@coool/opencode-adaptive 0.0.0-stage → 1.0.0

package/dist/execution/retry/types.d.ts

@@ -0,0 +1,66 @@
+import type { ModelRef } from "../../core/work-unit/types.js";
+import type { FailureClassification } from "../../health/classifier/types.js";
+/**
+ * Mirror of the host retry-hook decision shape (`SessionRetryDecision` from
+ * `@opencode/plugin`). The execution core never imports the plugin package —
+ * the adapter passes `hook.decision` straight through; the shapes are
+ * structurally identical.
+ */
+export type NativeRetryDecision = {
+    retry: false;
+} | {
+    retry: true;
+    delay: number;
+};
+/**
+ * Horizontal-recovery option computed by the wiring for the failing work
+ * unit, from the same tier (ADP-013). `none` means no healthy alternative
+ * exists right now — OpenCode's native retry of the same resource is then
+ * the preferred recovery. `switch` carries the candidate chosen by the
+ * scheduler over the remaining tier candidates; `probeId` is present when
+ * that candidate was admitted as a circuit-breaker probe.
+ */
+export type RecoveryOption = {
+    kind: "none";
+} | {
+    kind: "switch";
+    model: ModelRef;
+    probeId?: string | undefined;
+};
+export interface RetryInput {
+    /** Classification of the failure that triggered the retry hook. */
+    readonly classification: FailureClassification;
+    /** The resource whose execution just failed. */
+    readonly failingModel: ModelRef;
+    /** The host's own retry decision; left untouched unless we veto. */
+    readonly native: NativeRetryDecision;
+    readonly recovery: RecoveryOption;
+    /** Vetoes already issued for this work unit (per-unit budget). */
+    readonly vetoesUsed: number;
+}
+/**
+ * Per-work-unit budget on owned-recovery vetoes. Each veto switches to one
+ * alternative; health state already blocks repeats, but the explicit budget
+ * makes loop boundedness trivially provable (ADP-038). After exhaustion the
+ * policy leaves OpenCode's native retry — its built-in max attempts are the
+ * hard limit — and future units re-route fresh at safe boundaries.
+ */
+export declare const MAX_VETOES_PER_UNIT = 4;
+/**
+ * Core decision, mode-independent. `veto` takes ownership of recovery
+ * (`{retry: false}` in the hook + a native continuation by switching to the
+ * recovered candidate); `leave` keeps the host's own `decision` untouched.
+ */
+export type RetryCoreDecision = {
+    kind: "veto";
+    model: ModelRef;
+    probeId?: string | undefined;
+} | {
+    kind: "leave";
+};
+/** Mode-wrapped decision. Observe records `would` without intervening. */
+export type RetryDecision = RetryCoreDecision | {
+    kind: "observe-only";
+    would: RetryCoreDecision;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/execution/retry/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/execution/retry/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAA;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAA;AAE7E;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEnF;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GACxB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA;AAEtF,MAAM,WAAW,UAAU;IACzB,mEAAmE;IACnE,QAAQ,CAAC,cAAc,EAAE,qBAAqB,CAAA;IAC9C,gDAAgD;IAChD,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAA;IAC/B,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAA;IACpC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAA;IACjC,kEAAkE;IAClE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAA;AAEpC;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAC3B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAA;AAErF,0EAA0E;AAC1E,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,CAAA"}

package/dist/execution/retry/types.js

@@ -0,0 +1,9 @@
+/**
+ * Per-work-unit budget on owned-recovery vetoes. Each veto switches to one
+ * alternative; health state already blocks repeats, but the explicit budget
+ * makes loop boundedness trivially provable (ADP-038). After exhaustion the
+ * policy leaves OpenCode's native retry — its built-in max attempts are the
+ * hard limit — and future units re-route fresh at safe boundaries.
+ */
+export const MAX_VETOES_PER_UNIT = 4;
+//# sourceMappingURL=types.js.map

package/dist/execution/retry/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/execution/retry/types.ts"],"names":[],"mappings":"AAkCA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAA"}

package/dist/gui-experimental.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const n=require("solid-js/web"),_=require("@opencode/plugin/gui"),u=require("solid-js"),O=require("@opencode/schema/rpc"),q="coool.adaptive",C="coool.adaptive";function a(e,t){return{"~standard":{version:1,vendor:C,validate:i=>e(i)?{value:i}:{issues:[{message:t}]}}}}function w(){return{"~standard":{version:1,vendor:C,validate:e=>e===void 0?{value:void 0}:{issues:[{message:"unexpected input: no input expected"}]}}}}const r=e=>typeof e=="object"&&e!==null&&!Array.isArray(e),v=e=>typeof e=="string",m=e=>r(e)&&v(e.sessionID),M=e=>r(e)&&v(e.sessionID)&&(e.mode===null||v(e.mode)),L=e=>r(e)&&v(e.sessionID)&&(e.tier===null||v(e.tier)),N=O.Rpc.define({id:q,methods:{"settings.get":{input:w(),output:a(r,"output must be an object")},"settings.set":{input:a(r,"input must be an object"),output:a(r,"output must be an object")},"status.get":{input:w(),output:a(r,"output must be an object")},"receipts.list":{input:w(),output:a(Array.isArray,"output must be an array")},"session-mode.get":{input:a(m,"input must be an object with a sessionID string"),output:a(r,"output must be an object")},"session-mode.set":{input:a(M,"input must be an object with a sessionID string and a mode string or null"),output:a(r,"output must be an object")},"tier-request.get":{input:a(m,"input must be an object with a sessionID string"),output:a(r,"output must be an object")},"tier-request.set":{input:a(L,"input must be an object with a sessionID string and a tier string or null"),output:a(r,"output must be an object")}},events:{"settings-changed":{schema:a(r,"event data must be an object")},"session-mode-changed":{schema:a(m,"event data must be an object with a sessionID string")},"tier-request-changed":{schema:a(m,"event data must be an object with a sessionID string")}}}),I=["off","observe","active"],V=["quick","standard","advanced"];function F(e){const t=e.rpc(N);return{status:()=>t["status.get"]().catch(()=>{}),receipts:()=>t["receipts.list"]().catch(()=>{}),update:async i=>{try{return(await t["settings.set"](i)).ok}catch{return!1}},watchSettings:i=>t.events.on("settings-changed",()=>{i()})}}function h(e){const t=`${e.providerID}/${e.id}`;return e.variant===void 0?t:`${t}@${e.variant}`}function G(e){if(e===void 0)return"";const t=[];return e.health!=="healthy"&&t.push(e.health),e.breaker==="open"?t.push("breaker-open"):e.breaker==="half_open"&&t.push("half-open"),e.windowed&&t.push("windowed"),t.length===0?"":` [${t.join(", ")}]`}function j(e){switch(e.kind){case"apply":{const t=e.tier===void 0?"":` [${e.tier}]`;return`apply ${h(e.model)}${t} (${e.reason})`}case"defer":{const t=e.detail===void 0?"":` — ${e.detail}`;return`defer: ${e.reason}${t}`}case"park":{const t=e.detail===void 0?"":` — ${e.detail}`;return`park: ${e.reason}${t}`}case"escalate":return`escalate ${e.step} → ${h(e.target)} [${e.tier}]`;case"observe-only":return`observe: ${j(e.would)}`}}function W(e){return e===void 0?"pending":e.status==="succeeded"?"succeeded":e.status==="failed"?`failed (${e.category})`:`interrupted (${e.reason})`}function x(e){return`#${String(e.id)} ${j(e.decision)} — ${W(e.outcome)}`}const z="connection";function J(e){if(e===void 0)return[{id:z,label:"Server",value:"disconnected",tone:"warning"}];const t=[{id:"mode",label:"Mode",value:e.mode},{id:"pin",label:"Pin",value:e.pin===null?"none":h(e.pin)}];for(const i of V){const l=e.tiers[i],f=l.length===0?"empty":l.map(g=>`${h(g.ref)}${G(g)}`).join(", ");t.push({id:`tier-${i}`,label:`Tier ${i}`,value:f})}return t.push({id:"parked",label:"Parked",value:String(e.parked)}),t.push({id:"receipts",label:"Receipts",value:String(e.receipts)}),t}function B(e){return I.map(t=>({value:t,title:t===e?`${t} (current)`:t}))}function H(e){return I.find(t=>t===e)}function K(e){return e.map(t=>x(t))}var Q=n.template("<span class=adaptive-saved role=status>Saved"),U=n.template("<div class=adaptive-receipts>"),X=n.template('<div class=adaptive-page><table class=adaptive-status aria-label="OpenCode Adaptive status"><tbody></tbody></table><label class=adaptive-mode><span class=adaptive-row-label>Mode</span><select class=adaptive-mode-select>'),Y=n.template("<tr class=adaptive-row><td class=adaptive-row-label></td><td class=adaptive-row-value>"),Z=n.template("<option>"),ee=n.template("<div class=adaptive-receipt-line>");const te=5;function y(e){const[t,i]=u.createSignal(void 0),[l,f]=u.createSignal("observe"),[g,D]=u.createSignal([]),[A,R]=u.createSignal(!1),$=()=>{e.api.status().then(s=>{i(s),s!==void 0&&f(s.mode)}),e.api.receipts().then(s=>{D(s??[])})};u.onCleanup(e.api.watchSettings($)),$();const E=s=>{const c=H(s);c!==void 0&&e.api.update({mode:c}).then(S=>{R(S),$()})};return(()=>{var s=X(),c=s.firstChild,S=c.firstChild,P=c.nextSibling,k=P.firstChild,b=k.nextSibling;return n.insert(S,n.createComponent(u.For,{get each(){return J(t())},children:o=>(()=>{var d=Y(),p=d.firstChild,T=p.nextSibling;return n.insert(p,()=>o.label),n.insert(T,()=>o.value),n.effect(()=>n.setAttribute(d,"data-tone",o.tone)),d})()})),b.addEventListener("change",o=>{E(o.currentTarget.value)}),n.insert(b,n.createComponent(u.For,{get each(){return B(l())},children:o=>(()=>{var d=Z();return n.insert(d,()=>o.title),n.effect(()=>d.value=o.value),d})()})),n.insert(s,n.createComponent(u.Show,{get when(){return A()},get children(){return Q()}}),null),n.insert(s,n.createComponent(u.Show,{get when(){return t()!==void 0},get children(){var o=U();return n.insert(o,n.createComponent(u.For,{get each(){return K(g()).slice(0,te)},children:d=>(()=>{var p=ee();return n.insert(p,d),p})()})),o}}),null),n.effect(()=>b.disabled=t()===void 0),n.effect(()=>b.value=l()),s})()}const ne=_.Plugin.define({setup(e){const t=F(e.client);e.add(_.SettingsPage,{id:"adaptive",title:"OpenCode Adaptive",entries:[{id:"adaptive",title:"OpenCode Adaptive",description:"Execution tier routing, operating mode and resource health"}],render:()=>n.createComponent(y,{api:t})}),e.add(_.Command,{id:"open",title:"OpenCode Adaptive",group:"Adaptive",run:()=>{e.layout.settings("adaptive")}})}});exports.AdaptiveStatusPage=y;exports.default=ne;

package/dist/gui.d.ts

@@ -0,0 +1,17 @@
+import { Plugin } from "@opencode/plugin/gui";
+import type { JSX } from "solid-js";
+import { type GuiApi } from "./ui/gui/api.js";
+/**
+ * Native GUI settings page body (ADP-034). All data comes from the typed RPC adapter; the component holds no
+ * local settings state. A failed read renders the disconnected row instead of stale data.
+ */
+export declare function AdaptiveStatusPage(props: {
+    api: GuiApi;
+}): JSX.Element;
+/**
+ * GUI plugin entry (the `./gui-experimental` bundle default export). Thin adapter: registers a native
+ * SettingsPage and a palette command that opens it; no routing logic lives here (ADP-034/035).
+ */
+declare const _default: Plugin.Definition<{}>;
+export default _default;
+//# sourceMappingURL=gui.d.ts.map

package/dist/gui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gui.d.ts","sourceRoot":"","sources":["../src/gui.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAW,MAAM,EAA8B,MAAM,sBAAsB,CAAA;AAElF,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAKnC,OAAO,EAAkB,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAK7D;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,GAAG,CAAC,OAAO,CAuEtE;AAED;;;GAGG;;AACH,wBAwBE"}

package/dist/gui.js

@@ -0,0 +1,70 @@
+import { jsx as _jsx, jsxs as _jsxs } from "solid-js/jsx-runtime";
+import { Command, Plugin, SettingsPage } from "@opencode/plugin/gui";
+import { For, Show, createSignal, onCleanup } from "solid-js";
+import { adaptiveGuiApi } from "./ui/gui/api.js";
+import { modeChoices, parseModeValue, receiptLines, statusRows } from "./ui/gui/view.js";
+const RECEIPTS_PREVIEW_LIMIT = 5;
+/**
+ * Native GUI settings page body (ADP-034). All data comes from the typed RPC adapter; the component holds no
+ * local settings state. A failed read renders the disconnected row instead of stale data.
+ */
+export function AdaptiveStatusPage(props) {
+    const [snapshot, setSnapshot] = createSignal(undefined);
+    const [mode, setMode] = createSignal("observe");
+    const [receipts, setReceipts] = createSignal([]);
+    const [saved, setSaved] = createSignal(false);
+    const refresh = () => {
+        void props.api.status().then((next) => {
+            setSnapshot(next);
+            if (next !== undefined)
+                setMode(next.mode);
+        });
+        void props.api.receipts().then((next) => {
+            setReceipts(next ?? []);
+        });
+    };
+    onCleanup(props.api.watchSettings(refresh));
+    refresh();
+    const pick = (raw) => {
+        const value = parseModeValue(raw);
+        if (value === undefined)
+            return;
+        void props.api.update({ mode: value }).then((ok) => {
+            setSaved(ok);
+            refresh();
+        });
+    };
+    return (_jsxs("div", { class: "adaptive-page", children: [_jsx("table", { class: "adaptive-status", "aria-label": "OpenCode Adaptive status", children: _jsx("tbody", { children: _jsx(For, { each: statusRows(snapshot()), children: (row) => (_jsxs("tr", { class: "adaptive-row", "data-tone": row.tone, children: [_jsx("td", { class: "adaptive-row-label", children: row.label }), _jsx("td", { class: "adaptive-row-value", children: row.value })] })) }) }) }), _jsxs("label", { class: "adaptive-mode", children: [_jsx("span", { class: "adaptive-row-label", children: "Mode" }), _jsx("select", { class: "adaptive-mode-select", disabled: snapshot() === undefined, value: mode(), onChange: (event) => {
+                            pick(event.currentTarget.value);
+                        }, children: _jsx(For, { each: modeChoices(mode()), children: (choice) => _jsx("option", { value: choice.value, children: choice.title }) }) })] }), _jsx(Show, { when: saved(), children: _jsx("span", { class: "adaptive-saved", role: "status", children: "Saved" }) }), _jsx(Show, { when: snapshot() !== undefined, children: _jsx("div", { class: "adaptive-receipts", children: _jsx(For, { each: receiptLines(receipts()).slice(0, RECEIPTS_PREVIEW_LIMIT), children: (line) => _jsx("div", { class: "adaptive-receipt-line", children: line }) }) }) })] }));
+}
+/**
+ * GUI plugin entry (the `./gui-experimental` bundle default export). Thin adapter: registers a native
+ * SettingsPage and a palette command that opens it; no routing logic lives here (ADP-034/035).
+ */
+export default Plugin.define({
+    setup(context) {
+        const api = adaptiveGuiApi(context.client);
+        context.add(SettingsPage, {
+            id: "adaptive",
+            title: "OpenCode Adaptive",
+            entries: [
+                {
+                    id: "adaptive",
+                    title: "OpenCode Adaptive",
+                    description: "Execution tier routing, operating mode and resource health",
+                },
+            ],
+            render: () => _jsx(AdaptiveStatusPage, { api: api }),
+        });
+        context.add(Command, {
+            id: "open",
+            title: "OpenCode Adaptive",
+            group: "Adaptive",
+            run: () => {
+                context.layout.settings("adaptive");
+            },
+        });
+    },
+});
+//# sourceMappingURL=gui.js.map

package/dist/gui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gui.js","sourceRoot":"","sources":["../src/gui.tsx"],"names":[],"mappings":"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"}

package/dist/health/capacity/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./merge.js";
+export * from "./registry.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/health/capacity/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/health/capacity/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA"}

