@timurproko/a1 0.1.8-dev.137 → 0.1.8-dev.151

package/dist/product-identity.d.ts

@@ -1,6 +1,6 @@
-declare const ENVIRONMENT_KEYS: readonly ["certificationTarball", "configDir", "dataDir", "databasePath", "developmentInstanceId", "developmentRoot", "endpoint", "fixture", "fixtureInput", "fixtureToken", "inputAcknowledgement", "internalPackaging", "launchArgumentsJson", "launchProfile", "nativePi", "paneId", "piParityIntentionalMutation", "piPortRoot", "piSourceLedgerPath", "piSourceScanRoot", "probeTrace", "processGuardianPath", "profileHome", "protocolVersion", "releaseDigest", "releaseId", "releaseRoot", "releaseRunnerLabel", "runtimeDir", "structuredFlowLimits", "terminalArgumentsJson", "terminalExecutable", "terminalSessionId"];
+declare const ENVIRONMENT_KEYS: readonly ["certificationTarball", "configDir", "dataDir", "databasePath", "developmentInstanceId", "developmentRoot", "endpoint", "fixture", "fixtureInput", "fixtureToken", "inputAcknowledgement", "internalPackaging", "launchProfile", "nativePi", "paneId", "piParityIntentionalMutation", "piPortRoot", "piSourceLedgerPath", "piSourceScanRoot", "probeTrace", "processGuardianPath", "profileHome", "protocolVersion", "releaseDigest", "releaseId", "releaseRoot", "releaseRunnerLabel", "runtimeDir", "structuredFlowLimits", "terminalArgumentsJson", "terminalExecutable", "terminalSessionId"];
 declare const FILESYSTEM_KEYS: readonly ["slug", "windowsDirectory", "unixDirectory", "temporaryPrefix"];
-declare const STATE_KEYS: readonly ["windowsControlDirectory", "unixControlDirectory", "developmentDirectory", "piAgentProfile", "piVanillaProfile", "piSandboxProfile"];
+declare const STATE_KEYS: readonly ["windowsControlDirectory", "unixControlDirectory", "developmentDirectory", "piAgentProfile", "piVanillaProfile"];
 declare const ENDPOINT_KEYS: readonly ["windowsPipeStem", "unixSocketFilename", "metadataFilename", "supervisorLogFilename", "databaseFilename"];
 declare const MANIFEST_KEYS: readonly ["releaseFilename", "packageFilename"];
 declare const PROTOCOL_KEYS: readonly ["namespace", "controlEnvelope", "supervisorSchema", "nativeHostSchema", "structuredAgentSchema", "controlStoreSchema", "releaseCohortSchema", "updateJournalSchema"];

package/dist/product-identity.js

