echo-cli-agent 0.1.0

package/dist/src/session/session-manager.js

@@ -0,0 +1,339 @@
+import { chmod, realpath } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import { dirname, isAbsolute, join, relative, resolve } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import * as pty from 'node-pty';
+import { resolveProvider } from '../providers/registry.js';
+const require = createRequire(import.meta.url);
+export class SessionManager {
+    config;
+    state;
+    logger;
+    sessions = new Map();
+    constructor(config, state, logger) {
+        this.config = config;
+        this.state = state;
+        this.logger = logger;
+    }
+    get activeCount() {
+        return this.sessions.size;
+    }
+    /**
+     * Register a named local window before its first prompt. The server task id is
+     * the only routing key; a provider-native session id remains optional.
+     */
+    async createWindow(request) {
+        const provider = resolveProvider(request.agent_type);
+        if (this.config.capabilities.length > 0 && !this.config.capabilities.includes(provider.id)) {
+            throw new Error(`CLI 不可用：api_user 未检测到 ${provider.id} CLI`);
+        }
+        const workdir = await this.validateWorkdir(request.workdir ?? this.config.allowedRoots[0]);
+        const existing = this.state.getCliWindow(request.task_id, provider.id);
+        const window = {
+            taskId: request.task_id,
+            agentType: provider.id,
+            name: request.window_name?.trim() || existing?.name || `${provider.id} window`,
+            sessionId: existing?.sessionId ?? randomUUID(),
+            workdir,
+            updatedAt: new Date().toISOString()
+        };
+        await this.state.upsertCliWindow(window);
+        this.logger.info('cli-window-created', {
+            taskId: window.taskId,
+            agentType: window.agentType,
+            sessionId: window.sessionId
+        });
+        return window;
+    }
+    listWindows(agentType) {
+        return this.state.listCliWindows(agentType);
+    }
+    async deliver(request, hooks) {
+        const sessionKey = `${request.task_id}:${request.agent_type.toLowerCase()}`;
+        const provider = resolveProvider(request.agent_type);
+        if (this.config.capabilities.length > 0 && !this.config.capabilities.includes(provider.id)) {
+            throw new Error(`CLI 不可用：api_user 未检测到 ${provider.id} CLI`);
+        }
+        const providerSessionId = request.session_id?.trim();
+        if (!providerSessionId) {
+            throw new Error('派发缺少原生会话标识，已拒绝发送以避免新建会话');
+        }
+        const existing = this.sessions.get(sessionKey);
+        if (existing && provider.reuseSession !== false) {
+            if (existing.sessionId !== providerSessionId) {
+                throw new Error('本地活动会话与指定原生会话不一致，已拒绝发送');
+            }
+            await hooks.onSessionInitialized(existing.sessionId, false);
+            await this.writePrompt(existing, request.prompt ?? '');
+            return {
+                runId: request.run_id,
+                sessionId: existing.sessionId,
+                sessionKey,
+                created: false,
+                duplicate: false
+            };
+        }
+        const savedWindow = this.state.getCliWindow(request.task_id, provider.id);
+        const workdir = await this.validateWorkdir(request.workdir ?? savedWindow?.workdir ?? this.config.allowedRoots[0]);
+        // Only the control-plane session id is authoritative. Local state may be
+        // stale after an app restart and must never silently create another chat.
+        const plan = provider.buildLaunchPlan(request, {
+            allowExecutableOverride: this.config.allowExecutableOverride
+        });
+        const sessionId = providerSessionId;
+        let terminal;
+        try {
+            await this.ensurePtyHelperExecutable();
+            terminal = pty.spawn(plan.executable, plan.args, {
+                name: 'xterm-256color',
+                cols: 120,
+                rows: 36,
+                cwd: workdir,
+                env: plan.env
+            });
+        }
+        catch (error) {
+            throw new Error(`unable to start ${provider.id}: ${this.errorMessage(error)}`);
+        }
+        // Kiro may show its trust confirmation after the first terminal output. Keep
+        // the first user prompt queued until that confirmation has been handled;
+        // otherwise the TUI consumes the prompt as confirmation-screen input.
+        const trustApproval = plan.autoApproveTrustPrompt
+            ? this.autoApproveTrustPrompt(terminal, request.run_id)
+            : Promise.resolve();
+        const ready = this.waitForStartupOutput(terminal);
+        const managed = {
+            sessionKey,
+            sessionId,
+            runId: request.run_id,
+            process: terminal,
+            ready,
+            output: '',
+            startedAt: Date.now(),
+            cancelRequested: false
+        };
+        this.sessions.set(sessionKey, managed);
+        let discoveredProviderSessionId = providerSessionId;
+        terminal.onData((output) => {
+            managed.output = `${managed.output}${output}`.slice(-128 * 1024);
+            const discovered = provider.extractSessionId(output);
+            if (discovered && discovered !== discoveredProviderSessionId) {
+                discoveredProviderSessionId = discovered;
+                void this.state.upsertSession({
+                    sessionKey,
+                    sessionId,
+                    agentType: provider.id,
+                    workdir,
+                    providerSessionId: discovered,
+                    updatedAt: new Date().toISOString()
+                }).catch(() => undefined);
+                const namedWindow = this.state.getCliWindow(request.task_id, provider.id);
+                if (namedWindow) {
+                    void this.state.upsertCliWindow({
+                        ...namedWindow,
+                        providerSessionId: discovered,
+                        updatedAt: new Date().toISOString()
+                    }).catch(() => undefined);
+                }
+            }
+            const markers = this.outputMarkers(output);
+            if (markers.length > 0) {
+                this.logger.info('cli-output-marker', {
+                    runId: request.run_id,
+                    sessionId,
+                    markers,
+                    bytes: output.length
+                });
+            }
+        });
+        terminal.onExit(({ exitCode, signal }) => {
+            if (this.sessions.get(sessionKey)?.process === terminal)
+                this.sessions.delete(sessionKey);
+            const finalText = exitCode !== 0 ? failureSummary(managed.output) : undefined;
+            // Keep the provider session metadata after the PTY exits. Orca-style
+            // windows are durable logical sessions; Codex/Claude can resume from the
+            // provider-native id on the next prompt instead of starting over.
+            this.logger.info('cli-session-exited', {
+                runId: request.run_id,
+                agentType: provider.id,
+                sessionKey,
+                sessionId,
+                exitCode,
+                signal
+            });
+            void hooks.onProcessExited(discoveredProviderSessionId ?? sessionId, {
+                exitCode,
+                ...(signal ? { signal } : {}),
+                cancelled: managed.cancelRequested,
+                ...(finalText ? { finalText } : {}),
+                durationMs: Date.now() - managed.startedAt
+            }).catch((error) => {
+                this.logger.warn('cli-process-exit-report-failed', {
+                    runId: request.run_id,
+                    error: this.errorMessage(error)
+                });
+            });
+        });
+        await this.state.upsertSession({
+            sessionKey,
+            sessionId,
+            agentType: provider.id,
+            workdir,
+            ...(providerSessionId ? { providerSessionId } : {}),
+            updatedAt: new Date().toISOString()
+        });
+        await hooks.onProcessStarted(sessionId, terminal.pid);
+        await hooks.onSessionInitialized(sessionId, true);
+        await trustApproval;
+        if (plan.promptDelivery !== 'startup') {
+            await this.writePrompt(managed, request.prompt ?? '');
+        }
+        this.logger.info('prompt-delivered', { sessionKey, sessionId, runId: request.run_id });
+        return {
+            runId: request.run_id,
+            sessionId,
+            sessionKey,
+            created: true,
+            duplicate: false
+        };
+    }
+    dispose() {
+        for (const session of this.sessions.values()) {
+            try {
+                session.process.kill();
+            }
+            catch {
+                // The child may already have exited.
+            }
+        }
+        this.sessions.clear();
+    }
+    /** Stop the PTY that owns the requested remote run. */
+    cancelRun(runId) {
+        const session = [...this.sessions.values()].find((item) => item.runId === runId);
+        if (!session)
+            return false;
+        session.cancelRequested = true;
+        try {
+            session.process.kill();
+            this.logger.info('cli-run-cancel-requested', { runId, sessionId: session.sessionId });
+            return true;
+        }
+        catch (error) {
+            this.logger.warn('cli-run-cancel-failed', { runId, error: this.errorMessage(error) });
+            return false;
+        }
+    }
+    async writePrompt(session, prompt) {
+        await session.ready;
+        const safePrompt = prompt.replaceAll('\u0000', '').replaceAll('\u001b', '');
+        session.process.write(`\u001b[200~${safePrompt}\u001b[201~\r`);
+    }
+    waitForStartupOutput(terminal) {
+        return new Promise((resolveReady) => {
+            let settled = false;
+            const finish = () => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                disposable.dispose();
+                resolveReady();
+            };
+            const disposable = terminal.onData(() => finish());
+            const timer = setTimeout(finish, 2_000);
+        });
+    }
+    autoApproveTrustPrompt(terminal, runId) {
+        let buffer = '';
+        let disposable;
+        let exitDisposable;
+        let timer;
+        let settled = false;
+        return new Promise((resolveApproval) => {
+            const finish = () => {
+                if (settled)
+                    return;
+                settled = true;
+                if (timer)
+                    clearTimeout(timer);
+                disposable?.dispose();
+                exitDisposable?.dispose();
+                resolveApproval();
+            };
+            disposable = terminal.onData((output) => {
+                buffer = `${buffer}${output}`.replace(/\u001b\[[0-?]*[ -/]*[@-~]/g, '').slice(-512);
+                if (!buffer.includes('Warning: Kiro is running in trust all tools mode'))
+                    return;
+                // Kiro's TUI processes navigation on a render cycle. Writing the down
+                // key and Enter together can select its default "No, exit" action.
+                terminal.write('\u001b[B');
+                setTimeout(() => {
+                    if (settled)
+                        return;
+                    terminal.write('\r');
+                    this.logger.info('cli-trust-prompt-approved', { runId });
+                    finish();
+                }, 150);
+            });
+            exitDisposable = terminal.onExit(finish);
+            // Older Kiro versions do not show the warning when permissions.yaml has
+            // already granted trust. Do not block those sessions indefinitely.
+            timer = setTimeout(() => {
+                this.logger.debug('cli-trust-prompt-not-seen', { runId });
+                finish();
+            }, 5_000);
+        });
+    }
+    outputMarkers(output) {
+        const plain = output.replace(/\u001b\[[0-?]*[ -/]*[@-~]/g, '').toLowerCase();
+        const markers = [];
+        if (plain.includes('requires approval') || plain.includes('permission'))
+            markers.push('approval');
+        if (plain.includes('echo_report_task_progress'))
+            markers.push('echo-report');
+        if (plain.includes('error') || plain.includes('failed'))
+            markers.push('error');
+        return markers;
+    }
+    async validateWorkdir(input) {
+        if (!input)
+            throw new Error('no allowed work directory configured');
+        const candidate = await realpath(isAbsolute(input) ? input : resolve(input));
+        for (const root of this.config.allowedRoots) {
+            const allowed = await realpath(root).catch(() => resolve(root));
+            const segment = relative(allowed, candidate);
+            if (segment === '' || (!segment.startsWith('..') && !isAbsolute(segment)))
+                return candidate;
+        }
+        throw new Error('requested work directory is outside TASKMCP_ALLOWED_ROOTS');
+    }
+    async ensurePtyHelperExecutable() {
+        if (process.platform !== 'darwin')
+            return;
+        const packageRoot = dirname(require.resolve('node-pty/package.json'));
+        const helperPath = join(packageRoot, 'prebuilds', `darwin-${process.arch}`, 'spawn-helper');
+        await chmod(helperPath, 0o755);
+    }
+    errorMessage(error) {
+        return error instanceof Error ? error.message : String(error);
+    }
+}
+const ANSI_ESCAPE = /\u001b\[[0-?]*[ -/]*[@-~]/g;
+const SENSITIVE_VALUE = /\b(?:sk|rk|pk|ghp|github_pat)_[A-Za-z0-9._-]+\b|\bBearer\s+[^\s]+|\b(?:api[_-]?key|token|authorization|x-mcp-token)\s*[:=]\s*[^\s]+/gi;
+const FAILURE_LINE = /\b(?:error|failed|failure|fatal|forbidden|unauthorized|denied|invalid|unable|not found)\b|失败|错误|额度|拒绝|无权限|未授权/i;
+const MAX_FAILURE_SUMMARY_LENGTH = 500;
+function failureSummary(output) {
+    const cleaned = output
+        .replace(ANSI_ESCAPE, '')
+        .replace(/\r/g, '\n')
+        .replace(/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/g, '')
+        .replace(SENSITIVE_VALUE, '[redacted]');
+    const matchingLines = cleaned
+        .split('\n')
+        .map((line) => line.trim().replace(/\s+/g, ' '))
+        .filter((line) => line.length > 0 && FAILURE_LINE.test(line));
+    const detail = matchingLines.at(-1);
+    return detail ? detail.slice(-MAX_FAILURE_SUMMARY_LENGTH) : undefined;
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/src/session/session-manager.js.map

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

package/dist/src/shared/node-cli-command-resolution.d.ts

@@ -0,0 +1,11 @@
+type ResolveCommandOptions = {
+    pathEnv?: string | null;
+    platform?: NodeJS.Platform;
+    homePath?: string;
+};
+export declare function resolveCliCommand(commandName: string, options?: ResolveCommandOptions): string;
+export declare function resolveCliCommands(commandNames: readonly string[], options?: ResolveCommandOptions): Map<string, string>;
+export declare function resolveCodexCommand(options?: ResolveCommandOptions): string;
+export declare function resolveClaudeCommand(options?: ResolveCommandOptions): string;
+export declare function getVersionManagerBinPaths(options?: ResolveCommandOptions): string[];
+export {};

package/dist/src/shared/node-cli-command-resolution.js

@@ -0,0 +1,163 @@
+import { accessSync, constants, existsSync, readdirSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { delimiter, dirname, join } from 'node:path';
+function getExecutableNames(platform, commandName) {
+    if (platform === 'win32') {
+        return [`${commandName}.cmd`, `${commandName}.exe`, `${commandName}.bat`, commandName];
+    }
+    return [commandName];
+}
+function splitPath(pathEnv) {
+    if (!pathEnv) {
+        return [];
+    }
+    return pathEnv
+        .split(delimiter)
+        .map((entry) => entry.trim())
+        .filter(Boolean);
+}
+function parseVersionSegment(raw) {
+    return raw
+        .replace(/^v/i, '')
+        .split('.')
+        .map((segment) => Number.parseInt(segment, 10))
+        .map((segment) => (Number.isFinite(segment) ? segment : 0));
+}
+function compareVersionDesc(left, right) {
+    const leftParts = parseVersionSegment(left);
+    const rightParts = parseVersionSegment(right);
+    const length = Math.max(leftParts.length, rightParts.length);
+    for (let index = 0; index < length; index += 1) {
+        const delta = (rightParts[index] ?? 0) - (leftParts[index] ?? 0);
+        if (delta !== 0) {
+            return delta;
+        }
+    }
+    return right.localeCompare(left);
+}
+function findFirstExecutable(platform, directories, executableNames) {
+    for (const directory of directories) {
+        for (const executableName of executableNames) {
+            const candidate = join(directory, executableName);
+            if (isRunnableCommand(platform, candidate)) {
+                return candidate;
+            }
+        }
+    }
+    return null;
+}
+function isRunnableCommand(platform, candidate) {
+    try {
+        const stats = statSync(candidate);
+        if (!stats.isFile()) {
+            return false;
+        }
+        if (platform === 'win32') {
+            return true;
+        }
+        // Why: GUI fallback probing should skip placeholders/directories so spawn
+        // can continue to a runnable CLI instead of failing later with EACCES/EISDIR.
+        accessSync(candidate, constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function getBaseVersionManagerDirectories(platform, homePath) {
+    const directories = [
+        join(homePath, '.volta', 'bin'),
+        join(homePath, '.asdf', 'shims'),
+        join(homePath, '.fnm', 'aliases', 'default', 'bin'),
+        // Why: mise (formerly rtx) exposes managed tool binaries via a shims
+        // directory, similar to asdf.
+        join(homePath, '.local', 'share', 'mise', 'shims')
+    ];
+    if (platform === 'win32') {
+        // Why: Anthropic's native Windows installer places claude.exe here, and
+        // GUI-launched Orca may not inherit the user's PATH entry for it.
+        directories.push(join(homePath, '.local', 'bin'));
+        directories.push(join(homePath, 'AppData', 'Roaming', 'npm'));
+        directories.push(join(homePath, 'AppData', 'Local', 'pnpm'));
+        directories.push(join(homePath, 'AppData', 'Local', 'Yarn', 'bin'));
+    }
+    else {
+        directories.push(join(homePath, '.local', 'bin'));
+        // Why: pnpm uses platform-specific global bin directories that differ from
+        // npm's ~/.local/bin.
+        if (platform === 'darwin') {
+            directories.push(join(homePath, 'Library', 'pnpm'));
+        }
+        else {
+            directories.push(join(homePath, '.local', 'share', 'pnpm'));
+        }
+        directories.push(join(homePath, '.yarn', 'bin'));
+    }
+    directories.push(join(homePath, '.bun', 'bin'));
+    return directories;
+}
+function getNvmVersionDirectories(homePath) {
+    const nvmVersionsDir = join(homePath, '.nvm', 'versions', 'node');
+    if (!existsSync(nvmVersionsDir)) {
+        return [];
+    }
+    return readdirSync(nvmVersionsDir, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => entry.name)
+        .sort(compareVersionDesc)
+        .map((entry) => join(nvmVersionsDir, entry, 'bin'));
+}
+function getVersionManagerDirectories(platform, homePath, executableNames) {
+    const directories = getBaseVersionManagerDirectories(platform, homePath);
+    const firstNvmMatch = findFirstExecutable(platform, getNvmVersionDirectories(homePath), executableNames);
+    if (firstNvmMatch) {
+        directories.unshift(dirname(firstNvmMatch));
+    }
+    return directories;
+}
+export function resolveCliCommand(commandName, options = {}) {
+    const platform = options.platform ?? process.platform;
+    const executableNames = getExecutableNames(platform, commandName);
+    const pathEnv = options.pathEnv ?? process.env.PATH ?? process.env.Path ?? null;
+    const pathCandidate = findFirstExecutable(platform, splitPath(pathEnv), executableNames);
+    if (pathCandidate) {
+        return pathCandidate;
+    }
+    const homePath = options.homePath ?? homedir();
+    const nvmCandidate = findFirstExecutable(platform, getNvmVersionDirectories(homePath), executableNames);
+    const versionManagerCandidate = nvmCandidate ??
+        findFirstExecutable(platform, getBaseVersionManagerDirectories(platform, homePath), executableNames);
+    return versionManagerCandidate ?? commandName;
+}
+export function resolveCliCommands(commandNames, options = {}) {
+    const platform = options.platform ?? process.platform;
+    const pathEnv = options.pathEnv ?? process.env.PATH ?? process.env.Path ?? null;
+    const pathDirectories = splitPath(pathEnv);
+    const homePath = options.homePath ?? homedir();
+    const installDirectories = [
+        ...getNvmVersionDirectories(homePath),
+        ...getBaseVersionManagerDirectories(platform, homePath)
+    ];
+    const resolved = new Map();
+    for (const commandName of new Set(commandNames)) {
+        const executableNames = getExecutableNames(platform, commandName);
+        const pathCandidate = findFirstExecutable(platform, pathDirectories, executableNames);
+        const installCandidate = pathCandidate ?? findFirstExecutable(platform, installDirectories, executableNames);
+        resolved.set(commandName, installCandidate ?? commandName);
+    }
+    return resolved;
+}
+export function resolveCodexCommand(options = {}) {
+    return resolveCliCommand('codex', options);
+}
+export function resolveClaudeCommand(options = {}) {
+    return resolveCliCommand('claude', options);
+}
+// Why: Node-script CLIs need their version-manager sibling `node` on PATH.
+export function getVersionManagerBinPaths(options = {}) {
+    const platform = options.platform ?? process.platform;
+    const homePath = options.homePath ?? homedir();
+    const nodeNames = getExecutableNames(platform, 'node');
+    return getVersionManagerDirectories(platform, homePath, nodeNames);
+}
+//# sourceMappingURL=node-cli-command-resolution.js.map

package/dist/src/shared/node-cli-command-resolution.js.map

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

package/dist/src/state/state-store.d.ts

@@ -0,0 +1,48 @@
+export type RunStatus = 'received' | 'delivered' | 'completed' | 'failed';
+export type RunRecord = {
+    runId: string;
+    status: RunStatus;
+    sessionId?: string;
+    updatedAt: string;
+};
+export type SessionRecord = {
+    sessionKey: string;
+    sessionId: string;
+    agentType: string;
+    workdir: string;
+    providerSessionId?: string;
+    updatedAt: string;
+};
+/** A named remote window. taskId is the cross-device routing identity. */
+export type CliWindowRecord = {
+    taskId: string;
+    agentType: string;
+    name: string;
+    sessionId: string;
+    providerSessionId?: string;
+    workdir: string;
+    updatedAt: string;
+};
+export declare class StateStore {
+    private readonly filePath;
+    private state?;
+    private writeChain;
+    constructor(filePath: string);
+    initialize(): Promise<void>;
+    getRun(runId: string): RunRecord | undefined;
+    markRun(runId: string, status: RunStatus, sessionId?: string): Promise<void>;
+    getSession(sessionKey: string): SessionRecord | undefined;
+    upsertSession(record: SessionRecord): Promise<void>;
+    removeSession(sessionKey: string): Promise<void>;
+    getCliWindow(taskId: string, agentType: string): CliWindowRecord | undefined;
+    upsertCliWindow(record: CliWindowRecord): Promise<void>;
+    listCliWindows(agentType?: string): CliWindowRecord[];
+    snapshot(): {
+        runs: number;
+        sessions: number;
+    };
+    recentRuns(limit?: number): RunRecord[];
+    private requireState;
+    private cliWindowKey;
+    private persist;
+}