@convex-dev/workpool 0.1.2 → 0.2.0-alpha.0

package/dist/esm/component/schema.js

@@ -1,88 +1,79 @@
 import { defineSchema, defineTable } from "convex/server";
 import { v } from "convex/values";
-import { logLevel } from "./logging";
-export const completionStatus = v.union(v.literal("success"), v.literal("error"), v.literal("canceled"), v.literal("timeout"));
-/**
-Data flow:
-
-- The mutation `mainLoop` runs periodically and serially.
-- Several tables act as queues, with client-driven mutations enqueueing at high
-  timestamps and `mainLoop` popping at low timestamps:
-  pendingStart, pendingCompletion, and pendingCancelation.
-  - The `enqueue` mutation writes to pendingStart.
-  - The `cancel` mutation writes to pendingCancelation.
-  - The `saveResult` mutation, run as part of scheduled work, writes to pendingCompletion.
-- mainLoop processes the queues:
-  - pendingStart => inProgressWork.
-  - pendingCompletion and pendingCancelation => completedWork.
-  - inProgressWork that finishes uncleanly (timeout or system failure) => completedWork.
-- `mainLoop` schedules itself to run.
-- `enqueue`, `cancel`, and `saveResult` mutations check when `mainLoop` is scheduled to run,
-  and if it's too far in the future, they schedule it to run sooner.
-- `status` query reads from pendingWork and completedWork.
-- `cleanup` mutation deletes old rows from completedWork.
-
-To avoid OCCs, we restrict which mutations can read and write from each table:
-- pools: read by all, written only when static Workpool options change.
-- mainLoop (table): read by all, written mostly by `mainLoop`.
-  If `mainLoop` will not run for a while, mainLoop table is written by `enqueue`, `cancel`, or `saveResult`.
-- pendingWork: `enqueue` inserts at high timestamps, `mainLoop` pops at low timestamps. `status` query does point-reads.
-- pendingCompletion: `saveResult` inserts at high timestamps, `mainLoop` pops at low timestamps.
-- pendingCancelation: `cancel` inserts at high timestamps, `mainLoop` pops at low timestamps.
-- inProgressWork: `mainLoop` inserts, reads all, and deletes.
-- completedWork: `mainLoop` inserts at hight timestamps, `status` query reads, `cleanup` deletes at low timestamps.
-
- */
+import { config, onComplete, retryBehavior, runResult } from "./shared.js";
+// Represents a slice of time to process work.
+const segment = v.int64();
 export default defineSchema({
-    // Statically configured, singleton.
-    pool: defineTable({
-        maxParallelism: v.number(),
-        statusTtl: v.number(),
-        logLevel,
+    // Written from kickLoop, read everywhere.
+    globals: defineTable(config),
+    // Singleton, only read & written by `main`.
+    internalState: defineTable({
+        // Ensure that only one main is running at a time.
+        generation: v.int64(),
+        segmentCursors: v.object({
+            incoming: segment,
+            completion: segment,
+            cancelation: segment,
+        }),
+        lastRecovery: segment,
+        report: v.object({
+            completed: v.number(),
+            succeeded: v.number(),
+            failed: v.number(),
+            retries: v.number(),
+            canceled: v.number(),
+            lastReportTs: v.number(),
+        }),
+        running: v.array(v.object({
+            workId: v.id("work"),
+            scheduledId: v.id("_scheduled_functions"),
+            started: v.number(),
+        })),
     }),
-    mainLoop: defineTable({
+    // Singleton, written by `updateRunStatus` when running, by client or worker otherwise.
+    // Safe to read from kickLoop, since it should update infrequently.
+    runStatus: defineTable({
         state: v.union(v.object({ kind: v.literal("running") }), v.object({
             kind: v.literal("scheduled"),
-            runAtTime: v.number(),
-            fn: v.id("_scheduled_functions"),
-        }), v.object({ kind: v.literal("idle") })),
+            segment,
+            scheduledId: v.id("_scheduled_functions"),
+            saturated: v.boolean(),
+            generation: v.int64(),
+        }), v.object({ kind: v.literal("idle"), generation: v.int64() })),
     }),
+    // Written on enqueue. Deleted by `complete` for success, failure, canceled.
     work: defineTable({
         fnType: v.union(v.literal("action"), v.literal("mutation")),
         fnHandle: v.string(),
         fnName: v.string(),
         fnArgs: v.any(),
+        attempts: v.number(),
+        onComplete: v.optional(onComplete),
+        retryBehavior: v.optional(retryBehavior),
+        canceled: v.optional(v.boolean()),
     }),
+    // Written on enqueue & rescheduled for retry, read & deleted by `main`.
     pendingStart: defineTable({
         workId: v.id("work"),
-    }).index("workId", ["workId"]),
+        segment,
+    })
+        .index("workId", ["workId"])
+        .index("segment", ["segment"]),
+    // Written by complete, read & deleted by `main`.
     pendingCompletion: defineTable({
-        generation: v.number(),
-        completionStatus,
+        segment,
+        runResult,
         workId: v.id("work"),
+        retry: v.boolean(),
     })
         .index("workId", ["workId"])
-        .index("generation", ["generation"]),
+        .index("segment", ["segment"]),
+    // Written on cancelation, read & deleted by `main`.
     pendingCancelation: defineTable({
+        segment,
         workId: v.id("work"),
-    }),
-    inProgressWork: defineTable({
-        running: v.id("_scheduled_functions"),
-        timeoutMs: v.union(v.number(), v.null()),
-        workId: v.id("work"),
-    }).index("workId", ["workId"]),
-    inProgressCount: defineTable({
-        count: v.number(),
-    }),
-    completedWork: defineTable({
-        completionStatus,
-        workId: v.id("work"),
-    }).index("workId", ["workId"]),
-    completionGeneration: defineTable({
-        generation: v.number(),
-    }),
-    pendingStartCursor: defineTable({
-        cursor: v.number(),
-    }),
+    })
+        .index("workId", ["workId"])
+        .index("segment", ["segment"]),
 });
 //# sourceMappingURL=schema.js.map

