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

package/dist/core/pi-server-run-state.js

@@ -1,320 +0,0 @@
-import { Buffer } from "node:buffer";
-import { createHash } from "node:crypto";
-import { closeSync, existsSync, fsyncSync, openSync, readFileSync, truncateSync, writeSync } from "node:fs";
-import { dirname, resolve } from "node:path";
-import { DatabaseSync } from "node:sqlite";
-const RUN_STATE_VERSION = 1;
-const RUN_STATE_MAX_BYTES = 8 * 1024 * 1024;
-const SHA256_PATTERN = /^[a-f0-9]{64}$/;
-const IDENTIFIER_MAX_CHARS = 1024;
-function sha256(value) {
-    return createHash("sha256").update(value).digest("hex");
-}
-export function acquirePiServerRunStateLease(path) {
-    const normalizedPath = resolve(path);
-    const database = new DatabaseSync(`${normalizedPath}.lock.sqlite`);
-    let transactionStarted = false;
-    try {
-        database.exec("PRAGMA busy_timeout = 0");
-        database.exec("CREATE TABLE IF NOT EXISTS run_state_lock (id INTEGER PRIMARY KEY CHECK (id = 1))");
-        database.exec("BEGIN IMMEDIATE");
-        transactionStarted = true;
-        return { path: normalizedPath, database, active: true };
-    }
-    catch (error) {
-        if (transactionStarted) {
-            try {
-                database.exec("ROLLBACK");
-            }
-            catch {
-                // Closing the connection below is the authoritative lock release.
-            }
-        }
-        database.close();
-        throw new Error(`Cannot acquire pi-server run lease for ${normalizedPath}; another process owns the session`, {
-            cause: error,
-        });
-    }
-}
-export function releasePiServerRunStateLease(lease) {
-    if (!lease.active)
-        return;
-    lease.active = false;
-    try {
-        lease.database.exec("ROLLBACK");
-    }
-    catch {
-        // close() still releases the OS-backed SQLite transaction after connection failure.
-    }
-    try {
-        lease.database.close();
-    }
-    catch {
-        // The lease is already unusable and close() is idempotent at this abstraction boundary.
-    }
-}
-function assertPiServerRunStateLease(path, lease) {
-    if (!lease.active) {
-        throw new Error("Cannot use a released pi-server run lease");
-    }
-    const normalizedPath = resolve(path);
-    if (lease.path !== normalizedPath) {
-        throw new Error(`Pi-server run lease path mismatch: expected ${normalizedPath}, received ${lease.path}`);
-    }
-}
-function withRunStateLease(path, lease, operation) {
-    if (lease) {
-        assertPiServerRunStateLease(path, lease);
-        return operation();
-    }
-    const acquiredLease = acquirePiServerRunStateLease(path);
-    try {
-        return operation();
-    }
-    finally {
-        releasePiServerRunStateLease(acquiredLease);
-    }
-}
-function assertObject(value, path) {
-    if (typeof value !== "object" || value === null || Array.isArray(value)) {
-        throw new Error(`${path} must be an object`);
-    }
-}
-function assertIdentifier(value, path) {
-    if (typeof value !== "string" || value.length === 0 || value.length > IDENTIFIER_MAX_CHARS) {
-        throw new Error(`${path} must be a non-empty string up to ${IDENTIFIER_MAX_CHARS} characters`);
-    }
-}
-function assertHash(value, path) {
-    if (typeof value !== "string" || !SHA256_PATTERN.test(value)) {
-        throw new Error(`${path} must be a 64-character hex digest`);
-    }
-}
-function assertNonNegativeSafeInteger(value, path) {
-    if (!Number.isSafeInteger(value) || value < 0) {
-        throw new Error(`${path} must be a non-negative safe integer`);
-    }
-}
-function parseRecord(payload, lineNumber) {
-    let value;
-    try {
-        value = JSON.parse(payload);
-    }
-    catch (error) {
-        throw new Error(`pi-server run state payload is invalid JSON at line ${lineNumber}`, { cause: error });
-    }
-    assertObject(value, `pi-server run state line ${lineNumber}`);
-    if (value.version !== RUN_STATE_VERSION) {
-        throw new Error(`Unsupported pi-server run state version at line ${lineNumber}`);
-    }
-    assertNonNegativeSafeInteger(value.sequence, `pi-server run state line ${lineNumber}.sequence`);
-    assertNonNegativeSafeInteger(value.timestamp, `pi-server run state line ${lineNumber}.timestamp`);
-    if (value.kind === "ack") {
-        assertIdentifier(value.runId, `pi-server run state line ${lineNumber}.runId`);
-        if (value.resolution !== "server_ack" &&
-            value.resolution !== "server_authoritative_missing" &&
-            value.resolution !== "server_authoritative_rebind") {
-            throw new Error(`pi-server run state acknowledgement resolution is invalid at line ${lineNumber}`);
-        }
-        return {
-            version: RUN_STATE_VERSION,
-            kind: "ack",
-            sequence: value.sequence,
-            timestamp: value.timestamp,
-            runId: value.runId,
-            resolution: value.resolution,
-        };
-    }
-    if (value.kind !== "run") {
-        throw new Error(`Unsupported pi-server run state record kind at line ${lineNumber}`);
-    }
-    assertHash(value.serverHash, `pi-server run state line ${lineNumber}.serverHash`);
-    assertIdentifier(value.sessionId, `pi-server run state line ${lineNumber}.sessionId`);
-    assertIdentifier(value.runId, `pi-server run state line ${lineNumber}.runId`);
-    assertHash(value.baseTreeHash, `pi-server run state line ${lineNumber}.baseTreeHash`);
-    assertNonNegativeSafeInteger(value.baseEntryCount, `pi-server run state line ${lineNumber}.baseEntryCount`);
-    if (value.baseLeafId !== null) {
-        assertIdentifier(value.baseLeafId, `pi-server run state line ${lineNumber}.baseLeafId`);
-    }
-    assertHash(value.requestHash, `pi-server run state line ${lineNumber}.requestHash`);
-    return {
-        version: RUN_STATE_VERSION,
-        kind: "run",
-        sequence: value.sequence,
-        timestamp: value.timestamp,
-        serverHash: value.serverHash,
-        sessionId: value.sessionId,
-        runId: value.runId,
-        baseTreeHash: value.baseTreeHash,
-        baseEntryCount: value.baseEntryCount,
-        baseLeafId: value.baseLeafId,
-        requestHash: value.requestHash,
-    };
-}
-function parseRunStateFile(path) {
-    if (!existsSync(path)) {
-        return { nextSequence: 0, pending: undefined };
-    }
-    const encoded = readFileSync(path);
-    if (encoded.byteLength > RUN_STATE_MAX_BYTES) {
-        throw new Error(`pi-server run state exceeds ${RUN_STATE_MAX_BYTES} bytes: ${path}`);
-    }
-    const content = encoded.toString("utf-8");
-    const hasCompleteTail = content.endsWith("\n");
-    const lines = content.split("\n");
-    if (!hasCompleteTail) {
-        lines.pop();
-    }
-    let expectedSequence = 0;
-    let pending;
-    for (const [index, line] of lines.entries()) {
-        if (line.length === 0)
-            continue;
-        let envelopeValue;
-        try {
-            envelopeValue = JSON.parse(line);
-        }
-        catch (error) {
-            throw new Error(`pi-server run state envelope is invalid JSON at line ${index + 1}`, { cause: error });
-        }
-        assertObject(envelopeValue, `pi-server run state envelope line ${index + 1}`);
-        if (typeof envelopeValue.payload !== "string") {
-            throw new Error(`pi-server run state envelope payload must be a string at line ${index + 1}`);
-        }
-        assertHash(envelopeValue.sha256, `pi-server run state envelope line ${index + 1}.sha256`);
-        if (sha256(envelopeValue.payload) !== envelopeValue.sha256) {
-            throw new Error(`pi-server run state checksum mismatch at line ${index + 1}`);
-        }
-        const record = parseRecord(envelopeValue.payload, index + 1);
-        if (record.sequence !== expectedSequence) {
-            throw new Error(`pi-server run state sequence mismatch at line ${index + 1}: expected ${expectedSequence}, received ${record.sequence}`);
-        }
-        expectedSequence++;
-        if (record.kind === "run") {
-            if (pending) {
-                throw new Error(`pi-server run state contains a new run before ${pending.runId} was acknowledged`);
-            }
-            pending = record;
-        }
-        else {
-            if (!pending || pending.runId !== record.runId) {
-                throw new Error(`pi-server run state acknowledgement does not match the pending run at line ${index + 1}`);
-            }
-            pending = undefined;
-        }
-    }
-    return { nextSequence: expectedSequence, pending };
-}
-function appendRecord(path, record) {
-    const payload = JSON.stringify(record);
-    const envelope = { payload, sha256: sha256(payload) };
-    const encoded = Buffer.from(`${JSON.stringify(envelope)}\n`, "utf-8");
-    const existing = existsSync(path) ? readFileSync(path) : Buffer.alloc(0);
-    const validBytes = existing.lastIndexOf(0x0a) + 1;
-    if (validBytes !== existing.byteLength) {
-        truncateSync(path, validBytes);
-    }
-    const existingBytes = validBytes;
-    if (existingBytes + encoded.byteLength > RUN_STATE_MAX_BYTES) {
-        throw new Error(`pi-server run state would exceed ${RUN_STATE_MAX_BYTES} bytes: ${path}`);
-    }
-    const fileExisted = existsSync(path);
-    const handle = openSync(path, "a", 0o600);
-    try {
-        let written = 0;
-        while (written < encoded.byteLength) {
-            const bytesWritten = writeSync(handle, encoded, written, encoded.byteLength - written);
-            if (bytesWritten === 0) {
-                throw new Error(`Failed to make progress writing pi-server run state: ${path}`);
-            }
-            written += bytesWritten;
-        }
-        fsyncSync(handle);
-    }
-    finally {
-        closeSync(handle);
-    }
-    if (!fileExisted && process.platform !== "win32") {
-        const directoryHandle = openSync(dirname(path), "r");
-        try {
-            fsyncSync(directoryHandle);
-        }
-        finally {
-            closeSync(directoryHandle);
-        }
-    }
-}
-export function getPiServerRunStatePath(sessionFile) {
-    return `${sessionFile}.pi-server-runs.jsonl`;
-}
-export function hashPiServerIdentity(serverUrl) {
-    return sha256(serverUrl);
-}
-export function readPiServerPendingRun(path, lease) {
-    if (lease) {
-        assertPiServerRunStateLease(path, lease);
-    }
-    // The append-only checksum envelope makes an unlocked observer read safe: a concurrent
-    // incomplete final record is ignored. Lifecycle decisions pass the owning lease.
-    return parseRunStateFile(path).pending;
-}
-export function writePiServerPendingRun(path, input, lease) {
-    return withRunStateLease(path, lease, () => {
-        const state = parseRunStateFile(path);
-        if (state.pending) {
-            throw new Error(`pi-server run ${state.pending.runId} must be acknowledged before starting another run`);
-        }
-        if (state.nextSequence > 0) {
-            // All earlier runs are acknowledged. Truncating before the new durable marker is safe:
-            // the caller cannot submit the new provider request until this function returns.
-            truncateSync(path, 0);
-            state.nextSequence = 0;
-        }
-        const timestamp = input.timestamp ?? Date.now();
-        assertNonNegativeSafeInteger(timestamp, "pi-server run state timestamp");
-        assertHash(input.serverHash, "pi-server run state serverHash");
-        assertIdentifier(input.sessionId, "pi-server run state sessionId");
-        assertIdentifier(input.runId, "pi-server run state runId");
-        assertHash(input.baseTreeHash, "pi-server run state baseTreeHash");
-        assertNonNegativeSafeInteger(input.baseEntryCount, "pi-server run state baseEntryCount");
-        if (input.baseLeafId !== null) {
-            assertIdentifier(input.baseLeafId, "pi-server run state baseLeafId");
-        }
-        assertHash(input.requestHash, "pi-server run state requestHash");
-        const record = {
-            version: RUN_STATE_VERSION,
-            kind: "run",
-            sequence: state.nextSequence,
-            timestamp,
-            serverHash: input.serverHash,
-            sessionId: input.sessionId,
-            runId: input.runId,
-            baseTreeHash: input.baseTreeHash,
-            baseEntryCount: input.baseEntryCount,
-            baseLeafId: input.baseLeafId,
-            requestHash: input.requestHash,
-        };
-        appendRecord(path, record);
-        return record;
-    });
-}
-export function acknowledgePiServerPendingRun(path, runId, timestamp = Date.now(), lease, resolution = "server_ack") {
-    withRunStateLease(path, lease, () => {
-        const state = parseRunStateFile(path);
-        if (!state.pending)
-            return;
-        if (state.pending.runId !== runId) {
-            throw new Error(`Cannot acknowledge pi-server run ${runId}; pending run is ${state.pending.runId}`);
-        }
-        assertNonNegativeSafeInteger(timestamp, "pi-server run acknowledgement timestamp");
-        appendRecord(path, {
-            version: RUN_STATE_VERSION,
-            kind: "ack",
-            sequence: state.nextSequence,
-            timestamp,
-            runId,
-            resolution,
-        });
-    });
-}
-//# sourceMappingURL=pi-server-run-state.js.map

