@ontrails/mcp 1.0.0-beta.0

package/.turbo/turbo-build.log

@@ -0,0 +1 @@
+$ tsc -b

package/.turbo/turbo-lint.log

@@ -0,0 +1,3 @@
+$ oxlint ./src
+Found 0 warnings and 0 errors.
+Finished in 103ms on 12 files with 93 rules using 24 threads.

package/.turbo/turbo-typecheck.log

@@ -0,0 +1 @@
+$ tsc --noEmit

package/CHANGELOG.md

@@ -0,0 +1,20 @@
+# @ontrails/mcp
+
+## 1.0.0-beta.0
+
+### Minor Changes
+
+- Initial v1 beta release of the Trails framework.
+
+  - **@ontrails/core** — Result type, error taxonomy, trail/hike/event/topo, validateTopo, validateInput/Output, deriveFields, patterns, redaction, branded types, resilience
+  - **@ontrails/cli** — CLI surface adapter, Commander integration, flag derivation, layers
+  - **@ontrails/mcp** — MCP surface adapter, tool generation, annotations, progress bridge
+  - **@ontrails/logging** — Structured logging, sinks, formatters, LogTape adapter
+  - **@ontrails/testing** — testAll, testExamples, testTrail, testHike, testContracts, testDetours, surface harnesses
+  - **@ontrails/warden** — AST-based code convention rules via oxc-parser, drift detection, CI formatters
+  - **@ontrails/schema** — Surface map generation, hashing, semantic diffing
+
+### Patch Changes
+
+- Updated dependencies
+  - @ontrails/core@1.0.0-beta.0

package/README.md

