Fix #216 Publicly accessible PDF file URL is not yet supported in the input_file content data

Author: seratch

examples/basic/package.json

@@ -17,6 +17,7 @@
     "start:previous-response-id": "tsx previous-response-id.ts",
     "start:prompt": "tsx prompt-id.ts",
     "start:remote-image": "tsx remote-image.ts",
+    "start:remote-pdf": "tsx remote-pdf.ts",
     "start:stream-items": "tsx stream-items.ts",
     "start:stream-text": "tsx stream-text.ts",
     "start:json-schema-output-type": "tsx json-schema-output-type.ts",

examples/basic/remote-pdf.ts

@@ -0,0 +1,27 @@
+import { Agent, run } from '@openai/agents';
+
+const URL = 'https://www.berkshirehathaway.com/letters/2024ltr.pdf';
+
+async function main() {
+  const agent = new Agent({
+    name: 'Assistant',
+    instructions: 'You are a helpful assistant.',
+  });
+
+  const result = await run(agent, [
+    {
+      role: 'user',
+      content: [{ type: 'input_file', file: URL }],
+    },
+    {
+      role: 'user',
+      content: 'Can you summarize the letter?',
+    },
+  ]);
+
+  console.log(result.finalOutput);
+}
+
+if (require.main === module) {
+  main().catch(console.error);
+}

examples/docs/package.json

@@ -8,7 +8,7 @@
     "@openai/agents-extensions": "workspace:*",
     "@ai-sdk/openai": "^1.0.0",
     "server-only": "^0.0.1",
-    "openai": "^5.0.1",
+    "openai": "^5.10.1",
     "zod": "3.25.40 - 3.25.67"
   },
   "scripts": {

packages/agents-core/package.json

@@ -90,7 +90,7 @@
   "dependencies": {
     "@openai/zod": "npm:[email protected] - 3.25.67",
     "debug": "^4.4.0",
-    "openai": "^5.0.1"
+    "openai": "^5.10.1"
   },
   "peerDependencies": {
     "zod": "3.25.40 - 3.25.67"

packages/agents-core/src/types/protocol.ts

@@ -91,9 +91,17 @@ export const InputFile = SharedBase.extend({
    */
   file: z
     .string()
+    .describe(
+      'Either base64 encoded file data or a publicly accessible file URL',
+    )
     .or(
       z.object({
-        id: z.string(),
+        id: z.string().describe('OpenAI file ID'),
+      }),
+    )
+    .or(
+      z.object({
+        url: z.string().describe('Publicly accessible PDF file URL'),
       }),
     )
     .describe('Contents of the file or an object with a file ID.'),

packages/agents-openai/package.json

@@ -20,7 +20,7 @@
   "dependencies": {
     "@openai/agents-core": "workspace:*",
     "debug": "^4.4.0",
-    "openai": "^5.0.1",
+    "openai": "^5.10.1",
     "@openai/zod": "npm:[email protected] - 3.25.67"
   },
   "scripts": {

packages/agents-openai/src/openaiResponsesModel.ts

@@ -265,9 +265,19 @@ function getInputMessageContent(
       type: 'input_file',
     };
     if (typeof entry.file === 'string') {
-      fileEntry.file_data = entry.file;
-    } else {
+      if (entry.file.startsWith('data:')) {
+        fileEntry.file_data = entry.file;
+      } else if (entry.file.startsWith('https://')) {
+        fileEntry.file_url = entry.file;
+      } else {
+        throw new UserError(
+          `Unsupported string data for file input. If you're trying to pass an uploaded file's ID, use an object with the ID property instead.`,
+        );
+      }
+    } else if ('id' in entry.file) {
       fileEntry.file_id = entry.file.id;
+    } else if ('url' in entry.file) {
+      fileEntry.file_url = entry.file.url;
     }
     return {
       ...fileEntry,
@@ -525,7 +535,10 @@ function getInputItems(
           type: 'code_interpreter_call',
           id: item.id!,
           code: item.providerData?.code ?? '',
-          results: item.providerData?.results ?? [],
+          // This property used to be results, so keeping both for backward compatibility
+          // That said, this property cannot be passed from a user, so it's just API's internal data.
+          outputs:
+            item.providerData?.outputs ?? item.providerData?.results ?? [],
           status: CodeInterpreterStatus.parse(item.status ?? 'failed'),
           container_id: item.providerData?.containerId,
         };

packages/agents/package.json

@@ -42,7 +42,7 @@
     "@openai/agents-core": "workspace:*",
     "@openai/agents-openai": "workspace:*",
     "@openai/agents-realtime": "workspace:*",
-    "openai": "^5.0.1",
+    "openai": "^5.10.1",
     "debug": "^4.4.0"
   },
   "keywords": [