@averyyy/pi-coding-agent 0.82.1-piclient.6 → 0.82.1-piclient.7

package/dist/cli/tool-effects.js

@@ -1,164 +0,0 @@
-import { readFileSync } from "node:fs";
-import chalk from "chalk";
-import { APP_NAME } from "../config.js";
-import { assertValidSessionId, SessionManager } from "../core/session-manager.js";
-import { acceptToolEffectResult, inspectToolEffect, markToolEffectFailed, } from "../core/tool-effect-journal.js";
-import { normalizePath, resolvePath } from "../utils/paths.js";
-function printToolEffectsHelp() {
-    console.log(`${chalk.bold(`${APP_NAME} tool-effects`)} - explicitly resolve an interrupted tool effect
-
-${chalk.bold("Usage:")}
-  ${APP_NAME} tool-effects inspect --session <path|exact-id> --effect-id <sha256>
-  ${APP_NAME} tool-effects mark-failed --session <path|exact-id> --effect-id <sha256>
-  ${APP_NAME} tool-effects accept-result --session <path|exact-id> --effect-id <sha256> <json-file>
-
-${chalk.bold("Options:")}
-  --session <path|exact-id>  Exact session path or complete session ID
-  --effect-id <sha256>      Exact effect ID reported by the recovery error
-  --session-dir <dir>       Override the session lookup directory
-  --help, -h                Show this help
-
-mark-failed records an error result without re-executing the tool. External side effects may already have occurred.
-accept-result requires a complete ToolResultMessage JSON object whose toolCallId and toolName match the effect.
-Neither command displays stored tool arguments or accepted result content.`);
-}
-function requireOptionValue(args, index, option) {
-    const value = args[index + 1];
-    if (value === undefined || value.startsWith("-")) {
-        throw new Error(`${option} requires a value`);
-    }
-    return value;
-}
-function setOnce(current, value, option) {
-    if (current !== undefined) {
-        throw new Error(`${option} may only be specified once`);
-    }
-    return value;
-}
-function parseToolEffectsCommand(args) {
-    if (args.includes("--help") || args.includes("-h"))
-        return "help";
-    const action = args[1];
-    if (action !== "inspect" && action !== "mark-failed" && action !== "accept-result") {
-        throw new Error("tool-effects requires one action: inspect, mark-failed, or accept-result");
-    }
-    let session;
-    let effectId;
-    let sessionDir;
-    const positional = [];
-    for (let index = 2; index < args.length; index++) {
-        const argument = args[index];
-        if (argument === "--session") {
-            session = setOnce(session, requireOptionValue(args, index, argument), argument);
-            index++;
-            continue;
-        }
-        if (argument === "--effect-id") {
-            effectId = setOnce(effectId, requireOptionValue(args, index, argument), argument);
-            index++;
-            continue;
-        }
-        if (argument === "--session-dir") {
-            sessionDir = setOnce(sessionDir, requireOptionValue(args, index, argument), argument);
-            index++;
-            continue;
-        }
-        if (argument.startsWith("-")) {
-            throw new Error(`Unknown tool-effects option: ${argument}`);
-        }
-        positional.push(argument);
-    }
-    if (!session)
-        throw new Error("tool-effects requires --session <path|exact-id>");
-    if (!effectId)
-        throw new Error("tool-effects requires --effect-id <sha256>");
-    if (action === "accept-result") {
-        if (positional.length !== 1) {
-            throw new Error("tool-effects accept-result requires exactly one JSON file");
-        }
-    }
-    else if (positional.length > 0) {
-        throw new Error(`tool-effects ${action} does not accept positional arguments`);
-    }
-    return {
-        action,
-        session,
-        effectId,
-        sessionDir,
-        resultFile: positional[0],
-    };
-}
-async function openExactSession(sessionArgument, cwd, sessionDir) {
-    if (sessionArgument.includes("/") || sessionArgument.includes("\\") || sessionArgument.endsWith(".jsonl")) {
-        return SessionManager.open(resolvePath(sessionArgument, cwd), sessionDir);
-    }
-    assertValidSessionId(sessionArgument);
-    const matches = [
-        ...(await SessionManager.list(cwd, sessionDir)),
-        ...(await SessionManager.listAll(sessionDir)),
-    ].filter((session) => session.id === sessionArgument);
-    const uniquePaths = [...new Set(matches.map((session) => normalizePath(session.path)))];
-    if (uniquePaths.length === 0) {
-        throw new Error(`No session found with exact id '${sessionArgument}'`);
-    }
-    if (uniquePaths.length > 1) {
-        throw new Error(`Multiple sessions have exact id '${sessionArgument}'; use an exact session path`);
-    }
-    return SessionManager.open(uniquePaths[0], sessionDir);
-}
-function printTarget(target) {
-    console.log(`sessionPath: ${target.sessionPath}`);
-    console.log(`sessionId: ${target.sessionId}`);
-    console.log(`journalPath: ${target.journalPath}`);
-    console.log(`effectId: ${target.effectId}`);
-    console.log(`toolCallId: ${target.toolCallId}`);
-    console.log(`toolName: ${target.toolName}`);
-    console.log(`phase: ${target.phase}`);
-}
-function printResolution(result) {
-    printTarget(result.target);
-    console.log(`sessionEntryId: ${result.sessionEntryId}`);
-    console.log(`resolution: ${result.alreadyResolved ? "already-recorded" : "recorded"}`);
-}
-export async function handleToolEffectsCommand(args, options) {
-    if (args[0] !== "tool-effects")
-        return false;
-    try {
-        const command = parseToolEffectsCommand(args);
-        if (command === "help") {
-            printToolEffectsHelp();
-            return true;
-        }
-        const sessionDir = command.sessionDir ? resolvePath(command.sessionDir, options.cwd) : options.defaultSessionDir;
-        const session = await openExactSession(command.session, options.cwd, sessionDir);
-        if (command.action === "inspect") {
-            printTarget(inspectToolEffect(session, command.effectId));
-            return true;
-        }
-        if (command.action === "mark-failed") {
-            printResolution(markToolEffectFailed(session, command.effectId));
-            console.log("The tool was not re-executed; external side effects may already have occurred.");
-            return true;
-        }
-        if (!command.resultFile) {
-            throw new Error("tool-effects accept-result requires a JSON file");
-        }
-        const resultPath = resolvePath(command.resultFile, options.cwd);
-        let result;
-        try {
-            result = JSON.parse(readFileSync(resultPath, "utf8"));
-        }
-        catch (error) {
-            throw new Error(`Could not read accepted result JSON from ${resultPath}`, { cause: error });
-        }
-        printResolution(acceptToolEffectResult(session, command.effectId, result));
-        return true;
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.error(chalk.red(`Error: ${message}`));
-        process.exitCode = 1;
-        return true;
-    }
-}
-//# sourceMappingURL=tool-effects.js.map

