@north-light/cli 0.0.0 → 0.3.414

package/dist/clients/conversation/projection.d.ts

@@ -0,0 +1,79 @@
+import type { AgentSessionEvent } from '@earendil-works/pi-coding-agent';
+import type { Message, ToolResultMessage } from '@earendil-works/pi-ai';
+import type { BrokerSnapshot } from '../../core/runtime/broker-protocol.js';
+import { type ToolGroupSummary } from '../../shared/tool-groups.js';
+/** A persisted pi message or a crouter custom message carried on the broker wire. */
+export type AnyMessage = Message | ({
+    role: string;
+} & Record<string, unknown>);
+export interface ConvState {
+    /** The full ordered transcript (snapshot history + streamed messages). */
+    messages: AnyMessage[];
+    /** Index of the assistant message currently streaming, or null. */
+    streamingIndex: number | null;
+    /** toolCallIds whose `tool_execution_*` is in flight (for an "executing…" badge). */
+    executingToolIds: ReadonlySet<string>;
+    /** Latest streaming/final result carried by tool_execution_* before the persisted toolResult message lands. */
+    partialToolResults: ReadonlyMap<string, ToolResultMessage>;
+    /** True between `agent_start` and `agent_end` (drives prompt-vs-steer + Stop). */
+    isStreaming: boolean;
+    /** A transient activity label (working / compacting / retrying), or null. */
+    activity: string | null;
+    /** Broker-selected normal label restored after temporary compaction/retry activity. */
+    workingActivity: string;
+    /** Texts still waiting to run — a writable view's steer/follow-up sent mid-turn
+     *  (pi's `_steeringMessages` + `_followUpMessages`), authoritative from the
+     *  engine's `queue_update` event. Drained (and removed here) the moment each
+     *  one starts as a real `message_start`, so a queued row and the eventual
+     *  transcript message never both show. */
+    queued: readonly string[];
+    /** Plain-text presentation recaps, keyed by the group's first tool-call id. */
+    toolGroupSummaries: Readonly<Record<string, string>>;
+    /** Canonical broker-owned completed tool-group summaries, keyed by the group's first tool-call id. */
+    toolGroupSummaryDetails: Readonly<Record<string, ToolGroupSummary>>;
+}
+export declare function initialConvState(): ConvState;
+/** Rebuild the ephemeral reconciliation fields from a persisted transcript cache. */
+export declare function restoreConvState(entry: {
+    messages: AnyMessage[];
+    isStreaming: boolean;
+    activity: string | null;
+    toolGroupSummaries: unknown;
+}): ConvState;
+/** Seed state from the broker's catch-up snapshot.
+ *
+ *  `welcome.snapshot` is the PERSISTED history (`snapshotMessages()` in the
+ *  broker), not the live in-memory array. During an active turn — after
+ *  `message_start`, before `message_end` — the in-flight assistant message may
+ *  not be persisted yet, so a mid-stream `welcome` can report
+ *  `state.isStreaming: true` with no trailing assistant in the snapshot.
+ *  Wholesale-replacing in that case (as we always did) drops the in-flight
+ *  turn: `streamingIndex` resets to null and the next `message_update`/
+ *  `message_end` has nothing to land on (see `reduce`).
+ *
+ *  So: idle snapshots replace wholesale exactly as before. Streaming snapshots
+ *  reconcile — if the persisted history already ends in an assistant, adopt
+ *  it as the streaming target; otherwise adopt the caller-supplied `previous`
+ *  state's in-flight assistant (a cache-first render or an earlier live
+ *  session) if one exists, or synthesize an empty placeholder. Either way the
+ *  first `message_update` REPLACES that message wholesale, so no duplicate or
+ *  dropped turn results. */
+export declare function applySnapshot(snapshot: BrokerSnapshot, previous?: ConvState): ConvState;
+/** Apply the broker's random choice for the newly received user message. */
+export declare function applyWorkingActivity(state: ConvState, activity: string): ConvState;
+/** Apply one broker-published structured summary without touching transcript ordering. */
+export declare function applyToolGroupSummary(state: ConvState, key: string, summary: ToolGroupSummary): ConvState;
+export declare function bashStart(state: ConvState, command: string, excludeFromContext?: boolean): ConvState;
+export declare function bashOutput(state: ConvState, chunk: string): ConvState;
+export declare function bashEnd(state: ConvState, result: {
+    exitCode: number | undefined;
+    cancelled: boolean;
+    truncated: boolean;
+    fullOutputPath?: string;
+}): ConvState;
+/** Apply one broker→client AGENT event (an `AgentSessionEvent`) to the transcript.
+ *  Broker control frames (welcome/model_changed/error/…) are handled by the hook,
+ *  NOT here — only pi agent events reach this function. Returns a NEW state object
+ *  (with fresh `messages`/`executingToolIds` only when they actually change) so
+ *  React re-renders correctly. */
+export declare function reduce(state: ConvState, event: AgentSessionEvent): ConvState;

package/dist/clients/conversation/projection.js

