@averyyy/pi-server 0.80.3-piclient.10

package/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+## [Unreleased]
+
+### Added
+
+- Initial pi-server package: HTTP proxy server that stores session state and forwards incremental LLM requests to upstream providers.
+- `/api/session/init` endpoint for initializing session static context.
+- `/api/session/update` endpoint for updating session static context.
+- `GET /api/session/:id/history` endpoint for reading full server-side session history without a request body.
+- `/api/stream` endpoint for streaming incremental LLM requests with delta messages.
+- `/api/request/chunk` endpoint for reassembling oversized client requests before dispatch.
+- `DELETE /api/session/:id` endpoint for removing one server-side session.
+- `/health` endpoint for health checks.
+- `pi-server update` command with npm global package updates.
+- Configurable via `PI_SERVER_CONFIG` or environment variables: `PI_SERVER_HOST`, `PI_SERVER_PORT`, `PI_SERVER_AUTH_TOKEN`.
+- Persistent session tree storage under `PI_SERVER_SESSION_STORE_DIR`, including exact tree hashes in session responses.
+
+### Fixed
+
+- Used `--legacy-peer-deps` for npm-global fork updates so existing upstream Pi installs do not trigger peer override warnings for forked prerelease aliases.

package/README.md

@@ -0,0 +1,46 @@
+# @averyyy/pi-server
+
+Server for `@averyyy/pi-client`. It stores session state and forwards client requests to upstream model providers.
+
+## Install
+
+```bash
+npm i -g @averyyy/pi-server
+```
+
+## Start
+
+```bash
+pi-server
+```
+
+By default it listens on `http://127.0.0.1:4217` and stores sessions under `.pi/pi-server/sessions` in the current directory.
+
+## Configure
+
+Set provider keys in the server environment, then start the server:
+
+```bash
+OPENAI_API_KEY=your-key pi-server
+```
+
+Useful server settings:
+
+```bash
+PI_SERVER_HOST=127.0.0.1
+PI_SERVER_PORT=4217
+PI_SERVER_AUTH_TOKEN=your-token
+PI_SERVER_SESSION_STORE_DIR=/path/to/sessions
+```
+
+## Connect A Client
+
+```bash
+PI_SERVER_URL=http://127.0.0.1:4217 pi-client
+```
+
+With auth:
+
+```bash
+PI_SERVER_AUTH_TOKEN=your-token PI_SERVER_URL=http://127.0.0.1:4217 pi-client
+```

package/bin/pi-server.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const args = process.argv.slice(2);
+const modulePromise =
+	args[0] === "update"
+		? import("./update.js").then(async ({ runPiServerUpdate }) => {
+				process.exitCode = await runPiServerUpdate(args.slice(1));
+			})
+		: runPiServer(args);
+
+Promise.resolve(modulePromise).catch((e) => {
+	console.error(e);
+	process.exit(1);
+});
+
+function runPiServer(args) {
+	const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+	const result = spawnSync(process.execPath, [join(packageRoot, "dist", "cli.js"), ...args], {
+		stdio: "inherit",
+	});
+	if (result.error) throw result.error;
+	process.exitCode = result.status ?? (result.signal === "SIGINT" ? 130 : 1);
+}

package/bin/update.js

@@ -0,0 +1,86 @@
+import { spawnSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+function defaultPackageRoot() {
+	return dirname(dirname(fileURLToPath(import.meta.url)));
+}
+
+function defaultRepoRoot() {
+	return resolve(defaultPackageRoot(), "..", "..");
+}
+
+function readPackageMetadata(packageRoot) {
+	return JSON.parse(readFileSync(resolve(packageRoot, "package.json"), "utf-8"));
+}
+
+function runStep(runner, command, args, cwd, stdio = "inherit") {
+	return runner(command, args, { cwd, stdio, encoding: "utf-8" });
+}
+
+function isMissingGitCheckout(result) {
+	const text = `${String(result.stdout ?? "")}\n${String(result.stderr ?? "")}`;
+	return result.status !== 0 && text.includes("not a git repository");
+}
+
+async function runNpmGlobalUpdate(runner, repoRoot, stdout, stderr) {
+	stdout.write("Updating npm packages: @averyyy/pi-client@latest @averyyy/pi-server@latest\n");
+	const result = runStep(
+		runner,
+		"npm",
+		["install", "-g", "--ignore-scripts", "--legacy-peer-deps", "@averyyy/pi-client@latest", "@averyyy/pi-server@latest"],
+		repoRoot,
+	);
+	if (result.status !== 0) {
+		stderr.write(
+			"pi-server update failed: npm install -g --ignore-scripts --legacy-peer-deps @averyyy/pi-client@latest @averyyy/pi-server@latest\n",
+		);
+		return result.status ?? 1;
+	}
+	stdout.write("pi-server update complete\n");
+	return 0;
+}
+
+export async function runPiServerUpdate(_args = [], options = {}) {
+	const packageRoot = options.packageRoot ?? defaultPackageRoot();
+	const repoRoot = options.repoRoot ?? defaultRepoRoot();
+	const runner = options.runner ?? spawnSync;
+	const stdout = options.stdout ?? process.stdout;
+	const stderr = options.stderr ?? process.stderr;
+	const pkg = readPackageMetadata(packageRoot);
+
+	stdout.write(`pi-server ${pkg.version}\n`);
+	stdout.write(`Updating checkout: ${repoRoot}\n`);
+
+	const status = runStep(runner, "git", ["status", "--porcelain"], repoRoot, "pipe");
+	if (status.status !== 0) {
+		if (isMissingGitCheckout(status)) {
+			return runNpmGlobalUpdate(runner, repoRoot, stdout, stderr);
+		}
+		stderr.write("pi-server update failed: unable to inspect git status\n");
+		return status.status ?? 1;
+	}
+	if (String(status.stdout ?? "").trim().length > 0) {
+		stderr.write("pi-server update failed: working tree has uncommitted changes\n");
+		return 1;
+	}
+
+	const steps = [
+		["git", ["pull", "--ff-only"]],
+		["npm", ["install", "--ignore-scripts"]],
+		["npm", ["run", "install:pi-client"]],
+		["npm", ["run", "install:pi-server"]],
+	];
+
+	for (const [command, args] of steps) {
+		const result = runStep(runner, command, args, repoRoot);
+		if (result.status !== 0) {
+			stderr.write(`pi-server update failed: ${command} ${args.join(" ")}\n`);
+			return result.status ?? 1;
+		}
+	}
+
+	stdout.write("pi-server update complete\n");
+	return 0;
+}

package/dist/cli.d.ts

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

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"","sourcesContent":["#!/usr/bin/env node\nimport { startServer } from \"./server.ts\";\n\nstartServer();\n"]}

