@miragon/mcp-toolkit-core 2.5.0 → 2.6.0

package/dist/tools/register-dashboard-tools.d.ts

@@ -1,5 +1,5 @@
 import { type MCPServer } from "mcp-use";
-import type { DashboardStore } from "./dashboard-store.js";
+import { type DashboardStore } from "./dashboard-store.js";
 import type { WidgetRegistry } from "../registry/widget-registry.js";
 export interface RegisterDashboardToolsOptions {
     store: DashboardStore;
@@ -10,12 +10,24 @@ export interface RegisterDashboardToolsOptions {
      * blocked on a cosmetic mistake. Omit to skip the check entirely.
      */
     widgetRegistry?: WidgetRegistry;
+    /**
+     * Refuse every dashboard call that resolves no caller id — even one that
+     * carries no `ctx.auth` at all — instead of serving it in global scope.
+     * `createFrameworkApp` sets this whenever an `oauth` provider is configured.
+     * A call that DOES carry `ctx.auth` is held to it regardless: an
+     * authenticated caller without an id is never widened to global scope.
+     * Defaults to `false`.
+     */
+    requireCallerIdentity?: boolean;
 }
 /**
  * Registers `save-dashboard`, `list-dashboards`, `load-dashboard`, and
  * `delete-dashboard`. The tools are thin CRUD wrappers around the injected
- * `DashboardStore`; auth scoping is applied here (never in the store) via
- * the standard `ctx.auth.user.userId` extraction.
+ * `DashboardStore`; the caller's scope is decided here via
+ * {@link resolveCaller} (both mcp-use 2 `ctx.auth` shapes; `user.id`, then
+ * `user.userId`, then the token's `sub`) and handed to the store as its
+ * `userId` filter. An authenticated call that resolves no id is refused —
+ * never served in global scope.
  *
  * `load-dashboard` returns the full record as JSON in `content[0].text`
  * (mirrored into `structuredContent`) so the model itself receives the

package/dist/tools/register-dashboard-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register-dashboard-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-dashboard-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAA;AAGxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAG1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAEpE,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,cAAc,CAAA;IACrB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,cAAc,CAAA;CAChC;AAyCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,6BAA6B,GACrC,IAAI,CA0HN"}
+{"version":3,"file":"register-dashboard-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-dashboard-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAA;AAIxC,OAAO,EAML,KAAK,cAAc,EAEpB,MAAM,sBAAsB,CAAA;AAG7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAEpE,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,cAAc,CAAA;IACrB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B;;;;;;;OAOG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAChC;AA0GD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,6BAA6B,GACrC,IAAI,CA8JN"}

package/dist/tools/register-dashboard-tools.js

@@ -1,5 +1,7 @@
 import { z } from "zod";
-import { objectResult } from "./tool-results.js";
+import { resolveCaller } from "../auth/caller.js";
+import { errorResult, objectResult } from "./tool-results.js";
+import { assertDashboardWritable, DashboardOwnershipError, DashboardUnreadableError, isDashboardOwnedBy, } from "./dashboard-store.js";
 import { collectLayoutWidgets } from "../framework/view-builders.js";
 import { layoutSchema } from "../framework/layout-schemas.js";
 const stepRefSchema = z.object({
@@ -31,15 +33,70 @@ const saveSchema = z.object({
 const idSchema = z.object({
     id: z.string().describe("Dashboard id as returned by `save-dashboard` or `list-dashboards`."),
 });
-function extractUserId(ctx) {
-    const user = ctx?.auth?.user;
-    return typeof user?.userId === "string" ? user.userId : undefined;
+/**
+ * Whose dashboards a call may touch: `{ userId: undefined }` is global scope
+ * (a server without OAuth), `{ userId }` is that caller's records only, and
+ * `undefined` means refuse — the call is authenticated (or OAuth is
+ * required) but no caller id resolves, and falling back to global scope would
+ * hand it every user's dashboards.
+ */
+function dashboardScope(ctx, requireCallerIdentity) {
+    const caller = resolveCaller(ctx);
+    if (caller?.userId)
+        return { userId: caller.userId };
+    if (caller === undefined && !requireCallerIdentity)
+        return { userId: undefined };
+    return undefined;
+}
+const NO_IDENTITY_MESSAGE = "Access denied: this request carries no caller identity (the OAuth provider mapped no user id and the token has no `sub`). Dashboards are per-user, so they cannot be read or written without one.";
+/**
+ * Defence in depth for custom stores with a laxer ownership rule (the 2.5
+ * contract handed owner-less records to every caller): the record `get`
+ * returns, but only if it is the caller's — {@link isDashboardOwnedBy}, so
+ * global scope passes everything through. A store that already follows the
+ * rule loses nothing but the extra read.
+ */
+async function ownRecord(store, id, scope) {
+    const record = await store.get(id, scope);
+    return record && isDashboardOwnedBy(record.userId, scope.userId) ? record : undefined;
+}
+/**
+ * Keep only the identified caller's own summaries. A summary that names its
+ * owner is decided on the spot; one that doesn't (a store on the 2.5 summary
+ * shape) is verified through `get`, and an unreadable one that cannot be
+ * attributed that way is dropped rather than listed.
+ */
+async function ownSummaries(store, items, userId) {
+    const isOwn = async (item) => {
+        if (item.userId !== undefined)
+            return item.userId === userId;
+        try {
+            return (await ownRecord(store, item.id, { userId })) !== undefined;
+        }
+        catch (err) {
+            if (err instanceof DashboardUnreadableError)
+                return false;
+            throw err;
+        }
+    };
+    const verdicts = await Promise.all(items.map(isOwn));
+    return items.filter((_item, index) => verdicts[index]);
+}
+/** Store refusals that reach the caller as a tool error rather than a crash. */
+function refusalResult(err) {
+    if (err instanceof DashboardOwnershipError || err instanceof DashboardUnreadableError) {
+        return errorResult(err.message);
+    }
+    throw err;
 }
 /**
  * Registers `save-dashboard`, `list-dashboards`, `load-dashboard`, and
  * `delete-dashboard`. The tools are thin CRUD wrappers around the injected
- * `DashboardStore`; auth scoping is applied here (never in the store) via
- * the standard `ctx.auth.user.userId` extraction.
+ * `DashboardStore`; the caller's scope is decided here via
+ * {@link resolveCaller} (both mcp-use 2 `ctx.auth` shapes; `user.id`, then
+ * `user.userId`, then the token's `sub`) and handed to the store as its
+ * `userId` filter. An authenticated call that resolves no id is refused —
+ * never served in global scope.
  *
  * `load-dashboard` returns the full record as JSON in `content[0].text`
  * (mirrored into `structuredContent`) so the model itself receives the
@@ -54,28 +111,45 @@ function extractUserId(ctx) {
  */
 export function registerDashboardTools(server, options) {
     const { store, widgetRegistry } = options;
+    const requireCallerIdentity = options.requireCallerIdentity ?? false;
     server.tool({
         name: "save-dashboard",
         title: "Save Dashboard",
         description: "Persists a dashboard (render-view input bundle + name). Pass an existing `id` to update, omit to create. The builder UI's Save button invokes this tool.",
         inputSchema: saveSchema,
     }, async (params, ctx) => {
+        const scope = dashboardScope(ctx, requireCallerIdentity);
+        if (!scope)
+            return errorResult(NO_IDENTITY_MESSAGE);
         // Warn (never reject) on unknown widget ids — usually a typo. A save is
         // deliberately never blocked on a cosmetic layout mistake; the unknown
         // ids surface in the text summary so the user can spot and fix it.
         const unknownWidgets = widgetRegistry
             ? [...new Set(collectLayoutWidgets(params.layout))].filter((id) => !widgetRegistry.get(id))
             : [];
-        const record = await store.save({
-            id: params.id,
-            name: params.name,
-            description: params.description,
-            userId: extractUserId(ctx),
-            keys: params.keys,
-            steps: params.steps,
-            layout: params.layout,
-            title: params.title,
-        });
+        let record;
+        try {
+            if (scope.userId !== undefined && params.id !== undefined) {
+                // Defence in depth: a lax custom store's own save might let the
+                // caller overwrite (and so claim) a record it does not own.
+                const existing = await store.get(params.id, scope);
+                if (existing)
+                    assertDashboardWritable(existing, scope.userId);
+            }
+            record = await store.save({
+                id: params.id,
+                name: params.name,
+                description: params.description,
+                userId: scope.userId,
+                keys: params.keys,
+                steps: params.steps,
+                layout: params.layout,
+                title: params.title,
+            });
+        }
+        catch (err) {
+            return refusalResult(err);
+        }
         const summaryLines = [
             `Saved dashboard "${record.name}" (${record.id}).`,
             unknownWidgets.length > 0
@@ -99,8 +173,13 @@ export function registerDashboardTools(server, options) {
         description: "Returns the dashboards visible to the caller (scoped by userId when auth is enabled). Metadata only — fetch a full record via `load-dashboard`.",
         annotations: { readOnlyHint: true },
     }, async (_params, ctx) => {
-        const items = await store.list({ userId: extractUserId(ctx) });
-        return objectResult({ items });
+        const scope = dashboardScope(ctx, requireCallerIdentity);
+        if (!scope)
+            return errorResult(NO_IDENTITY_MESSAGE);
+        const items = await store.list({ userId: scope.userId });
+        return objectResult({
+            items: scope.userId === undefined ? items : await ownSummaries(store, items, scope.userId),
+        });
     });
     server.tool({
         name: "load-dashboard",
@@ -109,7 +188,16 @@ export function registerDashboardTools(server, options) {
         inputSchema: idSchema,
         annotations: { readOnlyHint: true },
     }, async ({ id }, ctx) => {
-        const record = await store.get(id, { userId: extractUserId(ctx) });
+        const scope = dashboardScope(ctx, requireCallerIdentity);
+        if (!scope)
+            return errorResult(NO_IDENTITY_MESSAGE);
+        let record;
+        try {
+            record = await ownRecord(store, id, scope);
+        }
+        catch (err) {
+            return refusalResult(err);
+        }
         if (!record) {
             return {
                 content: [{ type: "text", text: `Dashboard "${id}" not found.` }],
@@ -142,7 +230,19 @@ export function registerDashboardTools(server, options) {
         description: "Permanently removes a dashboard by id.",
         inputSchema: idSchema,
     }, async ({ id }, ctx) => {
-        const deleted = await store.delete(id, { userId: extractUserId(ctx) });
+        const scope = dashboardScope(ctx, requireCallerIdentity);
+        if (!scope)
+            return errorResult(NO_IDENTITY_MESSAGE);
+        let deleted;
+        try {
+            // Defence in depth: never let a lax custom store delete a record the
+            // identified caller does not own.
+            const deletable = scope.userId === undefined || (await ownRecord(store, id, scope));
+            deleted = deletable ? await store.delete(id, scope) : false;
+        }
+        catch (err) {
+            return refusalResult(err);
+        }
         return {
             content: [
                 {

package/dist/tools/register-dashboard-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"register-dashboard-tools.js","sourceRoot":"","sources":["../../src/tools/register-dashboard-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEhD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAc7D,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sEAAsE,CAAC;IAC/F,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;IAC/E,QAAQ,EAAE,CAAC;SACR,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,6EAA6E,CAAC;CAC3F,CAAC,CAAA;AAEF,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,EAAE,EAAE,CAAC;SACF,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,+DAA+D,CAAC;IAC5E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IAC1E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACzF,IAAI,EAAE,CAAC;SACJ,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SAC/B,QAAQ,EAAE;SACV,QAAQ,CACP,uFAAuF,CACxF;IACH,KAAK,EAAE,CAAC;SACL,KAAK,CAAC,aAAa,CAAC;SACpB,QAAQ,EAAE;SACV,QAAQ,CAAC,mFAAmF,CAAC;IAChG,MAAM,EAAE,YAAY;IACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;CACpF,CAAC,CAAA;AAEF,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;IACxB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oEAAoE,CAAC;CAC9F,CAAC,CAAA;AAEF,SAAS,aAAa,CAAC,GAAY;IACjC,MAAM,IAAI,GAAI,GAA8D,EAAE,IAAI,EAAE,IAAI,CAAA;IACxF,OAAO,OAAO,IAAI,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;AACnE,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAiB,EACjB,OAAsC;IAEtC,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,OAAO,CAAA;IAEzC,MAAM,CAAC,IAAI,CACT;QACE,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,gBAAgB;QACvB,WAAW,EACT,0JAA0J;QAC5J,WAAW,EAAE,UAAU;KACxB,EACD,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;QACpB,wEAAwE;QACxE,uEAAuE;QACvE,mEAAmE;QACnE,MAAM,cAAc,GAAG,cAAc;YACnC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,oBAAoB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC3F,CAAC,CAAC,EAAE,CAAA;QAEN,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC;YAC9B,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC;YAC1B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC,CAAA;QACF,MAAM,YAAY,GAAG;YACnB,oBAAoB,MAAM,CAAC,IAAI,MAAM,MAAM,CAAC,EAAE,IAAI;YAClD,cAAc,CAAC,MAAM,GAAG,CAAC;gBACvB,CAAC,CAAC,wEAAwE,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,mEAAmE;gBACtK,CAAC,CAAC,EAAE;SACP,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QACjB,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACnE,iBAAiB,EAAE;gBACjB,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,GAAG,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACzD;SACF,CAAA;IACH,CAAC,CACF,CAAA;IAED,MAAM,CAAC,IAAI,CACT;QACE,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,iJAAiJ;QACnJ,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE;QACrB,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAC9D,OAAO,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;IAChC,CAAC,CACF,CAAA;IAED,MAAM,CAAC,IAAI,CACT;QACE,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,gBAAgB;QACvB,WAAW,EACT,kIAAkI;QACpI,WAAW,EAAE,QAAQ;QACrB,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE;QACpB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAClE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;gBAC1E,OAAO,EAAE,IAAI;aACd,CAAA;QACH,CAAC;QACD,oEAAoE;QACpE,mEAAmE;QACnE,kEAAkE;QAClE,+BAA+B;QAC/B,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QACpD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,cAAc,EAAE,iDAAiD,MAAM,CAAC,KAAK,CAAC,MAAM;6BACvF,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;6BACvE,IAAI,CAAC,IAAI,CAAC,EAAE;qBAChB;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAA;QACH,CAAC;QACD,OAAO,YAAY,CAAC,MAA4C,CAAC,CAAA;IACnE,CAAC,CACF,CAAA;IAED,MAAM,CAAC,IAAI,CACT;QACE,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE,wCAAwC;QACrD,WAAW,EAAE,QAAQ;KACtB,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE;QACpB,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACtE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAC,CAAC,cAAc,EAAE,cAAc;iBAC7E;aACF;YACD,iBAAiB,EAAE,EAAE,OAAO,EAAE;YAC9B,OAAO,EAAE,CAAC,OAAO;SAClB,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"register-dashboard-tools.js","sourceRoot":"","sources":["../../src/tools/register-dashboard-tools.ts"],"names":[],"mappings":"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"}

package/dist/tools/register-framework-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register-framework-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-framework-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAA;AAMxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC7D,OAAO,EAGL,KAAK,cAAc,EAEpB,MAAM,kBAAkB,CAAA;AAEzB,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEtD,qFAAqF;AACrF,eAAO,MAAM,gBAAgB,gBAAgB,CAAA;AAE7C,MAAM,WAAW,6BAA6B;IAC5C,YAAY,EAAE,YAAY,CAAA;IAC1B,cAAc,EAAE,cAAc,CAAA;IAC9B,MAAM,EAAE,SAAS,CAAA;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACnD,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B;;;;;OAKG;IACH,GAAG,CAAC,EAAE,cAAc,CAAA;CACrB;AAuDD;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,6BAA6B,GACrC,IAAI,CAwFN"}
+{"version":3,"file":"register-framework-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-framework-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAA;AAQxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC7D,OAAO,EAGL,KAAK,cAAc,EAEpB,MAAM,kBAAkB,CAAA;AAEzB,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEtD,qFAAqF;AACrF,eAAO,MAAM,gBAAgB,gBAAgB,CAAA;AAE7C,MAAM,WAAW,6BAA6B;IAC5C,YAAY,EAAE,YAAY,CAAA;IAC1B,cAAc,EAAE,cAAc,CAAA;IAC9B,MAAM,EAAE,SAAS,CAAA;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACnD,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B;;;;;OAKG;IACH,GAAG,CAAC,EAAE,cAAc,CAAA;CACrB;AAyCD;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,6BAA6B,GACrC,IAAI,CA0FN"}

package/dist/tools/register-framework-tools.js

@@ -1,8 +1,10 @@
 import { z } from "zod";
+import { resolvePipelineContext } from "../engine/pipeline-executor.js";
 import { textResult } from "./tool-results.js";
 import { getFrameworkManifest } from "../framework/manifest.js";
 import { layoutInputSchema } from "../framework/layout-schemas.js";
 import { renderView } from "../framework/render-view.js";
+import { moduleToolOwner, withToolOwner } from "./tool-name-guard.js";
 import { appsSdkMeta, viewResourceUri, } from "../types/meta.js";
 /** View name (and thus `ui://views/render-view.html` URI) bound to `render-view`. */
 export const RENDER_VIEW_NAME = "render-view";
@@ -29,10 +31,6 @@ const renderViewSchema = z.object({
     layout: layoutInputSchema,
     title: z.string().optional().describe("Optional view title."),
 });
-function extractUserId(ctx) {
-    const user = ctx?.auth?.user;
-    return typeof user?.userId === "string" ? user.userId : undefined;
-}
 /** Converts the camelCase resource CSP into the snake_cased `openai/widgetCSP` shape. */
 function toWidgetCspMeta(csp) {
     const meta = {};
@@ -81,7 +79,7 @@ export function registerFrameworkTools(server, options) {
             },
             stepRegistry,
             appConfigs,
-            ctx: { userId: extractUserId(ctx) },
+            ctx: resolvePipelineContext(ctx),
             builderAvailable,
         });
     };
@@ -109,7 +107,7 @@ export function registerFrameworkTools(server, options) {
         }),
     }, renderHandler);
     for (const plugin of plugins) {
-        plugin.registerWidgetTools?.(server, { widgetCSP, viewCsp: csp });
+        withToolOwner(server, moduleToolOwner(plugin.definition.name), () => plugin.registerWidgetTools?.(server, { widgetCSP, viewCsp: csp }));
     }
     server.tool({
         name: refreshToolName,

package/dist/tools/register-framework-tools.js.map

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

package/dist/tools/register-tool.d.ts

@@ -1,6 +1,6 @@
-import { type MCPServer } from "mcp-use";
+import { type MCPServer, type ToolRef } from "mcp-use";
 import { z } from "zod";
-type ZodRawShape = Record<string, z.ZodTypeAny>;
+import { type HandlerUser, type ToolDefinitionPassthrough, type ToolHandlerContext, type ToolRegistrarOptions, type TypedToolRefOptions, type ZodRawShape } from "./registrar-shared.js";
 /**
  * The validated args a handler receives. When an `inputSchema` shape is
  * declared, this is inferred from it (`z.infer`), so handlers get precise types
@@ -8,7 +8,7 @@ type ZodRawShape = Record<string, z.ZodTypeAny>;
  * falls back to a permissive record, matching the pre-generic behaviour.
  */
 export type ToolArgs<TShape extends ZodRawShape = ZodRawShape> = z.infer<z.ZodObject<TShape>>;
-export interface ToolConfig<TClient, TShape extends ZodRawShape = ZodRawShape> {
+export interface ToolConfig<TClient, TShape extends ZodRawShape = ZodRawShape, TUser = unknown> {
     name: string;
     description: string;
     category?: string;
@@ -30,16 +30,74 @@ export interface ToolConfig<TClient, TShape extends ZodRawShape = ZodRawShape> {
         idempotentHint?: boolean;
         openWorldHint?: boolean;
     };
-    handler: (client: TClient, args: ToolArgs<TShape>) => Promise<unknown>;
+    /**
+     * Reject unknown input keys instead of silently stripping them: the input
+     * schema is advertised with `additionalProperties: false`, and a call with
+     * an unknown key fails with a tool error naming the valid keys. Overrides
+     * the registrar's `strictInput` option; off by default in 2.x.
+     */
+    strictInput?: boolean;
+    /**
+     * Every other mcp-use `ToolDefinition` field, forwarded verbatim to
+     * `server.tool` — `title`, `_meta`, `visibility`, `securitySchemes`,
+     * `view`, … The registrar-derived keys (name, description, schemas,
+     * annotations) always win.
+     */
+    definition?: ToolDefinitionPassthrough;
+    /**
+     * The tool body. `ctx` is mcp-use's per-call context ({@link ToolHandlerContext}):
+     * `signal` for cancellation, `reportProgress`, `sendLog`, `client`, `auth`.
+     * The registrar always passes it; it is optional in the type so handlers
+     * stay directly callable as `(client, args)` — e.g. from unit tests.
+     */
+    handler: (client: TClient, args: ToolArgs<TShape>, ctx?: ToolHandlerContext<TUser>) => Promise<unknown>;
     formatResult?: (result: unknown, args: ToolArgs<TShape>) => string;
 }
 export interface RegisteredToolMeta {
     name: string;
     category?: string;
 }
-export declare function createToolRegistrar<TClient>(server: MCPServer, client: TClient): {
-    <TShape extends ZodRawShape = ZodRawShape>(config: ToolConfig<TClient, TShape>): void;
-    getRegisteredTools(): RegisteredToolMeta[];
-};
-export {};
+/**
+ * The structured output a registrar tool advertises for its `outputSchema`
+ * — the `ToolRef` output type. Arrays are wrapped into `{ data }` exactly
+ * like the advertised schema; no `outputSchema` means `never`, mirroring
+ * mcp-use's own `InferToolOutput`.
+ */
+export type RegistrarToolOutput<TOutput> = [TOutput] extends [z.ZodArray<z.ZodTypeAny>] ? {
+    data: z.output<TOutput>;
+} : [TOutput] extends [z.ZodTypeAny] ? z.output<TOutput> : never;
+/**
+ * The `register` function {@link createToolRegistrar} returns. Its static
+ * return type is `void` so hand-written wrappers typed as
+ * `ReturnType<typeof createToolRegistrar<C>>` (e.g. a toolset filter that
+ * skips registration) keep compiling; at runtime it returns the mcp-use
+ * `ToolRef`. Pass `toolRefs: true` for {@link TypedToolRegistrar}.
+ */
+export interface ToolRegistrar<TClient, TUser = unknown> {
+    <TShape extends ZodRawShape = ZodRawShape>(config: ToolConfig<TClient, TShape, TUser>): void;
+    getRegisteredTools: () => RegisteredToolMeta[];
+}
+/**
+ * The `register` function `createToolRegistrar(server, client, { toolRefs: true })`
+ * returns: each call returns the tool's mcp-use `ToolRef`, typed with the
+ * literal tool name, the inferred input and the structured output — export
+ * it for `mcp-env.d.ts` / typed `useCallTool`, like a raw `server.tool` ref.
+ */
+export interface TypedToolRegistrar<TClient, TUser = unknown> {
+    <TShape extends ZodRawShape = ZodRawShape, const TName extends string = string, TOutput extends z.ZodTypeAny | undefined = undefined>(config: ToolConfig<TClient, TShape, TUser> & {
+        name: TName;
+        outputSchema?: TOutput;
+    }): ToolRef<TName, ToolArgs<TShape>, RegistrarToolOutput<TOutput>>;
+    getRegisteredTools: () => RegisteredToolMeta[];
+}
+/**
+ * Registrar for a module's domain tools: builds the input/output schemas,
+ * wraps the handler in {@link withToolErrors}, and mirrors the result into
+ * `structuredContent`. Handlers receive `(client, args, ctx)` — `ctx` is
+ * mcp-use's per-call context. `options.strictInput` sets the default for
+ * every tool's `strictInput`; `options.toolRefs` types `register()`'s return
+ * value as the tool's `ToolRef`.
+ */
+export declare function createToolRegistrar<TClient, TUser = never>(server: MCPServer<TUser>, client: TClient, options: TypedToolRefOptions): TypedToolRegistrar<TClient, HandlerUser<TUser>>;
+export declare function createToolRegistrar<TClient, TUser = never>(server: MCPServer<TUser>, client: TClient, options?: ToolRegistrarOptions): ToolRegistrar<TClient, HandlerUser<TUser>>;
 //# sourceMappingURL=register-tool.d.ts.map

package/dist/tools/register-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register-tool.d.ts","sourceRoot":"","sources":["../../src/tools/register-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAA;AAK/C;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,CAAC,MAAM,SAAS,WAAW,GAAG,WAAW,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAA;AAE7F,MAAM,WAAW,UAAU,CAAC,OAAO,EAAE,MAAM,SAAS,WAAW,GAAG,WAAW;IAC3E,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,CAAC,CAAC,UAAU,CAAA;IAC3B,WAAW,CAAC,EAAE;QACZ,YAAY,CAAC,EAAE,OAAO,CAAA;QACtB,eAAe,CAAC,EAAE,OAAO,CAAA;QACzB,cAAc,CAAC,EAAE,OAAO,CAAA;QACxB,aAAa,CAAC,EAAE,OAAO,CAAA;KACxB,CAAA;IACD,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACtE,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,MAAM,CAAA;CACnE;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AA+BD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO;KAG3D,MAAM,SAAS,WAAW,wBAAwB,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC;;EAyDhG"}
+{"version":3,"file":"register-tool.d.ts","sourceRoot":"","sources":["../../src/tools/register-tool.ts"],"names":[],"mappings":"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"}

package/dist/tools/register-tool.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { objectResult, textResult } from "./tool-results.js";
 import { withToolErrors } from "./with-tool-errors.js";
+import { registrarInputSchema, } from "./registrar-shared.js";
 function wrapArraySchema(schema) {
     if (!schema)
         return undefined;
@@ -29,22 +30,30 @@ function toStructuredContent(result, toolName) {
     throw new Error(`Tool "${toolName}" declares an outputSchema but its handler returned a ${kind} value; ` +
         `structured output must be an object or array.`);
 }
-export function createToolRegistrar(server, client) {
+export function createToolRegistrar(server, client, options = {}) {
     const registeredTools = [];
+    // Registration is independent of the OAuth user type, which only shapes
+    // the callback ctx; the ctx is handed on typed by the registrar instead.
+    const target = server;
     function register(config) {
         registeredTools.push({ name: config.name, category: config.category });
-        server.tool({
+        return target.tool({
+            ...config.definition,
+            // Every registrar-owned key is set explicitly — undefined included —
+            // so a cast or plain-JS `definition` cannot smuggle one in.
             name: config.name,
             description: config.description,
-            inputSchema: config.inputSchema ? z.object(config.inputSchema) : undefined,
+            inputSchema: registrarInputSchema(config.inputSchema, config.strictInput ?? options.strictInput ?? false),
+            // mcp-use's alias: it reads `inputSchema ?? schema`.
+            schema: undefined,
             outputSchema: wrapArraySchema(config.outputSchema),
             annotations: config.annotations,
         }, 
-        // The SDK validates args against the schema above, so the loose callback
-        // arg is safely the handler's precise `ToolArgs<TShape>`.
-        withToolErrors(async (looseArgs) => {
-            const args = looseArgs;
-            const result = await config.handler(client, args);
+        // The SDK validates args against the schema above before the callback
+        // runs; the public `register` is generic over that shape, this
+        // implementation sees the erased `ToolArgs`.
+        withToolErrors(async (args, ctx) => {
+            const result = await config.handler(client, args, ctx);
             if (config.formatResult) {
                 const formatted = textResult(config.formatResult(result, args));
                 // When an outputSchema is declared the tool promised structured

package/dist/tools/register-tool.js.map

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

package/dist/tools/register-widget-tool.d.ts

@@ -1,8 +1,8 @@
-import { type MCPServer, type ToolAnnotations } from "mcp-use";
+import { type MCPServer, type ToolAnnotations, type ToolRef } from "mcp-use";
 import { z } from "zod";
 import { type WidgetToolMetaDefaults } from "../types/meta.js";
 import type { ToolArgs } from "./register-tool.js";
-type ZodRawShape = Record<string, z.ZodTypeAny>;
+import { type HandlerUser, type ToolHandlerContext, type ToolRegistrarOptions, type TypedToolRefOptions, type WidgetToolDefinitionPassthrough, type ZodRawShape } from "./registrar-shared.js";
 interface WidgetToolResult {
     text: string;
     structuredContent: Record<string, unknown>;
@@ -14,7 +14,7 @@ interface WidgetToolResult {
  * and binds a view so the host renders its result.
  */
 export type WidgetToolVisibility = "app" | "model";
-export interface WidgetToolConfig<TClient, TShape extends ZodRawShape = ZodRawShape> {
+export interface WidgetToolConfig<TClient, TShape extends ZodRawShape = ZodRawShape, TUser = unknown> {
     name: string;
     title?: string;
     description: string;
@@ -53,8 +53,43 @@ export interface WidgetToolConfig<TClient, TShape extends ZodRawShape = ZodRawSh
      * Only emitted on model-visible widget tools.
      */
     invoked?: string;
-    handler: (client: TClient, params: ToolArgs<TShape>) => Promise<WidgetToolResult>;
+    /**
+     * Reject unknown input keys with a tool error naming the valid keys
+     * instead of silently stripping them (`additionalProperties: false` on the
+     * advertised schema). Overrides the registrar's `strictInput` option; off
+     * by default in 2.x.
+     */
+    strictInput?: boolean;
+    /**
+     * Every other mcp-use `ToolDefinition` field, forwarded verbatim to
+     * `server.tool` — e.g. `securitySchemes`. `title`, `visibility`, `view`
+     * and `_meta` stay registrar-derived (use `title` / `visibility` / `meta`).
+     */
+    definition?: WidgetToolDefinitionPassthrough;
+    /**
+     * The tool body. `ctx` is mcp-use's per-call context ({@link ToolHandlerContext});
+     * always passed by the registrar, optional in the type so handlers stay
+     * directly callable as `(client, params)`.
+     */
+    handler: (client: TClient, params: ToolArgs<TShape>, ctx?: ToolHandlerContext<TUser>) => Promise<WidgetToolResult>;
 }
+/**
+ * The `ToolRef` output type of a widget tool: its declared `outputSchema`,
+ * else the `structuredContent` record every widget handler returns.
+ */
+export type WidgetToolOutput<TOutput> = [TOutput] extends [z.ZodTypeAny] ? z.output<TOutput> : WidgetToolResult["structuredContent"];
+/**
+ * The `register` function {@link createWidgetToolRegistrar} returns. Its
+ * static return type is `void` (wrapper-compatible, like `ToolRegistrar`);
+ * at runtime it returns the mcp-use `ToolRef`. Pass `toolRefs: true` for
+ * {@link TypedWidgetToolRegistrar}.
+ */
+export type WidgetToolRegistrar<TClient, TUser = unknown> = <TShape extends ZodRawShape = ZodRawShape>(config: WidgetToolConfig<TClient, TShape, TUser>) => void;
+/** The `ToolRef`-returning widget registrar (`toolRefs: true`). */
+export type TypedWidgetToolRegistrar<TClient, TUser = unknown> = <TShape extends ZodRawShape = ZodRawShape, const TName extends string = string, TOutput extends z.ZodTypeAny | undefined = undefined>(config: WidgetToolConfig<TClient, TShape, TUser> & {
+    name: TName;
+    outputSchema?: TOutput;
+}) => ToolRef<TName, ToolArgs<TShape>, WidgetToolOutput<TOutput>>;
 /**
  * Registrar for widget tools against mcp-use's native view binding.
  *
@@ -69,7 +104,13 @@ export interface WidgetToolConfig<TClient, TShape extends ZodRawShape = ZodRawSh
  * `createFrameworkApp` collects every `view` binding registered this way and
  * primes the view registry with the shared app bundle, so each bound name
  * resolves to the same compiled widget code.
+ *
+ * Handlers receive `(client, params, ctx)` — `ctx` is mcp-use's per-call
+ * context. `options.strictInput` sets the default for every tool's
+ * `strictInput`; `options.toolRefs` types `register()`'s return value as the
+ * tool's `ToolRef` (returned at runtime either way).
  */
-export declare function createWidgetToolRegistrar<TClient>(server: MCPServer, client: TClient, metaDefaults?: WidgetToolMetaDefaults): <TShape extends ZodRawShape = ZodRawShape>(config: WidgetToolConfig<TClient, TShape>) => void;
+export declare function createWidgetToolRegistrar<TClient, TUser = never>(server: MCPServer<TUser>, client: TClient, metaDefaults: WidgetToolMetaDefaults | undefined, options: TypedToolRefOptions): TypedWidgetToolRegistrar<TClient, HandlerUser<TUser>>;
+export declare function createWidgetToolRegistrar<TClient, TUser = never>(server: MCPServer<TUser>, client: TClient, metaDefaults?: WidgetToolMetaDefaults, options?: ToolRegistrarOptions): WidgetToolRegistrar<TClient, HandlerUser<TUser>>;
 export {};
 //# sourceMappingURL=register-widget-tool.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"register-widget-tool.d.ts","sourceRoot":"","sources":["../../src/tools/register-widget-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAA;AAC9D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAgC,KAAK,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAE5F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAElD,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAA;AAK/C,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC3C;AAED;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,OAAO,CAAA;AAElD,MAAM,WAAW,gBAAgB,CAAC,OAAO,EAAE,MAAM,SAAS,WAAW,GAAG,WAAW;IACjF,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,yEAAyE;IACzE,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B;;;;OAIG;IACH,UAAU,CAAC,EAAE,oBAAoB,CAAA;IACjC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,CAAC,CAAC,UAAU,CAAA;IAC3B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAA;CAClF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAC/C,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,OAAO,EACf,YAAY,CAAC,EAAE,sBAAsB,IAEZ,MAAM,SAAS,WAAW,GAAG,WAAW,EAC/D,QAAQ,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,UA6D5C"}
+{"version":3,"file":"register-widget-tool.d.ts","sourceRoot":"","sources":["../../src/tools/register-widget-tool.ts"],"names":[],"mappings":"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"}