@timurproko/a1 0.1.0 → 0.1.1-dev.2

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

@@ -1,4 +1,4 @@
-import { type ExtensionUIContext, type SessionInfo } from "@earendil-works/pi-coding-agent";
+import { type AgentSessionRuntime, 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 OwnedUiEvent, type OwnedUiSessionViewModel, type OwnedUiSnapshot } from "../owned-ui-contracts/index.js";
 import { type PiBashWorkflowResult, type PiPinnedSettingsCallback, type PiPinnedSettingsSnapshot, type PiWorkflowAutocompleteCommand, type PiWorkflowHost, type PiWorkflowInteractionHost, type PiWorkflowOption, type PiWorkflowRequest, type PiWorkflowResult } from "./workflows.js";
 export interface PiEngineRuntimeFactoryInput {
@@ -50,206 +50,7 @@ export interface PiScopedModelsRefreshResult extends PiScopedModelsContext {
     readonly status: string;
     readonly statusKind: "success" | "warning";
 }
-export interface PiSessionLike {
-    readonly sessionId: string;
-    readonly model: unknown;
-    readonly thinkingLevel: unknown;
-    readonly isStreaming: boolean;
-    readonly isIdle: boolean;
-    readonly isRetrying: boolean;
-    readonly isCompacting: boolean;
-    readonly messages: readonly unknown[];
-    readonly sessionManager?: {
-        getSessionName(): string | undefined;
-        getEntries(): readonly unknown[];
-        getCwd?(): string;
-        getSessionDir?(): string;
-        getSessionFile?(): string | undefined;
-        usesDefaultSessionDir?(): boolean;
-        getTree?(): readonly unknown[];
-        getLeafId?(): string | null | undefined;
-        appendLabelChange?(entryId: string, label: string | undefined): void;
-    };
-    readonly extensionRunner?: {
-        getCommands?(): readonly unknown[];
-        getMessageRenderer?(customType: string): unknown;
-        getToolDefinition?(toolName: string): unknown;
-    };
-    readonly scopedModels?: readonly unknown[];
-    readonly autoCompactionEnabled?: boolean;
-    readonly steeringMode?: PiPinnedSettingsSnapshot["steeringMode"];
-    readonly followUpMode?: PiPinnedSettingsSnapshot["followUpMode"];
-    getContextUsage?(): {
-        readonly tokens: number | null;
-        readonly contextWindow: number;
-        readonly percent: number | null;
-    } | undefined;
-    getScopedModels?(): readonly unknown[] | undefined;
-    setScopedModels?(models: readonly unknown[]): void;
-    cycleModel?(direction: "forward" | "backward"): Promise<unknown>;
-    getUserMessagesForForking?(): readonly unknown[];
-    getAvailableThinkingLevels?(): readonly unknown[];
-    cycleThinkingLevel?(): unknown;
-    setAutoCompactionEnabled?(enabled: unknown): void;
-    clearQueue?(): unknown;
-    abortBash?(): void;
-    executeBash?(command: string, onChunk: unknown, options: {
-        excludeFromContext: boolean;
-    }): Promise<unknown>;
-    exportToJsonl?(path?: string): string;
-    exportToHtml?(path?: string): Promise<string>;
-    getLastAssistantText?(): string | undefined;
-    setSessionName?(name: string): void;
-    getSessionStats?(): unknown;
-    navigateTree?(entryId: string, options?: {
-        summarize?: boolean;
-        customInstructions?: string;
-    }): Promise<unknown>;
-    reload?(): Promise<void>;
-    subscribe(listener: (event: unknown) => void): () => void;
-    prompt(text: string, options?: unknown): Promise<void>;
-    steer(text: string): Promise<void>;
-    followUp(text: string): Promise<void>;
-    abort(): Promise<void>;
-    abortRetry(): void;
-    abortCompaction(): void;
-    compact(customInstructions?: string): Promise<unknown>;
-    setModel(model: unknown): Promise<void>;
-    setThinkingLevel(level: unknown): void;
-    bindExtensions?(bindings: {
-        readonly uiContext?: ExtensionUIContext;
-        readonly mode?: "tui" | "print";
-        readonly shutdownHandler?: () => void | Promise<void>;
-        readonly onError?: (error: unknown) => void;
-    }): Promise<void>;
-    dispose(): void;
-}
-export interface PiServicesLike {
-    readonly modelRuntime: {
-        getModel(providerId: string, modelId: string): unknown;
-        isUsingSubscription?(providerId: string): boolean;
-        getAvailableSnapshot?(): readonly {
-            readonly provider?: string;
-            readonly id?: string;
-            readonly name?: string;
-        }[];
-        refresh?(options?: {
-            readonly signal?: AbortSignal;
-        }): Promise<unknown>;
-        getProviders?(): readonly unknown[];
-        getProvider?(providerId: string): unknown;
-        listCredentials?(options?: {
-            readonly signal?: AbortSignal;
-        }): Promise<readonly unknown[]>;
-        login?(providerId: string, authType: string, interaction: unknown, options?: {
-            readonly signal?: AbortSignal;
-        }): Promise<unknown>;
-        logout?(providerId: string, options?: {
-            readonly signal?: AbortSignal;
-        }): Promise<void>;
-    };
-    readonly settingsManager?: {
-        getCompactionEnabled?: () => boolean;
-        getEnabledModels?: () => readonly string[] | undefined;
-        setEnabledModels?: (patterns: string[] | undefined) => void;
-        isProjectTrusted?(): boolean;
-        setProjectTrusted?(trusted: boolean): void;
-        getTreeFilterMode?(): unknown;
-        getBranchSummarySkipPrompt?(): boolean;
-        setCompactionEnabled?(value: unknown): void;
-        getShowImages?(): unknown;
-        setShowImages?(value: unknown): void;
-        getImageWidthCells?(): unknown;
-        setImageWidthCells?(value: unknown): void;
-        getImageAutoResize?(): unknown;
-        setImageAutoResize?(value: unknown): void;
-        getBlockImages?(): unknown;
-        setBlockImages?(value: unknown): void;
-        getEnableSkillCommands?(): boolean;
-        setEnableSkillCommands?(value: unknown): void;
-        getSteeringMode?(): unknown;
-        setSteeringMode?(value: unknown): void;
-        getFollowUpMode?(): unknown;
-        setFollowUpMode?(value: unknown): void;
-        getTransport?(): unknown;
-        setTransport?(value: unknown): void;
-        getHttpIdleTimeoutMs?(): unknown;
-        setHttpIdleTimeoutMs?(value: unknown): void;
-        getTheme?(): unknown;
-        setTheme?(value: unknown): void;
-        getHideThinkingBlock?(): unknown;
-        setHideThinkingBlock?(value: unknown): void;
-        getMermaidRenderingMode?(): unknown;
-        setMermaidRenderingMode?(value: unknown): void;
-        getShowCacheMissNotices?(): unknown;
-        setShowCacheMissNotices?(value: unknown): void;
-        getCollapseChangelog?(): unknown;
-        setCollapseChangelog?(value: unknown): void;
-        getEnableInstallTelemetry?(): unknown;
-        setEnableInstallTelemetry?(value: unknown): void;
-        getQuietStartup?(): unknown;
-        setQuietStartup?(value: unknown): void;
-        getDefaultProjectTrust?(): unknown;
-        setDefaultProjectTrust?(value: unknown): void;
-        getDoubleEscapeAction?(): unknown;
-        setDoubleEscapeAction?(value: unknown): void;
-        setTreeFilterMode?(value: unknown): void;
-        getShowHardwareCursor?(): boolean;
-        setShowHardwareCursor?(value: unknown): void;
-        getEditorPaddingX?(): unknown;
-        setEditorPaddingX?(value: unknown): void;
-        getOutputPad?(): unknown;
-        setOutputPad?(value: unknown): void;
-        getAutocompleteMaxVisible?(): unknown;
-        setAutocompleteMaxVisible?(value: unknown): void;
-        getClearOnShrink?(): unknown;
-        setClearOnShrink?(value: unknown): void;
-        getShowTerminalProgress?(): unknown;
-        setShowTerminalProgress?(value: unknown): void;
-        getTuiMode?(): unknown;
-        setTuiMode?(value: unknown): void;
-        getFullscreenExitOutput?(): unknown;
-        setFullscreenExitOutput?(value: unknown): void;
-        getFullscreenScrollbar?(): unknown;
-        setFullscreenScrollbar?(value: unknown): void;
-        getWarnings?(): unknown;
-        setWarnings?(value: unknown): void;
-        getThemeSetting?(): unknown;
-        getTerminalTheme?(): unknown;
-        setDefaultModelAndProvider?(provider: string, model: string): void;
-    };
-    readonly resourceLoader?: {
-        getSkills(): unknown;
-        getPrompts(): unknown;
-        getAgentsFiles(): unknown;
-        getSystemPromptSource(): unknown;
-        getAppendSystemPromptSources(): unknown;
-        getExtensions?(): unknown;
-        getThemes?(): unknown;
-    };
-    readonly diagnostics: readonly {
-        readonly type: string;
-        readonly message: string;
-    }[];
-}
-export interface PiRuntimeLike {
-    readonly session: PiSessionLike;
-    readonly services: PiServicesLike;
-    readonly diagnostics: readonly {
-        readonly type: string;
-        readonly message: string;
-    }[];
-    setRebindSession(callback: (session: PiSessionLike) => Promise<void>): void;
-    listSessions?(): Promise<readonly unknown[]>;
-    newSession(options?: unknown): Promise<unknown>;
-    switchSession(sessionPath: string, options?: unknown): Promise<unknown>;
-    fork?(entryId: string, options?: {
-        position?: "before" | "at";
-    }): Promise<unknown>;
-    importFromJsonl?(path: string): Promise<unknown>;
-    dispose(): Promise<void>;
-}
-export type PiEngineRuntimeFactory = (input: PiEngineRuntimeFactoryInput) => Promise<PiRuntimeLike>;
+export type PiEngineRuntimeFactory = (input: PiEngineRuntimeFactoryInput) => Promise<AgentSessionRuntime>;
 export interface OwnedPiResourceSummary {
     readonly kind: "skill" | "prompt-template" | "agent-context" | "system-prompt" | "theme";
     readonly id: string;
@@ -340,4 +141,3 @@ export declare class PiEngineAdapter {
     dispose(): Promise<void>;
 }
 export declare function createPiEngineAdapter(options?: PiEngineAdapterOptions): Promise<PiEngineAdapter>;
-//# sourceMappingURL=adapter.d.ts.map

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,7 +60,7 @@ export class PiEngineAdapter {
     #eventQueue = [];
     #eventQueueProcessing;
     #droppedEventCount = 0;
-    #lastPrompt = null;
+    #sessionCommands;
     #gitBranch = null;
     #extensionUi;
     #extensionShutdown;
@@ -279,8 +283,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 +346,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");
@@ -378,7 +382,7 @@ export class PiEngineAdapter {
         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
@@ -455,7 +459,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),
@@ -594,7 +598,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"),
@@ -824,7 +828,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]);
@@ -1122,9 +1126,6 @@ export class PiEngineAdapter {
     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 +1183,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 +1209,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 +1261,7 @@ export class PiEngineAdapter {
         this.#session = session;
         this.#activeCommandIds = [];
         this.#completedCommands.clear();
-        this.#lastPrompt = null;
+        this.#sessionCommands = new PiSessionCommandIntegration(session);
         this.#editor = {
             text: "",
             queuedSubmissions: [],
@@ -1501,7 +1407,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 +1801,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 +1923,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 +2017,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 +2063,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 +2218,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 +2265,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;