@guildai/cli 0.11.0 → 0.12.0

package/dist/lib/event-filter.js

@@ -1,91 +0,0 @@
-// Copyright 2026 Guild.ai
-// SPDX-License-Identifier: Apache-2.0
-/**
- * User-facing event types — shown by default (mirrors web UI defaults).
- */
-export const USER_EVENT_TYPES = [
-    'user_message',
-    'agent_notification_message',
-    'agent_notification_progress',
-    'agent_notification_error',
-    'credentials_request',
-    'agent_install_request',
-    'trigger_message',
-    'system_error',
-];
-/**
- * System / debug event types — hidden by default (mirrors web UI defaults).
- */
-export const SYSTEM_EVENT_TYPES = [
-    'agent_console',
-    'runtime_start',
-    'runtime_running',
-    'runtime_waiting',
-    'runtime_error',
-    'runtime_done',
-    'llm_start',
-    'llm_done',
-];
-/**
- * Default active filter: all user-facing types, no system types.
- */
-export const DEFAULT_EVENT_TYPES = new Set(USER_EVENT_TYPES);
-/**
- * Parse the value of the `--events` flag into a Set of event type names.
- *
- * Whatever you pass replaces the defaults entirely:
- *  - `none`   → empty set (no event types shown)
- *  - `user`   → all USER_EVENT_TYPES (same as default)
- *  - `system` → only SYSTEM_EVENT_TYPES
- *  - `all`    → both USER_EVENT_TYPES + SYSTEM_EVENT_TYPES
- *
- * Comma-separated for fine-grained control:
- *  - `agent_console,llm_start` → only those two types
- *  - `user,system` → same as `all`
- */
-export function parseEventFilter(raw) {
-    const tokens = raw
-        .split(',')
-        .map((t) => t.trim())
-        .filter(Boolean);
-    // `none` returns an empty set — no event types shown
-    if (tokens.length === 1 && tokens[0] === 'none') {
-        return new Set();
-    }
-    const result = new Set();
-    for (const token of tokens) {
-        switch (token) {
-            case 'all':
-                for (const t of USER_EVENT_TYPES)
-                    result.add(t);
-                for (const t of SYSTEM_EVENT_TYPES)
-                    result.add(t);
-                break;
-            case 'user':
-                for (const t of USER_EVENT_TYPES)
-                    result.add(t);
-                break;
-            case 'system':
-                for (const t of SYSTEM_EVENT_TYPES)
-                    result.add(t);
-                break;
-            default:
-                result.add(token);
-        }
-    }
-    return result;
-}
-/**
- * Check whether an event should be shown given the active filter.
- *
- * Returns `true` when the event type is in the filter set.
- *
- * Note: certain event types (e.g. `agent_notification_progress`,
- * `agent_notification_message`) drive core UI state (spinner, chat history)
- * and are always processed regardless of the filter; only their *display* is
- * gated here for new/optional event types.
- */
-export function shouldShowEvent(type, filter) {
-    return filter.has(type);
-}
-//# sourceMappingURL=event-filter.js.map

package/dist/lib/generated-types.js

@@ -1,56 +0,0 @@
-// =============================================================================
-// AUTO-GENERATED FILE - DO NOT EDIT MANUALLY
-// =============================================================================
-//
-// This file is generated by: cli/scripts/sync-types-from-python.py
-// Run that script after modifying Python enum definitions.
-//
-// =============================================================================
-// Source: python/guildcore/ent_schemas/third_party_service.py -> ThirdPartyService
-export const WEBHOOK_SERVICES = [
-    'AZURE_DEVOPS',
-    'BITBUCKET',
-    'CURL',
-    'CYPRESS',
-    'GITHUB',
-    'GOOGLE_DOCS',
-    'GOOGLE_COMPUTE',
-    'GOOGLE_LOGGING',
-    'JIRA',
-    'LINEAR',
-    'NEWRELIC',
-    'NOTION',
-    'SLACK',
-    'TESTRAIL',
-    'ZENDESK',
-];
-// Source: python/guildcore/ent_schemas/ent_workspace_trigger_time_schema.py -> TimeTriggerFrequency
-export const TIME_TRIGGER_FREQUENCIES = [
-    'HOURLY',
-    'DAILY',
-    'WEEKLY',
-    'MONTHLY',
-    'CRON',
-];
-// Source: python/guildcore/routes/serializers.py -> EventType
-export const EVENT_TYPES = [
-    'user_message',
-    'agent_console',
-    'runtime_start',
-    'runtime_running',
-    'runtime_waiting',
-    'runtime_error',
-    'runtime_done',
-    'credentials_request',
-    'agent_install_request',
-    'agent_notification_message',
-    'agent_notification_progress',
-    'agent_notification_error',
-    'system_error',
-    'system_message',
-    'trigger_message',
-    'interrupted',
-    'llm_start',
-    'llm_done',
-];
-//# sourceMappingURL=generated-types.js.map

