@claudebuddy/claudebuddy-agent-sdk 0.4.0

package/dist/tools/team-tools.js.map

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

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

@@ -0,0 +1,22 @@
+/**
+ * TodoWriteTool - Session todo/checklist management
+ *
+ * Manages a session-scoped todo list for tracking work items.
+ */
+import type { ToolDefinition } from '../types.js';
+export interface TodoItem {
+    id: number;
+    text: string;
+    done: boolean;
+    priority?: 'high' | 'medium' | 'low';
+}
+/**
+ * Get all todos.
+ */
+export declare function getTodos(): TodoItem[];
+/**
+ * Clear all todos.
+ */
+export declare function clearTodos(): void;
+export declare const TodoWriteTool: ToolDefinition;
+//# sourceMappingURL=todo-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"todo-tool.d.ts","sourceRoot":"","sources":["../../src/tools/todo-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,aAAa,CAAA;AAE7D,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,OAAO,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA;CACrC;AAKD;;GAEG;AACH,wBAAgB,QAAQ,IAAI,QAAQ,EAAE,CAErC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAGjC;AAED,eAAO,MAAM,aAAa,EAAE,cA8E3B,CAAA"}

package/dist/tools/todo-tool.js

@@ -0,0 +1,93 @@
+/**
+ * TodoWriteTool - Session todo/checklist management
+ *
+ * Manages a session-scoped todo list for tracking work items.
+ */
+const todoList = [];
+let todoCounter = 0;
+/**
+ * Get all todos.
+ */
+export function getTodos() {
+    return [...todoList];
+}
+/**
+ * Clear all todos.
+ */
+export function clearTodos() {
+    todoList.length = 0;
+    todoCounter = 0;
+}
+export const TodoWriteTool = {
+    name: 'TodoWrite',
+    description: 'Manage a session todo/checklist. Supports add, toggle, remove, and list operations.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            action: {
+                type: 'string',
+                enum: ['add', 'toggle', 'remove', 'list', 'clear'],
+                description: 'Operation to perform',
+            },
+            text: { type: 'string', description: 'Todo item text (for add)' },
+            id: { type: 'number', description: 'Todo item ID (for toggle/remove)' },
+            priority: {
+                type: 'string',
+                enum: ['high', 'medium', 'low'],
+                description: 'Priority level (for add)',
+            },
+        },
+        required: ['action'],
+    },
+    isReadOnly: () => false,
+    isConcurrencySafe: () => true,
+    isEnabled: () => true,
+    async prompt() { return 'Manage session todo list.'; },
+    async call(input) {
+        switch (input.action) {
+            case 'add': {
+                if (!input.text) {
+                    return { type: 'tool_result', tool_use_id: '', content: 'text required', is_error: true };
+                }
+                const item = {
+                    id: ++todoCounter,
+                    text: input.text,
+                    done: false,
+                    priority: input.priority,
+                };
+                todoList.push(item);
+                return { type: 'tool_result', tool_use_id: '', content: `Todo added: #${item.id} "${item.text}"` };
+            }
+            case 'toggle': {
+                const item = todoList.find(t => t.id === input.id);
+                if (!item) {
+                    return { type: 'tool_result', tool_use_id: '', content: `Todo #${input.id} not found`, is_error: true };
+                }
+                item.done = !item.done;
+                return { type: 'tool_result', tool_use_id: '', content: `Todo #${item.id} ${item.done ? 'completed' : 'reopened'}` };
+            }
+            case 'remove': {
+                const idx = todoList.findIndex(t => t.id === input.id);
+                if (idx === -1) {
+                    return { type: 'tool_result', tool_use_id: '', content: `Todo #${input.id} not found`, is_error: true };
+                }
+                todoList.splice(idx, 1);
+                return { type: 'tool_result', tool_use_id: '', content: `Todo #${input.id} removed` };
+            }
+            case 'list': {
+                if (todoList.length === 0) {
+                    return { type: 'tool_result', tool_use_id: '', content: 'No todos.' };
+                }
+                const lines = todoList.map(t => `${t.done ? '[x]' : '[ ]'} #${t.id} ${t.text}${t.priority ? ` (${t.priority})` : ''}`);
+                return { type: 'tool_result', tool_use_id: '', content: lines.join('\n') };
+            }
+            case 'clear': {
+                todoList.length = 0;
+                return { type: 'tool_result', tool_use_id: '', content: 'All todos cleared.' };
+            }
+            default:
+                return { type: 'tool_result', tool_use_id: '', content: `Unknown action: ${input.action}`, is_error: true };
+        }
+    },
+};
+//# sourceMappingURL=todo-tool.js.map

