@bestagentkits/render 0.1.1-next.1 → 0.3.0

package/dist/diagram/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/diagram/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,QAAQ,CAAC,eAAe,EAAE,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,GAAG,SAAS,CAAC;CAC3D;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,gCAAgC,EAAG,CAAU,CAAC;AAE3D,iFAAiF;AACjF,eAAO,MAAM,wBAAwB,QAAa,CAAC;AAuBnD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAWrE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,GAAG,SAAS,EACnC,OAAO,EAAE,IAAI,CAAC,oBAAoB,EAAE,iBAAiB,CAAC,GACrD,oBAAoB,GAAG,SAAS,CAclC"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/diagram/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5C,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,QAAQ,CAAC,eAAe,EAAE,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,GAAG,SAAS,CAAC;CAC3D;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,gCAAgC,EAAG,CAAU,CAAC;AAE3D,iFAAiF;AACjF,eAAO,MAAM,wBAAwB,QAAa,CAAC;AAEnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAgC/D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAYrE;AAeD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,GAAG,SAAS,EACnC,OAAO,EAAE,IAAI,CAAC,oBAAoB,EAAE,iBAAiB,CAAC,GACrD,oBAAoB,GAAG,SAAS,CAwBlC"}

package/dist/diagram/adapter.js

@@ -17,10 +17,19 @@
  *   "verified before it reaches the artifact".
  * - The fallback text is always emitted, so the diagram's content is available
  *   to assistive technology and to a reader whose adapter is not installed.
+ * - Accepted markup is fitted to the page's Content Security Policy: its
+ *   `<style>` elements are marked to receive the page style nonce, and inline
+ *   `style` attributes, which that policy refuses, are removed and reported.
+ * - Adapter stylesheets are filtered so they cannot load anything, and scoped
+ *   to the diagram's own canvas so they cannot restyle the page.
  */
+import { stableHash } from '../hash.js';
+import { ADAPTER_STYLE_MARKER, fitAdapterMarkup } from './adapter-markup-fit.js';
+import { ADAPTER_SCOPE_ATTRIBUTE } from './adapter-stylesheet-filter.js';
 export const DIAGRAM_ADAPTER_CONTRACT_VERSION = 1;
 /** Bound on adapter output, so a runaway adapter cannot inflate the artifact. */
 export const MAX_DIAGRAM_MARKUP_BYTES = 256 * 1024;
+export { ADAPTER_STYLE_MARKER } from './adapter-markup-fit.js';
 /**
  * Vectors that must never appear in adapter output.
  *
@@ -40,6 +49,15 @@ const FORBIDDEN_ADAPTER_PATTERNS = [
     { pattern: /\son[a-z]+\s*=/iu, reason: 'inline event handler' },
     { pattern: /javascript\s*:/iu, reason: 'javascript: URL' },
     { pattern: /\bdata\s*:\s*text\/html/iu, reason: 'data: text/html URL' },
+    // Adapter `<style>` elements are live on the page, so they must not pull in
+    // another stylesheet or reach the network from CSS.
+    { pattern: /@import/iu, reason: 'CSS @import' },
+    { pattern: /url\(\s*['"]?\s*(?:[a-z][a-z0-9+.-]*:)?\/\//iu, reason: 'remote CSS url()' },
+    // The page owns its style nonce and the attributes it uses to place and scope
+    // adapter styles. Markup that writes any of them could forge or misplace one.
+    { pattern: /nonce[\t\n\f\r ]*=/iu, reason: 'nonce attribute' },
+    { pattern: new RegExp(ADAPTER_STYLE_MARKER, 'iu'), reason: 'reserved page attribute' },
+    { pattern: new RegExp(ADAPTER_SCOPE_ATTRIBUTE, 'iu'), reason: 'reserved page attribute' },
 ];
 /**
  * Verify adapter output before it is embedded.
@@ -58,8 +76,20 @@ export function checkAdapterMarkup(markup) {
         if (pattern.test(markup))
             return { ok: false, reason };
     }
-    return { ok: true };
+    const fitted = fitAdapterMarkup(markup, CHECK_SCOPE);
+    return fitted.ok ? { ok: true } : { ok: false, reason: fitted.reason };
 }
+/**
+ * Token naming the canvas an adapter's styles are scoped to.
+ *
+ * Node ids are already a safe token; anything else (a host calling
+ * `runDiagramAdapter` directly) is hashed into one, so it never needs escaping.
+ */
+function adapterScope(nodeId) {
+    return /^[A-Za-z0-9_-]{1,64}$/u.test(nodeId) ? nodeId : `s${stableHash(nodeId)}`;
+}
+/** Placeholder scope used when markup is only being checked. */
+const CHECK_SCOPE = 'check';
 /**
  * Run an adapter and return markup that has passed the trust boundary.
  *
@@ -82,6 +112,17 @@ export function runDiagramAdapter(adapter, request) {
     if (!check.ok) {
         return { markup: '', adapter: adapter.name, rejected: check.reason ?? 'rejected' };
     }
-    return { markup, adapter: adapter.name };
+    const scope = adapterScope(request.nodeId);
+    const fitted = fitAdapterMarkup(markup, scope);
+    if (!fitted.ok)
+        return { markup: '', adapter: adapter.name, rejected: fitted.reason };
+    return {
+        markup: fitted.markup,
+        adapter: adapter.name,
+        scope,
+        ...(fitted.removedInlineStyles === 0
+            ? {}
+            : { removedInlineStyles: fitted.removedInlineStyles }),
+    };
 }
 //# sourceMappingURL=adapter.js.map

package/dist/diagram/adapter.js.map

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

package/dist/index.d.ts

@@ -5,6 +5,9 @@
  * what a minor and a major release promise. Functions that are not implemented
  * yet are not exported — the package never advertises a scaffold.
  */