package/dist/cli/tool-effects.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool-effects.js","sourceRoot":"","sources":["../../src/cli/tool-effects.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFileSync } from \"node:fs\";\nimport chalk from \"chalk\";\nimport { APP_NAME } from \"../config.ts\";\nimport { assertValidSessionId, SessionManager } from \"../core/session-manager.ts\";\nimport {\n\tacceptToolEffectResult,\n\tinspectToolEffect,\n\tmarkToolEffectFailed,\n\ttype ToolEffectResolutionResult,\n\ttype ToolEffectResolutionTarget,\n} from \"../core/tool-effect-journal.ts\";\nimport { normalizePath, resolvePath } from \"../utils/paths.ts\";\n\ntype ToolEffectsAction = \"inspect\" | \"mark-failed\" | \"accept-result\";\n\ninterface ToolEffectsCommand {\n\taction: ToolEffectsAction;\n\tsession: string;\n\teffectId: string;\n\tsessionDir?: string;\n\tresultFile?: string;\n}\n\nexport interface ToolEffectsCommandOptions {\n\tcwd: string;\n\tdefaultSessionDir?: string;\n}\n\nfunction printToolEffectsHelp(): void {\n\tconsole.log(`${chalk.bold(`${APP_NAME} tool-effects`)} - explicitly resolve an interrupted tool effect\n\n${chalk.bold(\"Usage:\")}\n  ${APP_NAME} tool-effects inspect --session <path|exact-id> --effect-id <sha256>\n  ${APP_NAME} tool-effects mark-failed --session <path|exact-id> --effect-id <sha256>\n  ${APP_NAME} tool-effects accept-result --session <path|exact-id> --effect-id <sha256> <json-file>\n\n${chalk.bold(\"Options:\")}\n  --session <path|exact-id>  Exact session path or complete session ID\n  --effect-id <sha256>      Exact effect ID reported by the recovery error\n  --session-dir <dir>       Override the session lookup directory\n  --help, -h                Show this help\n\nmark-failed records an error result without re-executing the tool. External side effects may already have occurred.\naccept-result requires a complete ToolResultMessage JSON object whose toolCallId and toolName match the effect.\nNeither command displays stored tool arguments or accepted result content.`);\n}\n\nfunction requireOptionValue(args: string[], index: number, option: string): string {\n\tconst value = args[index + 1];\n\tif (value === undefined || value.startsWith(\"-\")) {\n\t\tthrow new Error(`${option} requires a value`);\n\t}\n\treturn value;\n}\n\nfunction setOnce(current: string | undefined, value: string, option: string): string {\n\tif (current !== undefined) {\n\t\tthrow new Error(`${option} may only be specified once`);\n\t}\n\treturn value;\n}\n\nfunction parseToolEffectsCommand(args: string[]): ToolEffectsCommand | \"help\" {\n\tif (args.includes(\"--help\") || args.includes(\"-h\")) return \"help\";\n\tconst action = args[1];\n\tif (action !== \"inspect\" && action !== \"mark-failed\" && action !== \"accept-result\") {\n\t\tthrow new Error(\"tool-effects requires one action: inspect, mark-failed, or accept-result\");\n\t}\n\n\tlet session: string | undefined;\n\tlet effectId: string | undefined;\n\tlet sessionDir: string | undefined;\n\tconst positional: string[] = [];\n\tfor (let index = 2; index < args.length; index++) {\n\t\tconst argument = args[index];\n\t\tif (argument === \"--session\") {\n\t\t\tsession = setOnce(session, requireOptionValue(args, index, argument), argument);\n\t\t\tindex++;\n\t\t\tcontinue;\n\t\t}\n\t\tif (argument === \"--effect-id\") {\n\t\t\teffectId = setOnce(effectId, requireOptionValue(args, index, argument), argument);\n\t\t\tindex++;\n\t\t\tcontinue;\n\t\t}\n\t\tif (argument === \"--session-dir\") {\n\t\t\tsessionDir = setOnce(sessionDir, requireOptionValue(args, index, argument), argument);\n\t\t\tindex++;\n\t\t\tcontinue;\n\t\t}\n\t\tif (argument.startsWith(\"-\")) {\n\t\t\tthrow new Error(`Unknown tool-effects option: ${argument}`);\n\t\t}\n\t\tpositional.push(argument);\n\t}\n\n\tif (!session) throw new Error(\"tool-effects requires --session <path|exact-id>\");\n\tif (!effectId) throw new Error(\"tool-effects requires --effect-id <sha256>\");\n\tif (action === \"accept-result\") {\n\t\tif (positional.length !== 1) {\n\t\t\tthrow new Error(\"tool-effects accept-result requires exactly one JSON file\");\n\t\t}\n\t} else if (positional.length > 0) {\n\t\tthrow new Error(`tool-effects ${action} does not accept positional arguments`);\n\t}\n\treturn {\n\t\taction,\n\t\tsession,\n\t\teffectId,\n\t\tsessionDir,\n\t\tresultFile: positional[0],\n\t};\n}\n\nasync function openExactSession(\n\tsessionArgument: string,\n\tcwd: string,\n\tsessionDir: string | undefined,\n): Promise<SessionManager> {\n\tif (sessionArgument.includes(\"/\") || sessionArgument.includes(\"\\\\\") || sessionArgument.endsWith(\".jsonl\")) {\n\t\treturn SessionManager.open(resolvePath(sessionArgument, cwd), sessionDir);\n\t}\n\n\tassertValidSessionId(sessionArgument);\n\tconst matches = [\n\t\t...(await SessionManager.list(cwd, sessionDir)),\n\t\t...(await SessionManager.listAll(sessionDir)),\n\t].filter((session) => session.id === sessionArgument);\n\tconst uniquePaths = [...new Set(matches.map((session) => normalizePath(session.path)))];\n\tif (uniquePaths.length === 0) {\n\t\tthrow new Error(`No session found with exact id '${sessionArgument}'`);\n\t}\n\tif (uniquePaths.length > 1) {\n\t\tthrow new Error(`Multiple sessions have exact id '${sessionArgument}'; use an exact session path`);\n\t}\n\treturn SessionManager.open(uniquePaths[0], sessionDir);\n}\n\nfunction printTarget(target: ToolEffectResolutionTarget): void {\n\tconsole.log(`sessionPath: ${target.sessionPath}`);\n\tconsole.log(`sessionId: ${target.sessionId}`);\n\tconsole.log(`journalPath: ${target.journalPath}`);\n\tconsole.log(`effectId: ${target.effectId}`);\n\tconsole.log(`toolCallId: ${target.toolCallId}`);\n\tconsole.log(`toolName: ${target.toolName}`);\n\tconsole.log(`phase: ${target.phase}`);\n}\n\nfunction printResolution(result: ToolEffectResolutionResult): void {\n\tprintTarget(result.target);\n\tconsole.log(`sessionEntryId: ${result.sessionEntryId}`);\n\tconsole.log(`resolution: ${result.alreadyResolved ? \"already-recorded\" : \"recorded\"}`);\n}\n\nexport async function handleToolEffectsCommand(args: string[], options: ToolEffectsCommandOptions): Promise<boolean> {\n\tif (args[0] !== \"tool-effects\") return false;\n\ttry {\n\t\tconst command = parseToolEffectsCommand(args);\n\t\tif (command === \"help\") {\n\t\t\tprintToolEffectsHelp();\n\t\t\treturn true;\n\t\t}\n\t\tconst sessionDir = command.sessionDir ? resolvePath(command.sessionDir, options.cwd) : options.defaultSessionDir;\n\t\tconst session = await openExactSession(command.session, options.cwd, sessionDir);\n\t\tif (command.action === \"inspect\") {\n\t\t\tprintTarget(inspectToolEffect(session, command.effectId));\n\t\t\treturn true;\n\t\t}\n\t\tif (command.action === \"mark-failed\") {\n\t\t\tprintResolution(markToolEffectFailed(session, command.effectId));\n\t\t\tconsole.log(\"The tool was not re-executed; external side effects may already have occurred.\");\n\t\t\treturn true;\n\t\t}\n\t\tif (!command.resultFile) {\n\t\t\tthrow new Error(\"tool-effects accept-result requires a JSON file\");\n\t\t}\n\t\tconst resultPath = resolvePath(command.resultFile, options.cwd);\n\t\tlet result: unknown;\n\t\ttry {\n\t\t\tresult = JSON.parse(readFileSync(resultPath, \"utf8\")) as unknown;\n\t\t} catch (error) {\n\t\t\tthrow new Error(`Could not read accepted result JSON from ${resultPath}`, { cause: error });\n\t\t}\n\t\tprintResolution(acceptToolEffectResult(session, command.effectId, result));\n\t\treturn true;\n\t} catch (error: unknown) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tconsole.error(chalk.red(`Error: ${message}`));\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n}\n"]}

