@guildai/cli 0.9.1 → 0.11.0

package/dist/commands/setup.js

@@ -79,9 +79,9 @@ const MCP_SERVER_CONFIG = {
     command: 'guild',
     args: ['mcp'],
 };
-async function setupMcp(options) {
+async function setupMcp(targetDir, options) {
     const output = createOutputWriter();
-    const mcpPath = path.join(process.cwd(), '.mcp.json');
+    const mcpPath = path.join(targetDir, '.mcp.json');
     let existing = {};
     const exists = await fileExists(mcpPath);
     if (exists) {
@@ -108,55 +108,74 @@ async function setupMcp(options) {
     }
     return 'created';
 }
-async function setup(options) {
+/**
+ * Run setup in a target directory. Exported so init/clone can call it.
+ * When called with `quiet: true`, suppresses progress output (used as a
+ * post-init/clone step where the caller handles its own progress UI).
+ */
+export async function runSetup(targetDir, options = {}) {
     const output = createOutputWriter();
-    if (options.agentsMd && !options.codex) {
+    const force = options.force ?? false;
+    const claudeMd = options.claudeMd ?? false;
+    const codex = options.codex ?? false;
+    const agentsMd = options.agentsMd ?? false;
+    const mcp = options.mcp ?? true;
+    const quiet = options.quiet ?? false;
+    if (agentsMd && !codex) {
         output.error('--agents-md requires --codex', 'Create Codex setup files with:\n  guild setup --codex --agents-md');
         process.exit(1);
     }
-    if (options.claudeMd && options.codex) {
+    if (claudeMd && codex) {
         output.error('--claude-md cannot be used with --codex', 'Create Claude setup with:\n  guild setup --claude-md\n\nCreate Codex setup with:\n  guild setup --codex --agents-md');
         process.exit(1);
     }
-    const skillFiles = options.codex ? CODEX_SKILL_FILES : CLAUDE_SKILL_FILES;
+    const skillFiles = codex ? CODEX_SKILL_FILES : CLAUDE_SKILL_FILES;
     // Verify source docs exist
     for (const file of skillFiles) {
         if (!(await fileExists(file.src))) {
-            output.error('Could not find Guild CLI docs. Reinstall the CLI: npm install -g @guildai/cli');
-            process.exit(1);
+            if (!quiet) {
+                output.error('Could not find Guild CLI docs. Reinstall the CLI: npm install -g @guildai/cli');
+            }
+            return { filesCreated: 0, filesSkipped: 0 };
         }
     }
-    output.progress('Setting up Guild CLI skills...');
-    output.progress('');
+    if (!quiet) {
+        output.progress('Setting up Guild CLI skills...');
+        output.progress('');
+    }
     let filesCreated = 0;
     let filesSkipped = 0;
     let codexProjectFilesChanged = false;
     // Copy skill files
     for (const file of skillFiles) {
-        const destPath = path.join(process.cwd(), file.dest);
+        const destPath = path.join(targetDir, file.dest);
         const exists = await fileExists(destPath);
-        if (exists && !options.force) {
-            output.progress(`${file.label} already exists (use --force to overwrite)`);
+        if (exists && !force) {
+            if (!quiet) {
+                output.progress(`${file.label} already exists (use --force to overwrite)`);
+            }
             filesSkipped++;
         }
         else {
             await fs.mkdir(path.dirname(destPath), { recursive: true });
             await fs.copyFile(file.src, destPath);
-            if (exists) {
-                output.success(`Updated ${file.label}`);
-            }
-            else {
-                output.success(`Created ${file.label}`);
+            if (!quiet) {
+                if (exists) {
+                    output.success(`Updated ${file.label}`);
+                }
+                else {
+                    output.success(`Created ${file.label}`);
+                }
             }
             filesCreated++;
-            if (options.codex) {
+            if (codex) {
                 codexProjectFilesChanged = true;
             }
         }
     }
-    // Handle --mcp flag
-    if (options.mcp) {
-        const result = await setupMcp({ force: options.force });
+    // Handle MCP config
+    if (mcp) {
+        const result = await setupMcp(targetDir, { force });
         if (result === 'created') {
             filesCreated++;
         }
@@ -165,53 +184,64 @@ async function setup(options) {
         }
     }
     // Handle CLAUDE.md template
-    if (options.claudeMd) {
-        const claudeMdPath = path.join(process.cwd(), 'CLAUDE.md');
+    if (claudeMd) {
+        const claudeMdPath = path.join(targetDir, 'CLAUDE.md');
         const exists = await fileExists(claudeMdPath);
         if (exists) {
-            output.progress('CLAUDE.md already exists (not overwriting)');
+            if (!quiet) {
+                output.progress('CLAUDE.md already exists (not overwriting)');
+            }
             filesSkipped++;
         }
         else {
             await fs.writeFile(claudeMdPath, CLAUDE_MD_TEMPLATE, 'utf-8');
-            output.success('Created CLAUDE.md');
+            if (!quiet) {
+                output.success('Created CLAUDE.md');
+            }
             filesCreated++;
         }
     }
     // Handle AGENTS.md template for Codex setup
-    if (options.agentsMd) {
-        const agentsMdPath = path.join(process.cwd(), 'AGENTS.md');
+    if (agentsMd) {
+        const agentsMdPath = path.join(targetDir, 'AGENTS.md');
         const exists = await fileExists(agentsMdPath);
         if (exists) {
-            output.progress('AGENTS.md already exists (not overwriting)');
+            if (!quiet) {
+                output.progress('AGENTS.md already exists (not overwriting)');
+            }
             filesSkipped++;
         }
         else {
             await fs.writeFile(agentsMdPath, AGENTS_MD_TEMPLATE, 'utf-8');
-            output.success('Created AGENTS.md');
+            if (!quiet) {
+                output.success('Created AGENTS.md');
+            }
             filesCreated++;
             codexProjectFilesChanged = true;
         }
     }
-    // Summary
-    output.progress('');
-    if (filesCreated > 0 && filesSkipped === 0) {
-        if (options.force) {
-            output.success('Guild CLI skills updated.');
+    // Summary (only in standalone mode)
+    if (!quiet) {
+        output.progress('');
+        if (filesCreated > 0 && filesSkipped === 0) {
+            if (force) {
+                output.success('Guild CLI skills updated.');
+            }
+            else {
+                output.success('Guild CLI skills installed. Your coding assistant can now drive agent development.');
+            }
+        }
+        else if (filesCreated === 0) {
+            output.progress('No files were modified. Use --force to overwrite existing files.');
         }
         else {
-            output.success('Guild CLI skills installed. Your coding assistant can now drive agent development.');
+            output.success('Guild CLI skills installed.');
+        }
+        if (codexProjectFilesChanged) {
+            output.progress('Restart Codex to pick up the new project instructions.');
         }
     }
-    else if (filesCreated === 0) {
-        output.progress('No files were modified. Use --force to overwrite existing files.');
-    }
-    else {
-        output.success('Guild CLI skills installed.');
-    }
-    if (codexProjectFilesChanged) {
-        output.progress('Restart Codex to pick up the new project instructions.');
-    }
+    return { filesCreated, filesSkipped };
 }
 export function createSetupCommand() {
     const cmd = new Command('setup');
@@ -223,7 +253,7 @@ export function createSetupCommand() {
         .option('--agents-md', 'With --codex, also create an AGENTS.md template in the project root', false)
         .option('--no-mcp', 'Skip MCP server configuration')
         .action(async (options) => {
-        await setup(options);
+        await runSetup(process.cwd(), options);
     });
     return cmd;
 }

package/dist/commands/trigger/list.js

@@ -5,15 +5,16 @@ import { GuildAPIClient } from '../../lib/api-client.js';
 import { getAuthToken } from '../../lib/auth.js';
 import { getWorkspaceId } from '../../lib/guild-config.js';
 import { handleAxiosError } from '../../lib/errors.js';
-import { getOutputMode } from '../../lib/output-mode.js';
+import { isMachineReadable } from '../../lib/output-mode.js';
 import { createOutputWriter, formatTriggerTable } from '../../lib/output.js';
+import { DEFAULT_PAGE_LIMIT } from '../../lib/api-types.js';
 export function createTriggerListCommand() {
     const cmd = new Command('list');
     cmd
         .description('List all triggers in a workspace')
         .option('--workspace <id>', 'Workspace ID or name')
-        .option('--limit <number>', 'Number of results to return', '20')
-        .option('--offset <number>', 'Offset for pagination', '0')
+        .option('--limit <number>', `Number of results to return (default: ${DEFAULT_PAGE_LIMIT})`, String(DEFAULT_PAGE_LIMIT))
+        .option('--offset <number>', 'Offset for pagination (default: 0)', '0')
         .action(async (options) => {
         const output = createOutputWriter();
         try {
@@ -38,7 +39,7 @@ export function createTriggerListCommand() {
             params.append('limit', options.limit);
             params.append('offset', options.offset);
             const response = await client.get(`/workspaces/${workspaceId}/triggers?${params.toString()}`);
-            if (getOutputMode() === 'json') {
+            if (isMachineReadable()) {
                 console.log(JSON.stringify(response, null, 2));
             }
             else {

package/dist/commands/trigger/sessions.js

@@ -5,13 +5,14 @@ import { GuildAPIClient } from '../../lib/api-client.js';
 import { getAuthToken } from '../../lib/auth.js';
 import { handleAxiosError, ErrorCodes } from '../../lib/errors.js';
 import { createOutputWriter } from '../../lib/output.js';
+import { DEFAULT_PAGE_LIMIT } from '../../lib/api-types.js';
 export function createTriggerSessionsCommand() {
     const cmd = new Command('sessions');
     cmd
         .description('List sessions spawned by a trigger')
         .argument('<trigger-id>', 'Trigger ID')
-        .option('--limit <number>', 'Number of results to return', '20')
-        .option('--offset <number>', 'Offset for pagination', '0')
+        .option('--limit <number>', `Number of results to return (default: ${DEFAULT_PAGE_LIMIT})`, String(DEFAULT_PAGE_LIMIT))
+        .option('--offset <number>', 'Offset for pagination (default: 0)', '0')
         .action(async (triggerId, options) => {
         const output = createOutputWriter();
         try {

package/dist/commands/workspace/agent/list.js

@@ -6,15 +6,16 @@ import { getAuthToken } from '../../../lib/auth.js';
 import { getWorkspaceId } from '../../../lib/guild-config.js';
 import { handleAxiosError, ErrorCodes } from '../../../lib/errors.js';
 import { createOutputWriter, formatWorkspaceAgentTable } from '../../../lib/output.js';
-import { getOutputMode } from '../../../lib/output-mode.js';
+import { isMachineReadable } from '../../../lib/output-mode.js';
 import { resolveWorkspaceId } from '../../../lib/workspace-helpers.js';
+import { DEFAULT_PAGE_LIMIT } from '../../../lib/api-types.js';
 export function createWorkspaceAgentListCommand() {
     const cmd = new Command('list');
     cmd
         .description('List agents in a workspace')
         .option('--workspace <id>', 'Workspace ID or name')
-        .option('--limit <number>', 'Number of results to return', '20')
-        .option('--offset <number>', 'Offset for pagination', '0')
+        .option('--limit <number>', `Number of results to return (default: ${DEFAULT_PAGE_LIMIT})`, String(DEFAULT_PAGE_LIMIT))
+        .option('--offset <number>', 'Offset for pagination (default: 0)', '0')
         .action(async (options) => {
         const output = createOutputWriter();
         try {
@@ -51,7 +52,7 @@ export function createWorkspaceAgentListCommand() {
             params.append('limit', options.limit);
             params.append('offset', options.offset);
             const response = await client.get(`/workspaces/${workspaceId}/workspace_agents?${params.toString()}`);
-            if (getOutputMode() === 'json') {
+            if (isMachineReadable()) {
                 output.data(response);
             }
             else {

package/dist/commands/workspace/context/list.js

@@ -3,15 +3,16 @@
 import { Command } from 'commander';
 import { GuildAPIClient } from '../../../lib/api-client.js';
 import { handleAxiosError, ErrorCodes } from '../../../lib/errors.js';
-import { getOutputMode } from '../../../lib/output-mode.js';
+import { isMachineReadable } from '../../../lib/output-mode.js';
 import { createOutputWriter, formatContextTable } from '../../../lib/output.js';
+import { DEFAULT_PAGE_LIMIT } from '../../../lib/api-types.js';
 export function createWorkspaceContextListCommand() {
     const cmd = new Command('list');
     cmd
         .description('List context versions for a workspace')
         .argument('<workspace>', 'Workspace ID or full name (e.g., owner/workspace-name)')
-        .option('--limit <number>', 'Number of results to return', '20')
-        .option('--offset <number>', 'Offset for pagination', '0')
+        .option('--limit <number>', `Number of results to return (default: ${DEFAULT_PAGE_LIMIT})`, String(DEFAULT_PAGE_LIMIT))
+        .option('--offset <number>', 'Offset for pagination (default: 0)', '0')
         .action(async (workspaceId, options) => {
         const output = createOutputWriter();
         try {
@@ -20,7 +21,7 @@ export function createWorkspaceContextListCommand() {
             params.append('limit', options.limit);
             params.append('offset', options.offset);
             const response = await client.get(`/workspaces/${workspaceId}/contexts?${params.toString()}`);
-            if (getOutputMode() === 'json') {
+            if (isMachineReadable()) {
                 output.data(response);
             }
             else {

package/dist/commands/workspace/list.js

@@ -3,14 +3,15 @@
 import { Command } from 'commander';
 import { GuildAPIClient } from '../../lib/api-client.js';
 import { handleAxiosError, ErrorCodes } from '../../lib/errors.js';
-import { getOutputMode } from '../../lib/output-mode.js';
+import { isMachineReadable } from '../../lib/output-mode.js';
 import { createOutputWriter, formatWorkspaceTable } from '../../lib/output.js';
+import { DEFAULT_PAGE_LIMIT } from '../../lib/api-types.js';
 export function createWorkspaceListCommand() {
     const cmd = new Command('list');
     cmd
         .description('List workspaces')
-        .option('--limit <number>', 'Number of results to return', '20')
-        .option('--offset <number>', 'Offset for pagination', '0')
+        .option('--limit <number>', `Number of results to return (default: ${DEFAULT_PAGE_LIMIT})`, String(DEFAULT_PAGE_LIMIT))
+        .option('--offset <number>', 'Offset for pagination (default: 0)', '0')
         .option('--owner <name>', 'Filter workspaces by owner name (case-insensitive)')
         .action(async (options) => {
         const output = createOutputWriter();
@@ -43,7 +44,7 @@ export function createWorkspaceListCommand() {
                 params.append('offset', options.offset);
                 response = await client.get(`/me/workspaces?${params.toString()}`);
             }
-            if (getOutputMode() === 'json') {
+            if (isMachineReadable()) {
                 console.log(JSON.stringify(response, null, 2));
             }
             else {

package/dist/index.js

@@ -24,6 +24,7 @@ import { createAgentForkCommand } from './commands/agent/fork.js';
 import { createAgentPublishCommand } from './commands/agent/publish.js';
 import { createAgentUnpublishCommand } from './commands/agent/unpublish.js';
 import { createAgentRevalidateCommand } from './commands/agent/revalidate.js';
+import { createAgentLogsCommand } from './commands/agent/logs.js';
 import { createAgentSearchCommand } from './commands/agent/search.js';
 import { createAgentOwnersCommand } from './commands/agent/owners.js';
 import { createAgentWorkspacesCommand } from './commands/agent/workspaces.js';
@@ -111,8 +112,11 @@ program
     .description('Guild.ai CLI - Build, test, and deploy AI agents')
     .version(packageJson.version)
     .option('--debug', 'Enable debug mode with verbose logging')
-    .option('--json', 'Output pure JSON format (non-interactive)')
+    .option('--mode <format>', 'Output format: interactive (default), json, or jsonl')
+    // Backward compat: --json is a hidden alias for --mode json
+    .addOption(new Option('--json').default(false).hideHelp())
     .option('--quiet, -q', 'Suppress progress and log messages')
+    .option('--non-interactive', 'Disable interactive prompts (for CI, scripts, and coding agents)')
     // Dev shortcuts — hidden from help, use env vars GUILD_USE_SHARED / GUILD_USE_LOCAL instead
     .addOption(new Option('--shared').default(false).hideHelp())
     .addOption(new Option('--local').default(false).hideHelp())
@@ -135,11 +139,13 @@ program
     .argument('[prompt...]', 'Optional initial prompt (multiple words)')
     .option('--agent <identifier>', 'Agent ID or full name, e.g., foo~bar (default: assistant)')
     .option('--once', 'One-shot mode: send message, wait for response, exit (non-interactive)')
-    .option('--mode <format>', 'Machine-readable output format: json or jsonl')
     .option('--workspace <identifier>', 'Workspace ID or full name (e.g., owner/workspace-name)')
     .option('--no-splash', 'Skip the splash screen animation')
     .option('--resume <session-id>', 'Resume an existing session')
     .option('--events <types>', 'Event types to show (default: user). Shorthands: none, user, system, all, or comma-separated type names (e.g. agent_console,llm_start)')
+    // Accept --mode here so `guild chat --mode json` doesn't error.
+    // The actual value is read from process.argv by getOutputMode().
+    .addOption(new Option('--mode <format>').hideHelp())
     .addHelpText('after', '\nTo chat with a local agent under development: guild agent chat')
     .action(async (promptArgs, options) => {
     const { handleChatAction } = await import('./commands/chat.js');
@@ -170,12 +176,14 @@ agentCmd
     .argument('[prompt...]', 'Optional initial prompt for the agent')
     .option('--path <dir>', 'Path to agent directory (defaults to current directory)')
     .option('--workspace <identifier>', 'Workspace ID or full name (e.g., owner~workspace-name)')
-    .option('--mode <format>', 'Input mode: json (one-shot) or jsonl (line-by-line)')
     .option('--agent-version <id>', 'Chat with a specific version (UUID or version number)')
     .option('--no-splash', 'Skip the splash screen animation')
     .option('--resume <session-id>', 'Resume an existing session')
     .option('--open', 'Open session in web dashboard')
     .option('--no-cache', 'Skip ephemeral build cache (force a fresh build)')
+    // Accept --mode here so `guild agent chat --mode json` doesn't error.
+    // The actual value is read from process.argv by getOutputMode().
+    .addOption(new Option('--mode <format>').hideHelp())
     .addHelpText('after', '\nTo chat with a published agent by name: guild chat --agent owner~agent-name')
     .action(async (promptArgs, options) => {
     const { handleAgentChatAction } = await import('./commands/agent/chat.js');
@@ -190,13 +198,15 @@ agentCmd
     .command('test')
     .description('Test agent in interactive REPL session')
     .option('--workspace <identifier>', 'Workspace ID or full name (e.g., owner/workspace-name)')
-    .option('--mode <format>', 'Input mode: json (one-shot) or jsonl (line-by-line)')
     .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: 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)')
+    // Accept --mode here so `guild agent test --mode json` doesn't error.
+    // The actual value is read from process.argv by getOutputMode().
+    .addOption(new Option('--mode <format>').hideHelp())
     .action(async (options) => {
     const { handleAgentTestAction } = await import('./commands/agent/test.js');
     await handleAgentTestAction(options);
@@ -204,6 +214,7 @@ agentCmd
 agentCmd.addCommand(createAgentPublishCommand());
 agentCmd.addCommand(createAgentUnpublishCommand());
 agentCmd.addCommand(createAgentRevalidateCommand());
+agentCmd.addCommand(createAgentLogsCommand());
 agentCmd.addCommand(createAgentSearchCommand());
 agentCmd.addCommand(createAgentOwnersCommand());
 agentCmd.addCommand(createAgentWorkspacesCommand());

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

@@ -159,6 +159,10 @@ export interface Pagination {
     offset: number;
     has_more: boolean;
 }
+/** Default page size for standard list endpoints (matches backend). */
+export declare const DEFAULT_PAGE_LIMIT = 20;
+/** Default page size for high-volume endpoints (events, tasks, operations). */
+export declare const DEFAULT_PAGE_LIMIT_LARGE = 100;
 /**
  * Generic paginated response wrapper.
  * All list endpoints return { items: T[], pagination: Pagination }

package/dist/lib/api-types.js

@@ -1,5 +1,9 @@
 // Copyright 2026 Guild.ai
 // SPDX-License-Identifier: Apache-2.0
+/** Default page size for standard list endpoints (matches backend). */
+export const DEFAULT_PAGE_LIMIT = 20;
+/** Default page size for high-volume endpoints (events, tasks, operations). */
+export const DEFAULT_PAGE_LIMIT_LARGE = 100;
 // Import and re-export generated types (from cli/scripts/sync-types-from-python.py)
 import { WEBHOOK_SERVICES, TIME_TRIGGER_FREQUENCIES, } from './generated-types.js';
 export { WEBHOOK_SERVICES, TIME_TRIGGER_FREQUENCIES, };

package/dist/lib/auth.d.ts

@@ -46,7 +46,7 @@ export declare function pollForToken(authUrl: string, code: string, interval: nu
  * @param returnLabel - Optional friendly label for return button (e.g., "VSCode")
  * @returns true if successful, false otherwise
  */
-export declare function login(returnUrl?: string, returnLabel?: string, nonInteractive?: boolean): Promise<boolean>;
+export declare function login(returnUrl?: string, returnLabel?: string): Promise<boolean>;
 /**
  * Perform logout
  */

package/dist/lib/auth.js

@@ -191,12 +191,12 @@ export async function pollForToken(authUrl, code, interval) {
  * @param returnLabel - Optional friendly label for return button (e.g., "VSCode")
  * @returns true if successful, false otherwise
  */
-export async function login(returnUrl, returnLabel, nonInteractive) {
+export async function login(returnUrl, returnLabel) {
     const authUrl = getGuildcoreUrl();
     try {
         console.log(chalk.bold('\nGuild.ai Authentication'));
         const deviceCode = await startDeviceFlow(authUrl, returnUrl, returnLabel);
-        const skipBrowser = nonInteractive || !isInteractive();
+        const skipBrowser = !isInteractive();
         if (skipBrowser) {
             console.log(`\nVerification code: ${deviceCode.user_code}`);
             console.log(`Open to authenticate: ${deviceCode.verification_uri_complete}\n`);

package/dist/lib/output-mode.d.ts

@@ -1,11 +1,18 @@
-export type OutputMode = 'interactive' | 'json';
+export type OutputMode = 'interactive' | 'json' | 'jsonl';
 /**
  * Detect output mode from CLI flags or config
  *
- * Checks --json flag and config. CLI flag overrides config.
+ * Priority: --mode <value> > --json (backward compat) > config
  * Does NOT auto-detect pipes (user must request JSON explicitly).
  */
 export declare function getOutputMode(): OutputMode;
+/**
+ * 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 declare function isMachineReadable(): boolean;
 /**
  * Check if quiet mode is enabled (CLI flag or config)
  *

package/dist/lib/output-mode.js

@@ -4,21 +4,42 @@
  * Output mode detection for the CLI
  *
  * Interactive mode (default): Colors, tables, spinners, interactive
- * JSON mode (--json): Pure JSON, non-interactive, machine-readable
+ * 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
  *
- * Checks --json flag and config. CLI flag overrides 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)
  *

package/dist/lib/output.d.ts

@@ -1,5 +1,5 @@
 import { type Spinner } from './progress.js';
-import type { Agent, AgentVersion, Credentials, CredentialsPolicy, Context, Integration, IntegrationVersion, JobStep, Pagination, Session, Task, Workspace, WorkspaceAgent, Trigger } from './api-types.js';
+import type { Agent, AgentVersion, Credentials, CredentialsPolicy, Context, Integration, IntegrationVersion, JobStep, Pagination, Session, Task, ValidationStep, Workspace, WorkspaceAgent, Trigger } from './api-types.js';
 /**
  * Format an agent list as a human-readable table.
  * Shared by agent list and agent search commands.
@@ -57,6 +57,12 @@ export declare function formatPoliciesTable(policies: CredentialsPolicy[], pagin
  * Used by job get command.
  */
 export declare function formatJobStepTable(steps: JobStep[]): void;
+/**
+ * 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 declare function formatValidationLogs(steps: ValidationStep[]): void;
 /**
  * Output writer interface for consistent CLI output
  *

package/dist/lib/output.js

@@ -195,7 +195,7 @@ export function formatVersionTable(versions, pagination) {
                 ? chalk.red
                 : chalk.dim;
         table.addRow({
-            id: v.id.substring(0, 8),
+            id: v.id,
             version: v.version_number || '-',
             status: v.status,
             validation: validationColor(v.validation_status || '-'),
@@ -225,7 +225,7 @@ export function formatContextTable(contexts, pagination) {
     });
     contexts.forEach((ctx) => {
         table.addRow({
-            id: truncate(ctx.id, 12),
+            id: ctx.id,
             status: ctx.status,
             type: ctx.type || '-',
             created: ctx.created_at ? formatRelativeTime(ctx.created_at) : '',
@@ -256,7 +256,7 @@ export function formatWorkspaceAgentTable(agents) {
         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.substring(0, 8),
+            version: wa.agent_version.version_number || wa.agent_version.id,
             auto_update: wa.should_autoupdate ? chalk.green('yes') : chalk.dim('no'),
         });
     });
@@ -353,7 +353,7 @@ export function formatTaskTable(tasks, pagination) {
                     ? chalk.yellow
                     : chalk.dim;
         table.addRow({
-            id: truncate(task.id, 13),
+            id: task.id,
             name,
             status: statusColor(task.status),
             tokens: task.token_usage ? task.token_usage.total_tokens.toLocaleString() : '-',
@@ -506,6 +506,35 @@ export function formatJobStepTable(steps) {
     });
     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
  *
@@ -573,7 +602,9 @@ export class JSONOutputWriter {
  */
 export function createOutputWriter() {
     const mode = getOutputMode();
-    return mode === 'json' ? new JSONOutputWriter() : new InteractiveOutputWriter();
+    return mode === 'interactive'
+        ? new InteractiveOutputWriter()
+        : new JSONOutputWriter();
 }
 /**
  * Create a no-op spinner (for quiet/JSON modes)

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

@@ -13,6 +13,9 @@ export interface ResolveOwnerOptions {
     ownerFlag?: string;
     client: GuildAPIClient;
     interactive: boolean;
+    /** When true, error if multiple accounts and no explicit owner in non-interactive mode.
+     *  When false (default), fall back to current user. */
+    requireExplicitOwner?: boolean;
 }
 export declare function resolveOwnerId(options: ResolveOwnerOptions): Promise<OwnerChoice>;
 //# sourceMappingURL=owner-helpers.d.ts.map