open-agent-sdk 0.1.0-alpha.0

package/dist/tools/task.js

@@ -0,0 +1,99 @@
+/**
+ * Task tool - Launch a subagent to handle specific tasks
+ * Aligned with Claude Agent SDK
+ */
+import { runSubagent } from '../agent/subagent-runner';
+import { logger } from '../utils/logger';
+// JSON Schema for Task tool parameters
+const parameters = {
+    type: 'object',
+    properties: {
+        description: {
+            type: 'string',
+            description: 'Short task description (3-5 words)',
+        },
+        prompt: {
+            type: 'string',
+            description: 'Full task prompt for the subagent',
+        },
+        subagent_type: {
+            type: 'string',
+            description: 'Agent type identifier (must match a key in agents config)',
+        },
+    },
+    required: ['description', 'prompt', 'subagent_type'],
+};
+/**
+ * Task tool implementation
+ */
+export class TaskTool {
+    name = 'Task';
+    description = 'Launch a specialized subagent to handle a specific task. ' +
+        'The subagent operates independently with its own tool set and configuration. ' +
+        'Use this to delegate complex tasks like code review, testing, or exploration.';
+    parameters = parameters;
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    handler = async (input, context) => {
+        logger.debug(`[TaskTool] Executing task: ${input.description}`);
+        logger.debug(`[TaskTool] Subagent type: ${input.subagent_type}`);
+        // Validate that the subagent_type exists in agents config
+        const agentDef = this.config.agents[input.subagent_type];
+        if (!agentDef) {
+            const availableTypes = Object.keys(this.config.agents).join(', ');
+            throw new Error(`Unknown subagent_type: "${input.subagent_type}". ` +
+                `Available types: ${availableTypes || 'none configured'}`);
+        }
+        // Create subagent context
+        const subagentContext = {
+            parentContext: context,
+            parentToolRegistry: this.config.toolRegistry,
+            hookManager: this.config.hookManager,
+            parentSessionId: this.config.sessionId,
+            parentConfig: {
+                model: this.config.model,
+                maxTurns: this.config.maxTurns,
+                permissionMode: this.config.permissionMode,
+            },
+        };
+        // Execute the subagent
+        const result = await runSubagent(agentDef, input.prompt, input.subagent_type, subagentContext);
+        logger.debug(`[TaskTool] Task completed: ${input.description}`);
+        logger.debug(`[TaskTool] Duration: ${result.durationMs}ms${result.costUsd !== undefined ? `, Cost: $${result.costUsd}` : ''}`);
+        return {
+            result: result.result,
+            agent_id: result.agentId,
+            usage: {
+                input_tokens: result.usage.inputTokens,
+                output_tokens: result.usage.outputTokens,
+            },
+            ...(result.costUsd !== undefined && { total_cost_usd: result.costUsd }),
+            duration_ms: result.durationMs,
+            ...(result.error && { error: result.error }),
+        };
+    };
+}
+/**
+ * Create a Task tool instance
+ */
+export function createTaskTool(config) {
+    return new TaskTool(config);
+}
+/**
+ * Create a Task tool with agent definitions from parent config
+ * This is a convenience factory for use in ReActLoop
+ */
+export function createTaskToolFromConfig(agents, sessionId, model, maxTurns, permissionMode, hookManager, toolRegistry) {
+    return new TaskTool({
+        agents,
+        sessionId,
+        model,
+        maxTurns,
+        permissionMode,
+        hookManager,
+        toolRegistry,
+    });
+}
+//# sourceMappingURL=task.js.map

