@guildai/cli 0.6.2 → 0.7.1

package/dist/commands/agent/test.js

@@ -13,13 +13,13 @@ import { handleAxiosError, ErrorCodes } from '../../lib/errors.js';
 import { format } from '../../lib/progress.js';
 import { showBetaGuidance } from '../../lib/auth.js';
 import * as readline from 'readline';
+import { parseEventFilter } from '../../lib/event-filter.js';
 import { isQuietMode, getOutputMode } from '../../lib/output-mode.js';
-import { pollForResponse } from '../../lib/session-polling.js';
+import { pollForResponse, pollForResponseWithEvents, } from '../../lib/session-polling.js';
 import { readStdinAsJSON, ensureInteractiveStdin } from '../../lib/stdin.js';
 import { loadLocalConfig, getWorkspaceId } from '../../lib/guild-config.js';
-import { runGit, GitError, formatGitError } from '../../lib/git.js';
-import { pollUntilComplete } from '../../lib/polling.js';
-import { readAgentFiles } from '../../lib/agent-helpers.js';
+import { GitError, formatGitError } from '../../lib/git.js';
+import { readAgentFiles, buildEphemeralVersion, BuildTimeoutError, BuildFailedError, } from '../../lib/agent-helpers.js';
 import { fetchSession, fetchSessionEvents } from '../../lib/session-resume.js';
 import { ChatApp, ensureAuthenticated } from '../chat.js';
 import { suppressScrollbackClear } from '../../lib/alternate-screen.js';
