cmdr-agent 2.1.2 → 2.3.0

package/dist/src/tools/built-in/git-worktree.js

@@ -0,0 +1,75 @@
+/**
+ * Built-in git_worktree tool — manage git worktrees for parallel branch work.
+ *
+ * Allows the agent to create, list, and remove worktrees, enabling
+ * work on multiple branches simultaneously without stashing.
+ */
+import { spawn } from 'child_process';
+import { z } from 'zod';
+import { defineTool } from '../registry.js';
+function runGit(args, cwd) {
+    return new Promise((resolve) => {
+        const child = spawn('git', args, { cwd, stdio: ['ignore', 'pipe', 'pipe'] });
+        const chunks = [];
+        const errChunks = [];
+        child.stdout.on('data', (c) => chunks.push(c));
+        child.stderr.on('data', (c) => errChunks.push(c));
+        child.on('close', (code) => {
+            resolve({
+                stdout: Buffer.concat(chunks).toString('utf-8').trim(),
+                stderr: Buffer.concat(errChunks).toString('utf-8').trim(),
+                code: code ?? 1,
+            });
+        });
+        child.on('error', (err) => {
+            resolve({ stdout: '', stderr: err.message, code: 1 });
+        });
+    });
+}
+export const gitWorktreeTool = defineTool({
+    name: 'git_worktree',
+    description: 'Manage git worktrees for parallel branch work. ' +
+        'Actions: list (show worktrees), add (create new worktree), remove (delete worktree).',
+    inputSchema: z.object({
+        action: z.enum(['list', 'add', 'remove']).describe('Worktree action to perform.'),
+        path: z.string().optional().describe('Path for the new worktree (required for add/remove).'),
+        branch: z.string().optional().describe('Branch name for the worktree (for add). Created if -b is needed.'),
+        createBranch: z.boolean().optional().describe('Create a new branch for the worktree.'),
+    }),
+    execute: async (input, context) => {
+        const cwd = context.cwd ?? process.cwd();
+        switch (input.action) {
+            case 'list': {
+                const result = await runGit(['worktree', 'list', '--porcelain'], cwd);
+                if (result.code !== 0)
+                    return { data: result.stderr || 'Failed to list worktrees', isError: true };
+                return { data: result.stdout || '(no worktrees)' };
+            }
+            case 'add': {
+                if (!input.path)
+                    return { data: '"path" is required for add action', isError: true };
+                const args = ['worktree', 'add'];
+                if (input.createBranch && input.branch) {
+                    args.push('-b', input.branch);
+                }
+                args.push(input.path);
+                if (input.branch && !input.createBranch) {
+                    args.push(input.branch);
+                }
+                const result = await runGit(args, cwd);
+                if (result.code !== 0)
+                    return { data: result.stderr || 'Failed to add worktree', isError: true };
+                return { data: result.stdout || `Worktree created at ${input.path}` };
+            }
+            case 'remove': {
+                if (!input.path)
+                    return { data: '"path" is required for remove action', isError: true };
+                const result = await runGit(['worktree', 'remove', input.path], cwd);
+                if (result.code !== 0)
+                    return { data: result.stderr || 'Failed to remove worktree', isError: true };
+                return { data: result.stdout || `Worktree at ${input.path} removed` };
+            }
+        }
+    },
+});
+//# sourceMappingURL=git-worktree.js.map

package/dist/src/tools/built-in/git-worktree.js.map

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

package/dist/src/tools/built-in/index.d.ts

@@ -12,10 +12,20 @@ import { globTool } from './glob.js';
 import { gitDiffTool } from './git-diff.js';
 import { gitLogTool } from './git-log.js';
 import { gitCommitTool, gitBranchTool } from './git-commit.js';
+import { gitWorktreeTool } from './git-worktree.js';
 import { thinkTool } from './think.js';
 import { webFetchTool } from './web-fetch.js';