@@ -0,0 +1 @@
+var I=Object.defineProperty;var s=(t,e)=>I(t,"name",{value:e,configurable:!0});import{normalizeToolGroupSummary as T,normalizeToolGroupSummaryRecord as p}from"../../shared/tool-groups.js";import{DEFAULT_WORKING_ACTIVITY as c}from"../../shared/working-activity.js";function w(){return{messages:[],streamingIndex:null,executingToolIds:new Set,partialToolResults:new Map,isStreaming:!1,activity:null,workingActivity:c,queued:[],toolGroupSummaries:{},toolGroupSummaryDetails:{}}}s(w,"initialConvState");function E(t){const e=t.messages.length-1;return{...w(),messages:t.messages,streamingIndex:t.isStreaming&&e>=0?e:null,isStreaming:t.isStreaming,activity:t.activity,workingActivity:t.isStreaming&&t.activity!==null?t.activity:c,toolGroupSummaries:b(t.toolGroupSummaries),toolGroupSummaryDetails:p(t.toolGroupSummaries)}}s(E,"restoreConvState");function A(){return{role:"assistant",content:[]}}s(A,"placeholderAssistant");function M(t,e){const n=t.messages,o=G(t),i=R(o),l=t.state?.isStreaming===!0,r=h(t),u=_(t);if(!l)return{messages:n,streamingIndex:null,executingToolIds:new Set,partialToolResults:new Map,isStreaming:!1,activity:null,workingActivity:r,queued:u,toolGroupSummaries:i,toolGroupSummaryDetails:o};const m=n.length-1;if(m>=0&&a(n[m])==="assistant")return{messages:n,streamingIndex:m,executingToolIds:new Set,partialToolResults:new Map,isStreaming:!0,activity:r,workingActivity:r,queued:u,toolGroupSummaries:i,toolGroupSummaryDetails:o};const g=e&&e.streamingIndex!==null?e.messages[e.streamingIndex]:void 0,S=g&&a(g)==="assistant"?g:A(),d=[...n,S];return{messages:d,streamingIndex:d.length-1,executingToolIds:new Set,partialToolResults:new Map,isStreaming:!0,activity:r,workingActivity:r,queued:u,toolGroupSummaries:i,toolGroupSummaryDetails:o}}s(M,"applySnapshot");function h(t){const e=t.workingActivity;return typeof e=="string"&&e.trim()!==""?e:c}s(h,"snapshotWorkingActivity");function _(t){const e=t.queued;if(typeof e!="object"||e===null)return[];const{steering:n,followUp:o}=e;return[...f(n),...f(o)]}s(_,"snapshotQueued");function f(t){return Array.isArray(t)?t.filter(e=>typeof e=="string"):[]}s(f,"texts");function O(t,e){const n=e.trim()===""?c:e;return t.workingActivity===n?t:{...t,workingActivity:n}}s(O,"applyWorkingActivity");function G(t){return p(t.toolGroupSummaries)}s(G,"snapshotToolGroupSummaries");function R(t){return Object.fromEntries(Object.entries(t).map(([e,n])=>[e,n.bullets.join(" \xB7 ")]))}s(R,"summaryTexts");function b(t){return typeof t!="object"||t===null||Array.isArray(t)?{}:Object.fromEntries(Object.entries(t).filter(e=>typeof e[1]=="string"))}s(b,"textToolGroupSummaries");function D(t,e,n){const o=e.trim()===""?null:T(n);return o===null?t:{...t,toolGroupSummaries:{...t.toolGroupSummaries,[e]:o.bullets.join(" \xB7 ")},toolGroupSummaryDetails:{...t.toolGroupSummaryDetails,[e]:o}}}s(D,"applyToolGroupSummary");function a(t){return t.role??""}s(a,"roleOf");function x(t){for(let e=t.messages.length-1;e>=0;e--)if(a(t.messages[e])==="bashExecution")return e;return null}s(x,"lastBashIndex");function q(t,e,n){const o={role:"bashExecution",command:e,output:"",exitCode:void 0,cancelled:!1,truncated:!1,excludeFromContext:n,timestamp:Date.now()};return{...t,messages:[...t.messages,o]}}s(q,"bashStart");function $(t,e){const n=x(t);if(n===null)return t;const o=[...t.messages],i=o[n];return o[n]={...i,output:`${i.output??""}${e}`},{...t,messages:o}}s($,"bashOutput");function z(t,e){const n=x(t);if(n===null)return t;const o=[...t.messages],i=o[n];return o[n]={...i,exitCode:e.exitCode,cancelled:e.cancelled,truncated:e.truncated,fullOutputPath:e.fullOutputPath},{...t,messages:o}}s(z,"bashEnd");function F(t,e){switch(e.type){case"agent_start":return{...t,isStreaming:!0,activity:t.workingActivity};case"agent_end":case"agent_settled":return{...t,isStreaming:!1,activity:null,streamingIndex:null,executingToolIds:t.executingToolIds.size?new Set:t.executingToolIds};case"message_start":{const n=e.message,o=[...t.messages,n],i=a(n)==="assistant";let l=t.partialToolResults;if(a(n)==="toolResult"){const r=n.toolCallId;if(typeof r=="string"&&l.has(r)){const u=new Map(l);u.delete(r),l=u}}return{...t,messages:o,partialToolResults:l,streamingIndex:i?o.length-1:t.streamingIndex}}case"message_update":{let n=t.streamingIndex;if(n===null){const i=t.messages.length-1;i>=0&&a(t.messages[i])==="assistant"&&(n=i)}if(n===null)return t;const o=[...t.messages];return o[n]=e.message,{...t,messages:o,streamingIndex:n}}case"message_end":{if(t.streamingIndex===null)return t;const n=[...t.messages];return n[t.streamingIndex]=e.message,{...t,messages:n,streamingIndex:null}}case"tool_execution_start":{const n=new Set(t.executingToolIds);return n.add(e.toolCallId),{...t,executingToolIds:n}}case"tool_execution_update":{const n=new Map(t.partialToolResults);return n.set(e.toolCallId,y(e.toolCallId,e.toolName,e.partialResult,!1)),{...t,partialToolResults:n}}case"tool_execution_end":{const n=new Set(t.executingToolIds);n.delete(e.toolCallId);const o=new Map(t.partialToolResults);return o.set(e.toolCallId,y(e.toolCallId,e.toolName,e.result,e.isError)),{...t,executingToolIds:n,partialToolResults:o}}case"compaction_start":return{...t,activity:"Compacting context\u2026"};case"compaction_end":return{...t,activity:t.isStreaming?t.workingActivity:null};case"auto_retry_start":return{...t,activity:`Retrying (${e.attempt}/${e.maxAttempts}) in ${Math.ceil(e.delayMs/1e3)}s\u2026`};case"auto_retry_end":return{...t,activity:t.isStreaming?t.workingActivity:null};case"queue_update":return{...t,queued:[...e.steering,...e.followUp]};default:return t}}s(F,"reduce");function y(t,e,n,o){const i=typeof n=="object"&&n!==null?n:{};return{role:"toolResult",toolCallId:t,toolName:e,...i,content:Array.isArray(i.content)?i.content:[],isError:o}}s(y,"toolResultFromExecution");export{M as applySnapshot,D as applyToolGroupSummary,O as applyWorkingActivity,z as bashEnd,$ as bashOutput,q as bashStart,w as initialConvState,F as reduce,E as restoreConvState};

package/dist/clients/conversation/submit.d.ts

@@ -0,0 +1,38 @@
+export type SubmitClassification = {
+    kind: 'empty';
+} | {
+    kind: 'slash';
+    trimmed: string;
+} | {
+    kind: 'dormant';
+    text: string;
+    trimmed: string;
+} | {
+    kind: 'bash';
+    command: string;
+    excludeFromContext: boolean;
+    trimmed: string;
+} | {
+    kind: 'steer';
+    text: string;
+    trimmed: string;
+} | {
+    kind: 'prompt';
+    text: string;
+    trimmed: string;
+};
+/**
+ * Classify a text submission to determine the appropriate message kind.
+ *
+ * The branch order is load-bearing and must match the original handleSubmit order exactly:
+ * 1. Empty trim → nothing
+ * 2. Slash command → handled by the viewer caller
+ * 3. Dormant + can wake → dormant wake (if `canWakeDormant`)
+ * 4. Bash (! or !!) → bash
+ * 5. Streaming ? steer : prompt → prompt or steer
+ */
+export declare function classifySubmit(text: string, ctx: {
+    isDormant: boolean;
+    canWakeDormant: boolean;
+    isStreaming: boolean;
+}): SubmitClassification;

package/dist/clients/conversation/submit.js

@@ -0,0 +1 @@
+var m=Object.defineProperty;var e=(t,i)=>m(t,"name",{value:i,configurable:!0});function o(t,i){const r=t.trim();if(!r)return{kind:"empty"};if(r.startsWith("/"))return{kind:"slash",trimmed:r};if(i.isDormant&&i.canWakeDormant)return{kind:"dormant",text:t,trimmed:r};if(r.startsWith("!")){const n=r.startsWith("!!"),s=r.slice(n?2:1).trim();return s===""?{kind:"empty"}:{kind:"bash",command:s,excludeFromContext:n,trimmed:r}}return i.isStreaming?{kind:"steer",text:t,trimmed:r}:{kind:"prompt",text:t,trimmed:r}}e(o,"classifySubmit");export{o as classifySubmit};

package/dist/clients/inbox/controller.d.ts

