@miragon/mcp-toolkit-core 0.10.1

package/dist/framework/layout-types.js

@@ -0,0 +1,7 @@
+/** Normalizes any layout format to the canonical union type (rows or tabs object). */
+export function normalizeLayout(layout) {
+    if (Array.isArray(layout))
+        return { rows: layout };
+    return layout;
+}
+//# sourceMappingURL=layout-types.js.map

package/dist/framework/layout-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-types.js","sourceRoot":"","sources":["../../src/framework/layout-types.ts"],"names":[],"mappings":"AASA,sFAAsF;AACtF,MAAM,UAAU,eAAe,CAC7B,MAAoB;IAEpB,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IAClD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/framework/manifest.d.ts

@@ -0,0 +1,65 @@
+import type { StepRegistry } from "../registry/step-registry.js";
+import type { WidgetRegistry } from "../registry/widget-registry.js";
+import type { OptionalKeyDeclaration } from "../types/step.js";
+import type { AppConfig } from "../types/config.js";
+export interface FrameworkManifest {
+    activeApps: string[];
+    steps: {
+        id: string;
+        app: string;
+        /** One-line description of what the step does. */
+        description?: string;
+        dataType: string;
+        requires: string[];
+        /**
+         * Keys the step reads opportunistically (scoping/filter inputs) but does
+         * not strictly need. Mirrors `PipelineStepDefinition.optionalKeys`.
+         */
+        optionalKeys?: OptionalKeyDeclaration[];
+        produces: string[];
+    }[];
+    widgets: {
+        id: string;
+        app: string;
+        /** One-line description of what the widget shows. */
+        description?: string;
+        requires: string[];
+        /**
+         * Step `dataType`s the widget can render. Pair with `steps[].dataType`
+         * to find which step populates this widget.
+         */
+        consumes?: string[];
+        size: string;
+        /**
+         * JSON Schema for the per-instance props the widget accepts via a
+         * layout cell's `props` field. Omitted for widgets that take no
+         * per-instance props. Same JSON-Schema contract the LLM already
+         * understands from MCP tool input schemas, so it can construct scoped
+         * views (e.g. one tab per `processDefinitionKey`) without guessing.
+         */
+        propsSchema?: Record<string, unknown>;
+    }[];
+    pipelines: {
+        id: string;
+        steps: {
+            id: string;
+            step: string;
+            optional?: boolean;
+        }[];
+    }[];
+    keyContracts: {
+        key: string;
+        producedBy: string[];
+        consumedBy: string[];
+        optionallyConsumedBy: string[];
+    }[];
+}
+/**
+ * Produces a JSON-serializable manifest of everything the framework currently
+ * knows about: active apps, registered pipeline steps, available widgets, and
+ * the key contracts derived from step `requires`/`produces`. Consumers expose
+ * this via a `get-framework-manifest` tool so the LLM can learn what is
+ * composable via `render-view`.
+ */
+export declare function getFrameworkManifest(stepRegistry: StepRegistry, widgetRegistry: WidgetRegistry, config: AppConfig): FrameworkManifest;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/framework/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/framework/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AACpE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAEnD,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,KAAK,EAAE;QACL,EAAE,EAAE,MAAM,CAAA;QACV,GAAG,EAAE,MAAM,CAAA;QACX,kDAAkD;QAClD,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,QAAQ,EAAE,MAAM,CAAA;QAChB,QAAQ,EAAE,MAAM,EAAE,CAAA;QAClB;;;WAGG;QACH,YAAY,CAAC,EAAE,sBAAsB,EAAE,CAAA;QACvC,QAAQ,EAAE,MAAM,EAAE,CAAA;KACnB,EAAE,CAAA;IACH,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAA;QACV,GAAG,EAAE,MAAM,CAAA;QACX,qDAAqD;QACrD,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,QAAQ,EAAE,MAAM,EAAE,CAAA;QAClB;;;WAGG;QACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;QACnB,IAAI,EAAE,MAAM,CAAA;QACZ;;;;;;WAMG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACtC,EAAE,CAAA;IACH,SAAS,EAAE;QACT,EAAE,EAAE,MAAM,CAAA;QACV,KAAK,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;SAAE,EAAE,CAAA;KAC1D,EAAE,CAAA;IACH,YAAY,EAAE;QACZ,GAAG,EAAE,MAAM,CAAA;QACX,UAAU,EAAE,MAAM,EAAE,CAAA;QACpB,UAAU,EAAE,MAAM,EAAE,CAAA;QACpB,oBAAoB,EAAE,MAAM,EAAE,CAAA;KAC/B,EAAE,CAAA;CACJ;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,cAAc,EAC9B,MAAM,EAAE,SAAS,GAChB,iBAAiB,CAiCnB"}

