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

package/dist/named-views.test.js

@@ -0,0 +1,110 @@
+import { describe, expect, it, vi } from "vitest";
+import { namedDashboard, namedFailureDashboard, namedLandscape } from "./named-views.js";
+import { createNameLookup } from "./bpmn-name-lookup.js";
+import { elementNameOf, processNameOf } from "./bpmn-names.js";
+/**
+ * Every view asks for the names of exactly the ids it lists, no more, by
+ * priority, on the engines its rows come from.
+ */
+describe("named views", () => {
+    const lookup = () => vi.fn(() => Promise.resolve({}));
+    it("the dashboard: its scope, the elements of its activities, then its definitions", async () => {
+        const namesFor = lookup();
+        const data = {
+            processDefinitionKey: "order",
+            engines: ["prod-b", "prod-a", "prod-c"],
+            reportingEngines: ["prod-a", "prod-b"],
+            definitionBreakdown: [{ processDefinitionKey: "order" }, { processDefinitionKey: "refund" }],
+            activityBreakdown: [
+                { processDefinitionKey: "order", activityId: "Task_A" },
+                { processDefinitionKey: "order", activityId: "Task_B" },
+            ],
+        };
+        const named = await namedDashboard(data, namesFor);
+        expect(named.names).toEqual({});
+        const [keys, request] = namesFor.mock.calls[0];
+        expect([...keys]).toEqual(["order", "order", "order", "order", "refund"]);
+        expect(request?.elementIds).toEqual({ order: ["Task_A", "Task_B"], refund: [] });
+        // The reporting engines, in the scope's (configuration) order; a silent one has no rows.
+        expect(request?.engines).toEqual(["prod-b", "prod-a"]);
+    });
+    it("the dashboard reads on its whole scope when the payload does not say which engines report", async () => {
+        const namesFor = lookup();
+        await namedDashboard({
+            processDefinitionKey: null,
+            engines: ["prod-a", "prod-b"],
+            definitionBreakdown: [],
+            activityBreakdown: [],
+        }, namesFor);
+        expect(namesFor.mock.calls[0][1]?.engines).toEqual(["prod-a", "prod-b"]);
+    });
+    it("names a process key such as constructor like any other", async () => {
+        const namesFor = lookup();
+        await namedDashboard({
+            processDefinitionKey: null,
+            engines: null,
+            definitionBreakdown: [{ processDefinitionKey: "constructor" }],
+            activityBreakdown: [{ processDefinitionKey: "constructor", activityId: "Task_A" }],
+        }, namesFor);
+        expect(namesFor.mock.calls[0][1]?.elementIds).toEqual({ constructor: ["Task_A"] });
+        expect(namesFor.mock.calls[0][1]?.engines).toBeNull();
+    });
+    // The lookup reads at most 40 models per view: a fleet with more
+    // definitions must not lose the names of its bottleneck activities to the
+    // long tail of the breakdown (sorted by starts).
+    it("keeps the activities' names when the fleet has more than 40 definitions", async () => {
+        const fetchBpmnXml = vi.fn((key) => Promise.resolve(`<process id="${key}" name="Process ${key}"><userTask id="Task_Slow" name="Review"/></process>`));
+        const definitions = Array.from({ length: 45 }, (_, i) => ({ processDefinitionKey: `p${i}` }));
+        const data = {
+            processDefinitionKey: null,
+            engines: ["prod-a"],
+            reportingEngines: ["prod-a"],
+            definitionBreakdown: definitions,
+            // A long-running, low-volume process: the last of the breakdown.
+            activityBreakdown: [{ processDefinitionKey: "p44", activityId: "Task_Slow" }],
+        };
+        const { names } = await namedDashboard(data, createNameLookup(fetchBpmnXml));
+        expect(elementNameOf(names, "p44", "Task_Slow")).toBe("Review");
+        expect(processNameOf(names, "p44")).toBe("Process p44");
+        expect(fetchBpmnXml).toHaveBeenCalledTimes(40);
+        // The cap falls on the end of the breakdown instead.
+        expect(processNameOf(names, "p0")).toBe("Process p0");
+        expect(processNameOf(names, "p40")).toBeNull();
+    });
+    it("the failure dashboard: process names only, its most affected first, on its engines", async () => {
+        const failures = lookup();
+        await namedFailureDashboard({
+            engines: ["prod-a", "prod-b"],
+            errorPatterns: [{ processDefinitionKey: "a" }],
+            processBreakdown: [{ processDefinitionKey: "b" }],
+            mostAffectedProcess: "b",
+        }, failures);
+        expect([...failures.mock.calls[0][0]]).toEqual(["b", "a", "b"]);
+        expect(failures.mock.calls[0][1]).toEqual({
+            elementIds: { a: [], b: [] },
+            engines: ["prod-a", "prod-b"],
+        });
+        const none = lookup();
+        await namedFailureDashboard({
+            engines: ["prod-a"],
+            errorPatterns: [],
+            processBreakdown: [],
+            mostAffectedProcess: null,
+        }, none);
+        expect([...none.mock.calls[0][0]]).toEqual([]);
+    });
+    it("the landscape: each process read on the engines it runs on", async () => {
+        const landscape = lookup();
+        await namedLandscape({
+            processes: [
+                { processDefinitionKey: "c", engineIds: ["prod-b", "prod-c"] },
+                { processDefinitionKey: "d", engineIds: ["prod-a"] },
+            ],
+        }, landscape);
+        expect(landscape.mock.calls[0][1]).toEqual({
+            elementIds: { c: [], d: [] },
+            enginesByKey: { c: ["prod-b", "prod-c"], d: ["prod-a"] },
+        });
+    });
+});
+//# sourceMappingURL=named-views.test.js.map