+import { webSearchTool } from './web-search.js';
 import { askUserTool } from './ask-user.js';
-export { bashTool, fileReadTool, fileWriteTool, fileEditTool, grepTool, globTool, gitDiffTool, gitLogTool, gitCommitTool, gitBranchTool, thinkTool, webFetchTool, askUserTool, };
+import { memoryReadTool, memoryWriteTool } from './memory.js';
+import { lspDiagnosticsTool } from './diagnostics.js';
+import { notebookReadTool, notebookEditTool, notebookRunTool } from './notebook.js';
+import { todoWriteTool } from './todo-tool.js';
+import { taskCreateTool, taskListTool, taskGetTool, taskStopTool } from './task-tools.js';
+import { cronCreateTool, cronListTool, cronDeleteTool } from './cron-tools.js';
+import { enterPlanModeTool, exitPlanModeTool } from './plan-tools.js';
+import { mcpListResourcesTool, mcpReadResourceTool } from './mcp-resource-tools.js';
+export { bashTool, fileReadTool, fileWriteTool, fileEditTool, grepTool, globTool, gitDiffTool, gitLogTool, gitCommitTool, gitBranchTool, gitWorktreeTool, lspDiagnosticsTool, notebookReadTool, notebookEditTool, notebookRunTool, thinkTool, webFetchTool, webSearchTool, askUserTool, memoryReadTool, memoryWriteTool, todoWriteTool, taskCreateTool, taskListTool, taskGetTool, taskStopTool, cronCreateTool, cronListTool, cronDeleteTool, enterPlanModeTool, exitPlanModeTool, mcpListResourcesTool, mcpReadResourceTool, };
 export declare const BUILT_IN_TOOLS: ToolDefinition<any>[];
 export declare function registerBuiltInTools(registry: ToolRegistry): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/src/tools/built-in/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/built-in/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C,OAAO,EACL,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EACnD,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EACzE,SAAS,EAAE,YAAY,EAAE,WAAW,GACrC,CAAA;AAGD,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,GAAG,CAAC,EAI/C,CAAA;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAMjE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/built-in/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACzF,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAC9E,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACrE,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAEnF,OAAO,EACL,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EACnD,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EACzE,eAAe,EAAE,kBAAkB,EACnC,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EACnD,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EACpF,aAAa,EACb,cAAc,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EACvD,cAAc,EAAE,YAAY,EAAE,cAAc,EAC5C,iBAAiB,EAAE,gBAAgB,EACnC,oBAAoB,EAAE,mBAAmB,GAC1C,CAAA;AAGD,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,GAAG,CAAC,EAW/C,CAAA;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAMjE"}

package/dist/src/tools/built-in/index.js

@@ -10,15 +10,32 @@ import { globTool } from './glob.js';
 import { gitDiffTool } from './git-diff.js';
 import { gitLogTool } from './git-log.js';
 import { gitCommitTool, gitBranchTool } from './git-commit.js';
+import { gitWorktreeTool } from './git-worktree.js';
 import { thinkTool } from './think.js';
 import { webFetchTool } from './web-fetch.js';
+import { webSearchTool } from './web-search.js';
 import { askUserTool } from './ask-user.js';
