@opengeni/codex 0.2.10 → 0.2.13

package/dist/fetch.d.ts

@@ -67,9 +67,9 @@ export type CodexSseFailureProjection = {
  * A provider terminal carried inside an accepted HTTP-200 stream. The OpenAI
  * SDK cannot turn that late terminal into a non-2xx APIError because headers
  * have already been accepted, so the body transform throws this equivalent
- * bounded shape. Provider-supplied message/param text is intentionally absent:
- * the worker may persist Error.message, while identifiers/classifications are
- * sufficient for retry, compaction, and incident diagnostics.
+ * bounded shape. Provider-supplied message/param text remains exact within the
+ * explicit terminal-field byte contract; retry classification is additive and
+ * never substitutes for the source diagnostic.
  */
 export declare class CodexStreamingTerminalError extends Error {
     readonly status: number;
@@ -80,5 +80,5 @@ export declare class CodexStreamingTerminalError extends Error {
     readonly responseStatus?: string;
     readonly headers: Headers;
     readonly error: Record<string, unknown>;
-    constructor(projection: CodexSseFailureProjection, publicMessage: string);
+    constructor(projection: CodexSseFailureProjection);
 }

package/dist/index.d.ts

@@ -11,5 +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";

package/dist/index.js

@@ -786,6 +786,27 @@ function isPreHeadersTimeoutError(error) {
 
 // src/fetch.ts
 import { randomUUID } from "crypto";
+
+// src/opaque-artifact.ts
+import { createHash } from "crypto";
+function opaqueProviderArtifactFingerprint(item) {
+  if (!item || typeof item !== "object") return null;
+  const record = item;
+  if (record.type !== "reasoning" && record.type !== "compaction") return null;
+  const providerData = record.providerData && typeof record.providerData === "object" ? record.providerData : null;
+  const ciphertext = typeof record.encrypted_content === "string" && record.encrypted_content || typeof record.encryptedContent === "string" && record.encryptedContent || typeof providerData?.encrypted_content === "string" && providerData.encrypted_content || typeof providerData?.encryptedContent === "string" && providerData.encryptedContent || null;
+  if (!ciphertext) return null;
+  return `${record.type}:${createHash("sha256").update(ciphertext).digest("hex")}`;
+}
+function opaqueProviderArtifactFingerprints(input) {
+  if (!Array.isArray(input)) return [];
+  return input.flatMap((item) => {
+    const fingerprint = opaqueProviderArtifactFingerprint(item);
+    return fingerprint ? [fingerprint] : [];
+  });
+}
+
+// src/fetch.ts
 var CODEX_TRANSPORT_ERROR_HEADER = "x-opengeni-codex-transport-error";
 function headersCarryCodexTransportMarker(headers) {
   if (!headers || typeof headers !== "object") return false;
@@ -1122,6 +1143,7 @@ function codexSubscriptionFetch(base = globalThis.fetch) {
       }
       let callerWantsStream = true;
       let model;
+      let requestOpaqueArtifacts = [];
       const nextInit = { ...init, headers };
       if (typeof init?.body === "string") {
         try {
@@ -1130,24 +1152,22 @@ function codexSubscriptionFetch(base = globalThis.fetch) {
           const normalized = normalizeCodexRequestBody(parsed, ctx.resolveModel);
           model = typeof normalized.model === "string" ? normalized.model : void 0;
           nextInit.body = JSON.stringify(normalized);
+          requestOpaqueArtifacts = opaqueProviderArtifactFingerprints(normalized.input);
         } catch {
         }
       }
+      ctx.onRequestOpaqueArtifacts?.({ requestId, fingerprints: requestOpaqueArtifacts });
       headers.set(
         "Idempotency-Key",
         authenticationAttempt === 0 ? requestId : `${requestId}:auth-${authenticationAttempt}`
       );
       if (process.env.CODEX_DEBUG) {
-        let keys = [];
-        if (typeof nextInit.body === "string") {
-          try {
-            keys = Object.keys(JSON.parse(nextInit.body));
-          } catch {
-          }
-        }
-        console.error(
-          `[codex-debug] POST ${rewritten} stream=${callerWantsStream} bodyKeys=[${keys.join(",")}]`
-        );
+        console.error("[codex-debug] request dispatched", {
+          method: "POST",
+          origin: "codex-subscription",
+          route: "codex_responses",
+          stream: callerWantsStream
+        });
       }
       let res;
       transportAttempt += 1;
@@ -1204,9 +1224,11 @@ function codexSubscriptionFetch(base = globalThis.fetch) {
         ctx.onUsageHeaders?.(usage);
       }
       if (process.env.CODEX_DEBUG && !res.ok) {
-        console.error(
-          `[codex-debug] <- ${res.status} requestId=${res.headers.get("x-request-id") ?? "unknown"}`
-        );
+        console.error("[codex-debug] request failed", {
+          origin: "codex-subscription",
+          route: "codex_responses",
+          status: res.status
+        });
       }
       if (!res.ok) {
         return await bufferCodexErrorResponse(res);
@@ -1468,8 +1490,8 @@ var CodexStreamingTerminalError = class extends Error {
   responseStatus;
   headers;
   error;
-  constructor(projection, publicMessage) {
-    super(publicMessage);
+  constructor(projection) {
+    super(projection.error.message);
     this.name = "CodexStreamingTerminalError";
     this.status = projection.status;
     this.code = projection.error.code;
@@ -1487,6 +1509,8 @@ var CodexStreamingTerminalError = class extends Error {
     this.error = {
       type: projection.error.type,
       code: projection.error.code,
+      message: projection.error.message,
+      ...projection.error.param ? { param: projection.error.param } : {},
       ...projection.error.event_type ? { event_type: projection.error.event_type } : {},
       ...projection.error.response_id ? { response_id: projection.error.response_id } : {},
       ...projection.error.response_status ? { response_status: projection.error.response_status } : {},
@@ -1496,8 +1520,7 @@ var CodexStreamingTerminalError = class extends Error {
 };
 function codexSseFailureError(source, rawError, fallbackCode, publicMessage, metadata = {}) {
   return new CodexStreamingTerminalError(
-    codexSseFailureProjection(source, rawError, fallbackCode, publicMessage, metadata),
-    publicMessage
+    codexSseFailureProjection(source, rawError, fallbackCode, publicMessage, metadata)
   );
 }
 function repairCodexStream(res) {
@@ -1762,13 +1785,15 @@ function inlineStructuredContentInRpcMessage(message) {
     return;
   }
   const structured = record.structuredContent;
-  if (structured === void 0 || structured === null) {
-    return;
+  if (structured !== void 0 && structured !== null) {
+    const text = typeof structured === "string" ? structured : JSON.stringify(structured);
+    const content = Array.isArray(record.content) ? [...record.content] : [];
+    content.push({ type: "text", text });
+    record.content = content;
+  }
+  if (typeof structured !== "object" || structured === null || Array.isArray(structured)) {
+    delete record.structuredContent;
   }
-  const text = typeof structured === "string" ? structured : JSON.stringify(structured);
-  const content = Array.isArray(record.content) ? [...record.content] : [];
-  content.push({ type: "text", text });
-  record.content = content;
 }
 function sanitizeMcpJsonBody(text, mapper = new ToolNameMapper(), namespaceSink) {
   try {
@@ -2607,6 +2632,8 @@ export {
   modelToolOutputSerializationBudgetTokens,
   normalizeCodexRequestBody,
   normalizeCodexUsage,
+  opaqueProviderArtifactFingerprint,
+  opaqueProviderArtifactFingerprints,
   parseCodexRateLimitResetConsumeResponse,
   parseCodexRateLimitResetCreditsDetails,
   parseCodexRateLimitResetCreditsSummary,