@winspan/claude-forge 8.35.0 → 8.37.0

package/dist/intelligence/multimodal-parser.js

@@ -0,0 +1,425 @@
+/**
+ * MultimodalParser — turns a raw user prompt into a structured multimodal input.
+ *
+ * Responsibilities:
+ *   1. Detect `[Image #N]` markers and markdown image references in the prompt.
+ *   2. Resolve those references to absolute file paths (defaulting to the
+ *      Claude Code image cache at `~/.claude/image-cache/<session>/<n>.<ext>`).
+ *   3. Sniff the file header to determine a supported media type
+ *      (PNG / JPEG / GIF / WebP).
+ *   4. Call `AIProvider.completeWithImage` in parallel for every resolved image
+ *      and parse the JSON response into a typed `ImageAnalysis`.
+ *   5. Extract fenced code blocks (```lang...```), preserving language and
+ *      their 1-based line position within the original prompt.
+ *   6. Produce a plain-text view of the prompt with markers and code fences
+ *      stripped, suitable for downstream classification.
+ *
+ * Failure model: this module never throws on missing files, unsupported media
+ * types, network errors, or malformed Vision JSON. Each failure is recorded in
+ * `meta.errors` and the analysis falls back to a neutral default
+ * (`screenshotType: 'unknown'`, empty fields) so the classifier can still run
+ * on text alone.
+ */
+import { promises as fs } from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { logger } from '../core/utils/logger.js';
+// ---------------------------------------------------------------------------
+// Constants & regexes
+// ---------------------------------------------------------------------------
+const DEFAULT_VISION_TIMEOUT_MS = 10_000;
+const DEFAULT_VISION_MAX_TOKENS = 1024;
+/** Order matters in the cache lookup: most likely first to short-circuit. */
+const CACHE_IMAGE_EXTENSIONS = ['png', 'jpg', 'jpeg', 'gif', 'webp'];
+/** Magic-number prefix table used by `detectMediaType`. */
+const MAGIC_PREFIXES = [
+    { media: 'image/png', bytes: [0x89, 0x50, 0x4e, 0x47] },
+    { media: 'image/jpeg', bytes: [0xff, 0xd8, 0xff] },
+    { media: 'image/gif', bytes: [0x47, 0x49, 0x46, 0x38] },
+];
+const SCREENSHOT_TYPES = new Set([
+    'ui', 'terminal', 'code', 'error', 'diagram', 'unknown',
+]);
+const IMAGE_MARKER_RE = /\[Image\s+#(\d+)\]/gi;
+const MARKDOWN_IMAGE_RE = /!\[([^\]]*)\]\(([^)\s]+)(?:\s+"[^"]*")?\)/g;
+/**
+ * Fenced code block: opening ``` plus optional language + newline, body
+ * (non-greedy), then closing ```. Tolerates CRLF and missing trailing newline.
+ */
+const FENCED_BLOCK_RE = /```([a-zA-Z0-9_+\-#.]*)[ \t]*\r?\n([\s\S]*?)\r?\n?```/g;
+// ---------------------------------------------------------------------------
+// Vision prompt — kept module-level so it's easy to inspect / snapshot in tests.
+// ---------------------------------------------------------------------------
+export const VISION_ANALYSIS_PROMPT = `Analyze this screenshot and respond with ONLY a JSON object:
+
+{
+  "screenshotType": "ui|terminal|code|error|diagram|unknown",
+  "ocrText": "all visible text",
+  "visibleElements": ["element1", "element2"],
+  "errorMessages": ["error1"],
+  "semanticDescription": "one sentence describing what this screenshot shows"
+}
+
+Guidelines:
+- screenshotType: "ui" = web/desktop UI; "terminal" = CLI output; "code" = code editor; "error" = error dialog/page; "diagram" = chart/diagram
+- ocrText: extract ALL visible text, line by line
+- visibleElements: identify UI components (buttons, menus, tabs, etc.), for UI screenshots
+- errorMessages: extract error messages, stack traces, warnings if visible
+- semanticDescription: explain WHAT this screenshot tells us (e.g., "shows methodology execution page that should have been removed")
+
+Respond with the JSON only — no prose, no markdown fences.`;
+/** Per-call clone of the magic-prefix table so we can also handle WebP separately. */
+function matchesPrefix(buf, prefix) {
+    if (buf.length < prefix.length)
+        return false;
+    for (let i = 0; i < prefix.length; i++) {
+        if (buf[i] !== prefix[i])
+            return false;
+    }
+    return true;
+}
+/** Read the first 12 bytes of a file and map them to a supported media type. */
+export async function detectMediaType(filePath) {
+    let handle;
+    try {
+        handle = await fs.open(filePath, 'r');
+        const buffer = Buffer.alloc(12);
+        const { bytesRead } = await handle.read(buffer, 0, 12, 0);
+        if (bytesRead < 3)
+            return undefined;
+        const head = buffer.subarray(0, bytesRead);
+        for (const { media, bytes } of MAGIC_PREFIXES) {
+            if (matchesPrefix(head, bytes))
+                return media;
+        }
+        // WebP: RIFF....WEBP — needs the 12-byte window.
+        if (bytesRead >= 12
+            && matchesPrefix(head, [0x52, 0x49, 0x46, 0x46])
+            && head[8] === 0x57 && head[9] === 0x45 && head[10] === 0x42 && head[11] === 0x50) {
+            return 'image/webp';
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+    finally {
+        await handle?.close().catch(() => {
+            /* best-effort close */
+        });
+    }
+}
+/** Look in `<cacheRoot>/<session>/<n>.<ext>` for the most recent match. */
+export async function defaultResolveCachedImage(marker, cacheRoot) {
+    const numMatch = /#(\d+)/.exec(marker);
+    if (!numMatch)
+        return undefined;
+    const n = numMatch[1];
+    const root = cacheRoot ?? path.join(os.homedir(), '.claude', 'image-cache');
+    let sessionDirs;
+    try {
+        sessionDirs = await fs.readdir(root);
+    }
+    catch {
+        return undefined;
+    }
+    const candidates = [];
+    for (const entry of sessionDirs) {
+        const sessionPath = path.join(root, entry);
+        try {
+            const sessionStat = await fs.stat(sessionPath);
+            if (!sessionStat.isDirectory())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        for (const ext of CACHE_IMAGE_EXTENSIONS) {
+            const candidate = path.join(sessionPath, `${n}.${ext}`);
+            try {
+                const fileStat = await fs.stat(candidate);
+                if (fileStat.isFile()) {
+                    candidates.push({ filePath: candidate, mtimeMs: fileStat.mtimeMs });
+                }
+            }
+            catch {
+                // file absent — keep searching
+            }
+        }
+    }
+    if (candidates.length === 0)
+        return undefined;
+    candidates.sort((a, b) => b.mtimeMs - a.mtimeMs);
+    return candidates[0].filePath;
+}
+/** Compute 1-based line number for a byte offset within `text`. */
+function lineNumberAt(text, offset) {
+    if (offset <= 0)
+        return 1;
+    let line = 1;
+    const end = Math.min(offset, text.length);
+    for (let i = 0; i < end; i++) {
+        if (text.charCodeAt(i) === 0x0a /* \n */)
+            line++;
+    }
+    return line;
+}
+/** Extract fenced code blocks. Indented-style blocks are intentionally ignored. */
+export function extractCodeBlocks(prompt) {
+    const blocks = [];
+    const re = new RegExp(FENCED_BLOCK_RE.source, FENCED_BLOCK_RE.flags);
+    let match;
+    while ((match = re.exec(prompt)) !== null) {
+        const rawLang = match[1] ?? '';
+        const content = (match[2] ?? '').replace(/\r?\n$/, '');
+        blocks.push({
+            language: rawLang.length > 0 ? rawLang.toLowerCase() : undefined,
+            content,
+            startLine: lineNumberAt(prompt, match.index),
+        });
+    }
+    return blocks;
+}
+/** Extract `[Image #N]` markers preserving prompt order and duplicates. */
+function extractImageMarkers(prompt) {
+    const found = [];
+    const re = new RegExp(IMAGE_MARKER_RE.source, IMAGE_MARKER_RE.flags);
+    let match;
+    while ((match = re.exec(prompt)) !== null) {
+        found.push(match[0]);
+    }
+    return found;
+}
+/** Extract markdown image references (`![alt](path)`), preserving order. */
+function extractMarkdownImages(prompt) {
+    const found = [];
+    const re = new RegExp(MARKDOWN_IMAGE_RE.source, MARKDOWN_IMAGE_RE.flags);
+    let match;
+    while ((match = re.exec(prompt)) !== null) {
+        found.push({ alt: match[1] ?? '', path: match[2] });
+    }
+    return found;
+}
+/** Build the prompt with image references and fenced code blocks removed. */
+function stripMarkersAndBlocks(prompt) {
+    return prompt
+        .replace(new RegExp(FENCED_BLOCK_RE.source, FENCED_BLOCK_RE.flags), '')
+        .replace(new RegExp(MARKDOWN_IMAGE_RE.source, MARKDOWN_IMAGE_RE.flags), '')
+        .replace(new RegExp(IMAGE_MARKER_RE.source, IMAGE_MARKER_RE.flags), '')
+        .replace(/[ \t]+\n/g, '\n')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+}
+function isScreenshotType(val) {
+    return typeof val === 'string' && SCREENSHOT_TYPES.has(val);
+}
+function asStringArray(val) {
+    if (!Array.isArray(val))
+        return [];
+    return val.filter((x) => typeof x === 'string');
+}
+/**
+ * Parse the JSON object returned by the Vision call. Tolerates surrounding
+ * prose / markdown fences. Returns `null` if no JSON object can be recovered.
+ */
+export function parseVisionResponse(text) {
+    if (!text)
+        return null;
+    let candidate = text.trim();
+    // Strip ```json ... ``` fences if present.
+    const fenceMatch = /```(?:json)?\s*\r?\n?([\s\S]*?)\r?\n?```/i.exec(candidate);
+    if (fenceMatch)
+        candidate = fenceMatch[1].trim();
+    // If still not pure JSON, try to recover the first {...} block.
+    if (!candidate.startsWith('{')) {
+        const firstBrace = candidate.indexOf('{');
+        const lastBrace = candidate.lastIndexOf('}');
+        if (firstBrace === -1 || lastBrace === -1 || lastBrace <= firstBrace)
+            return null;
+        candidate = candidate.slice(firstBrace, lastBrace + 1);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(candidate);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== 'object' || parsed === null)
+        return null;
+    const obj = parsed;
+    return {
+        screenshotType: isScreenshotType(obj.screenshotType) ? obj.screenshotType : 'unknown',
+        ocrText: typeof obj.ocrText === 'string' ? obj.ocrText : '',
+        visibleElements: asStringArray(obj.visibleElements),
+        errorMessages: asStringArray(obj.errorMessages),
+        semanticDescription: typeof obj.semanticDescription === 'string' ? obj.semanticDescription : '',
+    };
+}
+function defaultAnalysis(imagePath, analysisMs) {
+    return {
+        imagePath,
+        screenshotType: 'unknown',
+        ocrText: '',
+        visibleElements: [],
+        errorMessages: [],
+        semanticDescription: '',
+        analysisMs,
+    };
+}
+// ---------------------------------------------------------------------------
+// MultimodalParser
+// ---------------------------------------------------------------------------
+export class MultimodalParser {
+    ai;
+    visionTimeoutMs;
+    visionModel;
+    customResolver;
+    imageCacheDir;
+    constructor(ai, options) {
+        this.ai = ai;
+        this.visionTimeoutMs = options?.visionTimeoutMs ?? DEFAULT_VISION_TIMEOUT_MS;
+        this.visionModel = options?.visionModel;
+        this.customResolver = options?.imagePathResolver;
+        this.imageCacheDir = options?.imageCacheDir;
+    }
+    /** Main entry point. See module header for the failure model. */
+    async parse(prompt) {
+        const start = Date.now();
+        const errors = [];
+        // --- 1. Pure-text artifacts (code blocks + stripped text) -------------
+        const codeBlocks = extractCodeBlocks(prompt);
+        const textWithoutMarkers = stripMarkersAndBlocks(prompt);
+        // --- 2. Collect image references --------------------------------------
+        const markerTokens = extractImageMarkers(prompt);
+        const markdownImages = extractMarkdownImages(prompt);
+        const imagesFound = markerTokens.length + markdownImages.length;
+        if (imagesFound === 0) {
+            return {
+                originalText: prompt,
+                textWithoutMarkers,
+                images: [],
+                codeBlocks,
+                meta: {
+                    parseMs: Date.now() - start,
+                    imagesFound: 0,
+                    imagesAnalyzed: 0,
+                    codeBlocksFound: codeBlocks.length,
+                    errors,
+                },
+            };
+        }
+        // --- 3. Resolve marker -> path (custom resolver, then default cache) --
+        const references = [];
+        for (const marker of markerTokens) {
+            const custom = this.customResolver?.(marker);
+            if (custom) {
+                references.push({ marker, resolvedPath: custom });
+                continue;
+            }
+            const fromCache = await defaultResolveCachedImage(marker, this.imageCacheDir);
+            if (fromCache) {
+                references.push({ marker, resolvedPath: fromCache });
+            }
+            else {
+                const reason = `Could not resolve ${marker} to a file path`;
+                references.push({ marker, resolutionError: reason });
+                errors.push(reason);
+            }
+        }
+        for (const md of markdownImages) {
+            // Markdown image paths are already explicit; expand `~` for convenience.
+            const expanded = md.path.startsWith('~/')
+                ? path.join(os.homedir(), md.path.slice(2))
+                : md.path;
+            references.push({ marker: `![${md.alt}](${md.path})`, resolvedPath: expanded });
+        }
+        // --- 4. Vision analysis (parallel) ------------------------------------
+        let images = [];
+        let imagesAnalyzed = 0;
+        const visionFn = this.ai?.completeWithImage?.bind(this.ai);
+        if (!visionFn) {
+            if (references.some((r) => r.resolvedPath)) {
+                errors.push('AI provider not configured for vision; skipped image analysis');
+            }
+        }
+        else {
+            const tasks = references.map((ref) => this.analyzeImage(ref, visionFn, errors));
+            const settled = await Promise.all(tasks);
+            const successes = [];
+            for (const result of settled) {
+                if (!result)
+                    continue;
+                successes.push(result.analysis);
+                if (result.success)
+                    imagesAnalyzed++;
+            }
+            images = successes;
+        }
+        return {
+            originalText: prompt,
+            textWithoutMarkers,
+            images,
+            codeBlocks,
+            meta: {
+                parseMs: Date.now() - start,
+                imagesFound,
+                imagesAnalyzed,
+                codeBlocksFound: codeBlocks.length,
+                errors,
+            },
+        };
+    }
+    /**
+     * Analyze a single image. Returns `null` only when path resolution failed
+     * upstream (we already pushed an error for that case). Otherwise returns
+     * an analysis plus a `success` flag indicating whether Vision actually
+     * returned a usable JSON payload.
+     */
+    async analyzeImage(ref, completeWithImage, errors) {
+        if (!ref.resolvedPath)
+            return null;
+        const imagePath = ref.resolvedPath;
+        const started = Date.now();
+        // Make sure the file actually exists & is a supported format before we
+        // burn an API call on it.
+        const mediaType = await detectMediaType(imagePath);
+        if (!mediaType) {
+            errors.push(`Skipped ${ref.marker}: file missing or unsupported media type (${imagePath})`);
+            return { analysis: defaultAnalysis(imagePath, Date.now() - started), success: false };
+        }
+        try {
+            const response = await completeWithImage(VISION_ANALYSIS_PROMPT, {
+                images: [{ path: imagePath, mediaType }],
+                timeoutMs: this.visionTimeoutMs,
+                maxTokens: DEFAULT_VISION_MAX_TOKENS,
+                ...(this.visionModel ? { model: this.visionModel } : {}),
+            });
+            const parsed = parseVisionResponse(response);
+            const analysisMs = Date.now() - started;
+            if (!parsed) {
+                errors.push(`Vision response for ${ref.marker} was not valid JSON; using defaults`);
+                return { analysis: defaultAnalysis(imagePath, analysisMs), success: false };
+            }
+            return {
+                analysis: {
+                    imagePath,
+                    screenshotType: parsed.screenshotType,
+                    ocrText: parsed.ocrText,
+                    visibleElements: parsed.visibleElements,
+                    errorMessages: parsed.errorMessages,
+                    semanticDescription: parsed.semanticDescription,
+                    analysisMs,
+                },
+                success: true,
+            };
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            logger.warn(`[MultimodalParser] vision call failed for ${imagePath}: ${reason}`);
+            errors.push(`Vision call failed for ${ref.marker}: ${reason}`);
+            return { analysis: defaultAnalysis(imagePath, Date.now() - started), success: false };
+        }
+    }
+}
+//# sourceMappingURL=multimodal-parser.js.map

package/dist/intelligence/multimodal-parser.js.map

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

package/dist/mcp/server.d.ts

@@ -0,0 +1,58 @@
+/**
+ * MCP Server for claude-forge
+ *
+ * 嵌入在 daemon 进程内，通过 HTTP（Streamable HTTP transport）向 Claude Code
+ * 暴露以下工具：
+ *   - skill_invoke：Agent 按需获取某个 Skill 的方法论内容
+ *   - skill_list：列出所有可用 Skill（id / name / description / keywords）
+ *
+ * 调用链路：
+ *   Claude Code → HTTP POST /mcp → MCP server → skillInvoke()/skillList()
+ *                                            → writeSkillInvocation() 记录
+ *
+ * 设计要点：
+ *   - 复用现有 Express app（不新增端口），路径前缀固定为 /mcp
+ *   - 沿用 daemon auth token（Bearer），与 /api 写操作同一鉴权链路
+ *   - Stateless 模式：每个请求开一对 server/transport，避免长连接污染
+ *     daemon 主循环；Skill 调用本身是短平快、无需流式推送的场景
+ *   - Session 追踪：优先 header `X-Forge-Session-Id`，缺失时回落到
+ *     routingState 中最近一次活跃路由（heuristic，第一阶段足够）
+ */
+import type { Application, Request } from 'express';
+import type { SkillRegistry } from '../skills/registry.js';
+import type { SQLiteStorage } from '../core/storage/sqlite.js';
+import type { InvocationGuard } from '../skills/invocation-guard.js';
+/** Resolved session context for a single MCP tool call. */
+export interface SessionContext {
+    sessionId: string | null;
+    routeRequestId: string | null;
+    agentId: string | null;
+}
+export interface McpServerOptions {
+    skillRegistry: SkillRegistry;
+    storage: SQLiteStorage;
+    guard?: InvocationGuard;
+    /**
+     * Override the session-resolution strategy. Default behavior:
+     *   1. Read header `X-Forge-Session-Id` (passed by the harness if available)
+     *   2. Fallback: pick the freshest live routing entry from routingState
+     *   3. If neither yields a sessionId → return all-null context (invocation
+     *      will be recorded with session_id derived from the synthetic
+     *      "mcp-anon-<ts>" so the writeSkillInvocation NOT NULL constraint still
+     *      passes; see resolveSessionContext below).
+     */
+    resolveSession?: (req: Request) => SessionContext;
+}
+/**
+ * Mount the MCP server endpoints on an existing Express application.
+ *
+ * Routes:
+ *   POST /mcp   — JSON-RPC over Streamable HTTP (initialize, tools/list, tools/call)
+ *   GET  /mcp   — Standalone SSE channel (server→client notifications)
+ *   DELETE /mcp — Session termination (stateful mode only; no-op in stateless)
+ *
+ * Authentication: every method requires the daemon Bearer token. Token-file
+ * absence still falls through (early-startup safety, identical to /api).
+ */
+export declare function mountMcpServer(app: Application, options: McpServerOptions): void;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAY,MAAM,SAAS,CAAC;AAK9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAOrE,2DAA2D;AAC3D,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,aAAa,CAAC;IAC7B,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,cAAc,CAAC;CACnD;AAkJD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CA4ChF"}