flanders 0.1.0 → 0.2.0

package/lib/Claude.js

@@ -1,387 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Claude = exports.NonRetryableError = void 0;
-const wait_1 = require("./wait");
-const RATE_LIMIT_CHUNK_MS = 60 * 60 * 1000;
-const INITIAL_TRANSIENT_WAIT_MS = 1000;
-const TRANSIENT_WAIT_CAP_MS = 60000;
-class RateLimitError extends Error {
-    constructor(retryAfterMs, inputTokens = 0, outputTokens = 0) {
-        super(`rate_limit: retry after ${retryAfterMs}ms`);
-        this.retryAfterMs = retryAfterMs;
-        this.inputTokens = inputTokens;
-        this.outputTokens = outputTokens;
-    }
-}
-class RetryableTransientError extends Error {
-    constructor(inputTokens = 0, outputTokens = 0) {
-        super("retryable transient error");
-        this.inputTokens = inputTokens;
-        this.outputTokens = outputTokens;
-    }
-}
-class NonRetryableError extends Error {
-    constructor(message) {
-        super(message);
-    }
-}
-exports.NonRetryableError = NonRetryableError;
-class Claude {
-    constructor(options, _context, _time) {
-        var _a, _b;
-        this.options = options;
-        this._context = _context;
-        this._time = _time;
-        this._disposed = false;
-        this._process = null;
-        this._waitAbort = null;
-        this._killTimer = null;
-        this._transientAttempt = 0;
-        this._sessionId = (_a = options.initialSessionId) !== null && _a !== void 0 ? _a : null;
-        this._forkFromSessionId = (_b = options.forkFromSessionId) !== null && _b !== void 0 ? _b : null;
-        this._runPromise = this._run();
-        this._runPromise.catch(() => { });
-    }
-    result() {
-        return this._runPromise;
-    }
-    sendUserMessage(content) {
-        this._writeStdin({ type: "user", message: { role: "user", content } });
-    }
-    sendControlResponse(requestId, response) {
-        this._writeStdin({
-            type: "control_response",
-            response: {
-                subtype: "success",
-                request_id: requestId,
-                response
-            }
-        });
-    }
-    endSession() {
-        var _a, _b;
-        if (this._disposed) {
-            return;
-        }
-        (_b = (_a = this._process) === null || _a === void 0 ? void 0 : _a.stdin) === null || _b === void 0 ? void 0 : _b.end();
-    }
-    _writeStdin(payload) {
-        var _a;
-        if (this._disposed) {
-            return;
-        }
-        const stdin = (_a = this._process) === null || _a === void 0 ? void 0 : _a.stdin;
-        if (!stdin) {
-            return;
-        }
-        stdin.write(JSON.stringify(payload) + "\n");
-    }
-    async _run() {
-        var _a, _b, _c, _d;
-        if (this._sessionId != null && this._forkFromSessionId != null) {
-            throw new Error("Cannot specify both forkFromSessionId and initialSessionId");
-        }
-        let totalInputTokens = 0;
-        let totalOutputTokens = 0;
-        for (;;) {
-            if (this._disposed) {
-                throw new Error("Claude disposed");
-            }
-            try {
-                const result = await this._runOnce();
-                totalInputTokens += result.inputTokens;
-                totalOutputTokens += result.outputTokens;
-                this._transientAttempt = 0;
-                return { ...result, inputTokens: totalInputTokens, outputTokens: totalOutputTokens };
-            }
-            catch (e) {
-                if (e instanceof RateLimitError) {
-                    totalInputTokens += e.inputTokens;
-                    totalOutputTokens += e.outputTokens;
-                    if (this._disposed) {
-                        throw new Error("Claude disposed");
-                    }
-                    (_b = (_a = this.options).onLongWaitStart) === null || _b === void 0 ? void 0 : _b.call(_a, "rate-limit", this._time.now() + e.retryAfterMs);
-                    try {
-                        await this._scheduleWait(e.retryAfterMs, RATE_LIMIT_CHUNK_MS);
-                    }
-                    finally {
-                        (_d = (_c = this.options).onLongWaitEnd) === null || _d === void 0 ? void 0 : _d.call(_c);
-                    }
-                    if (this._disposed) {
-                        throw new Error("Claude disposed");
-                    }
-                    continue;
-                }
-                if (e instanceof RetryableTransientError) {
-                    totalInputTokens += e.inputTokens;
-                    totalOutputTokens += e.outputTokens;
-                    this._transientAttempt++;
-                    const waitMs = Math.min(TRANSIENT_WAIT_CAP_MS, INITIAL_TRANSIENT_WAIT_MS * 2 ** (this._transientAttempt - 1));
-                    await this._scheduleWait(waitMs, waitMs);
-                    if (this._disposed) {
-                        throw new Error("Claude disposed");
-                    }
-                    continue;
-                }
-                throw e;
-            }
-        }
-    }
-    _runOnce() {
-        return new Promise((resolve, reject) => {
-            var _a;
-            if (this._disposed) {
-                return reject(new Error("Claude disposed"));
-            }
-            const args = [];
-            if (this._sessionId) {
-                args.push("--resume", this._sessionId);
-            }
-            else if (this._forkFromSessionId) {
-                args.push("--resume", this._forkFromSessionId, "--fork-session");
-                this._forkFromSessionId = null;
-            }
-            args.push("--model=claude-opus-4-6", "--effort=xhigh", "--input-format=stream-json", "--output-format=stream-json", "--include-partial-messages", "--permission-prompt-tool=stdio", "--verbose", "-p");
-            const spawnOptions = {
-                stdio: "pipe",
-                ...(this.options.cwd ? { cwd: this.options.cwd } : null)
-            };
-            const proc = this._context.spawn("claude", args, spawnOptions);
-            this._process = proc;
-            const initialMessage = {
-                type: "user",
-                message: { role: "user", content: this.options.prompt }
-            };
-            (_a = proc.stdin) === null || _a === void 0 ? void 0 : _a.write(JSON.stringify(initialMessage) + "\n");
-            const collected = {
-                text: "",
-                session: null,
-                rateLimit: null,
-                isRetryableError: false,
-                nonRetryableReason: null,
-                inputTokens: 0,
-                outputTokens: 0
-            };
-            this._attachStreamParser(proc, collected);
-            let settled = false;
-            const settle = (outcome) => {
-                if (settled) {
-                    return;
-                }
-                settled = true;
-                this._process = null;
-                if (outcome.ok) {
-                    resolve(outcome.value);
-                }
-                else {
-                    reject(outcome.error);
-                }
-            };
-            proc.on("error", e => {
-                settle({ ok: false, error: e instanceof Error ? e : new Error(String(e)) });
-            });
-            proc.on("exit", code => {
-                if (collected.session) {
-                    this._sessionId = collected.session;
-                }
-                if (this._disposed) {
-                    settle({ ok: false, error: new Error("Claude disposed") });
-                    return;
-                }
-                if (collected.rateLimit) {
-                    settle({ ok: false, error: new RateLimitError(collected.rateLimit.retryAfterMs, collected.inputTokens, collected.outputTokens) });
-                    return;
-                }
-                if (collected.isRetryableError) {
-                    settle({ ok: false, error: new RetryableTransientError(collected.inputTokens, collected.outputTokens) });
-                    return;
-                }
-                if (collected.nonRetryableReason) {
-                    settle({ ok: false, error: new NonRetryableError(collected.nonRetryableReason) });
-                    return;
-                }
-                if (code === 0 || code === null) {
-                    settle({ ok: true, value: { text: collected.text, sessionId: collected.session, inputTokens: collected.inputTokens, outputTokens: collected.outputTokens } });
-                }
-                else {
-                    settle({ ok: false, error: new NonRetryableError(`Claude process exited with code ${code}`) });
-                }
-            });
-        });
-    }
-    _attachStreamParser(proc, collected) {
-        var _a, _b;
-        let buffer = "";
-        const handleLine = (line) => {
-            var _a, _b, _c, _d, _e, _f, _g, _h;
-            if (!line) {
-                return;
-            }
-            let parsed = null;
-            try {
-                parsed = JSON.parse(line);
-            }
-            catch {
-                return;
-            }
-            if (!parsed) {
-                return;
-            }
-            if (parsed.session_id && !collected.session) {
-                collected.session = parsed.session_id;
-            }
-            if (parsed.type === "rate_limit_event" && ((_a = parsed.rate_limit_info) === null || _a === void 0 ? void 0 : _a.status) === "rejected") {
-                const info = parsed.rate_limit_info;
-                const target = info.isUsingOverage && typeof info.overageResetsAt === "number"
-                    ? info.overageResetsAt
-                    : info.resetsAt;
-                if (typeof target === "number") {
-                    const retryAfterMs = Math.max(0, target * 1000 - this._time.now());
-                    collected.rateLimit = new RateLimitError(retryAfterMs);
-                }
-            }
-            else if (parsed.type === "result") {
-                if (typeof parsed.result === "string") {
-                    collected.text = parsed.result;
-                }
-                const u = parsed.usage;
-                if (u) {
-                    collected.inputTokens = ((_b = u.input_tokens) !== null && _b !== void 0 ? _b : 0) + ((_c = u.cache_creation_input_tokens) !== null && _c !== void 0 ? _c : 0) + ((_d = u.cache_read_input_tokens) !== null && _d !== void 0 ? _d : 0);
-                    collected.outputTokens = (_e = u.output_tokens) !== null && _e !== void 0 ? _e : 0;
-                }
-                if (parsed.is_error) {
-                    const subtype = parsed.subtype;
-                    const status = parsed.api_error_status;
-                    if (subtype === "error_max_turns" || subtype === "error_max_budget_usd" || subtype === "error_max_structured_output_retries") {
-                        collected.nonRetryableReason = subtype;
-                    }
-                    else if ((typeof status === "number" && (status >= 500 || status === 408 || status === 425)) ||
-                        status === null ||
-                        subtype === "error_during_execution") {
-                        collected.isRetryableError = true;
-                    }
-                    else {
-                        collected.nonRetryableReason = typeof status === "number" ? `HTTP ${status}` : "unknown error";
-                    }
-                }
-            }
-            else if (parsed.type === "assistant" && ((_f = parsed.message) === null || _f === void 0 ? void 0 : _f.content)) {
-                let text = "";
-                for (const block of parsed.message.content) {
-                    if (block.type === "text" && typeof block.text === "string") {
-                        text += block.text;
-                    }
-                }
-                if (text) {
-                    collected.text = text;
-                }
-            }
-            else if (parsed.type === "control_request" || parsed.type === "sdk_control_request") {
-                this._handleControlRequest(parsed);
-            }
-            try {
-                (_h = (_g = this.options).onEvent) === null || _h === void 0 ? void 0 : _h.call(_g, parsed);
-            }
-            catch (e) {
-                if (this.options.onStderr) {
-                    this.options.onStderr(`onEvent handler threw: ${String(e)}\n`);
-                }
-            }
-        };
-        (_a = proc.stdout) === null || _a === void 0 ? void 0 : _a.on("data", chunk => {
-            buffer += String(chunk);
-            for (;;) {
-                const nl = buffer.indexOf("\n");
-                if (nl < 0) {
-                    break;
-                }
-                const line = buffer.slice(0, nl).replace(/\r$/, "");
-                buffer = buffer.slice(nl + 1);
-                handleLine(line);
-            }
-        });
-        (_b = proc.stderr) === null || _b === void 0 ? void 0 : _b.on("data", chunk => {
-            if (this.options.onStderr) {
-                this.options.onStderr(String(chunk));
-            }
-        });
-    }
-    _scheduleWait(totalMs, chunkMs) {
-        const abort = new AbortController();
-        this._waitAbort = abort;
-        return (0, wait_1.wait)(totalMs, chunkMs, this._time, abort.signal).then(() => {
-            if (this._waitAbort === abort) {
-                this._waitAbort = null;
-            }
-        });
-    }
-    _handleControlRequest(parsed) {
-        var _a, _b;
-        const req = parsed.request;
-        if (!req) {
-            return;
-        }
-        if (req.subtype !== "can_use_tool" && req.subtype !== "permission") {
-            return;
-        }
-        const requestId = (_a = parsed.request_id) !== null && _a !== void 0 ? _a : req.request_id;
-        if (typeof requestId !== "string" || requestId.length === 0) {
-            return;
-        }
-        const toolName = req.tool_name;
-        if (typeof toolName !== "string") {
-            return;
-        }
-        const toolInput = (_b = req.input) !== null && _b !== void 0 ? _b : req.tool_input;
-        const handler = this.options.onPermissionRequest;
-        const responsePromise = handler
-            ? handler({ request_id: requestId, tool_name: toolName, tool_input: toolInput })
-            : Promise.resolve({
-                behavior: "allow",
-                updatedInput: typeof toolInput === "object" && toolInput !== null ? toolInput : {}
-            });
-        responsePromise.then(response => {
-            this.sendControlResponse(requestId, response);
-        }, err => {
-            this.sendControlResponse(requestId, {
-                behavior: "deny",
-                message: err instanceof Error ? err.message : String(err)
-            });
-        });
-    }
-    async dispose() {
-        var _a, _b, _c;
-        if (this._disposed) {
-            try {
-                await this._runPromise;
-            }
-            catch {
-            }
-            return;
-        }
-        this._disposed = true;
-        (_a = this._waitAbort) === null || _a === void 0 ? void 0 : _a.abort();
-        const proc = this._process;
-        if (proc) {
-            const exitWaiter = new Promise(resolve => {
-                proc.on("exit", () => resolve());
-            });
-            (_b = proc.stdin) === null || _b === void 0 ? void 0 : _b.end();
-            proc.kill("SIGINT");
-            this._killTimer = this._time.setTimeout(() => {
-                this._killTimer = null;
-                proc.kill("SIGTERM");
-            }, 5000);
-            await exitWaiter;
-            (_c = this._killTimer) === null || _c === void 0 ? void 0 : _c.cancel();
-            this._killTimer = null;
-        }
-        try {
-            await this._runPromise;
-        }
-        catch {
-        }
-    }
-}
-exports.Claude = Claude;

