toc-ocra 0.2.0

package/dist/src/runtime/agent-runtime.js

@@ -0,0 +1,340 @@
+import { join } from 'node:path';
+import { executeScript } from '../exec/script-runner.js';
+import { createDiagnosticLogger } from '../logging/diagnostic-log.js';
+import { cliDetection } from '../providers/detection.js';
+import { ModelCatalogCollector } from '../providers/model-catalog-collector.js';
+import { OrphanRegistry } from '../runs/orphan-registry.js';
+import { RunSupervisor } from '../runs/run-supervisor.js';
+import { GatewayClient, GatewayError } from '../transport/gateway-client.js';
+import { listDirectory } from '../workspace/directory-browser.js';
+import { WorkspaceManager } from '../workspace/workspace-manager.js';
+import { CliModelsPayloadSchema, DEFAULT_POLICY, FsListPayloadSchema, WorkspaceScanPayloadSchema, WorkspaceSyncPayloadSchema, RunCancelPayloadSchema, RunStartPayloadSchema, RunTailPayloadSchema, ScriptRunPayloadSchema, SqlRunPayloadSchema } from '../types/protocol.js';
+const sleep = (ms, signal) => new Promise((resolve) => {
+    const timer = setTimeout(resolve, ms);
+    signal?.addEventListener('abort', () => { clearTimeout(timer); resolve(); }, { once: true });
+});
+/**
+ * The agent's main loop, with no persistent connection:
+ *   - heartbeat every `heartbeatInterval` seconds (liveness + reconciliation)
+ *   - long-poll for commands, handling each one concurrently
+ *   - run reports retried until the server acknowledges them
+ */
+export class AgentRuntime {
+    config;
+    version;
+    logger;
+    client;
+    runs;
+    orphans;
+    workspaces;
+    stopController = new AbortController();
+    startedAt = new Date().toISOString();
+    detection;
+    policy = DEFAULT_POLICY;
+    heartbeatInterval = 30;
+    pollWait = 25;
+    lastHeartbeatOk = false;
+    lastError;
+    /** The server rejected the device token (revoked or unpaired). */
+    unauthorized = false;
+    ownsLogger;
+    deviceName;
+    /** Finish reports not yet acknowledged; retried on every heartbeat. */
+    pendingReports = new Map();
+    /** Model catalogs of the installed CLIs; re-read in the background. */
+    models = new ModelCatalogCollector();
+    catalogReport;
+    catalogRefresh;
+    /** Hash of the catalogs the server has stored (from its heartbeat reply). */
+    serverCatalogHash;
+    constructor(config, version, logger) {
+        this.config = config;
+        this.version = version;
+        this.ownsLogger = !logger;
+        this.logger = logger ?? createDiagnosticLogger(config.logFile, { level: config.logLevel, maxAgeMs: 5 * 60 * 1_000 });
+        this.client = new GatewayClient(config);
+        this.deviceName = config.deviceName;
+        const reporter = {
+            started: async (runId, report) => {
+                await this.retry(() => this.client.runStarted(runId, report), 3);
+            },
+            finished: async (runId, report) => {
+                this.pendingReports.set(runId, report);
+                await this.flushReport(runId);
+            }
+        };
+        this.workspaces = new WorkspaceManager(config, this.logger);
+        this.orphans = new OrphanRegistry(join(config.dataDir, 'active-runs.json'));
+        this.runs = new RunSupervisor(config, this.logger, reporter, this.orphans);
+    }
+    async start() {
+        // A previous agent that crashed may have left CLI processes running.
+        const reaped = await this.orphans.reapPrevious();
+        if (reaped.length > 0)
+            this.logger.warn('orphan-runs-stopped', { runIds: reaped.map((r) => r.runId) });
+        this.detection = await cliDetection.detect();
+        await this.refreshCatalogs();
+        await this.heartbeat();
+        void this.heartbeatLoop();
+        void this.pollLoop();
+        this.logger.info('agent-started', { serverUrl: this.config.serverUrl, deviceId: this.config.deviceId });
+        process.stdout.write(`toc-ocra ${this.version} 已启动：${this.config.serverUrl}（设备 ${this.deviceName}）\n`);
+    }
+    async stop() {
+        this.stopController.abort();
+        await this.runs.disposeAll();
+        this.logger.info('agent-stopped');
+        if (this.ownsLogger)
+            this.logger.close();
+    }
+    /** Current state, for the local dashboard and the plugin. */
+    snapshot() {
+        return {
+            deviceId: this.config.deviceId,
+            deviceName: this.deviceName,
+            serverUrl: this.config.serverUrl,
+            connected: this.lastHeartbeatOk,
+            activeSessions: this.runs.activeCount,
+            storedRuns: this.runs.recentRuns().length,
+            startedAt: this.startedAt,
+            runs: this.runs.recentRuns().map((run) => ({ runId: run.runId, status: run.status, sessionId: run.workstationId, updatedAt: new Date(run.at).toISOString() })),
+            capabilities: this.detection?.detectedIds ?? [],
+            ...(this.detection ? { detection: this.detection } : {}),
+            ...(!this.lastHeartbeatOk && this.lastError ? { connectionError: this.lastError } : {}),
+            unauthorized: this.unauthorized,
+            activeRunIds: this.runs.activeRunIds()
+        };
+    }
+    /** Re-detects installed CLIs and pushes the change with the next heartbeat. */
+    async refreshDetection() {
+        this.detection = await cliDetection.detect(true);
+        void this.refreshCatalogs({ force: true });
+        return this.detection;
+    }
+    // ---- Heartbeat ----
+    async heartbeatLoop() {
+        while (!this.stopController.signal.aborted) {
+            await sleep(this.heartbeatInterval * 1_000, this.stopController.signal);
+            if (this.stopController.signal.aborted)
+                return;
+            await this.heartbeat();
+        }
+    }
+    async heartbeat() {
+        for (const runId of [...this.pendingReports.keys()])
+            await this.flushReport(runId, 1);
+        // Catalogs go up only when they differ from what the server holds.
+        const report = this.catalogReport;
+        const sendCatalogs = report !== undefined && report.hash !== this.serverCatalogHash;
+        try {
+            const response = await this.client.heartbeat({
+                agent_version: this.version,
+                hostname: this.config.hostname,
+                capabilities: this.capabilitySummary(),
+                active_runs: this.runs.activeRunIds(),
+                ...(sendCatalogs ? { model_catalogs: report } : {})
+            });
+            this.serverCatalogHash = response.model_catalog_hash ?? (sendCatalogs ? report.hash : this.serverCatalogHash);
+            this.policy = response.policy ?? DEFAULT_POLICY;
+            this.heartbeatInterval = Math.min(Math.max(response.heartbeat_interval || 30, 5), 120);
+            this.pollWait = Math.min(Math.max(response.poll_wait || 25, 1), 30);
+            this.deviceName = response.device_name || this.deviceName;
+            if (!this.lastHeartbeatOk)
+                this.logger.info('heartbeat-ok', { deviceId: response.device_id });
+            this.lastHeartbeatOk = true;
+            this.unauthorized = false;
+        }
+        catch (error) {
+            this.noteFailure('heartbeat', error);
+        }
+        // Re-read changed catalogs for the next heartbeat, off the heartbeat path.
+        void this.refreshCatalogs();
+    }
+    /** Re-reads catalogs whose sources changed; concurrent calls share one run. */
+    refreshCatalogs(options = {}) {
+        if (this.catalogRefresh && !options.force)
+            return this.catalogRefresh;
+        const run = (async () => {
+            try {
+                this.catalogReport = await this.models.collect(this.detection?.detectedIds ?? [], options);
+            }
+            catch (error) {
+                this.logger.warn('model-catalog-failed', { error: error instanceof Error ? error.message : String(error) });
+            }
+        })();
+        const tracked = run.finally(() => { if (this.catalogRefresh === tracked)
+            this.catalogRefresh = undefined; });
+        this.catalogRefresh = tracked;
+        return tracked;
+    }
+    capabilitySummary() {
+        const snapshot = this.detection;
+        if (!snapshot)
+            return { providers: [] };
+        return {
+            providers: snapshot.providers.map((p) => ({ id: p.id, installed: p.installed, runnable: p.available, version: p.version ?? '', path: p.resolvedPath ?? '' })),
+            detected_ids: snapshot.detectedIds,
+            refreshed_at: snapshot.refreshedAt
+        };
+    }
+    noteFailure(where, error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        const unauthorized = error instanceof GatewayError && error.unauthorized;
+        if (this.lastHeartbeatOk || this.lastError?.reason !== reason) {
+            this.logger.warn(`${where}-failed`, { error: reason });
+            if (unauthorized)
+                process.stderr.write('设备凭据已失效（可能已解除配对），请在「设备代理」插件里重新绑定，或运行 toc-ocra enroll\n');
+        }
+        this.unauthorized = unauthorized;
+        this.lastHeartbeatOk = false;
+        this.lastError = { reason, at: new Date().toISOString() };
+    }
+    // ---- Commands ----
+    async pollLoop() {
+        let backoff = 1_000;
+        while (!this.stopController.signal.aborted) {
+            try {
+                const commands = await this.client.poll(this.pollWait, this.stopController.signal);
+                backoff = 1_000;
+                for (const command of commands)
+                    void this.handle(command);
+            }
+            catch (error) {
+                if (this.stopController.signal.aborted)
+                    return;
+                this.noteFailure('poll', error);
+                const unauthorized = error instanceof GatewayError && error.unauthorized;
+                await sleep(unauthorized ? 60_000 : backoff, this.stopController.signal);
+                backoff = Math.min(backoff * 2, 30_000);
+            }
+        }
+    }
+    async handle(command) {
+        this.logger.info('command-received', { commandId: command.id, type: command.type });
+        let outcome;
+        try {
+            outcome = await this.execute(command);
+        }
+        catch (error) {
+            outcome = { success: false, error: error instanceof Error ? error.message : String(error) };
+        }
+        await this.retry(() => this.client.commandResult(command.id, outcome), 5).catch((error) => {
+            this.logger.warn('command-result-failed', { commandId: command.id, error: error instanceof Error ? error.message : String(error) });
+        });
+    }
+    async execute(command) {
+        switch (command.type) {
+            case 'run.start': {
+                const payload = RunStartPayloadSchema.parse(command.payload);
+                await this.runs.start(payload);
+                return { success: true, result: { accepted: true } };
+            }
+            case 'run.cancel': {
+                const payload = RunCancelPayloadSchema.parse(command.payload);
+                const cancelled = await this.runs.cancel(payload.run_id);
+                return { success: true, result: { cancelled } };
+            }
+            case 'run.tail': {
+                const payload = RunTailPayloadSchema.parse(command.payload);
+                const tail = this.runs.tail({ ...(payload.run_id ? { runId: payload.run_id } : {}), ...(payload.workstation_id ? { workstationId: payload.workstation_id } : {}) }, payload.lines ?? 200, payload.before_cursor);
+                return { success: true, result: tail };
+            }
+            case 'workstation.create': {
+                // Headless workstations need no local setup: a session starts with
+                // the first turn. Acknowledge so the workstation becomes ready.
+                const workstationId = String(command.payload?.workstation_id ?? command.workstation_id);
+                return { success: true, session_key: workstationId, result: { ready: true } };
+            }
+            case 'cli.detect':
+                this.detection = await cliDetection.detect(true);
+                void this.refreshCatalogs({ force: true });
+                return { success: true, result: this.capabilitySummary() };
+            case 'cli.models': {
+                // Manual refresh: re-read now (one CLI, or all installed ones).
+                const payload = CliModelsPayloadSchema.parse(command.payload ?? {});
+                await this.refreshCatalogs({ force: true, ...(payload.agent_type ? { only: payload.agent_type.toLowerCase() } : {}) });
+                if (!this.catalogReport)
+                    return { success: false, error: '读取模型目录失败' };
+                return { success: true, result: this.catalogReport };
+            }
+            case 'script.run': {
+                const payload = ScriptRunPayloadSchema.parse(command.payload);
+                this.checkPolicy('script', payload.policy);
+                const workdir = await this.runs.validateWorkdir(payload.workdir || this.config.allowedRoots[0]);
+                const result = await executeScript(payload.cmd, workdir, payload.timeout_s);
+                return { success: result.exitCode === 0, result, ...(result.exitCode === 0 ? {} : { error: `exit ${result.exitCode}` }) };
+            }
+            case 'fs.list': {
+                const payload = FsListPayloadSchema.parse(command.payload ?? {});
+                return { success: true, result: await listDirectory(payload.path, this.config.allowedRoots) };
+            }
+            case 'workspace.scan': {
+                const payload = WorkspaceScanPayloadSchema.parse(command.payload);
+                return { success: true, result: await this.workspaces.scan(payload) };
+            }
+            case 'workspace.sync': {
+                const payload = WorkspaceSyncPayloadSchema.parse(command.payload);
+                const result = await this.workspaces.sync(payload);
+                return { success: !result.error, result, ...(result.error ? { error: result.error } : {}) };
+            }
+            case 'sql.run': {
+                const payload = SqlRunPayloadSchema.parse(command.payload);
+                this.checkPolicy('sql', payload.policy);
+                return { success: false, error: 'SQL 执行器尚未接入（策略已放行，执行器是预留接口）' };
+            }
+            default:
+                return { success: false, error: `不支持的指令：${command.type}` };
+        }
+    }
+    /**
+     * Script / SQL run only when the server policy allows it and the local
+     * owner has not switched it off. The policy attached to the command was
+     * checked by the server at enqueue time, so it wins over the (up to one
+     * heartbeat old) cached copy. New policy fields (read-only SQL,
+     * allowlists) are enforced here.
+     */
+    checkPolicy(kind, commandPolicy) {
+        const localOff = kind === 'script' ? this.config.disableScript : this.config.disableSql;
+        const policy = commandPolicy ?? this.policy;
+        const enabled = !localOff && policy[kind].enabled;
+        if (!enabled)
+            throw new Error(kind === 'script' ? '该设备未开启脚本执行' : '该设备未开启 SQL 执行');
+    }
+    // ---- Reports ----
+    async flushReport(runId, attempts = 6) {
+        const report = this.pendingReports.get(runId);
+        if (!report)
+            return;
+        try {
+            await this.retry(() => this.client.runFinished(runId, report), attempts);
+            this.pendingReports.delete(runId);
+            this.runs.markReported(runId);
+        }
+        catch (error) {
+            // 404: the server no longer knows the run; nothing left to report.
+            if (error instanceof GatewayError && (error.status === 404 || /not found/i.test(error.message))) {
+                this.pendingReports.delete(runId);
+                this.runs.markReported(runId);
+                return;
+            }
+            this.logger.warn('run-report-pending', { runId, error: error instanceof Error ? error.message : String(error) });
+        }
+    }
+    async retry(action, attempts) {
+        let delay = 500;
+        for (let attempt = 1;; attempt++) {
+            try {
+                return await action();
+            }
+            catch (error) {
+                // A logical error (HTTP 200, success=false) or a 4xx will not change on retry.
+                const permanent = error instanceof GatewayError && (error.status === 200 || (error.status >= 400 && error.status < 500 && error.status !== 429));
+                if (permanent || attempt >= attempts || this.stopController.signal.aborted)
+                    throw error;
+                await sleep(delay, this.stopController.signal);
+                delay = Math.min(delay * 2, 10_000);
+            }
+        }
+    }
+}
+//# sourceMappingURL=agent-runtime.js.map

