@miragon/pulse-widget-shell 0.24.2 → 0.25.0

package/dist/server-locale.js

@@ -1,64 +0,0 @@
-import { resolveProfileKey } from "./profile.js";
-import { readProfileAdvisory } from "./profile-advisory.js";
-import { explicitLocale } from "./profile-constants.js";
-/**
- * Resolve the active locale for the in-flight request from the user profile
- * (`resolveProfileKey` → `language`), falling back to English — also for the
- * `system` preference: the host locale it follows is a widget-side signal
- * (`hostContext.locale`) the server never sees. Pass the
- * tool-handler `ctx` so the lookup resolves the caller exactly like the save
- * path (`resolveProfileKey`: the OAuth caller from `ctx`) — without it, only
- * the ambient request info can name the caller.
- *
- * Fail-soft on every axis — no store, no key, or a store OUTAGE: with
- * `DATABASE_URL` the store is a network call, and this runs as the first
- * `await` of many widget tools — a Postgres hiccup must degrade the summary to
- * English, never fail a tool whose data comes from the engine/Prometheus.
- */
-export async function resolveProfileLocale(store, ctx) {
-    if (!store)
-        return "en";
-    return (explicitLocale((await readProfileAdvisory(store, resolveProfileKey(ctx)))?.language) ?? "en");
-}
-/**
- * Bind a module's translator to the per-request locale resolution: the module
- * creates its `localizeFor` once —
- * `export const localizeFor = createLocalizeFor(translator)` — and tool
- * handlers localize their model-facing summaries with
- * `const t = await localizeFor(store, ctx); … summary: t("key", { … })`.
- */
-export function createLocalizeFor(translator) {
-    return async (store, ctx) => {
-        const locale = await resolveProfileLocale(store, ctx);
-        return (key, params) => translator(locale, key, params);
-    };
-}
-/**
- * Bind a module's translator to the ONE view-title rule every show tool of
- * every module follows: `export const viewLocaleOf = createViewLocaleOf(translator)`,
- * for a handler that already holds the caller's profile language (a settings
- * view reads the whole record anyway).
- */
-export function createViewLocaleOf(translator) {
-    return (language) => {
-        const named = explicitLocale(language);
-        const t = (key, params) => translator(named ?? "en", key, params);
-        return { t, title: (key, params) => (named ? t(key, params) : undefined) };
-    };
-}
-/**
- * `createLocalizeFor` plus the view title, from ONE profile read: a show tool
- * words its result with
- * `const { t, title } = await localizeViewFor(store, ctx)`, then
- * `title: title("key"), summary: t("key", { … })`.
- * Fail-soft like it: no store, no caller or a store outage reads as "system"
- * (no title, an English summary).
- */
-export function createLocalizeViewFor(translator) {
-    const viewLocaleOf = createViewLocaleOf(translator);
-    return async (store, ctx) => {
-        const record = store ? await readProfileAdvisory(store, resolveProfileKey(ctx)) : undefined;
-        return viewLocaleOf(record?.language);
-    };
-}
-//# sourceMappingURL=server-locale.js.map

package/dist/server-locale.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"server-locale.js","sourceRoot":"","sources":["../src/server-locale.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAEhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAQvD;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAgC,EAChC,GAAa;IAEb,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAA;IACvB,OAAO,CACL,cAAc,CAAC,CAAC,MAAM,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,IAAI,IAAI,CAC7F,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAsB;IAEtB,OAAO,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC1B,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;QACrD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAA;IACzD,CAAC,CAAA;AACH,CAAC;AAgBD;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAsB;IAEtB,OAAO,CAAC,QAAQ,EAAE,EAAE;QAClB,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAA;QACtC,MAAM,CAAC,GAAY,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,IAAI,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,CAAA;QAC1E,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAA;IAC5E,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAAsB;IAEtB,MAAM,YAAY,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAA;IACnD,OAAO,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QAC3F,OAAO,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IACvC,CAAC,CAAA;AACH,CAAC"}