package/dist/health/capacity/index.js

@@ -0,0 +1,4 @@
+export * from "./merge.js";
+export * from "./registry.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/health/capacity/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/health/capacity/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA"}

package/dist/health/capacity/merge.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Deterministic capacity merge semantics (ADP-020).
+ *
+ * Several sensors may observe the same resource (e.g. passive headers and an
+ * optional quota endpoint). The merge picks one coherent story instead of
+ * synthesizing chimera numbers: readings are prioritized by confidence, then
+ * by conservativeness (lower remaining ratio first), then by input order, and
+ * each measured field is taken from the first reading in priority order that
+ * supplies it. Trust is reduced, never amplified:
+ *
+ * - the merged confidence is the LOWEST confidence among all surviving fresh
+ *   readings, because any concurrent contradictory observation unsettles the
+ *   whole picture (a sensor that merely corroborates still shares its doubt);
+ * - `observedAt` is the oldest surviving observation, so the merged reading
+ *   ages honestly;
+ * - `evidence` follows the base (highest-priority) reading, which owns the
+ *   merged story.
+ *
+ * Exact bounds are facts, not estimates: `remainingRatio === 0` or
+ * `usedRatio === 1` signals exhaustion at any confidence, while the softer
+ * `draining` signal requires `high` confidence (ADP-021). Anything that is
+ * not a well-formed measurement is rejected — untrusted data becomes "no
+ * estimate", never a guess.
+ */
+import type { HealthEvent, ResourceKey } from "../resource-health/types.js";
+import { type CapacityConfig, type CapacityReading, type CapacitySignals, type Confidence } from "./types.js";
+/** Evidence labels are bounded so unbounded header text cannot be persisted. */
+export declare const MAX_EVIDENCE_LENGTH = 128;
+export declare function confidenceRank(confidence: Confidence): number;
+/**
+ * Re-validates a reading field by field. A reading with an invalid ratio is
+ * rejected entirely (its numbers cannot be partially trusted); invalid
+ * `retryAfterMs`/`resetAt` values only drop their own field. A reading with
+ * no measured field left is discarded as pure noise.
+ */
+export declare function normalizeReading(reading: unknown): CapacityReading | null;
+/**
+ * Merges concurrent readings for one resource. Returns `null` when nothing
+ * survives normalization and the freshness window — an explicit "no estimate".
+ *
+ * Selection runs over the input order with a strict priority comparator, so
+ * ties keep the earliest reading and both comparator outcomes stay reachable.
+ */
+export declare function mergeReadings(readings: readonly CapacityReading[], now: number, config?: CapacityConfig): CapacityReading | null;
+/**
+ * Drain/exhaust derivation. Exhaustion is signaled by exact bounds at any
+ * confidence (a header stating zero remaining is a fact, not a guess);
+ * draining additionally requires `high` confidence because it withdraws new
+ * work before hard evidence exists (ADP-021).
+ */
+export declare function capacitySignals(reading: CapacityReading, config?: CapacityConfig): CapacitySignals;
+/**
+ * Pure bridge to the health layer: converts a merged reading into the
+ * capacity event consumed by resource-health transitions (ADP-021). The
+ * scheduler wiring decides when to observe it; this function only shapes it.
+ */
+export declare function capacityHealthEvent(key: ResourceKey, reading: CapacityReading): HealthEvent;
+//# sourceMappingURL=merge.d.ts.map

