@guildai/cli 0.3.16 → 0.3.18

package/dist/commands/workspace/select.js

@@ -4,6 +4,7 @@ import * as fs from 'fs/promises';
 import * as readline from 'readline';
 import { GuildAPIClient } from '../../lib/api-client.js';
 import { handleAxiosError, ErrorCodes } from '../../lib/errors.js';
+import { createOutputWriter } from '../../lib/output.js';
 import { isAgentDirectory, loadLocalConfig, getLocalConfigPath, getWorkspaceId, saveGlobalConfig, } from '../../lib/guild-config.js';
 /**
  * Format workspace for display with owner name.
@@ -23,37 +24,35 @@ export function createWorkspaceSelectCommand() {
         .description('Select default workspace for agent testing')
         .argument('[workspace]', 'Workspace name or ID to select directly')
         .action(async (workspaceArg) => {
+        const output = createOutputWriter();
         try {
             const client = new GuildAPIClient();
             // Use filter=all to get workspaces from all orgs user is a member of
             const workspaces = await client.get('/me/workspaces?filter=all');
             if (workspaces.items.length === 0) {
-                console.error('No workspaces found.');
-                console.error('');
-                console.error('Create a workspace first:');
-                console.error('  guild workspace create <name>');
+                output.error('No workspaces found.', 'Create a workspace first:\n  guild workspace create <name>');
                 process.exit(1);
             }
             // If a workspace argument was provided, find and select it directly
             if (workspaceArg) {
                 const workspace = workspaces.items.find((w) => w.name === workspaceArg ||
                     w.name.toLowerCase() === workspaceArg.toLowerCase() ||
+                    w.full_name === workspaceArg ||
+                    w.full_name?.toLowerCase() === workspaceArg.toLowerCase() ||
                     w.id === workspaceArg);
                 if (!workspace) {
-                    console.error(`Workspace "${workspaceArg}" not found.`);
-                    console.error('');
-                    console.error('Available workspaces:');
-                    workspaces.items.forEach((w) => {
-                        console.error(`  - ${formatWorkspaceDisplay(w)}`);
-                    });
+                    const available = workspaces.items
+                        .map((w) => `  - ${formatWorkspaceDisplay(w)}`)
+                        .join('\n');
+                    output.error(`Workspace "${workspaceArg}" not found.`, `Available workspaces:\n${available}`);
                     process.exit(1);
                 }
                 const target = await saveWorkspaceConfig(workspace.id, workspace.name);
                 if (target === 'local') {
-                    console.log(`✓ Workspace set for this agent: ${formatWorkspaceDisplay(workspace)}`);
+                    output.success(`Workspace set for this agent: ${formatWorkspaceDisplay(workspace)}`);
                 }
                 else {
-                    console.log(`✓ Default workspace set to: ${formatWorkspaceDisplay(workspace)}`);
+                    output.success(`Default workspace set to: ${formatWorkspaceDisplay(workspace)}`);
                 }
                 return;
             }
@@ -85,33 +84,29 @@ export function createWorkspaceSelectCommand() {
             }
             const selection = parseInt(answer.trim(), 10);
             if (isNaN(selection) || selection < 1 || selection > workspaces.items.length) {
-                console.error('Invalid selection');
+                output.error('Invalid selection');
                 process.exit(1);
             }
             const selectedWorkspace = workspaces.items[selection - 1];
             const target = await saveWorkspaceConfig(selectedWorkspace.id, selectedWorkspace.name);
             if (target === 'local') {
-                console.log(`✓ Workspace set for this agent: ${formatWorkspaceDisplay(selectedWorkspace)}`);
+                output.success(`Workspace set for this agent: ${formatWorkspaceDisplay(selectedWorkspace)}`);
             }
             else {
-                console.log(`✓ Default workspace set to: ${formatWorkspaceDisplay(selectedWorkspace)}`);
+                output.success(`Default workspace set to: ${formatWorkspaceDisplay(selectedWorkspace)}`);
             }
         }
         catch (error) {
             const formattedError = handleAxiosError(error);
             if (formattedError.code === ErrorCodes.AUTH_REQUIRED) {
-                console.error('Not authenticated. Please log in first.');
-                console.error('');
-                console.error('Run: guild auth login');
+                output.error('Not authenticated. Please log in first.', 'Run: guild auth login');
                 process.exit(1);
             }
             if (formattedError.code === ErrorCodes.CONN_REFUSED) {
-                console.error(`Failed to fetch workspaces: ${formattedError.details}`);
-                console.error('');
-                console.error('Run with --debug for more details');
+                output.error(`Failed to fetch workspaces: ${formattedError.details}`, 'Run with --debug for more details');
                 process.exit(1);
             }
-            console.error(`Failed to select workspace: ${formattedError.details}`);
+            output.error(`Failed to select workspace: ${formattedError.details}`);
             process.exit(1);
         }
     });

package/dist/index.js

@@ -28,6 +28,7 @@ import { createAgentUnpublishCommand } from './commands/agent/unpublish.js';
 import { createAgentRevalidateCommand } from './commands/agent/revalidate.js';
 import { createAgentSearchCommand } from './commands/agent/search.js';
 import { createAgentOwnersCommand } from './commands/agent/owners.js';
+import { createAgentWorkspacesCommand } from './commands/agent/workspaces.js';
 import { createAgentTagsListCommand } from './commands/agent/tags/list.js';
 import { createAgentTagsAddCommand } from './commands/agent/tags/add.js';
 import { createAgentTagsRemoveCommand } from './commands/agent/tags/remove.js';
@@ -131,6 +132,7 @@ agentCmd.addCommand(createAgentUnpublishCommand());
 agentCmd.addCommand(createAgentRevalidateCommand());
 agentCmd.addCommand(createAgentSearchCommand());
 agentCmd.addCommand(createAgentOwnersCommand());
+agentCmd.addCommand(createAgentWorkspacesCommand());
 // Agent tags subcommand group
 const tagsCmd = agentCmd.command('tags').description('Manage agent tags');
 tagsCmd.addCommand(createAgentTagsListCommand());

package/dist/lib/agent-helpers.js

@@ -66,8 +66,8 @@ export async function readAgentFiles(cwd) {
         const content = await fs.readFile(fullPath, 'utf-8');
         files.push({ path: filePath, content });
     }
-    const fileNames = files.map((f) => f.path);
-    const missing = REQUIRED_AGENT_FILES.filter((f) => !fileNames.includes(f));
+    const filePaths = files.map((f) => f.path);
+    const missing = REQUIRED_AGENT_FILES.filter((req) => !filePaths.some((fp) => fp === req || fp.endsWith(`/${req}`)));
     if (missing.length > 0) {
         throw new Error(`Missing required files: ${missing.join(', ')}`);
     }

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

@@ -1,4 +1,4 @@
-export declare const WEBHOOK_SERVICES: readonly ["AZURE_DEVOPS", "BITBUCKET", "CYPRESS", "GITHUB", "GOOGLE_DOCS", "JIRA", "LINEAR", "NEWRELIC", "NOTION", "SLACK", "TESTRAIL", "ZENDESK"];
+export declare const WEBHOOK_SERVICES: readonly ["AZURE_DEVOPS", "BITBUCKET", "CYPRESS", "GITHUB", "GOOGLE_DOCS", "GOOGLE_LOGGING", "JIRA", "LINEAR", "NEWRELIC", "NOTION", "SLACK", "TESTRAIL", "ZENDESK"];
 export type WebhookService = (typeof WEBHOOK_SERVICES)[number];
 export declare const TIME_TRIGGER_FREQUENCIES: readonly ["HOURLY", "DAILY", "WEEKLY", "MONTHLY"];
 export type TimeTriggerFrequency = (typeof TIME_TRIGGER_FREQUENCIES)[number];

package/dist/lib/generated-types.js

@@ -13,6 +13,7 @@ export const WEBHOOK_SERVICES = [
     'CYPRESS',
     'GITHUB',
     'GOOGLE_DOCS',
+    'GOOGLE_LOGGING',
     'JIRA',
     'LINEAR',
     'NEWRELIC',

package/dist/lib/npmrc.js

@@ -17,6 +17,7 @@ export async function configureNpmrc() {
     }
     try {
         await execa('npm', [
+            '--workspaces=false',
             'config',
             'set',
             '--location',
@@ -36,7 +37,14 @@ export async function cleanupNpmrc() {
     const keys = [...SCOPES.map((s) => `${s}:registry`), `${scope}:_authToken`];
     for (const key of keys) {
         try {
-            await execa('npm', ['config', 'delete', '--location', 'user', key]);
+            await execa('npm', [
+                '--workspaces=false',
+                'config',
+                'delete',
+                '--location',
+                'user',
+                key,
+            ]);
         }
         catch {
             // Key may not exist, that's fine

package/dist/lib/output.d.ts

@@ -1,5 +1,5 @@
 import { type Spinner } from './progress.js';
-import type { Agent, Pagination, Workspace, Trigger } from './api-types.js';
+import type { Agent, AgentVersion, Context, Pagination, Workspace, WorkspaceAgent, Trigger } from './api-types.js';
 /**
  * Session type from API responses
  */
