@hotmeshio/long-tail 0.1.0

package/build/system/workflows/mcp-triage/response.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripJsonComments = exports.parseTriageResponse = void 0;
+exports.handleFinalResponse = handleFinalResponse;
+const hotmesh_1 = require("@hotmeshio/hotmesh");
+const response_builders_1 = require("./response-builders");
+// Re-export public API so existing consumers are unaffected
+var response_builders_2 = require("./response-builders");
+Object.defineProperty(exports, "parseTriageResponse", { enumerable: true, get: function () { return response_builders_2.parseTriageResponse; } });
+Object.defineProperty(exports, "stripJsonComments", { enumerable: true, get: function () { return response_builders_2.stripJsonComments; } });
+// ── Main handler ──────────────────────────────────────────────
+/**
+ * Process the LLM's final response and route corrected data
+ * back to the original workflow through the appropriate exit path.
+ */
+async function handleFinalResponse(content, envelope, toolCallCount, deps) {
+    const parsed = (0, response_builders_1.parseTriageResponse)(content);
+    const ctx = extractTriageContext(envelope);
+    const milestones = (0, response_builders_1.buildMilestones)(toolCallCount);
+    // 1. LLM couldn't fix — return failure so the parent router gets signaled
+    if (!parsed.correctedData) {
+        return (0, response_builders_1.buildUnresolvedReturn)(ctx, parsed, toolCallCount);
+    }
+    // 2. Notify engineering if the LLM has a recommendation
+    if (parsed.recommendation) {
+        await notifyEngineeringOfFix(deps, ctx, parsed, toolCallCount);
+    }
+    // 3. Merge corrected data with original escalation payload
+    const correctedData = mergeCorrectedData(ctx.escalationPayload, parsed.correctedData);
+    // 4. Exit the vortex — route fix back to the original workflow
+    if (ctx.originalWorkflowType && ctx.originalTaskQueue && ctx.originalTaskId) {
+        const originalEnvelope = await reconstructOriginalEnvelope(deps, ctx);
+        if (parsed.directResolution) {
+            // 4a. Direct resolution — re-run original workflow immediately
+            const rerunId = await rerunOriginalWorkflow(deps, ctx, originalEnvelope, correctedData, parsed, toolCallCount);
+            return (0, response_builders_1.buildDirectResolutionReturn)(ctx, parsed, correctedData, rerunId, toolCallCount, milestones);
+        }
+        // 4b. Escalation path — create follow-up for human review
+        await createReviewEscalation(deps, ctx, originalEnvelope, correctedData, parsed, toolCallCount);
+    }
+    // 5. Return success — vortex unwound
+    return (0, response_builders_1.buildVortexUnwoundReturn)(ctx, parsed, correctedData, toolCallCount, milestones);
+}
+// ── Context extraction ────────────────────────────────────────
+function extractTriageContext(envelope) {
+    return {
+        originId: envelope.data.originId,
+        originalWorkflowType: envelope.data.originalWorkflowType,
+        originalTaskQueue: envelope.data.originalTaskQueue,
+        originalTaskId: envelope.data.originalTaskId,
+        escalationPayload: envelope.data.escalationPayload || {},
+        escalationId: envelope.data.escalationId,
+        parentId: envelope.lt?.parentId,
+    };
+}
+function mergeCorrectedData(escalationPayload, correctedData) {
+    const merged = { ...escalationPayload, ...correctedData };
+    delete merged._lt;
+    return merged;
+}
+// ── Envelope reconstruction ───────────────────────────────────
+async function reconstructOriginalEnvelope(deps, ctx) {
+    const originalTask = await deps.ltGetTask(ctx.originalTaskId);
+    let envelope = {};
+    if (originalTask?.envelope) {
+        try {
+            envelope = JSON.parse(originalTask.envelope);
+        }
+        catch { /* use empty */ }
+    }
+    const meta = originalTask?.metadata;
+    envelope.lt = {
+        ...envelope.lt,
+        taskId: ctx.originalTaskId,
+        originId: ctx.originId,
+        parentId: originalTask?.parent_id || envelope.lt?.parentId,
+        signalId: meta?.signalId,
+        parentWorkflowId: meta?.parentWorkflowId,
+        parentTaskQueue: meta?.parentTaskQueue,
+        parentWorkflowType: meta?.parentWorkflowType,
+    };
+    // Strip triage flags so follow-on resolution doesn't re-trigger mcpTriage
+    if (envelope.data?._lt) {
+        delete envelope.data._lt;
+    }
+    return envelope;
+}
+// ── Vortex exit paths ─────────────────────────────────────────
+async function rerunOriginalWorkflow(deps, ctx, originalEnvelope, correctedData, triageParsed, toolCallCount) {
+    originalEnvelope.resolver = {
+        ...correctedData,
+        _triageContext: {
+            diagnosis: triageParsed.diagnosis,
+            actions_taken: triageParsed.actions_taken,
+            recommendation: triageParsed.recommendation,
+            confidence: triageParsed.confidence,
+            tool_calls_made: toolCallCount,
+        },
+    };
+    originalEnvelope.lt = {
+        ...originalEnvelope.lt,
+        escalationId: ctx.escalationId,
+        _triageDirect: true,
+    };
+    const rerunId = `triage-rerun-${ctx.originalTaskId}-${hotmesh_1.Durable.guid()}`;
+    // Create a task record so the re-run is visible in the wizard
+    await deps.ltCreateTask({
+        workflowId: rerunId,
+        workflowType: ctx.originalWorkflowType,
+        ltType: ctx.originalWorkflowType,
+        taskQueue: ctx.originalTaskQueue,
+        signalId: `lt-${rerunId}`,
+        parentWorkflowId: rerunId,
+        originId: ctx.originId,
+        envelope: JSON.stringify(originalEnvelope),
+    });
+    await deps.ltStartWorkflow({
+        workflowName: ctx.originalWorkflowType,
+        taskQueue: ctx.originalTaskQueue,
+        workflowId: rerunId,
+        args: [originalEnvelope],
+        expire: 180,
+    });
+    return rerunId;
+}
+async function createReviewEscalation(deps, ctx, originalEnvelope, correctedData, parsed, toolCallCount) {
+    const originalTask = await deps.ltGetTask(ctx.originalTaskId);
+    const wfConfig = await deps.ltGetWorkflowConfig(ctx.originalWorkflowType);
+    await deps.ltCreateEscalation({
+        type: ctx.originalWorkflowType,
+        subtype: ctx.originalWorkflowType,
+        description: 'AI Triage — Ready for Review',
+        priority: 3,
+        taskId: ctx.originalTaskId,
+        originId: ctx.originId,
+        parentId: ctx.parentId,
+        role: wfConfig?.role || 'reviewer',
+        envelope: JSON.stringify(originalEnvelope),
+        escalationPayload: JSON.stringify({
+            ...correctedData,
+            _triage: {
+                diagnosis: parsed.diagnosis,
+                actions_taken: parsed.actions_taken,
+                tool_calls_made: toolCallCount,
+                confidence: parsed.confidence,
+                recommendation: parsed.recommendation,
+                originalData: ctx.escalationPayload,
+            },
+        }),
+        workflowId: originalTask?.workflow_id,
+        workflowType: ctx.originalWorkflowType,
+        taskQueue: ctx.originalTaskQueue,
+    });
+}
+async function notifyEngineeringOfFix(deps, ctx, parsed, toolCallCount) {
+    await deps.notifyEngineering(ctx.originId, `Triage auto-remediation for ${ctx.originalWorkflowType}: ${parsed.diagnosis || 'issue resolved'}. Recommendation: ${parsed.recommendation}`, { actions_taken: parsed.actions_taken, tool_calls: toolCallCount, confidence: parsed.confidence });
+}