package/dist/health/capacity/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../../src/health/capacity/merge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAC3E,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,eAAe,EAEpB,KAAK,UAAU,EAChB,MAAM,YAAY,CAAA;AAEnB,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,MAAM,CAAA;AAEtC,wBAAgB,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAE7D;AAUD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CA+CzE;AAsBD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,SAAS,eAAe,EAAE,EACpC,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,cAAwC,GAC/C,eAAe,GAAG,IAAI,CA6CxB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,eAAe,EACxB,MAAM,GAAE,cAAwC,GAC/C,eAAe,CAUjB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,GAAG,WAAW,CAO3F"}

package/dist/health/capacity/merge.js

@@ -0,0 +1,154 @@
+import { CONFIDENCE_LEVELS, DEFAULT_CAPACITY_CONFIG, } from "./types.js";
+/** Evidence labels are bounded so unbounded header text cannot be persisted. */
+export const MAX_EVIDENCE_LENGTH = 128;
+export function confidenceRank(confidence) {
+    return CONFIDENCE_LEVELS.indexOf(confidence);
+}
+function isFiniteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value);
+}
+function isValidRatio(value) {
+    return isFiniteNumber(value) && value >= 0 && value <= 1;
+}
+/**
+ * Re-validates a reading field by field. A reading with an invalid ratio is
+ * rejected entirely (its numbers cannot be partially trusted); invalid
+ * `retryAfterMs`/`resetAt` values only drop their own field. A reading with
+ * no measured field left is discarded as pure noise.
+ */
+export function normalizeReading(reading) {
+    if (typeof reading !== "object" || reading === null) {
+        return null;
+    }
+    const candidate = reading;
+    if (!CONFIDENCE_LEVELS.includes(candidate.confidence)) {
+        return null;
+    }
+    if (!isFiniteNumber(candidate.observedAt) || candidate.observedAt < 0) {
+        return null;
+    }
+    if ((candidate.usedRatio !== undefined && !isValidRatio(candidate.usedRatio)) ||
+        (candidate.remainingRatio !== undefined && !isValidRatio(candidate.remainingRatio))) {
+        return null;
+    }
+    const retryAfterMs = candidate.retryAfterMs !== undefined &&
+        isFiniteNumber(candidate.retryAfterMs) &&
+        Number.isInteger(candidate.retryAfterMs) &&
+        candidate.retryAfterMs >= 0
+        ? candidate.retryAfterMs
+        : undefined;
+    const resetAt = isFiniteNumber(candidate.resetAt) && candidate.resetAt >= 0 ? candidate.resetAt : undefined;
+    const evidence = typeof candidate.evidence === "string"
+        ? candidate.evidence.slice(0, MAX_EVIDENCE_LENGTH)
+        : undefined;
+    if (candidate.usedRatio === undefined &&
+        candidate.remainingRatio === undefined &&
+        retryAfterMs === undefined &&
+        resetAt === undefined) {
+        return null;
+    }
+    return {
+        ...(candidate.usedRatio !== undefined ? { usedRatio: candidate.usedRatio } : {}),
+        ...(candidate.remainingRatio !== undefined ? { remainingRatio: candidate.remainingRatio } : {}),
+        ...(retryAfterMs !== undefined ? { retryAfterMs } : {}),
+        ...(resetAt !== undefined ? { resetAt } : {}),
+        confidence: candidate.confidence,
+        observedAt: candidate.observedAt,
+        ...(evidence !== undefined ? { evidence } : {}),
+    };
+}
+function isFresh(reading, now, config) {
+    return now - reading.observedAt <= config.maxAgeMs;
+}
+/**
+ * Strict priority between two readings: higher confidence wins; on equal
+ * confidence the more conservative remaining ratio wins (a missing remaining
+ * ratio cannot prove scarcity, so it counts as the least conservative value).
+ * Equal readings keep their relative order.
+ */
+function strictlyHigherPriority(candidate, incumbent) {
+    const byConfidence = confidenceRank(candidate.confidence) - confidenceRank(incumbent.confidence);
+    if (byConfidence !== 0) {
+        return byConfidence > 0;
+    }
+    const candidateRemaining = candidate.remainingRatio ?? 1;
+    const incumbentRemaining = incumbent.remainingRatio ?? 1;
+    return candidateRemaining < incumbentRemaining;
+}
+/**
+ * Merges concurrent readings for one resource. Returns `null` when nothing
+ * survives normalization and the freshness window — an explicit "no estimate".
+ *
+ * Selection runs over the input order with a strict priority comparator, so
+ * ties keep the earliest reading and both comparator outcomes stay reachable.
+ */
+export function mergeReadings(readings, now, config = DEFAULT_CAPACITY_CONFIG) {
+    const survivors = readings
+        .map(normalizeReading)
+        .filter((reading) => reading !== null)
+        .filter((reading) => isFresh(reading, now, config));
+    if (survivors.length === 0) {
+        return null;
+    }
+    const base = survivors.reduce((best, reading) => strictlyHigherPriority(reading, best) ? reading : best);
+    const bestField = (pick) => {
+        let best;
+        let bestValue;
+        for (const reading of survivors) {
+            const value = pick(reading);
+            if (value === undefined) {
+                continue;
+            }
+            if (best === undefined || strictlyHigherPriority(reading, best)) {
+                best = reading;
+                bestValue = value;
+            }
+        }
+        return bestValue;
+    };
+    const usedRatio = bestField((reading) => reading.usedRatio);
+    const remainingRatio = bestField((reading) => reading.remainingRatio);
+    const retryAfterMs = bestField((reading) => reading.retryAfterMs);
+    const resetAt = bestField((reading) => reading.resetAt);
+    const confidence = survivors.reduce((lowest, reading) => confidenceRank(reading.confidence) < confidenceRank(lowest) ? reading.confidence : lowest, base.confidence);
+    const observedAt = Math.min(...survivors.map((reading) => reading.observedAt));
+    return {
+        ...(usedRatio !== undefined ? { usedRatio } : {}),
+        ...(remainingRatio !== undefined ? { remainingRatio } : {}),
+        ...(retryAfterMs !== undefined ? { retryAfterMs } : {}),
+        ...(resetAt !== undefined ? { resetAt } : {}),
+        confidence,
+        observedAt,
+        ...(base.evidence !== undefined ? { evidence: base.evidence } : {}),
+    };
+}
+/**
+ * Drain/exhaust derivation. Exhaustion is signaled by exact bounds at any
+ * confidence (a header stating zero remaining is a fact, not a guess);
+ * draining additionally requires `high` confidence because it withdraws new
+ * work before hard evidence exists (ADP-021).
+ */
+export function capacitySignals(reading, config = DEFAULT_CAPACITY_CONFIG) {
+    const exhausted = reading.remainingRatio === 0 || reading.usedRatio === 1;
+    const draining = !exhausted &&
+        reading.confidence === "high" &&
+        ((reading.remainingRatio !== undefined &&
+            reading.remainingRatio <= config.drainingRemainingThreshold) ||
+            (reading.usedRatio !== undefined &&
+                reading.usedRatio >= 1 - config.drainingRemainingThreshold));
+    return { exhausted, draining };
+}
+/**
+ * Pure bridge to the health layer: converts a merged reading into the
+ * capacity event consumed by resource-health transitions (ADP-021). The
+ * scheduler wiring decides when to observe it; this function only shapes it.
+ */
+export function capacityHealthEvent(key, reading) {
+    return {
+        kind: "capacity",
+        key,
+        exhausted: capacitySignals(reading).exhausted,
+        ...(reading.retryAfterMs !== undefined ? { retryAfterMs: reading.retryAfterMs } : {}),
+    };
+}
+//# sourceMappingURL=merge.js.map