package/dist/framework/manifest.js

@@ -0,0 +1,47 @@
+/**
+ * Produces a JSON-serializable manifest of everything the framework currently
+ * knows about: active apps, registered pipeline steps, available widgets, and
+ * the key contracts derived from step `requires`/`produces`. Consumers expose
+ * this via a `get-framework-manifest` tool so the LLM can learn what is
+ * composable via `render-view`.
+ */
+export function getFrameworkManifest(stepRegistry, widgetRegistry, config) {
+    return {
+        activeApps: config.activeApps.map((a) => a.app),
+        steps: stepRegistry.getAll().map((step) => ({
+            id: step.id,
+            app: appOf(step.id),
+            ...(step.description ? { description: step.description } : {}),
+            dataType: step.dataType,
+            requires: step.requires,
+            ...(step.optionalKeys && step.optionalKeys.length > 0
+                ? { optionalKeys: step.optionalKeys }
+                : {}),
+            produces: step.produces,
+        })),
+        widgets: widgetRegistry.getAll().map((widget) => ({
+            id: widget.id,
+            app: appOf(widget.id),
+            ...(widget.description ? { description: widget.description } : {}),
+            requires: widget.requires,
+            ...(widget.consumes && widget.consumes.length > 0 ? { consumes: widget.consumes } : {}),
+            size: widget.size,
+            ...(widget.propsSchema ? { propsSchema: widget.propsSchema } : {}),
+        })),
+        pipelines: Object.entries(config.pipelines).map(([id, pipeline]) => ({
+            id,
+            steps: pipeline.steps ?? [],
+        })),
+        keyContracts: stepRegistry.getKeyContracts(),
+    };
+}
+/**
+ * Splits a namespaced id like `"lexoffice:load-invoice"` into the
+ * leading namespace. Falls back to the full id if no colon is present
+ * (i.e. a malformed id) so callers always get a non-empty string.
+ */
+function appOf(id) {
+    const colon = id.indexOf(":");
+    return colon >= 0 ? id.slice(0, colon) : id;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/framework/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/framework/manifest.ts"],"names":[],"mappings":"AAsDA;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,YAA0B,EAC1B,cAA8B,EAC9B,MAAiB;IAEjB,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAE/C,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC1C,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACnB,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;gBACnD,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE;gBACrC,CAAC,CAAC,EAAE,CAAC;YACP,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;QAEH,OAAO,EAAE,cAAc,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAChD,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YACrB,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClE,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvF,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC,CAAC;QAEH,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;YACnE,EAAE;YACF,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,EAAE;SAC5B,CAAC,CAAC;QAEH,YAAY,EAAE,YAAY,CAAC,eAAe,EAAE;KAC7C,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,KAAK,CAAC,EAAU;IACvB,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAC7B,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AAC7C,CAAC"}

package/dist/framework/render-view.d.ts

@@ -0,0 +1,53 @@
+import { type PipelineExecutionContext } from "../engine/pipeline-executor.js";
+import type { StepRegistry } from "../registry/step-registry.js";
+import type { PipelineStepRef } from "../types/pipeline.js";
+import type { ViewStructuredContent } from "../types/view-data.js";
+import type { LayoutConfig } from "./layout-types.js";
+export interface RenderViewInput {
+    keys?: Record<string, unknown>;
+    steps?: PipelineStepRef[];
+    layout: LayoutConfig;
+    title?: string;
+}
+export interface RenderViewOptions {
+    input: RenderViewInput;
+    stepRegistry: StepRegistry;
+    appConfigs?: Record<string, Record<string, unknown>>;
+    /**
+     * Per-request context (currently: the calling userId) that the pipeline
+     * executor uses to pre-bind user-scoped `callTool` closures on step
+     * `appConfig`s. Pass it through from the tool handler's
+     * `ctx.auth?.user?.userId`.
+     */
+    ctx?: PipelineExecutionContext;
+    /**
+     * Whether the in-iframe visual builder is usable on this server (i.e.
+     * `app.builder` is on and `get-builder-catalogue` is registered). Echoed
+     * into `structuredContent.builderAvailable` so the `McpAppView` shell shows
+     * its Build affordance only when the builder can actually be serviced.
+     * Defaults to `false` — `createFrameworkApp` passes the real value through
+     * from `options.app.builder`.
+     */
+    builderAvailable?: boolean;
+}
+/**
+ * Executes a pipeline of steps to populate the keys map and returns a payload
+ * ready to be embedded into an MCP App widget. The resulting `structuredContent`
+ * is consumed by the `McpAppView` component in `@miragon/mcp-toolkit-ui`.
+ */
+export declare function renderView(options: RenderViewOptions): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+    structuredContent?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: ViewStructuredContent;
+    isError?: undefined;
+}>;
+//# sourceMappingURL=render-view.d.ts.map

