@ai-sdk/mcp 1.0.54 → 1.0.55

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @ai-sdk/mcp
 
+## 1.0.55
+
+### Patch Changes
+
+- 3d0bd52: feat(mcp): allow MCP client to use server completions
+- Updated dependencies [b30e43a]
+  - @ai-sdk/provider-utils@4.0.33
+
 ## 1.0.54
 
 ### Patch Changes

package/dist/index.d.mts

@@ -434,6 +434,33 @@ declare const ReadResourceResultSchema: z.ZodObject<{
     }, z.core.$loose>]>>;
 }, z.core.$loose>;
 type ReadResourceResult = z.infer<typeof ReadResourceResultSchema>;
+declare const CompleteRequestParamsSchema: z.ZodObject<{
+    _meta: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    ref: z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodLiteral<"ref/prompt">;
+        name: z.ZodString;
+    }, z.core.$loose>, z.ZodObject<{
+        type: z.ZodLiteral<"ref/resource">;
+        uri: z.ZodString;
+    }, z.core.$loose>]>;
+    argument: z.ZodObject<{
+        name: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$loose>;
+    context: z.ZodOptional<z.ZodObject<{
+        arguments: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+type CompleteRequestParams = z.infer<typeof CompleteRequestParamsSchema>;
+declare const CompleteResultSchema: z.ZodObject<{
+    _meta: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    completion: z.ZodObject<{
+        values: z.ZodArray<z.ZodString>;
+        total: z.ZodOptional<z.ZodNumber>;
+        hasMore: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$loose>;
+}, z.core.$loose>;
+type CompleteResult = z.infer<typeof CompleteResultSchema>;
 declare const ListPromptsResultSchema: z.ZodObject<{
     _meta: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
     nextCursor: z.ZodOptional<z.ZodString>;
@@ -576,8 +603,11 @@ interface MCPClient {
         arguments?: Record<string, unknown>;
         options?: RequestOptions;
     }): Promise<GetPromptResult>;
+    complete(args: CompleteRequestParams & {
+        options?: RequestOptions;
+    }): Promise<CompleteResult>;
     onElicitationRequest(schema: typeof ElicitationRequestSchema, handler: (request: ElicitationRequest) => Promise<ElicitResult> | ElicitResult): void;
     close: () => Promise<void>;
 }
 
-export { type Configuration, type ElicitResult, ElicitResultSchema, type ElicitationRequest, ElicitationRequestSchema, type JSONRPCError, type JSONRPCMessage, type JSONRPCNotification, type JSONRPCRequest, type JSONRPCResponse, type ListToolsResult, type MCPClient, type ClientCapabilities as MCPClientCapabilities, type MCPClientConfig, type MCPTransport, type OAuthAuthorizationServerInformation, type OAuthClientInformation, type OAuthClientMetadata, type OAuthClientProvider, type OAuthTokens, UnauthorizedError, auth, createMCPClient, type MCPClient as experimental_MCPClient, type ClientCapabilities as experimental_MCPClientCapabilities, type MCPClientConfig as experimental_MCPClientConfig, createMCPClient as experimental_createMCPClient };
+export { type CallToolResult, type CompleteRequestParams, type CompleteResult, type Configuration, type ElicitResult, ElicitResultSchema, type ElicitationRequest, ElicitationRequestSchema, type JSONRPCError, type JSONRPCMessage, type JSONRPCNotification, type JSONRPCRequest, type JSONRPCResponse, type ListToolsResult, type MCPClient, type ClientCapabilities as MCPClientCapabilities, type MCPClientConfig, type MCPTransport, type OAuthAuthorizationServerInformation, type OAuthClientInformation, type OAuthClientMetadata, type OAuthClientProvider, type OAuthTokens, UnauthorizedError, auth, createMCPClient, type MCPClient as experimental_MCPClient, type ClientCapabilities as experimental_MCPClientCapabilities, type MCPClientConfig as experimental_MCPClientConfig, createMCPClient as experimental_createMCPClient };

package/dist/index.d.ts

@@ -434,6 +434,33 @@ declare const ReadResourceResultSchema: z.ZodObject<{
     }, z.core.$loose>]>>;
 }, z.core.$loose>;
 type ReadResourceResult = z.infer<typeof ReadResourceResultSchema>;
