@ts-pf/mcp 0.0.0-stage → 0.0.0

package/dist/call.d.ts

@@ -0,0 +1,12 @@
+import type { BoundTool } from './bound-tool.js';
+import { type McpOnError } from './error-text.js';
+import type { Executor } from './executor.js';
+import type { McpCallInfo, McpToolResult } from './types.js';
+export type CallOptions = {
+    readonly executor: Executor;
+    readonly onError: McpOnError | undefined;
+    readonly maxResultChars: number;
+};
+/** Run one tool: context, inject / input map, procedure, output map + check, then errors → next-step text. */
+export declare function callTool(tool: BoundTool, args: unknown, info: McpCallInfo, options: CallOptions): Promise<McpToolResult>;
+//# sourceMappingURL=call.d.ts.map

package/dist/call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call.d.ts","sourceRoot":"","sources":["../src/call.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAa,KAAK,UAAU,EAAe,MAAM,iBAAiB,CAAA;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAG7C,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE5D,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAChC,CAAA;AAqED,8GAA8G;AAC9G,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAqCxB"}

package/dist/call.js

@@ -0,0 +1,104 @@
+import { validateSchema } from '@ts-pf/contract';
+import { PFError } from '@ts-pf/protocol';
+import { errorText, reportError } from './error-text.js';
+import { errorResult, successResult } from './result.js';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+async function parse(schema, value) {
+    const result = await validateSchema(schema, value);
+    if (!result.success) {
+        throw new PFError({
+            code: 'VALIDATION',
+            message: 'Validation failed',
+            data: { issues: result.issues },
+        });
+    }
+    return result.value;
+}
+/** Model arguments → procedure input: `.input()` map, or the arguments plus injected keys. */
+async function procedureInput(spec, args, opts) {
+    if (spec.input?.map) {
+        return spec.input.map(await parse(spec.input.schema, args), opts);
+    }
+    if (spec.procedure?.['~pf'].input === undefined)
+        return undefined;
+    const keys = Object.keys(spec.inject);
+    if (keys.length === 0)
+        return args ?? {};
+    // Injected values always win over anything the model sent under that key.
+    const input = isRecord(args) ? { ...args } : {};
+    for (const key of keys) {
+        input[key] = await spec.inject[key]?.({
+            context: opts.context,
+            info: opts.info,
+        });
+    }
+    return input;
+}
+async function execute(tool, args, opts, executor) {
+    const { spec } = tool;
+    if (spec.run) {
+        const input = spec.input ? await parse(spec.input.schema, args) : args;
+        return spec.run({ ...opts, input });
+    }
+    const input = await procedureInput(spec, args, opts);
+    const output = await executor.run(spec.path, input, opts.context, opts.info);
+    if (!spec.output)
+        return output;
+    const mapped = await spec.output.map(output, opts);
+    if (!spec.output.schema)
+        return mapped;
+    const result = await validateSchema(spec.output.schema, mapped);
+    if (!result.success) {
+        // A server bug: the model gets INTERNAL; `cause` (the issues) is for the log only.
+        throw new PFError({
+            code: 'INTERNAL',
+            message: 'Internal server error',
+            cause: result.issues,
+        });
+    }
+    return result.value;
+}
+/** Run one tool: context, inject / input map, procedure, output map + check, then errors → next-step text. */
+export async function callTool(tool, args, info, options) {
+    const callInfo = {
+        ...info,
+        tool: { name: tool.name, path: tool.spec.path },
+    };
+    let context;
+    try {
+        context = await options.executor.context(callInfo);
+        const opts = {
+            context,
+            info: callInfo,
+            call: options.executor.client(context, callInfo),
+        };
+        const value = await execute(tool, args, opts, options.executor);
+        return successResult(value, options.maxResultChars, tool.structured);
+    }
+    catch (error) {
+        let reported = error;
+        let text;
+        try {
+            text = errorText(error, {
+                name: tool.name,
+                schema: tool.inputSchema,
+                errors: tool.spec.errors,
+                context,
+            });
+        }
+        catch (mapperError) {
+            reported = mapperError;
+            text = errorText(mapperError, {
+                name: tool.name,
+                schema: tool.inputSchema,
+                errors: {},
+                context,
+            });
+        }
+        reportError(reported, callInfo, options.onError);
+        return errorResult(text, options.maxResultChars);
+    }
+}
+//# sourceMappingURL=call.js.map

package/dist/call.js.map

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

