@deepseek-harness-tui/dsh-tui 0.10.0 → 0.10.2

package/lib/types/adapter/ports/channel-catalog.d.ts

@@ -0,0 +1,90 @@
+/** Host-owned in-process Channel contract. No runtime or upstream imports. */
+export interface LocalCommand {
+    /** The command name without the slash, e.g. `clear`. */
+    name: string;
+    /**
+     * One-line description shown in the suggestion overlay — the English text
+     * and the fallback for languages without a `cmd-desc-<name>` dict entry
+     * (see {@link localizedDescription}).
+     */
+    description: string;
+    /** Provider-owned translations selected with the active TUI language. */
+    descriptions?: LocalizedDescriptions;
+    /** Optional bracket tag shown between name and description. */
+    tag?: string;
+    /** True when a DSH plugin registered this command (not built in). */
+    external?: boolean;
+    /** True when this command explicitly accepts composer images. Local
+     * commands default to false; registry entries mirror `input.images`. */
+    acceptsImages?: boolean;
+    /**
+     * True when the entry is a user-invocable skill discovered by the DSH
+     * skill registry (issue #86). Skill entries are completion-only: dispatch
+     * falls through to the model as plain text, where dsh-tool-skill's
+     * pre-step hook injects the skill body — the same path a hand-typed
+     * `/skill-name` takes. The help menu hides them (chrome commands only).
+     */
+    skill?: boolean;
+}
+export type LocalizedDescriptions = Readonly<Partial<Record<'zh' | 'en', string>>>;
+/** A concrete completion row, including the text inserted by Tab/Enter. */
+export interface CommandCompletion extends LocalCommand {
+    replacement: string;
+    commandLine: string;
+    descriptionKey?: string;
+}
+export type BalanceResult = {
+    readonly ok: true;
+    /** 账户是否可用（是否有可用额度）。 */
+    readonly isAvailable: boolean;
+    readonly balances: readonly BalanceInfo[];
+} | {
+    readonly ok: false;
+    /** 失败分类：无 key / 网络或超时 / 认证失败 / 非 2xx / 响应结构非法。 */
+    readonly reason: 'no-key' | 'network' | 'unauthorized' | 'http' | 'invalid';
+    /** 非 2xx 时的 HTTP 状态码（其余分类无）。 */
+    readonly status?: number;
+};
+/**
+ * DeepSeek 官方账户余额查询（`GET /user/balance`）。
+ *
+ * 纯函数模块：只负责"用 key 换余额"，密钥由调用方（channel 的 credentials
+ * seam → 环境变量兜底）解析，绝不在此打印或持久化。查询接口本身是只读的，
+ * 不消耗 API 额度（社区插件均按秒/分钟级轮询使用）。
+ *
+ * 响应结构（官方文档）：
+ *   { "is_available": true, "balance_infos": [
+ *       { "currency": "CNY", "total_balance": "110.00",
+ *         "granted_balance": "10.00", "topped_up_balance": "100.00" } ] }
+ * 余额字段是字符串数字；`granted` 为赠送余额，`topped_up` 为充值余额，
+ * 扣费优先扣赠送余额。
+ */
+/** 单个币种的余额快照（元）。 */
+export interface BalanceInfo {
+    currency: string;
+    /** 总余额 = granted + toppedUp。 */
+    total: number;
+    /** 赠送余额。 */
+    granted: number;
+    /** 充值余额。 */
+    toppedUp: number;
+}
+export interface FileCandidate {
+    id: string;
+    path: string;
+    displayPath: string;
+    name: string;
+    kind: FileCandidateKind;
+    score: number;
+}
+export type FileCandidateKind = 'file' | 'directory';
+/** Outcome of one recap call, as surfaced on the Channel. */
+export interface RecapOutcome {
+    /** The one-line summary, or null when the call failed. */
+    summary: string | null;
+    /** Proposed session title, when the model offered one. */
+    title?: string;
+    /** Human-readable failure reason (llm missing, stream error, …). */
+    error?: string;
+}
+//# sourceMappingURL=channel-catalog.d.ts.map