package/dist/tools/todo-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-tool.js","sourceRoot":"","sources":["../../src/tools/todo-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,MAAM,QAAQ,GAAe,EAAE,CAAA;AAC/B,IAAI,WAAW,GAAG,CAAC,CAAA;AAEnB;;GAEG;AACH,MAAM,UAAU,QAAQ;IACtB,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAA;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAA;IACnB,WAAW,GAAG,CAAC,CAAA;AACjB,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,qFAAqF;IAClG,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC;gBAClD,WAAW,EAAE,sBAAsB;aACpC;YACD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;YACjE,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;YACvE,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC;gBAC/B,WAAW,EAAE,0BAA0B;aACxC;SACF;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB;IACD,UAAU,EAAE,GAAG,EAAE,CAAC,KAAK;IACvB,iBAAiB,EAAE,GAAG,EAAE,CAAC,IAAI;IAC7B,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;IACrB,KAAK,CAAC,MAAM,KAAK,OAAO,2BAA2B,CAAA,CAAC,CAAC;IACrD,KAAK,CAAC,IAAI,CAAC,KAAU;QACnB,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC;YACrB,KAAK,KAAK,CAAC,CAAC,CAAC;gBACX,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;oBAChB,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;gBAC3F,CAAC;gBACD,MAAM,IAAI,GAAa;oBACrB,EAAE,EAAE,EAAE,WAAW;oBACjB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,IAAI,EAAE,KAAK;oBACX,QAAQ,EAAE,KAAK,CAAC,QAAQ;iBACzB,CAAA;gBACD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACnB,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,gBAAgB,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,IAAI,GAAG,EAAE,CAAA;YACpG,CAAC;YAED,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC,CAAA;gBAClD,IAAI,CAAC,IAAI,EAAE,CAAC;oBACV,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,KAAK,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;gBACzG,CAAC;gBACD,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAA;gBACtB,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,EAAE,EAAE,CAAA;YACtH,CAAC;YAED,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC,CAAA;gBACtD,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;oBACf,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,KAAK,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;gBACzG,CAAC;gBACD,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;gBACvB,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,KAAK,CAAC,EAAE,UAAU,EAAE,CAAA;YACvF,CAAC;YAED,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC1B,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,CAAA;gBACvE,CAAC;gBACD,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAC7B,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACtF,CAAA;gBACD,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAA;YAC5E,CAAC;YAED,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAA;gBACnB,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAA;YAChF,CAAC;YAED;gBACE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,mBAAmB,KAAK,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;QAC/G,CAAC;IACH,CAAC;CACF,CAAA"}

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

@@ -0,0 +1,13 @@
+/**
+ * ToolSearchTool - Discover deferred/lazy-loaded tools
+ *
+ * Allows the model to search for tools that haven't been loaded yet.
+ * Supports keyword search and exact name selection.
+ */
+import type { ToolDefinition } from '../types.js';
+/**
+ * Set deferred tools available for search.
+ */
+export declare function setDeferredTools(tools: ToolDefinition[]): void;
+export declare const ToolSearchTool: ToolDefinition;
+//# sourceMappingURL=tool-search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-search.d.ts","sourceRoot":"","sources":["../../src/tools/tool-search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,aAAa,CAAA;AAK7D;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,IAAI,CAE9D;AAED,eAAO,MAAM,cAAc,EAAE,cAmE5B,CAAA"}

