@timurproko/a1 0.1.1-dev.5 → 0.1.1-dev.7

package/dist/src/foundation/pi-component-adapter/shell-selectors-dialogs.js

@@ -163,14 +163,16 @@ export function createPiShellReloadBox() {
 }
 export function createPiShellAuthProviderSelector(mode, providers, onSelect, onCancel) {
     ensureTheme();
-    const selector = new OAuthSelectorComponent(mode, providers.map(provider => {
-        const [authType, providerId] = provider.id.includes(":") ? provider.id.split(":", 2) : ["oauth", provider.id];
-        return {
-            id: providerId,
-            name: provider.label,
-            authType: authType === "api_key" ? "api_key" : "oauth",
-        };
-    }), (providerId, authType) => onSelect(`${authType}:${providerId}`), onCancel);
+    const selector = new OAuthSelectorComponent(mode, providers.map(provider => ({
+        id: provider.providerId,
+        name: provider.label,
+        authType: provider.authType,
+        ...(provider.status === undefined ? {} : { status: provider.status }),
+    })), (providerId, authType) => {
+        const selected = providers.find(provider => provider.providerId === providerId && provider.authType === authType);
+        if (selected)
+            onSelect(selected.id);
+    }, onCancel);
     return componentPort(selector);
 }
 export function createPiShellExtensionSelector(title, options, onSelect, onCancel) {

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

@@ -1,6 +1,7 @@
 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";
+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 type { AgentSettingsPort } from "../agent-engine-contracts/index.js";
 export interface PiEngineRuntimeFactoryInput {
     readonly cwd: string;
     readonly agentDir: string;
@@ -83,6 +84,12 @@ export interface PiEngineAdapterOptions {
     readonly sessionId?: string;
     readonly createRuntime?: PiEngineRuntimeFactory;
     readonly workflowHost?: PiWorkflowHost;
+    /**
+     * Themes installed on this machine. Supplied because listing them belongs to
+     * the component adapter that owns the engine's theme unit; the grammar and the
+     * offering stay here.
+     */
+    readonly availableThemes?: () => readonly string[];
 }
 export interface AdapterCommandResult {
     readonly outcome: OwnedUiCommandOutcome;
@@ -106,6 +113,8 @@ export declare class PiEngineAdapter {
     unbindExtensionUi(): Promise<void>;
     workflowAutocompleteCommands(): readonly PiWorkflowAutocompleteCommand[];
     cycleModelWorkflow(direction: "forward" | "backward"): Promise<PiWorkflowResult>;
+    /** Settings port for the live runtime, or null before the runtime is available. */
+    settingsPort(): AgentSettingsPort | null;
     pinnedModelSelectorContext(): {
         readonly currentModel: unknown;
         readonly settingsManager: unknown;
@@ -119,12 +128,12 @@ export declare class PiEngineAdapter {
     updateScopedModels(enabledModelIds: readonly string[] | null): void;
     persistScopedModels(enabledModelIds: readonly string[] | null): void;
     refreshScopedModels(signal: AbortSignal): Promise<PiScopedModelsRefreshResult>;
-    pinnedLoginOptions(authType?: "oauth" | "api_key"): readonly PiWorkflowOption[];
+    pinnedLoginOptions(authType?: "oauth" | "api_key"): readonly PiAuthenticationProviderOption[];
     pinnedLoginMethodOptions(providerReference: string): {
         readonly title: string;
         readonly options: readonly PiWorkflowOption[];
     };
-    pinnedLogoutOptions(): Promise<readonly PiWorkflowOption[]>;
+    pinnedLogoutOptions(): Promise<readonly PiAuthenticationProviderOption[]>;
     pinnedForkOptions(): readonly PiWorkflowOption[];
     pinnedTreeSelectorContext(): PiTreeSelectorContext;
     pinnedSettingsSnapshot(): PiPinnedSettingsSnapshot;

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

@@ -66,12 +66,15 @@ export class PiEngineAdapter {
     #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) {
@@ -377,6 +380,20 @@ export class PiEngineAdapter {
             return workflowResult("model", "failed", error instanceof Error ? error.message : String(error));
         }
     }
+    /** 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;
@@ -397,7 +414,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 : [],
@@ -539,8 +556,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 };
     }
@@ -687,7 +705,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: [],
                 },
             },
@@ -987,6 +1005,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": {
@@ -997,6 +1017,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}`);
@@ -1087,7 +1109,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 => {
@@ -1096,11 +1121,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;
@@ -1118,8 +1165,11 @@ 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" },
                 }];
         });
     }
@@ -1272,12 +1322,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;

package/dist/src/foundation/pi-engine-adapter/pi-settings-metadata.json

@@ -0,0 +1,374 @@
+{
+    "presented": [
+        "autoCompact",
+        "showImages",
+        "imageWidthCells",
+        "autoResizeImages",
+        "blockImages",
+        "enableSkillCommands",
+        "showHardwareCursor",
+        "editorPaddingX",
+        "outputPad",
+        "autocompleteMaxVisible",
+        "clearOnShrink",
+        "showTerminalProgress",
+        "steeringMode",
+        "followUpMode",
+        "transport",
+        "httpIdleTimeoutMs",
+        "hideThinkingBlock",
+        "mermaidRenderingMode",
+        "showCacheMissNotices",
+        "collapseChangelog",
+        "quietStartup",
+        "enableInstallTelemetry",
+        "defaultProjectTrust",
+        "doubleEscapeAction",
+        "treeFilterMode",
+        "warnings",
+        "thinkingLevel",
+        "tuiMode",
+        "fullscreenExitOutput",
+        "fullscreenScrollbar",
+        "theme"
+    ],
+    "order": [
+        "autoCompact",
+        "showImages",
+        "imageWidthCells",
+        "autoResizeImages",
+        "blockImages",
+        "enableSkillCommands",
+        "showHardwareCursor",
+        "editorPaddingX",
+        "outputPad",
+        "autocompleteMaxVisible",
+        "clearOnShrink",
+        "showTerminalProgress",
+        "steeringMode",
+        "followUpMode",
+        "transport",
+        "httpIdleTimeoutMs",
+        "hideThinkingBlock",
+        "mermaidRenderingMode",
+        "showCacheMissNotices",
+        "collapseChangelog",
+        "quietStartup",
+        "enableInstallTelemetry",
+        "defaultProjectTrust",
+        "doubleEscapeAction",
+        "treeFilterMode",
+        "warnings",
+        "thinkingLevel",
+        "tuiMode",
+        "fullscreenExitOutput",
+        "fullscreenScrollbar",
+        "theme"
+    ],
+    "settings": {
+        "autoCompact": {
+            "label": "Auto-compact",
+            "description": "Automatically compact context when it gets too large",
+            "opensDialog": false,
+            "values": [
+                "true",
+                "false"
+            ]
+        },
+        "showImages": {
+            "label": "Show images",
+            "description": "Render images inline in terminal",
+            "opensDialog": false,
+            "values": [
+                "true",
+                "false"
+            ]
+        },
+        "imageWidthCells": {
+            "label": "Image width",
+            "description": "Preferred inline image width in terminal cells",
+            "opensDialog": false,
+            "values": [
+                "60",
+                "80",
+                "120"
+            ]
+        },
+        "autoResizeImages": {
+            "label": "Auto-resize images",
+            "description": "Resize large images to 2000x2000 max for better model compatibility",
+            "opensDialog": false,
+            "values": [
+                "true",
+                "false"
+            ]
+        },
+        "blockImages": {
+            "label": "Block images",
+            "description": "Prevent images from being sent to LLM providers",
+            "opensDialog": false,
+            "values": [
+                "true",
+                "false"
+            ]
+        },
+        "enableSkillCommands": {
+            "label": "Skill commands",
+            "description": "Register skills as /skill:name commands",
+            "opensDialog": false,
+            "values": [
+                "true",
+                "false"
+            ]
+        },
+        "showHardwareCursor": {
+            "label": "Show hardware cursor",
+            "description": "Show the terminal cursor while still positioning it for IME support",
+            "opensDialog": false,
+            "values": [
+                "true",
+                "false"
+            ]
+        },
+        "editorPaddingX": {
+            "label": "Editor padding",
+            "description": "Horizontal padding for input editor (0-3)",
+            "opensDialog": false,
+            "values": [
+                "0",
+                "1",
+                "2",
+                "3"
+            ]
+        },
+        "outputPad": {
+            "label": "Output padding",
+            "description": "Horizontal padding for user messages, assistant messages, and thinking",
+            "opensDialog": false,
+            "values": [
+                "0",
+                "1"
+            ]
+        },
+        "autocompleteMaxVisible": {
+            "label": "Autocomplete max items",
+            "description": "Max visible items in autocomplete dropdown (3-20)",
+            "opensDialog": false,
+            "values": [
+                "3",
+                "5",
+                "7",
+                "10",
+                "15",
+                "20"
+            ]
+        },
+        "clearOnShrink": {
+            "label": "Clear on shrink",
+            "description": "Clear empty rows when content shrinks (may cause flicker)",
+            "opensDialog": false,
+            "values": [
+                "true",
+                "false"
+            ]
+        },
+        "showTerminalProgress": {
+            "label": "Terminal progress",
+            "description": "Show OSC 9;4 progress indicators in the terminal tab bar",
+            "opensDialog": false,
+            "values": [
+                "true",
+                "false"
+            ]
+        },
+        "steeringMode": {
+            "label": "Steering mode",
+            "description": "Enter while streaming queues steering messages. 'one-at-a-time': deliver one, wait for response. 'all': deliver all at once.",
+            "opensDialog": false,
+            "values": [
+                "one-at-a-time",
+                "all"
+            ]
+        },
+        "followUpMode": {
+            "label": "Follow-up mode",
+            "description": "",
+            "opensDialog": false,
+            "values": [
+                "one-at-a-time",
+                "all"
+            ]
+        },
+        "transport": {
+            "label": "Transport",
+            "description": "Preferred transport for providers that support multiple transports",
+            "opensDialog": false,
+            "values": [
+                "sse",
+                "websocket",
+                "websocket-cached",
+                "auto"
+            ]
+        },
+        "httpIdleTimeoutMs": {
+            "label": "HTTP idle timeout",
+            "description": "Maximum idle gap while waiting for HTTP headers or body chunks. Disable for local models that pause longer than five minutes.",
+            "opensDialog": false
+        },
+        "hideThinkingBlock": {
+            "label": "Hide thinking",
+            "description": "Hide thinking blocks in assistant responses",
+            "opensDialog": false,
+            "values": [
+                "true",
+                "false"
+            ]
+        },
+        "mermaidRenderingMode": {
+            "label": "Mermaid diagrams",
+            "description": "Render Mermaid code blocks as Unicode diagrams",
+            "opensDialog": false,
+            "values": [
+                "off",
+                "final",
+                "streaming"
+            ]
+        },
+        "showCacheMissNotices": {
+            "label": "Cache miss notices",
+            "description": "Show transcript notices for significant prompt-cache misses",
+            "opensDialog": false,
+            "values": [
+                "true",
+                "false"
+            ]
+        },
+        "collapseChangelog": {
+            "label": "Collapse changelog",
+            "description": "Show condensed changelog after updates",
+            "opensDialog": false,
+            "values": [
+                "true",
+                "false"
+            ]
+        },
+        "quietStartup": {
+            "label": "Quiet startup",
+            "description": "Disable verbose printing at startup",
+            "opensDialog": false,
+            "values": [
+                "true",
+                "false"
+            ]
+        },
+        "enableInstallTelemetry": {
+            "label": "Install telemetry",
+            "description": "Send an anonymous version/update ping after changelog-detected updates",
+            "opensDialog": false,
+            "values": [
+                "true",
+                "false"
+            ]
+        },
+        "defaultProjectTrust": {
+            "label": "Default project trust",
+            "description": "Fallback behavior when no extension or saved trust decision decides project trust",
+            "opensDialog": false,
+            "values": [
+                "ask",
+                "always",
+                "never"
+            ]
+        },
+        "doubleEscapeAction": {
+            "label": "Double-escape action",
+            "description": "Action when pressing Escape twice with empty editor",
+            "opensDialog": false,
+            "values": [
+                "tree",
+                "fork",
+                "none"
+            ]
+        },
+        "treeFilterMode": {
+            "label": "Tree filter mode",
+            "description": "Default filter when opening /tree",
+            "opensDialog": false,
+            "values": [
+                "default",
+                "no-tools",
+                "user-only",
+                "labeled-only",
+                "all"
+            ]
+        },
+        "warnings": {
+            "label": "Warnings",
+            "description": "Enable or disable individual warnings",
+            "opensDialog": true,
+            "literalValue": "configure"
+        },
+        "thinkingLevel": {
+            "label": "Thinking level",
+            "description": "Reasoning depth for thinking-capable models",
+            "opensDialog": true
+        },
+        "tuiMode": {
+            "label": "TUI mode",
+            "description": "Interface layout; fullscreen mode is experimental",
+            "opensDialog": false,
+            "values": [
+                "regular",
+                "fullscreen"
+            ]
+        },
+        "fullscreenExitOutput": {
+            "label": "Fullscreen exit output",
+            "description": "Print the transcript or only a session resume hint when exiting fullscreen mode",
+            "opensDialog": false,
+            "values": [
+                "transcript",
+                "resume-hint"
+            ]
+        },
+        "fullscreenScrollbar": {
+            "label": "Fullscreen scrollbar",
+            "description": "Scrollbar behavior in fullscreen mode; has no effect in regular mode",
+            "opensDialog": false,
+            "values": [
+                "auto",
+                "always",
+                "hidden"
+            ]
+        },
+        "theme": {
+            "label": "Theme",
+            "description": "Color theme for the interface",
+            "opensDialog": true
+        }
+    },
+    "dialogs": {
+        "warnings": [
+            {
+                "id": "anthropic-extra-usage",
+                "label": "Anthropic extra usage",
+                "description": "Warn when Anthropic subscription auth may use paid extra usage",
+                "key": "anthropicExtraUsage",
+                "fallback": true
+            }
+        ]
+    },
+    "bounds": {
+        "imageWidthCells": {
+            "minimum": 1
+        },
+        "editorPaddingX": {
+            "minimum": 0,
+            "maximum": 3
+        },
+        "autocompleteMaxVisible": {
+            "minimum": 3,
+            "maximum": 20
+        }
+    }
+}

package/dist/src/foundation/pi-engine-adapter/public-main-entry.js

@@ -1,3 +1,4 @@
+import { realpathSync } from "node:fs";
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { main as runPublicMain } from "@earendil-works/pi-coding-agent";
@@ -13,6 +14,14 @@ export async function runPublicMainEntry(arguments_, dependencies = {}) {
         return 1;
     }
 }
-const isMain = process.argv[1] !== undefined && resolve(process.argv[1]) === fileURLToPath(import.meta.url);
+const isMain = process.argv[1] !== undefined && canonicalPath(process.argv[1]) === canonicalPath(fileURLToPath(import.meta.url));
 if (isMain)
     process.exitCode = await runPublicMainEntry(process.argv.slice(2));
+function canonicalPath(path) {
+    try {
+        return realpathSync.native(path);
+    }
+    catch {
+        return resolve(path);
+    }
+}