@miragon/mcp-toolkit-core 0.10.1 → 1.0.1

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

@@ -1,37 +1,17 @@
-import { type MCPServer } from "mcp-use/server";
+import { type MCPServer } from "mcp-use";
 import type { StepRegistry } from "../registry/step-registry.js";
 import type { WidgetRegistry } from "../registry/widget-registry.js";
 import type { AppConfig, AppPlugin } from "../types/index.js";
-/**
- * CSP advertised on the widget resource, in the SEP-1865 camelCase shape
- * (`_meta.ui.csp`). All entries are full origins (e.g. `https://server.example`).
- * The Apps SDK tool-meta variant (`openai/widgetCSP`, snake_cased) is derived
- * from the same value.
- */
-export interface AppResourceCsp {
-    /** Origins allowed for fetch/XHR/WebSocket from inside the widget iframe. */
-    connectDomains?: string[];
-    /** Origins allowed for images, scripts, stylesheets, fonts. */
-    resourceDomains?: string[];
-    /** Allowed iframe origins. */
-    frameDomains?: string[];
-    /** Allowed `base-uri` origins. */
-    baseUriDomains?: string[];
-}
+import { type AppResourceCsp } from "../types/meta.js";
+export type { AppResourceCsp } from "../types/meta.js";
+/** View name (and thus `ui://views/render-view.html` URI) bound to `render-view`. */
+export declare const RENDER_VIEW_NAME = "render-view";
 export interface RegisterFrameworkToolsOptions {
     stepRegistry: StepRegistry;
     widgetRegistry: WidgetRegistry;
     config: AppConfig;
     appConfigs: Record<string, Record<string, unknown>>;
     plugins: AppPlugin[];
-    /**
-     * The MCP UI resource URI that hosts the widget bundle (typically the
-     * compiled `mcp-app.html`). Referenced by `render-view` / `refresh-view`
-     * via the `_meta.ui.resourceUri` convention.
-     */
-    resourceUri: string;
-    /** Absolute path to the bundled `mcp-app.html` served behind `resourceUri`. */
-    htmlPath: string;
     /**
      * Tool name for the refresh hook the UI calls to re-run the pipeline.
      * The `@miragon/mcp-toolkit-ui` default matches this — change both in
@@ -48,36 +28,24 @@ export interface RegisterFrameworkToolsOptions {
      */
     builderAvailable?: boolean;
     /**
-     * Public base URL the server advertises. Its origin is auto-injected into
-     * the resource CSP's connect/resource/baseUri domains — mirroring native
-     * mcp-use's server-origin enrichment — so widgets can reach the server
-     * origin without CSP violations. Without it (and without {@link csp}) the
-     * resource advertises no CSP, which ext-apps hosts treat as the secure
-     * "no network" default; fine for a fully inlined bundle.
-     */
-    baseUrl?: string;
-    /**
-     * Additional CSP origins advertised on the widget resource
-     * (`_meta.ui.csp`) and, snake_cased, on widget tools (`openai/widgetCSP`).
-     * Merged with the origin derived from {@link baseUrl}.
+     * Additional CSP origins advertised on the view resources (`_meta.ui.csp`,
+     * via each tool's `view.csp`) and, snake_cased, on widget tools
+     * (`openai/widgetCSP`). The server origin is appended by mcp-use itself at
+     * emission time, so this only needs third-party origins (e.g. a CDN).
      */
     csp?: AppResourceCsp;
 }
