@webmcp-bridge/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 holon-run
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This module exposes the public exports of the core package.
+ * It depends on install/runtime/types modules to present the supported bridge API surface.
+ */
+export * from "./types.js";
+export * from "./runtime.js";
+export * from "./install.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+/**
+ * This module exposes the public exports of the core package.
+ * It depends on install/runtime/types modules to present the supported bridge API surface.
+ */
+export * from "./types.js";
+export * from "./runtime.js";
+export * from "./install.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}

package/dist/install.d.ts

@@ -0,0 +1,13 @@
+/**
+ * This module installs the modelContext shim on a target environment.
+ * It depends on runtime creation and exposes a stable install handle for callers.
+ */
+import type { BridgeHandle, BridgeInstallTarget, BridgeToolDefinition, BridgeTransport } from "./types.js";
+export type InstallBridgeOptions = {
+    preferNative?: boolean;
+    transport?: BridgeTransport;
+};
+export declare function isNativeModelContext(target: BridgeInstallTarget): boolean;
+export declare function installModelContextBridge(target: BridgeInstallTarget, options?: InstallBridgeOptions): BridgeHandle;
+export declare function defineLocalTool(name: string, execute: BridgeToolDefinition["execute"], description?: string): BridgeToolDefinition;
+//# sourceMappingURL=install.d.ts.map

package/dist/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EAGhB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CASzE;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,oBAAoB,GAC7B,YAAY,CAiDd;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,oBAAoB,CAAC,SAAS,CAAC,EACxC,WAAW,CAAC,EAAE,MAAM,GACnB,oBAAoB,CAStB"}

package/dist/install.js