package/dist/esm/component/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/component/schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/component/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE3E,8CAA8C;AAC9C,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;AAE1B,eAAe,YAAY,CAAC;IAC1B,0CAA0C;IAC1C,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC;IAC5B,4CAA4C;IAC5C,aAAa,EAAE,WAAW,CAAC;QACzB,kDAAkD;QAClD,UAAU,EAAE,CAAC,CAAC,KAAK,EAAE;QACrB,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC;YACvB,QAAQ,EAAE,OAAO;YACjB,UAAU,EAAE,OAAO;YACnB,WAAW,EAAE,OAAO;SACrB,CAAC;QACF,YAAY,EAAE,OAAO;QACrB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;YACf,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;YACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;YACrB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;YAClB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;YACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;YACpB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;SACzB,CAAC;QACF,OAAO,EAAE,CAAC,CAAC,KAAK,CACd,CAAC,CAAC,MAAM,CAAC;YACP,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC;YACpB,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC,sBAAsB,CAAC;YACzC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;SACpB,CAAC,CACH;KACF,CAAC;IAEF,uFAAuF;IACvF,mEAAmE;IACnE,SAAS,EAAE,WAAW,CAAC;QACrB,KAAK,EAAE,CAAC,CAAC,KAAK,CACZ,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,EACxC,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;YAC5B,OAAO;YACP,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC,sBAAsB,CAAC;YACzC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;YACtB,UAAU,EAAE,CAAC,CAAC,KAAK,EAAE;SACtB,CAAC,EACF,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAC7D;KACF,CAAC;IAEF,4EAA4E;IAC5E,IAAI,EAAE,WAAW,CAAC;QAChB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC3D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,MAAM,EAAE,CAAC,CAAC,GAAG,EAAE;QACf,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;QAClC,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;QACxC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;KAClC,CAAC;IAEF,wEAAwE;IACxE,YAAY,EAAE,WAAW,CAAC;QACxB,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC;QACpB,OAAO;KACR,CAAC;SACC,KAAK,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC;SAC3B,KAAK,CAAC,SAAS,EAAE,CAAC,SAAS,CAAC,CAAC;IAEhC,iDAAiD;IACjD,iBAAiB,EAAE,WAAW,CAAC;QAC7B,OAAO;QACP,SAAS;QACT,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC;QACpB,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;KACnB,CAAC;SACC,KAAK,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC;SAC3B,KAAK,CAAC,SAAS,EAAE,CAAC,SAAS,CAAC,CAAC;IAEhC,oDAAoD;IACpD,kBAAkB,EAAE,WAAW,CAAC;QAC9B,OAAO;QACP,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC;KACrB,CAAC;SACC,KAAK,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC;SAC3B,KAAK,CAAC,SAAS,EAAE,CAAC,SAAS,CAAC,CAAC;CACjC,CAAC,CAAC"}

