agentfootprint 1.22.0 → 2.0.1

package/dist/types/types/llm.d.ts

@@ -1,78 +0,0 @@
-/**
- * Provider-agnostic LLM interface.
- * No SDK dependency — consumers implement for their provider.
- */
-import type { StreamCallback } from './content';
-import type { Message, ToolCall } from './messages';
-export interface LLMProvider {
-    /** Send messages and get a response. */
-    chat(messages: Message[], options?: LLMCallOptions): Promise<LLMResponse>;
-    /** Stream response token-by-token. Optional — not all providers support it. */
-    chatStream?(messages: Message[], options?: LLMCallOptions): AsyncIterable<LLMStreamChunk>;
-}
-export interface LLMCallOptions {
-    /** Tool descriptions for function calling. */
-    readonly tools?: LLMToolDescription[];
-    /** Max tokens in response. */
-    readonly maxTokens?: number;
-    /** Temperature (0-1). */
-    readonly temperature?: number;
-    /** Stop sequences. */
-    readonly stop?: string[];
-    /** AbortSignal for cancellation. */
-    readonly signal?: AbortSignal;
-    /** Callback for streaming tokens incrementally. When provided, the LLM provider should emit chunks as they arrive. */
-    readonly streamCallback?: StreamCallback;
-    /**
-     * Request structured JSON output matching a schema.
-     * Each adapter handles this differently:
-     * - OpenAI: passes as native `response_format`
-     * - Anthropic: injects schema into system prompt + validates
-     * - Custom: adapter decides the strategy
-     */
-    readonly responseFormat?: ResponseFormat;
-}
-/** Structured output format request. */
-export interface ResponseFormat {
-    readonly type: 'json_schema';
-    /** JSON Schema the response must conform to. */
-    readonly schema: Record<string, unknown>;
-    /** Optional name for the schema (used by OpenAI's API). */
-    readonly name?: string;
-    /**
-     * Where to inject the schema instruction for providers without native support (e.g., Anthropic).
-     * - `'system'` — append to system prompt (default)
-     * - `'user'` — inject as the last user message (recency window — higher LLM attention)
-     *
-     * OpenAI ignores this — it uses native `response_format`.
-     */
-    readonly injection?: 'system' | 'user';
-}
-/** Normalized finish reason across all providers. */
-export type FinishReason = 'stop' | 'tool_calls' | 'length' | 'error';
-export interface LLMResponse {
-    readonly content: string;
-    readonly toolCalls?: ToolCall[];
-    readonly usage?: TokenUsage;
-    readonly model?: string;
-    readonly finishReason?: FinishReason;
-    /** Extended thinking text. Present when the model uses extended thinking (e.g., Anthropic with thinking enabled). Requires provider-specific configuration. */
-    readonly thinking?: string;
-}
-export interface LLMStreamChunk {
-    readonly type: 'token' | 'thinking' | 'tool_call' | 'usage' | 'done';
-    readonly content?: string;
-    readonly toolCall?: ToolCall;
-    readonly usage?: TokenUsage;
-}
-export interface TokenUsage {
-    readonly inputTokens: number;
-    readonly outputTokens: number;
-    readonly totalTokens?: number;
-}
-export interface LLMToolDescription {
-    readonly name: string;
-    readonly description: string;
-    readonly inputSchema: Record<string, unknown>;
-}
-//# sourceMappingURL=llm.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../../src/types/llm.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE1E,+EAA+E;IAC/E,UAAU,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;CAC3F;AAED,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACtC,8BAA8B;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,yBAAyB;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,sBAAsB;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,oCAAoC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,sHAAsH;IACtH,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;CAC1C;AAED,wCAAwC;AACxC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;CACxC;AAED,qDAAqD;AACrD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEtE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,+JAA+J;IAC/J,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;IACrE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/C"}

package/dist/types/types/messages.d.ts

@@ -1,40 +0,0 @@
-/**
- * Message types for LLM conversation.
- * Provider-agnostic — adapters translate to/from provider formats.
- *
- * Content can be a plain string (backward compat) or ContentBlock[]
- * for multi-modal messages (images, structured tool results, etc.).
- */
-import type { MessageContent } from './content';
-export interface SystemMessage {
-    readonly role: 'system';
-    readonly content: string;
-}
-export interface UserMessage {
-    readonly role: 'user';
-    readonly content: MessageContent;
-}
-export interface AssistantMessage {
-    readonly role: 'assistant';
-    readonly content: MessageContent;
-    readonly toolCalls?: ToolCall[];
-}
-export interface ToolResultMessage {
-    readonly role: 'tool';
-    readonly content: MessageContent;
-    readonly toolCallId: string;
-}
-export type Message = SystemMessage | UserMessage | AssistantMessage | ToolResultMessage;
-export interface ToolCall {
-    readonly id: string;
-    readonly name: string;
-    readonly arguments: Record<string, unknown>;
-}
-export declare function systemMessage(content: string): SystemMessage;
-export declare function userMessage(content: MessageContent): UserMessage;
-export declare function assistantMessage(content: MessageContent, toolCalls?: ToolCall[]): AssistantMessage;
-export declare function toolResultMessage(content: MessageContent, toolCallId: string): ToolResultMessage;
-export declare function hasToolCalls(msg: Message): msg is AssistantMessage & {
-    toolCalls: ToolCall[];
-};
-//# sourceMappingURL=messages.d.ts.map