-/**
- * Merges the configured CSP with the server origin derived from `baseUrl`
- * (injected into connect/resource/baseUri domains, deduplicated) — the same
- * enrichment native mcp-use applies to its widget definitions. Returns
- * `undefined` when there is nothing to advertise.
- */
-export declare function buildAppResourceCsp(baseUrl: string | undefined, csp: AppResourceCsp | undefined): AppResourceCsp | undefined;
 /**
  * Registers the framework-level MCP tools that make up a Miranum-style MCP
- * app: the manifest tool, the `render-view` / `refresh-view` pair, the widget
- * bundle resource, plus any widget-action tools each plugin contributes.
+ * app: the manifest tool, the `render-view` / `refresh-view` pair, plus any
+ * widget-action tools each plugin contributes. `render-view` is bound to its
+ * own view ({@link RENDER_VIEW_NAME}); the view resource itself is emitted by
+ * mcp-use from the registry `createFrameworkApp` primes with the app bundle.
  *
  * Intended to be called from `createFrameworkApp`, but exposed directly so
  * consumers that build their own server can still opt into the framework
- * tools without the rest of the boot helper.
+ * tools without the rest of the boot helper — such consumers must prime the
+ * view registry themselves (see `createFrameworkApp`).
  */
 export declare function registerFrameworkTools(server: MCPServer, options: RegisterFrameworkToolsOptions): void;
 //# sourceMappingURL=register-framework-tools.d.ts.map

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":"AACA,OAAO,EAAyB,KAAK,SAAS,EAA4B,MAAM,gBAAgB,CAAA;AAKhG,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;AAG7D;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,kCAAkC;IAClC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAC1B;AAED,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,WAAW,EAAE,MAAM,CAAA;IACnB,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,GAAG,CAAC,EAAE,cAAc,CAAA;CACrB;AA+CD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,GAAG,EAAE,cAAc,GAAG,SAAS,GAC9B,cAAc,GAAG,SAAS,CAgB5B;AAYD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,6BAA6B,GACrC,IAAI,CAyGN"}
+{"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;AAoDD;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,6BAA6B,GACrC,IAAI,CAwFN"}

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

@@ -1,10 +1,11 @@
-import fs from "node:fs/promises";
-import { createMcpAppsResource, RESOURCE_MIME_TYPE, text } from "mcp-use/server";
 import { z } from "zod";
