@hotmeshio/long-tail 0.1.3 → 0.1.5

package/build/{services → lib}/db/index.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPool = getPool;
 exports.closePool = closePool;
+exports.getConnection = getConnection;
 const pg_1 = require("pg");
 const config_1 = require("../../modules/config");
 let pool = null;
@@ -17,3 +18,11 @@ async function closePool() {
         pool = null;
     }
 }
+/**
+ * HotMesh connection descriptor: `{ class: Client, options: postgres_options }`.
+ * Use this everywhere HotMesh / Durable APIs need a connection config
+ * instead of importing `pg` and `postgres_options` directly.
+ */
+function getConnection() {
+    return { class: pg_1.Client, options: config_1.postgres_options };
+}

package/build/{services → lib}/db/migrate.js

@@ -38,8 +38,8 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const index_1 = require("./index");
 const logger_1 = require("../logger");
-// In dev: __dirname = services/db → schemas is ./schemas
-// In built/published: __dirname = build/services/db → schemas is ../../../services/db/schemas
+// In dev: __dirname = lib/db → schemas is ./schemas
+// In built/published: __dirname = build/lib/db → schemas is ../../../lib/db/schemas
 const devPath = path.join(__dirname, 'schemas');
 const SCHEMAS_DIR = fs.existsSync(devPath)
     ? devPath
@@ -68,7 +68,7 @@ async function migrate() {
         }
     }
 }
