npm - @opengsd/gsd-pi - Versions diffs - 1.0.1-dev.bf2899e → 1.0.2-dev.0ee79e5 - Mend

@opengsd/gsd-pi 1.0.1-dev.bf2899e → 1.0.2-dev.0ee79e5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1202) hide show

package/packages/pi-agent-core/dist/token-audit.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"token-audit.js","sourceRoot":"","sources":["../src/token-audit.ts"],"names":[],"mappings":"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","sourcesContent":["// Project/App: GSD-2\n// File Purpose: Provider-boundary token payload audit helpers.\n\nimport type { Context, ImageContent, Message, TextContent, Tool } from \"@gsd/pi-ai\";\nimport type { AgentMessage } from \"./types.js\";\n\nconst CHARS_PER_TOKEN = 4;\nconst LARGEST_MESSAGE_LIMIT = 5;\nconst LARGEST_TOOL_LIMIT = 10;\nconst LARGEST_CUSTOM_MESSAGE_LIMIT = 5;\n\nexport interface TokenAuditMessageSummary {\n\tindex: number;\n\trole: string;\n\ttype: string;\n\tchars: number;\n}\n\nexport interface TokenAuditToolSummary {\n\tname: string;\n\tchars: number;\n}\n\nexport interface TokenAuditCustomMessageSummary {\n\tindex: number;\n\trole: string;\n\tcustomType?: string;\n\tchars: number;\n}\n\nexport interface TokenAuditSummary {\n\tsystemChars: number;\n\ttoolSchemaChars: number;\n\tmessageCharsByRole: Record<string, number>;\n\ttoolResultChars: number;\n\tcustomMessageChars: number;\n\timageCount: number;\n\testimatedInputTokens: number;\n\tmessageCount: number;\n\ttoolCount: number;\n\tlargestMessages: TokenAuditMessageSummary[];\n\tlargestTools: TokenAuditToolSummary[];\n\tlargestCustomMessages: TokenAuditCustomMessageSummary[];\n}\n\nexport interface ProviderPayloadAuditSummary {\n\tpayloadChars: number;\n\tmessageCharsByRole: Record<string, number>;\n\ttoolSchemaChars: number;\n\timageCount: number;\n\tmessageCount: number;\n\ttoolCount: number;\n\tlargestMessages: TokenAuditMessageSummary[];\n\tlargestTools: TokenAuditToolSummary[];\n}\n\nexport function buildTokenAuditSummary(context: Context, sourceMessages: AgentMessage[]): TokenAuditSummary {\n\tconst systemChars = context.systemPrompt?.length ?? 0;\n\tconst toolSummaries = summarizeTools(context.tools ?? []);\n\tconst toolSchemaChars = toolSummaries.reduce((sum, tool) => sum + tool.chars, 0);\n\tconst messageSummaries = context.messages.map((message, index) => summarizeMessage(message, index));\n\tconst messageCharsByRole: Record<string, number> = {};\n\tlet toolResultChars = 0;\n\tlet imageCount = 0;\n\n\tfor (const summary of messageSummaries) {\n\t\tmessageCharsByRole[summary.role] = (messageCharsByRole[summary.role] ?? 0) + summary.chars;\n\t}\n\n\tfor (const message of context.messages) {\n\t\timageCount += countImagesInMessage(message);\n\t\tif (message.role === \"toolResult\") {\n\t\t\ttoolResultChars += countContentChars(message.content);\n\t\t}\n\t}\n\n\tconst customMessageSummaries = summarizeCustomMessages(sourceMessages);\n\tconst customMessageChars = customMessageSummaries.reduce((sum, message) => sum + message.chars, 0);\n\n\tconst totalChars =\n\t\tsystemChars +\n\t\ttoolSchemaChars +\n\t\tmessageSummaries.reduce((sum, message) => sum + message.chars, 0);\n\n\treturn {\n\t\tsystemChars,\n\t\ttoolSchemaChars,\n\t\tmessageCharsByRole,\n\t\ttoolResultChars,\n\t\tcustomMessageChars,\n\t\timageCount,\n\t\testimatedInputTokens: Math.ceil(totalChars / CHARS_PER_TOKEN),\n\t\tmessageCount: context.messages.length,\n\t\ttoolCount: context.tools?.length ?? 0,\n\t\tlargestMessages: [...messageSummaries].sort((a, b) => b.chars - a.chars).slice(0, LARGEST_MESSAGE_LIMIT),\n\t\tlargestTools: [...toolSummaries].sort((a, b) => b.chars - a.chars).slice(0, LARGEST_TOOL_LIMIT),\n\t\tlargestCustomMessages: [...customMessageSummaries]\n\t\t\t.sort((a, b) => b.chars - a.chars)\n\t\t\t.slice(0, LARGEST_CUSTOM_MESSAGE_LIMIT),\n\t};\n}\n\nexport function maybeLogTokenAudit(context: Context, sourceMessages: AgentMessage[]): void {\n\tif (process.env.PI_TOKEN_AUDIT !== \"1\") return;\n\tconst summary = buildTokenAuditSummary(context, sourceMessages);\n\tprocess.stderr.write(`${JSON.stringify({ type: \"token_audit\", summary })}\\n`);\n}\n\nexport function buildProviderPayloadAuditSummary(payload: unknown): ProviderPayloadAuditSummary {\n\tconst record = asRecord(payload);\n\tconst messages = extractProviderMessages(record);\n\tconst tools = extractProviderTools(record);\n\tconst messageSummaries = messages.map((message, index) => summarizeProviderMessage(message, index));\n\tconst toolSummaries = tools.map((tool) => summarizeProviderTool(tool));\n\tconst messageCharsByRole: Record<string, number> = {};\n\tlet imageCount = 0;\n\n\tfor (const summary of messageSummaries) {\n\t\tmessageCharsByRole[summary.role] = (messageCharsByRole[summary.role] ?? 0) + summary.chars;\n\t}\n\tfor (const message of messages) {\n\t\timageCount += countImagesInValue(message);\n\t}\n\n\treturn {\n\t\tpayloadChars: safeJsonLength(payload),\n\t\tmessageCharsByRole,\n\t\ttoolSchemaChars: toolSummaries.reduce((sum, tool) => sum + tool.chars, 0),\n\t\timageCount,\n\t\tmessageCount: messages.length,\n\t\ttoolCount: tools.length,\n\t\tlargestMessages: [...messageSummaries].sort((a, b) => b.chars - a.chars).slice(0, LARGEST_MESSAGE_LIMIT),\n\t\tlargestTools: [...toolSummaries].sort((a, b) => b.chars - a.chars).slice(0, LARGEST_TOOL_LIMIT),\n\t};\n}\n\nexport function maybeLogProviderPayloadAudit(payload: unknown, phase: string): void {\n\tif (process.env.PI_TOKEN_AUDIT !== \"1\") return;\n\tconst summary = buildProviderPayloadAuditSummary(payload);\n\tprocess.stderr.write(`${JSON.stringify({ type: \"token_audit_provider_payload\", phase, summary })}\\n`);\n}\n\nfunction summarizeMessage(message: Message, index: number): TokenAuditMessageSummary {\n\treturn {\n\t\tindex,\n\t\trole: message.role,\n\t\ttype: messageType(message),\n\t\tchars: safeJsonLength(message),\n\t};\n}\n\nfunction messageType(message: Message): string {\n\tif (message.role === \"assistant\") {\n\t\tconst types = new Set(message.content.map((content) => content.type));\n\t\treturn types.size > 0 ? Array.from(types).join(\"+\") : \"assistant\";\n\t}\n\tif (message.role === \"toolResult\") return message.toolName \|\| \"toolResult\";\n\tif (typeof message.content === \"string\") return \"text\";\n\tconst types = new Set(message.content.map((content) => content.type));\n\treturn types.size > 0 ? Array.from(types).join(\"+\") : \"user\";\n}\n\nfunction summarizeTools(tools: Tool[]): TokenAuditToolSummary[] {\n\treturn tools.map((tool) => ({\n\t\tname: tool.name,\n\t\tchars: safeJsonLength(tool),\n\t}));\n}\n\nfunction summarizeCustomMessages(messages: AgentMessage[]): TokenAuditCustomMessageSummary[] {\n\treturn messages.flatMap((message, index) => {\n\t\tif (!isCustomOrInjectedMessage(message)) return [];\n\t\tconst customType = (message as { customType?: unknown }).customType;\n\t\treturn [{\n\t\t\tindex,\n\t\t\trole: String((message as { role?: unknown }).role ?? \"unknown\"),\n\t\t\tcustomType: typeof customType === \"string\" ? customType : undefined,\n\t\t\tchars: safeJsonLength(message),\n\t\t}];\n\t});\n}\n\nfunction summarizeProviderMessage(message: unknown, index: number): TokenAuditMessageSummary {\n\tconst record = asRecord(message);\n\tconst role = typeof record?.role === \"string\" ? record.role : \"unknown\";\n\tconst type = typeof record?.type === \"string\" ? record.type : role;\n\treturn { index, role, type, chars: safeJsonLength(message) };\n}\n\nfunction summarizeProviderTool(tool: unknown): TokenAuditToolSummary {\n\tconst record = asRecord(tool);\n\tconst name =\n\t\ttypeof record?.name === \"string\"\n\t\t\t? record.name\n\t\t\t: typeof asRecord(record?.function)?.name === \"string\"\n\t\t\t\t? String(asRecord(record?.function)?.name)\n\t\t\t\t: typeof asRecord(record?.toolSpec)?.name === \"string\"\n\t\t\t\t\t? String(asRecord(record?.toolSpec)?.name)\n\t\t\t\t\t: \"unknown\";\n\treturn { name, chars: safeJsonLength(tool) };\n}\n\nfunction extractProviderMessages(record: Record<string, unknown> \| null): unknown[] {\n\tconst candidates = [\n\t\tgetArrayField(record, \"messages\"),\n\t\tgetArrayField(record, \"input\"),\n\t\tgetArrayField(record, \"contents\"),\n\t].filter((value): value is unknown[] => value !== null);\n\tif (candidates.length > 0) return candidates[0];\n\tconst input = record?.input;\n\treturn typeof input === \"string\" ? [{ role: \"input\", content: input }] : [];\n}\n\nfunction extractProviderTools(record: Record<string, unknown> \| null): unknown[] {\n\tconst direct = getArrayField(record, \"tools\")\n\t\t?? getNestedArrayField(record, [\"config\", \"tools\"])\n\t\t?? getNestedArrayField(record, [\"toolConfig\", \"tools\"])\n\t\t?? getNestedArrayField(record, [\"tool_config\", \"tools\"])\n\t\t?? [];\n\treturn direct.flatMap(expandProviderToolEntry);\n}\n\nfunction expandProviderToolEntry(tool: unknown): unknown[] {\n\tconst record = asRecord(tool);\n\tconst functionDeclarations =\n\t\tgetArrayField(record, \"functionDeclarations\")\n\t\t?? getArrayField(record, \"function_declarations\");\n\tif (functionDeclarations) return functionDeclarations;\n\treturn [tool];\n}\n\nfunction countImagesInMessage(message: Message): number {\n\tif (!(\"content\" in message) \|\| !Array.isArray(message.content)) return 0;\n\treturn message.content.filter((content): content is ImageContent => content.type === \"image\").length;\n}\n\nfunction countImagesInValue(value: unknown): number {\n\tif (!value \|\| typeof value !== \"object\") return 0;\n\tif (Array.isArray(value)) {\n\t\treturn value.reduce((sum, item) => sum + countImagesInValue(item), 0);\n\t}\n\tconst record = value as Record<string, unknown>;\n\tlet count = record.type === \"image\" \|\| record.type === \"input_image\" ? 1 : 0;\n\tfor (const nested of Object.values(record)) {\n\t\tcount += countImagesInValue(nested);\n\t}\n\treturn count;\n}\n\nfunction countContentChars(content: string \| (TextContent \| ImageContent)[]): number {\n\tif (typeof content === \"string\") return content.length;\n\treturn content.reduce((sum, block) => {\n\t\tif (block.type === \"text\") return sum + block.text.length;\n\t\tif (block.type === \"image\") return sum + block.data.length;\n\t\treturn sum;\n\t}, 0);\n}\n\nfunction isCustomOrInjectedMessage(message: AgentMessage): boolean {\n\tconst role = (message as { role?: unknown }).role;\n\treturn role === \"custom\" \|\| role === \"bashExecution\" \|\| role === \"branchSummary\" \|\| role === \"compactionSummary\";\n}\n\nfunction asRecord(value: unknown): Record<string, unknown> \| null {\n\treturn value && typeof value === \"object\" && !Array.isArray(value) ? value as Record<string, unknown> : null;\n}\n\nfunction getArrayField(record: Record<string, unknown> \| null, key: string): unknown[] \| null {\n\tconst value = record?.[key];\n\treturn Array.isArray(value) ? value : null;\n}\n\nfunction getNestedArrayField(record: Record<string, unknown> \| null, path: string[]): unknown[] \| null {\n\tlet current: unknown = record;\n\tfor (const key of path) {\n\t\tcurrent = asRecord(current)?.[key];\n\t}\n\treturn Array.isArray(current) ? current : null;\n}\n\nfunction safeJsonLength(value: unknown): number {\n\ttry {\n\t\treturn JSON.stringify(value)?.length ?? 0;\n\t} catch {\n\t\treturn 0;\n\t}\n}\n"]}
1	+ {"version":3,"file":"token-audit.js","sourceRoot":"","sources":["../src/token-audit.ts"],"names":[],"mappings":"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","sourcesContent":["// Project/App: gsd-pi\n// File Purpose: Provider-boundary token payload audit helpers.\n\nimport type { Context, ImageContent, Message, TextContent, Tool } from \"@gsd/pi-ai\";\nimport type { AgentMessage } from \"./types.js\";\n\nconst CHARS_PER_TOKEN = 4;\nconst LARGEST_MESSAGE_LIMIT = 5;\nconst LARGEST_TOOL_LIMIT = 10;\nconst LARGEST_CUSTOM_MESSAGE_LIMIT = 5;\n\nexport interface TokenAuditMessageSummary {\n\tindex: number;\n\trole: string;\n\ttype: string;\n\tchars: number;\n}\n\nexport interface TokenAuditToolSummary {\n\tname: string;\n\tchars: number;\n}\n\nexport interface TokenAuditCustomMessageSummary {\n\tindex: number;\n\trole: string;\n\tcustomType?: string;\n\tchars: number;\n}\n\nexport interface TokenAuditSummary {\n\tsystemChars: number;\n\ttoolSchemaChars: number;\n\tmessageCharsByRole: Record<string, number>;\n\ttoolResultChars: number;\n\tcustomMessageChars: number;\n\timageCount: number;\n\testimatedInputTokens: number;\n\tmessageCount: number;\n\ttoolCount: number;\n\tlargestMessages: TokenAuditMessageSummary[];\n\tlargestTools: TokenAuditToolSummary[];\n\tlargestCustomMessages: TokenAuditCustomMessageSummary[];\n}\n\nexport interface ProviderPayloadAuditSummary {\n\tpayloadChars: number;\n\tmessageCharsByRole: Record<string, number>;\n\ttoolSchemaChars: number;\n\timageCount: number;\n\tmessageCount: number;\n\ttoolCount: number;\n\tlargestMessages: TokenAuditMessageSummary[];\n\tlargestTools: TokenAuditToolSummary[];\n}\n\nexport function buildTokenAuditSummary(context: Context, sourceMessages: AgentMessage[]): TokenAuditSummary {\n\tconst systemChars = context.systemPrompt?.length ?? 0;\n\tconst toolSummaries = summarizeTools(context.tools ?? []);\n\tconst toolSchemaChars = toolSummaries.reduce((sum, tool) => sum + tool.chars, 0);\n\tconst messageSummaries = context.messages.map((message, index) => summarizeMessage(message, index));\n\tconst messageCharsByRole: Record<string, number> = {};\n\tlet toolResultChars = 0;\n\tlet imageCount = 0;\n\n\tfor (const summary of messageSummaries) {\n\t\tmessageCharsByRole[summary.role] = (messageCharsByRole[summary.role] ?? 0) + summary.chars;\n\t}\n\n\tfor (const message of context.messages) {\n\t\timageCount += countImagesInMessage(message);\n\t\tif (message.role === \"toolResult\") {\n\t\t\ttoolResultChars += countContentChars(message.content);\n\t\t}\n\t}\n\n\tconst customMessageSummaries = summarizeCustomMessages(sourceMessages);\n\tconst customMessageChars = customMessageSummaries.reduce((sum, message) => sum + message.chars, 0);\n\n\tconst totalChars =\n\t\tsystemChars +\n\t\ttoolSchemaChars +\n\t\tmessageSummaries.reduce((sum, message) => sum + message.chars, 0);\n\n\treturn {\n\t\tsystemChars,\n\t\ttoolSchemaChars,\n\t\tmessageCharsByRole,\n\t\ttoolResultChars,\n\t\tcustomMessageChars,\n\t\timageCount,\n\t\testimatedInputTokens: Math.ceil(totalChars / CHARS_PER_TOKEN),\n\t\tmessageCount: context.messages.length,\n\t\ttoolCount: context.tools?.length ?? 0,\n\t\tlargestMessages: [...messageSummaries].sort((a, b) => b.chars - a.chars).slice(0, LARGEST_MESSAGE_LIMIT),\n\t\tlargestTools: [...toolSummaries].sort((a, b) => b.chars - a.chars).slice(0, LARGEST_TOOL_LIMIT),\n\t\tlargestCustomMessages: [...customMessageSummaries]\n\t\t\t.sort((a, b) => b.chars - a.chars)\n\t\t\t.slice(0, LARGEST_CUSTOM_MESSAGE_LIMIT),\n\t};\n}\n\nexport function maybeLogTokenAudit(context: Context, sourceMessages: AgentMessage[]): void {\n\tif (process.env.PI_TOKEN_AUDIT !== \"1\") return;\n\tconst summary = buildTokenAuditSummary(context, sourceMessages);\n\tprocess.stderr.write(`${JSON.stringify({ type: \"token_audit\", summary })}\\n`);\n}\n\nexport function buildProviderPayloadAuditSummary(payload: unknown): ProviderPayloadAuditSummary {\n\tconst record = asRecord(payload);\n\tconst messages = extractProviderMessages(record);\n\tconst tools = extractProviderTools(record);\n\tconst messageSummaries = messages.map((message, index) => summarizeProviderMessage(message, index));\n\tconst toolSummaries = tools.map((tool) => summarizeProviderTool(tool));\n\tconst messageCharsByRole: Record<string, number> = {};\n\tlet imageCount = 0;\n\n\tfor (const summary of messageSummaries) {\n\t\tmessageCharsByRole[summary.role] = (messageCharsByRole[summary.role] ?? 0) + summary.chars;\n\t}\n\tfor (const message of messages) {\n\t\timageCount += countImagesInValue(message);\n\t}\n\n\treturn {\n\t\tpayloadChars: safeJsonLength(payload),\n\t\tmessageCharsByRole,\n\t\ttoolSchemaChars: toolSummaries.reduce((sum, tool) => sum + tool.chars, 0),\n\t\timageCount,\n\t\tmessageCount: messages.length,\n\t\ttoolCount: tools.length,\n\t\tlargestMessages: [...messageSummaries].sort((a, b) => b.chars - a.chars).slice(0, LARGEST_MESSAGE_LIMIT),\n\t\tlargestTools: [...toolSummaries].sort((a, b) => b.chars - a.chars).slice(0, LARGEST_TOOL_LIMIT),\n\t};\n}\n\nexport function maybeLogProviderPayloadAudit(payload: unknown, phase: string): void {\n\tif (process.env.PI_TOKEN_AUDIT !== \"1\") return;\n\tconst summary = buildProviderPayloadAuditSummary(payload);\n\tprocess.stderr.write(`${JSON.stringify({ type: \"token_audit_provider_payload\", phase, summary })}\\n`);\n}\n\nfunction summarizeMessage(message: Message, index: number): TokenAuditMessageSummary {\n\treturn {\n\t\tindex,\n\t\trole: message.role,\n\t\ttype: messageType(message),\n\t\tchars: safeJsonLength(message),\n\t};\n}\n\nfunction messageType(message: Message): string {\n\tif (message.role === \"assistant\") {\n\t\tconst types = new Set(message.content.map((content) => content.type));\n\t\treturn types.size > 0 ? Array.from(types).join(\"+\") : \"assistant\";\n\t}\n\tif (message.role === \"toolResult\") return message.toolName \|\| \"toolResult\";\n\tif (typeof message.content === \"string\") return \"text\";\n\tconst types = new Set(message.content.map((content) => content.type));\n\treturn types.size > 0 ? Array.from(types).join(\"+\") : \"user\";\n}\n\nfunction summarizeTools(tools: Tool[]): TokenAuditToolSummary[] {\n\treturn tools.map((tool) => ({\n\t\tname: tool.name,\n\t\tchars: safeJsonLength(tool),\n\t}));\n}\n\nfunction summarizeCustomMessages(messages: AgentMessage[]): TokenAuditCustomMessageSummary[] {\n\treturn messages.flatMap((message, index) => {\n\t\tif (!isCustomOrInjectedMessage(message)) return [];\n\t\tconst customType = (message as { customType?: unknown }).customType;\n\t\treturn [{\n\t\t\tindex,\n\t\t\trole: String((message as { role?: unknown }).role ?? \"unknown\"),\n\t\t\tcustomType: typeof customType === \"string\" ? customType : undefined,\n\t\t\tchars: safeJsonLength(message),\n\t\t}];\n\t});\n}\n\nfunction summarizeProviderMessage(message: unknown, index: number): TokenAuditMessageSummary {\n\tconst record = asRecord(message);\n\tconst role = typeof record?.role === \"string\" ? record.role : \"unknown\";\n\tconst type = typeof record?.type === \"string\" ? record.type : role;\n\treturn { index, role, type, chars: safeJsonLength(message) };\n}\n\nfunction summarizeProviderTool(tool: unknown): TokenAuditToolSummary {\n\tconst record = asRecord(tool);\n\tconst name =\n\t\ttypeof record?.name === \"string\"\n\t\t\t? record.name\n\t\t\t: typeof asRecord(record?.function)?.name === \"string\"\n\t\t\t\t? String(asRecord(record?.function)?.name)\n\t\t\t\t: typeof asRecord(record?.toolSpec)?.name === \"string\"\n\t\t\t\t\t? String(asRecord(record?.toolSpec)?.name)\n\t\t\t\t\t: \"unknown\";\n\treturn { name, chars: safeJsonLength(tool) };\n}\n\nfunction extractProviderMessages(record: Record<string, unknown> \| null): unknown[] {\n\tconst candidates = [\n\t\tgetArrayField(record, \"messages\"),\n\t\tgetArrayField(record, \"input\"),\n\t\tgetArrayField(record, \"contents\"),\n\t].filter((value): value is unknown[] => value !== null);\n\tif (candidates.length > 0) return candidates[0];\n\tconst input = record?.input;\n\treturn typeof input === \"string\" ? [{ role: \"input\", content: input }] : [];\n}\n\nfunction extractProviderTools(record: Record<string, unknown> \| null): unknown[] {\n\tconst direct = getArrayField(record, \"tools\")\n\t\t?? getNestedArrayField(record, [\"config\", \"tools\"])\n\t\t?? getNestedArrayField(record, [\"toolConfig\", \"tools\"])\n\t\t?? getNestedArrayField(record, [\"tool_config\", \"tools\"])\n\t\t?? [];\n\treturn direct.flatMap(expandProviderToolEntry);\n}\n\nfunction expandProviderToolEntry(tool: unknown): unknown[] {\n\tconst record = asRecord(tool);\n\tconst functionDeclarations =\n\t\tgetArrayField(record, \"functionDeclarations\")\n\t\t?? getArrayField(record, \"function_declarations\");\n\tif (functionDeclarations) return functionDeclarations;\n\treturn [tool];\n}\n\nfunction countImagesInMessage(message: Message): number {\n\tif (!(\"content\" in message) \|\| !Array.isArray(message.content)) return 0;\n\treturn message.content.filter((content): content is ImageContent => content.type === \"image\").length;\n}\n\nfunction countImagesInValue(value: unknown): number {\n\tif (!value \|\| typeof value !== \"object\") return 0;\n\tif (Array.isArray(value)) {\n\t\treturn value.reduce((sum, item) => sum + countImagesInValue(item), 0);\n\t}\n\tconst record = value as Record<string, unknown>;\n\tlet count = record.type === \"image\" \|\| record.type === \"input_image\" ? 1 : 0;\n\tfor (const nested of Object.values(record)) {\n\t\tcount += countImagesInValue(nested);\n\t}\n\treturn count;\n}\n\nfunction countContentChars(content: string \| (TextContent \| ImageContent)[]): number {\n\tif (typeof content === \"string\") return content.length;\n\treturn content.reduce((sum, block) => {\n\t\tif (block.type === \"text\") return sum + block.text.length;\n\t\tif (block.type === \"image\") return sum + block.data.length;\n\t\treturn sum;\n\t}, 0);\n}\n\nfunction isCustomOrInjectedMessage(message: AgentMessage): boolean {\n\tconst role = (message as { role?: unknown }).role;\n\treturn role === \"custom\" \|\| role === \"bashExecution\" \|\| role === \"branchSummary\" \|\| role === \"compactionSummary\";\n}\n\nfunction asRecord(value: unknown): Record<string, unknown> \| null {\n\treturn value && typeof value === \"object\" && !Array.isArray(value) ? value as Record<string, unknown> : null;\n}\n\nfunction getArrayField(record: Record<string, unknown> \| null, key: string): unknown[] \| null {\n\tconst value = record?.[key];\n\treturn Array.isArray(value) ? value : null;\n}\n\nfunction getNestedArrayField(record: Record<string, unknown> \| null, path: string[]): unknown[] \| null {\n\tlet current: unknown = record;\n\tfor (const key of path) {\n\t\tcurrent = asRecord(current)?.[key];\n\t}\n\treturn Array.isArray(current) ? current : null;\n}\n\nfunction safeJsonLength(value: unknown): number {\n\ttry {\n\t\treturn JSON.stringify(value)?.length ?? 0;\n\t} catch {\n\t\treturn 0;\n\t}\n}\n"]}