@@ -19,6 +19,21 @@ interface Session {
  * Shared by agent list and agent search commands.
  */
 export declare function formatAgentTable(agents: Agent[], pagination: Pagination): void;
+/**
+ * Format an agent version list as a human-readable table.
+ * Used by agent versions command.
+ */
+export declare function formatVersionTable(versions: AgentVersion[], pagination: Pagination): void;
+/**
+ * Format a context list as a human-readable table.
+ * Used by workspace context list command.
+ */
+export declare function formatContextTable(contexts: Context[], pagination: Pagination): void;
+/**
+ * Format a workspace agent list as a human-readable table.
+ * Used by workspace agent list command.
+ */
+export declare function formatWorkspaceAgentTable(agents: WorkspaceAgent[]): void;
 /**
  * Format a workspace list as a human-readable table.
  * Used by workspace list command.
@@ -38,7 +53,7 @@ export declare function formatTriggerTable(triggers: Trigger[], pagination: Pagi
  * Output writer interface for consistent CLI output
  *
  * Implementations:
- * - HumanOutputWriter: Colors, tables, spinners for interactive use
+ * - InteractiveOutputWriter: Colors, tables, spinners for interactive use
  * - JSONOutputWriter: Pure JSON for scripting and automation
  */
 export interface OutputWriter {
@@ -69,9 +84,8 @@ export interface OutputWriter {
  * Uses colors, symbols, and formatting for readability.
  * Progress goes to stderr.
  */
-export declare class HumanOutputWriter implements OutputWriter {
+export declare class InteractiveOutputWriter implements OutputWriter {
     data(value: unknown): void;
-    private isAgentListResponse;
     success(message: string, details?: Record<string, unknown>): void;
     error(message: string, details?: string): void;
     progress(message: string): void;

package/dist/lib/output.js

@@ -76,6 +76,112 @@ export function formatAgentTable(agents, pagination) {
         console.log(chalk.dim(`\nShowing ${showing} of ${pagination.total_count} agents`));
     }
 }
+/**
+ * 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: 'sha', title: 'SHA', 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({
+            sha: v.sha.slice(0, 7),
+            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();
+    const showing = Math.min(pagination.limit, versions.length);
+    if (pagination.has_more) {
+        const nextOffset = pagination.offset + pagination.limit;
+        console.log(`\nShowing ${showing} of ${pagination.total_count} versions. ` +
+            chalk.dim(`Use --offset ${nextOffset} to see more.`));
+    }
+    else if (pagination.total_count > showing) {
+        console.log(chalk.dim(`\nShowing ${showing} of ${pagination.total_count} 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: truncate(ctx.id, 12),
+            status: ctx.status,
+            type: ctx.type || '-',
+            created: ctx.created_at ? formatRelativeTime(ctx.created_at) : '',
+        });
+    });
+    table.printTable();
+    const showing = Math.min(pagination.limit, contexts.length);
+    if (pagination.has_more) {
+        const nextOffset = pagination.offset + pagination.limit;
+        console.log(`\nShowing ${showing} of ${pagination.total_count} contexts. ` +
+            chalk.dim(`Use --offset ${nextOffset} to see more.`));
+    }
+    else if (pagination.total_count > showing) {
+        console.log(chalk.dim(`\nShowing ${showing} of ${pagination.total_count} 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' },
+        ],
+    });
+    agents.forEach((wa) => {
+        table.addRow({
+            name: wa.agent.full_name || wa.agent.name,
+            version: wa.agent_version.version_number || wa.agent_version.sha.slice(0, 7),
+            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.
@@ -199,28 +305,15 @@ export function formatTriggerTable(triggers, pagination) {
  * Uses colors, symbols, and formatting for readability.
  * Progress goes to stderr.
  */
-export class HumanOutputWriter {
+export class InteractiveOutputWriter {
     data(value) {
-        // Special handling for agent list responses
-        if (this.isAgentListResponse(value)) {
-            formatAgentTable(value.items, value.pagination);
-            return;
-        }
-        // Fallback to pretty JSON for other data
         console.log(JSON.stringify(value, null, 2));
     }
-    isAgentListResponse(value) {
-        return (typeof value === 'object' &&
-            value !== null &&
-            'items' in value &&
-            'pagination' in value &&
-            Array.isArray(value.items));
-    }
     success(message, details) {
-        console.log(chalk.green('✓'), message);
+        process.stderr.write(chalk.green('✓') + ' ' + message + '\n');
         if (details) {
             Object.entries(details).forEach(([k, v]) => {
-                console.log(`  ${k}: ${brand(String(v))}`);
+                process.stderr.write(`  ${k}: ${brand(String(v))}\n`);
             });
         }
     }
@@ -253,10 +346,10 @@ export class JSONOutputWriter {
         console.log(JSON.stringify(value, null, 2));
     }
     success(message, details) {
-        this.data({ success: true, message, ...details });
+        process.stderr.write(JSON.stringify({ success: true, message, ...details }) + '\n');
     }
     error(message, details) {
-        this.data({ success: false, error: message, details });
+        process.stderr.write(JSON.stringify({ success: false, error: message, details }) + '\n');
     }
     progress(message) {
         if (!isQuietMode()) {
@@ -273,7 +366,7 @@ export class JSONOutputWriter {
  */
 export function createOutputWriter() {
     const mode = getOutputMode();
-    return mode === 'json' ? new JSONOutputWriter() : new HumanOutputWriter();
+    return mode === 'json' ? new JSONOutputWriter() : new InteractiveOutputWriter();
 }
 /**
  * Create a no-op spinner (for quiet/JSON modes)

package/docs/getting-started.md

@@ -316,7 +316,7 @@ guild agent code               # View source of latest version
 
 ## Key Rules
 
-- Agent code lives at `agent.ts` in the project root.
+- Agent code lives in `agent.ts` (typically at the project root, but can be in a subdirectory like `src/`).
 - Don't add `@guildai/agents-sdk`, `zod`, or `@guildai-services/*` to `package.json`. The runtime provides them. Only add third-party packages you actually use.
 - Always call tools through `task.tools.<name>(args)`. Never access services directly.
 - Always use `guild agent save` to commit and `guild agent pull` to sync. Don't use raw git commands.

package/docs/output-format.md

@@ -46,7 +46,7 @@ interface OutputWriter {
 
 Two implementations:
 
-- `HumanOutputWriter` - Colors, symbols, formatted output
+- `InteractiveOutputWriter` - Colors, symbols, formatted output
 - `JSONOutputWriter` - Pure JSON
 
 Commands use `createOutputWriter()` to get the right implementation based on flags.

package/docs/skills/agent-dev.md

@@ -489,10 +489,23 @@ async function onToolResults(
 
 ### Slack-Specific Patterns
 
-When posting to Slack, convert markdown to Slack's mrkdwn format:
+When posting to Slack, convert markdown to Slack's mrkdwn format. Use an inline converter
+(`slackify-markdown` is CJS and breaks in the ESM agent runtime):
 
 ```typescript
-import slackifyMarkdown from 'slackify-markdown';
+// Simple markdown-to-Slack-mrkdwn converter (inline — do NOT use slackify-markdown)
+function slackifyMarkdown(md: string): string {
+  return md
+    .replace(/\*\*(.+?)\*\*/g, '*$1*') // bold: **text** → *text*
+    .replace(/(?<!\*)\*(?!\*)(.+?)(?<!\*)\*(?!\*)/g, '_$1_') // italic: *text* → _text_
+    .replace(/~~(.+?)~~/g, '~$1~') // strikethrough
+    .replace(/^### (.+)$/gm, '*$1*') // h3 → bold
+    .replace(/^## (.+)$/gm, '*$1*') // h2 → bold
+    .replace(/^# (.+)$/gm, '*$1*') // h1 → bold
+    .replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<$2|$1>') // links
+    .replace(/^> (.+)$/gm, '> $1') // blockquotes (same syntax)
+    .replace(/`([^`]+)`/g, '`$1`'); // inline code (same syntax)
+}
 
 // In your agent:
 const responseText = '## Summary\n- Item 1\n- Item 2';
@@ -504,16 +517,6 @@ await task.tools.slack_chat_post_message({
 });
 ```
 
-Add `slackify-markdown` to `package.json` dependencies:
-
-```json
-{
-  "dependencies": {
-    "slackify-markdown": "^4.5.0"
-  }
-}
-```
-
 ---
 
 ## Anti-Hallucination Guide
@@ -620,9 +623,7 @@ export default agent({ run: async (input, task) => { ... } })
   "version": "1.0.0",
   "author": "Guild.ai",
   "type": "module",
-  "dependencies": {
-    "slackify-markdown": "^4.5.0"
-  },
+  "dependencies": {},
   "devDependencies": {
     "typescript": "^5.0.0"
   }
@@ -632,7 +633,7 @@ export default agent({ run: async (input, task) => { ... } })
 **Important:**
 
 - Do NOT add `@guildai/agents-sdk`, `@guildai-services/*`, or `zod` to dependencies. The runtime provides them.
-- DO add third-party packages your agent uses (e.g., `slackify-markdown`) to `dependencies`.
+- DO add third-party ESM-compatible packages your agent uses to `dependencies`. Note: CJS-only packages (e.g., `slackify-markdown`) will break in the ESM agent runtime — use inline alternatives instead.
 - `devDependencies` is for build tools only.
 
 ## Versioning
@@ -649,7 +650,7 @@ After `guild agent create` + `guild agent init`:
 my-agent/
 ├── .git/              # Git repo (remote is Guild server)
 ├── .gitignore         # Includes guild.json
-├── agent.ts           # Your agent code (at project root, NOT in src/)
+├── agent.ts           # Your agent code (default location; can also be in src/)
 ├── package.json       # Dependencies
 ├── tsconfig.json      # TypeScript config
 └── guild.json         # Agent ID (gitignored, local only)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guildai/cli",
-  "version": "0.3.16",
+  "version": "0.3.18",
   "description": "Guild.ai CLI - Build, test, and deploy AI agents",
   "type": "module",
   "main": "dist/index.js",