@guildai/cli 0.5.10 → 0.5.12

package/dist/lib/output.js

@@ -1,7 +1,7 @@
 // Copyright 2026 Guild.ai
 // SPDX-License-Identifier: Apache-2.0
 import chalk from 'chalk';
-import { Table } from 'console-table-printer';
+import { Table } from './table.js';
 import { getOutputMode, isQuietMode } from './output-mode.js';
 import { createSpinner } from './progress.js';
 import { brand, hyperlink } from './colors.js';
@@ -313,6 +313,189 @@ export function formatTriggerTable(triggers, pagination) {
         console.log(chalk.dim(`\nShowing ${showing} of ${pagination.total_count} triggers`));
     }
 }
+/**
+ * Format a container list as a human-readable table.
+ * Used by container list command.
+ */
+export function formatContainerTable(containers, pagination) {
+    if (containers.length === 0) {
+        console.log(chalk.dim('No containers found'));
+        return;
+    }
+    const table = new Table({
+        columns: [
+            { name: 'id', title: 'ID', alignment: 'left' },
+            { name: 'status', title: 'STATUS', alignment: 'left' },
+            { name: 'image', title: 'IMAGE', alignment: 'left' },
+            { name: 'tag', title: 'TAG', alignment: 'left' },
+            { name: 'created', title: 'CREATED', alignment: 'left' },
+        ],
+    });
+    containers.forEach((container) => {
+        const statusColor = container.status === 'RUNNING'
+            ? chalk.green
+            : container.status === 'ERRORED'
+                ? chalk.red
+                : container.status === 'DESTROYED'
+                    ? chalk.dim
+                    : chalk.yellow;
+        table.addRow({
+            id: container.id,
+            status: statusColor(container.status),
+            image: container.image?.name || '-',
+            tag: container.image?.tag || '-',
+            created: container.created_at ? formatRelativeTime(container.created_at) : '',
+        });
+    });
+    table.printTable();
+    const showing = Math.min(pagination.limit, containers.length);
+    if (pagination.has_more) {
+        const nextOffset = pagination.offset + pagination.limit;
+        console.log(`\nShowing ${showing} of ${pagination.total_count} containers. ` +
+            chalk.dim(`Use --offset ${nextOffset} to see more.`));
+    }
+    else if (pagination.total_count > showing) {
+        console.log(chalk.dim(`\nShowing ${showing} of ${pagination.total_count} containers`));
+    }
+}
+/**
+ * Format a container image list as a human-readable table.
+ * Used by container-image list command.
+ */
+export function formatContainerImageTable(images, pagination) {
+    if (images.length === 0) {
+        console.log(chalk.dim('No container images found'));
+        return;
+    }
+    const table = new Table({
+        columns: [
+            { name: 'id', title: 'ID', alignment: 'left' },
+            { name: 'name', title: 'NAME', alignment: 'left' },
+            { name: 'image', title: 'IMAGE', alignment: 'left' },
+            { name: 'tag', title: 'TAG', alignment: 'left' },
+            { name: 'public', title: 'PUBLIC', alignment: 'left' },
+        ],
+    });
+    images.forEach((image) => {
+        table.addRow({
+            id: image.id,
+            name: image.name,
+            image: image.image_name,
+            tag: image.tag,
+            public: image.is_public ? chalk.green('yes') : chalk.dim('no'),
+        });
+    });
+    table.printTable();
+    const showing = Math.min(pagination.limit, images.length);
+    if (pagination.has_more) {
+        const nextOffset = pagination.offset + pagination.limit;
+        console.log(`\nShowing ${showing} of ${pagination.total_count} images. ` +
+            chalk.dim(`Use --offset ${nextOffset} to see more.`));
+    }
+    else if (pagination.total_count > showing) {
+        console.log(chalk.dim(`\nShowing ${showing} of ${pagination.total_count} images`));
+    }
+}
+/**
+ * Derive a human-readable event type label from entity_type.
+ */
+function formatEventType(entityType) {
+    if (entityType === 'EntContainerEventCreate')
+        return 'create';
+    if (entityType === 'EntContainerEventDestroy')
+        return 'destroy';
+    if (entityType === 'EntContainerEventCommand')
+        return 'command';
+    return entityType;
+}
+/**
+ * Format a container event list as a human-readable table.
+ * Used by container events command.
+ */
+export function formatContainerEventTable(events, pagination) {
+    if (events.length === 0) {
+        console.log(chalk.dim('No events found'));
+        return;
+    }
+    const table = new Table({
+        columns: [
+            { name: 'id', title: 'ID', alignment: 'left' },
+            { name: 'type', title: 'TYPE', alignment: 'left', color: 'cyan' },
+            { name: 'status', title: 'STATUS', alignment: 'left' },
+            { name: 'actor', title: 'ACTOR', alignment: 'left' },
+            { name: 'detail', title: 'DETAIL', alignment: 'left' },
+            { name: 'created', title: 'CREATED', alignment: 'left' },
+        ],
+    });
+    events.forEach((event) => {
+        const statusColor = event.status === 'SUCCESS'
+            ? chalk.green
+            : event.status === 'ERROR'
+                ? chalk.red
+                : chalk.yellow;
+        let detail = '';
+        if (event.entity_type === 'EntContainerEventCommand') {
+            detail = truncate(event.command, 30);
+        }
+        else if (event.status === 'ERROR' && event.error) {
+            detail = truncate(event.error, 30);
+        }
+        table.addRow({
+            id: event.id,
+            type: formatEventType(event.entity_type),
+            status: statusColor(event.status),
+            actor: event.actor?.name || event.actor?.full_name || '-',
+            detail,
+            created: event.created_at ? formatRelativeTime(event.created_at) : '',
+        });
+    });
+    table.printTable();
+    const showing = Math.min(pagination.limit, events.length);
+    if (pagination.has_more) {
+        const nextOffset = pagination.offset + pagination.limit;
+        console.log(`\nShowing ${showing} of ${pagination.total_count} events. ` +
+            chalk.dim(`Use --offset ${nextOffset} to see more.`));
+    }
+    else if (pagination.total_count > showing) {
+        console.log(chalk.dim(`\nShowing ${showing} of ${pagination.total_count} events`));
+    }
+}
+/**
+ * Format job steps as a human-readable table.
+ * Used by job get command.
+ */
+export function formatJobStepTable(steps) {
+    if (steps.length === 0) {
+        console.log(chalk.dim('No steps found'));
+        return;
+    }
+    const table = new Table({
+        columns: [
+            { name: 'name', title: 'STEP', alignment: 'left' },
+            { name: 'status', title: 'STATUS', alignment: 'left' },
+            { name: 'started', title: 'STARTED', alignment: 'left' },
+            { name: 'completed', title: 'COMPLETED', alignment: 'left' },
+        ],
+    });
+    steps.forEach((step) => {
+        const statusColor = step.status === 'SUCCEEDED'
+            ? chalk.green
+            : step.status === 'FAILED' || step.status === 'ERRORED'
+                ? chalk.red
+                : step.status === 'RUNNING'
+                    ? chalk.yellow
+                    : step.status === 'SKIPPED'
+                        ? chalk.dim
+                        : chalk.white;
+        table.addRow({
+            name: step.name,
+            status: statusColor(step.status),
+            started: step.started_at ? formatRelativeTime(step.started_at) : '-',
+            completed: step.completed_at ? formatRelativeTime(step.completed_at) : '-',
+        });
+    });
+    table.printTable();
+}
 /**
  * Human-friendly output writer
  *

package/dist/lib/session-events.d.ts

@@ -85,6 +85,7 @@ export interface RuntimeWaitingEvent extends BaseEvent {
 export interface RuntimeErrorEvent extends BaseEvent {
     type: 'runtime_error';
     content: string;
+    stack: string | null;
 }
 export interface RuntimeDoneEvent extends BaseEvent {
     type: 'runtime_done';

package/dist/lib/table.d.ts

@@ -0,0 +1,22 @@
+interface ColumnConfig {
+    name: string;
+    title: string;
+    alignment?: 'left';
+    color?: string;
+}
+/**
+ * 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;
+    private rows;
+    constructor(config: {
+        columns: ColumnConfig[];
+    });
+    addRow(row: Record<string, string>): void;
+    render(): string;
+    printTable(): void;
+}
+export {};
+//# sourceMappingURL=table.d.ts.map

package/dist/lib/table.js

@@ -0,0 +1,60 @@
+// Copyright 2026 Guild.ai
+// SPDX-License-Identifier: Apache-2.0
+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;
+    rows = [];
+    constructor(config) {
+        this.columns = config.columns;
+    }
+    addRow(row) {
+        const sanitized = {};
+        for (const [k, v] of Object.entries(row)) {
+            sanitized[k] = v.replace(/[\r\n]+/g, ' ').trim();
+        }
+        this.rows.push(sanitized);
+    }
+    render() {
+        const widths = this.columns.map((col) => {
+            const headerWidth = stringWidth(col.title);
+            const maxData = this.rows.reduce((max, row) => Math.max(max, stringWidth(row[col.name] ?? '')), 0);
+            return Math.max(headerWidth, maxData);
+        });
+        const pad = (text, width) => {
+            const visible = stringWidth(text);
+            return visible >= width ? text : text + ' '.repeat(width - visible);
+        };
+        const top = '┌' + widths.map((w) => '─'.repeat(w + 2)).join('┬') + '┐';
+        const mid = '├' + widths.map((w) => '─'.repeat(w + 2)).join('┼') + '┤';
+        const bot = '└' + widths.map((w) => '─'.repeat(w + 2)).join('┴') + '┘';
+        const header = '│' +
+            this.columns
+                .map((col, i) => ' ' + chalk.bold(pad(col.title, widths[i])) + ' ')
+                .join('│') +
+            '│';
+        const dataRows = this.rows.map((row) => '│' +
+            this.columns
+                .map((col, i) => {
+                const val = row[col.name] ?? '';
+                const padded = pad(val, widths[i]);
+                if (col.color && col.color in chalk) {
+                    return (' ' +
+                        chalk[col.color](padded) +
+                        ' ');
+                }
+                return ' ' + padded + ' ';
+            })
+                .join('│') +
+            '│');
+        return [top, header, mid, ...dataRows, bot].join('\n');
+    }
+    printTable() {
+        console.log(this.render());
+    }
+}
+//# sourceMappingURL=table.js.map

package/docs/CLI_WORKFLOW.md

@@ -11,7 +11,7 @@ For local agent development using the Guild CLI. This workflow manages agent cod
 
 If Guild MCP tools are available (check for tools prefixed with `guild_`), use them for **read operations**: searching agents, listing workspaces, reading contexts, checking sessions, viewing credentials. MCP tools are faster and don't require shell execution.
 
-Use the **CLI** (via Bash) for **local development operations**: `guild agent create`, `guild agent save`, `guild agent test`, `guild agent pull`, `guild agent clone`. These involve the local filesystem and git, which MCP can't do.
+Use the **CLI** (via Bash) for **local development operations**: `guild agent init`, `guild agent save`, `guild agent test`, `guild agent pull`, `guild agent clone`. These involve the local filesystem and git, which MCP can't do.
 
 ## CRITICAL: Always Use the Guild CLI
 
@@ -19,7 +19,7 @@ Use the **CLI** (via Bash) for **local development operations**: `guild agent cr
 
 ```bash
 # Create a new agent
-guild agent create my-agent --template LLM
+guild agent init --name my-agent --template LLM
 
 # Clone an existing agent
 guild agent clone guildai/dev-assistant
@@ -66,11 +66,11 @@ guild setup --claude-md
 ### Creating Agents
 
 ```bash
-# Create with template (interactive — prompts for template if omitted)
-guild agent create my-agent
-guild agent create my-agent --template LLM
-guild agent create my-agent --template AUTO_MANAGED_STATE
-guild agent create my-agent --template BLANK
+# Create and initialize a new agent (interactive — prompts for name and template)
+guild agent init
+guild agent init --name my-agent --template LLM
+guild agent init --name my-agent --template AUTO_MANAGED_STATE
+guild agent init --name my-agent --template BLANK
 
 # Fork an existing agent
 guild agent init --fork owner/agent-name
@@ -145,7 +145,7 @@ guild agent chat "Hello, can you help me?"
 
 ## File Structure
 
-After `guild agent create`, you get:
+After `guild agent init`, you get:
 
 ```
 my-agent/
@@ -175,7 +175,7 @@ Working tree is clean and there are no unpushed commits. Make a code change, com
 You're not in an agent directory. Either:
 
 - `cd` into the agent directory
-- Run `guild agent create` to create one
+- Run `guild agent init` to create one
 
 ### Validation Failed
 

package/docs/skills/agent-dev.md

@@ -11,7 +11,7 @@ Build agents for Guild using the CLI. **Always use the Guild CLI for agent opera
 
 If Guild MCP tools are available (check for tools prefixed with `guild_`), use them for **read operations**: searching agents, listing workspaces, reading contexts, checking sessions, viewing credentials. MCP tools are faster and don't require shell execution.
 
-Use the **CLI** (via Bash) for **local development operations**: `guild agent create`, `guild agent save`, `guild agent test`, `guild agent pull`, `guild agent clone`. These involve the local filesystem and git, which MCP can't do.
+Use the **CLI** (via Bash) for **local development operations**: `guild agent init`, `guild agent save`, `guild agent test`, `guild agent pull`, `guild agent clone`. These involve the local filesystem and git, which MCP can't do.
 
 ## When to Use This
 
@@ -39,17 +39,14 @@ guild setup --claude-md
 ### Creating Agents
 
 ```bash
-# Create from template (interactive - prompts for template)
-guild agent create my-agent
-
-# Create with specific template
-guild agent create my-agent --template LLM
-guild agent create my-agent --template AUTO_MANAGED_STATE
-guild agent create my-agent --template BLANK
-
-# Initialize local workspace for existing agent
+# Create and initialize a new agent (interactive - prompts for name and template)
 guild agent init
 
+# Create with specific name and template
+guild agent init --name my-agent --template LLM
+guild agent init --name my-agent --template AUTO_MANAGED_STATE
+guild agent init --name my-agent --template BLANK
+
 # Initialize with fork of existing agent
 guild agent init --fork owner/agent-name
 
@@ -98,7 +95,7 @@ guild agent chat "Hello, can you help me?"
 
 ### For Creating and Modifying
 
-- ✅ `guild agent create`, `guild agent init`, `guild agent clone`
+- ✅ `guild agent init`, `guild agent clone`
 - ✅ `git add`, `git commit` (manage your own working tree)
 - ✅ `guild agent save` (push commits and create a version)
 - ✅ `guild agent save -A --message "desc"` (stage+commit+push in one step)
@@ -1681,7 +1678,7 @@ export default agent({ run: async (input, task) => { ... } })
 
 ## File Structure
 
-After `guild agent create` + `guild agent init`:
+After `guild agent init`:
 
 ```
 my-agent/
@@ -1705,9 +1702,8 @@ my-agent/
 ```bash
 guild setup                                        # Install coding assistant skills
 guild setup --claude-md                            # Also create CLAUDE.md template
-guild agent create <name>                          # Create new agent (prompts for template)
-guild agent create <name> --template LLM           # Create with specific template
-guild agent init                                   # Initialize local workspace
+guild agent init                                   # Create and initialize a new agent
+guild agent init --name <name> --template LLM      # Create with specific name and template
 guild agent init --fork <agent-id>                 # Fork existing agent
 guild agent pull                                   # Pull remote changes
 guild agent save                                   # Push commits and create a draft version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guildai/cli",
-  "version": "0.5.10",
+  "version": "0.5.12",
   "description": "Guild.ai CLI - Build, test, and deploy AI agents",
   "type": "module",
   "main": "dist/index.js",
@@ -59,9 +59,7 @@
     "@napi-rs/keyring": "^1.2.0",
     "axios": "^1.13.2",
     "chalk": "^5.3.0",
-    "cli-table3": "^0.6.5",
     "commander": "^12.1.0",
-    "console-table-printer": "^2.15.0",
     "dotenv": "^16.4.7",
     "execa": "^9.6.1",
     "ink": "^5.0.1",
@@ -76,6 +74,7 @@
     "react": "^18.3.1",
     "sharp": "^0.34.5",
     "shell-quote": "^1.8.2",
+    "string-width": "^7.2.0",
     "svg-pathdata": "^8.0.0",
     "svgdom": "^0.1.22",
     "ws": "^8.18.0",

package/dist/commands/agent/create.d.ts

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

package/dist/commands/agent/create.js

@@ -1,132 +0,0 @@
-// Copyright 2026 Guild.ai
-// SPDX-License-Identifier: Apache-2.0
-import { Command } from 'commander';
-import inquirer from 'inquirer';
-import { GuildAPIClient } from '../../lib/api-client.js';
-import { getGuildcoreUrl } from '../../lib/config.js';
-import { handleAxiosError, ErrorCodes } from '../../lib/errors.js';
-import { pollAgentStatus } from '../../lib/polling.js';
-import { createOutputWriter } from '../../lib/output.js';
-const TEMPLATE_CHOICES = [
-    {
-        name: 'LLM - Simple language model agent (recommended)',
-        value: 'LLM',
-        short: 'LLM',
-    },
-    {
-        name: 'Auto-managed state - Agent with automatic state management',
-        value: 'AUTO_MANAGED_STATE',
-        short: 'Auto-managed state',
-    },
-    {
-        name: 'Blank - Start from scratch',
-        value: 'BLANK',
-        short: 'Blank',
-    },
-];
-function isInteractive() {
-    return process.stdin.isTTY === true;
-}
-async function promptForTemplate() {
-    const { template } = await inquirer.prompt([
-        {
-            type: 'list',
-            name: 'template',
-            message: 'Select agent template:',
-            choices: TEMPLATE_CHOICES,
-            default: 'LLM',
-        },
-    ]);
-    return template;
-}
-export function createAgentCreateCommand() {
-    const cmd = new Command('create');
-    cmd
-        .description('Create a new agent')
-        .argument('<name>', 'Agent name')
-        .option('--description <text>', 'Agent description')
-        .option('--owner-id <id>', 'Owner ID (user or organization, defaults to current user)')
-        .option('--template <template>', 'Agent template (LLM, AUTO_MANAGED_STATE, BLANK)')
-        .option('--no-wait', 'Return immediately without waiting for initialization')
-        .action(async (name, options) => {
-        const output = createOutputWriter();
-        const baseUrl = getGuildcoreUrl();
-        const client = new GuildAPIClient({ baseUrl });
-        try {
-            // Get owner_id: use --owner-id option or default to current user
-            let ownerId = options.ownerId;
-            if (!ownerId) {
-                const me = (await client.get('/me'));
-                ownerId = me.id;
-            }
-            // Determine template: use --template option, prompt if interactive, or error
-            let template = options.template;
-            if (!template) {
-                if (isInteractive()) {
-                    template = await promptForTemplate();
-                }
-                else {
-                    output.error('Error: --template is required in non-interactive mode', `Provide a template:\n  guild agent create ${name} --template LLM\n\nAvailable templates:\n  • LLM - Simple language model agent (recommended)\n  • AUTO_MANAGED_STATE - Agent with automatic state management\n  • BLANK - Start from scratch`);
-                    process.exit(1);
-                }
-            }
-            // Normalize template to uppercase for case-insensitive matching
-            template = template.toUpperCase();
-            // Validate template
-            const validTemplates = [
-                'LLM',
-                'AUTO_MANAGED_STATE',
-                'BLANK',
-            ];
-            if (!validTemplates.includes(template)) {
-                output.error(`Error: Invalid template '${template}'`, 'Valid templates:\n  • LLM\n  • AUTO_MANAGED_STATE\n  • BLANK');
-                process.exit(1);
-            }
-            const response = await client.post('/agents', {
-                name,
-                owner_id: ownerId,
-                description: options.description || 'No description provided',
-                template,
-            });
-            // By default, poll until agent is ready (unless --no-wait is passed)
-            if (options.wait !== false) {
-                const pollResult = await pollAgentStatus(response.id, 'READY');
-                if (pollResult.success && pollResult.response) {
-                    // Display the updated response with READY status
-                    output.data(pollResult.response);
-                }
-                else {
-                    // Polling failed or timed out - this is an error
-                    output.error('Agent initialization failed or timed out', `Check status: guild agent get ${response.id}`);
-                    output.data(response);
-                    process.exit(1);
-                }
-            }
-            else {
-                // --no-wait: return immediately without polling
-                output.data(response);
-            }
-        }
-        catch (error) {
-            const formattedError = handleAxiosError(error);
-            // Provide specific error messages based on error code
-            if (formattedError.code === ErrorCodes.AUTH_REQUIRED) {
-                output.error('Not logged in.', 'Please authenticate first:\n  guild auth login');
-            }
-            else if (formattedError.code === ErrorCodes.CONN_REFUSED) {
-                output.error('Cannot connect to Guild servers');
-            }
-            else if (formattedError.code === ErrorCodes.API_ERROR &&
-                formattedError.details.includes('already exists')) {
-                output.error(`Agent name '${name}' already exists.`, `Try a different name:\n  guild agent create ${name}-v2`);
-            }
-            else {
-                // Generic error with details from server
-                output.error(`Failed to create agent: ${formattedError.details}`);
-            }
-            process.exit(1);
-        }
-    });
-    return cmd;
-}
-//# sourceMappingURL=create.js.map