package/dist/lib/git.js

@@ -1,176 +0,0 @@
-// Copyright 2026 Guild.ai
-// SPDX-License-Identifier: Apache-2.0
-/**
- * Git command utilities for Guild CLI
- *
- * These helpers ensure git commands work reliably in non-interactive environments
- * by preventing interactive prompts and providing clear error messages.
- */
-import { execa } from 'execa';
-import * as fs from 'fs/promises';
-import * as path from 'path';
-import { debug } from './errors.js';
-/**
- * Error thrown when a git command fails
- */
-export class GitError extends Error {
-    command;
-    args;
-    stderr;
-    stdout;
-    exitCode;
-    timedOut;
-    constructor(command, args, stderr, stdout, exitCode, timedOut) {
-        // Use stderr as the primary message, fall back to stdout
-        const output = stderr.trim() || stdout.trim();
-        const baseMessage = timedOut
-            ? `Git command timed out: git ${args.join(' ')}`
-            : `Git command failed: git ${args.join(' ')}`;
-        super(output ? `${baseMessage}\n${output}` : baseMessage);
-        this.command = command;
-        this.args = args;
-        this.stderr = stderr;
-        this.stdout = stdout;
-        this.exitCode = exitCode;
-        this.timedOut = timedOut;
-        this.name = 'GitError';
-    }
-}
-/**
- * Default timeout for git commands (30 seconds)
- *
- * This is long enough for most operations but short enough to fail fast
- * if something is waiting for interactive input.
- */
-const DEFAULT_TIMEOUT = 30000;
-/**
- * Longer timeout for network operations (2 minutes)
- *
- * Clone, push, pull, and fetch can take longer over slow connections.
- */
-const NETWORK_TIMEOUT = 120000;
-/**
- * Git commands that involve network operations
- */
-const NETWORK_COMMANDS = ['clone', 'push', 'pull', 'fetch'];
-/**
- * Run a git command with non-interactive settings
- *
- * This function:
- * - Sets GIT_TERMINAL_PROMPT=0 to prevent credential prompts from hanging
- * - Applies a timeout to prevent indefinite hangs
- * - Bubbles up errors with the actual git output
- *
- * @example
- * const { stdout } = await runGit(['status', '--porcelain'], { cwd: '/path/to/repo' });
- *
- * @example
- * try {
- *   await runGit(['commit', '-m', 'message'], { cwd });
- * } catch (error) {
- *   if (error instanceof GitError) {
- *     console.error('Git failed:', error.message);
- *   }
- * }
- */
-export async function runGit(args, options = {}) {
-    const { cwd, timeout: customTimeout, env: extraEnv } = options;
-    // Determine timeout based on command type
-    const isNetworkCommand = args.length > 0 && NETWORK_COMMANDS.includes(args[0]);
-    const timeout = customTimeout ?? (isNetworkCommand ? NETWORK_TIMEOUT : DEFAULT_TIMEOUT);
-    debug(`Running git command: git ${args.join(' ')} (timeout: ${timeout}ms)`);
-    let result;
-    try {
-        result = await execa('git', args, {
-            cwd,
-            timeout,
-            reject: false,
-            env: {
-                ...process.env,
-                // Prevent git from prompting for credentials - fail fast instead
-                GIT_TERMINAL_PROMPT: '0',
-                // Prevent SSH from prompting for passwords/passphrases
-                GIT_SSH_COMMAND: 'ssh -o BatchMode=yes',
-                ...extraEnv,
-            },
-        });
-    }
-    catch (error) {
-        // Handle timeout errors from execa
-        const execaError = error;
-        if (execaError.timedOut) {
-            throw new GitError('git', args, String(execaError.stderr || ''), String(execaError.stdout || ''), null, true);
-        }
-        throw error;
-    }
-    const stdout = String(result.stdout ?? '');
-    const stderr = String(result.stderr ?? '');
-    const exitCode = result.exitCode ?? 0;
-    // Check for timeout (execa sets timedOut property)
-    if (result.timedOut) {
-        throw new GitError('git', args, stderr, stdout, null, true);
-    }
-    // Check for non-zero exit code
-    if (exitCode !== 0) {
-        throw new GitError('git', args, stderr, stdout, exitCode, false);
-    }
-    return { stdout, stderr, exitCode };
-}
-/**
- * Format a GitError for display to the user
- *
- * Returns a user-friendly error message with the git output.
- */
-export function formatGitError(error) {
-    const lines = [];
-    if (error.timedOut) {
-        lines.push('Git command timed out');
-        lines.push('');
-        lines.push('This usually means git is waiting for input that cannot be provided.');
-        lines.push('Common causes:');
-        lines.push('  • GPG signing requires a passphrase - run `gpg --sign` to cache it');
-        lines.push('  • SSH key requires a passphrase - run `ssh-add` to cache it');
-        lines.push('  • Git credentials are needed - configure a credential helper');
-    }
-    else {
-        lines.push('Git operation failed');
-    }
-    lines.push('');
-    lines.push(`Command: git ${error.args.join(' ')}`);
-    if (error.stderr) {
-        lines.push('');
-        lines.push('Output:');
-        lines.push(error.stderr.trim());
-    }
-    else if (error.stdout) {
-        lines.push('');
-        lines.push('Output:');
-        lines.push(error.stdout.trim());
-    }
-    if (error.exitCode !== null) {
-        lines.push('');
-        lines.push(`Exit code: ${error.exitCode}`);
-    }
-    return lines.join('\n');
-}
-const PRE_PUSH_HOOK = `#!/bin/sh
-if [ "$GUILD_AGENT_SAVE" != "1" ]; then
-  echo "Please use \\\`guild agent save\\\` to push."
-  exit 1
-fi
-exit 0
-`;
-/**
- * Install a pre-push hook that blocks direct git push.
- *
- * The hook allows pushes only when the GUILD_AGENT_SAVE env var is set,
- * which guild agent save sets automatically.
- */
-export async function installPrePushHook(targetDir) {
-    const hooksDir = path.join(targetDir, '.git', 'hooks');
-    await fs.mkdir(hooksDir, { recursive: true });
-    await fs.writeFile(path.join(hooksDir, 'pre-push'), PRE_PUSH_HOOK, {
-        mode: 0o755,
-    });
-}
-//# sourceMappingURL=git.js.map