package/dist/named-views.test.js.map

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

package/dist/plugin.d.ts

@@ -0,0 +1,44 @@
+import type { AppPlugin } from "@miragon/mcp-toolkit-core";
+import type { MCPServer } from "mcp-use";
+import { type PrometheusConfig } from "@miragon/pulse-analytics-client";
+import { type FetchBpmnXml } from "./bpmn-name-lookup.js";
+import type { ProfileSource } from "./server-locale.js";
+/**
+ * `PrometheusConfig` carries the connection: the base URL (e.g.
+ * http://localhost:9090), optional bearer/basic auth + extra headers, and the
+ * per-query deadline (`timeoutMs`).
+ */
+export interface AnalyticsPluginConfig extends PrometheusConfig {
+    /**
+     * Optional BPMN-XML lookup used by widget tools that enrich metric data with
+     * engine lookups — the BPMN heatmap's diagram, and the process and activity
+     * names the dashboards, the failure dashboard and the landscape show in
+     * place of ids. Injected by the host app (which owns the engine client) so
+     * this module stays free of engine SDKs. When absent, the heatmap degrades
+     * to a non-diagram fallback and the views show ids.
+     */
+    fetchBpmnXml?: FetchBpmnXml;
+    /**
+     * Profile store (shared with camunda7): locale for model-facing summaries,
+     * plus this module's own settings slice (`modules.analytics`) — read for
+     * period/minBucketSize defaults, written by `analytics_save_settings`.
+     */
+    profileStore?: ProfileSource;
+    /**
+     * The module's toolset (`analyticsModule` passes the one the composition
+     * root resolved). `"read-only"` — also what an ABSENT or unknown toolset
+     * resolves to (an unknown name warns) — registers no settings save tool;
+     * `"standard"` registers it, given a writable `profileStore`. Typed `string`
+     * like camunda7's, so callers can pass a configured value through; it is
+     * resolved fail-closed here.
+     */
+    toolset?: string;
+    /**
+     * The engine ids analytics may read — the server's configured engines.
+     * Empty or absent: every engine-reading tool refuses (fail-closed), see
+     * `engine-ids.ts`.
+     */
+    engineIds?: readonly string[];
+}
+export declare function createPlugin(config: AnalyticsPluginConfig): AppPlugin<MCPServer>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAExC,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAI/F,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAE3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAKvD;;;;GAIG;AACH,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;IAC7D;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B;;;;OAIG;IACH,YAAY,CAAC,EAAE,aAAa,CAAA;IAC5B;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC9B;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,qBAAqB,GAAG,SAAS,CAAC,SAAS,CAAC,CAyChF"}