package/dist/cli.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { startServer } from "./server.js";
+startServer();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,WAAW,EAAE,CAAC","sourcesContent":["#!/usr/bin/env node\nimport { startServer } from \"./server.ts\";\n\nstartServer();\n"]}

package/dist/config.d.ts

@@ -0,0 +1,8 @@
+export interface ServerConfig {
+    host: string;
+    port: number;
+    authToken: string | undefined;
+    sessionStoreDir: string;
+}
+export declare function loadConfig(overrides?: Partial<ServerConfig>): ServerConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;CACxB;AAwBD,wBAAgB,UAAU,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAmB1E","sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\n\nexport interface ServerConfig {\n\thost: string;\n\tport: number;\n\tauthToken: string | undefined;\n\tsessionStoreDir: string;\n}\n\nconst DEFAULT_CONFIG: ServerConfig = {\n\thost: \"127.0.0.1\",\n\tport: 4217,\n\tauthToken: undefined,\n\tsessionStoreDir: resolve(\".pi\", \"pi-server\", \"sessions\"),\n};\n\nfunction loadConfigFile(): Partial<ServerConfig> {\n\tconst configPath = process.env.PI_SERVER_CONFIG;\n\tif (!configPath) return {};\n\tconst resolved = resolve(configPath);\n\tif (!existsSync(resolved)) {\n\t\tthrow new Error(`PI_SERVER_CONFIG file not found: ${resolved}`);\n\t}\n\ttry {\n\t\tconst content = readFileSync(resolved, \"utf-8\");\n\t\treturn JSON.parse(content) as Partial<ServerConfig>;\n\t} catch (err) {\n\t\tthrow new Error(`PI_SERVER_CONFIG file contains invalid JSON: ${resolved}`, { cause: err });\n\t}\n}\n\nexport function loadConfig(overrides?: Partial<ServerConfig>): ServerConfig {\n\tconst fileConfig = loadConfigFile();\n\n\treturn {\n\t\thost: overrides?.host ?? process.env.PI_SERVER_HOST ?? fileConfig.host ?? DEFAULT_CONFIG.host,\n\t\tport:\n\t\t\toverrides?.port ??\n\t\t\t(process.env.PI_SERVER_PORT ? parseInt(process.env.PI_SERVER_PORT, 10) : undefined) ??\n\t\t\tfileConfig.port ??\n\t\t\tDEFAULT_CONFIG.port,\n\t\tauthToken:\n\t\t\toverrides?.authToken ?? process.env.PI_SERVER_AUTH_TOKEN ?? fileConfig.authToken ?? DEFAULT_CONFIG.authToken,\n\t\tsessionStoreDir: resolve(\n\t\t\toverrides?.sessionStoreDir ??\n\t\t\t\tprocess.env.PI_SERVER_SESSION_STORE_DIR ??\n\t\t\t\tfileConfig.sessionStoreDir ??\n\t\t\t\tDEFAULT_CONFIG.sessionStoreDir,\n\t\t),\n\t};\n}\n"]}

package/dist/config.js