-export { bashTool, fileReadTool, fileWriteTool, fileEditTool, grepTool, globTool, gitDiffTool, gitLogTool, gitCommitTool, gitBranchTool, thinkTool, webFetchTool, askUserTool, };
+import { memoryReadTool, memoryWriteTool } from './memory.js';
+import { lspDiagnosticsTool } from './diagnostics.js';
+import { notebookReadTool, notebookEditTool, notebookRunTool } from './notebook.js';
+import { todoWriteTool } from './todo-tool.js';
+import { taskCreateTool, taskListTool, taskGetTool, taskStopTool } from './task-tools.js';
+import { cronCreateTool, cronListTool, cronDeleteTool } from './cron-tools.js';
+import { enterPlanModeTool, exitPlanModeTool } from './plan-tools.js';
+import { mcpListResourcesTool, mcpReadResourceTool } from './mcp-resource-tools.js';
+export { bashTool, fileReadTool, fileWriteTool, fileEditTool, grepTool, globTool, gitDiffTool, gitLogTool, gitCommitTool, gitBranchTool, gitWorktreeTool, lspDiagnosticsTool, notebookReadTool, notebookEditTool, notebookRunTool, thinkTool, webFetchTool, webSearchTool, askUserTool, memoryReadTool, memoryWriteTool, todoWriteTool, taskCreateTool, taskListTool, taskGetTool, taskStopTool, cronCreateTool, cronListTool, cronDeleteTool, enterPlanModeTool, exitPlanModeTool, mcpListResourcesTool, mcpReadResourceTool, };
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export const BUILT_IN_TOOLS = [
     bashTool, fileReadTool, fileWriteTool, fileEditTool,
     grepTool, globTool, gitDiffTool, gitLogTool, gitCommitTool, gitBranchTool,
-    thinkTool, webFetchTool, askUserTool,
+    gitWorktreeTool, lspDiagnosticsTool,
+    notebookReadTool, notebookEditTool, notebookRunTool,
+    thinkTool, webFetchTool, webSearchTool, askUserTool, memoryReadTool, memoryWriteTool,
+    todoWriteTool,
+    taskCreateTool, taskListTool, taskGetTool, taskStopTool,
+    cronCreateTool, cronListTool, cronDeleteTool,
+    enterPlanModeTool, exitPlanModeTool,
+    mcpListResourcesTool, mcpReadResourceTool,
 ];
 export function registerBuiltInTools(registry) {
     for (const tool of BUILT_IN_TOOLS) {

package/dist/src/tools/built-in/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/built-in/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C,OAAO,EACL,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EACnD,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EACzE,SAAS,EAAE,YAAY,EAAE,WAAW,GACrC,CAAA;AAED,8DAA8D;AAC9D,MAAM,CAAC,MAAM,cAAc,GAA0B;IACnD,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY;IACnD,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa;IACzE,SAAS,EAAE,YAAY,EAAE,WAAW;CACrC,CAAA;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAsB;IACzD,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QACzB,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/built-in/index.ts"],"names":[],"mappings":"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"}

package/dist/src/tools/built-in/mcp-resource-tools.d.ts

@@ -0,0 +1,16 @@
+/**
+ * MCP resource tools — list and read resources from connected MCP servers.
+ *
+ * MCP servers can expose resources (files, database schemas, API docs, etc.)
+ * in addition to tools. These tools let the LLM discover and read them.
+ */
+import type { McpClient } from '../../plugins/mcp-client.js';
+export declare function setMcpClient(client: McpClient): void;
+export declare const mcpListResourcesTool: import("../registry.js").ToolDefinition<{
+    server?: string | undefined;
+}>;
+export declare const mcpReadResourceTool: import("../registry.js").ToolDefinition<{
+    server: string;
+    uri: string;
+}>;
+//# sourceMappingURL=mcp-resource-tools.d.ts.map

package/dist/src/tools/built-in/mcp-resource-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-resource-tools.d.ts","sourceRoot":"","sources":["../../../../src/tools/built-in/mcp-resource-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAA;AAI5D,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAEpD;AAED,eAAO,MAAM,oBAAoB;;EAkC/B,CAAA;AAEF,eAAO,MAAM,mBAAmB;;;EAgC9B,CAAA"}

package/dist/src/tools/built-in/mcp-resource-tools.js

@@ -0,0 +1,73 @@
+/**
+ * MCP resource tools — list and read resources from connected MCP servers.
+ *
+ * MCP servers can expose resources (files, database schemas, API docs, etc.)
+ * in addition to tools. These tools let the LLM discover and read them.
+ */
+import { z } from 'zod';
+import { defineTool } from '../registry.js';
+let mcpClientRef = null;
+export function setMcpClient(client) {
+    mcpClientRef = client;
+}
+export const mcpListResourcesTool = defineTool({
+    name: 'mcp_list_resources',
+    description: 'List available resources from connected MCP servers. Resources are additional context like files, database schemas, or documentation that MCP servers can provide.',
+    inputSchema: z.object({
+        server: z.string().optional().describe('Optional: filter to a specific MCP server name'),
+    }),
+    execute: async (input) => {
+        if (!mcpClientRef) {
+            return { data: 'No MCP client available', isError: true };
+        }
+        const connections = mcpClientRef.listConnections();
+        if (connections.length === 0) {
+            return { data: 'No MCP servers connected. Use /mcp to manage connections.' };
+        }
+        const filtered = input.server
+            ? connections.filter(c => c.name === input.server)
+            : connections;
+        if (filtered.length === 0) {
+            return { data: `MCP server "${input.server}" not found. Connected: ${connections.map(c => c.name).join(', ')}`, isError: true };
+        }
+        // Note: Resource listing requires the MCP server to support resources/list.
+        // This is a best-effort — many servers only support tools.
+        const lines = filtered.map(c => `${c.name} (${c.transport}) — ${c.tools} tools${c.connected ? '' : ' [disconnected]'}`);
+        return {
+            data: `Connected MCP servers:\n${lines.join('\n')}\n\nNote: Use mcp_read_resource with a specific server and resource URI to read content.`,
+        };
+    },
+});
+export const mcpReadResourceTool = defineTool({
+    name: 'mcp_read_resource',
+    description: 'Read a specific resource from an MCP server by URI. The resource URI format depends on the server (e.g. "file:///path", "db://schema/table").',
+    inputSchema: z.object({
+        server: z.string().describe('The MCP server name'),
+        uri: z.string().describe('The resource URI to read'),
+    }),
+    execute: async (input) => {
+        if (!mcpClientRef) {
+            return { data: 'No MCP client available', isError: true };
+        }
+        // Validate URI format
+        try {
+            new URL(input.uri);
+        }
+        catch {
+            // Allow relative URIs too — some MCP servers use simple paths
+        }
+        try {
+            // Use the MCP client's callTool to send a resources/read request
+            // This piggybacks on the existing transport infrastructure
+            const result = await mcpClientRef.callTool(input.server, '__resources_read__', {
+                uri: input.uri,
+            });
+            return result;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { data: `Failed to read resource: ${msg}`, isError: true };
+        }
+    },
+});
+//# sourceMappingURL=mcp-resource-tools.js.map

package/dist/src/tools/built-in/mcp-resource-tools.js.map

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

package/dist/src/tools/built-in/memory.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Built-in memory tools — read and write persistent MEMORY.md files.
+ *
+ * Two scopes:
+ *   - project: .cmdr/MEMORY.md — project conventions, build commands, patterns
+ *   - user:    ~/.cmdr/MEMORY.md — personal preferences, global patterns
+ */
+export declare const memoryReadTool: import("../registry.js").ToolDefinition<{
+    scope: "user" | "project";
+}>;
+export declare const memoryWriteTool: import("../registry.js").ToolDefinition<{
+    content: string;
+    scope: "user" | "project";
+}>;
+//# sourceMappingURL=memory.d.ts.map

package/dist/src/tools/built-in/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../../src/tools/built-in/memory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,eAAO,MAAM,cAAc;;EA4BzB,CAAA;AAEF,eAAO,MAAM,eAAe;;;EA0B1B,CAAA"}

package/dist/src/tools/built-in/memory.js

@@ -0,0 +1,58 @@
+/**
+ * Built-in memory tools — read and write persistent MEMORY.md files.
+ *
+ * Two scopes:
+ *   - project: .cmdr/MEMORY.md — project conventions, build commands, patterns
+ *   - user:    ~/.cmdr/MEMORY.md — personal preferences, global patterns
+ */
+import { z } from 'zod';
+import { defineTool } from '../registry.js';
+export const memoryReadTool = defineTool({
+    name: 'memory_read',
+    description: 'Read persistent memory notes. Scope "project" reads .cmdr/MEMORY.md (repo-specific), ' +
+        'scope "user" reads ~/.cmdr/MEMORY.md (global). Memory persists across sessions.',
+    inputSchema: z.object({
+        scope: z.enum(['project', 'user']).describe('Which memory file to read.'),
+    }),
+    execute: async (input, context) => {
+        try {
+            // MemoryManager is injected via context.metadata
+            const manager = context.metadata?.memoryManager;
+            if (!manager) {
+                return { data: 'Memory system not initialized.', isError: true };
+            }
+            const content = await manager.read(input.scope);
+            if (!content.trim()) {
+                return { data: `No ${input.scope} memory found. Use memory_write to save notes.` };
+            }
+            return { data: content };
+        }
+        catch (err) {
+            return { data: `Failed to read memory: ${err instanceof Error ? err.message : String(err)}`, isError: true };
+        }
+    },
+});
+export const memoryWriteTool = defineTool({
+    name: 'memory_write',
+    description: 'Save notes to persistent memory. Use "project" scope for repo-specific info ' +
+        '(build commands, conventions, architecture notes). Use "user" scope for personal ' +
+        'preferences and global patterns. Content is appended with a date header.',
+    inputSchema: z.object({
+        scope: z.enum(['project', 'user']).describe('Which memory file to write to.'),
+        content: z.string().describe('The note to append to memory. Keep concise — bullet points preferred.'),
+    }),
+    execute: async (input, context) => {
+        try {
+            const manager = context.metadata?.memoryManager;
+            if (!manager) {
+                return { data: 'Memory system not initialized.', isError: true };
+            }
+            await manager.append(input.scope, input.content);
+            return { data: `Saved to ${input.scope} memory.` };
+        }
+        catch (err) {
+            return { data: `Failed to write memory: ${err instanceof Error ? err.message : String(err)}`, isError: true };
+        }
+    },
+});
+//# sourceMappingURL=memory.js.map

package/dist/src/tools/built-in/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../../src/tools/built-in/memory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAE3C,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;IACvC,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,uFAAuF;QACvF,iFAAiF;IAEnF,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;KAC1E,CAAC;IAEF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChC,IAAI,CAAC;YACH,iDAAiD;YACjD,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,aACkC,CAAA;YACpE,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,EAAE,IAAI,EAAE,gCAAgC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;YAClE,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YAC/C,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;gBACpB,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC,KAAK,gDAAgD,EAAE,CAAA;YACpF,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;QAC1B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,EAAE,IAAI,EAAE,0BAA0B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QAC9G,CAAC;IACH,CAAC;CACF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAC;IACxC,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,8EAA8E;QAC9E,mFAAmF;QACnF,0EAA0E;IAE5E,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,gCAAgC,CAAC;QAC7E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uEAAuE,CAAC;KACtG,CAAC;IAEF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,aACkC,CAAA;YACpE,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,EAAE,IAAI,EAAE,gCAAgC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;YAClE,CAAC;YAED,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;YAChD,OAAO,EAAE,IAAI,EAAE,YAAY,KAAK,CAAC,KAAK,UAAU,EAAE,CAAA;QACpD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,EAAE,IAAI,EAAE,2BAA2B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QAC/G,CAAC;IACH,CAAC;CACF,CAAC,CAAA"}

package/dist/src/tools/built-in/notebook.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Built-in notebook tool — read, write, and execute Jupyter notebook cells.
+ *
+ * Works with .ipynb files directly, parsing the notebook JSON format.
+ * Execution uses `jupyter nbconvert --execute` or `jupyter run` when available.
+ */
+export declare const notebookReadTool: import("../registry.js").ToolDefinition<{
+    path: string;
+    cell?: number | undefined;
+}>;
+export declare const notebookEditTool: import("../registry.js").ToolDefinition<{
+    path: string;
+    action: "replace" | "insert" | "delete";
+    cell: number;
+    content?: string | undefined;
+    cell_type?: "code" | "markdown" | "raw" | undefined;
+}>;
+export declare const notebookRunTool: import("../registry.js").ToolDefinition<{
+    path: string;
+    cell?: number | undefined;
+}>;
+//# sourceMappingURL=notebook.d.ts.map

package/dist/src/tools/built-in/notebook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notebook.d.ts","sourceRoot":"","sources":["../../../../src/tools/built-in/notebook.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0CH,eAAO,MAAM,gBAAgB;;;EAkC3B,CAAA;AAEF,eAAO,MAAM,gBAAgB;;;;;;EAiE3B,CAAA;AAEF,eAAO,MAAM,eAAe;;;EAgG1B,CAAA"}

package/dist/src/tools/built-in/notebook.js

@@ -0,0 +1,207 @@
+/**
+ * Built-in notebook tool — read, write, and execute Jupyter notebook cells.
+ *
+ * Works with .ipynb files directly, parsing the notebook JSON format.
+ * Execution uses `jupyter nbconvert --execute` or `jupyter run` when available.
+ */
+import { readFile, writeFile } from 'node:fs/promises';
+import { spawn } from 'node:child_process';
+import { z } from 'zod';
+import { defineTool } from '../registry.js';
+function formatCell(cell, index) {
+    const type = cell.cell_type.toUpperCase();
+    const source = cell.source.join('');
+    const exec = cell.execution_count != null ? ` [${cell.execution_count}]` : '';
+    let output = `--- Cell ${index + 1} (${type})${exec} ---\n${source}`;
+    if (cell.outputs && cell.outputs.length > 0) {
+        const outputTexts = cell.outputs.map((o) => {
+            if (o.text)
+                return (Array.isArray(o.text) ? o.text.join('') : o.text);
+            if (o.data?.['text/plain'])
+                return Array.isArray(o.data['text/plain']) ? o.data['text/plain'].join('') : o.data['text/plain'];
+            if (o.ename)
+                return `${o.ename}: ${o.evalue}`;
+            return '';
+        }).filter(Boolean);
+        if (outputTexts.length > 0) {
+            output += `\n\n>> Output:\n${outputTexts.join('\n')}`;
+        }
+    }
+    return output;
+}
+export const notebookReadTool = defineTool({
+    name: 'notebook_read',
+    description: 'Read a Jupyter notebook (.ipynb) file. Returns cell contents with their types and outputs. ' +
+        'Can read specific cells by index or the entire notebook.',
+    inputSchema: z.object({
+        path: z.string().describe('Path to the .ipynb file.'),
+        cell: z.number().optional().describe('0-based cell index to read. Omit to read all cells.'),
+    }),
+    execute: async (input, context) => {
+        const cwd = context.cwd ?? process.cwd();
+        const fullPath = input.path.startsWith('/') ? input.path : `${cwd}/${input.path}`;
+        try {
+            const raw = await readFile(fullPath, 'utf-8');
+            const nb = JSON.parse(raw);
+            if (input.cell != null) {
+                if (input.cell < 0 || input.cell >= nb.cells.length) {
+                    return { data: `Cell index ${input.cell} out of range (0-${nb.cells.length - 1})`, isError: true };
+                }
+                return { data: formatCell(nb.cells[input.cell], input.cell) };
+            }
+            const kernelMeta = nb.metadata?.kernelspec;
+            const summary = `Notebook: ${nb.cells.length} cells (${kernelMeta?.display_name ?? 'unknown kernel'})\n\n`;
+            const cells = nb.cells.map((c, i) => formatCell(c, i)).join('\n\n');
+            return { data: summary + cells };
+        }
+        catch (err) {
+            return { data: `Failed to read notebook: ${err instanceof Error ? err.message : String(err)}`, isError: true };
+        }
+    },
+});
+export const notebookEditTool = defineTool({
+    name: 'notebook_edit',
+    description: 'Edit a Jupyter notebook cell. Can replace cell content, insert new cells, or delete cells.',
+    inputSchema: z.object({
+        path: z.string().describe('Path to the .ipynb file.'),
+        action: z.enum(['replace', 'insert', 'delete']).describe('Edit action.'),
+        cell: z.number().describe('0-based cell index (for replace/delete) or insertion position (for insert).'),
+        content: z.string().optional().describe('New cell content (for replace/insert).'),
+        cell_type: z.enum(['code', 'markdown', 'raw']).optional().describe('Cell type for insert (default: code).'),
+    }),
+    execute: async (input, context) => {
+        const cwd = context.cwd ?? process.cwd();
+        const fullPath = input.path.startsWith('/') ? input.path : `${cwd}/${input.path}`;
+        try {
+            const raw = await readFile(fullPath, 'utf-8');
+            const nb = JSON.parse(raw);
+            switch (input.action) {
+                case 'replace': {
+                    if (input.cell < 0 || input.cell >= nb.cells.length) {
+                        return { data: `Cell index ${input.cell} out of range`, isError: true };
+                    }
+                    if (!input.content)
+                        return { data: 'content is required for replace', isError: true };
+                    nb.cells[input.cell].source = input.content.split('\n').map((l, i, arr) => i < arr.length - 1 ? l + '\n' : l);
+                    nb.cells[input.cell].outputs = [];
+                    nb.cells[input.cell].execution_count = null;
+                    break;
+                }
+                case 'insert': {
+                    if (input.cell < 0 || input.cell > nb.cells.length) {
+                        return { data: `Insertion position ${input.cell} out of range`, isError: true };
+                    }
+                    const newCell = {
+                        cell_type: input.cell_type ?? 'code',
+                        source: (input.content ?? '').split('\n').map((l, i, arr) => i < arr.length - 1 ? l + '\n' : l),
+                        metadata: {},
+                        outputs: input.cell_type === 'code' || !input.cell_type ? [] : undefined,
+                        execution_count: input.cell_type === 'code' || !input.cell_type ? null : undefined,
+                    };
+                    nb.cells.splice(input.cell, 0, newCell);
+                    break;
+                }
+                case 'delete': {
+                    if (input.cell < 0 || input.cell >= nb.cells.length) {
+                        return { data: `Cell index ${input.cell} out of range`, isError: true };
+                    }
+                    nb.cells.splice(input.cell, 1);
+                    break;
+                }
+            }
+            await writeFile(fullPath, JSON.stringify(nb, null, 1) + '\n', 'utf-8');
+            return { data: `Notebook updated: ${input.action} cell ${input.cell} (${nb.cells.length} cells total)` };
+        }
+        catch (err) {
+            return { data: `Failed to edit notebook: ${err instanceof Error ? err.message : String(err)}`, isError: true };
+        }
+    },
+});
+export const notebookRunTool = defineTool({
+    name: 'notebook_run',
+    description: 'Execute a Jupyter notebook cell or the entire notebook. Requires jupyter to be installed.',
+    inputSchema: z.object({
+        path: z.string().describe('Path to the .ipynb file.'),
+        cell: z.number().optional().describe('0-based cell index to execute. Omit to run entire notebook.'),
+    }),
+    execute: async (input, context) => {
+        const cwd = context.cwd ?? process.cwd();
+        const fullPath = input.path.startsWith('/') ? input.path : `${cwd}/${input.path}`;
+        if (input.cell != null) {
+            // Execute single cell by using jupyter's execute API
+            // Read notebook, extract cell, run with python -c, put output back
+            try {
+                const raw = await readFile(fullPath, 'utf-8');
+                const nb = JSON.parse(raw);
+                const cell = nb.cells[input.cell];
+                if (!cell)
+                    return { data: `Cell ${input.cell} not found`, isError: true };
+                if (cell.cell_type !== 'code')
+                    return { data: `Cell ${input.cell} is not a code cell`, isError: true };
+                const code = cell.source.join('');
+                return new Promise((resolve) => {
+                    const child = spawn('python3', ['-c', code], {
+                        cwd,
+                        stdio: ['ignore', 'pipe', 'pipe'],
+                    });
+                    const out = [];
+                    const err = [];
+                    const timeout = setTimeout(() => {
+                        child.kill();
+                        resolve({ data: 'Cell execution timed out after 30s', isError: true });
+                    }, 30_000);
+                    child.stdout.on('data', (c) => out.push(c));
+                    child.stderr.on('data', (c) => err.push(c));
+                    child.on('close', (exitCode) => {
+                        clearTimeout(timeout);
+                        const stdout = Buffer.concat(out).toString('utf-8').trim();
+                        const stderr = Buffer.concat(err).toString('utf-8').trim();
+                        if (exitCode === 0) {
+                            resolve({ data: stdout || '(no output)' });
+                        }
+                        else {
+                            resolve({ data: stderr || stdout || 'Cell execution failed', isError: true });
+                        }
+                    });
+                    child.on('error', (e) => {
+                        clearTimeout(timeout);
+                        resolve({ data: `Failed to run cell: ${e.message}`, isError: true });
+                    });
+                });
+            }
+            catch (err) {
+                return { data: `Failed: ${err instanceof Error ? err.message : String(err)}`, isError: true };
+            }
+        }
+        // Execute entire notebook
+        return new Promise((resolve) => {
+            const child = spawn('jupyter', [
+                'nbconvert', '--to', 'notebook', '--execute',
+                '--output', fullPath, fullPath,
+            ], { cwd, stdio: ['ignore', 'pipe', 'pipe'] });
+            const out = [];
+            const err = [];
+            const timeout = setTimeout(() => {
+                child.kill();
+                resolve({ data: 'Notebook execution timed out after 120s', isError: true });
+            }, 120_000);
+            child.stdout.on('data', (c) => out.push(c));
+            child.stderr.on('data', (c) => err.push(c));
+            child.on('close', (code) => {
+                clearTimeout(timeout);
+                if (code === 0) {
+                    resolve({ data: `Notebook executed successfully.` });
+                }
+                else {
+                    const stderr = Buffer.concat(err).toString('utf-8').trim();
+                    resolve({ data: stderr || 'Notebook execution failed', isError: true });
+                }
+            });
+            child.on('error', (e) => {
+                clearTimeout(timeout);
+                resolve({ data: `jupyter not found: ${e.message}. Install with: pip install jupyter`, isError: true });
+            });
+        });
+    },
+});
+//# sourceMappingURL=notebook.js.map

package/dist/src/tools/built-in/notebook.js.map

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

package/dist/src/tools/built-in/plan-tools.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Plan mode tools — allow the LLM to self-manage planning vs execution mode.
+ *
+ * When in plan mode, the LLM should describe its approach before executing.
+ * These tools let the LLM switch modes programmatically.
+ */
+export declare function isPlanMode(): boolean;
+export declare function setPlanMode(active: boolean): void;
+export declare const enterPlanModeTool: import("../registry.js").ToolDefinition<{
+    reason?: string | undefined;
+}>;
+export declare const exitPlanModeTool: import("../registry.js").ToolDefinition<{}>;
+//# sourceMappingURL=plan-tools.d.ts.map

package/dist/src/tools/built-in/plan-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-tools.d.ts","sourceRoot":"","sources":["../../../../src/tools/built-in/plan-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAEjD;AAED,eAAO,MAAM,iBAAiB;;EAa5B,CAAA;AAEF,eAAO,MAAM,gBAAgB,6CAU3B,CAAA"}