@guildai/cli 0.3.15 → 0.3.17

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

@@ -3,47 +3,36 @@ import { Command } from 'commander';
 import { GuildAPIClient } from '../../../lib/api-client.js';
 import { getAgentId } from '../../../lib/agent-helpers.js';
 import { handleAxiosError, ErrorCodes } from '../../../lib/errors.js';
+import { createOutputWriter } from '../../../lib/output.js';
 export function createAgentTagsListCommand() {
     const cmd = new Command('list');
     cmd
         .description('List tags for an agent')
         .argument('[agent-id]', 'Agent ID (optional if in agent directory)')
         .action(async (agentIdArg) => {
+        const output = createOutputWriter();
         try {
             const client = new GuildAPIClient();
             // Resolve agent ID
-            const { agentId, config } = await getAgentId(agentIdArg);
+            const { agentId } = await getAgentId(agentIdArg);
             // Fetch tags
             const response = await client.get(`/agents/${agentId}/tags`);
-            const agentName = config?.name || `agent ${agentId}`;
-            console.log(`Tags for agent: ${agentName}${config ? '' : ` (${agentId})`}`);
-            console.log('');
-            if (response.names.length === 0) {
-                console.log('  No tags set');
-            }
-            else {
-                response.names.forEach((tag) => {
-                    console.log(`  • ${tag}`);
-                });
-            }
+            output.data(response);
         }
         catch (error) {
             const formattedError = handleAxiosError(error);
             if (formattedError.code === ErrorCodes.AUTH_REQUIRED) {
-                console.error('Not authenticated. Run: guild auth login');
-                process.exit(1);
+                output.error('Not authenticated.', 'Run: guild auth login');
             }
-            if (formattedError.code === ErrorCodes.NOT_FOUND) {
-                console.error('Agent not found');
-                console.error('');
-                console.error('Run: guild agent list');
-                process.exit(1);
+            else if (formattedError.code === ErrorCodes.NOT_FOUND) {
+                output.error('Agent not found.', 'Run: guild agent list');
             }
-            if (formattedError.code === ErrorCodes.CONN_REFUSED) {
-                console.error('Cannot connect to Guild servers');
-                process.exit(1);
+            else if (formattedError.code === ErrorCodes.CONN_REFUSED) {
+                output.error('Cannot connect to Guild servers');
+            }
+            else {
+                output.error(`Failed to fetch tags: ${formattedError.details}`);
             }
-            console.error(`Failed to fetch tags: ${formattedError.details}`);
             process.exit(1);
         }
     });

package/dist/commands/agent/tags/remove.js

@@ -3,6 +3,7 @@ import { Command } from 'commander';
 import { GuildAPIClient } from '../../../lib/api-client.js';
 import { getAgentId } from '../../../lib/agent-helpers.js';
 import { handleAxiosError, ErrorCodes } from '../../../lib/errors.js';
+import { createOutputWriter } from '../../../lib/output.js';
 export function createAgentTagsRemoveCommand() {
     const cmd = new Command('remove');
     cmd
@@ -10,6 +11,7 @@ export function createAgentTagsRemoveCommand() {
         .argument('[agent-id]', 'Agent ID (optional if in agent directory)')
         .argument('<tags...>', 'Tags to remove')
         .action(async (agentIdOrFirstTag, remainingTags) => {
+        const output = createOutputWriter();
         try {
             const client = new GuildAPIClient();
             // Parse arguments - need to determine if first arg is agent-id or tag
@@ -32,9 +34,7 @@ export function createAgentTagsRemoveCommand() {
             // Now resolve agent ID properly
             const { agentId, config } = await getAgentId(agentIdArg);
             if (tagsToRemove.length === 0) {
-                console.error('Error: At least one tag is required');
-                console.error('');
-                console.error('Usage: guild agent tags remove [agent-id] <tag...>');
+                output.error('At least one tag is required.', 'Usage: guild agent tags remove [agent-id] <tag...>');
                 process.exit(1);
             }
             // Fetch current tags
@@ -47,44 +47,33 @@ export function createAgentTagsRemoveCommand() {
             // Update tags
             await client.post(`/agents/${agentId}/tags`, { names: updatedTags });
             const agentName = config?.name || `agent ${agentId}`;
-            console.log(`✓ Updated tags for agent: ${agentName}${config ? '' : ` (${agentId})`}`);
-            console.log('');
-            if (updatedTags.length === 0) {
-                console.log('  No tags set');
-            }
-            else {
-                updatedTags.forEach((tag) => {
-                    console.log(`  • ${tag}`);
-                });
-            }
+            const label = `${agentName}${config ? '' : ` (${agentId})`}`;
+            output.success(`Updated tags for agent: ${label}`);
+            output.data({ names: updatedTags });
             // Show warning for tags that weren't present
             if (notPresentTags.length > 0) {
-                console.log('');
                 if (notPresentTags.length === 1) {
-                    console.log(`Note: Tag '${notPresentTags[0]}' was not present`);
+                    output.progress(`Note: Tag '${notPresentTags[0]}' was not present`);
                 }
                 else {
-                    console.log(`Note: Tags not present: ${notPresentTags.map((t) => `'${t}'`).join(', ')}`);
+                    output.progress(`Note: Tags not present: ${notPresentTags.map((t) => `'${t}'`).join(', ')}`);
                 }
             }
         }
         catch (error) {
             const formattedError = handleAxiosError(error);
             if (formattedError.code === ErrorCodes.AUTH_REQUIRED) {
-                console.error('Not authenticated. Run: guild auth login');
-                process.exit(1);
+                output.error('Not authenticated.', 'Run: guild auth login');
             }
-            if (formattedError.code === ErrorCodes.NOT_FOUND) {
-                console.error('Agent not found');
-                console.error('');
-                console.error('Run: guild agent list');
-                process.exit(1);
+            else if (formattedError.code === ErrorCodes.NOT_FOUND) {
+                output.error('Agent not found.', 'Run: guild agent list');
             }
-            if (formattedError.code === ErrorCodes.CONN_REFUSED) {
-                console.error('Cannot connect to Guild servers');
-                process.exit(1);
+            else if (formattedError.code === ErrorCodes.CONN_REFUSED) {
+                output.error('Cannot connect to Guild servers');
+            }
+            else {
+                output.error(`Failed to remove tags: ${formattedError.details}`);
             }
-            console.error(`Failed to remove tags: ${formattedError.details}`);
             process.exit(1);
         }
     });

package/dist/commands/agent/tags/set.js

@@ -3,6 +3,7 @@ import { Command } from 'commander';
 import { GuildAPIClient } from '../../../lib/api-client.js';
 import { getAgentId } from '../../../lib/agent-helpers.js';
 import { handleAxiosError, ErrorCodes } from '../../../lib/errors.js';
+import { createOutputWriter } from '../../../lib/output.js';
 export function createAgentTagsSetCommand() {
     const cmd = new Command('set');
     cmd
@@ -10,6 +11,7 @@ export function createAgentTagsSetCommand() {
         .argument('[agent-id]', 'Agent ID (optional if in agent directory)')
         .argument('[tags...]', 'Tags to set (omit to clear all tags)')
         .action(async (agentIdOrFirstTag, remainingTags) => {
+        const output = createOutputWriter();
         try {
             const client = new GuildAPIClient();
             // Parse arguments - need to determine if first arg is agent-id or tag
@@ -36,36 +38,29 @@ export function createAgentTagsSetCommand() {
             // Update tags (direct replacement)
             await client.post(`/agents/${agentId}/tags`, { names: tagsToSet });
             const agentName = config?.name || `agent ${agentId}`;
+            const label = `${agentName}${config ? '' : ` (${agentId})`}`;
             if (tagsToSet.length === 0) {
-                console.log(`✓ Cleared all tags for agent: ${agentName}${config ? '' : ` (${agentId})`}`);
-                console.log('');
-                console.log('  No tags set');
+                output.success(`Cleared all tags for agent: ${label}`);
             }
             else {
-                console.log(`✓ Updated tags for agent: ${agentName}${config ? '' : ` (${agentId})`}`);
-                console.log('');
-                tagsToSet.forEach((tag) => {
-                    console.log(`  • ${tag}`);
-                });
+                output.success(`Updated tags for agent: ${label}`);
             }
+            output.data({ names: tagsToSet });
         }
         catch (error) {
             const formattedError = handleAxiosError(error);
             if (formattedError.code === ErrorCodes.AUTH_REQUIRED) {
-                console.error('Not authenticated. Run: guild auth login');
-                process.exit(1);
+                output.error('Not authenticated.', 'Run: guild auth login');
             }
-            if (formattedError.code === ErrorCodes.NOT_FOUND) {
-                console.error('Agent not found');
-                console.error('');
-                console.error('Run: guild agent list');
-                process.exit(1);
+            else if (formattedError.code === ErrorCodes.NOT_FOUND) {
+                output.error('Agent not found.', 'Run: guild agent list');
             }
-            if (formattedError.code === ErrorCodes.CONN_REFUSED) {
-                console.error('Cannot connect to Guild servers');
-                process.exit(1);
+            else if (formattedError.code === ErrorCodes.CONN_REFUSED) {
+                output.error('Cannot connect to Guild servers');
+            }
+            else {
+                output.error(`Failed to set tags: ${formattedError.details}`);
             }
-            console.error(`Failed to set tags: ${formattedError.details}`);
             process.exit(1);
         }
     });

package/dist/commands/agent/unpublish.js

@@ -3,12 +3,14 @@ import { Command } from 'commander';
 import { GuildAPIClient } from '../../lib/api-client.js';
 import { getAgentId } from '../../lib/agent-helpers.js';
 import { handleAxiosError, ErrorCodes } from '../../lib/errors.js';
+import { createOutputWriter } from '../../lib/output.js';
 export function createAgentUnpublishCommand() {
     const cmd = new Command('unpublish');
     cmd
         .description('Unpublish the latest published version of an agent')
         .argument('[identifier]', 'Agent ID or full name (e.g., owner/agent-name)')
         .action(async (agentIdArg) => {
+        const output = createOutputWriter();
         try {
             const client = new GuildAPIClient();
             // Resolve agent ID
@@ -21,44 +23,37 @@ export function createAgentUnpublishCommand() {
                 .sort((a, b) => new Date(b.created_at).getTime() - new Date(a.created_at).getTime());
             if (publishedVersions.length === 0) {
                 const agentName = config?.name || agentId;
-                console.error(`No published versions available for agent: ${agentName}`);
-                console.error('');
-                console.error('Publish a draft version:');
-                console.error('  guild agent publish');
+                output.error(`No published versions available for agent: ${agentName}`, 'Publish a draft version:\n  guild agent publish');
                 process.exit(1);
             }
             const versionToUnpublish = publishedVersions[0];
             // Check if already draft
             if (versionToUnpublish.status === 'DRAFT') {
-                console.error(`Version ${versionToUnpublish.id} is already a draft`);
-                console.error('');
-                console.error('To publish:');
-                console.error('  guild agent publish');
+                output.error(`Version ${versionToUnpublish.id} is already a draft`, 'To publish:\n  guild agent publish');
                 process.exit(1);
             }
             // Unpublish version
             await client.post(`/versions/${versionToUnpublish.id}/unpublish`, {});
-            console.log(`✓ Unpublished version ${versionToUnpublish.id}`);
-            console.log(`  Agent: ${versionToUnpublish.agent?.name || config?.name || agentId}${config ? '' : ` (${agentId})`}`);
-            console.log(`  Status: PUBLISHED → DRAFT`);
+            output.success(`Unpublished version ${versionToUnpublish.id}`, {
+                agent: `${versionToUnpublish.agent?.name || config?.name || agentId}${config ? '' : ` (${agentId})`}`,
+                status: 'PUBLISHED → DRAFT',
+            });
         }
         catch (error) {
             const formattedError = handleAxiosError(error);
             if (formattedError.code === ErrorCodes.AUTH_REQUIRED) {
-                console.error('Not authenticated. Run: guild auth login');
+                output.error('Not authenticated. Run: guild auth login');
                 process.exit(1);
             }
             if (formattedError.code === ErrorCodes.NOT_FOUND) {
-                console.error('Agent not found');
-                console.error('');
-                console.error('Run: guild agent list');
+                output.error('Agent not found', 'Run: guild agent list');
                 process.exit(1);
             }
             if (formattedError.code === ErrorCodes.CONN_REFUSED) {
-                console.error('Cannot connect to Guild servers');
+                output.error('Cannot connect to Guild servers');
                 process.exit(1);
             }
-            console.error(`Failed to unpublish version: ${formattedError.details}`);
+            output.error(`Failed to unpublish version: ${formattedError.details}`);
             process.exit(1);
         }
     });

package/dist/commands/agent/update.js

@@ -4,6 +4,7 @@ import * as readline from 'readline';
 import { GuildAPIClient } from '../../lib/api-client.js';
 import { getGuildcoreUrl } from '../../lib/config.js';
 import { handleAxiosError, ErrorCodes } from '../../lib/errors.js';
+import { createOutputWriter } from '../../lib/output.js';
 async function confirmVisibilityChange(agentName, makePublic) {
     const rl = readline.createInterface({
         input: process.stdin,
@@ -29,27 +30,15 @@ export function createAgentUpdateCommand() {
         .option('--private', 'Make the agent private (only visible to owner)')
         .option('--yes', 'Skip confirmation prompt for visibility changes')
         .action(async (agentId, options) => {
+        const output = createOutputWriter();
         // Validate that at least one option is provided
         if (!options.public && !options.private) {
-            console.error('No update options provided.');
-            console.error('');
-            console.error('Usage: guild agent update <agent-id> [options]');
-            console.error('');
-            console.error('Options:');
-            console.error('  --public              Make the agent public');
-            console.error('  --private             Make the agent private');
-            console.error('  --yes                 Skip confirmation prompt');
-            console.error('');
-            console.error('Examples:');
-            console.error('  guild agent update my-agent --public');
-            console.error('  guild agent update my-agent --private --yes');
-            console.error('');
-            console.error('Note: Agent descriptions are set from README.md when publishing.');
+            output.error('No update options provided.', 'Usage: guild agent update <agent-id> [options]\n\nOptions:\n  --public              Make the agent public\n  --private             Make the agent private\n  --yes                 Skip confirmation prompt\n\nExamples:\n  guild agent update my-agent --public\n  guild agent update my-agent --private --yes\n\nNote: Agent descriptions are set from README.md when publishing.');
             process.exit(1);
         }
         // Validate that --public and --private are not both specified
         if (options.public && options.private) {
-            console.error('Cannot specify both --public and --private');
+            output.error('Cannot specify both --public and --private');
             process.exit(1);
         }
         const baseUrl = getGuildcoreUrl();
@@ -63,14 +52,14 @@ export function createAgentUpdateCommand() {
                 const makePublic = Boolean(options.public);
                 // Check if already in desired state
                 if (agent.is_public === makePublic) {
-                    console.log(`Agent "${agent.full_name}" is already ${makePublic ? 'public' : 'private'}.`);
+                    output.progress(`Agent "${agent.full_name}" is already ${makePublic ? 'public' : 'private'}.`);
                     process.exit(0);
                 }
                 // Confirm unless --yes is specified
                 if (!options.yes) {
                     const confirmed = await confirmVisibilityChange(agent.full_name, makePublic);
                     if (!confirmed) {
-                        console.log('Cancelled.');
+                        output.progress('Cancelled.');
                         process.exit(0);
                     }
                 }
@@ -89,33 +78,27 @@ export function createAgentUpdateCommand() {
             if (changingVisibility) {
                 changes.push(`visibility: ${result.is_public ? 'public' : 'private'}`);
             }
-            console.log(JSON.stringify({
+            output.data({
                 success: 'Agent updated',
                 id: result.id,
                 full_name: result.full_name,
                 is_public: result.is_public,
                 changes: changes,
-            }, null, 2));
+            });
         }
         catch (error) {
             const formattedError = handleAxiosError(error);
             if (formattedError.code === ErrorCodes.AUTH_REQUIRED) {
-                console.error('Not logged in.');
-                console.error('');
-                console.error('Please authenticate first:');
-                console.error('  guild auth login');
+                output.error('Not logged in.', 'Please authenticate first:\n  guild auth login');
             }
             else if (formattedError.code === ErrorCodes.CONN_REFUSED) {
-                console.error('Cannot connect to Guild servers');
+                output.error('Cannot connect to Guild servers');
             }
             else if (formattedError.code === ErrorCodes.NOT_FOUND) {
-                console.error(`Agent not found: ${agentId}`);
-                console.error('');
-                console.error('Check the agent ID:');
-                console.error('  guild agent list');
+                output.error(`Agent not found: ${agentId}`, 'Check the agent ID:\n  guild agent list');
             }
             else {
-                console.error(`Failed to update agent: ${formattedError.details}`);
+                output.error(`Failed to update agent: ${formattedError.details}`);
             }
             process.exit(1);
         }

package/dist/commands/agent/versions.js

@@ -4,6 +4,7 @@ import { GuildAPIClient } from '../../lib/api-client.js';
 import { getGuildcoreUrl } from '../../lib/config.js';
 import { handleAxiosError, ErrorCodes } from '../../lib/errors.js';
 import { getAgentId } from '../../lib/agent-helpers.js';
+import { createOutputWriter } from '../../lib/output.js';
 export function createAgentVersionsCommand() {
     const cmd = new Command('versions');
     cmd
@@ -12,6 +13,7 @@ export function createAgentVersionsCommand() {
         .option('--limit <number>', 'Maximum number of versions to return', '20')
         .option('--offset <number>', 'Number of versions to skip', '0')
         .action(async (agentIdArg, options) => {
+        const output = createOutputWriter();
         // Get agent ID from argument or guild.json
         const { agentId } = await getAgentId(agentIdArg);
         const baseUrl = getGuildcoreUrl();
@@ -20,27 +22,21 @@ export function createAgentVersionsCommand() {
         const offset = parseInt(options.offset, 10);
         try {
             const result = await client.get(`/agents/${agentId}/versions?limit=${limit}&offset=${offset}`);
-            console.log(JSON.stringify(result, null, 2));
+            output.data(result);
         }
         catch (error) {
             const formattedError = handleAxiosError(error);
             if (formattedError.code === ErrorCodes.AUTH_REQUIRED) {
-                console.error('Not logged in.');
-                console.error('');
-                console.error('Please authenticate first:');
-                console.error('  guild auth login');
+                output.error('Not logged in.', 'Please authenticate first:\n  guild auth login');
             }
             else if (formattedError.code === ErrorCodes.CONN_REFUSED) {
-                console.error('Cannot connect to Guild servers');
+                output.error('Cannot connect to Guild servers');
             }
             else if (formattedError.code === ErrorCodes.NOT_FOUND) {
-                console.error(`Agent not found: ${agentId}`);
-                console.error('');
-                console.error('Check the agent ID:');
-                console.error('  guild agent list');
+                output.error(`Agent not found: ${agentId}`, 'Check the agent ID:\n  guild agent list');
             }
             else {
-                console.error(`Failed to list agent versions: ${formattedError.details}`);
+                output.error(`Failed to list agent versions: ${formattedError.details}`);
             }
             process.exit(1);
         }

package/dist/commands/auth/login.js

@@ -3,6 +3,7 @@ import { Command } from 'commander';
 import { login } from '../../lib/auth.js';
 import { configureNpmrc } from '../../lib/npmrc.js';
 import { debug } from '../../lib/errors.js';
+import { createOutputWriter } from '../../lib/output.js';
 export function createAuthLoginCommand() {
     const cmd = new Command('login');
     cmd
@@ -10,15 +11,16 @@ export function createAuthLoginCommand() {
         .option('--return-url <url>', 'Custom URL to redirect to after authentication')
         .option('--return-label <text>', 'Friendly label for return button (e.g., "VSCode")')
         .action(async (options) => {
+        const output = createOutputWriter();
         const success = await login(options.returnUrl, options.returnLabel);
         if (success) {
             try {
                 await configureNpmrc();
-                console.log('✓ Configured registry in ~/.npmrc');
+                output.progress('Configured registry in ~/.npmrc');
             }
             catch (error) {
                 debug('npmrc configuration failed:', error);
-                console.warn('⚠ Could not configure npm registry in ~/.npmrc');
+                output.error('Could not configure npm registry in ~/.npmrc');
             }
         }
         process.exit(success ? 0 : 1);

package/dist/commands/auth/logout.js

@@ -3,16 +3,18 @@ import { Command } from 'commander';
 import { logout } from '../../lib/auth.js';
 import { cleanupNpmrc } from '../../lib/npmrc.js';
 import { debug } from '../../lib/errors.js';
+import { createOutputWriter } from '../../lib/output.js';
 export function createAuthLogoutCommand() {
     const cmd = new Command('logout');
     cmd.description('Logout from Guild.ai').action(async () => {
+        const output = createOutputWriter();
         await logout();
         try {
             await cleanupNpmrc();
         }
         catch (error) {
             debug('npmrc cleanup failed:', error);
-            console.warn('⚠ Could not clean up npm registry entries from ~/.npmrc');
+            output.error('Could not clean up npm registry entries from ~/.npmrc');
         }
         process.exit(0);
     });

package/dist/commands/auth/status.js

@@ -1,16 +1,17 @@
 // Copyright (c) 2026 Guild.ai All Rights Reserved
 import { Command } from 'commander';
 import { getAuthStatus } from '../../lib/auth.js';
-import chalk from 'chalk';
+import { createOutputWriter } from '../../lib/output.js';
 export function createAuthStatusCommand() {
     const cmd = new Command('status');
     cmd.description('Check authentication status').action(async () => {
+        const output = createOutputWriter();
         const { authenticated } = await getAuthStatus();
         if (authenticated) {
-            console.log(chalk.green('\n✓ Authenticated\n'));
+            output.success('Authenticated');
         }
         else {
-            console.log(chalk.red('\n✗ Not authenticated\n'));
+            output.error('Not authenticated');
         }
         process.exit(0);
     });

package/dist/commands/auth/token.js

@@ -1,13 +1,14 @@
 // Copyright (c) 2026 Guild.ai All Rights Reserved
 import { Command } from 'commander';
-import chalk from 'chalk';
 import { getAuthToken } from '../../lib/auth.js';
+import { createOutputWriter } from '../../lib/output.js';
 export function createAuthTokenCommand() {
     const cmd = new Command('token');
     cmd.description('Print auth token to stdout (for scripting)').action(async () => {
+        const output = createOutputWriter();
         const token = await getAuthToken();
         if (!token) {
-            console.error(chalk.red('Not authenticated. Run: guild auth login'));
+            output.error('Not authenticated. Run: guild auth login');
             process.exit(1);
         }
         console.log(token);