package/dist/framework/render-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-view.d.ts","sourceRoot":"","sources":["../../src/framework/render-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,wBAAwB,EAAE,MAAM,gCAAgC,CAAA;AAE/F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,KAAK,CAAC,EAAE,eAAe,EAAE,CAAA;IACzB,MAAM,EAAE,YAAY,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,eAAe,CAAA;IACtB,YAAY,EAAE,YAAY,CAAA;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACpD;;;;;OAKG;IACH,GAAG,CAAC,EAAE,wBAAwB,CAAA;IAC9B;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB;;;;;;;;;;;;;;GAuE1D"}

package/dist/framework/render-view.js

@@ -0,0 +1,73 @@
+import { executePipeline } from "../engine/pipeline-executor.js";
+import { validatePipeline } from "../engine/context-builder.js";
+/**
+ * Executes a pipeline of steps to populate the keys map and returns a payload
+ * ready to be embedded into an MCP App widget. The resulting `structuredContent`
+ * is consumed by the `McpAppView` component in `@miragon/mcp-toolkit-ui`.
+ */
+export async function renderView(options) {
+    const { input, stepRegistry, appConfigs, ctx, builderAvailable } = options;
+    const initialKeys = input.keys ?? {};
+    const pipelineConfig = { steps: input.steps };
+    if (input.steps?.length) {
+        const validation = validatePipeline(pipelineConfig, stepRegistry, Object.keys(initialKeys));
+        if (!validation.valid) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Pipeline validation failed: ${validation.issues.join("; ")}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    const context = await executePipeline({
+        config: pipelineConfig,
+        initialKeys,
+        registry: stepRegistry,
+        appConfigs,
+        ctx,
+    });
+    const textSummary = [
+        input.title ?? "View",
+        `Steps: ${Object.keys(context.steps).join(", ") || "none"}`,
+        `Keys: ${Object.keys(context.keys).join(", ")}`,
+        context.errors.length > 0
+            ? `Errors: ${context.errors.map((e) => `${e.stepId}: ${e.reason}`).join("; ")}`
+            : "",
+    ]
+        .filter(Boolean)
+        .join("\n");
+    const structuredContent = {
+        _refreshParams: {
+            keys: input.keys,
+            steps: input.steps,
+            layout: input.layout,
+            title: input.title,
+        },
+        title: input.title,
+        context: {
+            keys: context.keys,
+            stepIds: Object.keys(context.steps),
+            stepData: Object.fromEntries(Object.entries(context.steps).map(([id, result]) => [
+                id,
+                {
+                    data: result.data,
+                    keys: result.keys,
+                    _app: result._app,
+                    _dataType: result._dataType,
+                },
+            ])),
+            errors: context.errors,
+        },
+        layout: input.layout,
+        builderAvailable: builderAvailable ?? false,
+    };
+    return {
+        content: [{ type: "text", text: textSummary }],
+        structuredContent,
+    };
+}
+//# sourceMappingURL=render-view.js.map

package/dist/framework/render-view.js.map

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

package/dist/framework/view-builders.d.ts

@@ -0,0 +1,79 @@
+import type { LayoutConfig } from "./layout-types.js";
+import type { ViewStructuredContent } from "../types/view-data.js";
+export interface SingleWidgetViewInput {
+    widget: string;
+    app: string;
+    dataType: string;
+    data: unknown;
+    title?: string;
+    /**
+     * Short model-facing summary emitted on the text channel (1-2 sentences,
+     * e.g. "Process list: 12 definitions matching ..."). The full data payload
+     * lives only in `structuredContent` — never put bulky data (BPMN XML, row
+     * arrays) in the summary. Falls back to a generic one-liner derived from
+     * the widget type and an item count when omitted.
+     */
+    summary?: string;
+}
+export interface ComposedViewEntry {
+    /** Stable id used as the step result key (must be unique within the view). */
+    id?: string;
+    /** Step `_dataType` widgets resolve through `adaptDataWidget`. */
+    dataType: string;
+    /** Eager data payload — same shape the matching widget expects. */
+    data: unknown;
+}
+export interface ComposedViewInput {
+    app: string;
+    layout: LayoutConfig;
+    entries: ComposedViewEntry[];
+    title?: string;
+    /** Same contract as {@link SingleWidgetViewInput.summary}. */
+    summary?: string;
+}
+/** Shape both view builders return — the `McpAppView` envelope plus a summary. */
+export interface ViewToolResult {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: ViewStructuredContent;
+}
+/**
+ * Best-effort item count for the generic fallback summary: array length or a
+ * conventional `totalCount`/`total` field. Returns null when not derivable.
+ */
+export declare function deriveItemCount(data: unknown): number | null;
+/**
+ * Generic model-facing summary used when a caller omits `summary`. Names the
+ * view (its `title`, or the widget ids) and appends a derivable item count.
+ */
+export declare function defaultSummary(widgets: string[], data: unknown, title?: string): string;
+/** Widget ids across all three LayoutConfig variants (rows array, rows object, tabs). */
+export declare function collectLayoutWidgets(layout: LayoutConfig): string[];
+/**
+ * Multi-widget variant of {@link buildSingleWidgetView}. Lets `*_show_*` tools
+ * compose several small widgets into a layout while keeping the eager
+ * (no-pipeline) execution model: each widget resolves its slice through
+ * `adaptDataWidget` by `_dataType`. Widgets that share a `dataType` all
+ * receive the same data object and are expected to render their own slice.
+ *
+ * The text channel carries only the model-facing `summary`; the data payload
+ * lives in `structuredContent.context.stepData`. In-widget refresh callers
+ * must therefore parse results structuredContent-first (the toolkit's
+ * text-first `useToolQuery` would only see the summary string).
+ */
+export declare function buildComposedView(input: ComposedViewInput): ViewToolResult;
+/**
+ * Builds an MCP tool result that renders a single widget through the same
+ * `McpAppView` shell as `render-view`. Use this from `*_show_*` tools that
+ * compute their data eagerly (no pipeline) — the widget data is exposed under
+ * `context.stepData["result"]` with the given `_dataType`, so the registry
+ * adapter (`adaptDataWidget`) can route it to the right widget component.
+ *
+ * The text channel carries only the model-facing `summary` (the model never
+ * needs the rendered payload); the data lives in `structuredContent`.
+ * In-widget refresh callers parse structuredContent-first.
+ */
+export declare function buildSingleWidgetView(input: SingleWidgetViewInput): ViewToolResult;
+//# sourceMappingURL=view-builders.d.ts.map

package/dist/framework/view-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-builders.d.ts","sourceRoot":"","sources":["../../src/framework/view-builders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAElE,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,8EAA8E;IAC9E,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAA;IAChB,mEAAmE;IACnE,IAAI,EAAE,OAAO,CAAA;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,YAAY,CAAA;IACpB,OAAO,EAAE,iBAAiB,EAAE,CAAA;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACzC,iBAAiB,EAAE,qBAAqB,CAAA;CACzC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAQ5D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAKvF;AAED,yFAAyF;AACzF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAOnE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,cAAc,CA8B1E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,qBAAqB,GAAG,cAAc,CAuBlF"}

package/dist/framework/view-builders.js

@@ -0,0 +1,113 @@
+/**
+ * Best-effort item count for the generic fallback summary: array length or a
+ * conventional `totalCount`/`total` field. Returns null when not derivable.
+ */
+export function deriveItemCount(data) {
+    if (Array.isArray(data))
+        return data.length;
+    if (data && typeof data === "object") {
+        const d = data;
+        if (typeof d.totalCount === "number")
+            return d.totalCount;
+        if (typeof d.total === "number")
+            return d.total;
+    }
+    return null;
+}
+/**
+ * Generic model-facing summary used when a caller omits `summary`. Names the
+ * view (its `title`, or the widget ids) and appends a derivable item count.
+ */
+export function defaultSummary(widgets, data, title) {
+    const label = title ?? widgets.join(", ");
+    const count = deriveItemCount(data);
+    const countSuffix = count === null ? "" : ` (${count} item${count === 1 ? "" : "s"})`;
+    return `Rendered widget "${label}"${countSuffix}. Full data is shown in the widget.`;
+}
+/** Widget ids across all three LayoutConfig variants (rows array, rows object, tabs). */
+export function collectLayoutWidgets(layout) {
+    const rows = Array.isArray(layout)
+        ? layout
+        : "rows" in layout
+            ? layout.rows
+            : layout.tabs.flatMap((tab) => tab.rows);
+    return rows.flatMap((row) => row.row.map((cell) => cell.widget));
+}
+/**
+ * Multi-widget variant of {@link buildSingleWidgetView}. Lets `*_show_*` tools
+ * compose several small widgets into a layout while keeping the eager
+ * (no-pipeline) execution model: each widget resolves its slice through
+ * `adaptDataWidget` by `_dataType`. Widgets that share a `dataType` all
+ * receive the same data object and are expected to render their own slice.
+ *
+ * The text channel carries only the model-facing `summary`; the data payload
+ * lives in `structuredContent.context.stepData`. In-widget refresh callers
+ * must therefore parse results structuredContent-first (the toolkit's
+ * text-first `useToolQuery` would only see the summary string).
+ */
+export function buildComposedView(input) {
+    const stepData = {};
+    const stepIds = [];
+    for (const [idx, entry] of input.entries.entries()) {
+        const id = entry.id ?? `result_${idx}`;
+        stepIds.push(id);
+        stepData[id] = {
+            data: entry.data,
+            keys: {},
+            _app: input.app,
+            _dataType: entry.dataType,
+        };
+    }
+    const widgets = collectLayoutWidgets(input.layout);
+    const summary = input.summary ??
+        defaultSummary(widgets, input.entries.length === 1 ? input.entries[0].data : null, input.title);
+    return {
+        content: [{ type: "text", text: summary }],
+        structuredContent: {
+            title: input.title,
+            context: {
+                keys: {},
+                stepIds,
+                stepData,
+                errors: [],
+            },
+            layout: input.layout,
+        },
+    };
+}
+/**
+ * Builds an MCP tool result that renders a single widget through the same
+ * `McpAppView` shell as `render-view`. Use this from `*_show_*` tools that
+ * compute their data eagerly (no pipeline) — the widget data is exposed under
+ * `context.stepData["result"]` with the given `_dataType`, so the registry
+ * adapter (`adaptDataWidget`) can route it to the right widget component.
+ *
+ * The text channel carries only the model-facing `summary` (the model never
+ * needs the rendered payload); the data lives in `structuredContent`.
+ * In-widget refresh callers parse structuredContent-first.
+ */
+export function buildSingleWidgetView(input) {
+    const layout = [{ row: [{ widget: input.widget }] }];
+    const summary = input.summary ?? defaultSummary([input.widget], input.data, input.title);
+    return {
+        content: [{ type: "text", text: summary }],
+        structuredContent: {
+            title: input.title,
+            context: {
+                keys: {},
+                stepIds: ["result"],
+                stepData: {
+                    result: {
+                        data: input.data,
+                        keys: {},
+                        _app: input.app,
+                        _dataType: input.dataType,
+                    },
+                },
+                errors: [],
+            },
+            layout,
+        },
+    };
+}
+//# sourceMappingURL=view-builders.js.map

package/dist/framework/view-builders.js.map

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

package/dist/i18n/index.d.ts

@@ -0,0 +1,3 @@
+export { createTranslator } from "./translator.js";
+export type { Message, MessageCatalog, Catalogs, Translate, CreateTranslatorOptions, } from "./translator.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/i18n/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,YAAY,EACV,OAAO,EACP,cAAc,EACd,QAAQ,EACR,SAAS,EACT,uBAAuB,GACxB,MAAM,iBAAiB,CAAA"}