@@ -12,7 +12,6 @@ const ENVIRONMENT_KEYS = [
     "fixtureToken",
     "inputAcknowledgement",
     "internalPackaging",
-    "launchArgumentsJson",
     "launchProfile",
     "nativePi",
     "paneId",
@@ -35,7 +34,7 @@ const ENVIRONMENT_KEYS = [
     "terminalSessionId",
 ];
 const FILESYSTEM_KEYS = ["slug", "windowsDirectory", "unixDirectory", "temporaryPrefix"];
-const STATE_KEYS = ["windowsControlDirectory", "unixControlDirectory", "developmentDirectory", "piAgentProfile", "piVanillaProfile", "piSandboxProfile"];
+const STATE_KEYS = ["windowsControlDirectory", "unixControlDirectory", "developmentDirectory", "piAgentProfile", "piVanillaProfile"];
 const ENDPOINT_KEYS = ["windowsPipeStem", "unixSocketFilename", "metadataFilename", "supervisorLogFilename", "databaseFilename"];
 const MANIFEST_KEYS = ["releaseFilename", "packageFilename"];
 const PROTOCOL_KEYS = ["namespace", "controlEnvelope", "supervisorSchema", "nativeHostSchema", "structuredAgentSchema", "controlStoreSchema", "releaseCohortSchema", "updateJournalSchema"];
@@ -64,8 +63,8 @@ export function validateProductIdentity(value) {
         throw new TypeError("product display name must be non-empty without surrounding whitespace");
     if (schema !== `${commandName}-product-identity-v1`)
         throw new TypeError("product identity schema must derive from the command name");
-    if (filesystem.slug !== commandName || filesystem.unixDirectory !== filesystem.slug || filesystem.windowsDirectory !== displayName) {
-        throw new TypeError("product filesystem identity must derive from display and command names");
+    if (filesystem.slug !== commandName || filesystem.unixDirectory !== filesystem.slug || filesystem.windowsDirectory !== filesystem.slug) {
+        throw new TypeError("product filesystem identity must derive from the command name");
     }
     if (filesystem.temporaryPrefix !== `${filesystem.slug}-`)
         throw new TypeError("product temporary prefix must derive from the filesystem slug");

package/dist/product-identity.json

@@ -5,7 +5,7 @@
     "packageName": "@timurproko/a1",
     "filesystem": {
         "slug": "a1",
-        "windowsDirectory": "A1",
+        "windowsDirectory": "a1",
         "unixDirectory": "a1",
         "temporaryPrefix": "a1-"
     },
@@ -22,7 +22,6 @@
         "fixtureToken": "A1_FIXTURE_TOKEN",
         "inputAcknowledgement": "A1_INPUT_ACK",
         "internalPackaging": "A1_INTERNAL_PACKAGING",
-        "launchArgumentsJson": "A1_LAUNCH_ARGUMENTS_JSON",
         "launchProfile": "A1_LAUNCH_PROFILE",
         "nativePi": "A1_NATIVE_PI",
         "paneId": "A1_PANE_ID",
@@ -45,12 +44,11 @@
         "terminalSessionId": "A1_TERMINAL_SESSION_ID"
     },
     "state": {
-        "windowsControlDirectory": "A1",
+        "windowsControlDirectory": "a1",
         "unixControlDirectory": "a1",
         "developmentDirectory": "a1-development",
         "piAgentProfile": ".a1/agent",
-        "piVanillaProfile": ".pi/agent",
-        "piSandboxProfile": ".a1/sandbox"
+        "piVanillaProfile": ".pi/agent"
     },
     "endpoint": {
         "windowsPipeStem": "a1",

package/dist/ui/apps/contracts.d.ts

@@ -1,4 +1,4 @@
-import type { PaneInputResult, PaneMouseEvent, PaneRect, UiTheme } from "../components/index.js";
+import type { PaneInputResult, PaneMouseEvent, PaneRect, RenderCacheContract, UiTheme } from "../components/index.js";
 export interface AppSize {
     readonly width: number;
     readonly height: number;
@@ -27,6 +27,8 @@ export interface AppHostServices {
 }
 export interface UiApp {
     readonly id: string;
+    /** Optional declared revisions used by the host's shared frame cache. */
+    readonly renderCache?: RenderCacheContract;
     render(rect: PaneRect, host: AppHostServices): readonly string[];
     onInput?(data: string, host: AppHostServices): PaneInputResult;
     onMouse?(event: PaneMouseEvent, host: AppHostServices): PaneInputResult;
@@ -39,4 +41,24 @@ export interface AppRegistration {
     readonly route: string;
     create(): UiApp;
 }
+/** A neutral owned-app surface mounted by a surrounding presentation runtime. */
+export interface UiRouteSurface {
+    readonly id: string;
+    /** Renders exactly `height` rows of at most `width` columns. */
+    render(width: number, height: number): readonly string[];
+    /** True when the key was consumed; false leaves it to the surrounding shell. */
+    handleInput(data: string): boolean;
+    /** Mouse report in surface-local coordinates. True when consumed. */
+    handleMouse(event: PaneMouseEvent): boolean;
+    isClosed(): boolean;
+    close(): void;
+    onRenderRequested(listener: () => void): void;
+    /** The surface asks to leave A1 entirely, not merely to close itself. */
+    onExitRequested(listener: () => void): void;
+}
+/** Route lookup seam shared by owned apps and any presentation runtime hosting them. */
+export interface UiRouteHost {
+    claims(route: string): boolean;
+    open(route: string): UiRouteSurface | null;
+}
 export declare function assertAppRegistration(registration: AppRegistration): void;

package/dist/ui/apps/host.js

@@ -16,6 +16,7 @@ export class UiAppHost {
     #theme;
     /** When the first interrupt of a chord was seen, or null when disarmed. */
     #interruptArmedAt = null;
+    #renderedInterruptArmed;
     #cache = new FrameCache();
     #app = null;
     constructor(options) {
@@ -58,7 +59,11 @@ export class UiAppHost {
         }
         const size = this.#surface.size();
         const rect = { width: Math.max(0, size.width), height: Math.max(0, size.height) };
-        const lines = this.#guard(() => finalizeFrame(app.render(rect, this.#services()), rect, app.id));
+        const interruptArmed = this.interruptArmed;
+        if (this.#renderedInterruptArmed !== interruptArmed)
+            this.#cache.invalidate();
+        this.#renderedInterruptArmed = interruptArmed;
+        const lines = this.#guard(() => this.#cache.render(app, rect, () => finalizeFrame(app.render(rect, this.#services()), rect, app.id)));
         this.#surface.present(lines ?? null);
     }
     handleInput(data) {
@@ -101,6 +106,9 @@ export class UiAppHost {
             return { consumed: true, render: true };
         }
         this.#interruptArmedAt = now;
+        // Host-owned state participates in the app's next frame independently of
+        // the app's own revision contract.
+        this.#cache.invalidate();
         return { consumed: true, render: true };
     }
     get interruptArmed() {

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

@@ -11,8 +11,11 @@ export * from "./scrollbar.js";
 export * from "./shortcuts.js";
 export * from "./spans.js";
 export * from "./status-line.js";
+export * from "./submitted-prompt.js";
 export * from "./stepper.js";
+export * from "./transcript-viewport.js";
 export * from "./surface.js";
 export * from "./text.js";
+export * from "./text-selection.js";
 export * from "./theme.js";
 export * from "./value-menu.js";

package/dist/ui/components/index.js

@@ -11,8 +11,11 @@ export * from "./scrollbar.js";
 export * from "./shortcuts.js";
 export * from "./spans.js";
 export * from "./status-line.js";
+export * from "./submitted-prompt.js";
 export * from "./stepper.js";
+export * from "./transcript-viewport.js";
 export * from "./surface.js";
 export * from "./text.js";
+export * from "./text-selection.js";
 export * from "./theme.js";
 export * from "./value-menu.js";

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

@@ -13,3 +13,13 @@ export interface ParsedMouseInput {
 }
 /** Extracts SGR mouse reports, leaving any keyboard input untouched. */
 export declare function parseMouseInput(data: string): ParsedMouseInput;
+export interface RoutedMouseInput {
+    /** Input left for the TUI after only claimed reports were removed. */
+    readonly data: string;
+    readonly consumed: boolean;
+}
+/**
+ * Routes every SGR report independently, preserving keyboard bytes and mouse
+ * reports the caller does not claim even when they share one physical chunk.
+ */
+export declare function routeMouseInput(data: string, claim: (event: PaneMouseEvent) => boolean): RoutedMouseInput;

package/dist/ui/components/mouse.js

@@ -30,6 +30,29 @@ export function parseMouseInput(data) {
     rest += data.slice(index);
     return { events: Object.freeze(events), rest };
 }
+/**
+ * Routes every SGR report independently, preserving keyboard bytes and mouse
+ * reports the caller does not claim even when they share one physical chunk.
+ */
+export function routeMouseInput(data, claim) {
+    if (!data.includes("\u001b[<"))
+        return { data, consumed: false };
+    let output = "";
+    let index = 0;
+    let consumed = false;
+    SGR_PATTERN.lastIndex = 0;
+    for (let match = SGR_PATTERN.exec(data); match !== null; match = SGR_PATTERN.exec(data)) {
+        output += data.slice(index, match.index);
+        index = match.index + match[0].length;
+        const event = toEvent(Number.parseInt(match[1] ?? "", 10), Number.parseInt(match[2] ?? "", 10), Number.parseInt(match[3] ?? "", 10), match[4] === "m");
+        if (event !== null && claim(event))
+            consumed = true;
+        else
+            output += match[0];
+    }
+    output += data.slice(index);
+    return { data: output, consumed };
+}
 function toEvent(code, column, row, released) {
     if ((code & 64) !== 0) {
         const kind = (code & 1) === 0 ? "wheel-up" : "wheel-down";

package/dist/ui/components/prompt-row.d.ts

@@ -0,0 +1,14 @@
+export interface TimestampedPromptRowsInput {
+    readonly width: number;
+    readonly sourceTimestamp: number | Date;
+    readonly render: (contentWidth: number) => readonly string[];
+    /** Styles the reserved suffix while keeping policy independent of a vendor theme. */
+    readonly decorateSuffix?: (text: string, firstRow: boolean) => string;
+    readonly minimumWidth?: number;
+}
+export declare function formatPromptTimestamp(source: number | Date): string | null;
+/**
+ * Reserves timestamp columns before wrapping, so the clock never overwrites
+ * prompt content. At narrow widths the same renderer is used without a clock.
+ */
+export declare function composeTimestampedPromptRows(input: TimestampedPromptRowsInput): readonly string[];

package/dist/ui/components/prompt-row.js

@@ -0,0 +1,20 @@
+import { overlaySpan } from "./spans.js";
+export function formatPromptTimestamp(source) {
+    const date = source instanceof Date ? source : new Date(source);
+    if (Number.isNaN(date.getTime()))
+        return null;
+    return `${String(date.getHours()).padStart(2, "0")}:${String(date.getMinutes()).padStart(2, "0")}`;
+}
+/**
+ * Reserves timestamp columns before wrapping, so the clock never overwrites
+ * prompt content. At narrow widths the same renderer is used without a clock.
+ */
+export function composeTimestampedPromptRows(input) {
+    const timestamp = formatPromptTimestamp(input.sourceTimestamp);
+    if (timestamp === null || input.width < (input.minimumWidth ?? 20))
+        return input.render(input.width);
+    const suffixWidth = timestamp.length + 2;
+    const contentWidth = Math.max(1, input.width - suffixWidth);
+    const decorate = input.decorateSuffix ?? ((text) => text);
+    return input.render(contentWidth).map((row, index) => overlaySpan(row, contentWidth, input.width, decorate(index === 0 ? `  ${timestamp}` : " ".repeat(suffixWidth), index === 0)));
+}

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

@@ -19,6 +19,30 @@ export interface ScrollbarInput {
     readonly scroll: number;
     readonly trackHeight: number;
 }
+export type ScrollbarAppearance = "auto" | "always" | "hidden";
+export type ScrollbarStyle = "thin" | "thick";
+export type ScrollbarSpeed = "normal" | "fast" | "high";
+/** Wheel distance: normal (3), fast (6), high as normal + fast (9). */
+export declare function scrollbarWheelRows(speed: ScrollbarSpeed): number;
+/** Selection edge distance uses the same configured rate as a wheel event. */
+export declare function scrollbarSelectionRows(speed: ScrollbarSpeed): number;
+export interface ScrollbarPresentationInput {
+    readonly geometry: ScrollbarGeometry | null;
+    readonly appearance: ScrollbarAppearance;
+    readonly style: ScrollbarStyle;
+    readonly hovered: boolean;
+    readonly dragging: boolean;
+    readonly activeUntil: number;
+    readonly now: number;
+}
+export interface ScrollbarPresentation {
+    readonly visible: boolean;
+    readonly reservesSpace: boolean;
+    readonly trackGlyph: "│" | "┃";
+    readonly thumbGlyph: "│" | "┃";
+}
+/** Pure appearance decision; activity time is supplied so tests own the clock. */
+export declare function scrollbarPresentation(input: ScrollbarPresentationInput): ScrollbarPresentation;
 /** Null when the content fits: no scrollbar is drawn and no width is reserved. */
 export declare function scrollbarGeometry(input: ScrollbarInput): ScrollbarGeometry | null;
 export declare function scrollbarReservesSpace(geometry: ScrollbarGeometry | null): boolean;
@@ -48,6 +72,8 @@ export interface RailPointer {
  */
 export declare class ScrollbarRails {
     #private;
+    noteActivity(key: string, now: number, lingerMs?: number): void;
+    isRecentlyActive(key: string, now: number): boolean;
     isHovered(key: string): boolean;
     isDragging(key: string): boolean;
     get draggingKey(): string | null;

package/dist/ui/components/scrollbar.js

@@ -3,6 +3,33 @@
  * rail rather than to a global, because two scrollable surfaces can be visible
  * at once and a shared flag lights up the wrong one.
  */
+/** Wheel distance: normal (3), fast (6), high as normal + fast (9). */
+export function scrollbarWheelRows(speed) {
+    return speed === "high" ? 9 : speed === "fast" ? 6 : 3;
+}
+/** Selection edge distance uses the same configured rate as a wheel event. */
+export function scrollbarSelectionRows(speed) {
+    return scrollbarWheelRows(speed);
+}
+/** Pure appearance decision; activity time is supplied so tests own the clock. */
+export function scrollbarPresentation(input) {
+    const overflowing = input.geometry !== null;
+    // As in v2, auto/always reserve the final rail cell even while content fits.
+    // The blank gutter prevents prompt timestamps from touching the terminal edge
+    // and keeps later scrollbar appearance from reflowing the transcript.
+    const reservesSpace = input.appearance !== "hidden";
+    const visible = overflowing && reservesSpace && (input.appearance === "always"
+        || input.hovered
+        || input.dragging
+        || (input.activeUntil > 0 && input.now <= input.activeUntil));
+    const thick = input.style === "thick";
+    return {
+        visible,
+        reservesSpace,
+        trackGlyph: thick ? "┃" : "│",
+        thumbGlyph: thick || input.hovered || input.dragging ? "┃" : "│",
+    };
+}
 /** Null when the content fits: no scrollbar is drawn and no width is reserved. */
 export function scrollbarGeometry(input) {
     const { contentLength, viewportHeight, trackHeight } = input;
@@ -51,7 +78,14 @@ export function scrollForTrackPage(geometry, trackRow, scroll, viewportHeight) {
  */
 export class ScrollbarRails {
     #hovered = new Set();
+    #activeUntil = new Map();
     #dragging;
+    noteActivity(key, now, lingerMs = 900) {
+        this.#activeUntil.set(key, Math.max(this.#activeUntil.get(key) ?? 0, now + Math.max(0, lingerMs)));
+    }
+    isRecentlyActive(key, now) {
+        return now <= (this.#activeUntil.get(key) ?? 0);
+    }
     isHovered(key) {
         return this.#hovered.has(key);
     }
@@ -97,6 +131,7 @@ export class ScrollbarRails {
     }
     clear() {
         this.#hovered.clear();
+        this.#activeUntil.clear();
         this.#dragging = undefined;
     }
 }

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

@@ -5,3 +5,24 @@
  * replaced by spaces rather than split.
  */
 export declare function overlaySpan(line: string, from: number, to: number, span: string): string;
+/**
+ * Paints only a background over [from,to), preserving every glyph and its
+ * foreground, bold, underline, and hyperlink styling. Embedded resets reapply
+ * the selection background, while leaving the span restores the row's styles.
+ */
+/** Wraps visible columns `[from,to)` in an explicit OSC 8 hyperlink. */
+export declare function hyperlinkSgrSpan(line: string, from: number, to: number, target: string, widthOf?: (text: string) => number): string;
+/**
+ * Gives existing and bare web links explicit, tightly bounded OSC 8 regions so
+ * the terminal owns dotted-idle/solid-hover decoration without leaking hover
+ * state into cells repainted during scrolling.
+ */
+export declare function nativeHyperlinkStyle(line: string, color?: (text: string, target: string) => string): string;
+/**
+ * Held-button paint for terminal-native links. OSC 8 is removed so the terminal
+ * cannot switch a selected link to its solid hover underline. A dotted SGR
+ * underline preserves the idle appearance, and VS15 transiently breaks native
+ * plain-text URL detection without changing visible width.
+ */
+export declare function heldNativeHyperlinkStyle(line: string): string;
+export declare function backgroundSgrSpan(line: string, from: number, to: number, on?: string, off?: string, widthOf?: (text: string) => number): string;

package/dist/ui/components/spans.js

@@ -9,6 +9,9 @@ const ANSI_SEQUENCE = "\\u001b(?:\\[[0-?]*[ -/]*[@-~]|[\\]_][^\\u0007\\u001b]*(?
 const ANSI_SPLIT = new RegExp(`(${ANSI_SEQUENCE})`);
 const HYPERLINK = /^\]8;;([^]*)(?:|\\)?$/;
 const HYPERLINK_OFF = "]8;;\\";
+const SGR = /^\[[0-9;]*m$/;
+const BARE_URL = /https?:\/\/[^\s\u0000-\u001f\u007f<>"']+/giu;
+const TRAILING_URL_PUNCTUATION = /[.,;:!?]/u;
 const GRAPHEMES = new Intl.Segmenter(undefined, { granularity: "grapheme" });
 /**
  * Replaces the visible columns `[from, to)` of `line` with `span`, preserving
@@ -57,3 +60,178 @@ export function overlaySpan(line, from, to, span) {
         head += " ".repeat(from - column);
     return head + (hyperlinkOpen ? HYPERLINK_OFF : "") + span + replay + tail;
 }
+/**
+ * Paints only a background over [from,to), preserving every glyph and its
+ * foreground, bold, underline, and hyperlink styling. Embedded resets reapply
+ * the selection background, while leaving the span restores the row's styles.
+ */
+/** Wraps visible columns `[from,to)` in an explicit OSC 8 hyperlink. */
+export function hyperlinkSgrSpan(line, from, to, target, widthOf = displayWidth) {
+    const on = `\u001b]8;;${target}\u001b\\`;
+    const off = "\u001b]8;;\u001b\\";
+    let output = "";
+    let column = 0;
+    let inside = false;
+    for (const token of line.split(ANSI_SPLIT)) {
+        if (!token)
+            continue;
+        if (token.startsWith("\u001b")) {
+            output += token;
+            continue;
+        }
+        for (const { segment } of GRAPHEMES.segment(token)) {
+            const shouldBeInside = column >= from && column < to;
+            if (shouldBeInside !== inside) {
+                output += shouldBeInside ? on : off;
+                inside = shouldBeInside;
+            }
+            output += segment;
+            column += widthOf(segment);
+        }
+    }
+    if (inside)
+        output += off;
+    return output;
+}
+/**
+ * Gives existing and bare web links explicit, tightly bounded OSC 8 regions so
+ * the terminal owns dotted-idle/solid-hover decoration without leaking hover
+ * state into cells repainted during scrolling.
+ */
+export function nativeHyperlinkStyle(line, color = text => text) {
+    let hyperlinkTarget;
+    let sgrReplay = "";
+    let output = "";
+    for (const token of line.split(ANSI_SPLIT)) {
+        if (!token)
+            continue;
+        const link = HYPERLINK.exec(token);
+        if (link) {
+            hyperlinkTarget = (link[1] ?? "") || undefined;
+            output += token;
+            continue;
+        }
+        if (!token.startsWith("\u001b")) {
+            output += hyperlinkTarget === undefined
+                ? decorateBareUrls(token, color, sgrReplay)
+                : color(token, hyperlinkTarget);
+            continue;
+        }
+        if (SGR.test(token)) {
+            if (token === "\u001b[0m")
+                sgrReplay = token;
+            else
+                sgrReplay += token;
+        }
+        if (hyperlinkTarget === undefined || (token !== "\u001b[4m" && token !== "\u001b[24m"))
+            output += token;
+    }
+    return hyperlinkTarget === undefined ? output : output + HYPERLINK_OFF;
+}
+/**
+ * Held-button paint for terminal-native links. OSC 8 is removed so the terminal
+ * cannot switch a selected link to its solid hover underline. A dotted SGR
+ * underline preserves the idle appearance, and VS15 transiently breaks native
+ * plain-text URL detection without changing visible width.
+ */
+export function heldNativeHyperlinkStyle(line) {
+    let hyperlinkTarget;
+    let fileDetectorBroken = false;
+    let output = "";
+    for (const token of line.split(ANSI_SPLIT)) {
+        if (!token)
+            continue;
+        const link = HYPERLINK.exec(token);
+        if (link) {
+            const nextTarget = (link[1] ?? "") || undefined;
+            if ((nextTarget !== undefined) !== (hyperlinkTarget !== undefined)) {
+                output += nextTarget === undefined ? "\u001b[24m" : "\u001b[4:4m";
+            }
+            if (nextTarget !== hyperlinkTarget)
+                fileDetectorBroken = false;
+            hyperlinkTarget = nextTarget;
+            continue;
+        }
+        if (token.startsWith("\u001b")) {
+            output += token;
+            // Foreground helpers may reset every SGR attribute; restore the held
+            // dotted underline without disturbing the source colour or intensity.
+            if (hyperlinkTarget !== undefined && SGR.test(token))
+                output += "\u001b[4:4m";
+            continue;
+        }
+        if (hyperlinkTarget === undefined) {
+            output += token;
+            continue;
+        }
+        let painted = token.replaceAll("https://", "https:\uFE0E//").replaceAll("http://", "http:\uFE0E//");
+        // Windows Terminal also detects file-link labels such as package.json and
+        // D:/work/file.ts after OSC 8 is removed. Break that detector once inside
+        // the paint-only label; semantic transcript text remains untouched.
+        if (!fileDetectorBroken && /^file:/iu.test(hyperlinkTarget)) {
+            const firstVisible = /\S/u.exec(painted);
+            if (firstVisible?.index !== undefined) {
+                const index = firstVisible.index;
+                const codePoint = painted.codePointAt(index) ?? 0;
+                const end = index + (codePoint > 0xffff ? 2 : 1);
+                painted = `${painted.slice(0, end)}\uFE0E${painted.slice(end)}`;
+                fileDetectorBroken = true;
+            }
+        }
+        output += painted;
+    }
+    return hyperlinkTarget === undefined ? output : `${output}\u001b[24m`;
+}
+function decorateBareUrls(text, color, sgrReplay) {
+    return text.replace(BARE_URL, candidate => {
+        const { target, trailing } = splitUrlTrailingPunctuation(candidate);
+        if (target.length === 0)
+            return candidate;
+        return `\u001b]8;;${target}\u001b\\\u001b[24m${color(target, target)}${HYPERLINK_OFF}${sgrReplay}${trailing}`;
+    });
+}
+function splitUrlTrailingPunctuation(candidate) {
+    let end = candidate.length;
+    while (end > 0 && TRAILING_URL_PUNCTUATION.test(candidate[end - 1] ?? ""))
+        end -= 1;
+    for (const [opening, closing] of [["(", ")"], ["[", "]"], ["{", "}"]]) {
+        while (candidate.slice(0, end).endsWith(closing)
+            && occurrences(candidate.slice(0, end), closing) > occurrences(candidate.slice(0, end), opening)) {
+            end -= 1;
+        }
+    }
+    return { target: candidate.slice(0, end), trailing: candidate.slice(end) };
+}
+function occurrences(text, value) {
+    return text.split(value).length - 1;
+}
+export function backgroundSgrSpan(line, from, to, on = "\u001b[47m", off = "\u001b[49m", widthOf = displayWidth) {
+    let output = "";
+    let seen = "";
+    let column = 0;
+    let inside = false;
+    for (const token of line.split(ANSI_SPLIT)) {
+        if (!token)
+            continue;
+        if (token.startsWith("\u001b")) {
+            output += token;
+            if (SGR.test(token))
+                seen += token;
+            if (inside)
+                output += on;
+            continue;
+        }
+        for (const { segment } of GRAPHEMES.segment(token)) {
+            const shouldBeInside = column >= from && column < to;
+            if (shouldBeInside !== inside) {
+                output += shouldBeInside ? on : off + seen;
+                inside = shouldBeInside;
+            }
+            output += segment;
+            column += widthOf(segment);
+        }
+    }
+    if (inside)
+        output += off;
+    return output;
+}

package/dist/ui/components/submitted-prompt.d.ts

@@ -0,0 +1,23 @@
+/** Visible width of the submitted-prompt prefix (`❯ `). */
+export declare const SUBMITTED_PROMPT_PREFIX_WIDTH = 2;
+export interface SubmittedPromptStyle {
+    readonly prefix?: (text: string) => string;
+    readonly timestamp?: (text: string) => string;
+}
+export interface SubmittedPromptLayout {
+    readonly contentWidth: number;
+    readonly timestamp: string | null;
+}
+/** Formats transcript metadata, never render time, as local 24-hour HH:mm. */
+export declare function formatSubmittedPromptTime(source: Date | number): string | null;
+/**
+ * Computes the width at which the prompt's Markdown body must be rendered.
+ * The timestamp is omitted rather than allowing it to crowd useful content.
+ */
+export declare function submittedPromptLayout(width: number, source?: Date | number | null): SubmittedPromptLayout;
+/**
+ * Composes already-rendered prompt content into the compact submitted bar.
+ * Continuations align below the content, not below the prefix, and no row can
+ * exceed the supplied terminal width even when the content renderer misbehaves.
+ */
+export declare function composeSubmittedPromptRows(contentRows: readonly string[], width: number, source?: Date | number | null, style?: SubmittedPromptStyle): readonly string[];

package/dist/ui/components/submitted-prompt.js

@@ -0,0 +1,50 @@
+import { displayWidth, truncateToWidth } from "./text.js";
+/** Visible width of the submitted-prompt prefix (`❯ `). */
+export const SUBMITTED_PROMPT_PREFIX_WIDTH = 2;
+const TIMESTAMP_MARGIN = 3;
+const MIN_USEFUL_CONTENT_WIDTH = 8;
+/** Formats transcript metadata, never render time, as local 24-hour HH:mm. */
+export function formatSubmittedPromptTime(source) {
+    const date = source instanceof Date ? source : new Date(source);
+    if (!Number.isFinite(date.getTime()))
+        return null;
+    return `${String(date.getHours()).padStart(2, "0")}:${String(date.getMinutes()).padStart(2, "0")}`;
+}
+/**
+ * Computes the width at which the prompt's Markdown body must be rendered.
+ * The timestamp is omitted rather than allowing it to crowd useful content.
+ */
+export function submittedPromptLayout(width, source) {
+    const boundedWidth = Math.max(1, width);
+    const timestamp = source === undefined || source === null ? null : formatSubmittedPromptTime(source);
+    const timestampReserve = timestamp === null ? 0 : displayWidth(timestamp) + TIMESTAMP_MARGIN;
+    const canShowTimestamp = timestamp !== null
+        && boundedWidth - SUBMITTED_PROMPT_PREFIX_WIDTH - timestampReserve >= MIN_USEFUL_CONTENT_WIDTH;
+    return {
+        contentWidth: Math.max(1, boundedWidth - SUBMITTED_PROMPT_PREFIX_WIDTH - (canShowTimestamp ? timestampReserve : 0)),
+        timestamp: canShowTimestamp ? timestamp : null,
+    };
+}
+/**
+ * Composes already-rendered prompt content into the compact submitted bar.
+ * Continuations align below the content, not below the prefix, and no row can
+ * exceed the supplied terminal width even when the content renderer misbehaves.
+ */
+export function composeSubmittedPromptRows(contentRows, width, source, style = {}) {
+    if (width <= 0)
+        return [];
+    const layout = submittedPromptLayout(width, source);
+    const prefix = (style.prefix ?? identity)("❯ ");
+    const rows = (contentRows.length === 0 ? [""] : contentRows).map((row, index) => {
+        const content = truncateToWidth(row, layout.contentWidth);
+        return `${index === 0 ? prefix : " ".repeat(SUBMITTED_PROMPT_PREFIX_WIDTH)}${content}`;
+    });
+    if (layout.timestamp !== null && rows[0] !== undefined) {
+        const gap = Math.max(1, width - displayWidth(rows[0]) - displayWidth(layout.timestamp));
+        rows[0] = `${rows[0]}${" ".repeat(gap)}${(style.timestamp ?? identity)(layout.timestamp)}`;
+    }
+    return rows.map(row => truncateToWidth(row, width));
+}
+function identity(text) {
+    return text;
+}