@hotmeshio/long-tail 0.1.5 → 0.1.7

package/build/routes/controlplane.js

@@ -35,8 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 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("../lib/events");
+const api = __importStar(require("../api/controlplane"));
 const router = (0, express_1.Router)();
 /**
  * GET /api/controlplane/apps
@@ -44,13 +43,8 @@ const router = (0, express_1.Router)();
  * Admin-only.
  */
 router.get('/apps', auth_1.requireAdmin, async (_req, res) => {
-    try {
-        const apps = await controlplane.listApps();
-        res.json({ apps });
-    }
-    catch (err) {
-        res.status(500).json({ error: err.message });
-    }
+    const result = await api.listApps();
+    res.status(result.status).json(result.data ?? { error: result.error });
 });
 /**
  * GET /api/controlplane/rollcall?app_id=durable&delay=1000
@@ -58,15 +52,11 @@ router.get('/apps', auth_1.requireAdmin, async (_req, res) => {
  * Admin-only.
  */
 router.get('/rollcall', auth_1.requireAdmin, async (req, res) => {
-    try {
-        const appId = req.query.app_id || 'durable';
-        const delay = req.query.delay ? parseInt(req.query.delay, 10) : undefined;
-        const profiles = await controlplane.rollCall(appId, delay);
-        res.json({ profiles });
-    }
-    catch (err) {
-        res.status(500).json({ error: err.message });
-    }
+    const result = await api.rollCall({
+        appId: req.query.app_id || 'durable',
+        delay: req.query.delay ? parseInt(req.query.delay, 10) : undefined,
+    });
+    res.status(result.status).json(result.data ?? { error: result.error });
 });
 /**
  * POST /api/controlplane/throttle
@@ -77,30 +67,9 @@ router.get('/rollcall', auth_1.requireAdmin, async (req, res) => {
  *   throttle: ms delay (-1 = pause, 0 = resume, >0 = delay per msg)
  */
 router.post('/throttle', auth_1.requireAdmin, async (req, res) => {
-    try {
-        const { appId = 'durable', throttle, topic, guid } = req.body;
-        if (typeof throttle !== 'number') {
-            res.status(400).json({ error: 'throttle (number) is required' });
-            return;
-        }
-        const result = await controlplane.applyThrottle(appId, { throttle, topic, guid });
-        // Publish a synthetic event so the dashboard event stream sees it
-        // (throttle commands don't echo back through the quorum subscription)
-        const throttleEvent = {
-            type: 'mesh.throttle',
-            source: 'controlplane',
-            workflowId: guid || '',
-            workflowName: '',
-            taskQueue: appId,
-            data: { throttle, topic, guid, appId },
-            timestamp: new Date().toISOString(),
-        };
-        events_1.eventRegistry.publish(throttleEvent).catch(() => { });
-        res.json({ success: result });
-    }
-    catch (err) {
-        res.status(500).json({ error: err.message });
-    }
+    const { appId = 'durable', throttle, topic, guid } = req.body;
+    const result = await api.applyThrottle({ appId, throttle, topic, guid });
+    res.status(result.status).json(result.data ?? { error: result.error });
 });
 /**
  * GET /api/controlplane/streams?app_id=durable&duration=1h&stream=hmsh:durable:x:
@@ -111,16 +80,12 @@ router.post('/throttle', auth_1.requireAdmin, async (req, res) => {
  * stream: optional stream_name filter (specific task queue topic)
  */
 router.get('/streams', auth_1.requireAdmin, async (req, res) => {
-    try {
-        const schema = req.query.app_id || 'durable';
-        const duration = req.query.duration || '1h';
-        const stream = req.query.stream || undefined;
-        const stats = await controlplane.getStreamStats(schema, duration, stream);
-        res.json(stats);
-    }
-    catch (err) {
-        res.status(500).json({ error: err.message });
-    }
+    const result = await api.getStreamStats({
+        app_id: req.query.app_id || 'durable',
+        duration: req.query.duration || '1h',
+        stream: req.query.stream || undefined,
+    });
+    res.status(result.status).json(result.data ?? { error: result.error });
 });
 /**
  * POST /api/controlplane/subscribe
@@ -132,13 +97,8 @@ router.get('/streams', auth_1.requireAdmin, async (req, res) => {
  * Body: { appId: string }
  */
 router.post('/subscribe', auth_1.requireAdmin, async (req, res) => {
-    try {
-        const { appId = 'durable' } = req.body;
-        await controlplane.subscribeMesh(appId);
-        res.json({ subscribed: true, appId });
-    }
-    catch (err) {
-        res.status(500).json({ error: err.message });
-    }
+    const { appId = 'durable' } = req.body;
+    const result = await api.subscribeMesh({ appId });
+    res.status(result.status).json(result.data ?? { error: result.error });
 });
 exports.default = router;

