@timurproko/a1 0.1.8-dev.299 → 0.1.8-dev.332

package/README.md

@@ -45,13 +45,25 @@ a1 pi                                   # vanilla Pi oracle: ~/.pi/agent
 Unsupported commands exit quietly without launching anything. The removed
 `update:<preview>` forms are not aliases; use `update --develop`.
 
+## Prompt suggestions
+
+Bare A1's `/settings` → Agent → Prompt suggestions controls faint next-prompt
+predictions. It is enabled by default and uses one additional background request
+with the selected model for eligible turns. Disabling it takes effect immediately.
+Tab accepts a suggestion as editable text; Enter submits it afterward. The setting
+remains stored in A1's profile, and `a1 pi` is unchanged.
+
 ## Prompt history
 
 Bare A1 recalls recent unique prompts across sessions with Up/Down. History is
-stored in a separate profile-local SQLite database under A1's application-data
-root, not `~/.a1/agent` or disposable caches. `/settings` → History controls
-persistence and the 10-100-entry limit (default 100), effective on next start.
-History is unencrypted user text; images are not reattached. See
+stored in a separate profile-local SQLite database at
+`~/.a1/data/history/<profile-id>.sqlite3`, or under `<A1_DATA_DIR>/history` when
+explicitly overridden. Other application data stays in its existing location.
+`/settings` → History controls persistence and the 10-100-entry limit (default
+100), effective on next start. The new default starts fresh: old platform history
+is neither imported nor automatically deleted. Ordinary upgrades and npm
+uninstall/reinstall preserve saved history. History is unencrypted user text;
+images are not reattached. See
 [prompt history](docs/features/prompt-history.md) for privacy, storage, and removal.
 
 ## Extensions

package/bin/guardian.js

@@ -3,13 +3,14 @@
 const startup = await import("../dist/foundation/startup/index.js");
 startup.enableEnvironmentCompileCache(process.env);
 await startup.markStartupPhase(process.env, "guardian-start");
-const { fileURLToPath } = await import("node:url");
 const { resolve } = await import("node:path");
 const { parseSessionSelection } = await import("../dist/foundation/lifecycle/index.js");
 const { runLaunchGuardian } = await import("../dist/foundation/launch-guardian/index.js");
 
