@supernal/interface 1.0.2 → 1.0.4

package/dist/esm/src/decorators/ToolProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"ToolProvider.js","sourceRoot":"","sources":["../../../../src/decorators/ToolProvider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,oEAAoE;AACpE,IAAI,eAAe,GAAmC,IAAI,CAAC;AAE3D,SAAS,eAAe;IACtB,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,0DAA0D;QAC1D,eAAe,GAAG,OAAO,CAAC,qCAAqC,CAAC,CAAC,YAAY,CAAC;IAChF,CAAC;IACD,OAAO,eAAgB,CAAC;AAC1B,CAAC;AAoDD,wCAAwC;AACxC,MAAM,UAAU,YAAY,CAC1B,mBAAgD;IAEhD,OAAO,UAAkD,WAAc;QACrE,kCAAkC;QAClC,MAAM,MAAM,GAAuB,OAAO,mBAAmB,KAAK,QAAQ;YACxE,CAAC,CAAC,EAAE,WAAW,EAAE,mBAAmB,EAAE;YACtC,CAAC,CAAC,mBAAmB,CAAC;QAExB,qCAAqC;QACpC,WAAmB,CAAC,gBAAgB,GAAG;YACtC,IAAI,EAAE,WAAW,CAAC,IAAI;YACtB,MAAM;YACN,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACvC,CAAC;QAEF,sEAAsE;QACtE,MAAM,EAAE,GAAG,eAAe,EAAE,CAAC;QAC7B,IAAI,EAAE,EAAE,CAAC;YACP,MAAM,KAAK,GAAG,EAAE,CAAC,kBAAkB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YACtD,KAAK,CAAC,OAAO,CAAC,CAAC,IAAS,EAAE,EAAE;gBAC1B,8CAA8C;gBAC9C,IAAI,MAAM,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;oBAC5C,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;gBACxC,CAAC;gBACD,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;oBACnE,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;gBACpC,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QAED,qDAAqD;QACrD,MAAM,kBAAkB,GAAG,KAAM,SAAQ,WAAW;YAClD,YAAY,GAAG,IAAW;gBACxB,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;gBAEf,oDAAoD;gBACpD,uCAAuC;gBACvC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;oBAClC,MAAM,EAAE,GAAG,eAAe,EAAE,CAAC;oBAC7B,IAAI,EAAE,EAAE,CAAC;wBACP,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;oBACxB,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,IAAI,CAAC,qDAAqD,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;oBACxF,CAAC;gBACH,CAAC;YACH,CAAC;SACF,CAAC;QAEF,6CAA6C;QAC7C,MAAM,CAAC,cAAc,CAAC,kBAAkB,EAAE,MAAM,EAAE;YAChD,KAAK,EAAE,WAAW,CAAC,IAAI;YACvB,QAAQ,EAAE,KAAK;SAChB,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,gCAAgC,WAAW,CAAC,IAAI,yBAAyB,CAAC,CAAC;QAEvF,OAAO,kBAAuB,CAAC;IACjC,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAW;IAC/C,OAAO,MAAM,CAAC,WAAW,EAAE,gBAAgB,EAAE,MAAM,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAW;IACxC,OAAO,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,gBAAgB,CAAC;AAChD,CAAC"}
+{"version":3,"file":"ToolProvider.js","sourceRoot":"","sources":["../../../../src/decorators/ToolProvider.ts"],"names":[],"mappings":"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"}

package/dist/esm/src/decorators/index.d.ts

@@ -1,8 +1,26 @@
 /**
- * Supernal AI Interface - Decorator System Exports
+ * Supernal Intelligence Interface - Decorator System Exports
  *
  * Enhanced decorators for automatic AI tool generation with safety controls.
  */