package/dist/composite.d.ts

@@ -0,0 +1,17 @@
+import type { AnySchema, InferSchemaInput, InferSchemaOutput } from '@ts-pf/contract';
+import type { Effect } from './meta.js';
+import type { MapperOpts, ToolPhantom } from './tool.js';
+export type CompositeToolDef<T, Ctx, Sch extends AnySchema> = {
+    description: string;
+    effect: Effect;
+    input: Sch;
+    run: (o: MapperOpts<T, Ctx> & {
+        input: InferSchemaOutput<Sch>;
+    }) => unknown;
+};
+/** An N→1 tool: no procedure path, so `$coverage` never counts it. */
+export type CompositeTool<Ctx, Model> = {
+    readonly '~tool': ToolPhantom<never, Ctx, Model>;
+};
+export declare function createCompositeTool<T, Ctx, Sch extends AnySchema>(def: CompositeToolDef<T, Ctx, Sch>): CompositeTool<Ctx, InferSchemaInput<Sch>>;
+//# sourceMappingURL=composite.d.ts.map

package/dist/composite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite.d.ts","sourceRoot":"","sources":["../src/composite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAY,MAAM,WAAW,CAAA;AAElE,MAAM,MAAM,gBAAgB,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,SAAS,SAAS,IAAI;IAC5D,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,GAAG,CAAA;IACV,GAAG,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG;QAAE,KAAK,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAA;KAAE,KAAK,OAAO,CAAA;CAC5E,CAAA;AAED,sEAAsE;AACtE,MAAM,MAAM,aAAa,CAAC,GAAG,EAAE,KAAK,IAAI;IACtC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;CACjD,CAAA;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,SAAS,SAAS,EAC/D,GAAG,EAAE,gBAAgB,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GACjC,aAAa,CAAC,GAAG,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAY3C"}

package/dist/composite.js

@@ -0,0 +1,14 @@
+export function createCompositeTool(def) {
+    const spec = {
+        path: '',
+        description: def.description,
+        effect: def.effect,
+        inject: {},
+        input: { schema: def.input },
+        errors: {},
+        examples: [],
+        run: def.run,
+    };
+    return { '~tool': spec };
+}
+//# sourceMappingURL=composite.js.map

package/dist/composite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite.js","sourceRoot":"","sources":["../src/composite.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,mBAAmB,CACjC,GAAkC;IAElC,MAAM,IAAI,GAAa;QACrB,IAAI,EAAE,EAAE;QACR,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,MAAM,EAAE,EAAE;QACV,KAAK,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,KAAK,EAAE;QAC5B,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE,EAAE;QACZ,GAAG,EAAE,GAAG,CAAC,GAAmC;KAC7C,CAAA;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAW,CAAA;AACnC,CAAC"}

package/dist/coverage.d.ts

@@ -0,0 +1,11 @@
+import type { ExcludedPath } from './all.js';
+import type { ProcPaths } from './infer.js';
+import { type AnyToolset, type Toolset } from './toolset.js';
+type Uncovered<T, S, X> = Exclude<ProcPaths<T>, (S extends readonly Toolset<unknown, never, infer P>[] ? P : never) | ExcludedPath<X>>;
+export type CoverageCheck<T, S, X> = [Uncovered<T, S, X>] extends [never] ? unknown : {
+    uncovered: `"${Uncovered<T, S, X>}" is not exposed by any toolset nor excluded`;
+};
+/** Paths no toolset exposes (flat or through a host) and no exclusion names. `docs({ hidden: true })` counts as decided. */
+export declare function uncoveredPaths(contract: unknown, toolsets: readonly AnyToolset[], exclude: readonly unknown[]): string[];
+export {};
+//# sourceMappingURL=coverage.d.ts.map

package/dist/coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage.d.ts","sourceRoot":"","sources":["../src/coverage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAI3C,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,OAAO,EAAe,MAAM,cAAc,CAAA;AAEzE,KAAK,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,OAAO,CAC/B,SAAS,CAAC,CAAC,CAAC,EACV,CAAC,CAAC,SAAS,SAAS,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,GACnE,YAAY,CAAC,CAAC,CAAC,CAClB,CAAA;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GACrE,OAAO,GACP;IACE,SAAS,EAAE,IAAI,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,8CAA8C,CAAA;CAChF,CAAA;AAEL,4HAA4H;AAC5H,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,SAAS,UAAU,EAAE,EAC/B,OAAO,EAAE,SAAS,OAAO,EAAE,GAC1B,MAAM,EAAE,CA4BV"}