-const releaseRoot = process.env.A1_RELEASE_ROOT ?? fileURLToPath(new URL("..", import.meta.url));
-const profileId = process.env.A1_LAUNCH_PROFILE ?? "a1";
+const { readLaunchContext } = await import("../dist/foundation/launch-context/index.js");
+const launchContext = readLaunchContext(process.env, "release");
+const releaseRoot = launchContext.releaseRoot;
+const profileId = readLaunchContext(process.env, "profile").launchProfile;
 
 Promise.resolve().then(() => runLaunchGuardian({
   sessionSelection: parseSessionSelection(process.argv.slice(2)),

package/bin/ui.js

@@ -2,14 +2,16 @@
 
 const startup = await import("../dist/foundation/startup/index.js");
 startup.enableEnvironmentCompileCache(process.env);
-const profile = process.env.A1_LAUNCH_PROFILE ?? "a1";
+const { readLaunchContext } = await import("../dist/foundation/launch-context/index.js");
+const launchContext = readLaunchContext(process.env, "profile");
+const profile = launchContext.launchProfile;
 const { installFatalExit } = await import("../dist/foundation/terminal-cleanup/index.js");
 const { resolveProductPaths } = await import("../dist/foundation/lifecycle/index.js");
 const { join } = await import("node:path");
 let runningApplication;
 const fatal = profile === "a1" ? installFatalExit({
   directory: join(resolveProductPaths().runtimeDir, "crashes"),
-  releaseId: process.env.A1_RELEASE_ID,
+  releaseId: launchContext.releaseId,
   dispose: () => runningApplication?.dispose(),
 }) : undefined;
 // Performance: begin the exact launch graph together while the trace write is pending.

package/bin/update-recovery.js

@@ -140,6 +140,7 @@ async function runRecoveredCommand(value, arguments_) {
 
 async function readCapsule(path) {
   const value = JSON.parse(await readFile(path, "utf8"));
+  if (value.launchContract !== "neutral-launch-v1") throw new Error("Unsupported private recovery contract; stop existing processes and install directly with npm. Preserve settings, sessions, and history.");
   if (value.schema !== SCHEMA || typeof value.transactionId !== "string" || typeof value.packageName !== "string"
     || typeof value.packageName !== "string" || !value.packageName.includes("/") || typeof value.targetVersion !== "string" || typeof value.packageRoot !== "string" || typeof value.globalRoot !== "string"
     || typeof value.launcherRoot !== "string" || !Array.isArray(value.launchers) || typeof value.priorReleaseId !== "string" || typeof value.priorReleaseRoot !== "string"
@@ -178,6 +179,7 @@ async function readCapsule(path) {
   assertDirectChild(releasesRoot, priorReleaseRoot);
   if (priorReleaseRoot.split(sep).at(-1) !== value.priorReleaseId) throw new Error("A1 update recovery prior release identity is invalid");
   const priorManifest = JSON.parse(await readFile(resolve(priorReleaseRoot, value.releaseManifestName), "utf8"));
+  if (priorManifest.launchContract !== "neutral-launch-v1") throw new Error("Unsupported prior private launch contract; manual cutover is required.");
   if (priorManifest.releaseId !== value.priorReleaseId || priorManifest.contentDigest !== value.priorContentDigest) {
     throw new Error("A1 update recovery prior release manifest is invalid");
   }
@@ -190,7 +192,7 @@ async function installedTargetEntry(value) {
   try {
     const manifest = JSON.parse(await readFile(resolve(value.packageRoot, "package.json"), "utf8"));
     const entry = resolve(value.packageRoot, "bin", "cli.js");
-    if (manifest.name !== value.packageName || manifest.version !== value.targetVersion || !(await lstat(entry)).isFile()) return null;
+    if (manifest.privateLaunchContract !== "neutral-launch-v1" || manifest.name !== value.packageName || manifest.version !== value.targetVersion || !(await lstat(entry)).isFile()) return null;
     return entry;
   } catch { return null; }
 }

package/dist/cli/dispatch.js

@@ -212,7 +212,7 @@ function pinnedPiUpdateError() {
         message: [
             PRODUCT_TEXT.diagnostic("pins its certified Pi runtime and cannot update it independently."),
             "Use:",
-            `  ${PRODUCT_TEXT.commandName} update                    Update A1`,
+            `  ${PRODUCT_TEXT.commandName} update                    Update a1`,
             `  ${PRODUCT_TEXT.commandName} pi update --extensions    Update Pi-compatible packages`,
             `  ${PRODUCT_TEXT.commandName} pi update --models        Refresh model catalogs`,
         ].join("\n"),

package/dist/composition/owned-ui.js

@@ -1,4 +1,5 @@
 import { PromptHistoryService } from "../features/prompt-history/index.js";
+import { resolvePromptHistoryDataDir } from "../features/launch/index.js";
 import { resolveProductPaths } from "../foundation/lifecycle/index.js";
 import { applyConfiguredPiTheme, getAvailablePiThemes, loadHistoryEditor } from "../integrations/pi/components/index.js";
 import { createPiEngineAdapter, } from "../integrations/pi/engine/index.js";
@@ -47,7 +48,7 @@ export async function composeOwnedUi(options = {}) {
     const promptHistory = settings === null || !ownedSurfaces || settings.value("promptHistoryEnabled") === false ? null : {
         limit: typeof historyLimit === "number" ? historyLimit : 100,
         store: new PromptHistoryService({
-            dataDir: resolveProductPaths().dataDir,
+            dataDir: resolvePromptHistoryDataDir(),
             profileRoot: adapter.agentDir,
             limit: typeof historyLimit === "number" ? historyLimit : 100,
         }),

package/dist/features/launch/profile-paths.d.ts

@@ -11,4 +11,6 @@ export interface LaunchProfilePathOptions {
     readonly platform?: NodeJS.Platform;
 }
 export declare function resolveLaunchProfilePaths(options?: LaunchProfilePathOptions): LaunchProfilePaths;
+/** Select history storage without relocating control state or probing former stores. */
+export declare function resolvePromptHistoryDataDir(options?: LaunchProfilePathOptions): string;
 export declare function configurationRootForProfile(profileId: LaunchProfileId, paths: LaunchProfilePaths): string | null;

package/dist/features/launch/profile-paths.js

@@ -1,6 +1,7 @@
 import { homedir } from "node:os";
 import { posix, win32 } from "node:path";
 import { PRODUCT_IDENTITY } from "../../product-identity.js";
+import { resolveProductPaths } from "../../foundation/lifecycle/index.js";
 export function resolveLaunchProfilePaths(options = {}) {
     const environment = options.environment ?? process.env;
     const path = options.platform === "win32" || (options.platform === undefined && process.platform === "win32") ? win32 : posix;
@@ -13,6 +14,16 @@ export function resolveLaunchProfilePaths(options = {}) {
         agentProfile,
     });
 }
+/** Select history storage without relocating control state or probing former stores. */
+export function resolvePromptHistoryDataDir(options = {}) {
+    const environment = options.environment ?? process.env;
+    const platform = options.platform ?? process.platform;
+    if (environment[PRODUCT_IDENTITY.environment.dataDir] !== undefined) {
+        return resolveProductPaths(environment, platform).dataDir;
+    }
+    const path = platform === "win32" ? win32 : posix;
+    return path.join(resolveLaunchProfilePaths(options).managedStateRoot, "data");
+}
 export function configurationRootForProfile(profileId, paths) {
     return profileId === "a1" ? paths.agentProfile : null;
 }

package/dist/features/owned-ui/project-trust-prompt.js

@@ -37,7 +37,7 @@ export function createConsoleProjectTrustPrompt(options = {}) {
                 `${BOLD}${ACCENT}Trust project folder?${RESET_FG}${RESET_BOLD}`,
                 cwd,
                 "",
-                "This allows A1 to load project settings and resources, install missing project packages, and execute project extensions.",
+                "This allows a1 to load project settings and resources, install missing project packages, and execute project extensions.",
                 "",
                 optionRow("Trust", selected === 0),
                 optionRow("Do not trust", selected === 1),

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

@@ -628,7 +628,7 @@ export class SettingsApp {
         const open = this.#structured;
         if (open !== null)
             return this.#dialogLines(open, width, theme);
-        const hint = this.#interruptArmed ? "press ctrl+c again to exit A1" : SETTINGS_SHORTCUTS.hint(SCOPE);
+        const hint = this.#interruptArmed ? "press ctrl+c again to exit a1" : SETTINGS_SHORTCUTS.hint(SCOPE);
         const status = renderStatusLine({ hint, report: this.#notice }, width, theme);
         const input = this.#filter;
         if (input === null)

package/dist/features/prompt-history/service.d.ts

@@ -1,6 +1,12 @@
 import type { Worker } from "node:worker_threads";
 import { type PromptHistoryFailure, type PromptHistoryPort, type PromptHistoryResult, type PromptHistorySnapshot, type PromptHistorySubmission } from "../../contracts/owned-ui/index.js";
-/** Owns a finite asynchronous history queue; storage faults never throw into prompt dispatch. */
+export type HistoryRecoveryState = "starting" | "ready" | "recovering" | "blocked-storage" | "closing" | "closed";
+export interface HistoryClock {
+    now(): number;
+    setTimeout(callback: () => void, milliseconds: number): ReturnType<typeof setTimeout>;
+    clearTimeout(timer: ReturnType<typeof setTimeout> | undefined): void;
+}
+/** One generation owns storage work; only proven non-commits may be retried. No default output sink. */
 export declare class PromptHistoryService implements PromptHistoryPort {
     #private;
     readonly options: {
@@ -8,13 +14,37 @@ export declare class PromptHistoryService implements PromptHistoryPort {
         profileRoot: string;
         limit: number;
         createWorker?: () => Worker;
+        clock?: HistoryClock;
+        random?: () => number;
     };
     constructor(options: {
         dataDir: string;
         profileRoot: string;
         limit: number;
         createWorker?: () => Worker;
+        clock?: HistoryClock;
+        random?: () => number;
     });
+    /** Explicit developer inspection: bounded classified counters, never exception or prompt payloads. */
+    diagnostics(): {
+        state: HistoryRecoveryState;
+        generation: number;
+        attempts: number;
+        recoveries: number;
+        pending: number;
+        bytes: number;
+        active: boolean;
+        timers: number;
+        failures: {
+            schema?: number;
+            shutdown?: number;
+            unavailable?: number;
+            busy?: number;
+            capacity?: number;
+            oversized?: number;
+            corrupt?: number;
+        };
+    };
     start(): void;
     record(submission: PromptHistorySubmission): Promise<PromptHistoryResult>;
     refresh(): void;