@@ -0,0 +1,174 @@
+import type { Key } from './tui/keys.js';
+import type { SurfaceHost } from '../surfaces/host.js';
+import type { InboxRow } from './dto-adapt.js';
+/** The attached node's profile, when it has one. The list opens filtered to
+ *  this profile's nodes and uppercase P toggles that off for this open inbox. */
+export interface InboxProfileScope {
+    /** Stable profile id the membership set was fetched for. */
+    id: string;
+    /** Display name for the heading; never used to decide membership. */
+    label: string;
+    /** Node ids in that profile, re-read on every rescan. */
+    members: () => ReadonlySet<string>;
+}
+export interface InboxControllerOptions {
+    host: SurfaceHost;
+    /** Called whenever the rendered frame may have changed. */
+    onDirty: () => void;
+    /** Called after the controller has finished closing itself. */
+    onClosed: () => void;
+    cols?: number;
+    rows?: number;
+    scan?: () => Promise<InboxRow[]>;
+    /** Replaces the default rescan after inbox activity. */
+    onInboxActivity?: () => void;
+    /** Ticket dir to seat the selection on at construction, when present. */
+    initialSelection?: string;
+    profile?: InboxProfileScope;
+}
+type Screen = 'list' | 'detail';
+/** Host-agnostic model for scanning, stable selection, claims, and rendering. */
+export declare class InboxController {
+    private readonly options;
+    private readonly host;
+    private readonly scan;
+    /** Every row the daemon's inbox leaves eligible. This, never the
+     *  profile-filtered list, decides whether a ticket has settled. */
+    private items;
+    /** The eligible rows the current filter shows. */
+    private visible;
+    private readonly profile;
+    private filter;
+    /** Ticket dir the caller asked to open on, until the first scan can seat it. */
+    private pendingSeat;
+    private selectedDir;
+    /** Position hint into `visible`; the highlight itself is derived from
+     *  `selectedDir`, which an open detail may hold on a filtered-out ticket. */
+    private selectedIndex;
+    private screen;
+    private adapter;
+    private reviewAdapter;
+    private focusingSource;
+    private claim;
+    private submittingDir;
+    private cancelConfirmation;
+    private cols;
+    private rows;
+    private status;
+    /** Set while the latest refresh failed, so the list is known incomplete. */
+    private refreshError;
+    private watchers;
+    private selectedWatcher;
+    private heartbeat;
+    private started;
+    private closed;
+    /** The selected page's projection, kept across frames because fetching it is
+     *  a round trip. `view` is held so a width change re-wraps without one. */
+    private preview;
+    /** A preview read that failed, so the panel says so instead of staying blank. */
+    private previewFailed;
+    /** In-flight preview fetch, keyed by dir: one request per selection at a time. */
+    private previewFetching;
+    /** Set by `invalidate`: the held preview may no longer be the current revision. */
+    private previewStale;
+    /** The revision the open detail was loaded from, so a replacement published
+     *  while the reader has the page open reloads it. */
+    private openRevision;
+    constructor(options: InboxControllerOptions);
+    snapshot(): {
+        items: InboxRow[];
+        selectedDir?: string;
+        screen: Screen;
+        inputBuffer?: string;
+    };
+    rescan(): Promise<void>;
+    /** Apply the active filter to the eligible list. A ticket belongs to the
+     *  profile exactly when its requesting node is one of that profile's nodes;
+     *  an absent or unknown requester is reachable under all profiles only. */
+    private recomputeVisible;
+    /** Put the highlight back on a visible row after the list or the filter
+     *  changed under it, keeping the same list position when the selected ticket
+     *  is gone. An open detail holds its own ticket instead, filtered out or not. */
+    private reseatSelection;
+    /** Index of the highlighted row, or -1 while an open detail holds a ticket
+     *  the filter hides — no other row stands in for it. */
+    private highlightIndex;
+    /** The highlighted ticket, absent when no visible row is highlighted. */
+    private currentRow;
+    private scopeHeading;
+    /** Record how a surface refresh ended. A failure names itself while the last
+     *  complete list stays on screen — never an empty profile or a silent
+     *  widening — and the next successful refresh takes that notice away. */
+    refreshOutcome(error?: string): void;
+    start(): void;
+    /** Inbox activity is the one signal a replacement always emits, and it is
+     *  emitted after the new revision is selected — so an open page reloads here
+     *  rather than from a file watch that cannot see a directory swap. */
+    invalidate(): Promise<void>;
+    resize(cols: number, rows: number): void;
+    render(): string[];
+    handleKey(input: string, key: Key): void;
+    /** Swap between this profile's tickets and every eligible ticket. The mode
+     *  lives only until this inbox closes; the next open starts filtered again. */
+    private toggleProfileFilter;
+    /** Settle the selected ticket from the list with what crouter already put on
+     *  its summary — the agent's recommended option, or a notice's empty map. A
+     *  row without a fast action says so rather than opening the page: the key
+     *  means one thing, and the page is what Enter is for. */
+    private sendFastAction;
+    /** A review and a page are two different durable records; the inbox dismisses
+     *  whichever one the selected row actually is. */
+    private cancelFromInbox;
+    activate(): Promise<void>;
+    /** A review opens in its own tmux window, which tmux selects at once, so
+     *  the inbox left behind in this pane has nothing more to do: it closes,
+     *  and returning to this window lands on the conversation beneath it. The
+     *  inbox stays up only when the window could not be opened, so its notice
+     *  is read where the person is looking. */
+    private activateReview;
+    /** Seat the selection on a ticket dir, when present in the current list. */
+    selectDir(dir: string): void;
+    /** Seat the selection on an eligible ticket, widening to all profiles when
+     *  the profile filter alone is what hides it — a caller that names a ticket
+     *  is promised that ticket, never a neighbouring one. */
+    private seatOn;
+    /** Re-read the open page and reload it only when its revision actually moved. */
+    reloadSelectedPage(): Promise<void>;
+    close(): void;
+    private complete;
+    /** Edit the active buffer while the host releases the terminal to $EDITOR. */
+    private editActivePageInput;
+    private leaveDetail;
+    private select;
+    private detailSize;
+    private detailLines;
+    private focusAvailable;
+    /** Ask the host to bring the requesting node's viewer into view — the
+     *  conversation that raised this ask. */
+    private focusSelectedSource;
+    /** What the selected page actually says. Rendering is synchronous and the
+     *  page is a round trip, so the projection is held and a miss schedules the
+     *  fetch, marking the frame dirty when it lands. A width change re-wraps the
+     *  held projection without another read. */
+    private pagePreviewBody;
+    /** One in-flight preview read at a time. A revision that did not move keeps
+     *  the held projection, so activity on an unrelated ticket costs no re-wrap. */
+    private schedulePreview;
+    /** The request record is the settlement authority: a settled page publishes
+     *  no file, so a claim would still succeed on its directory. An unreachable
+     *  daemon reads as "not known to be settled" — the settle attempt that
+     *  follows is the one that fails loudly. */
+    private requestOrNull;
+    /** The read-only preview beside the list. It shows the page's own content,
+     *  because `s` settles the selected ticket from here without ever opening
+     *  it — a reader must not answer something they were never shown. */
+    private passiveDetailLines;
+    private withStatus;
+    private markDirty;
+    private watchRoots;
+    /** The request directory still carries the claim and progress files other
+     *  inboxes write. Its page content lives in the daemon-selected revision,
+     *  which `invalidate` re-reads over the API. */
+    private watchSelected;
+}
+export {};

package/dist/clients/inbox/controller.js

