agentx-sdk 0.1.0

package/dist/tools/json-schema-to-zod.js

@@ -0,0 +1,123 @@
+/**
+ * Deep JSON Schema → Zod converter.
+ *
+ * Converts JSON Schema objects (as returned by MCP servers) to Zod schemas
+ * for validation in the ToolExecutor pipeline.
+ *
+ * Supports: primitives, nested objects, arrays, enums, anyOf/oneOf,
+ * nullable, descriptions, required fields. Max recursion depth: 10.
+ */
+import { z } from 'zod';
+const MAX_DEPTH = 10;
+/**
+ * Convert a JSON Schema to a Zod schema.
+ * Returns `z.object({}).passthrough()` for undefined/empty input.
+ */
+export function jsonSchemaToZod(schema, depth = 0) {
+    if (!schema || depth > MAX_DEPTH)
+        return z.unknown();
+    // Handle anyOf / oneOf → z.union
+    if (schema.anyOf && schema.anyOf.length > 0) {
+        return buildUnion(schema.anyOf, depth);
+    }
+    if (schema.oneOf && schema.oneOf.length > 0) {
+        return buildUnion(schema.oneOf, depth);
+    }
+    // Handle enum
+    if (schema.enum && schema.enum.length > 0) {
+        return buildEnum(schema.enum, schema.nullable);
+    }
+    const type = schema.type;
+    // Object with properties
+    if (type === 'object' || (schema.properties && !type)) {
+        return buildObject(schema, depth);
+    }
+    // Array
+    if (type === 'array') {
+        const items = schema.items
+            ? jsonSchemaToZod(schema.items, depth + 1)
+            : z.unknown();
+        let arr = z.array(items);
+        if (schema.nullable)
+            arr = arr.nullable();
+        if (schema.description)
+            arr = arr.describe(schema.description);
+        return arr;
+    }
+    // Primitives
+    let field;
+    switch (type) {
+        case 'string':
+            field = z.string();
+            break;
+        case 'number':
+        case 'integer':
+            field = z.number();
+            break;
+        case 'boolean':
+            field = z.boolean();
+            break;
+        case 'null':
+            field = z.null();
+            break;
+        default:
+            field = z.unknown();
+            break;
+    }
+    if (schema.nullable)
+        field = field.nullable();
+    if (schema.description)
+        field = field.describe(schema.description);
+    return field;
+}
+function buildObject(schema, depth) {
+    if (!schema.properties)
+        return z.object({}).passthrough();
+    const required = new Set(schema.required ?? []);
+    const shape = {};
+    for (const [key, propSchema] of Object.entries(schema.properties)) {
+        let field = jsonSchemaToZod(propSchema, depth + 1);
+        if (!required.has(key)) {
+            field = field.optional();
+        }
+        shape[key] = field;
+    }
+    let obj = z.object(shape).passthrough();
+    if (schema.nullable)
+        obj = obj.nullable();
+    if (schema.description)
+        obj = obj.describe(schema.description);
+    return obj;
+}
+function buildEnum(values, nullable) {
+    // Filter to string values for z.enum (Zod enums only support strings)
+    const strings = values.filter((v) => typeof v === 'string');
+    if (strings.length >= 2) {
+        let e = z.enum(strings);
+        if (nullable)
+            e = e.nullable();
+        return e;
+    }
+    if (strings.length === 1) {
+        let e = z.literal(strings[0]);
+        if (nullable)
+            e = e.nullable();
+        return e;
+    }
+    // Mixed types — fall back to union of literals
+    const literals = values.map(v => z.literal(v));
+    if (literals.length >= 2) {
+        return z.union(literals);
+    }
+    return z.unknown();
+}
+function buildUnion(schemas, depth) {
+    const members = schemas.map(s => jsonSchemaToZod(s, depth + 1));
+    if (members.length >= 2) {
+        return z.union(members);
+    }
+    if (members.length === 1)
+        return members[0];
+    return z.unknown();
+}
+//# sourceMappingURL=json-schema-to-zod.js.map

package/dist/tools/json-schema-to-zod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-to-zod.js","sourceRoot":"","sources":["../../src/tools/json-schema-to-zod.ts"],"names":[],"mappings":"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"}

package/dist/tools/mcp-adapter.d.ts

