@coralai/claude-code-agent 0.1.0

package/dist/agent.js

@@ -0,0 +1,592 @@
+/**
+ * ClaudeCodeAgent — public class for embedding ACP-compatible Claude Code in
+ * Node.js applications. Built from scratch on top of AcpSdkAdapter (per
+ * Step 1.3.3 finding: ACPWorkerRuntime is SPS-slot-adapter, not reusable).
+ *
+ * v0.1.0-alpha.0 (Step 1.4.3): constructor + state machine + start/stop only.
+ * Other methods (prompt / cancelAll / fork / promptJson / usage / static
+ * resumeSession/replay/checkRuntime) throw NOT_IMPLEMENTED — filled in
+ * Steps 1.4.4-1.4.8.
+ *
+ * Spec: vision doc §3 (Full API Surface), §5 (state machine).
+ */
+import { randomUUID } from 'node:crypto';
+import { AgentError } from './errors.js';
+import { aggregateResult, createPromptHandle, } from './prompt-handle.js';
+import { AcpSdkAdapter, } from './internal/sdk-adapter.js';
+import { RecordingWriter } from './recording/writer.js';
+import { SpanManager } from './telemetry/otel-adapter.js';
+// ─── Main class ────────────────────────────────────────
+const DEFAULT_SPAWN_TIMEOUT_MS = 60_000;
+const DEFAULT_ELICITATION_TIMEOUT_MS = 60_000;
+const DEFAULT_MAX_QUEUE_LENGTH = 32;
+export class ClaudeCodeAgent {
+    options;
+    // State machine
+    _status = 'idle';
+    _sessionId;
+    _pid;
+    // Internal transport
+    _sessionName;
+    _client = null;
+    // Idempotency caches: returning the same in-flight Promise from repeated
+    // start()/stop() prevents duplicate ACP handshakes.
+    _startPromise = null;
+    _stopPromise = null;
+    // Capability flags read from initialize response. Populated in start().
+    // Used by Step 1.4.4 prompt() to decide whether to queue or throw BUSY.
+    _supportsPromptQueueing = false;
+    // Current in-flight turn. v0.1: at most one active per session.
+    // 1.4.4 enforces this via BUSY / queue. Cleared when turn settles or cancels.
+    _currentTurn = null;
+    // Optional recording writer; null when options.recording is unset.
+    _recording = null;
+    // Optional OTel span manager; null when options.tracer is unset.
+    _spans = null;
+    // Cumulative usage across all turns in this session. Updated on each settle.
+    _cumUsage = {
+        inputTokens: 0,
+        outputTokens: 0,
+    };
+    constructor(options) {
+        this.options = options;
+        if (!options || typeof options.cwd !== 'string' || options.cwd.length === 0) {
+            throw new AgentError('CALL_AFTER_STOP', // best-fit code; constructor-level config is pre-lifecycle
+            'AgentOptions.cwd is required and must be a non-empty string', { context: { reason: 'invalid_options' } });
+        }
+        // Stable per-instance session name. Internal to the agent — never surfaced
+        // to callers. Step 1.5 will gate exposure if SPS needs slot-name parity.
+        this._sessionName = `cca-${randomUUID()}`;
+    }
+    // ─── Getters ─────────────────────────────────────────
+    get status() {
+        return this._status;
+    }
+    get sessionId() {
+        return this._sessionId;
+    }
+    get pid() {
+        return this._pid;
+    }
+    /** Whether the shim advertised promptQueueing capability at initialize.
+     *  Read after start() completes successfully. Used by Step 1.4.4. */
+    get supportsPromptQueueing() {
+        return this._supportsPromptQueueing;
+    }
+    // ─── Lifecycle ───────────────────────────────────────
+    /**
+     * Spawn shim + ACP initialize + newSession. Idempotent: repeated calls
+     * return the same Promise. `eager: true` is a documentation signal that
+     * the caller wants the spawn to happen now (vs lazy "spawn on first
+     * prompt") — in v0.1, start() always spawns now, so the flag only
+     * controls the displayed status ('warming' vs 'starting').
+     *
+     * Throws AgentError with code SPAWN_FAILED / SPAWN_TIMEOUT / INIT_FAILED /
+     * SESSION_FAILED / AUTH_ERROR / PROTOCOL_ERROR depending on failure point.
+     */
+    async start(opts) {
+        if (this._status === 'stopped' || this._status === 'error') {
+            throw new AgentError('CALL_AFTER_STOP', `Cannot start agent in terminal state '${this._status}'`, { context: { status: this._status } });
+        }
+        if (this._startPromise)
+            return this._startPromise;
+        this._startPromise = this._doStart(opts?.eager === true);
+        return this._startPromise;
+    }
+    async _doStart(eager) {
+        this._status = eager ? 'warming' : 'starting';
+        try {
+            const internalMode = this._mapPermissionMode(this.options.permissionMode ?? 'auto');
+            this._client = new AcpSdkAdapter(internalMode);
+            const result = await this._client.ensureSession({
+                sessionName: this._sessionName,
+                tool: 'claude',
+                cwd: this.options.cwd,
+                ...(this.options.env ? { extraEnv: this.options.env } : {}),
+            });
+            this._sessionId = result.sessionId;
+            this._pid = result.pid ?? undefined;
+            this._status = 'ready';
+            // Open OTel session span (if configured). Errors don't abort start.
+            if (this.options.tracer) {
+                try {
+                    this._spans = new SpanManager(this.options.tracer);
+                    this._spans.startSession({
+                        sessionId: this._sessionId,
+                        cwd: this.options.cwd,
+                        ...(this._pid !== undefined ? { pid: this._pid } : {}),
+                    });
+                }
+                catch (e) {
+                    this._log('warn', `OTel tracer failed: ${e instanceof Error ? e.message : String(e)}`);
+                    this._spans = null;
+                }
+            }
+            // Open recording writer (if configured) and emit session_start.
+            // Failure here logs but does not abort start — recording is best-effort.
+            if (this.options.recording) {
+                try {
+                    this._recording = new RecordingWriter(this.options.recording);
+                    this._recording.write({
+                        type: 'session_start',
+                        sessionId: this._sessionId,
+                        ...(this._pid !== undefined ? { pid: this._pid } : {}),
+                        cwd: this.options.cwd,
+                    });
+                }
+                catch (e) {
+                    this._log('warn', `Recording open failed (${this.options.recording}): ${e instanceof Error ? e.message : String(e)}`);
+                    this._recording = null;
+                }
+            }
+            // Notify caller. Hook exceptions never poison the start contract.
+            this._safeFire('onStart', () => this.options.hooks?.onStart?.({
+                pid: this._pid,
+                sessionId: this._sessionId,
+            }));
+        }
+        catch (e) {
+            this._status = 'error';
+            const err = this._wrapStartError(e);
+            this._safeFire('onError', () => this.options.hooks?.onError?.(err));
+            throw err;
+        }
+    }
+    /**
+     * Close session (v0.20 stable closeSession) + drain in-flight prompts +
+     * kill shim. Idempotent. An agent that was never started transitions
+     * directly to 'stopped'.
+     */
+    async stop() {
+        if (this._status === 'idle') {
+            // Never started — go straight to stopped without invoking transport.
+            this._status = 'stopped';
+            return;
+        }
+        if (this._status === 'stopped')
+            return;
+        if (this._stopPromise)
+            return this._stopPromise;
+        this._stopPromise = this._doStop();
+        return this._stopPromise;
+    }
+    async _doStop() {
+        const previousStatus = this._status;
+        this._status = 'stopping';
+        try {
+            if (this._client) {
+                await this._client.stopSession({
+                    sessionName: this._sessionName,
+                    tool: 'claude',
+                });
+            }
+            this._status = 'stopped';
+            // Close OTel session span
+            if (this._spans) {
+                try {
+                    this._spans.endSession({ code: 0 });
+                }
+                catch { /* best effort */ }
+                this._spans = null;
+            }
+            // Force-flush recording (D4 contract: stop() drains pending bytes)
+            if (this._recording) {
+                const rec = this._recording;
+                rec.write({ type: 'session_stop', code: 0 });
+                try {
+                    await rec.close();
+                }
+                catch {
+                    /* best effort */
+                }
+                this._recording = null;
+            }
+            this._safeFire('onStop', () => this.options.hooks?.onStop?.({ code: 0 }));
+        }
+        catch (e) {
+            this._status = 'error';
+            const err = new AgentError('SHIM_DIED', `stop() failed: ${e instanceof Error ? e.message : String(e)}`, {
+                ...(e instanceof Error ? { cause: e } : {}),
+                context: { previousStatus, sessionId: this._sessionId },
+            });
+            this._safeFire('onError', () => this.options.hooks?.onError?.(err));
+            throw err;
+        }
+        finally {
+            this._client = null;
+        }
+    }
+    // ─── prompt / cancelAll (Step 1.4.4) ─────────────────
+    /**
+     * Submit a prompt. Returns a PromptHandle whose `result` resolves with the
+     * aggregated PromptResult, and whose `updates` AsyncIterable broadcasts
+     * every SessionUpdate (D1 broadcast semantics).
+     *
+     * v0.1: single in-flight prompt per agent. Concurrent prompt() throws BUSY
+     * unless queuePrompts='always' (queue implementation lands in 1.4.4+).
+     * For v0.1.0-alpha we accept the simplest behavior: BUSY on overlap.
+     */
+    prompt(text, opts) {
+        if (!this._client || !this._sessionId) {
+            throw new AgentError('CALL_AFTER_STOP', `Cannot prompt: agent not started (status=${this._status})`, { context: { status: this._status } });
+        }
+        if (this._status === 'stopped' || this._status === 'error') {
+            throw new AgentError('CALL_AFTER_STOP', `Cannot prompt in terminal state '${this._status}'`);
+        }
+        if (this._currentTurn) {
+            // v0.1: no queueing yet. Will refine in later sub-tasks.
+            throw new AgentError('BUSY', 'Agent already has an in-flight prompt; await handle.result or call cancelAll() first', { context: { currentTurnId: this._currentTurn.turnId } });
+        }
+        const turnId = randomUUID();
+        const ctrl = createPromptHandle(turnId, this._sessionId);
+        const collected = [];
+        const client = this._client;
+        const sessionName = this._sessionName;
+        // Subscribe BEFORE startRun so we don't miss early events. The shim
+        // emits notifications serially after `conn.prompt()` begins, so the
+        // listener attached in the same tick captures everything.
+        const unsubscribe = client.subscribe(sessionName, (event) => {
+            if (event.type === 'complete') {
+                const stopReason = this._mapStopReason(event.stopReason);
+                const finalResult = aggregateResult(turnId, collected, stopReason);
+                this._recording?.write({
+                    type: 'turn_end',
+                    turnId,
+                    stopReason: finalResult.stopReason,
+                    ...(finalResult.usage ? { usage: finalResult.usage } : {}),
+                });
+                this._spans?.endPrompt({
+                    stopReason: finalResult.stopReason,
+                    ...(finalResult.usage ? { usage: finalResult.usage } : {}),
+                });
+                // Accumulate usage for usage() getter
+                if (finalResult.usage)
+                    this._addUsage(finalResult.usage);
+                ctrl.settle(finalResult);
+                this._endTurn();
+                return;
+            }
+            const update = this._accumulatorToSessionUpdate(event);
+            if (update !== null) {
+                collected.push(update);
+                ctrl.pushUpdate(update);
+                this._recording?.write({ type: 'session_update', turnId, update });
+                this._safeFire('onSessionUpdate', () => this.options.hooks?.onSessionUpdate?.(update, turnId));
+            }
+        });
+        this._currentTurn = { turnId, controller: ctrl, unsubscribe };
+        this._status = 'busy';
+        this._recording?.write({ type: 'turn_start', turnId, prompt: text });
+        this._spans?.startPrompt({ turnId, promptPreview: text });
+        // Per-handle cancel routes to ACP cancelRun. The accumulator emits
+        // 'complete' with stopReason='cancelled' after the cancel ACK, which
+        // settles the handle through the same path as normal completion.
+        ctrl.setCancelImpl(async () => {
+            try {
+                await client.cancelRun(sessionName);
+            }
+            catch (e) {
+                // Best-effort: even if cancel RPC fails, fail the handle so the
+                // caller's await unblocks. The session may be in a weird state;
+                // surface it via onError.
+                const err = new AgentError('PROMPT_CANCELLED', `cancelRun failed but handle is being failed anyway: ${e instanceof Error ? e.message : String(e)}`, { ...(e instanceof Error ? { cause: e } : {}), context: { turnId } });
+                ctrl.fail(err);
+                this._endTurn();
+                return;
+            }
+            ctrl.fail(new AgentError('PROMPT_CANCELLED', 'Cancelled via handle.cancel()', {
+                context: { turnId },
+            }));
+            this._endTurn();
+        });
+        // Wire optional AbortSignal to the same cancel path
+        if (opts?.signal) {
+            const signal = opts.signal;
+            if (signal.aborted) {
+                // Already aborted — fire cancel on next tick so caller receives handle first
+                queueMicrotask(() => { void ctrl.handle.cancel(); });
+            }
+            else {
+                const onAbort = () => { void ctrl.handle.cancel(); };
+                signal.addEventListener('abort', onAbort, { once: true });
+            }
+        }
+        // Fire-and-forget: actual completion comes via accumulator 'complete'.
+        // startRun returns the synthetic 'running' state immediately; rejecting
+        // here means the prompt couldn't be submitted at all.
+        client
+            .startRun({ sessionName, tool: 'claude', prompt: text })
+            .catch((e) => {
+            const err = new AgentError('CLAUDE_ERROR', `startRun failed: ${e instanceof Error ? e.message : String(e)}`, {
+                ...(e instanceof Error ? { cause: e } : {}),
+                context: { turnId, sessionId: this._sessionId },
+            });
+            ctrl.fail(err);
+            this._safeFire('onError', () => this.options.hooks?.onError?.(err));
+            this._endTurn();
+        });
+        return ctrl.handle;
+    }
+    /**
+     * Cancel the in-flight prompt (and, when v1.x queueing lands, the queued
+     * prompts too). v0.1: same effect as `handle.cancel()` for the current
+     * turn. Safe to call when no turn is active (no-op).
+     */
+    async cancelAll() {
+        if (!this._currentTurn)
+            return;
+        await this._currentTurn.controller.handle.cancel();
+    }
+    /** Step 1.4.8 will implement fork via v0.20 session.fork + resumeSession. */
+    async fork() {
+        throw new Error('NOT_IMPLEMENTED: fork() lands in Step 1.4.8 (depends on resumeSession)');
+    }
+    /**
+     * Structured output helper. Sends a prompt that asks Claude to return JSON
+     * matching the supplied zod schema. Parses + validates the result.
+     *
+     * v0.1: claude-only. Non-claude agents throw UNSUPPORTED_ON_AGENT (the
+     * agent registry doesn't expose JSON mode capability uniformly yet).
+     *
+     * The supplied schema must have a `.parse(input): T` method (zod-compatible
+     * structural interface — works with zod v3 + v4).
+     */
+    async promptJson(text, schema, opts) {
+        if (!schema || typeof schema.parse !== 'function') {
+            throw new AgentError('CLAUDE_ERROR', 'promptJson schema must expose a .parse(input) method (e.g. zod schema)');
+        }
+        // v1: claude-only. v1.1+ will route via agent registry capabilities.
+        const wrappedPrompt = `${text}\n\nReply with ONLY a JSON object matching the requested schema. No prose, no fences.`;
+        const handle = this.prompt(wrappedPrompt, opts);
+        const result = await handle.result;
+        let parsed;
+        try {
+            parsed = JSON.parse(result.text.trim());
+        }
+        catch (e) {
+            throw new AgentError('CLAUDE_ERROR', `promptJson: response was not valid JSON: ${e instanceof Error ? e.message : String(e)}`, {
+                ...(e instanceof Error ? { cause: e } : {}),
+                context: { text: result.text.slice(0, 200) },
+            });
+        }
+        try {
+            return schema.parse(parsed);
+        }
+        catch (e) {
+            throw new AgentError('CLAUDE_ERROR', `promptJson: schema validation failed: ${e instanceof Error ? e.message : String(e)}`, {
+                ...(e instanceof Error ? { cause: e } : {}),
+                context: { parsed },
+            });
+        }
+    }
+    /** Cumulative token + cost usage across all turns settled so far. */
+    usage() {
+        // Return a copy so callers can't mutate internal state.
+        return { ...this._cumUsage };
+    }
+    // ─── Static methods ──────────────────────────────────
+    /**
+     * Detect runtime prerequisites: local `claude` CLI binary, the
+     * `claude-agent-acp` shim, and the active auth mode.
+     * Step 1.4.8 ships best-effort detection; refined in v0.2 with
+     * shim version detection.
+     */
+    static async checkRuntime() {
+        const { execFileSync } = await import('node:child_process');
+        const { existsSync } = await import('node:fs');
+        const { homedir } = await import('node:os');
+        const { resolve } = await import('node:path');
+        const probeBinary = (name) => {
+            try {
+                const path = execFileSync('which', [name], { encoding: 'utf-8' }).trim();
+                return path.length > 0 ? { ok: true, path } : { ok: false };
+            }
+            catch {
+                return { ok: false };
+            }
+        };
+        const claudeBinary = probeBinary('claude');
+        const shim = probeBinary('claude-agent-acp');
+        const authPath = resolve(homedir(), '.claude', '.credentials.json');
+        let authMode = 'none';
+        if (process.env.ANTHROPIC_API_KEY) {
+            authMode = 'env_api_key';
+        }
+        else if (existsSync(authPath)) {
+            authMode = 'oauth_subscription';
+        }
+        return {
+            claudeBinary: claudeBinary.ok
+                ? { ok: true, ...(claudeBinary.path ? { path: claudeBinary.path } : {}) }
+                : { ok: false },
+            shim: shim.ok
+                ? { ok: true, mode: 'global', ...(shim.path ? { path: shim.path } : {}) }
+                : { ok: false, mode: 'npx' },
+            auth: { mode: authMode },
+        };
+    }
+    /** Resume an existing session by id. Deferred to v1.1 — requires the
+     *  AcpSdkAdapter to expose a `loadSession` method against the shim's
+     *  v0.20 loadSession capability. */
+    static async resumeSession(_sessionId, _options) {
+        throw new AgentError('UNSUPPORTED_ON_AGENT', 'resumeSession() is reserved for v1.1 (needs AcpSdkAdapter.loadSession wiring)');
+    }
+    /** Replay a session from a recording file. Minimal v0.1 implementation
+     *  reads the jsonl; full hook-divergence validation (REPLAY_MISMATCH)
+     *  lands in v0.2 once the public agent surface supports replay-driven
+     *  hook injection. */
+    static async replay(_recordingPath, _options) {
+        throw new AgentError('UNSUPPORTED_ON_AGENT', 'replay() returns a real ClaudeCodeAgent only in v0.2; for now use new RecordingReplayer(path) directly');
+    }
+    // ─── Private helpers ─────────────────────────────────
+    /** Map public permission mode to internal hooks/permissions PermissionMode.
+     *  'manual' currently maps to 'deny-all' — Step 1.4.5 will properly route
+     *  through onPermissionRequest hook instead. */
+    _mapPermissionMode(mode) {
+        switch (mode) {
+            case 'auto':
+                return 'approve-all';
+            case 'readonly':
+                return 'approve-reads';
+            case 'manual':
+                // TODO 1.4.5: route through hooks.onPermissionRequest. Until then
+                // 'deny-all' is the safe default (callers without the hook want
+                // safety; callers with the hook will get the proper wiring soon).
+                return 'deny-all';
+        }
+    }
+    /** Wrap an AcpSdkAdapter error into the appropriate AgentError code.
+     *  Best-effort string matching; refinement lives in Step 1.4.5 when we
+     *  surface structured errors from the adapter. */
+    _wrapStartError(e) {
+        if (e instanceof AgentError)
+            return e;
+        const msg = e instanceof Error ? e.message : String(e);
+        const cause = e instanceof Error ? e : new Error(String(e));
+        // Heuristic mapping. Replaceable when adapter exposes typed errors.
+        const lowered = msg.toLowerCase();
+        let code = 'SESSION_FAILED';
+        if (lowered.includes('spawn') && lowered.includes('timeout')) {
+            code = 'SPAWN_TIMEOUT';
+        }
+        else if (lowered.includes('spawn') || lowered.includes('enoent')) {
+            code = 'SPAWN_FAILED';
+        }
+        else if (lowered.includes('initialize')) {
+            code = 'INIT_FAILED';
+        }
+        else if (lowered.includes('auth') || lowered.includes('credentials')) {
+            code = 'AUTH_ERROR';
+        }
+        else if (lowered.includes('protocol') || lowered.includes('json-rpc')) {
+            code = 'PROTOCOL_ERROR';
+        }
+        return new AgentError(code, `Failed to start agent: ${msg}`, {
+            cause,
+            context: { sessionName: this._sessionName, cwd: this.options.cwd },
+        });
+    }
+    /** Accumulate turn usage into the cumulative session usage tally. */
+    _addUsage(delta) {
+        this._cumUsage.inputTokens += delta.inputTokens;
+        this._cumUsage.outputTokens += delta.outputTokens;
+        if (delta.cacheReadTokens !== undefined) {
+            this._cumUsage.cacheReadTokens =
+                (this._cumUsage.cacheReadTokens ?? 0) + delta.cacheReadTokens;
+        }
+        if (delta.cacheWriteTokens !== undefined) {
+            this._cumUsage.cacheWriteTokens =
+                (this._cumUsage.cacheWriteTokens ?? 0) + delta.cacheWriteTokens;
+        }
+        if (delta.estimatedCostUsd !== undefined) {
+            this._cumUsage.estimatedCostUsd =
+                (this._cumUsage.estimatedCostUsd ?? 0) + delta.estimatedCostUsd;
+        }
+    }
+    /** Tear down the current turn's subscription and reset status to ready. */
+    _endTurn() {
+        if (!this._currentTurn)
+            return;
+        try {
+            this._currentTurn.unsubscribe();
+        }
+        catch {
+            /* unsubscribe is best-effort */
+        }
+        this._currentTurn = null;
+        if (this._status === 'busy')
+            this._status = 'ready';
+    }
+    /** Map accumulator stopReason string to PromptResult stopReason union. */
+    _mapStopReason(s) {
+        switch (s) {
+            case 'end_turn':
+                return 'end_turn';
+            case 'cancelled':
+                return 'cancelled';
+            case 'max_tokens':
+                return 'max_tokens';
+            default:
+                return 'error';
+        }
+    }
+    /** Convert pre-parsed AccumulatorEvent back to a raw-SDK-shape SessionUpdate.
+     *  prompt-handle.ts uses raw SDK shape so consumers see ACP-native fields.
+     *  Returns null if the event has no SessionUpdate analogue (e.g. complete). */
+    _accumulatorToSessionUpdate(event) {
+        switch (event.type) {
+            case 'text':
+                return {
+                    sessionUpdate: 'agent_message_chunk',
+                    content: { type: 'text', text: event.text },
+                };
+            case 'tool_use':
+                return {
+                    sessionUpdate: 'tool_call',
+                    toolCallId: event.id,
+                    title: event.title,
+                    kind: event.kind,
+                    status: event.status,
+                };
+            case 'tool_update':
+                return {
+                    sessionUpdate: 'tool_call_update',
+                    toolCallId: event.id,
+                    status: event.status,
+                };
+            case 'usage':
+                return {
+                    sessionUpdate: 'usage_update',
+                    used: event.used,
+                    size: event.size,
+                };
+            case 'complete':
+                return null;
+        }
+    }
+    /** Run a hook callback and swallow any throw so a misbehaving hook never
+     *  poisons the lifecycle contract. Hook errors get logged. */
+    _safeFire(name, fn) {
+        try {
+            fn();
+        }
+        catch (e) {
+            this._log('warn', `Hook ${name} threw: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    _log(level, msg) {
+        if (this.options.logger) {
+            this.options.logger(level, msg);
+        }
+        else if (level !== 'info') {
+            process.stderr.write(`[claude-code-agent] ${level}: ${msg}\n`);
+        }
+    }
+    // Reserved for Step 1.4.4-1.4.8 (avoid unused-var noise during scaffolding)
+    _DEFAULTS = {
+        spawnTimeoutMs: DEFAULT_SPAWN_TIMEOUT_MS,
+        elicitationTimeoutMs: DEFAULT_ELICITATION_TIMEOUT_MS,
+        maxQueueLength: DEFAULT_MAX_QUEUE_LENGTH,
+    };
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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).
+ */
+/** All possible failure modes the agent surfaces to callers. */
+export type AgentErrorCode = 'SPAWN_FAILED' | 'SPAWN_TIMEOUT' | 'INIT_FAILED' | 'PROTOCOL_ERROR' | 'SESSION_FAILED' | 'SESSION_LOST' | 'PROMPT_TIMEOUT' | 'PROMPT_CANCELLED' | 'QUEUE_FULL' | 'BUSY' | 'ELICITATION_TIMEOUT' | 'CLAUDE_ERROR' | 'AUTH_ERROR' | 'SHIM_DIED' | 'CALL_AFTER_STOP' | 'UNSUPPORTED_ON_AGENT' | 'REPLAY_MISMATCH' | 'REPLAY_EOF';
+/** Standardized error for all agent operations. */
+export declare class AgentError extends Error {
+    readonly code: AgentErrorCode;
+    /** Original error captured at the failure site, if any. */
+    readonly cause?: Error;
+    /** Debug context: pid, sessionId, turnId, lastUpdate, etc. */
+    readonly context?: Record<string, unknown>;
+    /** Actionable fix guidance — auto-populated for AUTH_ERROR (calls checkRuntime). */
+    readonly diagnostic?: string;
+    constructor(code: AgentErrorCode, message: string, options?: {
+        cause?: Error;
+        context?: Record<string, unknown>;
+        diagnostic?: string;
+    });
+}
+/** Type-narrowing helper for callers handling errors. */
+export declare function isAgentError(err: unknown): err is AgentError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,gEAAgE;AAChE,MAAM,MAAM,cAAc,GAEtB,cAAc,GACd,eAAe,GAGf,aAAa,GACb,gBAAgB,GAGhB,gBAAgB,GAChB,cAAc,GAGd,gBAAgB,GAChB,kBAAkB,GAClB,YAAY,GACZ,MAAM,GACN,qBAAqB,GAGrB,cAAc,GACd,YAAY,GACZ,WAAW,GAGX,iBAAiB,GAGjB,sBAAsB,GAGtB,iBAAiB,GACjB,YAAY,CAAC;AAEjB,mDAAmD;AACnD,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,oFAAoF;IACpF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAG3B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,KAAK,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;CASJ;AAED,yDAAyD;AACzD,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,UAAU,CAE5D"}