rivetkit 2.3.0-rc.9 → 2.3.0

package/dist/tsup/workflow/mod.js

@@ -1,22 +1,23 @@
 import {
   createWorkflowInspectorAdapter
-} from "../chunk-MMMEZM5J.js";
+} from "../chunk-P2GNQ4RN.js";
+import "../chunk-UMZVD6DQ.js";
 import {
   ACTOR_CONTEXT_INTERNAL_SYMBOL,
+  RAW_STATE_SYMBOL,
   RUN_FUNCTION_CONFIG_SYMBOL
-} from "../chunk-T6YVRM4K.js";
-import "../chunk-KJTA3ATT.js";
+} from "../chunk-DPIMKYNB.js";
 import {
   makeWorkflowKey,
   workflowStoragePrefix
-} from "../chunk-3YY5S6TV.js";
-import "../chunk-W7EYSYVI.js";
+} from "../chunk-HXUEHHJF.js";
+import "../chunk-2OTRTA3J.js";
 import {
   stringifyError
-} from "../chunk-VRCIXJRN.js";
+} from "../chunk-VTTFNQQI.js";
 import {
   RivetError
-} from "../chunk-KIWH5H3K.js";
+} from "../chunk-BRP62GZC.js";
 
 // src/workflow/mod.ts
 import {
@@ -25,561 +26,585 @@ import {
   HistoryDivergedError,
   JoinError,
   RaceError,
-  replayWorkflowFromStep,
   RollbackCheckpointError,
   RollbackError,
+  replayWorkflowFromStep,
   runWorkflow,
   StepExhaustedError
 } from "@rivetkit/workflow-engine";
 import invariant from "invariant";
 
-// src/workflow/driver.ts
-var WORKFLOW_STORAGE_PREFIX = workflowStoragePrefix();
-function stripWorkflowKey(prefixed) {
-  return prefixed.slice(WORKFLOW_STORAGE_PREFIX.length);
-}
-function computeUpperBound(prefix) {
-  const upperBound = prefix.slice();
-  for (let i = upperBound.length - 1; i >= 0; i--) {
-    if (upperBound[i] !== 255) {
-      upperBound[i]++;
-      return upperBound.slice(0, i + 1);
-    }
-  }
-  return null;
-}
-var ActorWorkflowMessageDriver = class {
-  #actor;
+// src/workflow/constants.ts
+var WORKFLOW_GUARD_KV_KEY = "__rivet_actor_workflow_guard_triggered";
+
+// src/workflow/context.ts
+var ActorWorkflowContext = class _ActorWorkflowContext {
+  #inner;
   #runCtx;
-  constructor(actor, runCtx) {
-    this.#actor = actor;
+  #actorAccessDepth = 0;
+  #allowActorAccess = false;
+  #guardViolation = false;
+  constructor(inner, runCtx) {
+    this.#inner = inner;
     this.#runCtx = runCtx;
   }
-  async addMessage(message) {
-    await this.#runCtx.internalKeepAwake(
-      this.#actor.queueManager.enqueue(message.name, message.data)
-    );
+  get workflowId() {
+    return this.#inner.workflowId;
   }
-  async receiveMessages(opts) {
-    const messages = await this.#runCtx.internalKeepAwake(
-      this.#actor.queueManager.receive(
-        opts.names && opts.names.length > 0 ? [...opts.names] : void 0,
-        opts.count,
-        0,
-        void 0,
-        opts.completable
-      )
-    );
-    return messages.map((message) => ({
-      id: message.id.toString(),
-      name: message.name,
-      data: message.body,
-      sentAt: message.createdAt,
-      ...opts.completable ? {
-        complete: async (response) => {
-          await this.#runCtx.internalKeepAwake(
-            this.#actor.queueManager.completeMessage(
-              message,
-              response
-            )
-          );
-        }
-      } : {}
-    }));
+  get abortSignal() {
+    return this.#inner.abortSignal;
   }
-  async completeMessage(messageId, response) {
-    let parsedId;
-    try {
-      parsedId = BigInt(messageId);
-    } catch {
-      return;
+  get queue() {
+    const self = this;
+    async function next(name, opts) {
+      const message = await self.#inner.queue.next(name, opts);
+      return self.#toActorQueueMessage(message);
     }
-    await this.#runCtx.internalKeepAwake(
-      this.#actor.queueManager.completeMessageById(parsedId, response)
-    );
-  }
-};
-var ActorWorkflowDriver = class {
-  workerPollInterval = 100;
-  messageDriver;
-  #actor;
-  #runCtx;
-  constructor(actor, runCtx) {
-    this.#actor = actor;
-    this.#runCtx = runCtx;
-    this.messageDriver = new ActorWorkflowMessageDriver(actor, runCtx);
-  }
-  async get(key) {
-    const [value] = await this.#runCtx.internalKeepAwake(
-      this.#actor.driver.kvBatchGet(this.#actor.id, [
-        makeWorkflowKey(key)
-      ])
-    );
-    return value ?? null;
-  }
-  async set(key, value) {
-    await this.#runCtx.internalKeepAwake(
-      this.#actor.driver.kvBatchPut(this.#actor.id, [
-        [makeWorkflowKey(key), value]
-      ])
-    );
-  }
-  async delete(key) {
-    await this.#runCtx.internalKeepAwake(
-      this.#actor.driver.kvBatchDelete(this.#actor.id, [
-        makeWorkflowKey(key)
-      ])
-    );
+    async function nextBatch(name, opts) {
+      const messages = await self.#inner.queue.nextBatch(name, opts);
+      return messages.map(
+        (message) => self.#toActorQueueMessage(message)
+      );
+    }
+    async function send(name, body) {
+      self.#ensureActorAccess("queue.send");
+      await self.#runCtx.queue.send(name, body);
+    }
+    return {
+      next,
+      nextBatch,
+      send
+    };
   }