package/dist/tools/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../../src/tools/task.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,WAAW,EAAwB,MAAM,0BAA0B,CAAC;AAG7E,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAwDzC,uCAAuC;AACvC,MAAM,UAAU,GAAe;IAC7B,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,oCAAoC;SAClD;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,mCAAmC;SACjD;QACD,aAAa,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,2DAA2D;SACzE;KACF;IACD,QAAQ,EAAE,CAAC,aAAa,EAAE,QAAQ,EAAE,eAAe,CAAC;CACrD,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,QAAQ;IACnB,IAAI,GAAG,MAAM,CAAC;IACd,WAAW,GACT,2DAA2D;QAC3D,+EAA+E;QAC/E,+EAA+E,CAAC;IAClF,UAAU,GAAG,UAAU,CAAC;IAEhB,MAAM,CAAiB;IAE/B,YAAY,MAAsB;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,OAAO,GAAG,KAAK,EAAE,KAAgB,EAAE,OAAoB,EAAuB,EAAE;QAC9E,MAAM,CAAC,KAAK,CAAC,8BAA8B,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAChE,MAAM,CAAC,KAAK,CAAC,6BAA6B,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC;QAEjE,0DAA0D;QAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACzD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClE,MAAM,IAAI,KAAK,CACb,2BAA2B,KAAK,CAAC,aAAa,KAAK;gBACjD,oBAAoB,cAAc,IAAI,iBAAiB,EAAE,CAC5D,CAAC;QACJ,CAAC;QAED,0BAA0B;QAC1B,MAAM,eAAe,GAAoB;YACvC,aAAa,EAAE,OAAO;YACtB,kBAAkB,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY;YAC5C,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;YACpC,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;YACtC,YAAY,EAAE;gBACZ,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;gBACxB,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAC9B,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc;aAC3C;SACF,CAAC;QAEF,uBAAuB;QACvB,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;QAE/F,MAAM,CAAC,KAAK,CAAC,8BAA8B,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAChE,MAAM,CAAC,KAAK,CAAC,wBAAwB,MAAM,CAAC,UAAU,KAAK,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAE/H,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,OAAO;YACxB,KAAK,EAAE;gBACL,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW;gBACtC,aAAa,EAAE,MAAM,CAAC,KAAK,CAAC,YAAY;aACzC;YACD,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;YACvE,WAAW,EAAE,MAAM,CAAC,UAAU;YAC9B,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;SAC7C,CAAC;IACJ,CAAC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAsB;IACnD,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAwB,EACxB,SAAiB,EACjB,KAAa,EACb,QAAgB,EAChB,cAAsB,EACtB,WAAwB,EACxB,YAA0B;IAE1B,OAAO,IAAI,QAAQ,CAAC;QAClB,MAAM;QACN,SAAS;QACT,KAAK;QACL,QAAQ;QACR,cAAc;QACd,WAAW;QACX,YAAY;KACb,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/web-fetch.d.ts

@@ -0,0 +1,21 @@
+import type { Tool, ToolContext, JSONSchema } from '../types/tools.js';
+export interface WebFetchInput {
+    url: string;
+    prompt: string;
+}
+export interface WebFetchOutput {
+    response?: string;
+    url: string;
+    final_url?: string;
+    status_code?: number;
+    error?: string;
+}
+export declare class WebFetchTool implements Tool<WebFetchInput, WebFetchOutput> {
+    name: string;
+    description: string;
+    parameters: JSONSchema;
+    handler: (input: WebFetchInput, context: ToolContext) => Promise<WebFetchOutput>;
+    private extractContent;
+}
+export declare const webFetchTool: WebFetchTool;
+//# sourceMappingURL=web-fetch.d.ts.map

package/dist/tools/web-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch.d.ts","sourceRoot":"","sources":["../../src/tools/web-fetch.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIvE,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAiBD,qBAAa,YAAa,YAAW,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC;IACtE,IAAI,SAAc;IAClB,WAAW,SAA4F;IACvG,UAAU,aAAc;IAExB,OAAO,GACL,OAAO,aAAa,EACpB,SAAS,WAAW,KACnB,OAAO,CAAC,cAAc,CAAC,CA6ExB;IAEF,OAAO,CAAC,cAAc;CA6BvB;AAED,eAAO,MAAM,YAAY,cAAqB,CAAC"}

package/dist/tools/web-fetch.js

