@north-light/crouter 0.3.188 → 0.3.189

package/dist/api/dto/nodes.d.ts

@@ -16,6 +16,10 @@ export interface CreateNodeRequest {
     name?: string;
     parent?: NodeIdDTO | null;
     root?: boolean;
+    /** Lifecycle of an independent root. Defaults to `resident`; use `terminal`
+     *  for bounded, unattended work that must finalize rather than remain an
+     *  ongoing conversation. Only valid with `root: true`. */
+    root_lifecycle?: LifecycleDTO;
     /** Worktree branch name, or true for an auto-named managed worktree. */
     worktree?: string | boolean;
     fork_from?: string;

package/dist/daemon/api/handlers/nodes.js

@@ -85,6 +85,15 @@ function parseCreateBody(body) {
     if (typeof b['kind'] !== 'string' || b['kind'].trim() === '') {
         throw usage('a node create requires a kind');
     }
+    const rootLifecycle = b['root_lifecycle'];
+    if (rootLifecycle !== undefined &&
+        rootLifecycle !== 'resident' &&
+        rootLifecycle !== 'terminal') {
+        throw usage("root_lifecycle must be 'resident' or 'terminal'");
+    }
+    if (rootLifecycle !== undefined && b['root'] !== true) {
+        throw usage('root_lifecycle is only valid with root: true');
+    }
     return b;
 }
 /** The directory a new node is pinned to. An explicit `pin_cwd` wins; else a
@@ -122,6 +131,9 @@ function buildRecipe(req, parent, cwd) {
         recipe.parent = parent;
     if (req.root === true)
         recipe.root = true;
+    if (req.root_lifecycle !== undefined) {
+        recipe.rootLifecycle = req.root_lifecycle;
+    }
     if (req.worktree === true || typeof req.worktree === 'string')
         recipe.worktree = true;
     if (typeof req.worktree === 'string')
@@ -143,7 +155,8 @@ function buildRecipe(req, parent, cwd) {
  *  kickoff, so anything that shapes the node AT BIRTH — a prompt to run, a
  *  forked conversation, a managed worktree, a caller-pinned node id, a spine
  *  parent — disqualifies it. `kind`, `mode`, `model`, `name`, `situational_context`
- *  and `output_schema` are all applied at claim time and so do not. */
+ *  and `output_schema` are all applied at claim time and so do not. A terminal
+ *  root is not warm-compatible: every spare is resident. */
 function warmRequestFor(req, cwd, profileId) {
     if (!warmPoolEnabled())
         return null;
@@ -151,6 +164,8 @@ function warmRequestFor(req, cwd, profileId) {
         return null;
     if (req.root !== true || req.parent != null)
         return null;
+    if (req.root_lifecycle === 'terminal')
+        return null;
     if ((req.prompt ?? '') !== '')
         return null;
     if (req.fork_from !== undefined || req.worktree !== undefined || req.node_id !== undefined)
@@ -210,7 +225,7 @@ export async function handleCreate(ctx, deps = {}) {
     const profileId = await resolveProfileId(req.profile, parent ?? null, contextCwd);
     const cwd = resolveNodeCwd(req, parent, profileId, contextCwd);
     const launch = buildLaunchSpec(req.kind, (req.mode ?? 'base'), {
-        lifecycle: req.root === true ? 'resident' : 'terminal',
+        lifecycle: req.root === true ? (req.root_lifecycle ?? 'resident') : 'terminal',
         hasManager: req.root !== true,
         ...(req.model !== undefined ? { model: req.model } : {}),
         cwd,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/crouter",
-  "version": "0.3.188",
+  "version": "0.3.189",
   "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.188",
+  "version": "0.3.189",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@north-light/crouter",
-      "version": "0.3.188",
+      "version": "0.3.189",
       "hasInstallScript": true,
       "license": "MIT",
       "dependencies": {