package/dist/server-locale.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=server-locale.test.d.ts.map

package/dist/server-locale.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"server-locale.test.d.ts","sourceRoot":"","sources":["../src/server-locale.test.ts"],"names":[],"mappings":""}

package/dist/server-locale.test.js

@@ -1,90 +0,0 @@
-import { describe, expect, it, vi } from "vitest";
-import { createLocalizeFor, createLocalizeViewFor, createViewLocaleOf, resolveProfileLocale, } from "./server-locale.js";
-import { runWithMcpRequestInfo } from "./request-context.js";
-const storeWith = (language) => ({
-    get: () => Promise.resolve({ language }),
-});
-/** A signed-in caller's handler ctx. */
-const CTX = { auth: { user: { id: "user-1" } } };
-describe("resolveProfileLocale", () => {
-    it("reads the caller's profile language", async () => {
-        expect(await resolveProfileLocale(storeWith("de"), CTX)).toBe("de");
-    });
-    it("falls back to English without a store, without a stored language, and without a key", async () => {
-        expect(await resolveProfileLocale(undefined, CTX)).toBe("en");
-        expect(await resolveProfileLocale(storeWith(undefined), CTX)).toBe("en");
-        // No identity: no request context at all, or an HTTP request without OAuth.
-        expect(await resolveProfileLocale(storeWith("de"))).toBe("en");
-        expect(await runWithMcpRequestInfo({}, () => resolveProfileLocale(storeWith("de")))).toBe("en");
-    });
-    it("reads the system preference — and a locale this build ships no catalog for — as English", async () => {
-        // The host locale `system` follows is a widget-side signal the server never sees.
-        expect(await resolveProfileLocale(storeWith("system"), CTX)).toBe("en");
-        expect(await resolveProfileLocale(storeWith("fr"), CTX)).toBe("en");
-    });
-    it("degrades to English on a store OUTAGE instead of failing the tool", async () => {
-        const warn = vi.spyOn(console, "warn").mockImplementation(() => { });
-        const broken = { get: () => Promise.reject(new Error("pg down")) };
-        expect(await resolveProfileLocale(broken, CTX)).toBe("en");
-        expect(warn).toHaveBeenCalledOnce();
-        warn.mockRestore();
-    });
-});
-describe("createLocalizeFor", () => {
-    const translator = (locale, key, params) => `${locale}:${key}${params ? `:${JSON.stringify(params)}` : ""}`;
-    it("binds the module translator to the resolved locale", async () => {
-        const localizeFor = createLocalizeFor(translator);
-        const t = await localizeFor(storeWith("de"), CTX);
-        expect(t("greeting")).toBe("de:greeting");
-        expect(t("count", { n: 2 })).toBe('de:count:{"n":2}');
-    });
-    it("localizes to English when no store is wired", async () => {
-        const t = await createLocalizeFor(translator)();
-        expect(t("greeting")).toBe("en:greeting");
-    });
-});
-/**
- * The view-title rule every module's show tools share (#322 U3): a title
- * only in a language the profile names. "system" follows the host's locale,
- * which the server never sees, so the view carries no title rather than an
- * English one over a German view.
- */
-describe("createLocalizeViewFor / createViewLocaleOf", () => {
-    const translator = (locale, key, params) => `${locale}:${key}${params ? `:${JSON.stringify(params)}` : ""}`;
-    const localizeViewFor = createLocalizeViewFor(translator);
-    const viewLocaleOf = createViewLocaleOf(translator);
-    it("titles the view in the language the profile names, the summary alike", async () => {
-        for (const language of ["de", "en"]) {
-            const { t, title } = await localizeViewFor(storeWith(language), CTX);
-            expect(title("view.title")).toBe(`${language}:view.title`);
-            expect(title("view.title", { n: 2 })).toBe(`${language}:view.title:{"n":2}`);
-            expect(t("summary")).toBe(`${language}:summary`);
-        }
-    });
-    it("sets no title for system, no saved language or one without a catalog; summaries in English", async () => {
-        for (const language of ["system", undefined, "fr"]) {
-            const { t, title } = await localizeViewFor(storeWith(language), CTX);
-            expect(title("view.title")).toBeUndefined();
-            expect(t("summary")).toBe("en:summary");
-            expect(viewLocaleOf(language).title("view.title")).toBeUndefined();
-        }
-    });
-    it("no store, no caller or a store outage reads as system: no title", async () => {
-        const warn = vi.spyOn(console, "warn").mockImplementation(() => { });
-        const broken = { get: () => Promise.reject(new Error("pg down")) };
-        for (const view of [
-            await localizeViewFor(undefined, CTX),
-            await localizeViewFor(storeWith("de")),
-            await localizeViewFor(broken, CTX),
-        ]) {
-            expect(view.title("view.title")).toBeUndefined();
-            expect(view.t("summary")).toBe("en:summary");
-        }
-        warn.mockRestore();
-    });
-    it("a language already read titles the same way", () => {
-        expect(viewLocaleOf("de").title("view.title")).toBe("de:view.title");
-        expect(viewLocaleOf("en").t("summary")).toBe("en:summary");
-    });
-});
-//# sourceMappingURL=server-locale.test.js.map

