@oh-my-pi/pi-agent-core 18.4.4 → 18.4.6

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## [Unreleased]
 
+## [18.4.6] - 2026-10-01
+
+### Added
+
+- Added APIs for improving agent follow-up and steering workflow management, including moving queued follow-ups into steering with a single queue-change notification.
+- Added support for trusted post-tool guidance via `afterToolCall` results, allowing additional context to be included in the next provider request, including after tool failures.
+
 ## [18.4.4] - 2026-09-29
 
 ### Added

package/dist/types/agent.d.ts

@@ -477,6 +477,13 @@ export declare class Agent {
      * delivery are dropped here exactly as {@link replaceQueues} does.
      */
     replaceQueue(queue: "steering" | "followUp", messages: readonly AgentMessage[]): void;
+    /**
+     * Install `followUp` as the pending follow-up queue (same claim handling as
+     * {@link replaceQueue}) and append `promoted` to the steering queue, then notify
+     * queue listeners once. A live steering claim is left alone. Listeners never
+     * observe the moved messages in both queues or in neither.
+     */
+    moveFollowUpsToSteering(followUp: readonly AgentMessage[], promoted: readonly AgentMessage[]): void;
     appendMessage(m: AgentMessage): void;
     popMessage(): AgentMessage | undefined;
     /**

package/dist/types/compaction/pruning.d.ts

@@ -43,6 +43,12 @@ export declare const DEFAULT_PRUNE_CONFIG: PruneConfig;
 export interface PruneResult {
     prunedCount: number;
     tokensSaved: number;
+    /**
+     * Restore every result this pass blanked. Pruning mutates entries in place,
+     * so a caller whose persistence of the pruned history fails calls this to keep
+     * memory matching what is durable.
+     */
+    undo(): void;
 }
 /** Exact placeholder written over a superseded tool result. */
 export declare const SUPERSEDED_NOTICE = "[Superseded by a newer read of this file]";

package/dist/types/types.d.ts