package/dist/esm/component/shared.d.ts

@@ -0,0 +1,138 @@
+import { Infer } from "convex/values";
+import { Logger } from "./logging.js";
+export declare const SECOND = 1000;
+export declare const MINUTE: number;
+export declare const HOUR: number;
+export declare const DAY: number;
+export declare const YEAR: number;
+export declare function toSegment(ms: number): bigint;
+export declare function currentSegment(): bigint;
+export declare function nextSegment(): bigint;
+export declare function fromSegment(segment: bigint): number;
+export declare const config: import("convex/values").VObject<{
+    maxParallelism: number;
+    logLevel: "DEBUG" | "INFO" | "WARN" | "ERROR";
+}, {
+    maxParallelism: import("convex/values").VFloat64<number, "required">;
+    logLevel: import("convex/values").VUnion<"DEBUG" | "INFO" | "WARN" | "ERROR", [import("convex/values").VLiteral<"DEBUG", "required">, import("convex/values").VLiteral<"INFO", "required">, import("convex/values").VLiteral<"WARN", "required">, import("convex/values").VLiteral<"ERROR", "required">], "required", never>;
+}, "required", "maxParallelism" | "logLevel">;
+export type Config = Infer<typeof config>;
+export declare const retryBehavior: import("convex/values").VObject<{
+    maxAttempts: number;
+    initialBackoffMs: number;
+    base: number;
+}, {
+    maxAttempts: import("convex/values").VFloat64<number, "required">;
+    initialBackoffMs: import("convex/values").VFloat64<number, "required">;
+    base: import("convex/values").VFloat64<number, "required">;
+}, "required", "maxAttempts" | "initialBackoffMs" | "base">;
+export type RetryBehavior = {
+    /**
+     * The maximum number of attempts to make. 2 means one retry.
+     */
+    maxAttempts: number;
+    /**
+     * The initial backoff time in milliseconds. 100 means wait 100ms before the
+     * first retry.
+     */
+    initialBackoffMs: number;
+    /**
+     * The base for the backoff. 2 means double the backoff each time.
+     * e.g. if the initial backoff is 100ms, and the base is 2, then the first
+     * retry will wait 200ms, the second will wait 400ms, etc.
+     */
+    base: number;
+};
+export declare const runResult: import("convex/values").VUnion<{
+    kind: "success";
+    returnValue: any;
+} | {
+    kind: "failed";
+    error: string;
+} | {
+    kind: "canceled";
+}, [import("convex/values").VObject<{
+    kind: "success";
+    returnValue: any;
+}, {
+    kind: import("convex/values").VLiteral<"success", "required">;
+    returnValue: import("convex/values").VAny<any, "required", string>;
+}, "required", "kind" | "returnValue" | `returnValue.${string}`>, import("convex/values").VObject<{
+    kind: "failed";
+    error: string;
+}, {
+    kind: import("convex/values").VLiteral<"failed", "required">;
+    error: import("convex/values").VString<string, "required">;
+}, "required", "kind" | "error">, import("convex/values").VObject<{
+    kind: "canceled";
+}, {
+    kind: import("convex/values").VLiteral<"canceled", "required">;
+}, "required", "kind">], "required", "kind" | "returnValue" | `returnValue.${string}` | "error">;
+export type RunResult = Infer<typeof runResult>;
+export declare const onComplete: import("convex/values").VObject<{
+    context?: any;
+    fnHandle: string;
+}, {
+    fnHandle: import("convex/values").VString<string, "required">;
+    context: import("convex/values").VAny<any, "optional", string>;
+}, "required", "fnHandle" | "context" | `context.${string}`>;
+export type OnComplete = Infer<typeof onComplete>;
+export type OnCompleteArgs = {
+    /**
+     * The ID of the work that completed.
+     */
+    workId: string;
+    /**
+     * The context object passed when enqueuing the work.
+     * Useful for passing data from the enqueue site to the onComplete site.
+     */
+    context: unknown;
+    /**
+     * The result of the run that completed.
+     */
+    result: RunResult;
+};
+export declare const status: import("convex/values").VUnion<{
+    state: "pending";
+    previousAttempts: number;
+} | {
+    state: "running";
+    previousAttempts: number;
+} | {
+    state: "finished";
+}, [import("convex/values").VUnion<{
+    state: "pending";
+    previousAttempts: number;
+} | {
+    state: "running";
+    previousAttempts: number;
+} | {
+    state: "finished";
+}, [import("convex/values").VObject<{
+    state: "pending";
+    previousAttempts: number;
+}, {
+    state: import("convex/values").VLiteral<"pending", "required">;
+    previousAttempts: import("convex/values").VFloat64<number, "required">;
+}, "required", "state" | "previousAttempts">, import("convex/values").VObject<{
+    state: "running";
+    previousAttempts: number;
+}, {
+    state: import("convex/values").VLiteral<"running", "required">;
+    previousAttempts: import("convex/values").VFloat64<number, "required">;
+}, "required", "state" | "previousAttempts">, import("convex/values").VObject<{
+    state: "finished";
+}, {
+    state: import("convex/values").VLiteral<"finished", "required">;
+}, "required", "state">], "required", "state" | "previousAttempts">], "required", "state" | "previousAttempts">;
+export type Status = Infer<typeof status>;
+export declare function boundScheduledTime(ms: number, console: Logger): number;
+/**
+ * Returns the smaller of two bigint values.
+ */
+export declare function min<T extends bigint>(a: T, b: T): T;
+/**
+ * Returns the larger of two bigint values.
+ */
+export declare function max<T extends bigint>(a: T, b: T): T;
+//# sourceMappingURL=shared.d.ts.map

