convex-effect-workflows 0.1.0

package/dist/client/ConvexWorkflowEngine.js.map

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

package/dist/client/activityWorker.d.ts

@@ -0,0 +1,23 @@
+export declare const activityWorkerArgs: {
+    workflowName: import("convex/values").VString<string, "required">;
+    activityName: import("convex/values").VString<string, "required">;
+    executionId: import("convex/values").VString<string, "required">;
+    attempt: import("convex/values").VFloat64<number, "required">;
+};
+export declare function runRegisteredActivity(args: {
+    workflowName: string;
+    activityName: string;
+    executionId: string;
+    attempt: number;
+}): Promise<any>;
+/**
+ * Create an app-local internal action worker that can execute registered activities.
+ */
+export declare function defineActivityWorker(): import("convex/server").RegisteredAction<"internal", {
+    executionId: string;
+    workflowName: string;
+    attempt: number;
+    activityName: string;
+}, Promise<any>>;
+export type ActivityWorkerReference = ReturnType<typeof defineActivityWorker>;
+//# sourceMappingURL=activityWorker.d.ts.map

package/dist/client/activityWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activityWorker.d.ts","sourceRoot":"","sources":["../../src/client/activityWorker.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,kBAAkB;;;;;CAK9B,CAAC;AAEF,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,gBA2BA;AAED;;GAEG;AACH,wBAAgB,oBAAoB;;;;;iBAOnC;AAED,MAAM,MAAM,uBAAuB,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/client/activityWorker.js

@@ -0,0 +1,41 @@
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import { internalActionGeneric } from "convex/server";
+import { v } from "convex/values";
+import { WorkflowInstance } from "@effect/workflow/WorkflowEngine";
+import * as Activity from "@effect/workflow/Activity";
+import { getActivity, getWorkflow } from "./registry.js";
+export const activityWorkerArgs = {
+    workflowName: v.string(),
+    activityName: v.string(),
+    executionId: v.string(),
+    attempt: v.number(),
+};
+export async function runRegisteredActivity(args) {
+    const workflowEntry = getWorkflow(args.workflowName);
+    if (!workflowEntry) {
+        throw new Error(`Workflow not registered: ${args.workflowName}`);
+    }
+    const activity = getActivity(args.activityName);
+    if (!activity) {
+        throw new Error(`Activity not registered: ${args.activityName}`);
+    }
+    const instance = WorkflowInstance.initial(workflowEntry.workflow, args.executionId);
+    const exit = await Effect.runPromiseExit(activity.executeEncoded.pipe(Effect.provideService(WorkflowInstance, instance), Effect.provideService(Activity.CurrentAttempt, args.attempt)));
+    if (Exit.isSuccess(exit)) {
+        return exit.value;
+    }
+    throw new Error(String(exit.cause));
+}
+/**
+ * Create an app-local internal action worker that can execute registered activities.
+ */
+export function defineActivityWorker() {
+    return internalActionGeneric({
+        args: activityWorkerArgs,
+        handler: async (_ctx, args) => {
+            return await runRegisteredActivity(args);
+        },
+    });
+}
+//# sourceMappingURL=activityWorker.js.map

package/dist/client/activityWorker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activityWorker.js","sourceRoot":"","sources":["../../src/client/activityWorker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,QAAQ,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEzD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAK3C;IACC,MAAM,aAAa,GAAG,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACrD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,CACvC,aAAa,CAAC,QAAQ,EACtB,IAAI,CAAC,WAAW,CACjB,CAAC;IAEF,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,cAAc,CACtC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAC1B,MAAM,CAAC,cAAc,CAAC,gBAAgB,EAAE,QAAQ,CAAC,EACjD,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,cAAuB,EAAE,IAAI,CAAC,OAAO,CAAC,CACtE,CACF,CAAC;IAEF,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,qBAAqB,CAAC;QAC3B,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;YAC5B,OAAO,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/client/boundaries.d.ts

