bitfab 0.54.11 → 0.54.13

package/dist/index.d.cts

@@ -557,7 +557,6 @@ declare class HttpClient {
      * Blocks until complete - needed for function execution.
      */
     lookupFunction<T>(name: string): Promise<T>;
-    getAutoTracePolicy<T>(traceFunctionKey: string, protocol: string): Promise<T>;
     getSimulationPlan(): Promise<SimulationPlanResponse>;
     getTraceSpan(traceId: string, lookup: SpanLookup): Promise<CapturedSpan | null>;
     /**
@@ -2214,18 +2213,18 @@ declare const RIVET_GROUP_EFFECT_METHODS: {
     readonly queue: readonly ["send", "next", "nextBatch", "waitForNames", "waitForAvailable", "complete", "enqueueAndWait", "tryNext", "tryNextBatch"];
     readonly run: readonly ["setWakeAt"];
 };
-declare const RIVET_TOP_LEVEL_EFFECTS: readonly ["broadcast", "saveState", "sleep", "destroy"];
+declare const RIVET_TOP_LEVEL_EFFECTS: readonly ["broadcast", "saveState", "sleep", "destroy", "step", "tryStep", "try", "loop", "sleepUntil", "rollbackCheckpoint", "join", "race", "removed", "getVersion"];
 type RivetGroup = keyof typeof RIVET_GROUP_EFFECT_METHODS;
 type RivetGroupEffectType = {
     [TGroup in RivetGroup]: `${TGroup}.${(typeof RIVET_GROUP_EFFECT_METHODS)[TGroup][number]}`;
 }[RivetGroup];
-/** Finite Rivet context operations supported as replay effects. */
+/** Rivet context operations supported as replay effects. */
 type RivetEffectType = RivetGroupEffectType | (typeof RIVET_TOP_LEVEL_EFFECTS)[number] | "db.transaction.execute" | "queue.message.complete";
 /** Configuration for {@link BitfabRivetIntegration}. */
 interface RivetIntegrationOptions {
     /**
      * Context operations whose recorded outputs replay should serve instead of
-     * executing against a live actor. Nothing is marked by default.
+     * executing against a live actor or workflow. Nothing is marked by default.
      */
     mockOnReplay?: readonly RivetEffectType[];
 }
@@ -2246,8 +2245,8 @@ interface RivetIntegrationRuntime {
     recordRootFixture(context: Record<string, unknown>, recordedRoots: Set<string>): void;
 }
 /**
- * Binds a live Rivet actor context to an existing traced function and exposes
- * replay-aware proxies for supported context operations.
+ * Binds a live Rivet actor or workflow context to an existing traced function
+ * and exposes replay-aware proxies for supported context operations.
  *
  * The integration never creates a trace root. Use it with the same
  * `BitfabFunction` handle whose `withTrace()` wrapper is the production and
@@ -2267,13 +2266,15 @@ declare class BitfabRivetIntegration<TContext extends object = RivetContextLike>
     withContext<TReturn>(context: TContext, fn: () => TReturn): TReturn;
     /**
      * Adapt a traced function into a Rivet handler whose first argument is the
-     * live actor context. The context is not added to the traced root's inputs.
+     * live actor or workflow context. The context is not added to the traced
+     * root's inputs.
      */
     bind<This, TArgs extends unknown[], TReturn>(fn: (this: This, ...args: TArgs) => TReturn): (this: This, context: TContext, ...args: TArgs) => TReturn;
     /**
      * Return the current Rivet context proxy. In production it delegates to the
      * bound live context. During replay it hydrates recorded actor state and
-     * intercepts supported effects without requiring a live Rivet actor.
+     * intercepts supported effects without requiring a live Rivet actor or
+     * workflow.
      */
     getContext(): TContext;
     private createContextProxy;
@@ -2902,7 +2903,6 @@ declare class Bitfab {
     readonly graders: GradersClient;
     private readonly bamlClient;
     private readonly dbSnapshot;
-    private readonly autoTracePolicyRefreshes;
     private readonly simulationPlan;
     /**
      * Mock overrides registered via {@link Bitfab.registerMockOverride}, applied
@@ -2921,12 +2921,12 @@ declare class Bitfab {
      *
      * Build instrumentation turns repository functions called beneath this
      * method into nested spans that capture inputs, outputs, and errors by
-     * default. A confirmed capture policy can narrow rich capture to selected
-     * function IDs.
+     * default. Source exclusions and sim-plan capture-off decisions are explicit
+     * opt-outs from that default.
      * Without a compatible build transform, this still records the decorated
      * method as a normal rich root span but cannot discover child calls.
      *
-     * @param traceFunctionKey - Groups traces and their capture policy.
+     * @param traceFunctionKey - Groups traces and their capture controls.
      * @param options - Root presentation, subtree bounds, and exclusions.
      * @experimental Automatic child-call instrumentation is experimental.
      */
@@ -2937,11 +2937,11 @@ declare class Bitfab {
      * This is the function-oriented equivalent of {@link Bitfab.trace}. Build
      * instrumentation turns repository functions called beneath the wrapped
      * function into nested spans that capture inputs, outputs, and errors by
-     * default. A confirmed capture policy can narrow rich capture to selected
-     * function IDs. Without a compatible transform, this still records one
-     * normal rich root span and runs the function unchanged.
+     * default. Source exclusions and sim-plan capture-off decisions are explicit
+     * opt-outs from that default. Without a compatible transform, this still
+     * records one normal rich root span and runs the function unchanged.
      *
-     * @param traceFunctionKey - Groups traces and their capture policy.
+     * @param traceFunctionKey - Groups traces and their capture controls.
      * @param optionsOrFn - Options or the workflow entrypoint to wrap.
      * @param maybeFn - Workflow entrypoint when options are provided.
      * @experimental Automatic child-call instrumentation is experimental.
@@ -2980,7 +2980,6 @@ declare class Bitfab {
     private createAutoTraceNode;
     private createAutoTraceRoot;
     private applySimulationPlan;
-    private refreshAutoTraceCapturePolicy;
     /**
      * Flush and permanently close this client's tracing resources: its pending
      * requests and the single span-transport worker shared by its decorators and
@@ -3123,9 +3122,9 @@ declare class Bitfab {
      */
     getLangGraphIntegration(traceFunctionKey: string, options?: LangGraphIntegrationOptions): BitfabLangGraphIntegration;
     /**
-     * Get the first-class Rivet actor-context integration for an existing trace
-     * root. The integration binds context and records effect spans; it never
-     * creates another root.
+     * Get the first-class Rivet actor/workflow-context integration for an
+     * existing trace root. The integration binds context and records effect
+     * spans; it never creates another root.
      *
      * @param traceFunctionKey - Key used by the enclosing `withTrace()` root
      * @param options - Explicit per-context-path replay mocking policy
@@ -3602,7 +3601,7 @@ interface CommitRef {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.54.11";
+declare const __version__ = "0.54.13";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.d.ts

@@ -557,7 +557,6 @@ declare class HttpClient {
      * Blocks until complete - needed for function execution.
      */
     lookupFunction<T>(name: string): Promise<T>;
-    getAutoTracePolicy<T>(traceFunctionKey: string, protocol: string): Promise<T>;
     getSimulationPlan(): Promise<SimulationPlanResponse>;
     getTraceSpan(traceId: string, lookup: SpanLookup): Promise<CapturedSpan | null>;
     /**
@@ -2214,18 +2213,18 @@ declare const RIVET_GROUP_EFFECT_METHODS: {
     readonly queue: readonly ["send", "next", "nextBatch", "waitForNames", "waitForAvailable", "complete", "enqueueAndWait", "tryNext", "tryNextBatch"];
     readonly run: readonly ["setWakeAt"];
 };
-declare const RIVET_TOP_LEVEL_EFFECTS: readonly ["broadcast", "saveState", "sleep", "destroy"];
+declare const RIVET_TOP_LEVEL_EFFECTS: readonly ["broadcast", "saveState", "sleep", "destroy", "step", "tryStep", "try", "loop", "sleepUntil", "rollbackCheckpoint", "join", "race", "removed", "getVersion"];
 type RivetGroup = keyof typeof RIVET_GROUP_EFFECT_METHODS;
 type RivetGroupEffectType = {
     [TGroup in RivetGroup]: `${TGroup}.${(typeof RIVET_GROUP_EFFECT_METHODS)[TGroup][number]}`;
 }[RivetGroup];
-/** Finite Rivet context operations supported as replay effects. */
+/** Rivet context operations supported as replay effects. */
 type RivetEffectType = RivetGroupEffectType | (typeof RIVET_TOP_LEVEL_EFFECTS)[number] | "db.transaction.execute" | "queue.message.complete";
 /** Configuration for {@link BitfabRivetIntegration}. */
 interface RivetIntegrationOptions {
     /**
      * Context operations whose recorded outputs replay should serve instead of
-     * executing against a live actor. Nothing is marked by default.
+     * executing against a live actor or workflow. Nothing is marked by default.
      */
     mockOnReplay?: readonly RivetEffectType[];
 }
@@ -2246,8 +2245,8 @@ interface RivetIntegrationRuntime {
     recordRootFixture(context: Record<string, unknown>, recordedRoots: Set<string>): void;
 }
 /**
- * Binds a live Rivet actor context to an existing traced function and exposes
- * replay-aware proxies for supported context operations.
+ * Binds a live Rivet actor or workflow context to an existing traced function
+ * and exposes replay-aware proxies for supported context operations.
  *
  * The integration never creates a trace root. Use it with the same
  * `BitfabFunction` handle whose `withTrace()` wrapper is the production and
@@ -2267,13 +2266,15 @@ declare class BitfabRivetIntegration<TContext extends object = RivetContextLike>
     withContext<TReturn>(context: TContext, fn: () => TReturn): TReturn;
     /**
      * Adapt a traced function into a Rivet handler whose first argument is the
-     * live actor context. The context is not added to the traced root's inputs.
+     * live actor or workflow context. The context is not added to the traced
+     * root's inputs.
      */
     bind<This, TArgs extends unknown[], TReturn>(fn: (this: This, ...args: TArgs) => TReturn): (this: This, context: TContext, ...args: TArgs) => TReturn;
     /**
      * Return the current Rivet context proxy. In production it delegates to the
      * bound live context. During replay it hydrates recorded actor state and
-     * intercepts supported effects without requiring a live Rivet actor.
+     * intercepts supported effects without requiring a live Rivet actor or
+     * workflow.
      */
     getContext(): TContext;
     private createContextProxy;
@@ -2902,7 +2903,6 @@ declare class Bitfab {
     readonly graders: GradersClient;
     private readonly bamlClient;
     private readonly dbSnapshot;
-    private readonly autoTracePolicyRefreshes;
     private readonly simulationPlan;
     /**
      * Mock overrides registered via {@link Bitfab.registerMockOverride}, applied
@@ -2921,12 +2921,12 @@ declare class Bitfab {
      *
      * Build instrumentation turns repository functions called beneath this
      * method into nested spans that capture inputs, outputs, and errors by
-     * default. A confirmed capture policy can narrow rich capture to selected
-     * function IDs.
+     * default. Source exclusions and sim-plan capture-off decisions are explicit
+     * opt-outs from that default.
      * Without a compatible build transform, this still records the decorated
      * method as a normal rich root span but cannot discover child calls.
      *
-     * @param traceFunctionKey - Groups traces and their capture policy.
+     * @param traceFunctionKey - Groups traces and their capture controls.
      * @param options - Root presentation, subtree bounds, and exclusions.
      * @experimental Automatic child-call instrumentation is experimental.
      */
@@ -2937,11 +2937,11 @@ declare class Bitfab {
      * This is the function-oriented equivalent of {@link Bitfab.trace}. Build
      * instrumentation turns repository functions called beneath the wrapped
      * function into nested spans that capture inputs, outputs, and errors by
-     * default. A confirmed capture policy can narrow rich capture to selected
-     * function IDs. Without a compatible transform, this still records one
-     * normal rich root span and runs the function unchanged.
+     * default. Source exclusions and sim-plan capture-off decisions are explicit
+     * opt-outs from that default. Without a compatible transform, this still
+     * records one normal rich root span and runs the function unchanged.
      *
-     * @param traceFunctionKey - Groups traces and their capture policy.
+     * @param traceFunctionKey - Groups traces and their capture controls.
      * @param optionsOrFn - Options or the workflow entrypoint to wrap.
      * @param maybeFn - Workflow entrypoint when options are provided.
      * @experimental Automatic child-call instrumentation is experimental.
@@ -2980,7 +2980,6 @@ declare class Bitfab {
     private createAutoTraceNode;
     private createAutoTraceRoot;
     private applySimulationPlan;
-    private refreshAutoTraceCapturePolicy;
     /**
      * Flush and permanently close this client's tracing resources: its pending
      * requests and the single span-transport worker shared by its decorators and
@@ -3123,9 +3122,9 @@ declare class Bitfab {
      */
     getLangGraphIntegration(traceFunctionKey: string, options?: LangGraphIntegrationOptions): BitfabLangGraphIntegration;
     /**
-     * Get the first-class Rivet actor-context integration for an existing trace
-     * root. The integration binds context and records effect spans; it never
-     * creates another root.
+     * Get the first-class Rivet actor/workflow-context integration for an
+     * existing trace root. The integration binds context and records effect
+     * spans; it never creates another root.
      *
      * @param traceFunctionKey - Key used by the enclosing `withTrace()` root
      * @param options - Explicit per-context-path replay mocking policy
@@ -3602,7 +3601,7 @@ interface CommitRef {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.54.11";
+declare const __version__ = "0.54.13";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.js

@@ -30,8 +30,8 @@ import {
   getCurrentTrace,
   reseedFromRegistry,
   seedFromRegistry
-} from "./chunk-MEJOPEKV.js";
-import "./chunk-EGWJYCNT.js";
+} from "./chunk-Q7HDNYYY.js";
+import "./chunk-RCHSYWKI.js";
 import {
   BITFAB_PROGRESS_PREFIX,
   DbBranchReplayError,
@@ -39,7 +39,7 @@ import {
   ReplayError,
   reportReplayProgress,
   serializeReplayResult
-} from "./chunk-G4LWALQ7.js";
+} from "./chunk-FZNRSEMN.js";
 import {
   BitfabError,
   DEFAULT_SERVICE_URL,
@@ -47,7 +47,7 @@ import {
   MixedTracingError,
   __version__,
   flushTraces
-} from "./chunk-FMUJONTQ.js";
+} from "./chunk-YKOD4GWI.js";
 import "./chunk-VCRFFCLY.js";
 export {
   AssertionCategoriesClient,

package/dist/node.cjs

@@ -97,7 +97,7 @@ var __version__, __packageName__;
 var init_version_generated = __esm({
   "src/version.generated.ts"() {
     "use strict";
-    __version__ = "0.54.11";
+    __version__ = "0.54.13";
     __packageName__ = "bitfab";
   }
 });
@@ -2673,12 +2673,6 @@ var init_http = __esm({
       async lookupFunction(name) {
         return this.request("/api/sdk/functions/lookup", { name });
       }
-      async getAutoTracePolicy(traceFunctionKey, protocol) {
-        return this.request("/api/sdk/auto-trace/policy", {
-          traceFunctionKey,
-          protocol
-        });
-      }
       async getSimulationPlan() {
         return this.get(
           "/api/sdk/sim-plan",
@@ -5209,21 +5203,6 @@ function currentAutoTraceScope() {
   initializeAutoTraceStorage();
   return autoTraceState.storage?.getStore() ?? autoTraceState.browserScope;
 }
-function __setBitfabAutoTraceCapturePolicy(client, traceFunctionKey, functionIds) {
-  const policies = autoTraceState.capturePolicies.get(client) ?? /* @__PURE__ */ new Map();
-  if (functionIds === void 0) {
-    policies.delete(traceFunctionKey);
-    if (policies.size === 0) {
-      autoTraceState.capturePolicies.delete(client);
-    }
-    return;
-  }
-  policies.set(traceFunctionKey, new Set(functionIds));
-  autoTraceState.capturePolicies.set(client, policies);
-}
-function getAutoTraceCapturePolicy(client, traceFunctionKey) {
-  return autoTraceState.capturePolicies.get(client)?.get(traceFunctionKey);
-}
 
 // src/optionalPeer.ts
 function importOptionalPeer(specifierParts) {
@@ -7072,7 +7051,6 @@ function openAiAgentsParentSpanId(bitfabTraceId, enclosingSpanIds) {
 }
 
 // src/client.ts
-init_policyRefresh();
 init_randomUuid();
 init_replay();
 
@@ -7220,18 +7198,42 @@ var RIVET_TOP_LEVEL_EFFECTS = [
   "broadcast",
   "saveState",
   "sleep",
-  "destroy"
+  "destroy",
+  "step",
+  "tryStep",
+  "try",
+  "loop",
+  "sleepUntil",
+  "rollbackCheckpoint",
+  "join",
+  "race",
+  "removed",
+  "getVersion"
 ];
 var TOP_LEVEL_UNAVAILABLE_CAPABILITIES = /* @__PURE__ */ new Set([
   "conn",
   "conns",
-  "log",
   "request",
   "actorRuntimeSocket",
   "keepAwake",
   "waitUntil",
   "client"
 ]);
+var replayLog = () => void 0;
+var replayLogger = {
+  level: "silent",
+  msgPrefix: void 0,
+  fatal: replayLog,
+  trace: replayLog,
+  silent: replayLog,
+  debug: replayLog,
+  info: replayLog,
+  warn: replayLog,
+  error: replayLog,
+  child: () => replayLogger,
+  bindings: () => ({}),
+  isLevelEnabled: () => false
+};
 var SYNC_VOID_EFFECTS = /* @__PURE__ */ new Set([
   "broadcast",
   "sleep",
@@ -7261,16 +7263,28 @@ function snapshotContext(context) {
     "state",
     "vars",
     "actorId",
+    "workflowId",
     "name",
     "key",
-    "region",
-    "aborted"
+    "region"
   ]) {
     const value = readProperty(source, property);
     if (value !== void 0) {
       snapshot[property] = value;
     }
   }
+  const aborted = readProperty(source, "aborted");
+  if (typeof aborted === "boolean") {
+    snapshot.aborted = aborted;
+  } else {
+    const abortSignal = readProperty(source, "abortSignal");
+    if (isRecord5(abortSignal)) {
+      const signalAborted = readProperty(abortSignal, "aborted");
+      if (typeof signalAborted === "boolean") {
+        snapshot.aborted = signalAborted;
+      }
+    }
+  }
   return snapshot;
 }
 function unavailableCapability(path) {
@@ -7362,7 +7376,8 @@ var BitfabRivetIntegration = class {
   }
   /**
    * Adapt a traced function into a Rivet handler whose first argument is the
-   * live actor context. The context is not added to the traced root's inputs.
+   * live actor or workflow context. The context is not added to the traced
+   * root's inputs.
    */
   bind(fn) {
     const integration = this;
@@ -7373,7 +7388,8 @@ var BitfabRivetIntegration = class {
   /**
    * Return the current Rivet context proxy. In production it delegates to the
    * bound live context. During replay it hydrates recorded actor state and
-   * intercepts supported effects without requiring a live Rivet actor.
+   * intercepts supported effects without requiring a live Rivet actor or
+   * workflow.
    */
   getContext() {
     const replay2 = getReplayContext();
@@ -7457,6 +7473,12 @@ var BitfabRivetIntegration = class {
         if (property === "setPreventSleep" && replay2) {
           return (_preventSleep) => void 0;
         }
+        if (property === "isEvicted" && replay2) {
+          return () => replayTarget.abortSignal?.aborted === true;
+        }
+        if (property === "log" && replay2) {
+          return replayLogger;
+        }
         if (replay2 && typeof property === "string" && TOP_LEVEL_UNAVAILABLE_CAPABILITIES.has(property)) {
           throw unavailableCapability(property);
         }
@@ -7630,7 +7652,7 @@ var BitfabRivetIntegration = class {
     return { ...value, complete };
   }
   queueCallIsCompletable(effect, args) {
-    const options = effect === "queue.waitForNames" ? args[1] : args[0];
+    const options = effect === "queue.waitForNames" || (effect === "queue.next" || effect === "queue.nextBatch") && typeof args[0] === "string" ? args[1] : args[0];
     return isRecord5(options) && options.completable === true;
   }
   createQueueIterator(queue, options) {
@@ -8612,8 +8634,6 @@ function readBooleanEnv(name) {
 var DEFAULT_AUTO_TRACE_MAX_DEPTH = 30;
 var DEFAULT_AUTO_TRACE_MAX_SPANS = 500;
 var AUTO_TRACE_PROTOCOL = "ts-auto-v1";
-var AUTO_TRACE_POLICY_REFRESH_MS = 6e4;
-var AUTO_TRACE_POLICY_RETRY_MS = 1e4;
 function spanOwnerName(receiver) {
   if (typeof receiver === "function") {
     return receiver.name !== "" ? receiver.name : void 0;
@@ -8646,7 +8666,6 @@ var Bitfab = class {
   constructor(config) {
     /** Gate the empty-key warning to fire at most once. */
     this.apiKeyWarned = false;
-    this.autoTracePolicyRefreshes = /* @__PURE__ */ new Map();
     /**
      * Mock overrides registered via {@link Bitfab.registerMockOverride}, applied
      * to every `replay` on this client (after any per-call `mockOverride`). In
@@ -8695,12 +8714,12 @@ var Bitfab = class {
    *
    * Build instrumentation turns repository functions called beneath this
    * method into nested spans that capture inputs, outputs, and errors by
-   * default. A confirmed capture policy can narrow rich capture to selected
-   * function IDs.
+   * default. Source exclusions and sim-plan capture-off decisions are explicit
+   * opt-outs from that default.
    * Without a compatible build transform, this still records the decorated
    * method as a normal rich root span but cannot discover child calls.
    *
-   * @param traceFunctionKey - Groups traces and their capture policy.
+   * @param traceFunctionKey - Groups traces and their capture controls.
    * @param options - Root presentation, subtree bounds, and exclusions.
    * @experimental Automatic child-call instrumentation is experimental.
    */
@@ -8858,11 +8877,6 @@ var Bitfab = class {
       traceFunctionKey,
       spanOptions,
       function(...args) {
-        const capturePolicy = getAutoTraceCapturePolicy(
-          self,
-          traceFunctionKey
-        );
-        self.refreshAutoTraceCapturePolicy(traceFunctionKey);
         self.simulationPlan.refresh();
         let spansUsed = 0;
         let truncated = false;
@@ -8942,7 +8956,7 @@ var Bitfab = class {
               surface: "opt-out",
               instrumentation: "trace",
               functionId: definition.id,
-              captureContent: nodeConfiguration !== void 0 || capturePolicy === void 0 || capturePolicy.has(definition.id),
+              captureContent: true,
               autoTraceDefinition: definition,
               ...nodeConfiguration?.testRunId !== void 0 && {
                 testRunId: nodeConfiguration.testRunId
@@ -9041,34 +9055,6 @@ var Bitfab = class {
   applySimulationPlan(payload, submit) {
     this.simulationPlan.send(payload, rootTraceFunctionKeyOf(payload), submit);
   }
-  refreshAutoTraceCapturePolicy(traceFunctionKey) {
-    const state2 = this.autoTracePolicyRefreshes.get(traceFunctionKey) ?? new PolicyRefresh();
-    this.autoTracePolicyRefreshes.set(traceFunctionKey, state2);
-    state2.run(
-      () => this.httpClient.getAutoTracePolicy(
-        traceFunctionKey,
-        AUTO_TRACE_PROTOCOL
-      ),
-      (policy) => {
-        if (policy.protocol !== AUTO_TRACE_PROTOCOL) {
-          state2.hold(AUTO_TRACE_POLICY_RETRY_MS);
-          return;
-        }
-        const functionIds = Array.isArray(policy.functionIds) ? policy.functionIds.filter(
-          (id) => typeof id === "string" && id.startsWith(`${AUTO_TRACE_PROTOCOL}:`)
-        ).slice(0, DEFAULT_AUTO_TRACE_MAX_SPANS) : [];
-        __setBitfabAutoTraceCapturePolicy(
-          this,
-          traceFunctionKey,
-          policy.revision === null ? void 0 : functionIds
-        );
-        state2.hold(AUTO_TRACE_POLICY_REFRESH_MS);
-      },
-      () => {
-        state2.hold(AUTO_TRACE_POLICY_RETRY_MS);
-      }
-    );
-  }
   /**
    * Flush and permanently close this client's tracing resources: its pending
    * requests and the single span-transport worker shared by its decorators and
@@ -9371,9 +9357,9 @@ var Bitfab = class {
     });
   }
   /**
-   * Get the first-class Rivet actor-context integration for an existing trace
-   * root. The integration binds context and records effect spans; it never
-   * creates another root.
+   * Get the first-class Rivet actor/workflow-context integration for an
+   * existing trace root. The integration binds context and records effect
+   * spans; it never creates another root.
    *
    * @param traceFunctionKey - Key used by the enclosing `withTrace()` root
    * @param options - Explicit per-context-path replay mocking policy