@ontrails/mcp 1.0.0-beta.4 → 1.0.0-beta.41

package/dist/build.js

@@ -1,227 +0,0 @@
-/**
- * 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, isBlobRef, validateInput, zodToJsonSchema, } from '@ontrails/core';
-import { deriveAnnotations } from './annotations.js';
-import { createMcpProgressCallback } from './progress.js';
-import { deriveToolName } from './tool-name.js';
-// ---------------------------------------------------------------------------
-// Internal helpers (defined before use)
-// ---------------------------------------------------------------------------
-/** Concatenate an array of Uint8Array chunks into a single Uint8Array. */
-const concatChunks = (chunks, totalLength) => {
-    const result = new Uint8Array(totalLength);
-    let offset = 0;
-    for (const chunk of chunks) {
-        result.set(chunk, offset);
-        offset += chunk.length;
-    }
-    return result;
-};
-/** Collect a ReadableStream into a single Uint8Array. */
-const collectStream = async (stream) => {
-    const reader = stream.getReader();
-    const chunks = [];
-    let totalLength = 0;
-    for (;;) {
-        const { done, value } = await reader.read();
-        if (done) {
-            break;
-        }
-        chunks.push(value);
-        totalLength += value.length;
-    }
-    return concatChunks(chunks, totalLength);
-};
-/** Resolve BlobRef data to Uint8Array (handles ReadableStream). */
-const resolveBlobData = (blob) => {
-    if (blob.data instanceof ReadableStream) {
-        return collectStream(blob.data);
-    }
-    return blob.data;
-};
-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 = async (blob) => {
-    const bytes = await resolveBlobData(blob);
-    if (blob.mimeType.startsWith('image/')) {
-        return {
-            data: uint8ArrayToBase64(bytes),
-            mimeType: blob.mimeType,
-            type: 'image',
-        };
-    }
-    return {
-        mimeType: blob.mimeType,
-        type: 'resource',
-        uri: `blob://${blob.name}`,
-    };
-};
-/** Separate blob fields from non-blob fields in an object. */
-const separateBlobFields = async (obj) => {
-    const blobContents = [];
-    const textFields = {};
-    let hasBlobFields = false;
-    for (const [key, val] of Object.entries(obj)) {
-        if (isBlobRef(val)) {
-            hasBlobFields = true;
-            blobContents.push(await blobToContent(val));
-        }
-        else {
-            textFields[key] = val;
-        }
-    }
-    return { blobContents, hasBlobFields, textFields };
-};
-/** Serialize a mixed blob/text object to MCP content. */
-const serializeMixedObject = async (obj) => {
-    const { blobContents, hasBlobFields, textFields } = await separateBlobFields(obj);
-    if (!hasBlobFields) {
-        return undefined;
-    }
-    if (Object.keys(textFields).length > 0) {
-        blobContents.unshift({ text: JSON.stringify(textFields), type: 'text' });
-    }
-    return blobContents;
-};
-const serializeOutput = async (value) => {
-    if (isBlobRef(value)) {
-        return [await blobToContent(value)];
-    }
-    if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
-        const mixed = await 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.run);
-    try {
-        const result = await impl(validatedInput, ctx);
-        if (result.isOk()) {
-            return { content: await 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 metadata
- * - A handler that validates, composes layers, executes, and maps results
- */
-/** Check if a trail should be included based on metadata and filters. */
-const shouldInclude = (trail, options) => {
-    if (trail.metadata?.['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),
-    };
-};
-/** Register a trail as an MCP tool, checking for name collisions. */
-const registerTool = (app, trailItem, layers, options, nameToTrailId, tools) => {
-    const toolName = deriveToolName(app.name, trailItem.id);
-    const existingId = nameToTrailId.get(toolName);
-    if (existingId !== undefined) {
-        throw new Error(`MCP tool-name collision: trails "${existingId}" and "${trailItem.id}" both derive the tool name "${toolName}"`);
-    }
-    nameToTrailId.set(toolName, trailItem.id);
-    tools.push(buildToolDefinition(app, trailItem, layers, options));
-};
-/** Filter topo items to eligible trails. */
-const eligibleTrails = (app, options) => app
-    .list()
-    .filter((item) => item.kind === 'trail' &&
-    shouldInclude(item, options));
-export const buildMcpTools = (app, options = {}) => {
-    const layers = options.layers ?? [];
-    const tools = [];
-    const nameToTrailId = new Map();
-    for (const trailItem of eligibleTrails(app, options)) {
-        registerTool(app, trailItem, layers, options, nameToTrailId, tools);
-    }
-    return tools;
-};
-//# sourceMappingURL=build.js.map

package/dist/build.js.map

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

package/dist/index.d.ts

@@ -1,7 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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"}

package/dist/index.js

@@ -1,13 +0,0 @@
-// Build
-export { buildMcpTools, } from './build.js';
-// Tool naming
-export { deriveToolName } from './tool-name.js';
-// Annotations
-export { deriveAnnotations } from './annotations.js';
-// Progress
-export { createMcpProgressCallback } from './progress.js';
-// Blaze
-export { blaze } from './blaze.js';
-// Transport
-export { connectStdio } from './stdio.js';
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,OAAO,EACL,aAAa,GAMd,MAAM,YAAY,CAAC;AAEpB,cAAc;AACd,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,cAAc;AACd,OAAO,EAAE,iBAAiB,EAAuB,MAAM,kBAAkB,CAAC;AAE1E,WAAW;AACX,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAE1D,QAAQ;AACR,OAAO,EAAE,KAAK,EAAwB,MAAM,YAAY,CAAC;AAEzD,YAAY;AACZ,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/progress.d.ts

@@ -1,13 +0,0 @@
-/**
- * Bridge Trails ProgressCallback to MCP sendProgress notifications.
- */
-import type { ProgressCallback } from '@ontrails/core';
-import type { McpExtra } from './build.js';
-/**
- * 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 declare const createMcpProgressCallback: (extra: McpExtra) => ProgressCallback | undefined;
-//# sourceMappingURL=progress.d.ts.map

package/dist/progress.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../src/progress.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAiB,MAAM,gBAAgB,CAAC;AAEtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AA6C3C;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GACpC,OAAO,QAAQ,KACd,gBAAgB,GAAG,SAarB,CAAC"}

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 blaze().
- */
-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 blaze().
- */
-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/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/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');
-  });
-});

