@scottwalker/claude-connector 0.1.0

package/dist/executor/sdk-executor.js

@@ -0,0 +1,256 @@
+import { EventEmitter } from 'node:events';
+/**
+ * Executor implementation using the Claude Agent SDK (V2 API).
+ *
+ * ## Why this exists
+ *
+ * The CLI executor (`CliExecutor`) spawns a new `claude` process for every query.
+ * Each spawn has a cold-start cost: loading the CLI, authenticating, initializing
+ * tools and MCP servers. For interactive use this delay is noticeable (5-15s).
+ *
+ * `SdkExecutor` solves this by creating a **persistent SDK session** via
+ * `unstable_v2_createSession()`. The session stays warm — subsequent queries
+ * use `session.send()` + `session.stream()` with near-zero overhead.
+ *
+ * ## Lifecycle
+ *
+ * ```
+ * const executor = new SdkExecutor({ model: 'sonnet' })
+ * await executor.init()          // warm up (emits stage events)
+ * executor.execute(args, opts)   // fast — session already running
+ * executor.execute(args, opts)   // fast
+ * executor.close()               // cleanup
+ * ```
+ *
+ * ## Initialization events
+ *
+ * Subscribe to stage events for UI feedback:
+ * ```
+ * executor.on('init:stage', (stage, message) => {
+ *   console.log(`[${stage}] ${message}`)
+ * })
+ * executor.on('init:ready', () => console.log('Ready!'))
+ * ```
+ */
+export class SdkExecutor extends EventEmitter {
+    sdkModule = null;
+    session = null;
+    _ready = false;
+    initPromise = null;
+    sdkOptions;
+    constructor(options) {
+        super();
+        this.sdkOptions = options;
+    }
+    /** Whether the session is initialized and ready for queries. */
+    get ready() {
+        return this._ready;
+    }
+    /**
+     * Initialize the SDK session (warm up).
+     *
+     * This imports the SDK, creates a persistent session, and waits for
+     * the `system/init` message confirming Claude Code is ready.
+     *
+     * Call this once at startup. Subsequent queries will be fast.
+     * Safe to call multiple times — only initializes once.
+     */
+    async init() {
+        if (this._ready)
+            return;
+        if (this.initPromise)
+            return this.initPromise;
+        this.initPromise = this.doInit();
+        return this.initPromise;
+    }
+    async execute(args, options) {
+        await this.ensureReady();
+        const prompt = extractPrompt(args);
+        await this.session.send(prompt);
+        let resultText = '';
+        let sessionId = '';
+        let usage = { inputTokens: 0, outputTokens: 0 };
+        let cost = null;
+        let durationMs = 0;
+        let structured = null;
+        for await (const msg of this.session.stream()) {
+            const parsed = this.mapMessage(msg);
+            if (!parsed)
+                continue;
+            if (parsed.type === 'text') {
+                resultText += parsed.text;
+            }
+            else if (parsed.type === 'result') {
+                resultText = parsed.text || resultText;
+                sessionId = parsed.sessionId;
+                usage = parsed.usage;
+                cost = parsed.cost;
+                durationMs = parsed.durationMs;
+            }
+        }
+        return {
+            text: resultText,
+            sessionId,
+            usage,
+            cost,
+            durationMs,
+            messages: [],
+            structured,
+            raw: {},
+        };
+    }
+    async *stream(args, options) {
+        await this.ensureReady();
+        const prompt = extractPrompt(args);
+        await this.session.send(prompt);
+        for await (const msg of this.session.stream()) {
+            const event = this.mapMessage(msg);
+            if (event)
+                yield event;
+        }
+    }
+    abort() {
+        // SDK sessions don't have a per-query abort — close the whole session
+        this.close();
+    }
+    /**
+     * Close the SDK session and free resources.
+     */
+    close() {
+        if (this.session) {
+            this.session.close();
+            this.session = null;
+        }
+        this._ready = false;
+        this.initPromise = null;
+    }
+    // ── Private ───────────────────────────────────────────────────────
+    async doInit() {
+        try {
+            // Stage 1: Import SDK
+            this.emit('init:stage', 'importing', 'Loading Claude Agent SDK...');
+            this.sdkModule = await import('@anthropic-ai/claude-agent-sdk');
+            // Stage 2: Create session
+            this.emit('init:stage', 'creating', 'Creating persistent session...');
+            const sessionOptions = {
+                model: this.sdkOptions.model ?? 'sonnet',
+                permissionMode: this.sdkOptions.permissionMode,
+                allowedTools: this.sdkOptions.allowedTools,
+                disallowedTools: this.sdkOptions.disallowedTools,
+            };
+            if (this.sdkOptions.pathToClaudeCodeExecutable) {
+                sessionOptions.pathToClaudeCodeExecutable = this.sdkOptions.pathToClaudeCodeExecutable;
+            }
+            if (this.sdkOptions.env) {
+                sessionOptions.env = { ...process.env, ...this.sdkOptions.env };
+            }
+            this.session = this.sdkModule.unstable_v2_createSession(sessionOptions);
+            // Stage 3: Warm up — send a no-op to trigger initialization, wait for init message
+            this.emit('init:stage', 'connecting', 'Waiting for Claude Code to initialize...');
+            // The session initializes on first send+stream
+            await this.session.send('.');
+            for await (const msg of this.session.stream()) {
+                if (msg.type === 'system' && 'subtype' in msg && msg.subtype === 'init') {
+                    const sysMsg = msg;
+                    this.emit('init:stage', 'connecting', `Connected: model=${sysMsg['model']}, tools=${sysMsg['tools']?.length ?? 0}`);
+                }
+                if (msg.type === 'result') {
+                    break;
+                }
+            }
+            // Stage 4: Ready
+            this._ready = true;
+            this.emit('init:stage', 'ready', 'Session is warm and ready');
+            this.emit('init:ready');
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            this.emit('init:error', error);
+            throw error;
+        }
+    }
+    async ensureReady() {
+        if (!this._ready) {
+            await this.init();
+        }
+    }
+    /**
+     * Map an SDK message to our StreamEvent type.
+     */
+    mapMessage(msg) {
+        switch (msg.type) {
+            case 'assistant': {
+                const assistantMsg = msg;
+                const message = assistantMsg['message'];
+                const content = message?.['content'];
+                if (!content?.length)
+                    return null;
+                const lastBlock = content[content.length - 1];
+                if (lastBlock['type'] === 'text' && typeof lastBlock['text'] === 'string') {
+                    return { type: 'text', text: lastBlock['text'] };
+                }
+                if (lastBlock['type'] === 'tool_use') {
+                    return {
+                        type: 'tool_use',
+                        toolName: String(lastBlock['name'] ?? ''),
+                        toolInput: lastBlock['input'] ?? {},
+                    };
+                }
+                return null;
+            }
+            case 'result': {
+                const result = msg;
+                const usage = result['usage'];
+                return {
+                    type: 'result',
+                    text: typeof result['result'] === 'string' ? result['result'] : '',
+                    sessionId: String(result['session_id'] ?? ''),
+                    usage: {
+                        inputTokens: typeof usage?.['input_tokens'] === 'number' ? usage['input_tokens'] : 0,
+                        outputTokens: typeof usage?.['output_tokens'] === 'number' ? usage['output_tokens'] : 0,
+                    },
+                    cost: typeof result['total_cost_usd'] === 'number' ? result['total_cost_usd'] : null,
+                    durationMs: typeof result['duration_ms'] === 'number' ? result['duration_ms'] : 0,
+                };
+            }
+            default:
+                return null;
+        }
+    }
+}
+/**
+ * Extract the prompt string from a CLI args array.
+ * In our args format, the prompt is the first positional argument
+ * (after --print and --output-format flags).
+ */
+function extractPrompt(args) {
+    // The prompt is typically the argument right after '--print', '--output-format', 'json/stream-json'
+    // In buildArgs: ['--print', '--output-format', 'json', <prompt>, ...flags]
+    // Find the first arg that doesn't start with '--' and isn't a flag value
+    let skipNext = false;
+    for (const arg of args) {
+        if (skipNext) {
+            skipNext = false;
+            continue;
+        }
+        if (arg.startsWith('--')) {
+            // Flags that take a value
+            if ([
+                '--output-format', '--model', '--fallback-model', '--permission-mode',
+                '--system-prompt', '--append-system-prompt', '--max-turns', '--max-budget-usd',
+                '--add-dir', '--mcp-config', '--agents', '--json-schema', '--worktree',
+                '--resume', '--session-id', '--allowedTools', '--disallowedTools',
+            ].includes(arg)) {
+                skipNext = true;
+            }
+            continue;
+        }
+        // Skip format values
+        if (arg === 'json' || arg === 'stream-json' || arg === 'text')
+            continue;
+        // This should be the prompt
+        return arg;
+    }
+    return '';
+}
+//# sourceMappingURL=sdk-executor.js.map