package/dist/tools/tool-search.js

@@ -0,0 +1,76 @@
+/**
+ * ToolSearchTool - Discover deferred/lazy-loaded tools
+ *
+ * Allows the model to search for tools that haven't been loaded yet.
+ * Supports keyword search and exact name selection.
+ */
+// Registry of deferred tools (set by the agent)
+let deferredTools = [];
+/**
+ * Set deferred tools available for search.
+ */
+export function setDeferredTools(tools) {
+    deferredTools = tools;
+}
+export const ToolSearchTool = {
+    name: 'ToolSearch',
+    description: 'Search for additional tools that may be available but not yet loaded. Use keyword search or exact name selection.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'Search query. Use "select:ToolName" for exact match or keywords for search.',
+            },
+            max_results: {
+                type: 'number',
+                description: 'Maximum results to return (default: 5)',
+            },
+        },
+        required: ['query'],
+    },
+    isReadOnly: () => true,
+    isConcurrencySafe: () => true,
+    isEnabled: () => true,
+    async prompt() { return 'Search for available tools.'; },
+    async call(input) {
+        const { query, max_results = 5 } = input;
+        if (deferredTools.length === 0) {
+            return {
+                type: 'tool_result',
+                tool_use_id: '',
+                content: 'No deferred tools available.',
+            };
+        }
+        let matches;
+        if (query.startsWith('select:')) {
+            // Exact name selection
+            const names = query.slice(7).split(',').map((n) => n.trim());
+            matches = deferredTools.filter(t => names.includes(t.name));
+        }
+        else {
+            // Keyword search
+            const keywords = query.toLowerCase().split(/\s+/);
+            matches = deferredTools
+                .filter(t => {
+                const searchText = `${t.name} ${t.description}`.toLowerCase();
+                return keywords.some((kw) => searchText.includes(kw));
+            })
+                .slice(0, max_results);
+        }
+        if (matches.length === 0) {
+            return {
+                type: 'tool_result',
+                tool_use_id: '',
+                content: `No tools found matching "${query}"`,
+            };
+        }
+        const lines = matches.map(t => `- ${t.name}: ${t.description.slice(0, 200)}`);
+        return {
+            type: 'tool_result',
+            tool_use_id: '',
+            content: `Found ${matches.length} tool(s):\n${lines.join('\n')}`,
+        };
+    },
+};
+//# sourceMappingURL=tool-search.js.map

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

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