@@ -0,0 +1,124 @@
+import { Readability } from '@mozilla/readability';
+import { JSDOM } from 'jsdom';
+import TurndownService from 'turndown';
+import { createUserMessage } from '../types/messages.js';
+import { generateUUID } from '../utils/uuid.js';
+const parameters = {
+    type: 'object',
+    properties: {
+        url: {
+            type: 'string',
+            description: 'The URL to fetch (HTTP will be auto-upgraded to HTTPS)',
+        },
+        prompt: {
+            type: 'string',
+            description: 'The prompt to process the fetched content with',
+        },
+    },
+    required: ['url', 'prompt'],
+};
+export class WebFetchTool {
+    name = 'WebFetch';
+    description = 'Fetch a webpage and analyze its content using an LLM. Returns the LLM analysis result.';
+    parameters = parameters;
+    handler = async (input, context) => {
+        // Validate URL
+        let url;
+        try {
+            url = new URL(input.url);
+            // Auto-upgrade HTTP to HTTPS
+            if (url.protocol === 'http:') {
+                url.protocol = 'https:';
+            }
+        }
+        catch {
+            return {
+                url: input.url,
+                error: 'Invalid URL provided',
+            };
+        }
+        // Check for provider
+        if (!context.provider) {
+            return {
+                url: input.url,
+                error: 'No provider available for LLM analysis. WebFetch requires a provider to be configured.',
+            };
+        }
+        try {
+            // Fetch the webpage
+            const fetchOptions = {
+                signal: context.abortController?.signal,
+                headers: {
+                    'User-Agent': 'Mozilla/5.0 (compatible; OpenAgentSDK/1.0)',
+                },
+            };
+            const response = await fetch(url.toString(), fetchOptions);
+            const finalUrl = response.url;
+            const statusCode = response.status;
+            if (!response.ok) {
+                return {
+                    url: input.url,
+                    final_url: finalUrl,
+                    status_code: statusCode,
+                    error: `HTTP error ${statusCode}: ${response.statusText}`,
+                };
+            }
+            const html = await response.text();
+            // Extract readable content
+            const markdown = this.extractContent(html, finalUrl);
+            // Analyze with LLM using the chat method
+            const analysisPrompt = `${input.prompt}\n\nContent from ${finalUrl}:\n\n${markdown}`;
+            const message = createUserMessage(analysisPrompt, 'webfetch-session', generateUUID(), null);
+            const chunks = [];
+            for await (const chunk of context.provider.chat([message], undefined, context.abortController?.signal)) {
+                if (chunk.type === 'content' && chunk.delta) {
+                    chunks.push(chunk.delta);
+                }
+            }
+            const response_text = chunks.join('');
+            return {
+                response: response_text,
+                url: input.url,
+                final_url: finalUrl,
+                status_code: statusCode,
+            };
+        }
+        catch (error) {
+            return {
+                url: input.url,
+                error: error instanceof Error ? error.message : 'Failed to fetch or analyze webpage',
+            };
+        }
+    };
+    extractContent(html, url) {
+        try {
+            const dom = new JSDOM(html, { url });
+            const reader = new Readability(dom.window.document);
+            const article = reader.parse();
+            if (article && article.content) {
+                // Convert to markdown
+                const turndownService = new TurndownService({
+                    headingStyle: 'atx',
+                    codeBlockStyle: 'fenced',
+                });
+                return turndownService.turndown(article.content);
+            }
+        }
+        catch {
+            // Fall through to raw HTML conversion
+        }
+        // Fallback: convert entire body to markdown
+        try {
+            const dom = new JSDOM(html);
+            const turndownService = new TurndownService();
+            const body = dom.window.document.body;
+            return body ? turndownService.turndown(body.innerHTML) : '';
+        }
+        catch {
+            // Final fallback: return plain text
+            return html.replace(/<[^>]*>/g, '');
+        }
+    }
+}
+export const webFetchTool = new WebFetchTool();
+//# sourceMappingURL=web-fetch.js.map

package/dist/tools/web-fetch.js.map

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

package/dist/tools/web-search.d.ts

@@ -0,0 +1,20 @@
+import type { Tool, ToolContext, JSONSchema } from '../types/tools.js';
+export interface WebSearchInput {
+    query: string;
+    numResults?: number;
+    type?: 'auto' | 'fast' | 'deep';
+    livecrawl?: 'fallback' | 'preferred';
+}
+export interface WebSearchOutput {
+    content: string;
+    query: string;
+    error?: string;
+}
+export declare class WebSearchTool implements Tool<WebSearchInput, WebSearchOutput> {
+    name: string;
+    description: string;
+    parameters: JSONSchema;
+    handler: (input: WebSearchInput, context: ToolContext) => Promise<WebSearchOutput>;
+}
+export declare const webSearchTool: WebSearchTool;
+//# sourceMappingURL=web-search.d.ts.map

