@aragon-agent/core 0.2.60 → 0.2.62

package/dist/engine/agent.d.ts

@@ -130,6 +130,8 @@ export declare class Agent {
     subscribe(listener: AgentEventListener): () => void;
     /** Queue high-priority text; an optional ID is echoed only after history acceptance. */
     steer(message: string, id?: string): void;
+    /** Withdraw a queued steering message by its receipt ID; false if the engine already took it. */
+    removeQueuedSteering(id: string): boolean;
     /** Queue a low-priority follow-up message (consumed after end_turn). */
     followUp(message: string): void;
     setModel(model: ModelRef): void;

package/dist/engine/agent.js

@@ -160,6 +160,10 @@ export class Agent {
     steer(message, id) {
         this.messageQueueManager.pushSteering(message, id);
     }
+    /** Withdraw a queued steering message by its receipt ID; false if the engine already took it. */
+    removeQueuedSteering(id) {
+        return this.messageQueueManager.removeSteeringById(id);
+    }
     /** Queue a low-priority follow-up message (consumed after end_turn). */
     followUp(message) {
         this.messageQueueManager.pushFollowUp(message);

package/dist/engine/steering.d.ts

@@ -21,6 +21,13 @@ export declare class MessageQueueManager {
     drainSteering(): string[];
     /** Drain all pending envelopes in FIFO order (empties the same queue). */
     drainSteeringItems(): SteeringMessage[];
+    /**
+     * Remove the first pending steering envelope carrying `id`.
+     * Returns false when no such envelope is queued -- typically because the engine has
+     * already drained it. Synchronous on purpose: the caller treats the answer as the
+     * single authority on "was it withdrawn or delivered".
+     */
+    removeSteeringById(id: string): boolean;
     /** Whether there are pending steering messages. */
     hasSteering(): boolean;
     /** Enqueue a low-priority follow-up message. */

package/dist/engine/steering.js

@@ -25,6 +25,19 @@ export class MessageQueueManager {
     drainSteeringItems() {
         return this.steeringQueue.splice(0);
     }
+    /**
+     * Remove the first pending steering envelope carrying `id`.
+     * Returns false when no such envelope is queued -- typically because the engine has
+     * already drained it. Synchronous on purpose: the caller treats the answer as the
+     * single authority on "was it withdrawn or delivered".
+     */
+    removeSteeringById(id) {
+        const index = this.steeringQueue.findIndex((item) => item.id === id);
+        if (index < 0)
+            return false;
+        this.steeringQueue.splice(index, 1);
+        return true;
+    }
     /** Whether there are pending steering messages. */
     hasSteering() {
         return this.steeringQueue.length > 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aragon-agent/core",
-  "version": "0.2.60",
+  "version": "0.2.62",
   "description": "AragonAgent core engine — LLM provider adapters, streaming, tool registry/execution, steering, idle watchdog, and an optional isolated-vm sandbox.",
   "license": "MIT",
   "author": "AragonAgent contributors",