+declare const CompleteRequestParamsSchema: z.ZodObject<{
+    _meta: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    ref: z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodLiteral<"ref/prompt">;
+        name: z.ZodString;
+    }, z.core.$loose>, z.ZodObject<{
+        type: z.ZodLiteral<"ref/resource">;
+        uri: z.ZodString;
+    }, z.core.$loose>]>;
+    argument: z.ZodObject<{
+        name: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$loose>;
+    context: z.ZodOptional<z.ZodObject<{
+        arguments: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+type CompleteRequestParams = z.infer<typeof CompleteRequestParamsSchema>;
+declare const CompleteResultSchema: z.ZodObject<{
+    _meta: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    completion: z.ZodObject<{
+        values: z.ZodArray<z.ZodString>;
+        total: z.ZodOptional<z.ZodNumber>;
+        hasMore: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$loose>;
+}, z.core.$loose>;
+type CompleteResult = z.infer<typeof CompleteResultSchema>;
 declare const ListPromptsResultSchema: z.ZodObject<{
     _meta: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
     nextCursor: z.ZodOptional<z.ZodString>;
@@ -576,8 +603,11 @@ interface MCPClient {
         arguments?: Record<string, unknown>;
         options?: RequestOptions;
     }): Promise<GetPromptResult>;
+    complete(args: CompleteRequestParams & {
+        options?: RequestOptions;
+    }): Promise<CompleteResult>;
     onElicitationRequest(schema: typeof ElicitationRequestSchema, handler: (request: ElicitationRequest) => Promise<ElicitResult> | ElicitResult): void;
     close: () => Promise<void>;
 }
 
-export { type Configuration, type ElicitResult, ElicitResultSchema, type ElicitationRequest, ElicitationRequestSchema, type JSONRPCError, type JSONRPCMessage, type JSONRPCNotification, type JSONRPCRequest, type JSONRPCResponse, type ListToolsResult, type MCPClient, type ClientCapabilities as MCPClientCapabilities, type MCPClientConfig, type MCPTransport, type OAuthAuthorizationServerInformation, type OAuthClientInformation, type OAuthClientMetadata, type OAuthClientProvider, type OAuthTokens, UnauthorizedError, auth, createMCPClient, type MCPClient as experimental_MCPClient, type ClientCapabilities as experimental_MCPClientCapabilities, type MCPClientConfig as experimental_MCPClientConfig, createMCPClient as experimental_createMCPClient };
+export { type CallToolResult, type CompleteRequestParams, type CompleteResult, type Configuration, type ElicitResult, ElicitResultSchema, type ElicitationRequest, ElicitationRequestSchema, type JSONRPCError, type JSONRPCMessage, type JSONRPCNotification, type JSONRPCRequest, type JSONRPCResponse, type ListToolsResult, type MCPClient, type ClientCapabilities as MCPClientCapabilities, type MCPClientConfig, type MCPTransport, type OAuthAuthorizationServerInformation, type OAuthClientInformation, type OAuthClientMetadata, type OAuthClientProvider, type OAuthTokens, UnauthorizedError, auth, createMCPClient, type MCPClient as experimental_MCPClient, type ClientCapabilities as experimental_MCPClientCapabilities, type MCPClientConfig as experimental_MCPClientConfig, createMCPClient as experimental_createMCPClient };

package/dist/index.js

@@ -108,6 +108,7 @@ var ElicitationCapabilitySchema = import_v4.z.object({
 var ServerCapabilitiesSchema = import_v4.z.looseObject({
   experimental: import_v4.z.optional(import_v4.z.object({}).loose()),
   logging: import_v4.z.optional(import_v4.z.object({}).loose()),
+  completions: import_v4.z.optional(import_v4.z.object({}).loose()),
   prompts: import_v4.z.optional(
     import_v4.z.looseObject({
       listChanged: import_v4.z.optional(import_v4.z.boolean())
@@ -252,6 +253,34 @@ var ReadResourceResultSchema = ResultSchema.extend({
     import_v4.z.union([TextResourceContentsSchema, BlobResourceContentsSchema])
   )
 });
+var PromptReferenceSchema = import_v4.z.object({
+  type: import_v4.z.literal("ref/prompt"),
+  name: import_v4.z.string()
+}).loose();
+var ResourceReferenceSchema = import_v4.z.object({
+  type: import_v4.z.literal("ref/resource"),
+  uri: import_v4.z.string()
+}).loose();
+var CompletionArgumentSchema = import_v4.z.object({
+  name: import_v4.z.string(),
+  value: import_v4.z.string()
+}).loose();
+var CompleteRequestParamsSchema = BaseParamsSchema.extend({
+  ref: import_v4.z.union([PromptReferenceSchema, ResourceReferenceSchema]),
+  argument: CompletionArgumentSchema,
+  context: import_v4.z.optional(
+    import_v4.z.object({
+      arguments: import_v4.z.record(import_v4.z.string(), import_v4.z.string())
+    }).loose()
+  )
+});
+var CompleteResultSchema = ResultSchema.extend({
+  completion: import_v4.z.object({
+    values: import_v4.z.array(import_v4.z.string()).max(100),
+    total: import_v4.z.optional(import_v4.z.number().int()),
+    hasMore: import_v4.z.optional(import_v4.z.boolean())
+  }).loose()
+});
 var PromptArgumentSchema = import_v4.z.object({
   name: import_v4.z.string(),
   description: import_v4.z.optional(import_v4.z.string()),
@@ -2015,6 +2044,13 @@ var DefaultMCPClient = class {
     switch (method) {
       case "initialize":
         break;
+      case "completion/complete":
+        if (!this.serverCapabilities.completions) {
+          throw new MCPClientError({
+            message: `Server does not support completions`
+          });
+        }
+        break;
       case "tools/list":
       case "tools/call":
         if (!this.serverCapabilities.tools) {
@@ -2197,6 +2233,16 @@ var DefaultMCPClient = class {
       throw error;
     }
   }
+  async completeInternal({
+    options,
+    ...params
+  }) {
+    return this.request({
+      request: { method: "completion/complete", params },
+      resultSchema: CompleteResultSchema,
+      options
+    });
+  }
   async notification(notification) {
     const jsonrpcNotification = {
       ...notification,
@@ -2344,6 +2390,9 @@ var DefaultMCPClient = class {
   }) {
     return this.getPromptInternal({ name: name3, args, options });
   }
+  complete(args) {
+    return this.completeInternal(args);
+  }
   onElicitationRequest(schema, handler) {
     if (schema !== ElicitationRequestSchema) {
       throw new MCPClientError({