package/build/system/workflows/mcp-triage/types.d.ts

@@ -0,0 +1,20 @@
+/** Shared type definitions for the mcp-triage workflow. */
+import type * as activities from '../../activities/triage';
+import type * as interceptorActivities from '../../../services/interceptor/activities';
+export interface TriageResponseDeps {
+    ltCreateEscalation: typeof interceptorActivities.ltCreateEscalation;
+    ltCreateTask: typeof interceptorActivities.ltCreateTask;
+    ltGetTask: typeof interceptorActivities.ltGetTask;
+    ltGetWorkflowConfig: typeof interceptorActivities.ltGetWorkflowConfig;
+    ltStartWorkflow: typeof interceptorActivities.ltStartWorkflow;
+    notifyEngineering: typeof activities.notifyEngineering;
+}
+export interface TriageContext {
+    originId: string;
+    originalWorkflowType: string;
+    originalTaskQueue: string;
+    originalTaskId: string | undefined;
+    escalationPayload: Record<string, any>;
+    escalationId: string | undefined;
+    parentId: string | undefined;
+}

package/build/system/workflows/mcp-triage/types.js

@@ -0,0 +1,3 @@
+"use strict";
+/** Shared type definitions for the mcp-triage workflow. */
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/system/workflows/mcp-triage-deterministic/activities.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Triage deterministic activities — reuse the compiled workflow invoker.
+ */
+export { invokeCompiledWorkflow } from '../mcp-deterministic/activities';