package/dist/server-locale.test.js.map

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

package/dist/shell-catalogue.d.ts

@@ -1,12 +0,0 @@
-import { type AppDefinition, type AppPlugin } from "@miragon/mcp-toolkit-core";
-import type { MCPServer } from "mcp-use";
-import { type ShellSettingsToolsOptions } from "./shell-settings.js";
-export declare const shellDefinition: AppDefinition;
-export type ShellPluginOptions = ShellSettingsToolsOptions;
-/**
- * The always-on shell plugin. With a profile store it registers the settings
- * triple; without one (a root that persists nothing) the page renders the
- * module sections alone and `ProfileGate` falls back to the host's locale.
- */
-export declare function createShellPlugin(options?: ShellPluginOptions): AppPlugin<MCPServer>;
-//# sourceMappingURL=shell-catalogue.d.ts.map

package/dist/shell-catalogue.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"shell-catalogue.d.ts","sourceRoot":"","sources":["../src/shell-catalogue.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,SAAS,EAEf,MAAM,2BAA2B,CAAA;AAClC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAExC,OAAO,EAA8B,KAAK,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAkJhG,eAAO,MAAM,eAAe,EAAE,aA+D7B,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG,yBAAyB,CAAA;AAE1D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC,SAAS,CAAC,CAMpF"}

package/dist/shell-catalogue.js