package/packages/pi-agent-core/dist/types.d.ts CHANGED Viewed

@@ -50,6 +50,28 @@ export interface BeforeToolCallContext {
     /** Current agent context at the time the tool call is prepared. */
     context: AgentContext;
 }
+/** A single tool call that failed during preparation (validation / not found / blocked). */
+export interface PreparationErrorFailure {
+    toolName: string;
+    arguments: Record<string, unknown>;
+    errorText: string;
+}
+/** Context passed to `onPreparationErrorsTurn`. */
+export interface PreparationErrorsTurnContext {
+    /** The assistant message that requested the tool calls. */
+    assistantMessage: AssistantMessage;
+    /** Tool calls that failed during preparation this turn. */
+    failures: PreparationErrorFailure[];
+    /** Count of tool results that failed during preparation. */
+    preparationErrorCount: number;
+}
+/** Result returned from `onPreparationErrorsTurn`. */
+export interface PreparationErrorsTurnResult {
+    /** Messages injected before the next LLM call (same as getSteeringMessages). */
+    steeringMessages?: AgentMessage[];
+    /** When true, the schema-overload counter resets instead of incrementing this turn. */
+    resetValidationFailureCap?: boolean;
+}
 /** Context passed to `afterToolCall`. */
 export interface AfterToolCallContext {
     /** The assistant message that requested the tool call. */
@@ -175,6 +197,16 @@ export interface AgentLoopConfig extends SimpleStreamOptions {
      * The hook receives the agent abort signal and is responsible for honoring it.
      */
     afterToolCall?: (context: AfterToolCallContext, signal?: AbortSignal) => Promise<AfterToolCallResult | undefined>;
+    /**
+     * Optional formatter for tool argument validation errors (AJV / schema failures).
+     * Called in prepareToolCall before the error tool result is emitted.
+     */
+    formatValidationError?: (tool: AgentTool<any>, toolCall: AgentToolCall, baseMessage: string) => string | Promise<string>;
+    /**
+     * Called after a turn when one or more tool calls failed during preparation.
+     * Use to inject corrective steering and reset the schema-overload counter.
+     */
+    onPreparationErrorsTurn?: (context: PreparationErrorsTurnContext, signal?: AbortSignal) => Promise<PreparationErrorsTurnResult | void>;
     /**
      * When true, tool calls in assistant messages are rendered in the TUI
      * but NOT executed locally. Used for providers that handle tool execution

package/packages/pi-agent-core/dist/types.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
1	+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/packages/pi-agent-core/dist/types.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n\tAssistantMessage,\n\tAssistantMessageEvent,\n\tImageContent,\n\tMessage,\n\tModel,\n\tSimpleStreamOptions,\n\tstreamSimple,\n\tTextContent,\n\tTool,\n\tToolResultMessage,\n} from \"@gsd/pi-ai\";\nimport type { Static, TSchema } from \"@sinclair/typebox\";\n\n/** Stream function - can return sync or Promise for async config lookup /\nexport type StreamFn = (\n\t...args: Parameters<typeof streamSimple>\n) => ReturnType<typeof streamSimple> \| Promise<ReturnType<typeof streamSimple>>;\n\n/\n Configuration for how tool calls from a single assistant message are executed.\n \n - \"sequential\": each tool call is prepared, executed, and finalized before the next one starts.\n * - \"parallel\": tool calls are prepared sequentially, then allowed tools execute concurrently.\n * Final tool results are still emitted in assistant source order.\n /\nexport type ToolExecutionMode = \"sequential\" \| \"parallel\";\n\n/* A single tool call content block emitted by an assistant message. /\nexport type AgentToolCall = Extract<AssistantMessage[\"content\"][number], { type: \"toolCall\" }>;\n\n/\n Result returned from `beforeToolCall`.\n \n Returning `{ block: true }` prevents the tool from executing. The loop emits an error tool result instead.\n * `reason` becomes the text shown in that error result. If omitted, a default blocked message is used.\n /\nexport interface BeforeToolCallResult {\n\tblock?: boolean;\n\treason?: string;\n}\n\n/\n Partial override returned from `afterToolCall`.\n \n Merge semantics are field-by-field:\n * - `content`: if provided, replaces the tool result content array in full\n * - `details`: if provided, replaces the tool result details value in full\n * - `isError`: if provided, replaces the tool result error flag\n \n Omitted fields keep the original executed tool result values.\n /\nexport interface AfterToolCallResult {\n\tcontent?: (TextContent \| ImageContent)[];\n\tdetails?: unknown;\n\tisError?: boolean;\n}\n\n/* Context passed to `beforeToolCall`. /\nexport interface BeforeToolCallContext {\n\t/* The assistant message that requested the tool call. /\n\tassistantMessage: AssistantMessage;\n\t/* The raw tool call block from `assistantMessage.content`. /\n\ttoolCall: AgentToolCall;\n\t/* Validated tool arguments for the target tool schema. /\n\targs: unknown;\n\t/* Current agent context at the time the tool call is prepared. /\n\tcontext: AgentContext;\n}\n\n/* Context passed to `afterToolCall`. /\nexport interface AfterToolCallContext {\n\t/* The assistant message that requested the tool call. /\n\tassistantMessage: AssistantMessage;\n\t/* The raw tool call block from `assistantMessage.content`. /\n\ttoolCall: AgentToolCall;\n\t/* Validated tool arguments for the target tool schema. /\n\targs: unknown;\n\t/* The executed tool result before any `afterToolCall` overrides are applied. /\n\tresult: AgentToolResult<any>;\n\t/* Whether the executed tool result is currently treated as an error. /\n\tisError: boolean;\n\t/* Current agent context at the time the tool call is finalized. /\n\tcontext: AgentContext;\n}\n\n/\n Configuration for the agent loop.\n /\nexport interface AgentLoopConfig extends SimpleStreamOptions {\n\tmodel: Model<any>;\n\n\t/\n\t Converts AgentMessage[] to LLM-compatible Message[] before each LLM call.\n\t \n\t Each AgentMessage must be converted to a UserMessage, AssistantMessage, or ToolResultMessage\n\t * that the LLM can understand. AgentMessages that cannot be converted (e.g., UI-only notifications,\n\t * status messages) should be filtered out.\n\t \n\t @example\n\t * ```typescript\n\t * convertToLlm: (messages) => messages.flatMap(m => {\n\t * if (m.role === \"custom\") {\n\t * // Convert custom message to user message\n\t * return [{ role: \"user\", content: m.content, timestamp: m.timestamp }];\n\t * }\n\t * if (m.role === \"notification\") {\n\t * // Filter out UI-only messages\n\t * return [];\n\t * }\n\t * // Pass through standard LLM messages\n\t * return [m];\n\t * })\n\t * ```\n\t /\n\tconvertToLlm: (messages: AgentMessage[]) => Message[] \| Promise<Message[]>;\n\n\t/\n\t Optional transform applied to the context before `convertToLlm`.\n\t \n\t Use this for operations that work at the AgentMessage level:\n\t * - Context window management (pruning old messages)\n\t * - Injecting context from external sources\n\t \n\t @example\n\t * ```typescript\n\t * transformContext: async (messages) => {\n\t * if (estimateTokens(messages) > MAX_TOKENS) {\n\t * return pruneOldMessages(messages);\n\t * }\n\t * return messages;\n\t * }\n\t * ```\n\t /\n\ttransformContext?: (messages: AgentMessage[], signal?: AbortSignal) => Promise<AgentMessage[]>;\n\n\t/\n\t Optional final tool filter applied immediately before each provider call.\n\t \n\t Use this for runtime policy that depends on the fully active tool set.\n\t * The returned list is what token audit and the provider request both see.\n\t * Receives the post-transform AgentMessage context so policy can scope\n\t * request-local custom messages without inspecting provider payload text.\n\t /\n\tfilterTools?: (\n\t\ttools: AgentTool<any>[],\n\t\tsignal?: AbortSignal,\n\t\tmessages?: AgentMessage[],\n\t) => AgentTool<any>[] \| Promise<AgentTool<any>[]>;\n\n\t/\n\t Resolves an API key dynamically for each LLM call.\n\t \n\t Useful for short-lived OAuth tokens (e.g., GitHub Copilot) that may expire\n\t * during long-running tool execution phases.\n\t /\n\tgetApiKey?: (provider: string) => Promise<string \| undefined> \| string \| undefined;\n\n\t/\n\t Returns steering messages to inject into the conversation mid-run.\n\t \n\t Called after each tool execution to check for user interruptions.\n\t * If messages are returned, remaining tool calls are skipped and\n\t * these messages are added to the context before the next LLM call.\n\t \n\t Use this for \"steering\" the agent while it's working.\n\t /\n\tgetSteeringMessages?: () => Promise<AgentMessage[]>;\n\n\t/\n\t Returns follow-up messages to process after the agent would otherwise stop.\n\t \n\t Called when the agent has no more tool calls and no steering messages.\n\t * If messages are returned, they're added to the context and the agent\n\t * continues with another turn.\n\t \n\t Use this for follow-up messages that should wait until the agent finishes.\n\t /\n\tgetFollowUpMessages?: () => Promise<AgentMessage[]>;\n\n\t/\n\t Tool execution mode.\n\t * - \"sequential\": execute tool calls one by one\n\t * - \"parallel\": preflight tool calls sequentially, then execute allowed tools concurrently\n\t \n\t Default: \"parallel\"\n\t /\n\ttoolExecution?: ToolExecutionMode;\n\n\t/\n\t Called before a tool is executed, after arguments have been validated.\n\t \n\t Return `{ block: true }` to prevent execution. The loop emits an error tool result instead.\n\t * The hook receives the agent abort signal and is responsible for honoring it.\n\t /\n\tbeforeToolCall?: (context: BeforeToolCallContext, signal?: AbortSignal) => Promise<BeforeToolCallResult \| undefined>;\n\n\t/\n\t Called after a tool finishes executing, before final tool events are emitted.\n\t \n\t Return an `AfterToolCallResult` to override parts of the executed tool result:\n\t * - `content` replaces the full content array\n\t * - `details` replaces the full details payload\n\t * - `isError` replaces the error flag\n\t \n\t Any omitted fields keep their original values. No deep merge is performed.\n\t * The hook receives the agent abort signal and is responsible for honoring it.\n\t /\n\tafterToolCall?: (context: AfterToolCallContext, signal?: AbortSignal) => Promise<AfterToolCallResult \| undefined>;\n\n\t/\n\t When true, tool calls in assistant messages are rendered in the TUI\n\t * but NOT executed locally. Used for providers that handle tool execution\n\t * internally (e.g., Claude Code CLI via Agent SDK).\n\t \n\t The agent loop emits tool_execution_start/end events for TUI rendering\n\t * but skips tool.execute() and does not add tool results to context.\n\t /\n\texternalToolExecution?: boolean;\n\n\t/\n\t Called when the agent is about to retry after a recoverable provider error.\n\t \n\t Fires after each transient failure (rate limit, connection reset, etc.)\n\t * before the retry backoff sleep. Useful for surfacing retry telemetry to\n\t * the host app without instrumenting the provider layer directly.\n\t /\n\tonRetry?: (context: RetryContext, signal?: AbortSignal) => Promise<void> \| void;\n\n\t/\n\t Called when the LLM stream fails mid-response.\n\t \n\t Fires once per failed stream — `onRetry` may still fire separately if the\n\t * loop elects to retry. Use this for logging or flushing partial state.\n\t /\n\tonStreamError?: (context: StreamErrorContext, signal?: AbortSignal) => Promise<void> \| void;\n}\n\n/* Context passed to `onRetry`. /\nexport interface RetryContext {\n\tattempt: number;\n\tmaxRetries: number;\n\tdelayMs: number;\n\terror: Error;\n}\n\n/* Context passed to `onStreamError`. /\nexport interface StreamErrorContext {\n\terror: Error;\n\t/* The text already emitted by the stream before it failed (may be empty). /\n\tpartialText: string;\n\t/* Whether the loop will attempt to retry after this failure. /\n\twillRetry: boolean;\n}\n\n/\n Thinking/reasoning level for models that support it.\n * Note: \"xhigh\" is only supported by OpenAI gpt-5.1-codex-max, gpt-5.2, gpt-5.2-codex, gpt-5.3, and gpt-5.3-codex models.\n /\nexport type ThinkingLevel = \"off\" \| \"minimal\" \| \"low\" \| \"medium\" \| \"high\" \| \"xhigh\";\n\n/\n Extensible interface for custom app messages.\n * Apps can extend via declaration merging:\n \n @example\n * ```typescript\n * declare module \"@mariozechner/agent\" {\n * interface CustomAgentMessages {\n * artifact: ArtifactMessage;\n * notification: NotificationMessage;\n * }\n * }\n * ```\n /\nexport interface CustomAgentMessages {\n\t// Empty by default - apps extend via declaration merging\n}\n\n/\n AgentMessage: Union of LLM messages + custom messages.\n * This abstraction allows apps to add custom message types while maintaining\n * type safety and compatibility with the base LLM messages.\n /\nexport type AgentMessage = Message \| CustomAgentMessages[keyof CustomAgentMessages];\n\n/\n Agent state containing all configuration and conversation data.\n /\nexport interface AgentState {\n\tsystemPrompt: string;\n\tmodel: Model<any>;\n\tthinkingLevel: ThinkingLevel;\n\ttools: AgentTool<any>[];\n\tmessages: AgentMessage[]; // Can include attachments + custom message types\n\tisStreaming: boolean;\n\tstreamMessage: AgentMessage \| null;\n\tpendingToolCalls: Set<string>;\n\terror?: string;\n\t/\n\t The model currently being used for inference. Set at _runLoop() start,\n\t * cleared when the loop ends. When present, UI should display this instead\n\t * of `model` to avoid showing a stale value after a mid-turn model switch.\n\t /\n\tactiveInferenceModel?: Model<any>;\n}\n\nexport interface AgentToolResult<T> {\n\t// Content blocks supporting text and images\n\tcontent: (TextContent \| ImageContent)[];\n\t// Details to be displayed in a UI or logged\n\tdetails: T;\n}\n\n// Callback for streaming tool execution updates\nexport type AgentToolUpdateCallback<T = any> = (partialResult: AgentToolResult<T>) => void;\n\n// AgentTool extends Tool but adds the execute function\nexport interface AgentTool<TParameters extends TSchema = TSchema, TDetails = any> extends Tool<TParameters> {\n\t// A human-readable label for the tool to be displayed in UI\n\tlabel: string;\n\texecute: (\n\t\ttoolCallId: string,\n\t\tparams: Static<TParameters>,\n\t\tsignal?: AbortSignal,\n\t\tonUpdate?: AgentToolUpdateCallback<TDetails>,\n\t) => Promise<AgentToolResult<TDetails>>;\n}\n\n// AgentContext is like Context but uses AgentTool\nexport interface AgentContext {\n\tsystemPrompt: string;\n\tmessages: AgentMessage[];\n\ttools?: AgentTool<any>[];\n}\n\nexport type AgentAbortOrigin = \"session-transition\" \| \"user\" \| \"timeout\" \| \"unknown\";\n\n/\n Events emitted by the Agent for UI updates.\n * These events provide fine-grained lifecycle information for messages, turns, and tool executions.\n */\nexport type AgentEvent =\n\t// Agent lifecycle\n\t\| { type: \"agent_start\"; sessionId?: string; turnId?: string }\n\t\| { type: \"agent_end\"; messages: AgentMessage[]; sessionId?: string; turnId?: string; abortOrigin?: AgentAbortOrigin }\n\t// Turn lifecycle - a turn is one assistant response + any tool calls/results\n\t\| { type: \"turn_start\"; sessionId?: string; turnId?: string }\n\t\| { type: \"turn_end\"; message: AgentMessage; toolResults: ToolResultMessage[]; sessionId?: string; turnId?: string }\n\t// Message lifecycle - emitted for user, assistant, and toolResult messages\n\t\| { type: \"message_start\"; message: AgentMessage; sessionId?: string; turnId?: string }\n\t// Only emitted for assistant messages during streaming\n\t\| { type: \"message_update\"; message: AgentMessage; assistantMessageEvent: AssistantMessageEvent; sessionId?: string; turnId?: string }\n\t\| { type: \"message_end\"; message: AgentMessage; sessionId?: string; turnId?: string }\n\t// Tool execution lifecycle\n\t\| { type: \"tool_execution_start\"; toolCallId: string; toolName: string; args: any; sessionId?: string; turnId?: string }\n\t\| { type: \"tool_execution_update\"; toolCallId: string; toolName: string; args: any; partialResult: any; sessionId?: string; turnId?: string }\n\t\| { type: \"tool_execution_end\"; toolCallId: string; toolName: string; result: any; isError: boolean; sessionId?: string; turnId?: string };\n"]}
1	+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n\tAssistantMessage,\n\tAssistantMessageEvent,\n\tImageContent,\n\tMessage,\n\tModel,\n\tSimpleStreamOptions,\n\tstreamSimple,\n\tTextContent,\n\tTool,\n\tToolResultMessage,\n} from \"@gsd/pi-ai\";\nimport type { Static, TSchema } from \"@sinclair/typebox\";\n\n/** Stream function - can return sync or Promise for async config lookup /\nexport type StreamFn = (\n\t...args: Parameters<typeof streamSimple>\n) => ReturnType<typeof streamSimple> \| Promise<ReturnType<typeof streamSimple>>;\n\n/\n Configuration for how tool calls from a single assistant message are executed.\n \n - \"sequential\": each tool call is prepared, executed, and finalized before the next one starts.\n * - \"parallel\": tool calls are prepared sequentially, then allowed tools execute concurrently.\n * Final tool results are still emitted in assistant source order.\n /\nexport type ToolExecutionMode = \"sequential\" \| \"parallel\";\n\n/* A single tool call content block emitted by an assistant message. /\nexport type AgentToolCall = Extract<AssistantMessage[\"content\"][number], { type: \"toolCall\" }>;\n\n/\n Result returned from `beforeToolCall`.\n \n Returning `{ block: true }` prevents the tool from executing. The loop emits an error tool result instead.\n * `reason` becomes the text shown in that error result. If omitted, a default blocked message is used.\n /\nexport interface BeforeToolCallResult {\n\tblock?: boolean;\n\treason?: string;\n}\n\n/\n Partial override returned from `afterToolCall`.\n \n Merge semantics are field-by-field:\n * - `content`: if provided, replaces the tool result content array in full\n * - `details`: if provided, replaces the tool result details value in full\n * - `isError`: if provided, replaces the tool result error flag\n \n Omitted fields keep the original executed tool result values.\n /\nexport interface AfterToolCallResult {\n\tcontent?: (TextContent \| ImageContent)[];\n\tdetails?: unknown;\n\tisError?: boolean;\n}\n\n/* Context passed to `beforeToolCall`. /\nexport interface BeforeToolCallContext {\n\t/* The assistant message that requested the tool call. /\n\tassistantMessage: AssistantMessage;\n\t/* The raw tool call block from `assistantMessage.content`. /\n\ttoolCall: AgentToolCall;\n\t/* Validated tool arguments for the target tool schema. /\n\targs: unknown;\n\t/* Current agent context at the time the tool call is prepared. /\n\tcontext: AgentContext;\n}\n\n/* A single tool call that failed during preparation (validation / not found / blocked). /\nexport interface PreparationErrorFailure {\n\ttoolName: string;\n\targuments: Record<string, unknown>;\n\terrorText: string;\n}\n\n/* Context passed to `onPreparationErrorsTurn`. /\nexport interface PreparationErrorsTurnContext {\n\t/* The assistant message that requested the tool calls. /\n\tassistantMessage: AssistantMessage;\n\t/* Tool calls that failed during preparation this turn. /\n\tfailures: PreparationErrorFailure[];\n\t/* Count of tool results that failed during preparation. /\n\tpreparationErrorCount: number;\n}\n\n/* Result returned from `onPreparationErrorsTurn`. /\nexport interface PreparationErrorsTurnResult {\n\t/* Messages injected before the next LLM call (same as getSteeringMessages). /\n\tsteeringMessages?: AgentMessage[];\n\t/* When true, the schema-overload counter resets instead of incrementing this turn. /\n\tresetValidationFailureCap?: boolean;\n}\n\n/* Context passed to `afterToolCall`. /\nexport interface AfterToolCallContext {\n\t/* The assistant message that requested the tool call. /\n\tassistantMessage: AssistantMessage;\n\t/* The raw tool call block from `assistantMessage.content`. /\n\ttoolCall: AgentToolCall;\n\t/* Validated tool arguments for the target tool schema. /\n\targs: unknown;\n\t/* The executed tool result before any `afterToolCall` overrides are applied. /\n\tresult: AgentToolResult<any>;\n\t/* Whether the executed tool result is currently treated as an error. /\n\tisError: boolean;\n\t/* Current agent context at the time the tool call is finalized. /\n\tcontext: AgentContext;\n}\n\n/\n Configuration for the agent loop.\n /\nexport interface AgentLoopConfig extends SimpleStreamOptions {\n\tmodel: Model<any>;\n\n\t/\n\t Converts AgentMessage[] to LLM-compatible Message[] before each LLM call.\n\t \n\t Each AgentMessage must be converted to a UserMessage, AssistantMessage, or ToolResultMessage\n\t * that the LLM can understand. AgentMessages that cannot be converted (e.g., UI-only notifications,\n\t * status messages) should be filtered out.\n\t \n\t @example\n\t * ```typescript\n\t * convertToLlm: (messages) => messages.flatMap(m => {\n\t * if (m.role === \"custom\") {\n\t * // Convert custom message to user message\n\t * return [{ role: \"user\", content: m.content, timestamp: m.timestamp }];\n\t * }\n\t * if (m.role === \"notification\") {\n\t * // Filter out UI-only messages\n\t * return [];\n\t * }\n\t * // Pass through standard LLM messages\n\t * return [m];\n\t * })\n\t * ```\n\t /\n\tconvertToLlm: (messages: AgentMessage[]) => Message[] \| Promise<Message[]>;\n\n\t/\n\t Optional transform applied to the context before `convertToLlm`.\n\t \n\t Use this for operations that work at the AgentMessage level:\n\t * - Context window management (pruning old messages)\n\t * - Injecting context from external sources\n\t \n\t @example\n\t * ```typescript\n\t * transformContext: async (messages) => {\n\t * if (estimateTokens(messages) > MAX_TOKENS) {\n\t * return pruneOldMessages(messages);\n\t * }\n\t * return messages;\n\t * }\n\t * ```\n\t /\n\ttransformContext?: (messages: AgentMessage[], signal?: AbortSignal) => Promise<AgentMessage[]>;\n\n\t/\n\t Optional final tool filter applied immediately before each provider call.\n\t \n\t Use this for runtime policy that depends on the fully active tool set.\n\t * The returned list is what token audit and the provider request both see.\n\t * Receives the post-transform AgentMessage context so policy can scope\n\t * request-local custom messages without inspecting provider payload text.\n\t /\n\tfilterTools?: (\n\t\ttools: AgentTool<any>[],\n\t\tsignal?: AbortSignal,\n\t\tmessages?: AgentMessage[],\n\t) => AgentTool<any>[] \| Promise<AgentTool<any>[]>;\n\n\t/\n\t Resolves an API key dynamically for each LLM call.\n\t \n\t Useful for short-lived OAuth tokens (e.g., GitHub Copilot) that may expire\n\t * during long-running tool execution phases.\n\t /\n\tgetApiKey?: (provider: string) => Promise<string \| undefined> \| string \| undefined;\n\n\t/\n\t Returns steering messages to inject into the conversation mid-run.\n\t \n\t Called after each tool execution to check for user interruptions.\n\t * If messages are returned, remaining tool calls are skipped and\n\t * these messages are added to the context before the next LLM call.\n\t \n\t Use this for \"steering\" the agent while it's working.\n\t /\n\tgetSteeringMessages?: () => Promise<AgentMessage[]>;\n\n\t/\n\t Returns follow-up messages to process after the agent would otherwise stop.\n\t \n\t Called when the agent has no more tool calls and no steering messages.\n\t * If messages are returned, they're added to the context and the agent\n\t * continues with another turn.\n\t \n\t Use this for follow-up messages that should wait until the agent finishes.\n\t /\n\tgetFollowUpMessages?: () => Promise<AgentMessage[]>;\n\n\t/\n\t Tool execution mode.\n\t * - \"sequential\": execute tool calls one by one\n\t * - \"parallel\": preflight tool calls sequentially, then execute allowed tools concurrently\n\t \n\t Default: \"parallel\"\n\t /\n\ttoolExecution?: ToolExecutionMode;\n\n\t/\n\t Called before a tool is executed, after arguments have been validated.\n\t \n\t Return `{ block: true }` to prevent execution. The loop emits an error tool result instead.\n\t * The hook receives the agent abort signal and is responsible for honoring it.\n\t /\n\tbeforeToolCall?: (context: BeforeToolCallContext, signal?: AbortSignal) => Promise<BeforeToolCallResult \| undefined>;\n\n\t/\n\t Called after a tool finishes executing, before final tool events are emitted.\n\t \n\t Return an `AfterToolCallResult` to override parts of the executed tool result:\n\t * - `content` replaces the full content array\n\t * - `details` replaces the full details payload\n\t * - `isError` replaces the error flag\n\t \n\t Any omitted fields keep their original values. No deep merge is performed.\n\t * The hook receives the agent abort signal and is responsible for honoring it.\n\t /\n\tafterToolCall?: (context: AfterToolCallContext, signal?: AbortSignal) => Promise<AfterToolCallResult \| undefined>;\n\n\t/\n\t Optional formatter for tool argument validation errors (AJV / schema failures).\n\t * Called in prepareToolCall before the error tool result is emitted.\n\t /\n\tformatValidationError?: (\n\t\ttool: AgentTool<any>,\n\t\ttoolCall: AgentToolCall,\n\t\tbaseMessage: string,\n\t) => string \| Promise<string>;\n\n\t/\n\t Called after a turn when one or more tool calls failed during preparation.\n\t * Use to inject corrective steering and reset the schema-overload counter.\n\t /\n\tonPreparationErrorsTurn?: (\n\t\tcontext: PreparationErrorsTurnContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<PreparationErrorsTurnResult \| void>;\n\n\t/\n\t When true, tool calls in assistant messages are rendered in the TUI\n\t * but NOT executed locally. Used for providers that handle tool execution\n\t * internally (e.g., Claude Code CLI via Agent SDK).\n\t \n\t The agent loop emits tool_execution_start/end events for TUI rendering\n\t * but skips tool.execute() and does not add tool results to context.\n\t /\n\texternalToolExecution?: boolean;\n\n\t/\n\t Called when the agent is about to retry after a recoverable provider error.\n\t \n\t Fires after each transient failure (rate limit, connection reset, etc.)\n\t * before the retry backoff sleep. Useful for surfacing retry telemetry to\n\t * the host app without instrumenting the provider layer directly.\n\t /\n\tonRetry?: (context: RetryContext, signal?: AbortSignal) => Promise<void> \| void;\n\n\t/\n\t Called when the LLM stream fails mid-response.\n\t \n\t Fires once per failed stream — `onRetry` may still fire separately if the\n\t * loop elects to retry. Use this for logging or flushing partial state.\n\t /\n\tonStreamError?: (context: StreamErrorContext, signal?: AbortSignal) => Promise<void> \| void;\n}\n\n/* Context passed to `onRetry`. /\nexport interface RetryContext {\n\tattempt: number;\n\tmaxRetries: number;\n\tdelayMs: number;\n\terror: Error;\n}\n\n/* Context passed to `onStreamError`. /\nexport interface StreamErrorContext {\n\terror: Error;\n\t/* The text already emitted by the stream before it failed (may be empty). /\n\tpartialText: string;\n\t/* Whether the loop will attempt to retry after this failure. /\n\twillRetry: boolean;\n}\n\n/\n Thinking/reasoning level for models that support it.\n * Note: \"xhigh\" is only supported by OpenAI gpt-5.1-codex-max, gpt-5.2, gpt-5.2-codex, gpt-5.3, and gpt-5.3-codex models.\n /\nexport type ThinkingLevel = \"off\" \| \"minimal\" \| \"low\" \| \"medium\" \| \"high\" \| \"xhigh\";\n\n/\n Extensible interface for custom app messages.\n * Apps can extend via declaration merging:\n \n @example\n * ```typescript\n * declare module \"@mariozechner/agent\" {\n * interface CustomAgentMessages {\n * artifact: ArtifactMessage;\n * notification: NotificationMessage;\n * }\n * }\n * ```\n /\nexport interface CustomAgentMessages {\n\t// Empty by default - apps extend via declaration merging\n}\n\n/\n AgentMessage: Union of LLM messages + custom messages.\n * This abstraction allows apps to add custom message types while maintaining\n * type safety and compatibility with the base LLM messages.\n /\nexport type AgentMessage = Message \| CustomAgentMessages[keyof CustomAgentMessages];\n\n/\n Agent state containing all configuration and conversation data.\n /\nexport interface AgentState {\n\tsystemPrompt: string;\n\tmodel: Model<any>;\n\tthinkingLevel: ThinkingLevel;\n\ttools: AgentTool<any>[];\n\tmessages: AgentMessage[]; // Can include attachments + custom message types\n\tisStreaming: boolean;\n\tstreamMessage: AgentMessage \| null;\n\tpendingToolCalls: Set<string>;\n\terror?: string;\n\t/\n\t The model currently being used for inference. Set at _runLoop() start,\n\t * cleared when the loop ends. When present, UI should display this instead\n\t * of `model` to avoid showing a stale value after a mid-turn model switch.\n\t /\n\tactiveInferenceModel?: Model<any>;\n}\n\nexport interface AgentToolResult<T> {\n\t// Content blocks supporting text and images\n\tcontent: (TextContent \| ImageContent)[];\n\t// Details to be displayed in a UI or logged\n\tdetails: T;\n}\n\n// Callback for streaming tool execution updates\nexport type AgentToolUpdateCallback<T = any> = (partialResult: AgentToolResult<T>) => void;\n\n// AgentTool extends Tool but adds the execute function\nexport interface AgentTool<TParameters extends TSchema = TSchema, TDetails = any> extends Tool<TParameters> {\n\t// A human-readable label for the tool to be displayed in UI\n\tlabel: string;\n\texecute: (\n\t\ttoolCallId: string,\n\t\tparams: Static<TParameters>,\n\t\tsignal?: AbortSignal,\n\t\tonUpdate?: AgentToolUpdateCallback<TDetails>,\n\t) => Promise<AgentToolResult<TDetails>>;\n}\n\n// AgentContext is like Context but uses AgentTool\nexport interface AgentContext {\n\tsystemPrompt: string;\n\tmessages: AgentMessage[];\n\ttools?: AgentTool<any>[];\n}\n\nexport type AgentAbortOrigin = \"session-transition\" \| \"user\" \| \"timeout\" \| \"unknown\";\n\n/\n Events emitted by the Agent for UI updates.\n * These events provide fine-grained lifecycle information for messages, turns, and tool executions.\n */\nexport type AgentEvent =\n\t// Agent lifecycle\n\t\| { type: \"agent_start\"; sessionId?: string; turnId?: string }\n\t\| { type: \"agent_end\"; messages: AgentMessage[]; sessionId?: string; turnId?: string; abortOrigin?: AgentAbortOrigin }\n\t// Turn lifecycle - a turn is one assistant response + any tool calls/results\n\t\| { type: \"turn_start\"; sessionId?: string; turnId?: string }\n\t\| { type: \"turn_end\"; message: AgentMessage; toolResults: ToolResultMessage[]; sessionId?: string; turnId?: string }\n\t// Message lifecycle - emitted for user, assistant, and toolResult messages\n\t\| { type: \"message_start\"; message: AgentMessage; sessionId?: string; turnId?: string }\n\t// Only emitted for assistant messages during streaming\n\t\| { type: \"message_update\"; message: AgentMessage; assistantMessageEvent: AssistantMessageEvent; sessionId?: string; turnId?: string }\n\t\| { type: \"message_end\"; message: AgentMessage; sessionId?: string; turnId?: string }\n\t// Tool execution lifecycle\n\t\| { type: \"tool_execution_start\"; toolCallId: string; toolName: string; args: any; sessionId?: string; turnId?: string }\n\t\| { type: \"tool_execution_update\"; toolCallId: string; toolName: string; args: any; partialResult: any; sessionId?: string; turnId?: string }\n\t\| { type: \"tool_execution_end\"; toolCallId: string; toolName: string; result: any; isError: boolean; sessionId?: string; turnId?: string };\n"]}

