@zhixuan92/multi-model-agent-core 0.1.0 → 0.2.0

package/README.md

@@ -10,12 +10,6 @@ This is the building-block library. If you just want to run the MCP server, inst
 npm install @zhixuan92/multi-model-agent-core
 ```
 
-If you plan to use `openai-compatible` providers, also install the optional peer dependencies:
-
-```bash
-npm install @openai/agents openai
-```
-
 Requires Node `>= 22`. ESM only.
 
 ## What's exported

package/dist/config/schema.d.ts

@@ -26,6 +26,9 @@ export declare const codexProviderConfigSchema: z.ZodObject<{
         high: "high";
         free: "free";
     }>>;
+    inputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+    outputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+    inputTokenSoftLimit: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export declare const claudeProviderConfigSchema: z.ZodObject<{
     type: z.ZodLiteral<"claude">;
@@ -53,6 +56,9 @@ export declare const claudeProviderConfigSchema: z.ZodObject<{
         high: "high";
         free: "free";
     }>>;
+    inputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+    outputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+    inputTokenSoftLimit: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export declare const openAICompatibleProviderConfigSchema: z.ZodObject<{
     type: z.ZodLiteral<"openai-compatible">;
@@ -83,6 +89,9 @@ export declare const openAICompatibleProviderConfigSchema: z.ZodObject<{
         high: "high";
         free: "free";
     }>>;
+    inputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+    outputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+    inputTokenSoftLimit: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export declare const providerConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"codex">;
@@ -110,6 +119,9 @@ export declare const providerConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
         high: "high";
         free: "free";
     }>>;
+    inputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+    outputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+    inputTokenSoftLimit: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"claude">;
     model: z.ZodString;
@@ -136,6 +148,9 @@ export declare const providerConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
         high: "high";
         free: "free";
     }>>;
+    inputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+    outputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+    inputTokenSoftLimit: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"openai-compatible">;
     model: z.ZodString;
@@ -165,6 +180,9 @@ export declare const providerConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
         high: "high";
         free: "free";
     }>>;
+    inputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+    outputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+    inputTokenSoftLimit: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>], "type">;
 export declare const multiModelConfigSchema: z.ZodObject<{
     providers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -193,6 +211,9 @@ export declare const multiModelConfigSchema: z.ZodObject<{
             high: "high";
             free: "free";
         }>>;
+        inputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+        outputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+        inputTokenSoftLimit: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"claude">;
         model: z.ZodString;
@@ -219,6 +240,9 @@ export declare const multiModelConfigSchema: z.ZodObject<{
             high: "high";
             free: "free";
         }>>;
+        inputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+        outputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+        inputTokenSoftLimit: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"openai-compatible">;
         model: z.ZodString;
@@ -248,6 +272,9 @@ export declare const multiModelConfigSchema: z.ZodObject<{
             high: "high";
             free: "free";
         }>>;
+        inputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+        outputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+        inputTokenSoftLimit: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>], "type">>>;
     defaults: z.ZodDefault<z.ZodObject<{
         maxTurns: z.ZodDefault<z.ZodNumber>;

package/dist/config/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAGV,gBAAgB,EAGjB,MAAM,aAAa,CAAC;AASrB,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;iBASpC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;iBASrC,CAAC;AAEH,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAY/C,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAI/B,CAAC;AAUH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGjC,CAAC;AAEH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,gBAAgB,CAAA;IACxB,OAAO,EAAE,IAAI,CAAA;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,KAAK,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,MAAM,iBAAiB,GAAG,mBAAmB,GAAG,mBAAmB,CAAA;AAEzE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAE1D"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAGV,gBAAgB,EAGjB,MAAM,aAAa,CAAC;AAarB,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAYpC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAYrC,CAAC;AAEH,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAe/C,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAI/B,CAAC;AAUH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGjC,CAAC;AAEH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,gBAAgB,CAAA;IACxB,OAAO,EAAE,IAAI,CAAA;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,KAAK,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,MAAM,iBAAiB,GAAG,mBAAmB,GAAG,mBAAmB,CAAA;AAEzE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAE1D"}

package/dist/config/schema.js

@@ -4,6 +4,10 @@ const effortSchema = z.enum(['none', 'low', 'medium', 'high']);
 const costTierSchema = z.enum(['free', 'low', 'medium', 'high']);
 const hostedToolsSchema = z.array(z.enum(['web_search', 'image_generation', 'code_interpreter']));
 const sandboxPolicySchema = z.enum(['none', 'cwd-only']).optional();
+// Per-million-token pricing for cost computation. Must be non-negative; zero
+// is allowed (free providers can set both rates to 0 to get a deterministic
+// costUSD: 0 instead of null).
+const tokenCostSchema = z.number().nonnegative().finite().optional();
 export const codexProviderConfigSchema = z.object({
     type: z.literal('codex'),
     model: z.string(),
@@ -13,6 +17,9 @@ export const codexProviderConfigSchema = z.object({
     sandboxPolicy: sandboxPolicySchema,
     hostedTools: hostedToolsSchema.optional(),
     costTier: costTierSchema.optional(),
+    inputCostPerMTok: tokenCostSchema,
+    outputCostPerMTok: tokenCostSchema,
+    inputTokenSoftLimit: z.number().int().positive().optional(),
 });
 export const claudeProviderConfigSchema = z.object({
     type: z.literal('claude'),
@@ -23,6 +30,9 @@ export const claudeProviderConfigSchema = z.object({
     sandboxPolicy: sandboxPolicySchema,
     hostedTools: hostedToolsSchema.optional(),
     costTier: costTierSchema.optional(),
+    inputCostPerMTok: tokenCostSchema,
+    outputCostPerMTok: tokenCostSchema,
+    inputTokenSoftLimit: z.number().int().positive().optional(),
 });
 export const openAICompatibleProviderConfigSchema = z.object({
     type: z.literal('openai-compatible'),
@@ -36,6 +46,9 @@ export const openAICompatibleProviderConfigSchema = z.object({
     sandboxPolicy: sandboxPolicySchema,
     hostedTools: hostedToolsSchema.optional(),
     costTier: costTierSchema.optional(),
+    inputCostPerMTok: tokenCostSchema,
+    outputCostPerMTok: tokenCostSchema,
+    inputTokenSoftLimit: z.number().int().positive().optional(),
 });
 export const providerConfigSchema = z.discriminatedUnion('type', [
     codexProviderConfigSchema,

package/dist/config/schema.js.map

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

package/dist/context/context-block-store.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Metadata describing a successful `register(...)` call. The orchestrator
+ * and MCP tool surfaces return this to the caller so they can reference
+ * the stored block later (by id) and independently verify its content
+ * (via sha256).
+ */
+export interface RegisteredBlock {
+    id: string;
+    lengthChars: number;
+    sha256: string;
+}
+/**
+ * Minimal store contract for reusable context blocks.
+ *
+ * The intent is to let a caller register a large brief once, then reference
+ * it by id from many subsequent dispatches without re-transmitting the
+ * content on every call. See `expandContextBlocks` for the resolution
+ * step that turns `TaskSpec.contextBlockIds` into prompt text.
+ */
+export interface ContextBlockStore {
+    /** Store `content` under an explicit id (idempotent replace) or a new
+     *  UUID. Returns the id, length, and sha256 hash. */
+    register(content: string, opts?: {
+        id?: string;
+    }): RegisteredBlock;
+    /** Fetch content by id. Returns `undefined` if the id is unknown or
+     *  the entry has expired. Touches the LRU access time on success. */
+    get(id: string): string | undefined;
+    /** Delete an entry. Returns `true` if the entry existed. */
+    delete(id: string): boolean;
+}
+/**
+ * Thrown by `expandContextBlocks` when a task references a block id that
+ * cannot be resolved against the store (missing, expired, or evicted).
+ * Callers are expected to surface this to the user so they can re-register
+ * the block and retry.
+ */
+export declare class ContextBlockNotFoundError extends Error {
+    readonly id: string;
+    constructor(id: string);
+}
+export interface InMemoryContextBlockStoreOptions {
+    /** TTL in milliseconds. Defaults to 30 minutes. */
+    ttlMs?: number;
+    /** Max number of entries before LRU eviction. Defaults to 100. */
+    maxEntries?: number;
+}
+/**
+ * In-memory implementation with two bounds:
+ *   1. A TTL (time-to-live) from `addedAtMs` — checked lazily on `get`.
+ *   2. An LRU cap on entry count — enforced eagerly after every `register`.
+ *
+ * Both bounds are intentional: the TTL prevents stale briefs from lingering
+ * after a long-running session; the LRU cap prevents memory growth from a
+ * chatty caller that never explicitly deletes anything. The eviction loop
+ * is O(n) per insertion but `n <= maxEntries` (defaults to 100), so we
+ * keep the implementation simple.
+ *
+ * `Date.now()` is read directly (not through a clock abstraction) so tests
+ * can drive time forward with Vitest's fake timers.
+ */
+export declare class InMemoryContextBlockStore implements ContextBlockStore {
+    private entries;
+    private ttlMs;
+    private maxEntries;
+    private tick;
+    constructor(opts?: InMemoryContextBlockStoreOptions);
+    register(content: string, opts?: {
+        id?: string;
+    }): RegisteredBlock;
+    get(id: string): string | undefined;
+    delete(id: string): boolean;
+    private evictIfOverBound;
+}
+//# sourceMappingURL=context-block-store.d.ts.map

package/dist/context/context-block-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-block-store.d.ts","sourceRoot":"","sources":["../../src/context/context-block-store.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC;yDACqD;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe,CAAC;IACnE;yEACqE;IACrE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACpC,4DAA4D;IAC5D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7B;AAED;;;;;GAKG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;aACtB,EAAE,EAAE,MAAM;gBAAV,EAAE,EAAE,MAAM;CAIvC;AAcD,MAAM,WAAW,gCAAgC;IAC/C,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,yBAA0B,YAAW,iBAAiB;IACjE,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,IAAI,CAAK;gBAEL,IAAI,GAAE,gCAAqC;IAKvD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,eAAe;IAYtE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAYnC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI3B,OAAO,CAAC,gBAAgB;CAczB"}

package/dist/context/context-block-store.js

@@ -0,0 +1,82 @@
+import { createHash, randomUUID } from 'node:crypto';
+/**
+ * Thrown by `expandContextBlocks` when a task references a block id that
+ * cannot be resolved against the store (missing, expired, or evicted).
+ * Callers are expected to surface this to the user so they can re-register
+ * the block and retry.
+ */
+export class ContextBlockNotFoundError extends Error {
+    id;
+    constructor(id) {
+        super(`context block "${id}" is unknown or expired`);
+        this.id = id;
+        this.name = 'ContextBlockNotFoundError';
+    }
+}
+/**
+ * In-memory implementation with two bounds:
+ *   1. A TTL (time-to-live) from `addedAtMs` — checked lazily on `get`.
+ *   2. An LRU cap on entry count — enforced eagerly after every `register`.
+ *
+ * Both bounds are intentional: the TTL prevents stale briefs from lingering
+ * after a long-running session; the LRU cap prevents memory growth from a
+ * chatty caller that never explicitly deletes anything. The eviction loop
+ * is O(n) per insertion but `n <= maxEntries` (defaults to 100), so we
+ * keep the implementation simple.
+ *
+ * `Date.now()` is read directly (not through a clock abstraction) so tests
+ * can drive time forward with Vitest's fake timers.
+ */
+export class InMemoryContextBlockStore {
+    entries = new Map();
+    ttlMs;
+    maxEntries;
+    tick = 0;
+    constructor(opts = {}) {
+        this.ttlMs = opts.ttlMs ?? 30 * 60 * 1000;
+        this.maxEntries = opts.maxEntries ?? 100;
+    }
+    register(content, opts = {}) {
+        const id = opts.id ?? randomUUID();
+        const now = Date.now();
+        this.entries.set(id, { content, addedAtMs: now, lastAccessTick: ++this.tick });
+        this.evictIfOverBound();
+        return {
+            id,
+            lengthChars: content.length,
+            sha256: createHash('sha256').update(content).digest('hex'),
+        };
+    }
+    get(id) {
+        const entry = this.entries.get(id);
+        if (!entry)
+            return undefined;
+        const now = Date.now();
+        if (now - entry.addedAtMs > this.ttlMs) {
+            this.entries.delete(id);
+            return undefined;
+        }
+        entry.lastAccessTick = ++this.tick;
+        return entry.content;
+    }
+    delete(id) {
+        return this.entries.delete(id);
+    }
+    evictIfOverBound() {
+        while (this.entries.size > this.maxEntries) {
+            let oldestId;
+            let oldestTick = Infinity;
+            for (const [id, entry] of this.entries) {
+                if (entry.lastAccessTick < oldestTick) {
+                    oldestTick = entry.lastAccessTick;
+                    oldestId = id;
+                }
+            }
+            if (oldestId)
+                this.entries.delete(oldestId);
+            else
+                break;
+        }
+    }
+}
+//# sourceMappingURL=context-block-store.js.map

package/dist/context/context-block-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-block-store.js","sourceRoot":"","sources":["../../src/context/context-block-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAiCrD;;;;;GAKG;AACH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IACtB;IAA5B,YAA4B,EAAU;QACpC,KAAK,CAAC,kBAAkB,EAAE,yBAAyB,CAAC,CAAC;QAD3B,OAAE,GAAF,EAAE,CAAQ;QAEpC,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAqBD;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,yBAAyB;IAC5B,OAAO,GAAG,IAAI,GAAG,EAAiB,CAAC;IACnC,KAAK,CAAS;IACd,UAAU,CAAS;IACnB,IAAI,GAAG,CAAC,CAAC;IAEjB,YAAY,OAAyC,EAAE;QACrD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAC1C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC;IAC3C,CAAC;IAED,QAAQ,CAAC,OAAe,EAAE,OAAwB,EAAE;QAClD,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,cAAc,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/E,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,OAAO;YACL,EAAE;YACF,WAAW,EAAE,OAAO,CAAC,MAAM;YAC3B,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC3D,CAAC;IACJ,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YACvC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACxB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,KAAK,CAAC,cAAc,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC;QACnC,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;IAEO,gBAAgB;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAC3C,IAAI,QAA4B,CAAC;YACjC,IAAI,UAAU,GAAG,QAAQ,CAAC;YAC1B,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACvC,IAAI,KAAK,CAAC,cAAc,GAAG,UAAU,EAAE,CAAC;oBACtC,UAAU,GAAG,KAAK,CAAC,cAAc,CAAC;oBAClC,QAAQ,GAAG,EAAE,CAAC;gBAChB,CAAC;YACH,CAAC;YACD,IAAI,QAAQ;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;;gBACvC,MAAM;QACb,CAAC;IACH,CAAC;CACF"}

package/dist/context/expand-context-blocks.d.ts

@@ -0,0 +1,20 @@
+import { type ContextBlockStore } from './context-block-store.js';
+import type { TaskSpec } from '../types.js';
+/**
+ * Expands a task's `contextBlockIds` against a `ContextBlockStore`,
+ * returning a NEW `TaskSpec` whose `prompt` has the resolved blocks
+ * prepended (in the order they appear in `contextBlockIds`) with
+ * `SEPARATOR` between each block and before the original prompt.
+ *
+ * The returned task has `contextBlockIds` removed so downstream code
+ * cannot accidentally double-expand.
+ *
+ * If the task has no `contextBlockIds` (or the array is empty), or if
+ * no store is provided, the task is returned unchanged — the caller
+ * does not have to special-case the no-op path.
+ *
+ * Throws `ContextBlockNotFoundError` synchronously on the first missing
+ * id so the caller gets a clear error pointing to the offending block.
+ */
+export declare function expandContextBlocks(task: TaskSpec, store: ContextBlockStore | undefined): TaskSpec;
+//# sourceMappingURL=expand-context-blocks.d.ts.map

package/dist/context/expand-context-blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand-context-blocks.d.ts","sourceRoot":"","sources":["../../src/context/expand-context-blocks.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAU5C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,iBAAiB,GAAG,SAAS,GACnC,QAAQ,CAoBV"}

package/dist/context/expand-context-blocks.js

@@ -0,0 +1,46 @@
+import { ContextBlockNotFoundError } from './context-block-store.js';
+/**
+ * Separator inserted between resolved blocks and between the last block
+ * and the original prompt. Exact string is load-bearing — tests assert on
+ * it, and the hash inputs in `onInitialRequest` depend on the rendered
+ * prompt being byte-stable across dispatches.
+ */
+const SEPARATOR = '\n\n---\n\n';
+/**
+ * Expands a task's `contextBlockIds` against a `ContextBlockStore`,
+ * returning a NEW `TaskSpec` whose `prompt` has the resolved blocks
+ * prepended (in the order they appear in `contextBlockIds`) with
+ * `SEPARATOR` between each block and before the original prompt.
+ *
+ * The returned task has `contextBlockIds` removed so downstream code
+ * cannot accidentally double-expand.
+ *
+ * If the task has no `contextBlockIds` (or the array is empty), or if
+ * no store is provided, the task is returned unchanged — the caller
+ * does not have to special-case the no-op path.
+ *
+ * Throws `ContextBlockNotFoundError` synchronously on the first missing
+ * id so the caller gets a clear error pointing to the offending block.
+ */
+export function expandContextBlocks(task, store) {
+    if (!task.contextBlockIds || task.contextBlockIds.length === 0)
+        return task;
+    if (!store)
+        return task;
+    const blocks = [];
+    for (const id of task.contextBlockIds) {
+        const content = store.get(id);
+        if (content === undefined) {
+            throw new ContextBlockNotFoundError(id);
+        }
+        blocks.push(content);
+    }
+    const expanded = blocks.join(SEPARATOR) + SEPARATOR + task.prompt;
+    // Strip contextBlockIds from the returned task so a second pass through
+    // expandContextBlocks is a no-op (defence in depth against double-
+    // expansion if runtime-plumbing calls it twice).
+    const { contextBlockIds, ...rest } = task;
+    void contextBlockIds;
+    return { ...rest, prompt: expanded };
+}
+//# sourceMappingURL=expand-context-blocks.js.map

package/dist/context/expand-context-blocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand-context-blocks.js","sourceRoot":"","sources":["../../src/context/expand-context-blocks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAA0B,MAAM,0BAA0B,CAAC;AAG7F;;;;;GAKG;AACH,MAAM,SAAS,GAAG,aAAa,CAAC;AAEhC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAc,EACd,KAAoC;IAEpC,IAAI,CAAC,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5E,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,IAAI,yBAAyB,CAAC,EAAE,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC;IAClE,wEAAwE;IACxE,mEAAmE;IACnE,iDAAiD;IACjD,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;IAC1C,KAAK,eAAe,CAAC;IACrB,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACvC,CAAC"}

package/dist/delegate-with-escalation.d.ts

@@ -0,0 +1,34 @@
+import type { TaskSpec, RunResult, Provider, MultiModelConfig, ProgressEvent } from './types.js';
+export interface DelegateOptions {
+    /** When true, the orchestrator does not walk the chain on failure —
+     *  the first (and only) provider's result is returned as-is. */
+    explicitlyPinned?: boolean;
+    /** Optional in-flight progress sink. When provided, it is threaded into
+     *  every `provider.run(...)` call so runners can emit turn/tool/injection
+     *  events, and the orchestrator itself emits one `escalation_start` event
+     *  between attempts whenever it hops to the next provider in the chain.
+     *  The callback MUST NOT throw. See `ProgressEvent` for variants. */
+    onProgress?: (event: ProgressEvent) => void;
+}
+/**
+ * Build the escalation chain for an auto-routed task. Returns all eligible
+ * providers sorted cheapest-first with alphabetical tiebreak — this mirrors
+ * `selectProviderForTask`'s ordering so the first element of the chain is the
+ * same provider auto-routing would have picked.
+ *
+ * Eligibility (capability + tier filters) is handled entirely by
+ * `getProviderEligibility`; we just drop the ineligible entries.
+ */
+export declare function buildEscalationChain(task: TaskSpec, config: MultiModelConfig): Provider[];
+/**
+ * Walks the provider chain for an auto-routed task. Returns the first
+ * successful result; if all attempts fail, returns the best salvageable
+ * output (longest non-empty) with status 'incomplete' and the full
+ * escalation log.
+ *
+ * For explicitly-pinned tasks, the chain has length 1 and there is no
+ * walking — the pinned provider's result is returned as-is. See spec
+ * Part A.4.
+ */
+export declare function delegateWithEscalation(task: TaskSpec, chain: Provider[], options?: DelegateOptions): Promise<RunResult>;
+//# sourceMappingURL=delegate-with-escalation.d.ts.map

package/dist/delegate-with-escalation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegate-with-escalation.d.ts","sourceRoot":"","sources":["../src/delegate-with-escalation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,SAAS,EACT,QAAQ,EAER,gBAAgB,EAEhB,aAAa,EACd,MAAM,YAAY,CAAC;AAKpB,MAAM,WAAW,eAAe;IAC9B;oEACgE;IAChE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;yEAIqE;IACrE,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;CAC7C;AASD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,gBAAgB,GACvB,QAAQ,EAAE,CAYZ;AAED;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,QAAQ,EAAE,EACjB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,SAAS,CAAC,CA4IpB"}

package/dist/delegate-with-escalation.js

@@ -0,0 +1,168 @@
+import { createProvider } from './provider.js';
+import { getProviderEligibility } from './routing/get-provider-eligibility.js';
+import { getEffectiveCostTier } from './routing/model-profiles.js';
+// NOTE: must stay byte-identical to the ordering in
+// routing/select-provider-for-task.ts so the head of the escalation chain is
+// the same provider auto-routing would have picked. If you change one, change
+// both.
+const COST_ORDER = { free: 0, low: 1, medium: 2, high: 3 };
+/**
+ * Build the escalation chain for an auto-routed task. Returns all eligible
+ * providers sorted cheapest-first with alphabetical tiebreak — this mirrors
+ * `selectProviderForTask`'s ordering so the first element of the chain is the
+ * same provider auto-routing would have picked.
+ *
+ * Eligibility (capability + tier filters) is handled entirely by
+ * `getProviderEligibility`; we just drop the ineligible entries.
+ */
+export function buildEscalationChain(task, config) {
+    const eligibility = getProviderEligibility(task, config);
+    const eligible = eligibility.filter((e) => e.eligible);
+    eligible.sort((a, b) => {
+        const aTier = COST_ORDER[getEffectiveCostTier(a.config)] ?? 3;
+        const bTier = COST_ORDER[getEffectiveCostTier(b.config)] ?? 3;
+        if (aTier !== bTier)
+            return aTier - bTier;
+        return a.name.localeCompare(b.name);
+    });
+    return eligible.map((e) => createProvider(e.name, config));
+}
+/**
+ * Walks the provider chain for an auto-routed task. Returns the first
+ * successful result; if all attempts fail, returns the best salvageable
+ * output (longest non-empty) with status 'incomplete' and the full
+ * escalation log.
+ *
+ * For explicitly-pinned tasks, the chain has length 1 and there is no
+ * walking — the pinned provider's result is returned as-is. See spec
+ * Part A.4.
+ */
+export async function delegateWithEscalation(task, chain, options = {}) {
+    if (chain.length === 0) {
+        throw new Error('delegateWithEscalation called with empty chain');
+    }
+    // Wrap the user-supplied sink with try/catch so a throwing callback can
+    // never corrupt a task. The contract says callbacks MUST NOT throw, but
+    // Tasks 9-11 will call this from hot runner loops — defense in depth.
+    // This wrapper is also the callback handed to `provider.run`, so runner
+    // emissions are covered by the same guard.
+    const safeSink = options.onProgress
+        ? (event) => {
+            try {
+                options.onProgress(event);
+            }
+            catch {
+                // Swallow — a broken sink must not affect dispatch.
+            }
+        }
+        : undefined;
+    const attempts = [];
+    for (let i = 0; i < chain.length; i++) {
+        const provider = chain[i];
+        // Emit one `escalation_start` between attempts (never before the first).
+        // The previous attempt's record is guaranteed to exist here because i>0.
+        if (i > 0 && safeSink) {
+            const prev = attempts[attempts.length - 1].record;
+            safeSink({
+                kind: 'escalation_start',
+                previousProvider: prev.provider,
+                previousReason: prev.reason ?? `status=${prev.status}`,
+                nextProvider: provider.name,
+            });
+        }
+        // Per-attempt metadata captured via the runner's `onInitialRequest`
+        // callback. Reset inside the loop so a subsequent escalation hop
+        // starts fresh. The runner invokes this exactly once per attempt
+        // (Task 12). We wrap assignment in try/catch at the runner site, but
+        // assigning to these locals cannot itself throw.
+        let initialPromptLengthChars = 0;
+        let initialPromptHash = '';
+        const result = await provider.run(task.prompt, {
+            tools: task.tools,
+            maxTurns: task.maxTurns,
+            timeoutMs: task.timeoutMs,
+            cwd: task.cwd,
+            effort: task.effort,
+            sandboxPolicy: task.sandboxPolicy,
+            onProgress: safeSink,
+            onInitialRequest: (meta) => {
+                initialPromptLengthChars = meta.lengthChars;
+                initialPromptHash = meta.sha256;
+            },
+        });
+        const record = {
+            provider: provider.name,
+            status: result.status,
+            turns: result.turns,
+            inputTokens: result.usage.inputTokens,
+            outputTokens: result.usage.outputTokens,
+            costUSD: result.usage.costUSD,
+            initialPromptLengthChars,
+            initialPromptHash,
+            // Use `||` (not `??`) so an empty-string error falls through to the
+            // status sentinel — an empty `reason` would be indistinguishable from
+            // an `ok` row in the escalation log.
+            reason: result.status === 'ok'
+                ? undefined
+                : (result.error || `status=${result.status}`),
+        };
+        attempts.push({ result, record });
+        if (result.status === 'ok') {
+            return {
+                ...result,
+                escalationLog: attempts.map((a) => a.record),
+            };
+        }
+        // Pinned: stop after the first attempt regardless of status.
+        if (options.explicitlyPinned) {
+            return {
+                ...result,
+                escalationLog: attempts.map((a) => a.record),
+            };
+        }
+    }
+    // All providers failed. Return the best salvageable output.
+    //
+    // Two-tier selection based on `RunResult.outputIsDiagnostic`:
+    //
+    //   Tier 1 (preferred): attempts whose `output` contains real
+    //   model-produced content — a clean final answer (on `ok`, but
+    //   `ok` short-circuits above so we never see one here) or
+    //   `scratchpad.latest()` text that the runner actually buffered
+    //   before termination. These are flagged `outputIsDiagnostic: false`.
+    //
+    //   Tier 2 (fallback): attempts whose `output` is a runner-synthesized
+    //   diagnostic template (`"Sub-agent error: …"`, `"Agent timed out…"`,
+    //   `buildXxxIncompleteDiagnostic(...)`, etc.) because the scratchpad
+    //   was empty at termination. These are `outputIsDiagnostic: true`.
+    //
+    // Why: status alone is NOT enough. Two `incomplete` attempts can both
+    // exist where one has genuine scratchpad content and the other has
+    // just the diagnostic template — picking by raw output length would
+    // silently discard the real work in favor of a longer diagnostic.
+    // Likewise a late `api_error` attempt with a long
+    // `"Sub-agent error: <stack trace>"` would beat an earlier
+    // `incomplete` attempt with a shorter genuine partial.
+    //
+    // Within each tier we still pick the longest output, because a
+    // longer genuine salvage is usually more useful than a shorter one,
+    // and among pure-diagnostic attempts a longer diagnostic usually
+    // carries more debugging signal than a shorter one.
+    //
+    // Note: the `ok` short-circuit above means every entry here is non-ok,
+    // so the status-remap below is defensive only.
+    const realContentAttempts = attempts.filter((a) => !a.result.outputIsDiagnostic);
+    const pool = realContentAttempts.length > 0 ? realContentAttempts : attempts;
+    let best = pool[0].result;
+    for (const a of pool) {
+        if (a.result.output.length > best.output.length) {
+            best = a.result;
+        }
+    }
+    return {
+        ...best,
+        status: best.status === 'ok' ? 'incomplete' : best.status,
+        escalationLog: attempts.map((a) => a.record),
+    };
+}
+//# sourceMappingURL=delegate-with-escalation.js.map

package/dist/delegate-with-escalation.js.map

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

package/dist/index.d.ts

@@ -1,6 +1,9 @@
 export { loadConfigFromFile } from './config/load.js';
 export { parseConfig, multiModelConfigSchema } from './config/schema.js';
-export type { Tier, Capability, ToolMode, SandboxPolicy, Effort, CostTier, RunStatus, TaskSpec, ProviderConfig, CodexProviderConfig, ClaudeProviderConfig, OpenAICompatibleProviderConfig, MultiModelConfig, TokenUsage, RunResult, Provider, RunOptions, EligibilityFailureCheck, EligibilityFailure, ProviderEligibility, } from './types.js';
+export type { Tier, Capability, ToolMode, SandboxPolicy, Effort, CostTier, RunStatus, TaskSpec, ProviderConfig, CodexProviderConfig, ClaudeProviderConfig, OpenAICompatibleProviderConfig, MultiModelConfig, TokenUsage, RunResult, Provider, RunOptions, RunTasksRuntime, ProgressEvent, EligibilityFailureCheck, EligibilityFailure, ProviderEligibility, } from './types.js';
+export { InMemoryContextBlockStore, ContextBlockNotFoundError, } from './context/context-block-store.js';
+export type { ContextBlockStore, RegisteredBlock, InMemoryContextBlockStoreOptions, } from './context/context-block-store.js';
+export { expandContextBlocks } from './context/expand-context-blocks.js';
 export { createProvider } from './provider.js';
 export { runTasks } from './run-tasks.js';
 export { getBaseCapabilities } from './routing/capabilities.js';