+/**
+ * ContainerScope - Named constants for tool container scoping
+ *
+ * Usage:
+ * - ContainerScope.GLOBAL: Tool available on all pages (default)
+ * - Route path (e.g., '/examples'): Tool scoped to that route and sub-routes
+ *
+ * @example
+ * ```typescript
+ * @ToolProvider({ containerId: ContainerScope.GLOBAL })  // Available everywhere
+ * @ToolProvider({ containerId: '/examples' })            // Only on /examples pages
+ * ```
+ */
+export declare const ContainerScope: {
+    /** Tool available on all pages - the default if no containerId specified */
+    readonly GLOBAL: "global";
+};
+export type ContainerScopeType = typeof ContainerScope[keyof typeof ContainerScope] | string;
 export { Tool, ToolConfig, ToolMetadata } from './Tool';
 export { ToolProvider, ToolProviderConfig, getToolProviderConfig, isToolProvider, } from './ToolProvider';
 export { Component, ComponentConfig, getComponentConfig, isComponent, } from './Component';

package/dist/esm/src/decorators/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/decorators/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACxD,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,MAAM,EACN,aAAa,EACb,eAAe,EACf,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,OAAO,EACL,UAAU,EACV,aAAa,EACb,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,UAAU,GACX,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/decorators/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc;IACzB,4EAA4E;;CAEpE,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,OAAO,cAAc,CAAC,MAAM,OAAO,cAAc,CAAC,GAAG,MAAM,CAAC;AAG7F,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACxD,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,MAAM,EACN,aAAa,EACb,eAAe,EACf,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,OAAO,EACL,UAAU,EACV,aAAa,EACb,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,UAAU,GACX,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/esm/src/decorators/index.js

@@ -1,8 +1,26 @@
 /**
- * Supernal AI Interface - Decorator System Exports
+ * Supernal Intelligence Interface - Decorator System Exports
  *
  * Enhanced decorators for automatic AI tool generation with safety controls.
  */
+// Container scope constants
+/**
+ * ContainerScope - Named constants for tool container scoping
+ *
+ * Usage:
+ * - ContainerScope.GLOBAL: Tool available on all pages (default)
+ * - Route path (e.g., '/examples'): Tool scoped to that route and sub-routes
+ *
+ * @example
+ * ```typescript
+ * @ToolProvider({ containerId: ContainerScope.GLOBAL })  // Available everywhere
+ * @ToolProvider({ containerId: '/examples' })            // Only on /examples pages
+ * ```
+ */
+export const ContainerScope = {
+    /** Tool available on all pages - the default if no containerId specified */
+    GLOBAL: 'global',
+};
 // Base decorators
 export { Tool } from './Tool.js';
 export { ToolProvider, getToolProviderConfig, isToolProvider, } from './ToolProvider.js';

package/dist/esm/src/decorators/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/decorators/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,kBAAkB;AAClB,OAAO,EAAE,IAAI,EAA4B,MAAM,QAAQ,CAAC;AACxD,OAAO,EACL,YAAY,EAEZ,qBAAqB,EACrB,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,SAAS,EAET,kBAAkB,EAClB,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,0CAA0C;AAC1C,OAAO,EACL,MAAM,EACN,aAAa,EACb,eAAe,EACf,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAG5B,sCAAsC;AACtC,OAAO,EACL,UAAU,EACV,aAAa,EACb,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,UAAU,GACX,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/decorators/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,4BAA4B;AAC5B;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,4EAA4E;IAC5E,MAAM,EAAE,QAAQ;CACR,CAAC;AAIX,kBAAkB;AAClB,OAAO,EAAE,IAAI,EAA4B,MAAM,QAAQ,CAAC;AACxD,OAAO,EACL,YAAY,EAEZ,qBAAqB,EACrB,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,SAAS,EAET,kBAAkB,EAClB,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,0CAA0C;AAC1C,OAAO,EACL,MAAM,EACN,aAAa,EACb,eAAe,EACf,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAG5B,sCAAsC;AACtC,OAAO,EACL,UAAU,EACV,aAAa,EACb,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,UAAU,GACX,MAAM,cAAc,CAAC"}

package/dist/esm/src/index.d.ts

@@ -9,7 +9,8 @@
  */
 export { Tool, ToolConfig, ToolMetadata } from './decorators/Tool';
 export { getStandaloneTools, getStandaloneTool } from './decorators/Tool';
