@ts-pf/mcp 0.0.0-stage → 0.0.0

package/dist/schema.js

@@ -0,0 +1,172 @@
+import { toJsonSchema } from '@ts-pf/docs';
+const emptyObject = () => ({ type: 'object', properties: {} });
+const cache = new WeakMap();
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function branchesOf(schema) {
+    const branches = schema.anyOf ?? schema.oneOf;
+    return Array.isArray(branches) ? branches.filter(isObject) : undefined;
+}
+/**
+ * Inline local `$ref`s (`#/$defs/X`, `#/definitions/X`) so clients that do not
+ * resolve references still see the full shape. A recursive reference stays a
+ * `$ref` (its definitions are kept) and is reported.
+ */
+function inlineRefs(root) {
+    const defs = {
+        ...(isObject(root.definitions) ? root.definitions : {}),
+        ...(isObject(root.$defs) ? root.$defs : {}),
+    };
+    let recursive = false;
+    const visit = (node, stack) => {
+        if (Array.isArray(node))
+            return node.map((item) => visit(item, stack));
+        if (!isObject(node))
+            return node;
+        const ref = node.$ref;
+        if (typeof ref === 'string') {
+            const name = /^#\/(?:\$defs|definitions)\/(.+)$/.exec(ref)?.[1];
+            if (ref === '#' || (name !== undefined && stack.includes(name))) {
+                recursive = true;
+                return node;
+            }
+            if (name !== undefined && Object.hasOwn(defs, name)) {
+                const { $ref: _ref, ...rest } = node;
+                const resolved = visit(defs[name], [...stack, name]);
+                return Object.keys(rest).length > 0
+                    ? { ...resolved, ...visit(rest, stack) }
+                    : resolved;
+            }
+        }
+        const out = {};
+        for (const [key, value] of Object.entries(node)) {
+            if (key === '$schema' || key === '$defs' || key === 'definitions')
+                continue;
+            out[key] = visit(value, stack);
+        }
+        return out;
+    };
+    const schema = visit(root, []);
+    if (!recursive)
+        return { schema, issues: [] };
+    return {
+        schema: { ...schema, $defs: root.$defs ?? root.definitions },
+        issues: [
+            {
+                level: 'warn',
+                message: 'schema is recursive; references stay as $ref',
+            },
+        ],
+    };
+}
+/** JSON Schema of a contract / tool schema, inlined; memoized per schema object. */
+function convert(schema, io) {
+    const key = schema;
+    const hit = io === 'input' ? cache.get(key) : undefined;
+    if (hit)
+        return hit;
+    let result;
+    try {
+        result = inlineRefs(toJsonSchema(schema, { io }));
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        result = {
+            schema: emptyObject(),
+            issues: [{ level: 'error', message: `no JSON Schema: ${reason}` }],
+        };
+    }
+    if (io === 'input')
+        cache.set(key, result);
+    return result;
+}
+/** Top-level keys a model may send: object properties, or the union of a union root's branches. */
+export function inputKeys(schema) {
+    const branches = branchesOf(schema);
+    if (branches)
+        return [...new Set(branches.flatMap(inputKeys))];
+    return isObject(schema.properties) ? Object.keys(schema.properties) : [];
+}
+function withoutKeys(schema, keys, issues) {
+    const branches = branchesOf(schema);
+    if (branches) {
+        const which = schema.anyOf ? 'anyOf' : 'oneOf';
+        return {
+            ...schema,
+            [which]: branches.map((b) => withoutKeys(b, keys, issues)),
+        };
+    }
+    if (!isObject(schema.properties)) {
+        if (Array.isArray(schema.allOf)) {
+            issues.push({
+                level: 'error',
+                message: `allOf root: injected ${keys.join(', ')} cannot be removed; use .input(schema, map)`,
+            });
+        }
+        return schema;
+    }
+    const properties = { ...schema.properties };
+    for (const key of keys)
+        delete properties[key];
+    const out = { ...schema, properties };
+    if (Array.isArray(schema.required)) {
+        out.required = schema.required.filter((key) => !keys.includes(key));
+    }
+    return out;
+}
+/** MCP tool arguments are always an object, so the advertised root is `type: 'object'`. */
+function objectRoot(schema, issues) {
+    if (schema.type === 'object')
+        return schema;
+    if (branchesOf(schema) || Array.isArray(schema.allOf)) {
+        issues.push({
+            level: 'warn',
+            message: 'input root is a union / allOf; some clients only read top-level properties. Consider .input(schema, map)',
+        });
+        return { type: 'object', ...schema };
+    }
+    issues.push({
+        level: 'error',
+        message: `input root is not an object (${JSON.stringify(schema.type ?? 'any')}); the model cannot call it. Use .input(schema, map)`,
+    });
+    return emptyObject();
+}
+/** The JSON Schema of what the model sends: `.input()` schema, or the procedure input minus injected keys. */
+export function modelInputSchema(spec) {
+    const source = spec.input?.schema ?? spec.procedure?.['~pf'].input;
+    if (source === undefined)
+        return { schema: emptyObject(), issues: [] };
+    const base = convert(source, 'input');
+    const issues = [...base.issues];
+    const injected = Object.keys(spec.inject);
+    const schema = injected.length > 0
+        ? withoutKeys(base.schema, injected, issues)
+        : base.schema;
+    return { schema: objectRoot(schema, issues), issues };
+}
+/** Input keys of a procedure, for `all({ inject })` (each key goes only to tools that have it). */
+export function procedureInputKeys(spec) {
+    const source = spec.procedure?.['~pf'].input;
+    return source === undefined ? [] : inputKeys(convert(source, 'input').schema);
+}
+/** The advertised `outputSchema`: only for `.output(schema, map)` with an object root. */
+export function modelOutputSchema(spec) {
+    const source = spec.output?.schema;
+    if (source === undefined)
+        return { issues: [] };
+    const { schema, issues } = convert(source, 'output');
+    if (schema.type !== 'object') {
+        return {
+            issues: [
+                ...issues,
+                {
+                    level: 'warn',
+                    message: 'output schema root is not an object; outputSchema is not advertised',
+                },
+            ],
+        };
+    }
+    return { schema, issues };
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,YAAY,EAAE,MAAM,aAAa,CAAA;AAO3D,MAAM,WAAW,GAAG,GAAe,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAA;AAC1E,MAAM,KAAK,GAAG,IAAI,OAAO,EAAuB,CAAA;AAEhD,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC7E,CAAC;AAED,SAAS,UAAU,CAAC,MAAkB;IACpC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAA;IAC7C,OAAO,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AACxE,CAAC;AAED;;;;GAIG;AACH,SAAS,UAAU,CAAC,IAAgB;IAClC,MAAM,IAAI,GAAG;QACX,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;KACjB,CAAA;IAC5B,IAAI,SAAS,GAAG,KAAK,CAAA;IACrB,MAAM,KAAK,GAAG,CAAC,IAAa,EAAE,KAAwB,EAAW,EAAE;QACjE,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAA;QACtE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAA;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAA;QACrB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,mCAAmC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;YAC/D,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;gBAChE,SAAS,GAAG,IAAI,CAAA;gBAChB,OAAO,IAAI,CAAA;YACb,CAAC;YACD,IAAI,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;gBACpD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAA;gBACpC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC,CAAe,CAAA;gBAClE,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;oBACjC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAI,KAAK,CAAC,IAAI,EAAE,KAAK,CAAgB,EAAE;oBACxD,CAAC,CAAC,QAAQ,CAAA;YACd,CAAC;QACH,CAAC;QACD,MAAM,GAAG,GAAe,EAAE,CAAA;QAC1B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,aAAa;gBAC/D,SAAQ;YACV,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;QAChC,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC,CAAA;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,CAAe,CAAA;IAC5C,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;IAC7C,OAAO;QACL,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,WAAW,EAAE;QAC5D,MAAM,EAAE;YACN;gBACE,KAAK,EAAE,MAAM;gBACb,OAAO,EAAE,8CAA8C;aACxD;SACF;KACF,CAAA;AACH,CAAC;AAED,oFAAoF;AACpF,SAAS,OAAO,CAAC,MAAe,EAAE,EAAsB;IACtD,MAAM,GAAG,GAAG,MAAgB,CAAA;IAC5B,MAAM,GAAG,GAAG,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IACvD,IAAI,GAAG;QAAE,OAAO,GAAG,CAAA;IACnB,IAAI,MAAmB,CAAA;IACvB,IAAI,CAAC;QACH,MAAM,GAAG,UAAU,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAA;IACnD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACrE,MAAM,GAAG;YACP,MAAM,EAAE,WAAW,EAAE;YACrB,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,MAAM,EAAE,EAAE,CAAC;SACnE,CAAA;IACH,CAAC;IACD,IAAI,EAAE,KAAK,OAAO;QAAE,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;IAC1C,OAAO,MAAM,CAAA;AACf,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,SAAS,CAAC,MAAkB;IAC1C,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;IACnC,IAAI,QAAQ;QAAE,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;IAC9D,OAAO,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AAC1E,CAAC;AAED,SAAS,WAAW,CAClB,MAAkB,EAClB,IAAuB,EACvB,MAAqB;IAErB,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;IACnC,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAA;QAC9C,OAAO;YACL,GAAG,MAAM;YACT,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;SAC3D,CAAA;IACH,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK,EAAE,OAAO;gBACd,OAAO,EAAE,wBAAwB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,6CAA6C;aAC9F,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IACD,MAAM,UAAU,GAAG,EAAE,GAAG,MAAM,CAAC,UAAU,EAA6B,CAAA;IACtE,KAAK,MAAM,GAAG,IAAI,IAAI;QAAE,OAAO,UAAU,CAAC,GAAG,CAAC,CAAA;IAC9C,MAAM,GAAG,GAAe,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,CAAA;IACjD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,GAAG,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CACnC,CAAC,GAAY,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAa,CAAC,CAChD,CAAA;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,2FAA2F;AAC3F,SAAS,UAAU,CAAC,MAAkB,EAAE,MAAqB;IAC3D,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAA;IAC3C,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,MAAM;YACb,OAAO,EACL,0GAA0G;SAC7G,CAAC,CAAA;QACF,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAA;IACtC,CAAC;IACD,MAAM,CAAC,IAAI,CAAC;QACV,KAAK,EAAE,OAAO;QACd,OAAO,EAAE,gCAAgC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC,sDAAsD;KACpI,CAAC,CAAA;IACF,OAAO,WAAW,EAAE,CAAA;AACtB,CAAC;AAED,8GAA8G;AAC9G,MAAM,UAAU,gBAAgB,CAAC,IAAc;IAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,CAAA;IAClE,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;IACtE,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAA;IAC/B,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACzC,MAAM,MAAM,GACV,QAAQ,CAAC,MAAM,GAAG,CAAC;QACjB,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC;QAC5C,CAAC,CAAC,IAAI,CAAC,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;AACvD,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,kBAAkB,CAAC,IAAc;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,CAAA;IAC5C,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,CAAA;AAC/E,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,iBAAiB,CAAC,IAAc;IAI9C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,CAAA;IAClC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;IAC/C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IACpD,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO;YACL,MAAM,EAAE;gBACN,GAAG,MAAM;gBACT;oBACE,KAAK,EAAE,MAAM;oBACb,OAAO,EACL,qEAAqE;iBACxE;aACF;SACF,CAAA;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;AAC3B,CAAC"}

package/dist/sdk.d.ts

@@ -0,0 +1,31 @@
+import { type McpServerFactory } from '@modelcontextprotocol/server';
+import { type CallInterceptor, type ImplementedRouter } from '@ts-pf/server';
+import { type CallPipelineOptions } from './bind.js';
+import type { MaybePromise } from './infer.js';
+import type { McpCallInfo, McpTools } from './types.js';
+/** Server identity and listing options, for both forms. */
+export type McpFactoryOptions = {
+    name: string;
+    version: string;
+    instructions?: string;
+    /** `tools/list` cache hint (`cacheScope: 'private'`). Default 0. */
+    listTtlMs?: number;
+};
+/** `context` is required when the app carries a `$context` brand; optional for an unbranded tree. */
+type ContextOption<Ctx> = unknown extends Ctx ? {
+    context?: (info: McpCallInfo) => unknown;
+} : {
+    context: (info: McpCallInfo) => MaybePromise<Ctx>;
+};
+type AppFactoryOptions<Ctx> = McpFactoryOptions & CallPipelineOptions & {
+    interceptors?: readonly CallInterceptor[];
+} & ContextOption<Ctx>;
+/**
+ * A per-request `McpServer` factory for `createMcpHandler` / `serveStdio`.
+ * Pass bound `McpTools` (shaped), or an `app` to expose every procedure.
+ * A fresh server per request: one instance cannot serve overlapping requests.
+ */
+export declare function createMcpFactory(source: McpTools, options: McpFactoryOptions): McpServerFactory;
+export declare function createMcpFactory<T, Ctx>(source: ImplementedRouter<T, Ctx>, options: AppFactoryOptions<NoInfer<Ctx>>): McpServerFactory;
+export {};
+//# sourceMappingURL=sdk.d.ts.map

package/dist/sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EAEtB,MAAM,8BAA8B,CAAA;AAGrC,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EAEvB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAe,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAK9C,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAEvD,2DAA2D;AAC3D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,qGAAqG;AACrG,KAAK,aAAa,CAAC,GAAG,IAAI,OAAO,SAAS,GAAG,GACzC;IAAE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,OAAO,CAAA;CAAE,GAC5C;IAAE,OAAO,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,YAAY,CAAC,GAAG,CAAC,CAAA;CAAE,CAAA;AAEzD,KAAK,iBAAiB,CAAC,GAAG,IAAI,iBAAiB,GAC7C,mBAAmB,GAAG;IACpB,YAAY,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;CAC1C,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;AAwDxB;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,QAAQ,EAChB,OAAO,EAAE,iBAAiB,GACzB,gBAAgB,CAAA;AACnB,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,GAAG,EACrC,MAAM,EAAE,iBAAiB,CAAC,CAAC,EAAE,GAAG,CAAC,EACjC,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GACvC,gBAAgB,CAAA"}

package/dist/sdk.js

@@ -0,0 +1,87 @@
+import { McpServer, } from '@modelcontextprotocol/server';
+import { defined } from '@ts-pf/protocol';
+import { isImplementedProcedure, } from '@ts-pf/server';
+import { bindToolset } from './bind.js';
+import { appExecutor } from './executor.js';
+import { toolName } from './names.js';
+import { DEFAULT_MAX_RESULT_CHARS } from './result.js';
+import { procedureSpec } from './tool.js';
+import { isHidden } from './tool-meta.js';
+/** Advertise our JSON Schema, never re-validate: one validation pass, our messages. */
+function passthrough(schema) {
+    return {
+        '~standard': {
+            version: 1,
+            vendor: 'ts-pf',
+            validate: (value) => ({ value }),
+            jsonSchema: { input: () => schema, output: () => schema },
+        },
+    };
+}
+function isMcpTools(source) {
+    const s = source;
+    return typeof s.list === 'function' && typeof s.call === 'function';
+}
+/** One tool per implemented procedure, named by path; `docs({ hidden: true })` is skipped. */
+function appToolSpecs(app) {
+    const tools = {};
+    const visit = (node, path) => {
+        if (isImplementedProcedure(node)) {
+            const spec = procedureSpec(path.join('.'), node['~pf'].contract);
+            if (isHidden(spec))
+                return;
+            const name = toolName(spec.path);
+            if (Object.hasOwn(tools, name)) {
+                throw new Error(`createMcpFactory(): duplicate tool name "${name}"`);
+            }
+            tools[name] = spec;
+            return;
+        }
+        if (typeof node !== 'object' || node === null)
+            return;
+        for (const [key, child] of Object.entries(node)) {
+            if (key !== '~pf')
+                visit(child, [...path, key]);
+        }
+    };
+    visit(app, []);
+    return tools;
+}
+function appTools(app, options) {
+    return bindToolset({ contract: undefined, tools: appToolSpecs(app), hosts: {} }, {
+        executor: appExecutor(app, options.context, options.interceptors),
+        onError: options.onError,
+        maxResultChars: options.maxResultChars ?? DEFAULT_MAX_RESULT_CHARS,
+    });
+}
+export function createMcpFactory(source, options) {
+    const tools = isMcpTools(source) ? source : appTools(source, options);
+    return async ({ authInfo, requestInfo, era }) => {
+        const server = new McpServer({ name: options.name, version: options.version }, defined({
+            instructions: options.instructions,
+            cacheHints: {
+                'tools/list': {
+                    ttlMs: options.listTtlMs ?? 0,
+                    cacheScope: 'private',
+                },
+            },
+        }));
+        const base = defined({ authInfo, requestInfo, era });
+        for (const tool of await tools.list(base)) {
+            server.registerTool(tool.name, defined({
+                description: tool.description,
+                annotations: tool.annotations,
+                inputSchema: passthrough(tool.inputSchema),
+                outputSchema: tool.outputSchema && passthrough(tool.outputSchema),
+            }), (args, ctx) => tools.call(tool.name, args, defined({
+                ...base,
+                authInfo: ctx.http?.authInfo ?? authInfo,
+                requestInfo: ctx.http?.req ?? requestInfo,
+                signal: ctx.mcpReq.signal,
+                inputResponses: ctx.mcpReq.inputResponses,
+            })));
+        }
+        return server;
+    };
+}
+//# sourceMappingURL=sdk.js.map

package/dist/sdk.js.map

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

package/dist/search.d.ts

@@ -0,0 +1,13 @@
+export type SearchDocument = {
+    id: string;
+    text: string;
+};
+export interface SearchIndex {
+    /** Ids with a positive BM25 score, best first. */
+    search(query: string): string[];
+}
+/** Lower-case word tokens; splits `snake_case`, `camelCase`, and punctuation. */
+export declare function tokenize(text: string): string[];
+/** BM25 over small documents (name, description, tags, aliases). Built once per host bucket. */
+export declare function createSearchIndex(documents: readonly SearchDocument[]): SearchIndex;
+//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEzD,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAChC;AAKD,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAM/C;AAED,gGAAgG;AAChG,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,SAAS,cAAc,EAAE,GACnC,WAAW,CAsCb"}

package/dist/search.js

@@ -0,0 +1,52 @@
+const K1 = 1.2;
+const B = 0.75;
+/** Lower-case word tokens; splits `snake_case`, `camelCase`, and punctuation. */
+export function tokenize(text) {
+    return text
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter((token) => token.length > 0);
+}
+/** BM25 over small documents (name, description, tags, aliases). Built once per host bucket. */
+export function createSearchIndex(documents) {
+    const docs = documents.map((doc) => {
+        const terms = new Map();
+        const tokens = tokenize(doc.text);
+        for (const token of tokens)
+            terms.set(token, (terms.get(token) ?? 0) + 1);
+        return { id: doc.id, terms, length: tokens.length };
+    });
+    const avgLength = docs.reduce((sum, doc) => sum + doc.length, 0) / Math.max(docs.length, 1);
+    const docFreq = new Map();
+    for (const doc of docs) {
+        for (const term of doc.terms.keys()) {
+            docFreq.set(term, (docFreq.get(term) ?? 0) + 1);
+        }
+    }
+    const idf = (term) => {
+        const n = docFreq.get(term) ?? 0;
+        return Math.log(1 + (docs.length - n + 0.5) / (n + 0.5));
+    };
+    return {
+        search(query) {
+            const terms = [...new Set(tokenize(query))];
+            return docs
+                .map((doc) => {
+                let score = 0;
+                for (const term of terms) {
+                    const tf = doc.terms.get(term) ?? 0;
+                    if (tf === 0)
+                        continue;
+                    const norm = 1 - B + (B * doc.length) / (avgLength || 1);
+                    score += (idf(term) * tf * (K1 + 1)) / (tf + K1 * norm);
+                }
+                return { id: doc.id, score };
+            })
+                .filter((hit) => hit.score > 0)
+                .sort((a, b) => b.score - a.score)
+                .map((hit) => hit.id);
+        },
+    };
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

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

package/dist/tool-meta.d.ts

@@ -0,0 +1,14 @@
+import { type Effect } from './meta.js';
+import type { ToolSpec } from './tool.js';
+import type { McpToolAnnotations } from './types.js';
+/** `.effect()` → `mcp({ effect })`; `undefined` when neither classifies the tool. */
+export declare function declaredEffect(spec: ToolSpec): Effect | undefined;
+/** Unclassified tools count as `write`: they never claim to be harmless. */
+export declare function effectOf(spec: ToolSpec): Effect;
+/** `.describe()` → `mcp({ description })` → `docs().description` → `docs().summary`. */
+export declare function descriptionOf(spec: ToolSpec): string;
+export declare function tagsOf(spec: ToolSpec): readonly string[];
+export declare function aliasesOf(spec: ToolSpec): readonly string[];
+export declare function isHidden(spec: ToolSpec): boolean;
+export declare function annotationsFor(effect: Effect): McpToolAnnotations;
+//# sourceMappingURL=tool-meta.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-meta.d.ts","sourceRoot":"","sources":["../src/tool-meta.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,MAAM,EAAyB,MAAM,WAAW,CAAA;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAcpD,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAEjE;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAE/C;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CASpD;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,MAAM,EAAE,CAExD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,MAAM,EAAE,CAE3D;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEhD;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAGjE"}

package/dist/tool-meta.js

@@ -0,0 +1,44 @@
+import { getDocs } from '@ts-pf/docs';
+import { MCP_KEY } from './meta.js';
+function contractMeta(spec) {
+    return (spec.procedure?.['~pf'].meta ?? {});
+}
+function mcpMeta(spec) {
+    const value = contractMeta(spec)[MCP_KEY];
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        return undefined;
+    }
+    return value;
+}
+/** `.effect()` → `mcp({ effect })`; `undefined` when neither classifies the tool. */
+export function declaredEffect(spec) {
+    return spec.effect ?? mcpMeta(spec)?.effect;
+}
+/** Unclassified tools count as `write`: they never claim to be harmless. */
+export function effectOf(spec) {
+    return declaredEffect(spec) ?? 'write';
+}
+/** `.describe()` → `mcp({ description })` → `docs().description` → `docs().summary`. */
+export function descriptionOf(spec) {
+    const docs = getDocs(contractMeta(spec));
+    return (spec.description ??
+        mcpMeta(spec)?.description ??
+        docs?.description ??
+        docs?.summary ??
+        '');
+}
+export function tagsOf(spec) {
+    return getDocs(contractMeta(spec))?.tags ?? [];
+}
+export function aliasesOf(spec) {
+    return mcpMeta(spec)?.aliases ?? [];
+}
+export function isHidden(spec) {
+    return getDocs(contractMeta(spec))?.hidden === true;
+}
+export function annotationsFor(effect) {
+    if (effect === 'read')
+        return { readOnlyHint: true };
+    return { readOnlyHint: false, destructiveHint: effect === 'destructive' };
+}
+//# sourceMappingURL=tool-meta.js.map

package/dist/tool-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-meta.js","sourceRoot":"","sources":["../src/tool-meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AACrC,OAAO,EAAe,OAAO,EAAgB,MAAM,WAAW,CAAA;AAI9D,SAAS,YAAY,CAAC,IAAc;IAClC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAA;AACxE,CAAC;AAED,SAAS,OAAO,CAAC,IAAc;IAC7B,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAA;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,OAAO,KAAgB,CAAA;AACzB,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,cAAc,CAAC,IAAc;IAC3C,OAAO,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;AAC7C,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,QAAQ,CAAC,IAAc;IACrC,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,OAAO,CAAA;AACxC,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,aAAa,CAAC,IAAc;IAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAA;IACxC,OAAO,CACL,IAAI,CAAC,WAAW;QAChB,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW;QAC1B,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,OAAO;QACb,EAAE,CACH,CAAA;AACH,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,IAAc;IACnC,OAAO,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAA;AAChD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,IAAI,EAAE,CAAA;AACrC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAc;IACrC,OAAO,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;AACrD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,CAAA;IACpD,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,KAAK,aAAa,EAAE,CAAA;AAC3E,CAAC"}

package/dist/tool.d.ts

@@ -0,0 +1,102 @@
+import type { AnySchema, ContractClient, ContractProcedure, ErrorDef, InferErrorData, InferSchemaInput, InferSchemaOutput } from '@ts-pf/contract';
+import type { DistOmit, Err, FieldOf, In, KeysOfUnion, MaybePromise, Out } from './infer.js';
+import type { Effect } from './meta.js';
+import type { McpCallInfo } from './types.js';
+/** Type-only view of the required `'~tool'` brand. At runtime the key holds a `ToolSpec`. */
+export type ToolPhantom<Path extends string, Ctx, Model> = {
+    path: Path;
+    ctx: (context: Ctx) => void;
+    model: Model;
+};
+/** `never` context: a tool built for any context is assignable. */
+export type AnyTool<Ctx = never> = {
+    readonly '~tool': ToolPhantom<string, Ctx, unknown>;
+};
+export type MapperOpts<T, Ctx> = {
+    context: Ctx;
+    info: McpCallInfo;
+    /** A typed client on the same executor, for joins across procedures. */
+    call: ContractClient<T>;
+};
+export type InjectFn = (o: {
+    context: unknown;
+    info: McpCallInfo;
+}) => unknown;
+type RuntimeOpts = MapperOpts<unknown, unknown>;
+type Mapper = (value: unknown, o: RuntimeOpts) => unknown;
+export type ErrorText = (o: {
+    data: unknown;
+    message: string;
+    context: unknown;
+}) => string;
+/** Runtime description of one tool; what `'~tool'` holds. */
+export interface ToolSpec {
+    /** Procedure path (`user.find`); `''` for a `$tool` composite. */
+    readonly path: string;
+    readonly procedure?: ContractProcedure;
+    readonly description?: string;
+    readonly effect?: Effect;
+    readonly inject: Readonly<Record<string, InjectFn>>;
+    /** `.input(schema, map)`, or a composite's input schema (no `map`). */
+    readonly input?: {
+        schema: AnySchema;
+        map?: Mapper;
+    };
+    readonly output?: {
+        schema?: AnySchema;
+        map: Mapper;
+    };
+    readonly errors: Readonly<Record<string, ErrorText>>;
+    readonly examples: readonly unknown[];
+    /** `$tool` composites run this instead of a procedure. */
+    readonly run?: (o: RuntimeOpts & {
+        input: unknown;
+    }) => unknown;
+}
+export declare function toolSpec(tool: AnyTool): ToolSpec;
+export declare function isTool(value: unknown): value is AnyTool;
+type Mode = 'none' | 'inject' | 'input';
+export type BuilderState = {
+    model: unknown;
+    mode: Mode;
+};
+export interface ToolBuilder<T, P, Ctx, Path extends string, S extends BuilderState> {
+    readonly '~tool': ToolPhantom<Path, Ctx, S['model']>;
+    describe(text: string): ToolBuilder<T, P, Ctx, Path, S>;
+    /** Overrides `mcp({ effect })`. Unclassified tools are treated as `write`. */
+    effect(effect: Effect): ToolBuilder<T, P, Ctx, Path, S>;
+    /** Hide input keys from the model and fill them per call (tenant ids, forced safe defaults). */
+    inject: S['mode'] extends 'input' ? (error: '.inject() cannot be combined with .input(); inject inside the input map', ...rest: unknown[]) => never : [S['model']] extends [object] ? <K extends KeysOfUnion<S['model']>>(map: {
+        [Q in K]: (o: {
+            context: Ctx;
+            info: McpCallInfo;
+        }) => MaybePromise<FieldOf<S['model'], Q>>;
+    }) => ToolBuilder<T, P, Ctx, Path, {
+        model: DistOmit<S['model'], K>;
+        mode: 'inject';
+    }> : (error: '.inject() needs an object input') => never;
+    /** A new model-facing input; `map` must return the procedure input. */
+    input: S['mode'] extends 'none' ? <Sch extends AnySchema, A = InferSchemaOutput<Sch>>(schema: Sch, map: (args: A, o: MapperOpts<T, Ctx>) => MaybePromise<In<P>>) => ToolBuilder<T, P, Ctx, Path, {
+        model: InferSchemaInput<Sch>;
+        mode: 'input';
+    }> : (error: '.input() cannot be combined with .inject(); inject inside the input map', ...rest: unknown[]) => never;
+    /** Reshape the result. No `outputSchema` is advertised without a schema. */
+    output<R>(map: (out: Out<P>, o: MapperOpts<T, Ctx>) => MaybePromise<R>): ToolBuilder<T, P, Ctx, Path, S>;
+    /** Reshape the result and advertise `schema` as `outputSchema`; results are checked against it. */
+    output<Sch extends AnySchema, R extends InferSchemaInput<Sch>>(schema: Sch, map: (out: Out<P>, o: MapperOpts<T, Ctx>) => MaybePromise<R>): ToolBuilder<T, P, Ctx, Path, S>;
+    /** Rewrite declared errors into a next step for the model. */
+    errors(map: {
+        [K in keyof Err<P> & string]?: (o: {
+            data: Err<P>[K] extends infer D extends ErrorDef ? InferErrorData<D> : never;
+            message: string;
+            context: Ctx;
+        }) => string;
+    }): ToolBuilder<T, P, Ctx, Path, S>;
+    /** Appended to the description; returned by hosts at `detail: 'full'`. */
+    examples(list: readonly S['model'][]): ToolBuilder<T, P, Ctx, Path, S>;
+}
+/** Immutable builder: each method returns a new builder over a copied spec. */
+export declare function createToolBuilder(spec: ToolSpec): unknown;
+export declare function procedureSpec(path: string, procedure: ContractProcedure): ToolSpec;
+export {};
+//# sourceMappingURL=tool.d.ts.map

package/dist/tool.d.ts.map

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

package/dist/tool.js

@@ -0,0 +1,30 @@
+export function toolSpec(tool) {
+    return tool['~tool'];
+}
+export function isTool(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        typeof value['~tool'] === 'object');
+}
+/** Immutable builder: each method returns a new builder over a copied spec. */
+export function createToolBuilder(spec) {
+    const next = (patch) => createToolBuilder({ ...spec, ...patch });
+    return {
+        '~tool': spec,
+        describe: (description) => next({ description }),
+        effect: (effect) => next({ effect }),
+        inject: (map) => next({ inject: { ...spec.inject, ...map } }),
+        input: (schema, map) => next({ input: { schema, map } }),
+        output: (schemaOrMap, map) => next({
+            output: map
+                ? { schema: schemaOrMap, map }
+                : { map: schemaOrMap },
+        }),
+        errors: (errors) => next({ errors: { ...spec.errors, ...errors } }),
+        examples: (examples) => next({ examples }),
+    };
+}
+export function procedureSpec(path, procedure) {
+    return { path, procedure, inject: {}, errors: {}, examples: [] };
+}
+//# sourceMappingURL=tool.js.map