package/lib/types/adapter/ports/channel-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-catalog.d.ts","sourceRoot":"","sources":["../../../../src/adapter/ports/channel-catalog.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAG9E,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB,yEAAyE;IACzE,YAAY,CAAC,EAAE,qBAAqB,CAAA;IACpC,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;4EACwE;IACxE,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;AAElF,2EAA2E;AAC3E,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,MAAM,aAAa,GACrB;IACA,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;IACjB,uBAAuB;IACvB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAA;CAC1C,GACC;IACA,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAA;IAClB,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,cAAc,GAAG,MAAM,GAAG,SAAS,CAAA;IAC3E,gCAAgC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAEH;;;;;;;;;;;;;GAaG;AAEH,oBAAoB;AACpB,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,YAAY;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,YAAY;IACZ,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,iBAAiB,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,WAAW,CAAA;AAEpD,6DAA6D;AAC7D,MAAM,WAAW,YAAY;IAC3B,0DAA0D;IAC1D,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAA;CACf"}

package/lib/types/adapter/ports/channel-catalog.js

@@ -0,0 +1,2 @@
+/** Host-owned in-process Channel contract. No runtime or upstream imports. */
+export {};

package/lib/types/adapter/ports/channel-display.d.ts

@@ -0,0 +1,90 @@
+/** Host-owned in-process Channel contract. No runtime or upstream imports. */
+/**
+ * Spinner presentation phase: the stage of the current turn the spinner
+ * should convey.
+ */
+export type SpinnerMode = 'requesting' | 'thinking' | 'responding' | 'tool-use' | 'tool-input';
+/** Background treatment applied to tool-call cards. */
+export type ToolBackground = 'none' | 'subtle' | 'strong';
+/**
+ * What the fullscreen transcript's right gutter shows:
+ *  - `timeline`: Grok-style turn rail — one tick per user turn (conversation
+ *    order, not scroll proportion), active turn highlighted, click to jump;
+ *  - `scrollbar`: classic proportional thumb — position/size of the visible
+ *    window over the whole content, click the track to scroll there;
+ *  - `hidden`: no gutter; the transcript takes the full width.
+ */
+export type ScrollGutterMode = 'timeline' | 'scrollbar' | 'hidden';
+/** A stored page-margin setting: a preset name or a custom spec. */
+export type PageMarginSetting = PageMarginMode | PageMarginSpec;
+/**
+ * Root page inset (settings `dsh-tui.pageMargin`): some terminals carry
+ * their own viewport padding (Windows Terminal's 8px default, GUI
+ * emulators), others — bare WSL, tmux, SSH — have none, so the UI text
+ * touches the screen edges. A setting is either a preset name
+ * (none/slim/normal/roomy) or a custom spec (see {@link PageMarginSpec}).
+ * The resolved geometry is what `PageMargin` (the root inset box above
+ * Chat) renders; the channel carries the setting for tests, the module
+ * store below is what the box itself subscribes to (the channel's version
+ * bump only re-renders below Chat).
+ */
+export type PageMarginMode = 'none' | 'slim' | 'normal' | 'roomy';
+/** Custom spec: `NxM` — N blank columns per side, M blank rows top/bottom
+ *  (e.g. `3x1`). */
+export type PageMarginSpec = `${number}x${number}`;
+/** Individually selectable fields in the status footer. */
+export interface StatusBarConfig {
+    /** Prefer the compact, single-line presentation when space permits. */
+    compact: boolean;
+    /** Live model id. */
+    model: boolean;
+    /** Reasoning effort / thinking mode. */
+    thinking: boolean;
+    /** Session working directory. */
+    cwd: boolean;
+    /** Current context-window consumption. */
+    contextUsage: boolean;
+    /** Prompt-cache hit rate. */
+    cache: boolean;
+    /** Running input/output token totals. */
+    tokens: boolean;
+    /** Estimated session spend (≈¥, DeepSeek official pricing — only shown
+     *  for official DeepSeek providers whose model has a known price). */
+    cost: boolean;
+    /** Live and recent output speed. */
+    tps: boolean;
+    /** Current git branch. */
+    gitBranch: boolean;
+    /** Current session title. */
+    sessionTitle: boolean;
+    /** Short session id (# + first 8 chars), matching the session log filename. */
+    sessionId: boolean;
+    /** Compact goal chip (phase glyph + rounds) while a goal exists. */
+    goal: boolean;
+    /** Non-default session mode. */
+    mode: boolean;
+    /** Segmented context progress bar on its own footer row. */
+    contextBar: boolean;
+    /** Idle working-activity summary. */
+    activity: boolean;
+    /** Mini trajectory wake rendered at the footer's right edge. */
+    trajectory: boolean;
+    /** Idle `? for shortcuts` reminder; shortcut keys remain available when hidden. */
+    shortcutHint: boolean;
+}
+export interface SessionModeSpec {
+    /** Stable id; also the display name unless `label` is set or the id is a
+     *  localized built-in (`default`/`plan`/`full`). */
+    id: string;
+    /** Optional display label; wins over the built-in i18n name. */
+    label?: string;
+    /** Plan mode on/off (dsh-plan-mode `/plan`). */
+    plan?: boolean;
+    /** Sandbox mode override (dsh-sandbox-policy `sandbox/mode`). */
+    sandbox?: 'read-only' | 'workspace-write' | 'danger-full-access';
+    /** Approval policy override (dsh-user-approval `approval/policy`). */
+    approval?: 'ask' | 'never';
+    /** Durable DSH permission preset identity (`permission/preset`). */
+    permission?: string;
+}
+//# sourceMappingURL=channel-display.d.ts.map