-  async deletePrefix(prefix) {
-    const start = makeWorkflowKey(prefix);
-    const end = computeUpperBound(start);
-    if (end) {
-      await this.#runCtx.internalKeepAwake(
-        this.#actor.driver.kvDeleteRange(this.#actor.id, start, end)
+  async step(nameOrConfig, run) {
+    if (typeof nameOrConfig === "string") {
+      if (!run) {
+        throw new Error("Step run function missing");
+      }
+      return await this.#wrapActive(
+        () => this.#inner.step(
+          nameOrConfig,
+          () => this.#withActorAccessAndStateRollback(run)
+        )
       );
-    } else {
-      const entries = await this.#runCtx.internalKeepAwake(
-        this.#actor.driver.kvListPrefix(this.#actor.id, start)
+    }
+    const stepConfig = nameOrConfig;
+    const config = {
+      ...stepConfig,
+      run: () => this.#withActorAccessAndStateRollback(stepConfig.run)
+    };
+    return await this.#wrapActive(() => this.#inner.step(config));
+  }
+  async tryStep(nameOrConfig, run) {
+    if (typeof nameOrConfig === "string") {
+      if (!run) {
+        throw new Error("Step run function missing");
+      }
+      return await this.#wrapActive(
+        () => this.#inner.tryStep(
+          nameOrConfig,
+          () => this.#withActorAccessAndStateRollback(run)
+        )
       );
-      if (entries.length === 0) {
-        return;
+    }
+    const stepConfig = nameOrConfig;
+    const config = {
+      ...stepConfig,
+      run: () => this.#withActorAccessAndStateRollback(stepConfig.run)
+    };
+    return await this.#wrapActive(() => this.#inner.tryStep(config));
+  }
+  async try(nameOrConfig, run) {
+    if (typeof nameOrConfig === "string") {
+      if (!run) {
+        throw new Error("Try run function missing");
       }
-      await this.#runCtx.internalKeepAwake(
-        this.#actor.driver.kvBatchDelete(
-          this.#actor.id,
-          entries.map(([key]) => key)
+      return await this.#wrapActive(
+        () => this.#inner.try(
+          nameOrConfig,
+          async (ctx) => run(this.#createChildContext(ctx))
         )
       );
     }
+    const tryConfig = nameOrConfig;
+    const config = {
+      ...tryConfig,
+      run: async (ctx) => tryConfig.run(this.#createChildContext(ctx))
+    };
+    return await this.#wrapActive(() => this.#inner.try(config));
   }
-  async deleteRange(start, end) {
-    await this.#runCtx.internalKeepAwake(
-      this.#actor.driver.kvDeleteRange(
-        this.#actor.id,
-        makeWorkflowKey(start),
-        makeWorkflowKey(end)
-      )
-    );
+  async loop(nameOrConfig, run) {
+    if (typeof nameOrConfig === "string") {
+      if (!run) {
+        throw new Error("Loop run function missing");
+      }
+      return await this.#wrapActive(
+        () => this.#inner.loop(
+          nameOrConfig,
+          async (ctx) => run(this.#createChildContext(ctx))
+        )
+      );
+    }
+    const wrapped = {
+      ...nameOrConfig,
+      run: async (ctx, state) => nameOrConfig.run(this.#createChildContext(ctx), state)
+    };
+    return await this.#wrapActive(() => this.#inner.loop(wrapped));
   }
