@miragon/pulse-analytics-connector 0.0.0-bootstrap.0 → 0.21.0

package/dist/settings.d.ts

@@ -0,0 +1,77 @@
+import { z } from "zod";
+import type { ProfileSource } from "./server-locale.js";
+/**
+ * The analytics module's OWN settings slice, persisted under
+ * `profile.modules.analytics` in the shared profile record (see the camunda7
+ * `modules` field — the profile transports the slice, this module owns its
+ * schema). Read fail-soft: a missing/foreign slice yields the defaults, so a
+ * stale or hand-edited record can never break analytics tools.
+ */
+export declare const analyticsSettingsSchema: z.ZodObject<{
+    defaultPeriod: z.ZodDefault<z.ZodEnum<{
+        "1d": "1d";
+        "3d": "3d";
+        "7d": "7d";
+        "14d": "14d";
+        "30d": "30d";
+    }>>;
+    minBucketSize: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type AnalyticsSettings = z.infer<typeof analyticsSettingsSchema>;
+/**
+ * The save tool's input — deliberately default-FREE: zod 4 re-applies
+ * `.default()`s through `.partial()` on parse, so a defaulted partial would
+ * materialize omitted fields at the tool boundary and a "single-field" save
+ * would silently reset the other saved value. With this shape, omitted keys
+ * stay absent and the handler's merge keeps them unchanged.
+ *
+ * Spelled out by hand because the save descriptions differ from the schema's
+ * ("Omitted → unchanged" is what the model needs at a write boundary). When the
+ * descriptions can be shared, derive it instead:
+ * `z.object(withoutDefaults(analyticsSettingsSchema.shape)).partial()`
+ * (`withoutDefaults` from `@miragon/pulse-widget-shell/server`) — which is what
+ * camunda7's `userProfileSaveInput` does.
+ */
+export declare const analyticsSettingsSaveInput: z.ZodObject<{
+    defaultPeriod: z.ZodOptional<z.ZodEnum<{
+        "1d": "1d";
+        "3d": "3d";
+        "7d": "7d";
+        "14d": "14d";
+        "30d": "30d";
+    }>>;
+    minBucketSize: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * `period` at the tool boundary is optional (no zod default) so an omitted
+ * value is distinguishable and can fall back to the user's saved analytics
+ * default before the schema default applies. Derived from PERIODS — never a
+ * copied enum. Shared by the widget tools and the registrar tools.
+ */
+export declare const optionalPeriod: z.ZodOptional<z.ZodEnum<{
+    "1d": "1d";
+    "3d": "3d";
+    "7d": "7d";
+    "14d": "14d";
+    "30d": "30d";
+}>>;
+/** Same optional-at-the-boundary treatment for `minBucketSize`. */
+export declare const optionalMinBucketSize: z.ZodOptional<z.ZodNumber>;
+/** The module's slice key inside `profile.modules`. */
+export declare const ANALYTICS_MODULE_KEY = "analytics";
+/**
+ * The slice parsed leniently: garbage or absence yields the defaults —
+ * per FIELD (shared `parseModuleSlice`), so one invalid value keeps the
+ * other saved preference intact.
+ */
+export declare function parseAnalyticsSettings(modules: Record<string, unknown> | undefined): AnalyticsSettings;
+/**
+ * Resolve the request's effective analytics settings from the shared profile
+ * store — the single place tools apply the "explicit arg > saved setting >
+ * schema default" precedence for `period`/`minBucketSize`. Fail-soft on every
+ * axis: no store, no resolvable key, or a store OUTAGE all yield the schema
+ * defaults — a profile-store hiccup must never fail an analytics read that
+ * only needs Prometheus.
+ */
+export declare function settingsFor(store: ProfileSource | undefined, ctx?: unknown): Promise<AnalyticsSettings>;
+//# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAGvD;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;iBAalC,CAAA;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;iBAWrC,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc;;;;;;GAGiE,CAAA;AAE5F,mEAAmE;AACnE,eAAO,MAAM,qBAAqB,4BAO/B,CAAA;AAEH,uDAAuD;AACvD,eAAO,MAAM,oBAAoB,cAAc,CAAA;AAE/C;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC3C,iBAAiB,CAEnB;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,aAAa,GAAG,SAAS,EAChC,GAAG,CAAC,EAAE,OAAO,GACZ,OAAO,CAAC,iBAAiB,CAAC,CAU5B"}

package/dist/settings.js

@@ -0,0 +1,99 @@
+import { z } from "zod";
+import { PERIODS } from "@miragon/pulse-analytics-client";
+import { parseModuleSlice } from "@miragon/pulse-widget-shell/server";
+import { resolveSettingsKey } from "./server-locale.js";
+/**
+ * The analytics module's OWN settings slice, persisted under
+ * `profile.modules.analytics` in the shared profile record (see the camunda7
+ * `modules` field — the profile transports the slice, this module owns its
+ * schema). Read fail-soft: a missing/foreign slice yields the defaults, so a
+ * stale or hand-edited record can never break analytics tools.
+ */
+export const analyticsSettingsSchema = z.object({
+    defaultPeriod: z
+        .enum(PERIODS)
+        .default("7d")
+        .describe("Default look-back window applied when an analytics call omits `period`."),
+    minBucketSize: z
+        .number()
+        .int()
+        .min(1)
+        .default(10)
+        .describe("Default minimum per-window instance count before comparison results are flagged `suppressed`, applied when a compare call omits `minBucketSize`."),
+});
+/**
+ * The save tool's input — deliberately default-FREE: zod 4 re-applies
+ * `.default()`s through `.partial()` on parse, so a defaulted partial would
+ * materialize omitted fields at the tool boundary and a "single-field" save
+ * would silently reset the other saved value. With this shape, omitted keys
+ * stay absent and the handler's merge keeps them unchanged.
+ *
+ * Spelled out by hand because the save descriptions differ from the schema's
+ * ("Omitted → unchanged" is what the model needs at a write boundary). When the
+ * descriptions can be shared, derive it instead:
+ * `z.object(withoutDefaults(analyticsSettingsSchema.shape)).partial()`
+ * (`withoutDefaults` from `@miragon/pulse-widget-shell/server`) — which is what
+ * camunda7's `userProfileSaveInput` does.
+ */
+export const analyticsSettingsSaveInput = z.object({
+    defaultPeriod: z
+        .enum(PERIODS)
+        .optional()
+        .describe("New default look-back period. Omitted → unchanged."),
+    minBucketSize: z
+        .number()
+        .int()
+        .min(1)
+        .optional()
+        .describe("New minimum comparison bucket size. Omitted → unchanged."),
+});
+/**
+ * `period` at the tool boundary is optional (no zod default) so an omitted
+ * value is distinguishable and can fall back to the user's saved analytics
+ * default before the schema default applies. Derived from PERIODS — never a
+ * copied enum. Shared by the widget tools and the registrar tools.
+ */
+export const optionalPeriod = z
+    .enum(PERIODS)
+    .optional()
+    .describe("Analysis time period. Omitted → the user's saved analytics default (else 7d).");
+/** Same optional-at-the-boundary treatment for `minBucketSize`. */
+export const optionalMinBucketSize = z
+    .number()
+    .int()
+    .min(1)
+    .optional()
+    .describe("Minimum per-window instance count before results are flagged `suppressed`. Omitted → the user's saved analytics default (else 10).");
+/** The module's slice key inside `profile.modules`. */
+export const ANALYTICS_MODULE_KEY = "analytics";
+/**
+ * The slice parsed leniently: garbage or absence yields the defaults —
+ * per FIELD (shared `parseModuleSlice`), so one invalid value keeps the
+ * other saved preference intact.
+ */
+export function parseAnalyticsSettings(modules) {
+    return parseModuleSlice(analyticsSettingsSchema, modules?.[ANALYTICS_MODULE_KEY]);
+}
+/**
+ * Resolve the request's effective analytics settings from the shared profile
+ * store — the single place tools apply the "explicit arg > saved setting >
+ * schema default" precedence for `period`/`minBucketSize`. Fail-soft on every
+ * axis: no store, no resolvable key, or a store OUTAGE all yield the schema
+ * defaults — a profile-store hiccup must never fail an analytics read that
+ * only needs Prometheus.
+ */
+export async function settingsFor(store, ctx) {
+    if (!store)
+        return analyticsSettingsSchema.parse({});
+    const key = resolveSettingsKey(ctx);
+    if (!key)
+        return analyticsSettingsSchema.parse({});
+    try {
+        const profile = await store.get(key);
+        return parseAnalyticsSettings(profile?.modules);
+    }
+    catch {
+        return analyticsSettingsSchema.parse({});
+    }
+}
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAA;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAErE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAEvD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,aAAa,EAAE,CAAC;SACb,IAAI,CAAC,OAAO,CAAC;SACb,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,yEAAyE,CAAC;IACtF,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CACP,kJAAkJ,CACnJ;CACJ,CAAC,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,aAAa,EAAE,CAAC;SACb,IAAI,CAAC,OAAO,CAAC;SACb,QAAQ,EAAE;SACV,QAAQ,CAAC,oDAAoD,CAAC;IACjE,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,0DAA0D,CAAC;CACxE,CAAC,CAAA;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,IAAI,CAAC,OAAO,CAAC;KACb,QAAQ,EAAE;KACV,QAAQ,CAAC,+EAA+E,CAAC,CAAA;AAE5F,mEAAmE;AACnE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,MAAM,EAAE;KACR,GAAG,EAAE;KACL,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,EAAE;KACV,QAAQ,CACP,oIAAoI,CACrI,CAAA;AAEH,uDAAuD;AACvD,MAAM,CAAC,MAAM,oBAAoB,GAAG,WAAW,CAAA;AAE/C;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAA4C;IAE5C,OAAO,gBAAgB,CAAC,uBAAuB,EAAE,OAAO,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAA;AACnF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAgC,EAChC,GAAa;IAEb,IAAI,CAAC,KAAK;QAAE,OAAO,uBAAuB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IACpD,MAAM,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAA;IACnC,IAAI,CAAC,GAAG;QAAE,OAAO,uBAAuB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAClD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACpC,OAAO,sBAAsB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,uBAAuB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC1C,CAAC;AACH,CAAC"}

package/dist/settings.test.d.ts

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

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

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

package/dist/settings.test.js

@@ -0,0 +1,299 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { parseToolResult } from "@miragon/mcp-toolkit-ui";
+import { createInMemoryProfileStore, runWithMcpRequestInfo, } from "@miragon/pulse-widget-shell/server";
+import { analyticsSettingsSaveInput, analyticsSettingsSchema, parseAnalyticsSettings, settingsFor, } from "./settings.js";
+import { registerSettingsTools } from "./settings-tools.js";
+import { ANALYTICS_SAVE_SETTINGS, ANALYTICS_SETTINGS_DATA } from "./tool-names.js";
+import { localizeFor } from "./server-locale.js";
+/** A feed's payload as the widget reads it (feeds answer in JSON text only). */
+const feedData = (result) => parseToolResult(result);
+afterEach(() => {
+    vi.restoreAllMocks();
+});
+/** A signed-in caller's handler ctx (mcp-use's flattened `ctx.auth`). */
+const CTX = { auth: { user: { id: "user-1" } } };
+describe("analyticsSettingsSchema", () => {
+    it("fills every default from an empty object", () => {
+        expect(analyticsSettingsSchema.parse({})).toEqual({ defaultPeriod: "7d", minBucketSize: 10 });
+    });
+});
+describe("analyticsSettingsSaveInput", () => {
+    // Zod 4 re-applies `.default()`s through `.partial()` — the save input must
+    // stay default-free so a single-field save can't reset the other saved value
+    // at the tool boundary.
+    it("keeps omitted fields ABSENT instead of materializing defaults", () => {
+        expect(analyticsSettingsSaveInput.parse({ minBucketSize: 5 })).toEqual({ minBucketSize: 5 });
+        expect(analyticsSettingsSaveInput.parse({})).toEqual({});
+    });
+});
+describe("parseAnalyticsSettings", () => {
+    it("returns defaults when the slice is absent", () => {
+        expect(parseAnalyticsSettings(undefined)).toEqual({ defaultPeriod: "7d", minBucketSize: 10 });
+        expect(parseAnalyticsSettings({})).toEqual({ defaultPeriod: "7d", minBucketSize: 10 });
+    });
+    it("returns defaults for a garbage slice (fail-soft)", () => {
+        expect(parseAnalyticsSettings({ analytics: "nope" })).toEqual({
+            defaultPeriod: "7d",
+            minBucketSize: 10,
+        });
+        expect(parseAnalyticsSettings({ analytics: { defaultPeriod: "yesterday" } })).toEqual({
+            defaultPeriod: "7d",
+            minBucketSize: 10,
+        });
+    });
+    it("degrades per FIELD: one invalid value keeps the other saved preference", () => {
+        expect(parseAnalyticsSettings({ analytics: { defaultPeriod: "yesterday", minBucketSize: 5 } })).toEqual({ defaultPeriod: "7d", minBucketSize: 5 });
+    });
+    it("parses a valid slice and fills missing fields with defaults", () => {
+        expect(parseAnalyticsSettings({ analytics: { defaultPeriod: "30d" } })).toEqual({
+            defaultPeriod: "30d",
+            minBucketSize: 10,
+        });
+    });
+    it("ignores other modules' slices", () => {
+        expect(parseAnalyticsSettings({ other: { defaultPeriod: "1d" } })).toEqual({
+            defaultPeriod: "7d",
+            minBucketSize: 10,
+        });
+    });
+});
+describe("settingsFor", () => {
+    it("returns defaults without a store", async () => {
+        expect(await settingsFor(undefined)).toEqual({ defaultPeriod: "7d", minBucketSize: 10 });
+    });
+    it("reads the slice off the profile record", async () => {
+        const store = {
+            get: () => Promise.resolve({ modules: { analytics: { defaultPeriod: "14d", minBucketSize: 3 } } }),
+        };
+        expect(await settingsFor(store, CTX)).toEqual({ defaultPeriod: "14d", minBucketSize: 3 });
+        // No caller identity → the defaults, never someone else's slice.
+        expect(await settingsFor(store)).toEqual({ defaultPeriod: "7d", minBucketSize: 10 });
+    });
+    it("falls back to defaults when the store throws (outage must not fail analytics reads)", async () => {
+        const store = {
+            get: () => Promise.reject(new Error("connection refused")),
+        };
+        expect(await settingsFor(store, CTX)).toEqual({ defaultPeriod: "7d", minBucketSize: 10 });
+    });
+});
+describe("localizeFor", () => {
+    it("binds the translate to the profile language", async () => {
+        const store = { get: () => Promise.resolve({ language: "de" }) };
+        const t = await localizeFor(store, CTX);
+        expect(t("aSettings.heading")).toBe("Analyse-Einstellungen");
+    });
+    it("falls back to English on a store OUTAGE, like settingsFor", async () => {
+        const store = { get: () => Promise.reject(new Error("connection refused")) };
+        const t = await localizeFor(store, CTX);
+        expect(t("aSettings.heading")).toBe("Analytics settings");
+    });
+});
+describe("registerSettingsTools", () => {
+    // `toolset` is a plain string here on purpose: an untyped (JS) caller can
+    // hand the gate any name, and the gate must still resolve it fail-closed.
+    function registeredToolNames(store, toolset) {
+        const tool = vi.fn();
+        const server = { tool };
+        registerSettingsTools(server, store, toolset);
+        return tool.mock.calls.map((c) => c[0].name);
+    }
+    const writable = {
+        get: () => Promise.resolve(undefined),
+        save: () => Promise.resolve({}),
+    };
+    it('registers the save tool with a writable store in the "standard" toolset', () => {
+        expect(registeredToolNames(writable, "standard")).toEqual([
+            "analytics_show_settings",
+            ANALYTICS_SETTINGS_DATA,
+            ANALYTICS_SAVE_SETTINGS,
+        ]);
+    });
+    it("stays read-only without a writable store (no save tool), even in standard", () => {
+        const readOnly = { get: () => Promise.resolve(undefined) };
+        expect(registeredToolNames(readOnly, "standard")).toEqual([
+            "analytics_show_settings",
+            ANALYTICS_SETTINGS_DATA,
+        ]);
+        expect(registeredToolNames(undefined, "standard")).toEqual([
+            "analytics_show_settings",
+            ANALYTICS_SETTINGS_DATA,
+        ]);
+    });
+    it("fails closed WITHOUT a toolset: a writable store alone registers no save tool", () => {
+        // A missing toolset is the read-only floor (silently — it is the
+        // documented default of a direct caller, not a misconfiguration).
+        const warn = vi.spyOn(console, "warn").mockImplementation(() => { });
+        expect(registeredToolNames(writable)).toEqual([
+            "analytics_show_settings",
+            ANALYTICS_SETTINGS_DATA,
+        ]);
+        expect(warn).not.toHaveBeenCalled();
+    });
+    it('drops the durable save tool in the "read-only" toolset, fails closed on unknown names', () => {
+        const warn = vi.spyOn(console, "warn").mockImplementation(() => { });
+        expect(registeredToolNames(writable, "read-only")).toEqual([
+            "analytics_show_settings",
+            ANALYTICS_SETTINGS_DATA,
+        ]);
+        expect(registeredToolNames(writable, "nonsense")).toEqual([
+            "analytics_show_settings",
+            ANALYTICS_SETTINGS_DATA,
+        ]);
+        expect(warn).toHaveBeenCalledWith(expect.stringContaining('Unknown toolset "nonsense"'));
+    });
+    it("a save-less section reports canSave false even for an identified caller", async () => {
+        const tool = vi.fn();
+        registerSettingsTools({ tool }, writable, "read-only");
+        const data = tool.mock.calls.find((c) => c[0].name === ANALYTICS_SETTINGS_DATA)[1];
+        const view = await runWithMcpRequestInfo({ authUserId: "user-7" }, () => data());
+        expect(feedData(view).canSave).toBe(false);
+    });
+    it("the model summary points at the save tool only when it is registered", async () => {
+        const show = async (toolset) => {
+            const tool = vi.fn();
+            registerSettingsTools({ tool }, writable, toolset);
+            const handler = tool.mock.calls.find((c) => c[0].name === "analytics_show_settings")[1];
+            return runWithMcpRequestInfo({ authUserId: "user-7" }, () => handler());
+        };
+        const defaults = { defaultPeriod: "7d", minBucketSize: 10 };
+        const standard = await show("standard");
+        expect(standard.content[0].text).toBe("Analytics settings: default period 7d, min bucket size 10. Change via analytics_save_settings.");
+        // A caller whose profile names no language follows the host: the server
+        // sets no view title (an English one would sit over a German view), and
+        // the section's own heading names the view (#322 U3).
+        expect(standard.structuredContent.title).toBeUndefined();
+        expect(standard.structuredContent).toMatchObject({
+            layout: [{ row: [{ widget: "analytics:settings" }] }],
+            context: {
+                stepData: {
+                    result: {
+                        data: { settings: defaults, canSave: true },
+                        _app: "analytics",
+                        _dataType: "analytics:settings",
+                    },
+                },
+            },
+        });
+        // On the read-only floor the save tool does not exist — advertising it to
+        // the model would send it to an unknown tool.
+        const readOnly = await show("read-only");
+        expect(readOnly.content[0].text).toBe("Analytics settings: default period 7d, min bucket size 10.");
+        expect(readOnly.structuredContent).toMatchObject({
+            context: { stepData: { result: { data: { settings: defaults, canSave: false } } } },
+        });
+    });
+    it("declares honest metadata for the settings triple", () => {
+        const tool = vi.fn();
+        registerSettingsTools({ tool }, writable, "standard");
+        const definitions = tool.mock.calls.map((c) => c[0]);
+        const readOnlyRead = { readOnlyHint: true, idempotentHint: true, openWorldHint: true };
+        expect(definitions.map(({ name, annotations }) => [name, annotations])).toEqual([
+            ["analytics_show_settings", readOnlyRead],
+            [ANALYTICS_SETTINGS_DATA, readOnlyRead],
+            [
+                ANALYTICS_SAVE_SETTINGS,
+                { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+            ],
+        ]);
+        for (const { name, title, description } of definitions) {
+            expect(title, `${name} title`).toBeTruthy();
+            expect(description, `${name} description`).toBeTruthy();
+        }
+    });
+    it("round-trips a save through the caller's record", async () => {
+        const store = createInMemoryProfileStore();
+        const tool = vi.fn();
+        registerSettingsTools({ tool }, store, "standard");
+        const handlerFor = (name) => {
+            const call = tool.mock.calls.find((c) => c[0].name === name);
+            if (!call)
+                throw new Error(`tool ${name} not registered`);
+            return call[1];
+        };
+        const saved = await handlerFor(ANALYTICS_SAVE_SETTINGS)({ defaultPeriod: "30d" }, CTX);
+        // The widget reads the EFFECTIVE slice back from structuredContent; the
+        // model gets the localized confirmation.
+        expect(saved.structuredContent).toEqual({ defaultPeriod: "30d", minBucketSize: 10 });
+        expect(saved.content).toEqual([
+            {
+                type: "text",
+                text: "Analytics settings saved: default period 30d, min bucket size 10.",
+            },
+        ]);
+        // Only the provided field is persisted — no defaults materialized into
+        // storage, so a later default change applies to fields never set.
+        expect((await store.get("user-1"))?.modules).toEqual({
+            analytics: { defaultPeriod: "30d" },
+        });
+        const data = await handlerFor(ANALYTICS_SETTINGS_DATA)({}, CTX);
+        expect(feedData(data).settings).toEqual({ defaultPeriod: "30d", minBucketSize: 10 });
+    });
+    it("a partial save keeps the other saved value (the store merges the patch)", async () => {
+        const store = createInMemoryProfileStore();
+        const tool = vi.fn();
+        registerSettingsTools({ tool }, store, "standard");
+        const call = tool.mock.calls.find((c) => c[0].name === ANALYTICS_SAVE_SETTINGS);
+        const save = call[1];
+        await save({ defaultPeriod: "30d" }, CTX);
+        const saved = await save({ minBucketSize: 5 }, CTX);
+        expect((await store.get("user-1"))?.modules).toEqual({
+            analytics: { defaultPeriod: "30d", minBucketSize: 5 },
+        });
+        // The report is the SAVED slice, not just this call's patch.
+        expect(saved.structuredContent).toEqual({ defaultPeriod: "30d", minBucketSize: 5 });
+    });
+    it("concurrent saves of the two fields keep both, even when one already held a value", async () => {
+        // Writes land after a round-trip, like a database's: the second save runs
+        // while the first one's write is still in flight. A save that handed the
+        // store a slice pre-read outside its lock would write the stale period back.
+        const inner = createInMemoryProfileStore();
+        await inner.save("user-1", { modules: { analytics: { defaultPeriod: "7d" } } });
+        const store = {
+            get: (key) => inner.get(key),
+            save: async (key, input, opts) => {
+                await new Promise((resolve) => setTimeout(resolve, 10));
+                return inner.save(key, input, opts);
+            },
+        };
+        const tool = vi.fn();
+        registerSettingsTools({ tool }, store, "standard");
+        const save = tool.mock.calls.find((c) => c[0].name === ANALYTICS_SAVE_SETTINGS)[1];
+        const first = save({ defaultPeriod: "30d" }, CTX);
+        await new Promise((resolve) => setTimeout(resolve, 1));
+        await Promise.all([first, save({ minBucketSize: 25 }, CTX)]);
+        expect((await inner.get("user-1"))?.modules).toEqual({
+            analytics: { defaultPeriod: "30d", minBucketSize: 25 },
+        });
+    });
+    // HTTP without OAuth: the ambient request info exists but carries no
+    // identity — the section must go read-only and the save tool must refuse
+    // with an actionable cause.
+    it("identity gating: canSave false + save refusal without identity, true with an auth user", async () => {
+        const tool = vi.fn();
+        registerSettingsTools({ tool }, { get: () => Promise.resolve(undefined), save: () => Promise.resolve({}) }, "standard");
+        const handlerFor = (name) => {
+            const call = tool.mock.calls.find((c) => c[0].name === name);
+            if (!call)
+                throw new Error(`tool ${name} not registered`);
+            return call[1];
+        };
+        const bare = await runWithMcpRequestInfo({}, () => handlerFor(ANALYTICS_SETTINGS_DATA)({}));
+        expect(feedData(bare).canSave).toBe(false);
+        const refused = await runWithMcpRequestInfo({}, () => handlerFor(ANALYTICS_SAVE_SETTINGS)({ defaultPeriod: "30d" }));
+        expect(refused.isError).toBe(true);
+        expect(refused.content?.[0]?.text).toContain("MCP_OAUTH");
+        const authed = await runWithMcpRequestInfo({ authUserId: "user-7" }, () => handlerFor(ANALYTICS_SETTINGS_DATA)({}));
+        expect(feedData(authed).canSave).toBe(true);
+    });
+    it("stamps the OAuth caller on the saved record as its owner", async () => {
+        const save = vi.fn(() => Promise.resolve({}));
+        const tool = vi.fn();
+        registerSettingsTools({ tool }, { get: () => Promise.resolve(undefined), save }, "standard");
+        const handler = tool.mock.calls.find((c) => c[0].name === ANALYTICS_SAVE_SETTINGS)[1];
+        await runWithMcpRequestInfo({ authUserId: "user-7" }, () => handler({ minBucketSize: 5 }));
+        expect(save).toHaveBeenCalledOnce();
+        expect(save.mock.calls[0][1]).toEqual({ modules: { analytics: { minBucketSize: 5 } } });
+        expect(save.mock.calls[0][2]).toEqual({ userId: "user-7" });
+    });
+});
+//# sourceMappingURL=settings.test.js.map

package/dist/settings.test.js.map

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

package/dist/steps/app-config.d.ts

@@ -0,0 +1,30 @@
+import { type PrometheusClient, type Period } from "@miragon/pulse-analytics-client";
+import type { AnalyticsEngineScope } from "../engine-ids.js";
+import type { ProfileSource } from "../server-locale.js";
+import type { NameLookup } from "../bpmn-name-lookup.js";
+/** What the analytics plugin hands its pipeline steps (`appConfig` in `plugin.ts`). */
+export interface AnalyticsAppConfig {
+    client: PrometheusClient;
+    /** The server's configured engine ids — a step never reads an engine outside them. */
+    engineScope: AnalyticsEngineScope;
+    /** The shared profile store — the source of the caller's saved analytics defaults. */
+    profileStore?: ProfileSource;
+    /** The process names behind the ids, the same lookup the tools use (absent → ids). */
+    namesFor?: NameLookup;
+}
+/** The optional `analytics:engine` scoping key both steps read. */
+export declare const ENGINE_KEY_DECLARATION: {
+    key: string;
+    description: string;
+};
+/** The step's `analytics:engine` key resolved to configured ids (omitted = all of them). */
+export declare function stepEngines(keys: Record<string, unknown>, engineScope: AnalyticsEngineScope): string[];
+/**
+ * The step's `analytics:period`: the key when set, else the CALLER's saved
+ * analytics default (resolved from the ambient request — a step gets no
+ * handler ctx), else the module default — the tools' precedence.
+ */
+export declare function stepPeriod(keys: Record<string, unknown>, profileStore: ProfileSource | undefined): Promise<Period>;
+/** The step's optional `analytics:processDefinitionKey` (omitted = every process). */
+export declare function stepProcessKey(keys: Record<string, unknown>): string | undefined;
+//# sourceMappingURL=app-config.d.ts.map

package/dist/steps/app-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-config.d.ts","sourceRoot":"","sources":["../../src/steps/app-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,gBAAgB,EAAE,KAAK,MAAM,EAAE,MAAM,iCAAiC,CAAA;AAC7F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAExD,uFAAuF;AACvF,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,gBAAgB,CAAA;IACxB,sFAAsF;IACtF,WAAW,EAAE,oBAAoB,CAAA;IACjC,sFAAsF;IACtF,YAAY,CAAC,EAAE,aAAa,CAAA;IAC5B,sFAAsF;IACtF,QAAQ,CAAC,EAAE,UAAU,CAAA;CACtB;AAUD,mEAAmE;AACnE,eAAO,MAAM,sBAAsB;;;CAIlC,CAAA;AAED,4FAA4F;AAC5F,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,EAAE,oBAAoB,GAChC,MAAM,EAAE,CAYV;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,YAAY,EAAE,aAAa,GAAG,SAAS,GACtC,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAMhF"}

package/dist/steps/app-config.js

@@ -0,0 +1,46 @@
+import { PERIODS } from "@miragon/pulse-analytics-client";
+import { settingsFor } from "../settings.js";
+/*
+ * Step keys arrive unchecked: render-view and the builder accept them as a
+ * free-form record and pass them through untouched. So each reader below holds
+ * the line the tools' strict inputs hold — a malformed value is refused naming
+ * its key, never read as "omitted" (which would widen `analytics:engine` to the
+ * whole fleet, or swap in a default period nobody asked for).
+ */
+/** The optional `analytics:engine` scoping key both steps read. */
+export const ENGINE_KEY_DECLARATION = {
+    key: "analytics:engine",
+    description: "Engine id, or a list of ids, to scope to (one of the server's configured engines). When omitted, every configured engine is aggregated — the result's `engines` names them.",
+};
+/** The step's `analytics:engine` key resolved to configured ids (omitted = all of them). */
+export function stepEngines(keys, engineScope) {
+    const raw = keys[ENGINE_KEY_DECLARATION.key];
+    const wellFormed = raw === undefined ||
+        typeof raw === "string" ||
+        (Array.isArray(raw) && raw.every((id) => typeof id === "string"));
+    if (!wellFormed) {
+        throw new Error(`${ENGINE_KEY_DECLARATION.key} must be an engine id or a list of engine ids — omit it to cover every configured engine.`);
+    }
+    return engineScope.resolve(raw);
+}
+/**
+ * The step's `analytics:period`: the key when set, else the CALLER's saved
+ * analytics default (resolved from the ambient request — a step gets no
+ * handler ctx), else the module default — the tools' precedence.
+ */
+export async function stepPeriod(keys, profileStore) {
+    const raw = keys["analytics:period"];
+    if (raw === undefined)
+        return (await settingsFor(profileStore)).defaultPeriod;
+    if (PERIODS.includes(raw))
+        return raw;
+    throw new Error(`analytics:period must be one of ${PERIODS.join(", ")} — omit it for the caller's saved default.`);
+}
+/** The step's optional `analytics:processDefinitionKey` (omitted = every process). */
+export function stepProcessKey(keys) {
+    const raw = keys["analytics:processDefinitionKey"];
+    if (raw === undefined || typeof raw === "string")
+        return raw;
+    throw new Error("analytics:processDefinitionKey must be a process definition key (a string) — omit it to cover every process.");
+}
+//# sourceMappingURL=app-config.js.map

package/dist/steps/app-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-config.js","sourceRoot":"","sources":["../../src/steps/app-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAsC,MAAM,iCAAiC,CAAA;AAG7F,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAc5C;;;;;;GAMG;AAEH,mEAAmE;AACnE,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,GAAG,EAAE,kBAAkB;IACvB,WAAW,EACT,6KAA6K;CAChL,CAAA;AAED,4FAA4F;AAC5F,MAAM,UAAU,WAAW,CACzB,IAA6B,EAC7B,WAAiC;IAEjC,MAAM,GAAG,GAAG,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAA;IAC5C,MAAM,UAAU,GACd,GAAG,KAAK,SAAS;QACjB,OAAO,GAAG,KAAK,QAAQ;QACvB,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAA;IACnE,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACb,GAAG,sBAAsB,CAAC,GAAG,2FAA2F,CACzH,CAAA;IACH,CAAC;IACD,OAAO,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;AACjC,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAA6B,EAC7B,YAAuC;IAEvC,MAAM,GAAG,GAAG,IAAI,CAAC,kBAAkB,CAAC,CAAA;IACpC,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,CAAC,MAAM,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAA;IAC7E,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAa,CAAC;QAAE,OAAO,GAAa,CAAA;IACzD,MAAM,IAAI,KAAK,CACb,mCAAmC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,4CAA4C,CAClG,CAAA;AACH,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,cAAc,CAAC,IAA6B;IAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,gCAAgC,CAAC,CAAA;IAClD,IAAI,GAAG,KAAK,SAAS,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAA;IAC5D,MAAM,IAAI,KAAK,CACb,8GAA8G,CAC/G,CAAA;AACH,CAAC"}

package/dist/steps/dashboard.d.ts

@@ -0,0 +1,12 @@
+import type { PipelineStepDefinition } from "@miragon/mcp-toolkit-core";
+import { type AnalyticsAppConfig } from "./app-config.js";
+/**
+ * Loads the dashboard figures from Prometheus — window flows plus the live
+ * state, the same `dashboardData` as `analytics_show_dashboard`. Consumed by
+ * `analytics:dashboard`. Reads optional filter keys:
+ * - `analytics:processDefinitionKey`
+ * - `analytics:period` (1d | 3d | 7d | 14d | 30d; omitted = the caller's saved default)
+ * - `analytics:engine` (configured engine id(s); omitted = all of them)
+ */
+export declare const loadDashboardStep: PipelineStepDefinition<AnalyticsAppConfig>;
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/steps/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/steps/dashboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AAKvE,OAAO,EAKL,KAAK,kBAAkB,EACxB,MAAM,iBAAiB,CAAA;AAMxB;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,EAAE,sBAAsB,CAAC,kBAAkB,CA+CxE,CAAA"}