@zhixuan92/multi-model-agent-core 0.1.1 → 0.3.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

@@ -4,10 +4,10 @@ export declare const codexProviderConfigSchema: z.ZodObject<{
     type: z.ZodLiteral<"codex">;
     model: z.ZodString;
     effort: z.ZodOptional<z.ZodEnum<{
-        none: "none";
-        low: "low";
-        medium: "medium";
         high: "high";
+        medium: "medium";
+        low: "low";
+        none: "none";
     }>>;
     maxTurns: z.ZodOptional<z.ZodNumber>;
     timeoutMs: z.ZodOptional<z.ZodNumber>;
@@ -21,20 +21,23 @@ export declare const codexProviderConfigSchema: z.ZodObject<{
         code_interpreter: "code_interpreter";
     }>>>;
     costTier: z.ZodOptional<z.ZodEnum<{
-        low: "low";
-        medium: "medium";
         high: "high";
+        medium: "medium";
+        low: "low";
         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">;
     model: z.ZodString;
     effort: z.ZodOptional<z.ZodEnum<{
-        none: "none";
-        low: "low";
-        medium: "medium";
         high: "high";
+        medium: "medium";
+        low: "low";
+        none: "none";
     }>>;
     maxTurns: z.ZodOptional<z.ZodNumber>;
     timeoutMs: z.ZodOptional<z.ZodNumber>;
@@ -48,11 +51,14 @@ export declare const claudeProviderConfigSchema: z.ZodObject<{
         code_interpreter: "code_interpreter";
     }>>>;
     costTier: z.ZodOptional<z.ZodEnum<{
-        low: "low";
-        medium: "medium";
         high: "high";
+        medium: "medium";
+        low: "low";
         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">;
@@ -61,10 +67,10 @@ export declare const openAICompatibleProviderConfigSchema: z.ZodObject<{
     apiKey: z.ZodOptional<z.ZodString>;
     apiKeyEnv: z.ZodOptional<z.ZodString>;
     effort: z.ZodOptional<z.ZodEnum<{
-        none: "none";
-        low: "low";
-        medium: "medium";
         high: "high";
+        medium: "medium";
+        low: "low";
+        none: "none";
     }>>;
     maxTurns: z.ZodOptional<z.ZodNumber>;
     timeoutMs: z.ZodOptional<z.ZodNumber>;
@@ -78,20 +84,23 @@ export declare const openAICompatibleProviderConfigSchema: z.ZodObject<{
         code_interpreter: "code_interpreter";
     }>>>;
     costTier: z.ZodOptional<z.ZodEnum<{
-        low: "low";
-        medium: "medium";
         high: "high";
+        medium: "medium";
+        low: "low";
         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">;
     model: z.ZodString;
     effort: z.ZodOptional<z.ZodEnum<{
-        none: "none";
-        low: "low";
-        medium: "medium";
         high: "high";
+        medium: "medium";
+        low: "low";
+        none: "none";
     }>>;
     maxTurns: z.ZodOptional<z.ZodNumber>;
     timeoutMs: z.ZodOptional<z.ZodNumber>;
@@ -105,19 +114,22 @@ export declare const providerConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
         code_interpreter: "code_interpreter";
     }>>>;
     costTier: z.ZodOptional<z.ZodEnum<{
-        low: "low";
-        medium: "medium";
         high: "high";
+        medium: "medium";
+        low: "low";
         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;
     effort: z.ZodOptional<z.ZodEnum<{
-        none: "none";
-        low: "low";
-        medium: "medium";
         high: "high";
+        medium: "medium";
+        low: "low";
+        none: "none";
     }>>;
     maxTurns: z.ZodOptional<z.ZodNumber>;
     timeoutMs: z.ZodOptional<z.ZodNumber>;
@@ -131,11 +143,14 @@ export declare const providerConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
         code_interpreter: "code_interpreter";
     }>>>;
     costTier: z.ZodOptional<z.ZodEnum<{
-        low: "low";
-        medium: "medium";
         high: "high";
+        medium: "medium";
+        low: "low";
         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;
@@ -143,10 +158,10 @@ export declare const providerConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
     apiKey: z.ZodOptional<z.ZodString>;
     apiKeyEnv: z.ZodOptional<z.ZodString>;
     effort: z.ZodOptional<z.ZodEnum<{
-        none: "none";
-        low: "low";
-        medium: "medium";
         high: "high";
+        medium: "medium";
+        low: "low";
+        none: "none";
     }>>;
     maxTurns: z.ZodOptional<z.ZodNumber>;
     timeoutMs: z.ZodOptional<z.ZodNumber>;
@@ -160,21 +175,24 @@ export declare const providerConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
         code_interpreter: "code_interpreter";
     }>>>;
     costTier: z.ZodOptional<z.ZodEnum<{
-        low: "low";
-        medium: "medium";
         high: "high";
+        medium: "medium";
+        low: "low";
         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<{
         type: z.ZodLiteral<"codex">;
         model: z.ZodString;
         effort: z.ZodOptional<z.ZodEnum<{
-            none: "none";
-            low: "low";
-            medium: "medium";
             high: "high";
+            medium: "medium";
+            low: "low";
+            none: "none";
         }>>;
         maxTurns: z.ZodOptional<z.ZodNumber>;
         timeoutMs: z.ZodOptional<z.ZodNumber>;
@@ -188,19 +206,22 @@ export declare const multiModelConfigSchema: z.ZodObject<{
             code_interpreter: "code_interpreter";
         }>>>;
         costTier: z.ZodOptional<z.ZodEnum<{
-            low: "low";
-            medium: "medium";
             high: "high";
+            medium: "medium";
+            low: "low";
             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;
         effort: z.ZodOptional<z.ZodEnum<{
-            none: "none";
-            low: "low";
-            medium: "medium";
             high: "high";
+            medium: "medium";
+            low: "low";
+            none: "none";
         }>>;
         maxTurns: z.ZodOptional<z.ZodNumber>;
         timeoutMs: z.ZodOptional<z.ZodNumber>;
@@ -214,11 +235,14 @@ export declare const multiModelConfigSchema: z.ZodObject<{
             code_interpreter: "code_interpreter";
         }>>>;
         costTier: z.ZodOptional<z.ZodEnum<{
-            low: "low";
-            medium: "medium";
             high: "high";
+            medium: "medium";
+            low: "low";
             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;
@@ -226,10 +250,10 @@ export declare const multiModelConfigSchema: z.ZodObject<{
         apiKey: z.ZodOptional<z.ZodString>;
         apiKeyEnv: z.ZodOptional<z.ZodString>;
         effort: z.ZodOptional<z.ZodEnum<{
-            none: "none";
-            low: "low";
-            medium: "medium";
             high: "high";
+            medium: "medium";
+            low: "low";
+            none: "none";
         }>>;
         maxTurns: z.ZodOptional<z.ZodNumber>;
         timeoutMs: z.ZodOptional<z.ZodNumber>;
@@ -243,11 +267,14 @@ export declare const multiModelConfigSchema: z.ZodObject<{
             code_interpreter: "code_interpreter";
         }>>>;
         costTier: z.ZodOptional<z.ZodEnum<{
-            low: "low";
-            medium: "medium";
             high: "high";
+            medium: "medium";
+            low: "low";
             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>;
@@ -256,6 +283,7 @@ export declare const multiModelConfigSchema: z.ZodObject<{
             none: "none";
             full: "full";
         }>>;
+        largeResponseThresholdChars: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export interface ParsedConfigSuccess {

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;AAWH,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,
@@ -47,6 +60,7 @@ const defaultsSchema = z.object({
     maxTurns: z.number().int().positive().default(200),
     timeoutMs: z.number().int().positive().default(600_000),
     tools: z.enum(['none', 'full']).default('full'),
+    largeResponseThresholdChars: z.number().int().positive().optional(),
 }).default(() => ({ maxTurns: 200, timeoutMs: 600_000, tools: 'full' }));
 export const multiModelConfigSchema = z.object({
     providers: z.record(z.string(), providerConfigSchema).default({}),

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,CAgJpB"}