@coool/opencode-adaptive 0.0.0-stage → 1.0.0

package/dist/index.js

@@ -0,0 +1,80 @@
+import { Plugin } from "@opencode/plugin";
+import { isCodexHeaderName } from "./adapters/codex-capacity/index.js";
+import { escalationTool, registerSessionHooks, subscribeSessions, tierTool, } from "./adapters/opencode/index.js";
+import { PLUGIN_ID } from "./plugin-id.js";
+import { adaptiveRpc } from "./rpc/definition.js";
+import { adaptiveRpcHandlers } from "./rpc/handlers.js";
+import { Supervisor, logFailOpen } from "./supervisor/index.js";
+export { PLUGIN_ID } from "./plugin-id.js";
+/**
+ * Plugin id as required by GOAL.md: must not collide with the `opencode.*`
+ * namespace and must stay stable across releases (referenced by settings
+ * storage keys and receipts).
+ */
+/**
+ * Entry point wired into OpenCode via `opencode.json(c)`. Setup glues the
+ * adapter touchpoints (session hooks, event subscription, storage) to the
+ * supervisor and returns a cleanup that disposes every registration.
+ * All supervision errors are fail-open (ADP-031): the supervisor's public
+ * entry points never throw; the event pump's stream errors are logged.
+ */
+export default Plugin.define({
+    id: PLUGIN_ID,
+    async setup(context) {
+        const supervisor = new Supervisor({
+            session: context.session,
+            model: context.model,
+            storage: context.storage,
+            clock: () => Date.now(),
+        });
+        const hooks = await registerSessionHooks(context.session, {
+            onRetry: async (input) => {
+                await supervisor.handleRetry(input);
+            },
+            onModelRequest: async (report) => {
+                await supervisor.handleReport(report);
+            },
+            onHttpResponse: async (report) => {
+                await supervisor.handleReport(report);
+            },
+            onIdle: async (report) => {
+                await supervisor.handleReport(report);
+            },
+            onPrompt: async (report) => {
+                await supervisor.handleReport(report);
+            },
+        }, { capture: isCodexHeaderName });
+        const subscription = subscribeSessions(context.event, (report) => {
+            void supervisor.handleReport(report);
+        }, (error) => {
+            logFailOpen("events", error);
+        });
+        // The typed escalation tool (T-18, ADP-015): the agent's self-report
+        // surface for stronger capability, applied at the next safe boundary.
+        // The tier tool (ADP-055): the agent declares the task's tier; the
+        // declaration steers the session's next admissions until cleared.
+        const toolRegistration = await context.tool.transform((editor) => {
+            editor.add(escalationTool((sessionID, reason, evidence) => supervisor.noteEscalationRequest(sessionID, reason, evidence)));
+            editor.add(tierTool((sessionID, tier) => supervisor.noteTierRequest(sessionID, tier)));
+        });
+        // Typed RPC (ADP-034/036): the only channel to the control surfaces.
+        // The settings-changed emitter resolves the registration lazily: handlers
+        // only run after `register` resolves, so the holder is always populated.
+        const rpcHolder = {};
+        const emit = (...args) => 
+        // The correlated tuple pairing is checked by the handler types; the
+        // registration forwards it to the host emitter untouched.
+        rpcHolder.registration?.events.emit(...args);
+        const rpcRegistration = await context.rpc.register(adaptiveRpc, adaptiveRpcHandlers(supervisor, emit));
+        rpcHolder.registration = rpcRegistration;
+        return () => {
+            for (const hookRegistration of hooks) {
+                void hookRegistration.dispose();
+            }
+            subscription.dispose();
+            void toolRegistration.dispose();
+            void rpcRegistration.dispose();
+        };
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/plugin-id.d.ts

@@ -0,0 +1,3 @@
+/** The plugin identity shared by the server, TUI, and GUI entries. */
+export declare const PLUGIN_ID = "coool.adaptive";
+//# sourceMappingURL=plugin-id.d.ts.map

package/dist/plugin-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-id.d.ts","sourceRoot":"","sources":["../src/plugin-id.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,eAAO,MAAM,SAAS,mBAAmB,CAAA"}

package/dist/plugin-id.js

@@ -0,0 +1,3 @@
+/** The plugin identity shared by the server, TUI, and GUI entries. */
+export const PLUGIN_ID = "coool.adaptive";
+//# sourceMappingURL=plugin-id.js.map

package/dist/plugin-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-id.js","sourceRoot":"","sources":["../src/plugin-id.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,MAAM,CAAC,MAAM,SAAS,GAAG,gBAAgB,CAAA"}

package/dist/rpc/definition.d.ts

@@ -0,0 +1,100 @@
+import type { StandardSchemaV1 } from "@standard-schema/spec";
+import type { OperatingMode } from "../core/scheduler/types.js";
+import type { SettingsPatch, SettingsV1 } from "../state/settings/index.js";
+import type { PatchResult } from "../state/settings/types.js";
+import type { SessionModeSetResult } from "../state/session-modes/index.js";
+import type { TierRequestSetResult } from "./handlers.js";
+import type { TierName } from "../core/tier-policy/types.js";
+import type { Receipt } from "../state/receipts/types.js";
+import type { StatusSnapshot } from "./status.js";
+export declare const ADAPTIVE_RPC_ID = "coool.adaptive";
+export declare const adaptiveRpc: {
+    readonly id: "coool.adaptive";
+    readonly methods: {
+        readonly "settings.get": {
+            readonly input: StandardSchemaV1<undefined, undefined>;
+            readonly output: StandardSchemaV1<SettingsV1, SettingsV1>;
+        };
+        readonly "settings.set": {
+            readonly input: StandardSchemaV1<SettingsPatch, SettingsPatch>;
+            readonly output: StandardSchemaV1<PatchResult, PatchResult>;
+        };
+        readonly "status.get": {
+            readonly input: StandardSchemaV1<undefined, undefined>;
+            readonly output: StandardSchemaV1<StatusSnapshot, StatusSnapshot>;
+        };
+        readonly "receipts.list": {
+            readonly input: StandardSchemaV1<undefined, undefined>;
+            readonly output: StandardSchemaV1<Receipt[], Receipt[]>;
+        };
+        readonly "session-mode.get": {
+            readonly input: StandardSchemaV1<{
+                sessionID: string;
+            }, {
+                sessionID: string;
+            }>;
+            readonly output: StandardSchemaV1<{
+                mode: OperatingMode | null;
+            }, {
+                mode: OperatingMode | null;
+            }>;
+        };
+        readonly "session-mode.set": {
+            readonly input: StandardSchemaV1<{
+                sessionID: string;
+                mode: OperatingMode | null;
+            }, {
+                sessionID: string;
+                mode: OperatingMode | null;
+            }>;
+            readonly output: StandardSchemaV1<SessionModeSetResult, SessionModeSetResult>;
+        };
+        readonly "tier-request.get": {
+            readonly input: StandardSchemaV1<{
+                sessionID: string;
+            }, {
+                sessionID: string;
+            }>;
+            readonly output: StandardSchemaV1<{
+                tier: TierName | null;
+            }, {
+                tier: TierName | null;
+            }>;
+        };
+        readonly "tier-request.set": {
+            readonly input: StandardSchemaV1<{
+                sessionID: string;
+                tier: string | null;
+            }, {
+                sessionID: string;
+                tier: string | null;
+            }>;
+            readonly output: StandardSchemaV1<TierRequestSetResult, TierRequestSetResult>;
+        };
+    };
+    readonly events: {
+        readonly "settings-changed": {
+            readonly schema: StandardSchemaV1<{
+                version: number;
+            }, {
+                version: number;
+            }>;
+        };
+        readonly "session-mode-changed": {
+            readonly schema: StandardSchemaV1<{
+                sessionID: string;
+            }, {
+                sessionID: string;
+            }>;
+        };
+        readonly "tier-request-changed": {
+            readonly schema: StandardSchemaV1<{
+                sessionID: string;
+            }, {
+                sessionID: string;
+            }>;
+        };
+    };
+};
+export type AdaptiveRpc = typeof adaptiveRpc;
+//# sourceMappingURL=definition.d.ts.map

package/dist/rpc/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/rpc/definition.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AAC3E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,eAAO,MAAM,eAAe,mBAAmB,CAAA;AAqD/C,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;2BAoBS,MAAM;;2BAAN,MAAM;;;sBAIV,aAAa,GAAG,IAAI;;sBAApB,aAAa,GAAG,IAAI;;;;;2BAGhB,MAAM;sBAAQ,aAAa,GAAG,IAAI;;2BAAlC,MAAM;sBAAQ,aAAa,GAAG,IAAI;;;;;;2BAOlC,MAAM;;2BAAN,MAAM;;;sBAIV,QAAQ,GAAG,IAAI;;sBAAf,QAAQ,GAAG,IAAI;;;;;2BAGX,MAAM;sBAAQ,MAAM,GAAG,IAAI;;2BAA3B,MAAM;sBAAQ,MAAM,GAAG,IAAI;;;;;;;;yBAS5B,MAAM;;yBAAN,MAAM;;;;;2BAGJ,MAAM;;2BAAN,MAAM;;;;;2BAMN,MAAM;;2BAAN,MAAM;;;;CAMtC,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAA"}

package/dist/rpc/definition.js

@@ -0,0 +1,104 @@
+/**
+ * Typed RPC definition (ADP-034/036): the only channel between the server
+ * plugin and the TUI/GUI surfaces. Surfaces hold no local settings state —
+ * they fetch snapshots, patch settings, and re-fetch on the `settings-changed`
+ * event (the server is the single source of truth). Session-mode overrides
+ * follow the same contract via `session-mode.get/set` and the
+ * `session-mode-changed` event (ADP-054); sticky per-session tier requests
+ * follow it via `tier-request.get/set` and `tier-request-changed` (ADP-055).
+ *
+ * Schema note: input schemas gate the wire shape (non-object patches are
+ * rejected as rpc.invalid_input); deeper validation happens in the handlers
+ * via the state parsers (`applyPatch` reports per-field errors instead), and
+ * output schemas are passthroughs over trusted server-side data.
+ */
+import { Rpc } from "@opencode/schema/rpc";
+export const ADAPTIVE_RPC_ID = "coool.adaptive";
+const RPC_VENDOR = "coool.adaptive";
+/**
+ * Identity schema: the wire value passes through unchanged; the type
+ * parameters carry the transport contract. `gate` optionally rejects values
+ * before they reach a handler; the failure message names the expectation so a
+ * rejected call is diagnosable from the wire error alone.
+ */
+function schema(gate, expectation) {
+    return {
+        "~standard": {
+            version: 1,
+            vendor: RPC_VENDOR,
+            validate: (value) => gate(value) ? { value: value } : { issues: [{ message: expectation }] },
+        },
+    };
+}
+function voidSchema() {
+    return {
+        "~standard": {
+            version: 1,
+            vendor: RPC_VENDOR,
+            validate: (value) => value === undefined
+                ? { value: undefined }
+                : { issues: [{ message: "unexpected input: no input expected" }] },
+        },
+    };
+}
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isString = (value) => typeof value === "string";
+/** `{ sessionID: string }` — deeper validation (bounds, vocabulary) is the handler's. */
+const hasSessionID = (value) => isRecord(value) && isString(value["sessionID"]);
+/** `{ sessionID: string, mode: OperatingMode | null }` wire shape. */
+const isSessionModeSet = (value) => isRecord(value) &&
+    isString(value["sessionID"]) &&
+    (value["mode"] === null || isString(value["mode"]));
+/** `{ sessionID: string, tier: string | null }` wire shape. */
+const isTierRequestSet = (value) => isRecord(value) &&
+    isString(value["sessionID"]) &&
+    (value["tier"] === null || isString(value["tier"]));
+export const adaptiveRpc = Rpc.define({
+    id: ADAPTIVE_RPC_ID,
+    methods: {
+        "settings.get": {
+            input: voidSchema(),
+            output: schema(isRecord, "output must be an object"),
+        },
+        "settings.set": {
+            input: schema(isRecord, "input must be an object"),
+            output: schema(isRecord, "output must be an object"),
+        },
+        "status.get": {
+            input: voidSchema(),
+            output: schema(isRecord, "output must be an object"),
+        },
+        "receipts.list": {
+            input: voidSchema(),
+            output: schema(Array.isArray, "output must be an array"),
+        },
+        "session-mode.get": {
+            input: schema(hasSessionID, "input must be an object with a sessionID string"),
+            output: schema(isRecord, "output must be an object"),
+        },
+        "session-mode.set": {
+            input: schema(isSessionModeSet, "input must be an object with a sessionID string and a mode string or null"),
+            output: schema(isRecord, "output must be an object"),
+        },
+        "tier-request.get": {
+            input: schema(hasSessionID, "input must be an object with a sessionID string"),
+            output: schema(isRecord, "output must be an object"),
+        },
+        "tier-request.set": {
+            input: schema(isTierRequestSet, "input must be an object with a sessionID string and a tier string or null"),
+            output: schema(isRecord, "output must be an object"),
+        },
+    },
+    events: {
+        "settings-changed": {
+            schema: schema(isRecord, "event data must be an object"),
+        },
+        "session-mode-changed": {
+            schema: schema(hasSessionID, "event data must be an object with a sessionID string"),
+        },
+        "tier-request-changed": {
+            schema: schema(hasSessionID, "event data must be an object with a sessionID string"),
+        },
+    },
+});
+//# sourceMappingURL=definition.js.map

package/dist/rpc/definition.js.map

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

package/dist/rpc/handlers.d.ts

@@ -0,0 +1,65 @@
+import type { OperatingMode } from "../core/scheduler/types.js";
+import type { TierName } from "../core/tier-policy/types.js";
+import type { SessionModeSetResult } from "../state/session-modes/index.js";
+import type { PatchResult } from "../state/settings/types.js";
+import type { SettingsPatch, SettingsV1 } from "../state/settings/index.js";
+import type { Receipt } from "../state/receipts/types.js";
+import type { StatusSnapshot } from "./status.js";
+export interface AdaptiveRpcSource {
+    settings(): Promise<SettingsV1>;
+    updateSettings(patch: SettingsPatch): Promise<PatchResult>;
+    status(): Promise<StatusSnapshot>;
+    receipts(): Promise<Receipt[]>;
+    getSessionMode(sessionID: string): Promise<OperatingMode | null>;
+    setSessionMode(sessionID: string, mode: OperatingMode | null): Promise<void>;
+    getTierRequest(sessionID: string): Promise<TierName | null>;
+    noteTierRequest(sessionID: string, tier: string): boolean;
+    setTierRequest(sessionID: string, tier: TierName | null): Promise<void>;
+}
+export type SettingsChangedEmit = (name: "settings-changed", data: {
+    version: number;
+}) => unknown;
+/**
+ * Correlated emit: each call site pairs the event name with its own payload
+ * shape — an invalid pairing is a type error, and the registration site can
+ * forward the tuple to the host emitter untouched.
+ */
+export type AdaptiveRpcEmit = (...args: ["settings-changed", {
+    version: number;
+}] | ["session-mode-changed", {
+    sessionID: string;
+}] | ["tier-request-changed", {
+    sessionID: string;
+}]) => unknown;
+/** A successful tier-request write; mirrors the SessionModeSetResult convention. */
+export type TierRequestSetResult = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly errors: readonly string[];
+};
+export declare function adaptiveRpcHandlers(source: AdaptiveRpcSource, emit?: AdaptiveRpcEmit): {
+    "settings.get": (input: undefined) => Promise<SettingsV1>;
+    "settings.set": (input: SettingsPatch) => Promise<PatchResult>;
+    "status.get": (input: undefined) => Promise<StatusSnapshot>;
+    "receipts.list": (input: undefined) => Promise<Receipt[]>;
+    "session-mode.get": (input: {
+        sessionID: string;
+    }) => Promise<{
+        mode: OperatingMode | null;
+    }>;
+    "session-mode.set": (input: {
+        sessionID: string;
+        mode: OperatingMode | null;
+    }) => Promise<SessionModeSetResult>;
+    "tier-request.get": (input: {
+        sessionID: string;
+    }) => Promise<{
+        tier: TierName | null;
+    }>;
+    "tier-request.set": (input: {
+        sessionID: string;
+        tier: string | null;
+    }) => Promise<TierRequestSetResult>;
+};
+//# sourceMappingURL=handlers.d.ts.map

package/dist/rpc/handlers.d.ts.map

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

package/dist/rpc/handlers.js

@@ -0,0 +1,111 @@
+/**
+ * RPC handler binding (ADP-034/036): adapts the supervisor's state API to the
+ * typed RPC methods. Handlers never throw for expected outcomes — an invalid
+ * patch is a per-field `PatchResult`, and an internal failure degrades to
+ * `{ ok: false }` (fail-open, ADP-031). Read methods propagate host errors so
+ * surfaces can show them honestly.
+ */
+import { OPERATING_MODES } from "../core/scheduler/types.js";
+import { TIERS } from "../core/tier-policy/types.js";
+import { logFailOpen } from "../supervisor/log.js";
+import { isValidSessionID } from "../state/session-modes/index.js";
+/** Per-field errors for a session-mode patch, mirroring the settings contract. */
+function sessionModeSetError(input) {
+    if (!isValidSessionID(input.sessionID)) {
+        return "sessionID must be a non-empty string of at most 128 characters";
+    }
+    if (input.mode !== null && !OPERATING_MODES.includes(input.mode)) {
+        return `mode must be one of ${OPERATING_MODES.join(", ")} or null`;
+    }
+    return undefined;
+}
+/** Same contract for a tier-request patch (ADP-055): vocabulary-gated tier. */
+function tierRequestSetError(input) {
+    if (!isValidSessionID(input.sessionID)) {
+        return "sessionID must be a non-empty string of at most 128 characters";
+    }
+    if (input.tier !== null && !TIERS.includes(input.tier)) {
+        return `tier must be one of ${TIERS.join(", ")} or null`;
+    }
+    return undefined;
+}
+export function adaptiveRpcHandlers(source, emit) {
+    return {
+        "settings.get": () => source.settings(),
+        "settings.set": async (patch) => {
+            try {
+                const result = await source.updateSettings(patch);
+                if (result.ok && emit !== undefined) {
+                    try {
+                        await emit("settings-changed", { version: result.settings.version });
+                    }
+                    catch (error) {
+                        logFailOpen("rpc-emit", error);
+                    }
+                }
+                return result;
+            }
+            catch (error) {
+                logFailOpen("rpc-set", error);
+                return { ok: false, errors: ["internal error"] };
+            }
+        },
+        "status.get": () => source.status(),
+        "receipts.list": () => source.receipts(),
+        "session-mode.get": (input) => source.getSessionMode(input.sessionID).then((mode) => ({ mode })),
+        "session-mode.set": async (input) => {
+            const invalid = sessionModeSetError(input);
+            if (invalid !== undefined)
+                return { ok: false, errors: [invalid] };
+            try {
+                await source.setSessionMode(input.sessionID, input.mode);
+            }
+            catch (error) {
+                logFailOpen("rpc-set", error);
+                return { ok: false, errors: ["internal error"] };
+            }
+            if (emit !== undefined) {
+                try {
+                    await emit("session-mode-changed", { sessionID: input.sessionID });
+                }
+                catch (error) {
+                    logFailOpen("rpc-emit", error);
+                }
+            }
+            return { ok: true };
+        },
+        "tier-request.get": (input) => source.getTierRequest(input.sessionID).then((tier) => ({ tier })),
+        "tier-request.set": async (input) => {
+            const invalid = tierRequestSetError(input);
+            if (invalid !== undefined)
+                return { ok: false, errors: [invalid] };
+            if (input.tier !== null) {
+                // A non-null tier is a sticky record: noteTierRequest re-validates the
+                // vocabulary (post-gate this cannot fail, so treat `false` as internal).
+                if (!source.noteTierRequest(input.sessionID, input.tier)) {
+                    logFailOpen("rpc-set", new Error("tier request rejected"));
+                    return { ok: false, errors: ["internal error"] };
+                }
+            }
+            else {
+                try {
+                    await source.setTierRequest(input.sessionID, null);
+                }
+                catch (error) {
+                    logFailOpen("rpc-set", error);
+                    return { ok: false, errors: ["internal error"] };
+                }
+            }
+            if (emit !== undefined) {
+                try {
+                    await emit("tier-request-changed", { sessionID: input.sessionID });
+                }
+                catch (error) {
+                    logFailOpen("rpc-emit", error);
+                }
+            }
+            return { ok: true };
+        },
+    };
+}
+//# sourceMappingURL=handlers.js.map

package/dist/rpc/handlers.js.map

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

package/dist/rpc/status.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Status snapshot for the control surfaces (ADP-033): a bounded, secret-free
+ * view of the settings and the resource-health state of every configured
+ * resource. Pure — the supervisor (or any future caller) gathers the inputs.
+ */
+import type { OperatingMode } from "../core/scheduler/types.js";
+import type { ModelRef } from "../core/work-unit/types.js";
+import type { TierName } from "../core/tier-policy/types.js";
+import type { ResourceRecord } from "../health/resource-health/types.js";
+import type { CapacityReading } from "../health/capacity/types.js";
+import type { SettingsV1 } from "../state/settings/index.js";
+export interface TierResourceStatus {
+    ref: ModelRef;
+    health: ResourceRecord["health"];
+    breaker: ResourceRecord["breaker"]["state"];
+    windowed: boolean;
+    /**
+     * Wall-clock deadline of the active window (ms epoch); null when unwindowed.
+     * Null — not undefined: the host RPC encoder rejects JSON objects carrying a
+     * present-but-undefined key ("Expected JSON value"), which 500'd every
+     * status.get once any resource was configured.
+     */
+    windowUntil: number | null;
+    /** Used capacity as a rounded whole percent; null when no reading exists. */
+    usedPercent: number | null;
+    /** Wall-clock capacity reset deadline (ms epoch); null when unread. */
+    resetAt: number | null;
+}
+export interface StatusSnapshot {
+    mode: OperatingMode;
+    pin: ModelRef | null;
+    tiers: Readonly<Record<TierName, readonly TierResourceStatus[]>>;
+    parked: number;
+    receipts: number;
+}
+export declare function buildStatus(input: {
+    settings: SettingsV1;
+    health: readonly ResourceRecord[];
+    capacity: Readonly<Record<string, CapacityReading | null>>;
+    parked: number;
+    receipts: number;
+}): StatusSnapshot;
+//# sourceMappingURL=status.d.ts.map

package/dist/rpc/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/rpc/status.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAE/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAA;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAElE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAE5D,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,QAAQ,CAAA;IACb,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAA;IAChC,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAA;IAC3C,QAAQ,EAAE,OAAO,CAAA;IACjB;;;;;OAKG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,6EAA6E;IAC7E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,uEAAuE;IACvE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,aAAa,CAAA;IACnB,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAA;IACpB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC,CAAC,CAAA;IAChE,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE;IACjC,QAAQ,EAAE,UAAU,CAAA;IACpB,MAAM,EAAE,SAAS,cAAc,EAAE,CAAA;IACjC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC,CAAC,CAAA;IAC1D,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;CACjB,GAAG,cAAc,CA0BjB"}

package/dist/rpc/status.js

@@ -0,0 +1,45 @@
+import { schedulerHealthKey } from "../core/scheduler/index.js";
+import { TIERS } from "../core/tier-policy/types.js";
+import { resourceKeyID } from "../health/resource-health/index.js";
+export function buildStatus(input) {
+    const byKey = new Map();
+    for (const record of input.health)
+        byKey.set(resourceKeyID(record.key), record);
+    const tiers = {};
+    for (const tier of TIERS) {
+        tiers[tier] = input.settings.tiers[tier].map((ref) => {
+            const record = byKey.get(schedulerHealthKey(ref));
+            const capacityReading = input.capacity[schedulerHealthKey(ref)] ?? null;
+            return {
+                ref,
+                health: record?.health ?? "healthy",
+                breaker: record?.breaker.state ?? "closed",
+                windowed: record?.window !== undefined,
+                windowUntil: record?.window?.until ?? null,
+                usedPercent: capacityUsedPercent(capacityReading),
+                resetAt: capacityReading?.resetAt ?? null,
+            };
+        });
+    }
+    return {
+        mode: input.settings.mode,
+        pin: input.settings.pin,
+        tiers,
+        parked: input.parked,
+        receipts: input.receipts,
+    };
+}
+/**
+ * Derives the used-capacity percentage from a reading. Readings may carry any
+ * subset of the two ratios: usedRatio directly, or the remainder inferred from
+ * remainingRatio. A reading with neither ratio is still present (confidence,
+ * resetAt may be set) but yields no percentage — null, not undefined.
+ */
+function capacityUsedPercent(reading) {
+    if (reading?.usedRatio !== undefined)
+        return Math.round(reading.usedRatio * 100);
+    if (reading?.remainingRatio !== undefined)
+        return Math.round((1 - reading.remainingRatio) * 100);
+    return null;
+}
+//# sourceMappingURL=status.js.map

package/dist/rpc/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/rpc/status.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAG/D,OAAO,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAA;AAGpD,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAA;AA6BlE,MAAM,UAAU,WAAW,CAAC,KAM3B;IACC,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAA;IAC/C,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,MAAM;QAAE,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAA;IAC/E,MAAM,KAAK,GAAG,EAA4C,CAAA;IAC1D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACnD,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAA;YACjD,MAAM,eAAe,GAAG,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAA;YACvE,OAAO;gBACL,GAAG;gBACH,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,SAAS;gBACnC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,QAAQ;gBAC1C,QAAQ,EAAE,MAAM,EAAE,MAAM,KAAK,SAAS;gBACtC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,IAAI;gBAC1C,WAAW,EAAE,mBAAmB,CAAC,eAAe,CAAC;gBACjD,OAAO,EAAE,eAAe,EAAE,OAAO,IAAI,IAAI;aAC1C,CAAA;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI;QACzB,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG;QACvB,KAAK;QACL,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,mBAAmB,CAAC,OAA+B;IAC1D,IAAI,OAAO,EAAE,SAAS,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,GAAG,GAAG,CAAC,CAAA;IAChF,IAAI,OAAO,EAAE,cAAc,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,GAAG,CAAC,CAAA;IAChG,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/rpc.d.ts

@@ -0,0 +1,11 @@
+/**
+ * RPC entrypoint: the typed definition shared by the server plugin and the
+ * control surfaces, plus the handler binding used server-side.
+ */
+export { adaptiveRpc, ADAPTIVE_RPC_ID } from "./rpc/definition.js";
+export type { AdaptiveRpc } from "./rpc/definition.js";
+export { adaptiveRpcHandlers } from "./rpc/handlers.js";
+export type { AdaptiveRpcSource, AdaptiveRpcEmit, SettingsChangedEmit, TierRequestSetResult, } from "./rpc/handlers.js";
+export { buildStatus } from "./rpc/status.js";
+export type { StatusSnapshot, TierResourceStatus } from "./rpc/status.js";
+//# sourceMappingURL=rpc.d.ts.map

package/dist/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAClE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/rpc.js

@@ -0,0 +1,8 @@
+/**
+ * RPC entrypoint: the typed definition shared by the server plugin and the
+ * control surfaces, plus the handler binding used server-side.
+ */
+export { adaptiveRpc, ADAPTIVE_RPC_ID } from "./rpc/definition.js";
+export { adaptiveRpcHandlers } from "./rpc/handlers.js";
+export { buildStatus } from "./rpc/status.js";
+//# sourceMappingURL=rpc.js.map

package/dist/rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAElE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAOvD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA"}