@north-light/cli 0.0.0 → 0.3.413

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

@@ -0,0 +1,5 @@
+/** Run $EDITOR against a temporary buffer. Terminal ownership stays with the host. */
+export declare function editBufferInEditor(buffer: string): {
+    text: string;
+    error?: string;
+};

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

@@ -0,0 +1,3 @@
+var l=Object.defineProperty;var s=(r,e)=>l(r,"name",{value:e,configurable:!0});import{readFileSync as a,unlinkSync as c,writeFileSync as d}from"node:fs";import{spawnSync as m}from"node:child_process";import{randomUUID as u}from"node:crypto";import{tmpdir as $}from"node:os";import{join as p}from"node:path";import{announceFallbackEditor as E,NO_EDITOR_MESSAGE as h,resolveEditor as x}from"../../../core/editor-resolver.js";function R(r){const e=p($(),`crtr-input-${u()}.txt`),o=x();if(o===null)return{text:r,error:h};const i=o.command;try{d(e,r),E(o);const t=m("/bin/sh",["-c",`${i} "$1"`,"sh",e],{stdio:"inherit"});if(t.error)return{text:r,error:`$EDITOR ("${i}") failed to launch: ${t.error.message}`};if(t.signal!==null)return{text:r,error:`$EDITOR ("${i}") was killed by signal ${t.signal}`};if(t.status===127||t.status===126)return{text:r,error:`$EDITOR ("${i}") failed to launch (shell exit ${t.status})`};if(t.status!==0)return{text:r,error:`$EDITOR ("${i}") exited with status ${t.status}`};let n=a(e,"utf8");return n.endsWith(`
+`)&&!r.endsWith(`
+`)&&(n=n.slice(0,-1)),{text:n}}catch(t){return{text:r,error:`$EDITOR round-trip failed: ${t instanceof Error?t.message:String(t)}`}}finally{try{c(e)}catch{}}}s(R,"editBufferInEditor");export{R as editBufferInEditor};

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

@@ -0,0 +1,153 @@
+import type { AnchoredComment } from './comments-client.js';
+import type { RenderedDoc } from '../../../core/termrender/termrender.js';
+import { type AnchorDoc, type AnchorUnit } from './anchors.js';
+export interface ComposeState {
+    buffer: string;
+    cursor: number;
+    /** Id of the comment being edited, or null when composing a new comment. */
+    editingId: string | null;
+    /** Submode to return to once compose closes (Escape or a successful save). */
+    returnMode: 'view' | 'list';
+    anchor: {
+        line: number;
+        endLine: number;
+    };
+}
+export interface ReviewState {
+    sourceLines: string[];
+    /** Ordered leaf anchor units. Never empty. */
+    units: AnchorUnit[];
+    /** Per rendered row: owning unit index, or null for separator rows. */
+    rowUnits: (number | null)[];
+    /** Current comment projection supplied by the daemon. */
+    comments: AnchoredComment[];
+    /** Revision of the live source snapshot the rendered units came from. */
+    sourceRevision: number;
+    /** Original ranges for comments whose current source range no longer survives. */
+    detached: Record<string, {
+        line: number;
+        endLine: number;
+    }>;
+    /** 0-based index of the anchored unit. */
+    activeUnit: number;
+    /** Set while a Shift+j/k range is being extended from this unit. */
+    selectionAnchor: number | null;
+    /** Scroll offset into the rendered (termrender) lines. */
+    scroll: number;
+    /** Horizontal pan offset, in display cells, for rows wider than the body
+     *  rectangle (diagrams). Rows that fit never move. */
+    hscroll: number;
+    mode: 'view' | 'list' | 'compose' | 'help';
+    compose: ComposeState | null;
+    listIndex: number;
+}
+/** 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 initReviewState(sourceLines: string[], anchor: AnchorDoc, comments: AnchoredComment[], sourceRevision: number): ReviewState;
+export declare function selectedUnitBounds(state: ReviewState): {
+    lo: number;
+    hi: number;
+};
+/** Source-line anchor of the current unit selection — what a committed
+ *  comment records as `line`/`endLine`. Whole-block chrome units can carry a
+ *  wider range than their neighbors, so take the min/max over the selection
+ *  rather than trusting the endpoints alone. */
+export declare function currentAnchor(state: ReviewState): {
+    line: number;
+    endLine: number;
+};
+export declare function moveActiveUnit(state: ReviewState, delta: number, extend: boolean): ReviewState;
+/** Unit indices overlapped by any existing comment's source range. A projected
+ *  range lying wholly past the last unit (the file shrank before its range was
+ *  remapped) still gets a marker on its clamped unit, so every comment is
+ *  visible somewhere in the document. */
+export declare function commentedUnitSet(state: ReviewState): Set<number>;
+/** First/last rendered-row indices spanned by units `lo..hi`, or null when
+ *  the indices fall outside the unit list. */
+export declare function anchorRowRange(units: AnchorUnit[], lo: number, hi: number): {
+    first: number;
+    last: number;
+} | null;
+/** Minimal scroll adjustment that keeps rows `first..last` visible with
+ *  `margin` rows of context (the margin yields whenever honoring it would push
+ *  either edge of the span out of view); a taller-than-view span pins `first`
+ *  at the top — one row down when scrolled, so the `↑ more above` indicator
+ *  overwrites the preceding row, never the pinned one. Always returns a scroll
+ *  clamped to the document. */
+export declare function scrollToReveal(scroll: number, first: number, last: number, bodyHeight: number, total: number, margin?: number): number;
+/** Auto-scroll so the active unit (the moving edge of a selection) is
+ *  visible. The wheel free-scrolls and is untouched until the next anchor move. */
+export declare function ensureAnchorVisible(state: ReviewState, doc: RenderedDoc, bodyHeight: number): ReviewState;
+export declare function scrollBy(state: ReviewState, delta: number, bodyHeight: number, totalLines: number): ReviewState;
+/** Rows one `u`/`d` press travels: half the visible body, and never fewer than
+ *  one row, so a diagram taller than the pane cannot hold the document still. */
+export declare function halfPageRows(bodyHeight: number): number;
+/** Move the view by `rows` and carry the anchored unit the same distance, so
+ *  the selection keeps its place on screen rather than being left behind. The
+ *  selection lands on the unit owning the row it would occupy after the move,
+ *  clamped into the rows the frame actually paints; at the end of the document,
+ *  where the view can no longer move, the selection walks the rest on its own. */
+export declare function moveViewRows(state: ReviewState, rows: number, bodyHeight: number, totalRows: number): ReviewState;
+export declare function openComposeNew(state: ReviewState): ReviewState;
+export declare function openComposeEdit(state: ReviewState, index: number): ReviewState;
+export declare function closeCompose(state: ReviewState): ReviewState;
+export interface ComposeCommit {
+    editingId: string | null;
+    anchor: {
+        line: number;
+        endLine: number;
+    };
+    text: string;
+}
+/** Closes compose and returns the daemon mutation payload. The daemon projection, not this reducer, repaints comments. */
+export declare function commitCompose(state: ReviewState): {
+    state: ReviewState;
+    commit: ComposeCommit | null;
+};
+export declare function openList(state: ReviewState): ReviewState;
+export declare function closeList(state: ReviewState): ReviewState;
+export declare function moveListIndex(state: ReviewState, delta: number): ReviewState;
+export declare function deleteAtListIndex(state: ReviewState): {
+    state: ReviewState;
+    id: string | null;
+};
+export declare function undoLast(state: ReviewState): {
+    state: ReviewState;
+    id: string | null;
+};
+export declare function openHelp(state: ReviewState): ReviewState;
+export declare function closeHelp(state: ReviewState): ReviewState;
+export declare function cleanPastedText(input: string): string;
+export declare function textInsert(buffer: string, cursor: number, text: string): {
+    buffer: string;
+    cursor: number;
+};
+export declare function textBackspace(buffer: string, cursor: number): {
+    buffer: string;
+    cursor: number;
+};
+export declare function textDelete(buffer: string, cursor: number): {
+    buffer: string;
+    cursor: number;
+};
+export declare function textHome(buffer: string, cursor: number): number;
+export declare function textEnd(buffer: string, cursor: number): number;
+export declare function textVertical(buffer: string, cursor: number, delta: number): number;
+/** Vertical motion by *visual* row (what up/down mean in a wrapped compose box):
+ *  a long soft-wrapped comment has many rows even though it is one logical
+ *  line. Shares `verticalCursor` with the frame renderer's own wrap. */
+export declare function textVerticalWrapped(buffer: string, cursor: number, delta: number, width: number): number;
+/** Start of the word before the cursor (readline alt-b / alt+left). Shares one
+ *  word-motion implementation with the page compose box. */
+export declare function textWordLeft(buffer: string, cursor: number): number;
+/** Just past the end of the word after the cursor (readline alt-f / alt+right). */
+export declare function textWordRight(buffer: string, cursor: number): number;
+/** Delete back to the start of the previous word (alt+backspace / ctrl+w). */
+export declare function textWordBackspace(buffer: string, cursor: number): {
+    buffer: string;
+    cursor: number;
+};

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