@@ -0,0 +1,161 @@
+# @ontrails/mcp
+
+MCP surface adapter for Trails. Generates MCP tools from trail definitions with auto-derived annotations, progress bridging, and a single `blaze()` call to start a server.
+
+## Installation
+
+```bash
+bun add @ontrails/mcp
+```
+
+## Quick Start
+
+```typescript
+import { trail, topo, Result } from '@ontrails/core';
+import { blaze } from '@ontrails/mcp';
+import { z } from 'zod';
+
+const greet = trail('greet', {
+  input: z.object({ name: z.string().describe('Who to greet') }),
+  readOnly: true,
+  implementation: (input) => Result.ok(`Hello, ${input.name}!`),
+});
+
+const app = topo('myapp', { greet });
+await blaze(app);
+```
+
+This starts an MCP server over stdio with a `myapp_greet` tool. The tool has `readOnlyHint: true` and a JSON Schema input derived from the Zod schema.
+
+Pure trails can return `Result` directly. The MCP surface still executes the normalized awaitable implementation shape under the hood.
+
+## API Overview
+
+### `blaze(app, options?)`
+
+Start an MCP server with all trails registered as tools.
+
+```typescript
+await blaze(app, {
+  serverInfo: { name: 'myapp', version: '1.0.0' },
+  transport: 'stdio',
+  includeTrails: ['entity.show', 'search'],
+  excludeTrails: ['internal.debug'],
+  layers: [myAuthLayer],
+  createContext: () => createTrailContext({ logger: myLogger }),
+});
+```
+
+### `buildMcpTools(app, options?)`
+
+Build tool definitions without starting a server. For advanced use cases where you manage the MCP server instance directly.
+
+```typescript
+import { buildMcpTools } from '@ontrails/mcp';
+
+const tools = buildMcpTools(app, {
+  includeTrails: ['entity.show', 'search'],
+});
+
+for (const tool of tools) {
+  server.registerTool(tool.name, tool.handler, {
+    inputSchema: tool.inputSchema,
+    annotations: tool.annotations,
+  });
+}
+```
+
+### Tool Name Derivation
+
+Trail IDs map to MCP tool names with the app name prefix:
+
+| App name   | Trail ID       | Tool name               |
+| ---------- | -------------- | ----------------------- |
+| `myapp`    | `entity.show`  | `myapp_entity_show`     |
+| `myapp`    | `search`       | `myapp_search`          |
+| `dispatch` | `patch.search` | `dispatch_patch_search` |
+
+Rules: dots become underscores, hyphens become underscores, everything lowercase. Names match MCP convention `[a-z0-9_]+`.
+
+```typescript
+import { deriveToolName } from '@ontrails/mcp';
+deriveToolName('myapp', 'entity.show'); // "myapp_entity_show"
+```
+
+### Annotation Auto-Generation
+
+Trail markers map directly to MCP tool annotations:
+
+| Trail field | MCP annotation | Effect |
+| --- | --- | --- |
+| `readOnly: true` | `readOnlyHint: true` | Tool does not modify state |
+| `destructive: true` | `destructiveHint: true` | Tool has destructive side effects |
+| `idempotent: true` | `idempotentHint: true` | Repeated calls are safe |
+| `description` | `title` | Human-readable tool title |
+
+```typescript
+import { deriveAnnotations } from '@ontrails/mcp';
+deriveAnnotations(showTrail); // { readOnlyHint: true, title: "Show entity details" }
+```
+
+Trails without markers produce empty annotations (MCP SDK defaults apply).
+
+### Progress Bridge
+
+Trail implementations report progress via `ctx.progress`. On MCP, these bridge to `notifications/progress`:
+
+```typescript
+const importTrail = trail('data.import', {
+  implementation: async (input, ctx) => {
+    for (let i = 0; i < items.length; i++) {
+      await processItem(items[i]);
+      ctx.progress?.({ type: 'progress', current: i + 1, total: items.length });
+    }
+    return Result.ok({ imported: items.length });
+  },
+});
+```
+
+Progress bridging activates only when the MCP client includes a `progressToken` in the tool call. Otherwise, `ctx.progress` calls are silently ignored.
+
+### Result Mapping
+
+| Trail Result | MCP Response |
+| --- | --- |
+| `Result.ok(value)` | `{ content: [{ type: "text", text: JSON.stringify(value) }] }` |
+| `Result.err(error)` | `{ content: [{ type: "text", text: error.message }], isError: true }` |
+| `BlobRef` with image MIME type | `{ content: [{ type: "image", data: "<base64>", mimeType: "..." }] }` |
+
+### Trail Filtering
+
+```typescript
+// Whitelist
+await blaze(app, { includeTrails: ['entity.show', 'entity.add', 'search'] });
+
+// Blacklist
+await blaze(app, { excludeTrails: ['internal.debug', 'admin.reset'] });
+```
+
+`includeTrails` takes precedence over `excludeTrails`.
+
+### AbortSignal Propagation
+
+The MCP client's abort signal propagates to `TrailContext.signal`. If the client cancels a tool call, the implementation's signal is aborted.
+
+## Exports
+
+```typescript
+import {
+  blaze,
+  buildMcpTools,
+  deriveToolName,
+  deriveAnnotations,
+  createMcpProgressCallback,
+  connectStdio,
+} from '@ontrails/mcp';
+```
+
+## Further Reading
+
+- [MCP Surface Guide](../../docs/surfaces/mcp.md)
+- [Getting Started](../../docs/getting-started.md)

package/dist/annotations.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Derive MCP tool annotations from trail spec markers.
+ */
+import type { Trail } from '@ontrails/core';
+export interface McpAnnotations {
+    readonly readOnlyHint?: boolean | undefined;
+    readonly destructiveHint?: boolean | undefined;
+    readonly idempotentHint?: boolean | undefined;
+    readonly openWorldHint?: boolean | undefined;
+    readonly title?: string | undefined;
+}
+/**
+ * Map trail spec fields to MCP tool annotations.
+ *
+ * Only sets hints that are explicitly declared on the trail.
+ * Omitted hints let the MCP SDK use its defaults.
+ */
+export declare const deriveAnnotations: (trail: Pick<Trail<unknown, unknown>, "readOnly" | "destructive" | "idempotent" | "description">) => McpAnnotations;
+//# sourceMappingURL=annotations.d.ts.map

package/dist/annotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../src/annotations.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAM5C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAMD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAC5B,OAAO,IAAI,CACT,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,EACvB,UAAU,GAAG,aAAa,GAAG,YAAY,GAAG,aAAa,CAC1D,KACA,cAiBF,CAAC"}

package/dist/annotations.js

