@north-light/crouter-api 0.3.175 → 0.3.177

package/dist/client.d.ts

@@ -33,7 +33,7 @@ export interface CrtrClientOptions {
      *  autostart is on; after it resolves, the client polls `/healthz` and retries
      *  the original request once. Absent → a cold socket throws `daemon_unavailable`. */
     onColdSocket?: () => Promise<void>;
-    /** Injected cold-start diagnostic (issue #516). Called ONLY when the bounded
+    /** Injected cold-start diagnostic. Called ONLY when the bounded
      *  `/healthz` poll times out after `onColdSocket`, so the caller can attach
      *  operator-useful context (e.g. a bounded tail of crtrd's stderr log) to the
      *  `daemon_unavailable` error instead of it staying a bare message. Must
@@ -43,7 +43,7 @@ export interface CrtrClientOptions {
     /** Bounded window (ms) to poll `/healthz` after `onColdSocket` resolves
      *  before giving up with `daemon_unavailable`. Defaults to
      *  `HEALTHZ_POLL_WINDOW_MS`. This must NOT silently drift from whatever
-     *  window actually governs "did the daemon start" (issue #508 follow-up):
+     *  window actually governs "did the daemon start":
      *  `onColdSocket` is fire-and-forget, so this poll is the ONLY deadline that
      *  determines whether the CLI reports success. A caller whose `onColdSocket`
      *  hook triggers a differently-windowed startup verifier (e.g. the CLI's
@@ -253,8 +253,8 @@ export declare class CrtrClient {
     private handleColdSocket;
 }
 /** Compose the cold-start `/healthz`-timeout `daemon_unavailable` message,
- *  appending the injected diagnostic (issue #516) when one is present instead
- *  of discarding the real startup failure behind a bare message. Exported (not
+ *  appending the injected diagnostic when one is present instead of discarding
+ *  the real startup failure behind a bare message. Exported (not
  *  from the package's public `index.ts` surface, which is dependency-light by
  *  design) purely so the regression test can assert the composition without
  *  waiting out the real poll window. */

package/dist/client.js

@@ -655,8 +655,8 @@ function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
 /** Compose the cold-start `/healthz`-timeout `daemon_unavailable` message,
- *  appending the injected diagnostic (issue #516) when one is present instead
- *  of discarding the real startup failure behind a bare message. Exported (not
+ *  appending the injected diagnostic when one is present instead of discarding
+ *  the real startup failure behind a bare message. Exported (not
  *  from the package's public `index.ts` surface, which is dependency-light by
  *  design) purely so the regression test can assert the composition without
  *  waiting out the real poll window. */

package/dist/dto/lifecycle.d.ts

@@ -3,7 +3,7 @@ import type { NodeIdDTO, NodeStatusDTO } from './common.js';
 export interface ReviveRequest {
     /** Resume the saved conversation (true) vs a fresh launch (false). */
     resume?: boolean;
-    /** Clear the finalization latch before reviving (#339 `--reopen` gate). The
+    /** Clear the finalization latch before reviving (the `--reopen` gate). The
      *  latch clear is a canvas write, so the gate is enforced server-side: with
      *  `reopen:false` (default) a finalized node is REJECTED (`node_finalized`);
      *  with `reopen:true` a node that is NOT finalized is rejected

package/dist/dto/nodes.d.ts

@@ -5,7 +5,13 @@ export interface CreateNodeRequest {
     prompt?: string;
     profile?: string;
     mode?: ModeDTO;
+    /** The DIRECTORY CONTEXT the create came from — not necessarily where the
+     *  node lands. It is what the daemon selects a profile from when the request
+     *  neither names one nor inherits one from a parent. */
     cwd?: string;
+    /** Pin the node to this exact directory, overriding the profile home a node
+     *  otherwise runs in. See `crtr node new --cwd`. */
+    pin_cwd?: string;
     /** Display name (tmux window + resume picker). Defaults to the kind. */
     name?: string;
     parent?: NodeIdDTO | null;
@@ -22,7 +28,7 @@ export interface CreateNodeRequest {
      *  HTTP 409 `node_id_exists`). See `crtr node new --node-id`. */
     node_id?: string;
     /** Serve this create from the warm pool when a pre-booted spare matches the
-     *  request's frozen launch tuple (kind, mode, cwd, profile, model,
+     *  request's frozen launch tuple (kind, mode, resolved cwd, profile, model,
      *  situational_context) — answering in milliseconds instead of waiting out a
      *  full engine boot. Only a bare root with no kickoff qualifies; anything the
      *  pool cannot honor (or an empty pool) falls back to an ordinary cold spawn,

package/dist/dto/profiles.d.ts

@@ -9,6 +9,9 @@ export interface ProfileDTO {
     id: string;
     name: string;
     projects: string[];
+    /** Where nodes under this profile run — one of `projects` (the first unless
+     *  re-pointed), or null when the profile owns none. */
+    home: string | null;
     /** The directory this profile is pinned as default for, if any. */
     default_dir?: string | null;
 }

package/dist/dto/reports.d.ts

@@ -20,7 +20,7 @@ export interface PushReportResultDTO {
     /** Present (and true) only for a `final` push whose reporting node owned a
      *  managed worktree with zero commits ahead of its base and no uncommitted
      *  changes: the server auto-dropped it instead of blocking on `node worktree
-     *  close` (#327/#333). A worktree with real unlanded work instead blocks with
+     *  close`. A worktree with real unlanded work instead blocks with
      *  an `open_managed_worktree` error. */
     worktree_auto_dropped?: boolean;
     /** Present only alongside `worktree_auto_dropped`: the checkout path dropped. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/crouter-api",
-  "version": "0.3.175",
+  "version": "0.3.177",
   "description": "Typed crtrd /v1 API contract — DTOs, route builders, the error contract, and the CrtrClient. Zero runtime dependencies.",
   "type": "module",
   "main": "./dist/index.js",