@guildai/cli 0.9.1 → 0.11.0

package/dist/commands/agent/chat.js

@@ -1,6 +1,6 @@
 // Copyright 2026 Guild.ai
 // SPDX-License-Identifier: Apache-2.0
-import { Command } from 'commander';
+import { Command, Option } from 'commander';
 import { render } from 'ink';
 import React from 'react';
 import open from 'open';
@@ -31,12 +31,14 @@ export function createAgentChatCommand() {
         .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 so `guild agent chat --mode json` works when re-parsed.
+        // 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) => {
         try {
@@ -45,8 +47,9 @@ export function createAgentChatCommand() {
             const { agentId, config } = await getAgentId(undefined, agentPath);
             const initialPrompt = promptArgs.length > 0 ? promptArgs.join(' ') : 'Hello';
             // If using JSON input, read it early (before auth) for fast failure on bad input
+            const outputMode = getOutputMode();
             let inputData;
-            if (options.mode === 'json') {
+            if (outputMode === 'json') {
                 try {
                     inputData = await readStdinAsJSON();
                 }
@@ -98,10 +101,10 @@ export function createAgentChatCommand() {
                 }
             }
             // Branch: JSON/JSONL modes vs interactive
-            if (options.mode === 'json' || options.mode === 'jsonl') {
+            if (outputMode === 'json' || outputMode === 'jsonl') {
                 // For JSON mode with piped input, use the piped data as the initial prompt
                 // so the agent receives it as its input (not the default 'Hello')
-                const sessionPrompt = options.mode === 'json' && inputData
+                const sessionPrompt = outputMode === 'json' && inputData
                     ? JSON.stringify(inputData)
                     : initialPrompt;
                 // Pre-resolve workspace so we can show the source label in output.
@@ -133,7 +136,7 @@ export function createAgentChatCommand() {
                 if (options.open && session.session_url) {
                     await open(session.session_url);
                 }
-                if (options.mode === 'json' && inputData) {
+                if (outputMode === 'json' && inputData) {
                     // JSON one-shot mode — input was passed as initial_prompt during
                     // session creation, so the agent already has it. Just poll for the response.
                     try {
@@ -158,7 +161,7 @@ export function createAgentChatCommand() {
                         process.exit(1);
                     }
                 }
-                else if (options.mode === 'jsonl') {
+                else if (outputMode === 'jsonl') {
                     // JSONL line-by-line mode
                     const rl = readline.createInterface({
                         input: process.stdin,

package/dist/commands/agent/clone.js

@@ -88,6 +88,8 @@ export function createAgentCloneCommand() {
             output.progress('  3. git add . && git commit -m "your changes"');
             output.progress("  4. Run 'guild agent save' to push and create a version");
             output.progress(`  5. Run 'guild agent test' to test your changes`);
+            output.progress('');
+            output.progress(`Tip: Using a coding agent? Run 'guild setup' to install skills for Claude Code, Codex, etc.`);
         }
         catch (error) {
             if (error instanceof GitError) {

package/dist/commands/agent/fork.js

@@ -143,6 +143,7 @@ export function createAgentForkCommand() {
                 ownerFlag: options.owner,
                 client,
                 interactive: isInteractive(),
+                requireExplicitOwner: true,
             });
             // Create forked agent
             output.progress(`✓ Forking agent '${agentName}'...`);
@@ -189,6 +190,8 @@ export function createAgentForkCommand() {
             output.progress('  2. Make your changes to the code');
             output.progress(`  3. Run 'guild agent save --message "your changes"'`);
             output.progress(`  4. Run 'guild agent test' to test your changes`);
+            output.progress('');
+            output.progress(`Tip: Using a coding agent? Run 'guild setup' to install skills for Claude Code, Codex, etc.`);
         }
         catch (error) {
             if (error instanceof GitError) {

package/dist/commands/agent/init.js

@@ -59,6 +59,20 @@ async function promptForName(defaultName) {
     });
     return ask();
 }
+async function confirmCreation(ownerName, agentName) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(`\nYou are about to create agent "${ownerName}~${agentName}".\n` +
+            'Warning: Owner and name cannot be changed after creation, and agents cannot be deleted.\n\n' +
+            'Continue? [y/N] ', (answer) => {
+            rl.close();
+            resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+        });
+    });
+}
 async function promptForTemplate() {
     const { default: inquirer } = await import('inquirer');
     const { template } = await inquirer.prompt([
@@ -80,17 +94,37 @@ export function createAgentInitCommand() {
         .option('--template <template>', 'Agent template (LLM, AUTO_MANAGED_STATE, BLANK)')
         .option('--fork <agent-id>', 'Fork from existing agent')
         .option('--owner <owner>', 'Owner (name or ID)')
-        .option('--directory <path>', 'Directory to initialize (created if needed)')
+        .option('--directory <path>', 'Directory to initialize (default: ./<name>, created if needed)')
         .option('--force', 'Overwrite existing guild.json', false)
         .action(async (options) => {
-        // Resolve target directory
+        // Get agent name first (needed to determine default directory)
+        let agentName = options.name;
+        if (!agentName) {
+            if (isInteractive()) {
+                const dirName = path.basename(process.cwd());
+                const defaultName = slugify(dirName);
+                agentName = await promptForName(defaultName);
+                if (!agentName) {
+                    console.error('Error: Agent name cannot be empty');
+                    process.exit(1);
+                }
+            }
+            else {
+                console.error('Error: Agent name is required');
+                console.error('');
+                console.error('Provide a name:');
+                console.error('  guild agent init --name my-agent');
+                console.error('');
+                console.error('Or run interactively to be prompted for a name.');
+                process.exit(1);
+            }
+        }
+        // Resolve target directory: --directory overrides, otherwise ./<name>
         const targetDir = options.directory
             ? path.resolve(process.cwd(), options.directory)
-            : process.cwd();
+            : path.resolve(process.cwd(), agentName);
         // Create directory if it doesn't exist
-        if (options.directory) {
-            await fs.mkdir(targetDir, { recursive: true });
-        }
+        await fs.mkdir(targetDir, { recursive: true });
         const guildJsonPath = path.join(targetDir, 'guild.json');
         try {
             // Check if already initialized
@@ -107,29 +141,6 @@ export function createAgentInitCommand() {
                 console.error('To reinitialize, use: guild agent init --force');
                 process.exit(1);
             }
-            // Get agent name
-            let agentName = options.name;
-            if (!agentName) {
-                if (isInteractive()) {
-                    // Use slugified directory name as default
-                    const dirName = path.basename(targetDir);
-                    const defaultName = slugify(dirName);
-                    agentName = await promptForName(defaultName);
-                    if (!agentName) {
-                        console.error('Error: Agent name cannot be empty');
-                        process.exit(1);
-                    }
-                }
-                else {
-                    console.error('Error: Agent name is required');
-                    console.error('');
-                    console.error('Provide a name:');
-                    console.error('  guild agent init --name my-agent');
-                    console.error('');
-                    console.error('Or run interactively to be prompted for a name.');
-                    process.exit(1);
-                }
-            }
             // Validate name (catches --name flag and non-interactive paths)
             if (!isValidAgentName(agentName)) {
                 console.error(`Error: Invalid agent name "${agentName}"`);
@@ -176,14 +187,15 @@ export function createAgentInitCommand() {
                 process.exit(1);
             }
             // Create progress tracker for initialization steps
-            const steps = createSteps([
+            const stepNames = [
                 'Create agent in backend',
                 'Initialize git repository',
                 'Configure git remote',
                 'Wait for backend initialization',
                 'Pull scaffolding from remote',
                 'Create guild.json',
-            ]);
+            ];
+            const steps = createSteps(stepNames);
             steps.start();
             // Step 1: Create agent in backend
             const client = new GuildAPIClient();
@@ -192,7 +204,15 @@ export function createAgentInitCommand() {
                 ownerFlag: options.owner,
                 client,
                 interactive: isInteractive(),
+                requireExplicitOwner: true,
             });
+            if (isInteractive()) {
+                const confirmed = await confirmCreation(owner.name, agentName);
+                if (!confirmed) {
+                    console.log('Cancelled.');
+                    process.exit(0);
+                }
+            }
             const agent = await client.post('/agents', {
                 name: agentName,
                 description: `Agent created via CLI`,
@@ -346,19 +366,13 @@ export function createAgentInitCommand() {
             steps.complete('Agent initialized successfully');
             // Display next steps
             format.section('Next steps:');
-            if (options.directory) {
-                format.detail(`1. cd ${targetDir}`);
-                format.detail('2. Edit agent.ts to implement your agent logic');
-                format.detail('3. git add . && git commit -m "Initial implementation"');
-                format.detail("4. Run 'guild agent save' to push and create a version");
-                format.detail(`5. Run 'guild agent test' to test your agent`);
-            }
-            else {
-                format.detail('1. Edit agent.ts to implement your agent logic');
-                format.detail('2. git add . && git commit -m "Initial implementation"');
-                format.detail("3. Run 'guild agent save' to push and create a version");
-                format.detail(`4. Run 'guild agent test' to test your agent`);
-            }
+            format.detail(`1. cd ${targetDir}`);
+            format.detail('2. Edit agent.ts to implement your agent logic');
+            format.detail('3. git add . && git commit -m "Initial implementation"');
+            format.detail("4. Run 'guild agent save' to push and create a version");
+            format.detail(`5. Run 'guild agent test' to test your agent`);
+            format.detail('');
+            format.detail(`Tip: Using a coding agent? Run 'guild setup' to install skills for Claude Code, Codex, etc.`);
         }
         catch (error) {
             if (error instanceof GitError) {

package/dist/commands/agent/list.js

@@ -4,8 +4,9 @@ import { Command } from 'commander';
 import { GuildAPIClient } from '../../lib/api-client.js';
 import { getAuthToken } from '../../lib/auth.js';
 import { handleAxiosError, ErrorCodes } from '../../lib/errors.js';
-import { getOutputMode } from '../../lib/output-mode.js';
+import { isMachineReadable } from '../../lib/output-mode.js';
 import { createOutputWriter, formatAgentTable } from '../../lib/output.js';
+import { DEFAULT_PAGE_LIMIT } from '../../lib/api-types.js';
 const SORT_MAP = {
     updated: 'updated_at',
     newest: 'created_at',
@@ -23,8 +24,8 @@ export function createAgentListCommand() {
         .option('--all', 'Show all agents including archived')
         .option('--owner <name>', 'Filter by owner (user or org name). Without this flag, lists your own agents')
         .option('--workspace <id>', 'Filter agents by 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();
         if (options.archived && options.all) {
@@ -79,7 +80,7 @@ export function createAgentListCommand() {
             if (options.archived) {
                 response.items = response.items.filter((a) => a.is_archived);
             }
-            if (getOutputMode() === 'json') {
+            if (isMachineReadable()) {
                 output.data(response);
             }
             else {

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

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

package/dist/commands/agent/logs.js

@@ -0,0 +1,62 @@
+// Copyright 2026 Guild.ai
+// SPDX-License-Identifier: Apache-2.0
+import { Command } from 'commander';
+import { GuildAPIClient } from '../../lib/api-client.js';
+import { getGuildcoreUrl } from '../../lib/config.js';
+import { handleAxiosError, ErrorCodes } from '../../lib/errors.js';
+import { getAgentId, resolveAgentRef } from '../../lib/agent-helpers.js';
+import { isMachineReadable } from '../../lib/output-mode.js';
+import { createOutputWriter, formatValidationLogs } from '../../lib/output.js';
+export function createAgentLogsCommand() {
+    const cmd = new Command('logs');
+    cmd
+        .description('Show build/validation logs for an agent version')
+        .argument('[identifier]', 'Agent ID or full name (e.g., "owner~agent-name")')
+        .argument('[version-id]', 'ID of the version to show logs for (uses latest if omitted)')
+        .action(async (agentIdArg, versionIdArg) => {
+        const output = createOutputWriter();
+        // Get agent ID from argument or guild.json
+        const { agentId } = await getAgentId(agentIdArg);
+        const baseUrl = getGuildcoreUrl();
+        const client = new GuildAPIClient({ baseUrl });
+        try {
+            const resolvedId = await resolveAgentRef(client, agentId);
+            let versionId = versionIdArg;
+            // If no version ID provided, get the latest version
+            if (!versionId) {
+                const versions = await client.get(`/agents/${resolvedId}/versions?limit=1&offset=0`);
+                if (!versions.items || versions.items.length === 0) {
+                    output.error('No versions found for this agent.', `The agent may still be initializing. Check status:\n  guild agent get ${agentId}`);
+                    process.exit(1);
+                }
+                versionId = versions.items[0].id;
+            }
+            // Fetch validation steps for the version
+            const stepsResponse = await client.get(`/versions/${versionId}/validation/steps`);
+            if (isMachineReadable()) {
+                output.data(stepsResponse);
+            }
+            else {
+                formatValidationLogs(stepsResponse.steps);
+            }
+        }
+        catch (error) {
+            const formattedError = handleAxiosError(error);
+            if (formattedError.code === ErrorCodes.AUTH_REQUIRED) {
+                output.error('Not authenticated.', '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.NOT_FOUND) {
+                output.error('Agent or version not found', `Check the agent and version IDs:\n  guild agent list\n  guild agent versions ${agentId}`);
+            }
+            else {
+                output.error(`Failed to retrieve logs: ${formattedError.details}`);
+            }
+            process.exit(1);
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=logs.js.map

package/dist/commands/agent/owners.js

@@ -4,7 +4,7 @@ import { Command } from 'commander';
 import chalk from 'chalk';
 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 } from '../../lib/output.js';
 import { loadGlobalConfig } from '../../lib/guild-config.js';
 export function createAgentOwnersCommand() {
@@ -12,7 +12,7 @@ export function createAgentOwnersCommand() {
     cmd.description('List accounts that can own agents').action(async () => {
         const output = createOutputWriter();
         try {
-            const mode = getOutputMode();
+            const mode = isMachineReadable();
             const client = new GuildAPIClient();
             const [me, orgs, globalConfig] = await Promise.all([
                 client.get('/me'),
@@ -34,7 +34,7 @@ export function createAgentOwnersCommand() {
                     is_default: defaultOwnerId === org.id,
                 })),
             ];
-            if (mode === 'json') {
+            if (mode) {
                 output.data({ owners });
                 return;
             }

package/dist/commands/agent/pull.js

@@ -3,7 +3,7 @@
 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 } from '../../lib/output.js';
 import * as fs from 'fs/promises';
 import * as path from 'path';
@@ -11,10 +11,7 @@ import { getAuthenticatedUrl } from '../../lib/auth.js';
 import { runGit, GitError, formatGitError } from '../../lib/git.js';
 export function createAgentPullCommand() {
     const cmd = new Command('pull');
-    cmd
-        .description('Pull remote changes into local agent directory')
-        .option('--json', 'Output JSON only (no progress messages)', false)
-        .action(async (_options) => {
+    cmd.description('Pull remote changes into local agent directory').action(async () => {
         const cwd = process.cwd();
         const output = createOutputWriter();
         try {
@@ -82,8 +79,7 @@ export function createAgentPullCommand() {
                     ? pullError.stderr || pullError.stdout
                     : String(pullError);
                 // Check for rebase conflicts
-                if (errMessage.includes('CONFLICT') ||
-                    errMessage.includes('could not apply')) {
+                if (errMessage.includes('CONFLICT') || errMessage.includes('could not apply')) {
                     output.error('Merge conflict detected', 'Your changes conflict with remote changes.\n\nTo resolve:\n  1. Fix conflicts in the listed files\n  2. git add <resolved-files>\n  3. git rebase --continue\n\nOr abort the rebase:\n  git rebase --abort');
                     process.exit(1);
                 }
@@ -91,7 +87,7 @@ export function createAgentPullCommand() {
                 if (errMessage.includes('no tracking information') ||
                     errMessage.includes("couldn't find remote ref")) {
                     output.progress('✓ Already up to date (no remote branch yet)');
-                    if (getOutputMode() === 'json') {
+                    if (isMachineReadable()) {
                         output.data({
                             success: true,
                             message: 'Already up to date (no remote branch yet)',
@@ -113,7 +109,7 @@ export function createAgentPullCommand() {
                     if (!gitPulledNewCommits) {
                         output.progress('✓ Already up to date');
                     }
-                    if (getOutputMode() === 'json') {
+                    if (isMachineReadable()) {
                         output.data({
                             success: true,
                             message: gitPulledNewCommits
@@ -126,7 +122,7 @@ export function createAgentPullCommand() {
                     // SHA mismatch — warn user
                     output.progress(`⚠ Remote has a newer version (${latest.sha.slice(0, 7)}) not on this branch`);
                     output.progress('  Try: git fetch origin && git log --oneline origin/main');
-                    if (getOutputMode() === 'json') {
+                    if (isMachineReadable()) {
                         output.data({
                             success: true,
                             message: 'SHA mismatch with latest version',
@@ -151,7 +147,7 @@ export function createAgentPullCommand() {
                         await fs.writeFile(filePath, file.content, 'utf-8');
                     }
                     output.progress(`✓ Downloaded ${files.length} files from latest draft version`);
-                    if (getOutputMode() === 'json') {
+                    if (isMachineReadable()) {
                         output.data({
                             success: true,
                             message: `Downloaded ${files.length} files from draft version`,
@@ -165,7 +161,7 @@ export function createAgentPullCommand() {
                 if (!gitPulledNewCommits) {
                     output.progress('✓ Already up to date');
                 }
-                if (getOutputMode() === 'json') {
+                if (isMachineReadable()) {
                     output.data({
                         success: true,
                         message: gitPulledNewCommits

package/dist/commands/agent/save.js

@@ -3,7 +3,7 @@
 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 } from '../../lib/output.js';
 import * as fs from 'fs/promises';
 import * as path from 'path';
@@ -16,11 +16,10 @@ export function createAgentSaveCommand() {
         .description('Commit, push, and create a new agent version')
         .option('-A, --all', 'Stage all changes and commit before pushing', false)
         .option('-m, --message <text>', 'Commit message (required with --all)')
-        .option('--wait', 'Wait for validation to complete before returning', false)
-        .option('--publish', 'Publish after validation passes (implies --wait)', false)
-        .option('--bump [level]', 'Bump package.json version before saving (patch, or minor/major)', 'patch')
+        .option('--wait', 'Wait for validation to complete before returning (default: returns immediately)', false)
+        .option('--publish', 'Publish after validation passes (implies --wait) (default: does not publish)', false)
+        .option('--bump [level]', 'Bump package.json version before saving (patch, or minor/major) (default: patch)', 'patch')
         .option('--no-bump', 'Skip automatic version bump')
-        .option('--json', 'Output JSON only (no progress messages)', false)
         .action(async (options) => {
         const cwd = process.cwd();
         let guildConfig = null;
@@ -314,7 +313,7 @@ export function createAgentSaveCommand() {
             // Output JSON to stdout only in --json mode.
             // In interactive mode the progress messages above already
             // show version details; dumping raw JSON is noise.
-            if (getOutputMode() === 'json') {
+            if (isMachineReadable()) {
                 output.data({ version });
             }
         }

package/dist/commands/agent/search.js

@@ -4,8 +4,9 @@ import { Command } from 'commander';
 import { GuildAPIClient } from '../../lib/api-client.js';
 import { getAuthToken } from '../../lib/auth.js';
 import { handleAxiosError } from '../../lib/errors.js';
-import { getOutputMode } from '../../lib/output-mode.js';
+import { isMachineReadable } from '../../lib/output-mode.js';
 import { createOutputWriter, formatAgentTable } from '../../lib/output.js';
+import { DEFAULT_PAGE_LIMIT } from '../../lib/api-types.js';
 const SORT_MAP = {
     updated: 'updated_at',
     newest: 'created_at',
@@ -19,8 +20,8 @@ export function createAgentSearchCommand() {
         .argument('<query>', 'Search query')
         .option('--sort <field>', 'Sort by: updated, newest, name, popular (default: updated)', 'updated')
         .option('--published', 'Only show published agents')
-        .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 (query, options) => {
         const output = createOutputWriter();
         try {
@@ -42,7 +43,7 @@ export function createAgentSearchCommand() {
                 params.append('sort_by', sortField);
             }
             const response = await client.get(`/agents?${params.toString()}`);
-            if (getOutputMode() === 'json') {
+            if (isMachineReadable()) {
                 output.data(response);
             }
             else {

package/dist/commands/agent/test.js

@@ -1,6 +1,6 @@
 // Copyright 2026 Guild.ai
 // SPDX-License-Identifier: Apache-2.0
-import { Command } from 'commander';
+import { Command, Option } from 'commander';
 import { render } from 'ink';
 import React from 'react';
 import { readFileSync } from 'fs';
@@ -32,13 +32,15 @@ export function createAgentTestCommand() {
     cmd
         .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: user). 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 so `guild agent test --mode json` works when re-parsed.
+        // The actual value is read from process.argv by getOutputMode().
+        .addOption(new Option('--mode <format>').hideHelp())
         .action(async (options) => {
         const cwd = process.cwd();
         // Parse --events filter once, before any branching
@@ -85,9 +87,10 @@ export function createAgentTestCommand() {
             }
             // If using JSON/JSONL input, read and validate it early (before auth/session creation)
             // This provides better UX - fail fast on bad input without needing auth
+            const outputMode = getOutputMode();
             let inputData;
             let jsonlInputs;
-            if (options.mode === 'json') {
+            if (outputMode === 'json') {
                 try {
                     inputData = await readStdinAsJSON();
                 }
@@ -101,7 +104,7 @@ export function createAgentTestCommand() {
                     process.exit(1);
                 }
             }
-            else if (options.mode === 'jsonl') {
+            else if (outputMode === 'jsonl') {
                 try {
                     const stdinContent = await readStdinAsText();
                     jsonlInputs = [];
@@ -321,7 +324,7 @@ export function createAgentTestCommand() {
                 await open(session.session_url);
             }
             // Branch: JSON input mode vs interactive REPL
-            if (options.mode === 'json' && inputData) {
+            if (outputMode === 'json' && inputData) {
                 // JSON input mode: one-shot test
                 try {
                     // Send JSON as event content (inputData already read earlier)
@@ -384,7 +387,7 @@ export function createAgentTestCommand() {
                     process.exit(1);
                 }
             }
-            else if (options.mode === 'jsonl' && jsonlInputs) {
+            else if (outputMode === 'jsonl' && jsonlInputs) {
                 // JSONL input mode: line-by-line processing (inputs already parsed and validated)
                 let processedCount = 0;
                 let lastEventId;

package/dist/commands/agent/update.js

@@ -6,6 +6,7 @@ import { GuildAPIClient } from '../../lib/api-client.js';
 import { getAgentId, resolveAgentRef } from '../../lib/agent-helpers.js';
 import { handleAxiosError, ErrorCodes } from '../../lib/errors.js';
 import { createOutputWriter } from '../../lib/output.js';
+import { isInteractive } from '../../lib/stdin.js';
 async function confirmVisibilityChange(agentName, makePublic) {
     const rl = readline.createInterface({
         input: process.stdin,
@@ -13,7 +14,7 @@ async function confirmVisibilityChange(agentName, makePublic) {
     });
     const action = makePublic ? 'PUBLIC' : 'PRIVATE';
     const warning = makePublic
-        ? 'This will make the agent visible to everyone.'
+        ? 'This will make the agent visible to everyone.\nWarning: Once public, an agent cannot be made private again.'
         : 'This will hide the agent from public discovery.';
     return new Promise((resolve) => {
         rl.question(`\nAre you sure you want to make "${agentName}" ${action}?\n${warning}\n\nContinue? [y/N] `, (answer) => {
@@ -59,6 +60,13 @@ export function createAgentUpdateCommand() {
                 }
                 // Confirm unless --yes is specified
                 if (!options.yes) {
+                    if (!isInteractive()) {
+                        output.error('Confirmation required for visibility changes.', 'Use --yes to skip confirmation in non-interactive mode:\n  guild agent update ' +
+                            (identifierArg ?? '') +
+                            (makePublic ? ' --public' : ' --private') +
+                            ' --yes');
+                        process.exit(1);
+                    }
                     const confirmed = await confirmVisibilityChange(agent.full_name, makePublic);
                     if (!confirmed) {
                         output.progress('Cancelled.');

package/dist/commands/agent/versions.js

@@ -5,15 +5,16 @@ import { GuildAPIClient } from '../../lib/api-client.js';
 import { getGuildcoreUrl } from '../../lib/config.js';
 import { handleAxiosError, ErrorCodes } from '../../lib/errors.js';
 import { getAgentId, resolveAgentRef } from '../../lib/agent-helpers.js';
-import { getOutputMode } from '../../lib/output-mode.js';
+import { isMachineReadable } from '../../lib/output-mode.js';
 import { createOutputWriter, formatVersionTable } from '../../lib/output.js';
+import { DEFAULT_PAGE_LIMIT } from '../../lib/api-types.js';
 export function createAgentVersionsCommand() {
     const cmd = new Command('versions');
     cmd
         .description('List all versions of an agent')
         .argument('[identifier]', 'Agent ID or full name (e.g., owner~agent-name)')
-        .option('--limit <number>', 'Maximum number of versions to return', '20')
-        .option('--offset <number>', 'Number of versions to skip', '0')
+        .option('--limit <number>', `Maximum number of versions to return (default: ${DEFAULT_PAGE_LIMIT})`, String(DEFAULT_PAGE_LIMIT))
+        .option('--offset <number>', 'Number of versions to skip (default: 0)', '0')
         .action(async (agentIdArg, options) => {
         const output = createOutputWriter();
         // Get agent ID from argument or guild.json
@@ -25,7 +26,7 @@ export function createAgentVersionsCommand() {
         try {
             const resolvedId = await resolveAgentRef(client, agentId);
             const result = await client.get(`/agents/${resolvedId}/versions?limit=${limit}&offset=${offset}`);
-            if (getOutputMode() === 'json') {
+            if (isMachineReadable()) {
                 output.data(result);
             }
             else {