@xmoon76/dsh-pi-tui 0.1.5 → 0.1.7

package/dist/index.d.mts

@@ -1,5 +1,6 @@
 import z from "@deepseek-ai/schemastery";
 import { Agent, ModelSelectionRef } from "@deepseek-ai/dsh-agent";
+import { ContentBlock } from "@deepseek-ai/dsh-llm";
 import { SessionEvent, SessionId } from "@deepseek-ai/dsh-session";
 import { CommandDescriptor } from "@deepseek-ai/dsh-commands";
 import { EventEmitter } from "events";
@@ -14,6 +15,20 @@ interface Diag {
   dispose(): void;
 }
 //#endregion
+//#region src/tui-app.d.ts
+/** One queued inbox row for the queue pane (mirrors the agent Inbox's lists). */
+interface QueueItem {
+  /** The pending message id (agent inbox identity). */
+  id: string;
+  /** The message text, single-line display form. */
+  text: string;
+  /** next-turn followup vs next-step steer. */
+  mode: 'followup' | 'steer';
+  /** Plugin notice (e.g. a background-job completion): NOT steerable — it
+   * renders with its own marker and the hint drops the steer verbs. */
+  notice?: boolean;
+}
+//#endregion
 //#region src/skill-catalog.d.ts
 /**
  * The standing-scope skill catalog adapter: the SINGLE narrow seam between
@@ -162,6 +177,24 @@ declare function shouldSteerOnEnter(parsed: {
 declare function shouldConsumeAdvertisedMiss(execution: {
   readonly result: unknown;
 } | undefined, wasAdvertised: boolean): boolean;
+/** One unsettled subagent delegation, in tool/call order. */
+interface PendingSubagentCall {
+  readonly callId: string;
+  readonly description: string;
+}
+/**
+ * Match the child a user is about to view against the unsettled subagent
+ * calls (pure, exported for the headless suite). The child's durable label
+ * is the delegation's `description`; duplicate descriptions take the MOST
+ * RECENT call (the one the user is most likely watching), an empty/absent
+ * label falls back to a LONE pending call, and no match disables the
+ * auto-pop (the user exits the viewer with Esc as before — never a wrong
+ * pop). Mutates `pending` by removing the matched call.
+ * @param pending - the unsettled calls, in order (oldest first).
+ * @param label - the child's durable label; '' or undefined = no description.
+ * @returns the matched call, or undefined when nothing matches.
+ */
+declare function matchPendingSubagentCall(pending: PendingSubagentCall[], label: string | undefined): PendingSubagentCall | undefined;
 /**
  * The pre-mount surface catalog resolution:
  * - an explicit `--session` start PREFETCHES the resumed agent's effective
@@ -212,6 +245,73 @@ declare function resolveInitialCatalog(options: ResolveInitialCatalogOptions): P
 declare function subagentJobTranscriptId(snapshot: unknown): string | undefined;
 /** Viewer body for a subagent job with no uniquely matched child. */
 declare function subagentJobViewHint(status: string, detail: string | undefined): string;
