@bluefly/openstandardagents 0.4.5 → 0.4.8

package/dist/spec/v0.4/extensions/token-efficiency/token-efficiency.schema.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openstandardagents.org/schemas/v0.5/extensions/token-efficiency.schema.json",
+  "title": "OSSA Token Efficiency Extension",
+  "description": "Extension schema for token efficiency, budget management, knowledge graph refs, and model routing",
+  "type": "object",
+  "properties": {
+    "optimization": {
+      "type": "object",
+      "properties": {
+        "enabled": { "type": "boolean", "default": true },
+        "baseline_tokens": { "type": "integer" },
+        "target_tokens": { "type": "integer" },
+        "target_reduction": { "type": "string" },
+        "techniques": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "knowledge_graph_refs",
+              "template_compression",
+              "semantic_compression",
+              "dynamic_budgets",
+              "checkpoint_retry",
+              "cascade_composition",
+              "circuit_breaker",
+              "observation_masking",
+              "lazy_loading",
+              "hierarchical_context",
+              "intelligent_routing",
+              "prefiltering",
+              "manifest_fingerprint"
+            ]
+          }
+        },
+        "benchmarks": {
+          "type": "object",
+          "properties": {
+            "baseline": { "type": "object" },
+            "optimized": { "type": "object" },
+            "improvement": { "type": "object" }
+          }
+        }
+      }
+    }
+  }
+}

package/dist/spec/v0.4/mcp.schema.json

