@guildai/cli 0.6.0 → 0.6.2

package/dist/lib/session-resume.js

@@ -7,6 +7,7 @@
 import chalk from 'chalk';
 import { marked } from 'marked';
 import { markedTerminal } from 'marked-terminal';
+import { fetchEvents } from './session-events-fetch.js';
 import { brand, code as codeColor } from './colors.js';
 // Configure marked for terminal rendering (same config as chat.tsx)
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -37,11 +38,7 @@ export function printResumeHint(sessionId, command) {
  * Fetch all events for a session from the API.
  */
 export async function fetchSessionEvents(client, sessionId) {
-    const response = await client.get(`/sessions/${sessionId}/events?limit=1000`);
-    const events = (Array.isArray(response)
-        ? response
-        : response?.items || []);
-    return events;
+    return fetchEvents(client, sessionId);
 }
 /**
  * Fetch an existing session by ID.

package/dist/lib/table.d.ts

@@ -6,7 +6,6 @@ interface ColumnConfig {
 }
 /**
  * Minimal table renderer using string-width@7 for ANSI-aware column sizing.
- * Handles OSC8 hyperlink sequences correctly (string-width uses strip-ansi@7).
  */
 export declare class Table {
     private columns;

package/dist/lib/table.js

@@ -4,7 +4,6 @@ import chalk from 'chalk';
 import stringWidth from 'string-width';
 /**
  * Minimal table renderer using string-width@7 for ANSI-aware column sizing.
- * Handles OSC8 hyperlink sequences correctly (string-width uses strip-ansi@7).
  */
 export class Table {
     columns;

package/dist/lib/version-helpers.d.ts

@@ -0,0 +1,15 @@
+import type { OutputWriter } from './output.js';
+import type { AgentVersion } from './api-types.js';
+/**
+ * Poll until a version's validation completes, then check the result.
+ * Exits the process on timeout or validation failure.
+ * Returns the updated version on success.
+ */
+export declare function waitForValidation(versionId: string, output: OutputWriter): Promise<AgentVersion>;
+/**
+ * Poll until a version's publish completes (PUBLISHING → PUBLISHED).
+ * Exits the process on timeout or failure.
+ * Returns the updated version on success.
+ */
+export declare function waitForPublish(versionId: string, output: OutputWriter): Promise<AgentVersion>;
+//# sourceMappingURL=version-helpers.d.ts.map

package/dist/lib/version-helpers.js

@@ -0,0 +1,83 @@
+// Copyright 2026 Guild.ai
+// SPDX-License-Identifier: Apache-2.0
+import { GuildAPIClient } from './api-client.js';
+import { pollUntilComplete } from './polling.js';
+/**
+ * Poll until a version's validation completes, then check the result.
+ * Exits the process on timeout or validation failure.
+ * Returns the updated version on success.
+ */
+export async function waitForValidation(versionId, output) {
+    const pollResult = await pollUntilComplete({
+        resourceId: versionId,
+        endpoint: `/versions/${versionId}`,
+        isComplete: (response) => response.validation_status !== 'PENDING' &&
+            response.validation_status !== 'RUNNING',
+        message: 'Waiting for validation to complete...',
+        successMessage: 'Validation complete',
+        timeoutMessage: 'Validation timed out',
+        maxAttempts: 120,
+        delayMs: 1000,
+    });
+    if (!pollResult.success || !pollResult.response) {
+        output.error('Validation did not complete in time', 'Check status manually:\n  guild agent versions');
+        process.exit(1);
+    }
+    const version = pollResult.response;
+    if (version.validation_status === 'FAILED') {
+        const details = await fetchValidationFailureDetails(version.id);
+        output.error('Validation failed', details);
+        process.exit(1);
+    }
+    return version;
+}
+/**
+ * Fetch validation step details for a failed version.
+ */
+async function fetchValidationFailureDetails(versionId) {
+    const client = new GuildAPIClient();
+    let failureDetails = '';
+    try {
+        const stepsResponse = await client.get(`/versions/${versionId}/validation/steps`);
+        const failedSteps = stepsResponse.steps.filter((step) => step.status === 'FAILED');
+        if (failedSteps.length > 0) {
+            failureDetails = failedSteps
+                .map((step) => step.content
+                ? `Step "${step.name}" failed: ${step.content}`
+                : `Step "${step.name}" failed`)
+                .join('\n');
+        }
+        else {
+            failureDetails = 'No failed steps found. Check validation logs for details.';
+        }
+    }
+    catch {
+        failureDetails = 'Could not fetch validation details.';
+    }
+    failureDetails +=
+        '\n\nFix the issues, then save a new version:\n  guild agent save --message "Fix validation errors"';
+    return failureDetails;
+}
+/**
+ * Poll until a version's publish completes (PUBLISHING → PUBLISHED).
+ * Exits the process on timeout or failure.
+ * Returns the updated version on success.
+ */
+export async function waitForPublish(versionId, output) {
+    const pollResult = await pollUntilComplete({
+        resourceId: versionId,
+        endpoint: `/versions/${versionId}`,
+        isComplete: (response) => response.status === 'PUBLISHED' || response.status === 'FAILED',
+        message: 'Waiting for publish to complete...',
+        successMessage: 'Published',
+        timeoutMessage: 'Publish timed out',
+        maxAttempts: 60,
+        delayMs: 1000,
+    });
+    if (!pollResult.success || pollResult.response?.status !== 'PUBLISHED') {
+        output.error('Publish did not complete in time', 'Check status manually:\n  guild agent versions');
+        process.exit(1);
+    }
+    return pollResult.response;
+}
+//# sourceMappingURL=version-helpers.js.map

package/dist/mcp/tools.js

@@ -4,7 +4,7 @@ import { z } from 'zod';
 // ---------------------------------------------------------------------------
 // Constants
 // ---------------------------------------------------------------------------
-const POLL_INTERVAL_MS = 500;
+const POLL_INTERVAL_MS = 2000;
 const POLL_TIMEOUT_MS = 120_000;
 // ---------------------------------------------------------------------------
 // Helpers
@@ -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;
             }

package/docs/CLI_WORKFLOW.md

@@ -145,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.**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guildai/cli",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Guild.ai CLI - Build, test, and deploy AI agents",
   "type": "module",
   "main": "dist/index.js",
@@ -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",