@astrosheep/keiyaku 2.9.13 → 4.0.1

package/build/src/akuma/providers/claude/index.d.ts

@@ -0,0 +1,46 @@
+import type { Options, Query, SDKUserMessage } from "@anthropic-ai/claude-agent-sdk";
+import { type ProviderAdapter, type ProviderOptions, type Session } from "../../provider.js";
+import type { ResumeCoordinate } from "../../provider.js";
+export { CLAUDE_MESSAGE_DISPOSITIONS, CLAUDE_SYSTEM_DISPOSITIONS } from "./events.js";
+type ClaudeExecution = Readonly<{
+    executable?: string;
+    env?: Readonly<Record<string, string>>;
+}>;
+export type ClaudeSdk = Readonly<{
+    query(input: Readonly<{
+        prompt: string | AsyncIterable<SDKUserMessage>;
+        options?: Options;
+    }>): Query;
+    forkSession?(sessionId: string, options: Readonly<{
+        dir: string;
+        upToMessageId: string;
+    }>): Promise<Readonly<{
+        sessionId: string;
+    }>>;
+}>;
+export declare function createClaudeProvider(load: () => Promise<ClaudeSdk>, execution?: ClaudeExecution): ProviderAdapter;
+export declare const claudeProvider: Readonly<{
+    confinement(input: Readonly<{
+        cwd: string;
+        options: ProviderOptions;
+    }>): import("../../index.js").Confinement;
+    admitOptions(options: ProviderOptions): import("../../provider.js").ProviderOptionAdmission;
+    fork?(input: Readonly<{
+        session: ResumeCoordinate;
+        at: string;
+        cwd: string;
+    }>): Promise<Readonly<{
+        session: ResumeCoordinate;
+    }>>;
+    start(input: import("../../provider.js").DriveInput & Readonly<{
+        session: Readonly<{
+            kind: "fresh";
+        }>;
+    }>): Promise<Session>;
+    resume?(input: import("../../provider.js").DriveInput & Readonly<{
+        session: Readonly<{
+            kind: "resume";
+            coordinate: ResumeCoordinate;
+        }>;
+    }>): Promise<Session>;
+}>;

package/build/src/akuma/providers/claude/index.js

