cmdr-agent 2.1.2 → 2.3.0

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

@@ -0,0 +1,42 @@
+/**
+ * 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.
+ */
+import { z } from 'zod';
+import { defineTool } from '../registry.js';
+// Global plan mode state — can also be set by /plan command
+let planModeActive = false;
+export function isPlanMode() {
+    return planModeActive;
+}
+export function setPlanMode(active) {
+    planModeActive = active;
+}
+export const enterPlanModeTool = defineTool({
+    name: 'enter_plan_mode',
+    description: 'Switch to plan mode. In plan mode, describe your approach and reasoning before executing any tools. Use this when the task is complex and would benefit from planning first.',
+    inputSchema: z.object({
+        reason: z.string().optional().describe('Why you are entering plan mode'),
+    }),
+    execute: async (input) => {
+        planModeActive = true;
+        const reason = input.reason ? ` Reason: ${input.reason}` : '';
+        return {
+            data: `Plan mode activated.${reason}\n\nYou are now in plan mode. Describe your approach step-by-step before executing. Use exit_plan_mode when ready to execute.`,
+        };
+    },
+});
+export const exitPlanModeTool = defineTool({
+    name: 'exit_plan_mode',
+    description: 'Exit plan mode and return to execution mode. Use this after you have laid out your plan and are ready to start implementing.',
+    inputSchema: z.object({}),
+    execute: async () => {
+        planModeActive = false;
+        return {
+            data: 'Plan mode deactivated. You are now in execution mode. Proceed with implementing your plan.',
+        };
+    },
+});
+//# sourceMappingURL=plan-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan-tools.js","sourceRoot":"","sources":["../../../../src/tools/built-in/plan-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAE3C,4DAA4D;AAC5D,IAAI,cAAc,GAAG,KAAK,CAAA;AAE1B,MAAM,UAAU,UAAU;IACxB,OAAO,cAAc,CAAA;AACvB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAe;IACzC,cAAc,GAAG,MAAM,CAAA;AACzB,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;IAC1C,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,8KAA8K;IAC3L,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;KACzE,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACvB,cAAc,GAAG,IAAI,CAAA;QACrB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAC7D,OAAO;YACL,IAAI,EAAE,uBAAuB,MAAM,+HAA+H;SACnK,CAAA;IACH,CAAC;CACF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAC;IACzC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,8HAA8H;IAC3I,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACzB,OAAO,EAAE,KAAK,IAAI,EAAE;QAClB,cAAc,GAAG,KAAK,CAAA;QACtB,OAAO;YACL,IAAI,EAAE,4FAA4F;SACnG,CAAA;IACH,CAAC;CACF,CAAC,CAAA"}

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

@@ -0,0 +1,22 @@
+/**
+ * Task management tools — LLM-driven wrappers around TaskScheduler.
+ *
+ * Provides task_create, task_list, task_get, task_stop for the LLM to
+ * schedule and manage background tasks.
+ */
+import type { TaskScheduler } from '../../scheduling/task-scheduler.js';
+export declare function setTaskScheduler(ts: TaskScheduler): void;
+export declare const taskCreateTool: import("../registry.js").ToolDefinition<{
+    command: string;
+    name: string;
+    intervalMs?: number | undefined;
+    delayMs?: number | undefined;
+}>;
+export declare const taskListTool: import("../registry.js").ToolDefinition<{}>;
+export declare const taskGetTool: import("../registry.js").ToolDefinition<{
+    id: string;
+}>;
+export declare const taskStopTool: import("../registry.js").ToolDefinition<{
+    id: string;
+}>;
+//# sourceMappingURL=task-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task-tools.d.ts","sourceRoot":"","sources":["../../../../src/tools/built-in/task-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAA;AAKvE,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI,CAExD;AAED,eAAO,MAAM,cAAc;;;;;EA6BzB,CAAA;AAEF,eAAO,MAAM,YAAY,6CA4BvB,CAAA;AAEF,eAAO,MAAM,WAAW;;EA2BtB,CAAA;AAEF,eAAO,MAAM,YAAY;;EAkBvB,CAAA"}

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