package/packages/pi-agent-core/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@gsd/pi-agent-core",
-  "version": "1.0.1-dev.bf2899e",
+  "version": "1.0.2-dev.0ee79e5",
   "description": "General-purpose agent core (vendored from pi-mono)",
   "type": "module",
   "gsd": {

package/packages/pi-agent-core/src/agent-loop.test.ts CHANGED Viewed

@@ -730,4 +730,166 @@ describe("agent-loop — schema overload retry cap (#2783)", () => {
 			);
 		}
 	});
+	it("formatValidationError appends hint to validation error tool result", async () => {
+		const tool = makeToolWithSchema();
+		const badCall = makeToolCallMessage({ path: "/tmp/test" });
+		const finalStop = makeAssistantMessage({
+			content: [{ type: "text", text: "Done." }],
+			stopReason: "stop",
+		});
+		const mockStream = createMockStreamFn([badCall, finalStop]);
+		const context: AgentContext = {
+			systemPrompt: "test",
+			messages: [{ role: "user", content: [{ type: "text", text: "go" }], timestamp: Date.now() }],
+			tools: [tool],
+		};
+		const config: AgentLoopConfig = {
+			model: TEST_MODEL,
+			convertToLlm: (msgs) => msgs.filter((m): m is any => m.role !== "custom"),
+			toolExecution: "sequential",
+			formatValidationError: (_tool, _tc, base) => `${base}\n\nHINT: include content field`,
+		};
+		const stream = agentLoop(
+			[{ role: "user", content: [{ type: "text", text: "go" }], timestamp: Date.now() }],
+			context,
+			config,
+			undefined,
+			mockStream as any,
+		);
+		const events = await collectEvents(stream);
+		const toolError = events.find(
+			(e) => e.type === "tool_execution_end" && e.isError === true,
+		);
+		assert.ok(toolError && toolError.type === "tool_execution_end");
+		const text = toolError.result.content.find((c) => c.type === "text");
+		assert.ok(text && text.type === "text" && text.text.includes("HINT: include content field"));
+	});
+	it("onPreparationErrorsTurn with resetValidationFailureCap prevents schema overload stop", async () => {
+		const tool = makeToolWithSchema();
+		const badCall = makeToolCallMessage({ path: "/tmp/test" });
+		const goodCall = makeToolCallMessage({ path: "/tmp/test", content: "hello" });
+		const finalStop = makeAssistantMessage({
+			content: [{ type: "text", text: "Done." }],
+			stopReason: "stop",
+		});
+		// Exceed cap without reset: 3 bad + would stop. With reset after each bad: survives.
+		const responses = [badCall, badCall, badCall, goodCall, finalStop];
+		const mockStream = createMockStreamFn(responses);
+		let recoveryCalls = 0;
+		const context: AgentContext = {
+			systemPrompt: "test",
+			messages: [{ role: "user", content: [{ type: "text", text: "go" }], timestamp: Date.now() }],
+			tools: [tool],
+		};
+		const config: AgentLoopConfig = {
+			model: TEST_MODEL,
+			convertToLlm: (msgs) => msgs.filter((m): m is any => m.role !== "custom"),
+			toolExecution: "sequential",
+			onPreparationErrorsTurn: async () => {
+				recoveryCalls++;
+				return {
+					resetValidationFailureCap: true,
+					steeringMessages: [
+						{
+							role: "user",
+							content: [{ type: "text", text: "Retry with valid args." }],
+							timestamp: Date.now(),
+						},
+					],
+				};
+			},
+		};
+		const stream = agentLoop(
+			[{ role: "user", content: [{ type: "text", text: "go" }], timestamp: Date.now() }],
+			context,
+			config,
+			undefined,
+			mockStream as any,
+		);
+		const events = await collectEvents(stream);
+		const agentEnd = events.find((e) => e.type === "agent_end");
+		assert.ok(agentEnd, "agent must complete without schema overload stop");
+		assert.ok(recoveryCalls >= 3, "recovery hook should run for each bad turn");
+		const stopMessages = (agentEnd as any).messages.filter(
+			(m: AgentMessage) =>
+				m.role === "assistant" &&
+				(m as AssistantMessage).errorMessage?.includes("Schema overload"),
+		);
+		assert.equal(stopMessages.length, 0, "must not emit schema overload stop");
+	});
+	it("onPreparationErrorsTurn failures exclude execution errors in mixed turns", async () => {
+		const schemaTool = makeToolWithSchema();
+		const execFailTool: AgentTool<any> = {
+			...makeToolWithSchema(),
+			name: "exec_fail_tool",
+			label: "Exec Fail",
+			execute: async () => {
+				throw new Error("EXECUTION_PHASE_FAILURE");
+			},
+		};
+		const prepFailCall = makeToolCallMessage({ path: "/tmp/test" });
+		(prepFailCall.content[0] as any).name = "write_file";
+		const execFailCall = makeToolCallMessage({ path: "/tmp/ok", content: "hello" });
+		(execFailCall.content[0] as any).id = "tc_exec_fail";
+		(execFailCall.content[0] as any).name = "exec_fail_tool";
+		const mixedTurn = makeAssistantMessage({
+			content: [
+				prepFailCall.content[0],
+				execFailCall.content[0],
+			],
+			stopReason: "toolUse",
+		});
+		const finalStop = makeAssistantMessage({
+			content: [{ type: "text", text: "Done." }],
+			stopReason: "stop",
+		});
+		const mockStream = createMockStreamFn([mixedTurn, finalStop]);
+		let capturedFailures: Array<{ toolName: string; errorText: string }> = [];
+		const context: AgentContext = {
+			systemPrompt: "test",
+			messages: [{ role: "user", content: [{ type: "text", text: "go" }], timestamp: Date.now() }],
+			tools: [schemaTool, execFailTool],
+		};
+		const config: AgentLoopConfig = {
+			model: TEST_MODEL,
+			convertToLlm: (msgs) => msgs.filter((m): m is any => m.role !== "custom"),
+			toolExecution: "sequential",
+			onPreparationErrorsTurn: async (ctx) => {
+				capturedFailures = ctx.failures.map((f) => ({
+					toolName: f.toolName,
+					errorText: f.errorText,
+				}));
+				return undefined;
+			},
+		};
+		const stream = agentLoop(
+			[{ role: "user", content: [{ type: "text", text: "go" }], timestamp: Date.now() }],
+			context,
+			config,
+			undefined,
+			mockStream as any,
+		);
+		await collectEvents(stream);
+		assert.equal(capturedFailures.length, 1, "only preparation-phase errors belong in failures");
+		assert.equal(capturedFailures[0]?.toolName, "write_file");
+		assert.ok(
+			!capturedFailures.some((f) => f.errorText.includes("EXECUTION_PHASE_FAILURE")),
+			"execution errors must not appear in preparation failures context",
+		);
+	});
 });