package/dist/coverage.js

@@ -0,0 +1,35 @@
+import { walkContract } from '@ts-pf/docs';
+import { nodeInfo } from './node.js';
+import { isTool, procedureSpec, toolSpec } from './tool.js';
+import { isHidden } from './tool-meta.js';
+import { toolsetSpec } from './toolset.js';
+/** Paths no toolset exposes (flat or through a host) and no exclusion names. `docs({ hidden: true })` counts as decided. */
+export function uncoveredPaths(contract, toolsets, exclude) {
+    const covered = new Set();
+    for (const toolset of toolsets) {
+        const spec = toolsetSpec(toolset);
+        for (const tool of Object.values(spec.tools))
+            covered.add(tool.path);
+        for (const host of Object.values(spec.hosts)) {
+            for (const tool of Object.values(host.tools))
+                covered.add(tool.path);
+        }
+    }
+    const prefixes = [];
+    for (const value of exclude) {
+        if (isTool(value))
+            covered.add(toolSpec(value).path);
+        else {
+            const info = nodeInfo(value);
+            if (!info)
+                throw new TypeError('$coverage() exclude takes tools or nodes');
+            prefixes.push(info.path.join('.'));
+        }
+    }
+    return walkContract(contract)
+        .filter((entry) => !isHidden(procedureSpec('', entry.procedure)))
+        .map((entry) => entry.path.join('.'))
+        .filter((path) => !covered.has(path) &&
+        !prefixes.some((p) => p === '' || path === p || path.startsWith(`${p}.`)));
+}
+//# sourceMappingURL=coverage.js.map

package/dist/coverage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage.js","sourceRoot":"","sources":["../src/coverage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG1C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAiC,WAAW,EAAE,MAAM,cAAc,CAAA;AAczE,4HAA4H;AAC5H,MAAM,UAAU,cAAc,CAC5B,QAAiB,EACjB,QAA+B,EAC/B,OAA2B;IAE3B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAA;IACjC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA;QACjC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACpE,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACtE,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,GAAa,EAAE,CAAA;IAC7B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,MAAM,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAA;aAC/C,CAAC;YACJ,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;YAC5B,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,SAAS,CAAC,0CAA0C,CAAC,CAAA;YAC1E,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;QACpC,CAAC;IACH,CAAC;IACD,OAAO,YAAY,CAAC,QAAQ,CAAC;SAC1B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;SAChE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;SACpC,MAAM,CACL,CAAC,IAAI,EAAE,EAAE,CACP,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QAClB,CAAC,QAAQ,CAAC,IAAI,CACZ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAC1D,CACJ,CAAA;AACL,CAAC"}

package/dist/error-text.d.ts

@@ -0,0 +1,25 @@
+import type { ValidationIssue } from '@ts-pf/contract';
+import type { JsonSchema } from '@ts-pf/docs';
+import type { ErrorText } from './tool.js';
+import type { McpCallInfo } from './types.js';
+/** Side-effect only; replaces the default `console.error`, like `FetchHandler`'s `onError`. */
+export type McpOnError = (error: unknown, info: McpCallInfo) => void;
+/** The issues plus the expected schema, so the model can repair the call in one turn. */
+export declare function invalidInputText(name: string, issues: readonly ValidationIssue[], schema: JsonSchema): string;
+type ErrorTextOptions = {
+    name: string;
+    schema: JsonSchema;
+    errors: Readonly<Record<string, ErrorText>>;
+    context: unknown;
+};
+/**
+ * Model-facing text for a thrown value: invalid input → issues + schema; a
+ * declared code with a `.errors()` mapper → its next-step text; any other
+ * `PFError` → its code and message; anything else → `toWireError` (no leak).
+ * A throwing mapper propagates, so the caller reports it as unknown.
+ */
+export declare function errorText(error: unknown, options: ErrorTextOptions): string;
+/** `onError` when given; otherwise log unknown throws and `INTERNAL` `PFError`s, as `FetchHandler` does. */
+export declare function reportError(error: unknown, info: McpCallInfo, onError: McpOnError | undefined): void;
+export {};
+//# sourceMappingURL=error-text.d.ts.map

