@timurproko/a1 0.1.8-dev.3b54f21 → 0.1.8-dev.407

package/dist/integrations/pi/components/upstream/history/kill-ring.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Adapted from @earendil-works/pi-tui 0.84.2, packages/tui/src/kill-ring.ts (MIT).
+ * Source commit: 914cf1472e715297caa30db4b9535d534a9eb718.
+ * Modifications: public imports and owned editor-local typed seams; see docs/architecture/history-editor-provenance.md.
+ */
+/**
+ * Ring buffer for Emacs-style kill/yank operations.
+ *
+ * Tracks killed (deleted) text entries. Consecutive kills can accumulate
+ * into a single entry. Supports yank (paste most recent) and yank-pop
+ * (cycle through older entries).
+ */
+export declare class KillRing {
+    private ring;
+    /**
+     * Add text to the kill ring.
+     *
+     * @param text - The killed text to add
+     * @param opts - Push options
+     * @param opts.prepend - If accumulating, prepend (backward deletion) or append (forward deletion)
+     * @param opts.accumulate - Merge with the most recent entry instead of creating a new one
+     */
+    push(text: string, opts: {
+        prepend: boolean;
+        accumulate?: boolean;
+    }): void;
+    /** Get most recent entry without modifying the ring. */
+    peek(): string | undefined;
+    /** Move last entry to front (for yank-pop cycling). */
+    rotate(): void;
+    get length(): number;
+}

package/dist/integrations/pi/components/upstream/history/kill-ring.js

@@ -0,0 +1,48 @@
+/**
+ * Adapted from @earendil-works/pi-tui 0.84.2, packages/tui/src/kill-ring.ts (MIT).
+ * Source commit: 914cf1472e715297caa30db4b9535d534a9eb718.
+ * Modifications: public imports and owned editor-local typed seams; see docs/architecture/history-editor-provenance.md.
+ */
+/**
+ * Ring buffer for Emacs-style kill/yank operations.
+ *
+ * Tracks killed (deleted) text entries. Consecutive kills can accumulate
+ * into a single entry. Supports yank (paste most recent) and yank-pop
+ * (cycle through older entries).
+ */
+export class KillRing {
+    ring = [];
+    /**
+     * Add text to the kill ring.
+     *
+     * @param text - The killed text to add
+     * @param opts - Push options
+     * @param opts.prepend - If accumulating, prepend (backward deletion) or append (forward deletion)
+     * @param opts.accumulate - Merge with the most recent entry instead of creating a new one
+     */
+    push(text, opts) {
+        if (!text)
+            return;
+        if (opts.accumulate && this.ring.length > 0) {
+            const last = this.ring.pop();
+            this.ring.push(opts.prepend ? text + last : last + text);
+        }
+        else {
+            this.ring.push(text);
+        }
+    }
+    /** Get most recent entry without modifying the ring. */
+    peek() {
+        return this.ring.length > 0 ? this.ring[this.ring.length - 1] : undefined;
+    }
+    /** Move last entry to front (for yank-pop cycling). */
+    rotate() {
+        if (this.ring.length > 1) {
+            const last = this.ring.pop();
+            this.ring.unshift(last);
+        }
+    }
+    get length() {
+        return this.ring.length;
+    }
+}

package/dist/integrations/pi/components/upstream/history/printable-key.d.ts

@@ -0,0 +1 @@
+export declare function decodePrintableKey(data: string): string | undefined;

package/dist/integrations/pi/components/upstream/history/printable-key.js