-  async list(prefix) {
-    const entries = await this.#runCtx.internalKeepAwake(
-      this.#actor.driver.kvListPrefix(
-        this.#actor.id,
-        makeWorkflowKey(prefix)
-      )
-    );
-    return entries.map(([key, value]) => ({
-      key: stripWorkflowKey(key),
-      value
-    }));
+  sleep(name, durationMs) {
+    return this.#inner.sleep(name, durationMs);
   }
-  async batch(writes) {
-    if (writes.length === 0) return;
-    await this.#runCtx.internalKeepAwake(
-      Promise.all([
-        this.#actor.driver.kvBatchPut(
-          this.#actor.id,
-          writes.map(({ key, value }) => [
-            makeWorkflowKey(key),
-            value
-          ])
-        ),
-        this.#actor.stateManager.saveState({
-          immediate: true
-        })
-      ])
-    );
+  sleepUntil(name, timestampMs) {
+    return this.#inner.sleepUntil(name, timestampMs);
   }
-  async setAlarm(_workflowId, wakeAt) {
-    await this.#runCtx.internalKeepAwake(
-      this.#actor.driver.setAlarm(this.#actor, wakeAt)
-    );
+  destroy() {
+    this.#ensureActorAccess("destroy");
+    this.#runCtx.destroy();
   }
