@oeronteros-1/opencode-orchestra 0.5.3 → 1.0.1

package/dist/index.js

@@ -6,6 +6,9 @@ import { applyDiscoveredModels, discoverConnectedModels } from "./routing/model-
 import { primarySystemHint } from "./superpowers/compatibility.js";
 import { Ledger } from "./telemetry/ledger.js";
 import { createOrchestraTools } from "./tools.js";
+import { createStreamObserver } from "./routing/observer.js";
+import { createPriceRefresher } from "./routing/pricing/refresh.js";
+import { detectMcpPresence, resolvePluginVersion, PACKAGE_NAME } from "./plugin-status.js";
 function mergeAgent(base, override) {
     if (!override)
         return base;
@@ -18,6 +21,74 @@ function mergeAgent(base, override) {
         },
     };
 }
+// Stream observers keyed by message part id. These let us flag low-confidence
+// or self-correcting output *while a worker is still generating*, before any
+// finalized answer exists, so escalation can fire early instead of post-hoc.
+const streamObservers = new Map();
+const flaggedParts = new Set();
+const STREAM_CONFIDENCE_THRESHOLD = 0.6;
+// Opt-in reply text and prompt text accumulation, keyed by message id. Only
+// populated when `telemetry.storeTexts` is enabled; otherwise dropped.
+const replyBuffers = new Map();
+// A chat.message prompt precedes its assistant message and has a different id,
+// so prompts are correlated by session rather than by assistant message id.
+const promptBuffers = new Map();
+const MAX_TEXT_BUFFERS = 512;
+let storeTextsFlag = false;
+function pruneOldest(map) {
+    while (map.size > MAX_TEXT_BUFFERS) {
+        const oldest = map.keys().next().value;
+        if (oldest === undefined)
+            break;
+        map.delete(oldest);
+    }
+}
+function trackStreamDelta(sessionID, part, delta) {
+    if (!delta)
+        return;
+    const partID = part.id;
+    let observer = streamObservers.get(partID);
+    if (!observer) {
+        observer = createStreamObserver({ threshold: STREAM_CONFIDENCE_THRESHOLD });
+        streamObservers.set(partID, observer);
+    }
+    const observation = observer.push(delta);
+    if (observation.lowConfidence && !flaggedParts.has(partID)) {
+        flaggedParts.add(partID);
+        void logStreamFlag(sessionID, partID, observation).catch(() => undefined);
+    }
+    if (storeTextsFlag) {
+        replyBuffers.set(part.messageID, `${replyBuffers.get(part.messageID) ?? ""}${delta}`);
+        pruneOldest(replyBuffers);
+    }
+}
+function endStream(messageID) {
+    // A finalized message no longer needs an accumulated reply after its event
+    // handler has consumed it. Keep the id parameter explicit for lifecycle use.
+    if (!storeTextsFlag)
+        replyBuffers.delete(messageID);
+    // Observers are pruned lazily by size to bound memory over a long session.
+    if (streamObservers.size > 512) {
+        const overflow = streamObservers.size - 512;
+        let removed = 0;
+        for (const key of streamObservers.keys()) {
+            if (removed >= overflow)
+                break;
+            streamObservers.delete(key);
+            flaggedParts.delete(key);
+            removed += 1;
+        }
+    }
+}
+// Stub logger: replaced when the plugin body captures `client.app.log`.
+let streamLog = () => Promise.resolve();
+function logStreamFlag(sessionID, partID, observation) {
+    return streamLog(sessionID, "orchestra stream observer flagged low-confidence output", {
+        partID,
+        confidence: observation.confidence,
+        flags: observation.flags,
+    });
+}
 export const OrchestraPlugin = async ({ client, directory }, rawOptions = {}) => {
     const loaded = await loadConfig(directory, rawOptions);
     const discovered = await discoverConnectedModels(client);
@@ -29,8 +100,30 @@ export const OrchestraPlugin = async ({ client, directory }, rawOptions = {}) =>
         ...Object.values(orchestra.models.worker),
         orchestra.models.judge,
     ];
-    const ledger = new Ledger(directory, orchestra.telemetry.directory, orchestra.telemetry.enabled, pools);
+    const ledger = new Ledger(directory, orchestra.telemetry.directory, orchestra.telemetry.enabled, pools, orchestra.telemetry.storeTexts);
+    storeTextsFlag = orchestra.telemetry.storeTexts;
+    const refreshSource = orchestra.pricing.endpoint
+        ? { endpoint: orchestra.pricing.endpoint, refreshIntervalHours: orchestra.pricing.refreshIntervalHours }
+        : undefined;
+    const priceRefresher = createPriceRefresher(undefined, refreshSource);
+    priceRefresher.start();
     const systemHint = primarySystemHint(orchestra);
