mcp-use 2.8.2 → 2.9.0

package/dist/mentions.d.ts

@@ -0,0 +1,64 @@
+import { type MetaObject, type ResourceLink } from "@modelcontextprotocol/server";
+import type { ToolDefinition } from "./tools.js";
+/** Search text supplied by the composer; empty and whitespace queries are valid. */
+export interface MentionSearchParams {
+    /** Application-owned search text, passed through without normalization. */
+    query: string;
+}
+/** App-owned resource identities suggested by a mention search. */
+export interface MentionSearchResult {
+    /** Authorized links in application-defined order; an empty list means no matches. */
+    items: ResourceLink[];
+}
+/** Register an ordinary tool for native composer mention search. */
+export interface MentionsRegistration<Ctx, Name extends string = string> {
+    /** Non-blank tool name, unique among existing registrations. */
+    name: Name;
+    /** Optional human-readable tool title. */
+    title?: string;
+    /** Optional explanation of the searchable items. */
+    description?: string;
+    /** Tool icons, resolved by the ordinary tool pipeline. */
+    icons?: NonNullable<ToolDefinition["icons"]>;
+    /** Tool annotations; search is read-only by default. */
+    annotations?: NonNullable<ToolDefinition["annotations"]>;
+    /** Descriptor metadata; unrelated UI and extension fields are preserved. */
+    _meta?: NonNullable<ToolDefinition["_meta"]>;
+    /** Explicit visibility; app visibility is always included. */
+    visibility?: NonNullable<ToolDefinition["visibility"]>;
+    /** Authorize, rank, and limit results using the ordinary request context and signal. */
+    search: (params: MentionSearchParams, ctx: Ctx) => MentionSearchResult | Promise<MentionSearchResult>;
+}
+/** Generate schemas and the owned mention marker without invoking search. @internal */
+export declare function prepareMentions<Ctx, Name extends string>(options: MentionsRegistration<Ctx, Name>): {
+    /** Non-blank tool name, unique among existing registrations. */
+    name: Name;
+    /** Optional human-readable tool title. */
+    title?: string;
+    /** Optional explanation of the searchable items. */
+    description?: string;
+    /** Tool icons, resolved by the ordinary tool pipeline. */
+    icons?: NonNullable<ToolDefinition["icons"]>;
+    /** Explicit visibility; app visibility is always included. */
+    visibility?: NonNullable<ToolDefinition["visibility"]>;
+    inputSchema: import("@modelcontextprotocol/server").StandardSchemaWithJSON<{
+        query: string;
+    }, {
+        query: string;
+    }>;
+    outputSchema: import("@modelcontextprotocol/server").StandardSchemaWithJSON<MentionSearchResult, MentionSearchResult>;
+    annotations: {
+        title?: string | undefined;
+        destructiveHint?: boolean | undefined;
+        idempotentHint?: boolean | undefined;
+        openWorldHint?: boolean | undefined;
+        readOnlyHint: boolean | undefined;
+    };
+    _meta: {
+        "openai/extensions": {
+            "mentions/search": {};
+        };
+    };
+};
+/** Restore mention visibility after ordinary view URI ownership is resolved. @internal */
+export declare function finalizeMentionsMeta(definition: ToolDefinition, metadata: MetaObject | undefined): MetaObject;

package/dist/server.d.ts

@@ -2,9 +2,10 @@ import { type ServerEventBus } from "@modelcontextprotocol/server";
 import { Hono, type Env, type MiddlewareHandler } from "hono";
 import { type ServerBranding } from "./branding.js";
 import { type ServerConfig } from "./config.js";
-import { type DefinitionSecuritySchemes, type ToolOAuthMode } from "./context.js";
+import { type DefinitionSecuritySchemes, type RequestContext, type ToolOAuthMode } from "./context.js";
 import { type McpEventListenerFnFor, type McpEventPattern, type McpMiddlewareFnFor, type McpMiddlewarePattern } from "./middleware/mcp-middleware.js";
 import { type SettingsFields, type SettingsRegistration } from "./settings.js";
+import { type MentionsRegistration, type MentionSearchParams, type MentionSearchResult } from "./mentions.js";
 import type { FromOpenAPIOptions } from "./openapi/types.js";
 import type { InferPromptInput, PromptCallback, PromptDefinition } from "./prompts.js";
 import type { InferTemplateParams, ResourceCallback, ResourceDefinition, ResourceTemplateCallback, ResourceTemplateDefinition } from "./resources.js";
@@ -156,6 +157,19 @@ export declare class MCPServer<TUser = never, TEnv extends Env = Env> {
      * or either tool name collides with an existing registration.
      */
     settings<const Fields extends SettingsFields>(options: SettingsRegistration<Fields, TUser, HasOAuth<TUser>, TEnv>): void;
+    /**
+     * Register a composer mention search tool before startup.
+     *
+     * Search receives the ordinary request context, authentication defaults, and
+     * cancellation signal. Authorization, ranking, limits, and resource identity
+     * remain application-owned. Hosts may ignore the marker; explicit tool calls
+     * still work. App visibility is always included, without requiring a View.
+     *
+     * @param options - Tool descriptor and search callback returning resource links.
+     * @returns A normal tool reference with typed query input and link output.
+     * @throws When started, the name or callback is invalid, or the name collides.
+     */
+    mentions<const Name extends string>(options: MentionsRegistration<RequestContext<TUser, HasOAuth<TUser>, TEnv>, Name>): ToolRef<Name, MentionSearchParams, MentionSearchResult>;
     /**
      * Prime the views registry from build/dev registry data.
      *

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcp-use",
   "type": "module",
-  "version": "2.8.2",
+  "version": "2.9.0",
   "description": "MCP framework and CLI built on the official v2 SDK",
   "author": "mcp-use, Inc.",
   "license": "MIT",
@@ -132,8 +132,8 @@
     "@modelcontextprotocol/server": "2.3.1",
     "hono": "^4.13.7",
     "jose": "^6.1.3",
-    "@mcp-use/cli": "4.3.2",
-    "@mcp-use/inspector": "20.3.18"
+    "@mcp-use/inspector": "20.3.19",
+    "@mcp-use/cli": "4.3.3"
   },
   "peerDependencies": {
     "@mcp-use/client": "^2.0.1 || ^2.1.0 || ^2.1.1 || ^2.1.2 || ^2.1.3 || ^2.1.4 || ^2.1.5 || ^2.2.0 || ^2.2.1 || ^2.2.2 || ^2.2.3 || ^2.2.4 || ^2.2.5 || ^2.3.0 || ^2.3.1 || ^2.3.2 || ^2.3.3 || ^2.3.4 || ^2.3.5 || ^2.4.0 || ^2.4.1 || ^2.4.2",