@codex-app-sdk/backend 0.17.0 → 0.18.0

package/dist/node/codex-surface-turn-actions-controller.d.ts.map

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

package/dist/protocol.js

@@ -1,2 +1,2 @@
-import { a as e, i as t, n, o as r, r as i, t as a } from "./chunks/codex-DzX6RrF2.js";
+import { a as e, i as t, n, o as r, r as i, t as a } from "./chunks/codex-CmHW3ikB.js";
 export { n as CodexAppServerClient, i as RpcRemoteError, t as RpcTransportProtocolError, a as codexSchemaCliVersion, e as isRecord, r as isRpcError };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codex-app-sdk/backend",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "Node.js app-server runtime and backend composition for Codex applications.",
   "type": "module",
   "license": "Apache-2.0",
@@ -39,7 +39,7 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@codex-app-sdk/core": "0.17.0"
+    "@codex-app-sdk/core": "0.18.0"
   },
   "engines": {
     "node": ">=22"

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

@@ -1 +0,0 @@
-{"version":3,"file":"codex-DzX6RrF2.js","names":[],"sources":["../../src/codex/listener-errors.ts","../../src/codex/wire.ts","../../src/codex/client.ts","../../src/codex/schema-version.ts"],"sourcesContent":["export type ListenerErrorHandler = (error: unknown) => void;\n\n/**\n * Reports an exception thrown by a subscriber without letting it disturb the\n * code that notified it. The host's handler receives it; without one it\n * surfaces as a process warning, so it is neither swallowed nor fatal.\n */\nexport function reportListenerError(error: unknown, handler?: ListenerErrorHandler): void {\n  if (handler) {\n    try {\n      handler(error);\n    } catch {\n      // A failing error handler must not escape into the notifier either.\n    }\n    return;\n  }\n  process.emitWarning(error instanceof Error ? error : new Error(String(error)));\n}\n\n/** Calls every listener, isolating each from the others' failures. */\nexport function notifyListeners<Value>(\n  listeners: Iterable<(value: Value) => void>,\n  value: Value,\n  onError?: ListenerErrorHandler,\n): void {\n  for (const listener of listeners) {\n    try {\n      listener(value);\n    } catch (error) {\n      reportListenerError(error, onError);\n    }\n  }\n}\n","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 { notifyListeners, type ListenerErrorHandler } from './listener-errors';\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  /**\n   * Receives exceptions thrown by notification and disconnect listeners. Each\n   * listener is isolated, so one failing subscriber never disturbs the others\n   * or fails in-flight requests. Defaults to a process warning.\n   */\n  onListenerError?: ListenerErrorHandler;\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    notifyListeners(this.notificationListeners, notification, this.options.onListenerError);\n    notifyListeners(\n      this.notificationListenersByMethod.get(notification.method) ?? [],\n      notification,\n      this.options.onListenerError,\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    notifyListeners(this.disconnectListeners, error, this.options.onListenerError);\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/generated/v2/ThreadRollbackParams.d.ts

@@ -1,14 +0,0 @@
-/**
- * DEPRECATED: `thread/rollback` will be removed soon.
- */
-export type ThreadRollbackParams = {
-    threadId: string;
-    /**
-     * The number of turns to drop from the end of the thread. Must be >= 1.
-     *
-     * This only modifies the thread's history and does not revert local file changes
-     * that have been made by the agent. Clients are responsible for reverting these changes.
-     */
-    numTurns: number;
-};
-//# sourceMappingURL=ThreadRollbackParams.d.ts.map

package/dist/codex/generated/v2/ThreadRollbackParams.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ThreadRollbackParams.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/ThreadRollbackParams.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IACtD;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAC;CAAE,CAAC"}

package/dist/codex/generated/v2/ThreadRollbackResponse.d.ts

@@ -1,12 +0,0 @@
-import type { Thread } from "./Thread";
-export type ThreadRollbackResponse = {
-    /**
-     * The updated thread after applying the rollback, with `turns` populated.
-     *
-     * The ThreadItems stored in each Turn are lossy since we explicitly do not
-     * persist all agent interactions, such as command executions. This is the same
-     * behavior as `thread/resume`.
-     */
-    thread: Thread;
-};
-//# sourceMappingURL=ThreadRollbackResponse.d.ts.map

package/dist/codex/generated/v2/ThreadRollbackResponse.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ThreadRollbackResponse.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/ThreadRollbackResponse.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,MAAM,MAAM,sBAAsB,GAAG;IACrC;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,CAAC;CAAE,CAAC"}