@@ -0,0 +1 @@
+var A=Object.defineProperty;var o=(d,e)=>A(d,"name",{value:e,configurable:!0});import{existsSync as P,watch as R}from"node:fs";import{visibleWidth as F}from"@earendil-works/pi-tui";import{renderMarkdown as C}from"../../core/termrender/termrender.js";import{BOLD as M,CYAN as W,DIM as h,GRAY as q,RESET as a,YELLOW as D,clipLine as p}from"./tui/ansi.js";import{buildInboxLines as O,recommendedLabel as L}from"./tui.js";import{inboxLayout as g}from"./layout.js";import{resolvePageComponents as E}from"../../core/config.js";import{watchInboxActivity as N}from"../../core/human/root.js";import{claimTicket as k,heartbeatClaim as H,releaseClaim as u}from"../../core/human/claim.js";import{claimPath as T,clearProgress as B}from"../../core/human/convention.js";import{emitEvent as _}from"../../core/events/emit.js";import{cliClient as f}from"../../commands/api-client.js";import{projectPageDisplayMarkdown as z}from"../../core/human/page-markdown.js";import{projectHtmlDocumentMarkdown as V}from"../../core/human/page-html-markdown.js";import{pageBodyLines as j}from"./tui/page-body.js";import{byNewestFirst as K,inboxRowFromDTO as Y,pageViewFromDTO as b,settledStatusOf as x}from"./dto-adapt.js";import{PageAdapter as G}from"./page-adapter.js";import{ReviewAdapter as X}from"./review-adapter.js";import{createReviewClient as J}from"./review/review-client.js";import{editBufferInEditor as Q}from"./review/roundtrip.js";import{daemonErrorMessage as m,dismissTicketViaDaemon as U,resolveFailureKind as $,resolveTicketPage as I}from"./resolve.js";class ke{static{o(this,"InboxController")}options;host;scan;items=[];visible=[];profile;filter;pendingSeat;selectedDir;selectedIndex=0;screen="list";adapter;reviewAdapter;focusingSource=!1;claim;submittingDir;cancelConfirmation;cols;rows;status;refreshError;watchers=[];selectedWatcher;heartbeat;started=!1;closed=!1;preview;previewFailed;previewFetching;previewStale=!1;openRevision;constructor(e){this.options=e,this.host=e.host,this.scan=e.scan??Z,this.cols=e.cols??80,this.rows=e.rows??24,this.profile=e.profile,this.filter=e.profile===void 0?"all":"profile",this.selectedDir=e.initialSelection,this.pendingSeat=e.initialSelection,this.rescan()}snapshot(){return{items:[...this.items],selectedDir:this.selectedDir,screen:this.screen,inputBuffer:this.adapter?.inputBuffer()}}async rescan(){const e=this.selectedDir,t=this.claim;try{this.items=await this.scan()}catch(s){if(this.closed)return;this.status=m(s),this.markDirty();return}if(this.closed)return;if(this.recomputeVisible(),this.pendingSeat!==void 0){const s=this.pendingSeat;this.pendingSeat=void 0,this.seatOn(s)}if(!(e!==void 0&&this.items.some(s=>s.dir===e))&&this.adapter!==void 0&&e!==void 0&&t!==void 0){const s=(await this.requestOrNull(t.id))?.state==="canceled";if(this.closed)return;s&&B(e),e!==this.submittingDir&&(this.status=s?"canceled by requester":"ticket resolved elsewhere"),this.leaveDetail(e!==this.submittingDir)}this.reseatSelection()}recomputeVisible(){if(this.filter==="all"||this.profile===void 0){this.visible=this.items;return}const e=this.profile.members();this.visible=this.items.filter(t=>{const i=t.source.nodeId;return i!==void 0&&e.has(i)})}reseatSelection(){const e=this.selectedDir===void 0?-1:this.visible.findIndex(t=>t.dir===this.selectedDir);if(e>=0){this.selectedIndex=e;return}if(!(this.adapter!==void 0&&this.selectedDir!==void 0&&this.items.some(t=>t.dir===this.selectedDir))){if(this.visible.length===0){this.selectedIndex=0,this.selectedDir=void 0;return}this.selectedIndex=Math.min(Math.max(0,this.selectedIndex),this.visible.length-1),this.selectedDir=this.visible[this.selectedIndex].dir}}highlightIndex(){return this.selectedDir===void 0?-1:this.visible.findIndex(e=>e.dir===this.selectedDir)}currentRow(){const e=this.highlightIndex();return e>=0?this.visible[e]:void 0}scopeHeading(){return this.profile===void 0?{label:"all profiles"}:this.filter==="profile"?{label:this.profile.label,hint:"P all profiles"}:{label:"all profiles",hint:`P ${this.profile.label} only`}}refreshOutcome(e){if(this.refreshError=e,e===void 0){this.invalidate();return}this.markDirty()}start(){this.started||this.closed||(this.started=!0,this.watchRoots(),this.heartbeat=setInterval(()=>{this.claim!==void 0&&H(this.claim.dir,this.claim.token)},1e4))}async invalidate(){if(this.previewStale=!0,await this.rescan(),!this.closed){if(this.adapter!==void 0&&this.claim!==void 0){await this.reloadSelectedPage();return}this.markDirty()}}resize(e,t){this.cols=e,this.rows=t,this.adapter?.resize(this.detailSize().cols,this.detailSize().rows),this.markDirty()}render(){const e=g(this.cols,this.rows,this.screen);if(e.mode==="minimum")return[`${D}Resize terminal to at least 60\xD718 to use inbox.${a}`];const t=O(this.visible,e.listWidth,this.highlightIndex(),this.scopeHeading(),e.height),i=this.detailLines(e.detailWidth,e.height);if(e.mode==="list")return this.withStatus(t);if(e.mode==="detail")return this.withStatus(i);const s=[],n=`${q}\u2502${a}`;for(let r=0;r<e.height;r++){const l=p(t[r]??"",e.listWidth),c=p(i[r]??"",e.detailWidth),v=" ".repeat(Math.max(0,e.listWidth-F(l)));s.push(`${l}${v}${n}${c}`)}return this.withStatus(s)}handleKey(e,t){if(t.ctrl&&e==="c"){this.close();return}if(this.screen==="detail"&&this.adapter!==void 0){if((e==="g"||e==="G")&&this.adapter.canAcceptHostKeys()){this.focusSelectedSource();return}this.adapter.handleKey(e,t),this.markDirty();return}if(this.cancelConfirmation!==void 0){if(e==="y"||e==="Y"){const i=this.cancelConfirmation.item;this.cancelConfirmation=void 0,this.status="canceling\u2026",this.cancelFromInbox(i)}else(e==="n"||e==="N"||t.escape)&&(this.cancelConfirmation=void 0,this.status=void 0);this.markDirty();return}if(e==="P"&&this.profile!==void 0){this.toggleProfileFilter(),this.markDirty();return}if(e==="x"||e==="X"){const i=this.currentRow();i!==void 0&&(this.cancelConfirmation={item:i},this.status=void 0),this.markDirty();return}if(e==="s"||e==="S"){this.sendFastAction(),this.markDirty();return}if(t.escape||e==="q"){this.close();return}e==="j"||t.downArrow?this.select(this.selectedIndex+1):e==="k"||t.upArrow?this.select(this.selectedIndex-1):e==="g"||e==="G"?this.focusSelectedSource():(t.return||e==="a")&&this.activate(),this.markDirty()}toggleProfileFilter(){this.filter=this.filter==="profile"?"all":"profile",this.recomputeVisible(),this.reseatSelection()}async sendFastAction(){const e=this.currentRow();if(e===void 0)return;if(e.kind!=="page"||e.fastAction===void 0){this.status="no recommended answer on this ticket \u2014 Enter opens it";return}const t=await this.requestOrNull(e.id);if(y(t)){this.status=w(t),await this.rescan();return}const i=k(e.dir);if(i===null){this.status="ticket is being edited by another inbox";return}const s=e.fastAction.kind==="acknowledge"?"acknowledged":`sent: ${L(e)??"recommended answer"}`;this.submittingDir=e.dir;try{await I(e.id,e.fastAction.responses),this.status=s}catch(n){this.status=$(n)==="already_settled"?w(await this.requestOrNull(e.id)):m(n)}finally{u(e.dir,i.token),this.submittingDir=void 0,await this.rescan(),this.markDirty()}}async cancelFromInbox(e){this.submittingDir=e.dir;try{e.kind==="review"?await J().cancel(e.id,"Canceled from the inbox."):await U(e.id,{reason:"Canceled from the inbox.",actor:"human"}),this.status="canceled"}catch(t){this.status=m(t)}finally{this.submittingDir=void 0,await this.rescan(),this.markDirty()}}async activate(){const e=this.currentRow();if(e===void 0)return;if(e.kind==="review"){await this.activateReview(e);return}const t=await this.requestOrNull(e.id);if(this.closed)return;if(y(t)){this.status=w(t),await this.rescan();return}const i=k(e.dir);if(i===null){this.status="ticket is being edited by another inbox";return}let s,n;try{const r=await f().getHumanInboxPage(e.inboxTicketId);if(r.state==="resolved"||r.state==="canceled"){u(e.dir,i.token),this.status=x(r),await this.rescan();return}s=b(r),n=r.revision}catch{u(e.dir,i.token),this.status="page could not be read",await this.invalidate();return}if(this.closed||this.claim!==void 0||this.adapter!==void 0){u(e.dir,i.token);return}this.claim={dir:e.dir,id:e.id,ticketId:e.inboxTicketId,token:i.token},this.screen="detail",this.adapter=new G({ticketId:e.inboxTicketId,page:s,productKinds:E(),cols:this.detailSize().cols,rows:this.detailSize().rows,onDirty:o(()=>this.markDirty(),"onDirty"),onEditorRequest:o(()=>this.editActivePageInput(),"onEditorRequest"),onBack:o(()=>{this.leaveDetail(),this.markDirty()},"onBack"),onComplete:o(r=>{this.complete(r)},"onComplete")}),this.openRevision=n,this.watchSelected(e.dir),this.markDirty()}async activateReview(e){this.reviewAdapter=new X({reviewId:e.id,host:this.host});let t=!1;try{t=await this.reviewAdapter.start()}catch(i){this.status=m(i)}finally{this.reviewAdapter=void 0}if(t){this.close();return}await this.rescan(),this.markDirty()}selectDir(e){this.seatOn(e)&&this.markDirty()}seatOn(e){let t=this.visible.findIndex(i=>i.dir===e);return t<0&&this.items.some(i=>i.dir===e)&&(this.filter="all",this.recomputeVisible(),t=this.visible.findIndex(i=>i.dir===e)),t<0?!1:(this.select(t),!0)}async reloadSelectedPage(){const e=this.claim;if(this.adapter===void 0||e===void 0){this.markDirty();return}try{const t=await f().getHumanInboxPage(e.ticketId);if(this.closed||this.claim!==e||this.adapter===void 0)return;t.revision!==this.openRevision&&(this.openRevision=t.revision,this.adapter.reload(b(t)))}catch{this.status="page could not be read"}this.markDirty()}close(){if(!this.closed){this.closed=!0,this.started=!1,this.heartbeat!==void 0&&clearInterval(this.heartbeat),this.heartbeat=void 0,this.reviewAdapter?.stop(),this.leaveDetail(this.claim?.dir!==this.submittingDir);for(const e of this.watchers)e.close();this.watchers=[],this.selectedWatcher?.close(),this.selectedWatcher=void 0,this.options.onClosed()}}async complete(e){const t=this.claim;if(t===void 0)return;this.submittingDir=t.dir;try{await I(t.id,e)}catch(s){this.submittingDir=void 0,this.status=m(s);const n=$(s);if(n==="unreachable"||n==="other"){this.markDirty();return}n==="already_settled"&&(this.status=w(await this.requestOrNull(t.id))),this.leaveDetail(!1),await this.rescan(),this.markDirty();return}this.submittingDir=void 0,this.leaveDetail(!1),await this.rescan();const i=this.items.some(s=>s.dir===t.dir);_({level:i?"warn":"info",event:"inbox.page.resolved",fields:{ticket_id:t.id,request_settled:y(await this.requestOrNull(t.id)),still_listed:i,claim_left_behind:P(T(t.dir))}}),this.markDirty()}editActivePageInput(){const e=this.adapter?.inputBuffer();if(e===void 0)return;const t=this.host.suspendForChild();let i={text:e};try{i=Q(e)}finally{t(),this.adapter?.setInputBuffer(i.text),i.error!==void 0&&(this.status=i.error),this.markDirty()}}leaveDetail(e=!0){this.adapter?.close(),this.adapter=void 0,this.selectedWatcher?.close(),this.selectedWatcher=void 0,e&&this.claim!==void 0&&u(this.claim.dir,this.claim.token),this.claim=void 0,this.openRevision=void 0,this.screen="list",this.reseatSelection()}select(e){this.visible.length!==0&&(this.selectedIndex=Math.max(0,Math.min(e,this.visible.length-1)),this.selectedDir=this.visible[this.selectedIndex].dir)}detailSize(){const e=g(this.cols,this.rows,this.screen);return{cols:Math.max(1,e.detailWidth-2),rows:e.height}}detailLines(e,t){if(this.adapter!==void 0)return this.adapter.render();const i=this.currentRow();if(i===void 0)return this.passiveDetailLines(e,t);const s=this.focusAvailable(i.dir)?`  ${h}g${a} chat`:"",n=i.kind==="page"&&i.fastAction!==void 0?`  ${h}s${a} ${i.fastAction.kind==="acknowledge"?"acknowledge":"send recommended"}`:"",r=i.kind==="page"?[`  ${h}Enter${a} opens the full page  ${h}\u2191\u2193/jk${a} select${n}  ${h}x${a} cancel`,`  ${h}Page:${a} c comment  u/d scroll${s}  ${h}q${a} close`]:[`  ${h}Enter${a} opens the full review  ${h}\u2191\u2193/jk${a} select  ${h}x${a} cancel`,` ${s}  ${h}q${a} close`],l=Math.max(0,t-r.length),c=this.passiveDetailLines(e,l);for(;c.length<l;)c.push("");return[...c,...r.map(v=>p(v,e))]}focusAvailable(e){return this.host.capabilities.canFocusNode}async focusSelectedSource(){const e=this.screen==="detail"?this.claim?.dir:this.currentRow()?.dir,t=e===void 0?void 0:this.items.find(s=>s.dir===e);if(t===void 0||this.focusingSource)return;const i=t.source.nodeId;if(i===void 0){this.status="This request was not raised by a canvas node",this.markDirty();return}this.focusingSource=!0;try{await this.host.focusNode(i)?this.close():(this.status="Could not open that node\u2019s viewer",this.markDirty())}finally{this.focusingSource=!1}}pagePreviewBody(e,t){const i=this.preview;if(i!==void 0&&i.dir===e.dir){if(this.previewStale&&this.schedulePreview(e),i.width===t)return i.lines;const s=S(i.view,t);return this.preview={...i,width:t,lines:s},s}return this.schedulePreview(e),this.previewFailed===e.dir?[`${h}page could not be read${a}`]:[]}schedulePreview(e){this.previewFetching!==e.dir&&(this.previewFetching=e.dir,this.previewStale=!1,f().getHumanInboxPage(e.inboxTicketId).then(t=>{if(this.closed||this.previewFetching!==e.dir||(this.previewFetching=void 0,this.previewFailed=void 0,this.preview?.dir===e.dir&&this.preview.revision===t.revision))return;const i=b(t),s=this.preview?.width??g(this.cols,this.rows,this.screen).detailWidth;this.preview={dir:e.dir,revision:t.revision,view:i,width:s,lines:S(i,s)},this.markDirty()},()=>{this.closed||this.previewFetching!==e.dir||(this.previewFetching=void 0,this.previewFailed=e.dir,this.preview?.dir===e.dir&&(this.preview=void 0),this.markDirty())}))}async requestOrNull(e){try{return await f().getHumanRequest(e)}catch{return}}passiveDetailLines(e,t){const i=this.currentRow();if(i===void 0)return[`  ${h}Select a pending interaction.${a}`];const s=[`  ${M}${W}${i.title}${a}`,""];for(const r of C(i.subtitle,Math.max(1,e-2)))s.push(`  ${r}`);const n=i.kind==="page"?this.pagePreviewBody(i,e):[`${h}1 file to review${a}`];if(n.length>0){s.push("");const r=Math.max(0,t-s.length),l=n.length<=r?n:n.slice(0,Math.max(0,r-1));for(const c of l)s.push(`  ${c}`);l.length<n.length&&s.push(`  ${h}\u2026 +${n.length-l.length} more lines${a}`)}return s.map(r=>p(r,e)).slice(0,Math.max(1,t))}withStatus(e){const t=this.cancelConfirmation===void 0?this.refreshError??this.status:`cancel \u201C${this.cancelConfirmation.item.title}\u201D?  y yes \xB7 n/Esc no`;if(t===void 0||this.rows<1)return e;const i=[...e];for(;i.length<this.rows;)i.push("");return i[this.rows-1]=`${D}${t}${a}`,i}markDirty(){this.options.onDirty()}watchRoots(){const e=N(this.options.onInboxActivity??(()=>{this.invalidate()}));this.watchers.push({close:e})}watchSelected(e){this.selectedWatcher?.close();try{this.selectedWatcher=R(e,()=>{this.invalidate()})}catch{this.selectedWatcher=void 0}}}async function Z(){const{tickets:d}=await f().listHumanInbox();return d.map(Y).sort(K)}o(Z,"defaultScan");function S(d,e){const t=d.manifest.dialect==="html"?V(d.document):z(d.document,d.manifest);return j(d.manifest,t,Math.min(Math.max(20,e-4),100),Math.max(20,e-4))}o(S,"previewLines");function y(d){return d!==void 0&&d.state!=="pending"}o(y,"isSettled");function w(d){return d?.page===void 0?"ticket was already resolved":x(d.page)}o(w,"settledStatus");export{ke as InboxController};