@@ -0,0 +1,40 @@
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+const DEFAULT_CONFIG = {
+    host: "127.0.0.1",
+    port: 4217,
+    authToken: undefined,
+    sessionStoreDir: resolve(".pi", "pi-server", "sessions"),
+};
+function loadConfigFile() {
+    const configPath = process.env.PI_SERVER_CONFIG;
+    if (!configPath)
+        return {};
+    const resolved = resolve(configPath);
+    if (!existsSync(resolved)) {
+        throw new Error(`PI_SERVER_CONFIG file not found: ${resolved}`);
+    }
+    try {
+        const content = readFileSync(resolved, "utf-8");
+        return JSON.parse(content);
+    }
+    catch (err) {
+        throw new Error(`PI_SERVER_CONFIG file contains invalid JSON: ${resolved}`, { cause: err });
+    }
+}
+export function loadConfig(overrides) {
+    const fileConfig = loadConfigFile();
+    return {
+        host: overrides?.host ?? process.env.PI_SERVER_HOST ?? fileConfig.host ?? DEFAULT_CONFIG.host,
+        port: overrides?.port ??
+            (process.env.PI_SERVER_PORT ? parseInt(process.env.PI_SERVER_PORT, 10) : undefined) ??
+            fileConfig.port ??
+            DEFAULT_CONFIG.port,
+        authToken: overrides?.authToken ?? process.env.PI_SERVER_AUTH_TOKEN ?? fileConfig.authToken ?? DEFAULT_CONFIG.authToken,
+        sessionStoreDir: resolve(overrides?.sessionStoreDir ??
+            process.env.PI_SERVER_SESSION_STORE_DIR ??
+            fileConfig.sessionStoreDir ??
+            DEFAULT_CONFIG.sessionStoreDir),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,MAAM,cAAc,GAAiB;IACpC,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,IAAI;IACV,SAAS,EAAE,SAAS;IACpB,eAAe,EAAE,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,CAAC;CACxD,CAAC;AAEF,SAAS,cAAc,GAA0B;IAChD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAChD,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,oCAAoC,QAAQ,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,CAAC;QACJ,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAA0B,CAAC;IACrD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,gDAAgD,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7F,CAAC;AAAA,CACD;AAED,MAAM,UAAU,UAAU,CAAC,SAAiC,EAAgB;IAC3E,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;IAEpC,OAAO;QACN,IAAI,EAAE,SAAS,EAAE,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,UAAU,CAAC,IAAI,IAAI,cAAc,CAAC,IAAI;QAC7F,IAAI,EACH,SAAS,EAAE,IAAI;YACf,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACnF,UAAU,CAAC,IAAI;YACf,cAAc,CAAC,IAAI;QACpB,SAAS,EACR,SAAS,EAAE,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,UAAU,CAAC,SAAS,IAAI,cAAc,CAAC,SAAS;QAC7G,eAAe,EAAE,OAAO,CACvB,SAAS,EAAE,eAAe;YACzB,OAAO,CAAC,GAAG,CAAC,2BAA2B;YACvC,UAAU,CAAC,eAAe;YAC1B,cAAc,CAAC,eAAe,CAC/B;KACD,CAAC;AAAA,CACF","sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\n\nexport interface ServerConfig {\n\thost: string;\n\tport: number;\n\tauthToken: string | undefined;\n\tsessionStoreDir: string;\n}\n\nconst DEFAULT_CONFIG: ServerConfig = {\n\thost: \"127.0.0.1\",\n\tport: 4217,\n\tauthToken: undefined,\n\tsessionStoreDir: resolve(\".pi\", \"pi-server\", \"sessions\"),\n};\n\nfunction loadConfigFile(): Partial<ServerConfig> {\n\tconst configPath = process.env.PI_SERVER_CONFIG;\n\tif (!configPath) return {};\n\tconst resolved = resolve(configPath);\n\tif (!existsSync(resolved)) {\n\t\tthrow new Error(`PI_SERVER_CONFIG file not found: ${resolved}`);\n\t}\n\ttry {\n\t\tconst content = readFileSync(resolved, \"utf-8\");\n\t\treturn JSON.parse(content) as Partial<ServerConfig>;\n\t} catch (err) {\n\t\tthrow new Error(`PI_SERVER_CONFIG file contains invalid JSON: ${resolved}`, { cause: err });\n\t}\n}\n\nexport function loadConfig(overrides?: Partial<ServerConfig>): ServerConfig {\n\tconst fileConfig = loadConfigFile();\n\n\treturn {\n\t\thost: overrides?.host ?? process.env.PI_SERVER_HOST ?? fileConfig.host ?? DEFAULT_CONFIG.host,\n\t\tport:\n\t\t\toverrides?.port ??\n\t\t\t(process.env.PI_SERVER_PORT ? parseInt(process.env.PI_SERVER_PORT, 10) : undefined) ??\n\t\t\tfileConfig.port ??\n\t\t\tDEFAULT_CONFIG.port,\n\t\tauthToken:\n\t\t\toverrides?.authToken ?? process.env.PI_SERVER_AUTH_TOKEN ?? fileConfig.authToken ?? DEFAULT_CONFIG.authToken,\n\t\tsessionStoreDir: resolve(\n\t\t\toverrides?.sessionStoreDir ??\n\t\t\t\tprocess.env.PI_SERVER_SESSION_STORE_DIR ??\n\t\t\t\tfileConfig.sessionStoreDir ??\n\t\t\t\tDEFAULT_CONFIG.sessionStoreDir,\n\t\t),\n\t};\n}\n"]}

package/dist/event-encoding.d.ts

@@ -0,0 +1,5 @@
+import type { ProxyAssistantMessageEvent } from "@earendil-works/pi-agent-core";
+export declare function encodeProxyEvent(event: ProxyAssistantMessageEvent): string;
+export declare function encodeErrorEvent(message: string): string;
+export declare function parseProxyEvent(line: string): ProxyAssistantMessageEvent | undefined;
+//# sourceMappingURL=event-encoding.d.ts.map

package/dist/event-encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-encoding.d.ts","sourceRoot":"","sources":["../src/event-encoding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAEhF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,0BAA0B,GAAG,MAAM,CAE1E;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS,CAKpF","sourcesContent":["import type { ProxyAssistantMessageEvent } from \"@earendil-works/pi-agent-core\";\n\nexport function encodeProxyEvent(event: ProxyAssistantMessageEvent): string {\n\treturn `data: ${JSON.stringify(event)}\\n\\n`;\n}\n\nexport function encodeErrorEvent(message: string): string {\n\treturn `data: ${JSON.stringify({ type: \"error\", reason: \"error\", errorMessage: message, usage: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, totalTokens: 0, cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 } } })}\\n\\n`;\n}\n\nexport function parseProxyEvent(line: string): ProxyAssistantMessageEvent | undefined {\n\tif (!line.startsWith(\"data: \")) return undefined;\n\tconst data = line.slice(6).trim();\n\tif (!data) return undefined;\n\treturn JSON.parse(data) as ProxyAssistantMessageEvent;\n}\n"]}

