@hotmeshio/long-tail 0.4.14 → 0.4.16

package/build/services/escalation/crud.js

@@ -17,8 +17,11 @@ exports.getEscalationsByOriginId = getEscalationsByOriginId;
 exports.findByMetadata = findByMetadata;
 exports.claimByMetadata = claimByMetadata;
 const db_1 = require("../../lib/db");
+const publish_1 = require("../../lib/events/publish");
+const logger_1 = require("../../lib/logger");
 const sql_1 = require("./sql");
 async function createEscalation(input) {
+    logger_1.loggerRegistry.info(`[escalation-crud] createEscalation called for wf=${input.workflow_id} type=${input.type} caller=${new Error().stack?.split('\n')[2]?.trim()}`);
     const pool = (0, db_1.getPool)();
     // Ensure the role exists in lt_roles (FK constraint)
     await pool.query(sql_1.ENSURE_ROLE_EXISTS, [input.role]);
@@ -40,7 +43,18 @@ async function createEscalation(input) {
         input.trace_id || null,
         input.span_id || null,
     ]);
-    return rows[0];
+    const escalation = rows[0];
+    (0, publish_1.publishEscalationEvent)({
+        type: 'escalation.created',
+        source: 'service',
+        workflowId: escalation.workflow_id || '',
+        workflowName: escalation.workflow_type || '',
+        taskQueue: escalation.task_queue || '',
+        escalationId: escalation.id,
+        status: 'pending',
+        data: { type: input.type, role: input.role },
+    });
+    return escalation;
 }
 /**
  * Atomic claim operation. Does NOT change status — "claimed" is implicit
@@ -58,15 +72,39 @@ async function claimEscalation(id, userId, durationMinutes = 30) {
     if (rows.length === 0)
         return null;
     const row = rows[0];
+    const escalation = row;
+    (0, publish_1.publishEscalationEvent)({
+        type: 'escalation.claimed',
+        source: 'service',
+        workflowId: escalation.workflow_id || '',
+        workflowName: escalation.workflow_type || '',
+        taskQueue: escalation.task_queue || '',
+        escalationId: escalation.id,
+        status: 'claimed',
+        data: { assigned_to: userId },
+    });
     return {
-        escalation: row,
+        escalation,
         isExtension: row.prev_assigned_to === userId,
     };
 }
 async function resolveEscalation(id, resolverPayload) {
     const pool = (0, db_1.getPool)();
     const { rows } = await pool.query(sql_1.RESOLVE_ESCALATION, [id, JSON.stringify(resolverPayload)]);
-    return rows[0] || null;
+    const escalation = rows[0] || null;
+    if (escalation) {
+        (0, publish_1.publishEscalationEvent)({
+            type: 'escalation.resolved',
+            source: 'service',
+            workflowId: escalation.workflow_id || '',
+            workflowName: escalation.workflow_type || '',
+            taskQueue: escalation.task_queue || '',
+            escalationId: escalation.id,
+            status: 'resolved',
+            data: {},
+        });
+    }
+    return escalation;
 }
 /**
  * Bulk update priority for a set of escalations.
@@ -163,15 +201,27 @@ async function findByMetadata(key, value, status, limit = 50, offset = 0) {
         total: parseInt(countResult.rows[0].count, 10),
     };
 }
-async function claimByMetadata(key, value, userId, durationMinutes = 30) {
+async function claimByMetadata(key, value, userId, durationMinutes = 30, metadata) {
     const pool = (0, db_1.getPool)();
     const filter = JSON.stringify({ [key]: value });
-    const { rows } = await pool.query(sql_1.CLAIM_BY_METADATA, [filter, userId, durationMinutes]);
+    const metaPatch = metadata ? JSON.stringify(metadata) : null;
+    const { rows } = await pool.query(sql_1.CLAIM_BY_METADATA, [filter, userId, durationMinutes, metaPatch]);
     if (rows.length === 0)
         return null;
     const row = rows[0];
+    const escalation = row;
+    (0, publish_1.publishEscalationEvent)({
+        type: 'escalation.claimed',
+        source: 'service',
+        workflowId: escalation.workflow_id || '',
+        workflowName: escalation.workflow_type || '',
+        taskQueue: escalation.task_queue || '',
+        escalationId: escalation.id,
+        status: 'claimed',
+        data: { assigned_to: userId },
+    });
     return {
-        escalation: row,
+        escalation,
         isExtension: row.prev_assigned_to === userId,
     };
 }

package/build/services/escalation/sql.d.ts

@@ -22,5 +22,5 @@ export declare const LIST_DISTINCT_TYPES = "SELECT DISTINCT type FROM lt_escalat
 /** Find escalations by a single metadata key-value pair. */
 export declare const FIND_BY_METADATA = "SELECT * FROM lt_escalations\nWHERE metadata @> $1::jsonb\n  AND ($2::text IS NULL OR status = $2)\nORDER BY priority ASC, created_at ASC\nLIMIT $3 OFFSET $4";
 export declare const COUNT_BY_METADATA = "SELECT COUNT(*) FROM lt_escalations\nWHERE metadata @> $1::jsonb\n  AND ($2::text IS NULL OR status = $2)";