+/** The message-source projection the queue filter reads (a structural subset
+ * of dsh's message sources, so the helpers are testable without dsh types). */
+interface QueueNoticeSource {
+  readonly form?: string;
+  readonly kind?: string;
+  readonly summary?: string;
+}
+/**
+ * Whether a plain submitted draft is the quit word: exactly `exit` (trimmed,
+ * lowercase). The runner intercepts this BEFORE any session creation or
+ * submission (shell muscle memory); anything else — `exit!`, `Exit`, or a
+ * draft with a recalled entry still in it — is an ordinary message.
+ * @param text - the submitted draft.
+ */
+declare function isPlainExitPrompt(text: string): boolean;
+/**
+ * Whether an inbox message is a BACKGROUND-SUBAGENT settlement notice — the
+ * runtime's account of a child ending, not steerable user input. Two dsh
+ * producers push these into the parent's inbox:
+ *  - continuable children: `source.kind === 'subagent-settled'` (the
+ *    continuation manager's settlement notice);
+ *  - one-shot background subagent jobs: tool-jobs completion notices whose
+ *    summary starts with the job kind (`subagent <label> [status: …]`).
+ * The queue pane mirrors the inbox, but these belong to the task browser
+ * (terminal job rows / inactive child rows), so the mirror drops them and
+ * only failures surface as a transient error notify.
+ * @param source - the message source projection, or undefined for a plain row.
+ */
+declare function isSubagentSettlementNotice(source: QueueNoticeSource | undefined): boolean;
+/**
+ * Whether a subagent settlement notice reports FAILURE, classified on the
+ * producers' own deterministic wording:
+ *  - `subagent-settled` summaries: "finished and will do no further work"
+ *    is the only success wording; aborted / max-tokens / refusal / error /
+ *    unknown endings all fail;
+ *  - tool-jobs subagent summaries carry the terminal status line, whose
+ *    failure statuses are `failed` and `killed` (dsh JobStatus).
+ * A notice that cannot be classified is treated as success (silent).
+ * @param source - the message source projection.
+ */
+declare function subagentNoticeIsFailure(source: QueueNoticeSource | undefined): boolean;
+/** One inbox message as the queue mirror sees it (a structural projection). */
+interface QueueInboxMessage {
+  readonly id: string;
+  readonly content: readonly ContentBlock[];
+  readonly source?: QueueNoticeSource;
+}
+/** The mirror result for one inbox batch: the rows to show plus the failed
+ * settlement summaries the caller should notify (each once). */
+interface QueueFoldResult {
+  /** Queue rows (background-subagent settlement notices excluded). */
+  readonly rows: QueueItem[];
+  /** Failed settlement summaries not yet notified (the caller notifies). */
+  readonly failures: readonly string[];
+}
+/**
+ * Build the queue-pane rows for one inbox batch, dropping background-subagent
+ * settlement notices (the task browser is their surface) and reporting which
+ * FAILED settlements should notify. Pure and injectable so the filter +
+ * once-notify semantics are testable without the agent.
+ * @param messages - one inbox batch (next-turn or next-step), in order.
+ * @param mode - the delivery mode for surviving rows.
+ * @param notified - the notify-once guard; failed notices already in it are
+ *   skipped, and a newly-reported id is ADDED here so a re-render can never
+ *   double-notify.
+ */
+declare function foldQueueRows(messages: readonly QueueInboxMessage[], mode: 'followup' | 'steer', notified: Set<string>): QueueFoldResult;
 /**
  * Whether a shell command matches a destructive pattern. `rm` is treated
  * specially: any spelling of recursive + force flags (`rm -rf`, `rm -r -f`,
@@ -237,6 +337,17 @@ declare function runningProfile(argv?: readonly string[], fallback?: string): st
  * @returns the resume command line, or undefined without a session.
  */
 declare function resumeCommand(profile: string, sessionId: string): string | undefined;
+/**
+ * A launch-time open-lock refusal: the requested session is held by another
+ * live dsh process (or its lock cannot be verified). Unlike a stale/missing
+ * session id, this is NOT recoverable by falling back to a fresh session —
+ * the user asked for a specific session and must resolve the holder first.
+ * Thrown from the resume path and re-thrown past the resume catch so the
+ * runner exits with the refusal as the error message.
+ */
+declare class SessionLockRefusedError extends Error {
+  constructor(message: string);
+}
 /** One agent's preset composition: the id to record and the setup that installs it. */
 interface AgentComposition {
   /** Preset id for the session header, absent when the deployment composes no roster. */
@@ -312,4 +423,4 @@ declare function recomposeBlank(ctx: Context, agent: {
  */
 declare function apply(ctx: Context, config: Config): void;
 //#endregion
-export { AgentComposition, Config, InitialCatalogResolution, LOCAL_COMMANDS, RecomposableSession, RecomposeOutcome, ResolveInitialCatalogOptions, SESSIONLESS_COMMANDS, apply, composeAgent, dangerCommand, forkSeed, inject, name, recomposeBlank, recordedPreset, resolveInitialCatalog, resumeCommand, runningProfile, shouldConsumeAdvertisedMiss, shouldSteerOnEnter, subagentJobTranscriptId, subagentJobViewHint };
+export { AgentComposition, Config, InitialCatalogResolution, LOCAL_COMMANDS, PendingSubagentCall, QueueFoldResult, QueueInboxMessage, QueueNoticeSource, RecomposableSession, RecomposeOutcome, ResolveInitialCatalogOptions, SESSIONLESS_COMMANDS, SessionLockRefusedError, apply, composeAgent, dangerCommand, foldQueueRows, forkSeed, inject, isPlainExitPrompt, isSubagentSettlementNotice, matchPendingSubagentCall, name, recomposeBlank, recordedPreset, resolveInitialCatalog, resumeCommand, runningProfile, shouldConsumeAdvertisedMiss, shouldSteerOnEnter, subagentJobTranscriptId, subagentJobViewHint, subagentNoticeIsFailure };