package/dist/esm/component/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/component/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAGtC,OAAO,EAAE,MAAM,EAAY,MAAM,cAAc,CAAC;AAGhD,eAAO,MAAM,MAAM,OAAO,CAAC;AAC3B,eAAO,MAAM,MAAM,QAAc,CAAC;AAClC,eAAO,MAAM,IAAI,QAAc,CAAC;AAChC,eAAO,MAAM,GAAG,QAAY,CAAC;AAC7B,eAAO,MAAM,IAAI,QAAY,CAAC;AAE9B,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,eAAO,MAAM,MAAM;;;;;;6CAGjB,CAAC;AACH,MAAM,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE1C,eAAO,MAAM,aAAa;;;;;;;;2DAIxB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAIF,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;gGAYrB,CAAC;AACF,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAEhD,eAAO,MAAM,UAAU;;;;;;4DAGrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAElD,MAAM,MAAM,cAAc,GAAG;IAC3B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+GAclB,CAAC;AACF,MAAM,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE1C,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAatE;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAEnD;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAEnD"}

package/dist/esm/component/shared.js

@@ -0,0 +1,77 @@
+import { v } from "convex/values";
+import { logLevel } from "./logging.js";
+const SEGMENT_MS = 100;
+export const SECOND = 1000;
+export const MINUTE = 60 * SECOND;
+export const HOUR = 60 * MINUTE;
+export const DAY = 24 * HOUR;
+export const YEAR = 365 * DAY;
+export function toSegment(ms) {
+    return BigInt(Math.floor(ms / SEGMENT_MS));
+}
+export function currentSegment() {
+    return toSegment(Date.now());
+}
+export function nextSegment() {
+    return toSegment(Date.now()) + 1n;
+}
+export function fromSegment(segment) {
+    return Number(segment) * SEGMENT_MS;
+}
+export const config = v.object({
+    maxParallelism: v.number(),
+    logLevel,
+});
+export const retryBehavior = v.object({
+    maxAttempts: v.number(),
+    initialBackoffMs: v.number(),
+    base: v.number(),
+});
+// This ensures that the type satisfies the schema.
+const _ = {};
+export const runResult = v.union(v.object({
+    kind: v.literal("success"),
+    returnValue: v.any(),
+}), v.object({
+    kind: v.literal("failed"),
+    error: v.string(),
+}), v.object({
+    kind: v.literal("canceled"),
+}));
+export const onComplete = v.object({
+    fnHandle: v.string(),
+    context: v.optional(v.any()),
+});
+export const status = v.union(v.union(v.object({
+    state: v.literal("pending"),
+    previousAttempts: v.number(),
+}), v.object({
+    state: v.literal("running"),
+    previousAttempts: v.number(),
+}), v.object({
+    state: v.literal("finished"),
+})));
+export function boundScheduledTime(ms, console) {
+    if (ms < Date.now() - YEAR) {
+        console.error("scheduled time is too old, defaulting to now", ms);
+        return Date.now();
+    }
+    if (ms > Date.now() + 4 * YEAR) {
+        console.error("scheduled time is too far in the future, defaulting to 1 year from now", ms);
+        return Date.now() + YEAR;
+    }
+    return ms;
+}
+/**
+ * Returns the smaller of two bigint values.
+ */
+export function min(a, b) {
+    return a > b ? b : a;
+}
+/**
+ * Returns the larger of two bigint values.
+ */
+export function max(a, b) {
+    return a < b ? b : a;
+}
+//# sourceMappingURL=shared.js.map

