@apollo/client-ai-apps 0.5.4 → 0.6.1

package/CHANGELOG.md

@@ -1,3 +1,183 @@
+## 0.6.1 (2026-03-11)
+
+### Features
+
+#### Add `useToolInfo` hook
+
+A new `useToolInfo()` hook is now available that combines `useToolName()` and `useToolInput()` into a single hook. `useToolInfo` is more type-safe and automatically narrows the `toolInput` type based on the `toolName`.
+
+```typescript
+// With toolInputs registered for "CreateTodo" and "DeleteTodo":
+const info = useToolInfo();
+// info: { toolName: "CreateTodo"; toolInput: CreateTodoInput }
+//     | { toolName: "DeleteTodo"; toolInput: DeleteTodoInput }
+//     | undefined
+
+if (info?.toolName === "CreateTodo") {
+  // info.toolInput is narrowed to `CreateTodoInput`
+  doSomething(info.toolInput.title);
+}
+```
+
+As a result, `useToolName()` and `useToolInput()` are now deprecated in favor of `useToolInfo()`. These hooks will be removed with the next major version.
+
+#### Generate a TypeScript definition file for `.application-manifest.json`
+
+The Vite plugin now generates a `.application-manifest.json.d.ts` TypeScript declaration file next to `.application-manifest.json`. This file declares the manifest as `ApplicationManifest`, so TypeScript infers the correct type automatically when you import it.
+
+This removes the need to type cast the `manifest` when initializing `ApolloClient`:
+
+```typescript
+// before
+import manifest from "./.application-manifest.json";
+
+const client = new ApolloClient({
+  manifest: manifest as ApplicationManifest, // cast required
+});
+
+// after
+import manifest from "./.application-manifest.json";
+
+const client = new ApolloClient({
+  manifest, // type is inferred as ApplicationManifest
+});
+```
+
+> [!NOTE]
+> This requires the TypeScript `allowArbitraryExtensions` option. Please ensure your `tsconfig.json` extends one of the provided `tsconfig`, or add these compiler options manually:
+
+```json
+{
+  "compilerOptions": {
+    "allowArbitraryExtensions": true,
+    "resolveJsonModule": true
+  }
+}
+```
+
+#### Add type-safe tool names
+
+The Vite plugin now generates a `.apollo-client-ai-apps/types/register.d.ts` TypeScript declaration file. This file contains a union of all tool names found in your app's `@tool` directives.
+
+This means the `useToolName()` hook now provides the precise union of tool names instead of `string | undefined`:
+
+```typescript
+// before
+const toolName = useToolName(); // string | undefined
+
+// after (with @tool directives on "CreateTodo", "DeleteTodo", "UpdateTodo")
+const toolName = useToolName(); // "CreateTodo" | "DeleteTodo" | "UpdateTodo" | undefined
+```
+
+The generated file is written to `.apollo-client-ai-apps/types/register.d.ts` and is kept up to date as you edit your operations. Add this path to your `tsconfig.json` `include` to ensure these types are included:
+
+```json
+{
+  "include": ["src", ".apollo-client-ai-apps/types"]
+}
+```
+
+You might also consider adding `.apollo-client-ai-apps/` to your `.gitignore` since it is fully generated.
+
+The `ToolName` type is exported from `@apollo/client-ai-apps` if you need access to the available tool names for your own utilities.
+
+#### `@tool` `name` and `description` arguments are now optional
+
+The `name` and `description` arguments on the `@tool` directive are now optional. When omitted, they fall back to the operation name and description respectively.
+
+```graphql
+## name defaults to "HelloWorldQuery", description defaults to the operation description
+"""
+Say hello to the world.
+"""
+query HelloWorldQuery @tool {
+  helloWorld
+}
+```
+
+Tool `name` and `description` are still enforced and must be set either by the operation or the `@tool` arguments. An anonymous operation or an operation that omits the description while using a bare `@tool` directive fails validation.
+
+When an operation has multiple `@tool` directives, `name` and `description` must still be provided explicitly on each directive to avoid ambiguity.
+
+```graphql
+## ✅ Valid — each @tool has an explicit name and description
+query ProductsQuery
+@tool(name: "list-products", description: "List all products")
+@tool(name: "search-products", description: "Search products by keyword") {
+  products {
+    id
+    title
+  }
+}
+
+## ❌ Error — missing name on second @tool when multiple are present
+query ProductsQuery
+@tool(name: "list-products", description: "List all products")
+@tool(description: "Search products") {
+  products {
+    id
+    title
+  }
+}
+```
+
+## 0.6.0 (2026-03-06)
+
+### Breaking Changes
+
+#### Added a new required `appsOutDir` option to the `apolloClientAiApps` Vite plugin
+
+The `apolloClientAiApps` Vite plugin now requires an `appsOutDir` option that controls where build output is written. The value must end with `apps` as the final path segment (e.g. `"dist/apps"`).
+
+```ts
+apolloClientAiApps({ targets: ["mcp"], appsOutDir: "dist/apps" });
+```
+
+The plugin will now write the application manifest to `<appsOutDir>/<appName>/.application-manifest.json`, where `appName` is taken from the `name` field in your `apollo-client-ai-apps` config or `package.json`. Previously, the output location was derived from `build.outDir` in your Vite config. Setting `build.outDir` alongside this plugin will now emit a warning that it is ignored.
+
+This option replaces `build.outDir`. Setting `build.outDir` now emits a warning and the value is ignored. To migrate, please move the path from `build.outDir` to the `appsOutDir` option in the `apolloClientAiApps` plugin.
+
+```diff
+// vite.config.ts
+export default defineConfig({
+- build: {
+-   outDir: "../../apps",
+- },
+  plugins: [
+    apolloClientAiApps({
+      targets: ["mcp"],
++     appsOutDir: "../../apps" ,
+    }),
+  ],
+});
+```
+
+### Features
+
+#### Add `baseUriDomains` to CSP config
+
+Adds support for configuring `baseUriDomains` in CSP settings. Only available for MCP apps.
+
+#### Add a `useHostContext` hook
+
+Adds a new `useHostContext` hook that returns the current host context from the MCP host.
+
+```typescript
+import { useHostContext } from "@apollo/client-ai-apps/react";
+
+function MyComponent() {
+  const hostContext = useHostContext();
+
+  // ...
+}
+```
+
+### Fixes
+
+#### `@modelcontextprotocol/ext-apps` is now a required peer dependency
+
+`@modelcontextprotocol/ext-apps` is now a required peer dependency and must be installed along with this library.
+
 ## 0.5.4 (2026-02-27)
 
 ### Fixes