@@ -808,6 +808,13 @@ export interface AfterToolCallResult {
     isError?: boolean;
     /** If provided, replaces the contextually-useless flag carried with the tool result. */
     useless?: boolean;
+    /**
+     * Trusted post-tool instructions for the next provider request. Delivered
+     * outside the tool result, after all calls in the batch settle. Unlike
+     * `BeforeToolCallResult.additionalContext`, this is retained for error
+     * results because the callback receives the finalized outcome.
+     */
+    additionalContext?: string;
 }
 /** Context passed to `beforeToolCall`. */
 export interface BeforeToolCallContext {

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-agent-core",
-	"version": "18.4.4",
+	"version": "18.4.6",
 	"description": "General-purpose agent with transport abstraction, state management, and attachment support",
 	"homepage": "https://omp.sh",
 	"author": {
@@ -38,16 +38,16 @@
 		"fmt": "oxfmt --no-error-on-unmatched-pattern 'src/**/*.{ts,tsx}' '{test,bench,examples,scripts}/**/*.ts' '*.ts'"
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-ai": "18.4.4",
-		"@oh-my-pi/pi-catalog": "18.4.4",
-		"@oh-my-pi/pi-natives": "18.4.4",
-		"@oh-my-pi/pi-utils": "18.4.4",
-		"@oh-my-pi/pi-wire": "18.4.4",
-		"@oh-my-pi/snapcompact": "18.4.4",
+		"@oh-my-pi/pi-ai": "18.4.6",
+		"@oh-my-pi/pi-catalog": "18.4.6",
+		"@oh-my-pi/pi-natives": "18.4.6",
+		"@oh-my-pi/pi-utils": "18.4.6",
+		"@oh-my-pi/pi-wire": "18.4.6",
+		"@oh-my-pi/snapcompact": "18.4.6",
 		"@opentelemetry/api": "^1.9.1"
 	},
 	"devDependencies": {
-		"@oh-my-pi/omptype": "18.4.4",
+		"@oh-my-pi/omptype": "18.4.6",
 		"@opentelemetry/context-async-hooks": "^2.9.0",
 		"@opentelemetry/sdk-trace-base": "^2.9.0",
 		"@types/bun": "^1.3.14"

package/src/agent-loop.ts

@@ -3470,6 +3470,9 @@ async function executeToolCalls(
 						});
 						result = coerced.result;
 						isError = coerced.malformed || (after.isError ?? isError);
+						if (isNonBlankContext(after.additionalContext)) {
+							record.reportedContext.push(after.additionalContext);
+						}
 					}
 				} catch (e) {
 					caughtError = e;

package/src/agent.ts

@@ -1252,6 +1252,20 @@ export class Agent {
 		this.#emitQueueChanged();
 	}
 
+	/**
+	 * Install `followUp` as the pending follow-up queue (same claim handling as
+	 * {@link replaceQueue}) and append `promoted` to the steering queue, then notify
+	 * queue listeners once. A live steering claim is left alone. Listeners never
+	 * observe the moved messages in both queues or in neither.
+	 */
+	moveFollowUpsToSteering(followUp: readonly AgentMessage[], promoted: readonly AgentMessage[]): void {
+		this.#followUpQueue = followUp.slice();
+		this.#cancelQueuedMessagePreparation("followUp");
+		this.#steeringQueue.push(...promoted);
+		this.#notifySteeringWaiters();
+		this.#emitQueueChanged();
+	}
+
 	appendMessage(m: AgentMessage) {
 		this.#state.messages.push(m);
 		const live = this.#liveSteered.findIndex(entry => entry.message === m);

package/src/compaction/pruning.ts

@@ -62,6 +62,34 @@ export const DEFAULT_PRUNE_CONFIG: PruneConfig = {
 export interface PruneResult {
 	prunedCount: number;
 	tokensSaved: number;
+	/**
+	 * Restore every result this pass blanked. Pruning mutates entries in place,
+	 * so a caller whose persistence of the pruned history fails calls this to keep
+	 * memory matching what is durable.
+	 */
+	undo(): void;
+}
+
+const NOTHING_PRUNED: PruneResult = { prunedCount: 0, tokensSaved: 0, undo: () => {} };
+
+/** Blank `message` to `notice`, returning the step that restores it. */
+function blankToolResult(message: ToolResultMessage, notice: string, prunedAt: number): () => void {
+	const { content, prunedAt: previousPrunedAt } = message;
+	message.content = [{ type: "text", text: notice }];
+	message.prunedAt = prunedAt;
+	invalidateMessageCache(message as AgentMessage);
+	return () => {
+		message.content = content;
+		message.prunedAt = previousPrunedAt;
+		invalidateMessageCache(message as AgentMessage);
+	};
+}
+
+/** Combine per-message restore steps into one {@link PruneResult.undo}. */
+function undoAll(steps: Array<() => void>): () => void {
+	return () => {
+		for (const step of steps) step();
+	};
 }
 
 /** Exact placeholder written over a superseded tool result. */
@@ -257,7 +285,7 @@ export function pruneSupersededToolResults(
 		candidates.push(...collectUselessResults(entries, tokenizer, toolCallsById, config.protectedTools, exclude));
 		candidates.sort((a, b) => a.index - b.index);
 	}
-	if (candidates.length === 0) return { prunedCount: 0, tokensSaved: 0 };
+	if (candidates.length === 0) return NOTHING_PRUNED;
 
 	const now = config.now ?? Date.now();
 	let lastMessageTimestamp: number | undefined;
@@ -290,17 +318,15 @@ export function pruneSupersededToolResults(
 			candidate => candidate.index >= boundaryIndex && suffixTokens[candidate.index] <= suffixTokenLimit,
 		);
 	}
-	if (toPrune.length === 0) return { prunedCount: 0, tokensSaved: 0 };
+	if (toPrune.length === 0) return NOTHING_PRUNED;
 
 	const prunedAt = Date.now();
 	let tokensSaved = 0;
-	for (const candidate of toPrune) {
-		candidate.message.content = [{ type: "text", text: candidate.notice }];
-		candidate.message.prunedAt = prunedAt;
-		invalidateMessageCache(candidate.message as AgentMessage);
+	const steps = toPrune.map(candidate => {
 		tokensSaved += estimatePrunedSavings(candidate.tokens, candidate.notice);
-	}
-	return { prunedCount: toPrune.length, tokensSaved };
+		return blankToolResult(candidate.message, candidate.notice, prunedAt);
+	});
+	return { prunedCount: toPrune.length, tokensSaved, undo: undoAll(steps) };
 }
 
 export function pruneToolOutputs(
@@ -310,7 +336,6 @@ export function pruneToolOutputs(
 ): PruneResult {
 	let accumulatedTokens = 0;
 	let tokensSaved = 0;
-	let prunedCount = 0;
 
 	const candidates: Array<{ entry: SessionMessageEntry; tokens: number; superseded: boolean; useless: boolean }> = [];
 	const toolCallsById = collectToolCallsById(entries);
@@ -394,24 +419,20 @@ export function pruneToolOutputs(
 	}
 
 	if (tokensSaved < config.minimumSavings || candidates.length === 0) {
-		return { prunedCount: 0, tokensSaved: 0 };
+		return NOTHING_PRUNED;
 	}
 
 	const prunedAt = Date.now();
-	for (const candidate of candidates) {
-		const message = candidate.entry.message as ToolResultMessage;
+	const steps = candidates.map(candidate => {
 		const notice = candidate.superseded
 			? SUPERSEDED_NOTICE
 			: candidate.useless
 				? USELESS_NOTICE
 				: createPrunedNotice(candidate.tokens);
-		message.content = [{ type: "text", text: notice }];
-		message.prunedAt = prunedAt;
-		invalidateMessageCache(message as AgentMessage);
-		prunedCount++;
-	}
+		return blankToolResult(candidate.entry.message as ToolResultMessage, notice, prunedAt);
+	});
 
-	return { prunedCount, tokensSaved };
+	return { prunedCount: candidates.length, tokensSaved, undo: undoAll(steps) };
 }
 
 /**

package/src/types.ts

@@ -906,6 +906,13 @@ export interface AfterToolCallResult {
 	isError?: boolean;
 	/** If provided, replaces the contextually-useless flag carried with the tool result. */
 	useless?: boolean;
+	/**
+	 * Trusted post-tool instructions for the next provider request. Delivered
+	 * outside the tool result, after all calls in the batch settle. Unlike
+	 * `BeforeToolCallResult.additionalContext`, this is retained for error
+	 * results because the callback receives the finalized outcome.
+	 */
+	additionalContext?: string;
 }
 
 /** Context passed to `beforeToolCall`. */