@dudousxd/nestjs-agent 1.14.0 → 1.15.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 { AgentStore, AgentRunInput, AgentLoopResult, LlmStepEnvelope, BufferedModelTurnResult, ToolStepEnvelope, AgentRunner, TokenStreamSink, AgentRunStartOptions, 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-DkWvoWbD.cjs';
+import { A as AgentDepsFactory, C as ChatQueueService, a as AgentSurface, b as AgentModuleOptions } from '../chat-queue.service-Bqq00NN1.cjs';
 import { WorkflowService } from '@dudousxd/nestjs-durable';
 import { DynamicModule } from '@nestjs/common';
 import '@standard-schema/spec';
@@ -22,7 +22,19 @@ declare class AgentRunWorkflow {
     private readonly factory;
     private readonly store;
     private readonly runs?;
-    constructor(factory: AgentDepsFactory, store: AgentStore, runs?: RunGateway | undefined);
+    private readonly queue?;
+    constructor(factory: AgentDepsFactory, store: AgentStore, runs?: RunGateway | undefined, queue?: ChatQueueService | undefined);
+    /**
+     * Move the thread past this settling turn — to the next queued message, started here as a
+     * fire-and-forget `ctx.startChild` under the message's own id, or to a paused/empty queue — and
+     * answer the `queue` frame to write before the turn's terminal.
+     *
+     * Journaled: the decision (which message, claimed and popped) is one `localStep`, so a replay
+     * reads it back instead of popping a second message, and the start is the runtime's own
+     * replay-safe spawn. Gated by `ctx.patched`, so a run recorded before the queue existed replays
+     * against the history it has. A no-op for a sub-agent's run and on a store without a queue.
+     */
+    private advanceQueue;
     /**
      * Has someone asked this run to stop? Read from the runtime's own run status, which is where
      * `DurableAgentRunner.cancel` puts it — `cancelling` while a compensating cancel is in flight,
@@ -134,11 +146,18 @@ declare class DurableAgentRunner implements AgentRunner {
     private readonly runs;
     private readonly store;
     private readonly sink;
+    private readonly queue?;
     private readonly logger;
-    constructor(workflows: WorkflowService, runs: RunGateway, store: AgentStore, sink: TokenStreamSink);
-    start(input: AgentRunInput): Promise<{
+    constructor(workflows: WorkflowService, runs: RunGateway, store: AgentStore, sink: TokenStreamSink, queue?: ChatQueueService | undefined);
+    start(input: AgentRunInput, options?: AgentRunStartOptions): Promise<{
         runId: string;
     }>;
+    /**
+     * From the runtime's own run row. A run it does not know yet counts as running — a queued turn is
+     * claimed before its `startChild` lands — and so does one it cannot be asked about: only a run the
+     * runtime reports settled (`completed`/`failed`/`cancelled`/`dead`) is stale.
+     */
+    isRunActive(runId: string): Promise<boolean>;
     signal(runId: string, toolCallId: string, reply: HumanReply): Promise<void>;
     /**
      * Stop a run, and settle what the durable runtime knows nothing about.
@@ -166,7 +185,7 @@ declare class DurableAgentRunner implements AgentRunner {
      */
     cancel(runId: string): Promise<void>;
     /**
-     * Which thread a run was streaming, or `undefined` where the gateway cannot say.
+     * The input a run was started with (which thread it was streaming), or `undefined` where the gateway cannot say.
      *
      * A read failure answers `undefined` instead of propagating, the same posture `AgentRunWorkflow`
      * takes for its own cancel observation: failing to ask is not an answer worth failing a cancel
@@ -175,7 +194,7 @@ declare class DurableAgentRunner implements AgentRunner {
      * with a subscriber holding a stream that never settles, from the one call whose entire job is to
      * make a run stop.
      */
-    private threadOf;
+    private inputOf;
 }
 
 /**

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 { AgentStore, AgentRunInput, AgentLoopResult, LlmStepEnvelope, BufferedModelTurnResult, ToolStepEnvelope, AgentRunner, TokenStreamSink, AgentRunStartOptions, 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-DkWvoWbD.js';
+import { A as AgentDepsFactory, C as ChatQueueService, a as AgentSurface, b as AgentModuleOptions } from '../chat-queue.service-Bqq00NN1.js';
 import { WorkflowService } from '@dudousxd/nestjs-durable';
 import { DynamicModule } from '@nestjs/common';
 import '@standard-schema/spec';
@@ -22,7 +22,19 @@ declare class AgentRunWorkflow {
     private readonly factory;
     private readonly store;
     private readonly runs?;
-    constructor(factory: AgentDepsFactory, store: AgentStore, runs?: RunGateway | undefined);
+    private readonly queue?;
+    constructor(factory: AgentDepsFactory, store: AgentStore, runs?: RunGateway | undefined, queue?: ChatQueueService | undefined);
+    /**
+     * Move the thread past this settling turn — to the next queued message, started here as a
+     * fire-and-forget `ctx.startChild` under the message's own id, or to a paused/empty queue — and
+     * answer the `queue` frame to write before the turn's terminal.
+     *
+     * Journaled: the decision (which message, claimed and popped) is one `localStep`, so a replay
+     * reads it back instead of popping a second message, and the start is the runtime's own
+     * replay-safe spawn. Gated by `ctx.patched`, so a run recorded before the queue existed replays
+     * against the history it has. A no-op for a sub-agent's run and on a store without a queue.
+     */
+    private advanceQueue;
     /**
      * Has someone asked this run to stop? Read from the runtime's own run status, which is where
      * `DurableAgentRunner.cancel` puts it — `cancelling` while a compensating cancel is in flight,
@@ -134,11 +146,18 @@ declare class DurableAgentRunner implements AgentRunner {
     private readonly runs;
     private readonly store;
     private readonly sink;
+    private readonly queue?;
     private readonly logger;
-    constructor(workflows: WorkflowService, runs: RunGateway, store: AgentStore, sink: TokenStreamSink);
-    start(input: AgentRunInput): Promise<{
+    constructor(workflows: WorkflowService, runs: RunGateway, store: AgentStore, sink: TokenStreamSink, queue?: ChatQueueService | undefined);
+    start(input: AgentRunInput, options?: AgentRunStartOptions): Promise<{
         runId: string;
     }>;
+    /**
+     * From the runtime's own run row. A run it does not know yet counts as running — a queued turn is
+     * claimed before its `startChild` lands — and so does one it cannot be asked about: only a run the
+     * runtime reports settled (`completed`/`failed`/`cancelled`/`dead`) is stale.
+     */
+    isRunActive(runId: string): Promise<boolean>;
     signal(runId: string, toolCallId: string, reply: HumanReply): Promise<void>;
     /**
      * Stop a run, and settle what the durable runtime knows nothing about.
@@ -166,7 +185,7 @@ declare class DurableAgentRunner implements AgentRunner {
      */
     cancel(runId: string): Promise<void>;
     /**
-     * Which thread a run was streaming, or `undefined` where the gateway cannot say.
+     * The input a run was started with (which thread it was streaming), or `undefined` where the gateway cannot say.
      *
      * A read failure answers `undefined` instead of propagating, the same posture `AgentRunWorkflow`
      * takes for its own cancel observation: failing to ask is not an answer worth failing a cancel
@@ -175,7 +194,7 @@ declare class DurableAgentRunner implements AgentRunner {
      * with a subscriber holding a stream that never settles, from the one call whose entire job is to
      * make a run stop.
      */
-    private threadOf;
+    private inputOf;
 }
 
 /**