@ontrails/mcp 1.0.0-beta.15 → 1.0.0-beta.16

package/dist/progress.js

@@ -1,51 +0,0 @@
-/**
- * Bridge Trails ProgressCallback to MCP sendProgress notifications.
- */
-/** Fire-and-forget a progress send, swallowing transport errors. */
-const fireSend = async (send, current, total) => {
-    try {
-        await send(current, total);
-    }
-    catch {
-        /* Transport errors are expected and safe to ignore */
-    }
-};
-const handleProgress = (event, send) => {
-    if (event.current !== undefined && event.total !== undefined) {
-        fireSend(send, event.current, event.total);
-    }
-    else if (event.current !== undefined) {
-        fireSend(send, event.current, 0);
-    }
-};
-const progressHandlers = {
-    complete: (_event, send) => fireSend(send, 1, 1),
-    error: () => {
-        /* No progress notification for errors */
-    },
-    progress: handleProgress,
-    start: (_event, send) => fireSend(send, 0, 1),
-};
-// ---------------------------------------------------------------------------
-// Factory
-// ---------------------------------------------------------------------------
-/**
- * Create a ProgressCallback that bridges to MCP's sendProgress.
- *
- * Returns `undefined` if the MCP client did not provide a progressToken
- * (meaning no progress reporting was requested).
- */
-export const createMcpProgressCallback = (extra) => {
-    if (extra.progressToken === undefined || extra.progressToken === null) {
-        return undefined;
-    }
-    if (typeof extra.sendProgress !== 'function') {
-        return undefined;
-    }
-    const send = extra.sendProgress;
-    return (event) => {
-        const handler = progressHandlers[event.type];
-        handler?.(event, send);
-    };
-};
-//# sourceMappingURL=progress.js.map

