@f5-sales-demo/pi-agent-core 20.2.3 → 20.2.6

package/CHANGELOG.md

@@ -3,6 +3,7 @@
 ## [Unreleased]
 
 ## [14.0.1] - 2026-04-08
+
 ### Added
 
 - Added `onAssistantMessageEvent` callback option to inspect assistant streaming events before they are emitted, enabling abort decisions before buffered events continue flowing
@@ -25,6 +26,7 @@
 - Fixed stale forced toolChoice being passed to provider after tools are refreshed mid-turn
 
 ## [13.9.16] - 2026-03-10
+
 ### Added
 
 - Added `onPayload` option to `AgentOptions` to inspect or replace provider payloads before they are sent
@@ -43,11 +45,13 @@
 - Updated `setThinkingLevel()` method to accept `Effort | undefined` instead of `ThinkingLevel` string
 
 ## [13.4.0] - 2026-03-01
+
 ### Added
 
 - Added `getToolChoice` option to dynamically override tool choice per LLM call
 
 ## [13.3.8] - 2026-02-28
+
 ### Changed
 
 - Changed intent field name from `agent__intent` to `_i` in tool schemas
@@ -55,12 +59,15 @@
 ### Fixed
 
 - Fixed synthetic tool result text formatting so aborted/error tool results no longer emit `Tool execution was aborted.: Request was aborted` style punctuation.
+
 ## [13.3.7] - 2026-02-27
+
 ### Added
 
 - Added `lenientArgValidation` option to tools to allow graceful handling of argument validation errors by passing raw arguments to execute() instead of returning an error to the LLM
 
 ## [13.3.1] - 2026-02-26
+
 ### Added
 
 - Added `topP`, `topK`, `minP`, `presencePenalty`, and `repetitionPenalty` options to `AgentOptions` for fine-grained sampling control
@@ -71,7 +78,9 @@
 ### Changed
 
 - Removed per-tool `agent__intent` field description from injected schema to reduce token usage; intent format is now documented once in the system prompt instead of repeated in every tool definition
+
 ## [12.19.0] - 2026-02-22
+
 ### Changed
 
 - Updated tool result messages to include error details when tool execution fails
@@ -316,4 +325,4 @@ Initial release under @oh-my-pi scope. See previous releases at [badlogic/pi-mon
 
 - `Agent` constructor now has all options optional (empty options use defaults).
 
-- `queueMessage()` is now synchronous (no longer returns a Promise).
+- `queueMessage()` is now synchronous (no longer returns a Promise).

package/README.md

@@ -15,17 +15,17 @@ import { Agent } from "@f5-sales-demo/pi-agent";
 import { getModel } from "@f5-sales-demo/pi-ai";
 
 const agent = new Agent({
-	initialState: {
-		systemPrompt: "You are a helpful assistant.",
-		model: getModel("anthropic", "claude-sonnet-4-20250514"),
-	},
+ initialState: {
+  systemPrompt: "You are a helpful assistant.",
+  model: getModel("anthropic", "claude-sonnet-4-20250514"),
+ },
 });
 
 agent.subscribe((event) => {
-	if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
-		// Stream just the new text chunk
-		process.stdout.write(event.assistantMessageEvent.delta);
-	}
+ if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
+  // Stream just the new text chunk
+  process.stdout.write(event.assistantMessageEvent.delta);
+ }
 });
 
 await agent.prompt("Hello!");
