@gopherhole/cli 0.4.0 → 0.5.0

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) {
@@ -871,6 +871,9 @@ ${chalk_1.default.bold('Examples:')}
   $ gopherhole agents config agent-abc123 --no-auto-approve
   $ gopherhole agents config agent-abc123 --price 0.01 --price-unit request
   $ gopherhole agents config agent-abc123 --visibility public
+  $ gopherhole agents config agent-abc123 --alias support
+  $ gopherhole agents config agent-abc123 --email-enabled
+  $ gopherhole agents config agent-abc123 --no-email-enabled
 `)
     .option('--auto-approve', 'Enable auto-approve (instant access for marketplace)')
     .option('--no-auto-approve', 'Disable auto-approve (require manual approval)')
@@ -881,6 +884,9 @@ ${chalk_1.default.bold('Examples:')}
     .option('--category <category>', 'Set category')
     .option('--tags <tags>', 'Set tags (comma-separated)')
     .option('--description <text>', 'Update description')
+    .option('--alias <alias>', 'Set email alias (<alias>[.<tenant-slug>]@gopherhole.io). Triggers 30-day grace redirect from the previous alias if email is enabled')
+    .option('--email-enabled', 'Enable inbound + outbound email for this agent (requires an alias)')
+    .option('--no-email-enabled', 'Disable email for this agent (inbound rejects with 550, Postie refuses to send)')
     .action(async (agentId, options) => {
     const sessionId = config.get('sessionId');
     if (!sessionId) {
@@ -921,26 +927,65 @@ ${chalk_1.default.bold('Examples:')}
     if (options.description) {
         body.description = options.description;
     }
-    if (Object.keys(body).length === 0) {
+    const aliasChange = options.alias;
+    const emailEnabledChange = options.emailEnabled;
+    if (Object.keys(body).length === 0 && aliasChange === undefined && emailEnabledChange === undefined) {
         console.log(chalk_1.default.yellow('No changes specified.'));
         console.log(chalk_1.default.gray('Use --help to see available options.'));
         return;
     }
     const spinner = (0, ora_1.default)('Updating agent config...').start();
-    log('PATCH /agents/' + agentId, body);
     try {
-        const res = await fetch(`${API_URL}/agents/${agentId}`, {
-            method: 'PATCH',
-            headers: {
-                'Content-Type': 'application/json',
-                'X-Session-ID': sessionId,
-            },
-            body: JSON.stringify(body),
-        });
-        if (!res.ok) {
-            const err = await res.json();
-            logError('config', err);
-            throw new Error(err.error || 'Failed to update agent');
+        if (Object.keys(body).length > 0) {
+            log('PATCH /agents/' + agentId, body);
+            const res = await fetch(`${API_URL}/agents/${agentId}`, {
+                method: 'PATCH',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-Session-ID': sessionId,
+                },
+                body: JSON.stringify(body),
+            });
+            if (!res.ok) {
+                const err = await res.json();
+                logError('config', err);
+                throw new Error(err.error || 'Failed to update agent');
+            }
+        }
+        // Alias rename has its own endpoint because it also writes the
+        // 30-day grace redirect into agent_alias_history.
+        if (aliasChange !== undefined) {
+            log('PATCH /agents/' + agentId + '/alias', { alias: aliasChange });
+            const res = await fetch(`${API_URL}/agents/${agentId}/alias`, {
+                method: 'PATCH',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-Session-ID': sessionId,
+                },
+                body: JSON.stringify({ alias: aliasChange }),
+            });
+            if (!res.ok) {
+                const err = await res.json().catch(() => ({ error: `HTTP ${res.status}` }));
+                logError('alias', err);
+                throw new Error(err.error || 'Failed to set alias');
+            }
+        }
+        // Email toggle is a dedicated endpoint that enforces alias-first.
+        if (emailEnabledChange !== undefined) {
+            log('PATCH /agents/' + agentId + '/email-enabled', { enabled: emailEnabledChange });
+            const res = await fetch(`${API_URL}/agents/${agentId}/email-enabled`, {
+                method: 'PATCH',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-Session-ID': sessionId,
+                },
+                body: JSON.stringify({ enabled: emailEnabledChange }),
+            });
+            if (!res.ok) {
+                const err = await res.json().catch(() => ({ error: `HTTP ${res.status}` }));
+                logError('email-enabled', err);
+                throw new Error(err.error || 'Failed to toggle email');
+            }
         }
         spinner.succeed('Agent config updated');
         // Show what was changed
@@ -969,6 +1014,12 @@ ${chalk_1.default.bold('Examples:')}
             const desc = body.description;
             changes.push(`  Description: ${chalk_1.default.gray(desc.slice(0, 50))}${desc.length > 50 ? '...' : ''}`);
         }
+        if (aliasChange !== undefined) {
+            changes.push(`  Alias: ${brand.green(aliasChange)}`);
+        }
+        if (emailEnabledChange !== undefined) {
+            changes.push(`  Email: ${emailEnabledChange ? brand.green('enabled 📬') : chalk_1.default.gray('disabled')}`);
+        }
         if (changes.length > 0) {
             console.log('');
             console.log(chalk_1.default.bold('Changes:'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gopherhole/cli",
-  "version": "0.4.0",
+  "version": "0.5.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.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
@@ -968,6 +968,9 @@ ${chalk.bold('Examples:')}
   $ gopherhole agents config agent-abc123 --no-auto-approve
   $ gopherhole agents config agent-abc123 --price 0.01 --price-unit request
   $ gopherhole agents config agent-abc123 --visibility public
+  $ gopherhole agents config agent-abc123 --alias support
+  $ gopherhole agents config agent-abc123 --email-enabled
+  $ gopherhole agents config agent-abc123 --no-email-enabled
 `)
   .option('--auto-approve', 'Enable auto-approve (instant access for marketplace)')
   .option('--no-auto-approve', 'Disable auto-approve (require manual approval)')