package/dist/event-encoding.js

@@ -0,0 +1,15 @@
+export function encodeProxyEvent(event) {
+    return `data: ${JSON.stringify(event)}\n\n`;
+}
+export function encodeErrorEvent(message) {
+    return `data: ${JSON.stringify({ type: "error", reason: "error", errorMessage: message, usage: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, totalTokens: 0, cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 } } })}\n\n`;
+}
+export function parseProxyEvent(line) {
+    if (!line.startsWith("data: "))
+        return undefined;
+    const data = line.slice(6).trim();
+    if (!data)
+        return undefined;
+    return JSON.parse(data);
+}
+//# sourceMappingURL=event-encoding.js.map

package/dist/event-encoding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-encoding.js","sourceRoot":"","sources":["../src/event-encoding.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAAC,KAAiC,EAAU;IAC3E,OAAO,SAAS,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC;AAAA,CAC5C;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAU;IACzD,OAAO,SAAS,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC;AAAA,CACnP;AAED,MAAM,UAAU,eAAe,CAAC,IAAY,EAA0C;IACrF,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAClC,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAA+B,CAAC;AAAA,CACtD","sourcesContent":["import type { ProxyAssistantMessageEvent } from \"@earendil-works/pi-agent-core\";\n\nexport function encodeProxyEvent(event: ProxyAssistantMessageEvent): string {\n\treturn `data: ${JSON.stringify(event)}\\n\\n`;\n}\n\nexport function encodeErrorEvent(message: string): string {\n\treturn `data: ${JSON.stringify({ type: \"error\", reason: \"error\", errorMessage: message, usage: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, totalTokens: 0, cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 } } })}\\n\\n`;\n}\n\nexport function parseProxyEvent(line: string): ProxyAssistantMessageEvent | undefined {\n\tif (!line.startsWith(\"data: \")) return undefined;\n\tconst data = line.slice(6).trim();\n\tif (!data) return undefined;\n\treturn JSON.parse(data) as ProxyAssistantMessageEvent;\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { loadConfig, type ServerConfig } from "./config.ts";
+export { encodeErrorEvent, encodeProxyEvent, parseProxyEvent } from "./event-encoding.ts";
+export { createPiServer, startServer } from "./server.ts";
+export { appendAssistantResponse, appendMessages, clearAllSessions, deleteSession, exportSessionState, getOrCreateSession, getSession, hashSessionEntries, listSessions, type PersistedSessionState, restoreSessionState, type SessionState, type SessionStaticContext, type SessionSummary, setStaticContext, } from "./session-store.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC1F,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EACN,uBAAuB,EACvB,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,KAAK,qBAAqB,EAC1B,mBAAmB,EACnB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,gBAAgB,GAChB,MAAM,oBAAoB,CAAC","sourcesContent":["export { loadConfig, type ServerConfig } from \"./config.ts\";\nexport { encodeErrorEvent, encodeProxyEvent, parseProxyEvent } from \"./event-encoding.ts\";\nexport { createPiServer, startServer } from \"./server.ts\";\nexport {\n\tappendAssistantResponse,\n\tappendMessages,\n\tclearAllSessions,\n\tdeleteSession,\n\texportSessionState,\n\tgetOrCreateSession,\n\tgetSession,\n\thashSessionEntries,\n\tlistSessions,\n\ttype PersistedSessionState,\n\trestoreSessionState,\n\ttype SessionState,\n\ttype SessionStaticContext,\n\ttype SessionSummary,\n\tsetStaticContext,\n} from \"./session-store.ts\";\n"]}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { loadConfig } from "./config.js";
+export { encodeErrorEvent, encodeProxyEvent, parseProxyEvent } from "./event-encoding.js";
+export { createPiServer, startServer } from "./server.js";
+export { appendAssistantResponse, appendMessages, clearAllSessions, deleteSession, exportSessionState, getOrCreateSession, getSession, hashSessionEntries, listSessions, restoreSessionState, setStaticContext, } from "./session-store.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAqB,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC1F,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EACN,uBAAuB,EACvB,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACV,kBAAkB,EAClB,YAAY,EAEZ,mBAAmB,EAInB,gBAAgB,GAChB,MAAM,oBAAoB,CAAC","sourcesContent":["export { loadConfig, type ServerConfig } from \"./config.ts\";\nexport { encodeErrorEvent, encodeProxyEvent, parseProxyEvent } from \"./event-encoding.ts\";\nexport { createPiServer, startServer } from \"./server.ts\";\nexport {\n\tappendAssistantResponse,\n\tappendMessages,\n\tclearAllSessions,\n\tdeleteSession,\n\texportSessionState,\n\tgetOrCreateSession,\n\tgetSession,\n\thashSessionEntries,\n\tlistSessions,\n\ttype PersistedSessionState,\n\trestoreSessionState,\n\ttype SessionState,\n\ttype SessionStaticContext,\n\ttype SessionSummary,\n\tsetStaticContext,\n} from \"./session-store.ts\";\n"]}

package/dist/pi-server-protocol.d.ts