@@ -0,0 +1,27 @@
+import type { GenericDataModel, GenericMutationCtx } from "convex/server";
+import type { WorkpoolOptions } from "@convex-dev/workpool";
+import type { ComponentApi } from "../component/_generated/component.js";
+import type { RunnerArgs, RunnerHandle } from "./ConvexWorkflowEngine.js";
+type Scheduler = Pick<GenericMutationCtx<GenericDataModel>, "scheduler">["scheduler"];
+type MutationRun = Pick<GenericMutationCtx<GenericDataModel>, "runMutation">["runMutation"];
+export type EnqueueActivityArgs = {
+    executionId: string;
+    generation: number;
+    workflowName: string;
+    activityName: string;
+    attempt: number;
+    stepNumber: number;
+    spanId?: string;
+    activityWorkerHandle: string;
+    workpoolOptions?: WorkpoolOptions;
+};
+export declare function serializeRunnerHandle(handle: RunnerHandle): string;
+export declare function enqueueActivity(runMutation: MutationRun, component: ComponentApi, args: EnqueueActivityArgs): Promise<any>;
+export declare function scheduleRunnerFanIn(scheduler: Scheduler, component: ComponentApi, args: RunnerArgs): Promise<import("convex/values").GenericId<"_scheduled_functions">>;
+export declare function scheduleDeferredCompletion(scheduler: Scheduler, component: ComponentApi, runAfterMs: number, args: {
+    executionId: string;
+    deferredName: string;
+    exit: unknown;
+}): Promise<import("convex/values").GenericId<"_scheduled_functions">>;
+export {};
+//# sourceMappingURL=boundaries.d.ts.map

package/dist/client/boundaries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundaries.d.ts","sourceRoot":"","sources":["../../src/client/boundaries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE1E,KAAK,SAAS,GAAG,IAAI,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,WAAW,CAAC,CAAC,WAAW,CAAC,CAAC;AAUtF,KAAK,WAAW,GAAG,IAAI,CACrB,kBAAkB,CAAC,gBAAgB,CAAC,EACpC,aAAa,CACd,CAAC,aAAa,CAAC,CAAC;AAQjB,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAElE;AAED,wBAAgB,eAAe,CAC7B,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,YAAY,EACvB,IAAI,EAAE,mBAAmB,gBAI1B;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,YAAY,EACvB,IAAI,EAAE,UAAU,sEAGjB;AAED,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,YAAY,EACvB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE;IACJ,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;CACf,sEAOF"}

package/dist/client/boundaries.js

@@ -0,0 +1,17 @@
+function asMutationRef(reference) {
+    return reference;
+}
+export function serializeRunnerHandle(handle) {
+    return handle;
+}
+export function enqueueActivity(runMutation, component, args) {
+    const reference = component.runner.enqueueActivity;
+    return runMutation(asMutationRef(reference), args);
+}
+export function scheduleRunnerFanIn(scheduler, component, args) {
+    return scheduler.runAfter(0, asMutationRef(component.runner.run), args);
+}
+export function scheduleDeferredCompletion(scheduler, component, runAfterMs, args) {
+    return scheduler.runAfter(runAfterMs, asMutationRef(component.deferreds.deferredDone), args);
+}
+//# sourceMappingURL=boundaries.js.map

package/dist/client/boundaries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundaries.js","sourceRoot":"","sources":["../../src/client/boundaries.ts"],"names":[],"mappings":"AAeA,SAAS,aAAa,CAAC,SAAkB;IACvC,OAAO,SAAwB,CAAC;AAClC,CAAC;AAyBD,MAAM,UAAU,qBAAqB,CAAC,MAAoB;IACxD,OAAO,MAA2B,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,WAAwB,EACxB,SAAuB,EACvB,IAAyB;IAEzB,MAAM,SAAS,GAAI,SAA0C,CAAC,MAAM,CAAC,eAAe,CAAC;IACrF,OAAO,WAAW,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,SAAoB,EACpB,SAAuB,EACvB,IAAgB;IAEhB,OAAO,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,SAAoB,EACpB,SAAuB,EACvB,UAAkB,EAClB,IAIC;IAED,OAAO,SAAS,CAAC,QAAQ,CACvB,UAAU,EACV,aAAa,CAAC,SAAS,CAAC,SAAS,CAAC,YAAY,CAAC,EAC/C,IAAI,CACL,CAAC;AACJ,CAAC"}

package/dist/client/encoded.d.ts

