@north-light/crouter 0.3.263 → 0.3.269

package/dist/shared/env.d.ts

@@ -8,6 +8,8 @@ export declare function envNodeCwd(): string | undefined;
  *  undefined. Cleared (not read) via `delete process.env['CRTR_MODEL_INTENT']`
  *  in `runtime/broker.ts` — a mutation, not a read, so it stays there. */
 export declare function envModelIntent(): string | undefined;
+/** Whether the launch recipe requires this broker to keep its exact provider/model. */
+export declare function envModelExact(): boolean;
 /** The raw `CRTR_HOME` override, unresolved. Use `crtrHome()`
  *  (`core/canvas/paths.ts`) to get the resolved canvas-home path; use this
  *  only when a caller needs the override itself — to check whether one is
@@ -67,6 +69,14 @@ export declare function envWarnLiveBrokers(): number | undefined;
 /** Test-only unattended-park interval override (`CRTR_TEST_UNATTENDED_PARK_MS`),
  *  gated by `envNoDaemonAutostart()` at the call site; no production default. */
 export declare function envTestUnattendedParkMs(): number | undefined;
+/** Production unattended-park interval override (`CRTR_UNATTENDED_PARK_MS`), in
+ *  milliseconds; wins over the user-scope config value
+ *  (`readConfig('user').lifecycle.unattendedParkMs`, itself defaulting to 15
+ *  min) whenever set, autostart or not. Unlike `CRTR_TEST_UNATTENDED_PARK_MS`
+ *  this is not gated on `envNoDaemonAutostart()`: it is the env escape hatch
+ *  above the configured knob a deployment sets to tune how long an eligible
+ *  resident idles before its parking turn. */
+export declare function envUnattendedParkMs(): number | undefined;
 /** Test-only park-summary grace-period override
  *  (`CRTR_TEST_PARK_SUMMARY_GRACE_MS`); no production default. */
 export declare function envTestParkSummaryGraceMs(): number | undefined;

package/dist/shared/env.js

@@ -40,6 +40,10 @@ export function envNodeCwd() {
 export function envModelIntent() {
     return process.env['CRTR_MODEL_INTENT'];
 }
+/** Whether the launch recipe requires this broker to keep its exact provider/model. */
+export function envModelExact() {
+    return process.env['CRTR_MODEL_EXACT'] === '1';
+}
 /** The raw `CRTR_HOME` override, unresolved. Use `crtrHome()`
  *  (`core/canvas/paths.ts`) to get the resolved canvas-home path; use this
  *  only when a caller needs the override itself — to check whether one is
@@ -140,10 +144,11 @@ export function envDebug() {
     return process.env['CRTR_DEBUG'] === '1';
 }
 // Precedence — broker-supervision.ts's threshold/interval overrides. Each
-// returns the raw parsed value with NO default: the caller (config for the
-// thresholds, a hardcoded production constant for the intervals) supplies
-// the default, and env wins over it when set. Undefined, unparseable, or
-// non-positive all mean "no override" — the caller's own default applies.
+// returns the raw parsed value with NO default: the caller supplies the
+// default (user config for the broker thresholds and the unattended-park
+// interval, a hardcoded constant for the test-only park-summary grace), and
+// env wins over it when set. Undefined, unparseable, or non-positive all mean
+// "no override" — the caller's own default applies.
 function parsePositiveInteger(raw) {
     if (raw === undefined || raw === '')
         return undefined;
@@ -171,6 +176,16 @@ function parsePositiveMsNoDefault(raw) {
 export function envTestUnattendedParkMs() {
     return parsePositiveMsNoDefault(process.env['CRTR_TEST_UNATTENDED_PARK_MS']);
 }
+/** Production unattended-park interval override (`CRTR_UNATTENDED_PARK_MS`), in
+ *  milliseconds; wins over the user-scope config value
+ *  (`readConfig('user').lifecycle.unattendedParkMs`, itself defaulting to 15
+ *  min) whenever set, autostart or not. Unlike `CRTR_TEST_UNATTENDED_PARK_MS`
+ *  this is not gated on `envNoDaemonAutostart()`: it is the env escape hatch
+ *  above the configured knob a deployment sets to tune how long an eligible
+ *  resident idles before its parking turn. */
+export function envUnattendedParkMs() {
+    return parsePositiveMsNoDefault(process.env['CRTR_UNATTENDED_PARK_MS']);
+}
 /** Test-only park-summary grace-period override
  *  (`CRTR_TEST_PARK_SUMMARY_GRACE_MS`); no production default. */
 export function envTestParkSummaryGraceMs() {

package/dist/types.d.ts

@@ -157,6 +157,14 @@ export interface BrokerThresholdsConfig {
     /** Defer daemon-initiated revives once the live broker census reaches this count. */
     automaticReviveCap: number;
 }
+/** Host-wide node-lifecycle timing. Read only from user scope by crtrd, like
+ *  `brokerThresholds`: project configuration must not change another user's
+ *  daemon. */
+export interface LifecycleConfig {
+    /** How long an eligible resident idles before its unattended-parking turn
+     *  begins, in milliseconds. `CRTR_UNATTENDED_PARK_MS` overrides this. */
+    unattendedParkMs: number;
+}
 export type KeybindingOverrides = Record<string, string[]>;
 /** Compile-time seam for runtime consumers migrating to semantic binding IDs. */
 export type CanvasAction = {
@@ -251,6 +259,8 @@ export interface ScopeConfig {
      *  Independent attended roots keep their normal viewer behavior. */
     auto_open_child_viewers: boolean;
     brokerThresholds: BrokerThresholdsConfig;
+    /** Host-wide node-lifecycle timing (user scope only). */
+    lifecycle: LifecycleConfig;
     /** Ring a short completion sound in the attach viewer when the node you are
      *  watching finishes a turn and hands control back (the Claude-Code Stop-hook
      *  ding). Only ever fires inside a live viewer pane — a headless/background

package/dist/types.js

@@ -82,6 +82,10 @@ export function defaultScopeConfig() {
         // sized as a backstop that actually engages before the machine does.
         // Override per host with CRTR_MAX_LIVE_BROKERS / CRTR_WARN_LIVE_BROKERS.
         brokerThresholds: { warning: 16, automaticReviveCap: 32 },
+        // The unattended-park idle-eligibility delay: how long an eligible resident
+        // idles before its parking turn begins. Override per host with
+        // CRTR_UNATTENDED_PARK_MS.
+        lifecycle: { unattendedParkMs: 15 * 60_000 },
         completion_bell: true,
         working_gerunds: [...DEFAULT_WORKING_GERUNDS],
         whip_mode: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/crouter",
-  "version": "0.3.263",
+  "version": "0.3.269",
   "description": "crtr — agent runtime with memory, plugins, and marketplaces",
   "type": "module",
   "main": "dist/index.js",

package/runtime.lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@north-light/crouter",
-  "version": "0.3.263",
+  "version": "0.3.269",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@north-light/crouter",
-      "version": "0.3.263",
+      "version": "0.3.269",
       "hasInstallScript": true,
       "license": "MIT",
       "dependencies": {