@@ -0,0 +1,13 @@
+import type { SessionTreeEntry } from "@earendil-works/pi-agent-core";
+import type { Tool } from "@earendil-works/pi-ai";
+export interface PiServerStaticContext {
+    systemPrompt?: string;
+    tools?: Tool[];
+}
+export declare function hashPiServerStaticContext(context: PiServerStaticContext | undefined): string;
+export declare const PI_SERVER_EMPTY_TREE_HASH: string;
+export declare function hashPiServerTreeEntry(entry: SessionTreeEntry): string;
+export declare function appendPiServerTreeHash(previousHash: string, entryHash: string): string;
+export declare function buildPiServerTreePrefixHashes(entries: SessionTreeEntry[]): string[];
+export declare function hashPiServerSessionEntries(entries: SessionTreeEntry[]): string;
+//# sourceMappingURL=pi-server-protocol.d.ts.map

package/dist/pi-server-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-server-protocol.d.ts","sourceRoot":"","sources":["../src/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"]}

package/dist/pi-server-protocol.js

@@ -0,0 +1,32 @@
+import { createHash } from "node:crypto";
+export function hashPiServerStaticContext(context) {
+    if (!context)
+        return "";
+    const canonical = {
+        systemPrompt: context.systemPrompt,
+        tools: context.tools?.map((tool) => ({
+            name: tool.name,
+            description: tool.description,
+            parameters: tool.parameters,
+        })),
+    };
+    return createHash("sha256").update(JSON.stringify(canonical)).digest("hex");
+}
+export const PI_SERVER_EMPTY_TREE_HASH = createHash("sha256").update("pi-tree-v1").digest("hex");
+export function hashPiServerTreeEntry(entry) {
+    return createHash("sha256").update(JSON.stringify(entry)).digest("hex");
+}
+export function appendPiServerTreeHash(previousHash, entryHash) {
+    return createHash("sha256").update(`${previousHash}:${entryHash}`).digest("hex");
+}
+export function buildPiServerTreePrefixHashes(entries) {
+    const hashes = [PI_SERVER_EMPTY_TREE_HASH];
+    for (const entry of entries) {
+        hashes.push(appendPiServerTreeHash(hashes[hashes.length - 1], hashPiServerTreeEntry(entry)));
+    }
+    return hashes;
+}
+export function hashPiServerSessionEntries(entries) {
+    return buildPiServerTreePrefixHashes(entries)[entries.length];
+}
+//# sourceMappingURL=pi-server-protocol.js.map

package/dist/pi-server-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-server-protocol.js","sourceRoot":"","sources":["../src/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"]}

package/dist/request-chunks.d.ts

@@ -0,0 +1,37 @@
+export declare const CHUNK_ENDPOINT = "/api/request/chunk";
+export interface RequestChunkBody {
+    requestId: string;
+    target: string;
+    chunkIndex: number;
+    totalChunks: number;
+    sha256: string;
+    chunk: string;
+}
+interface ChunkAck {
+    received: true;
+    requestId: string;
+    chunkIndex: number;
+    totalChunks: number;
+}
+interface PendingChunkResult {
+    complete: false;
+    ack: ChunkAck;
+}
+interface CompleteChunkResult {
+    complete: true;
+    target: string;
+    bodyJson: string;
+}
+export declare const REQUEST_CHUNK_PENDING_TTL_MS: number;
+export declare const REQUEST_CHUNK_MAX_PENDING_BYTES: number;
+export declare const REQUEST_CHUNK_COMPLETED_TTL_MS: number;
+interface ReceiveRequestChunkOptions {
+    nowMs?: number;
+    pendingTtlMs?: number;
+    maxPendingBytes?: number;
+    completedTtlMs?: number;
+}
+export declare function receiveRequestChunk(body: RequestChunkBody, options?: ReceiveRequestChunkOptions): PendingChunkResult | CompleteChunkResult;
+export declare function clearAllRequestChunks(): void;
+export {};
+//# sourceMappingURL=request-chunks.d.ts.map

