@timurproko/a1 0.2.7-dev.754 → 0.2.7-dev.772

package/dist/foundation/session-writer-lock/index.js

@@ -0,0 +1,201 @@
+import { closeSync, existsSync, mkdirSync, openSync, readFileSync, realpathSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { tmpdir } from "node:os";
+import { basename, dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { createHash } from "node:crypto";
+import { PRODUCT_IDENTITY } from "../../product-identity.js";
+/** Reports that a canonical session identity already has a live writer. */
+export class SessionWriterConflict extends Error {
+    path;
+    holderKind;
+    constructor(path, holderKind = "another A1 process") {
+        super(`session is open in ${holderKind}`);
+        this.name = "SessionWriterConflict";
+        this.path = path;
+        this.holderKind = holderKind;
+    }
+}
+let backendOverride;
+let cachedBackend;
+/** Development-only override naming a native lock addon to load first. */
+export const SESSION_LOCK_OVERRIDE_ENVIRONMENT = "A1_SESSION_LOCK_PATH";
+/** Security: a release that carries its own lock never loads an addon chosen by the environment or cwd. */
+export function nativeCandidates(moduleUrl = import.meta.url, env = process.env, cwd = process.cwd(), exists = existsSync) {
+    const addon = "a1_session_lock.node";
+    // Invariant: this module sits at dist/foundation/session-writer-lock/ inside the release root.
+    const own = resolve(fileURLToPath(new URL("../../../", moduleUrl)), "dist", "native", `${process.platform}-${process.arch}`, addon);
+    const override = env[PRODUCT_IDENTITY.environment.developmentInstanceId] ? env[SESSION_LOCK_OVERRIDE_ENVIRONMENT]?.trim() || undefined : undefined;
+    const local = exists(own) ? [own] : [resolve(cwd, "dist", "native", `${process.platform}-${process.arch}`, addon), resolve(cwd, ".artifacts", "terminal-host", addon)];
+    return override ? [override, ...local] : local;
+}
+function loadNativeBackend() {
+    const require = createRequire(import.meta.url);
+    for (const candidate of nativeCandidates()) {
+        if (!existsSync(candidate))
+            continue;
+        try {
+            const loaded = require(candidate);
+            if (loaded.SessionLock?.acquire)
+                return loaded.SessionLock;
+        }
+        catch {
+            // Compatibility: an addon for another Node ABI is unusable; try the next location.
+        }
+    }
+    return undefined;
+}
+function processIsLive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Development fallback. Installed releases carry the verified Node-API lock resolved above. */
+function portableBackend() {
+    const root = join(tmpdir(), "a1-session-writer-locks");
+    mkdirSync(root, { recursive: true, mode: 0o700 });
+    const authorityPath = (kind, key) => join(root, `${createHash("sha256").update(`${kind}\0${key}`).digest("hex")}.lock`);
+    const locationKey = (path) => `${realpathSync.native(dirname(path))}\0${process.platform === "win32" ? basename(path).toLowerCase() : basename(path)}`;
+    const identityKey = (path) => {
+        const physical = realpathSync.native(path);
+        const metadata = statSync(physical, { bigint: true });
+        return `${metadata.dev}:${metadata.ino}`;
+    };
+    const acquireAuthority = (path) => {
+        for (let attempt = 0; attempt < 2; attempt += 1) {
+            try {
+                const descriptor = openSync(path, "wx", 0o600);
+                writeFileSync(descriptor, JSON.stringify({ pid: process.pid, kind: process.env.A1_TAB_ID ? "resident tab" : "another A1 process" }));
+                closeSync(descriptor);
+                return;
+            }
+            catch (error) {
+                if (attempt === 0) {
+                    try {
+                        const record = JSON.parse(readFileSync(path, "utf8"));
+                        if (typeof record.pid === "number" && !processIsLive(record.pid)) {
+                            rmSync(path, { force: true });
+                            continue;
+                        }
+                    }
+                    catch {
+                        // Security: malformed or racing lock evidence remains authoritative and fails closed.
+                    }
+                }
+                throw error;
+            }
+        }
+    };
+    return {
+        acquire(requested) {
+            const absolute = resolve(requested);
+            const location = authorityPath("location", locationKey(absolute));
+            acquireAuthority(location);
+            let identity;
+            let identityAcquired = false;
+            let bound = false;
+            try {
+                if (existsSync(absolute)) {
+                    const key = identityKey(absolute);
+                    identity = authorityPath("identity", key);
+                    acquireAuthority(identity);
+                    identityAcquired = true;
+                    if (identityKey(absolute) !== key) {
+                        throw new Error("session identity changed while its writer lock was acquired");
+                    }
+                    rmSync(location, { force: true });
+                    bound = true;
+                }
+            }
+            catch (error) {
+                rmSync(location, { force: true });
+                if (identityAcquired && identity !== undefined)
+                    rmSync(identity, { force: true });
+                throw error;
+            }
+            let released = false;
+            return {
+                get bound() { return bound; },
+                bindCreated(created) {
+                    if (bound || resolve(created) !== absolute || !existsSync(absolute)) {
+                        throw new Error("created session does not match its reservation");
+                    }
+                    const key = identityKey(absolute);
+                    identity = authorityPath("identity", key);
+                    acquireAuthority(identity);
+                    if (identityKey(absolute) !== key) {
+                        rmSync(identity, { force: true });
+                        identity = undefined;
+                        throw new Error("created session identity changed during bind");
+                    }
+                    rmSync(location, { force: true });
+                    bound = true;
+                },
+                release() {
+                    if (released)
+                        throw new Error("session lock was already released");
+                    released = true;
+                    rmSync(bound ? identity : location, { force: true });
+                },
+            };
+        },
+    };
+}
+function backend() {
+    return backendOverride ?? (cachedBackend ??= loadNativeBackend() ?? portableBackend());
+}
+function acquire(path) {
+    const absolute = resolve(path);
+    let lock;
+    try {
+        lock = backend().acquire(absolute);
+    }
+    catch {
+        throw new SessionWriterConflict(absolute, process.env.A1_TAB_ID ? "a resident tab" : "another A1 process");
+    }
+    let released = false;
+    return {
+        path: absolute,
+        get bound() { return lock.bound; },
+        bind(createdPath = absolute) {
+            if (released)
+                throw new Error("session writer lock was released");
+            if (!lock.bound)
+                lock.bindCreated(resolve(createdPath));
+        },
+        release() {
+            if (released)
+                return;
+            released = true;
+            lock.release();
+        },
+    };
+}
+export function acquireExisting(path) {
+    if (!existsSync(path))
+        throw new Error(`session file does not exist: ${path}`);
+    return acquire(path);
+}
+export function reserveNew(parent, name) {
+    if (!name || basename(name) !== name)
+        throw new Error("session reservation requires one file name");
+    return acquire(join(parent, name));
+}
+export function acquireSessionWriter(path) {
+    return acquire(path);
+}
+export function bind(handle, createdPath) {
+    handle.bind(createdPath);
+}
+export function release(handle) {
+    handle.release();
+}
+/** Test-only backend seam; passing undefined restores native discovery. */
+export function setSessionWriterLockBackendForTest(value) {
+    backendOverride = value;
+    cachedBackend = undefined;
+}

package/dist/foundation/startup/startup-descriptor.js

@@ -10,7 +10,7 @@ export const STARTUP_DESCRIPTOR = Object.freeze({
   ],
   "generatedArtifact": {
     "path": "dist/integrations/pi/startup-public.js",
-    "sha256": "62906f5056fabed7a83b97843e3a407c955103ab2bb7849e6713026fe7c760a9"
+    "sha256": "2e5c23263868c689b0b76648a7565fe4384f8144f4c11b64569a08fc4d3502c2"
   },
   "dependencyLayerIdentity": {
     "source": "A1_RELEASE_LAYERS",
@@ -19,7 +19,7 @@ export const STARTUP_DESCRIPTOR = Object.freeze({
   "compileCacheNamespace": {
     "strategy": "node-abi-version-and-ordered-layer-sha256-v1"
   },
-  "identity": "089bcfdc784e7d61cd028ede3b5546864ab49e6329e1296ed55afacb16bcb077"
+  "identity": "5d1fea810b3c76b1560dd3a743dd4db0b8d03935d9f5079fd4b2da55d4f1084a"
 });
 
 export function loadDeclaredStartupGraph() {

package/dist/foundation/terminal-cleanup/index.d.ts

@@ -1,3 +1,3 @@
-export { EMERGENCY_TERMINAL_RESET, boundedCleanup, restoreAfterOwnedExit, restoreProcessTerminal } from "./terminal-reset.js";
+export { CLEAR_EXIT_INTERVAL_MS, EMERGENCY_TERMINAL_RESET, boundedCleanup, restoreAfterOwnedExit, restoreProcessTerminal } from "./terminal-reset.js";
 export { installFatalExit, writeFatalDiagnostic } from "./fatal-exit.js";
 export type { FatalExitOptions } from "./fatal-exit.js";

package/dist/foundation/terminal-cleanup/index.js

@@ -1,2 +1,2 @@
-export { EMERGENCY_TERMINAL_RESET, boundedCleanup, restoreAfterOwnedExit, restoreProcessTerminal } from "./terminal-reset.js";
+export { CLEAR_EXIT_INTERVAL_MS, EMERGENCY_TERMINAL_RESET, boundedCleanup, restoreAfterOwnedExit, restoreProcessTerminal } from "./terminal-reset.js";
 export { installFatalExit, writeFatalDiagnostic } from "./fatal-exit.js";

package/dist/foundation/terminal-cleanup/terminal-reset.d.ts

@@ -1,3 +1,4 @@
+export declare const CLEAR_EXIT_INTERVAL_MS = 500;
 export declare const EMERGENCY_TERMINAL_RESET: string;
 export declare function restoreProcessTerminal(): void;
 export declare function restoreAfterOwnedExit(ownsTerminal: boolean, code: number | null, signal: string | null, restore?: () => void): number;

package/dist/foundation/terminal-cleanup/terminal-reset.js

@@ -1,4 +1,5 @@
 import { writeSync } from "node:fs";
+export const CLEAR_EXIT_INTERVAL_MS = 500;
 // Protocol: reset modes on both screens; setting keyboard flags to zero is idempotent,
 // unlike repeatedly popping a keyboard-protocol stack owned by a parent application.
 // Resetting parent-screen margins homes the cursor, so preserve its restored position.

package/dist/integrations/pi/components/owned-editor-ux.d.ts

@@ -44,7 +44,7 @@ export declare class OwnedEditorUxInterception {
     pasteClipboard(): boolean;
 }
 export interface PromptSelectionUxOptions {
-    readonly copyText: (text: string) => void;
+    readonly copyText: (text: string, cut: boolean) => void;
     readonly readClipboardContent: () => Promise<PiShellClipboardContent | null>;
     readonly beginClipboardPaste?: () => PiShellPasteReservation;
     readonly beginTextPaste?: (text: string) => PiShellPasteReservation;

package/dist/integrations/pi/components/owned-editor-ux.js

@@ -88,12 +88,12 @@ class PromptSelectionInterceptor {
             return;
         }
         if (this.keybindings.matches(data, "tui.input.copy") && this.hasSelection()) {
-            this.options.copyText(this.options.expandCopiedText(this.#selectedText()));
+            this.options.copyText(this.options.expandCopiedText(this.#selectedText()), false);
             this.#collapseCopiedSelection();
             return;
         }
         if (this.keybindings.matches(data, "owned.editor.cut") && this.hasSelection()) {
-            this.options.copyText(this.options.expandCopiedText(this.#selectedText()));
+            this.options.copyText(this.options.expandCopiedText(this.#selectedText()), true);
             if (!this.#deleteSelection())
                 this.#deleteAtomicFocus();
             return;

package/dist/integrations/pi/components/resources/builtin-themes.d.ts

@@ -1,8 +1,8 @@
 /**
- * Attributed owned theme resources adapted from @earendil-works/pi-coding-agent 1.1.0 (MIT),
- * commit abe508e1b89912adde45528136c3221eb69acdd7.
- * Upstream dark.json SHA-256: c11a588b714d35300293079b425fb09a3693d4b2d453585d211b08163c648b75
- * Upstream light.json SHA-256: f590c51c2bc8b238891efd0e983473ed2e2a6487b6692cc1d4b2845165e703f7
+ * Attributed owned theme resources adapted from @earendil-works/pi-coding-agent 1.2.0 (MIT),
+ * commit 06a466935536f8c9bcacb2d5efc0fc021be1bdff.
+ * Upstream dark.json SHA-256: e1f96982f8cb7d2a48eca7db03c9cb282cb1e14a243680cd855638ecd6a251b6
+ * Upstream light.json SHA-256: 2dee6a4be7f765e7fd7728166b7ebf8c29e4ce313f8ec6b38ae50699e3abc2f3
  * Modifications: removed upstream schema/export metadata; runtime color data is unchanged.
  */
 export declare const BUILTIN_THEME_RESOURCES: Readonly<{

package/dist/integrations/pi/components/resources/builtin-themes.js

@@ -1,8 +1,8 @@
 /**
- * Attributed owned theme resources adapted from @earendil-works/pi-coding-agent 1.1.0 (MIT),
- * commit abe508e1b89912adde45528136c3221eb69acdd7.
- * Upstream dark.json SHA-256: c11a588b714d35300293079b425fb09a3693d4b2d453585d211b08163c648b75
- * Upstream light.json SHA-256: f590c51c2bc8b238891efd0e983473ed2e2a6487b6692cc1d4b2845165e703f7
+ * Attributed owned theme resources adapted from @earendil-works/pi-coding-agent 1.2.0 (MIT),
+ * commit 06a466935536f8c9bcacb2d5efc0fc021be1bdff.
+ * Upstream dark.json SHA-256: e1f96982f8cb7d2a48eca7db03c9cb282cb1e14a243680cd855638ecd6a251b6
+ * Upstream light.json SHA-256: 2dee6a4be7f765e7fd7728166b7ebf8c29e4ce313f8ec6b38ae50699e3abc2f3
  * Modifications: removed upstream schema/export metadata; runtime color data is unchanged.
  */
 export const BUILTIN_THEME_RESOURCES = Object.freeze({

package/dist/integrations/pi/components/shell-hotkey-sections.js

@@ -6,7 +6,7 @@ import { hotkeysMarkdown } from "./shell-presenters-info.js";
 export function renderPiShellHotkeySections(presentation, width) {
     ensureTheme();
     const shortcuts = presentation.getShortcuts ?? (() => []);
-    const markdown = hotkeysMarkdown(presentation.bindings, shortcuts, presentation.profile ?? "pi");
+    const markdown = hotkeysMarkdown(presentation.bindings, shortcuts, presentation.profile ?? "pi", presentation.residentTabs);
     const sections = [];
     for (const line of markdown.split("\n")) {
         const heading = /^\*\*(.+)\*\*$/.exec(line)?.[1];

package/dist/integrations/pi/components/shell-presenters-info.d.ts

@@ -68,11 +68,13 @@ export interface PiShellHotkeysPresentation {
     readonly bindings?: KeybindingsConfig;
     readonly getShortcuts?: NonNullable<PiShellExtensionRendererResolver["getShortcuts"]>;
     readonly profile?: "pi" | "a1";
+    readonly residentTabs?: boolean;
 }
-export declare function createPiShellHotkeys(bindings?: KeybindingsConfig, getShortcuts?: NonNullable<PiShellExtensionRendererResolver["getShortcuts"]>, profile?: "pi" | "a1"): PiShellComponentPort;
+export declare function createPiShellHotkeys(bindings?: KeybindingsConfig, getShortcuts?: NonNullable<PiShellExtensionRendererResolver["getShortcuts"]>, profile?: "pi" | "a1", residentTabs?: boolean): PiShellComponentPort;
 /** The keyboard-shortcut document rows the feed presenter shows, without its spacer, borders, and heading. */
 export declare function renderPiShellHotkeysLines(presentation: PiShellHotkeysPresentation, width: number): readonly string[];
-export declare function hotkeysMarkdown(bindings: KeybindingsConfig | undefined, getShortcuts: NonNullable<PiShellExtensionRendererResolver["getShortcuts"]>, profile: "pi" | "a1"): string;
+export declare const TAB_HOTKEYS: readonly (readonly [string, string | null, string])[];
+export declare function hotkeysMarkdown(bindings: KeybindingsConfig | undefined, getShortcuts: NonNullable<PiShellExtensionRendererResolver["getShortcuts"]>, profile: "pi" | "a1", residentTabs?: boolean): string;
 /**
  * Pinned Pi's `showPackageUpdateNotification` banner: warning-coloured dynamic
  * borders around a bold warning title, the muted update instruction with the

package/dist/integrations/pi/components/shell-presenters-info.js

@@ -147,9 +147,9 @@ function shortcutDisplay(key) {
         return label.charAt(0).toUpperCase() + label.slice(1);
     }).join("+")).join("/");
 }
-export function createPiShellHotkeys(bindings, getShortcuts = () => [], profile = "pi") {
+export function createPiShellHotkeys(bindings, getShortcuts = () => [], profile = "pi", residentTabs = false) {
     ensureTheme();
-    const markdown = hotkeysMarkdown(bindings, getShortcuts, profile);
+    const markdown = hotkeysMarkdown(bindings, getShortcuts, profile, residentTabs);
     const container = new Container();
     container.addChild(new Spacer(1));
     container.addChild(new DynamicBorder(paintPiBorder));
@@ -162,12 +162,20 @@ export function createPiShellHotkeys(bindings, getShortcuts = () => [], profile
 /** The keyboard-shortcut document rows the feed presenter shows, without its spacer, borders, and heading. */
 export function renderPiShellHotkeysLines(presentation, width) {
     ensureTheme();
-    return hotkeysMarkdownComponent(hotkeysMarkdown(presentation.bindings, presentation.getShortcuts ?? (() => []), presentation.profile ?? "pi")).render(width);
+    return hotkeysMarkdownComponent(hotkeysMarkdown(presentation.bindings, presentation.getShortcuts ?? (() => []), presentation.profile ?? "pi", presentation.residentTabs)).render(width);
 }
 function hotkeysMarkdownComponent(markdown) {
     return new Markdown(markdown, 1, 1, getPiHotkeysMarkdownTheme());
 }
-export function hotkeysMarkdown(bindings, getShortcuts, profile) {
+// Performance: keep startup presentation independent from the registry; parity is contract-tested.
+export const TAB_HOTKEYS = [
+    ["tabs.new", "alt+a", "New A1 tab"], ["tabs.close", "alt+w", "Close A1 tab"],
+    ["tabs.rename", "f2", "Rename A1 tab"],
+    ...Array.from({ length: 10 }, (_, index) => [`tabs.jump${index + 1}`, `alt+${(index + 1) % 10}`, `View A1 tab ${index + 1}`]),
+    ["tabs.next", null, "View next A1 tab"], ["tabs.previous", null, "View previous A1 tab"],
+    ["tabs.moveRight", null, "Move A1 tab right"], ["tabs.moveLeft", null, "Move A1 tab left"],
+];
+export function hotkeysMarkdown(bindings, getShortcuts, profile, residentTabs = false) {
     const keys = profile === "a1" ? KeybindingsManager.fromOwnedBindings(bindings) : new KeybindingsManager(bindings);
     // Compatibility: the owned viewport consumes these physical chords before editor actions.
     const display = (action) => keys.getKeys(action)
@@ -180,6 +188,32 @@ export function hotkeysMarkdown(bindings, getShortcuts, profile) {
             : `\`${label}\``;
     }).join(" / ")} | ${description} |`;
     let markdown = ["**Navigation**", "| Key | Action |", "|-----|--------|", row(["tui.editor.cursorUp", "tui.editor.cursorDown", "tui.editor.cursorLeft", "tui.editor.cursorRight"], "Move cursor / browse history"), row(["tui.editor.cursorWordLeft", "tui.editor.cursorWordRight"], "Move by word"), row(["tui.editor.cursorLineStart"], profile === "a1" ? "Start of prompt line" : "Start of line"), row(["tui.editor.cursorLineEnd"], profile === "a1" ? "End of prompt line" : "End of line"), ...(profile === "a1" ? ["| `Ctrl+Home` | Start of content |", "| `Ctrl+End` | End of content / follow output |"] : []), row(["tui.editor.jumpForward"], "Jump forward to character"), row(["tui.editor.jumpBackward"], "Jump backward to character"), row(["tui.editor.pageUp", "tui.editor.pageDown"], "Scroll by page"), "", "**Editing**", "| Key | Action |", "|-----|--------|", row(["tui.input.submit"], "Send message"), row(["tui.input.newLine"], `New line${process.platform === "win32" ? " (Ctrl+Enter on Windows Terminal)" : ""}`), row(["tui.editor.deleteWordBackward"], "Delete word backwards"), row(["tui.editor.deleteWordForward"], "Delete word forwards"), row(["tui.editor.deleteToLineStart"], "Delete to start of line"), row(["tui.editor.deleteToLineEnd"], "Delete to end of line"), row(["tui.editor.yank"], "Paste the most-recently-deleted text"), row(["tui.editor.yankPop"], "Cycle through the deleted text after pasting"), row(["tui.editor.undo"], "Undo"), "", "**Other**", "| Key | Action |", "|-----|--------|", row(["tui.input.tab"], "Path completion / accept autocomplete"), row(["app.interrupt"], "Cancel autocomplete / abort streaming"), row(["app.clear"], "Clear editor (first) / exit (second)"), row(["app.exit"], "Exit (when editor is empty)"), row(["app.suspend"], "Suspend to background"), row(["app.thinking.cycle"], "Cycle thinking level"), row(["app.model.cycleForward", "app.model.cycleBackward"], "Cycle models"), row(["app.model.select"], profile === "a1" ? "Open the Models dialog" : "Open model selector"), row(["app.tools.expand"], "Toggle tool output expansion"), row(["app.thinking.toggle"], "Toggle thinking block visibility"), row(["app.editor.external"], "Edit message in external editor"), row(["app.message.copy"], "Copy selection or last assistant message"), row(["app.message.followUp"], "Queue follow-up message"), row(["app.message.dequeue"], "Restore queued messages"), row(["app.clipboard.pasteImage"], profile === "a1" ? "Paste image or text from clipboard" : "Paste files on macOS, images, or text from clipboard"), "| `/` | Slash commands |", "| `!` | Run bash command |", "| `!!` | Run bash command (excluded from context) |", ...(profile === "a1" ? ["", "**Models dialog**", "| Key | Action |", "|-----|--------|", "| `Space` | Toggle the selected model in the cycling scope |", "| `Tab` | Switch the all/scoped filter |", row(["app.models.save"], "Save the scope to settings"), row(["app.models.enableAll"], "Scope every listed model"), row(["app.models.clearAll"], "Clear the listed models from the scope"), row(["app.models.toggleProvider"], "Toggle the selected model's provider"), row(["app.models.reorderUp", "app.models.reorderDown"], "Reorder the cycling scope")] : [])].join("\n");
+    if (profile === "a1" && residentTabs) {
+        const configured = (bindings ?? {});
+        markdown += "\n\n**Tabs**\n| Key | Action |\n|-----|--------|\n";
+        const claimed = new Set();
+        for (const [action, value] of Object.entries(configured)) {
+            if (action.startsWith("tabs."))
+                continue;
+            const keys = typeof value === "string" ? [value] : Array.isArray(value) ? value : [];
+            for (const key of keys)
+                if (typeof key === "string")
+                    claimed.add(key.toLowerCase());
+        }
+        markdown += TAB_HOTKEYS.map(([id, defaultKey, description]) => {
+            const value = configured[id];
+            const assigned = (typeof value === "string" ? [value] : Array.isArray(value) ? value.filter((key) => typeof key === "string") : defaultKey === null ? [] : [defaultKey])
+                .filter(key => {
+                const normalized = key.toLowerCase();
+                if (claimed.has(normalized))
+                    return false;
+                claimed.add(normalized);
+                return true;
+            });
+            const label = assigned.length === 0 ? "Unbound" : `\`${assigned.map(shortcutDisplay).join("/")}\``;
+            return `| ${label} | ${description} |`;
+        }).join("\n");
+    }
     const shortcuts = getShortcuts(bindings ?? keys.getEffectiveConfig());
     if (shortcuts.length > 0) {
         markdown += "\n\n**Extensions**\n| Key | Action |\n|-----|--------|\n";

package/dist/integrations/pi/components/shell-shared-facade.d.ts

@@ -185,7 +185,7 @@ export interface PiShellEditorOptions {
     readonly onFollowUp?: (() => void) | undefined;
     readonly onDequeue?: (() => void) | undefined;
     readonly onPromptSuggestionAccepted?: (text: string) => void;
-    readonly onCopyText?: (text: string) => void;
+    readonly onCopyText?: (text: string, cut: boolean) => void;
     readonly readClipboardContent?: (signal?: AbortSignal) => Promise<PiShellClipboardContent | null>;
     readonly beginClipboardPaste?: () => PiShellPasteReservation;
     readonly beginTextPaste?: (text: string) => PiShellPasteReservation;

package/dist/integrations/pi/components/upstream/adjacent/core/keybindings.d.ts

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.2.0 (MIT), commit 06a466935536f8c9bcacb2d5efc0fc021be1bdff,
  * packages/coding-agent/src/core/keybindings.ts.
  * Modifications: Mechanical source port with Node import prefixes, public package-root agent-directory
  * resolution, and an opt-in bare-A1 input profile including Ctrl+L level cycling, unbound model

package/dist/integrations/pi/components/upstream/adjacent/core/keybindings.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.2.0 (MIT), commit 06a466935536f8c9bcacb2d5efc0fc021be1bdff,
  * packages/coding-agent/src/core/keybindings.ts.
  * Modifications: Mechanical source port with Node import prefixes, public package-root agent-directory
  * resolution, and an opt-in bare-A1 input profile including Ctrl+L level cycling, unbound model
@@ -9,7 +9,7 @@
  * Deviations: keybindings-public-config-boundary, owned-level-cycle-shortcut,
  * owned-input-keybinding-aliases, owned-session-tree-dialog, owned-dialog-ctrl-c-cancel.
  */
-import { matchesKey, TUI_KEYBINDINGS, KeybindingsManager as TuiKeybindingsManager, } from "@earendil-works/pi-tui";
+import { Key, matchesKey, TUI_KEYBINDINGS, KeybindingsManager as TuiKeybindingsManager, } from "@earendil-works/pi-tui";
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { getAgentDir } from "../../../../startup-public.js";
@@ -278,14 +278,27 @@ const KEYBINDING_NAME_MIGRATIONS = {
 function isLegacyKeybindingName(key) {
     return key in KEYBINDING_NAME_MIGRATIONS;
 }
+const KEYBINDING_MODIFIERS = ["ctrl", "shift", "alt", "super"];
+const BASE_KEY_PATTERN = `(?:[a-z0-9]|${Object.values(Key)
+    .flatMap((value) => (typeof value === "string" ? [value.replace(/[\\^$.*+?()[\]{}|]/g, "\\$&")] : []))
+    .join("|")})`;
+const DUPLICATE_MODIFIER_PATTERN = KEYBINDING_MODIFIERS
+    .map((modifier) => `${modifier}\\+.*${modifier}\\+`)
+    .join("|");
+const KEY_ID_PATTERN = new RegExp(`^(?!.*(?:${DUPLICATE_MODIFIER_PATTERN}))(?:(?:${KEYBINDING_MODIFIERS.join("|")})\\+){0,4}${BASE_KEY_PATTERN}$`);
+function isKeyId(value) {
+    return typeof value === "string" && KEY_ID_PATTERN.test(value);
+}
 function toKeybindingsConfig(value) {
     const config = {};
     for (const [key, binding] of Object.entries(value)) {
-        if (typeof binding === "string") {
+        if (key === "$schema")
+            continue;
+        if (isKeyId(binding)) {
             config[key] = binding;
             continue;
         }
-        if (Array.isArray(binding) && binding.every((entry) => typeof entry === "string")) {
+        if (Array.isArray(binding) && binding.every(isKeyId)) {
             config[key] = binding;
         }
     }

package/dist/integrations/pi/components/upstream/assets/earendil-image.json

@@ -1,8 +1,8 @@
 {
     "sourcePackage": "@earendil-works/pi-coding-agent",
-    "sourceVersion": "1.1.0",
+    "sourceVersion": "1.2.0",
     "upstreamRepository": "https://github.com/earendil-works/pi.git",
-    "upstreamCommit": "abe508e1b89912adde45528136c3221eb69acdd7",
+    "upstreamCommit": "06a466935536f8c9bcacb2d5efc0fc021be1bdff",
     "sourcePath": "dist/modes/interactive/assets/clankolas.png",
     "sourceSha256": "169acd0dfe6fbb8d8742ed24a3fc654fd0b2e2d4223c733249c5493723f1b72d",
     "license": "MIT",

package/dist/integrations/pi/components/upstream/components/countdown-timer.d.ts

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.2.0 (MIT), commit 06a466935536f8c9bcacb2d5efc0fc021be1bdff,
  * packages/coding-agent/src/modes/interactive/components/countdown-timer.ts.
  * Modifications: Mechanical source port with ECMAScript private fields; imports remain on the public
  * Pi TUI package root.

package/dist/integrations/pi/components/upstream/components/earendil-announcement.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.2.0 (MIT), commit 06a466935536f8c9bcacb2d5efc0fc021be1bdff,
  * packages/coding-agent/src/modes/interactive/components/earendil-announcement.ts.
  * Modifications: Mechanical pinned source port with private imports remapped to public package-root
  * types/APIs and A1-owned theme boundaries. The unchanged image is loaded lazily from its attributed,

package/dist/integrations/pi/components/upstream/components/extension-editor.d.ts

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.2.0 (MIT), commit 06a466935536f8c9bcacb2d5efc0fc021be1bdff,
  * packages/coding-agent/src/modes/interactive/components/extension-editor.ts.
  * Modifications: Mechanical port: remap pi-tui to the root public singleton, use owned
  * keybindings/theme and external-editor seams, preserve editor layout, hints, focus, submission,

package/dist/integrations/pi/components/upstream/components/extension-editor.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.2.0 (MIT), commit 06a466935536f8c9bcacb2d5efc0fc021be1bdff,
  * packages/coding-agent/src/modes/interactive/components/extension-editor.ts.
  * Modifications: Mechanical port: remap pi-tui to the root public singleton, use owned
  * keybindings/theme and external-editor seams, preserve editor layout, hints, focus, submission,

package/dist/integrations/pi/components/upstream/components/extension-input.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.2.0 (MIT), commit 06a466935536f8c9bcacb2d5efc0fc021be1bdff,
  * packages/coding-agent/src/modes/interactive/components/extension-input.ts.
  * Modifications: Mechanical port: remap public imports, use ECMAScript private fields, and route the
  * bare-A1 instruction row and chrome through the shared semantic shortcut and compact padded

package/dist/integrations/pi/components/upstream/components/extension-selector.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.2.0 (MIT), commit 06a466935536f8c9bcacb2d5efc0fc021be1bdff,
  * packages/coding-agent/src/modes/interactive/components/extension-selector.ts.
  * Modifications: Mechanical port: remap public imports, use ECMAScript private fields, and route the
  * bare-A1 instruction row and chrome through the shared semantic shortcut and compact padded

package/dist/integrations/pi/components/upstream/components/mermaid.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.2.0 (MIT), commit 06a466935536f8c9bcacb2d5efc0fc021be1bdff,
  * packages/coding-agent/src/modes/interactive/components/mermaid.ts.
  * Modifications: Mechanical pinned source port with private imports remapped to public package-root
  * types/APIs and A1-owned theme boundaries; behavior remains acceptance-tested.

package/dist/integrations/pi/components/upstream/components/owned-editor.d.ts

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.2.0 (MIT), commit 06a466935536f8c9bcacb2d5efc0fc021be1bdff,
  * packages/coding-agent/src/modes/interactive/components/custom-editor.ts.
  * Modifications: A1-owned class name and synchronized A1 keybinding contract replace the nominal
  * private upstream keybinding constructor dependency; bare A1 injects the shared Settings/agent input

package/dist/integrations/pi/components/upstream/components/owned-editor.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.2.0 (MIT), commit 06a466935536f8c9bcacb2d5efc0fc021be1bdff,
  * packages/coding-agent/src/modes/interactive/components/custom-editor.ts.
  * Modifications: A1-owned class name and synchronized A1 keybinding contract replace the nominal
  * private upstream keybinding constructor dependency; bare A1 injects the shared Settings/agent input

package/dist/integrations/pi/components/upstream/components/pi-logo.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.2.0 (MIT), commit 06a466935536f8c9bcacb2d5efc0fc021be1bdff,
  * packages/coding-agent/src/modes/interactive/components/pi-logo.ts.
  * Modifications: Remapped the private theme import to A1's public-backed adapter and composed the
  * fixed-color logo into the owned startup header.

package/dist/integrations/pi/components/upstream/components/scoped-models-selector.d.ts

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.2.0 (MIT), commit 06a466935536f8c9bcacb2d5efc0fc021be1bdff,
  * packages/coding-agent/src/modes/interactive/components/scoped-models-selector.ts.
  * Modifications: Source-synchronized scoped-model selector port: preserve session-only toggles,
  * search, bulk/provider/reorder actions, dirty state, Ctrl+S persistence, refresh status,

package/dist/integrations/pi/components/upstream/components/session-footer.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.2.0 (MIT), commit 06a466935536f8c9bcacb2d5efc0fc021be1bdff,
  * packages/coding-agent/src/modes/interactive/components/footer.ts.
  * Modifications: Consumes neutral owned-UI view data instead of a fabricated concrete AgentSession;
  * preserves the latest physical route for virtual models; an explicit bare-A1 profile colors the

package/dist/integrations/pi/components/upstream/components/session-selector-search.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.2.0 (MIT), commit 06a466935536f8c9bcacb2d5efc0fc021be1bdff,
  * packages/coding-agent/src/modes/interactive/components/session-selector-search.ts.
  * Modifications: Source-synchronized session search port with only the public SessionInfo type import
  * remapped.

package/dist/integrations/pi/components/upstream/components/session-selector.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.2.0 (MIT), commit 06a466935536f8c9bcacb2d5efc0fc021be1bdff,
  * packages/coding-agent/src/modes/interactive/components/session-selector.ts.
  * Modifications: Source-synchronized session selector port: preserve threaded/current/all scope,
  * search, sort, named/path filters, rename, delete confirmation, active-session protection,

package/dist/integrations/pi/components/upstream/components/skill-invocation-message.d.ts

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.2.0 (MIT), commit 06a466935536f8c9bcacb2d5efc0fc021be1bdff,
  * packages/coding-agent/src/modes/interactive/components/skill-invocation-message.ts.
  * Modifications: Mechanical port uses A1's public pi-tui instance, owned theme boundary, and
  * root-instance keybinding registry because the public coding-agent component closes over a second

package/dist/integrations/pi/components/upstream/components/skill-invocation-message.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.2.0 (MIT), commit 06a466935536f8c9bcacb2d5efc0fc021be1bdff,
  * packages/coding-agent/src/modes/interactive/components/skill-invocation-message.ts.
  * Modifications: Mechanical port uses A1's public pi-tui instance, owned theme boundary, and
  * root-instance keybinding registry because the public coding-agent component closes over a second