{"components":{"schemas":{"ApiError":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"}},"required":["error"],"type":"object"},"DocumentRecord":{"$defs":{"OutlineEntry":{"properties":{"id":{"type":"string"},"level":{"format":"uint8","maximum":255,"minimum":0,"type":"integer"},"title":{"type":"string"}},"required":["id","title","level"],"type":"object"}},"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"area":{"type":"string"},"date":{"type":["string","null"]},"description":{"type":"string"},"generation":{"format":"uint64","minimum":0,"type":"integer"},"locale":{"type":"string"},"markdown":{"type":"string"},"modified":{"type":["string","null"]},"outline":{"items":{"$ref":"#/$defs/OutlineEntry"},"type":"array"},"path":{"type":"string"},"reading_minutes":{"format":"uint32","minimum":0,"type":"integer"},"resource_uri":{"type":"string"},"size_bytes":{"format":"uint","minimum":0,"type":"integer"},"tags":{"items":{"type":"string"},"type":"array"},"title":{"type":"string"},"web_url":{"type":"string"}},"required":["path","web_url","resource_uri","title","description","locale","area","tags","reading_minutes","size_bytes","outline","markdown","generation"],"title":"DocumentRecord","type":"object"},"ListDocumentsRequest":{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"area":{"default":null,"type":["string","null"]},"cursor":{"default":null,"type":["string","null"]},"limit":{"default":null,"description":"Number of documents to return (default 50, maximum 100).","format":"uint","minimum":0,"type":["integer","null"]},"locale":{"default":null,"type":["string","null"]},"tag":{"default":null,"type":["string","null"]}},"title":"ListDocumentsRequest","type":"object"},"ListDocumentsResponse":{"$defs":{"DocumentSummary":{"properties":{"area":{"type":"string"},"description":{"type":"string"},"locale":{"type":"string"},"modified":{"type":["string","null"]},"path":{"type":"string"},"reading_minutes":{"format":"uint32","minimum":0,"type":"integer"},"resource_uri":{"type":"string"},"size_bytes":{"format":"uint","minimum":0,"type":"integer"},"tags":{"items":{"type":"string"},"type":"array"},"title":{"type":"string"},"web_url":{"type":"string"}},"required":["path","web_url","resource_uri","title","description","locale","area","tags","reading_minutes","size_bytes"],"type":"object"}},"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"documents":{"items":{"$ref":"#/$defs/DocumentSummary"},"type":"array"},"generation":{"format":"uint64","minimum":0,"type":"integer"},"next_cursor":{"type":["string","null"]}},"required":["generation","documents"],"title":"ListDocumentsResponse","type":"object"},"ReadDocumentRequest":{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"path":{"description":"Canonical, root-relative public document path.","type":"string"}},"required":["path"],"title":"ReadDocumentRequest","type":"object"},"ReadDocumentSectionRequest":{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"heading_id":{"description":"Heading id from the document outline. Omit to read from the beginning.","type":["string","null"]},"max_chars":{"description":"Maximum returned Markdown characters (default 8000, maximum 32000).","format":"uint","minimum":0,"type":["integer","null"]},"path":{"description":"Canonical, root-relative public document path.","type":"string"}},"required":["path"],"title":"ReadDocumentSectionRequest","type":"object"},"ReadDocumentSectionResponse":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"area":{"type":"string"},"description":{"type":"string"},"generation":{"format":"uint64","minimum":0,"type":"integer"},"heading_id":{"type":["string","null"]},"locale":{"type":"string"},"markdown":{"type":"string"},"modified":{"type":["string","null"]},"path":{"type":"string"},"reading_minutes":{"format":"uint32","minimum":0,"type":"integer"},"resource_uri":{"type":"string"},"size_bytes":{"format":"uint","minimum":0,"type":"integer"},"tags":{"items":{"type":"string"},"type":"array"},"title":{"type":"string"},"truncated":{"type":"boolean"},"web_url":{"type":"string"}},"required":["path","web_url","resource_uri","title","description","locale","area","tags","reading_minutes","size_bytes","markdown","truncated","generation"],"title":"ReadDocumentSectionResponse","type":"object"},"RelatedDocumentsRequest":{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"limit":{"description":"Number of related documents to return (default 5, maximum 20).","format":"uint","minimum":0,"type":["integer","null"]},"path":{"type":"string"}},"required":["path"],"title":"RelatedDocumentsRequest","type":"object"},"RelatedDocumentsResponse":{"$defs":{"DocumentSummary":{"properties":{"area":{"type":"string"},"description":{"type":"string"},"locale":{"type":"string"},"modified":{"type":["string","null"]},"path":{"type":"string"},"reading_minutes":{"format":"uint32","minimum":0,"type":"integer"},"resource_uri":{"type":"string"},"size_bytes":{"format":"uint","minimum":0,"type":"integer"},"tags":{"items":{"type":"string"},"type":"array"},"title":{"type":"string"},"web_url":{"type":"string"}},"required":["path","web_url","resource_uri","title","description","locale","area","tags","reading_minutes","size_bytes"],"type":"object"}},"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"documents":{"items":{"$ref":"#/$defs/DocumentSummary"},"type":"array"},"generation":{"format":"uint64","minimum":0,"type":"integer"},"path":{"type":"string"}},"required":["generation","path","documents"],"title":"RelatedDocumentsResponse","type":"object"},"SearchDocumentsRequest":{"$defs":{"SearchMode":{"enum":["lexical","semantic","hybrid"],"type":"string"}},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"area":{"default":null,"description":"Optional top-level documentation area.","type":["string","null"]},"cursor":{"default":null,"description":"Opaque cursor returned by a previous search response.","type":["string","null"]},"limit":{"default":null,"description":"Number of results to return (default 5, maximum 20).","format":"uint","minimum":0,"type":["integer","null"]},"locale":{"default":null,"description":"Language code (`zh`, a configured locale, or `all`).","type":["string","null"]},"mode":{"anyOf":[{"$ref":"#/$defs/SearchMode"},{"type":"null"}],"default":null,"description":"`hybrid` combines lexical and multilingual semantic retrieval;\n`lexical` is deterministic and supports cursor pagination."},"query":{"default":"","description":"Full-text query, between 1 and 200 Unicode characters.","type":"string"},"tag":{"default":null,"description":"Optional exact tag filter.","type":["string","null"]}},"title":"SearchDocumentsRequest","type":"object"},"SearchDocumentsResponse":{"$defs":{"SearchDocumentHit":{"properties":{"area":{"type":"string"},"description":{"type":"string"},"excerpt_text":{"type":"string"},"locale":{"type":"string"},"modified":{"type":["string","null"]},"path":{"type":"string"},"reading_minutes":{"format":"uint32","minimum":0,"type":"integer"},"resource_uri":{"type":"string"},"score":{"format":"float","type":"number"},"size_bytes":{"format":"uint","minimum":0,"type":"integer"},"tags":{"items":{"type":"string"},"type":"array"},"title":{"type":"string"},"web_url":{"type":"string"}},"required":["path","web_url","resource_uri","title","description","locale","area","tags","reading_minutes","size_bytes","excerpt_text","score"],"type":"object"},"SearchMode":{"enum":["lexical","semantic","hybrid"],"type":"string"}},"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"generation":{"format":"uint64","minimum":0,"type":"integer"},"mode":{"$ref":"#/$defs/SearchMode"},"next_cursor":{"type":["string","null"]},"results":{"items":{"$ref":"#/$defs/SearchDocumentHit"},"type":"array"},"semantic_ready":{"type":"boolean"},"total":{"format":"uint","minimum":0,"type":"integer"}},"required":["generation","mode","semantic_ready","total","results"],"title":"SearchDocumentsResponse","type":"object"}}},"info":{"description":"Read-only, public-content-only API for agents. Responses contain untrusted documentation content.","title":"liz's doc public knowledge API","version":"0.1.0"},"openapi":"3.1.0","paths":{"/api/v1/capabilities":{"get":{"operationId":"getAgentCapabilities","responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Enabled transports and WebMCP manifest"}}}},"/api/v1/document":{"get":{"operationId":"readDocument","parameters":[{"description":"Canonical root-relative public path","in":"query","name":"path","required":true,"schema":{"maxLength":512,"pattern":"^/","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentRecord"}}},"description":"Markdown document"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Invalid input"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Document not found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Cursor belongs to a retired generation"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Knowledge generation unavailable"}}}},"/api/v1/documents":{"get":{"operationId":"listDocuments","parameters":[{"description":"zh, a configured locale, or all","in":"query","name":"locale","required":false,"schema":{"type":"string"}},{"description":"Exact documentation area","in":"query","name":"area","required":false,"schema":{"maxLength":80,"type":"string"}},{"description":"Exact tag","in":"query","name":"tag","required":false,"schema":{"maxLength":100,"type":"string"}},{"description":"Page size","in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":100,"minimum":1,"type":"integer"}},{"description":"Opaque cursor from this filter and generation","in":"query","name":"cursor","required":false,"schema":{"maxLength":512,"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListDocumentsResponse"}}},"description":"Document list"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Invalid input"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Document not found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Cursor belongs to a retired generation"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Knowledge generation unavailable"}}}},"/api/v1/related":{"get":{"operationId":"relatedDocuments","parameters":[{"description":"Canonical root-relative public path","in":"query","name":"path","required":true,"schema":{"maxLength":512,"pattern":"^/","type":"string"}},{"description":"Maximum related documents","in":"query","name":"limit","required":false,"schema":{"default":5,"maximum":20,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RelatedDocumentsResponse"}}},"description":"Related documents"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Invalid input"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Document not found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Cursor belongs to a retired generation"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Knowledge generation unavailable"}}}},"/api/v1/search":{"get":{"operationId":"searchDocuments","parameters":[{"description":"Full-text query","in":"query","name":"query","required":true,"schema":{"maxLength":200,"minLength":1,"type":"string"}},{"description":"zh, a configured locale, or all","in":"query","name":"locale","required":false,"schema":{"type":"string"}},{"description":"Exact documentation area","in":"query","name":"area","required":false,"schema":{"maxLength":80,"type":"string"}},{"description":"Exact tag","in":"query","name":"tag","required":false,"schema":{"maxLength":100,"type":"string"}},{"description":"Page size","in":"query","name":"limit","required":false,"schema":{"default":5,"maximum":20,"minimum":1,"type":"integer"}},{"description":"Opaque cursor from this query and generation","in":"query","name":"cursor","required":false,"schema":{"maxLength":512,"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchDocumentsResponse"}}},"description":"Search results"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Invalid input"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Document not found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Cursor belongs to a retired generation"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Knowledge generation unavailable"}}}},"/api/v1/section":{"get":{"operationId":"readDocumentSection","parameters":[{"description":"Canonical root-relative public path","in":"query","name":"path","required":true,"schema":{"maxLength":512,"pattern":"^/","type":"string"}},{"description":"Heading id from the document outline","in":"query","name":"heading_id","required":false,"schema":{"maxLength":200,"type":"string"}},{"description":"Maximum Unicode characters","in":"query","name":"max_chars","required":false,"schema":{"default":8000,"maximum":32000,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadDocumentSectionResponse"}}},"description":"Bounded Markdown section"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Invalid input"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Document not found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Cursor belongs to a retired generation"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Knowledge generation unavailable"}}}}},"servers":[{"url":"https://doc.liz6.com"}]}