-export { ToolProvider, ToolProviderConfig, getToolProviderConfig, isToolProvider, } from './decorators/ToolProvider';
+export { ToolProvider, ToolProviderConfig, getToolProviderConfig, isToolProvider, CONTAINER_SCOPE_GLOBAL, } from './decorators/ToolProvider';
+export { ContainerScope, ContainerScopeType } from './decorators';
 export { ClickTool, ChangeTool, TypeTool, HoverTool, MultiActionTool, FormTool } from './decorators/ToolHelpers';
 export { AITool, TestTool, OnboardingTool, DangerousTool, DestructiveTool, DataReadTool, DataWriteTool, NavigationTool, AIAndTestTool, OnboardingAndTestTool, } from './decorators/SpecializedTools';
 export { ToolPreset, getToolPreset, applyPreset, registerPendingPreset, clearToolPresets, PresetTemplates, createPreset, containerPreset, pathPreset, } from './decorators/ToolPreset';
@@ -41,10 +42,12 @@ export type { ComponentId } from './names/createNames';
 export { ChatUIAdapter, ChatUIProps, ReadableState, ToolExecutionCallback, AdapterFactory, ChatUIProviderConfig, ChatUIProvider, ChatUI, useChatUI, useChatUIOptional, withChatUI, NativeAdapter, createNativeAdapter, bridgeToolRegistry, bridgeComponentState, registerReadable, createAuditTrail, setupBridge, } from './adapters';
 export type { CopilotKitAdapterConfig, NativeAdapterConfig, BridgeToolRegistryOptions, BridgeComponentStateOptions, AuditTrailOptions, ToolExecution as ChatToolExecution, } from './adapters';
 export type { UniversalExecutionContext, UniversalToolResult } from './background/registry/ToolRegistry';
+export type { MCPServer, MCPServerConfig, MCPTransport, MCPRequest, MCPResponse, MCPTool, MCPToolsListResponse, MCPToolCallRequest, MCPToolCallResponse } from './mcp';
+export { syncStateToDom, triggerStateChange, getStateFromDom, waitForState, onStateChange, type StateChangeEventDetail } from './state/StateSync';
 export { NavigationGraph } from './background/navigation/NavigationGraph';
 export type { INavigationGraph } from './background/navigation/INavigationGraph';
 export { RuntimeTreeBuilder } from './background/navigation/RuntimeTreeBuilder';
 export { TreeBuilder } from './background/navigation/RuntimeTreeBuilder';
-export declare const VERSION = "1.0.0";
+export declare const VERSION = "1.1.0";
 export declare const PACKAGE_NAME = "@supernal/interface";
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/src/index.d.ts.map

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

package/dist/esm/src/index.js

@@ -10,7 +10,9 @@
 // Core decorators and registry
 export { Tool } from './decorators/Tool.js';
 export { getStandaloneTools, getStandaloneTool } from './decorators/Tool.js';
-export { ToolProvider, getToolProviderConfig, isToolProvider, } from './decorators/ToolProvider.js';
+export { ToolProvider, getToolProviderConfig, isToolProvider, CONTAINER_SCOPE_GLOBAL, } from './decorators/ToolProvider.js';
+// Container scope constants
+export { ContainerScope } from './decorators/index.js';
 export { ClickTool, ChangeTool, TypeTool, HoverTool, MultiActionTool, FormTool } from './decorators/ToolHelpers.js';
 // Specialized decorators and presets
 export { AITool, TestTool, OnboardingTool, DangerousTool, DestructiveTool, DataReadTool, DataWriteTool, NavigationTool, AIAndTestTool, OnboardingAndTestTool, } from './decorators/SpecializedTools.js';
@@ -65,12 +67,14 @@ ChatUIProvider, ChatUI, useChatUI, useChatUIOptional, withChatUI,
 NativeAdapter, createNativeAdapter, 
 // Bridge utilities
 bridgeToolRegistry, bridgeComponentState, registerReadable, createAuditTrail, setupBridge, } from './adapters/index.js';
+// State Management - NEW in v1.1.0
+export { syncStateToDom, triggerStateChange, getStateFromDom, waitForState, onStateChange } from './state/StateSync.js';
 // Enterprise feature stubs (warn users, drive upgrade)
 export { NavigationGraph } from './background/navigation/NavigationGraph.js';
 export { RuntimeTreeBuilder } from './background/navigation/RuntimeTreeBuilder.js';
 export { TreeBuilder } from './background/navigation/RuntimeTreeBuilder.js';
 // Version info
