@hotmeshio/long-tail 0.4.12 → 0.4.14

package/build/api/index.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.maintenance = exports.namespaces = exports.dba = exports.workflowSets = exports.botAccounts = exports.controlplane = exports.exports = exports.settings = exports.insight = exports.mcpRuns = exports.mcp = exports.auth = exports.roles = exports.users = exports.yamlWorkflows = exports.workflows = exports.escalations = exports.tasks = void 0;
+exports.maintenance = exports.namespaces = exports.dba = exports.workflowSets = exports.botAccounts = exports.controlplane = exports.exports = exports.settings = exports.insight = exports.mcpRuns = exports.pipelines = exports.mcp = exports.auth = exports.roles = exports.users = exports.yamlWorkflows = exports.workflows = exports.escalations = exports.tasks = void 0;
 exports.tasks = __importStar(require("./tasks"));
 exports.escalations = __importStar(require("./escalations"));
 exports.workflows = __importStar(require("./workflows"));
@@ -42,7 +42,8 @@ exports.users = __importStar(require("./users"));
 exports.roles = __importStar(require("./roles"));
 exports.auth = __importStar(require("./auth"));
 exports.mcp = __importStar(require("./mcp"));
-exports.mcpRuns = __importStar(require("./mcp-runs"));
+exports.pipelines = __importStar(require("./pipelines"));
+exports.mcpRuns = __importStar(require("./pipelines")); // backward-compat alias
 exports.insight = __importStar(require("./insight"));
 exports.settings = __importStar(require("./settings"));
 exports.exports = __importStar(require("./exports"));

package/build/api/{mcp-runs.d.ts → pipelines.d.ts}

@@ -43,3 +43,21 @@ export declare function getJobExecution(input: {
     jobId: string;
     app_id: string;
 }): Promise<LTApiResult>;
+/**
+ * Interrupt a running pipeline job via HotMesh.interrupt().
+ *
+ * This is the pipeline equivalent of the durable terminate endpoint.
+ * Pipelines run as raw HotMesh YAML DAGs, not through the Durable
+ * abstraction, so they require the app_id (namespace) and topic
+ * to locate the correct engine instance.
+ *
+ * @param input.jobId — HotMesh job ID (workflow_id)
+ * @param input.topic — workflow entity/topic name
+ * @param input.app_id — HotMesh namespace (e.g. "hmsh", "longtail")
+ * @returns `{ status: 200, data: { interrupted: true } }` or error
+ */
+export declare function interruptJob(input: {
+    jobId: string;
+    topic: string;
+    app_id: string;
+}): Promise<LTApiResult>;

package/build/api/{mcp-runs.js → pipelines.js}

@@ -3,8 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.listEntities = listEntities;
 exports.listJobs = listJobs;
 exports.getJobExecution = getJobExecution;
+exports.interruptJob = interruptJob;
 const hotmesh_utils_1 = require("../services/hotmesh-utils");
