@sayknow-cli/agent-core 0.3.9 → 0.3.10

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [0.9.2] - 2026-07-09
+
+### Fixed
+
+- Follow-up queues can now mark individual messages as one-at-a-time, so interactive composer queues can remain sequential without disabling the existing batch mode for other callers.
+
 ## [0.8.2] - 2026-07-06
 ### Added
 

package/dist/types/agent.d.ts

@@ -323,8 +323,14 @@ export declare class Agent {
     /**
      * Queue a follow-up message to be processed after the agent finishes.
      * Delivered only when agent has no more tool calls or steering messages.
+     *
+     * `forceOneAtATime` lets UI composer queues preserve prompt-by-prompt
+     * delivery even when the session-wide follow-up mode is set to `all` for
+     * other integration paths.
      */
-    followUp(m: AgentMessage): void;
+    followUp(m: AgentMessage, options?: {
+        forceOneAtATime?: boolean;
+    }): void;
     clearSteeringQueue(): void;
     clearFollowUpQueue(): void;
     clearAllQueues(): void;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@sayknow-cli/agent-core",
-	"version": "0.3.9",
+	"version": "0.3.10",
 	"description": "General-purpose agent with transport abstraction, state management, and attachment support",
 	"homepage": "https://sayknow-cli.com",
 	"author": "jaybeyond",
@@ -35,9 +35,9 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"@sayknow-cli/ai": "0.3.9",
-		"@sayknow-cli/natives": "0.3.9",
-		"@sayknow-cli/utils": "0.3.9",
+		"@sayknow-cli/ai": "0.3.10",
+		"@sayknow-cli/natives": "0.3.10",
+		"@sayknow-cli/utils": "0.3.10",
 		"@opentelemetry/api": "^1.9.0"
 	},
 	"devDependencies": {

package/src/agent.ts

@@ -275,6 +275,7 @@ export class Agent {
 	#transformContext?: (messages: AgentMessage[], signal?: AbortSignal) => Promise<AgentMessage[]>;
 	#steeringQueue: AgentMessage[] = [];
 	#followUpQueue: AgentMessage[] = [];
+	#followUpForceOneAtATime = new WeakSet<AgentMessage>();
 	#steeringMode: "all" | "one-at-a-time";
 	#followUpMode: "all" | "one-at-a-time";
 	#interruptMode: "immediate" | "wait";
@@ -865,8 +866,15 @@ export class Agent {
 	/**
 	 * Queue a follow-up message to be processed after the agent finishes.
 	 * Delivered only when agent has no more tool calls or steering messages.
+	 *
+	 * `forceOneAtATime` lets UI composer queues preserve prompt-by-prompt
+	 * delivery even when the session-wide follow-up mode is set to `all` for
+	 * other integration paths.
 	 */
-	followUp(m: AgentMessage) {
+	followUp(m: AgentMessage, options?: { forceOneAtATime?: boolean }) {
+		if (options?.forceOneAtATime) {
+			this.#followUpForceOneAtATime.add(m);
+		}
 		this.#followUpQueue.push(m);
 	}
 
@@ -942,8 +950,18 @@ export class Agent {
 			}
 			return [];
 		}
-		const followUp = this.#followUpQueue.slice();
-		this.#followUpQueue = [];
+
+		const first = this.#followUpQueue[0];
+		if (!first) return [];
+		if (this.#followUpForceOneAtATime.has(first)) {
+			this.#followUpQueue = this.#followUpQueue.slice(1);
+			return [first];
+		}
+
+		const forcedIndex = this.#followUpQueue.findIndex(message => this.#followUpForceOneAtATime.has(message));
+		const takeCount = forcedIndex === -1 ? this.#followUpQueue.length : forcedIndex;
+		const followUp = this.#followUpQueue.slice(0, takeCount);
+		this.#followUpQueue = this.#followUpQueue.slice(takeCount);
 		return followUp;
 	}