@@ -0,0 +1 @@
+{"$schema":"http://json-schema.org/draft-07/schema#","$id":"https://openstandardagents.org/schemas/v0.4/mcp.schema.json","title":"OSSA v0.4 MCP Server Manifest Schema","description":"Open Standard for Software Agents (OSSA) - MCP Server manifest. Defines governed MCP server packages with identity, trust, and federation metadata.","type":"object","required":["apiVersion","kind","metadata","spec"],"properties":{"apiVersion":{"type":"string","pattern":"^ossa/v[0-9]+(\\.[0-9]+)*(-[a-zA-Z0-9.]+)?$","description":"OSSA API version","examples":["ossa/v1","ossa/v0.4"]},"kind":{"type":"string","const":"MCPServer","description":"Resource type — must be MCPServer"},"metadata":{"type":"object","required":["name"],"properties":{"name":{"type":"string","pattern":"^[a-z][a-z0-9-]*$","description":"DNS-style server name"},"version":{"type":"string","pattern":"^[0-9]+\\.[0-9]+\\.[0-9]+(-[a-zA-Z0-9.]+)?$"},"description":{"type":"string"},"did":{"type":"string","pattern":"^did:ossa:mcp:[a-z0-9-]+(:[a-z0-9-]+)*$","description":"Decentralized identifier for this MCP server"},"author":{"type":"object","properties":{"name":{"type":"string"},"did":{"type":"string"},"email":{"type":"string","format":"email"},"url":{"type":"string","format":"uri"}}},"license":{"type":"string"},"labels":{"type":"object","additionalProperties":{"type":"string"}},"created":{"type":"string","format":"date-time"},"updated":{"type":"string","format":"date-time"}}},"spec":{"type":"object","required":["transport"],"properties":{"description":{"type":"string"},"transport":{"type":"string","enum":["stdio","sse","streamable-http"],"description":"MCP transport type"},"command":{"type":"string","description":"Command to start the MCP server (for stdio transport)"},"args":{"type":"array","items":{"type":"string"},"description":"Command arguments"},"url":{"type":"string","format":"uri","description":"Server URL (for SSE/HTTP transport)"},"env":{"type":"object","additionalProperties":{"type":"string"},"description":"Environment variables required"},"tools":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"description":{"type":"string"},"inputSchema":{"type":"object"},"outputSchema":{"type":"object"}}},"description":"Declared tools this server provides"},"resources":{"type":"array","items":{"type":"object","properties":{"uri":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string"}}},"description":"Resources this server exposes"},"prompts":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"arguments":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"required":{"type":"boolean"}}}}}},"description":"Prompts this server exposes"},"platforms":{"type":"array","items":{"type":"string"},"description":"Compatible platforms"},"governance":{"type":"object","properties":{"approvalRequired":{"type":"boolean","default":false},"dataAccess":{"type":"object","properties":{"filesystem":{"type":"string","enum":["none","read-only","read-write","scoped"]},"network":{"type":"string","enum":["none","allowlist","full"]}}},"prohibitedActions":{"type":"array","items":{"type":"string"}}}},"trust":{"type":"object","properties":{"attestation":{"type":"string","format":"uri"},"lastAudit":{"type":"string","format":"date-time"},"signatures":{"type":"array","items":{"type":"object","properties":{"signer":{"type":"string"},"algorithm":{"type":"string"},"value":{"type":"string"}}}}}},"compliance":{"type":"array","items":{"type":"string"}}}},"extensions":{"type":"object","additionalProperties":true}}}

package/dist/spec/v0.4/skill.schema.json

@@ -0,0 +1 @@
+{"$schema":"http://json-schema.org/draft-07/schema#","$id":"https://openstandardagents.org/schemas/v0.4/skill.schema.json","title":"OSSA v0.4 Skill Manifest Schema","description":"Open Standard for Software Agents (OSSA) - Skill manifest. Defines portable, governed skill packages with identity, trust, compliance, and federation metadata. Superset of the Agent Skills (SKILL.md) specification.","type":"object","required":["apiVersion","kind","metadata","spec"],"properties":{"apiVersion":{"type":"string","pattern":"^ossa/v[0-9]+(\\.[0-9]+)*(-[a-zA-Z0-9.]+)?$","description":"OSSA API version","examples":["ossa/v1","ossa/v0.4"]},"kind":{"type":"string","const":"Skill","description":"Resource type — must be Skill"},"metadata":{"$ref":"#/definitions/SkillMetadata"},"spec":{"$ref":"#/definitions/SkillSpec"},"extensions":{"type":"object","description":"Framework-specific extensions","additionalProperties":true}},"definitions":{"SkillMetadata":{"type":"object","required":["name"],"properties":{"name":{"type":"string","pattern":"^[a-z][a-z0-9-]*$","description":"DNS-style skill name (lowercase, hyphens)","examples":["drupal-code-analysis","tdd-workflow","git-commit-review"]},"version":{"type":"string","pattern":"^[0-9]+\\.[0-9]+\\.[0-9]+(-[a-zA-Z0-9.]+)?$","description":"Semantic version","examples":["1.0.0","2.1.0-beta"]},"description":{"type":"string","description":"Human-readable description (maps to SKILL.md description frontmatter)"},"did":{"type":"string","pattern":"^did:ossa:skill:[a-z0-9-]+(:[a-z0-9-]+)*$","description":"Decentralized identifier for this skill","examples":["did:ossa:skill:drupal-code-analysis"]},"author":{"$ref":"#/definitions/Author"},"license":{"type":"string","description":"SPDX license identifier","examples":["Apache-2.0","MIT","CC-BY-4.0"]},"labels":{"type":"object","additionalProperties":{"type":"string"},"description":"Key-value labels for filtering and categorization"},"annotations":{"type":"object","additionalProperties":{"type":"string"},"description":"Non-identifying metadata"},"created":{"type":"string","format":"date-time","description":"ISO 8601 creation timestamp"},"updated":{"type":"string","format":"date-time","description":"ISO 8601 last update timestamp"}}},"Author":{"type":"object","properties":{"name":{"type":"string","description":"Author display name"},"did":{"type":"string","pattern":"^did:ossa:author:[a-z0-9-]+(:[a-z0-9-]+)*$","description":"Author DID"},"email":{"type":"string","format":"email"},"url":{"type":"string","format":"uri"},"vc":{"type":"string","format":"uri","description":"URL to verifiable credential"}}},"SkillSpec":{"type":"object","required":["description"],"properties":{"description":{"type":"string","description":"When to activate this skill. Maps to SKILL.md description. Should include trigger phrases."},"instructions":{"type":"string","description":"Full skill instructions (markdown). The body of SKILL.md. Can use !include for external file."},"instructionsFile":{"type":"string","description":"Path to external instructions file (relative to manifest). Alternative to inline instructions."},"categories":{"type":"array","items":{"type":"string"},"description":"Categorization tags for discovery","examples":[["drupal","migration","code-analysis"]]},"platforms":{"type":"array","items":{"type":"string","examples":["claude-code","cursor","codex-cli","goose","windsurf","gemini-cli","github-copilot","kiro","roo-code"]},"description":"Compatible AI coding platforms"},"allowedTools":{"type":"array","items":{"type":"string"},"description":"Pre-approved tools list. Maps to SKILL.md allowed-tools frontmatter.","examples":[["bash","file_read","file_write","web_search"]]},"runtimes":{"type":"object","description":"Runtime requirements by language","properties":{"node":{"type":"string","description":"Node.js version constraint"},"python":{"type":"string","description":"Python version constraint"},"php":{"type":"string","description":"PHP version constraint"},"ruby":{"type":"string","description":"Ruby version constraint"},"go":{"type":"string","description":"Go version constraint"}},"additionalProperties":{"type":"string"}},"dependencies":{"$ref":"#/definitions/SkillDependencies"},"trust":{"$ref":"#/definitions/TrustInfo"},"governance":{"$ref":"#/definitions/GovernanceInfo"},"compliance":{"type":"array","items":{"type":"string"},"description":"Compliance framework tags","examples":[["FedRAMP-moderate","NIST-800-53","SOC2-Type2"]]},"resources":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","description":"Relative path to resource file"},"description":{"type":"string"}},"required":["path"]},"description":"Additional resource files (templates, configs, examples)"},"scripts":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","description":"Relative path to script"},"description":{"type":"string"},"when":{"type":"string","description":"When to run: setup, teardown, on-activate"}},"required":["path"]},"description":"Helper scripts whose output enters agent context"},"tests":{"type":"array","items":{"type":"object","properties":{"prompt":{"type":"string","description":"Test prompt to send to agent with this skill"},"expectedBehavior":{"type":"string","description":"What the agent should do"},"assertions":{"type":"array","items":{"type":"string"}}},"required":["prompt","expectedBehavior"]},"description":"Skill evaluation test cases"}}},"SkillDependencies":{"type":"object","properties":{"skills":{"type":"array","items":{"type":"object","properties":{"did":{"type":"string","description":"DID of required skill"},"name":{"type":"string","description":"Skill name (if no DID)"},"version":{"type":"string","description":"Semver range"},"required":{"type":"boolean","default":true}}},"description":"Other skills this skill depends on"},"mcp":{"type":"array","items":{"type":"object","properties":{"uri":{"type":"string","format":"uri","description":"MCP server URI"},"name":{"type":"string"},"required":{"type":"boolean","default":false}}},"description":"MCP servers this skill requires"},"tools":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string","enum":["cli","api","mcp-tool","library"]},"version":{"type":"string"},"required":{"type":"boolean","default":true}},"required":["name"]},"description":"External tools this skill requires"}}},"TrustInfo":{"type":"object","properties":{"attestation":{"type":"string","format":"uri","description":"URL to cryptographic attestation document"},"testsPassed":{"type":"string","description":"Test results summary","examples":["47/47","12/12"]},"coverage":{"type":"string","description":"Test coverage percentage","examples":["94%","100%"]},"lastAudit":{"type":"string","format":"date-time","description":"Last security audit timestamp"},"signatures":{"type":"array","items":{"type":"object","properties":{"signer":{"type":"string"},"algorithm":{"type":"string","examples":["ed25519","rsa-sha256"]},"value":{"type":"string"},"timestamp":{"type":"string","format":"date-time"}}},"description":"Cryptographic signatures for tamper detection"}}},"GovernanceInfo":{"type":"object","properties":{"approvalRequired":{"type":"boolean","default":false,"description":"Whether org admin approval is needed to use this skill"},"maxAutonomy":{"type":"integer","minimum":0,"maximum":5,"description":"OSSA autonomy level (0=no autonomy, 5=full autonomy)"},"dataAccess":{"type":"object","properties":{"filesystem":{"type":"string","enum":["none","read-only","read-write","scoped"]},"network":{"type":"string","enum":["none","allowlist","full"]},"secrets":{"type":"string","enum":["none","read-only","read-write"]}},"description":"Data access boundaries"},"prohibitedActions":{"type":"array","items":{"type":"string"},"description":"Explicitly forbidden actions","examples":[["file_deletion","credential_access","external_network_calls"]]},"revocation":{"type":"object","properties":{"revoked":{"type":"boolean","default":false},"reason":{"type":"string"},"revokedAt":{"type":"string","format":"date-time"},"revokedBy":{"type":"string"}},"description":"Revocation status for compromised skills"}}}}}

package/dist/spec/v0.5/agent-card.schema.json

@@ -0,0 +1,477 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openstandardagents.org/schemas/v0.4/agent-card.schema.json",
+  "title": "OSSA Agent Card",
+  "description": "Universal agent contract for discovery, Agent Social profile, marketplace, and global/GitLab registry. Every attribute is defined in and projected from the OSSA agent spec (metadata, spec, or extensions). Single source of truth: OSSA manifest. Serve at .well-known/agent-card.json or .well-known/agent.json (A2A).",
+  "type": "object",
+  "required": ["uri", "name", "version", "ossaVersion", "capabilities", "endpoints", "transport", "authentication", "encryption"],
+  "properties": {
+    "uri": {
+      "type": "string",
+      "pattern": "^uadp://",
+      "description": "Agent URI in the format uadp://{namespace}/{name}"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Human-readable agent name"
+    },
+    "version": {
+      "type": "string",
+      "description": "Agent version (semver)"
+    },
+    "ossaVersion": {
+      "type": "string",
+      "description": "OSSA specification version (e.g., ossa/v0.4.6)"
+    },
+    "taxonomy": {
+      "type": "object",
+      "description": "Agent classification — runtime platform, functional role, architecture pattern",
+      "properties": {
+        "agentType": {
+          "type": "string",
+          "description": "Runtime platform: claude, kagent, openai, langchain, crewai, etc."
+        },
+        "agentKind": {
+          "type": "string",
+          "description": "Functional role: orchestrator, worker, reviewer, analyzer, etc."
+        },
+        "architecture": {
+          "type": "object",
+          "properties": {
+            "pattern": {
+              "type": "string",
+              "description": "Architecture pattern: swarm, pipeline, tree, graph, etc."
+            },
+            "capabilities": {
+              "type": "array",
+              "items": { "type": "string" },
+              "description": "Architecture capabilities: handoff, streaming, context, tools, vision"
+            },
+            "coordination": {
+              "type": "object",
+              "properties": {
+                "handoffStrategy": { "type": "string" },
+                "maxDepth": { "type": "integer" }
+              }
+            },
+            "runtime": {
+              "type": "object",
+              "properties": {
+                "scalability": { "type": "string" },
+                "executionModel": { "type": "string" },
+                "preferredRegion": { "type": "string" }
+              }
+            }
+          }
+        }
+      }
+    },
+    "capabilities": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "List of agent capabilities"
+    },
+    "tools": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["name", "description", "inputSchema"],
+        "properties": {
+          "name": { "type": "string" },
+          "description": { "type": "string" },
+          "inputSchema": { "type": "object" },
+          "outputSchema": { "type": "object" }
+        }
+      },
+      "description": "Tools the agent can call"
+    },
+    "role": {
+      "type": "string",
+      "description": "Agent's role/system prompt summary"
+    },
+    "model": {
+      "type": "object",
+      "description": "LLM configuration powering this agent",
+      "properties": {
+        "provider": { "type": "string", "description": "LLM provider: anthropic, openai, google, etc." },
+        "model": { "type": "string", "description": "Model identifier" },
+        "temperature": { "type": "number", "minimum": 0, "maximum": 2 },
+        "maxTokens": { "type": "integer" },
+        "topP": { "type": "number", "minimum": 0, "maximum": 1 }
+      }
+    },
+    "mcpServers": {
+      "type": "array",
+      "description": "MCP (Model Context Protocol) servers this agent connects to",
+      "items": {
+        "type": "object",
+        "required": ["name"],
+        "properties": {
+          "name": { "type": "string" },
+          "description": { "type": "string" },
+          "transport": {
+            "type": "object",
+            "properties": {
+              "type": { "type": "string", "enum": ["stdio", "sse", "streamable-http"] },
+              "command": { "type": "string" },
+              "args": { "type": "array", "items": { "type": "string" } },
+              "url": { "type": "string" }
+            }
+          },
+          "version": { "type": "string" },
+          "capabilities": {
+            "type": "object",
+            "properties": {
+              "resources": { "type": "object" },
+              "tools": { "type": "object" },
+              "logging": { "type": "object" }
+            }
+          },
+          "resources": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["uri", "name"],
+              "properties": {
+                "uri": { "type": "string" },
+                "name": { "type": "string" },
+                "description": { "type": "string" },
+                "mimeType": { "type": "string" }
+              }
+            }
+          }
+        }
+      }
+    },
+    "a2aProtocol": {
+      "type": "object",
+      "description": "A2A (Agent-to-Agent) protocol configuration",
+      "properties": {
+        "protocol": {
+          "type": "object",
+          "properties": {
+            "type": { "type": "string" },
+            "version": { "type": "string" },
+            "messageFormat": { "type": "string" }
+          }
+        },
+        "agentEndpoints": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["agentId", "url"],
+            "properties": {
+              "agentId": { "type": "string" },
+              "url": { "type": "string" },
+              "capabilities": { "type": "array", "items": { "type": "string" } },
+              "priority": { "type": "integer" }
+            }
+          }
+        },
+        "routing": {
+          "type": "object",
+          "properties": {
+            "strategy": { "type": "string" },
+            "rules": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": ["name", "condition", "target"],
+                "properties": {
+                  "name": { "type": "string" },
+                  "condition": { "type": "string" },
+                  "target": { "type": "string" },
+                  "priority": { "type": "integer" }
+                }
+              }
+            }
+          }
+        },
+        "delegation": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean" },
+            "maxDepth": { "type": "integer" },
+            "timeout": { "type": "integer" },
+            "handoffRules": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": ["name", "condition", "target"],
+                "properties": {
+                  "name": { "type": "string" },
+                  "condition": { "type": "string" },
+                  "target": { "type": "string" },
+                  "message": { "type": "string" }
+                }
+              }
+            }
+          }
+        },
+        "completionSignals": {
+          "type": "object",
+          "properties": {
+            "signals": { "type": "array", "items": { "type": "string" } },
+            "handlers": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": ["signal", "action"],
+                "properties": {
+                  "signal": { "type": "string" },
+                  "action": { "type": "string" },
+                  "target": { "type": "string" }
+                }
+              }
+            }
+          }
+        },
+        "retryPolicy": {
+          "type": "object",
+          "properties": {
+            "maxRetries": { "type": "integer" },
+            "backoff": { "type": "string" },
+            "retryableErrors": { "type": "array", "items": { "type": "string" } }
+          }
+        },
+        "circuitBreaker": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean" },
+            "failureThreshold": { "type": "integer" },
+            "timeout": { "type": "integer" }
+          }
+        }
+      }
+    },
+    "handoffs": {
+      "type": "array",
+      "description": "Direct delegation targets",
+      "items": {
+        "type": "object",
+        "required": ["to"],
+        "properties": {
+          "to": { "type": "string" },
+          "condition": { "type": "string" }
+        }
+      }
+    },
+    "autonomy": {
+      "type": "object",
+      "description": "Agent independence level and operational boundaries",
+      "properties": {
+        "level": { "type": "string", "description": "Autonomy level: supervised, autonomous, semi-autonomous" },
+        "approvalRequired": { "type": "boolean" },
+        "allowedActions": { "type": "array", "items": { "type": "string" } },
+        "blockedActions": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "constraints": {
+      "type": "object",
+      "description": "Operational limits — cost, performance, resources",
+      "properties": {
+        "cost": {
+          "type": "object",
+          "properties": {
+            "maxTokensPerDay": { "type": "integer" },
+            "maxTokensPerRequest": { "type": "integer" },
+            "maxCostPerDay": { "type": "number" },
+            "currency": { "type": "string" }
+          }
+        },
+        "performance": {
+          "type": "object",
+          "properties": {
+            "maxLatencySeconds": { "type": "number" },
+            "maxConcurrentRequests": { "type": "integer" },
+            "timeoutSeconds": { "type": "number" }
+          }
+        },
+        "resources": {
+          "type": "object",
+          "properties": {
+            "cpu": { "type": "string" },
+            "memory": { "type": "string" }
+          }
+        }
+      }
+    },
+    "observability": {
+      "type": "object",
+      "description": "Tracing, metrics, and logging configuration",
+      "properties": {
+        "tracing": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean" },
+            "exporter": { "type": "string" },
+            "endpoint": { "type": "string" },
+            "samplingRate": { "type": "number" }
+          }
+        },
+        "metrics": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean" },
+            "exporter": { "type": "string" },
+            "endpoint": { "type": "string" }
+          }
+        },
+        "logging": {
+          "type": "object",
+          "properties": {
+            "level": { "type": "string" },
+            "format": { "type": "string" }
+          }
+        }
+      }
+    },
+    "endpoints": {
+      "type": "object",
+      "properties": {
+        "http": { "type": "string", "format": "uri" },
+        "grpc": { "type": "string" },
+        "websocket": { "type": "string", "format": "uri" }
+      },
+      "description": "Network endpoints for reaching the agent"
+    },
+    "transport": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": ["http", "grpc", "websocket", "mqtt"]
+      },
+      "minItems": 1,
+      "description": "Supported transport protocols"
+    },
+    "authentication": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": ["mtls", "bearer", "oidc", "api_key", "none"]
+      },
+      "minItems": 1,
+      "description": "Supported authentication methods"
+    },
+    "encryption": {
+      "type": "object",
+      "required": ["tlsRequired", "minTlsVersion"],
+      "properties": {
+        "tlsRequired": { "type": "boolean" },
+        "minTlsVersion": { "type": "string", "enum": ["1.2", "1.3"] },
+        "cipherSuites": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "metadata": {
+      "type": "object",
+      "properties": {
+        "team": { "type": "string" },
+        "environment": { "type": "string" },
+        "region": { "type": "string" },
+        "description": { "type": "string" },
+        "author": { "type": "string" }
+      },
+      "additionalProperties": true,
+      "description": "Additional metadata"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["healthy", "degraded", "unavailable"],
+      "description": "Current agent health status"
+    },
+    "lastHeartbeat": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Last heartbeat timestamp (ISO 8601)"
+    },
+    "state": {
+      "type": "object",
+      "description": "State persistence for discovery and session resume (SoD: defined in OSSA manifest, projected here)",
+      "properties": {
+        "mode": {
+          "type": "string",
+          "enum": ["stateless", "session", "long_running"],
+          "description": "State persistence mode"
+        },
+        "storageHint": {
+          "type": "string",
+          "description": "Storage backend: redis, postgres, vector-db, kv, custom"
+        },
+        "sessionEndpoint": {
+          "type": "string",
+          "format": "uri",
+          "description": "URL to create or resume session"
+        },
+        "checkpointIntervalSeconds": {
+          "type": "integer",
+          "description": "Checkpoint interval in seconds"
+        },
+        "retention": {
+          "type": "string",
+          "description": "Data retention e.g. 30d, 1h"
+        }
+      }
+    },
+    "tokenEfficiencySummary": {
+      "type": "object",
+      "description": "Token efficiency hints for routing and cost (SoD: defined in OSSA manifest, projected here)",
+      "properties": {
+        "serializationProfile": {
+          "type": "string",
+          "enum": ["compact", "full", "fingerprint"]
+        },
+        "observationFormat": {
+          "type": "string",
+          "enum": ["projected", "summary", "diff", "full"]
+        },
+        "maxInputTokens": { "type": "integer" },
+        "cascade": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Model cascade e.g. haiku, sonnet, opus"
+        },
+        "consolidationStrategy": { "type": "string" }
+      }
+    },
+    "manifestRef": {
+      "type": "string",
+      "format": "uri",
+      "description": "URL to full OSSA manifest (single source of truth)"
+    },
+    "manifestDigest": {
+      "type": "string",
+      "description": "Content digest of manifest (e.g. SHA-256) for integrity and deduplication"
+    },
+    "separation": {
+      "type": "object",
+      "description": "Separation of duties for discovery and policy (SoD: defined in OSSA spec.access and spec.separation)",
+      "properties": {
+        "accessTier": {
+          "type": "string",
+          "enum": ["tier_1_read", "tier_2_write_limited", "tier_3_write_elevated", "tier_4_policy"]
+        },
+        "role": {
+          "type": "string",
+          "description": "Primary role (e.g. reviewer, deployer)"
+        },
+        "conflictsWith": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Roles this agent must not also perform"
+        }
+      }
+    },
+    "cardProfile": {
+      "type": "string",
+      "enum": ["minimal", "discovery", "full"],
+      "description": "Card profile: minimal (uri,name,capabilities), discovery (+ state, tokenEfficiency), full (all)"
+    },
+    "extensions": {
+      "type": "object",
+      "additionalProperties": true,
+      "description": "Extension data for platform-specific fields"
+    }
+  },
+  "additionalProperties": false
+}