@hotmeshio/long-tail 0.1.9 → 0.1.11

package/build/services/mcp/client/connection.js

@@ -160,13 +160,18 @@ async function resolveClient(serverId) {
     if (clients.has(serverId))
         return clients.get(serverId);
     // 2. Check built-in server factories -- exact match first, then fuzzy
+    //    Normalize strips non-alphanumeric chars so hyphens and underscores
+    //    match (e.g., "long_tail_vision" matches "long-tail-vision").
+    const norm = (s) => s.replace(/[^a-zA-Z0-9]/g, '').toLowerCase();
     let matchedName = null;
     if (builtinFactories.has(serverId)) {
         matchedName = serverId;
     }
     else {
+        const normId = norm(serverId);
         for (const [name] of builtinFactories) {
-            if (name.includes(serverId) || serverId.includes(name)) {
+            const normName = norm(name);
+            if (normName.includes(normId) || normId.includes(normName)) {
                 matchedName = name;
                 break;
             }

package/build/services/yaml-workflow/workers/register.js

@@ -44,6 +44,27 @@ const yamlDb = __importStar(require("../db"));
 const scope_1 = require("./scope");
 const callbacks_1 = require("./callbacks");
 const events_1 = require("./events");
+/**
+ * HotMesh YAML maps serialize arrays as objects with numeric keys
+ * (e.g., {0: "a", 1: "b"}). Recursively coerce these back to arrays
+ * before passing args to MCP tools that expect real arrays.
+ */
+function coerceNumericObjects(obj) {
+    if (Array.isArray(obj))
+        return obj.map(coerceNumericObjects);
+    if (obj === null || typeof obj !== 'object')
+        return obj;
+    const record = obj;
+    const keys = Object.keys(record);
+    if (keys.length > 0 && keys.every((k, i) => k === String(i))) {
+        return keys.map((k) => coerceNumericObjects(record[k]));
+    }
+    const result = {};
+    for (const [k, v] of Object.entries(record)) {
+        result[k] = coerceNumericObjects(v);
+    }
+    return result;
+}
 /** Track which topics already have registered workers */
 const registeredTopics = new Set();
 /**
@@ -194,7 +215,8 @@ async function registerWorkersForWorkflow(workflow) {
                         };
                     }
                     const exchangedArgs = await (0, ephemeral_1.exchangeTokensInArgs)(mergedArgs);
-                    const result = await mcpClient.callServerTool(serverId, toolName, exchangedArgs);
+                    const coercedArgs = coerceNumericObjects(exchangedArgs);
+                    const result = await mcpClient.callServerTool(serverId, toolName, coercedArgs);
                     if (result && typeof result === 'object' && 'error' in result) {
                         logger_1.loggerRegistry.error(`[yaml-workflow:worker] ${toolName} error: ${JSON.stringify(result).slice(0, 200)}`);
                     }

package/build/start/workers.js

@@ -114,9 +114,16 @@ async function startWorkers(startConfig, workers, builtinMcpServerFactories) {
         });
         // Start each worker
         for (const w of workers) {
+            if (w.connection?.readonly) {
+                // Readonly workers register for discovery only — they must not
+                // consume messages from the stream (that is the real worker's job).
+                (0, registry_1.registerWorker)(w.workflow.name, w.taskQueue);
+                logger_1.loggerRegistry.info(`[long-tail] readonly worker registered: ${w.taskQueue}::${w.workflow.name}`);
+                continue;
+            }
             const label = `${w.taskQueue}::${w.workflow.name}`;
             const worker = await hotmesh_1.Durable.Worker.create({
-                connection: w.connection ? { ...connection, ...w.connection } : connection,
+                connection,
                 taskQueue: w.taskQueue,
                 workflow: w.workflow,
                 guid: `${label}-${hotmesh_1.Durable.guid()}`,

package/build/system/workflows/mcp-workflow-builder/prompts.js

@@ -205,14 +205,15 @@ IMPORTANT: A bare array like \`['.png']\` as a row after sub-pipes will CRASH
 2. **Worker per tool**: Each MCP tool call is a worker activity
 3. **Collision-proof activity IDs**: Multiple workflows share the same app namespace. Activity IDs MUST be globally unique within the app. Use a descriptive name with a shared 4-char random suffix appended to every activity in the flow: \`trigger_x8kf\`, \`capture_x8kf\`, \`analyze_x8kf\`, \`store_x8kf\`. The suffix is the same for all activities in one workflow but unique across workflows. NEVER use bare names like \`trigger\`, \`capture\`, \`analyze\` — they WILL collide with other workflows in the same app.
 4. **workflowName**: Every worker MUST have \`workflowName: '<tool_name>'\` in its input.maps — this routes to the correct MCP tool handler
-5. **_scope threading**: Every worker MUST have \`_scope: '{trigger_x8kf.output.data._scope}'\` (using YOUR trigger's ID) for IAM context
-6. **Wire outputs forward**: Use \`{prevActivity.output.data.fieldName}\` to pass data between steps
-7. **Use @pipe for transforms**: When a value needs runtime computation (date stamp, string concat, slugify), use @pipe — never hardcode computed values
-8. **Simple fields stay simple**: If a field just passes a trigger value through (domain, key, url), use a plain reference like \`'{trigger_x8kf.output.data.domain}'\` — NEVER wrap it in @pipe. Only use @pipe when actual transformation is needed.
-9. **File extensions**: Screenshot paths MUST include .png extension. Use @pipe concat if deriving from a slug
-10. **job.maps on last activity**: The final activity should have job.maps to promote output fields to the workflow result
-11. **Linear transitions**: Chain activities with transitions unless branching or iteration is needed
-12. **Conditional transitions**: For branching, use multi-target transitions with conditions:
+5. **mcp_server_id**: In the activity_manifest, use the exact hyphenated server name from the inventory (e.g., "long-tail-vision"), NOT the underscored tool prefix (e.g., "long_tail_vision")
+6. **_scope threading**: Every worker MUST have \`_scope: '{trigger_x8kf.output.data._scope}'\` (using YOUR trigger's ID) for IAM context
+7. **Wire outputs forward**: Use \`{prevActivity.output.data.fieldName}\` to pass data between steps
+8. **Use @pipe for transforms**: When a value needs runtime computation (date stamp, string concat, slugify), use @pipe — never hardcode computed values
+9. **Simple fields stay simple**: If a field just passes a trigger value through (domain, key, url), use a plain reference like \`'{trigger_x8kf.output.data.domain}'\` — NEVER wrap it in @pipe. Only use @pipe when actual transformation is needed.
+10. **File extensions**: Screenshot paths MUST include .png extension. Use @pipe concat if deriving from a slug
+11. **job.maps on last activity**: The final activity should have job.maps to promote output fields to the workflow result
+12. **Linear transitions**: Chain activities with transitions unless branching or iteration is needed
+13. **Conditional transitions**: For branching, use multi-target transitions with conditions:
 \`\`\`yaml
 transitions:
   check_x8kf:
@@ -222,7 +223,7 @@ transitions:
     - to: proceed_x8kf
 \`\`\`
 Conditions can match on \`code\` (HTTP status) or \`match\` (field comparisons). The first matching condition wins; the last entry (no conditions) is the default.
-13. **Trigger stats for idempotency**: Use \`stats.id\` and \`stats.key\` on the trigger when the workflow needs custom job IDs or indexed lookups:
+14. **Trigger stats for idempotency**: Use \`stats.id\` and \`stats.key\` on the trigger when the workflow needs custom job IDs or indexed lookups:
 \`\`\`yaml
 trigger_x8kf:
   type: trigger

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hotmeshio/long-tail",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "Long Tail Workflows — Durable AI workflows with human-in-the-loop escalation. Powered by PostgreSQL.",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",
@@ -61,7 +61,7 @@
   "dependencies": {
     "@anthropic-ai/sdk": "^0.82.0",
     "@aws-sdk/client-s3": "^3.1017.0",
-    "@hotmeshio/hotmesh": "^0.14.3",
+    "@hotmeshio/hotmesh": "^0.14.4",
     "@modelcontextprotocol/sdk": "^1.27.1",
     "@opentelemetry/exporter-trace-otlp-proto": "^0.215.0",
     "@opentelemetry/resources": "^2.5.1",