pi-tinychat 0.1.0 → 0.1.1

package/public/theme-init.js

@@ -1,18 +1,18 @@
-// Applied before the stylesheet so the first paint matches the saved theme.
-// This is the only script that reads localStorage before the app boots.
-(() => {
-	let choice = "system";
-	try {
-		const raw =
-			localStorage.getItem("pi-tinychat:settings") ?? localStorage.getItem("pi-dock:settings");
-		if (raw) {
-			const parsed = JSON.parse(raw);
-			if (parsed && ["system", "light", "dark"].includes(parsed.theme)) choice = parsed.theme;
-		}
-	} catch {
-		/* storage unavailable */
-	}
-	const dark = window.matchMedia("(prefers-color-scheme: dark)").matches;
-	document.documentElement.dataset.theme =
-		choice === "system" ? (dark ? "dark" : "light") : choice;
-})();
+// Applied before the stylesheet so the first paint matches the saved theme.
+// This is the only script that reads localStorage before the app boots.
+(() => {
+	let choice = "system";
+	try {
+		const raw =
+			localStorage.getItem("pi-tinychat:settings") ?? localStorage.getItem("pi-dock:settings");
+		if (raw) {
+			const parsed = JSON.parse(raw);
+			if (parsed && ["system", "light", "dark"].includes(parsed.theme)) choice = parsed.theme;
+		}
+	} catch {
+		/* storage unavailable */
+	}
+	const dark = window.matchMedia("(prefers-color-scheme: dark)").matches;
+	document.documentElement.dataset.theme =
+		choice === "system" ? (dark ? "dark" : "light") : choice;
+})();

package/src/compaction.js