-export const VERSION = '1.0.0';
+export const VERSION = '1.1.0'; // Updated for MCP + State Management
 export const PACKAGE_NAME = '@supernal/interface';
 // Enterprise features not included in open source
 // Available at https://supernal.ai/enterprise:

package/dist/esm/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/esm/src/mcp/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * MCP (Model Context Protocol) Module
+ *
+ * Exports MCP server, transport, and types for exposing Supernal Interface
+ * tools to external AI agents.
+ */
+export { SupernalMCPServer, createSupernalMCPServer } from './server';
+export { StdioTransport, createStdioTransport } from './transport';
+export type { MCPServer, MCPServerConfig, MCPTransport, MCPRequest, MCPResponse, MCPTool, MCPToolsListResponse, MCPToolCallRequest, MCPToolCallResponse, MCPError, MCPErrorCode, MCPContent, MCPTextContent, MCPImageContent, MCPResourceContent, MCPToolParameter } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/src/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnE,YAAY,EACV,SAAS,EACT,eAAe,EACf,YAAY,EACZ,UAAU,EACV,WAAW,EACX,OAAO,EACP,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,SAAS,CAAC"}

package/dist/esm/src/mcp/index.js

@@ -0,0 +1,9 @@
+/**
+ * MCP (Model Context Protocol) Module
+ *
+ * Exports MCP server, transport, and types for exposing Supernal Interface
+ * tools to external AI agents.
+ */
+export { SupernalMCPServer, createSupernalMCPServer } from './server.js';
+export { StdioTransport, createStdioTransport } from './transport.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/src/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/esm/src/mcp/server.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Supernal MCP Server
+ *
+ * MCP (Model Context Protocol) server that exposes Supernal Interface tools
+ * to external AI agents like Claude Desktop, Cursor, and custom MCP clients.
+ *
+ * Usage:
+ * ```typescript
+ * import { createSupernalMCPServer } from '@supernal/interface';
+ *
+ * const server = createSupernalMCPServer({
+ *   name: 'my-app-tools',
+ *   version: '1.0.0'
+ * });
+ *
+ * await server.start();
+ * ```
+ */
+import type { MCPServer, MCPServerConfig, MCPRequest, MCPResponse, MCPTransport } from './types';
+/**
+ * Supernal MCP Server implementation
+ */
+export declare class SupernalMCPServer implements MCPServer {
+    config: MCPServerConfig;
+    private executor;
+    private transport?;
+    private running;
+    constructor(config?: Partial<MCPServerConfig>);
+    /**
+     * Start the MCP server with given transport
+     */
+    start(transport: MCPTransport): Promise<void>;
+    /**
+     * Stop the MCP server
+     */
+    stop(): Promise<void>;
+    /**
+     * Handle incoming MCP request
+     */
+    handle(request: MCPRequest): Promise<MCPResponse | null>;
+    /**
+     * Handle tools/list request
+     *
+     * Returns location-filtered tools based on LocationContext.getCurrent()
+     * Uses @LocationScope decorators to determine tool availability
+     */
+    private handleToolsList;
+    /**
+     * Handle tools/call request
+     */
+    private handleToolCall;
+    /**
+     * Handle initialize request
+     */
+    private handleInitialize;
+    /**
+     * Convert Supernal tool to MCP tool format
+     */
+    private convertToMCPTool;
+    /**
+     * Create error response
+     */
+    private errorResponse;
+}
+/**
+ * Create and configure a Supernal MCP server
+ *
+ * @param config - Server configuration
+ * @returns Configured MCP server instance
+ *
+ * @example
+ * ```typescript
+ * const server = createSupernalMCPServer({
+ *   name: 'my-app-tools',
+ *   version: '1.0.0'
+ * });
+ *
+ * // Start with stdio transport
+ * const transport = new StdioTransport();
+ * await server.start(transport);
+ * ```
+ */
+export declare function createSupernalMCPServer(config?: Partial<MCPServerConfig>): SupernalMCPServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/esm/src/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,UAAU,EACV,WAAW,EAMX,YAAY,EACb,MAAM,SAAS,CAAC;AAiBjB;;GAEG;AACH,qBAAa,iBAAkB,YAAW,SAAS;IAC1C,MAAM,EAAE,eAAe,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,SAAS,CAAC,CAAe;IACjC,OAAO,CAAC,OAAO,CAAkB;gBAErB,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM;IAKjD;;OAEG;IACG,KAAK,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAwCnD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAiC9D;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAqBvB;;OAEG;YACW,cAAc;IAwE5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAexB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAwBxB;;OAEG;IACH,OAAO,CAAC,aAAa;CAkBtB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,iBAAiB,CAE5F"}