package/dist/request-chunks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-chunks.d.ts","sourceRoot":"","sources":["../src/request-chunks.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,cAAc,uBAAuB,CAAC;AAenD,MAAM,WAAW,gBAAgB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACd;AAwBD,UAAU,QAAQ;IACjB,QAAQ,EAAE,IAAI,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,kBAAkB;IAC3B,QAAQ,EAAE,KAAK,CAAC;IAChB,GAAG,EAAE,QAAQ,CAAC;CACd;AAED,UAAU,mBAAmB;IAC5B,QAAQ,EAAE,IAAI,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACjB;AAMD,eAAO,MAAM,4BAA4B,QAAgB,CAAC;AAC1D,eAAO,MAAM,+BAA+B,QAAmB,CAAC;AAChE,eAAO,MAAM,8BAA8B,QAAY,CAAC;AAExD,UAAU,0BAA0B;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAkED,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,gBAAgB,EACtB,OAAO,GAAE,0BAA+B,GACtC,kBAAkB,GAAG,mBAAmB,CAuF1C;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C","sourcesContent":["import { Buffer } from \"node:buffer\";\nimport { createHash } from \"node:crypto\";\n\nexport const CHUNK_ENDPOINT = \"/api/request/chunk\";\n\nconst ALLOWED_TARGETS = new Set([\n\t\"/api/session/init\",\n\t\"/api/session/update\",\n\t\"/api/session/sync\",\n\t\"/api/session/append\",\n\t\"/api/session/tree/sync\",\n\t\"/api/session/tree/append\",\n\t\"/api/session/tree/switch\",\n\t\"/api/session/drop-last-assistant-error\",\n\t\"/api/session/compact\",\n\t\"/api/stream\",\n]);\n\nexport interface RequestChunkBody {\n\trequestId: string;\n\ttarget: string;\n\tchunkIndex: number;\n\ttotalChunks: number;\n\tsha256: string;\n\tchunk: string;\n}\n\ninterface RequestChunk {\n\tchunk: string;\n\tsha256: string;\n}\n\ninterface PendingRequest {\n\ttarget: string;\n\ttotalChunks: number;\n\tchunks: Map<number, RequestChunk>;\n\treceivedBytes: number;\n\tupdatedAtMs: number;\n}\n\ninterface CompletedRequest {\n\ttarget: string;\n\ttotalChunks: number;\n\tbodyJson: string;\n\tcompletedChunkIndex: number;\n\tcompletedAtMs: number;\n\tchunks: Map<number, RequestChunk>;\n}\n\ninterface ChunkAck {\n\treceived: true;\n\trequestId: string;\n\tchunkIndex: number;\n\ttotalChunks: number;\n}\n\ninterface PendingChunkResult {\n\tcomplete: false;\n\tack: ChunkAck;\n}\n\ninterface CompleteChunkResult {\n\tcomplete: true;\n\ttarget: string;\n\tbodyJson: string;\n}\n\nconst pendingRequests = new Map<string, PendingRequest>();\nconst completedRequests = new Map<string, CompletedRequest>();\nlet pendingRequestBytes = 0;\n\nexport const REQUEST_CHUNK_PENDING_TTL_MS = 5 * 60 * 1000;\nexport const REQUEST_CHUNK_MAX_PENDING_BYTES = 64 * 1024 * 1024;\nexport const REQUEST_CHUNK_COMPLETED_TTL_MS = 60 * 1000;\n\ninterface ReceiveRequestChunkOptions {\n\tnowMs?: number;\n\tpendingTtlMs?: number;\n\tmaxPendingBytes?: number;\n\tcompletedTtlMs?: number;\n}\n\nfunction sha256(value: string): string {\n\treturn createHash(\"sha256\").update(value).digest(\"hex\");\n}\n\nfunction assertValidChunk(body: RequestChunkBody): void {\n\tif (!body.requestId) throw new Error(\"requestId is required\");\n\tif (!ALLOWED_TARGETS.has(body.target)) throw new Error(`Unsupported chunk target: ${body.target}`);\n\tif (!Number.isInteger(body.totalChunks) || body.totalChunks <= 0) {\n\t\tthrow new Error(\"totalChunks must be a positive integer\");\n\t}\n\tif (!Number.isInteger(body.chunkIndex) || body.chunkIndex < 0 || body.chunkIndex >= body.totalChunks) {\n\t\tthrow new Error(\"chunkIndex must be an integer within the chunk range\");\n\t}\n\tif (typeof body.chunk !== \"string\") throw new Error(\"chunk must be a string\");\n\tif (typeof body.sha256 !== \"string\" || !/^[a-f0-9]{64}$/i.test(body.sha256)) {\n\t\tthrow new Error(\"sha256 must be a 64-character hex string\");\n\t}\n\tif (sha256(body.chunk) !== body.sha256) {\n\t\tthrow new Error(`Chunk checksum mismatch: ${body.chunkIndex}`);\n\t}\n}\n\nfunction makeAck(body: RequestChunkBody): PendingChunkResult {\n\treturn {\n\t\tcomplete: false,\n\t\tack: {\n\t\t\treceived: true,\n\t\t\trequestId: body.requestId,\n\t\t\tchunkIndex: body.chunkIndex,\n\t\t\ttotalChunks: body.totalChunks,\n\t\t},\n\t};\n}\n\nfunction deletePendingRequest(requestId: string, pending: PendingRequest): void {\n\tpendingRequests.delete(requestId);\n\tpendingRequestBytes -= pending.receivedBytes;\n}\n\nfunction cleanupExpiredRequests(nowMs: number, pendingTtlMs: number, completedTtlMs: number): void {\n\tfor (const [requestId, pending] of pendingRequests) {\n\t\tif (nowMs - pending.updatedAtMs > pendingTtlMs) {\n\t\t\tdeletePendingRequest(requestId, pending);\n\t\t}\n\t}\n\tfor (const [requestId, completed] of completedRequests) {\n\t\tif (nowMs - completed.completedAtMs > completedTtlMs) {\n\t\t\tcompletedRequests.delete(requestId);\n\t\t}\n\t}\n}\n\nfunction cleanupForPendingBytes(extraBytes: number, maxPendingBytes: number, protectedRequestId: string): void {\n\tfor (const [requestId, pending] of pendingRequests) {\n\t\tif (pendingRequestBytes + extraBytes <= maxPendingBytes) return;\n\t\tif (requestId !== protectedRequestId) {\n\t\t\tdeletePendingRequest(requestId, pending);\n\t\t}\n\t}\n\tif (pendingRequestBytes + extraBytes > maxPendingBytes) {\n\t\tthrow new Error(\"Request chunk pending bytes limit exceeded\");\n\t}\n}\n\nexport function receiveRequestChunk(\n\tbody: RequestChunkBody,\n\toptions: ReceiveRequestChunkOptions = {},\n): PendingChunkResult | CompleteChunkResult {\n\tassertValidChunk(body);\n\n\tconst nowMs = options.nowMs ?? Date.now();\n\tcleanupExpiredRequests(\n\t\tnowMs,\n\t\toptions.pendingTtlMs ?? REQUEST_CHUNK_PENDING_TTL_MS,\n\t\toptions.completedTtlMs ?? REQUEST_CHUNK_COMPLETED_TTL_MS,\n\t);\n\n\tconst completed = completedRequests.get(body.requestId);\n\tif (completed) {\n\t\tif (completed.target !== body.target || completed.totalChunks !== body.totalChunks) {\n\t\t\tthrow new Error(\"Chunk metadata does not match the completed request\");\n\t\t}\n\t\tconst existing = completed.chunks.get(body.chunkIndex);\n\t\tif (!existing || existing.chunk !== body.chunk || existing.sha256 !== body.sha256) {\n\t\t\tthrow new Error(`Duplicate chunk index does not match: ${body.chunkIndex}`);\n\t\t}\n\t\tif (body.chunkIndex === completed.completedChunkIndex) {\n\t\t\treturn {\n\t\t\t\tcomplete: true,\n\t\t\t\ttarget: completed.target,\n\t\t\t\tbodyJson: completed.bodyJson,\n\t\t\t};\n\t\t}\n\t\treturn makeAck(body);\n\t}\n\n\tlet pending = pendingRequests.get(body.requestId);\n\tif (pending) {\n\t\tif (pending.target !== body.target || pending.totalChunks !== body.totalChunks) {\n\t\t\tthrow new Error(\"Chunk metadata does not match the pending request\");\n\t\t}\n\t\tconst existing = pending.chunks.get(body.chunkIndex);\n\t\tif (existing) {\n\t\t\tif (existing.chunk !== body.chunk || existing.sha256 !== body.sha256) {\n\t\t\t\tthrow new Error(`Duplicate chunk index does not match: ${body.chunkIndex}`);\n\t\t\t}\n\t\t\tpending.updatedAtMs = nowMs;\n\t\t\treturn makeAck(body);\n\t\t}\n\t}\n\n\tconst chunkBytes = Buffer.byteLength(body.chunk, \"utf-8\");\n\tcleanupForPendingBytes(chunkBytes, options.maxPendingBytes ?? REQUEST_CHUNK_MAX_PENDING_BYTES, body.requestId);\n\tif (!pending) {\n\t\tpending = {\n\t\t\ttarget: body.target,\n\t\t\ttotalChunks: body.totalChunks,\n\t\t\tchunks: new Map(),\n\t\t\treceivedBytes: 0,\n\t\t\tupdatedAtMs: nowMs,\n\t\t};\n\t\tpendingRequests.set(body.requestId, pending);\n\t}\n\tpending.chunks.set(body.chunkIndex, { chunk: body.chunk, sha256: body.sha256 });\n\tpending.receivedBytes += chunkBytes;\n\tpending.updatedAtMs = nowMs;\n\tpendingRequestBytes += chunkBytes;\n\n\tif (pending.chunks.size !== pending.totalChunks) {\n\t\treturn makeAck(body);\n\t}\n\n\tconst encodedChunks: string[] = [];\n\tfor (let index = 0; index < pending.totalChunks; index++) {\n\t\tconst chunk = pending.chunks.get(index);\n\t\tif (chunk === undefined) throw new Error(`Missing chunk index: ${index}`);\n\t\tencodedChunks.push(chunk.chunk);\n\t}\n\n\tdeletePendingRequest(body.requestId, pending);\n\tconst bodyJson = Buffer.from(encodedChunks.join(\"\"), \"base64\").toString(\"utf-8\");\n\tcompletedRequests.set(body.requestId, {\n\t\ttarget: pending.target,\n\t\ttotalChunks: pending.totalChunks,\n\t\tbodyJson,\n\t\tcompletedChunkIndex: body.chunkIndex,\n\t\tcompletedAtMs: nowMs,\n\t\tchunks: pending.chunks,\n\t});\n\treturn {\n\t\tcomplete: true,\n\t\ttarget: pending.target,\n\t\tbodyJson,\n\t};\n}\n\nexport function clearAllRequestChunks(): void {\n\tpendingRequests.clear();\n\tcompletedRequests.clear();\n\tpendingRequestBytes = 0;\n}\n"]}