-// run directly: npx ts-node services/db/migrate.ts
+// run directly: npx ts-node lib/db/migrate.ts
 if (require.main === module) {
     require('dotenv').config();
     migrate()

package/build/{services → lib}/telemetry/honeycomb.d.ts

@@ -26,8 +26,8 @@ export interface HoneycombOptions {
  *
  * Usage:
  * ```typescript
- * import { telemetryRegistry } from './services/telemetry';
- * import { HoneycombTelemetryAdapter } from './services/telemetry/honeycomb';
+ * import { telemetryRegistry } from './lib/telemetry';
+ * import { HoneycombTelemetryAdapter } from './lib/telemetry/honeycomb';
  *
  * telemetryRegistry.register(new HoneycombTelemetryAdapter({
  *   apiKey: process.env.HONEYCOMB_API_KEY,

package/build/{services → lib}/telemetry/honeycomb.js

@@ -19,8 +19,8 @@ const logger_1 = require("../logger");
  *
  * Usage:
  * ```typescript
- * import { telemetryRegistry } from './services/telemetry';
- * import { HoneycombTelemetryAdapter } from './services/telemetry/honeycomb';
+ * import { telemetryRegistry } from './lib/telemetry';
+ * import { HoneycombTelemetryAdapter } from './lib/telemetry/honeycomb';
  *
  * telemetryRegistry.register(new HoneycombTelemetryAdapter({
  *   apiKey: process.env.HONEYCOMB_API_KEY,

package/build/modules/defaults.d.ts

@@ -23,6 +23,8 @@ export declare const LLM_MAX_TOKENS_VISION: number;
 export declare const LLM_MAX_ARRAY_ITEMS: number;
 /** Hard character cap on serialized input payloads sent to the LLM. */
 export declare const LLM_MAX_INPUT_CHARS: number;
+/** Max characters for a single tool result before truncation in the agentic loop. */
+export declare const TOOL_RESULT_MAX_CHARS: number;
 /** Max agentic loop iterations for MCP triage workflows. */
 export declare const TOOL_ROUNDS_TRIAGE: number;
 /** Max agentic loop iterations for mcpQuery (higher — includes recall + discover + persist phases). */

package/build/modules/defaults.js

@@ -9,7 +9,7 @@
  * Grouped by domain so related knobs live together.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.YAML_LINE_WIDTH = exports.STOP_WORDS = exports.CLAIM_DURATION_OPTIONS = exports.YAML_VERSION_LIMIT = exports.YAML_LIST_LIMIT = exports.QUERY_LIMIT_MAX = exports.QUERY_LIMIT_DEFAULT = exports.CONFIG_CACHE_TTL_MS = exports.MCP_TOOL_TIMEOUT_MS = exports.WORKFLOW_SYNC_TIMEOUT_MS = exports.JOB_EXPIRE_SECS = exports.WORKFLOW_EXPIRE_SECS = exports.TOOL_ARG_LIMIT_CAP = exports.TOOL_ROUNDS_MCP_QUERY = exports.TOOL_ROUNDS_TRIAGE = exports.LLM_MAX_INPUT_CHARS = exports.LLM_MAX_ARRAY_ITEMS = exports.LLM_MAX_TOKENS_VISION = exports.LLM_MAX_TOKENS_JSON = exports.LLM_MAX_TOKENS_DEFAULT = exports.LLM_BASE_URL = exports.LLM_MODEL_SECONDARY = exports.LLM_MODEL_PRIMARY = void 0;
+exports.YAML_LINE_WIDTH = exports.STOP_WORDS = exports.CLAIM_DURATION_OPTIONS = exports.YAML_VERSION_LIMIT = exports.YAML_LIST_LIMIT = exports.QUERY_LIMIT_MAX = exports.QUERY_LIMIT_DEFAULT = exports.CONFIG_CACHE_TTL_MS = exports.MCP_TOOL_TIMEOUT_MS = exports.WORKFLOW_SYNC_TIMEOUT_MS = exports.JOB_EXPIRE_SECS = exports.WORKFLOW_EXPIRE_SECS = exports.TOOL_ARG_LIMIT_CAP = exports.TOOL_ROUNDS_MCP_QUERY = exports.TOOL_ROUNDS_TRIAGE = exports.TOOL_RESULT_MAX_CHARS = exports.LLM_MAX_INPUT_CHARS = exports.LLM_MAX_ARRAY_ITEMS = exports.LLM_MAX_TOKENS_VISION = exports.LLM_MAX_TOKENS_JSON = exports.LLM_MAX_TOKENS_DEFAULT = exports.LLM_BASE_URL = exports.LLM_MODEL_SECONDARY = exports.LLM_MODEL_PRIMARY = void 0;
 function envInt(key, fallback) {
     const v = process.env[key];
     if (v === undefined || v === '')
@@ -37,6 +37,8 @@ exports.LLM_MAX_TOKENS_VISION = envInt('LT_LLM_MAX_TOKENS_VISION', 2000);
 exports.LLM_MAX_ARRAY_ITEMS = envInt('LT_LLM_MAX_ARRAY_ITEMS', 25);
 /** Hard character cap on serialized input payloads sent to the LLM. */
 exports.LLM_MAX_INPUT_CHARS = envInt('LT_LLM_MAX_INPUT_CHARS', 12_000);
+/** Max characters for a single tool result before truncation in the agentic loop. */
+exports.TOOL_RESULT_MAX_CHARS = envInt('LT_TOOL_RESULT_MAX_CHARS', 50_000);
 // ── Tool execution ───────────────────────────────────────────────────
 /** Max agentic loop iterations for MCP triage workflows. */
 exports.TOOL_ROUNDS_TRIAGE = envInt('LT_TOOL_ROUNDS_TRIAGE', 10);

package/build/routes/controlplane.js

@@ -36,7 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const express_1 = require("express");
 const auth_1 = require("../modules/auth");
 const controlplane = __importStar(require("../services/controlplane"));
-const events_1 = require("../services/events");
+const events_1 = require("../lib/events");
 const router = (0, express_1.Router)();
 /**
  * GET /api/controlplane/apps

package/build/routes/dba.js

@@ -58,6 +58,10 @@ router.post('/prune', auth_1.requireAdmin, async (req, res) => {
             expire: req.body.expire,
             jobs: req.body.jobs,
             streams: req.body.streams,
+            engineStreams: req.body.engineStreams,
+            engineStreamsExpire: req.body.engineStreamsExpire,
+            workerStreams: req.body.workerStreams,
+            workerStreamsExpire: req.body.workerStreamsExpire,
             attributes: req.body.attributes,
             entities: req.body.entities,
             pruneTransient: req.body.pruneTransient,

package/build/routes/docs.d.ts

@@ -0,0 +1,2 @@
+declare const router: import("express-serve-static-core").Router;
+export default router;

package/build/routes/docs.js

@@ -0,0 +1,87 @@
+"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 });
+const express_1 = require("express");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const router = (0, express_1.Router)();
+function docsDir() {
+    const candidates = [
+        path.join(__dirname, '..', 'docs'),
+        path.join(__dirname, '..', '..', 'docs'),
+    ];
+    for (const dir of candidates) {
+        if (fs.existsSync(dir))
+            return dir;
+    }
+    return candidates[0];
+}
+function listDocs(dir, prefix = '') {
+    if (!fs.existsSync(dir))
+        return [];
+    const results = [];
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
+        if (entry.isDirectory()) {
+            results.push(...listDocs(path.join(dir, entry.name), rel));
+        }
+        else if (entry.name.endsWith('.md')) {
+            const content = fs.readFileSync(path.join(dir, entry.name), 'utf-8');
+            const firstLine = content.split('\n').find(l => l.startsWith('# '));
+            const title = firstLine ? firstLine.replace(/^#\s+/, '') : entry.name;
+            results.push({ path: rel, title });
+        }
+    }
+    return results;
+}
+router.get('/', (_req, res) => {
+    res.json({ docs: listDocs(docsDir()) });
+});
+// Use query param for doc path to avoid Express wildcard issues
+router.get('/read', (req, res) => {
+    const docPath = req.query.path;
+    if (!docPath || docPath.includes('..')) {
+        res.status(400).json({ error: 'Invalid path' });
+        return;
+    }
+    const filePath = path.join(docsDir(), docPath);
+    if (!fs.existsSync(filePath)) {
+        res.status(404).json({ error: 'Document not found' });
+        return;
+    }
+    const content = fs.readFileSync(filePath, 'utf-8');
+    res.json({ path: docPath, content });
+});
+exports.default = router;

package/build/routes/escalations/bulk.js

@@ -39,12 +39,41 @@ const taskService = __importStar(require("../../services/task"));
 const userService = __importStar(require("../../services/user"));
 const workers_1 = require("../../workers");
 const defaults_1 = require("../../modules/defaults");
-const publish_1 = require("../../services/events/publish");
+const publish_1 = require("../../lib/events/publish");
+// ── Shared helpers ──────────────────────────────────────────────────────────
+function validateIds(ids) {
+    return Array.isArray(ids) && ids.length > 0;
+}
+async function requireBulkPermission(userId, ids, res) {
+    const isSuperAdminUser = await userService.isSuperAdmin(userId);
+    if (isSuperAdminUser)
+        return true;
+    const roles = await escalationService.getEscalationRoles(ids);
+    for (const role of roles) {
+        const canManage = await userService.isGroupAdmin(userId, role);
+        if (!canManage) {
+            res.status(403).json({ error: `Insufficient permissions for role "${role}"` });
+            return false;
+        }
+    }
+    return true;
+}
+function publishBulkClaimEvents(ids, assignedTo) {
+    for (const id of ids) {
+        (0, publish_1.publishEscalationEvent)({
+            type: 'escalation.claimed',
+            source: 'api',
+            workflowId: '',
+            workflowName: '',
+            taskQueue: '',
+            escalationId: id,
+            status: 'claimed',
+            data: { assigned_to: assignedTo, bulk: true },
+        });
+    }
+}
+// ── Routes ──────────────────────────────────────────────────────────────────
 function registerBulkRoutes(router) {
-    /**
-     * POST /api/escalations/release-expired
-     * Optional cleanup of stale assignment data.
-     */
     router.post('/release-expired', async (_req, res) => {
         try {
             const released = await escalationService.releaseExpiredClaims();
@@ -54,38 +83,15 @@ function registerBulkRoutes(router) {
             res.status(500).json({ error: err.message });
         }
     });
-    /**
-     * PATCH /api/escalations/priority
-     * Bulk update priority for selected escalations.
-     * Body: { ids: string[], priority: 1|2|3|4 }
-     * Requires admin/superadmin permission for the escalation roles.
-     */
     router.patch('/priority', async (req, res) => {
         try {
-            const userId = req.auth.userId;
             const { ids, priority } = req.body || {};
-            if (!Array.isArray(ids) || ids.length === 0) {
-                res.status(400).json({ error: 'ids must be a non-empty array' });
-                return;
-            }
-            if (![1, 2, 3, 4].includes(priority)) {
-                res.status(400).json({ error: 'priority must be 1, 2, 3, or 4' });
+            if (!validateIds(ids))
+                return res.status(400).json({ error: 'ids must be a non-empty array' });
+            if (![1, 2, 3, 4].includes(priority))
+                return res.status(400).json({ error: 'priority must be 1, 2, 3, or 4' });
+            if (!await requireBulkPermission(req.auth.userId, ids, res))
                 return;
-            }
-            // Permission check: superadmin can update any; admin only for their roles
-            const isSuperAdminUser = await userService.isSuperAdmin(userId);
-            if (!isSuperAdminUser) {
-                const roles = await escalationService.getEscalationRoles(ids);
-                for (const role of roles) {
-                    const canManage = await userService.isGroupAdmin(userId, role);
-                    if (!canManage) {
-                        res.status(403).json({
-                            error: `Insufficient permissions for role "${role}"`,
-                        });
-                        return;
-                    }
-                }
-            }
             const updated = await escalationService.updateEscalationsPriority(ids, priority);
             res.json({ updated });
         }
@@ -93,138 +99,62 @@ function registerBulkRoutes(router) {
             res.status(500).json({ error: err.message });
         }
     });
-    /**
-     * POST /api/escalations/bulk-claim
-     * Bulk claim selected escalations for the authenticated user.
-     * Body: { ids: string[], durationMinutes?: number }
-     */
     router.post('/bulk-claim', async (req, res) => {
         try {
             const userId = req.auth.userId;
             const { ids, durationMinutes } = req.body || {};
-            if (!Array.isArray(ids) || ids.length === 0) {
-                res.status(400).json({ error: 'ids must be a non-empty array' });
+            if (!validateIds(ids))
+                return res.status(400).json({ error: 'ids must be a non-empty array' });
+            if (!await requireBulkPermission(userId, ids, res))
                 return;
-            }
-            const isSuperAdminUser = await userService.isSuperAdmin(userId);
-            if (!isSuperAdminUser) {
-                const roles = await escalationService.getEscalationRoles(ids);
-                for (const role of roles) {
-                    const canManage = await userService.isGroupAdmin(userId, role);
-                    if (!canManage) {
-                        res.status(403).json({ error: `Insufficient permissions for role "${role}"` });
-                        return;
-                    }
-                }
-            }
             const result = await escalationService.bulkClaimEscalations(ids, userId, durationMinutes ?? 30);
             res.json(result);
-            if (result.claimed > 0) {
-                for (const id of ids) {
-                    (0, publish_1.publishEscalationEvent)({
-                        type: 'escalation.claimed',
-                        source: 'api',
-                        workflowId: '',
-                        workflowName: '',
-                        taskQueue: '',
-                        escalationId: id,
-                        status: 'claimed',
-                        data: { assigned_to: userId, bulk: true },
-                    });
-                }
-            }
+            if (result.claimed > 0)
+                publishBulkClaimEvents(ids, userId);
         }
         catch (err) {
             res.status(500).json({ error: err.message });
         }
     });
-    /**
-     * POST /api/escalations/bulk-assign
-     * Bulk assign selected escalations to a specific user.
-     * Body: { ids: string[], targetUserId: string, durationMinutes?: number }
-     * Superadmin: can assign anyone. Admin: target must hold escalation role.
-     */
     router.post('/bulk-assign', async (req, res) => {
         try {
             const userId = req.auth.userId;
             const { ids, targetUserId, durationMinutes } = req.body || {};
-            if (!Array.isArray(ids) || ids.length === 0) {
-                res.status(400).json({ error: 'ids must be a non-empty array' });
+            if (!validateIds(ids))
+                return res.status(400).json({ error: 'ids must be a non-empty array' });
+            if (!targetUserId || typeof targetUserId !== 'string')
+                return res.status(400).json({ error: 'targetUserId is required' });
+            if (!await requireBulkPermission(userId, ids, res))
                 return;
-            }
-            if (!targetUserId || typeof targetUserId !== 'string') {
-                res.status(400).json({ error: 'targetUserId is required' });
-                return;
-            }
+            // Non-superadmin: target user must hold each escalation's role
             const isSuperAdminUser = await userService.isSuperAdmin(userId);
-            const roles = await escalationService.getEscalationRoles(ids);
             if (!isSuperAdminUser) {
-                // Caller must be group admin for each escalation's role
-                for (const role of roles) {
-                    const canManage = await userService.isGroupAdmin(userId, role);
-                    if (!canManage) {
-                        res.status(403).json({ error: `Insufficient permissions for role "${role}"` });
-                        return;
-                    }
-                }
-                // Target user must hold each escalation's role
+                const roles = await escalationService.getEscalationRoles(ids);
                 for (const role of roles) {
                     const targetHasRole = await userService.hasRole(targetUserId, role);
                     if (!targetHasRole) {
-                        res.status(400).json({ error: `Target user does not hold the "${role}" role` });
-                        return;
+                        return res.status(400).json({ error: `Target user does not hold the "${role}" role` });
                     }
                 }
             }
             const result = await escalationService.bulkAssignEscalations(ids, targetUserId, durationMinutes ?? 30);
             res.json(result);
-            if (result.assigned > 0) {
-                for (const id of ids) {
-                    (0, publish_1.publishEscalationEvent)({
-                        type: 'escalation.claimed',
-                        source: 'api',
-                        workflowId: '',
-                        workflowName: '',
-                        taskQueue: '',
-                        escalationId: id,
-                        status: 'claimed',
-                        data: { assigned_to: targetUserId, bulk: true },
-                    });
-                }
-            }
+            if (result.assigned > 0)
+                publishBulkClaimEvents(ids, targetUserId);
         }
         catch (err) {
             res.status(500).json({ error: err.message });
         }
     });
-    /**
-     * PATCH /api/escalations/bulk-escalate
-     * Bulk reassign selected escalations to a different role.
-     * Body: { ids: string[], targetRole: string }
-     */
     router.patch('/bulk-escalate', async (req, res) => {
         try {
-            const userId = req.auth.userId;
             const { ids, targetRole } = req.body || {};
-            if (!Array.isArray(ids) || ids.length === 0) {
-                res.status(400).json({ error: 'ids must be a non-empty array' });
+            if (!validateIds(ids))
+                return res.status(400).json({ error: 'ids must be a non-empty array' });
+            if (!targetRole || typeof targetRole !== 'string')
+                return res.status(400).json({ error: 'targetRole is required' });
+            if (!await requireBulkPermission(req.auth.userId, ids, res))
                 return;
-            }
-            if (!targetRole || typeof targetRole !== 'string') {
-                res.status(400).json({ error: 'targetRole is required' });
-                return;
-            }
-            const isSuperAdminUser = await userService.isSuperAdmin(userId);
-            if (!isSuperAdminUser) {
-                const roles = await escalationService.getEscalationRoles(ids);
-                for (const role of roles) {
-                    const canManage = await userService.isGroupAdmin(userId, role);
-                    if (!canManage) {
-                        res.status(403).json({ error: `Insufficient permissions for role "${role}"` });
-                        return;
-                    }
-                }
-            }
             const updated = await escalationService.bulkEscalateToRole(ids, targetRole);
             res.json({ updated });
         }
@@ -232,87 +162,18 @@ function registerBulkRoutes(router) {
             res.status(500).json({ error: err.message });
         }
     });
-    /**
-     * POST /api/escalations/bulk-triage
-     * Bulk resolve selected escalations and start AI triage workflows.
-     * Body: { ids: string[], hint?: string }
-     */
     router.post('/bulk-triage', async (req, res) => {
         try {
-            const userId = req.auth.userId;
             const { ids, hint } = req.body || {};
-            if (!Array.isArray(ids) || ids.length === 0) {
-                res.status(400).json({ error: 'ids must be a non-empty array' });
+            if (!validateIds(ids))
+                return res.status(400).json({ error: 'ids must be a non-empty array' });
+            if (!await requireBulkPermission(req.auth.userId, ids, res))
                 return;
-            }
-            const isSuperAdminUser = await userService.isSuperAdmin(userId);
-            if (!isSuperAdminUser) {
-                const roles = await escalationService.getEscalationRoles(ids);
-                for (const role of roles) {
-                    const canManage = await userService.isGroupAdmin(userId, role);
-                    if (!canManage) {
-                        res.status(403).json({ error: `Insufficient permissions for role "${role}"` });
-                        return;
-                    }
-                }
-            }
             const resolved = await escalationService.bulkResolveForTriage(ids, hint);
             const client = (0, workers_1.createClient)();
             const workflowIds = [];
             for (const escalation of resolved) {
-                let escalationPayload = {};
-                if (escalation.escalation_payload) {
-                    try {
-                        escalationPayload = JSON.parse(escalation.escalation_payload);
-                    }
-                    catch { }
-                }
-                let envelope = {};
-                if (escalation.envelope) {
-                    try {
-                        envelope = JSON.parse(escalation.envelope);
-                    }
-                    catch { }
-                }
-                const triageWorkflowId = `triage-${escalation.id}-${Date.now()}`;
-                const triageEnvelope = {
-                    data: {
-                        escalationId: escalation.id,
-                        originId: escalation.origin_id ?? undefined,
-                        originalWorkflowType: escalation.workflow_type,
-                        originalTaskQueue: escalation.task_queue,
-                        originalTaskId: escalation.task_id,
-                        escalationPayload,
-                        resolverPayload: {
-                            _lt: { needsTriage: true, ...(hint ? { hint } : {}) },
-                        },
-                    },
-                    metadata: envelope.metadata || {},
-                    lt: { ...(envelope.lt || {}), userId: req.auth?.userId },
-                };
-                const routing = escalation.task_id
-                    ? (await taskService.getTask(escalation.task_id))?.metadata
-                    : null;
-                await taskService.createTask({
-                    workflow_id: triageWorkflowId,
-                    workflow_type: 'mcpTriage',
-                    lt_type: 'mcpTriage',
-                    task_queue: 'long-tail-system',
-                    signal_id: `lt-triage-${triageWorkflowId}`,
-                    parent_workflow_id: routing?.parentWorkflowId || triageWorkflowId,
-                    origin_id: escalation.origin_id || triageWorkflowId,
-                    parent_id: escalation.parent_id ?? undefined,
-                    envelope: JSON.stringify(triageEnvelope),
-                    metadata: routing || undefined,
-                });
-                await client.workflow.start({
-                    workflowName: 'mcpTriage',
-                    args: [triageEnvelope],
-                    taskQueue: 'long-tail-system',
-                    workflowId: triageWorkflowId,
-                    expire: defaults_1.JOB_EXPIRE_SECS,
-                    entity: 'mcpTriage',
-                });
+                const triageWorkflowId = await startTriageWorkflow(escalation, hint, req.auth?.userId, client);
                 workflowIds.push(triageWorkflowId);
             }
             res.json({ triaged: resolved.length, workflows: workflowIds });
@@ -322,3 +183,60 @@ function registerBulkRoutes(router) {
         }
     });
 }
+// ── Triage workflow launcher ────────────────────────────────────────────────
+async function startTriageWorkflow(escalation, hint, userId, client) {
+    let escalationPayload = {};
+    if (escalation.escalation_payload) {
+        try {
+            escalationPayload = JSON.parse(escalation.escalation_payload);
+        }
+        catch { }
+    }
+    let envelope = {};
+    if (escalation.envelope) {
+        try {
+            envelope = JSON.parse(escalation.envelope);
+        }
+        catch { }
+    }
+    const triageWorkflowId = `triage-${escalation.id}-${Date.now()}`;
+    const triageEnvelope = {
+        data: {
+            escalationId: escalation.id,
+            originId: escalation.origin_id ?? undefined,
+            originalWorkflowType: escalation.workflow_type,
+            originalTaskQueue: escalation.task_queue,
+            originalTaskId: escalation.task_id,
+            escalationPayload,
+            resolverPayload: {
+                _lt: { needsTriage: true, ...(hint ? { hint } : {}) },
+            },
+        },
+        metadata: envelope.metadata || {},
+        lt: { ...(envelope.lt || {}), userId },
+    };
+    const routing = escalation.task_id
+        ? (await taskService.getTask(escalation.task_id))?.metadata
+        : null;
+    await taskService.createTask({
+        workflow_id: triageWorkflowId,
+        workflow_type: 'mcpTriage',
+        lt_type: 'mcpTriage',
+        task_queue: 'long-tail-system',
+        signal_id: `lt-triage-${triageWorkflowId}`,
+        parent_workflow_id: routing?.parentWorkflowId || triageWorkflowId,
+        origin_id: escalation.origin_id || triageWorkflowId,
+        parent_id: escalation.parent_id ?? undefined,
+        envelope: JSON.stringify(triageEnvelope),
+        metadata: routing || undefined,
+    });
+    await client.workflow.start({
+        workflowName: 'mcpTriage',
+        args: [triageEnvelope],
+        taskQueue: 'long-tail-system',
+        workflowId: triageWorkflowId,
+        expire: defaults_1.JOB_EXPIRE_SECS,
+        entity: 'mcpTriage',
+    });
+    return triageWorkflowId;
+}

package/build/routes/escalations/resolve.js

@@ -37,7 +37,7 @@ exports.registerResolveRoutes = registerResolveRoutes;
 const escalationService = __importStar(require("../../services/escalation"));
 const taskService = __importStar(require("../../services/task"));
 const escalation_strategy_1 = require("../../services/escalation-strategy");
-const publish_1 = require("../../services/events/publish");
+const publish_1 = require("../../lib/events/publish");
 const ephemeral_1 = require("../../services/iam/ephemeral");
 const deployer_1 = require("../../services/yaml-workflow/deployer");
 const workers_1 = require("../../workers");

package/build/routes/escalations/single.js

@@ -37,7 +37,7 @@ exports.registerSingleRoutes = registerSingleRoutes;
 const escalationService = __importStar(require("../../services/escalation"));
 const userService = __importStar(require("../../services/user"));
 const roleService = __importStar(require("../../services/role"));
-const publish_1 = require("../../services/events/publish");
+const publish_1 = require("../../lib/events/publish");
 function registerSingleRoutes(router) {
     /**
      * PATCH /api/escalations/:id/escalate

package/build/routes/files.js

@@ -5,7 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const express_1 = require("express");
 const path_1 = __importDefault(require("path"));
-const storage_1 = require("../services/storage");
+const storage_1 = require("../lib/storage");
 const router = (0, express_1.Router)();
 const MIME_TYPES = {
     '.png': 'image/png',

package/build/routes/index.js

@@ -25,6 +25,7 @@ const namespaces_1 = __importDefault(require("./namespaces"));
 const files_1 = __importDefault(require("./files"));
 const controlplane_1 = __importDefault(require("./controlplane"));
 const bot_accounts_1 = __importDefault(require("./bot-accounts"));
+const docs_1 = __importDefault(require("./docs"));
 const router = (0, express_1.Router)();
 // Public routes (no auth required — they handle their own auth)
 router.use('/auth', auth_2.default);
@@ -49,4 +50,5 @@ router.use('/mcp-runs', mcp_runs_1.default);
 router.use('/namespaces', namespaces_1.default);
 router.use('/controlplane', controlplane_1.default);
 router.use('/bot-accounts', bot_accounts_1.default);
+router.use('/docs', docs_1.default);
 exports.default = router;