@north-light/crouter-api 0.3.231 → 0.3.232

package/dist/api/client.d.ts

@@ -9,7 +9,7 @@ import type { FocusDTO, RegisterFocusRequest, SetFocusPaneRequest } from './dto/
 import { type ArmCronRequest, type CancelCronQuery, type CronDTO, type CronRunDTO, type CronScopeQuery, type CronShowDTO, type ListCronsQuery, type PokeCronsResult } from './dto/crons.js';
 import type { NodeConfigPatch } from './dto/config.js';
 import type { AttachEnsureRequest, AttachEnsureResultDTO } from './dto/attach.js';
-import type { DeleteProfileRequest, DeleteProfileResultDTO, EnsureProfileRequest, ProfileDTO } from './dto/profiles.js';
+import type { DeleteProfileRequest, DeleteProfileResultDTO, EnsureProfileRequest, ProfileDTO, UpdateProfileMetadataRequest } from './dto/profiles.js';
 import type { FilePeekDTO } from './dto/files.js';
 import type { MemoryDocRefDTO } from './dto/memory.js';
 import type { ChatInventoryDTO, ProspectiveChatInventoryDTO, ProspectiveChatInventoryQuery } from './dto/chat-inventory.js';
@@ -174,6 +174,8 @@ export declare class CrtrClient {
     ensureProfile(name: string, req?: EnsureProfileRequest): Promise<ProfileDTO>;
     listProfiles(): Promise<ProfileDTO[]>;
     getProfile(name: string): Promise<ProfileDTO>;
+    /** Merge and remove entries in a profile's metadata map. */
+    updateProfileMetadata(name: string, req: UpdateProfileMetadataRequest): Promise<ProfileDTO>;
     /** Force-delete or detach one profile by exact id or unique name. */
     deleteProfile(name: string, req: DeleteProfileRequest): Promise<DeleteProfileResultDTO>;
     listModelAuth(): Promise<ModelAuthListDTO>;

package/dist/api/client.js

@@ -309,6 +309,10 @@ export class CrtrClient {
     getProfile(name) {
         return this.request('GET', routes.profile(name));
     }
+    /** Merge and remove entries in a profile's metadata map. */
+    updateProfileMetadata(name, req) {
+        return this.request('PATCH', routes.profileMetadata(name), req);
+    }
     /** Force-delete or detach one profile by exact id or unique name. */
     deleteProfile(name, req) {
         return this.request('DELETE', routes.profile(name), req);

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

@@ -19,6 +19,8 @@ export interface AttentionItemDTO {
     cwd: string;
     /** Number of open tickets on this node. */
     count: number;
+    /** Open ticket titles for this node, newest first — one per counted ticket. */
+    subjects: string[];
 }
 /** `GET /v1/canvas/attention` result. */
 export interface AttentionDTO {
@@ -142,6 +144,10 @@ export interface HistoryReadResultDTO {
 export interface SnapshotNodeDTO {
     node_id: NodeIdDTO;
     name: string;
+    /** Caller-supplied node title, kept separate from the enriched full label. */
+    title: string;
+    /** Caller-supplied node brief, or null when absent. */
+    description: string | null;
     kind: string;
     mode: string;
     lifecycle?: string;
@@ -161,6 +167,10 @@ export interface SnapshotNodeDTO {
     last_activity?: IsoTime;
     ctx_tokens?: number;
     streaming: boolean;
+    /** Number of active background bash jobs, reported only for a live broker. */
+    jobs_active: number;
+    /** Controller node this node is durably waiting for, or null. */
+    waiting_for: string | null;
     /** The node's active fault projection (structurally a `Fault`), or null. Kept
      *  as a loose object to keep this DTO free of a `core` type import. */
     hanging: Record<string, unknown> | null;

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

@@ -18,7 +18,7 @@ export type LifecycleDTO = 'terminal' | 'resident';
 /** Execution mode of a node (mirrors the runtime `Mode` union). */
 export type ModeDTO = 'base' | 'orchestrator';
 /** Why a node last stopped (mirrors the runtime `ExitIntent` union). */
-export type ExitIntentDTO = 'done' | 'refresh' | 'idle-release' | null;
+export type ExitIntentDTO = 'done' | 'refresh' | 'idle-release' | 'parked' | null;
 /** 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/health.d.ts

@@ -8,7 +8,8 @@ export interface HealthDTO {
     brokers_reconciled: boolean;
 }
 /** `GET /v1/status` — daemon status snapshot. Backs `crtr sys daemon status`
- *  state and the `crtr canvas dashboard` header. Versions are informational. */
+ *  state and the `crtr canvas dashboard` header. `runtime_version` is also
+ *  checked by Core's minimum-runtime capability gate. */
 export interface StatusDTO {
     daemon_pid: number;
     tick_interval_ms: number;

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

@@ -4,10 +4,9 @@ export interface ReviveRequest {
     /** Resume the saved conversation (true) vs a fresh launch (false). */
     resume?: boolean;
     /** 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
-     *  (`not_finalized`). */
+     *  revive doorway accepts it only for a finalized node (`not_finalized`
+     *  otherwise); without it, a finalized node is rejected (`node_finalized`).
+     *  Message delivery has its own wider reopen behavior. */
     reopen?: boolean;
     /** Wake provenance: the cron whose run drove this revive (`CRTR_CRON_ID`,
      *  set by the daemon in every cron run's environment and forwarded by the

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

@@ -19,8 +19,9 @@ export interface SendMessageRequest {
     from?: NodeIdDTO | null;
     /** Revive with no inbox entry (`--fresh` → `reviveNode({ resume: false })`). */
     fresh?: boolean;
-    /** Clear a latched target's finalization latch before an immediate delivery
-     *  or `--fresh` revive (`--reopen`). Immediate only. */
+    /** Before delivery, make the target resident and clear its finalization latch
+     *  when present (`--reopen`). Accepted for both durable and interactive
+     *  delivery; `--fresh` retains its separate finalized-only gate. */
     reopen?: boolean;
     /** Hidden ambient context upserted onto the target's sidecar as a
      *  `situational` card, never visible chat (`--situational-context`).
@@ -42,8 +43,8 @@ export interface SendMessageRequest {
      *  on its one serialized frame loop — the same ordering a tmux viewer gets)
      *  instead of the durable inbox; a dormant or mid-revive target falls back to
      *  the durable inbox + revive (watcher delivers post-boot). Plain immediate
-     *  body only — rejected with fresh/reopen/situational_context/
-     *  output_schema or tier 'deferred'. Runtime cards ARE accepted: a
+     *  body only — rejected with fresh/situational_context/output_schema or tier
+     *  'deferred'. Runtime cards and reopen ARE accepted: a
      *  card-bearing send is an ordinary human send that happens to carry context,
      *  and the live deliver frame places the cards ahead of the body in one turn.
      *  Absent → durable inbox (unchanged). */

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

@@ -33,6 +33,8 @@ export interface CreateNodeRequest {
     pin_cwd?: string;
     /** Display name (tmux window + resume picker). Defaults to the kind. */
     name?: string;
+    /** Caller-supplied short description, preserved against automatic naming. */
+    description?: string;
     parent?: NodeIdDTO | null;
     root?: boolean;
     /** Lifecycle of an independent root. Defaults to `resident`; use `terminal`

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

@@ -23,6 +23,11 @@ export interface EnsureProfileRequest {
      *  launched under the profile as `CRTR_PROFILE_META_<KEY>` env. */
     metadata?: Record<string, string>;
 }
+/** `PATCH /v1/profiles/{name}/metadata` body. Merges `set` and removes `unset`. */
+export interface UpdateProfileMetadataRequest {
+    set?: Record<string, string>;
+    unset?: string[];
+}
 /** `DELETE /v1/profiles/{name}` body. Destructive deletion is never implicit. */
 export interface DeleteProfileRequest {
     force: boolean;

package/dist/api/routes.d.ts

@@ -93,6 +93,7 @@ export declare const routes: {
     readonly humanRequestCancel: (requestId: string) => string;
     readonly profiles: () => string;
     readonly profile: (name: string) => string;
+    readonly profileMetadata: (name: string) => string;
     readonly modelAuths: () => string;
     readonly modelAuth: (provider: string) => string;
     readonly filePeek: () => string;

package/dist/api/routes.js

@@ -124,6 +124,7 @@ export const routes = {
     // Profiles (deletion is daemon-owned because it crosses canvas state)
     profiles: () => `${V}/profiles`,
     profile: (name) => `${V}/profiles/${name}`,
+    profileMetadata: (name) => `${V}/profiles/${name}/metadata`,
     // Model auth
     modelAuths: () => `${V}/model-auth`,
     modelAuth: (provider) => `${V}/model-auth/${provider}`,

package/dist/shared/generated-context.d.ts

@@ -8,6 +8,13 @@ export declare const CONTEXT_NUDGE_CUSTOM_TYPE = "crtr-context-nudge";
 export declare const REVIEW_BOUNDARY_CUSTOM_TYPE = "crtr-review-boundary";
 /** Generic completion mandate issued by the terminal-node stop guard. */
 export declare const STALL_REPROMPT: string;
+/** The daemon's parking mandate: the last turn of a conversation the unattended
+ *  clock is concluding. Delivered live, wrapped in a `park` runtime card. It
+ *  shares a CONTRACT with `node yield`'s pre-invocation guide (roadmap current,
+ *  short and shrinking; context dir for in-progress material; memory only for
+ *  gated permanent lessons) but not a string: yield is read by an agent choosing
+ *  to refresh, this by an agent being told to conclude. */
+export declare const PARK_SUMMARY_PROMPT: string;
 /** Static recovery prompts shared by the broker producer and display classifier. */
 export declare const AUTH_FAULT_RECOVERY_BODY = "Provider credentials were just updated (a new login landed). Your previous turn stopped on a provider authentication failure. Continue from where you left off and retry the work that failed.";
 export declare const CONNECTION_FAULT_RECOVERY_BODY = "The network connection is back online. Your previous turn stopped on a connection error (the network was down). Continue from where you left off and retry the work that failed.";

package/dist/shared/generated-context.js

@@ -13,6 +13,17 @@ export const REVIEW_BOUNDARY_CUSTOM_TYPE = 'crtr-review-boundary';
 /** Generic completion mandate issued by the terminal-node stop guard. */
 export const STALL_REPROMPT = "You've stopped but you're not waiting on anyone and haven't finished. " +
     "Pipe the result to `crtr push final` through a single-quoted heredoc if the work is done, or use `crtr human send` if you are blocked or need the user.";
+/** The daemon's parking mandate: the last turn of a conversation the unattended
+ *  clock is concluding. Delivered live, wrapped in a `park` runtime card. It
+ *  shares a CONTRACT with `node yield`'s pre-invocation guide (roadmap current,
+ *  short and shrinking; context dir for in-progress material; memory only for
+ *  gated permanent lessons) but not a string: yield is read by an agent choosing
+ *  to refresh, this by an agent being told to conclude. */
+export const PARK_SUMMARY_PROMPT = 'This conversation has been idle with nothing waiting on it, so it is being concluded. This is your last turn — do these four things now, then stop.\n\n'
+    + '1. Bring your roadmap current. It lives at `$CRTR_CONTEXT_DIR/roadmap.md`, and it is the document a fresh cycle reads to know where things stand: what was done, what is still open, and what someone picking this up needs. Write one now if you never had one. Keep it short and shrinking — strategy and present state only, deleting completed items rather than marking them done.\n\n'
+    + '2. Save anything else worth keeping. In-progress task material — what has happened, identifiers, in-flight state — goes to one or more files in your context directory. A permanent lesson worth remembering indefinitely goes to node memory (`crtr memory write -h`), gated deliberately: transcript state does not belong in memory.\n\n'
+    + '3. Push one regular report to your subscribers summarizing where things stand: `crtr push update`. NOT `crtr push final` — this concludes the conversation, it does not finish a mandate.\n\n'
+    + '4. Stop. A later message reopens you on a fresh context window grounded in your goal and that roadmap, so what you leave behind now is what you get back.';
 /** Static recovery prompts shared by the broker producer and display classifier. */
 export const AUTH_FAULT_RECOVERY_BODY = 'Provider credentials were just updated (a new login landed). Your previous turn stopped on a provider authentication failure. Continue from where you left off and retry the work that failed.';
 export const CONNECTION_FAULT_RECOVERY_BODY = 'The network connection is back online. Your previous turn stopped on a connection error (the network was down). Continue from where you left off and retry the work that failed.';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/crouter-api",
-  "version": "0.3.231",
+  "version": "0.3.232",
   "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",