@iambarryking/ag 3.0.0 → 3.1.0

package/dist/tools/git.js

@@ -0,0 +1,217 @@
+import { execFileSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+function run(args, cwd) {
+    return execFileSync('git', args, { cwd, encoding: 'utf-8', timeout: 30_000 }).trim();
+}
+function tryRun(args, cwd) {
+    try {
+        return { ok: true, out: run(args, cwd) };
+    }
+    catch (e) {
+        return { ok: false, out: ((e.stdout ?? '') + (e.stderr ?? '')).trim() };
+    }
+}
+function isRepo(cwd) {
+    return existsSync(join(cwd, '.git'));
+}
+function defaultBranch(cwd) {
+    const ref = tryRun(['symbolic-ref', 'refs/remotes/origin/HEAD'], cwd);
+    if (ref.ok)
+        return ref.out.replace('refs/remotes/origin/', '');
+    const branches = tryRun(['branch', '-r'], cwd);
+    if (branches.ok) {
+        if (branches.out.includes('origin/main'))
+            return 'main';
+        if (branches.out.includes('origin/master'))
+            return 'master';
+    }
+    return 'main';
+}
+function currentBranch(cwd) {
+    const result = tryRun(['rev-parse', '--abbrev-ref', 'HEAD'], cwd);
+    if (result.ok)
+        return result.out;
+    // No commits yet — check symbolic ref for initial branch name
+    const sym = tryRun(['symbolic-ref', '--short', 'HEAD'], cwd);
+    return sym.ok ? `${sym.out} (no commits yet)` : '(no commits yet)';
+}
+function remoteUrl(cwd) {
+    const r = tryRun(['remote', 'get-url', 'origin'], cwd);
+    return r.ok ? r.out : '';
+}
+function compareUrl(cwd, branch) {
+    const remote = remoteUrl(cwd);
+    if (!remote)
+        return '';
+    const base = defaultBranch(cwd);
+    const url = remote
+        .replace(/^git@([^:]+):/, 'https://$1/')
+        .replace(/\.git$/, '');
+    return `${url}/compare/${base}...${branch}`;
+}
+// ── Action handlers ────────────────────────────────────────────────────────
+function doStatus(cwd) {
+    if (!isRepo(cwd))
+        return 'Not a git repository. Use action=init first.';
+    const lines = [];
+    lines.push(`Branch: ${currentBranch(cwd)}`);
+    const remote = remoteUrl(cwd);
+    if (remote)
+        lines.push(`Remote: ${remote}`);
+    const status = run(['status', '--porcelain'], cwd);
+    if (status) {
+        const files = status.split('\n');
+        const staged = files.filter(f => /^[MADRC]/.test(f)).length;
+        const unstaged = files.filter(f => /^.[MADRC]/.test(f)).length;
+        const untracked = files.filter(f => f.startsWith('??')).length;
+        lines.push(`Changes: ${staged} staged, ${unstaged} unstaged, ${untracked} untracked`);
+    }
+    else {
+        lines.push('Working tree clean.');
+    }
+    const ahead = tryRun(['rev-list', '@{u}..HEAD', '--count'], cwd);
+    const behind = tryRun(['rev-list', 'HEAD..@{u}', '--count'], cwd);
+    if (ahead.ok && behind.ok) {
+        lines.push(`Ahead: ${ahead.out}, Behind: ${behind.out}`);
+    }
+    const log = tryRun(['log', '--oneline', '-5'], cwd);
+    if (log.ok && log.out)
+        lines.push(`\nRecent commits:\n${log.out}`);
+    return lines.join('\n');
+}
+function doInit(cwd, remote) {
+    if (isRepo(cwd)) {
+        const branch = currentBranch(cwd);
+        const existing = remoteUrl(cwd);
+        let msg = `Already a git repo. Branch: ${branch}`;
+        if (existing)
+            msg += `, Remote: ${existing}`;
+        if (remote && remote !== existing) {
+            tryRun(['remote', 'remove', 'origin'], cwd);
+            run(['remote', 'add', 'origin', remote], cwd);
+            msg += `\nRemote updated to: ${remote}`;
+        }
+        return msg;
+    }
+    run(['init'], cwd);
+    let msg = 'Initialized git repository.';
+    if (remote) {
+        run(['remote', 'add', 'origin', remote], cwd);
+        msg += ` Remote set to: ${remote}`;
+    }
+    return msg;
+}
+function doBranch(cwd, name) {
+    if (!isRepo(cwd))
+        return 'Not a git repository. Use action=init first.';
+    const lines = [];
+    const status = run(['status', '--porcelain'], cwd);
+    if (status) {
+        lines.push(`Warning: ${status.split('\n').length} uncommitted change(s). Consider committing or stashing first.`);
+    }
+    const fetch = tryRun(['fetch', 'origin'], cwd);
+    if (fetch.ok) {
+        lines.push('Fetched latest from origin.');
+    }
+    else {
+        lines.push('Warning: Could not fetch from origin (no remote or offline). Branching from local state.');
+    }
+    const base = defaultBranch(cwd);
+    if (fetch.ok) {
+        tryRun(['checkout', base], cwd);
+        tryRun(['reset', '--hard', `origin/${base}`], cwd);
+        lines.push(`Updated local ${base} to origin/${base}.`);
+    }
+    const result = tryRun(['checkout', '-b', name], cwd);
+    if (result.ok) {
+        lines.push(`Created and switched to branch: ${name}`);
+    }
+    else {
+        const sw = tryRun(['checkout', name], cwd);
+        lines.push(sw.ok
+            ? `Branch ${name} already exists. Switched to it.`
+            : `Error creating branch: ${result.out}`);
+    }
+    return lines.join('\n');
+}
+function doCommit(cwd, message, files) {
+    if (!isRepo(cwd))
+        return 'Not a git repository. Use action=init first.';
+    if (files && files.length > 0) {
+        run(['add', ...files], cwd);
+    }
+    else {
+        run(['add', '-A'], cwd);
+    }
+    const staged = tryRun(['diff', '--cached', '--stat'], cwd);
+    if (!staged.out)
+        return 'Nothing to commit. Working tree clean.';
+    const result = tryRun(['commit', '-m', message], cwd);
+    return result.ok ? `Committed: ${message}\n${result.out}` : `Commit failed: ${result.out}`;
+}
+function doPush(cwd, force) {
+    if (!isRepo(cwd))
+        return 'Not a git repository. Use action=init first.';
+    const branch = currentBranch(cwd);
+    const base = defaultBranch(cwd);
+    if (branch === base) {
+        return `You're on ${base}. Create a feature branch first with action=branch.`;
+    }
+    const args = ['push', '-u', 'origin', branch];
+    if (force)
+        args.splice(1, 0, '--force-with-lease');
+    const result = tryRun(args, cwd);
+    const lines = [];
+    if (result.ok || result.out.includes('->')) {
+        lines.push(`Pushed ${branch} to origin.`);
+    }
+    else {
+        return `Push failed: ${result.out}`;
+    }
+    const url = compareUrl(cwd, branch);
+    if (url)
+        lines.push(`\nCreate PR: ${url}`);
+    return lines.join('\n');
+}
+// ── Exported tool ──────────────────────────────────────────────────────────
+export function gitTool(cwd) {
+    return {
+        type: 'function',
+        function: {
+            name: 'git',
+            description: 'Git operations. Actions: status (branch, changes, recent commits), init (initialize repo), branch (create from latest main), commit (stage + commit), push (push + PR compare URL).',
+            parameters: {
+                type: 'object',
+                properties: {
+                    action: { type: 'string', enum: ['status', 'init', 'branch', 'commit', 'push'], description: 'The git operation to perform.' },
+                    name: { type: 'string', description: 'Branch name (for action=branch, e.g. "feature/add-auth").' },
+                    message: { type: 'string', description: 'Commit message (for action=commit).' },
+                    files: { type: 'array', items: { type: 'string' }, description: 'Specific files to stage (for action=commit). Omit to stage all.' },
+                    remote: { type: 'string', description: 'Remote URL (for action=init, e.g. "git@github.com:user/repo.git").' },
+                    force: { type: 'boolean', description: 'Force push with lease (for action=push). Default: false.' }
+                },
+                required: ['action']
+            }
+        },
+        execute: ({ action, name, message, files, remote, force }) => {
+            switch (action) {
+                case 'status': return doStatus(cwd);
+                case 'init': return doInit(cwd, remote);
+                case 'branch': {
+                    if (!name)
+                        return 'Error: name is required for action=branch.';
+                    return doBranch(cwd, name);
+                }
+                case 'commit': {
+                    if (!message)
+                        return 'Error: message is required for action=commit.';
+                    return doCommit(cwd, message, files);
+                }
+                case 'push': return doPush(cwd, force);
+                default: return `Unknown action "${action}". Use: status, init, branch, commit, push.`;
+            }
+        }
+    };
+}
+//# sourceMappingURL=git.js.map

package/dist/tools/git.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/tools/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAGxC,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAwB5C"}
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/tools/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAGxC,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CA8B5C"}

package/dist/tools/memory.js

@@ -3,24 +3,30 @@ export function memoryTool(cwd) {
     return {
         type: 'function',
         function: {
-            name: 'save_memory',
-            description: 'Save a fact, decision, or pattern to persistent memory. Use "global" for things that apply everywhere (preferences, patterns). Use "project" for things specific to the current codebase.',
+            name: 'memory',
+            description: 'Memory operations. Actions: save (persist a fact, decision, or pattern for future sessions).',
             parameters: {
                 type: 'object',
                 properties: {
-                    tier: { type: 'string', enum: ['global', 'project'], description: 'Where to store: "global" (all projects) or "project" (this codebase only)' },
-                    content: { type: 'string', description: 'The fact, decision, or pattern to remember' }
+                    action: { type: 'string', enum: ['save'], description: 'The memory operation to perform.' },
+                    tier: { type: 'string', enum: ['global', 'project'], description: '"global" for preferences, coding style, patterns that apply everywhere. "project" for architecture decisions, current ticket, PR templates, gotchas specific to this codebase.' },
+                    content: { type: 'string', description: 'The fact, decision, or pattern to remember.' }
                 },
-                required: ['tier', 'content']
+                required: ['action', 'tier', 'content']
             }
         },
-        execute: ({ tier, content }) => {
-            if (tier === 'global') {
-                appendGlobalMemory(content, cwd);
-                return `Saved to global memory.`;
+        execute: ({ action, tier, content }) => {
+            switch (action) {
+                case 'save': {
+                    if (tier === 'global') {
+                        appendGlobalMemory(content, cwd);
+                        return 'Saved to global memory.';
+                    }
+                    appendProjectMemory(content, cwd);
+                    return 'Saved to project memory.';
+                }
+                default: return `Unknown action "${action}". Use: save.`;
             }
-            appendProjectMemory(content, cwd);
-            return `Saved to project memory.`;
         }
     };
 }

package/dist/tools/memory.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/tools/memory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,2LAA2L;YACxM,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,WAAW,EAAE,2EAA2E,EAAE;oBAC/I,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4CAA4C,EAAE;iBACvF;gBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;aAC9B;SACF;QACD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAqC,EAAU,EAAE;YACxE,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACtB,kBAAkB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;gBACjC,OAAO,yBAAyB,CAAC;YACnC,CAAC;YACD,mBAAmB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAClC,OAAO,0BAA0B,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/tools/memory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,8FAA8F;YAC3G,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,kCAAkC,EAAE;oBAC3F,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,WAAW,EAAE,gLAAgL,EAAE;oBACpP,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6CAA6C,EAAE;iBACxF;gBACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC;aACxC;SACF;QACD,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAqD,EAAU,EAAE;YAChG,QAAQ,MAAM,EAAE,CAAC;gBACf,KAAK,MAAM,CAAC,CAAC,CAAC;oBACZ,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;wBACtB,kBAAkB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;wBACjC,OAAO,yBAAyB,CAAC;oBACnC,CAAC;oBACD,mBAAmB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;oBAClC,OAAO,0BAA0B,CAAC;gBACpC,CAAC;gBACD,OAAO,CAAC,CAAC,OAAO,mBAAmB,MAAM,eAAe,CAAC;YAC3D,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/plan.d.ts

@@ -1,4 +1,3 @@
 import { Tool } from '../core/types.js';
 export declare function planTool(cwd: string): Tool;
-export declare function listPlansTool(cwd: string): Tool;
 //# sourceMappingURL=plan.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/tools/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAGxC,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAoB1C;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAwB/C"}
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/tools/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAGxC,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAsC1C"}

package/dist/tools/plan.js

@@ -3,46 +3,41 @@ export function planTool(cwd) {
     return {
         type: 'function',
         function: {
-            name: 'save_plan',
-            description: 'Save a new plan. Each plan is timestamped and kept. The most recent plan is automatically loaded as context. Use this when asked to plan something or to break down a task.',
+            name: 'plan',
+            description: 'Manage task plans. Save a new plan, list all plans, or read a specific plan by name. Plans are timestamped and the latest is automatically loaded as context.',
             parameters: {
                 type: 'object',
                 properties: {
-                    content: { type: 'string', description: 'The plan content' },
-                    name: { type: 'string', description: 'Optional short name for the plan (e.g. "refactor-cli", "add-auth")' }
+                    action: { type: 'string', enum: ['save', 'list', 'read'], description: '"save" to create a new plan, "list" to see all plans, "read" to view a specific plan.' },
+                    content: { type: 'string', description: 'Plan content (required for action=save).' },
+                    name: { type: 'string', description: 'Plan name for save (e.g. "refactor-cli") or read (e.g. "2026-04-13T12-31-22-refactor-cli").' }
                 },
-                required: ['content']
+                required: ['action']
             }
         },
-        execute: ({ content, name }) => {
-            savePlan(content, name, cwd);
-            return `Plan saved.${name ? ` (${name})` : ''}`;
-        }
-    };
-}
-export function listPlansTool(cwd) {
-    return {
-        type: 'function',
-        function: {
-            name: 'list_plans',
-            description: 'List all saved plans for this project, or read a specific plan by name. Use this to review previous plans.',
-            parameters: {
-                type: 'object',
-                properties: {
-                    name: { type: 'string', description: 'Optional: name of a specific plan to read. Omit to list all plans.' }
-                },
-                required: []
-            }
-        },
-        execute: ({ name }) => {
-            if (name) {
-                const content = loadPlanByName(name, cwd);
-                return content || `No plan found with name "${name}".`;
+        execute: ({ action, content, name }) => {
+            switch (action) {
+                case 'save': {
+                    if (!content)
+                        return 'Error: content is required for action=save.';
+                    savePlan(content, name, cwd);
+                    return `Plan saved.${name ? ` (${name})` : ''}`;
+                }
+                case 'list': {
+                    const plans = listPlans(cwd);
+                    if (plans.length === 0)
+                        return 'No plans saved yet.';
+                    return plans.map(p => p.name).join('\n');
+                }
+                case 'read': {
+                    if (!name)
+                        return 'Error: name is required for action=read. Use action=list to see available plans.';
+                    const result = loadPlanByName(name, cwd);
+                    return result || `No plan found with name "${name}".`;
+                }
+                default:
+                    return `Unknown action "${action}". Use "save", "list", or "read".`;
             }
-            const plans = listPlans(cwd);
-            if (plans.length === 0)
-                return 'No plans saved yet.';
-            return plans.map(p => p.name).join('\n');
         }
     };
 }

package/dist/tools/plan.js.map

@@ -1 +1 @@
-{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/tools/plan.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1E,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,6KAA6K;YAC1L,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;oBAC5D,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oEAAoE,EAAE;iBAC5G;gBACD,QAAQ,EAAE,CAAC,SAAS,CAAC;aACtB;SACF;QACD,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAsC,EAAU,EAAE;YACzE,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;YAC7B,OAAO,cAAc,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAClD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,4GAA4G;YACzH,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oEAAoE,EAAE;iBAC5G;gBACD,QAAQ,EAAE,EAAE;aACb;SACF;QACD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAqB,EAAU,EAAE;YAC/C,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAC1C,OAAO,OAAO,IAAI,4BAA4B,IAAI,IAAI,CAAC;YACzD,CAAC;YACD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,qBAAqB,CAAC;YACrD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/tools/plan.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1E,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,+JAA+J;YAC5K,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,uFAAuF,EAAE;oBAChK,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE;oBACpF,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6FAA6F,EAAE;iBACrI;gBACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;aACrB;SACF;QACD,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAuD,EAAU,EAAE;YAClG,QAAQ,MAAM,EAAE,CAAC;gBACf,KAAK,MAAM,CAAC,CAAC,CAAC;oBACZ,IAAI,CAAC,OAAO;wBAAE,OAAO,6CAA6C,CAAC;oBACnE,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;oBAC7B,OAAO,cAAc,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBAClD,CAAC;gBACD,KAAK,MAAM,CAAC,CAAC,CAAC;oBACZ,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;oBAC7B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;wBAAE,OAAO,qBAAqB,CAAC;oBACrD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC3C,CAAC;gBACD,KAAK,MAAM,CAAC,CAAC,CAAC;oBACZ,IAAI,CAAC,IAAI;wBAAE,OAAO,kFAAkF,CAAC;oBACrG,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;oBACzC,OAAO,MAAM,IAAI,4BAA4B,IAAI,IAAI,CAAC;gBACxD,CAAC;gBACD;oBACE,OAAO,mBAAmB,MAAM,mCAAmC,CAAC;YACxE,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/skill.d.ts

@@ -0,0 +1,6 @@
+import { Tool } from '../core/types.js';
+export interface SkillHost {
+    activateSkill(name: string): Promise<string>;
+}
+export declare function skillTool(host: SkillHost): Tool;
+//# sourceMappingURL=skill.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/tools/skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,MAAM,WAAW,SAAS;IACxB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9C;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAkB/C"}

package/dist/tools/skill.js

@@ -0,0 +1,20 @@
+export function skillTool(host) {
+    return {
+        type: 'function',
+        function: {
+            name: 'skill',
+            description: 'Activate a skill by name to load its full instructions into context. Check <available-skills> in your system prompt for what is available.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Skill name to activate (from the available-skills catalog).' }
+                },
+                required: ['name']
+            }
+        },
+        execute: async ({ name }) => {
+            return host.activateSkill(name);
+        }
+    };
+}
+//# sourceMappingURL=skill.js.map

package/dist/tools/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/tools/skill.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,SAAS,CAAC,IAAe;IACvC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,4IAA4I;YACzJ,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6DAA6D,EAAE;iBACrG;gBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;aACnB;SACF;QACD,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAoB,EAAmB,EAAE;YAC7D,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/web.d.ts

@@ -0,0 +1,3 @@
+import { Tool } from '../core/types.js';
+export declare function webTool(): Tool;
+//# sourceMappingURL=web.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/tools/web.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAuJxC,wBAAgB,OAAO,IAAI,IAAI,CAiC9B"}

package/dist/tools/web.js

@@ -0,0 +1,158 @@
+import { createInterface } from 'node:readline';
+import { loadConfig, saveConfig } from '../core/config.js';
+// ── HTML stripping (native fallback when Jina is unavailable) ─────────────
+function stripHtml(html) {
+    let text = html;
+    // Remove script, style, nav, header, footer, aside blocks
+    text = text.replace(/<(script|style|nav|header|footer|aside)\b[^>]*>[\s\S]*?<\/\1>/gi, '');
+    // Try to extract article or main content
+    const article = text.match(/<(article|main)\b[^>]*>([\s\S]*?)<\/\1>/i);
+    if (article)
+        text = article[2];
+    // Convert headings to markdown-style
+    text = text.replace(/<h([1-6])\b[^>]*>([\s\S]*?)<\/h\1>/gi, (_m, _l, content) => `\n## ${content.trim()}\n`);
+    // Convert links to text (url) format
+    text = text.replace(/<a\b[^>]*href="([^"]*)"[^>]*>([\s\S]*?)<\/a>/gi, (_m, href, content) => {
+        const label = content.replace(/<[^>]+>/g, '').trim();
+        return href && !href.startsWith('#') ? `${label} (${href})` : label;
+    });
+    // Convert block elements to newlines
+    text = text.replace(/<\/?(p|div|li|tr|br)\b[^>]*\/?>/gi, '\n');
+    // Strip all remaining tags
+    text = text.replace(/<[^>]+>/g, '');
+    // Decode common HTML entities
+    text = text
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&nbsp;/g, ' ');
+    // Collapse whitespace
+    text = text.replace(/[ \t]+/g, ' ');
+    text = text.replace(/\n{3,}/g, '\n\n');
+    return text.trim();
+}
+// ── Action handlers ───────────────────────────────────────────────────────
+async function doFetch(url, raw) {
+    if (!/^https?:\/\//i.test(url)) {
+        return 'Error: URL must start with http:// or https://';
+    }
+    const fetchOpts = { signal: AbortSignal.timeout(15_000) };
+    // Try Jina Reader first (returns clean markdown, handles JS-rendered pages)
+    if (!raw) {
+        try {
+            const res = await fetch(`https://r.jina.ai/${url}`, {
+                ...fetchOpts,
+                headers: { 'Accept': 'text/markdown' }
+            });
+            if (res.ok) {
+                const text = await res.text();
+                if (text.trim())
+                    return text;
+            }
+        }
+        catch {
+            // Fall through to native fetch
+        }
+    }
+    // Native fetch fallback
+    try {
+        const res = await fetch(url, fetchOpts);
+        if (!res.ok)
+            return `Fetch error: HTTP ${res.status}`;
+        const contentType = res.headers.get('content-type') || '';
+        if (contentType.includes('application/json')) {
+            const json = await res.json();
+            return JSON.stringify(json, null, 2);
+        }
+        const text = await res.text();
+        if (contentType.includes('text/html')) {
+            return stripHtml(text);
+        }
+        return text;
+    }
+    catch (error) {
+        return `Fetch failed: ${error.message}`;
+    }
+}
+async function ensureTavilyKey() {
+    const existing = process.env.TAVILY_API_KEY || loadConfig().tavilyApiKey;
+    if (existing)
+        return existing;
+    // Interactive prompt if TTY
+    if (process.stdin.isTTY) {
+        const C = await import('../core/colors.js').then(m => m.C);
+        console.error(`\n${C.bold}Web search requires a Tavily API key${C.reset}`);
+        console.error(`Sign up free (no credit card): ${C.cyan}https://app.tavily.com${C.reset}\n`);
+        const rl = createInterface({ input: process.stdin, output: process.stderr });
+        const key = await new Promise(resolve => rl.question(`${C.yellow}Enter your Tavily API key:${C.reset} `, resolve));
+        rl.close();
+        const trimmed = key.trim();
+        if (!trimmed)
+            return null;
+        saveConfig({ tavilyApiKey: trimmed });
+        console.error(`${C.green}Key saved to config.${C.reset}\n`);
+        return trimmed;
+    }
+    return null;
+}
+async function doSearch(query) {
+    const key = await ensureTavilyKey();
+    if (!key) {
+        return 'Error: Tavily API key not configured. Sign up free at https://tavily.com (no credit card needed), then set TAVILY_API_KEY env var or run /config set tavilyApiKey <key>';
+    }
+    try {
+        const res = await fetch('https://api.tavily.com/search', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            signal: AbortSignal.timeout(15_000),
+            body: JSON.stringify({ api_key: key, query, max_results: 5 })
+        });
+        if (!res.ok)
+            return `Search error: HTTP ${res.status}`;
+        const data = await res.json();
+        if (!data.results?.length)
+            return 'No results found.';
+        return data.results.map((r, i) => `${i + 1}. ${r.title || '(untitled)'}\n   ${r.url || ''}\n   ${r.content || ''}`).join('\n\n');
+    }
+    catch (error) {
+        return `Search failed: ${error.message}`;
+    }
+}
+// ── Exported tool ─────────────────────────────────────────────────────────
+export function webTool() {
+    return {
+        type: 'function',
+        function: {
+            name: 'web',
+            description: 'Web operations. Actions: fetch (retrieve readable content from a URL), search (search the web for current information via Tavily).',
+            parameters: {
+                type: 'object',
+                properties: {
+                    action: { type: 'string', enum: ['fetch', 'search'], description: 'The web operation to perform.' },
+                    url: { type: 'string', description: 'URL to fetch (for action=fetch).' },
+                    query: { type: 'string', description: 'Search query (for action=search).' },
+                    raw: { type: 'boolean', description: 'If true, use native fetch + HTML stripping instead of Jina Reader (for action=fetch). Default: false.' }
+                },
+                required: ['action']
+            }
+        },
+        execute: async ({ action, url, query, raw }) => {
+            switch (action) {
+                case 'fetch': {
+                    if (!url)
+                        return 'Error: url is required for action=fetch.';
+                    return doFetch(url, raw);
+                }
+                case 'search': {
+                    if (!query)
+                        return 'Error: query is required for action=search.';
+                    return doSearch(query);
+                }
+                default: return `Unknown action "${action}". Use: fetch, search.`;
+            }
+        }
+    };
+}
+//# sourceMappingURL=web.js.map

package/dist/tools/web.js.map

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