package/dist/tools/web-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../src/tools/web-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEvE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAChC,SAAS,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;CACtC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAoCD,qBAAa,aAAc,YAAW,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC;IACzE,IAAI,SAAe;IACnB,WAAW,SAAqG;IAChH,UAAU,aAAc;IAExB,OAAO,GACL,OAAO,cAAc,EACrB,SAAS,WAAW,KACnB,OAAO,CAAC,eAAe,CAAC,CAgGzB;CACH;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/tools/web-search.js

@@ -0,0 +1,127 @@
+const API_CONFIG = {
+    BASE_URL: 'https://mcp.exa.ai',
+    ENDPOINTS: {
+        SEARCH: '/mcp',
+    },
+    DEFAULT_NUM_RESULTS: 8,
+    TIMEOUT_MS: 25000,
+};
+const parameters = {
+    type: 'object',
+    properties: {
+        query: {
+            type: 'string',
+            description: 'The search query',
+        },
+        numResults: {
+            type: 'number',
+            description: 'Number of search results to return (default: 8)',
+        },
+        type: {
+            type: 'string',
+            enum: ['auto', 'fast', 'deep'],
+            description: "Search type - 'auto': balanced (default), 'fast': quick, 'deep': comprehensive",
+        },
+        livecrawl: {
+            type: 'string',
+            enum: ['fallback', 'preferred'],
+            description: "Live crawl mode - 'fallback': use as backup, 'preferred': prioritize (default: 'fallback')",
+        },
+    },
+    required: ['query'],
+};
+export class WebSearchTool {
+    name = 'WebSearch';
+    description = 'Search the web for information. Returns formatted search results optimized for LLM consumption.';
+    parameters = parameters;
+    handler = async (input, context) => {
+        // Validate query
+        if (!input.query || input.query.trim().length === 0) {
+            return {
+                content: '',
+                query: input.query || '',
+                error: 'Query is required',
+            };
+        }
+        const searchRequest = {
+            jsonrpc: '2.0',
+            id: 1,
+            method: 'tools/call',
+            params: {
+                name: 'web_search_exa',
+                arguments: {
+                    query: input.query,
+                    type: input.type || 'auto',
+                    numResults: input.numResults || API_CONFIG.DEFAULT_NUM_RESULTS,
+                    livecrawl: input.livecrawl || 'fallback',
+                },
+            },
+        };
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), API_CONFIG.TIMEOUT_MS);
+        try {
+            const abortSignals = [controller.signal];
+            if (context.abortController?.signal) {
+                abortSignals.push(context.abortController.signal);
+            }
+            const response = await fetch(`${API_CONFIG.BASE_URL}${API_CONFIG.ENDPOINTS.SEARCH}`, {
+                method: 'POST',
+                headers: {
+                    accept: 'application/json, text/event-stream',
+                    'content-type': 'application/json',
+                },
+                body: JSON.stringify(searchRequest),
+                signal: AbortSignal.any(abortSignals),
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                const errorText = await response.text();
+                return {
+                    content: '',
+                    query: input.query,
+                    error: `Search error (${response.status}): ${errorText}`,
+                };
+            }
+            const responseText = await response.text();
+            // Parse SSE response
+            const lines = responseText.split('\n');
+            for (const line of lines) {
+                if (line.startsWith('data: ')) {
+                    try {
+                        const data = JSON.parse(line.substring(6));
+                        if (data.result?.content?.length > 0) {
+                            return {
+                                content: data.result.content[0].text,
+                                query: input.query,
+                            };
+                        }
+                    }
+                    catch {
+                        // Skip invalid JSON lines
+                    }
+                }
+            }
+            return {
+                content: 'No search results found. Please try a different query.',
+                query: input.query,
+            };
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof Error && error.name === 'AbortError') {
+                return {
+                    content: '',
+                    query: input.query,
+                    error: 'Search request timed out after 25 seconds',
+                };
+            }
+            return {
+                content: '',
+                query: input.query,
+                error: error instanceof Error ? error.message : 'Search failed',
+            };
+        }
+    };
+}
+export const webSearchTool = new WebSearchTool();
+//# sourceMappingURL=web-search.js.map

package/dist/tools/web-search.js.map

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

