idun-agent-schema 0.1.0__tar.gz

idun_agent_schema-0.1.0/.gitignore

@@ -0,0 +1,201 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Database files
+*.db
+*.db-shm
+*.db-wai
+*.db-journal*
+*.sqlite
+*.sqlite3
+agents.db
+checkpoint_async.db
+
+# Python virtual environment
+.venv/
+venv/
+ENV/
+
+# Python cache
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+
+# Poetry
+poetry.lock
+
+# Environment variables
+.env

idun_agent_schema-0.1.0/PKG-INFO

@@ -0,0 +1,40 @@
+Metadata-Version: 2.4
+Name: idun-agent-schema
+Version: 0.1.0
+Summary: Centralized Pydantic schema library for Idun Agent Engine and Manager
+Project-URL: Homepage, https://github.com/geoffreyharrazi/idun-agent-platform
+Project-URL: Repository, https://github.com/geoffreyharrazi/idun-agent-platform
+Project-URL: Issues, https://github.com/geoffreyharrazi/idun-agent-platform/issues
+Author-email: Idun Team <team@idun.com>
+License-Expression: MIT
+Keywords: fastapi,idun,langgraph,pydantic,schemas
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: <3.14,>=3.13
+Requires-Dist: pydantic-settings<3.0.0,>=2.7.0
+Requires-Dist: pydantic<3.0.0,>=2.11.7
+Description-Content-Type: text/markdown
+
+# Idun Agent Schema
+
+Centralized Pydantic schema library shared by Idun Agent Engine and Idun Agent Manager.
+
+## Install
+
+```bash
+pip install idun-agent-schema
+```
+
+## Usage
+
+```python
+from idun_agent_schema.engine import EngineConfig
+from idun_agent_schema.manager.api import AgentCreateRequest
+```
+
+This package re-exports stable schema namespaces to avoid breaking existing imports. Prefer importing from this package directly going forward.
+
+

idun_agent_schema-0.1.0/README.md

@@ -0,0 +1,20 @@
+# Idun Agent Schema
+
+Centralized Pydantic schema library shared by Idun Agent Engine and Idun Agent Manager.
+
+## Install
+
+```bash
+pip install idun-agent-schema
+```
+
+## Usage
+
+```python
+from idun_agent_schema.engine import EngineConfig
+from idun_agent_schema.manager.api import AgentCreateRequest
+```
+
+This package re-exports stable schema namespaces to avoid breaking existing imports. Prefer importing from this package directly going forward.
+
+

idun_agent_schema-0.1.0/pyproject.toml

