@dudousxd/nestjs-agent 0.4.0 → 0.4.1

package/dist/durable/index.d.cts

@@ -5,7 +5,10 @@ import { WorkflowService } from '@dudousxd/nestjs-durable';
 import { DynamicModule } from '@nestjs/common';
 
 /**
- * The agent turn AS a durable workflow. Each model/tool call is a checkpointed `ctx.step`, HITL is
+ * The agent turn AS a durable workflow. Each model/tool call is a checkpointed `ctx.localStep` — the
+ * in-process primitive, NOT the always-dispatched `ctx.step`: the loop's deps (model provider, store,
+ * sink) live in THIS workflow worker's DI, and the step names are dynamic checkpoint identities
+ * (`llm:0`, `persist:toolcall:<id>`), not routable worker groups. HITL is
  * `ctx.waitForSignal`, and sub-agent delegation is `ctx.child(AgentRunWorkflow)` — a replay-safe,
  * observable child run (it shows up as a node in the durable dashboard). A child streams into its
  * top-level ancestor's sink (`sinkRunId`) so the human watching the parent sees it and can approve

package/dist/durable/index.d.ts

@@ -5,7 +5,10 @@ import { WorkflowService } from '@dudousxd/nestjs-durable';
 import { DynamicModule } from '@nestjs/common';
 
 /**
- * The agent turn AS a durable workflow. Each model/tool call is a checkpointed `ctx.step`, HITL is
+ * The agent turn AS a durable workflow. Each model/tool call is a checkpointed `ctx.localStep` — the
+ * in-process primitive, NOT the always-dispatched `ctx.step`: the loop's deps (model provider, store,
+ * sink) live in THIS workflow worker's DI, and the step names are dynamic checkpoint identities
+ * (`llm:0`, `persist:toolcall:<id>`), not routable worker groups. HITL is
  * `ctx.waitForSignal`, and sub-agent delegation is `ctx.child(AgentRunWorkflow)` — a replay-safe,
  * observable child run (it shows up as a node in the durable dashboard). A child streams into its
  * top-level ancestor's sink (`sinkRunId`) so the human watching the parent sees it and can approve

package/dist/durable/index.js

@@ -55,7 +55,7 @@ var AgentRunWorkflow = class _AgentRunWorkflow {
     const day = input.day ?? utcDay();
     const deps = this.factory.forAgent(input.agentName);
     if (input.sinkRunId !== void 0) {
-      await ctx.step("activate", () => this.store.setActiveStream(input.threadId, ctx.runId));
+      await ctx.localStep("activate", () => this.store.setActiveStream(input.threadId, ctx.runId));
     }
     const sinkRunId = input.sinkRunId ?? ctx.runId;
     const hooks = {
@@ -63,9 +63,9 @@ var AgentRunWorkflow = class _AgentRunWorkflow {
       // A child forwards into the top-level sink but must not end/fail it (the top-level run owns it).
       openSink: /* @__PURE__ */ __name(async () => input.sinkRunId !== void 0 ? childSinkWriter(await deps.sink.open(sinkRunId)) : deps.sink.open(ctx.runId), "openSink"),
       awaitApproval: /* @__PURE__ */ __name((call) => ctx.waitForSignal(`tool:${ctx.runId}:${call.id}`), "awaitApproval"),
-      step: /* @__PURE__ */ __name((name, fn) => ctx.step(name, fn), "step"),
+      step: /* @__PURE__ */ __name((name, fn) => ctx.localStep(name, fn), "step"),
       runAgent: /* @__PURE__ */ __name(async (agentName, task) => {
-        const subThreadId = await ctx.step(`subthread:${agentName}`, async () => {
+        const subThreadId = await ctx.localStep(`subthread:${agentName}`, async () => {
           const thread = await this.store.createThread({
             actor: input.actor,
             transient: true
@@ -88,7 +88,7 @@ var AgentRunWorkflow = class _AgentRunWorkflow {
         ...deps,
         day
       }, input, hooks);
-      await ctx.step("deactivate", () => this.store.setActiveStream(input.threadId, null));
+      await ctx.localStep("deactivate", () => this.store.setActiveStream(input.threadId, null));
       return result;
     } catch (error) {
       if (error instanceof WorkflowSuspended || error instanceof ContinueAsNew) {
@@ -101,7 +101,7 @@ var AgentRunWorkflow = class _AgentRunWorkflow {
         code,
         message
       });
-      await ctx.step("deactivate", () => this.store.setActiveStream(input.threadId, null));
+      await ctx.localStep("deactivate", () => this.store.setActiveStream(input.threadId, null));
       const writer = await hooks.openSink();
       await writer.fail({
         code,