@averyyy/pi-coding-agent 0.82.1-piclient.3 → 0.82.1-piclient.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (58) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/dist/cli/args.d.ts.map +1 -1
  3. package/dist/cli/args.js +2 -1
  4. package/dist/cli/args.js.map +1 -1
  5. package/dist/cli/tool-effects.d.ts +6 -0
  6. package/dist/cli/tool-effects.d.ts.map +1 -0
  7. package/dist/cli/tool-effects.js +164 -0
  8. package/dist/cli/tool-effects.js.map +1 -0
  9. package/dist/core/agent-session-runtime.d.ts.map +1 -1
  10. package/dist/core/agent-session-runtime.js +5 -0
  11. package/dist/core/agent-session-runtime.js.map +1 -1
  12. package/dist/core/agent-session.d.ts +12 -1
  13. package/dist/core/agent-session.d.ts.map +1 -1
  14. package/dist/core/agent-session.js +314 -89
  15. package/dist/core/agent-session.js.map +1 -1
  16. package/dist/core/pi-server-client.d.ts +53 -2
  17. package/dist/core/pi-server-client.d.ts.map +1 -1
  18. package/dist/core/pi-server-client.js +2082 -290
  19. package/dist/core/pi-server-client.js.map +1 -1
  20. package/dist/core/pi-server-compact-state.d.ts +81 -0
  21. package/dist/core/pi-server-compact-state.d.ts.map +1 -0
  22. package/dist/core/pi-server-compact-state.js +438 -0
  23. package/dist/core/pi-server-compact-state.js.map +1 -0
  24. package/dist/core/pi-server-protocol.d.ts +2 -0
  25. package/dist/core/pi-server-protocol.d.ts.map +1 -1
  26. package/dist/core/pi-server-protocol.js +24 -1
  27. package/dist/core/pi-server-protocol.js.map +1 -1
  28. package/dist/core/pi-server-request.d.ts +28 -0
  29. package/dist/core/pi-server-request.d.ts.map +1 -1
  30. package/dist/core/pi-server-request.js +492 -75
  31. package/dist/core/pi-server-request.js.map +1 -1
  32. package/dist/core/pi-server-run-state.d.ts +41 -0
  33. package/dist/core/pi-server-run-state.d.ts.map +1 -0
  34. package/dist/core/pi-server-run-state.js +318 -0
  35. package/dist/core/pi-server-run-state.js.map +1 -0
  36. package/dist/core/sdk.d.ts.map +1 -1
  37. package/dist/core/sdk.js +69 -53
  38. package/dist/core/sdk.js.map +1 -1
  39. package/dist/core/session-manager.d.ts +86 -2
  40. package/dist/core/session-manager.d.ts.map +1 -1
  41. package/dist/core/session-manager.js +737 -144
  42. package/dist/core/session-manager.js.map +1 -1
  43. package/dist/core/tool-effect-journal.d.ts +103 -0
  44. package/dist/core/tool-effect-journal.d.ts.map +1 -0
  45. package/dist/core/tool-effect-journal.js +1442 -0
  46. package/dist/core/tool-effect-journal.js.map +1 -0
  47. package/dist/core/tools/output-accumulator.d.ts +3 -1
  48. package/dist/core/tools/output-accumulator.d.ts.map +1 -1
  49. package/dist/core/tools/output-accumulator.js +46 -26
  50. package/dist/core/tools/output-accumulator.js.map +1 -1
  51. package/dist/main.d.ts.map +1 -1
  52. package/dist/main.js +13 -0
  53. package/dist/main.js.map +1 -1
  54. package/dist/modes/interactive/components/session-selector.d.ts +15 -0
  55. package/dist/modes/interactive/components/session-selector.d.ts.map +1 -1
  56. package/dist/modes/interactive/components/session-selector.js +98 -29
  57. package/dist/modes/interactive/components/session-selector.js.map +1 -1
  58. package/package.json +4 -4
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pi-server-compact-state.js","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\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) {\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"]}
@@ -1,9 +1,11 @@
1
1
  import type { SessionTreeEntry } from "@earendil-works/pi-agent-core";
2
2
  import type { Tool } from "@earendil-works/pi-ai";
3
+ export declare const PI_SERVER_PROTOCOL_VERSION = 2;
3
4
  export interface PiServerStaticContext {
4
5
  systemPrompt?: string;
5
6
  tools?: Tool[];
6
7
  }
8
+ export declare function canonicalJsonStringify(value: unknown): string | undefined;
7
9
  export declare function hashPiServerStaticContext(context: PiServerStaticContext | undefined): string;
8
10
  export declare const PI_SERVER_EMPTY_TREE_HASH: string;
9
11
  export declare function hashPiServerTreeEntry(entry: SessionTreeEntry): string;
@@ -1 +1 @@
1
- {"version":3,"file":"pi-server-protocol.d.ts","sourceRoot":"","sources":["../../src/core/pi-server-protocol.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAElD,MAAM,WAAW,qBAAqB;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;CACf;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,qBAAqB,GAAG,SAAS,GAAG,MAAM,CAW5F;AAED,eAAO,MAAM,yBAAyB,QAA0D,CAAC;AAEjG,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAErE;AAED,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtF;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM,EAAE,CAMnF;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAE9E","sourcesContent":["import { createHash } from \"node:crypto\";\nimport type { SessionTreeEntry } from \"@earendil-works/pi-agent-core\";\nimport type { Tool } from \"@earendil-works/pi-ai\";\n\nexport interface PiServerStaticContext {\n\tsystemPrompt?: string;\n\ttools?: Tool[];\n}\n\nexport function hashPiServerStaticContext(context: PiServerStaticContext | undefined): string {\n\tif (!context) return \"\";\n\tconst canonical = {\n\t\tsystemPrompt: context.systemPrompt,\n\t\ttools: context.tools?.map((tool) => ({\n\t\t\tname: tool.name,\n\t\t\tdescription: tool.description,\n\t\t\tparameters: tool.parameters,\n\t\t})),\n\t};\n\treturn createHash(\"sha256\").update(JSON.stringify(canonical)).digest(\"hex\");\n}\n\nexport const PI_SERVER_EMPTY_TREE_HASH = createHash(\"sha256\").update(\"pi-tree-v1\").digest(\"hex\");\n\nexport function hashPiServerTreeEntry(entry: SessionTreeEntry): string {\n\treturn createHash(\"sha256\").update(JSON.stringify(entry)).digest(\"hex\");\n}\n\nexport function appendPiServerTreeHash(previousHash: string, entryHash: string): string {\n\treturn createHash(\"sha256\").update(`${previousHash}:${entryHash}`).digest(\"hex\");\n}\n\nexport function buildPiServerTreePrefixHashes(entries: SessionTreeEntry[]): string[] {\n\tconst hashes = [PI_SERVER_EMPTY_TREE_HASH];\n\tfor (const entry of entries) {\n\t\thashes.push(appendPiServerTreeHash(hashes[hashes.length - 1], hashPiServerTreeEntry(entry)));\n\t}\n\treturn hashes;\n}\n\nexport function hashPiServerSessionEntries(entries: SessionTreeEntry[]): string {\n\treturn buildPiServerTreePrefixHashes(entries)[entries.length];\n}\n"]}
1
+ {"version":3,"file":"pi-server-protocol.d.ts","sourceRoot":"","sources":["../../src/core/pi-server-protocol.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAElD,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C,MAAM,WAAW,qBAAqB;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;CACf;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAgBzE;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,qBAAqB,GAAG,SAAS,GAAG,MAAM,CAgB5F;AAED,eAAO,MAAM,yBAAyB,QAA0D,CAAC;AAEjG,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAErE;AAED,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtF;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM,EAAE,CAMnF;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAE9E","sourcesContent":["import { createHash } from \"node:crypto\";\nimport type { SessionTreeEntry } from \"@earendil-works/pi-agent-core\";\nimport type { Tool } from \"@earendil-works/pi-ai\";\n\nexport const PI_SERVER_PROTOCOL_VERSION = 2;\n\nexport interface PiServerStaticContext {\n\tsystemPrompt?: string;\n\ttools?: Tool[];\n}\n\nexport function canonicalJsonStringify(value: unknown): string | undefined {\n\tif (Array.isArray(value)) {\n\t\treturn `[${Array.from(value, (item) => canonicalJsonStringify(item) ?? \"null\").join(\",\")}]`;\n\t}\n\tif (value !== null && typeof value === \"object\") {\n\t\tconst record = value as Record<string, unknown>;\n\t\tconst properties: string[] = [];\n\t\tfor (const key of Object.keys(record).sort()) {\n\t\t\tconst serialized = canonicalJsonStringify(record[key]);\n\t\t\tif (serialized !== undefined) {\n\t\t\t\tproperties.push(`${JSON.stringify(key)}:${serialized}`);\n\t\t\t}\n\t\t}\n\t\treturn `{${properties.join(\",\")}}`;\n\t}\n\treturn JSON.stringify(value);\n}\n\nexport function hashPiServerStaticContext(context: PiServerStaticContext | undefined): string {\n\tif (!context) return \"\";\n\tconst canonical = {\n\t\tsystemPrompt: context.systemPrompt,\n\t\ttools: context.tools?.map((tool) => ({\n\t\t\tname: tool.name,\n\t\t\tdescription: tool.description,\n\t\t\tparameters: tool.parameters,\n\t\t\tconstrainedSampling: tool.constrainedSampling,\n\t\t})),\n\t};\n\tconst serialized = canonicalJsonStringify(canonical);\n\tif (serialized === undefined) {\n\t\tthrow new Error(\"Failed to serialize pi-server static context\");\n\t}\n\treturn createHash(\"sha256\").update(serialized).digest(\"hex\");\n}\n\nexport const PI_SERVER_EMPTY_TREE_HASH = createHash(\"sha256\").update(\"pi-tree-v1\").digest(\"hex\");\n\nexport function hashPiServerTreeEntry(entry: SessionTreeEntry): string {\n\treturn createHash(\"sha256\").update(JSON.stringify(entry)).digest(\"hex\");\n}\n\nexport function appendPiServerTreeHash(previousHash: string, entryHash: string): string {\n\treturn createHash(\"sha256\").update(`${previousHash}:${entryHash}`).digest(\"hex\");\n}\n\nexport function buildPiServerTreePrefixHashes(entries: SessionTreeEntry[]): string[] {\n\tconst hashes = [PI_SERVER_EMPTY_TREE_HASH];\n\tfor (const entry of entries) {\n\t\thashes.push(appendPiServerTreeHash(hashes[hashes.length - 1], hashPiServerTreeEntry(entry)));\n\t}\n\treturn hashes;\n}\n\nexport function hashPiServerSessionEntries(entries: SessionTreeEntry[]): string {\n\treturn buildPiServerTreePrefixHashes(entries)[entries.length];\n}\n"]}
@@ -1,4 +1,22 @@
1
1
  import { createHash } from "node:crypto";
2
+ export const PI_SERVER_PROTOCOL_VERSION = 2;
3
+ export function canonicalJsonStringify(value) {
4
+ if (Array.isArray(value)) {
5
+ return `[${Array.from(value, (item) => canonicalJsonStringify(item) ?? "null").join(",")}]`;
6
+ }
7
+ if (value !== null && typeof value === "object") {
8
+ const record = value;
9
+ const properties = [];
10
+ for (const key of Object.keys(record).sort()) {
11
+ const serialized = canonicalJsonStringify(record[key]);
12
+ if (serialized !== undefined) {
13
+ properties.push(`${JSON.stringify(key)}:${serialized}`);
14
+ }
15
+ }
16
+ return `{${properties.join(",")}}`;
17
+ }
18
+ return JSON.stringify(value);
19
+ }
2
20
  export function hashPiServerStaticContext(context) {
3
21
  if (!context)
4
22
  return "";
@@ -8,9 +26,14 @@ export function hashPiServerStaticContext(context) {
8
26
  name: tool.name,
9
27
  description: tool.description,
10
28
  parameters: tool.parameters,
29
+ constrainedSampling: tool.constrainedSampling,
11
30
  })),
12
31
  };
13
- return createHash("sha256").update(JSON.stringify(canonical)).digest("hex");
32
+ const serialized = canonicalJsonStringify(canonical);
33
+ if (serialized === undefined) {
34
+ throw new Error("Failed to serialize pi-server static context");
35
+ }
36
+ return createHash("sha256").update(serialized).digest("hex");
14
37
  }