@@ -33,11 +33,17 @@ export function createAgentTestCommand() {
         .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('--ephemeral', 'Test unsaved changes via ephemeral version (no guild agent save required)')
+        .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('--no-cache', 'Skip ephemeral build cache (force a fresh build)')
         .action(async (options) => {
         const cwd = process.cwd();
+        // Parse --events filter once, before any branching
+        const eventFilter = options.events
+            ? parseEventFilter(options.events)
+            : undefined;
         try {
             // Handle --resume: skip build, fetch existing session, hand off to ChatApp
             if (options.resume) {
@@ -57,6 +63,7 @@ export function createAgentTestCommand() {
                     resumeSession,
                     resumeEvents,
                     resumeCommand,
+                    eventFilter,
                 }), { exitOnCtrlC: false });
                 await waitUntilExit();
                 return;
@@ -75,49 +82,6 @@ export function createAgentTestCommand() {
                 console.error('  guild agent clone <agent-id>');
                 process.exit(1);
             }
-            // For ephemeral mode, we skip git checks and read files directly
-            // For committed mode, we require a clean working tree
-            let commitSha = null;
-            let agentFiles = null;
-            if (options.ephemeral) {
-                // Ephemeral mode: read files from disk
-                try {
-                    agentFiles = await readAgentFiles(cwd);
-                }
-                catch (error) {
-                    const err = error;
-                    console.error('Error: Could not read agent files');
-                    console.error('');
-                    console.error(err.message);
-                    console.error('');
-                    console.error('Ensure you are in an agent directory with:');
-                    console.error('  - agent.ts (required)');
-                    console.error('  - package.json (required)');
-                    process.exit(1);
-                }
-            }
-            else {
-                // Committed mode: require clean working tree
-                const { stdout: statusOutput } = await runGit(['status', '--porcelain'], {
-                    cwd,
-                });
-                if (statusOutput.trim().length > 0) {
-                    console.error('Error: Working tree has unsaved changes');
-                    console.error('');
-                    console.error('Options:');
-                    console.error('  1. Save your changes first:');
-                    console.error('       guild agent save --message "your changes"');
-                    console.error('');
-                    console.error('  2. Test unsaved changes:');
-                    console.error('       guild agent test --ephemeral');
-                    process.exit(1);
-                }
-                // Get commit SHA
-                const { stdout: shaOutput } = await runGit(['rev-parse', 'HEAD'], {
-                    cwd,
-                });
-                commitSha = shaOutput.trim();
-            }
             // If using JSON input, read and validate it early (before auth/session creation)
             // This provides better UX - fail fast on bad JSON without needing auth
             let inputData;
@@ -156,35 +120,60 @@ export function createAgentTestCommand() {
             }
             // Validate auth before any API calls or UI rendering
             await ensureAuthenticated();
-            // Create version for testing
+            // Resolve version for testing
             const client = new GuildAPIClient();
             let version;
+            let ephemeralCached = false;
             try {
-                if (options.ephemeral && agentFiles) {
-                    // Ephemeral version: send file contents directly
-                    version = (await client.post(`/agents/${guildConfig.agent_id}/versions`, {
-                        files: agentFiles,
-                        summary: '[Test] Ephemeral development version',
-                        version_type: 'EPHEMERAL',
-                    }));
-                }
-                else {
-                    // Committed mode: check if a version for this commit already exists
+                if (options.agentVersion) {
+                    // Explicit version: look it up by ID or version number
                     const existingVersions = (await client.get(`/agents/${guildConfig.agent_id}/versions`));
-                    const existing = existingVersions.items.find((v) => v.sha === commitSha);
-                    if (existing) {
-                        version = existing;
-                    }
-                    else {
-                        version = (await client.post(`/agents/${guildConfig.agent_id}/versions`, {
-                            commit_sha: commitSha,
-                            summary: '[Test] Development version',
-                            version_type: 'COMMITTED',
-                        }));
+                    const match = existingVersions.items.find((v) => v.id === options.agentVersion ||
+                        v.version_number === options.agentVersion);
+                    if (!match) {
+                        console.error(`Error: Version not found: ${options.agentVersion}`);
+                        console.error('');
+                        console.error('List available versions:');
+                        console.error(`  guild agent versions ${guildConfig.agent_id}`);
+                        process.exit(1);
                     }
+                    version = match;
+                }
+                else {
+                    // Default: build ephemeral version from working directory,
+                    // reusing the last build if files haven't changed.
+                    const agentFiles = await readAgentFiles(cwd);
+                    const noCache = options.cache === false;
+                    const result = await buildEphemeralVersion(client, guildConfig.agent_id, agentFiles, cwd, '[Test] Ephemeral development version', { noCache });
+                    version = result.version;
+                    ephemeralCached = result.cached;
                 }
             }
             catch (error) {
+                if (error instanceof BuildTimeoutError) {
+                    console.error('Error: Build did not complete');
+                    console.error('');
+                    console.error(error.message);
+                    console.error('');
+                    console.error('Check build status:');
+                    console.error('  guild agent versions');
+                    process.exit(1);
+                }
+                if (error instanceof BuildFailedError) {
+                    console.error(`Error: ${error.message}`);
+                    process.exit(1);
+                }
+                if (error instanceof Error &&
+                    error.message.startsWith('Missing required')) {
+                    console.error('Error: Could not read agent files');
+                    console.error('');
+                    console.error(error.message);
+                    console.error('');
+                    console.error('Ensure you are in an agent directory with:');
+                    console.error('  - agent.ts (required)');
+                    console.error('  - package.json (required)');
+                    process.exit(1);
+                }
                 const formattedError = handleAxiosError(error);
                 if (formattedError.code === ErrorCodes.NOT_FOUND) {
                     console.error(`Error: Agent not found: ${guildConfig.agent_id}`);
@@ -200,61 +189,6 @@ export function createAgentTestCommand() {
                 }
                 throw error;
             }
-            // Wait for validation to complete
-            const pollResult = await pollUntilComplete({
-                resourceId: version.id,
-                endpoint: `/versions/${version.id}`,
-                isComplete: (response) => response.validation_status !== 'PENDING' &&
-                    response.validation_status !== 'RUNNING',
-                message: 'Building...',
-                successMessage: 'Build finished',
-                timeoutMessage: 'Build timed out',
-                maxAttempts: 120,
-                delayMs: 1000,
-            });
-            if (!pollResult.success || !pollResult.response) {
-                console.error('Error: Build did not complete');
-                console.error('');
-                console.error('The agent version build timed out or failed to report status.');
-                console.error('');
-                console.error('Check build status:');
-                console.error(`  guild agent versions ${guildConfig.agent_id}`);
-                console.error('');
-                console.error('Retry the test:');
-                console.error('  guild agent test');
-                process.exit(1);
-            }
-            version = pollResult.response;
-            if (version.validation_status === 'FAILED') {
-                console.error('Error: Build failed');
-                console.error('');
-                // Fetch validation steps to show the actual error
-                try {
-                    const stepsResponse = await client.get(`/versions/${version.id}/validation/steps`);
-                    const failedSteps = stepsResponse.steps.filter((step) => step.status === 'FAILED');
-                    if (failedSteps.length > 0) {
-                        for (const step of failedSteps) {
-                            console.error(`Step "${step.name}" failed:`);
-                            if (step.content) {
-                                console.error(step.content);
-                            }
-                            console.error('');
-                        }
-                    }
-                    else {
-                        console.error('No failed steps found. Check validation logs for details.');
-                        console.error('');
-                    }
-                }
-                catch {
-                    // If we can't fetch steps, just show generic message
-                    console.error('Could not fetch validation details.');
-                    console.error('');
-                }
-                console.error('Fix the issues and retry:');
-                console.error('  guild agent test');
-                process.exit(1);
-            }
             // Create test session
             let session;
             try {
@@ -280,9 +214,11 @@ export function createAgentTestCommand() {
             const quiet = isQuietMode();
             if (!quiet) {
                 console.log(`✓ Agent: ${guildConfig.name} (${guildConfig.agent_id})`);
-                const versionDisplay = options.ephemeral
-                    ? 'ephemeral (unsaved changes)'
-                    : commitSha?.substring(0, 12) || 'unknown';
+                const versionDisplay = options.agentVersion
+                    ? options.agentVersion
+                    : ephemeralCached
+                        ? 'ephemeral (cached, no changes)'
+                        : 'ephemeral (working directory)';
                 console.log(`✓ Version: ${versionDisplay}`);
                 console.log(`✓ Workspace: ${workspaceId}`);
                 const sessionLink = session.session_url
@@ -305,7 +241,9 @@ export function createAgentTestCommand() {
                     });
                     // Poll for response (starting from beginning)
                     // 3 minutes - allow time for agents that use LLM calls for input parsing
-                    const { response } = await pollForResponse(client, session.id, undefined, 180000);
+                    const { response } = eventFilter
+                        ? await pollForResponseWithEvents(client, session.id, eventFilter, undefined, 180000)
+                        : await pollForResponse(client, session.id, undefined, 180000);
                     if (!response) {
                         console.error('Error: No response received from agent within timeout');
                         console.error('');
@@ -381,7 +319,9 @@ export function createAgentTestCommand() {
                             content: jsonInput,
                         });
                         // Wait for response (looking for events after last seen)
-                        const result = await pollForResponse(client, session.id, lastEventId, 180000);
+                        const result = eventFilter
+                            ? await pollForResponseWithEvents(client, session.id, eventFilter, lastEventId, 180000)
+                            : await pollForResponse(client, session.id, lastEventId, 180000);
                         lastEventId = result.lastEventId;
                         if (!result.response) {
                             console.error(`Timeout: No response for line ${lineNumber}`);
@@ -430,6 +370,7 @@ export function createAgentTestCommand() {
                 resumeSession: session,
                 resumeEvents: [],
                 resumeCommand,
+                eventFilter,
             }), { exitOnCtrlC: false });
             await waitUntilExit();
         }
@@ -452,7 +393,6 @@ export function createAgentTestCommand() {
             console.error('Failed to start test session. Troubleshooting:');
             console.error('  - Verify the agent exists: guild agent get');
             console.error('  - Check your workspace: guild workspace list');
-            console.error('  - Test unsaved changes: guild agent test --ephemeral');
             if (formattedError.code) {
                 console.error(`  - Error code: ${formattedError.code}`);
             }

package/dist/commands/agent/unpublish.js

@@ -9,7 +9,7 @@ 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)')
+        .argument('[identifier]', 'Agent ID or full name (e.g., owner~agent-name)')
         .action(async (agentIdArg) => {
         const output = createOutputWriter();
         try {

package/dist/commands/agent/update.js

@@ -26,7 +26,7 @@ export function createAgentUpdateCommand() {
     const cmd = new Command('update');
     cmd
         .description('Update agent properties (visibility)')
-        .argument('[identifier]', 'Agent ID or full name (e.g., owner/agent-name)')
+        .argument('[identifier]', 'Agent ID or full name (e.g., owner~agent-name)')
         .option('--public', 'Make the agent public (visible to everyone)')
         .option('--private', 'Make the agent private (only visible to owner)')
         .option('--yes', 'Skip confirmation prompt for visibility changes')

package/dist/commands/agent/versions.js

@@ -11,7 +11,7 @@ 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)')
+        .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')
         .action(async (agentIdArg, options) => {

package/dist/commands/agent/workspaces.js

@@ -11,7 +11,7 @@ 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)')
+        .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) => {

package/dist/commands/chat.d.ts

@@ -17,8 +17,9 @@ export interface ChatAppProps {
     resumeEvents?: SessionEvent[];
     resumeCommand?: string;
     openDashboard?: boolean;
+    eventFilter?: Set<string>;
 }
-export declare function ChatApp({ initialPrompt, version, workspaceId, versionId, agentName, showSplash, resumeSession, resumeEvents, resumeCommand, openDashboard, }: ChatAppProps): React.JSX.Element;
+export declare function ChatApp({ initialPrompt, version, workspaceId, versionId, agentName, showSplash, resumeSession, resumeEvents, resumeCommand, openDashboard, eventFilter, }: ChatAppProps): React.JSX.Element;
 export declare function ensureAuthenticated(): Promise<string>;
 export declare function createSession(client: GuildAPIClient, workspaceId: string | undefined, initialPrompt: string, versionId?: string, onProgress?: (status: string) => void): Promise<Session>;
 export declare function createChatCommand(): Command;