@aotter/mantle-web 0.1.0-alpha.11 → 0.1.0-alpha.13

package/README.md

@@ -23,3 +23,26 @@ const html = await web.renderEntryLive.execute({
 
 Omit this package when an application only needs Mantle parsing, planning, or
 headless runtime operations.
+
+## WebMCP (opt in)
+
+Browsers implementing the draft imperative WebMCP API can expose public Views
+as read-only tools. Importing the subpath has no registration side effect;
+registration begins only when `bindWebMcp` is called.
+
+```ts
+import { projectCallableCapabilities } from "@aotter/mantle-runtime";
+import { bindWebMcp } from "@aotter/mantle-web/webmcp";
+
+const binding = await bindWebMcp(
+  projectCallableCapabilities(plan, { surface: "public" }),
+);
+
+// Unregister when the page/app scope ends.
+binding.dispose();
+```
+
+Unsupported browsers return `{ supported: false }`. Only public View
+capabilities are registered; staff Views and Procedure mutations are excluded.
+Calls use the same-origin `/api/views/<name>` route, forward browser
+cancellation, and declare both `readOnlyHint` and `untrustedContentHint`.

package/dist/webmcp.d.ts

@@ -0,0 +1,32 @@
+import type { RuntimeCallableCapability } from "@aotter/mantle-runtime";
+export interface WebMcpTool {
+    readonly name: string;
+    readonly title?: string;
+    readonly description: string;
+    readonly inputSchema: Record<string, unknown>;
+    readonly annotations: {
+        readonly readOnlyHint: true;
+        readonly untrustedContentHint: true;
+    };
+    execute(input: Record<string, unknown>, context: {
+        readonly signal?: AbortSignal;
+    }): Promise<unknown>;
+}
+export interface WebMcpModelContext {
+    registerTool(tool: WebMcpTool, options: {
+        readonly signal: AbortSignal;
+    }): void | Promise<void>;
+}
+export interface WebMcpBinding {
+    readonly supported: boolean;
+    readonly registered: readonly string[];
+    dispose(): void;
+}
+export interface BindWebMcpOptions {
+    readonly modelContext?: WebMcpModelContext;
+    readonly fetch?: typeof fetch;
+    readonly endpointPrefix?: string;
+}
+/** Opt-in browser binding for public, read-only View capabilities. */
+export declare function bindWebMcp(capabilities: readonly RuntimeCallableCapability[], options?: BindWebMcpOptions): Promise<WebMcpBinding>;
+//# sourceMappingURL=webmcp.d.ts.map

package/dist/webmcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webmcp.d.ts","sourceRoot":"","sources":["../src/webmcp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EAE1B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,QAAQ,CAAC,WAAW,EAAE;QACpB,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC;QAC5B,QAAQ,CAAC,oBAAoB,EAAE,IAAI,CAAC;KACrC,CAAC;IACF,OAAO,CACL,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACzC,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,CACV,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;KAAE,GACxC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,sEAAsE;AACtE,wBAAsB,UAAU,CAC9B,YAAY,EAAE,SAAS,yBAAyB,EAAE,EAClD,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,aAAa,CAAC,CAkCxB"}

package/dist/webmcp.js

@@ -0,0 +1,69 @@
+/** Opt-in browser binding for public, read-only View capabilities. */
+export async function bindWebMcp(capabilities, options = {}) {
+    const modelContext = options.modelContext ?? browserModelContext();
+    if (!modelContext)
+        return unsupportedBinding();
+    const controller = new AbortController();
+    const views = capabilities.filter((capability) => capability.kind === "view" && capability.surface === "public");
+    try {
+        await Promise.all(views.map((capability) => modelContext.registerTool({
+            name: capability.name,
+            ...(capability.title ? { title: capability.title } : {}),
+            description: capability.description,
+            inputSchema: capability.inputSchema,
+            annotations: { readOnlyHint: true, untrustedContentHint: true },
+            execute: (input, context) => queryView(capability, input, context.signal
+                ? AbortSignal.any([context.signal, controller.signal])
+                : controller.signal, options),
+        }, { signal: controller.signal })));
+    }
+    catch (error) {
+        controller.abort();
+        throw error;
+    }
+    return Object.freeze({
+        supported: true,
+        registered: Object.freeze(views.map((view) => view.name)),
+        dispose: () => controller.abort(),
+    });
+}
+function browserModelContext() {
+    const modelContext = globalThis
+        .document?.modelContext;
+    return modelContext && typeof modelContext.registerTool === "function"
+        ? modelContext
+        : undefined;
+}
+function unsupportedBinding() {
+    return Object.freeze({
+        supported: false,
+        registered: Object.freeze([]),
+        dispose: () => { },
+    });
+}
+async function queryView(capability, input, signal, options) {
+    if (!input || typeof input !== "object" || Array.isArray(input)) {
+        throw new TypeError("WebMCP View input must be an object.");
+    }
+    const query = Object.entries(input)
+        .filter((entry) => ["string", "number", "boolean"].includes(typeof entry[1]))
+        .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`)
+        .join("&");
+    const prefix = (options.endpointPrefix ?? "/api/views").replace(/\/$/u, "");
+    if (!/^\/(?!\/)[^\\?#]*$/u.test(prefix)) {
+        throw new TypeError("WebMCP endpointPrefix must be a same-origin absolute path.");
+    }
+    const response = await (options.fetch ?? fetch)(`${prefix}/${encodeURIComponent(capability.ownerName)}${query ? `?${query}` : ""}`, {
+        method: "GET",
+        credentials: "same-origin",
+        headers: { accept: "application/json" },
+        signal,
+    });
+    if (!response.ok)
+        throw new Error(`Mantle View '${capability.ownerName}' failed (${response.status}).`);
+    const body = await response.json();
+    return body && typeof body === "object" && body.ok === true
+        ? body.data
+        : body;
+}
+//# sourceMappingURL=webmcp.js.map

package/dist/webmcp.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aotter/mantle-web",
-  "version": "0.1.0-alpha.11",
+  "version": "0.1.0-alpha.13",
   "description": "Optional public document composition for Mantle: HTML, Markdown, llms.txt, sitemap, SEO, and preview.",
   "license": "Apache-2.0",
   "homepage": "https://mantle.tools/",
@@ -22,6 +22,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./webmcp": {
+      "types": "./dist/webmcp.d.ts",
+      "import": "./dist/webmcp.js"
     }
   },
   "files": [
@@ -29,8 +33,8 @@
     "README.md"
   ],
   "dependencies": {
-    "@aotter/mantle-runtime": "0.1.0-alpha.11",
-    "@aotter/mantle-spec": "0.1.0-alpha.11"
+    "@aotter/mantle-spec": "0.1.0-alpha.13",
+    "@aotter/mantle-runtime": "0.1.0-alpha.13"
   },
   "devDependencies": {
     "@types/node": "^26",