@miragon/pulse-widget-shell 0.24.2 → 0.25.0

package/dist/server.js

@@ -1,34 +1,30 @@
-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";
+/**
+ * The `/server` import path: the module port, tool authoring and the boot. The boot's own parts
+ * (edge guard, body limit, metrics, health, request context) stay inside `createComposedServer`,
+ * so no root can wire a second boot that skips one of them.
+ */
+export { createToolsetVocabulary } from "./toolsets.js";
+// Tool authoring: the registrar, the view and feed bindings and results, the server i18n, the
+// BPMN-name readers and the per-caller request info.
+export { withToolErrors } from "./tool-errors.js";
+export { createToolRegistrar } from "./tool-registrar.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";
+export { buildDataFeedResult, buildViewResult } from "./view-results.js";
+// The two protocol helpers both halves use are also on `/widgets`, with their types: server
+// summaries and widget strings call createTranslator at runtime, and the server's tool tests
+// decode results the way the view runtime does. Both come from src/protocol/, the one tree the
+// server half and the view half (src/ui) share; neither half imports the other
+// (.dependency-cruiser.cjs: widget-shell-server-headless, widget-shell-views-browser-only).
+export { decodeToolResult } from "./protocol/tool-result.js";
+export { createTranslator, } from "./protocol/translator.js";
+export { bpmnProcessNameOf, parseBpmnNames, readBpmnNames, } from "./protocol/bpmn-names.js";
+export { callerCacheKey, getMcpRequestInfo, runWithMcpRequestInfo, } from "./request-context.js";
+// The boot: one composed server, the variables it reads, the view resources it primes and the
+// view bundle's dedupe list.
+export { composedEnvVars, createComposedServer, retiredEnvVars, } from "./composed-server.js";
+export { VIEW_RESOURCE_URI_PREFIX, viewResourceUri } from "./widget-tool-bindings.js";
+export { viewPrelude } from "./protocol/view-name.js";
+export { VIEW_BUNDLE_DEDUPE } from "./view-bundle.js";
+export { fontAssetsCsp, installFontAssets, } from "./font-assets.js";
+export { SERVED_FONT_FILES, SERVED_FONT_PATH, servedFontBaseUrl } from "./protocol/served-fonts.js";
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,uBAAuB,EAA0B,MAAM,eAAe,CAAA;AAE/E,8FAA8F;AAC9F,qDAAqD;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,mBAAmB,EAAuC,MAAM,qBAAqB,CAAA;AAC9F,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AACrF,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAmB,MAAM,mBAAmB,CAAA;AACzF,4FAA4F;AAC5F,6FAA6F;AAC7F,+FAA+F;AAC/F,+EAA+E;AAC/E,4FAA4F;AAC5F,OAAO,EAAE,gBAAgB,EAAmB,MAAM,2BAA2B,CAAA;AAC7E,OAAO,EACL,gBAAgB,GAKjB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,aAAa,GAGd,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,qBAAqB,GAEtB,MAAM,sBAAsB,CAAA;AAE7B,8FAA8F;AAC9F,6BAA6B;AAC7B,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,cAAc,GAMf,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AACrF,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAIrD,OAAO,EACL,aAAa,EACb,iBAAiB,GAGlB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA"}

package/dist/testing/glossary.d.ts

