@cyanmycelium/mcp-broker 0.4.0 → 1.2.0

package/dist/broker/broker.grammars.d.ts

@@ -1,130 +0,0 @@
-import { McpGrammar } from "@cyanmycelium/mcp-core";
-/**
- * Locale identifier used to look up a grammar JSON file under
- * `<userAgent>/<locale>.json`. Open string: a host application can use any
- * value its grammar resources support.
- *
- * The broker registers each `(userAgent, locale)` pair found on disk as a
- * separate `McpGrammar` keyed by {@link brokerGrammarKey}. The actual
- * resolution of "which key to use for this session" is delegated to
- * `@cyanmycelium/mcp-core@0.3.0`'s `grammarResolverFromOptions`, which
- * handles BCP-47 narrowing (`fr-CA` → `fr` → `en`), agent-family fallback,
- * and the optional version dimension natively.
- */
-export type BrokerLocale = string;
-/**
- * User-agent family identifier used to look up a grammar JSON file under
- * `<userAgent>/<locale>.json`. Open string. Conventional values follow
- * the defaults emitted by `grammarResolverFromOptions`: `claude`, `gpt`,
- * `mistral`, `copilot`, plus the universal `default`. Custom families
- * are supported by passing a custom `agents` map in
- * `StartBrokerServerOptions.grammarResolverOptions`.
- */
-export type BrokerUserAgent = string;
-/**
- * Builds the canonical grammar key for the `(userAgent, locale, version?)`
- * matrix the broker registers on disk.
- *
- * Pattern:
- *   - `"<userAgent>:<locale>"` (no version) — e.g. `"claude:fr"`, `"default:en"`
- *   - `"<userAgent>:<locale>@<version>"` (versioned) — e.g. `"claude:fr@v2"`
- *
- * The colon separator is reserved for the `<ua>:<locale>` composition; the
- * `@` separator is reserved for the optional version suffix. Neither
- * character is allowed inside the identifier segments. This matches the
- * default `composeKey` of `grammarResolverFromOptions` exactly, so a
- * broker-loaded grammar at `claude/fr@v2.json` is automatically picked up
- * when a Claude session resolves to the `claude:fr@v2` candidate.
- */
-export declare function brokerGrammarKey(userAgent: BrokerUserAgent, locale: BrokerLocale, version?: string): string;
-/**
- * Parses a grammar JSON filename of the form `<locale>.json` or
- * `<locale>@<version>.json` (without the `.json` suffix) into its
- * components. The first `@` (if any) separates locale from version; any
- * additional `@` is folded into the version string.
- *
- * Returns `null` when the input cannot be split into a usable locale.
- */
-export declare function parseBrokerGrammarStem(stem: string): {
-    locale: BrokerLocale;
-    version?: string;
-} | null;
-/**
- * Loads and caches the grammar for a given `(userAgent, locale, version?)`
- * combination. Returns `undefined` (instead of throwing) when the resource
- * file is missing, so the caller can implement a fallback chain.
- *
- * Filename convention on disk:
- *   - `<userAgent>/<locale>.json` (no version)
- *   - `<userAgent>/<locale>@<version>.json` (versioned)
- */
-export declare function loadBrokerGrammar(userAgent: BrokerUserAgent, locale: BrokerLocale, version?: string): McpGrammar | undefined;
-/**
- * Walks a grammars directory and yields every `(userAgent, locale)` pair
- * found on disk. The directory must follow the layout
- * `<dir>/<userAgent>/<locale>.json`.
- *
- * Used by the broker server at startup to bulk-register both the packaged
- * grammars and any local overrides. No hard-coded list of supported
- * user-agents or locales — adding a new grammar is dropping a JSON file.
- */
-export interface BrokerGrammarEntry {
-    userAgent: BrokerUserAgent;
-    locale: BrokerLocale;
-    /** Set only for filenames carrying an `@<version>` suffix. */
-    version?: string;
-    /** Composed via {@link brokerGrammarKey} from the three segments above. */
-    key: string;
-    grammar: McpGrammar;
-}
-export declare function iterBrokerGrammarsFrom(grammarsDir: string): Generator<BrokerGrammarEntry>;
-/**
- * Walks the **packaged** grammars directory (the one shipped with the
- * mcp-broker package). Equivalent to `iterBrokerGrammarsFrom(<packaged-dir>)`.
- *
- * For local user overrides, see {@link iterBrokerGrammarsFrom} with a custom
- * directory — typically `.mcp-broker/grammars/` next to the config file.
- */
-export declare function iterAvailableBrokerGrammars(): Generator<BrokerGrammarEntry>;
-/**
- * Returns the baseline grammar used by the broker behaviors as their
- * source-of-truth for inline tool / property descriptions.
- *
- * Conventionally this is `default:en`. Session-specific grammars selected by
- * the resolver override individual entries on top of this baseline.
- *
- * Throws if the JSON resource is missing — the broker behaviors cannot be
- * built without baseline descriptions.
- */
-export declare function brokerBaselineGrammar(): McpGrammar;
-/**
- * Convenience accessor for a baseline tool description. Throws when the
- * tool is not listed in the baseline grammar — i.e. the JSON file is missing
- * an entry for a tool the code knows about.
- */
-export declare function brokerBaselineToolDescription(toolName: string): string;
-/**
- * Convenience accessor for a baseline property description. Throws when the
- * property is not listed under the tool in the baseline grammar.
- */
-export declare function brokerBaselinePropertyDescription(toolName: string, propertyName: string): string;
-/**
- * Convenience accessor for a baseline resource name. Throws when the resource
- * URI has no entry in the baseline grammar.
- */
-export declare function brokerBaselineResourceName(uri: string): string;
-/**
- * Convenience accessor for a baseline resource description. Throws when the
- * resource URI has no entry in the baseline grammar.
- */
-export declare function brokerBaselineResourceDescription(uri: string): string;
-/**
- * Convenience accessor for a baseline resource template name. Throws when the
- * template URI has no entry in the baseline grammar.
- */
-export declare function brokerBaselineResourceTemplateName(uriTemplate: string): string;
-/**
- * Convenience accessor for a baseline resource template description. Throws
- * when the template URI has no entry in the baseline grammar.
- */
-export declare function brokerBaselineResourceTemplateDescription(uriTemplate: string): string;