package/dist/clients/inbox/dto-adapt.d.ts

@@ -0,0 +1,28 @@
+import type { InboxPageDTO, InboxTicketSummaryDTO } from '../../api/dto/inbox.js';
+import type { PageManifest, PageResponses } from '../../core/human/page-schema.js';
+import type { PageTicketSummary, ReviewTicketSummary } from '../../core/human/types.js';
+/** A review row as the inbox actually uses it. The review's file and output
+ *  path belong to the review document surface, which reads them from the review
+ *  client — an inbox row never needs either. */
+export type InboxReviewRow = Omit<ReviewTicketSummary, 'file' | 'output'>;
+export type InboxRow = PageTicketSummary | InboxReviewRow;
+/** Everything the page renderer needs, plus the revision token that decides
+ *  whether an already-open page has to reload. */
+export interface InboxPageView {
+    manifest: PageManifest;
+    /** The authored JSX/HTML source the renderer projects — never the compiled host module. */
+    document: string;
+    progress: PageResponses | null;
+    state: 'pending' | 'resolved' | 'canceled' | 'passive';
+    /** Opaque equality token for the SQL-selected revision. Compare, never parse. */
+    revision: string;
+}
+export declare function inboxRowFromDTO(dto: InboxTicketSummaryDTO): InboxRow;
+export declare function pageViewFromDTO(dto: InboxPageDTO): InboxPageView;
+/** The stored one-line answer digest, or undefined when the page was not
+ *  answered. A canceled page carries no digest by construction. */
+export declare function answerDigestOf(dto: InboxPageDTO): string | undefined;
+/** What a surface says when a settled request refuses a second settlement. */
+export declare function settledStatusOf(dto: InboxPageDTO): string;
+/** The row sort every inbox surface shares: newest first, request id breaking ties. */
+export declare function byNewestFirst(a: InboxRow, b: InboxRow): number;