package/dist/src/runtime/agent-runtime.js.map

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

package/dist/src/runtime/agent-service.d.ts

@@ -0,0 +1,33 @@
+/** Bumped when the control API changes incompatibly. */
+export declare const CONTROL_PROTOCOL_VERSION = 1;
+/**
+ * The long-running `toc-ocra run` process. It owns the local server (the
+ * dashboard plus the plugin control API) and runs the agent runtime while
+ * this machine is enrolled. Pairing and unpairing from the plugin start and
+ * stop the runtime without restarting the process.
+ */
+export declare class AgentService {
+    private readonly version;
+    private config;
+    private readonly logger;
+    private readonly pairing;
+    private readonly server;
+    private runtime;
+    private detection;
+    private readonly startedAt;
+    /** Serializes enroll / unpair so two clicks cannot race. */
+    private transition;
+    constructor(version: string);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private startRuntime;
+    private stopRuntime;
+    private detect;
+    private idleSnapshot;
+    /** What the plugin shows; never includes the device or control token. */
+    private status;
+    private controlApi;
+    private serialize;
+}
+/** The platform names echo_admin uses for devices. */
+export declare function devicePlatform(platform: NodeJS.Platform): 'mac' | 'win' | 'linux';

package/dist/src/runtime/agent-service.js

