@cleocode/lafs 2026.3.74 → 2026.4.3

package/dist/src/mcpAdapter.js

@@ -1,281 +0,0 @@
-import { randomUUID } from "node:crypto";
-/**
- * Extract result from MCP content array
- * Attempts to parse JSON content, falls back to text representation
- */
-function extractResultFromContent(content) {
-    if (!content || content.length === 0) {
-        return null;
-    }
-    // Combine all text content
-    const textParts = [];
-    const otherContent = [];
-    for (const item of content) {
-        if (item.type === "text" && item.text) {
-            textParts.push(item.text);
-        }
-        else {
-            otherContent.push(item);
-        }
-    }
-    // Try to parse as JSON if single text item looks like JSON
-    if (textParts.length === 1) {
-        const text = textParts[0]?.trim() ?? "";
-        if (text.startsWith("{") || text.startsWith("[")) {
-            try {
-                const parsed = JSON.parse(text);
-                if (typeof parsed === "object" && parsed !== null) {
-                    return parsed;
-                }
-            }
-            catch {
-                // Not valid JSON, treat as text
-            }
-        }
-    }
-    // Combine into result object
-    const result = {};
-    if (textParts.length > 0) {
-        result.text = textParts.length === 1 ? textParts[0] : textParts.join("\n");
-    }
-    if (otherContent.length > 0) {
-        result.content = otherContent;
-    }
-    return result;
-}
-/**
- * Estimate token count from content
- * Rough estimation: ~4 characters per token
- */
-function estimateTokens(content) {
-    if (!content)
-        return 0;
-    const jsonString = JSON.stringify(content);
-    return Math.ceil(jsonString.length / 4);
-}
-/**
- * Truncate content to fit within budget
- */
-function truncateToBudget(content, budget) {
-    if (!content)
-        return { result: null, truncated: false, originalEstimate: 0 };
-    const originalEstimate = estimateTokens(content);
-    if (originalEstimate <= budget) {
-        return { result: content, truncated: false, originalEstimate };
-    }
-    // Calculate truncation ratio
-    const ratio = budget / originalEstimate;
-    const jsonString = JSON.stringify(content);
-    const targetLength = Math.floor(jsonString.length * ratio);
-    // Truncate the string and try to make it valid JSON
-    let truncated = jsonString.slice(0, targetLength);
-    // Close any open structures
-    const openBraces = (truncated.match(/\{/g) || []).length - (truncated.match(/\}/g) || []).length;
-    const openBrackets = (truncated.match(/\[/g) || []).length - (truncated.match(/\]/g) || []).length;
-    truncated += "}".repeat(Math.max(0, openBraces));
-    truncated += "]".repeat(Math.max(0, openBrackets));
-    try {
-        const parsed = JSON.parse(truncated);
-        // Add truncation notice
-        if (typeof parsed === "object" && parsed !== null) {
-            parsed["_truncated"] = true;
-            parsed["_originalTokens"] = originalEstimate;
-            parsed["_budget"] = budget;
-        }
-        return { result: parsed, truncated: true, originalEstimate };
-    }
-    catch {
-        // If parsing fails, return minimal result
-        return {
-            result: {
-                _truncated: true,
-                _error: "Content truncated due to budget constraints",
-                _originalTokens: originalEstimate,
-                _budget: budget,
-            },
-            truncated: true,
-            originalEstimate,
-        };
-    }
-}
-/**
- * Convert MCP error to LAFS error format
- */
-function convertMCPErrorToLAFS(mcpResult, operation) {
-    const content = mcpResult.content;
-    const errorText = content
-        .filter((item) => item.type === "text" && typeof item.text === "string")
-        .map((item) => item.text)
-        .join("\n");
-    // Determine error category based on error text
-    let category = "INTERNAL";
-    let code = "E_MCP_INTERNAL_ERROR";
-    let retryable = false;
-    let retryAfterMs = null;
-    const errorLower = errorText.toLowerCase();
-    if (errorLower.includes("not found") || errorLower.includes("doesn't exist") || errorLower.includes("does not exist")) {
-        category = "NOT_FOUND";
-        code = "E_MCP_NOT_FOUND";
-    }
-    else if (errorLower.includes("rate limit") || errorLower.includes("too many requests")) {
-        category = "RATE_LIMIT";
-        code = "E_MCP_RATE_LIMIT";
-        retryable = true;
-        retryAfterMs = 60000; // 1 minute default
-    }
-    else if (errorLower.includes("auth") || errorLower.includes("unauthorized") || errorLower.includes("forbidden")) {
-        category = "AUTH";
-        code = "E_MCP_AUTH_ERROR";
-    }
-    else if (errorLower.includes("permission") || errorLower.includes("access denied")) {
-        category = "PERMISSION";
-        code = "E_MCP_PERMISSION_DENIED";
-    }
-    else if (errorLower.includes("validation") || errorLower.includes("invalid")) {
-        category = "VALIDATION";
-        code = "E_MCP_VALIDATION_ERROR";
-    }
-    else if (errorLower.includes("timeout") || errorLower.includes("transient")) {
-        category = "TRANSIENT";
-        code = "E_MCP_TRANSIENT_ERROR";
-        retryable = true;
-        retryAfterMs = 5000; // 5 seconds
-    }
-    return {
-        code,
-        message: errorText || "MCP tool execution failed",
-        category,
-        retryable,
-        retryAfterMs,
-        details: {
-            operation,
-            mcpError: true,
-            contentTypes: content.map((c) => c.type),
-        },
-    };
-}
-/**
- * Wrap MCP tool result in LAFS envelope
- *
- * @param mcpResult - The raw MCP CallToolResult
- * @param operation - The operation name (tool name)
- * @param budget - Optional token budget for response
- * @returns LAFS-compliant envelope
- */
-export function wrapMCPResult(mcpResult, operation, budget) {
-    const requestId = randomUUID();
-    const timestamp = new Date().toISOString();
-    // Build base meta
-    const meta = {
-        specVersion: "1.0.0",
-        schemaVersion: "1.0.0",
-        timestamp,
-        operation,
-        requestId,
-        transport: "sdk",
-        strict: true,
-        mvi: "standard",
-        contextVersion: 1,
-    };
-    // Handle MCP error
-    if (mcpResult.isError) {
-        const error = convertMCPErrorToLAFS(mcpResult, operation);
-        return {
-            $schema: "https://lafs.dev/schemas/v1/envelope.schema.json",
-            _meta: meta,
-            success: false,
-            result: null,
-            error,
-        };
-    }
-    // Extract result from MCP content
-    let result = extractResultFromContent(mcpResult.content);
-    let truncated = false;
-    let originalEstimate = 0;
-    let extensions;
-    // Apply budget enforcement if specified
-    if (budget !== undefined && budget > 0) {
-        const budgetResult = truncateToBudget(result, budget);
-        result = budgetResult.result;
-        truncated = budgetResult.truncated;
-        originalEstimate = budgetResult.originalEstimate;
-        // Put token estimate in extensions to comply with strict schema
-        extensions = {
-            "x-mcp-token-estimate": {
-                estimated: truncated ? budget : originalEstimate,
-                truncated,
-                originalEstimate: truncated ? originalEstimate : undefined,
-            },
-        };
-    }
-    return {
-        $schema: "https://lafs.dev/schemas/v1/envelope.schema.json",
-        _meta: meta,
-        success: true,
-        result,
-        error: null,
-        _extensions: extensions,
-    };
-}
-/**
- * Create a LAFS error envelope for MCP adapter errors
- *
- * @param message - Error message
- * @param operation - The operation being performed
- * @param category - Error category
- * @returns LAFS error envelope
- */
-export function createAdapterErrorEnvelope(message, operation, category = "INTERNAL") {
-    const requestId = randomUUID();
-    const timestamp = new Date().toISOString();
-    const error = {
-        code: "E_MCP_ADAPTER_ERROR",
-        message,
-        category,
-        retryable: category === "TRANSIENT" || category === "RATE_LIMIT",
-        retryAfterMs: category === "RATE_LIMIT" ? 60000 : category === "TRANSIENT" ? 5000 : null,
-        details: {
-            operation,
-            adapterError: true,
-        },
-    };
-    return {
-        $schema: "https://lafs.dev/schemas/v1/envelope.schema.json",
-        _meta: {
-            specVersion: "1.0.0",
-            schemaVersion: "1.0.0",
-            timestamp,
-            operation,
-            requestId,
-            transport: "sdk",
-            strict: true,
-            mvi: "standard",
-            contextVersion: 1,
-        },
-        success: false,
-        result: null,
-        error,
-    };
-}
-/**
- * Type guard to check if content is TextContent
- */
-export function isTextContent(content) {
-    return (typeof content === "object" &&
-        content !== null &&
-        "type" in content &&
-        content.type === "text" &&
-        "text" in content &&
-        typeof content.text === "string");
-}
-/**
- * Parse MCP text content as JSON if possible
- */
-export function parseMCPTextContent(content) {
-    try {
-        return JSON.parse(content.text);
-    }
-    catch {
-        return content.text;
-    }
-}