@north-light/crouter-api 0.3.198 → 0.3.200

package/dist/api/client.d.ts

@@ -9,14 +9,14 @@ 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 { EnsureProfileRequest, ProfileDTO } from './dto/profiles.js';
+import type { DeleteProfileRequest, DeleteProfileResultDTO, EnsureProfileRequest, ProfileDTO } from './dto/profiles.js';
 import type { FilePeekDTO } from './dto/files.js';
 import type { MemoryDocRefDTO } from './dto/memory.js';
 import type { CredentialRemovalResultDTO, CredentialResultDTO, InstallCredentialRequest, ModelAuthListDTO } from './dto/modelauth.js';
 import type { CreateHumanBridgeRequest, HumanBridgeResultDTO, HumanCancelRequest, HumanCancelResultDTO, HumanResolveRequest, HumanResolveResultDTO } from './dto/human.js';
 import type { CancelReviewRequest, CreateReviewRequest, ListReviewsQuery, ReviewCancelResultDTO, ReviewDocumentBaseDTO, ReviewDTO, ReviewListDTO, ReviewSubmitResultDTO } from './dto/reviews.js';
 import type { CreateReviewCommentRequest, EditReviewCommentRequest, ListReviewCommentsQuery, ReadReviewCommentEventsQuery, ReviewCommentActionRequest, ReviewCommentDetailDTO, ReviewCommentEventsDTO, ReviewCommentListDTO, ReviewCommentMutationDTO, ReviewCommentRangeBatchRequest, ReviewCommentRangeBatchResultDTO } from './dto/review-comments.js';
-import type { CancelInboxTicketRequest, CanceledTicketResultDTO, InboxListDTO, InboxPageDTO, InboxPageHistoryDTO, InboxPageRenderDTO, PagesBundleAssetDTO, InboxPageResponseDTO, InboxTicketIdDTO, PageResponsesDTO, PageTicketResultDTO, RespondInboxPageRequest } from './dto/inbox.js';
+import type { CancelInboxTicketRequest, CanceledTicketResultDTO, InboxListDTO, InboxPageDTO, InboxPageHistoryDTO, InboxPageResponseDTO, InboxTicketIdDTO, PageFeedbackResolutionDTO, PageResponsesDTO, PageTicketResultDTO, RespondInboxPageRequest } from './dto/inbox.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 { BrokerExtensionStateDTO, BrokerGeneratedNameRequest, BrokerGeneratedNameResultDTO, BrokerInboxCursorDirective, BrokerInboxCursorRequest, BrokerModelCommitRequest, BrokerModelCommitResultDTO, BrokerPersonaAckRequest, BrokerSessionBoundRequest, BrokerSessionBoundResultDTO, BrokerSettleDirective, BrokerSettleRequest } from './dto/broker-ops.js';
@@ -158,9 +158,8 @@ export declare class CrtrClient {
     ensureProfile(name: string, req?: EnsureProfileRequest): Promise<ProfileDTO>;
     listProfiles(): Promise<ProfileDTO[]>;
     getProfile(name: string): Promise<ProfileDTO>;
-    /** Delete one profile by exact id or unique name (`DELETE /v1/profiles/:name`,
-     *  idempotent — a miss is success). */
-    deleteProfile(name: string): Promise<void>;
+    /** Force-delete or detach one profile by exact id or unique name. */
+    deleteProfile(name: string, req: DeleteProfileRequest): Promise<DeleteProfileResultDTO>;
     listModelAuth(): Promise<ModelAuthListDTO>;
     installCredential(provider: string, req: InstallCredentialRequest): Promise<CredentialResultDTO>;
     removeCredential(provider: string): Promise<CredentialRemovalResultDTO>;
@@ -169,12 +168,11 @@ export declare class CrtrClient {
      *  broker) precisely because a human bridge must never have one. */
     createHumanBridge(req: CreateHumanBridgeRequest): Promise<HumanBridgeResultDTO>;
     /** Resolve a page ticket answer. crtrd claims the ticket (taking over a live
-     *  inbox claim where one exists), publishes the canonical result, delivers
-     *  to the asking node, and retires the bridge before this resolves. */
-    resolveHumanTicket(nodeId: string, body: HumanResolveRequest): Promise<HumanResolveResultDTO>;
-    /** Cancel a pending ticket: a terminal canceled result, the bridge retired,
-     *  every subscriber but the caller notified. */
-    cancelHumanTicket(nodeId: string, body: HumanCancelRequest): Promise<HumanCancelResultDTO>;
+     * inbox claim where one exists), publishes the canonical result, and follows
+     * its optional reply route before this resolves. */
+    resolveHumanTicket(ticketId: string, body: HumanResolveRequest): Promise<HumanResolveResultDTO>;
+    /** Cancel a pending ticket and retire its optional reply bridge. */
+    cancelHumanTicket(ticketId: string, body: HumanCancelRequest): Promise<HumanCancelResultDTO>;
     createReview(req: CreateReviewRequest): Promise<ReviewDTO>;
     listReviews(query?: ListReviewsQuery): Promise<ReviewListDTO>;
     getReview(reviewId: string): Promise<ReviewDTO>;
