@modelprofile.com/flexharness-agent 9.9.0 → 9.10.0

package/dist_ts_agent/smartagent.transactions.js

@@ -96,9 +96,85 @@ export const getAgentGenerationTransactions = (events) => {
     return transactions;
 };
 export const isTransactionalGeneration = (events, generationId) => getAgentGenerationTransactions(events).has(generationId);
+/** The model output that closes a tool call its stopped generation left without a result. */
+export const INTERRUPTED_TOOL_CALL_RESULT = 'The tool call was interrupted before its result was recorded; its effect is unknown.';
+const isModelOutputEvent = (event) => event.type === 'assistant-message'
+    || event.type === 'tool-call'
+    || event.type === 'tool-result'
+    || event.type === 'model-message';
+/**
+ * Whether the events of a transactional generation are part of the model context. An accepted
+ * generation is, and so is the generation that is executing. A generation its owner stopped
+ * stays in the context once the model produced output in it: its prompt, the input it took in
+ * while it ran and what the model produced before the stop. One stopped before any model output
+ * left no trace in the conversation and is not shown, so its prompt can be sent again. Rejected
+ * generations, and generations interrupted by an abort, a failure or a restart, are not shown.
+ */
+const isModelVisibleTransaction = (transaction, producedOutput) => transaction.state === 'accepted'
+    || transaction.state === 'execution-started'
+    || (transaction.state === 'interrupted'
+        && transaction.outcome?.stopped === true
+        && transaction.executionStarted !== undefined
+        && producedOutput.has(transaction.generationId));
+/** The generations whose model produced output in `events`. */
+const generationsWithModelOutput = (events) => {
+    const producedOutput = new Set();
+    for (const event of events) {
+        if (event.generationId && isModelOutputEvent(event))
+            producedOutput.add(event.generationId);
+    }
+    return producedOutput;
+};
+/**
+ * Whether the transactional generation `generationId` is part of the model context of later
+ * generations, by the rule `filterModelVisibleAgentEvents` applies: it was accepted, is
+ * executing, or was stopped by its owner after its model produced output. False for a
+ * generation `events` holds no transaction of.
+ */
+export const isGenerationInModelContext = (events, generationId) => {
+    const transaction = getAgentGenerationTransactions(events).get(generationId);
+    return transaction !== undefined
+        && isModelVisibleTransaction(transaction, generationsWithModelOutput(events));
+};
+const interruptedToolResult = (toolCallId, toolName, source) => ({
+    id: `${source.id}:interrupted:${toolCallId}`,
+    timestamp: source.timestamp,
+    type: 'tool-result',
+    toolCallId,
+    toolName,
+    error: INTERRUPTED_TOOL_CALL_RESULT,
+    modelOutput: { type: 'error-text', value: INTERRUPTED_TOOL_CALL_RESULT },
+    generationId: source.generationId,
+    inferenceId: source.inferenceId,
+    causationId: source.causationId,
+    parentIds: [source.id],
+});
 export const filterModelVisibleAgentEvents = (events) => {
     const transactions = getAgentGenerationTransactions(events);
+    const producedOutput = generationsWithModelOutput(events);
+    const resultedToolCalls = new Set();
+    for (const event of events) {
+        if (!event.generationId)
+            continue;
+        if (event.type === 'tool-result')
+            resultedToolCalls.add(`${event.generationId}\0${event.toolCallId}`);
+        if (event.type === 'assistant-message' && Array.isArray(event.content)) {
+            for (const part of event.content) {
+                if (part.type === 'tool-result') {
+                    resultedToolCalls.add(`${event.generationId}\0${part.toolCallId}`);
+                }
+            }
+        }
+    }
     const visibleEvents = [];
+    /** Closes each tool call a stopped generation left open, right after the call. */
+    const closeOpenToolCall = (toolCallId, toolName, source) => {
+        const key = `${source.generationId}\0${toolCallId}`;
+        if (resultedToolCalls.has(key))
+            return;
+        resultedToolCalls.add(key);
+        visibleEvents.push(interruptedToolResult(toolCallId, toolName, source));
+    };
     for (const event of events) {
         if (isControlEvent(event))
             continue;
@@ -111,10 +187,21 @@ export const filterModelVisibleAgentEvents = (events) => {
             continue;
         }
         const transaction = transactions.get(event.generationId);
-        if (!transaction
-            || transaction.state === 'accepted'
-            || transaction.state === 'execution-started')
-            visibleEvents.push(event);
+        if (transaction && !isModelVisibleTransaction(transaction, producedOutput))
+            continue;
+        visibleEvents.push(event);
+        if (transaction?.state !== 'interrupted')
+            continue;
+        if (event.type === 'tool-call' && event.providerExecuted !== true) {
+            closeOpenToolCall(event.toolCallId, event.toolName, event);
+        }
+        else if (event.type === 'assistant-message' && Array.isArray(event.content)) {
+            for (const part of event.content) {
+                if (part.type === 'tool-call' && part.providerExecuted !== true) {
+                    closeOpenToolCall(part.toolCallId, part.toolName, event);
+                }
+            }
+        }
     }
     return visibleEvents;
 };
