@gopherhole/cli 0.3.1 → 0.4.1

package/README.md

@@ -6,17 +6,17 @@ Connect AI agents to the world.
 
 ```bash
 # Use with npx (no install required)
-npx gopherhole init
+npx @gopherhole/cli init
 
-# Or install globally
-npm install -g gopherhole
+# Or install globally (exposes the `gopherhole` command)
+npm install -g @gopherhole/cli
 ```
 
 ## Quick Start
 
 ```bash
 # Initialize a new agent in your project
-npx gopherhole init
+npx @gopherhole/cli init
 
 # This will:
 # 1. Log you in (or create an account)
@@ -64,12 +64,20 @@ The CLI stores configuration in:
 - **Linux**: `~/.config/gopherhole-nodejs/`
 - **Windows**: `%APPDATA%/gopherhole-nodejs/`
 
+## Related Packages
+
+- **[@gopherhole/mcp](https://www.npmjs.com/package/@gopherhole/mcp)** — MCP
+  server for Claude Code, Cursor, Windsurf, and other MCP-compatible IDEs.
+  Use this to call GopherHole agents from your IDE without writing any code.
+- **[@gopherhole/sdk](https://www.npmjs.com/package/@gopherhole/sdk)** —
+  TypeScript SDK for building agents that send/receive A2A messages,
+  discover other agents, and use shared workspaces.
+
 ## Links
 
 - Website: https://gopherhole.ai
 - Dashboard: https://gopherhole.ai/dashboard
 - Docs: https://docs.gopherhole.ai
-- GitHub: https://github.com/gopherhole
 
 ## License
 

package/dist/index.js

@@ -20,7 +20,7 @@ const brand = {
     greenDark: chalk_1.default.hex('#16a34a'), // gopher-600 - emphasis
 };
 // Version
-const VERSION = '0.3.0';
+const VERSION = '0.4.1';
 // ========== API KEY RESOLUTION ==========
 // Precedence: --api-key flag > GOPHERHOLE_API_KEY env var > .env file in cwd
 async function resolveApiKey(flagValue) {
@@ -1274,6 +1274,183 @@ ${chalk_1.default.bold('Examples:')}
         process.exit(1);
     }
 });
+// ========== TASK COMMANDS ==========
+const taskCmd = program
+    .command('task')
+    .description(`Manage tasks (queued messages, pending responses)
+
+${chalk_1.default.bold('Examples:')}
+  $ gopherhole task status task-abc123
+  $ gopherhole task pending
+  $ gopherhole task cancel task-abc123
+  $ gopherhole task cancel-all
+`);
+taskCmd
+    .command('status <taskId>')
+    .description('Check the status of a task and get the response if completed')
+    .action(async (taskId) => {
+    const sessionId = config.get('sessionId');
+    if (!sessionId) {
+        console.log(chalk_1.default.yellow('Not logged in. Run: gopherhole login'));
+        process.exit(1);
+    }
+    const spinner = (0, ora_1.default)(`Checking task ${taskId}...`).start();
+    try {
+        const res = await fetch(`${API_URL}/../a2a`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', 'X-Session-ID': sessionId },
+            body: JSON.stringify({ jsonrpc: '2.0', method: 'GetTask', params: { id: taskId }, id: 1 }),
+        });
+        const data = await res.json();
+        if (data.error)
+            throw new Error(data.error.message || 'Failed');
+        const task = data.result;
+        const state = task?.status?.state || 'unknown';
+        spinner.stop();
+        console.log(`\n${chalk_1.default.bold('Task:')} ${taskId}`);
+        console.log(`${chalk_1.default.bold('State:')} ${stateColor(state)(state)}`);
+        if (task?.status?.timestamp)
+            console.log(`${chalk_1.default.bold('Time:')}  ${task.status.timestamp}`);
+        if (state === 'completed' && task?.artifacts?.length) {
+            const texts = task.artifacts.flatMap((a) => a.parts?.filter((p) => p.kind === 'text').map((p) => p.text) || []);
+            if (texts.length)
+                console.log(`\n${chalk_1.default.bold('Response:')}\n${texts.join('\n')}`);
+        }
+        else if (state === 'submitted') {
+            console.log(chalk_1.default.yellow('\n⏳ Queued — recipient hasn\'t come online yet.'));
+        }
+        else if (state === 'working') {
+            console.log(chalk_1.default.blue('\n⚙️  Delivered — waiting for response.'));
+        }
+        else if (state === 'failed') {
+            const msg = task?.status?.message;
+            console.log(chalk_1.default.red(`\n❌ ${typeof msg === 'string' ? msg : 'Unknown error'}`));
+        }
+    }
+    catch (err) {
+        spinner.fail(chalk_1.default.red(err.message));
+        process.exit(1);
+    }
+});
+taskCmd
+    .command('pending')
+    .description('List all queued/pending tasks')
+    .option('-l, --limit <n>', 'Max tasks to show', parseInt, 20)
+    .action(async (opts) => {
+    const sessionId = config.get('sessionId');
+    if (!sessionId) {
+        console.log(chalk_1.default.yellow('Not logged in. Run: gopherhole login'));
+        process.exit(1);
+    }
+    const spinner = (0, ora_1.default)('Fetching pending tasks...').start();
+    try {
+        const res = await fetch(`${API_URL}/../a2a`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', 'X-Session-ID': sessionId },
+            body: JSON.stringify({ jsonrpc: '2.0', method: 'ListTasks', params: { status: 'submitted', pageSize: opts.limit || 20 }, id: 1 }),
+        });
+        const data = await res.json();
+        if (data.error)
+            throw new Error(data.error.message || 'Failed');
+        const tasks = data.result?.tasks || [];
+        spinner.stop();
+        if (tasks.length === 0) {
+            console.log(chalk_1.default.green('✅ No pending tasks.'));
+            return;
+        }
+        console.log(chalk_1.default.bold(`\n${tasks.length} pending task(s):\n`));
+        for (const t of tasks) {
+            const age = Date.now() - new Date(t.status?.timestamp || 0).getTime();
+            const ageMins = Math.round(age / 60000);
+            console.log(`  ${chalk_1.default.gray(t.id)} → ${t.serverAgentId || 'unknown'} ${chalk_1.default.yellow(`(${ageMins}m ago)`)}`);
+        }
+    }
+    catch (err) {
+        spinner.fail(chalk_1.default.red(err.message));
+        process.exit(1);
+    }
+});
+taskCmd
+    .command('cancel <taskId>')
+    .description('Cancel a specific task and purge its queued messages')
+    .action(async (taskId) => {
+    const sessionId = config.get('sessionId');
+    if (!sessionId) {
+        console.log(chalk_1.default.yellow('Not logged in. Run: gopherhole login'));
+        process.exit(1);
+    }
+    const spinner = (0, ora_1.default)(`Canceling task ${taskId}...`).start();
+    try {
+        const res = await fetch(`${API_URL}/../a2a`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', 'X-Session-ID': sessionId },
+            body: JSON.stringify({ jsonrpc: '2.0', method: 'CancelTask', params: { id: taskId }, id: 1 }),
+        });
+        const data = await res.json();
+        if (data.error)
+            throw new Error(data.error.message || 'Failed');
+        spinner.succeed(`Task ${taskId} canceled. Queued messages purged.`);
+    }
+    catch (err) {
+        spinner.fail(chalk_1.default.red(err.message));
+        process.exit(1);
+    }
+});
+taskCmd
+    .command('cancel-all')
+    .description('Cancel ALL pending tasks and purge all queued messages')
+    .action(async () => {
+    const sessionId = config.get('sessionId');
+    if (!sessionId) {
+        console.log(chalk_1.default.yellow('Not logged in. Run: gopherhole login'));
+        process.exit(1);
+    }
+    const spinner = (0, ora_1.default)('Fetching pending tasks...').start();
+    try {
+        const res = await fetch(`${API_URL}/../a2a`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', 'X-Session-ID': sessionId },
+            body: JSON.stringify({ jsonrpc: '2.0', method: 'ListTasks', params: { status: 'submitted', pageSize: 100 }, id: 1 }),
+        });
+        const data = await res.json();
+        if (data.error)
+            throw new Error(data.error.message || 'Failed');
+        const tasks = data.result?.tasks || [];
+        if (tasks.length === 0) {
+            spinner.succeed('No pending tasks to cancel.');
+            return;
+        }
+        spinner.text = `Canceling ${tasks.length} task(s)...`;
+        let canceled = 0;
+        for (const t of tasks) {
+            try {
+                await fetch(`${API_URL}/../a2a`, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json', 'X-Session-ID': sessionId },
+                    body: JSON.stringify({ jsonrpc: '2.0', method: 'CancelTask', params: { id: t.id }, id: 1 }),
+                });
+                canceled++;
+            }
+            catch { /* skip */ }
+        }
+        spinner.succeed(`Canceled ${canceled}/${tasks.length} task(s). Queued messages purged.`);
+    }
+    catch (err) {
+        spinner.fail(chalk_1.default.red(err.message));
+        process.exit(1);
+    }
+});
+function stateColor(state) {
+    switch (state) {
+        case 'completed': return chalk_1.default.green;
+        case 'submitted': return chalk_1.default.yellow;
+        case 'working': return chalk_1.default.blue;
+        case 'failed':
+        case 'canceled':
+        case 'rejected': return chalk_1.default.red;
+        default: return chalk_1.default.gray;
+    }
+}
 // ========== DISCOVER COMMANDS ==========
 const discover = program
     .command('discover')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gopherhole/cli",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "description": "GopherHole CLI - Connect AI agents to the world",
   "main": "dist/index.js",
   "bin": {
@@ -22,7 +22,7 @@
   "author": "GopherHole",
   "license": "MIT",
   "dependencies": {
-    "@gopherhole/sdk": "^0.6.0",
+    "@gopherhole/sdk": "^0.7.2",
     "chalk": "^5.3.0",
     "commander": "^12.0.0",
     "conf": "^12.0.0",

package/src/index.ts

@@ -20,7 +20,7 @@ const brand = {
 };
 
 // Version
-const VERSION = '0.3.0';
+const VERSION = '0.4.1';
 
 // ========== API KEY RESOLUTION ==========
 // Precedence: --api-key flag > GOPHERHOLE_API_KEY env var > .env file in cwd
@@ -1412,6 +1412,174 @@ ${chalk.bold('Examples:')}
     }
   });
 
+// ========== TASK COMMANDS ==========
+
+const taskCmd = program
+  .command('task')
+  .description(`Manage tasks (queued messages, pending responses)
+
+${chalk.bold('Examples:')}
+  $ gopherhole task status task-abc123
+  $ gopherhole task pending
+  $ gopherhole task cancel task-abc123
+  $ gopherhole task cancel-all
+`);
+
+taskCmd
+  .command('status <taskId>')
+  .description('Check the status of a task and get the response if completed')
+  .action(async (taskId) => {
+    const sessionId = config.get('sessionId') as string;
+    if (!sessionId) { console.log(chalk.yellow('Not logged in. Run: gopherhole login')); process.exit(1); }
+
+    const spinner = ora(`Checking task ${taskId}...`).start();
+    try {
+      const res = await fetch(`${API_URL}/../a2a`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', 'X-Session-ID': sessionId },
+        body: JSON.stringify({ jsonrpc: '2.0', method: 'GetTask', params: { id: taskId }, id: 1 }),
+      });
+      const data = await res.json() as any;
+      if (data.error) throw new Error(data.error.message || 'Failed');
+
+      const task = data.result;
+      const state = task?.status?.state || 'unknown';
+      spinner.stop();
+
+      console.log(`\n${chalk.bold('Task:')} ${taskId}`);
+      console.log(`${chalk.bold('State:')} ${stateColor(state)(state)}`);
+      if (task?.status?.timestamp) console.log(`${chalk.bold('Time:')}  ${task.status.timestamp}`);
+
+      if (state === 'completed' && task?.artifacts?.length) {
+        const texts = task.artifacts.flatMap((a: any) => a.parts?.filter((p: any) => p.kind === 'text').map((p: any) => p.text) || []);
+        if (texts.length) console.log(`\n${chalk.bold('Response:')}\n${texts.join('\n')}`);
+      } else if (state === 'submitted') {
+        console.log(chalk.yellow('\n⏳ Queued — recipient hasn\'t come online yet.'));
+      } else if (state === 'working') {
+        console.log(chalk.blue('\n⚙️  Delivered — waiting for response.'));
+      } else if (state === 'failed') {
+        const msg = task?.status?.message;
+        console.log(chalk.red(`\n❌ ${typeof msg === 'string' ? msg : 'Unknown error'}`));
+      }
+    } catch (err) {
+      spinner.fail(chalk.red((err as Error).message));
+      process.exit(1);
+    }
+  });
+
+taskCmd
+  .command('pending')
+  .description('List all queued/pending tasks')
+  .option('-l, --limit <n>', 'Max tasks to show', parseInt, 20)
+  .action(async (opts) => {
+    const sessionId = config.get('sessionId') as string;
+    if (!sessionId) { console.log(chalk.yellow('Not logged in. Run: gopherhole login')); process.exit(1); }
+
+    const spinner = ora('Fetching pending tasks...').start();
+    try {
+      const res = await fetch(`${API_URL}/../a2a`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', 'X-Session-ID': sessionId },
+        body: JSON.stringify({ jsonrpc: '2.0', method: 'ListTasks', params: { status: 'submitted', pageSize: opts.limit || 20 }, id: 1 }),
+      });
+      const data = await res.json() as any;
+      if (data.error) throw new Error(data.error.message || 'Failed');
+
+      const tasks = data.result?.tasks || [];
+      spinner.stop();
+
+      if (tasks.length === 0) {
+        console.log(chalk.green('✅ No pending tasks.'));
+        return;
+      }
+
+      console.log(chalk.bold(`\n${tasks.length} pending task(s):\n`));
+      for (const t of tasks) {
+        const age = Date.now() - new Date(t.status?.timestamp || 0).getTime();
+        const ageMins = Math.round(age / 60000);
+        console.log(`  ${chalk.gray(t.id)} → ${t.serverAgentId || 'unknown'} ${chalk.yellow(`(${ageMins}m ago)`)}`);
+      }
+    } catch (err) {
+      spinner.fail(chalk.red((err as Error).message));
+      process.exit(1);
+    }
+  });
+
+taskCmd
+  .command('cancel <taskId>')
+  .description('Cancel a specific task and purge its queued messages')
+  .action(async (taskId) => {
+    const sessionId = config.get('sessionId') as string;
+    if (!sessionId) { console.log(chalk.yellow('Not logged in. Run: gopherhole login')); process.exit(1); }
+
+    const spinner = ora(`Canceling task ${taskId}...`).start();
+    try {
+      const res = await fetch(`${API_URL}/../a2a`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', 'X-Session-ID': sessionId },
+        body: JSON.stringify({ jsonrpc: '2.0', method: 'CancelTask', params: { id: taskId }, id: 1 }),
+      });
+      const data = await res.json() as any;
+      if (data.error) throw new Error(data.error.message || 'Failed');
+      spinner.succeed(`Task ${taskId} canceled. Queued messages purged.`);
+    } catch (err) {
+      spinner.fail(chalk.red((err as Error).message));
+      process.exit(1);
+    }
+  });
+
+taskCmd
+  .command('cancel-all')
+  .description('Cancel ALL pending tasks and purge all queued messages')
+  .action(async () => {
+    const sessionId = config.get('sessionId') as string;
+    if (!sessionId) { console.log(chalk.yellow('Not logged in. Run: gopherhole login')); process.exit(1); }
+
+    const spinner = ora('Fetching pending tasks...').start();
+    try {
+      const res = await fetch(`${API_URL}/../a2a`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', 'X-Session-ID': sessionId },
+        body: JSON.stringify({ jsonrpc: '2.0', method: 'ListTasks', params: { status: 'submitted', pageSize: 100 }, id: 1 }),
+      });
+      const data = await res.json() as any;
+      if (data.error) throw new Error(data.error.message || 'Failed');
+
+      const tasks = data.result?.tasks || [];
+      if (tasks.length === 0) {
+        spinner.succeed('No pending tasks to cancel.');
+        return;
+      }
+
+      spinner.text = `Canceling ${tasks.length} task(s)...`;
+      let canceled = 0;
+      for (const t of tasks) {
+        try {
+          await fetch(`${API_URL}/../a2a`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', 'X-Session-ID': sessionId },
+            body: JSON.stringify({ jsonrpc: '2.0', method: 'CancelTask', params: { id: t.id }, id: 1 }),
+          });
+          canceled++;
+        } catch { /* skip */ }
+      }
+      spinner.succeed(`Canceled ${canceled}/${tasks.length} task(s). Queued messages purged.`);
+    } catch (err) {
+      spinner.fail(chalk.red((err as Error).message));
+      process.exit(1);
+    }
+  });
+
+function stateColor(state: string) {
+  switch (state) {
+    case 'completed': return chalk.green;
+    case 'submitted': return chalk.yellow;
+    case 'working': return chalk.blue;
+    case 'failed': case 'canceled': case 'rejected': return chalk.red;
+    default: return chalk.gray;
+  }
+}
+
 // ========== DISCOVER COMMANDS ==========
 
 const discover = program