@@ -0,0 +1,22 @@
+import * as Workflow from "@effect/workflow/Workflow";
+import type * as Activity from "@effect/workflow/Activity";
+import { type Encoded } from "@effect/workflow/WorkflowEngine";
+import type { ComponentApi } from "../component/_generated/component.js";
+import { type ConvexWorkflowCtx } from "./ConvexCtx.js";
+export type RunnerEnqueueArgs = {
+    workflow: Workflow.Any;
+    executionId: string;
+    generation: number;
+};
+export type ActivityEnqueueArgs = RunnerEnqueueArgs & {
+    activity: Activity.Any;
+    stepNumber: number;
+    spanId: string;
+    attempt: number;
+};
+export type ConvexEncodedHooks = {
+    enqueueRunner: (ctx: ConvexWorkflowCtx, args: RunnerEnqueueArgs) => Promise<void>;
+    enqueueActivity: (ctx: ConvexWorkflowCtx, args: ActivityEnqueueArgs) => Promise<string>;
+};
+export declare function makeConvexEncoded(component: ComponentApi, hooks: ConvexEncodedHooks): Encoded;
+//# sourceMappingURL=encoded.d.ts.map

package/dist/client/encoded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoded.d.ts","sourceRoot":"","sources":["../../src/client/encoded.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,QAAQ,MAAM,2BAA2B,CAAC;AACtD,OAAO,KAAK,KAAK,QAAQ,MAAM,2BAA2B,CAAC;AAE3D,OAAO,EACL,KAAK,OAAO,EAGb,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAEzE,OAAO,EAAa,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAqBnE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,iBAAiB,GAAG;IACpD,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,aAAa,EAAE,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,eAAe,EAAE,CACf,GAAG,EAAE,iBAAiB,EACtB,IAAI,EAAE,mBAAmB,KACtB,OAAO,CAAC,MAAM,CAAC,CAAC;CACtB,CAAC;AAyGF,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,YAAY,EACvB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAiUT"}

package/dist/client/encoded.js