package/dist/core/pi-server-compact-state.d.ts

@@ -1,81 +0,0 @@
-declare const COMPACT_STATE_VERSION = 1;
-interface PiServerCompactStateBase {
-    version: typeof COMPACT_STATE_VERSION;
-    sequence: number;
-    timestamp: number;
-}
-export interface PiServerPendingCompactState extends PiServerCompactStateBase {
-    kind: "compact";
-    serverHash: string;
-    sessionId: string;
-    operationId: string;
-    requestHash: string;
-    baseStaticContextHash: string;
-    baseTreeHash: string;
-    baseEntryCount: number;
-    baseLeafId: string | null;
-    baseRevision: number;
-    observation?: PiServerCompactObservationState;
-}
-export interface PiServerAppliedCompactState extends PiServerCompactStateBase {
-    kind: "applied";
-    operationId: string;
-    requestHash: string;
-    entryId: string;
-    entryHash: string;
-    updatedTreeHash: string;
-    updatedLeafId: string;
-    updatedRevision: number;
-    resolution: "tree_applied";
-}
-export interface PiServerTerminalCompactState extends PiServerCompactStateBase {
-    kind: "terminal";
-    operationId: string;
-    requestHash: string;
-    httpStatus: number;
-    error: string;
-    operationDisposition: "terminal" | "not_started";
-    status: "failed" | "rejected";
-    resolution: "terminal_failed_observed" | "server_rejected";
-}
-export type PiServerCompactObservationState = PiServerAppliedCompactState | PiServerTerminalCompactState;
-export type PiServerCompactAcknowledgementResolution = "server_ack" | "server_missing_after_tree_applied" | "server_missing_after_terminal_failure" | "server_rejected_not_started" | "server_authoritative_missing";
-export interface WritePiServerPendingCompactInput {
-    serverHash: string;
-    sessionId: string;
-    operationId: string;
-    requestHash: string;
-    baseStaticContextHash: string;
-    baseTreeHash: string;
-    baseEntryCount: number;
-    baseLeafId: string | null;
-    baseRevision: number;
-    timestamp?: number;
-}
-export interface WritePiServerAppliedCompactInput {
-    operationId: string;
-    requestHash: string;
-    entryId: string;
-    entryHash: string;
-    updatedTreeHash: string;
-    updatedLeafId: string;
-    updatedRevision: number;
-    timestamp?: number;
-}
-export interface WritePiServerTerminalCompactInput {
-    operationId: string;
-    requestHash: string;
-    httpStatus: number;
-    error: string;
-    operationDisposition: "terminal" | "not_started";
-    status: "failed" | "rejected";
-    timestamp?: number;
-}
-export declare function getPiServerCompactStatePath(sessionFile: string): string;
-export declare function readPiServerPendingCompact(path: string): PiServerPendingCompactState | undefined;
-export declare function writePiServerPendingCompact(path: string, input: WritePiServerPendingCompactInput): PiServerPendingCompactState;
-export declare function writePiServerAppliedCompact(path: string, input: WritePiServerAppliedCompactInput): PiServerAppliedCompactState;
-export declare function writePiServerTerminalCompact(path: string, input: WritePiServerTerminalCompactInput): PiServerTerminalCompactState;
-export declare function acknowledgePiServerPendingCompact(path: string, operationId: string, resolution?: PiServerCompactAcknowledgementResolution, timestamp?: number): void;
-export {};
-//# sourceMappingURL=pi-server-compact-state.d.ts.map