package/dist/config/defineConfig.d.ts

@@ -12,6 +12,7 @@ export declare function defineConfig(config: ApolloClientAiAppsConfig.Config): {
         frameDomains?: string[];
         redirectDomains?: string[];
         resourceDomains?: string[];
+        baseUriDomains?: string[];
     };
     widgetSettings?: {
         prefersBorder?: boolean;

package/dist/config/defineConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defineConfig.d.ts","sourceRoot":"","sources":["../../src/config/defineConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3D;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,wBAAwB,CAAC,MAAM;;;;;;;;;;;;;;;;;;;;;;EAEnE"}
+{"version":3,"file":"defineConfig.d.ts","sourceRoot":"","sources":["../../src/config/defineConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3D;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,wBAAwB,CAAC,MAAM;;;;;;;;;;;;;;;;;;;;;;;EAEnE"}

package/dist/config/schema.d.ts

@@ -10,6 +10,7 @@ export declare const ApolloClientAiAppsConfigSchema: z.ZodObject<{
         frameDomains: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
         redirectDomains: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
         resourceDomains: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
+        baseUriDomains: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>>;
     widgetSettings: z.ZodExactOptional<z.ZodObject<{
         prefersBorder: z.ZodExactOptional<z.ZodBoolean>;

package/dist/config/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,SAAS,gCAA+B,CAAC;AAwBtD,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;kBA8CzC,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,SAAS,gCAA+B,CAAC;AAwBtD,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;kBA+CzC,CAAC"}

package/dist/config/schema.js

@@ -23,6 +23,7 @@ export const ApolloClientAiAppsConfigSchema = z.strictObject({
         frameDomains: z.array(z.string()).exactOptional(),
         redirectDomains: z.array(z.string()).exactOptional(),
         resourceDomains: z.array(z.string()).exactOptional(),
+        baseUriDomains: z.array(z.string()).exactOptional(),
     })),
     widgetSettings: z.exactOptional(z.strictObject({
         prefersBorder: z.boolean().exactOptional(),

package/dist/config/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\n\nexport const AppTarget = z.literal([\"mcp\", \"openai\"]);\n\nconst Mode = z\n  .literal([\"development\", \"production\"])\n  .or(z.custom<string & {}>((value) => typeof value === \"string\"));\n\nconst labelsInput = z.exactOptional(\n  z.strictObject({\n    toolInvocation: z.exactOptional(\n      z.strictObject({\n        invoking: z.string().exactOptional(),\n        invoked: z.string().exactOptional(),\n      })\n    ),\n  })\n);\n\nconst labelsOutput = z.exactOptional(\n  z.strictObject({\n    \"toolInvocation/invoking\": z.string().exactOptional(),\n    \"toolInvocation/invoked\": z.string().exactOptional(),\n  })\n);\n\nexport const ApolloClientAiAppsConfigSchema = z.strictObject({\n  name: z.string().exactOptional(),\n  description: z.string().exactOptional(),\n  version: z.string().exactOptional(),\n  entry: z.exactOptional(\n    z.partialRecord(\n      Mode,\n      z.union([z.string(), z.partialRecord(AppTarget, z.string())])\n    )\n  ),\n  csp: z.exactOptional(\n    z.strictObject({\n      connectDomains: z.array(z.string()).exactOptional(),\n      frameDomains: z.array(z.string()).exactOptional(),\n      redirectDomains: z.array(z.string()).exactOptional(),\n      resourceDomains: z.array(z.string()).exactOptional(),\n    })\n  ),\n  widgetSettings: z.exactOptional(\n    z.strictObject({\n      prefersBorder: z.boolean().exactOptional(),\n      description: z.string().exactOptional(),\n      domain: z.string().exactOptional(),\n    })\n  ),\n  labels: z.codec(labelsInput, labelsOutput, {\n    encode: () => {\n      // encode is currently not used so we can skip the business logic and\n      // return an empty object which satisfies the type. If we need to encode\n      // labels back to the original form, this will need to be implemented\n      return {};\n    },\n    decode: ({ toolInvocation }) => {\n      const config: z.infer<typeof labelsOutput> = {};\n\n      if (toolInvocation?.invoking) {\n        config[\"toolInvocation/invoking\"] = toolInvocation.invoking;\n      }\n\n      if (toolInvocation?.invoked) {\n        config[\"toolInvocation/invoked\"] = toolInvocation.invoked;\n      }\n\n      return config;\n    },\n  }),\n});\n"]}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\n\nexport const AppTarget = z.literal([\"mcp\", \"openai\"]);\n\nconst Mode = z\n  .literal([\"development\", \"production\"])\n  .or(z.custom<string & {}>((value) => typeof value === \"string\"));\n\nconst labelsInput = z.exactOptional(\n  z.strictObject({\n    toolInvocation: z.exactOptional(\n      z.strictObject({\n        invoking: z.string().exactOptional(),\n        invoked: z.string().exactOptional(),\n      })\n    ),\n  })\n);\n\nconst labelsOutput = z.exactOptional(\n  z.strictObject({\n    \"toolInvocation/invoking\": z.string().exactOptional(),\n    \"toolInvocation/invoked\": z.string().exactOptional(),\n  })\n);\n\nexport const ApolloClientAiAppsConfigSchema = z.strictObject({\n  name: z.string().exactOptional(),\n  description: z.string().exactOptional(),\n  version: z.string().exactOptional(),\n  entry: z.exactOptional(\n    z.partialRecord(\n      Mode,\n      z.union([z.string(), z.partialRecord(AppTarget, z.string())])\n    )\n  ),\n  csp: z.exactOptional(\n    z.strictObject({\n      connectDomains: z.array(z.string()).exactOptional(),\n      frameDomains: z.array(z.string()).exactOptional(),\n      redirectDomains: z.array(z.string()).exactOptional(),\n      resourceDomains: z.array(z.string()).exactOptional(),\n      baseUriDomains: z.array(z.string()).exactOptional(),\n    })\n  ),\n  widgetSettings: z.exactOptional(\n    z.strictObject({\n      prefersBorder: z.boolean().exactOptional(),\n      description: z.string().exactOptional(),\n      domain: z.string().exactOptional(),\n    })\n  ),\n  labels: z.codec(labelsInput, labelsOutput, {\n    encode: () => {\n      // encode is currently not used so we can skip the business logic and\n      // return an empty object which satisfies the type. If we need to encode\n      // labels back to the original form, this will need to be implemented\n      return {};\n    },\n    decode: ({ toolInvocation }) => {\n      const config: z.infer<typeof labelsOutput> = {};\n\n      if (toolInvocation?.invoking) {\n        config[\"toolInvocation/invoking\"] = toolInvocation.invoking;\n      }\n\n      if (toolInvocation?.invoked) {\n        config[\"toolInvocation/invoked\"] = toolInvocation.invoked;\n      }\n\n      return config;\n    },\n  }),\n});\n"]}

package/dist/core/typeRegistration.d.ts

@@ -0,0 +1,33 @@
+export interface Register {
+}
+/**
+ * @deprecated Please use the `ToolInfo` type instead. `ToolName` will be
+ * removed in the next major version.
+ */
+export type ToolName = Register extends {
+    toolName: infer T extends string;
+} ? T : string;
+type RegisteredToolInputs = Register extends {
+    toolInputs: infer T extends Record<string, unknown>;
+} ? T : never;
+/**
+ * @deprecated Please use the `ToolInfo` type instead. `ToolInput` will be
+ * removed in the next major version.
+ */
+export type ToolInput = [
+    RegisteredToolInputs
+] extends [never] ? Record<string, unknown> : RegisteredToolInputs[keyof RegisteredToolInputs];
+type ToolInfoFromInputs<T extends Record<string, unknown>> = {
+    [K in keyof T]: {
+        toolName: K;
+        toolInput: T[K] extends Record<string, never> ? T[K] | undefined : T[K];
+    };
+}[keyof T];
+export type ToolInfo = [
+    RegisteredToolInputs
+] extends [never] ? {
+    toolName: string;
+    toolInput: Record<string, unknown> | undefined;
+} : ToolInfoFromInputs<RegisteredToolInputs>;
+export {};
+//# sourceMappingURL=typeRegistration.d.ts.map

package/dist/core/typeRegistration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeRegistration.d.ts","sourceRoot":"","sources":["../../src/core/typeRegistration.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;CAAG;AAE5B;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAClB,QAAQ,SAAS;IAAE,QAAQ,EAAE,MAAM,CAAC,SAAS,MAAM,CAAA;CAAE,GAAG,CAAC,GAAG,MAAM,CAAC;AAErE,KAAK,oBAAoB,GACvB,QAAQ,SAAS;IAAE,UAAU,EAAE,MAAM,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,CAAC,GAC1E,KAAK,CAAC;AAEV;;;GAGG;AACH,MAAM,MAAM,SAAS,GACnB;IAAC,oBAAoB;CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9D,oBAAoB,CAAC,MAAM,oBAAoB,CAAC,CAAC;AAErD,KAAK,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;KAC1D,CAAC,IAAI,MAAM,CAAC,GAAG;QACd,QAAQ,EAAE,CAAC,CAAC;QACZ,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;KACzE;CACF,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX,MAAM,MAAM,QAAQ,GAClB;IAAC,oBAAoB;CAAC,SAAS,CAAC,KAAK,CAAC,GACpC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;CAAE,GACpE,kBAAkB,CAAC,oBAAoB,CAAC,CAAC"}

package/dist/core/typeRegistration.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=typeRegistration.js.map

package/dist/core/typeRegistration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeRegistration.js","sourceRoot":"","sources":["../../src/core/typeRegistration.ts"],"names":[],"mappings":"","sourcesContent":["export interface Register {}\n\n/**\n * @deprecated Please use the `ToolInfo` type instead. `ToolName` will be\n * removed in the next major version.\n */\nexport type ToolName =\n  Register extends { toolName: infer T extends string } ? T : string;\n\ntype RegisteredToolInputs =\n  Register extends { toolInputs: infer T extends Record<string, unknown> } ? T\n  : never;\n\n/**\n * @deprecated Please use the `ToolInfo` type instead. `ToolInput` will be\n * removed in the next major version.\n */\nexport type ToolInput =\n  [RegisteredToolInputs] extends [never] ? Record<string, unknown>\n  : RegisteredToolInputs[keyof RegisteredToolInputs];\n\ntype ToolInfoFromInputs<T extends Record<string, unknown>> = {\n  [K in keyof T]: {\n    toolName: K;\n    toolInput: T[K] extends Record<string, never> ? T[K] | undefined : T[K];\n  };\n}[keyof T];\n\nexport type ToolInfo =\n  [RegisteredToolInputs] extends [never] ?\n    { toolName: string; toolInput: Record<string, unknown> | undefined }\n  : ToolInfoFromInputs<RegisteredToolInputs>;\n"]}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export type { ApplicationManifest, ManifestOperation, ManifestTool, ManifestExtraInput, ManifestCsp, ManifestLabels, ManifestWidgetSettings, } from "./types/application-manifest.js";
+export type { Register, ToolInfo, ToolInput, ToolName, } from "./core/typeRegistration.js";
 export { ApolloClient } from "./core/ApolloClient.js";
 export { ToolCallLink } from "./link/ToolCallLink.js";
 export { Platform } from "./core/Platform.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,sBAAsB,GACvB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,sBAAsB,GACvB,MAAM,iCAAiC,CAAC;AAEzC,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,QAAQ,GACT,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC","sourcesContent":["export type {\n  ApplicationManifest,\n  ManifestOperation,\n  ManifestTool,\n  ManifestExtraInput,\n  ManifestCsp,\n  ManifestLabels,\n  ManifestWidgetSettings,\n} from \"./types/application-manifest.js\";\n\nexport { ApolloClient } from \"./core/ApolloClient.js\";\nexport { ToolCallLink } from \"./link/ToolCallLink.js\";\n\nexport { Platform } from \"./core/Platform.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC","sourcesContent":["export type {\n  ApplicationManifest,\n  ManifestOperation,\n  ManifestTool,\n  ManifestExtraInput,\n  ManifestCsp,\n  ManifestLabels,\n  ManifestWidgetSettings,\n} from \"./types/application-manifest.js\";\n\nexport type {\n  Register,\n  ToolInfo,\n  ToolInput,\n  ToolName,\n} from \"./core/typeRegistration.js\";\n\nexport { ApolloClient } from \"./core/ApolloClient.js\";\nexport { ToolCallLink } from \"./link/ToolCallLink.js\";\n\nexport { Platform } from \"./core/Platform.js\";\n"]}

package/dist/mcp/core/McpAppManager.d.ts

@@ -1,4 +1,4 @@
-import { App } from "@modelcontextprotocol/ext-apps";
+import { App, type McpUiHostContextChangedNotification } from "@modelcontextprotocol/ext-apps";
 import type { ApplicationManifest } from "../../types/application-manifest";
 import type { FormattedExecutionResult } from "graphql";
 import type { DocumentNode, OperationVariables } from "@apollo/client";
@@ -11,6 +11,7 @@ export declare class McpAppManager {
     get toolName(): string | undefined;
     get toolMetadata(): ApolloMcpServerApps.Meta | undefined;
     get toolInput(): Record<string, unknown> | undefined;
+    onHostContextChanged(cb: (params: McpUiHostContextChangedNotification["params"]) => void): () => void;
     connect: (() => Promise<{
         toolName: string | undefined;
         args: Record<string, unknown> | undefined;

package/dist/mcp/core/McpAppManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"McpAppManager.d.ts","sourceRoot":"","sources":["../../../src/mcp/core/McpAppManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAwB,MAAM,gCAAgC,CAAC;AAE3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAM5D,gBAAgB;AAChB,qBAAa,aAAa;;IACxB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;gBAMN,QAAQ,EAAE,mBAAmB;IAIzC,IAAI,QAAQ,uBAEX;IAED,IAAI,YAAY,yCAEf;IAED,IAAI,SAAS,wCAEZ;IAED,OAAO;;;;;;;MAqCJ;IAEH,KAAK;IAIC,YAAY,CAAC,EACjB,KAAK,EACL,SAAS,GACV,EAAE;QACD,KAAK,EAAE,YAAY,CAAC;QACpB,SAAS,EAAE,kBAAkB,GAAG,SAAS,CAAC;KAC3C;YASa,aAAa;CAW5B"}
+{"version":3,"file":"McpAppManager.d.ts","sourceRoot":"","sources":["../../../src/mcp/core/McpAppManager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,GAAG,EAEH,KAAK,mCAAmC,EACzC,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAM5D,gBAAgB;AAChB,qBAAa,aAAa;;IACxB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;gBAUN,QAAQ,EAAE,mBAAmB;IAIzC,IAAI,QAAQ,uBAEX;IAED,IAAI,YAAY,yCAEf;IAED,IAAI,SAAS,wCAEZ;IAED,oBAAoB,CAClB,EAAE,EAAE,CAAC,MAAM,EAAE,mCAAmC,CAAC,QAAQ,CAAC,KAAK,IAAI;IASrE,OAAO;;;;;;;MAyCJ;IAEH,KAAK;IAIC,YAAY,CAAC,EACjB,KAAK,EACL,SAAS,GACV,EAAE;QACD,KAAK,EAAE,YAAY,CAAC;QACpB,SAAS,EAAE,kBAAkB,GAAG,SAAS,CAAC;KAC3C;YASa,aAAa;CAW5B"}

package/dist/mcp/core/McpAppManager.js

@@ -1,4 +1,4 @@
-import { App, PostMessageTransport } from "@modelcontextprotocol/ext-apps";
+import { App, PostMessageTransport, } from "@modelcontextprotocol/ext-apps";
 import { print } from "@apollo/client/utilities";
 import { cacheAsync, promiseWithResolvers } from "../../utilities";
 /** @internal */
@@ -7,6 +7,7 @@ export class McpAppManager {
     #toolName;
     #toolMetadata;
     #toolInput;
+    #hostContextCallbacks = new Set();
     constructor(manifest) {
         this.app = new App({ name: manifest.name, version: manifest.appVersion });
     }
@@ -19,6 +20,12 @@ export class McpAppManager {
     get toolInput() {
         return this.#toolInput;
     }
+    onHostContextChanged(cb) {
+        this.#hostContextCallbacks.add(cb);
+        return () => {
+            this.#hostContextCallbacks.delete(cb);
+        };
+    }
     connect = cacheAsync(async () => {
         let toolResult = promiseWithResolvers();
         let toolInput = promiseWithResolvers();
@@ -28,6 +35,9 @@ export class McpAppManager {
         this.app.ontoolinput = (params) => {
             toolInput.resolve(params);
         };
+        this.app.onhostcontextchanged = (params) => {
+            this.#hostContextCallbacks.forEach((cb) => cb(params));
+        };
         await this.connectToHost();
         const { structuredContent, _meta } = await toolResult.promise;
         const { arguments: args } = await toolInput.promise;

package/dist/mcp/core/McpAppManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"McpAppManager.js","sourceRoot":"","sources":["../../../src/mcp/core/McpAppManager.ts"],"names":[],"mappings":"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","sourcesContent":["import { App, PostMessageTransport } from \"@modelcontextprotocol/ext-apps\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport type { ApplicationManifest } from \"../../types/application-manifest\";\nimport type { FormattedExecutionResult } from \"graphql\";\nimport type { DocumentNode, OperationVariables } from \"@apollo/client\";\nimport { print } from \"@apollo/client/utilities\";\nimport { cacheAsync, promiseWithResolvers } from \"../../utilities\";\nimport type { ApolloMcpServerApps } from \"../../core/types\";\n\ntype ExecuteQueryCallToolResult = Omit<CallToolResult, \"structuredContent\"> & {\n  structuredContent: FormattedExecutionResult;\n};\n\n/** @internal */\nexport class McpAppManager {\n  readonly app: App;\n\n  #toolName: string | undefined;\n  #toolMetadata: ApolloMcpServerApps.CallToolResult[\"_meta\"] | undefined;\n  #toolInput: Record<string, unknown> | undefined;\n\n  constructor(manifest: ApplicationManifest) {\n    this.app = new App({ name: manifest.name, version: manifest.appVersion });\n  }\n\n  get toolName() {\n    return this.#toolName;\n  }\n\n  get toolMetadata() {\n    return this.#toolMetadata;\n  }\n\n  get toolInput() {\n    return this.#toolInput;\n  }\n\n  connect = cacheAsync(async () => {\n    let toolResult = promiseWithResolvers<ApolloMcpServerApps.CallToolResult>();\n    let toolInput = promiseWithResolvers<Parameters<App[\"ontoolinput\"]>[0]>();\n\n    this.app.ontoolresult = (params) => {\n      toolResult.resolve(\n        params as unknown as ApolloMcpServerApps.CallToolResult\n      );\n    };\n\n    this.app.ontoolinput = (params) => {\n      toolInput.resolve(params);\n    };\n\n    await this.connectToHost();\n\n    const { structuredContent, _meta } = await toolResult.promise;\n    const { arguments: args } = await toolInput.promise;\n\n    // Some hosts do not provide toolInfo in the ui/initialize response, so we\n    // fallback to `_meta.toolName` provided by Apollo MCP server if the value\n    // is not available.\n    this.#toolName =\n      this.app.getHostContext()?.toolInfo?.tool.name ??\n      _meta?.toolName ??\n      // Some hosts do not forward `_meta` nor do they provide `toolInfo`. Our\n      // MCP server provides `toolName` in `structuredContent` as a workaround\n      // that we can use if all else fails\n      structuredContent.toolName;\n    this.#toolMetadata = _meta;\n    this.#toolInput = args;\n\n    return {\n      ...structuredContent,\n      toolName: this.toolName,\n      args,\n    };\n  });\n\n  close() {\n    return this.app.close();\n  }\n\n  async executeQuery({\n    query,\n    variables,\n  }: {\n    query: DocumentNode;\n    variables: OperationVariables | undefined;\n  }) {\n    const result = (await this.app.callServerTool({\n      name: \"execute\",\n      arguments: { query: print(query), variables },\n    })) as ExecuteQueryCallToolResult;\n\n    return result.structuredContent;\n  }\n\n  private async connectToHost() {\n    try {\n      return await this.app.connect(\n        new PostMessageTransport(window.parent, window.parent)\n      );\n    } catch (e) {\n      const error = e instanceof Error ? e : new Error(\"Failed to connect\");\n\n      throw error;\n    }\n  }\n}\n"]}
+{"version":3,"file":"McpAppManager.js","sourceRoot":"","sources":["../../../src/mcp/core/McpAppManager.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  App,\n  PostMessageTransport,\n  type McpUiHostContextChangedNotification,\n} from \"@modelcontextprotocol/ext-apps\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport type { ApplicationManifest } from \"../../types/application-manifest\";\nimport type { FormattedExecutionResult } from \"graphql\";\nimport type { DocumentNode, OperationVariables } from \"@apollo/client\";\nimport { print } from \"@apollo/client/utilities\";\nimport { cacheAsync, promiseWithResolvers } from \"../../utilities\";\nimport type { ApolloMcpServerApps } from \"../../core/types\";\n\ntype ExecuteQueryCallToolResult = Omit<CallToolResult, \"structuredContent\"> & {\n  structuredContent: FormattedExecutionResult;\n};\n\n/** @internal */\nexport class McpAppManager {\n  readonly app: App;\n\n  #toolName: string | undefined;\n  #toolMetadata: ApolloMcpServerApps.CallToolResult[\"_meta\"] | undefined;\n  #toolInput: Record<string, unknown> | undefined;\n\n  #hostContextCallbacks = new Set<\n    (params: McpUiHostContextChangedNotification[\"params\"]) => void\n  >();\n\n  constructor(manifest: ApplicationManifest) {\n    this.app = new App({ name: manifest.name, version: manifest.appVersion });\n  }\n\n  get toolName() {\n    return this.#toolName;\n  }\n\n  get toolMetadata() {\n    return this.#toolMetadata;\n  }\n\n  get toolInput() {\n    return this.#toolInput;\n  }\n\n  onHostContextChanged(\n    cb: (params: McpUiHostContextChangedNotification[\"params\"]) => void\n  ) {\n    this.#hostContextCallbacks.add(cb);\n\n    return () => {\n      this.#hostContextCallbacks.delete(cb);\n    };\n  }\n\n  connect = cacheAsync(async () => {\n    let toolResult = promiseWithResolvers<ApolloMcpServerApps.CallToolResult>();\n    let toolInput = promiseWithResolvers<Parameters<App[\"ontoolinput\"]>[0]>();\n\n    this.app.ontoolresult = (params) => {\n      toolResult.resolve(\n        params as unknown as ApolloMcpServerApps.CallToolResult\n      );\n    };\n\n    this.app.ontoolinput = (params) => {\n      toolInput.resolve(params);\n    };\n\n    this.app.onhostcontextchanged = (params) => {\n      this.#hostContextCallbacks.forEach((cb) => cb(params));\n    };\n\n    await this.connectToHost();\n\n    const { structuredContent, _meta } = await toolResult.promise;\n    const { arguments: args } = await toolInput.promise;\n\n    // Some hosts do not provide toolInfo in the ui/initialize response, so we\n    // fallback to `_meta.toolName` provided by Apollo MCP server if the value\n    // is not available.\n    this.#toolName =\n      this.app.getHostContext()?.toolInfo?.tool.name ??\n      _meta?.toolName ??\n      // Some hosts do not forward `_meta` nor do they provide `toolInfo`. Our\n      // MCP server provides `toolName` in `structuredContent` as a workaround\n      // that we can use if all else fails\n      structuredContent.toolName;\n    this.#toolMetadata = _meta;\n    this.#toolInput = args;\n\n    return {\n      ...structuredContent,\n      toolName: this.toolName,\n      args,\n    };\n  });\n\n  close() {\n    return this.app.close();\n  }\n\n  async executeQuery({\n    query,\n    variables,\n  }: {\n    query: DocumentNode;\n    variables: OperationVariables | undefined;\n  }) {\n    const result = (await this.app.callServerTool({\n      name: \"execute\",\n      arguments: { query: print(query), variables },\n    })) as ExecuteQueryCallToolResult;\n\n    return result.structuredContent;\n  }\n\n  private async connectToHost() {\n    try {\n      return await this.app.connect(\n        new PostMessageTransport(window.parent, window.parent)\n      );\n    } catch (e) {\n      const error = e instanceof Error ? e : new Error(\"Failed to connect\");\n\n      throw error;\n    }\n  }\n}\n"]}

package/dist/mcp/react/hooks/useHostContext.d.ts

@@ -0,0 +1,2 @@
+export declare function useHostContext(): import("@modelcontextprotocol/ext-apps").McpUiHostContext | undefined;
+//# sourceMappingURL=useHostContext.d.ts.map

package/dist/mcp/react/hooks/useHostContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHostContext.d.ts","sourceRoot":"","sources":["../../../../src/mcp/react/hooks/useHostContext.ts"],"names":[],"mappings":"AAGA,wBAAgB,cAAc,0EAU7B"}

package/dist/mcp/react/hooks/useHostContext.js

@@ -0,0 +1,7 @@
+import { useCallback, useSyncExternalStore } from "react";
+import { useApolloClient } from "./useApolloClient";
+export function useHostContext() {
+    const appManager = useApolloClient()["appManager"];
+    return useSyncExternalStore(useCallback((update) => appManager.onHostContextChanged(update), [appManager]), () => appManager.app.getHostContext());
+}
+//# sourceMappingURL=useHostContext.js.map

package/dist/mcp/react/hooks/useHostContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHostContext.js","sourceRoot":"","sources":["../../../../src/mcp/react/hooks/useHostContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,UAAU,cAAc;IAC5B,MAAM,UAAU,GAAG,eAAe,EAAE,CAAC,YAAY,CAAC,CAAC;IAEnD,OAAO,oBAAoB,CACzB,WAAW,CACT,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,oBAAoB,CAAC,MAAM,CAAC,EACnD,CAAC,UAAU,CAAC,CACb,EACD,GAAG,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,cAAc,EAAE,CACtC,CAAC;AACJ,CAAC","sourcesContent":["import { useCallback, useSyncExternalStore } from \"react\";\nimport { useApolloClient } from \"./useApolloClient\";\n\nexport function useHostContext() {\n  const appManager = useApolloClient()[\"appManager\"];\n\n  return useSyncExternalStore(\n    useCallback(\n      (update) => appManager.onHostContextChanged(update),\n      [appManager]\n    ),\n    () => appManager.app.getHostContext()\n  );\n}\n"]}

package/dist/mcp/react/hooks/useToolInfo.d.ts

@@ -0,0 +1,3 @@
+import type { ToolInfo } from "../../../core/typeRegistration.js";
+export declare function useToolInfo(): ToolInfo | undefined;
+//# sourceMappingURL=useToolInfo.d.ts.map

package/dist/mcp/react/hooks/useToolInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useToolInfo.d.ts","sourceRoot":"","sources":["../../../../src/mcp/react/hooks/useToolInfo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAGlE,wBAAgB,WAAW,IAAI,QAAQ,GAAG,SAAS,CASlD"}

package/dist/mcp/react/hooks/useToolInfo.js

@@ -0,0 +1,10 @@
+import { useApolloClient } from "./useApolloClient.js";
+export function useToolInfo() {
+    const appManager = useApolloClient()["appManager"];
+    const toolName = appManager.toolName;
+    if (!toolName) {
+        return;
+    }
+    return { toolName, toolInput: appManager.toolInput };
+}
+//# sourceMappingURL=useToolInfo.js.map

package/dist/mcp/react/hooks/useToolInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useToolInfo.js","sourceRoot":"","sources":["../../../../src/mcp/react/hooks/useToolInfo.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,UAAU,WAAW;IACzB,MAAM,UAAU,GAAG,eAAe,EAAE,CAAC,YAAY,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;IAErC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;IACT,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC,SAAS,EAAE,CAAC;AACvD,CAAC","sourcesContent":["import type { ToolInfo } from \"../../../core/typeRegistration.js\";\nimport { useApolloClient } from \"./useApolloClient.js\";\n\nexport function useToolInfo(): ToolInfo | undefined {\n  const appManager = useApolloClient()[\"appManager\"];\n  const toolName = appManager.toolName;\n\n  if (!toolName) {\n    return;\n  }\n\n  return { toolName, toolInput: appManager.toolInput };\n}\n"]}

package/dist/mcp/react/hooks/useToolInput.d.ts

@@ -1,2 +1,7 @@
-export declare function useToolInput(): Record<string, unknown> | undefined;
+import type { ToolInput } from "../../../core/typeRegistration.js";
+/**
+ * @deprecated Please use the `useToolInfo` hook. `useToolInput` will be removed
+ * in the next major version.
+ */
+export declare function useToolInput(): ToolInput | undefined;
 //# sourceMappingURL=useToolInput.d.ts.map

package/dist/mcp/react/hooks/useToolInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useToolInput.d.ts","sourceRoot":"","sources":["../../../../src/mcp/react/hooks/useToolInput.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,wCAE3B"}
+{"version":3,"file":"useToolInput.d.ts","sourceRoot":"","sources":["../../../../src/mcp/react/hooks/useToolInput.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAGnE;;;GAGG;AACH,wBAAgB,YAAY,IAAI,SAAS,GAAG,SAAS,CAEpD"}

package/dist/mcp/react/hooks/useToolInput.js

@@ -1,4 +1,8 @@
 import { useApolloClient } from "./useApolloClient.js";
+/**
+ * @deprecated Please use the `useToolInfo` hook. `useToolInput` will be removed
+ * in the next major version.
+ */
 export function useToolInput() {
     return useApolloClient()["appManager"].toolInput;
 }

package/dist/mcp/react/hooks/useToolInput.js.map

@@ -1 +1 @@
-{"version":3,"file":"useToolInput.js","sourceRoot":"","sources":["../../../../src/mcp/react/hooks/useToolInput.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,UAAU,YAAY;IAC1B,OAAO,eAAe,EAAE,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC;AACnD,CAAC","sourcesContent":["import { useApolloClient } from \"./useApolloClient.js\";\n\nexport function useToolInput() {\n  return useApolloClient()[\"appManager\"].toolInput;\n}\n"]}
+{"version":3,"file":"useToolInput.js","sourceRoot":"","sources":["../../../../src/mcp/react/hooks/useToolInput.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,eAAe,EAAE,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC;AACnD,CAAC","sourcesContent":["import type { ToolInput } from \"../../../core/typeRegistration.js\";\nimport { useApolloClient } from \"./useApolloClient.js\";\n\n/**\n * @deprecated Please use the `useToolInfo` hook. `useToolInput` will be removed\n * in the next major version.\n */\nexport function useToolInput(): ToolInput | undefined {\n  return useApolloClient()[\"appManager\"].toolInput;\n}\n"]}

package/dist/mcp/react/hooks/useToolName.d.ts

@@ -1,2 +1,7 @@
-export declare function useToolName(): string | undefined;
+import type { ToolName } from "../../../core/typeRegistration.js";
+/**
+ * @deprecated Please use the `useToolInfo` hook. `useToolName` will be removed
+ * in the next major version.
+ */
+export declare function useToolName(): ToolName | undefined;
 //# sourceMappingURL=useToolName.d.ts.map

package/dist/mcp/react/hooks/useToolName.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useToolName.d.ts","sourceRoot":"","sources":["../../../../src/mcp/react/hooks/useToolName.ts"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,uBAE1B"}
+{"version":3,"file":"useToolName.d.ts","sourceRoot":"","sources":["../../../../src/mcp/react/hooks/useToolName.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAGlE;;;GAGG;AACH,wBAAgB,WAAW,IAAI,QAAQ,GAAG,SAAS,CAElD"}

package/dist/mcp/react/hooks/useToolName.js

@@ -1,4 +1,8 @@
 import { useApolloClient } from "./useApolloClient.js";
+/**
+ * @deprecated Please use the `useToolInfo` hook. `useToolName` will be removed
+ * in the next major version.
+ */
 export function useToolName() {
     return useApolloClient()["appManager"].toolName;
 }

package/dist/mcp/react/hooks/useToolName.js.map

@@ -1 +1 @@
-{"version":3,"file":"useToolName.js","sourceRoot":"","sources":["../../../../src/mcp/react/hooks/useToolName.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,UAAU,WAAW;IACzB,OAAO,eAAe,EAAE,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC;AAClD,CAAC","sourcesContent":["import { useApolloClient } from \"./useApolloClient.js\";\n\nexport function useToolName() {\n  return useApolloClient()[\"appManager\"].toolName;\n}\n"]}
+{"version":3,"file":"useToolName.js","sourceRoot":"","sources":["../../../../src/mcp/react/hooks/useToolName.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,eAAe,EAAE,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC;AAClD,CAAC","sourcesContent":["import type { ToolName } from \"../../../core/typeRegistration.js\";\nimport { useApolloClient } from \"./useApolloClient.js\";\n\n/**\n * @deprecated Please use the `useToolInfo` hook. `useToolName` will be removed\n * in the next major version.\n */\nexport function useToolName(): ToolName | undefined {\n  return useApolloClient()[\"appManager\"].toolName;\n}\n"]}

package/dist/mcp/react/index.d.ts

@@ -1,6 +1,8 @@
 export { useApp } from "./hooks/useApp.js";
+export { useHostContext } from "./hooks/useHostContext.js";
 export { useToolName } from "./hooks/useToolName.js";
 export { useToolMetadata } from "./hooks/useToolMetadata.js";
 export { useToolInput } from "./hooks/useToolInput.js";
+export { useToolInfo } from "./hooks/useToolInfo.js";
 export { createHydrationUtils } from "./hooks/createHydrationUtils.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/mcp/react/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/mcp/react/index.js

@@ -1,6 +1,8 @@
 export { useApp } from "./hooks/useApp.js";
+export { useHostContext } from "./hooks/useHostContext.js";
 export { useToolName } from "./hooks/useToolName.js";
 export { useToolMetadata } from "./hooks/useToolMetadata.js";
 export { useToolInput } from "./hooks/useToolInput.js";
+export { useToolInfo } from "./hooks/useToolInfo.js";
 export { createHydrationUtils } from "./hooks/createHydrationUtils.js";
 //# sourceMappingURL=index.js.map

package/dist/mcp/react/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC","sourcesContent":["export { useApp } from \"./hooks/useApp.js\";\nexport { useToolName } from \"./hooks/useToolName.js\";\nexport { useToolMetadata } from \"./hooks/useToolMetadata.js\";\nexport { useToolInput } from \"./hooks/useToolInput.js\";\nexport { createHydrationUtils } from \"./hooks/createHydrationUtils.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC","sourcesContent":["export { useApp } from \"./hooks/useApp.js\";\nexport { useHostContext } from \"./hooks/useHostContext.js\";\nexport { useToolName } from \"./hooks/useToolName.js\";\nexport { useToolMetadata } from \"./hooks/useToolMetadata.js\";\nexport { useToolInput } from \"./hooks/useToolInput.js\";\nexport { useToolInfo } from \"./hooks/useToolInfo.js\";\nexport { createHydrationUtils } from \"./hooks/createHydrationUtils.js\";\n"]}

package/dist/openai/core/McpAppManager.d.ts

@@ -1,4 +1,4 @@
-import { App } from "@modelcontextprotocol/ext-apps";
+import { App, type McpUiHostContextChangedNotification } from "@modelcontextprotocol/ext-apps";
 import type { ApplicationManifest } from "../../types/application-manifest";
 import type { FormattedExecutionResult } from "graphql";
 import type { DocumentNode, OperationVariables } from "@apollo/client";
@@ -10,6 +10,7 @@ export declare class McpAppManager {
     get toolName(): string | undefined;
     get toolMetadata(): Record<string, unknown> | null;
     get toolInput(): Record<string, unknown> | undefined;
+    onHostContextChanged(cb: (params: McpUiHostContextChangedNotification["params"]) => void): () => void;
     connect: (() => Promise<{
         toolName: string | undefined;
         args: Record<string, unknown> | undefined;

package/dist/openai/core/McpAppManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"McpAppManager.d.ts","sourceRoot":"","sources":["../../../src/openai/core/McpAppManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAwB,MAAM,gCAAgC,CAAC;AAE3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AASvE,gBAAgB;AAChB,qBAAa,aAAa;;IACxB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;gBAMN,QAAQ,EAAE,mBAAmB;IAIzC,IAAI,QAAQ,uBAEX;IAED,IAAI,YAAY,mCAEf;IAED,IAAI,SAAS,wCAEZ;IAED,OAAO;;;;;;;MAqCJ;IAEH,KAAK;IAIC,YAAY,CAAC,EACjB,KAAK,EACL,SAAS,GACV,EAAE;QACD,KAAK,EAAE,YAAY,CAAC;QACpB,SAAS,EAAE,kBAAkB,GAAG,SAAS,CAAC;KAC3C;YASa,aAAa;CAW5B"}
+{"version":3,"file":"McpAppManager.d.ts","sourceRoot":"","sources":["../../../src/openai/core/McpAppManager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,GAAG,EAEH,KAAK,mCAAmC,EACzC,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AASvE,gBAAgB;AAChB,qBAAa,aAAa;;IACxB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;gBAUN,QAAQ,EAAE,mBAAmB;IAIzC,IAAI,QAAQ,uBAEX;IAED,IAAI,YAAY,mCAEf;IAED,IAAI,SAAS,wCAEZ;IAED,oBAAoB,CAClB,EAAE,EAAE,CAAC,MAAM,EAAE,mCAAmC,CAAC,QAAQ,CAAC,KAAK,IAAI;IAQrE,OAAO;;;;;;;MAyCJ;IAEH,KAAK;IAIC,YAAY,CAAC,EACjB,KAAK,EACL,SAAS,GACV,EAAE;QACD,KAAK,EAAE,YAAY,CAAC;QACpB,SAAS,EAAE,kBAAkB,GAAG,SAAS,CAAC;KAC3C;YASa,aAAa;CAW5B"}

package/dist/openai/core/McpAppManager.js

@@ -1,4 +1,4 @@
-import { App, PostMessageTransport } from "@modelcontextprotocol/ext-apps";
+import { App, PostMessageTransport, } from "@modelcontextprotocol/ext-apps";
 import { print } from "@apollo/client/utilities";
 import { cacheAsync, promiseWithResolvers } from "../../utilities";
 /** @internal */
@@ -7,6 +7,7 @@ export class McpAppManager {
     #toolName;
     #toolMetadata = null;
     #toolInput;
+    #hostContextCallbacks = new Set();
     constructor(manifest) {
         this.app = new App({ name: manifest.name, version: manifest.appVersion });
     }
@@ -19,11 +20,20 @@ export class McpAppManager {
     get toolInput() {
         return this.#toolInput;
     }
+    onHostContextChanged(cb) {
+        this.#hostContextCallbacks.add(cb);
+        return () => {
+            this.#hostContextCallbacks.delete(cb);
+        };
+    }
     connect = cacheAsync(async () => {
         let toolResult = promiseWithResolvers();
         this.app.ontoolresult = (params) => {
             toolResult.resolve(params);
         };
+        this.app.onhostcontextchanged = (params) => {
+            this.#hostContextCallbacks.forEach((cb) => cb(params));
+        };
         await this.connectToHost();
         const { structuredContent } = await toolResult.promise;
         this.#toolName = this.app.getHostContext()?.toolInfo?.tool.name;