package/dist/tools/write.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Write tool - Write content to files, creating parent directories as needed
+ */
+import type { Tool, ToolContext, JSONSchema } from '../types/tools';
+export interface WriteInput {
+    file_path: string;
+    content: string;
+}
+export interface WriteOutput {
+    message: string;
+    file_path: string;
+    bytes_written: number;
+    error?: string;
+}
+export declare class WriteTool implements Tool<WriteInput, WriteOutput> {
+    name: string;
+    description: string;
+    parameters: JSONSchema;
+    handler: (input: WriteInput, context: ToolContext) => Promise<WriteOutput>;
+}
+export declare const writeTool: WriteTool;
+//# sourceMappingURL=write.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/tools/write.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEpE,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAiBD,qBAAa,SAAU,YAAW,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC;IAC7D,IAAI,SAAW;IACf,WAAW,SACuF;IAClG,UAAU,aAAc;IAExB,OAAO,GACL,OAAO,UAAU,EACjB,SAAS,WAAW,KACnB,OAAO,CAAC,WAAW,CAAC,CAqBrB;CACH;AAGD,eAAO,MAAM,SAAS,WAAkB,CAAC"}

package/dist/tools/write.js

@@ -0,0 +1,46 @@
+/**
+ * Write tool - Write content to files, creating parent directories as needed
+ */
+import { writeFileSync, existsSync, mkdirSync } from 'fs';
+import { resolve, dirname } from 'path';
+const parameters = {
+    type: 'object',
+    properties: {
+        file_path: {
+            type: 'string',
+            description: 'Absolute path to the file to write',
+        },
+        content: {
+            type: 'string',
+            description: 'Content to write to the file',
+        },
+    },
+    required: ['file_path', 'content'],
+};
+export class WriteTool {
+    name = 'Write';
+    description = 'Write content to a file. Creates parent directories automatically. Overwrites existing files.';
+    parameters = parameters;
+    handler = async (input, context) => {
+        const filePath = resolve(context.cwd, input.file_path);
+        const existed = existsSync(filePath);
+        // Create parent directories
+        const parentDir = dirname(filePath);
+        if (!existsSync(parentDir)) {
+            mkdirSync(parentDir, { recursive: true });
+        }
+        // Write file
+        const content = input.content;
+        writeFileSync(filePath, content, 'utf-8');
+        return {
+            message: existed
+                ? `File "${input.file_path}" overwritten successfully`
+                : `File "${input.file_path}" created successfully`,
+            file_path: input.file_path,
+            bytes_written: Buffer.byteLength(content, 'utf-8'),
+        };
+    };
+}
+// Export singleton instance
+export const writeTool = new WriteTool();
+//# sourceMappingURL=write.js.map

package/dist/tools/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../src/tools/write.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAexC,MAAM,UAAU,GAAe;IAC7B,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,SAAS,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,oCAAoC;SAClD;QACD,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,8BAA8B;SAC5C;KACF;IACD,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;CACnC,CAAC;AAEF,MAAM,OAAO,SAAS;IACpB,IAAI,GAAG,OAAO,CAAC;IACf,WAAW,GACT,+FAA+F,CAAC;IAClG,UAAU,GAAG,UAAU,CAAC;IAExB,OAAO,GAAG,KAAK,EACb,KAAiB,EACjB,OAAoB,EACE,EAAE;QACxB,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACvD,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QAErC,4BAA4B;QAC5B,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,aAAa;QACb,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC9B,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAE1C,OAAO;YACL,OAAO,EAAE,OAAO;gBACd,CAAC,CAAC,SAAS,KAAK,CAAC,SAAS,4BAA4B;gBACtD,CAAC,CAAC,SAAS,KAAK,CAAC,SAAS,wBAAwB;YACpD,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,aAAa,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC;SACnD,CAAC;IACJ,CAAC,CAAC;CACH;AAED,4BAA4B;AAC5B,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC"}