@@ -0,0 +1,40 @@
+/**
+ * Adapted from @earendil-works/pi-tui 0.84.2, packages/tui/src/keys.ts (MIT).
+ * Source commit: 914cf1472e715297caa30db4b9535d534a9eb718.
+ * Modifications: public imports and owned editor-local typed seams; see docs/architecture/history-editor-provenance.md.
+ */
+import { decodeKittyPrintable } from "#pi-tui";
+const MODIFIERS = {
+    shift: 1,
+    alt: 2,
+    ctrl: 4,
+    super: 8,
+};
+const LOCK_MASK = 64 + 128;
+function parseModifyOtherKeysSequence(data) {
+    const match = data.match(/^\x1b\[27;(\d+);(\d+)~$/);
+    if (!match)
+        return null;
+    const modValue = parseInt(match[1], 10);
+    const codepoint = parseInt(match[2], 10);
+    return { codepoint, modifier: modValue - 1 };
+}
+function decodeModifyOtherKeysPrintable(data) {
+    const parsed = parseModifyOtherKeysSequence(data);
+    if (!parsed)
+        return undefined;
+    const modifier = parsed.modifier & ~LOCK_MASK;
+    if ((modifier & ~MODIFIERS.shift) !== 0)
+        return undefined;
+    if (!Number.isFinite(parsed.codepoint) || parsed.codepoint < 32)
+        return undefined;
+    try {
+        return String.fromCodePoint(parsed.codepoint);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function decodePrintableKey(data) {
+    return decodeKittyPrintable(data) ?? decodeModifyOtherKeysPrintable(data);
+}

package/dist/integrations/pi/components/upstream/history/text-helpers.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Get the shared grapheme segmenter instance.
+ */
+export declare function getGraphemeSegmenter(): Intl.Segmenter;
+/**
+ * Get the shared word segmenter instance.
+ */
+export declare function getWordSegmenter(): Intl.Segmenter;
+export declare const cjkBreakRegex: RegExp;
+export declare const PUNCTUATION_REGEX: RegExp;
+/**
+ * Check if a character is whitespace.
+ */
+export declare function isWhitespaceChar(char: string): boolean;

package/dist/integrations/pi/components/upstream/history/text-helpers.js

@@ -0,0 +1,28 @@
+/**
+ * Adapted from @earendil-works/pi-tui 0.84.2, packages/tui/src/utils.ts (MIT).
+ * Source commit: 914cf1472e715297caa30db4b9535d534a9eb718.
+ * Modifications: public imports and owned editor-local typed seams; see docs/architecture/history-editor-provenance.md.
+ */
+// segmenters (shared instance)
+const graphemeSegmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });
+const wordSegmenter = new Intl.Segmenter(undefined, { granularity: "word" });
+/**
+ * Get the shared grapheme segmenter instance.
+ */
+export function getGraphemeSegmenter() {
+    return graphemeSegmenter;
+}
+/**
+ * Get the shared word segmenter instance.
+ */
+export function getWordSegmenter() {
+    return wordSegmenter;
+}
+export const cjkBreakRegex = /[\p{Script_Extensions=Han}\p{Script_Extensions=Hiragana}\p{Script_Extensions=Katakana}\p{Script_Extensions=Hangul}\p{Script_Extensions=Bopomofo}]/u;
+export const PUNCTUATION_REGEX = /[(){}[\]<>.,;:'"!?+\-=*/\\|&%^$#@~`]/;
+/**
+ * Check if a character is whitespace.
+ */
+export function isWhitespaceChar(char) {
+    return /\s/.test(char);
+}

package/dist/integrations/pi/components/upstream/history/undo-stack.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Adapted from @earendil-works/pi-tui 0.84.2, packages/tui/src/undo-stack.ts (MIT).
+ * Source commit: 914cf1472e715297caa30db4b9535d534a9eb718.
+ * Modifications: public imports and owned editor-local typed seams; see docs/architecture/history-editor-provenance.md.
+ */
+/**
+ * Generic undo stack with clone-on-push semantics.
+ *
+ * Stores deep clones of state snapshots. Popped snapshots are returned
+ * directly (no re-cloning) since they are already detached.
+ */
+export declare class UndoStack<S> {
+    private stack;
+    /** Push a deep clone of the given state onto the stack. */
+    push(state: S): void;
+    /** Pop and return the most recent snapshot, or undefined if empty. */
+    pop(): S | undefined;
+    /** Remove all snapshots. */
+    clear(): void;
+    updateSnapshots(update: (snapshot: S) => void): void;
+    get length(): number;
+}

package/dist/integrations/pi/components/upstream/history/undo-stack.js

@@ -0,0 +1,36 @@
+/**
+ * Adapted from @earendil-works/pi-tui 0.84.2, packages/tui/src/undo-stack.ts (MIT).
+ * Source commit: 914cf1472e715297caa30db4b9535d534a9eb718.
+ * Modifications: public imports and owned editor-local typed seams; see docs/architecture/history-editor-provenance.md.
+ */
+/**
+ * Generic undo stack with clone-on-push semantics.
+ *
+ * Stores deep clones of state snapshots. Popped snapshots are returned
+ * directly (no re-cloning) since they are already detached.
+ */
+export class UndoStack {
+    stack = [];
+    /** Push a deep clone of the given state onto the stack. */
+    push(state) {
+        this.stack.push(structuredClone(state));
+    }
+    /** Pop and return the most recent snapshot, or undefined if empty. */
+    pop() {
+        return this.stack.pop();
+    }
+    /** Remove all snapshots. */
+    clear() {
+        this.stack.length = 0;
+    }
+    updateSnapshots(update) {
+        this.stack = this.stack.map(snapshot => {
+            const copy = structuredClone(snapshot);
+            update(copy);
+            return copy;
+        });
+    }
+    get length() {
+        return this.stack.length;
+    }
+}

package/dist/integrations/pi/components/upstream/history/word-navigation.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Options for word navigation functions.
+ * When omitted, uses the default Intl.Segmenter word segmentation.
+ */
+export interface WordNavigationOptions {
+    /** Custom segmenter returning word segments for the given text. */
+    segment?: (text: string) => Iterable<Intl.SegmentData>;
+    /** Predicate identifying atomic segments that should be treated as single units (e.g. paste markers). */
+    isAtomicSegment?: (segment: string) => boolean;
+}
+/**
+ * Find the cursor position after moving one word backward from `cursor` in `text`.
+ * Skips trailing whitespace, then stops at the next word/punctuation boundary.
+ *
+ * Pure function - does not mutate any state.
+ */
+export declare function findWordBackward(text: string, cursor: number, options?: WordNavigationOptions): number;
+/**
+ * Find the cursor position after moving one word forward from `cursor` in `text`.
+ * Skips leading whitespace, then stops at the next word/punctuation boundary.
+ *
+ * Pure function - does not mutate any state.
+ */
+export declare function findWordForward(text: string, cursor: number, options?: WordNavigationOptions): number;

package/dist/integrations/pi/components/upstream/history/word-navigation.js

@@ -0,0 +1,100 @@
+/**
+ * Adapted from @earendil-works/pi-tui 0.84.2, packages/tui/src/word-navigation.ts (MIT).
+ * Source commit: 914cf1472e715297caa30db4b9535d534a9eb718.
+ * Modifications: public imports and owned editor-local typed seams; see docs/architecture/history-editor-provenance.md.
+ */
+import { getWordSegmenter, isWhitespaceChar, PUNCTUATION_REGEX } from "./text-helpers.js";
+const wordSegmenter = getWordSegmenter();
+/**
+ * Find the cursor position after moving one word backward from `cursor` in `text`.
+ * Skips trailing whitespace, then stops at the next word/punctuation boundary.
+ *
+ * Pure function - does not mutate any state.
+ */
+export function findWordBackward(text, cursor, options) {
+    if (cursor <= 0)
+        return 0;
+    const textBeforeCursor = text.slice(0, cursor);
+    const segmentFn = options?.segment;
+    const isAtomic = options?.isAtomicSegment;
+    const segments = segmentFn ? [...segmentFn(textBeforeCursor)] : [...wordSegmenter.segment(textBeforeCursor)];
+    let newCursor = cursor;
+    // Skip trailing whitespace
+    while (segments.length > 0 &&
+        !isAtomic?.(segments[segments.length - 1]?.segment || "") &&
+        isWhitespaceChar(segments[segments.length - 1]?.segment || "")) {
+        newCursor -= segments.pop()?.segment.length || 0;
+    }
+    if (segments.length === 0)
+        return newCursor;
+    const last = segments[segments.length - 1];
+    if (isAtomic?.(last.segment)) {
+        // Skip one atomic segment.
+        newCursor -= last.segment.length;
+    }
+    else if (last.isWordLike) {
+        // Skip inside one word-like segment, preserving ASCII punctuation boundaries.
+        const segment = last.segment;
+        const matches = [...segment.matchAll(new RegExp(PUNCTUATION_REGEX, "g"))];
+        if (matches.length <= 0) {
+            newCursor -= segment.length;
+        }
+        else {
+            const lastMatch = matches[matches.length - 1];
+            newCursor -= segment.length - (lastMatch.index + lastMatch[0].length);
+        }
+    }
+    else {
+        // Skip non-word non-whitespace run (punctuation)
+        while (segments.length > 0 &&
+            !isAtomic?.(segments[segments.length - 1]?.segment || "") &&
+            !segments[segments.length - 1]?.isWordLike &&
+            !isWhitespaceChar(segments[segments.length - 1]?.segment || "")) {
+            newCursor -= segments.pop()?.segment.length || 0;
+        }
+    }
+    return newCursor;
+}
+/**
+ * Find the cursor position after moving one word forward from `cursor` in `text`.
+ * Skips leading whitespace, then stops at the next word/punctuation boundary.
+ *
+ * Pure function - does not mutate any state.
+ */
+export function findWordForward(text, cursor, options) {
+    if (cursor >= text.length)
+        return text.length;
+    const textAfterCursor = text.slice(cursor);
+    const segmentFn = options?.segment;
+    const isAtomic = options?.isAtomicSegment;
+    const segments = segmentFn ? segmentFn(textAfterCursor) : wordSegmenter.segment(textAfterCursor);
+    const iterator = segments[Symbol.iterator]();
+    let next = iterator.next();
+    let newCursor = cursor;
+    // Skip leading whitespace
+    while (!next.done && !isAtomic?.(next.value.segment) && isWhitespaceChar(next.value.segment)) {
+        newCursor += next.value.segment.length;
+        next = iterator.next();
+    }
+    if (next.done)
+        return newCursor;
+    if (isAtomic?.(next.value.segment)) {
+        // Skip one atomic segment.
+        newCursor += next.value.segment.length;
+    }
+    else if (next.value.isWordLike) {
+        // Skip inside one word-like segment, preserving ASCII punctuation boundaries.
+        newCursor += PUNCTUATION_REGEX.exec(next.value.segment)?.index ?? next.value.segment.length;
+    }
+    else {
+        // Skip non-word non-whitespace run (punctuation)
+        while (!next.done &&
+            !isAtomic?.(next.value.segment) &&
+            !next.value.isWordLike &&
+            !isWhitespaceChar(next.value.segment)) {
+            newCursor += next.value.segment.length;
+            next = iterator.next();
+        }
+    }
+    return newCursor;
+}

package/dist/{src/foundation/pi-engine-adapter → integrations/pi/engine}/adapter.d.ts

@@ -1,11 +1,23 @@
-import { type AgentSessionRuntime, type AgentSessionServices, type SessionInfo } from "@earendil-works/pi-coding-agent";
-import { OWNED_UI_EXTENSION_CONTRACT_VERSION, OWNED_UI_EXTENSION_RENDER_CALLBACKS, OWNED_UI_EXTENSION_UI_CALLBACKS, OWNED_UI_EXTENSION_UI_PROPERTIES, type OwnedUiCommand, type OwnedUiCommandOutcome, type OwnedUiEvent, type OwnedUiSessionViewModel, type OwnedUiSnapshot } from "../owned-ui-contracts/index.js";
+import type { PiSessionForkPrompt, PiSessionSelection } from "./session-selection.js";
+import { type AgentSession, type AgentSessionRuntime, type AgentSessionServices, type SessionInfo } from "@earendil-works/pi-coding-agent";
+import { OWNED_UI_EXTENSION_CONTRACT_VERSION, OWNED_UI_EXTENSION_RENDER_CALLBACKS, OWNED_UI_EXTENSION_UI_CALLBACKS, OWNED_UI_EXTENSION_UI_PROPERTIES, type OwnedUiCommand, type OwnedUiCommandOutcome, type OwnedUiImageAttachment, type OwnedUiPromptSuggestionGeneratorPort, type OwnedUiPromptSuggestionReasoning, type OwnedUiPromptSuggestionRequest, type OwnedUiPromptSuggestionResult, type OwnedUiEvent, type OwnedUiSessionViewModel, type OwnedUiSnapshot } from "../../../contracts/owned-ui/index.js";
 import { type PiAuthenticationProviderOption, type PiBashWorkflowResult, type PiPinnedSettingsCallback, type PiPinnedSettingsSnapshot, type PiWorkflowAutocompleteCommand, type PiWorkflowHost, type PiWorkflowInteractionHost, type PiWorkflowOption, type PiWorkflowRequest, type PiWorkflowResult } from "./workflows.js";
-import type { AgentSettingsPort } from "../agent-engine-contracts/index.js";
+import { PiSettingsIntegration } from "./settings-integration.js";
+import type { PiSettingOwnerHandlers } from "./settings-effects.js";
+import type { PiProjectTrustPreflightPrompt } from "./project-trust-preflight.js";
+import type { AgentSettingOwner } from "../../../contracts/agent-engine/index.js";
+/** Explicit flush failure when required delivery was interrupted rather than completed. */
+export declare class EngineDeliveryError extends Error {
+    constructor();
+}
 export interface PiEngineRuntimeFactoryInput {
     readonly cwd: string;
     readonly agentDir: string;
     readonly sessionId: string;
+    readonly sessionPath?: string;
+    readonly sessionSelection?: PiSessionSelection;
+    readonly sessionForkPrompt?: PiSessionForkPrompt;
+    readonly projectTrustPrompt?: PiProjectTrustPreflightPrompt;
 }
 export interface PiScopedModelDescriptor {
     readonly provider: string;
@@ -41,6 +53,11 @@ export interface PiTreeSelectorContext {
     readonly skipSummaryPrompt: boolean;
     readonly appendLabelChange: (entryId: string, label: string | undefined) => void;
 }
+export interface PiSessionResumeMetadata {
+    readonly sessionId: string;
+    readonly sessionDir: string;
+    readonly usesDefaultSessionDir: boolean;
+}
 export interface PiSessionSelectorContext {
     readonly currentSessionFilePath: string | undefined;
     readonly loadCurrentSessions: (onProgress?: (loaded: number, total: number) => void) => Promise<SessionInfo[]>;
@@ -60,11 +77,18 @@ export interface OwnedPiResourceSummary {
     readonly sourcePath: string | null;
     readonly diagnostic: string | null;
 }
+export interface OwnedPiExtensionSourceSummary {
+    readonly source: string;
+    readonly scope: "user" | "project" | "temporary";
+    readonly origin: "package" | "top-level";
+    readonly baseDir: string | null;
+}
 export interface OwnedPiExtensionResourceSummary {
     readonly kind: "extension";
     readonly id: string;
     readonly sourcePath: string | null;
     readonly resolvedPath: string | null;
+    readonly sourceInfo: OwnedPiExtensionSourceSummary | null;
     readonly loaded: boolean;
     readonly hidden: boolean;
     readonly diagnostic: string | null;
@@ -83,6 +107,9 @@ export interface PiEngineAdapterOptions {
     readonly cwd?: string;
     readonly agentDir?: string;
     readonly sessionId?: string;
+    readonly sessionPath?: string;
+    readonly sessionSelection?: PiSessionSelection;
+    readonly sessionForkPrompt?: PiSessionForkPrompt;
     readonly createRuntime?: PiEngineRuntimeFactory;
     readonly workflowHost?: PiWorkflowHost;
     /**
@@ -91,6 +118,8 @@ export interface PiEngineAdapterOptions {
      * offering stay here.
      */
     readonly availableThemes?: () => readonly string[];
+    readonly settingsProductMode?: "bare" | "comparison";
+    readonly projectTrustPrompt?: PiProjectTrustPreflightPrompt;
     /**
      * Startup extension-package update probe, mirroring pinned Pi's interactive
      * mode. Returns display names of packages with updates available.
@@ -101,16 +130,39 @@ export interface AdapterCommandResult {
     readonly outcome: OwnedUiCommandOutcome;
     readonly diagnostic: string | null;
 }
-export declare class PiEngineAdapter {
+/** Owns the pinned Pi session lifecycle and translates its events into the neutral agent-engine contract. */
+export declare class PiEngineAdapter implements OwnedUiPromptSuggestionGeneratorPort {
     #private;
     constructor(options?: PiEngineAdapterOptions);
     setWorkflowInteractionHost(interaction: PiWorkflowInteractionHost): void;
     get sessionId(): string;
     get sessionGeneration(): number;
+    /** Actual session replacements, excluding delivery-only invalidation of callbacks. */
+    get sessionBindingGeneration(): number;
+    get cwd(): string;
     get agentDir(): string;
+    resolveTranscriptImage(assetId: string): OwnedUiImageAttachment | null;
+    currentSessionFile(): string | null;
+    currentSessionResumeMetadata(): PiSessionResumeMetadata | null;
     get disposed(): boolean;
+    suggestionReasoningPolicy(): OwnedUiPromptSuggestionReasoning;
+    generate(request: OwnedUiPromptSuggestionRequest): Promise<OwnedUiPromptSuggestionResult>;
     start(): Promise<OwnedUiSessionViewModel>;
     onEvent(listener: (event: OwnedUiEvent) => void): () => void;
+    /** Developer-only pressure evidence; never mirrored into visible diagnostic/status arrays. */
+    deliveryDiagnostics(): {
+        overloads: number;
+        recovering: boolean;
+        pendingCommands: number;
+        reservedOutcomes: number;
+        invalidatedEvents: number;
+        pending: number;
+        bytes: number;
+        protected: number;
+        superseded: number;
+        peakNodes: number;
+        peakBytes: number;
+    };
     flushEvents(): Promise<void>;
     nonVisualResources(): readonly OwnedPiResourceSummary[];
     extensionResources(): readonly OwnedPiExtensionResourceSummary[];
@@ -125,7 +177,8 @@ export declare class PiEngineAdapter {
      */
     configuredTheme(): string | undefined;
     /** Settings port for the live runtime, or null before the runtime is available. */
-    settingsPort(): AgentSettingsPort | null;
+    settingsPort(): PiSettingsIntegration | null;
+    bindSettingsOwner(owner: AgentSettingOwner, handlers: PiSettingOwnerHandlers): () => void;
     pinnedModelSelectorContext(): {
         readonly currentModel: unknown;
         readonly settingsManager: unknown;
@@ -144,16 +197,31 @@ export declare class PiEngineAdapter {
         readonly title: string;
         readonly options: readonly PiWorkflowOption[];
     };
+    pinnedAmbientAuthentication(selection: string): {
+        readonly providerId: string;
+        readonly providerName: string;
+        readonly title: string;
+        readonly message: string;
+    } | null;
     pinnedLogoutOptions(): Promise<readonly PiAuthenticationProviderOption[]>;
     pinnedForkOptions(): readonly PiWorkflowOption[];
     pinnedTreeSelectorContext(): PiTreeSelectorContext;
     pinnedSettingsSnapshot(): PiPinnedSettingsSnapshot;
     pinnedMessageRenderer(customType: string): unknown;
+    pinnedShortcutDescriptions(bindings: Parameters<AgentSession["extensionRunner"]["getShortcuts"]>[0]): readonly {
+        readonly key: string;
+        readonly description: string;
+    }[];
     pinnedToolDefinition(toolName: string): unknown;
+    /** Bind the owned UI's clipboard lifecycle without changing the comparison host. True means acknowledged delivery. */
+    bindClipboardWriter(writer: (text: string) => Promise<boolean>): () => void;
+    /** Workflow and tree copying share the active owner's write fence and delivery acknowledgment. */
+    copyWorkflowText(text: string): Promise<boolean>;
     clearQueuedWorkflows(): readonly string[];
     abortBashWorkflow(): void;
     executeBashWorkflow(command: string, excludeFromContext: boolean): Promise<PiBashWorkflowResult>;
-    applyPinnedSettingValue(callback: PiPinnedSettingsCallback, value: unknown): PiWorkflowResult;
+    applyPinnedSettingValue(callback: PiPinnedSettingsCallback, value: unknown): Promise<PiWorkflowResult>;
+    reloadBlockedResult(): PiWorkflowResult | null;
     executeWorkflow(request: PiWorkflowRequest): Promise<PiWorkflowResult>;
     view(): OwnedUiSessionViewModel;
     snapshot(): OwnedUiSnapshot;