package/dist/request-chunks.js

@@ -0,0 +1,167 @@
+import { Buffer } from "node:buffer";
+import { createHash } from "node:crypto";
+export const CHUNK_ENDPOINT = "/api/request/chunk";
+const ALLOWED_TARGETS = new Set([
+    "/api/session/init",
+    "/api/session/update",
+    "/api/session/sync",
+    "/api/session/append",
+    "/api/session/tree/sync",
+    "/api/session/tree/append",
+    "/api/session/tree/switch",
+    "/api/session/drop-last-assistant-error",
+    "/api/session/compact",
+    "/api/stream",
+]);
+const pendingRequests = new Map();
+const completedRequests = new Map();
+let pendingRequestBytes = 0;
+export const REQUEST_CHUNK_PENDING_TTL_MS = 5 * 60 * 1000;
+export const REQUEST_CHUNK_MAX_PENDING_BYTES = 64 * 1024 * 1024;
+export const REQUEST_CHUNK_COMPLETED_TTL_MS = 60 * 1000;
+function sha256(value) {
+    return createHash("sha256").update(value).digest("hex");
+}
+function assertValidChunk(body) {
+    if (!body.requestId)
+        throw new Error("requestId is required");
+    if (!ALLOWED_TARGETS.has(body.target))
+        throw new Error(`Unsupported chunk target: ${body.target}`);
+    if (!Number.isInteger(body.totalChunks) || body.totalChunks <= 0) {
+        throw new Error("totalChunks must be a positive integer");
+    }
+    if (!Number.isInteger(body.chunkIndex) || body.chunkIndex < 0 || body.chunkIndex >= body.totalChunks) {
+        throw new Error("chunkIndex must be an integer within the chunk range");
+    }
+    if (typeof body.chunk !== "string")
+        throw new Error("chunk must be a string");
+    if (typeof body.sha256 !== "string" || !/^[a-f0-9]{64}$/i.test(body.sha256)) {
+        throw new Error("sha256 must be a 64-character hex string");
+    }
+    if (sha256(body.chunk) !== body.sha256) {
+        throw new Error(`Chunk checksum mismatch: ${body.chunkIndex}`);
+    }
+}
+function makeAck(body) {
+    return {
+        complete: false,
+        ack: {
+            received: true,
+            requestId: body.requestId,
+            chunkIndex: body.chunkIndex,
+            totalChunks: body.totalChunks,
+        },
+    };
+}
+function deletePendingRequest(requestId, pending) {
+    pendingRequests.delete(requestId);
+    pendingRequestBytes -= pending.receivedBytes;
+}
+function cleanupExpiredRequests(nowMs, pendingTtlMs, completedTtlMs) {
+    for (const [requestId, pending] of pendingRequests) {
+        if (nowMs - pending.updatedAtMs > pendingTtlMs) {
+            deletePendingRequest(requestId, pending);
+        }
+    }
+    for (const [requestId, completed] of completedRequests) {
+        if (nowMs - completed.completedAtMs > completedTtlMs) {
+            completedRequests.delete(requestId);
+        }
+    }
+}
+function cleanupForPendingBytes(extraBytes, maxPendingBytes, protectedRequestId) {
+    for (const [requestId, pending] of pendingRequests) {
+        if (pendingRequestBytes + extraBytes <= maxPendingBytes)
+            return;
+        if (requestId !== protectedRequestId) {
+            deletePendingRequest(requestId, pending);
+        }
+    }
+    if (pendingRequestBytes + extraBytes > maxPendingBytes) {
+        throw new Error("Request chunk pending bytes limit exceeded");
+    }
+}
+export function receiveRequestChunk(body, options = {}) {
+    assertValidChunk(body);
+    const nowMs = options.nowMs ?? Date.now();
+    cleanupExpiredRequests(nowMs, options.pendingTtlMs ?? REQUEST_CHUNK_PENDING_TTL_MS, options.completedTtlMs ?? REQUEST_CHUNK_COMPLETED_TTL_MS);
+    const completed = completedRequests.get(body.requestId);
+    if (completed) {
+        if (completed.target !== body.target || completed.totalChunks !== body.totalChunks) {
+            throw new Error("Chunk metadata does not match the completed request");
+        }
+        const existing = completed.chunks.get(body.chunkIndex);
+        if (!existing || existing.chunk !== body.chunk || existing.sha256 !== body.sha256) {
+            throw new Error(`Duplicate chunk index does not match: ${body.chunkIndex}`);
+        }
+        if (body.chunkIndex === completed.completedChunkIndex) {
+            return {
+                complete: true,
+                target: completed.target,
+                bodyJson: completed.bodyJson,
+            };
+        }
+        return makeAck(body);
+    }
+    let pending = pendingRequests.get(body.requestId);
+    if (pending) {
+        if (pending.target !== body.target || pending.totalChunks !== body.totalChunks) {
+            throw new Error("Chunk metadata does not match the pending request");
+        }
+        const existing = pending.chunks.get(body.chunkIndex);
+        if (existing) {
+            if (existing.chunk !== body.chunk || existing.sha256 !== body.sha256) {
+                throw new Error(`Duplicate chunk index does not match: ${body.chunkIndex}`);
+            }
+            pending.updatedAtMs = nowMs;
+            return makeAck(body);
+        }
+    }
+    const chunkBytes = Buffer.byteLength(body.chunk, "utf-8");
+    cleanupForPendingBytes(chunkBytes, options.maxPendingBytes ?? REQUEST_CHUNK_MAX_PENDING_BYTES, body.requestId);
+    if (!pending) {
+        pending = {
+            target: body.target,
+            totalChunks: body.totalChunks,
+            chunks: new Map(),
+            receivedBytes: 0,
+            updatedAtMs: nowMs,
+        };
+        pendingRequests.set(body.requestId, pending);
+    }
+    pending.chunks.set(body.chunkIndex, { chunk: body.chunk, sha256: body.sha256 });
+    pending.receivedBytes += chunkBytes;
+    pending.updatedAtMs = nowMs;
+    pendingRequestBytes += chunkBytes;
+    if (pending.chunks.size !== pending.totalChunks) {
+        return makeAck(body);
+    }
+    const encodedChunks = [];
+    for (let index = 0; index < pending.totalChunks; index++) {
+        const chunk = pending.chunks.get(index);
+        if (chunk === undefined)
+            throw new Error(`Missing chunk index: ${index}`);
+        encodedChunks.push(chunk.chunk);
+    }
+    deletePendingRequest(body.requestId, pending);
+    const bodyJson = Buffer.from(encodedChunks.join(""), "base64").toString("utf-8");
+    completedRequests.set(body.requestId, {
+        target: pending.target,
+        totalChunks: pending.totalChunks,
+        bodyJson,
+        completedChunkIndex: body.chunkIndex,
+        completedAtMs: nowMs,
+        chunks: pending.chunks,
+    });
+    return {
+        complete: true,
+        target: pending.target,
+        bodyJson,
+    };
+}
+export function clearAllRequestChunks() {
+    pendingRequests.clear();
+    completedRequests.clear();
+    pendingRequestBytes = 0;
+}
+//# sourceMappingURL=request-chunks.js.map