-  async clearAlarm(_workflowId) {
-    return;
+  async rollbackCheckpoint(name) {
+    await this.#wrapActive(() => this.#inner.rollbackCheckpoint(name));
   }
-  waitForMessages(messageNames, abortSignal) {
-    return this.#actor.queueManager.waitForNames(
-      messageNames.length > 0 ? messageNames : void 0,
-      abortSignal
+  async join(name, branches) {
+    const wrappedBranches = Object.fromEntries(
+      Object.entries(branches).map(([key, branch]) => [
+        key,
+        {
+          run: async (ctx) => branch.run(this.#createChildContext(ctx))
+        }
+      ])
+    );
+    return await this.#wrapActive(
+      () => this.#inner.join(name, wrappedBranches)
     );
   }
-};
-var NoopWorkflowMessageDriver = class {
-  async addMessage(_message) {
-    throw new Error("Workflow control driver does not support messages");
+  async race(name, branches) {
+    const wrappedBranches = branches.map((branch) => ({
+      name: branch.name,
+      run: (ctx) => branch.run(this.#createChildContext(ctx))
+    }));
+    return await this.#wrapActive(
+      () => this.#inner.race(name, wrappedBranches)
+    );
   }
-  async receiveMessages(_opts) {
-    throw new Error("Workflow control driver does not support messages");
+  async removed(name, originalType) {
+    await this.#wrapActive(() => this.#inner.removed(name, originalType));
   }
-  async completeMessage(_messageId, _response) {
-    throw new Error("Workflow control driver does not support messages");
+  isEvicted() {
+    return this.#inner.isEvicted();
   }
-};
-var ActorWorkflowControlDriver = class {
-  workerPollInterval = 100;
-  messageDriver = new NoopWorkflowMessageDriver();
-  #actor;
-  constructor(actor) {
-    this.#actor = actor;
+  get state() {
+    this.#ensureActorAccess("state");
+    return this.#runCtx.state;
   }
-  async get(key) {
-    const [value] = await this.#actor.driver.kvBatchGet(this.#actor.id, [
-      makeWorkflowKey(key)
-    ]);
-    return value ?? null;
+  get vars() {
+    this.#ensureActorAccess("vars");
+    return this.#runCtx.vars;
   }
-  async set(key, value) {
-    await this.#actor.driver.kvBatchPut(this.#actor.id, [
-      [makeWorkflowKey(key), value]
-    ]);
+  client() {
+    this.#ensureActorAccess("client");
+    return this.#runCtx.client();
   }
-  async delete(key) {
-    await this.#actor.driver.kvBatchDelete(this.#actor.id, [
-      makeWorkflowKey(key)
-    ]);
+  get db() {
+    this.#ensureActorAccess("db");
+    return this.#runCtx.db;
   }
-  async deletePrefix(prefix) {
-    const start = makeWorkflowKey(prefix);
-    const end = computeUpperBound(start);
-    if (end) {
-      await this.#actor.driver.kvDeleteRange(this.#actor.id, start, end);
-      return;
-    }
-    const entries = await this.#actor.driver.kvListPrefix(
-      this.#actor.id,
-      start
-    );
-    if (entries.length === 0) {
-      return;
-    }
-    await this.#actor.driver.kvBatchDelete(
-      this.#actor.id,
-      entries.map(([key]) => key)
-    );
+  get log() {
+    return this.#runCtx.log;
   }
-  async deleteRange(start, end) {
-    await this.#actor.driver.kvDeleteRange(
-      this.#actor.id,
-      makeWorkflowKey(start),
-      makeWorkflowKey(end)
-    );
+  /** @deprecated No-op. Use `keepAwake(promise)` or `waitUntil(promise)` instead. */
+  setPreventSleep(_prevent) {
+    this.#ensureActorAccess("setPreventSleep");
   }
-  async list(prefix) {
-    const entries = await this.#actor.driver.kvListPrefix(
-      this.#actor.id,
-      makeWorkflowKey(prefix)
-    );
-    return entries.map(([key, value]) => ({
-      key: stripWorkflowKey(key),
-      value
-    }));
+  /** @deprecated No-op. Always returns `false`. */
+  get preventSleep() {
+    this.#ensureActorAccess("preventSleep");
+    return false;
   }
-  async batch(writes) {
-    if (writes.length === 0) {
-      return;
-    }
-    await this.#actor.driver.kvBatchPut(
-      this.#actor.id,
-      writes.map(({ key, value }) => [makeWorkflowKey(key), value])
-    );
+  /**
+   * Holds the actor awake for the duration of the provided promise. The
+   * actor cannot idle-sleep or finalize the sleep grace period until the
+   * promise settles.
+   */
+  keepAwake(promise) {
+    this.#ensureActorAccess("keepAwake");
+    return this.#runCtx.keepAwake(promise);
   }
-  async setAlarm(_workflowId, wakeAt) {
-    await this.#actor.driver.setAlarm(this.#actor, wakeAt);
+  /**
+   * Registers a promise that the sleep grace period will wait on. Use this
+   * for best-effort flush/cleanup work that may complete inside the grace
+   * window. For work the actor must stay running through, prefer
+   * `c.keepAwake(promise)` which also blocks idle sleep.
+   */
+  waitUntil(promise) {
+    this.#ensureActorAccess("waitUntil");
+    this.#runCtx.waitUntil(promise);
   }
-  async clearAlarm(_workflowId) {
-    return;
+  get actorId() {
+    return this.#runCtx.actorId;
   }
-  waitForMessages(_messageNames, _abortSignal) {
-    throw new Error("Workflow control driver does not support messages");
+  broadcast(name, ...args) {
+    this.#ensureActorAccess("broadcast");
+    this.#runCtx.broadcast(
+      name,
+      ...args
+    );
   }
-};
-
-// src/workflow/constants.ts
-var WORKFLOW_GUARD_KV_KEY = "__rivet_actor_workflow_guard_triggered";
-
-// src/workflow/context.ts
-var ActorWorkflowContext = class _ActorWorkflowContext {
-  #inner;
-  #runCtx;
-  #actorAccessDepth = 0;
-  #allowActorAccess = false;
-  #guardViolation = false;
-  constructor(inner, runCtx) {
-    this.#inner = inner;
-    this.#runCtx = runCtx;
+  #toActorQueueMessage(message) {
+    let id;
+    try {
+      id = BigInt(message.id);
+    } catch {
+      throw new Error(`Invalid queue message id "${message.id}"`);
+    }
+    return {
+      id,
+      name: message.name,
+      body: message.body,
+      createdAt: message.createdAt,
+      ...message.complete ? { complete: message.complete } : {}
+    };
   }
-  get workflowId() {
-    return this.#inner.workflowId;
+  async #wrapActive(run) {
+    return await this.#runCtx.internalKeepAwake(run);
   }
-  get abortSignal() {
-    return this.#inner.abortSignal;
+  async #withActorAccess(run) {
+    this.#actorAccessDepth++;
+    if (this.#actorAccessDepth === 1) {
+      this.#allowActorAccess = true;
+    }
+    try {
+      return await run();
+    } finally {
+      this.#actorAccessDepth--;
+      if (this.#actorAccessDepth === 0) {
+        this.#allowActorAccess = false;
+      }
+    }
   }
-  get queue() {
-    const self = this;
-    async function next(name, opts) {
-      const message = await self.#inner.queue.next(name, opts);
-      return self.#toActorQueueMessage(message);
+  async #withActorAccessAndStateRollback(run) {
+    let stateSnapshot = null;
+    try {
+      stateSnapshot = { state: this.#runCtx[RAW_STATE_SYMBOL]() };
+    } catch (error) {
+      this.#runCtx.log.debug({
+        msg: "failed to get state, likely due to being stateless workflow",
+        error
+      });
     }
-    async function nextBatch(name, opts) {
-      const messages = await self.#inner.queue.nextBatch(name, opts);
-      return messages.map(
-        (message) => self.#toActorQueueMessage(message)
-      );
+    if (stateSnapshot) {
+      stateSnapshot.state = structuredClone(stateSnapshot.state);
     }
-    async function send(name, body) {
-      self.#ensureActorAccess("queue.send");
-      await self.#runCtx.queue.send(name, body);
+    const varsSnapshot = structuredClone(this.#runCtx.vars);
+    try {
+      return await this.#withActorAccess(run);
+    } catch (error) {
+      if (stateSnapshot) {
+        this.#runCtx.state = stateSnapshot.state;
+      }
+      this.#runCtx.vars = varsSnapshot;
+      throw error;
     }
-    return {
-      next,
-      nextBatch,
-      send
-    };
   }
-  async step(nameOrConfig, run) {
-    if (typeof nameOrConfig === "string") {
-      if (!run) {
-        throw new Error("Step run function missing");
-      }
-      return await this.#wrapActive(
-        () => this.#inner.step(
-          nameOrConfig,
-          () => this.#withActorAccess(run)
-        )
+  #ensureActorAccess(feature) {
+    if (!this.#allowActorAccess) {
+      this.#guardViolation = true;
+      this.#markGuardTriggered();
+      throw new Error(
+        `${feature} is only available inside workflow steps`
       );
     }
-    const stepConfig = nameOrConfig;
-    const config = {
-      ...stepConfig,
-      run: () => this.#withActorAccess(stepConfig.run)
-    };
-    return await this.#wrapActive(() => this.#inner.step(config));
   }
-  async tryStep(nameOrConfig, run) {
-    if (typeof nameOrConfig === "string") {
-      if (!run) {
-        throw new Error("Step run function missing");
+  consumeGuardViolation() {
+    const violated = this.#guardViolation;
+    this.#guardViolation = false;
+    return violated;
+  }
+  #markGuardTriggered() {
+    try {
+      const state = this.#runCtx.state;
+      if (state && typeof state === "object" && "guardTriggered" in state) {
+        state.guardTriggered = true;
       }
-      return await this.#wrapActive(
-        () => this.#inner.tryStep(
-          nameOrConfig,
-          () => this.#withActorAccess(run)
-        )
-      );
+    } catch {
     }
-    const stepConfig = nameOrConfig;
-    const config = {
-      ...stepConfig,
-      run: () => this.#withActorAccess(stepConfig.run)
-    };
-    return await this.#wrapActive(() => this.#inner.tryStep(config));
+    this.#runCtx.waitUntil(
+      (async () => {
+        try {
+          await this.#runCtx.kv.put(WORKFLOW_GUARD_KV_KEY, "true");
+        } catch (error) {
+          this.#runCtx.log.error({
+            msg: "failed to persist workflow guard flag",
+            error
+          });
+        }
+      })()
+    );
   }
-  async try(nameOrConfig, run) {
-    if (typeof nameOrConfig === "string") {
-      if (!run) {
-        throw new Error("Try run function missing");
-      }
-      return await this.#wrapActive(
-        () => this.#inner.try(
-          nameOrConfig,
-          async (ctx) => run(this.#createChildContext(ctx))
-        )
-      );
+  #createChildContext(ctx) {
+    return new _ActorWorkflowContext(ctx, this.#runCtx);
+  }
+};
+
+// src/workflow/driver.ts
+var WORKFLOW_STORAGE_PREFIX = workflowStoragePrefix();
+function stripWorkflowKey(prefixed) {
+  return prefixed.slice(WORKFLOW_STORAGE_PREFIX.length);
+}
+function computeUpperBound(prefix) {
+  const upperBound = prefix.slice();
+  for (let i = upperBound.length - 1; i >= 0; i--) {
+    if (upperBound[i] !== 255) {
+      upperBound[i]++;
+      return upperBound.slice(0, i + 1);
     }
-    const tryConfig = nameOrConfig;
-    const config = {
-      ...tryConfig,
-      run: async (ctx) => tryConfig.run(this.#createChildContext(ctx))
-    };
-    return await this.#wrapActive(() => this.#inner.try(config));
   }
-  async loop(nameOrConfig, run) {
-    if (typeof nameOrConfig === "string") {
-      if (!run) {
-        throw new Error("Loop run function missing");
-      }
-      return await this.#wrapActive(
-        () => this.#inner.loop(
-          nameOrConfig,
-          async (ctx) => run(this.#createChildContext(ctx))
-        )
-      );
+  return null;
+}
+var ActorWorkflowMessageDriver = class {
+  #actor;
+  #runCtx;
+  constructor(actor, runCtx) {
+    this.#actor = actor;
+    this.#runCtx = runCtx;
+  }
+  async addMessage(message) {
+    await this.#runCtx.internalKeepAwake(
+      this.#actor.queueManager.enqueue(message.name, message.data)
+    );
+  }
+  async receiveMessages(opts) {
+    const messages = await this.#runCtx.internalKeepAwake(
+      this.#actor.queueManager.receive(
+        opts.names && opts.names.length > 0 ? [...opts.names] : void 0,
+        opts.count,
+        0,
+        void 0,
+        opts.completable
+      )
+    );
+    return messages.map((message) => ({
+      id: message.id.toString(),
+      name: message.name,
+      data: message.body,
+      sentAt: message.createdAt,
+      ...opts.completable ? {
+        complete: async (response) => {
+          await this.#runCtx.internalKeepAwake(
+            this.#actor.queueManager.completeMessage(
+              message,
+              response
+            )
+          );
+        }
+      } : {}
+    }));
+  }
+  async completeMessage(messageId, response) {
+    let parsedId;
+    try {
+      parsedId = BigInt(messageId);
+    } catch {
+      return;
     }
-    const wrapped = {
-      ...nameOrConfig,
-      run: async (ctx, state) => nameOrConfig.run(this.#createChildContext(ctx), state)
-    };
-    return await this.#wrapActive(() => this.#inner.loop(wrapped));
+    await this.#runCtx.internalKeepAwake(
+      this.#actor.queueManager.completeMessageById(parsedId, response)
+    );
   }
-  sleep(name, durationMs) {
-    return this.#inner.sleep(name, durationMs);
+};
+var ActorWorkflowDriver = class {
+  workerPollInterval = 100;
+  messageDriver;
+  #actor;
+  #runCtx;
+  constructor(actor, runCtx) {
+    this.#actor = actor;
+    this.#runCtx = runCtx;
+    this.messageDriver = new ActorWorkflowMessageDriver(actor, runCtx);
   }
-  sleepUntil(name, timestampMs) {
-    return this.#inner.sleepUntil(name, timestampMs);
+  async get(key) {
+    const [value] = await this.#runCtx.internalKeepAwake(
+      this.#actor.driver.kvBatchGet(this.#actor.id, [
+        makeWorkflowKey(key)
+      ])
+    );
+    return value ?? null;
+  }
+  async set(key, value) {
+    await this.#runCtx.internalKeepAwake(
+      this.#actor.driver.kvBatchPut(this.#actor.id, [
+        [makeWorkflowKey(key), value]
+      ])
+    );
+  }
+  async delete(key) {
+    await this.#runCtx.internalKeepAwake(
+      this.#actor.driver.kvBatchDelete(this.#actor.id, [
+        makeWorkflowKey(key)
+      ])
+    );
+  }
+  async deletePrefix(prefix) {
+    const start = makeWorkflowKey(prefix);
+    const end = computeUpperBound(start);
+    if (end) {
+      await this.#runCtx.internalKeepAwake(
+        this.#actor.driver.kvDeleteRange(this.#actor.id, start, end)
+      );
+    } else {
+      const entries = await this.#runCtx.internalKeepAwake(
+        this.#actor.driver.kvListPrefix(this.#actor.id, start)
+      );
+      if (entries.length === 0) {
+        return;
+      }
+      await this.#runCtx.internalKeepAwake(
+        this.#actor.driver.kvBatchDelete(
+          this.#actor.id,
+          entries.map(([key]) => key)
+        )
+      );
+    }
   }
