@dudousxd/nestjs-agent 0.4.1 → 0.6.0

package/dist/{agent-deps.factory-BM_RB6br.d.cts → agent-deps.factory-BlC9tumI.d.cts}

@@ -112,6 +112,21 @@ interface AgentModuleOptions {
      * `AgentDurableModule` from `@dudousxd/nestjs-agent/durable` and a configured `DurableModule`.
      */
     durable?: boolean;
+    /**
+     * Dispatch the turn's model call and tool executions as routed durable steps
+     * (`AgentRunSteps.llm` / `AgentRunSteps.tool`) instead of in-process `ctx.localStep`s.
+     * DEFAULT `true` under `durable: true` — dispatching moves the run off its pod during the two
+     * long steps (the correct production posture), and `AgentRunSteps` is always registered so the
+     * routed groups are never unserved. Set `false` to keep the turn's steps in-process localSteps.
+     * `true` without `durable: true` throws at module build.
+     *
+     * The cross-process-sink requirement is a property of `durable: true` itself, not of this flag:
+     * the turn already runs on whichever worker takes `agent.run`, which may not be the pod holding
+     * the SSE connection — multi-pod fleets MUST wire a cross-process token sink (e.g. a Redis
+     * pub/sub `TokenStreamSink`) either way. STATIC top-level flag (like `durable`/
+     * `attachments.upload`): it decides how the workflow dispatches at module build time.
+     */
+    dispatchedSteps?: boolean;
     /**
      * Static functional tools (`{ spec, handler }`, e.g. from `createExecuteSqlTool`) to register at
      * boot. For tools that need DI-resolved dependencies, use `provideAgentTool(factory, inject)` in a
@@ -173,6 +188,15 @@ interface AgentModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
      * the runner. Requires importing `AgentDurableModule` and a configured `DurableModule`.
      */
     durable?: boolean;
+    /**
+     * Dispatch the turn's model call and tool executions as routed durable steps. DEFAULT `true`
+     * under `durable: true`; set `false` to keep the turn's steps in-process localSteps. Same
+     * static-wiring reasoning as `durable` above — it lives here (not in the async factory result)
+     * because it decides how `AgentRunWorkflow` builds its hooks at module build time. `true` without
+     * `durable: true` throws at module build. See `AgentModuleOptions.dispatchedSteps` for the full
+     * contract.
+     */
+    dispatchedSteps?: boolean;
     /**
      * Set when `AGENT_STORE` is bound by a globally-imported store module (e.g.
      * `MikroOrmAgentStoreModule.forFeature()`) instead of returned as `store` from `useFactory`.

package/dist/{agent-deps.factory-BM_RB6br.d.ts → agent-deps.factory-BlC9tumI.d.ts}

@@ -112,6 +112,21 @@ interface AgentModuleOptions {
      * `AgentDurableModule` from `@dudousxd/nestjs-agent/durable` and a configured `DurableModule`.
      */
     durable?: boolean;
+    /**
+     * Dispatch the turn's model call and tool executions as routed durable steps
+     * (`AgentRunSteps.llm` / `AgentRunSteps.tool`) instead of in-process `ctx.localStep`s.
+     * DEFAULT `true` under `durable: true` — dispatching moves the run off its pod during the two
+     * long steps (the correct production posture), and `AgentRunSteps` is always registered so the
+     * routed groups are never unserved. Set `false` to keep the turn's steps in-process localSteps.
+     * `true` without `durable: true` throws at module build.
+     *
+     * The cross-process-sink requirement is a property of `durable: true` itself, not of this flag:
+     * the turn already runs on whichever worker takes `agent.run`, which may not be the pod holding
+     * the SSE connection — multi-pod fleets MUST wire a cross-process token sink (e.g. a Redis
+     * pub/sub `TokenStreamSink`) either way. STATIC top-level flag (like `durable`/
+     * `attachments.upload`): it decides how the workflow dispatches at module build time.
+     */
+    dispatchedSteps?: boolean;
     /**
      * Static functional tools (`{ spec, handler }`, e.g. from `createExecuteSqlTool`) to register at
      * boot. For tools that need DI-resolved dependencies, use `provideAgentTool(factory, inject)` in a
@@ -173,6 +188,15 @@ interface AgentModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
      * the runner. Requires importing `AgentDurableModule` and a configured `DurableModule`.
      */
     durable?: boolean;
+    /**
+     * Dispatch the turn's model call and tool executions as routed durable steps. DEFAULT `true`
+     * under `durable: true`; set `false` to keep the turn's steps in-process localSteps. Same
+     * static-wiring reasoning as `durable` above — it lives here (not in the async factory result)
+     * because it decides how `AgentRunWorkflow` builds its hooks at module build time. `true` without
+     * `durable: true` throws at module build. See `AgentModuleOptions.dispatchedSteps` for the full
+     * contract.
+     */
+    dispatchedSteps?: boolean;
     /**
      * Set when `AGENT_STORE` is bound by a globally-imported store module (e.g.
      * `MikroOrmAgentStoreModule.forFeature()`) instead of returned as `store` from `useFactory`.