@@ -0,0 +1,29 @@
+/**
+ * Derive MCP tool annotations from trail spec markers.
+ */
+// ---------------------------------------------------------------------------
+// Derivation
+// ---------------------------------------------------------------------------
+/**
+ * Map trail spec fields to MCP tool annotations.
+ *
+ * Only sets hints that are explicitly declared on the trail.
+ * Omitted hints let the MCP SDK use its defaults.
+ */
+export const deriveAnnotations = (trail) => {
+    const annotations = {};
+    if (trail.readOnly === true) {
+        annotations['readOnlyHint'] = true;
+    }
+    if (trail.destructive === true) {
+        annotations['destructiveHint'] = true;
+    }
+    if (trail.idempotent === true) {
+        annotations['idempotentHint'] = true;
+    }
+    if (trail.description !== undefined) {
+        annotations['title'] = trail.description;
+    }
+    return annotations;
+};
+//# sourceMappingURL=annotations.js.map

package/dist/annotations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.js","sourceRoot":"","sources":["../src/annotations.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgBH,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,KAGC,EACe,EAAE;IAClB,MAAM,WAAW,GAA4B,EAAE,CAAC;IAEhD,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC5B,WAAW,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;IACrC,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QAC/B,WAAW,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC;IACxC,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;QAC9B,WAAW,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;IACvC,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACpC,WAAW,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC;IAC3C,CAAC;IAED,OAAO,WAA6B,CAAC;AACvC,CAAC,CAAC"}

package/dist/blaze.d.ts

@@ -0,0 +1,36 @@
+/**
+ * blaze() -- the one-liner MCP server launcher.
+ *
+ * Three lines to expose trails as MCP tools:
+ *
+ * ```ts
+ * const app = topo("myapp", entity);
+ * await blaze(app);
+ * ```
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { Layer, Topo, TrailContext } from '@ontrails/core';
+import type { McpToolDefinition } from './build.js';
+export interface BlazeMcpOptions {
+    readonly createContext?: (() => TrailContext | Promise<TrailContext>) | undefined;
+    readonly excludeTrails?: readonly string[] | undefined;
+    readonly includeTrails?: readonly string[] | undefined;
+    readonly layers?: readonly Layer[] | undefined;
+    readonly serverInfo?: {
+        readonly name?: string | undefined;
+        readonly version?: string | undefined;
+    } | undefined;
+    readonly transport?: 'stdio' | undefined;
+}
+/**
+ * Create an MCP Server instance and register all tools.
+ */
+export declare const createMcpServer: (tools: McpToolDefinition[], info: {
+    readonly name: string;
+    readonly version: string;
+}) => Server;
+/**
+ * Build MCP tools from an App, create a server, and connect via stdio.
+ */
+export declare const blaze: (app: Topo, options?: BlazeMcpOptions) => Promise<void>;
+//# sourceMappingURL=blaze.d.ts.map

package/dist/blaze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blaze.d.ts","sourceRoot":"","sources":["../src/blaze.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAKnE,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEhE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAQpD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,aAAa,CAAC,EACnB,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,GAC5C,SAAS,CAAC;IACd,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,UAAU,CAAC,EAChB;QACE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACvC,GACD,SAAS,CAAC;IACd,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC1C;AAMD;;GAEG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,iBAAiB,EAAE,EAC1B,MAAM;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,KACxD,MAmEF,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,KAAK,GAChB,KAAK,IAAI,EACT,UAAS,eAAoB,KAC5B,OAAO,CAAC,IAAI,CAcd,CAAC"}

package/dist/blaze.js

