@apollo/client-ai-apps 0.6.4 → 0.7.0

package/CHANGELOG.md

@@ -1,3 +1,103 @@
+## 0.7.0 (2026-03-31)
+
+### Breaking Changes
+
+#### Remove deprecated hooks
+
+The deprecated `useToolInput` and `useToolName` hooks have been removed along with their corresponding `ToolInput` and `ToolName` types. Use `useToolInfo` instead:
+
+```diff
+- import { useToolInput, useToolName } from "@apollo/client-ai-apps/react";
++ import { useToolInfo } from "@apollo/client-ai-apps/react";
+
+  function MyComponent() {
+-   const toolName = useToolName();
+-   const toolInput = useToolInput();
++   const { toolName, toolInput } = useToolInfo();
+
+    // ...
+  }
+```
+
+#### Simplified React entry points
+
+The React entry points have now been simplified to encourage the use of the shared `/react` entry point. This means all React symbols shared between the `@apollo/client-ai-apps/mcp/react` and `@apollo/client-ai-apps/openai/react` entry points are only available in `@apollo/client-ai-apps/react`.
+
+As part of this consolidation, the `@apollo/client-ai-apps/mcp/react` entry point was removed because there were no unique symbols exported from this entry point. The `@apollo/client-ai-apps/openai/react` entry point now exports only the `useWidgetState` hook. All other symbols should be imported from `@apollo/client-ai-apps/react`.
+
+If you are already importing React symbols from `@apollo/client-ai-apps/react`, you do not need to do anything.
+
+If you are importing React symbols from platform-specific entry points, you will need to update your imports to use the top-level `/react` entry point.
+
+```diff
+- import {
+-   useApp,
+-   useHostContext,
+-   useToolInfo,
+-   createHydrationUtils
+- } from "@apollo/client-ai-apps/mcp/react";
+- import {
+-   useApp,
+-   useHostContext,
+-   useToolInfo,
+-   createHydrationUtils
+- } from "@apollo/client-ai-apps/openai/react";
++ import {
++   useApp,
++   useHostContext,
++   useToolInfo,
++   createHydrationUtils
++ } from "@apollo/client-ai-apps/react";
+```
+
+### Fixes
+
+#### Honor no-cache queries when hydrating query
+
+The `no-cache` fetch policy is now properly honored when hydrating a `no-cache` query initiated by a tool call. Previously, all tool calls wrote the query to the cache regardless of the configured fetch policy.
+
+#### Hydrate `network-only`, `cache-and-network`, and `no-cache` queries from tool result data
+
+Queries using `network-only`, `cache-and-network`, or `no-cache` fetch policies previously called the `execute` tool to fetch data, even when the result was already available from the tool call that initiated the app. These queries are now served directly from the tool result on first load, avoiding a redundant `execute` call. Subsequent queries will continue to call `execute` using the configured fetch policy as expected.
+
+## 0.6.5 (2026-03-23)
+
+### Features
+
+#### Add support for `extraOutputs` to the `@tool` directive
+
+The `@tool` directive now supports an `extraOutputs` argument. This is a free-form object (any shape) that is written to the manifest under each tool's config. Values provided to `extraOutputs` are returned by Apollo MCP Server for the tool result in `structuredContent` to make it accessible to the LLM.
+
+```graphql
+query MyQuery
+@tool(
+  name: "my-tool",
+  description: "My tool",
+  extraOutputs: { "follow-up-instructions": "Perform a feat of magic" }
+) {
+  myField
+}
+```
+
+#### Support `@private` in operations to hide parts of a query result from LLMs
+
+In MCP Apps, you may have data that you want made available to your app but hidden from the LLM. A new `@private` directive is now supported that hides these fields from LLMs:
+
+```
+query ProductsQuery {
+  topProducts {
+    sku
+    title
+    meta @private {
+      createdAt
+      barcode
+    }
+  }
+}
+```
+
+`@private` directs Apollo MCP Server to remove those fields in `structuredContent` so that the field data is not available to the LLM. The full result is instead added to `_meta`. `@apollo/client-ai-apps` handles reading the query result from the proper location when `@private` is used.
+
 ## 0.6.4 (2026-03-13)
 
 ### Fixes

package/CONTRIBUTING.md

