@gopherhole/cli 0.2.0 → 0.3.0

package/dist/index.js

@@ -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. */
@@ -166,6 +174,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) {
@@ -2316,6 +2325,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 +2475,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 +2509,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 +2534,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 +2575,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 +2604,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 +2647,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 +2676,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 +2702,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.0",
   "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';
@@ -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.
@@ -176,6 +186,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) {
@@ -2550,6 +2561,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 +2707,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 +2738,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 +2761,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 +2799,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 +2826,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 +2866,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 +2894,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 +2918,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) {