{"openapi":"3.1.0","info":{"title":"Forge Cascade Agent Core","version":"1.0.0","description":"Compact OpenAPI profile for source-backed capsule retrieval, graph queries, MCP, and A2A discovery."},"servers":[{"url":"https://forgecascade.org","description":"Production"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"x-service-info":{"categories":["data","knowledge-graph","agent-tools"],"docs":{"humanGuide":"https://forgecascade.org/docs/agents","llms":"https://forgecascade.org/llms.txt","llmsFull":"https://forgecascade.org/llms-full.txt","apiReference":"https://forgecascade.org/api/docs","mcp":"https://forgecascade.org/.well-known/mcp.json","a2a":"https://forgecascade.org/.well-known/agent.json"}},"paths":{"/api/v1/agent-gateway/register":{"post":{"summary":"Register an agent","description":"Creates an API key and session metadata for an agent client.","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["agent_name","platform"],"properties":{"agent_name":{"type":"string"},"platform":{"type":"string"},"description":{"type":"string"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Agent API key issued"}}}},"/api/v1/agent-gateway/search":{"post":{"summary":"Search source-backed capsules","description":"Semantic capsule search for authenticated agents.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string"},"max_results":{"type":"integer","minimum":1,"maximum":50,"default":10},"capsule_type":{"type":"string"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Search results"}}}},"/api/v1/agent-gateway/query":{"post":{"summary":"Query the knowledge graph","description":"Runs natural-language, semantic, graph traversal, or governed aggregation queries.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query_type":{"type":"string","enum":["natural_language","semantic_search","graph_traverse","aggregation"],"default":"natural_language"},"query_text":{"type":"string"},"start_node":{"type":"string"},"depth":{"type":"integer","minimum":1,"maximum":5,"default":2},"max_results":{"type":"integer","minimum":1,"maximum":100,"default":10}},"additionalProperties":false}}}},"responses":{"200":{"description":"Query results"}}}},"/api/v1/agent-gateway/capsule/{capsule_id}":{"get":{"summary":"Retrieve one capsule","parameters":[{"name":"capsule_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Capsule"}}}},"/api/v1/agent-gateway/capsule/{capsule_id}/lineage":{"get":{"summary":"Retrieve capsule lineage","parameters":[{"name":"capsule_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"max_depth","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":15}}],"responses":{"200":{"description":"Lineage graph"}}}},"/api/v1/capsules/public/browse":{"get":{"summary":"Browse the public source-backed catalog","description":"Unauthenticated catalog browse. Defaults to verified, source-backed, answer-eligible capsules.","security":[],"parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"tags","in":"query","schema":{"type":"string"}},{"name":"type","in":"query","schema":{"type":"string"}},{"name":"min_trust","in":"query","schema":{"type":"integer","default":60}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}},{"name":"include_exploratory","in":"query","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Public capsule list"}}}},"/api/v1/capsules/public/status":{"get":{"summary":"Get public capsule corpus status","security":[],"responses":{"200":{"description":"Aggregate public corpus health"}}}},"/.well-known/agent.json":{"get":{"summary":"A2A agent card","security":[],"responses":{"200":{"description":"Agent-to-agent discovery card"}}}},"/.well-known/mcp.json":{"get":{"summary":"MCP server manifest","security":[],"responses":{"200":{"description":"MCP tools, resources, prompts, and auth metadata"}}}}},"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"},"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}}}}