@janole/ai-sdk-provider-codex-asp 0.2.3 → 0.2.4

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { LanguageModelV3CallOptions, LanguageModelV3, LanguageModelV3GenerateResult, LanguageModelV3StreamResult, LanguageModelV3StreamPart, LanguageModelV3Prompt, ProviderV3 } from '@ai-sdk/provider';
+import { LanguageModelV3CallOptions, LanguageModelV3, LanguageModelV3GenerateResult, LanguageModelV3StreamResult, LanguageModelV3StreamPart, ProviderV3, LanguageModelV3Prompt } from '@ai-sdk/provider';
 
 /** Base error type for this provider package. */
 declare class CodexProviderError extends Error {
@@ -1403,24 +1403,6 @@ declare class CodexEventMapper {
     map(event: CodexEventMapperInput): LanguageModelV3StreamPart[];
 }
 
-/**
- * Extracts system messages from the prompt and concatenates them into a single
- * string suitable for `developerInstructions` on `thread/start` or
- * `thread/resume`.  Returns `undefined` when no system content is present.
- */
-declare function mapSystemPrompt(prompt: LanguageModelV3Prompt): string | undefined;
-/**
- * Maps the prompt to the `input` array for a `turn/start` request.
- *
- * System messages are **not** included here — they are routed to
- * `developerInstructions` via {@link mapSystemPrompt} instead.
- *
- * @param isResume - When true the thread already holds the full history on
- *   disk, so only the last user message is extracted and sent.  When false
- *   (fresh thread) all user text is folded into a single item.
- */
-declare function mapPromptToTurnInput(prompt: LanguageModelV3Prompt, isResume?: boolean): CodexTurnInputItem[];
-
 declare const CODEX_PROVIDER_ID = "@janole/ai-sdk-provider-codex-asp";
 declare function codexProviderMetadata(threadId: string | undefined): {
     "@janole/ai-sdk-provider-codex-asp": {
@@ -1442,4 +1424,95 @@ declare const codexAppServer: CodexProvider;
  */
 declare const createCodexProvider: typeof createCodexAppServer;
 
-export { type AgentMessageDeltaNotification, AppServerClient, type AppServerClientSettings, ApprovalsDispatcher, type ApprovalsDispatcherSettings, type AskForApproval, CODEX_PROVIDER_ID, type CodexCommandApprovalRequest, type CodexDynamicToolDefinition, CodexEventMapper, type CodexEventMapperInput, type CodexEventMapperOptions, type CodexFileChangeApprovalRequest, type CodexInitializeParams, type CodexInitializeResult, type CodexInitializedNotification, CodexLanguageModel, type CodexLanguageModelSettings, type CodexModelConfig, CodexNotImplementedError, type CodexNotification, type CodexProvider, CodexProviderError, type CodexProviderSettings, type CodexThreadDefaults, type CodexThreadResumeParams, type CodexThreadResumeResult, type CodexThreadStartParams, type CodexThreadStartResult, type CodexToolCallDeltaNotification, type CodexToolCallFinishedNotification, type CodexToolCallRequestParams, type CodexToolCallResult, type CodexToolCallStartedNotification, type CodexToolResultContentItem, type CodexTransport, type CodexTransportEventMap, type CodexTurnInputImage, type CodexTurnInputItem, type CodexTurnInputLocalImage, type CodexTurnInputMention, type CodexTurnInputSkill, type CodexTurnInputText, type CodexTurnStartParams, type CodexTurnStartResult, CodexWorker, CodexWorkerPool, type CodexWorkerPoolSettings, type CodexWorkerSettings, type CommandApprovalHandler, type CommandExecutionApprovalDecision, type CommandExecutionRequestApprovalParams, type CommandExecutionRequestApprovalResponse, type DynamicToolDefinition, type DynamicToolExecutionContext, type DynamicToolHandler, DynamicToolsDispatcher, type DynamicToolsDispatcherSettings, type FileChangeApprovalDecision, type FileChangeApprovalHandler, type FileChangeRequestApprovalParams, type FileChangeRequestApprovalResponse, type ItemCompletedNotification, type ItemStartedNotification, JsonRpcError, type JsonRpcErrorResponse, type JsonRpcId, type JsonRpcMessage, type JsonRpcMessageBase, type JsonRpcNotification, type JsonRpcRequest, type JsonRpcResponse, type JsonRpcSuccessResponse, PACKAGE_NAME, PACKAGE_VERSION, type PendingToolCall, PersistentTransport, type PersistentTransportSettings, type SandboxMode, StdioTransport, type StdioTransportSettings, type ThreadTokenUsageUpdatedNotification, type TurnCompletedNotification, type TurnStartedNotification, WebSocketTransport, type WebSocketTransportSettings, codexAppServer, codexProviderMetadata, createCodexAppServer, createCodexProvider, mapPromptToTurnInput, mapSystemPrompt, withProviderMetadata };
+/**
+ * Extracts system messages from the prompt and concatenates them into a single
+ * string suitable for `developerInstructions` on `thread/start` or
+ * `thread/resume`.  Returns `undefined` when no system content is present.
+ */
+declare function mapSystemPrompt(prompt: LanguageModelV3Prompt): string | undefined;
+/**
+ * Pluggable backend for persisting inline binary data so that the Codex
+ * protocol can reference it by URL.
+ *
+ * Implement this interface to use a different storage backend (e.g. S3, GCS).
+ *
+ * - A `file:` URL maps to `{ type: "localImage", path }` in the Codex protocol.
+ * - An `http(s):` URL maps to `{ type: "image", url }`.
+ */
+interface FileWriter {
+    /** Persist `data` and return a URL that Codex can use to access it. */
+    write(data: Uint8Array | string, mediaType: string): Promise<URL>;
+    /**
+     * Remove previously written files.  Best-effort — implementations should
+     * never throw.
+     */
+    cleanup(urls: URL[]): Promise<void>;
+}
+/**
+ * A {@link FileWriter} that writes to `os.tmpdir()` and returns `file:` URLs.
+ */
+declare class LocalFileWriter implements FileWriter {
+    write(data: Uint8Array | string, mediaType: string): Promise<URL>;
+    cleanup(urls: URL[]): Promise<void>;
+}
+/**
+ * Resolves inline binary data in AI SDK prompts and maps user content to
+ * {@link CodexTurnInputItem} arrays ready for `turn/start`.
+ *
+ * Instantiate with an optional custom {@link FileWriter} for non-local storage
+ * (e.g. S3).  Tracks all written URLs so that {@link cleanup} can remove them
+ * after the turn completes.
+ *
+ * @example
+ * ```ts
+ * const fileResolver = new PromptFileResolver();
+ * const turnInput = await fileResolver.resolve(prompt, isResume);
+ * // … after the turn …
+ * await fileResolver.cleanup();
+ * ```
+ */
+declare class PromptFileResolver {
+    private readonly writer;
+    private readonly written;
+    constructor(writer?: FileWriter);
+    /**
+     * Resolve inline file data and map user content to Codex input items.
+     *
+     * - Inline image data (base64 / Uint8Array) is written via the
+     *   {@link FileWriter} and converted to `localImage` or `image` items.
+     * - URL-based image file parts are converted directly.
+     * - Inline text file data is decoded and inlined as text.
+     * - Unsupported media types are silently skipped.
+     *
+     * @param isResume - When true only the last user message is extracted.
+     *   When false (fresh thread) all user text is accumulated with images
+     *   flushing the text buffer to preserve ordering.
+     */
+    resolve(prompt: LanguageModelV3Prompt, isResume?: boolean): Promise<CodexTurnInputItem[]>;
+    /**
+     * Remove all files created by previous {@link resolve} calls.
+     * Best-effort — never throws.
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Convert a resolved image URL to a Codex input item.
+     */
+    private mapImageUrl;
+    /**
+     * Resolve a single file part: write inline data via the writer, then
+     * convert to a Codex input item.  Text files are decoded and returned
+     * as text items.  Returns `null` for unsupported media types.
+     */
+    private resolveFilePart;
+    /**
+     * Resume path: extract parts from the last user message individually.
+     */
+    private resolveResumed;
+    /**
+     * Fresh thread path: accumulate text chunks across all user messages,
+     * flushing before each image to preserve ordering.
+     */
+    private resolveFresh;
+}
+
+export { type AgentMessageDeltaNotification, AppServerClient, type AppServerClientSettings, ApprovalsDispatcher, type ApprovalsDispatcherSettings, type AskForApproval, CODEX_PROVIDER_ID, type CodexCommandApprovalRequest, type CodexDynamicToolDefinition, CodexEventMapper, type CodexEventMapperInput, type CodexEventMapperOptions, type CodexFileChangeApprovalRequest, type CodexInitializeParams, type CodexInitializeResult, type CodexInitializedNotification, CodexLanguageModel, type CodexLanguageModelSettings, type CodexModelConfig, CodexNotImplementedError, type CodexNotification, type CodexProvider, CodexProviderError, type CodexProviderSettings, type CodexThreadDefaults, type CodexThreadResumeParams, type CodexThreadResumeResult, type CodexThreadStartParams, type CodexThreadStartResult, type CodexToolCallDeltaNotification, type CodexToolCallFinishedNotification, type CodexToolCallRequestParams, type CodexToolCallResult, type CodexToolCallStartedNotification, type CodexToolResultContentItem, type CodexTransport, type CodexTransportEventMap, type CodexTurnInputImage, type CodexTurnInputItem, type CodexTurnInputLocalImage, type CodexTurnInputMention, type CodexTurnInputSkill, type CodexTurnInputText, type CodexTurnStartParams, type CodexTurnStartResult, CodexWorker, CodexWorkerPool, type CodexWorkerPoolSettings, type CodexWorkerSettings, type CommandApprovalHandler, type CommandExecutionApprovalDecision, type CommandExecutionRequestApprovalParams, type CommandExecutionRequestApprovalResponse, type DynamicToolDefinition, type DynamicToolExecutionContext, type DynamicToolHandler, DynamicToolsDispatcher, type DynamicToolsDispatcherSettings, type FileChangeApprovalDecision, type FileChangeApprovalHandler, type FileChangeRequestApprovalParams, type FileChangeRequestApprovalResponse, type FileWriter, type ItemCompletedNotification, type ItemStartedNotification, JsonRpcError, type JsonRpcErrorResponse, type JsonRpcId, type JsonRpcMessage, type JsonRpcMessageBase, type JsonRpcNotification, type JsonRpcRequest, type JsonRpcResponse, type JsonRpcSuccessResponse, LocalFileWriter, PACKAGE_NAME, PACKAGE_VERSION, type PendingToolCall, PersistentTransport, type PersistentTransportSettings, PromptFileResolver, type SandboxMode, StdioTransport, type StdioTransportSettings, type ThreadTokenUsageUpdatedNotification, type TurnCompletedNotification, type TurnStartedNotification, WebSocketTransport, type WebSocketTransportSettings, codexAppServer, codexProviderMetadata, createCodexAppServer, createCodexProvider, mapSystemPrompt, withProviderMetadata };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { LanguageModelV3CallOptions, LanguageModelV3, LanguageModelV3GenerateResult, LanguageModelV3StreamResult, LanguageModelV3StreamPart, LanguageModelV3Prompt, ProviderV3 } from '@ai-sdk/provider';
+import { LanguageModelV3CallOptions, LanguageModelV3, LanguageModelV3GenerateResult, LanguageModelV3StreamResult, LanguageModelV3StreamPart, ProviderV3, LanguageModelV3Prompt } from '@ai-sdk/provider';
 
 /** Base error type for this provider package. */
 declare class CodexProviderError extends Error {
@@ -1403,24 +1403,6 @@ declare class CodexEventMapper {
     map(event: CodexEventMapperInput): LanguageModelV3StreamPart[];
 }
 
-/**
- * Extracts system messages from the prompt and concatenates them into a single
- * string suitable for `developerInstructions` on `thread/start` or
- * `thread/resume`.  Returns `undefined` when no system content is present.
- */
-declare function mapSystemPrompt(prompt: LanguageModelV3Prompt): string | undefined;
-/**
- * Maps the prompt to the `input` array for a `turn/start` request.
- *
- * System messages are **not** included here — they are routed to
- * `developerInstructions` via {@link mapSystemPrompt} instead.
- *
- * @param isResume - When true the thread already holds the full history on
- *   disk, so only the last user message is extracted and sent.  When false
- *   (fresh thread) all user text is folded into a single item.
- */
-declare function mapPromptToTurnInput(prompt: LanguageModelV3Prompt, isResume?: boolean): CodexTurnInputItem[];
-
 declare const CODEX_PROVIDER_ID = "@janole/ai-sdk-provider-codex-asp";
 declare function codexProviderMetadata(threadId: string | undefined): {
     "@janole/ai-sdk-provider-codex-asp": {
@@ -1442,4 +1424,95 @@ declare const codexAppServer: CodexProvider;
  */
 declare const createCodexProvider: typeof createCodexAppServer;
 
-export { type AgentMessageDeltaNotification, AppServerClient, type AppServerClientSettings, ApprovalsDispatcher, type ApprovalsDispatcherSettings, type AskForApproval, CODEX_PROVIDER_ID, type CodexCommandApprovalRequest, type CodexDynamicToolDefinition, CodexEventMapper, type CodexEventMapperInput, type CodexEventMapperOptions, type CodexFileChangeApprovalRequest, type CodexInitializeParams, type CodexInitializeResult, type CodexInitializedNotification, CodexLanguageModel, type CodexLanguageModelSettings, type CodexModelConfig, CodexNotImplementedError, type CodexNotification, type CodexProvider, CodexProviderError, type CodexProviderSettings, type CodexThreadDefaults, type CodexThreadResumeParams, type CodexThreadResumeResult, type CodexThreadStartParams, type CodexThreadStartResult, type CodexToolCallDeltaNotification, type CodexToolCallFinishedNotification, type CodexToolCallRequestParams, type CodexToolCallResult, type CodexToolCallStartedNotification, type CodexToolResultContentItem, type CodexTransport, type CodexTransportEventMap, type CodexTurnInputImage, type CodexTurnInputItem, type CodexTurnInputLocalImage, type CodexTurnInputMention, type CodexTurnInputSkill, type CodexTurnInputText, type CodexTurnStartParams, type CodexTurnStartResult, CodexWorker, CodexWorkerPool, type CodexWorkerPoolSettings, type CodexWorkerSettings, type CommandApprovalHandler, type CommandExecutionApprovalDecision, type CommandExecutionRequestApprovalParams, type CommandExecutionRequestApprovalResponse, type DynamicToolDefinition, type DynamicToolExecutionContext, type DynamicToolHandler, DynamicToolsDispatcher, type DynamicToolsDispatcherSettings, type FileChangeApprovalDecision, type FileChangeApprovalHandler, type FileChangeRequestApprovalParams, type FileChangeRequestApprovalResponse, type ItemCompletedNotification, type ItemStartedNotification, JsonRpcError, type JsonRpcErrorResponse, type JsonRpcId, type JsonRpcMessage, type JsonRpcMessageBase, type JsonRpcNotification, type JsonRpcRequest, type JsonRpcResponse, type JsonRpcSuccessResponse, PACKAGE_NAME, PACKAGE_VERSION, type PendingToolCall, PersistentTransport, type PersistentTransportSettings, type SandboxMode, StdioTransport, type StdioTransportSettings, type ThreadTokenUsageUpdatedNotification, type TurnCompletedNotification, type TurnStartedNotification, WebSocketTransport, type WebSocketTransportSettings, codexAppServer, codexProviderMetadata, createCodexAppServer, createCodexProvider, mapPromptToTurnInput, mapSystemPrompt, withProviderMetadata };
+/**
+ * Extracts system messages from the prompt and concatenates them into a single
+ * string suitable for `developerInstructions` on `thread/start` or
+ * `thread/resume`.  Returns `undefined` when no system content is present.
+ */
+declare function mapSystemPrompt(prompt: LanguageModelV3Prompt): string | undefined;
+/**
+ * Pluggable backend for persisting inline binary data so that the Codex
+ * protocol can reference it by URL.
+ *
+ * Implement this interface to use a different storage backend (e.g. S3, GCS).
+ *
+ * - A `file:` URL maps to `{ type: "localImage", path }` in the Codex protocol.
+ * - An `http(s):` URL maps to `{ type: "image", url }`.
+ */
+interface FileWriter {
+    /** Persist `data` and return a URL that Codex can use to access it. */
+    write(data: Uint8Array | string, mediaType: string): Promise<URL>;
+    /**
+     * Remove previously written files.  Best-effort — implementations should
+     * never throw.
+     */
+    cleanup(urls: URL[]): Promise<void>;
+}
+/**
+ * A {@link FileWriter} that writes to `os.tmpdir()` and returns `file:` URLs.
+ */
+declare class LocalFileWriter implements FileWriter {
+    write(data: Uint8Array | string, mediaType: string): Promise<URL>;
+    cleanup(urls: URL[]): Promise<void>;
+}
+/**
+ * Resolves inline binary data in AI SDK prompts and maps user content to
+ * {@link CodexTurnInputItem} arrays ready for `turn/start`.
+ *
+ * Instantiate with an optional custom {@link FileWriter} for non-local storage
+ * (e.g. S3).  Tracks all written URLs so that {@link cleanup} can remove them
+ * after the turn completes.
+ *
+ * @example
+ * ```ts
+ * const fileResolver = new PromptFileResolver();
+ * const turnInput = await fileResolver.resolve(prompt, isResume);
+ * // … after the turn …
+ * await fileResolver.cleanup();
+ * ```
+ */
+declare class PromptFileResolver {
+    private readonly writer;
+    private readonly written;
+    constructor(writer?: FileWriter);
+    /**
+     * Resolve inline file data and map user content to Codex input items.
+     *
+     * - Inline image data (base64 / Uint8Array) is written via the
+     *   {@link FileWriter} and converted to `localImage` or `image` items.
+     * - URL-based image file parts are converted directly.
+     * - Inline text file data is decoded and inlined as text.
+     * - Unsupported media types are silently skipped.
+     *
+     * @param isResume - When true only the last user message is extracted.
+     *   When false (fresh thread) all user text is accumulated with images
+     *   flushing the text buffer to preserve ordering.
+     */
+    resolve(prompt: LanguageModelV3Prompt, isResume?: boolean): Promise<CodexTurnInputItem[]>;
+    /**
+     * Remove all files created by previous {@link resolve} calls.
+     * Best-effort — never throws.
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Convert a resolved image URL to a Codex input item.
+     */
+    private mapImageUrl;
+    /**
+     * Resolve a single file part: write inline data via the writer, then
+     * convert to a Codex input item.  Text files are decoded and returned
+     * as text items.  Returns `null` for unsupported media types.
+     */
+    private resolveFilePart;
+    /**
+     * Resume path: extract parts from the last user message individually.
+     */
+    private resolveResumed;
+    /**
+     * Fresh thread path: accumulate text chunks across all user messages,
+     * flushing before each image to preserve ordering.
+     */
+    private resolveFresh;
+}
+
+export { type AgentMessageDeltaNotification, AppServerClient, type AppServerClientSettings, ApprovalsDispatcher, type ApprovalsDispatcherSettings, type AskForApproval, CODEX_PROVIDER_ID, type CodexCommandApprovalRequest, type CodexDynamicToolDefinition, CodexEventMapper, type CodexEventMapperInput, type CodexEventMapperOptions, type CodexFileChangeApprovalRequest, type CodexInitializeParams, type CodexInitializeResult, type CodexInitializedNotification, CodexLanguageModel, type CodexLanguageModelSettings, type CodexModelConfig, CodexNotImplementedError, type CodexNotification, type CodexProvider, CodexProviderError, type CodexProviderSettings, type CodexThreadDefaults, type CodexThreadResumeParams, type CodexThreadResumeResult, type CodexThreadStartParams, type CodexThreadStartResult, type CodexToolCallDeltaNotification, type CodexToolCallFinishedNotification, type CodexToolCallRequestParams, type CodexToolCallResult, type CodexToolCallStartedNotification, type CodexToolResultContentItem, type CodexTransport, type CodexTransportEventMap, type CodexTurnInputImage, type CodexTurnInputItem, type CodexTurnInputLocalImage, type CodexTurnInputMention, type CodexTurnInputSkill, type CodexTurnInputText, type CodexTurnStartParams, type CodexTurnStartResult, CodexWorker, CodexWorkerPool, type CodexWorkerPoolSettings, type CodexWorkerSettings, type CommandApprovalHandler, type CommandExecutionApprovalDecision, type CommandExecutionRequestApprovalParams, type CommandExecutionRequestApprovalResponse, type DynamicToolDefinition, type DynamicToolExecutionContext, type DynamicToolHandler, DynamicToolsDispatcher, type DynamicToolsDispatcherSettings, type FileChangeApprovalDecision, type FileChangeApprovalHandler, type FileChangeRequestApprovalParams, type FileChangeRequestApprovalResponse, type FileWriter, type ItemCompletedNotification, type ItemStartedNotification, JsonRpcError, type JsonRpcErrorResponse, type JsonRpcId, type JsonRpcMessage, type JsonRpcMessageBase, type JsonRpcNotification, type JsonRpcRequest, type JsonRpcResponse, type JsonRpcSuccessResponse, LocalFileWriter, PACKAGE_NAME, PACKAGE_VERSION, type PendingToolCall, PersistentTransport, type PersistentTransportSettings, PromptFileResolver, type SandboxMode, StdioTransport, type StdioTransportSettings, type ThreadTokenUsageUpdatedNotification, type TurnCompletedNotification, type TurnStartedNotification, WebSocketTransport, type WebSocketTransportSettings, codexAppServer, codexProviderMetadata, createCodexAppServer, createCodexProvider, mapSystemPrompt, withProviderMetadata };

package/dist/index.js

@@ -1,4 +1,9 @@
 import { spawn } from 'child_process';
+import { randomUUID } from 'crypto';
+import { writeFile, unlink } from 'fs/promises';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { fileURLToPath, pathToFileURL } from 'url';
 import { NoSuchModelError } from '@ai-sdk/provider';
 
 // src/utils/object.ts
@@ -928,7 +933,7 @@ var DynamicToolsDispatcher = class {
 // package.json
 var package_default = {
   name: "@janole/ai-sdk-provider-codex-asp",
-  version: "0.2.3"};
+  version: "0.2.4"};
 
 // src/package-info.ts
 var PACKAGE_NAME = package_default.name;
@@ -1315,8 +1320,6 @@ var CodexEventMapper = class {
     return parts;
   }
 };
-
-// src/protocol/prompt-mapper.ts
 function mapSystemPrompt(prompt) {
   const chunks = [];
   for (const message of prompt) {
@@ -1329,8 +1332,111 @@ function mapSystemPrompt(prompt) {
   }
   return chunks.length > 0 ? chunks.join("\n\n") : void 0;
 }
-function mapPromptToTurnInput(prompt, isResume = false) {
-  if (isResume) {
+function textItem(text) {
+  return { type: "text", text, text_elements: [] };
+}
+var MEDIA_TYPE_TO_EXT = {
+  "image/png": ".png",
+  "image/jpeg": ".jpg",
+  "image/gif": ".gif",
+  "image/webp": ".webp",
+  "image/svg+xml": ".svg",
+  "image/bmp": ".bmp",
+  "image/tiff": ".tiff"
+};
+function extensionForMediaType(mediaType) {
+  return MEDIA_TYPE_TO_EXT[mediaType] ?? ".bin";
+}
+var LocalFileWriter = class {
+  async write(data, mediaType) {
+    const ext = extensionForMediaType(mediaType);
+    const filename = `codex-ai-sdk-${randomUUID()}${ext}`;
+    const filepath = join(tmpdir(), filename);
+    const buffer = typeof data === "string" ? Buffer.from(data, "base64") : data;
+    await writeFile(filepath, buffer);
+    return pathToFileURL(filepath);
+  }
+  async cleanup(urls) {
+    await Promise.allSettled(
+      urls.filter((u) => u.protocol === "file:").map((u) => unlink(u))
+    );
+  }
+};
+var PromptFileResolver = class {
+  writer;
+  written = [];
+  constructor(writer) {
+    this.writer = writer ?? new LocalFileWriter();
+  }
+  /**
+   * Resolve inline file data and map user content to Codex input items.
+   *
+   * - Inline image data (base64 / Uint8Array) is written via the
+   *   {@link FileWriter} and converted to `localImage` or `image` items.
+   * - URL-based image file parts are converted directly.
+   * - Inline text file data is decoded and inlined as text.
+   * - Unsupported media types are silently skipped.
+   *
+   * @param isResume - When true only the last user message is extracted.
+   *   When false (fresh thread) all user text is accumulated with images
+   *   flushing the text buffer to preserve ordering.
+   */
+  async resolve(prompt, isResume = false) {
+    if (isResume) {
+      return this.resolveResumed(prompt);
+    }
+    return this.resolveFresh(prompt);
+  }
+  /**
+   * Remove all files created by previous {@link resolve} calls.
+   * Best-effort — never throws.
+   */
+  async cleanup() {
+    const urls = this.written.splice(0);
+    if (urls.length > 0) {
+      await this.writer.cleanup(urls);
+    }
+  }
+  /**
+   * Convert a resolved image URL to a Codex input item.
+   */
+  mapImageUrl(mediaType, data) {
+    if (!mediaType.startsWith("image/")) {
+      return null;
+    }
+    if (data.protocol === "file:") {
+      return { type: "localImage", path: fileURLToPath(data) };
+    }
+    return { type: "image", url: data.href };
+  }
+  /**
+   * Resolve a single file part: write inline data via the writer, then
+   * convert to a Codex input item.  Text files are decoded and returned
+   * as text items.  Returns `null` for unsupported media types.
+   */
+  async resolveFilePart(part) {
+    const { mediaType, data } = part;
+    if (mediaType.startsWith("text/")) {
+      if (data instanceof URL) {
+        return textItem(data.href);
+      }
+      const text = typeof data === "string" ? Buffer.from(data, "base64").toString("utf-8") : new TextDecoder().decode(data);
+      return textItem(text);
+    }
+    if (mediaType.startsWith("image/") && !(data instanceof URL)) {
+      const url = await this.writer.write(data, mediaType);
+      this.written.push(url);
+      return this.mapImageUrl(mediaType, url);
+    }
+    if (data instanceof URL) {
+      return this.mapImageUrl(mediaType, data);
+    }
+    return null;
+  }
+  /**
+   * Resume path: extract parts from the last user message individually.
+   */
+  async resolveResumed(prompt) {
     for (let i = prompt.length - 1; i >= 0; i--) {
       const message = prompt[i];
       if (message?.role === "user") {
@@ -1339,7 +1445,12 @@ function mapPromptToTurnInput(prompt, isResume = false) {
           if (part.type === "text") {
             const text = part.text.trim();
             if (text.length > 0) {
-              items.push({ type: "text", text, text_elements: [] });
+              items.push(textItem(text));
+            }
+          } else if (part.type === "file") {
+            const mapped = await this.resolveFilePart(part);
+            if (mapped) {
+              items.push(mapped);
             }
           }
         }
@@ -1348,21 +1459,45 @@ function mapPromptToTurnInput(prompt, isResume = false) {
     }
     return [];
   }
-  const chunks = [];
-  for (const message of prompt) {
-    if (message.role === "user") {
-      for (const part of message.content) {
-        if (part.type === "text") {
-          const text = part.text.trim();
-          if (text.length > 0) {
-            chunks.push(text);
+  /**
+   * Fresh thread path: accumulate text chunks across all user messages,
+   * flushing before each image to preserve ordering.
+   */
+  async resolveFresh(prompt) {
+    const items = [];
+    const textChunks = [];
+    const flushText = () => {
+      if (textChunks.length > 0) {
+        items.push(textItem(textChunks.join("\n\n")));
+        textChunks.length = 0;
+      }
+    };
+    for (const message of prompt) {
+      if (message.role === "user") {
+        for (const part of message.content) {
+          if (part.type === "text") {
+            const text = part.text.trim();
+            if (text.length > 0) {
+              textChunks.push(text);
+            }
+          } else if (part.type === "file") {
+            const mapped = await this.resolveFilePart(part);
+            if (mapped) {
+              if (mapped.type === "text") {
+                textChunks.push(mapped.text);
+              } else {
+                flushText();
+                items.push(mapped);
+              }
+            }
           }
         }
       }
     }
+    flushText();
+    return items;
   }
-  return [{ type: "text", text: chunks.join("\n\n"), text_elements: [] }];
-}
+};
 
 // src/model.ts
 function createEmptyUsage() {
@@ -1629,6 +1764,7 @@ var CodexLanguageModel = class {
       debugLog?.("outbound", "turn/interrupt", interruptParams);
       await client.request("turn/interrupt", interruptParams, interruptTimeoutMs);
     };
+    const fileResolver = new PromptFileResolver();
     const stream = new ReadableStream({
       start: (controller) => {
         let closed = false;
@@ -1641,6 +1777,7 @@ var CodexLanguageModel = class {
           try {
             controller.close();
           } finally {
+            await fileResolver.cleanup();
             await client.disconnect();
           }
         };
@@ -1652,6 +1789,7 @@ var CodexLanguageModel = class {
           try {
             controller.close();
           } finally {
+            await fileResolver.cleanup();
             await client.disconnect();
           }
         };
@@ -1876,7 +2014,7 @@ var CodexLanguageModel = class {
                 closeSuccessfully
               );
             }
-            const turnInput = mapPromptToTurnInput(options.prompt, !!resumeThreadId);
+            const turnInput = await fileResolver.resolve(options.prompt, !!resumeThreadId);
             const turnStartParams = stripUndefined({
               threadId,
               input: turnInput,
@@ -1900,6 +2038,7 @@ var CodexLanguageModel = class {
           await interruptTurnIfPossible();
         } catch {
         }
+        await fileResolver.cleanup();
         await client.disconnect();
       }
     });
@@ -2070,6 +2209,6 @@ function createCodexAppServer(settings = {}) {
 var codexAppServer = createCodexAppServer();
 var createCodexProvider = createCodexAppServer;
 
-export { AppServerClient, ApprovalsDispatcher, CODEX_PROVIDER_ID, CodexEventMapper, CodexLanguageModel, CodexNotImplementedError, CodexProviderError, CodexWorker, CodexWorkerPool, DynamicToolsDispatcher, JsonRpcError, PACKAGE_NAME, PACKAGE_VERSION, PersistentTransport, StdioTransport, WebSocketTransport, codexAppServer, codexProviderMetadata, createCodexAppServer, createCodexProvider, mapPromptToTurnInput, mapSystemPrompt, withProviderMetadata };
+export { AppServerClient, ApprovalsDispatcher, CODEX_PROVIDER_ID, CodexEventMapper, CodexLanguageModel, CodexNotImplementedError, CodexProviderError, CodexWorker, CodexWorkerPool, DynamicToolsDispatcher, JsonRpcError, LocalFileWriter, PACKAGE_NAME, PACKAGE_VERSION, PersistentTransport, PromptFileResolver, StdioTransport, WebSocketTransport, codexAppServer, codexProviderMetadata, createCodexAppServer, createCodexProvider, mapSystemPrompt, withProviderMetadata };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map