@@ -0,0 +1,76 @@
+[project]
+name = "idun-agent-schema"
+version = "0.1.0"
+description = "Centralized Pydantic schema library for Idun Agent Engine and Manager"
+authors = [{ name = "Idun Team", email = "team@idun.com" }]
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.13,<3.14"
+keywords = ["pydantic", "schemas", "fastapi", "langgraph", "idun"]
+classifiers = [
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.13",
+  "Typing :: Typed",
+]
+dependencies = [
+  "pydantic>=2.11.7,<3.0.0",
+  "pydantic-settings>=2.7.0,<3.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/geoffreyharrazi/idun-agent-platform"
+Repository = "https://github.com/geoffreyharrazi/idun-agent-platform"
+Issues = "https://github.com/geoffreyharrazi/idun-agent-platform/issues"
+
+[build-system]
+requires = ["hatchling>=1.25.0"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.sdist]
+include = [
+  "src/idun_agent_schema",
+  "src/idun_agent_schema/py.typed",
+]
+
+[tool.hatch.build.targets.wheel]
+include = [
+  "src/idun_agent_schema",
+  "src/idun_agent_schema/py.typed",
+]
+
+[tool.hatch.build.targets.wheel.sources]
+"src/idun_agent_schema" = "idun_agent_schema"
+
+[tool.ruff]
+target-version = "py313"
+line-length = 88
+
+[tool.ruff.lint]
+select = [
+  "E", "F", "W", "I", "B", "UP", "N", "SIM", "D"
+]
+extend-ignore = ["E501"]
+
+[tool.black]
+line-length = 88
+target-version = ["py313"]
+include = "\\.pyi?$"
+
+[tool.mypy]
+python_version = "3.13"
+warn_return_any = true
+warn_unused_ignores = true
+ignore_missing_imports = true
+strict_optional = true
+no_implicit_optional = true
+check_untyped_defs = true
+pretty = true
+show_error_codes = true
+
+[tool.pytest.ini_options]
+addopts = "-ra -q --strict-markers --disable-warnings"
+testpaths = ["tests"]
+
+

idun_agent_schema-0.1.0/src/idun_agent_schema/__init__.py

@@ -0,0 +1,12 @@
+"""Idun Agent Schema - Centralized Pydantic schemas.
+
+Public namespaces:
+- idun_agent_schema.engine: Engine-related schemas
+- idun_agent_schema.manager: Manager-related schemas
+- idun_agent_schema.shared: Shared cross-cutting schemas
+"""
+
+# Re-export key types for convenience
+from .shared.observability import ObservabilityConfig  # noqa: F401
+
+

idun_agent_schema-0.1.0/src/idun_agent_schema/engine/__init__.py

@@ -0,0 +1,13 @@
+"""Engine-related schemas."""
+
+from .agent import BaseAgentConfig  # noqa: F401
+from .api import ChatRequest, ChatResponse  # noqa: F401
+from .config import AgentConfig, EngineConfig  # noqa: F401
+from .langgraph import (  # noqa: F401
+    CheckpointConfig,
+    LangGraphAgentConfig,
+    SqliteCheckpointConfig,
+)
+from .server import ServerAPIConfig, ServerConfig  # noqa: F401
+
+

idun_agent_schema-0.1.0/src/idun_agent_schema/engine/agent.py

@@ -0,0 +1,18 @@
+"""Common agent model definitions (engine)."""
+
+from typing import Any
+
+from pydantic import BaseModel, Field
+
+from idun_agent_schema.shared import ObservabilityConfig
+
+
+class BaseAgentConfig(BaseModel):
+    """Base model for agent configurations. Extend for specific frameworks."""
+
+    name: str | None = Field(default="Unnamed Agent")
+    input_schema_definition: dict[str, Any] | None = Field(default_factory=dict)
+    output_schema_definition: dict[str, Any] | None = Field(default_factory=dict)
+    observability: ObservabilityConfig | None = Field(default=None)
+
+

idun_agent_schema-0.1.0/src/idun_agent_schema/engine/api.py

@@ -0,0 +1,15 @@
+"""Schemas for engine HTTP API request/response payloads."""
+
+from pydantic import BaseModel
+
+
+class ChatRequest(BaseModel):
+    session_id: str
+    query: str
+
+
+class ChatResponse(BaseModel):
+    session_id: str
+    response: str
+
+

idun_agent_schema-0.1.0/src/idun_agent_schema/engine/config.py

@@ -0,0 +1,27 @@
+"""Top-level engine configuration models."""
+
+from typing import Literal
+
+from pydantic import BaseModel, Field
+
+from .agent import BaseAgentConfig
+from .langgraph import LangGraphAgentConfig
+from .server import ServerConfig
+
+
+class AgentConfig(BaseModel):
+    """Configuration for agent specification and settings."""
+
+    type: Literal["langgraph", "ADK", "CREWAI"] = Field(default="langgraph")
+    config: BaseAgentConfig | LangGraphAgentConfig = Field(
+        default_factory=BaseAgentConfig
+    )
+
+
+class EngineConfig(BaseModel):
+    """Main engine configuration model for the entire Idun Agent Engine."""
+
+    server: ServerConfig = Field(default_factory=ServerConfig)
+    agent: AgentConfig
+
+

idun_agent_schema-0.1.0/src/idun_agent_schema/engine/langgraph.py

@@ -0,0 +1,42 @@
+"""Configuration models for LangGraph agents (engine)."""
+
+from typing import Any, Literal
+from urllib.parse import urlparse
+
+from pydantic import BaseModel, field_validator
+
+from .agent import BaseAgentConfig
+
+
+class SqliteCheckpointConfig(BaseModel):
+    """Configuration for SQLite checkpointer."""
+
+    type: Literal["sqlite"]
+    db_url: str
+
+    @field_validator("db_url")
+    @classmethod
+    def db_url_must_be_sqlite(cls, v: str) -> str:
+        if not v.startswith("sqlite:///"):
+            raise ValueError("SQLite DB URL must start with 'sqlite:///'")
+        return v
+
+    @property
+    def db_path(self) -> str:
+        path = urlparse(self.db_url).path
+        if self.db_url.startswith("sqlite:///"):
+            return path.lstrip("/")
+        return path
+
+
+CheckpointConfig = SqliteCheckpointConfig
+
+
+class LangGraphAgentConfig(BaseAgentConfig):
+    """Configuration model for LangGraph agents."""
+
+    graph_definition: str
+    checkpointer: CheckpointConfig | None = None
+    store: dict[str, Any] | None = None
+
+

idun_agent_schema-0.1.0/src/idun_agent_schema/engine/server.py

@@ -0,0 +1,17 @@
+"""Server configuration models (engine)."""
+
+from pydantic import BaseModel, Field
+
+
+class ServerAPIConfig(BaseModel):
+    """API server configuration."""
+
+    port: int = 8000
+
+
+class ServerConfig(BaseModel):
+    """Configuration for the Engine's universal settings."""
+
+    api: ServerAPIConfig = Field(default_factory=ServerAPIConfig)
+
+

idun_agent_schema-0.1.0/src/idun_agent_schema/manager/__init__.py

@@ -0,0 +1,52 @@
+"""Manager-related schemas."""
+
+from .api import (  # noqa: F401
+    AgentCreateRequest,
+    AgentResponse,
+    AgentRunRequest,
+    AgentRunResponse,
+    AgentRunSummaryResponse,
+    AgentStatsResponse,
+    AgentSummaryResponse,
+    AgentUpdateRequest,
+    PaginatedAgentsResponse,
+    PaginatedResponse,
+    PaginatedRunsResponse,
+)
+from .deps import Principal  # noqa: F401
+from .domain import (  # noqa: F401
+    AgentEntity,
+    AgentFramework,
+    AgentRunEntity,
+    AgentStatus,
+    TenantEntity,
+    TenantPlan,
+    TenantStatus,
+    TenantUserEntity,
+)
+from .dto import (  # noqa: F401
+    AgentCreateDTO,
+    AgentDeploymentDTO,
+    AgentHealthDTO,
+    AgentMetricsDTO,
+    AgentRunCreateDTO,
+    AgentUpdateDTO,
+    TenantCreateDTO,
+    TenantQuotaDTO,
+    TenantUpdateDTO,
+    TenantUsageDTO,
+    TenantUserCreateDTO,
+    TenantUserUpdateDTO,
+)
+from .errors import ProblemDetail  # noqa: F401
+from .settings import (  # noqa: F401
+    APISettings,
+    AuthSettings,
+    CelerySettings,
+    DatabaseSettings,
+    ObservabilitySettings,
+    RedisSettings,
+    Settings,
+)
+
+

idun_agent_schema-0.1.0/src/idun_agent_schema/manager/api.py

@@ -0,0 +1,130 @@
+"""Pydantic schemas for Agent Manager API I/O."""
+
+from datetime import datetime
+from typing import Any
+from uuid import UUID
+
+from pydantic import BaseModel, Field
+
+from .domain import AgentFramework, AgentStatus
+
+
+class AgentCreateRequest(BaseModel):
+    name: str = Field(..., min_length=1, max_length=255)
+    description: str | None = Field(None, max_length=1000)
+    framework: AgentFramework
+    config: dict[str, Any] = Field(default_factory=dict)
+    environment_variables: dict[str, str] = Field(default_factory=dict)
+    tags: list[str] = Field(default_factory=list)
+
+
+class AgentUpdateRequest(BaseModel):
+    name: str | None = Field(None, min_length=1, max_length=255)
+    description: str | None = Field(None, max_length=1000)
+    config: dict[str, Any] | None = None
+    environment_variables: dict[str, str] | None = None
+    tags: list[str] | None = None
+
+
+class AgentRunRequest(BaseModel):
+    input_data: dict[str, Any]
+    trace_id: str | None = Field(None, max_length=100)
+
+
+class AgentResponse(BaseModel):
+    id: UUID
+    name: str
+    description: str | None
+    framework: AgentFramework
+    status: AgentStatus
+    config: dict[str, Any]
+    environment_variables: dict[str, str]
+    version: str
+    tags: list[str]
+    tenant_id: UUID
+    created_at: datetime
+    updated_at: datetime
+    deployed_at: datetime | None
+    total_runs: int
+    success_rate: float | None
+    avg_response_time_ms: float | None
+
+    class Config:
+        from_attributes = True
+
+
+class AgentSummaryResponse(BaseModel):
+    id: UUID
+    name: str
+    description: str | None
+    framework: AgentFramework
+    status: AgentStatus
+    version: str
+    tags: list[str]
+    created_at: datetime
+    updated_at: datetime
+    total_runs: int
+    success_rate: float | None
+
+    class Config:
+        from_attributes = True
+
+
+class AgentRunResponse(BaseModel):
+    id: UUID
+    agent_id: UUID
+    tenant_id: UUID
+    input_data: dict[str, Any]
+    output_data: dict[str, Any] | None
+    status: str
+    started_at: datetime
+    completed_at: datetime | None
+    error_message: str | None
+    response_time_ms: float | None
+    tokens_used: int | None
+    cost_usd: float | None
+    trace_id: str | None
+    span_id: str | None
+
+    class Config:
+        from_attributes = True
+
+
+class AgentRunSummaryResponse(BaseModel):
+    id: UUID
+    agent_id: UUID
+    status: str
+    started_at: datetime
+    completed_at: datetime | None
+    response_time_ms: float | None
+    tokens_used: int | None
+    cost_usd: float | None
+
+    class Config:
+        from_attributes = True
+
+
+class PaginatedResponse(BaseModel):
+    total: int
+    limit: int
+    offset: int
+    has_more: bool
+
+
+class PaginatedAgentsResponse(PaginatedResponse):
+    items: list[AgentSummaryResponse]
+
+
+class PaginatedRunsResponse(PaginatedResponse):
+    items: list[AgentRunSummaryResponse]
+
+
+class AgentStatsResponse(BaseModel):
+    total_agents: int
+    active_agents: int
+    total_runs_today: int
+    total_runs_this_month: int
+    avg_success_rate: float | None
+    avg_response_time_ms: float | None
+
+

idun_agent_schema-0.1.0/src/idun_agent_schema/manager/deployments.py

@@ -0,0 +1,14 @@
+"""Deployment-related enums and schemas."""
+
+from enum import Enum
+
+
+class DeploymentMode(str, Enum):
+    """Supported deployment modes."""
+
+    LOCAL = "local"
+    AWS = "aws"
+    AZURE = "azure"
+    GCP = "gcp"
+
+

idun_agent_schema-0.1.0/src/idun_agent_schema/manager/deps.py

@@ -0,0 +1,16 @@
+"""Shared dependency models used by FastAPI deps in Manager."""
+
+from uuid import UUID
+
+from pydantic import BaseModel
+
+
+class Principal(BaseModel):
+    """Authenticated caller identity and authorization context."""
+
+    user_id: str
+    tenant_id: UUID
+    roles: list[str] = []
+    workspace_ids: list[UUID] = []
+
+

idun_agent_schema-0.1.0/src/idun_agent_schema/manager/domain.py

@@ -0,0 +1,261 @@
+"""Domain entities and enums for Agents and Tenants."""
+
+from datetime import UTC, datetime
+from enum import Enum
+from typing import Any
+from uuid import UUID, uuid4
+
+from pydantic import BaseModel, Field
+
+
+class AgentStatus(str, Enum):
+    """Agent status enumeration."""
+
+    DRAFT = "draft"
+    ACTIVE = "active"
+    INACTIVE = "inactive"
+    DEPRECATED = "deprecated"
+    ERROR = "error"
+
+
+class AgentFramework(str, Enum):
+    """Supported agent frameworks."""
+
+    LANGGRAPH = "langgraph"
+    CREWAI = "crewai"
+    AUTOGEN = "autogen"
+    CUSTOM = "custom"
+
+
+class AgentEntity(BaseModel):
+    """Agent domain entity."""
+
+    id: UUID = Field(default_factory=uuid4)
+    name: str = Field(..., min_length=1, max_length=255)
+    description: str | None = Field(None, max_length=1000)
+    framework: AgentFramework
+    status: AgentStatus = Field(default=AgentStatus.DRAFT)
+
+    # Configuration
+    config: dict[str, Any] = Field(default_factory=dict)
+    environment_variables: dict[str, str] = Field(default_factory=dict)
+
+    # Metadata
+    version: str = Field(default="1.0.0")
+    tags: list[str] = Field(default_factory=list)
+
+    # Tenant isolation
+    tenant_id: UUID
+
+    # Timestamps
+    created_at: datetime
+    updated_at: datetime
+    deployed_at: datetime | None = None
+
+    # Performance metrics
+    total_runs: int = Field(default=0)
+    success_rate: float | None = Field(None, ge=0.0, le=1.0)
+    avg_response_time_ms: float | None = Field(None, ge=0)
+
+    def activate(self) -> None:
+        if self.status == AgentStatus.DRAFT:
+            self.status = AgentStatus.ACTIVE
+            self.deployed_at = datetime.now(UTC)
+        else:
+            raise ValueError(f"Cannot activate agent in {self.status} status")
+
+    def deactivate(self) -> None:
+        if self.status == AgentStatus.ACTIVE:
+            self.status = AgentStatus.INACTIVE
+        else:
+            raise ValueError(f"Cannot deactivate agent in {self.status} status")
+
+    def update_metrics(self, success: bool, response_time_ms: float) -> None:
+        self.total_runs += 1
+
+        if self.success_rate is None:
+            self.success_rate = 1.0 if success else 0.0
+        else:
+            current_successes = self.success_rate * (self.total_runs - 1)
+            if success:
+                current_successes += 1
+            self.success_rate = current_successes / self.total_runs
+
+        if self.avg_response_time_ms is None:
+            self.avg_response_time_ms = response_time_ms
+        else:
+            total_time = self.avg_response_time_ms * (self.total_runs - 1)
+            self.avg_response_time_ms = (total_time + response_time_ms) / self.total_runs
+
+    def can_be_deployed(self) -> bool:
+        return (
+            self.status in [AgentStatus.DRAFT, AgentStatus.INACTIVE]
+            and bool(self.name)
+            and bool(self.config)
+        )
+
+
+class AgentRunEntity(BaseModel):
+    """Agent run domain entity."""
+
+    id: UUID = Field(default_factory=uuid4)
+    agent_id: UUID
+    tenant_id: UUID
+
+    # Input/Output
+    input_data: dict[str, Any]
+    output_data: dict[str, Any] | None = None
+
+    # Execution details
+    status: str  # running, completed, failed
+    started_at: datetime
+    completed_at: datetime | None = None
+    error_message: str | None = None
+
+    # Performance
+    response_time_ms: float | None = None
+    tokens_used: int | None = None
+    cost_usd: float | None = None
+
+    # Tracing
+    trace_id: str | None = None
+    span_id: str | None = None
+
+    def complete(self, output_data: dict[str, Any], response_time_ms: float) -> None:
+        self.status = "completed"
+        self.output_data = output_data
+        self.completed_at = datetime.now(UTC)
+        self.response_time_ms = response_time_ms
+
+    def fail(self, error_message: str) -> None:
+        self.status = "failed"
+        self.error_message = error_message
+        self.completed_at = datetime.now(UTC)
+
+    @property
+    def is_completed(self) -> bool:
+        return self.status in ["completed", "failed"]
+
+    @property
+    def was_successful(self) -> bool:
+        return self.status == "completed"
+
+
+class TenantStatus(str, Enum):
+    """Tenant status enumeration."""
+
+    ACTIVE = "active"
+    SUSPENDED = "suspended"
+    DEACTIVATED = "deactivated"
+
+
+class TenantPlan(str, Enum):
+    """Tenant subscription plan."""
+
+    FREE = "free"
+    STARTER = "starter"
+    PROFESSIONAL = "professional"
+    ENTERPRISE = "enterprise"
+
+
+class TenantEntity(BaseModel):
+    """Tenant domain entity."""
+
+    id: UUID = Field(default_factory=uuid4)
+    name: str = Field(..., min_length=1, max_length=255)
+    slug: str = Field(..., min_length=1, max_length=100)
+
+    # Contact information
+    email: str = Field(..., description="Primary contact email")
+    website: str | None = Field(None)
+
+    # Status and plan
+    status: TenantStatus = Field(default=TenantStatus.ACTIVE)
+    plan: TenantPlan = Field(default=TenantPlan.FREE)
+
+    # Settings
+    settings: dict[str, Any] = Field(default_factory=dict)
+
+    # Quotas and limits
+    max_agents: int = Field(default=5)
+    max_runs_per_month: int = Field(default=1000)
+    max_storage_mb: int = Field(default=100)
+
+    # Usage tracking
+    current_agents: int = Field(default=0)
+    current_runs_this_month: int = Field(default=0)
+    current_storage_mb: float = Field(default=0.0)
+
+    # Timestamps
+    created_at: datetime
+    updated_at: datetime
+    suspended_at: datetime | None = None
+
+    def can_create_agent(self) -> bool:
+        return self.status == TenantStatus.ACTIVE and self.current_agents < self.max_agents
+
+    def can_run_agent(self) -> bool:
+        return self.status == TenantStatus.ACTIVE and self.current_runs_this_month < self.max_runs_per_month
+
+    def suspend(self, reason: str) -> None:
+        self.status = TenantStatus.SUSPENDED
+        self.suspended_at = datetime.utcnow()
+        self.settings["suspension_reason"] = reason
+
+    def reactivate(self) -> None:
+        if self.status == TenantStatus.SUSPENDED:
+            self.status = TenantStatus.ACTIVE
+            self.suspended_at = None
+            if "suspension_reason" in self.settings:
+                del self.settings["suspension_reason"]
+
+    def upgrade_plan(self, new_plan: TenantPlan) -> None:
+        self.plan = new_plan
+        if new_plan == TenantPlan.STARTER:
+            self.max_agents = 20
+            self.max_runs_per_month = 10000
+            self.max_storage_mb = 1000
+        elif new_plan == TenantPlan.PROFESSIONAL:
+            self.max_agents = 100
+            self.max_runs_per_month = 100000
+            self.max_storage_mb = 10000
+        elif new_plan == TenantPlan.ENTERPRISE:
+            self.max_agents = 1000
+            self.max_runs_per_month = 1000000
+            self.max_storage_mb = 100000
+
+    def increment_usage(self, agents: int = 0, runs: int = 0, storage_mb: float = 0) -> None:
+        self.current_agents += agents
+        self.current_runs_this_month += runs
+        self.current_storage_mb += storage_mb
+
+    def reset_monthly_usage(self) -> None:
+        self.current_runs_this_month = 0
+
+
+class TenantUserEntity(BaseModel):
+    """Tenant user domain entity for multi-user tenants."""
+
+    id: UUID = Field(default_factory=uuid4)
+    tenant_id: UUID
+    user_id: str
+    email: str
+
+    # Role and permissions
+    role: str = Field(default="member")
+    permissions: list[str] = Field(default_factory=list)
+
+    # Status
+    is_active: bool = Field(default=True)
+
+    # Timestamps
+    joined_at: datetime
+    last_active_at: datetime | None = None
+
+    def has_permission(self, permission: str) -> bool:
+        return permission in self.permissions or self.role == "owner"
+
+    def is_admin(self) -> bool:
+        return self.role in ["owner", "admin"]
+
+

idun_agent_schema-0.1.0/src/idun_agent_schema/manager/dto.py

@@ -0,0 +1,109 @@
+"""DTOs for Manager operations."""
+
+from datetime import datetime
+from typing import Any
+from uuid import UUID
+
+from pydantic import BaseModel, Field
+
+from .domain import AgentFramework, TenantPlan
+
+
+class AgentCreateDTO(BaseModel):
+    name: str = Field(..., min_length=1, max_length=255)
+    description: str | None = Field(None, max_length=1000)
+    framework: AgentFramework
+    config: dict[str, Any] = Field(default_factory=dict)
+    environment_variables: dict[str, str] = Field(default_factory=dict)
+    tags: list[str] = Field(default_factory=list)
+    tenant_id: UUID
+
+
+class AgentUpdateDTO(BaseModel):
+    name: str | None = Field(None, min_length=1, max_length=255)
+    description: str | None = Field(None, max_length=1000)
+    config: dict[str, Any] | None = None
+    environment_variables: dict[str, str] | None = None
+    tags: list[str] | None = None
+
+
+class AgentDeploymentDTO(BaseModel):
+    agent_id: UUID
+    container_id: str
+    endpoint: str
+    status: str
+    framework: str
+    deployed_at: datetime | None = None
+
+
+class AgentHealthDTO(BaseModel):
+    agent_id: UUID
+    status: str
+    uptime: str | None = None
+    cpu_usage: str | None = None
+    memory_usage: str | None = None
+    last_activity: str | None = None
+    error: str | None = None
+
+
+class AgentRunCreateDTO(BaseModel):
+    agent_id: UUID
+    tenant_id: UUID
+    input_data: dict[str, Any]
+    trace_id: str | None = None
+
+
+class AgentMetricsDTO(BaseModel):
+    agent_id: UUID
+    total_runs: int
+    success_rate: float | None = Field(None, ge=0.0, le=1.0)
+    avg_response_time_ms: float | None = Field(None, ge=0)
+    last_run_at: datetime | None = None
+
+
+class TenantCreateDTO(BaseModel):
+    name: str = Field(..., min_length=1, max_length=255)
+    slug: str = Field(..., min_length=1, max_length=100)
+    email: str = Field(..., description="Primary contact email")
+    website: str | None = None
+    plan: TenantPlan = Field(default=TenantPlan.FREE)
+
+
+class TenantUpdateDTO(BaseModel):
+    name: str | None = Field(None, min_length=1, max_length=255)
+    email: str | None = None
+    website: str | None = None
+    settings: dict[str, Any] | None = None
+
+
+class TenantUsageDTO(BaseModel):
+    tenant_id: UUID
+    current_agents: int
+    max_agents: int
+    current_runs_this_month: int
+    max_runs_per_month: int
+    current_storage_mb: float
+    max_storage_mb: int
+    usage_percentage: dict[str, float]
+
+
+class TenantQuotaDTO(BaseModel):
+    max_agents: int | None = None
+    max_runs_per_month: int | None = None
+    max_storage_mb: int | None = None
+
+
+class TenantUserCreateDTO(BaseModel):
+    tenant_id: UUID
+    user_id: str
+    email: str
+    role: str = Field(default="member")
+    permissions: list[str] = Field(default_factory=list)
+
+
+class TenantUserUpdateDTO(BaseModel):
+    role: str | None = None
+    permissions: list[str] | None = None
+    is_active: bool | None = None
+
+

idun_agent_schema-0.1.0/src/idun_agent_schema/manager/errors.py

@@ -0,0 +1,24 @@
+"""RFC 9457 Problem Details model (shared)."""
+
+from typing import Any
+
+from pydantic import BaseModel, Field
+
+
+class ProblemDetail(BaseModel):
+    """RFC 9457 Problem Details model."""
+
+    type: str = Field(default="about:blank")
+    title: str = Field()
+    status: int = Field()
+    detail: str | None = Field(default=None)
+    instance: str | None = Field(default=None)
+
+    # Extension members
+    timestamp: str | None = Field(default=None)
+    request_id: str | None = Field(default=None)
+    errors: dict[str, Any] | None = Field(default=None)
+
+    model_config = {"extra": "allow"}
+
+

idun_agent_schema-0.1.0/src/idun_agent_schema/manager/settings.py

@@ -0,0 +1,139 @@
+"""Application settings schemas using Pydantic Settings v2."""
+
+from typing import Literal
+
+from pydantic import Field, field_validator
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+
+class DatabaseSettings(BaseSettings):
+    url: str = Field(default="postgresql+asyncpg://postgres:postgres@localhost:55432/idun_agents")
+    echo: bool = Field(default=False)
+    pool_size: int = Field(default=10)
+    max_overflow: int = Field(default=20)
+    pool_pre_ping: bool = Field(default=True)
+
+    model_config = SettingsConfigDict(env_prefix="DATABASE_", env_file=".env")
+
+
+class RedisSettings(BaseSettings):
+    url: str = Field(default="redis://localhost:6379/0")
+    max_connections: int = Field(default=20)
+
+    model_config = SettingsConfigDict(env_prefix="REDIS_", env_file=".env")
+
+
+class AuthSettings(BaseSettings):
+    provider_type: Literal["okta", "auth0", "entra", "google"] = Field(default="auth0")
+    issuer: str = Field(default="")
+    client_id: str = Field(default="")
+    client_secret: str = Field(default="")
+    audience: str | None = Field(default=None)
+    redirect_uri: str | None = Field(default=None)
+    scopes: list[str] = Field(default_factory=lambda: ["openid", "profile", "email"])
+
+    allowed_algs: list[str] = Field(default_factory=lambda: ["RS256", "RS512", "ES256"])
+    jwks_cache_ttl: int = Field(default=300)
+    clock_skew_seconds: int = Field(default=60)
+    expected_audiences: list[str] = Field(default_factory=list)
+
+    claim_user_id_path: list[str] | None = Field(default=None)
+    claim_email_path: list[str] | None = Field(default=None)
+    claim_roles_paths: list[list[str]] | None = Field(default=None)
+    claim_groups_paths: list[list[str]] | None = Field(default=None)
+    claim_workspace_ids_paths: list[list[str]] | None = Field(default=None)
+
+    @field_validator("claim_user_id_path", "claim_email_path", mode="before")
+    @classmethod
+    def _string_to_list(cls, v):
+        if isinstance(v, str) and v.strip().startswith("#"):
+            return None
+        return v
+
+    @field_validator(
+        "claim_roles_paths",
+        "claim_groups_paths",
+        "claim_workspace_ids_paths",
+        mode="before",
+    )
+    @classmethod
+    def _string_to_list_of_lists(cls, v):
+        if isinstance(v, str) and v.strip().startswith("#"):
+            return None
+        return v
+
+    model_config = SettingsConfigDict(env_prefix="AUTH_", env_file=".env", extra="ignore")
+
+    @field_validator("issuer")
+    @classmethod
+    def validate_issuer(cls, v: str) -> str:
+        if not v:
+            return v
+        if not v.startswith("http"):
+            raise ValueError("issuer must be a URL")
+        return v
+
+
+class ObservabilitySettings(BaseSettings):
+    otel_service_name: str = Field(default="idun-agent-manager")
+    otel_exporter_endpoint: str | None = Field(default=None)
+    otel_exporter_headers: str | None = Field(default=None)
+    log_level: str = Field(default="INFO")
+    log_format: str = Field(default="json")
+
+    model_config = SettingsConfigDict(env_prefix="OTEL_", env_file=".env")
+
+
+class CelerySettings(BaseSettings):
+    broker_url: str = Field(default="redis://localhost:6379/1")
+    result_backend: str = Field(default="redis://localhost:6379/2")
+    task_serializer: str = Field(default="json")
+    result_serializer: str = Field(default="json")
+    accept_content: list[str] = Field(default=["json"])
+    timezone: str = Field(default="UTC")
+
+    model_config = SettingsConfigDict(env_prefix="CELERY_", env_file=".env")
+
+
+class APISettings(BaseSettings):
+    title: str = Field(default="Idun Agent Manager API")
+    description: str = Field(default="Modern FastAPI backend for managing AI agents")
+    version: str = Field(default="0.1.0")
+    docs_url: str = Field(default="/docs")
+    redoc_url: str = Field(default="/redoc")
+    openapi_url: str = Field(default="/openapi.json")
+    cors_origins: list[str] = Field(default=["http://localhost:3000", "http://localhost:8080"])
+    cors_methods: list[str] = Field(default=["*"])
+    cors_headers: list[str] = Field(default=["*"])
+    rate_limit_enabled: bool = Field(default=True)
+    rate_limit_requests: int = Field(default=100)
+    rate_limit_window: int = Field(default=60)
+
+    model_config = SettingsConfigDict(env_prefix="API_", env_file=".env", extra="ignore")
+
+
+class Settings(BaseSettings):
+    environment: str = Field(default="development")
+    debug: bool = Field(default=False)
+    testing: bool = Field(default=False)
+    host: str = Field(default="0.0.0.0")
+    port: int = Field(default=8000)
+    workers: int = Field(default=1)
+    reload: bool = Field(default=False)
+
+    database: DatabaseSettings = Field(default_factory=DatabaseSettings)
+    redis: RedisSettings = Field(default_factory=RedisSettings)
+    auth: AuthSettings = Field(default_factory=AuthSettings)
+    observability: ObservabilitySettings = Field(default_factory=ObservabilitySettings)
+    celery: CelerySettings = Field(default_factory=CelerySettings)
+    api: APISettings = Field(default_factory=APISettings)
+
+    model_config = SettingsConfigDict(
+        env_file=".env",
+        env_file_encoding="utf-8",
+        env_nested_delimiter="__",
+        case_sensitive=False,
+        extra="ignore",
+    )
+
+

idun_agent_schema-0.1.0/src/idun_agent_schema/py.typed

@@ -0,0 +1,2 @@
+
+

idun_agent_schema-0.1.0/src/idun_agent_schema/shared/__init__.py

@@ -0,0 +1,5 @@
+"""Shared cross-cutting schemas used by both Engine and Manager."""
+
+from .observability import ObservabilityConfig
+
+__all__ = ["ObservabilityConfig"]

idun_agent_schema-0.1.0/src/idun_agent_schema/shared/observability.py

@@ -0,0 +1,58 @@
+"""Provider-agnostic observability configuration model (shared)."""
+
+from __future__ import annotations
+
+import os
+from typing import Any
+
+from pydantic import BaseModel, Field
+
+
+def _resolve_env(value: Any) -> Any:
+    """Resolve environment placeholders in strings.
+
+    Supports patterns ${VAR} and $VAR. Non-strings are returned unchanged.
+    """
+    if isinstance(value, str):
+        if value.startswith("${") and value.endswith("}"):
+            return os.getenv(value[2:-1])
+        if value.startswith("$"):
+            return os.getenv(value[1:])
+    return value
+
+
+class ObservabilityConfig(BaseModel):
+    """Provider-agnostic observability configuration based on Pydantic.
+
+    Example YAML:
+      observability:
+        provider: "langfuse"  # or "phoenix"
+        enabled: true
+        options:
+          host: ${LANGFUSE_HOST}
+          public_key: ${LANGFUSE_PUBLIC_KEY}
+          secret_key: ${LANGFUSE_SECRET_KEY}
+          run_name: "my-run"
+    """
+
+    provider: str | None = Field(default=None)
+    enabled: bool = Field(default=False)
+    options: dict[str, Any] = Field(default_factory=dict)
+
+    def _resolve_value(self, value: Any) -> Any:
+        if isinstance(value, dict):
+            return {k: self._resolve_value(v) for k, v in value.items()}
+        if isinstance(value, list):
+            return [self._resolve_value(v) for v in value]
+        return _resolve_env(value)
+
+    def resolved(self) -> ObservabilityConfig:
+        """Return a copy with env placeholders resolved in options."""
+        resolved_options = self._resolve_value(self.options)
+        return ObservabilityConfig(
+            provider=self.provider,
+            enabled=self.enabled,
+            options=resolved_options,
+        )
+
+