@scotthuang/agent-knock-knock 0.13.17 → 0.14.0

package/dist/src/codex-native-client-interactions.js

@@ -0,0 +1,124 @@
+import { CodexNativeError } from "./codex-native-types.js";
+import { nativeId, nativeRecord, nativeInvalid, nativeInteractionId } from "./codex-native-snapshot.js";
+const methods = new Map([
+    ["item/commandExecution/requestApproval", "command_approval"],
+    ["item/fileChange/requestApproval", "file_approval"], ["item/tool/requestUserInput", "blocking_question"]
+]);
+export function parseNativeRequest(raw) {
+    const kind = methods.get(String(raw.method));
+    if (!kind)
+        return null;
+    if ((typeof raw.id !== "string" && !Number.isSafeInteger(raw.id)) || raw.id === undefined)
+        nativeInvalid("Invalid native request id");
+    const p = nativeRecord(raw.params);
+    const threadId = nativeId(p.threadId), turnId = nativeId(p.turnId), itemId = nativeId(p.itemId);
+    const questions = kind === "blocking_question" ? parseQuestions(p.questions) : [];
+    const details = approvalDetails(p, kind);
+    return { id: nativeInteractionId([threadId, turnId, itemId, raw.method, questions, details]), kind, threadId, turnId, itemId,
+        method: String(raw.method), requestId: raw.id, questions, ...details };
+}
+function approvalDetails(p, kind) {
+    const details = {};
+    for (const field of ["command", "reason", "cwd"]) {
+        if (p[field] != null && typeof p[field] !== "string")
+            nativeInvalid("Invalid native approval detail");
+        if (typeof p[field] === "string")
+            details[field] = p[field];
+    }
+    if (p.availableDecisions != null) {
+        if (!Array.isArray(p.availableDecisions))
+            nativeInvalid("Invalid native approval decisions");
+        details.availableDecisions = p.availableDecisions.filter((d) => typeof d === "string");
+    }
+    if (kind === "command_approval") {
+        details.nativeApprovalKind = p.kind == null ? "command" : nativeId(p.kind);
+        if (p.approvalId != null)
+            details.approvalId = nativeId(p.approvalId);
+        if (p.networkApprovalContext != null) {
+            const network = nativeRecord(p.networkApprovalContext);
+            details.networkApprovalContext = { host: nativeId(network.host, 4096), protocol: nativeId(network.protocol) };
+        }
+    }
+    return details;
+}
+function parseQuestions(value) {
+    if (!Array.isArray(value) || value.length < 1 || value.length > 64)
+        nativeInvalid("Invalid native blocking questions");
+    const ids = new Set();
+    return value.map(raw => {
+        const q = nativeRecord(raw);
+        const id = nativeId(q.id);
+        if (ids.has(id) || typeof q.question !== "string")
+            nativeInvalid("Invalid native question identity");
+        ids.add(id);
+        if (q.options != null && !Array.isArray(q.options))
+            nativeInvalid("Invalid native question options");
+        const options = (q.options ?? []).map(raw => {
+            const option = nativeRecord(raw);
+            if (typeof option.label !== "string")
+                nativeInvalid("Invalid native question option");
+            return option.label;
+        });
+        return { id, title: q.question, options, isOther: q.isOther === true, isSecret: q.isSecret === true };
+    });
+}
+export function nativeResponse(interaction, response) {
+    if (interaction.kind === "blocking_question" && "answers" in response) {
+        const keys = Object.keys(response.answers);
+        if (keys.length !== interaction.questions.length || interaction.questions.some(q => !Object.hasOwn(response.answers, q.id))) {
+            throw new CodexNativeError("invalid_argument", "Answer must identify every native question exactly once");
+        }
+        const answers = Object.create(null);
+        for (const q of interaction.questions) {
+            const values = response.answers[q.id];
+            if (!Array.isArray(values) || values.length < 1 || values.length > 100 || values.some(value => typeof value !== "string"
+                || !value.trim() || value.length > 16_384 || (!q.isOther && q.options.length > 0 && !q.options.includes(value)))) {
+                throw new CodexNativeError("invalid_argument", "Invalid answer for native question");
+            }
+            answers[q.id] = { answers: values };
+        }
+        return { answers };
+    }
+    if ((interaction.kind === "command_approval" || interaction.kind === "file_approval") && "decision" in response
+        && ["accept", "decline", "cancel"].includes(response.decision)) {
+        if (interaction.availableDecisions && !interaction.availableDecisions.includes(response.decision)) {
+            throw new CodexNativeError("invalid_argument", "Decision is not offered by this native approval");
+        }
+        return { decision: response.decision };
+    }
+    throw new CodexNativeError("invalid_argument", "Response does not match native interaction kind");
+}
+export function buildNativeAsyncReply(interaction, answer) {
+    if (interaction.kind !== "async_question" || interaction.questions.length !== 1 || typeof answer !== "string"
+        || !answer.trim() || answer.length > 16_384)
+        throw new CodexNativeError("invalid_argument", "Invalid native asynchronous answer");
+    const question = interaction.questions[0];
+    return `<send_user_message_question_reply>\n${JSON.stringify([{ questionItemId: question.id,
+            question: question.title, answer }])}\n</send_user_message_question_reply>`;
+}
+/** Preview comes from the same native item as the pending approval, never a nearby diff. */
+export function hydrateNativeFileApproval(interaction, turns, liveItem) {
+    if (interaction.kind !== "file_approval")
+        return interaction;
+    const turn = turns.find(t => t.id === interaction.turnId);
+    const item = turn?.items.find(i => i.id === interaction.itemId && i.type === "fileChange")
+        ?? (liveItem?.id === interaction.itemId && liveItem.type === "fileChange" ? liveItem : undefined);
+    if (!item)
+        return interaction; // The canonical item can appear one polling tick after the request.
+    if (!Array.isArray(item.changes) || item.changes.length === 0)
+        nativeInvalid("Native file approval omitted exact changes");
+    const changes = item.changes.map(raw => {
+        const change = nativeRecord(raw);
+        const path = nativeId(change.path, 16_384);
+        const kind = change.kind == null ? undefined : typeof change.kind === "string" ? change.kind : nativeRecord(change.kind).type;
+        if (kind !== undefined && typeof kind !== "string")
+            nativeInvalid("Invalid native file change kind");
+        if (change.diff !== undefined && typeof change.diff !== "string")
+            nativeInvalid("Invalid native file diff");
+        const diffBytes = typeof change.diff === "string" ? Buffer.from(change.diff) : undefined;
+        return { path, ...(typeof kind === "string" ? { kind } : {}),
+            ...(diffBytes ? { diff: diffBytes.subarray(0, 16_384).toString("utf8"), ...(diffBytes.length > 16_384 ? { diffTruncated: true } : {}) } : {}) };
+    });
+    return { ...interaction, changes };
+}
+//# sourceMappingURL=codex-native-client-interactions.js.map