+export type { DataRow, DataScalar, MaterializedData } from './data/dataset-types.js';
+export type { ValueFormat } from './data/format-value.js';
+export { VALUE_FORMATS } from './data/format-value.js';
 export type { Diagnostic, DiagnosticSeverity } from './diagnostics.js';
 export type { AdapterMarkupCheck, DiagramAdapter, DiagramAdapterResult, DiagramRenderRequest, } from './diagram/adapter.js';
 export { checkAdapterMarkup, DIAGRAM_ADAPTER_CONTRACT_VERSION, MAX_DIAGRAM_MARKUP_BYTES, runDiagramAdapter, } from './diagram/adapter.js';
@@ -12,9 +15,17 @@ export type { RenderErrorCode, RenderErrorOptions } from './errors.js';
 export { isRenderError, RenderError } from './errors.js';
 export type { IrDocument, IrNode, IrTheme, NetworkPolicy } from './ir.js';
 export type { JsonValue } from './json.js';
+export type { PageRecipe, PageRecipeSummary } from './recipes/index.js';
+export { recipe, recipes } from './recipes/index.js';
 export type { ActionDefinition, ActionType } from './registry/actions.js';
 export { ACTION_DEFINITIONS, ALLOWED_EVENTS, listActionTypes } from './registry/actions.js';
-export type { Catalog, CatalogEntry } from './registry/registry.js';
+export type { BlockCategory } from './registry/block-module.js';
+export { BLOCK_CATEGORIES } from './registry/block-module.js';
+export type { CatalogSearchHit } from './registry/catalog-search.js';
+export { searchCatalog } from './registry/catalog-search.js';
+export type { BlockDescription, CompactBlockDescription, DescribeManyOptions, } from './registry/describe-many.js';
+export { describeMany } from './registry/describe-many.js';
+export type { Catalog, CatalogEntry, CatalogOptions } from './registry/registry.js';
 export { blockTypes, buildPageSpecJsonSchema, catalog, describe, getBlockDefinition, SPEC_SCHEMA_VERSION, } from './registry/registry.js';
 export type { BlockDefinition, SizingContract, SlotSpec } from './registry/roster.js';
 export { buildContentSecurityPolicy } from './render/document.js';
