convex-effect-workflows 0.1.0

package/dist/component/deferreds.d.ts

@@ -0,0 +1,31 @@
+export declare const deferredResult: import("convex/server").RegisteredQuery<"public", {
+    executionId: string;
+    deferredName: string;
+}, Promise<any>>;
+export declare const deferredDone: import("convex/server").RegisteredMutation<"public", {
+    executionId: string;
+    deferredName: string;
+    exit: any;
+}, Promise<{
+    changed: boolean;
+}>>;
+export declare const registerDeferred: import("convex/server").RegisteredMutation<"public", {
+    executionId: string;
+    deferredName: string;
+}, Promise<null>>;
+/**
+ * Test helper for creating a deferred record.
+ */
+export declare const createDeferred: import("convex/server").RegisteredMutation<"public", {
+    executionId: string;
+    deferredName: string;
+}, Promise<null>>;
+/**
+ * Test helper for completing a deferred with exit value.
+ */
+export declare const completeDeferred: import("convex/server").RegisteredMutation<"public", {
+    executionId: string;
+    deferredName: string;
+    exit: any;
+}, Promise<null>>;
+//# sourceMappingURL=deferreds.d.ts.map

package/dist/component/deferreds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferreds.d.ts","sourceRoot":"","sources":["../../src/component/deferreds.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,cAAc;;;gBAazB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;GAqDvB,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;iBAiB3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc;;;iBAkBzB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;iBAyB3B,CAAC"}

package/dist/component/deferreds.js

@@ -0,0 +1,138 @@
+import { v } from "convex/values";
+import { mutation, query } from "./_generated/server.js";
+import { scheduleRunnerFanIn } from "./boundaries.js";
+import { persistBoundedPayload, hydratePayload } from "./payloads.js";
+import { nowTs } from "./utils.js";
+async function getDeferredRow(ctx, executionId, deferredName) {
+    return await ctx.db
+        .query("deferreds")
+        .withIndex("by_execution_name", (q) => q.eq("executionId", executionId).eq("deferredName", deferredName))
+        .unique();
+}
+export const deferredResult = query({
+    args: {
+        executionId: v.string(),
+        deferredName: v.string(),
+    },
+    returns: v.any(),
+    handler: async (ctx, args) => {
+        const deferred = await getDeferredRow(ctx, args.executionId, args.deferredName);
+        if (!deferred || !deferred.completed) {
+            return undefined;
+        }
+        return await hydratePayload(ctx, deferred.exitRef, deferred.exitPreview);
+    },
+});
+export const deferredDone = mutation({
+    args: {
+        executionId: v.string(),
+        deferredName: v.string(),
+        exit: v.any(),
+    },
+    returns: v.object({ changed: v.boolean() }),
+    handler: async (ctx, args) => {
+        const existing = await getDeferredRow(ctx, args.executionId, args.deferredName);
+        if (existing?.completed) {
+            return { changed: false };
+        }
+        const exitPayload = await persistBoundedPayload(ctx, "deferredExit", args.exit);
+        if (existing) {
+            await ctx.db.patch(existing._id, {
+                completed: true,
+                completedAt: nowTs(),
+                exitRef: exitPayload.ref,
+                exitPreview: exitPayload.preview,
+            });
+        }
+        else {
+            await ctx.db.insert("deferreds", {
+                executionId: args.executionId,
+                deferredName: args.deferredName,
+                completed: true,
+                completedAt: nowTs(),
+                exitRef: exitPayload.ref,
+                exitPreview: exitPayload.preview,
+            });
+        }
+        const execution = await ctx.db
+            .query("executions")
+            .withIndex("by_execution_id", (q) => q.eq("executionId", args.executionId))
+            .unique();
+        if (execution &&
+            execution.runnerHandle &&
+            execution.status !== "completed" &&
+            execution.status !== "failed" &&
+            execution.status !== "interrupted") {
+            await scheduleRunnerFanIn(ctx.scheduler, {
+                executionId: execution.executionId,
+                generation: execution.generation,
+            });
+        }
+        return { changed: true };
+    },
+});
+export const registerDeferred = mutation({
+    args: {
+        executionId: v.string(),
+        deferredName: v.string(),
+    },
+    returns: v.null(),
+    handler: async (ctx, args) => {
+        const existing = await getDeferredRow(ctx, args.executionId, args.deferredName);
+        if (!existing) {
+            await ctx.db.insert("deferreds", {
+                executionId: args.executionId,
+                deferredName: args.deferredName,
+                completed: false,
+            });
+        }
+        return null;
+    },
+});
+/**
+ * Test helper for creating a deferred record.
+ */
+export const createDeferred = mutation({
+    args: {
+        executionId: v.string(),
+        deferredName: v.string(),
+    },
+    returns: v.null(),
+    handler: async (ctx, args) => {
+        const existing = await getDeferredRow(ctx, args.executionId, args.deferredName);
+        if (existing) {
+            return null;
+        }
+        await ctx.db.insert("deferreds", {
+            executionId: args.executionId,
+            deferredName: args.deferredName,
+            completed: false,
+        });
+        return null;
+    },
+});
+/**
+ * Test helper for completing a deferred with exit value.
+ */
+export const completeDeferred = mutation({
+    args: {
+        executionId: v.string(),
+        deferredName: v.string(),
+        exit: v.any(),
+    },
+    returns: v.null(),
+    handler: async (ctx, args) => {
+        const exitPayload = await persistBoundedPayload(ctx, "deferredExit", args.exit);
+        const existing = await getDeferredRow(ctx, args.executionId, args.deferredName);
+        if (existing) {
+            await ctx.db.patch(existing._id, {
+                completed: true,
+                completedAt: nowTs(),
+                exitRef: exitPayload.ref,
+                exitPreview: exitPayload.preview,
+            });
+        }
+        return null;
+    },
+});
+//# sourceMappingURL=deferreds.js.map

