@guildai/cli 0.11.0 → 0.12.0

package/dist/lib/output-mode.js

@@ -1,54 +0,0 @@
-// Copyright 2026 Guild.ai
-// SPDX-License-Identifier: Apache-2.0
-/**
- * Output mode detection for the CLI
- *
- * Interactive mode (default): Colors, tables, spinners, interactive
- * JSON mode (--mode json or --json): Pure JSON, non-interactive, machine-readable
- * JSONL mode (--mode jsonl): Line-delimited JSON for streaming
- */
-import { getConfigFlag } from './config-cache.js';
-/**
- * Detect output mode from CLI flags or config
- *
- * Priority: --mode <value> > --json (backward compat) > config
- * Does NOT auto-detect pipes (user must request JSON explicitly).
- */
-export function getOutputMode() {
-    // Check --mode <value> first (primary flag)
-    const modeIndex = process.argv.indexOf('--mode');
-    if (modeIndex !== -1 && modeIndex + 1 < process.argv.length) {
-        const value = process.argv[modeIndex + 1];
-        if (value === 'json' || value === 'jsonl') {
-            return value;
-        }
-        // --mode interactive falls through to default
-    }
-    // Backward compat: --json is equivalent to --mode json
-    if (process.argv.includes('--json') || getConfigFlag('json')) {
-        return 'json';
-    }
-    return 'interactive';
-}
-/**
- * Check if the current output mode is machine-readable (json or jsonl).
- *
- * Use this in list/get commands instead of `getOutputMode() === 'json'`
- * so that both --mode json and --mode jsonl trigger non-interactive output.
- */
-export function isMachineReadable() {
-    const mode = getOutputMode();
-    return mode === 'json' || mode === 'jsonl';
-}
-/**
- * Check if quiet mode is enabled (CLI flag or config)
- *
- * Quiet mode suppresses progress and log messages to stderr.
- * Errors are still shown.
- */
-export function isQuietMode() {
-    return (process.argv.includes('--quiet') ||
-        process.argv.includes('-q') ||
-        getConfigFlag('quiet'));
-}
-//# sourceMappingURL=output-mode.js.map

package/dist/lib/output.js

