@selesai/code 0.8.3 → 0.8.4

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/package-manager-cli.d.ts

@@ -0,0 +1,8 @@
+import type { InlineExtension } from "./core/extensions/types.ts";
+export type PackageCommand = "install" | "remove" | "update" | "list";
+export interface PackageCommandRuntimeOptions {
+    extensionFactories?: InlineExtension[];
+}
+export declare function handleConfigCommand(args: string[], runtimeOptions?: PackageCommandRuntimeOptions): Promise<boolean>;
+export declare function handlePackageCommand(args: string[], runtimeOptions?: PackageCommandRuntimeOptions): Promise<boolean>;
+//# sourceMappingURL=package-manager-cli.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/rpc-entry.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=rpc-entry.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/ansi.d.ts

@@ -0,0 +1,2 @@
+export declare function stripAnsi(value: string): string;
+//# sourceMappingURL=ansi.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/changelog.d.ts

@@ -0,0 +1,22 @@
+export interface ChangelogEntry {
+    major: number;
+    minor: number;
+    patch: number;
+    content: string;
+}
+export declare function normalizeChangelogLinks(markdown: string, version: string | ChangelogEntry): string;
+/**
+ * Parse changelog entries from CHANGELOG.md
+ * Scans for ## lines and collects content until next ## or EOF
+ */
+export declare function parseChangelog(changelogPath: string): ChangelogEntry[];
+/**
+ * Compare versions. Returns: -1 if v1 < v2, 0 if v1 === v2, 1 if v1 > v2
+ */
+export declare function compareVersions(v1: ChangelogEntry, v2: ChangelogEntry): number;
+/**
+ * Get entries newer than lastVersion
+ */
+export declare function getNewEntries(entries: ChangelogEntry[], lastVersion: string): ChangelogEntry[];
+export { getChangelogPath } from "../config.ts";
+//# sourceMappingURL=changelog.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/child-process.d.ts

@@ -0,0 +1,18 @@
+import { type ChildProcess, type ChildProcessByStdio, type SpawnOptions, type SpawnOptionsWithStdioTuple, type SpawnSyncOptionsWithStringEncoding, type SpawnSyncReturns, type StdioNull, type StdioPipe } from "node:child_process";
+import type { Readable } from "node:stream";
+export declare function spawnProcess(command: string, args: string[], options: SpawnOptionsWithStdioTuple<StdioNull, StdioPipe, StdioPipe>): ChildProcessByStdio<null, Readable, Readable>;
+export declare function spawnProcess(command: string, args: string[], options: SpawnOptions): ChildProcess;
+export declare function spawnProcessSync(command: string, args: string[], options: SpawnSyncOptionsWithStringEncoding): SpawnSyncReturns<string>;
+/**
+ * Wait for a child process to terminate without hanging on inherited stdio handles.
+ *
+ * A short-lived child can `exit` while a detached descendant keeps its stdout/stderr
+ * pipe open. We must not resolve and destroy the streams on a fixed deadline measured
+ * from `exit`, or output still being written past that deadline is silently lost
+ * (earendil-works/pi#5303). Instead, after `exit` we wait for the pipes to fall idle:
+ * the grace timer is re-armed on every chunk, so an actively writing descendant keeps
+ * us reading, while a quiet inherited handle (e.g. a Windows daemonized descendant
+ * that never lets `close` fire) still releases us after the grace elapses.
+ */
+export declare function waitForChildProcess(child: ChildProcess): Promise<number | null>;
+//# sourceMappingURL=child-process.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/clipboard-image.d.ts

@@ -0,0 +1,11 @@
+export type ClipboardImage = {
+    bytes: Uint8Array;
+    mimeType: string;
+};
+export declare function isWaylandSession(env?: NodeJS.ProcessEnv): boolean;
+export declare function extensionForImageMimeType(mimeType: string): string | null;
+export declare function readClipboardImage(options?: {
+    env?: NodeJS.ProcessEnv;
+    platform?: NodeJS.Platform;
+}): Promise<ClipboardImage | null>;
+//# sourceMappingURL=clipboard-image.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/clipboard-native.d.ts

@@ -0,0 +1,11 @@
+export type ClipboardModule = {
+    getText: () => Promise<string>;
+    setText: (text: string) => Promise<void>;
+    hasImage: () => boolean;
+    getImageBinary: () => Promise<Array<number>>;
+};
+type ClipboardRequire = (id: string) => unknown;
+export declare function loadClipboardNative(requires?: readonly ClipboardRequire[]): ClipboardModule | null;
+declare const clipboard: ClipboardModule | null;
+export { clipboard };
+//# sourceMappingURL=clipboard-native.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/clipboard.d.ts