package/dist/tools/types.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Tool interface and helper utilities
+ */
+import type { ToolDefinition, ToolInputSchema, ToolContext } from '../types.js';
+/**
+ * Helper to create a tool definition with sensible defaults.
+ */
+export declare function defineTool(config: {
+    name: string;
+    description: string;
+    inputSchema: ToolInputSchema;
+    call: (input: any, context: ToolContext) => Promise<string | {
+        data: string;
+        is_error?: boolean;
+    }>;
+    isReadOnly?: boolean;
+    isConcurrencySafe?: boolean;
+    prompt?: string | ((context: ToolContext) => Promise<string>);
+}): ToolDefinition;
+/**
+ * Convert a ToolDefinition to API-compatible tool format.
+ * Returns the normalized tool format used by providers.
+ */
+export declare function toApiTool(tool: ToolDefinition): {
+    name: string;
+    description: string;
+    input_schema: ToolInputSchema;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAc,MAAM,aAAa,CAAA;AAE3F;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,eAAe,CAAA;IAC5B,IAAI,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IAClG,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;CAC9D,GAAG,cAAc,CAgCjB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,cAAc,GAAG;IAC/C,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,eAAe,CAAA;CAC9B,CAMA"}

package/dist/tools/types.js

@@ -0,0 +1,52 @@
+/**
+ * Tool interface and helper utilities
+ */
+/**
+ * Helper to create a tool definition with sensible defaults.
+ */
+export function defineTool(config) {
+    return {
+        name: config.name,
+        description: config.description,
+        inputSchema: config.inputSchema,
+        isReadOnly: () => config.isReadOnly ?? false,
+        isConcurrencySafe: () => config.isConcurrencySafe ?? false,
+        isEnabled: () => true,
+        prompt: typeof config.prompt === 'function'
+            ? config.prompt
+            : async (_context) => config.prompt ?? config.description,
+        async call(input, context) {
+            try {
+                const result = await config.call(input, context);
+                const output = typeof result === 'string' ? result : result.data;
+                const isError = typeof result === 'object' && result.is_error;
+                return {
+                    type: 'tool_result',
+                    tool_use_id: '', // filled by engine
+                    content: output,
+                    is_error: isError || false,
+                };
+            }
+            catch (err) {
+                return {
+                    type: 'tool_result',
+                    tool_use_id: '',
+                    content: `Error: ${err.message}`,
+                    is_error: true,
+                };
+            }
+        },
+    };
+}
+/**
+ * Convert a ToolDefinition to API-compatible tool format.
+ * Returns the normalized tool format used by providers.
+ */
+export function toApiTool(tool) {
+    return {
+        name: tool.name,
+        description: tool.description,
+        input_schema: tool.inputSchema,
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAQ1B;IACC,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,IAAI,KAAK;QAC5C,iBAAiB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,iBAAiB,IAAI,KAAK;QAC1D,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;QACrB,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,UAAU;YACzC,CAAC,CAAC,MAAM,CAAC,MAAM;YACf,CAAC,CAAC,KAAK,EAAE,QAAqB,EAAE,EAAE,CAAE,MAAM,CAAC,MAAiB,IAAI,MAAM,CAAC,WAAW;QACpF,KAAK,CAAC,IAAI,CAAC,KAAU,EAAE,OAAoB;YACzC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;gBAChD,MAAM,MAAM,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAA;gBAChE,MAAM,OAAO,GAAG,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAA;gBAC7D,OAAO;oBACL,IAAI,EAAE,aAAa;oBACnB,WAAW,EAAE,EAAE,EAAE,mBAAmB;oBACpC,OAAO,EAAE,MAAM;oBACf,QAAQ,EAAE,OAAO,IAAI,KAAK;iBAC3B,CAAA;YACH,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,OAAO;oBACL,IAAI,EAAE,aAAa;oBACnB,WAAW,EAAE,EAAE;oBACf,OAAO,EAAE,UAAU,GAAG,CAAC,OAAO,EAAE;oBAChC,QAAQ,EAAE,IAAI;iBACf,CAAA;YACH,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,IAAoB;IAK5C,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,YAAY,EAAE,IAAI,CAAC,WAAW;KAC/B,CAAA;AACH,CAAC"}

package/dist/tools/update-goal.d.ts

@@ -0,0 +1,38 @@
+/**
+ * update_goal — internal tool for the goal-driven loop
+ *
+ * The model calls this tool to report whether the goal is complete, blocked,
+ * or still in progress. It does NOT perform any real action; it only records
+ * the reported status so the goal driver in agent.ts can decide whether to
+ * keep running another round.
+ *
+ * Because the engine faithfully executes tools and feeds the tool_result back
+ * to the model, calling this tool both (a) gives the model a structured way to
+ * declare task state, and (b) lets the driver read that state from the shared
+ * module-level record below.
+ */
+import type { ToolDefinition } from '../types.js';
+/** Reported goal status by the latest update_goal call. */
+export interface GoalReport {
+    status: 'complete' | 'blocked' | 'in_progress';
+    summary?: string;
+    /** Increments on every report so callers can detect "no new report". */
+    revision: number;
+}
+/** Reset the goal record (call at the start of a runGoal). */
+export declare function resetGoalState(revision?: number): void;
+/** Read the latest reported goal state without consuming it. */
+export declare function getGoalState(): Readonly<GoalReport>;
+/** Whether a report with this revision has been recorded (i.e. model spoke). */
+export declare function hasGoalReport(revision: number): boolean;
+/**
+ * The internal update_goal tool definition.
+ * Schema: { goal_status, summary?, error? }
+ */
+export declare function createUpdateGoalTool(): ToolDefinition;
+/**
+ * Build the system-prompt appendix that instructs the model to work toward a
+ * goal and to call update_goal when finished or blocked.
+ */
+export declare function buildGoalSystemPrompt(goal: string, maxRounds: number): string;
+//# sourceMappingURL=update-goal.d.ts.map

package/dist/tools/update-goal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-goal.d.ts","sourceRoot":"","sources":["../../src/tools/update-goal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,2DAA2D;AAC3D,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,aAAa,CAAA;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAA;CACjB;AASD,8DAA8D;AAC9D,wBAAgB,cAAc,CAAC,QAAQ,SAAI,GAAG,IAAI,CAIjD;AAED,gEAAgE;AAChE,wBAAgB,YAAY,IAAI,QAAQ,CAAC,UAAU,CAAC,CAEnD;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAmDrD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAgB7E"}

package/dist/tools/update-goal.js

@@ -0,0 +1,109 @@
+/**
+ * update_goal — internal tool for the goal-driven loop
+ *
+ * The model calls this tool to report whether the goal is complete, blocked,
+ * or still in progress. It does NOT perform any real action; it only records
+ * the reported status so the goal driver in agent.ts can decide whether to
+ * keep running another round.
+ *
+ * Because the engine faithfully executes tools and feeds the tool_result back
+ * to the model, calling this tool both (a) gives the model a structured way to
+ * declare task state, and (b) lets the driver read that state from the shared
+ * module-level record below.
+ */
+/** Module-level recorded goal state shared with the driver. */
+const goalState = {
+    status: 'in_progress',
+    summary: undefined,
+    revision: 0,
+};
+/** Reset the goal record (call at the start of a runGoal). */
+export function resetGoalState(revision = 0) {
+    goalState.status = 'in_progress';
+    goalState.summary = undefined;
+    goalState.revision = revision;
+}
+/** Read the latest reported goal state without consuming it. */
+export function getGoalState() {
+    return { ...goalState };
+}
+/** Whether a report with this revision has been recorded (i.e. model spoke). */
+export function hasGoalReport(revision) {
+    return goalState.revision > revision;
+}
+/**
+ * The internal update_goal tool definition.
+ * Schema: { goal_status, summary?, error? }
+ */
+export function createUpdateGoalTool() {
+    return {
+        name: 'update_goal',
+        description: 'Report the status of the goal you are working toward. Call this when the goal is COMPLETED (goal_status=complete), when you are BLOCKED and cannot make further progress (goal_status=blocked), or to record progress. You should call this at least once before stopping. Provide a concise summary of what was accomplished.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                goal_status: {
+                    type: 'string',
+                    enum: ['complete', 'blocked', 'in_progress'],
+                    description: 'Whether the goal is complete, blocked, or still in progress.',
+                },
+                summary: {
+                    type: 'string',
+                    description: 'Concise summary of what was accomplished or why blocked.',
+                },
+                error: {
+                    type: 'string',
+                    description: 'Optional error description when blocked.',
+                },
+            },
+            required: ['goal_status'],
+        },
+        isReadOnly: () => false,
+        isEnabled: () => true,
+        async prompt() {
+            return 'Call update_goal with goal_status=complete when the goal is done, blocked when stuck. Always include a brief summary.';
+        },
+        async call(input) {
+            const status = input?.goal_status === 'complete'
+                ? 'complete'
+                : input?.goal_status === 'blocked'
+                    ? 'blocked'
+                    : 'in_progress';
+            goalState.status = status;
+            goalState.summary = input?.summary ?? input?.error ?? input?.summary ?? undefined;
+            goalState.revision++;
+            const ack = status === 'complete'
+                ? 'Goal reported complete. Well done.'
+                : status === 'blocked'
+                    ? 'Goal reported blocked. Stopping current round.'
+                    : 'Goal progress noted.';
+            return {
+                type: 'tool_result',
+                tool_use_id: '',
+                content: ack,
+            };
+        },
+    };
+}
+/**
+ * Build the system-prompt appendix that instructs the model to work toward a
+ * goal and to call update_goal when finished or blocked.
+ */
+export function buildGoalSystemPrompt(goal, maxRounds) {
+    return [
+        '',
+        '# Goal-Driven Mode',
+        `You are working toward the following goal:`,
+        ``,
+        `"""`,
+        goal,
+        `"""`,
+        ``,
+        `- Work autonomously toward this goal using your tools. Do not stop early.`,
+        `- When you believe the goal is FULLY achieved, call the update_goal tool with goal_status="complete" and a summary.`,
+        `- If you are truly blocked and cannot proceed, call update_goal with goal_status="blocked".`,
+        `- You may have up to ${maxRounds} rounds to achieve this goal. Use your turns efficiently.`,
+        ``,
+    ].join('\n');
+}
+//# sourceMappingURL=update-goal.js.map

