@hotmeshio/long-tail 0.1.15 → 0.1.17

package/build/examples/workers.js

@@ -1,59 +0,0 @@
-"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.exampleWorkers = void 0;
-const reviewContentWorkflow = __importStar(require("./workflows/review-content"));
-const kitchenSinkWorkflow = __importStar(require("./workflows/kitchen-sink"));
-const basicEchoWorkflow = __importStar(require("./workflows/basic-echo"));
-const assemblyLineWorkflow = __importStar(require("./workflows/assembly-line"));
-const workstationWorkflow = __importStar(require("./workflows/assembly-line/worker"));
-const stepIteratorWorkflow = __importStar(require("./workflows/assembly-line/iterator"));
-const reverterWorkflow = __importStar(require("./workflows/assembly-line/reverter"));
-const basicSignalWorkflow = __importStar(require("./workflows/basic-signal"));
-/**
- * Example workers that ship with Long Tail.
- * Pass these to `start({ workers: [...exampleWorkers] })` or enable
- * via `examples: true` in the start config.
- */
-exports.exampleWorkers = [
-    { taskQueue: 'long-tail-examples', workflow: reviewContentWorkflow.reviewContent },
-    { taskQueue: 'long-tail-examples', workflow: kitchenSinkWorkflow.kitchenSink },
-    { taskQueue: 'long-tail-examples', workflow: basicEchoWorkflow.basicEcho },
-    { taskQueue: 'long-tail-examples', workflow: assemblyLineWorkflow.assemblyLine },
-    { taskQueue: 'long-tail-examples', workflow: workstationWorkflow.workstation },
-    { taskQueue: 'long-tail-examples', workflow: stepIteratorWorkflow.stepIterator },
-    { taskQueue: 'long-tail-examples', workflow: reverterWorkflow.reverter },
-    { taskQueue: 'long-tail-examples', workflow: basicSignalWorkflow.basicSignal },
-];

package/build/examples/workflows/assembly-line/activities.d.ts

@@ -1,28 +0,0 @@
-/**
- * Assembly Line Activities
- *
- * Side-effect functions that run outside the deterministic workflow
- * sandbox. Each is wrapped via proxyActivities so results are
- * checkpointed and replayed on restart.
- *
- * Two responsibilities:
- *   1. Create an escalation with signal routing so the resolve API
- *      can wake the paused child workflow.
- *   2. Signal the parent orchestrator when the child completes.
- */
-export declare function createStationEscalation(input: {
-    role: string;
-    stationName: string;
-    instructions: string;
-    workflowId: string;
-    workflowType: string;
-    taskQueue: string;
-    signalId: string;
-}): Promise<string>;
-export declare function signalParent(input: {
-    parentTaskQueue: string;
-    parentWorkflowType: string;
-    parentWorkflowId: string;
-    signalId: string;
-    data: any;
-}): Promise<void>;

package/build/examples/workflows/assembly-line/activities.js