@@ -163,15 +163,15 @@ const agent = new Agent({
 
 ```typescript
 interface AgentState {
-	systemPrompt: string;
-	model: Model;
-	thinkingLevel: ThinkingLevel;
-	tools: AgentTool<any>[];
-	messages: AgentMessage[];
-	isStreaming: boolean;
-	streamMessage: AgentMessage | null; // Current partial during streaming
-	pendingToolCalls: Set<string>;
-	error?: string;
+ systemPrompt: string;
+ model: Model;
+ thinkingLevel: ThinkingLevel;
+ tools: AgentTool<any>[];
+ messages: AgentMessage[];
+ isStreaming: boolean;
+ streamMessage: AgentMessage | null; // Current partial during streaming
+ pendingToolCalls: Set<string>;
+ error?: string;
 }
 ```
 
@@ -219,7 +219,7 @@ await agent.waitForIdle(); // Wait for completion
 
 ```typescript
 const unsubscribe = agent.subscribe((event) => {
-	console.log(event.type);
+ console.log(event.type);
 });
 unsubscribe();
 ```
@@ -234,16 +234,16 @@ agent.setInterruptMode("immediate");
 
 // While agent is running tools
 agent.steer({
-	role: "user",
-	content: "Stop! Do this instead.",
-	timestamp: Date.now(),
+ role: "user",
+ content: "Stop! Do this instead.",
+ timestamp: Date.now(),
 });
 
 // Queue a follow-up to run after the current turn completes
 agent.followUp({
-	role: "user",
-	content: "After that, summarize the changes.",
-	timestamp: Date.now(),
+ role: "user",
+ content: "After that, summarize the changes.",
+ timestamp: Date.now(),
 });
 ```
 
@@ -256,9 +256,9 @@ Extend `AgentMessage` via declaration merging:
 
 ```typescript
 declare module "@f5-sales-demo/pi-agent" {
-	interface CustomAgentMessages {
-		notification: { role: "notification"; text: string; timestamp: number };
-	}
+ interface CustomAgentMessages {
+  notification: { role: "notification"; text: string; timestamp: number };
+ }
 }
 
 // Now valid
@@ -269,11 +269,11 @@ Handle custom types in `convertToLlm`:
 
 ```typescript
 const agent = new Agent({
-	convertToLlm: (messages) =>
-		messages.flatMap((m) => {
-			if (m.role === "notification") return []; // Filter out
-			return [m];
-		}),
+ convertToLlm: (messages) =>
+  messages.flatMap((m) => {
+   if (m.role === "notification") return []; // Filter out
+   return [m];
+  }),
 });
 ```
 
@@ -285,23 +285,23 @@ Define tools using `AgentTool`:
 import { Type } from "@sinclair/typebox";
 
 const readFileTool: AgentTool = {
-	name: "read_file",
-	label: "Read File", // For UI display
-	description: "Read a file's contents",
-	parameters: Type.Object({
-		path: Type.String({ description: "File path" }),
-	}),
-	execute: async (toolCallId, params, signal, onUpdate, context) => {
-		const content = await fs.readFile(params.path, "utf-8");
-
-		// Optional: stream progress
-		onUpdate?.({ content: [{ type: "text", text: "Reading..." }], details: {} });
-
-		return {
-			content: [{ type: "text", text: content }],
-			details: { path: params.path, size: content.length },
-		};
-	},
+ name: "read_file",
+ label: "Read File", // For UI display
+ description: "Read a file's contents",
+ parameters: Type.Object({
+  path: Type.String({ description: "File path" }),
+ }),
+ execute: async (toolCallId, params, signal, onUpdate, context) => {
+  const content = await fs.readFile(params.path, "utf-8");
+
+  // Optional: stream progress
+  onUpdate?.({ content: [{ type: "text", text: "Reading..." }], details: {} });
+
+  return {
+   content: [{ type: "text", text: content }],
+   details: { path: params.path, size: content.length },
+  };
+ },
 };
 
 agent.setTools([readFileTool]);
@@ -313,11 +313,11 @@ agent.setTools([readFileTool]);
 
 ```typescript
 execute: async (toolCallId, params, signal, onUpdate) => {
-	if (!fs.existsSync(params.path)) {
-		throw new Error(`File not found: ${params.path}`);
-	}
-	// Return content only on success
-	return { content: [{ type: "text", text: "..." }] };
+ if (!fs.existsSync(params.path)) {
+  throw new Error(`File not found: ${params.path}`);
+ }
+ // Return content only on success
+ return { content: [{ type: "text", text: "..." }] };
 };
 ```
 
@@ -331,12 +331,12 @@ For browser apps that proxy through a backend:
 import { Agent, streamProxy } from "@f5-sales-demo/pi-agent";
 
 const agent = new Agent({
-	streamFn: (model, context, options) =>
-		streamProxy(model, context, {
-			...options,
-			authToken: "...",
-			proxyUrl: "https://your-server.com",
-		}),
+ streamFn: (model, context, options) =>
+  streamProxy(model, context, {
+   ...options,
+   authToken: "...",
+   proxyUrl: "https://your-server.com",
+  }),
 });
 ```
 
@@ -348,25 +348,25 @@ For direct control without the Agent class:
 import { agentLoop, agentLoopContinue } from "@f5-sales-demo/pi-agent";
 
 const context: AgentContext = {
-	systemPrompt: "You are helpful.",
-	messages: [],
-	tools: [],
+ systemPrompt: "You are helpful.",
+ messages: [],
+ tools: [],
 };
 
 const config: AgentLoopConfig = {
-	model: getModel("openai", "gpt-4o"),
-	convertToLlm: (msgs) => msgs.filter((m) => ["user", "assistant", "toolResult"].includes(m.role)),
+ model: getModel("openai", "gpt-4o"),
+ convertToLlm: (msgs) => msgs.filter((m) => ["user", "assistant", "toolResult"].includes(m.role)),
 };
 
 const userMessage = { role: "user", content: "Hello", timestamp: Date.now() };
 
 for await (const event of agentLoop([userMessage], context, config)) {
-	console.log(event.type);
+ console.log(event.type);
 }
 
 // Continue from existing context
 for await (const event of agentLoopContinue(context, config)) {
-	console.log(event.type);
+ console.log(event.type);
 }
 ```
 

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@f5-sales-demo/pi-agent-core",
-	"version": "20.2.3",
+	"version": "20.2.6",
 	"description": "General-purpose agent with transport abstraction, state management, and attachment support",
 	"homepage": "https://github.com/f5-sales-demo/xcsh",
 	"author": "Can Boluk",
@@ -35,8 +35,8 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"@f5-sales-demo/pi-ai": "20.2.3",
-		"@f5-sales-demo/pi-utils": "20.2.3"
+		"@f5-sales-demo/pi-ai": "20.2.6",
+		"@f5-sales-demo/pi-utils": "20.2.6"
 	},
 	"devDependencies": {
 		"@sinclair/typebox": "^0.34",