@vibesdotdev/mcp 0.0.0-stage → 1.0.0-rc.1

package/dist/adapters/mcp/context.js

@@ -0,0 +1,230 @@
+/**
+ * MCP Tool Context Types and Helpers
+ *
+ * Tool-runtime context with CLI/AI/auth/PM runtime fields.
+ * These types compose tool-runtime context for MCP tool execution.
+ */
+import * as z from 'zod/v4';
+import { ToolError, ToolErrorCode } from '@vibesdotdev/tools/errors';
+// ============================================================================
+// MCP Context Input Validation Schemas
+// ============================================================================
+/** Valid session ID: UUID v4 format */
+const SessionIdSchema = z
+    .string()
+    .regex(/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i, 'Invalid session ID format: expected UUID v4')
+    .max(36, 'Session ID exceeds maximum length (36 characters)');
+/** Valid project ID: alphanumeric, hyphens, underscores; 1-64 chars */
+const ProjectIdSchema = z
+    .string()
+    .regex(/^[a-zA-Z0-9_-]+$/, 'Invalid project ID format: only alphanumeric, hyphens, and underscores allowed')
+    .min(1, 'Project ID cannot be empty')
+    .max(64, 'Project ID exceeds maximum length (64 characters)');
+/** Valid cookie name: printable ASCII except control chars, semicolon, comma, equals, space, tab */
+const CookieNameSchema = z
+    .string()
+    .regex(/^[\x21-\x7E&&[^;\s,=]]+$/, 'Invalid cookie name: contains forbidden characters')
+    .max(128, 'Cookie name exceeds maximum length (128 characters)');
+/** Valid cookie value: printable ASCII except control chars, semicolon, comma, space, tab */
+const CookieValueSchema = z
+    .string()
+    .regex(/^[\x21-\x7E&&[^;\s,]]*$/, 'Invalid cookie value: contains forbidden characters')
+    .max(4096, 'Cookie value exceeds maximum length (4096 characters)');
+/** Valid header value: printable ASCII and spaces; 1-8192 chars (HTTP spec limit) */
+const HeaderValueSchema = z
+    .string()
+    .regex(/^[\x20-\x7E]*$/, 'Invalid header value: contains non-printable characters')
+    .max(8192, 'Header value exceeds maximum length (8192 characters)');
+/** String-keyed record whose values are validated by the reader, not by the type. */
+const McpRecordSchema = z.record(z.string(), z.unknown());
+/** A string, or undefined for anything else. */
+const OptionalStringSchema = z.string().optional().catch(undefined);
+/** Transport named by the MCP environment; anything unrecognised is stdio. */
+const TransportSchema = z.enum(['stdio', 'http']).catch('stdio');
+/** Validation error result for structured error reporting */
+const ValidationErrorSchema = z.object({
+    field: z.enum(['mcp-session-id', 'x-project-id', 'cookie-name', 'cookie-value']),
+    issue: z.string()
+});
+/**
+ * Validates a session ID and returns typed errors if invalid.
+ */
+function validateSessionId(value) {
+    const result = SessionIdSchema.safeParse(value);
+    if (result.success) {
+        return { valid: true, value: result.data };
+    }
+    return {
+        valid: false,
+        errors: result.error.issues.map((issue) => ({
+            field: 'mcp-session-id',
+            issue: issue.message
+        }))
+    };
+}
+/**
+ * Validates a project ID and returns typed errors if invalid.
+ */
+function validateProjectId(value) {
+    const result = ProjectIdSchema.safeParse(value);
+    if (result.success) {
+        return { valid: true, value: result.data };
+    }
+    return {
+        valid: false,
+        errors: result.error.issues.map((issue) => ({
+            field: 'x-project-id',
+            issue: issue.message
+        }))
+    };
+}
+/**
+ * Validates cookie name/value pairs and returns typed errors.
+ */
+function validateCookies(cookies) {
+    const errors = [];
+    for (const [name, value] of Object.entries(cookies)) {
+        const nameResult = CookieNameSchema.safeParse(name);
+        if (!nameResult.success) {
+            errors.push(...nameResult.error.issues.map((issue) => ({
+                field: 'cookie-name',
+                issue: `Invalid cookie name: ${issue.message}`
+            })));
+        }
+        const valueResult = CookieValueSchema.safeParse(value);
+        if (!valueResult.success) {
+            errors.push(...valueResult.error.issues.map((issue) => ({
+                field: 'cookie-value',
+                issue: `Invalid cookie value: ${issue.message}`
+            })));
+        }
+    }
+    if (errors.length > 0) {
+        return { valid: false, errors };
+    }
+    return { valid: true };
+}
+/**
+ * Validates a header value and returns typed errors if invalid.
+ */
+function validateHeaderValue(headerName, value) {
+    if (value === undefined) {
+        return { valid: true, value: undefined };
+    }
+    if (!z.string().safeParse(value).success) {
+        return {
+            valid: false,
+            errors: [{ field: headerName, issue: 'Header value must be a string' }]
+        };
+    }
+    const result = HeaderValueSchema.safeParse(value);
+    if (result.success) {
+        return { valid: true, value: result.data };
+    }
+    return {
+        valid: false,
+        errors: result.error.issues.map((issue) => ({
+            field: headerName,
+            issue: issue.message
+        }))
+    };
+}
+/**
+ * Throws a structured ToolError for validation failures.
+ */
+function throwValidationError(errors) {
+    const summary = errors.map((e) => `${e.field}: ${e.issue}`).join('; ');
+    throw new ToolError(`MCP context validation failed: ${summary}`, ToolErrorCode.CONTEXT_INVALID, {
+        operation: 'prepareMcpToolExecution',
+        validationErrors: errors,
+        timestamp: new Date().toISOString()
+    }, 'Check that session ID is a valid UUID, project ID uses allowed characters, and headers/cookies are within size limits');
+}
+/**
+ * Resolve workspace path from context
+ */
+function resolveWorkspaceFromContext(context, requestWorkspace) {
+    if (requestWorkspace)
+        return requestWorkspace;
+    if (context.workspacePath)
+        return context.workspacePath;
+    if (context.options?.workspace)
+        return context.options.workspace;
+    return null;
+}
+/**
+ * Prepare MCP tool execution from CLI context and HTTP request
+ * @deprecated Use prepareMcpToolExecutionAsync instead
+ */
+export function prepareMcpToolExecution(_cliContext, _request) {
+    throw new Error('prepareMcpToolExecution requires runtime - use prepareMcpToolExecutionAsync');
+}
+/**
+ * Async version that accepts runtime directly
+ * Validates headers, cookies, session ID, and project ID before use.
+ */
+export function prepareMcpToolExecutionAsync(runtime, cliContext, request) {
+    const headers = request.headers ?? {};
+    const cookies = request.cookies ?? {};
+    const parsedEnvironment = McpRecordSchema.safeParse(cliContext.environment);
+    const environment = parsedEnvironment.success ? parsedEnvironment.data : undefined;
+    // Collect all validation errors
+    const allValidationErrors = [];
+    // Validate cookies first (before we read from them)
+    const cookieValidation = validateCookies(cookies);
+    if (!cookieValidation.valid) {
+        allValidationErrors.push(...cookieValidation.errors);
+    }
+    // Validate header values
+    const mcpSessionHeaderResult = validateHeaderValue('mcp-session-id', headers['mcp-session-id']);
+    if (!mcpSessionHeaderResult.valid) {
+        allValidationErrors.push(...mcpSessionHeaderResult.errors);
+    }
+    const xProjectIdHeaderResult = validateHeaderValue('x-project-id', headers['x-project-id']);
+    if (!xProjectIdHeaderResult.valid) {
+        allValidationErrors.push(...xProjectIdHeaderResult.errors);
+    }
+    // Extract raw values (now validated as safe strings)
+    const rawSessionId = request.sessionId ?? readHeaderValue(headers['mcp-session-id']) ?? cookies['mcp-session-id'];
+    const rawProjectId = request.projectId ?? readHeaderValue(headers['x-project-id']) ?? cookies['project-id'];
+    // Validate session ID if present
+    if (rawSessionId !== undefined && rawSessionId !== null && rawSessionId !== '') {
+        const sessionValidation = validateSessionId(rawSessionId);
+        if (!sessionValidation.valid) {
+            allValidationErrors.push(...sessionValidation.errors);
+        }
+    }
+    // Validate project ID if present
+    if (rawProjectId !== undefined && rawProjectId !== null && rawProjectId !== '') {
+        const projectValidation = validateProjectId(rawProjectId);
+        if (!projectValidation.valid) {
+            allValidationErrors.push(...projectValidation.errors);
+        }
+    }
+    // Throw structured error if any validations failed
+    if (allValidationErrors.length > 0) {
+        throwValidationError(allValidationErrors);
+    }
+    const requestWorkspace = OptionalStringSchema.parse(request.workspacePath);
+    const workspacePath = resolveWorkspaceFromContext(cliContext, requestWorkspace);
+    const mcpConfig = McpRecordSchema.safeParse(environment?.mcp);
+    const transport = TransportSchema.parse(mcpConfig.success ? mcpConfig.data.mode : undefined);
+    const projectIdFromEnv = OptionalStringSchema.parse(environment?.projectId);
+    return {
+        callId: request.toolCallId || generateCallId(),
+        runtime,
+        workspacePath,
+        transport,
+        sessionId: rawSessionId,
+        projectId: rawProjectId ?? projectIdFromEnv
+    };
+}
+function generateCallId() {
+    return `mcp_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
+}
+function readHeaderValue(value) {
+    if (Array.isArray(value))
+        return value.length === 0 ? undefined : value[value.length - 1];
+    return OptionalStringSchema.parse(value);
+}
+//# sourceMappingURL=context.js.map

package/dist/adapters/mcp/context.js.map

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

package/dist/adapters/mcp/formatters.d.ts

@@ -0,0 +1,41 @@
+/**
+ * MCP Response Formatters
+ *
+ * Response formatter functions for MCP tool results.
+ */
+import type { JsonObject } from '@vibesdotdev/kernel/schemas/json';
+import type { McpToolResult } from '@vibesdotdev/mcp/types';
+/**
+ * JSON Schema for tool input parameters
+ */
+export interface McpInputSchema {
+    type: 'object';
+    properties?: JsonObject;
+    required?: string[];
+    additionalProperties?: boolean;
+}
+/**
+ * Response formatter function
+ * Converts arbitrary data into MCP-compatible tool result
+ */
+export type McpResponseFormatter<TData = unknown> = (data: TData) => McpToolResult | Promise<McpToolResult>;
+/**
+ * Default response formatter - converts data to JSON text
+ */
+export declare const defaultFormatter: <TData>(data: TData) => McpToolResult;
+/**
+ * Table formatter - formats array data as markdown table
+ */
+export declare const tableFormatter: <T extends JsonObject>(items: T[], options?: {
+    title?: string;
+    emptyMessage?: string;
+}) => McpToolResult;
+/**
+ * List formatter - formats array as bulleted list
+ */
+export declare const listFormatter: <T>(items: T[], options?: {
+    title?: string;
+    emptyMessage?: string;
+    itemFormatter?: (item: T) => string;
+}) => McpToolResult;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/adapters/mcp/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../../src/adapters/mcp/formatters.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAa,UAAU,EAAa,MAAM,kCAAkC,CAAC;AACzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAUD;;;GAGG;AACH,MAAM,MAAM,oBAAoB,CAAC,KAAK,GAAG,OAAO,IAAI,CACnD,IAAI,EAAE,KAAK,KACP,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,EAAE,MAAM,KAAK,KAAG,aAWrD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,UAAU,EAClD,OAAO,CAAC,EAAE,EACV,UAAS;IACR,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACjB,KACJ,aA6CF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAC9B,OAAO,CAAC,EAAE,EACV,UAAS;IACR,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;CAC/B,KACJ,aA+BF,CAAC"}

package/dist/adapters/mcp/formatters.js

@@ -0,0 +1,102 @@
+/**
+ * MCP Response Formatters
+ *
+ * Response formatter functions for MCP tool results.
+ */
+function isText(value) {
+    return typeof value === 'string';
+}
+function isNestedJson(value) {
+    return typeof value === 'object' && value !== null;
+}
+/**
+ * Default response formatter - converts data to JSON text
+ */
+export const defaultFormatter = (data) => {
+    const text = isText(data) ? data : JSON.stringify(data, null, 2);
+    return {
+        content: [
+            {
+                type: 'text',
+                text
+            }
+        ]
+    };
+};
+/**
+ * Table formatter - formats array data as markdown table
+ */
+export const tableFormatter = (items, options = {}) => {
+    if (!items || items.length === 0) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: options.emptyMessage || 'No results found'
+                }
+            ]
+        };
+    }
+    // Get all unique keys from items
+    const keys = Array.from(new Set(items.flatMap((item) => Object.keys(item))));
+    // Build markdown table
+    let table = '';
+    if (options.title) {
+        table += `## ${options.title}\n\n`;
+    }
+    // Header row
+    table += `| ${keys.join(' | ')} |\n`;
+    table += `| ${keys.map(() => '---').join(' | ')} |\n`;
+    // Data rows
+    for (const item of items) {
+        const values = keys.map((key) => {
+            const value = item[key];
+            if (value === null || value === undefined)
+                return '';
+            if (isNestedJson(value))
+                return JSON.stringify(value);
+            return String(value);
+        });
+        table += `| ${values.join(' | ')} |\n`;
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: table
+            }
+        ]
+    };
+};
+/**
+ * List formatter - formats array as bulleted list
+ */
+export const listFormatter = (items, options = {}) => {
+    if (!items || items.length === 0) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: options.emptyMessage || 'No results found'
+                }
+            ]
+        };
+    }
+    const formatter = options.itemFormatter || ((item) => String(item));
+    let text = '';
+    if (options.title) {
+        text += `## ${options.title}\n\n`;
+    }
+    for (const item of items) {
+        text += `- ${formatter(item)}\n`;
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text
+            }
+        ]
+    };
+};
+//# sourceMappingURL=formatters.js.map