@@ -1,53 +0,0 @@
-"use strict";
-/**
- * Assembly Line Activities
- *
- * Side-effect functions that run outside the deterministic workflow
- * sandbox. Each is wrapped via proxyActivities so results are
- * checkpointed and replayed on restart.
- *
- * Two responsibilities:
- *   1. Create an escalation with signal routing so the resolve API
- *      can wake the paused child workflow.
- *   2. Signal the parent orchestrator when the child completes.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createStationEscalation = createStationEscalation;
-exports.signalParent = signalParent;
-const hotmesh_1 = require("@hotmeshio/hotmesh");
-const db_1 = require("../../../lib/db");
-const escalation_1 = require("../../../services/escalation");
-// ── Create station escalation ──────────────────────────────────────
-async function createStationEscalation(input) {
-    const escalation = await (0, escalation_1.createEscalation)({
-        type: 'assemblyLine',
-        subtype: input.stationName,
-        description: input.instructions,
-        priority: 2,
-        role: input.role,
-        envelope: JSON.stringify({ station: input.stationName }),
-        workflow_id: input.workflowId,
-        task_queue: input.taskQueue,
-        workflow_type: input.workflowType,
-    });
-    await (0, escalation_1.enrichEscalationRouting)(escalation.id, {
-        signal_routing: {
-            engine: 'durable',
-            taskQueue: input.taskQueue,
-            workflowType: input.workflowType,
-            workflowId: input.workflowId,
-            signalId: input.signalId,
-        },
-    }, {
-        workflowType: input.workflowType,
-        workflowId: input.workflowId,
-        taskQueue: input.taskQueue,
-    });
-    return escalation.id;
-}
-// ── Signal parent orchestrator ─────────────────────────────────────
-async function signalParent(input) {
-    const client = new hotmesh_1.Durable.Client({ connection: (0, db_1.getConnection)() });
-    const handle = await client.workflow.getHandle(input.parentTaskQueue, input.parentWorkflowType, input.parentWorkflowId);
-    await handle.signal(input.signalId, input.data);
-}

package/build/examples/workflows/assembly-line/index.d.ts

@@ -1,17 +0,0 @@
-/**
- * Assembly Line — durable orchestrator with human task queues.
- *
- * Demonstrates the core composition pattern without the LT interceptor:
- *   startChild  → spawn a child workflow (fire-and-forget)
- *   condition   → pause until the child signals back
- *   signal      → child wakes the parent when done
- *
- * A product moves through sequential workstations. Each station
- * creates an escalation for a human operator, pauses, then signals
- * the parent when the human resolves it.
- *
- * No registration, no certification, no interceptor — just Durable
- * primitives and the escalation table.
- */
-import type { LTEnvelope } from '../../../types';
-export declare function assemblyLine(envelope: LTEnvelope): Promise<any>;

package/build/examples/workflows/assembly-line/index.js

@@ -1,60 +0,0 @@
-"use strict";
-/**
- * Assembly Line — durable orchestrator with human task queues.
- *
- * Demonstrates the core composition pattern without the LT interceptor:
- *   startChild  → spawn a child workflow (fire-and-forget)
- *   condition   → pause until the child signals back
- *   signal      → child wakes the parent when done
- *
- * A product moves through sequential workstations. Each station
- * creates an escalation for a human operator, pauses, then signals
- * the parent when the human resolves it.
- *
- * No registration, no certification, no interceptor — just Durable
- * primitives and the escalation table.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.assemblyLine = assemblyLine;
-const hotmesh_1 = require("@hotmeshio/hotmesh");
-const defaults_1 = require("../../../modules/defaults");
-async function assemblyLine(envelope) {
-    const { productName, stations } = envelope.data;
-    const ctx = hotmesh_1.Durable.workflow.workflowInfo();
-    const results = [];
-    for (const [i, station] of stations.entries()) {
-        const signalId = `station-${i}-${ctx.workflowId}`;
-        const childWorkflowId = `workstation-${ctx.workflowId}-${i}`;
-        // Spawn child — fire-and-forget; only the start is awaited
-        await hotmesh_1.Durable.workflow.startChild({
-            workflowName: 'workstation',
-            args: [
-                {
-                    data: {
-                        ...station,
-                        parentSignalId: signalId,
-                        parentTaskQueue: 'long-tail-examples',
-                        parentWorkflowType: 'assemblyLine',
-                        parentWorkflowId: ctx.workflowId,
-                    },
-                    metadata: { source: 'assembly-line', station: station.stationName },
-                },
-            ],
-            taskQueue: 'long-tail-examples',
-            workflowId: childWorkflowId,
-            expire: defaults_1.JOB_EXPIRE_SECS,
-            entity: 'workstation',
-        });
-        // Pause until the child signals back with its result
-        const result = await hotmesh_1.Durable.workflow.condition(signalId);
-        results.push(result);
-    }
-    return {
-        type: 'return',
-        data: {
-            productName,
-            stations: results,
-            completedAt: new Date().toISOString(),
-        },
-    };
-}

package/build/examples/workflows/assembly-line/iterator.d.ts

@@ -1,12 +0,0 @@
-/**
- * Step Iterator — generic durable loop over dynamic steps.
- *
- * Proves that the number and shape of steps can be entirely
- * data-driven. The orchestrator knows nothing about grinder,
- * gluer, or any specific station — it just walks the list,
- * spawns a child for each, and waits for the signal.
- *
- * Reuses the same `workstation` child workflow as the assembly line.
- */
-import type { LTEnvelope } from '../../../types';
-export declare function stepIterator(envelope: LTEnvelope): Promise<any>;

package/build/examples/workflows/assembly-line/iterator.js