@@ -0,0 +1,276 @@
+import * as Context from "effect/Context";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Workflow from "@effect/workflow/Workflow";
+import { WorkflowEngine, WorkflowInstance, } from "@effect/workflow/WorkflowEngine";
+import { ConvexCtx } from "./ConvexCtx.js";
+import { scheduleDeferredCompletion } from "./boundaries.js";
+const ReplayStateTag = Context.GenericTag("convex-effect-workflows/ReplayState");
+function signaturesMatch(a, b) {
+    return JSON.stringify(a) === JSON.stringify(b);
+}
+function asExecuteOptions(options) {
+    return options;
+}
+function asDeferredDoneOptions(options) {
+    return options;
+}
+function asScheduleClockOptions(options) {
+    return options;
+}
+function toStepResult(step) {
+    const runResult = step?.runResult;
+    if (!runResult) {
+        return new Workflow.Suspended({});
+    }
+    if (runResult.kind === "success") {
+        return new Workflow.Complete({ exit: Exit.succeed(runResult.valuePreview) });
+    }
+    if (runResult.kind === "failed") {
+        return new Workflow.Complete({ exit: Exit.fail(runResult.error) });
+    }
+    return new Workflow.Complete({ exit: Exit.fail("canceled") });
+}
+function toExecutionTerminal(execution) {
+    if (!execution)
+        return undefined;
+    if (execution.status === "completed") {
+        return new Workflow.Complete({ exit: Exit.succeed(execution.resultPreview) });
+    }
+    if (execution.status === "failed" || execution.status === "interrupted") {
+        return new Workflow.Complete({
+            exit: Exit.fail(execution.error ?? "Workflow failed"),
+        });
+    }
+    return undefined;
+}
+function readExecution(ctx, component, executionId) {
+    return ctx.runQuery(component.executions.getExecution, { executionId });
+}
+function readJournalSteps(ctx, component, executionId) {
+    return ctx.runQuery(component.journalSteps.loadJournalForExecution, {
+        executionId,
+    });
+}
+function readPayload(ctx, component, payloadId) {
+    const runQueryPayload = ctx.runQuery;
+    return runQueryPayload(component.payloads.getPayload, { payloadId });
+}
+export function makeConvexEncoded(component, hooks) {
+    const workflows = new Map();
+    const encoded = {
+        register: Effect.fnUntraced(function* (workflow, execute) {
+            workflows.set(workflow.name, {
+                workflow,
+                execute: execute,
+            });
+        }),
+        execute: Effect.fnUntraced(function* (workflow, options) {
+            const convex = yield* ConvexCtx;
+            const executeOptions = asExecuteOptions(options);
+            const created = yield* Effect.promise(() => convex.runMutation(component.executions.createExecution, {
+                workflowName: workflow.name,
+                executionId: executeOptions.executionId,
+                payload: executeOptions.payload,
+                parentExecutionId: executeOptions.parent?.executionId,
+            }));
+            if (executeOptions.discard) {
+                if (created.created) {
+                    yield* Effect.promise(() => hooks.enqueueRunner(convex, {
+                        workflow,
+                        executionId: executeOptions.executionId,
+                        generation: 0,
+                    }));
+                }
+                return;
+            }
+            const execution = yield* Effect.promise(() => readExecution(convex, component, executeOptions.executionId));
+            if (!execution) {
+                return new Workflow.Complete({
+                    exit: Exit.fail(`Execution not found: ${executeOptions.executionId}`),
+                });
+            }
+            const terminal = toExecutionTerminal(execution);
+            if (terminal) {
+                return terminal;
+            }
+            yield* Effect.promise(() => convex.runMutation(component.executions.setExecutionRunning, {
+                executionId: executeOptions.executionId,
+                generation: execution.generation,
+            }));
+            const replaySteps = yield* Effect.promise(() => readJournalSteps(convex, component, executeOptions.executionId));
+            const registered = workflows.get(workflow.name);
+            if (!registered) {
+                yield* Effect.promise(() => convex.runMutation(component.executions.completeExecution, {
+                    executionId: executeOptions.executionId,
+                    generation: execution.generation,
+                    kind: "failure",
+                    error: `Workflow not registered: ${workflow.name}`,
+                }));
+                return new Workflow.Complete({
+                    exit: Exit.fail(`Workflow not registered: ${workflow.name}`),
+                });
+            }
+            const engine = yield* WorkflowEngine;
+            const instance = WorkflowInstance.initial(workflow, executeOptions.executionId);
+            let payload = execution.payloadPreview;
+            const payloadRef = execution.payloadRef;
+            if (payloadRef) {
+                const payloadDoc = yield* Effect.promise(() => readPayload(convex, component, payloadRef));
+                payload = payloadDoc?.data ?? execution.payloadPreview;
+            }
+            const replayState = { steps: replaySteps, cursor: 0 };
+            const result = yield* registered.execute(payload, executeOptions.executionId).pipe(Workflow.intoResult, Effect.provideService(ReplayStateTag, replayState), Effect.provideService(WorkflowInstance, instance), Effect.provideService(WorkflowEngine, engine));
+            if (result._tag === "Complete") {
+                yield* Exit.match(result.exit, {
+                    onSuccess: (value) => Effect.promise(() => convex.runMutation(component.executions.completeExecution, {
+                        executionId: executeOptions.executionId,
+                        generation: execution.generation,
+                        kind: "success",
+                        result: value,
+                    })),
+                    onFailure: (cause) => Effect.promise(() => convex.runMutation(component.executions.completeExecution, {
+                        executionId: executeOptions.executionId,
+                        generation: execution.generation,
+                        kind: "failure",
+                        error: String(cause),
+                    })),
+                });
+            }
+            else {
+                yield* Effect.promise(() => convex.runMutation(component.executions.setExecutionSuspended, {
+                    executionId: executeOptions.executionId,
+                    generation: execution.generation,
+                }));
+            }
+            return result;
+        }),
+        poll: Effect.fnUntraced(function* (_workflow, executionId) {
+            const convex = yield* ConvexCtx;
+            const execution = yield* Effect.promise(() => readExecution(convex, component, executionId));
+            return toExecutionTerminal(execution);
+        }),
+        interrupt: Effect.fnUntraced(function* (_workflow, executionId) {
+            const convex = yield* ConvexCtx;
+            yield* Effect.promise(() => convex.runMutation(component.executions.interruptExecution, {
+                executionId,
+                reason: "Interrupted",
+            }));
+        }),
+        resume: Effect.fnUntraced(function* (workflow, executionId) {
+            const convex = yield* ConvexCtx;
+            const execution = yield* Effect.promise(() => readExecution(convex, component, executionId));
+            if (!execution || execution.status === "interrupted") {
+                return;
+            }
+            yield* Effect.promise(() => hooks.enqueueRunner(convex, {
+                workflow,
+                executionId,
+                generation: execution.generation,
+            }));
+        }),
+        activityExecute: Effect.fnUntraced(function* (activity, attempt) {
+            const convex = yield* ConvexCtx;
+            const instance = yield* WorkflowInstance;
+            const replay = yield* ReplayStateTag;
+            const signature = {
+                kind: "activity",
+                opName: activity.name,
+            };
+            const replayed = replay.steps[replay.cursor];
+            if (replayed) {
+                replay.cursor += 1;
+                if (!signaturesMatch(replayed.signature, signature)) {
+                    throw new Error(`Determinism mismatch at ${instance.executionId}/${replayed.stepNumber}`);
+                }
+                if (replayed.state === "completed" ||
+                    replayed.state === "failed" ||
+                    replayed.state === "canceled") {
+                    return toStepResult(replayed);
+                }
+                return new Workflow.Suspended({});
+            }
+            const execution = yield* Effect.promise(() => readExecution(convex, component, instance.executionId));
+            if (!execution) {
+                return new Workflow.Complete({
+                    exit: Exit.fail(`Execution not found: ${instance.executionId}`),
+                });
+            }
+            const stepNumber = replay.steps.length;
+            const span = yield* Effect.promise(() => convex.runMutation(component.spans.createSpan, {
+                executionId: instance.executionId,
+                traceId: execution.traceId,
+                name: activity.name,
+                kind: "activity",
+                stepNumber,
+                attempt,
+            }));
+            yield* Effect.promise(() => convex.runMutation(component.journalSteps.appendJournalStep, {
+                executionId: instance.executionId,
+                stepNumber,
+                kind: "activity",
+                name: activity.name,
+                signature,
+                attempt,
+                spanId: span.spanId,
+                input: null,
+            }));
+            const workId = yield* Effect.promise(() => hooks.enqueueActivity(convex, {
+                workflow: instance.workflow,
+                executionId: instance.executionId,
+                generation: execution.generation,
+                activity,
+                stepNumber,
+                spanId: span.spanId,
+                attempt,
+            }));
+            yield* Effect.promise(() => convex.runMutation(component.journalSteps.suspendJournalStep, {
+                executionId: instance.executionId,
+                stepNumber,
+                workId,
+            }));
+            replay.steps.push({
+                stepNumber,
+                state: "suspended",
+                signature,
+            });
+            replay.cursor += 1;
+            return new Workflow.Suspended({});
+        }),
+        deferredResult: Effect.fnUntraced(function* (deferred) {
+            const convex = yield* ConvexCtx;
+            const instance = yield* WorkflowInstance;
+            return yield* Effect.promise(() => convex.runQuery(component.deferreds.deferredResult, {
+                executionId: instance.executionId,
+                deferredName: deferred.name,
+            }));
+        }),
+        deferredDone: Effect.fnUntraced(function* (options) {
+            const convex = yield* ConvexCtx;
+            const doneOptions = asDeferredDoneOptions(options);
+            yield* Effect.promise(() => convex.runMutation(component.deferreds.deferredDone, {
+                executionId: doneOptions.executionId,
+                deferredName: doneOptions.deferredName,
+                exit: doneOptions.exit,
+            }));
+        }),
+        scheduleClock: Effect.fnUntraced(function* (_workflow, options) {
+            const convex = yield* ConvexCtx;
+            const clockOptions = asScheduleClockOptions(options);
+            const execution = yield* Effect.promise(() => readExecution(convex, component, clockOptions.executionId));
+            if (!execution) {
+                return;
+            }
+            const ms = Duration.toMillis(clockOptions.clock.duration);
+            const runAfter = Math.max(0, Math.ceil(ms));
+            yield* Effect.promise(() => scheduleDeferredCompletion(convex.scheduler, component, runAfter, {
+                executionId: clockOptions.executionId,
+                deferredName: clockOptions.clock.deferred.name,
+                exit: Exit.void,
+            }));
+        }),
+    };
+    return encoded;
+}
+//# sourceMappingURL=encoded.js.map