@@ -0,0 +1,113 @@
+/**
+ * Task management tools — LLM-driven wrappers around TaskScheduler.
+ *
+ * Provides task_create, task_list, task_get, task_stop for the LLM to
+ * schedule and manage background tasks.
+ */
+import { z } from 'zod';
+import { defineTool } from '../registry.js';
+// TaskScheduler reference is set during REPL startup
+let scheduler = null;
+export function setTaskScheduler(ts) {
+    scheduler = ts;
+}
+export const taskCreateTool = defineTool({
+    name: 'task_create',
+    description: 'Create a background scheduled task. Supports one-shot (delayed) and recurring (interval) tasks. The task runs a shell command.',
+    inputSchema: z.object({
+        name: z.string().describe('Human-readable name for the task'),
+        command: z.string().describe('Shell command to execute'),
+        intervalMs: z.number().optional().describe('Run every N milliseconds (recurring). Omit for one-shot.'),
+        delayMs: z.number().optional().describe('Delay before first/only run (default: 0 for immediate)'),
+    }),
+    execute: async (input) => {
+        if (!scheduler) {
+            return { data: 'TaskScheduler is not initialized', isError: true };
+        }
+        const { execSync } = await import('node:child_process');
+        const handler = async () => {
+            execSync(input.command, { timeout: 30000, stdio: 'pipe' });
+        };
+        let id;
+        if (input.intervalMs) {
+            id = scheduler.scheduleInterval(input.name, input.intervalMs, handler);
+        }
+        else {
+            id = scheduler.scheduleOnce(input.name, input.delayMs ?? 0, handler);
+        }
+        const type = input.intervalMs ? `recurring (every ${input.intervalMs}ms)` : `one-shot (delay ${input.delayMs ?? 0}ms)`;
+        return { data: `Task created: ${input.name} (${type})\nID: ${id}` };
+    },
+});
+export const taskListTool = defineTool({
+    name: 'task_list',
+    description: 'List all scheduled background tasks with their status, run count, and timing.',
+    inputSchema: z.object({}),
+    execute: async () => {
+        if (!scheduler) {
+            return { data: 'TaskScheduler is not initialized', isError: true };
+        }
+        const tasks = scheduler.list();
+        if (tasks.length === 0) {
+            return { data: 'No scheduled tasks.' };
+        }
+        const lines = tasks.map(t => {
+            const parts = [
+                `  ${t.name} [${t.status}]`,
+                `  ID: ${t.id}`,
+                `  Runs: ${t.runCount}`,
+            ];
+            if (t.lastRun)
+                parts.push(`  Last: ${t.lastRun.toISOString()}`);
+            if (t.nextRun)
+                parts.push(`  Next: ${t.nextRun.toISOString()}`);
+            if (t.error)
+                parts.push(`  Error: ${t.error}`);
+            return parts.join('\n');
+        });
+        return { data: `Scheduled tasks (${tasks.length} total, ${scheduler.activeCount} active):\n\n${lines.join('\n\n')}` };
+    },
+});
+export const taskGetTool = defineTool({
+    name: 'task_get',
+    description: 'Get details of a specific scheduled task by ID.',
+    inputSchema: z.object({
+        id: z.string().describe('The task ID returned by task_create'),
+    }),
+    execute: async (input) => {
+        if (!scheduler) {
+            return { data: 'TaskScheduler is not initialized', isError: true };
+        }
+        const task = scheduler.get(input.id);
+        if (!task) {
+            return { data: `Task not found: ${input.id}`, isError: true };
+        }
+        const info = [
+            `Name: ${task.name}`,
+            `Status: ${task.status}`,
+            `Runs: ${task.runCount}`,
+            task.lastRun ? `Last run: ${task.lastRun.toISOString()}` : null,
+            task.nextRun ? `Next run: ${task.nextRun.toISOString()}` : null,
+            task.error ? `Error: ${task.error}` : null,
+        ].filter(Boolean).join('\n');
+        return { data: info };
+    },
+});
+export const taskStopTool = defineTool({
+    name: 'task_stop',
+    description: 'Stop/cancel a scheduled task by ID.',
+    inputSchema: z.object({
+        id: z.string().describe('The task ID to cancel'),
+    }),
+    execute: async (input) => {
+        if (!scheduler) {
+            return { data: 'TaskScheduler is not initialized', isError: true };
+        }
+        const success = scheduler.cancel(input.id);
+        if (!success) {
+            return { data: `Task not found: ${input.id}`, isError: true };
+        }
+        return { data: `Task ${input.id} cancelled.` };
+    },
+});
+//# sourceMappingURL=task-tools.js.map

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

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

package/dist/src/tools/built-in/todo-tool.d.ts

