@linxiraos/pi-tui 1.3.2 → 1.4.0

package/CHANGELOG.md

@@ -1,8 +1,8 @@
 ## [Unreleased]
 
-## [1.3.2] - 2026-10-19
+## [1.4.0] - 2026-10-21
 
-- Version line moves to 1.3.2 with the rest of the suite; no user-visible change in this package.
+- Added a `zetawork` terminal id that resolves to the Kitty image protocol from the environment alone, so images render in the desktop app's own terminal
 
 ## [9.5.0] - 2026-02-01
 
@@ -187,6 +187,10 @@
 
 Initial release under @oh-my-pi scope. See previous releases at [badlogic/pi-mono](https://github.com/badlogic/pi-mono).
 
+## [1.3.2] - 2026-10-19
+
+- Version line moves to 1.3.2 with the rest of the suite; no user-visible change in this package.
+
 ## [1.3.1] - 2026-10-19
 
 ### Breaking Changes

package/dist/types/apps/session-picker.d.ts

@@ -1,10 +1,13 @@
-import { type SessionSelectorEntry, type SessionHistoryMatcher } from "../overlays/session-selector.js";
+import { type ResumeSourceLike, type SessionHistoryMatcher, type SessionSelectorEntry } from "../overlays/session-selector.js";
+import type { ResumeTreeSource } from "../overlays/resume-tree.js";
 /** Persistence and history capabilities supplied by the session-owning host. */
 export interface SessionPickerHost<T extends SessionSelectorEntry = SessionSelectorEntry> {
     loadPinnedIds?(): Promise<ReadonlySet<string>>;
     loadHistoryMatcher?(): SessionHistoryMatcher;
     deleteSession?(session: T): Promise<boolean>;
     loadAllSessions?(): Promise<T[]>;
+    /** Builds the three-level resume source for the standalone `--resume` tree. */
+    loadResumeSource?(deleteMode: "trash" | "permanent", workspacePath?: string): Promise<ResumeTreeSource | undefined>;
 }
 /** Presentation and capability controls for the standalone session picker. */
 export interface SessionPickerOptions<T extends SessionSelectorEntry = SessionSelectorEntry> {
@@ -16,6 +19,15 @@ export interface SessionPickerOptions<T extends SessionSelectorEntry = SessionSe
     allowGlobalScope?: boolean;
     historySearch?: boolean;
     pinnedIds?: ReadonlySet<string>;
+    /** Opt into the three-level resume tree; `deleteMode` words the confirm step. */
+    resume?: {
+        deleteMode: "trash" | "permanent";
+        workspacePath?: string;
+    };
+    /** The host's resume model; when set, the native picker renders the project tree. */
+    resumeSource?: ResumeSourceLike;
+    /** Delete wording: in-session moves to trash, `--resume` deletes permanently. */
+    deleteMode?: "trash" | "permanent";
 }
 /**
  * Show the TUI session selector and return the selected session, or null if

package/dist/types/overlays/resume-picker.d.ts

@@ -0,0 +1,293 @@
+/**
+ * Native (`picker`) mapping of the resume directory model.
+ *
+ * The coding-agent owns the data model (`ResumeDirectory` / `buildResumeView`:
+ * project → workspace → conversation). pi-tui cannot import it (dependency
+ * direction), so this module declares structurally compatible `*Like` types
+ * and accepts a {@link ResumeSourceLike} the host builds from its real
+ * directory and view builder (the ANSI tree passes the same object). Nothing
+ * here re-groups conversations: the rows come from the model, and this module
+ * only turns them into picker props.
+ */
+import type { TspPickerGroup, TspPickerItem, TspPickerScope } from "@linxiraos/pi-wire";
+import type { SessionSelectorStatus } from "./session-selector.js";
+import type { NativeChild } from "../native/node.js";
+export type ResumeScopeKindLike = "workspace" | "project" | "all";
+export interface ResumeScopeLike {
+    readonly kind: ResumeScopeKindLike;
+    readonly key?: string;
+    readonly projectKey?: string;
+    readonly workspaceKey?: string;
+}
+export type ResumeScopeInputLike = ResumeScopeKindLike | ResumeScopeLike;
+/** Parsed query, as far as the native renderer reads it (the ANSI tree passes a subset). */
+export interface ResumeQueryLike {
+    readonly raw: string;
+    readonly terms?: readonly string[];
+    readonly project?: readonly string[];
+    readonly workspace?: readonly string[];
+    readonly branch?: readonly string[];
+    readonly status?: readonly string[];
+    readonly current?: boolean | null;
+    readonly fork?: boolean | null;
+    readonly pinned?: boolean | null;
+}
+/** The session fields the picker reads; the host's `SessionInfo` supplies all of them. */
+export interface ResumeSessionLike {
+    readonly path: string;
+    readonly id: string;
+    readonly cwd: string;
+    readonly title?: string;
+    readonly modified: Date;
+    readonly size?: number;
+    readonly firstMessage?: string;
+    readonly allMessagesText?: string;
+    readonly status?: SessionSelectorStatus;
+    readonly parentSessionPath?: string;
+    readonly created?: Date;
+    readonly messageCount?: number;
+    readonly assistantTurns?: number;
+    /** Last model recorded in the session (`provider/modelId`), when one was persisted. */
+    readonly model?: string;
+}
+export interface ResumeConversationLike {
+    readonly session: ResumeSessionLike;
+    readonly key: string;
+    readonly id: string;
+    readonly path: string;
+    readonly title: string;
+    readonly cwd: string;
+    readonly projectKey: string;
+    readonly workspaceKey: string;
+    readonly created: Date;
+    readonly modified: Date;
+    readonly status?: SessionSelectorStatus;
+    readonly pinned: boolean;
+    readonly current: boolean;
+    readonly fork: boolean;
+    /** Subagent marker from `session_init.agent`; forks never set it. */
+    readonly isSubagent?: boolean;
+    readonly agentName?: string;
+    readonly parentKey?: string;
+    readonly subagents?: readonly ResumeConversationLike[];
+    readonly messageCount: number;
+}
+export interface ResumeWorkspaceLike {
+    readonly key: string;
+    readonly path: string;
+    readonly name: string;
+    readonly alias?: string | null;
+    readonly displayName?: string;
+    readonly projectKey: string;
+    readonly branch: string | null;
+    readonly isWorktree?: boolean;
+    readonly pinned: boolean;
+    readonly lastActivity: Date | null;
+    /** Flat conversation list; the core model keeps conversations on the directory only. */
+    readonly conversations?: readonly ResumeConversationLike[];
+    readonly counts: {
+        readonly conversations: number;
+        readonly pinnedConversations: number;
+    };
+}
+export interface ResumeProjectLike {
+    readonly key: string;
+    readonly root: string;
+    readonly name: string;
+    readonly alias: string | null;
+    readonly displayName: string;
+    readonly isDefault: boolean;
+    readonly pinned: boolean;
+    readonly removable?: boolean;
+    readonly collapsed: boolean;
+    readonly lastActivity: Date | null;
+    readonly workspaces?: readonly ResumeWorkspaceLike[];
+    readonly conversations?: readonly ResumeConversationLike[];
+    readonly counts: {
+        readonly conversations: number;
+        readonly workspaces: number;
+        readonly pinnedConversations: number;
+    };
+}
+export interface ResumeDirectoryLike {
+    readonly projects: readonly ResumeProjectLike[];
+    readonly workspaces: readonly ResumeWorkspaceLike[];
+    readonly conversations: readonly ResumeConversationLike[];
+    readonly defaultProjectKey: string;
+    readonly defaultWorkspaceKey: string;
+    readonly counts: {
+        readonly projects: number;
+        readonly workspaces: number;
+        readonly conversations: number;
+        readonly pinnedConversations: number;
+    };
+}
+export interface ResumeProjectRowLike {
+    readonly type: "project";
+    readonly key: string;
+    readonly project: ResumeProjectLike;
+    readonly depth?: 0;
+    readonly pinned: boolean;
+    readonly collapsed: boolean;
+    readonly conversationCount: number;
+    readonly totalConversationCount: number;
+    readonly workspaceCount: number;
+    readonly totalWorkspaceCount: number;
+}
+export interface ResumeWorkspaceRowLike {
+    readonly type: "workspace";
+    readonly key: string;
+    readonly workspace: ResumeWorkspaceLike;
+    readonly projectKey: string;
+    readonly depth?: 1;
+    readonly pinned: boolean;
+    readonly conversationCount: number;
+    readonly totalConversationCount: number;
+}
+export interface ResumeConversationRowLike {
+    readonly type: "conversation";
+    readonly key: string;
+    readonly conversation: ResumeConversationLike;
+    readonly projectKey: string;
+    readonly workspaceKey: string;
+    readonly depth?: number;
+    readonly pinned: boolean;
+    readonly current: boolean;
+    readonly score?: number;
+    readonly pinnedOnly?: boolean;
+}
+export type ResumeViewRowLike = ResumeProjectRowLike | ResumeWorkspaceRowLike | ResumeConversationRowLike;
+export interface ResumeViewCountsLike {
+    readonly conversations: number;
+    readonly workspaces?: number;
+    readonly projects?: number;
+    readonly pinnedConversations?: number;
+    readonly totalConversations: number;
+    readonly totalWorkspaces?: number;
+    readonly totalProjects?: number;
+}
+export interface ResumeViewLike {
+    readonly scope: ResumeScopeLike;
+    readonly query: ResumeQueryLike;
+    readonly rows: readonly ResumeViewRowLike[];
+    /** Conversation rows; the ANSI tree leaves it out and read `rows` instead. */
+    readonly conversations?: readonly ResumeConversationRowLike[];
+    readonly counts: ResumeViewCountsLike;
+    readonly referenceBranch?: string | null;
+    readonly currentWorkspaceKey?: string;
+}
+export interface ResumeViewOptionsLike {
+    scope?: ResumeScopeInputLike;
+    query?: string;
+    currentSessionPath?: string;
+}
+/** Names and per-scope conversation totals for the segmented control. */
+export interface ResumeScopeSummaryLike {
+    readonly workspaceName: string;
+    readonly projectName: string;
+    readonly counts: Readonly<Record<ResumeScopeKindLike, number>>;
+}
+/**
+ * The host's resume model: the loaded directory plus its pure view builder.
+ * Shared with the ANSI tree, which supplies the same object; `directory` is
+ * null until the first scan finishes, and `buildView` returns null then.
+ */
+export interface ResumeSourceLike {
+    readonly directory: ResumeDirectoryLike | null;
+    readonly initialScope?: ResumeScopeKindLike;
+    readonly deleteMode?: "trash" | "permanent";
+    buildView(options: ResumeViewOptionsLike): ResumeViewLike | null;
+    scopeSummary?(): ResumeScopeSummaryLike;
+    persistScope?(scope: ResumeScopeKindLike): void | Promise<void>;
+    refresh?(): Promise<void>;
+    pinConversation?(conversation: ResumeConversationLike, pinned: boolean): void | Promise<void>;
+    deleteConversation?(conversation: ResumeConversationLike): boolean | Promise<boolean>;
+    isLoading?(): boolean;
+    loadError?(): string | undefined;
+}
+export declare const RESUME_SCOPE_ORDER: readonly ResumeScopeKindLike[];
+/** The scope after `kind` in the three-way cycle (Tab). */
+export declare function nextResumeScope(kind: ResumeScopeKindLike): ResumeScopeKindLike;
+/** The segmented control's label for a scope kind. */
+export declare function resumeScopeLabel(kind: ResumeScopeKindLike): string;
+/**
+ * Per-scope conversation totals for the segmented control. The host summary
+ * wins when present (the ANSI tree already computes it); otherwise the active
+ * scope's own pre-query total is reused and the other scopes cost one
+ * empty-query view each, so the model's scope resolution (current session →
+ * default workspace) decides the group, not this module.
+ */
+export declare function resumeScopeTabs(source: ResumeSourceLike, active: ResumeViewLike, currentSessionPath: string | undefined): TspPickerScope[];
+/** Assistant turns the session persisted; older listings fall back to the message count. */
+export declare function resumeTurnCount(conversation: ResumeConversationLike): number;
+export interface ResumeItemOptions {
+    /** Show each conversation's working directory (multi-worktree scopes). */
+    readonly showCwd?: boolean;
+    readonly now?: number;
+    /** Branch of the current workspace; a repeated branch stays off the cards. */
+    readonly referenceBranch?: string | null;
+}
+/** One conversation card: the existing facts plus turns, branch and model. */
+export declare function resumePickerItem(row: ResumeConversationRowLike, workspace: ResumeWorkspaceLike | undefined, options?: ResumeItemOptions): TspPickerItem;
+/** Project and workspace section heads followed by their conversations, from the model's rows. */
+export declare function resumePickerOrder(view: ResumeViewLike): (string | TspPickerGroup)[];
+/** Free-text hit ranges for the displayed rows (structured tokens never highlight). */
+export declare function resumePickerHits(view: ResumeViewLike, items: ReadonlyMap<string, TspPickerItem>): Record<string, readonly (readonly [number, number])[]> | undefined;
+/** Catalogue items for every conversation in the target scope (identity stable while typing). */
+export declare function resumePickerItems(catalogue: ResumeViewLike, directory: ResumeDirectoryLike, options?: ResumeItemOptions): {
+    items: TspPickerItem[];
+    byPath: Map<string, TspPickerItem>;
+};
+/** The selected conversation path: the caller's when still visible, else the first row. */
+export declare function resumePickerSelection(view: ResumeViewLike, preferred: string | null | undefined): string | null;
+/**
+ * The same view with locally deleted conversations (and the section heads
+ * left empty by them) removed. Deletes are host-driven; the directory is not
+ * rebuilt per keystroke, so the picker hides the removed rows itself.
+ */
+export declare function resumeViewWithout(view: ResumeViewLike, hidden: ReadonlySet<string>): ResumeViewLike;
+export interface ResumePickerModel {
+    readonly view: ResumeViewLike;
+    readonly catalogue: ResumeViewLike;
+    readonly items: readonly TspPickerItem[];
+    readonly order: readonly (string | TspPickerGroup)[];
+    readonly hits?: Readonly<Record<string, readonly (readonly [number, number])[]>>;
+    readonly tabs: readonly TspPickerScope[];
+    readonly selected: string | null;
+    readonly current: readonly string[];
+    readonly total: number;
+    /** Conversations the filter hides (the ANSI tree stays on screen while filtering). */
+    readonly hidden: number;
+    readonly empty: string;
+    readonly placeholder: string;
+}
+export interface ResumePickerModelOptions {
+    readonly scope: ResumeScopeInputLike;
+    readonly query: string;
+    readonly currentSessionPath?: string;
+    readonly hidden?: ReadonlySet<string>;
+    readonly showCwd?: boolean;
+    readonly now?: number;
+    /** Selection to keep when it survives the query; the first row otherwise. */
+    readonly preferredPath?: string | null;
+}
+/**
+ * Everything the native sheet needs for one scope + query: the model's
+ * filtered view (rows, counts, tokens), a stable catalogue built without the
+ * query, the picker items for it, section order, hits, scope tabs and copy.
+ */
+export declare function buildResumePickerModel(source: ResumeSourceLike, options: ResumePickerModelOptions): ResumePickerModel | undefined;
+/** True when the view carries any filter (free text or structured token). */
+export declare function resumeQueryActive(view: ResumeViewLike): boolean;
+/** The empty pane's copy: no matches while filtering, else the scope's own empty wording. */
+export declare function resumeEmptyText(view: ResumeViewLike): string;
+/** The search field's placeholder for the active scope (names come from the host summary). */
+export declare function resumePlaceholder(source: ResumeSourceLike, scope: ResumeScopeInputLike): string;
+/** The selected conversation's preview: project, workspace, branch, status, model, then the excerpt. */
+export declare function resumeConversationPreview(conversation: ResumeConversationLike, project: ResumeProjectLike | undefined, workspace: ResumeWorkspaceLike | undefined): NativeChild[];
+/** Project/workspace lookups for a conversation path, derived from the directory (no re-grouping). */
+export declare function resumeConversationContext(directory: ResumeDirectoryLike, path: string): {
+    conversation: ResumeConversationLike;
+    project: ResumeProjectLike | undefined;
+    workspace: ResumeWorkspaceLike | undefined;
+} | undefined;