package/dist/client/encoded.js.map

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

package/dist/client/index.d.ts

@@ -0,0 +1,13 @@
+export { ConvexWorkflowEngine } from "./ConvexWorkflowEngine.js";
+export type { MutationRunCtx, QueryRunCtx, RunnerArgs, RunnerHandle, StartWorkflowArgs, ResumeWorkflowArgs, } from "./ConvexWorkflowEngine.js";
+export { ConvexCtx, ConvexActionCtx } from "./ConvexCtx.js";
+export type { ConvexWorkflowCtx, ConvexWorkflowActionCtx } from "./ConvexCtx.js";
+export { makeConvexLogger } from "./ConvexLogger.js";
+export { makeConvexTracer } from "./ConvexTracer.js";
+export { makeConvexEncoded, type ConvexEncodedHooks, type RunnerEnqueueArgs, type ActivityEnqueueArgs, } from "./encoded.js";
+export { makeWorkflowEngine, provideConvexCtx, layerConvexWorkflowEngine, } from "./runtime.js";
+export { serializeRunnerHandle, scheduleRunnerFanIn, scheduleDeferredCompletion, } from "./boundaries.js";
+export { registerActivity, registerWorkflow, getActivity, getWorkflow } from "./registry.js";
+export { defineActivityWorker, runRegisteredActivity, activityWorkerArgs, } from "./activityWorker.js";
+export { defineWorkflowRunner, functionHandleForRunner, type RunnerMutationArgs, type RunnerOptions, } from "./runner.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EACV,cAAc,EACd,WAAW,EACX,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC5D,YAAY,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EACL,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,11 @@
+export { ConvexWorkflowEngine } from "./ConvexWorkflowEngine.js";
+export { ConvexCtx, ConvexActionCtx } from "./ConvexCtx.js";
+export { makeConvexLogger } from "./ConvexLogger.js";
+export { makeConvexTracer } from "./ConvexTracer.js";
+export { makeConvexEncoded, } from "./encoded.js";
+export { makeWorkflowEngine, provideConvexCtx, layerConvexWorkflowEngine, } from "./runtime.js";
+export { serializeRunnerHandle, scheduleRunnerFanIn, scheduleDeferredCompletion, } from "./boundaries.js";
+export { registerActivity, registerWorkflow, getActivity, getWorkflow } from "./registry.js";
+export { defineActivityWorker, runRegisteredActivity, activityWorkerArgs, } from "./activityWorker.js";
+export { defineWorkflowRunner, functionHandleForRunner, } from "./runner.js";
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAUjE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAG5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EACL,iBAAiB,GAIlB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,uBAAuB,GAGxB,MAAM,aAAa,CAAC"}

