@timurproko/a1 0.2.5 → 0.2.6-dev.727

package/bin/cli.js

@@ -55,8 +55,19 @@ process.exitCode = await dispatchCli(process.argv.slice(2), {
     return await runPackageCommand(request, { createPort: createPiPackagesPort });
   },
   sessionContext: async request => {
-    const { runSessionContextCommand } = await import("../dist/cli/session-context.js");
-    return await runSessionContextCommand(request);
+    const [{ runSessionContextCommand }, { createNativeProcessInspector }, { readLaunchContext }] = await Promise.all([
+      import("../dist/cli/session-context.js"),
+      import("../dist/foundation/process-containment/native-process-inspector.js"),
+      import("../dist/foundation/launch-context/index.js"),
+    ]);
+    const launch = readLaunchContext(process.env);
+    let inspector;
+    return await runSessionContextCommand(request, {
+      inspectProcess: async pid => {
+        inspector ??= createNativeProcessInspector(process.env, process.platform, launch.releaseRoot);
+        return (await inspector).observe(pid);
+      },
+    });
   },
 }, {
   stdout: message => process.stdout.write(message),

package/bin/ui.js

@@ -9,6 +9,13 @@ const { readLaunchContext } = await import("../dist/foundation/launch-context/in
 const launchContext = readLaunchContext(process.env, "profile");
 const profile = launchContext.launchProfile;
 if (profile === undefined) throw new Error("A1 launch profile is missing");
+if (profile === "a1") {
+  const [{ randomUUID }, { PRODUCT_IDENTITY }] = await Promise.all([
+    import("node:crypto"),
+    import("../dist/product-identity.js"),
+  ]);
+  process.env[PRODUCT_IDENTITY.environment.sessionRuntimeId] = randomUUID();
+}
 const { installFatalExit } = await import("../dist/foundation/terminal-cleanup/fatal-exit.js");
 const { resolveProductPaths } = await import("../dist/foundation/lifecycle/paths.js");
 const { join } = await import("node:path");
@@ -49,10 +56,16 @@ Promise.resolve().then(() => {
   if (sessionSelection && profile !== "a1") throw new Error("session selection requires the normal A1 profile");
   return runSelectedInteractiveRuntime(profile, {
     ownedUi: async (profileId, ownedSurfaces) => {
+      const processInspector = ownedSurfaces
+        ? await import("../dist/foundation/process-containment/native-process-inspector.js")
+          .then(module => module.createNativeProcessInspector(process.env, process.platform, launchContext.releaseRoot))
+          .catch(() => null)
+        : null;
       const { application, settings } = await composeOwnedUi({
         cwd: process.cwd(),
         profileId,
         ownedSurfaces,
+        ...(processInspector === null ? {} : { inspectProcess: pid => processInspector.observe(pid) }),
         projectTrustPrompt: createConsoleProjectTrustPrompt({ presentation: profile === "a1" ? "bare" : "comparison" }),
         sessionForkPrompt: createConsoleSessionForkPrompt(),
         ...(sessionSelection === undefined ? {} : { sessionSelection }),

package/dist/app/session-shell/prompt-suggestion-controller.d.ts

@@ -17,7 +17,7 @@ export interface ContextualPromptSuggestionControllerOptions {
 type DecisionIdentity = Omit<OwnedUiPromptSuggestionIdentity, "model"> & {
     readonly model: OwnedUiPromptSuggestionIdentity["model"] | null;
 };
-/** Prefetches one inert candidate; owns retirement even when a provider ignores abort. */
+/** Prefetches one inert candidate and owns one bounded settlement/retry recovery lifecycle. */
 export declare class ContextualPromptSuggestionController {
     #private;
     readonly options: ContextualPromptSuggestionControllerOptions;
@@ -26,12 +26,13 @@ export declare class ContextualPromptSuggestionController {
     setEnabled(enabled: boolean): void;
     skip(identity: DecisionIdentity, reason: SuggestionDecisionReason): void;
     consider(identity: OwnedUiPromptSuggestionIdentity, decision: boolean | SuggestionDecision): void;
-    settle(identity: OwnedUiPromptSuggestionIdentity): void;
+    /** Settles an existing prefetch or starts the first request when that eligible prefetch was missed. */
+    settle(identity: OwnedUiPromptSuggestionIdentity, decision?: boolean | SuggestionDecision): void;
     accept(): void;
     invalidate(): void;
-    /** Retires only a generating request; a prepared or available suggestion survives the draft edit. */
+    /** Retires generating or scheduled recovery; a prepared or available suggestion survives a draft edit. */
     abortPending(): void;
-    /** Reasserts retained ghost text after an editor mutation makes the prompt eligible again. */
+    /** Reasserts retained ghost text or retries a deferred presentation when the editor is eligible. */
     restoreAvailable(): void;
     dispose(): void;
 }

package/dist/app/session-shell/prompt-suggestion-controller.js

@@ -1,9 +1,17 @@
 import { assertOwnedUiPromptSuggestionResult, normalizePromptSuggestionCandidate, } from "../../contracts/owned-ui/index.js";
-/** Prefetches one inert candidate; owns retirement even when a provider ignores abort. */
+const TRANSIENT_PRESENTATION_REASONS = new Set([
+    "not-ready", "not-focused", "autocomplete", "prompt-mode",
+]);
+const RETRYABLE_OUTCOMES = new Set([
+    "empty", "rejected", "provider-failure", "unavailable", "timeout",
+]);
+/** Prefetches one inert candidate and owns one bounded settlement/retry recovery lifecycle. */
 export class ContextualPromptSuggestionController {
     #state = { status: "idle" };
+    #lifecycle = null;
     #request = null;
     #lastConsidered = "";
+    #retiredIdentity = "";
     #enabled;
     #disposed = false;
     #sessionKey = "";
@@ -27,6 +35,7 @@ export class ContextualPromptSuggestionController {
     }
     skip(identity, reason) {
         this.invalidate();
+        this.#lastConsidered = decisionIdentityKey(identity);
         this.#emit(this.#metadata(identity), "skipped", reason);
     }
     consider(identity, decision) {
@@ -34,51 +43,43 @@ export class ContextualPromptSuggestionController {
         if (key === this.#lastConsidered)
             return;
         this.#lastConsidered = key;
-        this.invalidate();
-        const reason = this.#disposed ? "disposed" : !this.#enabled ? "disabled"
-            : decision === false ? "ineligible" : decision === true ? null : decision;
+        this.#reset(true, true);
+        const reason = this.#decisionReason(decision);
         if (reason !== null) {
             this.#emit(this.#metadata(identity), "skipped", reason);
             return;
         }
-        let reasoning = "unavailable";
-        try {
-            reasoning = this.options.generator.suggestionReasoningPolicy?.() ?? "unavailable";
-        }
-        catch { /* Security: isolate diagnostic metadata failure. */ }
-        const request = {
-            identity,
-            metadata: { ...this.#metadata(identity), request: ++this.#requestSequence, reasoning },
-            abort: new AbortController(), startedAt: this.#now(), terminal: false,
-        };
-        this.#request = request;
-        this.#state = { status: "generating", identity, settled: false };
-        this.#emit(request.metadata, "started");
-        request.timer = setTimeout(() => {
-            if (this.#request !== request || this.#state.status !== "generating")
-                return;
-            this.#finish(request, "timeout");
-            this.#state = { status: "idle" };
-            this.#request = null;
-            request.abort.abort();
-        }, this.#timeoutMs);
-        request.timer.unref?.();
-        try {
-            void this.options.generator.generate({ identity, signal: request.abort.signal })
-                .then(result => this.#receive(request, result), () => this.#failed(request))
-                .finally(() => clearTimeout(request.timer));
-        }
-        catch {
-            this.#failed(request);
-        }
+        this.#retiredIdentity = "";
+        this.#lifecycle = { identity, settled: false, attempts: 0, retryPending: false, presentationDeferred: false };
+        this.#startAttempt("prefetch");
     }
-    settle(identity) {
-        if (this.#disposed || !this.#enabled || this.#state.status === "idle")
+    /** Settles an existing prefetch or starts the first request when that eligible prefetch was missed. */
+    settle(identity, decision = null) {
+        if (this.#disposed || !this.#enabled || identityKey(identity) === this.#retiredIdentity)
             return;
-        if (!samePromptSuggestionIdentity(this.#state.identity, identity)) {
+        const reason = this.#decisionReason(decision);
+        const lifecycle = this.#lifecycle;
+        if (lifecycle !== null && !samePromptSuggestionIdentity(lifecycle.identity, identity)) {
             if (this.#request)
                 this.#finish(this.#request, "stale-result", "stale-identity");
-            this.invalidate();
+            this.#reset(true, true);
+        }
+        if (reason !== null) {
+            if (this.#lifecycle !== null)
+                this.#reset(true, true);
+            else
+                this.#emit(this.#metadata(identity), "skipped", reason);
+            return;
+        }
+        if (this.#lifecycle === null) {
+            this.#retiredIdentity = "";
+            this.#lifecycle = { identity, settled: true, attempts: 0, retryPending: false, presentationDeferred: false };
+            this.#startAttempt("settlement");
+            return;
+        }
+        this.#lifecycle.settled = true;
+        if (this.#lifecycle.retryPending) {
+            this.#startAttempt("retry");
             return;
         }
         if (this.#state.status === "generating")
@@ -86,23 +87,23 @@ export class ContextualPromptSuggestionController {
         else if (this.#state.status === "prepared" && this.#request)
             this.#show(this.#request, this.#state.text);
     }
-    accept() { this.#invalidate(false); }
-    invalidate() { this.#invalidate(true); }
-    /** Retires only a generating request; a prepared or available suggestion survives the draft edit. */
+    accept() { this.#reset(false, true); }
+    invalidate() { this.#reset(true, true); }
+    /** Retires generating or scheduled recovery; a prepared or available suggestion survives a draft edit. */
     abortPending() {
-        if (this.#state.status !== "generating")
-            return;
-        const request = this.#request;
-        this.#request = null;
-        this.#state = { status: "idle" };
-        if (request === null)
+        if (this.#state.status !== "generating" && !(this.#state.status === "idle" && this.#lifecycle?.retryPending))
             return;
-        this.#finish(request, "cancelled");
-        request.abort.abort();
+        this.#reset(false, true);
     }
-    /** Reasserts retained ghost text after an editor mutation makes the prompt eligible again. */
+    /** Reasserts retained ghost text or retries a deferred presentation when the editor is eligible. */
     restoreAvailable() {
-        if (this.#disposed || !this.#enabled || this.#state.status !== "available")
+        if (this.#disposed || !this.#enabled)
+            return;
+        if (this.#state.status === "prepared" && this.#lifecycle?.settled && this.#request) {
+            this.#show(this.#request, this.#state.text);
+            return;
+        }
+        if (this.#state.status !== "available")
             return;
         const reason = this.options.surface.presentationBlockReason?.(this.#state.identity)
             ?? (this.options.surface.canPresent(this.#state.identity) ? null : "presentation-unavailable");
@@ -114,16 +115,64 @@ export class ContextualPromptSuggestionController {
         this.#disposed = true;
         this.invalidate();
         this.#lastConsidered = "";
+        this.#retiredIdentity = "";
         this.#sessionKey = "";
     }
-    #invalidate(clearSurface) {
+    #decisionReason(decision) {
+        return this.#disposed ? "disposed" : !this.#enabled ? "disabled"
+            : decision === false ? "ineligible" : decision === true ? null : decision;
+    }
+    #startAttempt(trigger) {
+        const lifecycle = this.#lifecycle;
+        if (lifecycle === null || this.#request !== null || lifecycle.attempts >= 2)
+            return;
+        lifecycle.retryPending = false;
+        lifecycle.presentationDeferred = false;
+        const attempt = ++lifecycle.attempts;
+        let reasoning = "unavailable";
+        try {
+            reasoning = this.options.generator.suggestionReasoningPolicy?.() ?? "unavailable";
+        }
+        catch { /* Security: isolate diagnostic metadata failure. */ }
+        const request = {
+            identity: lifecycle.identity,
+            metadata: { ...this.#metadata(lifecycle.identity), request: ++this.#requestSequence, reasoning, attempt, trigger },
+            abort: new AbortController(), startedAt: this.#now(), terminal: false,
+        };
+        this.#request = request;
+        this.#state = { status: "generating", identity: lifecycle.identity, settled: lifecycle.settled };
+        this.#emit(request.metadata, "started");
+        request.timer = setTimeout(() => {
+            if (this.#request !== request || this.#state.status !== "generating")
+                return;
+            this.#finish(request, "timeout");
+            this.#request = null;
+            this.#state = { status: "idle" };
+            request.abort.abort();
+            this.#completeNoCandidate(request, "timeout");
+        }, this.#timeoutMs);
+        request.timer.unref?.();
+        try {
+            void this.options.generator.generate({ identity: lifecycle.identity, signal: request.abort.signal })
+                .then(result => this.#receive(request, result), () => this.#failed(request))
+                .finally(() => clearTimeout(request.timer));
+        }
+        catch {
+            this.#failed(request);
+        }
+    }
+    #reset(clearSurface, retire) {
         const hadVisibleSuggestion = this.#state.status === "available";
+        const identity = this.#lifecycle?.identity ?? (this.#state.status === "idle" ? null : this.#state.identity);
         const request = this.#request;
         if (request)
             this.#finish(request, "cancelled");
         this.#request = null;
+        this.#lifecycle = null;
         this.#state = { status: "idle" };
         request?.abort.abort();
+        if (retire && identity !== null)
+            this.#retiredIdentity = identityKey(identity);
         if (clearSurface && hadVisibleSuggestion) {
             this.options.surface.clear();
             this.options.surface.requestRender();
@@ -137,6 +186,7 @@ export class ContextualPromptSuggestionController {
         this.#finish(request, "provider-failure");
         this.#request = null;
         this.#state = { status: "idle" };
+        this.#completeNoCandidate(request, "provider-failure");
     }
     #receive(request, result) {
         if (this.#disposed || this.#request !== request || request.terminal || this.#state.status !== "generating") {
@@ -148,41 +198,76 @@ export class ContextualPromptSuggestionController {
         }
         catch {
             this.#finish(request, "rejected");
-            this.invalidate();
+            this.#request = null;
+            this.#state = { status: "idle" };
+            this.#completeNoCandidate(request, "rejected");
             return;
         }
         if (!samePromptSuggestionIdentity(request.identity, result.identity)) {
             this.#finish(request, "stale-result", "stale-identity");
-            this.invalidate();
+            this.#reset(true, true);
             return;
         }
         if (result.outcome !== "candidate") {
             this.#finish(request, result.outcome);
-            this.invalidate();
+            this.#request = null;
+            this.#state = { status: "idle" };
+            if (RETRYABLE_OUTCOMES.has(result.outcome))
+                this.#completeNoCandidate(request, result.outcome);
+            else {
+                this.#retiredIdentity = identityKey(request.identity);
+                this.#lifecycle = null;
+            }
             return;
         }
         const text = normalizePromptSuggestionCandidate(result.text);
         if (text === null) {
             this.#finish(request, "rejected");
-            this.invalidate();
+            this.#request = null;
+            this.#state = { status: "idle" };
+            this.#completeNoCandidate(request, "rejected");
             return;
         }
         clearTimeout(request.timer);
-        if (this.#state.settled)
+        if (this.#lifecycle?.settled)
             this.#show(request, text);
         else
             this.#state = { status: "prepared", identity: request.identity, text };
     }
+    #completeNoCandidate(request, outcome) {
+        const lifecycle = this.#lifecycle;
+        if (lifecycle === null || !samePromptSuggestionIdentity(lifecycle.identity, request.identity))
+            return;
+        if (lifecycle.attempts >= 2 || !RETRYABLE_OUTCOMES.has(outcome)) {
+            this.#emit({ ...request.metadata, elapsedMs: Math.max(0, this.#now() - request.startedAt) }, "retry-exhausted");
+            this.#retiredIdentity = identityKey(request.identity);
+            this.#lifecycle = null;
+            return;
+        }
+        lifecycle.retryPending = true;
+        if (lifecycle.settled)
+            this.#startAttempt("retry");
+    }
     #show(request, text) {
         const reason = this.options.surface.presentationBlockReason?.(request.identity)
             ?? (this.options.surface.canPresent(request.identity) ? null : "presentation-unavailable");
+        if (reason !== null && TRANSIENT_PRESENTATION_REASONS.has(reason)) {
+            this.#state = { status: "prepared", identity: request.identity, text };
+            if (this.#lifecycle !== null && !this.#lifecycle.presentationDeferred) {
+                this.#lifecycle.presentationDeferred = true;
+                this.#emit({ ...request.metadata, elapsedMs: Math.max(0, this.#now() - request.startedAt) }, "presentation-deferred", reason);
+            }
+            return;
+        }
         if (reason !== null || !this.options.surface.present(text)) {
             this.#finish(request, "presentation-blocked", reason ?? "presentation-unavailable");
-            this.invalidate();
+            this.#reset(true, true);
             return;
         }
         this.#state = { status: "available", identity: request.identity, text };
         this.#finish(request, "displayed");
+        if (this.#lifecycle !== null)
+            this.#lifecycle.presentationDeferred = false;
         this.options.surface.requestRender();
     }
     #finish(request, event, reason) {
@@ -227,3 +312,8 @@ export function samePromptSuggestionIdentity(left, right) {
 function identityKey(identity) {
     return `${identity.sessionId}\0${identity.sessionGeneration}\0${identity.runSequence}\0${identity.responseSequence}\0${identity.model.providerId}\0${identity.model.modelId}`;
 }
+function decisionIdentityKey(identity) {
+    return identity.model === null
+        ? `${identity.sessionId}\0${identity.sessionGeneration}\0${identity.runSequence}\0${identity.responseSequence}\0\0`
+        : identityKey(identity);
+}

package/dist/app/session-shell/session-shell-root.d.ts

@@ -5,6 +5,7 @@ import type { UiRouteHost, UiRouteInput } from "../../ui/apps/contracts.js";
 import type { TranscriptViewportFrame, TranscriptViewportFrameDescriptor } from "../../ui/components/transcript-viewport.js";
 import type { PiEngineAdapter } from "../../integrations/pi/engine/adapter.js";
 import type { PiWorkflowMessage, PiWorkflowResult } from "../../integrations/pi/engine/workflows.js";
+import type { PiShellLazySelectorLoader } from "../../integrations/pi/components/lazy-selectors.js";
 import { type PiShellHotkeysPresentation } from "../../integrations/pi/components/shell-presenters-info.js";
 import { type PiShellClipboardContent, type PiShellComponentPort, type PiShellEditorPort, type PiShellExtensionRendererResolver, type PiShellHeaderOptions, type PiShellHeaderPort, type PiShellImageAssetResolver, type PiShellLoadedResourcesPort, type PiShellResourceEntry, type PiShellTranscriptComponentPort } from "../../integrations/pi/components/shell-shared-facade.js";
 import { type PiTuiInputCoordinationScheduler, type PiTuiInputSurfaceKind } from "../../integrations/pi/tui-runtime/input-presentation-coordinator.js";
@@ -116,6 +117,8 @@ export interface OwnedUiShellDiagnosticOptions {
     readonly paste?: (event: PasteEvent) => void;
     /** Test seams for isolated paste preparation: an in-process starter, or the forked helper's entry. */
     readonly pastePreparation?: Omit<PastePreparationClientOptions, "onEvent" | "spareIdleMs">;
+    /** Test seam for pending and failed optional selector-module preparation. */
+    readonly lazySelectors?: PiShellLazySelectorLoader;
 }
 /** Live prompt-image admission policy supplied only by the bare-A1 profile. */
 export interface OwnedUiShellPromptImagesOptions {
@@ -169,6 +172,7 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
         readonly onEditorChange?: (text: string) => void;
         readonly onPromptSuggestionAccepted?: (text: string) => void;
         readonly onInputSurfaceChanged?: () => void;
+        readonly onPromptSuggestionEligibilityChanged?: () => void;
         readonly onCopyText?: (text: string) => void;
         readonly readClipboardContent?: (signal?: AbortSignal) => Promise<PiShellClipboardContent | null>;
         readonly captureClipboardPaste?: () => PasteSource;
@@ -242,7 +246,7 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
         maxScroll: number;
         cause: "initial" | "steady" | "dock-input" | "follow-shift" | "detached" | "geometry-change" | null;
     };
-    /** Visible non-selectable Steering, alignment, and Working rows, for rendering evidence. */
+    /** Visible non-persistent Steering, alignment, and Working rows, for rendering evidence. */
     viewportTransientTailRowCount(): number;
     hasActiveSelection(): boolean;
     setViewportConfig(config: OwnedUiViewportSettings): void;

package/dist/app/session-shell/session-shell-root.js

@@ -48,6 +48,7 @@ export class OwnedUiSessionShellRoot {
     #viewportTheme;
     #onViewportFrame;
     #onInputSurfaceChanged;
+    #onPromptSuggestionEligibilityChanged;
     #componentRuntime;
     #toolsExpanded = false;
     #thinkingVisible = true;
@@ -107,6 +108,7 @@ export class OwnedUiSessionShellRoot {
         this.#componentRuntime = handlers;
         this.#onViewportFrame = handlers.onViewportFrame;
         this.#onInputSurfaceChanged = handlers.onInputSurfaceChanged;
+        this.#onPromptSuggestionEligibilityChanged = handlers.onPromptSuggestionEligibilityChanged;
         this.#dockInputReuseEnabled = handlers.enableDockInputReuse ?? true;
         this.header = createPiShellHeader({
             ...startup,
@@ -223,8 +225,8 @@ export class OwnedUiSessionShellRoot {
         // Invariant: colours come from the active theme, so rendered rows outlive their revision only
         // until the theme under them changes.
         this.#themeUnsubscribe = onPiThemeChange(() => {
-            this.#renderedRows.clear();
-            this.#documentLayouts.clear();
+            this.invalidate();
+            this.#componentRuntime.requestRender(true);
         });
     }
     setEditorPaddingX(padding) {
@@ -327,6 +329,7 @@ export class OwnedUiSessionShellRoot {
         this.editor.setPromptSuggestion(text);
     }
     update(view) {
+        const becameReady = this.#view.lifecycle !== "ready" && view.lifecycle === "ready";
         if (view.diagnostics.length !== this.#view.diagnostics.length
             || view.diagnostics.some((diagnostic, index) => diagnostic.sequence !== this.#view.diagnostics[index]?.sequence)) {
             this.#documentLayouts.clear();
@@ -349,6 +352,8 @@ export class OwnedUiSessionShellRoot {
         this.editor.setThinkingLevel(view.thinkingLevel);
         // Performance: semantic updates already invalidate affected transcript blocks. Chrome is a separate authority.
         this.#invalidateChrome();
+        if (becameReady)
+            this.#onPromptSuggestionEligibilityChanged?.();
     }
     /**
      * Applies one block: its component is created or updated in place and the order grows
@@ -458,13 +463,13 @@ export class OwnedUiSessionShellRoot {
         if (frame === null) {
             frame = this.#viewportController.compose({
                 // Performance: do not copy the complete document on unchanged dock-only input.
-                // Steering and Working retain their one non-selectable viewport-tail ownership.
+                // Steering and Working retain their one non-persistent viewport-tail ownership.
                 documentRows: [...document.rows, ...steeringRows, ...statusRows],
                 ...(this.#viewportController.transcriptPointerSelecting
                     ? { paintDocumentRow: heldNativeHyperlinkStyle }
                     : {}),
-                // Invariant: selection and copying stop at the real document tail; Steering,
-                // fitting alignment, and live Working remain transient presentation chrome.
+                // Invariant: this boundary tracks persistent transcript rows for streaming and
+                // geometry; transient Steering and Working rows remain complete-frame selectable.
                 selectableDocumentRowCount,
                 ...(document.liveTailStartRow === undefined ? {} : { liveTailStartRow: document.liveTailStartRow }),
                 bottomAlignedTailRowCount: steeringRows.length + statusRows.length,
@@ -527,7 +532,7 @@ export class OwnedUiSessionShellRoot {
             cause: frame?.descriptor.cause ?? null,
         };
     }
-    /** Visible non-selectable Steering, alignment, and Working rows, for rendering evidence. */
+    /** Visible non-persistent Steering, alignment, and Working rows, for rendering evidence. */
     viewportTransientTailRowCount() {
         return this.#viewportController.frame?.hits.transientTail.length ?? 0;
     }
@@ -1179,6 +1184,8 @@ export class OwnedUiSessionShellRoot {
     }
     setFocused(focused) {
         this.#inputSurface.setFocused?.(focused);
+        if (focused)
+            this.#onPromptSuggestionEligibilityChanged?.();
     }
     dispose() {
         this.#clearCopyAcknowledgement(false);