package/dist/esm/src/mcp/server.js

@@ -0,0 +1,276 @@
+/**
+ * Supernal MCP Server
+ *
+ * MCP (Model Context Protocol) server that exposes Supernal Interface tools
+ * to external AI agents like Claude Desktop, Cursor, and custom MCP clients.
+ *
+ * Usage:
+ * ```typescript
+ * import { createSupernalMCPServer } from '@supernal/interface';
+ *
+ * const server = createSupernalMCPServer({
+ *   name: 'my-app-tools',
+ *   version: '1.0.0'
+ * });
+ *
+ * await server.start();
+ * ```
+ */
+import { ToolRegistry } from '../background/registry/ToolRegistry.js';
+import { ToolExecutor } from '../ai/ToolExecutor.js';
+import { MCPErrorCode } from './types.js';
+/**
+ * Default server configuration
+ */
+const DEFAULT_CONFIG = {
+    name: 'supernal-interface',
+    version: '1.0.0',
+    description: 'MCP server for Supernal Interface tools',
+    capabilities: {
+        tools: {},
+        resources: {},
+        prompts: {}
+    }
+};
+/**
+ * Supernal MCP Server implementation
+ */
+export class SupernalMCPServer {
+    constructor(config = {}) {
+        this.running = false;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.executor = new ToolExecutor();
+    }
+    /**
+     * Start the MCP server with given transport
+     */
+    async start(transport) {
+        if (this.running) {
+            throw new Error('Server is already running');
+        }
+        this.transport = transport;
+        this.running = true;
+        console.error(`[MCP Server] Starting: ${this.config.name} v${this.config.version}`);
+        // Message processing loop
+        while (this.running) {
+            try {
+                const request = await this.transport.receive();
+                const response = await this.handle(request);
+                // Only send response if not null (notifications return null)
+                if (response !== null) {
+                    await this.transport.send(response);
+                }
+            }
+            catch (error) {
+                if (!this.running)
+                    break; // Transport closed
+                console.error('[MCP Server] Error processing message:', error);
+                // Send error response
+                if (this.transport) {
+                    await this.transport.send({
+                        jsonrpc: '2.0',
+                        error: {
+                            code: MCPErrorCode.INTERNAL_ERROR,
+                            message: error instanceof Error ? error.message : 'Internal server error',
+                            data: error
+                        }
+                    });
+                }
+            }
+        }
+    }
+    /**
+     * Stop the MCP server
+     */
+    async stop() {
+        this.running = false;
+        if (this.transport) {
+            await this.transport.close();
+            this.transport = undefined;
+        }
+        console.error('[MCP Server] Stopped');
+    }
+    /**
+     * Handle incoming MCP request
+     */
+    async handle(request) {
+        const { method, params, id } = request;
+        try {
+            // Handle notifications (no response needed)
+            if (method.startsWith('notifications/')) {
+                console.error(`[MCP Server] Received notification: ${method}`);
+                return null; // No response for notifications
+            }
+            switch (method) {
+                case 'tools/list':
+                    return this.handleToolsList(id);
+                case 'tools/call':
+                    return await this.handleToolCall(id, params);
+                case 'initialize':
+                    return this.handleInitialize(id);
+                default:
+                    return this.errorResponse(id, MCPErrorCode.METHOD_NOT_FOUND, `Method not found: ${method}`);
+            }
+        }
+        catch (error) {
+            return this.errorResponse(id, MCPErrorCode.INTERNAL_ERROR, error instanceof Error ? error.message : 'Internal error', error);
+        }
+    }
+    /**
+     * Handle tools/list request
+     *
+     * Returns location-filtered tools based on LocationContext.getCurrent()
+     * Uses @LocationScope decorators to determine tool availability
+     */
+    handleToolsList(id) {
+        const toolsByContainer = ToolRegistry.getToolsGroupedByContainerForLocation();
+        const mcpTools = [];
+        for (const [container, containerTools] of Object.entries(toolsByContainer)) {
+            for (const tool of containerTools) {
+                mcpTools.push(this.convertToMCPTool(container, tool));
+            }
+        }
+        const response = {
+            tools: mcpTools
+        };
+        return {
+            jsonrpc: '2.0',
+            id,
+            result: response
+        };
+    }
+    /**
+     * Handle tools/call request
+     */
+    async handleToolCall(id, params) {
+        const { name, arguments: args } = params;
+        if (!name) {
+            return this.errorResponse(id, MCPErrorCode.INVALID_PARAMS, 'Missing tool name');
+        }
+        // Parse tool name (format: container.toolName)
+        const [container, toolName] = name.split('.');
+        if (!container || !toolName) {
+            return this.errorResponse(id, MCPErrorCode.INVALID_PARAMS, `Invalid tool name format: ${name}. Expected: container.toolName`);
+        }
+        // Find tool by containerId and tool name
+        // The tool may be registered with its class name, but exposed with containerId
+        // Handle undefined containerId (treat as matching the container name used in MCP)
+        const tool = Array.from(ToolRegistry.getAllTools().values()).find(t => {
+            const toolContainer = t.containerId || 'global'; // undefined becomes 'global'
+            return toolContainer === container && t.name === toolName;
+        });
+        if (!tool) {
+            return this.errorResponse(id, MCPErrorCode.TOOL_NOT_FOUND, `Tool not found: ${name}`);
+        }
+        // Execute tool
+        try {
+            // Convert args object to array format expected by ToolExecutor
+            const argsArray = Object.values(args || {});
+            const result = await this.executor.execute(tool, argsArray);
+            if (!result.success) {
+                return this.errorResponse(id, MCPErrorCode.TOOL_EXECUTION_FAILED, result.message || 'Tool execution failed', { error: result.error, timing: result.timing });
+            }
+            // Format success response
+            const response = {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: true,
+                            result: result.data,
+                            timing: result.timing,
+                            message: result.message
+                        }, null, 2)
+                    }
+                ]
+            };
+            return {
+                jsonrpc: '2.0',
+                id,
+                result: response
+            };
+        }
+        catch (error) {
+            return this.errorResponse(id, MCPErrorCode.TOOL_EXECUTION_FAILED, error instanceof Error ? error.message : 'Tool execution failed', error);
+        }
+    }
+    /**
+     * Handle initialize request
+     */
+    handleInitialize(id) {
+        return {
+            jsonrpc: '2.0',
+            id,
+            result: {
+                protocolVersion: '2024-11-05',
+                serverInfo: {
+                    name: this.config.name,
+                    version: this.config.version
+                },
+                capabilities: this.config.capabilities
+            }
+        };
+    }
+    /**
+     * Convert Supernal tool to MCP tool format
+     */
+    convertToMCPTool(container, tool) {
+        // tool.inputSchema is already a full schema object {type, properties, required}
+        // Use it directly, or create a default if missing
+        const inputSchema = tool.inputSchema || {
+            type: 'object',
+            properties: {},
+            required: []
+        };
+        return {
+            name: `${container}.${tool.name}`,
+            description: tool.description || `Tool: ${tool.name}`,
+            inputSchema,
+            annotations: {
+                container,
+                category: tool.category,
+                elementId: tool.elementId,
+                componentName: tool.componentName,
+                toolType: tool.toolType,
+                aiEnabled: tool.aiEnabled
+            }
+        };
+    }
+    /**
+     * Create error response
+     */
+    errorResponse(id, code, message, data) {
+        const error = {
+            code,
+            message,
+            data
+        };
+        return {
+            jsonrpc: '2.0',
+            id,
+            error
+        };
+    }
+}
+/**
+ * Create and configure a Supernal MCP server
+ *
+ * @param config - Server configuration
+ * @returns Configured MCP server instance
+ *
+ * @example
+ * ```typescript
+ * const server = createSupernalMCPServer({
+ *   name: 'my-app-tools',
+ *   version: '1.0.0'
+ * });
+ *
+ * // Start with stdio transport
+ * const transport = new StdioTransport();
+ * await server.start(transport);
+ * ```
+ */
+export function createSupernalMCPServer(config) {
+    return new SupernalMCPServer(config);
+}
+//# sourceMappingURL=server.js.map

