@timurproko/a1 0.1.8-dev.299 → 0.1.8-dev.322

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

@@ -1,10 +1,28 @@
 // Mechanically adapted from Pi commit 914cf14
 // packages/coding-agent/src/modes/interactive/components/earendil-announcement.ts (MIT).
-// Local modifications: remap private imports to public package-root/owned theme boundaries and omit optional package-private imagery.
-import { Container, Spacer, Text } from "#pi-tui";
+// Local modifications: remap private imports to public package-root/owned theme boundaries; load the verified owned copy of the image lazily.
+import { readFileSync } from "node:fs";
+import { Container, Image, Spacer, Text } from "#pi-tui";
 import { DynamicBorder } from "@earendil-works/pi-coding-agent";
 import { piTheme } from "../theme/theme.js";
 const BLOG_URL = "https://mariozechner.at/posts/2026-04-08-ive-sold-out/";
+const IMAGE_FILENAME = "clankolas.png";
+let cachedImageBase64;
+let attemptedImageLoad = false;
+function loadImageBase64() {
+    if (attemptedImageLoad)
+        return cachedImageBase64;
+    attemptedImageLoad = true;
+    try {
+        const resource = JSON.parse(readFileSync(new URL("../assets/earendil-image.json", import.meta.url), "utf8"));
+        if (resource && typeof resource === "object" && "data" in resource && typeof resource.data === "string")
+            cachedImageBase64 = resource.data;
+    }
+    catch {
+        cachedImageBase64 = undefined;
+    }
+    return cachedImageBase64;
+}
 export class EarendilAnnouncementComponent extends Container {
     constructor() {
         super();
@@ -14,6 +32,11 @@ export class EarendilAnnouncementComponent extends Container {
         this.addChild(new Text(piTheme().fg("muted", "Read the blog post:"), 1, 0));
         this.addChild(new Text(piTheme().fg("mdLink", BLOG_URL), 1, 0));
         this.addChild(new Spacer(1));
+        const imageBase64 = loadImageBase64();
+        if (imageBase64) {
+            this.addChild(new Image(imageBase64, "image/png", { fallbackColor: text => piTheme().fg("muted", text) }, { maxWidthCells: 56, filename: IMAGE_FILENAME }));
+            this.addChild(new Spacer(1));
+        }
         this.addChild(new DynamicBorder((text) => piTheme().fg("accent", text)));
     }
 }

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

@@ -1,5 +1,5 @@
 import type { PiSessionForkPrompt, PiSessionSelection } from "./session-selection.js";
-import { type AgentSessionRuntime, type AgentSessionServices, type SessionInfo } from "@earendil-works/pi-coding-agent";
+import { type AgentSession, type AgentSessionRuntime, type AgentSessionServices, type SessionInfo } from "@earendil-works/pi-coding-agent";
 import { OWNED_UI_EXTENSION_CONTRACT_VERSION, OWNED_UI_EXTENSION_RENDER_CALLBACKS, OWNED_UI_EXTENSION_UI_CALLBACKS, OWNED_UI_EXTENSION_UI_PROPERTIES, type OwnedUiCommand, type OwnedUiCommandOutcome, type OwnedUiImageAttachment, type OwnedUiPromptSuggestionGeneratorPort, type OwnedUiPromptSuggestionRequest, type OwnedUiPromptSuggestionResult, type OwnedUiEvent, type OwnedUiSessionViewModel, type OwnedUiSnapshot } from "../../../contracts/owned-ui/index.js";
 import { type PiAuthenticationProviderOption, type PiBashWorkflowResult, type PiPinnedSettingsCallback, type PiPinnedSettingsSnapshot, type PiWorkflowAutocompleteCommand, type PiWorkflowHost, type PiWorkflowInteractionHost, type PiWorkflowOption, type PiWorkflowRequest, type PiWorkflowResult } from "./workflows.js";
 import { PiSettingsIntegration } from "./settings-integration.js";
@@ -176,16 +176,28 @@ export declare class PiEngineAdapter implements OwnedUiPromptSuggestionGenerator
         readonly title: string;
         readonly options: readonly PiWorkflowOption[];
     };
+    pinnedAmbientAuthentication(selection: string): {
+        readonly providerId: string;
+        readonly providerName: string;
+        readonly title: string;
+        readonly message: string;
+    } | null;
     pinnedLogoutOptions(): Promise<readonly PiAuthenticationProviderOption[]>;
     pinnedForkOptions(): readonly PiWorkflowOption[];
     pinnedTreeSelectorContext(): PiTreeSelectorContext;
     pinnedSettingsSnapshot(): PiPinnedSettingsSnapshot;
     pinnedMessageRenderer(customType: string): unknown;