package/dist/clients/inbox/dto-adapt.js

@@ -0,0 +1 @@
+var r=Object.defineProperty;var t=(e,i)=>r(e,"name",{value:i,configurable:!0});import{validatePageManifest as a}from"../../core/human/page-schema.js";function p(e){return e}t(p,"responsesFromDTO");function l(e){return{dir:e.request_dir,id:e.request_id,inboxTicketId:e.ticket_id,kind:"page",title:e.title,subtitle:e.subtitle??"",dialect:e.dialect,placement:e.placement,inbox:e.inbox,steps:e.steps,slotKinds:e.slot_kinds,awaitsResponse:e.awaits_response,source:e.source,emittedAt:e.emitted_at,recommendedOptions:(e.recommended_options??[]).map(i=>({slotId:i.slot_id,optionId:i.option_id,label:i.label})),...e.fast_action===void 0?{}:{fastAction:{kind:e.fast_action.kind,responses:e.fast_action.responses}},state:e.state,...e.answer_digest===void 0?{}:{answerDigest:e.answer_digest}}}t(l,"pageRowFromDTO");function u(e){return{dir:e.request_dir,id:e.request_id,inboxTicketId:e.ticket_id,kind:"review",title:e.title,subtitle:e.subtitle,blockedSince:e.blocked_since,source:e.source}}t(u,"reviewRowFromDTO");function d(e){return e.kind==="page"?l(e):u(e)}t(d,"inboxRowFromDTO");function m(e){return{manifest:a(e.page),document:e.source_document,progress:e.progress===null?null:e.progress.responses,state:e.state,revision:e.revision}}t(m,"pageViewFromDTO");function f(e){const i=e.result;if(!(i===null||i.kind!=="page"))return i.summary.replace(/\s+/g," ").trim()}t(f,"answerDigestOf");function k(e){const i=e.result;return i!==null&&i.kind==="canceled"?"ticket was already canceled":i!==null&&i.kind==="page"?"ticket was already resolved: page submitted":"ticket was already resolved"}t(k,"settledStatusOf");function _(e,i){const n=t(s=>s.kind==="page"?s.emittedAt:s.blockedSince,"time");return n(i).localeCompare(n(e))||e.id.localeCompare(i.id)}t(_,"byNewestFirst");export{f as answerDigestOf,_ as byNewestFirst,d as inboxRowFromDTO,m as pageViewFromDTO,k as settledStatusOf};

package/dist/clients/inbox/layout.d.ts

@@ -0,0 +1,8 @@
+export interface InboxLayout {
+    mode: 'two-column' | 'list' | 'detail' | 'minimum';
+    listWidth: number;
+    detailWidth: number;
+    height: number;
+}
+/** Pure geometry for the centralized inbox surface. */
+export declare function inboxLayout(cols: number, rows: number, screen?: 'list' | 'detail'): InboxLayout;

package/dist/clients/inbox/layout.js

@@ -0,0 +1 @@
+var n=Object.defineProperty;var e=(t,i)=>n(t,"name",{value:i,configurable:!0});function a(t,i,d="list"){if(t<60||i<18)return{mode:"minimum",listWidth:t,detailWidth:0,height:i};if(t<96)return{mode:d,listWidth:t,detailWidth:t,height:i};const h=Math.max(30,Math.min(44,Math.floor(t/3)));return{mode:"two-column",listWidth:h,detailWidth:t-h-1,height:i}}e(a,"inboxLayout");export{a as inboxLayout};

package/dist/clients/inbox/page-adapter.d.ts

@@ -0,0 +1,33 @@
+import type { ProductPageComponents } from '../../types.js';
+import type { PageResponses } from '../../core/human/page-schema.js';
+import type { InboxPageView } from './dto-adapt.js';
+import type { Key } from './tui/keys.js';
+export interface PageAdapterOptions {
+    /** The opaque inbox ticket id autosave posts against. */
+    ticketId: string;
+    page: InboxPageView;
+    productKinds: ProductPageComponents;
+    cols: number;
+    rows: number;
+    onProgress?: (responses: PageResponses) => void;
+    onComplete: (responses: PageResponses) => void;
+    onBack: () => void;
+    onDirty: () => void;
+    onEditorRequest?: () => void;
+}
+/** Embeds the page renderer in a controller-owned rectangle. */
+export declare class PageAdapter {
+    private readonly opts;
+    private panel;
+    /** The live manifest — reload() can swap a display page for a response-bearing one. */
+    private manifest;
+    constructor(opts: PageAdapterOptions);
+    render(): string[];
+    resize(cols: number, rows: number): string[];
+    inputBuffer(): string | undefined;
+    setInputBuffer(text: string): void;
+    canAcceptHostKeys(): boolean;
+    handleKey(input: string, key: Key): void;
+    reload(page: InboxPageView): void;
+    close(): void;
+}

package/dist/clients/inbox/page-adapter.js