package/dist/core/pi-server-compact-state.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pi-server-compact-state.d.ts","sourceRoot":"","sources":["../../src/core/pi-server-compact-state.ts"],"names":[],"mappings":"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","sourcesContent":["import { Buffer } from \"node:buffer\";\nimport { createHash } from \"node:crypto\";\nimport { closeSync, existsSync, fsyncSync, openSync, readFileSync, truncateSync, writeSync } from \"node:fs\";\nimport { dirname, resolve } from \"node:path\";\nimport { DatabaseSync } from \"node:sqlite\";\n\nconst COMPACT_STATE_VERSION = 1;\nconst COMPACT_STATE_MAX_BYTES = 8 * 1024 * 1024;\nconst SHA256_PATTERN = /^[a-f0-9]{64}$/u;\nconst IDENTIFIER_MAX_CHARS = 4096;\nconst ERROR_MAX_CHARS = 1024 * 1024;\n\ninterface PiServerCompactStateBase {\n\tversion: typeof COMPACT_STATE_VERSION;\n\tsequence: number;\n\ttimestamp: number;\n}\n\nexport interface PiServerPendingCompactState extends PiServerCompactStateBase {\n\tkind: \"compact\";\n\tserverHash: string;\n\tsessionId: string;\n\toperationId: string;\n\trequestHash: string;\n\tbaseStaticContextHash: string;\n\tbaseTreeHash: string;\n\tbaseEntryCount: number;\n\tbaseLeafId: string | null;\n\tbaseRevision: number;\n\tobservation?: PiServerCompactObservationState;\n}\n\nexport interface PiServerAppliedCompactState extends PiServerCompactStateBase {\n\tkind: \"applied\";\n\toperationId: string;\n\trequestHash: string;\n\tentryId: string;\n\tentryHash: string;\n\tupdatedTreeHash: string;\n\tupdatedLeafId: string;\n\tupdatedRevision: number;\n\tresolution: \"tree_applied\";\n}\n\nexport interface PiServerTerminalCompactState extends PiServerCompactStateBase {\n\tkind: \"terminal\";\n\toperationId: string;\n\trequestHash: string;\n\thttpStatus: number;\n\terror: string;\n\toperationDisposition: \"terminal\" | \"not_started\";\n\tstatus: \"failed\" | \"rejected\";\n\tresolution: \"terminal_failed_observed\" | \"server_rejected\";\n}\n\nexport type PiServerCompactObservationState = PiServerAppliedCompactState | PiServerTerminalCompactState;\n\nexport type PiServerCompactAcknowledgementResolution =\n\t| \"server_ack\"\n\t| \"server_missing_after_tree_applied\"\n\t| \"server_missing_after_terminal_failure\"\n\t| \"server_rejected_not_started\"\n\t| \"server_authoritative_missing\";\n\ninterface PiServerAcknowledgedCompactState extends PiServerCompactStateBase {\n\tkind: \"ack\";\n\toperationId: string;\n\tresolution: PiServerCompactAcknowledgementResolution;\n}\n\ntype PiServerCompactStateRecord =\n\t| PiServerPendingCompactState\n\t| PiServerCompactObservationState\n\t| PiServerAcknowledgedCompactState;\n\ninterface ParsedPiServerCompactState {\n\tnextSequence: number;\n\tpending: PiServerPendingCompactState | undefined;\n}\n\nexport interface WritePiServerPendingCompactInput {\n\tserverHash: string;\n\tsessionId: string;\n\toperationId: string;\n\trequestHash: string;\n\tbaseStaticContextHash: string;\n\tbaseTreeHash: string;\n\tbaseEntryCount: number;\n\tbaseLeafId: string | null;\n\tbaseRevision: number;\n\ttimestamp?: number;\n}\n\nexport interface WritePiServerAppliedCompactInput {\n\toperationId: string;\n\trequestHash: string;\n\tentryId: string;\n\tentryHash: string;\n\tupdatedTreeHash: string;\n\tupdatedLeafId: string;\n\tupdatedRevision: number;\n\ttimestamp?: number;\n}\n\nexport interface WritePiServerTerminalCompactInput {\n\toperationId: string;\n\trequestHash: string;\n\thttpStatus: number;\n\terror: string;\n\toperationDisposition: \"terminal\" | \"not_started\";\n\tstatus: \"failed\" | \"rejected\";\n\ttimestamp?: number;\n}\n\nfunction sha256(value: string): string {\n\treturn createHash(\"sha256\").update(value).digest(\"hex\");\n}\n\nfunction assertObject(value: unknown, path: string): asserts value is Record<string, unknown> {\n\tif (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n\t\tthrow new Error(`${path} must be an object`);\n\t}\n}\n\nfunction assertIdentifier(value: unknown, path: string): asserts value is string {\n\tif (typeof value !== \"string\" || value.length === 0 || value.length > IDENTIFIER_MAX_CHARS || value.includes(\"\\0\")) {\n\t\tthrow new Error(`${path} must be a non-empty string without NUL bytes`);\n\t}\n}\n\nfunction assertHash(value: unknown, path: string, allowEmpty = false): asserts value is string {\n\tif (\n\t\ttypeof value !== \"string\" ||\n\t\t(!allowEmpty && !SHA256_PATTERN.test(value)) ||\n\t\t(allowEmpty && value !== \"\" && !SHA256_PATTERN.test(value))\n\t) {\n\t\tthrow new Error(`${path} must be ${allowEmpty ? \"empty or \" : \"\"}a lowercase SHA-256 digest`);\n\t}\n}\n\nfunction assertError(value: unknown, path: string): asserts value is string {\n\tif (typeof value !== \"string\" || value.length === 0 || value.length > ERROR_MAX_CHARS || value.includes(\"\\0\")) {\n\t\tthrow new Error(`${path} must be a non-empty string without NUL bytes`);\n\t}\n}\n\nfunction assertNonNegativeSafeInteger(value: unknown, path: string): asserts value is number {\n\tif (!Number.isSafeInteger(value) || (value as number) < 0) {\n\t\tthrow new Error(`${path} must be a non-negative safe integer`);\n\t}\n}\n\nfunction parsePayload(payload: string, lineNumber: number): PiServerCompactStateRecord {\n\tlet value: unknown;\n\ttry {\n\t\tvalue = JSON.parse(payload) as unknown;\n\t} catch (error) {\n\t\tthrow new Error(`pi-server compact state payload is invalid JSON at line ${lineNumber}`, { cause: error });\n\t}\n\tassertObject(value, `pi-server compact state line ${lineNumber}`);\n\tif (value.version !== COMPACT_STATE_VERSION) {\n\t\tthrow new Error(`Unsupported pi-server compact state version at line ${lineNumber}`);\n\t}\n\tassertNonNegativeSafeInteger(value.sequence, `pi-server compact state line ${lineNumber}.sequence`);\n\tassertNonNegativeSafeInteger(value.timestamp, `pi-server compact state line ${lineNumber}.timestamp`);\n\tif (value.kind === \"ack\") {\n\t\tassertIdentifier(value.operationId, `pi-server compact state line ${lineNumber}.operationId`);\n\t\tif (\n\t\t\tvalue.resolution !== \"server_ack\" &&\n\t\t\tvalue.resolution !== \"server_missing_after_tree_applied\" &&\n\t\t\tvalue.resolution !== \"server_missing_after_terminal_failure\" &&\n\t\t\tvalue.resolution !== \"server_rejected_not_started\" &&\n\t\t\tvalue.resolution !== \"server_authoritative_missing\"\n\t\t) {\n\t\t\tthrow new Error(`pi-server compact state acknowledgement resolution is invalid at line ${lineNumber}`);\n\t\t}\n\t\treturn {\n\t\t\tversion: COMPACT_STATE_VERSION,\n\t\t\tkind: \"ack\",\n\t\t\tsequence: value.sequence,\n\t\t\ttimestamp: value.timestamp,\n\t\t\toperationId: value.operationId,\n\t\t\tresolution: value.resolution,\n\t\t};\n\t}\n\tif (value.kind === \"applied\") {\n\t\tassertIdentifier(value.operationId, `pi-server compact state line ${lineNumber}.operationId`);\n\t\tassertHash(value.requestHash, `pi-server compact state line ${lineNumber}.requestHash`);\n\t\tassertIdentifier(value.entryId, `pi-server compact state line ${lineNumber}.entryId`);\n\t\tassertHash(value.entryHash, `pi-server compact state line ${lineNumber}.entryHash`);\n\t\tassertHash(value.updatedTreeHash, `pi-server compact state line ${lineNumber}.updatedTreeHash`);\n\t\tassertIdentifier(value.updatedLeafId, `pi-server compact state line ${lineNumber}.updatedLeafId`);\n\t\tassertNonNegativeSafeInteger(value.updatedRevision, `pi-server compact state line ${lineNumber}.updatedRevision`);\n\t\tif (value.resolution !== \"tree_applied\") {\n\t\t\tthrow new Error(`pi-server compact applied resolution is invalid at line ${lineNumber}`);\n\t\t}\n\t\treturn {\n\t\t\tversion: COMPACT_STATE_VERSION,\n\t\t\tkind: \"applied\",\n\t\t\tsequence: value.sequence,\n\t\t\ttimestamp: value.timestamp,\n\t\t\toperationId: value.operationId,\n\t\t\trequestHash: value.requestHash,\n\t\t\tentryId: value.entryId,\n\t\t\tentryHash: value.entryHash,\n\t\t\tupdatedTreeHash: value.updatedTreeHash,\n\t\t\tupdatedLeafId: value.updatedLeafId,\n\t\t\tupdatedRevision: value.updatedRevision,\n\t\t\tresolution: value.resolution,\n\t\t};\n\t}\n\tif (value.kind === \"terminal\") {\n\t\tassertIdentifier(value.operationId, `pi-server compact state line ${lineNumber}.operationId`);\n\t\tassertHash(value.requestHash, `pi-server compact state line ${lineNumber}.requestHash`);\n\t\tif (\n\t\t\t!Number.isSafeInteger(value.httpStatus) ||\n\t\t\t(value.httpStatus as number) < 100 ||\n\t\t\t(value.httpStatus as number) > 599\n\t\t) {\n\t\t\tthrow new Error(`pi-server compact terminal HTTP status is invalid at line ${lineNumber}`);\n\t\t}\n\t\tassertError(value.error, `pi-server compact state line ${lineNumber}.error`);\n\t\tif (\n\t\t\t(value.operationDisposition !== \"terminal\" && value.operationDisposition !== \"not_started\") ||\n\t\t\t(value.status !== \"failed\" && value.status !== \"rejected\") ||\n\t\t\t(value.operationDisposition === \"terminal\" && value.status !== \"failed\") ||\n\t\t\t(value.operationDisposition === \"not_started\" && value.status !== \"rejected\")\n\t\t) {\n\t\t\tthrow new Error(`pi-server compact terminal disposition is invalid at line ${lineNumber}`);\n\t\t}\n\t\tconst expectedResolution =\n\t\t\tvalue.operationDisposition === \"terminal\" ? \"terminal_failed_observed\" : \"server_rejected\";\n\t\tif (value.resolution !== expectedResolution) {\n\t\t\tthrow new Error(`pi-server compact terminal resolution is invalid at line ${lineNumber}`);\n\t\t}\n\t\treturn {\n\t\t\tversion: COMPACT_STATE_VERSION,\n\t\t\tkind: \"terminal\",\n\t\t\tsequence: value.sequence,\n\t\t\ttimestamp: value.timestamp,\n\t\t\toperationId: value.operationId,\n\t\t\trequestHash: value.requestHash,\n\t\t\thttpStatus: value.httpStatus as number,\n\t\t\terror: value.error,\n\t\t\toperationDisposition: value.operationDisposition,\n\t\t\tstatus: value.status,\n\t\t\tresolution: expectedResolution,\n\t\t};\n\t}\n\tif (value.kind !== \"compact\") {\n\t\tthrow new Error(`Unsupported pi-server compact state record kind at line ${lineNumber}`);\n\t}\n\tassertHash(value.serverHash, `pi-server compact state line ${lineNumber}.serverHash`);\n\tassertIdentifier(value.sessionId, `pi-server compact state line ${lineNumber}.sessionId`);\n\tassertIdentifier(value.operationId, `pi-server compact state line ${lineNumber}.operationId`);\n\tassertHash(value.requestHash, `pi-server compact state line ${lineNumber}.requestHash`);\n\tassertHash(value.baseStaticContextHash, `pi-server compact state line ${lineNumber}.baseStaticContextHash`, true);\n\tassertHash(value.baseTreeHash, `pi-server compact state line ${lineNumber}.baseTreeHash`);\n\tassertNonNegativeSafeInteger(value.baseEntryCount, `pi-server compact state line ${lineNumber}.baseEntryCount`);\n\tif (value.baseLeafId !== null) {\n\t\tassertIdentifier(value.baseLeafId, `pi-server compact state line ${lineNumber}.baseLeafId`);\n\t}\n\tassertNonNegativeSafeInteger(value.baseRevision, `pi-server compact state line ${lineNumber}.baseRevision`);\n\treturn {\n\t\tversion: COMPACT_STATE_VERSION,\n\t\tkind: \"compact\",\n\t\tsequence: value.sequence,\n\t\ttimestamp: value.timestamp,\n\t\tserverHash: value.serverHash,\n\t\tsessionId: value.sessionId,\n\t\toperationId: value.operationId,\n\t\trequestHash: value.requestHash,\n\t\tbaseStaticContextHash: value.baseStaticContextHash,\n\t\tbaseTreeHash: value.baseTreeHash,\n\t\tbaseEntryCount: value.baseEntryCount,\n\t\tbaseLeafId: value.baseLeafId,\n\t\tbaseRevision: value.baseRevision,\n\t};\n}\n\nfunction parseCompactStateFile(path: string): ParsedPiServerCompactState {\n\tif (!existsSync(path)) return { nextSequence: 0, pending: undefined };\n\tconst encoded = readFileSync(path);\n\tif (encoded.byteLength > COMPACT_STATE_MAX_BYTES) {\n\t\tthrow new Error(`pi-server compact state exceeds ${COMPACT_STATE_MAX_BYTES} bytes: ${path}`);\n\t}\n\tconst content = encoded.toString(\"utf-8\");\n\tconst lines = content.split(\"\\n\");\n\tif (!content.endsWith(\"\\n\")) lines.pop();\n\tlet expectedSequence = 0;\n\tlet pending: PiServerPendingCompactState | undefined;\n\tfor (const [index, line] of lines.entries()) {\n\t\tif (!line) continue;\n\t\tlet envelope: unknown;\n\t\ttry {\n\t\t\tenvelope = JSON.parse(line) as unknown;\n\t\t} catch (error) {\n\t\t\tthrow new Error(`pi-server compact state envelope is invalid JSON at line ${index + 1}`, {\n\t\t\t\tcause: error,\n\t\t\t});\n\t\t}\n\t\tassertObject(envelope, `pi-server compact state envelope line ${index + 1}`);\n\t\tif (typeof envelope.payload !== \"string\") {\n\t\t\tthrow new Error(`pi-server compact state envelope payload must be a string at line ${index + 1}`);\n\t\t}\n\t\tassertHash(envelope.sha256, `pi-server compact state envelope line ${index + 1}.sha256`);\n\t\tif (sha256(envelope.payload) !== envelope.sha256) {\n\t\t\tthrow new Error(`pi-server compact state checksum mismatch at line ${index + 1}`);\n\t\t}\n\t\tconst record = parsePayload(envelope.payload, index + 1);\n\t\tif (record.sequence !== expectedSequence) {\n\t\t\tthrow new Error(\n\t\t\t\t`pi-server compact state sequence mismatch at line ${index + 1}: expected ${expectedSequence}, received ${record.sequence}`,\n\t\t\t);\n\t\t}\n\t\texpectedSequence++;\n\t\tif (record.kind === \"compact\") {\n\t\t\tif (pending) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`pi-server compact state contains a new operation before ${pending.operationId} was acknowledged`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tpending = record;\n\t\t} else if (record.kind === \"applied\" || record.kind === \"terminal\") {\n\t\t\tif (\n\t\t\t\t!pending ||\n\t\t\t\tpending.operationId !== record.operationId ||\n\t\t\t\tpending.requestHash !== record.requestHash ||\n\t\t\t\tpending.observation\n\t\t\t) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`pi-server compact state observation does not match the pending operation at line ${index + 1}`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tpending = { ...pending, observation: record };\n\t\t} else {\n\t\t\tif (!pending || pending.operationId !== record.operationId) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`pi-server compact state acknowledgement does not match the pending operation at line ${index + 1}`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tpending = undefined;\n\t\t}\n\t}\n\treturn { nextSequence: expectedSequence, pending };\n}\n\nfunction appendRecord(path: string, record: PiServerCompactStateRecord): void {\n\tconst payload = JSON.stringify(record);\n\tconst encoded = Buffer.from(`${JSON.stringify({ payload, sha256: sha256(payload) })}\\n`, \"utf-8\");\n\tconst existing = existsSync(path) ? readFileSync(path) : Buffer.alloc(0);\n\tconst validBytes = existing.lastIndexOf(0x0a) + 1;\n\tif (validBytes !== existing.byteLength) truncateSync(path, validBytes);\n\tif (validBytes + encoded.byteLength > COMPACT_STATE_MAX_BYTES) {\n\t\tthrow new Error(`pi-server compact state would exceed ${COMPACT_STATE_MAX_BYTES} bytes: ${path}`);\n\t}\n\tconst fileExisted = existsSync(path);\n\tconst handle = openSync(path, \"a\", 0o600);\n\ttry {\n\t\tlet written = 0;\n\t\twhile (written < encoded.byteLength) {\n\t\t\tconst bytesWritten = writeSync(handle, encoded, written, encoded.byteLength - written);\n\t\t\tif (bytesWritten === 0) throw new Error(`Failed to make progress writing pi-server compact state: ${path}`);\n\t\t\twritten += bytesWritten;\n\t\t}\n\t\tfsyncSync(handle);\n\t} finally {\n\t\tcloseSync(handle);\n\t}\n\tif (!fileExisted && process.platform !== \"win32\") {\n\t\tconst directoryHandle = openSync(dirname(path), \"r\");\n\t\ttry {\n\t\t\tfsyncSync(directoryHandle);\n\t\t} finally {\n\t\t\tcloseSync(directoryHandle);\n\t\t}\n\t}\n}\n\nfunction withCompactStateLock<T>(path: string, operation: () => T): T {\n\tconst normalizedPath = resolve(path);\n\tconst database = new DatabaseSync(`${normalizedPath}.lock.sqlite`);\n\tlet transactionStarted = false;\n\ttry {\n\t\tdatabase.exec(\"PRAGMA busy_timeout = 0\");\n\t\tdatabase.exec(\"CREATE TABLE IF NOT EXISTS compact_state_lock (id INTEGER PRIMARY KEY CHECK (id = 1))\");\n\t\tdatabase.exec(\"BEGIN IMMEDIATE\");\n\t\ttransactionStarted = true;\n\t\treturn operation();\n\t} catch (error) {\n\t\tconst details = error instanceof Error ? error.message : String(error);\n\t\tthrow new Error(`Cannot update pi-server compact state ${normalizedPath}: ${details}`, { cause: error });\n\t} finally {\n\t\tif (transactionStarted) {\n\t\t\ttry {\n\t\t\t\tdatabase.exec(\"ROLLBACK\");\n\t\t\t} catch {\n\t\t\t\t// Closing the connection is the authoritative lock release.\n\t\t\t}\n\t\t}\n\t\tdatabase.close();\n\t}\n}\n\nexport function getPiServerCompactStatePath(sessionFile: string): string {\n\treturn `${sessionFile}.pi-server-compacts.jsonl`;\n}\n\nexport function readPiServerPendingCompact(path: string): PiServerPendingCompactState | undefined {\n\treturn parseCompactStateFile(path).pending;\n}\n\nexport function writePiServerPendingCompact(\n\tpath: string,\n\tinput: WritePiServerPendingCompactInput,\n): PiServerPendingCompactState {\n\treturn withCompactStateLock(path, () => {\n\t\tconst state = parseCompactStateFile(path);\n\t\tif (state.pending) {\n\t\t\tthrow new Error(\n\t\t\t\t`pi-server compaction ${state.pending.operationId} must be acknowledged before starting another compaction`,\n\t\t\t);\n\t\t}\n\t\tif (state.nextSequence > 0) {\n\t\t\ttruncateSync(path, 0);\n\t\t\tstate.nextSequence = 0;\n\t\t}\n\t\tconst timestamp = input.timestamp ?? Date.now();\n\t\tassertNonNegativeSafeInteger(timestamp, \"pi-server compact state timestamp\");\n\t\tassertHash(input.serverHash, \"pi-server compact state serverHash\");\n\t\tassertIdentifier(input.sessionId, \"pi-server compact state sessionId\");\n\t\tassertIdentifier(input.operationId, \"pi-server compact state operationId\");\n\t\tassertHash(input.requestHash, \"pi-server compact state requestHash\");\n\t\tassertHash(input.baseStaticContextHash, \"pi-server compact state baseStaticContextHash\", true);\n\t\tassertHash(input.baseTreeHash, \"pi-server compact state baseTreeHash\");\n\t\tassertNonNegativeSafeInteger(input.baseEntryCount, \"pi-server compact state baseEntryCount\");\n\t\tif (input.baseLeafId !== null) assertIdentifier(input.baseLeafId, \"pi-server compact state baseLeafId\");\n\t\tassertNonNegativeSafeInteger(input.baseRevision, \"pi-server compact state baseRevision\");\n\t\tconst record: PiServerPendingCompactState = {\n\t\t\tversion: COMPACT_STATE_VERSION,\n\t\t\tkind: \"compact\",\n\t\t\tsequence: state.nextSequence,\n\t\t\ttimestamp,\n\t\t\tserverHash: input.serverHash,\n\t\t\tsessionId: input.sessionId,\n\t\t\toperationId: input.operationId,\n\t\t\trequestHash: input.requestHash,\n\t\t\tbaseStaticContextHash: input.baseStaticContextHash,\n\t\t\tbaseTreeHash: input.baseTreeHash,\n\t\t\tbaseEntryCount: input.baseEntryCount,\n\t\t\tbaseLeafId: input.baseLeafId,\n\t\t\tbaseRevision: input.baseRevision,\n\t\t};\n\t\tappendRecord(path, record);\n\t\treturn record;\n\t});\n}\n\nexport function writePiServerAppliedCompact(\n\tpath: string,\n\tinput: WritePiServerAppliedCompactInput,\n): PiServerAppliedCompactState {\n\treturn withCompactStateLock(path, () => {\n\t\tconst state = parseCompactStateFile(path);\n\t\tconst pending = state.pending;\n\t\tif (!pending || pending.operationId !== input.operationId || pending.requestHash !== input.requestHash) {\n\t\t\tthrow new Error(\"Cannot record an applied pi-server compaction without its matching pending operation\");\n\t\t}\n\t\tassertIdentifier(input.entryId, \"pi-server compact applied entryId\");\n\t\tassertHash(input.entryHash, \"pi-server compact applied entryHash\");\n\t\tassertHash(input.updatedTreeHash, \"pi-server compact applied updatedTreeHash\");\n\t\tassertIdentifier(input.updatedLeafId, \"pi-server compact applied updatedLeafId\");\n\t\tassertNonNegativeSafeInteger(input.updatedRevision, \"pi-server compact applied updatedRevision\");\n\t\tif (pending.observation) {\n\t\t\tif (\n\t\t\t\tpending.observation.kind !== \"applied\" ||\n\t\t\t\tpending.observation.entryId !== input.entryId ||\n\t\t\t\tpending.observation.entryHash !== input.entryHash ||\n\t\t\t\tpending.observation.updatedTreeHash !== input.updatedTreeHash ||\n\t\t\t\tpending.observation.updatedLeafId !== input.updatedLeafId ||\n\t\t\t\tpending.observation.updatedRevision !== input.updatedRevision\n\t\t\t) {\n\t\t\t\tthrow new Error(\"Pi-server compaction already has a divergent durable observation\");\n\t\t\t}\n\t\t\treturn pending.observation;\n\t\t}\n\t\tconst timestamp = input.timestamp ?? Date.now();\n\t\tassertNonNegativeSafeInteger(timestamp, \"pi-server compact applied timestamp\");\n\t\tconst record: PiServerAppliedCompactState = {\n\t\t\tversion: COMPACT_STATE_VERSION,\n\t\t\tkind: \"applied\",\n\t\t\tsequence: state.nextSequence,\n\t\t\ttimestamp,\n\t\t\toperationId: input.operationId,\n\t\t\trequestHash: input.requestHash,\n\t\t\tentryId: input.entryId,\n\t\t\tentryHash: input.entryHash,\n\t\t\tupdatedTreeHash: input.updatedTreeHash,\n\t\t\tupdatedLeafId: input.updatedLeafId,\n\t\t\tupdatedRevision: input.updatedRevision,\n\t\t\tresolution: \"tree_applied\",\n\t\t};\n\t\tappendRecord(path, record);\n\t\treturn record;\n\t});\n}\n\nexport function writePiServerTerminalCompact(\n\tpath: string,\n\tinput: WritePiServerTerminalCompactInput,\n): PiServerTerminalCompactState {\n\treturn withCompactStateLock(path, () => {\n\t\tconst state = parseCompactStateFile(path);\n\t\tconst pending = state.pending;\n\t\tif (!pending || pending.operationId !== input.operationId || pending.requestHash !== input.requestHash) {\n\t\t\tthrow new Error(\"Cannot record a terminal pi-server compaction without its matching pending operation\");\n\t\t}\n\t\tif (!Number.isSafeInteger(input.httpStatus) || input.httpStatus < 100 || input.httpStatus > 599) {\n\t\t\tthrow new Error(\"pi-server compact terminal HTTP status is invalid\");\n\t\t}\n\t\tassertError(input.error, \"pi-server compact terminal error\");\n\t\tif (\n\t\t\t(input.operationDisposition === \"terminal\" && input.status !== \"failed\") ||\n\t\t\t(input.operationDisposition === \"not_started\" && input.status !== \"rejected\")\n\t\t) {\n\t\t\tthrow new Error(\"pi-server compact terminal disposition is invalid\");\n\t\t}\n\t\tif (pending.observation) {\n\t\t\tif (\n\t\t\t\tpending.observation.kind !== \"terminal\" ||\n\t\t\t\tpending.observation.httpStatus !== input.httpStatus ||\n\t\t\t\tpending.observation.error !== input.error ||\n\t\t\t\tpending.observation.operationDisposition !== input.operationDisposition ||\n\t\t\t\tpending.observation.status !== input.status\n\t\t\t) {\n\t\t\t\tthrow new Error(\"Pi-server compaction already has a divergent durable observation\");\n\t\t\t}\n\t\t\treturn pending.observation;\n\t\t}\n\t\tconst timestamp = input.timestamp ?? Date.now();\n\t\tassertNonNegativeSafeInteger(timestamp, \"pi-server compact terminal timestamp\");\n\t\tconst record: PiServerTerminalCompactState = {\n\t\t\tversion: COMPACT_STATE_VERSION,\n\t\t\tkind: \"terminal\",\n\t\t\tsequence: state.nextSequence,\n\t\t\ttimestamp,\n\t\t\toperationId: input.operationId,\n\t\t\trequestHash: input.requestHash,\n\t\t\thttpStatus: input.httpStatus,\n\t\t\terror: input.error,\n\t\t\toperationDisposition: input.operationDisposition,\n\t\t\tstatus: input.status,\n\t\t\tresolution: input.operationDisposition === \"terminal\" ? \"terminal_failed_observed\" : \"server_rejected\",\n\t\t};\n\t\tappendRecord(path, record);\n\t\treturn record;\n\t});\n}\n\nexport function acknowledgePiServerPendingCompact(\n\tpath: string,\n\toperationId: string,\n\tresolution: PiServerCompactAcknowledgementResolution = \"server_ack\",\n\ttimestamp = Date.now(),\n): void {\n\twithCompactStateLock(path, () => {\n\t\tconst state = parseCompactStateFile(path);\n\t\tif (!state.pending) return;\n\t\tif (state.pending.operationId !== operationId) {\n\t\t\tthrow new Error(\n\t\t\t\t`Cannot acknowledge pi-server compaction ${operationId}; pending operation is ${state.pending.operationId}`,\n\t\t\t);\n\t\t}\n\t\tassertNonNegativeSafeInteger(timestamp, \"pi-server compact acknowledgement timestamp\");\n\t\tappendRecord(path, {\n\t\t\tversion: COMPACT_STATE_VERSION,\n\t\t\tkind: \"ack\",\n\t\t\tsequence: state.nextSequence,\n\t\t\ttimestamp,\n\t\t\toperationId,\n\t\t\tresolution,\n\t\t});\n\t});\n}\n"]}