@@ -1,142 +0,0 @@
-import { z } from "zod";
-import { PROPS_SCHEMA_DISPLAY_KEYWORD, } from "@miragon/mcp-toolkit-core";
-import { SHELL_SETTINGS_PAGE_WIDGET, SHELL_SETTINGS_WIDGET } from "./shell-settings-contract.js";
-import { registerShellSettingsTools } from "./shell-settings.js";
-/**
- * The `shell` module: generic, module-agnostic widgets every deployment gets.
- * They render plain data from ANY context key (named via `props.dataKey`) —
- * the standard composition targets for `render-view` and the visual builder,
- * so any module or pipeline step can feed a KPI row or data table without
- * shipping a dedicated widget:
- *
- *   step:   produces ["camunda7:kpis"]
- *   layout: { widget: "shell:kpi-grid", props: { dataKey: "camunda7:kpis" } }
- *
- * Components live next door in `src/ui/generic-widgets.tsx` and
- * `src/ui/shell-settings.tsx` (exported via `@miragon/pulse-widget-shell/widgets`,
- * all four in `shellWidgets`); this file carries their catalogue metadata so
- * host apps register the plugin without owning any domain UI. Its only tools
- * are the settings triple (`shell-settings.ts`), and no step.
- *
- * `description`s are the model's text; the view builder shows people the
- * `title`/`summary` (and each top-level field's `x-display`) in English or
- * German (toolkit 2.8), never sent to the model.
- */
-/** A text in both languages the builder speaks. */
-const both = (en, de) => ({ en, de });
-/** A props field's label and help line in the builder's props sheet. */
-const field = (title, summary) => ({
-    [PROPS_SCHEMA_DISPLAY_KEYWORD]: { title, summary },
-});
-const DATA_KEY = both("Data key", "Datenschlüssel");
-const EMPTY_TEXT = both("Text without data", "Text ohne Daten");
-const kpiGridPropsSchema = z.toJSONSchema(z.object({
-    dataKey: z
-        .string()
-        .describe('Context key holding the KPI cells — either an array of { label, value, tone?, fraction? } (tone: danger|warning|success|info|neutral) or a plain { "label": value } object.')
-        .meta(field(DATA_KEY, both("The key whose metrics the strip shows.", "Der Schlüssel, dessen Kennzahlen die Leiste zeigt."))),
-    boxed: z
-        .boolean()
-        .optional()
-        .describe("Wrap the strip in a rounded bordered card.")
-        .meta(field(both("Framed", "Mit Rahmen"), both("Draws the strip in a framed card.", "Zeichnet die Leiste in einer Karte mit Rahmen."))),
-    variant: z
-        .enum(["strip", "soft"])
-        .optional()
-        .describe('"soft" renders tone-tinted cards instead of the bordered strip.')
-        .meta(field(both("Style", "Darstellung"), both("One strip, or a tinted card per metric.", "Eine Leiste oder eine getönte Karte je Kennzahl."))),
-    emptyText: z
-        .string()
-        .optional()
-        .describe("Text shown when the key holds no usable cells.")
-        .meta(field(EMPTY_TEXT, both("Shown when the key holds no metrics.", "Erscheint, wenn der Schlüssel keine Kennzahlen enthält."))),
-}));
-const dataTablePropsSchema = z.toJSONSchema(z.object({
-    dataKey: z
-        .string()
-        .describe("Context key holding the rows — an array of flat records, or { rows: [...] }.")
-        .meta(field(DATA_KEY, both("The key whose records the table shows.", "Der Schlüssel, dessen Datensätze die Tabelle zeigt."))),
-    // The props sheet edits top-level fields only (an array is JSON there),
-    // and the toolkit strips `x-display` at that level only: the column
-    // fields carry no builder text, or it would reach the model.
-    columns: z
-        .array(z.object({
-        key: z.string().describe("Record field to render."),
-        label: z
-            .string()
-            .optional()
-            .describe("Column header (defaults to the key in words: totalIncidents → Total incidents)."),
-        align: z.enum(["left", "right"]).optional(),
-    }))
-        .optional()
-        .describe("Column spec; derived from the first row's primitive fields when omitted.")
-        .meta(field(both("Columns", "Spalten"), both("The fields the table shows. Without them, those of the first row.", "Die Felder, die die Tabelle zeigt. Ohne Angabe die der ersten Zeile."))),
-    emptyText: z
-        .string()
-        .optional()
-        .describe("Text shown when there are no rows.")
-        .meta(field(EMPTY_TEXT, both("Shown when there are no rows.", "Erscheint, wenn es keine Zeilen gibt."))),
-}));
-export const shellDefinition = {
-    name: "shell",
-    title: both("Building blocks", "Bausteine"),
-    steps: [],
-    widgets: [
-        {
-            id: "shell:kpi-grid",
-            title: both("Metric strip", "Kennzahlenleiste"),
-            summary: both("A row of metrics from any data key.", "Eine Reihe Kennzahlen aus einem beliebigen Datenschlüssel."),
-            description: "Generic KPI strip. Renders the cells found under props.dataKey — lets any module or pipeline step feed a standard KPI row without shipping its own widget.",
-            requires: [],
-            consumes: [],
-            size: "half",
-            propsSchema: kpiGridPropsSchema,
-        },
-        {
-            id: "shell:data-table",
-            title: both("Data table", "Datentabelle"),
-            summary: both("A table of the records under any data key.", "Eine Tabelle der Datensätze unter einem beliebigen Datenschlüssel."),
-            description: "Generic data table. Renders the array of records found under props.dataKey as a cockpit-style table — columns configurable or derived from the data.",
-            requires: [],
-            consumes: [],
-            size: "full",
-            propsSchema: dataTablePropsSchema,
-        },
-        {
-            // Self-fetching from shell_settings_data; one row of the settings page.
-            id: SHELL_SETTINGS_WIDGET,
-            title: both("Language", "Sprache"),
-            summary: both("The language of the views and the summaries.", "Die Sprache der Ansichten und der Zusammenfassungen."),
-            description: "The UI language section of the settings page (shell_save_settings changes it).",
-            requires: [],
-            consumes: [],
-            size: "full",
-        },
-        {
-            // The page itself: the language section, then every `<module>:settings`
-            // section the host bundles — opened by shell_show_settings and the
-            // cockpit's settings tab, not composed into a view.
-            id: SHELL_SETTINGS_PAGE_WIDGET,
-            title: both("Settings", "Einstellungen"),
-            summary: both("The language and every module's settings on one page.", "Die Sprache und die Einstellungen jedes Moduls auf einer Seite."),
-            description: "The whole settings page — opened by shell_show_settings, not composed into a view.",
-            requires: [],
-            consumes: [],
-            size: "full",
-        },
-    ],
-};
-/**
- * The always-on shell plugin. With a profile store it registers the settings
- * triple; without one (a root that persists nothing) the page renders the
- * module sections alone and `ProfileGate` falls back to the host's locale.
- */
-export function createShellPlugin(options) {
-    if (!options)
-        return { definition: shellDefinition };
-    return {
-        definition: shellDefinition,
-        registerWidgetTools: (server) => registerShellSettingsTools(server, options),
-    };
-}
-//# sourceMappingURL=shell-catalogue.js.map