@@ -0,0 +1 @@
+var i=Object.defineProperty;var n=(s,e)=>i(s,"name",{value:e,configurable:!0});import{pageAwaitsResponse as r}from"../../core/human/page-schema.js";import{cliClient as o}from"../../commands/api-client.js";import{mountPanel as a}from"./tui/panel.js";class d{static{n(this,"PageAdapter")}opts;panel;manifest;constructor(e){this.opts=e,this.manifest=e.page.manifest,this.panel=a({manifest:e.page.manifest,document:e.page.document,productKinds:e.productKinds,initialResponses:e.page.progress,cols:e.cols,rows:e.rows,onProgress:n(t=>{o().postInboxProgress(e.ticketId,t).catch(()=>{}),e.onProgress?.(t)},"onProgress"),onComplete:e.onComplete,onExit:n(()=>{r(this.manifest)?e.onBack():e.onComplete({})},"onExit"),onDirty:e.onDirty,onEditorRequest:e.onEditorRequest})}render(){return this.panel.render()}resize(e,t){return this.panel.handleResize(e,t)}inputBuffer(){return this.panel.getInputBuffer()}setInputBuffer(e){this.panel.setInputBuffer(e)}canAcceptHostKeys(){return this.panel.canAcceptHostKeys()}handleKey(e,t){if(t.escape&&this.panel.atPageTop()){this.opts.onBack();return}this.panel.handleKey(e,t)}reload(e){this.manifest=e.manifest,this.panel.loadPage(e.manifest,{document:e.document,initialResponses:e.progress,productKinds:this.opts.productKinds}),this.opts.onDirty()}close(){this.panel.unmount()}}export{d as PageAdapter};

package/dist/clients/inbox/resolve.d.ts

@@ -0,0 +1,16 @@
+import type { PageResponses } from '../../core/human/page-schema.js';
+/** Settle a page request with the person's answer. The request id a scan
+ *  already carries IS the settlement identity — there is no bridge node to
+ *  derive one from. An omitted actor is what records a person, not a
+ *  programmatic writer, as the author of the result. */
+export declare function resolveTicketPage(requestId: string, responses: PageResponses): Promise<void>;
+/** Close a page request from the inbox without answering it. The inbox is the
+ *  recipient surface, so this is always a dismissal, never the requester
+ *  withdrawing its own request. */
+export declare function dismissTicketViaDaemon(requestId: string, opts: {
+    reason: string;
+    actor: string;
+}): Promise<void>;
+export declare function daemonErrorMessage(err: unknown): string;
+export type ResolveFailure = 'unreachable' | 'already_settled' | 'other';
+export declare function resolveFailureKind(err: unknown): ResolveFailure;

package/dist/clients/inbox/resolve.js

@@ -0,0 +1 @@
+var s=Object.defineProperty;var n=(e,t)=>s(e,"name",{value:t,configurable:!0});import{ApiError as a}from"../../api/errors.js";import{cliClient as i}from"../../commands/api-client.js";async function d(e,t){await i().respondHumanRequest(e,{responses:t})}n(d,"resolveTicketPage");async function f(e,t){await i().dismissHumanRequest(e,t)}n(f,"dismissTicketViaDaemon");function o(e){if(e instanceof a)return e.status===503||e.code==="daemon_unavailable";const t=e?.code;return t==="ECONNREFUSED"||t==="ENOENT"}n(o,"isUnreachable");function l(e){return o(e)?"could not reach crtrd \u2014 nothing was submitted":e instanceof a||e instanceof Error?e.message:String(e)}n(l,"daemonErrorMessage");function m(e){return o(e)?"unreachable":e instanceof a&&e.status===409&&e.code==="already_settled"?"already_settled":"other"}n(m,"resolveFailureKind");export{l as daemonErrorMessage,f as dismissTicketViaDaemon,m as resolveFailureKind,d as resolveTicketPage};

package/dist/clients/inbox/review/anchors.d.ts

@@ -0,0 +1,41 @@
+import type { RenderedDoc } from '../../../core/termrender/termrender.js';
+/** One leaf anchor unit: the finest step j/k moves by. Consecutive rendered
+ *  rows sharing one source span collapse into a single unit that knows both
+ *  its source-line bounds and its rendered-row bounds. */
+export interface AnchorUnit {
+    /** 1-indexed inclusive source-line bounds. */
+    start: number;
+    end: number;
+    /** 0-indexed inclusive rendered-row bounds in the mapped doc. */
+    firstRow: number;
+    lastRow: number;
+}
+/** The anchorable shape of a rendered doc: ordered leaf units plus the
+ *  per-row owning-unit index the painter keys off. */
+export interface AnchorDoc {
+    units: AnchorUnit[];
+    /** Per rendered row: index into `units`, or null (separator rows). */
+    rowUnits: (number | null)[];
+}
+/** Derive leaf anchor units from a mapped render: dedupe runs of consecutive
+ *  rows carrying the identical source span. A mapped row without a leaf span
+ *  (an unmapped block) anchors at its whole block's range, so every content
+ *  row belongs to a unit; separator rows belong to none. */
+export declare function deriveAnchorUnits(doc: RenderedDoc): AnchorDoc;
+/** Best unit for a source line: the NARROWEST unit containing it — code/table
+ *  chrome units carry their whole block's range and sit before the per-line
+ *  content units in rendered order, so "first whose end reaches the line"
+ *  would wrongly pick the chrome over the exact code line. A line no unit
+ *  contains (a blank separator) snaps forward to the next unit; past the end
+ *  clamps to the last. */
+export declare function unitIndexForLine(units: AnchorUnit[], line: number): number;
+/** Remap a unit from an old unit list into a re-derived one: an exact
+ *  source-range match wins (chrome and leaf units can share source lines),
+ *  else the best unit for its first line. */
+export declare function remapUnitIndex(units: AnchorUnit[], prev: AnchorUnit): number;
+/** First/last unit indices overlapping the source range `line..endLine`;
+ *  a range touching no unit snaps like unitIndexForLine. */
+export declare function unitRangeForSpan(units: AnchorUnit[], line: number, endLine: number): {
+    lo: number;
+    hi: number;
+};

package/dist/clients/inbox/review/anchors.js

@@ -0,0 +1 @@
+var h=Object.defineProperty;var a=(n,e)=>h(n,"name",{value:e,configurable:!0});function g(n){const e=[],r=new Array(n.lines.length).fill(null);for(let t=0;t<n.lines.length;t++){let l=n.spans[t]??null;if(l===null){const o=n.rows[t]??null,f=o!==null?n.blocks[o]:void 0;if(f===void 0)continue;l=[f.start,f.end]}const s=e[e.length-1];s!==void 0&&s.lastRow===t-1&&s.start===l[0]&&s.end===l[1]?s.lastRow=t:e.push({start:l[0],end:l[1],firstRow:t,lastRow:t}),r[t]=e.length-1}if(e.length===0){e.push({start:n.blocks[0]?.start??1,end:n.blocks[n.blocks.length-1]?.end??1,firstRow:0,lastRow:Math.max(0,n.lines.length-1)});for(let t=0;t<r.length;t++)r[t]=0}return{units:e,rowUnits:r}}a(g,"deriveAnchorUnits");function i(n,e){let r=-1;for(let t=0;t<n.length;t++){const l=n[t];l.start<=e&&l.end>=e&&(r===-1||l.end-l.start<n[r].end-n[r].start)&&(r=t)}if(r!==-1)return r;for(let t=0;t<n.length;t++)if(n[t].start>e)return t;return Math.max(0,n.length-1)}a(i,"unitIndexForLine");function d(n,e){for(let r=0;r<n.length;r++)if(n[r].start===e.start&&n[r].end===e.end)return r;return i(n,e.start)}a(d,"remapUnitIndex");function c(n,e,r){let t=-1,l=-1;if(n.forEach((s,o)=>{s.start<=r&&s.end>=e&&(t===-1&&(t=o),l=o)}),t===-1){const s=i(n,e);return{lo:s,hi:s}}return{lo:t,hi:l}}a(c,"unitRangeForSpan");export{g as deriveAnchorUnits,d as remapUnitIndex,i as unitIndexForLine,c as unitRangeForSpan};