@@ -0,0 +1,195 @@
+# Apollo Contributor Guide
+
+Excited about Apollo and want to make it better? We're excited too!
+
+Apollo is a community of developers just like you, striving to create the best tools and libraries around GraphQL. We welcome anyone who wants to contribute or provide constructive feedback, no matter the age or level of experience. If you want to help but don't know where to start, let us know, and we'll find something for you.
+
+Oh, and if you haven't already, join our [community forums](https://community.apollographql.com).
+
+Here are some ways to contribute to the project, from easiest to most difficult:
+
+- [Apollo Client](#apollo-client)
+- [Issues](#issues)
+  - [Reporting bugs](#reporting-bugs)
+  - [Improving the documentation](#improving-the-documentation)
+  - [Responding to issues](#responding-to-issues)
+  - [Changesets](#changesets)
+  - [Small bug fixes](#small-bug-fixes)
+  - [Suggesting features](#suggesting-features)
+- [Big PRs](#big-prs)
+  - [Code review guidelines](#code-review-guidelines)
+- [Development](#development)
+  - [Building](#building)
+  - [Testing](#testing)
+  - [Testing with the AI Apps Template](#testing-with-the-ai-apps-template)
+
+## Apollo Client
+
+This package is an integration layer built on top of [Apollo Client](https://github.com/apollographql/apollo-client). If you encounter an issue that appears to be in the core Apollo Client library rather than the MCP Apps integration, please open an issue or contribute directly in the [apollographql/apollo-client](https://github.com/apollographql/apollo-client) repository. See Apollo Client's own [CONTRIBUTING.md](https://github.com/apollographql/apollo-client/blob/main/CONTRIBUTING.md) for guidance on contributing there.
+
+If you're unsure whether an issue belongs here or in the core library, feel free to open an issue here and we'll help triage it.
+
+## Issues
+
+### Reporting bugs
+
+If you encounter a bug, please file an issue on GitHub via the repository of the sub-project you think contains the bug. If an issue you have is already reported, please add additional information or add a 👍 reaction to indicate your agreement.
+
+While we will try to be as helpful as we can on any issue reported, please include the following to maximize the chances of a quick fix:
+
+1. **Intended outcome:** What you were trying to accomplish when the bug occurred, and as much code as possible related to the source of the problem.
+2. **Actual outcome:** A description of what actually happened, including a screenshot or copy-paste of any related error messages, logs, or other output that might be related. Places to look for information include your browser console, server console, and network logs. Please avoid non-specific phrases like "didn't work" or "broke".
+3. **How to reproduce the issue:** Instructions for how the issue can be reproduced by a maintainer or contributor. Be as specific as possible, and only mention what is necessary to reproduce the bug. If possible, isolate the exact circumstances in which the bug occurs. Avoid speculation over what the cause might be.
+
+Creating a good reproduction really helps contributors investigate and resolve your issue quickly. In many cases, the act of creating a minimal reproduction illuminates that the source of the bug was somewhere outside the library in question, saving time and effort for everyone.
+
+### Improving the documentation
+
+Improving the documentation, examples, and other open source content can be the easiest way to contribute to the library. If you see a piece of content that can be better, open a PR with an improvement, no matter how small! If you would like to suggest a big change or major rewrite, we'd love to hear your ideas! Please open a feature request for discussion before writing the PR.
+
+### Responding to issues
+
+In addition to reporting issues, a great way to contribute to Apollo is to respond to other peoples' issues and try to identify the problem or help them work around it. If you're interested in taking a more active role in this process, please go ahead and respond to issues. And don't forget to say "Hi" in our [community forums](https://community.apollographql.com)!
+
+### Changesets
+
+This package uses [knope](https://knope.tech/) to automate its versioning and release process. When contributing, your PR should contain a "changeset" that can be generated by running `npm run changeset` from your branch locally.
+
+The changeset CLI will ask you to enter the corresponding [semver bump type](https://semver.org/) and a short summary of your changes: feel free to enter a brief description via the command line and continue editing the generated Markdown file found inside of `.changeset` in your editor of choice. When editing your changeset's Markdown file, you can leverage any of the features of GitHub flavored markdown! The description you provide in your changeset will be used to generate an entry in `CHANGELOG.md` and the release notes in a future release, so the more complete and descriptive the better. Include code samples where necessary.
+
+### Small bug fixes
+
+For a small bug fix change (less than 20 lines of code changed), feel free to open a pull request. We'll try to merge it as fast as possible and ideally publish a new release on the same day. The only requirement is, make sure you also add a test that verifies the bug you are trying to fix.
+
+### Suggesting features
+
+Most of the features in this package came from suggestions by you, the community! We welcome any ideas about how to make the MCP Apps integration better for your use case. Please open an issue with your details.
+
+## Big PRs
+
+This includes:
+
+- Big bug fixes
+- New features
+
+For significant changes to a repository, it's important to settle on a design before starting on the implementation. This way, we can make sure that major improvements get the care and attention they deserve. Since big changes can be risky and might not always get merged, it's good to reduce the amount of possible wasted effort by agreeing on an implementation design/plan first.
+
+1. **Open an issue.** Open an issue about your bug or feature request.
+2. **Reach consensus.** Some contributors and community members should reach an agreement that this feature or bug is important, and that someone should work on implementing or fixing it.
+3. **Agree on intended behavior.** On the issue, reach an agreement about the desired behavior. In the case of a bug fix, it should be clear what it means for the bug to be fixed, and in the case of a feature, it should be clear what it will be like for developers to use the new feature.
+4. **Agree on implementation plan.** Write a plan for how this feature or bug fix should be implemented. What modules need to be added or rewritten? Should this be one pull request or multiple incremental improvements? Who is going to do each part?
+5. **Submit PR.** In the case where multiple dependent patches need to be made to implement the change, only submit one at a time. Otherwise, the others might get stale while the first is reviewed and merged. Make sure to avoid "while we're here" type changes - if something isn't relevant to the improvement at hand, it should be in a separate PR; this especially includes code style changes of unrelated code.
+6. **Review.** At least one core contributor should sign off on the change before it's merged. Look at the "code review" section below to learn about factors are important in the code review. If you want to expedite the code being merged, try to review your own code first!
+7. **Merge and release!**
+
+### Code review guidelines
+
+It's important that every piece of code in Apollo packages is reviewed by at least one core contributor familiar with that codebase. Here are some things we look for:
+
+1. **Required CI checks pass.** This is a prerequisite for the review, and it is the PR author's responsibility. As long as the tests don't pass, the PR won't get reviewed.
+2. **Simplicity.** Is this the simplest way to achieve the intended goal? If there are too many files, redundant functions, or complex lines of code, suggest a simpler way to do the same thing. In particular, avoid implementing an overly general solution when a simple, small, and pragmatic fix will do.
+3. **Testing.** Do the tests ensure this code won't break when other stuff changes around it? When it does break, will the tests added help us identify which part of the library has the problem? Did we cover an appropriate set of edge cases? Look at the test coverage report if there is one. Are all significant code paths in the new code exercised at least once?
+4. **No unnecessary or unrelated changes.** PRs shouldn't come with random formatting changes, especially in unrelated parts of the code. If there is some refactoring that needs to be done, it should be in a separate PR from a bug fix or feature, if possible.
+5. **Code has appropriate comments.** Code should be commented, or written in a clear "self-documenting" way.
+6. **Idiomatic use of the language.** In TypeScript, make sure the typings are specific and correct. In ES2015, make sure to use imports rather than require and const instead of var, etc. Ideally a linter enforces a lot of this, but use your common sense and follow the style of the surrounding code.
+
+## Development
+
+### Building
+
+**Build the package once:**
+
+```
+npm run build
+```
+
+### Testing
+
+**Run all tests once:**
+
+```
+npm run test
+```
+
+**Run all tests in watch mode:**
+
+```
+npm run test:watch
+```
+
+### Testing with the AI Apps Template
+
+It can be useful to test your local changes against a real MCP app. The [Apollo AI Apps Template](https://github.com/apollographql/ai-apps-template) provides a complete setup for this purpose.
+
+#### Step 1: Build and pack this package
+
+From the root of this repository, build the package and create a local `.tgz` tarball:
+
+```bash
+npm run build && npm pack
+```
+
+This creates a file like `apollo-client-ai-apps-0.6.5.tgz` in the root of the repo. Note the path to this file — you'll need it in the next step.
+
+#### Step 2: Set up the template
+
+Scaffold a new project from the template:
+
+```bash
+npx tiged apollographql/ai-apps-template mcp-apps-reproduction
+cd mcp-apps-reproduction
+./install.sh
+```
+
+#### Step 3: Point the template at your local build
+
+In the template's React app (`dev/the-store/package.json`), replace the published `@apollo/client-ai-apps` version with the path to your local `.tgz`:
+
+```json
+{
+  "dependencies": {
+    "@apollo/client-ai-apps": "file:/path/to/apollo-client-ai-apps-0.6.5.tgz"
+  }
+}
+```
+
+Then reinstall dependencies in that directory:
+
+```bash
+cd dev/the-store
+npm install
+```
+
+#### Step 4: Start the services
+
+You'll need three terminal windows:
+
+**Terminal 1 — GraphQL API:**
+
+```bash
+cd ecommerce-graph
+npm run dev
+```
+
+**Terminal 2 — React app:**
+
+```bash
+cd dev/the-store
+npm run dev:mcp
+```
+
+**Terminal 3 — MCP server:**
+
+```bash
+./start_mcp.sh
+```
+
+#### Step 5: Iterate
+
+When you make changes to this package:
+
+1. Rebuild and repack: `npm run build && npm pack`
+2. Reinstall in the template: `cd dev/the-store && npm update @apollo/client-ai-apps`
+3. Restart the React app dev server
+
+Refer to the [MCP Apps Quickstart Guide](https://www.apollographql.com/docs/apollo-mcp-server/mcp-apps-quickstart) for more details on configuring the template, setting up tunneling for end-to-end testing with a host like ChatGPT, and other development workflows.

package/README.md

@@ -0,0 +1,74 @@
+<header>
+  <div align="center">
+    <a href="https://www.apollographql.com?utm_medium=github&utm_source=apollographql_apollo-client-ai-apps&utm_campaign=readme"><img src="https://raw.githubusercontent.com/apollographql/apollo-client-devtools/main/assets/apollo-wordmark.svg" height="100" alt="Apollo Logo"></a>
+  </div>
+  <h1 align="center">Apollo Client - MCP Apps Integration</h1>
+
+**The industry-leading GraphQL client for TypeScript, JavaScript, React, Vue, Angular, and more.** Apollo Client delivers powerful caching, intuitive APIs, and comprehensive developer tools to accelerate your app development.
+
+➡️ [**Get Started with Apollo Client's MCP Apps Integration→**](https://www.apollographql.com/docs/apollo-mcp-server/mcp-apps?utm_source=github&utm_medium=apollographql_apollo-client-ai-apps&utm_campaign=readme)
+
+  <div align="center">
+
+[![npm version](https://img.shields.io/npm/v/%40apollo%2Fclient-ai-apps)](https://img.shields.io/npm/v/%40apollo%2Fclient-ai-apps) [![Join the community](https://img.shields.io/discourse/status?label=Join%20the%20community&server=https%3A%2F%2Fcommunity.apollographql.com)](https://community.apollographql.com)
+
+  </div>
+</header>
+
+## 🚀 Quick Start
+
+Use our [MCP Apps template](https://github.com/apollographql/ai-apps-template) with a working application:
+
+```sh
+npx tiged apollographql/ai-apps-template my-awesome-app
+```
+
+## Apollo Client Skill
+
+Give your AI agent specialized Apollo Client knowledge and setup guidance:
+
+```sh
+npx skills add apollographql/skills --skill apollo-client
+```
+
+## 💡 Resources
+
+| Resource                        | Description                                   | Link                                                                                                                                                                                             |
+| ------------------------------- | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| **Getting Started Guide**       | MCP Apps quickstart guide                     | [Start Here →](https://www.apollographql.com/docs/apollo-mcp-server/mcp-apps-quickstart?utm_source=github&utm_medium=apollographql_apollo-client-ai-apps&utm_campaign=readme)                    |
+| **Documentation**               | MCP Apps documentation                        | [Read Docs →](https://www.apollographql.com/docs/apollo-mcp-server/mcp-apps?utm_source=github&utm_medium=apollographql_apollo-client-ai-apps&utm_campaign=readme)                                |
+| **Apollo Client Documentation** | Comprehensive documentation for Apollo Client | [Apollo Client →](https://www.apollographql.com/docs/react?utm_source=github&utm_medium=apollographql_apollo-client-ai-apps&utm_campaign=readme)                                                 |
+| **VS Code Extension**           | Enhanced development experience               | [Install Extension →](https://marketplace.visualstudio.com/items?itemName=apollographql.vscode-apollo)                                                                                           |
+| **DevTools**                    | Debug your GraphQL apps                       | [Chrome](https://chrome.google.com/webstore/detail/apollo-client-devtools/jdkknkkbebbapilgoeccciglkfbmbnfm) \| [Firefox](https://addons.mozilla.org/en-US/firefox/addon/apollo-developer-tools/) |
+
+## 🧑‍🚀 About Apollo
+
+Deliver tomorrow's roadmap today with our comprehensive suite of API orchestration tools:
+
+- [**Apollo Client MCP Apps Integration**](https://www.apollographql.com/docs/apollo-mcp-server/mcp-apps?utm_source=github&utm_medium=apollographql_apollo-client-ai-apps&utm_campaign=readme) \- Apollo Client and Apollo MCP Server powered MCP Apps
+- [**Apollo Client**](https://www.apollographql.com/docs/react?utm_source=github&utm_medium=apollographql_apollo-client-ai-apps&utm_campaign=readme) \- Type-safe apps with GraphQL-powered on-device caching
+- [**Apollo Connectors**](https://www.apollographql.com/graphos/apollo-connectors?utm_source=github&utm_medium=apollographql_apollo-client-ai-apps&utm_campaign=readme) \- Compose all your GraphQL and REST APIs into one GraphQL endpoint
+- [**Apollo MCP Server**](https://www.apollographql.com/apollo-mcp-server?utm_source=github&utm_medium=apollographql_apollo-client-ai-apps&utm_campaign=readme) \- AI needs APIs. The fastest way to ship reliable AI experiences
+- [**Apollo Router**](https://www.apollographql.com/docs/router?utm_source=github&utm_medium=apollographql_apollo-client-ai-apps&utm_campaign=readme) \- Scale your APIs seamlessly with GraphQL Federation, Security, Auth, and more
+- [**GraphOS**](https://www.apollographql.com/graphos?utm_source=github&utm_medium=apollographql_apollo-client-ai-apps&utm_campaign=readme) \- Deploy, manage, govern, and explore your APIs ([start for free, no credit card needed](https://www.apollographql.com/pricing?utm_medium=github&utm_source=apollographql_apollo-client-ai-apps&utm_campaign=readme))
+
+[**Explore the Complete Apollo Platform →**](https://www.apollographql.com/?utm_source=github&utm_medium=apollographql-_apollo-client-ai-apps&utm_campaign=readme)
+
+## 🛠️ Maintained by
+
+| Name            | Username                                             |
+| --------------- | ---------------------------------------------------- |
+| Jerel Miller    | [@jerelmiller](https://github.com/jerelmiller)       |
+| Andrew McGivery | [@andrewmcgivery](https://github.com/andrewmcgivery) |
+
+## 🏆 Contributing
+
+Thank you for your interest in submitting a Pull Request to Apollo Client! Read our [guidelines](https://github.com/apollographql/apollo-client-ai-apps/blob/main/CONTRIBUTING.md) first, and don't hesitate to get in touch.
+
+## 🤝 Code of Conduct
+
+Please read our [Code of Conduct](https://community.apollographql.com/faq). This applies to any space run by Apollo, including our GitHub repositories, the Apollo GraphOS Discord, the Apollo GraphQL Forum. The Code of Conduct reflects our commitment to making the Apollo Community a welcoming and safe space in which individuals can interact.
+
+## 🪪 License
+
+Source code in this repository is available under the terms of the MIT License. Read the full text [here](https://github.com/apollographql/apollo-client-ai-apps/blob/main/LICENSE).

package/dist/core/AbstractApolloClient.d.ts

@@ -0,0 +1,33 @@
+import { ApolloLink, ApolloClient as NativeApolloClient, ObservableQuery, type OperationVariables, type WatchQueryOptions } from "@apollo/client";
+import type { ApplicationManifest } from "../types/application-manifest.js";
+import { aiClientSymbol } from "../utilities/constants.js";
+import { type ConnectToHostImplementation } from "./McpAppManager.js";
+import type { ApolloMcpServerApps } from "./types.js";
+export declare namespace AbstractApolloClient {
+    interface Options extends Omit<NativeApolloClient.Options, "link"> {
+        link?: NativeApolloClient.Options["link"];
+        manifest: ApplicationManifest;
+    }
+}
+export declare class AbstractApolloClient extends NativeApolloClient {
+    #private;
+    manifest: ApplicationManifest;
+    private readonly appManager;
+    /** @internal */
+    readonly [aiClientSymbol] = true;
+    constructor(options: AbstractApolloClient.Options, connectToHost: ConnectToHostImplementation);
+    get toolInfo(): {
+        toolName: string;
+        toolInput: Record<string, unknown> | undefined;
+    } | undefined;
+    get toolMetadata(): ApolloMcpServerApps.Meta | undefined;
+    setLink(newLink: ApolloLink): void;
+    stop(): void;
+    protected get hydratedToolInput(): Record<string, unknown> | undefined;
+    protected clearHydratedToolInput(): void;
+    watchQuery<T = any, TVariables extends OperationVariables = OperationVariables>(options: WatchQueryOptions<TVariables, T>): ObservableQuery<T, TVariables>;
+    connect: (() => Promise<void>) & {
+        reset: () => void;
+    };
+}
+//# sourceMappingURL=AbstractApolloClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractApolloClient.d.ts","sourceRoot":"","sources":["../../src/core/AbstractApolloClient.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,YAAY,IAAI,kBAAkB,EAElC,eAAe,EACf,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,gBAAgB,CAAC;AAKxB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,oBAAoB,CAAC;AAU5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGtD,MAAM,CAAC,OAAO,WAAW,oBAAoB,CAAC;IAC5C,UAAiB,OAAQ,SAAQ,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC;QACvE,IAAI,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1C,QAAQ,EAAE,mBAAmB,CAAC;KAC/B;CACF;AAED,qBAAa,oBAAqB,SAAQ,kBAAkB;;IAC1D,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;IAE3C,gBAAgB;IAChB,QAAQ,CAAC,CAAC,cAAc,CAAC,QAAQ;gBAS/B,OAAO,EAAE,oBAAoB,CAAC,OAAO,EACrC,aAAa,EAAE,2BAA2B;IAgC5C,IAAI,QAAQ;;;kBAEX;IAED,IAAI,YAAY,yCAEf;IAED,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAIlC,IAAI;IAKJ,SAAS,KAAK,iBAAiB,wCAE9B;IAED,SAAS,CAAC,sBAAsB;IAIhC,UAAU,CACR,CAAC,GAAG,GAAG,EACP,UAAU,SAAS,kBAAkB,GAAG,kBAAkB,EAC1D,OAAO,EAAE,iBAAiB,CAAC,UAAU,EAAE,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,EAAE,UAAU,CAAC;IAyC5E,OAAO;;MAyCJ;CACJ"}

package/dist/core/AbstractApolloClient.js

@@ -0,0 +1,129 @@
+import { ApolloLink, ApolloClient as NativeApolloClient, DocumentTransform, ObservableQuery, } from "@apollo/client";
+import { __DEV__ } from "@apollo/client/utilities/environment";
+import { removeDirectivesFromDocument } from "@apollo/client/utilities/internal";
+import { parse, visit } from "graphql";
+import { equal } from "@wry/equality";
+import { aiClientSymbol } from "../utilities/constants.js";
+import { McpAppManager, } from "./McpAppManager.js";
+import { ToolHydrationLink } from "../link/ToolHydrationLink.js";
+import { ToolCallLink } from "../link/ToolCallLink.js";
+import { cacheAsync, getToolNamesFromDocument, getVariableNamesFromDocument, getVariablesForOperationFromToolInput, warnOnVariableMismatch, } from "../utilities/index.js";
+export class AbstractApolloClient extends NativeApolloClient {
+    manifest;
+    appManager;
+    /** @internal */
+    [aiClientSymbol] = true;
+    #hydratedToolInput;
+    #toolHydrationLink;
+    #toolInfo;
+    #toolMetadata;
+    constructor(options, connectToHost) {
+        const toolHydrationLink = new ToolHydrationLink();
+        const link = options.link ?? new ToolCallLink();
+        if (__DEV__) {
+            validateTerminatingLink(link);
+        }
+        super({
+            ...options,
+            link: toolHydrationLink.concat(link),
+            // Strip out the prefetch/tool directives so they don't get sent with the operation to the server
+            documentTransform: new DocumentTransform((document) => {
+                const serverDocument = removeDirectivesFromDocument([{ name: "prefetch" }, { name: "tool" }], document);
+                return visit(serverDocument, {
+                    OperationDefinition(node) {
+                        return { ...node, description: undefined };
+                    },
+                });
+            }).concat(options.documentTransform ?? DocumentTransform.identity()),
+        });
+        this.#toolHydrationLink = toolHydrationLink;
+        this.manifest = options.manifest;
+        this.appManager = new McpAppManager(this.manifest, connectToHost);
+    }
+    get toolInfo() {
+        return this.#toolInfo;
+    }
+    get toolMetadata() {
+        return this.#toolMetadata;
+    }
+    setLink(newLink) {
+        super.setLink(this.#toolHydrationLink.concat(newLink));
+    }
+    stop() {
+        super.stop();
+        this.appManager.close().catch(() => { });
+    }
+    get hydratedToolInput() {
+        return this.#hydratedToolInput;
+    }
+    clearHydratedToolInput() {
+        this.#hydratedToolInput = undefined;
+    }
+    watchQuery(options) {
+        if (__DEV__) {
+            const toolInput = this.#hydratedToolInput;
+            if (toolInput) {
+                const toolName = this.toolInfo?.toolName;
+                const hasMatchingTool = !!toolName && getToolNamesFromDocument(options.query).has(toolName);
+                if (hasMatchingTool) {
+                    // Clear after first matching comparison so this only fires once and
+                    // remounting doesn't produce spurious warnings.
+                    this.#hydratedToolInput = undefined;
+                    const variableNames = getVariableNamesFromDocument(options.query);
+                    if (variableNames.size > 0) {
+                        const { variables } = options;
+                        const toolInputVariables = Object.entries(toolInput).filter(([key]) => variableNames.has(key));
+                        const hasToolInputMismatch = toolInputVariables.some(([key, value]) => !equal(value, variables?.[key]));
+                        if (hasToolInputMismatch) {
+                            warnOnVariableMismatch(options.query, Object.fromEntries(toolInputVariables), variables);
+                        }
+                    }
+                }
+            }
+        }
+        return super.watchQuery(options);
+    }
+    connect = cacheAsync(async () => {
+        const { structuredContent, toolName, toolInput, _meta } = await this.appManager.connect();
+        this.#hydratedToolInput = toolInput;
+        this.#toolMetadata = _meta;
+        if (toolName != null) {
+            this.#toolInfo = { toolName, toolInput };
+        }
+        this.manifest.operations.forEach((operation) => {
+            if (operation.prefetchID &&
+                structuredContent.prefetch?.[operation.prefetchID]) {
+                this.writeQuery({
+                    query: parse(operation.body),
+                    data: structuredContent.prefetch[operation.prefetchID].data,
+                });
+                this.#toolHydrationLink.hydrate(operation, {
+                    result: structuredContent.prefetch[operation.prefetchID],
+                    variables: {},
+                });
+            }
+            if (structuredContent.result &&
+                operation.tools.find((tool) => tool.name === toolName)) {
+                this.#toolHydrationLink.hydrate(operation, {
+                    result: structuredContent.result,
+                    variables: getVariablesForOperationFromToolInput(operation, toolInput),
+                });
+            }
+        });
+        this.#toolHydrationLink.complete();
+    });
+}
+function validateTerminatingLink(link) {
+    let terminatingLink = link;
+    while (terminatingLink.right) {
+        terminatingLink = terminatingLink.right;
+    }
+    if (!isNamedLink(terminatingLink) ||
+        terminatingLink.name !== "ToolCallLink") {
+        throw new Error("The terminating link must be a `ToolCallLink`. If you are using a `split` link, ensure the `right` branch uses a `ToolCallLink` as the terminating link.");
+    }
+}
+function isNamedLink(link) {
+    return "name" in link;
+}
+//# sourceMappingURL=AbstractApolloClient.js.map

package/dist/core/AbstractApolloClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractApolloClient.js","sourceRoot":"","sources":["../../src/core/AbstractApolloClient.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  ApolloLink,\n  ApolloClient as NativeApolloClient,\n  DocumentTransform,\n  ObservableQuery,\n  type OperationVariables,\n  type WatchQueryOptions,\n} from \"@apollo/client\";\nimport { __DEV__ } from \"@apollo/client/utilities/environment\";\nimport { removeDirectivesFromDocument } from \"@apollo/client/utilities/internal\";\nimport { parse, visit } from \"graphql\";\nimport { equal } from \"@wry/equality\";\nimport type { ApplicationManifest } from \"../types/application-manifest.js\";\nimport { aiClientSymbol } from \"../utilities/constants.js\";\nimport {\n  McpAppManager,\n  type ConnectToHostImplementation,\n} from \"./McpAppManager.js\";\nimport { ToolHydrationLink } from \"../link/ToolHydrationLink.js\";\nimport { ToolCallLink } from \"../link/ToolCallLink.js\";\nimport {\n  cacheAsync,\n  getToolNamesFromDocument,\n  getVariableNamesFromDocument,\n  getVariablesForOperationFromToolInput,\n  warnOnVariableMismatch,\n} from \"../utilities/index.js\";\nimport type { ApolloMcpServerApps } from \"./types.js\";\nimport type { ToolInfo } from \"./typeRegistration.js\";\n\nexport declare namespace AbstractApolloClient {\n  export interface Options extends Omit<NativeApolloClient.Options, \"link\"> {\n    link?: NativeApolloClient.Options[\"link\"];\n    manifest: ApplicationManifest;\n  }\n}\n\nexport class AbstractApolloClient extends NativeApolloClient {\n  manifest: ApplicationManifest;\n  private readonly appManager: McpAppManager;\n\n  /** @internal */\n  readonly [aiClientSymbol] = true;\n\n  #hydratedToolInput: Record<string, unknown> | undefined;\n  #toolHydrationLink: ToolHydrationLink;\n\n  #toolInfo: ToolInfo | undefined;\n  #toolMetadata: ApolloMcpServerApps.CallToolResult[\"_meta\"] | undefined;\n\n  constructor(\n    options: AbstractApolloClient.Options,\n    connectToHost: ConnectToHostImplementation\n  ) {\n    const toolHydrationLink = new ToolHydrationLink();\n    const link = options.link ?? new ToolCallLink();\n\n    if (__DEV__) {\n      validateTerminatingLink(link);\n    }\n\n    super({\n      ...options,\n      link: toolHydrationLink.concat(link),\n      // Strip out the prefetch/tool directives so they don't get sent with the operation to the server\n      documentTransform: new DocumentTransform((document) => {\n        const serverDocument = removeDirectivesFromDocument(\n          [{ name: \"prefetch\" }, { name: \"tool\" }],\n          document\n        )!;\n\n        return visit(serverDocument, {\n          OperationDefinition(node) {\n            return { ...node, description: undefined };\n          },\n        });\n      }).concat(options.documentTransform ?? DocumentTransform.identity()),\n    });\n\n    this.#toolHydrationLink = toolHydrationLink;\n    this.manifest = options.manifest;\n    this.appManager = new McpAppManager(this.manifest, connectToHost);\n  }\n\n  get toolInfo() {\n    return this.#toolInfo;\n  }\n\n  get toolMetadata() {\n    return this.#toolMetadata;\n  }\n\n  setLink(newLink: ApolloLink): void {\n    super.setLink(this.#toolHydrationLink.concat(newLink));\n  }\n\n  stop() {\n    super.stop();\n    this.appManager.close().catch(() => {});\n  }\n\n  protected get hydratedToolInput() {\n    return this.#hydratedToolInput;\n  }\n\n  protected clearHydratedToolInput() {\n    this.#hydratedToolInput = undefined;\n  }\n\n  watchQuery<\n    T = any,\n    TVariables extends OperationVariables = OperationVariables,\n  >(options: WatchQueryOptions<TVariables, T>): ObservableQuery<T, TVariables> {\n    if (__DEV__) {\n      const toolInput = this.#hydratedToolInput;\n\n      if (toolInput) {\n        const toolName = this.toolInfo?.toolName;\n        const hasMatchingTool =\n          !!toolName && getToolNamesFromDocument(options.query).has(toolName);\n\n        if (hasMatchingTool) {\n          // Clear after first matching comparison so this only fires once and\n          // remounting doesn't produce spurious warnings.\n          this.#hydratedToolInput = undefined;\n\n          const variableNames = getVariableNamesFromDocument(options.query);\n\n          if (variableNames.size > 0) {\n            const { variables } = options;\n            const toolInputVariables = Object.entries(toolInput).filter(\n              ([key]) => variableNames.has(key)\n            );\n\n            const hasToolInputMismatch = toolInputVariables.some(\n              ([key, value]) => !equal(value, variables?.[key])\n            );\n\n            if (hasToolInputMismatch) {\n              warnOnVariableMismatch(\n                options.query,\n                Object.fromEntries(toolInputVariables),\n                variables\n              );\n            }\n          }\n        }\n      }\n    }\n\n    return super.watchQuery(options);\n  }\n\n  connect = cacheAsync(async () => {\n    const { structuredContent, toolName, toolInput, _meta } =\n      await this.appManager.connect();\n\n    this.#hydratedToolInput = toolInput;\n    this.#toolMetadata = _meta;\n\n    if (toolName != null) {\n      this.#toolInfo = { toolName, toolInput };\n    }\n\n    this.manifest.operations.forEach((operation) => {\n      if (\n        operation.prefetchID &&\n        structuredContent.prefetch?.[operation.prefetchID]\n      ) {\n        this.writeQuery({\n          query: parse(operation.body),\n          data: structuredContent.prefetch[operation.prefetchID].data,\n        });\n        this.#toolHydrationLink.hydrate(operation, {\n          result: structuredContent.prefetch[operation.prefetchID],\n          variables: {},\n        });\n      }\n\n      if (\n        structuredContent.result &&\n        operation.tools.find((tool) => tool.name === toolName)\n      ) {\n        this.#toolHydrationLink.hydrate(operation, {\n          result: structuredContent.result,\n          variables: getVariablesForOperationFromToolInput(\n            operation,\n            toolInput\n          ),\n        });\n      }\n    });\n\n    this.#toolHydrationLink.complete();\n  });\n}\n\nfunction validateTerminatingLink(link: ApolloLink) {\n  let terminatingLink = link;\n\n  while (terminatingLink.right) {\n    terminatingLink = terminatingLink.right;\n  }\n\n  if (\n    !isNamedLink(terminatingLink) ||\n    terminatingLink.name !== \"ToolCallLink\"\n  ) {\n    throw new Error(\n      \"The terminating link must be a `ToolCallLink`. If you are using a `split` link, ensure the `right` branch uses a `ToolCallLink` as the terminating link.\"\n    );\n  }\n}\n\nfunction isNamedLink(link: ApolloLink): link is ApolloLink & { name: string } {\n  return \"name\" in link;\n}\n"]}

package/dist/core/ApolloClient.d.ts

@@ -1,16 +1,12 @@
-import { ApolloClient as BaseApolloClient } from "@apollo/client";
-import type { ApplicationManifest } from "../types/application-manifest.js";
+import { AbstractApolloClient } from "./AbstractApolloClient.js";
 import { aiClientSymbol } from "../utilities/constants.js";
 export declare namespace ApolloClient {
-    interface Options extends Omit<BaseApolloClient.Options, "link"> {
-        link?: BaseApolloClient.Options["link"];
-        manifest: ApplicationManifest;
+    interface Options extends AbstractApolloClient.Options {
     }
 }
-export declare class ApolloClient extends BaseApolloClient {
+export declare class ApolloClient extends AbstractApolloClient {
     /** @internal */
     readonly [aiClientSymbol] = true;
     constructor(options: ApolloClient.Options);
-    connect(): Promise<void>;
 }
 //# sourceMappingURL=ApolloClient.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ApolloClient.d.ts","sourceRoot":"","sources":["../../src/core/ApolloClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,UAAiB,OAAQ,SAAQ,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC;QACrE,IAAI,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACxC,QAAQ,EAAE,mBAAmB,CAAC;KAC/B;CACF;AAED,qBAAa,YAAa,SAAQ,gBAAgB;IAChD,gBAAgB;IAChB,QAAQ,CAAC,CAAC,cAAc,CAAC,QAAQ;gBAErB,OAAO,EAAE,YAAY,CAAC,OAAO;IAQnC,OAAO;CACd"}
+{"version":3,"file":"ApolloClient.d.ts","sourceRoot":"","sources":["../../src/core/ApolloClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,UAAiB,OAAQ,SAAQ,oBAAoB,CAAC,OAAO;KAAG;CACjE;AAED,qBAAa,YAAa,SAAQ,oBAAoB;IACpD,gBAAgB;IAChB,QAAQ,CAAC,CAAC,cAAc,CAAC,QAAQ;gBAErB,OAAO,EAAE,YAAY,CAAC,OAAO;CAW1C"}

package/dist/core/ApolloClient.js

@@ -1,12 +1,13 @@
-import { ApolloClient as BaseApolloClient } from "@apollo/client";
+import { AbstractApolloClient } from "./AbstractApolloClient.js";
 import { aiClientSymbol } from "../utilities/constants.js";
-export class ApolloClient extends BaseApolloClient {
+export class ApolloClient extends AbstractApolloClient {
     /** @internal */
     [aiClientSymbol] = true;
     constructor(options) {
-        super(options);
+        super(options, () => {
+            throw new Error("Cannot connect an `ApolloClient` instance from `@apollo/client-ai-apps` without export conditions. Please set conditions or import from the `/openai` or `/mcp` subpath directly.");
+        });
         throw new Error("Cannot construct an `ApolloClient` instance from `@apollo/client-ai-apps` without export conditions. Please set conditions or import from the `/openai` or `/mcp` subpath directly.");
     }
-    async connect() { }
 }
 //# sourceMappingURL=ApolloClient.js.map

package/dist/core/ApolloClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"ApolloClient.js","sourceRoot":"","sources":["../../src/core/ApolloClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAS3D,MAAM,OAAO,YAAa,SAAQ,gBAAgB;IAChD,gBAAgB;IACP,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;IAEjC,YAAY,OAA6B;QACvC,KAAK,CAAC,OAAc,CAAC,CAAC;QAEtB,MAAM,IAAI,KAAK,CACb,qLAAqL,CACtL,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,KAAI,CAAC;CACnB","sourcesContent":["import { ApolloClient as BaseApolloClient } from \"@apollo/client\";\nimport type { ApplicationManifest } from \"../types/application-manifest.js\";\nimport { aiClientSymbol } from \"../utilities/constants.js\";\n\nexport declare namespace ApolloClient {\n  export interface Options extends Omit<BaseApolloClient.Options, \"link\"> {\n    link?: BaseApolloClient.Options[\"link\"];\n    manifest: ApplicationManifest;\n  }\n}\n\nexport class ApolloClient extends BaseApolloClient {\n  /** @internal */\n  readonly [aiClientSymbol] = true;\n\n  constructor(options: ApolloClient.Options) {\n    super(options as any);\n\n    throw new Error(\n      \"Cannot construct an `ApolloClient` instance from `@apollo/client-ai-apps` without export conditions. Please set conditions or import from the `/openai` or `/mcp` subpath directly.\"\n    );\n  }\n\n  async connect() {}\n}\n"]}
+{"version":3,"file":"ApolloClient.js","sourceRoot":"","sources":["../../src/core/ApolloClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAM3D,MAAM,OAAO,YAAa,SAAQ,oBAAoB;IACpD,gBAAgB;IACP,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;IAEjC,YAAY,OAA6B;QACvC,KAAK,CAAC,OAAc,EAAE,GAAG,EAAE;YACzB,MAAM,IAAI,KAAK,CACb,mLAAmL,CACpL,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,KAAK,CACb,qLAAqL,CACtL,CAAC;IACJ,CAAC;CACF","sourcesContent":["import { AbstractApolloClient } from \"./AbstractApolloClient.js\";\nimport { aiClientSymbol } from \"../utilities/constants.js\";\n\nexport declare namespace ApolloClient {\n  export interface Options extends AbstractApolloClient.Options {}\n}\n\nexport class ApolloClient extends AbstractApolloClient {\n  /** @internal */\n  readonly [aiClientSymbol] = true;\n\n  constructor(options: ApolloClient.Options) {\n    super(options as any, () => {\n      throw new Error(\n        \"Cannot connect an `ApolloClient` instance from `@apollo/client-ai-apps` without export conditions. Please set conditions or import from the `/openai` or `/mcp` subpath directly.\"\n      );\n    });\n\n    throw new Error(\n      \"Cannot construct an `ApolloClient` instance from `@apollo/client-ai-apps` without export conditions. Please set conditions or import from the `/openai` or `/mcp` subpath directly.\"\n    );\n  }\n}\n"]}