package/dist/progress.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"progress.js","sourceRoot":"","sources":["../src/progress.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,oEAAoE;AACpE,MAAM,QAAQ,GAAG,KAAK,EACpB,IAAY,EACZ,OAAe,EACf,KAAa,EACE,EAAE;IACjB,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,sDAAsD;IACxD,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,KAAoB,EAAE,IAAY,EAAQ,EAAE;IAClE,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7D,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACvC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACnC,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAGlB;IACF,QAAQ,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IAChD,KAAK,EAAE,GAAG,EAAE;QACV,yCAAyC;IAC3C,CAAC;IACD,QAAQ,EAAE,cAAc;IACxB,KAAK,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;CAC9C,CAAC;AAEF,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,KAAe,EACe,EAAE;IAChC,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS,IAAI,KAAK,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;QACtE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;QAC7C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC;IAChC,OAAO,CAAC,KAAoB,EAAQ,EAAE;QACpC,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7C,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACzB,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/dist/stdio.d.ts

@@ -1,12 +0,0 @@
-/**
- * Thin wrapper around MCP SDK's StdioServerTransport.
- *
- * Exists as a separate function so it can be swapped for other transports
- * (SSE, streamable HTTP) without changing surface().
- */
-import type { Server } from '@modelcontextprotocol/sdk/server/index.js';
-/**
- * Connect an MCP server to stdio transport.
- */
-export declare const connectStdio: (server: Server) => Promise<void>;
-//# sourceMappingURL=stdio.d.ts.map

package/dist/stdio.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAGxE;;GAEG;AACH,eAAO,MAAM,YAAY,GAAU,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAG/D,CAAC"}

package/dist/stdio.js

@@ -1,15 +0,0 @@
-/**
- * Thin wrapper around MCP SDK's StdioServerTransport.
- *
- * Exists as a separate function so it can be swapped for other transports
- * (SSE, streamable HTTP) without changing surface().
- */
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-/**
- * Connect an MCP server to stdio transport.
- */
-export const connectStdio = async (server) => {
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-};
-//# sourceMappingURL=stdio.js.map

package/dist/stdio.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,MAAc,EAAiB,EAAE;IAClE,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC,CAAC"}

package/dist/surface.d.ts

@@ -1,35 +0,0 @@
-/**
- * Surface helpers for exposing a topo over MCP.
- */
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import type { Intent, Layer, ResourceOverrideMap, Topo, TrailContextInit } from '@ontrails/core';
-export interface CreateServerOptions {
-    /** Config values for resources that declare a `config` schema, keyed by resource ID. */
-    readonly configValues?: Readonly<Record<string, Record<string, unknown>>> | undefined;
-    readonly createContext?: (() => TrailContextInit | Promise<TrailContextInit>) | undefined;
-    readonly description?: string | undefined;
-    readonly exclude?: readonly string[] | undefined;
-    readonly include?: readonly string[] | undefined;
-    readonly intent?: readonly Intent[] | undefined;
-    readonly layers?: readonly Layer[] | undefined;
-    readonly name?: string | undefined;
-    readonly resources?: ResourceOverrideMap | undefined;
-    /** Set to `false` to skip topo validation at startup. Defaults to `true`. */
-    readonly validate?: boolean | undefined;
-    readonly version?: string | undefined;
-}
-export interface SurfaceMcpResult {
-    readonly close: () => Promise<void>;
-}
-/**
- * Build MCP tools from a topo and create an MCP server.
- */
-export declare const createServer: (graph: Topo, options?: CreateServerOptions) => Server;
-/**
- * Build MCP tools from a topo, create a server, and connect via stdio.
- *
- * @remarks Opens the MCP server on stdio. For custom transports, use
- * `createServer(graph)` with `connectStdio` or your own connector.
- */
-export declare const surface: (graph: Topo, options?: CreateServerOptions) => Promise<SurfaceMcpResult>;
-//# sourceMappingURL=surface.d.ts.map

package/dist/surface.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"surface.d.ts","sourceRoot":"","sources":["../src/surface.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAKnE,OAAO,KAAK,EACV,MAAM,EACN,KAAK,EACL,mBAAmB,EACnB,IAAI,EACJ,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAUxB,MAAM,WAAW,mBAAmB;IAClC,wFAAwF;IACxF,QAAQ,CAAC,YAAY,CAAC,EAClB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GACjD,SAAS,CAAC;IACd,QAAQ,CAAC,aAAa,CAAC,EACnB,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,GACpD,SAAS,CAAC;IACd,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACrD,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAkGD;;GAEG;AACH,eAAO,MAAM,YAAY,GACvB,OAAO,IAAI,EACX,UAAS,mBAAwB,KAChC,MAqBF,CAAC;AAMF;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAClB,OAAO,IAAI,EACX,UAAS,mBAAwB,KAChC,OAAO,CAAC,gBAAgB,CAS1B,CAAC"}

package/dist/surface.js

@@ -1,123 +0,0 @@
-/**
- * Surface helpers for exposing a topo over MCP.
- */
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-import { deriveMcpTools } from './build.js';
-import { connectStdio } from './stdio.js';
-// ---------------------------------------------------------------------------
-// Internal: create MCP server with tool handlers
-// ---------------------------------------------------------------------------
-/**
- * Create an MCP Server instance and register all tools.
- *
- * When provided, `info.description` is forwarded to the MCP SDK as the
- * server's `instructions` field — the SDK's documented channel for
- * "optional instructions describing how to use the server and its features."
- */
-const createMcpServer = (tools, info) => {
-    const server = new Server({ name: info.name, version: info.version }, {
-        capabilities: { tools: {} },
-        ...(info.description === undefined
-            ? {}
-            : { instructions: info.description }),
-    });
-    // 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 = {
-            abortSignal: undefined,
-            progressToken,
-            sendProgress,
-        };
-        const result = await tool.handler(args, extra);
-        // Spread to satisfy MCP SDK's index-signature requirement
-        return { ...result };
-    });
-    return server;
-};
-// ---------------------------------------------------------------------------
-// createServer
-// ---------------------------------------------------------------------------
-/**
- * Build MCP tools from a topo and create an MCP server.
- */
-export const createServer = (graph, options = {}) => {
-    const toolsResult = deriveMcpTools(graph, {
-        configValues: options.configValues,
-        createContext: options.createContext,
-        exclude: options.exclude,
-        include: options.include,
-        intent: options.intent,
-        layers: options.layers,
-        resources: options.resources,
-        validate: options.validate,
-    });
-    if (toolsResult.isErr()) {
-        throw toolsResult.error;
-    }
-    return createMcpServer(toolsResult.value, {
-        description: options.description ?? graph.description,
-        name: options.name ?? graph.name,
-        version: options.version ?? graph.version ?? '0.1.0',
-    });
-};
-// ---------------------------------------------------------------------------
-// surface
-// ---------------------------------------------------------------------------
-/**
- * Build MCP tools from a topo, create a server, and connect via stdio.
- *
- * @remarks Opens the MCP server on stdio. For custom transports, use
- * `createServer(graph)` with `connectStdio` or your own connector.
- */
-export const surface = async (graph, options = {}) => {
-    const server = createServer(graph, options);
-    await connectStdio(server);
-    return {
-        close: async () => {
-            await server.close();
-        },
-    };
-};
-//# sourceMappingURL=surface.js.map