package/dist/adapters/mcp/formatters.js.map

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

package/dist/adapters/mcp/from-api-endpoint.d.ts

@@ -0,0 +1,59 @@
+/**
+ * MCP Tool Helper: fromApiEndpoint
+ *
+ * Creates an MCP tool that directly calls a Vibes API endpoint.
+ * Handles request transformation, authentication, and response formatting.
+ */
+import type { McpTool } from './vibes-types.ts';
+import type { McpToolContext } from './context.ts';
+import { type JsonObject, type JsonValue } from '@vibesdotdev/kernel/schemas/json';
+import type { McpInputSchema, McpResponseFormatter } from './formatters.ts';
+import { type RequestBody } from '@vibesdotdev/client/schemas';
+/**
+ * Request transformer - converts MCP args to API request options
+ */
+export interface ApiRequestTransform {
+    /** Query parameters */
+    query?: JsonObject | ((args: JsonValue) => JsonObject);
+    /** URL path parameters */
+    params?: JsonObject | ((args: JsonValue) => JsonObject);
+    /** Request body */
+    body?: RequestBody | ((args: JsonValue) => RequestBody);
+    /** Additional headers */
+    headers?: Record<string, string> | ((args: JsonValue) => Record<string, string>);
+}
+/**
+ * Configuration for fromApiEndpoint helper
+ */
+export interface FromApiEndpointConfig<TResponse = unknown> {
+    /** Tool name */
+    name: string;
+    /** Tool description */
+    description: string;
+    /** HTTP method */
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    /** API endpoint path (e.g., '/api/knowledge') */
+    path: string | ((args: JsonValue, context: McpToolContext) => string);
+    /** Whether tool requires authentication */
+    auth?: boolean;
+    /** Input parameter schema */
+    input?: McpInputSchema;
+    /** Output schema for structured, machine-parseable results (June 2025 MCP spec) */
+    outputSchema?: {
+        type: 'object';
+        properties?: Record<string, JsonObject>;
+        required?: string[];
+    };
+    /** Request transformation */
+    transform?: {
+        /** Transform MCP args to API request options */
+        request?: (args: JsonValue, context: McpToolContext) => ApiRequestTransform;
+        /** Format API response for MCP */
+        response?: McpResponseFormatter<TResponse>;
+    };
+}
+/**
+ * Create an MCP tool from an API endpoint
+ */
+export declare function fromApiEndpoint<TResponse = unknown>(config: FromApiEndpointConfig<TResponse>): McpTool;
+//# sourceMappingURL=from-api-endpoint.d.ts.map

