@codex-app-sdk/backend 0.13.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,39 @@
+# `@codex-app-sdk/backend`
+
+Trusted Node.js runtime for Codex applications. It owns app-server protocol and
+process lifecycle, transports, `CodexSurface`, and `CodexAppBackend`.
+
+```bash
+npm install @codex-app-sdk/backend @codex-app-sdk/core
+```
+
+```ts
+import { createCodexAppBackend } from '@codex-app-sdk/backend';
+
+const backend = createCodexAppBackend({
+  surfaceOptions: {
+    clientInfo: { name: 'my_app', title: 'My App', version: '0.1.0' },
+  },
+});
+
+await backend.surface.connect();
+// Grant backend.surface to one trusted Electron or web adapter.
+```
+
+The trusted surface also exposes state-neutral helpers for app-owned workflows:
+`generateText()` runs an ephemeral read-only turn, while
+`readConversationSummary()` and `readConversationPromptHistory()` retrieve
+bounded metadata or user-only prompt history without hydrating a full thread
+into renderer state.
+
+Use `@codex-app-sdk/backend/protocol` only for low-level app-server methods not
+yet projected by `CodexSurface`. Renderer code must use
+`@codex-app-sdk/core` plus a host adapter instead of importing this package.
+
+The backend does not own website users, authentication sessions, business data,
+token storage, or process-pool policy. See the [runtime
+guide](https://codex-app-sdk.github.io/codex-app-sdk/guide/surface.html) and [Node
+API](https://codex-app-sdk.github.io/codex-app-sdk/api/node.html). The generated
+[JSON-RPC coverage inventory](https://codex-app-sdk.github.io/codex-app-sdk/api/json-rpc.html)
+shows which app-server methods have a high-level SDK projection and which remain
+available only through the trusted protocol client.

package/dist/chunks/codex-BT2Vtjs1.js

@@ -0,0 +1,233 @@
+//#region src/codex/wire.ts
+var e = class extends Error {
+	requestId;
+	constructor(e, t) {
+		super(e, t), this.name = "RpcTransportProtocolError", this.requestId = t?.requestId;
+	}
+}, t = class extends Error {
+	code;
+	data;
+	constructor(e) {
+		super(e.message), this.name = "RpcRemoteError", this.code = e.code, this.data = e.data;
+	}
+};
+function n(e) {
+	return r(e) ? typeof e.code == "number" && typeof e.message == "string" : !1;
+}
+function r(e) {
+	return typeof e == "object" && !!e && !Array.isArray(e);
+}
+//#endregion
+//#region src/codex/client.ts
+var i = 15e3, a = 12e4, o = {
+	"thread/revert": a,
+	"thread/rollback": a
+}, s = (e) => ({
+	code: -32601,
+	message: `Codex app-server request is not implemented: ${e.method}`
+}), c = class {
+	transport;
+	options;
+	nextId = 1;
+	started = !1;
+	initializePromise = null;
+	pending = /* @__PURE__ */ new Map();
+	notificationListeners = /* @__PURE__ */ new Set();
+	notificationListenersByMethod = /* @__PURE__ */ new Map();
+	serverRequestHandlers = /* @__PURE__ */ new Map();
+	anyServerRequestHandlers = /* @__PURE__ */ new Set();
+	disconnectListeners = /* @__PURE__ */ new Set();
+	unsubscribeMessage;
+	unsubscribeError;
+	constructor(e, t = {}) {
+		this.transport = e, this.options = t;
+	}
+	async start() {
+		if (!this.started) {
+			this.unsubscribeMessage = this.transport.onMessage((e) => this.handleMessage(e)), this.unsubscribeError = this.transport.onError((e) => this.handleTransportError(e));
+			try {
+				await this.transport.start(), this.started = !0;
+			} catch (e) {
+				throw this.unsubscribeTransport(), e;
+			}
+		}
+	}
+	initialize(e) {
+		return this.initializePromise ||= this.request("initialize", e).then((e) => (this.notify("initialized"), e)).catch((e) => {
+			throw this.initializePromise = null, e;
+		}), this.initializePromise;
+	}
+	request(e, ...[t]) {
+		this.assertStarted();
+		let n = this.nextId++, r = t === void 0 ? {
+			id: n,
+			method: e
+		} : {
+			id: n,
+			method: e,
+			params: t
+		}, a = new Promise((t, r) => {
+			let a = setTimeout(() => {
+				this.pending.delete(n), r(/* @__PURE__ */ Error(`Codex app-server request timed out: ${e}`));
+			}, this.options.requestTimeoutMs ?? o[e] ?? i);
+			this.pending.set(n, {
+				method: e,
+				resolve: (e) => t(e),
+				reject: r,
+				timeout: a
+			});
+		});
+		try {
+			this.transport.send(r);
+		} catch (e) {
+			let t = this.pending.get(n);
+			t && (clearTimeout(t.timeout), this.pending.delete(n), t.reject(d(e)));
+		}
+		return a;
+	}
+	notify(e, ...[t]) {
+		this.assertStarted(), this.transport.send(t === void 0 ? { method: e } : {
+			method: e,
+			params: t
+		});
+	}
+	onNotification(e, t) {
+		if (typeof e == "function") return this.notificationListeners.add(e), () => this.notificationListeners.delete(e);
+		let n = this.notificationListenersByMethod.get(e) ?? /* @__PURE__ */ new Set(), r = t;
+		return n.add(r), this.notificationListenersByMethod.set(e, n), () => {
+			n.delete(r), n.size === 0 && this.notificationListenersByMethod.delete(e);
+		};
+	}
+	onServerRequest(e, t) {
+		let n = this.serverRequestHandlers.get(e) ?? /* @__PURE__ */ new Set(), r = t;
+		return n.add(r), this.serverRequestHandlers.set(e, n), () => {
+			n.delete(r), n.size === 0 && this.serverRequestHandlers.delete(e);
+		};
+	}
+	onAnyServerRequest(e) {
+		return this.anyServerRequestHandlers.add(e), () => this.anyServerRequestHandlers.delete(e);
+	}
+	onDisconnect(e) {
+		return this.disconnectListeners.add(e), () => this.disconnectListeners.delete(e);
+	}
+	async close() {
+		this.unsubscribeTransport(), this.started = !1, this.initializePromise = null, this.rejectAll(/* @__PURE__ */ Error("Codex app-server connection closed")), await this.transport.close();
+	}
+	assertStarted() {
+		if (!this.started) throw Error("Codex app-server client is not started");
+	}
+	unsubscribeTransport() {
+		this.unsubscribeMessage?.(), this.unsubscribeError?.(), this.unsubscribeMessage = void 0, this.unsubscribeError = void 0;
+	}
+	handleMessage(e) {
+		if (!r(e)) {
+			this.reportProtocolError(/* @__PURE__ */ Error("Codex app-server sent a non-object message"));
+			return;
+		}
+		let t = u(e.id) ? e.id : void 0;
+		if (t !== void 0 && ("result" in e || "error" in e) && typeof e.method != "string") {
+			this.handleResponse(t, e);
+			return;
+		}
+		if (typeof e.method == "string" && t !== void 0) {
+			this.handleServerRequest({
+				id: t,
+				method: e.method,
+				..."params" in e ? { params: e.params } : {}
+			});
+			return;
+		}
+		if (typeof e.method == "string") {
+			this.handleNotification(e);
+			return;
+		}
+		this.reportProtocolError(/* @__PURE__ */ Error("Codex app-server sent an invalid RPC message"));
+	}
+	handleResponse(e, r) {
+		let i = this.pending.get(e);
+		if (i) {
+			if (clearTimeout(i.timeout), this.pending.delete(e), "error" in r) {
+				n(r.error) ? i.reject(new t(r.error)) : i.reject(/* @__PURE__ */ Error(`Codex app-server returned a malformed error for ${i.method}`));
+				return;
+			}
+			i.resolve(r.result);
+		}
+	}
+	handleNotification(e) {
+		for (let t of this.notificationListeners) t(e);
+		for (let t of this.notificationListenersByMethod.get(e.method) ?? []) t(e);
+	}
+	async handleServerRequest(e) {
+		let t = this.createResponder(e.id), n = [...this.serverRequestHandlers.get(e.method) ?? [], ...this.anyServerRequestHandlers];
+		for (let r of n) try {
+			if (await r(e, t) === !0 || t.responded) return;
+		} catch (e) {
+			t.reject({
+				code: -32603,
+				message: d(e).message
+			});
+			return;
+		}
+		t.reject((this.options.unhandledServerRequestError ?? s)(e));
+	}
+	createResponder(e) {
+		let t = !1;
+		return {
+			get responded() {
+				return t;
+			},
+			resolve: (n) => {
+				t || (t = !0, this.transport.send({
+					id: e,
+					result: n
+				}));
+			},
+			reject: (n) => {
+				t || (t = !0, this.transport.send({
+					id: e,
+					error: l(n)
+				}));
+			}
+		};
+	}
+	rejectAll(e) {
+		for (let t of this.pending.values()) clearTimeout(t.timeout), t.reject(e);
+		this.pending.clear();
+	}
+	handleTransportError(t) {
+		if (t instanceof e) {
+			if (this.reportProtocolError(t), t.requestId !== void 0) {
+				let e = this.pending.get(t.requestId);
+				e && (clearTimeout(e.timeout), this.pending.delete(t.requestId), e.reject(t));
+			} else this.rejectAll(t);
+			return;
+		}
+		this.started = !1, this.initializePromise = null, this.unsubscribeTransport(), this.rejectAll(t);
+		for (let e of this.disconnectListeners) e(t);
+	}
+	reportProtocolError(e) {
+		this.options.onProtocolError?.(e);
+	}
+};
+function l(e) {
+	return typeof e == "string" ? {
+		code: -32603,
+		message: e
+	} : e instanceof Error ? {
+		code: -32603,
+		message: e.message
+	} : e;
+}
+function u(e) {
+	return typeof e == "number" || typeof e == "string";
+}
+function d(e) {
+	return e instanceof Error ? e : Error(String(e));
+}
+//#endregion
+//#region src/codex/schema-version.ts
+var f = "codex-cli 0.154.0";
+//#endregion
+export { r as a, e as i, c as n, n as o, t as r, f as t };
+
+//# sourceMappingURL=codex-BT2Vtjs1.js.map

package/dist/chunks/codex-BT2Vtjs1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-BT2Vtjs1.js","names":[],"sources":["../../src/codex/wire.ts","../../src/codex/client.ts","../../src/codex/schema-version.ts"],"sourcesContent":["export type RpcId = number | string;\n\nexport type RpcError = {\n  code: number;\n  message: string;\n  data?: unknown;\n};\n\nexport type RpcRequest = {\n  id: RpcId;\n  method: string;\n  params?: unknown;\n};\n\nexport type RpcNotification = {\n  method: string;\n  params?: unknown;\n};\n\nexport type RpcSuccessResponse = {\n  id: RpcId;\n  result: unknown;\n};\n\nexport type RpcErrorResponse = {\n  id: RpcId;\n  error: RpcError;\n};\n\nexport type RpcMessage =\n  | RpcRequest\n  | RpcNotification\n  | RpcSuccessResponse\n  | RpcErrorResponse;\n\nexport interface RpcTransport {\n  start(): Promise<void>;\n  send(message: RpcMessage): void;\n  close(): Promise<void>;\n  onMessage(listener: (message: unknown) => void): () => void;\n  onError(listener: (error: Error) => void): () => void;\n}\n\n/** A malformed transport frame that does not imply the connection was lost. */\nexport class RpcTransportProtocolError extends Error {\n  readonly requestId?: RpcId;\n\n  constructor(message: string, options?: ErrorOptions & { requestId?: RpcId }) {\n    super(message, options);\n    this.name = 'RpcTransportProtocolError';\n    this.requestId = options?.requestId;\n  }\n}\n\nexport class RpcRemoteError extends Error {\n  readonly code: number;\n  readonly data?: unknown;\n\n  constructor(error: RpcError) {\n    super(error.message);\n    this.name = 'RpcRemoteError';\n    this.code = error.code;\n    this.data = error.data;\n  }\n}\n\nexport function isRpcError(value: unknown): value is RpcError {\n  if (!isRecord(value)) {\n    return false;\n  }\n\n  return typeof value.code === 'number' && typeof value.message === 'string';\n}\n\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n","import type { ClientNotification } from './generated/ClientNotification';\nimport type { InitializeParams } from './generated/InitializeParams';\nimport type { InitializeResponse } from './generated/InitializeResponse';\nimport type { ServerNotification } from './generated/ServerNotification';\nimport type { ServerRequest } from './generated/ServerRequest';\nimport type { CodexAppServerMethodMap } from './method-map';\nimport type { CodexServerRequestMethodMap } from './server-request-map';\nimport {\n  isRecord,\n  isRpcError,\n  RpcRemoteError,\n  RpcTransportProtocolError,\n  type RpcError,\n  type RpcId,\n  type RpcMessage,\n  type RpcTransport,\n} from './wire';\n\ntype MethodName = keyof CodexAppServerMethodMap & string;\ntype MethodParams<Method extends MethodName> = CodexAppServerMethodMap[Method]['params'];\ntype MethodResult<Method extends MethodName> = CodexAppServerMethodMap[Method]['result'];\ntype MethodArguments<Params> = undefined extends Params ? [params?: Params] : [params: Params];\n\ntype ClientNotificationMethod = ClientNotification['method'];\ntype ClientNotificationFor<Method extends ClientNotificationMethod> = Extract<ClientNotification, { method: Method }>;\ntype ClientNotificationParams<Method extends ClientNotificationMethod> = ClientNotificationFor<Method> extends { params: infer Params }\n  ? Params\n  : undefined;\n\ntype ServerNotificationMethod = ServerNotification['method'];\ntype ServerNotificationFor<Method extends ServerNotificationMethod> = Extract<ServerNotification, { method: Method }>;\n\ntype ServerRequestMethod = keyof CodexServerRequestMethodMap & string;\ntype ServerRequestFor<Method extends ServerRequestMethod> = Extract<ServerRequest, { method: Method }>;\ntype ServerRequestResult<Method extends ServerRequestMethod> = CodexServerRequestMethodMap[Method]['result'];\n\ntype PendingRequest = {\n  method: string;\n  resolve(result: unknown): void;\n  reject(error: Error): void;\n  timeout: ReturnType<typeof setTimeout>;\n};\n\nconst DEFAULT_REQUEST_TIMEOUT_MS = 15_000;\nconst LONG_MUTATION_REQUEST_TIMEOUT_MS = 120_000;\nconst requestTimeoutByMethod: Partial<Record<MethodName, number>> = {\n  'thread/revert': LONG_MUTATION_REQUEST_TIMEOUT_MS,\n  'thread/rollback': LONG_MUTATION_REQUEST_TIMEOUT_MS,\n};\n\nexport type CodexServerRequestResponder<Method extends ServerRequestMethod> = {\n  readonly responded: boolean;\n  resolve(result: ServerRequestResult<Method>): void;\n  reject(error: Error | RpcError | string): void;\n};\n\nexport type UntypedCodexServerRequestResponder = {\n  readonly responded: boolean;\n  resolve(result: unknown): void;\n  reject(error: Error | RpcError | string): void;\n};\n\nexport type CodexAppServerClientOptions = {\n  requestTimeoutMs?: number;\n  onProtocolError?: (error: Error) => void;\n  unhandledServerRequestError?: (request: { id: RpcId; method: string; params?: unknown }) => RpcError;\n};\n\ntype AnyServerRequestHandler = (\n  request: ServerRequest,\n  responder: UntypedCodexServerRequestResponder,\n) => boolean | void | Promise<boolean | void>;\n\nconst defaultUnhandledRequestError = (request: { method: string }): RpcError => ({\n  code: -32601,\n  message: `Codex app-server request is not implemented: ${request.method}`,\n});\n\nexport class CodexAppServerClient {\n  private nextId = 1;\n  private started = false;\n  private initializePromise: Promise<InitializeResponse> | null = null;\n  private readonly pending = new Map<RpcId, PendingRequest>();\n  private readonly notificationListeners = new Set<(notification: ServerNotification) => void>();\n  private readonly notificationListenersByMethod = new Map<string, Set<(notification: ServerNotification) => void>>();\n  private readonly serverRequestHandlers = new Map<string, Set<AnyServerRequestHandler>>();\n  private readonly anyServerRequestHandlers = new Set<AnyServerRequestHandler>();\n  private readonly disconnectListeners = new Set<(error: Error) => void>();\n  private unsubscribeMessage?: () => void;\n  private unsubscribeError?: () => void;\n\n  constructor(\n    private readonly transport: RpcTransport,\n    private readonly options: CodexAppServerClientOptions = {},\n  ) {}\n\n  async start(): Promise<void> {\n    if (this.started) {\n      return;\n    }\n\n    this.unsubscribeMessage = this.transport.onMessage((message) => this.handleMessage(message));\n    this.unsubscribeError = this.transport.onError((error) => this.handleTransportError(error));\n\n    try {\n      await this.transport.start();\n      this.started = true;\n    } catch (error) {\n      this.unsubscribeTransport();\n      throw error;\n    }\n  }\n\n  initialize(params: InitializeParams): Promise<InitializeResponse> {\n    if (!this.initializePromise) {\n      this.initializePromise = this.request('initialize', params)\n        .then((result) => {\n          this.notify('initialized');\n          return result;\n        })\n        .catch((error: unknown) => {\n          this.initializePromise = null;\n          throw error;\n        });\n    }\n\n    return this.initializePromise;\n  }\n\n  request<Method extends MethodName>(\n    method: Method,\n    ...[params]: MethodArguments<MethodParams<Method>>\n  ): Promise<MethodResult<Method>> {\n    this.assertStarted();\n    const id = this.nextId++;\n    const message: RpcMessage = params === undefined\n      ? { id, method }\n      : { id, method, params };\n\n    const result = new Promise<MethodResult<Method>>((resolve, reject) => {\n      const timeout = setTimeout(() => {\n        this.pending.delete(id);\n        reject(new Error(`Codex app-server request timed out: ${method}`));\n      }, this.options.requestTimeoutMs ?? requestTimeoutByMethod[method] ?? DEFAULT_REQUEST_TIMEOUT_MS);\n\n      this.pending.set(id, {\n        method,\n        resolve: (value) => resolve(value as MethodResult<Method>),\n        reject,\n        timeout,\n      });\n    });\n\n    try {\n      this.transport.send(message);\n    } catch (error) {\n      const pending = this.pending.get(id);\n      if (pending) {\n        clearTimeout(pending.timeout);\n        this.pending.delete(id);\n        pending.reject(toError(error));\n      }\n    }\n\n    return result;\n  }\n\n  notify<Method extends ClientNotificationMethod>(\n    method: Method,\n    ...[params]: MethodArguments<ClientNotificationParams<Method>>\n  ): void {\n    this.assertStarted();\n    this.transport.send(params === undefined ? { method } : { method, params });\n  }\n\n  onNotification(listener: (notification: ServerNotification) => void): () => void;\n  onNotification<Method extends ServerNotificationMethod>(\n    method: Method,\n    listener: (notification: ServerNotificationFor<Method>) => void,\n  ): () => void;\n  onNotification<Method extends ServerNotificationMethod>(\n    methodOrListener: Method | ((notification: ServerNotification) => void),\n    methodListener?: (notification: ServerNotificationFor<Method>) => void,\n  ): () => void {\n    if (typeof methodOrListener === 'function') {\n      this.notificationListeners.add(methodOrListener);\n      return () => this.notificationListeners.delete(methodOrListener);\n    }\n\n    const listeners = this.notificationListenersByMethod.get(methodOrListener) ?? new Set();\n    const listener = methodListener as (notification: ServerNotification) => void;\n    listeners.add(listener);\n    this.notificationListenersByMethod.set(methodOrListener, listeners);\n    return () => {\n      listeners.delete(listener);\n      if (listeners.size === 0) {\n        this.notificationListenersByMethod.delete(methodOrListener);\n      }\n    };\n  }\n\n  onServerRequest<Method extends ServerRequestMethod>(\n    method: Method,\n    handler: (\n      request: ServerRequestFor<Method>,\n      responder: CodexServerRequestResponder<Method>,\n    ) => boolean | void | Promise<boolean | void>,\n  ): () => void {\n    const handlers = this.serverRequestHandlers.get(method) ?? new Set();\n    const untypedHandler = handler as AnyServerRequestHandler;\n    handlers.add(untypedHandler);\n    this.serverRequestHandlers.set(method, handlers);\n    return () => {\n      handlers.delete(untypedHandler);\n      if (handlers.size === 0) {\n        this.serverRequestHandlers.delete(method);\n      }\n    };\n  }\n\n  onAnyServerRequest(handler: AnyServerRequestHandler): () => void {\n    this.anyServerRequestHandlers.add(handler);\n    return () => this.anyServerRequestHandlers.delete(handler);\n  }\n\n  onDisconnect(listener: (error: Error) => void): () => void {\n    this.disconnectListeners.add(listener);\n    return () => this.disconnectListeners.delete(listener);\n  }\n\n  async close(): Promise<void> {\n    this.unsubscribeTransport();\n    this.started = false;\n    this.initializePromise = null;\n    this.rejectAll(new Error('Codex app-server connection closed'));\n    await this.transport.close();\n  }\n\n  private assertStarted(): void {\n    if (!this.started) {\n      throw new Error('Codex app-server client is not started');\n    }\n  }\n\n  private unsubscribeTransport(): void {\n    this.unsubscribeMessage?.();\n    this.unsubscribeError?.();\n    this.unsubscribeMessage = undefined;\n    this.unsubscribeError = undefined;\n  }\n\n  private handleMessage(message: unknown): void {\n    if (!isRecord(message)) {\n      this.reportProtocolError(new Error('Codex app-server sent a non-object message'));\n      return;\n    }\n\n    const id = isRpcId(message.id) ? message.id : undefined;\n    if (id !== undefined && ('result' in message || 'error' in message) && typeof message.method !== 'string') {\n      this.handleResponse(id, message);\n      return;\n    }\n\n    if (typeof message.method === 'string' && id !== undefined) {\n      void this.handleServerRequest({\n        id,\n        method: message.method,\n        ...('params' in message ? { params: message.params } : {}),\n      });\n      return;\n    }\n\n    if (typeof message.method === 'string') {\n      this.handleNotification(message as ServerNotification);\n      return;\n    }\n\n    this.reportProtocolError(new Error('Codex app-server sent an invalid RPC message'));\n  }\n\n  private handleResponse(id: RpcId, message: Record<string, unknown>): void {\n    const pending = this.pending.get(id);\n    if (!pending) {\n      return;\n    }\n\n    clearTimeout(pending.timeout);\n    this.pending.delete(id);\n    if ('error' in message) {\n      if (isRpcError(message.error)) {\n        pending.reject(new RpcRemoteError(message.error));\n      } else {\n        pending.reject(new Error(`Codex app-server returned a malformed error for ${pending.method}`));\n      }\n      return;\n    }\n\n    pending.resolve(message.result);\n  }\n\n  private handleNotification(notification: ServerNotification): void {\n    for (const listener of this.notificationListeners) {\n      listener(notification);\n    }\n    for (const listener of this.notificationListenersByMethod.get(notification.method) ?? []) {\n      listener(notification);\n    }\n  }\n\n  private async handleServerRequest(request: { id: RpcId; method: string; params?: unknown }): Promise<void> {\n    const responder = this.createResponder(request.id);\n    const handlers = [\n      ...(this.serverRequestHandlers.get(request.method) ?? []),\n      ...this.anyServerRequestHandlers,\n    ];\n\n    for (const handler of handlers) {\n      try {\n        const claimed = await handler(request as ServerRequest, responder);\n        if (claimed === true || responder.responded) {\n          return;\n        }\n      } catch (error) {\n        responder.reject({\n          code: -32603,\n          message: toError(error).message,\n        });\n        return;\n      }\n    }\n\n    responder.reject((this.options.unhandledServerRequestError ?? defaultUnhandledRequestError)(request));\n  }\n\n  private createResponder(id: RpcId): UntypedCodexServerRequestResponder {\n    let responded = false;\n    return {\n      get responded() {\n        return responded;\n      },\n      resolve: (result) => {\n        if (responded) {\n          return;\n        }\n        responded = true;\n        this.transport.send({ id, result });\n      },\n      reject: (error) => {\n        if (responded) {\n          return;\n        }\n        responded = true;\n        this.transport.send({ id, error: normalizeRpcError(error) });\n      },\n    };\n  }\n\n  private rejectAll(error: Error): void {\n    for (const pending of this.pending.values()) {\n      clearTimeout(pending.timeout);\n      pending.reject(error);\n    }\n    this.pending.clear();\n  }\n\n  private handleTransportError(error: Error): void {\n    if (error instanceof RpcTransportProtocolError) {\n      this.reportProtocolError(error);\n      if (error.requestId !== undefined) {\n        const pending = this.pending.get(error.requestId);\n        if (pending) {\n          clearTimeout(pending.timeout);\n          this.pending.delete(error.requestId);\n          pending.reject(error);\n        }\n      } else {\n        this.rejectAll(error);\n      }\n      return;\n    }\n    this.started = false;\n    this.initializePromise = null;\n    this.unsubscribeTransport();\n    this.rejectAll(error);\n    for (const listener of this.disconnectListeners) listener(error);\n  }\n\n  private reportProtocolError(error: Error): void {\n    this.options.onProtocolError?.(error);\n  }\n}\n\nfunction normalizeRpcError(error: Error | RpcError | string): RpcError {\n  if (typeof error === 'string') {\n    return { code: -32603, message: error };\n  }\n  if (error instanceof Error) {\n    return { code: -32603, message: error.message };\n  }\n  return error;\n}\n\nfunction isRpcId(value: unknown): value is RpcId {\n  return typeof value === 'number' || typeof value === 'string';\n}\n\nfunction toError(error: unknown): Error {\n  return error instanceof Error ? error : new Error(String(error));\n}\n","// Generated by scripts/generate-codex-schema.mjs.\nexport const codexSchemaCliVersion = \"codex-cli 0.154.0\";\n"],"mappings":"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"}

package/dist/codex/client.d.ts

@@ -0,0 +1,86 @@
+import type { ClientNotification } from './generated/ClientNotification';
+import type { InitializeParams } from './generated/InitializeParams';
+import type { InitializeResponse } from './generated/InitializeResponse';
+import type { ServerNotification } from './generated/ServerNotification';
+import type { ServerRequest } from './generated/ServerRequest';
+import type { CodexAppServerMethodMap } from './method-map';
+import type { CodexServerRequestMethodMap } from './server-request-map';
+import { type RpcError, type RpcId, type RpcTransport } from './wire';
+type MethodName = keyof CodexAppServerMethodMap & string;
+type MethodParams<Method extends MethodName> = CodexAppServerMethodMap[Method]['params'];
+type MethodResult<Method extends MethodName> = CodexAppServerMethodMap[Method]['result'];
+type MethodArguments<Params> = undefined extends Params ? [params?: Params] : [params: Params];
+type ClientNotificationMethod = ClientNotification['method'];
+type ClientNotificationFor<Method extends ClientNotificationMethod> = Extract<ClientNotification, {
+    method: Method;
+}>;
+type ClientNotificationParams<Method extends ClientNotificationMethod> = ClientNotificationFor<Method> extends {
+    params: infer Params;
+} ? Params : undefined;
+type ServerNotificationMethod = ServerNotification['method'];
+type ServerNotificationFor<Method extends ServerNotificationMethod> = Extract<ServerNotification, {
+    method: Method;
+}>;
+type ServerRequestMethod = keyof CodexServerRequestMethodMap & string;
+type ServerRequestFor<Method extends ServerRequestMethod> = Extract<ServerRequest, {
+    method: Method;
+}>;
+type ServerRequestResult<Method extends ServerRequestMethod> = CodexServerRequestMethodMap[Method]['result'];
+export type CodexServerRequestResponder<Method extends ServerRequestMethod> = {
+    readonly responded: boolean;
+    resolve(result: ServerRequestResult<Method>): void;
+    reject(error: Error | RpcError | string): void;
+};
+export type UntypedCodexServerRequestResponder = {
+    readonly responded: boolean;
+    resolve(result: unknown): void;
+    reject(error: Error | RpcError | string): void;
+};
+export type CodexAppServerClientOptions = {
+    requestTimeoutMs?: number;
+    onProtocolError?: (error: Error) => void;
+    unhandledServerRequestError?: (request: {
+        id: RpcId;
+        method: string;
+        params?: unknown;
+    }) => RpcError;
+};
+type AnyServerRequestHandler = (request: ServerRequest, responder: UntypedCodexServerRequestResponder) => boolean | void | Promise<boolean | void>;
+export declare class CodexAppServerClient {
+    private readonly transport;
+    private readonly options;
+    private nextId;
+    private started;
+    private initializePromise;
+    private readonly pending;
+    private readonly notificationListeners;
+    private readonly notificationListenersByMethod;
+    private readonly serverRequestHandlers;
+    private readonly anyServerRequestHandlers;
+    private readonly disconnectListeners;
+    private unsubscribeMessage?;
+    private unsubscribeError?;
+    constructor(transport: RpcTransport, options?: CodexAppServerClientOptions);
+    start(): Promise<void>;
+    initialize(params: InitializeParams): Promise<InitializeResponse>;
+    request<Method extends MethodName>(method: Method, ...[params]: MethodArguments<MethodParams<Method>>): Promise<MethodResult<Method>>;
+    notify<Method extends ClientNotificationMethod>(method: Method, ...[params]: MethodArguments<ClientNotificationParams<Method>>): void;
+    onNotification(listener: (notification: ServerNotification) => void): () => void;
+    onNotification<Method extends ServerNotificationMethod>(method: Method, listener: (notification: ServerNotificationFor<Method>) => void): () => void;
+    onServerRequest<Method extends ServerRequestMethod>(method: Method, handler: (request: ServerRequestFor<Method>, responder: CodexServerRequestResponder<Method>) => boolean | void | Promise<boolean | void>): () => void;
+    onAnyServerRequest(handler: AnyServerRequestHandler): () => void;
+    onDisconnect(listener: (error: Error) => void): () => void;
+    close(): Promise<void>;
+    private assertStarted;
+    private unsubscribeTransport;
+    private handleMessage;
+    private handleResponse;
+    private handleNotification;
+    private handleServerRequest;
+    private createResponder;
+    private rejectAll;
+    private handleTransportError;
+    private reportProtocolError;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/codex/client.d.ts.map

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

package/dist/codex/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/generated/AbsolutePathBuf.d.ts.map

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

package/dist/codex/generated/AgentMessageInputContent.d.ts

@@ -0,0 +1,8 @@
+export type AgentMessageInputContent = {
+    "type": "input_text";
+    text: string;
+} | {
+    "type": "encrypted_content";
+    encrypted_content: string;
+};
+//# sourceMappingURL=AgentMessageInputContent.d.ts.map

package/dist/codex/generated/AgentMessageInputContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentMessageInputContent.d.ts","sourceRoot":"","sources":["../../../src/codex/generated/AgentMessageInputContent.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,wBAAwB,GAAG;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;CAAE,GAAG;IAAE,MAAM,EAAE,mBAAmB,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAC;CAAE,CAAC"}

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

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

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

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