Merge branch 'main' into mcp-docs

Author: dkundel-openai

.changeset/crazy-coats-give.md

@@ -0,0 +1,5 @@
+---
+'@openai/agents-core': patch
+---
+
+Add remote MCP server (Streamable HTTP) support

.changeset/eighty-dingos-pump.md

@@ -0,0 +1,6 @@
+---
+"@openai/agents-core": patch
+"@openai/agents-openai": patch
+---
+
+Add allowed_tools and headers to hosted mcp server factory method

.changeset/tired-experts-care.md

@@ -0,0 +1,5 @@
+---
+'@openai/agents-core': patch
+---
+
+Publishes types that were marked as internal but caused build errors when not exported in typings.

AGENTS.md

@@ -43,7 +43,7 @@ The OpenAI Agents JS repository is a pnpm-managed monorepo that provides:
 - `pnpm-workspace.yaml`: Defines workspace packages.
 - `tsconfig.json`, `tsc-multi.json`: TypeScript configuration.
 - `vitest.config.ts`: Test runner configuration.
-- `eslint.config.js`: ESLint configuration.
+- `eslint.config.mjs`: ESLint configuration.
 - `package.json` (root): Common scripts (`build`, `test`, `lint`, `dev`, `docs:dev`, `examples:*`).
 
 ## Testing & Automated Checks
@@ -81,7 +81,7 @@ Before submitting changes, ensure all checks pass:
   ```bash
   pnpm lint
   ```
-- Code style follows `eslint.config.js` and Prettier defaults.
+- Code style follows `eslint.config.mjs` and Prettier defaults.
 - Comments must end with a period.
 
 ### Type Checking
@@ -128,7 +128,7 @@ Before submitting changes, ensure all checks pass:
 
 ## Style, Linting & Type Checking
 
-- Follow ESLint rules (`eslint.config.js`), no unused imports, adhere to Prettier.
+- Follow ESLint rules (`eslint.config.mjs`), no unused imports, adhere to Prettier.
 - Run `pnpm lint` and fix all errors locally.
 - Use `pnpm build` to catch type errors.
 

eslint.config.js renamed to eslint.config.mjs

@@ -16,7 +16,7 @@ async function main() {
   try {
     await withTrace('MCP Filesystem Example', async () => {
       const agent = new Agent({
-        name: 'Assistant',
+        name: 'MCP Assistant',
         instructions:
           'Use the tools to read the filesystem and answer questions based on those files. If you are unable to find any files, you can say so instead of assuming they exist.',
         mcpServers: [mcpServer],
@@ -25,20 +25,20 @@ async function main() {
       let message = 'Read the files and list them.';
       console.log(`Running: ${message}`);
       let result = await run(agent, message);
-      console.log(result.finalOutput ?? result.output ?? result);
+      console.log(result.finalOutput);
 
       // Ask about books
       message = 'What is my #1 favorite book?';
       console.log(`\nRunning: ${message}\n`);
       result = await run(agent, message);
-      console.log(result.finalOutput ?? result.output ?? result);
+      console.log(result.finalOutput);
 
       // Ask a question that reads then reasons
       message =
         'Look at my favorite songs. Suggest one new song that I might like.';
       console.log(`\nRunning: ${message}\n`);
       result = await run(agent, message);
-      console.log(result.finalOutput ?? result.output ?? result);
+      console.log(result.finalOutput);
     });
   } finally {
     await mcpServer.close();

examples/mcp/filesystem-example.ts

@@ -1,8 +1,8 @@
-import * as readline from 'readline/promises';
-import { stdin, stdout } from 'node:process';
 import { Agent, run, hostedMcpTool, RunToolApprovalItem } from '@openai/agents';
+import * as readline from 'node:readline/promises';
+import { stdin, stdout } from 'node:process';
 
-async function promptApproval(item: RunToolApprovalItem): Promise<boolean> {
+async function confirm(item: RunToolApprovalItem): Promise<boolean> {
   const rl = readline.createInterface({ input: stdin, output: stdout });
   const name = item.rawItem.name;
   const params = JSON.parse(item.rawItem.providerData?.arguments || '{}');
@@ -14,9 +14,7 @@ async function promptApproval(item: RunToolApprovalItem): Promise<boolean> {
 }
 
 async function main(verbose: boolean, stream: boolean): Promise<void> {
-  // 'always' |
-  // 'never'  |
-  // { never?: { toolNames: string[] }; always?: { toolNames: string[] } }
+  // 'always' | 'never' | { never, always }
   const requireApproval = {
     never: { toolNames: ['search_codex_code', 'fetch_codex_documentation'] },
     always: { toolNames: ['fetch_generic_url_content'] },
@@ -54,17 +52,18 @@ async function main(verbose: boolean, stream: boolean): Promise<void> {
     console.log(`Done streaming; final result: ${result.finalOutput}`);
   } else {
     // Non-streaming
-    let result = await run(agent, input, { maxTurns: 100 });
+    let result = await run(agent, input);
     while (result.interruptions && result.interruptions.length) {
       for (const interruption of result.interruptions) {
-        const approval = await promptApproval(interruption);
+        // Human in the loop here
+        const approval = await confirm(interruption);
         if (approval) {
           result.state.approve(interruption);
         } else {
           result.state.reject(interruption);
         }
       }
-      result = await run(agent, result.state, { maxTurns: 100 });
+      result = await run(agent, result.state);
     }
     console.log(result.finalOutput);
 

examples/mcp/hosted-mcp-human-in-the-loop.ts

@@ -14,9 +14,7 @@ async function promptApproval(item: RunToolApprovalItem): Promise<boolean> {
 }
 
 async function main(verbose: boolean, stream: boolean): Promise<void> {
-  // 'always' |
-  // 'never'  |
-  // { never?: { toolNames: string[] }; always?: { toolNames: string[] } }
+  // 'always' | 'never' | { never, always }
   const requireApproval = {
     never: {
       toolNames: ['fetch_codex_documentation', 'fetch_generic_url_content'],
@@ -34,6 +32,7 @@ async function main(verbose: boolean, stream: boolean): Promise<void> {
         serverUrl: 'https://gitmcp.io/openai/codex',
         requireApproval,
         onApproval: async (_context, item) => {
+          // Human in the loop here
           const approval = await promptApproval(item);
           return { approve: approval, reason: undefined };
         },

examples/mcp/hosted-mcp-on-approval.ts

@@ -9,7 +9,6 @@ async function main(verbose: boolean, stream: boolean): Promise<void> {
         hostedMcpTool({
           serverLabel: 'gitmcp',
           serverUrl: 'https://gitmcp.io/openai/codex',
-          requireApproval: 'never',
         }),
       ],
     });

examples/mcp/hosted-mcp-simple.ts

@@ -9,6 +9,7 @@
   "scripts": {
     "build-check": "tsc --noEmit",
     "start:stdio": "tsx filesystem-example.ts",
+    "start:streamable-http": "tsx streamable-http-example.ts",
     "start:hosted-mcp-on-approval": "tsx hosted-mcp-on-approval.ts",
     "start:hosted-mcp-human-in-the-loop": "tsx hosted-mcp-human-in-the-loop.ts",
     "start:hosted-mcp-simple": "tsx hosted-mcp-simple.ts"