package/dist/esm/src/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAelD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;GAEG;AACH,MAAM,cAAc,GAA6B;IAC/C,IAAI,EAAE,oBAAoB;IAC1B,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,yCAAyC;IACtD,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;QACT,SAAS,EAAE,EAAE;QACb,OAAO,EAAE,EAAE;KACZ;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,iBAAiB;IAM5B,YAAY,SAAmC,EAAE;QAFzC,YAAO,GAAY,KAAK,CAAC;QAG/B,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAqB,CAAC;QAClE,IAAI,CAAC,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,SAAuB;QACjC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QAEpB,OAAO,CAAC,KAAK,CAAC,0BAA0B,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAEpF,0BAA0B;QAC1B,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;YACpB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;gBAC/C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBAE5C,6DAA6D;gBAC7D,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;oBACtB,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACtC,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,IAAI,CAAC,OAAO;oBAAE,MAAM,CAAC,mBAAmB;gBAE7C,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,KAAK,CAAC,CAAC;gBAE/D,sBAAsB;gBACtB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;oBACnB,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;wBACxB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE;4BACL,IAAI,EAAE,YAAY,CAAC,cAAc;4BACjC,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB;4BACzE,IAAI,EAAE,KAAK;yBACZ;qBACF,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QAErB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YAC7B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC7B,CAAC;QAED,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,OAAmB;QAC9B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC;QAEvC,IAAI,CAAC;YACH,4CAA4C;YAC5C,IAAI,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBACxC,OAAO,CAAC,KAAK,CAAC,uCAAuC,MAAM,EAAE,CAAC,CAAC;gBAC/D,OAAO,IAAI,CAAC,CAAC,gCAAgC;YAC/C,CAAC;YAED,QAAQ,MAAM,EAAE,CAAC;gBACf,KAAK,YAAY;oBACf,OAAO,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;gBAElC,KAAK,YAAY;oBACf,OAAO,MAAM,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE,MAA4B,CAAC,CAAC;gBAErE,KAAK,YAAY;oBACf,OAAO,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;gBAEnC;oBACE,OAAO,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,YAAY,CAAC,gBAAgB,EAAE,qBAAqB,MAAM,EAAE,CAAC,CAAC;YAChG,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,aAAa,CACvB,EAAE,EACF,YAAY,CAAC,cAAc,EAC3B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,EACzD,KAAK,CACN,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,eAAe,CAAC,EAAoB;QAC1C,MAAM,gBAAgB,GAAG,YAAY,CAAC,qCAAqC,EAAE,CAAC;QAC9E,MAAM,QAAQ,GAAc,EAAE,CAAC;QAE/B,KAAK,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC3E,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;gBAClC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAyB;YACrC,KAAK,EAAE,QAAQ;SAChB,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,KAAK;YACd,EAAE;YACF,MAAM,EAAE,QAAQ;SACjB,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc,CAAC,EAA+B,EAAE,MAA0B;QACtF,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;QAEzC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,YAAY,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAC;QAClF,CAAC;QAED,+CAA+C;QAC/C,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE9C,IAAI,CAAC,SAAS,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,YAAY,CAAC,cAAc,EAAE,6BAA6B,IAAI,gCAAgC,CAAC,CAAC;QAChI,CAAC;QAED,yCAAyC;QACzC,+EAA+E;QAC/E,kFAAkF;QAClF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;YACpE,MAAM,aAAa,GAAG,CAAC,CAAC,WAAW,IAAI,QAAQ,CAAC,CAAC,6BAA6B;YAC9E,OAAO,aAAa,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;QAC5D,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,YAAY,CAAC,cAAc,EAAE,mBAAmB,IAAI,EAAE,CAAC,CAAC;QACxF,CAAC;QAED,eAAe;QACf,IAAI,CAAC;YACH,+DAA+D;YAC/D,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YAC5C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAE5D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,IAAI,CAAC,aAAa,CACvB,EAAE,EACF,YAAY,CAAC,qBAAqB,EAClC,MAAM,CAAC,OAAO,IAAI,uBAAuB,EACzC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAC/C,CAAC;YACJ,CAAC;YAED,0BAA0B;YAC1B,MAAM,QAAQ,GAAwB;gBACpC,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,OAAO,EAAE,IAAI;4BACb,MAAM,EAAE,MAAM,CAAC,IAAI;4BACnB,MAAM,EAAE,MAAM,CAAC,MAAM;4BACrB,OAAO,EAAE,MAAM,CAAC,OAAO;yBACxB,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ;iBACF;aACF,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,EAAE;gBACF,MAAM,EAAE,QAAQ;aACjB,CAAC;QAEJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,aAAa,CACvB,EAAE,EACF,YAAY,CAAC,qBAAqB,EAClC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB,EAChE,KAAK,CACN,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,EAAoB;QAC3C,OAAO;YACL,OAAO,EAAE,KAAK;YACd,EAAE;YACF,MAAM,EAAE;gBACN,eAAe,EAAE,YAAY;gBAC7B,UAAU,EAAE;oBACV,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;oBACtB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;iBAC7B;gBACD,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY;aACvC;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,SAAiB,EAAE,IAAkB;QAC5D,gFAAgF;QAChF,kDAAkD;QAClD,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI;YACtC,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;SACb,CAAC;QAEF,OAAO;YACL,IAAI,EAAE,GAAG,SAAS,IAAI,IAAI,CAAC,IAAI,EAAE;YACjC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,SAAS,IAAI,CAAC,IAAI,EAAE;YACrD,WAAW;YACX,WAAW,EAAE;gBACX,SAAS;gBACT,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,SAAS,EAAE,IAAI,CAAC,SAAS;aAC1B;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,aAAa,CACnB,EAA+B,EAC/B,IAAkB,EAClB,OAAe,EACf,IAAU;QAEV,MAAM,KAAK,GAAa;YACtB,IAAI;YACJ,OAAO;YACP,IAAI;SACL,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,KAAK;YACd,EAAE;YACF,KAAK;SACN,CAAC;IACJ,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAiC;IACvE,OAAO,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC"}