@@ -0,0 +1,4 @@
+/** Read plain text from the system clipboard, if native clipboard access is available. */
+export declare function readClipboardText(): Promise<string | null>;
+export declare function copyToClipboard(text: string): Promise<void>;
+//# sourceMappingURL=clipboard.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/deprecation.d.ts

@@ -0,0 +1,4 @@
+export declare function warnDeprecation(message: string): void;
+/** Clear deprecation warning state. Exported for tests. */
+export declare function clearDeprecationWarningsForTests(): void;
+//# sourceMappingURL=deprecation.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/exif-orientation.d.ts

@@ -0,0 +1,5 @@
+import type { PhotonImageType } from "./photon.ts";
+type Photon = typeof import("@silvia-odwyer/photon-node");
+export declare function applyExifOrientation(photon: Photon, image: PhotonImageType, originalBytes: Uint8Array): PhotonImageType;
+export {};
+//# sourceMappingURL=exif-orientation.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/frontmatter.d.ts

@@ -0,0 +1,8 @@
+type ParsedFrontmatter<T extends Record<string, unknown>> = {
+    frontmatter: T;
+    body: string;
+};
+export declare const parseFrontmatter: <T extends Record<string, unknown> = Record<string, unknown>>(content: string) => ParsedFrontmatter<T>;
+export declare const stripFrontmatter: (content: string) => string;
+export {};
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/fs-watch.d.ts

@@ -0,0 +1,5 @@
+import { type FSWatcher, type WatchListener } from "node:fs";
+export declare const FS_WATCH_RETRY_DELAY_MS = 5000;
+export declare function closeWatcher(watcher: FSWatcher | null | undefined): void;
+export declare function watchWithErrorHandler(path: string, listener: WatchListener<string>, onError: () => void): FSWatcher | null;
+//# sourceMappingURL=fs-watch.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/git.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Parsed git URL information.
+ */
+export type GitSource = {
+    /** Always "git" for git sources */
+    type: "git";
+    /** Clone URL (always valid for git clone, without ref suffix) */
+    repo: string;
+    /** Git host domain (e.g., "github.com") */
+    host: string;
+    /** Repository path (e.g., "user/repo") */
+    path: string;
+    /** Git ref (branch, tag, commit) if specified */
+    ref?: string;
+    /** True if ref was specified (package won't be auto-updated) */
+    pinned: boolean;
+};
+/**
+ * Parse git source into a GitSource.
+ *
+ * Rules:
+ * - With git: prefix, accept all historical shorthand forms.
+ * - Without git: prefix, only accept explicit protocol URLs.
+ */
+export declare function parseGitUrl(source: string): GitSource | null;
+//# sourceMappingURL=git.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/html.d.ts

@@ -0,0 +1,7 @@
+export interface DecodedHtmlEntity {
+    text: string;
+    length: number;
+}
+export declare function decodeHtmlEntity(entity: string): string | undefined;
+export declare function decodeHtmlEntityAt(html: string, index: number): DecodedHtmlEntity | undefined;
+//# sourceMappingURL=html.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/image-convert.d.ts

@@ -0,0 +1,10 @@
+export declare function convertImageBytesToPng(bytes: Uint8Array): Promise<Uint8Array | null>;
+/**
+ * Convert image to PNG format for terminal display.
+ * Kitty graphics protocol requires PNG format (f=100).
+ */
+export declare function convertToPng(base64Data: string, mimeType: string): Promise<{
+    data: string;
+    mimeType: string;
+} | null>;
+//# sourceMappingURL=image-convert.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/image-process.d.ts

@@ -0,0 +1,18 @@
+import { type ImageResizeOptions } from "./image-resize.ts";
+export interface ProcessImageOptions {
+    /** Whether to resize images to inline provider limits. Default: true */
+    autoResizeImages?: boolean;
+    /** Optional resize overrides. Uses resizeImage defaults when omitted. */
+    resizeOptions?: ImageResizeOptions;
+}
+export type ProcessImageResult = {
+    ok: true;
+    data: string;
+    mimeType: string;
+    hints: string[];
+} | {
+    ok: false;
+    message: string;
+};
+export declare function processImage(bytes: Uint8Array, mimeType: string, options?: ProcessImageOptions): Promise<ProcessImageResult>;
+//# sourceMappingURL=image-process.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/image-resize-core.d.ts