-  destroy() {
-    this.#ensureActorAccess("destroy");
-    this.#runCtx.destroy();
+  async deleteRange(start, end) {
+    await this.#runCtx.internalKeepAwake(
+      this.#actor.driver.kvDeleteRange(
+        this.#actor.id,
+        makeWorkflowKey(start),
+        makeWorkflowKey(end)
+      )
+    );
   }
-  async rollbackCheckpoint(name) {
-    await this.#wrapActive(() => this.#inner.rollbackCheckpoint(name));
+  async list(prefix) {
+    const entries = await this.#runCtx.internalKeepAwake(
+      this.#actor.driver.kvListPrefix(
+        this.#actor.id,
+        makeWorkflowKey(prefix)
+      )
+    );
+    return entries.map(([key, value]) => ({
+      key: stripWorkflowKey(key),
+      value
+    }));
   }
-  async join(name, branches) {
-    const wrappedBranches = Object.fromEntries(
-      Object.entries(branches).map(([key, branch]) => [
-        key,
-        {
-          run: async (ctx) => branch.run(this.#createChildContext(ctx))
-        }
+  async batch(writes) {
+    if (writes.length === 0) return;
+    await this.#runCtx.internalKeepAwake(
+      Promise.all([
+        this.#actor.driver.kvBatchPut(
+          this.#actor.id,
+          writes.map(({ key, value }) => [
+            makeWorkflowKey(key),
+            value
+          ])
+        ),
+        this.#actor.stateManager.saveState({
+          immediate: true
+        })
       ])
     );
-    return await this.#wrapActive(
-      () => this.#inner.join(name, wrappedBranches)
-    );
   }