@@ -0,0 +1,265 @@
+import { randomUUID } from "node:crypto";
+import { AgentEventChannel, } from "../../provider.js";
+import { emitClaudeMessage, } from "./events.js";
+import { claudeUserMessage, createClaudeInput, isClaudeTurnEnded } from "./input.js";
+export { CLAUDE_MESSAGE_DISPOSITIONS, CLAUDE_SYSTEM_DISPOSITIONS } from "./events.js";
+class ReceiptChannel {
+    queued = [];
+    waiters = [];
+    ended = false;
+    emit(receipt) {
+        if (this.ended)
+            throw new Error("Claude receipt stream already ended");
+        const waiter = this.waiters.shift();
+        if (waiter === undefined)
+            this.queued.push(receipt);
+        else
+            waiter.resolve({ done: false, value: receipt });
+    }
+    end() {
+        if (this.ended)
+            return;
+        this.ended = true;
+        for (const waiter of this.waiters.splice(0))
+            waiter.resolve({ done: true, value: undefined });
+    }
+    [Symbol.asyncIterator]() {
+        return {
+            next: () => {
+                const receipt = this.queued.shift();
+                if (receipt !== undefined)
+                    return Promise.resolve({ done: false, value: receipt });
+                if (this.ended)
+                    return Promise.resolve({ done: true, value: undefined });
+                return new Promise((resolve) => this.waiters.push({ resolve }));
+            },
+        };
+    }
+}
+function admitClaudeOptions(options) {
+    if (options.network !== undefined) {
+        return { kind: "refused", diagnostic: "Claude provider does not support the Archetype network option" };
+    }
+    return { kind: "admitted", options: Object.freeze({ ...options }) };
+}
+function permissionMode(access) {
+    if (access === "read")
+        return "plan";
+    if (access === "write")
+        return "acceptEdits";
+    return "bypassPermissions";
+}
+function claudeSessionId(coordinate) {
+    if (!("sessionId" in coordinate) || coordinate.sessionId === undefined) {
+        throw new Error("Claude resume requires sessionId");
+    }
+    return coordinate.sessionId;
+}
+function claudeQueryOptions(input, execution, abortController) {
+    const access = permissionMode(input.options.access);
+    return {
+        cwd: input.cwd,
+        abortController,
+        ...(execution.executable === undefined ? {} : { pathToClaudeCodeExecutable: execution.executable }),
+        ...(execution.env === undefined ? {} : { env: { ...process.env, ...execution.env } }),
+        permissionMode: access,
+        ...(access === "bypassPermissions" ? { allowDangerouslySkipPermissions: true } : {}),
+        settingSources: ["user", "project", "local"],
+        ...(input.options.model === undefined ? {} : { model: input.options.model }),
+        ...(input.options.effort === undefined ? {} : { effort: input.options.effort }),
+        ...(input.options.systemPrompt === undefined || input.options.systemPrompt.length === 0 ? {} : {
+            systemPrompt: { type: "preset", preset: "claude_code", append: input.options.systemPrompt },
+        }),
+        ...(input.session.kind === "fresh" ? {} : { resume: claudeSessionId(input.session.coordinate) }),
+    };
+}
+async function forkClaude(load, execution, input) {
+    const sessionId = claudeSessionId(input.session);
+    if (execution.env !== undefined)
+        throw new Error("Claude fork cannot apply the frozen provider environment");
+    const sdk = await load();
+    if (sdk.forkSession === undefined)
+        throw new Error("Claude SDK does not expose forkSession");
+    const forked = await sdk.forkSession(sessionId, { dir: input.cwd, upToMessageId: input.at });
+    if (forked.sessionId.trim().length === 0)
+        throw new Error("Claude fork returned an empty child session id");
+    if (forked.sessionId === sessionId)
+        throw new Error("Claude fork reused the source session id");
+    return { session: { sessionId: forked.sessionId } };
+}
+function launchText(input) {
+    return [input.body, ...input.launchTells.map((tell) => tell.text)]
+        .filter((part) => part.length > 0).join("\n\n");
+}
+function successfulResult(message, historyId) {
+    return historyId === undefined
+        ? { kind: "failed", diagnostic: "Claude query succeeded without an assistant history id" }
+        : { kind: "answered", answer: message.subtype === "success" ? message.result : "", historyId };
+}
+function finishClaudeInput(input, terminal) {
+    if (terminal?.kind === "answered")
+        input.end();
+    else
+        input.close();
+}
+function observeClaudeQuery(context) {
+    const { query, input, events, receipts, accepted, state } = context;
+    const observation = { tools: new Map() };
+    let admit;
+    let rejectAdmission;
+    const admission = new Promise((resolve, reject) => { admit = resolve; rejectAdmission = reject; });
+    let settle;
+    const completion = new Promise((resolve) => { settle = resolve; });
+    let checkpoint = 0, ended = false;
+    const settleReceipts = () => {
+        if (ended && state.openSubmissions === 0 && accepted.every((tell) => tell.visible))
+            receipts.end();
+    };
+    const flushReceipts = () => {
+        for (let index = 0; index < accepted.length;) {
+            const tell = accepted[index];
+            if (!tell.visible || tell.afterCheckpoint >= checkpoint) {
+                index += 1;
+                continue;
+            }
+            accepted.splice(index, 1);
+            receipts.emit({ evidence: "exact", tellId: tell.id, kind: "consumed" });
+        }
+        closeWhenIdle();
+        settleReceipts();
+    };
+    const closeWhenIdle = () => {
+        if (state.openSubmissions === 0 && accepted.length === 0 && input.pending === 0)
+            input.close();
+    };
+    void (async () => {
+        let admitted = false;
+        let terminal = null;
+        let historyId;
+        try {
+            for await (const message of query) {
+                if (!admitted && "session_id" in message && typeof message.session_id === "string") {
+                    admitted = true;
+                    events.emit({ type: "session", coordinate: { sessionId: message.session_id } });
+                    admit();
+                }
+                emitClaudeMessage(message, events, observation);
+                if (message.type === "assistant" && message.parent_tool_use_id === null
+                    && typeof message.uuid === "string" && message.uuid.length > 0)
+                    historyId = message.uuid;
+                if (message.type !== "result")
+                    continue;
+                if (message.subtype === "success") {
+                    terminal = successfulResult(message, historyId);
+                    checkpoint += 1;
+                    flushReceipts();
+                    queueMicrotask(closeWhenIdle);
+                }
+                else {
+                    terminal = { kind: "failed", diagnostic: message.errors.join("; ") || message.subtype };
+                    input.close();
+                }
+            }
+            ended = true;
+            const result = terminal ?? { kind: "failed", diagnostic: "Claude query ended without a result" };
+            if (!admitted)
+                rejectAdmission(new Error(result.kind === "failed" ? result.diagnostic : "Claude query ended before session admission"));
+            settle(result);
+        }
+        catch (error) {
+            ended = true;
+            input.fail(error);
+            const failure = error instanceof Error ? error : new Error(String(error));
+            if (!admitted)
+                rejectAdmission(failure);
+            settle({ kind: "failed", diagnostic: failure.message });
+        }
+        finally {
+            finishClaudeInput(input, terminal);
+            events.end();
+            settleReceipts();
+        }
+    })();
+    return {
+        admission,
+        completion,
+        get ended() { return ended; },
+        get checkpoint() { return checkpoint; },
+        flushReceipts,
+        settleReceipts,
+    };
+}
+async function driveClaude(load, execution, drive) {
+    if (drive.session.kind === "resume")
+        claudeSessionId(drive.session.coordinate);
+    const sdk = await load();
+    const events = new AgentEventChannel();
+    const receipts = new ReceiptChannel();
+    const input = createClaudeInput();
+    const abortController = new AbortController();
+    const run = randomUUID();
+    const accepted = [];
+    let submission = 0;
+    let openSubmissions = 0;
+    const launchAcknowledged = input.push(claudeUserMessage(launchText(drive)));
+    const query = sdk.query({
+        prompt: input.iterable,
+        options: claudeQueryOptions(drive, execution, abortController),
+    });
+    const observed = observeClaudeQuery({
+        query, input, events, receipts, accepted,
+        state: { get openSubmissions() { return openSubmissions; } },
+    });
+    await Promise.all([launchAcknowledged, observed.admission]);
+    return {
+        admission: { fence: `claude:${run}:0` },
+        events,
+        receipts,
+        completion: observed.completion,
+        tell(tell) {
+            if (observed.ended || input.closed)
+                return Promise.resolve({ kind: "turn-ended" });
+            openSubmissions += 1;
+            const ordinal = ++submission;
+            return new Promise((resolve, reject) => {
+                const pending = { id: tell.id, afterCheckpoint: 0, visible: false };
+                void input.push(claudeUserMessage(tell.text), () => {
+                    pending.afterCheckpoint = observed.checkpoint;
+                    accepted.push(pending);
+                }).then(() => {
+                    openSubmissions -= 1;
+                    resolve({ kind: "accepted", fence: `claude:${run}:${ordinal}` });
+                    queueMicrotask(() => {
+                        pending.visible = true;
+                        observed.flushReceipts();
+                        observed.settleReceipts();
+                    });
+                }, (error) => {
+                    openSubmissions -= 1;
+                    if (isClaudeTurnEnded(error))
+                        resolve({ kind: "turn-ended" });
+                    else
+                        reject(error);
+                    observed.settleReceipts();
+                });
+            });
+        },
+        async abort() {
+            const error = new Error("Claude query aborted");
+            abortController.abort(error);
+            input.fail(error);
+            query.close();
+            await observed.completion;
+        },
+    };
+}
+export function createClaudeProvider(load, execution = {}) {
+    return {
+        confinement: () => ({ kind: "unconfined" }),
+        admitOptions: admitClaudeOptions,
+        fork: (input) => forkClaude(load, execution, input),
+        start: (input) => driveClaude(load, execution, input),
+        resume: (input) => driveClaude(load, execution, input),
+    };
+}
+export const claudeProvider = createClaudeProvider(async () => await import("@anthropic-ai/claude-agent-sdk"));

