groundswell 0.0.2 → 1.0.0

package/dist/core/factory.js

@@ -0,0 +1,110 @@
+/**
+ * Factory Functions - Convenience functions for dynamic workflow, agent, and prompt creation
+ *
+ * These functions provide a simple API for creating workflow components dynamically
+ * at runtime, useful for metaprogramming and agent-driven workflow construction.
+ */
+import { Workflow } from './workflow.js';
+import { Agent } from './agent.js';
+import { Prompt } from './prompt.js';
+/**
+ * Create a new Workflow instance
+ *
+ * @param config Workflow configuration
+ * @param executor Executor function that receives WorkflowContext
+ * @returns Configured Workflow instance
+ *
+ * @example
+ * ```ts
+ * const workflow = createWorkflow(
+ *   { name: 'DataPipeline', enableReflection: true },
+ *   async (ctx) => {
+ *     const data = await ctx.step('fetch', () => fetchData());
+ *     const processed = await ctx.step('process', () => processData(data));
+ *     return processed;
+ *   }
+ * );
+ *
+ * const result = await workflow.run();
+ * ```
+ */
+export function createWorkflow(config, executor) {
+    return new Workflow(config, executor);
+}
+/**
+ * Create a new Agent instance
+ *
+ * @param config Agent configuration
+ * @returns Configured Agent instance
+ *
+ * @example
+ * ```ts
+ * const agent = createAgent({
+ *   name: 'DataAnalyst',
+ *   system: 'You analyze data and provide insights.',
+ *   enableCache: true,
+ *   enableReflection: true,
+ * });
+ *
+ * const result = await agent.prompt(analysisPrompt);
+ * ```
+ */
+export function createAgent(config) {
+    return new Agent(config);
+}
+/**
+ * Create a new Prompt instance
+ *
+ * @param config Prompt configuration
+ * @returns Configured Prompt instance
+ *
+ * @example
+ * ```ts
+ * const prompt = createPrompt({
+ *   user: 'Analyze this data',
+ *   data: { values: [1, 2, 3, 4, 5] },
+ *   responseFormat: z.object({
+ *     summary: z.string(),
+ *     insights: z.array(z.string()),
+ *   }),
+ * });
+ *
+ * const result = await agent.prompt(prompt);
+ * ```
+ */
+export function createPrompt(config) {
+    return new Prompt(config);
+}
+/**
+ * Create a workflow with an inline executor (shorthand)
+ *
+ * @param name Workflow name
+ * @param executor Executor function
+ * @returns Configured Workflow instance
+ *
+ * @example
+ * ```ts
+ * const workflow = quickWorkflow('ProcessData', async (ctx) => {
+ *   return await ctx.step('process', () => processData());
+ * });
+ * ```
+ */
+export function quickWorkflow(name, executor) {
+    return new Workflow({ name }, executor);
+}
+/**
+ * Create a simple agent with minimal configuration (shorthand)
+ *
+ * @param name Agent name
+ * @param system System prompt
+ * @returns Configured Agent instance
+ *
+ * @example
+ * ```ts
+ * const agent = quickAgent('Helper', 'You are a helpful assistant.');
+ * ```
+ */
+export function quickAgent(name, system) {
+    return new Agent({ name, system });
+}
+//# sourceMappingURL=factory.js.map

package/dist/core/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/core/factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAyB,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAIrC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAsB,EACtB,QAA6B;IAE7B,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,WAAW,CAAC,MAAmB;IAC7C,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,YAAY,CAAI,MAAuB;IACrD,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,QAA6B;IAE7B,OAAO,IAAI,QAAQ,CAAC,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,MAAe;IACtD,OAAO,IAAI,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;AACrC,CAAC"}

package/{src/core/index.ts → dist/core/index.d.ts}

@@ -5,13 +5,5 @@ export { Prompt } from './prompt.js';
 export { MCPHandler, type ToolExecutor } from './mcp-handler.js';
 export { EventTreeHandleImpl, createEventTreeHandle } from './event-tree.js';
 export { WorkflowContextImpl, createWorkflowContext } from './workflow-context.js';
-export {
-  getExecutionContext,
-  requireExecutionContext,
-  runInContext,
-  runInContextSync,
-  hasExecutionContext,
-  createChildContext,
-  agentExecutionStorage,
-  type AgentExecutionContext,
-} from './context.js';
+export { getExecutionContext, requireExecutionContext, runInContext, runInContextSync, hasExecutionContext, createChildContext, agentExecutionStorage, type AgentExecutionContext, } from './context.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,cAAc,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,9 @@
+export { WorkflowLogger } from './logger.js';
+export { Workflow } from './workflow.js';
+export { Agent } from './agent.js';
+export { Prompt } from './prompt.js';
+export { MCPHandler } from './mcp-handler.js';
+export { EventTreeHandleImpl, createEventTreeHandle } from './event-tree.js';
+export { WorkflowContextImpl, createWorkflowContext } from './workflow-context.js';
+export { getExecutionContext, requireExecutionContext, runInContext, runInContextSync, hasExecutionContext, createChildContext, agentExecutionStorage, } from './context.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAyB,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,KAAK,EAAqB,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAqB,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,GAEtB,MAAM,cAAc,CAAC"}