package/dist/broker/broker.grammars.js

@@ -1,229 +0,0 @@
-import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-import { McpGrammar } from "@cyanmycelium/mcp-core";
-// ---------------------------------------------------------------------------
-// Canonical grammar key
-// ---------------------------------------------------------------------------
-/**
- * Builds the canonical grammar key for the `(userAgent, locale, version?)`
- * matrix the broker registers on disk.
- *
- * Pattern:
- *   - `"<userAgent>:<locale>"` (no version) — e.g. `"claude:fr"`, `"default:en"`
- *   - `"<userAgent>:<locale>@<version>"` (versioned) — e.g. `"claude:fr@v2"`
- *
- * The colon separator is reserved for the `<ua>:<locale>` composition; the
- * `@` separator is reserved for the optional version suffix. Neither
- * character is allowed inside the identifier segments. This matches the
- * default `composeKey` of `grammarResolverFromOptions` exactly, so a
- * broker-loaded grammar at `claude/fr@v2.json` is automatically picked up
- * when a Claude session resolves to the `claude:fr@v2` candidate.
- */
-export function brokerGrammarKey(userAgent, locale, version) {
-    const base = `${userAgent}:${locale}`;
-    return version ? `${base}@${version}` : base;
-}
-/**
- * Parses a grammar JSON filename of the form `<locale>.json` or
- * `<locale>@<version>.json` (without the `.json` suffix) into its
- * components. The first `@` (if any) separates locale from version; any
- * additional `@` is folded into the version string.
- *
- * Returns `null` when the input cannot be split into a usable locale.
- */
-export function parseBrokerGrammarStem(stem) {
-    const at = stem.indexOf("@");
-    if (at < 0)
-        return stem.length > 0 ? { locale: stem } : null;
-    const locale = stem.slice(0, at);
-    const version = stem.slice(at + 1);
-    if (locale.length === 0 || version.length === 0)
-        return null;
-    return { locale, version };
-}
-// ---------------------------------------------------------------------------
-// JSON resource loading
-// ---------------------------------------------------------------------------
-/**
- * Absolute path of the directory holding the grammar JSON resources.
- *
- * Layout (one folder per user-agent family, one JSON file per locale):
- * ```
- * <GRAMMARS_DIR>/
- * ├── default/
- * │   ├── en.json
- * │   ├── fr.json
- * │   └── zh.json
- * └── claude/
- *     ├── en.json
- *     └── fr.json
- * ```
- *
- * JSON files live alongside this module in `src/broker/grammars/` during
- * development and are mirrored under `dist/broker/grammars/` at build time
- * by `scripts/copy-assets.mjs`. Adding a new `(userAgent, locale)` pair is
- * just a matter of dropping a new JSON file — no code change required.
- */
-const GRAMMARS_DIR = join(dirname(fileURLToPath(import.meta.url)), "grammars");
-const _cache = new Map();
-/**
- * Loads and caches the grammar for a given `(userAgent, locale, version?)`
- * combination. Returns `undefined` (instead of throwing) when the resource
- * file is missing, so the caller can implement a fallback chain.
- *
- * Filename convention on disk:
- *   - `<userAgent>/<locale>.json` (no version)
- *   - `<userAgent>/<locale>@<version>.json` (versioned)
- */
-export function loadBrokerGrammar(userAgent, locale, version) {
-    const key = brokerGrammarKey(userAgent, locale, version);
-    const cached = _cache.get(key);
-    if (cached)
-        return cached;
-    const filename = version ? `${locale}@${version}.json` : `${locale}.json`;
-    const path = join(GRAMMARS_DIR, userAgent, filename);
-    if (!existsSync(path))
-        return undefined;
-    const raw = readFileSync(path, "utf-8");
-    const data = JSON.parse(raw);
-    const grammar = McpGrammar.fromJSON(data);
-    _cache.set(key, grammar);
-    return grammar;
-}
-export function* iterBrokerGrammarsFrom(grammarsDir) {
-    if (!existsSync(grammarsDir))
-        return;
-    const userAgents = readdirSync(grammarsDir).sort();
-    for (const userAgent of userAgents) {
-        const uaDir = join(grammarsDir, userAgent);
-        if (!statSync(uaDir).isDirectory())
-            continue;
-        const files = readdirSync(uaDir).sort();
-        for (const file of files) {
-            if (!file.endsWith(".json"))
-                continue;
-            const stem = file.slice(0, -".json".length);
-            const parsed = parseBrokerGrammarStem(stem);
-            if (!parsed) {
-                process.stderr.write(`[mcp-broker] Skipping unparseable grammar filename ${file} in ${uaDir}\n`);
-                continue;
-            }
-            const { locale, version } = parsed;
-            const path = join(uaDir, file);
-            try {
-                const raw = readFileSync(path, "utf-8");
-                const data = JSON.parse(raw);
-                const grammar = McpGrammar.fromJSON(data);
-                yield {
-                    userAgent,
-                    locale,
-                    version,
-                    key: brokerGrammarKey(userAgent, locale, version),
-                    grammar,
-                };
-            }
-            catch (err) {
-                process.stderr.write(`[mcp-broker] Failed to load grammar ${path}: ${err.message}\n`);
-            }
-        }
-    }
-}
-/**
- * Walks the **packaged** grammars directory (the one shipped with the
- * mcp-broker package). Equivalent to `iterBrokerGrammarsFrom(<packaged-dir>)`.
- *
- * For local user overrides, see {@link iterBrokerGrammarsFrom} with a custom
- * directory — typically `.mcp-broker/grammars/` next to the config file.
- */
-export function* iterAvailableBrokerGrammars() {
-    yield* iterBrokerGrammarsFrom(GRAMMARS_DIR);
-}
-// ---------------------------------------------------------------------------
-// Baseline helpers (used by behaviors to source their inline descriptions)
-// ---------------------------------------------------------------------------
-/**
- * Returns the baseline grammar used by the broker behaviors as their
- * source-of-truth for inline tool / property descriptions.
- *
- * Conventionally this is `default:en`. Session-specific grammars selected by
- * the resolver override individual entries on top of this baseline.
- *
- * Throws if the JSON resource is missing — the broker behaviors cannot be
- * built without baseline descriptions.
- */
-export function brokerBaselineGrammar() {
-    const g = loadBrokerGrammar("default", "en");
-    if (!g) {
-        throw new Error(`Required baseline broker grammar "default:en" is missing — expected at ${join(GRAMMARS_DIR, "default", "en.json")}.`);
-    }
-    return g;
-}
-/**
- * Convenience accessor for a baseline tool description. Throws when the
- * tool is not listed in the baseline grammar — i.e. the JSON file is missing
- * an entry for a tool the code knows about.
- */
-export function brokerBaselineToolDescription(toolName) {
-    const desc = brokerBaselineGrammar().getToolDescription(toolName);
-    if (!desc) {
-        throw new Error(`Missing baseline description for tool "${toolName}" in default/en.json.`);
-    }
-    return desc;
-}
-/**
- * Convenience accessor for a baseline property description. Throws when the
- * property is not listed under the tool in the baseline grammar.
- */
-export function brokerBaselinePropertyDescription(toolName, propertyName) {
-    const desc = brokerBaselineGrammar().getPropertyDescription(toolName, propertyName);
-    if (!desc) {
-        throw new Error(`Missing baseline description for property "${propertyName}" of tool "${toolName}" in default/en.json.`);
-    }
-    return desc;
-}
-/**
- * Convenience accessor for a baseline resource name. Throws when the resource
- * URI has no entry in the baseline grammar.
- */
-export function brokerBaselineResourceName(uri) {
-    const name = brokerBaselineGrammar().getResourceName(uri);
-    if (!name) {
-        throw new Error(`Missing baseline name for resource "${uri}" in default/en.json.`);
-    }
-    return name;
-}
-/**
- * Convenience accessor for a baseline resource description. Throws when the
- * resource URI has no entry in the baseline grammar.
- */
-export function brokerBaselineResourceDescription(uri) {
-    const desc = brokerBaselineGrammar().getResourceDescription(uri);
-    if (!desc) {
-        throw new Error(`Missing baseline description for resource "${uri}" in default/en.json.`);
-    }
-    return desc;
-}
-/**
- * Convenience accessor for a baseline resource template name. Throws when the
- * template URI has no entry in the baseline grammar.
- */
-export function brokerBaselineResourceTemplateName(uriTemplate) {
-    const name = brokerBaselineGrammar().getResourceTemplateName(uriTemplate);
-    if (!name) {
-        throw new Error(`Missing baseline name for resource template "${uriTemplate}" in default/en.json.`);
-    }
-    return name;
-}
-/**
- * Convenience accessor for a baseline resource template description. Throws
- * when the template URI has no entry in the baseline grammar.
- */
-export function brokerBaselineResourceTemplateDescription(uriTemplate) {
-    const desc = brokerBaselineGrammar().getResourceTemplateDescription(uriTemplate);
-    if (!desc) {
-        throw new Error(`Missing baseline description for resource template "${uriTemplate}" in default/en.json.`);
-    }
-    return desc;
-}
-//# sourceMappingURL=broker.grammars.js.map