15
38
  export const PI_SERVER_EMPTY_TREE_HASH = createHash("sha256").update("pi-tree-v1").digest("hex");
16
39
  export function hashPiServerTreeEntry(entry) {
@@ -1 +1 @@
1
- {"version":3,"file":"pi-server-protocol.js","sourceRoot":"","sources":["../../src/core/pi-server-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AASzC,MAAM,UAAU,yBAAyB,CAAC,OAA0C,EAAU;IAC7F,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,MAAM,SAAS,GAAG;QACjB,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACpC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;SAC3B,CAAC,CAAC;KACH,CAAC;IACF,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAAA,CAC5E;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAEjG,MAAM,UAAU,qBAAqB,CAAC,KAAuB,EAAU;IACtE,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAAA,CACxE;AAED,MAAM,UAAU,sBAAsB,CAAC,YAAoB,EAAE,SAAiB,EAAU;IACvF,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,YAAY,IAAI,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAAA,CACjF;AAED,MAAM,UAAU,6BAA6B,CAAC,OAA2B,EAAY;IACpF,MAAM,MAAM,GAAG,CAAC,yBAAyB,CAAC,CAAC;IAC3C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,MAAM,CAAC;AAAA,CACd;AAED,MAAM,UAAU,0BAA0B,CAAC,OAA2B,EAAU;IAC/E,OAAO,6BAA6B,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AAAA,CAC9D","sourcesContent":["import { createHash } from \"node:crypto\";\nimport type { SessionTreeEntry } from \"@earendil-works/pi-agent-core\";\nimport type { Tool } from \"@earendil-works/pi-ai\";\n\nexport interface PiServerStaticContext {\n\tsystemPrompt?: string;\n\ttools?: Tool[];\n}\n\nexport function hashPiServerStaticContext(context: PiServerStaticContext | undefined): string {\n\tif (!context) return \"\";\n\tconst canonical = {\n\t\tsystemPrompt: context.systemPrompt,\n\t\ttools: context.tools?.map((tool) => ({\n\t\t\tname: tool.name,\n\t\t\tdescription: tool.description,\n\t\t\tparameters: tool.parameters,\n\t\t})),\n\t};\n\treturn createHash(\"sha256\").update(JSON.stringify(canonical)).digest(\"hex\");\n}\n\nexport const PI_SERVER_EMPTY_TREE_HASH = createHash(\"sha256\").update(\"pi-tree-v1\").digest(\"hex\");\n\nexport function hashPiServerTreeEntry(entry: SessionTreeEntry): string {\n\treturn createHash(\"sha256\").update(JSON.stringify(entry)).digest(\"hex\");\n}\n\nexport function appendPiServerTreeHash(previousHash: string, entryHash: string): string {\n\treturn createHash(\"sha256\").update(`${previousHash}:${entryHash}`).digest(\"hex\");\n}\n\nexport function buildPiServerTreePrefixHashes(entries: SessionTreeEntry[]): string[] {\n\tconst hashes = [PI_SERVER_EMPTY_TREE_HASH];\n\tfor (const entry of entries) {\n\t\thashes.push(appendPiServerTreeHash(hashes[hashes.length - 1], hashPiServerTreeEntry(entry)));\n\t}\n\treturn hashes;\n}\n\nexport function hashPiServerSessionEntries(entries: SessionTreeEntry[]): string {\n\treturn buildPiServerTreePrefixHashes(entries)[entries.length];\n}\n"]}
1
+ {"version":3,"file":"pi-server-protocol.js","sourceRoot":"","sources":["../../src/core/pi-server-protocol.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport type { SessionTreeEntry } from \"@earendil-works/pi-agent-core\";\nimport type { Tool } from \"@earendil-works/pi-ai\";\n\nexport const PI_SERVER_PROTOCOL_VERSION = 2;\n\nexport interface PiServerStaticContext {\n\tsystemPrompt?: string;\n\ttools?: Tool[];\n}\n\nexport function canonicalJsonStringify(value: unknown): string | undefined {\n\tif (Array.isArray(value)) {\n\t\treturn `[${Array.from(value, (item) => canonicalJsonStringify(item) ?? \"null\").join(\",\")}]`;\n\t}\n\tif (value !== null && typeof value === \"object\") {\n\t\tconst record = value as Record<string, unknown>;\n\t\tconst properties: string[] = [];\n\t\tfor (const key of Object.keys(record).sort()) {\n\t\t\tconst serialized = canonicalJsonStringify(record[key]);\n\t\t\tif (serialized !== undefined) {\n\t\t\t\tproperties.push(`${JSON.stringify(key)}:${serialized}`);\n\t\t\t}\n\t\t}\n\t\treturn `{${properties.join(\",\")}}`;\n\t}\n\treturn JSON.stringify(value);\n}\n\nexport function hashPiServerStaticContext(context: PiServerStaticContext | undefined): string {\n\tif (!context) return \"\";\n\tconst canonical = {\n\t\tsystemPrompt: context.systemPrompt,\n\t\ttools: context.tools?.map((tool) => ({\n\t\t\tname: tool.name,\n\t\t\tdescription: tool.description,\n\t\t\tparameters: tool.parameters,\n\t\t\tconstrainedSampling: tool.constrainedSampling,\n\t\t})),\n\t};\n\tconst serialized = canonicalJsonStringify(canonical);\n\tif (serialized === undefined) {\n\t\tthrow new Error(\"Failed to serialize pi-server static context\");\n\t}\n\treturn createHash(\"sha256\").update(serialized).digest(\"hex\");\n}\n\nexport const PI_SERVER_EMPTY_TREE_HASH = createHash(\"sha256\").update(\"pi-tree-v1\").digest(\"hex\");\n\nexport function hashPiServerTreeEntry(entry: SessionTreeEntry): string {\n\treturn createHash(\"sha256\").update(JSON.stringify(entry)).digest(\"hex\");\n}\n\nexport function appendPiServerTreeHash(previousHash: string, entryHash: string): string {\n\treturn createHash(\"sha256\").update(`${previousHash}:${entryHash}`).digest(\"hex\");\n}\n\nexport function buildPiServerTreePrefixHashes(entries: SessionTreeEntry[]): string[] {\n\tconst hashes = [PI_SERVER_EMPTY_TREE_HASH];\n\tfor (const entry of entries) {\n\t\thashes.push(appendPiServerTreeHash(hashes[hashes.length - 1], hashPiServerTreeEntry(entry)));\n\t}\n\treturn hashes;\n}\n\nexport function hashPiServerSessionEntries(entries: SessionTreeEntry[]): string {\n\treturn buildPiServerTreePrefixHashes(entries)[entries.length];\n}\n"]}
@@ -1,14 +1,42 @@
1
+ export declare const PI_SERVER_CHUNK_ACK_HEADER = "X-Pi-Chunk-Ack";
2
+ export declare const PI_SERVER_CHUNK_ACK_VALUE = "1";
3
+ export declare const PI_SERVER_CHUNK_FINAL_VALUE = "0";
4
+ export declare const PI_SERVER_CHUNK_SEGMENT_ENCODING = "base64-segment-v1";
5
+ export declare const PI_SERVER_RESPONSE_HEADER_TIMEOUT_MS = 30000;
1
6
  export interface PiServerRequestOptions {
2
7
  serverUrl: string;
3
8
  authToken: string;
4
9
  signal?: AbortSignal;
10
+ responseHeaderTimeoutMs?: number;
11
+ maxChunkRequestMemos?: number;
12
+ }
13
+ export declare class PiServerTransportHeaderTimeoutError extends Error {
14
+ readonly code = "PI_SERVER_TRANSPORT_HEADER_TIMEOUT";
15
+ readonly timeoutMs: number;
16
+ constructor(method: string, endpoint: string, timeoutMs: number);
17
+ }
18
+ export declare class PiServerChunkRequestMemoLimitError extends Error {
19
+ readonly code = "PI_SERVER_CHUNK_REQUEST_MEMO_LIMIT";
20
+ readonly limit: number;
21
+ constructor(limit: number);
22
+ }
23
+ export declare class PiServerChunkAckProtocolError extends Error {
24
+ constructor(message: string);
25
+ }
26
+ export declare class PiServerTransportBodyLimitError extends Error {
27
+ readonly code = "PI_SERVER_TRANSPORT_BODY_LIMIT";
28
+ readonly maxBytes: number;
29
+ constructor(maxBytes: number);
5
30
  }
6
31
  export declare function getMaxRequestBytes(): number;
32
+ export declare function readPiServerResponseText(response: Response, maxBytes?: number): Promise<string>;
33
+ export declare function readPiServerResponseJson(response: Response, maxBytes?: number): Promise<unknown>;
7
34
  export declare class ChunkRequest {
8
35
  #private;
9
36
  options: PiServerRequestOptions;
10
37
  constructor(options: PiServerRequestOptions);
11
38
  getJson(endpoint: string): Promise<Response>;
39
+ deleteJson(endpoint: string): Promise<Response>;
12
40
  postJson(endpoint: string, body: unknown): Promise<Response>;
13
41
  }
14
42
  //# sourceMappingURL=pi-server-request.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"pi-server-request.d.ts","sourceRoot":"","sources":["../../src/core/pi-server-request.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,sBAAsB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAsBD,wBAAgB,kBAAkB,IAAI,MAAM,CAS3C;AAwFD,qBAAa,YAAY;;IACxB,OAAO,EAAE,sBAAsB,CAAC;IAEhC,YAAY,OAAO,EAAE,sBAAsB,EAE1C;IAEK,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAMjD;IAEK,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAgDjE;CAUD","sourcesContent":["import { Buffer } from \"node:buffer\";\nimport { createHash, randomUUID } from \"node:crypto\";\n\nconst DEFAULT_MAX_REQUEST_KB = 512;\nconst CHUNK_ENDPOINT = \"/api/request/chunk\";\nconst CHUNK_UPLOAD_CONCURRENCY = 4;\n\nexport interface PiServerRequestOptions {\n\tserverUrl: string;\n\tauthToken: string;\n\tsignal?: AbortSignal;\n}\n\ninterface ChunkBody {\n\trequestId: string;\n\ttarget: string;\n\tchunkIndex: number;\n\ttotalChunks: number;\n\tsha256: string;\n\tchunk: string;\n}\n\ninterface ChunkAckBody {\n\treceived: unknown;\n\trequestId: unknown;\n\tchunkIndex: unknown;\n\ttotalChunks: unknown;\n}\n\nfunction jsonByteLength(value: unknown): number {\n\treturn Buffer.byteLength(JSON.stringify(value), \"utf-8\");\n}\n\nexport function getMaxRequestBytes(): number {\n\tconst raw = process.env.PI_CLIENT_MAX_REQUEST_KB;\n\tif (raw === undefined || raw === \"\") return DEFAULT_MAX_REQUEST_KB * 1024;\n\n\tconst value = Number(raw);\n\tif (!Number.isFinite(value) || value <= 0) {\n\t\tthrow new Error(\"PI_CLIENT_MAX_REQUEST_KB must be a positive number\");\n\t}\n\treturn Math.floor(value * 1024);\n}\n\nfunction makeHeaders(authToken: string): Record<string, string> {\n\treturn {\n\t\t\"Content-Type\": \"application/json\",\n\t\t...(authToken ? { Authorization: `Bearer ${authToken}` } : {}),\n\t};\n}\n\nfunction sha256(value: string): string {\n\treturn createHash(\"sha256\").update(value).digest(\"hex\");\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null;\n}\n\nfunction isChunkAckBody(value: unknown): value is ChunkAckBody {\n\treturn (\n\t\tisRecord(value) && \"received\" in value && \"requestId\" in value && \"chunkIndex\" in value && \"totalChunks\" in value\n\t);\n}\n\nasync function isChunkAck(\n\tresponse: Response,\n\trequestId: string,\n\tchunkIndex: number,\n\ttotalChunks: number,\n): Promise<boolean> {\n\tif (!response.headers.get(\"Content-Type\")?.includes(\"application/json\")) return false;\n\ttry {\n\t\tconst body = (await response.clone().json()) as unknown;\n\t\treturn (\n\t\t\tisChunkAckBody(body) &&\n\t\t\tbody.received === true &&\n\t\t\tbody.requestId === requestId &&\n\t\t\tbody.chunkIndex === chunkIndex &&\n\t\t\tbody.totalChunks === totalChunks\n\t\t);\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction chunkBodyFits(\n\ttarget: string,\n\trequestId: string,\n\tencodedLength: number,\n\tchunkLength: number,\n\tmaxBytes: number,\n): boolean {\n\tconst total = Math.ceil(encodedLength / chunkLength);\n\tconst body: ChunkBody = {\n\t\trequestId,\n\t\ttarget,\n\t\tchunkIndex: Math.max(0, total - 1),\n\t\ttotalChunks: total,\n\t\tsha256: \"0\".repeat(64),\n\t\tchunk: \"x\".repeat(Math.min(chunkLength, encodedLength)),\n\t};\n\treturn jsonByteLength(body) <= maxBytes;\n}\n\nfunction splitEncodedBody(target: string, requestId: string, encoded: string, maxBytes: number): string[] {\n\tif (!chunkBodyFits(target, requestId, encoded.length, 1, maxBytes)) {\n\t\tthrow new Error(\"PI_CLIENT_MAX_REQUEST_KB is too small for pi-server chunk envelopes\");\n\t}\n\n\tlet low = 1;\n\tlet high = encoded.length;\n\tlet best = 1;\n\twhile (low <= high) {\n\t\tconst mid = Math.floor((low + high) / 2);\n\t\tif (chunkBodyFits(target, requestId, encoded.length, mid, maxBytes)) {\n\t\t\tbest = mid;\n\t\t\tlow = mid + 1;\n\t\t} else {\n\t\t\thigh = mid - 1;\n\t\t}\n\t}\n\n\tconst chunks: string[] = [];\n\tfor (let offset = 0; offset < encoded.length; offset += best) {\n\t\tchunks.push(encoded.slice(offset, offset + best));\n\t}\n\treturn chunks;\n}\n\nexport class ChunkRequest {\n\toptions: PiServerRequestOptions;\n\n\tconstructor(options: PiServerRequestOptions) {\n\t\tthis.options = options;\n\t}\n\n\tasync getJson(endpoint: string): Promise<Response> {\n\t\treturn fetch(`${this.options.serverUrl}${endpoint}`, {\n\t\t\tmethod: \"GET\",\n\t\t\theaders: makeHeaders(this.options.authToken),\n\t\t\tsignal: this.options.signal,\n\t\t});\n\t}\n\n\tasync postJson(endpoint: string, body: unknown): Promise<Response> {\n\t\tconst rawJson = JSON.stringify(body);\n\t\tconst maxBytes = getMaxRequestBytes();\n\t\tif (Buffer.byteLength(rawJson, \"utf-8\") <= maxBytes) {\n\t\t\treturn this.#postRawJson(endpoint, rawJson);\n\t\t}\n\n\t\tconst requestId = randomUUID();\n\t\tconst encoded = Buffer.from(rawJson, \"utf-8\").toString(\"base64\");\n\t\tconst chunks = splitEncodedBody(endpoint, requestId, encoded, maxBytes);\n\t\tlet nextIndex = 0;\n\t\tlet finalResponse: Response | undefined;\n\t\tlet failureResponse: Response | undefined;\n\n\t\tconst uploadWorker = async (): Promise<void> => {\n\t\t\twhile (nextIndex < chunks.length && finalResponse === undefined && failureResponse === undefined) {\n\t\t\t\tconst index = nextIndex;\n\t\t\t\tnextIndex++;\n\t\t\t\tconst chunk = chunks[index];\n\t\t\t\tconst chunkBody: ChunkBody = {\n\t\t\t\t\trequestId,\n\t\t\t\t\ttarget: endpoint,\n\t\t\t\t\tchunkIndex: index,\n\t\t\t\t\ttotalChunks: chunks.length,\n\t\t\t\t\tsha256: sha256(chunk),\n\t\t\t\t\tchunk,\n\t\t\t\t};\n\t\t\t\tconst response = await this.#postRawJson(CHUNK_ENDPOINT, JSON.stringify(chunkBody));\n\t\t\t\tif (finalResponse !== undefined || failureResponse !== undefined) return;\n\t\t\t\tif (!response.ok) {\n\t\t\t\t\tfailureResponse = response;\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tif (!(await isChunkAck(response, requestId, index, chunks.length))) {\n\t\t\t\t\tfinalResponse = response;\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t}\n\t\t};\n\n\t\tawait Promise.all(\n\t\t\tArray.from({ length: Math.min(CHUNK_UPLOAD_CONCURRENCY, chunks.length) }, () => uploadWorker()),\n\t\t);\n\n\t\tif (failureResponse) return failureResponse;\n\t\tif (finalResponse) return finalResponse;\n\n\t\tthrow new Error(\"No final chunk response received from pi-server\");\n\t}\n\n\tasync #postRawJson(endpoint: string, rawJson: string): Promise<Response> {\n\t\treturn fetch(`${this.options.serverUrl}${endpoint}`, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: makeHeaders(this.options.authToken),\n\t\t\tbody: rawJson,\n\t\t\tsignal: this.options.signal,\n\t\t});\n\t}\n}\n"]}
1
+ {"version":3,"file":"pi-server-request.d.ts","sourceRoot":"","sources":["../../src/core/pi-server-request.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,0BAA0B,mBAAmB,CAAC;AAC3D,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAC/C,eAAO,MAAM,gCAAgC,sBAAsB,CAAC;AACpE,eAAO,MAAM,oCAAoC,QAAS,CAAC;AAE3D,MAAM,WAAW,sBAAsB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAoCD,qBAAa,mCAAoC,SAAQ,KAAK;IAC7D,QAAQ,CAAC,IAAI,wCAAwC;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,YAAY,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAI9D;CACD;AASD,qBAAa,kCAAmC,SAAQ,KAAK;IAC5D,QAAQ,CAAC,IAAI,wCAAwC;IACrD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,YAAY,KAAK,EAAE,MAAM,EAMxB;CACD;AAED,qBAAa,6BAA8B,SAAQ,KAAK;IACvD,YAAY,OAAO,EAAE,MAAM,EAG1B;CACD;AAED,qBAAa,+BAAgC,SAAQ,KAAK;IACzD,QAAQ,CAAC,IAAI,oCAAoC;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,YAAY,QAAQ,EAAE,MAAM,EAI3B;CACD;AAMD,wBAAgB,kBAAkB,IAAI,MAAM,CAS3C;AAsGD,wBAAsB,wBAAwB,CAC7C,QAAQ,EAAE,QAAQ,EAClB,QAAQ,SAA2B,GACjC,OAAO,CAAC,MAAM,CAAC,CA8BjB;AAED,wBAAsB,wBAAwB,CAC7C,QAAQ,EAAE,QAAQ,EAClB,QAAQ,SAA2B,GACjC,OAAO,CAAC,OAAO,CAAC,CAElB;AAmLD,qBAAa,YAAY;;IACxB,OAAO,EAAE,sBAAsB,CAAC;IAIhC,YAAY,OAAO,EAAE,sBAAsB,EAO1C;IAEK,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAKjD;IAEK,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAKpD;IAEK,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAyKjE;CAyCD","sourcesContent":["import { Buffer } from \"node:buffer\";\nimport { createHash, randomUUID } from \"node:crypto\";\n\nconst DEFAULT_MAX_REQUEST_KB = 512;\nconst CHUNK_ENDPOINT = \"/api/request/chunk\";\nconst CHUNK_UPLOAD_CONCURRENCY = 4;\nconst CHUNK_MAX_TOTAL_CHUNKS = 4096;\nconst CHUNK_UPLOAD_RETRY_DELAYS_MS = [100, 250, 500] as const;\nconst LEGACY_CHUNK_ACK_MAX_BYTES = 4096;\nconst DEFAULT_CHUNK_REQUEST_MEMO_LIMIT = 128;\nconst DEFAULT_RESPONSE_NO_PROGRESS_TIMEOUT_MS = 90_000;\nexport const PI_SERVER_CHUNK_ACK_HEADER = \"X-Pi-Chunk-Ack\";\nexport const PI_SERVER_CHUNK_ACK_VALUE = \"1\";\nexport const PI_SERVER_CHUNK_FINAL_VALUE = \"0\";\nexport const PI_SERVER_CHUNK_SEGMENT_ENCODING = \"base64-segment-v1\";\nexport const PI_SERVER_RESPONSE_HEADER_TIMEOUT_MS = 30_000;\n\nexport interface PiServerRequestOptions {\n\tserverUrl: string;\n\tauthToken: string;\n\tsignal?: AbortSignal;\n\tresponseHeaderTimeoutMs?: number;\n\tmaxChunkRequestMemos?: number;\n}\n\ninterface ChunkBody {\n\trequestId: string;\n\ttarget: string;\n\tchunkIndex: number;\n\ttotalChunks: number;\n\tsha256: string;\n\tchunk: string;\n\tencoding: typeof PI_SERVER_CHUNK_SEGMENT_ENCODING;\n\trawTotalBytes: number;\n\trawChunkBytes: number;\n}\n\ninterface ChunkAckBody {\n\treceived: unknown;\n\trequestId: unknown;\n\tchunkIndex: unknown;\n\ttotalChunks: unknown;\n}\n\ninterface ChunkRequestMemo {\n\trequestId: string;\n\tmaxBytes: number;\n}\n\ninterface ChunkResponseInspection {\n\tacknowledged: boolean;\n\tresponse?: Response;\n}\n\ninterface BodyNoProgressState {\n\treadonly timeoutMs: number;\n\tdeadlineMs: number;\n}\n\nexport class PiServerTransportHeaderTimeoutError extends Error {\n\treadonly code = \"PI_SERVER_TRANSPORT_HEADER_TIMEOUT\";\n\treadonly timeoutMs: number;\n\n\tconstructor(method: string, endpoint: string, timeoutMs: number) {\n\t\tsuper(`pi-server transport header timeout after ${timeoutMs} ms (ETIMEDOUT): ${method} ${endpoint}`);\n\t\tthis.name = \"PiServerTransportHeaderTimeoutError\";\n\t\tthis.timeoutMs = timeoutMs;\n\t}\n}\n\nclass PiServerTransportBodyNoProgressError extends Error {\n\tconstructor(timeoutMs: number) {\n\t\tsuper(`pi-server response made no progress for ${timeoutMs}ms`);\n\t\tthis.name = \"PiServerTransportBodyNoProgressError\";\n\t}\n}\n\nexport class PiServerChunkRequestMemoLimitError extends Error {\n\treadonly code = \"PI_SERVER_CHUNK_REQUEST_MEMO_LIMIT\";\n\treadonly limit: number;\n\n\tconstructor(limit: number) {\n\t\tsuper(\n\t\t\t`pi-server chunk request identity limit (${limit}) reached; refusing to allocate a new requestId while prior requests remain uncertain`,\n\t\t);\n\t\tthis.name = \"PiServerChunkRequestMemoLimitError\";\n\t\tthis.limit = limit;\n\t}\n}\n\nexport class PiServerChunkAckProtocolError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"PiServerChunkAckProtocolError\";\n\t}\n}\n\nexport class PiServerTransportBodyLimitError extends Error {\n\treadonly code = \"PI_SERVER_TRANSPORT_BODY_LIMIT\";\n\treadonly maxBytes: number;\n\n\tconstructor(maxBytes: number) {\n\t\tsuper(`pi-server response body exceeded ${maxBytes} bytes`);\n\t\tthis.name = \"PiServerTransportBodyLimitError\";\n\t\tthis.maxBytes = maxBytes;\n\t}\n}\n\nfunction jsonByteLength(value: unknown): number {\n\treturn Buffer.byteLength(JSON.stringify(value), \"utf-8\");\n}\n\nexport function getMaxRequestBytes(): number {\n\tconst raw = process.env.PI_CLIENT_MAX_REQUEST_KB;\n\tif (raw === undefined || raw === \"\") return DEFAULT_MAX_REQUEST_KB * 1024;\n\n\tconst value = Number(raw);\n\tif (!Number.isFinite(value) || value <= 0) {\n\t\tthrow new Error(\"PI_CLIENT_MAX_REQUEST_KB must be a positive number\");\n\t}\n\treturn Math.floor(value * 1024);\n}\n\nfunction makeHeaders(authToken: string): Record<string, string> {\n\treturn {\n\t\t\"Content-Type\": \"application/json\",\n\t\t...(authToken ? { Authorization: `Bearer ${authToken}` } : {}),\n\t};\n}\n\nfunction sha256(value: string | Uint8Array): string {\n\treturn createHash(\"sha256\").update(value).digest(\"hex\");\n}\n\nfunction isTransientChunkResponse(status: number): boolean {\n\treturn status === 408 || status === 425 || status === 429 || status >= 500;\n}\n\nfunction waitForChunkRetry(delayMs: number, signal?: AbortSignal): Promise<void> {\n\tif (signal?.aborted) return Promise.reject(signal.reason);\n\n\treturn new Promise((resolve, reject) => {\n\t\tconst timeout = setTimeout(() => {\n\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t\tresolve();\n\t\t}, delayMs);\n\t\tconst onAbort = () => {\n\t\t\tclearTimeout(timeout);\n\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t\treject(signal?.reason ?? new DOMException(\"The operation was aborted\", \"AbortError\"));\n\t\t};\n\t\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\n\t});\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null;\n}\n\nfunction isChunkAckBody(value: unknown): value is ChunkAckBody {\n\treturn (\n\t\tisRecord(value) && \"received\" in value && \"requestId\" in value && \"chunkIndex\" in value && \"totalChunks\" in value\n\t);\n}\n\nfunction getResponseNoProgressTimeoutMs(): number {\n\tconst raw = process.env.PI_SERVER_RESPONSE_NO_PROGRESS_TIMEOUT_MS;\n\tconst value = raw === undefined ? DEFAULT_RESPONSE_NO_PROGRESS_TIMEOUT_MS : Number(raw);\n\tif (!Number.isFinite(value) || value <= 0) {\n\t\tthrow new Error(\"PI_SERVER_RESPONSE_NO_PROGRESS_TIMEOUT_MS must be positive finite milliseconds\");\n\t}\n\treturn value;\n}\n\nfunction createBodyNoProgressState(): BodyNoProgressState {\n\tconst timeoutMs = getResponseNoProgressTimeoutMs();\n\treturn { timeoutMs, deadlineMs: Date.now() + timeoutMs };\n}\n\nasync function readPiServerBodyChunk(\n\treader: ReadableStreamDefaultReader<Uint8Array>,\n\tstate: BodyNoProgressState,\n): Promise<Awaited<ReturnType<ReadableStreamDefaultReader<Uint8Array>[\"read\"]>>> {\n\twhile (true) {\n\t\tconst remainingMs = state.deadlineMs - Date.now();\n\t\tif (remainingMs <= 0) {\n\t\t\tthrow new PiServerTransportBodyNoProgressError(state.timeoutMs);\n\t\t}\n\t\tconst result = await new Promise<Awaited<ReturnType<ReadableStreamDefaultReader<Uint8Array>[\"read\"]>>>(\n\t\t\t(resolve, reject) => {\n\t\t\t\tlet settled = false;\n\t\t\t\tconst timeout = setTimeout(() => {\n\t\t\t\t\tif (settled) return;\n\t\t\t\t\tsettled = true;\n\t\t\t\t\treject(new PiServerTransportBodyNoProgressError(state.timeoutMs));\n\t\t\t\t}, remainingMs);\n\t\t\t\ttimeout.unref();\n\t\t\t\tvoid reader.read().then(\n\t\t\t\t\t(value) => {\n\t\t\t\t\t\tif (settled) return;\n\t\t\t\t\t\tsettled = true;\n\t\t\t\t\t\tclearTimeout(timeout);\n\t\t\t\t\t\tresolve(value);\n\t\t\t\t\t},\n\t\t\t\t\t(error: unknown) => {\n\t\t\t\t\t\tif (settled) return;\n\t\t\t\t\t\tsettled = true;\n\t\t\t\t\t\tclearTimeout(timeout);\n\t\t\t\t\t\treject(error);\n\t\t\t\t\t},\n\t\t\t\t);\n\t\t\t},\n\t\t);\n\t\tif (result.done || result.value.byteLength > 0) {\n\t\t\tif (!result.done) state.deadlineMs = Date.now() + state.timeoutMs;\n\t\t\treturn result;\n\t\t}\n\t\tawait new Promise<void>((resolve) => {\n\t\t\tsetTimeout(resolve, 0);\n\t\t});\n\t}\n}\n\nexport async function readPiServerResponseText(\n\tresponse: Response,\n\tmaxBytes = Number.POSITIVE_INFINITY,\n): Promise<string> {\n\tif (\n\t\t(maxBytes !== Number.POSITIVE_INFINITY && (!Number.isSafeInteger(maxBytes) || maxBytes <= 0)) ||\n\t\tmaxBytes === Number.NEGATIVE_INFINITY\n\t) {\n\t\tthrow new Error(\"pi-server response body limit must be positive safe-integer bytes or Infinity\");\n\t}\n\tif (!response.body) throw new Error(\"pi-server response body was missing\");\n\tconst reader = response.body.getReader();\n\tconst decoder = new TextDecoder();\n\tconst noProgress = createBodyNoProgressState();\n\tlet body = \"\";\n\tlet bodyBytes = 0;\n\ttry {\n\t\twhile (true) {\n\t\t\tconst result = await readPiServerBodyChunk(reader, noProgress);\n\t\t\tif (result.done) {\n\t\t\t\tbody += decoder.decode();\n\t\t\t\treturn body;\n\t\t\t}\n\t\t\tbodyBytes += result.value.byteLength;\n\t\t\tif (bodyBytes > maxBytes) {\n\t\t\t\tthrow new PiServerTransportBodyLimitError(maxBytes);\n\t\t\t}\n\t\t\tbody += decoder.decode(result.value, { stream: true });\n\t\t}\n\t} catch (error) {\n\t\tvoid reader.cancel().catch(() => undefined);\n\t\tthrow error;\n\t}\n}\n\nexport async function readPiServerResponseJson(\n\tresponse: Response,\n\tmaxBytes = Number.POSITIVE_INFINITY,\n): Promise<unknown> {\n\treturn JSON.parse(await readPiServerResponseText(response, maxBytes)) as unknown;\n}\n\nfunction rebuildResponse(response: Response, body: ConstructorParameters<typeof Response>[0]): Response {\n\treturn new Response(body, {\n\t\tstatus: response.status,\n\t\tstatusText: response.statusText,\n\t\theaders: response.headers,\n\t});\n}\n\nasync function discardResponse(response: Response | undefined): Promise<void> {\n\tif (!response?.body || response.bodyUsed || response.body.locked) return;\n\ttry {\n\t\tawait response.body.cancel();\n\t} catch {\n\t\t// The response is already unusable and must not replace the selected final response.\n\t}\n}\n\nasync function inspectLegacyChunkAck(\n\tresponse: Response,\n\trequestId: string,\n\tchunkIndex: number,\n\ttotalChunks: number,\n): Promise<ChunkResponseInspection> {\n\tconst contentLength = Number(response.headers.get(\"Content-Length\"));\n\tif (Number.isFinite(contentLength) && contentLength > LEGACY_CHUNK_ACK_MAX_BYTES) {\n\t\treturn { acknowledged: false, response };\n\t}\n\tif (!response.body) return { acknowledged: false, response };\n\tconst reader = response.body.getReader();\n\tconst noProgress = createBodyNoProgressState();\n\tconst chunks: Uint8Array[] = [];\n\tlet bodyBytes = 0;\n\ttry {\n\t\twhile (true) {\n\t\t\tconst result = await readPiServerBodyChunk(reader, noProgress);\n\t\t\tif (result.done) break;\n\t\t\tchunks.push(result.value);\n\t\t\tbodyBytes += result.value.byteLength;\n\t\t\tif (bodyBytes > LEGACY_CHUNK_ACK_MAX_BYTES) {\n\t\t\t\tlet prefixIndex = 0;\n\t\t\t\tconst rebuiltBody = new ReadableStream<Uint8Array>({\n\t\t\t\t\tasync pull(controller) {\n\t\t\t\t\t\tif (prefixIndex < chunks.length) {\n\t\t\t\t\t\t\tconst prefix = chunks[prefixIndex];\n\t\t\t\t\t\t\tchunks[prefixIndex] = new Uint8Array();\n\t\t\t\t\t\t\tprefixIndex++;\n\t\t\t\t\t\t\tcontroller.enqueue(prefix);\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tconst next = await readPiServerBodyChunk(reader, noProgress);\n\t\t\t\t\t\t\tif (next.done) {\n\t\t\t\t\t\t\t\tcontroller.close();\n\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\tcontroller.enqueue(next.value);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\tcontroller.error(error);\n\t\t\t\t\t\t\tvoid reader.cancel(error).catch(() => undefined);\n\t\t\t\t\t\t}\n\t\t\t\t\t},\n\t\t\t\t\tcancel(reason) {\n\t\t\t\t\t\treturn reader.cancel(reason);\n\t\t\t\t\t},\n\t\t\t\t});\n\t\t\t\treturn { acknowledged: false, response: rebuildResponse(response, rebuiltBody) };\n\t\t\t}\n\t\t}\n\t} catch (error) {\n\t\tvoid reader.cancel().catch(() => undefined);\n\t\tthrow error;\n\t}\n\n\tconst encoded = Buffer.concat(\n\t\tchunks.map((chunk) => Buffer.from(chunk)),\n\t\tbodyBytes,\n\t);\n\tconst rebuilt = rebuildResponse(response, encoded);\n\ttry {\n\t\tconst body = JSON.parse(encoded.toString(\"utf-8\")) as unknown;\n\t\tconst acknowledged =\n\t\t\tisChunkAckBody(body) &&\n\t\t\tbody.received === true &&\n\t\t\tbody.requestId === requestId &&\n\t\t\tbody.chunkIndex === chunkIndex &&\n\t\t\tbody.totalChunks === totalChunks;\n\t\treturn acknowledged ? { acknowledged: true } : { acknowledged: false, response: rebuilt };\n\t} catch {\n\t\treturn { acknowledged: false, response: rebuilt };\n\t}\n}\n\nasync function inspectChunkResponse(\n\tresponse: Response,\n\trequestId: string,\n\tchunkIndex: number,\n\ttotalChunks: number,\n): Promise<ChunkResponseInspection> {\n\tconst marker = response.headers.get(PI_SERVER_CHUNK_ACK_HEADER);\n\tif (marker === PI_SERVER_CHUNK_FINAL_VALUE) {\n\t\treturn { acknowledged: false, response };\n\t}\n\tif (marker === PI_SERVER_CHUNK_ACK_VALUE) {\n\t\tif (!response.headers.get(\"Content-Type\")?.includes(\"application/json\")) {\n\t\t\tawait discardResponse(response);\n\t\t\tthrow new PiServerChunkAckProtocolError(\"pi-server chunk acknowledgement must use application/json\");\n\t\t}\n\t\tconst text = await readPiServerResponseText(response, LEGACY_CHUNK_ACK_MAX_BYTES);\n\t\tlet body: unknown;\n\t\ttry {\n\t\t\tbody = JSON.parse(text) as unknown;\n\t\t} catch {\n\t\t\tthrow new PiServerChunkAckProtocolError(\"pi-server chunk acknowledgement was not valid JSON\");\n\t\t}\n\t\tif (\n\t\t\t!isChunkAckBody(body) ||\n\t\t\tbody.received !== true ||\n\t\t\tbody.requestId !== requestId ||\n\t\t\tbody.chunkIndex !== chunkIndex ||\n\t\t\tbody.totalChunks !== totalChunks\n\t\t) {\n\t\t\tthrow new PiServerChunkAckProtocolError(\"pi-server chunk acknowledgement did not match its request envelope\");\n\t\t}\n\t\treturn { acknowledged: true };\n\t}\n\tif (marker !== null) {\n\t\tawait discardResponse(response);\n\t\tthrow new PiServerChunkAckProtocolError(\n\t\t\t`pi-server returned unsupported ${PI_SERVER_CHUNK_ACK_HEADER} value: ${marker}`,\n\t\t);\n\t}\n\tif (!response.headers.get(\"Content-Type\")?.includes(\"application/json\")) {\n\t\treturn { acknowledged: false, response };\n\t}\n\treturn inspectLegacyChunkAck(response, requestId, chunkIndex, totalChunks);\n}\n\nfunction getRawChunkLayout(\n\ttarget: string,\n\trequestId: string,\n\trawBodyBytes: number,\n\tmaxBytes: number,\n): { rawChunkBytes: number; totalChunks: number } {\n\tlet totalChunks = 1;\n\twhile (true) {\n\t\tconst emptyEnvelopeBytes = jsonByteLength({\n\t\t\trequestId,\n\t\t\ttarget,\n\t\t\tchunkIndex: totalChunks - 1,\n\t\t\ttotalChunks,\n\t\t\tsha256: \"0\".repeat(64),\n\t\t\tchunk: \"\",\n\t\t\tencoding: PI_SERVER_CHUNK_SEGMENT_ENCODING,\n\t\t\trawTotalBytes: rawBodyBytes,\n\t\t\t// Using the total body size here is conservative because every\n\t\t\t// derived chunk size is no larger and therefore has no more digits.\n\t\t\trawChunkBytes: rawBodyBytes,\n\t\t} satisfies ChunkBody);\n\t\tconst encodedChunkBytes = Math.floor((maxBytes - emptyEnvelopeBytes) / 4) * 4;\n\t\tconst rawChunkBytes = Math.floor(encodedChunkBytes / 4) * 3;\n\t\tif (rawChunkBytes <= 0) {\n\t\t\tthrow new Error(\"PI_CLIENT_MAX_REQUEST_KB is too small for pi-server chunk envelopes\");\n\t\t}\n\t\tconst nextTotalChunks = Math.ceil(rawBodyBytes / rawChunkBytes);\n\t\tif (nextTotalChunks > CHUNK_MAX_TOTAL_CHUNKS) {\n\t\t\tthrow new Error(`pi-server chunk request exceeds the ${CHUNK_MAX_TOTAL_CHUNKS}-chunk protocol limit`);\n\t\t}\n\t\tif (nextTotalChunks === totalChunks) {\n\t\t\treturn { rawChunkBytes, totalChunks };\n\t\t}\n\t\tif (nextTotalChunks < totalChunks) {\n\t\t\tthrow new Error(\"pi-server chunk layout did not converge monotonically\");\n\t\t}\n\t\ttotalChunks = nextTotalChunks;\n\t}\n}\n\nexport class ChunkRequest {\n\toptions: PiServerRequestOptions;\n\treadonly #chunkRequestMemos = new Map<string, ChunkRequestMemo>();\n\treadonly #maxChunkRequestMemos: number;\n\n\tconstructor(options: PiServerRequestOptions) {\n\t\tconst maxChunkRequestMemos = options.maxChunkRequestMemos ?? DEFAULT_CHUNK_REQUEST_MEMO_LIMIT;\n\t\tif (!Number.isSafeInteger(maxChunkRequestMemos) || maxChunkRequestMemos <= 0) {\n\t\t\tthrow new Error(\"maxChunkRequestMemos must be a positive safe integer\");\n\t\t}\n\t\tthis.options = options;\n\t\tthis.#maxChunkRequestMemos = maxChunkRequestMemos;\n\t}\n\n\tasync getJson(endpoint: string): Promise<Response> {\n\t\treturn this.#fetchWithResponseHeaderTimeout(endpoint, {\n\t\t\tmethod: \"GET\",\n\t\t\theaders: makeHeaders(this.options.authToken),\n\t\t});\n\t}\n\n\tasync deleteJson(endpoint: string): Promise<Response> {\n\t\treturn this.#fetchWithResponseHeaderTimeout(endpoint, {\n\t\t\tmethod: \"DELETE\",\n\t\t\theaders: makeHeaders(this.options.authToken),\n\t\t});\n\t}\n\n\tasync postJson(endpoint: string, body: unknown): Promise<Response> {\n\t\tconst rawBody = Buffer.from(JSON.stringify(body), \"utf-8\");\n\t\tconst memoKey = `${endpoint}\\0${sha256(rawBody)}`;\n\t\tlet memo = this.#chunkRequestMemos.get(memoKey);\n\t\tconst maxBytes = memo?.maxBytes ?? getMaxRequestBytes();\n\t\tif (memo === undefined && rawBody.byteLength <= maxBytes) {\n\t\t\treturn this.#postRawJson(endpoint, rawBody.toString(\"utf-8\"));\n\t\t}\n\n\t\tif (memo === undefined) {\n\t\t\tif (this.#chunkRequestMemos.size >= this.#maxChunkRequestMemos) {\n\t\t\t\tthrow new PiServerChunkRequestMemoLimitError(this.#maxChunkRequestMemos);\n\t\t\t}\n\t\t\tmemo = { requestId: randomUUID(), maxBytes };\n\t\t\tthis.#chunkRequestMemos.set(memoKey, memo);\n\t\t}\n\n\t\tconst { requestId } = memo;\n\t\tlet layout: { rawChunkBytes: number; totalChunks: number };\n\t\ttry {\n\t\t\tlayout = getRawChunkLayout(endpoint, requestId, rawBody.byteLength, memo.maxBytes);\n\t\t} catch (error) {\n\t\t\tif (this.#chunkRequestMemos.get(memoKey) === memo) {\n\t\t\t\tthis.#chunkRequestMemos.delete(memoKey);\n\t\t\t}\n\t\t\tthrow error;\n\t\t}\n\t\tlet nextIndex = 0;\n\t\tlet finalResponse: Response | undefined;\n\t\tlet transientFailureResponse: Response | undefined;\n\t\tlet fatalError: unknown;\n\n\t\tconst stopped = () => finalResponse !== undefined || fatalError !== undefined;\n\t\tconst replaceTransientFailureResponse = async (response: Response): Promise<void> => {\n\t\t\tconst previous = transientFailureResponse;\n\t\t\ttransientFailureResponse = response;\n\t\t\tif (previous !== response) await discardResponse(previous);\n\t\t};\n\n\t\tconst uploadChunk = async (index: number): Promise<void> => {\n\t\t\tconst start = index * layout.rawChunkBytes;\n\t\t\tconst chunk = rawBody\n\t\t\t\t.subarray(start, Math.min(start + layout.rawChunkBytes, rawBody.byteLength))\n\t\t\t\t.toString(\"base64\");\n\t\t\tlet lastError: unknown;\n\t\t\tlet lastTransientResponse: Response | undefined;\n\n\t\t\ttry {\n\t\t\t\tfor (let attempt = 0; attempt <= CHUNK_UPLOAD_RETRY_DELAYS_MS.length; attempt++) {\n\t\t\t\t\tif (stopped()) return;\n\t\t\t\t\tif (attempt > 0) {\n\t\t\t\t\t\tawait waitForChunkRetry(CHUNK_UPLOAD_RETRY_DELAYS_MS[attempt - 1], this.options.signal);\n\t\t\t\t\t\tif (stopped()) return;\n\t\t\t\t\t}\n\n\t\t\t\t\tconst chunkBody: ChunkBody = {\n\t\t\t\t\t\trequestId,\n\t\t\t\t\t\ttarget: endpoint,\n\t\t\t\t\t\tchunkIndex: index,\n\t\t\t\t\t\ttotalChunks: layout.totalChunks,\n\t\t\t\t\t\tsha256: sha256(chunk),\n\t\t\t\t\t\tchunk,\n\t\t\t\t\t\tencoding: PI_SERVER_CHUNK_SEGMENT_ENCODING,\n\t\t\t\t\t\trawTotalBytes: rawBody.byteLength,\n\t\t\t\t\t\trawChunkBytes: layout.rawChunkBytes,\n\t\t\t\t\t};\n\n\t\t\t\t\ttry {\n\t\t\t\t\t\tlet response = await this.#postRawJson(CHUNK_ENDPOINT, JSON.stringify(chunkBody));\n\t\t\t\t\t\tif (stopped()) {\n\t\t\t\t\t\t\tawait discardResponse(response);\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (response.ok) {\n\t\t\t\t\t\t\tconst inspection = await inspectChunkResponse(response, requestId, index, layout.totalChunks);\n\t\t\t\t\t\t\tif (inspection.acknowledged) return;\n\t\t\t\t\t\t\tif (!inspection.response) {\n\t\t\t\t\t\t\t\tthrow new PiServerChunkAckProtocolError(\n\t\t\t\t\t\t\t\t\t\"pi-server chunk response inspection lost its response\",\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tresponse = inspection.response;\n\t\t\t\t\t\t\tif (stopped()) {\n\t\t\t\t\t\t\t\tawait discardResponse(response);\n\t\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (isTransientChunkResponse(response.status)) {\n\t\t\t\t\t\t\tawait discardResponse(lastTransientResponse);\n\t\t\t\t\t\t\tlastTransientResponse = response;\n\t\t\t\t\t\t\tlastError = new Error(\n\t\t\t\t\t\t\t\t`pi-server chunk ${index + 1}/${layout.totalChunks} returned HTTP ${response.status}`,\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (finalResponse === undefined && fatalError === undefined) {\n\t\t\t\t\t\t\tfinalResponse = response;\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tawait discardResponse(response);\n\t\t\t\t\t\t}\n\t\t\t\t\t\treturn;\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\tif (this.options.signal?.aborted) {\n\t\t\t\t\t\t\tthrow this.options.signal.reason ?? error;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (\n\t\t\t\t\t\t\terror instanceof PiServerChunkAckProtocolError ||\n\t\t\t\t\t\t\terror instanceof PiServerTransportBodyLimitError\n\t\t\t\t\t\t) {\n\t\t\t\t\t\t\tfatalError = error;\n\t\t\t\t\t\t\tthrow error;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tlastError = error;\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tif (lastTransientResponse !== undefined) {\n\t\t\t\t\tawait replaceTransientFailureResponse(lastTransientResponse);\n\t\t\t\t\tlastTransientResponse = undefined;\n\t\t\t\t}\n\t\t\t\tif (lastError instanceof Error) {\n\t\t\t\t\tthrow lastError;\n\t\t\t\t}\n\t\t\t\tthrow new Error(`pi-server chunk ${index + 1}/${layout.totalChunks} failed after bounded retries`);\n\t\t\t} finally {\n\t\t\t\tif (stopped()) await discardResponse(lastTransientResponse);\n\t\t\t}\n\t\t};\n\n\t\tconst uploadWorker = async (): Promise<void> => {\n\t\t\twhile (!stopped()) {\n\t\t\t\tconst index = nextIndex;\n\t\t\t\tif (index >= layout.totalChunks) return;\n\t\t\t\tnextIndex++;\n\t\t\t\tawait uploadChunk(index);\n\t\t\t}\n\t\t};\n\n\t\tconst results = await Promise.allSettled(\n\t\t\tArray.from({ length: Math.min(CHUNK_UPLOAD_CONCURRENCY, layout.totalChunks) }, () => uploadWorker()),\n\t\t);\n\n\t\tif (fatalError !== undefined) {\n\t\t\tawait discardResponse(finalResponse);\n\t\t\tawait discardResponse(transientFailureResponse);\n\t\t\tthrow fatalError;\n\t\t}\n\t\tif (this.options.signal?.aborted) {\n\t\t\tawait discardResponse(finalResponse);\n\t\t\tawait discardResponse(transientFailureResponse);\n\t\t\tthrow this.options.signal.reason ?? new DOMException(\"The operation was aborted\", \"AbortError\");\n\t\t}\n\t\tif (finalResponse !== undefined) {\n\t\t\tawait discardResponse(transientFailureResponse);\n\t\t\tif (this.#chunkRequestMemos.get(memoKey) === memo) {\n\t\t\t\tthis.#chunkRequestMemos.delete(memoKey);\n\t\t\t}\n\t\t\treturn finalResponse;\n\t\t}\n\t\tif (transientFailureResponse !== undefined) {\n\t\t\treturn transientFailureResponse;\n\t\t}\n\t\tfor (const result of results) {\n\t\t\tif (result.status === \"rejected\") {\n\t\t\t\tthrow result.reason;\n\t\t\t}\n\t\t}\n\n\t\tthrow new Error(\"No final chunk response received from pi-server\");\n\t}\n\n\tasync #postRawJson(endpoint: string, rawJson: string): Promise<Response> {\n\t\treturn this.#fetchWithResponseHeaderTimeout(endpoint, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: makeHeaders(this.options.authToken),\n\t\t\tbody: rawJson,\n\t\t});\n\t}\n\n\tasync #fetchWithResponseHeaderTimeout(endpoint: string, init: RequestInit): Promise<Response> {\n\t\tconst timeoutMs = this.options.responseHeaderTimeoutMs ?? PI_SERVER_RESPONSE_HEADER_TIMEOUT_MS;\n\t\tif (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {\n\t\t\tthrow new Error(\"responseHeaderTimeoutMs must be a positive finite number\");\n\t\t}\n\n\t\tconst method = init.method ?? \"GET\";\n\t\tconst timeoutError = new PiServerTransportHeaderTimeoutError(method, endpoint, timeoutMs);\n\t\tconst timeoutController = new AbortController();\n\t\tconst signal = this.options.signal\n\t\t\t? AbortSignal.any([this.options.signal, timeoutController.signal])\n\t\t\t: timeoutController.signal;\n\t\tconst timeout = setTimeout(() => {\n\t\t\ttimeoutController.abort(timeoutError);\n\t\t}, timeoutMs);\n\t\ttimeout.unref();\n\n\t\ttry {\n\t\t\treturn await fetch(`${this.options.serverUrl}${endpoint}`, {\n\t\t\t\t...init,\n\t\t\t\tsignal,\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tif (timeoutController.signal.aborted && !this.options.signal?.aborted) {\n\t\t\t\tthrow timeoutError;\n\t\t\t}\n\t\t\tthrow error;\n\t\t} finally {\n\t\t\tclearTimeout(timeout);\n\t\t}\n\t}\n}\n"]}