package/dist/src/codex-native-client-interactions.js.map

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

package/dist/src/codex-native-client-rpc.d.ts

@@ -0,0 +1,21 @@
+import { type CodexNativeClientOptions, type CodexNativeMetadata } from "./codex-native-types.js";
+/** Internal RPC transport, deliberately not exported through the public adapter. */
+export declare class CodexNativeRpc {
+    private transport;
+    readonly timeoutMs: number;
+    readonly metadata: CodexNativeMetadata;
+    private sequence;
+    private closed;
+    private pending;
+    private listeners;
+    private unlisten;
+    private constructor();
+    static connect(options: CodexNativeClientOptions): Promise<CodexNativeRpc>;
+    onEvent(listener: (message: Record<string, unknown>) => void): () => void;
+    call(method: string, params: unknown, mutation?: boolean): Promise<unknown>;
+    respond(id: string | number, result: unknown): void;
+    close(): void;
+    private receive;
+    private receiveResponse;
+    private finish;
+}

package/dist/src/codex-native-client-rpc.js

@@ -0,0 +1,137 @@
+import path from "node:path";
+import { connectCodexUnixWebSocket } from "./codex-app-server-transport.js";
+import { parseCodexAppServerMetadata } from "./codex-app-server-read-client.js";
+import { CodexNativeError } from "./codex-native-types.js";
+import { nativeRecord, nativeInvalid } from "./codex-native-snapshot.js";
+/** Internal RPC transport, deliberately not exported through the public adapter. */
+export class CodexNativeRpc {
+    transport;
+    timeoutMs;
+    metadata;
+    sequence = 0;
+    closed = false;
+    pending = new Map();
+    listeners = new Set();
+    unlisten;
+    constructor(transport, timeoutMs, socketPath) {
+        this.transport = transport;
+        this.timeoutMs = timeoutMs;
+        this.metadata = { socketPath, codexHome: "", serverVersion: "", platformFamily: "", platformOs: "" };
+        this.unlisten = [transport.onMessage(message => this.receive(message)),
+            transport.onDisconnect(() => this.finish(new CodexNativeError("closed", "Codex native connection closed")))];
+    }
+    static async connect(options) {
+        if (!path.isAbsolute(options.codexHome))
+            throw new CodexNativeError("invalid_argument", "Codex home must be absolute");
+        const timeoutMs = options.timeoutMs ?? 10_000;
+        if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 30_000)
+            throw new CodexNativeError("invalid_argument", "Invalid native timeout");
+        const socketPath = path.join(options.codexHome, "app-server-control", "app-server-control.sock");
+        const transport = await (options.transportFactory ?? connectCodexUnixWebSocket)({ socketPath, timeoutMs });
+        const rpc = new CodexNativeRpc(transport, timeoutMs, socketPath);
+        try {
+            const result = await rpc.call("initialize", { clientInfo: { name: "agent-knock-knock-native", title: "AKK native CLI", version: "1" },
+                capabilities: { experimentalApi: true } });
+            Object.assign(rpc.metadata, parseCodexAppServerMetadata(result, { codexHome: options.codexHome, expectedServerVersion: "", compatibility: "read_contract" }, socketPath));
+            transport.send(JSON.stringify({ method: "initialized" }));
+            return rpc;
+        }
+        catch (error) {
+            rpc.close();
+            throw error;
+        }
+    }
+    onEvent(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    call(method, params, mutation = false) {
+        if (this.closed)
+            return Promise.reject(new CodexNativeError("closed", "Codex native connection closed"));
+        if (this.pending.size >= 100)
+            return Promise.reject(new CodexNativeError("invalid_argument", "Too many native requests"));
+        const id = `akk-native-${++this.sequence}`;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new CodexNativeError("timeout", `Codex native ${method} timed out`, mutation ? "unknown" : "not_sent"));
+            }, this.timeoutMs);
+            this.pending.set(id, { resolve, reject, timer, mutation, method, params });
+            try {
+                this.transport.send(JSON.stringify({ id, method, params }));
+            }
+            catch {
+                clearTimeout(timer);
+                this.pending.delete(id);
+                reject(new CodexNativeError("closed", "Codex native send failed", mutation ? "unknown" : "not_sent"));
+            }
+        });
+    }
+    respond(id, result) {
+        if (this.closed)
+            throw new CodexNativeError("closed", "Codex native connection closed");
+        try {
+            this.transport.send(JSON.stringify({ id, result }));
+        }
+        catch {
+            throw new CodexNativeError("closed", "Codex native response delivery uncertain", "unknown");
+        }
+    }
+    close() { this.finish(new CodexNativeError("closed", "Codex native connection closed")); this.transport.close(); }
+    receive(message) {
+        try {
+            if (Buffer.byteLength(message) > 8 * 1024 * 1024)
+                nativeInvalid("Native message exceeds bound");
+            const raw = nativeRecord(JSON.parse(message));
+            if (typeof raw.method === "string") {
+                for (const listener of this.listeners)
+                    listener(raw);
+                return;
+            }
+            this.receiveResponse(raw);
+        }
+        catch {
+            this.finish(new CodexNativeError("invalid_response", "Malformed Codex native protocol message"));
+            this.transport.close();
+        }
+    }
+    receiveResponse(raw) {
+        if (typeof raw.id !== "string")
+            return;
+        const pending = this.pending.get(raw.id);
+        if (!pending)
+            return;
+        // Validate before removing the pending request, so malformed errors also reject it on disconnect.
+        const responseError = raw.error !== undefined ? nativeRecord(raw.error) : undefined;
+        this.pending.delete(raw.id);
+        clearTimeout(pending.timer);
+        if (responseError)
+            pending.reject(nativeRpcError(responseError, pending));
+        else if (Object.hasOwn(raw, "result"))
+            pending.resolve(raw.result);
+        else
+            pending.reject(new CodexNativeError("invalid_response", "Native response omitted result", pending.mutation ? "unknown" : "not_sent"));
+    }
+    finish(error) {
+        if (this.closed)
+            return;
+        this.closed = true;
+        for (const p of this.pending.values()) {
+            clearTimeout(p.timer);
+            p.reject(new CodexNativeError(error.code, error.message, p.mutation ? "unknown" : "not_sent"));
+        }
+        this.pending.clear();
+        this.listeners.clear();
+        this.unlisten.forEach(stop => stop());
+    }
+}
+function nativeRpcError(error, pending) {
+    const code = typeof error.code === "number" ? error.code : undefined;
+    const unsupported = code === -32601;
+    const threadId = pending.params && typeof pending.params === "object" ? pending.params.threadId : undefined;
+    const unmaterialized = pending.method === "thread/turns/list" && code === -32600 && typeof threadId === "string"
+        && error.message === `thread ${threadId} is not materialized yet; thread/turns/list is unavailable before first user message`;
+    // Raw RPC error messages can contain prompts and private paths. Keep them local to the server.
+    return new CodexNativeError(unmaterialized ? "unmaterialized_thread" : unsupported ? "unsupported_capability" : "rpc_error", unsupported ? "Codex backend does not expose this native capability" : "Codex backend rejected the native request", pending.mutation && code !== -32601 && code !== -32602 ? "unknown" : "not_sent", code);
+}
+//# sourceMappingURL=codex-native-client-rpc.js.map