package/dist/broker/broker.grammars.js.map

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

package/dist/broker/broker.server.d.ts

@@ -1,66 +0,0 @@
-import type { GrammarResolverOptions, IMcpServer, IMessageTransport } from "@cyanmycelium/mcp-core";
-import type { BrokerContext } from "./broker.context.js";
-/**
- * Reserved provider slot name under which the broker exposes itself as an MCP
- * server. Clients reach it via `<host>/_broker/mcp` (or any other client transport).
- *
- * Prefixed with `_` to make it unambiguously a system slot, and to reduce the
- * chance of collision with user-supplied provider names.
- */
-export declare const BROKER_PROVIDER_NAME = "_broker";
-/**
- * Optional knobs passed to {@link startBrokerServer}. Lets the embedder
- * replace either resolver with custom logic without touching mcp-broker
- * internals.
- */
-export interface StartBrokerServerOptions {
-    /**
-     * Overrides for the built-in grammar resolver from `@cyanmycelium/mcp-core`.
-     *
-     * The broker installs sensible defaults: `localeSource` reads
-     * `process.env.MCP_BROKER_LOCALE`, the `agents` map uses the mcp-core
-     * defaults (`claude`, `gpt`, `mistral`, `copilot`, `default`), the
-     * narrowing chain is BCP-47-style, and `fallbackKey` is `default:en`
-     * so the baseline grammar always matches as last resort.
-     *
-     * Pass partial overrides here to inject a custom `localeSource` (e.g.
-     * pull from an HTTP header proxied by your transport), enable the
-     * `versionFrom` dimension, or extend the `agents` map with additional
-     * LLM families. Anything you omit keeps the broker default.
-     */
-    grammarResolverOptions?: Partial<GrammarResolverOptions>;
-    /**
-     * Path to a user-supplied grammars directory whose `<userAgent>/<locale>.json`
-     * files are registered **in addition to** the packaged grammars.
-     *
-     * Both packaged and local entries are registered raw against the server
-     * via `withGrammar(brokerGrammarKey(ua, locale), grammar)`. The
-     * candidate-chain resolution implemented by `McpServer.initialize` in
-     * mcp-core@0.3.0 then walks the chain and merges the four layers
-     * (behavior, adapter, static, store) for the first matching key —
-     * the old hand-rolled pre-merge cascade is no longer needed.
-     *
-     * When `undefined` (default), only the packaged grammars are loaded.
-     */
-    localGrammarsDir?: string;
-}
-/**
- * Constructs the broker's own MCP server (the Tier-1 introspection behaviors)
- * and returns the running server plus the loopback transport that must be
- * registered against the {@link WsTunnel} as the `_broker` provider slot.
- *
- * Usage from {@link WsTunnel.start}:
- * ```ts
- * const { server, clientTransport } = await startBrokerServer(this, { ... });
- * this._registerLoopbackProvider(BROKER_PROVIDER_NAME, clientTransport);
- * ```
- *
- * @param context  Read-only view of the broker's state.
- * @param options  Optional resolver overrides.
- * @returns The running {@link IMcpServer} (call `.stop()` on shutdown) and the
- *          loopback transport to attach to the tunnel.
- */
-export declare function startBrokerServer(context: BrokerContext, options?: StartBrokerServerOptions): Promise<{
-    server: IMcpServer;
-    clientTransport: IMessageTransport;
-}>;