package/dist/component/deferreds.js.map

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

package/dist/component/executions.d.ts

@@ -0,0 +1,77 @@
+import { type QueryCtx } from "./_generated/server.js";
+import type { Doc } from "./_generated/dataModel.js";
+type DbReaderCtx = Pick<QueryCtx, "db">;
+export declare function mustGetExecution(ctx: DbReaderCtx, executionId: string): Promise<Doc<"executions">>;
+export declare const createExecution: import("convex/server").RegisteredMutation<"public", {
+    tenantId?: string | undefined;
+    parentExecutionId?: string | undefined;
+    runnerHandle?: string | undefined;
+    traceId?: string | undefined;
+    executionId: string;
+    workflowName: string;
+    payload: any;
+}, Promise<{
+    created: boolean;
+    executionId: import("convex/values").GenericId<"executions">;
+}>>;
+export declare const setExecutionRunning: import("convex/server").RegisteredMutation<"public", {
+    executionId: string;
+    generation: number;
+}, Promise<{
+    changed: boolean;
+}>>;
+export declare const setExecutionSuspended: import("convex/server").RegisteredMutation<"public", {
+    executionId: string;
+    generation: number;
+}, Promise<{
+    changed: boolean;
+}>>;
+export declare const completeExecution: import("convex/server").RegisteredMutation<"public", {
+    error?: string | undefined;
+    result?: any;
+    executionId: string;
+    kind: "success" | "failure";
+    generation: number;
+}, Promise<{
+    changed: boolean;
+}>>;
+export declare const interruptExecution: import("convex/server").RegisteredMutation<"public", {
+    reason?: string | undefined;
+    executionId: string;
+}, Promise<{
+    generation: number;
+}>>;
+export declare const getExecution: import("convex/server").RegisteredQuery<"public", {
+    executionId: string;
+}, Promise<{
+    _id: import("convex/values").GenericId<"executions">;
+    _creationTime: number;
+    error?: string | undefined;
+    tenantId?: string | undefined;
+    parentExecutionId?: string | undefined;
+    runnerHandle?: string | undefined;
+    payloadRef?: import("convex/values").GenericId<"payloads"> | undefined;
+    payloadPreview?: any;
+    resultKind?: "success" | "failure" | undefined;
+    resultRef?: import("convex/values").GenericId<"payloads"> | undefined;
+    resultPreview?: any;
+    completedAt?: number | undefined;
+    lastResumedAt?: number | undefined;
+    lastSuspendedAt?: number | undefined;
+    executionId: string;
+    workflowName: string;
+    status: "pending" | "running" | "suspended" | "completed" | "failed" | "interrupted";
+    generation: number;
+    traceId: string;
+    startedAt: number;
+    payloadSize: number;
+} | null>>;
+/**
+ * Test helper for patching execution startedAt (simulates old executions).
+ */
+export declare const internalPatchExecution: import("convex/server").RegisteredMutation<"public", {
+    executionId: string;
+    startedAt: number;
+}, Promise<null>>;
+export {};
+//# sourceMappingURL=executions.d.ts.map