@@ -978,6 +981,9 @@ ${chalk.bold('Examples:')}
   .option('--category <category>', 'Set category')
   .option('--tags <tags>', 'Set tags (comma-separated)')
   .option('--description <text>', 'Update description')
+  .option('--alias <alias>', 'Set email alias (<alias>[.<tenant-slug>]@gopherhole.io). Triggers 30-day grace redirect from the previous alias if email is enabled')
+  .option('--email-enabled', 'Enable inbound + outbound email for this agent (requires an alias)')
+  .option('--no-email-enabled', 'Disable email for this agent (inbound rejects with 550, Postie refuses to send)')
   .action(async (agentId, options) => {
     const sessionId = config.get('sessionId') as string;
     if (!sessionId) {
@@ -1021,29 +1027,71 @@ ${chalk.bold('Examples:')}
       body.description = options.description;
     }
 
-    if (Object.keys(body).length === 0) {
+    const aliasChange: string | undefined = options.alias;
+    const emailEnabledChange: boolean | undefined = options.emailEnabled;
+
+    if (Object.keys(body).length === 0 && aliasChange === undefined && emailEnabledChange === undefined) {
       console.log(chalk.yellow('No changes specified.'));
       console.log(chalk.gray('Use --help to see available options.'));
       return;
     }
 
     const spinner = ora('Updating agent config...').start();
-    log('PATCH /agents/' + agentId, body);
 
     try {
-      const res = await fetch(`${API_URL}/agents/${agentId}`, {
-        method: 'PATCH',
-        headers: {
-          'Content-Type': 'application/json',
-          'X-Session-ID': sessionId,
-        },
-        body: JSON.stringify(body),
-      });
+      if (Object.keys(body).length > 0) {
+        log('PATCH /agents/' + agentId, body);
+        const res = await fetch(`${API_URL}/agents/${agentId}`, {
+          method: 'PATCH',
+          headers: {
+            'Content-Type': 'application/json',
+            'X-Session-ID': sessionId,
+          },
+          body: JSON.stringify(body),
+        });
 
-      if (!res.ok) {
-        const err = await res.json();
-        logError('config', err);
-        throw new Error(err.error || 'Failed to update agent');
+        if (!res.ok) {
+          const err = await res.json();
+          logError('config', err);
+          throw new Error(err.error || 'Failed to update agent');
+        }
+      }
+
+      // Alias rename has its own endpoint because it also writes the
+      // 30-day grace redirect into agent_alias_history.
+      if (aliasChange !== undefined) {
+        log('PATCH /agents/' + agentId + '/alias', { alias: aliasChange });
+        const res = await fetch(`${API_URL}/agents/${agentId}/alias`, {
+          method: 'PATCH',
+          headers: {
+            'Content-Type': 'application/json',
+            'X-Session-ID': sessionId,
+          },
+          body: JSON.stringify({ alias: aliasChange }),
+        });
+        if (!res.ok) {
+          const err = await res.json().catch(() => ({ error: `HTTP ${res.status}` }));
+          logError('alias', err);
+          throw new Error((err as { error?: string }).error || 'Failed to set alias');
+        }
+      }
+
+      // Email toggle is a dedicated endpoint that enforces alias-first.
+      if (emailEnabledChange !== undefined) {
+        log('PATCH /agents/' + agentId + '/email-enabled', { enabled: emailEnabledChange });
+        const res = await fetch(`${API_URL}/agents/${agentId}/email-enabled`, {
+          method: 'PATCH',
+          headers: {
+            'Content-Type': 'application/json',
+            'X-Session-ID': sessionId,
+          },
+          body: JSON.stringify({ enabled: emailEnabledChange }),
+        });
+        if (!res.ok) {
+          const err = await res.json().catch(() => ({ error: `HTTP ${res.status}` }));
+          logError('email-enabled', err);
+          throw new Error((err as { error?: string }).error || 'Failed to toggle email');
+        }
       }
 
       spinner.succeed('Agent config updated');
@@ -1073,6 +1121,12 @@ ${chalk.bold('Examples:')}
         const desc = body.description as string;
         changes.push(`  Description: ${chalk.gray(desc.slice(0, 50))}${desc.length > 50 ? '...' : ''}`);
       }
+      if (aliasChange !== undefined) {
+        changes.push(`  Alias: ${brand.green(aliasChange)}`);
+      }
+      if (emailEnabledChange !== undefined) {
+        changes.push(`  Email: ${emailEnabledChange ? brand.green('enabled 📬') : chalk.gray('disabled')}`);
+      }
 
       if (changes.length > 0) {
         console.log('');