@oh-my-pi/pi-agent-core 17.4.1 → 18.0.0

package/CHANGELOG.md

@@ -1,6 +1,11 @@
 # Changelog
 
-## [Unreleased]
+## [18.0.0] - 2026-08-22
+
+### Fixed
+
+- Fixed Anthropic Claude tool calls containing provider-visible private-use icon glyphs by reversibly tokenizing glyphs at the wire boundary and rejecting model-invented or unresolved glyph tokens before execution.
+- Fixed agent identity confusion after session handoffs by clarifying context framing and ensuring successor instances seamlessly resume existing execution plans.
 
 ## [17.4.1] - 2026-08-21
 

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

@@ -11,7 +11,7 @@
  */
 export declare class CompactionCancelledError extends Error {
     readonly name: "CompactionCancelledError";
-    constructor(message?: string);
+    constructor(message?: string, options?: ErrorOptions);
 }
 /**
  * A provider-native compaction request failed after every native protocol

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

@@ -59,6 +59,14 @@ declare module "../types.js" {
 export type ConvertToLlm = (messages: AgentMessage[]) => Message[];
 export declare function renderBranchSummaryContext(summary: string): string;
 export declare function renderCompactionSummaryContext(summary: string): string;
+/**
+ * Wrap a handoff document for injection into the successor context. Unlike the
+ * generic compaction wrapper, this names the mechanism and pins authorship —
+ * the document was written by a prior instance in its own voice, so without
+ * this framing the successor misreads first-person "Next Steps" as fresh user
+ * instructions (or tries to write the handoff again).
+ */
+export declare function renderHandoffSummaryContext(summary: string): string;
 export declare function createBranchSummaryMessage(summary: string, fromId: string, timestamp: string): BranchSummaryMessage;
 /** Optional metadata for {@link createCompactionSummaryMessage}. */
 export interface CompactionSummaryMessageOptions {

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-agent-core",
-	"version": "17.4.1",
+	"version": "18.0.0",
 	"description": "General-purpose agent with transport abstraction, state management, and attachment support",
 	"homepage": "https://omp.sh",
 	"author": "Stencil Labs, Inc.",
@@ -35,16 +35,16 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-ai": "17.4.1",
-		"@oh-my-pi/pi-catalog": "17.4.1",
-		"@oh-my-pi/pi-natives": "17.4.1",
-		"@oh-my-pi/pi-utils": "17.4.1",
-		"@oh-my-pi/pi-wire": "17.4.1",
-		"@oh-my-pi/snapcompact": "17.4.1",
+		"@oh-my-pi/pi-ai": "18.0.0",
+		"@oh-my-pi/pi-catalog": "18.0.0",
+		"@oh-my-pi/pi-natives": "18.0.0",
+		"@oh-my-pi/pi-utils": "18.0.0",
+		"@oh-my-pi/pi-wire": "18.0.0",
+		"@oh-my-pi/snapcompact": "18.0.0",
 		"@opentelemetry/api": "^1.9.1"
 	},
 	"devDependencies": {
-		"@oh-my-pi/omptype": "17.4.1",
+		"@oh-my-pi/omptype": "18.0.0",
 		"@opentelemetry/context-async-hooks": "^2.9.0",
 		"@opentelemetry/sdk-trace-base": "^2.9.0",
 		"@types/bun": "^1.3.14"

package/src/compaction/errors.ts

@@ -13,8 +13,8 @@
 export class CompactionCancelledError extends Error {
 	override readonly name = "CompactionCancelledError" as const;
 
-	constructor(message = "Compaction cancelled") {
-		super(message);
+	constructor(message = "Compaction cancelled", options?: ErrorOptions) {
+		super(message, options);
 	}
 }
 

package/src/compaction/messages.ts

@@ -10,8 +10,10 @@ import { prompt } from "@oh-my-pi/pi-utils";
 import type { AgentMessage } from "../types";
 import branchSummaryContextPrompt from "./prompts/branch-summary-context.md" with { type: "text" };
 import compactionSummaryContextPrompt from "./prompts/compaction-summary-context.md" with { type: "text" };
+import handoffSummaryContextPrompt from "./prompts/handoff-summary-context.md" with { type: "text" };
 
 const COMPACTION_SUMMARY_TEMPLATE = compactionSummaryContextPrompt;
+const HANDOFF_SUMMARY_TEMPLATE = handoffSummaryContextPrompt;
 const BRANCH_SUMMARY_TEMPLATE = branchSummaryContextPrompt;
 
 export interface CustomMessage<T = unknown> {
@@ -93,6 +95,16 @@ export function renderBranchSummaryContext(summary: string): string {
 export function renderCompactionSummaryContext(summary: string): string {
 	return prompt.render(COMPACTION_SUMMARY_TEMPLATE, { summary });
 }
+/**
+ * Wrap a handoff document for injection into the successor context. Unlike the
+ * generic compaction wrapper, this names the mechanism and pins authorship —
+ * the document was written by a prior instance in its own voice, so without
+ * this framing the successor misreads first-person "Next Steps" as fresh user
+ * instructions (or tries to write the handoff again).
+ */
+export function renderHandoffSummaryContext(summary: string): string {
+	return prompt.render(HANDOFF_SUMMARY_TEMPLATE, { summary });
+}
 
 export function createBranchSummaryMessage(summary: string, fromId: string, timestamp: string): BranchSummaryMessage {
 	return {
@@ -216,7 +228,10 @@ export function convertMessageToLlm(message: AgentMessage): Message | undefined
 							: [
 									{
 										type: "text" as const,
-										text: renderCompactionSummaryContext(message.summary),
+										text:
+											message.method === "handoff"
+												? renderHandoffSummaryContext(message.summary)
+												: renderCompactionSummaryContext(message.summary),
 									},
 									...(message.images ?? []),
 								],

package/src/compaction/prompts/handoff-document.md

@@ -10,6 +10,8 @@ Capture exact technical state, not abstractions.
 - Test results, observed failures
 - Decisions made
 - Partial work affecting the next step
+Register: address the successor directly in the imperative ("Fix X", "Run Y") — never first person ("I need to…", "my attempt…").
+The handoff mechanism is invisible to the document: NEVER list writing, generating, or delivering a handoff/summary/context document as progress or a next step. Progress and Next Steps cover the user's task only.
 </instruction>
 
 <output>

package/src/compaction/prompts/handoff-summary-context.md

@@ -0,0 +1,9 @@
+Context replaced. The <handoff> below is a handoff document a prior instance of you wrote from the full conversation. It is your own working memory, not user input.
+- First person inside it refers to you (the prior instance).
+- "Next Steps" is your own resumed plan; re-check it against the latest user message before acting.
+- The handoff already exists and is complete: NEVER write another handoff document unless the user explicitly asks.
+MUST build on prior work; NEVER duplicate prior work.
+
+<handoff>
+{{summary}}
+</handoff>