package/build/src/akuma/providers/claude/input.d.ts

@@ -0,0 +1,13 @@
+import type { SDKUserMessage } from "@anthropic-ai/claude-agent-sdk";
+export declare function isClaudeTurnEnded(error: unknown): boolean;
+export type ClaudeInput = Readonly<{
+    iterable: AsyncIterable<SDKUserMessage>;
+    get closed(): boolean;
+    get pending(): number;
+    push(message: SDKUserMessage, onPulled?: () => void): Promise<void>;
+    end(): void;
+    close(): void;
+    fail(error: unknown): void;
+}>;
+export declare function claudeUserMessage(text: string): SDKUserMessage;
+export declare function createClaudeInput(): ClaudeInput;

package/build/src/akuma/providers/claude/input.js

@@ -0,0 +1,109 @@
+function deferred() {
+    let resolve;
+    let reject;
+    const promise = new Promise((accept, refuse) => {
+        resolve = accept;
+        reject = refuse;
+    });
+    return { promise, resolve, reject };
+}
+function ended() {
+    return new Error("Claude input ended before the SDK acknowledged the message");
+}
+const turnEnded = Symbol("claude-turn-ended");
+class ClaudeTurnEndedError extends Error {
+    [turnEnded] = true;
+}
+function turnEndedError() {
+    return new ClaudeTurnEndedError("Claude query ended before the SDK acknowledged the message");
+}
+export function isClaudeTurnEnded(error) {
+    return typeof error === "object" && error !== null && error[turnEnded] === true;
+}
+export function claudeUserMessage(text) {
+    return {
+        type: "user",
+        message: { role: "user", content: text },
+        parent_tool_use_id: null,
+    };
+}
+export function createClaudeInput() {
+    const queue = [];
+    const waiters = [];
+    let previous;
+    let failure;
+    let closed = false;
+    const acknowledgePrevious = () => {
+        previous?.onPulled?.();
+        previous?.pulled.resolve();
+        previous = undefined;
+    };
+    const take = (entry) => {
+        previous = entry;
+        return { done: false, value: entry.message };
+    };
+    const rejectUnresolved = (error) => {
+        previous?.pulled.reject(error);
+        previous = undefined;
+        for (const entry of queue.splice(0))
+            entry.pulled.reject(error);
+    };
+    return {
+        get closed() { return closed; },
+        get pending() { return queue.length + (previous === undefined ? 0 : 1); },
+        push(message, onPulled) {
+            if (closed)
+                return Promise.reject(failure ?? ended());
+            const entry = { message, pulled: deferred(), ...(onPulled === undefined ? {} : { onPulled }) };
+            const waiter = waiters.shift();
+            if (waiter === undefined)
+                queue.push(entry);
+            else
+                waiter.resolve(take(entry));
+            return entry.pulled.promise;
+        },
+        end() {
+            if (closed)
+                return;
+            closed = true;
+            rejectUnresolved(turnEndedError());
+            for (const waiter of waiters.splice(0))
+                waiter.resolve({ done: true, value: undefined });
+        },
+        close() {
+            if (closed)
+                return;
+            closed = true;
+            const error = ended();
+            rejectUnresolved(error);
+            for (const waiter of waiters.splice(0))
+                waiter.resolve({ done: true, value: undefined });
+        },
+        fail(error) {
+            if (closed)
+                return;
+            closed = true;
+            failure = error;
+            rejectUnresolved(error);
+            for (const waiter of waiters.splice(0))
+                waiter.reject(error);
+        },
+        iterable: {
+            [Symbol.asyncIterator]() {
+                return {
+                    next() {
+                        acknowledgePrevious();
+                        const entry = queue.shift();
+                        if (entry !== undefined)
+                            return Promise.resolve(take(entry));
+                        if (failure !== undefined)
+                            return Promise.reject(failure);
+                        if (closed)
+                            return Promise.resolve({ done: true, value: undefined });
+                        return new Promise((resolve, reject) => waiters.push({ resolve, reject }));
+                    },
+                };
+            },
+        },
+    };
+}