package/dist/tools/update-goal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-goal.js","sourceRoot":"","sources":["../../src/tools/update-goal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAYH,+DAA+D;AAC/D,MAAM,SAAS,GAAe;IAC5B,MAAM,EAAE,aAAa;IACrB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,CAAC;CACZ,CAAA;AAED,8DAA8D;AAC9D,MAAM,UAAU,cAAc,CAAC,QAAQ,GAAG,CAAC;IACzC,SAAS,CAAC,MAAM,GAAG,aAAa,CAAA;IAChC,SAAS,CAAC,OAAO,GAAG,SAAS,CAAA;IAC7B,SAAS,CAAC,QAAQ,GAAG,QAAQ,CAAA;AAC/B,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,YAAY;IAC1B,OAAO,EAAE,GAAG,SAAS,EAAE,CAAA;AACzB,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,OAAO,SAAS,CAAC,QAAQ,GAAG,QAAQ,CAAA;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,gUAAgU;QAClU,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,aAAa,CAAC;oBAC5C,WAAW,EAAE,8DAA8D;iBAC5E;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0DAA0D;iBACxE;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0CAA0C;iBACxD;aACF;YACD,QAAQ,EAAE,CAAC,aAAa,CAAC;SAC1B;QACD,UAAU,EAAE,GAAG,EAAE,CAAC,KAAK;QACvB,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;QACrB,KAAK,CAAC,MAAM;YACV,OAAO,uHAAuH,CAAA;QAChI,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,KAAU;YACnB,MAAM,MAAM,GAAG,KAAK,EAAE,WAAW,KAAK,UAAU;gBAC9C,CAAC,CAAC,UAAU;gBACZ,CAAC,CAAC,KAAK,EAAE,WAAW,KAAK,SAAS;oBAChC,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,aAAa,CAAA;YACnB,SAAS,CAAC,MAAM,GAAG,MAAM,CAAA;YACzB,SAAS,CAAC,OAAO,GAAG,KAAK,EAAE,OAAO,IAAI,KAAK,EAAE,KAAK,IAAI,KAAK,EAAE,OAAO,IAAI,SAAS,CAAA;YACjF,SAAS,CAAC,QAAQ,EAAE,CAAA;YACpB,MAAM,GAAG,GACP,MAAM,KAAK,UAAU;gBACnB,CAAC,CAAC,oCAAoC;gBACtC,CAAC,CAAC,MAAM,KAAK,SAAS;oBACpB,CAAC,CAAC,gDAAgD;oBAClD,CAAC,CAAC,sBAAsB,CAAA;YAC9B,OAAO;gBACL,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE,EAAE;gBACf,OAAO,EAAE,GAAG;aACb,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,SAAiB;IACnE,OAAO;QACL,EAAE;QACF,oBAAoB;QACpB,4CAA4C;QAC5C,EAAE;QACF,KAAK;QACL,IAAI;QACJ,KAAK;QACL,EAAE;QACF,2EAA2E;QAC3E,qHAAqH;QACrH,6FAA6F;QAC7F,wBAAwB,SAAS,2DAA2D;QAC5F,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC"}

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