package/dist/i18n/index.js

@@ -0,0 +1,6 @@
+// Localization engine. Browser-safe (pure data + functions, no `node:*`, no
+// `mcp-use/*`), so it is re-exported from the core root barrel and shared by the
+// server (tool summaries) and the UI (widget strings). Ships no catalogs — the
+// consuming app provides its own and decides where the active locale comes from.
+export { createTranslator } from "./translator.js";
+//# sourceMappingURL=index.js.map

package/dist/i18n/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,iFAAiF;AACjF,+EAA+E;AAC/E,iFAAiF;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/i18n/translator.d.ts

@@ -0,0 +1,59 @@
+/**
+ * A minimal, dependency-free translation engine shared by the server (tool
+ * summaries / messages) and the UI (widget strings). It deliberately ships *no*
+ * catalogs — a consuming app provides its own message catalogs and decides where
+ * the active locale comes from (a header, a user profile, a session store …).
+ *
+ * Browser-bundle-safe: pure data + functions, no `node:*` and no `mcp-use/*`, so
+ * it ships from the core root barrel and runs in a widget bundle and on the
+ * server alike.
+ */
+/**
+ * A single message. Either:
+ * - a string, optionally with `{name}` placeholders interpolated from params
+ *   (e.g. `"{count} open incidents"`), or
+ * - a function of the params, for logic a template can't express (plurals,
+ *   conditionals).
+ *
+ * Strings keep catalogs pure data (JSON-serialisable); reach for a function only
+ * when interpolation isn't enough.
+ */
+export type Message = string | ((params: Record<string, unknown>) => string);
+/** One locale's messages, keyed by a dotted message key (e.g. `"engine.list.empty"`). */
+export type MessageCatalog = Record<string, Message>;
+/** Per-locale catalogs, keyed by a locale tag (e.g. `"en"`, `"de"`). */
+export type Catalogs = Record<string, MessageCatalog>;
+/** Resolves a message for an explicit locale. */
+export type Translate = (locale: string, key: string, params?: Record<string, unknown>) => string;
+export interface CreateTranslatorOptions {
+    /**
+     * Locale used when the requested locale has no catalog, or has a catalog but
+     * not the requested key. Defaults to `"en"`.
+     */
+    fallbackLocale?: string;
+}
+/**
+ * Build a {@link Translate} over the given catalogs. Resolution falls back in a
+ * fixed chain so a partial translation degrades predictably rather than
+ * crashing:
+ *
+ *   requested locale → fallback locale → the key itself
+ *
+ * Returning the key for a wholly-unknown message keeps a missing translation
+ * visible (and greppable) in development instead of rendering an empty string.
+ *
+ * @example
+ * const t = createTranslator({
+ *   en: { "greeting": ({ name }) => `Hello, ${name}` },
+ *   de: { "greeting": ({ name }) => `Hallo, ${name}` },
+ * })
+ * t("de", "greeting", { name: "Ada" }) // "Hallo, Ada"
+ * t("fr", "greeting", { name: "Ada" }) // "Hello, Ada" (fallback)
+ * t("de", "missing")                   // "missing"     (key passthrough)
+ *
+ * // String templates interpolate `{name}` placeholders from params:
+ * const u = createTranslator({ en: { hi: "Hi {name}, {n} new" } })
+ * u("en", "hi", { name: "Ada", n: 3 })  // "Hi Ada, 3 new"
+ */
+export declare function createTranslator(catalogs: Catalogs, options?: CreateTranslatorOptions): Translate;
+//# sourceMappingURL=translator.d.ts.map

