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

package/dist/ui/components/scrollbar.js

@@ -7,14 +7,14 @@
 export function scrollbarWheelRows(speed) {
     return speed === "high" ? 9 : speed === "fast" ? 6 : 3;
 }
-/** Selection edge distance at each fixed 30ms tick. */
+/** Selection edge distance uses the same configured rate as a wheel event. */
 export function scrollbarSelectionRows(speed) {
-    return speed === "high" ? 3 : speed === "fast" ? 2 : 1;
+    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, always/hover reserve the final rail cell even while content fits.
+    // 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";

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

@@ -10,4 +10,19 @@ export declare function overlaySpan(line: string, from: number, to: number, span
  * foreground, bold, underline, and hyperlink styling. Embedded resets reapply
  * the selection background, while leaving the span restores the row's styles.
  */
-export declare function backgroundSgrSpan(line: string, from: number, to: number, on?: string, off?: string): string;
+/** 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

@@ -10,6 +10,8 @@ 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
@@ -63,7 +65,147 @@ export function overlaySpan(line, from, to, span) {
  * foreground, bold, underline, and hyperlink styling. Embedded resets reapply
  * the selection background, while leaving the span restores the row's styles.
  */
-export function backgroundSgrSpan(line, from, to, on = "\u001b[47m", off = "\u001b[49m") {
+/** 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;
@@ -86,7 +228,7 @@ export function backgroundSgrSpan(line, from, to, on = "\u001b[47m", off = "\u00
                 inside = shouldBeInside;
             }
             output += segment;
-            column += displayWidth(segment);
+            column += widthOf(segment);
         }
     }
     if (inside)

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

@@ -20,6 +20,10 @@ export interface TranscriptViewportTheme {
 }
 export interface TranscriptViewportFrameInput {
     readonly documentRows: readonly string[];
+    /** Optional paint-only transform; semantic selection and copying keep documentRows exact. */
+    readonly paintDocumentRow?: (row: string) => string;
+    /** Leading document rows that participate in pointer selection and copying. */
+    readonly selectableDocumentRowCount?: number;
     readonly dockRows: readonly string[];
     readonly promptAnchors: readonly TranscriptPromptAnchor[];
     readonly width: number;
@@ -92,6 +96,8 @@ export declare class TranscriptViewport {
     scrollToEnd(now?: number): boolean;
     /** Jumps to the pinned prompt governing this position, then earlier prompts. */
     scrollToPreviousPrompt(now?: number): boolean;
+    /** Jumps to the next submitted prompt after the prompt at the current stop. */
+    scrollToNextPrompt(now?: number): boolean;
     reset(): void;
     clearTransient(): void;
     compose(input: TranscriptViewportFrameInput): TranscriptViewportFrame;

package/dist/ui/components/transcript-viewport.js

@@ -4,7 +4,7 @@ import { faint, truncateToWidth, displayWidth, stripAnsi } from "./text.js";
 import { extendTextSelection, orderedTextSelection, pressTextSelection, releaseTextSelection, textSelectionLineExtendColumn, textSelectionText, usefulTextLineContent, } from "./text-selection.js";
 const CONTROL_STYLE_RESET = "\u001b]8;;\u001b\\\u001b[0m";
 const DEFAULT_CONFIG = {
-    scrollbarAppearance: "hover",
+    scrollbarAppearance: "auto",
     scrollbarStyle: "thin",
 };
 const PLAIN_THEME = {
@@ -33,6 +33,7 @@ export class TranscriptViewport {
     #selection;
     #selectionClick;
     #documentRows = [];
+    #selectableDocumentRowCount = 0;
     #promptAnchors = [];
     #contentWidth = 0;
     #frame = null;
@@ -69,6 +70,8 @@ export class TranscriptViewport {
         if (viewportRow < 1 || viewportRow > viewportHeight || column < 1 || column > this.#contentWidth)
             return false;
         const line = clamp(this.#scrollTop + viewportRow - 1, 0, Math.max(0, this.#documentRows.length - 1));
+        if (line >= this.#selectableDocumentRowCount)
+            return false;
         const pressed = pressTextSelection({
             line,
             column,
@@ -94,8 +97,11 @@ export class TranscriptViewport {
             this.scrollBy(1, now);
         else if (autoScroll && viewportRow <= 1 && this.#scrollTop > 0)
             this.scrollBy(-1, now);
+        const lastSelectableLine = Math.min(this.#documentRows.length, this.#selectableDocumentRowCount) - 1;
+        if (lastSelectableLine < 0)
+            return false;
         const visibleRow = clamp(viewportRow, 1, viewportHeight);
-        const line = clamp(this.#scrollTop + visibleRow - 1, 0, this.#documentRows.length - 1);
+        const line = clamp(this.#scrollTop + visibleRow - 1, 0, lastSelectableLine);
         const targetColumn = selection.fullRow
             ? textSelectionLineExtendColumn(selection, line, this.#contentWidth)
             : clamp(column, 1, this.#contentWidth);
@@ -118,7 +124,7 @@ export class TranscriptViewport {
         const selection = orderedTextSelection(this.#selection);
         if (selection === undefined)
             return null;
-        return textSelectionText(selection, this.#documentRows, line => this.#lineContentAt(line));
+        return textSelectionText(selection, this.#documentRows.slice(0, this.#selectableDocumentRowCount), line => this.#lineContentAt(line));
     }
     scrollBy(lines, now = Date.now()) {
         if (this.#maxScroll <= 0 || lines === 0)
@@ -166,6 +172,21 @@ export class TranscriptViewport {
         const destination = target === earliest ? 0 : target;
         return target >= 0 && this.scrollTo(destination, now);
     }
+    /** Jumps to the next submitted prompt after the prompt at the current stop. */
+    scrollToNextPrompt(now = Date.now()) {
+        if (this.#promptAnchors.length === 0)
+            return false;
+        const earliest = Math.min(...this.#promptAnchors.map(anchor => anchor.firstRow));
+        // Scroll position zero is the first-prompt stop because it includes that
+        // prompt's opening spacer. Do not spend an extra keypress moving one row.
+        const after = this.#scrollTop === 0 ? earliest : this.#scrollTop;
+        let target = Number.POSITIVE_INFINITY;
+        for (const anchor of this.#promptAnchors) {
+            if (anchor.firstRow > after && anchor.firstRow < target)
+                target = anchor.firstRow;
+        }
+        return Number.isFinite(target) && this.scrollTo(target, now);
+    }
     reset() {
         this.#scrollTop = 0;
         this.#maxScroll = 0;
@@ -174,6 +195,7 @@ export class TranscriptViewport {
         this.#selection = undefined;
         this.#selectionClick = undefined;
         this.#documentRows = [];
+        this.#selectableDocumentRowCount = 0;
         this.#promptAnchors = [];
         this.#contentWidth = 0;
         this.clearTransient();
@@ -219,9 +241,13 @@ export class TranscriptViewport {
         });
         const contentWidth = presentation.reservesSpace ? Math.max(1, width - 1) : width;
         this.#documentRows = input.documentRows;
+        this.#selectableDocumentRowCount = clamp(input.selectableDocumentRowCount ?? input.documentRows.length, 0, input.documentRows.length);
         this.#promptAnchors = input.promptAnchors;
         this.#contentWidth = contentWidth;
-        const visible = input.documentRows.slice(this.#scrollTop, this.#scrollTop + viewportHeight);
+        const paintDocumentRow = input.paintDocumentRow ?? (row => row);
+        const visible = input.documentRows
+            .slice(this.#scrollTop, this.#scrollTop + viewportHeight)
+            .map(paintDocumentRow);
         while (visible.length < viewportHeight)
             visible.push("");
         const governing = governingPrompt(input.promptAnchors, this.#scrollTop);
@@ -231,7 +257,7 @@ export class TranscriptViewport {
             // Sticky prompts use the same normal/hover surface roles as the bottom
             // control. Hover always starts from the full source row, so a quiet prompt
             // becomes prominent again with its timestamp intact.
-            const sticky = theme.sticky(governing.sourceRow, this.#stickyHovered);
+            const sticky = theme.sticky(paintDocumentRow(governing.sourceRow), this.#stickyHovered);
             visible[0] = quiet && !this.#stickyHovered ? theme.quietSticky(sticky) : sticky;
         }
         const orderedSelection = orderedTextSelection(this.#selection);
@@ -239,7 +265,9 @@ export class TranscriptViewport {
             let line = padRowPreservingBackground(visible[row] ?? "", width);
             if (orderedSelection !== undefined && !(stickyActive && row === 0)) {
                 const documentLine = this.#scrollTop + row;
-                if (documentLine >= orderedSelection.start.line && documentLine <= orderedSelection.end.line) {
+                if (documentLine < this.#selectableDocumentRowCount
+                    && documentLine >= orderedSelection.start.line
+                    && documentLine <= orderedSelection.end.line) {
                     const fullVisualRow = orderedSelection.fullRow === true
                         || (orderedSelection.start.line !== orderedSelection.end.line
                             && documentLine !== orderedSelection.start.line
@@ -272,9 +300,9 @@ export class TranscriptViewport {
         const frameRows = [...visible, ...dock].slice(0, height);
         let bottomHit = null;
         if (geometry !== null && !this.#followingEnd && frameRows.length > 0) {
-            const genericLabel = " Jump to bottom (Alt+End) ";
+            const genericLabel = " Jump to bottom (End) ";
             const countedLabel = this.#newMessages > 0
-                ? ` ${this.#newMessages} new message${this.#newMessages === 1 ? "" : "s"} (Alt+End) `
+                ? ` ${this.#newMessages} new message${this.#newMessages === 1 ? "" : "s"} (End) `
                 : genericLabel;
             const label = displayWidth(countedLabel) <= contentWidth ? countedLabel : genericLabel;
             const labelWidth = displayWidth(label);

package/dist/ui/settings/declarations.d.ts

@@ -1,4 +1,4 @@
-export declare const OWNED_UI_SETTINGS_VERSION = 2;
+export declare const OWNED_UI_SETTINGS_VERSION = 3;
 export type OwnedUiSettingValue = string | number | boolean;
 export type OwnedUiSettingApplication = "live" | "restart";
 export interface OwnedUiSettingDeclaration {

package/dist/ui/settings/declarations.js

@@ -1,4 +1,4 @@
-export const OWNED_UI_SETTINGS_VERSION = 2;
+export const OWNED_UI_SETTINGS_VERSION = 3;
 const MAX_ID_LENGTH = 64;
 const ID_PATTERN = /^[a-z][a-z0-9]*(?:[A-Z][a-z0-9]*)*$/;
 const SCROLL_SECTION = Object.freeze({ id: "scroll", title: "Scroll" });
@@ -9,8 +9,8 @@ export const OWNED_UI_SETTING_DECLARATIONS = Object.freeze([
         section: SCROLL_SECTION,
         description: "When the session transcript scrollbar is visible.",
         application: "live",
-        defaultValue: "hover",
-        allowedValues: Object.freeze(["always", "hover", "hidden"]),
+        defaultValue: "auto",
+        allowedValues: Object.freeze(["auto", "always", "hidden"]),
     }),
     Object.freeze({
         id: "scrollbarStyle",

package/dist/ui/settings/migrations.js

@@ -13,6 +13,15 @@ export const OWNED_UI_SETTINGS_MIGRATIONS = Object.freeze([
                 : { ...values };
         },
     }),
+    Object.freeze({
+        to: 3,
+        description: "Match Pi's auto scrollbar appearance name and ordering.",
+        migrate(values) {
+            return values.scrollbarAppearance === "hover"
+                ? { ...values, scrollbarAppearance: "auto" }
+                : { ...values };
+        },
+    }),
 ]);
 export function assertOwnedUiSettingsMigrations(migrations, currentVersion = OWNED_UI_SETTINGS_VERSION) {
     const firstProduced = currentVersion - migrations.length + 1;

package/docs/architecture/boundaries.md

@@ -30,7 +30,7 @@ The owned Pi-backed surface is not an arbitrary-CLI terminal multiplexer. A feat
 - `protocol`: additive control handshake, bounded line framing, authenticated launch-instance commands, typed stop intent, snapshots, and command results.
 - `storage`: SQLite migrations, prior-boot reconciliation, and plural launch-instance persistence. Legacy foreground rows are historical migration input and never authorize current ownership.
 - `supervisor`: endpoint identity, plural cohort ownership, per-instance reconciliation, and aggregate release shutdown coordination. It owns no terminal surface.
-- `pi-engine-adapter`, `pi-component-adapter`, `pi-tui-runtime-adapter`, and `pi-owned-ui-integration`: isolate pinned Pi engine and presentation knowledge behind neutral contracts; product features do not import them directly.
+- `pi-engine-adapter`, `pi-component-adapter`, `pi-tui-runtime-adapter`, and `pi-session-ui-integration`: isolate pinned Pi engine and presentation knowledge behind neutral contracts; product features do not import them directly. The session UI render root assembles semantic document and dock rows, while its focused viewport controller owns follow state, pointer routing, selection, and interaction timers. Owned-app route lifecycle belongs to the neutral `ui-apps` owner and is only hosted by the Pi session UI.
 - release/update/bootstrap: package-derived immutable release identity, process-guardian integrity, cohort selection, durable update transactions, rollback, and dependency-light command entry.
 
 ## Dependency direction

package/docs/architecture/project-structure.md

@@ -23,7 +23,7 @@ src/
     pi/
       components/                  pinned Pi component and theme adaptation
       engine/                      pinned Pi engine, settings, resource, package, and workflow integration
-      owned-ui/                    Pi-backed owned session shell and route host
+      session-ui/                  Pi-backed session shell and A1 viewport integration
       tui-runtime/                 neutral presentation runtime over pinned Pi TUI
   foundation/
     launch-guardian/               authenticated launch-instance coordination

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timurproko/a1",
-  "version": "0.1.8-dev.139",
+  "version": "0.1.8-dev.151",
   "description": "Standalone terminal workspace for supervised native and managed agents",
   "type": "module",
   "packageManager": "npm@11.13.0",
@@ -86,5 +86,8 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "optionalDependencies": {
+    "@mariozechner/clipboard": "^0.3.9"
   }
 }

package/dist/integrations/pi/owned-ui/route-host.d.ts

@@ -1,29 +0,0 @@
-import type { PaneMouseEvent } from "../../../ui/components/index.js";
-/**
- * The seam between the pinned shell and A1-owned screens. The shell asks whether
- * a route is claimed, mounts whatever surface it is handed, and forwards keys to
- * it — it never learns what an app is, and the app layer never reaches into the
- * shell.
- */
-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 shell. */
-    handleInput(data: string): boolean;
-    /** Mouse report in surface-local coordinates. True when consumed. */
-    handleMouse(event: PaneMouseEvent): boolean;
-    /** True once the surface has asked to be dismissed. */
-    isClosed(): boolean;
-    close(): void;
-    /** Called by the shell when the surface should repaint. */
-    onRenderRequested(listener: () => void): void;
-    /** The surface asks to leave A1 entirely, not merely to close itself. */
-    onExitRequested(listener: () => void): void;
-}
-export interface UiRouteHost {
-    /** True when a declared A1-owned surface claims this route. */
-    claims(route: string): boolean;
-    /** Opens the route's surface, or null when it could not be presented. */
-    open(route: string): UiRouteSurface | null;
-}