@@ -1,23 +1,7 @@
-import type { CatalogLanguage } from "./catalog-text.js";
-/**
- * The glossary gate: one word per thing, in every view of every module
- * (brand-tone "Ein Begriff pro Sache"). A rule names the synonym a catalog
- * must not use, the glossary term to write instead, and a probe it must catch
- * (a broken pattern then fails instead of passing everything). A rule may
- * spare named keys, each with its reason.
- *
- * {@link PRODUCT_GLOSSARY} holds the terms the modules' views show side by
- * side: camunda7's cross-engine cockpit embeds analytics' landscape, so one
- * quantity must read the same in both. Each module runs it over its own
- * catalogs next to its local rules (`messages/glossary.test.ts`) and lists
- * the terms in its `messages/GLOSSARY.md`:
- *
- *   expect(glossaryFindings(catalog, PRODUCT_GLOSSARY.de)).toEqual([])
- */
+import type { CatalogLanguage } from "@miragon/pulse-ui/testing";
+/** The glossary gate: one word per thing. Each rule carries a probe so a broken pattern fails instead of passing everything; PRODUCT_GLOSSARY holds the terms modules show side by side (the engine module's cockpit embeds analytics' landscape). */
 export interface GlossaryRule {
-    /** The forbidden synonym. */
     pattern: RegExp;
-    /** The glossary term that replaces it. */
     use: string;
     /** A text with the synonym: the rule is blind if it does not match. */
     probe: string;
@@ -30,23 +14,11 @@ export interface GlossaryFinding {
     /** The glossary term to write instead. */
     use: string;
 }
-/**
- * The product-wide terms, per catalog language (the modules' GLOSSARY.md
- * tables name each `use`).
- */
 export declare const PRODUCT_GLOSSARY: Readonly<Record<CatalogLanguage, readonly GlossaryRule[]>>;
-/**
- * Every entry that uses a synonym one of `rules` rules out (a key a rule
- * spares aside), once per entry and rule, plus every exception that no
- * longer spares a real use (shrink-only: a fixed entry drops off its rule).
- */
+/** Also reports exceptions that no longer spare a real use (shrink-only). */
 export declare function glossaryFindings(catalog: object, rules: readonly GlossaryRule[]): GlossaryFinding[];
 /** The probes `rules` do not catch: a rule whose pattern misses its own probe guards nothing. */
 export declare function blindGlossaryRules(rules: readonly GlossaryRule[]): string[];
-/**
- * The glossary words of `rules` (each `use`, split at ", ") that a glossary
- * document does not name, so the document people read and the gate cannot
- * drift apart.
- */
+/** Glossary words a glossary document does not name, so the document and the gate cannot drift apart. */
 export declare function unnamedGlossaryTerms(doc: string, rules: readonly GlossaryRule[]): string[];
 //# sourceMappingURL=glossary.d.ts.map

package/dist/testing/glossary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"glossary.d.ts","sourceRoot":"","sources":["../../src/testing/glossary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAA;IACX,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAA;IACb,kDAAkD;IAClD,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAC1C;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAA;CACZ;AAKD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,SAAS,YAAY,EAAE,CAAC,CA0CvF,CAAA;AAmDD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,YAAY,EAAE,GAC7B,eAAe,EAAE,CAgBnB;AAED,iGAAiG;AACjG,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,EAAE,CAE3E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,EAAE,CAG1F"}
+{"version":3,"file":"glossary.d.ts","sourceRoot":"","sources":["../../src/testing/glossary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAEhE,sPAAsP;AACtP,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAA;IACb,kDAAkD;IAClD,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAC1C;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAA;CACZ;AAKD,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,SAAS,YAAY,EAAE,CAAC,CAwCvF,CAAA;AAyCD,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,YAAY,EAAE,GAC7B,eAAe,EAAE,CAgBnB;AAED,iGAAiG;AACjG,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,EAAE,CAE3E;AAED,yGAAyG;AACzG,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,EAAE,CAG1F"}

package/dist/testing/glossary.js

@@ -1,17 +1,11 @@
 /** The verb only: "Deployment" stays the engine's noun. */
 const DEPLOY_VERB_DE = /(?<![\p{L}])(ge)?deploy(e|en|st|t|te|ten)?(?![\p{L}])/iu;
-/**
- * The product-wide terms, per catalog language (the modules' GLOSSARY.md
- * tables name each `use`).
- */
 export const PRODUCT_GLOSSARY = {
     de: [
         { pattern: /Vorf[aä]ll/i, use: "Incident", probe: "Offene Vorfälle" },
         { pattern: /(?<![\p{L}])störung/iu, use: "Incident", probe: "Störungen je Prozess" },
         {
-            // The jobs whose retries ran out (`failedJobs` of the engine's
-            // statistics, the metric `camunda_jobs_failed`). A single job that
-            // failed ("dieser Job ist fehlgeschlagen") stays free.
+            // The jobs whose retries ran out; a single failed job ("dieser Job ist fehlgeschlagen") stays free.
             pattern: /(?<![\p{L}])fehlgeschlagene(n|r|\(r\))?\s+Job(s(?![\p{L}])|\(s\))/iu,
             use: "Jobs ohne Versuche",
             probe: "Häufungen fehlgeschlagener Jobs",
@@ -47,10 +41,7 @@ export const PRODUCT_GLOSSARY = {
         { pattern: /\bfleet\b/i, use: "all engines, cross-engine", probe: "Fleet analysis" },
     ],
 };
-/**
- * A stand-in argument: every property, and its own primitive value, is `n`
- * (counted entries render as text, a positional string parameter too).
- */
+/** A stand-in argument: every property, and its own primitive value, is `n`. */
 function sampleParams(n) {
     return new Proxy(Object.create(null), {
         get: (_target, prop) => {
@@ -62,10 +53,7 @@ function sampleParams(n) {
         },
     });
 }
-/**
- * A function entry rendered with `n`; undefined when it needs a real shape
- * (the catalog text test reports that as its render-error).
- */
+/** Undefined when the entry needs a real shape (the catalog text test reports that). */
 function renderWith(value, n) {
     try {
         const text = value(sampleParams(n));
@@ -75,11 +63,7 @@ function renderWith(value, n) {
         return undefined;
     }
 }
-/**
- * Every entry of a (nested) catalog as text: strings as written, functions
- * rendered with every parameter 1 and 2 (both forms of a counted entry);
- * `{placeholder}` names are code, not copy, and drop out.
- */
+/** Functions render with 1 and 2 (both forms of a counted entry); `{placeholder}` names are code and drop out. */
 function rendered(catalog, prefix = "") {
     return Object.entries(catalog).flatMap(([name, value]) => {
         const key = prefix + name;
@@ -96,11 +80,7 @@ function rendered(catalog, prefix = "") {
         return [];
     });
 }
-/**
- * Every entry that uses a synonym one of `rules` rules out (a key a rule
- * spares aside), once per entry and rule, plus every exception that no
- * longer spares a real use (shrink-only: a fixed entry drops off its rule).
- */
+/** Also reports exceptions that no longer spare a real use (shrink-only). */
 export function glossaryFindings(catalog, rules) {
     const texts = rendered(catalog);
     const findings = new Map();
@@ -123,11 +103,7 @@ export function glossaryFindings(catalog, rules) {
 export function blindGlossaryRules(rules) {
     return rules.filter((rule) => !rule.pattern.test(rule.probe)).map((rule) => rule.probe);
 }
-/**
- * The glossary words of `rules` (each `use`, split at ", ") that a glossary
- * document does not name, so the document people read and the gate cannot
- * drift apart.
- */
+/** Glossary words a glossary document does not name, so the document and the gate cannot drift apart. */
 export function unnamedGlossaryTerms(doc, rules) {
     const terms = new Set(rules.flatMap((rule) => rule.use.split(", ")));
     return [...terms].filter((term) => !doc.includes(term));

package/dist/testing/glossary.js.map

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

package/dist/testing/index.d.ts

@@ -1,40 +1,3 @@
-/**
- * `@miragon/pulse-widget-shell/testing` — the brand gates every widget package
- * runs in its own test suite (Node, never bundled into a view):
- *  - `catalogTextFindings` — the voice rules over a message catalog;
- *  - `glossaryFindings` with `PRODUCT_GLOSSARY` — one word per thing across
- *    every module's catalogs (plus a module's own rules);
- *  - `scanGlyphs` — no Unicode glyphs, emoji or sparkle icons in widget code;
- *  - `scanIconSizes` — icons at the CI sizes only (16 px chrome, 24 px previews);
- *  - `scanTypeScale` — text on the type scale's five steps, nothing below 13 px;
- *  - `scanColors` — role names only, no palette classes, retired accents or
- *    raw colours; `stylesheetColorFindings` — no raw colour in a stylesheet's
- *    rules;
- *  - `parseThemeVariables` + `contrastFindings` with `toneContrastPairs()` /
- *    `ROLE_CONTRAST_PAIRS` — WCAG contrast of the theme, light and dark,
- *    over the toolkit's Miragon theme (`toolkitThemeStylesheets()`) plus a
- *    consumer's role overrides;
- *  - `missingDisplayTexts` + `displayTextCatalog` — the view builder names
- *    every widget, step and top-level props field in en and de, in the brand
- *    voice; `displayTextsSentToModel` — and none of those texts reaches the
- *    model through `get-framework-manifest`;
- *  - `setFormatLocale` — render numbers and dates in a language in a test.
- * `scanGlyphs`, `scanIconSizes` and `scanColors` parse sources with
- * `typescript` (an optional peer).
- */
-export { catalogTextFindings, type CatalogAllowance, type CatalogLanguage, type CatalogRule, type CatalogTextFinding, type CatalogTextOptions, } from "./catalog-text.js";
+/** The product glossary every widget package checks its catalogs against (Node, never bundled); the generic brand gates are `@miragon/pulse-ui/testing`. */
 export { blindGlossaryRules, glossaryFindings, PRODUCT_GLOSSARY, unnamedGlossaryTerms, type GlossaryFinding, type GlossaryRule, } from "./glossary.js";
-export { FORBIDDEN_GLYPHS, glyphFindings, scanGlyphs, type GlyphFinding } from "./glyphs.js";
-export { CI_ICON_SIZES, iconSizeFindings, scanIconSizes, type IconSizeFinding, } from "./icon-sizes.js";
-export { scanTypeScale, typeScaleFindings, type ScanTypeScaleOptions, type TypeScaleFinding, type TypeScaleRule, } from "./type-scale.js";
-export { colorFindings, scanColors, stylesheetColorFindings, type ColorFinding, type ScanColorsOptions, } from "./colors.js";
-export { composite, contrastFindings, contrastRatio, measureContrast, parseThemeVariables, resolveColor, toolkitThemeStylesheets, type ContrastPair, type ContrastResult, type Rgba, type ThemeMode, type ThemeVariables, } from "./contrast.js";
-export { ROLE_CONTRAST_PAIRS, toneContrastPairs } from "./tone-pairs.js";
-export { displayTextCatalog, displayTextsSentToModel, missingDisplayTexts, } from "./display-texts.js";
-/**
- * The format locale the shell's ProfileGate publishes, for tests that render
- * a widget's numbers and dates in a given language without booting the gate
- * (`afterEach(() => setFormatLocale(undefined))` restores the defaults).
- */
-export { setFormatLocale, type FormatLocale } from "../ui/format.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EACL,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AAC5F,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,aAAa,GACnB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,aAAa,EACb,UAAU,EACV,uBAAuB,EACvB,KAAK,YAAY,EACjB,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,uBAAuB,EACvB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,IAAI,EACT,KAAK,SAAS,EACd,KAAK,cAAc,GACpB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACxE,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,oBAAoB,CAAA;AAC3B;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,4JAA4J;AAC5J,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,eAAe,CAAA"}

package/dist/testing/index.js

@@ -1,40 +1,3 @@
-/**
- * `@miragon/pulse-widget-shell/testing` — the brand gates every widget package
- * runs in its own test suite (Node, never bundled into a view):
- *  - `catalogTextFindings` — the voice rules over a message catalog;
- *  - `glossaryFindings` with `PRODUCT_GLOSSARY` — one word per thing across
- *    every module's catalogs (plus a module's own rules);
- *  - `scanGlyphs` — no Unicode glyphs, emoji or sparkle icons in widget code;
- *  - `scanIconSizes` — icons at the CI sizes only (16 px chrome, 24 px previews);
- *  - `scanTypeScale` — text on the type scale's five steps, nothing below 13 px;
- *  - `scanColors` — role names only, no palette classes, retired accents or
- *    raw colours; `stylesheetColorFindings` — no raw colour in a stylesheet's
- *    rules;
- *  - `parseThemeVariables` + `contrastFindings` with `toneContrastPairs()` /
- *    `ROLE_CONTRAST_PAIRS` — WCAG contrast of the theme, light and dark,
- *    over the toolkit's Miragon theme (`toolkitThemeStylesheets()`) plus a
- *    consumer's role overrides;
- *  - `missingDisplayTexts` + `displayTextCatalog` — the view builder names
- *    every widget, step and top-level props field in en and de, in the brand
- *    voice; `displayTextsSentToModel` — and none of those texts reaches the
- *    model through `get-framework-manifest`;
- *  - `setFormatLocale` — render numbers and dates in a language in a test.
- * `scanGlyphs`, `scanIconSizes` and `scanColors` parse sources with
- * `typescript` (an optional peer).
- */
-export { catalogTextFindings, } from "./catalog-text.js";
+/** The product glossary every widget package checks its catalogs against (Node, never bundled); the generic brand gates are `@miragon/pulse-ui/testing`. */
 export { blindGlossaryRules, glossaryFindings, PRODUCT_GLOSSARY, unnamedGlossaryTerms, } from "./glossary.js";
-export { FORBIDDEN_GLYPHS, glyphFindings, scanGlyphs } from "./glyphs.js";
-export { CI_ICON_SIZES, iconSizeFindings, scanIconSizes, } from "./icon-sizes.js";
-export { scanTypeScale, typeScaleFindings, } from "./type-scale.js";
-export { colorFindings, scanColors, stylesheetColorFindings, } from "./colors.js";
-export { composite, contrastFindings, contrastRatio, measureContrast, parseThemeVariables, resolveColor, toolkitThemeStylesheets, } from "./contrast.js";
-export { ROLE_CONTRAST_PAIRS, toneContrastPairs } from "./tone-pairs.js";
-export { displayTextCatalog, displayTextsSentToModel, missingDisplayTexts, } from "./display-texts.js";
-/**
- * The format locale the shell's ProfileGate publishes, for tests that render
- * a widget's numbers and dates in a given language without booting the gate
- * (`afterEach(() => setFormatLocale(undefined))` restores the defaults).
- */
-export { setFormatLocale } from "../ui/format.js";
 //# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EACL,mBAAmB,GAMpB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,GAGrB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,UAAU,EAAqB,MAAM,aAAa,CAAA;AAC5F,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,aAAa,GAEd,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,aAAa,EACb,iBAAiB,GAIlB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,aAAa,EACb,UAAU,EACV,uBAAuB,GAGxB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,uBAAuB,GAMxB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACxE,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,oBAAoB,CAAA;AAC3B;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAqB,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,4JAA4J;AAC5J,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,GAGrB,MAAM,eAAe,CAAA"}

package/dist/tool-errors.d.ts

@@ -0,0 +1,16 @@
+/** An `isError` tool result; the literal `true` lets a handler with an outputSchema return it. */
+declare function errorResult(message: string): {
+    isError: true;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+/**
+ * A throw reaches the model as `[<status or code>] <message>`: mcp-use passes the bare message,
+ * and the code (`ENGINE_NOT_SELECTED`, `UNKNOWN_ENGINE`) is what tells the model the next step.
+ * An HTTP-ish `status` wins over a domain `code`; without either the message stays as it is.
+ */
+export declare function withToolErrors<TArgs extends unknown[], TResult>(handler: (...args: TArgs) => Promise<TResult>): (...args: TArgs) => Promise<TResult | ReturnType<typeof errorResult>>;
+export {};
+//# sourceMappingURL=tool-errors.d.ts.map

package/dist/tool-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-errors.d.ts","sourceRoot":"","sources":["../src/tool-errors.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,iBAAS,WAAW,CAAC,OAAO,EAAE,MAAM;;;;;;EAEnC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,SAAS,OAAO,EAAE,EAAE,OAAO,EAC7D,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,GAC5C,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAWvE"}

package/dist/tool-errors.js

@@ -0,0 +1,23 @@
+/** An `isError` tool result; the literal `true` lets a handler with an outputSchema return it. */
+function errorResult(message) {
+    return { isError: true, content: [{ type: "text", text: message }] };
+}
+/**
+ * A throw reaches the model as `[<status or code>] <message>`: mcp-use passes the bare message,
+ * and the code (`ENGINE_NOT_SELECTED`, `UNKNOWN_ENGINE`) is what tells the model the next step.
+ * An HTTP-ish `status` wins over a domain `code`; without either the message stays as it is.
+ */
+export function withToolErrors(handler) {
+    return async (...args) => {
+        try {
+            return await handler(...args);
+        }
+        catch (e) {
+            const message = e instanceof Error ? e.message : String(e);
+            const { status, code } = (e ?? {});
+            const errorCode = status ?? code;
+            return errorResult(errorCode ? `[${errorCode}] ${message}` : message);
+        }
+    };
+}
+//# sourceMappingURL=tool-errors.js.map

package/dist/tool-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-errors.js","sourceRoot":"","sources":["../src/tool-errors.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,SAAS,WAAW,CAAC,OAAe;IAClC,OAAO,EAAE,OAAO,EAAE,IAAa,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAA;AACxF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,OAA6C;IAE7C,OAAO,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE;QACvB,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;QAC/B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,OAAO,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;YAC1D,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAyD,CAAA;YAC1F,MAAM,SAAS,GAAG,MAAM,IAAI,IAAI,CAAA;YAChC,OAAO,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QACvE,CAAC;IACH,CAAC,CAAA;AACH,CAAC"}

package/dist/tool-registrar.d.ts

@@ -0,0 +1,29 @@
+import type { MCPServer, RequestContext, ToolAnnotations } from "mcp-use";
+import type { z } from "zod";
+type ZodRawShape = Record<string, z.ZodType>;
+/** The validated args a handler receives, inferred from its input shape. */
+type ToolArgs<TShape extends ZodRawShape = ZodRawShape> = z.infer<z.ZodObject<TShape>>;
+/** mcp-use's per-call context; `auth` is optional: a boot without OAuth has none. */
+type ToolHandlerContext = RequestContext<unknown, "optional">;
+export interface ToolConfig<TClient, TShape extends ZodRawShape = ZodRawShape> {
+    name: string;
+    description: string;
+    /** The domain file the tool lives in (CLAUDE.md invariant 1). */
+    category?: string;
+    inputSchema?: TShape;
+    /** An object schema: MCP's `structuredContent` is an object. */
+    outputSchema?: z.ZodObject;
+    annotations?: ToolAnnotations;
+    /** `ctx` is optional so a test calls the handler as `(client, args)`. */
+    handler: (client: TClient, args: ToolArgs<TShape>, ctx?: ToolHandlerContext) => Promise<unknown>;
+}
+/** What `createToolRegistrar` returns: a module's tool files take it as `register`. */
+export type ToolRegistrar<TClient> = <TShape extends ZodRawShape = ZodRawShape>(config: ToolConfig<TClient, TShape>) => void;
+/**
+ * Every operations tool registers here (CLAUDE.md invariant 1): strict input (an unknown key is a
+ * tool error naming the valid keys), a throw as `[code] message`, the result mirrored into
+ * `structuredContent`. The handler gets `(client, args, ctx)`.
+ */
+export declare function createToolRegistrar<TClient>(server: MCPServer, client: TClient): ToolRegistrar<TClient>;
+export {};
+//# sourceMappingURL=tool-registrar.d.ts.map

package/dist/tool-registrar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registrar.d.ts","sourceRoot":"","sources":["../src/tool-registrar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AACzE,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAI5B,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAA;AAE5C,4EAA4E;AAC5E,KAAK,QAAQ,CAAC,MAAM,SAAS,WAAW,GAAG,WAAW,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAA;AAEtF,qFAAqF;AACrF,KAAK,kBAAkB,GAAG,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;AAE7D,MAAM,WAAW,UAAU,CAAC,OAAO,EAAE,MAAM,SAAS,WAAW,GAAG,WAAW;IAC3E,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gEAAgE;IAChE,YAAY,CAAC,EAAE,CAAC,CAAC,SAAS,CAAA;IAC1B,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B,yEAAyE;IACzE,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CACjG;AAED,uFAAuF;AACvF,MAAM,MAAM,aAAa,CAAC,OAAO,IAAI,CAAC,MAAM,SAAS,WAAW,GAAG,WAAW,EAC5E,MAAM,EAAE,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,KAChC,IAAI,CAAA;AA8BT;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EACzC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,OAAO,GACd,aAAa,CAAC,OAAO,CAAC,CAwBxB"}

package/dist/tool-registrar.js

@@ -0,0 +1,47 @@
+import { withToolErrors } from "./tool-errors.js";
+import { strictToolInput } from "./widget-tool-bindings.js";
+const textResult = (text) => ({
+    content: [{ type: "text", text }],
+    _meta: { mimeType: "text/plain" },
+});
+const objectResult = (data) => ({
+    content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    structuredContent: data,
+    _meta: { mimeType: "application/json" },
+});
+/** A scalar under a declared outputSchema would be an opaque protocol error: name it instead. */
+function toResult(result, config) {
+    if (Array.isArray(result))
+        return objectResult({ data: result });
+    if (result !== null && typeof result === "object") {
+        return objectResult(result);
+    }
+    if (config.outputSchema) {
+        const kind = result === null ? "null" : typeof result;
+        throw new Error(`Tool "${config.name}" declares an outputSchema but its handler returned a ${kind} value; ` +
+            `structured output must be an object or array.`);
+    }
+    if (result !== undefined && result !== null)
+        return textResult(JSON.stringify(result, null, 2));
+    return textResult("Success (no content returned)");
+}
+/**
+ * Every operations tool registers here (CLAUDE.md invariant 1): strict input (an unknown key is a
+ * tool error naming the valid keys), a throw as `[code] message`, the result mirrored into
+ * `structuredContent`. The handler gets `(client, args, ctx)`.
+ */
+export function createToolRegistrar(server, client) {
+    return (config) => {
+        server.tool({
+            name: config.name,
+            description: config.description,
+            inputSchema: strictToolInput(config.inputSchema ?? {}),
+            outputSchema: config.outputSchema,
+            annotations: config.annotations,
+        }, 
+        // mcp-use validates the args against the schema above before the callback runs; the
+        // callback sees the erased `ToolArgs`, the handler its own shape.
+        withToolErrors(async (args, ctx) => toResult(await config.handler(client, args, ctx), config)));
+    };
+}
+//# sourceMappingURL=tool-registrar.js.map

package/dist/tool-registrar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registrar.js","sourceRoot":"","sources":["../src/tool-registrar.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AA4B3D,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC;IACpC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;IAC1C,KAAK,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE;CAClC,CAAC,CAAA;AAEF,MAAM,YAAY,GAAG,CAAC,IAA6B,EAAE,EAAE,CAAC,CAAC;IACvD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;IACzE,iBAAiB,EAAE,IAAI;IACvB,KAAK,EAAE,EAAE,QAAQ,EAAE,kBAAkB,EAAE;CACxC,CAAC,CAAA;AAEF,iGAAiG;AACjG,SAAS,QAAQ,CAAC,MAAe,EAAE,MAAgD;IACjF,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;IAChE,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAClD,OAAO,YAAY,CAAC,MAAiC,CAAC,CAAA;IACxD,CAAC;IACD,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,MAAM,CAAA;QACrD,MAAM,IAAI,KAAK,CACb,SAAS,MAAM,CAAC,IAAI,yDAAyD,IAAI,UAAU;YACzF,+CAA+C,CAClD,CAAA;IACH,CAAC;IACD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;IAC/F,OAAO,UAAU,CAAC,+BAA+B,CAAC,CAAA;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAiB,EACjB,MAAe;IAEf,OAAO,CAA6B,MAAmC,EAAE,EAAE;QACzE,MAAM,CAAC,IAAI,CACT;YACE,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,WAAW,EAAE,eAAe,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;YACtD,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC;QACD,oFAAoF;QACpF,kEAAkE;QAClE,cAAc,CAAC,KAAK,EAAE,IAAc,EAAE,GAAa,EAAE,EAAE,CACrD,QAAQ,CACN,MAAM,MAAM,CAAC,OAAO,CAClB,MAAM,EACN,IAAwB,EACxB,GAAqC,CACtC,EACD,MAAM,CACP,CACF,CACF,CAAA;IACH,CAAC,CAAA;AACH,CAAC"}

package/dist/tool-registration.d.ts

@@ -0,0 +1,35 @@
+import type { MCPServer } from "mcp-use";
+import type { ModulePlugin } from "./composition.js";
+/** Owner of a tool registered outside a plugin's `register`. */
+export declare const SERVER_TOOL_OWNER = "server";
+/** A view's CSP in the SEP-1865 spelling mcp-use takes on `view.csp`: origins other than the server's own. */
+export interface AppResourceCsp {
+    connectDomains?: string[];
+    resourceDomains?: string[];
+    frameDomains?: string[];
+    baseUriDomains?: string[];
+}
+/** The Apps SDK spelling of {@link AppResourceCsp}. */
+export interface WidgetCspMeta {
+    connect_domains?: string[];
+    resource_domains?: string[];
+    frame_domains?: string[];
+    base_uri_domains?: string[];
+}
+export interface ToolRegistration {
+    /** Every `view.name` a registered tool binds; the boot primes them once, after every plugin. */
+    readonly viewNames: ReadonlySet<string>;
+    /** Runs `plugin.register` with the plugin's name as the owner of every tool it adds. */
+    register(plugin: ModulePlugin): void;
+}
+export declare function toWidgetCspMeta(csp: AppResourceCsp): WidgetCspMeta;
+/** The tool's own entries come first; each default origin is appended once. */
+export declare function mergeDomainLists<T extends object>(own: T | undefined, defaults: T): T;
+/**
+ * Wraps `server.tool` before any plugin registers. mcp-use keeps the last tool of a name, so a
+ * second module's tool would silently replace the first: the boot refuses it instead. Modules bind
+ * views through `showToolBinding`, which knows nothing about the deployment, so the server-wide view
+ * CSP (the served fonts' origin) is merged in here.
+ */
+export declare function installToolRegistration(server: MCPServer, csp: AppResourceCsp | undefined): ToolRegistration;
+//# sourceMappingURL=tool-registration.d.ts.map

package/dist/tool-registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registration.d.ts","sourceRoot":"","sources":["../src/tool-registration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,SAAS,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEpD,gEAAgE;AAChE,eAAO,MAAM,iBAAiB,WAAW,CAAA;AAEzC,8GAA8G;AAC9G,MAAM,WAAW,cAAc;IAC7B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAC1B;AAED,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC5B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,gGAAgG;IAChG,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACvC,wFAAwF;IACxF,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;CACrC;AASD,wBAAgB,eAAe,CAAC,GAAG,EAAE,cAAc,GAAG,aAAa,CAOlE;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAQrF;AAgBD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,cAAc,GAAG,SAAS,GAC9B,gBAAgB,CAkClB"}

package/dist/tool-registration.js

@@ -0,0 +1,80 @@
+/** Owner of a tool registered outside a plugin's `register`. */
+export const SERVER_TOOL_OWNER = "server";
+/** Feeds never carry it, so it marks the tools Apps SDK hosts render. */
+const OUTPUT_TEMPLATE = "openai/outputTemplate";
+const WIDGET_CSP = "openai/widgetCSP";
+export function toWidgetCspMeta(csp) {
+    const meta = {};
+    if (csp.connectDomains)
+        meta.connect_domains = csp.connectDomains;
+    if (csp.resourceDomains)
+        meta.resource_domains = csp.resourceDomains;
+    if (csp.frameDomains)
+        meta.frame_domains = csp.frameDomains;
+    if (csp.baseUriDomains)
+        meta.base_uri_domains = csp.baseUriDomains;
+    return meta;
+}
+/** The tool's own entries come first; each default origin is appended once. */
+export function mergeDomainLists(own, defaults) {
+    const mine = (own ?? {});
+    const merged = { ...mine };
+    for (const [key, domains] of Object.entries(defaults)) {
+        if (!domains?.length)
+            continue;
+        merged[key] = [...new Set([...(mine[key] ?? []), ...domains])];
+    }
+    return merged;
+}
+const hasDomains = (lists) => lists !== undefined && Object.values(lists).some((domains) => (domains?.length ?? 0) > 0);
+function withCspDefaults(definition, csp) {
+    const { view, _meta: meta } = definition;
+    const next = { ...definition };
+    if (view)
+        next.view = { ...view, csp: mergeDomainLists(view.csp, csp) };
+    if (meta?.[OUTPUT_TEMPLATE] !== undefined) {
+        const own = meta[WIDGET_CSP];
+        next._meta = { ...meta, [WIDGET_CSP]: mergeDomainLists(own, toWidgetCspMeta(csp)) };
+    }
+    return next;
+}
+/**
+ * Wraps `server.tool` before any plugin registers. mcp-use keeps the last tool of a name, so a
+ * second module's tool would silently replace the first: the boot refuses it instead. Modules bind
+ * views through `showToolBinding`, which knows nothing about the deployment, so the server-wide view
+ * CSP (the served fonts' origin) is merged in here.
+ */
+export function installToolRegistration(server, csp) {
+    const owners = new Map();
+    const viewNames = new Set();
+    const defaults = hasDomains(csp) ? csp : undefined;
+    let owner = SERVER_TOOL_OWNER;
+    // `never` keeps the assignment sound under parameter contravariance: the wrapper only forwards it.
+    const original = server.tool.bind(server);
+    const guarded = (definition, callback) => {
+        const previous = owners.get(definition.name);
+        if (previous !== undefined) {
+            throw new Error(`Tool "${definition.name}" is registered twice: by "${previous}" and again by "${owner}". ` +
+                "mcp-use keeps one tool per name, so rename one of them.");
+        }
+        const ref = original(defaults ? withCspDefaults(definition, defaults) : definition, callback);
+        owners.set(definition.name, owner);
+        if (definition.view?.name)
+            viewNames.add(definition.view.name);
+        return ref;
+    };
+    server.tool = guarded;
+    return {
+        viewNames,
+        register(plugin) {
+            owner = plugin.name;
+            try {
+                plugin.register(server);
+            }
+            finally {
+                owner = SERVER_TOOL_OWNER;
+            }
+        },
+    };
+}
+//# sourceMappingURL=tool-registration.js.map

package/dist/tool-registration.js.map

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