package/dist/surface.js.map

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

package/dist/tool-name.d.ts

@@ -1,15 +0,0 @@
-/**
- * Derive MCP-safe tool names from app name + trail ID.
- *
- * MCP tool names must be [a-z0-9_]+. We prefix with the app name,
- * replace dots and hyphens with underscores, and lowercase everything.
- */
-/**
- * Convert app name + trail ID to an MCP-safe tool name.
- *
- * @example
- * deriveToolName("myapp", "entity.show") // "myapp_entity_show"
- * deriveToolName("dispatch", "patch.search") // "dispatch_patch_search"
- */
-export declare const deriveToolName: (appName: string, trailId: string) => string;
-//# sourceMappingURL=tool-name.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"tool-name.d.ts","sourceRoot":"","sources":["../src/tool-name.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,EAAE,SAAS,MAAM,KAAG,MAIjE,CAAC"}

package/dist/tool-name.js

@@ -1,19 +0,0 @@
-/**
- * Derive MCP-safe tool names from app name + trail ID.
- *
- * MCP tool names must be [a-z0-9_]+. We prefix with the app name,
- * replace dots and hyphens with underscores, and lowercase everything.
- */
-/**
- * Convert app name + trail ID to an MCP-safe tool name.
- *
- * @example
- * deriveToolName("myapp", "entity.show") // "myapp_entity_show"
- * deriveToolName("dispatch", "patch.search") // "dispatch_patch_search"
- */
-export const deriveToolName = (appName, trailId) => {
-    const prefix = appName.toLowerCase().replaceAll(/[.-]/g, '_');
-    const suffix = trailId.toLowerCase().replaceAll(/[.-]/g, '_');
-    return `${prefix}_${suffix}`;
-};
-//# sourceMappingURL=tool-name.js.map

package/dist/tool-name.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool-name.js","sourceRoot":"","sources":["../src/tool-name.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAe,EAAE,OAAe,EAAU,EAAE;IACzE,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC9D,OAAO,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAC/B,CAAC,CAAC"}

package/dist/trailhead.d.ts

