@xynogen/pix-runtime 0.3.1 → 0.4.0

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.0",
 	"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/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",

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),
+		};
+	},
+});