package/dist/broker/broker.server.js

@@ -1,73 +0,0 @@
-import { McpServerBuilder, LoopbackTransport } from "@cyanmycelium/mcp-core";
-import { BrokerInfoBehavior } from "./behaviors/broker.behavior.info.js";
-import { BrokerProvidersBehavior } from "./behaviors/broker.behavior.providers.js";
-import { iterAvailableBrokerGrammars, iterBrokerGrammarsFrom } from "./broker.grammars.js";
-/**
- * Reserved provider slot name under which the broker exposes itself as an MCP
- * server. Clients reach it via `<host>/_broker/mcp` (or any other client transport).
- *
- * Prefixed with `_` to make it unambiguously a system slot, and to reduce the
- * chance of collision with user-supplied provider names.
- */
-export const BROKER_PROVIDER_NAME = "_broker";
-/**
- * Constructs the broker's own MCP server (the Tier-1 introspection behaviors)
- * and returns the running server plus the loopback transport that must be
- * registered against the {@link WsTunnel} as the `_broker` provider slot.
- *
- * Usage from {@link WsTunnel.start}:
- * ```ts
- * const { server, clientTransport } = await startBrokerServer(this, { ... });
- * this._registerLoopbackProvider(BROKER_PROVIDER_NAME, clientTransport);
- * ```
- *
- * @param context  Read-only view of the broker's state.
- * @param options  Optional resolver overrides.
- * @returns The running {@link IMcpServer} (call `.stop()` on shutdown) and the
- *          loopback transport to attach to the tunnel.
- */
-export async function startBrokerServer(context, options = {}) {
-    const [serverEnd, clientEnd] = LoopbackTransport.createPair();
-    // Without an initializer, McpServerBuilder reports `version: "0.0.0"` in the
-    // `initialize` handshake. Supply the real package version from the context.
-    const builder = new McpServerBuilder()
-        .withName(BROKER_PROVIDER_NAME)
-        .withTransport(serverEnd)
-        .withInitializer({
-        initialize: () => ({
-            protocolVersion: "2024-11-05",
-            serverInfo: { name: BROKER_PROVIDER_NAME, version: context.version },
-        }),
-    })
-        .register(new BrokerInfoBehavior(context), new BrokerProvidersBehavior(context));
-    // Register every `(userAgent, locale)` JSON found on disk as a raw
-    // grammar layer. The candidate-chain resolution in
-    // McpServer.initialize (mcp-core@0.3.0) walks the resolver's chain
-    // and merges all matching layers — so partial user-agent files no
-    // longer need to be pre-merged with the default-locale baseline at
-    // boot. Local overrides come after packaged entries; identical keys
-    // get overlaid via the registry's last-write-wins.
-    for (const entry of iterAvailableBrokerGrammars()) {
-        builder.withGrammar(entry.key, entry.grammar);
-    }
-    if (options.localGrammarsDir) {
-        for (const entry of iterBrokerGrammarsFrom(options.localGrammarsDir)) {
-            builder.withGrammar(entry.key, entry.grammar);
-        }
-    }
-    // Wire the resolver via mcp-core's declarative helper. The broker
-    // ships sensible defaults (locale from MCP_BROKER_LOCALE env, agents
-    // from mcp-core's catalogue, BCP-47 narrowing, default:en fallback);
-    // anything the host application sets via `grammarResolverOptions`
-    // takes precedence.
-    builder.withGrammarResolver({
-        localeSource: () => process.env["MCP_BROKER_LOCALE"],
-        ...(options.grammarResolverOptions ?? {}),
-    });
-    // No reconnect policy → the McpServer does not attempt to reopen the loopback
-    // when WsTunnel.stop() closes it. Clean shutdown.
-    const server = builder.build();
-    await server.start();
-    return { server, clientTransport: clientEnd };
-}
-//# sourceMappingURL=broker.server.js.map