package/dist/core/logger.d.ts

@@ -0,0 +1,50 @@
+import type { WorkflowNode, LogEntry, WorkflowObserver } from '../types/index.js';
+/**
+ * Logger that emits log entries to workflow node and observers
+ */
+export declare class WorkflowLogger {
+    private readonly node;
+    private readonly observers;
+    private readonly parentLogId?;
+    constructor(node: WorkflowNode, observers: WorkflowObserver[], parentLogId?: string);
+    /**
+     * Emit a log entry directly to the node without notifying observers
+     * Used to avoid infinite recursion when observer.onLog() throws
+     */
+    private emitWithoutObserverNotification;
+    /**
+     * Emit a log entry to the node and all observers
+     */
+    private emit;
+    /**
+     * Create a log entry with the given level
+     */
+    private log;
+    /**
+     * Log a debug message
+     */
+    debug(message: string, data?: unknown): void;
+    /**
+     * Log an info message
+     */
+    info(message: string, data?: unknown): void;
+    /**
+     * Log a warning message
+     */
+    warn(message: string, data?: unknown): void;
+    /**
+     * Log an error message
+     */
+    error(message: string, data?: unknown): void;
+    /**
+     * Create a child logger that includes parentLogId
+     * @param parentLogId - ID of the parent log entry (legacy API)
+     */
+    child(parentLogId: string): WorkflowLogger;
+    /**
+     * Create a child logger with metadata
+     * @param meta - Partial log entry metadata (typically { parentLogId: string })
+     */
+    child(meta: Partial<LogEntry>): WorkflowLogger;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAY,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG5F;;GAEG;AACH,qBAAa,cAAc;IAIvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;gBAGnB,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,gBAAgB,EAAE,EAC9C,WAAW,CAAC,EAAE,MAAM;IAKtB;;;OAGG;IACH,OAAO,CAAC,+BAA+B;IAIvC;;OAEG;IACH,OAAO,CAAC,IAAI;IAoBZ;;OAEG;IACH,OAAO,CAAC,GAAG;IAkBX;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI5C;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI3C;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI3C;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI5C;;;OAGG;IACH,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc;IAC1C;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,cAAc;CAK/C"}

package/dist/core/logger.js

@@ -0,0 +1,91 @@
+import { generateId } from '../utils/id.js';
+/**
+ * Logger that emits log entries to workflow node and observers
+ */
+export class WorkflowLogger {
+    node;
+    observers;
+    parentLogId;
+    constructor(node, observers, parentLogId) {
+        this.node = node;
+        this.observers = observers;
+        this.parentLogId = parentLogId;
+    }
+    /**
+     * Emit a log entry directly to the node without notifying observers
+     * Used to avoid infinite recursion when observer.onLog() throws
+     */
+    emitWithoutObserverNotification(entry) {
+        this.node.logs.push(entry);
+    }
+    /**
+     * Emit a log entry to the node and all observers
+     */
+    emit(entry) {
+        this.node.logs.push(entry);
+        for (const obs of this.observers) {
+            try {
+                obs.onLog(entry);
+            }
+            catch (err) {
+                // Create error entry and emit without observer notification to avoid infinite recursion
+                const errorEntry = {
+                    id: generateId(),
+                    workflowId: this.node.id,
+                    timestamp: Date.now(),
+                    level: 'error',
+                    message: 'Observer onLog error',
+                    data: { error: err },
+                };
+                this.emitWithoutObserverNotification(errorEntry);
+            }
+        }
+    }
+    /**
+     * Create a log entry with the given level
+     */
+    log(level, message, data) {
+        const entry = {
+            id: generateId(),
+            workflowId: this.node.id,
+            timestamp: Date.now(),
+            level,
+            message,
+            data,
+        };
+        // Add parent log ID if this is a child logger
+        if (this.parentLogId) {
+            entry.parentLogId = this.parentLogId;
+        }
+        this.emit(entry);
+    }
+    /**
+     * Log a debug message
+     */
+    debug(message, data) {
+        this.log('debug', message, data);
+    }
+    /**
+     * Log an info message
+     */
+    info(message, data) {
+        this.log('info', message, data);
+    }
+    /**
+     * Log a warning message
+     */
+    warn(message, data) {
+        this.log('warn', message, data);
+    }
+    /**
+     * Log an error message
+     */
+    error(message, data) {
+        this.log('error', message, data);
+    }
+    child(input) {
+        const parentLogId = typeof input === 'string' ? input : input.parentLogId;
+        return new WorkflowLogger(this.node, this.observers, parentLogId);
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;GAEG;AACH,MAAM,OAAO,cAAc;IAIN;IACA;IAJF,WAAW,CAAU;IAEtC,YACmB,IAAkB,EAClB,SAA6B,EAC9C,WAAoB;QAFH,SAAI,GAAJ,IAAI,CAAc;QAClB,cAAS,GAAT,SAAS,CAAoB;QAG9C,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;;OAGG;IACK,+BAA+B,CAAC,KAAe;QACrD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACK,IAAI,CAAC,KAAe;QAC1B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACnB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,wFAAwF;gBACxF,MAAM,UAAU,GAAa;oBAC3B,EAAE,EAAE,UAAU,EAAE;oBAChB,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;oBACxB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;oBACrB,KAAK,EAAE,OAAO;oBACd,OAAO,EAAE,sBAAsB;oBAC/B,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE;iBACrB,CAAC;gBACF,IAAI,CAAC,+BAA+B,CAAC,UAAU,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,IAAc;QAC1D,MAAM,KAAK,GAAa;YACtB,EAAE,EAAE,UAAU,EAAE;YAChB,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;YACxB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,KAAK;YACL,OAAO;YACP,IAAI;SACL,CAAC;QAEF,8CAA8C;QAC9C,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACvC,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAe,EAAE,IAAc;QACnC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAe,EAAE,IAAc;QAClC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAe,EAAE,IAAc;QAClC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAe,EAAE,IAAc;QACnC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAYD,KAAK,CAAC,KAAiC;QACrC,MAAM,WAAW,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC;QAC1E,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACpE,CAAC;CACF"}

package/dist/core/mcp-handler.d.ts

@@ -0,0 +1,127 @@
+/**
+ * MCP Handler - Manages MCP server connections and tool execution
+ *
+ * Provides integration with MCP (Model Context Protocol) servers,
+ * converting MCP tools to Anthropic Tool format and Agent SDK MCP format.
+ */
+import { type McpServerConfig } from '@anthropic-ai/claude-agent-sdk';
+import type { ToolDefinition, AgentToolResult } from '@earendil-works/pi-coding-agent';
+import type { MCPServer, Tool, ToolResult, ToolExecutionResult, ToolExecutionRequest } from '../types/index.js';
+/**
+ * Tool executor function type
+ */
+export type ToolExecutor = (input: unknown) => Promise<unknown>;
+/**
+ * MCPHandler - Manages MCP server registration and tool execution
+ *
+ * Supports:
+ * - inprocess transport: Direct tool registration with executors
+ * - stdio transport: External MCP server processes
+ * - Agent SDK integration: Convert to SDK MCP server format
+ */
+export declare class MCPHandler {
+    /** Registered MCP servers */
+    private servers;
+    /** Registered tools from all servers */
+    private registeredTools;
+    /** Custom tool executors for inprocess servers */
+    private toolExecutors;
+    /**
+     * Register an MCP server
+     * @param server MCP server configuration
+     */
+    registerServer(server: MCPServer): void;
+    /**
+     * Unregister an MCP server
+     * @param name Server name to unregister
+     */
+    unregisterServer(name: string): void;
+    /**
+     * Register a custom tool executor for an inprocess tool
+     * @param serverName Server name
+     * @param toolName Tool name
+     * @param executor Executor function
+     */
+    registerToolExecutor(serverName: string, toolName: string, executor: ToolExecutor): void;
+    /**
+     * Get all tools from registered servers in Anthropic format
+     * @returns Array of Tool definitions
+     */
+    getTools(): Tool[];
+    /**
+     * Execute a tool by name
+     * @param toolName Full tool name (serverName__toolName)
+     * @param input Tool input
+     * @returns Tool result
+     */
+    executeTool(toolName: string, input: unknown): Promise<ToolResult>;
+    /**
+     * Check if a tool is registered
+     * @param toolName Tool name to check
+     */
+    hasTool(toolName: string): boolean;
+    /**
+     * Get registered server names
+     */
+    getServerNames(): string[];
+    /**
+     * Convert to Agent SDK MCP server configuration
+     * Returns an SDK MCP server that can be used with query()
+     */
+    toAgentSDKServer(): McpServerConfig | null;
+    /**
+     * Convert registered tools to Pi `ToolDefinition[]` (PRD §7.10, §7.12, §7.14.1).
+     *
+     * PARALLEL of {@link toAgentSDKServer} (Claude): iterates `registeredTools`, wraps each
+     * in a Pi ToolDefinition via `defineTool`, and delegates `execute` to
+     * `registered.executor`. `parameters` is the REAL TypeBox schema from
+     * `jsonSchemaToTypebox` (S1). Returns `[]` when no tools registered.
+     *
+     * `registered.executor` returns the RAW executor output (unknown) — stringified
+     * via {@link toAgentToolResult} (mirrors toAgentSDKServer's handler). Errors are
+     * caught → isError:true (never re-thrown), matching Claude-path semantics.
+     *
+     * When `toolExecutor` is provided (PRD §7.10 bridge), each tool's `execute` dispatches
+     * through the caller-supplied executor instead of `registered.executor`. The result is
+     * converted via {@link toAgentToolResultFromExecResult} (reads `result.content`/`result.isError`).
+     */
+    toPiCustomTools(toolExecutor?: (req: ToolExecutionRequest) => Promise<ToolExecutionResult>): ToolDefinition[];
+    /**
+     * Map a raw executor result (unknown) to a Pi `AgentToolResult`.
+     *
+     * Stringifies non-string values via `JSON.stringify` (mirrors toAgentSDKServer's
+     * handler). `registered.executor` returns RAW output (unknown), NOT a
+     * `ToolExecutionResult` — so we stringify the value DIRECTLY (do NOT read
+     * `result.content`).
+     */
+    private toAgentToolResult;
+    /**
+     * Convert a `ToolExecutionResult` (the `{ content, isError }` envelope returned by a
+     * caller-supplied `toolExecutor`, e.g. `Agent.toolExecutor`) into a Pi
+     * `AgentToolResult<{ isError: boolean }>`.
+     *
+     * Unlike {@link toAgentToolResult} (which stringifies the RAW executor output blindly),
+     * this reads `result.content` as the semantic payload and `result.isError` as the error
+     * flag. Used by the PiHarness toolExecutor bridge (PRD §7.10) — see P1.M2.T1.S2.
+     *
+     * String content passes through unchanged; non-string content is JSON.stringified
+     * (mirrors `toAgentToolResult`'s stringification, but applied to `content` only).
+     */
+    toAgentToolResultFromExecResult(result: ToolExecutionResult): AgentToolResult<{
+        isError: boolean;
+    }>;
+    /**
+     * Convert JSON Schema to Zod raw shape (for tool() function)
+     * The Agent SDK tool() expects a ZodRawShape, not a ZodObject
+     */
+    private jsonSchemaToZodRawShape;
+    /**
+     * Convert a JSON Schema property to Zod type
+     */
+    private jsonSchemaPropertyToZod;
+    /**
+     * Create a tool executor based on transport type
+     */
+    private createToolExecutor;
+}
+//# sourceMappingURL=mcp-handler.d.ts.map

package/dist/core/mcp-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-handler.d.ts","sourceRoot":"","sources":["../../src/core/mcp-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAEhB,MAAM,iCAAiC,CAAC;AAGzC,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEhH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAWhE;;;;;;;GAOG;AACH,qBAAa,UAAU;IACrB,6BAA6B;IAC7B,OAAO,CAAC,OAAO,CAAqC;IAEpD,wCAAwC;IACxC,OAAO,CAAC,eAAe,CAA0C;IAEjE,kDAAkD;IAClD,OAAO,CAAC,aAAa,CAAwC;IAE7D;;;OAGG;IACI,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAoB9C;;;OAGG;IACI,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAW3C;;;;;OAKG;IACI,oBAAoB,CACzB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,YAAY,GACrB,IAAI;IAKP;;;OAGG;IACI,QAAQ,IAAI,IAAI,EAAE;IAIzB;;;;;OAKG;IACU,WAAW,CACtB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,UAAU,CAAC;IA6BtB;;;OAGG;IACI,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIzC;;OAEG;IACI,cAAc,IAAI,MAAM,EAAE;IAIjC;;;OAGG;IACI,gBAAgB,IAAI,eAAe,GAAG,IAAI;IAkDjD;;;;;;;;;;;;;;;OAeG;IACI,eAAe,CACpB,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,oBAAoB,KAAK,OAAO,CAAC,mBAAmB,CAAC,GACzE,cAAc,EAAE;IAiCnB;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;;;;;;;;;;OAWG;IACI,+BAA+B,CACpC,MAAM,EAAE,mBAAmB,GAC1B,eAAe,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IASxC;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IA8B/B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA8B/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAyB3B"}