@opengeni/codex 0.2.25 → 0.2.26-canary.36199476632001

package/dist/model-output-truncation.d.ts

@@ -18,6 +18,7 @@
  * runtime request seam and the database history boundary call the same pure
  * function, so replayed conversation truth is identical to live model input.
  */
+import { type HostedCallStatusItemType } from "./hosted-call-status.js";
 export { MODEL_TOOL_OUTPUT_OVERSIZED_IMAGE_CARD_DATA_URL } from "./oversized-image-card.js";
 export type ModelHistoryItem = Record<string, unknown>;
 type WithoutOutputOnlyProviderDataFields<T> = T extends ModelHistoryItem ? Omit<T, "status"> : T;
@@ -28,15 +29,18 @@ type WithoutOutputOnlyProviderDataField<T extends ModelHistoryItem> = "providerD
 } : {
     providerData: WithoutOutputOnlyProviderDataFields<T["providerData"]>;
 } : object;
-type WithoutOutputOnlyHistoryItemFields<T extends ModelHistoryItem> = T extends unknown ? Omit<T, "status" | "providerData"> & WithoutOutputOnlyProviderDataField<T> : never;
+type WithoutOutputOnlyHistoryItemFields<T extends ModelHistoryItem> = T extends unknown ? T extends {
+    type: HostedCallStatusItemType;
+} ? T : Omit<T, "status" | "providerData"> & WithoutOutputOnlyProviderDataField<T> : never;
 /**
  * Responses output items carry `status` (`in_progress` / `completed` /
  * `incomplete`). That field is not conversation meaning — pairing is `call_id`
  * — and Codex's input schema 400s it (`Unknown parameter: 'input[N].status'`).
  * SuperGrok accepts items with or without it. The SDK also nests `status` on
  * `providerData` (reasoning items) and flattens it back onto the request.
- * Canonical history therefore omits both at persist so portable sessions can
- * cross Responses providers.
+ * Canonical history omits both for those items so portable sessions can cross
+ * Responses providers. Hosted tool calls are different: the provider requires
+ * their status on replay, and the SDK reads it to reconstruct the wire item.
  */
 export declare function omitOutputOnlyHistoryItemFields<T extends ModelHistoryItem>(item: T): WithoutOutputOnlyHistoryItemFields<T>;
 /** Persist/replay boundary: drop output-only fields, then bound tool output. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/codex",
-  "version": "0.2.25",
+  "version": "0.2.26-canary.36199476632001",
   "description": "ChatGPT/Codex subscription auth + transport: device-code login, token refresh, and the Responses-backend fetch. Pure HTTP + transforms; no database dependency.",
   "license": "Apache-2.0",
   "repository": {
@@ -41,7 +41,8 @@
     "prepublishOnly": "bash ../../scripts/prepublish-guard"
   },
   "dependencies": {
-    "@opengeni/network": "^0.3.1",
+    "@opengeni/contracts": "^5.1.1-canary.36199476632001",
+    "@opengeni/network": "^0.3.1-canary.36199476632001",
     "zod": "^4.2.1"
   },
   "engines": {

package/src/hosted-call-status.ts

@@ -0,0 +1,17 @@
+/** Hosted Responses calls require status on replay, unlike function/message annotations. */
+export type HostedCallStatusItemType =
+  | "hosted_tool_call"
+  | "web_search_call"
+  | "file_search_call"
+  | "code_interpreter_call"
+  | "image_generation_call";
+
+export function preservesHostedCallStatus(type: unknown): type is HostedCallStatusItemType {
+  return (
+    type === "hosted_tool_call" ||
+    type === "web_search_call" ||
+    type === "file_search_call" ||
+    type === "code_interpreter_call" ||
+    type === "image_generation_call"
+  );
+}

package/src/model-output-truncation.ts

@@ -20,6 +20,8 @@
  */
 
 import { MODEL_TOOL_OUTPUT_OVERSIZED_IMAGE_CARD_DATA_URL } from "./oversized-image-card";
+import { RetainedArtifactMetadataSchema } from "@opengeni/contracts";
+import { preservesHostedCallStatus, type HostedCallStatusItemType } from "./hosted-call-status";
 
 export { MODEL_TOOL_OUTPUT_OVERSIZED_IMAGE_CARD_DATA_URL } from "./oversized-image-card";
 
@@ -42,7 +44,9 @@ type WithoutOutputOnlyProviderDataField<T extends ModelHistoryItem> = "providerD
   : object;
 
 type WithoutOutputOnlyHistoryItemFields<T extends ModelHistoryItem> = T extends unknown