package/dist/shell-catalogue.js.map

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

package/dist/shell-settings-contract.d.ts

@@ -1,34 +0,0 @@
-import type { LanguagePref } from "./profile-constants.js";
-/**
- * The shell's settings contract, shared by the server tools
- * (`shell-settings.ts`) and the widgets (`ui/shell-settings.tsx`) — no
- * runtime dependency, so the browser bundle imports it without server code.
- *
- * The shell owns the record-level preferences every module reads (today the
- * UI `language`) and the settings PAGE, which composes one section per module
- * (`<module>:settings`). Modules own only their `profile.modules.<module>`
- * slice and its section.
- */
-/** Renders the settings page: the shell's language section, then every module's section. */
-export declare const SHELL_SHOW_SETTINGS = "shell_show_settings";
-/** App-only feed of the shell's section; also what `ProfileGate` reads the language from. */
-export declare const SHELL_SETTINGS_DATA = "shell_settings_data";
-/** Saves the record-level preferences (the UI language). */
-export declare const SHELL_SAVE_SETTINGS = "shell_save_settings";
-/** The settings page widget (`shell_show_settings`, the cockpit's settings tab). */
-export declare const SHELL_SETTINGS_PAGE_WIDGET = "shell:settings-page";
-/** The shell's own section on that page. */
-export declare const SHELL_SETTINGS_WIDGET = "shell:settings";
-/**
- * Why the section cannot save: no caller identity (no OAuth), or a deployment
- * whose framework writes are off (`frameworkWritesAllowed`: a module runs on
- * its read-only floor).
- */
-export type ShellSettingsReadOnlyReason = "noSignIn" | "readOnly";
-/** What `shell_settings_data` returns and `shell_show_settings` renders. */
-export interface ShellSettingsView {
-    language: LanguagePref;
-    canSave: boolean;
-    readOnlyReason: ShellSettingsReadOnlyReason | null;
-}
-//# sourceMappingURL=shell-settings-contract.d.ts.map

