@north-light/crouter-api 0.3.235 → 0.3.237

package/dist/api/client.d.ts

@@ -20,7 +20,7 @@ import type { CreateReviewCommentRequest, EditReviewCommentRequest, ListReviewCo
 import type { CancelInboxTicketRequest, CanceledTicketResultDTO, InboxListDTO, InboxPageDTO, InboxPageHistoryDTO, InboxPageResponseDTO, InboxTicketIdDTO, PageFeedbackResolutionDTO, PageResponsesDTO, PageTicketResultDTO, RespondInboxPageRequest } from './dto/inbox.js';
 import type { CreateHumanRequestDTO, CreateHumanRequestRequest, HumanRequestDTO, HumanRequestIdDTO, ReplaceHumanRequestRequest, RespondHumanRequestRequest, SettleHumanRequestRequest } from './dto/human-requests.js';
 import type { AttentionCountsDTO, AttentionDTO, DashboardDTO, DashboardQuery, HistoryGrepQuery, HistoryGrepResultDTO, HistoryReadQuery, HistoryReadResultDTO, HistorySearchQuery, HistorySearchResultDTO, PruneRequest, PruneResultDTO, RebuildIndexResultDTO, RosterDTO, SnapshotDTO } from './dto/canvas.js';
-import type { CloseWorktreeResultDTO } from './dto/worktree.js';
+import type { AbandonWorktreeRequest, AbandonWorktreeResultDTO, CloseWorktreeResultDTO } from './dto/worktree.js';
 import type { BrokerExtensionStateDTO, BrokerGeneratedNameRequest, BrokerGeneratedNameResultDTO, BrokerInboxCursorDirective, BrokerInboxCursorRequest, BrokerModelCommitRequest, BrokerModelCommitResultDTO, BrokerPersonaAckRequest, BrokerPersonaAckResultDTO, BrokerSessionBoundRequest, BrokerSessionBoundResultDTO, BrokerSettleDirective, BrokerSettleRequest } from './dto/broker-ops.js';
 export interface CrtrClientOptions {
     /** Unix socket path (default local transport). Exactly one of socketPath|baseUrl. */
@@ -113,6 +113,7 @@ export declare class CrtrClient {
      *  because it interleaves a canvas WRITE with a git land transaction and
      *  crtrd is the repo host (same principle as spawnChild's creation git). */
     closeWorktree(id: string): Promise<CloseWorktreeResultDTO>;
+    abandonWorktree(id: string, req: AbandonWorktreeRequest): Promise<AbandonWorktreeResultDTO>;
     subscribe(id: string, req: SubscribeRequest): Promise<SubscriptionDTO>;
     listFocuses(): Promise<FocusDTO[]>;
     focusOf(nodeId: string): Promise<FocusDTO | null>;

package/dist/api/client.js

@@ -176,6 +176,9 @@ export class CrtrClient {
     closeWorktree(id) {
         return this.request('POST', routes.nodeWorktreeClose(this.nodePath(id)), {});
     }
+    abandonWorktree(id, req) {
+        return this.request('POST', routes.nodeWorktreeAbandon(this.nodePath(id)), req);
+    }
     subscribe(id, req) {
         return this.request('POST', routes.nodeSubscriptions(this.nodePath(id)), req);
     }

package/dist/api/dto/broker-ops.d.ts

@@ -75,7 +75,7 @@ export interface BrokerExtensionNodeDTO {
     fork_from: string | null;
     profile_id: string | null;
     managed_worktree?: {
-        state: 'open' | 'closed';
+        state: 'open' | 'closed' | 'abandoned';
         cleanup?: 'pending' | 'complete';
         path: string;
         branch: string;

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

@@ -19,6 +19,8 @@ export type LifecycleDTO = 'terminal' | 'resident';
 export type ModeDTO = 'base' | 'orchestrator';
 /** Why a node last stopped (mirrors the runtime `ExitIntent` union). */
 export type ExitIntentDTO = 'done' | 'refresh' | 'idle-release' | 'parked' | null;
+/** Why a terminal node ended (mirrors the runtime `TerminalReason` union). */
+export type TerminalReasonDTO = 'finalized' | 'finished' | 'parked' | 'closed' | 'retired' | 'crashed' | 'stranded';
 /** Inbox urgency tier for a delivered message (mirrors feed/inbox `InboxTier`). */
 export type InboxTierDTO = 'critical' | 'urgent' | 'normal' | 'deferred';
 /** Whether a node id is a safe single filesystem path segment. Re-declared here

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

@@ -21,20 +21,27 @@ export interface ReviveResultDTO {
     revived: boolean;
     resumed: boolean;
     status: NodeStatusDTO;
+    /** What the call did: `launched` started a broker, `already-live` found one
+     *  already running, `frozen` found no free broker slot and left the row
+     *  waiting for one. */
+    outcome: 'launched' | 'already-live' | 'frozen';
 }
 /** `POST /v1/nodes/{id}/relaunch-root` result. A null id means the target
  * was not a relaunchable live root, or its replacement failed to launch. */
 export interface RelaunchRootResultDTO {
     newNodeId: NodeIdDTO | null;
 }
-/** `POST /v1/nodes/revive-all` result. Node ids relaunched, plus any that
- *  failed to revive with the reason (the reader reports both). */
+/** `POST /v1/nodes/revive-all` result. Node ids relaunched, any that failed to
+ *  revive with the reason, and any the broker cap turned away (the reader
+ *  reports all three). */
 export interface ReviveAllResultDTO {
     revived: NodeIdDTO[];
     failed: {
         node_id: NodeIdDTO;
         error: string;
     }[];
+    /** Frozen for capacity, not failed: the daemon relaunches these as slots free. */
+    frozen: NodeIdDTO[];
 }
 /** `POST /v1/nodes/{id}/close` body. The cascade set is computed server-side
  *  from edges; the flag only opts out of cascading descendants. */

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

@@ -57,6 +57,11 @@ export interface MessageResultDTO {
     delivered: boolean;
     /** Whether a dormant target was revived to receive the message. */
     revived: boolean;
+    /** Present only when a wake was attempted and did not happen:
+     *  `capacity_frozen` means no broker slot was free, so the target's row is
+     *  frozen and the daemon relaunches it when one frees. The entry is durably
+     *  appended either way, and delivery follows that relaunch. */
+    not_revived_reason?: 'capacity_frozen';
     delivered_at?: IsoTime;
     /** Which channel a `delivery:'interactive'` send actually used: `'engine'`
      *  (live broker frame loop, no inbox entry) or `'inbox'` (durable fallback).

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

@@ -1,4 +1,4 @@
-import type { Cursor, ExitIntentDTO, IsoTime, LifecycleDTO, ModeDTO, NodeIdDTO, NodeStatusDTO } from './common.js';
+import type { Cursor, ExitIntentDTO, IsoTime, LifecycleDTO, ModeDTO, NodeIdDTO, NodeStatusDTO, TerminalReasonDTO } from './common.js';
 import type { ReportDTO } from './reports.js';
 /** `GET /v1/nodes/{id}/subject` — the node-config subject substrate gate
  *  predicates evaluate against. Mirrors `NodeConfigSubject`; this narrow
@@ -37,9 +37,10 @@ export interface CreateNodeRequest {
     description?: 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`. */
+    /** Lifecycle of the new node. Roots default to `resident`; managed children
+     *  default to `terminal`. Use `resident` for a child that remains wakeable
+     *  without owing a final, or `terminal` for a bounded worker that must
+     *  finalize. */
     root_lifecycle?: LifecycleDTO;
     /** Worktree branch name, or true for an auto-named managed worktree. */
     worktree?: string | boolean;
@@ -75,6 +76,8 @@ export interface NodeSummaryDTO {
     created: IsoTime;
     intent: ExitIntentDTO;
     waiting_for: NodeIdDTO | null;
+    frozen_at: IsoTime | null;
+    terminal_reason: TerminalReasonDTO | null;
     pi_pid: number | null;
     /** Launch-time process identity paired with `pi_pid`, or null when absent. */
     pi_pid_identity: string | null;
@@ -121,7 +124,7 @@ export interface NodePathsDTO {
 }
 /** A node's managed git worktree, if any. */
 export interface NodeWorktreeDTO {
-    state: 'open' | 'closed';
+    state: 'open' | 'closed' | 'abandoned';
     /** Pending cleanup must be run manually after the owner exits. */
     cleanup?: 'pending' | 'complete';
     path: string;
@@ -131,6 +134,12 @@ export interface NodeWorktreeDTO {
     base_sha: string;
     created: IsoTime;
     closed?: IsoTime;
+    abandoned?: {
+        branch: string;
+        tip_sha: string;
+        at: IsoTime;
+        by: string;
+    };
 }
 /** Immutable companion provenance and fork coordinates. Present only on a
  *  daemon-spawned companion node: a `review/companion` node for a human review

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

@@ -15,3 +15,13 @@ export interface CloseWorktreeResultDTO {
     branch_deleted: boolean;
     branch_delete_error?: string;
 }
+export interface AbandonWorktreeRequest {
+    by: string;
+}
+export interface AbandonWorktreeResultDTO {
+    node_id: NodeIdDTO;
+    branch: string;
+    tip_sha: string;
+    worktree_path: string;
+    branch_deleted: boolean;
+}

package/dist/api/routes.d.ts

@@ -39,6 +39,7 @@ export declare const routes: {
     readonly nodeWait: (id: string) => string;
     readonly nodeConfig: (id: string) => string;
     readonly nodeWorktreeClose: (id: string) => string;
+    readonly nodeWorktreeAbandon: (id: string) => string;
     readonly nodeAttach: (id: string) => string;
     readonly focuses: () => string;
     readonly focusByNode: () => string;

package/dist/api/routes.js

@@ -57,6 +57,7 @@ export const routes = {
     nodeWait: (id) => `${V}/nodes/${id}/wait`,
     nodeConfig: (id) => `${V}/nodes/${id}/config`,
     nodeWorktreeClose: (id) => `${V}/nodes/${id}/worktree/close`,
+    nodeWorktreeAbandon: (id) => `${V}/nodes/${id}/worktree/abandon`,
     nodeAttach: (id) => `${V}/nodes/${id}/attach`,
     // Focuses (viewer registry — the canvas.db `focuses` table)
     focuses: () => `${V}/focuses`,

package/package.json

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