@oobe-protocol-labs/sap-mcp-server 0.1.0

package/dist/adapters/mcp/sdk-compat.d.ts

@@ -0,0 +1,191 @@
+/**
+ * MCP SDK compatibility layer
+ *
+ * Provides unified API for registering tools, resources, and prompts
+ * across different MCP SDK versions.
+ *
+ * CRITICAL: This layer MUST register JSON-RPC request handlers for:
+ * - tools/list, tools/call
+ * - resources/list, resources/read, resources/templates/list
+ * - prompts/list, prompts/get
+ *
+ * Following MCP SDK v1.x specification:
+ * https://github.com/modelcontextprotocol/typescript-sdk
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { Tool, Resource, ResourceTemplate, Prompt } from '@modelcontextprotocol/sdk/types.js';
+import type { SapMcpContext } from '../../core/types.js';
+type ResourceHandler = () => Promise<unknown>;
+type ResourceTemplateHandler = (uri: string, args: Record<string, unknown>) => Promise<unknown>;
+type PromptHandler = (args: Record<string, unknown>) => Promise<unknown>;
+/**
+ * Associates runtime context with an MCP server so tool calls can enforce policy and key-safety guards.
+ */
+export declare function setToolExecutionContext(server: Server, context: SapMcpContext): void;
+/**
+ * Tool registration helper
+ *
+ * Registers a tool and ensures JSON-RPC handlers are set up for tools/list and tools/call
+ */
+export declare function registerTool<TInput = unknown>(server: Server, name: string, definition: {
+    title?: string;
+    description: string;
+    inputSchema: unknown;
+}, handler: (input: TInput) => Promise<unknown>): {
+    inputSchema: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: object;
+        } | undefined;
+        required?: string[] | undefined;
+    };
+    name: string;
+    description?: string | undefined;
+    outputSchema?: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: object;
+        } | undefined;
+        required?: string[] | undefined;
+    } | undefined;
+    annotations?: {
+        title?: string | undefined;
+        readOnlyHint?: boolean | undefined;
+        destructiveHint?: boolean | undefined;
+        idempotentHint?: boolean | undefined;
+        openWorldHint?: boolean | undefined;
+    } | undefined;
+    execution?: {
+        taskSupport?: "optional" | "required" | "forbidden" | undefined;
+    } | undefined;
+    _meta?: {
+        [x: string]: unknown;
+    } | undefined;
+    icons?: {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+        theme?: "light" | "dark" | undefined;
+    }[] | undefined;
+    title?: string | undefined;
+};
+/**
+ * Resource registration helper
+ *
+ * Registers a resource and ensures JSON-RPC handlers are set up for resources/list and resources/read
+ */
+export declare function registerResource(server: Server, uri: string, schema: unknown, definition: {
+    name: string;
+    description?: string;
+    mimeType?: string;
+}, handler: ResourceHandler): {
+    uri: string;
+    name: string;
+    description?: string | undefined;
+    mimeType?: string | undefined;
+    size?: number | undefined;
+    annotations?: {
+        audience?: ("user" | "assistant")[] | undefined;
+        priority?: number | undefined;
+        lastModified?: string | undefined;
+    } | undefined;
+    _meta?: {
+        [x: string]: unknown;
+    } | undefined;
+    icons?: {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+        theme?: "light" | "dark" | undefined;
+    }[] | undefined;
+    title?: string | undefined;
+};
+/**
+ * Resource template registration helper
+ *
+ * Registers a resource template and ensures JSON-RPC handlers are set up
+ */
+export declare function registerResourceTemplate(server: Server, uriTemplate: string, schema: unknown, definition: {
+    name: string;
+    description?: string;
+    mimeType?: string;
+}, handler: ResourceTemplateHandler): {
+    uriTemplate: string;
+    name: string;
+    description?: string | undefined;
+    mimeType?: string | undefined;
+    annotations?: {
+        audience?: ("user" | "assistant")[] | undefined;
+        priority?: number | undefined;
+        lastModified?: string | undefined;
+    } | undefined;
+    _meta?: {
+        [x: string]: unknown;
+    } | undefined;
+    icons?: {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+        theme?: "light" | "dark" | undefined;
+    }[] | undefined;
+    title?: string | undefined;
+};
+/**
+ * Prompt registration helper
+ *
+ * Registers a prompt and ensures JSON-RPC handlers are set up for prompts/list and prompts/get
+ */
+export declare function registerPrompt(server: Server, name: string, schema: unknown, definition: {
+    description: string;
+    arguments?: Array<{
+        name: string;
+        description: string;
+        required?: boolean;
+    }>;
+}, handler: PromptHandler): {
+    name: string;
+    description?: string | undefined;
+    arguments?: {
+        name: string;
+        description?: string | undefined;
+        required?: boolean | undefined;
+    }[] | undefined;
+    _meta?: {
+        [x: string]: unknown;
+    } | undefined;
+    icons?: {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+        theme?: "light" | "dark" | undefined;
+    }[] | undefined;
+    title?: string | undefined;
+};
+/**
+ * Get registered tools
+ */
+export declare function getRegisteredTools(server: Server): Tool[];
+/**
+ * Get registered resources
+ */
+export declare function getRegisteredResources(server: Server): Resource[];
+/**
+ * Get registered resource templates
+ */
+export declare function getRegisteredResourceTemplates(server: Server): ResourceTemplate[];
+/**
+ * Get registered prompts
+ */
+export declare function getRegisteredPrompts(server: Server): Prompt[];
+/**
+ * Get handler registration status
+ */
+export declare function getHandlerStatus(server: Server): {
+    tools: boolean;
+    resources: boolean;
+    prompts: boolean;
+};
+export {};
+//# sourceMappingURL=sdk-compat.d.ts.map

package/dist/adapters/mcp/sdk-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-compat.d.ts","sourceRoot":"","sources":["../../../src/adapters/mcp/sdk-compat.ts"],"names":[],"mappings":"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"}