-const mcp_runs_1 = require("../services/mcp-runs");
+const pipelines_1 = require("../services/pipelines");
+const controlplane_1 = require("../services/controlplane");
 /**
  * List distinct entity types for an app (HotMesh namespace).
  *
@@ -16,7 +18,7 @@ async function listEntities(input) {
         if (!input.app_id) {
             return { status: 400, error: 'app_id query parameter is required' };
         }
-        const entities = await (0, mcp_runs_1.listEntities)(input.app_id);
+        const entities = await (0, pipelines_1.listEntities)(input.app_id);
         return { status: 200, data: { entities } };
     }
     catch (err) {
@@ -42,7 +44,7 @@ async function listJobs(input) {
         if (!input.app_id) {
             return { status: 400, error: 'app_id query parameter is required' };
         }
-        const result = await (0, mcp_runs_1.listJobs)({
+        const result = await (0, pipelines_1.listJobs)({
             rawAppId: input.app_id,
             limit: input.limit,
             offset: input.offset,
@@ -78,7 +80,7 @@ async function getJobExecution(input) {
         }
         const appId = (0, hotmesh_utils_1.sanitizeAppId)(input.app_id);
         const schema = (0, hotmesh_utils_1.quoteSchema)(appId);
-        const execution = await (0, mcp_runs_1.buildExecution)(input.jobId, appId, schema);
+        const execution = await (0, pipelines_1.buildExecution)(input.jobId, appId, schema);
         return { status: 200, data: execution };
     }
     catch (err) {
@@ -89,3 +91,33 @@ async function getJobExecution(input) {
         return { status: 500, error: msg };
     }
 }
+/**
+ * Interrupt a running pipeline job via HotMesh.interrupt().
+ *
+ * This is the pipeline equivalent of the durable terminate endpoint.
+ * Pipelines run as raw HotMesh YAML DAGs, not through the Durable
+ * abstraction, so they require the app_id (namespace) and topic
+ * to locate the correct engine instance.
+ *
+ * @param input.jobId — HotMesh job ID (workflow_id)
+ * @param input.topic — workflow entity/topic name
+ * @param input.app_id — HotMesh namespace (e.g. "hmsh", "longtail")
+ * @returns `{ status: 200, data: { interrupted: true } }` or error
+ */
+async function interruptJob(input) {
+    try {
+        if (!input.app_id) {
+            return { status: 400, error: 'app_id is required' };
+        }
+        if (!input.topic) {
+            return { status: 400, error: 'topic is required' };
+        }
+        const appId = (0, hotmesh_utils_1.sanitizeAppId)(input.app_id);
+        const engine = await (0, controlplane_1.getEngine)(appId);
+        await engine.interrupt(input.topic, input.jobId);
+        return { status: 200, data: { interrupted: true, jobId: input.jobId } };
+    }
+    catch (err) {
+        return { status: 500, error: err.message };
+    }
+}

package/build/api/workflows/discovery.js

@@ -40,7 +40,7 @@ const configService = __importStar(require("../../services/config"));
 const cron_1 = require("../../services/cron");
 const db_1 = require("../../lib/db");
 const registry_1 = require("../../services/workers/registry");