+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 { uiMeta } from "../types/meta.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";
 const stepRefSchema = z.object({
     id: z.string().describe("Context key under which the step's result is stored, e.g. 'invoice'."),
     step: z.string().describe("Registered step id, e.g. 'lexoffice:load-invoice'."),
@@ -29,36 +30,6 @@ function extractUserId(ctx) {
     const user = ctx?.auth?.user;
     return typeof user?.userId === "string" ? user.userId : undefined;
 }
-function withOrigin(list, origin) {
-    if (!list)
-        return [origin];
-    return list.includes(origin) ? list : [...list, origin];
-}
-/**
- * Merges the configured CSP with the server origin derived from `baseUrl`
- * (injected into connect/resource/baseUri domains, deduplicated) — the same
- * enrichment native mcp-use applies to its widget definitions. Returns
- * `undefined` when there is nothing to advertise.
- */
-export function buildAppResourceCsp(baseUrl, csp) {
-    let origin;
-    if (baseUrl) {
-        try {
-            origin = new URL(baseUrl).origin;
-        }
-        catch {
-            // Invalid baseUrl — skip origin injection rather than failing boot.
-        }
-    }
-    if (!origin)
-        return csp;
-    return {
-        ...csp,
-        connectDomains: withOrigin(csp?.connectDomains, origin),
-        resourceDomains: withOrigin(csp?.resourceDomains, origin),
-        baseUriDomains: withOrigin(csp?.baseUriDomains, origin),
-    };
-}
 /** Converts the camelCase resource CSP into the snake_cased `openai/widgetCSP` shape. */
 function toWidgetCspMeta(csp) {
     const meta = {};
@@ -74,17 +45,19 @@ function toWidgetCspMeta(csp) {
 }
 /**
  * Registers the framework-level MCP tools that make up a Miranum-style MCP
- * app: the manifest tool, the `render-view` / `refresh-view` pair, the widget
- * bundle resource, plus any widget-action tools each plugin contributes.
+ * app: the manifest tool, the `render-view` / `refresh-view` pair, plus any
+ * widget-action tools each plugin contributes. `render-view` is bound to its
+ * own view ({@link RENDER_VIEW_NAME}); the view resource itself is emitted by
+ * mcp-use from the registry `createFrameworkApp` primes with the app bundle.
  *
  * Intended to be called from `createFrameworkApp`, but exposed directly so
  * consumers that build their own server can still opt into the framework
- * tools without the rest of the boot helper.
+ * tools without the rest of the boot helper — such consumers must prime the
+ * view registry themselves (see `createFrameworkApp`).
  */
 export function registerFrameworkTools(server, options) {
-    const { stepRegistry, widgetRegistry, config, appConfigs, plugins, resourceUri, htmlPath, refreshToolName = "refresh-view", builderAvailable = false, baseUrl, csp, } = options;
-    const resourceCsp = buildAppResourceCsp(baseUrl, csp);
-    const widgetCSP = resourceCsp ? toWidgetCspMeta(resourceCsp) : undefined;
+    const { stepRegistry, widgetRegistry, config, appConfigs, plugins, refreshToolName = "refresh-view", builderAvailable = false, csp, } = options;
+    const widgetCSP = csp ? toWidgetCspMeta(csp) : undefined;
     server.tool({
         name: "get-framework-manifest",
         description: "Returns all active apps, available pipeline steps, widgets, and their key contracts. Call this first to discover which step-ids and widget-ids exist — and which `props` each widget accepts (see each widget's `propsSchema`) — before building a view.",
@@ -93,7 +66,7 @@ export function registerFrameworkTools(server, options) {
     // eslint-disable-next-line @typescript-eslint/require-await
     async () => {
         const manifest = getFrameworkManifest(stepRegistry, widgetRegistry, config);
-        return text(JSON.stringify(manifest, null, 2));
+        return textResult(JSON.stringify(manifest, null, 2));
     });
     const renderHandler = async (params, ctx) => {
         return renderView({
@@ -113,9 +86,18 @@ export function registerFrameworkTools(server, options) {
         name: "render-view",
         title: "Render View",
         description: "Builds a UI from pipeline steps and widgets. IMPORTANT: call get-framework-manifest first to learn which step-ids and widget-ids are available — only use ids listed there. Each widget entry's optional `propsSchema` (JSON Schema) describes the per-instance `props` you can set on a layout cell to scope or configure that widget (e.g. one tab per `processDefinitionKey`).",
-        schema: renderViewSchema,
-        _meta: uiMeta({
-            resourceUri,
+        inputSchema: renderViewSchema,
+        view: {
+            name: RENDER_VIEW_NAME,
+            description: "Interactive view composed of pipeline-driven widgets",
+            ...(csp ? { csp } : {}),
+        },
+        // The view envelope is dynamic (steps/layout are call-time arguments);
+        // `passthrough` satisfies the view binding's outputSchema requirement
+        // without stripping envelope keys on SDK-side validation.
+        outputSchema: z.object({}).passthrough(),
+        _meta: appsSdkMeta({
+            resourceUri: viewResourceUri(RENDER_VIEW_NAME),
             title: "Render View",
             invoking: "Rendering view...",
             invoked: "View rendered",
@@ -124,31 +106,17 @@ export function registerFrameworkTools(server, options) {
         }),
     }, renderHandler);
     for (const plugin of plugins) {
-        plugin.registerWidgetTools?.(server, resourceUri, { widgetCSP });
+        plugin.registerWidgetTools?.(server, { widgetCSP, viewCsp: csp });
     }
     server.tool({
         name: refreshToolName,
         title: "Refresh View",
         description: "Re-runs the pipeline with the stored parameters.",
-        schema: renderViewSchema,
-        _meta: uiMeta({ resourceUri, appOnly: true }),
+        inputSchema: renderViewSchema,
+        // App-only: called by the already-rendered view, never by the model —
+        // and no view binding, since its result replaces state inside the
+        // existing iframe rather than rendering a new one.
+        visibility: "app",
     }, renderHandler);
-    // The resource `_meta.ui.csp` must appear on the LISTING (resources/list)
-    // and on the READ contents — ext-apps hosts read it from the contents when
-    // sandboxing the iframe. `createMcpAppsResource` produces exactly the shape
-    // native mcp-use emits (mimeType `text/html;profile=mcp-app` + `_meta.ui`).
-    const resourceMeta = resourceCsp ? { ui: { csp: resourceCsp } } : undefined;
-    server.resource({
-        name: "mcp-app-html",
-        uri: resourceUri,
-        mimeType: RESOURCE_MIME_TYPE,
-        ...(resourceMeta ? { _meta: resourceMeta } : {}),
-    }, async () => {
-        // Read lazily per request so dev servers pick up a rebuilt bundle
-        // without a restart (same behaviour as before).
-        const html = await fs.readFile(htmlPath, "utf-8");
-        const uiResource = createMcpAppsResource(resourceUri, html, resourceCsp ? { csp: resourceCsp } : undefined);
-        return { contents: [uiResource.resource] };
-    });
 }
 //# sourceMappingURL=register-framework-tools.js.map

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,4 +1,4 @@
-import { type MCPServer } from "mcp-use/server";
+import { type MCPServer } from "mcp-use";
 import { z } from "zod";
 type ZodRawShape = Record<string, z.ZodTypeAny>;
 /**

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,EAAuB,MAAM,gBAAgB,CAAA;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,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;;EAmDhG"}
+{"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"}

package/dist/tools/register-tool.js

@@ -1,5 +1,5 @@
-import { array, object, text } from "mcp-use/server";
 import { z } from "zod";
+import { objectResult, textResult } from "./tool-results.js";
 import { withToolErrors } from "./with-tool-errors.js";
 function wrapArraySchema(schema) {
     if (!schema)
@@ -36,7 +36,7 @@ export function createToolRegistrar(server, client) {
         server.tool({
             name: config.name,
             description: config.description,
-            schema: config.inputSchema ? z.object(config.inputSchema) : undefined,
+            inputSchema: config.inputSchema ? z.object(config.inputSchema) : undefined,
             outputSchema: wrapArraySchema(config.outputSchema),
             annotations: config.annotations,
         }, 
@@ -46,7 +46,7 @@ export function createToolRegistrar(server, client) {
             const args = looseArgs;
             const result = await config.handler(client, args);
             if (config.formatResult) {
-                const formatted = text(config.formatResult(result, args));
+                const formatted = textResult(config.formatResult(result, args));
                 // When an outputSchema is declared the tool promised structured
                 // output, so mirror the raw result into structuredContent alongside
                 // the human-readable text instead of dropping it. Without an
@@ -57,10 +57,16 @@ export function createToolRegistrar(server, client) {
                 return formatted;
             }
             if (Array.isArray(result)) {
-                return array(result);
+                // Wrap here rather than delegating to mcp-use's `array()` helper.
+                // Up to 1.34 that helper produced `structuredContent: { data: [...] }`;
+                // the 2.x shim emits the bare array instead, which contradicts the
+                // `z.object({ data: <array> })` outputSchema `wrapArraySchema`
+                // declares — and MCP requires an object there regardless. Owning the
+                // wrap keeps the declared schema and the emitted payload in step.
+                return objectResult(toStructuredContent(result, config.name));
             }
             if (result !== null && typeof result === "object") {
-                return object(result);
+                return objectResult(result);
             }
             // A declared outputSchema requires an object `structuredContent`; a
             // scalar/null/undefined result would make the SDK reject the response
@@ -68,12 +74,12 @@ export function createToolRegistrar(server, client) {
             // (see toStructuredContent). Without an outputSchema, the text-only
             // fallbacks below are valid.
             if (config.outputSchema) {
-                return object(toStructuredContent(result, config.name));
+                return objectResult(toStructuredContent(result, config.name));
             }
             if (result !== null && result !== undefined) {
-                return text(JSON.stringify(result, null, 2));
+                return textResult(JSON.stringify(result, null, 2));
             }
-            return text("Success (no content returned)");
+            return textResult("Success (no content returned)");
         }));
     }
     register.getRegisteredTools = () => registeredTools;

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,4 +1,4 @@
-import { type MCPServer, type ToolAnnotations } from "mcp-use/server";
+import { type MCPServer, type ToolAnnotations } from "mcp-use";
 import { z } from "zod";
 import { type WidgetToolMetaDefaults } from "../types/meta.js";
 import type { ToolArgs } from "./register-tool.js";
@@ -8,11 +8,12 @@ interface WidgetToolResult {
     structuredContent: Record<string, unknown>;
 }
 /**
- * Tool visibility per SEP-1865 (`_meta.ui.visibility`). `"app"` hides the tool
- * from the LLM tool surface while keeping it callable from a widget; `"model"`
- * exposes it to the LLM. Pass an array to advertise both surfaces.
+ * Who may call or see the tool. `"app"` hides the tool from the LLM tool
+ * surface while keeping it callable from a widget (emitted natively by
+ * mcp-use as `_meta.ui.visibility: ["app"]`); `"model"` exposes it to the LLM
+ * and binds a view so the host renders its result.
  */
-export type WidgetToolVisibility = "app" | "model" | ("app" | "model")[];
+export type WidgetToolVisibility = "app" | "model";
 export interface WidgetToolConfig<TClient, TShape extends ZodRawShape = ZodRawShape> {
     name: string;
     title?: string;
@@ -21,15 +22,23 @@ export interface WidgetToolConfig<TClient, TShape extends ZodRawShape = ZodRawSh
     /** MCP tool annotations (e.g. `readOnlyHint`) advertised to the host. */
     annotations?: ToolAnnotations;
     /**
-     * SEP-1865 visibility. Defaults to `"app"` (the historical behaviour — widget
-     * tools are app-only). Use `"model"` to expose the tool to the LLM; in that
-     * case the `_meta.ui` carries only `{ resourceUri }` and no `visibility`.
+     * Defaults to `"app"` (the historical behaviour — widget tools are
+     * app-only). Use `"model"` for a widget-RENDERING tool: it is bound to its
+     * own view (named after the tool) and gets the Apps SDK `openai/*` keys.
      */
     visibility?: WidgetToolVisibility;
+    /**
+     * Structured-output schema. Model-visible (view-bound) tools require one —
+     * mcp-use refuses a `view` binding without it — so the registrar defaults
+     * to a passthrough object matching `WidgetToolResult.structuredContent`.
+     * Declare a precise schema to give hosts and view hooks typed output.
+     */
+    outputSchema?: z.ZodTypeAny;
     /**
      * Extra `_meta` entries merged flat into the emitted `_meta`, alongside the
-     * `ui` block this registrar builds. The `ui` key is reserved for the
-     * registrar; collisions are overwritten by the registrar's `ui`.
+     * `openai/*` block this registrar builds (collisions: the registrar wins).
+     * The `ui` namespace is owned by mcp-use (derived from `view`/`visibility`)
+     * and must not be stamped here.
      */
     meta?: Record<string, unknown>;
     /**
@@ -46,6 +55,21 @@ export interface WidgetToolConfig<TClient, TShape extends ZodRawShape = ZodRawSh
     invoked?: string;
     handler: (client: TClient, params: ToolArgs<TShape>) => Promise<WidgetToolResult>;
 }
-export declare function createWidgetToolRegistrar<TClient>(server: MCPServer, client: TClient, resourceUri: string, metaDefaults?: WidgetToolMetaDefaults): <TShape extends ZodRawShape = ZodRawShape>(config: WidgetToolConfig<TClient, TShape>) => void;
+/**
+ * Registrar for widget tools against mcp-use's native view binding.
+ *
+ * Model-visible tools are bound to a view named after the tool
+ * (`view: { name: <tool name> }`); mcp-use derives the MCP Apps wire keys
+ * (`_meta.ui.resourceUri`, flat `ui/resourceUri`) from that binding, and the
+ * registrar adds the Apps SDK `openai/*` keys pointing at the same resource
+ * (`viewResourceUri(<tool name>)`). App-only tools carry the native
+ * `visibility: "app"` and no view — their results feed an already-rendered
+ * widget via `callTool`.
+ *
+ * `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.
+ */
+export declare function createWidgetToolRegistrar<TClient>(server: MCPServer, client: TClient, metaDefaults?: WidgetToolMetaDefaults): <TShape extends ZodRawShape = ZodRawShape>(config: WidgetToolConfig<TClient, TShape>) => void;
 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,gBAAgB,CAAA;AACrE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAU,KAAK,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAEtE,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;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,OAAO,GAAG,CAAC,KAAK,GAAG,OAAO,CAAC,EAAE,CAAA;AAExE,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;;;;OAIG;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;AAYD,wBAAgB,yBAAyB,CAAC,OAAO,EAC/C,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,OAAO,EACf,WAAW,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,sBAAsB,IAEZ,MAAM,SAAS,WAAW,GAAG,WAAW,EAC/D,QAAQ,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,UAsC5C"}
+{"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"}

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

@@ -1,45 +1,72 @@
 import { z } from "zod";
-import { uiMeta } from "../types/meta.js";
+import { appsSdkMeta, viewResourceUri } from "../types/meta.js";
 import { withToolErrors } from "./with-tool-errors.js";
-/** Normalizes the {@link WidgetToolConfig.visibility} option into a flag set. */
-function resolveVisibility(visibility) {
-    const list = visibility === undefined ? ["app"] : Array.isArray(visibility) ? visibility : [visibility];
-    return { app: list.includes("app"), model: list.includes("model") };
-}
-export function createWidgetToolRegistrar(server, client, resourceUri, metaDefaults) {
+/**
+ * Registrar for widget tools against mcp-use's native view binding.
+ *
+ * Model-visible tools are bound to a view named after the tool
+ * (`view: { name: <tool name> }`); mcp-use derives the MCP Apps wire keys
+ * (`_meta.ui.resourceUri`, flat `ui/resourceUri`) from that binding, and the
+ * registrar adds the Apps SDK `openai/*` keys pointing at the same resource
+ * (`viewResourceUri(<tool name>)`). App-only tools carry the native
+ * `visibility: "app"` and no view — their results feed an already-rendered
+ * widget via `callTool`.
+ *
+ * `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.
+ */
+export function createWidgetToolRegistrar(server, client, metaDefaults) {
     return function register(config) {
-        const { app, model } = resolveVisibility(config.visibility);
-        // `"model"`-visible tools must not carry the app-only `visibility` marker so
-        // the LLM still sees them; otherwise mark app-only. The `resourceUri` is
-        // always present so the host knows which bundle renders the result.
-        // Model-visible tools additionally get the dual-protocol widget contract
-        // (flat `ui/resourceUri` + `openai/*` keys) ext-apps hosts key on.
-        const ui = uiMeta({
-            resourceUri,
-            appOnly: app && !model,
-            title: config.title ?? config.name,
-            invoking: config.invoking,
-            invoked: config.invoked,
-            widgetDescription: config.description,
-            widgetCSP: metaDefaults?.widgetCSP,
-        });
-        server.tool({
+        const model = config.visibility === "model";
+        const definition = {
             name: config.name,
             title: config.title,
             description: config.description,
-            schema: config.inputSchema ? z.object(config.inputSchema) : undefined,
+            inputSchema: config.inputSchema ? z.object(config.inputSchema) : undefined,
             annotations: config.annotations,
-            _meta: { ...config.meta, ...ui },
-        }, 
-        // The SDK validates params against the schema above, so the loose
-        // callback param is safely the handler's precise `ToolArgs<TShape>`.
-        withToolErrors(async (looseParams) => {
+        };
+        const callback = withToolErrors(async (looseParams) => {
+            // The SDK validates params against the schema above, so the loose
+            // callback param is safely the handler's precise `ToolArgs<TShape>`.
             const result = await config.handler(client, looseParams);
             return {
                 content: [{ type: "text", text: result.text }],
                 structuredContent: result.structuredContent,
             };
-        }));
+        });
+        if (!model) {
+            server.tool({
+                ...definition,
+                visibility: "app",
+                outputSchema: config.outputSchema,
+                ...(config.meta ? { _meta: config.meta } : {}),
+            }, callback);
+            return;
+        }
+        server.tool({
+            ...definition,
+            view: {
+                name: config.name,
+                description: config.description,
+                ...(metaDefaults?.viewCsp ? { csp: metaDefaults.viewCsp } : {}),
+            },
+            // A view binding requires an outputSchema; `passthrough` matches the
+            // free-form `WidgetToolResult.structuredContent` without stripping
+            // keys on SDK-side validation.
+            outputSchema: config.outputSchema ?? z.object({}).passthrough(),
+            _meta: {
+                ...config.meta,
+                ...appsSdkMeta({
+                    resourceUri: viewResourceUri(config.name),
+                    title: config.title ?? config.name,
+                    invoking: config.invoking,
+                    invoked: config.invoked,
+                    widgetDescription: config.description,
+                    widgetCSP: metaDefaults?.widgetCSP,
+                }),
+            },
+        }, callback);
     };
 }
 //# sourceMappingURL=register-widget-tool.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"register-widget-tool.js","sourceRoot":"","sources":["../../src/tools/register-widget-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,MAAM,EAA+B,MAAM,kBAAkB,CAAA;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAsDtD,iFAAiF;AACjF,SAAS,iBAAiB,CAAC,UAA4C;IAIrE,MAAM,IAAI,GACR,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;IAC5F,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAA;AACrE,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,MAAiB,EACjB,MAAe,EACf,WAAmB,EACnB,YAAqC;IAErC,OAAO,SAAS,QAAQ,CACtB,MAAyC;QAEzC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,iBAAiB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;QAC3D,6EAA6E;QAC7E,yEAAyE;QACzE,oEAAoE;QACpE,yEAAyE;QACzE,mEAAmE;QACnE,MAAM,EAAE,GAAG,MAAM,CAAC;YAChB,WAAW;YACX,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK;YACtB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI;YAClC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,iBAAiB,EAAE,MAAM,CAAC,WAAW;YACrC,SAAS,EAAE,YAAY,EAAE,SAAS;SACnC,CAAC,CAAA;QAEF,MAAM,CAAC,IAAI,CACT;YACE,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS;YACrE,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,KAAK,EAAE,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;SACjC;QACD,kEAAkE;QAClE,qEAAqE;QACrE,cAAc,CAAC,KAAK,EAAE,WAA0B,EAAE,EAAE;YAClD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,WAA+B,CAAC,CAAA;YAC5E,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;gBACvD,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;aAC5C,CAAA;QACH,CAAC,CAAC,CACH,CAAA;IACH,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"register-widget-tool.js","sourceRoot":"","sources":["../../src/tools/register-widget-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,WAAW,EAAE,eAAe,EAA+B,MAAM,kBAAkB,CAAA;AAC5F,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AA+DtD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAiB,EACjB,MAAe,EACf,YAAqC;IAErC,OAAO,SAAS,QAAQ,CACtB,MAAyC;QAEzC,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,KAAK,OAAO,CAAA;QAC3C,MAAM,UAAU,GAAG;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS;YAC1E,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC,CAAA;QAED,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,EAAE,WAA0B,EAAE,EAAE;YACnE,kEAAkE;YAClE,qEAAqE;YACrE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,WAA+B,CAAC,CAAA;YAC5E,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;gBACvD,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;aAC5C,CAAA;QACH,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,CACT;gBACE,GAAG,UAAU;gBACb,UAAU,EAAE,KAAK;gBACjB,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/C,EACD,QAAQ,CACT,CAAA;YACD,OAAM;QACR,CAAC;QAED,MAAM,CAAC,IAAI,CACT;YACE,GAAG,UAAU;YACb,IAAI,EAAE;gBACJ,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAChE;YACD,qEAAqE;YACrE,mEAAmE;YACnE,+BAA+B;YAC/B,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE;YAC/D,KAAK,EAAE;gBACL,GAAG,MAAM,CAAC,IAAI;gBACd,GAAG,WAAW,CAAC;oBACb,WAAW,EAAE,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC;oBACzC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI;oBAClC,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,iBAAiB,EAAE,MAAM,CAAC,WAAW;oBACrC,SAAS,EAAE,YAAY,EAAE,SAAS;iBACnC,CAAC;aACH;SACF,EACD,QAAQ,CACT,CAAA;IACH,CAAC,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,46 @@
+/**
+ * Toolkit-owned `CallToolResult` builders, byte-for-byte equivalent to the
+ * mcp-use v1 response helpers (`text` / `object` / `error`) the registrars
+ * used to import. The v2 migration guide deprecates those helpers in favour
+ * of raw result structures; owning the three shapes the toolkit actually
+ * emits keeps the wire output identical across the swap and survives their
+ * eventual upstream removal.
+ */
+/** A plain-text tool result (`text/plain` mime hint), as mcp-use's `text()` emitted. */
+export declare function textResult(content: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    _meta: {
+        mimeType: string;
+    };
+};
+/**
+ * An object tool result: pretty-printed JSON text plus `structuredContent`,
+ * as mcp-use's `object()` emitted for non-array payloads (the registrars wrap
+ * arrays into `{ data }` before calling this — see `toStructuredContent`).
+ */
+export declare function objectResult<T extends Record<string, unknown>>(data: T): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: T;
+    _meta: {
+        mimeType: string;
+    };
+};
+/**
+ * An error tool result. The literal `isError: true` matters: tools with an
+ * `outputSchema` (every view-bound tool) have a callback type demanding
+ * either matching `structuredContent` or an explicit `isError: true` result.
+ */
+export declare function errorResult(message: string): {
+    isError: true;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+//# sourceMappingURL=tool-results.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-results.d.ts","sourceRoot":"","sources":["../../src/tools/tool-results.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM;;;;;;;;EAKzC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC;;;;;;;;;EAMtE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM;;;;;;EAK1C"}