agentfootprint 1.0.0

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

@@ -0,0 +1,39 @@
+/**
+ * askHuman — Built-in tool that pauses the agent loop for human input.
+ *
+ * When the LLM calls this tool, the agent loop pauses and creates a checkpoint.
+ * The human's response is provided via agent.resume(), which continues the loop
+ * with the answer as the tool result.
+ *
+ * @example
+ * ```typescript
+ * const agent = Agent.create({ provider })
+ *   .system('You are helpful. Use ask_human when you need clarification.')
+ *   .tool(askHuman())
+ *   .build();
+ *
+ * const result = await agent.run('Process my refund');
+ * if (result.paused) {
+ *   console.log(result.pauseData.question); // "What is your order ID?"
+ *   const final = await agent.resume('ORD-123');
+ * }
+ * ```
+ */
+import type { ToolDefinition, ToolResult } from '../types/tools';
+/** Marker on ToolResult indicating this is an ask_human pause. Not globally reachable — only importable from this module. */
+export declare const ASK_HUMAN_MARKER: unique symbol;
+export interface AskHumanResult extends ToolResult {
+    /** @internal Marker for pause detection in tool execution stage. */
+    readonly [ASK_HUMAN_MARKER]: true;
+    /** The question asked by the LLM. */
+    readonly question: string;
+}
+/** Check if a tool result is an ask_human pause. */
+export declare function isAskHumanResult(result: ToolResult): result is AskHumanResult;
+/**
+ * Create the ask_human tool definition.
+ *
+ * @param description - Custom description for the LLM (optional).
+ */
+export declare function askHuman(description?: string): ToolDefinition;
+//# sourceMappingURL=askHuman.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"askHuman.d.ts","sourceRoot":"","sources":["../../../src/tools/askHuman.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjE,6HAA6H;AAC7H,eAAO,MAAM,gBAAgB,eAAqB,CAAC;AAEnD,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD,oEAAoE;IACpE,QAAQ,CAAC,CAAC,gBAAgB,CAAC,EAAE,IAAI,CAAC;IAClC,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,oDAAoD;AACpD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,IAAI,cAAc,CAO7E;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,cAAc,CA2B7D"}

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

@@ -0,0 +1,3 @@
+export { ToolRegistry, defineTool } from './ToolRegistry';
+export { askHuman } from './askHuman';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,29 @@
+/**
+ * validateToolInput — lightweight JSON Schema validation for tool arguments.
+ *
+ * Validates LLM-provided tool arguments against the tool's inputSchema
+ * before calling the handler. Catches malformed arguments early with
+ * a clear error message fed back to the LLM.
+ *
+ * Supports: required fields, type checking (string, number, boolean, object, array).
+ * Does NOT support: $ref, oneOf, allOf, pattern, min/max, nested validation.
+ * For complex schemas, use a full validator (Ajv) in the handler.
+ */
+export interface ValidationError {
+    readonly path: string;
+    readonly message: string;
+}
+export interface ValidationResult {
+    readonly valid: boolean;
+    readonly errors: readonly ValidationError[];
+}
+/**
+ * Validate tool arguments against a JSON Schema.
+ * Returns { valid: true } or { valid: false, errors: [...] }.
+ */
+export declare function validateToolInput(args: Record<string, unknown>, schema: Record<string, unknown>): ValidationResult;
+/**
+ * Format validation errors as a string for the LLM tool result.
+ */
+export declare function formatValidationErrors(errors: readonly ValidationError[]): string;
+//# sourceMappingURL=validateInput.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validateInput.d.ts","sourceRoot":"","sources":["../../../src/tools/validateInput.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,gBAAgB,CAoClB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,CAEjF"}

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

@@ -0,0 +1,9 @@
+/**
+ * Minimal Zod-to-JSON-Schema converter. Duck-typed — no zod dependency.
+ * Handles: object, string, number, boolean, array, enum, optional, default.
+ * @internal
+ */
+export declare function zodToJsonSchema(zodSchema: any): Record<string, unknown>;
+/** Duck-type check: is this a Zod schema? */
+export declare function isZodSchema(value: unknown): boolean;
+//# sourceMappingURL=zodToJsonSchema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zodToJsonSchema.d.ts","sourceRoot":"","sources":["../../../src/tools/zodToJsonSchema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoDvE;AAED,6CAA6C;AAC7C,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAInD"}

