@coralai/claude-code-agent 0.1.0

package/dist/errors.js

@@ -0,0 +1,33 @@
+/**
+ * AgentError + error codes — single error class for all failure modes
+ * across spawn, transport, session, prompt, recording, replay, and auth.
+ *
+ * Spec: vision doc §3 (Error Model). Total 18 codes (initial 16 + spike-added
+ * REPLAY_MISMATCH / REPLAY_EOF for v0.1 Recording feature).
+ */
+/** Standardized error for all agent operations. */
+export class AgentError extends Error {
+    code;
+    /** Original error captured at the failure site, if any. */
+    cause;
+    /** Debug context: pid, sessionId, turnId, lastUpdate, etc. */
+    context;
+    /** Actionable fix guidance — auto-populated for AUTH_ERROR (calls checkRuntime). */
+    diagnostic;
+    constructor(code, message, options) {
+        super(message);
+        this.name = 'AgentError';
+        this.code = code;
+        if (options?.cause !== undefined)
+            this.cause = options.cause;
+        if (options?.context !== undefined)
+            this.context = options.context;
+        if (options?.diagnostic !== undefined)
+            this.diagnostic = options.diagnostic;
+    }
+}
+/** Type-narrowing helper for callers handling errors. */
+export function isAgentError(err) {
+    return err instanceof AgentError;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsCH,mDAAmD;AACnD,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,IAAI,CAAiB;IAC9B,2DAA2D;IAClD,KAAK,CAAS;IACvB,8DAA8D;IACrD,OAAO,CAA2B;IAC3C,oFAAoF;IAC3E,UAAU,CAAU;IAE7B,YACE,IAAoB,EACpB,OAAe,EACf,OAIC;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,OAAO,EAAE,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC7D,IAAI,OAAO,EAAE,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QACnE,IAAI,OAAO,EAAE,UAAU,KAAK,SAAS;YAAE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAC9E,CAAC;CACF;AAED,yDAAyD;AACzD,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,OAAO,GAAG,YAAY,UAAU,CAAC;AACnC,CAAC"}

package/dist/hooks/fs.d.ts

@@ -0,0 +1,26 @@
+import type { PermissionMode } from './permissions.js';
+interface ReadTextFileRequest {
+    path: string;
+    line?: number;
+    limit?: number;
+}
+interface WriteTextFileRequest {
+    path: string;
+    content: string;
+}
+export declare class FileSystemHandlers {
+    private readonly rootDir;
+    private readonly permissionMode;
+    constructor(opts: {
+        cwd: string;
+        permissionMode: PermissionMode;
+    });
+    readTextFile(params: ReadTextFileRequest): Promise<{
+        content: string;
+    }>;
+    writeTextFile(params: WriteTextFileRequest): Promise<Record<string, never>>;
+    private resolvePathWithinRoot;
+    private sliceContent;
+}
+export {};
+//# sourceMappingURL=fs.d.ts.map

package/dist/hooks/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/hooks/fs.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,oBAAoB;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;gBAEpC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,cAAc,CAAA;KAAE;IAK3D,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IASvE,aAAa,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAUjF,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,YAAY;CAOrB"}

package/dist/hooks/fs.js

@@ -0,0 +1,61 @@
+/**
+ * @module        acp-fs-handlers
+ * @description   ACP 文件系统处理器，处理文件读写回调并强制沙箱隔离
+ *
+ * @author        eddy
+ * @organization  wykj
+ * @ownership     wykj/eddy
+ *
+ * @created       2026-03-31
+ * @updated       2026-04-03
+ *
+ * @role          adapter
+ * @layer         provider
+ * @boundedContext acp
+ */
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+export class FileSystemHandlers {
+    rootDir;
+    permissionMode;
+    constructor(opts) {
+        this.rootDir = path.resolve(opts.cwd);
+        this.permissionMode = opts.permissionMode;
+    }
+    async readTextFile(params) {
+        if (this.permissionMode === 'deny-all') {
+            throw new Error('Permission denied for fs/read_text_file (deny-all)');
+        }
+        const filePath = this.resolvePathWithinRoot(params.path);
+        const content = await readFile(filePath, 'utf-8');
+        return { content: this.sliceContent(content, params.line, params.limit) };
+    }
+    async writeTextFile(params) {
+        if (this.permissionMode === 'deny-all') {
+            throw new Error('Permission denied for fs/write_text_file (deny-all)');
+        }
+        const filePath = this.resolvePathWithinRoot(params.path);
+        await mkdir(path.dirname(filePath), { recursive: true });
+        await writeFile(filePath, params.content, 'utf-8');
+        return {};
+    }
+    resolvePathWithinRoot(rawPath) {
+        if (!path.isAbsolute(rawPath)) {
+            throw new Error(`Path must be absolute: ${rawPath}`);
+        }
+        const resolved = path.resolve(rawPath);
+        if (resolved !== this.rootDir && !resolved.startsWith(this.rootDir + path.sep)) {
+            throw new Error(`Path outside allowed cwd subtree: ${resolved}`);
+        }
+        return resolved;
+    }
+    sliceContent(content, line, limit) {
+        if (line == null && limit == null)
+            return content;
+        const lines = content.split('\n');
+        const startIndex = Math.max(0, (line ?? 1) - 1);
+        const endIndex = limit == null ? lines.length : Math.min(lines.length, startIndex + limit);
+        return lines.slice(startIndex, endIndex).join('\n');
+    }
+}
+//# sourceMappingURL=fs.js.map

package/dist/hooks/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/hooks/fs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,IAAI,MAAM,WAAW,CAAC;AAc7B,MAAM,OAAO,kBAAkB;IACZ,OAAO,CAAS;IAChB,cAAc,CAAiB;IAEhD,YAAY,IAAqD;QAC/D,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAA2B;QAC5C,IAAI,IAAI,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,MAA4B;QAC9C,IAAI,IAAI,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,MAAM,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACnD,OAAO,EAAE,CAAC;IACZ,CAAC;IAEO,qBAAqB,CAAC,OAAe;QAC3C,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,0BAA0B,OAAO,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,QAAQ,KAAK,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/E,MAAM,IAAI,KAAK,CAAC,qCAAqC,QAAQ,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,YAAY,CAAC,OAAe,EAAE,IAAa,EAAE,KAAc;QACjE,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI;YAAE,OAAO,OAAO,CAAC;QAClD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,UAAU,GAAG,KAAK,CAAC,CAAC;QAC3F,OAAO,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;CACF"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Public hooks barrel — re-exports user-facing hook types from agent.ts.
+ *
+ * Internal default implementations (fs.ts, permissions.ts, terminal.ts) are
+ * exported from those files directly and stay internal to the package.
+ *
+ * Step 1.4.5 status:
+ * - onStart / onStop / onError — wired in agent.ts (status transitions)
+ * - onSessionUpdate — wired in prompt() turn loop
+ * - onElicitation — reserved; claude-agent-acp 0.33.1 does not fire
+ *   elicitation (spike 2026-05-14). Forward-compatible: hook signature
+ *   uses SDK native types so when shim wires elicitation, no caller change
+ *   is needed.
+ * - onPermissionRequest + fs + terminal — TODO 1.4.7 (requires routing
+ *   through the AcpSdkAdapter ClientSideConnection handlers).
+ */
+export type { AgentHooks, PermissionRequest, PermissionDecision, } from '../agent.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,aAAa,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":""}

package/dist/hooks/permissions.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @module        acp-permissions
+ * @description   ACP 权限解析器，三层决策链自动审批工具调用权限
+ *
+ * @author        eddy
+ * @organization  wykj
+ * @ownership     wykj/eddy
+ *
+ * @created       2026-03-31
+ * @updated       2026-03-31
+ *
+ * @role          adapter
+ * @layer         provider
+ * @boundedContext acp
+ */
+export type PermissionMode = 'approve-all' | 'approve-reads' | 'deny-all';
+interface PermissionParams {
+    toolCall: {
+        toolCallId?: string;
+        title?: string;
+        kind?: string;
+        status?: string;
+    };
+    options: ReadonlyArray<{
+        optionId: string;
+        kind: string;
+        name?: string;
+    }>;
+}
+interface PermissionResponse {
+    outcome: {
+        outcome: 'selected';
+        optionId: string;
+    } | {
+        outcome: 'cancelled';
+    };
+}
+/** Infer tool kind from toolCall.kind or title keywords (aligned with acpx). */
+export declare function inferToolKind(params: Pick<PermissionParams, 'toolCall'>): string | undefined;
+export declare function resolvePermission(params: PermissionParams, mode: PermissionMode): PermissionResponse;
+export {};
+//# sourceMappingURL=permissions.d.ts.map

package/dist/hooks/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../src/hooks/permissions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,eAAe,GAAG,UAAU,CAAC;AAE1E,UAAU,gBAAgB;IACxB,QAAQ,EAAE;QACR,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,OAAO,EAAE,aAAa,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ;AAED,UAAU,kBAAkB;IAC1B,OAAO,EACH;QAAE,OAAO,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GACzC;QAAE,OAAO,EAAE,WAAW,CAAA;KAAE,CAAC;CAC9B;AAaD,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,GAAG,MAAM,GAAG,SAAS,CAc5F;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,GAAG,kBAAkB,CA8BpG"}

package/dist/hooks/permissions.js

@@ -0,0 +1,79 @@
+/**
+ * @module        acp-permissions
+ * @description   ACP 权限解析器，三层决策链自动审批工具调用权限
+ *
+ * @author        eddy
+ * @organization  wykj
+ * @ownership     wykj/eddy
+ *
+ * @created       2026-03-31
+ * @updated       2026-03-31
+ *
+ * @role          adapter
+ * @layer         provider
+ * @boundedContext acp
+ */
+function pickOption(options, kinds) {
+    for (const kind of kinds) {
+        const match = options.find((o) => o.kind === kind);
+        if (match)
+            return match;
+    }
+    return undefined;
+}
+/** Infer tool kind from toolCall.kind or title keywords (aligned with acpx). */
+export function inferToolKind(params) {
+    if (params.toolCall.kind)
+        return params.toolCall.kind;
+    const title = params.toolCall.title?.trim().toLowerCase() ?? '';
+    const head = title.split(':', 1)[0]?.trim() ?? '';
+    if (!head)
+        return undefined;
+    if (head.includes('read') || head.includes('cat'))
+        return 'read';
+    if (head.includes('search') || head.includes('find') || head.includes('grep'))
+        return 'search';
+    if (head.includes('write') || head.includes('edit') || head.includes('patch'))
+        return 'edit';
+    if (head.includes('delete') || head.includes('remove'))
+        return 'delete';
+    if (head.includes('move') || head.includes('rename'))
+        return 'move';
+    if (head.includes('run') || head.includes('execute') || head.includes('bash'))
+        return 'execute';
+    if (head.includes('fetch') || head.includes('http') || head.includes('url'))
+        return 'fetch';
+    if (head.includes('think'))
+        return 'think';
+    return 'other';
+}
+export function resolvePermission(params, mode) {
+    const { options } = params;
+    if (options.length === 0)
+        return { outcome: { outcome: 'cancelled' } };
+    const allowOption = pickOption(options, ['allow_once', 'allow_always']);
+    const rejectOption = pickOption(options, ['reject_once', 'reject_always']);
+    // Layer 1: global policy
+    if (mode === 'approve-all') {
+        const fallback = allowOption?.optionId ?? options[0]?.optionId;
+        if (!fallback)
+            return { outcome: { outcome: 'cancelled' } };
+        return { outcome: { outcome: 'selected', optionId: fallback } };
+    }
+    if (mode === 'deny-all') {
+        return rejectOption
+            ? { outcome: { outcome: 'selected', optionId: rejectOption.optionId } }
+            : { outcome: { outcome: 'cancelled' } };
+    }
+    // Layer 2: approve-reads — auto-approve read/search kinds
+    const kind = inferToolKind(params);
+    if ((kind === 'read' || kind === 'search') && allowOption) {
+        return { outcome: { outcome: 'selected', optionId: allowOption.optionId } };
+    }
+    // Layer 3: SPS is unattended — auto-approve (no TTY interaction)
+    if (allowOption) {
+        return { outcome: { outcome: 'selected', optionId: allowOption.optionId } };
+    }
+    return { outcome: { outcome: 'cancelled' } };
+}
+//# sourceMappingURL=permissions.js.map

package/dist/hooks/permissions.js.map

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

package/dist/hooks/terminal.d.ts

@@ -0,0 +1,56 @@
+import type { PermissionMode } from './permissions.js';
+interface CreateTerminalRequest {
+    sessionId: string;
+    command: string;
+    args?: string[];
+    env?: Array<{
+        name: string;
+        value: string;
+    }>;
+    cwd?: string;
+    outputByteLimit?: number;
+}
+interface TerminalOutputRequest {
+    sessionId: string;
+    terminalId: string;
+}
+interface WaitForTerminalExitRequest {
+    sessionId: string;
+    terminalId: string;
+}
+interface KillTerminalRequest {
+    sessionId: string;
+    terminalId: string;
+}
+interface ReleaseTerminalRequest {
+    sessionId: string;
+    terminalId: string;
+}
+interface ExitStatus {
+    exitCode: number | null;
+    signal: string | null;
+}
+export declare class TerminalManager {
+    private readonly cwd;
+    private readonly permissionMode;
+    private readonly terminals;
+    constructor(opts: {
+        cwd: string;
+        permissionMode: PermissionMode;
+    });
+    createTerminal(params: CreateTerminalRequest): Promise<{
+        terminalId: string;
+    }>;
+    terminalOutput(params: TerminalOutputRequest): Promise<{
+        output: string;
+        truncated: boolean;
+        exitStatus?: ExitStatus;
+    }>;
+    waitForTerminalExit(params: WaitForTerminalExitRequest): Promise<ExitStatus>;
+    killTerminal(params: KillTerminalRequest): Promise<Record<string, never>>;
+    releaseTerminal(params: ReleaseTerminalRequest): Promise<Record<string, never>>;
+    private killProcess;
+    private getTerminal;
+}
+export {};
+//# sourceMappingURL=terminal.d.ts.map

package/dist/hooks/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/hooks/terminal.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKvD,UAAU,qBAAqB;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,UAAU,qBAAqB;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,0BAA0B;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,mBAAmB;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,sBAAsB;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,UAAU;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAqBD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;gBAEpD,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,cAAc,CAAA;KAAE;IAK3D,cAAc,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IA+C9E,cAAc,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC;QAC3D,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,OAAO,CAAC;QACnB,UAAU,CAAC,EAAE,UAAU,CAAC;KACzB,CAAC;IAYI,mBAAmB,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,UAAU,CAAC;IAI5E,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAKzE,eAAe,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAQvE,WAAW;IAYzB,OAAO,CAAC,WAAW;CAKpB"}

package/dist/hooks/terminal.js

@@ -0,0 +1,127 @@
+/**
+ * @module        acp-terminal-manager
+ * @description   ACP 终端管理器，处理子进程创建、输出捕获与优雅终止
+ *
+ * @author        eddy
+ * @organization  wykj
+ * @ownership     wykj/eddy
+ *
+ * @created       2026-03-31
+ * @updated       2026-04-03
+ *
+ * @role          adapter
+ * @layer         provider
+ * @boundedContext acp
+ */
+import { spawn } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+const DEFAULT_OUTPUT_LIMIT_BYTES = 1024 * 1024; // 1MB
+const KILL_GRACE_MS = 5_000;
+function envArrayToRecord(env) {
+    if (!env)
+        return {};
+    const record = {};
+    for (const { name, value } of env) {
+        record[name] = value;
+    }
+    return record;
+}
+export class TerminalManager {
+    cwd;
+    permissionMode;
+    terminals = new Map();
+    constructor(opts) {
+        this.cwd = opts.cwd;
+        this.permissionMode = opts.permissionMode;
+    }
+    async createTerminal(params) {
+        if (this.permissionMode === 'deny-all') {
+            throw new Error('Permission denied for terminal/create (deny-all)');
+        }
+        const outputByteLimit = params.outputByteLimit ?? DEFAULT_OUTPUT_LIMIT_BYTES;
+        const proc = spawn(params.command, params.args ?? [], {
+            cwd: params.cwd ?? this.cwd,
+            env: { ...process.env, ...envArrayToRecord(params.env) },
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let resolveExit;
+        const exitPromise = new Promise((r) => { resolveExit = r; });
+        const terminal = {
+            process: proc,
+            output: Buffer.alloc(0),
+            truncated: false,
+            outputByteLimit,
+            exitCode: undefined,
+            signal: undefined,
+            exitPromise,
+        };
+        const appendOutput = (chunk) => {
+            terminal.output = Buffer.concat([terminal.output, chunk]);
+            if (terminal.output.length > terminal.outputByteLimit) {
+                terminal.output = terminal.output.subarray(-terminal.outputByteLimit);
+                terminal.truncated = true;
+            }
+        };
+        proc.stdout.on('data', appendOutput);
+        proc.stderr.on('data', appendOutput);
+        proc.once('exit', (code, signal) => {
+            terminal.exitCode = code;
+            terminal.signal = signal;
+            resolveExit({ exitCode: code ?? null, signal: signal ?? null });
+        });
+        const terminalId = randomUUID();
+        this.terminals.set(terminalId, terminal);
+        return { terminalId };
+    }
+    async terminalOutput(params) {
+        const terminal = this.getTerminal(params.terminalId);
+        const hasExit = terminal.exitCode !== undefined || terminal.signal !== undefined;
+        return {
+            output: terminal.output.toString('utf-8'),
+            truncated: terminal.truncated,
+            ...(hasExit
+                ? { exitStatus: { exitCode: terminal.exitCode ?? null, signal: terminal.signal ?? null } }
+                : {}),
+        };
+    }
+    async waitForTerminalExit(params) {
+        return this.getTerminal(params.terminalId).exitPromise;
+    }
+    async killTerminal(params) {
+        await this.killProcess(this.getTerminal(params.terminalId));
+        return {};
+    }
+    async releaseTerminal(params) {
+        const terminal = this.terminals.get(params.terminalId);
+        if (!terminal)
+            return {};
+        await this.killProcess(terminal);
+        this.terminals.delete(params.terminalId);
+        return {};
+    }
+    async killProcess(terminal) {
+        if (terminal.exitCode !== undefined)
+            return;
+        try {
+            terminal.process.kill('SIGTERM');
+        }
+        catch { /* already dead */ }
+        const exited = await Promise.race([
+            terminal.exitPromise.then(() => true),
+            new Promise((r) => setTimeout(() => r(false), KILL_GRACE_MS)),
+        ]);
+        if (!exited) {
+            try {
+                terminal.process.kill('SIGKILL');
+            }
+            catch { /* noop */ }
+        }
+    }
+    getTerminal(id) {
+        const terminal = this.terminals.get(id);
+        if (!terminal)
+            throw new Error(`Unknown terminal: ${id}`);
+        return terminal;
+    }
+}
+//# sourceMappingURL=terminal.js.map

package/dist/hooks/terminal.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @coralai/claude-code-agent — Public API barrel.
+ *
+ * v0.1.0-alpha.0: ClaudeCodeAgent class + supporting types.
+ *
+ * Public API surface (stable from v0.1.0):
+ *   - ClaudeCodeAgent class
+ *   - PromptHandle / PromptResult / SessionUpdate
+ *   - AgentError + 18 codes + isAgentError type guard
+ *   - AgentOptions / AgentHooks / PermissionMode / PermissionRequest /
+ *     PermissionDecision / UsageSummary / RuntimeCheck / Tracer
+ *   - RecordingWriter / RecordingReplayer (for tests + dev tooling)
+ *   - SpanManager (for advanced telemetry integration)
+ *
+ * Internal bridge re-exports (TEMPORARY — Step 1.5 removes once sps-cli
+ * switches to ClaudeCodeAgent class). sps-cli currently imports
+ * LocalACPClient / AcpSdkAdapter / etc. directly via this barrel.
+ */
+export { ClaudeCodeAgent } from './agent.js';
+export type { AgentOptions, AgentHooks, AgentStatus, PermissionMode, PermissionRequest, PermissionDecision, UsageSummary, RuntimeCheck, PromptAttachment, PromptOptions, Tracer, } from './agent.js';
+export type { PromptHandle, PromptResult, SessionUpdate, StopReason, } from './prompt-handle.js';
+export { aggregateResult } from './prompt-handle.js';
+export { AgentError, isAgentError, type AgentErrorCode } from './errors.js';
+export { RecordingWriter, RecordingReplayer, type RecordingEvent, } from './recording/index.js';
+export { SpanManager, SpanStatusCode, setAttributeSafe, truncateAttributeValue, type Attributes, type AttributeValue, type Span, } from './telemetry/index.js';
+export type { ACPRunRecord, ACPRunStatus, ACPSessionRecord, ACPSessionStatus, ACPSlotStatus, ACPState, ACPTool, } from './internal/acp-types.js';
+export type { ACPClient, EnsureSessionInput, EnsureSessionResult, StartRunInput, StartRunResult, InspectSessionInput, InspectSessionResult, InspectRunInput, InspectRunResult, StopSessionInput, McpServerConfig, AccumulatorEvent, AccumulatorListener, } from './internal/acp-client-interface.js';
+export type { AgentRuntime } from './internal/agent-runtime-interface.js';
+export { LocalACPClient } from './internal/local-acp-client.js';
+export { AcpSdkAdapter, loadAgentRegistry, type AgentRegistryEntry, } from './internal/sdk-adapter.js';
+export { SessionUpdateAccumulator } from './internal/session-accumulator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAG7C,YAAY,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,MAAM,GACP,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,UAAU,GACX,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAG5E,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,KAAK,cAAc,GACpB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,IAAI,GACV,MAAM,sBAAsB,CAAC;AAO9B,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,QAAQ,EACR,OAAO,GACR,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,SAAS,EACT,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,oCAAoC,CAAC;AAE5C,YAAY,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAE1E,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,KAAK,kBAAkB,GACxB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/index.js

@@ -0,0 +1,31 @@
+/**
+ * @coralai/claude-code-agent — Public API barrel.
+ *
+ * v0.1.0-alpha.0: ClaudeCodeAgent class + supporting types.
+ *
+ * Public API surface (stable from v0.1.0):
+ *   - ClaudeCodeAgent class
+ *   - PromptHandle / PromptResult / SessionUpdate
+ *   - AgentError + 18 codes + isAgentError type guard
+ *   - AgentOptions / AgentHooks / PermissionMode / PermissionRequest /
+ *     PermissionDecision / UsageSummary / RuntimeCheck / Tracer
+ *   - RecordingWriter / RecordingReplayer (for tests + dev tooling)
+ *   - SpanManager (for advanced telemetry integration)
+ *
+ * Internal bridge re-exports (TEMPORARY — Step 1.5 removes once sps-cli
+ * switches to ClaudeCodeAgent class). sps-cli currently imports
+ * LocalACPClient / AcpSdkAdapter / etc. directly via this barrel.
+ */
+// ─── Public class ──────────────────────────────────────────────
+export { ClaudeCodeAgent } from './agent.js';
+export { aggregateResult } from './prompt-handle.js';
+// ─── Errors ────────────────────────────────────────────────────
+export { AgentError, isAgentError } from './errors.js';
+// ─── Recording subsystem (test + dev tooling) ─────────────────
+export { RecordingWriter, RecordingReplayer, } from './recording/index.js';
+// ─── Telemetry (advanced integration) ──────────────────────────
+export { SpanManager, SpanStatusCode, setAttributeSafe, truncateAttributeValue, } from './telemetry/index.js';
+export { LocalACPClient } from './internal/local-acp-client.js';
+export { AcpSdkAdapter, loadAgentRegistry, } from './internal/sdk-adapter.js';
+export { SessionUpdateAccumulator } from './internal/session-accumulator.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,kEAAkE;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAwB7C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,kEAAkE;AAClE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAuB,MAAM,aAAa,CAAC;AAE5E,iEAAiE;AACjE,OAAO,EACL,eAAe,EACf,iBAAiB,GAElB,MAAM,sBAAsB,CAAC;AAE9B,kEAAkE;AAClE,OAAO,EACL,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,sBAAsB,GAIvB,MAAM,sBAAsB,CAAC;AAmC9B,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EACL,aAAa,EACb,iBAAiB,GAElB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC"}