-const sql_1 = require("../../services/mcp-runs/sql");
+const sql_1 = require("../../services/pipelines/sql");
 /**
  * List active workflow workers with their registration status.
  *

package/build/bin/ltc.js

@@ -134,6 +134,23 @@ escCmd.command('release <id>')
 escCmd.command('resolve <id>')
     .requiredOption('--data <json>', 'Resolver payload (JSON string)')
     .action(wrap(esc.resolveEscalation));
+escCmd.command('find-by-meta <key> <value>')
+    .description('Find escalations by metadata key-value pair')
+    .option('--status <status>', 'Filter by status')
+    .option('--limit <n>', 'Max results')
+    .option('--json', 'JSON output')
+    .option('-q, --quiet', 'IDs only')
+    .action(wrap(esc.findByMetadata));
+escCmd.command('claim-by-meta <key> <value>')
+    .description('Claim an escalation by metadata key-value pair')
+    .option('--duration <minutes>', 'Claim duration in minutes')
+    .option('--assignee <external_id>', 'Claim on behalf of user (external_id)')
+    .action(wrap(esc.claimByMetadata));
+escCmd.command('resolve-by-meta <key> <value>')
+    .description('Resolve an escalation by metadata key-value pair')
+    .option('--data <json>', 'Resolver payload (JSON string)')
+    .option('--assignee <external_id>', 'Resolve on behalf of user (external_id)')
+    .action(wrap(esc.resolveByMetadata));
 // ── Workflows ────────────────────────────────────────────────────────────
 const wfCmd = commander_1.program.command('workflows').alias('wf').description('Manage durable workflows');
 wfCmd.command('list')

package/build/lib/cli/commands/escalations.d.ts

@@ -16,4 +16,13 @@ export declare function releaseEscalation(id: string): Promise<void>;
 export declare function resolveEscalation(id: string, opts: {
     data?: string;
 }): Promise<void>;
+export declare function findByMetadata(key: string, value: string, opts: ListOptions): Promise<void>;
+export declare function claimByMetadata(key: string, value: string, opts: {
+    duration?: string;
+    assignee?: string;
+}): Promise<void>;
+export declare function resolveByMetadata(key: string, value: string, opts: {
+    data?: string;
+    assignee?: string;
+}): Promise<void>;
 export {};

package/build/lib/cli/commands/escalations.js

@@ -8,6 +8,9 @@ exports.getEscalation = getEscalation;
 exports.claimEscalation = claimEscalation;
 exports.releaseEscalation = releaseEscalation;
 exports.resolveEscalation = resolveEscalation;
+exports.findByMetadata = findByMetadata;
+exports.claimByMetadata = claimByMetadata;
+exports.resolveByMetadata = resolveByMetadata;
 const picocolors_1 = __importDefault(require("picocolors"));
 const client_1 = require("../client");
 const format_1 = require("../format");
@@ -67,3 +70,36 @@ async function resolveEscalation(id, opts) {
     });
     console.log(`\n  ${picocolors_1.default.green('✓')} Resolved ${picocolors_1.default.dim(id)}\n`);
 }
+// --- Metadata candidate key commands ----------------------------------------
+async function findByMetadata(key, value, opts) {
+    const params = new URLSearchParams({ key, value });
+    if (opts.status)
+        params.set('status', opts.status);
+    if (opts.limit)
+        params.set('limit', opts.limit);
+    const data = await (0, client_1.apiFetch)(`/escalations/by-metadata?${params}`);
+    (0, format_1.output)(data, data.escalations || [], COLUMNS, opts);
+}
+async function claimByMetadata(key, value, opts) {
+    const body = { key, value };
+    if (opts.duration)
+        body.durationMinutes = parseInt(opts.duration, 10);
+    if (opts.assignee)
+        body.assignee = opts.assignee;
+    const data = await (0, client_1.apiFetch)('/escalations/claim-by-metadata', {
+        method: 'POST',
+        body: JSON.stringify(body),
+    });
+    console.log(`\n  ${picocolors_1.default.green('✓')} Claimed ${picocolors_1.default.dim(data.escalation?.id || '')} by ${key}=${value}\n`);
+}
+async function resolveByMetadata(key, value, opts) {
+    const resolverPayload = opts.data ? JSON.parse(opts.data) : {};
+    const body = { key, value, resolverPayload };
+    if (opts.assignee)
+        body.assignee = opts.assignee;
+    await (0, client_1.apiFetch)('/escalations/resolve-by-metadata', {
+        method: 'POST',
+        body: JSON.stringify(body),
+    });
+    console.log(`\n  ${picocolors_1.default.green('✓')} Resolved by ${key}=${value}\n`);
+}

package/build/lib/db/schemas/010_metadata_gin.sql

@@ -0,0 +1,5 @@
+-- GIN index for JSONB containment queries on lt_escalations.metadata.
+-- Enables efficient lookups like: WHERE metadata @> '{"orderId":"order-123"}'::jsonb
+-- Uses jsonb_path_ops (smaller, faster for @> queries).
+CREATE INDEX IF NOT EXISTS idx_lt_escalations_metadata
+  ON lt_escalations USING GIN (metadata jsonb_path_ops);

package/build/routes/escalations/index.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const express_1 = require("express");
 const list_1 = require("./list");
 const bulk_1 = require("./bulk");
+const metadata_1 = require("./metadata");
 const single_1 = require("./single");
 const resolve_1 = require("./resolve");
 const router = (0, express_1.Router)();
@@ -12,6 +13,8 @@ const router = (0, express_1.Router)();
 // POST /release-expired, PATCH /priority, POST /bulk-claim,
 // POST /bulk-assign, PATCH /bulk-escalate, POST /bulk-triage
 (0, bulk_1.registerBulkRoutes)(router);
+// GET /by-metadata, POST /claim-by-metadata, POST /resolve-by-metadata
+(0, metadata_1.registerMetadataRoutes)(router);
 // PATCH /:id/escalate, GET /by-workflow/:workflowId,
 // GET /:id, POST /:id/claim, POST /:id/release
 (0, single_1.registerSingleRoutes)(router);

package/build/routes/escalations/metadata.d.ts

@@ -0,0 +1,6 @@
+import type { Router } from 'express';
+/**
+ * Register metadata-based escalation lookup routes.
+ * Must be registered BEFORE parameterized /:id routes.
+ */
+export declare function registerMetadataRoutes(router: Router): void;

package/build/routes/escalations/metadata.js