package/dist/error-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-text.d.ts","sourceRoot":"","sources":["../src/error-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,+FAA+F;AAC/F,MAAM,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,KAAK,IAAI,CAAA;AAEpE,yFAAyF;AACzF,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,MAAM,EAAE,UAAU,GACjB,MAAM,CASR;AAQD,KAAK,gBAAgB,GAAG;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,UAAU,CAAA;IAClB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAA;IAC3C,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAkB3E;AAED,4GAA4G;AAC5G,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,UAAU,GAAG,SAAS,GAC9B,IAAI,CAWN"}

package/dist/error-text.js

@@ -0,0 +1,56 @@
+import { isPFError, toWireError } from '@ts-pf/protocol';
+/** The issues plus the expected schema, so the model can repair the call in one turn. */
+export function invalidInputText(name, issues, schema) {
+    const list = issues
+        .map((issue) => issue.path.length > 0
+        ? `${issue.path.join('.')}: ${issue.message}`
+        : issue.message)
+        .join('; ');
+    return `Invalid input for ${name}: ${list}\nExpected schema: ${JSON.stringify(schema)}`;
+}
+function validationIssues(error) {
+    if (!isPFError(error) || error.code !== 'VALIDATION')
+        return undefined;
+    const issues = error.data?.issues;
+    return Array.isArray(issues) ? issues : undefined;
+}
+/**
+ * Model-facing text for a thrown value: invalid input → issues + schema; a
+ * declared code with a `.errors()` mapper → its next-step text; any other
+ * `PFError` → its code and message; anything else → `toWireError` (no leak).
+ * A throwing mapper propagates, so the caller reports it as unknown.
+ */
+export function errorText(error, options) {
+    const issues = validationIssues(error);
+    if (issues)
+        return invalidInputText(options.name, issues, options.schema);
+    if (isPFError(error) && error.code !== 'INTERNAL') {
+        const mapper = options.errors[error.code];
+        if (mapper) {
+            return mapper({
+                data: error.data,
+                message: error.message,
+                context: options.context,
+            });
+        }
+        const data = error.data === undefined ? '' : `\n${JSON.stringify(error.data)}`;
+        return `${error.code}: ${error.message}${data}`;
+    }
+    const wire = toWireError(error);
+    return `${wire.code}: ${wire.message}`;
+}
+/** `onError` when given; otherwise log unknown throws and `INTERNAL` `PFError`s, as `FetchHandler` does. */
+export function reportError(error, info, onError) {
+    if (onError) {
+        onError(error, info);
+        return;
+    }
+    const where = `"${info.tool?.name ?? '?'}"`;
+    if (!isPFError(error)) {
+        console.error(`[ts-pf/mcp] Unhandled error in ${where}:`, error);
+    }
+    else if (error.code === 'INTERNAL') {
+        console.error(`[ts-pf/mcp] INTERNAL error in ${where}:`, error);
+    }
+}
+//# sourceMappingURL=error-text.js.map

package/dist/error-text.js.map

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

package/dist/executor.d.ts

@@ -0,0 +1,19 @@
+import type { ContractClient } from '@ts-pf/contract';
+import { type CallInterceptor, type ImplementedRouter } from '@ts-pf/server';
+import type { MaybePromise } from './infer.js';
+import type { McpCallInfo } from './types.js';
+/** Where tools run: the contract defines them, an executor only runs them. */
+export interface Executor {
+    context(info: McpCallInfo): Promise<unknown>;
+    run(path: string, input: unknown, context: unknown, info: McpCallInfo): Promise<unknown>;
+    /** The typed `call` client mappers get, on the same executor. */
+    client(context: unknown, info: McpCallInfo): ContractClient<unknown>;
+}
+/** In-process: `lookupProcedure` + `runProcedure`, so middleware, auth, and interceptors all run. */
+export declare function appExecutor(app: ImplementedRouter, context: ((info: McpCallInfo) => MaybePromise<unknown>) | undefined, interceptors: readonly CallInterceptor[] | undefined): Executor;
+type AnyClient = ContractClient<unknown>;
+export type ClientSource<C> = C | ((info: McpCallInfo) => C);
+/** Remote: calls a typed client, which may be built per caller (a gateway calling upstream as the user). */
+export declare function clientExecutor(source: ClientSource<AnyClient>, context: ((info: McpCallInfo) => MaybePromise<unknown>) | undefined): Executor;
+export {};
+//# sourceMappingURL=executor.d.ts.map