package/dist/broker/broker.server.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"broker.server.js","sourceRoot":"","sources":["../../src/broker/broker.server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACnF,OAAO,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAG3F;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAC;AAwC9C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACnC,OAAsB,EACtB,UAAoC,EAAE;IAKtC,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,iBAAiB,CAAC,UAAU,EAAE,CAAC;IAE9D,6EAA6E;IAC7E,4EAA4E;IAC5E,MAAM,OAAO,GAAG,IAAI,gBAAgB,EAAE;SACjC,QAAQ,CAAC,oBAAoB,CAAC;SAC9B,aAAa,CAAC,SAAS,CAAC;SACxB,eAAe,CAAC;QACb,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;YACf,eAAe,EAAE,YAAY;YAC7B,UAAU,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;SACvE,CAAC;KACL,CAAC;SACD,QAAQ,CAAC,IAAI,kBAAkB,CAAC,OAAO,CAAC,EAAE,IAAI,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC;IAErF,mEAAmE;IACnE,mDAAmD;IACnD,mEAAmE;IACnE,kEAAkE;IAClE,mEAAmE;IACnE,oEAAoE;IACpE,mDAAmD;IACnD,KAAK,MAAM,KAAK,IAAI,2BAA2B,EAAE,EAAE,CAAC;QAChD,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC3B,KAAK,MAAM,KAAK,IAAI,sBAAsB,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACnE,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAClD,CAAC;IACL,CAAC;IAED,kEAAkE;IAClE,qEAAqE;IACrE,qEAAqE;IACrE,kEAAkE;IAClE,oBAAoB;IACpB,OAAO,CAAC,mBAAmB,CAAC;QACxB,YAAY,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QACpD,GAAG,CAAC,OAAO,CAAC,sBAAsB,IAAI,EAAE,CAAC;KAC5C,CAAC,CAAC;IAEH,8EAA8E;IAC9E,kDAAkD;IAClD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAE/B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IAErB,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC;AAClD,CAAC"}