-  async race(name, branches) {
-    const wrappedBranches = branches.map((branch) => ({
-      name: branch.name,
-      run: (ctx) => branch.run(this.#createChildContext(ctx))
-    }));
-    return await this.#wrapActive(
-      () => this.#inner.race(name, wrappedBranches)
+  async setAlarm(_workflowId, wakeAt) {
+    await this.#runCtx.internalKeepAwake(
+      this.#actor.driver.setAlarm(this.#actor, wakeAt)
     );
   }
-  async removed(name, originalType) {
-    await this.#wrapActive(() => this.#inner.removed(name, originalType));
-  }
-  isEvicted() {
-    return this.#inner.isEvicted();
-  }
-  get state() {
-    this.#ensureActorAccess("state");
-    return this.#runCtx.state;
-  }
-  get vars() {
-    this.#ensureActorAccess("vars");
-    return this.#runCtx.vars;
+  async clearAlarm(_workflowId) {
+    return;
   }
-  client() {
-    this.#ensureActorAccess("client");
-    return this.#runCtx.client();
+  waitForMessages(messageNames, abortSignal) {
+    return this.#actor.queueManager.waitForNames(
+      messageNames.length > 0 ? messageNames : void 0,
+      abortSignal
+    );
   }
-  get db() {
-    this.#ensureActorAccess("db");
-    return this.#runCtx.db;
+};
+var NoopWorkflowMessageDriver = class {
+  async addMessage(_message) {
+    throw new Error("Workflow control driver does not support messages");
   }
-  get log() {
-    return this.#runCtx.log;
+  async receiveMessages(_opts) {
+    throw new Error("Workflow control driver does not support messages");
   }
-  /** @deprecated No-op. Use `keepAwake(promise)` or `waitUntil(promise)` instead. */
-  setPreventSleep(_prevent) {
-    this.#ensureActorAccess("setPreventSleep");
+  async completeMessage(_messageId, _response) {
+    throw new Error("Workflow control driver does not support messages");
   }
-  /** @deprecated No-op. Always returns `false`. */
-  get preventSleep() {
-    this.#ensureActorAccess("preventSleep");
-    return false;
+};
+var ActorWorkflowControlDriver = class {
+  workerPollInterval = 100;
+  messageDriver = new NoopWorkflowMessageDriver();
+  #actor;
+  constructor(actor) {
+    this.#actor = actor;
   }
-  /**
-   * Holds the actor awake for the duration of the provided promise. The
-   * actor cannot idle-sleep or finalize the sleep grace period until the
-   * promise settles.
-   */
-  keepAwake(promise) {
-    this.#ensureActorAccess("keepAwake");
-    return this.#runCtx.keepAwake(promise);
+  async get(key) {
+    const [value] = await this.#actor.driver.kvBatchGet(this.#actor.id, [
+      makeWorkflowKey(key)
+    ]);
+    return value ?? null;
   }
-  /**
-   * Registers a promise that the sleep grace period will wait on. Use this
-   * for best-effort flush/cleanup work that may complete inside the grace
-   * window. For work the actor must stay running through, prefer
-   * `c.keepAwake(promise)` which also blocks idle sleep.
-   */
-  waitUntil(promise) {
-    this.#ensureActorAccess("waitUntil");
-    this.#runCtx.waitUntil(promise);
+  async set(key, value) {
+    await this.#actor.driver.kvBatchPut(this.#actor.id, [
+      [makeWorkflowKey(key), value]
+    ]);
   }
-  get actorId() {
-    return this.#runCtx.actorId;
+  async delete(key) {
+    await this.#actor.driver.kvBatchDelete(this.#actor.id, [
+      makeWorkflowKey(key)
+    ]);
   }
-  broadcast(name, ...args) {
-    this.#ensureActorAccess("broadcast");
-    this.#runCtx.broadcast(
-      name,
-      ...args
+  async deletePrefix(prefix) {
+    const start = makeWorkflowKey(prefix);
+    const end = computeUpperBound(start);
+    if (end) {
+      await this.#actor.driver.kvDeleteRange(this.#actor.id, start, end);
+      return;
+    }
+    const entries = await this.#actor.driver.kvListPrefix(
+      this.#actor.id,
+      start
     );
-  }
-  #toActorQueueMessage(message) {
-    let id;
-    try {
-      id = BigInt(message.id);
-    } catch {
-      throw new Error(`Invalid queue message id "${message.id}"`);
+    if (entries.length === 0) {
+      return;
     }
-    return {
-      id,
-      name: message.name,
-      body: message.body,
-      createdAt: message.createdAt,
-      ...message.complete ? { complete: message.complete } : {}
-    };
+    await this.#actor.driver.kvBatchDelete(
+      this.#actor.id,
+      entries.map(([key]) => key)
+    );
   }
-  async #wrapActive(run) {
-    return await this.#runCtx.internalKeepAwake(run);
+  async deleteRange(start, end) {
+    await this.#actor.driver.kvDeleteRange(
+      this.#actor.id,
+      makeWorkflowKey(start),
+      makeWorkflowKey(end)
+    );
   }
-  async #withActorAccess(run) {
-    this.#actorAccessDepth++;
-    if (this.#actorAccessDepth === 1) {
-      this.#allowActorAccess = true;
-    }
-    try {
-      return await run();
-    } finally {
-      this.#actorAccessDepth--;
-      if (this.#actorAccessDepth === 0) {
-        this.#allowActorAccess = false;
-      }
-    }
+  async list(prefix) {
+    const entries = await this.#actor.driver.kvListPrefix(
+      this.#actor.id,
+      makeWorkflowKey(prefix)
+    );
+    return entries.map(([key, value]) => ({
+      key: stripWorkflowKey(key),
+      value
+    }));
   }