@@ -0,0 +1,80 @@
+import type { AgentTool } from '../contracts/entities/agent-tool.js';
+import type { MCPConnectionConfig } from '../config/config.js';
+import type { ToolExecutor } from './tool-executor.js';
+export interface MCPHealthStatus {
+    servers: Array<{
+        name: string;
+        status: 'connected' | 'disconnected' | 'error' | 'reconnecting';
+        lastError?: string;
+        toolCount: number;
+        uptime: number;
+    }>;
+}
+/**
+ * Bridges MCP servers to AgentTool instances.
+ * Uses dynamic import for @modelcontextprotocol/sdk.
+ */
+export interface MCPResource {
+    uri: string;
+    name: string;
+    mimeType?: string;
+    description?: string;
+    serverName: string;
+}
+export interface MCPPromptInfo {
+    serverName: string;
+    promptName: string;
+    description?: string;
+}
+export interface MCPConnectionInfo {
+    name: string;
+    status: string;
+    instructions?: string;
+    toolCount: number;
+}
+export declare class MCPAdapter {
+    private readonly executor;
+    private readonly connections;
+    /** MCP prompts discovered from servers */
+    private readonly mcpPrompts;
+    constructor(executor: ToolExecutor);
+    /**
+     * Connect to an MCP server and register its tools.
+     * For URL-based transports (sse/http), auto-detects the correct transport
+     * by trying StreamableHTTP first, then falling back to SSE.
+     */
+    connect(config: MCPConnectionConfig): Promise<AgentTool[]>;
+    /**
+     * Disconnect a specific server and unregister its tools.
+     */
+    disconnect(name: string): Promise<void>;
+    /**
+     * Disconnect all servers.
+     */
+    disconnectAll(): Promise<void>;
+    /**
+     * Get health status of all connected servers.
+     */
+    getHealth(): MCPHealthStatus;
+    isConnected(name: string): boolean;
+    /** Get connection info for all servers (for context injection). */
+    getConnections(): MCPConnectionInfo[];
+    /** Get all discovered MCP prompts. */
+    getPrompts(): Map<string, MCPPromptInfo>;
+    /** List resources from a connected server. */
+    listResources(serverName: string): Promise<MCPResource[]>;
+    /** Read a specific resource from a server. */
+    readResource(serverName: string, uri: string): Promise<string>;
+    /** Fetch and return a prompt from a server (for skill getPrompt). */
+    getPrompt(serverName: string, promptName: string, args?: string): Promise<string>;
+    private convertTool;
+    /**
+     * Connect with transport auto-detection for URL-based configs.
+     * When transport is 'auto', tries StreamableHTTP first then falls back to SSE.
+     * Explicit 'sse' or 'http' use that transport directly.
+     */
+    private connectWithFallback;
+    private healthCheck;
+    private attemptReconnect;
+}
+//# sourceMappingURL=mcp-adapter.d.ts.map

package/dist/tools/mcp-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-adapter.d.ts","sourceRoot":"","sources":["../../src/tools/mcp-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAErE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,WAAW,GAAG,cAAc,GAAG,OAAO,GAAG,cAAc,CAAC;QAChE,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAwCD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoC;IAChE,0CAA0C;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;gBAEnD,QAAQ,EAAE,YAAY;IAIlC;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IA6ChE;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB7C;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAOpC;;OAEG;IACH,SAAS,IAAI,eAAe;IAY5B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIlC,mEAAmE;IACnE,cAAc,IAAI,iBAAiB,EAAE;IASrC,sCAAsC;IACtC,UAAU,IAAI,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC;IAIxC,8CAA8C;IACxC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAe/D,8CAA8C;IACxC,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAcpE,qEAAqE;IAC/D,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA6BvF,OAAO,CAAC,WAAW;IAyEnB;;;;OAIG;YACW,mBAAmB;YA+BnB,WAAW;YAiBX,gBAAgB;CA6B/B"}

package/dist/tools/mcp-adapter.js