package/build/system/workflows/mcp-triage-deterministic/activities.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invokeCompiledWorkflow = void 0;
+/**
+ * Triage deterministic activities — reuse the compiled workflow invoker.
+ */
+var activities_1 = require("../mcp-deterministic/activities");
+Object.defineProperty(exports, "invokeCompiledWorkflow", { enumerable: true, get: function () { return activities_1.invokeCompiledWorkflow; } });

package/build/system/workflows/mcp-triage-deterministic/index.d.ts

@@ -0,0 +1,12 @@
+import type { LTEnvelope, LTReturn } from '../../../types';
+/**
+ * MCP Triage Deterministic workflow (leaf).
+ *
+ * Invokes a matched compiled YAML workflow for triage remediation.
+ * Called by mcpTriageRouter when a compiled workflow matches
+ * the triage context with high confidence.
+ *
+ * The result is wrapped as correctedData so the triage vortex exit
+ * logic in mcpTriage can route it back to the original workflow.
+ */
+export declare function mcpTriageDeterministic(envelope: LTEnvelope): Promise<LTReturn>;

package/build/system/workflows/mcp-triage-deterministic/index.js

@@ -0,0 +1,83 @@
+"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.mcpTriageDeterministic = mcpTriageDeterministic;
+const hotmesh_1 = require("@hotmeshio/hotmesh");
+const activities = __importStar(require("./activities"));
+const { invokeCompiledWorkflow } = hotmesh_1.Durable.workflow.proxyActivities({
+    activities,
+    retryPolicy: {
+        maximumAttempts: 3,
+        backoffCoefficient: 2,
+        maximumInterval: '10 seconds',
+    },
+});
+/**
+ * MCP Triage Deterministic workflow (leaf).
+ *
+ * Invokes a matched compiled YAML workflow for triage remediation.
+ * Called by mcpTriageRouter when a compiled workflow matches
+ * the triage context with high confidence.
+ *
+ * The result is wrapped as correctedData so the triage vortex exit
+ * logic in mcpTriage can route it back to the original workflow.
+ */
+async function mcpTriageDeterministic(envelope) {
+    const { workflowName, inputs, confidence } = envelope.data;
+    const result = await invokeCompiledWorkflow(workflowName, inputs);
+    return {
+        type: 'return',
+        data: {
+            triaged: true,
+            exitedVortex: true,
+            directResolution: true,
+            correctedData: result?.result || result,
+            originalWorkflowType: envelope.data.originalWorkflowType,
+            originalTaskQueue: envelope.data.originalTaskQueue,
+            originId: envelope.data.originId,
+            diagnosis: `Matched compiled workflow "${workflowName}" with ${(confidence * 100).toFixed(0)}% confidence.`,
+            actions_taken: [`Invoked compiled workflow: ${workflowName}`],
+            tool_calls_made: 1,
+            confidence,
+            discovery: { method: 'compiled-workflow', confidence, workflowName },
+        },
+        milestones: [
+            { name: 'triage', value: 'completed' },
+            { name: 'triage_method', value: 'deterministic' },
+            { name: 'discovery', value: 'compiled_match' },
+            { name: 'confidence', value: String(confidence) },
+        ],
+    };
+}

package/build/system/workflows/mcp-triage-router/activities.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Router activities — discovery, matching, and input extraction.
+ * These run in the router workflow, NOT in the dynamic mcpTriage workflow,
+ * so they don't pollute the execution trace that gets compiled to YAML.
+ *
+ * Function names are unique to avoid collisions with mcpQuery activities
+ * on the same task queue.
+ */
+export { findTriageWorkflows, evaluateTriageMatch, extractTriageInputs, } from '../../activities/triage';

package/build/system/workflows/mcp-triage-router/activities.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractTriageInputs = exports.evaluateTriageMatch = exports.findTriageWorkflows = void 0;
+/**
+ * Router activities — discovery, matching, and input extraction.
+ * These run in the router workflow, NOT in the dynamic mcpTriage workflow,
+ * so they don't pollute the execution trace that gets compiled to YAML.
+ *
+ * Function names are unique to avoid collisions with mcpQuery activities
+ * on the same task queue.
+ */
+var triage_1 = require("../../activities/triage");
+Object.defineProperty(exports, "findTriageWorkflows", { enumerable: true, get: function () { return triage_1.findTriageWorkflows; } });
+Object.defineProperty(exports, "evaluateTriageMatch", { enumerable: true, get: function () { return triage_1.evaluateTriageMatch; } });
+Object.defineProperty(exports, "extractTriageInputs", { enumerable: true, get: function () { return triage_1.extractTriageInputs; } });