package/dist/types/tools.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Tool definitions for agent function calling.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=tools.js.map

package/dist/types/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/types/tools.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/types/types/adapter.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Adapter result — discriminated union for provider responses.
+ * Adapters normalize any provider's response into one of these shapes.
+ */
+import type { ToolCall, TokenUsage } from './index';
+/** LLM returned a final text response. */
+export interface AdapterFinalResult {
+    readonly type: 'final';
+    readonly content: string;
+    readonly usage?: TokenUsage;
+    readonly model?: string;
+}
+/** LLM requested tool calls. */
+export interface AdapterToolResult {
+    readonly type: 'tools';
+    readonly content: string;
+    readonly toolCalls: ToolCall[];
+    readonly usage?: TokenUsage;
+    readonly model?: string;
+}
+/** LLM call failed. */
+export interface AdapterErrorResult {
+    readonly type: 'error';
+    readonly code: string;
+    readonly message: string;
+    readonly retryable: boolean;
+    readonly originalError?: unknown;
+}
+export type AdapterResult = AdapterFinalResult | AdapterToolResult | AdapterErrorResult;
+/** Well-known scope paths for adapter stages. */
+export declare const ADAPTER_PATHS: {
+    readonly REQUEST: "adapterRequest";
+    readonly RESPONSE: "adapterRawResponse";
+    readonly RESULT: "adapterResult";
+};
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/types/adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEpD,0CAA0C;AAC1C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,gCAAgC;AAChC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,uBAAuB;AACvB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,MAAM,aAAa,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;AAExF,iDAAiD;AACjD,eAAO,MAAM,aAAa;;;;CAIhB,CAAC"}

