@guildai/cli 0.3.17 → 0.3.18

package/dist/commands/agent/clone.js

@@ -4,25 +4,9 @@ import { GuildAPIClient } from '../../lib/api-client.js';
 import { handleAxiosError, ErrorCodes } from '../../lib/errors.js';
 import * as fs from 'fs/promises';
 import * as path from 'path';
-import * as readline from 'readline';
 import { getAuthenticatedUrl } from '../../lib/auth.js';
 import { runGit, GitError, formatGitError } from '../../lib/git.js';
 import { createOutputWriter } from '../../lib/output.js';
-async function promptForDirectory(suggestedDir) {
-    const rl = readline.createInterface({
-        input: process.stdin,
-        output: process.stdout,
-    });
-    return new Promise((resolve) => {
-        rl.question(`Target directory (default: ${suggestedDir}): `, (answer) => {
-            rl.close();
-            resolve(answer.trim() || suggestedDir);
-        });
-    });
-}
-function isInteractive() {
-    return process.stdin.isTTY === true;
-}
 async function isDirectoryEmpty(dirPath) {
     try {
         const files = await fs.readdir(dirPath);
@@ -51,18 +35,8 @@ export function createAgentCloneCommand() {
                 process.exit(1);
             }
             output.progress(`✓ Fetched agent '${agent.name}' (${agent.id})`);
-            // Determine target directory
-            let targetDir = options.directory;
-            if (!targetDir) {
-                if (isInteractive()) {
-                    const suggestedDir = `./${agent.name}`;
-                    targetDir = await promptForDirectory(suggestedDir);
-                }
-                else {
-                    output.error('Error: Target directory required in non-interactive mode', `Provide a directory:\n  guild agent clone ${agentId} --directory ./my-agent\n\nOr run interactively to be prompted.`);
-                    process.exit(1);
-                }
-            }
+            // Determine target directory (default to agent name, like git clone)
+            const targetDir = options.directory || agent.name;
             // Check if directory exists and is not empty
             const dirExists = await fs
                 .access(targetDir)

package/dist/commands/agent/list.js

@@ -3,7 +3,8 @@ import { Command } from 'commander';
 import { GuildAPIClient } from '../../lib/api-client.js';
 import { getAuthToken } from '../../lib/auth.js';
 import { handleAxiosError } from '../../lib/errors.js';
-import { createOutputWriter } from '../../lib/output.js';
+import { getOutputMode } from '../../lib/output-mode.js';
+import { createOutputWriter, formatAgentTable } from '../../lib/output.js';
 const SORT_MAP = {
     updated: 'updated_at',
     newest: 'created_at',
@@ -42,7 +43,12 @@ export function createAgentListCommand() {
                 params.append('sort_by', sortField);
             }
             const response = await client.get(`/agents?${params.toString()}`);
-            output.data(response);
+            if (getOutputMode() === 'json') {
+                output.data(response);
+            }
+            else {
+                formatAgentTable(response.items, response.pagination);
+            }
         }
         catch (error) {
             const formattedError = handleAxiosError(error);

package/dist/commands/agent/save.js

@@ -2,6 +2,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 { createOutputWriter } from '../../lib/output.js';
 import * as fs from 'fs/promises';
 import * as path from 'path';
@@ -254,8 +255,12 @@ export function createAgentSaveCommand() {
                 output.progress('To publish this version:');
                 output.progress('  guild agent save --message "..." --publish');
             }
-            // Output JSON to stdout for programmatic use
-            output.data({ version });
+            // 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') {
+                output.data({ version });
+            }
         }
         catch (error) {
             if (error instanceof GitError) {

package/dist/commands/agent/search.js

@@ -3,7 +3,8 @@ import { Command } from 'commander';
 import { GuildAPIClient } from '../../lib/api-client.js';
 import { getAuthToken } from '../../lib/auth.js';
 import { handleAxiosError } from '../../lib/errors.js';
-import { createOutputWriter } from '../../lib/output.js';
+import { getOutputMode } from '../../lib/output-mode.js';
+import { createOutputWriter, formatAgentTable } from '../../lib/output.js';
 const SORT_MAP = {
     updated: 'updated_at',
     newest: 'created_at',
@@ -40,7 +41,12 @@ export function createAgentSearchCommand() {
                 params.append('sort_by', sortField);
             }
             const response = await client.get(`/agents?${params.toString()}`);
-            output.data(response);
+            if (getOutputMode() === 'json') {
+                output.data(response);
+            }
+            else {
+                formatAgentTable(response.items, response.pagination);
+            }
         }
         catch (error) {
             const formattedError = handleAxiosError(error);

package/dist/commands/agent/versions.js

@@ -4,7 +4,8 @@ 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';
+import { getOutputMode } from '../../lib/output-mode.js';
+import { createOutputWriter, formatVersionTable } from '../../lib/output.js';
 export function createAgentVersionsCommand() {
     const cmd = new Command('versions');
     cmd
@@ -22,7 +23,12 @@ export function createAgentVersionsCommand() {
         const offset = parseInt(options.offset, 10);
         try {
             const result = await client.get(`/agents/${agentId}/versions?limit=${limit}&offset=${offset}`);
-            output.data(result);
+            if (getOutputMode() === 'json') {
+                output.data(result);
+            }
+            else {
+                formatVersionTable(result.items, result.pagination);
+            }
         }
         catch (error) {
             const formattedError = handleAxiosError(error);

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

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

package/dist/commands/agent/workspaces.js

@@ -0,0 +1,51 @@
+// Copyright (c) 2026 Guild.ai All Rights Reserved
+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 } from '../../lib/agent-helpers.js';
+import { createOutputWriter, formatWorkspaceTable } from '../../lib/output.js';
+import { getOutputMode } from '../../lib/output-mode.js';
+export function createAgentWorkspacesCommand() {
+    const cmd = new Command('workspaces');
+    cmd
+        .description('List workspaces that use an agent')
+        .argument('[identifier]', 'Agent ID or full name (e.g., owner/agent-name)')
+        .option('--limit <number>', 'Maximum number of workspaces to return', '20')
+        .option('--offset <number>', 'Number of workspaces to skip', '0')
+        .action(async (agentIdArg, options) => {
+        const output = createOutputWriter();
+        const { agentId } = await getAgentId(agentIdArg);
+        const baseUrl = getGuildcoreUrl();
+        const client = new GuildAPIClient({ baseUrl });
+        const limit = parseInt(options.limit, 10);
+        const offset = parseInt(options.offset, 10);
+        try {
+            const result = await client.get(`/agents/${agentId}/workspaces?limit=${limit}&offset=${offset}`);
+            if (getOutputMode() === 'json') {
+                output.data(result);
+            }
+            else {
+                formatWorkspaceTable(result.items, result.pagination);
+            }
+        }
+        catch (error) {
+            const formattedError = handleAxiosError(error);
+            if (formattedError.code === ErrorCodes.AUTH_REQUIRED) {
+                output.error('Not logged in.', '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 not found: ${agentId}`, 'Check the agent ID:\n  guild agent list');
+            }
+            else {
+                output.error(`Failed to list workspaces: ${formattedError.details}`);
+            }
+            process.exit(1);
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=workspaces.js.map

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

@@ -4,7 +4,8 @@ import { GuildAPIClient } from '../../../lib/api-client.js';
 import { getAuthToken } from '../../../lib/auth.js';
 import { getWorkspaceId } from '../../../lib/guild-config.js';
 import { handleAxiosError, ErrorCodes } from '../../../lib/errors.js';
-import { createOutputWriter } from '../../../lib/output.js';
+import { createOutputWriter, formatWorkspaceAgentTable } from '../../../lib/output.js';
+import { getOutputMode } from '../../../lib/output-mode.js';
 export function createWorkspaceAgentListCommand() {
     const cmd = new Command('list');
     cmd
@@ -36,12 +37,12 @@ export function createWorkspaceAgentListCommand() {
             params.append('limit', options.limit);
             params.append('offset', options.offset);
             const response = await client.get(`/workspaces/${workspaceId}/workspace_agents?${params.toString()}`);
-            const agents = response.items;
-            if (agents.length === 0) {
-                output.data({ items: [], message: 'No agents installed in this workspace.' });
-                return;
+            if (getOutputMode() === 'json') {
+                output.data(response);
+            }
+            else {
+                formatWorkspaceAgentTable(response.items);
             }
-            output.data(response);
         }
         catch (error) {
             const formattedError = handleAxiosError(error);

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

@@ -2,7 +2,8 @@
 import { Command } from 'commander';
 import { GuildAPIClient } from '../../../lib/api-client.js';
 import { handleAxiosError, ErrorCodes } from '../../../lib/errors.js';
-import { createOutputWriter } from '../../../lib/output.js';
+import { getOutputMode } from '../../../lib/output-mode.js';
+import { createOutputWriter, formatContextTable } from '../../../lib/output.js';
 export function createWorkspaceContextListCommand() {
     const cmd = new Command('list');
     cmd
@@ -18,7 +19,12 @@ export function createWorkspaceContextListCommand() {
             params.append('limit', options.limit);
             params.append('offset', options.offset);
             const response = await client.get(`/workspaces/${workspaceId}/contexts?${params.toString()}`);
-            output.data(response);
+            if (getOutputMode() === 'json') {
+                output.data(response);
+            }
+            else {
+                formatContextTable(response.items, response.pagination);
+            }
         }
         catch (error) {
             const formattedError = handleAxiosError(error);

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,23 +305,10 @@ 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) {
         process.stderr.write(chalk.green('✓') + ' ' + message + '\n');
         if (details) {
@@ -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.17",
+  "version": "0.3.18",
   "description": "Guild.ai CLI - Build, test, and deploy AI agents",
   "type": "module",
   "main": "dist/index.js",