package/build/system/workflows/mcp-triage-router/index.d.ts

@@ -0,0 +1,13 @@
+import type { LTEnvelope, LTReturn } from '../../../types';
+/**
+ * MCP Triage Router (orchestrator/container).
+ *
+ * Entry point for triage requests. Determines whether a compiled
+ * deterministic workflow can handle the triage issue or whether
+ * dynamic MCP orchestration is needed.
+ *
+ * Phase 1: FTS + tag discovery of compiled workflows
+ * Phase 2: LLM-as-judge matching + input extraction
+ * Route: mcpTriageDeterministic (compiled match) OR mcpTriage (dynamic)
+ */
+export declare function mcpTriageRouter(envelope: LTEnvelope): Promise<LTReturn>;

package/build/system/workflows/mcp-triage-router/index.js

@@ -0,0 +1,122 @@
+"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.mcpTriageRouter = mcpTriageRouter;
+const hotmesh_1 = require("@hotmeshio/hotmesh");
+const orchestrator_1 = require("../../../services/orchestrator");
+const activities = __importStar(require("./activities"));
+const { findTriageWorkflows, evaluateTriageMatch, extractTriageInputs, } = hotmesh_1.Durable.workflow.proxyActivities({
+    activities,
+    retryPolicy: {
+        maximumAttempts: 3,
+        backoffCoefficient: 2,
+        maximumInterval: '10 seconds',
+    },
+});
+/**
+ * MCP Triage Router (orchestrator/container).
+ *
+ * Entry point for triage requests. Determines whether a compiled
+ * deterministic workflow can handle the triage issue or whether
+ * dynamic MCP orchestration is needed.
+ *
+ * Phase 1: FTS + tag discovery of compiled workflows
+ * Phase 2: LLM-as-judge matching + input extraction
+ * Route: mcpTriageDeterministic (compiled match) OR mcpTriage (dynamic)
+ */
+async function mcpTriageRouter(envelope) {
+    const { originalWorkflowType, escalationPayload, resolverPayload, } = envelope.data;
+    // Build a search prompt from the triage context for compiled workflow discovery
+    const resolverNotes = resolverPayload?.notes || resolverPayload?._lt?.notes || '';
+    const escalationDescription = typeof escalationPayload === 'object'
+        ? (escalationPayload.description || escalationPayload.message || '')
+        : '';
+    const searchPrompt = [
+        originalWorkflowType,
+        resolverNotes,
+        escalationDescription,
+    ].filter(Boolean).join(' — ');
+    if (!searchPrompt) {
+        // No context to search — go straight to dynamic triage
+        return await (0, orchestrator_1.executeLT)({
+            workflowName: 'mcpTriage',
+            args: [envelope],
+            taskQueue: 'long-tail-system',
+        });
+    }
+    // Phase 1: Ranked discovery of compiled YAML workflows
+    const compiled = await findTriageWorkflows(searchPrompt);
+    // Phase 2: LLM-as-judge — does a compiled workflow match?
+    if (compiled.candidates.length > 0) {
+        const match = await evaluateTriageMatch(searchPrompt, compiled.candidates);
+        if (match.matched && match.workflowName) {
+            // Phase 2b: Extract structured inputs from the FULL triage context
+            // (not just the search prompt — include the actual escalation data
+            // so the LLM can map real values like content text to the schema)
+            const candidate = compiled.candidates.find((c) => c.name === match.workflowName);
+            const inputSchema = candidate?.input_schema || { type: 'object', properties: {} };
+            const extractionContext = [
+                searchPrompt,
+                escalationPayload ? `\n## Escalation Data\n${JSON.stringify(escalationPayload, null, 2)}` : '',
+                resolverPayload ? `\n## Resolver Notes\n${JSON.stringify(resolverPayload, null, 2)}` : '',
+            ].filter(Boolean).join('\n');
+            const extraction = await extractTriageInputs(extractionContext, inputSchema, match.workflowName);
+            if (extraction.extracted && extraction.inputs) {
+                // Route to mcpTriageDeterministic — compiled workflow handles this
+                return await (0, orchestrator_1.executeLT)({
+                    workflowName: 'mcpTriageDeterministic',
+                    args: [{
+                            data: {
+                                ...envelope.data,
+                                workflowName: match.workflowName,
+                                inputs: extraction.inputs,
+                                confidence: match.confidence,
+                            },
+                            metadata: envelope.metadata,
+                            lt: envelope.lt,
+                        }],
+                    taskQueue: 'long-tail-system',
+                });
+            }
+            // Input extraction failed — fall through to dynamic
+        }
+    }
+    // No compiled match — route to mcpTriage for dynamic MCP orchestration
+    return await (0, orchestrator_1.executeLT)({
+        workflowName: 'mcpTriage',
+        args: [envelope],
+        taskQueue: 'long-tail-system',
+    });
+}