@@ -138,4 +225,4 @@ export const getUncertainToolExecutionIntents = (events, generationId) => {
     }
     return [...uncertain.values()];
 };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnRhZ2VudC50cmFuc2FjdGlvbnMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19hZ2VudC9zbWFydGFnZW50LnRyYW5zYWN0aW9ucy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUEyQkEsTUFBTSxjQUFjLEdBQUcsQ0FBQyxLQUFrQixFQUErQixFQUFFLENBQ3pFLEtBQUssQ0FBQyxJQUFJLEtBQUssa0JBQWtCO09BQzlCLEtBQUssQ0FBQyxJQUFJLEtBQUssOEJBQThCO09BQzdDLEtBQUssQ0FBQyxJQUFJLEtBQUssZ0NBQWdDO09BQy9DLEtBQUssQ0FBQyxJQUFJLEtBQUssb0JBQW9CO09BQ25DLEtBQUssQ0FBQyxJQUFJLEtBQUssdUJBQXVCO09BQ3RDLEtBQUssQ0FBQyxJQUFJLEtBQUssK0JBQStCLENBQUM7QUFFcEQsTUFBTSxDQUFDLE1BQU0sOEJBQThCLEdBQUcsQ0FDNUMsTUFBOEIsRUFDWSxFQUFFO0lBZTVDLE1BQU0sV0FBVyxHQUFHLElBQUksR0FBRyxFQUFtQyxDQUFDO0lBQy9ELE1BQU0sUUFBUSxHQUFHLENBQUMsWUFBb0IsRUFBMkIsRUFBRTtRQUNqRSxJQUFJLEtBQUssR0FBRyxXQUFXLENBQUMsR0FBRyxDQUFDLFlBQVksQ0FBQyxDQUFDO1FBQzFDLElBQUksQ0FBQyxLQUFLLEVBQUUsQ0FBQztZQUNYLEtBQUssR0FBRztnQkFDTixVQUFVLEVBQUUsQ0FBQztnQkFDYixVQUFVLEVBQUUsQ0FBQyxDQUFDO2dCQUNkLFlBQVksRUFBRSxDQUFDO2dCQUNmLFlBQVksRUFBRSxDQUFDLENBQUM7Z0JBQ2hCLGNBQWMsRUFBRSxDQUFDO2dCQUNqQixjQUFjLEVBQUUsQ0FBQyxDQUFDO2dCQUNsQixZQUFZLEVBQUUsQ0FBQztnQkFDZixZQUFZLEVBQUUsQ0FBQyxDQUFDO2FBQ2pCLENBQUM7WUFDRixXQUFXLENBQUMsR0FBRyxDQUFDLFlBQVksRUFBRSxLQUFLLENBQUMsQ0FBQztRQUN2QyxDQUFDO1FBQ0QsT0FB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
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnRhZ2VudC50cmFuc2FjdGlvbnMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19hZ2VudC9zbWFydGFnZW50LnRyYW5zYWN0aW9ucy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUE0QkEsTUFBTSxjQUFjLEdBQUcsQ0FBQyxLQUFrQixFQUErQixFQUFFLENBQ3pFLEtBQUssQ0FBQyxJQUFJLEtBQUssa0JBQWtCO09BQzlCLEtBQUssQ0FBQyxJQUFJLEtBQUssOEJBQThCO09BQzdDLEtBQUssQ0FBQyxJQUFJLEtBQUssZ0NBQWdDO09BQy9DLEtBQUssQ0FBQyxJQUFJLEtBQUssb0JBQW9CO09BQ25DLEtBQUssQ0FBQyxJQUFJLEtBQUssdUJBQXVCO09BQ3RDLEtBQUssQ0FBQyxJQUFJLEtBQUssK0JBQStCLENBQUM7QUFFcEQsTUFBTSxDQUFDLE1BQU0sOEJBQThCLEdBQUcsQ0FDNUMsTUFBOEIsRUFDWSxFQUFFO0lBZTVDLE1BQU0sV0FBVyxHQUFHLElBQUksR0FBRyxFQUFtQyxDQUFDO0lBQy9ELE1BQU0sUUFBUSxHQUFHLENBQUMsWUFBb0IsRUFBMkIsRUFBRTtRQUNqRSxJQUFJLEtBQUssR0FBRyxXQUFXLENBQUMsR0FBRyxDQUFDLFlBQVksQ0FBQyxDQUFDO1FBQzFDLElBQUksQ0FBQyxLQUFLLEVBQUUsQ0FBQztZQUNYLEtBQUssR0FBRztnQkFDTixVQUFVLEVBQUUsQ0FBQztnQkFDYixVQUFVLEVBQUUsQ0FBQyxDQUFDO2dCQUNkLFlBQVksRUFBRSxDQUFDO2dCQUNmLFlBQVksRUFBRSxDQUFDLENBQUM7Z0JBQ2hCLGNBQWMsRUFBRSxDQUFDO2dCQUNqQixjQUFjLEVBQUUsQ0FBQyxDQUFDO2dCQUNsQixZQUFZLEVBQUUsQ0FBQztnQkFDZixZQUFZLEVBQUUsQ0FBQyxDQUFDO2FBQ2pCLENBQUM7WUFDRixXQUFXLENBQUMsR0FBRyxDQUFDLFlBQVksRUFBRSxLQUFLLENBQUMsQ0FBQztRQUN2QyxDQUFDO1FBQ0QsT0FB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