package/dist/types/types/messages.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../src/types/messages.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,OAAO,GAAG,aAAa,GAAG,WAAW,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;AAEzF,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAID,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAE5D;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,WAAW,CAEhE;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,cAAc,EACvB,SAAS,CAAC,EAAE,QAAQ,EAAE,GACrB,gBAAgB,CAElB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,iBAAiB,CAEhG;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,gBAAgB,GAAG;IAAE,SAAS,EAAE,QAAQ,EAAE,CAAA;CAAE,CAE9F"}

package/dist/types/types/multiAgent.d.ts

@@ -1,66 +0,0 @@
-/**
- * Multi-Agent types — duck-typed interfaces for composing runners into pipelines.
- */
-/**
- * Duck-typed interface — any runner (Agent, RAG, LLMCall, or user-built)
- * that has a `.run()` method can be wrapped as a flowchart stage.
- */
-export interface RunnerLike {
-    run(message: string, options?: {
-        signal?: AbortSignal;
-        timeoutMs?: number;
-    }): Promise<{
-        content: string;
-    }>;
-    getNarrativeEntries?(): Array<{
-        text: string;
-    }>;
-    getSnapshot?(): unknown;
-}
-/**
- * Configuration for wrapping a runner as a flowchart stage.
- */
-export interface AgentStageConfig {
-    /** Unique identifier for this agent in the pipeline. */
-    readonly id: string;
-    /** Human-readable name (used in narrative). */
-    readonly name: string;
-    /** The runner to execute. */
-    readonly runner: RunnerLike;
-    /** Maps scope state to the input message for this runner. Defaults to reading 'pipelineInput'. */
-    readonly inputMapper?: (state: Record<string, unknown>) => string;
-    /** Maps runner output back into scope state. Defaults to writing 'result'. */
-    readonly outputMapper?: (output: {
-        content: string;
-    }, state: Record<string, unknown>) => Record<string, unknown>;
-}
-/**
- * Entry recording a single agent's execution within a pipeline.
- */
-export interface AgentResultEntry {
-    readonly id: string;
-    readonly name: string;
-    readonly content: string;
-    readonly latencyMs: number;
-    readonly narrative?: string[];
-}
-/**
- * Result of a flowchart traversal.
- * Every composed execution (Pipeline, Swarm, custom) produces this shape.
- */
-export interface TraversalResult {
-    /** Final output content. */
-    readonly content: string;
-    /** Results from each runner in execution order. */
-    readonly agents: AgentResultEntry[];
-    /** Total traversal execution time. */
-    readonly totalLatencyMs: number;
-    /**
-     * True when the traversal ended because `loopCount >= maxIterations` in the
-     * underlying agent loop (set by `safeDecider`), rather than because the LLM
-     * chose to stop. Surfaced uniformly across Swarm / Pipeline / custom runners
-     * so consumers can render a distinct "agent gave up" state.
-     */
-    readonly maxIterationsReached?: boolean;
-}
-//# sourceMappingURL=multiAgent.d.ts.map

package/dist/types/types/multiAgent.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"multiAgent.d.ts","sourceRoot":"","sources":["../../../src/types/multiAgent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,CACD,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GACrD,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChC,mBAAmB,CAAC,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,WAAW,CAAC,IAAI,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,kGAAkG;IAClG,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;IAClE,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,CAAC,EAAE,CACtB,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,EAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC;IACpC,sCAAsC;IACtC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CACzC"}

package/dist/types/types/retriever.d.ts