package/dist/broker/index.d.ts

@@ -1,9 +0,0 @@
-export { BrokerInfoBehavior } from "./behaviors/broker.behavior.info.js";
-export { BrokerProvidersBehavior } from "./behaviors/broker.behavior.providers.js";
-export { BrokerInfoAdapter, BROKER_INFO_URI } from "./adapters/broker.adapter.info.js";
-export { BrokerProvidersAdapter, PROVIDERS_URI, PROVIDER_URI_TEMPLATE } from "./adapters/broker.adapter.providers.js";
-export { startBrokerServer, BROKER_PROVIDER_NAME } from "./broker.server.js";
-export type { StartBrokerServerOptions } from "./broker.server.js";
-export { brokerBaselineGrammar, brokerBaselinePropertyDescription, brokerBaselineResourceDescription, brokerBaselineResourceName, brokerBaselineResourceTemplateDescription, brokerBaselineResourceTemplateName, brokerBaselineToolDescription, brokerGrammarKey, iterAvailableBrokerGrammars, iterBrokerGrammarsFrom, loadBrokerGrammar, parseBrokerGrammarStem, } from "./broker.grammars.js";
-export type { BrokerGrammarEntry, BrokerLocale, BrokerUserAgent } from "./broker.grammars.js";
-export type { BrokerContext, BrokerProviderInfo, BrokerProviderTransport } from "./broker.context.js";

