tmcp 1.4.0 → 1.6.0

package/src/index.d.ts

@@ -10,10 +10,15 @@ export class McpServer<StandardSchema extends StandardSchemaV1> {
      * @param {ServerOptions<StandardSchema>} options
      */
     constructor(server_info: ServerInfo, options: ServerOptions<StandardSchema>);
+    /**
+     * @type {Array<{uri: string, name?: string}>}
+     */
+    roots: Array<{
+        uri: string;
+        name?: string;
+    }>;
     currentClientCapabilities(): {
-        roots?: {
-            listChanged?: boolean;
-        } & {
+        experimental?: {} & {
             [key: string]: unknown;
         };
         sampling?: {} & {
@@ -22,6 +27,11 @@ export class McpServer<StandardSchema extends StandardSchemaV1> {
         elicitation?: {} & {
             [key: string]: unknown;
         };
+        roots?: {
+            listChanged?: boolean;
+        } & {
+            [key: string]: unknown;
+        };
     } & {
         [key: string]: unknown;
     };
@@ -34,64 +44,86 @@ export class McpServer<StandardSchema extends StandardSchemaV1> {
     on<TEvent extends keyof McpEvents>(event: TEvent, callback: McpEvents[TEvent], options?: AddEventListenerOptions): void;
     /**
      * @template {StandardSchema | undefined} [TSchema=undefined]
-     * @param {{ name: string; description: string; schema?: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema> extends Record<string, unknown> ? TSchema : never }} options
+     * @param {{ name: string; description: string; title?: string; schema?: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema> extends Record<string, unknown> ? TSchema : never }} options
      * @param {TSchema extends undefined ? (()=>Promise<CallToolResult> | CallToolResult) : ((input: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema>) => Promise<CallToolResult> | CallToolResult)} execute
      */
-    tool<TSchema extends StandardSchema | undefined = undefined>({ name, description, schema }: {
+    tool<TSchema extends StandardSchema | undefined = undefined>({ name, description, title, schema }: {
         name: string;
         description: string;
+        title?: string;
         schema?: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema> extends Record<string, unknown> ? TSchema : never;
     }, execute: TSchema extends undefined ? (() => Promise<CallToolResult> | CallToolResult) : ((input: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema>) => Promise<CallToolResult> | CallToolResult)): void;
     /**
      * @template {StandardSchema | undefined} [TSchema=undefined]
-     * @param {{ name: string; description: string; schema?: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema> extends Record<string, unknown> ? TSchema : never; complete?: NoInfer<TSchema extends undefined ? never : Partial<Record<keyof (StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema>), Completion>>> }} options
+     * @param {{ name: string; description: string; title?: string; schema?: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema> extends Record<string, unknown> ? TSchema : never; complete?: NoInfer<TSchema extends undefined ? never : Partial<Record<keyof (StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema>), Completion>>> }} options
      * @param {TSchema extends undefined ? (()=>Promise<GetPromptResult> | GetPromptResult) : (input: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema>) => Promise<GetPromptResult> | GetPromptResult} execute
      */
-    prompt<TSchema extends StandardSchema | undefined = undefined>({ name, description, schema, complete }: {
+    prompt<TSchema extends StandardSchema | undefined = undefined>({ name, description, title, schema, complete }: {
         name: string;
         description: string;
+        title?: string;
         schema?: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema> extends Record<string, unknown> ? TSchema : never;
         complete?: NoInfer<TSchema extends undefined ? never : Partial<Record<keyof StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema>, Completion>>>;
     }, execute: TSchema extends undefined ? (() => Promise<GetPromptResult> | GetPromptResult) : (input: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema>) => Promise<GetPromptResult> | GetPromptResult): void;
     /**
-     * @param {{ name: string; description: string; uri: string }} options
+     * @param {{ name: string; description: string; title?: string; uri: string }} options
      * @param {(uri: string) => Promise<ReadResourceResult> | ReadResourceResult} execute
      */
-    resource({ name, description, uri }: {
+    resource({ name, description, title, uri }: {
         name: string;
         description: string;
+        title?: string;
         uri: string;
     }, execute: (uri: string) => Promise<ReadResourceResult> | ReadResourceResult): void;
     /**
      * @template {string} TUri
      * @template {ExtractURITemplateVariables<TUri>} TVariables
-     * @param {{ name: string; description: string; uri: TUri; complete?: NoInfer<TVariables extends never ? never : Partial<Record<TVariables, Completion>>> }} options
+     * @param {{ name: string; description: string; title?: string; uri: TUri; complete?: NoInfer<TVariables extends never ? never : Partial<Record<TVariables, Completion>>>; list?: () => Promise<Array<Resource>> | Array<Resource> }} options
      * @param {(uri: string, params: Record<TVariables, string | string[]>) => Promise<ReadResourceResult> | ReadResourceResult} execute
      */
-    template<TUri extends string, TVariables extends ExtractURITemplateVariables<TUri>>({ name, description, uri, complete }: {
+    template<TUri extends string, TVariables extends ExtractURITemplateVariables<TUri>>({ name, description, title, uri, complete, list: list_resources }: {
         name: string;
         description: string;
+        title?: string;
         uri: TUri;
         complete?: NoInfer<TVariables extends never ? never : Partial<Record<TVariables, Completion>>>;
+        list?: () => Promise<Array<Resource>> | Array<Resource>;
     }, execute: (uri: string, params: Record<TVariables, string | string[]>) => Promise<ReadResourceResult> | ReadResourceResult): void;
     /**
-     * @param {JSONRPCRequest} request
+     * @param {JSONRPCResponse | JSONRPCRequest} message
      * @param {string} [session_id]
-     * @returns {ReturnType<JSONRPCServer['receive']>}
+     * @returns {ReturnType<JSONRPCServer['receive']> | ReturnType<JSONRPCClient['receive'] | undefined>}
      */
-    receive(request: JSONRPCRequest, session_id?: string): ReturnType<JSONRPCServer["receive"]>;
+    receive(message: JSONRPCResponse | JSONRPCRequest, session_id?: string): ReturnType<JSONRPCServer["receive"]> | ReturnType<JSONRPCClient["receive"] | undefined>;
     /**
      * Send a notification for subscriptions
      * @param {SubscriptionsKeys} what
      * @param {string} id
      */
     changed(what: SubscriptionsKeys, id: string): void;
+    /**
+     * Refresh roots list from client
+     */
+    refreshRoots(): Promise<void>;
     /**
      * @template {StandardSchema} TSchema
      * @param {TSchema} schema
      * @returns {Promise<StandardSchemaV1.InferOutput<TSchema>>}
      */
     elicitation<TSchema extends StandardSchema>(schema: TSchema): Promise<StandardSchemaV1.InferOutput<TSchema>>;
+    /**
+     * Request language model sampling from the client
+     * @param {CreateMessageRequestParams} request
+     * @returns {Promise<CreateMessageResult>}
+     */
+    message(request: CreateMessageRequestParams): Promise<CreateMessageResult>;
+    /**
+     * Log a message to the client if logging is enabled and the level is appropriate
+     * @param {LoggingLevel} level
+     * @param {unknown} data
+     * @param {string} [logger]
+     */
+    log(level: LoggingLevel, data: unknown, logger?: string): void;
     #private;
 }
 export type ClientCapabilities = ClientCapabilitiesType;
@@ -102,9 +134,15 @@ import type { Completion } from "./internal/internal.js";
 import type { GetPromptResult } from "./validation/index.js";
 import type { ReadResourceResult } from "./validation/index.js";
 import type { ExtractURITemplateVariables } from "./internal/uri-template.js";
+import type { Resource } from "./validation/index.js";
+import type { JSONRPCResponse } from "./validation/index.js";
 import type { JSONRPCRequest } from "json-rpc-2.0";
 import { JSONRPCServer } from 'json-rpc-2.0';
+import { JSONRPCClient } from 'json-rpc-2.0';
 import type { SubscriptionsKeys } from "./internal/internal.js";
+import type { CreateMessageRequestParams } from "./validation/index.js";
+import type { CreateMessageResult } from "./validation/index.js";
+import type { LoggingLevel } from "./validation/index.js";
 import type { ServerInfo } from "./internal/internal.js";
 import type { ServerOptions } from "./internal/internal.js";
 import type { ClientCapabilities as ClientCapabilitiesType } from "./validation/index.js";