package/dist/lib/gk.js

@@ -1,91 +0,0 @@
-// Copyright 2026 Guild.ai
-// SPDX-License-Identifier: Apache-2.0
-import * as fs from 'fs/promises';
-import * as path from 'path';
-import axios from 'axios';
-import { getGlobalConfigDir } from './guild-config.js';
-import { getGuildcoreUrl } from './config.js';
-import { getAuthToken } from './auth.js';
-import { getIapHeaders } from './iap.js';
-import { debug } from './errors.js';
-const GK_CACHE_FILE = 'gk-cache.json';
-const GK_CACHE_TTL_MS = 5 * 60 * 1000;
-function getCachePath() {
-    return path.join(getGlobalConfigDir(), GK_CACHE_FILE);
-}
-async function readCache(host) {
-    try {
-        const content = await fs.readFile(getCachePath(), 'utf-8');
-        const entry = JSON.parse(content);
-        if (entry.host === host && Date.now() - entry.ts < GK_CACHE_TTL_MS) {
-            debug('GK cache hit for %s', host);
-            return entry.gks;
-        }
-        debug('GK cache stale or host mismatch');
-    }
-    catch {
-        debug('GK cache not found or unreadable');
-    }
-    return null;
-}
-async function writeCache(host, gks) {
-    const configDir = getGlobalConfigDir();
-    await fs.mkdir(configDir, { recursive: true });
-    await fs.writeFile(getCachePath(), JSON.stringify({ gks, ts: Date.now(), host }));
-}
-/**
- * Fetch the set of GK names enabled for the current user.
- *
- * Returns null when the enabled set cannot be determined (not authenticated,
- * network error, etc.). Callers should treat null as "show everything" (fail-open).
- */
-export async function getEnabledGKs() {
-    const token = await getAuthToken();
-    if (!token) {
-        debug('Not authenticated, skipping GK fetch');
-        return null;
-    }
-    const baseUrl = getGuildcoreUrl();
-    let host;
-    try {
-        host = new URL(baseUrl).host;
-    }
-    catch {
-        return null;
-    }
-    const cached = await readCache(host);
-    if (cached) {
-        return new Set(cached);
-    }
-    try {
-        const iapHeaders = await getIapHeaders(baseUrl);
-        const response = await axios.get(`${baseUrl}/gks/enabled`, {
-            headers: {
-                ...iapHeaders,
-                Authorization: `Bearer ${token}`,
-                Accept: 'application/json',
-            },
-            timeout: 5000,
-        });
-        const gkNames = response.data.gks.map((g) => g.name);
-        await writeCache(host, gkNames);
-        debug('Fetched %d enabled GKs', gkNames.length);
-        return new Set(gkNames);
-    }
-    catch (error) {
-        debug('Failed to fetch GKs: %s', error);
-        return null;
-    }
-}
-/**
- * Check whether a specific GK is enabled for the current user.
- *
- * When enabledGKs is null (could not be determined), returns true (fail-open)
- * so that commands are not hidden due to transient errors.
- */
-export function isGKEnabled(gk, enabledGKs) {
-    if (!enabledGKs)
-        return true;
-    return enabledGKs.has(gk);
-}
-//# sourceMappingURL=gk.js.map