@@ -0,0 +1,5 @@
+/**
+ * WebFetchTool - Fetch web content
+ */
+export declare const WebFetchTool: import("../types.js").ToolDefinition;
+//# 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":"AAAA;;GAEG;AAIH,eAAO,MAAM,YAAY,sCA2DvB,CAAA"}

package/dist/tools/web-fetch.js

@@ -0,0 +1,60 @@
+/**
+ * WebFetchTool - Fetch web content
+ */
+import { defineTool } from './types.js';
+export const WebFetchTool = defineTool({
+    name: 'WebFetch',
+    description: 'Fetch content from a URL and return it as text. Supports HTML pages, JSON APIs, and plain text. Strips HTML tags for readability.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            url: {
+                type: 'string',
+                description: 'The URL to fetch content from',
+            },
+            headers: {
+                type: 'object',
+                description: 'Optional HTTP headers',
+            },
+        },
+        required: ['url'],
+    },
+    isReadOnly: true,
+    isConcurrencySafe: true,
+    async call(input, _context) {
+        const { url, headers } = input;
+        try {
+            const response = await fetch(url, {
+                headers: {
+                    'User-Agent': 'Mozilla/5.0 (compatible; AgentSDK/1.0)',
+                    ...headers,
+                },
+                signal: AbortSignal.timeout(30000),
+            });
+            if (!response.ok) {
+                return { data: `HTTP ${response.status}: ${response.statusText}`, is_error: true };
+            }
+            const contentType = response.headers.get('content-type') || '';
+            let text = await response.text();
+            // Strip HTML tags for readability
+            if (contentType.includes('text/html')) {
+                // Remove script and style blocks
+                text = text.replace(/<script[^>]*>[\s\S]*?<\/script>/gi, '');
+                text = text.replace(/<style[^>]*>[\s\S]*?<\/style>/gi, '');
+                // Remove HTML tags
+                text = text.replace(/<[^>]+>/g, ' ');
+                // Clean up whitespace
+                text = text.replace(/\s+/g, ' ').trim();
+            }
+            // Truncate very large responses
+            if (text.length > 100000) {
+                text = text.slice(0, 100000) + '\n...(truncated)';
+            }
+            return text || '(empty response)';
+        }
+        catch (err) {
+            return { data: `Error fetching ${url}: ${err.message}`, is_error: true };
+        }
+    },
+});
+//# 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":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvC,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;IACrC,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,mIAAmI;IAChJ,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+BAA+B;aAC7C;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uBAAuB;aACrC;SACF;QACD,QAAQ,EAAE,CAAC,KAAK,CAAC;KAClB;IACD,UAAU,EAAE,IAAI;IAChB,iBAAiB,EAAE,IAAI;IACvB,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ;QACxB,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,KAAK,CAAA;QAE9B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,OAAO,EAAE;oBACP,YAAY,EAAE,wCAAwC;oBACtD,GAAG,OAAO;iBACX;gBACD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;aACnC,CAAC,CAAA;YAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,OAAO,EAAE,IAAI,EAAE,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;YACpF,CAAC;YAED,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAA;YAC9D,IAAI,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;YAEhC,kCAAkC;YAClC,IAAI,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBACtC,iCAAiC;gBACjC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,mCAAmC,EAAE,EAAE,CAAC,CAAA;gBAC5D,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,iCAAiC,EAAE,EAAE,CAAC,CAAA;gBAC1D,mBAAmB;gBACnB,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAA;gBACpC,sBAAsB;gBACtB,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;YACzC,CAAC;YAED,gCAAgC;YAChC,IAAI,IAAI,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;gBACzB,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,kBAAkB,CAAA;YACnD,CAAC;YAED,OAAO,IAAI,IAAI,kBAAkB,CAAA;QACnC,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO,EAAE,IAAI,EAAE,kBAAkB,GAAG,KAAK,GAAG,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;QAC1E,CAAC;IACH,CAAC;CACF,CAAC,CAAA"}

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