package/build/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../index.ts","../vitest.config.ts","../vitest.integration.config.ts","../examples/index.ts","../examples/seed.ts","../examples/workers.ts","../examples/external-mcp-server/server.ts","../examples/types/envelopes.ts","../examples/types/index.ts","../examples/types/resolvers.ts","../examples/workflows/basic-echo/activities.ts","../examples/workflows/basic-echo/index.ts","../examples/workflows/kitchen-sink/activities.ts","../examples/workflows/kitchen-sink/index.ts","../examples/workflows/review-content/activities.ts","../examples/workflows/review-content/index.ts","../examples/workflows/review-content/types.ts","../modules/auth.ts","../modules/config.ts","../modules/defaults.ts","../modules/ltconfig.ts","../modules/maintenance.ts","../routes/auth.ts","../routes/bot-accounts.ts","../routes/controlplane.ts","../routes/dba.ts","../routes/delegation.ts","../routes/exports.ts","../routes/files.ts","../routes/index.ts","../routes/insight.ts","../routes/maintenance.ts","../routes/mcp-runs.ts","../routes/mcp.ts","../routes/namespaces.ts","../routes/oauth.ts","../routes/resolve.ts","../routes/roles.ts","../routes/settings.ts","../routes/tasks.ts","../routes/users.ts","../routes/escalations/bulk.ts","../routes/escalations/helpers.ts","../routes/escalations/index.ts","../routes/escalations/list.ts","../routes/escalations/resolve.ts","../routes/escalations/single.ts","../routes/workflows/config.ts","../routes/workflows/discovery.ts","../routes/workflows/index.ts","../routes/workflows/invocation.ts","../routes/yaml-workflows/crud.ts","../routes/yaml-workflows/deployment.ts","../routes/yaml-workflows/helpers.ts","../routes/yaml-workflows/index.ts","../routes/yaml-workflows/versions.ts","../scripts/process-helpers.ts","../scripts/process.ts","../scripts/token.ts","../services/dba.ts","../services/hotmesh-utils.ts","../services/workflow-invocation.ts","../services/auth/bot-api-key.ts","../services/auth/delegation.ts","../services/auth/service-token.ts","../services/config/cache.ts","../services/config/index.ts","../services/config/provider.ts","../services/config/read.ts","../services/config/sql.ts","../services/config/write.ts","../services/controlplane/index.ts","../services/controlplane/quorum-bridge.ts","../services/controlplane/sql.ts","../services/controlplane/types.ts","../services/cron/index.ts","../services/db/index.ts","../services/db/migrate.ts","../services/escalation/bulk.ts","../services/escalation/crud.ts","../services/escalation/index.ts","../services/escalation/queries.ts","../services/escalation/sql.ts","../services/escalation/types.ts","../services/escalation-strategy/default.ts","../services/escalation-strategy/index.ts","../services/escalation-strategy/mcp.ts","../services/events/index.ts","../services/events/memory.ts","../services/events/nats.ts","../services/events/publish.ts","../services/events/socketio.ts","../services/export/client.ts","../services/export/index.ts","../services/export/post-process.ts","../services/export/types.ts","../services/iam/activity.ts","../services/iam/bots.ts","../services/iam/context.ts","../services/iam/credentials.ts","../services/iam/envelope.ts","../services/iam/ephemeral.ts","../services/iam/index.ts","../services/iam/principal.ts","../services/iam/resolve.ts","../services/insight/index.ts","../services/insight/prompts.ts","../services/interceptor/activity-interceptor.ts","../services/interceptor/completion.ts","../services/interceptor/context.ts","../services/interceptor/escalation.ts","../services/interceptor/index.ts","../services/interceptor/lifecycle.ts","../services/interceptor/state.ts","../services/interceptor/types.ts","../services/interceptor/activities/config.ts","../services/interceptor/activities/escalation.ts","../services/interceptor/activities/index.ts","../services/interceptor/activities/task.ts","../services/interceptor/activities/workflow.ts","../services/llm/detect.ts","../services/llm/index.ts","../services/llm/translate.ts","../services/llm/types.ts","../services/llm/providers/anthropic.ts","../services/llm/providers/openai.ts","../services/logger/index.ts","../services/logger/pino.ts","../services/maintenance/index.ts","../services/mcp/adapter.ts","../services/mcp/db.ts","../services/mcp/index.ts","../services/mcp/server.ts","../services/mcp/sql.ts","../services/mcp/types.ts","../services/mcp/vision-server.ts","../services/mcp/workflow-compiler-server.ts","../services/mcp/workflow-server.ts","../services/mcp/client/connection.ts","../services/mcp/client/index.ts","../services/mcp/client/tools.ts","../services/mcp/db-server/index.ts","../services/mcp/db-server/schemas.ts","../services/mcp/db-server/tools.ts","../services/mcp/playwright-server/index.ts","../services/mcp/playwright-server/lifecycle.ts","../services/mcp/playwright-server/schemas.ts","../services/mcp/playwright-server/tools.ts","../services/mcp-runs/enrichment.ts","../services/mcp-runs/events.ts","../services/mcp-runs/execution-builder.ts","../services/mcp-runs/index.ts","../services/mcp-runs/queries.ts","../services/mcp-runs/sql.ts","../services/mcp-runs/types.ts","../services/namespace/index.ts","../services/namespace/sql.ts","../services/namespace/types.ts","../services/oauth/crypto.ts","../services/oauth/db.ts","../services/oauth/index.ts","../services/oauth/state.ts","../services/oauth/providers/anthropic.ts","../services/oauth/providers/github.ts","../services/oauth/providers/google.ts","../services/oauth/providers/index.ts","../services/oauth/providers/microsoft.ts","../services/oauth/providers/mock.ts","../services/oauth/providers/registry.ts","../services/oauth/providers/types.ts","../services/orchestrator/index.ts","../services/orchestrator/types.ts","../services/role/index.ts","../services/role/sql.ts","../services/role/types.ts","../services/storage/index.ts","../services/storage/local.ts","../services/storage/s3.ts","../services/storage/types.ts","../services/task/crud.ts","../services/task/index.ts","../services/task/process.ts","../services/task/resolve.ts","../services/task/sql.ts","../services/task/types.ts","../services/telemetry/honeycomb.ts","../services/telemetry/index.ts","../services/user/auth.ts","../services/user/crud.ts","../services/user/index.ts","../services/user/rbac.ts","../services/user/roles.ts","../services/user/sql.ts","../services/user/types.ts","../services/workers/registry.ts","../services/yaml-workflow/db-utils.ts","../services/yaml-workflow/db.ts","../services/yaml-workflow/deployer-helpers.ts","../services/yaml-workflow/deployer.ts","../services/yaml-workflow/generator.ts","../services/yaml-workflow/index.ts","../services/yaml-workflow/input-analyzer-helpers.ts","../services/yaml-workflow/input-analyzer.ts","../services/yaml-workflow/sql.ts","../services/yaml-workflow/types.ts","../services/yaml-workflow/pattern-detector/array-source.ts","../services/yaml-workflow/pattern-detector/collapse.ts","../services/yaml-workflow/pattern-detector/index.ts","../services/yaml-workflow/pattern-detector/run-detection.ts","../services/yaml-workflow/pattern-detector/types.ts","../services/yaml-workflow/pipeline/analyze.ts","../services/yaml-workflow/pipeline/extract-helpers.ts","../services/yaml-workflow/pipeline/extract.ts","../services/yaml-workflow/pipeline/prompts.ts","../services/yaml-workflow/pipeline/validate.ts","../services/yaml-workflow/pipeline/build/dag.ts","../services/yaml-workflow/pipeline/build/index.ts","../services/yaml-workflow/pipeline/build/iteration.ts","../services/yaml-workflow/pipeline/build/metadata.ts","../services/yaml-workflow/pipeline/build/transform.ts","../services/yaml-workflow/pipeline/build/utils.ts","../services/yaml-workflow/pipeline/build/wiring.ts","../services/yaml-workflow/pipeline/compile/index.ts","../services/yaml-workflow/pipeline/compile/llm-call.ts","../services/yaml-workflow/pipeline/compile/parse-plan.ts","../services/yaml-workflow/pipeline/compile/summarize.ts","../services/yaml-workflow/workers/callbacks.ts","../services/yaml-workflow/workers/events.ts","../services/yaml-workflow/workers/index.ts","../services/yaml-workflow/workers/register.ts","../services/yaml-workflow/workers/scope.ts","../start/adapters.ts","../start/config.ts","../start/index.ts","../start/server.ts","../start/workers.ts","../system/index.ts","../system/activities/claude-code.ts","../system/activities/file-storage.ts","../system/activities/http.ts","../system/activities/oauth.ts","../system/activities/triage/cache.ts","../system/activities/triage/context.ts","../system/activities/triage/discovery.ts","../system/activities/triage/index.ts","../system/activities/triage/llm.ts","../system/activities/triage/tools.ts","../system/mcp-servers/claude-code.ts","../system/mcp-servers/document-vision.ts","../system/mcp-servers/file-storage.ts","../system/mcp-servers/http-fetch.ts","../system/mcp-servers/human-queue.ts","../system/mcp-servers/oauth.ts","../system/mcp-servers/prompts.ts","../system/mcp-servers/workflow-compiler.ts","../system/mcp-servers/workflow.ts","../system/mcp-servers/db-query/index.ts","../system/mcp-servers/db-query/schemas.ts","../system/mcp-servers/db-query/tools.ts","../system/mcp-servers/playwright/browser-lifecycle.ts","../system/mcp-servers/playwright/index.ts","../system/mcp-servers/playwright/schemas.ts","../system/mcp-servers/playwright/tools-atomic.ts","../system/mcp-servers/playwright/tools-navigation.ts","../system/mcp-servers/playwright/tools-page-interaction.ts","../system/mcp-servers/playwright/tools-run-script.ts","../system/mcp-servers/playwright/types.ts","../system/mcp-servers/playwright-cli/helpers.ts","../system/mcp-servers/playwright-cli/index.ts","../system/mcp-servers/playwright-cli/schemas.ts","../system/mcp-servers/playwright-cli/tools-auth.ts","../system/mcp-servers/playwright-cli/tools-capture.ts","../system/seed/index.ts","../system/seed/server-definitions.ts","../system/seed/tool-manifests-browser.ts","../system/seed/tool-manifests-data.ts","../system/seed/tool-manifests-escalation.ts","../system/seed/tool-manifests-workflows.ts","../system/workflows/mcp-deterministic/activities.ts","../system/workflows/mcp-deterministic/index.ts","../system/workflows/mcp-query/index.ts","../system/workflows/mcp-query/prompts.ts","../system/workflows/mcp-query/strategy-advisors.ts","../system/workflows/mcp-query/types.ts","../system/workflows/mcp-query/activities/caches.ts","../system/workflows/mcp-query/activities/discovery.ts","../system/workflows/mcp-query/activities/index.ts","../system/workflows/mcp-query/activities/llm.ts","../system/workflows/mcp-query/activities/tool-executor.ts","../system/workflows/mcp-query/activities/tool-loader.ts","../system/workflows/mcp-query-router/activities.ts","../system/workflows/mcp-query-router/index.ts","../system/workflows/mcp-query-router/prompts.ts","../system/workflows/mcp-triage/index.ts","../system/workflows/mcp-triage/prompts.ts","../system/workflows/mcp-triage/response-builders.ts","../system/workflows/mcp-triage/response.ts","../system/workflows/mcp-triage/types.ts","../system/workflows/mcp-triage-deterministic/activities.ts","../system/workflows/mcp-triage-deterministic/index.ts","../system/workflows/mcp-triage-router/activities.ts","../system/workflows/mcp-triage-router/index.ts","../types/auth.ts","../types/config.ts","../types/delegation.ts","../types/discovery.ts","../types/envelope.ts","../types/escalation-strategy.ts","../types/escalation.ts","../types/events.ts","../types/export.ts","../types/express.d.ts","../types/index.ts","../types/logger.ts","../types/maintenance.ts","../types/mcp.ts","../types/oauth.ts","../types/startup.ts","../types/task.ts","../types/telemetry.ts","../types/tool-context.ts","../types/user.ts","../types/workflow.ts","../types/yaml-workflow.ts","../workers/index.ts"],"version":"5.9.3"}

