{"components":{"schemas":{"AgentToolDescriptor":{"additionalProperties":false,"description":"Provider-neutral tool description. It grants neither semantic authority nor permission to execute an action.","properties":{"authorizationGranted":{"const":"none"},"dataHandling":{"type":"object"},"description":{"type":"string"},"discovery":{"type":"object"},"inputSchema":{"type":"object"},"invocationPolicy":{"type":"object"},"name":{"const":"resolve_embedded_semantics"},"outputContract":{"type":"object"},"schema":{"const":"embedded-semantics.agent-tool.v1"},"sideEffects":{"const":"none"},"title":{"type":"string"},"transport":{"type":"object"},"version":{"type":"string"}},"required":["schema","version","name","title","description","sideEffects","authorizationGranted","transport","invocationPolicy","inputSchema","dataHandling","outputContract","discovery"],"type":"object"},"Candidate":{"additionalProperties":false,"description":"Probabilistic evidence only. A candidate is never a ConceptCode assignment.","properties":{"code":{"type":"string"},"name":{"type":"string"},"score":{"type":"number"}},"required":["code","name","score"],"type":"object"},"ConceptDetail":{"additionalProperties":false,"properties":{"canonicalUrl":{"format":"uri","type":"string"},"code":{"type":"string"},"definition":{"type":"string"},"domain":{"type":"string"},"expressions":{"items":{"$ref":"#/components/schemas/ConceptExpression"},"type":"array"},"name":{"type":"string"},"provenance":{},"registryVersion":{"type":"string"},"renderings":{"items":{"$ref":"#/components/schemas/ConceptRendering"},"type":"array"}},"required":["code","name","definition","domain","registryVersion","provenance","expressions","renderings","canonicalUrl"],"type":"object"},"ConceptExpression":{"additionalProperties":false,"properties":{"equivalenceStrength":{"type":"number"},"expression":{"type":"string"},"language":{"type":"string"},"locale":{"type":["string","null"]},"provenance":{},"reviewStatus":{"type":"string"},"type":{"type":"string"}},"required":["language","locale","expression","type","equivalenceStrength","reviewStatus","provenance"],"type":"object"},"ConceptList":{"additionalProperties":false,"properties":{"count":{"minimum":0,"type":"integer"},"data":{"items":{"$ref":"#/components/schemas/ConceptSummary"},"type":"array"}},"required":["data","count"],"type":"object"},"ConceptRendering":{"additionalProperties":false,"properties":{"confidence":{"type":"number"},"descriptor":{"type":"string"},"type":{"type":"string"},"unicodeSequence":{"type":["string","null"]}},"required":["type","descriptor","unicodeSequence","confidence"],"type":"object"},"ConceptSummary":{"additionalProperties":false,"properties":{"code":{"type":"string"},"definition":{"type":"string"},"domain":{"type":"string"},"name":{"type":"string"},"registryVersion":{"type":"string"},"url":{"format":"uri","type":"string"}},"required":["code","name","definition","domain","registryVersion","url"],"type":"object"},"DeploymentIdentityUnavailableEnvelope":{"additionalProperties":false,"properties":{"data":{"type":"null"},"error":{"additionalProperties":false,"properties":{"authorizationGranted":{"const":false,"type":"boolean"},"code":{"const":"deployment_identity_unavailable","type":"string"},"documentUrl":{"format":"uri","type":"string"},"downstreamSideEffects":{"const":0,"type":"integer"},"expectedRelease":{"additionalProperties":false,"properties":{"classification":{"enum":["wip","final"],"type":"string"},"packageVersion":{"pattern":"^v[1-9][0-9]*(?:-wip)?$","type":"string"},"productVersion":{"pattern":"^v[1-9][0-9]*$","type":"string"}},"required":["productVersion","packageVersion","classification"],"type":"object"},"failureCategory":{"enum":["identity_document_invalid_json","identity_document_missing_or_unsafe","canonical_origin_invalid","runtime_source_drift","identity_validation_failed"],"type":"string"},"message":{"minLength":1,"type":"string"},"nextAction":{"minLength":1,"type":"string"},"recoverySteps":{"items":{"minLength":1,"type":"string"},"maxItems":4,"minItems":4,"type":"array"},"requiredDeploymentMode":{"const":"clean_release_directory","type":"string"},"semanticAssignment":{"const":false,"type":"boolean"}},"required":["code","message","failureCategory","documentUrl","expectedRelease","requiredDeploymentMode","nextAction","recoverySteps","semanticAssignment","authorizationGranted","downstreamSideEffects"],"type":"object"}},"required":["data","error"],"type":"object"},"EmbeddingProfile":{"additionalProperties":false,"properties":{"dimensions":{"minimum":1,"type":"integer"},"modelName":{"type":"string"},"modelVersion":{"type":"string"},"name":{"type":"string"}},"required":["name","modelName","modelVersion","dimensions"],"type":"object"},"Error":{"additionalProperties":false,"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"ErrorEnvelope":{"additionalProperties":false,"properties":{"data":{"type":"null"},"error":{"$ref":"#/components/schemas/Error"}},"required":["data","error"],"type":"object"},"MCPConnectionManifest":{"additionalProperties":true,"description":"Deployment-specific convenience manifest. The standards-defined discovery operation remains server/discover on POST /mcp.","required":["$schema","schema","service","protocol","requestRequirements","security","capabilities","supportedMethods","identityAcceptanceRule","directApiAlternative"],"type":"object"},"MCPJsonRpcError":{"additionalProperties":false,"properties":{"error":{"additionalProperties":false,"properties":{"code":{"type":"integer"},"data":{},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"id":{"oneOf":[{"type":"string"},{"type":"integer"},{"type":"null"}]},"jsonrpc":{"const":"2.0","type":"string"}},"required":["jsonrpc","id","error"],"type":"object"},"MCPJsonRpcRequest":{"additionalProperties":false,"properties":{"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"jsonrpc":{"const":"2.0","type":"string"},"method":{"enum":["server/discover","tools/list","tools/call","resources/list","resources/read","prompts/list","prompts/get"],"type":"string"},"params":{"additionalProperties":true,"properties":{"_meta":{"$ref":"#/components/schemas/MCPRequestMeta"}},"required":["_meta"],"type":"object"}},"required":["jsonrpc","id","method","params"],"type":"object"},"MCPJsonRpcResponse":{"oneOf":[{"$ref":"#/components/schemas/MCPJsonRpcSuccess"},{"$ref":"#/components/schemas/MCPJsonRpcError"}]},"MCPJsonRpcSuccess":{"additionalProperties":false,"properties":{"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"jsonrpc":{"const":"2.0","type":"string"},"result":{"additionalProperties":true,"properties":{"resultType":{"enum":["complete","input_required"],"type":"string"}},"required":["resultType"],"type":"object"}},"required":["jsonrpc","id","result"],"type":"object"},"MCPRequestMeta":{"additionalProperties":true,"description":"Per-request MCP metadata. Additional extension and trace fields are allowed.","properties":{"io.modelcontextprotocol/clientCapabilities":{"additionalProperties":true,"type":"object"},"io.modelcontextprotocol/clientInfo":{"additionalProperties":true,"properties":{"name":{"maxLength":200,"minLength":1,"type":"string"},"version":{"maxLength":200,"minLength":1,"type":"string"}},"required":["name","version"],"type":"object"},"io.modelcontextprotocol/protocolVersion":{"const":"2026-07-28","type":"string"}},"required":["io.modelcontextprotocol/protocolVersion","io.modelcontextprotocol/clientCapabilities"],"type":"object"},"ResolutionData":{"additionalProperties":false,"properties":{"candidates":{"items":{"$ref":"#/components/schemas/Candidate"},"type":"array"},"concept":{"oneOf":[{"$ref":"#/components/schemas/ResolvedConcept"},{"type":"null"}]},"confidence":{"type":["number","null"]},"embeddingProfile":{"oneOf":[{"$ref":"#/components/schemas/EmbeddingProfile"},{"type":"null"}]},"input":{"additionalProperties":false,"properties":{"expression":{"type":"string"}},"required":["expression"],"type":"object"},"margin":{"type":["number","null"]},"reason":{"type":["string","null"]},"status":{"enum":["resolved","abstained"],"type":"string"}},"required":["input","status","reason","embeddingProfile","concept","candidates","confidence","margin"],"type":"object"},"ResolveEnvelope":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/ResolutionData"},"error":{"type":"null"}},"required":["data","error"],"type":"object"},"ResolveRequest":{"additionalProperties":false,"properties":{"expression":{"description":"The exact expression requiring stable semantic identity; do not include unrelated conversation or secrets.","maxLength":1000,"minLength":1,"type":"string"},"language":{"description":"Optional BCP 47 language tag. Omit when unknown.","maxLength":35,"minLength":1,"type":"string"}},"required":["expression"],"type":"object"},"ResolvedConcept":{"additionalProperties":false,"properties":{"code":{"type":"string"},"definition":{"type":"string"},"domain":{"type":"string"},"name":{"type":"string"},"registryVersion":{"type":"string"}},"required":["code","name","definition","domain","registryVersion"],"type":"object"},"StatusEnvelope":{"additionalProperties":false,"properties":{"data":{"properties":{"activeEmbeddingProfiles":{"minimum":0,"type":"integer"},"arbitraryQuerySemanticResolution":{"type":"string"},"domains":{"items":{"type":"string"},"type":"array"},"languages":{"items":{"type":"string"},"type":"array"},"productionResolver":{"const":"reviewed_exact_registry_first"},"publicBundle":{"type":"object"},"publishedConcepts":{"minimum":0,"type":"integer"},"reviewedExactExpressions":{"minimum":0,"type":"integer"},"semanticRuntimeConfigured":{"type":"boolean"}},"required":["publishedConcepts","reviewedExactExpressions","languages","domains","activeEmbeddingProfiles","semanticRuntimeConfigured","productionResolver","arbitraryQuerySemanticResolution","publicBundle"],"type":"object"},"error":{"type":"null"}},"required":["data","error"],"type":"object"}}},"externalDocs":{"description":"Canonical API and MCP reference","url":"https://embeddedsemantics.com/api-reference"},"info":{"description":"The production resolver is registry-first and exact. Use it at durable semantic boundaries such as memory, API/event records, workflow routing inputs, cross-language handoffs, or audit evidence\u2014not on every utterance. A ConceptCode may be used only when the resolver returns data.status=resolved and data.concept.code. HTTP 200 alone does not mean semantic resolution succeeded. Abstention is a valid outcome. AI agents may use either the direct HTTPS API or the stateless read-only MCP Streamable HTTP endpoint at /mcp; both share the same governed resolver and registry authority. Canonical answers, glossary terms, citation guidance, API discovery, and the RFC 9727 catalog are deterministic machine representations. The discovery receipt at /.well-known/embedded-semantics-discovery.json enumerates the exact ten-route representation inventory and binds it to a canonical SHA-256 receipt; this detects catalog drift but does not establish publisher authenticity or grant authorization.","license":{"name":"Repository license and public terms apply"},"summary":"Governed multilingual expression resolution to stable ConceptCodes.","title":"Embedded Semantics API","version":"1.7.0"},"openapi":"3.1.0","paths":{"/.well-known/api-catalog":{"get":{"description":"Returns a JSON Linkset connecting the direct API, MCP, OpenAPI, human directions, machine discovery, and deployment identity.","operationId":"getApiCatalog","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/linkset+json":{"schema":{"type":"object"}}},"description":"Deterministic selected representation.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read the first-party RFC 9727 API catalog","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false},"head":{"description":"Returns the same selected-representation metadata as GET and no response body.","operationId":"getApiCatalogHead","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Selected representation metadata; no response body.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read metadata for read the first-party rfc 9727 api catalog","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false}},"/.well-known/embedded-semantics-deployment.json":{"get":{"description":"Returns the versioned application-image source closure and SHA-256 tree digest. The digest detects runtime source drift; it is not a publisher signature, live-deployment proof, or authorization grant. When validation fails, the endpoint remains fail-closed with HTTP 503 and a public-safe clean-release recovery contract; the human MCP guide remains readable.","operationId":"getDeploymentIdentity","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"./schemas/embedded-semantics-deployment-identity-v1.schema.json"}}},"description":"Checked deployment identity and explicit evidence-state boundaries.","headers":{"ETag":{"description":"Quoted application-image source-closure SHA-256.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Application-image source-closure SHA-256.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}},"X-Embedded-Semantics-Deployment-Identity":{"description":"Confirms that the checked identity matches the observed runtime source closure.","schema":{"const":"verified","type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeploymentIdentityUnavailableEnvelope"}}},"description":"The checked deployment identity is unavailable or does not match the observed runtime source closure. No package digest, semantic assignment, or authorization may be inferred.","headers":{"Cache-Control":{"description":"Identity failures are never stored by HTTP caches.","schema":{"const":"no-store","type":"string"}},"X-Embedded-Semantics-Deployment-Identity":{"description":"Explicit fail-closed identity state.","schema":{"const":"unavailable","type":"string"}}}}},"summary":"Read the deployed application source identity","tags":["Discovery"],"x-integrity-not-authenticity":true,"x-read-only":true,"x-recovery-guide":"/mcp-guide#mcp-identity-recovery","x-semantic-assignment":false}},"/.well-known/embedded-semantics-discovery.json":{"get":{"description":"Returns the canonical ten-route machine-representation inventory, each route\u2019s media type, content location, cache policy, and the routeInventorySha256 receipt. The receipt supports drift detection only; it does not establish publisher authenticity, semantic assignment, or action authorization.","operationId":"getEmbeddedSemanticsDiscovery","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Deterministic selected representation.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read the deterministic machine-representation discovery receipt","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false},"head":{"description":"Returns the canonical ten-route machine-representation inventory, each route\u2019s media type, content location, cache policy, and the routeInventorySha256 receipt. The receipt supports drift detection only; it does not establish publisher authenticity, semantic assignment, or action authorization.","operationId":"getEmbeddedSemanticsDiscoveryHead","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Selected representation metadata; no response body.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read discovery-receipt headers without a body","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false}},"/.well-known/embedded-semantics.json":{"get":{"operationId":"getWellKnownAgentCapabilities","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"./schemas/embedded-semantics-agent-capabilities-v1.schema.json"}}},"description":"Same capability document as /api/v1/capabilities."}},"summary":"Discover the agent contract through a well-known path","tags":["Discovery"]}},"/agent-instructions.txt":{"get":{"description":"Plain-text operating rules with current deployment readiness. These instructions do not grant action authorization.","operationId":"getDesktopAgentInstructions","responses":{"200":{"content":{"text/plain":{"schema":{"type":"string"}}},"description":"Prompt-ready first-party agent instructions."}},"summary":"Read prompt-ready desktop-agent instructions","tags":["Discovery"]}},"/agent-tool.json":{"get":{"description":"Returns invocation policy, minimum request fields, fail-closed result handling, and the authorization boundary for desktop agents and local models.","operationId":"getAgentToolDescriptor","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentToolDescriptor"}}},"description":"Origin-bound desktop-agent tool descriptor."}},"summary":"Read the provider-neutral resolver tool descriptor","tags":["Discovery"]}},"/answers":{"get":{"description":"Content-negotiated canonical human or machine representation. Nonce-bearing HTML is private/no-store; deterministic machine representations carry byte validators.","operationId":"getCanonicalAnswers","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}},"text/html":{"schema":{"type":"string"}},"text/markdown":{"schema":{"type":"string"}}},"description":"Deterministic selected representation.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read canonical answers","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false},"head":{"description":"Returns the same selected-representation metadata as GET and no response body.","operationId":"getCanonicalAnswersHead","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Selected representation metadata; no response body.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read metadata for read canonical answers","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false}},"/answers.json":{"get":{"description":"Fixed JSON alternate for the canonical resource.","operationId":"getCanonicalAnswersJson","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Deterministic selected representation.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read canonical answers as deterministic JSON","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false},"head":{"description":"Returns the same selected-representation metadata as GET and no response body.","operationId":"getCanonicalAnswersJsonHead","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Selected representation metadata; no response body.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read metadata for read canonical answers as deterministic json","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false}},"/answers.md":{"get":{"description":"Fixed Markdown alternate for the canonical resource.","operationId":"getCanonicalAnswersMarkdown","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"text/markdown":{"schema":{"type":"string"}}},"description":"Deterministic selected representation.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read canonical answers as deterministic Markdown","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false},"head":{"description":"Returns the same selected-representation metadata as GET and no response body.","operationId":"getCanonicalAnswersMarkdownHead","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Selected representation metadata; no response body.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read metadata for read canonical answers as deterministic markdown","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false}},"/api-reference":{"get":{"description":"Content-negotiated canonical human or machine representation. Nonce-bearing HTML is private/no-store; deterministic machine representations carry byte validators.","operationId":"getCanonicalApiReference","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}},"text/html":{"schema":{"type":"string"}},"text/markdown":{"schema":{"type":"string"}}},"description":"Deterministic selected representation.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read canonical API reference","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false},"head":{"description":"Returns the same selected-representation metadata as GET and no response body.","operationId":"getCanonicalApiReferenceHead","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Selected representation metadata; no response body.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read metadata for read canonical api reference","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false}},"/api-reference.json":{"get":{"description":"Fixed JSON alternate for the canonical resource.","operationId":"getCanonicalApiReferenceJson","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Deterministic selected representation.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read canonical API reference as deterministic JSON","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false},"head":{"description":"Returns the same selected-representation metadata as GET and no response body.","operationId":"getCanonicalApiReferenceJsonHead","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Selected representation metadata; no response body.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read metadata for read canonical api reference as deterministic json","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false}},"/api-reference.md":{"get":{"description":"Fixed Markdown alternate for the canonical resource.","operationId":"getCanonicalApiReferenceMarkdown","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"text/markdown":{"schema":{"type":"string"}}},"description":"Deterministic selected representation.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read canonical API reference as deterministic Markdown","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false},"head":{"description":"Returns the same selected-representation metadata as GET and no response body.","operationId":"getCanonicalApiReferenceMarkdownHead","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Selected representation metadata; no response body.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read metadata for read canonical api reference as deterministic markdown","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false}},"/api/v1/adoption-guide":{"get":{"description":"Returns a first-party guide explaining why governed semantic identity is useful, where to place it in a workflow, concrete human and agent use cases, a staged adoption path, best practices, measurable success signals, and current safety boundaries.","operationId":"getAdoptionGuide","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"./schemas/embedded-semantics-adoption-guide-v1.schema.json"}}},"description":"Live value and adoption guide bound to the configured origin and readiness snapshot."}},"summary":"Understand value, fit, use cases, and safe adoption","tags":["Discovery"]}},"/api/v1/agent/connect":{"get":{"description":"Returns the configured canonical origin, live exact-resolution readiness, the canonical resolver request, minimum-data rules, and fail-closed result policy. The endpoint accepts no body, registers no client, creates no session, grants no authorization, and performs no side effect.","operationId":"connectDesktopAgent","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"./schemas/embedded-semantics-desktop-agent-connection-v1.schema.json"}}},"description":"Current stateless desktop-agent connection bootstrap."}},"summary":"Bootstrap a stateless desktop-agent connection","tags":["Discovery"]}},"/api/v1/capabilities":{"get":{"description":"Returns current authority rules, live readiness, invocation policy, minimal-data rules, endpoint URLs, and the required fail-closed decision procedure for desktop agents and local models.","operationId":"getAgentCapabilities","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"./schemas/embedded-semantics-agent-capabilities-v1.schema.json"}}},"description":"Current machine-agent capability document."}},"summary":"Discover the first-party agent contract","tags":["Discovery"]}},"/api/v1/concepts":{"get":{"description":"An empty data array is valid evidence that no public Concept records are deployed.","operationId":"listConcepts","parameters":[{"description":"Optional lexical filter over name and definition.","in":"query","name":"q","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConceptList"}}},"description":"Published Concept summaries."}},"summary":"List published Concept records","tags":["Registry"]}},"/api/v1/concepts/{code}":{"get":{"operationId":"getConcept","parameters":[{"description":"Exact ConceptCode. Do not normalize, translate, or repair it.","in":"path","name":"code","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConceptDetail"}}},"description":"Published Concept detail."},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"const":"concept_not_found"}},"required":["error"],"type":"object"}}},"description":"No published Concept exists for the exact code."}},"summary":"Read one published Concept and its reviewed evidence","tags":["Registry"]}},"/api/v1/integration-readiness":{"get":{"description":"Returns the provider-neutral checklist for selecting exactly one canonical recipe, running six fixed local fixtures, assigning identity only to a valid resolved result, preserving all no-assignment outcomes, and recording authorization separately.","operationId":"getIntegrationReadiness","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"./schemas/embedded-semantics-integration-readiness-v1.schema.json"}}},"description":"Integration-readiness checklist bound to the configured origin."}},"summary":"Prove local client handling before side effects","tags":["Discovery"]}},"/api/v1/integration-readiness/report/{recipeId}":{"get":{"description":"Returns a deterministic side-effect-free report. Only resolved-valid receives ConceptCode and registryVersion; unknown, ambiguous, malformed, request-error, and service-error fixtures remain no assignment. The report is not deployment proof or authorization.","operationId":"getIntegrationReadinessReport","parameters":[{"description":"Exactly one canonical integration recipe.","in":"path","name":"recipeId","required":true,"schema":{"enum":["multilingual-memory","workflow-routing","api-event-interoperability","clarification","audit-provenance"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"./schemas/embedded-semantics-integration-readiness-report-v1.schema.json"}}},"description":"Deterministic local readiness report."},"404":{"description":"The recipe identifier is not one of the canonical five."}},"summary":"Run the deterministic six-fixture self-test for one recipe","tags":["Discovery"]}},"/api/v1/integration-studio":{"get":{"description":"Returns the provider-neutral understand-select-prove-generate-inspect-download journey. Local proof uses six fixed fixtures, adapters are dependency-free relative to this repository, live resolution is off by default, and semantic identity never grants action authorization.","operationId":"getIntegrationStudio","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"./schemas/embedded-semantics-integration-studio-v1.schema.json"}}},"description":"Integration Studio guide bound to the configured origin."}},"summary":"Discover the first-party integration journey and deterministic client-kit contract","tags":["Discovery"]}},"/api/v1/integration-studio/kit/{recipeId}.zip":{"get":{"description":"Returns a reproducible ZIP with Python, Node.js, PowerShell-compatible, and curl handoffs; fixed fixtures; a passing local report; machine instructions; a provider-neutral tool definition; an OpenAPI fragment; a manifest; and SHA-256 checksums. Live mode remains explicit and no downstream side effect is included.","operationId":"downloadIntegrationKit","parameters":[{"description":"Exactly one canonical integration recipe.","in":"path","name":"recipeId","required":true,"schema":{"enum":["multilingual-memory","workflow-routing","api-event-interoperability","clarification","audit-provenance"],"type":"string"}}],"responses":{"200":{"content":{"application/zip":{"schema":{"contentEncoding":"binary","contentMediaType":"application/zip","type":"string"}}},"description":"Deterministic client-handoff ZIP.","headers":{"X-Content-SHA256":{"description":"SHA-256 of the returned ZIP bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"404":{"description":"The recipe identifier is not one of the canonical five."}},"summary":"Download one deterministic, first-party, dependency-free integration kit","tags":["Discovery"]}},"/api/v1/integration-studio/manifest/{recipeId}":{"get":{"description":"Returns the selected recipe, resolved-only client-record rule, independent authorization record, local conformance proof, adapter inventory, file hashes, and explicit scope boundaries. The manifest contains no credentials, model weights, production data, or live semantic results.","operationId":"getIntegrationKitManifest","parameters":[{"description":"Exactly one canonical integration recipe.","in":"path","name":"recipeId","required":true,"schema":{"enum":["multilingual-memory","workflow-routing","api-event-interoperability","clarification","audit-provenance"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"./schemas/embedded-semantics-integration-kit-manifest-v1.schema.json"}}},"description":"Deterministic integration-kit manifest."},"404":{"description":"The recipe identifier is not one of the canonical five."}},"summary":"Inspect one deterministic client handoff before downloading it","tags":["Discovery"]}},"/api/v1/interaction-guide":{"get":{"description":"Returns the request checklist, interpretation order, human explanations, safe next actions, correction guidance, and fail-closed invariants for every resolver outcome.","operationId":"getInteractionGuide","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"./schemas/embedded-semantics-interaction-guide-v1.schema.json"}}},"description":"Live self-explanatory interaction guide bound to the configured origin and readiness snapshot."}},"summary":"Read the ordered resolver interaction guide","tags":["Discovery"]}},"/api/v1/resolve":{"post":{"description":"The resolver first checks governed reviewed exact expressions. Call it only when a stable ConceptCode is required. Clients must inspect data.status. On any abstained result, assign no ConceptCode and preserve data.reason. Explain the observed outcome and next safe action without overriding it. The operation grants no authorization to execute an action.","operationId":"resolveExpression","requestBody":{"content":{"application/json":{"examples":{"english":{"summary":"Expression with an explicit language tag","value":{"expression":"stable concept identity","language":"en"}},"languageOmitted":{"summary":"Omit language when unknown","value":{"expression":"stable concept identity"}}},"schema":{"$ref":"#/components/schemas/ResolveRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"examples":{"ambiguous":{"value":{"data":{"candidates":[],"concept":null,"confidence":null,"embeddingProfile":null,"input":{"expression":"context-dependent term"},"margin":null,"reason":"ambiguous_expression","status":"abstained"},"error":null}},"resolved":{"value":{"data":{"candidates":[],"concept":{"code":"semantic_registry.stable_concept_identity","definition":"A stable registry-backed semantic identity.","domain":"semantic_registry","name":"Stable concept identity","registryVersion":"1.0.0"},"confidence":null,"embeddingProfile":null,"input":{"expression":"stable concept identity"},"margin":null,"reason":null,"status":"resolved"},"error":null}},"unknown":{"value":{"data":{"candidates":[],"concept":null,"confidence":null,"embeddingProfile":null,"input":{"expression":"unreviewed wording"},"margin":null,"reason":"unknown_expression","status":"abstained"},"error":null}}},"schema":{"$ref":"#/components/schemas/ResolveEnvelope"}}},"description":"Processed resolver request. This may be resolved or abstained; HTTP 200 is not proof of ConceptCode assignment."},"400":{"content":{"application/json":{"examples":{"invalidLanguageTag":{"value":{"data":null,"error":{"code":"invalid_language_tag","message":"Language must be a valid BCP 47 tag."}}},"missingExpression":{"value":{"data":null,"error":{"code":"missing_expression","message":"Request JSON must include an expression field."}}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Invalid resolver request. Repair the request only; do not infer a semantic result."}},"summary":"Resolve one expression or explicitly abstain","tags":["Resolution"],"x-read-only":true}},"/api/v1/status":{"get":{"description":"Use this before assuming that the deployed public corpus can return a positive resolution.","operationId":"getRegistryStatus","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatusEnvelope"}}},"description":"Live registry coverage and capability boundary."}},"summary":"Read live registry and resolver status","tags":["Discovery"]}},"/api/v1/use-case-recipes":{"get":{"description":"Returns implementation-ready recipes for multilingual memory, workflow routing, API/event records, human clarification, and audit evidence. Every recipe includes fit, placement, minimum request, client record, resolved/unknown/ambiguous/error branches, separate authorization, retained evidence, and benefit metrics.","operationId":"getUseCaseRecipes","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"./schemas/embedded-semantics-use-case-recipes-v1.schema.json"}}},"description":"Live use-case recipes bound to the configured origin and readiness snapshot."}},"summary":"Apply five fail-closed integration recipes","tags":["Discovery"]}},"/citation":{"get":{"description":"Content-negotiated canonical human or machine representation. Nonce-bearing HTML is private/no-store; deterministic machine representations carry byte validators.","operationId":"getCanonicalCitation","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}},"text/html":{"schema":{"type":"string"}},"text/markdown":{"schema":{"type":"string"}}},"description":"Deterministic selected representation.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read canonical citation guidance","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false},"head":{"description":"Returns the same selected-representation metadata as GET and no response body.","operationId":"getCanonicalCitationHead","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Selected representation metadata; no response body.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read metadata for read canonical citation guidance","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false}},"/citation.json":{"get":{"description":"Fixed JSON alternate for the canonical resource.","operationId":"getCanonicalCitationJson","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Deterministic selected representation.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read canonical citation guidance as deterministic JSON","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false},"head":{"description":"Returns the same selected-representation metadata as GET and no response body.","operationId":"getCanonicalCitationJsonHead","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Selected representation metadata; no response body.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read metadata for read canonical citation guidance as deterministic json","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false}},"/citation.md":{"get":{"description":"Fixed Markdown alternate for the canonical resource.","operationId":"getCanonicalCitationMarkdown","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"text/markdown":{"schema":{"type":"string"}}},"description":"Deterministic selected representation.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read canonical citation guidance as deterministic Markdown","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false},"head":{"description":"Returns the same selected-representation metadata as GET and no response body.","operationId":"getCanonicalCitationMarkdownHead","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Selected representation metadata; no response body.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read metadata for read canonical citation guidance as deterministic markdown","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false}},"/glossary":{"get":{"description":"Content-negotiated canonical human or machine representation. Nonce-bearing HTML is private/no-store; deterministic machine representations carry byte validators.","operationId":"getCanonicalGlossary","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}},"text/html":{"schema":{"type":"string"}},"text/markdown":{"schema":{"type":"string"}}},"description":"Deterministic selected representation.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read canonical glossary","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false},"head":{"description":"Returns the same selected-representation metadata as GET and no response body.","operationId":"getCanonicalGlossaryHead","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Selected representation metadata; no response body.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read metadata for read canonical glossary","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false}},"/glossary.json":{"get":{"description":"Fixed JSON alternate for the canonical resource.","operationId":"getCanonicalGlossaryJson","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Deterministic selected representation.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read canonical glossary as deterministic JSON","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false},"head":{"description":"Returns the same selected-representation metadata as GET and no response body.","operationId":"getCanonicalGlossaryJsonHead","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Selected representation metadata; no response body.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read metadata for read canonical glossary as deterministic json","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false}},"/glossary.md":{"get":{"description":"Fixed Markdown alternate for the canonical resource.","operationId":"getCanonicalGlossaryMarkdown","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"text/markdown":{"schema":{"type":"string"}}},"description":"Deterministic selected representation.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read canonical glossary as deterministic Markdown","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false},"head":{"description":"Returns the same selected-representation metadata as GET and no response body.","operationId":"getCanonicalGlossaryMarkdownHead","parameters":[{"in":"header","name":"Accept","required":false,"schema":{"type":"string"}},{"in":"header","name":"If-None-Match","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Selected representation metadata; no response body.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"304":{"description":"The selected representation matches If-None-Match; the response body is empty, Content-Location and representation validators are retained, and representation content headers are omitted.","headers":{"Content-Location":{"description":"Canonical URL of the selected representation retained on the equivalent 304 response.","schema":{"format":"uri","type":"string"}},"ETag":{"description":"Strong SHA-256-derived validator for the selected representation.","schema":{"type":"string"}},"Repr-Digest":{"description":"RFC 9530 SHA-256 digest of the selected representation bytes.","schema":{"type":"string"}},"X-Content-SHA256":{"description":"Lowercase hexadecimal SHA-256 of the selected representation bytes.","schema":{"pattern":"^[0-9a-f]{64}$","type":"string"}}}},"406":{"content":{"application/problem+json":{"schema":{"properties":{"downstreamAuthorization":{"const":false},"downstreamSideEffects":{"const":0},"semanticAssignment":{"const":false},"status":{"const":406}},"required":["status","semanticAssignment","downstreamAuthorization","downstreamSideEffects"],"type":"object"}}},"description":"The Accept field does not permit an available representation. No semantic identity or authorization is produced."}},"summary":"Read metadata for read canonical glossary as deterministic markdown","tags":["Discovery"],"x-downstream-authorization":false,"x-read-only":true,"x-semantic-assignment":false}},"/mcp":{"post":{"description":"One JSON-RPC request per HTTP POST using MCP protocol revision 2026-07-28. The server supports server/discover, read-only tool discovery and invocation, governed public resources, and one user-controlled prompt. It creates no MCP session, exposes no legacy GET stream or initialize handshake, performs no downstream side effect, and never treats semantic identity as action authorization. This release is public and read-only: clients must not send Authorization or Proxy-Authorization, and the server rejects either header. A protected deployment requires a complete standards-based OAuth resource-server implementation and is not claimed here. Use server/discover first or invoke a supported method directly. Each application worker enforces a bounded client-address rate limit; deployments must also enforce a shared ingress rate limit across workers and replicas.","operationId":"mcpRequest","parameters":[{"description":"Must advertise both application/json and text/event-stream.","example":"application/json, text/event-stream","in":"header","name":"Accept","required":true,"schema":{"type":"string"}},{"description":"Must exactly match params._meta.io.modelcontextprotocol/protocolVersion.","in":"header","name":"MCP-Protocol-Version","required":true,"schema":{"const":"2026-07-28","type":"string"}},{"description":"Must exactly mirror the JSON-RPC method field.","example":"server/discover","in":"header","name":"Mcp-Method","required":true,"schema":{"type":"string"}},{"description":"Required only for tools/call, resources/read, and prompts/get. It must mirror params.name or params.uri; non-ASCII values use the MCP Base64 sentinel form.","in":"header","name":"Mcp-Name","required":false,"schema":{"type":"string"}},{"description":"Native clients may omit Origin. When present it must exactly match the configured allowlist.","in":"header","name":"Origin","required":false,"schema":{"format":"uri","type":"string"}},{"description":"Must be omitted. This public read-only endpoint rejects credential material.","in":"header","name":"Authorization","required":false,"schema":{"maxLength":0,"type":"string"}},{"description":"Must be omitted. This public read-only endpoint rejects proxy credential material.","in":"header","name":"Proxy-Authorization","required":false,"schema":{"maxLength":0,"type":"string"}}],"requestBody":{"content":{"application/json":{"examples":{"discover":{"summary":"Discover protocol versions and capabilities","value":{"id":"discover-1","jsonrpc":"2.0","method":"server/discover","params":{"_meta":{"io.modelcontextprotocol/clientCapabilities":{},"io.modelcontextprotocol/clientInfo":{"name":"ExampleClient","version":"1.0.0"},"io.modelcontextprotocol/protocolVersion":"2026-07-28"}}}},"resolve":{"summary":"Resolve a governed expression through MCP","value":{"id":"resolve-1","jsonrpc":"2.0","method":"tools/call","params":{"_meta":{"io.modelcontextprotocol/clientCapabilities":{},"io.modelcontextprotocol/clientInfo":{"name":"ExampleClient","version":"1.0.0"},"io.modelcontextprotocol/protocolVersion":"2026-07-28"},"arguments":{"expression":"stable concept identity","language":"en"},"name":"embedded_semantics.resolve_expression"}}}},"schema":{"$ref":"#/components/schemas/MCPJsonRpcRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPJsonRpcResponse"}}},"description":"JSON-RPC success or method-level protocol error.","headers":{"Cache-Control":{"description":"Transport responses are not stored by HTTP caches.","schema":{"const":"no-store","type":"string"}},"MCP-Protocol-Version":{"description":"Protocol revision spoken by this endpoint.","schema":{"const":"2026-07-28","type":"string"}},"X-RateLimit-Limit":{"description":"Per-worker request limit for the current client-address window.","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Per-worker request slots remaining in the current window.","schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Window":{"description":"Configured per-worker fixed-window duration in seconds.","schema":{"minimum":1,"type":"integer"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPJsonRpcError"}}},"description":"Malformed request, credential header supplied, header/body mismatch, invalid params, or unsupported protocol version."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPJsonRpcError"}}},"description":"The supplied Origin is not in the exact allowlist."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPJsonRpcError"}}},"description":"The JSON-RPC method is not implemented."},"406":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPJsonRpcError"}}},"description":"Accept does not include both required response media types."},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPJsonRpcError"}}},"description":"The JSON body exceeds MCP_MAX_REQUEST_BYTES."},"415":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPJsonRpcError"}}},"description":"Content-Type is not application/json."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPJsonRpcError"}}},"description":"The per-worker client-address request limit was exceeded. Retry-After reports the minimum wait in seconds; shared ingress limits may impose a stricter policy.","headers":{"Cache-Control":{"description":"Transport responses are not stored by HTTP caches.","schema":{"const":"no-store","type":"string"}},"MCP-Protocol-Version":{"description":"Protocol revision spoken by this endpoint.","schema":{"const":"2026-07-28","type":"string"}},"Retry-After":{"description":"Minimum seconds before this worker will admit another request for the client address.","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Per-worker request limit for the current client-address window.","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Per-worker request slots remaining in the current window.","schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Window":{"description":"Configured per-worker fixed-window duration in seconds.","schema":{"minimum":1,"type":"integer"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPJsonRpcError"}}},"description":"MCP Origin configuration is invalid; the endpoint fails closed with reason invalid_origin_configuration."}},"security":[],"summary":"Send one modern stateless MCP request","tags":["MCP"],"x-mcp-access-mode":"public_read_only","x-mcp-credential-header-policy":"reject_authorization_and_proxy_authorization","x-mcp-credentials-accepted":false,"x-mcp-protocol-version":"2026-07-28","x-mcp-rate-limit":{"globalIngressLimitRequired":true,"requests":120,"scope":"per_worker_client_address","windowSeconds":60},"x-mcp-stateless":true,"x-read-only":true}},"/mcp-server.json":{"get":{"description":"Convenience discovery document for this deployment. Standards-aware clients should still call server/discover on POST /mcp to obtain the negotiated protocol capabilities.","operationId":"getMcpConnectionManifest","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPConnectionManifest"}}},"description":"Deployment endpoint, protocol, security, methods, tools, resources, and prompt."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPJsonRpcError"}}},"description":"MCP Origin configuration is invalid; the manifest fails closed and no connection parameters are asserted."}},"summary":"Read the deployment MCP connection manifest","tags":["MCP","Discovery"],"x-read-only":true}}},"servers":[{"description":"Configured canonical origin","url":"https://embeddedsemantics.com"}],"tags":[{"description":"Machine-readable capability and deployment-state discovery.","name":"Discovery"},{"description":"Modern stateless Model Context Protocol transport for AI agents and machine-intelligence clients. The endpoint is POST-only and exposes read-only tools, resources, and prompts.","name":"MCP"},{"description":"First-party local conformance, adapter handoff, and deterministic integration-kit generation.","name":"Integration"},{"description":"Read-only governed semantic resolution.","name":"Resolution"},{"description":"Published Concept records and evidence.","name":"Registry"}],"x-embedded-semantics-agent-rules":{"abstentionMeans":"no ConceptCode assignment","acceptIdentityOnlyWhen":"data.status == resolved and data.concept.code is a non-empty string","ambiguousExpressionPolicy":"abstain","authority":"published registry record","authorizationRule":"semantic identity does not authorize action execution","benefitEvidenceRule":"Measure wrong-assignment prevention, cross-system consistency, clarification, provenance, or duplicate reduction\u2014not call volume or resolution rate alone.","bestUseBoundary":"Place resolution at a durable semantic boundary: memory, an API/event record, routing input, clarification, a cross-language handoff, or audit evidence\u2014not every utterance.","candidateRule":"candidates, confidence, scores, margin, embeddings, and model output are not semantic authority","connectionBootstrapRule":"Start with GET /api/v1/agent/connect. It is stateless, accepts no request body or client metadata, creates no session, and points to the single canonical resolver operation.","explanationRule":"Explain the observed semantic outcome and the next safe action; never describe HTTP success alone as semantic success.","externalRuntimeRule":"calling the API does not require hosting the site, running an embedding model, or adding an external execution provider","integrationKitBoundary":"Generated kits contain no credentials, model weights, production data, live semantic results, or action authorization; live HTTPS mode is off by default and requires explicit operator action.","integrationKitRule":"A generated kit proves fixed-fixture client handling only; it neither proves arbitrary live coverage nor authorizes a downstream action.","integrationStudioRule":"Choose exactly one recipe, require a passing six-fixture local proof, inspect the generated adapters and manifest, and enable live HTTPS only by explicit operator choice.","invokeOnlyWhen":"a stable governed ConceptCode is required for one expression","minimumDataRule":"send only expression and optional known BCP 47 language; never send secrets or unrelated conversation","readinessRule":"Before wiring a real side effect, select exactly one recipe and run six fixed local fixtures; only resolved-valid may receive code/version; authorization remains separate.","readinessScope":"The readiness report makes zero network calls and performs zero side effects; it is not live-deployment proof or permission to act.","recipeRule":"Use one bounded recipe at a durable semantic boundary; always retain original expression, semantic outcome, and resolver evidence; add code/version only after resolved; authorize side effects separately.","resolutionMode":"reviewed_exact_registry_first","unseenExpressionPolicy":"abstain","valueMeasurement":"measure wrong-assignment prevention, cross-system consistency, clarification quality, and provenance completeness; do not optimize for resolution rate alone"},"x-embedded-semantics-discovery":{"answers":"https://embeddedsemantics.com/answers","apiCatalog":"https://embeddedsemantics.com/.well-known/api-catalog","apiReference":"https://embeddedsemantics.com/api-reference","canonicalOrigin":"https://embeddedsemantics.com","citation":"https://embeddedsemantics.com/citation","discoveryDocument":"https://embeddedsemantics.com/.well-known/embedded-semantics-discovery.json","downstreamAuthorization":false,"downstreamSideEffects":0,"glossary":"https://embeddedsemantics.com/glossary","semanticAssignment":false}}