package/dist/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD,OAAO,EACL,KAAK,eAAe,EAEpB,KAAK,iBAAiB,EAGvB,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,8EAA8E;AAC9E,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC5C,GAAG,CACD,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,OAAO,CAAC,CAAA;IACnB,iEAAiE;IACjE,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;CACrE;AAED,qGAAqG;AACrG,wBAAgB,WAAW,CACzB,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,KAAK,YAAY,CAAC,OAAO,CAAC,CAAC,GAAG,SAAS,EACnE,YAAY,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,GACnD,QAAQ,CAsBV;AAED,KAAK,SAAS,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;AACxC,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,WAAW,KAAK,CAAC,CAAC,CAAA;AA4B5D,4GAA4G;AAC5G,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,CAAC,SAAS,CAAC,EAC/B,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,KAAK,YAAY,CAAC,OAAO,CAAC,CAAC,GAAG,SAAS,GAClE,QAAQ,CASV"}

package/dist/executor.js

@@ -0,0 +1,49 @@
+import { defined } from '@ts-pf/protocol';
+import { createLocalClient, lookupProcedure, runProcedure, } from '@ts-pf/server';
+/** In-process: `lookupProcedure` + `runProcedure`, so middleware, auth, and interceptors all run. */
+export function appExecutor(app, context, interceptors) {
+    const chain = interceptors && interceptors.length > 0 ? interceptors : undefined;
+    return {
+        context: async (info) => context?.(info),
+        async run(path, input, ctx, info) {
+            const procedure = lookupProcedure(app, path.split('.'));
+            if (!procedure) {
+                throw new Error(`No procedure at "${path}" in the bound app`);
+            }
+            return runProcedure(procedure, input, ctx, defined({ signal: info.signal, interceptors: chain }));
+        },
+        client: (ctx) => chain
+            ? createLocalClient(app, { context: ctx, interceptors: chain })
+            : createLocalClient(app, { context: ctx }),
+    };
+}
+function procedureAt(client, path) {
+    let node = client;
+    for (const segment of path.split('.')) {
+        node = node?.[segment];
+    }
+    if (typeof node !== 'function') {
+        throw new Error(`No procedure at "${path}" on the bound client`);
+    }
+    return node;
+}
+/**
+ * `createClient()` returns a callable proxy, so `typeof` cannot tell it from a
+ * per-caller `(info) => client`. A client answers every key with a callable
+ * child; a plain factory function has no such key.
+ */
+function isClientFactory(source) {
+    return (typeof source === 'function' &&
+        typeof source['~ts-pf-mcp'] !==
+            'function');
+}
+/** Remote: calls a typed client, which may be built per caller (a gateway calling upstream as the user). */
+export function clientExecutor(source, context) {
+    const resolve = (info) => isClientFactory(source) ? source(info) : source;
+    return {
+        context: async (info) => (context ? context(info) : {}),
+        run: async (path, input, _ctx, info) => procedureAt(resolve(info), path)(input, defined({ signal: info.signal })),
+        client: (_ctx, info) => resolve(info),
+    };
+}
+//# sourceMappingURL=executor.js.map

package/dist/executor.js.map

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

package/dist/host.d.ts

@@ -0,0 +1,13 @@
+import type { BoundTool } from './bound-tool.js';
+import type { HostSpec } from './toolset.js';
+import type { McpCallInfo, McpToolDefinition, McpToolResult } from './types.js';
+/** A listed MCP tool and how to run it. */
+export type ToolEntry = {
+    readonly definition: McpToolDefinition;
+    invoke(args: unknown, info: McpCallInfo): Promise<McpToolResult>;
+};
+type Invoke = (tool: BoundTool, args: unknown, info: McpCallInfo) => Promise<McpToolResult>;
+/** The `get_*_capabilities` / `call_*_capability` pairs of one host; empty buckets list nothing. */
+export declare function hostEntries(key: string, host: HostSpec, tools: readonly BoundTool[], invoke: Invoke, maxChars: number): ToolEntry[];
+export {};
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAWhD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,KAAK,EACV,WAAW,EAEX,iBAAiB,EACjB,aAAa,EACd,MAAM,YAAY,CAAA;AAEnB,2CAA2C;AAC3C,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAA;IACtC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;CACjE,CAAA;AAED,KAAK,MAAM,GAAG,CACZ,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,WAAW,KACd,OAAO,CAAC,aAAa,CAAC,CAAA;AAqP3B,oGAAoG;AACpG,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,SAAS,SAAS,EAAE,EAC3B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,SAAS,EAAE,CAoBb"}