package/lib/types/adapter/ports/channel-display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-display.d.ts","sourceRoot":"","sources":["../../../../src/adapter/ports/channel-display.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAG9E;;;GAGG;AACH,MAAM,MAAM,WAAW,GACnB,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,UAAU,GACV,YAAY,CAAA;AAEhB,uDAAuD;AACvD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAEzD;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAA;AAElE,oEAAoE;AACpE,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,cAAc,CAAA;AAE/D;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;AAEjE;oBACoB;AACpB,MAAM,MAAM,cAAc,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAA;AAElD,2DAA2D;AAC3D,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,OAAO,EAAE,OAAO,CAAA;IAChB,qBAAqB;IACrB,KAAK,EAAE,OAAO,CAAA;IACd,wCAAwC;IACxC,QAAQ,EAAE,OAAO,CAAA;IACjB,iCAAiC;IACjC,GAAG,EAAE,OAAO,CAAA;IACZ,0CAA0C;IAC1C,YAAY,EAAE,OAAO,CAAA;IACrB,6BAA6B;IAC7B,KAAK,EAAE,OAAO,CAAA;IACd,yCAAyC;IACzC,MAAM,EAAE,OAAO,CAAA;IACf;0EACsE;IACtE,IAAI,EAAE,OAAO,CAAA;IACb,oCAAoC;IACpC,GAAG,EAAE,OAAO,CAAA;IACZ,0BAA0B;IAC1B,SAAS,EAAE,OAAO,CAAA;IAClB,6BAA6B;IAC7B,YAAY,EAAE,OAAO,CAAA;IACrB,+EAA+E;IAC/E,SAAS,EAAE,OAAO,CAAA;IAClB,oEAAoE;IACpE,IAAI,EAAE,OAAO,CAAA;IACb,gCAAgC;IAChC,IAAI,EAAE,OAAO,CAAA;IACb,4DAA4D;IAC5D,UAAU,EAAE,OAAO,CAAA;IACnB,qCAAqC;IACrC,QAAQ,EAAE,OAAO,CAAA;IACjB,gEAAgE;IAChE,UAAU,EAAE,OAAO,CAAA;IACnB,mFAAmF;IACnF,YAAY,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B;wDACoD;IACpD,EAAE,EAAE,MAAM,CAAA;IACV,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gDAAgD;IAChD,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,iEAAiE;IACjE,OAAO,CAAC,EAAE,WAAW,GAAG,iBAAiB,GAAG,oBAAoB,CAAA;IAChE,sEAAsE;IACtE,QAAQ,CAAC,EAAE,KAAK,GAAG,OAAO,CAAA;IAC1B,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB"}

