ai-sdk-provider-codex-cli 0.4.0 → 0.5.0

package/README.md

@@ -15,6 +15,7 @@ A community provider for Vercel AI SDK v5 that uses OpenAI’s Codex CLI (non‑
 - Works with `generateText`, `streamText`, and `generateObject` (native JSON Schema support via `--output-schema`)
 - Uses ChatGPT OAuth from `codex login` (tokens in `~/.codex/auth.json`) or `OPENAI_API_KEY`
 - Node-only (spawns a local process); supports CI and local dev
+- **v0.5.0**: Adds comprehensive logging system with verbose mode and custom logger support
 - **v0.3.0**: Adds comprehensive tool streaming support for monitoring autonomous tool execution
 - **v0.2.0 Breaking Changes**: Switched to `--experimental-json` and native schema enforcement (see [CHANGELOG](CHANGELOG.md))
 
@@ -96,6 +97,7 @@ console.log(object);
 
 - AI SDK v5 compatible (LanguageModelV2)
 - Streaming and non‑streaming
+- **Configurable logging** (v0.5.0+) - Verbose mode, custom loggers, or silent operation
 - **Tool streaming support** (v0.3.0+) - Monitor autonomous tool execution in real-time
 - **Native JSON Schema support** via `--output-schema` (API-enforced with `strict: true`)
 - JSON object generation with Zod schemas (100-200 fewer tokens per request vs prompt engineering)
@@ -135,6 +137,58 @@ for await (const part of result.fullStream) {
 
 **Limitation:** Real-time output streaming (`output-delta` events) not yet available. Tool outputs delivered in final `tool-result` event. See `examples/streaming-tool-calls.mjs` and `examples/streaming-multiple-tools.mjs` for usage patterns.
 
+### Logging Configuration (v0.5.0+)
+
+Control logging verbosity and integrate with your observability stack:
+
+```js
+import { codexCli } from 'ai-sdk-provider-codex-cli';
+
+// Default: warn/error only (clean production output)
+const model = codexCli('gpt-5-codex', {
+  allowNpx: true,
+  skipGitRepoCheck: true,
+});
+
+// Verbose mode: enable debug/info logs for troubleshooting
+const verboseModel = codexCli('gpt-5-codex', {
+  allowNpx: true,
+  skipGitRepoCheck: true,
+  verbose: true, // Shows all log levels
+});
+
+// Custom logger: integrate with Winston, Pino, Datadog, etc.
+const customModel = codexCli('gpt-5-codex', {
+  allowNpx: true,
+  skipGitRepoCheck: true,
+  verbose: true,
+  logger: {
+    debug: (msg) => myLogger.debug('Codex:', msg),
+    info: (msg) => myLogger.info('Codex:', msg),
+    warn: (msg) => myLogger.warn('Codex:', msg),
+    error: (msg) => myLogger.error('Codex:', msg),
+  },
+});
+
+// Silent: disable all logging
+const silentModel = codexCli('gpt-5-codex', {
+  allowNpx: true,
+  skipGitRepoCheck: true,
+  logger: false, // No logs at all
+});
+```
+
+**Log Levels:**
+
+- `debug`: Detailed execution traces (verbose mode only)
+- `info`: General execution flow (verbose mode only)
+- `warn`: Warnings and misconfigurations (always shown)
+- `error`: Errors and failures (always shown)
+
+**Default Logger:** Adds level tags `[DEBUG]`, `[INFO]`, `[WARN]`, `[ERROR]` to console output. Use a custom logger or `logger: false` if you need different formatting.
+
+See `examples/logging-*.mjs` for complete examples and [docs/ai-sdk-v5/guide.md](docs/ai-sdk-v5/guide.md) for detailed configuration.
+
 ### Text Streaming behavior
 
 **Status:** Incremental streaming not currently supported with `--experimental-json` format (expected in future Codex CLI releases)
@@ -176,6 +230,9 @@ When OpenAI adds streaming support, this provider will be updated to handle thos
 - `skipGitRepoCheck`: enable by default for CI/non‑repo contexts
 - `color`: `always` | `never` | `auto`
 - `outputLastMessageFile`: by default the provider sets a temp path and reads it to capture final text reliably
+- Logging (v0.5.0+):
+  - `verbose`: Enable debug/info logs (default: `false` for clean output)
+  - `logger`: Custom logger object or `false` to disable all logging
 
 See [docs/ai-sdk-v5/configuration.md](docs/ai-sdk-v5/configuration.md) for the full list and examples.
 

package/dist/index.cjs

@@ -15,20 +15,59 @@ var _documentCurrentScript = typeof document !== 'undefined' ? document.currentS
 
 // src/logger.ts
 var defaultLogger = {
-  warn: (m) => console.warn(m),
-  error: (m) => console.error(m)
+  debug: (message) => console.debug(`[DEBUG] ${message}`),
+  info: (message) => console.info(`[INFO] ${message}`),
+  warn: (message) => console.warn(`[WARN] ${message}`),
+  error: (message) => console.error(`[ERROR] ${message}`)
 };
 var noopLogger = {
+  debug: () => {
+  },
+  info: () => {
+  },
   warn: () => {
   },
   error: () => {
   }
 };
 function getLogger(logger) {
-  if (logger === false) return noopLogger;
-  if (!logger) return defaultLogger;
+  if (logger === false) {
+    return noopLogger;
+  }
+  if (logger === void 0) {
+    return defaultLogger;
+  }
   return logger;
 }
+function createVerboseLogger(logger, verbose = false) {
+  if (verbose) {
+    return logger;
+  }
+  return {
+    debug: () => {
+    },
+    // No-op when not verbose
+    info: () => {
+    },
+    // No-op when not verbose
+    warn: logger.warn.bind(logger),
+    error: logger.error.bind(logger)
+  };
+}
+var loggerFunctionSchema = zod.z.object({
+  debug: zod.z.any().refine((val) => typeof val === "function", {
+    message: "debug must be a function"
+  }),
+  info: zod.z.any().refine((val) => typeof val === "function", {
+    message: "info must be a function"
+  }),
+  warn: zod.z.any().refine((val) => typeof val === "function", {
+    message: "warn must be a function"
+  }),
+  error: zod.z.any().refine((val) => typeof val === "function", {
+    message: "error must be a function"
+  })
+});
 var settingsSchema = zod.z.object({
   codexPath: zod.z.string().optional(),
   cwd: zod.z.string().optional(),
@@ -41,7 +80,7 @@ var settingsSchema = zod.z.object({
   allowNpx: zod.z.boolean().optional(),
   env: zod.z.record(zod.z.string(), zod.z.string()).optional(),
   verbose: zod.z.boolean().optional(),
-  logger: zod.z.any().optional(),
+  logger: zod.z.union([zod.z.literal(false), loggerFunctionSchema]).optional(),
   // NEW: Reasoning & Verbosity
   reasoningEffort: zod.z.enum(["minimal", "low", "medium", "high"]).optional(),
   // Note: API rejects 'concise' and 'none' despite error messages claiming they're valid
@@ -233,7 +272,8 @@ var CodexCliLanguageModel = class {
   constructor(options) {
     this.modelId = options.id;
     this.settings = options.settings ?? {};
-    this.logger = getLogger(this.settings.logger);
+    const baseLogger = getLogger(this.settings.logger);
+    this.logger = createVerboseLogger(baseLogger, this.settings.verbose ?? false);
     if (!this.modelId || this.modelId.trim() === "") {
       throw new provider.NoSuchModelError({ modelId: this.modelId, modelType: "languageModel" });
     }
@@ -625,12 +665,16 @@ var CodexCliLanguageModel = class {
     });
   }
   async doGenerate(options) {
+    this.logger.debug(`[codex-cli] Starting doGenerate request with model: ${this.modelId}`);
     const { promptText, warnings: mappingWarnings } = mapMessagesToPrompt(options.prompt);
     const promptExcerpt = promptText.slice(0, 200);
     const warnings = [
       ...this.mapWarnings(options),
       ...mappingWarnings?.map((m) => ({ type: "other", message: m })) || []
     ];
+    this.logger.debug(
+      `[codex-cli] Converted ${options.prompt.length} messages, response format: ${options.responseFormat?.type ?? "none"}`
+    );
     const providerOptions = await providerUtils.parseProviderOptions({
       provider: this.provider,
       providerOptions: options.providerOptions,
@@ -643,9 +687,13 @@ var CodexCliLanguageModel = class {
       responseFormat,
       effectiveSettings
     );
+    this.logger.debug(
+      `[codex-cli] Executing Codex CLI: ${cmd} with ${args.length} arguments, cwd: ${cwd ?? "default"}`
+    );
     let text = "";
     const usage = { inputTokens: 0, outputTokens: 0, totalTokens: 0 };
     const finishReason = "stop";
+    const startTime = Date.now();
     const child = child_process.spawn(cmd, args, { env, cwd, stdio: ["ignore", "pipe", "pipe"] });
     let onAbort;
     if (options.abortSignal) {
@@ -667,11 +715,14 @@ var CodexCliLanguageModel = class {
           for (const line of lines) {
             const event = this.parseExperimentalJsonEvent(line);
             if (!event) continue;
+            this.logger.debug(`[codex-cli] Received event type: ${event.type ?? "unknown"}`);
             if (event.type === "thread.started" && typeof event.thread_id === "string") {
               this.sessionId = event.thread_id;
+              this.logger.debug(`[codex-cli] Session started: ${this.sessionId}`);
             }
             if (event.type === "session.created" && typeof event.session_id === "string") {
               this.sessionId = event.session_id;
+              this.logger.debug(`[codex-cli] Session created: ${this.sessionId}`);
             }
             if (event.type === "turn.completed") {
               const usageEvent = this.extractUsage(event);
@@ -687,15 +738,21 @@ var CodexCliLanguageModel = class {
             if (event.type === "turn.failed") {
               const errorText = event.error && typeof event.error.message === "string" && event.error.message || (typeof event.message === "string" ? event.message : void 0);
               turnFailureMessage = errorText ?? turnFailureMessage ?? "Codex turn failed";
+              this.logger.error(`[codex-cli] Turn failed: ${turnFailureMessage}`);
             }
             if (event.type === "error") {
               const errorText = typeof event.message === "string" ? event.message : void 0;
               turnFailureMessage = errorText ?? turnFailureMessage ?? "Codex error";
+              this.logger.error(`[codex-cli] Error event: ${turnFailureMessage}`);
             }
           }
         });
-        child.on("error", (e) => reject(this.handleSpawnError(e, promptExcerpt)));
+        child.on("error", (e) => {
+          this.logger.error(`[codex-cli] Spawn error: ${String(e)}`);
+          reject(this.handleSpawnError(e, promptExcerpt));
+        });
         child.on("close", (code) => {
+          const duration = Date.now() - startTime;
           if (code === 0) {
             if (turnFailureMessage) {
               reject(
@@ -707,8 +764,15 @@ var CodexCliLanguageModel = class {
               );
               return;
             }
+            this.logger.info(
+              `[codex-cli] Request completed - Session: ${this.sessionId ?? "N/A"}, Duration: ${duration}ms, Tokens: ${usage.totalTokens}`
+            );
+            this.logger.debug(
+              `[codex-cli] Token usage - Input: ${usage.inputTokens}, Output: ${usage.outputTokens}, Total: ${usage.totalTokens}`
+            );
             resolve();
           } else {
+            this.logger.error(`[codex-cli] Process exited with code ${code} after ${duration}ms`);
             reject(
               createAPICallError({
                 message: `Codex CLI exited with code ${code}`,
@@ -757,12 +821,16 @@ var CodexCliLanguageModel = class {
     };
   }
   async doStream(options) {
+    this.logger.debug(`[codex-cli] Starting doStream request with model: ${this.modelId}`);
     const { promptText, warnings: mappingWarnings } = mapMessagesToPrompt(options.prompt);
     const promptExcerpt = promptText.slice(0, 200);
     const warnings = [
       ...this.mapWarnings(options),
       ...mappingWarnings?.map((m) => ({ type: "other", message: m })) || []
     ];
+    this.logger.debug(
+      `[codex-cli] Converted ${options.prompt.length} messages for streaming, response format: ${options.responseFormat?.type ?? "none"}`
+    );
     const providerOptions = await providerUtils.parseProviderOptions({
       provider: this.provider,
       providerOptions: options.providerOptions,
@@ -775,8 +843,12 @@ var CodexCliLanguageModel = class {
       responseFormat,
       effectiveSettings
     );
+    this.logger.debug(
+      `[codex-cli] Executing Codex CLI for streaming: ${cmd} with ${args.length} arguments`
+    );
     const stream = new ReadableStream({
       start: (controller) => {
+        const startTime = Date.now();
         const child = child_process.spawn(cmd, args, { env, cwd, stdio: ["ignore", "pipe", "pipe"] });
         controller.enqueue({ type: "stream-start", warnings });
         let stderr = "";
@@ -799,12 +871,18 @@ var CodexCliLanguageModel = class {
           if (!item) return;
           if (event.type === "item.completed" && this.getItemType(item) === "assistant_message" && typeof item.text === "string") {
             accumulatedText = item.text;
+            this.logger.debug(
+              `[codex-cli] Received assistant message, length: ${item.text.length}`
+            );
             return;
           }
           const toolName = this.getToolName(item);
           if (!toolName) {
             return;
           }
+          this.logger.debug(
+            `[codex-cli] Tool detected: ${toolName}, item type: ${this.getItemType(item)}`
+          );
           const mapKey = typeof item.id === "string" && item.id.length > 0 ? item.id : crypto.randomUUID();
           let toolState = activeTools.get(mapKey);
           const latestInput = this.buildToolInputPayload(item);
@@ -823,6 +901,7 @@ var CodexCliLanguageModel = class {
             }
           }
           if (!toolState.hasEmittedCall) {
+            this.logger.debug(`[codex-cli] Emitting tool invocation: ${toolState.toolName}`);
             this.emitToolInvocation(
               controller,
               toolState.toolCallId,
@@ -833,6 +912,7 @@ var CodexCliLanguageModel = class {
           }
           if (event.type === "item.completed") {
             const { result, metadata } = this.buildToolResultPayload(item);
+            this.logger.debug(`[codex-cli] Tool completed: ${toolState.toolName}`);
             this.emitToolResult(
               controller,
               toolState.toolCallId,
@@ -856,7 +936,11 @@ var CodexCliLanguageModel = class {
           options.abortSignal.addEventListener("abort", onAbort, { once: true });
         }
         const finishStream = (code) => {
+          const duration = Date.now() - startTime;
           if (code !== 0) {
+            this.logger.error(
+              `[codex-cli] Stream process exited with code ${code} after ${duration}ms`
+            );
             controller.error(
               createAPICallError({
                 message: `Codex CLI exited with code ${code}`,
@@ -868,6 +952,7 @@ var CodexCliLanguageModel = class {
             return;
           }
           if (turnFailureMessage) {
+            this.logger.error(`[codex-cli] Stream failed: ${turnFailureMessage}`);
             controller.error(
               createAPICallError({
                 message: turnFailureMessage,
@@ -896,6 +981,12 @@ var CodexCliLanguageModel = class {
             controller.enqueue({ type: "text-end", id: textId });
           }
           const usageSummary = lastUsage ?? { inputTokens: 0, outputTokens: 0, totalTokens: 0 };
+          this.logger.info(
+            `[codex-cli] Stream completed - Session: ${this.sessionId ?? "N/A"}, Duration: ${duration}ms, Tokens: ${usageSummary.totalTokens}`
+          );
+          this.logger.debug(
+            `[codex-cli] Token usage - Input: ${usageSummary.inputTokens}, Output: ${usageSummary.outputTokens}, Total: ${usageSummary.totalTokens}`
+          );
           controller.enqueue({
             type: "finish",
             finishReason: "stop",
@@ -910,8 +1001,10 @@ var CodexCliLanguageModel = class {
           for (const line of lines) {
             const event = this.parseExperimentalJsonEvent(line);
             if (!event) continue;
+            this.logger.debug(`[codex-cli] Stream event: ${event.type ?? "unknown"}`);
             if (event.type === "thread.started" && typeof event.thread_id === "string") {
               this.sessionId = event.thread_id;
+              this.logger.debug(`[codex-cli] Stream session started: ${this.sessionId}`);
               if (!responseMetadataSent) {
                 responseMetadataSent = true;
                 sendMetadata();
@@ -920,6 +1013,7 @@ var CodexCliLanguageModel = class {
             }
             if (event.type === "session.created" && typeof event.session_id === "string") {
               this.sessionId = event.session_id;
+              this.logger.debug(`[codex-cli] Stream session created: ${this.sessionId}`);
               if (!responseMetadataSent) {
                 responseMetadataSent = true;
                 sendMetadata();
@@ -936,6 +1030,7 @@ var CodexCliLanguageModel = class {
             if (event.type === "turn.failed") {
               const errorText = event.error && typeof event.error.message === "string" && event.error.message || (typeof event.message === "string" ? event.message : void 0);
               turnFailureMessage = errorText ?? turnFailureMessage ?? "Codex turn failed";
+              this.logger.error(`[codex-cli] Stream turn failed: ${turnFailureMessage}`);
               sendMetadata({ error: turnFailureMessage });
               continue;
             }
@@ -943,6 +1038,7 @@ var CodexCliLanguageModel = class {
               const errorText = typeof event.message === "string" ? event.message : void 0;
               const effective = errorText ?? "Codex error";
               turnFailureMessage = turnFailureMessage ?? effective;
+              this.logger.error(`[codex-cli] Stream error event: ${effective}`);
               sendMetadata({ error: effective });
               continue;
             }
@@ -960,6 +1056,7 @@ var CodexCliLanguageModel = class {
           }
         };
         child.on("error", (e) => {
+          this.logger.error(`[codex-cli] Stream spawn error: ${String(e)}`);
           if (options.abortSignal) options.abortSignal.removeEventListener("abort", onAbort);
           cleanupSchema();
           controller.error(this.handleSpawnError(e, promptExcerpt));

package/dist/index.d.cts

@@ -1,7 +1,38 @@
 import { ProviderV2, LanguageModelV2 } from '@ai-sdk/provider';
 
+/**
+ * Logger interface for custom logging.
+ * Allows consumers to provide their own logging implementation
+ * or disable logging entirely.
+ *
+ * @example
+ * ```typescript
+ * const customLogger: Logger = {
+ *   debug: (message) => myLoggingService.debug(message),
+ *   info: (message) => myLoggingService.info(message),
+ *   warn: (message) => myLoggingService.warn(message),
+ *   error: (message) => myLoggingService.error(message),
+ * };
+ * ```
+ */
 interface Logger {
+    /**
+     * Log a debug message. Only logged when verbose mode is enabled.
+     * Used for detailed execution tracing and troubleshooting.
+     */
+    debug: (message: string) => void;
+    /**
+     * Log an informational message. Only logged when verbose mode is enabled.
+     * Used for general execution flow information.
+     */
+    info: (message: string) => void;
+    /**
+     * Log a warning message.
+     */
     warn: (message: string) => void;
+    /**
+     * Log an error message.
+     */
     error: (message: string) => void;
 }
 type ApprovalMode = 'untrusted' | 'on-failure' | 'on-request' | 'never';

package/dist/index.d.ts

@@ -1,7 +1,38 @@
 import { ProviderV2, LanguageModelV2 } from '@ai-sdk/provider';
 
+/**
+ * Logger interface for custom logging.
+ * Allows consumers to provide their own logging implementation
+ * or disable logging entirely.
+ *
+ * @example
+ * ```typescript
+ * const customLogger: Logger = {
+ *   debug: (message) => myLoggingService.debug(message),
+ *   info: (message) => myLoggingService.info(message),
+ *   warn: (message) => myLoggingService.warn(message),
+ *   error: (message) => myLoggingService.error(message),
+ * };
+ * ```
+ */
 interface Logger {
+    /**
+     * Log a debug message. Only logged when verbose mode is enabled.
+     * Used for detailed execution tracing and troubleshooting.
+     */
+    debug: (message: string) => void;
+    /**
+     * Log an informational message. Only logged when verbose mode is enabled.
+     * Used for general execution flow information.
+     */
+    info: (message: string) => void;
+    /**
+     * Log a warning message.
+     */
     warn: (message: string) => void;
+    /**
+     * Log an error message.
+     */
     error: (message: string) => void;
 }
 type ApprovalMode = 'untrusted' | 'on-failure' | 'on-request' | 'never';

package/dist/index.js

@@ -12,20 +12,59 @@ import { parseProviderOptions, generateId } from '@ai-sdk/provider-utils';
 
 // src/logger.ts
 var defaultLogger = {
-  warn: (m) => console.warn(m),
-  error: (m) => console.error(m)
+  debug: (message) => console.debug(`[DEBUG] ${message}`),
+  info: (message) => console.info(`[INFO] ${message}`),
+  warn: (message) => console.warn(`[WARN] ${message}`),
+  error: (message) => console.error(`[ERROR] ${message}`)
 };
 var noopLogger = {
+  debug: () => {
+  },
+  info: () => {
+  },
   warn: () => {
   },
   error: () => {
   }
 };
 function getLogger(logger) {
-  if (logger === false) return noopLogger;
-  if (!logger) return defaultLogger;
+  if (logger === false) {
+    return noopLogger;
+  }
+  if (logger === void 0) {
+    return defaultLogger;
+  }
   return logger;
 }
+function createVerboseLogger(logger, verbose = false) {
+  if (verbose) {
+    return logger;
+  }
+  return {
+    debug: () => {
+    },
+    // No-op when not verbose
+    info: () => {
+    },
+    // No-op when not verbose
+    warn: logger.warn.bind(logger),
+    error: logger.error.bind(logger)
+  };
+}
+var loggerFunctionSchema = z.object({
+  debug: z.any().refine((val) => typeof val === "function", {
+    message: "debug must be a function"
+  }),
+  info: z.any().refine((val) => typeof val === "function", {
+    message: "info must be a function"
+  }),
+  warn: z.any().refine((val) => typeof val === "function", {
+    message: "warn must be a function"
+  }),
+  error: z.any().refine((val) => typeof val === "function", {
+    message: "error must be a function"
+  })
+});
 var settingsSchema = z.object({
   codexPath: z.string().optional(),
   cwd: z.string().optional(),
@@ -38,7 +77,7 @@ var settingsSchema = z.object({
   allowNpx: z.boolean().optional(),
   env: z.record(z.string(), z.string()).optional(),
   verbose: z.boolean().optional(),
-  logger: z.any().optional(),
+  logger: z.union([z.literal(false), loggerFunctionSchema]).optional(),
   // NEW: Reasoning & Verbosity
   reasoningEffort: z.enum(["minimal", "low", "medium", "high"]).optional(),
   // Note: API rejects 'concise' and 'none' despite error messages claiming they're valid
@@ -230,7 +269,8 @@ var CodexCliLanguageModel = class {
   constructor(options) {
     this.modelId = options.id;
     this.settings = options.settings ?? {};
-    this.logger = getLogger(this.settings.logger);
+    const baseLogger = getLogger(this.settings.logger);
+    this.logger = createVerboseLogger(baseLogger, this.settings.verbose ?? false);
     if (!this.modelId || this.modelId.trim() === "") {
       throw new NoSuchModelError({ modelId: this.modelId, modelType: "languageModel" });
     }
@@ -622,12 +662,16 @@ var CodexCliLanguageModel = class {
     });
   }
   async doGenerate(options) {
+    this.logger.debug(`[codex-cli] Starting doGenerate request with model: ${this.modelId}`);
     const { promptText, warnings: mappingWarnings } = mapMessagesToPrompt(options.prompt);
     const promptExcerpt = promptText.slice(0, 200);
     const warnings = [
       ...this.mapWarnings(options),
       ...mappingWarnings?.map((m) => ({ type: "other", message: m })) || []
     ];
+    this.logger.debug(
+      `[codex-cli] Converted ${options.prompt.length} messages, response format: ${options.responseFormat?.type ?? "none"}`
+    );
     const providerOptions = await parseProviderOptions({
       provider: this.provider,
       providerOptions: options.providerOptions,
@@ -640,9 +684,13 @@ var CodexCliLanguageModel = class {
       responseFormat,
       effectiveSettings
     );
+    this.logger.debug(
+      `[codex-cli] Executing Codex CLI: ${cmd} with ${args.length} arguments, cwd: ${cwd ?? "default"}`
+    );
     let text = "";
     const usage = { inputTokens: 0, outputTokens: 0, totalTokens: 0 };
     const finishReason = "stop";
+    const startTime = Date.now();
     const child = spawn(cmd, args, { env, cwd, stdio: ["ignore", "pipe", "pipe"] });
     let onAbort;
     if (options.abortSignal) {
@@ -664,11 +712,14 @@ var CodexCliLanguageModel = class {
           for (const line of lines) {
             const event = this.parseExperimentalJsonEvent(line);
             if (!event) continue;
+            this.logger.debug(`[codex-cli] Received event type: ${event.type ?? "unknown"}`);
             if (event.type === "thread.started" && typeof event.thread_id === "string") {
               this.sessionId = event.thread_id;
+              this.logger.debug(`[codex-cli] Session started: ${this.sessionId}`);
             }
             if (event.type === "session.created" && typeof event.session_id === "string") {
               this.sessionId = event.session_id;
+              this.logger.debug(`[codex-cli] Session created: ${this.sessionId}`);
             }
             if (event.type === "turn.completed") {
               const usageEvent = this.extractUsage(event);
@@ -684,15 +735,21 @@ var CodexCliLanguageModel = class {
             if (event.type === "turn.failed") {
               const errorText = event.error && typeof event.error.message === "string" && event.error.message || (typeof event.message === "string" ? event.message : void 0);
               turnFailureMessage = errorText ?? turnFailureMessage ?? "Codex turn failed";
+              this.logger.error(`[codex-cli] Turn failed: ${turnFailureMessage}`);
             }
             if (event.type === "error") {
               const errorText = typeof event.message === "string" ? event.message : void 0;
               turnFailureMessage = errorText ?? turnFailureMessage ?? "Codex error";
+              this.logger.error(`[codex-cli] Error event: ${turnFailureMessage}`);
             }
           }
         });
-        child.on("error", (e) => reject(this.handleSpawnError(e, promptExcerpt)));
+        child.on("error", (e) => {
+          this.logger.error(`[codex-cli] Spawn error: ${String(e)}`);
+          reject(this.handleSpawnError(e, promptExcerpt));
+        });
         child.on("close", (code) => {
+          const duration = Date.now() - startTime;
           if (code === 0) {
             if (turnFailureMessage) {
               reject(
@@ -704,8 +761,15 @@ var CodexCliLanguageModel = class {
               );
               return;
             }
+            this.logger.info(
+              `[codex-cli] Request completed - Session: ${this.sessionId ?? "N/A"}, Duration: ${duration}ms, Tokens: ${usage.totalTokens}`
+            );
+            this.logger.debug(
+              `[codex-cli] Token usage - Input: ${usage.inputTokens}, Output: ${usage.outputTokens}, Total: ${usage.totalTokens}`
+            );
             resolve();
           } else {
+            this.logger.error(`[codex-cli] Process exited with code ${code} after ${duration}ms`);
             reject(
               createAPICallError({
                 message: `Codex CLI exited with code ${code}`,
@@ -754,12 +818,16 @@ var CodexCliLanguageModel = class {
     };
   }
   async doStream(options) {
+    this.logger.debug(`[codex-cli] Starting doStream request with model: ${this.modelId}`);
     const { promptText, warnings: mappingWarnings } = mapMessagesToPrompt(options.prompt);
     const promptExcerpt = promptText.slice(0, 200);
     const warnings = [
       ...this.mapWarnings(options),
       ...mappingWarnings?.map((m) => ({ type: "other", message: m })) || []
     ];
+    this.logger.debug(
+      `[codex-cli] Converted ${options.prompt.length} messages for streaming, response format: ${options.responseFormat?.type ?? "none"}`
+    );
     const providerOptions = await parseProviderOptions({
       provider: this.provider,
       providerOptions: options.providerOptions,
@@ -772,8 +840,12 @@ var CodexCliLanguageModel = class {
       responseFormat,
       effectiveSettings
     );
+    this.logger.debug(
+      `[codex-cli] Executing Codex CLI for streaming: ${cmd} with ${args.length} arguments`
+    );
     const stream = new ReadableStream({
       start: (controller) => {
+        const startTime = Date.now();
         const child = spawn(cmd, args, { env, cwd, stdio: ["ignore", "pipe", "pipe"] });
         controller.enqueue({ type: "stream-start", warnings });
         let stderr = "";
@@ -796,12 +868,18 @@ var CodexCliLanguageModel = class {
           if (!item) return;
           if (event.type === "item.completed" && this.getItemType(item) === "assistant_message" && typeof item.text === "string") {
             accumulatedText = item.text;
+            this.logger.debug(
+              `[codex-cli] Received assistant message, length: ${item.text.length}`
+            );
             return;
           }
           const toolName = this.getToolName(item);
           if (!toolName) {
             return;
           }
+          this.logger.debug(
+            `[codex-cli] Tool detected: ${toolName}, item type: ${this.getItemType(item)}`
+          );
           const mapKey = typeof item.id === "string" && item.id.length > 0 ? item.id : randomUUID();
           let toolState = activeTools.get(mapKey);
           const latestInput = this.buildToolInputPayload(item);
@@ -820,6 +898,7 @@ var CodexCliLanguageModel = class {
             }
           }
           if (!toolState.hasEmittedCall) {
+            this.logger.debug(`[codex-cli] Emitting tool invocation: ${toolState.toolName}`);
             this.emitToolInvocation(
               controller,
               toolState.toolCallId,
@@ -830,6 +909,7 @@ var CodexCliLanguageModel = class {
           }
           if (event.type === "item.completed") {
             const { result, metadata } = this.buildToolResultPayload(item);
+            this.logger.debug(`[codex-cli] Tool completed: ${toolState.toolName}`);
             this.emitToolResult(
               controller,
               toolState.toolCallId,
@@ -853,7 +933,11 @@ var CodexCliLanguageModel = class {
           options.abortSignal.addEventListener("abort", onAbort, { once: true });
         }
         const finishStream = (code) => {
+          const duration = Date.now() - startTime;
           if (code !== 0) {
+            this.logger.error(
+              `[codex-cli] Stream process exited with code ${code} after ${duration}ms`
+            );
             controller.error(
               createAPICallError({
                 message: `Codex CLI exited with code ${code}`,
@@ -865,6 +949,7 @@ var CodexCliLanguageModel = class {
             return;
           }
           if (turnFailureMessage) {
+            this.logger.error(`[codex-cli] Stream failed: ${turnFailureMessage}`);
             controller.error(
               createAPICallError({
                 message: turnFailureMessage,
@@ -893,6 +978,12 @@ var CodexCliLanguageModel = class {
             controller.enqueue({ type: "text-end", id: textId });
           }
           const usageSummary = lastUsage ?? { inputTokens: 0, outputTokens: 0, totalTokens: 0 };
+          this.logger.info(
+            `[codex-cli] Stream completed - Session: ${this.sessionId ?? "N/A"}, Duration: ${duration}ms, Tokens: ${usageSummary.totalTokens}`
+          );
+          this.logger.debug(
+            `[codex-cli] Token usage - Input: ${usageSummary.inputTokens}, Output: ${usageSummary.outputTokens}, Total: ${usageSummary.totalTokens}`
+          );
           controller.enqueue({
             type: "finish",
             finishReason: "stop",
@@ -907,8 +998,10 @@ var CodexCliLanguageModel = class {
           for (const line of lines) {
             const event = this.parseExperimentalJsonEvent(line);
             if (!event) continue;
+            this.logger.debug(`[codex-cli] Stream event: ${event.type ?? "unknown"}`);
             if (event.type === "thread.started" && typeof event.thread_id === "string") {
               this.sessionId = event.thread_id;
+              this.logger.debug(`[codex-cli] Stream session started: ${this.sessionId}`);
               if (!responseMetadataSent) {
                 responseMetadataSent = true;
                 sendMetadata();
@@ -917,6 +1010,7 @@ var CodexCliLanguageModel = class {
             }
             if (event.type === "session.created" && typeof event.session_id === "string") {
               this.sessionId = event.session_id;
+              this.logger.debug(`[codex-cli] Stream session created: ${this.sessionId}`);
               if (!responseMetadataSent) {
                 responseMetadataSent = true;
                 sendMetadata();
@@ -933,6 +1027,7 @@ var CodexCliLanguageModel = class {
             if (event.type === "turn.failed") {
               const errorText = event.error && typeof event.error.message === "string" && event.error.message || (typeof event.message === "string" ? event.message : void 0);
               turnFailureMessage = errorText ?? turnFailureMessage ?? "Codex turn failed";
+              this.logger.error(`[codex-cli] Stream turn failed: ${turnFailureMessage}`);
               sendMetadata({ error: turnFailureMessage });
               continue;
             }
@@ -940,6 +1035,7 @@ var CodexCliLanguageModel = class {
               const errorText = typeof event.message === "string" ? event.message : void 0;
               const effective = errorText ?? "Codex error";
               turnFailureMessage = turnFailureMessage ?? effective;
+              this.logger.error(`[codex-cli] Stream error event: ${effective}`);
               sendMetadata({ error: effective });
               continue;
             }
@@ -957,6 +1053,7 @@ var CodexCliLanguageModel = class {
           }
         };
         child.on("error", (e) => {
+          this.logger.error(`[codex-cli] Stream spawn error: ${String(e)}`);
           if (options.abortSignal) options.abortSignal.removeEventListener("abort", onAbort);
           cleanupSchema();
           controller.error(this.handleSpawnError(e, promptExcerpt));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-sdk-provider-codex-cli",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "AI SDK v5 provider for OpenAI Codex CLI with native JSON Schema support",
   "keywords": [
     "ai-sdk",