@hotmeshio/long-tail 0.5.10 → 0.5.12

package/build/system/mcp-servers/admin/schemas.d.ts

@@ -40,26 +40,55 @@ export declare const getProcessDetailSchema: z.ZodObject<{
     origin_id: string;
 }>;
 export declare const findEscalationsSchema: z.ZodObject<{
-    status: z.ZodOptional<z.ZodEnum<["pending", "resolved"]>>;
+    status: z.ZodOptional<z.ZodEnum<["pending", "resolved", "cancelled"]>>;
     role: z.ZodOptional<z.ZodString>;
     type: z.ZodOptional<z.ZodString>;
+    subtype: z.ZodOptional<z.ZodString>;
+    assigned_to: z.ZodOptional<z.ZodString>;
+    search: z.ZodOptional<z.ZodString>;
     priority: z.ZodOptional<z.ZodNumber>;
+    sort_by: z.ZodOptional<z.ZodEnum<["created_at", "priority", "updated_at"]>>;
+    order: z.ZodOptional<z.ZodEnum<["asc", "desc"]>>;
     limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
 }, "strip", z.ZodTypeAny, {
     limit: number;
     offset: number;
     role?: string | undefined;
-    status?: "pending" | "resolved" | undefined;
+    status?: "pending" | "cancelled" | "resolved" | undefined;
     type?: string | undefined;
+    search?: string | undefined;
     priority?: number | undefined;
+    assigned_to?: string | undefined;
+    subtype?: string | undefined;
+    sort_by?: "created_at" | "updated_at" | "priority" | undefined;
+    order?: "asc" | "desc" | undefined;
 }, {
     role?: string | undefined;
-    status?: "pending" | "resolved" | undefined;
+    status?: "pending" | "cancelled" | "resolved" | undefined;
     type?: string | undefined;
+    search?: string | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
     priority?: number | undefined;
+    assigned_to?: string | undefined;
+    subtype?: string | undefined;
+    sort_by?: "created_at" | "updated_at" | "priority" | undefined;
+    order?: "asc" | "desc" | undefined;
+}>;
+export declare const getEscalationSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+export declare const getEscalationsByWorkflowSchema: z.ZodObject<{
+    workflow_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    workflow_id: string;
+}, {
+    workflow_id: string;
 }>;
 export declare const getEscalationStatsSchema: z.ZodObject<{
     period: z.ZodOptional<z.ZodString>;
@@ -78,6 +107,57 @@ export declare const claimEscalationSchema: z.ZodObject<{
     id: string;
     duration_minutes?: number | undefined;
 }>;
+export declare const releaseEscalationSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+export declare const resolveEscalationSchema: z.ZodObject<{
+    id: z.ZodString;
+    resolverPayload: z.ZodRecord<z.ZodString, z.ZodAny>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    resolverPayload: Record<string, any>;
+}, {
+    id: string;
+    resolverPayload: Record<string, any>;
+}>;
+export declare const resolveBySignalKeySchema: z.ZodObject<{
+    signalKey: z.ZodString;
+    resolverPayload: z.ZodRecord<z.ZodString, z.ZodAny>;
+}, "strip", z.ZodTypeAny, {
+    signalKey: string;
+    resolverPayload: Record<string, any>;
+}, {
+    signalKey: string;
+    resolverPayload: Record<string, any>;
+}>;
+export declare const escalateEscalationSchema: z.ZodObject<{
+    id: z.ZodString;
+    targetRole: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    targetRole: string;
+}, {
+    id: string;
+    targetRole: string;
+}>;
+export declare const cancelEscalationSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+export declare const bulkCancelSchema: z.ZodObject<{
+    ids: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    ids: string[];
+}, {
+    ids: string[];
+}>;
 export declare const releaseExpiredClaimsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
 export declare const bulkTriageSchema: z.ZodObject<{
     ids: z.ZodArray<z.ZodString, "many">;
@@ -165,10 +245,13 @@ export declare const invokeWorkflowSchema: z.ZodObject<{
 }>;
 export declare const getWorkflowStatusSchema: z.ZodObject<{
     workflow_id: z.ZodString;
+    app_id: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     workflow_id: string;
+    app_id?: string | undefined;
 }, {
     workflow_id: string;
+    app_id?: string | undefined;
 }>;
 export declare const listMcpServersSchema: z.ZodObject<{
     status: z.ZodOptional<z.ZodString>;
@@ -1026,36 +1109,48 @@ export declare const getExportStatusSchema: z.ZodObject<{
 export declare const diagnoseJobSchema: z.ZodObject<{
     workflow_id: z.ZodString;
     app_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    max_events: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    include: z.ZodOptional<z.ZodArray<z.ZodEnum<["events", "streams"]>, "many">>;
+    verbosity: z.ZodOptional<z.ZodEnum<["summary", "full"]>>;
 }, "strip", z.ZodTypeAny, {
     app_id: string;
     workflow_id: string;
+    max_events: number;
+    include?: ("streams" | "events")[] | undefined;
+    verbosity?: "summary" | "full" | undefined;
 }, {
     workflow_id: string;
     app_id?: string | undefined;
+    max_events?: number | undefined;
+    include?: ("streams" | "events")[] | undefined;
+    verbosity?: "summary" | "full" | undefined;
 }>;
 export declare const findStalledJobsSchema: z.ZodObject<{
     app_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    stalled_minutes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    idle_minutes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     workflow_type: z.ZodOptional<z.ZodString>;
     limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
 }, "strip", z.ZodTypeAny, {
     app_id: string;
     limit: number;
-    stalled_minutes: number;
+    idle_minutes: number;
     workflow_type?: string | undefined;
 }, {
     workflow_type?: string | undefined;
     app_id?: string | undefined;
     limit?: number | undefined;
-    stalled_minutes?: number | undefined;
+    idle_minutes?: number | undefined;
 }>;
 export declare const findOrphanedSignalsSchema: z.ZodObject<{
     app_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    within_hours: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
 }, "strip", z.ZodTypeAny, {
     app_id: string;
     limit: number;
+    within_hours: number;
 }, {
     app_id?: string | undefined;
     limit?: number | undefined;
+    within_hours?: number | undefined;
 }>;

package/build/system/mcp-servers/admin/schemas.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.listStreamMessagesSchema = exports.getStreamStatsSchema = exports.applyThrottleSchema = exports.rollCallSchema = exports.listAppsSchema = exports.revokeBotKeySchema = exports.createBotApiKeySchema = exports.deleteBotSchema = exports.updateBotSchema = exports.createBotSchema = exports.getBotSchema = exports.listBotsSchema = exports.deleteAgentSubscriptionSchema = exports.createAgentSubscriptionSchema = exports.listAgentSubscriptionsSchema = exports.deleteAgentSchema = exports.updateAgentSchema = exports.createAgentSchema = exports.getAgentSchema = exports.listAgentsSchema = exports.pruneSchema = exports.addEscalationChainSchema = exports.createRoleSchema = exports.listRolesSchema = exports.removeUserRoleSchema = exports.addUserRoleSchema = exports.createUserSchema = exports.listUsersSchema = exports.invokeYamlWorkflowSchema = exports.deployYamlWorkflowSchema = exports.createYamlWorkflowSchema = exports.getYamlWorkflowSchema = exports.listYamlWorkflowsSchema = exports.disconnectMcpServerSchema = exports.connectMcpServerSchema = exports.updateMcpServerSchema = exports.listMcpServersSchema = exports.getWorkflowStatusSchema = exports.invokeWorkflowSchema = exports.listDiscoveredWorkflowsSchema = exports.deleteWorkflowConfigSchema = exports.upsertWorkflowConfigSchema = exports.listWorkflowConfigsSchema = exports.bulkTriageSchema = exports.releaseExpiredClaimsSchema = exports.claimEscalationSchema = exports.getEscalationStatsSchema = exports.findEscalationsSchema = exports.getProcessDetailSchema = exports.findTasksSchema = void 0;
-exports.findOrphanedSignalsSchema = exports.findStalledJobsSchema = exports.diagnoseJobSchema = exports.getExportStatusSchema = exports.exportWorkflowExecutionSchema = exports.exportWorkflowStateSchema = exports.listExportJobsSchema = exports.getSettingsSchema = exports.updatePrioritySchema = exports.bulkEscalateSchema = exports.bulkAssignSchema = exports.bulkClaimSchema = exports.resolveByMetadataSchema = exports.claimByMetadataSchema = exports.findByMetadataSchema = exports.deleteTopicSchema = exports.updateTopicSchema = exports.createTopicSchema = exports.getTopicSchema = exports.listTopicsSchema = exports.interruptJobSchema = exports.getJobExecutionSchema = exports.listPipelineJobsSchema = exports.listPipelineEntitiesSchema = void 0;
+exports.updateBotSchema = exports.createBotSchema = exports.getBotSchema = exports.listBotsSchema = exports.deleteAgentSubscriptionSchema = exports.createAgentSubscriptionSchema = exports.listAgentSubscriptionsSchema = exports.deleteAgentSchema = exports.updateAgentSchema = exports.createAgentSchema = exports.getAgentSchema = exports.listAgentsSchema = exports.pruneSchema = exports.addEscalationChainSchema = exports.createRoleSchema = exports.listRolesSchema = exports.removeUserRoleSchema = exports.addUserRoleSchema = exports.createUserSchema = exports.listUsersSchema = exports.invokeYamlWorkflowSchema = exports.deployYamlWorkflowSchema = exports.createYamlWorkflowSchema = exports.getYamlWorkflowSchema = exports.listYamlWorkflowsSchema = exports.disconnectMcpServerSchema = exports.connectMcpServerSchema = exports.updateMcpServerSchema = exports.listMcpServersSchema = exports.getWorkflowStatusSchema = exports.invokeWorkflowSchema = exports.listDiscoveredWorkflowsSchema = exports.deleteWorkflowConfigSchema = exports.upsertWorkflowConfigSchema = exports.listWorkflowConfigsSchema = exports.bulkTriageSchema = exports.releaseExpiredClaimsSchema = exports.bulkCancelSchema = exports.cancelEscalationSchema = exports.escalateEscalationSchema = exports.resolveBySignalKeySchema = exports.resolveEscalationSchema = exports.releaseEscalationSchema = exports.claimEscalationSchema = exports.getEscalationStatsSchema = exports.getEscalationsByWorkflowSchema = exports.getEscalationSchema = exports.findEscalationsSchema = exports.getProcessDetailSchema = exports.findTasksSchema = void 0;
+exports.findOrphanedSignalsSchema = exports.findStalledJobsSchema = exports.diagnoseJobSchema = exports.getExportStatusSchema = exports.exportWorkflowExecutionSchema = exports.exportWorkflowStateSchema = exports.listExportJobsSchema = exports.getSettingsSchema = exports.updatePrioritySchema = exports.bulkEscalateSchema = exports.bulkAssignSchema = exports.bulkClaimSchema = exports.resolveByMetadataSchema = exports.claimByMetadataSchema = exports.findByMetadataSchema = exports.deleteTopicSchema = exports.updateTopicSchema = exports.createTopicSchema = exports.getTopicSchema = exports.listTopicsSchema = exports.interruptJobSchema = exports.getJobExecutionSchema = exports.listPipelineJobsSchema = exports.listPipelineEntitiesSchema = exports.listStreamMessagesSchema = exports.getStreamStatsSchema = exports.applyThrottleSchema = exports.rollCallSchema = exports.listAppsSchema = exports.revokeBotKeySchema = exports.createBotApiKeySchema = exports.deleteBotSchema = void 0;
 /**
  * Zod schemas for the admin MCP server tools.
  *
@@ -28,13 +28,24 @@ exports.getProcessDetailSchema = zod_1.z.object({
 });
 // ── escalations (routes/escalations/) ───────────────────────────────────────
 exports.findEscalationsSchema = zod_1.z.object({
-    status: zod_1.z.enum(['pending', 'resolved']).optional().describe('Filter by status'),
+    status: zod_1.z.enum(['pending', 'resolved', 'cancelled']).optional().describe('Filter by status'),
     role: zod_1.z.string().optional().describe('Filter by target role'),
     type: zod_1.z.string().optional().describe('Filter by escalation type'),
+    subtype: zod_1.z.string().optional().describe('Filter by escalation subtype'),
+    assigned_to: zod_1.z.string().optional().describe('Filter by assigned user UUID (active claim holder)'),
+    search: zod_1.z.string().optional().describe('Free-text search across description, type/subtype, role, workflow/origin id, and metadata values (e.g. a correlation key like an order id). Server-side over the full result set.'),
     priority: zod_1.z.number().int().min(1).max(4).optional().describe('Filter by priority (1=critical, 4=low)'),
+    sort_by: zod_1.z.enum(['created_at', 'priority', 'updated_at']).optional().describe('Sort column (default: priority asc, then created_at asc)'),
+    order: zod_1.z.enum(['asc', 'desc']).optional().describe('Sort direction for sort_by'),
     limit: zod_1.z.number().int().min(1).max(100).optional().default(5),
     offset: zod_1.z.number().int().min(0).optional().default(0),
 });
+exports.getEscalationSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('Escalation UUID'),
+});
+exports.getEscalationsByWorkflowSchema = zod_1.z.object({
+    workflow_id: zod_1.z.string().describe('HotMesh workflow ID to list escalations for'),
+});
 exports.getEscalationStatsSchema = zod_1.z.object({
     period: zod_1.z.string().optional().describe('Time period: 1h, 24h, 7d, 30d'),
 });
@@ -43,6 +54,27 @@ exports.claimEscalationSchema = zod_1.z.object({
     duration_minutes: zod_1.z.number().int().optional().default(30)
         .describe('Lock duration in minutes'),
 });
+exports.releaseEscalationSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('Escalation UUID to release back to the pool'),
+});
+exports.resolveEscalationSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('Escalation UUID to resolve'),
+    resolverPayload: zod_1.z.record(zod_1.z.any()).describe('Resolution payload (matches the escalation form/resolver schema)'),
+});
+exports.resolveBySignalKeySchema = zod_1.z.object({
+    signalKey: zod_1.z.string().describe('Deterministic signal_key of an efficient escalation'),
+    resolverPayload: zod_1.z.record(zod_1.z.any()).describe('Resolution payload'),
+});
+exports.escalateEscalationSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('Escalation UUID'),
+    targetRole: zod_1.z.string().describe('Role to route the escalation to'),
+});
+exports.cancelEscalationSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('Escalation UUID to cancel'),
+});
+exports.bulkCancelSchema = zod_1.z.object({
+    ids: zod_1.z.array(zod_1.z.string()).min(1).describe('Escalation UUIDs to cancel'),
+});
 exports.releaseExpiredClaimsSchema = zod_1.z.object({});
 exports.bulkTriageSchema = zod_1.z.object({
     ids: zod_1.z.array(zod_1.z.string()).min(1).describe('Escalation UUIDs to triage'),
@@ -81,6 +113,7 @@ exports.invokeWorkflowSchema = zod_1.z.object({
 });
 exports.getWorkflowStatusSchema = zod_1.z.object({
     workflow_id: zod_1.z.string().describe('HotMesh workflow ID'),
+    app_id: zod_1.z.string().optional().describe('HotMesh namespace for resolution (default: durable). Set this to read a child/workflow running in another app.'),
 });
 // ── mcp servers (routes/mcp.ts) ─────────────────────────────────────────────
 exports.listMcpServersSchema = zod_1.z.object({
@@ -419,14 +452,18 @@ exports.getExportStatusSchema = zod_1.z.object({
 exports.diagnoseJobSchema = zod_1.z.object({
     workflow_id: zod_1.z.string().describe('Workflow ID to diagnose'),
     app_id: zod_1.z.string().optional().default('durable').describe('HotMesh namespace / DB schema (default: durable)'),
+    max_events: zod_1.z.number().int().min(1).optional().default(500).describe('Cap on execution events returned when events are included; most recent are kept (default: 500).'),
+    include: zod_1.z.array(zod_1.z.enum(['events', 'streams'])).optional().describe('Heavy sections to add to the verdict. "events" adds the execution timeline; "streams" adds raw engine+worker messages. Omit for the compact verdict (status, idle, stream counts, escalation, findings). For full raw message payloads prefer list_stream_messages filtered by jid.'),
+    verbosity: zod_1.z.enum(['summary', 'full']).optional().describe('Shorthand: "summary" (default) = verdict only; "full" = events + streams. Overridden by an explicit include[].'),
 });
 exports.findStalledJobsSchema = zod_1.z.object({
     app_id: zod_1.z.string().optional().default('durable').describe('HotMesh namespace / DB schema (default: durable)'),
-    stalled_minutes: zod_1.z.number().int().min(1).optional().default(5).describe('Minimum minutes since last progress (default: 5)'),
+    idle_minutes: zod_1.z.number().int().min(1).optional().default(5).describe('Minimum minutes since last status change (default: 5). NOTE: a frozen updated_at is NORMAL for a workflow waiting at a condition — see each row\'s `likely` classification.'),
     workflow_type: zod_1.z.string().optional().describe('Filter by workflow function name'),
-    limit: zod_1.z.number().int().min(1).max(200).optional().default(50).describe('Max results (default: 50)'),
+    limit: zod_1.z.number().int().min(1).max(200).optional().default(50).describe('Max results (default: 50, max: 200)'),
 });
 exports.findOrphanedSignalsSchema = zod_1.z.object({
     app_id: zod_1.z.string().optional().default('durable').describe('HotMesh namespace / DB schema (default: durable)'),
-    limit: zod_1.z.number().int().min(1).max(500).optional().default(100).describe('Max results (default: 100)'),
+    within_hours: zod_1.z.number().int().min(1).max(720).optional().default(24).describe('Recent time window to scan, in hours (default: 24, max: 720). Bounds the scan of the partitioned worker_streams table — widen deliberately to reach older orphans.'),
+    limit: zod_1.z.number().int().min(1).max(500).optional().default(100).describe('Max results (default: 100, max: 500)'),
 });

package/build/system/mcp-servers/admin/workflows.js

@@ -37,7 +37,7 @@ exports.registerWorkflowTools = registerWorkflowTools;
 const configService = __importStar(require("../../../services/config"));
 const registry_1 = require("../../../services/workers/registry");
 const workflow_invocation_1 = require("../../../services/workflow-invocation");
-const workers_1 = require("../../../workers");
+const workflowApi = __importStar(require("../../../api/workflows"));
 const schemas_1 = require("./schemas");
 function registerWorkflowTools(server) {
     // mirrors GET /api/workflows/discovered
@@ -110,21 +110,23 @@ function registerWorkflowTools(server) {
     server.registerTool('get_workflow_status', {
         title: 'Get Workflow Status',
         description: 'Check the status and result of a workflow execution. Returns ' +
-            'status (0=complete, positive=running) and the result if complete.',
+            'status (running | complete) and the result if complete. ' +
+            'Resolution is namespace-aware: pass app_id to read a workflow (e.g. a ' +
+            'child) running in a non-default HotMesh namespace.',
         inputSchema: schemas_1.getWorkflowStatusSchema,
     }, async (args) => {
-        const { getTaskByWorkflowId } = await Promise.resolve().then(() => __importStar(require('../../../services/task')));
-        const task = await getTaskByWorkflowId(args.workflow_id);
-        if (!task) {
+        const statusResult = await workflowApi.getWorkflowStatus({
+            workflowId: args.workflow_id,
+            appId: args.app_id,
+        });
+        if (statusResult.error) {
             return {
-                content: [{ type: 'text', text: JSON.stringify({ error: 'Workflow not found' }) }],
+                content: [{ type: 'text', text: JSON.stringify({ error: statusResult.error }) }],
                 isError: true,
             };
         }
-        const client = (0, workers_1.createClient)();
-        const handle = await client.workflow.getHandle(task.task_queue || 'long-tail-system', task.workflow_type, args.workflow_id);
-        const status = await handle.status();
-        if (status !== 0) {
+        // HotMesh status: 0 = complete, positive = running.
+        if (statusResult.data?.status !== 0) {
             return {
                 content: [{
                         type: 'text',
@@ -132,11 +134,20 @@ function registerWorkflowTools(server) {
                     }],
             };
         }
-        const result = await handle.result();
+        const resultResult = await workflowApi.getWorkflowResult({
+            workflowId: args.workflow_id,
+            appId: args.app_id,
+        });
+        if (resultResult.error) {
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ error: resultResult.error }) }],
+                isError: true,
+            };
+        }
         return {
             content: [{
                     type: 'text',
-                    text: JSON.stringify({ workflow_id: args.workflow_id, status: 'complete', result }),
+                    text: JSON.stringify({ workflow_id: args.workflow_id, status: 'complete', result: resultResult.data?.result }),
                 }],
         };
     });