coreason-manifest 0.13.0__py3-none-any.whl → 0.16.0__py3-none-any.whl

coreason_manifest/__init__.py

@@ -8,6 +8,30 @@
 #
 # Source Code: https://github.com/CoReason-AI/coreason-manifest
 
+from .common import ToolRiskLevel
+from .definitions.capabilities import AgentCapabilities, DeliveryMode
+from .definitions.identity import Identity
+from .definitions.message import ChatMessage, Role
+from .definitions.presentation import (
+    AnyPresentationEvent,
+    ArtifactEvent,
+    CitationEvent,
+    PresentationEvent,
+    PresentationEventType,
+)
+from .definitions.service import AgentRequest, ServiceContract
+from .governance import ComplianceReport, ComplianceViolation, GovernanceConfig
+from .spec.cap import (
+    ErrorSeverity,
+    HealthCheckResponse,
+    HealthCheckStatus,
+    ServiceRequest,
+    ServiceResponse,
+    StreamError,
+    StreamOpCode,
+    StreamPacket,
+)
+from .v2.governance import check_compliance_v2
 from .v2.io import dump_to_yaml, load_from_yaml
 from .v2.spec.contracts import InterfaceDefinition, PolicyDefinition, StateDefinition
 from .v2.spec.definitions import (
@@ -22,8 +46,9 @@ from .v2.spec.definitions import (
     ToolDefinition,
     Workflow,
 )
+from .v2.validator import validate_integrity, validate_loose
 
-__version__ = "0.13.0"
+__version__ = "0.15.0"
 
 Manifest = ManifestV2
 Recipe = ManifestV2
@@ -48,4 +73,31 @@ __all__ = [
     "InterfaceDefinition",
     "StateDefinition",
     "PolicyDefinition",
+    "ToolRiskLevel",
+    "AgentCapabilities",
+    "DeliveryMode",
+    "GovernanceConfig",
+    "ComplianceReport",
+    "ComplianceViolation",
+    "Identity",
+    "Role",
+    "ChatMessage",
+    "PresentationEventType",
+    "PresentationEvent",
+    "AnyPresentationEvent",
+    "CitationEvent",
+    "ArtifactEvent",
+    "HealthCheckResponse",
+    "HealthCheckStatus",
+    "ServiceRequest",
+    "ServiceResponse",
+    "StreamPacket",
+    "StreamError",
+    "StreamOpCode",
+    "ErrorSeverity",
+    "validate_integrity",
+    "validate_loose",
+    "check_compliance_v2",
+    "AgentRequest",
+    "ServiceContract",
 ]

coreason_manifest/common.py

@@ -32,8 +32,8 @@ class CoReasonBaseModel(BaseModel):
         Uses mode='json' to ensure types like UUID and datetime are serialized to strings.
         Defaults to by_alias=True and exclude_none=True.
         """
-        # Set defaults but allow overrides
-        kwargs.setdefault("mode", "json")
+        # Strict enforcement of json mode for zero-friction serialization
+        kwargs["mode"] = "json"
         kwargs.setdefault("by_alias", True)
         kwargs.setdefault("exclude_none", True)
         return self.model_dump(**kwargs)

coreason_manifest/definitions/capabilities.py

@@ -0,0 +1,28 @@
+from enum import Enum
+from typing import List
+
+from pydantic import ConfigDict, Field
+
+from ..common import CoReasonBaseModel
+
+
+class DeliveryMode(str, Enum):
+    """Supported transport mechanisms."""
+
+    REQUEST_RESPONSE = "request_response"
+    SSE = "sse"
+
+
+class AgentCapabilities(CoReasonBaseModel):
+    """Feature flags and capabilities for the agent."""
+
+    model_config = ConfigDict(frozen=True, extra="forbid")
+
+    delivery_mode: List[DeliveryMode] = Field(
+        default_factory=lambda: [DeliveryMode.SSE],
+        description="Supported transport mechanisms.",
+    )
+    history_support: bool = Field(
+        default=True,
+        description="Whether the agent supports conversation history/context.",
+    )

coreason_manifest/definitions/identity.py

@@ -0,0 +1,33 @@
+# Copyright (c) 2025 CoReason, Inc.
+#
+# This software is proprietary and dual-licensed.
+# Licensed under the Prosperity Public License 3.0 (the "License").
+# A copy of the license is available at https://prosperitylicense.com/versions/3.0.0
+# For details, see the LICENSE file.
+# Commercial use beyond a 30-day trial requires a separate license.
+#
+# Source Code: https://github.com/CoReason-AI/coreason-manifest
+
+from typing import Optional
+
+from pydantic import ConfigDict, Field
+
+from ..common import CoReasonBaseModel
+
+
+class Identity(CoReasonBaseModel):
+    """A pure, frozen data structure representing an actor (user, agent, system)."""
+
+    model_config = ConfigDict(frozen=True)
+
+    id: str = Field(..., description="Unique identifier for the actor (e.g., UUID, slug).")
+    name: str = Field(..., description="Human-readable display name.")
+    role: Optional[str] = Field(None, description="Contextual role (e.g., 'user', 'assistant', 'system').")
+
+    def __str__(self) -> str:
+        return f"{self.name} ({self.id})"
+
+    @classmethod
+    def anonymous(cls) -> "Identity":
+        """Factory method for a standardized anonymous identity."""
+        return cls(id="anonymous", name="Anonymous User", role="user")

coreason_manifest/definitions/message.py

@@ -0,0 +1,41 @@
+# Copyright (c) 2025 CoReason, Inc.
+#
+# This software is proprietary and dual-licensed.
+# Licensed under the Prosperity Public License 3.0 (the "License").
+# A copy of the license is available at https://prosperitylicense.com/versions/3.0.0
+# For details, see the LICENSE file.
+# Commercial use beyond a 30-day trial requires a separate license.
+#
+# Source Code: https://github.com/CoReason-AI/coreason-manifest
+
+from datetime import datetime, timezone
+from enum import Enum
+from typing import Optional
+
+from pydantic import ConfigDict, Field
+
+from ..common import CoReasonBaseModel
+
+
+class Role(str, Enum):
+    """The role of the message sender."""
+
+    SYSTEM = "system"
+    USER = "user"
+    ASSISTANT = "assistant"
+    TOOL = "tool"
+
+
+class ChatMessage(CoReasonBaseModel):
+    """A single message in a conversation."""
+
+    model_config = ConfigDict(frozen=True)
+
+    role: Role = Field(..., description="The role of the message sender.")
+    content: str = Field(..., description="The content of the message.")
+    name: Optional[str] = Field(None, description="The name of the author of this message.")
+    tool_call_id: Optional[str] = Field(None, description="The tool call ID this message is responding to.")
+    timestamp: datetime = Field(
+        default_factory=lambda: datetime.now(timezone.utc),
+        description="The timestamp of the message.",
+    )

coreason_manifest/definitions/presentation.py

@@ -0,0 +1,52 @@
+# Copyright (c) 2025 CoReason, Inc.
+#
+# This software is proprietary and dual-licensed.
+# Licensed under the Prosperity Public License 3.0 (the "License").
+# A copy of the license is available at https://prosperitylicense.com/versions/3.0.0
+# For details, see the LICENSE file.
+# Commercial use beyond a 30-day trial requires a separate license.
+#
+# Source Code: https://github.com/CoReason-AI/coreason-manifest
+
+from enum import Enum
+from typing import List, Literal, Optional, Union
+
+from pydantic import ConfigDict, Field
+
+from ..common import CoReasonBaseModel
+
+
+class PresentationEventType(str, Enum):
+    """Types of presentation events."""
+
+    CITATION = "citation"
+    ARTIFACT = "artifact"
+
+
+class PresentationEvent(CoReasonBaseModel):
+    """Base class for presentation events."""
+
+    model_config = ConfigDict(frozen=True)
+
+    type: PresentationEventType = Field(..., description="The type of presentation event.")
+
+
+class CitationEvent(PresentationEvent):
+    """An event representing a citation."""
+
+    type: Literal[PresentationEventType.CITATION] = PresentationEventType.CITATION
+    uri: str = Field(..., description="The source URI.")
+    text: str = Field(..., description="The quoted text.")
+    indices: Optional[List[int]] = Field(None, description="Start and end character indices.")
+
+
+class ArtifactEvent(PresentationEvent):
+    """An event representing a generated artifact."""
+
+    type: Literal[PresentationEventType.ARTIFACT] = PresentationEventType.ARTIFACT
+    artifact_id: str = Field(..., description="Unique ID of the artifact.")
+    mime_type: str = Field(..., description="MIME type of the artifact.")
+    url: Optional[str] = Field(None, description="Download URL if applicable.")
+
+
+AnyPresentationEvent = Union[CitationEvent, ArtifactEvent]

coreason_manifest/definitions/service.py

@@ -0,0 +1,37 @@
+from typing import Any, Dict, List, Optional
+
+from pydantic import ConfigDict
+
+from ..common import CoReasonBaseModel
+from ..spec.cap import ServiceRequest, ServiceResponse
+
+
+class AgentRequest(CoReasonBaseModel):
+    """Strictly typed payload inside a ServiceRequest."""
+
+    model_config = ConfigDict(frozen=True)
+
+    query: str
+    files: List[str] = []
+    conversation_id: Optional[str] = None
+    meta: Dict[str, Any] = {}
+
+
+class ServiceContract:
+    """Utility class to generate the OpenAPI specification."""
+
+    @staticmethod
+    def generate_openapi() -> Dict[str, Any]:
+        """Generate the OpenAPI 3.1 Path Item Object for the agent service."""
+        return {
+            "post": {
+                "summary": "Invoke Agent",
+                "requestBody": {"content": {"application/json": {"schema": ServiceRequest.model_json_schema()}}},
+                "responses": {
+                    "200": {
+                        "description": "Successful Response",
+                        "content": {"application/json": {"schema": ServiceResponse.model_json_schema()}},
+                    }
+                },
+            }
+        }

coreason_manifest/governance.py

@@ -60,6 +60,7 @@ class ComplianceViolation(CoReasonBaseModel):
         rule: Name of the rule broken.
         message: Human readable details.
         component_id: Name of the tool or component causing the issue.
+        severity: Severity level (e.g., 'error', 'warning').
     """
 
     model_config = ConfigDict(extra="forbid", frozen=True)
@@ -67,6 +68,7 @@ class ComplianceViolation(CoReasonBaseModel):
     rule: str = Field(..., description="Name of the rule broken, e.g., 'domain_restriction'.")
     message: str = Field(..., description="Human readable details.")
     component_id: Optional[str] = Field(None, description="Name of the tool or component causing the issue.")
+    severity: Optional[str] = Field(None, description="Severity level (e.g., 'error', 'warning').")
 
 
 class ComplianceReport(CoReasonBaseModel):

coreason_manifest/spec/cap.py

@@ -0,0 +1,115 @@
+# Copyright (c) 2025 CoReason, Inc.
+#
+# This software is proprietary and dual-licensed.
+# Licensed under the Prosperity Public License 3.0 (the "License").
+# A copy of the license is available at https://prosperitylicense.com/versions/3.0.0
+# For details, see the LICENSE file.
+# Commercial use beyond a 30-day trial requires a separate license.
+#
+# Source Code: https://github.com/CoReason-AI/coreason-manifest
+
+from datetime import datetime
+from enum import Enum
+from typing import Any, Dict, Optional, Union
+from uuid import UUID
+
+from pydantic import ConfigDict, Field, model_validator
+
+from coreason_manifest.common import CoReasonBaseModel
+
+
+class HealthCheckStatus(str, Enum):
+    """Status of the health check."""
+
+    OK = "ok"
+    DEGRADED = "degraded"
+    MAINTENANCE = "maintenance"
+
+
+class HealthCheckResponse(CoReasonBaseModel):
+    """Response for a health check request."""
+
+    model_config = ConfigDict(frozen=True)
+
+    status: HealthCheckStatus
+    agent_id: UUID
+    version: str
+    uptime_seconds: float
+
+
+class ErrorSeverity(str, Enum):
+    """Severity of a stream error."""
+
+    TRANSIENT = "transient"
+    FATAL = "fatal"
+
+
+class StreamOpCode(str, Enum):
+    """Operation code for a stream packet."""
+
+    DELTA = "delta"
+    EVENT = "event"
+    ERROR = "error"
+    CLOSE = "close"
+
+
+class StreamError(CoReasonBaseModel):
+    """Strict error model for stream exceptions."""
+
+    model_config = ConfigDict(frozen=True)
+
+    code: str
+    message: str
+    severity: ErrorSeverity
+    details: Optional[Dict[str, Any]] = None
+
+
+class StreamPacket(CoReasonBaseModel):
+    """A packet of data streaming from an agent."""
+
+    model_config = ConfigDict(frozen=True)
+
+    op: StreamOpCode
+    p: Union[StreamError, str, Dict[str, Any], None] = Field(union_mode="left_to_right")
+
+    @model_validator(mode="after")
+    def validate_structure(self) -> "StreamPacket":
+        if self.op == StreamOpCode.ERROR:
+            if not isinstance(self.p, StreamError):
+                raise ValueError("Payload 'p' must be a valid StreamError when op is ERROR.")
+
+        if self.op == StreamOpCode.DELTA:
+            if not isinstance(self.p, str):
+                raise ValueError("Payload 'p' must be a string when op is DELTA.")
+
+        return self
+
+
+class ServiceResponse(CoReasonBaseModel):
+    """Synchronous response from an agent service."""
+
+    model_config = ConfigDict(frozen=True)
+
+    request_id: UUID
+    created_at: datetime
+    output: Dict[str, Any]
+    metrics: Optional[Dict[str, Any]] = None
+
+
+class ServiceRequest(CoReasonBaseModel):
+    """Request to an agent service.
+
+    Attributes:
+        request_id: Unique trace ID for the transaction.
+        context: Metadata about the request (User Identity, Auth, Session).
+                 Separated from logic to enable consistent security policies.
+        payload: The actual arguments for the Agent's execution.
+    """
+
+    model_config = ConfigDict(frozen=True)
+
+    request_id: UUID
+    # TODO: In v0.16.0, strictly type 'context' with a SessionContext model
+    # once the Identity primitive is fully integrated.
+    context: Dict[str, Any]
+    payload: Dict[str, Any]

coreason_manifest/v2/governance.py

@@ -41,6 +41,11 @@ def _risk_score(level: ToolRiskLevel) -> int:
 def check_compliance_v2(manifest: ManifestV2, config: GovernanceConfig) -> ComplianceReport:
     """Enforce policy on V2 Manifest before compilation.
 
+    Validates:
+    - Tool risk levels against allowed maximums.
+    - Tool URIs against allowed domains.
+    - Presence of custom logic (LogicStep, complex SwitchStep) if restricted.
+
     Args:
         manifest: The V2 manifest to check.
         config: The governance policy configuration.

coreason_manifest/v2/resolver.py

@@ -57,9 +57,7 @@ class ReferenceResolver:
         try:
             target_path.relative_to(self.root_dir)
         except ValueError:
-            raise ValueError(
-                f"Security Error: Reference '{ref_path}' escapes the root directory '{self.root_dir}'."
-            ) from None
+            raise ValueError(f"Security Error: Reference '{ref_path}' escapes the root directory.") from None
 
         if not target_path.exists():
             raise FileNotFoundError(f"Referenced file not found: {target_path}")

coreason_manifest/v2/spec/contracts.py

@@ -1,18 +1,20 @@
 from typing import Any, Dict, Optional
 
-from pydantic import BaseModel, ConfigDict, Field
+from pydantic import ConfigDict, Field
 
+from coreason_manifest.common import CoReasonBaseModel
 
-class InterfaceDefinition(BaseModel):
+
+class InterfaceDefinition(CoReasonBaseModel):
     """Defines the input/output contract."""
 
-    model_config = ConfigDict(extra="forbid")
+    model_config = ConfigDict(extra="forbid", populate_by_name=True)
 
     inputs: Dict[str, Any] = Field(default_factory=dict, description="JSON Schema definitions for arguments.")
     outputs: Dict[str, Any] = Field(default_factory=dict, description="JSON Schema definitions for return values.")
 
 
-class StateDefinition(BaseModel):
+class StateDefinition(CoReasonBaseModel):
     """Defines the conversation memory/context structure."""
 
     model_config = ConfigDict(extra="forbid", populate_by_name=True)
@@ -23,10 +25,10 @@ class StateDefinition(BaseModel):
     backend: Optional[str] = Field(None, description="Backend storage type (e.g., 'redis', 'memory').")
 
 
-class PolicyDefinition(BaseModel):
+class PolicyDefinition(CoReasonBaseModel):
     """Defines execution policy and governance rules."""
 
-    model_config = ConfigDict(extra="forbid")
+    model_config = ConfigDict(extra="forbid", populate_by_name=True)
 
     max_steps: Optional[int] = Field(None, description="Execution limit on number of steps.")
     max_retries: int = Field(3, description="Maximum number of retries.")

coreason_manifest/v2/spec/definitions.py

@@ -1,12 +1,13 @@
 from typing import Annotated, Any, Dict, List, Literal, Optional, Union
 
-from pydantic import BaseModel, ConfigDict, Field, model_validator
+from pydantic import ConfigDict, Field
 
-from coreason_manifest.common import StrictUri, ToolRiskLevel
+from coreason_manifest.common import CoReasonBaseModel, StrictUri, ToolRiskLevel
+from coreason_manifest.definitions.capabilities import AgentCapabilities
 from coreason_manifest.v2.spec.contracts import InterfaceDefinition, PolicyDefinition, StateDefinition
 
 
-class DesignMetadata(BaseModel):
+class DesignMetadata(CoReasonBaseModel):
     """UI-specific metadata for the visual builder."""
 
     model_config = ConfigDict(extra="forbid", populate_by_name=True)
@@ -20,7 +21,7 @@ class DesignMetadata(BaseModel):
     collapsed: bool = Field(False, description="Whether the node is collapsed in UI.")
 
 
-class ToolDefinition(BaseModel):
+class ToolDefinition(CoReasonBaseModel):
     """Definition of an external tool."""
 
     model_config = ConfigDict(extra="forbid", populate_by_name=True)
@@ -33,7 +34,7 @@ class ToolDefinition(BaseModel):
     description: Optional[str] = Field(None, description="Description of the tool.")
 
 
-class AgentDefinition(BaseModel):
+class AgentDefinition(CoReasonBaseModel):
     """Definition of an Agent."""
 
     model_config = ConfigDict(extra="forbid", populate_by_name=True)
@@ -47,15 +48,18 @@ class AgentDefinition(BaseModel):
     model: Optional[str] = Field(None, description="LLM identifier.")
     tools: List[str] = Field(default_factory=list, description="List of Tool IDs or URI references.")
     knowledge: List[str] = Field(default_factory=list, description="List of file paths or knowledge base IDs.")
+    capabilities: AgentCapabilities = Field(
+        default_factory=AgentCapabilities, description="Feature flags and capabilities for the agent."
+    )
 
 
-class GenericDefinition(BaseModel):
+class GenericDefinition(CoReasonBaseModel):
     """Fallback for unknown definitions."""
 
     model_config = ConfigDict(extra="allow")
 
 
-class BaseStep(BaseModel):
+class BaseStep(CoReasonBaseModel):
     """Base attributes for all steps."""
 
     model_config = ConfigDict(extra="forbid", populate_by_name=True)
@@ -106,7 +110,7 @@ Step = Annotated[
 ]
 
 
-class Workflow(BaseModel):
+class Workflow(CoReasonBaseModel):
     """Defines the execution topology."""
 
     model_config = ConfigDict(extra="forbid", populate_by_name=True)
@@ -115,7 +119,7 @@ class Workflow(BaseModel):
     steps: Dict[str, Step] = Field(..., description="Dictionary of all steps indexed by ID.")
 
 
-class ManifestMetadata(BaseModel):
+class ManifestMetadata(CoReasonBaseModel):
     """Metadata for the manifest."""
 
     model_config = ConfigDict(extra="allow", populate_by_name=True)
@@ -124,7 +128,7 @@ class ManifestMetadata(BaseModel):
     design_metadata: Optional[DesignMetadata] = Field(None, alias="x-design", description="UI metadata.")
 
 
-class ManifestV2(BaseModel):
+class ManifestV2(CoReasonBaseModel):
     """Root object for Coreason Manifest V2."""
 
     model_config = ConfigDict(extra="forbid", populate_by_name=True)
@@ -143,54 +147,3 @@ class ManifestV2(BaseModel):
         ],
     ] = Field(default_factory=dict, description="Reusable definitions.")
     workflow: Workflow = Field(..., description="The main workflow topology.")
-
-    @model_validator(mode="after")
-    def validate_integrity(self) -> "ManifestV2":
-        """Validate referential integrity of the manifest."""
-        steps = self.workflow.steps
-
-        # 1. Validate Start Step
-        if self.workflow.start not in steps:
-            raise ValueError(f"Start step '{self.workflow.start}' not found in steps.")
-
-        for step in steps.values():
-            # 2. Validate 'next' pointers (AgentStep, LogicStep, CouncilStep)
-            if hasattr(step, "next") and step.next:
-                if step.next not in steps:
-                    raise ValueError(f"Step '{step.id}' references missing next step '{step.next}'.")
-
-            # 3. Validate SwitchStep targets
-            if isinstance(step, SwitchStep):
-                for target in step.cases.values():
-                    if target not in steps:
-                        raise ValueError(f"SwitchStep '{step.id}' references missing step '{target}' in cases.")
-                if step.default and step.default not in steps:
-                    raise ValueError(f"SwitchStep '{step.id}' references missing step '{step.default}' in default.")
-
-            # 4. Validate Definition References
-            if isinstance(step, AgentStep):
-                if step.agent not in self.definitions:
-                    raise ValueError(f"AgentStep '{step.id}' references missing agent '{step.agent}'.")
-
-                # Check type
-                agent_def = self.definitions[step.agent]
-                if not isinstance(agent_def, AgentDefinition):
-                    raise ValueError(
-                        f"AgentStep '{step.id}' references '{step.agent}' which is not an AgentDefinition "
-                        f"(got {type(agent_def).__name__})."
-                    )
-
-            if isinstance(step, CouncilStep):
-                for voter in step.voters:
-                    if voter not in self.definitions:
-                        raise ValueError(f"CouncilStep '{step.id}' references missing voter '{voter}'.")
-
-                    # Check type
-                    agent_def = self.definitions[voter]
-                    if not isinstance(agent_def, AgentDefinition):
-                        raise ValueError(
-                            f"CouncilStep '{step.id}' references voter '{voter}' which is not an AgentDefinition "
-                            f"(got {type(agent_def).__name__})."
-                        )
-
-        return self

coreason_manifest/v2/validator.py

@@ -13,17 +13,105 @@
 from typing import List
 
 from coreason_manifest.v2.spec.definitions import (
+    AgentDefinition,
+    AgentStep,
+    CouncilStep,
     ManifestV2,
     SwitchStep,
+    ToolDefinition,
 )
 
 
+def validate_integrity(manifest: ManifestV2) -> ManifestV2:
+    """Validate referential integrity of the manifest.
+
+    Checks:
+    1. workflow.start exists in steps.
+    2. step.next pointers exist in steps.
+    3. SwitchStep.cases targets exist.
+    4. agent references in AgentStep exist in definitions.
+    5. CouncilStep voters exist in definitions.
+    6. AgentDefinition tools exist in definitions.
+
+    Args:
+        manifest: The V2 manifest to validate.
+
+    Returns:
+        The valid manifest (for chaining).
+
+    Raises:
+        ValueError: If referential integrity is violated.
+    """
+    steps = manifest.workflow.steps
+
+    # 1. Validate Start Step
+    if manifest.workflow.start not in steps:
+        raise ValueError(f"Start step '{manifest.workflow.start}' not found in steps.")
+
+    for step in steps.values():
+        # 2. Validate 'next' pointers (AgentStep, LogicStep, CouncilStep)
+        if hasattr(step, "next") and step.next:
+            if step.next not in steps:
+                raise ValueError(f"Step '{step.id}' references missing next step '{step.next}'.")
+
+        # 3. Validate SwitchStep targets
+        if isinstance(step, SwitchStep):
+            for target in step.cases.values():
+                if target not in steps:
+                    raise ValueError(f"SwitchStep '{step.id}' references missing step '{target}' in cases.")
+            if step.default and step.default not in steps:
+                raise ValueError(f"SwitchStep '{step.id}' references missing step '{step.default}' in default.")
+
+        # 4. Validate Definition References
+        if isinstance(step, AgentStep):
+            if step.agent not in manifest.definitions:
+                raise ValueError(f"AgentStep '{step.id}' references missing agent '{step.agent}'.")
+
+            # Check type
+            agent_def = manifest.definitions[step.agent]
+            if not isinstance(agent_def, AgentDefinition):
+                raise ValueError(
+                    f"AgentStep '{step.id}' references '{step.agent}' which is not an AgentDefinition "
+                    f"(got {type(agent_def).__name__})."
+                )
+
+        if isinstance(step, CouncilStep):
+            for voter in step.voters:
+                if voter not in manifest.definitions:
+                    raise ValueError(f"CouncilStep '{step.id}' references missing voter '{voter}'.")
+
+                # Check type
+                agent_def = manifest.definitions[voter]
+                if not isinstance(agent_def, AgentDefinition):
+                    raise ValueError(
+                        f"CouncilStep '{step.id}' references voter '{voter}' which is not an AgentDefinition "
+                        f"(got {type(agent_def).__name__})."
+                    )
+
+    # 5. Validate Agent Tools
+    for _, definition in manifest.definitions.items():
+        if isinstance(definition, AgentDefinition):
+            for tool_id in definition.tools:
+                if tool_id not in manifest.definitions:
+                    raise ValueError(f"Agent '{definition.id}' references missing tool '{tool_id}'.")
+
+                tool_def = manifest.definitions[tool_id]
+                if not isinstance(tool_def, ToolDefinition):
+                    raise ValueError(
+                        f"Agent '{definition.id}' references '{tool_id}' which is not a ToolDefinition "
+                        f"(got {type(tool_def).__name__})."
+                    )
+
+    return manifest
+
+
 def validate_loose(manifest: ManifestV2) -> List[str]:
     """Validate "Draft" manifests for structural sanity only.
 
     Checks:
     - Unique Step IDs.
     - SwitchStep case syntax (basic).
+    - Referential integrity (Start, Next, Switch, Agents, Tools) - warnings only.
 
     Args:
         manifest: The V2 manifest to validate.
@@ -38,11 +126,70 @@ def validate_loose(manifest: ManifestV2) -> List[str]:
         if step.id != step_id:
             warnings.append(f"Step key '{step_id}' does not match step.id '{step.id}'.")
 
-    # 2. Check SwitchStep cases
+    # 2. Check SwitchStep cases syntax
     for step_id, step in manifest.workflow.steps.items():
         if isinstance(step, SwitchStep):
             for condition in step.cases.keys():
                 if not isinstance(condition, str) or not condition.strip():
                     warnings.append(f"SwitchStep '{step_id}' has invalid condition: {condition}")
 
+    # 3. Check Referential Integrity (Warnings)
+    steps = manifest.workflow.steps
+
+    # Start Step
+    if manifest.workflow.start not in steps:
+        warnings.append(f"Start step '{manifest.workflow.start}' not found in steps.")
+
+    for step in steps.values():
+        # 'next' pointers
+        if hasattr(step, "next") and step.next:
+            if step.next not in steps:
+                warnings.append(f"Step '{step.id}' references missing next step '{step.next}'.")
+
+        # SwitchStep targets
+        if isinstance(step, SwitchStep):
+            for target in step.cases.values():
+                if target not in steps:
+                    warnings.append(f"SwitchStep '{step.id}' references missing step '{target}' in cases.")
+            if step.default and step.default not in steps:
+                warnings.append(f"SwitchStep '{step.id}' references missing step '{step.default}' in default.")
+
+        # Definition References
+        if isinstance(step, AgentStep):
+            if step.agent not in manifest.definitions:
+                warnings.append(f"AgentStep '{step.id}' references missing agent '{step.agent}'.")
+            else:
+                agent_def = manifest.definitions[step.agent]
+                if not isinstance(agent_def, AgentDefinition):
+                    warnings.append(
+                        f"AgentStep '{step.id}' references '{step.agent}' which is not an AgentDefinition "
+                        f"(got {type(agent_def).__name__})."
+                    )
+
+        if isinstance(step, CouncilStep):
+            for voter in step.voters:
+                if voter not in manifest.definitions:
+                    warnings.append(f"CouncilStep '{step.id}' references missing voter '{voter}'.")
+                else:
+                    agent_def = manifest.definitions[voter]
+                    if not isinstance(agent_def, AgentDefinition):
+                        warnings.append(
+                            f"CouncilStep '{step.id}' references voter '{voter}' which is not an AgentDefinition "
+                            f"(got {type(agent_def).__name__})."
+                        )
+
+    # Agent Tools
+    for _, definition in manifest.definitions.items():
+        if isinstance(definition, AgentDefinition):
+            for tool_id in definition.tools:
+                if tool_id not in manifest.definitions:
+                    warnings.append(f"Agent '{definition.id}' references missing tool '{tool_id}'.")
+                else:
+                    tool_def = manifest.definitions[tool_id]
+                    if not isinstance(tool_def, ToolDefinition):
+                        warnings.append(
+                            f"Agent '{definition.id}' references '{tool_id}' which is not a ToolDefinition "
+                            f"(got {type(tool_def).__name__})."
+                        )
+
     return warnings

{coreason_manifest-0.13.0.dist-info → coreason_manifest-0.16.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: coreason_manifest
-Version: 0.13.0
+Version: 0.16.0
 Summary: This package is the definitive source of truth. If it isn't in the manifest, it doesn't exist. If it violates the manifest, it doesn't run.
 License: # The Prosperity Public License 3.0.0
          
@@ -168,6 +168,8 @@ For full details, see the [Usage Documentation](docs/usage.md).
 
 ## Documentation
 
+**[Full Documentation Index](docs/index.md)**
+
 *   [Usage Guide](docs/usage.md): How to load and create manifests.
 *   [Governance & Policy Enforcement](docs/governance_policy_enforcement.md): Validating agents against organizational rules.
 *   [Coreason Agent Manifest (CAM)](docs/cap/specification.md): The Canonical YAML Authoring Format.

coreason_manifest-0.16.0.dist-info/RECORD

@@ -0,0 +1,26 @@
+coreason_manifest/__init__.py,sha256=zO49wgoUgYAwP7h_JoUdlJ_3vu2gxZVWP73ba8kzkv8,2588
+coreason_manifest/common.py,sha256=5gdVUFR9rD0yjXu9Ao6e-71E9_qwETZLmlBt38SDGU4,2157
+coreason_manifest/definitions/capabilities.py,sha256=7Ek87yB5BiMRBJWDyzrYx4zjPAAUXjB9wqLmvYDkv6g,726
+coreason_manifest/definitions/identity.py,sha256=Mm_VbGY0NfKCUzjXvZwMZSI0Sk24On2Mko-yNU7YL5w,1227
+coreason_manifest/definitions/message.py,sha256=CwtxeNkPmEUJO3takkg1NI0F3rfvQIrs4SoE4Dzaop8,1370
+coreason_manifest/definitions/presentation.py,sha256=IrJXyuyJIuHHqcIEr0Kl_u91S7EVyrUocIu5-kdV0ek,1781
+coreason_manifest/definitions/service.py,sha256=M80oa3aUERETB1QuYhpZRnPlgGXYHoYYPbM8qqFms38,1151
+coreason_manifest/governance.py,sha256=Yag7uIQRhWEVJ6Gp4vK5BVSbhE1dsxPI5Rz1V6lif2k,3460
+coreason_manifest/schemas/__init__.py,sha256=g1cCu1DprGcnGAiuvYWz5VeKKXIHYYwlrsqdkg9fRZY,412
+coreason_manifest/schemas/coreason-v2.schema.json,sha256=R2UqXEY1NSpNNtGpyJnjJ0jhnT4U6-2FKn-WPi4tnD0,11312
+coreason_manifest/spec/cap.py,sha256=3xbx3ekPdD_Py9NaqGrcillRSxdNdyp0PySg6ALdhbQ,3158
+coreason_manifest/utils/__init__.py,sha256=Kdz519fMq6c7Px3MP5oD_9jfqqFbCiaHPBQTc0LhyII,848
+coreason_manifest/utils/logger.py,sha256=Y9j1W0rFAh5lMAJbgMnqnyu9XmvgYdW895N5NeLvee0,461
+coreason_manifest/v2/__init__.py,sha256=1bWTcGLOXjSDv2TgYXoH5wsla0T2W2ulhUHsK5AzIgM,23
+coreason_manifest/v2/governance.py,sha256=HGvTIbAXXxvfuGSuUrWdoVdR9Z2UozD6F1qmmSzCm0o,6113
+coreason_manifest/v2/io.py,sha256=6B5wzyW-TbnKcUgOOBaurSdZg0kQPtPx35hlcsbe1Us,4311
+coreason_manifest/v2/resolver.py,sha256=7Lq58ECzW8QEnp17wpjef-LQQV2BdL74jzHgKmQMu2E,2265
+coreason_manifest/v2/spec/__init__.py,sha256=i8Agxsn9vs6wGCaxaHVNupRpPCeAIGTtiA9FKyoJsaU,40
+coreason_manifest/v2/spec/contracts.py,sha256=7UhE6v9ZB5I7k_6zH4NV8W_h3dtbVRMUX62XTuCROEw,1469
+coreason_manifest/v2/spec/definitions.py,sha256=AyWk3hsGgA3NjmScqzC15V2_OtPlpPaHOYByMa19l4s,6438
+coreason_manifest/v2/validator.py,sha256=Q2gHFbLZ95g5TCqxsvIBJanFP_UrvnIm09EKLvmYCDE,7987
+coreason_manifest-0.16.0.dist-info/METADATA,sha256=x_JWaNMx8QGt3i0ihJskvHFj9eKKkLkcOJjZ2l-X_YY,8275
+coreason_manifest-0.16.0.dist-info/WHEEL,sha256=kJCRJT_g0adfAJzTx2GUMmS80rTJIVHRCfG0DQgLq3o,88
+coreason_manifest-0.16.0.dist-info/licenses/LICENSE,sha256=3tYb7ZQe7sVXcbNmX22fDESFjOSIlCZodUGpZMkuSlk,3063
+coreason_manifest-0.16.0.dist-info/licenses/NOTICE,sha256=tqzUyP9VTCGxoHLgBI0AC1i0G7m_PSyESFL8Jwuw0dA,610
+coreason_manifest-0.16.0.dist-info/RECORD,,

coreason_manifest-0.13.0.dist-info/RECORD

@@ -1,20 +0,0 @@
-coreason_manifest/__init__.py,sha256=qy8VLZO7M4S_PWl4PB7PIztcPd_JgvKUW64S3oty0UY,1189
-coreason_manifest/common.py,sha256=ebQPiWiYSKFVAS6eXUyOIgJbsO8QDXVlFQKtSCQLRzg,2136
-coreason_manifest/governance.py,sha256=cR0q3TUbwTx2-ROGtVh9tP6o9XUiD2ekqoNsgCPDR2o,3299
-coreason_manifest/schemas/__init__.py,sha256=g1cCu1DprGcnGAiuvYWz5VeKKXIHYYwlrsqdkg9fRZY,412
-coreason_manifest/schemas/coreason-v2.schema.json,sha256=R2UqXEY1NSpNNtGpyJnjJ0jhnT4U6-2FKn-WPi4tnD0,11312
-coreason_manifest/utils/__init__.py,sha256=Kdz519fMq6c7Px3MP5oD_9jfqqFbCiaHPBQTc0LhyII,848
-coreason_manifest/utils/logger.py,sha256=Y9j1W0rFAh5lMAJbgMnqnyu9XmvgYdW895N5NeLvee0,461
-coreason_manifest/v2/__init__.py,sha256=1bWTcGLOXjSDv2TgYXoH5wsla0T2W2ulhUHsK5AzIgM,23
-coreason_manifest/v2/governance.py,sha256=nN2eu2YeASuDQglb35IOYm525LXWovMzAt9mba8loTY,5929
-coreason_manifest/v2/io.py,sha256=6B5wzyW-TbnKcUgOOBaurSdZg0kQPtPx35hlcsbe1Us,4311
-coreason_manifest/v2/resolver.py,sha256=lLPbNZcQjQ_GI71a7Rf-XiMM0CDgTy96nTLxm94gJLg,2313
-coreason_manifest/v2/spec/__init__.py,sha256=i8Agxsn9vs6wGCaxaHVNupRpPCeAIGTtiA9FKyoJsaU,40
-coreason_manifest/v2/spec/contracts.py,sha256=bDlYHDWlpSsIzDU8_fwXS2d0NjEHAPkIK3VpJbvcL7k,1354
-coreason_manifest/v2/spec/definitions.py,sha256=TV2JHBBq90jN18xg5sG9Y_swd1blcXyomLb1H6DkpW4,8603
-coreason_manifest/v2/validator.py,sha256=iTkpb_V38KbJ89h-Zne_1xep-XL44PS1PobZRnwV5K8,1504
-coreason_manifest-0.13.0.dist-info/METADATA,sha256=D4Hltcoz_4efVfP6PO3zG3H5gewSn5seUbOqjmCx54c,8228
-coreason_manifest-0.13.0.dist-info/WHEEL,sha256=kJCRJT_g0adfAJzTx2GUMmS80rTJIVHRCfG0DQgLq3o,88
-coreason_manifest-0.13.0.dist-info/licenses/LICENSE,sha256=3tYb7ZQe7sVXcbNmX22fDESFjOSIlCZodUGpZMkuSlk,3063
-coreason_manifest-0.13.0.dist-info/licenses/NOTICE,sha256=tqzUyP9VTCGxoHLgBI0AC1i0G7m_PSyESFL8Jwuw0dA,610
-coreason_manifest-0.13.0.dist-info/RECORD,,