@timurproko/a1 0.1.8-dev.563 → 0.1.8-dev.572

package/dist/integrations/pi/components/shell-footer-status.d.ts

@@ -1,7 +1,8 @@
 import type { OwnedUiSessionViewModel } from "../../../contracts/owned-ui/index.js";
-import { type PiShellViewComponentPort, type PiShellStatusPort, type PiShellQueuedInputPort, type PiShellHeaderPort, type PiShellResourceEntry, type PiShellLoadedResourcesPort, type PiShellHeaderOptions, type PiShellEditorOptions } from "./shell-shared-facade.js";
+import { type KeybindingsConfig } from "./upstream/adjacent/core/keybindings.js";
+import { type PiShellViewComponentPort, type PiShellStatusPort, type PiShellProgressStatusPresentation, type PiShellQueuedInputPort, type PiShellHeaderPort, type PiShellResourceEntry, type PiShellLoadedResourcesPort, type PiShellHeaderOptions, type PiShellEditorOptions } from "./shell-shared-facade.js";
 export declare function createPiShellHeader(options?: PiShellHeaderOptions): PiShellHeaderPort;
 export declare function createPiShellLoadedResources(resources: readonly PiShellResourceEntry[], initialExpanded?: boolean): PiShellLoadedResourcesPort;
