@timurproko/a1 0.2.6-dev.717 → 0.2.6-dev.727

package/dist/app/session-shell/session-viewport-controller.js

@@ -306,14 +306,14 @@ export class SessionViewportController {
                 if (this.#viewport.clearSelection())
                     this.#requestRender();
             }
-            else {
+            else if (this.#viewport.hasSelection) {
                 const copySelection = this.#viewport.captureSelectedText();
-                if (copySelection !== null) {
-                    this.#viewport.clearSelection();
-                    this.#stopSelectionAutoScroll();
-                    this.#requestRender();
-                    return { data: "", consumed: true, copySelection };
-                }
+                this.#viewport.clearSelection();
+                this.#stopSelectionAutoScroll();
+                this.#requestRender();
+                return copySelection === null
+                    ? { data: "", consumed: true }
+                    : { data: "", consumed: true, copySelection };
             }
         }
         const previousPrompt = SHIFT_UP_INPUTS.has(data) || this.#editor.matchesTerminalKey(data, "alt+home");
@@ -412,12 +412,19 @@ export class SessionViewportController {
                 }
                 if (this.#dockPointerSuppressed || this.#tailPointerSuppressed)
                     return true;
+                const pendingEditorClick = this.#pendingEditorClick;
+                if (pendingEditorClick !== undefined) {
+                    if (event.column === pendingEditorClick.column && event.row === pendingEditorClick.row)
+                        return true;
+                    this.#pendingEditorClick = undefined;
+                    this.#viewport.pressSelection(pendingEditorClick.column, pendingEditorClick.row, now, { continueMultiClick: false });
+                    this.#viewport.extendSelection(event.column, event.row, now, false);
+                    this.#updateSelectionAutoScroll(event.column, event.row, hits.viewportHeight, frame.rows.length);
+                    activity = true;
+                    return true;
+                }
                 if (this.#viewport.selectionActive) {
                     this.#viewport.extendSelection(event.column, event.row, now, false);
-                    if (this.#pendingEditorClick !== undefined
-                        && (event.column !== this.#pendingEditorClick.column || event.row !== this.#pendingEditorClick.row)) {
-                        this.#pendingEditorClick = undefined;
-                    }
                     this.#updateSelectionAutoScroll(event.column, event.row, hits.viewportHeight, frame.rows.length);
                     activity = true;
                     return true;
@@ -500,11 +507,13 @@ export class SessionViewportController {
                 }
                 if (event.row >= 1 && event.row <= frame.rows.length && event.column <= frame.descriptor.width) {
                     if (editorFrame !== undefined && event.row >= editorFrame.rowStart && event.row <= editorFrame.rowEnd) {
+                        // Invariant: no-drag prompt clicks remain visually editor-owned. Distinct
+                        // motion promotes from this exact origin into complete-frame selection.
                         this.#pendingEditorClick = { column: event.column, row: event.row };
                     }
-                    // Invariant: frame selection includes transient and dock rows without changing
-                    // semantic ownership; no-drag editor presses replay on release.
-                    this.#viewport.pressSelection(event.column, event.row, now);
+                    else {
+                        this.#viewport.pressSelection(event.column, event.row, now);
+                    }
                     repaint = true;
                     return true;
                 }
@@ -525,19 +534,22 @@ export class SessionViewportController {
                     repaint = true;
                     return true;
                 }
-                if (this.#viewport.releaseSelection()) {
-                    this.#stopSelectionAutoScroll();
-                    const pendingEditorClick = this.#pendingEditorClick;
+                const pendingEditorClick = this.#pendingEditorClick;
+                if (pendingEditorClick !== undefined) {
                     this.#pendingEditorClick = undefined;
-                    if (pendingEditorClick !== undefined && this.#editorPointerFrame !== undefined) {
-                        this.#viewport.clearSelection();
+                    if (this.#editorPointerFrame !== undefined) {
                         const editorRow = pendingEditorClick.row - this.#editorPointerFrame.rowStart + 1;
                         this.#editor.handlePointer({ kind: "press", button: 0, column: pendingEditorClick.column, row: editorRow });
                         this.#editor.handlePointer({ kind: "release", button: 0, column: pendingEditorClick.column, row: editorRow });
                     }
-                    else if (this.#copyOnSelect) {
+                    forceRepaint = true;
+                    repaint = true;
+                    return true;
+                }
+                if (this.#viewport.releaseSelection()) {
+                    this.#stopSelectionAutoScroll();
+                    if (this.#copyOnSelect)
                         completedCopy = this.#viewport.captureSelectedText() ?? undefined;
-                    }
                     // Platform: restore OSC 8 links only after the held-button selection paint has
                     // ended, then overwrite any terminal-cached hover cells immediately.
                     forceRepaint = true;

package/dist/cli/dispatch.js

@@ -18,6 +18,7 @@ export function cliUsage(capabilities) {
         "remove <source>",
         "uninstall <source>",
         "list",
+        "session worktrees",
         "session link-worktree <path>",
         "session unlink-worktree",
     ]);
@@ -47,6 +48,7 @@ export function cliHelp(capabilities) {
         `  ${command} list`,
         "",
         "Session context:",
+        `  ${command} session worktrees`,
         `  ${command} session link-worktree <path>`,
         `  ${command} session unlink-worktree`,
         "",
@@ -127,12 +129,12 @@ function parseSessionContext(rest) {
             return { kind: "error", message: PRODUCT_TEXT.diagnostic("session link-worktree accepts one path.") };
         return { kind: "session-context", request: { action, path: value } };
     }
-    if (action === "unlink-worktree") {
+    if (action === "unlink-worktree" || action === "worktrees") {
         if (value !== undefined)
-            return { kind: "error", message: PRODUCT_TEXT.diagnostic("session unlink-worktree does not accept arguments.") };
+            return { kind: "error", message: PRODUCT_TEXT.diagnostic(`session ${action} does not accept arguments.`) };
         return { kind: "session-context", request: { action } };
     }
-    return { kind: "error", message: PRODUCT_TEXT.diagnostic("session accepts link-worktree <path> or unlink-worktree.") };
+    return { kind: "error", message: PRODUCT_TEXT.diagnostic("session accepts worktrees, link-worktree <path>, or unlink-worktree.") };
 }
 /**
  * Stable update is the empty form. `--develop` selects the moving development

package/dist/cli/session-context.d.ts

@@ -2,8 +2,12 @@ import { type SessionContextRequest } from "../features/launch/index.js";
 export type { SessionContextRequest } from "../features/launch/index.js";
 export interface SessionContextCommandOptions {
     readonly environment?: NodeJS.ProcessEnv;
+    readonly inspectProcess?: (pid: number) => Promise<{
+        readonly pid: number;
+        readonly startIdentity: string;
+    } | null>;
     readonly stdout?: (message: string) => void;
     readonly stderr?: (message: string) => void;
 }
-/** Apply repository presentation context only when invoked by an active Pi session shell tool. */
+/** Apply repository context only when invoked by an exact live A1 shell-tool runtime. */
 export declare function runSessionContextCommand(request: SessionContextRequest, options?: SessionContextCommandOptions): Promise<number>;

package/dist/cli/session-context.js

@@ -1,29 +1,46 @@
 import { updateSessionRepositoryContext, } from "../features/launch/index.js";
-import { PRODUCT_TEXT } from "../product-identity.js";
-/** Apply repository presentation context only when invoked by an active Pi session shell tool. */
+import { PRODUCT_IDENTITY, PRODUCT_TEXT } from "../product-identity.js";
+/** Apply repository context only when invoked by an exact live A1 shell-tool runtime. */
 export async function runSessionContextCommand(request, options = {}) {
     const environment = options.environment ?? process.env;
     const stdout = options.stdout ?? (message => process.stdout.write(message));
     const stderr = options.stderr ?? (message => process.stderr.write(message));
     const identity = readIdentity(environment);
     if (identity === null) {
-        stderr(`${PRODUCT_TEXT.diagnostic("session context requires an active A1 shell-tool session.")}\n`);
+        stderr(`${PRODUCT_TEXT.diagnostic("session context requires an active A1 shell-tool session runtime.")}\n`);
         return 2;
     }
     try {
-        const cwd = await updateSessionRepositoryContext(identity, request);
-        stdout(cwd === null ? "Session worktree context cleared.\n" : `Session worktree context linked: ${cwd}\n`);
+        if (options.inspectProcess === undefined)
+            throw Object.assign(new Error("native process identity inspection is unavailable"), { code: "process-inspection-unavailable" });
+        const outcome = await updateSessionRepositoryContext({ sessionId: identity.sessionId, sessionFile: identity.sessionFile }, request, { runtimeId: identity.runtimeId, inspectProcess: options.inspectProcess });
+        if (outcome.kind === "unlinked")
+            stdout("Session worktree context cleared.\n");
+        if (outcome.kind === "linked")
+            stdout(`Session worktree context linked: ${outcome.cwd}\n`);
+        if (outcome.kind === "worktrees") {
+            for (const entry of outcome.entries)
+                stdout(`${entry.status}: ${entry.cwd} (${entry.branch})\n`);
+        }
         return 0;
     }
     catch (error) {
-        stderr(`${PRODUCT_TEXT.diagnostic(`could not update session context: ${error instanceof Error ? error.message : String(error)}`)}\n`);
+        const code = errorCode(error);
+        const detail = error instanceof Error ? error.message : String(error);
+        stderr(`${PRODUCT_TEXT.diagnostic(`could not update session context${code === null ? "" : ` (${code})`}: ${detail}`)}\n`);
         return 1;
     }
 }
 function readIdentity(environment) {
     const sessionId = environment.PI_SESSION_ID;
     const sessionFile = environment.PI_SESSION_FILE;
-    if (!sessionId || !sessionFile)
+    const runtimeId = environment[PRODUCT_IDENTITY.environment.sessionRuntimeId];
+    if (!sessionId || !sessionFile || !runtimeId)
         return null;
-    return { sessionId, sessionFile };
+    return { sessionId, sessionFile, runtimeId };
+}
+function errorCode(error) {
+    if (error instanceof Error && "code" in error && typeof error.code === "string")
+        return error.code;
+    return null;
 }

package/dist/composition/owned-ui.d.ts

@@ -1,4 +1,5 @@
 import type { AvailableRelease, StartupReleaseCheckOptions } from "../foundation/release/latest-release.js";
+import type { NativeProcessIdentity } from "../foundation/lifecycle/model.js";
 import type { SessionSelection } from "../foundation/lifecycle/session-selection.js";
 import type { PiEngineAdapter } from "../integrations/pi/engine/adapter.js";
 import type { PiProjectTrustPreflightPrompt } from "../integrations/pi/engine/project-trust-preflight.js";
@@ -34,6 +35,8 @@ export interface OwnedUiCompositionOptions {
     readonly releaseNotes?: ReleaseNoteCatalog;
     /** Startup release-availability seam; defaults to the throttled registry check. */
     readonly checkForNewerRelease?: (options: StartupReleaseCheckOptions) => Promise<AvailableRelease | null>;
+    /** Exact native process inspection injected by the shipped entry; absent SDK seams do not publish claims. */
+    readonly inspectProcess?: (pid: number) => Promise<NativeProcessIdentity | null>;
 }
 export interface OwnedUiComposition {
     readonly application: OwnedUiApplicationPort;

package/dist/composition/owned-ui.js

@@ -6,8 +6,7 @@ import { PromptImageSidecar } from "../features/prompt-history/image-sidecar.js"
 import { resolvePromptHistoryPath } from "../features/prompt-history/paths.js";
 import { resolvePromptHistoryDataDir } from "../features/launch/profile-paths.js";
 import { resolveProductPaths } from "../foundation/lifecycle/paths.js";
-import { readSessionRepositoryContext } from "../foundation/lifecycle/session-repository-context.js";
-import { applyConfiguredPiTheme, getAvailablePiThemes } from "../integrations/pi/components/upstream/theme/theme.js";
+import { applyConfiguredPiTheme, getAvailablePiThemes, setPiAccentColor, setPiPackageBorderProjectionEnabled } from "../integrations/pi/components/upstream/theme/theme.js";
 import { createPiEngineAdapter } from "../integrations/pi/engine/adapter.js";
 import { ClipboardDiagnosticCapture } from "../app/session-shell/clipboard-diagnostics.js";
 import { OwnedUiSessionShell } from "../app/session-shell/session-shell.js";
@@ -16,12 +15,46 @@ import { createPiTerminalBridge } from "../integrations/pi/tui-runtime/presentat
 import { createOwnedRouteHost } from "./settings-route-host.js";
 import { renderPiShellChangelogLines } from "../integrations/pi/components/shell-presenters-info.js";
 import { nativeHyperlinkStyle } from "../ui/components/spans.js";
+const SESSION_RUNTIME_REFRESH_MS = 30_000;
 export async function composeOwnedUiApplication(options = {}) {
     return (await composeOwnedUi(options)).application;
 }
 export async function composeOwnedUi(options = {}) {
     const cwd = options.cwd ?? process.cwd();
     const ownedSurfaces = options.ownedSurfaces !== "off";
+    const sessionRuntimeId = ownedSurfaces ? process.env[PRODUCT_IDENTITY.environment.sessionRuntimeId] : undefined;
+    const inspectSessionProcess = options.inspectProcess;
+    let sessionRuntimeIdentity = null;
+    let activeSessionIdentity = null;
+    let sessionRuntimeRefreshTimer = null;
+    let sessionRuntimeRefresh = Promise.resolve();
+    let sessionRuntimeDisposed = false;
+    const runtimeIdentity = async () => {
+        if (sessionRuntimeId === undefined || inspectSessionProcess === undefined)
+            return null;
+        sessionRuntimeIdentity ??= inspectSessionProcess(process.pid).catch(() => null);
+        return await sessionRuntimeIdentity;
+    };
+    const queueSessionRuntimeRefresh = () => {
+        if (sessionRuntimeDisposed || activeSessionIdentity === null || sessionRuntimeId === undefined || inspectSessionProcess === undefined)
+            return;
+        sessionRuntimeRefresh = sessionRuntimeRefresh.then(async () => {
+            const identity = activeSessionIdentity;
+            if (sessionRuntimeDisposed || identity === null)
+                return;
+            const owner = await runtimeIdentity();
+            if (owner === null)
+                return;
+            const { registerSessionRepositoryRuntime } = await import("../foundation/lifecycle/session-repository-context.js");
+            await registerSessionRepositoryRuntime(identity, sessionRuntimeId, owner, { inspectProcess: inspectSessionProcess });
+        }).catch(() => undefined);
+    };
+    const armSessionRuntimeRefresh = () => {
+        if (sessionRuntimeRefreshTimer !== null)
+            return;
+        sessionRuntimeRefreshTimer = setInterval(queueSessionRuntimeRefresh, SESSION_RUNTIME_REFRESH_MS);
+        sessionRuntimeRefreshTimer.unref();
+    };
     const adapter = options.createPiAdapter
         ? await options.createPiAdapter()
         : await createPiEngineAdapter({
@@ -30,7 +63,16 @@ export async function composeOwnedUi(options = {}) {
             settingsProductMode: ownedSurfaces ? "bare" : "comparison",
             announceStartupChangelog: !ownedSurfaces,
             ...(ownedSurfaces ? {
-                repositoryContextReader: async (sessionId, sessionFile, signal) => await readSessionRepositoryContext({ sessionId, sessionFile }, { signal }),
+                repositoryContextReader: async (sessionId, sessionFile, signal) => {
+                    const owner = await runtimeIdentity();
+                    if (owner === null || sessionRuntimeId === undefined || inspectSessionProcess === undefined)
+                        return null;
+                    activeSessionIdentity = { sessionId, sessionFile };
+                    const { activateSessionRepositoryContext } = await import("../foundation/lifecycle/session-repository-context.js");
+                    const context = await activateSessionRepositoryContext(activeSessionIdentity, sessionRuntimeId, owner, { signal, inspectProcess: inspectSessionProcess });
+                    armSessionRuntimeRefresh();
+                    return context;
+                },
             } : {}),
             ...(options.sessionPath === undefined ? {} : { sessionPath: options.sessionPath }),
             ...(options.sessionSelection === undefined ? {} : { sessionSelection: options.sessionSelection }),
@@ -67,10 +109,15 @@ export async function composeOwnedUi(options = {}) {
         : await import("../features/owned-ui/release-note-state.js").then(module => module.claimReleaseNote({
             configDir: productPaths.configDir, profileId: options.profileId, version: currentReleaseNote.version,
         }));
-    // Compatibility: bare A1 intentionally ships one visual target while its UI is being completed:
-    // dark, regardless of terminal detection or a previously stored Pi theme. The
-    // comparison profile keeps Pi's configured theme behavior and settings surface.
+    // Compatibility: bare A1 intentionally ships one base visual target while its UI is being completed:
+    // dark, regardless of terminal detection or a previously stored Pi theme. Its owned accent projects
+    // over that base; comparison keeps Pi's configured theme and unmodified semantic accent.
+    setPiPackageBorderProjectionEnabled(ownedSurfaces);
+    setPiAccentColor(settings !== null && ownedSurfaces ? settings.value("accentColor") : "purple");
     applyConfiguredPiTheme(ownedSurfaces ? "dark" : adapter.configuredTheme());
+    const unsubscribeAccent = settings === null || !ownedSurfaces
+        ? () => { }
+        : settings.onChange(current => setPiAccentColor(current.value("accentColor")));
     // Rationale: Routes open only after shell construction.
     const references = {
         changelog: async (input) => {
@@ -167,6 +214,7 @@ export async function composeOwnedUi(options = {}) {
         });
     }
     catch (error) {
+        unsubscribeAccent();
         await releaseNoteClaim?.release();
         clipboardDiagnostics?.dispose();
         suggestionDiagnostics?.dispose();
@@ -211,6 +259,18 @@ export async function composeOwnedUi(options = {}) {
                 await releaseNoteAcknowledgement?.catch(() => undefined);
             }
             finally {
+                unsubscribeAccent();
+                sessionRuntimeDisposed = true;
+                if (sessionRuntimeRefreshTimer !== null)
+                    clearInterval(sessionRuntimeRefreshTimer);
+                sessionRuntimeRefreshTimer = null;
+                await sessionRuntimeRefresh;
+                const owner = await runtimeIdentity();
+                if (sessionRuntimeId !== undefined && owner !== null) {
+                    await import("../foundation/lifecycle/session-repository-context.js")
+                        .then(module => module.releaseSessionRepositoryRuntime(sessionRuntimeId, owner))
+                        .catch(() => undefined);
+                }
                 await releaseNoteClaim?.release();
                 suggestionDiagnostics?.dispose();
                 clipboardDiagnostics?.dispose();

package/dist/composition/settings-route-host.js

@@ -1,6 +1,6 @@
 import { CHANGELOG_ROUTE, HOTKEYS_ROUTE, HOTKEYS_TITLE } from "../features/owned-ui/reference-routes.js";
 import { SETTINGS_APP_ID, SETTINGS_ROUTE } from "../features/owned-ui/settings-route.js";
-import { piTheme } from "../integrations/pi/components/upstream/theme/theme.js";
+import { piTheme, renderPiAccentPreview } from "../integrations/pi/components/upstream/theme/theme.js";
 import { faint } from "../ui/components/text.js";
 /** Declares settings and lazy document routes. */
 export function createOwnedRouteHost(settings, references) {
@@ -130,6 +130,7 @@ function pinnedTheme() {
         fg: (token, text) => piTheme().fg(token, text),
         bold: (text) => piTheme().bold(text),
         plain: (text) => text,
+        accentPreview: (color, text) => renderPiAccentPreview(color, text),
         disabled: (text) => faint(piTheme().fg("dim", text)),
         highlight: (text) => piTheme().bg("selectedBg", text),
         panel: (text) => `\u001b[48;2;55;55;55m${text}\u001b[49m`,

package/dist/contracts/owned-ui/index.d.ts

@@ -1,3 +1,5 @@
+/** Stable stored choices for bare A1's semantic UI accent. */
+export type UiAccentColor = "purple" | "blue" | "cyan" | "green" | "orange" | "pink";
 export { OWNED_UI_EXTENSION_CONTRACT_VERSION, OWNED_UI_EXTENSION_RENDER_CALLBACKS, OWNED_UI_EXTENSION_UI_CALLBACKS, OWNED_UI_EXTENSION_UI_PROPERTIES, assertOwnedUiExtensionUiPort, } from "./extension-ui.js";
 export type { OwnedUiExtensionAutocompleteItem, OwnedUiExtensionAutocompleteProvider, OwnedUiExtensionAutocompleteProviderFactory, OwnedUiExtensionAutocompleteSuggestions, OwnedUiExtensionComponent, OwnedUiExtensionComponentFactory, OwnedUiExtensionComponentFactoryContext, OwnedUiExtensionCustomFactory, OwnedUiExtensionCustomOptions, OwnedUiExtensionDialogOptions, OwnedUiExtensionEditorComponent, OwnedUiExtensionEditorFactory, OwnedUiExtensionEditorThemePort, OwnedUiExtensionEntryRenderInput, OwnedUiExtensionFooterDataPort, OwnedUiExtensionFooterFactory, OwnedUiExtensionInputListener, OwnedUiExtensionKeybindingsPort, OwnedUiExtensionMessageRenderInput, OwnedUiExtensionNotificationSeverity, OwnedUiExtensionOverlayAnchor, OwnedUiExtensionOverlayHandle, OwnedUiExtensionOverlayMargin, OwnedUiExtensionOverlayOptions, OwnedUiExtensionRenderCallback, OwnedUiExtensionRendererPort, OwnedUiExtensionRuntimePort, OwnedUiExtensionSelectListThemePort, OwnedUiExtensionSizeValue, OwnedUiExtensionTerminalPort, OwnedUiExtensionThemeBackground, OwnedUiExtensionThemeColor, OwnedUiExtensionThemeInfo, OwnedUiExtensionThemePort, OwnedUiExtensionToolRenderContext, OwnedUiExtensionUiCallback, OwnedUiExtensionUiPort, OwnedUiExtensionUiProperty, OwnedUiExtensionWidgetOptions, OwnedUiExtensionWidgetPlacement, OwnedUiExtensionWorkingIndicatorOptions, } from "./extension-ui.js";
 export { OWNED_UI_CONTRACT_VERSION } from "./model.js";
@@ -7,8 +9,8 @@ export { DEFAULT_PROMPT_IMAGE_LIMIT, ImageAttachmentError, MAX_CLIPBOARD_TEXT_BY
 export { CONTEXTUAL_PROMPT_SUGGESTION_INSTRUCTION, normalizePromptSuggestionCandidate } from "./prompt-suggestions.js";
 export { canonicalPromptChipMatches, protectPromptChipWrapping, replaceCanonicalPromptChips } from "./prompt-chips.js";
 export type { PromptChipTextMatch, PromptChipWrapProtection } from "./prompt-chips.js";
-export { SUGGESTION_DECISION_REASONS, SUGGESTION_DIAGNOSTIC_EVENTS } from "./suggestion-diagnostics.js";
-export type { SuggestionDecision, SuggestionDecisionReason, SuggestionDiagnosticEvent, SuggestionDiagnosticObserver, SuggestionDiagnosticRecord, } from "./suggestion-diagnostics.js";
+export { SUGGESTION_ATTEMPT_TRIGGERS, SUGGESTION_DECISION_REASONS, SUGGESTION_DIAGNOSTIC_EVENTS } from "./suggestion-diagnostics.js";
+export type { SuggestionAttemptTrigger, SuggestionDecision, SuggestionDecisionReason, SuggestionDiagnosticEvent, SuggestionDiagnosticObserver, SuggestionDiagnosticRecord, } from "./suggestion-diagnostics.js";
 export { PROMPT_HISTORY_EDITOR_REPLACEMENT, PROMPT_HISTORY_MAX_ENTRY_BYTES, PROMPT_HISTORY_MAX_PENDING, PROMPT_HISTORY_MAX_TEXT_BYTES, assertPromptHistorySubmission, } from "./prompt-history.js";
 export type { PromptHistoryFailure, PromptHistoryImageSidecarAttachment, PromptHistoryImageSidecarPort, PromptHistoryImageSidecarRecord, PromptHistoryKind, PromptHistoryPort, PromptHistoryResult, PromptHistorySnapshot, PromptHistorySubmission, } from "./prompt-history.js";
 export { assertOwnedUiCommand, assertOwnedUiCustomization, assertOwnedUiDiagnostics, assertOwnedUiEditorState, assertOwnedUiEvent, assertOwnedUiPromptSuggestionIdentity, assertOwnedUiPromptSuggestionRequest, assertOwnedUiPromptSuggestionResult, assertOwnedUiPromptSuggestionState, assertOwnedUiSessionViewModel, assertOwnedUiSnapshot, assertOwnedUiStatusView, assertOwnedUiTerminalSurface, assertOwnedUiTranscriptBlock, } from "./validation.js";

package/dist/contracts/owned-ui/index.js

@@ -4,6 +4,6 @@ export { acceptsTranscriptUpdate, transcriptToolState } from "./transcript-lifec
 export { DEFAULT_PROMPT_IMAGE_LIMIT, ImageAttachmentError, MAX_CLIPBOARD_TEXT_BYTES, MAX_IMAGE_DATA_BYTES, MAX_PROMPT_IMAGES, assertImageEncodedSize, assertPromptImages, } from "./image-attachments.js";
 export { CONTEXTUAL_PROMPT_SUGGESTION_INSTRUCTION, normalizePromptSuggestionCandidate } from "./prompt-suggestions.js";
 export { canonicalPromptChipMatches, protectPromptChipWrapping, replaceCanonicalPromptChips } from "./prompt-chips.js";
-export { SUGGESTION_DECISION_REASONS, SUGGESTION_DIAGNOSTIC_EVENTS } from "./suggestion-diagnostics.js";
+export { SUGGESTION_ATTEMPT_TRIGGERS, SUGGESTION_DECISION_REASONS, SUGGESTION_DIAGNOSTIC_EVENTS } from "./suggestion-diagnostics.js";
 export { PROMPT_HISTORY_EDITOR_REPLACEMENT, PROMPT_HISTORY_MAX_ENTRY_BYTES, PROMPT_HISTORY_MAX_PENDING, PROMPT_HISTORY_MAX_TEXT_BYTES, assertPromptHistorySubmission, } from "./prompt-history.js";
 export { assertOwnedUiCommand, assertOwnedUiCustomization, assertOwnedUiDiagnostics, assertOwnedUiEditorState, assertOwnedUiEvent, assertOwnedUiPromptSuggestionIdentity, assertOwnedUiPromptSuggestionRequest, assertOwnedUiPromptSuggestionResult, assertOwnedUiPromptSuggestionState, assertOwnedUiSessionViewModel, assertOwnedUiSnapshot, assertOwnedUiStatusView, assertOwnedUiTerminalSurface, assertOwnedUiTranscriptBlock, } from "./validation.js";

package/dist/contracts/owned-ui/model.d.ts

@@ -336,6 +336,10 @@ export type OwnedUiEvent = {
     readonly model: OwnedUiModelInfo | null;
     readonly assistantMessageCount: number;
     readonly successful: boolean;
+    readonly stopReason: string | null;
+    readonly toolContinuation: boolean;
+    /** Pi 1.1 distinguishes user cancellation from an ordinary or failed settlement. */
+    readonly aborted: boolean;
 } | {
     readonly type: "editor-state";
     readonly sessionId: OwnedUiSessionId;

package/dist/contracts/owned-ui/suggestion-diagnostics.d.ts

@@ -2,12 +2,16 @@ import type { OwnedUiPromptSuggestionReasoning } from "./model.js";
 export declare const SUGGESTION_DECISION_REASONS: readonly ["disabled", "disposed", "early-conversation", "no-model", "failed-response", "incomplete-response", "tool-continuation", "replacement-input", "modal", "draft", "not-ready", "not-focused", "autocomplete", "prompt-mode", "presentation-unavailable", "ineligible", "stale-identity"];
 export type SuggestionDecisionReason = typeof SUGGESTION_DECISION_REASONS[number];
 export type SuggestionDecision = SuggestionDecisionReason | null;
-export declare const SUGGESTION_DIAGNOSTIC_EVENTS: readonly ["skipped", "started", "displayed", "empty", "rejected", "provider-failure", "unavailable", "timeout", "cancelled", "stale-result", "presentation-blocked", "late-result-discarded"];
+export declare const SUGGESTION_DIAGNOSTIC_EVENTS: readonly ["skipped", "started", "displayed", "empty", "rejected", "provider-failure", "unavailable", "timeout", "cancelled", "stale-result", "presentation-blocked", "presentation-deferred", "retry-exhausted", "late-result-discarded"];
 export type SuggestionDiagnosticEvent = typeof SUGGESTION_DIAGNOSTIC_EVENTS[number];
+export declare const SUGGESTION_ATTEMPT_TRIGGERS: readonly ["prefetch", "settlement", "retry"];
+export type SuggestionAttemptTrigger = typeof SUGGESTION_ATTEMPT_TRIGGERS[number];
 /** Metadata only: never carry a session path, prompt, candidate, or raw error. */
 export interface SuggestionDiagnosticRecord {
     readonly event: SuggestionDiagnosticEvent;
     readonly reason?: SuggestionDecisionReason;
+    readonly attempt?: number;
+    readonly trigger?: SuggestionAttemptTrigger;
     readonly session: number;
     readonly run: number;
     readonly response: number;

package/dist/contracts/owned-ui/suggestion-diagnostics.js

@@ -5,5 +5,7 @@ export const SUGGESTION_DECISION_REASONS = [
 ];
 export const SUGGESTION_DIAGNOSTIC_EVENTS = [
     "skipped", "started", "displayed", "empty", "rejected", "provider-failure", "unavailable",
-    "timeout", "cancelled", "stale-result", "presentation-blocked", "late-result-discarded",
+    "timeout", "cancelled", "stale-result", "presentation-blocked", "presentation-deferred",
+    "retry-exhausted", "late-result-discarded",
 ];
+export const SUGGESTION_ATTEMPT_TRIGGERS = ["prefetch", "settlement", "retry"];

package/dist/contracts/owned-ui/validation.js

@@ -133,6 +133,13 @@ export function assertOwnedUiEvent(event) {
                 assertOwnedUiModelInfo(event.model);
             if (typeof event.successful !== "boolean")
                 throw new TypeError("owned-UI settlement success state is invalid");
+            if (event.stopReason === undefined)
+                throw new TypeError("owned-UI settlement stop reason is missing");
+            assertOptionalText(event.stopReason, "owned-UI settlement stop reason", MAX_LABEL_LENGTH);
+            if (typeof event.toolContinuation !== "boolean")
+                throw new TypeError("owned-UI settlement tool-continuation state is invalid");
+            if (typeof event.aborted !== "boolean")
+                throw new TypeError("owned-UI settlement aborted state is invalid");
             return;
         case "editor-state":
             assertOwnedUiEditorState(event.editor);

package/dist/features/launch/index.d.ts

@@ -9,6 +9,6 @@ export type { LaunchProfilePathOptions, LaunchProfilePaths } from "./profile-pat
 export { prepareInteractiveLaunch } from "./prepare-launch.js";
 export type { PrepareInteractiveLaunchOptions, PreparedInteractiveLaunch } from "./prepare-launch.js";
 export { updateSessionRepositoryContext } from "./session-context.js";
-export type { SessionContextRequest } from "./session-context.js";
+export type { SessionContextOutcome, SessionContextRequest, SessionContextRuntime } from "./session-context.js";
 export { runSelectedInteractiveRuntime, selectInteractiveRuntime } from "./runtime-selection.js";
 export type { InteractiveRuntimeRunners, InteractiveRuntimeSelection, OwnedUiProfileId } from "./runtime-selection.js";

package/dist/features/launch/session-context.d.ts

@@ -1,8 +1,23 @@
-import { type SessionRepositoryIdentity } from "../../foundation/lifecycle/index.js";
+import { type NativeProcessIdentity, type SessionRepositoryIdentity, type SessionWorktreeInventoryEntry } from "../../foundation/lifecycle/index.js";
 export type SessionContextRequest = {
     readonly action: "link-worktree";
     readonly path: string;
 } | {
     readonly action: "unlink-worktree";
+} | {
+    readonly action: "worktrees";
+};
+export type SessionContextOutcome = {
+    readonly kind: "linked";
+    readonly cwd: string;
+} | {
+    readonly kind: "unlinked";
+} | {
+    readonly kind: "worktrees";
+    readonly entries: readonly SessionWorktreeInventoryEntry[];
 };
-export declare function updateSessionRepositoryContext(identity: SessionRepositoryIdentity, request: SessionContextRequest): Promise<string | null>;
+export interface SessionContextRuntime {
+    readonly runtimeId: string;
+    readonly inspectProcess: (pid: number) => Promise<NativeProcessIdentity | null>;
+}
+export declare function updateSessionRepositoryContext(identity: SessionRepositoryIdentity, request: SessionContextRequest, runtime: SessionContextRuntime): Promise<SessionContextOutcome>;

package/dist/features/launch/session-context.js

@@ -1,8 +1,12 @@
-import { clearSessionRepositoryContext, setSessionRepositoryContext, } from "../../foundation/lifecycle/index.js";
-export async function updateSessionRepositoryContext(identity, request) {
+import { clearSessionRepositoryContext, listSessionRepositoryWorktrees, setSessionRepositoryContext, } from "../../foundation/lifecycle/index.js";
+export async function updateSessionRepositoryContext(identity, request, runtime) {
+    const options = { runtimeId: runtime.runtimeId, inspectProcess: runtime.inspectProcess };
     if (request.action === "unlink-worktree") {
-        await clearSessionRepositoryContext(identity);
-        return null;
+        await clearSessionRepositoryContext(identity, options);
+        return { kind: "unlinked" };
     }
-    return (await setSessionRepositoryContext(identity, request.path)).cwd;
+    if (request.action === "worktrees") {
+        return { kind: "worktrees", entries: await listSessionRepositoryWorktrees(identity, options) };
+    }
+    return { kind: "linked", cwd: (await setSessionRepositoryContext(identity, request.path, options)).cwd };
 }

package/dist/features/owned-ui/settings-app.js

@@ -343,25 +343,27 @@ export class SettingsApp {
                 this.#apply(menu.entry, value);
             return { consumed: true };
         }
-        if (this.#structured !== null) {
-            // Invariant: the structured surface is keyboard-only. It owns every pointer report so
-            // neither its selection nor the Settings list behind it can react.
-            return { consumed: true, render: false };
-        }
         if (event.kind === "wheel-up" || event.kind === "wheel-down") {
             // Invariant: the whole list pane owns wheel scrolling, including blank space beside
-            // short labels. It must not depend on finding an item under the pointer.
+            // short labels. A fixed structured dialog keeps that content interaction available.
             const screenRow = event.row - 1;
             const wheelBottom = this.#filter === null
                 ? this.#bodyTopForFrame + this.#bodyHeightForFrame
                 : this.#panelTopForFrame + SETTINGS_SEARCH_INPUT_ROWS + SETTINGS_STATUS_ROWS;
-            if (screenRow < 0 || screenRow >= wheelBottom)
+            if (screenRow >= 0 && screenRow < wheelBottom) {
+                const distance = scrollbarWheelRows(this.#scrollbarSpeed());
+                if (this.#filter !== null)
+                    this.#scrollBeforeFilter = null;
+                this.#scroll = Math.max(0, this.#scroll + (event.kind === "wheel-down" ? distance : -distance));
+                return { consumed: true };
+            }
+            if (this.#structured === null)
                 return { consumed: false };
-            const distance = scrollbarWheelRows(this.#scrollbarSpeed());
-            if (this.#filter !== null)
-                this.#scrollBeforeFilter = null;
-            this.#scroll = Math.max(0, this.#scroll + (event.kind === "wheel-down" ? distance : -distance));
-            return { consumed: true };
+        }
+        if (this.#structured !== null) {
+            // Invariant: the structured surface is keyboard-only. Non-content-wheel pointer reports
+            // cannot change its selection or act on the Settings list behind it.
+            return { consumed: true, render: false };
         }
         const rail = this.#railPointer(event);
         if (rail.owned)
@@ -623,9 +625,7 @@ export class SettingsApp {
             const failure = changeFailure(outcome);
             if (failure === null) {
                 this.#recordUndo({ kind: "structured", sequence, entry: open.entry, previous, forward });
-                this.#notice = outcome.status === "deferred" && outcome.application !== null
-                    ? `${labelOf(open.entry)} is stored and applies ${applicationLabel(outcome.application)}`
-                    : null;
+                this.#notice = null;
                 return;
             }
             // Concurrency: only roll back the dialog if no later press has moved the record on.
@@ -766,9 +766,7 @@ export class SettingsApp {
             // Concurrency: a later press may have moved on; only the last request clears itself.
             if (this.#pending.get(key) === value)
                 this.#pending.delete(key);
-            this.#notice = outcome.status === "deferred" && outcome.application !== null
-                ? `${labelOf(entry)} is stored and applies ${applicationLabel(outcome.application)}`
-                : null;
+            this.#notice = null;
         });
     }
     #shownValue(entry) {
@@ -825,9 +823,7 @@ export class SettingsApp {
             this.#notice = `Could not restore ${labelOf(record.entry)}: ${failure}`;
         }
         else {
-            this.#notice = outcome.status === "deferred" && outcome.application !== null
-                ? `${labelOf(record.entry)} is restored and applies ${applicationLabel(outcome.application)}`
-                : null;
+            this.#notice = null;
         }
         this.#undoActive = false;
         this.#drainUndo();
@@ -925,7 +921,7 @@ export class SettingsApp {
             ? CONFIGURE
             : shown === null
                 ? describeRaw(entry.rawValue)
-                : this.#pending.has(key) ? displayValue(shown) : effectiveDisplay(entry, shown);
+                : displayValue(shown);
         const range = rangeOf(entry);
         return {
             key,
@@ -943,6 +939,9 @@ export class SettingsApp {
         }
         const state = {
             choices: menu.choices.map(choice => displayValue(choice)),
+            ...(menu.entry.id === "accentColor" ? {
+                previews: menu.choices.map(choice => theme.accentPreview?.(String(choice), "■") ?? ""),
+            } : {}),
             current: this.#shownValue(menu.entry) === null ? null : displayValue(this.#shownValue(menu.entry)),
             index: menu.index,
         };
@@ -1098,23 +1097,6 @@ function displayValue(value) {
         return value ? "yes" : "no";
     return String(value);
 }
-function effectiveDisplay(entry, stored) {
-    const effective = entry.effectiveValue;
-    if (effective === stored)
-        return displayValue(stored);
-    const shownEffective = typeof effective === "string" || typeof effective === "number" || typeof effective === "boolean"
-        ? displayValue(effective)
-        : describeRaw(effective);
-    return `${displayValue(stored)} (effective ${shownEffective}; ${applicationLabel(entry.application)})`;
-}
-function applicationLabel(application) {
-    switch (application) {
-        case "live": return "live";
-        case "next-session": return "in the next session";
-        case "next-start": return "on the next start";
-        case "current-exit": return "when the current session exits";
-    }
-}
 function describeRaw(value) {
     if (value === null || value === undefined)
         return "unset";