@@ -35,6 +46,8 @@ export { validate, validateOrThrow } from './spec/validate.js';
 export type { LoadThemeOptions, ResolvedTheme, ThemeInput } from './theme/load-theme.js';
 export { loadTheme, resolveTheme, themeDiagnostics, themePresetNames } from './theme/load-theme.js';
 export type { PresetEntry } from './theme/presets.js';
+export type { ThemeRecipeSurface } from './theme/recipes.js';
+export { THEME_RECIPE_SPECS } from './theme/recipes.js';
 export type { PresetSource, ThemeCatalog, ThemeCatalogOptions } from './theme/theme-catalog.js';
 export { buildThemeCatalog, builtinThemeCatalog, catalogPresetNames, loadPresetFile, parsePresetDocument, themeSearchDirectories, } from './theme/theme-catalog.js';
 export type { TokenSpec } from './theme/tokens.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -5,9 +5,14 @@
  * what a minor and a major release promise. Functions that are not implemented
  * yet are not exported — the package never advertises a scaffold.
  */
+export { VALUE_FORMATS } from './data/format-value.js';
 export { checkAdapterMarkup, DIAGRAM_ADAPTER_CONTRACT_VERSION, MAX_DIAGRAM_MARKUP_BYTES, runDiagramAdapter, } from './diagram/adapter.js';
 export { isRenderError, RenderError } from './errors.js';
+export { recipe, recipes } from './recipes/index.js';
 export { ACTION_DEFINITIONS, ALLOWED_EVENTS, listActionTypes } from './registry/actions.js';
+export { BLOCK_CATEGORIES } from './registry/block-module.js';
+export { searchCatalog } from './registry/catalog-search.js';
+export { describeMany } from './registry/describe-many.js';
 export { blockTypes, buildPageSpecJsonSchema, catalog, describe, getBlockDefinition, SPEC_SCHEMA_VERSION, } from './registry/registry.js';
 export { buildContentSecurityPolicy } from './render/document.js';
 export { escapeAttribute, escapeText, escapeUrl, serializeJsonForScript } from './render/escape.js';
@@ -19,6 +24,7 @@ export { parseSpec } from './spec/parse.js';
 export { EMBED_PROVIDER_NAMES, EMBED_PROVIDERS, hostMatchesAnyProvider, hostMatchesProvider, isEmbedProvider, } from './spec/providers.js';
 export { validate, validateOrThrow } from './spec/validate.js';
 export { loadTheme, resolveTheme, themeDiagnostics, themePresetNames } from './theme/load-theme.js';
+export { THEME_RECIPE_SPECS } from './theme/recipes.js';
 export { buildThemeCatalog, builtinThemeCatalog, catalogPresetNames, loadPresetFile, parsePresetDocument, themeSearchDirectories, } from './theme/theme-catalog.js';
 export { TOKEN_SPECS, tokenNames } from './theme/tokens.js';
 export { PACKAGE_NAME, VERSION } from './version.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,EACL,kBAAkB,EAClB,gCAAgC,EAChC,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAIzD,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE5F,OAAO,EACL,UAAU,EACV,uBAAuB,EACvB,OAAO,EACP,QAAQ,EACR,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEpG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE5E,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGpG,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAQvD,OAAO,EACL,kBAAkB,EAClB,gCAAgC,EAChC,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAIzD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAM7D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D,OAAO,EACL,UAAU,EACV,uBAAuB,EACvB,OAAO,EACP,QAAQ,EACR,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEpG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE5E,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGpG,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/ir.d.ts

@@ -6,10 +6,12 @@
  * the Page Spec is the compatibility boundary, and the IR may change without a
  * spec migration.
  */
+import type { DataRow, MaterializedData } from './data/dataset-types.js';
 import type { Diagnostic } from './diagnostics.js';
 import type { JsonValue } from './json.js';
 import type { RuntimeFeature } from './registry/roster.js';
 import type { BindingMap } from './spec/bindings.js';