package/dist/broker/index.js

@@ -1,7 +0,0 @@
-export { BrokerInfoBehavior } from "./behaviors/broker.behavior.info.js";
-export { BrokerProvidersBehavior } from "./behaviors/broker.behavior.providers.js";
-export { BrokerInfoAdapter, BROKER_INFO_URI } from "./adapters/broker.adapter.info.js";
-export { BrokerProvidersAdapter, PROVIDERS_URI, PROVIDER_URI_TEMPLATE } from "./adapters/broker.adapter.providers.js";
-export { startBrokerServer, BROKER_PROVIDER_NAME } from "./broker.server.js";
-export { brokerBaselineGrammar, brokerBaselinePropertyDescription, brokerBaselineResourceDescription, brokerBaselineResourceName, brokerBaselineResourceTemplateDescription, brokerBaselineResourceTemplateName, brokerBaselineToolDescription, brokerGrammarKey, iterAvailableBrokerGrammars, iterBrokerGrammarsFrom, loadBrokerGrammar, parseBrokerGrammarStem, } from "./broker.grammars.js";
-//# sourceMappingURL=index.js.map

package/dist/broker/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/broker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACvF,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AACtH,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE7E,OAAO,EACH,qBAAqB,EACrB,iCAAiC,EACjC,iCAAiC,EACjC,0BAA0B,EAC1B,yCAAyC,EACzC,kCAAkC,EAClC,6BAA6B,EAC7B,gBAAgB,EAChB,2BAA2B,EAC3B,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,GACzB,MAAM,sBAAsB,CAAC"}