@@ -0,0 +1,96 @@
+/**
+ * blaze() -- the one-liner MCP server launcher.
+ *
+ * Three lines to expose trails as MCP tools:
+ *
+ * ```ts
+ * const app = topo("myapp", entity);
+ * await blaze(app);
+ * ```
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { buildMcpTools } from './build.js';
+import { connectStdio } from './stdio.js';
+// ---------------------------------------------------------------------------
+// Internal: create MCP server with tool handlers
+// ---------------------------------------------------------------------------
+/**
+ * Create an MCP Server instance and register all tools.
+ */
+export const createMcpServer = (tools, info) => {
+    const server = new Server({ name: info.name, version: info.version }, { capabilities: { tools: {} } });
+    // Build a lookup map for tool dispatch
+    const toolMap = new Map();
+    for (const tool of tools) {
+        toolMap.set(tool.name, tool);
+    }
+    // Register tools/list handler
+    // oxlint-disable-next-line require-await -- MCP SDK requires async handler
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: tools.map((t) => ({
+            annotations: t.annotations,
+            description: t.description,
+            inputSchema: t.inputSchema,
+            name: t.name,
+        })),
+    }));
+    // Register tools/call handler
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const tool = toolMap.get(request.params.name);
+        if (tool === undefined) {
+            return {
+                content: [
+                    {
+                        text: `Unknown tool: ${request.params.name}`,
+                        type: 'text',
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const args = (request.params.arguments ?? {});
+        const progressToken = request.params._meta?.progressToken;
+        const sendProgress = progressToken === undefined
+            ? undefined
+            : async (current, total) => {
+                await server.notification({
+                    method: 'notifications/progress',
+                    params: {
+                        progress: current,
+                        progressToken: progressToken,
+                        total,
+                    },
+                });
+            };
+        const extra = {
+            progressToken,
+            sendProgress,
+            signal: undefined,
+        };
+        const result = await tool.handler(args, extra);
+        // Spread to satisfy MCP SDK's index-signature requirement
+        return { ...result };
+    });
+    return server;
+};
+// ---------------------------------------------------------------------------
+// blaze
+// ---------------------------------------------------------------------------
+/**
+ * Build MCP tools from an App, create a server, and connect via stdio.
+ */
+export const blaze = async (app, options = {}) => {
+    const tools = buildMcpTools(app, {
+        createContext: options.createContext,
+        excludeTrails: options.excludeTrails,
+        includeTrails: options.includeTrails,
+        layers: options.layers,
+    });
+    const server = createMcpServer(tools, {
+        name: options.serverInfo?.name ?? app.name,
+        version: options.serverInfo?.version ?? '0.1.0',
+    });
+    await connectStdio(server);
+};
+//# sourceMappingURL=blaze.js.map

package/dist/blaze.js.map

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

package/dist/build.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Build MCP tool definitions from a Trails App.
+ *
+ * Iterates the topo, generates McpToolDefinition[] with handlers that
+ * validate input, compose layers, execute the implementation, and map
+ * Results to MCP responses.
+ */
+import type { Layer, Topo, TrailContext } from '@ontrails/core';
+import type { McpAnnotations } from './annotations.js';
+export interface BuildMcpToolsOptions {
+    readonly createContext?: (() => TrailContext | Promise<TrailContext>) | undefined;
+    readonly excludeTrails?: readonly string[] | undefined;
+    readonly includeTrails?: readonly string[] | undefined;
+    readonly layers?: readonly Layer[] | undefined;
+}
+export interface McpToolDefinition {
+    readonly annotations: McpAnnotations | undefined;
+    readonly description: string | undefined;
+    readonly handler: (args: Record<string, unknown>, extra: McpExtra) => Promise<McpToolResult>;
+    readonly inputSchema: Record<string, unknown>;
+    readonly name: string;
+}
+export interface McpExtra {
+    readonly progressToken?: string | number | undefined;
+    readonly sendProgress?: ((current: number, total: number) => Promise<void>) | undefined;
+    readonly signal?: AbortSignal | undefined;
+}
+export interface McpToolResult {
+    readonly content: readonly McpContent[];
+    readonly isError?: boolean | undefined;
+}
+export interface McpContent {
+    readonly data?: string | undefined;
+    readonly mimeType?: string | undefined;
+    readonly text?: string | undefined;
+    readonly type: 'text' | 'image' | 'resource';
+    readonly uri?: string | undefined;
+}
+export declare const buildMcpTools: (app: Topo, options?: BuildMcpToolsOptions) => McpToolDefinition[];
+//# sourceMappingURL=build.d.ts.map

package/dist/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAS,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AASvD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,aAAa,CAAC,EACnB,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,GAC5C,SAAS,CAAC;IACd,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,GAAG,SAAS,CAAC;CAChD;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,cAAc,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,CAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,QAAQ,KACZ,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,YAAY,CAAC,EAClB,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GACnD,SAAS,CAAC;IACd,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC3C;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;IAC7C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AA4OD,eAAO,MAAM,aAAa,GACxB,KAAK,IAAI,EACT,UAAS,oBAAyB,KACjC,iBAAiB,EAiBnB,CAAC"}

package/dist/build.js

@@ -0,0 +1,190 @@
+/**
+ * Build MCP tool definitions from a Trails App.
+ *
+ * Iterates the topo, generates McpToolDefinition[] with handlers that
+ * validate input, compose layers, execute the implementation, and map
+ * Results to MCP responses.
+ */
+import { composeLayers, createTrailContext, validateInput, zodToJsonSchema, } from '@ontrails/core';
+import { deriveAnnotations } from './annotations.js';
+import { createMcpProgressCallback } from './progress.js';
+import { deriveToolName } from './tool-name.js';
+const isBlobRef = (value) => {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const obj = value;
+    return (obj['kind'] === 'blob' &&
+        obj['data'] instanceof Uint8Array &&
+        typeof obj['mimeType'] === 'string');
+};
+const uint8ArrayToBase64 = (bytes) => {
+    // Use btoa with manual conversion for runtime-agnostic base64
+    let binary = '';
+    for (const byte of bytes) {
+        binary += String.fromCodePoint(byte);
+    }
+    return btoa(binary);
+};
+const blobToContent = (blob) => {
+    if (blob.mimeType.startsWith('image/')) {
+        return {
+            data: uint8ArrayToBase64(blob.data),
+            mimeType: blob.mimeType,
+            type: 'image',
+        };
+    }
+    return {
+        mimeType: blob.mimeType,
+        type: 'resource',
+        uri: `blob://${blob.name ?? 'unnamed'}`,
+    };
+};
+/** Separate blob fields from non-blob fields in an object. */
+const separateBlobFields = (obj) => {
+    const blobContents = [];
+    const textFields = {};
+    let hasBlobFields = false;
+    for (const [key, val] of Object.entries(obj)) {
+        if (isBlobRef(val)) {
+            hasBlobFields = true;
+            blobContents.push(blobToContent(val));
+        }
+        else {
+            textFields[key] = val;
+        }
+    }
+    return { blobContents, hasBlobFields, textFields };
+};
+/** Serialize a mixed blob/text object to MCP content. */
+const serializeMixedObject = (obj) => {
+    const { blobContents, hasBlobFields, textFields } = separateBlobFields(obj);
+    if (!hasBlobFields) {
+        return undefined;
+    }
+    if (Object.keys(textFields).length > 0) {
+        blobContents.unshift({ text: JSON.stringify(textFields), type: 'text' });
+    }
+    return blobContents;
+};
+const serializeOutput = (value) => {
+    if (isBlobRef(value)) {
+        return [blobToContent(value)];
+    }
+    if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+        const mixed = serializeMixedObject(value);
+        if (mixed) {
+            return mixed;
+        }
+    }
+    return [{ text: JSON.stringify(value), type: 'text' }];
+};
+// ---------------------------------------------------------------------------
+// Handler factory
+// ---------------------------------------------------------------------------
+/** Create an error result for MCP responses. */
+const mcpError = (message) => ({
+    content: [{ text: message, type: 'text' }],
+    isError: true,
+});
+/** Build a TrailContext from options and MCP extra. */
+const buildTrailContext = async (options, extra) => {
+    const baseContext = options.createContext !== undefined && options.createContext !== null
+        ? await options.createContext()
+        : createTrailContext();
+    const signal = extra.signal ?? baseContext.signal;
+    const progressCb = createMcpProgressCallback(extra);
+    return {
+        ...baseContext,
+        signal,
+        ...(progressCb === undefined ? {} : { progress: progressCb }),
+    };
+};
+/** Execute a trail and map the result to an MCP response. */
+const executeAndMap = async (trail, validatedInput, ctx, layers) => {
+    const impl = composeLayers([...layers], trail, trail.implementation);
+    try {
+        const result = await impl(validatedInput, ctx);
+        if (result.isOk()) {
+            return { content: serializeOutput(result.value) };
+        }
+        return mcpError(result.error.message);
+    }
+    catch (error) {
+        return mcpError(error instanceof Error ? error.message : String(error));
+    }
+};
+const createHandler = (trail, layers, options) => async (args, extra) => {
+    const validated = validateInput(trail.input, args);
+    if (validated.isErr()) {
+        return mcpError(validated.error.message);
+    }
+    const ctx = await buildTrailContext(options, extra);
+    return executeAndMap(trail, validated.value, ctx, layers);
+};
+// ---------------------------------------------------------------------------
+// Builder
+// ---------------------------------------------------------------------------
+/**
+ * Build MCP tool definitions from an App's topology.
+ *
+ * Each trail in the topo becomes an McpToolDefinition with:
+ * - A derived tool name (app-prefixed, underscore-delimited)
+ * - JSON Schema input from zodToJsonSchema
+ * - MCP annotations from trail markers
+ * - A handler that validates, composes layers, executes, and maps results
+ */
+/** Check if a trail should be included based on markers and filters. */
+const shouldInclude = (trail, options) => {
+    if (trail.markers?.['internal'] === true) {
+        return false;
+    }
+    if (options.includeTrails !== undefined && options.includeTrails.length > 0) {
+        return options.includeTrails.includes(trail.id);
+    }
+    if (options.excludeTrails !== undefined &&
+        options.excludeTrails.includes(trail.id)) {
+        return false;
+    }
+    return true;
+};
+/** Build a description with optional example input appended. */
+const buildDescription = (trail) => {
+    let { description } = trail;
+    if (description !== undefined &&
+        trail.examples !== undefined &&
+        trail.examples.length > 0) {
+        const [firstExample] = trail.examples;
+        if (firstExample !== undefined) {
+            description = `${description}\n\nExample input: ${JSON.stringify(firstExample.input)}`;
+        }
+    }
+    return description;
+};
+/** Build a single MCP tool definition from a trail. */
+const buildToolDefinition = (app, trail, layers, options) => {
+    const rawAnnotations = deriveAnnotations(trail);
+    const annotations = Object.keys(rawAnnotations).length > 0 ? rawAnnotations : undefined;
+    return {
+        annotations,
+        description: buildDescription(trail),
+        handler: createHandler(trail, layers, options),
+        inputSchema: zodToJsonSchema(trail.input),
+        name: deriveToolName(app.name, trail.id),
+    };
+};
+export const buildMcpTools = (app, options = {}) => {
+    const layers = options.layers ?? [];
+    const tools = [];
+    for (const item of app.list()) {
+        if (item.kind !== 'trail' && item.kind !== 'hike') {
+            continue;
+        }
+        if (!shouldInclude(item, options)) {
+            continue;
+        }
+        tools.push(buildToolDefinition(app, item, layers, options));
+    }
+    return tools;
+};
+//# sourceMappingURL=build.js.map