-  ? Omit<T, "status" | "providerData"> & WithoutOutputOnlyProviderDataField<T>
+  ? T extends { type: HostedCallStatusItemType }
+    ? T
+    : Omit<T, "status" | "providerData"> & WithoutOutputOnlyProviderDataField<T>
   : never;
 
 /**
@@ -51,8 +55,9 @@ type WithoutOutputOnlyHistoryItemFields<T extends ModelHistoryItem> = T extends
  * — and Codex's input schema 400s it (`Unknown parameter: 'input[N].status'`).
  * SuperGrok accepts items with or without it. The SDK also nests `status` on
  * `providerData` (reasoning items) and flattens it back onto the request.
- * Canonical history therefore omits both at persist so portable sessions can
- * cross Responses providers.
+ * Canonical history omits both for those items so portable sessions can cross
+ * Responses providers. Hosted tool calls are different: the provider requires
+ * their status on replay, and the SDK reads it to reconstruct the wire item.
  */
 export function omitOutputOnlyHistoryItemFields<T extends ModelHistoryItem>(
   item: T,
@@ -60,6 +65,9 @@ export function omitOutputOnlyHistoryItemFields<T extends ModelHistoryItem>(
   if (!item || typeof item !== "object") {
     return item as unknown as WithoutOutputOnlyHistoryItemFields<T>;
   }
+  if (preservesHostedCallStatus(item.type)) {
+    return item as unknown as WithoutOutputOnlyHistoryItemFields<T>;
+  }
   const providerData =
     item.providerData && typeof item.providerData === "object"
       ? (item.providerData as Record<string, unknown>)
@@ -402,6 +410,16 @@ function boundTextLeaves(
     return bounded;
   }
   if (!value || typeof value !== "object") return value;
+  // Screenshot receipts are image protocol, not model-visible text. They are
+  // compact, schema-bounded references whose fields must survive a zero text
+  // budget so a resumed turn can materialize the image from durable storage.
+  if (
+    !Array.isArray(value) &&
+    (value as Record<string, unknown>).type === "retained_artifact" &&
+    RetainedArtifactMetadataSchema.safeParse((value as Record<string, unknown>).artifact).success
+  ) {
+    return value;
+  }
   if (depth >= MODEL_TOOL_OUTPUT_MAX_DEPTH) return DEPTH_OMISSION_MARKER;
   if (state.seen.has(value)) return CYCLE_OMISSION_MARKER;
   state.seen.add(value);

package/src/normalize.ts

@@ -7,7 +7,8 @@
 //   - strip max_output_tokens / max_completion_tokens
 //   - reasoning effort minimal -> low
 //   - normalize the model slug (longest-prefix against the live catalog)
-//   - strip every item `id` and `status` but PRESERVE `call_id`
+//   - strip every item `id` and output-only `status` but PRESERVE `call_id`
+//     and the required status of hosted tool calls
 // We do NOT filter item_reference (the SDK never emits it) and do NOT convert
 // orphaned tool outputs (the SDK's runner already prunes by call_id).
 //
@@ -16,6 +17,8 @@
 // schema 400s `Unknown parameter: 'input[N].status'` — observed live on a
 // portable SuperGrok → Codex switch. Pairing uses `call_id`, never `status`.
 
+import { preservesHostedCallStatus } from "./hosted-call-status";
+
 const MINIMAL = "minimal";
 
 // The ChatGPT/Codex backend is a STRICT ALLOWLIST: it 400s on ANY top-level field
@@ -71,13 +74,13 @@ export function normalizeCodexRequestBody(
     body.model = resolveModel(body.model);
   }
 
-  // strip every item id and status; PRESERVE call_id. spec §1.6 / verdict §0(b)
+  // Strip item ids and output-only status; preserve call_id and hosted status.
   // (This also covers tool_search items: the backend accepts an id-less
   // tool_search_call/output pair correlated by call_id — verified live — and
   // stripping the provider-stored `tsc_…` id here sanitizes BOTH replay paths.)
-  // `status` is output-only on Codex input items. New rows omit it at persist;
-  // this wire strip remains defense for already-stored SuperGrok rows and
-  // mid-turn SDK items.
+  // Hosted web/file search, code interpreter and image-generation items require
+  // their actual status on replay. Never turn an absent status into a fabricated
+  // completion. Other items retain the portable-history compatibility strip.
   if (Array.isArray(body.input)) {
     for (const item of body.input as unknown[]) {
       if (!item || typeof item !== "object") {
@@ -87,7 +90,7 @@ export function normalizeCodexRequestBody(
       if ("id" in record) {
         delete record.id;
       }
-      if ("status" in record) {
+      if ("status" in record && !preservesHostedCallStatus(record.type)) {
         delete record.status;
       }
       // A replayed tool_search_call must carry `arguments` as an OBJECT — the