+    pinnedShortcutDescriptions(bindings: Parameters<AgentSession["extensionRunner"]["getShortcuts"]>[0]): readonly {
+        readonly key: string;
+        readonly description: string;
+    }[];
     pinnedToolDefinition(toolName: string): unknown;
+    copyWorkflowText(text: string): Promise<void>;
     clearQueuedWorkflows(): readonly string[];
     abortBashWorkflow(): void;
     executeBashWorkflow(command: string, excludeFromContext: boolean): Promise<PiBashWorkflowResult>;
     applyPinnedSettingValue(callback: PiPinnedSettingsCallback, value: unknown): Promise<PiWorkflowResult>;
+    reloadBlockedResult(): PiWorkflowResult | null;
     executeWorkflow(request: PiWorkflowRequest): Promise<PiWorkflowResult>;
     view(): OwnedUiSessionViewModel;
     snapshot(): OwnedUiSnapshot;

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

@@ -7,6 +7,7 @@ import { dirname, join, resolve } from "node:path";
 import { promisify } from "node:util";
 import { PRODUCT_IDENTITY } from "../../../product-identity.js";
 import { configureOwnedHttpDispatcher } from "./http-dispatcher.js";
+import { readPinnedCommandChangelog } from "./changelog.js";
 import { copyToClipboard, CredentialSynchronizationError, DefaultPackageManager, getAgentDir, ProjectTrustStore, SessionManager, VERSION, } from "@earendil-works/pi-coding-agent";
 import { OWNED_UI_EXTENSION_CONTRACT_VERSION, OWNED_UI_EXTENSION_RENDER_CALLBACKS, OWNED_UI_EXTENSION_UI_CALLBACKS, OWNED_UI_EXTENSION_UI_PROPERTIES, CONTEXTUAL_PROMPT_SUGGESTION_INSTRUCTION, assertOwnedUiCommand, assertOwnedUiExtensionUiPort, assertOwnedUiPromptSuggestionRequest, assertOwnedUiPromptSuggestionResult, assertOwnedUiSnapshot, normalizePromptSuggestionCandidate, } from "../../../contracts/owned-ui/index.js";
 import { PINNED_PI_SETTINGS_CALLBACKS, PINNED_PI_WORKFLOW_COMMAND_NAMES, } from "./workflows.js";
@@ -308,14 +309,22 @@ export class PiEngineAdapter {
         if (!settingsManager || typeof settingsManager.getLastChangelogVersion !== "function"
             || typeof settingsManager.setLastChangelogVersion !== "function")
             return;
-        if (settingsManager.getLastChangelogVersion() === VERSION)
+        if ((this.#session?.messages.length ?? 0) > 0)
             return;
-        const markdown = await this.#workflowHost.readChangelog().catch(() => "");
+        const lastVersion = settingsManager.getLastChangelogVersion();
+        if (lastVersion === VERSION)
+            return;
+        if (!lastVersion) {
+            settingsManager.setLastChangelogVersion(VERSION);
+            await settingsManager.flush();
+            return;
+        }
+        const markdown = await this.#workflowHost.readChangelog(lastVersion).catch(() => "");
         if (markdown.trim().length > 0) {
             this.#addDiagnostic("info", settingsManager.getCollapseChangelog() ? "changelog-collapsed" : "changelog-expanded", markdown, true);
+            settingsManager.setLastChangelogVersion(VERSION);
+            await settingsManager.flush();
         }
-        settingsManager.setLastChangelogVersion(VERSION);
-        await settingsManager.flush();
     }
     async #announcePackageUpdates(settingsManager) {
         if (process.env.PI_OFFLINE)
@@ -877,6 +886,17 @@ export class PiEngineAdapter {
         }));
         return { title: `Select authentication method for ${providerName}:`, options };
     }
+    pinnedAmbientAuthentication(selection) {
+        if (!selection.startsWith("api_key:"))
+            return null;
+        const providerId = selection.slice("api_key:".length);
+        const provider = this.#runtime?.services.modelRuntime.getProvider?.(providerId);
+        const method = dynamicObject(dynamicObject(provider, "auth"), "apiKey");
+        if (!method || typeof method.login === "function")
+            return null;
+        const providerName = stringProperty(provider, "name") ?? providerId;
+        return { providerId, providerName, title: `${providerName} setup`, message: `${stringProperty(method, "name") ?? "Authentication"} is configured outside pi.` };
+    }
     pinnedLogoutOptions() {
         return this.#logoutOptions();
     }