package/dist/executor/sdk-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-executor.js","sourceRoot":"","sources":["../../src/executor/sdk-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAgC3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,OAAO,WAAY,SAAQ,YAA+B;IACtD,SAAS,GAAqB,IAAI,CAAC;IACnC,OAAO,GAAsB,IAAI,CAAC;IAClC,MAAM,GAAG,KAAK,CAAC;IACf,WAAW,GAAyB,IAAI,CAAC;IAChC,UAAU,CAAqB;IAEhD,YAAY,OAA2B;QACrC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC;IAC5B,CAAC;IAED,gEAAgE;IAChE,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC,WAAW,CAAC;QAE9C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAuB,EAAE,OAAuB;QAC5D,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAEzB,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,IAAI,CAAC,OAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEjC,IAAI,UAAU,GAAG,EAAE,CAAC;QACpB,IAAI,SAAS,GAAG,EAAE,CAAC;QACnB,IAAI,KAAK,GAAe,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;QAC5D,IAAI,IAAI,GAAkB,IAAI,CAAC;QAC/B,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,UAAU,GAAY,IAAI,CAAC;QAE/B,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,IAAI,CAAC,OAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YACpC,IAAI,CAAC,MAAM;gBAAE,SAAS;YAEtB,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC3B,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC;YAC5B,CAAC;iBAAM,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACpC,UAAU,GAAG,MAAM,CAAC,IAAI,IAAI,UAAU,CAAC;gBACvC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;gBAC7B,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;gBACrB,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;gBACnB,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;YACjC,CAAC;QACH,CAAC;QAED,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,SAAS;YACT,KAAK;YACL,IAAI;YACJ,UAAU;YACV,QAAQ,EAAE,EAAE;YACZ,UAAU;YACV,GAAG,EAAE,EAAE;SACR,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,CAAC,MAAM,CAAC,IAAuB,EAAE,OAAuB;QAC5D,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAEzB,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,IAAI,CAAC,OAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEjC,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,IAAI,CAAC,OAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YACnC,IAAI,KAAK;gBAAE,MAAM,KAAK,CAAC;QACzB,CAAC;IACH,CAAC;IAED,KAAK;QACH,sEAAsE;QACtE,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,qEAAqE;IAE7D,KAAK,CAAC,MAAM;QAClB,IAAI,CAAC;YACH,sBAAsB;YACtB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,EAAE,6BAA6B,CAAC,CAAC;YACpE,IAAI,CAAC,SAAS,GAAG,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAC;YAEhE,0BAA0B;YAC1B,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,EAAE,gCAAgC,CAAC,CAAC;YACtE,MAAM,cAAc,GAAsB;gBACxC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI,QAAQ;gBACxC,cAAc,EAAE,IAAI,CAAC,UAAU,CAAC,cAAqD;gBACrF,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,YAAoC;gBAClE,eAAe,EAAE,IAAI,CAAC,UAAU,CAAC,eAAuC;aACzE,CAAC;YAEF,IAAI,IAAI,CAAC,UAAU,CAAC,0BAA0B,EAAE,CAAC;gBAC/C,cAAc,CAAC,0BAA0B,GAAG,IAAI,CAAC,UAAU,CAAC,0BAA0B,CAAC;YACzF,CAAC;YAED,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;gBACxB,cAAc,CAAC,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,EAAwC,CAAC;YACxG,CAAC;YAED,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,yBAAyB,CAAC,cAAc,CAAC,CAAC;YAExE,mFAAmF;YACnF,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,EAAE,0CAA0C,CAAC,CAAC;YAClF,+CAA+C;YAC/C,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAE7B,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC9C,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,SAAS,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;oBACxE,MAAM,MAAM,GAAG,GAA8B,CAAC;oBAC9C,IAAI,CAAC,IAAI,CACP,YAAY,EACZ,YAAY,EACZ,oBAAoB,MAAM,CAAC,OAAO,CAAC,WAAY,MAAM,CAAC,OAAO,CAA0B,EAAE,MAAM,IAAI,CAAC,EAAE,CACvG,CAAC;gBACJ,CAAC;gBACD,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC1B,MAAM;gBACR,CAAC;YACH,CAAC;YAED,iBAAiB;YACjB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,EAAE,2BAA2B,CAAC,CAAC;YAC9D,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC1B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAClE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YAC/B,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,WAAW;QACvB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,GAAe;QAChC,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;YACjB,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,MAAM,YAAY,GAAG,GAA8B,CAAC;gBACpD,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,CAAwC,CAAC;gBAC/E,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC,SAAS,CAA+C,CAAC;gBACnF,IAAI,CAAC,OAAO,EAAE,MAAM;oBAAE,OAAO,IAAI,CAAC;gBAElC,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;gBAC/C,IAAI,SAAS,CAAC,MAAM,CAAC,KAAK,MAAM,IAAI,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;oBAC1E,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;gBACnD,CAAC;gBACD,IAAI,SAAS,CAAC,MAAM,CAAC,KAAK,UAAU,EAAE,CAAC;oBACrC,OAAO;wBACL,IAAI,EAAE,UAAU;wBAChB,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;wBACzC,SAAS,EAAG,SAAS,CAAC,OAAO,CAA6B,IAAI,EAAE;qBACjE,CAAC;gBACJ,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;YAED,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,MAAM,GAAG,GAA8B,CAAC;gBAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAwC,CAAC;gBACrE,OAAO;oBACL,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;oBAClE,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;oBAC7C,KAAK,EAAE;wBACL,WAAW,EAAE,OAAO,KAAK,EAAE,CAAC,cAAc,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;wBACpF,YAAY,EAAE,OAAO,KAAK,EAAE,CAAC,eAAe,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;qBACxF;oBACD,IAAI,EAAE,OAAO,MAAM,CAAC,gBAAgB,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI;oBACpF,UAAU,EAAE,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;iBAClF,CAAC;YACJ,CAAC;YAED;gBACE,OAAO,IAAI,CAAC;QAChB,CAAC;IACH,CAAC;CACF;AAyBD;;;;GAIG;AACH,SAAS,aAAa,CAAC,IAAuB;IAC5C,oGAAoG;IACpG,2EAA2E;IAC3E,yEAAyE;IACzE,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,GAAG,KAAK,CAAC;YACjB,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,0BAA0B;YAC1B,IAAI;gBACF,iBAAiB,EAAE,SAAS,EAAE,kBAAkB,EAAE,mBAAmB;gBACrE,iBAAiB,EAAE,wBAAwB,EAAE,aAAa,EAAE,kBAAkB;gBAC9E,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY;gBACtE,UAAU,EAAE,cAAc,EAAE,gBAAgB,EAAE,mBAAmB;aAClE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAChB,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;YACD,SAAS;QACX,CAAC;QACD,qBAAqB;QACrB,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,aAAa,IAAI,GAAG,KAAK,MAAM;YAAE,SAAS;QACxE,4BAA4B;QAC5B,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * # claude-connector
+ *
+ * Programmatic Node.js interface for Claude Code CLI.
+ *
+ * ## Quick start
+ *
+ * ```ts
+ * import { Claude } from 'claude-connector'
+ *
+ * const claude = new Claude({ model: 'sonnet' })
+ * const result = await claude.query('Find bugs in auth.ts')
+ * console.log(result.text)
+ * ```
+ *
+ * ## Architecture
+ *
+ * ```
+ * ┌─────────┐     ┌─────────────┐     ┌────────────┐     ┌─────────────┐
+ * │  Claude  │────>│ ArgsBuilder │────>│  IExecutor  │────>│  CLI Process │
+ * │ (facade) │     │ (options→   │     │ (abstract)  │     │  (claude -p) │
+ * │          │     │  CLI args)  │     │             │     │              │
+ * └─────────┘     └─────────────┘     └────────────┘     └─────────────┘
+ *      │                                    ▲
+ *      │                                    │
+ *      ▼                              ┌─────┴──────┐
+ * ┌─────────┐                         │CliExecutor  │  (default implementation)
+ * │ Session │                         │ SdkExecutor │  (future)
+ * │ Scheduler│                        │ HttpExecutor│  (future)
+ * └─────────┘                         └────────────┘
+ * ```
+ *
+ * @module
+ */
+export { Claude } from './client/claude.js';
+export { Session } from './client/session.js';
+export type { IExecutor, ExecuteOptions } from './executor/interface.js';
+export { CliExecutor } from './executor/cli-executor.js';
+export { SdkExecutor } from './executor/sdk-executor.js';
+export type { SdkExecutorOptions, SdkExecutorEvents, InitStage } from './executor/sdk-executor.js';
+export { Scheduler, ScheduledJob } from './scheduler/scheduler.js';
+export type { ScheduledJobEvents } from './scheduler/scheduler.js';
+export { buildArgs, mergeOptions, resolveEnv } from './builder/args-builder.js';
+export type { ResolvedOptions } from './builder/args-builder.js';
+export { parseJsonResult } from './parser/json-parser.js';
+export { parseStreamLine } from './parser/stream-parser.js';
+export { ClaudeConnectorError, CliNotFoundError, CliExecutionError, CliTimeoutError, ParseError, ValidationError, } from './errors/errors.js';
+export type { ClientOptions, QueryOptions, PermissionMode, EffortLevel, McpServerConfig, AgentConfig, HookEntry, HookMatcher, HooksConfig, QueryResult, StreamEvent, StreamTextEvent, StreamToolUseEvent, StreamResultEvent, StreamErrorEvent, StreamSystemEvent, TokenUsage, Message, ContentBlock, TextBlock, ToolUseBlock, ToolResultBlock, SessionOptions, SessionInfo, } from './types/index.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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAG9C,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAGnG,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACnE,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAGnE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAChF,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGjE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAG5D,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,aAAa,EACb,YAAY,EACZ,cAAc,EACd,WAAW,EACX,eAAe,EACf,WAAW,EACX,SAAS,EACT,WAAW,EACX,WAAW,EACX,WAAW,EACX,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,OAAO,EACP,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,eAAe,EACf,cAAc,EACd,WAAW,GACZ,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,49 @@
+/**
+ * # claude-connector
+ *
+ * Programmatic Node.js interface for Claude Code CLI.
+ *
+ * ## Quick start
+ *
+ * ```ts
+ * import { Claude } from 'claude-connector'
+ *
+ * const claude = new Claude({ model: 'sonnet' })
+ * const result = await claude.query('Find bugs in auth.ts')
+ * console.log(result.text)
+ * ```
+ *
+ * ## Architecture
+ *
+ * ```
+ * ┌─────────┐     ┌─────────────┐     ┌────────────┐     ┌─────────────┐
+ * │  Claude  │────>│ ArgsBuilder │────>│  IExecutor  │────>│  CLI Process │
+ * │ (facade) │     │ (options→   │     │ (abstract)  │     │  (claude -p) │
+ * │          │     │  CLI args)  │     │             │     │              │
+ * └─────────┘     └─────────────┘     └────────────┘     └─────────────┘
+ *      │                                    ▲
+ *      │                                    │
+ *      ▼                              ┌─────┴──────┐
+ * ┌─────────┐                         │CliExecutor  │  (default implementation)
+ * │ Session │                         │ SdkExecutor │  (future)
+ * │ Scheduler│                        │ HttpExecutor│  (future)
+ * └─────────┘                         └────────────┘
+ * ```
+ *
+ * @module
+ */
+// ── Main client ───────────────────────────────────────────────────
+export { Claude } from './client/claude.js';
+export { Session } from './client/session.js';
+export { CliExecutor } from './executor/cli-executor.js';
+export { SdkExecutor } from './executor/sdk-executor.js';
+// ── Scheduler ─────────────────────────────────────────────────────
+export { Scheduler, ScheduledJob } from './scheduler/scheduler.js';
+// ── Builder ───────────────────────────────────────────────────────
+export { buildArgs, mergeOptions, resolveEnv } from './builder/args-builder.js';
+// ── Parsers ───────────────────────────────────────────────────────
+export { parseJsonResult } from './parser/json-parser.js';
+export { parseStreamLine } from './parser/stream-parser.js';
+// ── Errors ────────────────────────────────────────────────────────
+export { ClaudeConnectorError, CliNotFoundError, CliExecutionError, CliTimeoutError, ParseError, ValidationError, } from './errors/errors.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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,qEAAqE;AACrE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAI9C,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAGzD,qEAAqE;AACrE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGnE,qEAAqE;AACrE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAGhF,qEAAqE;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,qEAAqE;AACrE,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,eAAe,GAChB,MAAM,oBAAoB,CAAC"}