package/packages/pi-agent-core/src/agent-loop.ts CHANGED Viewed

@@ -19,6 +19,8 @@ import type {
 	AgentTool,
 	AgentToolCall,
 	AgentToolResult,
+	PreparationErrorFailure,
+	PreparationErrorsTurnContext,
 	StreamFn,
 } from "./types.js";
 import { maybeLogTokenAudit } from "./token-audit.js";
@@ -333,7 +335,11 @@ async function runLoop(
 					toolResults.length > 0 &&
 					toolExecution.preparationErrorCount === toolResults.length;
 				if (allToolsFailedPreparation) {
-					consecutiveAllToolErrorTurns++;
+					if (toolExecution.resetValidationFailureCap) {
+						consecutiveAllToolErrorTurns = 0;
+					} else {
+						consecutiveAllToolErrorTurns++;
+					}
 				} else if (!hasPreparationErrors) {
 					// Reset only when there are zero preparation errors this turn.
 					// Mixed turns (some prep errors, some successes) don't reset,
@@ -504,6 +510,8 @@ interface ToolExecutionResult {
 	steeringMessages?: AgentMessage[];
 	/** Number of tool results that failed during preparation (validation/schema). */
 	preparationErrorCount: number;
+	/** When true, recovery hook requested resetting the schema-overload counter. */
+	resetValidationFailureCap?: boolean;
 }
 /**
@@ -534,6 +542,7 @@ async function executeToolCallsSequential(
 	const results: ToolResultMessage[] = [];
 	let steeringMessages: AgentMessage[] | undefined;
 	let preparationErrorCount = 0;
+	const preparationErrorToolCallIds = new Set<string>();
 	for (let index = 0; index < toolCalls.length; index++) {
 		const toolCall = toolCalls[index];
@@ -548,6 +557,7 @@ async function executeToolCallsSequential(
 		if (preparation.kind === "immediate") {
 			if (preparation.isError) {
 				preparationErrorCount++;
+				preparationErrorToolCallIds.add(toolCall.id);
 			}
 			results.push(emitToolCallOutcome(toolCall, preparation.result, preparation.isError, stream));
 		} else {
@@ -578,7 +588,15 @@ async function executeToolCallsSequential(
 		}
 	}
-	return { toolResults: results, steeringMessages, preparationErrorCount };
+	return finalizeToolExecutionResult(
+		assistantMessage,
+		results,
+		steeringMessages,
+		preparationErrorCount,
+		preparationErrorToolCallIds,
+		config,
+		signal,
+	);
 }
 async function executeToolCallsParallel(
@@ -593,6 +611,7 @@ async function executeToolCallsParallel(
 	const runnableCalls: PreparedToolCall[] = [];
 	let steeringMessages: AgentMessage[] | undefined;
 	let preparationErrorCount = 0;
+	const preparationErrorToolCallIds = new Set<string>();
 	for (let index = 0; index < toolCalls.length; index++) {
 		const toolCall = toolCalls[index];
@@ -607,6 +626,7 @@ async function executeToolCallsParallel(
 		if (preparation.kind === "immediate") {
 			if (preparation.isError) {
 				preparationErrorCount++;
+				preparationErrorToolCallIds.add(toolCall.id);
 			}
 			results.push(emitToolCallOutcome(toolCall, preparation.result, preparation.isError, stream));
 		} else {
@@ -624,7 +644,15 @@ async function executeToolCallsParallel(
 				for (const skipped of remainingCalls) {
 					results.push(skipToolCall(skipped, stream));
 				}
-				return { toolResults: results, steeringMessages, preparationErrorCount };
+				return finalizeToolExecutionResult(
+					assistantMessage,
+					results,
+					steeringMessages,
+					preparationErrorCount,
+					preparationErrorToolCallIds,
+					config,
+					signal,
+				);
 			}
 		}
 	}
@@ -656,7 +684,80 @@ async function executeToolCallsParallel(
 		}
 	}
-	return { toolResults: results, steeringMessages, preparationErrorCount };
+	return finalizeToolExecutionResult(
+		assistantMessage,
+		results,
+		steeringMessages,
+		preparationErrorCount,
+		preparationErrorToolCallIds,
+		config,
+		signal,
+	);
+}
+function buildPreparationErrorsContext(
+	assistantMessage: AssistantMessage,
+	toolResults: ToolResultMessage[],
+	preparationErrorToolCallIds: ReadonlySet<string>,
+	preparationErrorCount: number,
+): PreparationErrorsTurnContext {
+	const toolCallsById = new Map(
+		(assistantMessage.content.filter((c) => c.type === "toolCall") as AgentToolCall[]).map((tc) => [
+			tc.id,
+			tc,
+		]),
+	);
+	const failures: PreparationErrorFailure[] = [];
+	for (const result of toolResults) {
+		if (!result.isError) continue;
+		if (!preparationErrorToolCallIds.has(result.toolCallId)) continue;
+		const toolCall = toolCallsById.get(result.toolCallId);
+		if (!toolCall) continue;
+		const textBlock = result.content.find((c) => c.type === "text");
+		const errorText = textBlock && textBlock.type === "text" ? textBlock.text : "";
+		failures.push({
+			toolName: toolCall.name,
+			arguments: toolCall.arguments as Record<string, unknown>,
+			errorText,
+		});
+	}
+	return { assistantMessage, failures, preparationErrorCount };
+}
+async function finalizeToolExecutionResult(
+	assistantMessage: AssistantMessage,
+	toolResults: ToolResultMessage[],
+	steeringMessages: AgentMessage[] | undefined,
+	preparationErrorCount: number,
+	preparationErrorToolCallIds: ReadonlySet<string>,
+	config: AgentLoopConfig,
+	signal: AbortSignal | undefined,
+): Promise<ToolExecutionResult> {
+	let resetValidationFailureCap: boolean | undefined;
+	if (preparationErrorCount > 0 && config.onPreparationErrorsTurn) {
+		const recovery = await config.onPreparationErrorsTurn(
+			buildPreparationErrorsContext(
+				assistantMessage,
+				toolResults,
+				preparationErrorToolCallIds,
+				preparationErrorCount,
+			),
+			signal,
+		);
+		const recoverySteering = recovery?.steeringMessages;
+		if (recoverySteering && recoverySteering.length > 0) {
+			steeringMessages = recoverySteering;
+		}
+		if (recovery?.resetValidationFailureCap === true) {
+			resetValidationFailureCap = true;
+		}
+	}
+	return {
+		toolResults,
+		steeringMessages,
+		preparationErrorCount,
+		resetValidationFailureCap,
+	};
 }
 type PreparedToolCall = {
@@ -720,9 +821,13 @@ async function prepareToolCall(
 			args: validatedArgs,
 		};
 	} catch (error) {
+		let message = error instanceof Error ? error.message : String(error);
+		if (config.formatValidationError) {
+			message = await config.formatValidationError(tool, toolCall, message);
+		}
 		return {
 			kind: "immediate",
-			result: createErrorToolResult(error instanceof Error ? error.message : String(error)),
+			result: createErrorToolResult(message),
 			isError: true,
 		};
 	}