@haikeilabs/agentware 0.1.0 → 0.2.1

package/dist/llm/openai_backend.js

@@ -0,0 +1,203 @@
+import { Role } from "./request.js";
+export class OpenAIError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.name = "OpenAIError";
+        this.status = status;
+    }
+}
+const DEFAULT_BASE_URL = "https://api.openai.com/v1";
+const DEFAULT_TIMEOUT_MS = 60_000;
+const DEFAULT_MAX_RESPONSE_BYTES = 1_048_576;
+const DEFAULT_MAX_TOOL_ARG_BYTES = 65_536;
+const DEFAULT_CONTEXT_WINDOW = 128_000;
+const MAX_ERROR_DETAIL_CHARS = 512;
+export function parseToolArguments(raw, maxBytes) {
+    if (!raw) {
+        return {};
+    }
+    const bounded = raw.length > maxBytes ? raw.slice(0, maxBytes) : raw;
+    try {
+        const parsed = JSON.parse(bounded);
+        if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+        // fall through to raw fallback
+    }
+    return { _raw: bounded };
+}
+function toOpenAIMessage(message) {
+    switch (message.role) {
+        case Role.TOOL:
+            return {
+                role: "tool",
+                tool_call_id: message.tool_call_id ?? "",
+                content: message.content,
+            };
+        case Role.ASSISTANT:
+            if (message.tool_calls && message.tool_calls.length > 0) {
+                return {
+                    role: "assistant",
+                    content: message.content || null,
+                    tool_calls: message.tool_calls.map((tc) => ({
+                        id: tc.id,
+                        type: "function",
+                        function: { name: tc.name, arguments: JSON.stringify(tc.arguments) },
+                    })),
+                };
+            }
+            return { role: "assistant", content: message.content };
+        default:
+            return { role: message.role, content: message.content };
+    }
+}
+function toOpenAITool(tool) {
+    return {
+        type: "function",
+        function: {
+            name: tool.name,
+            description: tool.description,
+            parameters: tool.input_schema,
+        },
+    };
+}
+function truncateDetail(text) {
+    if (text.length <= MAX_ERROR_DETAIL_CHARS) {
+        return text;
+    }
+    return text.slice(0, MAX_ERROR_DETAIL_CHARS) + "...";
+}
+function toError(err) {
+    return err instanceof Error ? err : new Error(String(err));
+}
+export class OpenAIBackend {
+    model;
+    baseUrl;
+    apiKey;
+    fetchFn;
+    timeoutMs;
+    maxResponseBytes;
+    maxToolArgBytes;
+    contextWindow;
+    temperature;
+    maxTokens;
+    constructor(config) {
+        this.model = config.model;
+        this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+        this.apiKey = config.apiKey ?? "";
+        this.fetchFn = config.fetchFn ?? fetch;
+        this.timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.maxResponseBytes = config.maxResponseBytes ?? DEFAULT_MAX_RESPONSE_BYTES;
+        this.maxToolArgBytes = config.maxToolArgBytes ?? DEFAULT_MAX_TOOL_ARG_BYTES;
+        this.contextWindow = config.contextWindowSize ?? DEFAULT_CONTEXT_WINDOW;
+        this.temperature = config.temperature;
+        this.maxTokens = config.maxTokens;
+    }
+    async complete(messages, tools) {
+        const payload = {
+            model: this.model,
+            messages: messages.map(toOpenAIMessage),
+        };
+        if (this.temperature !== undefined) {
+            payload.temperature = this.temperature;
+        }
+        if (this.maxTokens !== undefined) {
+            payload.max_tokens = this.maxTokens;
+        }
+        if (tools && tools.length > 0) {
+            payload.tools = tools.map(toOpenAITool);
+            payload.tool_choice = "auto";
+        }
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (this.apiKey) {
+            headers.Authorization = `Bearer ${this.apiKey}`;
+        }
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            let res;
+            try {
+                res = await this.fetchFn(`${this.baseUrl}/chat/completions`, {
+                    method: "POST",
+                    headers,
+                    body: JSON.stringify(payload),
+                    signal: controller.signal,
+                });
+            }
+            catch (err) {
+                if (controller.signal.aborted ||
+                    (err instanceof Error && err.name === "AbortError")) {
+                    throw new OpenAIError(`request timed out after ${this.timeoutMs}ms`);
+                }
+                throw new OpenAIError(`request failed: ${toError(err).message}`);
+            }
+            const text = await res.text();
+            if (text.length > this.maxResponseBytes) {
+                throw new OpenAIError(`response body exceeds limit of ${this.maxResponseBytes} bytes`);
+            }
+            if (!res.ok) {
+                throw new OpenAIError(`HTTP ${res.status}: ${truncateDetail(text)}`, res.status);
+            }
+            let data;
+            try {
+                data = JSON.parse(text);
+            }
+            catch {
+                throw new OpenAIError("malformed JSON in response body");
+            }
+            return this.parseCompletion(data);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    parseCompletion(data) {
+        const completion = data;
+        const choice = completion.choices?.[0];
+        const message = choice?.message;
+        if (!message) {
+            throw new OpenAIError("unexpected response shape: missing choices[0].message");
+        }
+        const toolCalls = [];
+        if (message.tool_calls) {
+            for (let i = 0; i < message.tool_calls.length; i++) {
+                const tc = message.tool_calls[i];
+                const name = tc.function?.name;
+                if (!name) {
+                    continue;
+                }
+                toolCalls.push({
+                    id: tc.id ?? `call_${i}`,
+                    name,
+                    arguments: parseToolArguments(tc.function?.arguments, this.maxToolArgBytes),
+                });
+            }
+        }
+        const usage = {
+            prompt_tokens: completion.usage?.prompt_tokens ?? 0,
+            completion_tokens: completion.usage?.completion_tokens ?? 0,
+            total_tokens: completion.usage?.total_tokens ?? 0,
+        };
+        return {
+            content: message.content ?? "",
+            reasoning: message.reasoning_content ?? "",
+            tool_calls: toolCalls,
+            finish_reason: choice?.finish_reason ?? "",
+            usage_tokens: usage,
+        };
+    }
+    supportsNativeToolCalling() {
+        return true;
+    }
+    modelName() {
+        return this.model;
+    }
+    contextWindowSize() {
+        return this.contextWindow;
+    }
+}

package/dist/llm/response.d.ts

@@ -10,6 +10,11 @@ export interface TokenUsage {
 }
 export interface Response {
     content: string;
+    /** Raw reasoning returned on a separate channel (e.g. reasoning_content for
+     * DeepSeek-style models). Never written into content, never returned to the
+     * end user, and never recorded on a default audit record; consumers
+     * normalize it with the reasoning adapter. */
+    reasoning: string;
     tool_calls: ToolCall[];
     finish_reason: string;
     usage_tokens: TokenUsage;

package/dist/llm/response.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/llm/response.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,QAAQ,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,UAAU,CAAC;CAC1B"}
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/llm/response.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB;;;kDAG8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,QAAQ,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,UAAU,CAAC;CAC1B"}

package/dist/middleware/guardrails/response_validator.d.ts

@@ -1,4 +1,4 @@
-import { Nudge } from "./nudge";
+import { Nudge } from "./nudge.js";
 export interface ToolCall {
     tool: string;
     args: Record<string, unknown>;

package/dist/middleware/guardrails/response_validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"response_validator.d.ts","sourceRoot":"","sources":["../../../src/middleware/guardrails/response_validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAgC,MAAM,SAAS,CAAC;AAE9D,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,YAAY,CAAsD;IAE1E,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,mBAAmB,CAAS;gBAGlC,SAAS,EAAE,MAAM,EAAE,EACnB,aAAa,GAAE,OAAc,EAC7B,YAAY,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,KAAK;IAapE,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB;IAYxD,iBAAiB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,gBAAgB;IAoB1D,OAAO,CAAC,cAAc;IAsBtB,OAAO,CAAC,oBAAoB;IAqC5B,OAAO,CAAC,gBAAgB;IAuBxB,OAAO,CAAC,yBAAyB;IA0BjC,OAAO,CAAC,uBAAuB;CAGhC"}
+{"version":3,"file":"response_validator.d.ts","sourceRoot":"","sources":["../../../src/middleware/guardrails/response_validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAgC,MAAM,YAAY,CAAC;AAEjE,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,YAAY,CAAsD;IAE1E,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,mBAAmB,CAAS;gBAGlC,SAAS,EAAE,MAAM,EAAE,EACnB,aAAa,GAAE,OAAc,EAC7B,YAAY,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,KAAK;IAapE,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB;IAYxD,iBAAiB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,gBAAgB;IAoB1D,OAAO,CAAC,cAAc;IAsBtB,OAAO,CAAC,oBAAoB;IAqC5B,OAAO,CAAC,gBAAgB;IAuBxB,OAAO,CAAC,yBAAyB;IA0BjC,OAAO,CAAC,uBAAuB;CAGhC"}

package/dist/middleware/guardrails/response_validator.js

@@ -1,4 +1,4 @@
-import { retryNudge, unknownToolNudge } from "./nudge";
+import { retryNudge, unknownToolNudge } from "./nudge.js";
 export class ResponseValidator {
     toolNames;
     rescueEnabled;

package/dist/middleware/index.d.ts

@@ -2,4 +2,9 @@ export { MiddlewareImpl, Middleware, ToolExecutor } from "./middleware.js";
 export { Action, CallerContext, Decision, MessageType, MessageMeta } from "./types.js";
 export { PolicyEvaluator, Policy, Rule, Condition, Operator, SimplePolicyEvaluator } from "./policy.js";
 export { Auditor, AuditRecord, InMemoryAuditor, AuditFilter } from "./audit.js";
+export { runInference, InferenceConfig, InferenceResult, RetriesExhaustedError, } from "./inference.js";
+export { ResponseValidator, ValidationResult, ToolCall as ValidatedToolCall, } from "./guardrails/response_validator.js";
+export { Nudge, NudgeKind, retryNudge, unknownToolNudge, stepNudge, prerequisiteNudge, } from "./guardrails/nudge.js";
+export { ErrorTracker, ErrorCategory, ToolError, } from "./guardrails/error_tracker.js";
+export { StepEnforcer, StepNotAllowedError } from "./guardrails/step_enforcer.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/middleware/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACxG,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACxG,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EACL,YAAY,EACZ,eAAe,EACf,eAAe,EACf,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,QAAQ,IAAI,iBAAiB,GAC9B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,KAAK,EACL,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,YAAY,EACZ,aAAa,EACb,SAAS,GACV,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/middleware/index.js

@@ -2,3 +2,8 @@ export { MiddlewareImpl } from "./middleware.js";
 export { Action, MessageType } from "./types.js";
 export { Operator, SimplePolicyEvaluator } from "./policy.js";
 export { InMemoryAuditor } from "./audit.js";
+export { runInference, RetriesExhaustedError, } from "./inference.js";
+export { ResponseValidator, } from "./guardrails/response_validator.js";
+export { NudgeKind, retryNudge, unknownToolNudge, stepNudge, prerequisiteNudge, } from "./guardrails/nudge.js";
+export { ErrorTracker, ErrorCategory, } from "./guardrails/error_tracker.js";
+export { StepEnforcer, StepNotAllowedError } from "./guardrails/step_enforcer.js";

package/dist/middleware/inference.d.ts

@@ -5,6 +5,7 @@ import type { ContextWindowManager } from "../llmcontext/context_window.js";
 import type { ResponseValidator } from "./guardrails/response_validator.js";
 import { ErrorTracker } from "./guardrails/error_tracker.js";
 import { StepEnforcer } from "./guardrails/step_enforcer.js";
+import { ReasoningAdapter, type ContextTree } from "../reasoning/index.js";
 export declare class RetriesExhaustedError extends Error {
     constructor(message: string);
 }
@@ -13,6 +14,10 @@ export interface InferenceResult {
     newMessages: Message[];
     toolCallCounter: number;
     attempts: number;
+    /** Normalized context tree for the final turn's reasoning (native
+     * reasoning_content and/or thinking tags). Null when the turn carried no
+     * reasoning. Holds bounded summaries only; raw reasoning is never attached. */
+    reasoningTree: ContextTree | null;
 }
 export interface InferenceConfig {
     client: Backend;
@@ -23,6 +28,9 @@ export interface InferenceConfig {
     toolSpecs: ToolDefinition[];
     maxAttempts: number;
     stepIndex?: number;
+    /** Optional reasoning adapter override for limits and registered model
+     * fields. */
+    reasoning?: ReasoningAdapter;
 }
 export declare function runInference(messages: Message[], cfg: InferenceConfig, sessionId?: string): Promise<InferenceResult | null>;
 //# sourceMappingURL=inference.d.ts.map

package/dist/middleware/inference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inference.d.ts","sourceRoot":"","sources":["../../src/middleware/inference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAA2B,MAAM,oBAAoB,CAAC;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAG5E,OAAO,KAAK,EAAE,iBAAiB,EAA8B,MAAM,oCAAoC,CAAC;AACxG,OAAO,EAAE,YAAY,EAAiB,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAG7D,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,OAAO,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,YAAY,CAChC,QAAQ,EAAE,OAAO,EAAE,EACnB,GAAG,EAAE,eAAe,EACpB,SAAS,GAAE,MAAW,GACrB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAwJjC"}
+{"version":3,"file":"inference.d.ts","sourceRoot":"","sources":["../../src/middleware/inference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAA2B,MAAM,oBAAoB,CAAC;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAG5E,OAAO,KAAK,EAAE,iBAAiB,EAA8B,MAAM,oCAAoC,CAAC;AACxG,OAAO,EAAE,YAAY,EAAiB,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,OAAO,EAAE,gBAAgB,EAAkB,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAE3F,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,OAAO,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB;;mFAE+E;IAC/E,aAAa,EAAE,WAAW,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;iBACa;IACb,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAKD,wBAAsB,YAAY,CAChC,QAAQ,EAAE,OAAO,EAAE,EACnB,GAAG,EAAE,eAAe,EACpB,SAAS,GAAE,MAAW,GACrB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CA8LjC"}

package/dist/middleware/inference.js

@@ -2,12 +2,15 @@ import { Role } from "../llm/request.js";
 import { MessageType } from "./types.js";
 import { ErrorCategory } from "./guardrails/error_tracker.js";
 import { stepNudge } from "./guardrails/nudge.js";
+import { ReasoningAdapter, ReasoningError } from "../reasoning/index.js";
 export class RetriesExhaustedError extends Error {
     constructor(message) {
         super(message);
         this.name = "RetriesExhaustedError";
     }
 }
+// Default adapter strips and normalizes reasoning in the inference loop.
+const defaultAdapter = new ReasoningAdapter();
 export async function runInference(messages, cfg, sessionId = "") {
     let maxAttempts = cfg.maxAttempts;
     if (maxAttempts <= 0) {
@@ -49,43 +52,81 @@ export async function runInference(messages, cfg, sessionId = "") {
             cfg.contextManager.updateTokenCount(resp.usage_tokens.total_tokens);
         }
         let validationResult = null;
-        if (resp.tool_calls && resp.tool_calls.length > 0) {
-            const guardrailsToolCalls = resp.tool_calls.map((tc) => ({
-                tool: tc.name,
-                args: tc.arguments,
-            }));
-            if (cfg.validator) {
-                validationResult = cfg.validator.validateToolCalls(guardrailsToolCalls);
+        // AR-1: normalize reasoning and strip it before ordinary tool-call
+        // parsing. Reasoning can arrive as a native reasoning_content field or as
+        // embedded thinking tags in content; both are combined into a synthetic
+        // structured input so the adapter sees the full picture. Malformed or
+        // unbounded reasoning fails closed: this turn is treated as invalid and
+        // retried rather than parsed partially.
+        let reasoningTree = null;
+        let cleanContent = resp.content;
+        let reasoningFailed = false;
+        if (resp.content || resp.reasoning) {
+            const reasoningInput = { content: resp.content };
+            if (resp.reasoning) {
+                reasoningInput["reasoning_content"] = resp.reasoning;
             }
-            else {
-                validationResult = {
-                    toolCalls: guardrailsToolCalls,
-                    nudge: null,
-                    needsRetry: false,
-                };
-            }
-        }
-        else if (resp.content) {
-            if (cfg.validator) {
-                validationResult = cfg.validator.validateTextResponse(resp.content);
+            const adapter = cfg.reasoning ?? defaultAdapter;
+            try {
+                reasoningTree = adapter.extract(reasoningInput, cfg.client.modelName(), "llm-backend");
+                cleanContent = adapter.strip(reasoningInput);
             }
-            else {
-                validationResult = { toolCalls: [], nudge: null, needsRetry: false };
+            catch (e) {
+                if (e instanceof ReasoningError) {
+                    reasoningFailed = true;
+                    // Fail closed: never echo content that may carry reasoning we could
+                    // not parse.
+                    cleanContent = "";
+                    validationResult = {
+                        toolCalls: [],
+                        nudge: null,
+                        needsRetry: true,
+                    };
+                }
+                else {
+                    throw e;
+                }
             }
-            if (!validationResult.needsRetry && validationResult.toolCalls.length > 0) {
-                resp.tool_calls = validationResult.toolCalls.map((tc) => ({
-                    id: "",
-                    name: tc.tool,
-                    arguments: tc.args,
+        }
+        if (!reasoningFailed) {
+            if (resp.tool_calls && resp.tool_calls.length > 0) {
+                const guardrailsToolCalls = resp.tool_calls.map((tc) => ({
+                    tool: tc.name,
+                    args: tc.arguments,
                 }));
+                if (cfg.validator) {
+                    validationResult = cfg.validator.validateToolCalls(guardrailsToolCalls);
+                }
+                else {
+                    validationResult = {
+                        toolCalls: guardrailsToolCalls,
+                        nudge: null,
+                        needsRetry: false,
+                    };
+                }
             }
-        }
-        else {
-            if (cfg.validator) {
-                validationResult = cfg.validator.validateTextResponse("");
+            else if (cleanContent) {
+                if (cfg.validator) {
+                    validationResult = cfg.validator.validateTextResponse(cleanContent);
+                }
+                else {
+                    validationResult = { toolCalls: [], nudge: null, needsRetry: false };
+                }
+                if (!validationResult.needsRetry && validationResult.toolCalls.length > 0) {
+                    resp.tool_calls = validationResult.toolCalls.map((tc) => ({
+                        id: "",
+                        name: tc.tool,
+                        arguments: tc.args,
+                    }));
+                }
             }
             else {
-                validationResult = { toolCalls: [], nudge: null, needsRetry: true };
+                if (cfg.validator) {
+                    validationResult = cfg.validator.validateTextResponse("");
+                }
+                else {
+                    validationResult = { toolCalls: [], nudge: null, needsRetry: true };
+                }
             }
         }
         lastResponse = resp;
@@ -114,6 +155,7 @@ export async function runInference(messages, cfg, sessionId = "") {
                 newMessages: currentMessages,
                 toolCallCounter,
                 attempts,
+                reasoningTree,
             };
         }
         if (cfg.errorTracker) {
@@ -132,7 +174,7 @@ export async function runInference(messages, cfg, sessionId = "") {
         }
         const failedMsg = {
             role: Role.ASSISTANT,
-            content: resp.content,
+            content: cleanContent,
             meta: { type: MessageType.TEXT_RESPONSE },
         };
         currentMessages.push(failedMsg);

package/dist/reasoning/adapter.d.ts

@@ -0,0 +1,33 @@
+import { ReasoningError } from "./errors.js";
+import { ReasoningOptions } from "./options.js";
+import { ContextTree } from "./types.js";
+export { ReasoningError };
+export declare class ReasoningAdapter {
+    private readonly opts;
+    private readonly modelFields;
+    constructor(options?: ReasoningOptions);
+    get options(): Required<ReasoningOptions>;
+    /** Map a model name to a model-specific reasoning field name. Fields
+     * registered here are consulted before the known field set. */
+    registerModelField(model: string, fieldName: string): void;
+    /** Remove reasoning from raw and return the clean content that ordinary
+     * tool-call parsers should see. Fails closed. */
+    strip(raw: unknown): string;
+    /** Normalize reasoning found in raw into a versioned context tree. Raw
+     * reasoning is never stored on the tree: nodes carry bounded summaries. */
+    extract(raw: unknown, model?: string, backend?: string): ContextTree;
+    /** Strip and extract in one call: return the clean content and tree. */
+    parse(raw: unknown, model?: string, backend?: string): {
+        clean: string;
+        tree: ContextTree;
+    };
+    private analyze;
+    private analyzeString;
+    private analyzeBytes;
+    private analyzeStructured;
+    private extractReasoningField;
+    private analyzeText;
+    private hasRecognizedKey;
+    private parseNodes;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/reasoning/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/reasoning/adapter.ts"],"names":[],"mappings":"AAcA,OAAO,EAKL,cAAc,EAKf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAoB,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAoB,WAAW,EAAsC,MAAM,YAAY,CAAC;AAE/F,OAAO,EAAE,cAAc,EAAE,CAAC;AAmE1B,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsB;gBAEtC,OAAO,CAAC,EAAE,gBAAgB;IAKtC,IAAI,OAAO,IAAI,QAAQ,CAAC,gBAAgB,CAAC,CAExC;IAED;mEAC+D;IAC/D,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAM1D;qDACiD;IACjD,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;IAI3B;+EAC2E;IAC3E,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,SAAK,EAAE,OAAO,SAAK,GAAG,WAAW;IA0B5D,wEAAwE;IACxE,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,SAAK,EAAE,OAAO,SAAK,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,WAAW,CAAA;KAAE;IAKnF,OAAO,CAAC,OAAO;IAaf,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,iBAAiB;IA+BzB,OAAO,CAAC,qBAAqB;IAqC7B,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,UAAU;CA2DnB"}