@@ -1,54 +0,0 @@
-"use strict";
-/**
- * Step Iterator — generic durable loop over dynamic steps.
- *
- * Proves that the number and shape of steps can be entirely
- * data-driven. The orchestrator knows nothing about grinder,
- * gluer, or any specific station — it just walks the list,
- * spawns a child for each, and waits for the signal.
- *
- * Reuses the same `workstation` child workflow as the assembly line.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.stepIterator = stepIterator;
-const hotmesh_1 = require("@hotmeshio/hotmesh");
-const defaults_1 = require("../../../modules/defaults");
-async function stepIterator(envelope) {
-    const { name, steps } = envelope.data;
-    const ctx = hotmesh_1.Durable.workflow.workflowInfo();
-    const results = [];
-    for (const [i, step] of steps.entries()) {
-        const signalId = `step-${i}-${ctx.workflowId}`;
-        const childWorkflowId = `workstation-${ctx.workflowId}-${i}`;
-        await hotmesh_1.Durable.workflow.startChild({
-            workflowName: 'workstation',
-            args: [
-                {
-                    data: {
-                        ...step,
-                        parentSignalId: signalId,
-                        parentTaskQueue: 'long-tail-examples',
-                        parentWorkflowType: 'stepIterator',
-                        parentWorkflowId: ctx.workflowId,
-                    },
-                    metadata: { source: 'step-iterator', step: i },
-                },
-            ],
-            taskQueue: 'long-tail-examples',
-            workflowId: childWorkflowId,
-            expire: defaults_1.JOB_EXPIRE_SECS,
-            entity: 'workstation',
-        });
-        const result = await hotmesh_1.Durable.workflow.condition(signalId);
-        results.push(result);
-    }
-    return {
-        type: 'return',
-        data: {
-            name,
-            totalSteps: steps.length,
-            steps: results,
-            completedAt: new Date().toISOString(),
-        },
-    };
-}

package/build/examples/workflows/assembly-line/reverter.d.ts

@@ -1,18 +0,0 @@
-/**
- * Reverter — durable step loop with revert support.
- *
- * Like stepIterator, but each human resolution can send the
- * pipeline backwards. The resolver payload controls flow:
- *
- *   { approved: true }              → advance to next step
- *   { approved: false, revertSteps: 1 }  → go back 1 step
- *   { approved: false, revertSteps: 2 }  → go back 2 steps
- *
- * The orchestrator tracks a monotonic attempt counter so every
- * child spawn gets a unique workflow ID and signal key — even
- * when revisiting a step after a revert.
- *
- * The full history (approvals + reverts) is recorded in the result.
- */
-import type { LTEnvelope } from '../../../types';
-export declare function reverter(envelope: LTEnvelope): Promise<any>;

package/build/examples/workflows/assembly-line/reverter.js

