@guildai/cli 0.8.1 → 0.9.0

package/dist/commands/agent/test.js

@@ -15,7 +15,7 @@ import { format } from '../../lib/progress.js';
 import * as readline from 'readline';
 import { parseEventFilter } from '../../lib/event-filter.js';
 import { isQuietMode, getOutputMode } from '../../lib/output-mode.js';
-import { pollForResponse, pollForResponseWithEvents, } from '../../lib/session-polling.js';
+import { pollForResponseWithEvents } from '../../lib/session-polling.js';
 import { readStdinAsJSON, ensureInteractiveStdin } from '../../lib/stdin.js';
 import { loadLocalConfig, getWorkspaceId } from '../../lib/guild-config.js';
 import { GitError, formatGitError } from '../../lib/git.js';
@@ -36,15 +36,13 @@ export function createAgentTestCommand() {
         .option('--agent-version <id>', 'Test a specific version (UUID or version number)')
         .option('--resume <session-id>', 'Resume an existing test session')
         .option('--open', 'Open session in web dashboard')
-        .option('--events <types>', 'Event types to stream (default: user). Shorthands: none, user, system, all, or comma-separated type names')
+        .option('--events <types>', 'Event types to stream (default: all). Shorthands: none, user, system, all, or comma-separated type names')
         .option('--bundle <file>', 'Path to a pre-built gzip+base64 bundle file')
         .option('--no-cache', 'Skip ephemeral build cache (force a fresh build)')
         .action(async (options) => {
         const cwd = process.cwd();
-        // Parse --events filter once, before any branching
-        const eventFilter = options.events
-            ? parseEventFilter(options.events)
-            : undefined;
+        // Parse --events filter once, before any branching (default: all)
+        const eventFilter = parseEventFilter(options.events ?? 'all');
         try {
             // Handle --resume: skip build, fetch existing session, hand off to ChatApp
             if (options.resume) {
@@ -272,9 +270,7 @@ export function createAgentTestCommand() {
                     });
                     // Poll for response (starting from beginning)
                     // 3 minutes - allow time for agents that use LLM calls for input parsing
-                    const { response } = eventFilter
-                        ? await pollForResponseWithEvents(client, session.id, eventFilter, undefined, 180000)
-                        : await pollForResponse(client, session.id, undefined, 180000);
+                    const { response } = await pollForResponseWithEvents(client, session.id, eventFilter, undefined, 180000);
                     if (!response) {
                         console.error('Error: No response received from agent within timeout');
                         console.error('');
@@ -350,9 +346,7 @@ export function createAgentTestCommand() {
                             content: jsonInput,
                         });
                         // Wait for response (looking for events after last seen)
-                        const result = eventFilter
-                            ? await pollForResponseWithEvents(client, session.id, eventFilter, lastEventId, 180000)
-                            : await pollForResponse(client, session.id, lastEventId, 180000);
+                        const result = await pollForResponseWithEvents(client, session.id, eventFilter, lastEventId, 180000);
                         lastEventId = result.lastEventId;
                         if (!result.response) {
                             console.error(`Timeout: No response for line ${lineNumber}`);

package/dist/commands/job/get-step.d.ts

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

package/dist/commands/job/{step-get.js → get-step.js}

@@ -5,8 +5,8 @@ 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 createJobStepGetCommand() {
-    const cmd = new Command('step-get');
+export function createJobGetStepCommand() {
+    const cmd = new Command('get-step');
     cmd
         .description('Get details of a step in a job')
         .argument('<job-id>', 'Job ID')
@@ -37,4 +37,4 @@ export function createJobStepGetCommand() {
     });
     return cmd;
 }
-//# sourceMappingURL=step-get.js.map
+//# sourceMappingURL=get-step.js.map

package/dist/commands/mcp.js

@@ -6,7 +6,7 @@ export function createMcpCommand() {
     const cmd = new Command('mcp');
     cmd
         .description('Start an MCP server over stdio for use with Claude Code, Cursor, and other MCP hosts')
-        .option('--workspace <id>', 'Workspace ID (defaults to configured workspace)')
+        .option('--workspace <id>', 'Workspace ID or name (defaults to configured workspace)')
         .option('--debug', 'Enable debug logging to stderr')
         .addHelpText('after', `
 Configuration:

package/dist/commands/session/create.js

@@ -10,7 +10,7 @@ export function createSessionCreateCommand() {
     const cmd = new Command('create');
     cmd
         .description('Create a new session')
-        .option('--workspace <id>', 'Workspace ID or name')
+        .option('--workspace <id>', 'Workspace ID or name (e.g., owner~workspace-name)')
         .option('--type <type>', 'Session type: chat or agent_test', 'chat')
         .option('--prompt <text>', 'Initial prompt (required for chat sessions)')
         .option('--agent <identifier>', 'Agent identifier, e.g., owner~agent-name')

package/dist/commands/session/list.js

@@ -11,7 +11,7 @@ export function createSessionListCommand() {
     const cmd = new Command('list');
     cmd
         .description('List sessions in a workspace')
-        .option('--workspace <id>', 'Workspace ID or name')
+        .option('--workspace <id>', 'Workspace ID or name (e.g., owner~workspace-name)')
         .option('--type <type>', 'Filter by session type: chat, webhook, time, agent_test')
         .option('--limit <number>', 'Number of results to return', '20')
         .option('--offset <number>', 'Offset for pagination', '0')

package/dist/index.js

@@ -61,7 +61,7 @@ import { createSessionCreateCommand } from './commands/session/create.js';
 import { createSessionSendCommand } from './commands/session/send.js';
 import { createSessionInterruptCommand } from './commands/session/interrupt.js';
 import { createJobGetCommand } from './commands/job/get.js';
-import { createJobStepGetCommand } from './commands/job/step-get.js';
+import { createJobGetStepCommand } from './commands/job/get-step.js';
 import { createConfigListCommand } from './commands/config/list.js';
 import { createConfigGetCommand } from './commands/config/get.js';
 import { createConfigSetCommand } from './commands/config/set.js';
@@ -281,7 +281,10 @@ sessionCmd.addCommand(createSessionInterruptCommand());
 // Job command group
 const jobCmd = program.command('job').description('Job management');
 jobCmd.addCommand(createJobGetCommand());
-jobCmd.addCommand(createJobStepGetCommand());
+jobCmd.addCommand(createJobGetStepCommand());
+const stepGetAlias = createJobGetStepCommand();
+stepGetAlias.name('step-get');
+jobCmd.addCommand(stepGetAlias, { hidden: true });
 // Config command group
 const configCmd = program
     .command('config')

package/dist/lib/api-types.d.ts

@@ -116,6 +116,12 @@ export interface ValidationStep {
 export interface ValidationStepsResponse {
     steps: ValidationStep[];
 }
+/**
+ * Response from /versions/{id}/publish/steps
+ */
+export interface PublishStepsResponse {
+    steps: ValidationStep[];
+}
 /**
  * Workspace context entity from the API.
  * Used by: workspace context list, get, edit

package/dist/lib/output.js

@@ -38,6 +38,20 @@ function truncate(str, maxLen) {
         return str;
     return str.slice(0, maxLen - 1) + '…';
 }
+/**
+ * Print the "Showing N of M <entity>" footer after a paginated table.
+ */
+function printPaginationFooter(pagination, count, entityName) {
+    const showing = Math.min(pagination.limit, count);
+    if (pagination.has_more) {
+        const nextOffset = pagination.offset + pagination.limit;
+        console.log(`\nShowing ${showing} of ${pagination.total_count} ${entityName}. ` +
+            chalk.dim(`Use --offset ${nextOffset} to see more.`));
+    }
+    else if (pagination.total_count > showing) {
+        console.log(chalk.dim(`\nShowing ${showing} of ${pagination.total_count} ${entityName}`));
+    }
+}
 /**
  * Format an agent list as a human-readable table.
  * Shared by agent list and agent search commands.
@@ -75,15 +89,7 @@ export function formatAgentTable(agents, pagination, showArchived = false) {
         });
     });
     table.printTable();
-    const showing = Math.min(pagination.limit, agents.length);
-    if (pagination.has_more) {
-        const nextOffset = pagination.offset + pagination.limit;
-        console.log(`\nShowing ${showing} of ${pagination.total_count} agents. ` +
-            chalk.dim(`Use --offset ${nextOffset} to see more.`));
-    }
-    else if (pagination.total_count > showing) {
-        console.log(chalk.dim(`\nShowing ${showing} of ${pagination.total_count} agents`));
-    }
+    printPaginationFooter(pagination, agents.length, 'agents');
 }
 /**
  * Format an integration list as a human-readable table.
@@ -113,15 +119,7 @@ export function formatIntegrationTable(integrations, pagination) {
         });
     });
     table.printTable();
-    const showing = Math.min(pagination.limit, integrations.length);
-    if (pagination.has_more) {
-        const nextOffset = pagination.offset + pagination.limit;
-        console.log(`\nShowing ${showing} of ${pagination.total_count} integrations. ` +
-            chalk.dim(`Use --offset ${nextOffset} to see more.`));
-    }
-    else if (pagination.total_count > showing) {
-        console.log(chalk.dim(`\nShowing ${showing} of ${pagination.total_count} integrations`));
-    }
+    printPaginationFooter(pagination, integrations.length, 'integrations');
 }
 /**
  * Format an integration version list as a human-readable table.
@@ -169,15 +167,7 @@ export function formatIntegrationVersionTable(versions, pagination, integrationN
         });
     });
     table.printTable();
-    const showing = Math.min(pagination.limit, versions.length);
-    if (pagination.has_more) {
-        const nextOffset = pagination.offset + pagination.limit;
-        console.log(`\nShowing ${showing} of ${pagination.total_count} versions. ` +
-            chalk.dim(`Use --offset ${nextOffset} to see more.`));
-    }
-    else if (pagination.total_count > showing) {
-        console.log(chalk.dim(`\nShowing ${showing} of ${pagination.total_count} versions`));
-    }
+    printPaginationFooter(pagination, versions.length, 'versions');
 }
 /**
  * Format an agent version list as a human-readable table.
@@ -214,15 +204,7 @@ export function formatVersionTable(versions, pagination) {
         });
     });
     table.printTable();
-    const showing = Math.min(pagination.limit, versions.length);
-    if (pagination.has_more) {
-        const nextOffset = pagination.offset + pagination.limit;
-        console.log(`\nShowing ${showing} of ${pagination.total_count} versions. ` +
-            chalk.dim(`Use --offset ${nextOffset} to see more.`));
-    }
-    else if (pagination.total_count > showing) {
-        console.log(chalk.dim(`\nShowing ${showing} of ${pagination.total_count} versions`));
-    }
+    printPaginationFooter(pagination, versions.length, 'versions');
 }
 /**
  * Format a context list as a human-readable table.
@@ -250,15 +232,7 @@ export function formatContextTable(contexts, pagination) {
         });
     });
     table.printTable();
-    const showing = Math.min(pagination.limit, contexts.length);
-    if (pagination.has_more) {
-        const nextOffset = pagination.offset + pagination.limit;
-        console.log(`\nShowing ${showing} of ${pagination.total_count} contexts. ` +
-            chalk.dim(`Use --offset ${nextOffset} to see more.`));
-    }
-    else if (pagination.total_count > showing) {
-        console.log(chalk.dim(`\nShowing ${showing} of ${pagination.total_count} contexts`));
-    }
+    printPaginationFooter(pagination, contexts.length, 'contexts');
 }
 /**
  * Format a workspace agent list as a human-readable table.
@@ -314,15 +288,7 @@ export function formatWorkspaceTable(workspaces, pagination) {
         });
     });
     table.printTable();
-    const showing = Math.min(pagination.limit, workspaces.length);
-    if (pagination.has_more) {
-        const nextOffset = pagination.offset + pagination.limit;
-        console.log(`\nShowing ${showing} of ${pagination.total_count} workspaces. ` +
-            chalk.dim(`Use --offset ${nextOffset} to see more.`));
-    }
-    else if (pagination.total_count > showing) {
-        console.log(chalk.dim(`\nShowing ${showing} of ${pagination.total_count} workspaces`));
-    }
+    printPaginationFooter(pagination, workspaces.length, 'workspaces');
 }
 /**
  * Format a session list as a human-readable table.
@@ -353,15 +319,7 @@ export function formatSessionTable(sessions, pagination) {
         });
     });
     table.printTable();
-    const showing = Math.min(pagination.limit, sessions.length);
-    if (pagination.has_more) {
-        const nextOffset = pagination.offset + pagination.limit;
-        console.log(`\nShowing ${showing} of ${pagination.total_count} sessions. ` +
-            chalk.dim(`Use --offset ${nextOffset} to see more.`));
-    }
-    else if (pagination.total_count > showing) {
-        console.log(chalk.dim(`\nShowing ${showing} of ${pagination.total_count} sessions`));
-    }
+    printPaginationFooter(pagination, sessions.length, 'sessions');
 }
 /**
  * Format a task list as a human-readable table.
@@ -403,15 +361,7 @@ export function formatTaskTable(tasks, pagination) {
         });
     });
     table.printTable();
-    const showing = Math.min(pagination.limit, tasks.length);
-    if (pagination.has_more) {
-        const nextOffset = pagination.offset + pagination.limit;
-        console.log(`\nShowing ${showing} of ${pagination.total_count} tasks. ` +
-            chalk.dim(`Use --offset ${nextOffset} to see more.`));
-    }
-    else if (pagination.total_count > showing) {
-        console.log(chalk.dim(`\nShowing ${showing} of ${pagination.total_count} tasks`));
-    }
+    printPaginationFooter(pagination, tasks.length, 'tasks');
 }
 /**
  * Format a trigger list as a human-readable table.
@@ -453,15 +403,7 @@ export function formatTriggerTable(triggers, pagination) {
         });
     });
     table.printTable();
-    const showing = Math.min(pagination.limit, triggers.length);
-    if (pagination.has_more) {
-        const nextOffset = pagination.offset + pagination.limit;
-        console.log(`\nShowing ${showing} of ${pagination.total_count} triggers. ` +
-            chalk.dim(`Use --offset ${nextOffset} to see more.`));
-    }
-    else if (pagination.total_count > showing) {
-        console.log(chalk.dim(`\nShowing ${showing} of ${pagination.total_count} triggers`));
-    }
+    printPaginationFooter(pagination, triggers.length, 'triggers');
 }
 export function formatCredentialsTable(credentials, pagination) {
     if (credentials.length === 0) {
@@ -485,15 +427,7 @@ export function formatCredentialsTable(credentials, pagination) {
         });
     });
     table.printTable();
-    const showing = Math.min(pagination.limit, credentials.length);
-    if (pagination.has_more) {
-        const nextOffset = pagination.offset + pagination.limit;
-        console.log(`\nShowing ${showing} of ${pagination.total_count} credentials. ` +
-            chalk.dim(`Use --offset ${nextOffset} to see more.`));
-    }
-    else if (pagination.total_count > showing) {
-        console.log(chalk.dim(`\nShowing ${showing} of ${pagination.total_count} credentials`));
-    }
+    printPaginationFooter(pagination, credentials.length, 'credentials');
 }
 export function formatPoliciesTable(policies, pagination) {
     if (policies.length === 0) {
@@ -534,15 +468,7 @@ export function formatPoliciesTable(policies, pagination) {
         });
     });
     table.printTable();
-    const showing = Math.min(pagination.limit, policies.length);
-    if (pagination.has_more) {
-        const nextOffset = pagination.offset + pagination.limit;
-        console.log(`\nShowing ${showing} of ${pagination.total_count} policies. ` +
-            chalk.dim(`Use --offset ${nextOffset} to see more.`));
-    }
-    else if (pagination.total_count > showing) {
-        console.log(chalk.dim(`\nShowing ${showing} of ${pagination.total_count} policies`));
-    }
+    printPaginationFooter(pagination, policies.length, 'policies');
 }
 /**
  * Format job steps as a human-readable table.

package/dist/lib/polling.d.ts

@@ -37,6 +37,13 @@ export interface PollOptions<T = unknown> {
      * @default "Operation timed out"
      */
     timeoutMessage?: string;
+    /**
+     * Optional callback invoked after each poll when the operation is not yet
+     * complete. Return a non-null string to override the default spinner text
+     * (`${message} (${attempts}/${maxAttempts})`). Return null to keep the
+     * default. Errors thrown by the callback are silently ignored.
+     */
+    onPoll?: (response: T, attempts: number) => Promise<string | null>;
 }
 export interface PollResult<T = unknown> {
     /**

package/dist/lib/polling.js

@@ -21,7 +21,7 @@ import { createSpinner } from './progress.js';
  * ```
  */
 export async function pollUntilComplete(options) {
-    const { endpoint, isComplete, message = 'Waiting for operation to complete...', maxAttempts = 60, delayMs = 1000, successMessage = 'Operation complete', timeoutMessage = 'Operation timed out', } = options;
+    const { endpoint, isComplete, message = 'Waiting for operation to complete...', maxAttempts = 60, delayMs = 1000, successMessage = 'Operation complete', timeoutMessage = 'Operation timed out', onPoll, } = options;
     const client = new GuildAPIClient();
     const spinner = createSpinner(message);
     spinner.start();
@@ -40,8 +40,17 @@ export async function pollUntilComplete(options) {
                     attempts,
                 };
             }
-            // Update spinner with progress
-            spinner.text = `${message} (${attempts}/${maxAttempts})`;
+            // Update spinner with progress — prefer onPoll text when available
+            let spinnerText = null;
+            if (onPoll) {
+                try {
+                    spinnerText = await onPoll(response, attempts);
+                }
+                catch {
+                    // Silently ignore step-fetch errors; fall back to default text
+                }
+            }
+            spinner.text = spinnerText ?? `${message} (${attempts}/${maxAttempts})`;
         }
         catch {
             // If we can't fetch the resource, continue polling

package/dist/lib/version-helpers.js

@@ -2,12 +2,41 @@
 // SPDX-License-Identifier: Apache-2.0
 import { GuildAPIClient } from './api-client.js';
 import { pollUntilComplete } from './polling.js';
+/**
+ * Format a list of validation steps into a compact single-line status string
+ * suitable for spinner text, e.g. `✓ build  ⟳ test  ○ deploy`.
+ * Returns null when the steps array is empty so callers can fall back to the
+ * default attempt-counter text.
+ */
+function formatStepProgress(steps) {
+    if (steps.length === 0)
+        return null;
+    const tokens = steps.map((step) => {
+        let prefix;
+        switch (step.status) {
+            case 'SUCCEEDED':
+                prefix = '✓';
+                break;
+            case 'RUNNING':
+                prefix = '⟳';
+                break;
+            case 'FAILED':
+                prefix = '✗';
+                break;
+            default:
+                prefix = '○';
+        }
+        return `${prefix} ${step.name}`;
+    });
+    return tokens.join('  ');
+}
 /**
  * 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 client = new GuildAPIClient();
     const pollResult = await pollUntilComplete({
         resourceId: versionId,
         endpoint: `/versions/${versionId}`,
@@ -18,6 +47,10 @@ export async function waitForValidation(versionId, output) {
         timeoutMessage: 'Validation timed out',
         maxAttempts: 120,
         delayMs: 1000,
+        onPoll: async () => {
+            const r = await client.get(`/versions/${versionId}/validation/steps`);
+            return formatStepProgress(r.steps);
+        },
     });
     if (!pollResult.success || !pollResult.response) {
         output.error('Validation did not complete in time', 'Check status manually:\n  guild agent versions');
@@ -64,6 +97,7 @@ async function fetchValidationFailureDetails(versionId) {
  * Returns the updated version on success.
  */
 export async function waitForPublish(versionId, output) {
+    const client = new GuildAPIClient();
     const pollResult = await pollUntilComplete({
         resourceId: versionId,
         endpoint: `/versions/${versionId}`,
@@ -73,6 +107,10 @@ export async function waitForPublish(versionId, output) {
         timeoutMessage: 'Publish timed out',
         maxAttempts: 60,
         delayMs: 1000,
+        onPoll: async () => {
+            const r = await client.get(`/versions/${versionId}/publish/steps`);
+            return formatStepProgress(r.steps);
+        },
     });
     if (!pollResult.success || pollResult.response?.status !== 'PUBLISHED') {
         output.error('Publish did not complete in time', 'Check status manually:\n  guild agent versions');

package/docs/CLI_WORKFLOW.md

@@ -1,5 +1,5 @@
 ---
-name: Guild CLI Workflow
+name: guild-cli-workflow
 description: Agent development using the Guild CLI. Activated when user mentions guild agent commands, saving/publishing agents, clone/pull workflow, or agent testing. Covers CLI commands and common workflows.
 ---
 

package/docs/skills/agent-dev.md

@@ -1,5 +1,5 @@
 ---
-name: Guild Agent Development
+name: guild-agent-development
 description: Local agent development using the Guild CLI. Activated when user mentions creating agents, guild agent commands, saving/publishing agents, or agent development workflow. Handles proper CLI workflow and prevents direct git operations.
 ---
 

package/docs/skills/integrations.md

@@ -1,5 +1,5 @@
 ---
-name: Guild Integrations
+name: guild-integrations
 description: Build custom integrations that connect external APIs to Guild agents. Activated when user mentions custom integrations, OpenAPI specs, connecting APIs via CLI, guild integration commands, or building service tools for agents.
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guildai/cli",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "description": "Guild.ai CLI - Build, test, and deploy AI agents",
   "type": "module",
   "main": "dist/index.js",

package/dist/commands/job/step-get.d.ts

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