@@ -0,0 +1,70 @@
+/**
+ * This module installs the modelContext shim on a target environment.
+ * It depends on runtime creation and exposes a stable install handle for callers.
+ */
+import { createBridgeRuntime } from "./runtime.js";
+export function isNativeModelContext(target) {
+    const modelContext = target.navigator.modelContext;
+    if (!modelContext) {
+        return false;
+    }
+    return (typeof modelContext.registerTool === "function" &&
+        typeof modelContext.unregisterTool === "function");
+}
+export function installModelContextBridge(target, options) {
+    const preferNative = options?.preferNative ?? true;
+    const native = target.navigator.modelContext;
+    if (preferNative && isNativeModelContext(target) && native) {
+        return {
+            mode: "native",
+            listTools: () => [],
+            invokeTool: async (name, input) => {
+                const nativeAny = native;
+                if (typeof nativeAny.callTool !== "function") {
+                    throw new Error("native modelContext callTool is not available");
+                }
+                return await nativeAny.callTool(name, input);
+            },
+            uninstall: () => {
+                // no-op for native mode
+            },
+        };
+    }
+    const runtime = createBridgeRuntime(options?.transport);
+    const previous = target.navigator.modelContext;
+    Object.defineProperty(target.navigator, "modelContext", {
+        configurable: true,
+        enumerable: false,
+        writable: false,
+        value: runtime.modelContext,
+    });
+    return {
+        mode: "shim",
+        listTools: () => runtime.listTools(),
+        invokeTool: (name, input) => runtime.invokeTool(name, input),
+        uninstall: () => {
+            runtime.clear();
+            if (previous) {
+                Object.defineProperty(target.navigator, "modelContext", {
+                    configurable: true,
+                    enumerable: false,
+                    writable: false,
+                    value: previous,
+                });
+                return;
+            }
+            delete target.navigator.modelContext;
+        },
+    };
+}
+export function defineLocalTool(name, execute, description) {
+    const tool = {
+        name,
+        execute,
+    };
+    if (description !== undefined) {
+        tool.description = description;
+    }
+    return tool;
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAenD,MAAM,UAAU,oBAAoB,CAAC,MAA2B;IAC9D,MAAM,YAAY,GAAG,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC;IACnD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,CACL,OAAO,YAAY,CAAC,YAAY,KAAK,UAAU;QAC/C,OAAO,YAAY,CAAC,cAAc,KAAK,UAAU,CAClD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,MAA2B,EAC3B,OAA8B;IAE9B,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,IAAI,CAAC;IACnD,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC;IAE7C,IAAI,YAAY,IAAI,oBAAoB,CAAC,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QAC3D,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,GAAG,EAAE,CAAC,EAAE;YACnB,UAAU,EAAE,KAAK,EAAE,IAAY,EAAE,KAAgB,EAAE,EAAE;gBACnD,MAAM,SAAS,GAAG,MAAgG,CAAC;gBACnH,IAAI,OAAO,SAAS,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;oBAC7C,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;gBACnE,CAAC;gBACD,OAAO,MAAM,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC/C,CAAC;YACD,SAAS,EAAE,GAAG,EAAE;gBACd,wBAAwB;YAC1B,CAAC;SACF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,mBAAmB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC;IAE/C,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,EAAE;QACtD,YAAY,EAAE,IAAI;QAClB,UAAU,EAAE,KAAK;QACjB,QAAQ,EAAE,KAAK;QACf,KAAK,EAAE,OAAO,CAAC,YAAY;KAC5B,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE;QACpC,UAAU,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC;QAC5D,SAAS,EAAE,GAAG,EAAE;YACd,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,EAAE;oBACtD,YAAY,EAAE,IAAI;oBAClB,UAAU,EAAE,KAAK;oBACjB,QAAQ,EAAE,KAAK;oBACf,KAAK,EAAE,QAA4B;iBACpC,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YACD,OAAO,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC;QACvC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,OAAwC,EACxC,WAAoB;IAEpB,MAAM,IAAI,GAAyB;QACjC,IAAI;QACJ,OAAO;KACR,CAAC;IACF,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,13 @@
+/**
+ * This module builds the in-memory modelContext shim runtime.
+ * It depends on shared type contracts and is used by install logic to expose tool registration and invocation behavior.
+ */
+import type { BridgeToolDefinition, BridgeTransport, JsonValue, ModelContextLike } from "./types.js";
+export type BridgeRuntime = {
+    modelContext: ModelContextLike;
+    listTools: () => ReadonlyArray<BridgeToolDefinition>;
+    invokeTool: (name: string, input: JsonValue) => Promise<JsonValue>;
+    clear: () => void;
+};
+export declare function createBridgeRuntime(transport?: BridgeTransport): BridgeRuntime;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EACf,SAAS,EACT,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,aAAa,GAAG;IAC1B,YAAY,EAAE,gBAAgB,CAAC;IAC/B,SAAS,EAAE,MAAM,aAAa,CAAC,oBAAoB,CAAC,CAAC;IACrD,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACnE,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,eAAe,GAAG,aAAa,CA8C9E"}

package/dist/runtime.js

@@ -0,0 +1,49 @@
+/**
+ * This module builds the in-memory modelContext shim runtime.
+ * It depends on shared type contracts and is used by install logic to expose tool registration and invocation behavior.
+ */
+export function createBridgeRuntime(transport) {
+    const contexts = [];
+    const tools = new Map();
+    const invokeTool = async (name, input) => {
+        const localTool = tools.get(name);
+        if (localTool) {
+            return await localTool.execute(input);
+        }
+        if (transport) {
+            return await transport.call(name, input);
+        }
+        throw new Error(`tool not found: ${name}`);
+    };
+    const modelContext = {
+        provideContext: async (context) => {
+            contexts.push(context);
+        },
+        clearContext: async () => {
+            contexts.splice(0, contexts.length);
+            tools.clear();
+        },
+        registerTool: async (tool) => {
+            if (!tool.name.trim()) {
+                throw new Error("tool.name is required");
+            }
+            if (tools.has(tool.name)) {
+                throw new Error(`tool already registered: ${tool.name}`);
+            }
+            tools.set(tool.name, tool);
+        },
+        unregisterTool: async (name) => {
+            tools.delete(name);
+        },
+    };
+    return {
+        modelContext,
+        listTools: () => Array.from(tools.values()),
+        invokeTool,
+        clear: () => {
+            contexts.splice(0, contexts.length);
+            tools.clear();
+        },
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,MAAM,UAAU,mBAAmB,CAAC,SAA2B;IAC7D,MAAM,QAAQ,GAAgB,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAgC,CAAC;IAEtD,MAAM,UAAU,GAAG,KAAK,EAAE,IAAY,EAAE,KAAgB,EAAsB,EAAE;QAC9E,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,MAAM,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC3C,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC,CAAC;IAEF,MAAM,YAAY,GAAqB;QACrC,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAChC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;QACD,YAAY,EAAE,KAAK,IAAI,EAAE;YACvB,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;YACpC,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;QACD,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC3B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YAC3C,CAAC;YACD,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAC3D,CAAC;YACD,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,cAAc,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC7B,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;KACF,CAAC;IAEF,OAAO;QACL,YAAY;QACZ,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAC3C,UAAU;QACV,KAAK,EAAE,GAAG,EAAE;YACV,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;YACpC,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,36 @@
+/**
+ * This module defines the shared WebMCP bridge contracts.
+ * It is depended on by runtime/install modules and downstream integrations like playwright and adapters.
+ */
+export type JsonValue = string | number | boolean | null | {
+    [key: string]: JsonValue;
+} | JsonValue[];
+export type BridgeToolDefinition = {
+    name: string;
+    description?: string;
+    inputSchema?: JsonValue;
+    execute: (input: JsonValue) => Promise<JsonValue>;
+};
+export type BridgeTransport = {
+    call: (name: string, input: JsonValue) => Promise<JsonValue>;
+};
+export type ModelContextLike = {
+    provideContext: (context: JsonValue) => Promise<void>;
+    clearContext: () => Promise<void>;
+    registerTool: (tool: BridgeToolDefinition) => Promise<void>;
+    unregisterTool: (name: string) => Promise<void>;
+};
+export type BridgeInstallTarget = {
+    navigator: {
+        modelContext?: ModelContextLike;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+};
+export type BridgeHandle = {
+    mode: "native" | "shim";
+    listTools: () => ReadonlyArray<BridgeToolDefinition>;
+    invokeTool: (name: string, input: JsonValue) => Promise<JsonValue>;
+    uninstall: () => void;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAC5B,SAAS,EAAE,CAAC;AAEhB,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;CACnD,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;CAC9D,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,cAAc,EAAE,CAAC,OAAO,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,YAAY,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE;QACT,YAAY,CAAC,EAAE,gBAAgB,CAAC;QAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,aAAa,CAAC,oBAAoB,CAAC,CAAC;IACrD,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACnE,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC"}

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * This module defines the shared WebMCP bridge contracts.
+ * It is depended on by runtime/install modules and downstream integrations like playwright and adapters.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@webmcp-bridge/core",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  }
+}