@@ -1,57 +0,0 @@
-/**
- * trailhead() -- the one-liner MCP server launcher.
- *
- * Three lines to expose trails as MCP tools:
- *
- * ```ts
- * const app = topo("myapp", entity);
- * await trailhead(app);
- * ```
- */
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import type { Intent, Layer, ResourceOverrideMap, Topo, TrailContextInit } from '@ontrails/core';
-import type { McpToolDefinition } from './build.js';
-export interface TrailheadMcpOptions {
-    /** Config values for resources that declare a `config` schema, keyed by resource ID. */
-    readonly configValues?: Readonly<Record<string, Record<string, unknown>>> | undefined;
-    readonly createContext?: (() => TrailContextInit | Promise<TrailContextInit>) | undefined;
-    readonly description?: string | undefined;
-    readonly exclude?: readonly string[] | undefined;
-    readonly include?: readonly string[] | undefined;
-    readonly intent?: readonly Intent[] | undefined;
-    readonly layers?: readonly Layer[] | undefined;
-    readonly name?: string | undefined;
-    readonly resources?: ResourceOverrideMap | undefined;
-    /** Set to `false` to skip topo validation at startup. Defaults to `true`. */
-    readonly validate?: boolean | undefined;
-    readonly version?: string | undefined;
-}
-export type CreateServerOptions = TrailheadMcpOptions;
-export interface SurfaceMcpResult {
-    readonly close: () => Promise<void>;
-}
-/**
- * Create an MCP Server instance and register all tools.
- *
- * When provided, `info.description` is forwarded to the MCP SDK as the
- * server's `instructions` field — the SDK's documented channel for
- * "optional instructions describing how to use the server and its features."
- */
-export declare const createMcpServer: (tools: McpToolDefinition[], info: {
-    readonly name: string;
-    readonly version: string;
-    readonly description?: string | undefined;
-}) => Server;
-/**
- * Build MCP tools from a topo and create an MCP server.
- */
-export declare const createServer: (app: Topo, options?: CreateServerOptions) => Server;
-/**
- * Build MCP tools from a topo, create a server, and connect via stdio.
- */
-export declare const surface: (app: Topo, options?: TrailheadMcpOptions) => Promise<SurfaceMcpResult>;
-/**
- * Build MCP tools from a topo, create a server, and connect via stdio.
- */
-export declare const trailhead: (app: Topo, options?: TrailheadMcpOptions) => Promise<void>;
-//# sourceMappingURL=trailhead.d.ts.map

package/dist/trailhead.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"trailhead.d.ts","sourceRoot":"","sources":["../src/trailhead.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAKnE,OAAO,KAAK,EACV,MAAM,EACN,KAAK,EACL,mBAAmB,EACnB,IAAI,EACJ,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAQpD,MAAM,WAAW,mBAAmB;IAClC,wFAAwF;IACxF,QAAQ,CAAC,YAAY,CAAC,EAClB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GACjD,SAAS,CAAC;IACd,QAAQ,CAAC,aAAa,CAAC,EACnB,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,GACpD,SAAS,CAAC;IACd,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACrD,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAMD;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,iBAAiB,EAAE,EAC1B,MAAM;IACJ,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C,KACA,MAwEF,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,YAAY,GACvB,KAAK,IAAI,EACT,UAAS,mBAAwB,KAChC,MAqBF,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,OAAO,GAClB,KAAK,IAAI,EACT,UAAS,mBAAwB,KAChC,OAAO,CAAC,gBAAgB,CAS1B,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,SAAS,GACpB,KAAK,IAAI,EACT,UAAS,mBAAwB,KAChC,OAAO,CAAC,IAAI,CAEd,CAAC"}

package/dist/trailhead.js

