@xynogen/pix-runtime 0.3.1 → 0.4.2

package/DESIGN.md

@@ -132,7 +132,6 @@ interface PixConfigV1 {
   optimizer: {
     caveman: "off" | "lite" | "full" | "ultra" | "micro"; // default off
     rtk: "off" | "on";                                      // default on
-    toon: "off" | "on";                                     // default on
     ponytail: "off" | "lite" | "full" | "ultra";          // default off
   };
   gate: {

package/README.md

@@ -10,7 +10,7 @@ See `DESIGN.md` for the full contract.
 ## What it does
 
 - Versioned, sparse `pix.json` (`$version: 1`) — defaults resolve in code.
-- Typed sections: `collapse`, `pretty`, `optimizer`, `gate`.
+- Typed sections: `collapse`, `pretty`, `io`, `optimizer`, `gate`.
 - Atomic writes behind a serialized in-process queue and a short-lived
   cross-process lock. A failed write leaves the old file intact.
 - Immutable, deeply frozen config snapshots with a monotonic revision.
@@ -38,8 +38,17 @@ import { prettySection } from "@xynogen/pix-runtime/sections";
 const icons = config(prettySection).icons;         // synchronous read
 await updateConfig(prettySection, { icons: "ascii" });
 const off = onConfigChange((c) => render(), { paths: ["pretty.icons"] });
+
+import { ioTimeoutMs, ioTimeoutSignal } from "@xynogen/pix-runtime/io";
+const timeoutMs = ioTimeoutMs();                    // shared network timeout
+const signal = ioTimeoutSignal(toolSignal);         // timeout + cancellation
 ```
 
+Set `io.timeoutSec` in `~/.pi/agent/pix.json`, or change **Network → timeout (sec)**
+with `/pix`. The default is 30 seconds. It applies to Pix network operations,
+including remote skills, web fetch/search/transcription, MCP requests and
+connection bootstrap, background model-data refreshes, and update downloads.
+
 Collapse policy helpers:
 
 ```ts

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@xynogen/pix-runtime",
-	"version": "0.3.1",
+	"version": "0.4.2",
 	"description": "Pix shared runtime — versioned pix.json config, atomic persistence, typed change events",
 	"type": "module",
 	"main": "src/index.ts",
@@ -24,6 +24,7 @@
 		"./config": "./src/runtime.ts",
 		"./sections": "./src/sections/index.ts",
 		"./collapse": "./src/collapse.ts",
+		"./io": "./src/io.ts",
 		"./once": "./src/once.ts",
 		"./testing": "./src/testing.ts"
 	},

package/src/index.ts

@@ -7,6 +7,7 @@ export type {
 	SubscribeOptions,
 } from "./events.ts";
 export { default } from "./extension.ts";
+export { ioTimeoutMs, ioTimeoutSignal } from "./io.ts";
 export {
 	config,
 	createRuntime,
@@ -34,6 +35,8 @@ export {
 	type GateConfig,
 	type GateRuleConfig,
 	gateSection,
+	type IoConfig,
+	ioSection,
 	type OptimizerConfig,
 	optimizerSection,
 	type PrettyConfig,

package/src/io.ts

@@ -0,0 +1,11 @@
+import { config } from "./runtime.ts";
+import { ioSection } from "./sections/io.ts";
+
+export function ioTimeoutMs(): number {
+	return config(ioSection).timeoutSec * 1000;
+}
+
+export function ioTimeoutSignal(signal?: AbortSignal): AbortSignal {
+	const timeout = AbortSignal.timeout(ioTimeoutMs());
+	return signal ? AbortSignal.any([signal, timeout]) : timeout;
+}

package/src/migrations.ts

@@ -25,7 +25,7 @@ const LEGACY_DIFF_COLOR_KEYS = [
 	"fgDel",
 ] as const;
 
-const OPTIMIZER_KEYS = ["caveman", "rtk", "toon", "ponytail"] as const;
+const OPTIMIZER_KEYS = ["caveman", "rtk", "ponytail"] as const;
 
 export interface MigrationResult {
 	document: RawDocument;
@@ -80,6 +80,14 @@ export function migrate(input: RawDocument, ctx: ParseContext): MigrationResult
 		doc.pretty = pretty;
 	}
 
+	// TOON is now an on-demand pix-skills capability, not optimizer state.
+	if (isObj(doc.optimizer) && "toon" in doc.optimizer) {
+		doc.optimizer = Object.fromEntries(
+			Object.entries(doc.optimizer).filter(([key]) => key !== "toon"),
+		);
+		changed = true;
+	}
+
 	if (doc.$version !== CONFIG_FORMAT_VERSION) {
 		doc.$version = CONFIG_FORMAT_VERSION;
 		changed = true;
@@ -128,6 +136,7 @@ export function importOptimizerSidecar(
 	}
 	if (changed) doc.optimizer = existing;
 
+	const hasLegacyToon = typeof raw.toon === "string";
 	const archive = () => {
 		let target = `${sidecarPath}.migrated-v1`;
 		if (existsSync(target)) target = `${target}.${Date.now()}`;
@@ -138,5 +147,5 @@ export function importOptimizerSidecar(
 		}
 	};
 
-	return { changed, archive };
+	return { changed: changed || hasLegacyToon, archive };
 }

package/src/pix-command.ts

@@ -19,6 +19,7 @@ import type { PixRuntime } from "./runtime.ts";
 import type { DeepPartial, SectionHandle } from "./schema.ts";
 import { collapseSection } from "./sections/collapse.ts";
 import { gateSection } from "./sections/gate.ts";
+import { ioSection } from "./sections/io.ts";
 import { prettySection } from "./sections/pretty.ts";
 
 interface SettingRow<T> {
@@ -68,6 +69,14 @@ const SETTINGS: SettingRow<unknown>[] = [
 		read: (v) => String(v.delaySec),
 		patch: (value) => ({ delaySec: Number(value) }),
 	}),
+	row({
+		section: "Network",
+		label: "timeout (sec)",
+		handle: ioSection,
+		values: ["30", "10", "60", "120", "300"],
+		read: (v) => String(v.timeoutSec),
+		patch: (value) => ({ timeoutSec: Number(value) }),
+	}),
 	row({
 		section: "Gate",
 		label: "Guardrails",
@@ -120,6 +129,9 @@ export function registerPixCommand(pi: ExtensionAPI, runtime: PixRuntime): void
 					kb: KeybindingsManager,
 					done: (v: null) => void,
 				) => {
+					const guide = (key: string, action: string) =>
+						theme.fg("text", key) + theme.fg("dim", ` ${action}`);
+					const guideSep = theme.fg("dim", " · ");
 					let selected = 0;
 					let bodyOffset = 0;
 					let visibleBodyLines = 1;
@@ -168,7 +180,13 @@ export function registerPixCommand(pi: ExtensionAPI, runtime: PixRuntime): void
 								body,
 								footer: [
 									"",
-									theme.fg("dim", "←→ change · ↑↓ move · PgUp/PgDn inspect · esc close"),
+									guide("←→", "change") +
+										guideSep +
+										guide("↑↓", "move") +
+										guideSep +
+										guide("PgUp/PgDn", "inspect") +
+										guideSep +
+										guide("esc", "close"),
 								],
 								bodyOffset,
 								selectedBodyLine: inspectingPage ? undefined : settingBodyLines[selected],

package/src/sections/index.ts

@@ -5,6 +5,7 @@ export {
 	type GateSeverity,
 	gateSection,
 } from "./gate.ts";
+export { type IoConfig, ioSection } from "./io.ts";
 export {
 	type CavemanLevel,
 	type OptimizerConfig,
@@ -22,6 +23,7 @@ export {
 
 import { collapseSection } from "./collapse.ts";
 import { gateSection } from "./gate.ts";
+import { ioSection } from "./io.ts";
 import { optimizerSection } from "./optimizer.ts";
 import { prettySection } from "./pretty.ts";
 
@@ -29,6 +31,7 @@ import { prettySection } from "./pretty.ts";
 export const builtinSections = [
 	collapseSection,
 	prettySection,
+	ioSection,
 	optimizerSection,
 	gateSection,
 ] as const;

package/src/sections/io.ts

@@ -0,0 +1,21 @@
+import { defineSection, isObj, posNumOr } from "../schema.ts";
+
+export interface IoConfig {
+	/** Default timeout in seconds for Pix network requests. */
+	timeoutSec: number;
+}
+
+const DEFAULTS: Readonly<IoConfig> = {
+	timeoutSec: 30,
+};
+
+export const ioSection = defineSection<"io", IoConfig>({
+	key: "io",
+	defaults: DEFAULTS,
+	parse(raw) {
+		if (!isObj(raw)) return { ...DEFAULTS };
+		return {
+			timeoutSec: posNumOr(raw.timeoutSec, DEFAULTS.timeoutSec),
+		};
+	},
+});

package/src/sections/optimizer.ts

@@ -7,7 +7,6 @@ export type Toggle = "off" | "on";
 export interface OptimizerConfig {
 	caveman: CavemanLevel;
 	rtk: Toggle;
-	toon: Toggle;
 	ponytail: PonytailLevel;
 }
 
@@ -18,7 +17,6 @@ const TOGGLE: readonly Toggle[] = ["off", "on"];
 const DEFAULTS: Readonly<OptimizerConfig> = {
 	caveman: "off",
 	rtk: "on",
-	toon: "on",
 	ponytail: "off",
 };
 
@@ -30,7 +28,6 @@ export const optimizerSection = defineSection<"optimizer", OptimizerConfig>({
 		return {
 			caveman: enumOr(raw.caveman, CAVEMAN, DEFAULTS.caveman),
 			rtk: enumOr(raw.rtk, TOGGLE, DEFAULTS.rtk),
-			toon: enumOr(raw.toon, TOGGLE, DEFAULTS.toon),
 			ponytail: enumOr(raw.ponytail, PONYTAIL, DEFAULTS.ponytail),
 		};
 	},