@elench/shell 0.1.11 → 0.1.13

package/README.md

@@ -23,6 +23,22 @@ nodes. The shell adapts those definitions into its internal layout substrate;
 consumers should not import FlexLayout, shell internals, package source paths,
 or UI primitives directly.
 
+## Codex App Server
+
+The browser-safe API includes Codex app-server protocol types, a WebSocket
+client, React provider/hooks, a generic `codex-thread` view node, and reusable
+thread/request rendering primitives.
+
+Node-only process helpers are exported separately:
+
+```ts
+import { startCodexAppServerHost } from "@elench/shell/node";
+```
+
+Use the Node export from an Electron main process or local server boundary, then
+pass the WebSocket endpoint to the renderer through application-owned host
+plumbing.
+
 ## Commands
 
 ```bash

package/dist/codex/app-server-client.d.ts

@@ -0,0 +1,130 @@
+import type { CodexClientMethod, CodexClientNotification, CodexInitializeCapabilities, CodexInitializeResponse, CodexNotificationFor, CodexRequestId, CodexRequestParams, CodexResponseFor, CodexServerNotification, CodexServerNotificationMethod, CodexServerRequest, CodexServerRequestFor, CodexServerRequestMethod } from "./protocol.js";
+import type { CommandExecParams } from "./protocol/generated/v2/CommandExecParams.js";
+import type { CommandExecResponse } from "./protocol/generated/v2/CommandExecResponse.js";
+import type { ModelListParams } from "./protocol/generated/v2/ModelListParams.js";
+import type { ModelListResponse } from "./protocol/generated/v2/ModelListResponse.js";
+import type { ThreadListParams } from "./protocol/generated/v2/ThreadListParams.js";
+import type { ThreadListResponse } from "./protocol/generated/v2/ThreadListResponse.js";
+import type { ThreadReadParams } from "./protocol/generated/v2/ThreadReadParams.js";
+import type { ThreadReadResponse } from "./protocol/generated/v2/ThreadReadResponse.js";
+import type { ThreadResumeParams } from "./protocol/generated/v2/ThreadResumeParams.js";
+import type { ThreadResumeResponse } from "./protocol/generated/v2/ThreadResumeResponse.js";
+import type { ThreadStartParams } from "./protocol/generated/v2/ThreadStartParams.js";
+import type { ThreadStartResponse } from "./protocol/generated/v2/ThreadStartResponse.js";
+import type { TurnInterruptParams } from "./protocol/generated/v2/TurnInterruptParams.js";
+import type { TurnInterruptResponse } from "./protocol/generated/v2/TurnInterruptResponse.js";
+import type { TurnStartParams } from "./protocol/generated/v2/TurnStartParams.js";
+import type { TurnStartResponse } from "./protocol/generated/v2/TurnStartResponse.js";
+import type { TurnSteerParams } from "./protocol/generated/v2/TurnSteerParams.js";
+import type { TurnSteerResponse } from "./protocol/generated/v2/TurnSteerResponse.js";
+export type CodexAppServerConnectionStatus = "idle" | "connecting" | "connected" | "closed" | "error";
+export type CodexAppServerTransport = {
+    readonly status: CodexAppServerConnectionStatus;
+    connect: () => Promise<void>;
+    send: (message: string) => void | Promise<void>;
+    close: () => void | Promise<void>;
+    onMessage: (listener: (message: string) => void) => () => void;
+    onStatusChange?: (listener: (status: CodexAppServerConnectionStatus) => void) => () => void;
+};
+export type CodexJsonRpcErrorBody = {
+    code?: number;
+    message: string;
+    data?: unknown;
+};
+export declare class CodexAppServerError extends Error {
+    readonly details?: CodexJsonRpcErrorBody | undefined;
+    constructor(message: string, details?: CodexJsonRpcErrorBody | undefined);
+}
+export type CodexAppServerClientInfo = {
+    name: string;
+    title?: string | null;
+    version: string;
+};
+export type CodexAppServerClientOptions = {
+    clientInfo?: CodexAppServerClientInfo;
+    capabilities?: Partial<CodexInitializeCapabilities>;
+    requestTimeoutMs?: number;
+    transport: CodexAppServerTransport;
+};
+type StatusListener = (status: CodexAppServerConnectionStatus) => void;
+type NotificationListener = (notification: CodexServerNotification) => void;
+type ServerRequestListener = (request: CodexServerRequest) => void;
+export declare function createCodexTextInput(text: string): {
+    type: "text";
+    text: string;
+    text_elements: never[];
+};
+export declare function normalizeCodexThreadStartParams(params?: Partial<ThreadStartParams>): ThreadStartParams;
+export declare class CodexAppServerClient {
+    private connected;
+    private nextId;
+    private readonly pending;
+    private readonly notificationListeners;
+    private readonly serverRequestListeners;
+    private readonly statusListeners;
+    private readonly unsubscribeMessage;
+    private readonly unsubscribeStatus?;
+    readonly clientInfo: CodexAppServerClientInfo;
+    readonly capabilities?: Partial<CodexInitializeCapabilities>;
+    readonly requestTimeoutMs: number;
+    readonly transport: CodexAppServerTransport;
+    constructor({ capabilities, clientInfo, requestTimeoutMs, transport, }: CodexAppServerClientOptions);
+    get status(): CodexAppServerConnectionStatus;
+    connect(): Promise<void>;
+    initialize(params?: import("./protocol/generated/index.js").InitializeParams): Promise<CodexInitializeResponse>;
+    request<TMethod extends CodexClientMethod>(method: TMethod, params: CodexRequestParams<TMethod>, options?: {
+        timeoutMs?: number;
+    }): Promise<CodexResponseFor<TMethod>>;
+    requestRaw<TResponse = unknown>(method: string, params?: unknown, options?: {
+        timeoutMs?: number;
+    }): Promise<TResponse>;
+    notify(notification: CodexClientNotification): Promise<void>;
+    respond(requestId: CodexRequestId, result: unknown): Promise<void>;
+    reject(requestId: CodexRequestId, error: CodexJsonRpcErrorBody): Promise<void>;
+    startThread(params?: Partial<ThreadStartParams>): Promise<ThreadStartResponse>;
+    resumeThread(params: ThreadResumeParams): Promise<ThreadResumeResponse>;
+    readThread(params: ThreadReadParams): Promise<ThreadReadResponse>;
+    listThreads(params?: ThreadListParams): Promise<ThreadListResponse>;
+    startTurn(params: TurnStartParams): Promise<TurnStartResponse>;
+    steerTurn(params: TurnSteerParams): Promise<TurnSteerResponse>;
+    interruptTurn(params: TurnInterruptParams): Promise<TurnInterruptResponse>;
+    listModels(params?: ModelListParams): Promise<ModelListResponse>;
+    execCommand(params: CommandExecParams, options?: {
+        timeoutMs?: number;
+    }): Promise<CommandExecResponse>;
+    onStatusChange(listener: StatusListener): () => void;
+    onNotification(listener: NotificationListener): () => void;
+    onNotification<TMethod extends CodexServerNotificationMethod>(method: TMethod, listener: (notification: CodexNotificationFor<TMethod>) => void): () => void;
+    onServerRequest(listener: ServerRequestListener): () => void;
+    onServerRequest<TMethod extends CodexServerRequestMethod>(method: TMethod, listener: (request: CodexServerRequestFor<TMethod>) => void): () => void;
+    close(): Promise<void>;
+    private handleTransportMessage;
+    private handleResponse;
+    private emitStatus;
+    private rejectPending;
+}
+export type CodexAppServerWebSocketTransportOptions = {
+    protocols?: string | string[];
+    url: string | URL;
+    WebSocketCtor?: typeof WebSocket;
+};
+export declare class CodexAppServerWebSocketTransport implements CodexAppServerTransport {
+    private readonly options;
+    private socket;
+    private currentStatus;
+    private readonly messageListeners;
+    private readonly statusListeners;
+    constructor(options: CodexAppServerWebSocketTransportOptions);
+    get status(): CodexAppServerConnectionStatus;
+    connect(): Promise<void>;
+    send(message: string): void;
+    close(): void;
+    onMessage(listener: (message: string) => void): () => void;
+    onStatusChange(listener: StatusListener): () => void;
+    private emitMessage;
+    private setStatus;
+}
+export declare function createCodexAppServerClient(options: CodexAppServerClientOptions): CodexAppServerClient;
+export declare function createCodexAppServerWebSocketClient(options: Omit<CodexAppServerClientOptions, "transport"> & CodexAppServerWebSocketTransportOptions): CodexAppServerClient;
+export {};
+//# sourceMappingURL=app-server-client.d.ts.map

package/dist/codex/app-server-client.d.ts.map

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

package/dist/codex/app-server-client.js

@@ -0,0 +1,384 @@
+export class CodexAppServerError extends Error {
+    constructor(message, details) {
+        super(message);
+        this.details = details;
+        this.name = "CodexAppServerError";
+    }
+}
+const DEFAULT_CLIENT_INFO = {
+    name: "elench-shell",
+    title: "Elench Shell",
+    version: "0.1.0",
+};
+function isObject(value) {
+    return typeof value === "object" && value !== null;
+}
+function isResponseMessage(value) {
+    return isObject(value) && "id" in value && !("method" in value);
+}
+function isServerRequestMessage(value) {
+    return isObject(value) && "id" in value && typeof value.method === "string";
+}
+function isNotificationMessage(value) {
+    return isObject(value) && !("id" in value) && typeof value.method === "string";
+}
+function normalizeInitializeParams(clientInfo, capabilities) {
+    return {
+        clientInfo: {
+            name: clientInfo.name,
+            title: clientInfo.title ?? null,
+            version: clientInfo.version,
+        },
+        capabilities: {
+            experimentalApi: capabilities?.experimentalApi ?? true,
+            optOutNotificationMethods: capabilities?.optOutNotificationMethods ?? undefined,
+        },
+    };
+}
+export function createCodexTextInput(text) {
+    return { type: "text", text, text_elements: [] };
+}
+export function normalizeCodexThreadStartParams(params = {}) {
+    return {
+        ...params,
+        experimentalRawEvents: params.experimentalRawEvents ?? false,
+        persistExtendedHistory: params.persistExtendedHistory ?? true,
+    };
+}
+export class CodexAppServerClient {
+    constructor({ capabilities, clientInfo = DEFAULT_CLIENT_INFO, requestTimeoutMs = 60000, transport, }) {
+        this.connected = false;
+        this.nextId = 1;
+        this.pending = new Map();
+        this.notificationListeners = new Set();
+        this.serverRequestListeners = new Set();
+        this.statusListeners = new Set();
+        this.capabilities = capabilities;
+        this.clientInfo = clientInfo;
+        this.requestTimeoutMs = requestTimeoutMs;
+        this.transport = transport;
+        this.unsubscribeMessage = transport.onMessage((message) => this.handleTransportMessage(message));
+        this.unsubscribeStatus = transport.onStatusChange?.((status) => this.emitStatus(status));
+    }
+    get status() {
+        return this.transport.status;
+    }
+    async connect() {
+        if (this.status === "connected")
+            return;
+        await this.transport.connect();
+        this.connected = true;
+    }
+    async initialize(params = normalizeInitializeParams(this.clientInfo, this.capabilities)) {
+        const response = await this.request("initialize", params);
+        await this.notify({ method: "initialized" });
+        return response;
+    }
+    async request(method, params, options) {
+        await this.connect();
+        const id = this.nextId++;
+        const message = { id, method, params };
+        const timeoutMs = options?.timeoutMs ?? this.requestTimeoutMs;
+        const promise = new Promise((resolve, reject) => {
+            const timeout = timeoutMs > 0
+                ? setTimeout(() => {
+                    this.pending.delete(id);
+                    reject(new CodexAppServerError(`Codex app-server request timed out: ${method}`));
+                }, timeoutMs)
+                : null;
+            this.pending.set(id, {
+                method,
+                reject,
+                resolve: resolve,
+                timeout,
+            });
+        });
+        try {
+            await this.transport.send(JSON.stringify(message));
+        }
+        catch (error) {
+            const pending = this.pending.get(id);
+            if (pending?.timeout)
+                clearTimeout(pending.timeout);
+            this.pending.delete(id);
+            throw error;
+        }
+        return promise;
+    }
+    async requestRaw(method, params, options) {
+        await this.connect();
+        const id = this.nextId++;
+        const message = { id, method, params };
+        const timeoutMs = options?.timeoutMs ?? this.requestTimeoutMs;
+        const promise = new Promise((resolve, reject) => {
+            const timeout = timeoutMs > 0
+                ? setTimeout(() => {
+                    this.pending.delete(id);
+                    reject(new CodexAppServerError(`Codex app-server request timed out: ${method}`));
+                }, timeoutMs)
+                : null;
+            this.pending.set(id, {
+                method,
+                reject,
+                resolve: resolve,
+                timeout,
+            });
+        });
+        try {
+            await this.transport.send(JSON.stringify(message));
+        }
+        catch (error) {
+            const pending = this.pending.get(id);
+            if (pending?.timeout)
+                clearTimeout(pending.timeout);
+            this.pending.delete(id);
+            throw error;
+        }
+        return promise;
+    }
+    notify(notification) {
+        return Promise.resolve(this.transport.send(JSON.stringify(notification)));
+    }
+    respond(requestId, result) {
+        return Promise.resolve(this.transport.send(JSON.stringify({ id: requestId, result })));
+    }
+    reject(requestId, error) {
+        return Promise.resolve(this.transport.send(JSON.stringify({ id: requestId, error })));
+    }
+    startThread(params = {}) {
+        return this.request("thread/start", normalizeCodexThreadStartParams(params));
+    }
+    resumeThread(params) {
+        return this.request("thread/resume", params);
+    }
+    readThread(params) {
+        return this.request("thread/read", params);
+    }
+    listThreads(params = {}) {
+        return this.request("thread/list", params);
+    }
+    startTurn(params) {
+        return this.request("turn/start", params);
+    }
+    steerTurn(params) {
+        return this.request("turn/steer", params);
+    }
+    interruptTurn(params) {
+        return this.request("turn/interrupt", params);
+    }
+    listModels(params = {}) {
+        return this.request("model/list", params);
+    }
+    execCommand(params, options) {
+        return this.request("command/exec", params, options);
+    }
+    onStatusChange(listener) {
+        this.statusListeners.add(listener);
+        listener(this.status);
+        return () => {
+            this.statusListeners.delete(listener);
+        };
+    }
+    onNotification(methodOrListener, listener) {
+        const wrapped = typeof methodOrListener === "function"
+            ? methodOrListener
+            : (notification) => {
+                if (notification.method === methodOrListener) {
+                    listener?.(notification);
+                }
+            };
+        this.notificationListeners.add(wrapped);
+        return () => {
+            this.notificationListeners.delete(wrapped);
+        };
+    }
+    onServerRequest(methodOrListener, listener) {
+        const wrapped = typeof methodOrListener === "function"
+            ? methodOrListener
+            : (request) => {
+                if (request.method === methodOrListener) {
+                    listener?.(request);
+                }
+            };
+        this.serverRequestListeners.add(wrapped);
+        return () => {
+            this.serverRequestListeners.delete(wrapped);
+        };
+    }
+    close() {
+        this.connected = false;
+        this.rejectPending(new CodexAppServerError("Codex app-server closed."));
+        this.unsubscribeMessage();
+        this.unsubscribeStatus?.();
+        return Promise.resolve(this.transport.close());
+    }
+    handleTransportMessage(raw) {
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch (error) {
+            this.rejectPending(new CodexAppServerError(error instanceof Error
+                ? error.message
+                : "Failed to parse Codex app-server message."));
+            return;
+        }
+        if (isResponseMessage(parsed)) {
+            this.handleResponse(parsed);
+            return;
+        }
+        if (isServerRequestMessage(parsed)) {
+            const request = parsed;
+            for (const listener of this.serverRequestListeners)
+                listener(request);
+            return;
+        }
+        if (isNotificationMessage(parsed)) {
+            const notification = parsed;
+            for (const listener of this.notificationListeners) {
+                listener(notification);
+            }
+            return;
+        }
+    }
+    handleResponse(message) {
+        const pending = this.pending.get(message.id);
+        if (!pending)
+            return;
+        this.pending.delete(message.id);
+        if (pending.timeout)
+            clearTimeout(pending.timeout);
+        if (message.error) {
+            pending.reject(new CodexAppServerError(message.error.message, message.error));
+            return;
+        }
+        pending.resolve(message.result);
+    }
+    emitStatus(status) {
+        if (status !== "connected")
+            this.connected = false;
+        for (const listener of this.statusListeners)
+            listener(status);
+    }
+    rejectPending(error) {
+        for (const pending of this.pending.values()) {
+            if (pending.timeout)
+                clearTimeout(pending.timeout);
+            pending.reject(error);
+        }
+        this.pending.clear();
+    }
+}
+export class CodexAppServerWebSocketTransport {
+    constructor(options) {
+        this.options = options;
+        this.socket = null;
+        this.currentStatus = "idle";
+        this.messageListeners = new Set();
+        this.statusListeners = new Set();
+    }
+    get status() {
+        return this.currentStatus;
+    }
+    connect() {
+        if (this.socket?.readyState === WebSocket.OPEN)
+            return Promise.resolve();
+        if (this.currentStatus === "connecting") {
+            return new Promise((resolve, reject) => {
+                const unsubscribe = this.onStatusChange((status) => {
+                    if (status === "connected") {
+                        unsubscribe();
+                        resolve();
+                    }
+                    else if (status === "error" || status === "closed") {
+                        unsubscribe();
+                        reject(new CodexAppServerError("WebSocket connection failed."));
+                    }
+                });
+            });
+        }
+        const WebSocketImpl = this.options.WebSocketCtor ?? WebSocket;
+        this.setStatus("connecting");
+        return new Promise((resolve, reject) => {
+            const socket = new WebSocketImpl(this.options.url, this.options.protocols);
+            this.socket = socket;
+            const cleanupInitialListeners = () => {
+                socket.removeEventListener("open", handleOpen);
+                socket.removeEventListener("error", handleInitialError);
+            };
+            const handleOpen = () => {
+                cleanupInitialListeners();
+                this.setStatus("connected");
+                resolve();
+            };
+            const handleInitialError = () => {
+                cleanupInitialListeners();
+                this.setStatus("error");
+                reject(new CodexAppServerError("WebSocket connection failed."));
+            };
+            socket.addEventListener("open", handleOpen);
+            socket.addEventListener("error", handleInitialError);
+            socket.addEventListener("error", () => this.setStatus("error"));
+            socket.addEventListener("close", () => this.setStatus("closed"));
+            socket.addEventListener("message", (event) => {
+                if (typeof event.data === "string") {
+                    this.emitMessage(event.data);
+                    return;
+                }
+                if (event.data instanceof Blob) {
+                    void event.data.text().then((text) => this.emitMessage(text));
+                }
+            });
+        });
+    }
+    send(message) {
+        if (!this.socket || this.socket.readyState !== WebSocket.OPEN) {
+            throw new CodexAppServerError("Codex app-server WebSocket is not open.");
+        }
+        this.socket.send(message);
+    }
+    close() {
+        this.socket?.close();
+        this.socket = null;
+        this.setStatus("closed");
+    }
+    onMessage(listener) {
+        this.messageListeners.add(listener);
+        return () => {
+            this.messageListeners.delete(listener);
+        };
+    }
+    onStatusChange(listener) {
+        this.statusListeners.add(listener);
+        listener(this.currentStatus);
+        return () => {
+            this.statusListeners.delete(listener);
+        };
+    }
+    emitMessage(message) {
+        for (const listener of this.messageListeners)
+            listener(message);
+    }
+    setStatus(status) {
+        if (this.currentStatus === status)
+            return;
+        this.currentStatus = status;
+        for (const listener of this.statusListeners)
+            listener(status);
+    }
+}
+export function createCodexAppServerClient(options) {
+    return new CodexAppServerClient(options);
+}
+export function createCodexAppServerWebSocketClient(options) {
+    const { protocols, url, WebSocketCtor, ...clientOptions } = options;
+    return new CodexAppServerClient({
+        ...clientOptions,
+        transport: new CodexAppServerWebSocketTransport({
+            protocols,
+            url,
+            WebSocketCtor,
+        }),
+    });
+}
+//# sourceMappingURL=app-server-client.js.map

package/dist/codex/app-server-client.js.map

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

package/dist/codex/protocol/generated/AbsolutePathBuf.d.ts

@@ -0,0 +1,11 @@
+/**
+ * A path that is guaranteed to be absolute and normalized (though it is not
+ * guaranteed to be canonicalized or exist on the filesystem).
+ *
+ * IMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set
+ * using [AbsolutePathBufGuard::new]. If no base path is set, the
+ * deserialization will fail unless the path being deserialized is already
+ * absolute.
+ */
+export type AbsolutePathBuf = string;
+//# sourceMappingURL=AbsolutePathBuf.d.ts.map

package/dist/codex/protocol/generated/AbsolutePathBuf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbsolutePathBuf.d.ts","sourceRoot":"","sources":["../../../../src/codex/protocol/generated/AbsolutePathBuf.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC"}

package/dist/codex/protocol/generated/AbsolutePathBuf.js

@@ -0,0 +1,3 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+export {};
+//# sourceMappingURL=AbsolutePathBuf.js.map

package/dist/codex/protocol/generated/AbsolutePathBuf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbsolutePathBuf.js","sourceRoot":"","sources":["../../../../src/codex/protocol/generated/AbsolutePathBuf.ts"],"names":[],"mappings":"AAAA,yCAAyC"}

package/dist/codex/protocol/generated/AgentPath.d.ts

@@ -0,0 +1,2 @@
+export type AgentPath = string;
+//# sourceMappingURL=AgentPath.d.ts.map

package/dist/codex/protocol/generated/AgentPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentPath.d.ts","sourceRoot":"","sources":["../../../../src/codex/protocol/generated/AgentPath.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC"}

package/dist/codex/protocol/generated/AgentPath.js

@@ -0,0 +1,3 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+export {};
+//# sourceMappingURL=AgentPath.js.map

package/dist/codex/protocol/generated/AgentPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentPath.js","sourceRoot":"","sources":["../../../../src/codex/protocol/generated/AgentPath.ts"],"names":[],"mappings":"AAAA,yCAAyC"}

package/dist/codex/protocol/generated/ApplyPatchApprovalParams.d.ts

@@ -0,0 +1,23 @@
+import type { FileChange } from "./FileChange.js";
+import type { ThreadId } from "./ThreadId.js";
+export type ApplyPatchApprovalParams = {
+    conversationId: ThreadId;
+    /**
+     * Use to correlate this with [codex_protocol::protocol::PatchApplyBeginEvent]
+     * and [codex_protocol::protocol::PatchApplyEndEvent].
+     */
+    callId: string;
+    fileChanges: {
+        [key in string]?: FileChange;
+    };
+    /**
+     * Optional explanatory reason (e.g. request for extra write access).
+     */
+    reason: string | null;
+    /**
+     * When set, the agent is asking the user to allow writes under this root
+     * for the remainder of the session (unclear if this is honored today).
+     */
+    grantRoot: string | null;
+};
+//# sourceMappingURL=ApplyPatchApprovalParams.d.ts.map

package/dist/codex/protocol/generated/ApplyPatchApprovalParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApplyPatchApprovalParams.d.ts","sourceRoot":"","sources":["../../../../src/codex/protocol/generated/ApplyPatchApprovalParams.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,MAAM,wBAAwB,GAAG;IAAE,cAAc,EAAE,QAAQ,CAAC;IAClE;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE;SAAG,GAAG,IAAI,MAAM,CAAC,CAAC,EAAE,UAAU;KAAE,CAAC;IAC9D;;OAEG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;;OAGG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAAE,CAAC"}

package/dist/codex/protocol/generated/ApplyPatchApprovalParams.js

@@ -0,0 +1,3 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+export {};
+//# sourceMappingURL=ApplyPatchApprovalParams.js.map

package/dist/codex/protocol/generated/ApplyPatchApprovalParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApplyPatchApprovalParams.js","sourceRoot":"","sources":["../../../../src/codex/protocol/generated/ApplyPatchApprovalParams.ts"],"names":[],"mappings":"AAAA,yCAAyC"}

package/dist/codex/protocol/generated/ApplyPatchApprovalResponse.d.ts

@@ -0,0 +1,5 @@
+import type { ReviewDecision } from "./ReviewDecision.js";
+export type ApplyPatchApprovalResponse = {
+    decision: ReviewDecision;
+};
+//# sourceMappingURL=ApplyPatchApprovalResponse.d.ts.map