@@ -0,0 +1,86 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerMetadataRoutes = registerMetadataRoutes;
+const api = __importStar(require("../../api/escalations"));
+/**
+ * Register metadata-based escalation lookup routes.
+ * Must be registered BEFORE parameterized /:id routes.
+ */
+function registerMetadataRoutes(router) {
+    /**
+     * GET /api/escalations/by-metadata
+     * Find escalations by a metadata key-value pair.
+     * Query: key, value, status?, limit?, offset?
+     */
+    router.get('/by-metadata', async (req, res) => {
+        const result = await api.findByMetadata({
+            key: req.query.key,
+            value: req.query.value,
+            status: req.query.status,
+            limit: req.query.limit ? parseInt(req.query.limit, 10) : undefined,
+            offset: req.query.offset ? parseInt(req.query.offset, 10) : undefined,
+        }, req.auth);
+        res.status(result.status).json(result.data ?? { error: result.error });
+    });
+    /**
+     * POST /api/escalations/claim-by-metadata
+     * Find and claim an escalation by metadata key-value pair.
+     * Body: { key, value, durationMinutes?, assignee? }
+     */
+    router.post('/claim-by-metadata', async (req, res) => {
+        const result = await api.claimByMetadata({
+            key: req.body?.key,
+            value: req.body?.value,
+            durationMinutes: req.body?.durationMinutes,
+            assignee: req.body?.assignee,
+        }, req.auth);
+        res.status(result.status).json(result.data ?? { error: result.error });
+    });
+    /**
+     * POST /api/escalations/resolve-by-metadata
+     * Find and resolve an escalation by metadata key-value pair.
+     * Body: { key, value, resolverPayload, assignee? }
+     */
+    router.post('/resolve-by-metadata', async (req, res) => {
+        const result = await api.resolveByMetadata({
+            key: req.body?.key,
+            value: req.body?.value,
+            resolverPayload: req.body?.resolverPayload,
+            assignee: req.body?.assignee,
+        }, req.auth);
+        res.status(result.status).json(result.data ?? { error: result.error });
+    });
+}

package/build/routes/index.js

@@ -20,7 +20,7 @@ const mcp_1 = __importDefault(require("./mcp"));
 const insight_1 = __importDefault(require("./insight"));
 const yaml_workflows_1 = __importDefault(require("./yaml-workflows"));
 const settings_1 = __importDefault(require("./settings"));
-const mcp_runs_1 = __importDefault(require("./mcp-runs"));
+const pipelines_1 = __importDefault(require("./pipelines"));
 const namespaces_1 = __importDefault(require("./namespaces"));
 const files_1 = __importDefault(require("./files"));
 const file_browser_1 = __importDefault(require("./file-browser"));
@@ -54,7 +54,8 @@ router.use('/dba', dba_1.default);
 router.use('/mcp', mcp_1.default);
 router.use('/insight', insight_1.default);
 router.use('/yaml-workflows', yaml_workflows_1.default);
-router.use('/mcp-runs', mcp_runs_1.default);
+router.use('/pipelines', pipelines_1.default);
+router.use('/mcp-runs', pipelines_1.default); // backward-compat alias
 router.use('/namespaces', namespaces_1.default);
 router.use('/file-browser', file_browser_1.default);
 router.use('/controlplane', controlplane_1.default);

package/build/routes/{mcp-runs.js → pipelines.js}

@@ -34,11 +34,11 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 const express_1 = require("express");
-const api = __importStar(require("../api/mcp-runs"));
+const api = __importStar(require("../api/pipelines"));
 const router = (0, express_1.Router)();
 // ── Routes ───────────────────────────────────────────────────────────────────
 /**
- * GET /api/mcp-runs/entities
+ * GET /api/pipelines/entities
  * Return distinct entity (tool) names from {appId}.jobs,
  * supplemented with graph_topics from yaml_workflows for this app_id.
  */
