@hotmeshio/long-tail 0.5.6 → 0.5.7

package/build/services/diagnostics/patterns.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchPatterns = matchPatterns;
+/**
+ * Match event stream + stream messages against known failure patterns.
+ * Returns findings ordered by severity (critical first).
+ */
+function matchPatterns(execution, workerMessages, engineMessages, escalationRow) {
+    const findings = [];
+    const events = execution.events ?? [];
+    const now = Date.now();
+    // ── Derive open signals ──────────────────────────────────────────────────
+    const signalCompletions = new Set(events
+        .filter(e => e.event_type === 'workflow_execution_signaled')
+        .map(e => e.attributes.timeline_key)
+        .filter(Boolean));
+    const openSignals = events.filter(e => e.event_type === 'signal_wait_started' &&
+        !signalCompletions.has(e.attributes.timeline_key));
+    // ── Dead-lettered messages ────────────────────────────────────────────────
+    const deadWorker = workerMessages.filter(m => m.dead_lettered_at);
+    const deadEngine = engineMessages.filter(m => m.dead_lettered_at);
+    // ── Reservation leaks: claimed but not ACK'd for > 30s ───────────────────
+    const leaks = workerMessages.filter(m => m.reserved_at && !m.expired_at && !m.dead_lettered_at &&
+        now - new Date(m.reserved_at).getTime() > 30_000);
+    // ── Pattern: orphaned_signal ──────────────────────────────────────────────
+    if (openSignals.length > 0 && !escalationRow) {
+        const workerMsg = workerMessages.find(m => m.expired_at && m.aid?.endsWith('/worker'));
+        const payload = safeParseJson(workerMsg?.message);
+        const queueConfig = payload?.data?.queueConfig;
+        const signalId = payload?.data?.signalId;
+        findings.push({
+            condition: 'orphaned_signal',
+            confidence: 0.98,
+            severity: 'critical',
+            evidence: [
+                `${openSignals.length} open signal(s) with no matching resolution`,
+                `No escalation row in hmsh_escalations for this workflow`,
+                queueConfig == null
+                    ? `Worker result missing queueConfig — escalation INSERT was skipped (pre-0.22 SDK)`
+                    : `Worker result has queueConfig but escalation INSERT did not complete`,
+                ...(signalId ? [`Signal key: ${signalId}`] : []),
+            ],
+            treatment: [
+                { action: 'create_escalation_row', note: 'INSERT missing row into public.hmsh_escalations' },
+                ...(signalId ? [{ action: 'resolve_by_signal_key', signal_key: signalId, note: 'POST /api/escalations/resolve-by-signal-key after inserting escalation row' }] : []),
+            ],
+        });
+    }
+    // ── Pattern: normal_wait ──────────────────────────────────────────────────
+    // Two paths reach here:
+    // 1. Open signal in event stream (signal_wait_started) + pending escalation
+    // 2. No terminal event + pending escalation (conditionLT path — no signal_wait_started in export)
+    const isRunning = !events.some(e => e.event_type === 'workflow_execution_completed' || e.event_type === 'workflow_execution_failed');
+    const isNormalWait = (openSignals.length > 0 && escalationRow?.status === 'pending') ||
+        (isRunning && events.length > 0 && escalationRow?.status === 'pending');
+    if (isNormalWait) {
+        findings.push({
+            condition: 'normal_wait',
+            confidence: 0.99,
+            severity: 'info',
+            evidence: [
+                `Workflow suspended — escalation exists (status: pending)`,
+                ...(escalationRow.role ? [`Role: ${escalationRow.role}, Type: ${escalationRow.type}`] : []),
+                ...(escalationRow.id ? [`Escalation id: ${escalationRow.id}`] : []),
+            ],
+            treatment: [{ action: 'none', note: 'Waiting for human to claim and resolve escalation' }],
+        });
+    }
+    // ── Pattern: dead_lettered_activity ──────────────────────────────────────
+    if (deadWorker.length > 0 || deadEngine.length > 0) {
+        const samples = [...deadWorker, ...deadEngine].slice(0, 3);
+        findings.push({
+            condition: 'dead_lettered_activity',
+            confidence: 0.99,
+            severity: 'critical',
+            evidence: [
+                `${deadWorker.length} worker message(s) dead-lettered, ${deadEngine.length} engine message(s) dead-lettered`,
+                ...samples.map(m => `aid: ${m.aid ?? 'engine'}, retries: ${m.retry_attempt}/${m.max_retry_attempts}, stream: ${m.stream_name}`),
+            ],
+            treatment: [{
+                    action: 'investigate_dead_letter',
+                    count: deadWorker.length + deadEngine.length,
+                    note: 'Message exhausted retries — check worker health and DB connectivity',
+                }],
+        });
+    }
+    // ── Pattern: reservation_leak ─────────────────────────────────────────────
+    if (leaks.length > 0) {
+        findings.push({
+            condition: 'reservation_leak',
+            confidence: 0.85,
+            severity: 'warning',
+            evidence: leaks.map(m => `aid: ${m.aid}, claimed by: ${m.reserved_by ?? 'unknown'}, open for ${Math.round((now - new Date(m.reserved_at).getTime()) / 1000)}s`),
+            treatment: [{ action: 'check_worker_health', note: 'Worker claimed message but never ACKd — check for crashed workers' }],
+        });
+    }
+    // ── Pattern: terminal_failure ─────────────────────────────────────────────
+    const lastEvent = events.at(-1);
+    if (lastEvent?.event_type === 'workflow_execution_failed') {
+        const attrs = lastEvent.attributes;
+        findings.push({
+            condition: 'terminal_failure',
+            confidence: 0.99,
+            severity: 'critical',
+            evidence: [
+                `Workflow terminated with failure`,
+                ...(attrs?.error ? [`Error: ${attrs.error}`] : []),
+            ],
+            treatment: [{ action: 'none', note: 'Workflow terminated — review error and restart if needed' }],
+        });
+    }
+    // ── Pattern: never_started ────────────────────────────────────────────────
+    const nonStartEvents = events.filter(e => e.event_type !== 'workflow_execution_started');
+    if (events.length > 0 && nonStartEvents.length === 0) {
+        findings.push({
+            condition: 'never_started',
+            confidence: 0.90,
+            severity: 'critical',
+            evidence: [`Workflow created but no activities have run — engine may not be consuming this stream`],
+            treatment: [{ action: 'check_engine_health', note: 'Check engine health and stream backlog for this workflow type' }],
+        });
+    }
+    // ── Default: healthy ──────────────────────────────────────────────────────
+    if (findings.length === 0) {
+        const isCompleted = events.some(e => e.event_type === 'workflow_execution_completed' || e.event_type === 'workflow_execution_failed');
+        findings.push({
+            condition: isCompleted ? 'completed' : 'running',
+            confidence: 0.95,
+            severity: 'info',
+            evidence: [isCompleted ? 'Workflow completed normally' : 'Workflow is running — no anomalies detected'],
+            treatment: [{ action: 'none', note: 'No intervention required' }],
+        });
+    }
+    // Critical first
+    const order = { critical: 0, warning: 1, info: 2 };
+    return findings.sort((a, b) => order[a.severity] - order[b.severity]);
+}
+function safeParseJson(raw) {
+    if (!raw)
+        return null;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}

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