package/build/types/auth.d.ts

@@ -0,0 +1,34 @@
+import type { Request } from 'express';
+/**
+ * The identity payload extracted from an authenticated request.
+ * All auth adapters must return this shape.
+ */
+export interface AuthPayload {
+    userId: string;
+    role?: string;
+    [key: string]: any;
+}
+/**
+ * Pluggable authentication adapter interface.
+ *
+ * Implement this to integrate your own auth provider (Clerk, Auth0, jose, etc.)
+ * with Long Tail's middleware. The adapter extracts identity from the request;
+ * the middleware handles 401 responses and `userId` validation.
+ *
+ * Usage:
+ * ```typescript
+ * import { createAuthMiddleware, LTAuthAdapter, AuthPayload } from '@hotmeshio/long-tail';
+ *
+ * class MyAuthAdapter implements LTAuthAdapter {
+ *   async authenticate(req: Request): Promise<AuthPayload | null> {
+ *     // your verification logic
+ *     return { userId: 'user-1', role: 'admin' };
+ *   }
+ * }
+ *
+ * const authMiddleware = createAuthMiddleware(new MyAuthAdapter());
+ * ```
+ */
+export interface LTAuthAdapter {
+    authenticate(req: Request): Promise<AuthPayload | null> | (AuthPayload | null);
+}

