@gopherhole/cli 0.3.0 → 0.3.1

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,
             }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gopherhole/cli",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "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,
         }),