package/lib/ClaudeSession.d.ts

@@ -1,34 +0,0 @@
-import { ClaudeResult } from "./Claude";
-import type { AskContext, ClaudeContext, OutputContext, TimeContext } from "./contexts";
-export type ClaudeSessionOptions = Readonly<{
-    prompt: string;
-    cwd?: string;
-    initialSessionId?: string | null;
-    forkFromSessionId?: string | null;
-    onLongWaitStart?(kind: "rate-limit", endTimeMs: number): void;
-    onLongWaitEnd?(): void;
-}>;
-export type ClaudeSessionContexts = Readonly<{
-    claude: ClaudeContext;
-    time: TimeContext;
-    output: OutputContext;
-    ask: AskContext;
-}>;
-export declare class ClaudeSession {
-    private _options;
-    private _contexts;
-    private _disposed;
-    private _claude;
-    private _printedAnyOutputThisRun;
-    private _seenTextThisMessage;
-    private _textOpen;
-    constructor(_options: ClaudeSessionOptions, _contexts: ClaudeSessionContexts);
-    run(): Promise<ClaudeResult>;
-    dispose(): Promise<void>;
-    private _resetState;
-    private _onPermissionRequest;
-    private _handleAskUserQuestion;
-    private _onEvent;
-    private _emitText;
-    private _closeOpenTextLine;
-}