@linxiraos/pi-tui 1.3.1 → 1.4.0

package/dist/types/overlays/session-selector.d.ts

@@ -1,6 +1,7 @@
 import { type Component, Input } from "../index.js";
 import type { TspPickerGroup, TspPickerItem } from "@linxiraos/pi-wire";
 import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
+import { type ResumeSourceLike } from "./resume-picker.js";
 /** Session lifecycle status presented by the picker. */
 export type SessionSelectorStatus = "complete" | "interrupted" | "aborted" | "error" | "pending" | "unknown";
 /** Session listing fields consumed by the picker. */
@@ -18,6 +19,8 @@ export interface SessionSelectorEntry {
     /** Path to the parent session when this one was forked. */
     parentSessionPath?: string;
 }
+import { ResumeTreeComponent } from "./resume-tree.js";
+export type { ResumeConversationLike, ResumeDirectoryLike, ResumeProjectLike, ResumeQueryLike, ResumeScopeInputLike, ResumeScopeKindLike, ResumeSourceLike, ResumeViewLike, ResumeViewRowLike, ResumeWorkspaceLike, } from "./resume-picker.js";
 import { OverlayPanel } from "../chrome/overlay-box.js";
 /** The session list's part of the picker props, plus the memo keys it was built from. */
 interface SessionPickerView {
@@ -76,6 +79,11 @@ declare class SessionList<T extends SessionSelectorEntry> implements Component {
     constructor(sessions: T[], showCwd?: boolean, historyMatcher?: SessionHistoryMatcher, getTerminalRows?: () => number, pinnedIds?: ReadonlySet<string>, currentSessionPath?: string | (() => string | undefined));
     /** Replace the visible dataset, e.g. when toggling folder/all-projects scope. */
     setSessions(sessions: T[], showCwd: boolean, pinnedIds?: ReadonlySet<string>): void;
+    /**
+     * Resume-model mode: the given sessions are already the model's ordered,
+     * filtered view, so mirror them and keep the selection when it survives.
+     */
+    syncSessions(sessions: readonly T[], preferredPath?: string | null): void;
     /** Cancel pending async search work; idempotent, called on every picker exit path. */
     dispose(): void;
     removeSession(sessionPath: string): void;
@@ -125,6 +133,17 @@ export interface SessionSelectorOptions<T extends SessionSelectorEntry = Session
     loadAllSessions?: () => Promise<T[]>;
     /** Preloaded all-projects list; cached so the first Tab toggle is instant. */
     allSessions?: T[];
+    /**
+     * The host's resume model (project → workspace → conversation) and its
+     * pure view builder. When set, the native `picker` describes the resume
+     * tree instead of the flat day-grouped list; the ANSI path is unchanged.
+     */
+    resumeSource?: ResumeSourceLike;
+    /**
+     * What delete does to the session file: an in-session picker moves it to
+     * the trash, `--resume` deletes it permanently. Wording only.
+     */
+    deleteMode?: "trash" | "permanent";
     /** Picker heading; defaults to "Resume Session". */
     title?: string;
     /** Primary action label; defaults to "Resume" (ANSI footer defaults to "select"). */
@@ -160,9 +179,7 @@ export interface SessionSelectorOptions<T extends SessionSelectorEntry = Session
      */
     standalone?: boolean;
 }
-/**
- * Component that renders a session selector with optional confirmation dialog
- */
+/** Component that renders a session selector with optional confirmation dialog. */
 export declare class SessionSelectorComponent<T extends SessionSelectorEntry = SessionSelectorEntry> extends OverlayPanel {
     #private;
     constructor(sessions: T[], onSelect: (session: T) => void, onCancel: () => void, onExit: () => void, options?: SessionSelectorOptions<T>);
@@ -196,5 +213,6 @@ export declare class SessionSelectorComponent<T extends SessionSelectorEntry = S
     handleNativeEvent(event: NativeUiEvent): void;
     handleInput(keyData: string): void;
     getSessionList(): SessionList<T>;
+    /** The ANSI resume tree when the host supplied a resume source. */
+    getResumeTree(): ResumeTreeComponent | undefined;
 }
-export {};

package/dist/types/terminal-capabilities.d.ts

@@ -18,7 +18,7 @@ export declare enum NotifyProtocol {
     Osc99 = "\u001B]99;;",
     Osc9 = "\u001B]9;"
 }
-export type TerminalId = "kitty" | "ghostty" | "wezterm" | "iterm2" | "vscode" | "alacritty" | "warp" | "orca" | "otty" | "rio" | "tern" | "monstar" | "base" | "trueColor";
+export type TerminalId = "kitty" | "ghostty" | "wezterm" | "iterm2" | "vscode" | "alacritty" | "warp" | "orca" | "otty" | "rio" | "tern" | "monstar" | "zetawork" | "base" | "trueColor";
 /** Terminal capability details used for rendering and protocol selection. */
 export declare class TerminalInfo {
     readonly id: TerminalId;

package/dist/types/tools/hub.d.ts

@@ -123,6 +123,8 @@ export interface CoordinationDetails {
     }[];
     /** Running subagents not represented by a job row in this result. */
     agents?: AgentActivitySnapshot[];
+    /** `wait` returned early because blocking would deadlock (mesh S6). */
+    status?: "peer-waiting-on-you";
 }
 /** Hub result details: coordination snapshots or launch (process) state. */
 export type HubDetails = CoordinationDetails | LaunchToolDetails;
@@ -204,7 +206,7 @@ export interface IrcMessage {
 /** Delivery outcome for one peer recipient. */
 export interface IrcDeliveryReceipt {
     to: string;
-    outcome: "injected" | "woken" | "revived" | "failed";
+    outcome: "injected" | "woken" | "revived" | "queued" | "failed";
     error?: string;
 }
 /** Broker-facing launch parameters; the hub adapts its `ps` op to `list` before calling in. */

package/dist/types/tools/irc.d.ts

@@ -23,7 +23,11 @@ export interface IrcMessage {
 /** Delivery outcome for one peer recipient. */
 export interface IrcDeliveryReceipt {
     to: string;
-    outcome: "injected" | "woken" | "revived" | "failed";
+    /**
+     * `queued` is the cross-process offline path: the message is in the peer's
+     * persistent mailbox and will be injected when its process next starts.
+     */
+    outcome: "injected" | "woken" | "revived" | "queued" | "failed";
     error?: string;
 }
 /** Status ordering for peer rosters in child prompts. */

package/dist/types/tools/wait.d.ts

@@ -96,6 +96,12 @@ export interface CoordinationDetails {
     agents?: AgentActivitySnapshot[];
     /** `wait` was cut short by steering, a peer message, or a completion notice that injects next. */
     interrupted?: boolean;
+    /**
+     * `wait` returned early without a message because continuing would deadlock:
+     * the peer it was waiting on is itself waiting on this agent. Both sides can
+     * keep working — answer the peer, then wait again.
+     */
+    status?: "peer-waiting-on-you";
 }
 /** Pending wait frame. */
 declare function waitRenderCall(_args: object, _options: RenderResultOptions, uiTheme: Theme): Component;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@linxiraos/pi-tui",
-	"version": "1.3.1",
+	"version": "1.4.0",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://linxira-os.github.io/zeta/",
 	"author": "Linxira-OS",
@@ -38,14 +38,14 @@
 		"gen:glyphs": "bun scripts/gen-glyphs.ts"
 	},
 	"dependencies": {
-		"@linxiraos/pi-omptype": "1.3.1",
-		"@linxiraos/pi-agent-core": "1.3.1",
-		"@linxiraos/pi-ai": "1.3.1",
-		"@linxiraos/pi-catalog": "1.3.1",
-		"@linxiraos/pi-natives": "1.3.1",
-		"@linxiraos/pi-utils": "1.3.1",
-		"@linxiraos/pi-wire": "1.3.1",
-		"@linxiraos/pi-snapcompact": "1.3.1"
+		"@linxiraos/pi-omptype": "1.4.0",
+		"@linxiraos/pi-agent-core": "1.4.0",
+		"@linxiraos/pi-ai": "1.4.0",
+		"@linxiraos/pi-catalog": "1.4.0",
+		"@linxiraos/pi-natives": "1.4.0",
+		"@linxiraos/pi-utils": "1.4.0",
+		"@linxiraos/pi-wire": "1.4.0",
+		"@linxiraos/pi-snapcompact": "1.4.0"
 	},
 	"devDependencies": {
 		"kitty-vt-wasm": "^0.2.0"

package/src/apps/session-picker.ts

@@ -1,9 +1,12 @@
 import { logger } from "@linxiraos/pi-utils";
 import {
+	type ResumeSourceLike,
 	SessionSelectorComponent,
-	type SessionSelectorEntry,
 	type SessionHistoryMatcher,
+	type SessionSelectorEntry,
+	type SessionSelectorOptions,
 } from "../overlays/session-selector";
+import type { ResumeTreeSource } from "../overlays/resume-tree";
 import { runStandaloneTui } from "./standalone-picker";
 
 /** Persistence and history capabilities supplied by the session-owning host. */
@@ -12,6 +15,8 @@ export interface SessionPickerHost<T extends SessionSelectorEntry = SessionSelec
 	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. */
@@ -24,6 +29,12 @@ 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";
 }
 
 /**
@@ -51,6 +62,11 @@ export async function selectSession<T extends SessionSelectorEntry>(
 		}
 	}
 
+	const resumeMode = options.resume?.deleteMode;
+	const resumeSource = resumeMode
+		? await host.loadResumeSource?.(resumeMode, options.resume?.workspacePath)
+		: undefined;
+
 	return runStandaloneTui<T | null>(
 		({ ui, finish }) => {
 			const selector = new SessionSelectorComponent(
@@ -73,7 +89,9 @@ export async function selectSession<T extends SessionSelectorEntry>(
 					scopeLabel: options.scopeLabel,
 					showCwd: options.showCwd,
 					pinnedIds,
-				},
+					resumeSource: resumeSource ?? options.resumeSource,
+					deleteMode: resumeMode ?? options.deleteMode,
+				} as SessionSelectorOptions<T> & { resumeSource?: ResumeTreeSource; deleteMode?: "trash" | "permanent" },
 			);
 			selector.setOnRequestRender(() => ui.requestRender());
 			return selector;