ai 7.0.3 → 7.0.4

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # ai
 
+## 7.0.4
+
+### Patch Changes
+
+- Updated dependencies [6a436e3]
+  - @ai-sdk/provider-utils@5.0.1
+  - @ai-sdk/gateway@4.0.4
+
 ## 7.0.3
 
 ### Patch Changes

package/dist/index.js

@@ -1089,7 +1089,7 @@ import {
 } from "@ai-sdk/provider-utils";
 
 // src/version.ts
-var VERSION = true ? "7.0.3" : "0.0.0-test";
+var VERSION = true ? "7.0.4" : "0.0.0-test";
 
 // src/util/download/download.ts
 var download = async ({

package/dist/internal/index.js

@@ -83,7 +83,7 @@ import {
 } from "@ai-sdk/provider-utils";
 
 // src/version.ts
-var VERSION = true ? "7.0.3" : "0.0.0-test";
+var VERSION = true ? "7.0.4" : "0.0.0-test";
 
 // src/util/download/download.ts
 var download = async ({

package/docs/03-ai-sdk-core/16-mcp-tools.mdx

@@ -360,6 +360,52 @@ Resource templates are dynamic URI patterns that allow flexible queries. List al
 const templates = await mcpClient.listResourceTemplates();
 ```
 
+## Using MCP Completions
+
+MCP servers can provide autocompletion suggestions for prompt arguments and
+resource template variables when they advertise the `completions` capability.
+Use `complete` to ask the server for suggestions based on the current partial
+argument value:
+
+```typescript
+const completion = await mcpClient.complete({
+  ref: {
+    type: 'ref/resource',
+    uri: 'file:///{path}',
+  },
+  argument: {
+    name: 'path',
+    value: 'doc',
+  },
+});
+
+console.log(completion.completion.values);
+```
+
+For resource templates or prompts with multiple arguments, pass already resolved
+values through `context.arguments`:
+
+```typescript
+const completion = await mcpClient.complete({
+  ref: {
+    type: 'ref/resource',
+    uri: 'kubernetes://namespaced/{plural}/{namespace}',
+  },
+  argument: {
+    name: 'namespace',
+    value: 'auth',
+  },
+  context: {
+    arguments: {
+      plural: 'deployments',
+    },
+  },
+});
+```
+
+If the connected server does not advertise `capabilities.completions`, the
+client throws an `MCPClientError`.
+
 ## Using MCP Prompts
 
 <Note type="warning">

package/docs/07-reference/01-ai-sdk-core/23-create-mcp-client.mdx

@@ -10,6 +10,7 @@ Creates a lightweight Model Context Protocol (MCP) client that connects to an MC
 - **Tools**: Automatic conversion between MCP tools and AI SDK tools
 - **Resources**: Methods to list, read, and discover resource templates from MCP servers
 - **Prompts**: Methods to list available prompts and retrieve prompt messages
+- **Completions**: Methods to request autocompletion suggestions for prompt arguments and resource template variables
 - **Elicitation**: Support for handling server requests for additional input during tool execution
 
 It currently does not support accepting notifications from an MCP server, and custom configuration of the client.
@@ -440,6 +441,47 @@ Returns a Promise that resolves to an `MCPClient` with the following properties
         },
       ],
     },
+    {
+      name: 'complete',
+      type: `async (args: CompleteRequestParams & {
+        options?: RequestOptions;
+      }) => Promise<CompleteResult>`,
+      description:
+        'Requests autocompletion suggestions for a prompt argument or resource template variable. The server must advertise the completions capability.',
+      properties: [
+        {
+          type: 'args',
+          parameters: [
+            {
+              name: 'ref',
+              type: "{ type: 'ref/prompt'; name: string } | { type: 'ref/resource'; uri: string }",
+              description:
+                'Reference to the prompt or resource template being completed.',
+            },
+            {
+              name: 'argument',
+              type: '{ name: string; value: string }',
+              description:
+                'Argument name and current partial value to complete.',
+            },
+            {
+              name: 'context',
+              type: '{ arguments: Record<string, string> }',
+              isOptional: true,
+              description:
+                'Previously resolved argument values used to provide context for multi-argument prompts or resource templates.',
+            },
+            {
+              name: 'options',
+              type: 'RequestOptions',
+              isOptional: true,
+              description:
+                'Optional request options including signal and timeout.',
+            },
+          ],
+        },
+      ],
+    },
     {
       name: 'experimental_listPrompts',
       type: `async (options?: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai",
-  "version": "7.0.3",
+  "version": "7.0.4",
   "type": "module",
   "description": "AI SDK by Vercel - build apps like ChatGPT, Claude, Gemini, and more with a single interface for any model using the Vercel AI Gateway or go direct to OpenAI, Anthropic, Google, or any other model provider.",
   "license": "Apache-2.0",
@@ -42,9 +42,9 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/gateway": "4.0.3",
+    "@ai-sdk/gateway": "4.0.4",
     "@ai-sdk/provider": "4.0.0",
-    "@ai-sdk/provider-utils": "5.0.0"
+    "@ai-sdk/provider-utils": "5.0.1"
   },
   "devDependencies": {
     "@edge-runtime/vm": "^5.0.0",