package/dist/plugin.js

@@ -0,0 +1,52 @@
+import { installMcpRequestContext } from "@miragon/pulse-widget-shell/server";
+import { createPrometheusClient } from "@miragon/pulse-analytics-client";
+import { registerTools } from "./tools/index.js";
+import { registerSettingsTools } from "./settings-tools.js";
+import { registerWidgetTools } from "./widget-tools.js";
+import { createNameLookup } from "./bpmn-name-lookup.js";
+import { definition } from "./definition.js";
+import { analyticsToolsets } from "./toolsets.js";
+import { createEngineScope } from "./engine-ids.js";
+export function createPlugin(config) {
+    const client = createPrometheusClient({
+        url: config.url,
+        bearerToken: config.bearerToken,
+        username: config.username,
+        password: config.password,
+        headers: config.headers,
+        timeoutMs: config.timeoutMs,
+    });
+    const engineScope = createEngineScope(config.engineIds);
+    // ONE name lookup (and its per-caller cache) for the tools, the feeds and the steps.
+    const namesFor = createNameLookup(config.fetchBpmnXml);
+    // The steps get the profile store too: a step's omitted period resolves to
+    // the caller's saved default, like every tool's.
+    const appConfig = {
+        client,
+        engineScope,
+        profileStore: config.profileStore,
+        namesFor,
+    };
+    return {
+        definition,
+        appConfig,
+        // Tools and feeds resolve the caller (saved defaults, summary locale) from
+        // the handler ctx. The pipeline steps get none, so their saved-period
+        // lookup reads the ambient request info — installed here like camunda7
+        // does (idempotent; the host installs it too).
+        registerTools: (server) => {
+            installMcpRequestContext(server);
+            registerTools(server, client, engineScope, config.profileStore);
+        },
+        registerWidgetTools: (server) => {
+            registerWidgetTools(server, client, {
+                fetchBpmnXml: config.fetchBpmnXml,
+                namesFor,
+                profileStore: config.profileStore,
+                engineScope,
+            });
+            registerSettingsTools(server, config.profileStore, analyticsToolsets.resolve(config.toolset));
+        },
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAA;AAC7E,OAAO,EAAE,sBAAsB,EAAyB,MAAM,iCAAiC,CAAA;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,gBAAgB,EAAqB,MAAM,uBAAuB,CAAA;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAyCnD,MAAM,UAAU,YAAY,CAAC,MAA6B;IACxD,MAAM,MAAM,GAAG,sBAAsB,CAAC;QACpC,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC,CAAA;IACF,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IACvD,qFAAqF;IACrF,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;IACtD,2EAA2E;IAC3E,iDAAiD;IACjD,MAAM,SAAS,GAAG;QAChB,MAAM;QACN,WAAW;QACX,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,QAAQ;KACoB,CAAA;IAC9B,OAAO;QACL,UAAU;QACV,SAAS;QACT,2EAA2E;QAC3E,sEAAsE;QACtE,uEAAuE;QACvE,+CAA+C;QAC/C,aAAa,EAAE,CAAC,MAAM,EAAE,EAAE;YACxB,wBAAwB,CAAC,MAAM,CAAC,CAAA;YAChC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,YAAY,CAAC,CAAA;QACjE,CAAC;QACD,mBAAmB,EAAE,CAAC,MAAM,EAAE,EAAE;YAC9B,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE;gBAClC,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,QAAQ;gBACR,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,WAAW;aACZ,CAAC,CAAA;YACF,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,iBAAiB,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;QAC/F,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/prometheus-wiring.test.d.ts

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

package/dist/prometheus-wiring.test.d.ts.map

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

package/dist/prometheus-wiring.test.js

@@ -0,0 +1,142 @@
+import http from "node:http";
+import { afterAll, beforeAll, describe, expect, it } from "vitest";
+import { analyticsModule } from "./module.js";
+import { ANALYTICS_ENGINE_LANDSCAPE_DATA } from "./tool-names.js";
+const seenAuth = [];
+const seenTenant = [];
+let hang = false;
+const prometheus = http.createServer((req, res) => {
+    seenAuth.push(req.headers.authorization);
+    seenTenant.push(req.headers["x-scope-orgid"]);
+    if (hang)
+        return;
+    res.writeHead(200, { "Content-Type": "application/json" });
+    res.end(JSON.stringify({ status: "success", data: { resultType: "vector", result: [] } }));
+});
+let url = "";
+beforeAll(async () => {
+    await new Promise((resolve) => prometheus.listen(0, "127.0.0.1", resolve));
+    url = `http://127.0.0.1:${prometheus.address().port}`;
+});
+afterAll(async () => {
+    prometheus.closeAllConnections();
+    await new Promise((resolve) => prometheus.close(() => resolve()));
+});
+/** A standalone analytics boot names the engines it may read (`engine-ids.ts`). */
+const ENGINES = { ANALYTICS_ENGINE_IDS: "prod-a,prod-b" };
+/** Boots the module from env the way the composition root does; returns its tools. */
+function boot(env) {
+    const tools = new Map();
+    const server = {
+        tool: (definition, callback) => {
+            tools.set(definition.name, callback);
+        },
+        use: () => { },
+    };
+    const plugin = analyticsModule.createPlugin({
+        ...analyticsModule.configFromEnv({ PROMETHEUS_URL: url, ...ENGINES, ...env }),
+        toolset: "read-only",
+    }, {});
+    plugin.registerTools?.(server);
+    plugin.registerWidgetTools?.(server);
+    return tools;
+}
+describe("Prometheus config reaches the wire", () => {
+    it("PROMETHEUS_BEARER_TOKEN authenticates every query of a registrar tool", async () => {
+        hang = false;
+        seenAuth.length = 0;
+        const tools = boot({ PROMETHEUS_BEARER_TOKEN: "tok-123" });
+        const result = await tools.get("analytics_engine_landscape")({});
+        expect(result.isError).toBeFalsy();
+        expect(seenAuth.length).toBeGreaterThan(0);
+        expect(seenAuth.every((auth) => auth === "Bearer tok-123")).toBe(true);
+    });
+    it("PROMETHEUS_HEADERS and PROMETHEUS_USERNAME/PROMETHEUS_PASSWORD reach every query", async () => {
+        hang = false;
+        seenAuth.length = 0;
+        seenTenant.length = 0;
+        const tools = boot({
+            PROMETHEUS_HEADERS: '{"X-Scope-OrgID":"tenant-a"}',
+            PROMETHEUS_USERNAME: "grafana",
+            PROMETHEUS_PASSWORD: "hunter2-pass",
+        });
+        const result = await tools.get("analytics_engine_landscape")({});
+        expect(result.isError).toBeFalsy();
+        expect(seenTenant.length).toBeGreaterThan(0);
+        expect(seenTenant.every((tenant) => tenant === "tenant-a")).toBe(true);
+        const basic = `Basic ${Buffer.from("grafana:hunter2-pass").toString("base64")}`;
+        expect(seenAuth.every((auth) => auth === basic)).toBe(true);
+    });
+    it("PROMETHEUS_TIMEOUT_MS bounds a hung Prometheus", async () => {
+        hang = true;
+        const tools = boot({ PROMETHEUS_TIMEOUT_MS: "60" });
+        const result = await tools.get("analytics_engine_landscape")({});
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toBe("Prometheus did not respond within 60 ms (timeout)");
+    });
+    it("EVERY widget tool and feed hands ctx.signal to its queries", async () => {
+        hang = false;
+        const tools = new Map();
+        const server = {
+            tool: (definition, callback) => {
+                tools.set(definition.name, callback);
+            },
+        };
+        analyticsModule
+            .createPlugin({
+            ...analyticsModule.configFromEnv({ PROMETHEUS_URL: url, ...ENGINES }),
+            toolset: "read-only",
+        }, {})
+            .registerWidgetTools?.(server);
+        // Each handler runs twice with args every tool accepts: unsignalled it
+        // must reach Prometheus, with an already-aborted ctx.signal it must not —
+        // a handler that drops ctx would still query. Tools that never query are
+        // named.
+        const args = {
+            processDefinitionKey: "order",
+            // Handlers called directly get no schema defaults: the compare windows.
+            windowDays: 7,
+            windowBeforeDays: 3,
+            windowAfterDays: 3,
+            // Relative to now: compare windows are held inside the retention.
+            deploymentTimestamp: new Date(Date.now() - 3 * 86_400_000).toISOString(),
+            engineA: "prod-a",
+            engineB: "prod-b",
+        };
+        const queriesOf = async (name, ctx) => {
+            const before = seenAuth.length;
+            await tools.get(name)(args, ctx);
+            return seenAuth.length - before;
+        };
+        const neverQuery = [];
+        for (const name of tools.keys()) {
+            if ((await queriesOf(name, {})) === 0) {
+                neverQuery.push(name);
+                continue;
+            }
+            expect({ name, queries: await queriesOf(name, { signal: AbortSignal.abort() }) }).toEqual({
+                name,
+                queries: 0,
+            });
+        }
+        // The settings and the heatmap's diagram (read from the engine) never ask Prometheus.
+        expect(neverQuery.sort()).toEqual([
+            "analytics_bpmn_xml_data",
+            "analytics_settings_data",
+            "analytics_show_settings",
+        ]);
+        expect(tools.size - neverQuery.length).toBeGreaterThanOrEqual(11);
+    });
+    it("a widget feed's ctx.signal cancels its queries before the deadline", async () => {
+        hang = true;
+        const tools = boot({ PROMETHEUS_TIMEOUT_MS: "10000" });
+        const controller = new AbortController();
+        setTimeout(() => controller.abort(), 30);
+        const started = Date.now();
+        const result = await tools.get(ANALYTICS_ENGINE_LANDSCAPE_DATA)({}, { signal: controller.signal });
+        expect(Date.now() - started).toBeLessThan(5_000);
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toBe("Prometheus query cancelled by the caller");
+    });
+});
+//# sourceMappingURL=prometheus-wiring.test.js.map

package/dist/prometheus-wiring.test.js.map

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

package/dist/server-locale.d.ts

@@ -0,0 +1,48 @@
+import { resolveAuthUserId, resolveProfileKey } from "@miragon/pulse-widget-shell/server";
+/**
+ * The profile port + key resolution come from the shared server kit, NOT from a
+ * module-local copy: every module reads and writes the same profile record, so
+ * a divergent key precedence (or a differently-spelled anonymous fallback)
+ * would silently split a user's settings across two records. Re-exported under
+ * this module's names so the call sites read in analytics vocabulary.
+ *
+ * `ProfileSource` is the minimal read/write view a module needs — the locale
+ * plus its own slice under `modules.analytics`. camunda7's `ProfileStore`
+ * satisfies it structurally, without analytics depending on the camunda7
+ * module; `save` merges per module key on the store side, so writing
+ * `modules.analytics` never touches other modules' slices.
+ */
+export type { ProfileSlice, ProfileSource } from "@miragon/pulse-widget-shell/server";
+/**
+ * Resolve the profile key for the in-flight request: the OAuth caller (off the
+ * tool-handler `ctx`), else `anonymous` for an explicitly declared local
+ * caller (stdio, tests). A request without OAuth resolves `undefined` — reads
+ * fall back to defaults, saves fail visibly, so unrelated callers never
+ * cross-share one record.
+ */
+export declare const resolveSettingsKey: typeof resolveProfileKey;
+/**
+ * Just the OAuth half of {@link resolveSettingsKey} — the save path stamps it
+ * onto the record as its owner (`opts.userId`).
+ */
+export declare const resolveSettingsAuthUserId: typeof resolveAuthUserId;
+/** A locale-bound translate for summaries; a show tool's summary translate + view title. */
+export type { ServerT, ViewLocale } from "@miragon/pulse-widget-shell/server";
+/**
+ * Resolve the request locale and return a translate bound to it + the analytics
+ * catalogs — `const t = await localizeFor(store, ctx); … summary: t("key", { … })`.
+ * Pass the tool-handler `ctx` so an auth user id resolves the same record the
+ * save path writes. Locale resolution + the fail-soft rules (no store, no key,
+ * store OUTAGE → English) come from the shared `createLocalizeFor`.
+ */
+export declare const localizeFor: (store?: import("@miragon/pulse-widget-shell/server").ProfileSource, ctx?: unknown) => Promise<import("@miragon/pulse-widget-shell/server").ServerT>;
+/**
+ * {@link localizeFor} plus the view title, from ONE profile read — the kit's
+ * one title rule for every module's show tools: a view is titled only in a
+ * language the profile names; with "system" (the default), no caller or a
+ * store outage it carries no title, and the widget's own heading names it in
+ * the host's language (#322 U3). Summaries stay `t`:
+ * `const { t, title } = await localizeViewFor(store, ctx); … title: title("key")`.
+ */
+export declare const localizeViewFor: (store?: import("@miragon/pulse-widget-shell/server").ProfileSource, ctx?: unknown) => Promise<import("@miragon/pulse-widget-shell/server").ViewLocale>;
+//# sourceMappingURL=server-locale.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server-locale.d.ts","sourceRoot":"","sources":["../src/server-locale.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,oCAAoC,CAAA;AAG3C;;;;;;;;;;;;GAYG;AACH,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAA;AAErF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,0BAAoB,CAAA;AAEnD;;;GAGG;AACH,eAAO,MAAM,yBAAyB,0BAAoB,CAAA;AAE1D,4FAA4F;AAC5F,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAE7E;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,sJAAgC,CAAA;AAExD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,yJAAoC,CAAA"}

package/dist/server-locale.js

@@ -0,0 +1,33 @@
+import { createLocalizeFor, createLocalizeViewFor, resolveAuthUserId, resolveProfileKey, } from "@miragon/pulse-widget-shell/server";
+import { translator } from "./messages/index.js";
+/**
+ * Resolve the profile key for the in-flight request: the OAuth caller (off the
+ * tool-handler `ctx`), else `anonymous` for an explicitly declared local
+ * caller (stdio, tests). A request without OAuth resolves `undefined` — reads
+ * fall back to defaults, saves fail visibly, so unrelated callers never
+ * cross-share one record.
+ */
+export const resolveSettingsKey = resolveProfileKey;
+/**
+ * Just the OAuth half of {@link resolveSettingsKey} — the save path stamps it
+ * onto the record as its owner (`opts.userId`).
+ */
+export const resolveSettingsAuthUserId = resolveAuthUserId;
+/**
+ * Resolve the request locale and return a translate bound to it + the analytics
+ * catalogs — `const t = await localizeFor(store, ctx); … summary: t("key", { … })`.
+ * Pass the tool-handler `ctx` so an auth user id resolves the same record the
+ * save path writes. Locale resolution + the fail-soft rules (no store, no key,
+ * store OUTAGE → English) come from the shared `createLocalizeFor`.
+ */
+export const localizeFor = createLocalizeFor(translator);
+/**
+ * {@link localizeFor} plus the view title, from ONE profile read — the kit's
+ * one title rule for every module's show tools: a view is titled only in a
+ * language the profile names; with "system" (the default), no caller or a
+ * store outage it carries no title, and the widget's own heading names it in
+ * the host's language (#322 U3). Summaries stay `t`:
+ * `const { t, title } = await localizeViewFor(store, ctx); … title: title("key")`.
+ */
+export const localizeViewFor = createLocalizeViewFor(translator);
+//# sourceMappingURL=server-locale.js.map

package/dist/server-locale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-locale.js","sourceRoot":"","sources":["../src/server-locale.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,oCAAoC,CAAA;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAiBhD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAA;AAEnD;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,iBAAiB,CAAA;AAK1D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAA;AAExD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAA"}

package/dist/settings-tools.d.ts

@@ -0,0 +1,23 @@
+import type { MCPServer } from "mcp-use";
+import { type ProfileSource } from "./server-locale.js";
+import { type AnalyticsSettings } from "./settings.js";
+import { type AnalyticsToolset } from "./toolsets.js";
+/**
+ * The analytics module's settings section — its own show/data/save tool triple
+ * (the three render paths), so the module plugs into the settings page without
+ * camunda7 owning any analytics vocabulary. The slice persists under
+ * `modules.analytics` in the shared profile record; the shared store merges
+ * per module key, so this never touches other modules' slices.
+ */
+/** What the settings widget renders: the effective slice + whether saving is wired. */
+export interface AnalyticsSettingsView {
+    settings: AnalyticsSettings;
+    /**
+     * False without a writable store, in the `read-only` toolset (also what a
+     * missing toolset resolves to), or when the request carries no caller
+     * identity (no OAuth — see `resolveProfileKey`) — the widget hides Save.
+     */
+    canSave: boolean;
+}
+export declare function registerSettingsTools(server: MCPServer, profileStore?: ProfileSource, toolset?: AnalyticsToolset): void;
+//# sourceMappingURL=settings-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings-tools.d.ts","sourceRoot":"","sources":["../src/settings-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAYxC,OAAO,EAKL,KAAK,aAAa,EAEnB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAuB,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAE1E;;;;;;GAMG;AAEH,uFAAuF;AACvF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,iBAAiB,CAAA;IAC3B;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,YAAY,CAAC,EAAE,aAAa,EAC5B,OAAO,CAAC,EAAE,gBAAgB,GACzB,IAAI,CAqHN"}

package/dist/settings-tools.js

@@ -0,0 +1,100 @@
+import { appOnly, buildDataFeedResult, buildSingleWidgetView, requireProfileKey, saveModuleSlice, showToolBinding, withToolErrors, strictToolInput, } from "@miragon/pulse-widget-shell/server";
+import { ANALYTICS_SAVE_SETTINGS, ANALYTICS_SETTINGS_DATA } from "./tool-names.js";
+import { localizeFor, localizeViewFor, resolveSettingsAuthUserId, resolveSettingsKey, } from "./server-locale.js";
+import { ANALYTICS_MODULE_KEY, analyticsSettingsSaveInput, parseAnalyticsSettings, settingsFor, } from "./settings.js";
+import { allowsDurableWrites } from "./toolsets.js";
+export function registerSettingsTools(server, profileStore, toolset) {
+    // The save tool is a durable write registered OUTSIDE the tool registrar, so
+    // it gates itself against the module's toolset (see `allowsDurableWrites`):
+    // only `standard` saves. A missing toolset resolves to the `read-only`
+    // floor, and an unknown name from an untyped caller warns and degrades to it.
+    const store = profileStore;
+    const save = allowsDurableWrites(toolset) ? store?.save?.bind(store) : undefined;
+    const loadView = async (ctx) => ({
+        settings: await settingsFor(store, ctx),
+        // Store/toolset gate AND per-request identity: without a profile key the
+        // save tool refuses, so the section must render read-only instead of a
+        // Save button whose click errors.
+        canSave: Boolean(save) && resolveSettingsKey(ctx) !== undefined,
+    });
+    const summarize = (t, view) => t("aSum.settings", {
+        period: view.settings.defaultPeriod,
+        minBucketSize: view.settings.minBucketSize,
+        changeHint: view.canSave ? t("aSum.settingsChangeHint") : "",
+    });
+    server.tool({
+        name: "analytics_show_settings",
+        title: "Analytics Settings",
+        description: "Open the analytics settings section: the default look-back period and the minimum comparison bucket size applied when analytics calls omit them.",
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+        inputSchema: strictToolInput({}),
+        ...showToolBinding("analytics_show_settings", "Analytics Settings"),
+    }, withToolErrors(async (_params, ctx) => {
+        const view = await loadView(ctx);
+        const { t, title } = await localizeViewFor(store, ctx);
+        return buildSingleWidgetView({
+            widget: "analytics:settings",
+            app: "analytics",
+            dataType: "analytics:settings",
+            data: { ...view },
+            // The view title in the language the profile names (the section
+            // heading's own key); none with "system", where the heading names it.
+            title: title("aSettings.heading"),
+            summary: summarize(t, view),
+        });
+    }));
+    server.tool({
+        name: ANALYTICS_SETTINGS_DATA,
+        title: "Analytics settings data (internal)",
+        description: "Internal JSON feed (no UI) for the analytics settings section's self-fetch. Prefer analytics_show_settings.",
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+        inputSchema: strictToolInput({}),
+        ...appOnly,
+    }, withToolErrors(async (_params, ctx) => buildDataFeedResult({ ...(await loadView(ctx)) })));
+    // Without a writable store (or on the `read-only` floor) there is nothing to
+    // save into — the section stays read-only (canSave: false) and the tool
+    // surface honestly reflects that.
+    if (!save || !store)
+        return;
+    server.tool({
+        name: ANALYTICS_SAVE_SETTINGS,
+        title: "Save analytics settings",
+        description: "Update the caller's analytics defaults. Only the provided fields change; omitted fields keep their value. The saved defaults apply whenever an analytics call omits `period` or `minBucketSize`.",
+        // The module's only non-read-only tool, and explicitly NOT destructive
+        // (MCP presumes a write destructive unless told otherwise): it merges
+        // the caller's own slice, nothing is deleted or overwritten wholesale.
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        inputSchema: strictToolInput(analyticsSettingsSaveInput.shape),
+        // No view binding / app visibility: a normal model-visible tool; the
+        // settings widget also calls it and reads the saved slice back from
+        // structuredContent.
+    }, withToolErrors(async (params, ctx) => {
+        // Keyless refusal + a patch-only slice save are the shared slice-write
+        // contract (`@miragon/pulse-widget-shell/server`) — every module's save
+        // tool uses the same pair. The store merges the patch under its per-key
+        // lock, so a concurrent save of the other field is never reverted.
+        const key = requireProfileKey(ctx);
+        // The OAuth caller is stamped as the record's owner.
+        const savedSlice = await saveModuleSlice({ get: (k) => store.get(k), save }, key, ANALYTICS_MODULE_KEY, params, { userId: resolveSettingsAuthUserId(ctx) });
+        const effective = parseAnalyticsSettings({ [ANALYTICS_MODULE_KEY]: savedSlice });
+        const t = await localizeFor(store, ctx);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: t("aSum.settingsSaved", {
+                        period: effective.defaultPeriod,
+                        minBucketSize: effective.minBucketSize,
+                    }),
+                },
+            ],
+            structuredContent: effective,
+        };
+    }));
+}
+//# sourceMappingURL=settings-tools.js.map

package/dist/settings-tools.js.map

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