@@ -0,0 +1,326 @@
+import { jsonSchemaToZod } from './json-schema-to-zod.js';
+export class MCPAdapter {
+    executor;
+    connections = new Map();
+    /** MCP prompts discovered from servers */
+    mcpPrompts = new Map();
+    constructor(executor) {
+        this.executor = executor;
+    }
+    /**
+     * Connect to an MCP server and register its tools.
+     * For URL-based transports (sse/http), auto-detects the correct transport
+     * by trying StreamableHTTP first, then falling back to SSE.
+     */
+    async connect(config) {
+        if (this.connections.has(config.name)) {
+            throw new Error(`MCP server "${config.name}" already connected`);
+        }
+        const { Client } = await loadSDK();
+        const { client, transport } = await this.connectWithFallback(Client, config);
+        // List tools from server
+        const { tools: mcpTools } = await client.listTools();
+        // Convert MCP tools to AgentTools
+        const agentTools = mcpTools.map(mcpTool => this.convertTool(config.name, mcpTool, client, config));
+        // Register tools in executor
+        for (const tool of agentTools) {
+            this.executor.register(tool);
+        }
+        // Track connection
+        const connection = {
+            name: config.name,
+            config,
+            client,
+            transport,
+            toolNames: agentTools.map(t => t.name),
+            connectedAt: Date.now(),
+            status: 'connected',
+        };
+        // Health check timer
+        if (config.healthCheckInterval && config.healthCheckInterval > 0) {
+            connection.healthTimer = setInterval(() => void this.healthCheck(config.name), config.healthCheckInterval);
+        }
+        this.connections.set(config.name, connection);
+        return agentTools;
+    }
+    /**
+     * Disconnect a specific server and unregister its tools.
+     */
+    async disconnect(name) {
+        const conn = this.connections.get(name);
+        if (!conn)
+            throw new Error(`MCP server "${name}" not found`);
+        // Clear health check
+        if (conn.healthTimer)
+            clearInterval(conn.healthTimer);
+        // Unregister tools
+        for (const toolName of conn.toolNames) {
+            this.executor.unregister(toolName);
+        }
+        // Close connection
+        try {
+            await conn.client.close();
+        }
+        catch {
+            // Ignore close errors
+        }
+        this.connections.delete(name);
+    }
+    /**
+     * Disconnect all servers.
+     */
+    async disconnectAll() {
+        const names = [...this.connections.keys()];
+        for (const name of names) {
+            await this.disconnect(name);
+        }
+    }
+    /**
+     * Get health status of all connected servers.
+     */
+    getHealth() {
+        return {
+            servers: [...this.connections.values()].map(conn => ({
+                name: conn.name,
+                status: conn.status,
+                lastError: conn.lastError,
+                toolCount: conn.toolNames.length,
+                uptime: Date.now() - conn.connectedAt,
+            })),
+        };
+    }
+    isConnected(name) {
+        return this.connections.get(name)?.status === 'connected';
+    }
+    /** Get connection info for all servers (for context injection). */
+    getConnections() {
+        return [...this.connections.values()].map(conn => ({
+            name: conn.name,
+            status: conn.status,
+            instructions: conn.instructions,
+            toolCount: conn.toolNames.length,
+        }));
+    }
+    /** Get all discovered MCP prompts. */
+    getPrompts() {
+        return this.mcpPrompts;
+    }
+    /** List resources from a connected server. */
+    async listResources(serverName) {
+        const conn = this.connections.get(serverName);
+        if (!conn || conn.status !== 'connected')
+            return [];
+        try {
+            const result = await conn.client.listResources?.();
+            if (!result)
+                return [];
+            return result.resources.map(r => ({ ...r, serverName }));
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Read a specific resource from a server. */
+    async readResource(serverName, uri) {
+        const conn = this.connections.get(serverName);
+        if (!conn || conn.status !== 'connected') {
+            throw new Error(`MCP server "${serverName}" not connected`);
+        }
+        const result = await conn.client.readResource?.({ uri });
+        if (!result)
+            throw new Error('Server does not support resources');
+        return result.contents.map(c => c.text ?? `[Binary: ${c.uri}]`).join('\n');
+    }
+    /** Fetch and return a prompt from a server (for skill getPrompt). */
+    async getPrompt(serverName, promptName, args) {
+        const conn = this.connections.get(serverName);
+        if (!conn || conn.status !== 'connected') {
+            throw new Error(`MCP server "${serverName}" not connected`);
+        }
+        const parsedArgs = {};
+        if (args) {
+            // Simple key=value parsing from args string
+            for (const part of args.split(/\s+/)) {
+                const [k, ...v] = part.split('=');
+                if (k && v.length > 0)
+                    parsedArgs[k] = v.join('=');
+            }
+        }
+        const result = await conn.client.getPrompt?.({ name: promptName, arguments: parsedArgs });
+        if (!result)
+            throw new Error('Server does not support prompts');
+        return result.messages.map(m => {
+            const content = typeof m.content === 'string' ? m.content : m.content.text ?? '';
+            return content;
+        }).join('\n');
+    }
+    convertTool(serverName, mcpTool, client, config) {
+        const namespacedName = `mcp__${serverName}__${mcpTool.name}`;
+        const parameters = jsonSchemaToZod(mcpTool.inputSchema);
+        const isolateErrors = config.isolateErrors ?? true;
+        const timeout = config.timeout ?? 30_000;
+        // Map MCP annotations to AgentTool flags
+        const annotations = mcpTool.annotations ?? {};
+        const isReadOnly = annotations.readOnlyHint ?? false;
+        const isDestructive = annotations.destructiveHint ?? false;
+        return {
+            name: namespacedName,
+            description: mcpTool.description?.slice(0, 2048) ?? `MCP tool: ${mcpTool.name}`,
+            parameters,
+            isReadOnly,
+            isDestructive,
+            isConcurrencySafe: isReadOnly, // read-only tools are safe for parallel execution
+            execute: async (args, signal) => {
+                try {
+                    const controller = new AbortController();
+                    const timer = setTimeout(() => controller.abort(), timeout);
+                    signal.addEventListener('abort', () => controller.abort(), { once: true });
+                    try {
+                        const timeoutPromise = new Promise((_, reject) => {
+                            controller.signal.addEventListener('abort', () => reject(new Error(`MCP tool "${mcpTool.name}" timed out after ${timeout}ms`)), { once: true });
+                        });
+                        const result = await Promise.race([
+                            client.callTool({ name: mcpTool.name, arguments: args }, undefined, { signal: controller.signal }),
+                            timeoutPromise,
+                        ]);
+                        // Handle mixed content types (text, image, resource)
+                        const parts = result.content.map((c) => {
+                            if (c.type === 'text' && c.text)
+                                return c.text;
+                            if (c.type === 'image') {
+                                const mime = c.mimeType ?? 'unknown';
+                                const dataLen = typeof c.data === 'string' ? c.data.length : 0;
+                                const sizeKB = Math.round(dataLen * 0.75 / 1024);
+                                return `[Image: ${mime}, ~${sizeKB}KB]`;
+                            }
+                            if (c.type === 'resource')
+                                return c.text ?? `[Resource: ${c.uri}]`;
+                            return `[${c.type}]`;
+                        });
+                        const textContent = parts.join('\n');
+                        if (result.isError) {
+                            return { content: textContent || 'MCP tool returned an error', isError: true };
+                        }
+                        return textContent || 'Tool completed with no text output';
+                    }
+                    finally {
+                        clearTimeout(timer);
+                    }
+                }
+                catch (error) {
+                    if (isolateErrors) {
+                        return {
+                            content: `MCP tool error: ${error instanceof Error ? error.message : String(error)}`,
+                            isError: true,
+                        };
+                    }
+                    throw error;
+                }
+            },
+        };
+    }
+    /**
+     * Connect with transport auto-detection for URL-based configs.
+     * When transport is 'auto', tries StreamableHTTP first then falls back to SSE.
+     * Explicit 'sse' or 'http' use that transport directly.
+     */
+    async connectWithFallback(Client, config) {
+        // Explicit transport — use directly, no fallback
+        if (config.transport !== 'auto') {
+            const client = new Client({ name: `agentx-${config.name}`, version: '0.1.0' });
+            const transport = await createTransport(config);
+            await client.connect(transport);
+            return { client, transport };
+        }
+        // Auto-detect: try StreamableHTTP first, fall back to SSE
+        const requestInit = config.headers ? { headers: config.headers } : undefined;
+        try {
+            const client = new Client({ name: `agentx-${config.name}`, version: '0.1.0' });
+            const { StreamableHTTPClientTransport } = await import('@modelcontextprotocol/sdk/client/streamableHttp.js');
+            const transport = new StreamableHTTPClientTransport(new URL(config.url), { requestInit });
+            await client.connect(transport);
+            return { client, transport };
+        }
+        catch {
+            // StreamableHTTP failed — try SSE
+            const client = new Client({ name: `agentx-${config.name}`, version: '0.1.0' });
+            const { SSEClientTransport } = await import('@modelcontextprotocol/sdk/client/sse.js');
+            const transport = new SSEClientTransport(new URL(config.url), { requestInit });
+            await client.connect(transport);
+            return { client, transport };
+        }
+    }
+    async healthCheck(name) {
+        const conn = this.connections.get(name);
+        if (!conn)
+            return;
+        try {
+            await conn.client.listTools();
+            conn.status = 'connected';
+            conn.lastError = undefined;
+        }
+        catch (error) {
+            conn.status = 'error';
+            conn.lastError = error instanceof Error ? error.message : String(error);
+            // Attempt reconnection
+            void this.attemptReconnect(name);
+        }
+    }
+    async attemptReconnect(name) {
+        const conn = this.connections.get(name);
+        if (!conn || conn.status === 'reconnecting')
+            return;
+        conn.status = 'reconnecting';
+        const maxRetries = conn.config.maxRetries ?? 3;
+        for (let attempt = 0; attempt < maxRetries; attempt++) {
+            try {
+                const delay = Math.min(1000 * 2 ** attempt, 30_000);
+                await new Promise(r => setTimeout(r, delay));
+                const transport = await createTransport(conn.config);
+                await conn.client.connect(transport);
+                conn.transport = transport;
+                conn.status = 'connected';
+                conn.lastError = undefined;
+                return;
+            }
+            catch (error) {
+                conn.lastError = error instanceof Error ? error.message : String(error);
+            }
+        }
+        // Failed all retries — remove tools
+        conn.status = 'disconnected';
+        for (const toolName of conn.toolNames) {
+            this.executor.unregister(toolName);
+        }
+    }
+}
+// --- SDK Loading ---
+async function loadSDK() {
+    try {
+        const mod = await import('@modelcontextprotocol/sdk/client/index.js');
+        // Cast needed because MCP SDK types are broader than our minimal MCPClient interface
+        return { Client: mod.Client };
+    }
+    catch {
+        throw new Error('Install @modelcontextprotocol/sdk to use MCP connections: npm install @modelcontextprotocol/sdk');
+    }
+}
+async function createTransport(config) {
+    const requestInit = config.headers
+        ? { headers: config.headers }
+        : undefined;
+    if (config.transport === 'stdio') {
+        const { StdioClientTransport } = await import('@modelcontextprotocol/sdk/client/stdio.js');
+        return new StdioClientTransport({ command: config.command, args: config.args ?? [] });
+    }
+    if (config.transport === 'sse') {
+        const { SSEClientTransport } = await import('@modelcontextprotocol/sdk/client/sse.js');
+        return new SSEClientTransport(new URL(config.url), { requestInit });
+    }
+    if (config.transport === 'http') {
+        const { StreamableHTTPClientTransport } = await import('@modelcontextprotocol/sdk/client/streamableHttp.js');
+        return new StreamableHTTPClientTransport(new URL(config.url), { requestInit });
+    }
+    throw new Error(`Unsupported MCP transport: ${config.transport}`);
+}
+//# sourceMappingURL=mcp-adapter.js.map

package/dist/tools/mcp-adapter.js.map

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

package/dist/tools/skill-tool.d.ts

@@ -0,0 +1,41 @@
+/**
+ * SkillTool — allows the LLM to invoke skills as tool calls mid-loop.
+ *
+ * Ported from old_src/tools/SkillTool/SkillTool.ts with adaptations for SDK context.
+ *
+ * Key behaviors from old_src:
+ * - Skill lookup by exact name, alias, and triggerPrefix
+ * - Validates modelInvocable flag (disableModelInvocation equivalent)
+ * - Dynamic prompt resolution via resolveInstructions()
+ * - Registers skill-scoped tools in ToolExecutor when skill activates
+ * - Returns resolved prompt as tagged block for the model
+ * - Tracks invocation for session (survives compaction via invoked set)
+ *
+ * Differences from old_src:
+ * - No permission system (SDK has no interactive UI to ask user)
+ * - No fork mode (SDK uses inline execution only)
+ * - No contextModifier (SDK doesn't support mid-loop model/effort override)
+ * - No remote skill loading (CLI-specific feature)
+ */
+import type { AgentTool } from '../contracts/entities/agent-tool.js';
+import type { ToolExecutor } from './tool-executor.js';
+import type { SkillManager } from '../skills/skill-manager.js';
+export declare const SKILL_TOOL_NAME = "Skill";
+export interface SkillToolContext {
+    threadId: string;
+    traceId: string;
+}
+/**
+ * Build the system prompt section that teaches the model how to use the Skill tool.
+ * Ported from old_src/tools/SkillTool/prompt.ts getPrompt().
+ */
+export declare function buildSkillToolPrompt(listing: string): string;
+/**
+ * Create the Skill tool that the model can invoke during the react loop.
+ *
+ * @param skillManager — manages skill registry and resolution
+ * @param toolExecutor — used to register skill-scoped tools mid-loop
+ * @param getContext — returns current execution context (threadId, traceId)
+ */
+export declare function createSkillTool(skillManager: SkillManager, toolExecutor: ToolExecutor, getContext: () => SkillToolContext): AgentTool;
+//# sourceMappingURL=skill-tool.d.ts.map

package/dist/tools/skill-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-tool.d.ts","sourceRoot":"","sources":["../../src/tools/skill-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAErE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,eAAO,MAAM,eAAe,UAAU,CAAC;AAOvC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAmB5D;AA6BD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,gBAAgB,GACjC,SAAS,CAkFX"}