-export declare function createPiShellStatus(view: OwnedUiSessionViewModel, formatProgressStatus: (message: string) => string, runtime?: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">): PiShellStatusPort;
+export declare function createPiShellStatus(view: OwnedUiSessionViewModel, progressStatus: PiShellProgressStatusPresentation, runtime?: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">): PiShellStatusPort;
 export declare function createPiShellFooter(view: OwnedUiSessionViewModel, cwd: string, profile?: "pi" | "a1", showLevel?: () => boolean): PiShellViewComponentPort;
-export declare function createPiQueuedInputStatus(submissions: readonly string[], presentation?: "pinned" | "custom-viewport"): PiShellQueuedInputPort;
+export declare function createPiQueuedInputStatus(submissions: readonly string[], presentation?: "pinned" | "custom-viewport", getKeybindings?: () => KeybindingsConfig): PiShellQueuedInputPort;

package/dist/integrations/pi/components/shell-footer-status.js

@@ -2,7 +2,7 @@ import { rawKeyHint, VERSION } from "../startup-public.js";
 import { Spacer, Text, } from "@earendil-works/pi-tui";
 import { SessionFooter } from "./upstream/components/session-footer.js";
 import { KeybindingsManager } from "./upstream/adjacent/core/keybindings.js";
-import { WorkingStatusIndicator } from "./upstream/components/status-indicator.js";
+import { StatusIndicator, WorkingStatusIndicator } from "./upstream/components/status-indicator.js";
 import { PINNED_PI_LAYOUT, piTheme, } from "./theme.js";
 import { createTuiFacade, ensureTheme, } from "./shell-shared-facade.js";
 export function createPiShellHeader(options = {}) {
@@ -70,15 +70,15 @@ export function createPiShellLoadedResources(resources, initialExpanded = false)
         invalidate() { },
     };
 }
-export function createPiShellStatus(view, formatProgressStatus, runtime) {
+export function createPiShellStatus(view, progressStatus, runtime) {
     ensureTheme();
     const statusUi = createTuiFacade(runtime ?? { getColumns: () => 80, getRows: () => 24, requestRender() { } });
     let workingOverride;
     let outputPad = PINNED_PI_LAYOUT.outputPad;
     let progressPresentation = "pinned";
     let placement = statusPlacement(view, workingOverride);
-    const liveStatusText = () => formatProgressStatus(liveWorkingText(view, workingOverride, progressPresentation));
-    let component = statusComponent(view, statusUi, outputPad, liveStatusText, placement);
+    const liveStatusText = () => progressStatus.text(liveWorkingText(view, workingOverride, progressPresentation), progressPresentation);
+    let component = statusComponent(view, statusUi, outputPad, liveStatusText, placement, progressPresentation, progressStatus);
     let signature = statusSignature(view, workingOverride, outputPad, placement, progressPresentation);
     const rebuild = () => {
         const nextPlacement = statusPlacement(view, workingOverride);
@@ -86,7 +86,10 @@ export function createPiShellStatus(view, formatProgressStatus, runtime) {
         if (nextSignature === signature)
             return;
         // Performance: progress ticks change only the live message; the spinner keeps its frame and timer.
-        if (placement === "live" && nextPlacement === "live" && component instanceof WorkingStatusIndicator
+        const componentMatchesPresentation = progressPresentation === "custom-viewport"
+            ? component instanceof OwnedWorkingStatusIndicator
+            : component instanceof WorkingStatusIndicator;
+        if (placement === "live" && nextPlacement === "live" && component instanceof StatusIndicator && componentMatchesPresentation
             && statusSignature(view, workingOverride, outputPad, nextPlacement, progressPresentation, false)
                 === statusSignature(view, workingOverride, outputPad, placement, progressPresentation, false)) {
             component.setMessage(liveStatusText());
@@ -97,7 +100,7 @@ export function createPiShellStatus(view, formatProgressStatus, runtime) {
             component.dispose();
         placement = nextPlacement;
         signature = nextSignature;
-        component = statusComponent(view, statusUi, outputPad, liveStatusText, placement);
+        component = statusComponent(view, statusUi, outputPad, liveStatusText, placement, progressPresentation, progressStatus);
     };
     return {
         render: width => component?.render(width) ?? [],
@@ -138,14 +141,27 @@ export function createPiShellFooter(view, cwd, profile = "pi", showLevel = () =>
         dispose: () => footer.dispose(),
     };
 }
-export function createPiQueuedInputStatus(submissions, presentation = "pinned") {
-    const text = new Text(queuedInputText(submissions, presentation), 1, 0);
+export function createPiQueuedInputStatus(submissions, presentation = "pinned", getKeybindings) {
+    let renderedText = queuedInputText(submissions, presentation, getKeybindings?.());
+    const text = new Text(renderedText, 1, 0);
+    const refresh = () => {
+        const next = queuedInputText(submissions, presentation, getKeybindings?.());
+        if (next === renderedText)
+            return;
+        renderedText = next;
+        text.setText(next);
+    };
     return {
-        render: width => submissions.length === 0 ? [] : text.render(width),
+        render(width) {
+            if (submissions.length === 0)
+                return [];
+            refresh();
+            return text.render(width);
+        },
         invalidate: () => text.invalidate(),
         update(next) {
             submissions = next;
-            text.setText(queuedInputText(next, presentation));
+            refresh();
         },
     };
 }
@@ -168,9 +184,23 @@ function liveWorkingText(view, workingOverride, progressPresentation) {
         ? `${message}(${progress}%)`
         : message;
 }
-function statusComponent(view, ui, outputPad, liveStatusText, placement) {
+class OwnedWorkingStatusIndicator extends StatusIndicator {
+    constructor(ui, message, frame) {
+        let phase = -1;
+        super("working", ui, spinner => {
+            phase += 1;
+            return piTheme().fg("accent", spinner);
+        }, text => frame(text, phase, {
+            muted: value => piTheme().fg("muted", value),
+            accent: value => piTheme().fg("accent", value),
+        }), message);
+    }
+}
+function statusComponent(view, ui, outputPad, liveStatusText, placement, progressPresentation, progressStatus) {
     if (placement === "live") {
-        return new WorkingStatusIndicator(ui, liveStatusText());
+        return progressPresentation === "custom-viewport"
+            ? new OwnedWorkingStatusIndicator(ui, liveStatusText(), progressStatus.frame)
+            : new WorkingStatusIndicator(ui, liveStatusText());
     }
     if (placement === "dock") {
         if (view.lifecycle === "failed") {
@@ -184,7 +214,7 @@ function statusSignature(view, workingOverride, outputPad, placement, progressPr
     const message = withMessage ? `${workingOverride ?? ""}\u0000${view.status.workingMessage ?? ""}\u0000${view.status.workingProgress ?? ""}` : "";
     return `${placement}\u0000${outputPad}\u0000${view.lifecycle}\u0000${progressPresentation}\u0000${message}\u0000${view.status.diagnostics.at(-1) ?? ""}`;
 }
-function queuedInputText(submissions, presentation) {
+function queuedInputText(submissions, presentation, bindings) {
     if (submissions.length === 0)
         return "";
     const theme = piTheme();
@@ -192,11 +222,19 @@ function queuedInputText(submissions, presentation) {
         return submissions.map(submission => theme.fg("muted", `Steering: ${submission.replaceAll("\n", " ⏎ ")}`)).join("\n");
     }
     const messages = submissions.map(submission => theme.fg("dim", `Steering: ${submission.replaceAll("\n", " ⏎ ")}`));
-    const dequeueHint = theme.fg("dim", "↳ Alt+Up to edit all queued messages");
+    const keys = KeybindingsManager.fromOwnedBindings(bindings).getKeys("app.message.dequeue");
+    const label = keys.length === 0 ? "Unbound" : keys.map(displayKeybinding).join("/");
+    const dequeueHint = theme.fg("dim", `↳ ${label} to edit all queued messages`);
     // Compatibility: the custom viewport matches Pi's interactive queue presentation while the
     // comparison shell remains byte-for-byte compatible with its pinned fixture.
     return ["", ...messages, dequeueHint].join("\n");
 }
+function displayKeybinding(key) {
+    return key.split("+").map(part => {
+        const display = process.platform === "darwin" && part.toLowerCase() === "alt" ? "option" : part;
+        return display.charAt(0).toUpperCase() + display.slice(1);
+    }).join("+");
+}
 function compactHeaderText() {
     const theme = piTheme();
     const instructions = [
@@ -231,7 +269,7 @@ function expandedHeaderText(bindings) {
         rawKeyHint("!", "to run bash"),
         rawKeyHint("!!", "to run bash (no context)"),
         rawKeyHint("alt+enter", "to queue follow-up"),
-        rawKeyHint("alt+up", "to edit all queued messages"),
+        rawKeyHint(keys === undefined ? "alt+up" : keys.getKeys("app.message.dequeue").join("/") || "unbound", "to edit all queued messages"),
         rawKeyHint(process.platform === "win32" ? "alt+v" : "ctrl+v", "to paste image (with text fallback)"),
         rawKeyHint("drop files", "to attach"),
     ].join("\n");

package/dist/integrations/pi/components/shell-shared-facade.d.ts

@@ -80,11 +80,19 @@ export interface PiShellViewComponentPort extends PiShellComponentPort {
     update(view: OwnedUiSessionViewModel): void;
 }
 export type PiShellStatusPlacement = "live" | "dock" | "hidden";
+export type PiShellProgressPresentationMode = "pinned" | "custom-viewport";
+export interface PiShellProgressStatusPresentation {
+    readonly text: (message: string, mode: PiShellProgressPresentationMode) => string;
+    readonly frame: (message: string, phase: number, styles: {
+        readonly muted: (text: string) => string;
+        readonly accent: (text: string) => string;
+    }) => string;
+}
 export interface PiShellStatusPort extends PiShellViewComponentPort {
     setWorkingOverride(message: string | undefined): void;
     setOutputPad(padding: 0 | 1): void;
     /** Bare A1 shows engine-measured progress beside the working word; the pinned route keeps the bare word. */
-    setProgressPresentation(presentation: "pinned" | "custom-viewport"): void;
+    setProgressPresentation(presentation: PiShellProgressPresentationMode): void;
     /** Semantic row placement; callers must not inspect rendered text. */
     placement(): PiShellStatusPlacement;
     renderDock(width: number): readonly string[];

package/dist/integrations/pi/components/upstream/adjacent/core/keybindings.d.ts

@@ -2,8 +2,8 @@
  * Provenance: @earendil-works/pi-coding-agent 0.87.1 (MIT), commit f07218c4d4bbc12bef056a7058c3dd49dfe41abe,
  * packages/coding-agent/src/core/keybindings.ts.
  * Modifications: Mechanical source port with Node import prefixes, public package-root agent-directory
- * resolution, and an opt-in bare-A1 input profile including Ctrl+L level cycling and unbound model
- * selection.
+ * resolution, and an opt-in bare-A1 input profile including Ctrl+L level cycling, unbound model
+ * selection, and cross-platform Alt+Up queued-message restoration.
  * Deviations: keybindings-public-config-boundary, owned-level-cycle-shortcut,
  * owned-input-keybinding-aliases.
  */

package/dist/integrations/pi/components/upstream/adjacent/core/keybindings.js

@@ -2,8 +2,8 @@
  * Provenance: @earendil-works/pi-coding-agent 0.87.1 (MIT), commit f07218c4d4bbc12bef056a7058c3dd49dfe41abe,
  * packages/coding-agent/src/core/keybindings.ts.
  * Modifications: Mechanical source port with Node import prefixes, public package-root agent-directory
- * resolution, and an opt-in bare-A1 input profile including Ctrl+L level cycling and unbound model
- * selection.
+ * resolution, and an opt-in bare-A1 input profile including Ctrl+L level cycling, unbound model
+ * selection, and cross-platform Alt+Up queued-message restoration.
  * Deviations: keybindings-public-config-boundary, owned-level-cycle-shortcut,
  * owned-input-keybinding-aliases.
  */
@@ -184,6 +184,7 @@ const OWNED_INPUT_KEYBINDINGS = {
     ...KEYBINDINGS,
     "app.thinking.cycle": { ...KEYBINDINGS["app.thinking.cycle"], defaultKeys: "ctrl+l" },
     "app.model.select": { ...KEYBINDINGS["app.model.select"], defaultKeys: [] },
+    "app.message.dequeue": { ...KEYBINDINGS["app.message.dequeue"], defaultKeys: "alt+up" },
     "tui.editor.deleteWordBackward": {
         ...KEYBINDINGS["tui.editor.deleteWordBackward"],
         defaultKeys: [...KEYBINDINGS["tui.editor.deleteWordBackward"].defaultKeys, "ctrl+backspace"],

package/dist/integrations/pi/engine/compaction-progress.d.ts

@@ -10,7 +10,7 @@ export interface CompactionProgressSession {
     } | undefined;
 }
 export interface CompactionProgressObserver {
-    /** Marks `compaction_start`: resets the streamed count and captures the expected summary size. */
+    /** Marks `compaction_start`: resets the estimate and immediately reports zero percent. */
     begin(): void;
     /** Marks `compaction_end`: later stream chunks are ignored. */
     end(): void;

package/dist/integrations/pi/engine/compaction-progress.js

@@ -60,6 +60,7 @@ export function observeCompactionProgress(session, onProgress) {
             reported = null;
             expected = latestCompactionSummaryLength(session) ?? DEFAULT_EXPECTED_COMPACTION_SUMMARY_CHARS;
             active = true;
+            report();
         },
         end() {
             active = false;

package/dist/integrations/pi/engine/repository-pr.d.ts

@@ -3,6 +3,6 @@ export interface PiPullRequestIdentity {
     readonly url: string;
 }
 export type PiPullRequestProbe = (cwd: string, branch: string, signal: AbortSignal) => Promise<PiPullRequestIdentity | null>;
-/** Read the open GitHub pull request associated with one exact local branch. */
-export declare function readOpenPullRequest(cwd: string, branch: string, signal: AbortSignal, environment?: NodeJS.ProcessEnv): Promise<PiPullRequestIdentity | null>;
-export declare function parseOpenPullRequest(stdout: string, branch: string): PiPullRequestIdentity | null;
+/** Read an exact branch's open or merged PR. */
+export declare function readPullRequest(cwd: string, branch: string, signal: AbortSignal, environment?: NodeJS.ProcessEnv): Promise<PiPullRequestIdentity | null>;
+export declare function parsePullRequest(stdout: string, branch: string): PiPullRequestIdentity | null;

package/dist/integrations/pi/engine/repository-pr.js

@@ -2,19 +2,19 @@ import { execFile } from "node:child_process";
 import { PRODUCT_IDENTITY } from "../../../product-identity.js";
 const GH_TIMEOUT_MS = 5_000;
 const GH_MAX_BUFFER_BYTES = 64 * 1024;
-/** Read the open GitHub pull request associated with one exact local branch. */
-export async function readOpenPullRequest(cwd, branch, signal, environment = process.env) {
+/** Read an exact branch's open or merged PR. */
+export async function readPullRequest(cwd, branch, signal, environment = process.env) {
     if (branch.length === 0 || signal.aborted)
         return null;
     const preview = environment[PRODUCT_IDENTITY.environment.prFooterPreview];
     if (preview !== undefined)
-        return parseOpenPullRequest(preview, branch);
+        return parsePullRequest(preview, branch);
     const stdout = await executeGh(cwd, signal);
     if (stdout === null)
         return null;
-    return parseOpenPullRequest(stdout, branch);
+    return parsePullRequest(stdout, branch);
 }
-export function parseOpenPullRequest(stdout, branch) {
+export function parsePullRequest(stdout, branch) {
     let value;
     try {
         value = JSON.parse(stdout);
@@ -25,7 +25,7 @@ export function parseOpenPullRequest(stdout, branch) {
     if (!isRecord(value)
         || !Number.isSafeInteger(value.number)
         || value.number <= 0
-        || value.state !== "OPEN"
+        || (value.state !== "OPEN" && value.state !== "MERGED")
         || value.headRefName !== branch
         || typeof value.url !== "string")
         return null;

package/dist/integrations/pi/engine/session-runtime.js

@@ -6,7 +6,7 @@ import { observeCompactionProgress } from "./compaction-progress.js";
 import { createPiRuntimeIntegration } from "./runtime-integration.js";
 import { PiSessionCommandIntegration } from "./session-integration.js";
 import { DefaultPackageManager, VERSION } from "../startup-public.js";
-import { readOpenPullRequest, } from "./repository-pr.js";
+import { readPullRequest, } from "./repository-pr.js";
 const execFileAsync = promisify(execFile);
 const PULL_REQUEST_REFRESH_MS = 60_000;
 const REPOSITORY_CONTEXT_POLL_MS = 5_000;
@@ -56,7 +56,7 @@ export class PiEngineRuntime {
             ?? (options.createRuntime
                 ? async () => []
                 : settingsManager => checkDefaultPiPackageUpdates(this.#cwd, options.agentDir, settingsManager));
-        this.#pullRequestProbe = options.pullRequestProbe ?? readOpenPullRequest;
+        this.#pullRequestProbe = options.pullRequestProbe ?? readPullRequest;
         this.#pullRequestRefreshMs = options.pullRequestRefreshMs ?? PULL_REQUEST_REFRESH_MS;
         this.#repositoryContextPollMs = options.repositoryContextPollMs ?? REPOSITORY_CONTEXT_POLL_MS;
         this.#repositoryContextReader = options.repositoryContextReader ?? (async () => null);
@@ -393,6 +393,8 @@ function samePullRequest(left, right) {
     return left?.number === right?.number && left?.url === right?.url;
 }
 async function readGitBranch(cwd, signal) {
+    if (!existsSync(cwd))
+        return null;
     try {
         const { stdout } = await execFileAsync("git", ["branch", "--show-current"], {
             cwd,
@@ -402,8 +404,7 @@ async function readGitBranch(cwd, signal) {
             signal,
             encoding: "utf8",
         });
-        const branch = stdout.trim();
-        return branch.length > 0 ? branch : null;
+        return stdout.trim() || null;
     }
     catch {
         return null;

package/dist/integrations/pi/tui-runtime/adapter.d.ts

@@ -47,6 +47,8 @@ export declare class PiTuiRuntimeAdapter {
     getClearOnShrink(): boolean;
     setTerminalProgress(active: boolean): void;
     setTitle(title: string): void;
+    /** Shows a bounded fullscreen acknowledgement without changing root layout geometry. */
+    showFlash(message: string, durationMs?: number): void;
     writeAfterStop(text: string): void;
     invalidate(): void;
     requestRender(force?: boolean): void;

package/dist/integrations/pi/tui-runtime/adapter.js

@@ -392,6 +392,11 @@ export class PiTuiRuntimeAdapter {
     setTitle(title) {
         this.#terminal.setTitle(title);
     }
+    /** Shows a bounded fullscreen acknowledgement without changing root layout geometry. */
+    showFlash(message, durationMs) {
+        this.#assertRunning("flash");
+        this.#requireFullscreen().flash(message, durationMs);
+    }
     writeAfterStop(text) {
         if (this.#state !== "stopped")
             throw new Error("terminal output requires a stopped Pi TUI runtime");

package/dist/native/darwin-arm64/manifest.json

@@ -5,7 +5,7 @@
   "platform": "darwin",
   "architecture": "arm64",
   "capability": "supported",
-  "builtAt": "2026-09-23T16:42:04.513Z",
+  "builtAt": "2026-09-23T23:03:13.628Z",
   "artifact": {
     "filename": "process-guardian",
     "sha256": "9db1726bbe3fc2e8292f2ead1e7e9d0fd4d7d0dc9217b372582bf354b0f565dc",

package/dist/native/linux-x64/manifest.json

@@ -5,7 +5,7 @@
   "platform": "linux",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-09-23T16:42:11.967Z",
+  "builtAt": "2026-09-23T23:03:11.352Z",
   "artifact": {
     "filename": "process-guardian",
     "sha256": "d8cda6b0c7cb36c0cc41e90802aceebf6c02eaebbc08a83d7d963d2e918dbd7a",

package/dist/native/win32-x64/manifest.json

@@ -5,11 +5,11 @@
   "platform": "win32",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-09-23T16:43:16.752Z",
+  "builtAt": "2026-09-23T23:03:54.826Z",
   "artifact": {
     "filename": "process-guardian.exe",
-    "sha256": "051b57f8b1980f1cf2accf7d9f102941e5fcf74b4264f9375d924581e950b0d6",
-    "size": 177664
+    "sha256": "6c21b828ef2eb284a783609ad28dee4744f81cf0d53a4de1e38bddba4da08079",
+    "size": 178176
   },
   "provenance": {
     "language": "Rust",

package/dist/ui/components/index.d.ts

@@ -15,7 +15,8 @@ export { MOUSE_TRACKING_OFF, MOUSE_TRACKING_ON, parseMouseInput, routeMouseInput
 export type { ParsedMouseInput, RoutedMouseInput } from "./mouse.js";
 export { isInsidePane, toPaneLocalMouse } from "./pane.js";
 export type { Pane, PaneInputResult, PaneMouseEvent } from "./pane.js";
-export { progressStatusText } from "./progress-status.js";
+export { progressStatusFrame, progressStatusText } from "./progress-status.js";
+export type { ProgressStatusFrameStyles, ProgressStatusMarker } from "./progress-status.js";
 export { FrameCache, RENDER_REVISION_KINDS, RenderRevisionTracker, ZERO_REVISIONS, normalizeRevisions, revisionsEqual } from "./revision.js";
 export type { RenderCacheContract, RenderRevisionKind, RenderRevisions } from "./revision.js";
 export { MAX_COPY_ROWS, MAX_COPY_SOURCE_UNITS, selectionCopyLineContent, selectionCopyRowText } from "./selection-copy.js";

package/dist/ui/components/index.js

@@ -7,7 +7,7 @@ export { blockJumpTarget, blockRowSpan, clampScroll, indexOfKey, layoutList, max
 export { STEPPER_RESERVE, placementFor, regionAt, renderGroupHeader, renderListRow, renderNote, valueColumnFor } from "./list-view.js";
 export { MOUSE_TRACKING_OFF, MOUSE_TRACKING_ON, parseMouseInput, routeMouseInput } from "./mouse.js";
 export { isInsidePane, toPaneLocalMouse } from "./pane.js";
-export { progressStatusText } from "./progress-status.js";
+export { progressStatusFrame, progressStatusText } from "./progress-status.js";
 export { FrameCache, RENDER_REVISION_KINDS, RenderRevisionTracker, ZERO_REVISIONS, normalizeRevisions, revisionsEqual } from "./revision.js";
 export { MAX_COPY_ROWS, MAX_COPY_SOURCE_UNITS, selectionCopyLineContent, selectionCopyRowText } from "./selection-copy.js";
 export { ScrollbarRails, isThumbRow, scrollForThumbRow, scrollForTrackPage, scrollbarGeometry, scrollbarPresentation, scrollbarReservesSpace, scrollbarSelectionRows, scrollbarWheelRows, } from "./scrollbar.js";

package/dist/ui/components/progress-status.d.ts

@@ -1,2 +1,9 @@
-/** Returns spinner-backed status text with A1's canonical three-period marker. */
-export declare function progressStatusText(message: string): string;
+export type ProgressStatusMarker = "…" | "...";
+export interface ProgressStatusFrameStyles {
+    readonly muted: (text: string) => string;
+    readonly accent: (text: string) => string;
+}
+/** Returns spinner-backed status text with the selected terminal progress marker. */
+export declare function progressStatusText(message: string, marker?: ProgressStatusMarker): string;
+/** Paints one width-stable, grapheme-safe frame of the quiet progress-label sweep. */
+export declare function progressStatusFrame(message: string, phase: number, styles: ProgressStatusFrameStyles): string;

package/dist/ui/components/progress-status.js

@@ -1,4 +1,25 @@
-/** Returns spinner-backed status text with A1's canonical three-period marker. */
-export function progressStatusText(message) {
-    return `${message.replace(/(?:…|\.+)$/u, "")}...`;
+const GRAPHEMES = new Intl.Segmenter(undefined, { granularity: "grapheme" });
+const HIGHLIGHT_WIDTH = 2;
+const UPDATES_PER_STEP = 3;
+/** Returns spinner-backed status text with the selected terminal progress marker. */
+export function progressStatusText(message, marker = "…") {
+    return `${message.replace(/(?:…|\.+)$/u, "")}${marker}`;
+}
+/** Paints one width-stable, grapheme-safe frame of the quiet progress-label sweep. */
+export function progressStatusFrame(message, phase, styles) {
+    const marker = message.endsWith("…") ? "…" : "";
+    const label = marker === "" ? message : message.slice(0, -marker.length);
+    const graphemes = [...GRAPHEMES.segment(label)].map(segment => segment.segment);
+    if (graphemes.length === 0)
+        return paint(marker, styles.muted);
+    const step = Math.floor(Math.max(0, phase) / UPDATES_PER_STEP) % (graphemes.length * 2);
+    if (step >= graphemes.length)
+        return paint(`${label}${marker}`, styles.muted);
+    const before = graphemes.slice(0, step).join("");
+    const highlight = graphemes.slice(step, step + HIGHLIGHT_WIDTH).join("");
+    const after = `${graphemes.slice(step + HIGHLIGHT_WIDTH).join("")}${marker}`;
+    return `${paint(before, styles.muted)}${paint(highlight, styles.accent)}${paint(after, styles.muted)}`;
+}
+function paint(text, style) {
+    return text === "" ? "" : style(text);
 }

package/dist/ui/components/transcript-viewport.d.ts

@@ -50,6 +50,12 @@ export interface TranscriptViewportFrameInput {
         readonly column: number;
         readonly row: number;
     };
+    /** Base-frame cells hidden by modal/replacement surfaces and therefore excluded from visual copy. */
+    readonly coveredCells?: readonly {
+        readonly row: number;
+        readonly columnStart: number;
+        readonly columnEnd: number;
+    }[];
     readonly now?: number;
     readonly theme?: TranscriptViewportTheme;
 }
@@ -150,12 +156,12 @@ export declare class TranscriptViewport {
     setStickyHovered(hovered: boolean): void;
     get selectionActive(): boolean;
     get hasSelection(): boolean;
-    pressSelection(column: number, viewportRow: number, now?: number): boolean;
-    extendSelection(column: number, viewportRow: number, now?: number, autoScroll?: boolean): boolean;
+    pressSelection(column: number, frameRow: number, now?: number): boolean;
+    extendSelection(column: number, frameRow: number, now?: number, autoScroll?: boolean): boolean;
     releaseSelection(): boolean;
     clearSelection(): boolean;
     selectedText(): string | null;
-    /** Captures selected source references, never the entire mutable transcript or prompt graph. */
+    /** Captures only the selected visible frame text, never off-screen transcript history. */
     captureSelectedText(): SelectionCopySnapshot | null;
     scrollBy(lines: number, now?: number): boolean;
     scrollTo(position: number, now?: number): boolean;