address PR review comments

- Remove AGENTS.md reference to migration guide
- Add note that OpenAITransport is not yet available (PR #172)
- Remove unnecessary note about return type ordering

Author: ochafik

AGENTS.md

@@ -85,7 +85,3 @@ Uses npm workspaces. Examples in `examples/` are separate packages:
 - `basic-server-*` - Starter templates (vanillajs, react, vue, svelte, preact, solid). Use these as the basis for new examples.
 - `basic-host` - Reference host implementation
 - Other examples showcase specific features (charts, 3D, video, etc.)
-
-## Migrating code from OpenAI Apps SDK to MCP Apps
-
-See [Migrating from OpenAI Apps SDK to MCP Apps SDK](./docs/migrate_from_openai_apps.md)

docs/migrate_from_openai_apps.md

@@ -16,7 +16,7 @@ This guide helps you migrate from the OpenAI Apps SDK (`window.openai.*`) to the
 | -------------------------------- | -------------------------------------------------- | ------------------------------------------------------ |
 | `window.openai` (auto-available) | `const app = new App({name, version}, {})`         | MCP requires explicit instantiation                    |
 | (implicit)                       | `await app.connect()`                              | MCP requires async connection; auto-detects OpenAI env |
-| —                                | `await app.connect(new OpenAITransport())`         | Force OpenAI mode explicitly                           |
+| —                                | `await app.connect(new OpenAITransport())`         | Force OpenAI mode (not yet available, see [PR #172](https://github.com/modelcontextprotocol/ext-apps/pull/172)) |
 | —                                | `await app.connect(new PostMessageTransport(...))` | Force MCP mode explicitly                              |
 
 ## Host Context Properties
@@ -44,10 +44,9 @@ This guide helps you migrate from the OpenAI Apps SDK (`window.openai.*`) to the
 
 ## Calling Tools
 
-| OpenAI                                               | MCP Apps                                              | Notes                                   |
-| ---------------------------------------------------- | ----------------------------------------------------- | --------------------------------------- |
-| `await window.openai.callTool(name, args)`           | `await app.callServerTool({ name, arguments: args })` | Call another MCP server tool            |
-| Returns `{ structuredContent?, content?, isError? }` | Returns `{ content, structuredContent?, isError? }`   | Same shape, slightly different ordering |
+| OpenAI                                     | MCP Apps                                              | Notes                        |
+| ------------------------------------------ | ----------------------------------------------------- | ---------------------------- |
+| `await window.openai.callTool(name, args)` | `await app.callServerTool({ name, arguments: args })` | Call another MCP server tool |
 
 ## Sending Messages