package/dist/esm/component/shared.js.map

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

package/dist/esm/component/stats.d.ts

@@ -1,4 +1,4 @@
-import { Doc } from "./_generated/dataModel";
+import { Doc } from "./_generated/dataModel.js";
 /**
  * Record stats about work execution. Intended to be queried by Axiom or Datadog.
  */
@@ -17,7 +17,8 @@ workpool
 
  */
 export declare function recordStarted(work: Doc<"work">): string;
-export declare function recordCompleted(work: Doc<"work">, status: "success" | "error" | "canceled" | "timeout"): string;
+export declare function recordCompleted(work: Doc<"work">, status: "success" | "failed" | "canceled" | "retrying"): string;
+export declare function recordReport(state: Doc<"internalState">): string;
 /**
  * Warning: this should not be used from a mutation, as it will cause conflicts.
  * Use this to debug or diagnose your queue length when it's backed up.
@@ -29,9 +30,11 @@ export declare const queueLength: import("convex/server").RegisteredQuery<"inter
  */
 export declare const debugCounts: import("convex/server").RegisteredQuery<"internal", {}, Promise<{
     pendingStart: any;
-    inProgressWork: any;
+    inProgressWork: number;
     pendingCompletion: any;
     pendingCancelation: any;
     active: number;
+    runStatus: "running" | "scheduled" | "idle" | undefined;
+    generation: bigint | undefined;
 }>>;
 //# sourceMappingURL=stats.d.ts.map

package/dist/esm/component/stats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../../src/component/stats.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAG7C;;GAEG;AAEH;;;;;;;;;;;;;GAaG;AAEH,wBAAgB,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CASvD;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,EACjB,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GACnD,MAAM,CASR;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,uEAOtB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;GAwBtB,CAAC"}
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../../src/component/stats.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAGhD;;GAEG;AAEH;;;;;;;;;;;;;GAaG;AAEH,wBAAgB,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CASvD;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,EACjB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GACrD,MAAM,CAUR;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,eAAe,CAAC,GAAG,MAAM,CAahE;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,uEAOtB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;GA0BtB,CAAC"}

package/dist/esm/component/stats.js

@@ -1,5 +1,5 @@
 import { v } from "convex/values";
-import { internalQuery } from "./_generated/server";
+import { internalQuery } from "./_generated/server.js";
 /**
  * Record stats about work execution. Intended to be queried by Axiom or Datadog.
  */
@@ -33,10 +33,25 @@ export function recordCompleted(work, status) {
         event: "completed",
         fnName: work.fnName,
         completedAt: Date.now(),
+        attempts: work.attempts,
         status,
         lagSinceEnqueued: Date.now() - work._creationTime,
     });
 }
+export function recordReport(state) {
+    const { completed, succeeded, failed, retries, canceled } = state.report;
+    const withoutRetries = completed - retries;
+    return JSON.stringify({
+        event: "report",
+        completed,
+        succeeded,
+        failed,
+        retries,
+        canceled,
+        failureRate: completed ? (failed + retries) / completed : 0,
+        permanentFailureRate: withoutRetries ? failed / withoutRetries : 0,
+    });
+}
 /**
  * Warning: this should not be used from a mutation, as it will cause conflicts.
  * Use this to debug or diagnose your queue length when it's backed up.
@@ -57,19 +72,23 @@ export const debugCounts = internalQuery({
     args: {},
     returns: v.any(),
     handler: async (ctx) => {
+        const internalState = await ctx.db.query("internalState").unique();
+        const inProgressWork = internalState?.running.length ?? 0;
         /* eslint-disable @typescript-eslint/no-explicit-any */