package/dist/i18n/translator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translator.d.ts","sourceRoot":"","sources":["../../src/i18n/translator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;;GASG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,CAAA;AAE5E,yFAAyF;AACzF,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEpD,wEAAwE;AACxE,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;AAErD,iDAAiD;AACjD,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAA;AAEjG,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,uBAA4B,GACpC,SAAS,CAYX"}

package/dist/i18n/translator.js

@@ -0,0 +1,48 @@
+/**
+ * A minimal, dependency-free translation engine shared by the server (tool
+ * summaries / messages) and the UI (widget strings). It deliberately ships *no*
+ * catalogs — a consuming app provides its own message catalogs and decides where
+ * the active locale comes from (a header, a user profile, a session store …).
+ *
+ * Browser-bundle-safe: pure data + functions, no `node:*` and no `mcp-use/*`, so
+ * it ships from the core root barrel and runs in a widget bundle and on the
+ * server alike.
+ */
+/**
+ * Build a {@link Translate} over the given catalogs. Resolution falls back in a
+ * fixed chain so a partial translation degrades predictably rather than
+ * crashing:
+ *
+ *   requested locale → fallback locale → the key itself
+ *
+ * Returning the key for a wholly-unknown message keeps a missing translation
+ * visible (and greppable) in development instead of rendering an empty string.
+ *
+ * @example
+ * const t = createTranslator({
+ *   en: { "greeting": ({ name }) => `Hello, ${name}` },
+ *   de: { "greeting": ({ name }) => `Hallo, ${name}` },
+ * })
+ * t("de", "greeting", { name: "Ada" }) // "Hallo, Ada"
+ * t("fr", "greeting", { name: "Ada" }) // "Hello, Ada" (fallback)
+ * t("de", "missing")                   // "missing"     (key passthrough)
+ *
+ * // String templates interpolate `{name}` placeholders from params:
+ * const u = createTranslator({ en: { hi: "Hi {name}, {n} new" } })
+ * u("en", "hi", { name: "Ada", n: 3 })  // "Hi Ada, 3 new"
+ */
+export function createTranslator(catalogs, options = {}) {
+    const fallbackLocale = options.fallbackLocale ?? "en";
+    return (locale, key, params) => {
+        const message = catalogs[locale]?.[key] ?? catalogs[fallbackLocale]?.[key];
+        if (message === undefined)
+            return key;
+        if (typeof message === "function")
+            return message(params ?? {});
+        if (!params)
+            return message;
+        // Interpolate `{name}` placeholders; leave unknown ones untouched.
+        return message.replace(/\{(\w+)\}/g, (whole, name) => name in params ? String(params[name]) : whole);
+    };
+}
+//# sourceMappingURL=translator.js.map

package/dist/i18n/translator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translator.js","sourceRoot":"","sources":["../../src/i18n/translator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA+BH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAkB,EAClB,UAAmC,EAAE;IAErC,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,IAAI,CAAA;IACrD,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE;QAC7B,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;QAC1E,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,GAAG,CAAA;QACrC,IAAI,OAAO,OAAO,KAAK,UAAU;YAAE,OAAO,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAA;QAC/D,IAAI,CAAC,MAAM;YAAE,OAAO,OAAO,CAAA;QAC3B,mEAAmE;QACnE,OAAO,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE,CAC3D,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAC9C,CAAA;IACH,CAAC,CAAA;AACH,CAAC"}