package/dist/client/registry.d.ts

@@ -0,0 +1,17 @@
+import type * as Activity from "@effect/workflow/Activity";
+import type * as Workflow from "@effect/workflow/Workflow";
+import type * as Effect from "effect/Effect";
+import type { WorkflowEngine, WorkflowInstance } from "@effect/workflow/WorkflowEngine";
+export type WorkflowExecute = (payload: object, executionId: string) => Effect.Effect<unknown, unknown, WorkflowInstance | WorkflowEngine>;
+export declare function registerWorkflow(workflow: Workflow.Any, execute: WorkflowExecute): void;
+export declare function getWorkflow(name: string): {
+    workflow: Workflow.Any;
+    execute: WorkflowExecute;
+} | undefined;
+export declare function registerActivity(activity: Activity.Any): void;
+export declare function getActivity(name: string): Activity.Any | undefined;
+export declare function listRegistered(): {
+    workflows: string[];
+    activities: string[];
+};
+//# sourceMappingURL=registry.d.ts.map

package/dist/client/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/client/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,QAAQ,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,KAAK,QAAQ,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAExF,MAAM,MAAM,eAAe,GAAG,CAC5B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,KAChB,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG,cAAc,CAAC,CAAC;AAKxE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,eAAe,QAEhF;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM;cAPM,QAAQ,CAAC,GAAG;aAAW,eAAe;cASnF;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,QAEtD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,4BAEvC;AAED,wBAAgB,cAAc;;;EAK7B"}

