@timurproko/a1 0.1.8-dev.271 → 0.1.8-dev.279

package/dist/integrations/pi/session-ui/session-shell.js

@@ -1,4 +1,5 @@
 import { PRODUCT_TEXT } from "../../../product-identity.js";
+import { ContextualPromptSuggestionController } from "./prompt-suggestion-controller.js";
 import { MOUSE_TRACKING_OFF, MOUSE_TRACKING_ON, parseMouseInput, readVisibleHyperlinks } from "../../../ui/components/index.js";
 import { PINNED_PI_HIDDEN_COMMAND_NAMES, PINNED_PI_WORKFLOW_COMMAND_NAMES, } from "../engine/index.js";
 import { createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellStatus, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, onPiThemeChange, piTheme, renderPiShellPackageUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, } from "../components/index.js";
@@ -16,6 +17,8 @@ export class OwnedUiSessionShell {
     #cwd;
     #listeners = new Set();
     #unsubscribe;
+    #unsubscribePromptSuggestions;
+    #promptSuggestions;
     #extensionBridge;
     #stopped;
     #resolveStopped;
@@ -44,9 +47,11 @@ export class OwnedUiSessionShell {
     #lastEscapeTime = 0;
     #activeLoginDialog;
     #sessionGeneration;
+    #suggestionModelKey;
     constructor(options) {
         this.backend = options.backend;
         this.#sessionGeneration = this.backend.sessionGeneration;
+        this.#suggestionModelKey = modelKey(this.backend.view());
         this.#cwd = options.cwd;
         this.#routeHost = options.routeHost ?? null;
         this.#customViewport = options.sessionLayout === "custom-viewport";
@@ -59,6 +64,7 @@ export class OwnedUiSessionShell {
         let damageTerminal;
         let streamPresentation;
         let pendingClipboardWrite = Promise.resolve();
+        let promptSuggestionController = null;
         this.root = new OwnedUiSessionShellRoot(this.backend.view(), options.cwd, {
             getColumns: () => runtime?.viewport().columns ?? options.terminal?.columns ?? 80,
             getRows: () => runtime?.viewport().rows ?? options.terminal?.rows ?? 24,
@@ -84,6 +90,9 @@ export class OwnedUiSessionShell {
             onMessageCopy: () => { void this.runWorkflow({ command: "copy", argument: "" }); },
             onFollowUp: () => { void this.queueFollowUp(); },
             onDequeue: () => this.restoreQueuedInput(),
+            onEditorChange: () => promptSuggestionController?.invalidate(),
+            onPromptSuggestionAccepted: () => promptSuggestionController?.accept(),
+            onInputSurfaceChanged: () => promptSuggestionController?.invalidate(),
             onCopyText: text => {
                 runtime?.writeControl(`\u001b]52;c;${Buffer.from(text, "utf8").toString("base64")}\u0007`);
                 const write = options.clipboard === undefined
@@ -163,6 +172,26 @@ export class OwnedUiSessionShell {
             ? new StreamPresentationCoalescer(() => this.runtime.requestRender(), presentationInterval)
             : new StreamPresentationCoalescer(() => this.runtime.requestRender(), presentationInterval, options.streamPresentation.scheduler);
         this.#streamPresentation = streamPresentation;
+        const promptSuggestionOptions = this.#customViewport ? options.promptSuggestions : undefined;
+        promptSuggestionController = promptSuggestionOptions === undefined ? null : new ContextualPromptSuggestionController({
+            generator: promptSuggestionOptions.generator,
+            enabled: promptSuggestionOptions.enabled(),
+            surface: {
+                canPresent: identity => this.#canPresentPromptSuggestion(identity),
+                present: text => {
+                    if (!this.root.canPresentPromptSuggestion())
+                        return false;
+                    this.root.setPromptSuggestion(text);
+                    return true;
+                },
+                clear: () => this.root.setPromptSuggestion(null),
+                requestRender: () => this.runtime.requestRender(),
+            },
+        });
+        this.#promptSuggestions = promptSuggestionController;
+        this.#unsubscribePromptSuggestions = promptSuggestionOptions === undefined
+            ? () => { }
+            : promptSuggestionOptions.onChange(enabled => this.#promptSuggestions?.setEnabled(enabled));
         const initialPiSettings = this.backend.pinnedSettingsSnapshot();
         this.runtime.setHardwareCursor(initialPiSettings.showHardwareCursor);
         this.runtime.setClearOnShrink(initialPiSettings.clearOnShrink);
@@ -308,15 +337,48 @@ export class OwnedUiSessionShell {
             // Performance: a streamed chunk names one block, and touching only that block is what keeps the
             // cost of a chunk the same in a long session as in a new one. Everything else
             // resynchronizes the view, which is cheap next to re-reading the transcript.
-            if (event.type === "agent-run-started")
+            if (event.type === "agent-run-started") {
+                this.#promptSuggestions?.invalidate();
                 this.root.resumeViewportFollowing();
-            if (event.type === "assistant-message-completed")
+            }
+            if (event.type === "assistant-message-completed") {
                 this.root.noteCompletedAssistantMessage();
+                if (event.model !== null) {
+                    this.#promptSuggestions?.consider({
+                        sessionId: event.sessionId,
+                        sessionGeneration: event.sessionGeneration,
+                        runSequence: event.runSequence,
+                        responseSequence: event.responseSequence,
+                        model: event.model,
+                    }, event.successful
+                        && event.stopReason === "stop"
+                        && !event.toolContinuation
+                        && event.assistantMessageCount >= 2
+                        && this.root.canPreparePromptSuggestion());
+                }
+            }
             const semanticOnly = event.type === "agent-run-started" || event.type === "assistant-message-completed";
             const view = event.type === "transcript-block" && this.#sessionGeneration === this.backend.sessionGeneration
                 ? this.#syncBlock(event.block)
                 : semanticOnly ? this.view() : this.#syncView();
             this.#syncTerminalProgress(view);
+            const currentModelKey = modelKey(view);
+            if (this.backend.sessionGeneration !== this.#sessionGeneration || currentModelKey !== this.#suggestionModelKey) {
+                this.#promptSuggestions?.invalidate();
+                this.#suggestionModelKey = currentModelKey;
+            }
+            if (event.type === "status" && /^(Retrying|Compacting)/.test(event.status.workingMessage ?? "")) {
+                this.#promptSuggestions?.invalidate();
+            }
+            if (event.type === "agent-run-settled" && event.model !== null) {
+                this.#promptSuggestions?.settle({
+                    sessionId: event.sessionId,
+                    sessionGeneration: event.sessionGeneration,
+                    runSequence: event.runSequence,
+                    responseSequence: event.responseSequence,
+                    model: event.model,
+                });
+            }
             if (view.lifecycle === "ready" && this.#compactionQueue.length > 0)
                 void this.#flushCompactionQueue();
             if (event.type === "session-lifecycle" && event.lifecycle === "stopped")
@@ -328,6 +390,14 @@ export class OwnedUiSessionShell {
     view() {
         return this.backend.view();
     }
+    #canPresentPromptSuggestion(identity) {
+        const view = this.view();
+        return !this.#disposed
+            && identity.sessionId === view.sessionId
+            && identity.sessionGeneration === this.backend.sessionGeneration
+            && modelKey(view) === `${identity.model.providerId}/${identity.model.modelId}`
+            && this.root.canPresentPromptSuggestion();
+    }
     damagePresentationDecision() {
         return this.#damageTerminal?.lastDecision ?? null;
     }
@@ -351,6 +421,7 @@ export class OwnedUiSessionShell {
         return this.#stopped;
     }
     async submit(text) {
+        this.#promptSuggestions?.invalidate();
         const displayInput = text.trim();
         if (!displayInput)
             return { outcome: "completed", diagnostic: null };
@@ -406,6 +477,7 @@ export class OwnedUiSessionShell {
         });
     }
     async clearOrExit(now = Date.now()) {
+        this.#promptSuggestions?.invalidate();
         if (now - this.#lastClearTime < 500)
             return this.shutdown();
         this.root.editor.setText("");
@@ -414,6 +486,7 @@ export class OwnedUiSessionShell {
         return { outcome: "completed", diagnostic: null };
     }
     async interrupt(now = Date.now()) {
+        this.#promptSuggestions?.invalidate();
         if (this.view().lifecycle === "busy")
             return this.abort();
         if (this.root.editor.getText().trim().length > 0) {
@@ -441,15 +514,19 @@ export class OwnedUiSessionShell {
         return this.#execute(this.#simple("abort"));
     }
     async retry() {
+        this.#promptSuggestions?.invalidate();
         return this.#execute(this.#simple("retry"));
     }
     async compact() {
+        this.#promptSuggestions?.invalidate();
         return this.#execute(this.#simple("compact"));
     }
     async newSession() {
+        this.#promptSuggestions?.invalidate();
         return this.#execute(this.#simple("new-session"));
     }
     async resumeSession(sessionPath) {
+        this.#promptSuggestions?.invalidate();
         return this.#execute({
             type: "resume-session",
             correlationId: this.#correlation("resume"),
@@ -458,6 +535,7 @@ export class OwnedUiSessionShell {
         });
     }
     async setModel(providerId, modelId) {
+        this.#promptSuggestions?.invalidate();
         return this.#execute({
             type: "set-model",
             correlationId: this.#correlation("model"),
@@ -1008,6 +1086,8 @@ export class OwnedUiSessionShell {
         this.#setPointerReporting(false, true);
         this.#removeViewportPreInput();
         this.#streamPresentation.dispose();
+        this.#promptSuggestions?.dispose();
+        this.#unsubscribePromptSuggestions();
         this.#unsubscribeSettings();
         const exitMode = this.backend.disposed
             ? this.#fullscreenExitOutput
@@ -1059,6 +1139,7 @@ export class OwnedUiSessionShell {
         this.#streamPresentation.noteImmediatePresentation();
         const view = this.view();
         if (this.backend.sessionGeneration !== this.#sessionGeneration) {
+            this.#promptSuggestions?.invalidate();
             this.#sessionGeneration = this.backend.sessionGeneration;
             this.#activeLoginDialog = undefined;
             this.#extensionBridge.reset();
@@ -1385,6 +1466,9 @@ function modelReference(model) {
 function rejected(diagnostic) {
     return { outcome: "rejected", diagnostic };
 }
+function modelKey(view) {
+    return view.activeModel === null ? "" : `${view.activeModel.providerId}/${view.activeModel.modelId}`;
+}
 function workflowAdapterResult(result) {
     if (result.outcome === "completed")
         return { outcome: "completed", diagnostic: null };

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

@@ -5,7 +5,7 @@
   "platform": "darwin",
   "architecture": "arm64",
   "capability": "supported",
-  "builtAt": "2026-09-06T15:05:45.656Z",
+  "builtAt": "2026-09-07T08:48:09.287Z",
   "artifact": {
     "filename": "process-guardian",
     "sha256": "dc03605e5780e2aeebb4ecafd62868dc673e22ddd38b024a369aff704ff136dc",

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

@@ -5,7 +5,7 @@
   "platform": "linux",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-09-06T15:05:42.977Z",
+  "builtAt": "2026-09-07T08:48:08.596Z",
   "artifact": {
     "filename": "process-guardian",
     "sha256": "ee8a00eaaf79c707459bbbfb52518e9739314967049fbe5fa625f36ce33db9ee",

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

@@ -5,10 +5,10 @@
   "platform": "win32",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-09-06T15:06:12.448Z",
+  "builtAt": "2026-09-07T08:48:53.798Z",
   "artifact": {
     "filename": "process-guardian.exe",
-    "sha256": "7cca17597d89ae0dad9cd14114acc0795f688d54f6580b897463fba11af479ca",
+    "sha256": "ec965cf23ffb3dd4f8db9b265c620c3bbc078418a6f7e330bdcbf4d0055f6393",
     "size": 177664
   },
   "provenance": {

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

@@ -1,4 +1,4 @@
-export declare const OWNED_UI_SETTINGS_VERSION = 3;
+export declare const OWNED_UI_SETTINGS_VERSION = 4;
 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 = 3;
+export const OWNED_UI_SETTINGS_VERSION = 4;
 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" });
@@ -30,6 +30,14 @@ export const OWNED_UI_SETTING_DECLARATIONS = Object.freeze([
         defaultValue: "normal",
         allowedValues: Object.freeze(["normal", "fast", "high"]),
     }),
+    Object.freeze({
+        id: "promptSuggestions",
+        label: "Prompt suggestions",
+        description: "Predict likely next prompts with one additional background request using the selected model.",
+        application: "live",
+        defaultValue: true,
+        allowedValues: Object.freeze([true, false]),
+    }),
 ]);
 export function assertOwnedUiSettingDeclarations(declarations) {
     const seen = new Set();

package/dist/ui/settings/migrations.js

@@ -22,6 +22,13 @@ export const OWNED_UI_SETTINGS_MIGRATIONS = Object.freeze([
                 : { ...values };
         },
     }),
+    Object.freeze({
+        to: 4,
+        description: "Introduce contextual prompt suggestions with an enabled default.",
+        migrate(values) {
+            return { ...values };
+        },
+    }),
 ]);
 export function assertOwnedUiSettingsMigrations(migrations, currentVersion = OWNED_UI_SETTINGS_VERSION) {
     const firstProduced = currentVersion - migrations.length + 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timurproko/a1",
-  "version": "0.1.8-dev.271",
+  "version": "0.1.8-dev.279",
   "description": "Standalone terminal workspace for supervised native and managed agents",
   "type": "module",
   "packageManager": "npm@11.13.0",