{"openapi":"3.1.0","info":{"title":"FullStack AI Hub Knowledge Consumer (ChatGPT Custom Action & Plugin)","version":"1.3.0","description":"Read-only knowledge research API for ChatGPT and IDE assistants. Access 560 verified concepts, 25 system breakdowns with dynamic 3-9 layers, 11 papers, 13 WASM challenges, and AST codebase graphs."},"servers":[{"url":"https://fullstackaihub.com","description":"Apex Instant Gateway"},{"url":"https://mcp.fullstackaihub.com","description":"Dedicated Subdomain Gateway"}],"paths":{"/api/consumer/search":{"get":{"operationId":"searchKnowledge","summary":"Search Curriculum & Systems","description":"Full-text search across concepts, 3-9 layer system breakdowns, research papers, and guides.","parameters":[{"name":"q","in":"query","required":true,"description":"Search keyword or query string","schema":{"type":"string"}},{"name":"domain","in":"query","required":false,"description":"Filter results by domain slug","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Maximum number of items to return","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Search results list"}}}},"/api/consumer/concepts/{slug}":{"get":{"operationId":"getConceptBySlug","summary":"Get Canonical Concept Lesson","description":"Retrieve verified concept lesson including frontmatter, mental models, trade-offs, and MDX body.","parameters":[{"name":"slug","in":"path","required":true,"description":"Concept slug or unique identifier","schema":{"type":"string"}}],"responses":{"200":{"description":"Concept lesson details"},"404":{"description":"Concept not found"}}}},"/api/consumer/concepts/{slug}/relations":{"get":{"operationId":"getConceptRelations","summary":"Get Concept Knowledge Graph Relations","description":"Retrieve inbound and outbound directed edges (prerequisites, enables, alternatives) for a concept.","parameters":[{"name":"slug","in":"path","required":true,"description":"Concept slug or identifier","schema":{"type":"string"}}],"responses":{"200":{"description":"Concept relations list"},"404":{"description":"Concept not found"}}}},"/api/consumer/systems/{slug}":{"get":{"operationId":"getSystemBreakdown","summary":"Get 3-9 Layer System Breakdown","description":"Retrieve full multi-layer architectural system breakdown with subsystem chapters, nodes, and packet flows.","parameters":[{"name":"slug","in":"path","required":true,"description":"System identifier (e.g. inside-vllm)","schema":{"type":"string"}},{"name":"includeHotPathCode","in":"query","required":false,"description":"Whether to include source line anchors and snippets","schema":{"type":"boolean","default":true}}],"responses":{"200":{"description":"System architecture breakdown"},"404":{"description":"System not found"}}}},"/api/consumer/systems/{slug}/trace":{"get":{"operationId":"getSystemStepTrace","summary":"Get System Execution Step Traces","description":"Retrieve granular execution traces, packet flows, and state variable deltas for a system architecture.","parameters":[{"name":"slug","in":"path","required":true,"description":"System identifier","schema":{"type":"string"}},{"name":"chapterId","in":"query","required":false,"description":"Subsystem chapter filter","schema":{"type":"string"}},{"name":"diagramId","in":"query","required":false,"description":"Diagram identifier filter","schema":{"type":"string"}},{"name":"stepId","in":"query","required":false,"description":"Specific execution step ID","schema":{"type":"string"}}],"responses":{"200":{"description":"Execution step traces"},"404":{"description":"System or step trace not found"}}}},"/api/consumer/systems/{slug}/timeline":{"get":{"operationId":"getSystemTimeline","summary":"Get System Memory Layouts & Execution Timeline","description":"Retrieve analyzed hardware memory layouts, byte offsets, cache line alignment, and execution timeline for a system.","parameters":[{"name":"slug","in":"path","required":true,"description":"System identifier","schema":{"type":"string"}}],"responses":{"200":{"description":"Analyzed memory layouts and timeline"},"404":{"description":"System not found"}}}},"/api/consumer/codebase/{systemId}":{"get":{"operationId":"getCodebaseGraph","summary":"Get Dynamic AST Codebase Graph","description":"Retrieve AST class/function symbol graph mapped across contextual dynamic layers (3-9 layers).","parameters":[{"name":"systemId","in":"path","required":true,"description":"Reference system ID (e.g. inside-vllm)","schema":{"type":"string"}},{"name":"layerId","in":"query","required":false,"description":"Filter nodes to specific layer ID","schema":{"type":"string"}},{"name":"includeSnippets","in":"query","required":false,"description":"Whether to include code snippets","schema":{"type":"boolean","default":true}}],"responses":{"200":{"description":"Codebase AST graph"},"404":{"description":"Codebase graph not found"}}}},"/api/consumer/papers":{"get":{"operationId":"listPaperBreakdowns","summary":"List Academic Paper Breakdowns","description":"List seminal research paper breakdowns with methodology and evidence ratings.","parameters":[{"name":"query","in":"query","required":false,"description":"Filter by title or method","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max number of items","schema":{"type":"integer","default":20}}],"responses":{"200":{"description":"List of research paper breakdowns"}}}},"/api/consumer/papers/{slug}":{"get":{"operationId":"getPaperBreakdown","summary":"Get Paper Breakdown Details","description":"Retrieve complete paper analysis, mathematical foundations, and implementation takeaways.","parameters":[{"name":"slug","in":"path","required":true,"description":"Publication slug","schema":{"type":"string"}}],"responses":{"200":{"description":"Paper breakdown details"},"404":{"description":"Paper breakdown not found"}}}},"/api/consumer/blog":{"get":{"operationId":"listBlogPosts","summary":"List Engineering Blog Posts & Essays","description":"Retrieve published engineering blog posts, essays, guides, and briefings with canonical URLs and tags.","parameters":[{"name":"type","in":"query","required":false,"description":"Filter by type (all, essay, guide, brief, executive-briefing)","schema":{"type":"string"}},{"name":"tag","in":"query","required":false,"description":"Filter by topic tag","schema":{"type":"string"}},{"name":"query","in":"query","required":false,"description":"Search keywords in title, summary, or tags","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max items to return","schema":{"type":"integer","default":30}}],"responses":{"200":{"description":"List of published engineering blog posts"}}}},"/api/consumer/pathways/solve":{"post":{"operationId":"solveAdaptivePathway","summary":"Solve Adaptive Study Pathway","description":"Solve a prerequisite-safe topological study sequence with dynamic BKT retrievability decay.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["targetConceptIds"],"properties":{"targetConceptIds":{"type":"array","items":{"type":"string"},"description":"Target concept IDs or slugs"},"horizonDays":{"type":"integer","default":14},"dailyMinutesBudget":{"type":"integer","default":45}}}}}},"responses":{"200":{"description":"Generated ScheduledPath and PacingAdvice"},"400":{"description":"Invalid request or unknown target concepts"}}}},"/api/consumer/copilot/socratic-diagnose":{"post":{"operationId":"socraticDiagnoseChallenge","summary":"Generate Socratic Non-Spoiler Diagnostic Hint","description":"Generate a structured 3-part Socratic diagnostic hint for a failing WASM kernel challenge.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["challengeId","failingTestOutput"],"properties":{"challengeId":{"type":"string"},"failingTestOutput":{"type":"string"},"userCodeSnippet":{"type":"string"}}}}}},"responses":{"200":{"description":"3-part Socratic non-spoiler diagnostic"},"400":{"description":"Invalid request parameters"}}}},"/api/consumer/wasm-challenges":{"get":{"operationId":"listWasmChallenges","summary":"List Interactive WASM Kernel Challenges","description":"List interactive Pyodide WebAssembly runtime kernel implementation challenges.","parameters":[{"name":"category","in":"query","required":false,"description":"Category filter (autograd, attention, memory, search)","schema":{"type":"string"}}],"responses":{"200":{"description":"List of WASM challenges"}}}},"/api/consumer/wasm-challenges/{id}":{"get":{"operationId":"getWasmChallenge","summary":"Get WASM Kernel Challenge","description":"Retrieve challenge specification, starter code, solution, and test assertions.","parameters":[{"name":"id","in":"path","required":true,"description":"WASM challenge ID","schema":{"type":"string"}}],"responses":{"200":{"description":"WASM challenge definition"},"404":{"description":"WASM challenge not found"}}}},"/mcp":{"post":{"operationId":"callKnowledgeConsumerTool","summary":"Execute Knowledge Retrieval Tool","description":"Call search, concept, system, codebase graph, or paper analysis tools via JSON-RPC.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"jsonrpc":{"type":"string","example":"2.0"},"id":{"type":"integer","example":1},"method":{"type":"string","example":"tools/call"},"params":{"type":"object","properties":{"name":{"type":"string","enum":["fsai.search_knowledge","fsai.get_hybrid_context","fsai.get_concept","fsai.get_concept_relations","fsai.get_system_breakdown","fsai.get_system_step_trace","fsai.query_architecture_route","fsai.get_codebase_graph","fsai.query_codebase_symbols","fsai.list_papers","fsai.get_paper_breakdown","fsai.list_wasm_challenges","fsai.get_wasm_challenge","fsai.get_learning_path","fsai.get_evidence_source","fsai.list_territories","fsai.get_publication","fsai.get_reference_guide","fsai.get_server_profile","fsai.list_blog_posts","fsai.get_blog_taxonomy"]},"arguments":{"type":"object"}},"required":["name","arguments"]}},"required":["jsonrpc","method","params"]}}}},"responses":{"200":{"description":"Structured JSON-RPC tool result"},"401":{"description":"Invalid or missing Bearer token"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"FSAI Live API Key with read:curriculum and read:systems scopes"}}}}