-        const inProgressWork = await ctx.db.query("inProgressWork").count();
         const pendingStart = await ctx.db.query("pendingStart").count();
         const pendingCompletion = await ctx.db.query("pendingCompletion").count();
         const pendingCancelation = await ctx.db.query("pendingCancelation").count();
+        const runStatus = await ctx.db.query("runStatus").unique();
+        /* eslint-enable @typescript-eslint/no-explicit-any */
         return {
             pendingStart,
             inProgressWork,
             pendingCompletion,
             pendingCancelation,
-            active: inProgressWork - pendingCompletion - pendingCancelation,
+            active: inProgressWork - pendingCompletion,
+            runStatus: runStatus?.state.kind,
+            generation: internalState?.generation,
         };
-        /* eslint-enable @typescript-eslint/no-explicit-any */
     },
 });
 //# sourceMappingURL=stats.js.map

package/dist/esm/component/stats.js.map

@@ -1 +1 @@
-{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../../src/component/stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAElC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;GAEG;AAEH;;;;;;;;;;;;;GAaG;AAEH,MAAM,UAAU,aAAa,CAAC,IAAiB;IAC7C,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,MAAM,EAAE,IAAI,CAAC,GAAG;QAChB,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,UAAU,EAAE,IAAI,CAAC,aAAa;QAC9B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,gBAAgB,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,aAAa;KAClD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,IAAiB,EACjB,MAAoD;IAEpD,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,MAAM,EAAE,IAAI,CAAC,GAAG;QAChB,KAAK,EAAE,WAAW;QAClB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;QACvB,MAAM;QACN,gBAAgB,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,aAAa;KAClD,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;IACvC,IAAI,EAAE,EAAE;IACR,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACrB,8DAA8D;QAC9D,OAAQ,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,cAAc,CAAS,CAAC,KAAK,EAAE,CAAC;IACvD,CAAC;CACF,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;IACvC,IAAI,EAAE,EAAE;IACR,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE;IAChB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACrB,uDAAuD;QACvD,MAAM,cAAc,GAAG,MACrB,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAC9B,CAAC,KAAK,EAAE,CAAC;QACV,MAAM,YAAY,GAAG,MAAO,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,cAAc,CAAS,CAAC,KAAK,EAAE,CAAC;QACzE,MAAM,iBAAiB,GAAG,MACxB,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,mBAAmB,CACjC,CAAC,KAAK,EAAE,CAAC;QACV,MAAM,kBAAkB,GAAG,MACzB,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,oBAAoB,CAClC,CAAC,KAAK,EAAE,CAAC;QACV,OAAO;YACL,YAAY;YACZ,cAAc;YACd,iBAAiB;YACjB,kBAAkB;YAClB,MAAM,EAAE,cAAc,GAAG,iBAAiB,GAAG,kBAAkB;SAChE,CAAC;QACF,sDAAsD;IACxD,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../../src/component/stats.ts"],"names":[],"mappings":"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"}

package/dist/esm/component/worker.d.ts

@@ -0,0 +1,15 @@
+export declare const runMutationWrapper: import("convex/server").RegisteredMutation<"internal", {
+    logLevel: "DEBUG" | "INFO" | "WARN" | "ERROR";
+    fnHandle: string;
+    workId: import("convex/values").GenericId<"work">;
+    fnArgs: any;
+    attempt: number;
+}, Promise<void>>;
+export declare const runActionWrapper: import("convex/server").RegisteredAction<"internal", {
+    logLevel: "DEBUG" | "INFO" | "WARN" | "ERROR";
+    fnHandle: string;
+    workId: import("convex/values").GenericId<"work">;
+    fnArgs: any;
+    attempt: number;
+}, Promise<void>>;
+//# sourceMappingURL=worker.d.ts.map

package/dist/esm/component/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../src/component/worker.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,kBAAkB;;;;;;iBA4B7B,CAAC;AASH,eAAO,MAAM,gBAAgB;;;;;;iBA4B3B,CAAC"}

package/dist/esm/component/worker.js

@@ -0,0 +1,73 @@
+import { v } from "convex/values";
+import { internal } from "./_generated/api.js";
+import { internalAction, internalMutation } from "./_generated/server.js";
+import { createLogger, logLevel } from "./logging.js";
+export const runMutationWrapper = internalMutation({
+    args: {
+        workId: v.id("work"),
+        fnHandle: v.string(),
+        fnArgs: v.any(),
+        logLevel,
+        attempt: v.number(),
+    },
+    handler: async (ctx, { workId, attempt, ...args }) => {
+        const console = createLogger(args.logLevel);
+        const fnHandle = args.fnHandle;
+        try {
+            const returnValue = await ctx.runMutation(fnHandle, args.fnArgs);
+            // NOTE: we could run the `saveResult` handler here, or call `ctx.runMutation`,
+            // but we want the mutation to be a separate transaction to reduce the window for OCCs.
+            await ctx.scheduler.runAfter(0, internal.complete.complete, {
+                jobs: [
+                    { workId, runResult: { kind: "success", returnValue }, attempt },
+                ],
+            });
+        }
+        catch (e) {
+            console.error(e);
+            const runResult = { kind: "failed", error: formatError(e) };
+            await ctx.scheduler.runAfter(0, internal.complete.complete, {
+                jobs: [{ workId, runResult, attempt }],
+            });
+        }
+    },
+});
+function formatError(e) {
+    if (e instanceof Error) {
+        return e.message;
+    }
+    return String(e);
+}
+export const runActionWrapper = internalAction({
+    args: {
+        workId: v.id("work"),
+        fnHandle: v.string(),
+        fnArgs: v.any(),
+        logLevel,
+        attempt: v.number(),
+    },
+    handler: async (ctx, { workId, attempt, ...args }) => {
+        const console = createLogger(args.logLevel);
+        const fnHandle = args.fnHandle;
+        try {
+            const returnValue = await ctx.runAction(fnHandle, args.fnArgs);
+            // NOTE: we could run `ctx.runMutation`, but we want to guarantee execution,
+            // and `ctx.scheduler.runAfter` won't OCC.
+            const runResult = { kind: "success", returnValue };
+            await ctx.scheduler.runAfter(0, internal.complete.complete, {
+                jobs: [{ workId, runResult, attempt }],
+            });
+        }
+        catch (e) {
+            console.error(e);
+            // We let the main loop handle the retries.
+            const runResult = { kind: "failed", error: formatError(e) };
+            await ctx.scheduler.runAfter(0, internal.complete.complete, {
+                jobs: [{ workId, runResult, attempt }],
+            });
+        }
+    },
+});
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+const console = "THIS IS A REMINDER TO USE createLogger";
+//# sourceMappingURL=worker.js.map

package/dist/esm/component/worker.js.map

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

package/package.json

@@ -7,7 +7,7 @@
     "email": "support@convex.dev",
     "url": "https://github.com/get-convex/workpool/issues"
   },