package/dist/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAmEA,MAAM,UAAU,QAAQ,CAAC,IAAa;IACpC,OAAO,IAAI,CAAC,OAAO,CAAwB,CAAA;AAC7C,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAQ,KAAiC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAChE,CAAA;AACH,CAAC;AA+ED,+EAA+E;AAC/E,MAAM,UAAU,iBAAiB,CAAC,IAAc;IAC9C,MAAM,IAAI,GAAG,CAAC,KAAwB,EAAE,EAAE,CACxC,iBAAiB,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC,CAAA;IAC1C,OAAO;QACL,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,CAAC,WAAmB,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC;QACxD,MAAM,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAC5C,MAAM,EAAE,CAAC,GAA6B,EAAE,EAAE,CACxC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,EAAE,EAAE,CAAC;QAC9C,KAAK,EAAE,CAAC,MAAiB,EAAE,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;QAC3E,MAAM,EAAE,CAAC,WAA+B,EAAE,GAAY,EAAE,EAAE,CACxD,IAAI,CAAC;YACH,MAAM,EAAE,GAAG;gBACT,CAAC,CAAC,EAAE,MAAM,EAAE,WAAwB,EAAE,GAAG,EAAE;gBAC3C,CAAC,CAAC,EAAE,GAAG,EAAE,WAAqB,EAAE;SACnC,CAAC;QACJ,MAAM,EAAE,CAAC,MAAiC,EAAE,EAAE,CAC5C,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC;QACjD,QAAQ,EAAE,CAAC,QAA4B,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC;KAC/D,CAAA;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,SAA4B;IAE5B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAA;AAClE,CAAC"}