@@ -0,0 +1,21 @@
+/**
+ * todo_write — session-scoped task checklist for tracking progress.
+ *
+ * The LLM can create, update, and manage a checklist of tasks
+ * within the current session, similar to Claude Code's TodoWrite tool.
+ */
+interface TodoItem {
+    id: number;
+    title: string;
+    status: 'not-started' | 'in-progress' | 'completed';
+}
+export declare function getSessionTodos(): readonly TodoItem[];
+export declare const todoWriteTool: import("../registry.js").ToolDefinition<{
+    todos: {
+        status: "completed" | "not-started" | "in-progress";
+        title: string;
+        id?: number | undefined;
+    }[];
+}>;
+export {};
+//# sourceMappingURL=todo-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"todo-tool.d.ts","sourceRoot":"","sources":["../../../../src/tools/built-in/todo-tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,UAAU,QAAQ;IAChB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,aAAa,GAAG,aAAa,GAAG,WAAW,CAAA;CACpD;AAMD,wBAAgB,eAAe,IAAI,SAAS,QAAQ,EAAE,CAErD;AAED,eAAO,MAAM,aAAa;;;;;;EAuCxB,CAAA"}

package/dist/src/tools/built-in/todo-tool.js

@@ -0,0 +1,52 @@
+/**
+ * todo_write — session-scoped task checklist for tracking progress.
+ *
+ * The LLM can create, update, and manage a checklist of tasks
+ * within the current session, similar to Claude Code's TodoWrite tool.
+ */
+import { z } from 'zod';
+import { defineTool } from '../registry.js';
+// Session-scoped todo list (shared across all tool invocations)
+const sessionTodos = [];
+let nextId = 1;
+export function getSessionTodos() {
+    return sessionTodos;
+}
+export const todoWriteTool = defineTool({
+    name: 'todo_write',
+    description: 'Manage a session-scoped task checklist. Use to track progress on multi-step tasks. Provide the complete array of all todo items (both existing and new) each time.',
+    inputSchema: z.object({
+        todos: z.array(z.object({
+            id: z.number().optional().describe('Existing todo ID (omit for new items)'),
+            title: z.string().describe('Short description of the task'),
+            status: z.enum(['not-started', 'in-progress', 'completed']).describe('Current status'),
+        })).describe('Complete list of all todo items'),
+    }),
+    execute: async (input) => {
+        // Replace the entire todo list with the provided items
+        sessionTodos.length = 0;
+        for (const item of input.todos) {
+            sessionTodos.push({
+                id: item.id ?? nextId++,
+                title: item.title,
+                status: item.status,
+            });
+            // Keep nextId ahead of any provided IDs
+            if (item.id && item.id >= nextId) {
+                nextId = item.id + 1;
+            }
+        }
+        const total = sessionTodos.length;
+        const completed = sessionTodos.filter(t => t.status === 'completed').length;
+        const inProgress = sessionTodos.filter(t => t.status === 'in-progress').length;
+        const notStarted = sessionTodos.filter(t => t.status === 'not-started').length;
+        const lines = sessionTodos.map(t => {
+            const icon = t.status === 'completed' ? '✓' : t.status === 'in-progress' ? '▶' : '○';
+            return `  ${icon} [${t.id}] ${t.title} (${t.status})`;
+        });
+        return {
+            data: `Todo list updated (${completed}/${total} done, ${inProgress} in-progress, ${notStarted} not-started):\n${lines.join('\n')}`,
+        };
+    },
+});
+//# sourceMappingURL=todo-tool.js.map

package/dist/src/tools/built-in/todo-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-tool.js","sourceRoot":"","sources":["../../../../src/tools/built-in/todo-tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAQ3C,gEAAgE;AAChE,MAAM,YAAY,GAAe,EAAE,CAAA;AACnC,IAAI,MAAM,GAAG,CAAC,CAAA;AAEd,MAAM,UAAU,eAAe;IAC7B,OAAO,YAAY,CAAA;AACrB,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC;IACtC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,oKAAoK;IACjL,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;YACtB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;YAC3E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;YAC3D,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC;SACvF,CAAC,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC;KAChD,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACvB,uDAAuD;QACvD,YAAY,CAAC,MAAM,GAAG,CAAC,CAAA;QACvB,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC/B,YAAY,CAAC,IAAI,CAAC;gBAChB,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,MAAM,EAAE;gBACvB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAA;YACF,wCAAwC;YACxC,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,IAAI,MAAM,EAAE,CAAC;gBACjC,MAAM,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAA;YACtB,CAAC;QACH,CAAC;QAED,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAA;QACjC,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM,CAAA;QAC3E,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,MAAM,CAAA;QAC9E,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,MAAM,CAAA;QAE9E,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YACjC,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;YACpF,OAAO,KAAK,IAAI,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,MAAM,GAAG,CAAA;QACvD,CAAC,CAAC,CAAA;QAEF,OAAO;YACL,IAAI,EAAE,sBAAsB,SAAS,IAAI,KAAK,UAAU,UAAU,iBAAiB,UAAU,mBAAmB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SACnI,CAAA;IACH,CAAC;CACF,CAAC,CAAA"}