@@ -1,41 +0,0 @@
-/**
- * Retriever types — the contract for retrieval providers.
- * Users implement RetrieverProvider for their vector store (Pinecone, Chroma, pg_vector, etc.).
- */
-import type { Message } from './messages';
-export interface RetrieveOptions {
-    /** Number of chunks to retrieve. */
-    readonly topK?: number;
-    /** Metadata filter for narrowing results. */
-    readonly filter?: Record<string, unknown>;
-    /** Minimum relevance score (0-1). Chunks below this are excluded. */
-    readonly minScore?: number;
-}
-export interface RetrievalChunk {
-    /** The text content of this chunk. */
-    readonly content: string;
-    /** Relevance score (0-1). */
-    readonly score?: number;
-    /** Source metadata (document ID, page number, URL, etc.). */
-    readonly metadata?: Record<string, unknown>;
-    /** Unique chunk identifier for citation. */
-    readonly id?: string;
-}
-export interface RetrievalResult {
-    /** Retrieved chunks, ordered by relevance. */
-    readonly chunks: RetrievalChunk[];
-    /** The query that was used for retrieval. */
-    readonly query: string;
-}
-/** The retriever contract. Implement this for your vector store. */
-export interface RetrieverProvider {
-    retrieve(query: string, options?: RetrieveOptions): Promise<RetrievalResult>;
-}
-/** Result returned by RAGRunner.run(). */
-export interface RAGResult {
-    readonly content: string;
-    readonly messages: Message[];
-    readonly chunks: RetrievalChunk[];
-    readonly query: string;
-}
-//# sourceMappingURL=retriever.d.ts.map

package/dist/types/types/retriever.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"retriever.d.ts","sourceRoot":"","sources":["../../../src/types/retriever.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IAClC,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,oEAAoE;AACpE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC9E;AAED,0CAA0C;AAC1C,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB"}

package/dist/types/types/tools.d.ts

@@ -1,78 +0,0 @@
-/**
- * Tool definitions for agent function calling.
- */
-/**
- * Duck-typed shape for a Zod schema. Kept minimal so consumers can pass a
- * Zod v3 schema without a type-level zod dependency. `defineTool()` detects
- * Zod at runtime via `_def` + `safeParse` and auto-converts to JSON Schema
- * via `zodToJsonSchema()` before returning.
- */
-export interface ZodSchemaLike {
-    readonly _def: unknown;
-    readonly safeParse: (input: unknown) => unknown;
-}
-export interface ToolDefinition {
-    /** Unique tool identifier. */
-    readonly id: string;
-    /** Human-readable description (sent to LLM). */
-    readonly description: string;
-    /**
-     * JSON Schema for tool input. Always a plain object by the time a
-     * `ToolDefinition` flows through the library; Zod is accepted only at
-     * `defineTool()` construction time and converted eagerly.
-     */
-    readonly inputSchema: Record<string, unknown>;
-    /** Handler function. Receives parsed LLM arguments. */
-    readonly handler: ToolHandler;
-}
-/**
- * Shape accepted by `defineTool()` — like `ToolDefinition` but `inputSchema`
- * may additionally be a Zod schema. Separate from `ToolDefinition` so types
- * downstream of `defineTool()` stay narrow.
- */
-export interface ToolDefinitionInput {
-    readonly id: string;
-    readonly description: string;
-    readonly inputSchema: Record<string, unknown> | ZodSchemaLike;
-    readonly handler: ToolHandler;
-}
-/**
- * Tool handler function.
- *
- * Input is typed as `any` to allow destructured typed parameters
- * in tool definitions. The runtime input is always a parsed JSON object
- * from the LLM's tool call arguments.
- *
- * @example
- * ```typescript
- * // Destructure directly — the common pattern:
- * handler: async ({ query }: { query: string }) => ({ content: `Results for: ${query}` })
- *
- * // Or use the raw input:
- * handler: async (input) => ({ content: `${input.query}` })
- * ```
- */
-export type ToolHandler = (input: any) => Promise<ToolResult> | ToolResult;
-export interface ToolResult {
-    readonly content: string;
-    readonly error?: boolean;
-    /**
-     * Optional — a partial decision-scope update to merge after the tool
-     * executes. The agent loop's tool-execution stage applies this into
-     * the current decision ref, so downstream `AgentInstruction.activeWhen`
-     * predicates see the new state on the next iteration.
-     *
-     * Primary use case: tools that activate a mode / skill / routing
-     * branch by writing a single scalar into decision scope. Example:
-     * the auto-generated `read_skill` tool (from `SkillRegistry` with
-     * `autoActivate` configured) returns
-     *   `{ content, decisionUpdate: { [stateField]: skillId } }`
-     * so skill-gated `activeWhen: (d) => d.currentSkill === 'x'`
-     * predicates fire without any user-written bridge.
-     *
-     * Merge semantics: shallow `Object.assign(decision, decisionUpdate)`.
-     * Not provided → decision unchanged.
-     */
-    readonly decisionUpdate?: Record<string, unknown>;
-}
-//# sourceMappingURL=tools.d.ts.map

package/dist/types/types/tools.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/types/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CACjD;AAED,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,CAAC;IAC9D,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC;AAE3E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnD"}