@gopherhole/cli 0.2.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) {
@@ -62,6 +62,14 @@ async function resolveAgentId(flagValue) {
     catch { /* ignore */ }
     return null;
 }
+function resolveTransport(flagValue) {
+    const value = flagValue || process.env.GOPHERHOLE_TRANSPORT || 'http';
+    if (!['http', 'ws', 'auto'].includes(value)) {
+        console.error(chalk_1.default.red(`Invalid transport: ${value}. Must be http, ws, or auto`));
+        process.exit(1);
+    }
+    return value;
+}
 function makeAgentClient(apiKey) {
     return new sdk_1.A2AClient({
         apiKey,
@@ -69,10 +77,10 @@ function makeAgentClient(apiKey) {
     });
 }
 /** Hub client for workspace/discovery operations (does not connect WebSocket) */
-function makeHubClient(apiKey) {
+function makeHubClient(apiKey, transport) {
     const apiUrl = process.env.GOPHERHOLE_API_URL || 'https://hub.gopherhole.ai';
     const hubUrl = apiUrl.replace('https://', 'wss://').replace('http://', 'ws://') + '/ws';
-    return new sdk_1.GopherHole({ apiKey, hubUrl, autoReconnect: false });
+    return new sdk_1.GopherHole({ apiKey, hubUrl, autoReconnect: false, transport: transport || 'http' });
 }
 /** Send a message and poll until terminal state, return response text.
  *  Matches the MCP client pattern: sendText → poll getTask. */
@@ -83,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)');
@@ -90,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));
@@ -166,6 +179,7 @@ ${chalk_1.default.bold('Documentation:')}
 `)
     .version(VERSION)
     .option('-v, --verbose', 'Enable verbose output for debugging')
+    .option('-t, --transport <mode>', 'Transport mode: http | ws | auto (default: http)')
     .hook('preAction', (thisCommand) => {
     verbose = thisCommand.opts().verbose || false;
     if (verbose) {
@@ -1207,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.'));
@@ -1229,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,
             }),
@@ -2316,6 +2336,7 @@ ${chalk_1.default.bold('Examples:')}
         console.error(chalk_1.default.gray('Set GOPHERHOLE_API_KEY, pass --api-key, or run gopher init to create a .env'));
         process.exit(1);
     }
+    log(`Transport: http (A2AClient is HTTP-only)`);
     const spinner = (0, ora_1.default)(`Messaging ${agentId}...`).start();
     try {
         const client = makeAgentClient(apiKey);
@@ -2465,7 +2486,7 @@ ws
     }
     const spinner = (0, ora_1.default)('Loading workspaces...').start();
     try {
-        const client = makeHubClient(apiKey);
+        const client = makeHubClient(apiKey, resolveTransport(program.opts().transport));
         const result = await client.workspaceList();
         spinner.stop();
         if (!result.workspaces.length) {
@@ -2499,7 +2520,7 @@ ws
     }
     const spinner = (0, ora_1.default)('Creating workspace...').start();
     try {
-        const client = makeHubClient(apiKey);
+        const client = makeHubClient(apiKey, resolveTransport(program.opts().transport));
         const result = await client.workspaceCreate(name, options.description);
         spinner.succeed(`Workspace created: ${chalk_1.default.bold(result.workspace.name)}`);
         console.log(chalk_1.default.gray(`  ID: ${result.workspace.id}`));
@@ -2524,7 +2545,7 @@ ws
     }
     const spinner = (0, ora_1.default)('Searching...').start();
     try {
-        const client = makeHubClient(apiKey);
+        const client = makeHubClient(apiKey, resolveTransport(program.opts().transport));
         const result = await client.workspaceQuery({
             workspace_id: workspaceId,
             query,
@@ -2565,7 +2586,7 @@ ws
     }
     const spinner = (0, ora_1.default)('Storing...').start();
     try {
-        const client = makeHubClient(apiKey);
+        const client = makeHubClient(apiKey, resolveTransport(program.opts().transport));
         const result = await client.workspaceStore({
             workspace_id: workspaceId,
             content,
@@ -2594,7 +2615,7 @@ ws
     }
     const spinner = (0, ora_1.default)('Loading memories...').start();
     try {
-        const client = makeHubClient(apiKey);
+        const client = makeHubClient(apiKey, resolveTransport(program.opts().transport));
         const result = await client.workspaceMemories({
             workspace_id: workspaceId,
             limit: parseInt(options.limit),
@@ -2637,7 +2658,7 @@ ws
     }
     const spinner = (0, ora_1.default)('Deleting...').start();
     try {
-        const client = makeHubClient(apiKey);
+        const client = makeHubClient(apiKey, resolveTransport(program.opts().transport));
         const result = await client.workspaceForget({
             workspace_id: workspaceId,
             id: options.id,
@@ -2666,7 +2687,7 @@ wsMembers
     }
     const spinner = (0, ora_1.default)('Loading members...').start();
     try {
-        const client = makeHubClient(apiKey);
+        const client = makeHubClient(apiKey, resolveTransport(program.opts().transport));
         const result = await client.workspaceMembersList(workspaceId);
         spinner.stop();
         result.members.forEach(m => {
@@ -2692,7 +2713,7 @@ wsMembers
     }
     const spinner = (0, ora_1.default)('Adding member...').start();
     try {
-        const client = makeHubClient(apiKey);
+        const client = makeHubClient(apiKey, resolveTransport(program.opts().transport));
         await client.workspaceMembersAdd(workspaceId, agentId, options.role);
         spinner.succeed(`Added ${agentId} with role: ${options.role}`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gopherhole/cli",
-  "version": "0.2.0",
+  "version": "0.3.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.5.4",
+    "@gopherhole/sdk": "^0.6.0",
     "chalk": "^5.3.0",
     "commander": "^12.0.0",
     "conf": "^12.0.0",

package/src/index.ts

@@ -6,6 +6,7 @@ import inquirer from 'inquirer';
 import ora from 'ora';
 import open from 'open';
 import { A2AClient, GopherHole } from '@gopherhole/sdk';
+import type { TransportMode } from '@gopherhole/sdk';
 
 const config = new Conf({ projectName: 'gopherhole' });
 const API_URL = 'https://gopherhole.ai/api';
@@ -19,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
@@ -61,6 +62,15 @@ async function resolveAgentId(flagValue?: string): Promise<string | null> {
   return null;
 }
 
+function resolveTransport(flagValue?: string): TransportMode {
+  const value = flagValue || process.env.GOPHERHOLE_TRANSPORT || 'http';
+  if (!['http', 'ws', 'auto'].includes(value)) {
+    console.error(chalk.red(`Invalid transport: ${value}. Must be http, ws, or auto`));
+    process.exit(1);
+  }
+  return value as TransportMode;
+}
+
 function makeAgentClient(apiKey: string): A2AClient {
   return new A2AClient({
     apiKey,
@@ -69,10 +79,10 @@ function makeAgentClient(apiKey: string): A2AClient {
 }
 
 /** Hub client for workspace/discovery operations (does not connect WebSocket) */
-function makeHubClient(apiKey: string): GopherHole {
+function makeHubClient(apiKey: string, transport?: TransportMode): GopherHole {
   const apiUrl = process.env.GOPHERHOLE_API_URL || 'https://hub.gopherhole.ai';
   const hubUrl = apiUrl.replace('https://', 'wss://').replace('http://', 'ws://') + '/ws';
-  return new GopherHole({ apiKey, hubUrl, autoReconnect: false });
+  return new GopherHole({ apiKey, hubUrl, autoReconnect: false, transport: transport || 'http' });
 }
 
 /** Send a message and poll until terminal state, return response text.
@@ -86,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)');
@@ -93,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);
@@ -176,6 +191,7 @@ ${chalk.bold('Documentation:')}
 `)
   .version(VERSION)
   .option('-v, --verbose', 'Enable verbose output for debugging')