package/lib/types/adapter/ports/channel-display.js

@@ -0,0 +1,2 @@
+/** Host-owned in-process Channel contract. No runtime or upstream imports. */
+export {};

package/lib/types/adapter/ports/channel-session.d.ts

@@ -0,0 +1,229 @@
+/** Host-owned in-process Channel contract. No runtime or upstream imports. */
+/** One extra rewind mode offered by a plugin (e.g. "also restore files"). */
+export interface TuiRewindMode {
+    /** Stable id reported back in `TuiRewindDoneEvent.mode`. */
+    id: string;
+    /** One-line label shown in the confirm pane. */
+    label: string;
+    /** Optional dimmed description under the label. */
+    description?: string;
+}
+export interface SessionTreeData {
+    readonly roots: readonly TreeNode[];
+    /** Node ids on the path from the family root to the live tip (`•` marker). */
+    readonly activePath: ReadonlySet<string>;
+    /** Live session's last node (initial cursor target). */
+    readonly activeLeafId: string | null;
+    /** Per-session display facts (branch-head labels in the screen). */
+    readonly sessions: ReadonlyMap<string, SessionTreeMeta>;
+    /** Per-session rewind UX facts (drop-turn warning, branch-adopt target). */
+    readonly rewindFacts: ReadonlyMap<string, SessionRewindFacts>;
+    /** True when the family exceeded a cap and distant branches were dropped. */
+    readonly truncated: boolean;
+    readonly sessionCount: number;
+}
+export interface TreeNode {
+    /** `${sessionId}:${seq}`, or `${sessionId}:head` for a placeholder. */
+    readonly id: string;
+    /** Null only on a session's placeholder node (empty fork / unreadable log). */
+    readonly entry: TreeEntry | null;
+    /** Session whose chain this node belongs to. */
+    readonly sessionId: string;
+    /** True on a session chain's first node (renders the fork/session marker). */
+    branchHead: boolean;
+    children: TreeNode[];
+}
+/** One displayable log entry; identity = (sessionId, seq). */
+export interface TreeEntry {
+    readonly sessionId: string;
+    /** Source event seq inside that session's log (the fork anchor). */
+    readonly seq: number;
+    readonly kind: TreeEntryKind;
+    /** One-line preview (whitespace folded, capped). */
+    readonly text: string;
+    /** Uncapped searchable text (kind + tool name + content). */
+    readonly searchText: string;
+    /** Event wall-clock time. */
+    readonly time: number;
+    /** Tool outcome for kind 'tool' (settled by tool/result during extraction). */
+    readonly toolStatus?: 'running' | 'ok' | 'error';
+    /** Extra marker (e.g. `aborted` for chunk-only assistant text). */
+    readonly label?: string;
+    /** True on entries of the log's OWN first turn (a complete log's turn 0).
+     *  Only USER entries among them are unrewindable (dropping turn 0 needs
+     *  boundary -1, "cannot rewind to the very first message"), so the screen
+     *  refuses those up front instead of failing at confirm time; non-user
+     *  turn-0 entries rewind fine (a mid-turn cut at their step's step/end, or
+     *  turn 0's closing turn/end). Never set on a truncated tail: its first
+     *  VISIBLE turn rewinds fine against the full log, which is where
+     *  rewindToNode computes boundaries. */
+    readonly firstTurn?: boolean;
+}
+/** Displayable entry kinds (a subset of ChatRow kinds, plus fork structure). */
+export type TreeEntryKind = 'user' | 'assistant' | 'tool' | 'compact' | 'interrupt' | 'notice';
+export interface SessionTreeMeta {
+    readonly title?: string;
+    readonly createdAt: number;
+    readonly live: boolean;
+    readonly unreadable: boolean;
+    /** Log unread because the browse budget was spent (placeholder node). */
+    readonly unloaded: boolean;
+}
+/** Per-session rewind UX facts, derived from the loaded events at build time. */
+export interface SessionRewindFacts {
+    /** Own turns in seq order. A turn whose start was trimmed away (coverage /
+     *  budget head cut) has no range — its entries find no match and the
+     *  confirm UX stays silent rather than guessing. */
+    readonly turns: readonly TurnRange[];
+    /** Own entries displayed for this session. */
+    readonly ownEntries: number;
+    /** The loaded events reach the log tip (see FamilySession.tailComplete). */
+    readonly tailComplete: boolean;
+    /** Adopt-this-branch fork target: the log's last turn/end seq. Only set
+     *  when tailComplete holds and a closed turn exists — a tail-cut read's
+     *  last turn/end is NOT the branch tip, and forking there would silently
+     *  drop the unseen tail the user means to keep. */
+    readonly tipBoundary?: number;
+}
+/** One own turn of a session, as far as the loaded events show it. */
+export interface TurnRange {
+    /** turn/start seq. */
+    readonly start: number;
+    /** turn/end seq, or the last loaded event's seq while the turn is open. */
+    readonly end: number;
+    /** Displayable own entries inside (start, end]. */
+    readonly entries: number;
+    /** The turn/end was seen (an open turn's end is only the loaded tail). */
+    readonly closed: boolean;
+}
+/**
+ * Everything the browser shows for one session, and nothing that costs an
+ * unbounded read to learn.
+ *
+ * That second half is an invariant, not an accident: every field here comes
+ * from the persistence header, one `stat`, or a bounded window at one end of
+ * the log. A session's full statistics (turn counts, tool totals, token spend)
+ * require folding the entire event log, which is what the trajectory scene is
+ * for — the browser stays responsive on a 4 MB log because it never asks a
+ * question that big.
+ */
+export interface SessionSummary {
+    readonly id: string;
+    readonly kind: SessionKind;
+    readonly title: SessionTitle;
+    /** Working directory recorded in the header; '' when it recorded none. */
+    readonly cwd: string;
+    readonly createdAt: number;
+    /**
+     * Last activity: the later of the log's own mtime and this install's
+     * last-used note. Both are lower bounds on "when this session was last
+     * touched" — the mtime catches writes by another client (dsh web appends to
+     * the same store), the note catches a resume this install performed. The
+     * later of two lower bounds is the best available answer, and unlike a
+     * composite value there is no risk of stitching halves from different
+     * origins: this is one scalar with two witnesses.
+     */
+    readonly updatedAt: number;
+    /** Log size in bytes; undefined when the backend owns no per-session file. */
+    readonly bytes: number | undefined;
+    /**
+     * Whether the log holds a human message (including image-only input), or
+     * the read was inconclusive. False requires a complete successful scan;
+     * unknown logs must stay visible and out of empty-session cleanup.
+     *
+     * `list()` reports *materialized* sessions, not conversations: a session
+     * that only ever recorded its own boot policy is a real stored session with
+     * nothing to resume. Answering this is the consumer's job — the header does
+     * not promise it — and getting it wrong is why one empty row per launch used
+     * to accumulate in the picker.
+     */
+    readonly hasPrompt: boolean;
+    /** Agent preset the session was composed from, when the deployment records one. */
+    readonly agentPreset: string | undefined;
+    /** Model last seen in the log's trailing window, when one is recorded. */
+    readonly model: string | undefined;
+    /** Sub-agent label from the run's descriptor (`subagent` kind only). */
+    readonly label: string | undefined;
+    /** Git branch noted when this install last used the session. */
+    readonly branch: string | undefined;
+    /** How many sub-agent runs name this session as their parent. */
+    readonly childCount: number;
+}
+/**
+ * What the TUI knows about a persisted session before opening it.
+ *
+ * The shape here is the whole point of this feature. The picker used to run on
+ * `{ id, title, cwd, createdAt, updatedAt }`, and every defect it had was
+ * downstream of that: it could not tell a delegated sub-agent run from a
+ * conversation because it never carried the distinction, and it could not show
+ * why a row was labelled the way it was because the label arrived without its
+ * provenance. So the types below carry both — the kind as a closed sum, and
+ * every derived label together with the evidence that produced it.
+ *
+ * @module @deepseek-harness-tui/dsh-tui/sessions/types
+ */
+/**
+ * What a persisted session *is*, decided once from its immutable header.
+ *
+ * A closed sum rather than a pair of booleans: `isSubagent`/`isFork` would
+ * admit a fourth, meaningless combination, and every reader would have to
+ * re-derive the precedence between them. Deciding once, here, is also the fix
+ * for the defect that started this work — `origin` and `parentSession` reached
+ * the picker and were dropped on the floor.
+ *
+ * The discriminator is `origin`, never `parentSession`. A `/rewind` fork
+ * carries `parentSession` and no `origin`, so filtering on lineage alone would
+ * silently hide the user's own rewound branches along with the sub-agents.
+ */
+export type SessionKind = 
+/** A conversation the user started. */
+{
+    readonly kind: 'root';
+}
+/**
+ * A `/rewind` fork: a real conversation that inherited a prefix of its
+ * parent's log. `parent` is what defines it, so it is never absent.
+ */
+ | {
+    readonly kind: 'fork';
+    readonly parent: string;
+}
+/**
+ * A delegated sub-agent run. `origin: 'subagent'` is the authority, so the
+ * lineage link is reported as it is found — a run whose header records no
+ * parent is still a sub-agent run.
+ */
+ | {
+    readonly kind: 'subagent';
+    readonly parent: string | undefined;
+    readonly depth: number;
+};
+/**
+ * A display title and the evidence behind it.
+ *
+ * The source travels with the text because the UI consumes it: a `fallback`
+ * title is dimmed rather than presented as if the session were named that, and
+ * a reader who wonders why a row carries a fallback label can be told. A source that
+ * nothing consumed would be decoration; this one changes what is rendered.
+ */
+export interface SessionTitle {
+    readonly text: string;
+    readonly source: TitleSource;
+}
+/** Which evidence produced a session's display title. */
+export type TitleSource = 
+/** A `session/title` event appended after the session's own opening — a rename. */
+'renamed'
+/** The session's first `session/title`, written for it automatically. */
+ | 'auto'
+/** No title event; the opening user prompt stands in. */
+ | 'prompt'
+/** Nothing readable; the working directory's basename stands in. */
+ | 'fallback';
+/** One exchange in the preview pane, newest last. */
+export interface PreviewEntry {
+    readonly role: 'user' | 'assistant';
+    readonly text: string;
+    readonly at: number | undefined;
+}
+//# sourceMappingURL=channel-session.d.ts.map

package/lib/types/adapter/ports/channel-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-session.d.ts","sourceRoot":"","sources":["../../../../src/adapter/ports/channel-session.ts"],"names":[],"mappings":"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"}

package/lib/types/adapter/ports/channel-session.js

@@ -0,0 +1,2 @@
+/** Host-owned in-process Channel contract. No runtime or upstream imports. */
+export {};