@miragon/pulse-widget-shell 0.0.0-bootstrap.0 → 0.21.0

package/dist/server-locale.test.js

@@ -0,0 +1,90 @@
+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

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

package/dist/server.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Server-side surface of the widget shell (`@miragon/pulse-widget-shell/server`):
+ * the one import path for module tools and composition roots — the eager view
+ * builders for `*_show_*` tools (the toolkit core's, re-typed below), the
+ * shared error wrapper for raw `server.tool()` registrations, module
+ * composition and the composed-server boot, caller identity, the profile
+ * and dashboard persistence, and the one rule a BPMN model's names are read by.
+ */
+export type { ComposedViewEntry, ComposedViewInput, SingleWidgetViewInput, } from "@miragon/mcp-toolkit-core";
+export { withToolErrors } from "@miragon/mcp-toolkit-core/tools";
+export { createShellPlugin, shellDefinition, type ShellPluginOptions } from "./shell-catalogue.js";
+export { SHELL_SAVE_SETTINGS, SHELL_SETTINGS_DATA, SHELL_SETTINGS_PAGE_WIDGET, SHELL_SETTINGS_WIDGET, SHELL_SHOW_SETTINGS, type ShellSettingsReadOnlyReason, type ShellSettingsView, } from "./shell-settings-contract.js";
+export { createBuilderTexts, type BuilderTexts } from "./builder-texts.js";
+export { ANONYMOUS_PROFILE_KEY, resolveAuthUserId, resolveProfileKey, withoutDefaults, type ProfileSlice, type ProfileSource, } from "./profile.js";
+export { callerCacheKey, getMcpRequestInfo, installMcpRequestContext, runWithMcpRequestInfo, type McpMiddlewareHost, type McpRequestInfo, } from "./request-context.js";
+export { OAUTH_ENV_VARS, oauthFromEnv, type OAuthFromEnvOptions } from "./oauth-env.js";
+export { requestLogLevelWarning, resolvePort, swallowDevCliViewsPrime, type ResolvePortOptions, type ToolCallMiddlewareHost, } from "./host-boot.js";
+export { installHealthEndpoints, type HealthOptions, type HealthReport, type HealthStatus, type HttpRouteHost, type ReadinessCheck, } from "./health.js";
+export { installMetrics, type HttpMiddlewareContext, type HttpMiddlewareHost, type MetricsHost, type MetricsOptions, } from "./metrics.js";
+export { DEFAULT_MAX_BODY_BYTES, HTTP_EDGE_ENV_VARS, installHttpEdgeGuard, resolveHttpEdgePolicy, type AllowList, type EdgeGuardContext, type EdgeGuardHost, type EdgeGuardOptions, type HttpEdgePolicy, } from "./http-edge.js";
+export { fontAssetsCsp, installFontAssets, type FontAsset, type FontAssetsOptions, } from "./font-assets.js";
+export { SERVED_FONT_FILES, SERVED_FONT_PATH, servedFontBaseUrl } from "./served-fonts.js";
+export { honorWidgetMetaDefaults, withWidgetMetaDefaults, type WidgetMetaDefaults, } from "./widget-meta-defaults.js";
+export { createBodyLimitedListener, type BodyLimitedListener, type BodyLimitedListenerOptions, type FetchTarget, } from "./node-listener.js";
+export { createComposedServer, DEFAULT_DRAIN_TIMEOUT_MS, DEFAULT_REQUEST_TIMEOUT_MS, type BootComposition, type ComposedServer, type ComposedServerInfo, type ComposedServerOptions, type ComposedServerRuntime, type ListenOptions, type RunningServer, } from "./composed-server.js";
+export { explicitLocale, LANGUAGES, LOCALES, PROFILE_SCHEMA_VERSION, type LanguagePref, type Locale, } from "./profile-constants.js";
+export { defaultProfileRecord, profileRecordSchema, type ProfileRecord, type ProfileRecordSaveInput, } from "./profile-record.js";
+export { parseStoredProfile } from "./profile-migrations.js";
+export { createFileSystemProfileStore, createInMemoryProfileStore, mergeStoredProfile, type MergedProfile, type ProfileSaveOptions, type ProfileStore, } from "./profile-store.js";
+export { readProfileAdvisory } from "./profile-advisory.js";
+export { createPostgresProfileStore, PROFILE_STORE_MIGRATIONS } from "./profile-store-postgres.js";
+export { createPostgresDashboardStore, DASHBOARD_STORE_MIGRATIONS, } from "./dashboard-store-postgres.js";
+export { createSql, postgresReadinessCheck, runMigrations, type Migration } from "./postgres.js";
+export { appOnly, showToolBinding, strictToolInput } from "./widget-tool-bindings.js";
+export { composeModules, frameworkWritesAllowed, type ActiveModuleRef, type ComposableModule, type EffectiveToolset, type ModuleComposition, type ResolveBootOptions, type ResolvedBoot, } from "./composition.js";
+export { announcePersistence, persistenceFromEnv, profileStoreFromEnv, type PersistenceBackend, type PersistenceSelection, } from "./profile-store-env.js";
+export { createToolsetVocabulary, type EffectiveSelection, type ToolsetSource, type ToolsetVocabulary, } from "./toolsets.js";
+export { createLocalizeFor, createLocalizeViewFor, createViewLocaleOf, resolveProfileLocale, type ServerT, type Translator, type ViewLocale, } from "./server-locale.js";
+export { parseModuleSlice, requireProfileKey, saveModuleSlice } from "./profile-slice.js";
+export { catalogueSyncIssues } from "./catalogue-sync.js";
+export { bpmnProcessNameOf, parseBpmnNames, readBpmnNames, type BpmnModelNames, type BpmnNames, } from "./bpmn-names.js";
+export { buildComposedView, buildDataFeedResult, buildSingleWidgetView } from "./view-results.js";
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

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

package/dist/server.js

@@ -0,0 +1,34 @@
+export { withToolErrors } from "@miragon/mcp-toolkit-core/tools";
+export { createShellPlugin, shellDefinition } from "./shell-catalogue.js";
+export { SHELL_SAVE_SETTINGS, SHELL_SETTINGS_DATA, SHELL_SETTINGS_PAGE_WIDGET, SHELL_SETTINGS_WIDGET, SHELL_SHOW_SETTINGS, } from "./shell-settings-contract.js";
+export { createBuilderTexts } from "./builder-texts.js";
+export { ANONYMOUS_PROFILE_KEY, resolveAuthUserId, resolveProfileKey, withoutDefaults, } from "./profile.js";
+export { callerCacheKey, getMcpRequestInfo, installMcpRequestContext, runWithMcpRequestInfo, } from "./request-context.js";
+export { OAUTH_ENV_VARS, oauthFromEnv } from "./oauth-env.js";
+export { requestLogLevelWarning, resolvePort, swallowDevCliViewsPrime, } from "./host-boot.js";
+export { installHealthEndpoints, } from "./health.js";
+export { installMetrics, } from "./metrics.js";
+export { DEFAULT_MAX_BODY_BYTES, HTTP_EDGE_ENV_VARS, installHttpEdgeGuard, resolveHttpEdgePolicy, } from "./http-edge.js";
+export { fontAssetsCsp, installFontAssets, } from "./font-assets.js";
+export { SERVED_FONT_FILES, SERVED_FONT_PATH, servedFontBaseUrl } from "./served-fonts.js";
+export { honorWidgetMetaDefaults, withWidgetMetaDefaults, } from "./widget-meta-defaults.js";
+export { createBodyLimitedListener, } from "./node-listener.js";
+export { createComposedServer, DEFAULT_DRAIN_TIMEOUT_MS, DEFAULT_REQUEST_TIMEOUT_MS, } from "./composed-server.js";
+export { explicitLocale, LANGUAGES, LOCALES, PROFILE_SCHEMA_VERSION, } from "./profile-constants.js";
+export { defaultProfileRecord, profileRecordSchema, } from "./profile-record.js";
+export { parseStoredProfile } from "./profile-migrations.js";
+export { createFileSystemProfileStore, createInMemoryProfileStore, mergeStoredProfile, } from "./profile-store.js";
+export { readProfileAdvisory } from "./profile-advisory.js";
+export { createPostgresProfileStore, PROFILE_STORE_MIGRATIONS } from "./profile-store-postgres.js";
+export { createPostgresDashboardStore, DASHBOARD_STORE_MIGRATIONS, } from "./dashboard-store-postgres.js";
+export { createSql, postgresReadinessCheck, runMigrations } from "./postgres.js";
+export { appOnly, showToolBinding, strictToolInput } from "./widget-tool-bindings.js";
+export { composeModules, frameworkWritesAllowed, } from "./composition.js";
+export { announcePersistence, persistenceFromEnv, profileStoreFromEnv, } from "./profile-store-env.js";
+export { createToolsetVocabulary, } from "./toolsets.js";
+export { createLocalizeFor, createLocalizeViewFor, createViewLocaleOf, resolveProfileLocale, } from "./server-locale.js";
+export { parseModuleSlice, requireProfileKey, saveModuleSlice } from "./profile-slice.js";
+export { catalogueSyncIssues } from "./catalogue-sync.js";
+export { bpmnProcessNameOf, parseBpmnNames, readBpmnNames, } from "./bpmn-names.js";
+export { buildComposedView, buildDataFeedResult, buildSingleWidgetView } from "./view-results.js";
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/shell-catalogue.d.ts

@@ -0,0 +1,12 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,142 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,34 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,21 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,24 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,148 @@
+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

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