pi-squire 0.20.0 → 0.20.1

package/CHANGELOG.md

@@ -6,6 +6,16 @@ follows [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.20.1] - 2026-11-02
+
+### Changed
+
+- `delegation_fork` warns when its effective model differs from the source's
+  last model: copied context will be written to a new cache, with an approximate
+  token count when source usage is available. The model parameter and README
+  explain the cost; same-model forks retain their cache behavior. New fork tests
+  cover changed/same models, effective model locks and missing or invalid usage.
+
 ## [0.20.0] - 2026-11-02
 
 ### Added
@@ -1111,7 +1121,8 @@ author's dotfiles; the changes below are against that copy.
 
 - The published file list includes `child.ts`, which `index.ts` imports.
 
-[Unreleased]: https://github.com/gvanderclay/pi-squire/compare/v0.20.0...HEAD
+[Unreleased]: https://github.com/gvanderclay/pi-squire/compare/v0.20.1...HEAD
+[0.20.1]: https://github.com/gvanderclay/pi-squire/compare/v0.20.0...v0.20.1
 [0.20.0]: https://github.com/gvanderclay/pi-squire/compare/v0.19.1...v0.20.0
 [0.19.1]: https://github.com/gvanderclay/pi-squire/compare/v0.19.0...v0.19.1
 [0.19.0]: https://github.com/gvanderclay/pi-squire/compare/v0.18.4...v0.19.0

package/README.md

@@ -1670,7 +1670,10 @@ folder must exist, its agent must still be enabled, and current nesting grants,
 depth, capacity and trust checks apply. Copied history does not transfer
 ownership of the original child's descendants. Model, thinking and auto-exit
 default to the source's last settings with the same locks and fallbacks as a
-resume; the current roster supplies the prompt and tools.
+resume; the current roster supplies the prompt and tools. A different effective
+model re-reads the copied context without the source's cache; the result warns
+about the new cache write, estimating copied tokens when source usage is
+available. Keep the source's model unless the task needs another role.
 `session:launch` is emitted with the `delegation_fork` tool call id.
 
 ## Hooks

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-squire",
-	"version": "0.20.0",
+	"version": "0.20.1",
 	"description": "Starts a delegate Pi session in a background tmux window, sends it the task over message:*, and shows the parent its result",
 	"keywords": [
 		"pi-package",

package/src/fork.ts

@@ -3,6 +3,7 @@ import { Type } from "typebox";
 
 import { disabledProblem, THINKING_LEVELS } from "./agents.ts";
 import { dirtyNotice } from "./render.ts";
+import { finishedModel, sessionInputTokens } from "./result-sessions.ts";
 import { deriveState, isStarted, type StartedRecorded } from "./results.ts";
 import type { ResumeDeps, Resumed } from "./resume.ts";
 import { sessionFor, settleModel } from "./resume-checks.ts";
@@ -88,6 +89,14 @@ async function sharedFolderNotice(deps: ForkDeps, record: StartedRecorded, workt
 	return [`shares a working folder with running delegation ${record.id}; pass worktree to isolate`];
 }
 
+function modelNotice(record: StartedRecorded, sessionPath: string, model: string): string[] {
+	const sourceModel = finishedModel(sessionPath) ?? record.result?.finishedModel ?? record.model;
+	if (model === sourceModel) return [];
+	const tokens = sessionInputTokens(sessionPath);
+	const estimate = tokens === undefined ? "copied tokens" : `about ${Math.round(tokens / 1000)}k copied tokens`;
+	return [`${model} differs from the source's ${sourceModel}: ${estimate} will be written to a new cache.`];
+}
+
 function launchText(id: string, details: Forked, chosen: Awaited<ReturnType<ResumeDeps["chooseModel"]>>): string {
 	const workspace = details.workspace;
 	const managed =
@@ -97,6 +106,13 @@ function launchText(id: string, details: Forked, chosen: Awaited<ReturnType<Resu
 	return `Forked delegation ${id} as ${details.id} in window ${details.windowName} in ${details.cwd}.${managed} The original session is untouched. Its result arrives as a message that starts your next turn on its own; delegation_close ends it.${fallbackNote(chosen)}${details.notices.map((notice) => ` ${notice}`).join("")}`;
 }
 
+const modelParameter = Type.Optional(
+	Type.String({
+		description:
+			"provider/id; defaults to the source's last model. A different model re-reads the copied context without its cache; keep the source's model unless the task needs another role.",
+	}),
+);
+
 export function forkTool(deps: ForkDeps): ToolDef {
 	return {
 		name: "delegation_fork",
@@ -106,7 +122,7 @@ export function forkTool(deps: ForkDeps): ToolDef {
 		parameters: Type.Object({
 			id: Type.String({ description: "The direct child's delegation id whose context to copy." }),
 			task: Type.String(),
-			model: Type.Optional(Type.String({ description: "provider/id; defaults to the source's last model." })),
+			model: modelParameter,
 			thinking: Type.Optional(
 				Type.String({ description: `${THINKING_LEVELS.join(", ")}; defaults to the source's last level.` }),
 			),
@@ -141,6 +157,7 @@ export function forkTool(deps: ForkDeps): ToolDef {
 				ctx,
 			);
 			const source = forkSource(record, session);
+			chosen.notices.push(...modelNotice(record, session.path, chosen.model));
 			chosen.notices.push(...(await sharedFolderNotice(deps, record, given(params.worktree))));
 			const details = await deps.launch(
 				{

package/src/result-sessions.ts

@@ -78,6 +78,32 @@ export function finishedModel(sessionPath: string | undefined): string | undefin
 	return undefined;
 }
 
+/** Approximate copied context from the last assistant request, excluding its output. */
+export function sessionInputTokens(sessionPath: string): number | undefined {
+	let lines: string[];
+	try {
+		lines = readFileSync(sessionPath, "utf8").split("\n");
+	} catch {
+		return undefined;
+	}
+	for (let i = lines.length - 1; i >= 0; i--) {
+		let entry: { type?: unknown; message?: { role?: unknown; usage?: Record<string, unknown> } };
+		try {
+			entry = JSON.parse(lines[i]);
+		} catch {
+			continue;
+		}
+		if (entry?.type !== "message" || entry.message?.role !== "assistant") continue;
+		const usage = entry.message.usage;
+		const counts = [usage?.input, usage?.cacheRead, usage?.cacheWrite];
+		if (!counts.every((count): count is number => typeof count === "number" && Number.isFinite(count) && count >= 0))
+			return undefined;
+		const total = counts.reduce((sum, count) => sum + count, 0);
+		return Number.isFinite(total) && total > 0 ? total : undefined;
+	}
+	return undefined;
+}
+
 /** One session-file line, as much of it as the branch walk reads. */
 type BranchEntry = { type?: unknown; id?: unknown; parentId?: unknown; thinkingLevel?: unknown };