@hotmeshio/long-tail 0.1.5 → 0.1.7

package/build/system/mcp-servers/playwright-cli/schemas.d.ts

@@ -13,25 +13,25 @@ export declare const loginAndCaptureSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     password: string;
     url: string;
-    username_selector: string;
-    password_selector: string;
     username: string;
     submit_selector: string;
+    username_selector: string;
+    password_selector: string;
+    screenshot_path?: string | undefined;
     timeout?: number | undefined;
     full_page?: boolean | undefined;
     wait_after_login?: string | undefined;
-    screenshot_path?: string | undefined;
 }, {
     password: string;
     url: string;
-    username_selector: string;
-    password_selector: string;
     username: string;
     submit_selector: string;
+    username_selector: string;
+    password_selector: string;
+    screenshot_path?: string | undefined;
     timeout?: number | undefined;
     full_page?: boolean | undefined;
     wait_after_login?: string | undefined;
-    screenshot_path?: string | undefined;
 }>;
 export declare const capturePageSchema: z.ZodObject<{
     url: z.ZodString;
@@ -44,22 +44,22 @@ export declare const capturePageSchema: z.ZodObject<{
     timeout: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     url: string;
-    timeout?: number | undefined;
     page_id?: string | undefined;
+    screenshot_path?: string | undefined;
     wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
+    timeout?: number | undefined;
+    wait_ms?: number | undefined;
     full_page?: boolean | undefined;
-    screenshot_path?: string | undefined;
     wait_for_selector?: string | undefined;
-    wait_ms?: number | undefined;
 }, {
     url: string;
-    timeout?: number | undefined;
     page_id?: string | undefined;
+    screenshot_path?: string | undefined;
     wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
+    timeout?: number | undefined;
+    wait_ms?: number | undefined;
     full_page?: boolean | undefined;
-    screenshot_path?: string | undefined;
     wait_for_selector?: string | undefined;
-    wait_ms?: number | undefined;
 }>;
 export declare const captureAuthenticatedPagesSchema: z.ZodObject<{
     login: z.ZodObject<{
@@ -74,19 +74,19 @@ export declare const captureAuthenticatedPagesSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         password: string;
         url: string;
-        username_selector: string;
-        password_selector: string;
         username: string;
         submit_selector: string;
+        username_selector: string;
+        password_selector: string;
         timeout?: number | undefined;
         wait_after_login?: string | undefined;
     }, {
         password: string;
         url: string;
-        username_selector: string;
-        password_selector: string;
         username: string;
         submit_selector: string;
+        username_selector: string;
+        password_selector: string;
         timeout?: number | undefined;
         wait_after_login?: string | undefined;
     }>;
@@ -99,51 +99,51 @@ export declare const captureAuthenticatedPagesSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         url: string;
         screenshot_path: string;
+        wait_ms?: number | undefined;
         full_page?: boolean | undefined;
         wait_for_selector?: string | undefined;
-        wait_ms?: number | undefined;
     }, {
         url: string;
         screenshot_path: string;
+        wait_ms?: number | undefined;
         full_page?: boolean | undefined;
         wait_for_selector?: string | undefined;
-        wait_ms?: number | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     login: {
         password: string;
         url: string;
-        username_selector: string;
-        password_selector: string;
         username: string;
         submit_selector: string;
+        username_selector: string;
+        password_selector: string;
         timeout?: number | undefined;
         wait_after_login?: string | undefined;
     };
     pages: {
         url: string;
         screenshot_path: string;
+        wait_ms?: number | undefined;
         full_page?: boolean | undefined;
         wait_for_selector?: string | undefined;
-        wait_ms?: number | undefined;
     }[];
 }, {
     login: {
         password: string;
         url: string;
-        username_selector: string;
-        password_selector: string;
         username: string;
         submit_selector: string;
+        username_selector: string;
+        password_selector: string;
         timeout?: number | undefined;
         wait_after_login?: string | undefined;
     };
     pages: {
         url: string;
         screenshot_path: string;
+        wait_ms?: number | undefined;
         full_page?: boolean | undefined;
         wait_for_selector?: string | undefined;
-        wait_ms?: number | undefined;
     }[];
 }>;
 export declare const extractContentSchema: z.ZodObject<{
@@ -157,25 +157,25 @@ export declare const extractContentSchema: z.ZodObject<{
     wait_ms: z.ZodOptional<z.ZodNumber>;
     timeout: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    url?: string | undefined;
-    timeout?: number | undefined;
     page_id?: string | undefined;
+    url?: string | undefined;
     selector?: string | undefined;
-    script?: string | undefined;
-    wait_for_selector?: string | undefined;
+    timeout?: number | undefined;
     wait_ms?: number | undefined;
     extract_links?: boolean | undefined;
     extract_metadata?: boolean | undefined;
+    script?: string | undefined;
+    wait_for_selector?: string | undefined;
 }, {
-    url?: string | undefined;
-    timeout?: number | undefined;
     page_id?: string | undefined;
+    url?: string | undefined;
     selector?: string | undefined;
-    script?: string | undefined;
-    wait_for_selector?: string | undefined;
+    timeout?: number | undefined;
     wait_ms?: number | undefined;
     extract_links?: boolean | undefined;
     extract_metadata?: boolean | undefined;
+    script?: string | undefined;
+    wait_for_selector?: string | undefined;
 }>;
 export declare const submitFormSchema: z.ZodObject<{
     url: z.ZodString;
@@ -201,9 +201,9 @@ export declare const submitFormSchema: z.ZodObject<{
         value: string;
         selector: string;
     }[];
+    screenshot_path?: string | undefined;
     timeout?: number | undefined;
     full_page?: boolean | undefined;
-    screenshot_path?: string | undefined;
     wait_after_submit?: string | undefined;
 }, {
     url: string;
@@ -212,8 +212,8 @@ export declare const submitFormSchema: z.ZodObject<{
         value: string;
         selector: string;
     }[];
+    screenshot_path?: string | undefined;
     timeout?: number | undefined;
     full_page?: boolean | undefined;
-    screenshot_path?: string | undefined;
     wait_after_submit?: string | undefined;
 }>;

package/build/system/mcp-servers/playwright-cli/tools-capture.js

@@ -84,7 +84,7 @@ function registerCaptureTools(srv) {
                 await page.waitForTimeout(args.wait_ms ?? 2000);
             }
             // Auto-derive screenshot path from URL if not provided
-            const screenshotPath = args.screenshot_path || (() => {
+            let screenshotPath = args.screenshot_path || (() => {
                 try {
                     const urlPath = new URL(args.url).pathname;
                     const slug = urlPath === '/' ? 'home' : urlPath.replace(/^\/+|\/+$/g, '').replace(/\//g, '-');
@@ -94,6 +94,10 @@ function registerCaptureTools(srv) {
                     return `screenshots/capture-${Date.now()}.png`;
                 }
             })();
+            // Ensure file extension — storage backends require mime type
+            if (!path.extname(screenshotPath)) {
+                screenshotPath += '.png';
+            }
             const screenshot = await (0, helpers_1.saveScreenshot)(page, screenshotPath, args.full_page ?? true);
             return {
                 content: [{

package/build/system/mcp-servers/vision.js

@@ -32,12 +32,16 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createVisionServer = createVisionServer;
 exports.stopVisionServer = stopVisionServer;
 const path = __importStar(require("path"));
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const zod_1 = require("zod");
+const sharp_1 = __importDefault(require("sharp"));
 const llm_1 = require("../../services/llm");
 const defaults_1 = require("../../modules/defaults");
 const logger_1 = require("../../lib/logger");
@@ -47,6 +51,8 @@ const MIME_MAP = {
     '.png': 'image/png', '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg',
     '.gif': 'image/gif', '.webp': 'image/webp', '.svg': 'image/svg+xml',
 };
+/** Max dimension for LLM vision APIs (Anthropic limit is 8000px). */
+const MAX_IMAGE_DIMENSION = 7680;
 const analyzeImageSchema = zod_1.z.object({
     image: zod_1.z.string().describe('Image source: a storage path (e.g. "amazon_initial.png"), ' +
         'a data URI (data:image/png;base64,...), or an https:// URL.'),
@@ -77,10 +83,25 @@ async function resolveImageContent(image) {
     const storagePath = image.replace(/^file:\/\//, '');
     const backend = (0, storage_1.getStorageBackend)();
     const { data } = await backend.read(storagePath);
-    const ext = path.extname(storagePath).toLowerCase();
-    const mime = MIME_MAP[ext] || 'image/png';
-    const base64 = data.toString('base64');
-    return { type: 'image_url', image_url: { url: `data:${mime};base64,${base64}` } };
+    // Downscale if any dimension exceeds the LLM vision limit
+    let imageBuffer = data;
+    let outputMime = MIME_MAP[path.extname(storagePath).toLowerCase()] || 'image/png';
+    try {
+        const meta = await (0, sharp_1.default)(data).metadata();
+        if (meta.width && meta.height && (meta.width > MAX_IMAGE_DIMENSION || meta.height > MAX_IMAGE_DIMENSION)) {
+            logger_1.loggerRegistry.info(`[lt-mcp:vision] resizing ${meta.width}x${meta.height} -> fit ${MAX_IMAGE_DIMENSION}px`);
+            imageBuffer = await (0, sharp_1.default)(data)
+                .resize({ width: MAX_IMAGE_DIMENSION, height: MAX_IMAGE_DIMENSION, fit: 'inside' })
+                .png()
+                .toBuffer();
+            outputMime = 'image/png';
+        }
+    }
+    catch (err) {
+        logger_1.loggerRegistry.warn(`[lt-mcp:vision] could not check/resize image: ${err.message}`);
+    }
+    const base64 = imageBuffer.toString('base64');
+    return { type: 'image_url', image_url: { url: `data:${outputMime};base64,${base64}` } };
 }
 function registerTools(srv) {
     // ── analyze_image ───────────────────────────────────────────────
@@ -106,19 +127,35 @@ function registerTools(srv) {
         const systemPrompt = args.prompt
             ? `${vision_prompts_1.ANALYZE_IMAGE_PROMPT}\n\nAdditional guidance: ${args.prompt}`
             : vision_prompts_1.ANALYZE_IMAGE_PROMPT;
-        const response = await (0, llm_1.callLLM)({
-            model: defaults_1.LLM_MODEL_SECONDARY,
-            messages: [
-                { role: 'system', content: systemPrompt },
-                {
-                    role: 'user',
-                    content: [await resolveImageContent(args.image)],
-                },
-            ],
-            max_tokens: defaults_1.LLM_MAX_TOKENS_VISION,
-            temperature: 0,
-        });
+        let response;
+        try {
+            const imageContent = await resolveImageContent(args.image || args.image_path);
+            response = await (0, llm_1.callLLM)({
+                model: defaults_1.LLM_MODEL_SECONDARY,
+                messages: [
+                    { role: 'system', content: systemPrompt },
+                    { role: 'user', content: [imageContent] },
+                ],
+                max_tokens: defaults_1.LLM_MAX_TOKENS_VISION,
+                temperature: 0,
+            });
+        }
+        catch (err) {
+            logger_1.loggerRegistry.error(`[lt-mcp:vision] analyze_image failed: ${err.message}`);
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: err.message,
+                            description: null,
+                            text_content: null,
+                            objects: [],
+                        }),
+                    }],
+            };
+        }
         const raw = response.content || '';
+        logger_1.loggerRegistry.info(`[lt-mcp:vision] analyze_image response length: ${raw.length}`);
         try {
             const cleaned = raw.replace(/^```json\n?|\n?```$/g, '').trim();
             const parsed = JSON.parse(cleaned);
@@ -173,7 +210,7 @@ function registerTools(srv) {
                 { role: 'system', content: systemPrompt },
                 {
                     role: 'user',
-                    content: [await resolveImageContent(args.image)],
+                    content: [await resolveImageContent(args.image || args.image_path)],
                 },
             ],
             max_tokens: defaults_1.LLM_MAX_TOKENS_VISION,

package/build/system/seed/server-definitions.d.ts

@@ -1180,10 +1180,12 @@ export declare const SEED_MCP_SERVERS: ({
                 prompt: {
                     type: string;
                     description: string;
+                    default: string;
                 };
                 working_directory: {
                     type: string;
                     description: string;
+                    default: string;
                 };
                 allowed_tools: {
                     type: string;
@@ -1191,14 +1193,17 @@ export declare const SEED_MCP_SERVERS: ({
                         type: string;
                     };
                     description: string;
+                    default: string[];
                 };
                 max_turns: {
                     type: string;
                     description: string;
+                    default: number;
                 };
                 model: {
                     type: string;
                     description: string;
+                    default: string;
                 };
                 system_prompt: {
                     type: string;
@@ -1207,10 +1212,12 @@ export declare const SEED_MCP_SERVERS: ({
                 timeout_ms: {
                     type: string;
                     description: string;
+                    default: number;
                 };
                 credential_label: {
                     type: string;
                     description: string;
+                    default: string;
                 };
             };
             required: string[];

package/build/system/seed/server-definitions.js

@@ -51,8 +51,9 @@ exports.SEED_MCP_SERVERS = [
         tags: ['vision', 'image-analysis', 'multimodal'],
         compile_hints: [
             'Vision tools process one image at a time. When iterating over multiple images, each iteration should pass a single image URL or data URI.',
-            'The `image` argument accepts a storage path (e.g., "screenshot.png"), a data URI, or an https:// URL. When following a screenshot or run_script step, wire `image` from the producing step output — use `last_screenshot_path` from run_script or `path` from screenshot. NEVER make `image` a trigger input when the image is produced by a prior step.',
+            'The argument name is `image` (NOT `image_path`). It accepts a storage path (e.g., "screenshot.png"), a data URI, or an https:// URL. When following a screenshot or capture_page step, wire `image` from the producing step output field `path`. NEVER make `image` a trigger input when the image is produced by a prior step.',
             'Vision tools do NOT use browser sessions. Do NOT wire page_id or _handle to vision tools — they read from storage, not from the browser.',
+            'analyze_image output fields: description (string), text_content (string), objects (array). The main analysis text is in `description` — NOT `analysis` or `content`.',
         ].join(' '),
         credential_providers: ['anthropic'],
     },
@@ -88,6 +89,7 @@ exports.SEED_MCP_SERVERS = [
             'capture_authenticated_pages expects a `login` object and a `pages` array. The `login` object contains nested fields (url, username, password, selectors) — flatten credentials as dynamic trigger inputs but keep the object structure in stored tool_arguments. The `pages` array should flow from a transform edge that reshapes `links` into [{url, screenshot_path, wait_ms, full_page}].',
             'For screenshot_path derivation in transforms, use the `screenshot_dir` trigger input as a dynamic prefix (not hardcoded). Derivation strategy: slugify the href, prepend screenshot_dir + "/", append ".png".',
             'When login_and_capture follows a signal hook (human input), wire the password from the hook output to the `password` argument. Wire `url` and `username` from trigger inputs.',
+            'capture_page screenshot_path MUST include a file extension (e.g., .png). When deriving screenshot_path from a slug or identifier, always append ".png" using a concat derivation: { "strategy": "concat", "parts": ["{value}", ".png"] }. For date-stamped paths use: { "strategy": "concat", "parts": ["{value}", "-", "{date}", ".png"] }.',
         ].join(' '),
         credential_providers: [],
     },
@@ -181,7 +183,9 @@ exports.SEED_MCP_SERVERS = [
         tool_manifest: tool_manifests_knowledge_1.KNOWLEDGE_TOOLS,
         metadata: { builtin: true, category: 'knowledge' },
         tags: ['knowledge', 'memory', 'state', 'storage'],
-        compile_hints: 'store_knowledge upserts by domain+key — it merges data if the entry exists. ' +
+        compile_hints: 'store_knowledge arguments: domain (string), key (string), data (object — MUST be a JSON object, never a string), tags (optional string[]). ' +
+            'The data field is a JSONB object. When storing text content, wrap it: { "description": "the text" }. NEVER pass a bare string as data. ' +
+            'store_knowledge upserts by domain+key — it merges data if the entry exists. ' +
             'Use a consistent domain name across related workflows to build shared context. ' +
             'search_knowledge uses JSONB containment (@>) — the query object must be a subset of the stored data. ' +
             'append_knowledge adds to arrays without replacing existing entries — ideal for catalogs and logs. ' +

package/build/system/seed/tool-manifests-workflows.d.ts

@@ -156,10 +156,12 @@ export declare const CLAUDE_CODE_TOOLS: ({
             prompt: {
                 type: string;
                 description: string;
+                default: string;
             };
             working_directory: {
                 type: string;
                 description: string;
+                default: string;
             };
             allowed_tools: {
                 type: string;
@@ -167,14 +169,17 @@ export declare const CLAUDE_CODE_TOOLS: ({
                     type: string;
                 };
                 description: string;
+                default: string[];
             };
             max_turns: {
                 type: string;
                 description: string;
+                default: number;
             };
             model: {
                 type: string;
                 description: string;
+                default: string;
             };
             system_prompt: {
                 type: string;
@@ -183,10 +188,12 @@ export declare const CLAUDE_CODE_TOOLS: ({
             timeout_ms: {
                 type: string;
                 description: string;
+                default: number;
             };
             credential_label: {
                 type: string;
                 description: string;
+                default: string;
             };
         };
         required: string[];

package/build/system/seed/tool-manifests-workflows.js

@@ -91,23 +91,28 @@ exports.CLAUDE_CODE_TOOLS = [
                 prompt: {
                     type: 'string',
                     description: 'The task prompt. Be specific and actionable.',
+                    default: 'List the files in the current directory and describe what this project does in 2 sentences.',
                 },
                 working_directory: {
                     type: 'string',
-                    description: 'Working directory for the task. Defaults to server cwd.',
+                    description: 'Working directory for the task. Defaults to /app (container root).',
+                    default: '/app',
                 },
                 allowed_tools: {
                     type: 'array',
                     items: { type: 'string' },
-                    description: 'Restrict which tools Claude Code can use (e.g., ["Read", "Grep"]).',
+                    description: 'Restrict which tools Claude Code can use (e.g., ["Read", "Grep", "Glob", "Bash"]).',
+                    default: ['Read', 'Glob', 'Grep', 'Bash'],
                 },
                 max_turns: {
                     type: 'number',
                     description: 'Maximum agentic turns before stopping.',
+                    default: 5,
                 },
                 model: {
                     type: 'string',
                     description: 'Override the Claude model (e.g., "claude-sonnet-4-6").',
+                    default: 'claude-sonnet-4-6',
                 },
                 system_prompt: {
                     type: 'string',
@@ -116,10 +121,12 @@ exports.CLAUDE_CODE_TOOLS = [
                 timeout_ms: {
                     type: 'number',
                     description: 'Execution timeout in ms. Default: 120000, max: 300000.',
+                    default: 120000,
                 },
                 credential_label: {
                     type: 'string',
-                    description: 'Label of the stored Anthropic credential to use (e.g., "subscription", "api-batch"). Default: "default".',
+                    description: 'Label of the stored Anthropic credential to use (e.g., "subscription", "api-batch").',
+                    default: 'default',
                 },
             },
             required: ['prompt'],

package/build/system/workflows/mcp-workflow-builder/activities/caches.d.ts

@@ -0,0 +1,5 @@
+import type { ToolDefinition } from '../../../../services/llm';
+/** Maps qualified tool name -> MCP server name for routing calls */
+export declare const toolServerMap: Map<string, string>;
+/** Maps qualified tool name -> full tool definition */
+export declare const toolDefCache: Map<string, ToolDefinition>;

package/build/system/workflows/mcp-workflow-builder/activities/caches.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolDefCache = exports.toolServerMap = void 0;
+// ── Tool caches (module-level, persist across proxy activity calls) ──
+/** Maps qualified tool name -> MCP server name for routing calls */
+exports.toolServerMap = new Map();
+/** Maps qualified tool name -> full tool definition */
+exports.toolDefCache = new Map();

package/build/system/workflows/mcp-workflow-builder/activities/index.d.ts

@@ -0,0 +1,2 @@
+export { loadBuilderTools, loadReferenceSection } from './tool-loader';
+export { callBuilderLLM } from './llm';

package/build/system/workflows/mcp-workflow-builder/activities/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.callBuilderLLM = exports.loadReferenceSection = exports.loadBuilderTools = void 0;
+var tool_loader_1 = require("./tool-loader");
+Object.defineProperty(exports, "loadBuilderTools", { enumerable: true, get: function () { return tool_loader_1.loadBuilderTools; } });
+Object.defineProperty(exports, "loadReferenceSection", { enumerable: true, get: function () { return tool_loader_1.loadReferenceSection; } });
+var llm_1 = require("./llm");
+Object.defineProperty(exports, "callBuilderLLM", { enumerable: true, get: function () { return llm_1.callBuilderLLM; } });

package/build/system/workflows/mcp-workflow-builder/activities/llm.d.ts

@@ -0,0 +1,2 @@
+import { type LLMResponse } from '../../../../services/llm';
+export declare function callBuilderLLM(messages: any[], _toolIds?: string[]): Promise<LLMResponse>;

package/build/system/workflows/mcp-workflow-builder/activities/llm.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.callBuilderLLM = callBuilderLLM;
+const llm_1 = require("../../../../services/llm");
+const defaults_1 = require("../../../../modules/defaults");
+const logger_1 = require("../../../../lib/logger");
+/**
+ * Call the LLM for workflow building.
+ *
+ * Uses a higher max_tokens than the shared caller because the builder
+ * returns complete YAML + manifest JSON (typically 2000-4000 tokens).
+ */
+const BUILDER_MAX_TOKENS = 4096;
+async function callBuilderLLM(messages, _toolIds) {
+    const t0 = Date.now();
+    const response = await (0, llm_1.callLLM)({
+        model: defaults_1.LLM_MODEL_PRIMARY,
+        messages,
+        temperature: 0,
+        max_tokens: BUILDER_MAX_TOKENS,
+    });
+    const usage = response.usage;
+    logger_1.loggerRegistry.info(`[workflowBuilder:callLLM] ${Date.now() - t0}ms | in=${usage?.prompt_tokens} out=${usage?.completion_tokens} total=${usage?.total_tokens} | tool_calls=${response.tool_calls?.length || 0}`);
+    return response;
+}

package/build/system/workflows/mcp-workflow-builder/activities/tool-loader.d.ts

@@ -0,0 +1,11 @@
+export declare function loadBuilderTools(tags?: string[]): Promise<{
+    toolIds: string[];
+    inventory: string;
+    strategy: string;
+}>;
+/**
+ * Load a specific section from the activity-types reference file.
+ * Returns the markdown for the requested activity type (await, signal, interrupt).
+ * Returns empty string if the section or file is not found.
+ */
+export declare function loadReferenceSection(section: 'await' | 'signal' | 'interrupt'): Promise<string>;

package/build/system/workflows/mcp-workflow-builder/activities/tool-loader.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadBuilderTools = loadBuilderTools;
+exports.loadReferenceSection = loadReferenceSection;
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+const tool_loader_1 = require("../../shared/tool-loader");
+const caches_1 = require("./caches");
+async function loadBuilderTools(tags) {
+    return (0, tool_loader_1.loadToolsFromServers)(tags, { toolServerMap: caches_1.toolServerMap, toolDefCache: caches_1.toolDefCache }, { logPrefix: 'workflowBuilder' });
+}
+/**
+ * Load a specific section from the activity-types reference file.
+ * Returns the markdown for the requested activity type (await, signal, interrupt).
+ * Returns empty string if the section or file is not found.
+ */
+async function loadReferenceSection(section) {
+    try {
+        const refPath = (0, path_1.join)(__dirname, '..', 'reference', 'activity-types.md');
+        const content = await (0, promises_1.readFile)(refPath, 'utf-8');
+        // Extract the section between ## <name> and the next ## or end of file
+        const sectionHeader = `## ${section}`;
+        const startIdx = content.indexOf(sectionHeader);
+        if (startIdx === -1)
+            return '';
+        const afterHeader = content.indexOf('\n', startIdx);
+        const nextSection = content.indexOf('\n## ', afterHeader + 1);
+        const endIdx = nextSection === -1 ? content.length : nextSection;
+        return content.slice(startIdx, endIdx).trim();
+    }
+    catch {
+        return '';
+    }
+}

package/build/system/workflows/mcp-workflow-builder/index.d.ts

@@ -0,0 +1,16 @@
+import type { LTEnvelope, LTReturn } from '../../../types';
+/**
+ * MCP Workflow Builder — constructs HotMesh YAML DAGs directly.
+ *
+ * Unlike mcpQuery (which executes tools then compiles traces), this workflow
+ * reasons about tool schemas and builds the YAML declaratively. The LLM
+ * knows HotMesh's activity types, mapping syntax, and @pipe operators.
+ *
+ * Supports conversational clarification: when the prompt is ambiguous,
+ * the LLM returns questions instead of YAML. The user answers, and the
+ * exchange continues until the LLM has enough to build.
+ *
+ * Returns the generated YAML, input schema, and activity manifest —
+ * ready for deployment via the existing yaml-workflow infrastructure.
+ */
+export declare function mcpWorkflowBuilder(envelope: LTEnvelope): Promise<LTReturn>;