package/dist/health/capacity/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../../src/health/capacity/merge.ts"],"names":[],"mappings":"AAyBA,OAAO,EACL,iBAAiB,EAIjB,uBAAuB,GAExB,MAAM,YAAY,CAAA;AAEnB,gFAAgF;AAChF,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAA;AAEtC,MAAM,UAAU,cAAc,CAAC,UAAsB;IACnD,OAAO,iBAAiB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;AAC9C,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AAC5D,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;AAC1D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACpD,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,SAAS,GAAG,OAA0B,CAAA;IAC5C,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;QACtD,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,SAAS,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;QACtE,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IACE,CAAC,SAAS,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACzE,CAAC,SAAS,CAAC,cAAc,KAAK,SAAS,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,EACnF,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,YAAY,GAChB,SAAS,CAAC,YAAY,KAAK,SAAS;QACpC,cAAc,CAAC,SAAS,CAAC,YAAY,CAAC;QACtC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,YAAY,CAAC;QACxC,SAAS,CAAC,YAAY,IAAI,CAAC;QACzB,CAAC,CAAC,SAAS,CAAC,YAAY;QACxB,CAAC,CAAC,SAAS,CAAA;IACf,MAAM,OAAO,GACX,cAAc,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;IAC7F,MAAM,QAAQ,GACZ,OAAO,SAAS,CAAC,QAAQ,KAAK,QAAQ;QACpC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC;QAClD,CAAC,CAAC,SAAS,CAAA;IACf,IACE,SAAS,CAAC,SAAS,KAAK,SAAS;QACjC,SAAS,CAAC,cAAc,KAAK,SAAS;QACtC,YAAY,KAAK,SAAS;QAC1B,OAAO,KAAK,SAAS,EACrB,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO;QACL,GAAG,CAAC,SAAS,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,GAAG,CAAC,SAAS,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,SAAS,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/F,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,UAAU,EAAE,SAAS,CAAC,UAAU;QAChC,UAAU,EAAE,SAAS,CAAC,UAAU;QAChC,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChD,CAAA;AACH,CAAC;AAED,SAAS,OAAO,CAAC,OAAwB,EAAE,GAAW,EAAE,MAAsB;IAC5E,OAAO,GAAG,GAAG,OAAO,CAAC,UAAU,IAAI,MAAM,CAAC,QAAQ,CAAA;AACpD,CAAC;AAED;;;;;GAKG;AACH,SAAS,sBAAsB,CAAC,SAA0B,EAAE,SAA0B;IACpF,MAAM,YAAY,GAAG,cAAc,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,cAAc,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;IAChG,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,YAAY,GAAG,CAAC,CAAA;IACzB,CAAC;IACD,MAAM,kBAAkB,GAAG,SAAS,CAAC,cAAc,IAAI,CAAC,CAAA;IACxD,MAAM,kBAAkB,GAAG,SAAS,CAAC,cAAc,IAAI,CAAC,CAAA;IACxD,OAAO,kBAAkB,GAAG,kBAAkB,CAAA;AAChD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAoC,EACpC,GAAW,EACX,SAAyB,uBAAuB;IAEhD,MAAM,SAAS,GAAG,QAAQ;SACvB,GAAG,CAAC,gBAAgB,CAAC;SACrB,MAAM,CAAC,CAAC,OAAO,EAA8B,EAAE,CAAC,OAAO,KAAK,IAAI,CAAC;SACjE,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAA;IACrD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAC9C,sBAAsB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CACvD,CAAA;IACD,MAAM,SAAS,GAAG,CAAI,IAAiD,EAAiB,EAAE;QACxF,IAAI,IAAiC,CAAA;QACrC,IAAI,SAAwB,CAAA;QAC5B,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAA;YAC3B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,SAAQ;YACV,CAAC;YACD,IAAI,IAAI,KAAK,SAAS,IAAI,sBAAsB,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC;gBAChE,IAAI,GAAG,OAAO,CAAA;gBACd,SAAS,GAAG,KAAK,CAAA;YACnB,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAA;IAClB,CAAC,CAAA;IACD,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IAC3D,MAAM,cAAc,GAAG,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;IACrE,MAAM,YAAY,GAAG,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;IACjE,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IACvD,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CACjC,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAClB,cAAc,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,EAC3F,IAAI,CAAC,UAAU,CAChB,CAAA;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAA;IAC9E,OAAO;QACL,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,UAAU;QACV,UAAU;QACV,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpE,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAwB,EACxB,SAAyB,uBAAuB;IAEhD,MAAM,SAAS,GAAG,OAAO,CAAC,cAAc,KAAK,CAAC,IAAI,OAAO,CAAC,SAAS,KAAK,CAAC,CAAA;IACzE,MAAM,QAAQ,GACZ,CAAC,SAAS;QACV,OAAO,CAAC,UAAU,KAAK,MAAM;QAC7B,CAAC,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS;YACpC,OAAO,CAAC,cAAc,IAAI,MAAM,CAAC,0BAA0B,CAAC;YAC5D,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS;gBAC9B,OAAO,CAAC,SAAS,IAAI,CAAC,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAC,CAAA;IAClE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAA;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAgB,EAAE,OAAwB;IAC5E,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,GAAG;QACH,SAAS,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,SAAS;QAC7C,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtF,CAAA;AACH,CAAC"}