package/dist/component/executions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executions.d.ts","sourceRoot":"","sources":["../../src/component/executions.ts"],"names":[],"mappings":"AACA,OAAO,EAAqC,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAI1F,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAErD,KAAK,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAYxC,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,WAAW,EAChB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAM5B;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;GA2C1B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;GAwB9B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;GAwBhC,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;GA4C5B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;GAyB7B,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;UAQvB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;iBAWjC,CAAC"}

package/dist/component/executions.js

@@ -0,0 +1,186 @@
+import { v } from "convex/values";
+import { mutation, query } from "./_generated/server.js";
+import { nowTs, generateTraceId } from "./utils.js";
+import { persistBoundedPayload } from "./payloads.js";
+import { vExecutionStatus } from "../shared/validators.js";
+async function getExecutionByExecutionId(ctx, executionId) {
+    return await ctx.db
+        .query("executions")
+        .withIndex("by_execution_id", (q) => q.eq("executionId", executionId))
+        .unique();
+}
+export async function mustGetExecution(ctx, executionId) {
+    const execution = await getExecutionByExecutionId(ctx, executionId);
+    if (!execution) {
+        throw new Error(`Execution not found: ${executionId}`);
+    }
+    return execution;
+}
+export const createExecution = mutation({
+    args: {
+        workflowName: v.string(),
+        executionId: v.string(),
+        payload: v.any(),
+        tenantId: v.optional(v.string()),
+        parentExecutionId: v.optional(v.string()),
+        traceId: v.optional(v.string()),
+        runnerHandle: v.optional(v.string()),
+    },
+    returns: v.object({
+        created: v.boolean(),
+        executionId: v.id("executions"),
+    }),
+    handler: async (ctx, args) => {
+        const existing = await getExecutionByExecutionId(ctx, args.executionId);
+        if (existing) {
+            return { created: false, executionId: existing._id };
+        }
+        const payload = await persistBoundedPayload(ctx, "executionPayload", args.payload);
+        const id = await ctx.db.insert("executions", {
+            workflowName: args.workflowName,
+            executionId: args.executionId,
+            status: "pending",
+            generation: 0,
+            tenantId: args.tenantId,
+            parentExecutionId: args.parentExecutionId,
+            payloadRef: payload.ref,
+            payloadPreview: payload.preview,
+            payloadSize: payload.size,
+            traceId: args.traceId ?? generateTraceId(),
+            runnerHandle: args.runnerHandle,
+            startedAt: nowTs(),
+        });
+        return { created: true, executionId: id };
+    },
+});
+export const setExecutionRunning = mutation({
+    args: {
+        executionId: v.string(),
+        generation: v.number(),
+    },
+    returns: v.object({ changed: v.boolean() }),
+    handler: async (ctx, { executionId, generation }) => {
+        const execution = await mustGetExecution(ctx, executionId);
+        if (execution.generation !== generation) {
+            return { changed: false };
+        }
+        if (execution.status === "completed" ||
+            execution.status === "failed" ||
+            execution.status === "interrupted") {
+            return { changed: false };
+        }
+        await ctx.db.patch(execution._id, {
+            status: "running",
+            lastResumedAt: nowTs(),
+        });
+        return { changed: true };
+    },
+});
+export const setExecutionSuspended = mutation({
+    args: {
+        executionId: v.string(),
+        generation: v.number(),
+    },
+    returns: v.object({ changed: v.boolean() }),
+    handler: async (ctx, { executionId, generation }) => {
+        const execution = await mustGetExecution(ctx, executionId);
+        if (execution.generation !== generation) {
+            return { changed: false };
+        }
+        if (execution.status === "completed" ||
+            execution.status === "failed" ||
+            execution.status === "interrupted") {
+            return { changed: false };
+        }
+        await ctx.db.patch(execution._id, {
+            status: "suspended",
+            lastSuspendedAt: nowTs(),
+        });
+        return { changed: true };
+    },
+});
+export const completeExecution = mutation({
+    args: {
+        executionId: v.string(),
+        generation: v.number(),
+        kind: v.union(v.literal("success"), v.literal("failure")),
+        result: v.optional(v.any()),
+        error: v.optional(v.string()),
+    },
+    returns: v.object({ changed: v.boolean() }),
+    handler: async (ctx, args) => {
+        const execution = await mustGetExecution(ctx, args.executionId);
+        if (execution.generation !== args.generation) {
+            return { changed: false };
+        }
+        if (execution.status === "completed" ||
+            execution.status === "failed" ||
+            execution.status === "interrupted") {
+            return { changed: false };
+        }
+        let resultRef = execution.resultRef;
+        let resultPreview = execution.resultPreview;
+        if (args.result !== undefined) {
+            const resultPayload = await persistBoundedPayload(ctx, "stepOutput", args.result);
+            resultRef = resultPayload.ref;
+            resultPreview = resultPayload.preview;
+        }
+        await ctx.db.patch(execution._id, {
+            status: args.kind === "success" ? "completed" : "failed",
+            resultKind: args.kind,
+            resultRef,
+            resultPreview,
+            error: args.error,
+            completedAt: nowTs(),
+        });
+        return { changed: true };
+    },
+});
+export const interruptExecution = mutation({
+    args: {
+        executionId: v.string(),
+        reason: v.optional(v.string()),
+    },
+    returns: v.object({ generation: v.number() }),
+    handler: async (ctx, { executionId, reason }) => {
+        const execution = await mustGetExecution(ctx, executionId);
+        if (execution.status === "completed" ||
+            execution.status === "failed" ||
+            execution.status === "interrupted") {
+            return { generation: execution.generation };
+        }
+        const generation = execution.generation + 1;
+        await ctx.db.patch(execution._id, {
+            status: "interrupted",
+            generation,
+            error: reason ?? "Interrupted",
+            completedAt: nowTs(),
+        });
+        return { generation };
+    },
+});
+export const getExecution = query({
+    args: {
+        executionId: v.string(),
+    },
+    returns: v.any(),
+    handler: async (ctx, { executionId }) => {
+        return await getExecutionByExecutionId(ctx, executionId);
+    },
+});
+/**
+ * Test helper for patching execution startedAt (simulates old executions).
+ */
+export const internalPatchExecution = mutation({
+    args: {
+        executionId: v.string(),
+        startedAt: v.number(),
+    },
+    returns: v.null(),
+    handler: async (ctx, { executionId, startedAt }) => {
+        const execution = await mustGetExecution(ctx, executionId);
+        await ctx.db.patch(execution._id, { startedAt });
+        return null;
+    },
+});
+//# sourceMappingURL=executions.js.map

package/dist/component/executions.js.map

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