@cleocode/adapters 2026.5.3 → 2026.5.5

package/dist/providers/gemini-cli/adapter.js

@@ -1,158 +0,0 @@
-/**
- * Gemini CLI Adapter
- *
- * Main CLEOProviderAdapter implementation for Google Gemini CLI.
- * Provides hooks and install capabilities for CLEO integration.
- *
- * @task T161
- * @epic T134
- */
-import { exec } from 'node:child_process';
-import { existsSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import { promisify } from 'node:util';
-import { GeminiCliHookProvider } from './hooks.js';
-import { GeminiCliInstallProvider } from './install.js';
-const execAsync = promisify(exec);
-/**
- * CLEO provider adapter for Google Gemini CLI.
- *
- * Bridges CLEO's adapter system with Gemini CLI's native capabilities:
- * - Hooks: Maps Gemini CLI events (SessionStart, PreToolUse, etc.) to CAAMP events
- * - Install: Ensures AGENTS.md references for CLEO instruction files
- *
- * @remarks
- * Gemini CLI supports 10 canonical CAAMP events through its hook system,
- * including PreModel and PostModel which most other providers lack. It has
- * no spawn or transport capabilities. Integration is through AGENTS.md
- * instruction files and the Gemini CLI's configuration at `~/.gemini/`.
- *
- * @task T161
- * @epic T134
- */
-export class GeminiCliAdapter {
-    /** Unique provider identifier. */
-    id = 'gemini-cli';
-    /** Human-readable provider name. */
-    name = 'Gemini CLI';
-    /** Adapter version string. */
-    version = '1.0.0';
-    /** Declared capabilities for this provider. */
-    capabilities = {
-        supportsHooks: true,
-        supportedHookEvents: [
-            'SessionStart',
-            'SessionEnd',
-            'BeforeAgent',
-            'AfterAgent',
-            'BeforeTool',
-            'AfterTool',
-            'BeforeModel',
-            'AfterModel',
-            'PreCompress',
-            'Notification',
-        ],
-        supportsSpawn: false,
-        supportsInstall: true,
-        supportsInstructionFiles: false,
-        supportsContextMonitor: false,
-        supportsStatusline: false,
-        supportsProviderPaths: false,
-        supportsTransport: false,
-        supportsTaskSync: false,
-    };
-    /** Hook provider for CAAMP event mapping. */
-    hooks;
-    /** Install provider for managing instruction files. */
-    install;
-    /** Project directory this adapter was initialized with, or null. */
-    projectDir = null;
-    /** Whether {@link initialize} has been called. */
-    initialized = false;
-    constructor() {
-        this.hooks = new GeminiCliHookProvider();
-        this.install = new GeminiCliInstallProvider();
-    }
-    /**
-     * Initialize the adapter for a given project directory.
-     *
-     * @param projectDir - Root directory of the project
-     * @task T161
-     */
-    async initialize(projectDir) {
-        this.projectDir = projectDir;
-        this.initialized = true;
-    }
-    /**
-     * Dispose the adapter and clean up resources.
-     *
-     * Unregisters hooks and releases any tracked state.
-     * @task T161
-     */
-    async dispose() {
-        if (this.hooks.isRegistered()) {
-            await this.hooks.unregisterNativeHooks();
-        }
-        this.initialized = false;
-        this.projectDir = null;
-    }
-    /**
-     * Run a health check to verify Gemini CLI is accessible.
-     *
-     * Checks:
-     * 1. Adapter has been initialized
-     * 2. Gemini CLI binary is available in PATH
-     * 3. ~/.gemini/ configuration directory exists
-     *
-     * @returns Health status with details about each check
-     * @task T161
-     */
-    async healthCheck() {
-        const details = {};
-        if (!this.initialized) {
-            return {
-                healthy: false,
-                provider: this.id,
-                details: { error: 'Adapter not initialized' },
-            };
-        }
-        // Check Gemini CLI availability
-        let cliAvailable = false;
-        try {
-            const { stdout } = await execAsync('which gemini');
-            cliAvailable = stdout.trim().length > 0;
-            details.cliPath = stdout.trim();
-        }
-        catch {
-            details.cliAvailable = false;
-        }
-        // Check for Gemini CLI config directory
-        const geminiConfigDir = join(homedir(), '.gemini');
-        const configExists = existsSync(geminiConfigDir);
-        details.configDirExists = configExists;
-        // Healthy if CLI is available (primary requirement)
-        const healthy = cliAvailable;
-        details.cliAvailable = cliAvailable;
-        return {
-            healthy,
-            provider: this.id,
-            details,
-        };
-    }
-    /**
-     * Check whether the adapter has been initialized.
-     * @task T161
-     */
-    isInitialized() {
-        return this.initialized;
-    }
-    /**
-     * Get the project directory this adapter was initialized with.
-     * @task T161
-     */
-    getProjectDir() {
-        return this.projectDir;
-    }
-}
-//# sourceMappingURL=adapter.js.map

package/dist/providers/gemini-cli/adapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/providers/gemini-cli/adapter.ts"],"names":[],"mappings":"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"}

package/dist/providers/gemini-cli/hooks.js

@@ -1,128 +0,0 @@
-/**
- * Gemini CLI Hook Provider
- *
- * Maps Gemini CLI's native hook events to CAAMP canonical hook events.
- * Gemini CLI supports 11 canonical events through its hook system.
- *
- * Gemini CLI event mapping:
- * - SessionStart        -> SessionStart
- * - SessionEnd          -> SessionEnd
- * - PromptSubmit        -> BeforeAgent
- * - ResponseComplete    -> AfterAgent
- * - PreToolUse          -> BeforeTool
- * - PostToolUse         -> AfterTool
- * - PreModel            -> BeforeModel
- * - PostModel           -> AfterModel
- * - PreCompact          -> PreCompress
- * - Notification        -> Notification
- *
- * @task T161
- * @epic T134
- */
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import { readLatestTranscript } from '../shared/transcript-reader.js';
-/**
- * Mapping from Gemini CLI native event names to CAAMP canonical event names.
- */
-const GEMINI_CLI_EVENT_MAP = {
-    SessionStart: 'SessionStart',
-    SessionEnd: 'SessionEnd',
-    PromptSubmit: 'BeforeAgent',
-    ResponseComplete: 'AfterAgent',
-    PreToolUse: 'BeforeTool',
-    PostToolUse: 'AfterTool',
-    PreModel: 'BeforeModel',
-    PostModel: 'AfterModel',
-    PreCompact: 'PreCompress',
-    Notification: 'Notification',
-};
-/**
- * Hook provider for Gemini CLI.
- *
- * Gemini CLI registers hooks via its configuration system at
- * ~/.gemini/. Hook handlers are shell scripts or commands that
- * execute when the corresponding event fires.
- *
- * Since hooks are registered through the config system (managed by
- * the install provider), registerNativeHooks and unregisterNativeHooks
- * track registration state without performing filesystem operations.
- *
- * @remarks
- * Gemini CLI uses its own event naming convention (e.g. BeforeAgent,
- * AfterTool, PreCompress) which differs from both the PascalCase CAAMP
- * canonical names and other providers' conventions. The static event map
- * covers all 10 supported canonical events.
- *
- * @task T161
- * @epic T134
- */
-export class GeminiCliHookProvider {
-    /** Whether hooks have been registered for the current session. */
-    registered = false;
-    /**
-     * Map a Gemini CLI native event name to a CAAMP hook event name.
-     *
-     * @param providerEvent - Gemini CLI event name (e.g. "SessionStart", "PreToolUse")
-     * @returns CAAMP event name or null if unmapped
-     * @task T161
-     */
-    mapProviderEvent(providerEvent) {
-        return GEMINI_CLI_EVENT_MAP[providerEvent] ?? null;
-    }
-    /**
-     * Register native hooks for a project.
-     *
-     * For Gemini CLI, hooks are registered via the config system
-     * (~/.gemini/), which is handled by the install provider.
-     * This method marks hooks as registered without performing
-     * filesystem operations.
-     *
-     * @param _projectDir - Project directory (unused; hooks are global)
-     * @task T161
-     */
-    async registerNativeHooks(_projectDir) {
-        this.registered = true;
-    }
-    /**
-     * Unregister native hooks.
-     *
-     * For Gemini CLI, this is a no-op since hooks are managed through
-     * the config system. Unregistration happens via the install
-     * provider's uninstall method.
-     * @task T161
-     */
-    async unregisterNativeHooks() {
-        this.registered = false;
-    }
-    /**
-     * Check whether hooks have been registered via registerNativeHooks.
-     * @task T161
-     */
-    isRegistered() {
-        return this.registered;
-    }
-    /**
-     * Get the full event mapping for introspection/debugging.
-     * @task T161
-     */
-    getEventMap() {
-        return { ...GEMINI_CLI_EVENT_MAP };
-    }
-    /**
-     * Extract a plain-text transcript from Gemini CLI session data.
-     *
-     * Reads the most recent JSON/JSONL session file under `~/.gemini/`
-     * and returns its turns as a flat string for brain observation extraction.
-     *
-     * Returns null when no session data is found or on any read error.
-     *
-     * @param _sessionId - CLEO session ID (unused; reads the most recent file)
-     * @param _projectDir - Project directory (unused; Gemini CLI uses global paths)
-     * @task T161 @epic T134
-     */
-    async getTranscript(_sessionId, _projectDir) {
-        return readLatestTranscript(join(homedir(), '.gemini'));
-    }
-}
-//# sourceMappingURL=hooks.js.map

package/dist/providers/gemini-cli/hooks.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/providers/gemini-cli/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAEtE;;GAEG;AACH,MAAM,oBAAoB,GAA2B;IACnD,YAAY,EAAE,cAAc;IAC5B,UAAU,EAAE,YAAY;IACxB,YAAY,EAAE,aAAa;IAC3B,gBAAgB,EAAE,YAAY;IAC9B,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,WAAW;IACxB,QAAQ,EAAE,aAAa;IACvB,SAAS,EAAE,YAAY;IACvB,UAAU,EAAE,aAAa;IACzB,YAAY,EAAE,cAAc;CAC7B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,qBAAqB;IAChC,kEAAkE;IAC1D,UAAU,GAAG,KAAK,CAAC;IAE3B;;;;;;OAMG;IACH,gBAAgB,CAAC,aAAqB;QACpC,OAAO,oBAAoB,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC;IACrD,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,mBAAmB,CAAC,WAAmB;QAC3C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,qBAAqB;QACzB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,WAAW;QACT,OAAO,EAAE,GAAG,oBAAoB,EAAE,CAAC;IACrC,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,aAAa,CAAC,UAAkB,EAAE,WAAmB;QACzD,OAAO,oBAAoB,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;IAC1D,CAAC;CACF"}

package/dist/providers/gemini-cli/index.js

@@ -1,40 +0,0 @@
-/**
- * @packageDocumentation
- *
- * CLEO provider adapter for Google Gemini CLI.
- * Default export is the adapter class for dynamic loading by AdapterManager.
- *
- * @task T161
- * @epic T134
- */
-import { GeminiCliAdapter } from './adapter.js';
-export { GeminiCliAdapter } from './adapter.js';
-export { GeminiCliHookProvider } from './hooks.js';
-export { GeminiCliInstallProvider } from './install.js';
-export { GeminiCliSpawnProvider } from './spawn.js';
-export default GeminiCliAdapter;
-/**
- * Factory function for creating adapter instances.
- * Used by AdapterManager's dynamic import fallback.
- *
- * @remarks
- * This is the primary entry point for dynamic adapter loading.
- * AdapterManager calls this function when it resolves the gemini-cli
- * provider via its import-based discovery mechanism.
- *
- * @returns A new {@link GeminiCliAdapter} instance ready for initialization
- *
- * @example
- * ```typescript
- * import { createAdapter } from '@cleocode/adapters/providers/gemini-cli';
- *
- * const adapter = createAdapter();
- * await adapter.initialize('/path/to/project');
- * ```
- *
- * @task T161
- */
-export function createAdapter() {
-    return new GeminiCliAdapter();
-}
-//# sourceMappingURL=index.js.map

package/dist/providers/gemini-cli/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/gemini-cli/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEpD,eAAe,gBAAgB,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,gBAAgB,EAAE,CAAC;AAChC,CAAC"}

package/dist/providers/gemini-cli/install.js

@@ -1,124 +0,0 @@
-/**
- * Gemini CLI Install Provider
- *
- * Handles CLEO installation into Gemini CLI environments:
- * - Ensures AGENTS.md has CLEO @-references
- *
- * @task T161
- * @epic T134
- */
-import { existsSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-/** Lines that should appear in AGENTS.md to reference CLEO. */
-const INSTRUCTION_REFERENCES = ['@~/.cleo/templates/CLEO-INJECTION.md', '@.cleo/memory-bridge.md'];
-/**
- * Install provider for Gemini CLI.
- *
- * Manages CLEO's integration with Gemini CLI by:
- * 1. Ensuring AGENTS.md contains @-references to CLEO instruction files
- *
- * @remarks
- * Installation is idempotent -- running install multiple times on the same
- * project produces the same result. Only AGENTS.md is managed; Gemini CLI
- * does not have an MCP or plugin registration mechanism.
- *
- * @task T161
- * @epic T134
- */
-export class GeminiCliInstallProvider {
-    /**
-     * Install CLEO into a Gemini CLI environment.
-     *
-     * @param options - Installation options including project directory
-     * @returns Result describing what was installed
-     * @task T161
-     */
-    async install(options) {
-        const { projectDir } = options;
-        const installedAt = new Date().toISOString();
-        let instructionFileUpdated = false;
-        const details = {};
-        // Step 1: Ensure AGENTS.md has @-references
-        instructionFileUpdated = this.updateInstructionFile(projectDir);
-        if (instructionFileUpdated) {
-            details.instructionFile = join(projectDir, 'AGENTS.md');
-        }
-        return {
-            success: true,
-            installedAt,
-            instructionFileUpdated,
-            details,
-        };
-    }
-    /**
-     * Uninstall CLEO from the Gemini CLI environment.
-     *
-     * Does not remove AGENTS.md references (they are harmless if CLEO is not present).
-     * @task T161
-     */
-    async uninstall() {
-        // No-op: no MCP registration to remove
-    }
-    /**
-     * Check whether CLEO is installed in the Gemini CLI environment.
-     *
-     * Checks for CLEO references in AGENTS.md.
-     * @task T161
-     */
-    async isInstalled() {
-        const agentsMdPath = join(process.cwd(), 'AGENTS.md');
-        if (existsSync(agentsMdPath)) {
-            try {
-                const content = readFileSync(agentsMdPath, 'utf-8');
-                if (INSTRUCTION_REFERENCES.some((ref) => content.includes(ref))) {
-                    return true;
-                }
-            }
-            catch {
-                // Fall through
-            }
-        }
-        return false;
-    }
-    /**
-     * Ensure AGENTS.md contains @-references to CLEO instruction files.
-     *
-     * Creates AGENTS.md if it does not exist. Appends any missing references.
-     *
-     * @param projectDir - Project root directory
-     * @task T161
-     */
-    async ensureInstructionReferences(projectDir) {
-        this.updateInstructionFile(projectDir);
-    }
-    /**
-     * Update AGENTS.md with CLEO @-references.
-     *
-     * @param projectDir - Project root directory
-     * @returns true if the file was created or modified
-     */
-    updateInstructionFile(projectDir) {
-        const agentsMdPath = join(projectDir, 'AGENTS.md');
-        let content = '';
-        let existed = false;
-        if (existsSync(agentsMdPath)) {
-            content = readFileSync(agentsMdPath, 'utf-8');
-            existed = true;
-        }
-        const missingRefs = INSTRUCTION_REFERENCES.filter((ref) => !content.includes(ref));
-        if (missingRefs.length === 0) {
-            return false;
-        }
-        const refsBlock = missingRefs.join('\n');
-        if (existed) {
-            const separator = content.endsWith('\n') ? '' : '\n';
-            content = content + separator + refsBlock + '\n';
-        }
-        else {
-            content = refsBlock + '\n';
-        }
-        writeFileSync(agentsMdPath, content, 'utf-8');
-        return true;
-    }
-}
-//# sourceMappingURL=install.js.map

package/dist/providers/gemini-cli/install.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/providers/gemini-cli/install.ts"],"names":[],"mappings":"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"}

package/dist/providers/gemini-cli/spawn.js

@@ -1,195 +0,0 @@
-/**
- * Gemini CLI Spawn Provider
- *
- * Implements `AdapterSpawnProvider` for the Google Gemini CLI (`gemini` binary).
- *
- * The `gemini` binary is the Google Gemini CLI agent, available at:
- * https://github.com/google-gemini/gemini-cli
- *
- * Invocation: `gemini --yolo < <prompt-file>`
- *
- * The provider pipes the prompt via stdin using the `--yolo` flag, which
- * enables non-interactive mode (auto-approve all actions). Processes run
- * detached and are tracked by PID for listing and termination.
- *
- * If the `gemini` binary is not found, `canSpawn()` returns `false` with a
- * graceful error — no crash.
- *
- * @remarks
- * The Gemini CLI supports a `--model` flag to select the model family and a
- * `--yolo` flag for non-interactive headless execution (equivalent to Claude
- * Code's `--dangerously-skip-permissions`). Prompts are supplied via stdin
- * when run in `--yolo` mode. Install: `npm install -g @google/gemini-cli`
- * or see the GitHub repo above.
- *
- * @task T648
- */
-import { exec, spawn as nodeSpawn } from 'node:child_process';
-import { promisify } from 'node:util';
-import { getErrorMessage } from '@cleocode/contracts';
-const execAsync = promisify(exec);
-/** Default Gemini model for subagent spawns. */
-const DEFAULT_MODEL = 'gemini-2.5-pro';
-/**
- * Spawn provider for the Google Gemini CLI.
- *
- * Spawns detached Gemini CLI processes for subagent execution. Each spawn
- * pipes its prompt via stdin, then runs
- * `gemini --yolo --model <model>` as a detached, unref'd child process.
- *
- * @remarks
- * `canSpawn()` returns `false` (with no crash) when the `gemini` binary is
- * not found in PATH. Install instructions are emitted via `console.warn`
- * once to help operators discover the binary is missing.
- *
- * Processes are tracked by instance ID in an in-memory map and verified
- * via `kill(pid, 0)` liveness checks.
- *
- * @task T648
- */
-export class GeminiCliSpawnProvider {
-    /** Map of instance IDs to tracked process info. */
-    processMap = new Map();
-    /**
-     * Check if the Gemini CLI is available in PATH.
-     *
-     * @returns `true` if `gemini` is found via `which`
-     */
-    async canSpawn() {
-        try {
-            await execAsync('which gemini');
-            return true;
-        }
-        catch {
-            console.warn('[GeminiCliSpawnProvider] gemini CLI not found. ' +
-                'Install: npm install -g @google/gemini-cli  ' +
-                'Docs: https://github.com/google-gemini/gemini-cli');
-            return false;
-        }
-    }
-    /**
-     * Spawn a subagent via the Gemini CLI.
-     *
-     * Pipes the enriched prompt to stdin and spawns a detached Gemini
-     * process. The process runs independently of the parent.
-     *
-     * @param context - Spawn context with taskId, prompt, and options
-     * @returns Spawn result with instance ID and status
-     */
-    async spawn(context) {
-        const instanceId = `gemini-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
-        const startTime = new Date().toISOString();
-        try {
-            // Enrich prompt with CANT bundle, memory bridge, and mental model.
-            // Best-effort: if CANT context is unavailable, the raw prompt is used.
-            let enrichedPrompt = context.prompt;
-            try {
-                const { buildCantEnrichedPrompt } = await import('../../cant-context.js');
-                enrichedPrompt = await buildCantEnrichedPrompt({
-                    projectDir: context.workingDirectory ?? process.cwd(),
-                    basePrompt: context.prompt,
-                    agentName: context.options?.agentName ?? undefined,
-                });
-            }
-            catch {
-                // CANT enrichment unavailable — use raw prompt
-            }
-            const model = context.options?.model ?? DEFAULT_MODEL;
-            // --yolo: non-interactive batch mode (auto-approve all actions)
-            // --model: select the Gemini model variant
-            // Prompt is supplied via stdin (pipe)
-            const args = ['--yolo', '--model', model];
-            const spawnOpts = {
-                detached: true,
-                stdio: ['pipe', 'ignore', 'ignore'],
-            };
-            if (context.workingDirectory) {
-                spawnOpts.cwd = context.workingDirectory;
-            }
-            const child = nodeSpawn('gemini', args, spawnOpts);
-            // Write the prompt to stdin then close so the CLI receives it.
-            if (child.stdin) {
-                child.stdin.write(enrichedPrompt, 'utf-8');
-                child.stdin.end();
-            }
-            child.unref();
-            if (child.pid) {
-                this.processMap.set(instanceId, {
-                    pid: child.pid,
-                    taskId: context.taskId,
-                    startTime,
-                });
-            }
-            child.on('exit', () => {
-                this.processMap.delete(instanceId);
-            });
-            return {
-                instanceId,
-                taskId: context.taskId,
-                providerId: 'gemini-cli',
-                status: 'running',
-                startTime,
-            };
-        }
-        catch (error) {
-            console.error(`[GeminiCliSpawnProvider] Failed to spawn: ${getErrorMessage(error)}`);
-            return {
-                instanceId,
-                taskId: context.taskId,
-                providerId: 'gemini-cli',
-                status: 'failed',
-                startTime,
-                endTime: new Date().toISOString(),
-                error: getErrorMessage(error),
-            };
-        }
-    }
-    /**
-     * List currently running Gemini CLI subagent processes.
-     *
-     * Checks each tracked process via kill(pid, 0) to verify it is still alive.
-     * Dead processes are automatically cleaned from the tracking map.
-     *
-     * @returns Array of spawn results for running processes
-     */
-    async listRunning() {
-        const running = [];
-        for (const [instanceId, tracked] of this.processMap.entries()) {
-            try {
-                process.kill(tracked.pid, 0);
-                running.push({
-                    instanceId,
-                    taskId: tracked.taskId,
-                    providerId: 'gemini-cli',
-                    status: 'running',
-                    startTime: tracked.startTime,
-                });
-            }
-            catch {
-                this.processMap.delete(instanceId);
-            }
-        }
-        return running;
-    }
-    /**
-     * Terminate a running spawn by instance ID.
-     *
-     * Sends SIGTERM to the tracked process. If the process is not found
-     * or has already exited, this is a no-op.
-     *
-     * @param instanceId - ID of the spawn instance to terminate
-     */
-    async terminate(instanceId) {
-        const tracked = this.processMap.get(instanceId);
-        if (!tracked)
-            return;
-        try {
-            process.kill(tracked.pid, 'SIGTERM');
-        }
-        catch {
-            // Process may have already exited
-        }
-        this.processMap.delete(instanceId);
-    }
-}
-//# sourceMappingURL=spawn.js.map

package/dist/providers/gemini-cli/spawn.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../../../src/providers/gemini-cli/spawn.ts"],"names":[],"mappings":"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"}