@dudousxd/nestjs-agent 0.12.0 → 0.13.0

package/dist/durable/index.d.cts

@@ -1,6 +1,6 @@
 import { AgentStore, AgentRunInput, AgentLoopResult, LlmStepEnvelope, BufferedModelTurnResult, ToolStepEnvelope, AgentRunner, TokenStreamSink, HumanReply } from '@dudousxd/nestjs-agent-core';
 import { RunGateway, WorkflowCtx } from '@dudousxd/nestjs-durable-core';
-import { A as AgentDepsFactory, a as AgentSurface, b as AgentModuleOptions } from '../agent-deps.factory-EROMcBNh.cjs';
+import { A as AgentDepsFactory, a as AgentSurface, b as AgentModuleOptions } from '../agent-deps.factory-y2hvoQ6U.cjs';
 import { WorkflowService } from '@dudousxd/nestjs-durable';
 import { DynamicModule } from '@nestjs/common';
 import '@standard-schema/spec';
@@ -10,10 +10,10 @@ import '@standard-schema/spec';
  * in-process primitive, NOT the always-dispatched `ctx.step`: their names are dynamic checkpoint
  * identities (`persist:toolcall:<id>`), not routable worker groups, and their deps (store, sink)
  * live in THIS workflow worker's DI. The two LONG steps (model call, tool execution) are dispatched
- * through `AgentRunSteps` by default (`AGENT_DISPATCHED_STEPS`, ON under `durable: true`) so the
- * run isn't pinned to this pod while they execute; `dispatchedSteps: false` keeps them localSteps
- * too. 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
+ * through `AgentRunSteps` where the deployment asked for it (`AGENT_DISPATCHED_STEPS`, from
+ * `dispatchedSteps: true`) so the run isn't pinned to this pod while they execute; without that
+ * flag they are localSteps too. 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 its action tools; the approval routes to the child's own run via `runForToolCall`.
  */
@@ -86,8 +86,8 @@ interface DispatchedToolInput extends ToolStepEnvelope {
 }
 /**
  * The two long steps `AgentRunWorkflow` dispatches as routed remote steps (`AgentRunSteps.llm` /
- * `AgentRunSteps.tool`) — the default under `durable: true`; `dispatchedSteps: false` runs them
- * in-process under `ctx.localStep` instead. Both re-resolve their deps from THIS worker's own DI via
+ * `AgentRunSteps.tool`) under `dispatchedSteps: true`; omitting that flag runs them in-process
+ * under `ctx.localStep` instead. Both re-resolve their deps from THIS worker's own DI via
  * `AGENT_DEPS_FACTORY.forAgent` — a step can be served by any worker in the fleet, not just the one
  * that started the run. Always provided by `AgentDurableModule` regardless of `dispatchedSteps`, so
  * the worker group is never orphaned.
@@ -220,10 +220,10 @@ declare function agentDurable(options: AgentModuleOptions): DynamicModule[];
 /**
  * DI flag carrying the EFFECTIVE `dispatchedSteps` value: whether `AgentRunWorkflow` dispatches its
  * `llm`/`tool` steps as routed remote steps (`AgentRunSteps`) instead of in-process `ctx.localStep`s.
- * `AgentDurableModule` derives it from `AGENT_OPTIONS` (`durable === true && dispatchedSteps !==
- * false` — default ON under durable); `AgentRunWorkflow` injects it. Kept in its own file —
- * `AgentDurableModule` provides `AgentRunWorkflow` and `AgentRunWorkflow` injects this token, so
- * declaring it in either of those two files would make them import each other.
+ * `AgentDurableModule` derives it from `AGENT_OPTIONS` (`durable === true && dispatchedSteps ===
+ * true`); `AgentRunWorkflow` injects it. Kept in its own file — `AgentDurableModule` provides
+ * `AgentRunWorkflow` and `AgentRunWorkflow` injects this token, so declaring it in either of those
+ * two files would make them import each other.
  */
 declare const AGENT_DISPATCHED_STEPS: unique symbol;
 

package/dist/durable/index.d.ts

@@ -1,6 +1,6 @@
 import { AgentStore, AgentRunInput, AgentLoopResult, LlmStepEnvelope, BufferedModelTurnResult, ToolStepEnvelope, AgentRunner, TokenStreamSink, HumanReply } from '@dudousxd/nestjs-agent-core';
 import { RunGateway, WorkflowCtx } from '@dudousxd/nestjs-durable-core';