@@ -957,9 +977,16 @@ export class PiEngineAdapter {
     pinnedMessageRenderer(customType) {
         return this.#requireWorkflowSession().extensionRunner?.getMessageRenderer?.(customType);
     }
+    pinnedShortcutDescriptions(bindings) {
+        const shortcuts = this.#requireWorkflowSession().extensionRunner?.getShortcuts?.(bindings);
+        return shortcuts === undefined ? [] : [...shortcuts].map(([key, shortcut]) => ({ key, description: shortcut.description ?? shortcut.extensionPath }));
+    }
     pinnedToolDefinition(toolName) {
         return this.#requireWorkflowSession().extensionRunner?.getToolDefinition?.(toolName);
     }
+    async copyWorkflowText(text) {
+        await this.#workflowHost.copyText(text);
+    }
     clearQueuedWorkflows() {
         const session = this.#requireWorkflowSession();
         const result = session.clearQueue?.();
@@ -992,6 +1019,14 @@ export class PiEngineAdapter {
             return workflowResult("settings", "failed", error instanceof Error ? error.message : String(error));
         }
     }
+    reloadBlockedResult() {
+        const session = this.#requireWorkflowSession();
+        if (session.isStreaming)
+            return workflowResult("reload", "failed", "Wait for the current response to finish before reloading.", undefined, "warning");
+        if (session.isCompacting)
+            return workflowResult("reload", "failed", "Wait for compaction to finish before reloading.", undefined, "warning");
+        return null;
+    }
     async executeWorkflow(request) {
         try {
             return await this.#performWorkflow(request);
@@ -999,7 +1034,7 @@ export class PiEngineAdapter {
         catch (error) {
             const message = error instanceof Error ? error.message : String(error);
             const contextualMessage = request.command === "export"
-                ? `Failed to export session: ${message}`
+                ? `Failed to export session: ${errorMessage(error, "Unknown error")}`
                 : request.command === "import"
                     ? `Failed to import session: ${message}`
                     : request.command === "new"
@@ -1133,8 +1168,18 @@ export class PiEngineAdapter {
                     : [...(runtime.services.modelRuntime.getAvailableSnapshot?.() ?? [])];
                 let model = findExactWorkflowModel(reference, availableModels);
                 const messages = [];
+                const generation = this.#sessionGeneration;
+                const current = () => !this.#disposed && generation === this.#sessionGeneration;
+                const publish = (message) => {
+                    if (!current())
+                        return;
+                    if (this.#workflowInteraction.publish)
+                        this.#workflowInteraction.publish(message);
+                    else
+                        messages.push(message);
+                };
                 if (model === undefined && scopedModels.length === 0) {
-                    messages.push({ kind: "status", message: "Refreshing model catalogs…" });
+                    publish({ kind: "status", message: "Refreshing model catalogs…" });
                     const controller = new AbortController();
                     let timedOut = false;
                     const timeout = setTimeout(() => {
@@ -1144,14 +1189,14 @@ export class PiEngineAdapter {
                     try {
                         const refreshed = await runtime.services.modelRuntime.refresh?.({ signal: controller.signal });
                         if (isRecord(refreshed) && refreshed.aborted === true && timedOut) {
-                            messages.push({ kind: "warning", message: "Model refresh timed out; searching cached models." });
+                            publish({ kind: "warning", message: "Model refresh timed out; searching cached models." });
                         }
                         else if (isRecord(refreshed) && refreshed.errors instanceof Map && refreshed.errors.size > 0) {
-                            messages.push({ kind: "warning", message: `Could not refresh ${[...refreshed.errors.keys()].join(", ")}; searching cached models.` });
+                            publish({ kind: "warning", message: `Could not refresh ${[...refreshed.errors.keys()].join(", ")}; searching cached models.` });
                         }
                     }
                     catch (error) {
-                        messages.push({
+                        publish({
                             kind: "warning",
                             message: timedOut
                                 ? "Model refresh timed out; searching cached models."
@@ -1164,13 +1209,25 @@ export class PiEngineAdapter {
                     availableModels = [...(runtime.services.modelRuntime.getAvailableSnapshot?.() ?? [])];
                     model = findExactWorkflowModel(reference, availableModels);
                 }
+                if (!current())
+                    return workflowResult(request.command, "cancelled", "Model selection cancelled", undefined, "silent");
                 if (model === undefined) {
                     return {
                         ...workflowResult(request.command, "requires-selection", "Select a model", reference, "silent"),
                         ...(messages.length === 0 ? {} : { messages: Object.freeze(messages) }),
                     };
                 }
-                await session.setModel(model);
+                try {
+                    await session.setModel(model);
+                }
+                catch (error) {
+                    if (!current())
+                        return workflowResult(request.command, "cancelled", "Model selection cancelled", undefined, "silent");
+                    const failure = { kind: "error", message: error instanceof Error ? error.message : String(error) };
+                    return workflowResult(request.command, "failed", failure.message, undefined, "error", messages.length === 0 ? undefined : [...messages, failure]);
+                }
+                if (!current())
+                    return workflowResult(request.command, "cancelled", "Model selection cancelled", undefined, "silent");
                 const providerId = stringProperty(model, "provider") ?? "unknown";
                 const modelId = stringProperty(model, "id") ?? reference;
                 this.#activeModel = { providerId, modelId, displayName: stringProperty(model, "name") ?? modelId };
@@ -1226,9 +1283,8 @@ export class PiEngineAdapter {
                 const signal = request.signal;
                 if (signal?.aborted)
                     return workflowResult(request.command, "cancelled", "Share cancelled", undefined, "status");
-                let auth;
                 try {
-                    auth = await this.#workflowHost.runCommand("gh", ["auth", "status"], signal === undefined ? undefined : { signal });
+                    await this.#workflowHost.runCommand("gh", ["auth", "status"], signal === undefined ? undefined : { signal });
                 }
                 catch (error) {
                     if (signal?.aborted || isAbortError(error))
@@ -1238,9 +1294,6 @@ export class PiEngineAdapter {
                         : "GitHub CLI is not logged in. Run 'gh auth login' first.";
                     return workflowResult(request.command, "failed", message);
                 }
-                if (auth.stderr && !auth.stdout) {
-                    return workflowResult(request.command, "failed", "GitHub CLI is not logged in. Run 'gh auth login' first.");
-                }
                 const temporary = join(tmpdir(), `${PRODUCT_IDENTITY.filesystem.temporaryPrefix}pi-session-${process.pid}.html`);
                 try {
                     try {
@@ -1258,13 +1311,10 @@ export class PiEngineAdapter {
                     catch (error) {
                         if (signal?.aborted || isAbortError(error))
                             return workflowResult(request.command, "cancelled", "Share cancelled", undefined, "status");
-                        return workflowResult(request.command, "failed", `Failed to create gist: ${errorMessage(error, "Unknown error")}`);
+                        return workflowResult(request.command, "failed", `Failed to create gist: ${shareCommandFailureDetail(error)}`);
                     }
                     if (signal?.aborted)
                         return workflowResult(request.command, "cancelled", "Share cancelled", undefined, "status");
-                    if (gist.stderr && !gist.stdout) {
-                        return workflowResult(request.command, "failed", `Failed to create gist: ${gist.stderr.trim() || "Unknown error"}`);
-                    }
                     const gistUrl = gist.stdout.trim();
                     const gistId = gistUrl.split("/").at(-1);
                     if (!gistId)
@@ -1497,13 +1547,17 @@ export class PiEngineAdapter {
                 }
             }
             case "reload": {
-                if (session.isStreaming)
-                    return workflowResult(request.command, "failed", "Wait for the current response to finish before reloading.", undefined, "warning");
-                if (session.isCompacting)
-                    return workflowResult(request.command, "failed", "Wait for compaction to finish before reloading.", undefined, "warning");
+                const blocked = this.reloadBlockedResult();
+                if (blocked)
+                    return blocked;
                 await requireCapability(session.reload, "reload").call(session);
                 await this.#bindExtensionUiToSession();
-                return workflowResult(request.command, "completed", "Reloaded keybindings, extensions, skills, prompts, themes, and context files");
+                const message = "Reloaded keybindings, extensions, skills, prompts, themes, and context files";
+                const modelError = runtime.services.modelRuntime.getError?.();
+                return workflowResult(request.command, "completed", message, undefined, "status", modelError ? [
+                    { kind: "error", message: `models.json error: ${modelError}` },
+                    { kind: "status", message },
+                ] : undefined);
             }
             case "quit": {
                 await this.dispose();
@@ -2698,7 +2752,7 @@ function defaultWorkflowHost() {
             const result = await execFileAsync(command, [...arguments_], { encoding: "utf8", signal: options?.signal });
             return { stdout: result.stdout, stderr: result.stderr };
         },
-        readChangelog: async () => "No changelog entries found.",
+        readChangelog: readPinnedCommandChangelog,
     };
 }
 function workflowLoginNotification(event) {
@@ -2757,6 +2811,13 @@ function workflowConfirmation(command, message, detail) {
 function errorMessage(error, fallback) {
     return error instanceof Error ? error.message : fallback;
 }
+function shareCommandFailureDetail(error) {
+    // Compatibility: Pi reports a failed child's stderr, not execFile's command wrapper.
+    if (isRecord(error) && (typeof error.code === "number" || typeof error.signal === "string") && typeof error.stderr === "string") {
+        return error.stderr.trim() || "Unknown error";
+    }
+    return errorMessage(error, "Unknown error");
+}
 function commandMissing(error) {
     return isRecord(error) && error.code === "ENOENT";
 }

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

@@ -0,0 +1,2 @@
+export declare function readPinnedCommandChangelog(sinceVersion?: string): Promise<string>;
+export declare function formatPinnedCommandChangelog(content: string, sinceVersion?: string): string;

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

@@ -0,0 +1,63 @@
+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);
+    if (!existsSync(path))
+        return sinceVersion === undefined ? "No changelog entries found." : "";
+    try {
+        const resource = JSON.parse(await readFile(path, "utf8"));
+        if (!resource || typeof resource !== "object" || !("data" in resource) || typeof resource.data !== "string")
+            throw new TypeError("Invalid owned changelog resource");
+        const markdown = resource.data;
+        return formatPinnedCommandChangelog(markdown, sinceVersion);
+    }
+    catch (error) {
+        // Compatibility: Pi's data-file parser reports a warning and supplies an empty changelog.
+        console.error(`Warning: Could not parse changelog: ${error}`);
+        return sinceVersion === undefined ? "No changelog entries found." : "";
+    }
+}
+export 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) => {
+        const version = /^##\s+\[?(\d+)\.(\d+)\.(\d+)\]?/.exec(section);
+        return version ? [{ version: version.slice(1).map(Number), markdown: section.trim() }] : [];
+    });
+    if (sinceVersion !== undefined) {
+        const previous = sinceVersion.split(".").map(value => Number(value) || 0);
+        releases = releases.filter(release => {
+            for (let index = 0; index < 3; index++) {
+                const difference = release.version[index] - (previous[index] ?? 0);
+                if (difference !== 0)
+                    return difference > 0;
+            }
+            return false;
+        });
+    }
+    else
+        releases.reverse();
+    if (releases.length === 0)
+        return sinceVersion === undefined ? "No changelog entries found." : "";
+    return releases.map(release => release.markdown.replace(/(!?\[[^\]\n]+\]\()([^\s)]+)((?:\s+[^)]*)?\))/g, (_match, prefix, target, suffix) => `${prefix}${releaseLink(target, `v${release.version.join(".")}`)}${suffix}`)).join("\n\n");
+}
+function releaseLink(target, tag) {
+    const canonical = target
+        .replace(/^https:\/\/github\.com\/(?:badlogic|earendil-works)\/pi-mono(?=\/|$)/, REPOSITORY)
+        .replace(/^(https:\/\/github\.com\/earendil-works\/pi\/(?:blob|tree)\/)(?:main|master)\//, `$1${tag}/`);
+    if (/^(?:#|\/\/|[a-z][a-z0-9+.-]*:)/i.test(canonical))
+        return canonical;
+    const boundary = canonical.search(/[?#]/);
+    const path = boundary === -1 ? canonical : canonical.slice(0, boundary);
+    const suffix = boundary === -1 ? "" : canonical.slice(boundary);
+    if (!path)
+        return canonical;
+    const normalized = path.replaceAll("\\", "/");
+    const repositoryPath = posix.normalize(normalized.startsWith("/") ? normalized.replace(/^\/+/, "") : posix.join("packages/coding-agent", normalized));
+    if (repositoryPath === "." || repositoryPath === ".." || repositoryPath.startsWith("../"))
+        return canonical;
+    const route = path.endsWith("/") || !posix.basename(repositoryPath).includes(".") ? "tree" : "blob";
+    return `${REPOSITORY}/${route}/${tag}/${encodeURI(repositoryPath)}${suffix}`;
+}