@@ -1,139 +1,139 @@
-import { randomBytes } from "node:crypto";
-import { chmod, mkdir, readFile, rename, stat, unlink, writeFile } from "node:fs/promises";
-import { dirname, join } from "node:path";
-import { TinyChatError } from "./errors.js";
-import { agentDir } from "./sessions.js";
-
-/**
- * Pi owns compaction configuration. Pi TinyChat only reads and writes Pi's global
- * settings so the UI can show the threshold as a percentage of the current
- * model's context window. Project settings and per-model overrides are left
- * entirely to Pi.
- *
- * Writes happen only on explicit user action, with an atomic rename. Do not
- * edit the same settings file from Pi and Pi TinyChat at the same moment.
- */
-const DEFAULT_RESERVE = 16_384;
-const ASSUMED_CONTEXT_WINDOW = 1_000_000;
-
-export function settingsPath(env = process.env) {
-	return join(agentDir(env), "settings.json");
-}
-
-async function readSettings(path, { strict = false } = {}) {
-	try {
-		const text = (await readFile(path, "utf8")).replace(/^\uFEFF/, "");
-		if (!text.trim()) return {};
-		const value = JSON.parse(text);
-		if (!value || typeof value !== "object" || Array.isArray(value)) {
-			if (strict) throw new TinyChatError("server.invalidSettings");
-			return {};
-		}
-		return value;
-	} catch (error) {
-		if (error instanceof TinyChatError) throw error;
-		if (error.code === "ENOENT") return {};
-		if (strict) throw new TinyChatError("server.readSettings", { message: error.message });
-		return {};
-	}
-}
-
-function safeInteger(value) {
-	return Number.isSafeInteger(value) && value >= 0 ? value : null;
-}
-
-export async function describeCompaction({ env = process.env, model }) {
-	const path = settingsPath(env);
-	const settings = await readSettings(path);
-	const compaction =
-		settings.compaction && typeof settings.compaction === "object" ? settings.compaction : {};
-	const contextWindow = safeInteger(model?.contextWindow) ?? 0;
-	const displayContextWindow = contextWindow || ASSUMED_CONTEXT_WINDOW;
-	const configuredReserve = safeInteger(compaction.reserveTokens);
-	const reserveTokens = configuredReserve ?? DEFAULT_RESERVE;
-	const thresholdTokens = Math.max(0, displayContextWindow - reserveTokens);
-	return {
-		enabled: compaction.enabled !== false,
-		settingsPath: path,
-		reserveTokens,
-		reserveSource: configuredReserve === null ? "pi-default" : "settings",
-		contextWindow,
-		displayContextWindow,
-		contextWindowKnown: contextWindow > 0,
-		thresholdTokens,
-		thresholdPercent: (thresholdTokens / displayContextWindow) * 100,
-	};
-}
-
-function pruneEmpty(settings) {
-	const compaction = settings.compaction;
-	if (!compaction || typeof compaction !== "object") return;
-	if (Object.keys(compaction).length === 0) delete settings.compaction;
-}
-
-export async function setCompactionThreshold({ env = process.env, model, percent }) {
-	const contextWindow = safeInteger(model?.contextWindow) ?? 0;
-	if (!contextWindow) throw new TinyChatError("server.contextUnknown");
-	if (typeof percent !== "number" || !Number.isFinite(percent) || percent <= 0 || percent >= 100) {
-		throw new TinyChatError("server.percentRange");
-	}
-
-	const path = settingsPath(env);
-	const settings = await readSettings(path, { strict: true });
-	const compaction =
-		settings.compaction && typeof settings.compaction === "object" ? settings.compaction : {};
-	compaction.reserveTokens = contextWindow - Math.round((contextWindow * percent) / 100);
-	settings.compaction = compaction;
-	await writeSettings(path, settings);
-	return describeCompaction({ env, model });
-}
-
-export async function clearCompactionThreshold({ env = process.env, model }) {
-	const path = settingsPath(env);
-	const settings = await readSettings(path, { strict: true });
-	const compaction =
-		settings.compaction && typeof settings.compaction === "object" ? settings.compaction : null;
-	if (!compaction) return describeCompaction({ env, model });
-	delete compaction.reserveTokens;
-	pruneEmpty(settings);
-	await writeSettings(path, settings);
-	return describeCompaction({ env, model });
-}
-
-export async function setCompactionEnabled({ env = process.env, enabled }) {
-	const path = settingsPath(env);
-	const settings = await readSettings(path, { strict: true });
-	const compaction =
-		settings.compaction && typeof settings.compaction === "object" ? settings.compaction : {};
-	compaction.enabled = Boolean(enabled);
-	settings.compaction = compaction;
-	await writeSettings(path, settings);
-	return { enabled: Boolean(enabled) };
-}
-
-async function writeSettings(path, settings) {
-	pruneEmpty(settings);
-	const body = `${JSON.stringify(settings, null, 2)}\n`;
-	let current = null;
-	try {
-		current = await readFile(path, "utf8");
-	} catch (error) {
-		if (error.code !== "ENOENT") throw error;
-	}
-	if (current === body) return;
-	let mode = 0o600;
-	try {
-		mode = (await stat(path)).mode & 0o777;
-	} catch (error) {
-		if (error.code !== "ENOENT") throw error;
-	}
-	await mkdir(dirname(path), { recursive: true });
-	const temporaryPath = `${path}.${process.pid}.${randomBytes(8).toString("hex")}.tmp`;
-	try {
-		await writeFile(temporaryPath, body, { encoding: "utf8", mode });
-		if (process.platform !== "win32") await chmod(temporaryPath, mode);
-		await rename(temporaryPath, path);
-	} finally {
-		await unlink(temporaryPath).catch(() => {});
-	}
-}
+import { randomBytes } from "node:crypto";
+import { chmod, mkdir, readFile, rename, stat, unlink, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { TinyChatError } from "./errors.js";
+import { agentDir } from "./sessions.js";
+
+/**
+ * Pi owns compaction configuration. Pi TinyChat only reads and writes Pi's global
+ * settings so the UI can show the threshold as a percentage of the current
+ * model's context window. Project settings and per-model overrides are left
+ * entirely to Pi.
+ *
+ * Writes happen only on explicit user action, with an atomic rename. Do not
+ * edit the same settings file from Pi and Pi TinyChat at the same moment.
+ */
+const DEFAULT_RESERVE = 16_384;
+const ASSUMED_CONTEXT_WINDOW = 1_000_000;
+
+export function settingsPath(env = process.env) {
+	return join(agentDir(env), "settings.json");
+}
+
+async function readSettings(path, { strict = false } = {}) {
+	try {
+		const text = (await readFile(path, "utf8")).replace(/^\uFEFF/, "");
+		if (!text.trim()) return {};
+		const value = JSON.parse(text);
+		if (!value || typeof value !== "object" || Array.isArray(value)) {
+			if (strict) throw new TinyChatError("server.invalidSettings");
+			return {};
+		}
+		return value;
+	} catch (error) {
+		if (error instanceof TinyChatError) throw error;
+		if (error.code === "ENOENT") return {};
+		if (strict) throw new TinyChatError("server.readSettings", { message: error.message });
+		return {};
+	}
+}
+
+function safeInteger(value) {
+	return Number.isSafeInteger(value) && value >= 0 ? value : null;
+}
+
+export async function describeCompaction({ env = process.env, model }) {
+	const path = settingsPath(env);
+	const settings = await readSettings(path);
+	const compaction =
+		settings.compaction && typeof settings.compaction === "object" ? settings.compaction : {};
+	const contextWindow = safeInteger(model?.contextWindow) ?? 0;
+	const displayContextWindow = contextWindow || ASSUMED_CONTEXT_WINDOW;
+	const configuredReserve = safeInteger(compaction.reserveTokens);
+	const reserveTokens = configuredReserve ?? DEFAULT_RESERVE;
+	const thresholdTokens = Math.max(0, displayContextWindow - reserveTokens);
+	return {
+		enabled: compaction.enabled !== false,
+		settingsPath: path,
+		reserveTokens,
+		reserveSource: configuredReserve === null ? "pi-default" : "settings",
+		contextWindow,
+		displayContextWindow,
+		contextWindowKnown: contextWindow > 0,
+		thresholdTokens,
+		thresholdPercent: (thresholdTokens / displayContextWindow) * 100,
+	};
+}
+
+function pruneEmpty(settings) {
+	const compaction = settings.compaction;
+	if (!compaction || typeof compaction !== "object") return;
+	if (Object.keys(compaction).length === 0) delete settings.compaction;
+}
+
+export async function setCompactionThreshold({ env = process.env, model, percent }) {
+	const contextWindow = safeInteger(model?.contextWindow) ?? 0;
+	if (!contextWindow) throw new TinyChatError("server.contextUnknown");
+	if (typeof percent !== "number" || !Number.isFinite(percent) || percent <= 0 || percent >= 100) {
+		throw new TinyChatError("server.percentRange");
+	}
+
+	const path = settingsPath(env);
+	const settings = await readSettings(path, { strict: true });
+	const compaction =
+		settings.compaction && typeof settings.compaction === "object" ? settings.compaction : {};
+	compaction.reserveTokens = contextWindow - Math.round((contextWindow * percent) / 100);
+	settings.compaction = compaction;
+	await writeSettings(path, settings);
+	return describeCompaction({ env, model });
+}
+
+export async function clearCompactionThreshold({ env = process.env, model }) {
+	const path = settingsPath(env);
+	const settings = await readSettings(path, { strict: true });
+	const compaction =
+		settings.compaction && typeof settings.compaction === "object" ? settings.compaction : null;
+	if (!compaction) return describeCompaction({ env, model });
+	delete compaction.reserveTokens;
+	pruneEmpty(settings);
+	await writeSettings(path, settings);
+	return describeCompaction({ env, model });
+}
+
+export async function setCompactionEnabled({ env = process.env, enabled }) {
+	const path = settingsPath(env);
+	const settings = await readSettings(path, { strict: true });
+	const compaction =
+		settings.compaction && typeof settings.compaction === "object" ? settings.compaction : {};
+	compaction.enabled = Boolean(enabled);
+	settings.compaction = compaction;
+	await writeSettings(path, settings);
+	return { enabled: Boolean(enabled) };
+}
+
+async function writeSettings(path, settings) {
+	pruneEmpty(settings);
+	const body = `${JSON.stringify(settings, null, 2)}\n`;
+	let current = null;
+	try {
+		current = await readFile(path, "utf8");
+	} catch (error) {
+		if (error.code !== "ENOENT") throw error;
+	}
+	if (current === body) return;
+	let mode = 0o600;
+	try {
+		mode = (await stat(path)).mode & 0o777;
+	} catch (error) {
+		if (error.code !== "ENOENT") throw error;
+	}
+	await mkdir(dirname(path), { recursive: true });
+	const temporaryPath = `${path}.${process.pid}.${randomBytes(8).toString("hex")}.tmp`;
+	try {
+		await writeFile(temporaryPath, body, { encoding: "utf8", mode });
+		if (process.platform !== "win32") await chmod(temporaryPath, mode);
+		await rename(temporaryPath, path);
+	} finally {
+		await unlink(temporaryPath).catch(() => {});
+	}
+}

package/src/errors.js

@@ -1,13 +1,13 @@
-/**
- * A user-facing error generated by Pi TinyChat (not Pi/OS). The browser translates
- * `key` with its current language; the raw `message` stays for compatibility.
- */
-export class TinyChatError extends Error {
-	/** @param {string} key @param {Record<string, unknown>} [params] */
-	constructor(key, params = {}) {
-		super(key);
-		this.name = "TinyChatError";
-		this.key = key;
-		this.params = params;
-	}
-}
+/**
+ * A user-facing error generated by Pi TinyChat (not Pi/OS). The browser translates
+ * `key` with its current language; the raw `message` stays for compatibility.
+ */
+export class TinyChatError extends Error {
+	/** @param {string} key @param {Record<string, unknown>} [params] */
+	constructor(key, params = {}) {
+		super(key);
+		this.name = "TinyChatError";
+		this.key = key;
+		this.params = params;
+	}
+}

package/src/live.js

@@ -1,133 +1,133 @@
-/** @typedef {import("./pi-types.js").PiRecord} PiRecord */
-/** @typedef {import("./pi-types.js").PiAssistantMessageEvent} PiAssistantMessageEvent */
-/** @typedef {import("./pi-types.js").PiTextBlock} PiTextBlock */
-/** @typedef {import("./pi-types.js").PiToolOutput} PiToolOutput */
-
-/**
- * In-memory view of the assistant message currently being streamed.
- * Used only for snapshots (page reload during a run); rendering itself is
- * driven by the event stream in the browser.
- */
-export class LiveState {
-	#blocks = [];
-	#tools = new Map();
-
-	reset() {
-		this.#blocks = [];
-		this.#tools.clear();
-	}
-
-	/** @param {PiRecord} record */
-	apply(record) {
-		switch (record.type) {
-			case "agent_start":
-				this.reset();
-				break;
-			case "message_start":
-				if (record.message?.role === "assistant") this.#blocks = [];
-				break;
-			case "message_update":
-				this.#applyUpdate(record.assistantMessageEvent);
-				break;
-			case "tool_execution_start":
-				this.#tools.set(record.toolCallId, {
-					id: record.toolCallId,
-					name: record.toolName,
-					args: record.args,
-					status: "running",
-					output: "",
-					isError: false,
-				});
-				break;
-			case "tool_execution_update": {
-				const tool = this.#tools.get(record.toolCallId);
-				if (tool) tool.output = toolText(record.partialResult);
-				break;
-			}
-			case "tool_execution_end": {
-				const tool = this.#tools.get(record.toolCallId);
-				if (tool) {
-					tool.status = record.isError ? "error" : "done";
-					tool.isError = Boolean(record.isError);
-					tool.output = toolText(record.result) || tool.output;
-					tool.durationMs = record.durationMs;
-				}
-				break;
-			}
-			case "message_end":
-				if (record.message?.role === "assistant") this.#blocks = [];
-				break;
-			case "agent_settled":
-				this.reset();
-				break;
-		}
-	}
-
-	/** @param {PiAssistantMessageEvent} update */
-	#applyUpdate(update) {
-		if (!update || !("contentIndex" in update)) return;
-		const index = update.contentIndex;
-		const block = this.#blocks[index];
-		switch (update.type) {
-			case "text_start":
-				this.#blocks[index] = { type: "text", text: "" };
-				break;
-			case "text_delta":
-				if (block?.type === "text") block.text += update.delta;
-				break;
-			case "text_end":
-				this.#blocks[index] = { type: "text", text: update.content };
-				break;
-			case "thinking_start":
-				this.#blocks[index] = { type: "thinking", thinking: "" };
-				break;
-			case "thinking_delta":
-				if (block?.type === "thinking") block.thinking += update.delta;
-				break;
-			case "thinking_end":
-				this.#blocks[index] = { type: "thinking", thinking: update.content };
-				break;
-			case "toolcall_start":
-				this.#blocks[index] = {
-					type: "toolCall",
-					id: update.id,
-					name: update.toolName,
-					arguments: {},
-					partialArgs: "",
-				};
-				break;
-			case "toolcall_delta":
-				if (block?.type === "toolCall") block.partialArgs += update.delta;
-				break;
-			case "toolcall_end": {
-				const call = update.toolCall;
-				this.#blocks[index] = {
-					type: "toolCall",
-					id: call.id,
-					name: call.name,
-					arguments: call.arguments ?? {},
-				};
-				break;
-			}
-		}
-	}
-
-	snapshot() {
-		const blocks = this.#blocks.filter(Boolean);
-		return {
-			blocks,
-			tools: Object.fromEntries(this.#tools),
-		};
-	}
-}
-
-/** @param {PiToolOutput | string | null | undefined} result */
-export function toolText(result) {
-	if (!result) return "";
-	if (typeof result === "string") return result;
-	const content = result.content ?? result.partialResult?.content ?? [];
-	if (typeof content === "string") return content;
-	if (!Array.isArray(content)) return "";
-	const texts = /** @type {PiTextBlock[]} */ (content.filter((block) => block?.type === "text"));
-	return texts.map((block) => block.text).join("\n");
-}
+/** @typedef {import("./pi-types.js").PiRecord} PiRecord */
+/** @typedef {import("./pi-types.js").PiAssistantMessageEvent} PiAssistantMessageEvent */
+/** @typedef {import("./pi-types.js").PiTextBlock} PiTextBlock */
+/** @typedef {import("./pi-types.js").PiToolOutput} PiToolOutput */
+
+/**
+ * In-memory view of the assistant message currently being streamed.
+ * Used only for snapshots (page reload during a run); rendering itself is
+ * driven by the event stream in the browser.
+ */
+export class LiveState {
+	#blocks = [];
+	#tools = new Map();
+
+	reset() {
+		this.#blocks = [];
+		this.#tools.clear();
+	}
+
+	/** @param {PiRecord} record */
+	apply(record) {
+		switch (record.type) {
+			case "agent_start":
+				this.reset();
+				break;
+			case "message_start":
+				if (record.message?.role === "assistant") this.#blocks = [];
+				break;
+			case "message_update":
+				this.#applyUpdate(record.assistantMessageEvent);
+				break;
+			case "tool_execution_start":
+				this.#tools.set(record.toolCallId, {
+					id: record.toolCallId,
+					name: record.toolName,
+					args: record.args,
+					status: "running",
+					output: "",
+					isError: false,
+				});
+				break;
+			case "tool_execution_update": {
+				const tool = this.#tools.get(record.toolCallId);
+				if (tool) tool.output = toolText(record.partialResult);
+				break;
+			}
+			case "tool_execution_end": {
+				const tool = this.#tools.get(record.toolCallId);
+				if (tool) {
+					tool.status = record.isError ? "error" : "done";
+					tool.isError = Boolean(record.isError);
+					tool.output = toolText(record.result) || tool.output;
+					tool.durationMs = record.durationMs;
+				}
+				break;
+			}
+			case "message_end":
+				if (record.message?.role === "assistant") this.#blocks = [];
+				break;
+			case "agent_settled":
+				this.reset();
+				break;
+		}
+	}
+
+	/** @param {PiAssistantMessageEvent} update */
+	#applyUpdate(update) {
+		if (!update || !("contentIndex" in update)) return;
+		const index = update.contentIndex;
+		const block = this.#blocks[index];
+		switch (update.type) {
+			case "text_start":
+				this.#blocks[index] = { type: "text", text: "" };
+				break;
+			case "text_delta":
+				if (block?.type === "text") block.text += update.delta;
+				break;
+			case "text_end":
+				this.#blocks[index] = { type: "text", text: update.content };
+				break;
+			case "thinking_start":
+				this.#blocks[index] = { type: "thinking", thinking: "" };
+				break;
+			case "thinking_delta":
+				if (block?.type === "thinking") block.thinking += update.delta;
+				break;
+			case "thinking_end":
+				this.#blocks[index] = { type: "thinking", thinking: update.content };
+				break;
+			case "toolcall_start":
+				this.#blocks[index] = {
+					type: "toolCall",
+					id: update.id,
+					name: update.toolName,
+					arguments: {},
+					partialArgs: "",
+				};
+				break;
+			case "toolcall_delta":
+				if (block?.type === "toolCall") block.partialArgs += update.delta;
+				break;
+			case "toolcall_end": {
+				const call = update.toolCall;
+				this.#blocks[index] = {
+					type: "toolCall",
+					id: call.id,
+					name: call.name,
+					arguments: call.arguments ?? {},
+				};
+				break;
+			}
+		}
+	}
+
+	snapshot() {
+		const blocks = this.#blocks.filter(Boolean);
+		return {
+			blocks,
+			tools: Object.fromEntries(this.#tools),
+		};
+	}
+}
+
+/** @param {PiToolOutput | string | null | undefined} result */
+export function toolText(result) {
+	if (!result) return "";
+	if (typeof result === "string") return result;
+	const content = result.content ?? result.partialResult?.content ?? [];
+	if (typeof content === "string") return content;
+	if (!Array.isArray(content)) return "";
+	const texts = /** @type {PiTextBlock[]} */ (content.filter((block) => block?.type === "text"));
+	return texts.map((block) => block.text).join("\n");
+}