@@ -1,89 +0,0 @@
-"use strict";
-/**
- * Reverter — durable step loop with revert support.
- *
- * Like stepIterator, but each human resolution can send the
- * pipeline backwards. The resolver payload controls flow:
- *
- *   { approved: true }              → advance to next step
- *   { approved: false, revertSteps: 1 }  → go back 1 step
- *   { approved: false, revertSteps: 2 }  → go back 2 steps
- *
- * The orchestrator tracks a monotonic attempt counter so every
- * child spawn gets a unique workflow ID and signal key — even
- * when revisiting a step after a revert.
- *
- * The full history (approvals + reverts) is recorded in the result.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.reverter = reverter;
-const hotmesh_1 = require("@hotmeshio/hotmesh");
-const defaults_1 = require("../../../modules/defaults");
-async function reverter(envelope) {
-    const { name, steps } = envelope.data;
-    const ctx = hotmesh_1.Durable.workflow.workflowInfo();
-    const history = [];
-    const finalResults = [];
-    let stepIndex = 0;
-    let attempt = 0;
-    while (stepIndex < steps.length) {
-        const step = steps[stepIndex];
-        const signalId = `step-${stepIndex}-a${attempt}-${ctx.workflowId}`;
-        const childWorkflowId = `workstation-${ctx.workflowId}-${stepIndex}-a${attempt}`;
-        await hotmesh_1.Durable.workflow.startChild({
-            workflowName: 'workstation',
-            args: [
-                {
-                    data: {
-                        ...step,
-                        parentSignalId: signalId,
-                        parentTaskQueue: 'long-tail-examples',
-                        parentWorkflowType: 'reverter',
-                        parentWorkflowId: ctx.workflowId,
-                    },
-                    metadata: {
-                        source: 'reverter',
-                        step: stepIndex,
-                        attempt,
-                        totalSteps: steps.length,
-                    },
-                },
-            ],
-            taskQueue: 'long-tail-examples',
-            workflowId: childWorkflowId,
-            expire: defaults_1.JOB_EXPIRE_SECS,
-            entity: 'workstation',
-        });
-        const result = await hotmesh_1.Durable.workflow.condition(signalId);
-        const approved = result.resolution?.approved !== false;
-        const revertSteps = Number(result.resolution?.revertSteps) || 0;
-        history.push({
-            type: approved ? 'advance' : 'revert',
-            stepIndex,
-            stationName: step.stationName,
-            attempt,
-            resolution: result.resolution,
-            completedAt: result.completedAt,
-        });
-        attempt++;
-        if (approved) {
-            finalResults[stepIndex] = result;
-            stepIndex++;
-        }
-        else {
-            // Clamp revert target to 0
-            stepIndex = Math.max(0, stepIndex - revertSteps);
-        }
-    }
-    return {
-        type: 'return',
-        data: {
-            name,
-            totalSteps: steps.length,
-            totalAttempts: attempt,
-            steps: finalResults,
-            history,
-            completedAt: new Date().toISOString(),
-        },
-    };
-}

package/build/examples/workflows/assembly-line/types.d.ts

@@ -1,25 +0,0 @@
-/**
- * Assembly Line types.
- *
- * Defines the station config passed in the envelope and the
- * result shape each station returns when a human resolves it.
- */
-export interface AssemblyLineStation {
-    stationName: string;
-    role: string;
-    instructions: string;
-}
-export interface StationEnvelopeData {
-    stationName: string;
-    role: string;
-    instructions: string;
-    parentSignalId: string;
-    parentTaskQueue: string;
-    parentWorkflowType: string;
-    parentWorkflowId: string;
-}
-export interface StationResult {
-    stationName: string;
-    resolution: Record<string, any>;
-    completedAt: string;
-}

package/build/examples/workflows/assembly-line/types.js

@@ -1,8 +0,0 @@
-"use strict";
-/**
- * Assembly Line types.
- *
- * Defines the station config passed in the envelope and the
- * result shape each station returns when a human resolves it.
- */
-Object.defineProperty(exports, "__esModule", { value: true });

package/build/examples/workflows/assembly-line/worker.d.ts

@@ -1,13 +0,0 @@
-/**
- * Workstation — child workflow for the assembly line.
- *
- * Each workstation:
- *   1. Creates an escalation assigned to its role (grinder, gluer, etc.)
- *   2. Pauses (condition) until a human claims and resolves the escalation
- *   3. Signals the parent orchestrator with the result
- *
- * No interceptor, no registration — just raw Durable primitives
- * and a direct escalation record with signal routing metadata.
- */
-import type { LTEnvelope } from '../../../types';
-export declare function workstation(envelope: LTEnvelope): Promise<any>;

package/build/examples/workflows/assembly-line/worker.js

@@ -1,81 +0,0 @@
-"use strict";
-/**
- * Workstation — child workflow for the assembly line.
- *
- * Each workstation:
- *   1. Creates an escalation assigned to its role (grinder, gluer, etc.)
- *   2. Pauses (condition) until a human claims and resolves the escalation
- *   3. Signals the parent orchestrator with the result
- *
- * No interceptor, no registration — just raw Durable primitives
- * and a direct escalation record with signal routing metadata.
- */
-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.workstation = workstation;
-const hotmesh_1 = require("@hotmeshio/hotmesh");
-const activities = __importStar(require("./activities"));
-const { createStationEscalation, signalParent } = hotmesh_1.Durable.workflow.proxyActivities({ activities });
-async function workstation(envelope) {
-    const { stationName, role, instructions, parentSignalId, parentTaskQueue, parentWorkflowType, parentWorkflowId, } = envelope.data;
-    const ctx = hotmesh_1.Durable.workflow.workflowInfo();
-    const localSignalId = `station-done-${ctx.workflowId}`;
-    // 1. Create escalation — human sees this in their queue
-    await createStationEscalation({
-        role,
-        stationName,
-        instructions,
-        workflowId: ctx.workflowId,
-        workflowType: 'workstation',
-        taskQueue: 'long-tail-examples',
-        signalId: localSignalId,
-    });
-    // 2. Pause until the human resolves the escalation
-    const resolution = await hotmesh_1.Durable.workflow.condition(localSignalId);
-    // 3. Build result and signal the parent orchestrator
-    const result = {
-        stationName,
-        resolution,
-        completedAt: new Date().toISOString(),
-    };
-    await signalParent({
-        parentTaskQueue,
-        parentWorkflowType,
-        parentWorkflowId,
-        signalId: parentSignalId,
-        data: result,
-    });
-    return { type: 'return', data: result };
-}