@@ -1,136 +0,0 @@
-/**
- * trailhead() -- the one-liner MCP server launcher.
- *
- * Three lines to expose trails as MCP tools:
- *
- * ```ts
- * const app = topo("myapp", entity);
- * await trailhead(app);
- * ```
- */
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-import { deriveMcpTools } from './build.js';
-import { connectStdio } from './stdio.js';
-// ---------------------------------------------------------------------------
-// Internal: create MCP server with tool handlers
-// ---------------------------------------------------------------------------
-/**
- * Create an MCP Server instance and register all tools.
- *
- * When provided, `info.description` is forwarded to the MCP SDK as the
- * server's `instructions` field — the SDK's documented channel for
- * "optional instructions describing how to use the server and its features."
- */
-export const createMcpServer = (tools, info) => {
-    const server = new Server({ name: info.name, version: info.version }, {
-        capabilities: { tools: {} },
-        ...(info.description === undefined
-            ? {}
-            : { instructions: info.description }),
-    });
-    // 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 = {
-            abortSignal: undefined,
-            progressToken,
-            sendProgress,
-        };
-        const result = await tool.handler(args, extra);
-        // Spread to satisfy MCP SDK's index-signature requirement
-        return { ...result };
-    });
-    return server;
-};
-// ---------------------------------------------------------------------------
-// createServer
-// ---------------------------------------------------------------------------
-/**
- * Build MCP tools from a topo and create an MCP server.
- */
-export const createServer = (app, options = {}) => {
-    const toolsResult = deriveMcpTools(app, {
-        configValues: options.configValues,
-        createContext: options.createContext,
-        exclude: options.exclude,
-        include: options.include,
-        intent: options.intent,
-        layers: options.layers,
-        resources: options.resources,
-        validate: options.validate,
-    });
-    if (toolsResult.isErr()) {
-        throw toolsResult.error;
-    }
-    return createMcpServer(toolsResult.value, {
-        description: options.description ?? app.description,
-        name: options.name ?? app.name,
-        version: options.version ?? app.version ?? '0.1.0',
-    });
-};
-// ---------------------------------------------------------------------------
-// surface
-// ---------------------------------------------------------------------------
-/**
- * Build MCP tools from a topo, create a server, and connect via stdio.
- */
-export const surface = async (app, options = {}) => {
-    const server = createServer(app, options);
-    await connectStdio(server);
-    return {
-        close: async () => {
-            await server.close();
-        },
-    };
-};
-// ---------------------------------------------------------------------------
-// trailhead
-// ---------------------------------------------------------------------------
-/**
- * Build MCP tools from a topo, create a server, and connect via stdio.
- */
-export const trailhead = async (app, options = {}) => {
-    await surface(app, options);
-};
-//# sourceMappingURL=trailhead.js.map

package/dist/trailhead.js.map

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

package/src/__tests__/annotations.test.ts

@@ -1,63 +0,0 @@
-import { describe, expect, test } from 'bun:test';
-
-import { deriveAnnotations } from '../annotations.js';
-
-describe('deriveAnnotations', () => {
-  test('read intent produces readOnlyHint', () => {
-    const annotations = deriveAnnotations({ intent: 'read' });
-    expect(annotations.readOnlyHint).toBe(true);
-    expect(annotations.destructiveHint).toBeUndefined();
-    expect(annotations.idempotentHint).toBeUndefined();
-  });
-
-  test('destroy intent produces destructiveHint', () => {
-    const annotations = deriveAnnotations({ intent: 'destroy' });
-    expect(annotations.destructiveHint).toBe(true);
-    expect(annotations.readOnlyHint).toBeUndefined();
-  });
-
-  test('idempotent trail produces idempotentHint', () => {
-    const annotations = deriveAnnotations({
-      idempotent: true,
-      intent: 'write',
-    });
-    expect(annotations.idempotentHint).toBe(true);
-  });
-
-  test('read intent with idempotent combines correctly', () => {
-    const annotations = deriveAnnotations({
-      idempotent: true,
-      intent: 'read',
-    });
-    expect(annotations.readOnlyHint).toBe(true);
-    expect(annotations.idempotentHint).toBe(true);
-    expect(annotations.destructiveHint).toBeUndefined();
-  });
-
-  test('write intent produces empty annotations', () => {
-    const annotations = deriveAnnotations({ intent: 'write' });
-    expect(annotations.readOnlyHint).toBeUndefined();
-    expect(annotations.destructiveHint).toBeUndefined();
-    expect(annotations.idempotentHint).toBeUndefined();
-    expect(annotations.title).toBeUndefined();
-  });
-
-  test('description maps to title', () => {
-    const annotations = deriveAnnotations({
-      description: 'Show entity details',
-      intent: 'write',
-    });
-    expect(annotations.title).toBe('Show entity details');
-  });
-
-  test('all hints plus description', () => {
-    const annotations = deriveAnnotations({
-      description: 'A trail',
-      idempotent: true,
-      intent: 'destroy',
-    });
-    expect(annotations.destructiveHint).toBe(true);
-    expect(annotations.idempotentHint).toBe(true);
-    expect(annotations.title).toBe('A trail');
-  });
-});