+import type { Condition } from './spec/conditions.js';
 export interface IrNode {
     /** Stable node ID: author-provided when present, otherwise content-derived. */
     id: string;
@@ -26,6 +28,16 @@ export interface IrNode {
     bindings: BindingMap;
     /** Child node IDs, in authored order. */
     children: string[];
+    /**
+     * Nested slot lists, keyed by `slotKey()` (`aside`, `items[1].blocks`). Set
+     * only when non-empty, so a node without nested blocks has no `slots` key.
+     * `children` and `slots` never share a node.
+     */
+    slots?: Record<string, string[]>;
+    /** `visibleWhen`: the block shows only while this state condition holds. */
+    when?: Condition;
+    /** Rows the block resolved from `dataRef` or `data`, after its transform. */
+    data?: MaterializedData;
     /** Accessibility contract inherited from the block definition. */
     a11y: string;
     runtimeFeatures: RuntimeFeature[];
@@ -50,6 +62,10 @@ export interface IrTheme {
     preset: string;
     extends?: string;
     tokens?: JsonValue;
+    /** Dark-scheme token overrides, resolved by the theme loader. */
+    dark?: JsonValue;
+    /** Presentation recipe per surface, e.g. `{ cards: 'flat' }`. */
+    recipes?: Record<string, string>;
 }
 export interface IrDocument {
     /** Version of the IR shape itself. */
@@ -64,6 +80,8 @@ export interface IrDocument {
         network: NetworkPolicy;
     };
     state: Record<string, JsonValue>;
+    /** Named datasets declared in the spec envelope. */
+    datasets: Record<string, DataRow[]>;
     rootId: string;
     /** All nodes in deterministic depth-first pre-order, root first. */
     nodes: IrNode[];

package/dist/ir.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ir.d.ts","sourceRoot":"","sources":["../src/ir.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,WAAW,MAAM;IACrB,+EAA+E;IAC/E,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,UAAU,GAAG,WAAW,CAAC;IAC/B,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjC,8DAA8D;IAC9D,QAAQ,EAAE,UAAU,CAAC;IACrB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE/E,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,sCAAsC;IACtC,SAAS,EAAE,CAAC,CAAC;IACb,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE;QAAE,OAAO,EAAE,aAAa,CAAA;KAAE,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,iFAAiF;IACjF,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,yDAAyD;AACzD,wBAAgB,UAAU,CAAC,EAAE,EAAE,UAAU,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAE9D;AAED,oDAAoD;AACpD,wBAAgB,UAAU,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAKjE"}
+{"version":3,"file":"ir.d.ts","sourceRoot":"","sources":["../src/ir.ts"],"names":[],"mappings":"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"}

package/dist/ir.js.map

@@ -1 +1 @@
-{"version":3,"file":"ir.js","sourceRoot":"","sources":["../src/ir.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAmEH,yDAAyD;AACzD,MAAM,UAAU,UAAU,CAAC,EAAc;IACvC,OAAO,IAAI,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,UAAU,CAAC,EAAc,EAAE,IAAY;IACrD,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;IAC5B,OAAO,IAAI,CAAC,QAAQ;SACjB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;SACzB,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;AAC7D,CAAC"}
+{"version":3,"file":"ir.js","sourceRoot":"","sources":["../src/ir.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAqFH,yDAAyD;AACzD,MAAM,UAAU,UAAU,CAAC,EAAc;IACvC,OAAO,IAAI,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,UAAU,CAAC,EAAc,EAAE,IAAY;IACrD,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;IAC5B,OAAO,IAAI,CAAC,QAAQ;SACjB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;SACzB,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;AAC7D,CAAC"}

package/dist/mcp/mcp-http-transport.d.ts

@@ -0,0 +1,68 @@
+/**
+ * MCP Streamable HTTP transport, written against the Fetch API only.
+ *
+ * `handleMcpHttpRequest` turns one `Request` into one `Response`, so any
+ * runtime with `Request`/`Response` can host it: a Cloudflare Worker, Deno, Bun
+ * or Node 20+. It imports nothing Node-specific and no tool with a side effect;
+ * the host passes the tool list and a per-request context, which is how the
+ * Worker attaches authorization, rate limiting and storage to the shared tool
+ * contracts.
+ *
+ * The server is stateless: it issues no `Mcp-Session-Id`, opens no
+ * server-initiated stream (GET answers 405), and replies to every POST with a
+ * single JSON body rather than an SSE stream, which the specification allows.
+ */
+import { type ToolResult } from './mcp-protocol.js';
+import type { McpTool } from './mcp-tool-definitions.js';
+/** Request body ceiling used when the host does not set one: 1 MiB. */
+export declare const DEFAULT_MCP_MAX_REQUEST_BYTES: number;
+/**
+ * Most members one batch may carry. A batch is answered member by member in one
+ * request, so without a ceiling a small body buys unbounded work and output.
+ */
+export declare const DEFAULT_MCP_MAX_BATCH_SIZE = 16;
+export interface McpHttpOptions<C> {
+    /** The tools this endpoint serves, in the order `tools/list` announces them. */
+    tools: readonly McpTool<C, ToolResult | Promise<ToolResult>>[];
+    /** Per-request context handed to every tool call in this request. */
+    context: C;
+    /** `initialize` instructions for the model. */
+    instructions: string;
+    /**
+     * Browser origins allowed besides the endpoint's own. A request carrying any
+     * other `Origin` is refused with 403, which is the DNS-rebinding guard the
+     * transport specification requires. Requests without `Origin` (non-browser
+     * clients) are not affected.
+     */
+    allowedOrigins?: readonly string[];
+    /** Request body ceiling in bytes. */
+    maxRequestBytes?: number;
+    /** Most members a JSON-RPC batch may carry. */
+    maxBatchSize?: number;
+    /**
+     * Runs once per request after every transport check passed and before any
+     * message is dispatched. A returned `Response` is sent as is (for example a
+     * 401 for a rejected bearer); `undefined` lets the request through.
+     */
+    preflight?: () => Promise<Response | undefined>;
+    /**
+     * Turns an error a tool threw into a tool result. Defaults to reporting the
+     * error's message; a hosted server passes a mapper that hides internals.
+     */
+    toolError?: (error: unknown) => ToolResult;
+}
+/**
+ * Serve one Streamable HTTP request on the MCP endpoint.
+ *
+ * - POST with one JSON-RPC message (or a batch, for 2025-03-26 clients) answers
+ *   200 with the JSON response, or 202 with no body when every message was a
+ *   notification or a response.
+ * - A batch answers 400 when the request's protocol revision has no batching
+ *   (2025-06-18 and later), when it is larger than `maxBatchSize`, or when it
+ *   carries `initialize`, which must be sent alone.
+ * - Any other method answers 405: this server has no server-initiated stream
+ *   and no session to delete.
+ * - An unsupported `MCP-Protocol-Version` header answers 400.
+ */
+export declare function handleMcpHttpRequest<C>(request: Request, options: McpHttpOptions<C>): Promise<Response>;
+//# sourceMappingURL=mcp-http-transport.d.ts.map

package/dist/mcp/mcp-http-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-http-transport.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-http-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAQL,KAAK,UAAU,EAEhB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEzD,uEAAuE;AACvE,eAAO,MAAM,6BAA6B,QAAc,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,gFAAgF;IAChF,KAAK,EAAE,SAAS,OAAO,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;IAC/D,qEAAqE;IACrE,OAAO,EAAE,CAAC,CAAC;IACX,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,qCAAqC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC;IAChD;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,UAAU,CAAC;CAC5C;AAuDD;;;;;;;;;;;;GAYG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,QAAQ,CAAC,CAiFnB"}

package/dist/mcp/mcp-http-transport.js

@@ -0,0 +1,140 @@
+/**
+ * MCP Streamable HTTP transport, written against the Fetch API only.
+ *
+ * `handleMcpHttpRequest` turns one `Request` into one `Response`, so any
+ * runtime with `Request`/`Response` can host it: a Cloudflare Worker, Deno, Bun
+ * or Node 20+. It imports nothing Node-specific and no tool with a side effect;
+ * the host passes the tool list and a per-request context, which is how the
+ * Worker attaches authorization, rate limiting and storage to the shared tool
+ * contracts.
+ *
+ * The server is stateless: it issues no `Mcp-Session-Id`, opens no
+ * server-initiated stream (GET answers 405), and replies to every POST with a
+ * single JSON body rather than an SSE stream, which the specification allows.
+ */
+import { routeMcpMessage } from './mcp-json-rpc-dispatch.js';
+import { DEFAULT_HTTP_PROTOCOL, isSupportedProtocol, JSON_RPC_ERRORS, protocolAllowsBatching, rpcError, toolErrorResult, } from './mcp-protocol.js';
+/** Request body ceiling used when the host does not set one: 1 MiB. */
+export const DEFAULT_MCP_MAX_REQUEST_BYTES = 1024 * 1024;
+/**
+ * Most members one batch may carry. A batch is answered member by member in one
+ * request, so without a ceiling a small body buys unbounded work and output.
+ */
+export const DEFAULT_MCP_MAX_BATCH_SIZE = 16;
+const JSON_HEADERS = { 'content-type': 'application/json', 'cache-control': 'no-store' };
+function jsonResponse(status, body, extra = {}) {
+    return new Response(JSON.stringify(body), { status, headers: { ...JSON_HEADERS, ...extra } });
+}
+function transportError(status, code, message) {
+    return jsonResponse(status, rpcError(null, code, message));
+}
+function originAllowed(request, allowed) {
+    const origin = request.headers.get('origin');
+    if (origin === null)
+        return true;
+    return origin === new URL(request.url).origin || allowed.includes(origin);
+}
+/** Why a batch cannot be served, or `undefined` when it can. */
+function batchRefusal(batch, version, maxBatchSize = DEFAULT_MCP_MAX_BATCH_SIZE) {
+    if (batch.length === 0)
+        return 'invalid request';
+    if (!protocolAllowsBatching(version)) {
+        return `protocol revision ${version} does not support JSON-RPC batches`;
+    }
+    if (batch.length > maxBatchSize)
+        return `a batch may carry at most ${maxBatchSize} messages`;
+    const initializes = batch.some((member) => typeof member === 'object' &&
+        member !== null &&
+        member.method === 'initialize');
+    return initializes ? 'initialize must not be part of a batch' : undefined;
+}
+/** Run one routed message to completion. Tool errors become tool results. */
+async function answer(message, options) {
+    const route = routeMcpMessage(message, options.tools, { instructions: options.instructions });
+    if (route.kind === 'silent')
+        return undefined;
+    if (route.kind === 'reply')
+        return route.response;
+    let result;
+    try {
+        result = await route.tool.run(route.args, options.context);
+    }
+    catch (error) {
+        result = (options.toolError ?? toolErrorResult)(error);
+    }
+    return { jsonrpc: '2.0', id: route.id, result };
+}
+/**
+ * Serve one Streamable HTTP request on the MCP endpoint.
+ *
+ * - POST with one JSON-RPC message (or a batch, for 2025-03-26 clients) answers
+ *   200 with the JSON response, or 202 with no body when every message was a
+ *   notification or a response.
+ * - A batch answers 400 when the request's protocol revision has no batching
+ *   (2025-06-18 and later), when it is larger than `maxBatchSize`, or when it
+ *   carries `initialize`, which must be sent alone.
+ * - Any other method answers 405: this server has no server-initiated stream
+ *   and no session to delete.
+ * - An unsupported `MCP-Protocol-Version` header answers 400.
+ */
+export async function handleMcpHttpRequest(request, options) {
+    if (!originAllowed(request, options.allowedOrigins ?? [])) {
+        return transportError(403, JSON_RPC_ERRORS.invalidRequest, 'origin not allowed');
+    }
+    if (request.method.toUpperCase() !== 'POST') {
+        return jsonResponse(405, rpcError(null, JSON_RPC_ERRORS.invalidRequest, 'method not allowed: use POST'), { allow: 'POST' });
+    }
+    const header = request.headers.get('mcp-protocol-version');
+    if (header !== null && !isSupportedProtocol(header)) {
+        return transportError(400, JSON_RPC_ERRORS.invalidRequest, `unsupported MCP-Protocol-Version: ${header}`);
+    }
+    // A client that omits the header is assumed to speak the revision the
+    // transport specification names for that case.
+    const version = header ?? DEFAULT_HTTP_PROTOCOL;
+    const contentType = request.headers.get('content-type') ?? '';
+    if (!contentType.toLowerCase().includes('application/json')) {
+        return transportError(415, JSON_RPC_ERRORS.invalidRequest, 'content-type must be application/json');
+    }
+    const limit = options.maxRequestBytes ?? DEFAULT_MCP_MAX_REQUEST_BYTES;
+    const declared = Number(request.headers.get('content-length') ?? '0');
+    if (Number.isFinite(declared) && declared > limit) {
+        return transportError(413, JSON_RPC_ERRORS.invalidRequest, `request body exceeds ${limit} bytes`);
+    }
+    const body = await request.text();
+    if (new TextEncoder().encode(body).length > limit) {
+        return transportError(413, JSON_RPC_ERRORS.invalidRequest, `request body exceeds ${limit} bytes`);
+    }
+    let message;
+    try {
+        message = JSON.parse(body);
+    }
+    catch {
+        return transportError(400, JSON_RPC_ERRORS.parse, 'parse error');
+    }
+    if (Array.isArray(message)) {
+        const refused = batchRefusal(message, version, options.maxBatchSize);
+        if (refused !== undefined)
+            return transportError(400, JSON_RPC_ERRORS.invalidRequest, refused);
+    }
+    const gated = await options.preflight?.();
+    if (gated !== undefined)
+        return gated;
+    if (Array.isArray(message)) {
+        // Members run in order so per-subject rate limits count deterministically.
+        const responses = [];
+        for (const member of message) {
+            const response = await answer(member, options);
+            if (response !== undefined)
+                responses.push(response);
+        }
+        return responses.length === 0
+            ? new Response(null, { status: 202 })
+            : jsonResponse(200, responses);
+    }
+    const response = await answer(message, options);
+    if (response === undefined)
+        return new Response(null, { status: 202 });
+    const malformed = response.error?.code === JSON_RPC_ERRORS.invalidRequest && response.result === undefined;
+    return jsonResponse(malformed ? 400 : 200, response);
+}
+//# sourceMappingURL=mcp-http-transport.js.map

package/dist/mcp/mcp-http-transport.js.map

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

package/dist/mcp/mcp-json-rpc-dispatch.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Transport-independent JSON-RPC routing for the MCP server.
+ *
+ * `routeMcpMessage` answers everything a server can answer without running a
+ * tool (initialize, ping, tools/list, protocol errors) and hands a `tools/call`
+ * back to the transport as a pending call. The transport decides how to run it:
+ * stdio runs it synchronously, HTTP awaits it after authorization. That split
+ * keeps one protocol implementation while letting each transport own its side
+ * effects.
+ */
+import { type JsonRpcResponse } from './mcp-protocol.js';
+import type { McpToolDefinition } from './mcp-tool-definitions.js';
+/** What a transport announces about itself in `initialize`. */
+export interface McpServerDescription {
+    /** Guidance for the model: the loop and what `render` returns on this transport. */
+    instructions: string;
+}
+/** The outcome of routing one JSON-RPC message. */
+export type McpRoute<T extends McpToolDefinition> = {
+    kind: 'reply';
+    response: JsonRpcResponse;
+} | {
+    kind: 'silent';
+} | {
+    kind: 'call';
+    id: string | number;
+    tool: T;
+    args: Record<string, unknown>;
+};
+/** True when the message is a JSON-RPC response sent to us, which needs no reply. */
+export declare function isJsonRpcResponse(message: unknown): boolean;
+/**
+ * Route one JSON-RPC message against a tool list. Notifications and responses
+ * sent to us are silent; everything else either gets a reply now or becomes a
+ * pending tool call.
+ */
+export declare function routeMcpMessage<T extends McpToolDefinition>(message: unknown, tools: readonly T[], server: McpServerDescription): McpRoute<T>;
+//# sourceMappingURL=mcp-json-rpc-dispatch.d.ts.map

package/dist/mcp/mcp-json-rpc-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-json-rpc-dispatch.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-json-rpc-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAIL,KAAK,eAAe,EAGrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,+DAA+D;AAC/D,MAAM,WAAW,oBAAoB;IACnC,oFAAoF;IACpF,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,mDAAmD;AACnD,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,iBAAiB,IAC5C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAWlF,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAI3D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,iBAAiB,EACzD,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,MAAM,EAAE,oBAAoB,GAC3B,QAAQ,CAAC,CAAC,CAAC,CAiFb"}

package/dist/mcp/mcp-json-rpc-dispatch.js

@@ -0,0 +1,98 @@
+/**
+ * Transport-independent JSON-RPC routing for the MCP server.
+ *
+ * `routeMcpMessage` answers everything a server can answer without running a
+ * tool (initialize, ping, tools/list, protocol errors) and hands a `tools/call`
+ * back to the transport as a pending call. The transport decides how to run it:
+ * stdio runs it synchronously, HTTP awaits it after authorization. That split
+ * keeps one protocol implementation while letting each transport own its side
+ * effects.
+ */
+import { PACKAGE_NAME, VERSION } from '../version.js';
+import { isSupportedProtocol, JSON_RPC_ERRORS, LATEST_PROTOCOL, rpcError, } from './mcp-protocol.js';
+function isRequest(message) {
+    return (typeof message === 'object' &&
+        message !== null &&
+        message.jsonrpc === '2.0' &&
+        typeof message.method === 'string');
+}
+/** True when the message is a JSON-RPC response sent to us, which needs no reply. */
+export function isJsonRpcResponse(message) {
+    return (typeof message === 'object' && message !== null && ('result' in message || 'error' in message));
+}
+/**
+ * Route one JSON-RPC message against a tool list. Notifications and responses
+ * sent to us are silent; everything else either gets a reply now or becomes a
+ * pending tool call.
+ */
+export function routeMcpMessage(message, tools, server) {
+    if (!isRequest(message)) {
+        if (isJsonRpcResponse(message))
+            return { kind: 'silent' };
+        const id = message?.id;
+        return {
+            kind: 'reply',
+            response: rpcError(typeof id === 'string' || typeof id === 'number' ? id : null, JSON_RPC_ERRORS.invalidRequest, 'invalid request'),
+        };
+    }
+    if (message.id === undefined)
+        return { kind: 'silent' };
+    // MCP requires a string or number id; null is reserved for error replies.
+    if (message.id === null) {
+        return {
+            kind: 'reply',
+            response: rpcError(null, JSON_RPC_ERRORS.invalidRequest, 'invalid request'),
+        };
+    }
+    const id = message.id;
+    const params = message.params ?? {};
+    const reply = (result) => ({
+        kind: 'reply',
+        response: { jsonrpc: '2.0', id, result },
+    });
+    switch (message.method) {
+        case 'initialize': {
+            const requested = params.protocolVersion;
+            return reply({
+                protocolVersion: isSupportedProtocol(requested) ? requested : LATEST_PROTOCOL,
+                capabilities: { tools: { listChanged: false } },
+                serverInfo: { name: PACKAGE_NAME, version: VERSION },
+                instructions: server.instructions,
+            });
+        }
+        case 'ping':
+            return reply({});
+        case 'tools/list':
+            return reply({
+                tools: tools.map(({ name, description, inputSchema }) => ({
+                    name,
+                    description,
+                    inputSchema,
+                })),
+            });
+        case 'tools/call': {
+            const tool = tools.find((candidate) => candidate.name === params.name);
+            if (tool === undefined) {
+                return {
+                    kind: 'reply',
+                    response: rpcError(id, JSON_RPC_ERRORS.invalidParams, `unknown tool: ${String(params.name)}`),
+                };
+            }
+            const args = params.arguments;
+            return {
+                kind: 'call',
+                id,
+                tool,
+                args: typeof args === 'object' && args !== null && !Array.isArray(args)
+                    ? args
+                    : {},
+            };
+        }
+        default:
+            return {
+                kind: 'reply',
+                response: rpcError(id, JSON_RPC_ERRORS.methodNotFound, `method not found: ${message.method}`),
+            };
+    }
+}
+//# sourceMappingURL=mcp-json-rpc-dispatch.js.map

package/dist/mcp/mcp-json-rpc-dispatch.js.map

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