@@ -0,0 +1,181 @@
+import { clearEnrollment, enrollDevice, loadBaseConfig, normalizeServerUrl } from '../config.js';
+import { PairingStore } from '../control/pairing.js';
+import { ControlError, HealthServer } from '../health/server.js';
+import { createDiagnosticLogger } from '../logging/diagnostic-log.js';
+import { cliDetection } from '../providers/detection.js';
+import { AgentRuntime } from './agent-runtime.js';
+/** Bumped when the control API changes incompatibly. */
+export const CONTROL_PROTOCOL_VERSION = 1;
+/**
+ * The long-running `toc-ocra run` process. It owns the local server (the
+ * dashboard plus the plugin control API) and runs the agent runtime while
+ * this machine is enrolled. Pairing and unpairing from the plugin start and
+ * stop the runtime without restarting the process.
+ */
+export class AgentService {
+    version;
+    config;
+    logger;
+    pairing;
+    server;
+    runtime;
+    detection;
+    startedAt = new Date().toISOString();
+    /** Serializes enroll / unpair so two clicks cannot race. */
+    transition = Promise.resolve();
+    constructor(version) {
+        this.version = version;
+        this.config = loadBaseConfig();
+        this.logger = createDiagnosticLogger(this.config.logFile, { level: this.config.logLevel, maxAgeMs: 5 * 60 * 1_000 });
+        this.pairing = new PairingStore(this.config.dataDir);
+        this.server = new HealthServer(this.config.healthHost, this.config.healthPort, () => this.runtime?.snapshot() ?? this.idleSnapshot(), this.config.logFile, this.logger, async (refresh) => (this.runtime ? (refresh ? this.runtime.refreshDetection() : this.runtime.snapshot().detection ?? this.detect(false)) : this.detect(refresh)), this.controlApi());
+    }
+    async start() {
+        await this.pairing.init();
+        try {
+            await this.server.start();
+        }
+        catch (error) {
+            // Without the local server the plugin cannot reach this machine; the
+            // agent still runs if it is enrolled.
+            this.logger.warn('health-server-unavailable', { error: errorMessage(error) });
+            process.stderr.write(`本机服务端口 ${this.config.healthHost}:${this.config.healthPort} 不可用（${errorMessage(error)}），插件将无法连接\n`);
+        }
+        process.stdout.write(`toc-ocra ${this.version} 本机服务：http://${this.config.healthHost}:${this.server.boundPort}\n`);
+        process.stdout.write(`插件连接码：${this.pairing.connectionCode}（之后可运行 toc-ocra code 查看）\n`);
+        if (this.config.token)
+            await this.startRuntime();
+        else
+            process.stdout.write('本机尚未绑定服务器，请在「设备代理」插件中完成绑定\n');
+    }
+    async stop() {
+        await this.runtime?.stop();
+        this.runtime = undefined;
+        await this.server.stop();
+        await this.pairing.dispose();
+        this.logger.close();
+    }
+    async startRuntime() {
+        const runtime = new AgentRuntime(this.config, this.version, this.logger);
+        this.runtime = runtime;
+        await runtime.start();
+    }
+    async stopRuntime() {
+        const runtime = this.runtime;
+        this.runtime = undefined;
+        await runtime?.stop();
+    }
+    async detect(refresh) {
+        this.detection = await cliDetection.detect(refresh);
+        return this.detection;
+    }
+    idleSnapshot() {
+        return {
+            deviceId: '',
+            connected: false,
+            activeSessions: 0,
+            storedRuns: 0,
+            startedAt: this.startedAt,
+            runs: [],
+            ...(this.detection ? { detection: this.detection } : {})
+        };
+    }
+    /** What the plugin shows; never includes the device or control token. */
+    async status() {
+        const snapshot = this.runtime?.snapshot();
+        const detection = snapshot?.detection ?? this.detection ?? (await this.detect(false));
+        return {
+            version: this.version,
+            protocol: CONTROL_PROTOCOL_VERSION,
+            hostname: this.config.hostname,
+            platform: devicePlatform(this.config.platform),
+            started_at: this.startedAt,
+            paired: Boolean(this.config.token),
+            running: Boolean(this.runtime),
+            device_id: this.config.deviceId,
+            device_name: snapshot?.deviceName ?? this.config.deviceName,
+            server_url: this.config.token ? this.config.serverUrl : '',
+            connected: snapshot?.connected ?? false,
+            unauthorized: snapshot?.unauthorized ?? false,
+            connection_error: snapshot?.connectionError?.reason ?? '',
+            active_runs: snapshot?.activeRunIds.length ?? 0,
+            allowed_roots: this.config.allowedRoots,
+            token_from_env: Boolean(process.env.TOC_OCRA_TOKEN),
+            providers: detection.providers.map((provider) => ({
+                id: provider.id,
+                installed: provider.installed,
+                runnable: provider.available,
+                version: provider.version ?? ''
+            }))
+        };
+    }
+    controlApi() {
+        return {
+            info: () => ({ name: 'toc-ocra', version: this.version, protocol: CONTROL_PROTOCOL_VERSION, paired: Boolean(this.config.token) }),
+            pair: (code) => this.pairing.pair(code),
+            authorize: (header) => this.pairing.authorize(header),
+            status: () => this.status(),
+            enroll: (input) => this.serialize(async () => {
+                const code = typeof input.code === 'string' ? input.code.trim() : '';
+                const rawUrl = typeof input.serverUrl === 'string' ? input.serverUrl.trim() : '';
+                if (!code)
+                    throw new ControlError(400, '缺少配对码', 'code_required');
+                let serverUrl;
+                try {
+                    serverUrl = normalizeServerUrl(rawUrl);
+                }
+                catch {
+                    throw new ControlError(400, `服务器地址无效：${rawUrl || '（空）'}`, 'invalid_server_url');
+                }
+                if (process.env.TOC_OCRA_TOKEN)
+                    throw new ControlError(409, '设备令牌来自环境变量 TOC_OCRA_TOKEN，请先移除该变量再绑定', 'token_from_env');
+                // Enroll first: if the code is wrong the current binding keeps running.
+                let enrolled;
+                try {
+                    enrolled = await enrollDevice({ code, serverUrl, configPath: this.config.configPath, agentVersion: this.version });
+                }
+                catch (error) {
+                    throw new ControlError(400, errorMessage(error), 'enroll_failed');
+                }
+                await this.stopRuntime();
+                this.config = loadBaseConfig();
+                this.logger.info('device-enrolled', { deviceId: enrolled.deviceId, serverUrl: enrolled.serverUrl });
+                await this.startRuntime();
+                return this.status();
+            }),
+            unpair: () => this.serialize(async () => {
+                if (process.env.TOC_OCRA_TOKEN)
+                    throw new ControlError(409, '设备令牌来自环境变量 TOC_OCRA_TOKEN，请先移除该变量', 'token_from_env');
+                await this.stopRuntime();
+                await clearEnrollment(this.config.configPath);
+                this.config = loadBaseConfig();
+                this.logger.info('device-unpaired');
+                return this.status();
+            }),
+            detect: async () => {
+                if (this.runtime)
+                    await this.runtime.refreshDetection();
+                else
+                    await this.detect(true);
+                return this.status();
+            }
+        };
+    }
+    serialize(action) {
+        const next = this.transition.then(action, action);
+        this.transition = next.catch(() => undefined);
+        return next;
+    }
+}
+/** The platform names echo_admin uses for devices. */
+export function devicePlatform(platform) {
+    if (platform === 'darwin')
+        return 'mac';
+    if (platform === 'win32')
+        return 'win';
+    return 'linux';
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=agent-service.js.map

package/dist/src/runtime/agent-service.js.map

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

package/dist/src/runtime/cli/hydrate-shell-path.d.ts

@@ -0,0 +1,33 @@
+export type ShellHydrationFailureReason = 'none' | 'no_shell' | 'timeout' | 'spawn_error' | 'empty_path';
+export type HydrationResult = {
+    ok: true;
+    segments: string[];
+    failureReason: 'none';
+} | {
+    ok: false;
+    segments: [];
+    failureReason: Exclude<ShellHydrationFailureReason, 'none'>;
+};
+/** @internal - tests need a clean hydration cache between cases. */
+export declare function _resetHydrateShellPathCache(): void;
+type HydrateOptions = {
+    force?: boolean;
+    /** Override for tests — defaults to running `spawn` against the real shell. */
+    spawner?: (shell: string) => Promise<HydrationResult>;
+    /** Override for tests — defaults to `pickShell()`. */
+    shellOverride?: string | null;
+};
+/**
+ * Spawn the user's login shell once and return the PATH it would export.
+ * Caches the promise for the lifetime of the process — call
+ * `_resetHydrateShellPathCache()` in tests or `hydrateShellPath({ force: true })`
+ * when the user asks to re-probe (e.g. after installing a new CLI).
+ */
+export declare function hydrateShellPath(options?: HydrateOptions): Promise<HydrationResult>;
+/**
+ * Promote shell-discovered PATH segments to the front of process.env.PATH,
+ * preserving shell ordering and avoiding duplicates. Returns the segments that
+ * were newly added so callers can log/telemetry on nontrivial hydrations.
+ */
+export declare function mergePathSegments(segments: string[]): string[];
+export {};