package/dist/adapters/mcp/from-api-endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-api-endpoint.d.ts","sourceRoot":"","sources":["../../../src/adapters/mcp/from-api-endpoint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAInD,OAAO,EAAoB,KAAK,UAAU,EAAE,KAAK,SAAS,EAAmB,MAAM,kCAAkC,CAAC;AAEtH,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE5E,OAAO,EAAgF,KAAK,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAuB7I;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,uBAAuB;IACvB,KAAK,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,KAAK,UAAU,CAAC,CAAC;IACvD,0BAA0B;IAC1B,MAAM,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,KAAK,UAAU,CAAC,CAAC;IACxD,mBAAmB;IACnB,IAAI,CAAC,EAAE,WAAW,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,KAAK,WAAW,CAAC,CAAC;IACxD,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACjF;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB,CAAC,SAAS,GAAG,OAAO;IACzD,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpD,iDAAiD;IACjD,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,KAAK,MAAM,CAAC,CAAC;IACtE,2CAA2C;IAC3C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,6BAA6B;IAC7B,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,mFAAmF;IACnF,YAAY,CAAC,EAAE;QACd,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,6BAA6B;IAC7B,SAAS,CAAC,EAAE;QACX,gDAAgD;QAChD,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,KAAK,mBAAmB,CAAC;QAC5E,kCAAkC;QAClC,QAAQ,CAAC,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;KAC3C,CAAC;CACF;AA4DD;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,GAAG,OAAO,EAClD,MAAM,EAAE,qBAAqB,CAAC,SAAS,CAAC,GACtC,OAAO,CA+HT"}