@@ -205,15 +203,13 @@ export declare class CrtrClient {
     postInboxProgress(ticketId: InboxTicketIdDTO, responses: PageResponsesDTO): Promise<void>;
     /** Get the published response for a resolved page ticket. 404 if pending or canceled. */
     getInboxResponse(ticketId: InboxTicketIdDTO): Promise<InboxPageResponseDTO>;
-    /** The page's body-level HTML payload, for pending, resolved, and canceled
-     *  tickets alike. The host wraps it and injects the page runtime bundle. */
-    renderHumanInboxPage(ticketId: InboxTicketIdDTO): Promise<InboxPageRenderDTO>;
-    /** One built page runtime asset. Pass the previously returned `etag` as
-     *  `ifNoneMatch` to get a 304 (and no bytes) while the cached copy is
-     *  current. The one non-JSON route on this surface. */
-    getPagesBundleAsset(asset: 'js' | 'css', ifNoneMatch?: string): Promise<PagesBundleAssetDTO>;
     /** Cancel a ticket (terminal response, never deletion). */
     cancelHumanInboxTicket(ticketId: InboxTicketIdDTO, request?: CancelInboxTicketRequest): Promise<CanceledTicketResultDTO>;
+    /** Resolve one page feedback comment — the bound companion's report that it
+     *  has been dealt with. `nodeId` names the caller; the daemon refuses any
+     *  node but the ticket's companion. Terminal for the comment; appends no
+     *  chat turn. */
+    resolvePageFeedbackComment(ticketId: InboxTicketIdDTO, commentId: string, nodeId: string): Promise<PageFeedbackResolutionDTO>;
     /** Composed client-side from `GET /v1/nodes` + `GET /v1/status` (spec §6.3 —
      *  the dashboard is absorbed into those two reads; there is no single route).
      *  `generated_at` is the client-side capture instant of the composition. */
@@ -250,6 +246,10 @@ export declare class CrtrClient {
      *  wrapper goes through here; only the non-JSON routes call it directly. */
     private send;
     private nodePath;
+    /** Validate a human interaction id before route construction. Reply-bearing
+     * tickets use bridge ids and standalone pages use page ids; both obey the
+     * safe node-id segment contract. */
+    private interactionPath;
     /** Validate a background job id before route construction. Job ids arrive
      *  from the daemon's file-backed roster and must remain one path segment. */
     private jobPath;

package/dist/api/client.js

@@ -287,10 +287,9 @@ export class CrtrClient {
     getProfile(name) {
         return this.request('GET', routes.profile(name));
     }
-    /** Delete one profile by exact id or unique name (`DELETE /v1/profiles/:name`,
-     *  idempotent — a miss is success). */
-    async deleteProfile(name) {
-        await this.request('DELETE', routes.profile(name));
+    /** Force-delete or detach one profile by exact id or unique name. */
+    deleteProfile(name, req) {
+        return this.request('DELETE', routes.profile(name), req);
     }
     // ---- Model auth --------------------------------------------------------
     listModelAuth() {
@@ -310,15 +309,14 @@ export class CrtrClient {
         return this.request('POST', routes.humanBridge(), req);
     }
     /** Resolve a page ticket answer. crtrd claims the ticket (taking over a live
-     *  inbox claim where one exists), publishes the canonical result, delivers
-     *  to the asking node, and retires the bridge before this resolves. */
-    resolveHumanTicket(nodeId, body) {
-        return this.request('POST', routes.humanTicketResolve(this.nodePath(nodeId)), body);
+     * inbox claim where one exists), publishes the canonical result, and follows
+     * its optional reply route before this resolves. */
+    resolveHumanTicket(ticketId, body) {
+        return this.request('POST', routes.humanTicketResolve(this.interactionPath(ticketId)), body);
     }
-    /** Cancel a pending ticket: a terminal canceled result, the bridge retired,
-     *  every subscriber but the caller notified. */
-    cancelHumanTicket(nodeId, body) {
-        return this.request('POST', routes.humanTicketCancel(this.nodePath(nodeId)), body);
+    /** Cancel a pending ticket and retire its optional reply bridge. */
+    cancelHumanTicket(ticketId, body) {
+        return this.request('POST', routes.humanTicketCancel(this.interactionPath(ticketId)), body);
     }
     // ---- Daemon-owned document reviews and comments -----------------------
     createReview(req) {
@@ -401,35 +399,20 @@ export class CrtrClient {
     getInboxResponse(ticketId) {
         return this.request('GET', routes.humanInboxResponse(this.ticketId(ticketId)));
     }
-    /** The page's body-level HTML payload, for pending, resolved, and canceled
-     *  tickets alike. The host wraps it and injects the page runtime bundle. */
-    renderHumanInboxPage(ticketId) {
-        return this.request('GET', routes.humanInboxRender(this.ticketId(ticketId)));
-    }
-    /** One built page runtime asset. Pass the previously returned `etag` as
-     *  `ifNoneMatch` to get a 304 (and no bytes) while the cached copy is
-     *  current. The one non-JSON route on this surface. */
-    async getPagesBundleAsset(asset, ifNoneMatch) {
-        if (asset !== 'js' && asset !== 'css') {
-            throw new TypeError(`invalid page bundle asset: ${JSON.stringify(asset)}`);
-        }
-        const res = await this.send('GET', routes.humanPagesBundle(asset), undefined, ifNoneMatch === undefined ? undefined : { 'if-none-match': ifNoneMatch });
-        if (res.status === 304) {
-            return { status: 304, etag: res.headers['etag'] ?? '', content_type: res.headers['content-type'] ?? '', content: null };
-        }
-        if (res.status < 200 || res.status >= 300)
-            parse(res); // throws the mapped ApiError
-        return {
-            status: 200,
-            etag: res.headers['etag'] ?? '',
-            content_type: res.headers['content-type'] ?? '',
-            content: res.text,
-        };
-    }
     /** Cancel a ticket (terminal response, never deletion). */
     cancelHumanInboxTicket(ticketId, request) {
         return this.request('POST', routes.humanInboxCancel(this.ticketId(ticketId)), request ?? {});
     }
+    /** Resolve one page feedback comment — the bound companion's report that it
+     *  has been dealt with. `nodeId` names the caller; the daemon refuses any
+     *  node but the ticket's companion. Terminal for the comment; appends no
+     *  chat turn. */
+    resolvePageFeedbackComment(ticketId, commentId, nodeId) {
+        if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/.test(commentId)) {
+            throw new TypeError(`invalid feedback comment id: ${JSON.stringify(commentId)}`);
+        }
+        return this.request('POST', routes.humanInboxFeedbackResolve(this.ticketId(ticketId), commentId), { node_id: nodeId });
+    }
     // ---- Canvas reads / maintenance ---------------------------------------
     /** Composed client-side from `GET /v1/nodes` + `GET /v1/status` (spec §6.3 —
      *  the dashboard is absorbed into those two reads; there is no single route).
@@ -512,6 +495,15 @@ export class CrtrClient {
         }
         return id;
     }
+    /** Validate a human interaction id before route construction. Reply-bearing
+     * tickets use bridge ids and standalone pages use page ids; both obey the
+     * safe node-id segment contract. */
+    interactionPath(id) {
+        if (!isSafeNodeId(id)) {
+            throw new ApiError(400, 'invalid_ticket_id', `invalid interaction ticket id: ${JSON.stringify(id)}`);
+        }
+        return id;
+    }
     /** Validate a background job id before route construction. Job ids arrive
      *  from the daemon's file-backed roster and must remain one path segment. */
     jobPath(id) {

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

@@ -23,7 +23,7 @@ export interface BrokerSettleRequest {
     stopReason: string;
     backgroundJobsRunning: boolean;
     pushedFinal: boolean;
-    askedHuman: boolean;
+    requestedHumanReply: boolean;
 }
 /** The only consequence a settle caller may enact. crtrd has already committed
  * every canvas and placement effect before returning this directive. */
@@ -75,12 +75,14 @@ export interface BrokerExtensionNodeDTO {
     profile_id: string | null;
     managed_worktree?: {
         state: 'open' | 'closed';
+        cleanup?: 'pending' | 'complete';
         path: string;
         branch: string;
         base_ref: string;
         base_sha: string;
     } | null;
     review_binding?: {
+        kind?: 'review' | 'page_feedback';
         review_id: string;
         origin_node_id: string;
         branch_file: string;

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

@@ -12,14 +12,25 @@ export interface BrokerErrorFrame {
 }
 /**
  * The `welcome` frame's history/state snapshot, narrowed to what a relay consumer
- * replays: the message history and the streaming flag. `M` is the message shape
- * (pi's `AgentMessage` in a pi consumer; `unknown` by default).
+ * replays: the message history, the streaming flag, and the unrun queue. `M` is
+ * the message shape (pi's `AgentMessage` in a pi consumer; `unknown` by default).
+ *
+ * `queued` carries the same two arrays a live `queue_update` frame carries — the
+ * steer/follow-up texts accepted by the engine but not started yet. A relay that
+ * renders queued rows needs it to survive (re)attach: a message enqueued mid-turn
+ * is in NEITHER `messages` (it never ran) nor any later frame the consumer has
+ * already seen. Optional: a broker on an older runtime generation omits it, which
+ * a consumer reads as an empty queue.
  */
 export interface BrokerWelcomeSnapshot<M = unknown> {
     messages: M[];
     state?: {
         isStreaming?: boolean;
     };
+    queued?: {
+        steering?: string[];
+        followUp?: string[];
+    };
 }
 /**
  * The crtrd broker `welcome` control frame — the history/resume catch-up snapshot

package/dist/api/dto/broker.js

@@ -13,8 +13,8 @@
 // `unknown` defaults.
 //
 // NARROWING NOTE: `BrokerWelcomeSnapshot` is deliberately the fields a live/history
-// relay mapper reads — `messages` plus `state.isStreaming` — not the broker's full
-// authoritative `BrokerSnapshot` (stats + the complete `get_state` mirror). The
-// broker sends the richer object on the wire; consumers that only replay history
-// read this narrowing of it.
+// relay mapper reads — `messages`, `state.isStreaming`, and the unrun `queued`
+// texts — not the broker's full authoritative `BrokerSnapshot` (stats + the
+// complete `get_state` mirror). The broker sends the richer object on the wire;
+// consumers that only replay history read this narrowing of it.
 export {};

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

@@ -36,21 +36,22 @@ export interface FeedbackResultDTO {
     commentsTotal: number;
     commentsUnresolved: number;
 }
-/** `POST /v1/human/tickets/{node_id}/resolve` body — a page answer keyed by slot id. */
+/** `POST /v1/human/tickets/{ticket_id}/resolve` body — a page answer keyed by slot id. */
 export interface HumanResolveRequest {
     responses: Record<string, Record<string, unknown>>;
 }
-/** `POST /v1/human/tickets/{node_id}/cancel` body. */
+/** `POST /v1/human/tickets/{ticket_id}/cancel` body. */
 export interface HumanCancelRequest {
     reason?: string;
     actor?: string;
 }
-/** `POST /v1/human/tickets/{node_id}/resolve` result. */
+/** `POST /v1/human/tickets/{ticket_id}/resolve` result. */
 export interface HumanResolveResultDTO {
-    delivered: true;
+    completed: true;
+    reply_delivered: boolean;
     kind: 'page';
 }
-/** `POST /v1/human/tickets/{node_id}/cancel` result. */
+/** `POST /v1/human/tickets/{ticket_id}/cancel` result. */
 export interface HumanCancelResultDTO {
     canceled: true;
 }

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

@@ -5,6 +5,7 @@ export interface TicketSourceDTO {
     sessionName?: string;
     askedBy?: string;
     blockedSince?: IsoTime;
+    emittedAt?: IsoTime;
     profileName?: string;
     nodeId?: string;
 }
@@ -22,13 +23,14 @@ export interface PageTicketSummaryDTO {
     title: string;
     subtitle?: string;
     placement: 'inline' | 'panel';
-    dialect: 'md' | 'html';
+    dialect: 'jsx' | 'html';
+    inbox: boolean;
     steps: number;
-    blocked_since: IsoTime;
+    emitted_at: IsoTime;
     source: TicketSourceDTO;
     slot_kinds: string[];
     awaits_response: boolean;
-    state?: 'pending' | 'resolved' | 'canceled';
+    state?: 'pending' | 'resolved' | 'canceled' | 'passive';
     /** Present only on resolved history entries; the stored one-line answer digest. */
     answer_digest?: string;
 }
@@ -46,25 +48,27 @@ export interface PageSlotDTO {
 }
 /** The nested protocol object is deliberately camelCase on the wire. */
 export interface PageManifestDTO {
-    schema: 'crtr.page/v1';
-    dialect: 'md' | 'html';
+    schema: 'crtr.page/v2';
+    dialect: 'jsx' | 'html';
     title: string;
     subtitle?: string;
-    placement: 'inline' | 'panel';
-    document: 'page.md' | 'page.html';
+    delivery: {
+        placement: 'inline' | 'panel';
+        inbox: boolean;
+        reply: boolean;
+    };
+    document: 'page.tsx' | 'page.html';
     steps: number;
     slots: PageSlotDTO[];
     source?: TicketSourceDTO;
 }
+/** Answer-annotation anchors: option on UserQuestion, row on UserTable.
+ * Feedback on other page content — including the question text — is a
+ * ticket-level feedback comment, never a response anchor. */
 export interface PageCommentAnchorDTO {
-    kind: 'whole' | 'option' | 'row' | 'column' | 'card' | 'range';
+    kind: 'option' | 'row';
     optionId?: string;
     rowId?: string;
-    columnId?: string;
-    cardId?: string;
-    start?: number;
-    end?: number;
-    quote?: string;
 }
 export interface PageCommentDTO {
     id: string;
@@ -79,7 +83,6 @@ export interface PageOptionsResponseDTO {
 export interface PageTextResponseDTO {
     text: string;
     edited: boolean;
-    comments: PageCommentDTO[];
 }
 export interface PageTableResponseDTO {
     selectedRowIds: string[];
@@ -88,40 +91,81 @@ export interface PageTableResponseDTO {
 }
 export interface PageCardsResponseDTO {
     selectedCardIds: string[];
-    comments: PageCommentDTO[];
 }
 export type SlotResponseDTO = PageOptionsResponseDTO | PageTextResponseDTO | PageTableResponseDTO | PageCardsResponseDTO | Record<string, unknown>;
 export type PageResponsesDTO = Record<string, SlotResponseDTO>;
 export interface InboxPageDTO {
     ticket_id: InboxTicketIdDTO;
     kind: 'page';
-    state: 'pending' | 'resolved' | 'canceled';
+    state: 'pending' | 'resolved' | 'canceled' | 'passive';
     page: PageManifestDTO;
+    /** JSX is compiled for the host; HTML is the authored document verbatim. */
     document: string;
-    document_media_type: 'text/markdown' | 'text/html';
+    document_media_type: 'text/jsx' | 'text/html';
     progress: {
         responses: PageResponsesDTO;
     } | null;
+    /** Ticket-attached feedback comments and the companion conversation they
+     * deliver to. Comments are immutable once sent — open until the companion
+     * resolves them. */
+    feedback: PageFeedbackDTO;
+}
+export interface PageFeedbackCommentDTO {
+    id: string;
+    /** The highlighted text the note is about; for a chart, its title. */
+    quote: string;
+    /** Surrounding text that locates the quote on the page. */
+    context?: string;
+    note: string;
+    /** Open until the companion has dealt with it; resolution is terminal. */
+    status: 'open' | 'resolved';
+    created_at: IsoTime;
+    resolved_at?: IsoTime;
+}
+export interface PageFeedbackDTO {
+    /** The ticket-bound companion conversation comments deliver to; null until
+     * the first comment realizes it. */
+    companion_node_id: string | null;
+    /** How many comments remain open. Zero once feedback exists is the ticket's
+     * authoritative signal that the companion has dealt with all of it. */
+    open_count: number;
+    comments: PageFeedbackCommentDTO[];
+}
+/** `POST /v1/human/inbox/:ticket_id/feedback-comments` body. */
+export interface CreatePageFeedbackCommentRequest {
+    quote: string;
+    context?: string;
+    note: string;
+}
+export interface PageFeedbackDeliveryDTO {
+    target_node_id: string;
+    status: 'delivered' | 'failed';
+    via?: 'engine' | 'inbox';
+    woke: boolean;
+    error?: string;
+}
+/** Create result: the new comment, the ticket's full feedback state after it,
+ * and the delivery outcome in the companion conversation. */
+export interface PageFeedbackMutationDTO {
+    comment: PageFeedbackCommentDTO;
+    feedback: PageFeedbackDTO;
+    delivery: PageFeedbackDeliveryDTO;
+}
+/** `POST .../feedback-comments/:comment_id/resolve` request. Resolution is
+ * companion-only: `node_id` names the calling node and must equal the
+ * ticket's bound companion. */
+export interface ResolvePageFeedbackCommentRequest {
+    node_id: string;
+}
+/** `POST .../feedback-comments/:comment_id/resolve` result. Resolution appends
+ * no chat turn; the companion's own conversational report covers it. */
+export interface PageFeedbackResolutionDTO {
+    comment: PageFeedbackCommentDTO;
+    feedback: PageFeedbackDTO;
 }
 export interface InboxPageHistoryDTO {
     tickets: PageTicketSummaryDTO[];
 }
-/** `GET /v1/human/inbox/:ticket_id/render` — the page's body-level HTML
- *  payload. It carries the page's own prose and `crtr-*` slot elements only;
- *  the host supplies the surrounding document and injects the page runtime
- *  bundle it chooses to serve. */
-export interface InboxPageRenderDTO {
-    html: string;
-}
-/** A client-side projection of `GET /v1/human/pages/bundle.{js,css}` — the one
- *  non-JSON route on this surface. `content` is null on a 304, where the
- *  caller's cached copy is still current. */
-export interface PagesBundleAssetDTO {
-    status: 200 | 304;
-    etag: string;
-    content_type: string;
-    content: string | null;
-}
 export interface RespondInboxPageRequest {
     responses: PageResponsesDTO;
 }
@@ -145,7 +189,10 @@ export interface PageAnswerGroupDTO {
     }[];
 }
 export interface PageAnswerCommentDTO {
-    anchor: PageCommentAnchorDTO;
+    /** Legacy stored responses may still carry the retired `whole` anchor. */
+    anchor: PageCommentAnchorDTO | {
+        kind: 'whole';
+    };
     anchorLabel: string;
     text: string;
 }

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

@@ -90,6 +90,8 @@ export interface NodePathsDTO {
 /** A node's managed git worktree, if any. */
 export interface NodeWorktreeDTO {
     state: 'open' | 'closed';
+    /** Pending cleanup must be run manually after the owner exits. */
+    cleanup?: 'pending' | 'complete';
     path: string;
     branch: string;
     repo_root: string;
@@ -98,9 +100,13 @@ export interface NodeWorktreeDTO {
     created: IsoTime;
     closed?: IsoTime;
 }
-/** Immutable review-companion provenance and fork coordinates. Present only on
- *  a `review/companion` node spawned by the daemon for a human review. */
+/** Immutable companion provenance and fork coordinates. Present only on a
+ *  daemon-spawned companion node: a `review/companion` node for a human review
+ *  (`kind` absent or `review`), or — for a page ticket's feedback conversation
+ *  (`kind: 'page_feedback'`, review_id = ticket id, target_file = the page
+ *  source) — a fork of the sending node itself, spawned with its kind. */
 export interface NodeReviewBindingDTO {
+    kind?: 'review' | 'page_feedback';
     review_id: string;
     origin_node_id: string;
     branch_file: string;

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

@@ -3,6 +3,29 @@ export interface EnsureProfileRequest {
     /** Absolute project directories in the profile's purview. */
     projects?: string[];
 }
+/** `DELETE /v1/profiles/{name}` body. Destructive deletion is never implicit. */
+export interface DeleteProfileRequest {
+    force: boolean;
+    /** Preserve nodes and human history while removing their profile identity. */
+    detach?: boolean;
+    /** The invoking broker, when the request came from a node-owned CLI process. */
+    caller_node_id?: string | null;
+}
+export type DeleteProfileMode = 'deleted' | 'detached';
+/** The completed deletion, or the accepted plan when the invoking node is part of it. */
+export interface DeleteProfileResultDTO {
+    profile_id: string;
+    name: string;
+    mode: DeleteProfileMode;
+    nodes: number;
+    crons: number;
+    tickets: number;
+    reviews: number;
+    default_pins: number;
+    /** True only when crtrd acknowledged the response before tearing down its caller. */
+    accepted?: true;
+    grace_ms?: number;
+}
 /** A profile projection. */
 export interface ProfileDTO {
     /** Stable profile-directory id (`<slug>-<id>`). */

package/dist/api/dto/profiles.js

@@ -1,3 +1,3 @@
-// Profile DTOs (spec §6.6). Server-side for remote/Core (P2) consumers; local
-// `crtr profile *` verbs stay fs-local.
+// Profile DTOs (spec §6.6). Profile deletion crosses profile, canvas, cron,
+// inbox, and review state, so every consumer routes it through crtrd.
 export {};

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

@@ -7,13 +7,11 @@ export interface CloseWorktreeResultDTO {
     worktree_path: string;
     /** The commit SHA the recorded local base branch was fast-forwarded onto. */
     landed_sha: string;
-    /** False when the landing happened but the checkout could not be removed
-     *  automatically — the close still counts as done (state is closed);
-     *  `worktree_remove_error` carries the manual-cleanup note. */
+    /** False while the caller's checkout remains registered for deferred cleanup.
+     *  `worktree_remove_error` names that state and the safe follow-up. */
     worktree_removed: boolean;
     worktree_remove_error?: string;
-    /** False when the landing happened but the local branch could not be deleted
-     *  automatically — same non-fatal treatment as `worktree_removed`. */
+    /** False while the local branch remains checked out by the deferred cleanup. */
     branch_deleted: boolean;
     branch_delete_error?: string;
 }

package/dist/api/routes.d.ts

@@ -59,8 +59,8 @@ export declare const routes: {
     readonly canvasPrune: () => string;
     readonly canvasRebuildIndex: () => string;
     readonly humanBridge: () => string;
-    readonly humanTicketResolve: (nodeId: string) => string;
-    readonly humanTicketCancel: (nodeId: string) => string;
+    readonly humanTicketResolve: (ticketId: string) => string;
+    readonly humanTicketCancel: (ticketId: string) => string;
     readonly humanReviews: () => string;
     readonly humanReview: (reviewId: string) => string;
     readonly humanReviewByBridge: (bridgeNodeId: string) => string;
@@ -81,9 +81,7 @@ export declare const routes: {
     readonly humanInboxProgress: (ticketId: string) => string;
     readonly humanInboxResponse: (ticketId: string) => string;
     readonly humanInboxCancel: (ticketId: string) => string;
-    readonly humanInboxRender: (ticketId: string) => string;
-    /** The built page runtime assets, served for whatever host renders a page. */
-    readonly humanPagesBundle: (asset: "js" | "css") => string;
+    readonly humanInboxFeedbackResolve: (ticketId: string, commentId: string) => string;
     readonly profiles: () => string;
     readonly profile: (name: string) => string;
     readonly modelAuths: () => string;

package/dist/api/routes.js

@@ -83,8 +83,8 @@ export const routes = {
     // Human bridge creation + the pinned ticket route table (design §"The `/v1`
     // surface") — every ticket route is addressed by node id only.
     humanBridge: () => `${V}/human/bridge`,
-    humanTicketResolve: (nodeId) => `${V}/human/tickets/${nodeId}/resolve`,
-    humanTicketCancel: (nodeId) => `${V}/human/tickets/${nodeId}/cancel`,
+    humanTicketResolve: (ticketId) => `${V}/human/tickets/${ticketId}/resolve`,
+    humanTicketCancel: (ticketId) => `${V}/human/tickets/${ticketId}/cancel`,
     // Daemon-owned document reviews and comments. All interpolated ids are
     // guarded by `CrtrClient` before they reach these pure builders.
     humanReviews: () => `${V}/human/reviews`,
@@ -108,10 +108,8 @@ export const routes = {
     humanInboxProgress: (ticketId) => `${V}/human/inbox/${ticketId}/progress`,
     humanInboxResponse: (ticketId) => `${V}/human/inbox/${ticketId}/response`,
     humanInboxCancel: (ticketId) => `${V}/human/inbox/${ticketId}/cancel`,
-    humanInboxRender: (ticketId) => `${V}/human/inbox/${ticketId}/render`,
-    /** The built page runtime assets, served for whatever host renders a page. */
-    humanPagesBundle: (asset) => `${V}/human/pages/bundle.${asset}`,
-    // Profiles (server-side for P2 Core; CLI profile verbs stay fs-local)
+    humanInboxFeedbackResolve: (ticketId, commentId) => `${V}/human/inbox/${ticketId}/feedback-comments/${commentId}/resolve`,
+    // Profiles (deletion is daemon-owned because it crosses canvas state)
     profiles: () => `${V}/profiles`,
     profile: (name) => `${V}/profiles/${name}`,
     // Model auth

package/package.json

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