@oh-my-pi/pi-agent-core 14.9.3 → 14.9.5

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [14.9.5] - 2026-05-12
+
+### Added
+
+- Added an `isError?: boolean` field on `AgentToolResult` so tools can flag a non-throwing failure (e.g. an aggregator that catches per-entry errors). `coerceToolResult` preserves the flag and the agent loop surfaces it as a tool error on the wire.
+
 ## [14.9.3] - 2026-05-10
 ### Added
 

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-agent-core",
-	"version": "14.9.3",
+	"version": "14.9.5",
 	"description": "General-purpose agent with transport abstraction, state management, and attachment support",
 	"homepage": "https://github.com/can1357/oh-my-pi",
 	"author": "Can Boluk",
@@ -35,9 +35,9 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-ai": "14.9.3",
-		"@oh-my-pi/pi-natives": "14.9.3",
-		"@oh-my-pi/pi-utils": "14.9.3"
+		"@oh-my-pi/pi-ai": "14.9.5",
+		"@oh-my-pi/pi-natives": "14.9.5",
+		"@oh-my-pi/pi-utils": "14.9.5"
 	},
 	"devDependencies": {
 		"@sinclair/typebox": "^0.34.49",

package/src/agent-loop.ts

@@ -58,12 +58,17 @@ function coerceToolResult(raw: unknown): { result: AgentToolResult<any>; malform
 	const rawObj = raw && typeof raw === "object" ? (raw as Record<string, unknown>) : null;
 	const rawContent = rawObj?.content;
 	const details = rawObj && "details" in rawObj ? rawObj.details : {};
+	// Tools may flag a non-throwing failure on the result itself (e.g. an
+	// aggregator that catches per-entry errors and synthesizes a combined
+	// result). Preserve the flag so agent-loop can surface it on the wire.
+	const explicitError = Boolean(rawObj && "isError" in rawObj && rawObj.isError);
 
 	if (!Array.isArray(rawContent)) {
 		return {
 			result: {
 				content: [{ type: "text", text: "Tool returned an invalid result: missing content array." }],
 				details,
+				isError: true,
 			},
 			malformed: true,
 		};
@@ -82,7 +87,7 @@ function coerceToolResult(raw: unknown): { result: AgentToolResult<any>; malform
 			content.push(block as { type: "image"; data: string; mimeType: string });
 		}
 	}
-	return { result: { content, details }, malformed: false };
+	return { result: { content, details, ...(explicitError ? { isError: true } : {}) }, malformed: false };
 }
 
 /**
@@ -827,7 +832,7 @@ async function executeToolCalls(
 			);
 			const coerced = coerceToolResult(rawResult);
 			result = coerced.result;
-			if (coerced.malformed) isError = true;
+			if (coerced.malformed || result.isError) isError = true;
 		} catch (e) {
 			result = {
 				content: [{ type: "text", text: e instanceof Error ? e.message : String(e) }],

package/src/types.ts

@@ -223,6 +223,9 @@ export interface AgentToolResult<T = any, _TInput = unknown> {
 	content: (TextContent | ImageContent)[];
 	// Details to be displayed in a UI or logged
 	details?: T;
+	// Marks a non-throwing failure (e.g. an aggregator catching per-entry errors).
+	// agent-loop honors this and surfaces it as a tool error on the wire.
+	isError?: boolean;
 }
 
 // Callback for streaming tool execution updates