package/src/__tests__/blaze.test.ts

@@ -1,105 +0,0 @@
-import { describe, expect, test } from 'bun:test';
-
-import { Result, trail, topo } from '@ontrails/core';
-import { z } from 'zod';
-
-import { createMcpServer } from '../blaze.js';
-import { buildMcpTools } from '../build.js';
-
-// ---------------------------------------------------------------------------
-// Tests
-// ---------------------------------------------------------------------------
-
-const requireTool = (tools: ReturnType<typeof buildMcpTools>, name: string) => {
-  const tool = tools.find((entry) => entry.name === name);
-  expect(tool).toBeDefined();
-  if (!tool) {
-    throw new Error(`Expected tool: ${name}`);
-  }
-  return tool;
-};
-
-const createIntegrationTools = () => {
-  const greetTrail = trail('greet', {
-    description: 'Greet someone',
-    input: z.object({ name: z.string() }),
-    intent: 'read',
-    run: (input) => Result.ok({ greeting: `Hello, ${input.name}!` }),
-  });
-
-  const deleteTrail = trail('item.delete', {
-    description: 'Delete an item',
-    input: z.object({ id: z.string() }),
-    intent: 'destroy',
-    run: (_input) => Result.ok({ deleted: true }),
-  });
-
-  return buildMcpTools(topo('myapp', { deleteTrail, greetTrail }));
-};
-
-describe('blaze', () => {
-  test('createMcpServer registers tools that can be listed', () => {
-    const echoTrail = trail('echo', {
-      description: 'Echo',
-      input: z.object({ message: z.string() }),
-      intent: 'read',
-      run: (input) => Result.ok({ reply: input.message }),
-    });
-
-    const app = topo('testapp', { echoTrail });
-    const tools = buildMcpTools(app);
-    const server = createMcpServer(tools, {
-      name: 'testapp',
-      version: '0.1.0',
-    });
-
-    // Server is created successfully
-    expect(server).toBeDefined();
-  });
-
-  test('createMcpServer handles multiple tools', () => {
-    const echoTrail = trail('echo', {
-      description: 'Echo',
-      input: z.object({ message: z.string() }),
-      run: (input) => Result.ok({ reply: input.message }),
-    });
-
-    const searchTrail = trail('search', {
-      description: 'Search',
-      input: z.object({ query: z.string() }),
-      intent: 'read',
-      run: (input) => Result.ok({ results: [input.query] }),
-    });
-
-    const app = topo('testapp', { echoTrail, searchTrail });
-    const tools = buildMcpTools(app);
-
-    expect(tools).toHaveLength(2);
-
-    const server = createMcpServer(tools, {
-      name: 'testapp',
-      version: '0.1.0',
-    });
-    expect(server).toBeDefined();
-  });
-
-  test('buildMcpTools + createMcpServer integration', () => {
-    const tools = createIntegrationTools();
-    const names = tools.map((t) => t.name);
-    expect(names).toContain('myapp_greet');
-    expect(names).toContain('myapp_item_delete');
-
-    expect(requireTool(tools, 'myapp_greet').annotations?.readOnlyHint).toBe(
-      true
-    );
-    expect(
-      requireTool(tools, 'myapp_item_delete').annotations?.destructiveHint
-    ).toBe(true);
-
-    const server = createMcpServer(tools, {
-      name: 'myapp',
-      version: '1.0.0',
-    });
-    expect(server).toBeDefined();
-  });
-});