package/dist/shell-settings-contract.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"shell-settings-contract.d.ts","sourceRoot":"","sources":["../src/shell-settings-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAE1D;;;;;;;;;GASG;AAEH,4FAA4F;AAC5F,eAAO,MAAM,mBAAmB,wBAAwB,CAAA;AACxD,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB,wBAAwB,CAAA;AACxD,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,wBAAwB,CAAA;AAExD,oFAAoF;AACpF,eAAO,MAAM,0BAA0B,wBAAwB,CAAA;AAC/D,4CAA4C;AAC5C,eAAO,MAAM,qBAAqB,mBAAmB,CAAA;AAErD;;;;GAIG;AACH,MAAM,MAAM,2BAA2B,GAAG,UAAU,GAAG,UAAU,CAAA;AAEjE,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,YAAY,CAAA;IACtB,OAAO,EAAE,OAAO,CAAA;IAChB,cAAc,EAAE,2BAA2B,GAAG,IAAI,CAAA;CACnD"}

package/dist/shell-settings-contract.js

@@ -1,21 +0,0 @@
-/**
- * The shell's settings contract, shared by the server tools
- * (`shell-settings.ts`) and the widgets (`ui/shell-settings.tsx`) — no
- * runtime dependency, so the browser bundle imports it without server code.
- *
- * The shell owns the record-level preferences every module reads (today the
- * UI `language`) and the settings PAGE, which composes one section per module
- * (`<module>:settings`). Modules own only their `profile.modules.<module>`
- * slice and its section.
- */
-/** Renders the settings page: the shell's language section, then every module's section. */
-export const SHELL_SHOW_SETTINGS = "shell_show_settings";
-/** App-only feed of the shell's section; also what `ProfileGate` reads the language from. */
-export const SHELL_SETTINGS_DATA = "shell_settings_data";
-/** Saves the record-level preferences (the UI language). */
-export const SHELL_SAVE_SETTINGS = "shell_save_settings";
-/** The settings page widget (`shell_show_settings`, the cockpit's settings tab). */
-export const SHELL_SETTINGS_PAGE_WIDGET = "shell:settings-page";
-/** The shell's own section on that page. */
-export const SHELL_SETTINGS_WIDGET = "shell:settings";
-//# sourceMappingURL=shell-settings-contract.js.map

package/dist/shell-settings-contract.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"shell-settings-contract.js","sourceRoot":"","sources":["../src/shell-settings-contract.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,4FAA4F;AAC5F,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAA;AACxD,6FAA6F;AAC7F,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAA;AACxD,4DAA4D;AAC5D,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAA;AAExD,oFAAoF;AACpF,MAAM,CAAC,MAAM,0BAA0B,GAAG,qBAAqB,CAAA;AAC/D,4CAA4C;AAC5C,MAAM,CAAC,MAAM,qBAAqB,GAAG,gBAAgB,CAAA"}

package/dist/shell-settings.d.ts

@@ -1,24 +0,0 @@
-import { z } from "zod";
-import type { MCPServer } from "mcp-use";
-import { type Catalogs } from "@miragon/mcp-toolkit-core";
-import type { ProfileStore } from "./profile-store.js";
-/** The server texts, exported for the brand gates (`catalogTextFindings`). */
-export declare const SHELL_SETTINGS_CATALOGS: Catalogs;
-export declare const shellSettingsSaveInput: {
-    language: z.ZodEnum<{
-        en: "en";
-        de: "de";
-        system: "system";
-    }>;
-};
-export interface ShellSettingsToolsOptions {
-    /** The shared profile store; the language is a field of its record. */
-    profileStore: ProfileStore;
-    /**
-     * Whether the save tool exists: the composition root passes
-     * `frameworkWritesAllowed(boot)`. False keeps the section read-only.
-     */
-    allowSave: boolean;
-}
-export declare function registerShellSettingsTools(server: MCPServer, { profileStore: store, allowSave }: ShellSettingsToolsOptions): void;
-//# sourceMappingURL=shell-settings.d.ts.map

