@dudousxd/nestjs-agent 0.5.0 → 0.6.0

package/dist/durable/index.d.cts

@@ -1,6 +1,6 @@
 import { LlmStepEnvelope, ModelTurnResult, ToolStepEnvelope, AgentStore, AgentRunInput, AgentRunner, Decision } from '@dudousxd/nestjs-agent-core';
 import { WorkflowCtx } from '@dudousxd/nestjs-durable-core';
-import { A as AgentDepsFactory, a as AgentModuleOptions } from '../agent-deps.factory-DGM0IVtA.cjs';
+import { A as AgentDepsFactory, a as AgentModuleOptions } from '../agent-deps.factory-BlC9tumI.cjs';
 import { WorkflowService } from '@dudousxd/nestjs-durable';
 import { DynamicModule } from '@nestjs/common';
 
@@ -25,9 +25,9 @@ interface DispatchedLlmInput extends LlmStepEnvelope {
     childSink: boolean;
 }
 /**
- * The two long steps `AgentRunWorkflow` dispatches as routed remote steps when
- * `dispatchedSteps: true` (`AgentRunSteps.llm` / `AgentRunSteps.tool`) instead of running them
- * in-process under `ctx.localStep`. Both re-resolve their deps from THIS worker's own DI via
+ * 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
  * `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.
@@ -51,14 +51,16 @@ declare class AgentRunSteps {
 }
 
 /**
- * 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
- * its action tools; the approval routes to the child's own run via `runForToolCall`.
+ * The agent turn AS a durable workflow. Persist/stream checkpoints are `ctx.localStep`s — the
+ * 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
+ * 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`.
  */
 declare class AgentRunWorkflow {
     private readonly factory;
@@ -119,12 +121,12 @@ declare class AgentDurableModule {
 declare function agentDurable(options: AgentModuleOptions): DynamicModule[];
 
 /**
- * DI flag mirroring `AgentModuleOptions.dispatchedSteps`: whether `AgentRunWorkflow` dispatches its
+ * 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` binds it from `AGENT_OPTIONS` (defaulting to `false`); `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 !==
+ * 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.
  */
 declare const AGENT_DISPATCHED_STEPS: unique symbol;
 

package/dist/durable/index.d.ts

@@ -1,6 +1,6 @@
 import { LlmStepEnvelope, ModelTurnResult, ToolStepEnvelope, AgentStore, AgentRunInput, AgentRunner, Decision } from '@dudousxd/nestjs-agent-core';
 import { WorkflowCtx } from '@dudousxd/nestjs-durable-core';
-import { A as AgentDepsFactory, a as AgentModuleOptions } from '../agent-deps.factory-DGM0IVtA.js';
+import { A as AgentDepsFactory, a as AgentModuleOptions } from '../agent-deps.factory-BlC9tumI.js';
 import { WorkflowService } from '@dudousxd/nestjs-durable';
 import { DynamicModule } from '@nestjs/common';
 
@@ -25,9 +25,9 @@ interface DispatchedLlmInput extends LlmStepEnvelope {
     childSink: boolean;
 }
 /**
- * The two long steps `AgentRunWorkflow` dispatches as routed remote steps when
- * `dispatchedSteps: true` (`AgentRunSteps.llm` / `AgentRunSteps.tool`) instead of running them
- * in-process under `ctx.localStep`. Both re-resolve their deps from THIS worker's own DI via
+ * 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
  * `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.
@@ -51,14 +51,16 @@ declare class AgentRunSteps {
 }
 
 /**
- * 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
- * its action tools; the approval routes to the child's own run via `runForToolCall`.
+ * The agent turn AS a durable workflow. Persist/stream checkpoints are `ctx.localStep`s — the
+ * 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
+ * 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`.
  */
 declare class AgentRunWorkflow {
     private readonly factory;
@@ -119,12 +121,12 @@ declare class AgentDurableModule {
 declare function agentDurable(options: AgentModuleOptions): DynamicModule[];
 
 /**
- * DI flag mirroring `AgentModuleOptions.dispatchedSteps`: whether `AgentRunWorkflow` dispatches its
+ * 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` binds it from `AGENT_OPTIONS` (defaulting to `false`); `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 !==
+ * 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.
  */
 declare const AGENT_DISPATCHED_STEPS: unique symbol;