{"openapi":"3.1.0","info":{"title":"Codex Skills Hub","description":"Intelligent Semantic Router and Execution Gateway with theproxy Identity & Cloudflare Edge Optimization","version":"2.4.0"},"servers":[{"url":"https://skills.vibeworkplace.net","description":"Cloudflare Edge Gateway"},{"url":"https://skills.xsfire.com","description":"Direct Remote Dokploy Server"},{"url":"http://127.0.0.1:8090","description":"Local Development & Background Daemon"}],"paths":{"/api/auth/theproxy/login":{"get":{"summary":"theproxy OIDC Login Redirect","description":"Redirects the browser to theproxy OIDC login interface.","operationId":"theproxy_sso_login_api_auth_theproxy_login_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/auth/theproxy/callback":{"get":{"summary":"theproxy OIDC Callback Handler","description":"Receives OIDC code from theproxy, exchanges token, and logs in the admin user.","operationId":"theproxy_sso_callback_api_auth_theproxy_callback_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code"}},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/login":{"post":{"summary":"Direct theproxy Token / Key Login","description":"Verifies theproxy account token or admin access key.","operationId":"admin_login_api_auth_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/verify":{"get":{"summary":"Verify theproxy Session","operationId":"verify_admin_session_api_auth_verify_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/route":{"post":{"summary":"Auto-route task and get full skill instructions","operationId":"route_task","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RouteTaskRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RouteTaskResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/execute":{"post":{"summary":"Execute a script inside a skill","description":"Executes a script from the target skill's scripts/ directory.","operationId":"execute_script","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecuteScriptRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecuteScriptResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/skills":{"get":{"summary":"List all available skills","operationId":"list_skills","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SkillItem"},"type":"array","title":"Response List Skills"}}}}}}},"/skills/{skill_name}":{"get":{"summary":"Get specific skill instructions","operationId":"get_skill_detail","parameters":[{"name":"skill_name","in":"path","required":true,"schema":{"type":"string","title":"Skill Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/healthz":{"get":{"summary":"Health Check","operationId":"health_check","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/cf/edge-info":{"get":{"summary":"Cloudflare Edge & CDN Diagnostics","operationId":"get_cf_edge_info_api_cf_edge_info_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/governance/portfolio":{"get":{"summary":"Audit entire skill portfolio and get consolidation recommendations","operationId":"get_portfolio_audit_endpoint_api_governance_portfolio_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/governance/patterns":{"get":{"summary":"List logged If-Then patterns","operationId":"get_patterns_endpoint_api_governance_patterns_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"summary":"Record a new If-Then pattern into the ledger","operationId":"record_pattern_endpoint_api_governance_patterns_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatternLogRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/governance/consolidate":{"post":{"summary":"Execute adaptive merge, route, or distill consolidation","operationId":"execute_consolidation_endpoint_api_governance_consolidate_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsolidateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/governance/skills/create":{"post":{"summary":"Create a new 7-Gate compliant skill","operationId":"create_skill_endpoint_api_governance_skills_create_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSkillRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/governance/skills/update":{"post":{"summary":"Update SKILL.md and verify","operationId":"update_skill_endpoint_api_governance_skills_update_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSkillRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/governance/skills/validate":{"post":{"summary":"Run 7-Gate audit on a single skill","operationId":"validate_single_skill_endpoint_api_governance_skills_validate_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_validate_single_skill_endpoint_api_governance_skills_validate_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/network/graph":{"get":{"summary":"Get exhaustive Verb-Node Concept Flow Network Graph","operationId":"get_concept_network_graph_api_network_graph_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/network/route":{"post":{"summary":"Route task through topological Verb-Node Concept Map with multi-skill pipeline","operationId":"route_via_concept_network_api_network_route_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetworkRouteRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/korean/decompose":{"post":{"summary":"Decompose Korean task into Domain Boundary, Relational Postpositions, and Action Verbs","operationId":"decompose_korean_endpoint_api_korean_decompose_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KoreanDecomposeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin":{"get":{"summary":"Admin Control Panel Dashboard","operationId":"admin_dashboard_endpoint_admin_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/":{"get":{"summary":"Admin Control Panel Dashboard","operationId":"admin_dashboard_endpoint__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"Body_validate_single_skill_endpoint_api_governance_skills_validate_post":{"properties":{"skill_name":{"type":"string","title":"Skill Name"}},"type":"object","required":["skill_name"],"title":"Body_validate_single_skill_endpoint_api_governance_skills_validate_post"},"ConsolidateRequest":{"properties":{"action":{"type":"string","title":"Action","description":"'merge', 'route', or 'distill'"},"primary_skill":{"type":"string","title":"Primary Skill","description":"The canonical target skill"},"secondary_skill":{"type":"string","title":"Secondary Skill","description":"The redundant or secondary skill"},"custom_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Custom Note","description":"Reason or note for consolidation","default":""}},"type":"object","required":["action","primary_skill","secondary_skill"],"title":"ConsolidateRequest"},"CreateSkillRequest":{"properties":{"name":{"type":"string","title":"Name","description":"Skill name"},"description":{"type":"string","title":"Description","description":"Skill description"},"as_is":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As Is","description":"AS-IS state","default":"미정의 현재 상태"},"to_be":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"To Be","description":"TO-BE state","default":"검증 완료된 목표 상태"},"gap":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gap","description":"GAP definition","default":"절차적 실행을 통한 상태 전이"},"scripts":{"anyOf":[{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array"},{"type":"null"}],"title":"Scripts","description":"Optional script list"}},"type":"object","required":["name","description"],"title":"CreateSkillRequest"},"ExecuteScriptRequest":{"properties":{"skill_name":{"type":"string","title":"Skill Name","description":"The target skill name"},"script_name":{"type":"string","title":"Script Name","description":"The script name under scripts/ to execute"},"args":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Args","description":"Optional command line arguments"}},"type":"object","required":["skill_name","script_name"],"title":"ExecuteScriptRequest"},"ExecuteScriptResponse":{"properties":{"status":{"type":"string","title":"Status","description":"'success', 'error', or 'timeout'"},"exit_code":{"type":"integer","title":"Exit Code","description":"Process exit code"},"stdout":{"type":"string","title":"Stdout","description":"Standard output from the script"},"stderr":{"type":"string","title":"Stderr","description":"Standard error from the script"}},"type":"object","required":["status","exit_code","stdout","stderr"],"title":"ExecuteScriptResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"KoreanDecomposeRequest":{"properties":{"text":{"type":"string","title":"Text","description":"Korean natural language task sentence or bracketed phrase"}},"type":"object","required":["text"],"title":"KoreanDecomposeRequest"},"LoginRequest":{"properties":{"key":{"type":"string","title":"Key","description":"theproxy Account Token or Master Admin Key"}},"type":"object","required":["key"],"title":"LoginRequest"},"NetworkRouteRequest":{"properties":{"task":{"type":"string","title":"Task","description":"User task or prompt to route through the concept graph"}},"type":"object","required":["task"],"title":"NetworkRouteRequest"},"PatternLogRequest":{"properties":{"trigger_context":{"type":"string","title":"Trigger Context","description":"The situation, failure signal, or friction context"},"action_taken":{"type":"string","title":"Action Taken","description":"Action or adaptation attempted"},"result_status":{"type":"string","title":"Result Status","description":"'success', 'partial', 'failure'","default":"success"},"lesson_rule":{"type":"string","title":"Lesson Rule","description":"Derived If-Then operational rule"},"impact_skills":{"items":{"type":"string"},"type":"array","title":"Impact Skills","description":"Associated skills"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author","description":"Author identifier","default":"theproxy-operator"}},"type":"object","required":["trigger_context","action_taken","lesson_rule"],"title":"PatternLogRequest"},"PipelineStep":{"properties":{"skill":{"type":"string","title":"Skill"},"role":{"type":"string","title":"Role"},"stage":{"type":"string","title":"Stage"}},"type":"object","required":["skill","role","stage"],"title":"PipelineStep"},"RouteTaskRequest":{"properties":{"task":{"type":"string","title":"Task","description":"The user's task or question to route"}},"type":"object","required":["task"],"title":"RouteTaskRequest"},"RouteTaskResponse":{"properties":{"selected_skill":{"type":"string","title":"Selected Skill","description":"The best matching skill name"},"description":{"type":"string","title":"Description","description":"Skill description"},"confidence_score":{"type":"number","title":"Confidence Score","description":"Match confidence"},"available_scripts":{"items":{"type":"string"},"type":"array","title":"Available Scripts","description":"List of executable script names"},"execution_pipeline":{"items":{"$ref":"#/components/schemas/PipelineStep"},"type":"array","title":"Execution Pipeline","description":"Sequential Multi-Skill Execution Chain"},"korean_decomposition":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Korean Decomposition","description":"Korean Relational Semantic Decomposition breakdown"},"instructions":{"type":"string","title":"Instructions","description":"The full instructions and rules of the selected skill"},"candidate_skills":{"items":{"type":"string"},"type":"array","title":"Candidate Skills","description":"Alternative skill candidates"}},"type":"object","required":["selected_skill","description","confidence_score","instructions"],"title":"RouteTaskResponse"},"SkillItem":{"properties":{"name":{"type":"string","title":"Name","description":"Skill name"},"description":{"type":"string","title":"Description","description":"Skill description"}},"type":"object","required":["name","description"],"title":"SkillItem"},"UpdateSkillRequest":{"properties":{"skill_name":{"type":"string","title":"Skill Name","description":"Skill name to update"},"content":{"type":"string","title":"Content","description":"New raw Markdown content of SKILL.md"}},"type":"object","required":["skill_name","content"],"title":"UpdateSkillRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}