@oh-my-pi/pi-agent-core 6.2.0 → 6.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/pi-agent-core",
-	"version": "6.2.0",
+	"version": "6.7.0",
 	"description": "General-purpose agent with transport abstraction, state management, and attachment support",
 	"type": "module",
 	"main": "./src/index.ts",
@@ -13,8 +13,8 @@
 		"test": "vitest --run"
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-ai": "6.2.0",
-		"@oh-my-pi/pi-tui": "6.2.0"
+		"@oh-my-pi/pi-ai": "6.7.0",
+		"@oh-my-pi/pi-tui": "6.7.0"
 	},
 	"keywords": [
 		"ai",

package/src/types.ts

@@ -165,15 +165,19 @@ export interface AgentState {
 	error?: string;
 }
 
-export interface AgentToolResult<T> {
+export interface AgentToolResult<T, TNormative extends TSchema = any> {
 	// Content blocks supporting text and images
 	content: (TextContent | ImageContent)[];
 	// Details to be displayed in a UI or logged
-	details: T;
+	details?: T;
+	/** Normative input for the tool result */
+	$normative?: Static<TNormative>;
 }
 
 // Callback for streaming tool execution updates
-export type AgentToolUpdateCallback<T = any> = (partialResult: AgentToolResult<T>) => void;
+export type AgentToolUpdateCallback<T = any, TNormative extends TSchema = any> = (
+	partialResult: AgentToolResult<T, TNormative>,
+) => void;
 
 /** Options passed to renderResult */
 export interface RenderResultOptions {
@@ -204,15 +208,19 @@ export interface AgentTool<TParameters extends TSchema = TSchema, TDetails = any
 		toolCallId: string,
 		params: Static<TParameters>,
 		signal?: AbortSignal,
-		onUpdate?: AgentToolUpdateCallback<TDetails>,
+		onUpdate?: AgentToolUpdateCallback<TDetails, TParameters>,
 		context?: AgentToolContext,
-	) => Promise<AgentToolResult<TDetails>>;
+	) => Promise<AgentToolResult<TDetails, TParameters>>;
 
 	/** Optional custom rendering for tool call display (returns UI component) */
 	renderCall?: (args: Static<TParameters>, theme: TTheme) => unknown;
 
 	/** Optional custom rendering for tool result display (returns UI component) */
-	renderResult?: (result: AgentToolResult<TDetails>, options: RenderResultOptions, theme: TTheme) => unknown;
+	renderResult?: (
+		result: AgentToolResult<TDetails, TParameters>,
+		options: RenderResultOptions,
+		theme: TTheme,
+	) => unknown;
 }
 
 // AgentContext is like Context but uses AgentTool