package/build/types/auth.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/types/config.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Full workflow configuration as stored in the database.
+ * Includes all sub-entities (roles, consumers).
+ */
+export interface LTWorkflowConfig {
+    workflow_type: string;
+    invocable: boolean;
+    task_queue: string | null;
+    default_role: string;
+    description: string | null;
+    roles: string[];
+    invocation_roles: string[];
+    consumes: string[];
+    tool_tags?: string[];
+    envelope_schema?: Record<string, any> | null;
+    resolver_schema?: Record<string, any> | null;
+    cron_schedule?: string | null;
+    /** Bot external_id to run as. When set, workflows use this bot's identity. */
+    execute_as?: string | null;
+}
+/**
+ * Resolved config used by interceptor/executeLT at runtime.
+ * Flat structure with camelCase keys — no DB row noise.
+ */
+export interface LTResolvedConfig {
+    invocable: boolean;
+    taskQueue: string | null;
+    role: string;
+    roles: string[];
+    invocationRoles: string[];
+    consumes: string[];
+    toolTags: string[];
+    envelopeSchema: Record<string, any> | null;
+    resolverSchema: Record<string, any> | null;
+    cronSchedule: string | null;
+    executeAs: string | null;
+}
+/**
+ * Provider data returned by ltGetProviderData.
+ * Keyed by workflow type name from the `consumes` array.
+ */
+export interface LTProviderData {
+    [providerName: string]: {
+        data: Record<string, any>;
+        completedAt: string;
+        workflowType: string;
+    };
+}