package/dist/parser/index.d.ts

@@ -0,0 +1,3 @@
+export { parseJsonResult } from './json-parser.js';
+export { parseStreamLine } from './stream-parser.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/parser/index.js

@@ -0,0 +1,3 @@
+export { parseJsonResult } from './json-parser.js';
+export { parseStreamLine } from './stream-parser.js';
+//# sourceMappingURL=index.js.map

package/dist/parser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/parser/json-parser.d.ts

@@ -0,0 +1,22 @@
+import type { QueryResult } from '../types/index.js';
+/**
+ * Parses the JSON output from `claude -p --output-format json`.
+ *
+ * ## Expected CLI output structure
+ *
+ * ```json
+ * {
+ *   "session_id": "uuid",
+ *   "result": "text response",
+ *   "messages": [...],
+ *   "usage": { "input_tokens": N, "output_tokens": N },
+ *   "duration_ms": N,
+ *   "total_cost_usd": N | null
+ * }
+ * ```
+ *
+ * The parser is intentionally lenient — it extracts known fields and passes
+ * the rest through as `raw`. This way new CLI fields don't break the parser.
+ */
+export declare function parseJsonResult(stdout: string): QueryResult;
+//# sourceMappingURL=json-parser.d.ts.map

package/dist/parser/json-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-parser.d.ts","sourceRoot":"","sources":["../../src/parser/json-parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAuB,MAAM,mBAAmB,CAAC;AAE1E;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CA0B3D"}