package/dist/esm/src/mcp/transport.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Stdio Transport for MCP
+ *
+ * Implements MCP transport over stdin/stdout for integration with
+ * Claude Desktop, Cursor, and other MCP clients.
+ */
+import type { MCPTransport, MCPRequest, MCPResponse } from './types';
+/**
+ * Stdio transport implementation
+ *
+ * Reads JSON-RPC messages from stdin (one per line)
+ * Writes JSON-RPC responses to stdout (one per line)
+ */
+export declare class StdioTransport implements MCPTransport {
+    private readline?;
+    private messageQueue;
+    private waitingResolvers;
+    private closed;
+    constructor();
+    /**
+     * Setup readline interface for stdin
+     */
+    private setupReadline;
+    /**
+     * Send message to client (write to stdout)
+     */
+    send(message: MCPResponse): Promise<void>;
+    /**
+     * Receive message from client (read from stdin)
+     */
+    receive(): Promise<MCPRequest>;
+    /**
+     * Close transport
+     */
+    close(): Promise<void>;
+}
+/**
+ * Create stdio transport
+ *
+ * @returns Stdio transport instance
+ *
+ * @example
+ * ```typescript
+ * import { createSupernalMCPServer, createStdioTransport } from '@supernal/interface';
+ *
+ * const server = createSupernalMCPServer();
+ * const transport = createStdioTransport();
+ *
+ * await server.start(transport);
+ * ```
+ */
+export declare function createStdioTransport(): StdioTransport;
+//# sourceMappingURL=transport.d.ts.map

package/dist/esm/src/mcp/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../../src/mcp/transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAErE;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,YAAY;IACjD,OAAO,CAAC,QAAQ,CAAC,CAAoB;IACrC,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,gBAAgB,CAA4C;IACpE,OAAO,CAAC,MAAM,CAAkB;;IAMhC;;OAEG;IACH,OAAO,CAAC,aAAa;IAuCrB;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IAgBpC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAoB7B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAErD"}