@@ -0,0 +1,30 @@
+export interface ImageResizeOptions {
+    maxWidth?: number;
+    maxHeight?: number;
+    maxBytes?: number;
+    jpegQuality?: number;
+}
+export interface ResizedImage {
+    data: string;
+    mimeType: string;
+    originalWidth: number;
+    originalHeight: number;
+    width: number;
+    height: number;
+    wasResized: boolean;
+}
+/**
+ * Resize an image to fit within the specified max dimensions and encoded file size.
+ * Returns null if the image cannot be resized below maxBytes.
+ *
+ * Uses Photon (Rust/WASM) for image processing. If Photon is not available,
+ * returns null.
+ *
+ * Strategy for staying under maxBytes:
+ * 1. First resize to maxWidth/maxHeight
+ * 2. Try both PNG and JPEG formats, pick the smaller one
+ * 3. If still too large, try JPEG with decreasing quality
+ * 4. If still too large, progressively reduce dimensions until 1x1
+ */
+export declare function resizeImageInProcess(inputBytes: Uint8Array, mimeType: string, options?: ImageResizeOptions): Promise<ResizedImage | null>;
+//# sourceMappingURL=image-resize-core.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/image-resize-worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=image-resize-worker.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/image-resize.d.ts

@@ -0,0 +1,16 @@
+import { type ImageResizeOptions, type ResizedImage } from "./image-resize-core.ts";
+export type { ImageResizeOptions, ResizedImage } from "./image-resize-core.ts";
+/**
+ * Resize an image to fit within the specified max dimensions and encoded file size.
+ * Runs Photon in a worker thread so WASM decoding, resizing, and encoding do not
+ * block the TUI event loop. If the worker cannot be loaded (for example in some
+ * Bun compiled executable layouts), fall back to in-process resizing so image
+ * reads still work.
+ */
+export declare function resizeImage(inputBytes: Uint8Array, mimeType: string, options?: ImageResizeOptions): Promise<ResizedImage | null>;
+/**
+ * Format a dimension note for resized images.
+ * This helps the model understand the coordinate mapping.
+ */
+export declare function formatDimensionNote(result: ResizedImage): string | undefined;
+//# sourceMappingURL=image-resize.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/json.d.ts

@@ -0,0 +1,3 @@
+/** Strip `//` line comments and trailing commas from JSON, leaving string literals untouched. */
+export declare function stripJsonComments(input: string): string;
+//# sourceMappingURL=json.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/mime.d.ts

@@ -0,0 +1,3 @@
+export declare function detectSupportedImageMimeType(buffer: Uint8Array): string | null;
+export declare function detectSupportedImageMimeTypeFromFile(filePath: string): Promise<string | null>;
+//# sourceMappingURL=mime.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/open-browser.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Open a URL or file in the platform browser/default handler.
+ *
+ * This intentionally never invokes a shell. On Windows, do not use
+ * `cmd /c start`: cmd.exe re-parses metacharacters (&, |, ^, ...) before
+ * `start` runs, which would make attacker-controlled URLs injectable.
+ */
+export declare function openBrowser(target: string): void;
+//# sourceMappingURL=open-browser.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/paths.d.ts