package/dist/core/pi-server-run-state.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"pi-server-run-state.js","sourceRoot":"","sources":["../../src/core/pi-server-run-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 RUN_STATE_VERSION = 1;\nconst RUN_STATE_MAX_BYTES = 8 * 1024 * 1024;\nconst SHA256_PATTERN = /^[a-f0-9]{64}$/;\nconst IDENTIFIER_MAX_CHARS = 1024;\n\ninterface PiServerRunStateBase {\n\tversion: typeof RUN_STATE_VERSION;\n\tsequence: number;\n\ttimestamp: number;\n}\n\nexport interface PiServerPendingRunState extends PiServerRunStateBase {\n\tkind: \"run\";\n\tserverHash: string;\n\tsessionId: string;\n\trunId: string;\n\tbaseTreeHash: string;\n\tbaseEntryCount: number;\n\tbaseLeafId: string | null;\n\trequestHash: string;\n}\n\ninterface PiServerAcknowledgedRunState extends PiServerRunStateBase {\n\tkind: \"ack\";\n\trunId: string;\n\tresolution: PiServerRunAcknowledgementResolution;\n}\n\ntype PiServerRunStateRecord = PiServerPendingRunState | PiServerAcknowledgedRunState;\n\nexport type PiServerRunAcknowledgementResolution =\n\t| \"server_ack\"\n\t| \"server_authoritative_missing\"\n\t| \"server_authoritative_rebind\";\n\ninterface PiServerRunStateEnvelope {\n\tpayload: string;\n\tsha256: string;\n}\n\nexport interface WritePiServerPendingRunInput {\n\tserverHash: string;\n\tsessionId: string;\n\trunId: string;\n\tbaseTreeHash: string;\n\tbaseEntryCount: number;\n\tbaseLeafId: string | null;\n\trequestHash: string;\n\ttimestamp?: number;\n}\n\ninterface ParsedPiServerRunState {\n\tnextSequence: number;\n\tpending: PiServerPendingRunState | undefined;\n}\n\nexport interface PiServerRunStateLease {\n\treadonly path: string;\n\treadonly database: DatabaseSync;\n\tactive: boolean;\n}\n\nfunction sha256(value: string): string {\n\treturn createHash(\"sha256\").update(value).digest(\"hex\");\n}\n\nexport function acquirePiServerRunStateLease(path: string): PiServerRunStateLease {\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 run_state_lock (id INTEGER PRIMARY KEY CHECK (id = 1))\");\n\t\tdatabase.exec(\"BEGIN IMMEDIATE\");\n\t\ttransactionStarted = true;\n\t\treturn { path: normalizedPath, database, active: true };\n\t} catch (error) {\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 below is the authoritative lock release.\n\t\t\t}\n\t\t}\n\t\tdatabase.close();\n\t\tthrow new Error(`Cannot acquire pi-server run lease for ${normalizedPath}; another process owns the session`, {\n\t\t\tcause: error,\n\t\t});\n\t}\n}\n\nexport function releasePiServerRunStateLease(lease: PiServerRunStateLease): void {\n\tif (!lease.active) return;\n\tlease.active = false;\n\ttry {\n\t\tlease.database.exec(\"ROLLBACK\");\n\t} catch {\n\t\t// close() still releases the OS-backed SQLite transaction after connection failure.\n\t}\n\ttry {\n\t\tlease.database.close();\n\t} catch {\n\t\t// The lease is already unusable and close() is idempotent at this abstraction boundary.\n\t}\n}\n\nfunction assertPiServerRunStateLease(path: string, lease: PiServerRunStateLease): void {\n\tif (!lease.active) {\n\t\tthrow new Error(\"Cannot use a released pi-server run lease\");\n\t}\n\tconst normalizedPath = resolve(path);\n\tif (lease.path !== normalizedPath) {\n\t\tthrow new Error(`Pi-server run lease path mismatch: expected ${normalizedPath}, received ${lease.path}`);\n\t}\n}\n\nfunction withRunStateLease<T>(path: string, lease: PiServerRunStateLease | undefined, operation: () => T): T {\n\tif (lease) {\n\t\tassertPiServerRunStateLease(path, lease);\n\t\treturn operation();\n\t}\n\tconst acquiredLease = acquirePiServerRunStateLease(path);\n\ttry {\n\t\treturn operation();\n\t} finally {\n\t\treleasePiServerRunStateLease(acquiredLease);\n\t}\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) {\n\t\tthrow new Error(`${path} must be a non-empty string up to ${IDENTIFIER_MAX_CHARS} characters`);\n\t}\n}\n\nfunction assertHash(value: unknown, path: string): asserts value is string {\n\tif (typeof value !== \"string\" || !SHA256_PATTERN.test(value)) {\n\t\tthrow new Error(`${path} must be a 64-character hex digest`);\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 parseRecord(payload: string, lineNumber: number): PiServerRunStateRecord {\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 run state payload is invalid JSON at line ${lineNumber}`, { cause: error });\n\t}\n\tassertObject(value, `pi-server run state line ${lineNumber}`);\n\tif (value.version !== RUN_STATE_VERSION) {\n\t\tthrow new Error(`Unsupported pi-server run state version at line ${lineNumber}`);\n\t}\n\tassertNonNegativeSafeInteger(value.sequence, `pi-server run state line ${lineNumber}.sequence`);\n\tassertNonNegativeSafeInteger(value.timestamp, `pi-server run state line ${lineNumber}.timestamp`);\n\tif (value.kind === \"ack\") {\n\t\tassertIdentifier(value.runId, `pi-server run state line ${lineNumber}.runId`);\n\t\tif (\n\t\t\tvalue.resolution !== \"server_ack\" &&\n\t\t\tvalue.resolution !== \"server_authoritative_missing\" &&\n\t\t\tvalue.resolution !== \"server_authoritative_rebind\"\n\t\t) {\n\t\t\tthrow new Error(`pi-server run state acknowledgement resolution is invalid at line ${lineNumber}`);\n\t\t}\n\t\treturn {\n\t\t\tversion: RUN_STATE_VERSION,\n\t\t\tkind: \"ack\",\n\t\t\tsequence: value.sequence,\n\t\t\ttimestamp: value.timestamp,\n\t\t\trunId: value.runId,\n\t\t\tresolution: value.resolution,\n\t\t};\n\t}\n\tif (value.kind !== \"run\") {\n\t\tthrow new Error(`Unsupported pi-server run state record kind at line ${lineNumber}`);\n\t}\n\tassertHash(value.serverHash, `pi-server run state line ${lineNumber}.serverHash`);\n\tassertIdentifier(value.sessionId, `pi-server run state line ${lineNumber}.sessionId`);\n\tassertIdentifier(value.runId, `pi-server run state line ${lineNumber}.runId`);\n\tassertHash(value.baseTreeHash, `pi-server run state line ${lineNumber}.baseTreeHash`);\n\tassertNonNegativeSafeInteger(value.baseEntryCount, `pi-server run state line ${lineNumber}.baseEntryCount`);\n\tif (value.baseLeafId !== null) {\n\t\tassertIdentifier(value.baseLeafId, `pi-server run state line ${lineNumber}.baseLeafId`);\n\t}\n\tassertHash(value.requestHash, `pi-server run state line ${lineNumber}.requestHash`);\n\treturn {\n\t\tversion: RUN_STATE_VERSION,\n\t\tkind: \"run\",\n\t\tsequence: value.sequence,\n\t\ttimestamp: value.timestamp,\n\t\tserverHash: value.serverHash,\n\t\tsessionId: value.sessionId,\n\t\trunId: value.runId,\n\t\tbaseTreeHash: value.baseTreeHash,\n\t\tbaseEntryCount: value.baseEntryCount,\n\t\tbaseLeafId: value.baseLeafId,\n\t\trequestHash: value.requestHash,\n\t};\n}\n\nfunction parseRunStateFile(path: string): ParsedPiServerRunState {\n\tif (!existsSync(path)) {\n\t\treturn { nextSequence: 0, pending: undefined };\n\t}\n\tconst encoded = readFileSync(path);\n\tif (encoded.byteLength > RUN_STATE_MAX_BYTES) {\n\t\tthrow new Error(`pi-server run state exceeds ${RUN_STATE_MAX_BYTES} bytes: ${path}`);\n\t}\n\tconst content = encoded.toString(\"utf-8\");\n\tconst hasCompleteTail = content.endsWith(\"\\n\");\n\tconst lines = content.split(\"\\n\");\n\tif (!hasCompleteTail) {\n\t\tlines.pop();\n\t}\n\tlet expectedSequence = 0;\n\tlet pending: PiServerPendingRunState | undefined;\n\tfor (const [index, line] of lines.entries()) {\n\t\tif (line.length === 0) continue;\n\t\tlet envelopeValue: unknown;\n\t\ttry {\n\t\t\tenvelopeValue = JSON.parse(line) as unknown;\n\t\t} catch (error) {\n\t\t\tthrow new Error(`pi-server run state envelope is invalid JSON at line ${index + 1}`, { cause: error });\n\t\t}\n\t\tassertObject(envelopeValue, `pi-server run state envelope line ${index + 1}`);\n\t\tif (typeof envelopeValue.payload !== \"string\") {\n\t\t\tthrow new Error(`pi-server run state envelope payload must be a string at line ${index + 1}`);\n\t\t}\n\t\tassertHash(envelopeValue.sha256, `pi-server run state envelope line ${index + 1}.sha256`);\n\t\tif (sha256(envelopeValue.payload) !== envelopeValue.sha256) {\n\t\t\tthrow new Error(`pi-server run state checksum mismatch at line ${index + 1}`);\n\t\t}\n\t\tconst record = parseRecord(envelopeValue.payload, index + 1);\n\t\tif (record.sequence !== expectedSequence) {\n\t\t\tthrow new Error(\n\t\t\t\t`pi-server run 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 === \"run\") {\n\t\t\tif (pending) {\n\t\t\t\tthrow new Error(`pi-server run state contains a new run before ${pending.runId} was acknowledged`);\n\t\t\t}\n\t\t\tpending = record;\n\t\t} else {\n\t\t\tif (!pending || pending.runId !== record.runId) {\n\t\t\t\tthrow new Error(`pi-server run state acknowledgement does not match the pending run at line ${index + 1}`);\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: PiServerRunStateRecord): void {\n\tconst payload = JSON.stringify(record);\n\tconst envelope: PiServerRunStateEnvelope = { payload, sha256: sha256(payload) };\n\tconst encoded = Buffer.from(`${JSON.stringify(envelope)}\\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) {\n\t\ttruncateSync(path, validBytes);\n\t}\n\tconst existingBytes = validBytes;\n\tif (existingBytes + encoded.byteLength > RUN_STATE_MAX_BYTES) {\n\t\tthrow new Error(`pi-server run state would exceed ${RUN_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) {\n\t\t\t\tthrow new Error(`Failed to make progress writing pi-server run state: ${path}`);\n\t\t\t}\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\nexport function getPiServerRunStatePath(sessionFile: string): string {\n\treturn `${sessionFile}.pi-server-runs.jsonl`;\n}\n\nexport function hashPiServerIdentity(serverUrl: string): string {\n\treturn sha256(serverUrl);\n}\n\nexport function readPiServerPendingRun(\n\tpath: string,\n\tlease?: PiServerRunStateLease,\n): PiServerPendingRunState | undefined {\n\tif (lease) {\n\t\tassertPiServerRunStateLease(path, lease);\n\t}\n\t// The append-only checksum envelope makes an unlocked observer read safe: a concurrent\n\t// incomplete final record is ignored. Lifecycle decisions pass the owning lease.\n\treturn parseRunStateFile(path).pending;\n}\n\nexport function writePiServerPendingRun(\n\tpath: string,\n\tinput: WritePiServerPendingRunInput,\n\tlease?: PiServerRunStateLease,\n): PiServerPendingRunState {\n\treturn withRunStateLease(path, lease, () => {\n\t\tconst state = parseRunStateFile(path);\n\t\tif (state.pending) {\n\t\t\tthrow new Error(`pi-server run ${state.pending.runId} must be acknowledged before starting another run`);\n\t\t}\n\t\tif (state.nextSequence > 0) {\n\t\t\t// All earlier runs are acknowledged. Truncating before the new durable marker is safe:\n\t\t\t// the caller cannot submit the new provider request until this function returns.\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 run state timestamp\");\n\t\tassertHash(input.serverHash, \"pi-server run state serverHash\");\n\t\tassertIdentifier(input.sessionId, \"pi-server run state sessionId\");\n\t\tassertIdentifier(input.runId, \"pi-server run state runId\");\n\t\tassertHash(input.baseTreeHash, \"pi-server run state baseTreeHash\");\n\t\tassertNonNegativeSafeInteger(input.baseEntryCount, \"pi-server run state baseEntryCount\");\n\t\tif (input.baseLeafId !== null) {\n\t\t\tassertIdentifier(input.baseLeafId, \"pi-server run state baseLeafId\");\n\t\t}\n\t\tassertHash(input.requestHash, \"pi-server run state requestHash\");\n\t\tconst record: PiServerPendingRunState = {\n\t\t\tversion: RUN_STATE_VERSION,\n\t\t\tkind: \"run\",\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\trunId: input.runId,\n\t\t\tbaseTreeHash: input.baseTreeHash,\n\t\t\tbaseEntryCount: input.baseEntryCount,\n\t\t\tbaseLeafId: input.baseLeafId,\n\t\t\trequestHash: input.requestHash,\n\t\t};\n\t\tappendRecord(path, record);\n\t\treturn record;\n\t});\n}\n\nexport function acknowledgePiServerPendingRun(\n\tpath: string,\n\trunId: string,\n\ttimestamp = Date.now(),\n\tlease?: PiServerRunStateLease,\n\tresolution: PiServerRunAcknowledgementResolution = \"server_ack\",\n): void {\n\twithRunStateLease(path, lease, () => {\n\t\tconst state = parseRunStateFile(path);\n\t\tif (!state.pending) return;\n\t\tif (state.pending.runId !== runId) {\n\t\t\tthrow new Error(`Cannot acknowledge pi-server run ${runId}; pending run is ${state.pending.runId}`);\n\t\t}\n\t\tassertNonNegativeSafeInteger(timestamp, \"pi-server run acknowledgement timestamp\");\n\t\tappendRecord(path, {\n\t\t\tversion: RUN_STATE_VERSION,\n\t\t\tkind: \"ack\",\n\t\t\tsequence: state.nextSequence,\n\t\t\ttimestamp,\n\t\t\trunId,\n\t\t\tresolution,\n\t\t});\n\t});\n}\n"]}