package/dist/parser/json-parser.js

@@ -0,0 +1,87 @@
+import { ParseError } from '../errors/errors.js';
+/**
+ * Parses the JSON output from `claude -p --output-format json`.
+ *
+ * ## Expected CLI output structure
+ *
+ * ```json
+ * {
+ *   "session_id": "uuid",
+ *   "result": "text response",
+ *   "messages": [...],
+ *   "usage": { "input_tokens": N, "output_tokens": N },
+ *   "duration_ms": N,
+ *   "total_cost_usd": N | null
+ * }
+ * ```
+ *
+ * The parser is intentionally lenient — it extracts known fields and passes
+ * the rest through as `raw`. This way new CLI fields don't break the parser.
+ */
+export function parseJsonResult(stdout) {
+    const trimmed = stdout.trim();
+    if (!trimmed) {
+        throw new ParseError('Empty output from CLI', stdout);
+    }
+    let json;
+    try {
+        json = JSON.parse(trimmed);
+    }
+    catch {
+        throw new ParseError(`Failed to parse CLI JSON output: ${trimmed.slice(0, 200)}`, stdout);
+    }
+    const usage = parseUsage(json['usage']);
+    const messages = parseMessages(json['messages']);
+    return {
+        text: typeof json['result'] === 'string' ? json['result'] : extractText(json),
+        sessionId: String(json['session_id'] ?? ''),
+        usage,
+        cost: typeof json['total_cost_usd'] === 'number' ? json['total_cost_usd'] : null,
+        durationMs: typeof json['duration_ms'] === 'number' ? json['duration_ms'] : 0,
+        messages,
+        structured: json['structured_output'] ?? null,
+        raw: json,
+    };
+}
+function parseUsage(raw) {
+    if (raw && typeof raw === 'object') {
+        const obj = raw;
+        return {
+            inputTokens: typeof obj['input_tokens'] === 'number' ? obj['input_tokens'] : 0,
+            outputTokens: typeof obj['output_tokens'] === 'number' ? obj['output_tokens'] : 0,
+        };
+    }
+    return { inputTokens: 0, outputTokens: 0 };
+}
+function parseMessages(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    return raw.map((msg) => ({
+        role: msg['role'],
+        content: typeof msg['content'] === 'string' ? msg['content'] : msg['content'],
+    }));
+}
+/**
+ * Fallback text extraction when 'result' field is missing.
+ * Looks for the last assistant message content.
+ */
+function extractText(json) {
+    const messages = json['messages'];
+    if (!Array.isArray(messages))
+        return '';
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const msg = messages[i];
+        if (msg['role'] === 'assistant') {
+            if (typeof msg['content'] === 'string')
+                return msg['content'];
+            if (Array.isArray(msg['content'])) {
+                const textBlocks = msg['content']
+                    .filter((b) => b['type'] === 'text')
+                    .map((b) => b['text']);
+                return textBlocks.join('');
+            }
+        }
+    }
+    return '';
+}
+//# sourceMappingURL=json-parser.js.map

