@linxiraos/pi-tui 1.3.2 → 1.4.1

package/dist/types/overlays/approval-dialog.d.ts

@@ -1,7 +1,8 @@
 /**
  * Tool-approval prompt in the composer's place, presented like the ask
  * dialog: the approval title and its details over a list of choices —
- * Approve, an optional "approve for this session", and Deny — and an action
+ * optional grants (led by a toggle that keeps them across sessions), Approve,
+ * an optional "approve for this session", and Deny — and an action
  * bar. The arrows move between the choices and Enter takes the highlighted
  * one; `app.approval.approve` (Ctrl+Enter by default) approves this call
  * outright and Esc denies. Enter and the approve chord only arm
@@ -23,6 +24,13 @@ interface ApprovalDialogCallbacks {
     onApprove(): void;
     onDeny(): void;
 }
+/** A choice that approves the call and remembers more than it: a folder, or the exact target. */
+export interface ApprovalDialogGrant {
+    /** Label while the grant is remembered for this session. */
+    readonly label: string;
+    /** Label once the remember toggle keeps it across sessions. */
+    readonly alwaysLabel: string;
+}
 /** The composer mounted beneath the dialog: it receives every key the dialog does not own. */
 export interface ApprovalDialogDraft {
     /** True while the composer holds a draft — text, attachments, or a paste still landing: keys then edit and send it. */
@@ -48,6 +56,12 @@ interface ApprovalDialogOptions {
         label: string;
         onApprove(): void;
     };
+    /**
+     * Grants to offer above Approve, led by a toggle that keeps them across sessions; Approve then
+     * reads "Approve Once". `onGrant` gets the chosen grant and whether the toggle was on.
+     */
+    grants?: readonly ApprovalDialogGrant[];
+    onGrant?(grant: ApprovalDialogGrant, always: boolean): void;
 }
 export declare class ApprovalDialogComponent implements Component {
     #private;

package/dist/types/overlays/jobs-panel.d.ts

@@ -1,6 +1,7 @@
 import type { Component } from "../tui.js";
 import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
 import { type JobTreeAgent } from "./job-tree.js";
+import { type JobWidgetView } from "../tools/job-widget.js";
 /** One async job as the session snapshots it. */
 export interface JobsPanelJob {
     readonly id: string;
@@ -35,6 +36,8 @@ export interface JobsPanelDetail {
     readonly output?: string;
     /** Artifact holding the full output when `output` is cut. */
     readonly artifactId?: string;
+    /** The job's live widget (frozen once it settles), drawn above the output. */
+    readonly widget?: JobWidgetView;
 }
 /** The session behind a {@link JobsSheet}. */
 export interface JobsSheetSource {

package/dist/types/overlays/model-browser.d.ts

@@ -7,7 +7,7 @@ import { type ThemeColor } from "../theme/theme.js";
 import type { TspPickerColumn, TspPickerGroup, TspPickerItem, TspPickerMark } from "@linxiraos/pi-wire";
 import type { NativeChild, NativeNode, NativeUiEvent } from "../native/node.js";
 /** Canonical display ordering of built-in model roles. */
-export type ModelRole = "default" | "smol" | "slow" | "vision" | "plan" | "commit" | "tiny" | "memory" | "task" | "advisor" | "image" | "web" | "speech" | "dictation" | "judge";
+export type ModelRole = "default" | "smol" | "slow" | "vision" | "plan" | "commit" | "tiny" | "memory" | "task" | "advisor" | "widget" | "image" | "web" | "speech" | "dictation" | "judge";
 export declare const MODEL_ROLE_IDS: ModelRole[];
 export declare const CHAT_MODEL_ROLE_IDS: ModelRole[];
 export declare const KIND_ROLE_IDS: ModelRole[];

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;