@gopherhole/cli 0.3.0 → 0.4.0

package/dist/index.js

@@ -20,7 +20,7 @@ const brand = {
     greenDark: chalk_1.default.hex('#16a34a'), // gopher-600 - emphasis
 };
 // Version
-const VERSION = '0.2.0';
+const VERSION = '0.3.0';
 // ========== API KEY RESOLUTION ==========
 // Precedence: --api-key flag > GOPHERHOLE_API_KEY env var > .env file in cwd
 async function resolveApiKey(flagValue) {
@@ -91,6 +91,7 @@ async function askAgent(client, agentId, text) {
     const start = Date.now();
     const maxWait = 60_000;
     const poll = 1_000;
+    let printedQueued = false;
     while (!terminalStates.includes(current.status.state)) {
         if (current.status.state === 'input-required') {
             throw new Error('Agent requires additional input (not supported in CLI mode)');
@@ -98,6 +99,10 @@ async function askAgent(client, agentId, text) {
         if (current.status.state === 'auth-required') {
             throw new Error('Agent requires authentication — check your API key or request access');
         }
+        if (current.status.state === 'submitted' && !printedQueued) {
+            console.log(chalk_1.default.yellow('⏳ Message queued — recipient is offline. Waiting for delivery...'));
+            printedQueued = true;
+        }
         if (Date.now() - start > maxWait)
             throw new Error('Timed out waiting for agent response');
         await new Promise(r => setTimeout(r, poll));
@@ -1216,8 +1221,11 @@ program
 ${chalk_1.default.bold('Examples:')}
   $ gopherhole send echo "Hello!"
   $ gopherhole send agent-abc123 "What's the weather?"
+  $ gopherhole send agent-abc123 "Free now?" --ttl 0        # fail if offline
+  $ gopherhole send agent-abc123 "Review this" --ttl 3600   # queue up to 1h
 `)
-    .action(async (agentId, message) => {
+    .option('--ttl <seconds>', 'Message time-to-live in seconds (0 = no queue, omit = 30 day default)', parseInt)
+    .action(async (agentId, message, cmdOpts) => {
     const sessionId = config.get('sessionId');
     if (!sessionId) {
         console.log(chalk_1.default.yellow('Not logged in.'));
@@ -1238,7 +1246,10 @@ ${chalk_1.default.bold('Examples:')}
                 method: 'SendMessage',
                 params: {
                     message: { role: 'user', parts: [{ kind: 'text', text: message }] },
-                    configuration: { agentId },
+                    configuration: {
+                        agentId,
+                        ...(cmdOpts.ttl !== undefined ? { 'x-ttl': cmdOpts.ttl } : {}),
+                    },
                 },
                 id: 1,
             }),
@@ -1263,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.0",
+  "version": "0.4.0",
   "description": "GopherHole CLI - Connect AI agents to the world",
   "main": "dist/index.js",
   "bin": {

package/src/index.ts

@@ -20,7 +20,7 @@ const brand = {
 };
 
 // Version
-const VERSION = '0.2.0';
+const VERSION = '0.3.0';
 
 // ========== API KEY RESOLUTION ==========
 // Precedence: --api-key flag > GOPHERHOLE_API_KEY env var > .env file in cwd
@@ -96,6 +96,7 @@ async function askAgent(client: A2AClient, agentId: string, text: string): Promi
   const maxWait = 60_000;
   const poll = 1_000;
 
+  let printedQueued = false;
   while (!terminalStates.includes(current.status.state)) {
     if (current.status.state === 'input-required') {
       throw new Error('Agent requires additional input (not supported in CLI mode)');
@@ -103,6 +104,10 @@ async function askAgent(client: A2AClient, agentId: string, text: string): Promi
     if (current.status.state === 'auth-required') {
       throw new Error('Agent requires authentication — check your API key or request access');
     }
+    if (current.status.state === 'submitted' && !printedQueued) {
+      console.log(chalk.yellow('⏳ Message queued — recipient is offline. Waiting for delivery...'));
+      printedQueued = true;
+    }
     if (Date.now() - start > maxWait) throw new Error('Timed out waiting for agent response');
     await new Promise(r => setTimeout(r, poll));
     current = await client.getTask(current.id);
@@ -1347,8 +1352,11 @@ program
 ${chalk.bold('Examples:')}
   $ gopherhole send echo "Hello!"
   $ gopherhole send agent-abc123 "What's the weather?"
+  $ gopherhole send agent-abc123 "Free now?" --ttl 0        # fail if offline
+  $ gopherhole send agent-abc123 "Review this" --ttl 3600   # queue up to 1h
 `)
-  .action(async (agentId, message) => {
+  .option('--ttl <seconds>', 'Message time-to-live in seconds (0 = no queue, omit = 30 day default)', parseInt)
+  .action(async (agentId, message, cmdOpts) => {
     const sessionId = config.get('sessionId') as string;
     if (!sessionId) {
       console.log(chalk.yellow('Not logged in.'));
@@ -1371,7 +1379,10 @@ ${chalk.bold('Examples:')}
           method: 'SendMessage',
           params: {
             message: { role: 'user', parts: [{ kind: 'text', text: message }] },
-            configuration: { agentId },
+            configuration: {
+              agentId,
+              ...(cmdOpts.ttl !== undefined ? { 'x-ttl': cmdOpts.ttl } : {}),
+            },
           },
           id: 1,
         }),
@@ -1401,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