package/dist/types/messages.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Message types for Open Agent SDK
+ * Defines the communication protocol between user, agent, and tools
+ * Aligned with Claude Agent SDK V2 API
+ */
+import type { PermissionMode } from '../permissions/types';
+/** UUID type for message identification */
+export type UUID = string;
+/** Base message interface */
+export interface BaseMessage {
+    type: string;
+    uuid: UUID;
+    session_id: string;
+}
+/** Content block for assistant message */
+export type AssistantContentBlock = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: unknown;
+};
+/** Nested message structure for user messages */
+export interface UserMessageContent {
+    role: 'user';
+    content: string;
+}
+/** Nested message structure for assistant messages */
+export interface AssistantMessageContent {
+    role: 'assistant';
+    content: AssistantContentBlock[];
+    tool_calls?: ToolCall[];
+}
+/** User message - input from the user */
+export interface SDKUserMessage extends BaseMessage {
+    type: 'user';
+    message: UserMessageContent;
+    parent_tool_use_id: string | null;
+}
+/** Tool call from assistant */
+export interface ToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+/** Assistant message - response from the LLM */
+export interface SDKAssistantMessage extends BaseMessage {
+    type: 'assistant';
+    message: AssistantMessageContent;
+    parent_tool_use_id: string | null;
+}
+/** Tool result message - output from tool execution */
+export interface SDKToolResultMessage extends BaseMessage {
+    type: 'tool_result';
+    tool_use_id: string;
+    tool_name: string;
+    result: unknown;
+    is_error: boolean;
+}
+/** API key source for the session */
+export type ApiKeySource = 'env' | 'keychain' | 'custom';
+/** MCP server info in system message */
+export interface McpServerInfo {
+    name: string;
+    status: string;
+}
+/** System message - initialization metadata (aligned with Claude Agent SDK) */
+export interface SDKSystemMessage extends BaseMessage {
+    type: 'system';
+    subtype: 'init';
+    uuid: UUID;
+    session_id: string;
+    model: string;
+    provider: string;
+    tools: string[];
+    cwd: string;
+    apiKeySource?: ApiKeySource;
+    mcp_servers?: McpServerInfo[];
+    permissionMode?: PermissionMode;
+    slash_commands?: string[];
+    output_style?: string;
+}
+/** Compact boundary message - marks a conversation compaction point */
+export interface SDKCompactBoundaryMessage extends BaseMessage {
+    type: 'system';
+    subtype: 'compact_boundary';
+    uuid: UUID;
+    session_id: string;
+    compact_metadata: {
+        trigger: 'manual' | 'auto';
+        pre_tokens: number;
+    };
+}
+/** Result message - final output of the agent */
+export interface SDKResultMessage extends BaseMessage {
+    type: 'result';
+    subtype: 'success' | 'error_max_turns' | 'error_during_execution';
+    duration_ms: number;
+    duration_api_ms: number;
+    is_error: boolean;
+    num_turns: number;
+    result: string;
+    usage: {
+        input_tokens: number;
+        output_tokens: number;
+    };
+}
+/** Union type for all SDK messages */
+export type SDKMessage = SDKUserMessage | SDKAssistantMessage | SDKToolResultMessage | SDKSystemMessage | SDKCompactBoundaryMessage | SDKResultMessage;
+/** Helper function to create user message */
+export declare function createUserMessage(content: string, sessionId: string, uuid: UUID, parentToolUseId?: string | null): SDKUserMessage;
+/** Options for creating system message */
+export interface CreateSystemMessageOptions {
+    apiKeySource?: ApiKeySource;
+    mcp_servers?: McpServerInfo[];
+    permissionMode?: PermissionMode;
+    slash_commands?: string[];
+    output_style?: string;
+}
+/** Helper function to create system message (aligned with Claude Agent SDK) */
+export declare function createSystemMessage(model: string, provider: string, tools: string[], cwd: string, sessionId: string, uuid: UUID, options?: CreateSystemMessageOptions): SDKSystemMessage;
+/** Helper function to create assistant message */
+export declare function createAssistantMessage(contentBlocks: AssistantContentBlock[], sessionId: string, uuid: UUID, parentToolUseId?: string | null, toolCalls?: ToolCall[]): SDKAssistantMessage;
+/** Helper function to create tool result message */
+export declare function createToolResultMessage(toolUseId: string, toolName: string, result: unknown, isError: boolean, sessionId: string, uuid: UUID): SDKToolResultMessage;
+/** Helper function to create result message */
+export declare function createResultMessage(subtype: 'success' | 'error_max_turns' | 'error_during_execution', result: string, durationMs: number, durationApiMs: number, numTurns: number, usage: {
+    input_tokens: number;
+    output_tokens: number;
+}, sessionId: string, uuid: UUID): SDKResultMessage;
+/** Helper function to create compact boundary message */
+export declare function createCompactBoundaryMessage(sessionId: string, uuid: UUID, trigger: 'manual' | 'auto', preTokens: number): SDKCompactBoundaryMessage;
+//# sourceMappingURL=messages.d.ts.map

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

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