@guildai/cli 0.5.13 → 0.6.1

package/dist/mcp/tools.js

@@ -24,17 +24,13 @@ async function pollForResponse(apiClient, sessionId, debug) {
     let lastEventId;
     while (Date.now() - startTime < POLL_TIMEOUT_MS) {
         try {
-            const response = await apiClient.get(`/sessions/${sessionId}/events`);
+            let url = `/sessions/${sessionId}/events`;
+            if (lastEventId) {
+                url += `?from_id=${lastEventId}`;
+            }
+            const response = await apiClient.get(url);
             const events = response.events || [];
-            // Find new events after last seen
-            let foundLast = !lastEventId;
             for (const event of events) {
-                if (!foundLast) {
-                    if (event.id === lastEventId) {
-                        foundLast = true;
-                    }
-                    continue;
-                }
                 debugLog(debug, `Event: ${event.event_type}`);
                 if (event.event_type === 'agent_notification_message') {
                     const data = extractEventText(event);
@@ -53,9 +49,7 @@ async function pollForResponse(apiClient, sessionId, debug) {
                     debugLog(debug, 'Runtime done');
                     return messages.join('\n\n') || 'Agent completed without output.';
                 }
-                lastEventId = event.id;
             }
-            // Update lastEventId to latest
             if (events.length > 0) {
                 lastEventId = events[events.length - 1].id;
             }
@@ -694,7 +688,7 @@ export function registerTools(server, apiClient, defaultWorkspaceId, debug) {
                 const agent = t.agent.full_name || t.agent.name;
                 const disabled = t.deactivated_at ? ' [DISABLED]' : '';
                 if (t.type === 'webhook') {
-                    return `• ${t.id} [webhook] ${t.service}/${t.event_type || '*'} → ${agent}${disabled}`;
+                    return `• ${t.id} [webhook] ${t.integration.name}/${t.event_type || '*'} → ${agent}${disabled}`;
                 }
                 return `• ${t.id} [time] ${t.frequency} → ${agent}${disabled}`;
             })

package/docs/CLI_WORKFLOW.md

@@ -21,8 +21,9 @@ Use the **CLI** (via Bash) for **local development operations**: `guild agent in
 # Create a new agent
 guild agent init --name my-agent --template LLM
 
-# Clone an existing agent
+# Clone an existing agent (full name or short name)
 guild agent clone guildai/dev-assistant
+guild agent clone dev-assistant  # resolves to your-username/dev-assistant
 cd dev-assistant
 
 # Save changes (pushes commits to Guild server)
@@ -75,8 +76,9 @@ guild agent init --name my-agent --template BLANK
 # Fork an existing agent
 guild agent init --fork owner/agent-name
 
-# Clone to work on an existing agent
+# Clone to work on an existing agent (full name, short name, or UUID)
 guild agent clone owner/agent-name
+guild agent clone agent-name  # auto-resolves owner
 ```
 
 ### Working with Existing Agents
@@ -143,6 +145,21 @@ guild agent test --ephemeral
 guild agent chat "Hello, can you help me?"
 ```
 
+### Chatting with Agents
+
+```bash
+# Chat with any published agent by name
+guild chat --agent owner/agent-name
+
+# Chat with a specific agent in a specific workspace
+guild chat --agent owner/agent-name --workspace owner/workspace-name
+
+# One-shot mode (send prompt, get response, exit)
+guild chat --agent owner/agent-name --once "What can you do?"
+```
+
+To chat with the agent you are developing locally, use `guild agent chat` from within the agent directory.
+
 ## File Structure
 
 After `guild agent init`, you get:

package/docs/skills/agent-dev.md

@@ -89,6 +89,21 @@ guild agent test --ephemeral
 guild agent chat "Hello, can you help me?"
 ```
 
+### Chatting with Agents
+
+```bash
+# Chat with any published agent by name
+guild chat --agent owner/agent-name
+
+# Chat with a specific agent in a specific workspace
+guild chat --agent owner/agent-name --workspace owner/workspace-name
+
+# One-shot mode (send prompt, get response, exit)
+guild chat --agent owner/agent-name --once "What can you do?"
+```
+
+To chat with the agent you are developing locally, use `guild agent chat` from within the agent directory.
+
 ## Guild CLI Is the ONLY Tool for Agent Operations
 
 **ALL agent work — creating, saving, testing, debugging, investigating — goes through Guild CLI.**
@@ -1740,10 +1755,10 @@ guild agent list --search "github" --published     # Search published agents
 guild agent search <query>                         # Search published agents
 guild agent versions [agent-id]                    # Version history
 guild agent clone <agent-id>                       # Clone existing agent
-guild agent fork <agent-id>:<version-id>           # Fork a specific version as a new agent
+guild agent fork [identifier]                      # Fork an agent (latest published version, or identifier:version)
 guild agent publish                                # Publish a version
 guild agent unpublish                              # Remove from catalog
-guild agent update                                 # Update agent metadata
+guild agent update [identifier]                    # Update agent metadata
 guild agent workspaces [agent-id]                  # List workspaces using an agent
 guild agent tags list|add|remove|set               # Manage agent tags
 guild agent revalidate                             # Re-run validation

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guildai/cli",
-  "version": "0.5.13",
+  "version": "0.6.1",
   "description": "Guild.ai CLI - Build, test, and deploy AI agents",
   "type": "module",
   "main": "dist/index.js",
@@ -35,12 +35,12 @@
     "format:fix": "prettier --write .",
     "format:check": "prettier --check .",
     "test": "vitest run",
-    "test:unit": "vitest run test/unit",
+    "test:unit": "vitest run test/unit --config vitest.unit.config.ts",
     "test:e2e": "vitest run test/e2e --exclude='**/**.slow.test.ts'",
     "test:e2e:slow": "vitest run 'test/e2e/**/*.slow.test.ts'",
     "test:e2e:all": "vitest run test/e2e",
     "test:watch": "vitest",
-    "prepublishOnly": "npm run build && npm run lint && npm run test"
+    "prepublishOnly": "npm run build && npm run lint && npm run test:unit"
   },
   "keywords": [
     "guild",
@@ -56,6 +56,7 @@
   },
   "dependencies": {
     "@inquirer/search": "^4.1.7",
+    "@modelcontextprotocol/sdk": "^1.12.1",
     "@napi-rs/canvas": "^0.1.85",
     "@napi-rs/keyring": "^1.2.0",
     "axios": "^1.13.2",
@@ -76,11 +77,11 @@
     "sharp": "^0.34.5",
     "shell-quote": "^1.8.2",
     "string-width": "^7.2.0",
+    "strip-ansi": "^7.2.0",
     "svg-pathdata": "^8.0.0",
     "svgdom": "^0.1.22",
     "ws": "^8.18.0",
-    "zod": "^3.24.4",
-    "@modelcontextprotocol/sdk": "^1.12.1"
+    "zod": "^3.24.4"
   },
   "devDependencies": {
     "@types/inquirer": "^8.2.10",

package/dist/commands/container/destroy.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function createContainerDestroyCommand(): Command;
-//# sourceMappingURL=destroy.d.ts.map

package/dist/commands/container/destroy.js

@@ -1,48 +0,0 @@
-// Copyright 2026 Guild.ai
-// SPDX-License-Identifier: Apache-2.0
-import { Command } from 'commander';
-import { GuildAPIClient } from '../../lib/api-client.js';
-import { getAuthToken } from '../../lib/auth.js';
-import { handleAxiosError } from '../../lib/errors.js';
-import { getOutputMode } from '../../lib/output-mode.js';
-import { createOutputWriter } from '../../lib/output.js';
-export function createContainerDestroyCommand() {
-    const cmd = new Command('destroy');
-    cmd
-        .description('Destroy a running container')
-        .argument('<container-id>', 'Container ID')
-        .action(async (containerId) => {
-        const output = createOutputWriter();
-        try {
-            const token = await getAuthToken();
-            if (!token) {
-                output.error('Not authenticated. Run: guild auth login');
-                process.exit(1);
-            }
-            const client = new GuildAPIClient();
-            const response = await client.post(`/containers/${containerId}/destroy`, {});
-            if (getOutputMode() === 'json') {
-                console.log(JSON.stringify(response, null, 2));
-            }
-            else {
-                if (response.status === 'SUCCESS') {
-                    output.success(`Container ${containerId} destroyed`);
-                }
-                else if (response.status === 'ERROR') {
-                    output.error(`Failed to destroy container: ${response.error || 'unknown error'}`);
-                    process.exit(1);
-                }
-                else {
-                    output.progress(`Container destruction ${response.status.toLowerCase()}...`);
-                }
-            }
-        }
-        catch (error) {
-            const formattedError = handleAxiosError(error);
-            output.error(`Failed to destroy container: ${formattedError.details}`);
-            process.exit(1);
-        }
-    });
-    return cmd;
-}
-//# sourceMappingURL=destroy.js.map

package/dist/commands/container/events.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function createContainerEventsCommand(): Command;
-//# sourceMappingURL=events.d.ts.map

package/dist/commands/container/events.js

@@ -1,44 +0,0 @@
-// Copyright 2026 Guild.ai
-// SPDX-License-Identifier: Apache-2.0
-import { Command } from 'commander';
-import { GuildAPIClient } from '../../lib/api-client.js';
-import { getAuthToken } from '../../lib/auth.js';
-import { handleAxiosError } from '../../lib/errors.js';
-import { getOutputMode } from '../../lib/output-mode.js';
-import { createOutputWriter, formatContainerEventTable } from '../../lib/output.js';
-export function createContainerEventsCommand() {
-    const cmd = new Command('events');
-    cmd
-        .description('List events for a container')
-        .argument('<container-id>', 'Container ID')
-        .option('--limit <number>', 'Number of results to return', '20')
-        .option('--offset <number>', 'Offset for pagination', '0')
-        .action(async (containerId, options) => {
-        const output = createOutputWriter();
-        try {
-            const token = await getAuthToken();
-            if (!token) {
-                output.error('Not authenticated. Run: guild auth login');
-                process.exit(1);
-            }
-            const client = new GuildAPIClient();
-            const params = new URLSearchParams();
-            params.append('limit', options.limit);
-            params.append('offset', options.offset);
-            const response = await client.get(`/containers/${containerId}/events?${params.toString()}`);
-            if (getOutputMode() === 'json') {
-                console.log(JSON.stringify(response, null, 2));
-            }
-            else {
-                formatContainerEventTable(response.items, response.pagination);
-            }
-        }
-        catch (error) {
-            const formattedError = handleAxiosError(error);
-            output.error(`Failed to list container events: ${formattedError.details}`);
-            process.exit(1);
-        }
-    });
-    return cmd;
-}
-//# sourceMappingURL=events.js.map

package/dist/commands/container/exec.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function createContainerExecCommand(): Command;
-//# sourceMappingURL=exec.d.ts.map

package/dist/commands/container/exec.js

@@ -1,64 +0,0 @@
-// Copyright 2026 Guild.ai
-// SPDX-License-Identifier: Apache-2.0
-import { Command } from 'commander';
-import chalk from 'chalk';
-import { GuildAPIClient } from '../../lib/api-client.js';
-import { getAuthToken } from '../../lib/auth.js';
-import { handleAxiosError } from '../../lib/errors.js';
-import { getOutputMode } from '../../lib/output-mode.js';
-import { createOutputWriter } from '../../lib/output.js';
-export function createContainerExecCommand() {
-    const cmd = new Command('exec');
-    cmd
-        .description('Execute a command in a running container')
-        .argument('<container-id>', 'Container ID')
-        .argument('<command>', 'Command to execute')
-        .action(async (containerId, command) => {
-        const output = createOutputWriter();
-        try {
-            const token = await getAuthToken();
-            if (!token) {
-                output.error('Not authenticated. Run: guild auth login');
-                process.exit(1);
-            }
-            const client = new GuildAPIClient();
-            const response = await client.post(`/containers/${containerId}/command`, { command });
-            if (getOutputMode() === 'json') {
-                console.log(JSON.stringify(response, null, 2));
-            }
-            else {
-                // Display return code
-                if (response.return_code !== null) {
-                    const codeColor = response.return_code === 0 ? chalk.green : chalk.red;
-                    console.error(chalk.dim('Return code:'), codeColor(String(response.return_code)));
-                }
-                // Display stdout
-                if (response.stdout) {
-                    console.log(response.stdout);
-                }
-                // Display stderr
-                if (response.stderr) {
-                    console.error(chalk.red(response.stderr));
-                }
-                // Display error from event
-                if (response.status === 'ERROR' && response.error) {
-                    console.error(chalk.red(`Error: ${response.error}`));
-                }
-            }
-            // Exit with the command's return code if available
-            if (response.return_code !== null && response.return_code !== 0) {
-                process.exit(response.return_code);
-            }
-            if (response.status === 'ERROR') {
-                process.exit(1);
-            }
-        }
-        catch (error) {
-            const formattedError = handleAxiosError(error);
-            output.error(`Failed to execute command: ${formattedError.details}`);
-            process.exit(1);
-        }
-    });
-    return cmd;
-}
-//# sourceMappingURL=exec.js.map

package/dist/commands/container/get.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function createContainerGetCommand(): Command;
-//# sourceMappingURL=get.d.ts.map

package/dist/commands/container/list.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function createContainerListCommand(): Command;
-//# sourceMappingURL=list.d.ts.map

package/dist/commands/container-image/create.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function createContainerImageCreateCommand(): Command;
-//# sourceMappingURL=create.d.ts.map

package/dist/commands/container-image/create.js

@@ -1,41 +0,0 @@
-// Copyright 2026 Guild.ai
-// SPDX-License-Identifier: Apache-2.0
-import { Command } from 'commander';
-import { GuildAPIClient } from '../../lib/api-client.js';
-import { getAuthToken } from '../../lib/auth.js';
-import { handleAxiosError } from '../../lib/errors.js';
-import { createOutputWriter } from '../../lib/output.js';
-export function createContainerImageCreateCommand() {
-    const cmd = new Command('create');
-    cmd
-        .description('Create a container image')
-        .requiredOption('--account <id-or-name>', 'Account or organization ID or name')
-        .requiredOption('--name <name>', 'Image name (1-100 characters)')
-        .requiredOption('--image <image>', 'Container image path (e.g. registry.example.com/org/image)')
-        .requiredOption('--tag <tag>', 'Image tag (e.g. latest)')
-        .action(async (opts) => {
-        const output = createOutputWriter();
-        try {
-            const token = await getAuthToken();
-            if (!token) {
-                output.error('Not authenticated. Run: guild auth login');
-                process.exit(1);
-            }
-            const client = new GuildAPIClient();
-            const response = await client.post('/container-images', {
-                name: opts.name,
-                image_name: opts.image,
-                tag: opts.tag,
-                owner_id_or_name: opts.account,
-            });
-            output.data(response);
-        }
-        catch (error) {
-            const formattedError = handleAxiosError(error);
-            output.error(`Failed to create container image: ${formattedError.details}`);
-            process.exit(1);
-        }
-    });
-    return cmd;
-}
-//# sourceMappingURL=create.js.map

package/dist/commands/container-image/get.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function createContainerImageGetCommand(): Command;
-//# sourceMappingURL=get.d.ts.map

package/dist/commands/container-image/get.js

@@ -1,33 +0,0 @@
-// Copyright 2026 Guild.ai
-// SPDX-License-Identifier: Apache-2.0
-import { Command } from 'commander';
-import { GuildAPIClient } from '../../lib/api-client.js';
-import { getAuthToken } from '../../lib/auth.js';
-import { handleAxiosError } from '../../lib/errors.js';
-import { createOutputWriter } from '../../lib/output.js';
-export function createContainerImageGetCommand() {
-    const cmd = new Command('get');
-    cmd
-        .description('Get container image details')
-        .argument('<image-id-or-name>', 'Container image ID or name (owner~name)')
-        .action(async (imageIdOrName) => {
-        const output = createOutputWriter();
-        try {
-            const token = await getAuthToken();
-            if (!token) {
-                output.error('Not authenticated. Run: guild auth login');
-                process.exit(1);
-            }
-            const client = new GuildAPIClient();
-            const response = await client.get(`/container-images/${imageIdOrName}`);
-            output.data(response);
-        }
-        catch (error) {
-            const formattedError = handleAxiosError(error);
-            output.error(`Failed to get container image: ${formattedError.details}`);
-            process.exit(1);
-        }
-    });
-    return cmd;
-}
-//# sourceMappingURL=get.js.map

package/dist/commands/container-image/list.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function createContainerImageListCommand(): Command;
-//# sourceMappingURL=list.d.ts.map