@timurproko/a1 0.1.0 → 0.1.1-dev.10

package/dist/src/foundation/pi-engine-adapter/adapter.js

@@ -1,11 +1,15 @@
 import { execFile } from "node:child_process";
-import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { mkdir, rm, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { promisify } from "node:util";
-import { copyToClipboard, createAgentSessionFromServices, createAgentSessionRuntime, createAgentSessionServices, getAgentDir, getPackageDir, ProjectTrustStore, SessionManager, } from "@earendil-works/pi-coding-agent";
+import { PRODUCT_IDENTITY } from "../../product-identity.js";
+import { copyToClipboard, getAgentDir, ProjectTrustStore, SessionManager, } 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, assertOwnedUiCommand, assertOwnedUiExtensionUiPort, assertOwnedUiSnapshot, } from "../owned-ui-contracts/index.js";
 import { PINNED_PI_SETTINGS_CALLBACKS, PINNED_PI_WORKFLOW_COMMAND_NAMES, } from "./workflows.js";
+import { createPiRuntimeIntegration } from "./runtime-integration.js";
+import { PiSessionCommandIntegration } from "./session-integration.js";
+import { PiSettingsIntegration } from "./settings-integration.js";
 const execFileAsync = promisify(execFile);
 const DEFAULT_SURFACE = {
     columns: 100,
@@ -56,18 +60,21 @@ export class PiEngineAdapter {
     #eventQueue = [];
     #eventQueueProcessing;
     #droppedEventCount = 0;
-    #lastPrompt = null;
+    #sessionCommands;
     #gitBranch = null;
     #extensionUi;
     #extensionShutdown;
     #extensionBound = false;
     #disposed = false;
+    /** Lists the themes installed on this machine, when the caller supplies one. */
+    #availableThemes;
     constructor(options = {}) {
         this.#cwd = options.cwd ?? process.cwd();
         this.#agentDir = options.agentDir ?? getAgentDir();
         this.#sessionId = options.sessionId ?? "owned-session-1";
         this.#runtimeFactory = options.createRuntime ?? createDefaultPiRuntime;
         this.#workflowHost = options.workflowHost ?? defaultWorkflowHost();
+        this.#availableThemes = options.availableThemes ?? null;
         this.#workflowInteraction = { prompt: async () => null, notify() { } };
     }
     setWorkflowInteractionHost(interaction) {
@@ -279,8 +286,8 @@ export class PiEngineAdapter {
             uiProperties: OWNED_UI_EXTENSION_UI_PROPERTIES,
             renderCallbacks: OWNED_UI_EXTENSION_RENDER_CALLBACKS,
             diagnostic: this.#extensionBound
-                ? "Pinned public extension UI lifecycle is bound through the AddOne-owned bridge."
-                : "The complete AddOne-owned extension UI contract is available; the active session has not been bound to the owned UI bridge.",
+                ? `Pinned public extension UI lifecycle is bound through the ${PRODUCT_IDENTITY.displayName}-owned bridge.`
+                : `The complete ${PRODUCT_IDENTITY.displayName}-owned extension UI contract is available; the active session has not been bound to the owned UI bridge.`,
         };
     }
     async bindExtensionUi(ui, shutdown) {
@@ -342,7 +349,7 @@ export class PiEngineAdapter {
                 usedNames.add(name);
             }
         }
-        const extensionCommands = this.#session?.extensionRunner?.getCommands?.();
+        const extensionCommands = this.#session?.extensionRunner?.getRegisteredCommands?.();
         if (Array.isArray(extensionCommands)) {
             for (const command of extensionCommands.filter(isRecord)) {
                 const name = stringProperty(command, "name");
@@ -373,12 +380,33 @@ export class PiEngineAdapter {
             return workflowResult("model", "failed", error instanceof Error ? error.message : String(error));
         }
     }
+    /**
+     * The theme the engine is configured with, in the engine's own grammar: a
+     * theme's name, or a `light/dark` pair meaning "follow the terminal".
+     */
+    configuredTheme() {
+        return this.#runtime?.services.settingsManager.getThemeSetting();
+    }
+    /** Settings port for the live runtime, or null before the runtime is available. */
+    settingsPort() {
+        const settings = this.#runtime?.services.settingsManager;
+        if (!settings)
+            return null;
+        const session = this.#runtime?.session;
+        return new PiSettingsIntegration(settings, {
+            ...(this.#availableThemes === null ? {} : { themes: this.#availableThemes }),
+            thinkingLevels: () => {
+                const levels = session?.getAvailableThinkingLevels?.();
+                return Array.isArray(levels) ? levels.map(level => String(level)) : [];
+            },
+        });
+    }
     pinnedModelSelectorContext() {
         const session = this.#requireWorkflowSession();
         const runtime = this.#runtime;
         if (!runtime)
             throw new Error("engine runtime is unavailable");
-        const scoped = session.getScopedModels?.() ?? session.scopedModels;
+        const scoped = session.scopedModels;
         const modelRuntime = runtime.services.modelRuntime;
         const selectorRuntime = typeof modelRuntime.getAvailableSnapshot === "function"
             ? modelRuntime
@@ -393,7 +421,7 @@ export class PiEngineAdapter {
             ? settingsManager
             : { setDefaultModelAndProvider() { } };
         return {
-            currentModel: session.model,
+            currentModel: this.#activeModel === null ? undefined : session.model,
             settingsManager: selectorSettings,
             modelRuntime: selectorRuntime,
             scopedModels: Array.isArray(scoped) ? scoped : [],
@@ -455,7 +483,7 @@ export class PiEngineAdapter {
         if (!runtime)
             throw new Error("engine runtime is unavailable");
         const models = scopedModelRecords(runtime.services.modelRuntime);
-        const scoped = session.getScopedModels?.() ?? session.scopedModels;
+        const scoped = session.scopedModels;
         if (Array.isArray(scoped) && scoped.length > 0) {
             return {
                 models: models.map(item => item.descriptor),
@@ -535,8 +563,9 @@ export class PiEngineAdapter {
         const oauth = dynamicObject(dynamicObject(provider, "auth"), "oauth");
         const loginLabel = stringProperty(oauth, "loginLabel") ?? "Sign in with an account";
         const options = this.#loginOptions().filter(option => option.id.endsWith(`:${providerId}`)).map(option => ({
-            ...option,
+            id: option.id,
             label: option.id.startsWith("api_key:") ? "Sign in with an API key" : loginLabel,
+            ...(option.description === undefined ? {} : { description: option.description }),
         }));
         return { title: `Select authentication method for ${providerName}:`, options };
     }
@@ -594,7 +623,7 @@ export class PiEngineAdapter {
             thinkingLevel: readThinkingLevel(session.thinkingLevel),
             availableThinkingLevels: Array.isArray(levels) ? levels.map(readThinkingLevel) : ["off", "minimal", "low", "medium", "high", "xhigh"],
             currentTheme: setting(settings?.getThemeSetting, setting(settings?.getTheme, "dark")),
-            terminalTheme: setting(settings?.getTerminalTheme, "dark"),
+            terminalTheme: "dark",
             availableThemes: themes.length > 0 ? themes : ["dark", "light"],
             hideThinkingBlock: setting(settings?.getHideThinkingBlock, false),
             mermaidRenderingMode: setting(settings?.getMermaidRenderingMode, "off"),
@@ -683,7 +712,7 @@ export class PiEngineAdapter {
                 footer: {
                     branch: this.#gitBranch,
                     sessionName: this.#session?.sessionManager?.getSessionName() ?? null,
-                    availableProviderCount: new Set(this.#runtime?.services.modelRuntime.getAvailableSnapshot?.().map(model => model.provider).filter(provider => provider !== undefined) ?? []).size || 1,
+                    availableProviderCount: new Set(this.#runtime?.services.modelRuntime.getAvailableSnapshot?.().map(model => model.provider).filter(provider => provider !== undefined) ?? []).size,
                     extensionStatuses: [],
                 },
             },
@@ -824,7 +853,7 @@ export class PiEngineAdapter {
                 });
                 if (auth.stderr && !auth.stdout)
                     throw new Error(auth.stderr.trim());
-                const temporary = join(tmpdir(), `addone-pi-session-${process.pid}.html`);
+                const temporary = join(tmpdir(), `${PRODUCT_IDENTITY.filesystem.temporaryPrefix}pi-session-${process.pid}.html`);
                 try {
                     await requireCapability(session.exportToHtml, "exportToHtml").call(session, temporary);
                     const gist = await this.#workflowHost.runCommand("gh", ["gist", "create", "--public=false", temporary]);
@@ -983,6 +1012,8 @@ export class PiEngineAdapter {
                 finally {
                     this.#workflowInteraction.finishLogin?.();
                 }
+                this.#reconcileActiveModelAvailability();
+                this.#emitView();
                 return workflowResult(request.command, "completed", `Logged in to ${providerName}. Credentials saved to ${join(this.#agentDir, "auth.json")}`);
             }
             case "logout": {
@@ -993,6 +1024,8 @@ export class PiEngineAdapter {
                 await requireCapability(modelRuntime.logout, "logout").call(modelRuntime, providerId, { signal: AbortSignal.timeout(15_000) });
                 const provider = modelRuntime.getProvider?.(providerId);
                 const providerName = stringProperty(provider, "name") ?? providerId;
+                this.#reconcileActiveModelAvailability();
+                this.#emitView();
                 return workflowResult(request.command, "completed", credentialType === "api_key"
                     ? `Removed stored API key for ${providerName}. Environment variables and models.json config are unchanged.`
                     : `Logged out of ${providerName}`);
@@ -1083,7 +1116,10 @@ export class PiEngineAdapter {
     }
     #loginOptions(authType) {
         const runtime = this.#runtime;
-        const providers = runtime?.services.modelRuntime.getProviders?.();
+        const modelRuntime = runtime?.services.modelRuntime;
+        if (!modelRuntime)
+            return [];
+        const providers = modelRuntime.getProviders?.();
         if (!Array.isArray(providers))
             return [];
         return providers.filter(isRecord).flatMap(provider => {
@@ -1092,11 +1128,33 @@ export class PiEngineAdapter {
                 return [];
             const name = stringProperty(provider, "name") ?? id;
             const auth = isRecord(provider.auth) ? provider.auth : {};
+            const authStatus = modelRuntime.getProviderAuthStatus?.(id);
+            const source = authStatus?.label ?? authStatus?.source;
+            const status = authStatus?.configured === true
+                ? {
+                    type: modelRuntime.isUsingOAuth?.(id) === true ? "oauth" : "api_key",
+                    ...(source === undefined ? {} : { source }),
+                }
+                : undefined;
             return [
-                ...(authType !== "api_key" && auth.oauth ? [{ id: `oauth:${id}`, label: name, description: "Account / OAuth" }] : []),
-                ...(authType !== "oauth" && auth.apiKey ? [{ id: `api_key:${id}`, label: name, description: "API key" }] : []),
+                ...(authType !== "api_key" && auth.oauth ? [{
+                        id: `oauth:${id}`,
+                        providerId: id,
+                        label: name,
+                        description: "Account / OAuth",
+                        authType: "oauth",
+                        ...(status === undefined ? {} : { status }),
+                    }] : []),
+                ...(authType !== "oauth" && auth.apiKey ? [{
+                        id: `api_key:${id}`,
+                        providerId: id,
+                        label: name,
+                        description: "API key",
+                        authType: "api_key",
+                        ...(status === undefined ? {} : { status }),
+                    }] : []),
             ];
-        });
+        }).sort((left, right) => left.label.localeCompare(right.label));
     }
     async #logoutOptions() {
         const runtime = this.#runtime;
@@ -1114,17 +1172,17 @@ export class PiEngineAdapter {
             const provider = modelRuntime.getProvider?.(providerId);
             return [{
                     id: `${credentialType}:${providerId}`,
+                    providerId,
                     label: stringProperty(provider, "name") ?? providerId,
                     description: credentialType,
+                    authType: credentialType,
+                    status: { type: credentialType, source: "stored credential" },
                 }];
         });
     }
     async #sessionOptions() {
         const session = this.#requireWorkflowSession();
         const manager = session.sessionManager;
-        const runtimeSessions = await this.#runtime?.listSessions?.();
-        if (Array.isArray(runtimeSessions))
-            return sessionInfoOptions(runtimeSessions);
         const cwd = manager?.getCwd?.();
         const sessionDir = manager?.getSessionDir?.();
         if (typeof cwd !== "string")
@@ -1182,103 +1240,22 @@ export class PiEngineAdapter {
         if (!settings)
             return workflowResult("settings", "failed", "Settings are unavailable");
         const session = this.#requireWorkflowSession();
-        const apply = (setter, name) => requireCapability(setter, name).call(settings, selectedValue);
-        switch (callback) {
-            case "onAutoCompactChange":
-                session.setAutoCompactionEnabled?.(selectedValue);
-                apply(settings.setCompactionEnabled, "setCompactionEnabled");
-                break;
-            case "onThinkingLevelChange":
-                session.setThinkingLevel(selectedValue);
-                break;
-            case "onShowImagesChange":
-                apply(settings.setShowImages, "setShowImages");
-                break;
-            case "onImageWidthCellsChange":
-                apply(settings.setImageWidthCells, "setImageWidthCells");
-                break;
-            case "onAutoResizeImagesChange":
-                apply(settings.setImageAutoResize, "setImageAutoResize");
-                break;
-            case "onBlockImagesChange":
-                apply(settings.setBlockImages, "setBlockImages");
-                break;
-            case "onEnableSkillCommandsChange":
-                apply(settings.setEnableSkillCommands, "setEnableSkillCommands");
-                break;
-            case "onSteeringModeChange":
-                apply(settings.setSteeringMode, "setSteeringMode");
-                break;
-            case "onFollowUpModeChange":
-                apply(settings.setFollowUpMode, "setFollowUpMode");
-                break;
-            case "onTransportChange":
-                apply(settings.setTransport, "setTransport");
-                break;
-            case "onHttpIdleTimeoutMsChange":
-                apply(settings.setHttpIdleTimeoutMs, "setHttpIdleTimeoutMs");
-                break;
-            case "onThemeChange":
-                apply(settings.setTheme, "setTheme");
-                break;
-            case "onHideThinkingBlockChange":
-                apply(settings.setHideThinkingBlock, "setHideThinkingBlock");
-                break;
-            case "onMermaidRenderingModeChange":
-                apply(settings.setMermaidRenderingMode, "setMermaidRenderingMode");
-                break;
-            case "onShowCacheMissNoticesChange":
-                apply(settings.setShowCacheMissNotices, "setShowCacheMissNotices");
-                break;
-            case "onCollapseChangelogChange":
-                apply(settings.setCollapseChangelog, "setCollapseChangelog");
-                break;
-            case "onEnableInstallTelemetryChange":
-                apply(settings.setEnableInstallTelemetry, "setEnableInstallTelemetry");
-                break;
-            case "onQuietStartupChange":
-                apply(settings.setQuietStartup, "setQuietStartup");
-                break;
-            case "onDefaultProjectTrustChange":
-                apply(settings.setDefaultProjectTrust, "setDefaultProjectTrust");
-                break;
-            case "onDoubleEscapeActionChange":
-                apply(settings.setDoubleEscapeAction, "setDoubleEscapeAction");
-                break;
-            case "onTreeFilterModeChange":
-                apply(settings.setTreeFilterMode, "setTreeFilterMode");
-                break;
-            case "onShowHardwareCursorChange":
-                apply(settings.setShowHardwareCursor, "setShowHardwareCursor");
-                break;
-            case "onEditorPaddingXChange":
-                apply(settings.setEditorPaddingX, "setEditorPaddingX");
-                break;
-            case "onOutputPadChange":
-                apply(settings.setOutputPad, "setOutputPad");
-                break;
-            case "onAutocompleteMaxVisibleChange":
-                apply(settings.setAutocompleteMaxVisible, "setAutocompleteMaxVisible");
-                break;
-            case "onClearOnShrinkChange":
-                apply(settings.setClearOnShrink, "setClearOnShrink");
-                break;
-            case "onShowTerminalProgressChange":
-                apply(settings.setShowTerminalProgress, "setShowTerminalProgress");
-                break;
-            case "onTuiModeChange":
-                apply(settings.setTuiMode, "setTuiMode");
-                break;
-            case "onFullscreenExitOutputChange":
-                apply(settings.setFullscreenExitOutput, "setFullscreenExitOutput");
-                break;
-            case "onFullscreenScrollbarChange":
-                apply(settings.setFullscreenScrollbar, "setFullscreenScrollbar");
-                break;
-            case "onWarningsChange":
-                apply(settings.setWarnings, "setWarnings");
-                break;
-            default: return workflowResult("settings", "failed", `${settingLabel(callback)} is unavailable in this runtime`);
+        if (callback === "onThinkingLevelChange") {
+            if (!isThinkingLevel(selectedValue))
+                return workflowResult("settings", "failed", "Thinking level is invalid");
+            session.setThinkingLevel(selectedValue);
+        }
+        else {
+            const key = settingKeyForCallback(callback);
+            if (key === null)
+                return workflowResult("settings", "failed", `${settingLabel(callback)} is unavailable in this runtime`);
+            const value = agentJsonValue(selectedValue);
+            if (callback === "onAutoCompactChange") {
+                if (typeof value !== "boolean")
+                    return workflowResult("settings", "failed", "Auto compact value is invalid");
+                session.setAutoCompactionEnabled?.(value);
+            }
+            new PiSettingsIntegration(settings).writeSettingNow(key, value);
         }
         this.#emitView();
         return workflowResult("settings", "completed", `${settingLabel(callback)}: ${String(selectedValue)}`);
@@ -1289,34 +1266,20 @@ export class PiEngineAdapter {
         if (!runtime || !session)
             throw new Error("engine session is unavailable");
         switch (command.type) {
-            case "prompt": {
-                this.#lastPrompt = command.text;
-                await session.prompt(command.text, session.isStreaming ? { streamingBehavior: "followUp" } : undefined);
-                return;
-            }
+            case "prompt":
             case "steer":
-                this.#lastPrompt = command.text;
-                await session.steer(command.text);
-                return;
             case "follow-up":
-                this.#lastPrompt = command.text;
-                await session.followUp(command.text);
-                return;
             case "abort":
-                if (session.isRetrying)
-                    session.abortRetry();
-                if (session.isCompacting)
-                    session.abortCompaction();
-                await session.abort();
-                return;
             case "retry":
-                if (this.#lastPrompt === null)
-                    throw new Error("no previous prompt is available to retry");
-                await session.prompt(this.#lastPrompt, session.isStreaming ? { streamingBehavior: "followUp" } : undefined);
-                return;
-            case "compact":
-                await session.compact();
+            case "compact": {
+                const result = await this.#sessionCommands?.execute(command.type === "prompt" || command.type === "steer" || command.type === "follow-up"
+                    ? { type: command.type, text: command.text }
+                    : { type: command.type });
+                if (!result || result.outcome === "rejected" || result.outcome === "failed") {
+                    throw new Error(command.type === "retry" ? "no previous prompt is available to retry" : `Pi session command failed: ${command.type}`);
+                }
                 return;
+            }
             case "set-model": {
                 const model = runtime.services.modelRuntime.getModel(command.model.providerId, command.model.modelId);
                 if (!model) {
@@ -1355,7 +1318,7 @@ export class PiEngineAdapter {
         this.#session = session;
         this.#activeCommandIds = [];
         this.#completedCommands.clear();
-        this.#lastPrompt = null;
+        this.#sessionCommands = new PiSessionCommandIntegration(session);
         this.#editor = {
             text: "",
             queuedSubmissions: [],
@@ -1366,12 +1329,28 @@ export class PiEngineAdapter {
         };
         this.#status = { ...this.#status, workingMessage: null, badges: [] };
         this.#activeModel = readModel(session.model);
+        this.#reconcileActiveModelAvailability();
         this.#thinkingLevel = readThinkingLevel(session.thinkingLevel);
         this.#rebuildTranscript(session.messages, "finalized");
         this.#unsubscribe = session.subscribe(event => this.#handlePiEvent(event));
         if (this.#extensionUi !== undefined)
             void this.#bindExtensionUiToSession();
     }
+    #reconcileActiveModelAvailability() {
+        const modelRuntime = this.#runtime?.services.modelRuntime;
+        if (!modelRuntime) {
+            this.#activeModel = null;
+            return;
+        }
+        const available = modelRuntime.getAvailableSnapshot?.() ?? [];
+        const sessionModel = readModel(this.#session?.model);
+        const authoritative = this.#activeModel ?? sessionModel;
+        if (authoritative === null)
+            return;
+        const remainsAvailable = available.some(model => stringProperty(model, "provider") === authoritative.providerId
+            && stringProperty(model, "id") === authoritative.modelId);
+        this.#activeModel = remainsAvailable ? authoritative : null;
+    }
     async #bindExtensionUiToSession() {
         const session = this.#session;
         const ui = this.#extensionUi;
@@ -1501,7 +1480,7 @@ export class PiEngineAdapter {
         let cost = 0;
         let latestCacheHitRate = null;
         let latestPrompt = null;
-        const entries = this.#session?.sessionManager?.getEntries()
+        const entries = this.#session?.sessionManager?.getEntries?.()
             ?? (this.#session?.messages ?? []).map(message => ({ type: "message", message }));
         for (const entry of entries) {
             if (!isRecord(entry))
@@ -1895,26 +1874,7 @@ export async function createPiEngineAdapter(options = {}) {
     return adapter;
 }
 async function createDefaultPiRuntime(input) {
-    const sessionManager = SessionManager.create(input.cwd, process.env.PI_CODING_AGENT_SESSION_DIR);
-    const createRuntime = async ({ cwd, sessionManager: targetSessionManager, sessionStartEvent, }) => {
-        const services = await createAgentSessionServices({ cwd, agentDir: input.agentDir });
-        const created = await createAgentSessionFromServices({
-            services,
-            sessionManager: targetSessionManager,
-            ...(sessionStartEvent ? { sessionStartEvent } : {}),
-        });
-        return {
-            ...created,
-            services,
-            diagnostics: services.diagnostics,
-        };
-    };
-    const runtime = await createAgentSessionRuntime(createRuntime, {
-        cwd: input.cwd,
-        agentDir: input.agentDir,
-        sessionManager,
-    });
-    return runtime;
+    return createPiRuntimeIntegration({ cwd: input.cwd, agentDir: input.agentDir });
 }
 function pinnedSessionInfoPresentation(value, sessionName, entries, modelRuntime) {
     const stats = isRecord(value) ? value : {};
@@ -2036,7 +1996,7 @@ function defaultWorkflowHost() {
             const result = await execFileAsync(command, [...arguments_], { encoding: "utf8" });
             return { stdout: result.stdout, stderr: result.stderr };
         },
-        readChangelog: async () => pinnedChangelogMarkdown(await readFile(join(getPackageDir(), "CHANGELOG.md"), "utf8")),
+        readChangelog: async () => "No changelog entries found.",
     };
 }
 function workflowLoginNotification(event) {
@@ -2130,6 +2090,35 @@ function pathArgument(value) {
     }
     return value.split(/\s/, 1)[0] || undefined;
 }
+function settingKeyForCallback(callback) {
+    const keys = {
+        onAutoCompactChange: "autoCompact", onShowImagesChange: "showImages", onImageWidthCellsChange: "imageWidthCells",
+        onAutoResizeImagesChange: "autoResizeImages", onBlockImagesChange: "blockImages", onEnableSkillCommandsChange: "enableSkillCommands",
+        onSteeringModeChange: "steeringMode", onFollowUpModeChange: "followUpMode", onTransportChange: "transport",
+        onHttpIdleTimeoutMsChange: "httpIdleTimeoutMs", onThemeChange: "theme", onThemePreview: "theme",
+        onHideThinkingBlockChange: "hideThinkingBlock", onMermaidRenderingModeChange: "mermaidRenderingMode",
+        onShowCacheMissNoticesChange: "showCacheMissNotices", onCollapseChangelogChange: "collapseChangelog",
+        onEnableInstallTelemetryChange: "enableInstallTelemetry", onQuietStartupChange: "quietStartup",
+        onDefaultProjectTrustChange: "defaultProjectTrust", onDoubleEscapeActionChange: "doubleEscapeAction",
+        onTreeFilterModeChange: "treeFilterMode", onShowHardwareCursorChange: "showHardwareCursor",
+        onEditorPaddingXChange: "editorPaddingX", onOutputPadChange: "outputPad", onAutocompleteMaxVisibleChange: "autocompleteMaxVisible",
+        onClearOnShrinkChange: "clearOnShrink", onShowTerminalProgressChange: "showTerminalProgress", onTuiModeChange: "tuiMode",
+        onFullscreenExitOutputChange: "fullscreenExitOutput", onFullscreenScrollbarChange: "fullscreenScrollbar", onWarningsChange: "warnings",
+    };
+    return keys[callback] ?? null;
+}
+function agentJsonValue(value) {
+    if (value === null || typeof value === "string" || typeof value === "boolean" || (typeof value === "number" && Number.isFinite(value)))
+        return value;
+    if (Array.isArray(value))
+        return value.map(agentJsonValue);
+    if (isRecord(value))
+        return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== undefined).map(([key, item]) => [key, agentJsonValue(item)]));
+    throw new TypeError("setting value must be JSON serializable");
+}
+function isThinkingLevel(value) {
+    return typeof value === "string" && ["off", "minimal", "low", "medium", "high", "xhigh"].includes(value);
+}
 function settingLabel(callback) {
     return callback
         .replace(/^on/, "")
@@ -2147,16 +2136,10 @@ function pinnedHotkeySummary() {
     ].join("\n");
 }
 function scopedModelRecords(modelRuntime) {
-    const snapshot = modelRuntime.getAvailableSnapshot?.() ?? [];
-    return snapshot.flatMap(model => {
-        if (!isRecord(model))
-            return [];
-        const provider = stringValue(model.provider);
-        const id = stringValue(model.id);
-        if (!provider || !id)
-            return [];
-        return [{ descriptor: { provider, id, name: stringValue(model.name) ?? id }, model }];
-    });
+    return modelRuntime.getAvailableSnapshot().map(model => ({
+        descriptor: { provider: model.provider, id: model.id, name: model.name ?? model.id },
+        model,
+    }));
 }
 function scopedModelReference(value) {
     if (!isRecord(value) || !isRecord(value.model))
@@ -2308,13 +2291,6 @@ function contentImageCount(content) {
         ? content.filter(item => isRecord(item) && item.type === "image").length
         : 0;
 }
-function pinnedChangelogMarkdown(content) {
-    const entries = content.split(/^##\s+/m).slice(1).flatMap(section => {
-        const markdown = `## ${section}`.trim();
-        return /^##\s+\[?\d+\.\d+\.\d+\]?/.test(markdown) ? [markdown] : [];
-    });
-    return entries.reverse().join("\n\n") || "No changelog entries found.";
-}
 function jsonSummary(value) {
     const json = sanitizeJson(value);
     let summary = "";
@@ -2362,4 +2338,3 @@ function finiteNumber(value) {
 function isRecord(value) {
     return typeof value === "object" && value !== null;
 }
-//# sourceMappingURL=adapter.js.map

package/dist/src/foundation/pi-engine-adapter/conformance.d.ts

@@ -1,14 +1,37 @@
+export interface PiCapabilityConformanceResult {
+    readonly capability: string;
+    readonly operations: readonly string[];
+    readonly passed: boolean;
+}
+export declare const REQUIRED_PI_CAPABILITY_OPERATIONS: Readonly<{
+    readonly "public-exports": readonly ["services.create", "session.create", "runtime.create"];
+    readonly "session-lifecycle": readonly ["session.new", "session.resume", "session.rebind", "session.dispose"];
+    readonly "commands-events": readonly ["prompt", "steer", "followUp", "abort", "compact", "setModel", "setThinkingLevel", "subscribe", "dispose"];
+    readonly "models-authentication": readonly ["models.list", "models.refresh", "auth.status", "auth.login", "auth.logout", "auth.cancel"];
+    readonly settings: readonly ["settings.read", "settings.write", "settings.flush"];
+    readonly "resources-extensions": readonly ["resources.discover", "extensions.bind", "extensions.reload", "renderers.invoke"];
+    readonly workflows: readonly ["workflow.route", "workflow.validate", "workflow.diagnostics"];
+    readonly disposal: readonly ["subscription.dispose", "session.dispose", "services.cleanup"];
+}>;
+export declare class PiCapabilityCompatibilityError extends Error {
+    readonly packageVersion: string;
+    readonly capability: string;
+    readonly operation: string;
+    constructor(packageVersion: string, capability: string, operation: string, detail: string);
+}
 export interface PiUpgradeConformanceReport {
+    readonly schema: "pi-engine-conformance-v1";
     readonly packageName: "@earendil-works/pi-coding-agent";
     readonly packageVersion: string;
     readonly ownedUiContractVersion: number;
     readonly serviceDiagnostics: number;
     readonly sessionId: string;
     readonly commandSurface: readonly string[];
+    readonly capabilities: readonly PiCapabilityConformanceResult[];
 }
 export declare class PiUpgradeConformanceError extends Error {
     readonly stage: "exports" | "services" | "session";
     constructor(stage: "exports" | "services" | "session", cause: unknown);
 }
 export declare function runPiUpgradeConformance(): Promise<PiUpgradeConformanceReport>;
-//# sourceMappingURL=conformance.d.ts.map
+export declare function validatePiCapabilityResults(packageVersion: string, results: readonly PiCapabilityConformanceResult[]): void;