{"openapi":"3.1.0","info":{"title":"Model Plan public read-only data API","version":"0.21.116","description":"Read-only data services. Responses retain source identity, freshness and uncertainty. No model execution or subscription mutations. The API includes per-configuration AA generation-time estimates and optional plan-edition scope without changing unfiltered directory responses. Legacy task time retains its original metric. Website display now reads experimental composite metrics; legacy AA endpoints retain original units. Task runtimes retain reported source boundaries and populations, not guaranteed successful completions. Reviewed plans retain billing period, currency uncertainty, structured quota windows and source-qualified access. Immutable public publications are separate from raw source snapshots. The Cloudflare preparation preview supports the documented snapshot subset; full Node endpoints and MCP remain on the producer host."},"servers":[{"url":"https://modelplan.ai"}],"paths":{"/v1/advice":{"get":{"summary":"Rule-based plan × model × effort advice with exclusions, unknowns and a closed-choice rankerInput for external rankers","parameters":[{"name":"task","in":"query","required":false,"description":"Task type","schema":{"type":"string","enum":["development","debugging","review","general"]}},{"name":"size","in":"query","required":false,"description":"Task size","schema":{"type":"string","enum":["small","medium","large"]}},{"name":"plans","in":"query","required":false,"description":"Comma-separated plan ids the user holds","schema":{"type":"string"}},{"name":"preference","in":"query","required":false,"description":"Ranking preference","schema":{"type":"string","enum":["balanced","save","capability"]}},{"name":"lang","in":"query","required":false,"description":"Reason language","schema":{"type":"string","enum":["zh","en"]}},{"name":"at","in":"query","required":false,"description":"ISO time to evaluate","schema":{"type":"string"}}],"responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Invalid parameters"}},"description":"Provisional deterministic comparison. Personal quota is accepted only by POST; this GET response is no-store. Unknown eligibility requires verification and reference-task estimates are not personal task bounds."},"post":{"summary":"Same as GET with a JSON body (task, plans, preference, quota, at, language); stateless, response is no-store","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Invalid request"}}}},"/v1/quota-capacity":{"get":{"summary":"Third-party weekly token pools per plan × model (Real API Pricing, MIT); economic estimates, never official terms or personal balances","parameters":[{"name":"plan","in":"query","required":false,"description":"Plan id","schema":{"type":"string"}},{"name":"model","in":"query","required":false,"description":"Model id","schema":{"type":"string"}}],"responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}}}},"/v1/reset-events":{"get":{"summary":"Vendor-wide reset announcements with verification status; not proof of a personal reset","parameters":[{"name":"provider","in":"query","required":false,"description":"Provider id","schema":{"type":"string"}},{"name":"lang","in":"query","required":false,"description":"Language","schema":{"type":"string","enum":["zh","en"]}}],"responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}}}},"/v1/capabilities":{"get":{"summary":"Deployment transport and supported query surface","parameters":[],"responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"304":{"description":"ETag unchanged"}}}},"/v1/models":{"get":{"summary":"Curated models and native reasoning configurations","parameters":[],"responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"304":{"description":"ETag unchanged"},"400":{"description":"Invalid parameters"},"503":{"description":"No successful upstream snapshot"}},"description":"generationTime is per-configuration AA Intelligence Index decode time, with source method and null reason. A null valueSeconds may include trialEstimate for review only; it never sets the quantitative Z axis. Historical numeric differences are not prediction errors unless benchmark and performance windows are confirmed comparable. It is not whole-task wall time."}},"/v1/configurations":{"get":{"summary":"All AA observations including pending mappings","parameters":[{"name":"limit","in":"query","schema":{"type":"integer"}},{"name":"offset","in":"query","schema":{"type":"integer"}},{"name":"snapshot","in":"query","schema":{"type":"string"}},{"name":"mapping","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"304":{"description":"ETag unchanged"},"400":{"description":"Invalid parameters"},"503":{"description":"No successful upstream snapshot"}},"description":"generationTime is per-configuration AA Intelligence Index decode time, with source method and null reason. A null valueSeconds may include trialEstimate for review only; it never sets the quantitative Z axis. Historical numeric differences are not prediction errors unless benchmark and performance windows are confirmed comparable. It is not whole-task wall time."}},"/v1/snapshots/latest":{"get":{"summary":"Current AA snapshot identity","parameters":[],"responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"304":{"description":"ETag unchanged"},"400":{"description":"Invalid parameters"},"503":{"description":"No successful upstream snapshot"}}}},"/v1/recommendations":{"get":{"summary":"Evidence-based grouped recommendations","parameters":[{"name":"task","in":"query","schema":{"type":"string","enum":["general","coding","agentic","debugging","terminal","software-repair","code-editing","code-generation"]}},{"name":"policy","in":"query","schema":{"type":"string"}},{"name":"model","in":"query","schema":{"type":"string"}},{"name":"harness","in":"query","schema":{"type":"string"}},{"name":"tolerance","in":"query","schema":{"type":"number"}},{"name":"maxCost","in":"query","schema":{"type":"number"}},{"name":"deadlineSeconds","in":"query","schema":{"type":"number"}}],"responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"304":{"description":"ETag unchanged"},"400":{"description":"Invalid parameters"},"503":{"description":"No successful upstream snapshot"}},"description":"Default general/balanced returns v3 choices per verified model using the same policy as the chart, including an 80% same-model score floor and 10% observed effort-gain floor. Explicit tolerance and specialist policies retain separately labeled legacy rules. Automatic routing is disabled."}},"/v1/routes":{"get":{"summary":"OpenRouter catalog and supported parameters","parameters":[{"name":"q","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"304":{"description":"ETag unchanged"},"400":{"description":"Invalid parameters"},"503":{"description":"No successful upstream snapshot"}}}},"/v1/plans":{"get":{"summary":"Versioned plan terms and source freshness","parameters":[{"name":"provider","in":"query","schema":{"type":"string","enum":["openai","claude","zhipu","zai","multi","grok","kimi","minimax","alibaba","volcengine","opencode"]},"description":"Registered provider, including multi for cross-provider records."}],"responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"304":{"description":"ETag unchanged"},"400":{"description":"Invalid parameters"},"503":{"description":"No successful upstream snapshot"}},"description":"Reviewed plan catalogue. Optional modelCatalog preserves every advertised name with indexed/listed-only/not-in-index status and catalogue-level unpublished/unknown status. Indexed metrics use the current Index; single-source-reference ability is a normalized benchmark reference, not an aggregate or plan-native recommendation. Enterprise price.billingUnit=seat and minimumUnits specify the minimum purchase; quotaEstimates are scoped estimates, not guaranteed quotaTerms."}},"/v1/rules":{"get":{"summary":"Reviewed rules and explicitly unresolved claims","parameters":[],"responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"304":{"description":"ETag unchanged"},"400":{"description":"Invalid parameters"},"503":{"description":"No successful upstream snapshot"}}}},"/v1/calendar":{"get":{"summary":"Scenario plan calendar; never implies a private quota reset","parameters":[{"name":"plan","in":"query","schema":{"type":"string"}},{"name":"model","in":"query","schema":{"type":"string"}},{"name":"client","in":"query","schema":{"type":"string"}},{"name":"clientVersion","in":"query","schema":{"type":"string"}},{"name":"quota","in":"query","schema":{"type":"string"}},{"name":"from","in":"query","schema":{"type":"string"}},{"name":"to","in":"query","schema":{"type":"string"}},{"name":"tz","in":"query","schema":{"type":"string"}},{"name":"provider","in":"query","schema":{"type":"string","enum":["openai","claude","zhipu","zai","grok","kimi","minimax","alibaba","volcengine","opencode","glm"]},"description":"Registered calendar provider; glm combines reviewed BigModel/Z.ai scope."},{"name":"lang","in":"query","schema":{"type":"string","enum":["zh","en"]},"description":"Fixed feed language."},{"name":"edition","in":"query","description":"Optional, explicit plan-edition display scope; omission preserves the prior full public scope. An exact plan selection wins over this preference.","schema":{"type":"string","enum":["cn-first","international-first","all"]}},{"name":"models","in":"query","description":"Comma-separated focused model version IDs","schema":{"type":"string"}},{"name":"plans","in":"query","description":"Comma-separated explicitly browsed plan version IDs","schema":{"type":"string"}},{"name":"efforts","in":"query","description":"Comma-separated modelId:effort selections","schema":{"type":"string"}}],"responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"304":{"description":"ETag unchanged"},"400":{"description":"Invalid parameters"},"503":{"description":"No successful upstream snapshot"}},"description":"Public event and edition filters are resolved from the same reviewed plan scope; local browser preferences are never inferred server-side."}},"/v1/calendar/evaluate":{"get":{"summary":"Evaluate a plan window under explicit assumptions","parameters":[{"name":"plan","in":"query","schema":{"type":"string"}},{"name":"model","in":"query","schema":{"type":"string"}},{"name":"client","in":"query","schema":{"type":"string"}},{"name":"clientVersion","in":"query","schema":{"type":"string"}},{"name":"quota","in":"query","schema":{"type":"string"}},{"name":"at","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"304":{"description":"ETag unchanged"},"400":{"description":"Invalid parameters"},"503":{"description":"No successful upstream snapshot"}}}},"/v1/news":{"get":{"summary":"Plan-focused news discovery, not verified benefits","parameters":[{"name":"provider","in":"query","schema":{"type":"string","enum":["openai","claude","zhipu","zai","multi","grok","kimi","minimax","alibaba","volcengine","opencode"]},"description":"Registered provider, including multi for cross-provider records."},{"name":"topic","in":"query","schema":{"type":"string"}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"days","in":"query","description":"Reported-news archive window: 7 (default), 30 or 90 days; history grows from local ingestion","schema":{"type":"integer","enum":[7,30,90],"default":7}}],"responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"304":{"description":"ETag unchanged"},"400":{"description":"Invalid parameters"},"503":{"description":"No successful upstream snapshot"}}}},"/v1/sources":{"get":{"summary":"Per-source freshness and review status","parameters":[],"responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"304":{"description":"ETag unchanged"},"400":{"description":"Invalid parameters"},"503":{"description":"No successful upstream snapshot"}}}},"/v1/evaluations":{"get":{"summary":"Task-specific evidence observations","parameters":[{"name":"task","in":"query","schema":{"type":"string","enum":["general","coding","agentic","debugging","terminal","software-repair","code-editing","code-generation"]}},{"name":"model","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"304":{"description":"ETag unchanged"},"400":{"description":"Invalid parameters"},"503":{"description":"No successful upstream snapshot"}},"description":"At most 200 observations. totalRecords/truncated indicate coverage; narrow by model when truncated."}},"/v1/benchmark-sources":{"get":{"summary":"Live and reference-only benchmark provenance","parameters":[],"responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"304":{"description":"ETag unchanged"},"400":{"description":"Invalid parameters"},"503":{"description":"No successful upstream snapshot"}}}},"/health/sources":{"get":{"summary":"AA refresh state","parameters":[],"responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"304":{"description":"ETag unchanged"},"400":{"description":"Invalid parameters"},"503":{"description":"No successful upstream snapshot"}}}},"/calendar.ics":{"get":{"summary":"Public rolling 28-day ICS subscription, or a bounded requested week","parameters":[{"name":"plan","in":"query","schema":{"type":"string"}},{"name":"model","in":"query","schema":{"type":"string"}},{"name":"client","in":"query","schema":{"type":"string"}},{"name":"clientVersion","in":"query","schema":{"type":"string"}},{"name":"quota","in":"query","schema":{"type":"string"}},{"name":"from","in":"query","schema":{"type":"string"}},{"name":"to","in":"query","schema":{"type":"string"}},{"name":"tz","in":"query","schema":{"type":"string"}},{"name":"provider","in":"query","schema":{"type":"string","enum":["openai","claude","zhipu","zai","grok","kimi","minimax","alibaba","volcengine","opencode","glm"]},"description":"Registered calendar provider; glm combines reviewed BigModel/Z.ai scope."},{"name":"lang","in":"query","schema":{"type":"string","enum":["zh","en"]},"description":"Fixed feed language."},{"name":"edition","in":"query","description":"Optional, explicit plan-edition display scope; omission preserves the prior full public scope. An exact plan selection wins over this preference.","schema":{"type":"string","enum":["cn-first","international-first","all"]}},{"name":"models","in":"query","description":"Comma-separated focused model version IDs","schema":{"type":"string"}},{"name":"plans","in":"query","description":"Comma-separated explicitly browsed plan version IDs","schema":{"type":"string"}},{"name":"efforts","in":"query","description":"Comma-separated modelId:effort selections","schema":{"type":"string"}}],"responses":{"200":{"description":"RFC 5545 calendar, stable UID and explicit uncertainty","content":{"text/calendar":{"schema":{"type":"string"}}}}},"description":"Public event and edition filters are resolved from the same reviewed plan scope; local browser preferences are never inferred server-side."}},"/v1/recommendations/evaluate":{"post":{"summary":"Read-only scenario evaluation; never executes inference","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"task":{"type":"string"},"policy":{"type":"string"},"model":{"type":"string"},"harness":{"type":"string"},"tolerance":{"type":"number"},"maxCost":{"type":"number"},"deadlineSeconds":{"type":"number"}}}}}},"responses":{"200":{"description":"Same query contract as GET recommendations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Invalid input"},"413":{"description":"Maximum 64 KiB request body"}}}},"/v1/catalog":{"get":{"summary":"Full source catalog with explicit model/service mappings and coverage","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"offset","in":"query","schema":{"type":"integer"}},{"name":"limit","in":"query","schema":{"type":"integer"}},{"name":"view","in":"query","description":"versions groups model releases once; default preserves the existing full catalog contract","schema":{"type":"string","enum":["versions"]}},{"name":"scope","in":"query","schema":{"type":"string","enum":["coding","raw"],"default":"raw"},"description":"Coding contains only reviewed Coding-tool-selectable versions; raw discovery is retained for compatibility."},{"name":"history","in":"query","schema":{"type":"string","enum":["recent"]},"description":"Opt into a 30-day retired comparison archive; not current subscription availability."}],"responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"304":{"description":"ETag unchanged"},"400":{"description":"Invalid parameters"},"503":{"description":"No successful upstream snapshot"}}}},"/v1/methodology":{"get":{"summary":"Versioned deterministic scoring and admission policy","parameters":[],"responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"304":{"description":"ETag unchanged"},"400":{"description":"Invalid parameters"},"503":{"description":"No successful upstream snapshot"}},"description":"Documents balanced-coding-absolute-v4 and AA generation-time method aa-index-generation-v3; default ranking uses score and monetary cost only."}},"/v1/recommendation-preview":{"get":{"summary":"Active v3 recommendation settings and sensitivity candidates","parameters":[{"name":"model","in":"query","schema":{"type":"string"},"description":"Exact curated model id, such as opus; omit for all featured models."},{"name":"minimumScore","in":"query","schema":{"type":"number","minimum":0},"description":"Optional scenario parameter. Supply all four numeric parameters together, or none."},{"name":"costScale","in":"query","schema":{"type":"number","minimum":0},"description":"Optional scenario parameter. Supply all four numeric parameters together, or none."},{"name":"timeReferenceSeconds","in":"query","schema":{"type":"number","minimum":0},"description":"Optional scenario parameter. Supply all four numeric parameters together, or none."},{"name":"timeWeightCap","in":"query","schema":{"type":"number","minimum":0},"description":"Optional scenario parameter. Supply all four numeric parameters together, or none."}],"responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"304":{"description":"ETag unchanged"},"400":{"description":"Invalid parameters"},"503":{"description":"No successful upstream snapshot"}},"description":"Without numeric parameters, explains the active v3 default. All four numeric parameters together request the legacy soft-cost comparison, never change the active policy."}},"/v1/plan-coverage":{"get":{"summary":"Evidence-bound exact plan, model version and channel coverage","parameters":[{"name":"plan","in":"query","description":"Exact plan ID; legacy aliases resolve to versioned IDs","schema":{"type":"string"}},{"name":"provider","in":"query","description":"Registered provider, including multi for cross-provider records.","schema":{"type":"string","enum":["openai","claude","zhipu","zai","multi","grok","kimi","minimax","alibaba","volcengine","opencode"]}},{"name":"model","in":"query","description":"Exact chart model ID; unknown aliases remain unknown","schema":{"type":"string"}},{"name":"effort","in":"query","description":"Native effort; requires model and may remain unverified","schema":{"type":"string"}}],"responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"304":{"description":"ETag unchanged"},"400":{"description":"Invalid parameters"},"503":{"description":"No successful upstream snapshot"}}}},"/v1/opportunities":{"get":{"summary":"Current and next-72-hour reviewed public windows, with personal eligibility unknown","parameters":[{"name":"provider","in":"query","description":"Registered calendar provider; glm combines reviewed BigModel/Z.ai scope.","schema":{"type":"string","enum":["openai","claude","zhipu","zai","grok","kimi","minimax","alibaba","volcengine","opencode","glm"]}},{"name":"tz","in":"query","description":"IANA browser timezone","schema":{"type":"string"}},{"name":"lang","in":"query","description":"zh or en","schema":{"type":"string"}}],"responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"304":{"description":"ETag unchanged"},"400":{"description":"Invalid parameters"},"503":{"description":"No successful upstream snapshot"}}}},"/v1/explore":{"get":{"summary":"One read-only model focus scope across exact plan coverage and public events","parameters":[{"name":"models","in":"query","description":"Comma-separated exact model-version IDs; explicit empty is allowed","required":true,"schema":{"type":"string"}},{"name":"plans","in":"query","description":"Up to four exact plan IDs limiting the browse scope","required":false,"schema":{"type":"string"}},{"name":"efforts","in":"query","description":"Comma-separated modelId:effort pairs; selected native efforts remain separate from plan access","required":false,"schema":{"type":"string"}},{"name":"tz","in":"query","description":"IANA display timezone","required":false,"schema":{"type":"string"}},{"name":"lang","in":"query","description":"zh or en","required":false,"schema":{"type":"string"}},{"name":"from","in":"query","description":"Inclusive YYYY-MM-DD start of an optional <=8-day calendar range","required":false,"schema":{"type":"string"}},{"name":"to","in":"query","description":"Exclusive YYYY-MM-DD end of the optional range","required":false,"schema":{"type":"string"}},{"name":"edition","in":"query","description":"Optional, explicit plan-edition display scope; omission preserves the prior full public scope. An exact plan selection wins over this preference.","schema":{"type":"string","enum":["cn-first","international-first","all"]}}],"responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"304":{"description":"ETag unchanged"},"400":{"description":"Invalid parameters"},"503":{"description":"No successful upstream snapshot"}},"description":"Public event and edition filters are resolved from the same reviewed plan scope; local browser preferences are never inferred server-side."}},"/v1/model-updates":{"get":{"summary":"Deterministic model refresh, roster and discovery status","responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"304":{"description":"ETag unchanged"},"400":{"description":"Invalid parameters"},"503":{"description":"No successful upstream snapshot"}},"description":"Read-only status, source summaries and pending identity review. Does not fetch upstreams on demand or run paid inference."}},"/v1/index":{"get":{"summary":"Frozen experimental Index from current evidence","parameters":[{"name":"model","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"304":{"description":"ETag unchanged"},"400":{"description":"Invalid parameters"},"503":{"description":"No successful upstream snapshot"}},"description":"Separate overall panels and per-model effort candidate. Missing required sources leave total score null. Publication carries calculation dependencies and freshness; current chart recommendation remains AA-only v4."}},"/v1/index-metrics":{"get":{"summary":"Experimental ModelPlans Index v0.3: normalized capability, expense and task-time references","parameters":[{"name":"model","in":"query","schema":{"type":"string","maxLength":96},"description":"Reviewed model version ID, e.g. sol-6.1"}],"responses":{"200":{"description":"Evidence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"304":{"description":"ETag unchanged"},"400":{"description":"Invalid parameters"},"503":{"description":"No successful upstream snapshot"}},"description":"Own normalized metrics with independent completeness, source/protocol/windows, additive shared-source effort gains and compatible expense/time ratios. Current v4 recommendations are separate; no inference, account or subscription writes. Configurations additionally publish expenseUsdPerTask and expenseUsdEvidence (ReferenceExpenseUsdFields); expenseUsdReference declares the shared frozen AA Coding Agent v1.5 basis. expenseMultiplier remains unitless for ranking/compatibility. Cross-model clients display $ / reference task; × is only relative to this model’s recommended effort. Multisource rebasing is explicitly estimated; unknown conversion is null with reason."}},"/api/visualization/index-models":{"get":{"summary":"Versioned website chart projection for Index v0.3","parameters":[{"name":"include","in":"query","schema":{"type":"string","maxLength":6000}}],"responses":{"200":{"description":"Dataset with mode=index, metricVersion=0.3, primaryTimeMetric=task_reference_multiplier; capability and cost aliases are Index points and expense multipliers, NOT raw AA points or USD. Each effort includes task seconds, boundary, evidence and completeness."},"400":{"description":"Invalid parameters"},"503":{"description":"No successful AA identity snapshot"}}}},"/publications/current.json":{"get":{"summary":"Current complete public publication pointer","parameters":[],"responses":{"200":{"description":"Validated public JSON","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicationPointer"}}}},"304":{"description":"ETag unchanged"},"405":{"description":"Read-only resource"},"503":{"description":"Public publication unavailable"}}}},"/publications/releases/{publicationId}/manifest.json":{"get":{"summary":"Immutable publication manifest","parameters":[{"name":"publicationId","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{24}$"}}],"responses":{"200":{"description":"Validated public JSON","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicationManifest"}}}},"304":{"description":"ETag unchanged"},"404":{"description":"Public object not found"},"405":{"description":"Read-only resource"}}}},"/publications/objects/{hash}.json":{"get":{"summary":"Immutable content-addressed public component","parameters":[{"name":"hash","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{64}$"}}],"responses":{"200":{"description":"Validated public JSON","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicComponent"}}}},"304":{"description":"ETag unchanged"},"404":{"description":"Public object not found"},"405":{"description":"Read-only resource"}}}},"/v1/publication":{"get":{"summary":"Validated current public publication metadata","parameters":[],"responses":{"200":{"description":"Validated public JSON","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"304":{"description":"ETag unchanged"},"405":{"description":"Read-only resource"},"503":{"description":"Public publication unavailable"}}}},"/v1/registry":{"get":{"summary":"Reviewed model registry and default selection policy","parameters":[],"responses":{"200":{"description":"Validated public JSON","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"304":{"description":"ETag unchanged"},"405":{"description":"Read-only resource"},"503":{"description":"Public publication unavailable"}}}},"/v1/plan-knowledge":{"get":{"summary":"Complete third-party subscription and metered API knowledge catalogue","description":"One immutable publication generation. All adopted observations, source identities, upstream prices, economic scenarios, evidence, assumptions, reconciliation and change candidates. This does not confirm official entitlements, model coverage, personal balances or metrics. data is null for an older publication with no knowledge component. Unknown query parameters are rejected.","parameters":[],"responses":{"200":{"description":"Publication envelope containing PlanKnowledge or null","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Envelope"},{"type":"object","properties":{"data":{"anyOf":[{"$ref":"#/components/schemas/PlanKnowledge"},{"type":"null"}]}}}]}}}},"400":{"description":"Unsupported query parameters"},"503":{"description":"No complete publication available"}}}},"/v1/plan-value":{"get":{"summary":"Frozen plan evidence and opt-in uncalibrated workload value scenarios","parameters":[{"in":"query","name":"plan","required":false,"schema":{"type":"string"}},{"in":"query","name":"model","required":false,"schema":{"type":"string"}},{"in":"query","name":"effort","required":false,"schema":{"type":"string"}},{"in":"query","name":"client","required":false,"schema":{"type":"string"}},{"in":"query","name":"usage","required":false,"schema":{"type":"string","enum":["light","everyday","heavy"]}},{"in":"query","name":"mode","required":false,"schema":{"type":"string","enum":["evidence","scenario"]}},{"in":"query","name":"edition","required":false,"schema":{"type":"string","enum":["cn-first","international-first","all"]}},{"in":"query","name":"sort","required":false,"schema":{"type":"string","enum":["value","reach","price"]}},{"in":"query","name":"offset","required":false,"schema":{"type":"integer","minimum":0,"default":0}},{"in":"query","name":"limit","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"view","in":"query","required":false,"schema":{"type":"string","enum":["tiers","offerings"]}},{"name":"scope","in":"query","required":false,"schema":{"type":"string","enum":["personal","team"],"default":"personal"},"description":"Default comparison uses personal monthly variants; explicit team scope compares one monthly team variant per tier."}],"responses":{"200":{"description":"Versioned evidence or scenario results with uncertainty, sources, allocation and missing-data reasons"},"400":{"description":"Invalid or unsupported query"},"503":{"description":"Complete publication or plan-value component unavailable"}},"description":"Default results compare one personal monthly price-market variant per tier. view=offerings or an explicit plan returns exact variants; non-headline variants do not receive tier ranking/frontier slots. Mathematical value scores and underlying workload assumptions are unchanged."}},"/v1/client":{"get":{"summary":"Small publication-bound client digest with one display value per concept and reviewed exact harness IDs.","responses":{"200":{"description":"Frozen public projection in the existing publication envelope"},"503":{"description":"The pinned snapshot has no client component"}}}},"/v1/lineups":{"get":{"summary":"Precomputed same-maker recommended-effort lineup-v1 verdicts; cost uses USD per reference task.","responses":{"200":{"description":"Frozen public projection in the existing publication envelope"},"503":{"description":"The pinned snapshot has no client component"}}}},"/v1/plan-groups":{"get":{"summary":"Reviewed product lines and tiers with exact offering variants; grouping never combines quota pools","parameters":[{"name":"provider","in":"query","required":false,"schema":{"type":"string","maxLength":100}},{"name":"scope","in":"query","required":false,"schema":{"type":"string","enum":["personal","team"]}},{"name":"market","in":"query","required":false,"schema":{"type":"string","enum":["cn-first","international-first","all"]}},{"name":"billing","in":"query","required":false,"schema":{"type":"string","enum":["month","quarter","year"]}},{"name":"history","in":"query","required":false,"schema":{"type":"string","enum":["0","1"]}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}}],"responses":{"200":{"description":"One published snapshot; provider/product/tier/variant/history counts and exact selected IDs"},"400":{"description":"Invalid or unsupported query"},"503":{"description":"Complete required publication components unavailable"}}}}},"components":{"schemas":{"Envelope":{"type":"object","properties":{"schemaVersion":{"type":"integer"},"snapshotId":{"type":["string","null"]},"asOf":{"type":["string","null"]},"data":{},"freshness":{"type":"object"},"sourceSnapshots":{"type":"object"},"releaseVersion":{"type":["string","null"],"pattern":"^\\d+\\.\\d+\\.\\d+$","description":"Unified ModelPlans release that produced this immutable data publication. Null or absent for legacy snapshots; not the currently installed reader version. Historical implementation identifiers are compatibility/provenance only."}},"required":["schemaVersion","data"]},"Error":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]},"PublicationPointer":{"type":"object","required":["schemaVersion","publicationId","manifestHash"],"properties":{"schemaVersion":{"const":1},"publicationId":{"type":"string","pattern":"^[0-9a-f]{24}$"},"manifestHash":{"type":"string","pattern":"^[0-9a-f]{64}$"}}},"PublicationComponentReference":{"type":"object","required":["schemaVersion","hash","bytes"],"properties":{"schemaVersion":{"const":1},"hash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"bytes":{"type":"integer","minimum":2,"maximum":50000000}}},"PublicationManifest":{"type":"object","required":["schemaVersion","publicationId","publishedAt","comparisonVersion","methods","components"],"properties":{"schemaVersion":{"const":1},"publicationId":{"type":"string","pattern":"^[0-9a-f]{24}$"},"publishedAt":{"type":"string","format":"date-time"},"comparisonVersion":{"type":"string"},"methods":{"type":"object","properties":{"index":{"const":"unified-v03-estimator-0.1.0-internal"},"recommendation":{"const":"balanced-coding-absolute-v4"}}},"components":{"type":"object","required":["methods","registry","models","plans","rules","news","calendar"],"properties":{"methods":{"$ref":"#/components/schemas/PublicationComponentReference"},"registry":{"$ref":"#/components/schemas/PublicationComponentReference"},"models":{"$ref":"#/components/schemas/PublicationComponentReference"},"plans":{"$ref":"#/components/schemas/PublicationComponentReference"},"rules":{"$ref":"#/components/schemas/PublicationComponentReference"},"news":{"$ref":"#/components/schemas/PublicationComponentReference"},"calendar":{"$ref":"#/components/schemas/PublicationComponentReference"}},"additionalProperties":false}}},"PublicComponent":{"type":"object","required":["schemaVersion","kind","dependencies","evidence","data"],"properties":{"schemaVersion":{"const":1},"kind":{"type":"string","enum":["methods","registry","models","plans","rules","news","calendar"]},"dependencies":{"type":"object","additionalProperties":{"type":"string","pattern":"^[0-9a-f]{64}$"}},"evidence":{"type":"array","items":{"type":"object"}},"data":{"type":"object"}},"description":"Explicit public DTO projection. Clients must verify exact bytes, hash, component-specific schema and cross-component dependencies before switching the whole publication. Full component validation contract: shared/public-publication.ts."},"PlanKnowledge":{"type":"object","properties":{"schemaVersion":{"type":"number","const":1},"revision":{"type":"string","minLength":1,"maxLength":4000},"source":{"type":"object","properties":{"id":{"type":"string","const":"real-api-pricing"},"name":{"type":"string","const":"Real API Pricing"},"url":{"type":"string","format":"uri"},"commit":{"type":"string","pattern":"^[a-f0-9]{40}$"},"adoptedHash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"conventionsHash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"capturedAt":{"type":"string","minLength":1,"maxLength":4000},"mappingRevision":{"type":"string","minLength":1,"maxLength":4000},"parserVersion":{"type":"number","const":1},"attribution":{"type":"string","minLength":1,"maxLength":4000}},"required":["id","name","url","commit","adoptedHash","conventionsHash","capturedAt","mappingRevision","parserVersion","attribution"],"additionalProperties":false},"assumptions":{"type":"object","properties":{"formula":{"type":"string","minLength":1,"maxLength":4000},"tokenPolicy":{"type":"string","minLength":1,"maxLength":4000},"unmeteredPolicy":{"type":"string","minLength":1,"maxLength":4000},"calculationVersion":{"type":"string","minLength":1,"maxLength":4000},"monthWeeks":{"type":"number","minimum":0},"exchangeRate":{"type":"object","properties":{"value":{"type":"number","minimum":0},"units":{"type":"string","const":"CNY per USD"},"date":{"type":"string","minLength":1,"maxLength":4000},"sourceUrl":{"type":"string","format":"uri"}},"required":["value","units","date","sourceUrl"],"additionalProperties":false},"capacityMeaning":{"type":"string","const":"scenario-estimate-at-saturated-usage"},"confidenceMeaning":{"type":"string","const":"upstream-evidence-grade-not-probability"}},"required":["formula","tokenPolicy","unmeteredPolicy","calculationVersion","monthWeeks","exchangeRate","capacityMeaning","confidenceMeaning"],"additionalProperties":false},"products":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[\\w:.-]{1,160}$"},"name":{"type":"string","minLength":1,"maxLength":4000},"vendor":{"type":"string","minLength":1,"maxLength":4000},"category":{"type":"string","enum":["direct","tool","aggregator","api","unknown"]}},"required":["id","name","vendor","category"],"additionalProperties":false}},"entries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[\\w:.-]{1,160}$"},"upstreamPlanId":{"type":"string","pattern":"^[\\w:.-]{1,160}$"},"productId":{"type":"string","pattern":"^[\\w:.-]{1,160}$"},"tierGroupId":{"type":"string","pattern":"^[\\w:.-]{1,160}$"},"name":{"type":"string","minLength":1,"maxLength":4000},"nameEn":{"type":"string","maxLength":4000},"upstreamNames":{"type":"array","items":{"type":"string","minLength":1,"maxLength":4000}},"billing":{"type":"string","enum":["subscription","metered"]},"scenario":{"type":"string","maxLength":4000},"region":{"type":"string","enum":["cn","international","us","unknown"]},"generation":{"type":"string","maxLength":100},"formalPlanId":{"anyOf":[{"type":"string","pattern":"^[\\w:.-]{1,160}$"},{"type":"null"}]},"mappingStatus":{"type":"string","enum":["unmapped","linked"]}},"required":["id","upstreamPlanId","productId","tierGroupId","name","nameEn","upstreamNames","billing","scenario","region","generation","formalPlanId","mappingStatus"],"additionalProperties":false}},"observations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[\\w:.-]{1,160}$"},"entryId":{"type":"string","pattern":"^[\\w:.-]{1,160}$"},"upstreamModel":{"type":"string","minLength":1,"maxLength":4000},"formalModelId":{"anyOf":[{"type":"string","pattern":"^[\\w:.-]{1,160}$"},{"type":"null"}]},"upstreamGeneration":{"type":"string","maxLength":100},"price":{"type":"object","properties":{"amount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"currency":{"type":"string","maxLength":10},"period":{"type":"string","enum":["month","year","usage","unknown"]},"upstreamAmount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"monthlyEquivalent":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"comparisonMonthlyUsd":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"status":{"type":"string","const":"upstream-observation"}},"required":["amount","currency","period","upstreamAmount","monthlyEquivalent","comparisonMonthlyUsd","status"],"additionalProperties":false},"economics":{"type":"object","properties":{"monthlyTokens":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"effectiveUsdPerMillionTokens":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"upstreamEffectiveUsdPerMillionTokens":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"unmeteredPromotion":{"type":"boolean"},"promotionUntil":{"type":["string","null"]},"sharedPool":{"type":"string","enum":["shared","unknown","not-applicable"]},"additiveCapacity":{"type":"boolean","const":false},"comparisonEligible":{"type":"boolean"},"diagnostics":{"type":"array","items":{"type":"string","minLength":1,"maxLength":4000}}},"required":["monthlyTokens","effectiveUsdPerMillionTokens","upstreamEffectiveUsdPerMillionTokens","unmeteredPromotion","promotionUntil","sharedPool","additiveCapacity","comparisonEligible","diagnostics"],"additionalProperties":false},"workload":{"type":"object","properties":{"kind":{"type":"string","enum":["standard","lowCache","anthropic","measured","unknown"]},"cache":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"input":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"output":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"cacheWrite":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"monthWeeks":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"saturatedUsage":{"type":"boolean","const":true},"contextAndEffort":{"type":"string","const":"source-specific-or-unknown"}},"required":["kind","cache","input","output","cacheWrite","monthWeeks","saturatedUsage","contextAndEffort"],"additionalProperties":false},"sample":{"type":"object","properties":{"label":{"type":"string","maxLength":4000},"kind":{"type":"string","maxLength":100},"precision":{"type":"string","enum":["day","month","range","unknown"]},"derivedFrom":{"type":"string","maxLength":4000}},"required":["label","kind","precision","derivedFrom"],"additionalProperties":false},"confidence":{"type":"string","enum":["high","medium","low","unknown"]},"evidence":{"type":"object","properties":{"sourceLabel":{"type":"string","maxLength":4000},"sourceUrl":{"type":"string","format":"uri"},"links":{"type":"array","items":{"type":"string","format":"uri"}},"note":{"type":"string","maxLength":4000},"observedAt":{"type":"string","minLength":1,"maxLength":4000},"recordHash":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["sourceLabel","sourceUrl","links","note","observedAt","recordHash"],"additionalProperties":false}},"required":["id","entryId","upstreamModel","formalModelId","upstreamGeneration","price","economics","workload","sample","confidence","evidence"],"additionalProperties":false}},"changes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[\\w:.-]{1,160}$"},"kind":{"type":"string","enum":["added","updated","withdrawn","assumptions-review"]},"observationId":{"anyOf":[{"type":"string","pattern":"^[\\w:.-]{1,160}$"},{"type":"null"}]},"beforeHash":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"},{"type":"null"}]},"afterHash":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"},{"type":"null"}]},"sourceCommit":{"type":"string","pattern":"^[a-f0-9]{40}$"},"observedAt":{"type":"string","minLength":1,"maxLength":4000},"status":{"type":"string","enum":["published-observation","review-required"]}},"required":["id","kind","observationId","beforeHash","afterHash","sourceCommit","observedAt","status"],"additionalProperties":false}},"reconciliation":{"type":"object","properties":{"sourceRows":{"type":"integer","minimum":0,"maximum":9007199254740991},"subscriptionRows":{"type":"integer","minimum":0,"maximum":9007199254740991},"apiRows":{"type":"integer","minimum":0,"maximum":9007199254740991},"subscriptionKeys":{"type":"integer","minimum":0,"maximum":9007199254740991},"apiKeys":{"type":"integer","minimum":0,"maximum":9007199254740991},"unmappedEntries":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["sourceRows","subscriptionRows","apiRows","subscriptionKeys","apiKeys","unmappedEntries"],"additionalProperties":false},"calendarLeads":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[\\w:.-]{1,160}$"},"entryId":{"type":"string","pattern":"^[\\w:.-]{1,160}$"},"status":{"type":"string","enum":["UNVERIFIED"]},"formalPlanId":{"type":"string","nullable":true,"enum":[null]},"formalModelId":{"type":"string","nullable":true,"enum":[null]},"personalQualification":{"type":"string","enum":["unknown"]},"requiresOfficialReview":{"type":"boolean","enum":[true]},"observationIds":{"minItems":1,"type":"array","items":{"type":"string","pattern":"^[\\w:.-]{1,160}$"}},"sourceCommit":{"type":"string","pattern":"^[a-f0-9]{40}$"},"sourceHash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"evidence":{"minItems":1,"type":"array","items":{"type":"object","properties":{"observationId":{"type":"string","pattern":"^[\\w:.-]{1,160}$"},"recordHash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"sourceUrl":{"type":"string","format":"uri"},"originalText":{"type":"string","minLength":1,"maxLength":4000},"observedAt":{"type":"string","minLength":1,"maxLength":4000}},"required":["observationId","recordHash","sourceUrl","originalText","observedAt"],"additionalProperties":false}},"proposed":{"type":"object","properties":{"kind":{"type":"string","enum":["recurring-window","time-dependent-pricing","limited-promotion"]},"timezone":{"nullable":true,"type":"string","maxLength":100},"windows":{"type":"array","items":{"type":"object","properties":{"start":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"},"weekdays":{"maxItems":7,"type":"array","items":{"type":"integer","minimum":1,"maximum":7}}},"required":["start","end","weekdays"],"additionalProperties":false}},"coefficient":{"nullable":true,"type":"object","properties":{"value":{"type":"number","minimum":0,"exclusiveMinimum":true},"meaning":{"type":"string","enum":["deduction-multiplier","price-multiplier","capacity-multiplier"]}},"required":["value","meaning"],"additionalProperties":false},"validUntil":{"nullable":true,"type":"string","minLength":1,"maxLength":4000},"conditions":{"type":"array","items":{"type":"string","minLength":1,"maxLength":4000}}},"required":["kind","timezone","windows","coefficient","validUntil","conditions"],"additionalProperties":false}},"required":["id","entryId","status","formalPlanId","formalModelId","personalQualification","requiresOfficialReview","observationIds","sourceCommit","sourceHash","evidence","proposed"],"additionalProperties":false}}},"required":["schemaVersion","revision","source","assumptions","products","entries","observations","changes","reconciliation"],"additionalProperties":false},"ExpenseUsdEvidence":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"policyId":{"type":"string","const":"reference-task-usd-v1"},"basis":{"type":"string","const":"api-list-price"},"priceBasisScope":{"type":"string","const":"reference-anchor"},"status":{"type":"string","enum":["converted","estimated","unavailable"]},"conversion":{"anyOf":[{"type":"string","enum":["same-source-denormalization","index-reference-rebase"]},{"type":"null"}]},"reason":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"referenceWorkload":{"type":"object","properties":{"id":{"type":"string","const":"aa-agent-v1.5-api-reference-task-2026-09-30"},"sourceId":{"type":"string","const":"aa-agent"},"sourceUrl":{"type":"string","format":"uri"},"protocolVersion":{"type":"string","const":"1.5"},"currency":{"type":"string","const":"USD"},"referenceCostUsd":{"type":"number","const":4.463527946409263},"frozenAt":{"type":"string","const":"2026-09-30T14:28:16.806908+00:00"},"statistic":{"type":"string","minLength":1},"referenceModels":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"referenceMakers":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"taskDefinition":{"type":"string","minLength":1},"datasets":{"minItems":3,"maxItems":3,"type":"array","items":{"type":"string","minLength":1}},"pricingDefinition":{"type":"string","minLength":1},"limitation":{"type":"string","minLength":1}},"required":["id","sourceId","sourceUrl","protocolVersion","currency","referenceCostUsd","frozenAt","statistic","referenceModels","referenceMakers","taskDefinition","datasets","pricingDefinition","limitation"],"additionalProperties":false},"observedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"observedAtMeaning":{"type":"string","const":"oldest-contributing-cost-evidence-window"},"sources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"cohort":{"type":"string","minLength":1},"observedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"windowBasis":{"type":"string","enum":["source-evidence-window","input-capture"]}},"required":["id","url","cohort","observedAt","windowBasis"],"additionalProperties":false}},"measured":{"type":"boolean","const":false},"empiricalWorkloadCalibration":{"type":"boolean","const":false},"isSubscriptionConsumption":{"type":"boolean","const":false},"isRealBill":{"type":"boolean","const":false}},"required":["policyId","basis","priceBasisScope","status","conversion","reason","referenceWorkload","observedAt","observedAtMeaning","sources","measured","empiricalWorkloadCalibration","isSubscriptionConsumption","isRealBill"],"additionalProperties":false},"ReferenceExpenseUsdFields":{"type":"object","description":"Additive fields on each Index configuration and visualization effort. Equivalent API-tariff dollars for the declared frozen coding reference workload, not a measured real bill or subscription quota.","properties":{"expenseUsdPerTask":{"type":["number","null"],"minimum":0,"description":"expenseMultiplier multiplied by the shared positive frozen referenceCostUsd. Null requires unavailable evidence with reason."},"expenseUsdEvidence":{"$ref":"#/components/schemas/ExpenseUsdEvidence"}}}}}}