@timurproko/a1 0.1.8-dev.182 → 0.1.8-dev.218

package/dist/integrations/pi/engine/model-auth-integration.js

@@ -1,3 +1,4 @@
+/** Adapts the pinned model runtime to neutral model selection and authentication operations. */
 export class PiModelAuthenticationIntegration {
     options;
     capabilities = { selection: true, refresh: true, scopedCatalog: true, login: true, logout: true };

package/dist/integrations/pi/engine/package-integration.js

@@ -52,7 +52,7 @@ export function createPiPackagesPort(input) {
         },
         async update(source) {
             return await attempt("update", source ?? null, async () => {
-                // Asking first keeps "that package is not installed here" a structural
+                // Rationale: asking first keeps "that package is not installed here" a structural
                 // answer rather than a string a caller would have to recognize.
                 if (source !== undefined && !isConfigured(source))
                     return agentPackageOutcome("update", "not-found", null, source);

package/dist/integrations/pi/engine/project-trust-preflight.js

@@ -13,7 +13,7 @@ export async function resolvePiProjectTrustPreflight(options) {
     const saved = trustStore.get(options.cwd);
     if (saved !== null)
         return { trusted: saved, source: "saved", diagnostic: null };
-    // projectTrusted:false is the security boundary: this read may see global
+    // Security: projectTrusted:false is the boundary: this read may see global
     // settings but cannot consume project settings or construct project resources.
     const globalSettings = SettingsManager.create(options.cwd, options.agentDir, { projectTrusted: false });
     const fallback = globalSettings.getDefaultProjectTrust();

package/dist/integrations/pi/engine/resource-extension-integration.d.ts

@@ -5,6 +5,7 @@ export interface PiResourceExtensionOptions {
     readonly bindUi: () => Promise<void>;
     readonly unbindUi: () => Promise<void>;
 }
+/** Adapts Pi resource discovery and extension binding while containing extension failures at the port. */
 export declare class PiResourceExtensionIntegration implements AgentResourcesPort, AgentExtensionPort {
     #private;
     private readonly options;

package/dist/integrations/pi/engine/resource-extension-integration.js

@@ -1,3 +1,4 @@
+/** Adapts Pi resource discovery and extension binding while containing extension failures at the port. */
 export class PiResourceExtensionIntegration {
     options;
     capabilities = { reload: true, extensionBinding: true, binding: true, renderers: true };

package/dist/integrations/pi/engine/session-integration.d.ts

@@ -31,6 +31,7 @@ export interface PiSessionCommandResult {
     readonly outcome: AgentCommandOutcome;
     readonly value?: unknown;
 }
+/** Routes neutral session commands to Pi while preserving Pi streaming and retry semantics. */
 export declare class PiSessionCommandIntegration {
     #private;
     private readonly session;

package/dist/integrations/pi/engine/session-integration.js

@@ -1,4 +1,5 @@
 import { AGENT_ENGINE_CONTRACT_VERSION, } from "../../../contracts/agent-engine/index.js";
+/** Routes neutral session commands to Pi while preserving Pi streaming and retry semantics. */
 export class PiSessionCommandIntegration {
     session;
     #lastPrompt = null;
@@ -18,7 +19,7 @@ export class PiSessionCommandIntegration {
                 return { outcome: "completed" };
             case "steer":
                 this.#lastPrompt = command.text;
-                // Match interactive Pi: prompt() owns template/extension expansion and
+                // Compatibility: match interactive Pi: prompt() owns template/extension expansion and
                 // turns the accepted steering message into the visible user row while
                 // later messages remain in the pending queue.
                 await this.session.prompt(command.text, {

package/dist/integrations/pi/engine/settings-effects.d.ts

@@ -1,10 +1,20 @@
 import type { AgentJsonValue, AgentSettingApplicationBoundary, AgentSettingChangeOutcome, AgentSettingOwner } from "../../../contracts/agent-engine/index.js";
 export type PiSettingKey = "autoCompact" | "showImages" | "imageWidthCells" | "autoResizeImages" | "blockImages" | "enableSkillCommands" | "steeringMode" | "followUpMode" | "transport" | "httpIdleTimeoutMs" | "thinkingLevel" | "theme" | "hideThinkingBlock" | "mermaidRenderingMode" | "showCacheMissNotices" | "collapseChangelog" | "enableInstallTelemetry" | "quietStartup" | "defaultProjectTrust" | "doubleEscapeAction" | "treeFilterMode" | "showHardwareCursor" | "editorPaddingX" | "outputPad" | "autocompleteMaxVisible" | "clearOnShrink" | "showTerminalProgress" | "tuiMode" | "fullscreenExitOutput" | "fullscreenScrollbar" | "warnings";
+export type PiSettingVisualClass = "none" | "transcript" | "transcript-geometry" | "editor-menu" | "queue-transcript" | "status-error" | "retry-error" | "footer-transcript" | "markdown" | "transcript-notice" | "startup-transcript" | "startup-selector" | "selector" | "terminal-cursor" | "editor-geometry" | "menu-geometry" | "terminal-frame" | "terminal-status" | "restored-parent-output" | "hidden";
+export interface PiSettingVisualEvidence {
+    /** Reviewed visual family; `none` still names the behavior that can emit styled diagnostics. */
+    readonly class: PiSettingVisualClass;
+    /** Pinned component, lifecycle, or provider-visible failure surface used as the visual authority. */
+    readonly pinnedSurface: string;
+    /** Independent pinned/A1 test or physical checkpoint that owns acceptance. */
+    readonly evidence: string;
+}
 export interface PiSettingEffectDefinition {
     readonly application: AgentSettingApplicationBoundary;
     readonly owner: AgentSettingOwner;
-    /** Bare A1 deliberately replaces this Pi behavior and therefore cannot apply it. */
-    readonly bareLimitation?: string;
+    readonly visual: PiSettingVisualEvidence;
+    /** Bare A1 deliberately replaces this Pi behavior, so its settings UI omits the entry. */
+    readonly hiddenInBare?: true;
 }
 /**
  * Reviewed effect authority for every generated Pi setting. Presentation remains
@@ -53,3 +63,4 @@ export declare function settingsEffectInventoryDrift(presented: readonly string[
     readonly stale: readonly string[];
     readonly duplicated: readonly string[];
 };
+export declare function settingsVisualInventoryViolations(presented: readonly string[], reviewed?: Readonly<Partial<Record<PiSettingKey, PiSettingEffectDefinition>>>): readonly string[];

package/dist/integrations/pi/engine/settings-effects.js

@@ -1,47 +1,46 @@
-const PRODUCT_FIXED = {
-    theme: "Bare A1 uses its product-fixed dark owned theme",
-    quietStartup: "Bare A1 owns startup composition and does not expose Pi startup suppression",
-    tuiMode: "Bare A1 uses its product-fixed custom fullscreen viewport",
-    fullscreenScrollbar: "Bare A1 replaces Pi's scrollbar with declared A1 viewport settings",
-    enableInstallTelemetry: "Bare A1 does not run Pi's install/update telemetry lifecycle",
-};
 /**
  * Reviewed effect authority for every generated Pi setting. Presentation remains
  * generated; this table states who must make each accepted value observable.
  */
 export const PI_SETTING_EFFECTS = Object.freeze({
-    autoCompact: { application: "live", owner: "agent" },
-    showImages: { application: "live", owner: "shell" },
-    imageWidthCells: { application: "live", owner: "shell" },
-    autoResizeImages: { application: "live", owner: "agent" },
-    blockImages: { application: "live", owner: "agent" },
-    enableSkillCommands: { application: "live", owner: "shell" },
-    steeringMode: { application: "live", owner: "agent" },
-    followUpMode: { application: "live", owner: "agent" },
-    transport: { application: "live", owner: "agent" },
-    httpIdleTimeoutMs: { application: "live", owner: "agent" },
-    thinkingLevel: { application: "live", owner: "agent" },
-    theme: { application: "live", owner: "shell", bareLimitation: PRODUCT_FIXED.theme },
-    hideThinkingBlock: { application: "live", owner: "shell" },
-    mermaidRenderingMode: { application: "live", owner: "shell" },
-    showCacheMissNotices: { application: "live", owner: "shell" },
-    collapseChangelog: { application: "next-start", owner: "startup" },
-    enableInstallTelemetry: { application: "next-start", owner: "installation", bareLimitation: PRODUCT_FIXED.enableInstallTelemetry },
-    quietStartup: { application: "next-start", owner: "startup", bareLimitation: PRODUCT_FIXED.quietStartup },
-    defaultProjectTrust: { application: "next-start", owner: "startup" },
-    doubleEscapeAction: { application: "live", owner: "shell" },
-    treeFilterMode: { application: "live", owner: "shell" },
-    showHardwareCursor: { application: "live", owner: "terminal" },
-    editorPaddingX: { application: "live", owner: "shell" },
-    outputPad: { application: "live", owner: "shell" },
-    autocompleteMaxVisible: { application: "live", owner: "shell" },
-    clearOnShrink: { application: "live", owner: "terminal" },
-    showTerminalProgress: { application: "live", owner: "terminal" },
-    tuiMode: { application: "next-session", owner: "shell", bareLimitation: PRODUCT_FIXED.tuiMode },
-    fullscreenExitOutput: { application: "current-exit", owner: "shutdown" },
-    fullscreenScrollbar: { application: "live", owner: "shell", bareLimitation: PRODUCT_FIXED.fullscreenScrollbar },
-    warnings: { application: "live", owner: "agent" },
+    autoCompact: effect("live", "agent", "transcript", "compaction status, summary, completion, and failure rows", "pinned-transcript-lifecycle-parity"),
+    showImages: effect("live", "shell", "transcript", "pinned inline image and textual fallback components", "pinned-transcript-image-parity"),
+    imageWidthCells: effect("live", "shell", "transcript-geometry", "pinned image component width and clipping", "pinned-transcript-image-parity"),
+    autoResizeImages: effect("live", "agent", "none", "provider image preparation and pinned warning row", "settings-effects-provider-parity"),
+    blockImages: effect("live", "agent", "none", "provider context conversion and pinned blocked-image notice", "settings-effects-provider-parity"),
+    enableSkillCommands: effect("live", "shell", "editor-menu", "pinned command autocomplete list", "pinned-editor-input-parity"),
+    steeringMode: effect("live", "agent", "queue-transcript", "pinned steering queue and submitted prompt rows", "pinned-status-indicator-parity"),
+    followUpMode: effect("live", "agent", "queue-transcript", "pinned follow-up queue and submitted prompt rows", "pinned-status-indicator-parity"),
+    transport: effect("live", "agent", "status-error", "pinned provider request status and failure rows", "settings-effects-provider-parity"),
+    httpIdleTimeoutMs: effect("live", "agent", "retry-error", "pinned timeout, retry, and terminal failure rows", "pinned-transcript-lifecycle-parity"),
+    thinkingLevel: effect("live", "agent", "footer-transcript", "pinned footer indicator, thinking rows, and clamp notice", "pinned-status-indicator-parity"),
+    theme: hiddenEffect("live", "shell", "pinned theme selector and complete themed shell", "pinned-theme-parity"),
+    hideThinkingBlock: effect("live", "shell", "transcript", "pinned thinking block presence and spacing", "pinned-transcript-lifecycle-parity"),
+    mermaidRenderingMode: effect("live", "shell", "markdown", "pinned Mermaid Markdown transformation", "pinned-assistant-content-parity"),
+    showCacheMissNotices: effect("live", "shell", "transcript-notice", "pinned cache-miss transcript notice", "pinned-transcript-lifecycle-parity"),
+    collapseChangelog: effect("next-start", "startup", "startup-transcript", "pinned startup and command changelog components", "pi-startup-composition-parity"),
+    enableInstallTelemetry: effect("next-start", "installation", "none", "install lifecycle and its pinned failure diagnostic", "settings-effects-installation-parity"),
+    quietStartup: hiddenEffect("next-start", "startup", "pinned startup suppression lifecycle", "pi-startup-composition-parity"),
+    defaultProjectTrust: effect("next-start", "startup", "startup-selector", "pinned pre-resource project trust selector", "project-trust-startup-parity"),
+    doubleEscapeAction: effect("live", "shell", "selector", "pinned tree or fork selector", "pinned-selector-parity"),
+    treeFilterMode: effect("live", "shell", "selector", "pinned tree selector filter, rows, and hints", "pinned-selector-parity"),
+    showHardwareCursor: effect("live", "terminal", "terminal-cursor", "pinned editor, overlay, blur, failure, and exit cursor operations", "pi-terminal-operation-parity"),
+    editorPaddingX: effect("live", "shell", "editor-geometry", "pinned editor border, padding, wrapping, and cursor column", "pinned-editor-input-parity"),
+    outputPad: effect("live", "shell", "transcript-geometry", "pinned transcript, tool, status, and error horizontal padding", "pinned-transcript-lifecycle-parity"),
+    autocompleteMaxVisible: effect("live", "shell", "menu-geometry", "pinned autocomplete clipping and editor anchoring", "pinned-editor-input-parity"),
+    clearOnShrink: effect("live", "terminal", "terminal-frame", "pinned resize clearing and resulting terminal frame", "pi-terminal-operation-parity"),
+    showTerminalProgress: effect("live", "terminal", "terminal-status", "pinned OSC progress lifecycle", "pi-terminal-operation-parity"),
+    tuiMode: hiddenEffect("next-session", "shell", "pinned regular/fullscreen selector and terminal lifecycle", "pi-terminal-operation-parity"),
+    fullscreenExitOutput: effect("current-exit", "shutdown", "restored-parent-output", "pinned styled transcript and compact dim resume hint", "pinned-fullscreen-exit-parity"),
+    fullscreenScrollbar: hiddenEffect("live", "shell", "pinned fullscreen scrollbar reservation", "pi-terminal-operation-parity"),
+    warnings: effect("live", "agent", "transcript-notice", "pinned warning rows by warning part", "pinned-transcript-lifecycle-parity"),
 });
+function effect(application, owner, visualClass, pinnedSurface, evidence) {
+    return { application, owner, visual: { class: visualClass, pinnedSurface, evidence } };
+}
+function hiddenEffect(application, owner, pinnedSurface, evidence) {
+    return { application, owner, hiddenInBare: true, visual: { class: "hidden", pinnedSurface, evidence } };
+}
 /**
  * One transactional authority for Pi setting validation, active effects,
  * persistence, durability, rollback, and owner lifecycle.
@@ -74,8 +73,8 @@ export class PiSettingsCoordinator {
                 throw new Error(`unknown Pi setting effect: ${key}`);
             if (definition.owner !== owner)
                 throw new Error(`${key} belongs to ${definition.owner}, not ${owner}`);
-            if (this.#productMode === "bare" && definition.bareLimitation !== undefined) {
-                throw new Error(`${key} is product-fixed in bare A1`);
+            if (this.#productMode === "bare" && definition.hiddenInBare === true) {
+                throw new Error(`${key} is hidden in bare A1`);
             }
             this.#handlers.set(key, handler);
             bound.push(key);
@@ -103,8 +102,8 @@ export class PiSettingsCoordinator {
     }
     limitationReason(key) {
         const definition = PI_SETTING_EFFECTS[key];
-        if (this.#productMode === "bare" && definition.bareLimitation !== undefined)
-            return definition.bareLimitation;
+        if (this.#productMode === "bare" && definition.hiddenInBare === true)
+            return "setting is not available in the active product mode";
         const inconsistent = this.#requireState(key).inconsistentReason;
         if (inconsistent !== null)
             return inconsistent;
@@ -221,6 +220,27 @@ export function settingsEffectInventoryDrift(presented, reviewed = Object.keys(P
         duplicated: [...counts].filter(([, count]) => count > 1).map(([key]) => key),
     };
 }
+export function settingsVisualInventoryViolations(presented, reviewed = PI_SETTING_EFFECTS) {
+    const violations = [];
+    for (const candidate of presented) {
+        const key = candidate;
+        const definition = reviewed[key];
+        if (definition === undefined) {
+            violations.push(`${candidate}: missing visual classification`);
+            continue;
+        }
+        const visual = definition.visual;
+        if (!visual || visual.pinnedSurface.trim().length === 0)
+            violations.push(`${candidate}: missing pinned visual source`);
+        if (!visual || visual.evidence.trim().length === 0)
+            violations.push(`${candidate}: missing independent visual evidence`);
+        if (definition.hiddenInBare === true && visual?.class !== "hidden")
+            violations.push(`${candidate}: hidden setting declares a visible frame`);
+        if (definition.hiddenInBare !== true && visual?.class === "hidden")
+            violations.push(`${candidate}: visible setting declares hidden evidence`);
+    }
+    return violations;
+}
 function outcome(status, application, storedValue, effectiveValue, failure, limitationReason) {
     return { status, application, storedValue, effectiveValue, failure, limitationReason };
 }

package/dist/integrations/pi/engine/settings-integration.js

@@ -75,19 +75,19 @@ export class PiSettingsIntegration {
             return at < 0 ? PRESENTATION.order.length : at;
         };
         return [...this.#operations.values()]
+            .filter(operation => this.#coordinator.available(operation.key))
             .map(operation => {
             const key = operation.key;
             const wording = PRESENTATION.settings[key];
             const flags = PRESENTATION.dialogs[key];
             const bounds = PRESENTATION.bounds[key];
-            const limitationReason = this.#coordinator.limitationReason(key);
             const descriptor = {
                 ...operation.descriptor,
                 application: PI_SETTING_EFFECTS[key].application,
                 owner: PI_SETTING_EFFECTS[key].owner,
-                available: limitationReason === null,
-                limitationReason,
-                writable: limitationReason === null,
+                available: true,
+                limitationReason: null,
+                writable: true,
                 storedValue: this.#coordinator.storedValue(key),
                 effectiveValue: this.#coordinator.effectiveValue(key),
                 ...(bounds === undefined ? {} : bounds),

package/dist/integrations/pi/engine/workflow-controllers.d.ts

@@ -6,6 +6,7 @@ export interface WorkflowControllerResult {
     readonly message: string;
     readonly value?: AgentJsonValue;
 }
+/** Capability-gates pinned Pi workflows before delegating execution through the neutral workflow port. */
 export declare class PiWorkflowControllerPort implements AgentWorkflowPort {
     #private;
     private readonly execute;

package/dist/integrations/pi/engine/workflow-controllers.js

@@ -8,6 +8,7 @@ const DEFINITIONS = [
     define("new", "session.new"), define("compact", "compact"), define("resume", "session.resume"), define("reload", "resources.reload"),
     define("quit", "process.quit"), define("debug", "diagnostics.read"), define("arminsayshi", "resources.read"), define("dementedelves", "resources.read"),
 ];
+/** Capability-gates pinned Pi workflows before delegating execution through the neutral workflow port. */
 export class PiWorkflowControllerPort {
     execute;
     capabilities = { execute: true };

package/dist/integrations/pi/session-ui/index.d.ts

@@ -1,2 +1,3 @@
 export * from "./session-shell.js";
+export * from "./stream-presentation-coalescer.js";
 export * from "./route-host.js";

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

@@ -1,2 +1,3 @@
 export * from "./session-shell.js";
+export * from "./stream-presentation-coalescer.js";
 export * from "./route-host.js";

package/dist/integrations/pi/session-ui/prompt-chips.js

@@ -169,7 +169,7 @@ function existingClipboardPath(value) {
             return { fullPath, kind: "file" };
     }
     catch {
-        // Clipboard path probing is best-effort.
+        // Compatibility: clipboard path probing is best-effort.
     }
     return null;
 }

package/dist/integrations/pi/session-ui/session-shell-root.d.ts

@@ -1,9 +1,11 @@
 import type { OwnedUiSessionViewModel, OwnedUiViewportSettings, OwnedUiViewportSettingsPort } from "../../../contracts/owned-ui/index.js";
 import type { UiRouteHost } from "../../../ui/apps/index.js";
+import { type TranscriptViewportFrame, type TranscriptViewportFrameDescriptor } from "../../../ui/components/index.js";
 import { type PiEngineAdapter, type PiWorkflowResult } from "../engine/index.js";
 import { type PiShellClipboardContent, type PiShellComponentPort, type PiShellEditorPort, type PiShellExtensionRendererResolver, type PiShellHeaderOptions, type PiShellHeaderPort, type PiShellImageAssetResolver, type PiShellLoadedResourcesPort, type PiShellResourceEntry, type PiShellTranscriptComponentPort } from "../components/index.js";
-import { type PiTuiComponentPort, type PiTuiLayoutNode, type PiTuiTerminalPort } from "../tui-runtime/index.js";
+import { type PiTuiComponentPort, type PiTuiInputSurfaceKind, type PiTuiInputCoordinationScheduler, type PiTuiInputDiagnosticsEvent, type PiTuiLayoutNode, type PiTuiTerminalPort } from "../tui-runtime/index.js";
 import { type PreparedPrompt } from "./prompt-chips.js";
+import type { StreamPresentationScheduler } from "./stream-presentation-coalescer.js";
 export type OwnedUiBackendPort = PiEngineAdapter;
 export type OwnedUiTerminalPort = PiTuiTerminalPort;
 type OwnedUiStartupOptions = PiShellHeaderOptions;
@@ -31,7 +33,23 @@ export interface OwnedUiSessionShellOptions {
     readonly viewportSettings?: OwnedUiViewportSettingsPort;
     /** Optional platform seam; production uses A1's system clipboard adapter. */
     readonly clipboard?: OwnedUiClipboardPort;
+    /** Deterministic scheduling seam for presentation-cadence tests. */
+    readonly streamPresentation?: {
+        readonly intervalMs?: number;
+        readonly scheduler?: StreamPresentationScheduler;
+    };
+    /** Optional deterministic seam for keyboard scheduling and phase evidence. */
+    readonly inputPresentation?: {
+        readonly scheduler?: PiTuiInputCoordinationScheduler;
+        readonly onEvent?: (event: PiTuiInputDiagnosticsEvent) => void;
+        readonly now?: () => number;
+        /** Evidence-only baseline seam; production leaves coordination enabled. */
+        readonly coordination?: boolean;
+        /** Evidence-only baseline seam; production leaves dock reuse enabled. */
+        readonly viewportReuse?: boolean;
+    };
 }
+/** Composes backend session state into the owned transcript, viewport, editor, and dock presentation. */
 export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
     #private;
     readonly editor: PiShellEditorPort;
@@ -41,6 +59,8 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
         readonly getColumns: () => number;
         readonly getRows: () => number;
         readonly requestRender: (force?: boolean) => void;
+        readonly onViewportFrame?: (frame: TranscriptViewportFrame) => void;
+        readonly enableDockInputReuse?: boolean;
         readonly onSubmit: (text: string) => void;
         readonly onInterrupt: () => void;
         readonly onClear?: () => void;
@@ -70,6 +90,8 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
      */
     applyTranscriptBlock(block: OwnedUiSessionViewModel["transcript"][number]): void;
     render(width: number): readonly string[];
+    viewportFrameDescriptor(): TranscriptViewportFrameDescriptor | null;
+    hasActiveSelection(): boolean;
     setViewportConfig(config: OwnedUiViewportSettings): void;
     resumeViewportFollowing(): void;
     noteCompletedAssistantMessage(): void;
@@ -99,7 +121,13 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
     addExtensionNotification(message: string, type: "info" | "warning" | "error"): void;
     extensionFooterData(): unknown;
     usesDefaultInputSurface(): boolean;
-    setInputSurface(component: PiShellComponentPort | null, disposePrevious?: boolean): void;
+    inputCoordinationSurface(): PiTuiInputSurfaceKind;
+    viewportCompositionEvidence(): {
+        readonly full: number;
+        readonly dockOnly: number;
+    };
+    transcriptRenderCount(): number;
+    setInputSurface(component: PiShellComponentPort | null, disposePrevious?: boolean, coordination?: Exclude<PiTuiInputSurfaceKind, "editor">): void;
     handleInput(data: string): void;
     invalidate(): void;
     setFocused(focused: boolean): void;