-import { A as AgentDepsFactory, a as AgentSurface, b as AgentModuleOptions } from '../agent-deps.factory-EROMcBNh.js';
+import { A as AgentDepsFactory, a as AgentSurface, b as AgentModuleOptions } from '../agent-deps.factory-y2hvoQ6U.js';
 import { WorkflowService } from '@dudousxd/nestjs-durable';
 import { DynamicModule } from '@nestjs/common';
 import '@standard-schema/spec';
@@ -10,10 +10,10 @@ import '@standard-schema/spec';
  * in-process primitive, NOT the always-dispatched `ctx.step`: their names are dynamic checkpoint
  * identities (`persist:toolcall:<id>`), not routable worker groups, and their deps (store, sink)
  * live in THIS workflow worker's DI. The two LONG steps (model call, tool execution) are dispatched
- * through `AgentRunSteps` by default (`AGENT_DISPATCHED_STEPS`, ON under `durable: true`) so the
- * run isn't pinned to this pod while they execute; `dispatchedSteps: false` keeps them localSteps
- * too. 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
+ * through `AgentRunSteps` where the deployment asked for it (`AGENT_DISPATCHED_STEPS`, from
+ * `dispatchedSteps: true`) so the run isn't pinned to this pod while they execute; without that
+ * flag they are localSteps too. 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 its action tools; the approval routes to the child's own run via `runForToolCall`.
  */
@@ -86,8 +86,8 @@ interface DispatchedToolInput extends ToolStepEnvelope {
 }
 /**
  * The two long steps `AgentRunWorkflow` dispatches as routed remote steps (`AgentRunSteps.llm` /
- * `AgentRunSteps.tool`) — the default under `durable: true`; `dispatchedSteps: false` runs them
- * in-process under `ctx.localStep` instead. Both re-resolve their deps from THIS worker's own DI via
+ * `AgentRunSteps.tool`) under `dispatchedSteps: true`; omitting that flag runs them in-process
+ * under `ctx.localStep` instead. Both re-resolve their deps from THIS worker's own DI via
  * `AGENT_DEPS_FACTORY.forAgent` — a step can be served by any worker in the fleet, not just the one
  * that started the run. Always provided by `AgentDurableModule` regardless of `dispatchedSteps`, so
  * the worker group is never orphaned.
@@ -220,10 +220,10 @@ declare function agentDurable(options: AgentModuleOptions): DynamicModule[];
 /**
  * DI flag carrying the EFFECTIVE `dispatchedSteps` value: whether `AgentRunWorkflow` dispatches its
  * `llm`/`tool` steps as routed remote steps (`AgentRunSteps`) instead of in-process `ctx.localStep`s.
- * `AgentDurableModule` derives it from `AGENT_OPTIONS` (`durable === true && dispatchedSteps !==
- * false` — default ON under durable); `AgentRunWorkflow` injects it. Kept in its own file —
- * `AgentDurableModule` provides `AgentRunWorkflow` and `AgentRunWorkflow` injects this token, so
- * declaring it in either of those two files would make them import each other.
+ * `AgentDurableModule` derives it from `AGENT_OPTIONS` (`durable === true && dispatchedSteps ===
+ * true`); `AgentRunWorkflow` injects it. Kept in its own file — `AgentDurableModule` provides
+ * `AgentRunWorkflow` and `AgentRunWorkflow` injects this token, so declaring it in either of those
+ * two files would make them import each other.
  */
 declare const AGENT_DISPATCHED_STEPS: unique symbol;
 

package/dist/durable/index.js

@@ -633,9 +633,9 @@ function runnerProviders() {
     {
       provide: AGENT_DISPATCHED_STEPS,
       useFactory: /* @__PURE__ */ __name((options, sink) => {
-        const enabled = options.durable === true && options.dispatchedSteps !== false;
+        const enabled = options.durable === true && options.dispatchedSteps === true;
         if (enabled && sink instanceof InProcessTokenStreamSink) {
-          logger.warn("Dispatched steps are active (the default under durable: true) with the default InProcessTokenStreamSink, which only buffers tokens in-process. A dispatched `llm` step served by a different worker cannot stream into this buffer. Wire a cross-process TokenStreamSink (e.g. a Redis pub/sub sink) via AgentModule.forRoot({ sink }) before running multi-pod, or set dispatchedSteps: false to keep the turn in-process localSteps.");
+          logger.warn("dispatchedSteps: true with the default InProcessTokenStreamSink, which only buffers tokens in-process. A dispatched `llm` step served by a different worker cannot stream into this buffer. Wire a cross-process TokenStreamSink (e.g. a Redis pub/sub sink) via AgentModule.forRoot({ sink }) before running multi-pod, or drop dispatchedSteps to keep the turn in-process localSteps.");
         }
         return enabled;
       }, "useFactory"),