@@ -0,0 +1,31 @@
+export interface PathInputOptions {
+    /** Trim leading/trailing whitespace before normalization. */
+    trim?: boolean;
+    /** Expand leading `~` to a home directory. Defaults to true. */
+    expandTilde?: boolean;
+    /** Home directory used for `~` expansion. Defaults to `os.homedir()`. */
+    homeDir?: string;
+    /** Strip a leading `@`, used for CLI @file paths. */
+    stripAtPrefix?: boolean;
+    /** Normalize unicode space variants to regular spaces. */
+    normalizeUnicodeSpaces?: boolean;
+}
+/**
+ * Resolve a path to its canonical (real) form, following symlinks.
+ * Falls back to the raw path if resolution fails (e.g. the target does
+ * not exist yet), so that callers never crash on missing filesystem
+ * entries.
+ */
+export declare function canonicalizePath(path: string): string;
+/**
+ * Returns true if the value is NOT a package source (npm:, git:, etc.)
+ * or a remote URL protocol. Bare names, relative paths, and file: URLs
+ * are considered local.
+ */
+export declare function isLocalPath(value: string): boolean;
+export declare function normalizePath(input: string, options?: PathInputOptions): string;
+export declare function resolvePath(input: string, baseDir?: string, options?: PathInputOptions): string;
+export declare function getCwdRelativePath(filePath: string, cwd: string): string | undefined;
+export declare function formatPathRelativeToCwdOrAbsolute(filePath: string, cwd: string): string;
+export declare function markPathIgnoredByCloudSync(path: string): void;
+//# sourceMappingURL=paths.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/photon.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Photon image processing wrapper.
+ *
+ * This module provides a unified interface to @silvia-odwyer/photon-node that works in:
+ * 1. Node.js (development, npm run build)
+ * 2. Bun compiled binaries (standalone distribution)
+ *
+ * The challenge: photon-node's CJS entry uses fs.readFileSync(__dirname + '/photon_rs_bg.wasm')
+ * which bakes the build machine's absolute path into Bun compiled binaries.
+ *
+ * Solution:
+ * 1. Patch fs.readFileSync to redirect missing photon_rs_bg.wasm reads
+ * 2. Copy photon_rs_bg.wasm next to the executable in build:binary
+ */
+export type { PhotonImage as PhotonImageType } from "@silvia-odwyer/photon-node";
+/**
+ * Load the photon module asynchronously.
+ * Returns cached module on subsequent calls.
+ */
+export declare function loadPhoton(): Promise<typeof import("@silvia-odwyer/photon-node") | null>;
+//# sourceMappingURL=photon.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/pi-user-agent.d.ts

@@ -0,0 +1,2 @@
+export declare function getPiUserAgent(version: string): string;
+//# sourceMappingURL=pi-user-agent.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/shell.d.ts

@@ -0,0 +1,31 @@
+export interface ShellConfig {
+    shell: string;
+    args: string[];
+    commandTransport?: "argv" | "stdin";
+}
+/**
+ * Resolve shell configuration based on platform and an optional explicit shell path.
+ * Resolution order:
+ * 1. User-specified shellPath
+ * 2. On Windows: Git Bash in known locations, then bash on PATH
+ * 3. On Unix: /bin/bash, then bash on PATH, then fallback to sh
+ */
+export declare function getShellConfig(customShellPath?: string): ShellConfig;
+export declare function getShellEnv(): NodeJS.ProcessEnv;
+/**
+ * Sanitize binary output for display/storage.
+ * Removes characters that crash string-width or cause display issues:
+ * - Control characters (except tab, newline, carriage return)
+ * - Lone surrogates
+ * - Unicode Format characters (crash string-width due to a bug)
+ * - Characters with undefined code points
+ */
+export declare function sanitizeBinaryOutput(str: string): string;
+export declare function trackDetachedChildPid(pid: number): void;
+export declare function untrackDetachedChildPid(pid: number): void;
+export declare function killTrackedDetachedChildren(): void;
+/**
+ * Kill a process and all its children (cross-platform)
+ */
+export declare function killProcessTree(pid: number): void;
+//# sourceMappingURL=shell.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/sleep.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Sleep helper that respects abort signal.
+ */
+export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
+//# sourceMappingURL=sleep.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/syntax-highlight.d.ts

@@ -0,0 +1,12 @@
+export type HighlightFormatter = (text: string) => string;
+export type HighlightTheme = Partial<Record<string, HighlightFormatter>>;
+export interface HighlightOptions {
+    language?: string;
+    ignoreIllegals?: boolean;
+    languageSubset?: string[];
+    theme?: HighlightTheme;
+}
+export declare function renderHighlightedHtml(html: string, theme?: HighlightTheme): string;
+export declare function highlight(code: string, options?: HighlightOptions): string;
+export declare function supportsLanguage(name: string): boolean;
+//# sourceMappingURL=syntax-highlight.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/tools-manager.d.ts

@@ -0,0 +1,3 @@
+export declare function getToolPath(tool: "fd" | "rg"): string | null;
+export declare function ensureTool(tool: "fd" | "rg", silent?: boolean): Promise<string | undefined>;
+//# sourceMappingURL=tools-manager.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/version-check.d.ts

