switchback-core 2026.10.15 → 2026.10.16

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "switchback-core",
-	"version": "2026.10.15",
+	"version": "2026.10.16",
 	"type": "module",
 	"description": "Host-agnostic core for switchback: fallback routing, error classification ports, block state and configuration.",
 	"license": "MIT",

package/src/config-editor.ts

@@ -36,7 +36,7 @@ import { join } from "node:path";
 import { writeFileAtomic } from "./atomic-write.ts";
 import { isMap, isSeq, parseDocument, type Document, type YAMLMap, type YAMLSeq } from "yaml";
 import { ConfigError, piConfigDir, validateFileConfig } from "./config.ts";
-import type { ModelId, SwitchbackFileConfig } from "./types.ts";
+import type { IdleResetConfig, ModelId, SwitchbackFileConfig } from "./types.ts";
 
 /** Which switchback.yaml layer the editor has open. */
 export type ConfigLayer = "global" | "project";
@@ -405,6 +405,22 @@ export function countDecisionModelReferences(loaded: LoadedLayer, address: strin
 	return count;
 }
 
+/**
+ * Set or clear a model's `idleReset:` option. A duration ("30m", "2h", ...)
+ * returns to the head of the fallback list after that much idle time;
+ * `classifier` asks the decision model; `null` deletes the key, which is the
+ * loader's default (`never`). Validation of the value itself is the loader's
+ * job at save time, so an unknown value surfaces with the loader's message.
+ */
+export function setIdleReset(loaded: LoadedLayer, virtualId: string, option: IdleResetConfig | null): void {
+	const { node } = findModelNode(loaded, virtualId);
+	if (option === null) {
+		node.delete("idleReset");
+		return;
+	}
+	node.set("idleReset", option);
+}
+
 /** Set the top-level `debug:` flag (per-switch diagnostics notifications). */
 export function setDebug(loaded: LoadedLayer, enabled: boolean): void {
 	loaded.doc.set("debug", enabled);

package/src/index.ts

@@ -53,13 +53,18 @@ export {
 	disableModel,
 	disabledFilePath,
 	enableModel,
+	getPinnedModel,
 	isBlocked,
 	isDisabled,
+	pinFilePath,
 	readBlockedMap,
 	readDisabledMap,
-	unblockModel,
+	readPinMap,
+	setPinnedModel,
 	stateFilePath,
+	unblockModel,
 } from "./state.ts";
+export type { PinMap } from "./state.ts";
 export {
 	readCrashMap,
 	recordCrash,
@@ -115,6 +120,7 @@ export {
 	setDecisionModel,
 	setDebug,
 	setFallbacks,
+	setIdleReset,
 	setVirtualModelName,
 	updateDecisionModel,
 } from "./config-editor.ts";