-  "version": "0.1.2",
+  "version": "0.2.0-alpha.0",
   "license": "Apache-2.0",
   "keywords": [
     "convex",
@@ -27,7 +27,7 @@
     "prepare": "npm run build",
     "prepack": "node node10stubs.mjs",
     "postpack": "node node10stubs.mjs --cleanup",
-    "test": "vitest run",
+    "test": "vitest",
     "lint": "tsc --noEmit && eslint . && prettier --check .",
     "format": "prettier --write .",
     "test:debug": "vitest --inspect-brk --no-file-parallelism",
@@ -66,18 +66,19 @@
   "devDependencies": {
     "@eslint/js": "^9.9.1",
     "@types/node": "^18.17.0",
-    "convex-test": "^0.0.35",
+    "convex-test": "^0.0.36-alpha.0",
     "eslint": "^9.9.1",
     "globals": "^15.9.0",
     "prettier": "3.2.5",
     "typescript": "~5.0.3",
     "typescript-eslint": "^8.4.0",
-    "vitest": "^2.1.4"
+    "vitest": "^2.1.9"
   },
   "main": "./dist/commonjs/client/index.js",
   "types": "./dist/commonjs/client/index.d.ts",
   "module": "./dist/esm/client/index.js",
   "dependencies": {
-    "@convex-dev/crons": "^0.1.5"
+    "@edge-runtime/vm": "^4.0.4",
+    "@vitest/coverage-v8": "^2.1.9"
   }
 }