@@ -0,0 +1,5 @@
+/**
+ * WebSearchTool - Web search (via web fetch of search engines)
+ */
+export declare const WebSearchTool: import("../types.js").ToolDefinition;
+//# 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;;GAEG;AAIH,eAAO,MAAM,aAAa,sCA+ExB,CAAA"}

package/dist/tools/web-search.js

@@ -0,0 +1,77 @@
+/**
+ * WebSearchTool - Web search (via web fetch of search engines)
+ */
+import { defineTool } from './types.js';
+export const WebSearchTool = defineTool({
+    name: 'WebSearch',
+    description: 'Search the web for information. Returns search results with titles, URLs, and snippets.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'The search query',
+            },
+            num_results: {
+                type: 'number',
+                description: 'Number of results to return (default: 5)',
+            },
+        },
+        required: ['query'],
+    },
+    isReadOnly: true,
+    isConcurrencySafe: true,
+    async call(input, _context) {
+        const { query } = input;
+        try {
+            // Use DuckDuckGo HTML search as a free fallback
+            const encoded = encodeURIComponent(query);
+            const url = `https://html.duckduckgo.com/html/?q=${encoded}`;
+            const response = await fetch(url, {
+                headers: {
+                    'User-Agent': 'Mozilla/5.0 (compatible; AgentSDK/1.0)',
+                },
+                signal: AbortSignal.timeout(15000),
+            });
+            if (!response.ok) {
+                return { data: `Search failed: HTTP ${response.status}`, is_error: true };
+            }
+            const html = await response.text();
+            // Parse search results from DuckDuckGo HTML
+            const results = [];
+            const resultRegex = /<a rel="nofollow" class="result__a" href="([^"]*)"[^>]*>([\s\S]*?)<\/a>/gi;
+            const snippetRegex = /<a class="result__snippet"[^>]*>([\s\S]*?)<\/a>/gi;
+            let match;
+            const links = [];
+            while ((match = resultRegex.exec(html)) !== null) {
+                const href = match[1];
+                const title = match[2].replace(/<[^>]+>/g, '').trim();
+                if (href && title && !href.includes('duckduckgo.com')) {
+                    links.push({ title, url: href });
+                }
+            }
+            const snippets = [];
+            while ((match = snippetRegex.exec(html)) !== null) {
+                snippets.push(match[1].replace(/<[^>]+>/g, '').trim());
+            }
+            const numResults = Math.min(input.num_results || 5, links.length);
+            for (let i = 0; i < numResults; i++) {
+                const link = links[i];
+                if (!link)
+                    continue;
+                let entry = `${i + 1}. ${link.title}\n   ${link.url}`;
+                if (snippets[i]) {
+                    entry += `\n   ${snippets[i]}`;
+                }
+                results.push(entry);
+            }
+            return results.length > 0
+                ? results.join('\n\n')
+                : `No results found for "${query}"`;
+        }
+        catch (err) {
+            return { data: `Search error: ${err.message}`, is_error: true };
+        }
+    },
+});
+//# sourceMappingURL=web-search.js.map