package/dist/types/types/agent.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Agent configuration and result types.
+ */
+import type { FlowChart } from 'footprintjs';
+import type { Message } from './messages';
+export interface AgentConfig {
+    readonly name: string;
+    readonly systemPrompt?: string;
+    readonly maxIterations: number;
+    readonly toolIds: string[];
+}
+export interface AgentBuildResult {
+    readonly flowChart: FlowChart<unknown, unknown>;
+    readonly name: string;
+    readonly config: AgentConfig;
+}
+export interface AgentResult {
+    readonly content: string;
+    readonly messages: Message[];
+    readonly iterations: number;
+    /** True when the agent paused (ask_human tool). Call agent.resume() to continue. */
+    readonly paused?: boolean;
+    /** Pause data from ask_human (question + toolCallId). */
+    readonly pauseData?: {
+        question: string;
+        toolCallId: string;
+    };
+}
+export interface AgentRunOptions {
+    /** User message to send. */
+    readonly message: string;
+    /** Abort signal for cancellation. */
+    readonly signal?: AbortSignal;
+    /** Timeout in milliseconds. */
+    readonly timeoutMs?: number;
+}
+//# sourceMappingURL=agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/types/agent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,oFAAoF;IACpF,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/D;AAED,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qCAAqC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,+BAA+B;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/types/types/content.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Multi-modal content blocks for LLM messages.
+ * Provider-agnostic — adapters translate to/from provider formats (Anthropic, OpenAI, etc.).
+ *
+ * Design: discriminated union on `type` field, like Anthropic's API.
+ * Every message's `content` is `string | ContentBlock[]` — string for backward compat,
+ * ContentBlock[] for multi-modal (images, tool use, structured results).
+ */
+export interface TextBlock {
+    readonly type: 'text';
+    readonly text: string;
+}
+export interface ImageBlock {
+    readonly type: 'image';
+    readonly source: ImageSource;
+}
+export interface ToolUseBlock {
+    readonly type: 'tool_use';
+    readonly id: string;
+    readonly name: string;
+    readonly input: Record<string, unknown>;
+}
+export interface ToolResultBlock {
+    readonly type: 'tool_result';
+    readonly toolUseId: string;
+    readonly content: string | ContentBlock[];
+    readonly isError?: boolean;
+}
+export type ContentBlock = TextBlock | ImageBlock | ToolUseBlock | ToolResultBlock;
+export interface Base64ImageSource {
+    readonly type: 'base64';
+    readonly mediaType: string;
+    readonly data: string;
+}
+export interface UrlImageSource {
+    readonly type: 'url';
+    readonly url: string;
+}
+export type ImageSource = Base64ImageSource | UrlImageSource;
+/** Content of a message — plain string (backward compat) or structured blocks. */
+export type MessageContent = string | ContentBlock[];
+/**
+ * Callback for streaming LLM responses token-by-token.
+ * Passed through provider interfaces so consumers can receive
+ * incremental output without waiting for the full response.
+ */
+export type StreamCallback = (chunk: StreamChunk) => void;
+export interface StreamChunk {
+    readonly type: 'text' | 'tool_use_start' | 'tool_use_input' | 'done';
+    /** Text delta (for type: 'text'). */
+    readonly text?: string;
+    /** Tool call being streamed (for type: 'tool_use_start'). */
+    readonly toolUseId?: string;
+    /** Tool name (for type: 'tool_use_start'). */
+    readonly toolName?: string;
+    /** Partial JSON input (for type: 'tool_use_input'). */
+    readonly partialInput?: string;
+}
+export declare function textBlock(text: string): TextBlock;
+export declare function imageBlock(source: ImageSource): ImageBlock;
+export declare function base64Image(mediaType: string, data: string): ImageBlock;
+export declare function urlImage(url: string): ImageBlock;
+export declare function toolUseBlock(id: string, name: string, input: Record<string, unknown>): ToolUseBlock;
+export declare function toolResultBlock(toolUseId: string, content: string | ContentBlock[], isError?: boolean): ToolResultBlock;
+/**
+ * Convert a legacy ToolCall (from AssistantMessage.toolCalls) to a ToolUseBlock.
+ * Bridges the two representations: ToolCall uses `arguments`, ToolUseBlock uses `input`.
+ */
+export declare function toolCallToBlock(call: {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}): ToolUseBlock;
+/**
+ * Convert a ToolUseBlock to a legacy ToolCall format.
+ * Bridges the two representations: ToolUseBlock uses `input`, ToolCall uses `arguments`.
+ */
+export declare function blockToToolCall(block: ToolUseBlock): {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+};
+/**
+ * Extract text from message content, regardless of form.
+ * - string → returned as-is
+ * - ContentBlock[] → concatenates all TextBlock.text values
+ *
+ * Use this instead of `msg.content.length` or string operations on content.
+ */
+export declare function getTextContent(content: MessageContent): string;
+/**
+ * Get the character length of message content (for budget calculations).
+ * Handles both string and ContentBlock[] forms.
+ */
+export declare function contentLength(content: MessageContent): number;
+/**
+ * Check if content contains any tool use blocks.
+ */
+export declare function hasToolUseBlocks(content: MessageContent): boolean;
+/**
+ * Extract tool use blocks from content.
+ */
+export declare function getToolUseBlocks(content: MessageContent): ToolUseBlock[];
+//# sourceMappingURL=content.d.ts.map

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

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

package/dist/types/types/errors.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Normalized error types for LLM provider errors.
+ *
+ * All adapters wrap SDK-specific errors into LLMError so that
+ * compositions (withRetry, withFallback, withCircuitBreaker)
+ * can make uniform decisions.
+ */
+export type LLMErrorCode = 'auth' | 'rate_limit' | 'context_length' | 'invalid_request' | 'server' | 'timeout' | 'aborted' | 'network' | 'unknown';
+export declare class LLMError extends Error {
+    readonly code: LLMErrorCode;
+    readonly provider: string;
+    readonly statusCode?: number;
+    readonly retryable: boolean;
+    readonly cause?: Error;
+    constructor(opts: {
+        message: string;
+        code: LLMErrorCode;
+        provider: string;
+        statusCode?: number;
+        cause?: Error;
+    });
+}
+/** Classify an HTTP status code into an LLMErrorCode. */
+export declare function classifyStatusCode(status: number): LLMErrorCode;
+/** Wrap an unknown SDK error into an LLMError. */
+export declare function wrapSDKError(err: unknown, provider: string): LLMError;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,YAAY,GACZ,gBAAgB,GAChB,iBAAiB,GACjB,QAAQ,GACR,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,CAAC;AAEd,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;gBAEX,IAAI,EAAE;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,YAAY,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,KAAK,CAAC;KACf;CASF;AAMD,yDAAyD;AACzD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAO/D;AAED,kDAAkD;AAClD,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAsCrE"}