package/build/routes/dba.js

@@ -34,8 +34,8 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 const express_1 = require("express");
+const api = __importStar(require("../api/dba"));
 const auth_1 = require("../modules/auth");
-const dbaService = __importStar(require("../services/dba"));
 const router = (0, express_1.Router)();
 /**
  * POST /api/dba/prune
@@ -53,38 +53,28 @@ const router = (0, express_1.Router)();
  * Returns: { jobs, streams, attributes, transient, marked }
  */
 router.post('/prune', auth_1.requireAdmin, async (req, res) => {
-    try {
-        const result = await dbaService.prune({
-            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,
-            keepHmark: req.body.keepHmark,
-        });
-        res.json(result);
-    }
-    catch (err) {
-        res.status(500).json({ error: err.message });
-    }
+    const result = await api.prune({
+        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,
+        keepHmark: req.body.keepHmark,
+    });
+    res.status(result.status).json(result.data ?? { error: result.error });
 });
 /**
  * POST /api/dba/deploy
  * Deploy the server-side prune function and run migrations.
  * Idempotent — safe to call on startup or from CI/CD.
  */
-router.post('/deploy', auth_1.requireAdmin, async (req, res) => {
-    try {
-        await dbaService.deploy();
-        res.json({ ok: true });
-    }
-    catch (err) {
-        res.status(500).json({ error: err.message });
-    }
+router.post('/deploy', auth_1.requireAdmin, async (_req, res) => {
+    const result = await api.deploy();
+    res.status(result.status).json(result.data ?? { error: result.error });
 });
 exports.default = router;

package/build/routes/docs.js

@@ -37,13 +37,13 @@ const express_1 = require("express");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const router = (0, express_1.Router)();
-function docsDir() {
+function projectRoot() {
     const candidates = [
-        path.join(__dirname, '..', 'docs'),
-        path.join(__dirname, '..', '..', 'docs'),
+        path.join(__dirname, '..'),
+        path.join(__dirname, '..', '..'),
     ];
     for (const dir of candidates) {
-        if (fs.existsSync(dir))
+        if (fs.existsSync(path.join(dir, 'docs')))
             return dir;
     }
     return candidates[0];
@@ -66,8 +66,26 @@ function listDocs(dir, prefix = '') {
     }
     return results;
 }
+function resolveDocPath(docPath) {
+    const root = projectRoot();
+    // README.md lives at project root, everything else under docs/
+    if (docPath === 'README.md') {
+        const fp = path.join(root, 'README.md');
+        return fs.existsSync(fp) ? fp : null;
+    }
+    const fp = path.join(root, 'docs', docPath);
+    return fs.existsSync(fp) ? fp : null;
+}
 router.get('/', (_req, res) => {
-    res.json({ docs: listDocs(docsDir()) });
+    const root = projectRoot();
+    const docs = [];
+    // README first
+    const readmePath = path.join(root, 'README.md');
+    if (fs.existsSync(readmePath)) {
+        docs.push({ path: 'README.md', title: 'Long Tail' });
+    }
+    docs.push(...listDocs(path.join(root, 'docs')));
+    res.json({ docs });
 });
 // Use query param for doc path to avoid Express wildcard issues
 router.get('/read', (req, res) => {
@@ -76,8 +94,8 @@ router.get('/read', (req, res) => {
         res.status(400).json({ error: 'Invalid path' });
         return;
     }
-    const filePath = path.join(docsDir(), docPath);
-    if (!fs.existsSync(filePath)) {
+    const filePath = resolveDocPath(docPath);
+    if (!filePath) {
         res.status(404).json({ error: 'Document not found' });
         return;
     }

package/build/routes/escalations/bulk.js

@@ -34,209 +34,34 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerBulkRoutes = registerBulkRoutes;
-const escalationService = __importStar(require("../../services/escalation"));
-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("../../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 ──────────────────────────────────────────────────────────────────
+const api = __importStar(require("../../api/escalations"));
 function registerBulkRoutes(router) {
     router.post('/release-expired', async (_req, res) => {
-        try {
-            const released = await escalationService.releaseExpiredClaims();
-            res.json({ released });
-        }
-        catch (err) {
-            res.status(500).json({ error: err.message });
-        }
+        const result = await api.releaseExpiredClaims();
+        res.status(result.status).json(result.data ?? { error: result.error });
     });
     router.patch('/priority', async (req, res) => {
-        try {
-            const { ids, priority } = req.body || {};
-            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;
-            const updated = await escalationService.updateEscalationsPriority(ids, priority);
-            res.json({ updated });
-        }
-        catch (err) {
-            res.status(500).json({ error: err.message });
-        }
+        const result = await api.updatePriority({ ids: req.body?.ids, priority: req.body?.priority }, req.auth);
+        res.status(result.status).json(result.data ?? { error: result.error });
     });
     router.post('/bulk-claim', async (req, res) => {
-        try {
-            const userId = req.auth.userId;
-            const { ids, durationMinutes } = req.body || {};
-            if (!validateIds(ids))
-                return res.status(400).json({ error: 'ids must be a non-empty array' });
-            if (!await requireBulkPermission(userId, ids, res))
-                return;
-            const result = await escalationService.bulkClaimEscalations(ids, userId, durationMinutes ?? 30);
-            res.json(result);
-            if (result.claimed > 0)
-                publishBulkClaimEvents(ids, userId);
-        }
-        catch (err) {
-            res.status(500).json({ error: err.message });
-        }
+        const result = await api.bulkClaim({ ids: req.body?.ids, durationMinutes: req.body?.durationMinutes }, req.auth);
+        res.status(result.status).json(result.data ?? { error: result.error });
     });
     router.post('/bulk-assign', async (req, res) => {
-        try {
-            const userId = req.auth.userId;
-            const { ids, targetUserId, durationMinutes } = req.body || {};
-            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;
-            // Non-superadmin: target user must hold each escalation's role
-            const isSuperAdminUser = await userService.isSuperAdmin(userId);
-            if (!isSuperAdminUser) {
-                const roles = await escalationService.getEscalationRoles(ids);
-                for (const role of roles) {
-                    const targetHasRole = await userService.hasRole(targetUserId, role);
-                    if (!targetHasRole) {
-                        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)
-                publishBulkClaimEvents(ids, targetUserId);
-        }
-        catch (err) {
-            res.status(500).json({ error: err.message });
-        }
+        const result = await api.bulkAssign({
+            ids: req.body?.ids,
+            targetUserId: req.body?.targetUserId,
+            durationMinutes: req.body?.durationMinutes,
+        }, req.auth);
+        res.status(result.status).json(result.data ?? { error: result.error });
     });
     router.patch('/bulk-escalate', async (req, res) => {
-        try {
-            const { ids, targetRole } = req.body || {};
-            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;
-            const updated = await escalationService.bulkEscalateToRole(ids, targetRole);
-            res.json({ updated });
-        }
-        catch (err) {
-            res.status(500).json({ error: err.message });
-        }
+        const result = await api.bulkEscalate({ ids: req.body?.ids, targetRole: req.body?.targetRole }, req.auth);
+        res.status(result.status).json(result.data ?? { error: result.error });
     });
     router.post('/bulk-triage', async (req, res) => {
-        try {
-            const { ids, hint } = req.body || {};
-            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 resolved = await escalationService.bulkResolveForTriage(ids, hint);
-            const client = (0, workers_1.createClient)();
-            const workflowIds = [];
-            for (const escalation of resolved) {
-                const triageWorkflowId = await startTriageWorkflow(escalation, hint, req.auth?.userId, client);
-                workflowIds.push(triageWorkflowId);
-            }
-            res.json({ triaged: resolved.length, workflows: workflowIds });
-        }
-        catch (err) {
-            res.status(500).json({ error: err.message });
-        }
-    });
-}
-// ── 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',
+        const result = await api.bulkTriage({ ids: req.body?.ids, hint: req.body?.hint }, req.auth);
+        res.status(result.status).json(result.data ?? { error: result.error });
     });
-    return triageWorkflowId;
 }

package/build/routes/escalations/list.js

@@ -34,8 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerListRoutes = registerListRoutes;
-const escalationService = __importStar(require("../../services/escalation"));
-const helpers_1 = require("./helpers");
+const api = __importStar(require("../../api/escalations"));
 function registerListRoutes(router) {
     /**
      * GET /api/escalations
@@ -43,31 +42,19 @@ function registerListRoutes(router) {
      * RBAC: superadmin sees all; others see only roles they belong to.
      */
     router.get('/', async (req, res) => {
-        try {
-            const userId = req.auth.userId;
-            const visibleRoles = await (0, helpers_1.getVisibleRoles)(userId);
-            if (visibleRoles && visibleRoles.length === 0) {
-                res.json({ escalations: [], total: 0 });
-                return;
-            }
-            const result = await escalationService.listEscalations({
-                status: req.query.status,
-                role: req.query.role,
-                type: req.query.type,
-                subtype: req.query.subtype,
-                assigned_to: req.query.assigned_to,
-                priority: req.query.priority ? parseInt(req.query.priority, 10) : undefined,
-                limit: req.query.limit ? parseInt(req.query.limit, 10) : undefined,
-                offset: req.query.offset ? parseInt(req.query.offset, 10) : undefined,
-                sort_by: req.query.sort_by,
-                order: req.query.order,
-                visibleRoles,
-            });
-            res.json(result);
-        }
-        catch (err) {
-            res.status(500).json({ error: err.message });
-        }
+        const result = await api.listEscalations({
+            status: req.query.status,
+            role: req.query.role,
+            type: req.query.type,
+            subtype: req.query.subtype,
+            assigned_to: req.query.assigned_to,
+            priority: req.query.priority ? parseInt(req.query.priority, 10) : undefined,
+            limit: req.query.limit ? parseInt(req.query.limit, 10) : undefined,
+            offset: req.query.offset ? parseInt(req.query.offset, 10) : undefined,
+            sort_by: req.query.sort_by,
+            order: req.query.order,
+        }, req.auth);
+        res.status(result.status).json(result.data ?? { error: result.error });
     });
     /**
      * GET /api/escalations/available
@@ -75,42 +62,25 @@ function registerListRoutes(router) {
      * RBAC: superadmin sees all; others see only roles they belong to.
      */
     router.get('/available', async (req, res) => {
-        try {
-            const userId = req.auth.userId;
-            const visibleRoles = await (0, helpers_1.getVisibleRoles)(userId);
-            if (visibleRoles && visibleRoles.length === 0) {
-                res.json({ escalations: [], total: 0 });
-                return;
-            }
-            const result = await escalationService.listAvailableEscalations({
-                role: req.query.role,
-                type: req.query.type,
-                subtype: req.query.subtype,
-                priority: req.query.priority ? parseInt(req.query.priority, 10) : undefined,
-                limit: req.query.limit ? parseInt(req.query.limit, 10) : undefined,
-                offset: req.query.offset ? parseInt(req.query.offset, 10) : undefined,
-                sort_by: req.query.sort_by,
-                order: req.query.order,
-                visibleRoles,
-            });
-            res.json(result);
-        }
-        catch (err) {
-            res.status(500).json({ error: err.message });
-        }
+        const result = await api.listAvailableEscalations({
+            role: req.query.role,
+            type: req.query.type,
+            subtype: req.query.subtype,
+            priority: req.query.priority ? parseInt(req.query.priority, 10) : undefined,
+            limit: req.query.limit ? parseInt(req.query.limit, 10) : undefined,
+            offset: req.query.offset ? parseInt(req.query.offset, 10) : undefined,
+            sort_by: req.query.sort_by,
+            order: req.query.order,
+        }, req.auth);
+        res.status(result.status).json(result.data ?? { error: result.error });
     });
     /**
      * GET /api/escalations/types
      * Returns distinct escalation type values.
      */
     router.get('/types', async (_req, res) => {
-        try {
-            const types = await escalationService.listDistinctTypes();
-            res.json({ types });
-        }
-        catch (err) {
-            res.status(500).json({ error: err.message });
-        }
+        const result = await api.listDistinctTypes();
+        res.status(result.status).json(result.data ?? { error: result.error });
     });
     /**
      * GET /api/escalations/stats
@@ -118,23 +88,7 @@ function registerListRoutes(router) {
      * RBAC: superadmin sees all; others scoped to their roles.
      */
     router.get('/stats', async (req, res) => {
-        try {
-            const userId = req.auth.userId;
-            const visibleRoles = await (0, helpers_1.getVisibleRoles)(userId);
-            if (visibleRoles && visibleRoles.length === 0) {
-                res.json({
-                    pending: 0, claimed: 0,
-                    created: 0, resolved: 0,
-                    by_role: [], by_type: [],
-                });
-                return;
-            }
-            const period = req.query.period || undefined;
-            const stats = await escalationService.getEscalationStats(visibleRoles, period);
-            res.json(stats);
-        }
-        catch (err) {
-            res.status(500).json({ error: err.message });
-        }
+        const result = await api.getEscalationStats({ period: req.query.period || undefined }, req.auth);
+        res.status(result.status).json(result.data ?? { error: result.error });
     });
 }