package/dist/adapters/mcp/from-api-endpoint.js

@@ -0,0 +1,206 @@
+/**
+ * MCP Tool Helper: fromApiEndpoint
+ *
+ * Creates an MCP tool that directly calls a Vibes API endpoint.
+ * Handles request transformation, authentication, and response formatting.
+ */
+import { ApiStatusSchema } from "../../schemas/api-endpoint.js";
+import { CapabilityError, CaughtFailureSchema, isCapabilityError, settle, settleNow } from '@vibesdotdev/kernel';
+import { JsonObjectSchema, JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+import { McpAuthError, McpToolError } from '@vibesdotdev/mcp/errors';
+import { defaultFormatter } from "./formatters.js";
+import { PathParamsSchema, QuerySchema, readClientRequestBody } from '@vibesdotdev/client/schemas';
+function isClientLikeError(error) {
+    return error instanceof Error && error.name === 'ClientError';
+}
+/** The capability code an API status projects to. */
+function capabilityCodeForStatus(status) {
+    if (status === 400 || status === 422)
+        return 'INVALID_INPUT';
+    if (status === 401)
+        return 'AUTH_REQUIRED';
+    if (status === 403)
+        return 'PERMISSION_DENIED';
+    if (status === 404)
+        return 'NOT_FOUND';
+    if (status === 409)
+        return 'CONFLICT';
+    if (status === 429)
+        return 'RATE_LIMITED';
+    if (status === 408 || status === 504)
+        return 'TIMEOUT';
+    if (status >= 500)
+        return 'UNAVAILABLE';
+    return 'INTERNAL';
+}
+function admitQuery(value) {
+    const parsed = QuerySchema.safeParse(value);
+    if (!parsed.success) {
+        throw new CapabilityError('the API query is invalid', 'INVALID_INPUT', { reason: 'mcp-api-query-invalid' });
+    }
+    return parsed.data;
+}
+function admitParams(value) {
+    const parsed = PathParamsSchema.safeParse(value);
+    if (!parsed.success) {
+        throw new CapabilityError('the API params are invalid', 'INVALID_INPUT', { reason: 'mcp-api-params-invalid' });
+    }
+    return parsed.data;
+}
+function isArgsFunction(value) {
+    return typeof value === 'function';
+}
+function isPathFunction(path) {
+    return typeof path === 'function';
+}
+function readJsonArgs(args) {
+    const parsed = JsonObjectSchema.safeParse(args);
+    if (!parsed.success) {
+        throw new CapabilityError('the API arguments are invalid', 'INVALID_INPUT', { reason: 'mcp-api-args-invalid' });
+    }
+    return parsed.data;
+}
+function schemaProperties(properties) {
+    const accepted = {};
+    for (const [key, value] of Object.entries(properties)) {
+        const parsed = JsonObjectSchema.safeParse(value);
+        if (parsed.success)
+            accepted[key] = parsed.data;
+    }
+    return accepted;
+}
+function toolInputSchema(input) {
+    if (!input) {
+        return { type: 'object', properties: {}, additionalProperties: true };
+    }
+    const schema = {
+        type: 'object',
+        properties: input.properties ? schemaProperties(input.properties) : {}
+    };
+    if (input.required)
+        schema.required = input.required;
+    if (input.additionalProperties !== undefined)
+        schema.additionalProperties = input.additionalProperties;
+    return schema;
+}
+/**
+ * Create an MCP tool from an API endpoint
+ */
+export function fromApiEndpoint(config) {
+    const { name, description, method, path, auth = true, input, transform } = config;
+    return {
+        definition: {
+            name,
+            description,
+            inputSchema: toolInputSchema(input),
+            ...(config.outputSchema && { outputSchema: config.outputSchema })
+        },
+        requiresAuth: auth,
+        handler: async (context, args) => {
+            let queryArgs;
+            if (method === 'GET' || method === 'DELETE') {
+                const admittedArgs = settleNow(() => readJsonArgs(args));
+                if (!admittedArgs.ok) {
+                    throw new McpToolError('the API arguments are invalid', name, {
+                        code: 'INVALID_INPUT',
+                        reason: 'mcp-api-args-invalid',
+                        cause: CaughtFailureSchema.parse(admittedArgs.cause)
+                    });
+                }
+                queryArgs = admittedArgs.value;
+            }
+            // Check authentication
+            if (auth && !context.user) {
+                throw new McpAuthError(`Tool '${name}' requires authentication`);
+            }
+            // Check API client availability
+            if (!context.api) {
+                throw new McpToolError('API client not available. Make sure MCP server is running with CLI context.', name);
+            }
+            const api = context.api;
+            const attempted = await settle(async () => {
+                let transformArgs = null;
+                if (transform?.request || isPathFunction(path)) {
+                    const admitted = settleNow(() => JsonValueSchema.parse(args));
+                    if (!admitted.ok) {
+                        throw new McpToolError('the API request body is invalid', name, {
+                            code: 'INVALID_INPUT',
+                            reason: 'mcp-api-body-invalid',
+                            cause: CaughtFailureSchema.parse(admitted.cause)
+                        });
+                    }
+                    transformArgs = admitted.value;
+                }
+                const resolvedPath = isPathFunction(path) ? path(transformArgs, context) : path;
+                const requestOptions = {
+                    method,
+                    query: {},
+                    params: {},
+                    headers: {}
+                };
+                if (transform?.request) {
+                    const transformed = transform.request(transformArgs, context);
+                    if (transformed.query) {
+                        const query = isArgsFunction(transformed.query)
+                            ? transformed.query(transformArgs)
+                            : transformed.query;
+                        requestOptions.query = admitQuery(query);
+                    }
+                    if (transformed.params) {
+                        const params = isArgsFunction(transformed.params)
+                            ? transformed.params(transformArgs)
+                            : transformed.params;
+                        requestOptions.params = admitParams(params);
+                    }
+                    if (transformed.body !== undefined) {
+                        const body = isArgsFunction(transformed.body)
+                            ? transformed.body(transformArgs)
+                            : transformed.body;
+                        requestOptions.body = readClientRequestBody(body);
+                    }
+                    if (transformed.headers) {
+                        requestOptions.headers = isArgsFunction(transformed.headers)
+                            ? transformed.headers(transformArgs)
+                            : transformed.headers;
+                    }
+                }
+                else if (queryArgs) {
+                    requestOptions.query = admitQuery(queryArgs);
+                }
+                else {
+                    requestOptions.body = readClientRequestBody(args);
+                }
+                const response = await api.request(resolvedPath, requestOptions);
+                const formatter = transform?.response || defaultFormatter;
+                return await formatter(response);
+            });
+            if (attempted.ok)
+                return attempted.value;
+            const failure = attempted.cause;
+            if (failure instanceof McpAuthError || failure instanceof McpToolError)
+                throw failure;
+            const caught = CaughtFailureSchema.parse(failure);
+            if (isCapabilityError(caught) && caught.reason === 'client-body-invalid') {
+                throw new McpToolError('the API request body is invalid', name, {
+                    code: 'INVALID_INPUT', reason: 'mcp-api-body-invalid', cause: caught
+                });
+            }
+            if (isCapabilityError(caught) && (caught.reason === 'mcp-api-query-invalid' || caught.reason === 'mcp-api-params-invalid' || caught.reason === 'mcp-api-args-invalid')) {
+                throw new McpToolError('the API request is invalid', name, {
+                    code: 'INVALID_INPUT', reason: caught.reason, cause: caught
+                });
+            }
+            const status = isClientLikeError(failure) ? ApiStatusSchema.safeParse(failure.status) : undefined;
+            if (status?.success) {
+                throw new McpToolError(`the API refused the request (status ${status.data})`, name, {
+                    code: capabilityCodeForStatus(status.data),
+                    reason: 'mcp-api-refused',
+                    details: { status: status.data },
+                    cause: failure
+                });
+            }
+            throw new McpToolError('the API request failed', name, { reason: 'mcp-api-failed', cause: failure });
+        }
+    };
+}
+//# sourceMappingURL=from-api-endpoint.js.map