package/dist/core/tool-effect-journal.d.ts

@@ -1,103 +0,0 @@
-import type { ToolResultMessage } from "@earendil-works/pi-ai";
-import type { SessionManager } from "./session-manager.ts";
-declare const TOOL_EFFECT_JOURNAL_VERSION = 1;
-export type ToolEffectCheckpointStage = "after_temp_open" | "after_temp_write" | "after_temp_fsync" | "before_replace" | "after_replace" | "before_directory_fsync" | "after_directory_fsync";
-export interface ToolEffectJournalTestHooks {
-    onCheckpointStage?: (stage: ToolEffectCheckpointStage) => void;
-    beforeRenameAttempt?: (attempt: number) => void;
-}
-export declare function setToolEffectJournalTestHooks(hooks: ToolEffectJournalTestHooks | undefined): void;
-interface ToolEffectRecordBase {
-    version: typeof TOOL_EFFECT_JOURNAL_VERSION;
-    sequence: number;
-    timestamp: number;
-    effectId: string;
-}
-export interface ToolEffectIntentRecord extends ToolEffectRecordBase {
-    kind: "intent";
-    sessionId: string;
-    assistantEntryId: string;
-    toolCallId: string;
-    toolName: string;
-    toolCallIndex: number;
-    argumentsHash: string;
-}
-export interface DurableToolEffect {
-    intent: ToolEffectIntentRecord;
-    result?: ToolResultMessage;
-    committedSessionEntryId?: string;
-}
-export interface BeginToolEffectInput {
-    sessionId: string;
-    assistantEntryId: string;
-    toolCallId: string;
-    toolName: string;
-    toolCallIndex: number;
-    arguments: unknown;
-    timestamp?: number;
-}
-export interface ToolEffectRecoveryResult {
-    recoveredToolCallIds: string[];
-    acknowledgedToolCallIds: string[];
-}
-export type ToolEffectResolutionPhase = "execution_unknown" | "finalization_unknown" | "result_durable" | "committed";
-export interface ToolEffectResolutionTarget {
-    sessionId: string;
-    sessionPath: string;
-    journalPath: string;
-    effectId: string;
-    toolCallId: string;
-    toolName: string;
-    phase: ToolEffectResolutionPhase;
-}
-export interface ToolEffectResolutionResult {
-    target: ToolEffectResolutionTarget;
-    sessionEntryId: string;
-    alreadyResolved: boolean;
-}
-export type UnknownToolEffectResolutionTarget = ToolEffectResolutionTarget & {
-    phase: "execution_unknown" | "finalization_unknown";
-};
-export interface SessionToolExecutionStart {
-    toolCallId: string;
-    toolName: string;
-    args: unknown;
-}
-export declare class ToolEffectUnknownOutcomeError extends Error {
-    readonly code = "unknown_outcome";
-    readonly toolCallIds: string[];
-    readonly effects: UnknownToolEffectResolutionTarget[];
-    constructor(effects: UnknownToolEffectResolutionTarget[], message?: string);
-}
-export declare class ToolEffectRecoveryRequiredError extends Error {
-    readonly code = "recovery_required";
-    readonly toolCallId: string;
-    constructor(toolCallId: string);
-}
-export declare class ToolEffectJournalCapacityError extends Error {
-    readonly code = "tool_effect_journal_capacity";
-    constructor(message: string);
-}
-export declare function checkpointToolEffectJournal(path: string): boolean;
-export declare function getToolEffectJournalPath(sessionFile: string): string;
-export declare function beginToolEffect(path: string, input: BeginToolEffectInput): ToolEffectIntentRecord;
-export declare function writeToolEffectResult(path: string, effectId: string, message: ToolResultMessage, options?: {
-    finalizationPending?: boolean;
-}): void;
-export declare function beginToolEffectFinalization(path: string, effectId: string, timestamp?: number): void;
-export declare function writeToolEffectFinalResult(path: string, effectId: string, message: ToolResultMessage, timestamp?: number): void;
-export declare function commitToolEffect(path: string, effectId: string, sessionEntryId: string, timestamp?: number): void;
-export declare function readDurableToolEffects(path: string): DurableToolEffect[];
-export declare function beginSessionToolEffect(sessionManager: SessionManager, event: SessionToolExecutionStart): ToolEffectIntentRecord | undefined;
-export declare function writeSessionToolEffectResult(sessionManager: SessionManager, message: ToolResultMessage, options?: {
-    finalizationPending?: boolean;
-}): void;
-export declare function beginSessionToolEffectFinalization(sessionManager: SessionManager, message: ToolResultMessage): void;
-export declare function writeSessionToolEffectFinalResult(sessionManager: SessionManager, message: ToolResultMessage): void;
-export declare function commitSessionToolEffect(sessionManager: SessionManager, message: ToolResultMessage, sessionEntryId: string): void;
-export declare function inspectToolEffect(sessionManager: SessionManager, effectId: string): ToolEffectResolutionTarget;
-export declare function markToolEffectFailed(sessionManager: SessionManager, effectId: string): ToolEffectResolutionResult;
-export declare function acceptToolEffectResult(sessionManager: SessionManager, effectId: string, message: unknown): ToolEffectResolutionResult;
-export declare function recoverToolEffects(sessionManager: SessionManager, journalPath?: string): ToolEffectRecoveryResult;
-export {};
-//# sourceMappingURL=tool-effect-journal.d.ts.map