@timurproko/a1 0.2.1 → 0.2.2

package/dist/features/owned-ui/release-notes.js

@@ -0,0 +1,73 @@
+import { readFile } from "node:fs/promises";
+import semver from "semver";
+const RESOURCE_SCHEMA = "a1-release-notes-v1";
+const MAX_RESOURCE_BYTES = 1024 * 1024;
+const MAX_NOTE_BYTES = 128 * 1024;
+const STABLE = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/u;
+export async function readPackagedReleaseNotes(path = new URL("./resources/release-notes.json", import.meta.url)) {
+    const bytes = await readFile(path);
+    if (bytes.length > MAX_RESOURCE_BYTES)
+        throw new Error("A1 release notes resource is too large");
+    const value = JSON.parse(bytes.toString("utf8"));
+    if (!value || typeof value !== "object" || value.schema !== RESOURCE_SCHEMA
+        || !Array.isArray(value.releases))
+        throw new Error("A1 release notes resource is invalid");
+    const seen = new Set();
+    let previous = null;
+    const releases = value.releases.map((item) => {
+        const release = item;
+        if (typeof release.version !== "string" || !STABLE.test(release.version) || semver.valid(release.version) !== release.version
+            || typeof release.markdown !== "string" || !validMarkdown(release.markdown, release.version)) {
+            throw new Error("A1 release note entry is invalid");
+        }
+        if (seen.has(release.version) || (previous !== null && semver.gte(release.version, previous))) {
+            throw new Error("A1 release note order is invalid");
+        }
+        seen.add(release.version);
+        previous = release.version;
+        return Object.freeze({ version: release.version, markdown: release.markdown.replaceAll("\r\n", "\n").trimEnd() });
+    });
+    const frozen = Object.freeze(releases);
+    return Object.freeze({
+        releases: frozen,
+        completeMarkdown: frozen.length === 0 ? "No A1 release notes found."
+            : frozen.map(release => release.markdown.startsWith(`## [${release.version}] - `)
+                ? release.markdown : `## [${release.version}]\n\n${release.markdown}`).join("\n\n"),
+        current: (version) => STABLE.test(version) ? frozen.find(release => release.version === version) ?? null : null,
+    });
+}
+function validMarkdown(markdown, version) {
+    if (Buffer.byteLength(markdown, "utf8") > MAX_NOTE_BYTES
+        || /[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/u.test(markdown)
+        || [...markdown.matchAll(/^# A1 \d+\.\d+\.\d+$/gmu)].length !== 0
+        || markdown.trim() === ""
+        || /<\/?[A-Za-z][A-Za-z0-9-]*(?:\s[^>]*)?\/?>|\b(?:href|src)\s*=/iu.test(markdown))
+        return false;
+    const headings = [...markdown.matchAll(/^## \[((?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*))\] - (\d{4}-\d{2}-\d{2})$/gmu)];
+    if (headings.length > 1 || (headings.length === 1 && (headings[0]?.[1] !== version || !validDate(headings[0]?.[2]))))
+        return false;
+    const links = [
+        ...[...markdown.matchAll(/\[[^\]]*\]\(([^)\s]+)(?:\s+[^)]*)?\)/gu)].map(match => match[1] ?? ""),
+        ...[...markdown.matchAll(/<([^>\s]+:[^>]*)>/gu)].map(match => match[1] ?? ""),
+    ];
+    return links.every(safeLink);
+}
+function validDate(value) {
+    if (!value || !/^\d{4}-\d{2}-\d{2}$/u.test(value))
+        return false;
+    const parsed = new Date(`${value}T00:00:00.000Z`);
+    return !Number.isNaN(parsed.valueOf()) && parsed.toISOString().slice(0, 10) === value;
+}
+function safeLink(target) {
+    if (target.startsWith("https://")) {
+        try {
+            const url = new URL(target);
+            return Boolean(url.hostname) && !url.username && !url.password;
+        }
+        catch {
+            return false;
+        }
+    }
+    return Boolean(target) && !target.startsWith("/") && !target.includes("\\")
+        && !target.split(/[/?#]/u).includes("..") && !/^[A-Za-z][A-Za-z0-9+.-]*:/u.test(target);
+}

package/dist/features/owned-ui/resources/release-notes.json

@@ -0,0 +1,9 @@
+{
+  "schema": "a1-release-notes-v1",
+  "releases": [
+    {
+      "version": "0.2.2",
+      "markdown": "## [0.2.2] - 2026-09-30\n\n### Breaking Changes\n\n- publish from the native Publish release button ([#629](https://github.com/timurproko/a1/pull/629))\n\n### New Features\n\n- review changelog before publish ([#613](https://github.com/timurproko/a1/pull/613))\n- review notes in draft release ([#617](https://github.com/timurproko/a1/pull/617))\n- configure prompt image limit ([#622](https://github.com/timurproko/a1/pull/622))\n- refresh ready PRs after merges ([#625](https://github.com/timurproko/a1/pull/625))\n- refresh a draft bound to an older develop in place ([#635](https://github.com/timurproko/a1/pull/635))\n- show live validation jobs while waiting ([#637](https://github.com/timurproko/a1/pull/637))\n- keep one draft per stable version ([#638](https://github.com/timurproko/a1/pull/638))\n- delete a release tag left behind by a deleted Release ([#640](https://github.com/timurproko/a1/pull/640))\n- announce newer A1 releases on startup ([#643](https://github.com/timurproko/a1/pull/643))\n\n### Changed\n\n- rename publisher workflow ([#612](https://github.com/timurproko/a1/pull/612))\n- Update README.md ([#614](https://github.com/timurproko/a1/pull/614))\n- Update README.md ([#616](https://github.com/timurproko/a1/pull/616))\n- Update README.md ([#618](https://github.com/timurproko/a1/pull/618))\n- use npm x for installer commands ([#620](https://github.com/timurproko/a1/pull/620))\n- Streamline stable release handoff ([#627](https://github.com/timurproko/a1/pull/627))\n- shard Windows full regression ([#630](https://github.com/timurproko/a1/pull/630))\n- acknowledge candidate release note before resume launches ([#633](https://github.com/timurproko/a1/pull/633))\n- run the upstream sync at 03:23 Central European time ([#641](https://github.com/timurproko/a1/pull/641))\n\n### Fixed\n\n- retire blocked worktrees safely ([#610](https://github.com/timurproko/a1/pull/610))\n- approve publication from Actions ([#619](https://github.com/timurproko/a1/pull/619))\n- keep queued chips unbroken ([#621](https://github.com/timurproko/a1/pull/621))\n- retain pinned Pi runtime root ([#624](https://github.com/timurproko/a1/pull/624))\n- repair the 2026-09-29 full regression failure ([#626](https://github.com/timurproko/a1/pull/626))\n- repair the 2026-09-29-1 publish failure ([#628](https://github.com/timurproko/a1/pull/628))\n- wait for candidate validation and authorize dispatch wrappers ([#631](https://github.com/timurproko/a1/pull/631))\n- keep full-lanes directory in Windows lane artifacts ([#632](https://github.com/timurproko/a1/pull/632))\n- report preparation failures from the default runtime ([#634](https://github.com/timurproko/a1/pull/634))\n- keep the version tag when refreshing a draft ([#636](https://github.com/timurproko/a1/pull/636))\n- capture the stable version before checking the Release id ([#639](https://github.com/timurproko/a1/pull/639))\n- full changelog range, candidate-validated publish, and npm trust preflight ([#644](https://github.com/timurproko/a1/pull/644))\n- repair the 2026-09-30 full regression failure ([#645](https://github.com/timurproko/a1/pull/645))\n- repair the 2026-09-30-2 publish failure ([#646](https://github.com/timurproko/a1/pull/646))\n- stop the trust dialog flashing the terminal ([#647](https://github.com/timurproko/a1/pull/647))\n"
+    }
+  ]
+}

package/dist/foundation/release/latest-release.d.ts

@@ -0,0 +1,55 @@
+/** Published release channels: stable `X.Y.Z` on dist-tag `latest`, development `X.Y.Z-dev.N` on `next`. */
+export type ReleaseChannel = "stable" | "development";
+export interface DistTagVersions {
+    readonly release: string | null;
+    readonly develop: string | null;
+    readonly error: string | null;
+}
+export type RegistryFetcher = (url: string) => Promise<{
+    readonly ok: boolean;
+    readonly status: number;
+    text(): Promise<string>;
+}>;
+export interface AvailableRelease {
+    readonly channel: ReleaseChannel;
+    readonly version: string;
+    /** The command that installs it: `a1 update` or `a1 update --develop`. */
+    readonly command: string;
+    /** The GitHub Release page; development releases have none. */
+    readonly changelogUrl: string | null;
+}
+export declare const DEFAULT_NPM_REGISTRY = "https://registry.npmjs.org";
+export declare const UPDATE_CHECK_INTERVAL_MS: number;
+/**
+ * The channel a running version updates on, or null for a version that was never published:
+ * a bare `X.Y.Z-dev` only comes from a source checkout, which has nothing to update to.
+ */
+export declare function releaseChannelOf(version: string): ReleaseChannel | null;
+/** True only when both versions are valid semver and the candidate sorts strictly above the current one. */
+export declare function isNewerRelease(candidate: string, current: string): boolean;
+export declare function distTagsUrl(registry?: string): string;
+/** Read `latest` (required) and `next` (optional) from a dist-tags object. */
+export declare function parseDistTags(metadata: unknown, source: string): DistTagVersions;
+export declare function queryRegistryDistTags(fetcher: RegistryFetcher, registry?: string): Promise<DistTagVersions>;
+export declare function unavailableDistTags(error: string): DistTagVersions;
+export declare function createRegistryFetcher(timeoutMs: number): RegistryFetcher;
+export interface StartupReleaseCheckOptions {
+    readonly runningVersion: string;
+    readonly configDir: string;
+    readonly environment?: NodeJS.ProcessEnv;
+    /** Whether standard output is an interactive terminal. */
+    readonly interactive: boolean;
+    /** The bare-A1 `updateCheck` setting; comparison profiles omit it. */
+    readonly settingEnabled?: boolean;
+    readonly fetcher?: RegistryFetcher;
+    readonly now?: () => number;
+}
+/** Why the startup check is skipped before any cache read or network access, or null when it may run. */
+export declare function startupReleaseCheckSkipReason(options: StartupReleaseCheckOptions): string | null;
+/**
+ * Resolve whether a newer release exists on the running version's channel. A fresh cache for the
+ * same channel answers without network access; otherwise the registry is queried and a successful
+ * answer replaces the cache. Every failure resolves to null: the notice is best-effort.
+ */
+export declare function checkForNewerRelease(options: StartupReleaseCheckOptions): Promise<AvailableRelease | null>;
+export declare function availableRelease(channel: ReleaseChannel, version: string): AvailableRelease;

package/dist/foundation/release/latest-release.js

@@ -0,0 +1,166 @@
+import { randomUUID } from "node:crypto";
+import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { gt, prerelease, valid as validSemver } from "semver";
+import { PRODUCT_IDENTITY, PRODUCT_TEXT } from "../../product-identity.js";
+export const DEFAULT_NPM_REGISTRY = "https://registry.npmjs.org";
+export const UPDATE_CHECK_INTERVAL_MS = 24 * 60 * 60_000;
+const STARTUP_FETCH_TIMEOUT_MS = 3_000;
+const CACHE_FILENAME = "update-check.json";
+const CACHE_VERSION = 1;
+const MAX_CACHE_BYTES = 4096;
+const DEVELOPMENT_BUILD = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)-dev\.(0|[1-9]\d*)$/u;
+const RELEASE_PAGE = "https://github.com/timurproko/a1/releases/tag/v";
+/**
+ * The channel a running version updates on, or null for a version that was never published:
+ * a bare `X.Y.Z-dev` only comes from a source checkout, which has nothing to update to.
+ */
+export function releaseChannelOf(version) {
+    if (validSemver(version) !== version)
+        return null;
+    if (prerelease(version) === null)
+        return "stable";
+    return DEVELOPMENT_BUILD.test(version) ? "development" : null;
+}
+/** True only when both versions are valid semver and the candidate sorts strictly above the current one. */
+export function isNewerRelease(candidate, current) {
+    const left = validSemver(candidate);
+    const right = validSemver(current);
+    return left !== null && right !== null && gt(left, right);
+}
+export function distTagsUrl(registry = DEFAULT_NPM_REGISTRY) {
+    return `${registry.replace(/\/+$/u, "")}/-/package/${encodeURIComponent(PRODUCT_TEXT.packageName)}/dist-tags`;
+}
+/** Read `latest` (required) and `next` (optional) from a dist-tags object. */
+export function parseDistTags(metadata, source) {
+    if (typeof metadata !== "object" || metadata === null || Array.isArray(metadata)) {
+        return unavailableDistTags(`${source} returned a non-object dist-tags value`);
+    }
+    try {
+        const tags = metadata;
+        const release = parseVersion(tags.latest, `${source} latest`);
+        const develop = tags.next === undefined ? null : parseVersion(tags.next, `${source} development channel`);
+        return { release, develop, error: null };
+    }
+    catch (error) {
+        return unavailableDistTags(errorMessage(error));
+    }
+}
+export async function queryRegistryDistTags(fetcher, registry) {
+    try {
+        const response = await fetcher(distTagsUrl(registry));
+        if (!response.ok)
+            return unavailableDistTags(`registry responded with status ${response.status}`);
+        return parseDistTags(JSON.parse(await response.text()), "registry");
+    }
+    catch (error) {
+        return unavailableDistTags(errorMessage(error));
+    }
+}
+export function unavailableDistTags(error) {
+    return { release: null, develop: null, error };
+}
+export function createRegistryFetcher(timeoutMs) {
+    return async (url) => await fetch(url, { headers: { accept: "application/json" }, signal: AbortSignal.timeout(timeoutMs) });
+}
+/** Why the startup check is skipped before any cache read or network access, or null when it may run. */
+export function startupReleaseCheckSkipReason(options) {
+    const environment = options.environment ?? process.env;
+    if (truthy(environment.PI_OFFLINE))
+        return "offline";
+    if (truthy(environment[PRODUCT_IDENTITY.environment.skipVersionCheck]))
+        return "disabled-by-environment";
+    if (truthy(environment.CI))
+        return "ci";
+    if (!options.interactive)
+        return "not-interactive";
+    if (options.settingEnabled === false)
+        return "disabled-by-setting";
+    if (releaseChannelOf(options.runningVersion) === null)
+        return "unpublished-version";
+    return null;
+}
+/**
+ * Resolve whether a newer release exists on the running version's channel. A fresh cache for the
+ * same channel answers without network access; otherwise the registry is queried and a successful
+ * answer replaces the cache. Every failure resolves to null: the notice is best-effort.
+ */
+export async function checkForNewerRelease(options) {
+    if (startupReleaseCheckSkipReason(options) !== null)
+        return null;
+    const channel = releaseChannelOf(options.runningVersion);
+    const environment = options.environment ?? process.env;
+    const now = options.now ?? Date.now;
+    const cachePath = join(options.configDir, CACHE_FILENAME);
+    try {
+        let latest = await readFreshCache(cachePath, channel, now());
+        if (latest === null) {
+            const tags = await queryRegistryDistTags(options.fetcher ?? createRegistryFetcher(STARTUP_FETCH_TIMEOUT_MS), environment.npm_config_registry?.trim() || undefined);
+            latest = channel === "stable" ? tags.release : tags.develop;
+            if (tags.error !== null || latest === null)
+                return null;
+            await writeCache(options.configDir, cachePath, { version: CACHE_VERSION, channel, latest, checkedAt: now() }).catch(() => undefined);
+        }
+        return isNewerRelease(latest, options.runningVersion) ? availableRelease(channel, latest) : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function availableRelease(channel, version) {
+    return {
+        channel,
+        version,
+        command: channel === "stable" ? `${PRODUCT_TEXT.commandName} update` : `${PRODUCT_TEXT.commandName} update --develop`,
+        changelogUrl: channel === "stable" ? `${RELEASE_PAGE}${version}` : null,
+    };
+}
+async function readFreshCache(path, channel, now) {
+    let parsed;
+    try {
+        const source = await readFile(path, "utf8");
+        if (source.length > MAX_CACHE_BYTES)
+            return null;
+        parsed = JSON.parse(source);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== "object" || parsed === null)
+        return null;
+    const cache = parsed;
+    if (cache.version !== CACHE_VERSION || cache.channel !== channel)
+        return null;
+    if (typeof cache.latest !== "string" || validSemver(cache.latest) === null)
+        return null;
+    if (typeof cache.checkedAt !== "number" || !Number.isFinite(cache.checkedAt))
+        return null;
+    // Invariant: a timestamp from the future (clock moved back) is stale rather than fresh forever.
+    const age = now - cache.checkedAt;
+    return age >= 0 && age < UPDATE_CHECK_INTERVAL_MS ? cache.latest : null;
+}
+async function writeCache(directory, path, document) {
+    await mkdir(directory, { recursive: true });
+    const temporary = `${path}.${randomUUID()}.tmp`;
+    try {
+        await writeFile(temporary, `${JSON.stringify(document)}\n`, { encoding: "utf8", mode: 0o600 });
+        await rename(temporary, path);
+    }
+    catch (error) {
+        await rm(temporary, { force: true });
+        throw error;
+    }
+}
+function truthy(value) {
+    if (value === undefined)
+        return false;
+    const normalized = value.trim().toLowerCase();
+    return normalized !== "" && normalized !== "0" && normalized !== "false";
+}
+function parseVersion(value, source) {
+    const parsed = typeof value === "string" ? validSemver(value) : null;
+    if (!parsed)
+        throw new Error(`${source} did not provide a valid semantic version`);
+    return parsed;
+}
+function errorMessage(error) { return error instanceof Error ? error.message : String(error); }

package/dist/foundation/release/update.js

@@ -5,6 +5,7 @@ import { dirname, isAbsolute, relative, resolve, sep } from "node:path";
 import crossSpawn from "cross-spawn";
 import { valid as validSemver } from "semver";
 import { PRODUCT_IDENTITY, PRODUCT_TEXT } from "../../product-identity.js";
+import { isNewerRelease, releaseChannelOf } from "./latest-release.js";
 import { certifyMaterializedRelease, ensureSupervisor, waitForProcessExit, } from "./bootstrap.js";
 import { probeOwnership, readEndpointMetadata, removeEndpointArtifacts } from "./endpoints.js";
 import { resolveCohortEndpoint, resolveProductPaths } from "../lifecycle/index.js";
@@ -495,6 +496,14 @@ export async function runSelfUpdate(options) {
     if (resolved.version === null)
         return resolved.exitCode;
     const targetVersion = resolved.version;
+    // Invariant: a channel head below the running release on the same channel is never installed, so a
+    // lagging or rolled-back dist-tag cannot downgrade. Switching channels and named previews stay deliberate.
+    const sameChannel = releaseChannelOf(runningVersion) === (channel === "stable" ? "stable" : "development");
+    if ((requested === undefined || requested.length === 0) && sameChannel
+        && targetVersion !== runningVersion && !isNewerRelease(targetVersion, runningVersion)) {
+        output.stdout(`${PRODUCT_TEXT.commandName} is up to date — no update needed.\n`);
+        return 0;
+    }
     // Rationale: no full stop after a version: it already ends in a dot-separated identifier,
     // and a trailing one reads as part of the version rather than as punctuation.
     output.stdout(`${PRODUCT_TEXT.commandName} update: ${runningVersion} → ${targetVersion}\n`);

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

@@ -2,7 +2,7 @@ export { adaptPiAssistantMessage, adaptPiToolExecution, adaptPiUserMessage } fro
 export { loadHistoryEditor, type HistoryEditorConstructor } from "./history-editor-loader.js";
 export { PiComponentConformanceError, runPiComponentConformance } from "./conformance.js";
 export type { PiComponentConformanceReport, PiComponentConformanceResult } from "./conformance.js";
-export { OWNED_BUILTIN_SLASH_COMMANDS, PINNED_PI_BUILTIN_SLASH_COMMANDS, componentFromPort, componentPort, createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellModelsDialog, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellShowImagesSelector, createPiShellSkillsSelector, createPiShellStatus, createPiShellThemeSelector, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, createTuiFacade, ensureTheme, formatSessionTokens, isAutocompleteProvider, isPiPromptStyleCompaction, isRecord, paintPiSubmittedPromptTimestamp, piShellHyperlink, piShellTruncateToWidth, piShellVisibleWidth, renderPiShellChangelogLines, renderPiShellCommandMessage, renderPiShellHotkeysLines, renderPiShellPackageUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, validatedAssistantMessage, } from "./shell-components.js";
+export { OWNED_BUILTIN_SLASH_COMMANDS, PINNED_PI_BUILTIN_SLASH_COMMANDS, componentFromPort, componentPort, createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellModelsDialog, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellShowImagesSelector, createPiShellSkillsSelector, createPiShellStatus, createPiShellThemeSelector, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, createTuiFacade, ensureTheme, formatSessionTokens, isAutocompleteProvider, isPiPromptStyleCompaction, isRecord, paintPiSubmittedPromptTimestamp, piShellHyperlink, piShellTruncateToWidth, piShellVisibleWidth, renderPiShellChangelogLines, renderPiShellCommandMessage, renderPiShellHotkeysLines, renderPiShellPackageUpdateNotice, renderPiShellReleaseUpdateBanner, renderPiShellReleaseUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, validatedAssistantMessage, } from "./shell-components.js";
 export { renderPiShellHotkeySections } from "./shell-hotkey-sections.js";
 export type { PiShellHotkeySection } from "./shell-hotkey-sections.js";
 export type { PiExtensionUiBridge, PiExtensionUiBridgeHost, PiShellAuthProviderOption, PiShellAutocompleteCommand, PiShellClipboardContent, PiShellCommandMessagePresentation, PiShellComponentPort, PiShellEditorBodyGeometry, PiShellEditorOptions, PiShellEditorPointerEvent, PiShellEditorPort, PiShellEditorTextRange, PiShellExtensionRendererResolver, PiShellHeaderOptions, PiShellHeaderPort, PiShellHotkeysPresentation, PiShellImageAssetResolver, PiShellLoadedResourcesPort, PiShellLoginDialogPort, PiShellModelSelectorOptions, PiShellModelsDialogOptions, PiShellModelsDialogPort, PiShellOperationLoaderPort, PiShellPasteReservation, PiShellQueuedInputPort, PiShellResourceEntry, PiShellResourceSection, PiShellScopedModelDescriptor, PiShellScopedModelsSelectorOptions, PiShellScopedModelsSelectorPort, PiShellSelectorOption, PiShellSelectorOptions, PiShellSessionInfoPresentation, PiShellSettingsSelectorOptions, PiShellStartupNotice, PiShellStatusPlacement, PiShellStatusPort, PiShellSubmittedPromptComposer, PiShellTranscriptComponentPort, PiShellViewComponentPort, } from "./shell-components.js";

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

@@ -1,7 +1,7 @@
 export { adaptPiAssistantMessage, adaptPiToolExecution, adaptPiUserMessage } from "./components.js";
 export { loadHistoryEditor } from "./history-editor-loader.js";
 export { PiComponentConformanceError, runPiComponentConformance } from "./conformance.js";
-export { OWNED_BUILTIN_SLASH_COMMANDS, PINNED_PI_BUILTIN_SLASH_COMMANDS, componentFromPort, componentPort, createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellModelsDialog, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellShowImagesSelector, createPiShellSkillsSelector, createPiShellStatus, createPiShellThemeSelector, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, createTuiFacade, ensureTheme, formatSessionTokens, isAutocompleteProvider, isPiPromptStyleCompaction, isRecord, paintPiSubmittedPromptTimestamp, piShellHyperlink, piShellTruncateToWidth, piShellVisibleWidth, renderPiShellChangelogLines, renderPiShellCommandMessage, renderPiShellHotkeysLines, renderPiShellPackageUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, validatedAssistantMessage, } from "./shell-components.js";
+export { OWNED_BUILTIN_SLASH_COMMANDS, PINNED_PI_BUILTIN_SLASH_COMMANDS, componentFromPort, componentPort, createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellModelsDialog, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellShowImagesSelector, createPiShellSkillsSelector, createPiShellStatus, createPiShellThemeSelector, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, createTuiFacade, ensureTheme, formatSessionTokens, isAutocompleteProvider, isPiPromptStyleCompaction, isRecord, paintPiSubmittedPromptTimestamp, piShellHyperlink, piShellTruncateToWidth, piShellVisibleWidth, renderPiShellChangelogLines, renderPiShellCommandMessage, renderPiShellHotkeysLines, renderPiShellPackageUpdateNotice, renderPiShellReleaseUpdateBanner, renderPiShellReleaseUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, validatedAssistantMessage, } from "./shell-components.js";
 export { renderPiShellHotkeySections } from "./shell-hotkey-sections.js";
 export { PINNED_PI_LAYOUT, applyConfiguredPiTheme, applyPiTheme, applyPiThemeInstance, currentPiThemeName, detectPiTerminalBackgroundFromEnv, detectPiTerminalBackgroundTheme, detectPiTerminalThemeForAuto, ensurePiTheme, getAvailablePiThemes, loadPiTheme, onPiThemeChange, parsePiAutoThemeSetting, piTheme, resolvePiThemeSetting, stopPiThemeWatcher, } from "./theme.js";
 export { OwnedPiThemeController } from "./upstream/theme/theme-controller.js";

package/dist/integrations/pi/components/prompt-chip-presentation.d.ts

@@ -0,0 +1,3 @@
+import { type PromptChipWrapProtection } from "../../../contracts/owned-ui/index.js";
+/** Keeps fitting chips atomic and presents an oversized chip as one width-bounded ellipsized token. */
+export declare function protectPiPromptChipPresentation(text: string, width: number): PromptChipWrapProtection;

package/dist/integrations/pi/components/prompt-chip-presentation.js

@@ -0,0 +1,14 @@
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import { protectPromptChipWrapping } from "../../../contracts/owned-ui/index.js";
+/** Keeps fitting chips atomic and presents an oversized chip as one width-bounded ellipsized token. */
+export function protectPiPromptChipPresentation(text, width) {
+    const available = Math.max(1, width);
+    return protectPromptChipWrapping(text, chip => truncateChip(chip, available));
+}
+function truncateChip(chip, width) {
+    if (visibleWidth(chip) <= width)
+        return chip;
+    if (width < 3)
+        return "…";
+    return `${truncateToWidth(chip.slice(0, -1), width - 2, "")}…]`;
+}

package/dist/integrations/pi/components/shell-footer-status.js

@@ -3,6 +3,7 @@ import { Spacer, Text, } from "@earendil-works/pi-tui";
 import { SessionFooter } from "./upstream/components/session-footer.js";
 import { KeybindingsManager } from "./upstream/adjacent/core/keybindings.js";
 import { StatusIndicator, WorkingStatusIndicator } from "./upstream/components/status-indicator.js";
+import { protectPiPromptChipPresentation } from "./prompt-chip-presentation.js";
 import { PINNED_PI_LAYOUT, piTheme, } from "./theme.js";
 import { createTuiFacade, ensureTheme, } from "./shell-shared-facade.js";
 export function createPiShellHeader(options = {}) {
@@ -74,14 +75,15 @@ export function createPiShellStatus(view, progressStatus, runtime) {
     ensureTheme();
     const statusUi = createTuiFacade(runtime ?? { getColumns: () => 80, getRows: () => 24, requestRender() { } });
     let workingOverride;
+    let workingOverrideActive = false;
     let outputPad = PINNED_PI_LAYOUT.outputPad;
     let progressPresentation = "pinned";
-    let placement = statusPlacement(view, workingOverride);
+    let placement = statusPlacement(view, workingOverride, workingOverrideActive);
     const liveStatusText = () => progressStatus.text(liveWorkingText(view, workingOverride, progressPresentation), progressPresentation);
     let component = statusComponent(view, statusUi, outputPad, liveStatusText, placement, progressPresentation, progressStatus);
     let signature = statusSignature(view, workingOverride, outputPad, placement, progressPresentation);
     const rebuild = () => {
-        const nextPlacement = statusPlacement(view, workingOverride);
+        const nextPlacement = statusPlacement(view, workingOverride, workingOverrideActive);
         const nextSignature = statusSignature(view, workingOverride, outputPad, nextPlacement, progressPresentation);
         if (nextSignature === signature)
             return;
@@ -112,8 +114,9 @@ export function createPiShellStatus(view, progressStatus, runtime) {
             view = next;
             rebuild();
         },
-        setWorkingOverride(message) {
+        setWorkingOverride(message, active = false) {
             workingOverride = message;
+            workingOverrideActive = active && message !== undefined;
             rebuild();
         },
         setOutputPad(padding) {
@@ -143,20 +146,28 @@ export function createPiShellFooter(view, cwd, profile = "pi", showLevel = () =>
 }
 export function createPiQueuedInputStatus(submissions, presentation = "pinned", getKeybindings) {
     let renderedText = queuedInputText(submissions, presentation, getKeybindings?.());
+    let chipWrapping = { text: renderedText, restore: value => value };
+    let protectedWidth;
     const text = new Text(renderedText, 1, 0);
     const refresh = () => {
         const next = queuedInputText(submissions, presentation, getKeybindings?.());
         if (next === renderedText)
             return;
         renderedText = next;
-        text.setText(next);
+        protectedWidth = undefined;
     };
     return {
         render(width) {
             if (submissions.length === 0)
                 return [];
             refresh();
-            return text.render(width);
+            const contentWidth = queuedTextContentWidth(width);
+            if (contentWidth !== protectedWidth) {
+                chipWrapping = queuedInputChipWrapping(renderedText, presentation, contentWidth);
+                text.setText(chipWrapping.text);
+                protectedWidth = contentWidth;
+            }
+            return text.render(width).map(row => chipWrapping.restore(row));
         },
         invalidate: () => text.invalidate(),
         update(next) {
@@ -165,10 +176,11 @@ export function createPiQueuedInputStatus(submissions, presentation = "pinned",
         },
     };
 }
-function statusPlacement(view, workingOverride) {
-    // Invariant: live spinner placement follows semantic lifecycle, not text. An extension
-    // override is visible only when its lifecycle is busy, so a stale override cannot spin
-    // after completion or make an idle informational status scrollable.
+function statusPlacement(view, workingOverride, workingOverrideActive) {
+    // Invariant: extension text alone cannot create a live spinner. A shell-owned operation may
+    // explicitly own the brief interval before the engine lifecycle itself becomes busy.
+    if (workingOverrideActive && workingOverride !== undefined)
+        return "live";
     if (view.lifecycle === "busy")
         return "live";
     if (view.lifecycle === "failed")
@@ -214,6 +226,15 @@ function statusSignature(view, workingOverride, outputPad, placement, progressPr
     const message = withMessage ? `${workingOverride ?? ""}\u0000${view.status.workingMessage ?? ""}\u0000${view.status.workingProgress ?? ""}` : "";
     return `${placement}\u0000${outputPad}\u0000${view.lifecycle}\u0000${progressPresentation}\u0000${message}\u0000${view.status.diagnostics.at(-1) ?? ""}`;
 }
+function queuedInputChipWrapping(text, presentation, width) {
+    return presentation === "custom-viewport"
+        ? protectPiPromptChipPresentation(text, width)
+        : { text, restore: value => value };
+}
+function queuedTextContentWidth(width) {
+    const padding = Math.min(1, Math.max(0, Math.floor((width - 1) / 2)));
+    return Math.max(1, width - padding * 2);
+}
 function queuedInputText(submissions, presentation, bindings) {
     if (submissions.length === 0)
         return "";

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

@@ -71,3 +71,39 @@ export declare function createPiShellHotkeys(bindings?: KeybindingsConfig, getSh
 /** 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;
+/**
+ * Pinned Pi's `showPackageUpdateNotification` banner: warning-coloured dynamic
+ * borders around a bold warning title, the muted update instruction with the
+ * accent command, and the package list.
+ */
+export declare function renderPiShellPackageUpdateNotice(packages: readonly string[], width: number): readonly string[];
+/**
+ * Pinned Pi's `showNewVersionNotification` banner, naming A1's update command: warning-coloured
+ * dynamic borders around a bold warning title, the muted instruction with the accent command, and
+ * for stable releases the muted changelog label with an accent hyperlink.
+ */
+export declare function renderPiShellReleaseUpdateNotice(release: {
+    readonly version: string;
+    readonly command: string;
+    readonly changelogUrl: string | null;
+}, width: number): readonly string[];
+export interface PiShellReleaseUpdateBanner {
+    readonly rows: readonly string[];
+    /** Clickable close area: zero-based rows within `rows`, one-based inclusive columns. */
+    readonly close: {
+        readonly rowStart: number;
+        readonly rowEnd: number;
+        readonly columnStart: number;
+        readonly columnEnd: number;
+    };
+}
+/**
+ * Bare A1's docked variant of the release notice: Pi's notice wording and colours on the prompt
+ * band's background instead of borders, so it spans the same width as the editor rules, with a
+ * minimal close glyph at the right end of the title row, matching the settings screen's controls.
+ */
+export declare function renderPiShellReleaseUpdateBanner(release: {
+    readonly version: string;
+    readonly command: string;
+    readonly changelogUrl: string | null;
+}, width: number, closeHovered: boolean): PiShellReleaseUpdateBanner;

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

@@ -1,5 +1,6 @@
 import { DynamicBorder, getMarkdownTheme } from "../startup-public.js";
-import { Container, Markdown, Spacer, Text } from "@earendil-works/pi-tui";
+import { Container, getCapabilities, hyperlink, Markdown, Spacer, Text, visibleWidth } from "@earendil-works/pi-tui";
+import { PRODUCT_TEXT } from "../../../product-identity.js";
 import { KeybindingsManager } from "./upstream/adjacent/core/keybindings.js";
 import { PINNED_PI_LAYOUT, piTheme } from "./theme.js";
 import { componentPort, ensureTheme, formatSessionTokens } from "./shell-shared-facade.js";
@@ -186,3 +187,78 @@ export function hotkeysMarkdown(bindings, getShortcuts, profile) {
     }
     return markdown;
 }
+/**
+ * Pinned Pi's `showPackageUpdateNotification` banner: warning-coloured dynamic
+ * borders around a bold warning title, the muted update instruction with the
+ * accent command, and the package list.
+ */
+export function renderPiShellPackageUpdateNotice(packages, width) {
+    ensureTheme();
+    const theme = piTheme();
+    const container = new Container();
+    container.addChild(new Spacer(1));
+    container.addChild(new DynamicBorder(text => theme.fg("warning", text)));
+    container.addChild(new Text(`${theme.bold(theme.fg("warning", "Package Updates Available"))}\n`
+        + `${theme.fg("muted", "Package updates are available. Run ")}${theme.fg("accent", `${PRODUCT_TEXT.commandName} pi update --extensions`)}\n`
+        + `${theme.fg("muted", "Packages:")}\n`
+        + packages.map(name => `- ${name}`).join("\n"), 1, 0));
+    container.addChild(new DynamicBorder(text => theme.fg("warning", text)));
+    return container.render(width);
+}
+/**
+ * Pinned Pi's `showNewVersionNotification` banner, naming A1's update command: warning-coloured
+ * dynamic borders around a bold warning title, the muted instruction with the accent command, and
+ * for stable releases the muted changelog label with an accent hyperlink.
+ */
+export function renderPiShellReleaseUpdateNotice(release, width) {
+    ensureTheme();
+    const theme = piTheme();
+    const container = new Container();
+    container.addChild(new Spacer(1));
+    container.addChild(new DynamicBorder(text => theme.fg("warning", text)));
+    container.addChild(new Text(`${theme.bold(theme.fg("warning", "Update Available"))}\n`
+        + `${theme.fg("muted", `New version ${release.version} is available. Run `)}${theme.fg("accent", release.command)}`, 1, 0));
+    if (release.changelogUrl !== null) {
+        const link = getCapabilities().hyperlinks
+            ? hyperlink(theme.fg("accent", release.changelogUrl), release.changelogUrl)
+            : theme.fg("accent", release.changelogUrl);
+        container.addChild(new Text(`${theme.fg("muted", "Changelog: ")}${link}`, 1, 0));
+    }
+    container.addChild(new DynamicBorder(text => theme.fg("warning", text)));
+    return container.render(width);
+}
+const BANNER_PADDING_X = 2;
+/**
+ * Bare A1's docked variant of the release notice: Pi's notice wording and colours on the prompt
+ * band's background instead of borders, so it spans the same width as the editor rules, with a
+ * minimal close glyph at the right end of the title row, matching the settings screen's controls.
+ */
+export function renderPiShellReleaseUpdateBanner(release, width, closeHovered) {
+    ensureTheme();
+    const theme = piTheme();
+    const bandBg = (text) => theme.bg("userMessageBg", text);
+    const title = theme.bold(theme.fg("warning", "Update Available"));
+    // Compatibility: paints like the settings stepper controls: dim at rest, plain text under the pointer.
+    const close = closeHovered ? "✕" : theme.fg("dim", "✕");
+    // Rationale: a glyph looks inset by its own side bearing, so one trailing cell after it reads the same
+    // as the text's two leading cells.
+    const gap = Math.max(1, width - BANNER_PADDING_X - visibleWidth(title) - 2);
+    const closeColumn = BANNER_PADDING_X + visibleWidth(title) + gap + 1;
+    const titleRow = bandBg(`${" ".repeat(BANNER_PADDING_X)}${title}${" ".repeat(gap)}${close} `);
+    const body = [
+        `${theme.fg("muted", `New version ${release.version} is available. Run `)}${theme.fg("accent", release.command)}`,
+    ];
+    if (release.changelogUrl !== null) {
+        const link = getCapabilities().hyperlinks
+            ? hyperlink(theme.fg("accent", release.changelogUrl), release.changelogUrl)
+            : theme.fg("accent", release.changelogUrl);
+        body.push(`${theme.fg("muted", "Changelog: ")}${link}`);
+    }
+    const padding = bandBg(" ".repeat(width));
+    // Invariant: rows are a leading spacer, the band's top padding, then the title row. Hover and click
+    // share one area, the glyph and one cell either side, so what lights up is exactly what closes.
+    return {
+        rows: ["", padding, titleRow, ...new Text(body.join("\n"), BANNER_PADDING_X, 0, bandBg).render(width), padding],
+        close: { rowStart: 2, rowEnd: 2, columnStart: closeColumn - 1, columnEnd: Math.min(width, closeColumn + 1) },
+    };
+}

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

@@ -19,11 +19,5 @@ export declare function renderPiShellStartupDiagnostic(diagnostic: {
     readonly severity: "info" | "warning" | "error";
     readonly message: string;
 }, width: number): readonly string[];
-/**
- * Pinned Pi's `showPackageUpdateNotification` banner: warning-coloured dynamic
- * borders around a bold warning title, the muted update instruction with the
- * accent command, and the package list.
- */
-export declare function renderPiShellPackageUpdateNotice(packages: readonly string[], width: number): readonly string[];
 type PiAssistantMessage = NonNullable<ConstructorParameters<typeof AssistantMessageComponent>[0]>;
 export declare function validatedAssistantMessage(block: OwnedUiTranscriptBlock): PiAssistantMessage;