@opengeni/codex 0.2.9 → 0.2.11

package/dist/api-client.d.ts

@@ -7,6 +7,8 @@ export type CodexAuthHeaders = {
     clientVersion: string;
 };
 export type ResetCreditFetchFailureReason = "http_error" | "invalid_response" | "network_error" | "timeout";
+/** Server-only headers shared by every ChatGPT/Codex subscription transport. */
+export declare function codexSubscriptionHeaders(a: CodexAuthHeaders): Record<string, string>;
 /** GET /codex/models — login-check + live catalog. A 200 means the token is accepted. spec §1.4/§F */
 export declare function fetchCodexModels(a: CodexAuthHeaders, fetchImpl?: CodexFetch, timeoutMs?: number): Promise<{
     ok: boolean;

package/dist/{chunk-YGKQDUY7.js → chunk-HT463QWA.js}

@@ -22,7 +22,11 @@ var CODEX_AUTO_COMPACTION_PERCENT = 90;
 var CODEX_MODEL_AUTO_COMPACT_TOKEN_LIMIT = Math.floor(
   CODEX_MODEL_CONTEXT_WINDOW_TOKENS * CODEX_AUTO_COMPACTION_PERCENT / 100
 );
-var CODEX_CLIENT_VERSION = "0.144.6";
+var CODEX_CLIENT_VERSION = "0.145.0";
+var CODEX_REALTIME_MODEL = "gpt-live-1-boulder-alpha";
+var CODEX_REALTIME_VERSION = "v3";
+var CODEX_REALTIME_DEFAULT_VOICE = "cove";
+var CODEX_REALTIME_CALL_TIMEOUT_MS = 15e3;
 var CODEX_REFRESH_WINDOW_MS = 5 * 60 * 1e3;
 var CODEX_REFRESH_FALLBACK_MS = 8 * 24 * 60 * 60 * 1e3;
 var CODEX_RESPONSE_HEADERS_TIMEOUT_MS = 4 * 6e4;
@@ -58,6 +62,10 @@ export {
   CODEX_AUTO_COMPACTION_PERCENT,
   CODEX_MODEL_AUTO_COMPACT_TOKEN_LIMIT,
   CODEX_CLIENT_VERSION,
+  CODEX_REALTIME_MODEL,
+  CODEX_REALTIME_VERSION,
+  CODEX_REALTIME_DEFAULT_VOICE,
+  CODEX_REALTIME_CALL_TIMEOUT_MS,
   CODEX_REFRESH_WINDOW_MS,
   CODEX_REFRESH_FALLBACK_MS,
   CODEX_RESPONSE_HEADERS_TIMEOUT_MS,
@@ -72,4 +80,4 @@ export {
   CODEX_APPS_STARTUP_TIMEOUT_MS,
   CODEX_APPS_REQUIRED_SCOPES
 };
-//# sourceMappingURL=chunk-YGKQDUY7.js.map
+//# sourceMappingURL=chunk-HT463QWA.js.map

package/dist/chunk-HT463QWA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants.ts"],"sourcesContent":["// Wire constants for the ChatGPT/Codex subscription backend.\n// Source: CODEX-SUBSCRIPTION-SPEC.md (verified against openai/codex codex-rs).\n\nexport const CODEX_ISSUER = \"https://auth.openai.com\";\nexport const CODEX_CLIENT_ID = \"app_EMoamEEZ73f0CkXaXp7hrann\"; // spec §1.1 (manager.rs:1444)\nexport const CODEX_AUTH_BASE = `${CODEX_ISSUER}/api/accounts`; // device endpoints (device_code_auth.rs:164)\nexport const CODEX_TOKEN_URL = `${CODEX_ISSUER}/oauth/token`; // exchange (form) + refresh (json)\nexport const CODEX_DEVICE_VERIFICATION_URL = `${CODEX_ISSUER}/codex/device`;\nexport const CODEX_DEVICE_REDIRECT_URI = `${CODEX_ISSUER}/deviceauth/callback`;\n\n// Model requests: base already includes /codex; client appends /responses, /models.\nexport const CODEX_RESPONSES_BASE = \"https://chatgpt.com/backend-api/codex\";\n// Usage lives on the WHAM base — NOT under /codex (verified, spec §1.8a).\nexport const CODEX_WHAM_BASE = \"https://chatgpt.com/backend-api\";\n\nexport const CODEX_ORIGINATOR = \"codex_cli_rs\"; // whitelisted originator (spec §1.2)\nexport const CODEX_ID_TOKEN_AUTH_CLAIM = \"https://api.openai.com/auth\";\n\n// Synthetic registry-provider identity. The provider's baseURL is the bare\n// /backend-api (NOT /codex) — codexSubscriptionFetch rewrites /responses ->\n// /codex/responses. Codex model ids are namespaced `codex/<slug>` so they never\n// collide with the built-in OpenAI provider's model ids; the fetch's resolveModel\n// strips the prefix before the slug reaches the backend.\nexport const CODEX_PROVIDER_ID = \"codex-subscription\";\nexport const CODEX_PROVIDER_BASE_URL = \"https://chatgpt.com/backend-api\";\nexport const CODEX_MODEL_ID_PREFIX = \"codex/\";\n\n// The only Codex subscription models OpenGeni exposes. The live GET /models\n// catalog must contain every exact slug; older or internal models never broaden\n// this product allowlist.\nexport const CODEX_FALLBACK_MODEL_SLUGS = [\"gpt-5.6-sol\", \"gpt-5.6-terra\", \"gpt-5.6-luna\"] as const;\n\n// Live Codex model-catalog values for every exposed gpt-5.6 subscription slug.\n// Verified 2026-07-18 against Codex CLI 0.144.6's freshly fetched\n// ~/.codex/models_cache.json and the matching openai/codex core derivations:\n//   raw context window                = 272,000\n//   effective input window (95%)      = 258,400\n//   automatic compaction limit (90%)  = 244,800\n// Keep all three explicit: the effective ceiling is a hard input guard while\n// the lower auto-compact limit is the proactive checkpoint trigger.\nexport const CODEX_MODEL_CONTEXT_WINDOW_TOKENS = 272_000;\nexport const CODEX_EFFECTIVE_CONTEXT_WINDOW_PERCENT = 95;\nexport const CODEX_MODEL_EFFECTIVE_CONTEXT_WINDOW_TOKENS = Math.floor(\n  (CODEX_MODEL_CONTEXT_WINDOW_TOKENS * CODEX_EFFECTIVE_CONTEXT_WINDOW_PERCENT) / 100,\n);\nexport const CODEX_AUTO_COMPACTION_PERCENT = 90;\nexport const CODEX_MODEL_AUTO_COMPACT_TOKEN_LIMIT = Math.floor(\n  (CODEX_MODEL_CONTEXT_WINDOW_TOKENS * CODEX_AUTO_COMPACTION_PERCENT) / 100,\n);\n\n// Sent as the `version` header and inside the User-Agent. Staging-proven on\n// 2026-07-09: 0.142.4 filtered every GPT-5.6 slug out of GET /models, while the\n// official Codex 0.144.0+ releases return all three exact slugs above. Keep\n// this pinned to the latest stable Codex release we have verified end-to-end.\nexport const CODEX_CLIENT_VERSION = \"0.145.0\";\n\n// Native ChatGPT/Codex subscription WebRTC call creation. Verified against\n// openai/codex 0.145.0 commit bd2de422aa287b97b06ca6425a10935bcf1b3731.\nexport const CODEX_REALTIME_MODEL = \"gpt-live-1-boulder-alpha\";\nexport const CODEX_REALTIME_VERSION = \"v3\";\nexport const CODEX_REALTIME_DEFAULT_VOICE = \"cove\";\nexport const CODEX_REALTIME_CALL_TIMEOUT_MS = 15_000;\n\nexport const CODEX_REFRESH_WINDOW_MS = 5 * 60 * 1000; // proactive refresh when within 5 min of exp (spec §1.1)\nexport const CODEX_REFRESH_FALLBACK_MS = 8 * 24 * 60 * 60 * 1000; // 8 days when exp is unparseable\n\n// Codex Responses transport deadlines. The OpenAI SDK's own timeout only covers\n// the wait for response headers and erases the underlying timeout class into the\n// bare `Request timed out.` error. Keep the provider-specific budgets here so\n// the transport can enforce and durably report them without enabling the SDK's\n// blind request replay.\nexport const CODEX_RESPONSE_HEADERS_TIMEOUT_MS = 4 * 60_000;\nexport const CODEX_RESPONSE_STREAM_IDLE_TIMEOUT_MS = 5 * 60_000;\nexport const CODEX_RESPONSE_WHOLE_TIMEOUT_MS = 30 * 60_000;\n// Kept as a compatibility-shaped policy field, but automatic replay is disabled\n// until a provider-specific operation receipt can prove non-acceptance or resume\n// the same operation identity. An absent response does not prove that the\n// provider never accepted the request.\nexport const CODEX_RESPONSE_NO_BYTE_RETRIES = 0;\nexport const CODEX_RESPONSE_RETRY_BACKOFF_MS = 1_000;\n// Must exceed the transport-owned whole-response deadline. This SDK guard is a\n// last-resort envelope; the inner transport emits the typed/durable failure.\nexport const CODEX_RESPONSE_SDK_OUTER_TIMEOUT_MS = 35 * 60_000;\n\n// ── Apps / connectors MCP (spec §1.10, §E) ───────────────────────────────────\n// One server-side MCP exposes ALL the user's ChatGPT/Codex connectors\n// (gmail/github/linear/slack/sentry/drive/calendar/…). Streamable HTTP, always.\nexport const CODEX_APPS_MCP_SERVER_ID = \"codex_apps\"; // tools surface as mcp__codex_apps__<tool>\nexport const CODEX_APPS_MCP_SERVER_NAME = \"codex_apps\"; // MCP `name` — MUST equal the id so the SDK namespaces tools as mcp__codex_apps__*\nexport const CODEX_APPS_MCP_URL = \"https://chatgpt.com/backend-api/ps/mcp\"; // live URL (NOT /codex, NOT the legacy /wham/apps)\nexport const CODEX_APPS_STARTUP_TIMEOUT_MS = 30_000; // startup_timeout 30s (spec §1.10) — maps to timeoutMs on this server only\n// Connector scopes that the apps MCP requires. Present ONLY when granted at\n// browser-authorize time; the device-code path CANNOT be confirmed to grant\n// them, so treat connector availability as runtime-discovered (spec §1.10 / §E).\nexport const CODEX_APPS_REQUIRED_SCOPES = [\"api.connectors.read\", \"api.connectors.invoke\"] as const;\n"],"mappings":";AAGO,IAAM,eAAe;AACrB,IAAM,kBAAkB;AACxB,IAAM,kBAAkB,GAAG,YAAY;AACvC,IAAM,kBAAkB,GAAG,YAAY;AACvC,IAAM,gCAAgC,GAAG,YAAY;AACrD,IAAM,4BAA4B,GAAG,YAAY;AAGjD,IAAM,uBAAuB;AAE7B,IAAM,kBAAkB;AAExB,IAAM,mBAAmB;AACzB,IAAM,4BAA4B;AAOlC,IAAM,oBAAoB;AAC1B,IAAM,0BAA0B;AAChC,IAAM,wBAAwB;AAK9B,IAAM,6BAA6B,CAAC,eAAe,iBAAiB,cAAc;AAUlF,IAAM,oCAAoC;AAC1C,IAAM,yCAAyC;AAC/C,IAAM,8CAA8C,KAAK;AAAA,EAC7D,oCAAoC,yCAA0C;AACjF;AACO,IAAM,gCAAgC;AACtC,IAAM,uCAAuC,KAAK;AAAA,EACtD,oCAAoC,gCAAiC;AACxE;AAMO,IAAM,uBAAuB;AAI7B,IAAM,uBAAuB;AAC7B,IAAM,yBAAyB;AAC/B,IAAM,+BAA+B;AACrC,IAAM,iCAAiC;AAEvC,IAAM,0BAA0B,IAAI,KAAK;AACzC,IAAM,4BAA4B,IAAI,KAAK,KAAK,KAAK;AAOrD,IAAM,oCAAoC,IAAI;AAC9C,IAAM,wCAAwC,IAAI;AAClD,IAAM,kCAAkC,KAAK;AAK7C,IAAM,iCAAiC;AACvC,IAAM,kCAAkC;AAGxC,IAAM,sCAAsC,KAAK;AAKjD,IAAM,2BAA2B;AACjC,IAAM,6BAA6B;AACnC,IAAM,qBAAqB;AAC3B,IAAM,gCAAgC;AAItC,IAAM,6BAA6B,CAAC,uBAAuB,uBAAuB;","names":[]}

package/dist/chunk-MFVGCR3N.js

@@ -0,0 +1,236 @@
+// src/realtime-v3.ts
+var CODEX_REALTIME_INITIAL_ITEMS_MAX_COUNT = 128;
+var CODEX_REALTIME_INITIAL_ITEMS_MAX_TOKENS = 8192;
+var CODEX_REALTIME_CONTEXT_APPEND_MAX_BYTES = 500;
+var CODEX_REALTIME_V3_MAX_EVENT_BYTES = 1048576;
+var CODEX_REALTIME_V3_MAX_IDENTIFIER_BYTES = 1024;
+var CODEX_REALTIME_V3_MAX_TEXT_BYTES = 131072;
+function parseCodexRealtimeV3Event(payload) {
+  if (utf8ByteLength(payload) > CODEX_REALTIME_V3_MAX_EVENT_BYTES) {
+    return failure("oversized_event", null);
+  }
+  let value;
+  try {
+    value = JSON.parse(payload);
+  } catch {
+    return failure("invalid_json", null);
+  }
+  const event = record(value);
+  const typeField = boundedStringField(event, "type", CODEX_REALTIME_V3_MAX_IDENTIFIER_BYTES);
+  if (typeField.oversized) return failure("oversized_field", null);
+  const type = typeField.value;
+  if (!type) return failure("missing_type", null);
+  const providerEventIdField = firstBoundedStringField(
+    event,
+    ["event_id", "id"],
+    CODEX_REALTIME_V3_MAX_IDENTIFIER_BYTES
+  );
+  if (providerEventIdField.oversized) return failure("oversized_field", type);
+  const providerEventId = providerEventIdField.value ?? null;
+  if (type === "session.started" || type === "session.updated") {
+    const session = record(event.session);
+    const sessionIdField = boundedStringField(
+      session,
+      "id",
+      CODEX_REALTIME_V3_MAX_IDENTIFIER_BYTES
+    );
+    const instructionsField = boundedStringField(
+      session,
+      "instructions",
+      CODEX_REALTIME_V3_MAX_TEXT_BYTES
+    );
+    if (sessionIdField.oversized || instructionsField.oversized) {
+      return failure("oversized_field", type);
+    }
+    const sessionId = sessionIdField.value;
+    if (!sessionId) return failure("invalid_shape", type);
+    return {
+      ok: true,
+      event: {
+        type,
+        providerEventId,
+        sessionId,
+        instructions: instructionsField.value ?? null
+      }
+    };
+  }
+  if (type === "input_transcript.added" || type === "output_transcript.added") {
+    const item = record(event.item);
+    const itemIdField = boundedStringField(item, "id", CODEX_REALTIME_V3_MAX_IDENTIFIER_BYTES);
+    const textField = boundedStringField(item, "text", CODEX_REALTIME_V3_MAX_TEXT_BYTES);
+    if (itemIdField.oversized || textField.oversized) {
+      return failure("oversized_field", type);
+    }
+    const text = textField.value;
+    if (text === void 0) return failure("invalid_shape", type);
+    return {
+      ok: true,
+      event: {
+        type,
+        providerEventId,
+        itemId: itemIdField.value ?? null,
+        text
+      }
+    };
+  }
+  if (type === "output_audio.delta") {
+    const audio = stringField(event, "audio");
+    if (audio === void 0) return failure("invalid_shape", type);
+    return {
+      ok: true,
+      event: {
+        type,
+        providerEventId,
+        audio,
+        startMs: finiteNumberField(event, "start_ms"),
+        endMs: finiteNumberField(event, "end_ms")
+      }
+    };
+  }
+  if (type === "turn.done") {
+    const turn = record(event.turn);
+    const turnIdField = boundedStringField(turn, "id", CODEX_REALTIME_V3_MAX_IDENTIFIER_BYTES);
+    const transcriptField = boundedStringField(
+      turn,
+      "transcript",
+      CODEX_REALTIME_V3_MAX_TEXT_BYTES
+    );
+    if (turnIdField.oversized || transcriptField.oversized) {
+      return failure("oversized_field", type);
+    }
+    const turnId = turnIdField.value;
+    const role = stringField(turn, "role");
+    const transcript = transcriptField.value;
+    if (!turnId || role !== "user" && role !== "assistant" || transcript === void 0) {
+      return failure("invalid_shape", type);
+    }
+    return {
+      ok: true,
+      event: { type, providerEventId, turnId, role, transcript }
+    };
+  }
+  if (type === "delegation.created") {
+    const item = record(event.item);
+    const delegationItemIdField = boundedStringField(
+      item,
+      "id",
+      CODEX_REALTIME_V3_MAX_IDENTIFIER_BYTES
+    );
+    if (delegationItemIdField.oversized) return failure("oversized_field", type);
+    const delegationItemId = delegationItemIdField.value;
+    if (!delegationItemId || stringField(item, "type") !== "delegation" || stringField(item, "target") !== "client" || !Array.isArray(item.content)) {
+      return failure("invalid_shape", type);
+    }
+    const inputParts = [];
+    let inputBytes = 0;
+    for (const rawContent of item.content) {
+      const content = record(rawContent);
+      if (stringField(content, "type") !== "input_text") continue;
+      const textField = boundedStringField(content, "text", CODEX_REALTIME_V3_MAX_TEXT_BYTES);
+      if (textField.oversized) return failure("oversized_field", type);
+      const text = textField.value ?? "";
+      inputBytes += utf8ByteLength(text);
+      if (inputBytes > CODEX_REALTIME_V3_MAX_TEXT_BYTES) {
+        return failure("oversized_field", type);
+      }
+      inputParts.push(text);
+    }
+    const inputTranscript = inputParts.join("");
+    return {
+      ok: true,
+      event: {
+        type,
+        providerEventId,
+        delegationItemId,
+        inputTranscript,
+        offsetMs: finiteNumberField(event, "offset_ms")
+      }
+    };
+  }
+  if (type === "error") {
+    const nested = record(event.error);
+    const message = stringField(event, "message") ?? stringField(nested, "message") ?? (event.error === void 0 ? void 0 : JSON.stringify(event.error));
+    if (message === void 0) return failure("invalid_shape", type);
+    if (utf8ByteLength(message) > CODEX_REALTIME_V3_MAX_TEXT_BYTES) {
+      return failure("oversized_field", type);
+    }
+    return { ok: true, event: { type, providerEventId, message } };
+  }
+  return failure("unsupported_type", type);
+}
+function encodeCodexRealtimeV3DelegationContextAppend(input) {
+  return contextAppendChunks(input.text).map((text) => ({
+    type: "delegation.context.append",
+    delegation_item_id: input.delegationItemId,
+    ...input.channel ? { channel: input.channel } : {},
+    content: [{ type: "input_text", text }]
+  }));
+}
+function encodeCodexRealtimeV3SessionContextAppend(input) {
+  return contextAppendChunks(input.text).map((text) => ({
+    type: "session.context.append",
+    ...input.channel ? { channel: input.channel } : {},
+    content: [{ type: "input_text", text }]
+  }));
+}
+function contextAppendChunks(text) {
+  if (utf8ByteLength(text) <= CODEX_REALTIME_CONTEXT_APPEND_MAX_BYTES) return [text];
+  const chunks = [];
+  let chunk = "";
+  let bytes = 0;
+  for (const character of text) {
+    const characterBytes = utf8ByteLength(character);
+    if (bytes + characterBytes > CODEX_REALTIME_CONTEXT_APPEND_MAX_BYTES && chunk) {
+      chunks.push(chunk);
+      chunk = "";
+      bytes = 0;
+    }
+    chunk += character;
+    bytes += characterBytes;
+  }
+  if (chunk || text.length === 0) chunks.push(chunk);
+  return chunks;
+}
+function utf8ByteLength(value) {
+  return new TextEncoder().encode(value).byteLength;
+}
+function failure(reason, eventType) {
+  return { ok: false, reason, eventType };
+}
+function record(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function stringField(value, key) {
+  return typeof value[key] === "string" ? value[key] : void 0;
+}
+function boundedStringField(value, key, maxBytes) {
+  const candidate = stringField(value, key);
+  return {
+    value: candidate,
+    oversized: candidate !== void 0 && utf8ByteLength(candidate) > maxBytes
+  };
+}
+function firstBoundedStringField(value, keys, maxBytes) {
+  for (const key of keys) {
+    if (typeof value[key] === "string") return boundedStringField(value, key, maxBytes);
+  }
+  return { value: void 0, oversized: false };
+}
+function finiteNumberField(value, key) {
+  const candidate = value[key];
+  return typeof candidate === "number" && Number.isFinite(candidate) ? candidate : null;
+}
+
+export {
+  CODEX_REALTIME_INITIAL_ITEMS_MAX_COUNT,
+  CODEX_REALTIME_INITIAL_ITEMS_MAX_TOKENS,
+  CODEX_REALTIME_CONTEXT_APPEND_MAX_BYTES,
+  CODEX_REALTIME_V3_MAX_EVENT_BYTES,
+  CODEX_REALTIME_V3_MAX_IDENTIFIER_BYTES,
+  CODEX_REALTIME_V3_MAX_TEXT_BYTES,
+  parseCodexRealtimeV3Event,
+  encodeCodexRealtimeV3DelegationContextAppend,
+  encodeCodexRealtimeV3SessionContextAppend,
+  contextAppendChunks
+};
+//# sourceMappingURL=chunk-MFVGCR3N.js.map

package/dist/chunk-MFVGCR3N.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/realtime-v3.ts"],"sourcesContent":["/**\n * Codex GPT-Live Frameless Bidi (V3) wire adapter.\n *\n * These shapes are pinned to openai/codex@fa1d4c40. V3 delegates work with\n * `delegation.created`; it does not expose the ordinary Realtime V2\n * `function_call` protocol.\n */\n\nexport const CODEX_REALTIME_INITIAL_ITEMS_MAX_COUNT = 128;\nexport const CODEX_REALTIME_INITIAL_ITEMS_MAX_TOKENS = 8_192;\nexport const CODEX_REALTIME_CONTEXT_APPEND_MAX_BYTES = 500;\nexport const CODEX_REALTIME_V3_MAX_EVENT_BYTES = 1_048_576;\nexport const CODEX_REALTIME_V3_MAX_IDENTIFIER_BYTES = 1_024;\nexport const CODEX_REALTIME_V3_MAX_TEXT_BYTES = 131_072;\n\nexport type CodexRealtimeInitialItem = {\n  role: \"user\" | \"developer\" | \"assistant\";\n  text: string;\n};\n\ntype ProviderEventIdentity = {\n  providerEventId: string | null;\n};\n\nexport type CodexRealtimeV3Event =\n  | (ProviderEventIdentity & {\n      type: \"session.started\" | \"session.updated\";\n      sessionId: string;\n      instructions: string | null;\n    })\n  | (ProviderEventIdentity & {\n      type: \"input_transcript.added\" | \"output_transcript.added\";\n      itemId: string | null;\n      text: string;\n    })\n  | (ProviderEventIdentity & {\n      type: \"output_audio.delta\";\n      audio: string;\n      startMs: number | null;\n      endMs: number | null;\n    })\n  | (ProviderEventIdentity & {\n      type: \"turn.done\";\n      turnId: string;\n      role: \"user\" | \"assistant\";\n      transcript: string;\n    })\n  | (ProviderEventIdentity & {\n      type: \"delegation.created\";\n      delegationItemId: string;\n      inputTranscript: string;\n      offsetMs: number | null;\n    })\n  | (ProviderEventIdentity & {\n      type: \"error\";\n      message: string;\n    });\n\nexport type CodexRealtimeV3ParseFailure = {\n  ok: false;\n  reason:\n    | \"invalid_json\"\n    | \"missing_type\"\n    | \"unsupported_type\"\n    | \"invalid_shape\"\n    | \"oversized_event\"\n    | \"oversized_field\";\n  eventType: string | null;\n};\n\nexport type CodexRealtimeV3ParseResult =\n  | { ok: true; event: CodexRealtimeV3Event }\n  | CodexRealtimeV3ParseFailure;\n\nexport type CodexRealtimeV3ContextAppendChannel = \"speakable\" | \"commentary\";\n\nexport type CodexRealtimeV3DelegationContextAppend = {\n  type: \"delegation.context.append\";\n  delegation_item_id: string;\n  channel?: CodexRealtimeV3ContextAppendChannel | undefined;\n  content: Array<{ type: \"input_text\"; text: string }>;\n};\n\nexport type CodexRealtimeV3SessionContextAppend = {\n  type: \"session.context.append\";\n  channel?: CodexRealtimeV3ContextAppendChannel | undefined;\n  content: Array<{ type: \"input_text\"; text: string }>;\n};\n\nexport function parseCodexRealtimeV3Event(payload: string): CodexRealtimeV3ParseResult {\n  if (utf8ByteLength(payload) > CODEX_REALTIME_V3_MAX_EVENT_BYTES) {\n    return failure(\"oversized_event\", null);\n  }\n  let value: unknown;\n  try {\n    value = JSON.parse(payload);\n  } catch {\n    return failure(\"invalid_json\", null);\n  }\n  const event = record(value);\n  const typeField = boundedStringField(event, \"type\", CODEX_REALTIME_V3_MAX_IDENTIFIER_BYTES);\n  if (typeField.oversized) return failure(\"oversized_field\", null);\n  const type = typeField.value;\n  if (!type) return failure(\"missing_type\", null);\n  const providerEventIdField = firstBoundedStringField(\n    event,\n    [\"event_id\", \"id\"],\n    CODEX_REALTIME_V3_MAX_IDENTIFIER_BYTES,\n  );\n  if (providerEventIdField.oversized) return failure(\"oversized_field\", type);\n  const providerEventId = providerEventIdField.value ?? null;\n\n  if (type === \"session.started\" || type === \"session.updated\") {\n    const session = record(event.session);\n    const sessionIdField = boundedStringField(\n      session,\n      \"id\",\n      CODEX_REALTIME_V3_MAX_IDENTIFIER_BYTES,\n    );\n    const instructionsField = boundedStringField(\n      session,\n      \"instructions\",\n      CODEX_REALTIME_V3_MAX_TEXT_BYTES,\n    );\n    if (sessionIdField.oversized || instructionsField.oversized) {\n      return failure(\"oversized_field\", type);\n    }\n    const sessionId = sessionIdField.value;\n    if (!sessionId) return failure(\"invalid_shape\", type);\n    return {\n      ok: true,\n      event: {\n        type,\n        providerEventId,\n        sessionId,\n        instructions: instructionsField.value ?? null,\n      },\n    };\n  }\n\n  if (type === \"input_transcript.added\" || type === \"output_transcript.added\") {\n    const item = record(event.item);\n    const itemIdField = boundedStringField(item, \"id\", CODEX_REALTIME_V3_MAX_IDENTIFIER_BYTES);\n    const textField = boundedStringField(item, \"text\", CODEX_REALTIME_V3_MAX_TEXT_BYTES);\n    if (itemIdField.oversized || textField.oversized) {\n      return failure(\"oversized_field\", type);\n    }\n    const text = textField.value;\n    if (text === undefined) return failure(\"invalid_shape\", type);\n    return {\n      ok: true,\n      event: {\n        type,\n        providerEventId,\n        itemId: itemIdField.value ?? null,\n        text,\n      },\n    };\n  }\n\n  if (type === \"output_audio.delta\") {\n    const audio = stringField(event, \"audio\");\n    if (audio === undefined) return failure(\"invalid_shape\", type);\n    return {\n      ok: true,\n      event: {\n        type,\n        providerEventId,\n        audio,\n        startMs: finiteNumberField(event, \"start_ms\"),\n        endMs: finiteNumberField(event, \"end_ms\"),\n      },\n    };\n  }\n\n  if (type === \"turn.done\") {\n    const turn = record(event.turn);\n    const turnIdField = boundedStringField(turn, \"id\", CODEX_REALTIME_V3_MAX_IDENTIFIER_BYTES);\n    const transcriptField = boundedStringField(\n      turn,\n      \"transcript\",\n      CODEX_REALTIME_V3_MAX_TEXT_BYTES,\n    );\n    if (turnIdField.oversized || transcriptField.oversized) {\n      return failure(\"oversized_field\", type);\n    }\n    const turnId = turnIdField.value;\n    const role = stringField(turn, \"role\");\n    const transcript = transcriptField.value;\n    if (!turnId || (role !== \"user\" && role !== \"assistant\") || transcript === undefined) {\n      return failure(\"invalid_shape\", type);\n    }\n    return {\n      ok: true,\n      event: { type, providerEventId, turnId, role, transcript },\n    };\n  }\n\n  if (type === \"delegation.created\") {\n    const item = record(event.item);\n    const delegationItemIdField = boundedStringField(\n      item,\n      \"id\",\n      CODEX_REALTIME_V3_MAX_IDENTIFIER_BYTES,\n    );\n    if (delegationItemIdField.oversized) return failure(\"oversized_field\", type);\n    const delegationItemId = delegationItemIdField.value;\n    if (\n      !delegationItemId ||\n      stringField(item, \"type\") !== \"delegation\" ||\n      stringField(item, \"target\") !== \"client\" ||\n      !Array.isArray(item.content)\n    ) {\n      return failure(\"invalid_shape\", type);\n    }\n    const inputParts: string[] = [];\n    let inputBytes = 0;\n    for (const rawContent of item.content) {\n      const content = record(rawContent);\n      if (stringField(content, \"type\") !== \"input_text\") continue;\n      const textField = boundedStringField(content, \"text\", CODEX_REALTIME_V3_MAX_TEXT_BYTES);\n      if (textField.oversized) return failure(\"oversized_field\", type);\n      const text = textField.value ?? \"\";\n      inputBytes += utf8ByteLength(text);\n      if (inputBytes > CODEX_REALTIME_V3_MAX_TEXT_BYTES) {\n        return failure(\"oversized_field\", type);\n      }\n      inputParts.push(text);\n    }\n    const inputTranscript = inputParts.join(\"\");\n    return {\n      ok: true,\n      event: {\n        type,\n        providerEventId,\n        delegationItemId,\n        inputTranscript,\n        offsetMs: finiteNumberField(event, \"offset_ms\"),\n      },\n    };\n  }\n\n  if (type === \"error\") {\n    const nested = record(event.error);\n    const message =\n      stringField(event, \"message\") ??\n      stringField(nested, \"message\") ??\n      (event.error === undefined ? undefined : JSON.stringify(event.error));\n    if (message === undefined) return failure(\"invalid_shape\", type);\n    if (utf8ByteLength(message) > CODEX_REALTIME_V3_MAX_TEXT_BYTES) {\n      return failure(\"oversized_field\", type);\n    }\n    return { ok: true, event: { type, providerEventId, message } };\n  }\n\n  return failure(\"unsupported_type\", type);\n}\n\nexport function encodeCodexRealtimeV3DelegationContextAppend(input: {\n  delegationItemId: string;\n  text: string;\n  channel?: CodexRealtimeV3ContextAppendChannel | undefined;\n}): CodexRealtimeV3DelegationContextAppend[] {\n  return contextAppendChunks(input.text).map((text) => ({\n    type: \"delegation.context.append\",\n    delegation_item_id: input.delegationItemId,\n    ...(input.channel ? { channel: input.channel } : {}),\n    content: [{ type: \"input_text\", text }],\n  }));\n}\n\nexport function encodeCodexRealtimeV3SessionContextAppend(input: {\n  text: string;\n  channel?: CodexRealtimeV3ContextAppendChannel | undefined;\n}): CodexRealtimeV3SessionContextAppend[] {\n  return contextAppendChunks(input.text).map((text) => ({\n    type: \"session.context.append\",\n    ...(input.channel ? { channel: input.channel } : {}),\n    content: [{ type: \"input_text\", text }],\n  }));\n}\n\nexport function contextAppendChunks(text: string): string[] {\n  if (utf8ByteLength(text) <= CODEX_REALTIME_CONTEXT_APPEND_MAX_BYTES) return [text];\n  const chunks: string[] = [];\n  let chunk = \"\";\n  let bytes = 0;\n  for (const character of text) {\n    const characterBytes = utf8ByteLength(character);\n    if (bytes + characterBytes > CODEX_REALTIME_CONTEXT_APPEND_MAX_BYTES && chunk) {\n      chunks.push(chunk);\n      chunk = \"\";\n      bytes = 0;\n    }\n    chunk += character;\n    bytes += characterBytes;\n  }\n  if (chunk || text.length === 0) chunks.push(chunk);\n  return chunks;\n}\n\nfunction utf8ByteLength(value: string): number {\n  return new TextEncoder().encode(value).byteLength;\n}\n\nfunction failure(\n  reason: CodexRealtimeV3ParseFailure[\"reason\"],\n  eventType: string | null,\n): CodexRealtimeV3ParseFailure {\n  return { ok: false, reason, eventType };\n}\n\nfunction record(value: unknown): Record<string, unknown> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : {};\n}\n\nfunction stringField(value: Record<string, unknown>, key: string): string | undefined {\n  return typeof value[key] === \"string\" ? value[key] : undefined;\n}\n\nfunction boundedStringField(\n  value: Record<string, unknown>,\n  key: string,\n  maxBytes: number,\n): { value: string | undefined; oversized: boolean } {\n  const candidate = stringField(value, key);\n  return {\n    value: candidate,\n    oversized: candidate !== undefined && utf8ByteLength(candidate) > maxBytes,\n  };\n}\n\nfunction firstBoundedStringField(\n  value: Record<string, unknown>,\n  keys: readonly string[],\n  maxBytes: number,\n): { value: string | undefined; oversized: boolean } {\n  for (const key of keys) {\n    if (typeof value[key] === \"string\") return boundedStringField(value, key, maxBytes);\n  }\n  return { value: undefined, oversized: false };\n}\n\nfunction finiteNumberField(value: Record<string, unknown>, key: string): number | null {\n  const candidate = value[key];\n  return typeof candidate === \"number\" && Number.isFinite(candidate) ? candidate : null;\n}\n"],"mappings":"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","names":[]}

package/dist/constants.d.ts

@@ -17,7 +17,11 @@ export declare const CODEX_EFFECTIVE_CONTEXT_WINDOW_PERCENT = 95;
 export declare const CODEX_MODEL_EFFECTIVE_CONTEXT_WINDOW_TOKENS: number;
 export declare const CODEX_AUTO_COMPACTION_PERCENT = 90;
 export declare const CODEX_MODEL_AUTO_COMPACT_TOKEN_LIMIT: number;
-export declare const CODEX_CLIENT_VERSION = "0.144.6";
+export declare const CODEX_CLIENT_VERSION = "0.145.0";
+export declare const CODEX_REALTIME_MODEL = "gpt-live-1-boulder-alpha";
+export declare const CODEX_REALTIME_VERSION = "v3";
+export declare const CODEX_REALTIME_DEFAULT_VOICE = "cove";
+export declare const CODEX_REALTIME_CALL_TIMEOUT_MS = 15000;
 export declare const CODEX_REFRESH_WINDOW_MS: number;
 export declare const CODEX_REFRESH_FALLBACK_MS: number;
 export declare const CODEX_RESPONSE_HEADERS_TIMEOUT_MS: number;

package/dist/constants.js

@@ -21,6 +21,10 @@ import {
   CODEX_ORIGINATOR,
   CODEX_PROVIDER_BASE_URL,
   CODEX_PROVIDER_ID,
+  CODEX_REALTIME_CALL_TIMEOUT_MS,
+  CODEX_REALTIME_DEFAULT_VOICE,
+  CODEX_REALTIME_MODEL,
+  CODEX_REALTIME_VERSION,
   CODEX_REFRESH_FALLBACK_MS,
   CODEX_REFRESH_WINDOW_MS,
   CODEX_RESPONSES_BASE,
@@ -32,7 +36,7 @@ import {
   CODEX_RESPONSE_WHOLE_TIMEOUT_MS,
   CODEX_TOKEN_URL,
   CODEX_WHAM_BASE
-} from "./chunk-YGKQDUY7.js";
+} from "./chunk-HT463QWA.js";
 export {
   CODEX_APPS_MCP_SERVER_ID,
   CODEX_APPS_MCP_SERVER_NAME,
@@ -56,6 +60,10 @@ export {
   CODEX_ORIGINATOR,
   CODEX_PROVIDER_BASE_URL,
   CODEX_PROVIDER_ID,
+  CODEX_REALTIME_CALL_TIMEOUT_MS,
+  CODEX_REALTIME_DEFAULT_VOICE,
+  CODEX_REALTIME_MODEL,
+  CODEX_REALTIME_VERSION,
   CODEX_REFRESH_FALLBACK_MS,
   CODEX_REFRESH_WINDOW_MS,
   CODEX_RESPONSES_BASE,

package/dist/index.d.ts

@@ -11,3 +11,6 @@ export * from "./response-timeout";
 export * from "./fetch";
 export * from "./mcp-sanitize";
 export * from "./model-output-truncation";
+export * from "./opaque-artifact";
+export * from "./realtime";
+export * from "./realtime-v3";