+  .option('-t, --transport <mode>', 'Transport mode: http | ws | auto (default: http)')
   .hook('preAction', (thisCommand) => {
     verbose = thisCommand.opts().verbose || false;
     if (verbose) {
@@ -1336,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.'));
@@ -1360,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,
         }),
@@ -2550,6 +2572,7 @@ ${chalk.bold('Examples:')}
       process.exit(1);
     }
 
+    log(`Transport: http (A2AClient is HTTP-only)`);
     const spinner = ora(`Messaging ${agentId}...`).start();
     try {
       const client = makeAgentClient(apiKey);
@@ -2695,7 +2718,7 @@ ws
     }
     const spinner = ora('Loading workspaces...').start();
     try {
-      const client = makeHubClient(apiKey);
+      const client = makeHubClient(apiKey, resolveTransport(program.opts().transport));
       const result = await client.workspaceList();
       spinner.stop();
       if (!result.workspaces.length) {
@@ -2726,7 +2749,7 @@ ws
     }
     const spinner = ora('Creating workspace...').start();
     try {
-      const client = makeHubClient(apiKey);
+      const client = makeHubClient(apiKey, resolveTransport(program.opts().transport));
       const result = await client.workspaceCreate(name, options.description);
       spinner.succeed(`Workspace created: ${chalk.bold(result.workspace.name)}`);
       console.log(chalk.gray(`  ID: ${result.workspace.id}`));
@@ -2749,7 +2772,7 @@ ws
     }
     const spinner = ora('Searching...').start();
     try {
-      const client = makeHubClient(apiKey);
+      const client = makeHubClient(apiKey, resolveTransport(program.opts().transport));
       const result = await client.workspaceQuery({
         workspace_id: workspaceId,
         query,
@@ -2787,7 +2810,7 @@ ws
     }
     const spinner = ora('Storing...').start();
     try {
-      const client = makeHubClient(apiKey);
+      const client = makeHubClient(apiKey, resolveTransport(program.opts().transport));
       const result = await client.workspaceStore({
         workspace_id: workspaceId,
         content,
@@ -2814,7 +2837,7 @@ ws
     }
     const spinner = ora('Loading memories...').start();
     try {
-      const client = makeHubClient(apiKey);
+      const client = makeHubClient(apiKey, resolveTransport(program.opts().transport));
       const result = await client.workspaceMemories({
         workspace_id: workspaceId,
         limit: parseInt(options.limit),
@@ -2854,7 +2877,7 @@ ws
     }
     const spinner = ora('Deleting...').start();
     try {
-      const client = makeHubClient(apiKey);
+      const client = makeHubClient(apiKey, resolveTransport(program.opts().transport));
       const result = await client.workspaceForget({
         workspace_id: workspaceId,
         id: options.id,
@@ -2882,7 +2905,7 @@ wsMembers
     }
     const spinner = ora('Loading members...').start();
     try {
-      const client = makeHubClient(apiKey);
+      const client = makeHubClient(apiKey, resolveTransport(program.opts().transport));
       const result = await client.workspaceMembersList(workspaceId);
       spinner.stop();
       result.members.forEach(m => {
@@ -2906,7 +2929,7 @@ wsMembers
     }
     const spinner = ora('Adding member...').start();
     try {
-      const client = makeHubClient(apiKey);
+      const client = makeHubClient(apiKey, resolveTransport(program.opts().transport));
       await client.workspaceMembersAdd(workspaceId, agentId, options.role);
       spinner.succeed(`Added ${agentId} with role: ${options.role}`);
     } catch (err) {