package/build/types/config.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/types/delegation.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Delegation token payload — a scoped, short-lived JWT authorizing
+ * an MCP tool to act on behalf of a user.
+ */
+export interface DelegationTokenPayload {
+    /** Token type discriminator (distinguishes from user session JWTs). */
+    type: 'delegation';
+    /** User ID (JWT `sub` claim). */
+    sub: string;
+    /** Allowed scopes (e.g. ['oauth:google:read', 'files:read']). */
+    scopes: string[];
+    /** Workflow that created this token (for audit). */
+    workflowId?: string;
+    /** Target MCP server this token is scoped to. */
+    serverId?: string;
+    /** Standard JWT claims (set by sign). */
+    iss?: string;
+    iat?: number;
+    exp?: number;
+}
+/**
+ * Auth context passed to MCP tool invocations.
+ * Injected as `_auth` in tool args.
+ */
+export interface ToolAuthContext {
+    userId?: string;
+    delegationToken?: string;
+}
+/**
+ * Service token database record.
+ */
+export interface ServiceTokenRecord {
+    id: string;
+    name: string;
+    server_id: string | null;
+    scopes: string[];
+    expires_at: Date | null;
+    last_used_at: Date | null;
+    created_at: Date;
+    updated_at: Date;
+}

package/build/types/delegation.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/types/discovery.d.ts

@@ -0,0 +1,12 @@
+/** Shared types for workflow discovery (used by both mcpQuery and mcpTriage pipelines). */
+/** Candidate workflow returned by ranked FTS + tag discovery. */
+export interface WorkflowCandidate {
+    name: string;
+    description: string | null;
+    original_prompt: string | null;
+    category: string | null;
+    tags: string[];
+    input_schema: Record<string, unknown>;
+    tool_names: string[];
+    fts_rank: number;
+}