@interopio/mcp-core 0.1.0-beta.0

package/mcp-core.d.ts

@@ -0,0 +1,148 @@
+import { IOConnectBrowser } from "@interopio/browser";
+import { IOConnectDesktop } from "@interopio/desktop";
+import { IoIntelWorkingContext, IoIntelWorkingContextFactoryFunction } from "@interopio/intel-working-context";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+export namespace IoIntelMCPCore {
+
+    export interface ClientCapabilities {
+        [x: string]: unknown;
+        experimental?: {
+            [x: string]: unknown;
+        };
+        sampling?: {
+            [x: string]: unknown;
+        };
+        elicitation?: {
+            [x: string]: unknown;
+        };
+        roots?: {
+            [x: string]: unknown;
+            listChanged?: boolean;
+        };
+    }
+
+    export interface StaticToolConfig {
+        description: string;
+        inputSchema: Record<string, any>;
+        outputSchema: Record<string, any>;
+        title?: string;
+        annotations?: {
+            title?: string;
+            readOnlyHint?: boolean;
+            destructiveHint?: boolean;
+            idempotentHint?: boolean;
+            openWorldHint?: boolean;
+        }
+        _meta?: Record<string, unknown>;
+    }
+
+    export interface StaticToolDefinition {
+        availability: "variable" | "constant";
+        name: string;
+        config: StaticToolConfig;
+    }
+
+    export interface StaticMethodToolConfig extends StaticToolDefinition {
+        interop: {
+            methodName: string;
+            responseTimeoutMs?: number;
+            allowedApplications?: string[]; // default: all applications allowed
+        }
+    }
+
+    // recommended input schema to have type: string, as this is passed as context.type
+    export interface StaticIntentToolConfig extends StaticToolDefinition {
+        interop: {
+            intentName: string;
+            responseTimeoutMs?: number;
+            resolutionStrategy?: "mcp" | "io_connect"; // default: mcp
+            allowedApplications?: string[]; // default: all applications allowed
+        }
+    }
+
+    export interface DynamicToolsConfig {
+        methods?: {
+            enabled?: boolean; // default: true
+            guard?(method: IOConnectBrowser.Interop.Method, server: IOConnectBrowser.Interop.Instance): boolean;
+        }
+    }
+
+    export interface StaticToolsConfig {
+        methods?: StaticMethodToolConfig[];
+        intents?: StaticIntentToolConfig[];
+    }
+
+    export interface SystemToolConfig {
+        searchApps?: {
+            enabled?: boolean; // default: true
+            overrides?: {
+                name?: string;
+                description?: string;
+            };
+            guard?(app: { name: string }): boolean;
+        };
+        searchWorkspaces?: {
+            enabled?: boolean; // default: true
+            overrides?: {
+                name?: string;
+                description?: string;
+            };
+            guard?(workspace: { name: string }): boolean;
+        };
+        startApps?: {
+            enabled?: boolean; // default: true
+            overrides?: {
+                name?: string;
+                description?: string;
+            }
+        };
+        startWorkspaces?: {
+            enabled?: boolean; // default: true
+            overrides?: {
+                name?: string;
+                description?: string;
+            }
+        };
+    }
+
+    export interface McpServerConfig {
+        name: string;
+        title?: string | undefined;
+        tools?: {
+            dynamic?: DynamicToolsConfig;
+            static?: StaticToolsConfig;
+            system?: SystemToolConfig;
+        }
+    }
+
+    export interface McpTransportConfig {
+        type: "stdio" | "http" | "web";
+    }
+
+    export interface WorkingContextConfig {
+        factory: IoIntelWorkingContextFactoryFunction;
+        config?: IoIntelWorkingContext.Config;
+    }
+
+    export interface MCPCore {
+        id: string;
+        instance: McpServer;
+    }
+
+    export interface Config {
+        server: McpServerConfig;
+        licenseKey: string;
+        transport: McpTransportConfig;
+        context?: WorkingContextConfig;
+    }
+
+    export interface API {
+        createMCPInstance(clientCapabilities: ClientCapabilities): MCPCore;
+        removeMCPInstance(id: string): void;
+    }
+}
+
+export type IoIntelMCPCoreFactoryFunction = (io: IOConnectBrowser.API | IOConnectDesktop.API, config: IoIntelMCPCore.Config) => Promise<IoIntelMCPCore.API>;
+
+export declare const IoIntelMCPCoreFactory: IoIntelMCPCoreFactoryFunction;

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@interopio/mcp-core",
+  "version": "0.1.0-beta.0",
+  "type": "module",
+  "description": "io.Intelligence MCP Core Library",
+  "main": "./dist/mcp-core.umd.js",
+  "module": "./dist/mcp-core.es.js",
+  "types": "./mcp-core.d.ts",
+  "exports": {
+    ".": {
+      "types": "./mcp-core.d.ts",
+      "import": "./dist/mcp-core.es.js",
+      "require": "./dist/mcp-core.umd.js"
+    }
+  },
+  "scripts": {
+    "build": "rollup -c",
+    "build:docker": "rollup -c",
+    "version": "npm run build"
+  },
+  "dependencies": {
+    "@interopio/browser": "^4.0.0",
+    "@interopio/desktop": "^6.0.0",
+    "@interopio/intel-working-context": "^0.1.0-beta.0",
+    "@modelcontextprotocol/sdk": "^1.19.1"
+  },
+  "keywords": [
+    "ai",
+    "llm",
+    "agentic",
+    "copilot",
+    "assistant",
+    "io.Intelligence",
+    "io.connect",
+    "interop.io",
+    "io.connect browser",
+    "io.connect desktop",
+    "io.connect browser platform"
+  ],
+  "homepage": "https://interop.io/",
+  "author": {
+    "name": "Interop.IO",
+    "url": "https://interop.io/"
+  },
+  "publishConfig": {
+    "@interopio:registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "license": "MIT",
+  "gitHead": "c854d0327acdf587d4222a0c71f7a8869bbe4d22"
+}