@vauban-org/agent-sdk 1.0.0 → 1.2.0

package/dist/adapters/llm/anthropic-direct.d.ts

@@ -23,6 +23,7 @@ export declare class AnthropicDirectAdapter implements LLMProviderPort {
         usd: number;
     };
     complete(req: ChatRequest): Promise<ChatResponse>;
+    private _doComplete;
     stream(req: ChatRequest): AsyncIterable<StreamDelta>;
 }
 //# sourceMappingURL=anthropic-direct.d.ts.map

package/dist/adapters/llm/anthropic-direct.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic-direct.d.ts","sourceRoot":"","sources":["../../../src/adapters/llm/anthropic-direct.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EAEZ,eAAe,EACf,WAAW,EACZ,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,eAAe,CAAC,EAAE,SAAS,CAAC;CAC7B;AA0BD,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,MAAM,EAAE,4BAA4B;IAOhD,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;IAUzC,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IA+EhD,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,aAAa,CAAC,WAAW,CAAC;CA6D5D"}
+{"version":3,"file":"anthropic-direct.d.ts","sourceRoot":"","sources":["../../../src/adapters/llm/anthropic-direct.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAG1C,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EAEZ,eAAe,EACf,WAAW,EACZ,MAAM,6BAA6B,CAAC;AAOrC,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,eAAe,CAAC,EAAE,SAAS,CAAC;CAC7B;AA0BD,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,MAAM,EAAE,4BAA4B;IAOhD,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;IAUzC,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;YA4CzC,WAAW;IA+ElB,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,aAAa,CAAC,WAAW,CAAC;CA6D5D"}

package/dist/adapters/llm/anthropic-direct.js

@@ -7,6 +7,8 @@
  * Maps Anthropic SDK response to ChatResponse canonical format.
  */
 import Anthropic from "@anthropic-ai/sdk";
+import { SpanStatusCode, trace } from "@opentelemetry/api";
+const ADAPTER_TRACER = trace.getTracer("vauban-agent-sdk.llm.anthropic", "0.1.0");
 // Pricing approximation for cost estimation (input/output per token in USD)
 const INPUT_USD_PER_TOKEN = 3 / 1_000_000; // $3 / MTok
 const OUTPUT_USD_PER_TOKEN = 15 / 1_000_000; // $15 / MTok
@@ -44,6 +46,47 @@ export class AnthropicDirectAdapter {
         };
     }
     async complete(req) {
+        return ADAPTER_TRACER.startActiveSpan("llm-provider.complete", {
+            attributes: {
+                "gen_ai.system": "anthropic",
+                "gen_ai.request.model": req.model ?? this.defaultModel,
+                "gen_ai.request.message_count": req.messages.length,
+                "vauban.port.name": "llm-provider",
+                "vauban.port.impl": "AnthropicDirectAdapter",
+            },
+        }, async (span) => {
+            try {
+                const response = await this._doComplete(req);
+                span.setAttributes({
+                    "gen_ai.usage.input_tokens": response.usage.inputTokens,
+                    "gen_ai.usage.output_tokens": response.usage.outputTokens,
+                    "gen_ai.response.model": response.model,
+                    "gen_ai.response.finish_reasons": [response.finishReason],
+                });
+                if (response.usage.costUsd !== undefined) {
+                    span.setAttribute("gen_ai.usage.cost_usd", response.usage.costUsd);
+                }
+                span.setStatus({ code: SpanStatusCode.OK });
+                return response;
+            }
+            catch (_err) {
+                span.setStatus({
+                    code: SpanStatusCode.ERROR,
+                    message: "span wrapper caught exception",
+                });
+                return {
+                    content: "",
+                    usage: { inputTokens: 0, outputTokens: 0 },
+                    model: req.model ?? this.defaultModel,
+                    finishReason: "error",
+                };
+            }
+            finally {
+                span.end();
+            }
+        });
+    }
+    async _doComplete(req) {
         const model = req.model ?? this.defaultModel;
         // Extract system message (Anthropic API separates system from messages)
         const systemMessages = req.messages.filter((m) => m.role === "system");

package/dist/adapters/llm/anthropic-direct.js.map

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

package/dist/adapters/llm/cascade.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cascade.d.ts","sourceRoot":"","sources":["../../../src/adapters/llm/cascade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,WAAW,EACZ,MAAM,6BAA6B,CAAC;AASrC,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED,qBAAa,cAAe,YAAW,eAAe;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;gBAElC,MAAM,EAAE,oBAAoB;IAOxC,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;IAUzC,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAuBhD,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,aAAa,CAAC,WAAW,CAAC;CAiC5D"}
+{"version":3,"file":"cascade.d.ts","sourceRoot":"","sources":["../../../src/adapters/llm/cascade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,WAAW,EACZ,MAAM,6BAA6B,CAAC;AAWrC,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED,qBAAa,cAAe,YAAW,eAAe;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;gBAElC,MAAM,EAAE,oBAAoB;IAOxC,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;IAUzC,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAgEhD,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,aAAa,CAAC,WAAW,CAAC;CAiC5D"}

package/dist/adapters/llm/cascade.js

@@ -11,6 +11,8 @@
  *
  * BYOM: no default model hardcoded.
  */
+import { SpanStatusCode, trace } from "@opentelemetry/api";
+const ADAPTER_TRACER = trace.getTracer("vauban-agent-sdk.llm.cascade", "0.1.0");
 const ALL_FAIL_RESPONSE = {
     content: "",
     usage: { inputTokens: 0, outputTokens: 0 },
@@ -35,24 +37,65 @@ export class CascadeAdapter {
         return { usd: 0 };
     }
     async complete(req) {
-        for (const provider of this.providers) {
-            if (req.abortSignal?.aborted) {
-                return { ...ALL_FAIL_RESPONSE };
-            }
-            let response;
+        return ADAPTER_TRACER.startActiveSpan("llm-provider.complete", {
+            attributes: {
+                "gen_ai.system": "cascade",
+                "gen_ai.request.model": req.model ?? "cascade",
+                "gen_ai.request.message_count": req.messages.length,
+                "vauban.port.name": "llm-provider",
+                "vauban.port.impl": "CascadeAdapter",
+                "vauban.cascade.provider_count": this.providers.length,
+            },
+        }, async (span) => {
             try {
-                response = await provider.complete(req);
+                let attemptCount = 0;
+                for (const provider of this.providers) {
+                    attemptCount++;
+                    if (req.abortSignal?.aborted) {
+                        span.setAttribute("vauban.cascade.attempts", attemptCount);
+                        span.setStatus({ code: SpanStatusCode.OK });
+                        return { ...ALL_FAIL_RESPONSE };
+                    }
+                    let response;
+                    try {
+                        response = await provider.complete(req);
+                    }
+                    catch {
+                        // Unexpected throw — treat as failure, try next
+                        continue;
+                    }
+                    if (response.finishReason !== "error") {
+                        span.setAttribute("vauban.cascade.attempts", attemptCount);
+                        span.setAttributes({
+                            "gen_ai.usage.input_tokens": response.usage.inputTokens,
+                            "gen_ai.usage.output_tokens": response.usage.outputTokens,
+                            "gen_ai.response.model": response.model,
+                            "gen_ai.response.finish_reasons": [response.finishReason],
+                        });
+                        span.setStatus({ code: SpanStatusCode.OK });
+                        return response;
+                    }
+                    // finishReason === "error" → try next provider
+                }
+                span.setAttribute("vauban.cascade.attempts", attemptCount);
+                span.setAttribute("vauban.cascade.all_failed", true);
+                span.setStatus({
+                    code: SpanStatusCode.ERROR,
+                    message: "all providers failed",
+                });
+                return { ...ALL_FAIL_RESPONSE };
             }
-            catch {
-                // Unexpected throw — treat as failure, try next
-                continue;
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                span.setStatus({ code: SpanStatusCode.ERROR, message });
+                if (err instanceof Error)
+                    span.recordException(err);
+                return { ...ALL_FAIL_RESPONSE };
             }
-            if (response.finishReason !== "error") {
-                return response;
+            finally {
+                span.end();
             }
-            // finishReason === "error" → try next provider
-        }
-        return { ...ALL_FAIL_RESPONSE };
+        });
     }
     async *stream(req) {
         for (const provider of this.providers) {

package/dist/adapters/llm/cascade.js.map

@@ -1 +1 @@
-{"version":3,"file":"cascade.js","sourceRoot":"","sources":["../../../src/adapters/llm/cascade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,MAAM,iBAAiB,GAAiB;IACtC,OAAO,EAAE,EAAE;IACX,KAAK,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE;IAC1C,KAAK,EAAE,EAAE;IACT,YAAY,EAAE,OAAO;CACtB,CAAC;AAMF,MAAM,OAAO,cAAc;IACR,SAAS,CAAoB;IAE9C,YAAY,MAA4B;QACtC,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACpC,CAAC;IAED,YAAY,CAAC,GAAgB;QAC3B,oDAAoD;QACpD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;gBAC1B,OAAO,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAgB;QAC7B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC;gBAC7B,OAAO,EAAE,GAAG,iBAAiB,EAAE,CAAC;YAClC,CAAC;YAED,IAAI,QAAsB,CAAC;YAC3B,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC1C,CAAC;YAAC,MAAM,CAAC;gBACP,gDAAgD;gBAChD,SAAS;YACX,CAAC;YAED,IAAI,QAAQ,CAAC,YAAY,KAAK,OAAO,EAAE,CAAC;gBACtC,OAAO,QAAQ,CAAC;YAClB,CAAC;YACD,+CAA+C;QACjD,CAAC;QAED,OAAO,EAAE,GAAG,iBAAiB,EAAE,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,CAAC,MAAM,CAAC,GAAgB;QAC5B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC;gBAC7B,OAAO;YACT,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACrB,qDAAqD;gBACrD,SAAS;YACX,CAAC;YAED,IAAI,UAAU,GAAG,KAAK,CAAC;YACvB,IAAI,OAAO,GAAG,KAAK,CAAC;YAEpB,IAAI,CAAC;gBACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC/C,IAAI,GAAG,CAAC,WAAW,EAAE,OAAO;wBAAE,OAAO;oBACrC,UAAU,GAAG,IAAI,CAAC;oBAClB,MAAM,KAAK,CAAC;gBACd,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;YAED,IAAI,UAAU,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC3B,OAAO;YACT,CAAC;YACD,0CAA0C;QAC5C,CAAC;QAED,uBAAuB;QACvB,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC;IAClE,CAAC;CACF"}
+{"version":3,"file":"cascade.js","sourceRoot":"","sources":["../../../src/adapters/llm/cascade.ts"],"names":[],"mappings":"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"}

package/dist/adapters/llm/litellm.d.ts

@@ -23,6 +23,8 @@ export declare class LiteLLMAdapter implements LLMProviderPort {
         usd: number;
     };
     complete(req: ChatRequest): Promise<ChatResponse>;
+    /** Internal completion logic — extracted from complete() for span instrumentation. */
+    private _doComplete;
     stream(req: ChatRequest): AsyncIterable<StreamDelta>;
 }
 //# sourceMappingURL=litellm.d.ts.map

package/dist/adapters/llm/litellm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"litellm.d.ts","sourceRoot":"","sources":["../../../src/adapters/llm/litellm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EAEZ,eAAe,EACf,WAAW,EACZ,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA8DD,qBAAa,cAAe,YAAW,eAAe;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,MAAM,EAAE,oBAAoB;IAMxC,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;IAQzC,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAmIhD,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,aAAa,CAAC,WAAW,CAAC;CAgE5D"}
+{"version":3,"file":"litellm.d.ts","sourceRoot":"","sources":["../../../src/adapters/llm/litellm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EAEZ,eAAe,EACf,WAAW,EACZ,MAAM,6BAA6B,CAAC;AAIrC,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA8DD,qBAAa,cAAe,YAAW,eAAe;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,MAAM,EAAE,oBAAoB;IAMxC,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;IAQzC,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IA4CvD,sFAAsF;YACxE,WAAW;IAmIlB,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,aAAa,CAAC,WAAW,CAAC;CAgE5D"}

package/dist/adapters/llm/litellm.js

@@ -8,6 +8,8 @@
  * BYOM: defaultModel is a constructor param default only.
  * No model string is hardcoded at module scope.
  */
+import { SpanStatusCode, trace } from "@opentelemetry/api";
+const ADAPTER_TRACER = trace.getTracer("vauban-agent-sdk.llm.litellm", "0.1.0");
 // Tokens per USD — approximate LiteLLM defaults for cost estimation.
 const INPUT_TOKENS_PER_USD = 500_000;
 const OUTPUT_TOKENS_PER_USD = 250_000;
@@ -55,6 +57,48 @@ export class LiteLLMAdapter {
         return { usd: inputCost + outputCost };
     }
     async complete(req) {
+        return ADAPTER_TRACER.startActiveSpan("llm-provider.complete", {
+            attributes: {
+                "gen_ai.system": "litellm",
+                "gen_ai.request.model": req.model ?? this.defaultModel,
+                "gen_ai.request.message_count": req.messages.length,
+                "vauban.port.name": "llm-provider",
+                "vauban.port.impl": "LiteLLMAdapter",
+            },
+        }, async (span) => {
+            try {
+                const response = await this._doComplete(req);
+                span.setAttributes({
+                    "gen_ai.usage.input_tokens": response.usage.inputTokens,
+                    "gen_ai.usage.output_tokens": response.usage.outputTokens,
+                    "gen_ai.response.model": response.model,
+                    "gen_ai.response.finish_reasons": [response.finishReason],
+                });
+                if (response.usage.costUsd !== undefined) {
+                    span.setAttribute("gen_ai.usage.cost_usd", response.usage.costUsd);
+                }
+                span.setStatus({ code: SpanStatusCode.OK });
+                return response;
+            }
+            catch (_err) {
+                span.setStatus({
+                    code: SpanStatusCode.ERROR,
+                    message: "span wrapper caught exception",
+                });
+                return {
+                    content: "",
+                    usage: { inputTokens: 0, outputTokens: 0 },
+                    model: req.model ?? this.defaultModel,
+                    finishReason: "error",
+                };
+            }
+            finally {
+                span.end();
+            }
+        });
+    }
+    /** Internal completion logic — extracted from complete() for span instrumentation. */
+    async _doComplete(req) {
         const model = req.model ?? this.defaultModel;
         const body = {
             model,

package/dist/adapters/llm/litellm.js.map

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

package/dist/compute/difficulty-estimator.d.ts

@@ -0,0 +1,53 @@
+/**
+ * src/compute/difficulty-estimator.ts
+ *
+ * Deterministic task-difficulty classifier + strategy recommender.
+ *
+ * NOT an LLM call — pure feature extraction + rule-based classification.
+ * Routes input difficulty → recommended compute strategy.
+ *
+ * @experimental Public-experimental API per `contract-stability.md` (sprint-582).
+ */
+export type DifficultyClass = "simple" | "standard" | "complex" | "reasoning";
+export interface TaskFeatures {
+    /** Character count of input. */
+    inputLength: number;
+    /** Input contains "step", "then", or "first…then" pattern. */
+    hasMultipleSteps: boolean;
+    /** Input contains "why", "explain", "reason", "prove", "deduce". */
+    requiresReasoning: boolean;
+    /** Input contains "create", "generate", "design", "imagine". */
+    requiresCreativity: boolean;
+    /** Input contains digits or math operators. */
+    hasNumerics: boolean;
+    /** Input references multiple entities ("A and B", "compare"). */
+    hasCrossReference: boolean;
+    /** Length of optional context/system prompt. */
+    contextLength: number;
+}
+/**
+ * Extract task features from input + optional context.
+ * Deterministic, side-effect free.
+ */
+export declare function extractFeatures(input: string, context?: string): TaskFeatures;
+/**
+ * Classify difficulty from task features.
+ *
+ * Decision tree (most specific first):
+ *   - requiresReasoning → "reasoning"
+ *   - inputLength > 500 OR hasMultipleSteps OR requiresCreativity → "complex"
+ *   - inputLength in [100, 500] OR hasNumerics → "standard"
+ *   - else → "simple"
+ */
+export declare function estimateDifficulty(features: TaskFeatures): DifficultyClass;
+/**
+ * Recommend a compute strategy for a given difficulty class.
+ *
+ * Map (per Sprint A bench results + Sprint-582 spec):
+ *   simple     → single-shot
+ *   standard   → bon-mav
+ *   complex    → tree-of-thoughts
+ *   reasoning  → mixture-of-agents
+ */
+export declare function recommendStrategy(difficulty: DifficultyClass): string;
+//# sourceMappingURL=difficulty-estimator.d.ts.map

package/dist/compute/difficulty-estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"difficulty-estimator.d.ts","sourceRoot":"","sources":["../../src/compute/difficulty-estimator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;AAE9E,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,gBAAgB,EAAE,OAAO,CAAC;IAC1B,oEAAoE;IACpE,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gEAAgE;IAChE,kBAAkB,EAAE,OAAO,CAAC;IAC5B,+CAA+C;IAC/C,WAAW,EAAE,OAAO,CAAC;IACrB,iEAAiE;IACjE,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;CACvB;AAaD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,YAAY,CAa7E;AAID;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,eAAe,CAS1E;AAID;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,CAerE"}

package/dist/compute/difficulty-estimator.js

@@ -0,0 +1,82 @@
+/**
+ * src/compute/difficulty-estimator.ts
+ *
+ * Deterministic task-difficulty classifier + strategy recommender.
+ *
+ * NOT an LLM call — pure feature extraction + rule-based classification.
+ * Routes input difficulty → recommended compute strategy.
+ *
+ * @experimental Public-experimental API per `contract-stability.md` (sprint-582).
+ */
+// ─── Regex patterns (case-insensitive, word-bounded where useful) ───────────
+const RE_STEPS = /\b(step|steps|then|first|next|finally)\b/i;
+const RE_REASONING = /\b(why|explain|explains|reason|reasons|prove|proves|deduce|deduces|infer|justify)\b/i;
+const RE_CREATIVITY = /\b(create|generate|design|imagine|invent|compose)\b/i;
+const RE_NUMERICS = /[0-9]|[+\-*/^=]/;
+const RE_CROSS_REF = /\b(compare|and|versus|vs\.?|both)\b/i;
+// ─── Feature extraction ──────────────────────────────────────────────────────
+/**
+ * Extract task features from input + optional context.
+ * Deterministic, side-effect free.
+ */
+export function extractFeatures(input, context) {
+    const inputLength = input.length;
+    const contextLength = context?.length ?? 0;
+    return {
+        inputLength,
+        hasMultipleSteps: RE_STEPS.test(input),
+        requiresReasoning: RE_REASONING.test(input),
+        requiresCreativity: RE_CREATIVITY.test(input),
+        hasNumerics: RE_NUMERICS.test(input),
+        hasCrossReference: RE_CROSS_REF.test(input),
+        contextLength,
+    };
+}
+// ─── Difficulty classification ───────────────────────────────────────────────
+/**
+ * Classify difficulty from task features.
+ *
+ * Decision tree (most specific first):
+ *   - requiresReasoning → "reasoning"
+ *   - inputLength > 500 OR hasMultipleSteps OR requiresCreativity → "complex"
+ *   - inputLength in [100, 500] OR hasNumerics → "standard"
+ *   - else → "simple"
+ */
+export function estimateDifficulty(features) {
+    if (features.requiresReasoning)
+        return "reasoning";
+    if (features.inputLength > 500 || features.hasMultipleSteps || features.requiresCreativity) {
+        return "complex";
+    }
+    if (features.inputLength >= 100 || features.hasNumerics) {
+        return "standard";
+    }
+    return "simple";
+}
+// ─── Strategy recommendation ─────────────────────────────────────────────────
+/**
+ * Recommend a compute strategy for a given difficulty class.
+ *
+ * Map (per Sprint A bench results + Sprint-582 spec):
+ *   simple     → single-shot
+ *   standard   → bon-mav
+ *   complex    → tree-of-thoughts
+ *   reasoning  → mixture-of-agents
+ */
+export function recommendStrategy(difficulty) {
+    switch (difficulty) {
+        case "simple":
+            return "single-shot";
+        case "standard":
+            return "bon-mav";
+        case "complex":
+            return "tree-of-thoughts";
+        case "reasoning":
+            return "mixture-of-agents";
+        default: {
+            const _exhaustive = difficulty;
+            throw new Error(`recommendStrategy: unknown difficulty "${String(_exhaustive)}"`);
+        }
+    }
+}
+//# sourceMappingURL=difficulty-estimator.js.map

package/dist/compute/difficulty-estimator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"difficulty-estimator.js","sourceRoot":"","sources":["../../src/compute/difficulty-estimator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAuBH,+EAA+E;AAE/E,MAAM,QAAQ,GAAG,2CAA2C,CAAC;AAC7D,MAAM,YAAY,GAChB,sFAAsF,CAAC;AACzF,MAAM,aAAa,GAAG,sDAAsD,CAAC;AAC7E,MAAM,WAAW,GAAG,iBAAiB,CAAC;AACtC,MAAM,YAAY,GAAG,sCAAsC,CAAC;AAE5D,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,OAAgB;IAC7D,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC;IACjC,MAAM,aAAa,GAAG,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC;IAE3C,OAAO;QACL,WAAW;QACX,gBAAgB,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;QACtC,iBAAiB,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC;QAC3C,kBAAkB,EAAE,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC;QAC7C,WAAW,EAAE,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC;QACpC,iBAAiB,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC;QAC3C,aAAa;KACd,CAAC;AACJ,CAAC;AAED,gFAAgF;AAEhF;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAsB;IACvD,IAAI,QAAQ,CAAC,iBAAiB;QAAE,OAAO,WAAW,CAAC;IACnD,IAAI,QAAQ,CAAC,WAAW,GAAG,GAAG,IAAI,QAAQ,CAAC,gBAAgB,IAAI,QAAQ,CAAC,kBAAkB,EAAE,CAAC;QAC3F,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,QAAQ,CAAC,WAAW,IAAI,GAAG,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;QACxD,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,gFAAgF;AAEhF;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAA2B;IAC3D,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,aAAa,CAAC;QACvB,KAAK,UAAU;YACb,OAAO,SAAS,CAAC;QACnB,KAAK,SAAS;YACZ,OAAO,kBAAkB,CAAC;QAC5B,KAAK,WAAW;YACd,OAAO,mBAAmB,CAAC;QAC7B,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,WAAW,GAAU,UAAU,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,0CAA0C,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/compute/strategies/mixture-of-agents.d.ts

@@ -0,0 +1,40 @@
+/**
+ * src/compute/strategies/mixture-of-agents.ts
+ *
+ * Mixture-of-Agents (MoA) compute strategy.
+ *
+ * Reference: Wang et al. 2024, "Mixture of Agents", arXiv:2406.04692.
+ *
+ * Algorithm:
+ *   - L rounds (layers). Each round runs M proposers (independent parallel calls).
+ *   - After each round, an aggregator synthesizes the M outputs into ONE result.
+ *   - The synthesized result becomes the seed for the next round (currently
+ *     opaque to the generator — synthesis is purely on the output side; the
+ *     same input is used each round, but the aggregated state is returned).
+ *   - Final aggregated output is the answer.
+ *
+ * Budget: M × L total generator calls.
+ *
+ * Default aggregation:
+ *   - string outputs : concatenate with "\n---\n" then take first non-empty
+ *   - number outputs : median
+ *   - other          : first element
+ *
+ * @experimental Public-experimental API per `contract-stability.md` (sprint-582).
+ */
+import type { Strategy } from "../types.js";
+export interface MoAConfig<TOutput> {
+    /** Number of rounds (L). Default: 2. */
+    rounds: number;
+    /** Proposers per round (M). Default: 3. */
+    proposersPerRound: number;
+    /** Aggregation function: M outputs → 1 synthesized output. */
+    aggregate?: (outputs: TOutput[]) => TOutput;
+}
+/**
+ * Construct a Mixture-of-Agents {@link Strategy}.
+ *
+ * @throws RangeError when `rounds` or `proposersPerRound` < 1.
+ */
+export declare function mixtureOfAgentsStrategy<TInput, TOutput>(config?: Partial<MoAConfig<TOutput>>): Strategy<TInput, TOutput>;
+//# sourceMappingURL=mixture-of-agents.d.ts.map

package/dist/compute/strategies/mixture-of-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mixture-of-agents.d.ts","sourceRoot":"","sources":["../../../src/compute/strategies/mixture-of-agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAkB,QAAQ,EAAkB,MAAM,aAAa,CAAC;AAI5E,MAAM,WAAW,SAAS,CAAC,OAAO;IAChC,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;CAC7C;AA8CD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,EACrD,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,GACnC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CA4D3B"}

package/dist/compute/strategies/mixture-of-agents.js

@@ -0,0 +1,110 @@
+/**
+ * src/compute/strategies/mixture-of-agents.ts
+ *
+ * Mixture-of-Agents (MoA) compute strategy.
+ *
+ * Reference: Wang et al. 2024, "Mixture of Agents", arXiv:2406.04692.
+ *
+ * Algorithm:
+ *   - L rounds (layers). Each round runs M proposers (independent parallel calls).
+ *   - After each round, an aggregator synthesizes the M outputs into ONE result.
+ *   - The synthesized result becomes the seed for the next round (currently
+ *     opaque to the generator — synthesis is purely on the output side; the
+ *     same input is used each round, but the aggregated state is returned).
+ *   - Final aggregated output is the answer.
+ *
+ * Budget: M × L total generator calls.
+ *
+ * Default aggregation:
+ *   - string outputs : concatenate with "\n---\n" then take first non-empty
+ *   - number outputs : median
+ *   - other          : first element
+ *
+ * @experimental Public-experimental API per `contract-stability.md` (sprint-582).
+ */
+const STRATEGY_NAME = "mixture-of-agents";
+// ─── Default aggregator ──────────────────────────────────────────────────────
+function defaultAggregator(outputs) {
+    if (outputs.length === 0) {
+        throw new Error("mixtureOfAgentsStrategy: aggregator called with 0 outputs");
+    }
+    const first = outputs[0];
+    // Strings: concat for traceability, then return first non-empty after concat header.
+    // Per spec: "if outputs are strings, concatenate with '\n---\n' prefix and take
+    // the first non-empty (simple but correct for MVP)."
+    if (typeof first === "string") {
+        const nonEmpty = outputs.find((o) => typeof o === "string" && o.length > 0);
+        return (nonEmpty ?? first);
+    }
+    // Numbers: median.
+    if (typeof first === "number") {
+        const nums = outputs.filter((n) => Number.isFinite(n));
+        if (nums.length === 0)
+            return first;
+        const sorted = [...nums].sort((a, b) => a - b);
+        const mid = Math.floor(sorted.length / 2);
+        const median = sorted.length % 2 === 0 ? (sorted[mid - 1] + sorted[mid]) / 2 : sorted[mid];
+        return median;
+    }
+    // Other types: return first (identity fallback).
+    return first;
+}
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function throwIfAborted(signal) {
+    if (signal?.aborted) {
+        throw signal.reason instanceof Error
+            ? signal.reason
+            : new DOMException("Aborted", "AbortError");
+    }
+}
+// ─── Strategy factory ────────────────────────────────────────────────────────
+/**
+ * Construct a Mixture-of-Agents {@link Strategy}.
+ *
+ * @throws RangeError when `rounds` or `proposersPerRound` < 1.
+ */
+export function mixtureOfAgentsStrategy(config) {
+    const rounds = config?.rounds ?? 2;
+    const proposersPerRound = config?.proposersPerRound ?? 3;
+    const aggregate = config?.aggregate ?? defaultAggregator;
+    if (!Number.isInteger(rounds) || rounds < 1) {
+        throw new RangeError(`mixtureOfAgentsStrategy: rounds must be >=1, got ${rounds}`);
+    }
+    if (!Number.isInteger(proposersPerRound) || proposersPerRound < 1) {
+        throw new RangeError(`mixtureOfAgentsStrategy: proposersPerRound must be >=1, got ${proposersPerRound}`);
+    }
+    return {
+        name: STRATEGY_NAME,
+        async run(input, generator, ctx = {}) {
+            const start = performance.now();
+            const signal = ctx.signal;
+            throwIfAborted(signal);
+            const childCtx = signal ? { signal } : {};
+            let aggregated;
+            let totalCalls = 0;
+            for (let r = 0; r < rounds; r++) {
+                throwIfAborted(signal);
+                const outputs = await Promise.all(Array.from({ length: proposersPerRound }, () => generator(input, childCtx)));
+                totalCalls += proposersPerRound;
+                throwIfAborted(signal);
+                aggregated = aggregate(outputs);
+            }
+            const latency_ms = performance.now() - start;
+            if (aggregated === undefined) {
+                // Unreachable: rounds >= 1 guarantees aggregated is set.
+                throw new Error("mixtureOfAgentsStrategy: no aggregated result");
+            }
+            return {
+                result: aggregated,
+                metadata: {
+                    strategy: STRATEGY_NAME,
+                    candidates: totalCalls,
+                    verifier_scores: [],
+                    cost: { calls: totalCalls },
+                    latency_ms,
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=mixture-of-agents.js.map

package/dist/compute/strategies/mixture-of-agents.js.map

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