package/dist/types/types/index.d.ts

@@ -0,0 +1,14 @@
+export type { ContentBlock, TextBlock, ImageBlock, ToolUseBlock, ToolResultBlock, ImageSource, Base64ImageSource, UrlImageSource, MessageContent, StreamCallback, StreamChunk, } from './content';
+export { textBlock, imageBlock, base64Image, urlImage, toolUseBlock, toolResultBlock, toolCallToBlock, blockToToolCall, getTextContent, contentLength, hasToolUseBlocks, getToolUseBlocks, } from './content';
+export type { SystemMessage, UserMessage, AssistantMessage, ToolResultMessage, Message, ToolCall, } from './messages';
+export { systemMessage, userMessage, assistantMessage, toolResultMessage, hasToolCalls, } from './messages';
+export type { LLMProvider, LLMCallOptions, LLMResponse, LLMStreamChunk, TokenUsage, LLMToolDescription, ResponseFormat, FinishReason, } from './llm';
+export type { ToolDefinition, ToolHandler, ToolResult } from './tools';
+export type { AdapterResult, AdapterFinalResult, AdapterToolResult, AdapterErrorResult, } from './adapter';
+export { ADAPTER_PATHS } from './adapter';
+export type { AgentConfig, AgentBuildResult, AgentResult, AgentRunOptions } from './agent';
+export type { RetrieverProvider, RetrieveOptions, RetrievalChunk, RetrievalResult, RAGResult, } from './retriever';
+export type { RunnerLike, AgentStageConfig, AgentResultEntry, TraversalResult } from './multiAgent';
+export type { LLMErrorCode } from './errors';
+export { LLMError, classifyStatusCode, wrapSDKError } from './errors';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,SAAS,EACT,UAAU,EACV,YAAY,EACZ,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,SAAS,EACT,UAAU,EACV,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,eAAe,EACf,eAAe,EACf,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAEnB,YAAY,EACV,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,OAAO,EACP,QAAQ,GACT,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,WAAW,EACX,cAAc,EACd,WAAW,EACX,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,YAAY,GACb,MAAM,OAAO,CAAC;AAEf,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEvE,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE3F,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,eAAe,EACf,SAAS,GACV,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpG,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

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

@@ -0,0 +1,78 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,40 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,57 @@
+/**
+ * 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;
+    }>;
+    getNarrative?(): 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;
+}
+//# sourceMappingURL=multiAgent.d.ts.map

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

@@ -0,0 +1 @@
+{"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,YAAY,CAAC,IAAI,MAAM,EAAE,CAAC;IAC1B,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;CACjC"}

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

@@ -0,0 +1,41 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,19 @@
+/**
+ * Tool definitions for agent function calling.
+ */
+export interface ToolDefinition {
+    /** Unique tool identifier. */
+    readonly id: string;
+    /** Human-readable description (sent to LLM). */
+    readonly description: string;
+    /** JSON Schema for tool input. */
+    readonly inputSchema: Record<string, unknown>;
+    /** Handler function. Returns string result. */
+    readonly handler: ToolHandler;
+}
+export type ToolHandler = (input: Record<string, unknown>) => Promise<ToolResult> | ToolResult;
+export interface ToolResult {
+    readonly content: string;
+    readonly error?: boolean;
+}
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/types/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kCAAkC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC;AAE/F,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B"}