@@ -0,0 +1,15 @@
+export interface LatestPiRelease {
+    version: string;
+    packageName?: string;
+    note?: string;
+}
+export declare function comparePackageVersions(leftVersion: string, rightVersion: string): number | undefined;
+export declare function isNewerPackageVersion(candidateVersion: string, currentVersion: string): boolean;
+export declare function getLatestPiRelease(currentVersion: string, options?: {
+    timeoutMs?: number;
+}): Promise<LatestPiRelease | undefined>;
+export declare function getLatestPiVersion(currentVersion: string, options?: {
+    timeoutMs?: number;
+}): Promise<string | undefined>;
+export declare function checkForNewPiVersion(currentVersion: string): Promise<LatestPiRelease | undefined>;
+//# sourceMappingURL=version-check.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/windows-self-update.d.ts

@@ -0,0 +1,3 @@
+export declare function cleanupWindowsSelfUpdateQuarantine(packageDir: string): void;
+export declare function quarantineWindowsNativeDependencies(packageDir: string): void;
+//# sourceMappingURL=windows-self-update.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/index.mjs

@@ -0,0 +1,84 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { randomUUID } from "node:crypto";
+
+export const __piSubagentsTestShim = true;
+
+export function getMarkdownTheme() { return {}; }
+export function keyText(keybinding) { return keybinding === "app.tools.expand" ? "configured-expand-key" : ""; }
+export function initTheme() {}
+export function getLanguageFromPath(filePath) { return path.extname(String(filePath)).slice(1) || undefined; }
+export function highlightCode(source) { return String(source).split("\n"); }
+export function convertToLlm(value) { return value; }
+export function createReadOnlyTools() {
+	return ["read", "grep", "find", "ls"].map((name) => ({ name }));
+}
+export function rawKeyHint(keys, label) { return `${keys} ${label}`; }
+export function keyHint(_binding, label) { return label; }
+
+export class DynamicBorder {
+	constructor(style = (value) => value) { this.style = style; }
+	render(width = 1) { return [this.style("─".repeat(Math.max(1, width)))]; }
+	invalidate() {}
+}
+
+function writeSession(filePath, header, entries) {
+	fs.mkdirSync(path.dirname(filePath), { recursive: true });
+	fs.writeFileSync(filePath, `${[header, ...entries].map((entry) => JSON.stringify(entry)).join("\n")}\n`, "utf-8");
+}
+
+function readSession(filePath) {
+	const lines = fs.readFileSync(filePath, "utf-8").trim().split("\n").filter(Boolean).map((line) => JSON.parse(line));
+	const [header, ...entries] = lines;
+	return { header, entries };
+}
+
+export class SessionManager {
+	constructor(cwd, sessionDir, filePath, header, entries = []) {
+		this.cwd = cwd;
+		this.sessionDir = sessionDir;
+		this.filePath = filePath;
+		this.header = header;
+		this.entries = entries;
+	}
+
+	static create(cwd, sessionDir = path.join(cwd, ".pi", "sessions")) {
+		const id = randomUUID();
+		return new SessionManager(cwd, sessionDir, path.join(sessionDir, `${id}.jsonl`), { type: "session", version: 1, id, timestamp: new Date().toISOString(), cwd });
+	}
+
+	static open(filePath, sessionDir = path.dirname(filePath)) {
+		const { header, entries } = readSession(filePath);
+		return new SessionManager(header.cwd ?? process.cwd(), sessionDir, filePath, header, entries);
+	}
+
+	appendMessage(message) {
+		const previous = this.entries.at(-1);
+		const id = randomUUID().slice(0, 8);
+		this.entries.push({ type: "message", id, parentId: previous?.id ?? null, timestamp: new Date().toISOString(), message });
+		if (message?.role === "assistant" || fs.existsSync(this.filePath)) writeSession(this.filePath, this.header, this.entries);
+	}
+
+	getSessionFile() { return this.filePath; }
+	getLeafId() { return this.entries.at(-1)?.id ?? null; }
+	getSessionDir() { return this.sessionDir; }
+	getHeader() { return this.header; }
+	getEntries() { return this.entries; }
+
+	createBranchedSession(leafId) {
+		const id = randomUUID();
+		const branchFile = path.join(this.sessionDir, `${id}.jsonl`);
+		const leafIndex = this.entries.findIndex((entry) => entry.id === leafId);
+		const entries = leafIndex >= 0 ? this.entries.slice(0, leafIndex + 1) : [...this.entries];
+		writeSession(branchFile, { ...this.header, id, parentSession: this.filePath }, entries);
+		return branchFile;
+	}
+}
+
+export class DefaultResourceLoader {}
+export class ModelRuntime {}
+export class SettingsManager {}
+
+export function createAgentSession() {
+	throw new Error("Real Pi session tests require the real @selesai/code package.");
+}

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@selesai/code",
+  "version": "0.0.0-pi-subagents-test-shim",
+  "type": "module",
+  "main": "./index.mjs",
+  "types": "./dist/index.d.ts",
+  "private": true,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./index.mjs"
+    }
+  }
+}