-/** Atomic claim by metadata: find one available escalation and claim it. */
-export declare const CLAIM_BY_METADATA = "WITH target AS (\n  SELECT id, assigned_to\n  FROM lt_escalations\n  WHERE metadata @> $1::jsonb\n    AND status = 'pending'\n    AND (\n      assigned_to IS NULL\n      OR assigned_until <= NOW()\n      OR assigned_to = $2\n    )\n  ORDER BY priority ASC, created_at ASC\n  LIMIT 1\n  FOR UPDATE SKIP LOCKED\n),\nupdated AS (\n  UPDATE lt_escalations e\n  SET assigned_to = $2,\n      claimed_at = NOW(),\n      assigned_until = NOW() + INTERVAL '1 minute' * $3\n  FROM target t\n  WHERE e.id = t.id\n  RETURNING e.*, t.assigned_to AS prev_assigned_to\n)\nSELECT * FROM updated";
+/** Atomic claim by metadata: find one available escalation, claim it, and optionally merge metadata. */
+export declare const CLAIM_BY_METADATA = "WITH target AS (\n  SELECT id, assigned_to\n  FROM lt_escalations\n  WHERE metadata @> $1::jsonb\n    AND status = 'pending'\n    AND (\n      assigned_to IS NULL\n      OR assigned_until <= NOW()\n      OR assigned_to = $2\n    )\n  ORDER BY priority ASC, created_at ASC\n  LIMIT 1\n  FOR UPDATE SKIP LOCKED\n),\nupdated AS (\n  UPDATE lt_escalations e\n  SET assigned_to = $2,\n      claimed_at = NOW(),\n      assigned_until = NOW() + INTERVAL '1 minute' * $3,\n      metadata = CASE WHEN $4::jsonb IS NOT NULL\n        THEN COALESCE(e.metadata, '{}'::jsonb) || $4::jsonb\n        ELSE e.metadata END\n  FROM target t\n  WHERE e.id = t.id\n  RETURNING e.*, t.assigned_to AS prev_assigned_to\n)\nSELECT * FROM updated";

package/build/services/escalation/sql.js

@@ -145,7 +145,7 @@ exports.COUNT_BY_METADATA = `\
 SELECT COUNT(*) FROM lt_escalations
 WHERE metadata @> $1::jsonb
   AND ($2::text IS NULL OR status = $2)`;