@@ -20,6 +20,15 @@ export declare function bulkAssignEscalations(ids: string[], targetUserId: strin
  * Clears assignment on all affected rows.
  */
 export declare function bulkEscalateToRole(ids: string[], targetRole: string): Promise<number>;
+/**
+ * Bulk cancel escalations. Each row is cancelled individually; rows already in
+ * a terminal state are silently skipped by the SDK. Returns the count
+ * successfully cancelled.
+ */
+export declare function bulkCancelEscalations(ids: string[]): Promise<{
+    cancelled: number;
+    skipped: number;
+}>;
 /**
  * Bulk resolve escalations for AI triage.
  * Returns full records so the caller can start triage workflows. No signal is

package/build/services/escalation/bulk.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.bulkClaimEscalations = bulkClaimEscalations;
 exports.bulkAssignEscalations = bulkAssignEscalations;
 exports.bulkEscalateToRole = bulkEscalateToRole;
+exports.bulkCancelEscalations = bulkCancelEscalations;
 exports.bulkResolveForTriage = bulkResolveForTriage;
 const client_1 = require("./client");
 const map_1 = require("./map");
@@ -41,6 +42,26 @@ async function bulkEscalateToRole(ids, targetRole) {
     const client = await (0, client_1.escalations)();
     return client.escalateManyToRole({ ids, targetRole });
 }
+/**
+ * Bulk cancel escalations. Each row is cancelled individually; rows already in
+ * a terminal state are silently skipped by the SDK. Returns the count
+ * successfully cancelled.
+ */
+async function bulkCancelEscalations(ids) {
+    if (ids.length === 0)
+        return { cancelled: 0, skipped: 0 };
+    const client = await (0, client_1.escalations)();
+    let cancelled = 0;
+    let skipped = 0;
+    await Promise.all(ids.map(async (id) => {
+        const result = await client.cancel(id);
+        if (result.ok)
+            cancelled++;
+        else
+            skipped++;
+    }));
+    return { cancelled, skipped };
+}
 /**
  * Bulk resolve escalations for AI triage.
  * Returns full records so the caller can start triage workflows. No signal is

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

@@ -32,6 +32,13 @@ export declare function getEscalationBySignalKey(signalKey: string): Promise<LTE
  * pre-check (that would be a TOCTOU window) — the atomic resolve is the arbiter.
  */
 export declare function resolveEscalationBySignalKey(signalKey: string, resolverPayload: Record<string, any>): Promise<LTEscalationRecord | null>;
+/**
+ * Mark an escalation cancelled — used when the tied workflow has terminated and
+ * can never receive the resolution signal. The escalation is removed from the
+ * active queue but preserved for audit. Returns null when the row is missing or
+ * already terminal.
+ */
+export declare function cancelEscalation(id: string): Promise<LTEscalationRecord | null>;
 /**
  * Bulk update priority for a set of escalations. Only pending escalations are
  * updated.
@@ -62,6 +69,16 @@ export declare function escalateToRole(id: string, targetRole: string): Promise<
 export declare function getEscalation(id: string): Promise<LTEscalationRecord | null>;
 export declare function getEscalationsByTaskId(taskId: string): Promise<LTEscalationRecord[]>;
 export declare function getEscalationsByWorkflowId(workflowId: string): Promise<LTEscalationRecord[]>;
+/**
+ * Cancel all pending escalations tied to a workflow in one atomic UPDATE.
+ * Called after workflow termination so escalations don't remain in the queue.
+ *
+ * HotMesh's interrupt() is supposed to do this atomically, but it filters by
+ * `app_id = <engine-appId>`. Long-tail's Durable client uses app_id='durable'
+ * while escalations are stored with app_id='hmsh' — the WHERE never matches.
+ * This single UPDATE bypasses the SDK entirely and closes that gap.
+ */
+export declare function cancelEscalationsByWorkflowId(workflowId: string): Promise<number>;
 export declare function updateEscalationMetadata(id: string, patch: Record<string, any>): Promise<LTEscalationRecord | null>;
 export declare function enrichEscalationRouting(id: string, metadataPatch: Record<string, any>, workflowFields: {
     workflowType?: string;

package/build/services/escalation/crud.js

@@ -5,6 +5,7 @@ exports.claimEscalation = claimEscalation;
 exports.resolveEscalation = resolveEscalation;
 exports.getEscalationBySignalKey = getEscalationBySignalKey;
 exports.resolveEscalationBySignalKey = resolveEscalationBySignalKey;
+exports.cancelEscalation = cancelEscalation;
 exports.updateEscalationsPriority = updateEscalationsPriority;
 exports.getEscalationRoles = getEscalationRoles;
 exports.releaseEscalation = releaseEscalation;
@@ -13,6 +14,7 @@ exports.escalateToRole = escalateToRole;
 exports.getEscalation = getEscalation;
 exports.getEscalationsByTaskId = getEscalationsByTaskId;
 exports.getEscalationsByWorkflowId = getEscalationsByWorkflowId;
+exports.cancelEscalationsByWorkflowId = cancelEscalationsByWorkflowId;
 exports.updateEscalationMetadata = updateEscalationMetadata;
 exports.enrichEscalationRouting = enrichEscalationRouting;
 exports.getEscalationsByOriginId = getEscalationsByOriginId;
@@ -138,6 +140,30 @@ async function resolveEscalationBySignalKey(signalKey, resolverPayload) {
         return null;
     return resolveEscalation(escalation.id, resolverPayload);
 }
+/**
+ * Mark an escalation cancelled — used when the tied workflow has terminated and
+ * can never receive the resolution signal. The escalation is removed from the
+ * active queue but preserved for audit. Returns null when the row is missing or
+ * already terminal.
+ */
+async function cancelEscalation(id) {
+    const client = await (0, client_1.escalations)();
+    const result = await client.cancel(id);
+    if (!result.ok)
+        return null;
+    const cancelled = (0, map_1.toEscalationRecord)(result.entry);
+    (0, publish_1.publishEscalationEvent)({
+        type: 'escalation.cancelled',
+        source: 'service',
+        workflowId: cancelled.workflow_id || '',
+        workflowName: cancelled.workflow_type || '',
+        taskQueue: cancelled.task_queue || '',
+        escalationId: cancelled.id,
+        status: 'cancelled',
+        data: { reason: 'workflow_terminated' },
+    });
+    return cancelled;
+}
 /**
  * Bulk update priority for a set of escalations. Only pending escalations are
  * updated.
@@ -227,6 +253,37 @@ async function getEscalationsByWorkflowId(workflowId) {
     });
     return (0, map_1.toEscalationRecords)(rows);
 }
+/**
+ * Cancel all pending escalations tied to a workflow in one atomic UPDATE.
+ * Called after workflow termination so escalations don't remain in the queue.
+ *
+ * HotMesh's interrupt() is supposed to do this atomically, but it filters by
+ * `app_id = <engine-appId>`. Long-tail's Durable client uses app_id='durable'
+ * while escalations are stored with app_id='hmsh' — the WHERE never matches.
+ * This single UPDATE bypasses the SDK entirely and closes that gap.
+ */
+async function cancelEscalationsByWorkflowId(workflowId) {
+    await (0, client_1.ensureEscalationCompatView)();
+    const pool = (0, db_1.getPool)();
+    const { rows } = await pool.query(`UPDATE public.hmsh_escalations
+        SET status = 'cancelled', updated_at = NOW()
+      WHERE workflow_id = $1
+        AND status = 'pending'
+      RETURNING id, workflow_id, workflow_type, task_queue`, [workflowId]);
+    for (const row of rows) {
+        (0, publish_1.publishEscalationEvent)({
+            type: 'escalation.cancelled',
+            source: 'service',
+            workflowId: row.workflow_id || '',
+            workflowName: row.workflow_type || '',
+            taskQueue: row.task_queue || '',
+            escalationId: row.id,
+            status: 'cancelled',
+            data: { reason: 'workflow_terminated' },
+        });
+    }
+    return rows.length;
+}
 async function updateEscalationMetadata(id, patch) {
     const client = await (0, client_1.escalations)();
     const entry = await client.update({ id, metadata: patch });

package/build/services/orchestrator/condition.d.ts

@@ -36,4 +36,4 @@ import type { Types } from '@hotmeshio/hotmesh';
  * const decision = await conditionLT<{ approved: boolean }>(signalId);
  * ```
  */
-export declare function conditionLT<T = Record<string, any>>(signalId: string, escalation?: Types.ConditionQueueConfig): Promise<T>;
+export declare function conditionLT<T = Record<string, any>>(signalId: string, escalation?: Types.ConditionQueueConfig): Promise<T | false | null>;

package/build/services/orchestrator/condition.js

@@ -76,6 +76,9 @@ const LT_ACTIVITY_QUEUE = 'lt-interceptor';
  */
 async function conditionLT(signalId, escalation) {
     const raw = await hotmesh_1.Durable.workflow.condition(signalId, escalation);
+    // false = timeout, null = escalation was cancelled — propagate both as-is
+    if (raw === null || raw === false)
+        return raw;
     const escalationId = raw.$escalation_id;
     if (escalationId) {
         // Resolve the escalation as a durable activity (crash-safe)

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

@@ -0,0 +1,10 @@
+/**
+ * Diagnostics tools — mirrors routes/diagnostics.ts
+ *
+ * Three tools:
+ *   diagnose_job            — full per-job diagnosis: events + stream messages + findings
+ *   find_stalled_jobs       — fleet-level: running jobs with no recent progress
+ *   find_orphaned_signals   — fleet-level: suspended jobs with no escalation row
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerDiagnosticsTools(server: McpServer): void;

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

@@ -0,0 +1,94 @@
+"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.registerDiagnosticsTools = registerDiagnosticsTools;
+const api = __importStar(require("../../../api/diagnostics"));
+const schemas_1 = require("./schemas");
+function registerDiagnosticsTools(server) {
+    server.registerTool('diagnose_job', {
+        title: 'Diagnose Job',
+        description: 'Complete diagnostic for a single workflow job. Combines the execution event ' +
+            'timeline (from exportWorkflowExecution) with the raw stream messages for that ' +
+            'job (engine + worker, including full JSONB payload, retry state, and timing) ' +
+            'and the escalation row from hmsh_escalations. Returns structured findings[] ' +
+            'with confidence, evidence, and treatment options. ' +
+            'Use when a workflow is stalled, stuck at a condition, has dead-lettered ' +
+            'messages, or shows unexpected behavior. Call find_stalled_jobs or ' +
+            'find_orphaned_signals first to surface job IDs, then call this per job.',
+        inputSchema: schemas_1.diagnoseJobSchema,
+    }, async (args) => {
+        const result = await api.diagnose({ workflowId: args.workflow_id, appId: args.app_id });
+        if (result.error) {
+            return { content: [{ type: 'text', text: JSON.stringify({ error: result.error }) }], isError: true };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(result.data) }] };
+    });
+    server.registerTool('find_stalled_jobs', {
+        title: 'Find Stalled Jobs',
+        description: 'Find all running jobs that have not progressed in N minutes. ' +
+            'Returns workflow_id, workflow_type, stalled_ms, created_at, updated_at. ' +
+            'Use as a first step to surface the scope of a stall incident. ' +
+            'Follow up with diagnose_job on individual results for root cause.',
+        inputSchema: schemas_1.findStalledJobsSchema,
+    }, async (args) => {
+        const result = await api.stalledJobs({
+            appId: args.app_id,
+            stalledMinutes: args.stalled_minutes,
+            workflowType: args.workflow_type,
+            limit: args.limit,
+        });
+        if (result.error) {
+            return { content: [{ type: 'text', text: JSON.stringify({ error: result.error }) }], isError: true };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(result.data) }] };
+    });
+    server.registerTool('find_orphaned_signals', {
+        title: 'Find Orphaned Signals',
+        description: 'Find running workflows that are suspended at a condition() call ' +
+            '(waiter Leg1 committed, signal registered) but have no corresponding ' +
+            'escalation row in hmsh_escalations. These are permanently stalled — ' +
+            'the workflow is waiting for a signal that nothing will ever send. ' +
+            'Returns job_id, signal_id, workflow_name, suspended_at, stalled_ms, ' +
+            'and missing_queue_config (true = pre-0.22 SDK, false = DB error at commit time). ' +
+            'Call diagnose_job on any result for the full picture and recovery options.',
+        inputSchema: schemas_1.findOrphanedSignalsSchema,
+    }, async (args) => {
+        const result = await api.orphanedSignals({ appId: args.app_id, limit: args.limit });
+        if (result.error) {
+            return { content: [{ type: 'text', text: JSON.stringify({ error: result.error }) }], isError: true };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(result.data) }] };
+    });
+}

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

@@ -54,7 +54,8 @@ const topics_1 = require("./topics");
 const settings_1 = require("./settings");
 const exports_1 = require("./exports");
 const overview_1 = require("./overview");
-const TOOL_COUNT = 72;
+const diagnostics_1 = require("./diagnostics");
+const TOOL_COUNT = 75;
 let server = null;
 async function createAdminServer(options) {
     if (server && !options?.fresh)
@@ -81,7 +82,8 @@ async function createAdminServer(options) {
     (0, settings_1.registerSettingsTools)(instance); //  1 tool
     (0, exports_1.registerExportTools)(instance); //  4 tools
     (0, overview_1.registerOverviewTools)(instance); //  1 tool
-    // Total: 72
+    (0, diagnostics_1.registerDiagnosticsTools)(instance); //  3 tools
+    // Total: 75
     logger_1.loggerRegistry.info(`[lt-mcp:admin] ${name} ready (${TOOL_COUNT} tools registered)`);
     return instance;
 }

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

@@ -1023,3 +1023,39 @@ export declare const getExportStatusSchema: z.ZodObject<{
 }, {
     workflow_id: string;
 }>;
+export declare const diagnoseJobSchema: z.ZodObject<{
+    workflow_id: z.ZodString;
+    app_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    app_id: string;
+    workflow_id: string;
+}, {
+    workflow_id: string;
+    app_id?: string | undefined;
+}>;
+export declare const findStalledJobsSchema: z.ZodObject<{
+    app_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    stalled_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;
+    workflow_type?: string | undefined;
+}, {
+    workflow_type?: string | undefined;
+    app_id?: string | undefined;
+    limit?: number | undefined;
+    stalled_minutes?: number | undefined;
+}>;
+export declare const findOrphanedSignalsSchema: z.ZodObject<{
+    app_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    app_id: string;
+    limit: number;
+}, {
+    app_id?: string | undefined;
+    limit?: 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.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.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;
 /**
  * Zod schemas for the admin MCP server tools.
  *
@@ -415,3 +415,18 @@ exports.exportWorkflowExecutionSchema = zod_1.z.object({
 exports.getExportStatusSchema = zod_1.z.object({
     workflow_id: zod_1.z.string().describe('Workflow ID to check export status'),
 });
+// ── Diagnostics ───────────────────────────────────────────────────────────────
+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)'),
+});
+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)'),
+    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)'),
+});
+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)'),
+});