package/dist/health/capacity/registry.d.ts

@@ -0,0 +1,41 @@
+import type { Clock } from "../resource-health/types.js";
+import type { ResourceKey } from "../resource-health/types.js";
+import type { CapacityAssessment, CapacityConfig, CapacityReading, CapacitySensor } from "./types.js";
+/** One registry snapshot row: the sensor's resource and its latest reading. */
+export interface SensorSnapshot {
+    readonly resource: ResourceKey;
+    readonly latest: CapacityReading | null;
+}
+export declare class CapacityRegistry {
+    #private;
+    constructor(clock: Clock, config?: CapacityConfig);
+    /** Registers a sensor; re-registering an id replaces its previous sensor. */
+    register(sensor: CapacitySensor): void;
+    /** Removes a sensor; returns whether an entry existed. */
+    unregister(id: string): boolean;
+    /**
+     * Every registered sensor's latest reading alongside the resource it
+     * observes. The persisted-mirror path uses this to save what any instance
+     * observed; an entry whose sensor has no reading yet carries `null`.
+     */
+    snapshot(): readonly SensorSnapshot[];
+    /**
+     * Reads every sensor registered at call time once. A sensor already being
+     * read is skipped (its in-flight result will land) so concurrent refreshes
+     * never hammer a quota endpoint. A sensor that throws or returns malformed
+     * data stores "no observation" — fail-open, never a guess. A sensor
+     * unregistered or replaced while its read is in flight stores nothing.
+     */
+    refresh(): Promise<void>;
+    /**
+     * Merged reading for a resource, from sensors at the key itself or any of
+     * its ancestors. `null` means no fresh trustworthy estimate.
+     */
+    reading(key: ResourceKey): CapacityReading | null;
+    /**
+     * Scheduler-facing assessment for a resource. `none` is unknown capacity —
+     * callers must not interpret it as healthy.
+     */
+    assessment(key: ResourceKey): CapacityAssessment;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/health/capacity/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/health/capacity/registry.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAA;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAE9D,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,cAAc,EACf,MAAM,YAAY,CAAA;AAQnB,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAA;IAC9B,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAA;CACxC;AAED,qBAAa,gBAAgB;;gBAMf,KAAK,EAAE,KAAK,EAAE,MAAM,GAAE,cAAwC;IAK1E,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAItC,0DAA0D;IAC1D,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI/B;;;;OAIG;IACH,QAAQ,IAAI,SAAS,cAAc,EAAE;IAOrC;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B9B;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,WAAW,GAAG,eAAe,GAAG,IAAI;IAcjD;;;OAGG;IACH,UAAU,CAAC,GAAG,EAAE,WAAW,GAAG,kBAAkB;CAOjD"}

package/dist/health/capacity/registry.js

@@ -0,0 +1,106 @@
+/**
+ * Capacity registry: owns sensors, refreshes them, and answers scheduler
+ * queries (ADP-020). Pull-based and timer-free — the wiring layer decides
+ * when to refresh; queries sweep for staleness lazily, mirroring the
+ * resource-health registry.
+ *
+ * Lookups are hierarchical: a sensor attached to any ancestor of the queried
+ * key (provider → account → model → variant) contributes to it, so a
+ * provider- or account-wide quota reading covers its models without each
+ * model needing its own sensor.
+ */
+import { resourceChain, resourceKeyID } from "../resource-health/key.js";
+import { capacitySignals, mergeReadings, normalizeReading } from "./merge.js";
+import { DEFAULT_CAPACITY_CONFIG } from "./types.js";
+export class CapacityRegistry {
+    #clock;
+    #config;
+    #sensors = new Map();
+    #inFlight = new Set();
+    constructor(clock, config = DEFAULT_CAPACITY_CONFIG) {
+        this.#clock = clock;
+        this.#config = config;
+    }
+    /** Registers a sensor; re-registering an id replaces its previous sensor. */
+    register(sensor) {
+        this.#sensors.set(sensor.id, { sensor, latest: null });
+    }
+    /** Removes a sensor; returns whether an entry existed. */
+    unregister(id) {
+        return this.#sensors.delete(id);
+    }
+    /**
+     * Every registered sensor's latest reading alongside the resource it
+     * observes. The persisted-mirror path uses this to save what any instance
+     * observed; an entry whose sensor has no reading yet carries `null`.
+     */
+    snapshot() {
+        return [...this.#sensors.values()].map((entry) => ({
+            resource: entry.sensor.resource,
+            latest: entry.latest,
+        }));
+    }
+    /**
+     * Reads every sensor registered at call time once. A sensor already being
+     * read is skipped (its in-flight result will land) so concurrent refreshes
+     * never hammer a quota endpoint. A sensor that throws or returns malformed
+     * data stores "no observation" — fail-open, never a guess. A sensor
+     * unregistered or replaced while its read is in flight stores nothing.
+     */
+    async refresh() {
+        const entries = [...this.#sensors.values()];
+        await Promise.all(entries.map(async (entry) => this.#readSensor(entry)));
+    }
+    async #readSensor(entry) {
+        const id = entry.sensor.id;
+        if (this.#inFlight.has(id)) {
+            return;
+        }
+        this.#inFlight.add(id);
+        try {
+            let reading = null;
+            try {
+                reading = await entry.sensor.read();
+            }
+            catch {
+                reading = null;
+            }
+            const current = this.#sensors.get(id);
+            if (current?.sensor === entry.sensor) {
+                current.latest = reading === null ? null : normalizeReading(reading);
+            }
+        }
+        finally {
+            this.#inFlight.delete(id);
+        }
+    }
+    /**
+     * Merged reading for a resource, from sensors at the key itself or any of
+     * its ancestors. `null` means no fresh trustworthy estimate.
+     */
+    reading(key) {
+        const chainIDs = new Set(resourceChain(key).map(resourceKeyID));
+        const candidates = [];
+        for (const entry of this.#sensors.values()) {
+            if (!chainIDs.has(resourceKeyID(entry.sensor.resource))) {
+                continue;
+            }
+            if (entry.latest !== null) {
+                candidates.push(entry.latest);
+            }
+        }
+        return mergeReadings(candidates, this.#clock(), this.#config);
+    }
+    /**
+     * Scheduler-facing assessment for a resource. `none` is unknown capacity —
+     * callers must not interpret it as healthy.
+     */
+    assessment(key) {
+        const reading = this.reading(key);
+        if (reading === null) {
+            return { kind: "none" };
+        }
+        return { kind: "estimate", reading, signals: capacitySignals(reading, this.#config) };
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/health/capacity/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/health/capacity/registry.ts"],"names":[],"mappings":"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"}