package/dist/extensions/pi-subagents/test/integration/acceptance-file-report.test.ts

@@ -158,7 +158,7 @@ describe("acceptance file reports", { skip: !runSync ? "pi packages not availabl
 			const outputPath = path.join(tempDir, "report.md");
 			conflictingReportsCall(outputPath, "satisfied", "not-satisfied");
 
-			const result = await runSync!(tempDir, makeAgentConfigs(["builder"]), "builder", "Write the findings report.", {
+			const result = await runSync!(tempDir, makeAgentConfigs(["worker"]), "worker", "Write the findings report.", {
 				runId: "acceptance-file-only",
 				outputPath,
 				outputMode: "file-only",
@@ -179,7 +179,7 @@ describe("acceptance file reports", { skip: !runSync ? "pi packages not availabl
 				writeFiles: [{ path: outputPath, content: fileReport }],
 			});
 
-			const result = await runSync!(tempDir, makeAgentConfigs(["builder"]), "builder", "Write the findings report.", {
+			const result = await runSync!(tempDir, makeAgentConfigs(["worker"]), "worker", "Write the findings report.", {
 				runId: "acceptance-foreground-saved-receipt",
 				outputPath,
 				outputMode: "file-only",
@@ -203,7 +203,7 @@ describe("acceptance file reports", { skip: !runSync ? "pi packages not availabl
 			const artifactsDir = path.join(tempDir, "report-only-artifacts");
 			mockPi.onCall({ output: acceptanceReport("satisfied", "report-only evidence") });
 
-			const result = await runSync!(tempDir, [makeAgent("builder", { completionGuard: false })], "builder", "Implement and report the fix.", {
+			const result = await runSync!(tempDir, [makeAgent("worker", { completionGuard: false })], "worker", "Implement and report the fix.", {
 				runId: "acceptance-report-only",
 				acceptance: { level: "checked", criteria: ["Report the findings"] },
 				artifactsDir,
@@ -225,7 +225,7 @@ describe("acceptance file reports", { skip: !runSync ? "pi packages not availabl
 			const artifactsDir = path.join(tempDir, "rejected-artifacts");
 			conflictingReportsCall(outputPath, "satisfied", "not-satisfied");
 
-			const result = await runSync!(tempDir, makeAgentConfigs(["builder"]), "builder", "Write the findings report.", {
+			const result = await runSync!(tempDir, makeAgentConfigs(["worker"]), "worker", "Write the findings report.", {
 				runId: "acceptance-inline-text-first",
 				outputPath,
 				acceptance: { level: "checked", criteria: ["Report the findings"] },
@@ -248,7 +248,7 @@ describe("acceptance file reports", { skip: !runSync ? "pi packages not availabl
 			const outputPath = path.join(tempDir, "report.md");
 			conflictingReportsCall(outputPath, "not-satisfied", "satisfied");
 
-			const result = await runSync!(tempDir, makeAgentConfigs(["builder"]), "builder", "Write the findings report.", {
+			const result = await runSync!(tempDir, makeAgentConfigs(["worker"]), "worker", "Write the findings report.", {
 				runId: "acceptance-inline-file-fallback-only",
 				outputPath,
 				acceptance: { level: "checked", criteria: ["Report the findings"] },
@@ -281,7 +281,7 @@ describe("acceptance file reports", { skip: !runSync ? "pi packages not availabl
 				],
 			});
 
-			const result = await runSync!(tempDir, makeAgentConfigs(["builder"]), "builder", "Write the findings report.", {
+			const result = await runSync!(tempDir, makeAgentConfigs(["worker"]), "worker", "Write the findings report.", {
 				runId: "acceptance-failed-write",
 				outputPath,
 				outputMode: "file-only",
@@ -304,7 +304,7 @@ describe("acceptance file reports", { skip: !runSync ? "pi packages not availabl
 				writeFiles: [{ path: outputPath, content: malformedReport }],
 			});
 
-			const result = await runSync!(tempDir, makeAgentConfigs(["builder"]), "builder", "Write the findings report.", {
+			const result = await runSync!(tempDir, makeAgentConfigs(["worker"]), "worker", "Write the findings report.", {
 				runId: "acceptance-malformed-file-report",
 				outputPath,
 				outputMode: "file-only",
@@ -320,9 +320,9 @@ describe("acceptance file reports", { skip: !runSync ? "pi packages not availabl
 	describe("background runner", { skip: isAsyncAvailable && !isAsyncAvailable() ? "jiti not available" : undefined }, () => {
 		function runAsyncSingle(id: string, outputPath: string, outputMode: "inline" | "file-only", artifactConfig = DISABLED_ARTIFACTS) {
 			executeAsyncSingle!(id, {
-				agent: "builder",
+				agent: "worker",
 				task: "Write the findings report.",
-				agentConfig: makeAgent("builder", { completionGuard: false }),
+				agentConfig: makeAgent("worker", { completionGuard: false }),
 				ctx: { pi: { events: { emit() {} } }, cwd: tempDir, currentSessionId: "session-file-report" },
 				artifactConfig,
 				artifactsDir: path.join(tempDir, ".pi-subagents", "artifacts"),
@@ -350,7 +350,7 @@ describe("acceptance file reports", { skip: !runSync ? "pi packages not availabl
 
 		it("file-only mode persists async acceptance metadata when final assistant text is only a receipt", async () => {
 			const outputPath = path.join(tempDir, "saved-review.md");
-			const fileReport = `# Review\n${acceptanceReport("satisfied", "saved commentator verdict")}`;
+			const fileReport = `# Review\n${acceptanceReport("satisfied", "saved reviewer verdict")}`;
 			mockPi.onCall({
 				jsonl: [...events.completedWrite(outputPath, fileReport), events.assistantMessage("Output saved to the configured file.")],
 				writeFiles: [{ path: outputPath, content: fileReport }],
@@ -361,12 +361,12 @@ describe("acceptance file reports", { skip: !runSync ? "pi packages not availabl
 			const payload = await waitForAsyncResult(id);
 			assert.equal(payload.success, true);
 			assert.equal(payload.results[0]?.acceptance?.status, "checked");
-			assert.equal(payload.results[0]?.acceptance?.childReport?.criteriaSatisfied?.[0]?.evidence, "saved commentator verdict");
+			assert.equal(payload.results[0]?.acceptance?.childReport?.criteriaSatisfied?.[0]?.evidence, "saved reviewer verdict");
 			const metadataPath = payload.results[0]?.artifactPaths?.metadataPath;
 			assert.ok(metadataPath);
 			const metadata = JSON.parse(fs.readFileSync(metadataPath, "utf-8")) as { acceptance?: AcceptanceSummary };
 			assert.equal(metadata.acceptance?.status, "checked");
-			assert.equal(metadata.acceptance?.childReport?.criteriaSatisfied?.[0]?.evidence, "saved commentator verdict");
+			assert.equal(metadata.acceptance?.childReport?.criteriaSatisfied?.[0]?.evidence, "saved reviewer verdict");
 		});
 
 		it("inline mode accepts from the text report and strips fences from the resolved file output", async () => {
@@ -405,7 +405,7 @@ describe("acceptance file reports", { skip: !runSync ? "pi packages not availabl
 				tempArtifactsDir: tempDir,
 				getSubagentSessionRoot: () => tempDir,
 				expandTilde: (p: string) => p,
-				discoverAgents: () => ({ agents: [makeAgent("builder", { completionGuard: false })] }),
+				discoverAgents: () => ({ agents: [makeAgent("worker", { completionGuard: false })] }),
 			});
 
 			const acceptance = { level: "checked", criteria: ["Report the findings"] };
@@ -413,8 +413,8 @@ describe("acceptance file reports", { skip: !runSync ? "pi packages not availabl
 				"acceptance-parallel-files",
 				{
 					tasks: [
-						{ agent: "builder", task: "Alpha task: write the report.", output: alphaPath, outputMode: "file-only", acceptance },
-						{ agent: "builder", task: "Beta task: write the report.", output: betaPath, outputMode: "file-only", acceptance },
+						{ agent: "worker", task: "Alpha task: write the report.", output: alphaPath, outputMode: "file-only", acceptance },
+						{ agent: "worker", task: "Beta task: write the report.", output: betaPath, outputMode: "file-only", acceptance },
 					],
 					async: true,
 					clarify: false,