@guildai/cli 0.7.1 → 0.8.0

package/dist/commands/agent/init.js

@@ -210,7 +210,7 @@ export function createAgentInitCommand() {
                 .then(() => true)
                 .catch(() => false);
             if (!gitExists) {
-                await runGit(['init'], { cwd: targetDir });
+                await runGit(['init', '-b', 'main'], { cwd: targetDir });
                 steps.succeed('Initialize git repository');
             }
             else {

package/dist/commands/agent/test.js

@@ -4,6 +4,7 @@ import { Command } from 'commander';
 import { render } from 'ink';
 import React from 'react';
 import { readFileSync } from 'fs';
+import { access } from 'fs/promises';
 import path from 'path';
 import { fileURLToPath } from 'url';
 import open from 'open';
@@ -19,7 +20,7 @@ import { pollForResponse, pollForResponseWithEvents, } from '../../lib/session-p
 import { readStdinAsJSON, ensureInteractiveStdin } from '../../lib/stdin.js';
 import { loadLocalConfig, getWorkspaceId } from '../../lib/guild-config.js';
 import { GitError, formatGitError } from '../../lib/git.js';
-import { readAgentFiles, buildEphemeralVersion, BuildTimeoutError, BuildFailedError, } from '../../lib/agent-helpers.js';
+import { readAgentFiles, buildEphemeralVersion, buildBundledVersion, BundleNotFoundError, 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';
@@ -37,6 +38,7 @@ export function createAgentTestCommand() {
         .option('--resume <session-id>', 'Resume an existing test session')
         .option('--open', 'Open session in web dashboard')
         .option('--events <types>', 'Event types to stream (default: user). Shorthands: none, user, system, all, or comma-separated type names')
+        .option('--bundle <file>', 'Path to a pre-built gzip+base64 bundle file')
         .option('--no-cache', 'Skip ephemeral build cache (force a fresh build)')
         .action(async (options) => {
         const cwd = process.cwd();
@@ -99,6 +101,21 @@ export function createAgentTestCommand() {
                     process.exit(1);
                 }
             }
+            // If using bundle, verify the file exists early (before auth/session creation)
+            // so we fail fast without needing auth if the path is wrong.
+            if (options.bundle) {
+                try {
+                    await access(options.bundle);
+                }
+                catch {
+                    console.error(`Error: Bundle file not found: ${options.bundle}`);
+                    console.error('');
+                    console.error('Ensure the bundle file exists and the path is correct:');
+                    console.error('  npm run build');
+                    console.error('  guild agent test --bundle agent.js.gz');
+                    process.exit(1);
+                }
+            }
             // Determine workspace (priority: flag > local config > global config)
             let workspaceId = options.workspace;
             if (!workspaceId) {
@@ -139,6 +156,11 @@ export function createAgentTestCommand() {
                     }
                     version = match;
                 }
+                else if (options.bundle) {
+                    // Pre-built bundle: skip server-side compilation entirely.
+                    const result = await buildBundledVersion(client, guildConfig.agent_id, options.bundle, cwd, '[Test] Pre-built bundle');
+                    version = result.version;
+                }
                 else {
                     // Default: build ephemeral version from working directory,
                     // reusing the last build if files haven't changed.
@@ -150,6 +172,14 @@ export function createAgentTestCommand() {
                 }
             }
             catch (error) {
+                if (error instanceof BundleNotFoundError) {
+                    console.error(`Error: ${error.message}`);
+                    console.error('');
+                    console.error('Ensure the bundle file exists and the path is correct:');
+                    console.error('  npm run build');
+                    console.error('  guild agent test --bundle agent.js.gz');
+                    process.exit(1);
+                }
                 if (error instanceof BuildTimeoutError) {
                     console.error('Error: Build did not complete');
                     console.error('');
@@ -216,9 +246,11 @@ export function createAgentTestCommand() {
                 console.log(`✓ Agent: ${guildConfig.name} (${guildConfig.agent_id})`);
                 const versionDisplay = options.agentVersion
                     ? options.agentVersion
-                    : ephemeralCached
-                        ? 'ephemeral (cached, no changes)'
-                        : 'ephemeral (working directory)';
+                    : options.bundle
+                        ? `bundle (${path.basename(options.bundle)})`
+                        : ephemeralCached
+                            ? 'ephemeral (cached, no changes)'
+                            : 'ephemeral (working directory)';
                 console.log(`✓ Version: ${versionDisplay}`);
                 console.log(`✓ Workspace: ${workspaceId}`);
                 const sessionLink = session.session_url

package/dist/commands/session/tasks.js

@@ -4,7 +4,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, formatTaskTable } from '../../lib/output.js';
 export function createSessionTasksCommand() {
     const cmd = new Command('tasks');
     cmd
@@ -25,7 +26,12 @@ export function createSessionTasksCommand() {
             params.append('limit', options.limit);
             params.append('offset', options.offset);
             const response = await client.get(`/sessions/${sessionId}/tasks?${params.toString()}`);
-            output.data(response);
+            if (getOutputMode() === 'json') {
+                console.log(JSON.stringify(response, null, 2));
+            }
+            else {
+                formatTaskTable(response.items, response.pagination);
+            }
         }
         catch (error) {
             const formattedError = handleAxiosError(error);

package/dist/lib/agent-helpers.d.ts

@@ -84,4 +84,19 @@ export declare function buildEphemeralVersion(client: GuildAPIClient, agentId: s
     version: AgentVersion;
     cached: boolean;
 }>;
+/** Thrown when the specified bundle file cannot be found on disk. */
+export declare class BundleNotFoundError extends Error {
+    constructor(filePath: string);
+}
+/**
+ * Upload a pre-built bundle as an ephemeral version.
+ *
+ * The bundle file must be gzip+base64 encoded (the output of
+ * `esbuild ... | gzip | base64`). Source files are included for
+ * dashboard viewing, but the server skips its own build step because
+ * the ready-to-run artifact is already provided.
+ */
+export declare function buildBundledVersion(client: GuildAPIClient, agentId: string, bundlePath: string, cwd: string, summary: string): Promise<{
+    version: AgentVersion;
+}>;
 //# sourceMappingURL=agent-helpers.d.ts.map

package/dist/lib/agent-helpers.js

@@ -234,4 +234,73 @@ export async function buildEphemeralVersion(client, agentId, files, cwd, summary
     }
     return { version, cached: false };
 }
+// ---------------------------------------------------------------------------
+// Bundle version
+// ---------------------------------------------------------------------------
+/** Thrown when the specified bundle file cannot be found on disk. */
+export class BundleNotFoundError extends Error {
+    constructor(filePath) {
+        super(`Bundle file not found: ${filePath}`);
+        this.name = 'BundleNotFoundError';
+    }
+}
+/**
+ * Upload a pre-built bundle as an ephemeral version.
+ *
+ * The bundle file must be gzip+base64 encoded (the output of
+ * `esbuild ... | gzip | base64`). Source files are included for
+ * dashboard viewing, but the server skips its own build step because
+ * the ready-to-run artifact is already provided.
+ */
+export async function buildBundledVersion(client, agentId, bundlePath, cwd, summary) {
+    try {
+        await fs.access(bundlePath);
+    }
+    catch {
+        throw new BundleNotFoundError(bundlePath);
+    }
+    const bundle = (await fs.readFile(bundlePath, 'utf-8')).trim();
+    let files = [];
+    try {
+        files = await readAgentFiles(cwd);
+    }
+    catch {
+        // No git or missing required files — proceed with bundle-only upload
+    }
+    const initial = (await client.post(`/agents/${agentId}/versions`, {
+        version_type: 'EPHEMERAL',
+        bundle,
+        encoding: 'gzip;base64',
+        files,
+        summary,
+    }));
+    const pollResult = await pollUntilComplete({
+        resourceId: initial.id,
+        endpoint: `/versions/${initial.id}`,
+        isComplete: (r) => r.validation_status !== 'PENDING' && r.validation_status !== 'RUNNING',
+        message: 'Validating bundle...',
+        successMessage: 'Bundle validated',
+        timeoutMessage: 'Bundle validation timed out',
+        maxAttempts: 120,
+        delayMs: 1000,
+    });
+    if (!pollResult.success || !pollResult.response) {
+        throw new BuildTimeoutError('Bundle validation timed out.');
+    }
+    const version = pollResult.response;
+    if (version.validation_status === 'FAILED') {
+        let failedSteps = [];
+        try {
+            const stepsResponse = await client.get(`/versions/${version.id}/validation/steps`);
+            failedSteps = stepsResponse.steps
+                .filter((step) => step.status === 'FAILED')
+                .map((step) => ({ name: step.name, content: step.content ?? undefined }));
+        }
+        catch {
+            // Could not fetch validation details — throw with empty steps
+        }
+        throw new BuildFailedError(failedSteps);
+    }
+    return { version };
+}
 //# sourceMappingURL=agent-helpers.js.map

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

@@ -361,6 +361,43 @@ export interface CredentialsPolicy {
     updated_at: string;
 }
 export type CredentialsPolicyListResponse = PaginatedResponse<CredentialsPolicy>;
+export type TaskStatus = 'CREATED' | 'DISPATCHED' | 'STARTED' | 'RUNNING' | 'WAITING' | 'ERROR' | 'DONE' | 'INTERRUPTED';
+export interface TokenUsage {
+    input_tokens: number;
+    output_tokens: number;
+    cache_read_tokens: number;
+    cache_write_tokens: number;
+    total_tokens: number;
+    llm_call_count: number;
+}
+interface TaskBase {
+    id: string;
+    entity_type: string;
+    status: TaskStatus;
+    token_usage: TokenUsage | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface TaskAgent extends TaskBase {
+    entity_type: 'EntTaskAgent';
+    agent: {
+        name: string;
+        full_name?: string;
+    } | null;
+    version: {
+        id: string;
+        version_number?: string;
+    } | null;
+}
+export interface TaskTool extends TaskBase {
+    entity_type: 'EntTaskTool';
+    tool_name: string;
+    tool_call_id: string;
+    request_bytes: number;
+    response_bytes: number;
+    http_status_code: number;
+}
+export type Task = TaskAgent | TaskTool;
 /**
  * Session entity from API responses.
  * Used by: session list

package/dist/lib/output.d.ts

@@ -1,5 +1,5 @@
 import { type Spinner } from './progress.js';
-import type { Agent, AgentVersion, Credentials, CredentialsPolicy, Context, Integration, IntegrationVersion, JobStep, Pagination, Session, Workspace, WorkspaceAgent, Trigger } from './api-types.js';
+import type { Agent, AgentVersion, Credentials, CredentialsPolicy, Context, Integration, IntegrationVersion, JobStep, Pagination, Session, Task, Workspace, WorkspaceAgent, Trigger } from './api-types.js';
 /**
  * Format an agent list as a human-readable table.
  * Shared by agent list and agent search commands.
@@ -40,6 +40,11 @@ export declare function formatWorkspaceTable(workspaces: Workspace[], pagination
  * Used by session list command.
  */
 export declare function formatSessionTable(sessions: Session[], pagination: Pagination): void;
+/**
+ * Format a task list as a human-readable table.
+ * Used by session tasks command.
+ */
+export declare function formatTaskTable(tasks: Task[], pagination: Pagination): void;
 /**
  * Format a trigger list as a human-readable table.
  * Used by trigger list command.

package/dist/lib/output.js

@@ -359,6 +359,56 @@ export function formatSessionTable(sessions, pagination) {
         console.log(chalk.dim(`\nShowing ${showing} of ${pagination.total_count} sessions`));
     }
 }
+/**
+ * Format a task list as a human-readable table.
+ * Used by session tasks command.
+ */
+export function formatTaskTable(tasks, pagination) {
+    if (tasks.length === 0) {
+        console.log(chalk.dim('No tasks found'));
+        return;
+    }
+    const table = new Table({
+        columns: [
+            { name: 'id', title: 'ID', alignment: 'left' },
+            { name: 'name', title: 'NAME', alignment: 'left' },
+            { name: 'status', title: 'STATUS', alignment: 'left' },
+            { name: 'tokens', title: 'TOKENS', alignment: 'left' },
+            { name: 'created', title: 'CREATED', alignment: 'left' },
+        ],
+    });
+    tasks.forEach((task) => {
+        const name = task.entity_type === 'EntTaskAgent'
+            ? task.agent?.full_name || task.agent?.name || '-'
+            : task.tool_name;
+        const statusColor = task.status === 'DONE'
+            ? chalk.green
+            : task.status === 'ERROR'
+                ? chalk.red
+                : task.status === 'RUNNING' ||
+                    task.status === 'STARTED' ||
+                    task.status === 'WAITING'
+                    ? chalk.yellow
+                    : chalk.dim;
+        table.addRow({
+            id: truncate(task.id, 13),
+            name,
+            status: statusColor(task.status),
+            tokens: task.token_usage ? task.token_usage.total_tokens.toLocaleString() : '-',
+            created: task.created_at ? formatRelativeTime(task.created_at) : '',
+        });
+    });
+    table.printTable();
+    const showing = Math.min(pagination.limit, tasks.length);
+    if (pagination.has_more) {
+        const nextOffset = pagination.offset + pagination.limit;
+        console.log(`\nShowing ${showing} of ${pagination.total_count} tasks. ` +
+            chalk.dim(`Use --offset ${nextOffset} to see more.`));
+    }
+    else if (pagination.total_count > showing) {
+        console.log(chalk.dim(`\nShowing ${showing} of ${pagination.total_count} tasks`));
+    }
+}
 /**
  * Format a trigger list as a human-readable table.
  * Used by trigger list command.

package/package.json

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