package/dist/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AA0DhD,MAAM,SAAS,GAAG,CAAC,KAAc,EAAoB,EAAE;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,OAAO,CACL,GAAG,CAAC,MAAM,CAAC,KAAK,MAAM;QACtB,GAAG,CAAC,MAAM,CAAC,YAAY,UAAU;QACjC,OAAO,GAAG,CAAC,UAAU,CAAC,KAAK,QAAQ,CACpC,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,KAAiB,EAAU,EAAE;IACvD,8DAA8D;IAC9D,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,IAAa,EAAc,EAAE;IAClD,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvC,OAAO;YACL,IAAI,EAAE,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC;YACnC,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,OAAO;SACd,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,IAAI,EAAE,UAAU;QAChB,GAAG,EAAE,UAAU,IAAI,CAAC,IAAI,IAAI,SAAS,EAAE;KACxC,CAAC;AACJ,CAAC,CAAC;AAEF,8DAA8D;AAC9D,MAAM,kBAAkB,GAAG,CACzB,GAA4B,EAK5B,EAAE;IACF,MAAM,YAAY,GAAiB,EAAE,CAAC;IACtC,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7C,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,aAAa,GAAG,IAAI,CAAC;YACrB,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;QACxB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC;AACrD,CAAC,CAAC;AAEF,yDAAyD;AACzD,MAAM,oBAAoB,GAAG,CAC3B,GAA4B,EACO,EAAE;IACrC,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC5E,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,YAAY,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,KAAc,EAAyB,EAAE;IAChE,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzE,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAgC,CAAC,CAAC;QACrE,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;AACzD,CAAC,CAAC;AAEF,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,gDAAgD;AAChD,MAAM,QAAQ,GAAG,CAAC,OAAe,EAAiB,EAAE,CAAC,CAAC;IACpD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1C,OAAO,EAAE,IAAI;CACd,CAAC,CAAC;AAEH,uDAAuD;AACvD,MAAM,iBAAiB,GAAG,KAAK,EAC7B,OAA6B,EAC7B,KAAe,EACQ,EAAE;IACzB,MAAM,WAAW,GACf,OAAO,CAAC,aAAa,KAAK,SAAS,IAAI,OAAO,CAAC,aAAa,KAAK,IAAI;QACnE,CAAC,CAAC,MAAM,OAAO,CAAC,aAAa,EAAE;QAC/B,CAAC,CAAC,kBAAkB,EAAE,CAAC;IAE3B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,WAAW,CAAC,MAAM,CAAC;IAClD,MAAM,UAAU,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IAEpD,OAAO;QACL,GAAG,WAAW;QACd,MAAM;QACN,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;KAC9D,CAAC;AACJ,CAAC,CAAC;AAEF,6DAA6D;AAC7D,MAAM,aAAa,GAAG,KAAK,EACzB,KAA8B,EAC9B,cAAuB,EACvB,GAAiB,EACjB,MAAwB,EACA,EAAE;IAC1B,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IACrE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;QAC/C,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YAClB,OAAO,EAAE,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,CAAC;QACD,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,QAAQ,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,aAAa,GACjB,CACE,KAA8B,EAC9B,MAAwB,EACxB,OAA6B,EAIF,EAAE,CAC/B,KAAK,EAAE,IAAI,EAAE,KAAK,EAA0B,EAAE;IAC5C,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACnD,IAAI,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;QACtB,OAAO,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACpD,OAAO,aAAa,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;AAC5D,CAAC,CAAC;AAEJ,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,wEAAwE;AACxE,MAAM,aAAa,GAAG,CACpB,KAA8B,EAC9B,OAA6B,EACpB,EAAE;IACX,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5E,OAAO,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,IACE,OAAO,CAAC,aAAa,KAAK,SAAS;QACnC,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,EACxC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,gEAAgE;AAChE,MAAM,gBAAgB,GAAG,CACvB,KAA8B,EACV,EAAE;IACtB,IAAI,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IAC5B,IACE,WAAW,KAAK,SAAS;QACzB,KAAK,CAAC,QAAQ,KAAK,SAAS;QAC5B,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EACzB,CAAC;QACD,MAAM,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC;QACtC,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,WAAW,GAAG,GAAG,WAAW,sBAAsB,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACzF,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC,CAAC;AAEF,uDAAuD;AACvD,MAAM,mBAAmB,GAAG,CAC1B,GAAS,EACT,KAA8B,EAC9B,MAAwB,EACxB,OAA6B,EACV,EAAE;IACrB,MAAM,cAAc,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,WAAW,GACf,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,OAAO;QACL,WAAW;QACX,WAAW,EAAE,gBAAgB,CAAC,KAAK,CAAC;QACpC,OAAO,EAAE,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC;QAC9C,WAAW,EAAE,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC;QACzC,IAAI,EAAE,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;KACzC,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,GAAS,EACT,UAAgC,EAAE,EACb,EAAE;IACvB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;IACpC,MAAM,KAAK,GAAwB,EAAE,CAAC;IAEtC,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAClD,SAAS;QACX,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,IAA+B,EAAE,OAAO,CAAC,EAAE,CAAC;YAC7D,SAAS;QACX,CAAC;QACD,KAAK,CAAC,IAAI,CACR,mBAAmB,CAAC,GAAG,EAAE,IAA+B,EAAE,MAAM,EAAE,OAAO,CAAC,CAC3E,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { buildMcpTools, type BuildMcpToolsOptions, type McpToolDefinition, type McpToolResult, type McpContent, type McpExtra, } from './build.js';
+export { deriveToolName } from './tool-name.js';
+export { deriveAnnotations, type McpAnnotations } from './annotations.js';
+export { createMcpProgressCallback } from './progress.js';
+export { blaze, type BlazeMcpOptions } from './blaze.js';
+export { connectStdio } from './stdio.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,QAAQ,GACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EAAE,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAG1E,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAG1D,OAAO,EAAE,KAAK,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAGzD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}