@opengeni/codex 0.2.15 → 0.2.17

package/dist/request-context.d.ts

@@ -53,6 +53,7 @@ export type CodexRequestOpaqueArtifacts = {
     requestId: string;
     fingerprints: readonly string[];
 };
+export type CodexRequestPreparationPhase = "transport_entry" | "credential_ready" | "wire_request_ready";
 export type CodexRequestContext = {
     clientVersion: string;
     /**
@@ -83,6 +84,14 @@ export type CodexRequestContext = {
     onUsageHeaders?: (snapshot: CodexUsageHeaderSnapshot) => void;
     /** Optional per-run override, primarily for deterministic transport tests. */
     responseTimeoutPolicy?: Partial<CodexResponseTimeoutPolicy>;
+    /**
+     * Synchronous, best-effort diagnostics for the request lifecycle. This hook
+     * runs before the durable audit sink and MUST remain non-blocking: a throw is
+     * swallowed by the transport and it must never receive request bodies/auth.
+     */
+    onModelRequestDiagnostic?: (event: CodexModelRequestEvent) => void;
+    /** Bounded synchronous checkpoints for pre-network request preparation. */
+    onRequestPreparationDiagnostic?: (phase: CodexRequestPreparationPhase) => void;
     /** Worker-owned durable audit sink; payloads never contain request bodies or auth. */
     onModelRequestEvent?: (event: CodexModelRequestEvent) => Promise<void> | void;
     /** Exact opaque artifacts on the normalized wire request, never their ciphertext. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/codex",
-  "version": "0.2.15",
+  "version": "0.2.17",
   "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": {