@widgentic/webmcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Diego Hoyos
+
+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/README.md

@@ -0,0 +1,104 @@
+# @widgentic/webmcp
+
+> **Beta.** The API may change in minor versions before 1.0. Built against the
+> WebMCP specification's `document.modelContext` shape; see "Browsers" below
+> for what has been exercised where.
+
+Expose the mounted widgentic designers as [WebMCP](https://github.com/webmachinelearning/webmcp)
+tools, so a browser-side agent — ChatGPT Desktop's browser, Chrome or Edge in
+the WebMCP origin trial — can read and edit the drafts the person is looking
+at. **Agents edit, people save**: no tool here persists anything; the host's
+save controls stay the only write path. Browser-safe, no network I/O, depends
+only on `@widgentic/core` and `@widgentic/designer`.
+
+```sh
+npm install @widgentic/webmcp
+```
+
+One call after mounting. Sources are **getters**, resolved on every tool call,
+because hosts remount designers when the person switches tabs:
+
+```ts
+import { exposeDesigners } from "@widgentic/webmcp";
+
+const agentTools = await exposeDesigners({
+  widget: () => widgetDesigner,          // a DesignerHandle, or undefined while unmounted
+  theme: () => { showTab("theme"); return themeDesigner; },  // a getter may mount first
+  schema: () => schemaDesigner,
+  action: () => actionDesigner
+});
+
+status.textContent = agentTools.supported
+  ? `agent tools: ${agentTools.registered.length} registered`
+  : "no agent-capable browser";
+
+// Later, e.g. on sign-out: every tool disappears together.
+agentTools.dispose();
+```
+
+In a browser without a model context the call resolves with
+`supported: false`, registers nothing and throws nothing — the page is
+unchanged.
+
+## The tools
+
+Names are `<prefix>_<suffix>`; the prefix defaults to `widgentic` (`{ prefix }`
+in the options). Only designers you supply a source for get tools; the token
+reference is always present.
+
+| Tool | Read-only | Does |
+|---|---|---|
+| `widget_draft_get` | yes | The open widget definition in export shape `{ kind, template, descriptor, load? }` plus the designer's diagnostics |
+| `widget_draft_load` | | Replace the draft with a definition, through the designer's validation |
+| `widget_example_data_set` | | Replace `descriptor.dataExample` — what the preview renders; the example-vs-schema verdict comes back in the diagnostics |
+| `widget_theme_set` | | Set the preview theme tokens of the draft |
+| `theme_get` / `theme_load` | get | The theme entry `{ name, label?, description?, tokens }` |
+| `theme_tokens_set` | | Merge tokens into the open entry (`{ tokens, remove? }`), validated as a whole |
+| `schema_get` / `schema_load` | get | The shared data-schema entry `{ name, label?, description?, schema }` |
+| `action_get` / `action_load` | get | The action entry `{ name, label?, description?, definition }` |
+| `theme_token_specs` | yes | Every `--wg-*` token with type, default, purpose and fallback, from the exported specs |
+
+Every tool resolves to MCP-shaped text content carrying one JSON document with
+a boolean `ok`:
+
+```json
+{ "content": [{ "type": "text", "text": "{\"ok\":false,\"code\":\"REJECTED\",\"errors\":[\"template: … \"]}" }] }
+```
+
+Refusals are results, never rejections: `NOT_MOUNTED` (the source returned
+nothing), `INVALID_INPUT` (with the `argument`), `REJECTED` (with the
+designer's own `errors`). Read tools carry `annotations.readOnlyHint`, so
+agents run them without a confirmation step.
+
+Diagnostics come from the designer itself: the package subscribes to each
+handle it sees and returns what the designer computed for the change a tool
+made. Before the first change there is nothing to return, so `widget_draft_get`
+derives them without the host's shared entries and says so with
+`diagnosticsDerived: true`.
+
+## Your own tools
+
+`registerTools(tools, { modelContext?, signal? })` registers any descriptors in
+the same shape under one abort signal; `exposeDesigners` accepts extra ones as
+`{ tools }` and reports them in the same result. Build results with
+`okResult()` / `failResult()` so hosts and agents see one vocabulary.
+`designerTools(sources, { prefix })` returns the descriptors without
+registering — inspect them, or hand them to your own registration.
+
+## Browsers
+
+- **Native**: the package resolves `document.modelContext` (the specification;
+  ChatGPT Desktop's browser) and falls back to `navigator.modelContext` (Chrome
+  origin trial). An explicit `{ modelContext }` option wins over both.
+- **Chrome 149+ / Edge 150 without a token**: enable
+  `chrome://flags/#enable-webmcp-testing`, or launch with
+  `--enable-features=WebMCPTesting,DevToolsWebMCPSupport` and drive the tools
+  from `navigator.modelContextTesting.getTools()` / `executeTool()`.
+- **Polyfills**: nothing is bundled — a polyfill supplies the API, not the
+  agent, and cannot make Firefox or Safari agent-capable. If you want
+  extension-based agents (for example `@mcp-b/webmcp-polyfill`, which installs
+  `document.modelContext` and defers to a native one), load it **before** the
+  `exposeDesigners` call; the resolver finds whatever the page has.
+
+Tools must be registered on the top-level page; browsers do not read tools from
+iframes.

package/dist/entry-tools.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Theme, schema and action designer tools: each mirrors its handle — read the
+ * entry, load an entry through the designer's validation — plus a token merge
+ * for the theme designer.
+ */
+import type { ActionDesignerHandle, SchemaDesignerHandle, ThemeDesignerHandle } from "@widgentic/designer";
+import type { NameOf } from "./tool.js";
+import type { WebMcpTool } from "./types.js";
+export declare function themeTools(source: () => ThemeDesignerHandle | undefined, name: NameOf): WebMcpTool[];
+export declare function schemaTools(source: () => SchemaDesignerHandle | undefined, name: NameOf): WebMcpTool[];
+export declare function actionTools(source: () => ActionDesignerHandle | undefined, name: NameOf): WebMcpTool[];
+//# sourceMappingURL=entry-tools.d.ts.map

package/dist/entry-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-tools.d.ts","sourceRoot":"","sources":["../src/entry-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK7C,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,mBAAmB,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CAgEpG;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,oBAAoB,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CAkCtG;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,oBAAoB,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CAkCtG"}

package/dist/entry-tools.js

@@ -0,0 +1,149 @@
+import { isPlainObject } from "@widgentic/core";
+import { argumentsOf, invalidArgument, notMounted, okResult, rejected } from "./result.js";
+import { defineTool, objectSchema, PERSON_SAVES } from "./tool.js";
+const ENTRY_SCHEMA = (what) => objectSchema({ entry: { type: "object", description: `The ${what} entry.` } }, ["entry"]);
+export function themeTools(source, name) {
+    return [
+        defineTool({
+            name: name("theme_get"),
+            title: "Read the theme entry",
+            readOnly: true,
+            description: "Read the theme entry open in the theme designer: { entry: { name, label?, description?, extends?, tokens } } — tokens is a map of --wg-* token names (and x-<name> author variables) to CSS values.",
+            inputSchema: objectSchema({}),
+            execute() {
+                const handle = source();
+                if (handle === undefined)
+                    return notMounted("theme");
+                return okResult({ entry: handle.getTheme() });
+            }
+        }),
+        defineTool({
+            name: name("theme_load"),
+            title: "Load a theme entry",
+            description: "Replace the entry in the theme designer: { entry: { name, label?, description?, tokens } }. name: lowercase letters, digits, '.', '_' or '-'; light and dark are reserved. " +
+                "Validated by the theming rules (list tokens with theme_token_specs); refused → { ok: false, code: 'REJECTED', errors }. " +
+                PERSON_SAVES,
+            inputSchema: ENTRY_SCHEMA("theme"),
+            execute(input) {
+                const handle = source();
+                if (handle === undefined)
+                    return notMounted("theme");
+                const { entry } = argumentsOf(input);
+                if (!isPlainObject(entry))
+                    return invalidArgument("entry", "object");
+                const result = handle.loadTheme(entry);
+                if (!result.ok)
+                    return rejected(result.errors);
+                return okResult({ entry: handle.getTheme() });
+            }
+        }),
+        defineTool({
+            name: name("theme_tokens_set"),
+            title: "Merge theme tokens",
+            description: "Change some tokens of the theme entry open in the theme designer without retyping the rest: { tokens: { <token>: <css value> }, remove?: [<token>] }. " +
+                "The result is validated as a whole; an invalid value leaves the entry unchanged and returns { ok: false, code: 'REJECTED', errors }. " +
+                PERSON_SAVES,
+            inputSchema: objectSchema({
+                tokens: { type: "object", description: "Token name → CSS value to set.", additionalProperties: { type: "string" } },
+                remove: { type: "array", items: { type: "string" }, description: "Token names to drop." }
+            }),
+            execute(input) {
+                const handle = source();
+                if (handle === undefined)
+                    return notMounted("theme");
+                const args = argumentsOf(input);
+                const tokens = args.tokens === undefined ? {} : args.tokens;
+                if (!isPlainObject(tokens))
+                    return invalidArgument("tokens", "object of token → value");
+                const remove = args.remove === undefined ? [] : args.remove;
+                if (!Array.isArray(remove) || !remove.every((item) => typeof item === "string")) {
+                    return invalidArgument("remove", "array of token names");
+                }
+                const current = handle.getTheme();
+                const merged = { ...current.tokens, ...tokens };
+                for (const token of remove)
+                    delete merged[token];
+                const next = { ...current, tokens: merged };
+                const result = handle.loadTheme(next);
+                if (!result.ok)
+                    return rejected(result.errors);
+                return okResult({ entry: handle.getTheme() });
+            }
+        })
+    ];
+}
+export function schemaTools(source, name) {
+    return [
+        defineTool({
+            name: name("schema_get"),
+            title: "Read the schema entry",
+            readOnly: true,
+            description: "Read the shared data-schema entry open in the schema designer: { entry: { name, label?, description?, schema } } — schema is a JSON Schema object widgets reference by name (dataSchemaRef).",
+            inputSchema: objectSchema({}),
+            execute() {
+                const handle = source();
+                if (handle === undefined)
+                    return notMounted("schema");
+                return okResult({ entry: handle.getSchema() });
+            }
+        }),
+        defineTool({
+            name: name("schema_load"),
+            title: "Load a schema entry",
+            description: "Replace the entry in the schema designer: { entry: { name, label?, description?, schema } }. name: letters, digits, '.', '_' or '-'; schema: a JSON Schema object. " +
+                "Refused → { ok: false, code: 'REJECTED', errors }. " +
+                PERSON_SAVES,
+            inputSchema: ENTRY_SCHEMA("schema"),
+            execute(input) {
+                const handle = source();
+                if (handle === undefined)
+                    return notMounted("schema");
+                const { entry } = argumentsOf(input);
+                if (!isPlainObject(entry))
+                    return invalidArgument("entry", "object");
+                const result = handle.loadSchema(entry);
+                if (!result.ok)
+                    return rejected(result.errors);
+                return okResult({ entry: handle.getSchema() });
+            }
+        })
+    ];
+}
+export function actionTools(source, name) {
+    return [
+        defineTool({
+            name: name("action_get"),
+            title: "Read the action entry",
+            readOnly: true,
+            description: "Read the action entry open in the action designer: { entry: { name, label?, description?, definition } } — definition is a prompt action ({ kind: 'prompt', text }) or an http action ({ kind: 'http', … }).",
+            inputSchema: objectSchema({}),
+            execute() {
+                const handle = source();
+                if (handle === undefined)
+                    return notMounted("action");
+                return okResult({ entry: handle.getAction() });
+            }
+        }),
+        defineTool({
+            name: name("action_load"),
+            title: "Load an action entry",
+            description: "Replace the entry in the action designer: { entry: { name, label?, description?, definition } }. name: lowercase letters, digits and dashes, starting with a letter. " +
+                "Refused → { ok: false, code: 'REJECTED', errors }. Secrets are referenced by name only and never pass through this tool. " +
+                PERSON_SAVES,
+            inputSchema: ENTRY_SCHEMA("action"),
+            execute(input) {
+                const handle = source();
+                if (handle === undefined)
+                    return notMounted("action");
+                const { entry } = argumentsOf(input);
+                if (!isPlainObject(entry))
+                    return invalidArgument("entry", "object");
+                const result = handle.loadAction(entry);
+                if (!result.ok)
+                    return rejected(result.errors);
+                return okResult({ entry: handle.getAction() });
+            }
+        })
+    ];
+}
+//# sourceMappingURL=entry-tools.js.map

package/dist/entry-tools.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @widgentic/webmcp (beta) — the mounted widgentic designers as WebMCP tools.
+ * `exposeDesigners(sources)` builds tool descriptors over the designer
+ * handles a host supplies (as getters, resolved per call) and registers them
+ * on the page's model context; in a browser without one it is a reported
+ * no-op. Agents read and edit the working copies; the person saves — no tool
+ * here persists anything. Browser-safe, no network I/O.
+ */
+export { designerTools, DEFAULT_PREFIX } from "./tools.js";
+export { exposeDesigners, registerTools, resolveModelContext } from "./register.js";
+export { okResult, failResult } from "./result.js";
+export type { FailureCode } from "./result.js";
+export type { DesignerSources, ExposeOptions, ExposeResult, ModelContextLike, RegisterFailure, RegisterOptions, RegisterResult, ToolsOptions, WebMcpExecuteOptions, WebMcpTextContent, WebMcpTool, WebMcpToolAnnotations, WebMcpToolResult } from "./types.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;;;;;;;GAOG;AACH,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EACV,eAAe,EACf,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,UAAU,EACV,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * @widgentic/webmcp (beta) — the mounted widgentic designers as WebMCP tools.
+ * `exposeDesigners(sources)` builds tool descriptors over the designer
+ * handles a host supplies (as getters, resolved per call) and registers them
+ * on the page's model context; in a browser without one it is a reported
+ * no-op. Agents read and edit the working copies; the person saves — no tool
+ * here persists anything. Browser-safe, no network I/O.
+ */
+export { designerTools, DEFAULT_PREFIX } from "./tools.js";
+export { exposeDesigners, registerTools, resolveModelContext } from "./register.js";
+export { okResult, failResult } from "./result.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;;;;;;;GAOG;AACH,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/reference-tools.d.ts

@@ -0,0 +1,4 @@
+import type { NameOf } from "./tool.js";
+import type { WebMcpTool } from "./types.js";
+export declare function themeTokenSpecsTool(name: NameOf): WebMcpTool;
+//# sourceMappingURL=reference-tools.d.ts.map

package/dist/reference-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-tools.d.ts","sourceRoot":"","sources":["../src/reference-tools.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAmB5D"}

package/dist/reference-tools.js

@@ -0,0 +1,24 @@
+/** Tools that need no designer: reference data derived from the exported specs at call time. */
+import { TOKEN_SPECS } from "@widgentic/core";
+import { okResult } from "./result.js";
+import { defineTool, objectSchema } from "./tool.js";
+export function themeTokenSpecsTool(name) {
+    return defineTool({
+        name: name("theme_token_specs"),
+        title: "List the theme tokens",
+        readOnly: true,
+        description: "List every --wg-* theme token with its value type, default, purpose and fallback token — the vocabulary for theme entries and preview themes. Author-defined variables are x-<name>.",
+        inputSchema: objectSchema({}),
+        execute() {
+            const tokens = Object.entries(TOKEN_SPECS).map(([token, spec]) => ({
+                name: token,
+                type: spec.type,
+                default: spec.default,
+                use: spec.use,
+                ...("fallback" in spec && spec.fallback !== undefined ? { fallback: spec.fallback } : {})
+            }));
+            return okResult({ tokens });
+        }
+    });
+}
+//# sourceMappingURL=reference-tools.js.map

package/dist/reference-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-tools.js","sourceRoot":"","sources":["../src/reference-tools.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAIrD,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,IAAI,CAAC,mBAAmB,CAAC;QAC/B,KAAK,EAAE,uBAAuB;QAC9B,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,sLAAsL;QACxL,WAAW,EAAE,YAAY,CAAC,EAAE,CAAC;QAC7B,OAAO;YACL,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;gBACjE,IAAI,EAAE,KAAK;gBACX,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,GAAG,CAAC,UAAU,IAAI,IAAI,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC1F,CAAC,CAAC,CAAC;YACJ,OAAO,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9B,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/register.d.ts

@@ -0,0 +1,7 @@
+import type { DesignerSources, ExposeOptions, ExposeResult, ModelContextLike, RegisterOptions, RegisterResult, WebMcpTool } from "./types.js";
+/** The page's model context: the document's (spec, ChatGPT) before the navigator's (Chrome origin trial). */
+export declare function resolveModelContext(): ModelContextLike | undefined;
+export declare function registerTools(tools: readonly WebMcpTool[], options?: RegisterOptions): Promise<RegisterResult>;
+/** The one call a host makes after mounting: build the designer tools and register them. */
+export declare function exposeDesigners(sources: DesignerSources, options?: ExposeOptions): Promise<ExposeResult>;
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,YAAY,EACZ,gBAAgB,EAEhB,eAAe,EACf,cAAc,EACd,UAAU,EACX,MAAM,YAAY,CAAC;AAUpB,6GAA6G;AAC7G,wBAAgB,mBAAmB,IAAI,gBAAgB,GAAG,SAAS,CAUlE;AAQD,wBAAsB,aAAa,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAwCxH;AAED,4FAA4F;AAC5F,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAUlH"}

package/dist/register.js

@@ -0,0 +1,84 @@
+/**
+ * Registration on the page's model context. Feature-detected (the spec's
+ * `document.modelContext`, then Chrome's `navigator.modelContext`), reported
+ * rather than thrown, disposable as one unit through a single abort signal.
+ */
+import { designerTools } from "./tools.js";
+function isModelContext(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        typeof value.registerTool === "function");
+}
+/** The page's model context: the document's (spec, ChatGPT) before the navigator's (Chrome origin trial). */
+export function resolveModelContext() {
+    const scope = globalThis;
+    const fromDocument = scope.document?.modelContext;
+    if (isModelContext(fromDocument))
+        return fromDocument;
+    const fromNavigator = scope.navigator?.modelContext;
+    if (isModelContext(fromNavigator))
+        return fromNavigator;
+    return undefined;
+}
+function messageOf(reason) {
+    return reason instanceof Error ? reason.message : String(reason);
+}
+const UNSUPPORTED = { supported: false, registered: [], failed: [], dispose() { } };
+export async function registerTools(tools, options = {}) {
+    const context = options.modelContext ?? resolveModelContext();
+    if (context === undefined)
+        return UNSUPPORTED;
+    const controller = new AbortController();
+    const registered = [];
+    const failed = [];
+    let disposed = false;
+    const dispose = () => {
+        if (disposed)
+            return;
+        disposed = true;
+        controller.abort();
+        if (typeof context.unregisterTool !== "function")
+            return;
+        for (const name of registered) {
+            try {
+                context.unregisterTool(name);
+            }
+            catch {
+                // Already gone (the abort did it) — nothing to report.
+            }
+        }
+    };
+    if (options.signal !== undefined) {
+        if (options.signal.aborted)
+            dispose();
+        else
+            options.signal.addEventListener("abort", dispose, { once: true });
+    }
+    // One rejection (a duplicate name, a permissions-policy refusal) must not
+    // take the others down: settle them all, report by name.
+    const outcomes = await Promise.allSettled(tools.map(async (tool) => {
+        await context.registerTool(tool, { signal: controller.signal });
+        return tool.name;
+    }));
+    outcomes.forEach((outcome, index) => {
+        const name = tools[index]?.name ?? "";
+        if (outcome.status === "fulfilled")
+            registered.push(name);
+        else
+            failed.push({ name, message: messageOf(outcome.reason) });
+    });
+    return { supported: true, registered, failed, dispose };
+}
+/** The one call a host makes after mounting: build the designer tools and register them. */
+export async function exposeDesigners(sources, options = {}) {
+    const tools = [
+        ...designerTools(sources, options.prefix === undefined ? {} : { prefix: options.prefix }),
+        ...(options.tools ?? [])
+    ];
+    const result = await registerTools(tools, {
+        ...(options.modelContext === undefined ? {} : { modelContext: options.modelContext }),
+        ...(options.signal === undefined ? {} : { signal: options.signal })
+    });
+    return { ...result, tools };
+}
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

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

package/dist/result.d.ts

@@ -0,0 +1,10 @@
+import type { WebMcpToolResult } from "./types.js";
+export type FailureCode = "NOT_MOUNTED" | "INVALID_INPUT" | "REJECTED";
+export declare function okResult(payload?: Record<string, unknown>): WebMcpToolResult;
+export declare function failResult(code: FailureCode, detail?: Record<string, unknown>): WebMcpToolResult;
+/** The arguments object, or an empty one when the agent sent nothing usable. */
+export declare function argumentsOf(input: unknown): Record<string, unknown>;
+export declare function invalidArgument(argument: string, expected: string): WebMcpToolResult;
+export declare function notMounted(designer: "widget" | "theme" | "schema" | "action"): WebMcpToolResult;
+export declare function rejected(errors: readonly string[]): WebMcpToolResult;
+//# sourceMappingURL=result.d.ts.map

package/dist/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,eAAe,GAAG,UAAU,CAAC;AAMvE,wBAAgB,QAAQ,CAAC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,gBAAgB,CAEhF;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,gBAAgB,CAEpG;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEnE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAEpF;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,gBAAgB,CAK/F;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,gBAAgB,CAEpE"}

package/dist/result.js

@@ -0,0 +1,32 @@
+/**
+ * Tool results: one JSON document inside MCP text content, always with a
+ * boolean `ok`. Refusals are results, never rejections — a thrown error reaches
+ * the agent as an opaque failure, a result is something it can act on.
+ */
+import { isPlainObject } from "@widgentic/core";
+function textResult(payload) {
+    return { content: [{ type: "text", text: JSON.stringify(payload) }] };
+}
+export function okResult(payload = {}) {
+    return textResult({ ok: true, ...payload });
+}
+export function failResult(code, detail = {}) {
+    return textResult({ ok: false, code, ...detail });
+}
+/** The arguments object, or an empty one when the agent sent nothing usable. */
+export function argumentsOf(input) {
+    return isPlainObject(input) ? input : {};
+}
+export function invalidArgument(argument, expected) {
+    return failResult("INVALID_INPUT", { argument, expected });
+}
+export function notMounted(designer) {
+    return failResult("NOT_MOUNTED", {
+        designer,
+        message: `The ${designer} designer is not mounted on this page right now.`
+    });
+}
+export function rejected(errors) {
+    return failResult("REJECTED", { errors: [...errors] });
+}
+//# sourceMappingURL=result.js.map

package/dist/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAKhD,SAAS,UAAU,CAAC,OAAgC;IAClD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAO,GAA4B,EAAE;IAC5D,OAAO,UAAU,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAiB,EAAE,MAAM,GAA4B,EAAE;IAChF,OAAO,UAAU,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,QAAgB;IAChE,OAAO,UAAU,CAAC,eAAe,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAkD;IAC3E,OAAO,UAAU,CAAC,aAAa,EAAE;QAC/B,QAAQ;QACR,OAAO,EAAE,OAAO,QAAQ,kDAAkD;KAC3E,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAyB;IAChD,OAAO,UAAU,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;AACzD,CAAC"}

package/dist/tool.d.ts

@@ -0,0 +1,17 @@
+/** Descriptor construction shared by every tool module. */
+import type { WebMcpTool, WebMcpToolResult } from "./types.js";
+export type NameOf = (suffix: string) => string;
+/** A closed object schema: every accepted argument named, nothing else allowed. */
+export declare function objectSchema(properties: Record<string, unknown>, required?: readonly string[]): Record<string, unknown>;
+export interface ToolSpec {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    readOnly?: boolean;
+    execute(input: unknown): WebMcpToolResult | Promise<WebMcpToolResult>;
+}
+export declare function defineTool(spec: ToolSpec): WebMcpTool;
+/** The sentence every editing tool ends with — the boundary agents must hear every time. */
+export declare const PERSON_SAVES = "Nothing is saved by this tool: the person reviews the result in the designer and saves.";
+//# sourceMappingURL=tool.d.ts.map

package/dist/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;AAEhD,mFAAmF;AACnF,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,QAAQ,GAAE,SAAS,MAAM,EAAO,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACvE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CASrD;AAED,4FAA4F;AAC5F,eAAO,MAAM,YAAY,4FAA4F,CAAC"}

package/dist/tool.js

@@ -0,0 +1,22 @@
+/** A closed object schema: every accepted argument named, nothing else allowed. */
+export function objectSchema(properties, required = []) {
+    return {
+        type: "object",
+        properties,
+        ...(required.length > 0 ? { required: [...required] } : {}),
+        additionalProperties: false
+    };
+}
+export function defineTool(spec) {
+    return {
+        name: spec.name,
+        title: spec.title,
+        description: spec.description,
+        inputSchema: spec.inputSchema,
+        ...(spec.readOnly === true ? { annotations: { readOnlyHint: true } } : {}),
+        execute: async (input) => spec.execute(input)
+    };
+}
+/** The sentence every editing tool ends with — the boundary agents must hear every time. */
+export const PERSON_SAVES = "Nothing is saved by this tool: the person reviews the result in the designer and saves.";
+//# sourceMappingURL=tool.js.map

package/dist/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAKA,mFAAmF;AACnF,MAAM,UAAU,YAAY,CAC1B,UAAmC,EACnC,QAAQ,GAAsB,EAAE;IAEhC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU;QACV,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,oBAAoB,EAAE,KAAK;KAC5B,CAAC;AACJ,CAAC;AAWD,MAAM,UAAU,UAAU,CAAC,IAAc;IACvC,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED,4FAA4F;AAC5F,MAAM,CAAC,MAAM,YAAY,GAAG,yFAAyF,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,4 @@
+import type { DesignerSources, ToolsOptions, WebMcpTool } from "./types.js";
+export declare const DEFAULT_PREFIX = "widgentic";
+export declare function designerTools(sources: DesignerSources, options?: ToolsOptions): WebMcpTool[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG5E,eAAO,MAAM,cAAc,cAAc,CAAC;AAI1C,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,GAAE,YAAiB,GAAG,UAAU,EAAE,CAahG"}

package/dist/tools.js

@@ -0,0 +1,30 @@
+/**
+ * The descriptor factory: pure, no browser API — hosts and tests inspect the
+ * tools before anything is registered. Only designers with a source get tools;
+ * the token reference tool is always present.
+ */
+import { actionTools, schemaTools, themeTools } from "./entry-tools.js";
+import { themeTokenSpecsTool } from "./reference-tools.js";
+import { widgetTools } from "./widget-tools.js";
+export const DEFAULT_PREFIX = "widgentic";
+/** Prefixes are identifiers: a host namespaces its tools, it does not encode data in them. */
+const PREFIX = /^[a-z][a-z0-9_]{0,31}$/;
+export function designerTools(sources, options = {}) {
+    const prefix = options.prefix ?? DEFAULT_PREFIX;
+    if (!PREFIX.test(prefix)) {
+        throw new TypeError(`Tool prefix '${prefix}' must be lowercase letters, digits and underscores, starting with a letter (max 32).`);
+    }
+    const name = (suffix) => `${prefix}_${suffix}`;
+    const tools = [];
+    if (sources.widget !== undefined)
+        tools.push(...widgetTools(sources.widget, name));
+    if (sources.theme !== undefined)
+        tools.push(...themeTools(sources.theme, name));
+    if (sources.schema !== undefined)
+        tools.push(...schemaTools(sources.schema, name));
+    if (sources.action !== undefined)
+        tools.push(...actionTools(sources.action, name));
+    tools.push(themeTokenSpecsTool(name));
+    return tools;
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAG3D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAC;AAC1C,8FAA8F;AAC9F,MAAM,MAAM,GAAG,wBAAwB,CAAC;AAExC,MAAM,UAAU,aAAa,CAAC,OAAwB,EAAE,OAAO,GAAiB,EAAE;IAChF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,SAAS,CAAC,gBAAgB,MAAM,uFAAuF,CAAC,CAAC;IACrI,CAAC;IACD,MAAM,IAAI,GAAW,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;IACvD,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IACnF,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;IAChF,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IACnF,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IACnF,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;IACtC,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,88 @@
+/**
+ * The shapes this package shares with hosts: the WebMCP tool descriptor (a
+ * duck-typed subset of the spec's `ModelContextTool`, so no vendor typings are
+ * required), the model-context surface it registers on, and the designer
+ * sources a host hands over.
+ */
+import type { ActionDesignerHandle, DesignerHandle, SchemaDesignerHandle, ThemeDesignerHandle } from "@widgentic/designer";
+export interface WebMcpToolAnnotations {
+    /** The tool changes nothing — agents may run it without a confirmation step. */
+    readOnlyHint?: boolean;
+    untrustedContentHint?: boolean;
+}
+export interface WebMcpTextContent {
+    type: "text";
+    text: string;
+}
+/** Every widgentic tool resolves to MCP-shaped text content carrying a JSON document. */
+export interface WebMcpToolResult {
+    content: WebMcpTextContent[];
+}
+export interface WebMcpExecuteOptions {
+    signal?: AbortSignal;
+}
+export interface WebMcpTool {
+    name: string;
+    /** Short human label — browsers list it in their "site tools" UI. */
+    title?: string;
+    description: string;
+    /** JSON Schema for the arguments; every widgentic tool's is a closed object schema. */
+    inputSchema: Record<string, unknown>;
+    annotations?: WebMcpToolAnnotations;
+    execute(input: unknown, options?: WebMcpExecuteOptions): Promise<WebMcpToolResult>;
+}
+/**
+ * The part of `document.modelContext` / `navigator.modelContext` this package
+ * uses. `registerTool` may return a promise (the spec) or nothing (early
+ * builds); `unregisterTool` exists only on builds that pre-date the abort
+ * signal option.
+ */
+export interface ModelContextLike {
+    registerTool(tool: WebMcpTool, options?: {
+        signal?: AbortSignal;
+    }): unknown;
+    unregisterTool?(name: string): unknown;
+}
+/**
+ * Getters, not handles: hosts remount designers (tab switches), so each call
+ * resolves the CURRENT handle. A getter may do work — open the section that
+ * mounts the designer — and may return nothing, which the tools report as
+ * `NOT_MOUNTED`.
+ */
+export interface DesignerSources {
+    widget?: () => DesignerHandle | undefined;
+    theme?: () => ThemeDesignerHandle | undefined;
+    schema?: () => SchemaDesignerHandle | undefined;
+    action?: () => ActionDesignerHandle | undefined;
+}
+export interface ToolsOptions {
+    /** Tool-name prefix (`<prefix>_widget_draft_get`, …). Default `widgentic`. */
+    prefix?: string;
+}
+export interface RegisterOptions {
+    /** Explicit model context; wins over feature detection (tests, polyfills). */
+    modelContext?: ModelContextLike;
+    /** A host signal that also disposes the registration when aborted. */
+    signal?: AbortSignal;
+}
+export interface ExposeOptions extends ToolsOptions, RegisterOptions {
+    /** Extra host tools registered under the same signal and reported in the same result. */
+    tools?: WebMcpTool[];
+}
+export interface RegisterFailure {
+    name: string;
+    message: string;
+}
+export interface RegisterResult {
+    /** False when the page has no model context: nothing was registered, nothing threw. */
+    supported: boolean;
+    registered: string[];
+    failed: RegisterFailure[];
+    /** Aborts the signal (and unregisters by name where the context supports it); idempotent. */
+    dispose(): void;
+}
+export interface ExposeResult extends RegisterResult {
+    /** The descriptors that were offered, registered or not. */
+    tools: WebMcpTool[];
+}
+//# 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;;;;;GAKG;AACH,OAAO,KAAK,EACV,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,qBAAqB;IACpC,gFAAgF;IAChF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,yFAAyF;AACzF,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,uFAAuF;IACvF,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACpF;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC;IAC5E,cAAc,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACxC;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,cAAc,GAAG,SAAS,CAAC;IAC1C,KAAK,CAAC,EAAE,MAAM,mBAAmB,GAAG,SAAS,CAAC;IAC9C,MAAM,CAAC,EAAE,MAAM,oBAAoB,GAAG,SAAS,CAAC;IAChD,MAAM,CAAC,EAAE,MAAM,oBAAoB,GAAG,SAAS,CAAC;CACjD;AAED,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,sEAAsE;IACtE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,aAAc,SAAQ,YAAY,EAAE,eAAe;IAClE,yFAAyF;IACzF,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,uFAAuF;IACvF,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,6FAA6F;IAC7F,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,YAAa,SAAQ,cAAc;IAClD,4DAA4D;IAC5D,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+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":""}

package/dist/widget-tools.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Widget designer tools: read the draft the person is looking at, load a
+ * definition into it, replace its example data, set its preview theme. Every
+ * edit goes through the designer's own validation and is visible immediately.
+ */
+import type { DesignerHandle } from "@widgentic/designer";
+import type { NameOf } from "./tool.js";
+import type { WebMcpTool } from "./types.js";
+export declare function widgetTools(source: () => DesignerHandle | undefined, name: NameOf): WebMcpTool[];
+//# sourceMappingURL=widget-tools.d.ts.map

package/dist/widget-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-tools.d.ts","sourceRoot":"","sources":["../src/widget-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAuB,cAAc,EAAiC,MAAM,qBAAqB,CAAC;AAK9G,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA2C7C,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,cAAc,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CA+FhG"}

package/dist/widget-tools.js

@@ -0,0 +1,135 @@
+import { deriveDiagnostics } from "@widgentic/designer";
+import { isPlainObject } from "@widgentic/core";
+import { argumentsOf, invalidArgument, notMounted, okResult, rejected } from "./result.js";
+import { defineTool, objectSchema, PERSON_SAVES } from "./tool.js";
+/**
+ * The designer computes diagnostics on every change and hands them to
+ * subscribers; there is no getter. Subscribe once per handle so the tools
+ * return exactly what the designer computed for the change they made.
+ * Before the first change nothing is cached — then derive without the host's
+ * shared entries and say so (`diagnosticsDerived`), because unknown schema or
+ * action references may be over-reported there.
+ */
+const latest = new WeakMap();
+const tracked = new WeakSet();
+function track(handle) {
+    if (tracked.has(handle))
+        return;
+    tracked.add(handle);
+    handle.subscribe((_draft, diagnostics) => {
+        latest.set(handle, diagnostics);
+    });
+}
+function diagnosticsOf(handle) {
+    track(handle);
+    const cached = latest.get(handle);
+    if (cached !== undefined)
+        return { diagnostics: cached, diagnosticsDerived: false };
+    return { diagnostics: deriveDiagnostics(handle.getDraft()), diagnosticsDerived: true };
+}
+/** The export shape: what the designer's Export panel and the server's import consume. */
+function definitionOf(draft) {
+    return {
+        kind: draft.kind,
+        template: draft.template,
+        descriptor: draft.descriptor,
+        ...(draft.load !== undefined ? { load: draft.load } : {})
+    };
+}
+const DEFINITION_SHAPE = "{ kind, template, descriptor, load? } — kind: a unique id that is not a built-in (card, table, tree, group); " +
+    "template: the widgentic template DSL (data SELECTS, you supply every literal; no expressions); " +
+    "descriptor: { description (required), dataSchema? | dataSchemaRef?, dataExample?, … }; load?: an http action binding run on first render.";
+export function widgetTools(source, name) {
+    const resolve = () => {
+        const handle = source();
+        if (handle !== undefined)
+            track(handle);
+        return handle;
+    };
+    return [
+        defineTool({
+            name: name("widget_draft_get"),
+            title: "Read the widget draft",
+            readOnly: true,
+            description: "Read the widget definition currently open in the widget designer, in its export shape " +
+                DEFINITION_SHAPE +
+                " Returns { definition, diagnostics } — diagnostics is the designer's verdict (previewable, kind/template/example/style issues). " +
+                "Call this first: it is what the person is looking at.",
+            inputSchema: objectSchema({}),
+            execute() {
+                const handle = resolve();
+                if (handle === undefined)
+                    return notMounted("widget");
+                return okResult({ definition: definitionOf(handle.getDraft()), ...diagnosticsOf(handle) });
+            }
+        }),
+        defineTool({
+            name: name("widget_draft_load"),
+            title: "Load a widget definition",
+            description: "Replace the draft in the widget designer with a complete definition " +
+                DEFINITION_SHAPE +
+                " The designer validates it: applied → { ok: true, diagnostics } and the person sees it immediately; refused → { ok: false, code: 'REJECTED', errors } with the exact messages the designer shows. " +
+                "Keep the person's kind unless asked to change it. " +
+                PERSON_SAVES,
+            inputSchema: objectSchema({ definition: { type: "object", description: "The widget definition in export shape." } }, ["definition"]),
+            execute(input) {
+                const handle = resolve();
+                if (handle === undefined)
+                    return notMounted("widget");
+                const { definition } = argumentsOf(input);
+                if (!isPlainObject(definition))
+                    return invalidArgument("definition", "object");
+                const result = handle.loadWidget(definition);
+                if (!result.ok)
+                    return rejected(result.errors);
+                return okResult(diagnosticsOf(handle));
+            }
+        }),
+        defineTool({
+            name: name("widget_example_data_set"),
+            title: "Set the widget's example data",
+            description: "Replace the draft's example data (descriptor.dataExample) — the data the preview renders and the example saved with the widget. " +
+                "Send { data } matching the draft's data schema. Returns the diagnostics; a mismatch with the schema is reported in diagnostics.example rather than silently previewed. " +
+                PERSON_SAVES,
+            inputSchema: objectSchema({ data: { description: "Example data for the widget (any JSON value the data schema accepts)." } }, ["data"]),
+            execute(input) {
+                const handle = resolve();
+                if (handle === undefined)
+                    return notMounted("widget");
+                const args = argumentsOf(input);
+                if (!("data" in args) || args.data === undefined)
+                    return invalidArgument("data", "a JSON value");
+                const draft = handle.getDraft();
+                const next = {
+                    ...definitionOf(draft),
+                    descriptor: { ...draft.descriptor, dataExample: args.data }
+                };
+                const result = handle.loadWidget(next);
+                if (!result.ok)
+                    return rejected(result.errors);
+                return okResult(diagnosticsOf(handle));
+            }
+        }),
+        defineTool({
+            name: name("widget_theme_set"),
+            title: "Set the widget preview theme",
+            description: "Set the theme tokens the widget preview is rendered with: { tokens: { <token>: <css value> } } over the --wg-* tokens " +
+                "(list them with the theme_token_specs tool; author variables are x-<name>). Validated by the theming rules; refused → { ok: false, code: 'REJECTED', errors }. " +
+                "This is the preview theme of the draft, not a saved theme entry.",
+            inputSchema: objectSchema({ tokens: { type: "object", description: "Token name → CSS value.", additionalProperties: { type: "string" } } }, ["tokens"]),
+            execute(input) {
+                const handle = resolve();
+                if (handle === undefined)
+                    return notMounted("widget");
+                const { tokens } = argumentsOf(input);
+                if (!isPlainObject(tokens))
+                    return invalidArgument("tokens", "object of token → value");
+                const result = handle.loadTheme(tokens);
+                if (!result.ok)
+                    return rejected(result.errors);
+                return okResult({ theme: handle.getDraft().theme ?? {} });
+            }
+        })
+    ];
+}
+//# sourceMappingURL=widget-tools.js.map

package/dist/widget-tools.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@widgentic/webmcp",
+  "version": "0.1.0",
+  "description": "BETA — expose mounted widgentic designers as WebMCP tools (document.modelContext), so a browser-side agent can draft into the designer the person is looking at. API may change in minor versions before 1.0.",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/widgentic/widgentic.git",
+    "directory": "packages/webmcp"
+  },
+  "homepage": "https://widgentic.dev",
+  "keywords": [
+    "widgentic",
+    "webmcp",
+    "widgets",
+    "mcp",
+    "agents"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@widgentic/core": "^0.7.0",
+    "@widgentic/designer": "^0.7.0"
+  }
+}