package/dist/parser/json-parser.js.map

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

package/dist/parser/stream-parser.d.ts

@@ -0,0 +1,21 @@
+import type { StreamEvent } from '../types/index.js';
+/**
+ * Parses a single line of NDJSON from `claude -p --output-format stream-json`.
+ *
+ * ## Stream format
+ *
+ * Each line is a self-contained JSON object. The structure varies:
+ *
+ * ```jsonl
+ * {"type":"assistant","message":{"role":"assistant","content":[{"type":"text","text":"..."}]}}
+ * {"type":"assistant","message":{"role":"assistant","content":[{"type":"tool_use","name":"Read","input":{...}}]}}
+ * {"type":"result","session_id":"...","usage":{...},"duration_ms":...}
+ * ```
+ *
+ * The parser maps these into the typed {@link StreamEvent} union.
+ * Unknown event types are forwarded as `system` events for extensibility.
+ *
+ * @returns Parsed event, or `null` if the line should be skipped.
+ */
+export declare function parseStreamLine(line: string): StreamEvent | null;
+//# sourceMappingURL=stream-parser.d.ts.map

package/dist/parser/stream-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-parser.d.ts","sourceRoot":"","sources":["../../src/parser/stream-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAiChE"}

package/dist/parser/stream-parser.js

@@ -0,0 +1,84 @@
+/**
+ * Parses a single line of NDJSON from `claude -p --output-format stream-json`.
+ *
+ * ## Stream format
+ *
+ * Each line is a self-contained JSON object. The structure varies:
+ *
+ * ```jsonl
+ * {"type":"assistant","message":{"role":"assistant","content":[{"type":"text","text":"..."}]}}
+ * {"type":"assistant","message":{"role":"assistant","content":[{"type":"tool_use","name":"Read","input":{...}}]}}
+ * {"type":"result","session_id":"...","usage":{...},"duration_ms":...}
+ * ```
+ *
+ * The parser maps these into the typed {@link StreamEvent} union.
+ * Unknown event types are forwarded as `system` events for extensibility.
+ *
+ * @returns Parsed event, or `null` if the line should be skipped.
+ */
+export function parseStreamLine(line) {
+    let json;
+    try {
+        json = JSON.parse(line);
+    }
+    catch {
+        // Malformed line — skip gracefully
+        return null;
+    }
+    const type = json['type'];
+    if (type === 'result') {
+        return parseResultEvent(json);
+    }
+    if (type === 'assistant') {
+        return parseAssistantEvent(json);
+    }
+    if (type === 'error') {
+        return {
+            type: 'error',
+            message: String(json['message'] ?? json['error'] ?? 'Unknown error'),
+            code: typeof json['code'] === 'string' ? json['code'] : undefined,
+        };
+    }
+    // Forward unknown types as system events
+    return {
+        type: 'system',
+        subtype: String(type ?? 'unknown'),
+        data: json,
+    };
+}
+function parseResultEvent(json) {
+    const usage = json['usage'];
+    return {
+        type: 'result',
+        text: typeof json['result'] === 'string' ? json['result'] : '',
+        sessionId: String(json['session_id'] ?? ''),
+        usage: {
+            inputTokens: typeof usage?.['input_tokens'] === 'number' ? usage['input_tokens'] : 0,
+            outputTokens: typeof usage?.['output_tokens'] === 'number' ? usage['output_tokens'] : 0,
+        },
+        cost: typeof json['total_cost_usd'] === 'number' ? json['total_cost_usd'] : null,
+        durationMs: typeof json['duration_ms'] === 'number' ? json['duration_ms'] : 0,
+    };
+}
+function parseAssistantEvent(json) {
+    const message = json['message'];
+    if (!message)
+        return null;
+    const content = message['content'];
+    if (!Array.isArray(content) || content.length === 0)
+        return null;
+    // Process the last content block (most relevant for streaming)
+    const block = content[content.length - 1];
+    if (block['type'] === 'text' && typeof block['text'] === 'string') {
+        return { type: 'text', text: block['text'] };
+    }
+    if (block['type'] === 'tool_use') {
+        return {
+            type: 'tool_use',
+            toolName: String(block['name'] ?? ''),
+            toolInput: block['input'] ?? {},
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=stream-parser.js.map

package/dist/parser/stream-parser.js.map

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

package/dist/scheduler/index.d.ts

@@ -0,0 +1,2 @@
+export { Scheduler, ScheduledJob, type ScheduledJobEvents } from './scheduler.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scheduler/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/scheduler/index.js

@@ -0,0 +1,2 @@
+export { Scheduler, ScheduledJob } from './scheduler.js';
+//# sourceMappingURL=index.js.map

package/dist/scheduler/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scheduler/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAA2B,MAAM,gBAAgB,CAAC"}