@@ -49,7 +49,7 @@ router.get('/entities', async (req, res) => {
     res.status(result.status).json(result.data ?? { error: result.error });
 });
 /**
- * GET /api/mcp-runs
+ * GET /api/pipelines
  * List jobs from {appId}.jobs for a given app_id.
  */
 router.get('/', async (req, res) => {
@@ -66,7 +66,7 @@ router.get('/', async (req, res) => {
     res.status(result.status).json(result.data ?? { error: result.error });
 });
 /**
- * GET /api/mcp-runs/:jobId/execution
+ * GET /api/pipelines/:jobId/execution
  * Export execution details for a specific HotMesh pipeline job.
  */
 router.get('/:jobId/execution', async (req, res) => {
@@ -76,4 +76,17 @@ router.get('/:jobId/execution', async (req, res) => {
     });
     res.status(result.status).json(result.data ?? { error: result.error });
 });
+/**
+ * POST /api/pipelines/:jobId/interrupt
+ * Interrupt a running pipeline job via HotMesh.interrupt().
+ * Body: { topic, app_id }
+ */
+router.post('/:jobId/interrupt', async (req, res) => {
+    const result = await api.interruptJob({
+        jobId: req.params.jobId,
+        topic: req.body.topic,
+        app_id: req.body.app_id,
+    });
+    res.status(result.status).json(result.data ?? { error: result.error });
+});
 exports.default = router;

package/build/sdk/index.d.ts

@@ -6,7 +6,7 @@ import * as usersApi from '../api/users';
 import * as rolesApi from '../api/roles';
 import * as authApi from '../api/auth';
 import * as mcpApi from '../api/mcp';
-import * as mcpRunsApi from '../api/mcp-runs';
+import * as pipelinesApi from '../api/pipelines';
 import * as insightApi from '../api/insight';
 import * as settingsApi from '../api/settings';
 import * as exportsApi from '../api/exports';
@@ -150,6 +150,25 @@ export declare function createClient(options?: LTClientOptions): {
             ids: string[];
             hint?: string;
         }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+        findByMetadata: (input: {
+            key: string;
+            value: string;
+            status?: string;
+            limit?: number;
+            offset?: number;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+        claimByMetadata: (input: {
+            key: string;
+            value: string;
+            durationMinutes?: number;
+            assignee?: string;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+        resolveByMetadata: (input: {
+            key: string;
+            value: string;
+            resolverPayload: Record<string, any>;
+            assignee?: string;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
     };
     workflows: {
         invoke: (input: {
@@ -241,10 +260,17 @@ export declare function createClient(options?: LTClientOptions): {
             execute_as?: string;
         }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
     };
+    pipelines: {
+        listEntities: typeof pipelinesApi.listEntities;
+        listJobs: typeof pipelinesApi.listJobs;
+        getExecution: typeof pipelinesApi.getJobExecution;
+        interrupt: typeof pipelinesApi.interruptJob;
+    };
+    /** @deprecated Use `pipelines` */
     mcpRuns: {
-        listEntities: typeof mcpRunsApi.listEntities;
-        listJobs: typeof mcpRunsApi.listJobs;
-        getExecution: typeof mcpRunsApi.getJobExecution;
+        listEntities: typeof pipelinesApi.listEntities;
+        listJobs: typeof pipelinesApi.listJobs;
+        getExecution: typeof pipelinesApi.getJobExecution;
     };
     insight: {
         mcpQuery: (input: {

package/build/sdk/index.js

@@ -42,7 +42,7 @@ const usersApi = __importStar(require("../api/users"));
 const rolesApi = __importStar(require("../api/roles"));
 const authApi = __importStar(require("../api/auth"));
 const mcpApi = __importStar(require("../api/mcp"));
-const mcpRunsApi = __importStar(require("../api/mcp-runs"));
+const pipelinesApi = __importStar(require("../api/pipelines"));
 const insightApi = __importStar(require("../api/insight"));
 const settingsApi = __importStar(require("../api/settings"));
 const exportsApi = __importStar(require("../api/exports"));
@@ -130,6 +130,9 @@ function createClient(options = {}) {
             bulkAssign: bindAuth(escalationsApi.bulkAssign, auth),
             bulkEscalate: bindAuth(escalationsApi.bulkEscalate, auth),
             bulkTriage: bindAuth(escalationsApi.bulkTriage, auth),
+            findByMetadata: bindAuth(escalationsApi.findByMetadata, auth),
+            claimByMetadata: bindAuth(escalationsApi.claimByMetadata, auth),
+            resolveByMetadata: bindAuth(escalationsApi.resolveByMetadata, auth),
         },
         // ── Workflows ──────────────────────────────────────────────────────────
         workflows: {
@@ -208,11 +211,18 @@ function createClient(options = {}) {
             listTools: mcpApi.listMcpServerTools,
             callTool: bindOptionalAuth(mcpApi.callMcpTool, auth),
         },
-        // ── MCP Runs ───────────────────────────────────────────────────────────
+        // ── Pipelines ──────────────────────────────────────────────────────────
+        pipelines: {
+            listEntities: pipelinesApi.listEntities,
+            listJobs: pipelinesApi.listJobs,
+            getExecution: pipelinesApi.getJobExecution,
+            interrupt: pipelinesApi.interruptJob,
+        },
+        /** @deprecated Use `pipelines` */
         mcpRuns: {
-            listEntities: mcpRunsApi.listEntities,
-            listJobs: mcpRunsApi.listJobs,
-            getExecution: mcpRunsApi.getJobExecution,
+            listEntities: pipelinesApi.listEntities,
+            listJobs: pipelinesApi.listJobs,
+            getExecution: pipelinesApi.getJobExecution,
         },
         // ── Insight ────────────────────────────────────────────────────────────
         insight: {

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

@@ -45,3 +45,8 @@ export declare function enrichEscalationRouting(id: string, metadataPatch: Recor
     taskId?: string;
 }): Promise<LTEscalationRecord | null>;
 export declare function getEscalationsByOriginId(originId: string): Promise<LTEscalationRecord[]>;
+export declare function findByMetadata(key: string, value: string, status?: string, limit?: number, offset?: number): Promise<{
+    escalations: LTEscalationRecord[];
+    total: number;
+}>;
+export declare function claimByMetadata(key: string, value: string, userId: string, durationMinutes?: number): Promise<ClaimResult | null>;

package/build/services/escalation/crud.js

@@ -14,6 +14,8 @@ exports.getEscalationsByWorkflowId = getEscalationsByWorkflowId;
 exports.updateEscalationMetadata = updateEscalationMetadata;
 exports.enrichEscalationRouting = enrichEscalationRouting;
 exports.getEscalationsByOriginId = getEscalationsByOriginId;
+exports.findByMetadata = findByMetadata;
+exports.claimByMetadata = claimByMetadata;
 const db_1 = require("../../lib/db");
 const sql_1 = require("./sql");
 async function createEscalation(input) {
@@ -148,3 +150,28 @@ async function getEscalationsByOriginId(originId) {
     const { rows } = await pool.query(sql_1.GET_ESCALATIONS_BY_ORIGIN_ID, [originId]);
     return rows;
 }
+// --- Metadata candidate key lookups -----------------------------------------
+async function findByMetadata(key, value, status, limit = 50, offset = 0) {
+    const pool = (0, db_1.getPool)();
+    const filter = JSON.stringify({ [key]: value });
+    const [countResult, dataResult] = await Promise.all([
+        pool.query(sql_1.COUNT_BY_METADATA, [filter, status || null]),
+        pool.query(sql_1.FIND_BY_METADATA, [filter, status || null, limit, offset]),
+    ]);
+    return {
+        escalations: dataResult.rows,
+        total: parseInt(countResult.rows[0].count, 10),
+    };
+}
+async function claimByMetadata(key, value, userId, durationMinutes = 30) {
+    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]);
+    if (rows.length === 0)
+        return null;
+    const row = rows[0];
+    return {
+        escalation: row,
+        isExtension: row.prev_assigned_to === userId,
+    };
+}

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

@@ -19,3 +19,8 @@ export declare const BULK_RESOLVE_FOR_TRIAGE = "UPDATE lt_escalations\nSET statu
 export declare const UPDATE_ESCALATION_METADATA = "UPDATE lt_escalations\nSET metadata = COALESCE(metadata, '{}'::jsonb) || $2::jsonb,\n    updated_at = NOW()\nWHERE id = $1\nRETURNING *";
 export declare const ENRICH_ESCALATION_ROUTING = "UPDATE lt_escalations\nSET metadata = COALESCE(metadata, '{}'::jsonb) || $2::jsonb,\n    workflow_type = COALESCE(workflow_type, $3),\n    workflow_id = COALESCE(workflow_id, $4),\n    task_queue = COALESCE(task_queue, $5),\n    task_id = COALESCE(task_id, $6),\n    updated_at = NOW()\nWHERE id = $1\nRETURNING *";
 export declare const LIST_DISTINCT_TYPES = "SELECT DISTINCT type FROM lt_escalations ORDER BY type";
+/** 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";

package/build/services/escalation/sql.js

@@ -3,7 +3,7 @@
 // Escalation SQL – externalized from crud.ts, bulk.ts, queries.ts
 // ---------------------------------------------------------------------------
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LIST_DISTINCT_TYPES = exports.ENRICH_ESCALATION_ROUTING = exports.UPDATE_ESCALATION_METADATA = exports.BULK_RESOLVE_FOR_TRIAGE = exports.BULK_ESCALATE_TO_ROLE = exports.BULK_ASSIGN = exports.BULK_CLAIM = exports.GET_ESCALATIONS_BY_ORIGIN_ID = exports.GET_ESCALATIONS_BY_WORKFLOW_ID = exports.GET_ESCALATIONS_BY_TASK_ID = exports.GET_ESCALATION = exports.ESCALATE_TO_ROLE = exports.RELEASE_EXPIRED_CLAIMS = exports.RELEASE_ESCALATION = exports.GET_ESCALATION_ROLES = exports.UPDATE_ESCALATIONS_PRIORITY = exports.RESOLVE_ESCALATION = exports.CLAIM_ESCALATION = exports.CREATE_ESCALATION = exports.ENSURE_ROLE_EXISTS = void 0;
+exports.CLAIM_BY_METADATA = exports.COUNT_BY_METADATA = exports.FIND_BY_METADATA = exports.LIST_DISTINCT_TYPES = exports.ENRICH_ESCALATION_ROUTING = exports.UPDATE_ESCALATION_METADATA = exports.BULK_RESOLVE_FOR_TRIAGE = exports.BULK_ESCALATE_TO_ROLE = exports.BULK_ASSIGN = exports.BULK_CLAIM = exports.GET_ESCALATIONS_BY_ORIGIN_ID = exports.GET_ESCALATIONS_BY_WORKFLOW_ID = exports.GET_ESCALATIONS_BY_TASK_ID = exports.GET_ESCALATION = exports.ESCALATE_TO_ROLE = exports.RELEASE_EXPIRED_CLAIMS = exports.RELEASE_ESCALATION = exports.GET_ESCALATION_ROLES = exports.UPDATE_ESCALATIONS_PRIORITY = exports.RESOLVE_ESCALATION = exports.CLAIM_ESCALATION = exports.CREATE_ESCALATION = exports.ENSURE_ROLE_EXISTS = void 0;
 // --- Role management -------------------------------------------------------
 exports.ENSURE_ROLE_EXISTS = 'INSERT INTO lt_roles (role) VALUES ($1) ON CONFLICT DO NOTHING';
 // --- Single-record CRUD ---------------------------------------------------
@@ -133,3 +133,41 @@ SET metadata = COALESCE(metadata, '{}'::jsonb) || $2::jsonb,
 WHERE id = $1
 RETURNING *`;
 exports.LIST_DISTINCT_TYPES = 'SELECT DISTINCT type FROM lt_escalations ORDER BY type';
+// --- Metadata candidate key lookups -----------------------------------------
+/** Find escalations by a single metadata key-value pair. */
+exports.FIND_BY_METADATA = `\
+SELECT * FROM lt_escalations
+WHERE metadata @> $1::jsonb
+  AND ($2::text IS NULL OR status = $2)
+ORDER BY priority ASC, created_at ASC
+LIMIT $3 OFFSET $4`;
+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. */
+exports.CLAIM_BY_METADATA = `\
+WITH target AS (
+  SELECT id, assigned_to
+  FROM lt_escalations
+  WHERE metadata @> $1::jsonb
+    AND status = 'pending'
+    AND (
+      assigned_to IS NULL
+      OR assigned_until <= NOW()
+      OR assigned_to = $2
+    )
+  ORDER BY priority ASC, created_at ASC
+  LIMIT 1
+  FOR UPDATE SKIP LOCKED
+),
+updated AS (
+  UPDATE lt_escalations e
+  SET assigned_to = $2,
+      claimed_at = NOW(),
+      assigned_until = NOW() + INTERVAL '1 minute' * $3
+  FROM target t
+  WHERE e.id = t.id
+  RETURNING e.*, t.assigned_to AS prev_assigned_to
+)
+SELECT * FROM updated`;

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

@@ -39,6 +39,7 @@ 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).
@@ -106,5 +107,15 @@ 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 },
+    });
     return escalation.id;
 }

package/build/services/{mcp-runs → pipelines}/sql.js

@@ -1,5 +1,5 @@
 "use strict";
-// SQL templates for mcp-runs queries.
+// SQL templates for pipeline queries.
 // Schema placeholders (${schema}) are interpolated at call time
 // because Postgres does not support parameterized schema names.
 Object.defineProperty(exports, "__esModule", { value: true });