@@ -0,0 +1,4 @@
+var M=Object.defineProperty;var r=(n,t)=>M(n,"name",{value:t,configurable:!0});import{verticalCursor as v,wordLeftIndex as g,wordRightIndex as w}from"../tui/render.js";import{unitIndexForLine as h,unitRangeForSpan as U}from"./anchors.js";function j(n,t,e,o){const i=t.units.length>0?t:{units:[{start:1,end:Math.max(1,n.length),firstRow:0,lastRow:0}],rowUnits:t.rowUnits};return{sourceLines:n,units:i.units,rowUnits:i.rowUnits,comments:[...e],sourceRevision:o,detached:Object.fromEntries(e.flatMap(c=>c.anchorStatus==="detached"?[[c.id,c.originalRange??{line:c.line,endLine:c.endLine}]]:[])),activeUnit:e.length>0?h(i.units,e[0].line):0,selectionAnchor:null,scroll:0,hscroll:0,mode:"view",compose:null,listIndex:0}}r(j,"initReviewState");function I(n){const t=n.selectionAnchor??n.activeUnit;return{lo:Math.min(n.activeUnit,t),hi:Math.max(n.activeUnit,t)}}r(I,"selectedUnitBounds");function L(n){const{lo:t,hi:e}=I(n);let o=Number.POSITIVE_INFINITY,i=0;for(let c=t;c<=e;c++){const l=n.units[c];l!==void 0&&(o=Math.min(o,l.start),i=Math.max(i,l.end))}return Number.isFinite(o)?{line:o,endLine:Math.max(o,i)}:{line:1,endLine:Math.max(1,n.sourceLines.length)}}r(L,"currentAnchor");function C(n,t,e){const o=Math.max(0,n.units.length-1),i=Math.max(0,Math.min(o,n.activeUnit+t));return e?{...n,activeUnit:i,selectionAnchor:n.selectionAnchor??n.activeUnit}:{...n,activeUnit:i,selectionAnchor:null}}r(C,"moveActiveUnit");function V(n){const t=new Set;for(const e of n.comments){if(e.status==="deleted"||e.anchorStatus==="detached")continue;let o=!1;n.units.forEach((i,c)=>{i.start<=e.endLine&&i.end>=e.line&&(t.add(c),o=!0)}),o||t.add(h(n.units,e.line))}return t}r(V,"commentedUnitSet");function R(n,t,e){const o=n[t],i=n[e];return o===void 0||i===void 0?null:{first:o.firstRow,last:i.lastRow}}r(R,"anchorRowRange");function A(n,t,e,o,i,c=2){const l=Math.max(0,i-o);let u=Math.max(0,Math.min(n,l));return e-t+1>=o?Math.max(0,Math.min(Math.max(0,t-1),l)):(t-c<u?u=Math.max(t-c,e-(o-1)):e+c>u+o-1&&(u=Math.min(e+c-(o-1),t)),Math.max(0,Math.min(u,l)))}r(A,"scrollToReveal");function b(n,t,e){const o=R(n.units,n.activeUnit,n.activeUnit);if(o===null)return n;const i=A(n.scroll,o.first,o.last,e,t.lines.length);return i===n.scroll?n:{...n,scroll:i}}r(b,"ensureAnchorVisible");function P(n,t,e,o){const i=Math.max(0,o-e);return{...n,scroll:Math.max(0,Math.min(n.scroll+t,i))}}r(P,"scrollBy");function T(n){return Math.max(1,Math.floor(n/2))}r(T,"halfPageRows");function W(n,t,e,o){if(t===0)return n;const i=t>0?1:-1,c=Math.max(0,o-e),l=Math.max(0,Math.min(n.scroll+t,c)),u=l+(l>0?1:0),a=Math.max(u,l+e-1-(l+e<o?1:0)),m=n.units[n.activeUnit]?.firstRow??n.scroll,d=Math.max(u,Math.min(m+t,a)),f=S(n,d,u,a,i)??n.activeUnit;return l===n.scroll&&f===n.activeUnit?n:{...n,scroll:l,activeUnit:f,selectionAnchor:null}}r(W,"moveViewRows");function S(n,t,e,o,i){const c=Math.max(0,n.units.length-1);for(let l=0;l<=o-e;l++)for(const u of[t+l*i,t-l*i]){if(u<e||u>o)continue;const a=n.rowUnits[u];if(a!=null)return Math.max(0,Math.min(c,a))}return null}r(S,"unitNearRow");function k(n){return{...n,mode:"compose",compose:{buffer:"",cursor:0,editingId:null,returnMode:"view",anchor:L(n)}}}r(k,"openComposeNew");function O(n,t){const e=n.comments[t];if(e===void 0)return n;const o=e.comment,{lo:i,hi:c}=U(n.units,e.line,e.endLine);return{...n,activeUnit:c,selectionAnchor:i===c?null:i,mode:"compose",compose:{buffer:o,cursor:[...o].length,editingId:e.id,returnMode:"list",anchor:{line:e.line,endLine:e.endLine}}}}r(O,"openComposeEdit");function p(n){const t=n.compose?.returnMode??"view";return{...n,mode:t,compose:null}}r(p,"closeCompose");function z(n){const t=n.compose;if(t==null)return{state:n,commit:null};const e=t.buffer.trim();return e.length===0?{state:p(n),commit:null}:{state:p(n),commit:{editingId:t.editingId,anchor:t.anchor,text:e}}}r(z,"commitCompose");function D(n){return{...n,mode:"list",listIndex:Math.max(0,Math.min(n.listIndex,n.comments.length-1))}}r(D,"openList");function Y(n){return{...n,mode:"view"}}r(Y,"closeList");function Z(n,t){if(n.comments.length===0)return n;const e=Math.max(0,Math.min(n.comments.length-1,n.listIndex+t));return{...n,listIndex:e}}r(Z,"moveListIndex");function _(n){const t=n.comments[n.listIndex];return{state:n,id:t?.id??null}}r(_,"deleteAtListIndex");function q(n){return{state:n,id:n.comments.at(-1)?.id??null}}r(q,"undoLast");function G(n){return{...n,mode:"help"}}r(G,"openHelp");function J(n){return{...n,mode:"view"}}r(J,"closeHelp");function s(n){return[...n]}r(s,"codePoints");function K(n){return n.replace(/\x1b\[20[01]~/g,"").replace(/\x1b\[[0-9;?]*[a-zA-Z]/g,"").replace(/\r\n?/g,`
+`).replace(/[\x00-\x09\x0B-\x1F\x7F]/g,"")}r(K,"cleanPastedText");function Q(n,t,e){const o=s(n),i=Math.max(0,Math.min(t,o.length));return{buffer:[...o.slice(0,i),...s(e),...o.slice(i)].join(""),cursor:i+s(e).length}}r(Q,"textInsert");function X(n,t){if(t<=0)return{buffer:n,cursor:t};const e=s(n);return{buffer:[...e.slice(0,t-1),...e.slice(t)].join(""),cursor:t-1}}r(X,"textBackspace");function $(n,t){const e=s(n);return t>=e.length?{buffer:n,cursor:t}:{buffer:[...e.slice(0,t),...e.slice(t+1)].join(""),cursor:t}}r($,"textDelete");function x(n,t){let e=t;for(;e>0&&n[e-1]!==`
+`;)e--;let o=t;for(;o<n.length&&n[o]!==`
+`;)o++;return{start:e,end:o}}r(x,"lineBoundsAt");function H(n,t){return x(s(n),t).start}r(H,"textHome");function y(n,t){return x(s(n),t).end}r(y,"textEnd");function nn(n,t,e){const o=s(n),{start:i,end:c}=x(o,t),l=t-i;if(e<0){if(i===0)return t;const m=i-1,d=x(o,m).start;return Math.min(m,d+l)}if(c>=o.length)return t;const u=c+1,a=x(o,u).end;return Math.min(a,u+l)}r(nn,"textVertical");function tn(n,t,e,o){return v(n,t,e,o)}r(tn,"textVerticalWrapped");function E(n,t){return g(n,t)}r(E,"textWordLeft");function en(n,t){return w(n,t)}r(en,"textWordRight");function on(n,t){const e=s(n),o=Math.max(0,Math.min(t,e.length)),i=E(n,o);return i===o?{buffer:n,cursor:o}:{buffer:[...e.slice(0,i),...e.slice(o)].join(""),cursor:i}}r(on,"textWordBackspace");export{R as anchorRowRange,K as cleanPastedText,p as closeCompose,J as closeHelp,Y as closeList,V as commentedUnitSet,z as commitCompose,L as currentAnchor,_ as deleteAtListIndex,b as ensureAnchorVisible,T as halfPageRows,j as initReviewState,C as moveActiveUnit,Z as moveListIndex,W as moveViewRows,O as openComposeEdit,k as openComposeNew,G as openHelp,D as openList,P as scrollBy,A as scrollToReveal,I as selectedUnitBounds,X as textBackspace,$ as textDelete,y as textEnd,H as textHome,Q as textInsert,nn as textVertical,tn as textVerticalWrapped,on as textWordBackspace,E as textWordLeft,en as textWordRight,q as undoLast};

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

@@ -0,0 +1,17 @@
+import type { SurfaceHost } from '../surfaces/host.js';
+export interface ReviewAdapterOptions {
+    host: SurfaceHost;
+    /** The review request's own id — the same id its inbox row carries. */
+    reviewId: string;
+}
+/** Resolve a durable review ticket and open it in its own tmux window. */
+export declare class ReviewAdapter {
+    private readonly opts;
+    private running;
+    private stopped;
+    constructor(opts: ReviewAdapterOptions);
+    /** Resolves true once the review window has opened and been selected. */
+    start(): Promise<boolean>;
+    stop(): Promise<void>;
+    private run;
+}

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

@@ -0,0 +1 @@
+var s=Object.defineProperty;var n=(t,i)=>s(t,"name",{value:i,configurable:!0});import{openReviewWindow as r}from"./review/launch.js";import{createReviewClient as o,ReviewTerminalError as a,terminalRefusalNotice as u}from"./review/review-client.js";class f{static{n(this,"ReviewAdapter")}opts;running=null;stopped=!1;constructor(i){this.opts=i}start(){return this.running!==null?this.running:(this.running=this.run(),this.running)}async stop(){this.stopped=!0,this.running!==null&&await this.running}async run(){if(this.opts.host.capabilities.remote)return this.opts.host.notice("The review is unavailable in a remote attach \u2014 the file and companion live on the host."),!1;let i;try{i=await o().byId(this.opts.reviewId)}catch(e){return this.opts.host.notice(h(e)),!1}return!this.stopped&&r(this.opts.host,i)}}function h(t){return t instanceof a?u(t):t instanceof Error?t.message:String(t)}n(h,"noticeForLookupFailure");export{f as ReviewAdapter};

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

@@ -0,0 +1,25 @@
+import type { SurfaceHost } from '../surfaces/host.js';
+import type { InboxRow } from './dto-adapt.js';
+/** The attached node's profile identity, when it has one. The surface never
+ *  selects a profile itself — it is handed the one the viewer is attached to. */
+export interface InboxSurfaceProfile {
+    id: string;
+    /** Display name, or the id when the manifest name could not be resolved. */
+    label: string;
+}
+export interface InboxSurfaceOptions {
+    host: SurfaceHost;
+    profile?: InboxSurfaceProfile;
+    /** Injection seams for tests; production passes none. */
+    scan?: () => Promise<InboxRow[]>;
+}
+export interface InboxSurfaceOwner {
+    /** Mount when closed and close when open. */
+    toggle(): void;
+    /** Mount if closed; seat the selection on `preselectDir` when given. */
+    open(preselectDir?: string): void;
+    /** Idempotent surface and controller teardown. */
+    close(): void;
+    isOpen(): boolean;
+}
+export declare function createInboxSurface(opts: InboxSurfaceOptions): InboxSurfaceOwner;

package/dist/clients/inbox/surface.js

@@ -0,0 +1 @@
+var p=Object.defineProperty;var t=(o,n)=>p(o,"name",{value:n,configurable:!0});import{InboxController as w}from"./controller.js";import{byNewestFirst as g,inboxRowFromDTO as x}from"./dto-adapt.js";import{cliClient as m}from"../../commands/api-client.js";import{decodeInboxKey as y}from"./tui/keys.js";import{clipLine as v,visibleWidth as C}from"./tui/ansi.js";class I{static{t(this,"InboxComponent")}controller;focused=!1;rows=0;width=-1;height=-1;handle;constructor(n){this.controller=n}setRows(n){this.rows=n}render(n){const i=this.rows;return(n!==this.width||i!==this.height)&&(this.width=n,this.height=i,this.controller.resize(n,i)),S(this.controller.render(),n,i)}handleInput(n){const{input:i,key:s}=y(n);this.controller.handleKey(i,s)}invalidate(){this.handle?.invalidate()}setHandle(n){this.handle=n}}function S(o,n,i){const s=o.slice(0,i);for(;s.length<i;)s.push("");return s.map(c=>{const a=v(c,n);return a+" ".repeat(Math.max(0,n-C(a)))})}t(S,"padFrame");async function G(o){if(o.scan!==void 0)return o.scan();const{tickets:n}=await m().listHumanInbox();return n.map(x).sort(g)}t(G,"probeRows");async function u(o,n){try{return await n()}catch(i){throw new Error(`Could not load ${o}: ${i instanceof Error?i.message:String(i)}`)}}t(u,"named");function D(o){let n;const i=t(()=>{const e=n;e===void 0||e.closed||(e.closed=!0,n=void 0,e.controller?.close(),e.handle?.close(),e.controller=void 0,e.handle=void 0)},"close"),s=t(e=>{if(e.closed||n!==e)return;const l=new w({host:o.host,onDirty:t(()=>e.handle?.invalidate(),"onDirty"),onClosed:i,...o.scan===void 0?{}:{scan:o.scan},onInboxActivity:t(()=>a(e),"onInboxActivity"),...e.preselectDir===void 0?{}:{initialSelection:e.preselectDir},...o.profile===void 0?{}:{profile:{id:o.profile.id,label:o.profile.label,members:t(()=>e.profileMembers,"members")}}}),d=new I(l);e.controller=l;try{const r=o.host.mount(d);e.handle=r,d.setHandle(r),r.onClose(()=>{e.handle===r&&(e.handle=void 0),l.close()}),l.start()}catch(r){throw i(),r}},"mount"),c=t(async e=>{const l=o.profile,d=e?u("inbox visibility",()=>G(o)):void 0,r=l===void 0?void 0:u("profile membership",()=>m().listNodes({profile_id:l.id})),[,f]=await Promise.all([d,r]);return f===void 0?void 0:new Set(f.map(b=>b.node_id))},"load"),a=t((e,l=!1)=>{if(!l&&e.controller!==void 0&&o.profile===void 0){e.controller.invalidate();return}const d=++e.refreshGeneration;c(e.controller===void 0).then(r=>{e.closed||n!==e||d!==e.refreshGeneration||(r!==void 0&&(e.profileMembers=r),e.controller===void 0?s(e):e.controller.refreshOutcome())},r=>{if(e.closed||n!==e||d!==e.refreshGeneration)return;const f=r instanceof Error?r.message:String(r);if(l){i(),o.host.notice(f);return}e.controller?.refreshOutcome(f)})},"refresh"),h=t(e=>{if(n!==void 0){e!==void 0&&n.controller?.selectDir(e);return}if(o.host.capabilities.remote){o.host.notice("The inbox is unavailable in a remote attach.");return}const l={closed:!1,refreshGeneration:0,profileMembers:new Set,...e===void 0?{}:{preselectDir:e}};n=l,a(l,!0)},"open");return{toggle:t(()=>{if(n!==void 0){i();return}h()},"toggle"),open:h,close:i,isOpen:t(()=>n!==void 0,"isOpen")}}t(D,"createInboxSurface");export{D as createInboxSurface};

package/dist/clients/inbox/tui/ansi.d.ts

@@ -0,0 +1,68 @@
+export declare const ESC = "\u001B[";
+export declare const RESET = "\u001B[0m";
+export declare const BOLD = "\u001B[1m";
+export declare const DIM = "\u001B[2m";
+export declare const ITALIC = "\u001B[3m";
+export declare const RED = "\u001B[31m";
+export declare const GREEN = "\u001B[32m";
+export declare const YELLOW = "\u001B[33m";
+export declare const CYAN = "\u001B[36m";
+export declare const GRAY = "\u001B[90m";
+export declare const REVERSE = "\u001B[7m";
+export declare function sanitize(text: string): string;
+export declare function singleLine(text: string): string;
+export declare function hline(width: number, char?: string): string;
+export declare function padRight(text: string, width: number): string;
+/** Char-based width truncation with a trailing ellipsis. The canonical page
+ *  renderer variant. */
+export declare function truncate(text: string, maxWidth: number): string;
+/** Word-aware truncation that also flattens newlines and strips decorative
+ *  emoji — tuned for dense inbox rows (ported from sisyphus format.ts). Kept
+ *  distinct from `truncate` because those two surfaces want different behavior. */
+export declare function truncateRow(text: string, max: number): string;
+/** Word-wrap on whitespace; splits on `\n` into separate paragraphs. */
+export declare function wrap(text: string, maxWidth: number): string[];
+/** Hard character wrap that ignores word boundaries; splits on `\n`. Used for
+ *  free-form input buffers where every character (including runs without
+ *  spaces) must stay on screen. */
+export declare function hardWrap(text: string, maxWidth: number): string[];
+/**
+ * Pad each non-empty line with leading spaces to horizontally center the
+ * `contentWidth`-wide block within `cols`. Wide terminals get breathing room;
+ * narrow panes skip centering. Empty lines stay empty so frame diffing keeps
+ * them as cheap no-ops.
+ */
+export declare function centerHorizontal(lines: string[], cols: number, contentWidth: number): string[];
+/** Visible width of a line in display cells. pi-tui's helper is the one
+ *  terminal-cell contract: it accounts for graphemes and wide cells while
+ *  ignoring SGR, OSC, and APC sequences. */
+export declare function visibleWidth(line: string): number;
+/**
+ * The one display-cell containment primitive: the visible cells
+ * `[start, start + width)` of `line`, with escape sequences preserved.
+ *
+ * Every line rendered into a rectangle must fit within its assigned width, so
+ * each logical line occupies one physical row. Overflow wraps into the next
+ * row and violates the frame contract. Styling seen before
+ * the window is replayed at its head so a slice keeps the colors it had in
+ * place, and a double-width glyph straddling either edge becomes spaces so
+ * the slice occupies exactly the cells it claims.
+ */
+export declare function sliceCells(line: string, start: number, width: number): string;
+/**
+ * ANSI-aware clip: truncate a line's visible width to `maxWidth`. Thin
+ * wrapper over `sliceCells` so containment has a single implementation.
+ */
+export declare function clipLine(line: string, maxWidth: number): string;
+/**
+ * Horizontal window onto a row that may be wider than its rectangle (a
+ * Mermaid diagram rendered at the pane's full width). A row that fits is
+ * returned untouched — panning only ever moves content that overflows, so
+ * prose stays put while a diagram slides. Hidden content on either side is
+ * marked with a dim ‹/› in the edge cell, so the row always states whether
+ * more of the diagram exists left or right, and the marker disappears once
+ * that edge is reached (nothing is unreachable).
+ */
+export declare function panLine(line: string, offset: number, width: number): string;
+/** Cells of `line` that fall outside a `width`-wide rectangle. */
+export declare function rowOverflow(line: string, width: number): number;

package/dist/clients/inbox/tui/ansi.js

@@ -0,0 +1,3 @@
+var R=Object.defineProperty;var u=(t,e)=>R(t,"name",{value:e,configurable:!0});import a from"string-width";import{visibleWidth as O}from"@earendil-works/pi-tui";const l="\x1B[",m=`${l}0m`,y=`${l}1m`,E=`${l}2m`,N=`${l}3m`,T=`${l}31m`,v=`${l}32m`,z=`${l}33m`,B=`${l}36m`,D=`${l}90m`,F=`${l}7m`,A=/\x1b\[[0-9;?]*[a-zA-Z]|\x1b[@-_]|[\x00-\x08\x0B\x0E-\x1F\x7F-\x9F]/g;function k(t){return typeof t!="string"?"":t.replace(A,"")}u(k,"sanitize");function G(t){return k(t).replace(/\s+/g," ").trim()}u(G,"singleLine");function H(t,e="\u2500"){return t<1?"":e.repeat(t)}u(H,"hline");function P(t,e){const n=a(t);return n>=e?t:t+" ".repeat(e-n)}u(P,"padRight");function Y(t,e){if(e<1)return"";if(a(t)<=e)return t;const n=[...t];let r=0,o="";for(const c of n){const i=a(c);if(r+i+1>e)break;o+=c,r+=i}return o+"\u2026"}u(Y,"truncate");function K(t,e){const n=t.replace(/\n/g," ").replace(/✅/g,"\u2713").replace(/❌/g,"\u2717").replace(new RegExp("\\p{Emoji_Presentation}","gu"),"");if(e<4)return n.slice(0,e);if(a(n)<=e)return n;let o=n;for(;a(o)>e-1&&o.length>0;){const c=o.lastIndexOf(" ",o.length-2);c>e*.4?o=o.slice(0,c):o=o.slice(0,o.length-1)}return o+"\u2026"}u(K,"truncateRow");function C(t,e){let n=0,r="";for(const o of t){const c=a(o);if(n+c>e)break;r+=o,n+=c}return r===""&&t.length>0&&(r=[...t][0]),r}u(C,"sliceByWidth");function V(t,e){if(e<1)return[t];const n=[],r=t.split(`
+`);for(let o=0;o<r.length;o++){const c=r[o];if(c===""){n.push("");continue}const i=c.split(/[ \t]+/).filter(Boolean);let f="";for(let s of i){for(;a(s)>e;){f&&(n.push(f),f="");const p=C(s,e);n.push(p),s=s.slice(p.length)}const g=f?`${f} ${s}`:s;a(g)<=e?f=g:(f&&n.push(f),f=s)}f&&n.push(f)}return n.length>0?n:[""]}u(V,"wrap");function Z(t,e){if(e<1)return[t];const n=t.split(`
+`),r=[];for(const o of n){if(o.length===0){r.push("");continue}let c="",i=0;for(const f of[...o]){const s=a(f);i+s>e?(r.push(c),c=f,i=s):(c+=f,i+=s)}r.push(c)}return r}u(Z,"hardWrap");function j(t,e,n){const r=Math.max(0,Math.floor((e-n)/2));if(r===0)return t;const o=" ".repeat(r);return t.map(c=>c===""?"":o+c)}u(j,"centerHorizontal");function h(t){return O(t)}u(h,"visibleWidth");const b=/\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)|\x1b_[^\x07\x1b]*(?:\x07|\x1b\\)|\x1b\[[0-9;?]*[a-zA-Z]|\x1b[@-^]/g,$=/\x1b\]8;[^;\x07\x1b]*;([^\x07\x1b]*)(\x07|\x1b\\)/g,w=new Intl.Segmenter(void 0,{granularity:"grapheme"});function I(t){const e=[];let n=0;b.lastIndex=0;for(let r=b.exec(t);r!==null;r=b.exec(t)){for(const o of w.segment(t.slice(n,r.index)))e.push({ansi:!1,text:o.segment,width:h(o.segment)});e.push({ansi:!0,text:r[0]}),n=r.index+r[0].length}for(const r of w.segment(t.slice(n)))e.push({ansi:!1,text:r.segment,width:h(r.segment)});return e}u(I,"displayTokens");function d(t,e,n){if(n<1)return"";const r=Math.max(0,e),o=r+n;let c="",i="",f=!1,s=0;for(const p of I(t)){if(p.ansi){s<r?c+=p.text:(i+=p.text,f=!0);continue}if(s>=o)break;const x=p.width;if(x===0){s>=r&&(i+=p.text);continue}if(s+x<=r){s+=x;continue}if(s<r){i+=" ".repeat(s+x-r),s+=x;continue}if(s+x>o){i+=" ".repeat(o-s),s=o;break}i+=p.text,s+=x}if(i==="")return"";c!==""&&(i=c+i,f=!0);const g=L(i);return f?i+g+m:i}u(d,"sliceCells");function L(t){let e="";$.lastIndex=0;for(let n=$.exec(t);n!==null;n=$.exec(t))e=n[1]===""?"":`\x1B]8;;${n[2]}`;return e}u(L,"closeActiveOsc8");function W(t,e){return e<1?"":h(t)<=e?t:d(t,0,e)}u(W,"clipLine");function q(t,e,n){if(n<1)return"";const r=h(t);if(r<=n)return t;const o=r-n,c=Math.max(0,Math.min(e,o)),i=c>0,f=c<o,s=n-(i?1:0)-(f?1:0),g=s>0?d(t,c+(i?1:0),s):"";return`${i?`${E}\u2039${m}`:""}${g}${f?`${E}\u203A${m}`:""}`}u(q,"panLine");function J(t,e){return Math.max(0,h(t)-e)}u(J,"rowOverflow");export{y as BOLD,B as CYAN,E as DIM,l as ESC,D as GRAY,v as GREEN,N as ITALIC,T as RED,m as RESET,F as REVERSE,z as YELLOW,j as centerHorizontal,W as clipLine,Z as hardWrap,H as hline,P as padRight,q as panLine,J as rowOverflow,k as sanitize,G as singleLine,d as sliceCells,Y as truncate,K as truncateRow,h as visibleWidth,V as wrap};

package/dist/clients/inbox/tui/input.d.ts

@@ -0,0 +1,5 @@
+import type { TuiState } from './types.js';
+import type { Key } from './keys.js';
+export type RenderFn = () => void;
+export type ExitFn = (submit?: boolean) => void;
+export declare function handleKeypress(input: string, key: Key, state: TuiState, render: RenderFn, exit: ExitFn): void;

package/dist/clients/inbox/tui/input.js

@@ -0,0 +1,5 @@
+var B=Object.defineProperty;var f=(e,n)=>B(e,"name",{value:n,configurable:!0});import{isResponseBearingSlot as x}from"../../../core/human/page-schema.js";import{panItemReview as W,verticalCursor as S,wordLeftIndex as C,wordRightIndex as K}from"./render.js";import{commentAnchors as b,commentIdFor as p,pageComplete as I,responseAnswers as L,slotActions as z,slotAnswered as R,terminalAnswerable as j}from"./slots.js";const g=f((e,n)=>n==="single"&&(e.kind==="options"||e.kind==="cards"),"autoAdvances");function ee(e,n,r,o,i){if(n.ctrl&&e==="c"){i(!1);return}if(r.hint=void 0,r.inputMode!==null){H(e,n,r,o);return}r.phase==="overview"?D(e,n,r,o,i):r.phase==="item-review"?E(e,n,r,o,i):N(e,n,r,o,i)}f(ee,"handleKeypress");function A(e,n,r){return e==="d"||n.pageDown||n.ctrl&&(e==="d"||e==="e")?(r.scrollOffset+=e==="e"?1:10,r.followSelection=!1,!0):e==="u"||n.pageUp||n.ctrl&&(e==="u"||e==="y")?(r.scrollOffset=Math.max(0,r.scrollOffset-(e==="y"?1:10)),r.followSelection=!1,!0):!1}f(A,"scrollKey");function D(e,n,r,o,i){if(A(e,n,r)){o();return}if(e==="j"||n.downArrow)r.currentIndex=Math.min(r.currentIndex+1,Math.max(0,r.slots.length-1)),r.followSelection=!0;else if(e==="k"||n.upArrow)r.currentIndex=Math.max(r.currentIndex-1,0),r.followSelection=!0;else if((n.return||e===" ")&&r.slots.length>0)r.phase="item-review",M(r);else if(e==="q"||n.escape){i(!r.manifest.slots.some(x));return}else return;o()}f(D,"handleOverview");function E(e,n,r,o,i){const c=r.slots[r.currentIndex];if(c===void 0){r.phase="overview",o();return}const s=z(c);if(e==="n"){v(r,1),o();return}if(e==="p"){v(r,-1),o();return}if(e==="q"||n.escape){i(!1);return}if(A(e,n,r)){o();return}if((e==="h"||e==="l"||n.leftArrow||n.rightArrow)&&r.hscrollMax>0&&!s.some(l=>l.kind==="select"&&l.shortcut===e)){W(r,e==="h"||n.leftArrow?-1:1),o();return}if(e==="j"||n.downArrow){r.selectedAction=Math.min(r.selectedAction+1,Math.max(0,s.length-1)),o();return}if(e==="k"||n.upArrow){r.selectedAction=Math.max(0,r.selectedAction-1),o();return}if(e==="c"&&b(c).length>0){Z(r,c,s),o();return}const u=s.find(l=>l.kind==="select"&&l.shortcut===e);if(u?.kind==="select"){F(r,c,u,g(c,u.mode)),o(),g(c,u.mode)&&r.phase==="final"&&I(r)&&i(!0);return}if(e===" "&&s[r.selectedAction]?.kind==="select"){const l=s[r.selectedAction];F(r,c,l,g(c,l.mode)),o(),g(c,l.mode)&&r.phase==="final"&&I(r)&&i(!0);return}if(e==="r"&&s.some(l=>l.kind==="freetext")){const l=m(c,r.responses.get(c.id));r.inputMode={kind:"freetext",buffer:l.freetext??"",cursor:[...l.freetext??""].length},o();return}if(e==="e"&&s.some(l=>l.kind==="edit")){const l=m(c,r.responses.get(c.id));r.inputMode={kind:"text",buffer:l.text,cursor:[...l.text].length},o();return}if(e==="a"&&s.some(l=>l.kind==="accept")){d(r,c,{text:c.config.initialText,edited:!1}),h(r),o();return}if(n.return){const l=s[r.selectedAction];if(l?.kind==="freetext"){const t=m(c,r.responses.get(c.id));r.inputMode={kind:"freetext",buffer:t.freetext??"",cursor:[...t.freetext??""].length},o();return}if(l?.kind==="edit"){const t=m(c,r.responses.get(c.id));r.inputMode={kind:"text",buffer:t.text,cursor:[...t.text].length},o();return}if(l?.kind==="accept"){d(r,c,{text:c.config.initialText,edited:!1}),h(r),o();return}if(R(r,c)){h(r),o();return}if(j(c)){const t=m(c,r.responses.get(c.id));if(L(r,c,t)){d(r,c,t),h(r),o();return}}if(x(c)){r.hint=j(c)?"Select at least one option (space to toggle), or q to go back":"This must be answered in crouter cloud",o();return}v(r,1),o()}}f(E,"handleItemReview");function N(e,n,r,o,i){if(e==="q"||n.escape){r.phase=r.slots.length===1?"item-review":"overview",r.scrollOffset=0,o();return}if(A(e,n,r)){o();return}n.return&&(I(r)||!r.manifest.slots.some(x))&&i(!0)}f(N,"handleFinal");function M(e){e.selectedAction=0,e.scrollOffset=0,e.followSelection=!0,e.hscrollOffset=0,e.hscrollMax=0}f(M,"resetItem");function v(e,n){const r=e.currentIndex+n;if(r<0){e.phase=e.slots.length>1?"overview":"item-review",e.scrollOffset=0,e.followSelection=!0;return}if(r>=e.slots.length){e.phase="final",e.scrollOffset=0,e.followSelection=!0;return}e.currentIndex=r,M(e)}f(v,"advanceItem");function h(e){for(let n=e.currentIndex+1;n<e.slots.length;n++){const r=e.slots[n];if(x(r)&&!R(e,r)){e.currentIndex=n,M(e);return}}e.phase="final",e.scrollOffset=0}f(h,"advanceToNextIncomplete");function m(e,n){return n!==void 0?n:e.kind==="options"?{selectedOptionIds:[],comments:[]}:e.kind==="cards"?{selectedCardIds:[]}:e.kind==="table"?{selectedRowIds:[],selectedColumnIds:[],comments:[]}:e.kind==="text"?{text:e.config.initialText,edited:!1}:{}}f(m,"responseFor");function O(e){return[...e?.comments??[]]}f(O,"commentsFor");function d(e,n,r){n.id!==void 0&&(e.responses.set(n.id,r),e.persist?.())}f(d,"setResponse");function F(e,n,r,o){const i=m(n,e.responses.get(n.id));if(n.kind==="options"){const c=i,s=w(c.selectedOptionIds,r.id,r.mode);d(e,n,{...c,selectedOptionIds:s})}else if(n.kind==="cards"){const c=i;d(e,n,{...c,selectedCardIds:w(c.selectedCardIds,r.id,r.mode)})}else if(n.kind==="table"){const c=i;r.group==="row"?d(e,n,{...c,selectedRowIds:w(c.selectedRowIds,r.id,r.mode)}):d(e,n,{...c,selectedColumnIds:w(c.selectedColumnIds,r.id,r.mode)})}o&&h(e)}f(F,"commitSelection");function w(e,n,r){return r==="single"?[n]:e.includes(n)?e.filter(o=>o!==n):[...e,n]}f(w,"toggleIds");function U(e){if(e?.kind==="select"){if(e.group==="option")return{kind:"option",optionId:e.id};if(e.group==="row")return{kind:"row",rowId:e.id}}}f(U,"anchorFor");function Z(e,n,r){const o=U(r[e.selectedAction])??b(n)[0],c=O(n.id===void 0?void 0:e.responses.get(n.id)).find(s=>s.id===p(o))?.text??"";e.inputMode={kind:"comment",buffer:c,cursor:[...c].length,anchor:o}}f(Z,"startComment");function G(e){if(e.inputMode?.kind!=="comment")return;const n=e.slots[e.currentIndex],r=b(n);if(r.length===0)return;const o=p(e.inputMode.anchor),i=r.findIndex(u=>p(u)===o),c=r[(i+1)%r.length],s=O(n.id===void 0?void 0:e.responses.get(n.id)).find(u=>u.id===p(c))?.text??"";e.inputMode={kind:"comment",anchor:c,buffer:s,cursor:[...s].length}}f(G,"cycleCommentAnchor");function H(e,n,r,o){const i=r.inputMode;if(n.escape){r.inputMode=null,o();return}if(n.tab&&i.kind==="comment"){G(r),o();return}if(n.return){J(r),o();return}if(n.newline){T(i,`
+`),o();return}n.wordLeft?i.cursor=C(i.buffer,i.cursor):n.wordRight?i.cursor=K(i.buffer,i.cursor):n.leftArrow?i.cursor=Math.max(0,i.cursor-1):n.rightArrow?i.cursor=Math.min([...i.buffer].length,i.cursor+1):n.upArrow?i.cursor=S(i.buffer,i.cursor,-1,q(r)):n.downArrow?i.cursor=S(i.buffer,i.cursor,1,q(r)):n.home||n.ctrl&&e==="a"?i.cursor=Y(i.buffer,i.cursor):n.end||n.ctrl&&e==="e"?i.cursor=_(i.buffer,i.cursor):n.meta&&n.backspace?Q(i):n.backspace||e==="\x7F"?P(i):n.del||n.ctrl&&e==="d"?X(i):!n.ctrl&&!n.meta&&V(i,e),o()}f(H,"handleInputMode");function J(e){const n=e.inputMode,r=e.slots[e.currentIndex],o=m(r,r.id===void 0?void 0:e.responses.get(r.id));if(n.kind==="comment"){const i=n.anchor,c=p(i),s=O(o).filter(u=>u.id!==c);n.buffer.trim()!==""&&s.push({id:c,anchor:i,text:n.buffer}),d(e,r,{...o,comments:s})}else n.kind==="freetext"?(d(e,r,{...o,freetext:n.buffer}),h(e)):(d(e,r,{text:n.buffer,edited:n.buffer!==r.config.initialText}),h(e));e.inputMode=null}f(J,"commitInput");function T(e,n){const r=[...e.buffer];r.splice(e.cursor,0,...n),e.buffer=r.join(""),e.cursor+=[...n].length}f(T,"insert");function P(e){if(e.cursor===0)return;const n=[...e.buffer];n.splice(e.cursor-1,1),e.buffer=n.join(""),e.cursor--}f(P,"backspace");function Q(e){const n=C(e.buffer,e.cursor);if(n===e.cursor)return;const r=[...e.buffer];r.splice(n,e.cursor-n),e.buffer=r.join(""),e.cursor=n}f(Q,"wordBackspace");function V(e,n){const r=n.replace(/\x1b\[[0-9;?]*[a-zA-Z]/g,"").replace(/\r\n?/g,`
+`).replace(/[\x00-\x09\x0B-\x1F\x7F]/g,"");r.length>0&&T(e,r)}f(V,"insertTyped");function X(e){const n=[...e.buffer];e.cursor>=n.length||(n.splice(e.cursor,1),e.buffer=n.join(""))}f(X,"del");function Y(e,n){const r=[...e].slice(0,n).join(""),o=r.lastIndexOf(`
+`);return o<0?0:[...r.slice(0,o+1)].length}f(Y,"lineStart");function _(e,n){const r=[...e],o=r.slice(n).indexOf(`
+`);return o<0?r.length:n+o}f(_,"lineEnd");function q(e){return Math.max(10,Math.min(e.wrapWidth-8,116))}f(q,"inputWrapWidth");export{ee as handleKeypress};

package/dist/clients/inbox/tui/keys.d.ts

@@ -0,0 +1,28 @@
+export interface Key {
+    upArrow: boolean;
+    downArrow: boolean;
+    leftArrow: boolean;
+    rightArrow: boolean;
+    /** Word-wise cursor motion (ctrl/alt + arrow, or readline alt-b / alt-f). */
+    wordLeft: boolean;
+    wordRight: boolean;
+    home: boolean;
+    end: boolean;
+    pageUp: boolean;
+    pageDown: boolean;
+    /** Forward delete (the Del key / \x1b[3~). */
+    del: boolean;
+    return: boolean;
+    /** Newline-insert chord (ctrl+j / alt+enter) — distinct from return=submit. */
+    newline: boolean;
+    escape: boolean;
+    ctrl: boolean;
+    meta: boolean;
+    tab: boolean;
+    backspace: boolean;
+}
+export type KeypressHandler = (input: string, key: Key) => void;
+export declare function decodeInboxKey(data: string): {
+    input: string;
+    key: Key;
+};

package/dist/clients/inbox/tui/keys.js

@@ -0,0 +1 @@
+var c=Object.defineProperty;var u=(n,i)=>c(n,"name",{value:i,configurable:!0});import{decodeKittyPrintable as k,matchesKey as t,parseKey as y}from"@earendil-works/pi-tui";import{normalizeShiftedMeta as h}from"../../../core/keybindings/index.js";function f(){return{upArrow:!1,downArrow:!1,leftArrow:!1,rightArrow:!1,wordLeft:!1,wordRight:!1,home:!1,end:!1,pageUp:!1,pageDown:!1,del:!1,return:!1,newline:!1,escape:!1,ctrl:!1,meta:!1,tab:!1,backspace:!1}}u(f,"emptyKey");function r(...n){const i=f();for(const e of n)i[e]=!0;return i}u(r,"withFlag");function w(n){return n.length>0&&!n.includes("\x1B")&&n.charCodeAt(0)>=32}u(w,"isPlainText");const s="\x1B[200~",o="\x1B[201~";function d(n){if(!(!n.startsWith(s)||!n.endsWith(o)))return n.slice(s.length,-o.length)}u(d,"bracketedPaste");function A(n){const i=d(n);if(i!==void 0)return{input:i,key:f()};const e=h(n),l=y(e);if(t(e,"up"))return{input:"",key:r("upArrow")};if(t(e,"down"))return{input:"",key:r("downArrow")};if(t(e,"left"))return{input:"",key:r("leftArrow")};if(t(e,"right"))return{input:"",key:r("rightArrow")};if(t(e,"ctrl+left")||t(e,"alt+left")||t(e,"alt+b"))return{input:"",key:r("wordLeft")};if(t(e,"ctrl+right")||t(e,"alt+right")||t(e,"alt+f"))return{input:"",key:r("wordRight")};if(t(e,"home"))return{input:"",key:r("home")};if(t(e,"end"))return{input:"",key:r("end")};if(t(e,"pageUp"))return{input:"",key:r("pageUp")};if(t(e,"pageDown"))return{input:"",key:r("pageDown")};if(t(e,"delete"))return{input:"",key:r("del")};if(t(e,"alt+enter")||l==="ctrl+alt+j")return{input:"",key:r("newline")};if(t(e,"ctrl+j"))return{input:"",key:r("newline")};if(t(e,"enter"))return{input:"",key:r("return")};if(t(e,"alt+backspace")||t(e,"ctrl+w"))return{input:"",key:r("meta","backspace")};if(t(e,"escape"))return{input:"",key:r("escape")};if(t(e,"tab"))return{input:"",key:r("tab")};if(t(e,"backspace"))return{input:"",key:r("backspace")};if(t(e,"alt+shift+r"))return{input:"R",key:r("meta")};if(l?.startsWith("ctrl+")&&l.length===6){const p=l.slice(5);if(/^[a-z]$/.test(p))return{input:p,key:r("ctrl")}}const a=k(n);return a!==void 0?{input:a,key:f()}:w(n)?{input:n,key:f()}:{input:n,key:f()}}u(A,"decodeInboxKey");export{A as decodeInboxKey};

package/dist/clients/inbox/tui/page-body.d.ts

@@ -0,0 +1,10 @@
+import type { PageManifest } from '../../../core/human/page-schema.js';
+/** What a page says, as terminal rows: the authored prose, then each question
+ *  with its own body and the choices it offers. One projection serves every
+ *  read-only view of a page — the inline transcript block and the inbox list's
+ *  preview — so a reader is never asked to settle a page from a summary that
+ *  showed them less than the page itself does.
+ *
+ *  `maxW` is the prose measure, `paneW` the full rectangle a wide block (a
+ *  table, a code fence) may use. Callers window or fold the result. */
+export declare function pageBodyLines(manifest: PageManifest, displayMarkdown: string, maxW: number, paneW: number): string[];

package/dist/clients/inbox/tui/page-body.js

@@ -0,0 +1 @@
+var L=Object.defineProperty;var d=(s,r)=>L(s,"name",{value:r,configurable:!0});import{renderMarkdownBlockAwareLines as M}from"../../../core/termrender/termrender.js";import{describeSlot as S,tableMarkdown as w,terminalAnswerable as x}from"./slots.js";import{BOLD as b,DIM as l,RESET as n,sanitize as o,singleLine as u,truncate as h,wrap as k}from"./ansi.js";function D(s,r,f,m){const c=d(t=>M(t,f,m),"md");if(s.dialect==="html")return r===""?[`${l}HTML page \u2014 open in crouter cloud to read this${n}`]:c(r);const e=r===""?[]:c(r);let a=-1;for(const t of s.slots){s.steps>1&&t.step!==a&&(e.length>0&&e.push(""),e.push(`${b}Step ${t.step+1}/${s.steps}${n}`),a=t.step),e.length>0&&e.push(""),e.push(`${b}${h(o(u(S(t))),f)}${n}`);const $=t.config.body;if(typeof $=="string"&&$!==""&&e.push(...c($)),!x(t)){e.push(`${l}${o(t.kind)} \u2014 open in crouter cloud to answer this${n}`);continue}if(t.kind==="text")e.push(...c(t.config.initialText));else if(t.kind==="table")e.push(...c(w(t.config)));else if(t.kind==="cards"){for(const i of t.config.cards??[])if(e.push(`  \u2022 ${h(o(u(i.subtitle===void 0?i.title:`${i.title} \u2014 ${i.subtitle}`)),Math.max(10,f-4))}`),i.body!==void 0)for(const p of k(o(i.body),Math.max(10,f-6)))e.push(`    ${l}${p}${n}`)}else if(t.kind==="options"){for(const i of t.config.options)if(e.push(`  \u2022 ${h(o(u(i.label)),Math.max(10,f-4))}`),i.description!==void 0)for(const p of k(o(i.description),Math.max(10,f-6)))e.push(`    ${l}${p}${n}`)}else if(t.kind==="chart"){const i=t.config,p=i.title??`${i.x??""} vs ${(i.y??[]).map(g=>g.label??g.field).join(", ")}`;e.push(`${l}chart \u2014 ${o(i.kind??"chart")}: ${o(p)}${n}`)}}return e}d(D,"pageBodyLines");export{D as pageBodyLines};

package/dist/clients/inbox/tui/panel.d.ts

@@ -0,0 +1,4 @@
+import type { PageResponses } from '../../../core/human/page-schema.js';
+import type { MountedPanel, MountedPanelOpts, TuiState } from './types.js';
+export declare function collectResponses(state: TuiState): PageResponses;
+export declare function mountPanel(opts: MountedPanelOpts): MountedPanel;

package/dist/clients/inbox/tui/panel.js

@@ -0,0 +1 @@
+var M=Object.defineProperty;var o=(t,e)=>M(t,"name",{value:e,configurable:!0});import{projectPageDisplayMarkdown as b}from"../../../core/human/page-markdown.js";import{projectHtmlDocumentMarkdown as k}from"../../../core/human/page-html-markdown.js";import{handleKeypress as v}from"./input.js";import{clampItemReviewScroll as R,renderFinal as g,renderItemReview as y,renderOverview as E}from"./render.js";import{pageComplete as I,slotAnswered as x}from"./slots.js";function P(t,e){if(e===void 0)return"";try{return t.dialect==="html"?k(e):b(e,t)}catch{return""}}o(P,"displayMarkdownOf");function p(t,e,a,n,r,l){const i=new Map,w=new Set(t.slots.flatMap(s=>s.id===void 0?[]:[s.id]));for(const[s,h]of Object.entries(a??{}))w.has(s)&&i.set(s,h);const c=P(t,e),d={phase:t.slots.length===1&&c===""?"item-review":"overview",currentIndex:0,manifest:t,displayMarkdown:c,slots:t.slots,responses:i,productKinds:n,inputMode:null,selectedAction:0,scrollOffset:0,followSelection:!0,hscrollOffset:0,hscrollMax:0,wrapWidth:l,editorAvailable:r},f=t.slots.findIndex(s=>s.id!==void 0&&!x(d,s));return f>=0&&(d.currentIndex=f),d}o(p,"buildInitialState");function u(t){return Object.fromEntries(t.responses)}o(u,"collectResponses");function m(t){t.state.persist=()=>t.callbacks.onProgress?.(u(t.state))}o(m,"rebindPersist");function A(t){const e={state:p(t.manifest,t.document,t.initialResponses,t.productKinds??[],t.onEditorRequest!==void 0,t.cols),cols:t.cols,rows:t.rows,mounted:!0,callbacks:{onProgress:t.onProgress,onComplete:t.onComplete,onExit:t.onExit,onDirty:t.onDirty,onEditorRequest:t.onEditorRequest}};m(e);const a=o(()=>e.state.phase==="overview"?E(e.state,e.cols,e.rows):e.state.phase==="final"?g(e.state,e.cols,e.rows):(R(e.state,e.cols,e.rows),y(e.state,e.cols,e.rows)),"renderLines");return{handleKey(n,r){if(e.mounted){if(r.ctrl&&n==="o"&&e.state.inputMode!==null&&e.callbacks.onEditorRequest!==void 0){e.callbacks.onEditorRequest();return}v(n,r,e.state,()=>e.callbacks.onDirty?.(),l=>{const i=u(e.state);l===!0&&I(e.state)?e.callbacks.onComplete?.(i):e.callbacks.onExit?.()}),e.callbacks.onDirty?.()}},render:o(()=>e.mounted?a():[],"render"),handleResize(n,r){return e.cols=n,e.rows=r,e.state.wrapWidth=n,a()},unmount(){e.mounted=!1,e.state.persist=void 0},loadPage(n,r){if(!e.mounted)return;const l=u(e.state),i={...r?.initialResponses??{},...l};e.state=p(n,r?.document,i,r?.productKinds??e.state.productKinds,e.callbacks.onEditorRequest!==void 0,e.cols),m(e)},canAcceptHostKeys:o(()=>e.mounted&&e.state.inputMode===null,"canAcceptHostKeys"),atPageTop:o(()=>!e.mounted||e.state.phase==="overview"&&e.state.inputMode===null,"atPageTop"),getInputBuffer:o(()=>!e.mounted||e.state.inputMode===null?void 0:e.state.inputMode.buffer,"getInputBuffer"),setInputBuffer(n){!e.mounted||e.state.inputMode===null||(e.state.inputMode.buffer=n,e.state.inputMode.cursor=[...n].length)}}}o(A,"mountPanel");export{u as collectResponses,A as mountPanel};

package/dist/clients/inbox/tui/render.d.ts

@@ -0,0 +1,23 @@
+import type { TuiState } from './types.js';
+export declare function renderOverview(state: TuiState, cols: number, rows: number): string[];
+/** Wrap an input buffer and paint the cursor the way a terminal does: the
+ *  character under it is drawn in reverse video, occupying its own cell rather
+ *  than pushing the rest of the line across by one. Only past the end of a row
+ *  does the cursor need a cell of its own, and there it is a reversed space.
+ *  Wrapping runs over the plain buffer, so the rows here are exactly the rows
+ *  `verticalCursor` moves between. */
+export declare function renderInputBuffer(buffer: string, cursor: number, maxWidth: number): string[];
+/** Start of the word before the cursor (alt+left / readline alt-b). The one
+ *  implementation of word motion for every inbox input buffer. */
+export declare function wordLeftIndex(buffer: string, cursor: number): number;
+/** Just past the end of the word after the cursor (alt+right / readline alt-f). */
+export declare function wordRightIndex(buffer: string, cursor: number): number;
+export declare function wrappedRowBounds(buffer: string, width: number): {
+    start: number;
+    end: number;
+}[];
+export declare function verticalCursor(buffer: string, cursor: number, delta: number, width: number): number;
+export declare function clampItemReviewScroll(state: TuiState, cols: number, rows: number): void;
+export declare function panItemReview(state: TuiState, direction: -1 | 1): void;
+export declare function renderItemReview(state: TuiState, cols: number, rows: number): string[];
+export declare function renderFinal(state: TuiState, cols: number, rows: number): string[];

package/dist/clients/inbox/tui/render.js

@@ -0,0 +1,2 @@
+var J=Object.defineProperty;var h=(n,s)=>J(n,"name",{value:s,configurable:!0});import R from"string-width";import{isResponseBearingSlot as O}from"../../../core/human/page-schema.js";import{answerCommentAnchorLabel as K,describePageAnswer as Q}from"../../../core/human/answer.js";import{renderMarkdownBlockAwareLines as U}from"../../../core/termrender/termrender.js";import{commentAnchors as X,describeSlot as S,pageComplete as Z,slotActions as nn,slotAnswered as v,tableMarkdown as en,terminalAnswerable as A}from"./slots.js";import{RESET as i,BOLD as M,DIM as u,GREEN as E,YELLOW as w,CYAN as k,REVERSE as W,sanitize as a,singleLine as C,truncate as B,hline as g,wrap as b,centerHorizontal as q,clipLine as T,panLine as tn,visibleWidth as L}from"./ansi.js";const sn=8,y=h((n,s,e)=>U(n,s,e),"mdLines");function H(n){return Q(n.manifest,Object.fromEntries(n.responses),{completedAt:""})}h(H,"pageAnswer");function on(n,s){return s.id===void 0?void 0:n.slots.find(e=>e.id===s.id)}h(on,"answerSlot");function N(n){if(n===void 0||n.state==="unanswered")return"unanswered";if(n.raw!==void 0)return"custom response";const s=n.text!==void 0?[n.text.edited?"edited":"accepted"]:n.groups.map(e=>e.picked.length===0?"none":e.picked.map(t=>t.label).join(", "));return n.freetext!==void 0&&s.push(n.freetext),n.comments.length>0&&s.push(`${n.comments.length} comment${n.comments.length===1?"":"s"}`),s.join("; ")||"answered"}h(N,"answerSummary");function P(n,s){return K(n,s)}h(P,"commentLabel");function pn(n,s,e){const t=Math.min(Math.max(20,s-4),120),r=Math.max(20,s-4),o=["",`  ${M}${k}${a(n.manifest.title)}${i}`];if(n.manifest.subtitle)for(const m of b(a(n.manifest.subtitle),t))o.push(`  ${u}${m}${i}`);if(n.displayMarkdown!==""){o.push("");for(const m of y(n.displayMarkdown,t,r))o.push(`  ${m}`)}else n.manifest.dialect==="html"&&o.push("",`  ${u}HTML page \u2014 open in crouter cloud to read this${i}`);const l=n.slots.length>0;l&&o.push(`  ${u}${g(t)}${i}`,"");const f=H(n);let $=-1,c;for(let m=0;m<n.slots.length;m++){const p=n.slots[m];n.manifest.steps>1&&p.step!==$&&($!==-1&&o.push(""),o.push(`  ${M}Step ${p.step+1}/${n.manifest.steps}${i}`),$=p.step);const I=p.id===void 0?void 0:n.responses.get(p.id),V=O(p)?v(n,p)?`${E}\u2713${i}`:`${u}\u25CB${i}`:`${u}\xB7${i}`,_=m===n.currentIndex?`${k}\u25B8${i} `:"  ";m===n.currentIndex&&(c=o.length),o.push(`  ${_}${V} ${B(C(S(p)),Math.max(10,s-16))}`),I!==void 0&&o.push(`      ${u}${B(C(N(on(f,p))),Math.max(10,s-10))}${i}`)}if(n.manifest.slots.some(m=>O(m)&&!A(m))){o.push("");for(const m of b("This page must be answered in crouter cloud. Leaving it here keeps it in your inbox; x on the list cancels it.",t-2))o.push(`  ${w}${m}${i}`)}l&&o.push(""),o.push(`  ${u}${g(t)}${i}`);const x=!n.manifest.slots.some(O)?`  ${u}u/d${i} scroll  ${u}q${i} dismiss`:`  ${u}enter${i} review  ${u}\u2191\u2193/jk${i} navigate  ${u}u/d${i} scroll  ${u}q${i} close`;return G(o,x,n,s,e,t+2,n.followSelection?c:void 0)}h(pn,"renderOverview");function rn(n,s,e){const t=[...n],r=Math.max(0,Math.min(s,t.length)),o=z(n,e);let l=0;for(let c=0;c<o.length;c++)o[c].start<=r&&(l=c);const f=o.map((c,d)=>{if(d!==l)return t.slice(c.start,c.end).join("");const x=t.slice(c.start,r).join(""),m=r<c.end?t[r]:" ",p=r<c.end?t.slice(r+1,c.end).join(""):"";return`${x}${W}${m}${i}${p}`}),$=o[l];return r===$.end&&R(t.slice($.start,$.end).join(""))>=e&&(f[l]=t.slice($.start,$.end).join(""),f.splice(l+1,0,`${W} ${i}`)),f}h(rn,"renderInputBuffer");function xn(n,s){const e=[...n];let t=Math.max(0,Math.min(s,e.length));for(;t>0&&/\s/.test(e[t-1]);)t--;for(;t>0&&!/\s/.test(e[t-1]);)t--;return t}h(xn,"wordLeftIndex");function Mn(n,s){const e=[...n];let t=Math.max(0,Math.min(s,e.length));for(;t<e.length&&/\s/.test(e[t]);)t++;for(;t<e.length&&!/\s/.test(e[t]);)t++;return t}h(Mn,"wordRightIndex");function z(n,s){const e=[...n],t=Math.max(1,s),r=[];let o=0,l=0;for(let f=0;f<e.length;f++){const $=e[f];if($===`
+`){r.push({start:o,end:f}),o=f+1,l=0;continue}const c=R($);l+c>t?(r.push({start:o,end:f}),o=f,l=c):l+=c}return r.push({start:o,end:e.length}),r}h(z,"wrappedRowBounds");function gn(n,s,e,t){const r=z(n,t),o=Math.max(0,Math.min(s,[...n].length));let l=0;for(let $=0;$<r.length;$++)r[$].start<=o&&(l=$);const f=r[l+e];return f===void 0?o:Math.min(f.start+(o-r[l].start),f.end)}h(gn,"verticalCursor");function cn(n,s){return s.id===void 0?[]:n.responses.get(s.id)?.comments??[]}h(cn,"responseComments");function ln(n,s,e,t){if(s.id===void 0)return!1;const r=n.responses.get(s.id);return e==="option"?r?.selectedOptionIds?.includes(t)===!0:e==="card"?r?.selectedCardIds?.includes(t)===!0:e==="row"?r?.selectedRowIds?.includes(t)===!0:r?.selectedColumnIds?.includes(t)===!0}h(ln,"selected");function D(n,s){const e=n.slots[n.currentIndex],t=Math.min(Math.max(20,s-4),120),r=Math.max(20,s-4),o=["",`  ${M}${k}[${n.currentIndex+1}/${n.slots.length}]${i}  ${u}${a(n.manifest.title)}${i}`,`  ${u}${g(t)}${i}`,"",`  ${M}${a(S(e))}${i}`],l=e.config.body;if(typeof l=="string"&&l.length>0){o.push("");for(const c of y(l,t,r))o.push(`  ${c}`)}if(A(e)){if(e.kind==="chart"){const c=e.config,d=c.title??`${c.x} vs ${(c.y??[]).map(x=>x.label??x.field).join(", ")}`;o.push("",`  ${u}chart \u2014 ${a(c.kind)}: ${a(d)}${i}`)}else if(e.kind==="table"){o.push("");for(const d of y(en(e.config),t,r))o.push(`  ${d}`);const c=e.config.label;c&&o.push(`  ${u}${a(c)}${i}`)}else if(e.kind==="text"){const d=(e.id===void 0?void 0:n.responses.get(e.id))?.text??e.config.initialText;o.push("");for(const x of y(d,t,r))o.push(`  ${x}`)}}else{o.push("");for(const c of b(`${a(e.kind)} \u2014 must be answered in crouter cloud; the terminal cannot submit this page`,Math.max(10,t-2)))o.push(`  ${w}${c}${i}`);o.push(`  ${u}q leaves it in your inbox; x on the list cancels it${i}`)}o.push("",`  ${u}${g(t)}${i}`);let f;if(n.inputMode!==null){const c=n.inputMode.kind==="comment"?`Comment on ${P(e,n.inputMode.anchor)}`:n.inputMode.kind==="text"?"Edit text":"Other response";o.push(`  ${M}${c}${i}`);for(const d of rn(n.inputMode.buffer,n.inputMode.cursor,Math.max(10,t-4)))o.push(`  ${d}`);f=`  ${u}enter save  esc cancel${n.editorAvailable?"  ^o editor":""}${i}`}else{nn(e).forEach((d,x)=>{const m=x===n.selectedAction?`${k}\u25B8${i}`:" ";if(d.kind==="select"){const p=ln(n,e,d.group,d.id)?`${E}\u2713${i}`:" ";if(o.push(`  ${m} [${p}] ${d.shortcut?`[${d.shortcut}] `:""}${a(d.label)}`),d.description)for(const I of b(a(d.description),Math.max(10,t-6)))o.push(`        ${u}${I}${i}`)}else{const p=d.kind==="freetext"?"r":d.kind==="edit"?"e":"a";o.push(`  ${m} [${p}] ${a(d.label)}`)}});for(const d of cn(n,e))for(const x of b(`attached: ${P(e,d.anchor)} \u2014 ${a(d.text)}`,Math.max(10,t-2)))o.push(`  ${u}${x}${i}`);n.hint&&o.push(`  ${w}${a(n.hint)}${i}`),f=`  ${u}n/p next/previous  \u2191\u2193/jk actions${X(e).length>0?"  c comment":""}  u/d scroll  \u2190\u2192/hl pan  q close${i}`}const $=Math.max(0,...o.map(L));return{lines:o,footer:f,maxW:t,maxH:Math.max(0,$-Math.max(1,s))}}h(D,"itemLines");function wn(n,s,e){if(n.slots[n.currentIndex]===void 0){n.scrollOffset=0,n.hscrollOffset=0,n.hscrollMax=0;return}const t=D(n,s);n.hscrollMax=t.maxH,n.hscrollOffset=Math.max(0,Math.min(n.hscrollOffset,n.hscrollMax)),n.scrollOffset=Math.max(0,Math.min(n.scrollOffset,Math.max(0,t.lines.length-j(e))))}h(wn,"clampItemReviewScroll");function kn(n,s){n.hscrollOffset=Math.max(0,Math.min(n.hscrollMax,n.hscrollOffset+s*sn))}h(kn,"panItemReview");function bn(n,s,e){const t=D(n,s),r=j(e),o=n.scrollOffset,l=t.lines.slice(o,o+r);for(;l.length<r;)l.push("");const f=n.hscrollOffset>0?l.map(c=>tn(c,n.hscrollOffset,s)):l,$=Math.min(s,t.maxW+2);return r<e&&f.push(Y(t.footer,F(o,r,t.lines.length),t.maxW+2)),q(f.map(c=>T(c,s)),s,$)}h(bn,"renderItemReview");function On(n,s,e){const t=Math.min(Math.max(20,s-4),120),r=["",`  ${M}${k}${a(n.manifest.title)} \u2014 Summary${i}`,`  ${u}${g(t)}${i}`,""],o=H(n);for(const $ of o.slots){const c=n.manifest.slots.find(m=>m.id===$.id),x=c!==void 0&&v(n,c)?`${E}\u2713${i}`:`${w}\u25CB${i}`;r.push(`  ${x} ${M}${a(c===void 0?$.kind:S(c))}${i}  ${u}${a(N($))}${i}`)}const l=Z(n);if(!l){r.push("",`  ${w}Cannot submit yet.${i}`);for(const $ of n.slots.filter(O))v(n,$)||(r.push(`  ${u}${$.id??$.kind} is unanswered${i}`),A($)||r.push(`  ${u}${$.id} must be answered in crouter cloud${i}`))}r.push("",`  ${u}${g(t)}${i}`);const f=l?`  ${u}enter${i} submit  ${u}u/d${i} scroll  ${u}q${i} back`:`  ${u}u/d${i} scroll  ${u}q${i} back`;return G(r,f,n,s,e,t+2)}h(On,"renderFinal");function j(n){return n>=2?n-1:n}h(j,"bodyRows");function F(n,s,e){if(s<=0||e<=s)return{marks:"",full:""};const t=Math.min(e,n+s),r=`${n>0?"\u25B4":" "}${t<e?"\u25BE":" "}`;return{marks:`${u}${r}${i}`,full:`${u}${r} ${n+1}\u2013${t}/${e}${i}`}}h(F,"scrollBadge");function Y(n,s,e){if(s.full==="")return n;const t=h(r=>e-L(n)-L(r)-2,"room");for(const r of[s.full,s.marks])if(t(r)>=2)return`${n}${" ".repeat(t(r))}${r}`;return`  ${s.marks} ${n.trimStart()}`}h(Y,"pinnedFooter");function G(n,s,e,t,r,o,l){const f=j(r),$=Math.max(0,n.length-f);e.scrollOffset=Math.max(0,Math.min(e.scrollOffset,$)),l!==void 0&&f>0&&(l<e.scrollOffset?e.scrollOffset=l:l>=e.scrollOffset+f&&(e.scrollOffset=Math.min($,l-f+1)));const c=n.slice(e.scrollOffset,e.scrollOffset+f);for(;c.length<f;)c.push("");return f<r&&c.push(Y(s,F(e.scrollOffset,f,n.length),o)),q(c.map(d=>T(d,t)),t,Math.min(t,o))}h(G,"centeredWindow");export{wn as clampItemReviewScroll,kn as panItemReview,On as renderFinal,rn as renderInputBuffer,bn as renderItemReview,pn as renderOverview,gn as verticalCursor,xn as wordLeftIndex,Mn as wordRightIndex,z as wrappedRowBounds};

package/dist/clients/inbox/tui/slots.d.ts

@@ -0,0 +1,33 @@
+import type { PageCommentAnchor, PageSlot, SlotResponse, TableConfig } from '../../../core/human/page-schema.js';
+import type { TuiState } from './types.js';
+export type SelectGroup = 'option' | 'card' | 'row' | 'column';
+export type ActionRow = {
+    kind: 'select';
+    group: SelectGroup;
+    id: string;
+    label: string;
+    description?: string;
+    shortcut?: string;
+    mode: 'single' | 'multi';
+} | {
+    kind: 'freetext';
+    label: string;
+} | {
+    kind: 'accept';
+    label: string;
+} | {
+    kind: 'edit';
+    label: string;
+};
+export declare function describeSlot(slot: PageSlot): string;
+/** False when this component's response cannot be authored here: an unvalidated product kind, or a source-backed cards component whose cards the terminal never sees. */
+export declare function terminalAnswerable(slot: PageSlot): boolean;
+export declare function slotActions(slot: PageSlot): ActionRow[];
+export declare function tableMarkdown(config: TableConfig): string;
+/** Whether this value would be accepted as the slot's answer — the same reading crtrd applies on submit. */
+export declare function responseAnswers(state: Pick<TuiState, 'manifest'>, slot: PageSlot, response: SlotResponse): boolean;
+export declare function slotAnswered(state: TuiState, slot: PageSlot): boolean;
+export declare function pageComplete(state: Pick<TuiState, 'manifest' | 'responses'>): boolean;
+export declare function commentIdFor(anchor: PageCommentAnchor): string;
+/** The response-comment anchors this component may author: options take per-option, tables take rows only. */
+export declare function commentAnchors(slot: PageSlot): PageCommentAnchor[];

package/dist/clients/inbox/tui/slots.js

@@ -0,0 +1,3 @@
+var a=Object.defineProperty;var o=(e,n)=>a(e,"name",{value:n,configurable:!0});import{isResponseBearingSlot as l,validatePageResponses as c,validatePartialPageResponses as p}from"../../../core/human/page-schema.js";const m=new Set(["c","r","e","a","n","p","q","j","k","u","d"," "]);function h(e){const n=e.config.label;return typeof n=="string"&&n!==""?n:e.unvalidated===!0?e.kind:e.kind==="options"?"Options":e.kind==="text"?"Text":e.kind==="table"?"Table":e.kind==="cards"?"Cards":e.kind==="chart"?"Chart":e.kind}o(h,"describeSlot");function s(e){return!(e.unvalidated===!0||e.kind==="cards"&&e.config.cards===void 0)}o(s,"terminalAnswerable");function x(e){if(!s(e))return[];let n=[];if(e.kind==="options"){const r=e.config;n=r.options.map(i=>({kind:"select",group:"option",id:i.id,label:i.label,...i.description===void 0?{}:{description:i.description},mode:r.mode})),r.allowFreetext===!0&&n.push({kind:"freetext",label:r.freetextLabel??"Something else"})}else if(e.kind==="cards"){const r=e.config;n=(r.cards??[]).map(i=>({kind:"select",group:"card",id:i.id,label:i.subtitle===void 0?i.title:`${i.title} \u2014 ${i.subtitle}`,...i.body===void 0?{}:{description:i.body},mode:r.mode}))}else if(e.kind==="text")n.push({kind:"edit",label:"Edit"}),n.push({kind:"accept",label:"Accept as-is"});else if(e.kind==="table"){const r=e.config;if(r.rowSelect!=="none"){const i=r.columns[0];n.push(...(r.rows??[]).map(t=>({kind:"select",group:"row",id:t.id,label:i===void 0?t.id:String(t.cells[i.id]??t.id),mode:r.rowSelect})))}r.columnSelect!=="none"&&n.push(...r.columns.map(i=>({kind:"select",group:"column",id:i.id,label:i.label,mode:r.columnSelect})))}const d=new Set;return n.map(r=>{if(r.kind!=="select")return r;let i;for(const t of[...r.label.toLowerCase()].filter(f=>/[a-z]/.test(f)))if(!d.has(t)&&!m.has(t)){i=t;break}if(i===void 0){for(let t=1;t<=9;t++)if(!d.has(String(t))){i=String(t);break}}return i!==void 0&&d.add(i),{...r,...i===void 0?{}:{shortcut:i}}})}o(x,"slotActions");function u(e,n=!1){if(e==null)return"";const d=String(e).replaceAll("|","\\|").replaceAll(`
+`,"<br>");return n&&d!==""?`\`${d.replaceAll("`","\\`")}\``:d}o(u,"escapeCell");function w(e){const n=`| ${e.columns.map(r=>u(r.label)).join(" | ")} |`,d=`| ${e.columns.map(r=>r.align==="right"?"---:":"---").join(" | ")} |`;return[n,d,...(e.rows??[]).map(r=>`| ${e.columns.map(i=>u(r.cells[i.id],i.mono===!0)).join(" | ")} |`)].join(`
+`)}o(w,"tableMarkdown");function b(e,n,d){if(n.id===void 0)return!1;try{return p(e.manifest,{[n.id]:d}),!0}catch{return!1}}o(b,"responseAnswers");function S(e,n){return!s(n)||n.id===void 0||!e.responses.has(n.id)?!1:b(e,n,e.responses.get(n.id))}o(S,"slotAnswered");function A(e){if(e.manifest.slots.some(n=>l(n)&&!s(n)))return!1;try{return c(e.manifest,Object.fromEntries(e.responses)),!0}catch{return!1}}o(A,"pageComplete");function $(e){switch(e.kind){case"option":return`option:${e.optionId}`;case"row":return`row:${e.rowId}`}}o($,"commentIdFor");function j(e){return s(e)?e.kind==="options"?e.config.options.map(n=>({kind:"option",optionId:n.id})):e.kind==="table"?(e.config.rows??[]).map(n=>({kind:"row",rowId:n.id})):[]:[]}o(j,"commentAnchors");export{j as commentAnchors,$ as commentIdFor,h as describeSlot,A as pageComplete,b as responseAnswers,x as slotActions,S as slotAnswered,w as tableMarkdown,s as terminalAnswerable};

package/dist/clients/inbox/tui/types.d.ts

@@ -0,0 +1,73 @@
+import type { Key } from './keys.js';
+import type { ProductPageComponents } from '../../../types.js';
+import type { PageCommentAnchor, PageManifest, PageResponses, PageSlot, SlotResponse } from '../../../core/human/page-schema.js';
+export type Phase = 'overview' | 'item-review' | 'final';
+export type InputMode = null | {
+    kind: 'comment';
+    buffer: string;
+    cursor: number;
+    anchor: PageCommentAnchor;
+} | {
+    kind: 'freetext';
+    buffer: string;
+    cursor: number;
+} | {
+    kind: 'text';
+    buffer: string;
+    cursor: number;
+};
+export interface TuiState {
+    phase: Phase;
+    currentIndex: number;
+    manifest: PageManifest;
+    /** The authored display JSX (headings, paragraphs, prose outside slots),
+     *  projected to markdown — same projection the inline chat block uses.
+     *  Empty when the page has none, or its document was unavailable. */
+    displayMarkdown: string;
+    slots: PageSlot[];
+    responses: Map<string, SlotResponse>;
+    productKinds: ProductPageComponents;
+    inputMode: InputMode;
+    selectedAction: number;
+    scrollOffset: number;
+    /** Whether the overview window is following the j/k selection. Set by moving
+     *  the selection, cleared the moment the user scrolls the window themselves —
+     *  otherwise the follow would drag the window back on every manual scroll. */
+    followSelection: boolean;
+    hscrollOffset: number;
+    hscrollMax: number;
+    wrapWidth: number;
+    editorAvailable: boolean;
+    hint?: string;
+    persist?: () => void;
+}
+export interface MountedPanelOpts {
+    manifest: PageManifest;
+    /** The raw page document — needed only to project display markdown; a jsx
+     *  page without one just shows no display content, same as a read failure. */
+    document?: string;
+    productKinds?: ProductPageComponents;
+    initialResponses?: PageResponses | null;
+    cols: number;
+    rows: number;
+    onEditorRequest?: () => void;
+    onProgress?: (responses: PageResponses) => void;
+    onComplete?: (responses: PageResponses) => void;
+    onExit?: () => void;
+    onDirty?: () => void;
+}
+export interface MountedPanel {
+    handleKey(input: string, key: Key): void;
+    render(): string[];
+    handleResize(cols: number, rows: number): string[];
+    unmount(): void;
+    loadPage(manifest: PageManifest, opts?: {
+        document?: string;
+        initialResponses?: PageResponses | null;
+        productKinds?: ProductPageComponents;
+    }): void;
+    canAcceptHostKeys(): boolean;
+    atPageTop(): boolean;
+    getInputBuffer(): string | undefined;
+    setInputBuffer(text: string): void;
+}