package/dist/src/tools/built-in/web-search.d.ts

@@ -0,0 +1,9 @@
+/**
+ * web_search — search the web using DuckDuckGo HTML scraping (no API key required).
+ * Falls back to Brave Search API if BRAVE_SEARCH_API_KEY is set.
+ */
+export declare const webSearchTool: import("../registry.js").ToolDefinition<{
+    query: string;
+    maxResults?: number | undefined;
+}>;
+//# sourceMappingURL=web-search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../../../src/tools/built-in/web-search.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4EH,eAAO,MAAM,aAAa;;;EA8BxB,CAAA"}

package/dist/src/tools/built-in/web-search.js

@@ -0,0 +1,89 @@
+/**
+ * web_search — search the web using DuckDuckGo HTML scraping (no API key required).
+ * Falls back to Brave Search API if BRAVE_SEARCH_API_KEY is set.
+ */
+import { z } from 'zod';
+import { defineTool } from '../registry.js';
+async function searchDuckDuckGo(query, maxResults) {
+    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; cmdr-agent/1.0)',
+        },
+        signal: AbortSignal.timeout(15000),
+    });
+    if (!response.ok) {
+        throw new Error(`DuckDuckGo returned ${response.status}`);
+    }
+    const html = await response.text();
+    const results = [];
+    // Parse result entries from DuckDuckGo HTML
+    const resultPattern = /<a[^>]+class="result__a"[^>]*href="([^"]*)"[^>]*>([\s\S]*?)<\/a>[\s\S]*?<a[^>]+class="result__snippet"[^>]*>([\s\S]*?)<\/a>/g;
+    let match;
+    while ((match = resultPattern.exec(html)) !== null && results.length < maxResults) {
+        const rawUrl = match[1];
+        const title = match[2].replace(/<[^>]*>/g, '').trim();
+        const snippet = match[3].replace(/<[^>]*>/g, '').trim();
+        // DuckDuckGo wraps URLs in a redirect — extract the actual URL
+        let finalUrl = rawUrl;
+        try {
+            const parsed = new URL(rawUrl, 'https://duckduckgo.com');
+            const uddg = parsed.searchParams.get('uddg');
+            if (uddg)
+                finalUrl = decodeURIComponent(uddg);
+        }
+        catch { /* use raw */ }
+        if (title && finalUrl) {
+            results.push({ title, url: finalUrl, snippet });
+        }
+    }
+    return results;
+}
+async function searchBrave(query, maxResults, apiKey) {
+    const encoded = encodeURIComponent(query);
+    const response = await fetch(`https://api.search.brave.com/res/v1/web/search?q=${encoded}&count=${maxResults}`, {
+        headers: {
+            'Accept': 'application/json',
+            'Accept-Encoding': 'gzip',
+            'X-Subscription-Token': apiKey,
+        },
+        signal: AbortSignal.timeout(15000),
+    });
+    if (!response.ok) {
+        throw new Error(`Brave Search returned ${response.status}`);
+    }
+    const data = await response.json();
+    return (data.web?.results ?? []).slice(0, maxResults).map(r => ({
+        title: r.title,
+        url: r.url,
+        snippet: r.description,
+    }));
+}
+export const webSearchTool = defineTool({
+    name: 'web_search',
+    description: 'Search the web for information. Returns titles, URLs, and snippets of top results. Use this when you need current information not in your training data.',
+    inputSchema: z.object({
+        query: z.string().describe('The search query'),
+        maxResults: z.number().min(1).max(20).default(5).describe('Maximum number of results to return (default: 5)'),
+    }),
+    execute: async (input) => {
+        const braveKey = process.env.BRAVE_SEARCH_API_KEY;
+        const maxResults = input.maxResults ?? 5;
+        try {
+            const results = braveKey
+                ? await searchBrave(input.query, maxResults, braveKey)
+                : await searchDuckDuckGo(input.query, maxResults);
+            if (results.length === 0) {
+                return { data: `No results found for: "${input.query}"` };
+            }
+            const formatted = results.map((r, i) => `${i + 1}. ${r.title}\n   ${r.url}\n   ${r.snippet}`).join('\n\n');
+            return { data: `Search results for "${input.query}":\n\n${formatted}` };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { data: `Search failed: ${msg}`, isError: true };
+        }
+    },
+});
+//# sourceMappingURL=web-search.js.map

package/dist/src/tools/built-in/web-search.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cmdr-agent",
-  "version": "2.1.2",
+  "version": "2.3.0",
   "description": "Open-source multi-agent coding tool for your terminal. Powered by Ollama.",
   "type": "module",
   "bin": {