@@ -1,622 +0,0 @@
-// Copyright 2026 Guild.ai
-// SPDX-License-Identifier: Apache-2.0
-import chalk from 'chalk';
-import { Table } from './table.js';
-import { getOutputMode, isQuietMode } from './output-mode.js';
-import { createSpinner } from './progress.js';
-import { brand, hyperlink } from './colors.js';
-import { getDashboardUrl } from './config.js';
-/**
- * Format a relative timestamp (e.g. "2d ago", "3mo ago")
- */
-function formatRelativeTime(dateStr) {
-    const date = new Date(dateStr);
-    const now = new Date();
-    const diffMs = now.getTime() - date.getTime();
-    const diffMins = Math.floor(diffMs / 60000);
-    const diffHours = Math.floor(diffMins / 60);
-    const diffDays = Math.floor(diffHours / 24);
-    const diffWeeks = Math.floor(diffDays / 7);
-    const diffMonths = Math.floor(diffDays / 30);
-    if (diffMins < 1)
-        return 'just now';
-    if (diffMins < 60)
-        return `${diffMins}m ago`;
-    if (diffHours < 24)
-        return `${diffHours}h ago`;
-    if (diffDays < 7)
-        return `${diffDays}d ago`;
-    if (diffWeeks < 5)
-        return `${diffWeeks}w ago`;
-    return `${diffMonths}mo ago`;
-}
-/**
- * Truncate a string to a max length, appending ellipsis if needed
- */
-function truncate(str, maxLen) {
-    if (str.length <= 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.
- */
-export function formatAgentTable(agents, pagination, showArchived = false) {
-    if (agents.length === 0) {
-        console.log(chalk.dim('No agents found'));
-        return;
-    }
-    const table = new Table({
-        columns: [
-            { name: 'name', title: 'NAME', alignment: 'left' },
-            { name: 'owner', title: 'OWNER', alignment: 'left', color: 'cyan' },
-            {
-                name: 'description',
-                title: 'DESCRIPTION',
-                alignment: 'left',
-            },
-            { name: 'updated', title: 'UPDATED', alignment: 'left' },
-        ],
-    });
-    const base = getDashboardUrl();
-    agents.forEach((agent) => {
-        const rawName = agent.full_name || agent.name;
-        const agentUrl = agent.full_name ? `${base}/agents/${agent.full_name}` : '';
-        const linkedName = agentUrl ? hyperlink(rawName, agentUrl) : rawName;
-        const displayName = showArchived && agent.is_archived
-            ? linkedName + chalk.dim(' [archived]')
-            : linkedName;
-        table.addRow({
-            name: displayName,
-            owner: agent.owner?.name || '',
-            description: truncate(agent.description || '', 40),
-            updated: agent.updated_at ? formatRelativeTime(agent.updated_at) : '',
-        });
-    });
-    table.printTable();
-    printPaginationFooter(pagination, agents.length, 'agents');
-}
-/**
- * Format an integration list as a human-readable table.
- * Used by integration list command.
- */
-export function formatIntegrationTable(integrations, pagination) {
-    if (integrations.length === 0) {
-        console.log(chalk.dim('No integrations found'));
-        return;
-    }
-    const table = new Table({
-        columns: [
-            { name: 'name', title: 'NAME', alignment: 'left' },
-            { name: 'description', title: 'DESCRIPTION', alignment: 'left' },
-            { name: 'visibility', title: 'VISIBILITY', alignment: 'left' },
-            { name: 'owner', title: 'OWNER', alignment: 'left', color: 'cyan' },
-            { name: 'updated', title: 'UPDATED', alignment: 'left' },
-        ],
-    });
-    integrations.forEach((integration) => {
-        table.addRow({
-            name: integration.name,
-            description: truncate(integration.description || '', 40),
-            visibility: integration.is_public ? 'public' : 'internal',
-            owner: integration.owner?.name || '',
-            updated: integration.updated_at ? formatRelativeTime(integration.updated_at) : '',
-        });
-    });
-    table.printTable();
-    printPaginationFooter(pagination, integrations.length, 'integrations');
-}
-/**
- * Format an integration version list as a human-readable table.
- * Used by integration version list command.
- */
-export function formatIntegrationVersionTable(versions, pagination, integrationName) {
-    if (versions.length === 0) {
-        console.log(chalk.dim('No versions found'));
-        return;
-    }
-    console.log(chalk.bold(`Versions for ${integrationName}`));
-    console.log();
-    const table = new Table({
-        columns: [
-            { name: 'id', title: 'ID', alignment: 'left' },
-            { name: 'version', title: 'VERSION', alignment: 'left' },
-            { name: 'author', title: 'AUTHOR', alignment: 'left', color: 'cyan' },
-            { name: 'status', title: 'STATUS', alignment: 'left' },
-            { name: 'published', title: 'PUBLISHED', alignment: 'left' },
-            { name: 'created', title: 'CREATED', alignment: 'left' },
-        ],
-    });
-    versions.forEach((v) => {
-        let statusLabel;
-        switch (v.validation_status) {
-            case 'PASSED':
-                statusLabel = chalk.green('Valid');
-                break;
-            case 'FAILED':
-                statusLabel = chalk.red('Failed');
-                break;
-            case 'RUNNING':
-                statusLabel = chalk.yellow('Building');
-                break;
-            default:
-                statusLabel = chalk.dim('—');
-        }
-        table.addRow({
-            id: v.id,
-            version: v.version_number || 'Draft',
-            author: v.author?.name || '',
-            status: statusLabel,
-            published: v.published_at ? formatRelativeTime(v.published_at) : chalk.dim('—'),
-            created: v.created_at ? formatRelativeTime(v.created_at) : '',
-        });
-    });
-    table.printTable();
-    printPaginationFooter(pagination, versions.length, 'versions');
-}
-/**
- * Format an agent version list as a human-readable table.
- * Used by agent versions command.
- */
-export function formatVersionTable(versions, pagination) {
-    if (versions.length === 0) {
-        console.log(chalk.dim('No versions found'));
-        return;
-    }
-    const table = new Table({
-        columns: [
-            { name: 'id', title: 'ID', alignment: 'left' },
-            { name: 'version', title: 'VERSION', alignment: 'left', color: 'cyan' },
-            { name: 'status', title: 'STATUS', alignment: 'left' },
-            { name: 'validation', title: 'VALIDATION', alignment: 'left' },
-            { name: 'summary', title: 'SUMMARY', alignment: 'left' },
-            { name: 'created', title: 'CREATED', alignment: 'left' },
-        ],
-    });
-    versions.forEach((v) => {
-        const validationColor = v.validation_status === 'PASSED'
-            ? chalk.green
-            : v.validation_status === 'FAILED'
-                ? chalk.red
-                : chalk.dim;
-        table.addRow({
-            id: v.id,
-            version: v.version_number || '-',
-            status: v.status,
-            validation: validationColor(v.validation_status || '-'),
-            summary: truncate(v.summary || '', 30),
-            created: v.created_at ? formatRelativeTime(v.created_at) : '',
-        });
-    });
-    table.printTable();
-    printPaginationFooter(pagination, versions.length, 'versions');
-}
-/**
- * Format a context list as a human-readable table.
- * Used by workspace context list command.
- */
-export function formatContextTable(contexts, pagination) {
-    if (contexts.length === 0) {
-        console.log(chalk.dim('No contexts found'));
-        return;
-    }
-    const table = new Table({
-        columns: [
-            { name: 'id', title: 'ID', alignment: 'left' },
-            { name: 'status', title: 'STATUS', alignment: 'left', color: 'cyan' },
-            { name: 'type', title: 'TYPE', alignment: 'left' },
-            { name: 'created', title: 'CREATED', alignment: 'left' },
-        ],
-    });
-    contexts.forEach((ctx) => {
-        table.addRow({
-            id: ctx.id,
-            status: ctx.status,
-            type: ctx.type || '-',
-            created: ctx.created_at ? formatRelativeTime(ctx.created_at) : '',
-        });
-    });
-    table.printTable();
-    printPaginationFooter(pagination, contexts.length, 'contexts');
-}
-/**
- * Format a workspace agent list as a human-readable table.
- * Used by workspace agent list command.
- */
-export function formatWorkspaceAgentTable(agents) {
-    if (agents.length === 0) {
-        console.log(chalk.dim('No agents installed in this workspace'));
-        return;
-    }
-    const table = new Table({
-        columns: [
-            { name: 'name', title: 'NAME', alignment: 'left' },
-            { name: 'version', title: 'VERSION', alignment: 'left', color: 'cyan' },
-            { name: 'auto_update', title: 'AUTO-UPDATE', alignment: 'left' },
-        ],
-    });
-    const base = getDashboardUrl();
-    agents.forEach((wa) => {
-        const name = wa.agent.full_name || wa.agent.name;
-        const agentUrl = wa.agent.full_name ? `${base}/agents/${wa.agent.full_name}` : '';
-        table.addRow({
-            name: agentUrl ? hyperlink(name, agentUrl) : name,
-            version: wa.agent_version.version_number || wa.agent_version.id,
-            auto_update: wa.should_autoupdate ? chalk.green('yes') : chalk.dim('no'),
-        });
-    });
-    table.printTable();
-}
-/**
- * Format a workspace list as a human-readable table.
- * Used by workspace list command.
- */
-export function formatWorkspaceTable(workspaces, pagination) {
-    if (workspaces.length === 0) {
-        console.log(chalk.dim('No workspaces found'));
-        return;
-    }
-    const table = new Table({
-        columns: [
-            { name: 'name', title: 'NAME', alignment: 'left' },
-            { name: 'full_name', title: 'FULL NAME', alignment: 'left', color: 'cyan' },
-            { name: 'owner', title: 'OWNER', alignment: 'left' },
-            { name: 'id', title: 'ID', alignment: 'left' },
-        ],
-    });
-    workspaces.forEach((workspace) => {
-        table.addRow({
-            name: workspace.name,
-            full_name: workspace.full_name || workspace.name,
-            owner: workspace.owner?.name || '',
-            id: workspace.id,
-        });
-    });
-    table.printTable();
-    printPaginationFooter(pagination, workspaces.length, 'workspaces');
-}
-/**
- * Format a session list as a human-readable table.
- * Used by session list command.
- */
-export function formatSessionTable(sessions, pagination) {
-    if (sessions.length === 0) {
-        console.log(chalk.dim('No sessions found'));
-        return;
-    }
-    const table = new Table({
-        columns: [
-            { name: 'id', title: 'ID', alignment: 'left' },
-            { name: 'type', title: 'TYPE', alignment: 'left', color: 'cyan' },
-            { name: 'name', title: 'NAME', alignment: 'left' },
-            { name: 'workspace', title: 'WORKSPACE', alignment: 'left' },
-            { name: 'created', title: 'CREATED', alignment: 'left' },
-        ],
-    });
-    const base = getDashboardUrl();
-    sessions.forEach((session) => {
-        table.addRow({
-            id: hyperlink(session.id, `${base}/sessions/${session.id}`),
-            type: session.session_type,
-            name: session.name ? truncate(session.name, 30) : '-',
-            workspace: session.workspace?.name || '',
-            created: session.created_at ? formatRelativeTime(session.created_at) : '',
-        });
-    });
-    table.printTable();
-    printPaginationFooter(pagination, sessions.length, 'sessions');
-}
-/**
- * Format a task list as a human-readable table.
- * Used by session tasks command.
- */
-export function formatTaskTable(tasks, pagination) {
-    if (tasks.length === 0) {
-        console.log(chalk.dim('No tasks found'));
-        return;
-    }
-    const table = new Table({
-        columns: [
-            { name: 'id', title: 'ID', alignment: 'left' },
-            { name: 'name', title: 'NAME', alignment: 'left' },
-            { name: 'status', title: 'STATUS', alignment: 'left' },
-            { name: 'tokens', title: 'TOKENS', alignment: 'left' },
-            { name: 'created', title: 'CREATED', alignment: 'left' },
-        ],
-    });
-    tasks.forEach((task) => {
-        const name = task.entity_type === 'EntTaskAgent'
-            ? task.agent?.full_name || task.agent?.name || '-'
-            : task.tool_name;
-        const statusColor = task.status === 'DONE'
-            ? chalk.green
-            : task.status === 'ERROR'
-                ? chalk.red
-                : task.status === 'RUNNING' ||
-                    task.status === 'STARTED' ||
-                    task.status === 'WAITING'
-                    ? chalk.yellow
-                    : chalk.dim;
-        table.addRow({
-            id: task.id,
-            name,
-            status: statusColor(task.status),
-            tokens: task.token_usage ? task.token_usage.total_tokens.toLocaleString() : '-',
-            created: task.created_at ? formatRelativeTime(task.created_at) : '',
-        });
-    });
-    table.printTable();
-    printPaginationFooter(pagination, tasks.length, 'tasks');
-}
-/**
- * Format a trigger list as a human-readable table.
- * Used by trigger list command.
- */
-export function formatTriggerTable(triggers, pagination) {
-    if (triggers.length === 0) {
-        console.log(chalk.dim('No triggers found'));
-        return;
-    }
-    const table = new Table({
-        columns: [
-            { name: 'id', title: 'ID', alignment: 'left' },
-            { name: 'type', title: 'TYPE', alignment: 'left', color: 'cyan' },
-            { name: 'agent', title: 'AGENT', alignment: 'left' },
-            { name: 'status', title: 'STATUS', alignment: 'left' },
-            { name: 'created', title: 'CREATED', alignment: 'left' },
-        ],
-    });
-    const base = getDashboardUrl();
-    triggers.forEach((trigger) => {
-        const status = trigger.disabled_reason
-            ? chalk.yellow('disabled')
-            : trigger.deactivated_at
-                ? chalk.dim('inactive')
-                : chalk.green('active');
-        const agentName = trigger.agent?.full_name || trigger.agent?.name || '';
-        const agentUrl = trigger.agent?.full_name
-            ? `${base}/agents/${trigger.agent.full_name}`
-            : '';
-        const ownerSegment = trigger.workspace.owner.type === 'organization' ? 'organizations' : 'users';
-        const triggerUrl = `${base}/${ownerSegment}/${trigger.workspace.owner.name}/workspaces/${trigger.workspace.name}/triggers`;
-        table.addRow({
-            id: hyperlink(trigger.id, triggerUrl),
-            type: trigger.type,
-            agent: agentUrl ? hyperlink(agentName, agentUrl) : agentName,
-            status,
-            created: trigger.created_at ? formatRelativeTime(trigger.created_at) : '',
-        });
-    });
-    table.printTable();
-    printPaginationFooter(pagination, triggers.length, 'triggers');
-}
-export function formatCredentialsTable(credentials, pagination) {
-    if (credentials.length === 0) {
-        console.log(chalk.dim('No credentials found'));
-        return;
-    }
-    const table = new Table({
-        columns: [
-            { name: 'id', title: 'ID', alignment: 'left' },
-            { name: 'integration', title: 'INTEGRATION', alignment: 'left' },
-            { name: 'creator', title: 'CREATOR', alignment: 'left', color: 'cyan' },
-            { name: 'created', title: 'CREATED', alignment: 'left' },
-        ],
-    });
-    credentials.forEach((cred) => {
-        table.addRow({
-            id: cred.id,
-            integration: cred.integration.full_name,
-            creator: cred.creator.name,
-            created: formatRelativeTime(cred.created_at),
-        });
-    });
-    table.printTable();
-    printPaginationFooter(pagination, credentials.length, 'credentials');
-}
-export function formatPoliciesTable(policies, pagination) {
-    if (policies.length === 0) {
-        console.log(chalk.dim('No policies found'));
-        return;
-    }
-    const table = new Table({
-        columns: [
-            { name: 'id', title: 'ID', alignment: 'left' },
-            { name: 'decision', title: 'DECISION', alignment: 'left' },
-            { name: 'operations', title: 'OPERATIONS', alignment: 'left' },
-            { name: 'workspaces', title: 'WORKSPACES', alignment: 'left' },
-            { name: 'agents', title: 'AGENTS', alignment: 'left' },
-            { name: 'resources', title: 'RESOURCES', alignment: 'left' },
-            { name: 'created', title: 'CREATED', alignment: 'left' },
-        ],
-    });
-    policies.forEach((policy) => {
-        const decisionColor = policy.decision === 'ALLOW' ? chalk.green : chalk.red;
-        table.addRow({
-            id: policy.id,
-            decision: decisionColor(policy.decision),
-            operations: policy.operations
-                ? truncate(policy.operations.join(', '), 30)
-                : chalk.dim('all'),
-            workspaces: policy.workspaces.length > 0
-                ? truncate(policy.workspaces.map((w) => w.full_name || w.name).join(', '), 20)
-                : chalk.dim('all'),
-            agents: policy.agents.length > 0
-                ? truncate(policy.agents.map((a) => a.full_name || a.name).join(', '), 20)
-                : chalk.dim('all'),
-            resources: policy.resources
-                ? truncate(Object.entries(policy.resources)
-                    .map(([k, v]) => `${k}: ${v.join(', ')}`)
-                    .join('; '), 30)
-                : chalk.dim('none'),
-            created: formatRelativeTime(policy.created_at),
-        });
-    });
-    table.printTable();
-    printPaginationFooter(pagination, policies.length, 'policies');
-}
-/**
- * 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();
-}
-/**
- * Format validation step logs as human-readable output.
- * Prints each step's name, colored status, and full log content.
- * Used by the `guild agent logs` command.
- */
-export function formatValidationLogs(steps) {
-    if (steps.length === 0) {
-        console.log(chalk.dim('No steps found'));
-        return;
-    }
-    const hr = chalk.dim('─'.repeat(60));
-    steps.forEach((step, index) => {
-        if (index > 0) {
-            console.log(hr);
-        }
-        const statusColor = step.status === 'SUCCEEDED'
-            ? chalk.green
-            : step.status === 'FAILED' || step.status === 'ERRORED'
-                ? chalk.red
-                : step.status === 'RUNNING'
-                    ? chalk.yellow
-                    : chalk.dim;
-        console.log(`${chalk.bold(step.name)}  ${statusColor(step.status)}`);
-        if (step.content) {
-            console.log();
-            console.log(step.content);
-        }
-    });
-}
-/**
- * Human-friendly output writer
- *
- * Uses colors, symbols, and formatting for readability.
- * Progress goes to stderr.
- */
-export class InteractiveOutputWriter {
-    data(value) {
-        console.log(JSON.stringify(value, null, 2));
-    }
-    success(message, details) {
-        process.stderr.write(chalk.green('✓') + ' ' + message + '\n');
-        if (details) {
-            Object.entries(details).forEach(([k, v]) => {
-                process.stderr.write(`  ${k}: ${brand(String(v))}\n`);
-            });
-        }
-    }
-    error(message, details) {
-        console.error(chalk.red('✗'), message);
-        if (details) {
-            console.error(chalk.dim(details));
-        }
-    }
-    progress(message) {
-        if (!isQuietMode()) {
-            process.stderr.write(chalk.dim(message) + '\n');
-        }
-    }
-    spinner(message) {
-        if (isQuietMode()) {
-            return createNoopSpinner();
-        }
-        return createSpinner(message);
-    }
-}
-/**
- * JSON output writer
- *
- * Outputs pure JSON to stdout for machine consumption.
- * Progress goes to stderr as JSON (unless --quiet).
- */
-export class JSONOutputWriter {
-    data(value) {
-        console.log(JSON.stringify(value, null, 2));
-    }
-    success(message, details) {
-        process.stderr.write(JSON.stringify({ success: true, message, ...details }) + '\n');
-    }
-    error(message, details) {
-        process.stderr.write(JSON.stringify({ success: false, error: message, details }) + '\n');
-    }
-    progress(message) {
-        if (!isQuietMode()) {
-            process.stderr.write(JSON.stringify({ progress: message }) + '\n');
-        }
-    }
-    spinner(_message) {
-        // No-op spinner in JSON mode
-        return createNoopSpinner();
-    }
-}
-/**
- * Create output writer based on current mode
- */
-export function createOutputWriter() {
-    const mode = getOutputMode();
-    return mode === 'interactive'
-        ? new InteractiveOutputWriter()
-        : new JSONOutputWriter();
-}
-/**
- * Create a no-op spinner (for quiet/JSON modes)
- */
-function createNoopSpinner() {
-    return {
-        start: () => { },
-        succeed: () => { },
-        fail: () => { },
-        warn: () => { },
-        stop: () => { },
-        text: '',
-    };
-}
-//# sourceMappingURL=output.js.map