package/dist/client/registry.js

@@ -0,0 +1,21 @@
+const workflows = new Map();
+const activities = new Map();
+export function registerWorkflow(workflow, execute) {
+    workflows.set(workflow.name, { workflow, execute });
+}
+export function getWorkflow(name) {
+    return workflows.get(name);
+}
+export function registerActivity(activity) {
+    activities.set(activity.name, activity);
+}
+export function getActivity(name) {
+    return activities.get(name);
+}
+export function listRegistered() {
+    return {
+        workflows: [...workflows.keys()],
+        activities: [...activities.keys()],
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/client/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/client/registry.ts"],"names":[],"mappings":"AAUA,MAAM,SAAS,GAAG,IAAI,GAAG,EAAgE,CAAC;AAC1F,MAAM,UAAU,GAAG,IAAI,GAAG,EAAwB,CAAC;AAEnD,MAAM,UAAU,gBAAgB,CAAC,QAAsB,EAAE,OAAwB;IAC/E,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAsB;IACrD,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,SAAS,EAAE,CAAC,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;QAChC,UAAU,EAAE,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;KACnC,CAAC;AACJ,CAAC"}

package/dist/client/runner.d.ts

@@ -0,0 +1,27 @@
+import * as Effect from "effect/Effect";
+import * as Workflow from "@effect/workflow/Workflow";
+import { WorkflowEngine, type WorkflowInstance } from "@effect/workflow/WorkflowEngine";
+import { type FunctionReference } from "convex/server";
+import type { WorkpoolOptions } from "@convex-dev/workpool";
+import type { ComponentApi } from "../component/_generated/component.js";
+import type { RunnerArgs, RunnerHandle } from "./ConvexWorkflowEngine.js";
+export type RunnerMutationArgs = RunnerArgs;
+type MutationReference = FunctionReference<"mutation", "public"> | FunctionReference<"mutation", "internal">;
+type ActionReference = FunctionReference<"action", "public"> | FunctionReference<"action", "internal">;
+export type RunnerReference = MutationReference | string;
+export type ActivityWorkerTarget = ActionReference | string;
+export type RunnerOptions = {
+    activityWorker: ActivityWorkerTarget;
+    workpoolOptions?: WorkpoolOptions;
+};
+/**
+ * Define a workflow runner mutation for one workflow.
+ *
+ * The runner executes one deterministic tick by calling the encoded engine
+ * directly (not `WorkflowEngine.execute`), avoiding in-mutation suspended loops.
+ * Suspension/resume is handled via component.onComplete.
+ */
+export declare function defineWorkflowRunner(component: ComponentApi, workflow: Workflow.Any, execute: (payload: object, executionId: string) => Effect.Effect<unknown, unknown, WorkflowInstance | WorkflowEngine>, options: RunnerOptions): import("convex/server").RegisteredMutation<"internal", RunnerArgs, Promise<void>>;
+export declare function functionHandleForRunner(runner: RunnerReference): Promise<RunnerHandle>;
+export {};
+//# sourceMappingURL=runner.d.ts.map

package/dist/client/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/client/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,QAAQ,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAEL,cAAc,EACd,KAAK,gBAAgB,EACtB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AASzE,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAM1E,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC;AAE5C,KAAK,iBAAiB,GAClB,iBAAiB,CAAC,UAAU,EAAE,QAAQ,CAAC,GACvC,iBAAiB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;AAE9C,KAAK,eAAe,GAChB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,GACrC,iBAAiB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AAE5C,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG,MAAM,CAAC;AAazD,MAAM,MAAM,oBAAoB,GAAG,eAAe,GAAG,MAAM,CAAC;AAY5D,MAAM,MAAM,aAAa,GAAG;IAI1B,cAAc,EAAE,oBAAoB,CAAC;IACrC,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,YAAY,EACvB,QAAQ,EAAE,QAAQ,CAAC,GAAG,EACtB,OAAO,EAAE,CACP,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,KAChB,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG,cAAc,CAAC,EACvE,OAAO,EAAE,aAAa,qFAsEvB;AAED,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,YAAY,CAAC,CAEvB"}