-  #ensureActorAccess(feature) {
-    if (!this.#allowActorAccess) {
-      this.#guardViolation = true;
-      this.#markGuardTriggered();
-      throw new Error(
-        `${feature} is only available inside workflow steps`
-      );
+  async batch(writes) {
+    if (writes.length === 0) {
+      return;
     }
+    await this.#actor.driver.kvBatchPut(
+      this.#actor.id,
+      writes.map(({ key, value }) => [makeWorkflowKey(key), value])
+    );
   }
-  consumeGuardViolation() {
-    const violated = this.#guardViolation;
-    this.#guardViolation = false;
-    return violated;
+  async setAlarm(_workflowId, wakeAt) {
+    await this.#actor.driver.setAlarm(this.#actor, wakeAt);
   }
-  #markGuardTriggered() {
-    try {
-      const state = this.#runCtx.state;
-      if (state && typeof state === "object" && "guardTriggered" in state) {
-        state.guardTriggered = true;
-      }
-    } catch {
-    }
-    this.#runCtx.waitUntil(
-      (async () => {
-        try {
-          await this.#runCtx.kv.put(WORKFLOW_GUARD_KV_KEY, "true");
-        } catch (error) {
-          this.#runCtx.log.error({
-            msg: "failed to persist workflow guard flag",
-            error
-          });
-        }
-      })()
-    );
+  async clearAlarm(_workflowId) {
+    return;
   }
-  #createChildContext(ctx) {
-    return new _ActorWorkflowContext(ctx, this.#runCtx);
+  waitForMessages(_messageNames, _abortSignal) {
+    throw new Error("Workflow control driver does not support messages");
   }
 };