package/package.json

@@ -2,7 +2,7 @@
   "author": "Task Venture Capital GmbH",
   "license": "MIT",
   "name": "@modelprofile.com/flexharness-agent",
-  "version": "9.9.0",
+  "version": "9.10.0",
   "type": "module",
   "description": "Standalone event-driven agent runtime with generation transactions, context and tool execution contracts.",
   "main": "./dist_ts_agent/index.js",
@@ -18,7 +18,7 @@
     }
   },
   "dependencies": {
-    "@modelprofile.com/flexharness-models": "9.9.0",
+    "@modelprofile.com/flexharness-models": "9.10.0",
     "ai": "^7.0.107",
     "zod": "^4.4.1",
     "@noble/hashes": "^2.4.0",

package/readme.md

@@ -274,10 +274,34 @@ export async function createReviewedDraft(
 
 The `review` callback belongs to your application. While awaiting acceptance, `candidate.messages` includes the candidate, but `getModelMessages()` excludes it from ordinary future context. Acceptance includes the generation; rejection keeps it in the canonical event history while excluding it from future context. Generation IDs identify transactions within a session; use a distinct ID for each new transaction.
 
+`generate({ transaction, stop })` takes a second signal for the owner's stop, the way a user stops a turn. It ends the generation like `abort`, but the interrupted outcome records the stop (`stopped: true`, also accepted by `finalizeGeneration(transaction, 'interrupted', { stopped: true })` for a generation stopped after its execution completed). A stopped generation stays in future context once its model produced output: its prompt, the input it took in, the text its running model step streamed and the tool calls it issued. Each tool call without a recorded result is closed with an error result saying its effect is unknown, so the next request is well-formed for every provider. A generation stopped before any model output leaves no trace, so its prompt can be sent again without appearing twice. `isGenerationInModelContext(events, generationId)` applies the same rule to a list of events, for a caller that needs to know whether a finished generation stayed in context. Aborted and failed generations, and generations a restart interrupted, stay out of future context as before. `stop` requires a transactional generation.
+
 Closing a session or restoring a stored session interrupts unfinished transactions. Restoration does not automatically rerun them. Persisted transactions require an `IAgentEventStoreV2` store with `eventSchemaVersion: 2`; without a store, transactions are process-local.
 
 A rejected generation does not roll back external tool effects. The runtime records transactional tool-execution intents and results. If a crash leaves an intent without a known result, inspect `listUncertainToolExecutions()` and reconcile the external operation through `reconcileToolExecution()` before treating its outcome as known. This is not a general exactly-once guarantee for external services.
 
+## Take input while a generation runs
+
+Pass an `AgentPendingInputQueue` to `generate({ pendingInput })` to let the user steer a running generation. The generation takes waiting input in at every step boundary, after the tool results of the previous model step are recorded and before the next model call, and records each input as a user message of the generation (`inputId` set). A running tool call is never interrupted. `onInputApplied` is called for each input once it is durable, before the next model call; every durable input is reported, also when reporting an earlier one throws, and the generation then fails with that error. Input the generation could not record durably counts as never taken in: the generation gives it back to the queue with `restore()`.
+
+```typescript
+import { AgentPendingInputQueue } from '@modelprofile.com/flexharness-agent';
+
+const pendingInput = new AgentPendingInputQueue();
+const transaction = await session.beginGeneration('Plan the release.');
+const generation = session.generate({
+  transaction,
+  pendingInput,
+  onInputApplied: ({ inputId, eventId }) => markApplied(inputId, eventId),
+});
+// While the generation runs:
+pendingInput.add({ inputId: 'steer-1', content: 'Keep the migration out of it.' });
+await generation;
+const unapplied = pendingInput.close(); // input the generation never took in
+```
+
+The generation closes the queue when it ends, whether it completed, failed or was aborted. `close()` returns the inputs it never took in, the same list on every call once the generation has ended; input that arrives during the last model step is among them, and so is input the generation drained but could not record durably. After closing, `add()` throws `AgentPendingInputRejectedError` with reason `closed`, and a reused `inputId` is refused with reason `duplicate`. The caller decides what becomes of unapplied input, for example sending it as the next turn.
+
 ## Events, storage and context
 
 Canonical events retain user and assistant messages, tool calls and results, runtime events, compaction records and transaction outcomes. `getEvents()` returns this history; `getModelMessages()` projects the model-visible conversation through the configured `contextBuilder`, which defaults to `buildModelMessages`.

package/ts_agent/classes.sessionengine.ts

@@ -20,8 +20,13 @@ import {
   type IUserMessageEvent,
   type TAgentEvent,
   type TAgentGenerationOutcome,
+  type TAgentToolCallPart,
   type TAgentToolResultOutput,
 } from './smartagent.events.js';
+import type {
+  AgentPendingInputQueue,
+  IAgentAppliedInput,
+} from './smartagent.pendinginput.js';
 import {
   AgentGenerationLeaseCleanupError,
   ContextOverflowError,
@@ -31,6 +36,7 @@ import {
   type IAgentGenerationLease,
   type IAgentCompactOptions,
   type IAgentBeginGenerationOptions,
+  type IAgentFinalizeGenerationOptions,
   type IAgentSession,
   type IAgentSessionAbortOptions,
   type IAgentSessionChange,
@@ -101,8 +107,11 @@ interface IScheduledGeneration {
   cache?: TAgentCacheSetting;
   maxSteps?: number;
   abort?: AbortSignal;
+  stop?: AbortSignal;
   transaction?: IAgentGenerationHandle;
   prepare?: TAgentGenerationPrepare;
+  pendingInput?: AgentPendingInputQueue;
+  onInputApplied?: (input: IAgentAppliedInput) => void | Promise<void>;
   timer: NodeJS.Timeout;
   controller: AbortController;
   removeAbortListener: () => void;
@@ -821,6 +830,7 @@ export class AgentSessionEngine implements IAgentSession {
     generationId: string,
     outcome: TAgentGenerationOutcome,
     reason?: string,
+    stopped = false,
   ): Promise<void> {
     const transaction = this.transaction(generationId);
     if (
@@ -853,6 +863,7 @@ export class AgentSessionEngine implements IAgentSession {
       generationId,
       outcome,
       reason,
+      ...(stopped ? { stopped: true } : {}),
       parentIds: [parent.id],
     }));
     await this.flushPersistence();
@@ -874,6 +885,7 @@ export class AgentSessionEngine implements IAgentSession {
   public finalizeGeneration(
     transaction: IAgentGenerationHandle,
     outcome: TAgentGenerationOutcome,
+    options: IAgentFinalizeGenerationOptions = {},
   ): Promise<void> {
     const capabilityError = this.transactionalStoreCapabilityError();
     if (capabilityError) return Promise.reject(capabilityError);
@@ -881,6 +893,9 @@ export class AgentSessionEngine implements IAgentSession {
       if (!['accepted', 'rejected', 'interrupted'].includes(outcome)) {
         throw new Error(`Invalid transactional generation outcome "${String(outcome)}".`);
       }
+      if (options.stopped === true && outcome !== 'interrupted') {
+        throw new Error('Only an interrupted transactional generation can be stopped.');
+      }
       const state = this.verifyGenerationClaim(transaction);
       if (!('begun' in state)) {
         if (state.outcome === outcome) return;
@@ -888,7 +903,12 @@ export class AgentSessionEngine implements IAgentSession {
           `Transactional generation "${transaction.generationId}" already has outcome "${state.outcome}".`,
         );
       }
-      await this.appendGenerationOutcome(transaction.generationId, outcome);
+      await this.appendGenerationOutcome(
+        transaction.generationId,
+        outcome,
+        undefined,
+        options.stopped === true,
+      );
     });
   }
 
@@ -1024,6 +1044,9 @@ export class AgentSessionEngine implements IAgentSession {
       ? this.transactionalStoreCapabilityError()
       : undefined;
     if (capabilityError) return Promise.reject(capabilityError);
+    if (options.stop && !options.transaction) {
+      return Promise.reject(new Error('A stop signal requires a transactional generation.'));
+    }
     if (!options.key.trim()) return Promise.reject(new Error('Scheduled generation key must not be empty.'));
     const debounceMs = options.debounceMs ?? 50;
     if (!Number.isSafeInteger(debounceMs) || debounceMs < 0) {
@@ -1039,7 +1062,10 @@ export class AgentSessionEngine implements IAgentSession {
         || existing.cache !== options.cache
         || existing.maxSteps !== options.maxSteps
         || existing.abort !== options.abort
+        || existing.stop !== options.stop
         || existing.prepare !== options.prepare
+        || existing.pendingInput !== options.pendingInput
+        || existing.onInputApplied !== options.onInputApplied
         || existing.transaction?.generationId !== options.transaction?.generationId
         || existing.transaction?.claimToken !== options.transaction?.claimToken
       ) {
@@ -1053,8 +1079,9 @@ export class AgentSessionEngine implements IAgentSession {
       return existing.promise;
     }
 
-    if (options.abort?.aborted) {
-      const abortReason = options.abort.reason ?? new DOMException('Aborted', 'AbortError');
+    const endedBy = options.abort?.aborted ? options.abort : options.stop?.aborted ? options.stop : undefined;
+    if (endedBy) {
+      const abortReason = endedBy.reason ?? new DOMException('Aborted', 'AbortError');
       if (!options.transaction) return Promise.reject(abortReason);
       return this.queueExclusive(async () => {
         const transaction = this.verifyGenerationClaim(options.transaction!);
@@ -1082,9 +1109,11 @@ export class AgentSessionEngine implements IAgentSession {
     const controller = new AbortController();
     const onAbort = () => this.cancelScheduledGeneration(
       options.key,
-      options.abort?.reason ?? new DOMException('Aborted', 'AbortError'),
+      (options.abort?.aborted ? options.abort.reason : options.stop?.reason)
+        ?? new DOMException('Aborted', 'AbortError'),
     );
     options.abort?.addEventListener('abort', onAbort, { once: true });
+    options.stop?.addEventListener('abort', onAbort, { once: true });
     const scheduled: IScheduledGeneration = {
       state: 'debouncing',
       debounceMs,
@@ -1095,11 +1124,17 @@ export class AgentSessionEngine implements IAgentSession {
       cache: options.cache,
       maxSteps: options.maxSteps,
       abort: options.abort,
+      stop: options.stop,
       transaction: options.transaction,
       prepare: options.prepare,
+      pendingInput: options.pendingInput,
+      onInputApplied: options.onInputApplied,
       timer: setTimeout(() => this.startScheduledGeneration(options.key), debounceMs),
       controller,
-      removeAbortListener: () => options.abort?.removeEventListener('abort', onAbort),
+      removeAbortListener: () => {
+        options.abort?.removeEventListener('abort', onAbort);
+        options.stop?.removeEventListener('abort', onAbort);
+      },
       promise,
       resolve,
       reject,
@@ -1120,8 +1155,11 @@ export class AgentSessionEngine implements IAgentSession {
       cache: scheduled.cache,
       maxSteps: scheduled.maxSteps,
       abort: scheduled.controller.signal,
+      stop: scheduled.stop,
       transaction: scheduled.transaction,
       prepare: scheduled.prepare,
+      pendingInput: scheduled.pendingInput,
+      onInputApplied: scheduled.onInputApplied,
     }).then(
       (result) => this.settleScheduledGeneration(key, scheduled, () => scheduled.resolve(result)),
       (error) => this.settleScheduledGeneration(key, scheduled, () => scheduled.reject(error)),
@@ -1149,6 +1187,7 @@ export class AgentSessionEngine implements IAgentSession {
     const cancellationReason = reason
       ?? new DOMException('Scheduled generation cancelled', 'AbortError');
     if (!scheduled.controller.signal.aborted) scheduled.controller.abort(cancellationReason);
+    scheduled.pendingInput?.close();
     if (!scheduled.transaction) {
       scheduled.reject(cancellationReason);
       return true;
@@ -1720,6 +1759,9 @@ export class AgentSessionEngine implements IAgentSession {
       ? this.transactionalStoreCapabilityError()
       : undefined;
     if (capabilityError) return Promise.reject(capabilityError);
+    if (options.stop && !options.transaction) {
+      return Promise.reject(new Error('A stop signal requires a transactional generation.'));
+    }
     const run = this.generationQueue.then(async () => {
       if (!options.transaction) options.abort?.throwIfAborted();
       if (!options.transaction && this.sessionAbortController.signal.aborted) {
@@ -1730,6 +1772,9 @@ export class AgentSessionEngine implements IAgentSession {
       if (this.maintenanceError !== undefined) throw this.maintenanceError;
       await this.runEventRetentionLocked();
       return this.generateLocked(options);
+    }).finally(() => {
+      // The generation takes no further input; what it never took in stays with the queue.
+      options.pendingInput?.close();
     });
     this.generationQueue = run.then(() => undefined, () => undefined);
     // A transactional generation is not raced against its abort signal: it settles when its
@@ -1801,6 +1846,7 @@ export class AgentSessionEngine implements IAgentSession {
       this.sessionAbortController.signal,
       generationAbortController.signal,
       options.abort,
+      options.stop,
     ]);
 
     let lease: IAgentGenerationLease | undefined;
@@ -1862,6 +1908,8 @@ export class AgentSessionEngine implements IAgentSession {
       const reportCompactionUsage: TAgentModelCallUsageReporter = (call) =>
         recordModelCallUsage({ ...call, source: 'compaction', generationId });
       let currentInferenceId: string | undefined;
+      /** Text the current inference streamed so far, kept if the inference is interrupted. */
+      let inferenceText = '';
       let latestInferenceVisibleIds = new Set(this.events.map((event) => event.id));
       const completedInferenceIds = new Set<string>();
       const reasoningTextById = new Map<string, string>();
@@ -1889,10 +1937,90 @@ export class AgentSessionEngine implements IAgentSession {
             : undefined,
         }));
         currentInferenceId = marker.id;
+        inferenceText = '';
         latestInferenceVisibleIds = new Set(this.events.map((event) => event.id));
         await this.flushPersistence();
         return marker.id;
       };
+      const applyPendingInput = async (): Promise<void> => {
+        const inputs = options.pendingInput?.drain() ?? [];
+        if (inputs.length === 0) return;
+        const applied: IAgentAppliedInput[] = [];
+        try {
+          for (const input of inputs) {
+            const event = this.commitEvent(createAgentEvent<IUserMessageEvent>({
+              type: 'user-message',
+              content: input.content,
+              inputId: input.inputId,
+              generationId,
+              parentIds: this.events.length > 0
+                ? [this.events[this.events.length - 1].id]
+                : undefined,
+            }));
+            applied.push({
+              inputId: input.inputId,
+              eventId: event.id,
+              generationId,
+              completedSteps: stepCount,
+            });
+          }
+          await this.flushPersistence();
+        } catch (error) {
+          // Input that is not durable was not taken in: the queue returns it from close().
+          options.pendingInput!.restore(inputs);
+          throw error;
+        }
+        // Every durable input is reported, also when reporting an earlier one failed.
+        const callbackErrors: unknown[] = [];
+        for (const input of applied) {
+          try {
+            await this.invokeGenerationCallback(() => options.onInputApplied?.(input));
+          } catch (error) {
+            callbackErrors.push(error);
+          }
+        }
+        if (callbackErrors.length === 1) throw callbackErrors[0];
+        if (callbackErrors.length > 1) {
+          throw new AggregateError(callbackErrors, 'Reporting applied pending input failed.');
+        }
+      };
+      /**
+       * Keeps what a stopped inference produced: the text it streamed and the tool calls it
+       * issued, as one assistant message of the generation. Tool calls without a result are
+       * closed when the stopped generation is rendered for the model.
+       */
+      const commitInterruptedInference = async (): Promise<void> => {
+        const inferenceId = currentInferenceId;
+        if (!options.stop?.aborted || !inferenceId || completedInferenceIds.has(inferenceId)) return;
+        completedInferenceIds.add(inferenceId);
+        if (this.events.some((event) =>
+          event.type === 'assistant-message' && event.inferenceId === inferenceId)) return;
+        const toolCallParts: TAgentToolCallPart[] = this.events
+          .filter((event): event is IToolCallEvent =>
+            event.type === 'tool-call'
+            && event.generationId === generationId
+            && event.inferenceId === inferenceId)
+          .map((event) => ({
+            type: 'tool-call',
+            toolCallId: event.toolCallId,
+            toolName: event.toolName,
+            input: event.input,
+            ...(event.providerExecuted === undefined ? {} : { providerExecuted: event.providerExecuted }),
+            ...(event.providerOptions === undefined ? {} : { providerOptions: event.providerOptions }),
+          }));
+        if (!inferenceText && toolCallParts.length === 0) return;
+        this.commitEvent(createAgentEvent<IAssistantMessageEvent>({
+          type: 'assistant-message',
+          content: [
+            ...(inferenceText ? [{ type: 'text' as const, text: inferenceText }] : []),
+            ...toolCallParts,
+          ],
+          generationId,
+          inferenceId,
+          causationId: inferenceId,
+        }));
+        await this.flushPersistence();
+      };
       const allTools = this.wrapToolsForGeneration(
         generationId,
         runtime.tools,
@@ -1918,6 +2046,7 @@ export class AgentSessionEngine implements IAgentSession {
         let streamError: unknown;
         try {
           currentInferenceId = undefined;
+          inferenceText = '';
           const result = plugins.streamText({
             model: runtime.model,
             instructions: runtime.system,
@@ -1929,6 +2058,7 @@ export class AgentSessionEngine implements IAgentSession {
             maxRetries: 0,
             abortSignal: combinedAbort.signal,
             prepareStep: async () => {
+              await applyPendingInput();
               await beginInference();
               return { messages: this.buildContext(this.eventsByIds(latestInferenceVisibleIds)) };
             },
@@ -1959,7 +2089,9 @@ export class AgentSessionEngine implements IAgentSession {
               const chunkType = String((chunk as { type?: unknown }).type ?? '');
               if (chunkType === 'text-delta') {
                 const textChunk = chunk as { delta?: string; textDelta?: string; text?: string };
-                this.options.onToken?.(textChunk.delta ?? textChunk.textDelta ?? textChunk.text ?? '');
+                const delta = textChunk.delta ?? textChunk.textDelta ?? textChunk.text ?? '';
+                inferenceText += delta;
+                this.options.onToken?.(delta);
                 return;
               }
               if (chunkType === 'tool-result') {
@@ -2245,8 +2377,11 @@ export class AgentSessionEngine implements IAgentSession {
           flushReasoning();
           const effectiveError = streamError ?? error;
           if (combinedAbort.signal.aborted) {
+            await commitInterruptedInference();
             throw combinedAbort.signal.reason ?? new DOMException('Aborted', 'AbortError');
           }
+          // A failed attempt is retried or fails the generation; its partial text is not kept.
+          inferenceText = '';
           if (effectiveError instanceof DOMException && effectiveError.name === 'AbortError') {
             throw effectiveError;
           }
@@ -2344,6 +2479,7 @@ export class AgentSessionEngine implements IAgentSession {
                 generationId,
                 'interrupted',
                 this.transactionOutcomeErrorReason(effectiveError),
+                options.stop?.aborted === true,
               );
             } else {
               const transaction = this.transaction(generationId);
@@ -2366,6 +2502,7 @@ export class AgentSessionEngine implements IAgentSession {
                   generationId,
                   'interrupted',
                   this.transactionOutcomeErrorReason(abortError),
+                  options.stop?.aborted === true,
                 );
                 throw abortError;
               }

package/ts_agent/index.ts

@@ -6,6 +6,7 @@ export {
   getAgentGenerationTransactions,
   getOpenAgentGenerationTransactions,
   getUncertainToolExecutionIntents,
+  isGenerationInModelContext,
   isTransactionalGeneration,
 } from './smartagent.transactions.js';
 export {
@@ -13,6 +14,15 @@ export {
   createAgentEventId,
   modelMessagesToAgentEvents,
 } from './smartagent.events.js';
+export {
+  AgentPendingInputQueue,
+  AgentPendingInputRejectedError,
+} from './smartagent.pendinginput.js';
+export type {
+  IAgentAppliedInput,
+  IAgentPendingInput,
+  TAgentPendingInputRejection,
+} from './smartagent.pendinginput.js';
 export { ToolRegistry } from './smartagent.classes.toolregistry.js';
 export { AgentModelCallUsageRecorder } from './smartagent.usage.js';
 export type { IAgentModelCallUsageRecorderModel } from './smartagent.usage.js';
@@ -35,6 +45,7 @@ export type {
   IAgentCompactOptions,
   IAgentEventRetentionOptions,
   IAgentBeginGenerationOptions,
+  IAgentFinalizeGenerationOptions,
   IAgentGenerateOptions,
   IAgentGenerateResult,
   IAgentGenerationHandle,

package/ts_agent/readme.md

@@ -274,10 +274,34 @@ export async function createReviewedDraft(
 
 The `review` callback belongs to your application. While awaiting acceptance, `candidate.messages` includes the candidate, but `getModelMessages()` excludes it from ordinary future context. Acceptance includes the generation; rejection keeps it in the canonical event history while excluding it from future context. Generation IDs identify transactions within a session; use a distinct ID for each new transaction.
 
+`generate({ transaction, stop })` takes a second signal for the owner's stop, the way a user stops a turn. It ends the generation like `abort`, but the interrupted outcome records the stop (`stopped: true`, also accepted by `finalizeGeneration(transaction, 'interrupted', { stopped: true })` for a generation stopped after its execution completed). A stopped generation stays in future context once its model produced output: its prompt, the input it took in, the text its running model step streamed and the tool calls it issued. Each tool call without a recorded result is closed with an error result saying its effect is unknown, so the next request is well-formed for every provider. A generation stopped before any model output leaves no trace, so its prompt can be sent again without appearing twice. `isGenerationInModelContext(events, generationId)` applies the same rule to a list of events, for a caller that needs to know whether a finished generation stayed in context. Aborted and failed generations, and generations a restart interrupted, stay out of future context as before. `stop` requires a transactional generation.
+
 Closing a session or restoring a stored session interrupts unfinished transactions. Restoration does not automatically rerun them. Persisted transactions require an `IAgentEventStoreV2` store with `eventSchemaVersion: 2`; without a store, transactions are process-local.
 
 A rejected generation does not roll back external tool effects. The runtime records transactional tool-execution intents and results. If a crash leaves an intent without a known result, inspect `listUncertainToolExecutions()` and reconcile the external operation through `reconcileToolExecution()` before treating its outcome as known. This is not a general exactly-once guarantee for external services.
 
+## Take input while a generation runs
+
+Pass an `AgentPendingInputQueue` to `generate({ pendingInput })` to let the user steer a running generation. The generation takes waiting input in at every step boundary, after the tool results of the previous model step are recorded and before the next model call, and records each input as a user message of the generation (`inputId` set). A running tool call is never interrupted. `onInputApplied` is called for each input once it is durable, before the next model call; every durable input is reported, also when reporting an earlier one throws, and the generation then fails with that error. Input the generation could not record durably counts as never taken in: the generation gives it back to the queue with `restore()`.
+
+```typescript
+import { AgentPendingInputQueue } from '@modelprofile.com/flexharness-agent';
+
+const pendingInput = new AgentPendingInputQueue();
+const transaction = await session.beginGeneration('Plan the release.');
+const generation = session.generate({
+  transaction,
+  pendingInput,
+  onInputApplied: ({ inputId, eventId }) => markApplied(inputId, eventId),
+});
+// While the generation runs:
+pendingInput.add({ inputId: 'steer-1', content: 'Keep the migration out of it.' });
+await generation;
+const unapplied = pendingInput.close(); // input the generation never took in
+```
+
+The generation closes the queue when it ends, whether it completed, failed or was aborted. `close()` returns the inputs it never took in, the same list on every call once the generation has ended; input that arrives during the last model step is among them, and so is input the generation drained but could not record durably. After closing, `add()` throws `AgentPendingInputRejectedError` with reason `closed`, and a reused `inputId` is refused with reason `duplicate`. The caller decides what becomes of unapplied input, for example sending it as the next turn.
+
 ## Events, storage and context
 
 Canonical events retain user and assistant messages, tool calls and results, runtime events, compaction records and transaction outcomes. `getEvents()` returns this history; `getModelMessages()` projects the model-visible conversation through the configured `contextBuilder`, which defaults to `buildModelMessages`.

package/ts_agent/smartagent.events.ts

@@ -35,6 +35,8 @@ export interface IUserMessageEvent extends IAgentEventBase {
   type: 'user-message';
   content: TAgentUserMessage['content'];
   providerOptions?: TAgentUserMessage['providerOptions'];
+  /** Set when a running generation took the message in from its pending input. */
+  inputId?: string;
 }
 
 export interface IAssistantMessageEvent extends IAgentEventBase {
@@ -106,6 +108,11 @@ export interface IGenerationOutcomeEvent extends IAgentEventBase {
   generationId: string;
   outcome: TAgentGenerationOutcome;
   reason?: string;
+  /**
+   * Set on an `interrupted` outcome whose owner stopped the generation: what its model produced
+   * stays in the model context.
+   */
+  stopped?: boolean;
 }
 
 export interface IToolExecutionIntentEvent extends IAgentEventBase {