package/build/examples/workflows/basic-echo/activities.d.ts

@@ -1,20 +0,0 @@
-/**
- * Basic Echo Activities
- *
- * Single activity that echoes a message back with IAM context.
- * Demonstrates three ways to access identity inside a proxy activity:
- *
- * 1. `getActivityIdentity()` — recommended: one-call access to principal + credential exchange
- * 2. `getToolContext()` — lower-level access to ToolContext (principal, scopes, trace)
- * 3. `Durable.activity.getContext()` — raw HotMesh API for headers
- *
- * All work across process boundaries because headers travels
- * with the activity call via HotMesh's schema pipeline.
- */
-export declare function echo(input: {
-    message: string;
-}): Promise<{
-    message: string;
-    echoedAt: string;
-    identity: Record<string, unknown>;
-}>;

package/build/examples/workflows/basic-echo/activities.js

@@ -1,55 +0,0 @@
-"use strict";
-/**
- * Basic Echo Activities
- *
- * Single activity that echoes a message back with IAM context.
- * Demonstrates three ways to access identity inside a proxy activity:
- *
- * 1. `getActivityIdentity()` — recommended: one-call access to principal + credential exchange
- * 2. `getToolContext()` — lower-level access to ToolContext (principal, scopes, trace)
- * 3. `Durable.activity.getContext()` — raw HotMesh API for headers
- *
- * All work across process boundaries because headers travels
- * with the activity call via HotMesh's schema pipeline.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.echo = echo;
-const hotmesh_1 = require("@hotmeshio/hotmesh");
-const context_1 = require("../../../services/iam/context");
-async function echo(input) {
-    // Recommended: getActivityIdentity() — principal + getCredential() in one call
-    // const identity = getActivityIdentity();
-    // const token = await identity.getCredential('anthropic'); // credential exchange
-    // Primary: getToolContext() reads from headers (injected by activity interceptor)
-    const ctx = (0, context_1.getToolContext)();
-    // Direct access: Durable.activity.getContext() shows the raw headers
-    const activityCtx = hotmesh_1.Durable.activity.getContext();
-    const rawPrincipal = activityCtx?.headers?.principal;
-    const identity = ctx
-        ? {
-            source: 'getActivityIdentity',
-            principal: {
-                id: ctx.principal.id,
-                type: ctx.principal.type,
-                displayName: ctx.principal.displayName,
-                roles: ctx.principal.roles,
-                roleType: ctx.principal.roleType,
-            },
-            scopes: ctx.credentials.scopes,
-            note: 'Also available via getActivityIdentity().getCredential(provider) for token exchange',
-        }
-        : rawPrincipal
-            ? {
-                source: 'headers',
-                principal: rawPrincipal,
-            }
-            : {
-                source: 'unavailable',
-                note: 'no principal in envelope or headers',
-            };
-    return {
-        message: input.message,
-        echoedAt: new Date().toISOString(),
-        identity,
-    };
-}

package/build/examples/workflows/basic-echo/index.d.ts

@@ -1,14 +0,0 @@
-/**
- * Basic Echo Workflow
- *
- * Minimal durable workflow that:
- *   1. Sleeps for a configurable duration (durable timer)
- *   2. Echoes the input message back with IAM identity context
- *
- * Use this to verify:
- *   - Durable workflow invocation from the dashboard
- *   - IAM context availability (registered vs unregistered)
- *   - Cron scheduling for plain durable workers
- */
-import type { LTEnvelope } from '../../../types';
-export declare function basicEcho(envelope: LTEnvelope): Promise<any>;