package/build/src/akuma/providers/codex-app-server/events.d.ts

@@ -0,0 +1,110 @@
+import type { LineRpcNotification } from "../../../runtime/proc/line-rpc.js";
+import { AgentEventChannel, type ToolCall, type TurnResult } from "../../provider.js";
+export type CodexTurnState = {
+    threadId?: string;
+    turnId?: string;
+    lastAnswer?: string;
+    error?: string;
+    settled: boolean;
+    tools: Map<string, Readonly<{
+        name: string;
+        call: ToolCall;
+    }>>;
+};
+export declare const CODEX_NOTIFICATION_DISPOSITIONS: {
+    readonly "account/login/completed": "drop";
+    readonly "account/rateLimits/updated": "drop";
+    readonly "account/updated": "drop";
+    readonly "app/list/updated": "drop";
+    readonly "command/exec/outputDelta": "drop";
+    readonly configWarning: "note";
+    readonly deprecationNotice: "note";
+    readonly error: "error";
+    readonly "externalAgentConfig/import/completed": "note";
+    readonly "externalAgentConfig/import/progress": "note";
+    readonly "fs/changed": "note";
+    readonly "fuzzyFileSearch/sessionCompleted": "drop";
+    readonly "fuzzyFileSearch/sessionUpdated": "drop";
+    readonly guardianWarning: "note";
+    readonly "hook/completed": "drop";
+    readonly "hook/started": "note";
+    readonly "item/agentMessage/delta": "drop";
+    readonly "item/autoApprovalReview/completed": "note";
+    readonly "item/autoApprovalReview/started": "note";
+    readonly "item/commandExecution/outputDelta": "drop";
+    readonly "item/commandExecution/terminalInteraction": "drop";
+    readonly "item/completed": "item-completed";
+    readonly "item/fileChange/outputDelta": "drop";
+    readonly "item/fileChange/patchUpdated": "drop";
+    readonly "item/mcpToolCall/progress": "drop";
+    readonly "item/plan/delta": "drop";
+    readonly "item/reasoning/summaryPartAdded": "drop";
+    readonly "item/reasoning/summaryTextDelta": "drop";
+    readonly "item/reasoning/textDelta": "drop";
+    readonly "item/started": "item-started";
+    readonly "mcpServer/oauthLogin/completed": "drop";
+    readonly "mcpServer/startupStatus/updated": "drop";
+    readonly "model/rerouted": "note";
+    readonly "model/safetyBuffering/updated": "drop";
+    readonly "model/verification": "drop";
+    readonly "process/exited": "drop";
+    readonly "process/outputDelta": "drop";
+    readonly "rawResponse/completed": "drop";
+    readonly "rawResponseItem/completed": "drop";
+    readonly "remoteControl/status/changed": "drop";
+    readonly "serverRequest/resolved": "drop";
+    readonly "skills/changed": "drop";
+    readonly "thread/archived": "drop";
+    readonly "thread/closed": "drop";
+    readonly "thread/compacted": "drop";
+    readonly "thread/deleted": "drop";
+    readonly "thread/environment/connected": "drop";
+    readonly "thread/environment/disconnected": "drop";
+    readonly "thread/goal/cleared": "note";
+    readonly "thread/goal/updated": "note";
+    readonly "thread/name/updated": "drop";
+    readonly "thread/realtime/closed": "drop";
+    readonly "thread/realtime/error": "note";
+    readonly "thread/realtime/itemAdded": "drop";
+    readonly "thread/realtime/outputAudio/delta": "drop";
+    readonly "thread/realtime/sdp": "drop";
+    readonly "thread/realtime/started": "drop";
+    readonly "thread/realtime/transcript/delta": "drop";
+    readonly "thread/realtime/transcript/done": "drop";
+    readonly "thread/settings/updated": "drop";
+    readonly "thread/started": "drop";
+    readonly "thread/status/changed": "drop";
+    readonly "thread/tokenUsage/updated": "drop";
+    readonly "thread/unarchived": "drop";
+    readonly "turn/completed": "terminal";
+    readonly "turn/diff/updated": "drop";
+    readonly "turn/moderationMetadata": "note";
+    readonly "turn/plan/updated": "plan";
+    readonly "turn/started": "drop";
+    readonly warning: "note";
+    readonly "windows/worldWritableWarning": "note";
+    readonly "windowsSandbox/setupCompleted": "note";
+};
+export declare const CODEX_ITEM_DISPOSITIONS: {
+    readonly agentMessage: "assistant";
+    readonly collabAgentToolCall: "tool";
+    readonly commandExecution: "tool";
+    readonly contextCompaction: "drop";
+    readonly dynamicToolCall: "tool";
+    readonly enteredReviewMode: "note";
+    readonly exitedReviewMode: "note";
+    readonly fileChange: "tool";
+    readonly hookPrompt: "drop";
+    readonly imageGeneration: "tool";
+    readonly imageView: "tool";
+    readonly mcpToolCall: "tool";
+    readonly plan: "plan";
+    readonly reasoning: "thought";
+    readonly sleep: "note";
+    readonly subAgentActivity: "note";
+    readonly userMessage: "drop";
+    readonly webSearch: "tool";
+};
+export declare function codexObject(value: unknown): Readonly<Record<string, unknown>> | undefined;
+export declare function codexText(value: unknown): string | undefined;
+export declare function codexNotificationResult(notification: LineRpcNotification, state: CodexTurnState, events: AgentEventChannel): TurnResult | undefined;