package/dist/src/codex-native-client-rpc.js.map

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

package/dist/src/codex-native-client.d.ts

@@ -0,0 +1,42 @@
+import { type CodexNativeClientOptions, type CodexNativeSnapshot, type CodexNativeThread, type CodexNativeMetadata, type NativeInteraction, type NativeInteractionResponse, type CodexNativeReceipt, type CodexNativePermissionPreset, type CodexNativePermissions } from "./codex-native-types.js";
+/** Native shared-daemon connection. No terminal ownership inference and no historical thread loading. */
+export declare class CodexNativeClient {
+    private readonly rpc;
+    readonly metadata: CodexNativeMetadata;
+    private subscribed;
+    private requests;
+    private answered;
+    private settings;
+    private liveFileChanges;
+    private constructor();
+    static connect(options: CodexNativeClientOptions): Promise<CodexNativeClient>;
+    close(): void;
+    listLoaded(): Promise<string[]>;
+    readThread(threadId: string): Promise<CodexNativeThread>;
+    discover(): Promise<CodexNativeThread[]>;
+    readSnapshot(threadId: string, exactTurnId?: string): Promise<CodexNativeSnapshot>;
+    subscribe(threadId: string): Promise<void>;
+    getInteractions(threadId: string): NativeInteraction[];
+    start(threadId: string, options: {
+        text: string;
+        clientUserMessageId: string;
+        beforeDispatch?: (snapshot: CodexNativeSnapshot) => Promise<void>;
+    }): Promise<CodexNativeReceipt>;
+    respond(interaction: NativeInteraction, response: NativeInteractionResponse): Promise<{
+        dispatchState: "sent";
+    }>;
+    answerAsync(interaction: NativeInteraction, options: {
+        answer: string;
+        clientUserMessageId: string;
+    }): Promise<CodexNativeReceipt>;
+    readPermissions(threadId: string): Promise<CodexNativePermissions>;
+    updatePermissions(threadId: string, preset: CodexNativePermissionPreset): Promise<CodexNativePermissions>;
+    private requireLoaded;
+    private resume;
+    private readTurns;
+    private readItems;
+    private receive;
+    private receiveItemEvent;
+    private clearRequests;
+    private validateInput;
+}