-/** Atomic claim by metadata: find one available escalation and claim it. */
+/** Atomic claim by metadata: find one available escalation, claim it, and optionally merge metadata. */
 exports.CLAIM_BY_METADATA = `\
 WITH target AS (
   SELECT id, assigned_to
@@ -165,7 +165,10 @@ updated AS (
   UPDATE lt_escalations e
   SET assigned_to = $2,
       claimed_at = NOW(),
-      assigned_until = NOW() + INTERVAL '1 minute' * $3
+      assigned_until = NOW() + INTERVAL '1 minute' * $3,
+      metadata = CASE WHEN $4::jsonb IS NOT NULL
+        THEN COALESCE(e.metadata, '{}'::jsonb) || $4::jsonb
+        ELSE e.metadata END
   FROM target t
   WHERE e.id = t.id
   RETURNING e.*, t.assigned_to AS prev_assigned_to

package/build/services/interceptor/activities/escalation.js

@@ -39,7 +39,6 @@ exports.ltEnrichEscalationRouting = ltEnrichEscalationRouting;
 exports.ltCreateEscalation = ltCreateEscalation;
 const escalationService = __importStar(require("../../escalation"));
 const logger_1 = require("../../../lib/logger");
-const publish_1 = require("../../../lib/events/publish");
 /**
  * Resolve an escalation record. Called by the interceptor after
  * detecting a re-run (resolver data present in the envelope).
@@ -107,15 +106,6 @@ async function ltCreateEscalation(input) {
         trace_id: input.traceId,
         span_id: input.spanId,
     });
-    (0, publish_1.publishEscalationEvent)({
-        type: 'escalation.created',
-        source: 'interceptor',
-        workflowId: input.workflowId || '',
-        workflowName: input.workflowType || '',
-        taskQueue: input.taskQueue || '',
-        escalationId: escalation.id,
-        status: 'pending',
-        data: { type: input.type, role: input.role },
-    });
+    // Event published by service layer (services/escalation/crud.ts)
     return escalation.id;
 }

package/build/services/interceptor/activities/task.js

@@ -81,16 +81,7 @@ async function ltCreateTask(input) {
         executing_as: input.executingAs,
         status: input.status,
     });
-    (0, publish_1.publishTaskEvent)({
-        type: 'task.created',
-        source: 'interceptor',
-        workflowId: input.workflowId,
-        workflowName: input.workflowType,
-        taskQueue: input.taskQueue || 'unknown',
-        taskId: task.id,
-        originId: input.originId,
-        status: input.status || 'pending',
-    });
+    // Event published by service layer (services/task/crud.ts)
     return task.id;
 }
 /**
@@ -109,19 +100,7 @@ async function ltCompleteTask(input) {
         data: input.data,
         milestones: input.milestones,
     });
-    // Publish task.completed event
-    if (input.workflowId) {
-        (0, publish_1.publishTaskEvent)({
-            type: 'task.completed',
-            source: 'orchestrator',
-            workflowId: input.workflowId,
-            workflowName: input.workflowName || 'unknown',
-            taskQueue: input.taskQueue || 'unknown',
-            taskId: input.taskId,
-            status: 'completed',
-            milestones: input.milestones,
-        });
-    }
+    // task.completed event published by service layer (services/task/crud.ts)
     // Publish milestone event from orchestrator context
     if (input.milestones?.length && input.workflowId) {
         (0, publish_1.publishMilestoneEvent)({

package/build/services/interceptor/completion.js

@@ -115,28 +115,8 @@ async function createAdvisoryEscalation(state, result) {
         traceId: state.traceId,
         spanId: state.spanId,
     });
-    (0, publish_1.publishEscalationEvent)({
-        type: 'escalation.created',
-        source: 'interceptor',
-        workflowId: state.workflowId,
-        workflowName: state.workflowName,
-        taskQueue: state.taskQueue,
-        taskId: state.taskId,
-        escalationId,
-        originId: state.envelope?.lt?.originId,
-        status: 'pending',
-        data: result.data,
-    });
-    (0, publish_1.publishTaskEvent)({
-        type: 'task.escalated',
-        source: 'interceptor',
-        workflowId: state.workflowId,
-        workflowName: state.workflowName,
-        taskQueue: state.taskQueue,
-        taskId: state.taskId,
-        originId: state.envelope?.lt?.originId,
-        status: 'needs_intervention',
-    });
+    // escalation.created event published by service layer (services/escalation/crud.ts)
+    // task.escalated event published by service layer (services/task/crud.ts)
     // Auto-claim to submitting user if known
     const userId = state.envelope?.lt?.userId;
     if (userId) {

package/build/services/interceptor/escalation.js

@@ -41,28 +41,8 @@ async function handleEscalation(state, result) {
         traceId: state.traceId,
         spanId: state.spanId,
     });
-    (0, publish_1.publishEscalationEvent)({
-        type: 'escalation.created',
-        source: 'interceptor',
-        workflowId: state.workflowId,
-        workflowName: state.workflowName,
-        taskQueue: state.taskQueue,
-        taskId: state.taskId,
-        escalationId,
-        originId: state.envelope?.lt?.originId,
-        status: 'pending',
-        data: result.data,
-    });
-    (0, publish_1.publishTaskEvent)({
-        type: 'task.escalated',
-        source: 'interceptor',
-        workflowId: state.workflowId,
-        workflowName: state.workflowName,
-        taskQueue: state.taskQueue,
-        taskId: state.taskId,
-        originId: state.envelope?.lt?.originId,
-        status: 'needs_intervention',
-    });
+    // escalation.created event published by service layer (services/escalation/crud.ts)
+    // task.escalated event published by service layer (services/task/crud.ts)
     return result;
 }
 /**
@@ -109,28 +89,9 @@ async function handleErrorEscalation(state, err) {
         traceId: state.traceId,
         spanId: state.spanId,
     });
-    (0, publish_1.publishEscalationEvent)({
-        type: 'escalation.created',
-        source: 'interceptor',
-        workflowId: state.workflowId,
-        workflowName: state.workflowName,
-        taskQueue: state.taskQueue,
-        taskId: state.taskId,
-        escalationId: errorEscalationId,
-        originId: state.envelope?.lt?.originId,
-        status: 'pending',
-        data: { error: err.message },
-    });
-    (0, publish_1.publishTaskEvent)({
-        type: 'task.escalated',
-        source: 'interceptor',
-        workflowId: state.workflowId,
-        workflowName: state.workflowName,
-        taskQueue: state.taskQueue,
-        taskId: state.taskId,
-        originId: state.envelope?.lt?.originId,
-        status: 'needs_intervention',
-    });
+    // escalation.created event published by service layer (services/escalation/crud.ts)
+    // task.escalated event published by service layer (services/task/crud.ts)
+    // Publish workflow.failed event (error path only runs once — no replay guard needed)
     (0, publish_1.publishWorkflowEvent)({
         type: 'workflow.failed',
         source: 'interceptor',

package/build/services/interceptor/index.js

@@ -44,6 +44,7 @@ const escalation_1 = require("./escalation");
 const completion_1 = require("./completion");
 const lifecycle_1 = require("./lifecycle");
 const context_2 = require("../iam/context");
+const publish_1 = require("../../lib/events/publish");
 const envelope_1 = require("../iam/envelope");
 const DEFAULT_ACTIVITY_QUEUE = 'lt-interceptor';
 /**
@@ -104,13 +105,36 @@ function createLTInterceptor(options) {
             //    task creation, and escalation wiring.
             if (envelope?.metadata?.certified !== true) {
                 const toolCtx = (0, envelope_1.buildToolContextFromEnvelope)(envelope, wf.workflowId, wf.workflowTrace, wf.workflowSpan);
-                return toolCtx ? (0, context_2.runWithToolContext)(toolCtx, next) : next();
+                // Publish workflow events even for uncertified workflows
+                const taskQueue = (0, lifecycle_1.deriveTaskQueue)(wf);
+                (0, lifecycle_1.publishStartedEvents)(wf, taskQueue, undefined, wf.workflowId);
+                const result = toolCtx ? await (0, context_2.runWithToolContext)(toolCtx, next) : await next();
+                (0, publish_1.publishWorkflowEvent)({
+                    type: 'workflow.completed',
+                    source: 'interceptor',
+                    workflowId: wf.workflowId,
+                    workflowName: wf.workflowName,
+                    taskQueue,
+                    status: 'completed',
+                });
+                return result;
             }
             // 3. Load config — unregistered/uncertified workflows get ToolContext only
             const wfConfig = await activities.ltGetWorkflowConfig(wf.workflowName);
             if (!wfConfig) {
                 const toolCtx = (0, envelope_1.buildToolContextFromEnvelope)(envelope, wf.workflowId, wf.workflowTrace, wf.workflowSpan);
-                return toolCtx ? (0, context_2.runWithToolContext)(toolCtx, next) : next();
+                const taskQueue2 = (0, lifecycle_1.deriveTaskQueue)(wf);
+                (0, lifecycle_1.publishStartedEvents)(wf, taskQueue2, undefined, wf.workflowId);
+                const result2 = toolCtx ? await (0, context_2.runWithToolContext)(toolCtx, next) : await next();
+                (0, publish_1.publishWorkflowEvent)({
+                    type: 'workflow.completed',
+                    source: 'interceptor',
+                    workflowId: wf.workflowId,
+                    workflowName: wf.workflowName,
+                    taskQueue: taskQueue2,
+                    status: 'completed',
+                });
+                return result2;
             }
             const taskQueue = (0, lifecycle_1.deriveTaskQueue)(wf);
             // 3. Find existing task and handle re-run escalation resolution

package/build/services/interceptor/lifecycle.d.ts

@@ -37,7 +37,7 @@ export declare function resolveReRun(activities: ProxiedActivities, envelope: LT
  * Also injects originId back into the envelope for downstream consistency.
  */
 export declare function ensureTaskWithRouting(activities: ProxiedActivities, wf: WorkflowIdentity, envelope: LTEnvelope | undefined, existingTask: any | null, taskQueue: string, reRun: ReRunContext): Promise<TaskContext>;
-/** Publish workflow.started + task.started events. */
+/** Publish workflow.started event (guarded against replay). */
 export declare function publishStartedEvents(wf: WorkflowIdentity, taskQueue: string, taskId: string | undefined, originId: string): void;
 /** Complete a task and signal parent for plain (non-LTReturn) results. */
 export declare function completePlainResult(activities: ProxiedActivities, wf: WorkflowIdentity, taskQueue: string, taskId: string | undefined, routing: Record<string, any> | null, result: any): Promise<void>;

package/build/services/interceptor/lifecycle.js

@@ -13,6 +13,7 @@ exports.resolveReRun = resolveReRun;
 exports.ensureTaskWithRouting = ensureTaskWithRouting;
 exports.publishStartedEvents = publishStartedEvents;
 exports.completePlainResult = completePlainResult;
+const hotmesh_1 = require("@hotmeshio/hotmesh");
 const publish_1 = require("../../lib/events/publish");
 // ── Helpers ──────────────────────────────────────────────────────────────────
 /** Extract workflow identity fields from the HotMesh context map. */
@@ -56,17 +57,7 @@ async function resolveReRun(activities, envelope, existingTask, wf, taskQueue) {
             escalationId: escalationId,
             resolverPayload: envelope.resolver,
         });
-        (0, publish_1.publishEscalationEvent)({
-            type: 'escalation.resolved',
-            source: 'interceptor',
-            workflowId: wf.workflowId,
-            workflowName: wf.workflowName,
-            taskQueue,
-            taskId: task?.id || existingTask?.id,
-            escalationId: escalationId,
-            originId: envelope?.lt?.originId,
-            status: 'resolved',
-        });
+        // escalation.resolved event published by service layer (services/escalation/crud.ts)
     }
     return { isReRun, task, metadata };
 }
@@ -128,28 +119,23 @@ async function ensureTaskWithRouting(activities, wf, envelope, existingTask, tas
     }
     return { taskId, routing, originId };
 }
-/** Publish workflow.started + task.started events. */
+/** Publish workflow.started event (guarded against replay). */
 function publishStartedEvents(wf, taskQueue, taskId, originId) {
-    (0, publish_1.publishWorkflowEvent)({
-        type: 'workflow.started',
-        source: 'interceptor',
-        workflowId: wf.workflowId,
-        workflowName: wf.workflowName,
-        taskQueue,
-        taskId,
-        originId,
-        status: 'running',
-    });
-    (0, publish_1.publishTaskEvent)({
-        type: 'task.started',
-        source: 'interceptor',
-        workflowId: wf.workflowId,
-        workflowName: wf.workflowName,
-        taskQueue,
-        taskId: taskId,
-        originId,
-        status: 'in_progress',
-    });
+    const { replay } = hotmesh_1.Durable.workflow.workflowInfo();
+    const isFirstExecution = Object.keys(replay).length === 0;
+    if (isFirstExecution) {
+        (0, publish_1.publishWorkflowEvent)({
+            type: 'workflow.started',
+            source: 'interceptor',
+            workflowId: wf.workflowId,
+            workflowName: wf.workflowName,
+            taskQueue,
+            taskId,
+            originId,
+            status: 'running',
+        });
+    }
+    // task.started event published by service layer (services/task/crud.ts)
 }
 /** Complete a task and signal parent for plain (non-LTReturn) results. */
 async function completePlainResult(activities, wf, taskQueue, taskId, routing, result) {

package/build/services/task/crud.js

@@ -8,6 +8,7 @@ exports.getTaskBySignalId = getTaskBySignalId;
 exports.getTaskByWorkflowId = getTaskByWorkflowId;
 exports.listTasks = listTasks;
 const db_1 = require("../../lib/db");
+const publish_1 = require("../../lib/events/publish");
 const sql_1 = require("./sql");
 async function createTask(input) {
     const pool = (0, db_1.getPool)();
@@ -30,7 +31,18 @@ async function createTask(input) {
         input.executing_as || null,
         input.status || null,
     ]);
-    return rows[0];
+    const task = rows[0];
+    (0, publish_1.publishTaskEvent)({
+        type: 'task.created',
+        source: 'service',
+        workflowId: task.workflow_id || '',
+        workflowName: task.workflow_type || '',
+        taskQueue: task.task_queue || '',
+        taskId: task.id,
+        originId: task.origin_id || undefined,
+        status: task.status || 'pending',
+    });
+    return task;
 }
 async function updateTask(id, input) {
     const pool = (0, db_1.getPool)();
@@ -59,7 +71,29 @@ async function updateTask(id, input) {
     }
     values.push(id);
     const { rows } = await pool.query(`UPDATE lt_tasks SET ${sets.join(', ')} WHERE id = $${idx} RETURNING *`, values);
-    return rows[0];
+    const task = rows[0];
+    // Publish status-driven events from the single write path
+    if (input.status && task) {
+        const STATUS_EVENTS = {
+            in_progress: 'task.started',
+            completed: 'task.completed',
+            needs_intervention: 'task.escalated',
+        };
+        const eventType = STATUS_EVENTS[input.status];
+        if (eventType) {
+            (0, publish_1.publishTaskEvent)({
+                type: eventType,
+                source: 'service',
+                workflowId: task.workflow_id || '',
+                workflowName: task.workflow_type || '',
+                taskQueue: task.task_queue || '',
+                taskId: task.id,
+                originId: task.origin_id || undefined,
+                status: input.status,
+            });
+        }
+    }
+    return task;
 }
 async function appendMilestones(id, milestones) {
     const pool = (0, db_1.getPool)();

package/build/start/index.js

@@ -14,6 +14,8 @@ const adapters_1 = require("./adapters");
 const workers_1 = require("./workers");
 const server_1 = require("./server");
 const socketio_1 = require("../lib/events/socketio");
+const nats_1 = require("../lib/events/nats");
+const nats_ws_proxy_1 = require("../lib/events/nats-ws-proxy");
 /**
  * Start Long Tail with a declarative configuration.
  *
@@ -79,6 +81,18 @@ async function start(startConfig) {
             socketAdapter.attachServer(httpServer);
             await socketAdapter.connect();
         }
+        // Attach NATS WebSocket proxy (if configured)
+        const natsAdapter = events_1.eventRegistry.getAdapter(nats_1.NatsEventAdapter);
+        if (natsAdapter?.wsProxyTarget && httpServer) {
+            (0, nats_ws_proxy_1.attachNatsWsProxy)(httpServer, natsAdapter.wsProxyTarget, {
+                onWsUrlDerived: (url) => {
+                    // Auto-set wsUrl if not explicitly configured
+                    if (!natsAdapter.wsUrl) {
+                        natsAdapter.setWsUrl(url);
+                    }
+                },
+            });
+        }
     }
     // 7. Return instance
     const connection = (0, workers_1.buildConnection)();