package/dist/shell-settings.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"shell-settings.d.ts","sourceRoot":"","sources":["../src/shell-settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,EAAoB,KAAK,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AAI3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAyDtD,8EAA8E;AAC9E,eAAO,MAAM,uBAAuB,UAAW,CAAA;AAK/C,eAAO,MAAM,sBAAsB;;;;;;CAIlC,CAAA;AAED,MAAM,WAAW,yBAAyB;IACxC,uEAAuE;IACvE,YAAY,EAAE,YAAY,CAAA;IAC1B;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAA;CACnB;AAWD,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,yBAAyB,GAC5D,IAAI,CA6FN"}

package/dist/shell-settings.js

@@ -1,148 +0,0 @@
-import { z } from "zod";
-import { createTranslator } from "@miragon/mcp-toolkit-core";
-import { withToolErrors } from "@miragon/mcp-toolkit-core/tools";
-import { LANGUAGES } from "./profile-constants.js";
-import { requireProfileKey } from "./profile-slice.js";
-import { resolveAuthUserId, resolveProfileKey } from "./profile.js";
-import { createViewLocaleOf } from "./server-locale.js";
-import { SHELL_SAVE_SETTINGS, SHELL_SETTINGS_DATA, SHELL_SETTINGS_PAGE_WIDGET, SHELL_SHOW_SETTINGS, } from "./shell-settings-contract.js";
-import { buildDataFeedResult, buildSingleWidgetView } from "./view-results.js";
-import { appOnly, showToolBinding, strictToolInput } from "./widget-tool-bindings.js";
-/**
- * The shell's settings tools — the record-level preferences every module
- * reads (the UI language) and the settings page, owned by no connector (#346):
- *   - `shell_show_settings`  renders the page (the shell's section first, then
- *     every module's `<module>:settings` section the host bundles);
- *   - `shell_settings_data`  is the section's app-only feed, and what
- *     `ProfileGate` reads the language from in every view;
- *   - `shell_save_settings`  saves the language.
- *
- * The save is a durable write no module toolset filters, so it follows the
- * host rule for those: registered only while the composition root says
- * framework writes are allowed (`frameworkWritesAllowed(boot)`: OAuth
- * installed AND no module on its read-only floor). The two view tools carry
- * the same decision as `canSave`, so the section never offers a Save that
- * would resolve to an unknown tool.
- */
-/** The model's summaries, in the profile's language (English for "system"). */
-const catalogs = {
-    en: {
-        "settings.title": "Settings",
-        "settings.language.system": "automatic (follows the chat app)",
-        "settings.language.en": "English",
-        "settings.language.de": "German",
-        "settings.summary": ({ language }) => `Settings page: UI language ${String(language)}, then each module's settings section.`,
-        "settings.summary.canSave": " The user can change them on the page or ask you to.",
-        "settings.summary.readOnly": " Settings can't be saved on this server.",
-        "settings.saved": ({ language }) => `UI language saved: ${String(language)}.`,
-    },
-    de: {
-        "settings.title": "Einstellungen",
-        "settings.language.system": "automatisch (folgt der Chat-App)",
-        "settings.language.en": "Englisch",
-        "settings.language.de": "Deutsch",
-        "settings.summary": ({ language }) => `Einstellungen: Sprache der Oberfläche ${String(language)}, danach der Abschnitt jedes Moduls.`,
-        "settings.summary.canSave": " Du kannst sie auf der Seite ändern oder den Chat darum bitten.",
-        "settings.summary.readOnly": " Auf diesem Server lassen sich keine Einstellungen speichern.",
-        "settings.saved": ({ language }) => `Sprache der Oberfläche gespeichert: ${String(language)}.`,
-    },
-};
-/** The server texts, exported for the brand gates (`catalogTextFindings`). */
-export const SHELL_SETTINGS_CATALOGS = catalogs;
-const viewLocaleOf = createViewLocaleOf(createTranslator(catalogs));
-const languageName = (t, language) => t(`settings.language.${language}`);
-export const shellSettingsSaveInput = {
-    language: z
-        .enum(LANGUAGES)
-        .describe('"system" follows the chat app. Tool summaries follow it too.'),
-};
-/**
- * Which gate keeps the section read-only, so it can name the way out — the
- * missing sign-in first: without a caller nothing saves on any deployment.
- */
-function readOnlyReason(allowSave, key) {
-    if (key === undefined)
-        return "noSignIn";
-    return allowSave ? null : "readOnly";
-}
-export function registerShellSettingsTools(server, { profileStore: store, allowSave }) {
-    const loadView = async (ctx) => {
-        // Same key as the save, so a save is always read back. Without OAuth no
-        // key resolves: the defaults, read-only — the norm on an open server.
-        const key = resolveProfileKey(ctx);
-        const record = key ? await store.get(key) : undefined;
-        return {
-            language: record?.language ?? "system",
-            canSave: allowSave && key !== undefined,
-            readOnlyReason: readOnlyReason(allowSave, key),
-        };
-    };
-    server.tool({
-        name: SHELL_SHOW_SETTINGS,
-        title: "Settings",
-        description: "Open the settings page: the UI language and each module's settings.",
-        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
-        inputSchema: strictToolInput({}),
-        ...showToolBinding(SHELL_SHOW_SETTINGS, "Settings"),
-    }, withToolErrors(async (_params, ctx) => {
-        const view = await loadView(ctx);
-        // Titled only in a language the profile names; with "system" the
-        // page's own heading names it in the host's language (#322 U3).
-        const { t, title } = viewLocaleOf(view.language);
-        const hint = view.canSave ? "settings.summary.canSave" : "settings.summary.readOnly";
-        return buildSingleWidgetView({
-            widget: SHELL_SETTINGS_PAGE_WIDGET,
-            app: "shell",
-            dataType: "shell:settings",
-            data: { ...view },
-            title: title("settings.title"),
-            summary: t("settings.summary", { language: languageName(t, view.language) }) + t(hint),
-        });
-    }));
-    server.tool({
-        name: SHELL_SETTINGS_DATA,
-        title: "Settings data (internal)",
-        description: "Internal JSON feed (no UI) for the settings page's language section. Prefer shell_show_settings.",
-        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
-        inputSchema: strictToolInput({}),
-        ...appOnly,
-    }, withToolErrors(async (_params, ctx) => buildDataFeedResult({ ...(await loadView(ctx)) })));
-    if (!allowSave)
-        return;
-    server.tool({
-        name: SHELL_SAVE_SETTINGS,
-        title: "Save settings",
-        description: 'Set the caller\'s UI language, e.g. "switch the UI to German" (language: "de").',
-        // A local profile write: explicitly non-destructive (MCP presumes a
-        // write destructive unless told otherwise) and closed-world.
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: false,
-        },
-        inputSchema: strictToolInput(shellSettingsSaveInput),
-    }, withToolErrors(async ({ language }, ctx) => {
-        // A save without a caller fails visibly; the store merges the one
-        // field over the raw stored record under its per-key lock, so module
-        // slices saved concurrently survive. The OAuth caller is the owner.
-        const key = requireProfileKey(ctx);
-        const saved = await store.save(key, { language }, { userId: resolveAuthUserId(ctx) });
-        const view = {
-            language: saved.language,
-            canSave: true,
-            readOnlyReason: null,
-        };
-        const { t } = viewLocaleOf(saved.language);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: t("settings.saved", { language: languageName(t, saved.language) }),
-                },
-            ],
-            structuredContent: { ...view },
-        };
-    }));
-}
-//# sourceMappingURL=shell-settings.js.map

package/dist/shell-settings.js.map

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

package/dist/shell-settings.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=shell-settings.test.d.ts.map

package/dist/shell-settings.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"shell-settings.test.d.ts","sourceRoot":"","sources":["../src/shell-settings.test.ts"],"names":[],"mappings":""}