@dudousxd/nestjs-agent 1.19.2 → 1.20.0

package/dist/durable/index.d.cts

@@ -1,7 +1,7 @@
 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, C as ChatQueueService, a as AgentSurface, b as AgentModuleOptions } from '../chat-queue.service-CKZkjlMK.cjs';
 import { WorkflowService } from '@dudousxd/nestjs-durable';
+import { RunGateway, WorkflowCtx } from '@dudousxd/nestjs-durable-core';
+import { A as AgentDepsFactory, C as ChatQueueService, a as AgentSurface, b as AgentModuleOptions } from '../chat-queue.service-C0hr7dqx.cjs';
 import { DynamicModule } from '@nestjs/common';
 import '@standard-schema/spec';
 
@@ -23,8 +23,30 @@ declare class AgentRunWorkflow {
     private readonly store;
     private readonly runs?;
     private readonly queue?;
+    private readonly workflows?;
     private readonly logger;
-    constructor(factory: AgentDepsFactory, store: AgentStore, runs?: RunGateway | undefined, queue?: ChatQueueService | undefined);
+    constructor(factory: AgentDepsFactory, store: AgentStore, runs?: RunGateway | undefined, queue?: ChatQueueService | undefined, workflows?: WorkflowService | undefined);
+    /**
+     * Start a detached delegation as a TOP-LEVEL run, under an id derived from this run and the call.
+     *
+     * Not `ctx.startChild`, because the runtime treats a `spawn:` child as part of its parent: a Stop
+     * on the parent cascades to every run it spawned. A detached run is exactly the one the person did
+     * NOT ask to stop — they stopped the turn they were watching, and the work it handed off is meant
+     * to outlive that turn (it is meant to outlive it finishing, after all). Cascaded, it died parked
+     * on its approval, where its body never runs again, so nothing settled the delegation and the card
+     * said "started" for ever. The agent-level edge stays: the child's input still carries
+     * `parentRunId`, which is what the run rows record.
+     *
+     * Journaled as one `detach:<toolCallId>` localStep whose body runs outside the ambient workflow
+     * ctx (so the start goes to the engine and writes no position in this run). Its recorded result
+     * keeps a replay from starting it again, and a body re-run after a crash between the start and
+     * the checkpoint asks for the same id, which the runtime answers with the run it already has.
+     * The child is stamped with this run's namespace, as `ctx.startChild` would have stamped it, so an
+     * operator re-driving a tenant's turn does not move its delegate off that tenant's workers.
+     */
+    private startDetached;
+    /** The namespace this run is stamped with, where the runtime can say. */
+    private namespaceOf;
     /**
      * 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
@@ -188,7 +210,21 @@ declare class DurableAgentRunner implements AgentRunner {
      */
     cancel(runId: string): Promise<void>;
     /**
-     * The input a run was started with (which thread it was streaming), or `undefined` where the gateway cannot say.
+     * Settle the delegation a DETACHED run was started for, once it has been stopped. A run parked on
+     * a human never runs its body again — the runtime settles it from outside — so the body's own
+     * `deliver:detached:unsettled` is not reached, and without this the card in the calling thread says
+     * "started" for ever. Settles once (see `settleUnsettledDelegation`), so a body that did observe
+     * the Stop and a run that had already answered are both left as they are. A no-op for any run
+     * that does not deliver into another thread.
+     */
+    private settleCancelledDelegation;
+    /**
+     * A detached child the runtime cancelled along with its parent (a `spawn:` journaled before
+     * detached runs were started on their own): end it the way a Stop on its own id would have.
+     */
+    private settleCascadedDetached;
+    /**
+     * What the runtime recorded for a run — the input it was started with (which thread it was streaming), its status and the runs it spawned — 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
@@ -197,7 +233,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 inputOf;
+    private detailOf;
 }
 
 /**

package/dist/durable/index.d.ts

@@ -1,7 +1,7 @@
 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, C as ChatQueueService, a as AgentSurface, b as AgentModuleOptions } from '../chat-queue.service-CKZkjlMK.js';
 import { WorkflowService } from '@dudousxd/nestjs-durable';
+import { RunGateway, WorkflowCtx } from '@dudousxd/nestjs-durable-core';
+import { A as AgentDepsFactory, C as ChatQueueService, a as AgentSurface, b as AgentModuleOptions } from '../chat-queue.service-C0hr7dqx.js';
 import { DynamicModule } from '@nestjs/common';
 import '@standard-schema/spec';
 
@@ -23,8 +23,30 @@ declare class AgentRunWorkflow {
     private readonly store;
     private readonly runs?;
     private readonly queue?;
+    private readonly workflows?;
     private readonly logger;
-    constructor(factory: AgentDepsFactory, store: AgentStore, runs?: RunGateway | undefined, queue?: ChatQueueService | undefined);
+    constructor(factory: AgentDepsFactory, store: AgentStore, runs?: RunGateway | undefined, queue?: ChatQueueService | undefined, workflows?: WorkflowService | undefined);
+    /**
+     * Start a detached delegation as a TOP-LEVEL run, under an id derived from this run and the call.
+     *
+     * Not `ctx.startChild`, because the runtime treats a `spawn:` child as part of its parent: a Stop
+     * on the parent cascades to every run it spawned. A detached run is exactly the one the person did
+     * NOT ask to stop — they stopped the turn they were watching, and the work it handed off is meant
+     * to outlive that turn (it is meant to outlive it finishing, after all). Cascaded, it died parked
+     * on its approval, where its body never runs again, so nothing settled the delegation and the card
+     * said "started" for ever. The agent-level edge stays: the child's input still carries
+     * `parentRunId`, which is what the run rows record.
+     *
+     * Journaled as one `detach:<toolCallId>` localStep whose body runs outside the ambient workflow
+     * ctx (so the start goes to the engine and writes no position in this run). Its recorded result
+     * keeps a replay from starting it again, and a body re-run after a crash between the start and
+     * the checkpoint asks for the same id, which the runtime answers with the run it already has.
+     * The child is stamped with this run's namespace, as `ctx.startChild` would have stamped it, so an
+     * operator re-driving a tenant's turn does not move its delegate off that tenant's workers.
+     */
+    private startDetached;
+    /** The namespace this run is stamped with, where the runtime can say. */
+    private namespaceOf;
     /**
      * 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
@@ -188,7 +210,21 @@ declare class DurableAgentRunner implements AgentRunner {
      */
     cancel(runId: string): Promise<void>;
     /**
-     * The input a run was started with (which thread it was streaming), or `undefined` where the gateway cannot say.
+     * Settle the delegation a DETACHED run was started for, once it has been stopped. A run parked on
+     * a human never runs its body again — the runtime settles it from outside — so the body's own
+     * `deliver:detached:unsettled` is not reached, and without this the card in the calling thread says
+     * "started" for ever. Settles once (see `settleUnsettledDelegation`), so a body that did observe
+     * the Stop and a run that had already answered are both left as they are. A no-op for any run
+     * that does not deliver into another thread.
+     */
+    private settleCancelledDelegation;
+    /**
+     * A detached child the runtime cancelled along with its parent (a `spawn:` journaled before
+     * detached runs were started on their own): end it the way a Stop on its own id would have.
+     */
+    private settleCascadedDetached;
+    /**
+     * What the runtime recorded for a run — the input it was started with (which thread it was streaming), its status and the runs it spawned — 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
@@ -197,7 +233,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 inputOf;
+    private detailOf;
 }
 
 /**