package/dist/lib/guild-config.js

@@ -1,178 +0,0 @@
-// Copyright 2026 Guild.ai
-// SPDX-License-Identifier: Apache-2.0
-/**
- * Guild Configuration
- *
- * Unified config loading for local (guild.json) and global (~/.guild/config.json) configs.
- *
- * Priority for workspace resolution:
- * 1. Explicit --workspace flag (not handled here, handled by commands)
- * 2. GUILD_WORKSPACE_ID environment variable
- * 3. Local guild.json workspace_id (agent-specific workspace)
- * 4. Global ~/.guild/config.json default_workspace
- * 5. First workspace from API (fallback)
- */
-import * as fs from 'fs/promises';
-import * as path from 'path';
-import * as os from 'os';
-import { debug } from './errors.js';
-const GLOBAL_CONFIG_DIR = '.guild';
-const GLOBAL_CONFIG_FILE = 'config.json';
-const LOCAL_CONFIG_FILE = 'guild.json';
-/**
- * Get path to global config directory
- */
-export function getGlobalConfigDir() {
-    return path.join(os.homedir(), GLOBAL_CONFIG_DIR);
-}
-/**
- * Get path to global config file
- */
-export function getGlobalConfigPath() {
-    return path.join(getGlobalConfigDir(), GLOBAL_CONFIG_FILE);
-}
-/**
- * Get path to local config file in specified directory
- */
-export function getLocalConfigPath(cwd = process.cwd()) {
-    return path.join(cwd, LOCAL_CONFIG_FILE);
-}
-/**
- * Check if a file exists
- */
-async function fileExists(filePath) {
-    return fs
-        .access(filePath)
-        .then(() => true)
-        .catch(() => false);
-}
-/**
- * Load global config from ~/.guild/config.json
- *
- * @returns GlobalConfig or undefined if not found
- */
-export async function loadGlobalConfig() {
-    const configPath = getGlobalConfigPath();
-    if (!(await fileExists(configPath))) {
-        debug('Global config not found at %s', configPath);
-        return undefined;
-    }
-    try {
-        const content = await fs.readFile(configPath, 'utf-8');
-        const config = JSON.parse(content);
-        debug('Loaded global config: %O', config);
-        return config;
-    }
-    catch (error) {
-        debug('Failed to parse global config: %s', error);
-        return undefined;
-    }
-}
-/**
- * Load local config from guild.json in specified directory
- *
- * @param cwd Directory to look in (defaults to process.cwd())
- * @returns LocalConfig or undefined if not found
- */
-export async function loadLocalConfig(cwd = process.cwd()) {
-    const configPath = getLocalConfigPath(cwd);
-    if (!(await fileExists(configPath))) {
-        debug('Local config not found at %s', configPath);
-        return undefined;
-    }
-    try {
-        const content = await fs.readFile(configPath, 'utf-8');
-        const config = JSON.parse(content);
-        debug('Loaded local config: %O', config);
-        return config;
-    }
-    catch (error) {
-        debug('Failed to parse local config: %s', error);
-        return undefined;
-    }
-}
-/**
- * Load both local and global configs
- *
- * @param cwd Directory to look for local config (defaults to process.cwd())
- * @returns ResolvedConfig with local and global configs (either may be undefined)
- */
-export async function loadConfig(cwd = process.cwd()) {
-    const [local, global] = await Promise.all([loadLocalConfig(cwd), loadGlobalConfig()]);
-    return { local, global };
-}
-/**
- * Save global config to ~/.guild/config.json
- *
- * @param config Config to save (merged with existing config)
- */
-export async function saveGlobalConfig(config) {
-    const configDir = getGlobalConfigDir();
-    const configPath = getGlobalConfigPath();
-    // Ensure directory exists
-    await fs.mkdir(configDir, { recursive: true });
-    // Load existing config and merge
-    const existing = (await loadGlobalConfig()) || {};
-    const merged = { ...existing, ...config };
-    // Write config
-    await fs.writeFile(configPath, JSON.stringify(merged, null, 2) + '\n');
-    debug('Saved global config: %O', merged);
-}
-/**
- * Get the workspace ID to use, with proper priority.
- *
- * Priority (--workspace flag is handled by commands before calling this):
- * 1. GUILD_WORKSPACE_ID environment variable
- * 2. Local guild.json workspace_id (if in agent directory with workspace set)
- * 3. Global ~/.guild/config.json default_workspace
- * 4. undefined (caller should handle fallback)
- *
- * @param cwd Directory to look for local config
- * @returns Workspace ID and source, or undefined
- */
-export async function getWorkspaceId(cwd = process.cwd()) {
-    // Priority 1: Environment variable override
-    if (process.env.GUILD_WORKSPACE_ID) {
-        debug('Using workspace from GUILD_WORKSPACE_ID env var: %s', process.env.GUILD_WORKSPACE_ID);
-        return { workspaceId: process.env.GUILD_WORKSPACE_ID, source: 'env' };
-    }
-    const config = await loadConfig(cwd);
-    // Priority 2: Local workspace_id
-    if (config.local?.workspace_id) {
-        debug('Using workspace from local config: %s', config.local.workspace_id);
-        return { workspaceId: config.local.workspace_id, source: 'local' };
-    }
-    // Priority 3: Global default_workspace
-    if (config.global?.default_workspace) {
-        debug('Using workspace from global config: %s', config.global.default_workspace);
-        return { workspaceId: config.global.default_workspace, source: 'global' };
-    }
-    debug('No workspace configured in local or global config');
-    return undefined;
-}
-/**
- * Check if we're in an agent directory (has guild.json)
- */
-export async function isAgentDirectory(cwd = process.cwd()) {
-    return fileExists(getLocalConfigPath(cwd));
-}
-/**
- * Get a human-readable label for the workspace source.
- * Returns undefined for 'env' (treated as explicit, like --workspace flag; no label needed).
- *
- * @param source - The source of workspace resolution
- * @returns Human-readable label, or undefined for env source
- *
- * @example
- * getWorkspaceSourceLabel('local')  // → 'guild.json'
- * getWorkspaceSourceLabel('global') // → 'global config'
- * getWorkspaceSourceLabel('env')    // → undefined
- */
-export function getWorkspaceSourceLabel(source) {
-    if (source === 'local')
-        return 'guild.json';
-    if (source === 'global')
-        return 'global config';
-    return undefined; // 'env' is explicit (GUILD_WORKSPACE_ID), no magic label needed
-}
-//# sourceMappingURL=guild-config.js.map