@timurproko/a1 0.2.7-dev.1249 → 0.2.7-dev.1255

package/dist/integrations/pi/components/skills-command.js

@@ -1,14 +1,14 @@
 /** The collapsed bare-A1 replacement for the per-skill command listing. */
 export const SKILLS_COMMAND_NAME = "skills";
-export const SKILLS_COMMAND_DESCRIPTION = "Browse, search, and apply a skill";
+const SKILLS_COMMAND_DESCRIPTION = "Browse, search, and apply a skill";
 /** Pi's own command prefix; the engine expands `/skill:<name>` regardless of how the menu presents it. */
-export const SKILL_COMMAND_PREFIX = "skill:";
+const SKILL_COMMAND_PREFIX = "skill:";
 const SKILLS_TUNNEL_PREFIX = `${SKILLS_COMMAND_NAME}:`;
 /** The tunnel form follows v2: a name without whitespace right after the colon. */
 const SKILLS_TUNNEL_INPUT = /^\/skills:(\S*)$/u;
 const SKILLS_TUNNEL_SUBMISSION = /^\/skills:([A-Za-z0-9][A-Za-z0-9_-]*)(\s[\s\S]*)?$/u;
 /** One line of description, as the v2 extension shows it beside a row. */
-export function oneLineSkillDescription(description) {
+function oneLineSkillDescription(description) {
     return description.replace(/\s+/gu, " ").trim();
 }
 /** The skills the engine registered as `skill:<name>` commands, in its order. */
@@ -82,13 +82,13 @@ export function rewriteSkillsTunnelSubmission(text) {
     return `/${SKILL_COMMAND_PREFIX}${match[1]}${match[2] ?? ""}`;
 }
 /** The tunnel query when single-line content before the cursor is exactly `/skills:<query>`. */
-export function skillsTunnelQuery(lines, cursorLine, cursorCol) {
+function skillsTunnelQuery(lines, cursorLine, cursorCol) {
     if (cursorLine !== 0 || lines.length !== 1)
         return null;
     const match = SKILLS_TUNNEL_INPUT.exec((lines[0] ?? "").slice(0, cursorCol));
     return match === null ? null : match[1] ?? "";
 }
-export function skillsTunnelItems(skills, query) {
+function skillsTunnelItems(skills, query) {
     return skills.filter(skill => skillMatchesQuery(skill, query)).map(skill => ({
         value: `${SKILLS_TUNNEL_PREFIX}${skill.name}`,
         label: `${SKILLS_TUNNEL_PREFIX}${skill.name}`,

package/dist/integrations/pi/components/submitted-prompt-adapter.d.ts

@@ -1,17 +1,14 @@
 import { type Component } from "@earendil-works/pi-tui";
 import type { OwnedUiTranscriptBlock } from "../../../contracts/owned-ui/index.js";
 export interface PiShellSubmittedPromptComposer {
-    readonly layout: (width: number, source?: Date | number | null) => {
+    readonly layout: (width: number) => {
         readonly contentWidth: number;
     };
-    readonly compose: (contentRows: readonly string[], width: number, source?: Date | number | null, style?: {
+    readonly compose: (contentRows: readonly string[], width: number, style?: {
         readonly prefix?: (text: string) => string;
-        readonly timestamp?: (text: string) => string;
     }) => readonly string[];
 }
 /** Branch summaries share the block kind but do not participate in prompt navigation. */
 export declare function isPiPromptStyleCompaction(block: OwnedUiTranscriptBlock): boolean;
-/** Keep prompt timestamps metadata-grey even inside hover and quiet whole-row wrappers. */
-export declare function paintPiSubmittedPromptTimestamp(text: string): string;
 /** Pi owns Markdown and theme adaptation; the injected composer owns neutral row geometry. */
 export declare function createPiSubmittedPromptComponent(block: OwnedUiTranscriptBlock, composer: PiShellSubmittedPromptComposer, heading?: string): Component;

package/dist/integrations/pi/components/submitted-prompt-adapter.js

@@ -7,15 +7,8 @@ export function isPiPromptStyleCompaction(block) {
         && typeof block.payload === "object" && block.payload !== null
         && block.payload.role === "compactionSummary";
 }
-/** Keep prompt timestamps metadata-grey even inside hover and quiet whole-row wrappers. */
-export function paintPiSubmittedPromptTimestamp(text) {
-    // Protocol: combine the intensity/foreground reset so quietSticky does not immediately
-    // reapply faint; the semantic foreground that follows remains theme-controlled.
-    return `\u001b[22;39m${piTheme().fg("dim", text)}`;
-}
 /** Pi owns Markdown and theme adaptation; the injected composer owns neutral row geometry. */
 export function createPiSubmittedPromptComponent(block, composer, heading) {
-    const timestamp = numericTimestamp(block);
     // Invariant: presentation-only chrome stays outside the summary's Markdown parser and stored text.
     const header = heading === undefined ? undefined : new Text(heading, 0, 0);
     let chipWrapping;
@@ -30,7 +23,7 @@ export function createPiSubmittedPromptComponent(block, composer, heading) {
     });
     const content = {
         render(width) {
-            const layout = composer.layout(width, timestamp);
+            const layout = composer.layout(width);
             const renderedBodyRows = markdown.render(layout.contentWidth);
             const wrapping = chipWrapping;
             const bodyRows = wrapping === undefined ? renderedBodyRows : renderedBodyRows.map(row => wrapping.restore(row));
@@ -38,9 +31,8 @@ export function createPiSubmittedPromptComponent(block, composer, heading) {
                 ...header.render(layout.contentWidth).map(row => piTheme().fg("userMessageText", row)),
                 ...(bodyRows.length === 0 ? [] : ["", ...bodyRows]),
             ];
-            return [...composer.compose(rows, width, timestamp, {
+            return [...composer.compose(rows, width, {
                     prefix: text => piTheme().fg("muted", text),
-                    timestamp: paintPiSubmittedPromptTimestamp,
                 })];
         },
         invalidate() {
@@ -52,9 +44,3 @@ export function createPiSubmittedPromptComponent(block, composer, heading) {
     box.addChild(content);
     return box;
 }
-function numericTimestamp(block) {
-    if (typeof block.payload !== "object" || block.payload === null)
-        return null;
-    const value = block.payload.timestamp;
-    return typeof value === "number" && Number.isFinite(value) ? value : null;
-}

package/dist/integrations/pi/components/theme.d.ts

@@ -1,6 +1,13 @@
-import { DIALOG_CLOSE_SHORTCUT_HINT, displayShortcutKeyLabel, type SemanticShortcutHint } from "../../../contracts/presentation/index.js";
+import { DIALOG_CLOSE_SHORTCUT_HINT, displayShortcutKeyLabel, type SemanticShortcutHint, type ThemeSource, type UiTheme } from "../../../contracts/presentation/index.js";
 import { type MarkdownTheme, type SelectListTheme } from "@earendil-works/pi-tui";
-export * from "./upstream/theme/theme.js";
+export { PINNED_PI_LAYOUT, applyPiTheme, applyPiThemeInstance, currentPiThemeName, ensurePiTheme, getAvailablePiThemes, loadPiTheme, piCanvasBackgroundAnsi, piTheme, setPiAccentColor, setPiPackageBorderProjectionEnabled, } from "./upstream/theme/theme.js";
+type Paint = (text: string) => string;
+/** The live Pi theme in neutral roles; `panel` and `disabled` default to plain and dim. */
+export declare function piUiTheme(options?: {
+    readonly panel?: Paint;
+    readonly disabled?: Paint;
+}): UiTheme;
+export declare const PI_THEME_SOURCE: ThemeSource;
 export type PiModalShortcutHint = SemanticShortcutHint;
 export { DIALOG_CLOSE_SHORTCUT_HINT, displayShortcutKeyLabel };
 /** Resolves dialog rules through the live A1 projection instead of Pi's package-global theme. */

package/dist/integrations/pi/components/theme.js

@@ -1,8 +1,23 @@
 import { DIALOG_CLOSE_SHORTCUT_HINT, displayShortcutKeyLabel, renderSemanticShortcutHints, } from "../../../contracts/presentation/index.js";
 import { stripTerminalSequences, truncateToWidth } from "@earendil-works/pi-tui";
 import { getMarkdownTheme } from "../startup-public.js";
-import { piTheme } from "./upstream/theme/theme.js";
-export * from "./upstream/theme/theme.js";
+import { onPiThemeChange, piTheme, renderPiAccentPreview } from "./upstream/theme/theme.js";
+export { PINNED_PI_LAYOUT, applyPiTheme, applyPiThemeInstance, currentPiThemeName, ensurePiTheme, getAvailablePiThemes, loadPiTheme, piCanvasBackgroundAnsi, piTheme, setPiAccentColor, setPiPackageBorderProjectionEnabled, } from "./upstream/theme/theme.js";
+/** The live Pi theme in neutral roles; `panel` and `disabled` default to plain and dim. */
+export function piUiTheme(options = {}) {
+    return {
+        fg: (token, text) => piTheme().fg(token, text),
+        bold: text => piTheme().bold(text),
+        plain: text => text,
+        accentPreview: (color, text) => renderPiAccentPreview(color, text),
+        disabled: options.disabled ?? (text => piTheme().fg("dim", text)),
+        highlight: text => piTheme().bg("selectedBg", text),
+        panel: options.panel ?? (text => text),
+        background: (token, text) => piTheme().bg(token, text),
+    };
+}
+const PI_UI_THEME = Object.freeze(piUiTheme());
+export const PI_THEME_SOURCE = Object.freeze({ current: () => PI_UI_THEME, onChange: (listener) => onPiThemeChange(listener) });
 export { DIALOG_CLOSE_SHORTCUT_HINT, displayShortcutKeyLabel };
 /** Resolves dialog rules through the live A1 projection instead of Pi's package-global theme. */
 export function paintPiBorder(text) {

package/dist/integrations/pi/components/thinking-selector-dialog.d.ts

@@ -1,8 +1,9 @@
 import { type ThinkingSelectorLevel } from "./upstream/components/thinking-selector.js";
 import { type PiShellComponentPort } from "./shell-shared-facade.js";
-export interface PiShellThinkingSelectorPresentation {
+interface PiShellThinkingSelectorPresentation {
     readonly profile: "bare";
     readonly cycleBinding: string | readonly string[];
 }
 /** Lazily loaded because thinking-selector code does not belong to the startup graph before `/thinking` opens. */
 export declare function createPiShellThinkingSelector(currentLevel: ThinkingSelectorLevel, availableLevels: readonly ThinkingSelectorLevel[], onSelect: (level: ThinkingSelectorLevel) => void, onCancel: () => void, onSelectAsDefault?: (level: ThinkingSelectorLevel) => void, defaultLevel?: ThinkingSelectorLevel, presentation?: PiShellThinkingSelectorPresentation): PiShellComponentPort;
+export {};

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

@@ -73,7 +73,7 @@ declare module "@earendil-works/pi-tui" {
 }
 export declare const KEYBINDINGS: {
     readonly "tui.editor.undo": {
-        readonly defaultKeys: "ctrl+z" | "alt+z" | "ctrl+-";
+        readonly defaultKeys: "alt+z" | "ctrl+z" | "ctrl+-";
         readonly description: "Undo";
     };
     readonly "tui.altScreen.previousPrompt": {
@@ -153,7 +153,7 @@ export declare const KEYBINDINGS: {
         readonly description: "Restore queued messages";
     };
     readonly "app.clipboard.pasteImage": {
-        readonly defaultKeys: "alt+v" | "ctrl+v";
+        readonly defaultKeys: "ctrl+v" | "alt+v";
         readonly description: "Paste files on macOS, images, or text from clipboard";
     };
     readonly "app.session.new": {

package/dist/integrations/pi/components/upstream/components/session-footer.d.ts

@@ -5,8 +5,7 @@ export declare class SessionFooter implements Component {
     private readonly cwd;
     private readonly profile;
     private readonly show;
-    private readonly showSessionName;
-    constructor(getView: () => OwnedUiSessionViewModel, cwd: string, profile?: "pi" | "a1", show?: () => boolean, showSessionName?: boolean);
+    constructor(getView: () => OwnedUiSessionViewModel, cwd: string, profile?: "pi" | "a1", show?: () => boolean);
     invalidate(): void;
     dispose(): void;
     render(width: number): string[];

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

@@ -1,10 +1,10 @@
 /**
  * Provenance: @earendil-works/pi-coding-agent 1.5.0 (MIT), commit f9a26365568127461c47a07a37dcb42c140a3ac5,
  * packages/coding-agent/src/modes/interactive/components/footer.ts.
- * Modifications: Owned UI/routing; A1 level color, linked PRs, resident names, dim ellipsis and model
- * priority; Pi unchanged.
- * Deviations: owned-status-level-color, owned-pull-request-badge, owned-resident-session-name,
- * owned-footer-ellipsis, owned-footer-model-priority.
+ * Modifications: Owned UI/routing; A1 level color, linked PRs, dim ellipsis and model priority; Pi
+ * unchanged.
+ * Deviations: owned-status-level-color, owned-pull-request-badge, owned-footer-ellipsis,
+ * owned-footer-model-priority.
  */
 import { isAbsolute, relative, resolve, sep } from "node:path";
 import { hyperlink, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
@@ -14,13 +14,11 @@ export class SessionFooter {
     cwd;
     profile;
     show;
-    showSessionName;
-    constructor(getView, cwd, profile = "pi", show = () => true, showSessionName = true) {
+    constructor(getView, cwd, profile = "pi", show = () => true) {
         this.getView = getView;
         this.cwd = cwd;
         this.profile = profile;
         this.show = show;
-        this.showSessionName = showSessionName;
     }
     invalidate() { }
     dispose() { }
@@ -43,7 +41,7 @@ export class SessionFooter {
         const branch = view.status.footer?.branch;
         if (branch)
             pwd = `${pwd} (${branch})`;
-        const sessionName = this.showSessionName ? view.status.footer?.sessionName : null;
+        const sessionName = view.status.footer?.sessionName;
         const pullRequest = this.profile === "a1" ? view.status.footer?.pullRequest : null;
         let pathRow;
         if (pullRequest == null) {

package/dist/integrations/pi/engine/adapter.d.ts

@@ -6,7 +6,7 @@ import type { PiSessionForkPrompt, PiSessionSelection } from "./session-selectio
 import { type AdapterCommandResult } from "./command-dispatch.js";
 import { type PiEnginePackageUpdateProbe, type PiEngineRuntimeFactory, type PiRepositoryContextReader } from "./session-runtime.js";
 import { type PiEngineHostSessionPorts } from "./host-ports.js";
-import { type PiSessionPresentationSource } from "./ports.js";
+import { type PiEngineAnnouncements, type PiSessionPresentationSource } from "./ports.js";
 export type { OwnedPiExtensionResourceSummary, OwnedPiExtensionSourceSummary, OwnedPiResourceSummary } from "./resource-catalog.js";
 export type { PiEngineRuntimeFactory, PiEngineRuntimeFactoryInput } from "./session-runtime.js";
 export type { AdapterCommandResult } from "./command-dispatch.js";
@@ -56,17 +56,14 @@ export declare class PiEngineAdapter implements OwnedUiSessionBackend, OwnedUiPr
     get settings(): OwnedUiSessionSettingsPort;
     get catalog(): OwnedUiSessionCatalogPort;
     get extensions(): OwnedUiExtensionPort;
+    /** Pinned Pi's changelog since the profile's last seen version and extension package updates; the host announces each once per process. */
+    get announcements(): PiEngineAnnouncements;
     /** The Pi objects behind pinned selectors and renderers, for the session presenters owner only. */
     presentationSource(): PiSessionPresentationSource;
     setWorkflowInteractionHost(interaction: PiWorkflowInteractionHost): void;
     suggestionReasoningPolicy(): OwnedUiPromptSuggestionReasoning;
     generate(request: OwnedUiPromptSuggestionRequest): Promise<OwnedUiPromptSuggestionResult>;
-    generateResidentTabName(instruction: string, maxTokens: number, signal: AbortSignal): Promise<string | null>;
     start(): Promise<OwnedUiSessionViewModel>;
-    /** Announce pinned Pi's changelog since the profile's last seen version; the host calls this once per process. */
-    announceStartupChangelog(): Promise<void>;
-    /** Probe extension packages for updates and announce them; the host calls this once per process. */
-    announcePackageUpdates(): Promise<void>;
     onEvent(listener: (event: OwnedUiEvent) => void): () => void;
     /** Developer-only pressure evidence; never mirrored into visible diagnostic/status arrays. */
     deliveryDiagnostics(): {

package/dist/integrations/pi/engine/adapter.js

@@ -198,35 +198,22 @@ export class PiEngineAdapter {
     get settings() { return this.#ports.settings; }
     get catalog() { return this.#ports.catalog; }
     get extensions() { return this.#ports.extensions; }
+    /** Pinned Pi's changelog since the profile's last seen version and extension package updates; the host announces each once per process. */
+    get announcements() { return this.#ports.announcements; }
     /** The Pi objects behind pinned selectors and renderers, for the session presenters owner only. */
     presentationSource() { return this.#ports.presentation; }
     setWorkflowInteractionHost(interaction) {
         this.#workflowInteraction = interaction;
     }
-    #resolveTranscriptImage(assetId) {
-        return this.#projection.assets.resolve(assetId);
-    }
     // Rationale: the startup check's newer release becomes pinned Pi's `Update Available` notice; it arrives
     // whenever the check resolves, so a late result is appended like Pi's own fire-and-forget version check.
     #announceReleaseUpdate(release) {
         if (this.#disposed)
             return;
-        if (release.status === "client-connected") {
-            if (this.#state.diagnosticsState.acknowledgeClientVersion(release.version))
-                this.#emitView();
-            return;
-        }
         if (release.status === "installed") {
-            this.#state.diagnosticsState.clearCodes(["release-update-installed", "release-update-blocked"]);
+            this.#state.diagnosticsState.clearCodes(["release-update-installed"]);
             this.#addDiagnostic("info", "release-update-installed", `Update ${release.version} installed; restart to update.`, true);
         }
-        else if (release.status === "blocked") {
-            this.#state.diagnosticsState.clearCodes(["release-update-installed", "release-update-blocked"]);
-            this.#addDiagnostic("info", "release-update-blocked", `Update ${release.version} prepared; activation blocked.`, true);
-        }
-        else if (release.status === "blocked-cleared") {
-            this.#state.diagnosticsState.clearCodes(["release-update-blocked"]);
-        }
         else if (release.status === undefined || release.status === "available") {
             const changelog = release.changelogUrl === null ? "" : `\nChangelog: ${release.changelogUrl}`;
             this.#addDiagnostic("info", "release-update", `New version ${release.version} is available. Run ${release.command}${changelog}`, true);
@@ -239,9 +226,6 @@ export class PiEngineAdapter {
     generate(request) {
         return this.#suggestions.generate(request);
     }
-    generateResidentTabName(instruction, maxTokens, signal) {
-        return this.#suggestions.completeInstruction(instruction, maxTokens, signal);
-    }
     async start() {
         if (this.#engine.started)
             return this.view();
@@ -255,14 +239,6 @@ export class PiEngineAdapter {
         this.#emitView();
         return this.view();
     }
-    /** Announce pinned Pi's changelog since the profile's last seen version; the host calls this once per process. */
-    announceStartupChangelog() {
-        return this.#engine.announceChangelog();
-    }
-    /** Probe extension packages for updates and announce them; the host calls this once per process. */
-    announcePackageUpdates() {
-        return this.#engine.announcePackageUpdates();
-    }
     onEvent(listener) {
         return this.#delivery.subscribe(listener, this.#delivery.stamp({ type: "session-view", view: this.view() }));
     }
@@ -410,7 +386,7 @@ export class PiEngineAdapter {
             clearQueuedWorkflows: () => this.clearQueuedWorkflows(),
             setWorkflowInteractionHost: interaction => { this.setWorkflowInteractionHost(interaction); },
             announceReleaseUpdate: release => { this.#announceReleaseUpdate(release); },
-            resolveTranscriptImage: assetId => this.#resolveTranscriptImage(assetId),
+            resolveTranscriptImage: assetId => this.#projection.assets.resolve(assetId),
             extensionRunner: () => this.#requireWorkflowSession().extensionRunner,
         });
     }

package/dist/integrations/pi/engine/changelog.d.ts

@@ -1,2 +1,2 @@
-export declare function readPinnedCommandChangelog(sinceVersion?: string): Promise<string>;
-export declare function formatPinnedCommandChangelog(content: string, sinceVersion?: string): string;
+/** Pinned Pi's changelog since `sinceVersion` (all of it when absent), read from the owned data resource. */
+export declare function readPinnedCommandChangelog(sinceVersion?: string, path?: URL): Promise<string>;

package/dist/integrations/pi/engine/changelog.js

@@ -2,8 +2,8 @@ import { existsSync } from "node:fs";
 import { readFile } from "node:fs/promises";
 import { posix } from "node:path";
 const REPOSITORY = "https://github.com/earendil-works/pi";
-export async function readPinnedCommandChangelog(sinceVersion) {
-    const path = new URL("./resources/changelog.json", import.meta.url);
+/** Pinned Pi's changelog since `sinceVersion` (all of it when absent), read from the owned data resource. */
+export async function readPinnedCommandChangelog(sinceVersion, path = new URL("./resources/changelog.json", import.meta.url)) {
     if (!existsSync(path))
         return sinceVersion === undefined ? "No changelog entries found." : "";
     try {
@@ -19,7 +19,7 @@ export async function readPinnedCommandChangelog(sinceVersion) {
         return sinceVersion === undefined ? "No changelog entries found." : "";
     }
 }
-export function formatPinnedCommandChangelog(content, sinceVersion) {
+function formatPinnedCommandChangelog(content, sinceVersion) {
     // Provenance: behavior follows Pi 0.84.2 utils/changelog.ts at 914cf1472e715297caa30db4b9535d534a9eb718.
     // Runtime reads only the owned data resource; maintenance tooling verifies its pinned provenance.
     let releases = content.split(/(?=^## )/m).flatMap((section) => {

package/dist/integrations/pi/engine/compaction-progress.d.ts

@@ -1,7 +1,5 @@
-/** Expected summary size for a first compaction, when no previous summary on the branch can serve as the estimate. */
-export declare const DEFAULT_EXPECTED_COMPACTION_SUMMARY_CHARS = 4000;
 /** The public session surface compaction progress reads: the agent's stream function and the branch entries. */
-export interface CompactionProgressSession {
+interface CompactionProgressSession {
     readonly agent?: {
         streamFunction?: unknown;
     } | undefined;
@@ -22,3 +20,4 @@ export interface CompactionProgressObserver {
  * when the session exposes no callable public stream function.
  */
 export declare function observeCompactionProgress(session: CompactionProgressSession, onProgress: (percent: number) => void): CompactionProgressObserver | null;
+export {};

package/dist/integrations/pi/engine/compaction-progress.js

@@ -1,5 +1,5 @@
 /** Expected summary size for a first compaction, when no previous summary on the branch can serve as the estimate. */
-export const DEFAULT_EXPECTED_COMPACTION_SUMMARY_CHARS = 4000;
+const DEFAULT_EXPECTED_COMPACTION_SUMMARY_CHARS = 4000;
 /** Character-based estimates stay below terminal stream completion. */
 const MAX_STREAMING_PERCENT = 99;
 const COMPLETE_PERCENT = 100;

package/dist/integrations/pi/engine/conformance.d.ts

@@ -20,7 +20,7 @@ export declare class PiCapabilityCompatibilityError extends Error {
     readonly operation: string;
     constructor(packageVersion: string, capability: string, operation: string, detail: string);
 }
-export interface PiUpgradeConformanceReport {
+interface PiUpgradeConformanceReport {
     readonly schema: "pi-engine-conformance-v1";
     readonly packageName: "@earendil-works/pi-coding-agent";
     readonly packageVersion: string;
@@ -37,3 +37,4 @@ export declare class PiUpgradeConformanceError extends Error {
 }
 export declare function runPiUpgradeConformance(): Promise<PiUpgradeConformanceReport>;
 export declare function validatePiCapabilityResults(packageVersion: string, results: readonly PiCapabilityConformanceResult[]): void;
+export {};

package/dist/integrations/pi/engine/default-model-setting.d.ts

@@ -5,8 +5,6 @@ interface DefaultModelChoice {
     readonly label: string;
     readonly name: string;
 }
-export declare const DEFAULT_MODEL_SETTING_KEY = "defaultModel";
-export declare const SUPPLEMENTAL_SETTING_KEYS: readonly ["defaultModel"];
 export declare function defaultModelDescriptor(settings: SettingsManager, models: readonly DefaultModelChoice[]): AgentSettingDescriptor;
 export declare function writeDefaultModel(settings: SettingsManager, models: readonly DefaultModelChoice[], value: unknown): Promise<AgentSettingChangeOutcome>;
 export {};

package/dist/integrations/pi/engine/default-model-setting.js

@@ -1,5 +1,4 @@
-export const DEFAULT_MODEL_SETTING_KEY = "defaultModel";
-export const SUPPLEMENTAL_SETTING_KEYS = [DEFAULT_MODEL_SETTING_KEY];
+const DEFAULT_MODEL_SETTING_KEY = "defaultModel";
 const UNSET = "not set";
 function read(settings) {
     const provider = settings.getDefaultProvider();

package/dist/integrations/pi/engine/diagnostics-state.d.ts

@@ -6,5 +6,4 @@ export declare class EngineDiagnostics {
     get messages(): readonly string[];
     record(severity: OwnedUiDiagnostics["severity"], code: string, message: string, recoverable: boolean): OwnedUiDiagnostics;
     clearCodes(codes: readonly string[]): boolean;
-    acknowledgeClientVersion(version: string): boolean;
 }

package/dist/integrations/pi/engine/diagnostics-state.js

@@ -1,4 +1,3 @@
-import { gte, valid as validSemver } from "semver";
 /** Bounded structured notices; acknowledgements never inspect terminal cells or touch Agent work. */
 export class EngineDiagnostics {
     #values = [];
@@ -18,19 +17,6 @@ export class EngineDiagnostics {
         const selected = new Set(codes);
         return this.#remove(diagnostic => selected.has(diagnostic.code));
     }
-    acknowledgeClientVersion(version) {
-        if (validSemver(version) === null)
-            return false;
-        return this.#remove(diagnostic => {
-            // Invariant: restart readiness describes this long-lived process, not the outer client that
-            // attached to it. A newer client can clear activation blocking, but only process exit clears
-            // an installed-update notice.
-            const target = diagnostic.code === "release-update-blocked"
-                ? /^Update (\S+) prepared; activation blocked\.$/u.exec(diagnostic.message)?.[1]
-                : undefined;
-            return target !== undefined && validSemver(target) !== null && gte(version, target);
-        });
-    }
     #remove(predicate) {
         const removed = new Set();
         for (let index = this.#values.length - 1; index >= 0; index--) {

package/dist/integrations/pi/engine/event-delivery.d.ts

@@ -24,7 +24,7 @@ export type PiEmittedEvent = Omit<Extract<OwnedUiEvent, {
     type: "diagnostic";
 }>, "sessionId" | "sequence">;
 /** A command outcome held back during an overload so its command can still settle after recovery. */
-export interface ReservedCommandOutcome {
+interface ReservedCommandOutcome {
     readonly outcome: Extract<OwnedUiEvent, {
         type: "command-outcome";
     }>["outcome"];
@@ -98,3 +98,4 @@ export declare class PiEventDelivery {
     /** Resolves once every queued event has been delivered or invalidated. */
     settle(): Promise<void>;
 }
+export {};

package/dist/integrations/pi/engine/extension-ui-binding.d.ts

@@ -1,7 +1,7 @@
 import type { AgentSession } from "../startup-public.js";
 import { type OwnedUiDiagnostics, type OwnedUiVisualExtensionSupport } from "../../../contracts/owned-ui/index.js";
 export type OwnedPiVisualExtensionSupport = OwnedUiVisualExtensionSupport;
-export interface PiExtensionUiBindingPorts {
+interface PiExtensionUiBindingPorts {
     session(): AgentSession | undefined;
     diagnostic(severity: OwnedUiDiagnostics["severity"], code: string, message: string, recoverable: boolean): void;
     emitView(): void;
@@ -24,3 +24,4 @@ export declare class PiExtensionUiBinding {
     /** Bind the attached bridge to the current session, reporting failures as diagnostics. */
     rebind(): Promise<void>;
 }
+export {};

package/dist/integrations/pi/engine/host.js

@@ -141,7 +141,7 @@ class ProcessPiEngineHost {
             return;
         this.#announced = true;
         if (this.#options.announceStartupChangelog !== false)
-            await adapter.announceStartupChangelog();
-        void adapter.announcePackageUpdates();
+            await adapter.announcements.startupChangelog();
+        void adapter.announcements.packageUpdates();
     }
 }

package/dist/integrations/pi/engine/message-values.d.ts

@@ -10,7 +10,6 @@ export declare function retainCompletedArguments(current: OwnedUiTranscriptBlock
  * need re-renders it for nothing.
  */
 export declare function sameBlockContent(left: OwnedUiTranscriptBlock, right: OwnedUiTranscriptBlock): boolean;
-export declare function sameValue(left: unknown, right: unknown): boolean;
 export declare function textFromContent(content: unknown): string;
 export declare function assistantContent(content: readonly unknown[]): readonly Record<string, unknown>[];
 export declare function contentImageCount(content: unknown): number;

package/dist/integrations/pi/engine/message-values.js

@@ -35,7 +35,7 @@ export function sameBlockContent(left, right) {
         && sameValue(left.payload, right.payload)
         && sameValue(left.imageReferences ?? [], right.imageReferences ?? []);
 }
-export function sameValue(left, right) {
+function sameValue(left, right) {
     if (left === right)
         return true;
     if (typeof left !== typeof right || left === null || right === null)

package/dist/integrations/pi/engine/pending-delivery.d.ts

@@ -1,8 +1,4 @@
 import type { OwnedUiEvent } from "../../../contracts/owned-ui/index.js";
-export declare const MAX_PENDING_EVENTS = 1024;
-export declare const MAX_PENDING_EVENT_BYTES: number;
-/** Actual shell semantics: only live complete block state has no independent side effect. */
-export declare function replaceableEventKey(event: OwnedUiEvent): string | null;
 /** Intrusive FIFO + segment index: replacement unlinks in O(1), never changes source ordering. */
 export declare class PendingEngineDelivery {
     #private;

package/dist/integrations/pi/engine/pending-delivery.js

@@ -1,7 +1,7 @@
-export const MAX_PENDING_EVENTS = 1024;
-export const MAX_PENDING_EVENT_BYTES = 8 * 1024 * 1024;
+const MAX_PENDING_EVENTS = 1024;
+const MAX_PENDING_EVENT_BYTES = 8 * 1024 * 1024;
 /** Actual shell semantics: only live complete block state has no independent side effect. */
-export function replaceableEventKey(event) {
+function replaceableEventKey(event) {
     switch (event.type) {
         case "transcript-block": return event.block.status === "live" && !(typeof event.block.payload === "object" && event.block.payload !== null && "isError" in event.block.payload && event.block.payload.isError === true) ? event.block.id : null;
         case "session-view": // Invariant: may clear compaction work, replace editor/session state, or preempt presentation.

package/dist/integrations/pi/engine/ports.d.ts

@@ -24,6 +24,11 @@ export interface PiSessionPresentationSource {
     pinnedSettingsModels(): Pick<PiPinnedSettingsSnapshot, "currentModel" | "availableDefaultModels">;
     applyPinnedSettingValue(callback: PiPinnedSettingsCallback, value: unknown): Promise<PiWorkflowResult>;
 }
+/** Startup announcements the host makes once per process: pinned Pi's changelog and extension package updates. */
+export interface PiEngineAnnouncements {
+    startupChangelog(): Promise<void>;
+    packageUpdates(): Promise<void>;
+}
 export interface PiEngineAdapterPorts {
     readonly identity: OwnedUiSessionIdentityPort;
     readonly session: OwnedUiSessionPort;
@@ -32,12 +37,13 @@ export interface PiEngineAdapterPorts {
     readonly catalog: OwnedUiSessionCatalogPort;
     readonly extensions: OwnedUiExtensionPort;
     readonly presentation: PiSessionPresentationSource;
+    readonly announcements: PiEngineAnnouncements;
 }
 /** The adapter's collaborators and its own session operations, which every port member reaches at call time. */
 export interface EnginePortParts {
     readonly sessionId: string;
     readonly agentDir: string;
-    readonly engine: Pick<PiEngineRuntime, "cwd" | "generation" | "bindingGeneration" | "currentSessionResumeMetadata" | "currentSessionFile" | "session">;
+    readonly engine: Pick<PiEngineRuntime, "cwd" | "generation" | "bindingGeneration" | "currentSessionResumeMetadata" | "currentSessionFile" | "session" | "announceChangelog" | "announcePackageUpdates">;
     readonly contexts: PiWorkflowContexts;
     readonly workflows: PiWorkflowRunner;
     readonly settings: PiEngineSettings;

package/dist/integrations/pi/engine/ports.js

@@ -65,6 +65,10 @@ export function createEnginePorts(parts) {
             bindClipboardWriter: writer => workflows.bindClipboardWriter(writer),
             announceReleaseUpdate: release => { parts.announceReleaseUpdate(release); },
         },
+        announcements: {
+            startupChangelog: () => engine.announceChangelog(),
+            packageUpdates: () => engine.announcePackageUpdates(),
+        },
         presentation: {
             pinnedModelSelectorContext: () => contexts.pinnedModelSelectorContext(),
             pinnedSessionSelectorContext: () => contexts.pinnedSessionSelectorContext(),

package/dist/integrations/pi/engine/project-trust-preflight.d.ts

@@ -1,4 +1,4 @@
-export type PiProjectTrustChoiceId = "trust" | "trust-parent" | "trust-session" | "deny" | "deny-session";
+type PiProjectTrustChoiceId = "trust" | "trust-parent" | "trust-session" | "deny" | "deny-session";
 export interface PiProjectTrustPreflightRequest {
     readonly cwd: string;
     readonly defaultDecision: "ask" | "always" | "never";
@@ -24,3 +24,4 @@ export interface ResolvePiProjectTrustPreflightOptions {
  * result exists.
  */
 export declare function resolvePiProjectTrustPreflight(options: ResolvePiProjectTrustPreflightOptions): Promise<PiProjectTrustPreflightResult>;
+export {};

package/dist/integrations/pi/engine/prompt-suggestions.d.ts

@@ -1,13 +1,13 @@
 import type { AgentSession, AgentSessionRuntime } from "../startup-public.js";
 import { type OwnedUiModelInfo, type OwnedUiPromptSuggestionGeneratorPort, type OwnedUiPromptSuggestionReasoning, type OwnedUiPromptSuggestionRequest, type OwnedUiPromptSuggestionResult } from "../../../contracts/owned-ui/index.js";
 /** The run position a suggestion request must still match to be answered. */
-export interface PiPromptSuggestionIdentity {
+interface PiPromptSuggestionIdentity {
     readonly sessionId: string;
     readonly sessionGeneration: number;
     readonly runSequence: number;
     readonly responseSequence: number;
 }
-export interface PiPromptSuggestionPorts {
+interface PiPromptSuggestionPorts {
     session(): AgentSession | undefined;
     runtime(): AgentSessionRuntime | undefined;
     activeModel(): OwnedUiModelInfo | null;
@@ -26,6 +26,6 @@ export declare class PiPromptSuggestions implements OwnedUiPromptSuggestionGener
     #private;
     constructor(ports: PiPromptSuggestionPorts);
     reasoningPolicy(): OwnedUiPromptSuggestionReasoning;
-    completeInstruction(instruction: string, maxTokens: number, signal: AbortSignal): Promise<string | null>;
     generate(request: OwnedUiPromptSuggestionRequest): Promise<OwnedUiPromptSuggestionResult>;
 }
+export {};