@corgelabs/corge 0.0.1 → 1.0.1

package/dist/tasks/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/tasks/routes.ts"],"names":[],"mappings":"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"}

package/dist/tasks/schema.d.ts

@@ -0,0 +1,261 @@
+import type { DocumentReference } from 'firebase-admin/firestore';
+import { z } from 'zod';
+import type { AppBindings, DbRole } from '../config';
+import type { EntryId } from '../db';
+import type { AuthLevel, BaseRouteConfig, RouteMode } from '../router';
+import { StaleWorkerEpochError, type Duration } from '../utils';
+export { StaleWorkerEpochError };
+export type TaskStatus = 'running' | 'sleeping' | 'waiting_signal' | 'compensating' | 'completed' | 'errored' | 'cancelled';
+export interface TaskExecutionFence {
+    /** Monotonically increasing integer incremented on every worker claim, yield, hedge, or cancel transition */
+    epoch: number;
+    /** Unique UUID for the currently owning worker execution attempt */
+    activeRunId: string | null;
+    /** Timestamp of the latest worker heartbeat */
+    lastHeartbeatAt: number;
+}
+export interface TaskProgressUpdate {
+    percent?: number;
+    stage?: string;
+    message?: string;
+    data?: Record<string, unknown>;
+}
+export interface TaskStatusRecord<O = unknown> {
+    taskId: string;
+    workflowName: string;
+    status: TaskStatus;
+    userId?: EntryId;
+    epoch?: number;
+    activeRunId?: string | null;
+    lastHeartbeatAt?: number;
+    compensatedSteps?: Record<string, boolean>;
+    progress?: TaskProgressUpdate;
+    response?: O;
+    error?: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface WorkflowContext {
+    taskId: string;
+    workflowName: string;
+    attempt: number;
+    startedAt: number;
+    deadlineMs: number;
+    signal: AbortSignal;
+}
+export interface StepRetryPolicy {
+    maxAttempts?: number;
+    initialInterval?: Duration;
+    backoffCoefficient?: number;
+    maxInterval?: Duration;
+    jitter?: boolean;
+    nonRetryableErrorTypes?: string[];
+}
+export interface StepContext {
+    signal: AbortSignal;
+    attempt: number;
+    stepId: string;
+}
+export interface StepOptions<T = unknown> {
+    retry?: number | StepRetryPolicy;
+    timeout?: Duration;
+    rollback?: (result: T) => Promise<unknown>;
+}
+export interface StepMapOptions<T, R> extends StepOptions<R> {
+    concurrency?: number;
+    shortCircuit?: (item: T, index: number) => Promise<R | undefined> | R | undefined;
+}
+export type StepSpec<T> = ((ctx: StepContext) => Promise<T>) | {
+    fn: (ctx: StepContext) => Promise<T>;
+    rollback?: (result: T) => Promise<unknown>;
+    retry?: number | StepRetryPolicy;
+    timeout?: Duration;
+};
+export type StepFn = <T>(name: string, fnOrSpec: StepSpec<T>, options?: StepOptions<T>) => Promise<T>;
+export interface WorkflowTargetRef<I = any, O = any> {
+    workflowName?: string;
+    timeout?: Duration;
+    handler?: (ctx: any) => Promise<O>;
+    __input?: I;
+}
+export interface StepRunner extends StepFn {
+    run: StepFn;
+    map: <T, R>(name: string, items: readonly T[], fn: (item: T, index: number, ctx: StepContext) => Promise<R>, options?: StepMapOptions<T, R>) => Promise<R[]>;
+    invoke: <I = unknown, O = unknown>(name: string, target: string | WorkflowTargetRef<I, O>, input: I, options?: {
+        timeout?: Duration;
+        dedupeKey?: string;
+    }) => Promise<O>;
+    spawn: <I = unknown>(name: string, target: string | WorkflowTargetRef<I, unknown>, input: I, options?: {
+        dedupeKey?: string;
+        timeout?: Duration;
+    }) => Promise<{
+        taskId: string;
+    }>;
+    sleep: (name: string, duration: Duration) => Promise<void>;
+    waitForSignal: <T = unknown>(name: string, signalName: string, options?: {
+        timeout?: Duration;
+    }) => Promise<T>;
+    continueAsNew: <I = unknown>(newInput: I) => Promise<never>;
+    progress: (update: TaskProgressUpdate) => Promise<void>;
+    flush: () => Promise<PromiseSettledResult<unknown>[]>;
+    compensate: () => Promise<void>;
+    onError: () => Promise<void>;
+}
+export interface RollbackLeg<T> {
+    fn: () => Promise<T>;
+    rollback?: (result: T) => Promise<unknown>;
+}
+export interface WorkflowTaskPayload {
+    taskId: string;
+    workflowName: string;
+    params: Record<string, unknown>;
+    isDev: boolean;
+    expectedEpoch?: number;
+}
+export interface WorkflowRuntimeEntry {
+    mode: RouteMode;
+    deadlineSeconds?: number;
+    runTask: (params: any, step: StepRunner) => Promise<unknown>;
+}
+export declare class TaskYieldSignal extends Error {
+    readonly reason: 'sleeping' | 'waiting_signal' | 'continue_as_new' | 'yield';
+    readonly meta: {
+        delaySeconds?: number;
+        signalName?: string;
+        timeoutMs?: number;
+        newInput?: unknown;
+    };
+    readonly isTaskYield = true;
+    constructor(reason: 'sleeping' | 'waiting_signal' | 'continue_as_new' | 'yield', meta?: {
+        delaySeconds?: number;
+        signalName?: string;
+        timeoutMs?: number;
+        newInput?: unknown;
+    });
+}
+export interface ClaimCheckPointer {
+    __claimCheck: string;
+}
+export declare class ReplayCompleteSignal extends Error {
+    readonly isReplayComplete: true;
+    constructor();
+}
+export interface ActiveTaskExecution {
+    taskId: string;
+    step: StepRunner;
+    controller: AbortController;
+    claimedEpoch?: number;
+}
+export interface ActiveWorkflowStore {
+    workflow: WorkflowContext;
+    step: StepRunner;
+    env?: AppBindings;
+}
+export interface CreateStepRunnerOptions {
+    isDev?: boolean;
+    signals?: Record<string, unknown>;
+    workflowContext?: WorkflowContext;
+    canYield?: boolean;
+    claimedEpoch?: number;
+    abortController?: AbortController;
+    compensatedSteps?: Record<string, boolean>;
+    replayOnly?: boolean;
+}
+export interface DispatchWorkflowOptions {
+    mode?: RouteMode;
+    timeout?: Duration;
+    dedupeKey?: string;
+    wait?: boolean;
+    maxWaitMs?: number;
+    signal?: AbortSignal;
+    userId?: EntryId;
+    userRole?: DbRole;
+}
+export interface ExecuteWorkflowTaskOptions {
+    canYield?: boolean;
+}
+export type TaskRecord<O = unknown> = {
+    status: 'completed';
+    response: O;
+} | {
+    status: 'errored';
+    error: string;
+    errorCode?: string;
+    nonRetryable?: boolean;
+} | {
+    status: 'cancelled';
+    error?: string;
+};
+export declare class TaskWaitDetachedSignal extends Error {
+    readonly taskId: string;
+    readonly isTaskWaitDetached: true;
+    constructor(taskId: string);
+}
+export interface PendingEntry {
+    taskId: string;
+    workflowName: string;
+    docRef: DocumentReference;
+    createdAt: number;
+    hedged: boolean;
+    hedgeable?: boolean;
+    keepAlive?: boolean;
+    unsub?: () => void;
+    dispatch: () => Promise<void>;
+    finish: (res: TaskRecord<any>) => void;
+}
+export interface WatchTaskOptions {
+    isDev?: boolean;
+    docRef?: DocumentReference;
+    workflowName?: string;
+    hedgeable?: boolean;
+    keepAlive?: boolean;
+    timeoutMs?: number;
+    maxWaitMs?: number;
+    hedgeAfterMs?: number;
+    pollIntervalMs?: number;
+    signal?: AbortSignal;
+    dispatch?: () => Promise<void>;
+}
+export interface RouteRegistryItem {
+    id: string;
+    mode: RouteMode;
+    method: string;
+    path: string;
+    workflowName?: string;
+    auth?: AuthLevel;
+    description: string;
+    mcp?: boolean;
+    tool?: boolean;
+    input?: z.ZodType<any>;
+    output?: z.ZodType<any>;
+    guard?: BaseRouteConfig['guard'];
+}
+export interface RouteIntrospectionItem {
+    id: string;
+    method: string;
+    path: string;
+    mode: 'rest' | 'workflow';
+    workflowName?: string;
+    auth: string | false;
+    description: string;
+    mcp: boolean;
+    tool: boolean;
+    guards: string[];
+    inputSchema: Record<string, unknown> | null;
+    outputSchema: Record<string, unknown> | null;
+}
+export interface RoutesIntrospectionResponse {
+    appName: string;
+    generatedAt: string;
+    routes: RouteIntrospectionItem[];
+    collections?: Record<string, {
+        relationType: string;
+        rbac?: Record<string, unknown>;
+        schema: Record<string, unknown> | null;
+    }>;
+}
+export declare const signalTaskBody: z.ZodObject<{
+    signal: z.ZodString;
+    payload: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/tasks/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/tasks/schema.ts"],"names":[],"mappings":"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"}

package/dist/tasks/schema.js

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import { StaleWorkerEpochError } from '../utils';
+export { StaleWorkerEpochError };
+export class TaskYieldSignal extends Error {
+    reason;
+    meta;
+    isTaskYield = true;
+    constructor(reason, meta = {}) {
+        super(`TaskYield:${reason}`);
+        this.reason = reason;
+        this.meta = meta;
+        this.name = 'TaskYieldSignal';
+    }
+}
+export class ReplayCompleteSignal extends Error {
+    isReplayComplete = true;
+    constructor() {
+        super('ReplayComplete');
+        this.name = 'ReplayCompleteSignal';
+    }
+}
+export class TaskWaitDetachedSignal extends Error {
+    taskId;
+    isTaskWaitDetached = true;
+    constructor(taskId) {
+        super(`TaskWaitDetached:${taskId}`);
+        this.taskId = taskId;
+        this.name = 'TaskWaitDetachedSignal';
+    }
+}
+export const signalTaskBody = z.object({
+    signal: z.string().min(1),
+    payload: z.unknown().optional()
+});
+//# sourceMappingURL=schema.js.map

package/dist/tasks/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/tasks/schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,qBAAqB,EAAiB,MAAM,UAAU,CAAA;AAE/D,OAAO,EAAE,qBAAqB,EAAE,CAAA;AAoJhC,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAGtB,MAAM;IACN,IAAI;IAHb,WAAW,GAAG,IAAI,CAAA;IAC3B,YACkB,MAAmE,EACnE,IAAI,GAKhB,EAAE;QAEN,KAAK,CAAC,aAAa,MAAM,EAAE,CAAC,CAAA;sBARZ,MAAM;oBACN,IAAI;QAQpB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;IAC/B,CAAC;CACF;AAMD,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACpC,gBAAgB,GAAG,IAAa,CAAA;IACzC;QACE,KAAK,CAAC,gBAAgB,CAAC,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;IACpC,CAAC;CACF;AA8CD,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAEnB,MAAM;IADzB,kBAAkB,GAAG,IAAa,CAAA;IAC3C,YAA4B,MAAc;QACxC,KAAK,CAAC,oBAAoB,MAAM,EAAE,CAAC,CAAA;sBADT,MAAM;QAEhC,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAA;IACtC,CAAC;CACF;AAyED,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAA"}

package/dist/tasks/service.d.ts

@@ -0,0 +1,32 @@
+import { Timestamp, type DocumentReference } from 'firebase-admin/firestore';
+import type { Core } from '../index';
+import { type StepRunner, type TaskStatusRecord, type WorkflowContext, type WorkflowRuntimeEntry } from './schema';
+export declare class TasksService {
+    #private;
+    constructor(coreClient: Core);
+    status: <O = unknown>(taskId: string) => Promise<TaskStatusRecord<O>>;
+    signal: (taskId: string, signalName: string, payload?: unknown) => Promise<{
+        taskId: string;
+        signaled: true;
+    }>;
+    cancel: (taskId: string) => Promise<{
+        taskId: string;
+        status: 'cancelled';
+    }>;
+    get internals(): {
+        createStepRunner: (mode?: import("../router").RouteMode, docRef?: DocumentReference, steps?: Record<string, unknown>, expiresAt?: Timestamp, runnerOpts?: import("./schema").CreateStepRunnerOptions) => StepRunner;
+        allWithRollback: <T extends readonly unknown[]>(legs: { [K in keyof T]: import("./schema").RollbackLeg<T[K]>; }) => Promise<T>;
+        getContext: () => WorkflowContext;
+        useStep: () => StepRunner;
+        getActiveWorkflowStore: () => import("./schema").ActiveWorkflowStore | undefined;
+        dispatch: <I, O>(workflowName: string, fn: (input: I, step: StepRunner) => Promise<O>, params: I, opts?: import("./schema").DispatchWorkflowOptions) => Promise<O>;
+        execute: (payload: import("./schema").WorkflowTaskPayload, workflowRegistry?: Record<string, WorkflowRuntimeEntry>, execOpts?: import("./schema").ExecuteWorkflowTaskOptions) => Promise<void>;
+        registerRuntime: (registry: Record<string, WorkflowRuntimeEntry>) => void;
+        getRuntime: () => {
+            registry: Record<string, WorkflowRuntimeEntry>;
+        };
+        watchTask: <O = unknown>(taskId: string, opts?: import("./schema").WatchTaskOptions) => Promise<import("./schema").TaskRecord<O>>;
+        getActiveWatcherCount: () => number;
+    };
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/tasks/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/tasks/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAE5E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AACpC,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EAC1B,MAAM,UAAU,CAAA;AAMjB,qBAAa,YAAY;;IAMvB,YAAY,UAAU,EAAE,IAAI,EAM3B;IAgBD,MAAM,GAAU,CAAC,GAAG,OAAO,UAAU,MAAM,KAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAwBzE;IAED,MAAM,WACI,MAAM,cACF,MAAM,YACR,OAAO,KAChB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,IAAI,CAAA;KAAE,CAAC,CA2D7C;IA4CD,MAAM,WAAkB,MAAM,KAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,WAAW,CAAA;KAAE,CAAC,CA4DhF;IAED,IAAI,SAAS;QAET,gBAAgB;QAChB,eAAe;QACf,UAAU;QACV,OAAO,QAtNI,UAAU;QAuNrB,sBAAsB;QACtB,QAAQ;QACR,OAAO;QACP,eAAe;QACf,UAAU;;;QACV,SAAS;QACT,qBAAqB;MAExB;CACF"}

package/dist/tasks/service.js

@@ -0,0 +1,201 @@
+import { Timestamp } from 'firebase-admin/firestore';
+import { CORE_CONFIG } from '../config';
+import { StaleWorkerEpochError } from './schema';
+import { TaskStepsEngine } from './steps';
+import { resolveTaskDeadline } from './utils';
+import { TaskWatcherEngine } from './watcher';
+import { TaskWorkerEngine } from './worker';
+export class TasksService {
+    #core;
+    #worker;
+    #steps;
+    #watcher;
+    constructor(coreClient) {
+        this.#core = coreClient;
+        this.#worker = new TaskWorkerEngine(coreClient);
+        this.#steps = new TaskStepsEngine(coreClient, this.#worker.invokeChildWorkflow);
+        this.#watcher = new TaskWatcherEngine(coreClient, this.#steps);
+        this.#worker.bindEngines(this.#steps, this.#watcher);
+    }
+    #useStep = () => {
+        const store = this.#worker.getActiveWorkflowStore();
+        return store?.step ?? this.#steps.createStepRunner('workflow');
+    };
+    #assertTaskOwnership = (data) => {
+        if (!data)
+            throw this.#core.errors.httpError(404, 'Task not found', 'NOT_FOUND');
+        const caller = this.#core.caller;
+        if (!caller || caller.role === 'admin' || caller.userId === CORE_CONFIG.auth.adminUserId)
+            return;
+        if (typeof data.userId === 'string' && data.userId !== caller.userId) {
+            throw this.#core.errors.httpError(403, 'Forbidden', 'FORBIDDEN');
+        }
+    };
+    status = async (taskId) => {
+        const isDev = Boolean(this.#core.env.isDev);
+        const snap = await this.#core.db.firestore(isDev).collection('_tasks').doc(taskId).get();
+        const data = snap.exists ? snap.data() : undefined;
+        this.#assertTaskOwnership(data);
+        const response = 'response' in data ? await this.#steps.maybeHydrateStepValue(data.response, isDev) : undefined;
+        return {
+            taskId,
+            workflowName: String(data.workflowName ?? ''),
+            status: data.status ?? 'running',
+            ...(typeof data.userId === 'string' ? { userId: data.userId } : {}),
+            ...(typeof data.epoch === 'number' ? { epoch: data.epoch } : {}),
+            ...('activeRunId' in data ? { activeRunId: data.activeRunId ?? null } : {}),
+            ...(typeof data.lastHeartbeatAt === 'number' ? { lastHeartbeatAt: data.lastHeartbeatAt } : {}),
+            ...(data.compensatedSteps
+                ? { compensatedSteps: data.compensatedSteps }
+                : {}),
+            ...(data.progress ? { progress: data.progress } : {}),
+            ...('response' in data ? { response: response } : {}),
+            ...(typeof data.error === 'string' ? { error: data.error } : {}),
+            ...(typeof data.createdAt === 'string' ? { createdAt: data.createdAt } : {}),
+            ...(typeof data.updatedAt === 'string' ? { updatedAt: data.updatedAt } : {})
+        };
+    };
+    signal = async (taskId, signalName, payload) => {
+        const isDev = Boolean(this.#core.env.isDev);
+        const db = this.#core.db.firestore(isDev);
+        const docRef = db.collection('_tasks').doc(taskId);
+        const outcome = await db.runTransaction(async (tx) => {
+            const snap = await tx.get(docRef);
+            const data = snap.exists ? snap.data() : undefined;
+            this.#assertTaskOwnership(data);
+            const workflowName = String(data.workflowName ?? '');
+            const params = data.params ?? {};
+            const signals = {
+                ...(data.signals ?? {}),
+                [signalName]: payload ?? true
+            };
+            const wasWaiting = data.status === 'waiting_signal';
+            const currentEpoch = typeof data.epoch === 'number' ? data.epoch : 0;
+            const nextEpoch = wasWaiting ? currentEpoch + 1 : currentEpoch;
+            tx.set(docRef, {
+                signals,
+                ...(wasWaiting ? { status: 'running', waitingSignal: null, epoch: nextEpoch, activeRunId: null } : {}),
+                updatedAt: new Date().toISOString()
+            }, { merge: true });
+            return { workflowName, params, wasWaiting, nextEpoch };
+        });
+        if (outcome.wasWaiting) {
+            const wf = this.#worker.getRuntime().registry[outcome.workflowName];
+            const deadline = resolveTaskDeadline(outcome.workflowName, wf?.deadlineSeconds);
+            if (CORE_CONFIG.tasks.useCloudTasks) {
+                await this.#watcher.enqueueBatched({
+                    taskId,
+                    workflowName: outcome.workflowName,
+                    params: outcome.params,
+                    isDev,
+                    expectedEpoch: outcome.nextEpoch
+                }, deadline);
+            }
+            else if (wf) {
+                void this.#worker
+                    .execute({
+                    taskId,
+                    workflowName: outcome.workflowName,
+                    params: outcome.params,
+                    isDev,
+                    expectedEpoch: outcome.nextEpoch
+                })
+                    .catch(() => { });
+            }
+        }
+        return { taskId, signaled: true };
+    };
+    #replayUncompensatedSteps = async (taskId, docRef, freshData, isDev) => {
+        const stepsMap = { ...(freshData.steps ?? {}) };
+        const compMap = { ...(freshData.compensatedSteps ?? {}) };
+        const workflowName = String(freshData.workflowName ?? '');
+        const wf = this.#worker.getRuntime().registry[workflowName];
+        if (!wf || !Object.keys(stepsMap).some((k) => !compMap[k]))
+            return;
+        const effectiveEnv = this.#core.env;
+        const expiresAt = Timestamp.fromMillis(Date.now() + CORE_CONFIG.tasks.ttlMs);
+        const now = Date.now();
+        const wfCtx = {
+            taskId,
+            workflowName,
+            attempt: 1,
+            startedAt: now,
+            deadlineMs: now + 60_000,
+            signal: new AbortController().signal
+        };
+        const replayStep = this.#steps.createStepRunner(wf.mode, docRef, stepsMap, expiresAt, {
+            isDev,
+            workflowContext: wfCtx,
+            canYield: false,
+            compensatedSteps: compMap,
+            replayOnly: true
+        });
+        const params = freshData.params ?? {};
+        try {
+            await this.#worker.runWithWorkflowContext({ workflow: wfCtx, step: replayStep, env: effectiveEnv }, () => this.#core.internals.context.run({ env: effectiveEnv, userId: this.#core.userId, role: this.#core.role, step: replayStep }, () => wf.runTask(params, replayStep)));
+        }
+        catch { }
+        await replayStep.compensate();
+    };
+    cancel = async (taskId) => {
+        const isDev = Boolean(this.#core.env.isDev);
+        const db = this.#core.db.firestore(isDev);
+        const docRef = db.collection('_tasks').doc(taskId);
+        const preActiveExec = this.#worker.getActiveTaskExecution(taskId);
+        const txResult = await db.runTransaction(async (tx) => {
+            const snap = await tx.get(docRef);
+            const data = snap.exists ? snap.data() : undefined;
+            this.#assertTaskOwnership(data);
+            const currentStatus = data.status;
+            if (currentStatus === 'completed' || currentStatus === 'errored' || currentStatus === 'cancelled') {
+                return { alreadyTerminal: true, data: data };
+            }
+            const currentEpoch = typeof data.epoch === 'number' ? data.epoch : 0;
+            const nextEpoch = currentEpoch + 1;
+            tx.set(docRef, {
+                status: 'compensating',
+                epoch: nextEpoch,
+                activeRunId: null,
+                updatedAt: new Date().toISOString()
+            }, { merge: true });
+            return { alreadyTerminal: false, nextEpoch, data: data };
+        });
+        if (!txResult.alreadyTerminal) {
+            const activeExec = preActiveExec ?? this.#worker.getActiveTaskExecution(taskId);
+            if (activeExec) {
+                activeExec.controller.abort(new StaleWorkerEpochError(`Task ${taskId} cancelled by caller`, {
+                    taskId,
+                    claimedEpoch: activeExec.claimedEpoch,
+                    actualEpoch: txResult.nextEpoch
+                }));
+                await activeExec.step.compensate();
+            }
+            const freshSnap = await docRef.get().catch(() => null);
+            const freshData = freshSnap?.data() ?? txResult.data;
+            await this.#replayUncompensatedSteps(taskId, docRef, freshData, isDev);
+            await docRef.set({
+                status: 'cancelled',
+                activeRunId: null,
+                error: 'Cancelled by caller',
+                updatedAt: new Date().toISOString()
+            }, { merge: true });
+        }
+        return { taskId, status: 'cancelled' };
+    };
+    get internals() {
+        return {
+            createStepRunner: this.#steps.createStepRunner,
+            allWithRollback: this.#steps.allWithRollback,
+            getContext: this.#worker.getContext,
+            useStep: this.#useStep,
+            getActiveWorkflowStore: this.#worker.getActiveWorkflowStore,
+            dispatch: this.#worker.dispatch,
+            execute: this.#worker.execute,
+            registerRuntime: this.#worker.registerRuntime,
+            getRuntime: this.#worker.getRuntime,
+            watchTask: this.#watcher.watchTask,
+            getActiveWatcherCount: this.#watcher.getActiveWatcherCount
+        };
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/tasks/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/tasks/service.ts"],"names":[],"mappings":"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"}

package/dist/tasks/steps.d.ts

@@ -0,0 +1,18 @@
+import type { DocumentReference, Timestamp } from 'firebase-admin/firestore';
+import type { Core } from '../index';
+import type { RouteMode } from '../router';
+import type { Duration } from '../utils';
+import { type CreateStepRunnerOptions, type RollbackLeg, type StepRunner } from './schema';
+export declare class TaskStepsEngine {
+    #private;
+    constructor(coreClient: Core, invokeChildWorkflow: (targetName: string, input: unknown, options?: {
+        timeout?: Duration;
+        dedupeKey?: string;
+        wait?: boolean;
+    }) => Promise<any>);
+    maybeOffloadStepValue: (docRef: DocumentReference | undefined, stepId: string, val: unknown, isDev?: boolean, forceOffload?: boolean) => Promise<unknown>;
+    maybeHydrateStepValue: <T>(raw: unknown, isDev?: boolean) => Promise<T>;
+    allWithRollback: <T extends readonly unknown[]>(legs: { [K in keyof T]: RollbackLeg<T[K]>; }) => Promise<T>;
+    createStepRunner: (mode?: RouteMode, docRef?: DocumentReference, steps?: Record<string, unknown>, expiresAt?: Timestamp, runnerOpts?: CreateStepRunnerOptions) => StepRunner;
+}
+//# sourceMappingURL=steps.d.ts.map

package/dist/tasks/steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../../src/tasks/steps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAE5E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAIL,KAAK,uBAAuB,EAC5B,KAAK,WAAW,EAMhB,KAAK,UAAU,EAKhB,MAAM,UAAU,CAAA;AAcjB,qBAAa,eAAe;;IAQ1B,YACE,UAAU,EAAE,IAAI,EAChB,mBAAmB,EAAE,CACnB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,QAAQ,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,KACjE,OAAO,CAAC,GAAG,CAAC,EAIlB;IAED,qBAAqB,WACX,iBAAiB,GAAG,SAAS,UAC7B,MAAM,OACT,OAAO,8CAGX,OAAO,CAAC,OAAO,CAAC,CAqBlB;IAED,qBAAqB,GAAU,CAAC,OAAO,OAAO,sBAAkB,OAAO,CAAC,CAAC,CAAC,CAIzE;IAED,eAAe,GAAU,CAAC,SAAS,SAAS,OAAO,EAAE,QAC7C,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAE,KAC1C,OAAO,CAAC,CAAC,CAAC,CAUZ;IAmTD,gBAAgB,UACR,SAAS,WACN,iBAAiB,UACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,cAClB,SAAS,eACR,uBAAuB,KACnC,UAAU,CAuDZ;CACF"}