Skip to content

LCORE-2846: Updated project structure for Agents #2121

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
tisnik merged 1 commit into from
Jul 13, 2026
Merged

LCORE-2846: Updated project structure for Agents #2121

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
57 changes: 36 additions & 21 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,33 +13,48 @@ Lightspeed Core Stack (LCS) is an AI-powered assistant built on FastAPI that pro
## Code Architecture & Patterns

### Project Structure

```
src/
├── app/ # FastAPI application
│ ├── endpoints/ # REST API endpoints
│ └── main.py # Application entry point
├── a2a_storage/ # A2A protocol persistent storage
│ ├── context_store.py # Abstract base class for context stores
├── app/ # FastAPI application
│ ├── endpoints/ # REST API endpoints
│ └── main.py # Application entry point
├── a2a_storage/ # A2A protocol persistent storage
│ ├── context_store.py # Abstract base class for context stores
│ ├── in_memory_context_store.py # In-memory implementation
│ ├── sqlite_context_store.py # SQLite implementation
│ ├── postgres_context_store.py # PostgreSQL implementation
│ └── storage_factory.py # Factory for creating stores
├── authentication/ # Authentication modules (k8s, jwk, noop, rh-identity)
├── authorization/ # Authorization middleware & resolvers
├── cache/ # Conversation cache implementations
├── quota/ # Quota limiter and token usage tracking
├── metrics/ # Prometheus metrics
├── runners/ # Agent runners
├── models/ # Pydantic models
│ ├── api/
│ │ ├── requests/ # REST API request models
│ │ └── responses/ # HTTP response models
│ ├── common/ # Shared cross-layer models
│ └── database/ # Database models
├── utils/ # Utility functions
├── client.py # Llama Stack client wrapper (Singleton)
├── configuration.py # Config management (Singleton)
└── constants.py # Shared constants
├── authentication/ # Authentication modules (k8s, jwk, noop, rh-identity)
├── authorization/ # Authorization middleware & resolvers
├── cache/ # Conversation cache implementations
├── data/ # Built-in default Llama Stack baseline for unified-mode synthesis
├── quota/ # Quota limiter and token usage tracking
├── metrics/ # Prometheus metrics
├── runners/ # Runners for various LCore subsystems
├── models/ # Pydantic models
│   ├── api/ # REST API models
│   │   ├── requests/ # REST API request models
│   │   └── responses/ # HTTP response models
│   │   ├── error/ # Error responses
│   │   └── successful/ # Successful responses
│   ├── common/ # Shared cross-layer models
│   │   ├── agents/ # Streaming payload models and event type exports
│   │   └── responses/ # Shared models for the OpenAI-compatible Responses API pipeline
│   └── database/ # Database models
├── observability/ # Observability module for telemetry and event collection
│   └── formats/ # Event format builders for Splunk telemetry
├── pydantic_ai_lightspeed/ # Pydantic AI integrations/extensions for Lightspeed Core Stack
│   ├── capabilities/ # Pluggable capabilities for pydantic-ai agents in Lightspeed
│   │   ├── question_validity/ # Question validity capability for agent input validation
│   │   └── redaction/ # PII redaction capability for Pydantic AI agents
│   └── llamastack/ # Pydantic AI provider for Llama Stack
├── telemetry/ # Telemetry module for configuration snapshot collection
├── utils/ # Utility functions
│ └── agents # Agent streaming and non streaming helpers
├── client.py # Llama Stack client wrapper (Singleton)
├── configuration.py # Config management (Singleton)
└── constants.py # Shared (final) constants
```

### Coding Standards
Expand Down
Loading