package/dist/clients/inbox/review/comments-client.d.ts

@@ -0,0 +1,74 @@
+export interface AnchoredComment {
+    id: string;
+    revision: number;
+    line: number;
+    endLine: number;
+    lineText: string;
+    comment: string;
+    status: 'open' | 'resolved' | 'deleted';
+    authorKind: 'human' | 'node';
+    createdAt: string;
+    anchorStatus: 'live' | 'shifted' | 'detached';
+    originalRange?: {
+        line: number;
+        endLine: number;
+    };
+}
+/** A daemon rejection that leaves the rendered document or comment projection stale. */
+export declare class ReviewDocumentError extends Error {
+    readonly code: 'stale_document' | 'stale_comment' | 'range_batch_incomplete' | 'range_batch_stale';
+    readonly details: unknown;
+    constructor(code: ReviewDocumentError['code'], message: string, details: unknown);
+}
+/** The approved document coordinates every stored comment anchor is expressed against. */
+export interface AnchorBase {
+    /** Canonical reviewed file the base was captured from; the review surface rejects a mismatched target. */
+    file: string;
+    /** Full base document text, the left side of the base→current remap done before first paint. */
+    text: string;
+    /** Content hash of `text`, and the `fromDocHash` of that first remap batch. */
+    docHash: string;
+}
+export type ReviewRequest = <T>(operation: () => Promise<T>) => Promise<T>;
+export interface CommentAuthority {
+    anchorBase(): Promise<AnchorBase>;
+    list(): Promise<AnchoredComment[]>;
+    /** Resolves to the new comment's id, which forking it needs. */
+    create(p: {
+        line: number;
+        endLine: number;
+        text: string;
+        docHash: string;
+    }): Promise<string>;
+    edit(p: {
+        id: string;
+        text: string;
+        ifRevision: number;
+    }): Promise<void>;
+    resolve(id: string): Promise<void>;
+    reopen(id: string): Promise<void>;
+    remove(id: string): Promise<void>;
+    remapRanges(p: {
+        fromDocHash: string;
+        toDocHash: string;
+        entries: Array<{
+            id: string;
+            anchor: {
+                line: number;
+                endLine: number;
+            };
+        } | {
+            id: string;
+            detached: true;
+        }>;
+    }): Promise<void>;
+    /** Hand one comment to its own fork of the review companion; resolves to the
+     *  newborn fork and the cwd a viewer for it runs in. */
+    fork(commentId: string): Promise<{
+        nodeId: string;
+        cwd: string;
+    }>;
+    onChanged(fn: () => void): () => void;
+}
+/** The terminal's complete daemon seam for one review's comment projection. */
+export declare function createCommentAuthority(reviewId: string, request: ReviewRequest): CommentAuthority;

package/dist/clients/inbox/review/comments-client.js

@@ -0,0 +1 @@
+var c=Object.defineProperty;var i=(t,n)=>c(t,"name",{value:n,configurable:!0});import{ApiError as s}from"../../../api/errors.js";import{cliClient as o}from"../../../commands/api-client.js";import{watchReviewActivity as d}from"../../../core/review/signal.js";class l extends Error{static{i(this,"ReviewDocumentError")}code;details;constructor(n,e,a){super(e),this.name="ReviewDocumentError",this.code=n,this.details=a}}function v(t,n){return{async anchorBase(){const e=await n(()=>o().getReviewDocumentBase(t));return{file:e.file,text:e.anchor_base_text,docHash:e.anchor_base_sha256}},async list(){return(await n(()=>o().listReviewComments(t,{status:"all"}))).comments.map(h)},async create(e){return(await r(()=>n(()=>o().createReviewComment(t,{text:e.text,anchor:{line:e.line,end_line:e.endLine},doc_hash:e.docHash,actor_node_id:null})))).comment.comment_id},async edit(e){await r(()=>n(()=>o().editReviewComment(e.id,{text:e.text,if_revision:e.ifRevision,actor_node_id:null})))},async resolve(e){await r(()=>n(()=>o().resolveReviewComment(e,{actor_node_id:null})))},async reopen(e){await r(()=>n(()=>o().reopenReviewComment(e,{actor_node_id:null})))},async remove(e){await r(()=>n(()=>o().deleteReviewComment(e,{actor_node_id:null})))},async remapRanges(e){await r(()=>n(()=>o().updateReviewCommentRanges(t,{from_doc_hash:e.fromDocHash,to_doc_hash:e.toDocHash,entries:e.entries.map(a=>"detached"in a?{comment_id:a.id,detached:!0}:{comment_id:a.id,anchor:{line:a.anchor.line,end_line:a.anchor.endLine}})})))},async fork(e){const a=await n(()=>o().forkReviewComment(e));return{nodeId:a.node_id,cwd:a.cwd}},onChanged(e){return d(e)}}}i(v,"createCommentAuthority");function h(t){const n={line:t.anchor.line,endLine:t.anchor.end_line};return{id:t.comment_id,revision:t.revision,...n,lineText:t.anchor_line_text,comment:t.text,status:t.status,authorKind:t.author.kind,createdAt:t.created_at,anchorStatus:t.anchor_state==="detached"?"detached":"live",...t.anchor_state==="detached"?{originalRange:n}:{}}}i(h,"projectComment");async function r(t){try{return await t()}catch(n){throw n instanceof s&&_(n.code)?new l(n.code,n.message,n.details):n}}i(r,"translateDocumentError");function _(t){return t==="stale_document"||t==="stale_comment"||t==="range_batch_incomplete"||t==="range_batch_stale"}i(_,"isDocumentErrorCode");export{l as ReviewDocumentError,v as createCommentAuthority};

package/dist/clients/inbox/review/companion-pane.d.ts

@@ -0,0 +1,47 @@
+export declare const SPLIT_MIN_COLS = 99;
+export declare const MIN_COMPANION_COLS = 40;
+export declare const MIN_COMPANION_ROWS = 12;
+export declare const COMPANION_WIDTH_RATIO = 0.42;
+export declare const COMPANION_HEIGHT_RATIO = 0.4;
+/** A fork column narrower than this cannot hold a readable conversation, so the
+ *  split is refused rather than shipping an unusable pane. */
+export declare const MIN_FORK_COLS = 52;
+export type CompanionPaneOrigin = 'opened' | 'adopted';
+export type CompanionPaneResult = {
+    ok: true;
+    paneId: string;
+    origin: CompanionPaneOrigin;
+} | {
+    ok: false;
+    reason: 'no_tmux' | 'no_caller_pane' | 'split_refused';
+};
+/** Open or adopt a companion pane for a review. Adoption succeeds only when
+ *  an existing validated-live companion viewer pane exists; otherwise, a
+ *  fresh pane is split beside the caller. */
+export declare function openCompanionPane(args: {
+    companionNodeId: string;
+    cwd: string;
+    callerPane: string | undefined;
+}): CompanionPaneResult;
+/** Open a column for a comment's fork, splitting the rightmost review pane —
+ *  the newest fork, else the companion — so columns accumulate to the right and
+ *  the document keeps its width. */
+export declare function openForkPane(args: {
+    nodeId: string;
+    cwd: string;
+    splitFrom: string | undefined;
+}): {
+    ok: true;
+    paneId: string;
+} | {
+    ok: false;
+    reason: 'no_tmux' | 'no_caller_pane' | 'split_refused' | 'no_room';
+};
+/** True while tmux can still describe `paneId` and its process is alive.
+ *  Deliberately tag-free: a companion pane carries `@crtr_node` only once its
+ *  viewer has connected, so a tag check would call a still-booting pane dead
+ *  and let a duplicate be split beside it. */
+export declare function companionPaneLive(paneId: string): boolean;
+/** Kill the pane only when it still exists AND still carries
+ *  `@crtr_node === companionNodeId`. */
+export declare function closeCompanionPane(paneId: string, companionNodeId: string): void;