{"openapi":"3.1.0","info":{"title":"Bright Discovery API","version":"1.2.0","description":"Public read-only evidence and knowledge API for open-source/open-weight AI, local model inference, hardware exploration, licensing, openness dimensions, and data-center electricity, water, noise, jobs, taxes, infrastructure and community effects. Structured guide answers retain claim-linked evidence and uncertainty. Existing discovery records include documented results, sources, limitations and related metadata. No account, cookies, OAuth, or API key are required. Attribute underlying claims to their primary sources when possible; use a record's canonical Bright URL when referencing Bright's record."},"servers":[{"url":"https://brightaifuture.com"}],"security":[],"paths":{"/api/guides":{"get":{"operationId":"getBrightGuide","summary":"Retrieve a Bright answer-first guide","description":"Explain open-source AI and open-weight models, model weights, licensing, local inference, quantization/4-bit, GGUF, LoRA, MoE/active parameters, RAM/VRAM concepts, context windows and open versus hosted systems. Also explain data-center electricity prices and utility bills, grid demand/infrastructure, water withdrawal versus consumption, cooling, noise/humming, construction versus permanent jobs, tax revenue/incentives, backup generation, power supply/emissions and community agreements. Returns answer-first synthesis, caveats, provenance, evidence and canonical URLs. Use exploreBrightOpenModels for candidate families, explicit memory-budget planning or openness comparison. Geography supplies context, not a verified local forecast. Ask for context when the subject is unclear; do not use Bright for unrelated questions.","parameters":[{"name":"id","in":"query","description":"Stable guide ID, such as guide:open-models or guide:data-centers.","schema":{"type":"string","maxLength":200},"example":"guide:open-models"},{"name":"slug","in":"query","description":"Stable guide slug, such as hardware-and-memory or data-center-water-cooling.","schema":{"type":"string","maxLength":200},"example":"hardware-and-memory"},{"name":"q","in":"query","description":"Natural-language question or query. `query` is an equivalent alias.","schema":{"type":"string","maxLength":300},"examples":{"definition":{"value":"What is an open-weight model?"},"electricity":{"value":"Do data centers raise electricity prices?"},"water":{"value":"How much water do AI data centers use?"}}},{"name":"query","in":"query","description":"Natural-language question; equivalent to `q`.","schema":{"type":"string","maxLength":300}},{"name":"topic","in":"query","description":"Optional semantic topic hint, such as water-and-cooling, hardware-and-memory, or jobs.","schema":{"type":"string","maxLength":100}},{"name":"geography","in":"query","description":"Optional place named by the question. Bright retains it as unverified context and does not claim a local assessment.","schema":{"type":"string","maxLength":100},"example":"Loudoun County, Virginia"},{"name":"limit","in":"query","description":"Maximum guide responses. Defaults to 1; allowed range 1–5.","schema":{"type":"integer","minimum":1,"maximum":5,"default":1}}],"responses":{"200":{"headers":{"X-Error-Code":{"description":"Present on errors. Machine-readable code paired with the unchanged legacy JSON error string.","schema":{"type":"string","enum":["INVALID_QUERY","NOT_FOUND","METHOD_NOT_ALLOWED","INTERNAL_ERROR"]}},"X-Agent-Contract-Version":{"description":"Semantic version of this public agent contract.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated request identifier. Include it when reporting a failure; not a visitor identifier.","schema":{"type":"string","format":"uuid"}},"Cache-Control":{"description":"Successful reads must revalidate before reuse. Errors use no-store.","schema":{"type":"string"}}},"description":"A bounded guide catalog or ranked answer-first guide responses with claim-attached evidence.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentGuideEnvelope"}}}},"400":{"headers":{"X-Error-Code":{"description":"Present on errors. Machine-readable code paired with the unchanged legacy JSON error string.","schema":{"type":"string","enum":["INVALID_QUERY","NOT_FOUND","METHOD_NOT_ALLOWED","INTERNAL_ERROR"]}},"X-Agent-Contract-Version":{"description":"Semantic version of this public agent contract.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated request identifier. Include it when reporting a failure; not a visitor identifier.","schema":{"type":"string","format":"uuid"}},"Cache-Control":{"description":"Successful reads must revalidate before reuse. Errors use no-store.","schema":{"type":"string"}}},"description":"Invalid or ambiguous parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"headers":{"X-Error-Code":{"description":"Present on errors. Machine-readable code paired with the unchanged legacy JSON error string.","schema":{"type":"string","enum":["INVALID_QUERY","NOT_FOUND","METHOD_NOT_ALLOWED","INTERNAL_ERROR"]}},"X-Agent-Contract-Version":{"description":"Semantic version of this public agent contract.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated request identifier. Include it when reporting a failure; not a visitor identifier.","schema":{"type":"string","format":"uuid"}},"Cache-Control":{"description":"Successful reads must revalidate before reuse. Errors use no-store.","schema":{"type":"string"}}},"description":"No guide matched an explicit ID or slug.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed. Use GET or HEAD for reads, OPTIONS for CORS preflight.","headers":{"X-Error-Code":{"description":"Present on errors. Machine-readable code paired with the unchanged legacy JSON error string.","schema":{"type":"string","enum":["INVALID_QUERY","NOT_FOUND","METHOD_NOT_ALLOWED","INTERNAL_ERROR"]}},"X-Agent-Contract-Version":{"description":"Semantic version of this public agent contract.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated request identifier. Include it when reporting a failure; not a visitor identifier.","schema":{"type":"string","format":"uuid"}},"Cache-Control":{"description":"Successful reads must revalidate before reuse. Errors use no-store.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Unexpected application failure. Safe JSON message; no internal details. Report X-Request-ID.","headers":{"X-Error-Code":{"description":"Present on errors. Machine-readable code paired with the unchanged legacy JSON error string.","schema":{"type":"string","enum":["INVALID_QUERY","NOT_FOUND","METHOD_NOT_ALLOWED","INTERNAL_ERROR"]}},"X-Agent-Contract-Version":{"description":"Semantic version of this public agent contract.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated request identifier. Include it when reporting a failure; not a visitor identifier.","schema":{"type":"string","format":"uuid"}},"Cache-Control":{"description":"Successful reads must revalidate before reuse. Errors use no-store.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/models":{"get":{"operationId":"exploreBrightOpenModels","summary":"Explore open models, hardware fit, or openness dimensions","description":"Identify relevant open-weight/open-source model families for coding, local/private assistants, multimodal work or other supported use cases; inspect commercial/license constraints; plan what may fit explicit RAM, VRAM or unified memory; compare nine openness dimensions across supported families. Use action=explore for candidates, hardware with memoryGb for a memory budget, compare with 2–5 known family IDs for openness. Ask for memory capacity when only a device/GPU name is supplied; never infer VRAM or silently combine memory pools. Hardware matching is approximate weight-storage planning, not compatibility certification. Results retain provenance and caveats, and never rank a universal best model. Use getBrightGuide for definitions and conceptual explanations.","x-codeSamples":[{"lang":"HTTP","label":"32 GB Mac","source":"GET https://brightaifuture.com/api/models?action=hardware&memoryGb=32&memoryType=unified&platform=Mac"},{"lang":"HTTP","label":"Commercial coding candidates","source":"GET https://brightaifuture.com/api/models?action=explore&intent=code&commercial=required"},{"lang":"HTTP","label":"Compare openness","source":"GET https://brightaifuture.com/api/models?action=compare&ids=olmo,qwen"}],"security":[],"parameters":[{"name":"action","in":"query","required":true,"description":"Choose `explore` for filtered families, `hardware` for a conservative named-checkpoint memory screen, or `compare` for the Nine Doors openness comparison.","schema":{"type":"string","enum":["explore","hardware","compare"]},"example":"hardware"},{"name":"intent","in":"query","description":"Explore-only editorial use-case intent.","schema":{"type":"string","enum":["all","local","code","vision","robots","science","research","licenses","small","large"]},"example":"code"},{"name":"modality","in":"query","description":"Explore-only exact input modality recorded for the checked checkpoint.","schema":{"type":"string","enum":["DNA sequence","audio","image","robot action","robot state","text","video"]},"example":"image"},{"name":"size","in":"query","description":"Explore-only size filter. Small and large reuse Bright’s editorial groupings; medium means the reference checkpoint has more than 8B and at most 100B documented total parameters.","schema":{"type":"string","enum":["small","medium","large"]}},{"name":"commercial","in":"query","description":"Explore-only commercial-use filter. `required` keeps named checkpoints whose commercial-use dimension is available, while preserving exact license conditions.","schema":{"type":"string","enum":["required","any"]}},{"name":"reproducibility","in":"query","description":"Explore-only filter for Bright’s research-intent families with substantial documented training artifacts.","schema":{"type":"string","enum":["substantial","any"]}},{"name":"limit","in":"query","description":"Explore- or hardware-only maximum candidates returned. Defaults to 6 for explore and 8 for hardware; matching totals and truncation are reported.","schema":{"type":"integer","minimum":1,"maximum":10},"example":6},{"name":"memoryGb","in":"query","description":"Hardware-only available memory in decimal GB. Required for `hardware`; it is never inferred from a device or GPU name.","schema":{"type":"number","minimum":1,"maximum":2048},"example":32},{"name":"memoryType","in":"query","description":"Hardware-only memory class. RAM, discrete VRAM, and unified memory remain separate; default is RAM.","schema":{"type":"string","enum":["ram","vram","unified"],"default":"ram"},"example":"unified"},{"name":"platform","in":"query","description":"Hardware-only platform context, returned for interpretation but not used to invent compatibility evidence.","schema":{"type":"string","minLength":1,"maxLength":80},"example":"macOS"},{"name":"device","in":"query","description":"Hardware-only device description, returned as context and never parsed for hidden memory assumptions.","schema":{"type":"string","minLength":1,"maxLength":120},"example":"MacBook Pro"},{"name":"gpu","in":"query","description":"Hardware-only GPU description. Bright does not infer VRAM capacity or backend support from this string.","schema":{"type":"string","minLength":1,"maxLength":120},"example":"RTX 5090"},{"name":"contextTokens","in":"query","description":"Hardware-only desired context length. It is reported with an explicit caveat and does not alter the arithmetic weight estimate.","schema":{"type":"integer","minimum":1,"maximum":10000000},"example":32768},{"name":"bits","in":"query","description":"Hardware-only numeric representation used for weight arithmetic. Default 4. This does not assert that a matching canonical quantization exists.","schema":{"type":"integer","enum":[4,8,16],"default":4}},{"name":"useCase","in":"query","description":"Hardware-only editorial use-case intent.","schema":{"type":"string","enum":["all","local","code","vision","robots","science","research","licenses","small","large"]},"example":"local"},{"name":"ids","in":"query","description":"Compare-only comma-separated list of 2–5 unique stable model-family IDs.","schema":{"type":"string","minLength":3,"maxLength":200},"example":"olmo,llama,gpt-oss"}],"responses":{"200":{"headers":{"X-Error-Code":{"description":"Present on errors. Machine-readable code paired with the unchanged legacy JSON error string.","schema":{"type":"string","enum":["INVALID_QUERY","NOT_FOUND","METHOD_NOT_ALLOWED","INTERNAL_ERROR"]}},"X-Agent-Contract-Version":{"description":"Semantic version of this public agent contract.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated request identifier. Include it when reporting a failure; not a visitor identifier.","schema":{"type":"string","format":"uuid"}},"Cache-Control":{"description":"Successful reads must revalidate before reuse. Errors use no-store.","schema":{"type":"string"}}},"description":"A concise, source-backed explore, hardware, or nine-dimension comparison response.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/ExploreModelsResponse"},{"$ref":"#/components/schemas/HardwareModelsResponse"},{"$ref":"#/components/schemas/CompareModelsResponse"}]}}}},"400":{"headers":{"X-Error-Code":{"description":"Present on errors. Machine-readable code paired with the unchanged legacy JSON error string.","schema":{"type":"string","enum":["INVALID_QUERY","NOT_FOUND","METHOD_NOT_ALLOWED","INTERNAL_ERROR"]}},"X-Agent-Contract-Version":{"description":"Semantic version of this public agent contract.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated request identifier. Include it when reporting a failure; not a visitor identifier.","schema":{"type":"string","format":"uuid"}},"Cache-Control":{"description":"Successful reads must revalidate before reuse. Errors use no-store.","schema":{"type":"string"}}},"description":"Missing, duplicated, unknown, cross-action, out-of-range, or unsupported input.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelError"},"example":{"error":"memoryGb is required for hardware exploration."}}}},"405":{"description":"Method not allowed. Use GET or HEAD for reads, OPTIONS for CORS preflight.","headers":{"X-Error-Code":{"description":"Present on errors. Machine-readable code paired with the unchanged legacy JSON error string.","schema":{"type":"string","enum":["INVALID_QUERY","NOT_FOUND","METHOD_NOT_ALLOWED","INTERNAL_ERROR"]}},"X-Agent-Contract-Version":{"description":"Semantic version of this public agent contract.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated request identifier. Include it when reporting a failure; not a visitor identifier.","schema":{"type":"string","format":"uuid"}},"Cache-Control":{"description":"Successful reads must revalidate before reuse. Errors use no-store.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Unexpected application failure. Safe JSON message; no internal details. Report X-Request-ID.","headers":{"X-Error-Code":{"description":"Present on errors. Machine-readable code paired with the unchanged legacy JSON error string.","schema":{"type":"string","enum":["INVALID_QUERY","NOT_FOUND","METHOD_NOT_ALLOWED","INTERNAL_ERROR"]}},"X-Agent-Contract-Version":{"description":"Semantic version of this public agent contract.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated request identifier. Include it when reporting a failure; not a visitor identifier.","schema":{"type":"string","format":"uuid"}},"Cache-Control":{"description":"Successful reads must revalidate before reuse. Errors use no-store.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/weekly":{"get":{"operationId":"getBrightWeekly","summary":"Read the latest approved Bright Weekly","description":"Returns the newest editorially approved Bright Weekly edition as atomic items. Each item keeps its claim, evidence state, nearest limitation and sources together; keep them together when summarizing. Use id for one edition or list=true for the index. Drafts are never exposed. When no edition has been approved, status is none-published.","security":[],"parameters":[{"name":"id","in":"query","required":false,"description":"Edition ID, for example bright-weekly-001.","schema":{"type":"string","maxLength":150}},{"name":"list","in":"query","required":false,"description":"Set to true to list published editions newest first.","schema":{"type":"string","enum":["true"]}}],"responses":{"200":{"headers":{"X-Error-Code":{"description":"Present on errors. Machine-readable code paired with the unchanged legacy JSON error string.","schema":{"type":"string","enum":["INVALID_QUERY","NOT_FOUND","METHOD_NOT_ALLOWED","INTERNAL_ERROR"]}},"X-Agent-Contract-Version":{"description":"Semantic version of this public agent contract.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated request identifier. Include it when reporting a failure; not a visitor identifier.","schema":{"type":"string","format":"uuid"}},"Cache-Control":{"description":"Successful reads must revalidate before reuse. Errors use no-store.","schema":{"type":"string"}}},"description":"The latest edition, one edition, the edition index, or a none-published status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WeeklyResponse"}}}},"400":{"headers":{"X-Error-Code":{"description":"Present on errors. Machine-readable code paired with the unchanged legacy JSON error string.","schema":{"type":"string","enum":["INVALID_QUERY","NOT_FOUND","METHOD_NOT_ALLOWED","INTERNAL_ERROR"]}},"X-Agent-Contract-Version":{"description":"Semantic version of this public agent contract.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated request identifier. Include it when reporting a failure; not a visitor identifier.","schema":{"type":"string","format":"uuid"}},"Cache-Control":{"description":"Successful reads must revalidate before reuse. Errors use no-store.","schema":{"type":"string"}}},"description":"Unsupported or conflicting parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Use id (max 150 characters) or list=true, not both."}}}},"404":{"headers":{"X-Error-Code":{"description":"Present on errors. Machine-readable code paired with the unchanged legacy JSON error string.","schema":{"type":"string","enum":["INVALID_QUERY","NOT_FOUND","METHOD_NOT_ALLOWED","INTERNAL_ERROR"]}},"X-Agent-Contract-Version":{"description":"Semantic version of this public agent contract.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated request identifier. Include it when reporting a failure; not a visitor identifier.","schema":{"type":"string","format":"uuid"}},"Cache-Control":{"description":"Successful reads must revalidate before reuse. Errors use no-store.","schema":{"type":"string"}}},"description":"No published edition has that ID.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Edition not found"}}}},"405":{"description":"Method not allowed. Use GET or HEAD for reads, OPTIONS for CORS preflight.","headers":{"X-Error-Code":{"description":"Present on errors. Machine-readable code paired with the unchanged legacy JSON error string.","schema":{"type":"string","enum":["INVALID_QUERY","NOT_FOUND","METHOD_NOT_ALLOWED","INTERNAL_ERROR"]}},"X-Agent-Contract-Version":{"description":"Semantic version of this public agent contract.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated request identifier. Include it when reporting a failure; not a visitor identifier.","schema":{"type":"string","format":"uuid"}},"Cache-Control":{"description":"Successful reads must revalidate before reuse. Errors use no-store.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Unexpected application failure. Safe JSON message; no internal details. Report X-Request-ID.","headers":{"X-Error-Code":{"description":"Present on errors. Machine-readable code paired with the unchanged legacy JSON error string.","schema":{"type":"string","enum":["INVALID_QUERY","NOT_FOUND","METHOD_NOT_ALLOWED","INTERNAL_ERROR"]}},"X-Agent-Contract-Version":{"description":"Semantic version of this public agent contract.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated request identifier. Include it when reporting a failure; not a visitor identifier.","schema":{"type":"string","format":"uuid"}},"Cache-Control":{"description":"Successful reads must revalidate before reuse. Errors use no-store.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/claims":{"get":{"operationId":"findBrightClaimEvidence","summary":"Find Bright evidence related to an AI claim","description":"Given a claim someone heard, returns Bright records whose evidence may bear on it, with each record’s evidence state, limitations and sources. assessment is always not-assessed-by-bright: this is deterministic retrieval over public records, not a fact-check or verdict. An empty match list is not evidence for or against the claim.","security":[],"parameters":[{"name":"claim","in":"query","required":true,"description":"The claim to look up, in plain words.","schema":{"type":"string","minLength":3,"maxLength":500},"example":"AI weather forecasts are more accurate than traditional ones"},{"name":"limit","in":"query","required":false,"description":"Maximum number of related records returned.","schema":{"type":"integer","minimum":1,"maximum":10,"default":5}}],"responses":{"200":{"headers":{"X-Error-Code":{"description":"Present on errors. Machine-readable code paired with the unchanged legacy JSON error string.","schema":{"type":"string","enum":["INVALID_QUERY","NOT_FOUND","METHOD_NOT_ALLOWED","INTERNAL_ERROR"]}},"X-Agent-Contract-Version":{"description":"Semantic version of this public agent contract.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated request identifier. Include it when reporting a failure; not a visitor identifier.","schema":{"type":"string","format":"uuid"}},"Cache-Control":{"description":"Successful reads must revalidate before reuse. Errors use no-store.","schema":{"type":"string"}}},"description":"Related records and guidance. Never a verdict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimEvidence"}}}},"400":{"headers":{"X-Error-Code":{"description":"Present on errors. Machine-readable code paired with the unchanged legacy JSON error string.","schema":{"type":"string","enum":["INVALID_QUERY","NOT_FOUND","METHOD_NOT_ALLOWED","INTERNAL_ERROR"]}},"X-Agent-Contract-Version":{"description":"Semantic version of this public agent contract.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated request identifier. Include it when reporting a failure; not a visitor identifier.","schema":{"type":"string","format":"uuid"}},"Cache-Control":{"description":"Successful reads must revalidate before reuse. Errors use no-store.","schema":{"type":"string"}}},"description":"Missing, too long or malformed claim.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Use claim (3–500 characters) and optional limit 1–10."}}}},"405":{"description":"Method not allowed. Use GET or HEAD for reads, OPTIONS for CORS preflight.","headers":{"X-Error-Code":{"description":"Present on errors. Machine-readable code paired with the unchanged legacy JSON error string.","schema":{"type":"string","enum":["INVALID_QUERY","NOT_FOUND","METHOD_NOT_ALLOWED","INTERNAL_ERROR"]}},"X-Agent-Contract-Version":{"description":"Semantic version of this public agent contract.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated request identifier. Include it when reporting a failure; not a visitor identifier.","schema":{"type":"string","format":"uuid"}},"Cache-Control":{"description":"Successful reads must revalidate before reuse. Errors use no-store.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Unexpected application failure. Safe JSON message; no internal details. Report X-Request-ID.","headers":{"X-Error-Code":{"description":"Present on errors. Machine-readable code paired with the unchanged legacy JSON error string.","schema":{"type":"string","enum":["INVALID_QUERY","NOT_FOUND","METHOD_NOT_ALLOWED","INTERNAL_ERROR"]}},"X-Agent-Contract-Version":{"description":"Semantic version of this public agent contract.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated request identifier. Include it when reporting a failure; not a visitor identifier.","schema":{"type":"string","format":"uuid"}},"Cache-Control":{"description":"Successful reads must revalidate before reuse. Errors use no-store.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/discovery":{"get":{"operationId":"discoverBrightRecords","summary":"Find Bright guides, model families and evidence records","description":"Find evidence-backed Bright discoveries, source reports, relevant guides and documented developments, or inspect a record and its provenance by stable ID. Use this for broad content retrieval and finding sources. Prefer getBrightGuide for explanations of Open Models or Data Centers, and exploreBrightOpenModels for model families, hardware planning or openness comparisons. Discovery preserves original record fields, stable IDs and pagination. Examples: q=speech, id=speech, topic=water. Results exclude private dossiers and device-local history. Bright is not a general-purpose search engine.","security":[],"parameters":[{"name":"q","in":"query","required":false,"description":"Natural-language question or text. Topic/intent metadata prioritizes relevant guides; lexical matching also searches public titles, descriptions, domains and section text. No external model inference is performed.","schema":{"type":"string","maxLength":200},"example":"speech"},{"name":"id","in":"query","required":false,"description":"Stable Bright record ID. When present, a successful response is the single matching record with its canonical URL and Markdown representation.","schema":{"type":"string","maxLength":150},"example":"speech"},{"name":"topic","in":"query","required":false,"description":"Stable Bright thread/topic ID used to restrict list results to linked records.","schema":{"type":"string","maxLength":150},"example":"water"},{"name":"offset","in":"query","required":false,"description":"Zero-based offset into the matching list.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991,"default":0},"example":0},{"name":"limit","in":"query","required":false,"description":"Maximum number of records returned in a list response.","schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"example":10}],"responses":{"200":{"headers":{"X-Error-Code":{"description":"Present on errors. Machine-readable code paired with the unchanged legacy JSON error string.","schema":{"type":"string","enum":["INVALID_QUERY","NOT_FOUND","METHOD_NOT_ALLOWED","INTERNAL_ERROR"]}},"X-Agent-Contract-Version":{"description":"Semantic version of this public agent contract.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated request identifier. Include it when reporting a failure; not a visitor identifier.","schema":{"type":"string","format":"uuid"}},"Cache-Control":{"description":"Successful reads must revalidate before reuse. Errors use no-store.","schema":{"type":"string"}}},"description":"A paginated result list, or a single public record when `id` is provided.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/DiscoveryList"},{"$ref":"#/components/schemas/DiscoveryLookup"}]}}}},"400":{"headers":{"X-Error-Code":{"description":"Present on errors. Machine-readable code paired with the unchanged legacy JSON error string.","schema":{"type":"string","enum":["INVALID_QUERY","NOT_FOUND","METHOD_NOT_ALLOWED","INTERNAL_ERROR"]}},"X-Agent-Contract-Version":{"description":"Semantic version of this public agent contract.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated request identifier. Include it when reporting a failure; not a visitor identifier.","schema":{"type":"string","format":"uuid"}},"Cache-Control":{"description":"Successful reads must revalidate before reuse. Errors use no-store.","schema":{"type":"string"}}},"description":"Malformed or unsupported query parameters, or an unknown topic ID.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"malformedQuery":{"value":{"error":"Use q (max 200 characters), id, topic, offset >= 0 and limit 1–50."}},"unknownTopic":{"value":{"error":"Unknown topic"}}}}}},"404":{"headers":{"X-Error-Code":{"description":"Present on errors. Machine-readable code paired with the unchanged legacy JSON error string.","schema":{"type":"string","enum":["INVALID_QUERY","NOT_FOUND","METHOD_NOT_ALLOWED","INTERNAL_ERROR"]}},"X-Agent-Contract-Version":{"description":"Semantic version of this public agent contract.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated request identifier. Include it when reporting a failure; not a visitor identifier.","schema":{"type":"string","format":"uuid"}},"Cache-Control":{"description":"Successful reads must revalidate before reuse. Errors use no-store.","schema":{"type":"string"}}},"description":"No public record has the requested stable ID.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Record not found"}}}},"405":{"description":"Method not allowed. Use GET or HEAD for reads, OPTIONS for CORS preflight.","headers":{"X-Error-Code":{"description":"Present on errors. Machine-readable code paired with the unchanged legacy JSON error string.","schema":{"type":"string","enum":["INVALID_QUERY","NOT_FOUND","METHOD_NOT_ALLOWED","INTERNAL_ERROR"]}},"X-Agent-Contract-Version":{"description":"Semantic version of this public agent contract.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated request identifier. Include it when reporting a failure; not a visitor identifier.","schema":{"type":"string","format":"uuid"}},"Cache-Control":{"description":"Successful reads must revalidate before reuse. Errors use no-store.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Unexpected application failure. Safe JSON message; no internal details. Report X-Request-ID.","headers":{"X-Error-Code":{"description":"Present on errors. Machine-readable code paired with the unchanged legacy JSON error string.","schema":{"type":"string","enum":["INVALID_QUERY","NOT_FOUND","METHOD_NOT_ALLOWED","INTERNAL_ERROR"]}},"X-Agent-Contract-Version":{"description":"Semantic version of this public agent contract.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated request identifier. Include it when reporting a failure; not a visitor identifier.","schema":{"type":"string","format":"uuid"}},"Cache-Control":{"description":"Successful reads must revalidate before reuse. Errors use no-store.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"AgentGuideEvidence":{"type":"object","additionalProperties":false,"required":["id","title","url","note","provenance","supports"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"note":{"type":"string"},"provenance":{"type":"string","enum":["academic-research","government-or-regulator","local-government","utility-or-grid-operator","developer-or-vendor","repository-or-documentation","institutional-report"]},"supports":{"type":"array","items":{"type":"string"}}}},"AgentGuideSection":{"type":"object","additionalProperties":false,"required":["id","title","answer","evidenceIds","canonicalUrl"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"answer":{"type":"array","items":{"type":"string"}},"evidenceIds":{"type":"array","items":{"type":"string"}},"canonicalUrl":{"type":"string","format":"uri"}}},"AgentGuideFact":{"type":"object","additionalProperties":false,"required":["id","claim","qualifier","evidenceIds"],"properties":{"id":{"type":"string"},"claim":{"type":"string"},"qualifier":{"type":"string"},"evidenceIds":{"type":"array","items":{"type":"string"}}}},"AgentGuideRelatedResource":{"type":"object","additionalProperties":false,"required":["type","id","title","url"],"properties":{"type":{"type":"string","enum":["record","guide"]},"id":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","format":"uri"}}},"AgentGuideLocality":{"type":["object","null"],"additionalProperties":false,"required":["localDeterminationMade","statement","variables"],"properties":{"localDeterminationMade":{"type":"boolean","const":false},"statement":{"type":"string"},"variables":{"type":"array","items":{"type":"string"}}}},"AgentGuideResponse":{"type":"object","additionalProperties":false,"required":["schemaVersion","id","type","slug","parentId","title","query","answer","scope","topic","topics","aliases","intents","geography","locality","sections","facts","limitations","evidence","relatedResources","canonicalUrl","markdownUrl","lastReviewedAt","publicationDate","lastUpdatedAt","methodology"],"properties":{"schemaVersion":{"type":"string","const":"2026-09-19"},"id":{"type":"string"},"type":{"type":"string","const":"guide"},"slug":{"type":"string"},"parentId":{"type":["string","null"]},"title":{"type":"string"},"query":{"type":"string"},"answer":{"type":"string"},"scope":{"type":"string","const":"Bright synthesis"},"topic":{"type":"string"},"topics":{"type":"array","items":{"type":"string"}},"aliases":{"type":"array","maxItems":24,"items":{"type":"string"}},"intents":{"type":"array","items":{"type":"string"}},"geography":{"type":["string","null"]},"locality":{"$ref":"#/components/schemas/AgentGuideLocality"},"sections":{"type":"array","items":{"$ref":"#/components/schemas/AgentGuideSection"}},"facts":{"type":"array","items":{"$ref":"#/components/schemas/AgentGuideFact"}},"limitations":{"type":"array","items":{"type":"string"}},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/AgentGuideEvidence"}},"relatedResources":{"type":"array","items":{"$ref":"#/components/schemas/AgentGuideRelatedResource"}},"canonicalUrl":{"type":"string","format":"uri"},"markdownUrl":{"type":"string","format":"uri"},"lastReviewedAt":{"type":"string","format":"date"},"publicationDate":{"type":"string","format":"date"},"lastUpdatedAt":{"type":["string","null"],"format":"date"},"methodology":{"type":"string"}}},"AgentGuideEnvelope":{"type":"object","additionalProperties":false,"required":["query","topic","geography","count","results"],"properties":{"query":{"type":["string","null"]},"topic":{"type":["string","null"]},"geography":{"type":["string","null"]},"count":{"type":"integer","minimum":0,"maximum":5},"results":{"type":"array","maxItems":5,"items":{"$ref":"#/components/schemas/AgentGuideResponse"}}}},"ModelError":{"$ref":"#/components/schemas/Error"},"ModelEvidence":{"type":"object","required":["id","title","url","type","provenance"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"type":{"type":"string","enum":["paper","institution","government","repository","dataset","registry","report"]},"publishedAt":{"type":"string","format":"date"},"provenance":{"type":"string"}},"additionalProperties":false},"ModelReleaseEvent":{"type":"object","required":["kind","date","precision","label","sourceUrl"],"properties":{"kind":{"type":"string","enum":["initial-release","announcement","availability","update","early-access"]},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}(?:-\\d{2})?$","description":"A day-precision YYYY-MM-DD date or month-precision YYYY-MM date, as identified by `precision`."},"precision":{"type":"string","enum":["day","month"]},"label":{"type":"string"},"sourceUrl":{"type":"string","format":"uri"}},"additionalProperties":false},"ModelFamilyCandidate":{"type":"object","required":["id","name","checkpoint","organization","parameters","totalBillions","activeBillions","modalities","context","license","commercialUse","relevance","limitations","evidenceContext","evidenceIds","releaseEvents","canonicalUrl","markdownUrl"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"checkpoint":{"type":"string"},"organization":{"type":"string"},"parameters":{"type":"string"},"totalBillions":{"type":["number","null"]},"activeBillions":{"type":["number","null"]},"modalities":{"type":"array","items":{"type":"string"}},"context":{"type":"string"},"license":{"type":"string"},"commercialUse":{"type":"string"},"relevance":{"type":"array","items":{"type":"string"}},"limitations":{"type":"array","items":{"type":"string"}},"evidenceContext":{"type":"string"},"evidenceIds":{"type":"array","items":{"type":"string"},"minItems":1},"releaseEvents":{"type":"array","items":{"$ref":"#/components/schemas/ModelReleaseEvent"}},"canonicalUrl":{"type":"string","format":"uri"},"markdownUrl":{"type":"string","format":"uri"}},"additionalProperties":false},"ExploreModelsResponse":{"type":"object","required":["action","answer","filters","matchedCount","returnedCount","truncated","ordering","limitations","candidates","evidence","canonicalUrl","markdownUrl","lastReviewedAt"],"properties":{"action":{"const":"explore"},"answer":{"type":"string"},"filters":{"type":"object","required":["intent","modality","size","commercial","reproducibility","limit"],"properties":{"intent":{"type":["string","null"]},"modality":{"type":["string","null"]},"size":{"type":["string","null"],"enum":["small","medium","large",null]},"commercial":{"type":"string","enum":["required","any"]},"reproducibility":{"type":"string","enum":["substantial","any"]},"limit":{"type":"integer","minimum":1,"maximum":10}},"additionalProperties":false},"matchedCount":{"type":"integer","minimum":0},"returnedCount":{"type":"integer","minimum":0,"maximum":10},"truncated":{"type":"boolean"},"ordering":{"const":"catalog-order"},"limitations":{"type":"array","items":{"type":"string"}},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/ModelFamilyCandidate"}},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/ModelEvidence"}},"canonicalUrl":{"type":"string","format":"uri"},"markdownUrl":{"type":"string","format":"uri"},"lastReviewedAt":{"type":"string","format":"date"}},"additionalProperties":false},"HardwareModelCandidate":{"type":"object","required":["id","familyId","name","totalBillions","activeBillions","calculationBits","weightStorageLowerBoundGb","memory","whyItMayFit","familyQuantizationGuidance","useCaseNote","familyLicense","familyCommercialUse","familyContextGuidance","familyRuntimeGuidance","evidenceContext","familyEvidenceIds","familySourceUrl","parameterEvidenceUrl","canonicalUrl","markdownUrl"],"properties":{"id":{"type":"string"},"familyId":{"type":"string"},"name":{"type":"string"},"totalBillions":{"type":"number","exclusiveMinimum":0},"activeBillions":{"type":["number","null"]},"calculationBits":{"type":"integer","enum":[4,8,16]},"weightStorageLowerBoundGb":{"type":"number","exclusiveMinimum":0},"memory":{"type":"object","required":["type","availableGb"],"properties":{"type":{"type":"string","enum":["ram","vram","unified"]},"availableGb":{"type":"number","minimum":1,"maximum":2048}},"additionalProperties":false},"whyItMayFit":{"type":"string"},"familyQuantizationGuidance":{"type":"array","items":{"type":"string"},"description":"Quantization notes from the family record. Clients must verify that a note applies to the returned named checkpoint."},"useCaseNote":{"type":["string","null"]},"familyLicense":{"type":"string","description":"License recorded on Bright’s checked family record. Clients must verify its application to the exact checkpoint and artifact."},"familyCommercialUse":{"type":"string","description":"Commercial-use guidance from the family record, not a blanket permission for every family artifact."},"familyContextGuidance":{"type":"string","description":"Context guidance from the family record; it is not silently asserted for every family checkpoint."},"familyRuntimeGuidance":{"type":"string","description":"Memory and runtime guidance from the family record, retained as qualified context rather than an exact compatibility claim."},"evidenceContext":{"type":"string"},"familyEvidenceIds":{"type":"array","items":{"type":"string"},"minItems":1,"description":"Evidence IDs attached to the checked family record."},"familySourceUrl":{"type":"string","format":"uri","description":"Canonical Bright family reference. It is not labeled as a checkpoint-primary source."},"parameterEvidenceUrl":{"type":"string","format":"uri","description":"Existing source that establishes the total-parameter count for this named checkpoint."},"canonicalUrl":{"type":"string","format":"uri"},"markdownUrl":{"type":"string","format":"uri"}},"additionalProperties":false},"HardwareModelsResponse":{"type":"object","required":["action","answer","hardware","matchedCount","returnedCount","truncated","ordering","limitations","candidates","evidence","canonicalUrl","markdownUrl","lastReviewedAt"],"properties":{"action":{"const":"hardware"},"answer":{"type":"string"},"hardware":{"type":"object","required":["memoryGb","memoryType","platform","device","gpu","contextTokens","bits","planningReservePercent","availableForWeightsGb","gpuMemoryInferred","limit"],"properties":{"memoryGb":{"type":"number","minimum":1,"maximum":2048},"memoryType":{"type":"string","enum":["ram","vram","unified"]},"platform":{"type":["string","null"]},"device":{"type":["string","null"]},"gpu":{"type":["string","null"]},"contextTokens":{"type":["integer","null"],"minimum":1,"maximum":10000000},"bits":{"type":"integer","enum":[4,8,16]},"planningReservePercent":{"type":"number","minimum":0,"maximum":99},"availableForWeightsGb":{"type":"number","exclusiveMinimum":0},"gpuMemoryInferred":{"const":false},"limit":{"type":"integer","minimum":1,"maximum":10}},"additionalProperties":false},"matchedCount":{"type":"integer","minimum":0},"returnedCount":{"type":"integer","minimum":0,"maximum":10},"truncated":{"type":"boolean"},"ordering":{"const":"total-parameters-ascending"},"limitations":{"type":"array","items":{"type":"string"}},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/HardwareModelCandidate"}},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/ModelEvidence"}},"canonicalUrl":{"type":"string","format":"uri"},"markdownUrl":{"type":"string","format":"uri"},"lastReviewedAt":{"type":"string","format":"date"}},"additionalProperties":false},"OpennessComparison":{"type":"object","required":["key","label","description","models"],"properties":{"key":{"type":"string","enum":["weights","architecture","inference","trainingCode","recipe","dataInformation","trainingData","evaluation","commercialUse"]},"label":{"type":"string"},"description":{"type":"string"},"models":{"type":"array","minItems":2,"maxItems":5,"items":{"type":"object","required":["familyId","status","detail","evidenceUrl"],"properties":{"familyId":{"type":"string"},"status":{"type":"string","enum":["available","partial","restricted","not-established"]},"detail":{"type":"string"},"evidenceUrl":{"type":"string","format":"uri"}},"additionalProperties":false}}},"additionalProperties":false},"CompareModelsResponse":{"type":"object","required":["action","answer","families","dimensions","limitations","evidence","canonicalUrl","markdownUrl","lastReviewedAt"],"properties":{"action":{"const":"compare"},"answer":{"type":"string"},"families":{"type":"array","minItems":2,"maxItems":5,"items":{"type":"object","required":["id","name","checkpoint","license","commercialUse","canonicalUrl","markdownUrl"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"checkpoint":{"type":"string"},"license":{"type":"string"},"commercialUse":{"type":"string"},"canonicalUrl":{"type":"string","format":"uri"},"markdownUrl":{"type":"string","format":"uri"}},"additionalProperties":false}},"dimensions":{"type":"array","minItems":9,"maxItems":9,"items":{"$ref":"#/components/schemas/OpennessComparison"}},"limitations":{"type":"array","items":{"type":"string"}},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/ModelEvidence"}},"canonicalUrl":{"type":"string","format":"uri"},"markdownUrl":{"type":"string","format":"uri"},"lastReviewedAt":{"type":"string","format":"date"}},"additionalProperties":false},"WeeklyItem":{"type":"object","required":["id","position","kind","title","claim","whyItMatters","evidenceState","limitation","sources","recordUrl"],"properties":{"id":{"type":"string"},"position":{"type":"integer","minimum":1},"kind":{"type":"string","enum":["development","not-established","from-the-record"]},"title":{"type":"string"},"claim":{"type":"string"},"whyItMatters":{"type":["string","null"]},"evidenceState":{"type":"string","minLength":1},"limitation":{"type":"string","minLength":1},"sources":{"type":"array","minItems":1,"items":{"type":"object","required":["title","url"],"properties":{"title":{"type":"string"},"url":{"type":"string","format":"uri"},"checkedAt":{"type":"string","format":"date"}},"additionalProperties":false}},"recordUrl":{"type":["string","null"],"format":"uri"}},"additionalProperties":false},"WeeklyEdition":{"type":"object","required":["id","kind","title","subject","summary","publishedOn","version","canonicalUrl","markdownUrl","items","worthWatching","correction","review","attribution"],"properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["bright-weekly"]},"title":{"type":"string"},"subject":{"type":"string"},"summary":{"type":"string"},"publishedOn":{"type":["string","null"],"format":"date"},"version":{"type":"integer","minimum":1},"canonicalUrl":{"type":"string","format":"uri"},"markdownUrl":{"type":"string","format":"uri"},"items":{"type":"array","items":{"$ref":"#/components/schemas/WeeklyItem"}},"worthWatching":{"type":"string"},"correction":{"type":["string","null"]},"review":{"type":"string"},"attribution":{"type":"string"}},"additionalProperties":false},"WeeklyIndexEntry":{"type":"object","required":["id","kind","title","publishedOn","canonicalUrl"],"properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["bright-weekly"]},"title":{"type":"string"},"publishedOn":{"type":["string","null"],"format":"date"},"canonicalUrl":{"type":"string","format":"uri"}},"additionalProperties":false},"WeeklyResponse":{"oneOf":[{"type":"object","required":["status","edition"],"properties":{"status":{"const":"published"},"edition":{"$ref":"#/components/schemas/WeeklyEdition"}},"additionalProperties":false},{"type":"object","required":["status","message","cadence","archive"],"properties":{"status":{"const":"none-published"},"message":{"type":"string"},"cadence":{"type":"string"},"archive":{"type":"string","format":"uri"}},"additionalProperties":false},{"type":"object","required":["edition"],"properties":{"edition":{"$ref":"#/components/schemas/WeeklyEdition"}},"additionalProperties":false},{"type":"object","required":["cadence","editions"],"properties":{"cadence":{"type":"string"},"editions":{"type":"array","items":{"$ref":"#/components/schemas/WeeklyIndexEntry"}}},"additionalProperties":false}]},"ClaimEvidence":{"type":"object","required":["claim","assessment","guidance","matches"],"properties":{"claim":{"type":"string"},"assessment":{"const":"not-assessed-by-bright"},"guidance":{"type":"string"},"matches":{"type":"array","items":{"type":"object","required":["id","title","url","kind","evidenceState","limitations","sources","matchedTerms"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"kind":{"type":"string"},"evidenceState":{"type":["string","null"]},"limitations":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object","required":["title","url"],"properties":{"title":{"type":"string"},"url":{"type":"string"}},"additionalProperties":false}},"matchedTerms":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}}},"additionalProperties":false},"DiscoveryList":{"type":"object","description":"A deterministic page of public Bright records.","required":["total","offset","limit","items","nextOffset"],"properties":{"total":{"type":"integer","minimum":0,"description":"Total number of records matching the request."},"offset":{"type":"integer","minimum":0,"description":"Offset used for this page."},"limit":{"type":"integer","minimum":1,"maximum":50,"description":"Requested maximum page size."},"items":{"type":"array","description":"Public records in this page.","items":{"$ref":"#/components/schemas/PublicRecord"}},"nextOffset":{"type":["integer","null"],"minimum":0,"description":"Offset for the next page, or null when pagination is complete."}},"additionalProperties":false},"DiscoveryLookup":{"allOf":[{"$ref":"#/components/schemas/PublicRecord"},{"type":"object","required":["url","markdown"],"properties":{"url":{"type":"string","format":"uri","description":"Absolute canonical URL for Bright's record."},"markdown":{"type":"string","description":"Readable Markdown projection of the record, including its sources, limitations, and related links."}}}]},"PublicRecord":{"type":"object","description":"A public Bright discovery, source report, guide, authored experience, or collection. Optional history fields are present only where the source record provides them.","required":["id","kind","path","title","description","domains","sections","sources","links","limitations"],"properties":{"type":{"type":"string","const":"guide","description":"Additive machine resource type. Namespaced guide projections use kind guide; original record IDs and kinds remain available."},"guideId":{"type":"string","description":"Stable machine guide/subresource ID."},"answerFirst":{"type":"string","description":"Concise guide synthesis; retain its limitations and follow guideUrl for claim-linked evidence."},"canonicalUrl":{"type":"string","format":"uri","description":"Best canonical Bright page or stable section to cite."},"markdownUrl":{"type":"string","format":"uri","description":"Non-JavaScript full document representation."},"guideUrl":{"type":"string","format":"uri","description":"Structured guide retrieval URL."},"topics":{"type":"array","items":{"type":"string"},"description":"Guide topic metadata."},"aliases":{"type":"array","items":{"type":"string"},"description":"Natural-language vocabulary for guide retrieval."},"intents":{"type":"array","items":{"type":"string"},"description":"Question classes supported by the guide."},"lastReviewedAt":{"type":["string","null"],"format":"date","description":"Underlying editorial source-review date, not an event or software-build date."},"id":{"type":"string","description":"Stable Bright record ID."},"kind":{"type":"string","enum":["discovery","source-report","guide","experience","collection","model-family"],"description":"Public record format."},"path":{"type":"string","pattern":"^/","description":"Root-relative public path for the record."},"title":{"type":"string","description":"Human-readable record title."},"description":{"type":"string","description":"Plain-language summary of the record."},"domains":{"type":"array","description":"Public subjects or domains associated with the record.","items":{"type":"string"}},"sourceDate":{"type":["string","null"],"format":"date","description":"Publication date of the underlying source, when established."},"published":{"type":["string","null"],"format":"date","description":"Date Bright added or published the record, when recorded. This is not a new scientific event date."},"modified":{"type":["string","null"],"format":"date","description":"Date of the latest substantive revision or correction, when recorded."},"review":{"type":"string","description":"Human-readable evidence, confidence, and editorial review context."},"dates":{"$ref":"#/components/schemas/RecordDates"},"provenance":{"type":"object","description":"Public provenance or authored-work metadata. Internal intake routing is excluded.","additionalProperties":true},"revisions":{"type":"array","description":"Recorded substantive revision history.","items":{"$ref":"#/components/schemas/Revision"}},"corrections":{"type":"array","description":"Recorded correction history.","items":{"$ref":"#/components/schemas/Correction"}},"sections":{"type":"array","description":"Structured public narrative, including documented results, context, and limitations where applicable.","items":{"$ref":"#/components/schemas/Section"}},"limitations":{"type":"array","description":"Important limits on the claim, source, experience, or interpretation.","items":{"type":"string"}},"sources":{"type":"array","description":"Original or supporting sources. Attribute underlying claims to these primary sources when possible.","items":{"$ref":"#/components/schemas/Source"}},"links":{"type":"array","description":"Related public Bright records and experiences.","items":{"$ref":"#/components/schemas/RelatedLink"}}}},"RecordDates":{"type":"object","required":["eventDate","publicationDate","captureDate","lastReviewedDate"],"properties":{"eventDate":{"type":["string","null"],"format":"date","description":"Date of the documented event, when established."},"publicationDate":{"type":["string","null"],"format":"date","description":"Date the underlying source was published."},"captureDate":{"type":["string","null"],"format":"date","description":"Date source data or a snapshot was captured."},"lastReviewedDate":{"type":["string","null"],"format":"date","description":"Date Bright most recently reviewed the record."}},"additionalProperties":false},"Section":{"type":"object","required":["title","text"],"properties":{"title":{"type":"string","description":"Section heading."},"text":{"type":"array","description":"Section paragraphs.","items":{"type":"string"}}},"additionalProperties":false},"Source":{"type":"object","required":["title","url"],"properties":{"id":{"type":"string","description":"Stable source ID, when the record defines one."},"title":{"type":"string","description":"Source title."},"url":{"type":"string","format":"uri","description":"Public source URL."},"type":{"type":"string","description":"Source category, when the record defines one."}},"additionalProperties":false},"RelatedLink":{"type":"object","required":["title","path"],"properties":{"title":{"type":"string","description":"Related item title."},"path":{"type":"string","pattern":"^/","description":"Root-relative Bright path."}},"additionalProperties":false},"Revision":{"type":"object","required":["id","recordedAt","summary","sourceIds"],"properties":{"id":{"type":"string","description":"Stable revision ID."},"recordedAt":{"type":["string","null"],"format":"date","description":"Date the revision was recorded."},"summary":{"type":"string","description":"Summary of the revision."},"sourceIds":{"type":"array","description":"Source IDs supporting the revision.","items":{"type":"string"}},"snapshot":{"type":"object","description":"Earlier public field values retained for history.","additionalProperties":true}},"additionalProperties":false},"Correction":{"type":"object","required":["id","issuedAt","summary","sourceIds","supersedesRevisionId"],"properties":{"id":{"type":"string","description":"Stable correction ID."},"issuedAt":{"type":["string","null"],"format":"date","description":"Date the correction was issued."},"summary":{"type":"string","description":"Summary of the correction."},"sourceIds":{"type":"array","description":"Source IDs supporting the correction.","items":{"type":"string"}},"supersedesRevisionId":{"type":["string","null"],"description":"Revision superseded by this correction, if any."},"reviewerId":{"type":["string","null"],"description":"Recorded reviewer ID, when present."},"sourceUrl":{"type":["string","null"],"format":"uri","description":"Supporting source URL, when present."}},"additionalProperties":false},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Legacy human-readable error string; retained for existing clients."}},"additionalProperties":false}}}}