+    const pluginStatus = {
+        name: PACKAGE_NAME,
+        version: await resolvePluginVersion(),
+        budget: orchestra.budget,
+        modelStrategy: orchestra.models.strategy,
+        configuredModels: pools.flat().length,
+        discoveredModels: discovered.length,
+        configSource: loaded.source ?? "plugin options/defaults",
+        mcp: await detectMcpPresence(),
+    };
+    streamLog = (sessionID, message, extra) => client.app
+        .log({
+        body: { service: "opencode-orchestra", level: "warn", message, extra: { sessionID, ...extra } },
+    })
+        .then(() => undefined)
+        .catch(() => undefined);
     await client.app
         .log({
         body: {
@@ -59,19 +152,65 @@ export const OrchestraPlugin = async ({ client, directory }, rawOptions = {}) =>
                 description: "Show OpenCode Orchestra usage and escalation status",
                 template: "Call the orchestra_status tool and present its result verbatim.",
             };
+            mutable.command["plugin-status"] ??= {
+                description: "Show the OpenCode Orchestra plugin's own runtime status",
+                template: "Call the orchestra_plugin_status tool and present its result verbatim.",
+            };
             mutable.command.orchestra ??= {
                 description: "Classify a task and delegate it to orch-lead",
                 template: "Call orchestra_route for this task: $ARGUMENTS. Then delegate the full task once to orch-lead using the returned profile and constraints.",
             };
         },
-        tool: createOrchestraTools(orchestra, ledger),
+        tool: createOrchestraTools(orchestra, ledger, pluginStatus, {
+            get snapshot() { return priceRefresher.snapshot; },
+        }),
+        dispose: async () => {
+            priceRefresher.stop();
+            promptBuffers.clear();
+            replyBuffers.clear();
+            streamObservers.clear();
+            flaggedParts.clear();
+        },
+        "chat.message": async ({ sessionID }, output) => {
+            if (!storeTextsFlag || !sessionID)
+                return;
+            const text = output.parts
+                .filter((part) => part.type === "text")
+                .map((part) => part.text)
+                .join("")
+                .trim();
+            if (text) {
+                promptBuffers.set(sessionID, text);
+                pruneOldest(promptBuffers);
+            }
+        },
         event: async ({ event }) => {
+            if (event.type === "message.part.updated") {
+                const part = event.properties.part;
+                trackStreamDelta(part.sessionID, part, event.properties.delta ?? "");
+                return;
+            }
             if (event.type !== "message.updated")
                 return;
             const info = event.properties.info;
             if (info.role !== "assistant")
                 return;
+            endStream(info.id);
             await ledger.recordAssistant(info);
+            if (storeTextsFlag) {
+                const prompt = promptBuffers.get(info.sessionID);
+                const reply = replyBuffers.get(info.id);
+                promptBuffers.delete(info.sessionID);
+                replyBuffers.delete(info.id);
+                if (prompt !== undefined || reply !== undefined) {
+                    const text = {};
+                    if (prompt !== undefined)
+                        text.prompt = prompt;
+                    if (reply !== undefined)
+                        text.reply = reply;
+                    await ledger.recordText(info.sessionID, info.id, text);
+                }
+            }
         },
         ...(systemHint
             ? {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAElD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AAC7F,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,EAAE,oBAAoB,EAAuB,MAAM,uBAAuB,CAAA;AACjF,OAAO,EAAE,oBAAoB,EAAsB,MAAM,8BAA8B,CAAA;AACvF,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,YAAY,EAAqB,MAAM,oBAAoB,CAAA;AAO7G,SAAS,UAAU,CAAC,IAAwB,EAAE,QAA6B;IACzE,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAA;IAC1B,OAAO;QACL,GAAG,IAAI;QACP,GAAG,QAAQ;QACX,UAAU,EAAE;YACV,GAAG,IAAI,CAAC,UAAU;YAClB,GAAG,QAAQ,CAAC,UAAU;SACvB;KACF,CAAA;AACH,CAAC;AAED,8EAA8E;AAC9E,6EAA6E;AAC7E,6EAA6E;AAC7E,MAAM,eAAe,GAAG,IAAI,GAAG,EAA0B,CAAA;AACzD,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAA;AACtC,MAAM,2BAA2B,GAAG,GAAG,CAAA;AAEvC,4EAA4E;AAC5E,uEAAuE;AACvE,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAA;AAC9C,+EAA+E;AAC/E,4EAA4E;AAC5E,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAA;AAC/C,MAAM,gBAAgB,GAAG,GAAG,CAAA;AAC5B,IAAI,cAAc,GAAG,KAAK,CAAA;AAE1B,SAAS,WAAW,CAAC,GAAwB;IAC3C,OAAO,GAAG,CAAC,IAAI,GAAG,gBAAgB,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAA;QACtC,IAAI,MAAM,KAAK,SAAS;YAAE,MAAK;QAC/B,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACpB,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,SAAiB,EAAE,IAAuC,EAAE,KAAa;IACjG,IAAI,CAAC,KAAK;QAAE,OAAM;IAClB,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAA;IACtB,IAAI,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,oBAAoB,CAAC,EAAE,SAAS,EAAE,2BAA2B,EAAE,CAAC,CAAA;QAC3E,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IACvC,CAAC;IACD,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACxC,IAAI,WAAW,CAAC,aAAa,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3D,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACxB,KAAK,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IAC3E,CAAC;IACD,IAAI,cAAc,EAAE,CAAC;QACnB,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC,CAAA;QACrF,WAAW,CAAC,YAAY,CAAC,CAAA;IAC3B,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,SAAiB;IAClC,2EAA2E;IAC3E,6EAA6E;IAC7E,IAAI,CAAC,cAAc;QAAE,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IACnD,2EAA2E;IAC3E,IAAI,eAAe,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,GAAG,GAAG,CAAA;QAC3C,IAAI,OAAO,GAAG,CAAC,CAAA;QACf,KAAK,MAAM,GAAG,IAAI,eAAe,CAAC,IAAI,EAAE,EAAE,CAAC;YACzC,IAAI,OAAO,IAAI,QAAQ;gBAAE,MAAK;YAC9B,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YAC3B,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACxB,OAAO,IAAI,CAAC,CAAA;QACd,CAAC;IACH,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,IAAI,SAAS,GAA0E,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAA;AAE9G,SAAS,aAAa,CAAC,SAAiB,EAAE,MAAc,EAAE,WAAoD;IAC5G,OAAO,SAAS,CAAC,SAAS,EAAE,yDAAyD,EAAE;QACrF,MAAM;QACN,UAAU,EAAE,WAAW,CAAC,UAAU;QAClC,KAAK,EAAE,WAAW,CAAC,KAAK;KACzB,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAW,KAAK,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,UAAU,GAAG,EAAE,EAAE,EAAE;IACtF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;IACtD,MAAM,UAAU,GAAG,MAAM,uBAAuB,CAAC,MAAM,CAAC,CAAA;IACxD,MAAM,SAAS,GAAG,qBAAqB,CAAC,iBAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,CAAA;IACrF,MAAM,OAAO,GAAG,MAAM,WAAW,EAAE,CAAA;IACnC,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IACjD,MAAM,KAAK,GAA4B;QACrC,SAAS,CAAC,MAAM,CAAC,IAAI;QACrB,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC;QACzC,SAAS,CAAC,MAAM,CAAC,KAAK;KACvB,CAAA;IACD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;IACvI,cAAc,GAAG,SAAS,CAAC,SAAS,CAAC,UAAU,CAAA;IAC/C,MAAM,aAAa,GAA8B,SAAS,CAAC,OAAO,CAAC,QAAQ;QACzE,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,oBAAoB,EAAE,SAAS,CAAC,OAAO,CAAC,oBAAoB,EAAE;QACxG,CAAC,CAAC,SAAS,CAAA;IACb,MAAM,cAAc,GAAG,oBAAoB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAA;IACrE,cAAc,CAAC,KAAK,EAAE,CAAA;IACtB,MAAM,UAAU,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAA;IAC/C,MAAM,YAAY,GAAiB;QACjC,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,MAAM,oBAAoB,EAAE;QACrC,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,aAAa,EAAE,SAAS,CAAC,MAAM,CAAC,QAAQ;QACxC,gBAAgB,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM;QACrC,gBAAgB,EAAE,UAAU,CAAC,MAAM;QACnC,YAAY,EAAE,MAAM,CAAC,MAAM,IAAI,yBAAyB;QACxD,GAAG,EAAE,MAAM,iBAAiB,EAAE;KAC/B,CAAA;IAED,SAAS,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CACxC,MAAM,CAAC,GAAG;SACP,GAAG,CAAC;QACH,IAAI,EAAE,EAAE,OAAO,EAAE,oBAAoB,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,GAAI,KAAgB,EAAE,EAAE;KAC5G,CAAC;SACD,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;SACrB,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IAE3B,MAAM,MAAM,CAAC,GAAG;SACb,GAAG,CAAC;QACH,IAAI,EAAE;YACJ,OAAO,EAAE,oBAAoB;YAC7B,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,gCAAgC;YACzC,KAAK,EAAE;gBACL,MAAM,EAAE,SAAS,CAAC,MAAM;gBACxB,YAAY,EAAE,MAAM,CAAC,MAAM,IAAI,yBAAyB;gBACxD,gBAAgB,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM;gBACrC,gBAAgB,EAAE,UAAU,CAAC,MAAM;gBACnC,aAAa,EAAE,SAAS,CAAC,MAAM,CAAC,QAAQ;aACzC;SACF;KACF,CAAC;SACD,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IAEzB,OAAO;QACL,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACtB,MAAM,OAAO,GAAG,KAAiC,CAAA;YACjD,OAAO,CAAC,KAAK,KAAK,EAAE,CAAA;YACpB,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACnD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;YAC9D,CAAC;YACD,OAAO,CAAC,OAAO,KAAK,EAAE,CAAA;YACtB,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,KAAK;gBACtC,WAAW,EAAE,qDAAqD;gBAClE,QAAQ,EAAE,iEAAiE;aAC5E,CAAA;YACD,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK;gBACnC,WAAW,EAAE,yDAAyD;gBACtE,QAAQ,EAAE,wEAAwE;aACnF,CAAA;YACD,OAAO,CAAC,OAAO,CAAC,SAAS,KAAK;gBAC5B,WAAW,EAAE,8CAA8C;gBAC3D,QAAQ,EAAE,2IAA2I;aACtJ,CAAA;QACH,CAAC;QACD,IAAI,EAAE,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE;YAC1D,IAAI,QAAQ,KAAK,OAAO,cAAc,CAAC,QAAQ,CAAA,CAAC,CAAC;SAClD,CAAC;QACF,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,cAAc,CAAC,IAAI,EAAE,CAAA;YACrB,aAAa,CAAC,KAAK,EAAE,CAAA;YACrB,YAAY,CAAC,KAAK,EAAE,CAAA;YACpB,eAAe,CAAC,KAAK,EAAE,CAAA;YACvB,YAAY,CAAC,KAAK,EAAE,CAAA;QACtB,CAAC;QACD,cAAc,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,EAAE;YAC9C,IAAI,CAAC,cAAc,IAAI,CAAC,SAAS;gBAAE,OAAM;YACzC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK;iBACtB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;iBACtC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;iBACxB,IAAI,CAAC,EAAE,CAAC;iBACR,IAAI,EAAE,CAAA;YACT,IAAI,IAAI,EAAE,CAAC;gBACT,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;gBAClC,WAAW,CAAC,aAAa,CAAC,CAAA;YAC5B,CAAC;QACH,CAAC;QACD,KAAK,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;YACzB,IAAI,KAAK,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;gBAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAA;gBAClC,gBAAgB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC,CAAA;gBACpE,OAAM;YACR,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB;gBAAE,OAAM;YAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAA;YAClC,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW;gBAAE,OAAM;YACrC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAClB,MAAM,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;YAClC,IAAI,cAAc,EAAE,CAAC;gBACnB,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;gBAChD,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;gBACvC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;gBACpC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;gBAC5B,IAAI,MAAM,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBAChD,MAAM,IAAI,GAAwC,EAAE,CAAA;oBACpD,IAAI,MAAM,KAAK,SAAS;wBAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;oBAC9C,IAAI,KAAK,KAAK,SAAS;wBAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;oBAC3C,MAAM,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;gBACxD,CAAC;YACH,CAAC;QACH,CAAC;QACD,GAAG,CAAC,UAAU;YACZ,CAAC,CAAC;gBACE,oCAAoC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;oBAC7D,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;gBAChC,CAAC;aACF;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAA;AACH,CAAC,CAAA;AAED,qEAAqE;AACrE,mEAAmE;AACnE,uEAAuE;AACvE,MAAM,CAAC,MAAM,MAAM,GAAW,eAAe,CAAA;AAC7C,eAAe,eAAe,CAAA"}

package/dist/plugin-status.d.ts

@@ -0,0 +1,34 @@
+export declare const PACKAGE_NAME = "@oeronteros-1/opencode-orchestra";
+/**
+ * Resolve the installed package version from `package.json`. The compiled
+ * output lives in `dist/`, so the package root is one level up. Falls back to
+ * "unknown" when the manifest cannot be read (e.g. running from an unpacked
+ * source tree without a package.json next to the dist folder).
+ */
+export declare function resolvePluginVersion(): Promise<string>;
+/**
+ * Snapshot of the plugin's own runtime state. Unlike `orchestra_status` (which
+ * reports per-session usage/escalation telemetry), this reports the plugin
+ * itself: what version is loaded, which budget/strategy are active, where the
+ * config came from, how many models were discovered, and which companion MCPs
+ * are present in the OpenCode configuration.
+ */
+export interface PluginStatus {
+    name: string;
+    version: string;
+    budget: string;
+    modelStrategy: string;
+    configuredModels: number;
+    discoveredModels: number;
+    configSource: string;
+    mcp: Record<string, boolean>;
+}
+/**
+ * Detect which companion MCPs are configured in the OpenCode main config.
+ * Mirrors the dashboard's `mcpStatus` helper without importing the HTTP server.
+ */
+export declare function detectMcpPresence(configDirectory?: string): Promise<Record<string, boolean>>;
+/**
+ * Format the plugin status snapshot as a stable, human-readable report.
+ */
+export declare function formatPluginStatus(status: PluginStatus): Promise<string>;

package/dist/plugin-status.js

@@ -0,0 +1,90 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { parse } from "jsonc-parser";
+import { openCodeConfigDirectory } from "./config/paths.js";
+export const PACKAGE_NAME = "@oeronteros-1/opencode-orchestra";
+/**
+ * Resolve the installed package version from `package.json`. The compiled
+ * output lives in `dist/`, so the package root is one level up. Falls back to
+ * "unknown" when the manifest cannot be read (e.g. running from an unpacked
+ * source tree without a package.json next to the dist folder).
+ */
+export async function resolvePluginVersion() {
+    try {
+        const here = new URL(".", import.meta.url);
+        const inline = new URL("../package.json", here);
+        const pkg = JSON.parse(await readFile(inline, "utf8"));
+        if (pkg.version)
+            return pkg.version;
+    }
+    catch {
+        // Fall through to the unknown marker.
+    }
+    return "unknown";
+}
+async function readTextOr(file, fallback) {
+    try {
+        return await readFile(file, "utf8");
+    }
+    catch {
+        return fallback;
+    }
+}
+async function findMainConfig(configDirectory) {
+    for (const name of ["opencode.json", "opencode.jsonc"]) {
+        const candidate = path.join(configDirectory, name);
+        try {
+            await readFile(candidate, "utf8");
+            return candidate;
+        }
+        catch {
+            // Try the next name.
+        }
+    }
+    return path.join(configDirectory, "opencode.json");
+}
+function parseJsonc(text) {
+    const value = parse(text, [], { allowTrailingComma: true, disallowComments: false });
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : {};
+}
+/**
+ * Detect which companion MCPs are configured in the OpenCode main config.
+ * Mirrors the dashboard's `mcpStatus` helper without importing the HTTP server.
+ */
+export async function detectMcpPresence(configDirectory = openCodeConfigDirectory()) {
+    const root = parseJsonc(await readTextOr(await findMainConfig(configDirectory), "{}"));
+    const mcp = typeof root.mcp === "object" && root.mcp !== null && !Array.isArray(root.mcp)
+        ? root.mcp
+        : {};
+    return {
+        context7: "context7" in mcp,
+        codebaseMemory: "codebase-memory" in mcp,
+        memoryGraph: "memorygraph" in mcp,
+        supermemory: "supermemory" in mcp,
+    };
+}
+/**
+ * Format the plugin status snapshot as a stable, human-readable report.
+ */
+export async function formatPluginStatus(status) {
+    const mcp = Object.entries({ ...status.mcp })
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([name, present]) => `  ${name.padEnd(24)} ${present ? "connected" : "not configured"}`)
+        .join("\n");
+    return [
+        "OpenCode Orchestra plugin status",
+        "",
+        `plugin: ${status.name}@${status.version}`,
+        `budget: ${status.budget}`,
+        `model strategy: ${status.modelStrategy}`,
+        `configured models: ${status.configuredModels}`,
+        `discovered models: ${status.discoveredModels}`,
+        `config source: ${status.configSource}`,
+        "",
+        "MCP servers:",
+        mcp || "  none detected",
+    ].join("\n");
+}
+//# sourceMappingURL=plugin-status.js.map

package/dist/plugin-status.js.map

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

package/dist/routing/budget-guard.d.ts

@@ -0,0 +1,36 @@
+import type { BudgetMode, ModelCost } from "../config/schema.js";
+/** How much paid-model spend a single work branch is allowed before we cut it. */
+export interface PaidBudgetLimit {
+    /** Maximum paid-model calls a branch may make before termination. */
+    maxPaidCalls: number;
+    /** Soft warning threshold (fraction of maxPaidCalls). */
+    warnAt: number;
+    enabled: boolean;
+}
+/**
+ * Derive a paid-call budget for a branch of work from the global budget mode.
+ * eco/balanced keep it tight (no or few paid calls); quality/ebobo open it up.
+ *
+ * "Early termination" here is budget-aware: a branch is stopped as soon as it
+ * has burned its paid-call allowance, so paid models never silently overrun.
+ */
+export declare function paidBudgetFor(mode: BudgetMode, explicit?: Partial<PaidBudgetLimit>): PaidBudgetLimit;
+export interface BudgetSnapshot {
+    paidCallsUsed: number;
+    remaining: number;
+    terminated: boolean;
+    warning: boolean;
+}
+export interface BudgetGuard {
+    /** Record a paid call and report whether the branch should stop. */
+    recordPaidCall(cost: ModelCost): BudgetSnapshot;
+    /** Current remaining paid-call allowance. */
+    remaining(): number;
+    reset(): void;
+}
+/**
+ * Guard a single work branch. Only the costs of a *paid* model advance the
+ * counter; free/subscription calls are free passes (mode already prices them
+ * in elsewhere). Once paidCallsUsed reaches the cap the branch is terminated.
+ */
+export declare function createBudgetGuard(limit: PaidBudgetLimit): BudgetGuard;

package/dist/routing/budget-guard.js

@@ -0,0 +1,52 @@
+/**
+ * Derive a paid-call budget for a branch of work from the global budget mode.
+ * eco/balanced keep it tight (no or few paid calls); quality/ebobo open it up.
+ *
+ * "Early termination" here is budget-aware: a branch is stopped as soon as it
+ * has burned its paid-call allowance, so paid models never silently overrun.
+ */
+export function paidBudgetFor(mode, explicit) {
+    const base = {
+        eco: { maxPaidCalls: 0, warnAt: 0, enabled: false },
+        balanced: { maxPaidCalls: 1, warnAt: 1, enabled: true },
+        quality: { maxPaidCalls: 6, warnAt: 0.7, enabled: true },
+        ebobo: { maxPaidCalls: 12, warnAt: 0.75, enabled: true },
+    };
+    const defaults = base[mode];
+    return {
+        ...defaults,
+        ...explicit,
+        enabled: (explicit?.enabled ?? defaults.enabled) && (explicit?.maxPaidCalls ?? defaults.maxPaidCalls) >= 0,
+    };
+}
+/**
+ * Guard a single work branch. Only the costs of a *paid* model advance the
+ * counter; free/subscription calls are free passes (mode already prices them
+ * in elsewhere). Once paidCallsUsed reaches the cap the branch is terminated.
+ */
+export function createBudgetGuard(limit) {
+    let paidCallsUsed = 0;
+    const cap = limit.maxPaidCalls;
+    const warnAt = Math.round(limit.warnAt * cap);
+    const snapshot = () => {
+        const remaining = Math.max(0, cap - paidCallsUsed);
+        return {
+            paidCallsUsed,
+            remaining,
+            terminated: cap > 0 && paidCallsUsed >= cap,
+            warning: !limit.enabled ? false : cap > 0 && paidCallsUsed >= warnAt && paidCallsUsed < cap,
+        };
+    };
+    return {
+        recordPaidCall(cost) {
+            if (cost === "paid")
+                paidCallsUsed += 1;
+            return snapshot();
+        },
+        remaining: () => Math.max(0, cap - paidCallsUsed),
+        reset() {
+            paidCallsUsed = 0;
+        },
+    };
+}
+//# sourceMappingURL=budget-guard.js.map

package/dist/routing/budget-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget-guard.js","sourceRoot":"","sources":["../../src/routing/budget-guard.ts"],"names":[],"mappings":"AAWA;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAgB,EAAE,QAAmC;IACjF,MAAM,IAAI,GAAgF;QACxF,GAAG,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE;QACnD,QAAQ,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE;QACvD,OAAO,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE;QACxD,KAAK,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;KACzD,CAAA;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3B,OAAO;QACL,GAAG,QAAQ;QACX,GAAG,QAAQ;QACX,OAAO,EAAE,CAAC,QAAQ,EAAE,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,IAAI,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC;KAC3G,CAAA;AACH,CAAC;AAiBD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAsB;IACtD,IAAI,aAAa,GAAG,CAAC,CAAA;IACrB,MAAM,GAAG,GAAG,KAAK,CAAC,YAAY,CAAA;IAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAA;IAE7C,MAAM,QAAQ,GAAG,GAAmB,EAAE;QACpC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,aAAa,CAAC,CAAA;QAClD,OAAO;YACL,aAAa;YACb,SAAS;YACT,UAAU,EAAE,GAAG,GAAG,CAAC,IAAI,aAAa,IAAI,GAAG;YAC3C,OAAO,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,aAAa,IAAI,MAAM,IAAI,aAAa,GAAG,GAAG;SAC5F,CAAA;IACH,CAAC,CAAA;IAED,OAAO;QACL,cAAc,CAAC,IAAI;YACjB,IAAI,IAAI,KAAK,MAAM;gBAAE,aAAa,IAAI,CAAC,CAAA;YACvC,OAAO,QAAQ,EAAE,CAAA;QACnB,CAAC;QACD,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,aAAa,CAAC;QACjD,KAAK;YACH,aAAa,GAAG,CAAC,CAAA;QACnB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/routing/classifier-cache.d.ts

@@ -0,0 +1,25 @@
+import type { Classification } from "./classifier.js";
+/**
+ * Memoized classification cache: near-duplicate tasks reuse a previous
+ * classification instead of re-running the (judge-token-burning) classifier.
+ * Content-addressed by a normalized fingerprint and LRU-bounded in process.
+ */
+export interface CacheEntry {
+    key: string;
+    classification: Classification;
+    createdAt: number;
+    hits: number;
+    lastHit: number;
+}
+export interface ClassifierCacheOptions {
+    maxEntries?: number;
+}
+/** Normalize a task into a stable fingerprint (case/punct/whitespace folding). */
+export declare function fingerprint(task: string): string;
+export declare function createClassifierCache(options?: ClassifierCacheOptions): {
+    get(task: string): Classification | undefined;
+    set(task: string, classification: Classification): void;
+    clear(): void;
+    size: () => number;
+};
+export type ClassifierCache = ReturnType<typeof createClassifierCache>;

package/dist/routing/classifier-cache.js

@@ -0,0 +1,46 @@
+/** Normalize a task into a stable fingerprint (case/punct/whitespace folding). */
+export function fingerprint(task) {
+    return task
+        .toLowerCase()
+        .normalize("NFKC")
+        .replace(/[^\p{L}\p{N}\s]/gu, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+export function createClassifierCache(options = {}) {
+    const maxEntries = options.maxEntries ?? 256;
+    const map = new Map();
+    function touch(entry) {
+        map.delete(entry.key);
+        map.set(entry.key, entry);
+    }
+    return {
+        get(task) {
+            const key = fingerprint(task);
+            const entry = map.get(key);
+            if (!entry)
+                return undefined;
+            entry.hits += 1;
+            entry.lastHit = Date.now();
+            touch(entry);
+            return entry.classification;
+        },
+        set(task, classification) {
+            const key = fingerprint(task);
+            const now = Date.now();
+            const entry = { key, classification, createdAt: now, hits: 0, lastHit: now };
+            map.set(key, entry);
+            while (map.size > maxEntries) {
+                const oldest = map.keys().next().value;
+                if (oldest === undefined)
+                    break;
+                map.delete(oldest);
+            }
+        },
+        clear() {
+            map.clear();
+        },
+        size: () => map.size,
+    };
+}
+//# sourceMappingURL=classifier-cache.js.map

package/dist/routing/classifier-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier-cache.js","sourceRoot":"","sources":["../../src/routing/classifier-cache.ts"],"names":[],"mappings":"AAoBA,kFAAkF;AAClF,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI;SACR,WAAW,EAAE;SACb,SAAS,CAAC,MAAM,CAAC;SACjB,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC;SACjC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAA;AACX,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,UAAkC,EAAE;IACxE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,GAAG,CAAA;IAC5C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAsB,CAAA;IAEzC,SAAS,KAAK,CAAC,KAAiB;QAC9B,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACrB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IAC3B,CAAC;IAED,OAAO;QACL,GAAG,CAAC,IAAY;YACd,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;YAC7B,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YAC1B,IAAI,CAAC,KAAK;gBAAE,OAAO,SAAS,CAAA;YAC5B,KAAK,CAAC,IAAI,IAAI,CAAC,CAAA;YACf,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YAC1B,KAAK,CAAC,KAAK,CAAC,CAAA;YACZ,OAAO,KAAK,CAAC,cAAc,CAAA;QAC7B,CAAC;QACD,GAAG,CAAC,IAAY,EAAE,cAA8B;YAC9C,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;YAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YACtB,MAAM,KAAK,GAAe,EAAE,GAAG,EAAE,cAAc,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAA;YACxF,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YACnB,OAAO,GAAG,CAAC,IAAI,GAAG,UAAU,EAAE,CAAC;gBAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAA;gBACtC,IAAI,MAAM,KAAK,SAAS;oBAAE,MAAK;gBAC/B,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;YACpB,CAAC;QACH,CAAC;QACD,KAAK;YACH,GAAG,CAAC,KAAK,EAAE,CAAA;QACb,CAAC;QACD,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI;KACrB,CAAA;AACH,CAAC"}

package/dist/routing/fallback.d.ts

@@ -0,0 +1,41 @@
+import type { BudgetMode, ModelCandidateInput, ModelCost } from "../config/schema.js";
+import { resolveModel } from "./model-resolver.js";
+export interface FallbackEntry {
+    id: string;
+    cost: ModelCost;
+    /** Lower is cheaper; used to prefer cheaper fallbacks after a failure. */
+    costRank: number;
+}
+export interface FallbackChain {
+    /** The winning model id (first choice). */
+    primary: string;
+    /** Ordered cheaper alternatives after the primary. */
+    alternatives: FallbackEntry[];
+    /** All entries (primary + alternatives) in failover order. */
+    all: FallbackEntry[];
+}
+interface RetryableError {
+    /** HTTP status or "timeout". Rate-limit (429) and 5xx are retryable. */
+    kind: "rate-limit" | "server" | "timeout" | "other";
+}
+/**
+ * Classify an error into retryable categories. A retryable failure should
+ * trigger failover to a cheaper model in the chain.
+ */
+export declare function classifyError(error: unknown): RetryableError;
+export declare function isRetryable(kind: RetryableError["kind"]): boolean;
+/**
+ * Build a failover chain for a capability pool. The primary is the current
+ * winner; alternatives are the remaining candidates sorted by increasing cost
+ * (cheaper first), so a retry steps down in price instead of up.
+ */
+export declare function buildFallbackChain(pool: ModelCandidateInput[], capability: Parameters<typeof resolveModel>[0]["capability"], budget: BudgetMode, allowPaid: boolean, options?: {
+    preferredCosts?: ModelCost[];
+    preferredTiers?: Parameters<typeof resolveModel>[0]["preferredTiers"];
+}): FallbackChain | undefined;
+/**
+ * Given a chain and the id of a model that just failed, return the next
+ * cheaper alternative to try, or undefined when the chain is exhausted.
+ */
+export declare function nextAfterFailure(chain: FallbackChain, failedId: string): string | undefined;
+export {};

package/dist/routing/fallback.js

@@ -0,0 +1,81 @@
+import { normalizeCandidate, resolveModel } from "./model-resolver.js";
+const COST_RANK = { paid: 2, subscription: 1, free: 0 };
+/**
+ * Classify an error into retryable categories. A retryable failure should
+ * trigger failover to a cheaper model in the chain.
+ */
+export function classifyError(error) {
+    const candidate = typeof error === "object" && error !== null ? error : undefined;
+    const message = typeof error === "string"
+        ? error
+        : candidate?.message
+            ? String(candidate.message)
+            : error instanceof Error
+                ? error.message
+                : String(error);
+    const status = candidate?.status ?? candidate?.statusCode;
+    const text = (status !== undefined ? String(status) + " " : "") + message.toLowerCase();
+    if (status === 429 || text.includes("429") || text.includes("rate limit") || text.includes("rate-limit") || text.includes("too many requests")) {
+        return { kind: "rate-limit" };
+    }
+    if (status === 408 || text.includes("timeout") || text.includes("timed out")) {
+        return { kind: "timeout" };
+    }
+    if ((status !== undefined && status >= 500) || text.includes("internal server error") || text.includes("service unavailable") || text.includes("overloaded")) {
+        return { kind: "server" };
+    }
+    return { kind: "other" };
+}
+export function isRetryable(kind) {
+    return kind === "rate-limit" || kind === "server" || kind === "timeout";
+}
+/**
+ * Build a failover chain for a capability pool. The primary is the current
+ * winner; alternatives are the remaining candidates sorted by increasing cost
+ * (cheaper first), so a retry steps down in price instead of up.
+ */
+export function buildFallbackChain(pool, capability, budget, allowPaid, options = {}) {
+    const normalized = pool.map(normalizeCandidate);
+    if (normalized.length === 0)
+        return undefined;
+    const winner = resolveModel({
+        pool,
+        capability,
+        budget,
+        allowPaid,
+        ...(options.preferredCosts ? { preferredCosts: options.preferredCosts } : {}),
+        ...(options.preferredTiers ? { preferredTiers: options.preferredTiers } : {}),
+    });
+    const primary = winner?.id ?? normalized[0]?.id;
+    if (!primary)
+        return undefined;
+    const byId = new Map(normalized.map((candidate) => [candidate.id, candidate]));
+    const primaryEntry = toEntry(byId.get(primary));
+    const alternatives = normalized
+        .filter((candidate) => candidate.id !== primary)
+        .sort((a, b) => COST_RANK[a.cost] - COST_RANK[b.cost] || a.id.localeCompare(b.id))
+        .map((candidate) => toEntry(candidate));
+    return {
+        primary,
+        alternatives,
+        all: primaryEntry ? [primaryEntry, ...alternatives] : alternatives,
+    };
+}
+function toEntry(candidate) {
+    return {
+        id: candidate?.id ?? "",
+        cost: candidate?.cost ?? "free",
+        costRank: COST_RANK[candidate?.cost ?? "free"],
+    };
+}
+/**
+ * Given a chain and the id of a model that just failed, return the next
+ * cheaper alternative to try, or undefined when the chain is exhausted.
+ */
+export function nextAfterFailure(chain, failedId) {
+    const index = chain.all.findIndex((entry) => entry.id === failedId);
+    if (index < 0)
+        return undefined;
+    return chain.all[index + 1]?.id;
+}
+//# sourceMappingURL=fallback.js.map

package/dist/routing/fallback.js.map

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