@timurproko/a1 0.1.8-dev.50ebb19 → 0.1.8-dev.510

package/dist/src/foundation/pi-component-adapter/upstream/theme/theme.js

@@ -1,326 +0,0 @@
-import { existsSync, readFileSync, readdirSync, watch } from "node:fs";
-import { join } from "node:path";
-import { getAgentDir, initTheme, Theme, } from "@earendil-works/pi-coding-agent";
-import { getCapabilities } from "#pi-tui";
-import { BUILTIN_THEME_RESOURCES, isBuiltinThemeName } from "../../resources/builtin-themes.js";
-export const PINNED_PI_LAYOUT = Object.freeze({
-    editorPaddingX: 0,
-    outputPad: 1,
-    autocompleteMaxVisible: 5,
-    contentPaddingX: 1,
-    messagePaddingY: 1,
-    sectionSpacing: 1,
-    selectorMaxVisible: 10,
-});
-const FOREGROUND_COLORS = [
-    "accent", "border", "borderAccent", "borderMuted", "success", "error", "warning", "muted", "dim", "text",
-    "thinkingText", "userMessageText", "customMessageText", "customMessageLabel", "toolTitle", "toolOutput",
-    "mdHeading", "mdLink", "mdLinkUrl", "mdCode", "mdCodeBlock", "mdCodeBlockBorder", "mdQuote", "mdQuoteBorder",
-    "mdHr", "mdListBullet", "toolDiffAdded", "toolDiffRemoved", "toolDiffContext", "syntaxComment", "syntaxKeyword",
-    "syntaxFunction", "syntaxVariable", "syntaxString", "syntaxNumber", "syntaxType", "syntaxOperator", "syntaxPunctuation",
-    "thinkingOff", "thinkingMinimal", "thinkingLow", "thinkingMedium", "thinkingHigh", "thinkingXhigh", "thinkingMax", "bashMode",
-];
-const BACKGROUND_COLORS = [
-    "selectedBg", "scrollbarThumb", "userMessageBg", "customMessageBg", "toolPendingBg", "toolSuccessBg", "toolErrorBg",
-];
-let activeTheme;
-let activeThemeName;
-let activeThemeMode;
-let themeWatcher;
-let themeReloadTimer;
-const themeChangeListeners = new Set();
-export function ensurePiTheme() {
-    if (activeTheme)
-        return activeTheme;
-    const detected = detectPiTerminalBackgroundFromEnv();
-    applyPiTheme(detected.theme);
-    return activeTheme;
-}
-export function piTheme() {
-    return ensurePiTheme();
-}
-export function currentPiThemeName() {
-    ensurePiTheme();
-    return activeThemeName;
-}
-export function applyPiTheme(name, enableWatcher = false, mode) {
-    try {
-        const loaded = loadPiTheme(name, mode);
-        initTheme(name, false);
-        activeTheme = loaded;
-        activeThemeName = name;
-        activeThemeMode = mode;
-        if (enableWatcher)
-            startPiThemeWatcher(name);
-        notifyThemeChanged();
-        return { success: true, name };
-    }
-    catch (error) {
-        initTheme("dark", false);
-        activeTheme = loadPiTheme("dark", mode);
-        activeThemeName = "dark";
-        activeThemeMode = mode;
-        notifyThemeChanged();
-        return { success: false, name: "dark", error: error instanceof Error ? error.message : String(error) };
-    }
-}
-export function applyPiThemeInstance(theme) {
-    stopPiThemeWatcher();
-    activeTheme = theme;
-    activeThemeName = theme.name ?? "<in-memory>";
-    activeThemeMode = theme.getColorMode();
-    notifyThemeChanged();
-    return { success: true, name: activeThemeName };
-}
-export function onPiThemeChange(listener) {
-    themeChangeListeners.add(listener);
-    return () => themeChangeListeners.delete(listener);
-}
-export function stopPiThemeWatcher() {
-    if (themeReloadTimer !== undefined)
-        clearTimeout(themeReloadTimer);
-    themeReloadTimer = undefined;
-    themeWatcher?.close();
-    themeWatcher = undefined;
-}
-export function loadPiTheme(name, mode) {
-    if (!name || name.includes("/"))
-        throw new Error(`Invalid theme name: ${name}`);
-    const builtin = isBuiltinThemeName(name);
-    const path = builtin ? `owned:builtin-theme/${name}` : customThemePath(name);
-    let parsed;
-    if (builtin) {
-        parsed = BUILTIN_THEME_RESOURCES[name];
-    }
-    else {
-        const source = readFileSync(path, "utf8");
-        try {
-            parsed = JSON.parse(source);
-        }
-        catch (error) {
-            throw new Error(`Failed to parse theme ${path}: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    }
-    const themeJson = validateThemeJson(path, parsed);
-    const vars = themeJson.vars ?? {};
-    const colors = { ...themeJson.colors };
-    const thinkingMax = colors.thinkingMax ?? colors.thinkingXhigh;
-    const scrollbarThumb = colors.scrollbarThumb ?? colors.selectedBg;
-    if (thinkingMax !== undefined)
-        colors.thinkingMax = thinkingMax;
-    if (scrollbarThumb !== undefined)
-        colors.scrollbarThumb = scrollbarThumb;
-    const resolved = Object.fromEntries(Object.entries(colors).map(([key, value]) => [key, resolveVariable(value, vars)]));
-    const foreground = Object.fromEntries(FOREGROUND_COLORS.map(key => [key, requiredColor(resolved, key, path)]));
-    const backgrounds = Object.fromEntries(BACKGROUND_COLORS.map(key => [key, requiredColor(resolved, key, path)]));
-    return new Theme(foreground, backgrounds, mode ?? (getCapabilities().trueColor ? "truecolor" : "256color"), {
-        name: themeJson.name,
-        sourcePath: path,
-    });
-}
-export function getAvailablePiThemes() {
-    const available = new Map();
-    for (const name of ["dark", "light"])
-        available.set(name, `owned:builtin-theme/${name}`);
-    const customDirectory = join(getAgentDir(), "themes");
-    if (existsSync(customDirectory)) {
-        for (const file of readdirSync(customDirectory)) {
-            if (!file.endsWith(".json"))
-                continue;
-            const path = join(customDirectory, file);
-            try {
-                const parsed = validateThemeJson(path, JSON.parse(readFileSync(path, "utf8")));
-                if (!available.has(parsed.name))
-                    available.set(parsed.name, path);
-            }
-            catch { }
-        }
-    }
-    return [...available].map(([name, path]) => ({ name, path })).sort((left, right) => left.name.localeCompare(right.name));
-}
-export function parsePiAutoThemeSetting(setting) {
-    if (!setting)
-        return undefined;
-    const slashIndex = setting.indexOf("/");
-    if (slashIndex === -1 || setting.indexOf("/", slashIndex + 1) !== -1)
-        return undefined;
-    const lightTheme = setting.slice(0, slashIndex).trim();
-    const darkTheme = setting.slice(slashIndex + 1).trim();
-    return lightTheme && darkTheme ? { lightTheme, darkTheme } : undefined;
-}
-export function resolvePiThemeSetting(setting, terminalTheme) {
-    const automatic = parsePiAutoThemeSetting(setting);
-    if (automatic)
-        return terminalTheme === "light" ? automatic.lightTheme : automatic.darkTheme;
-    if (setting?.includes("/"))
-        return undefined;
-    return setting;
-}
-export function detectPiTerminalBackgroundFromEnv(environment = process.env) {
-    const parts = (environment.COLORFGBG ?? "").split(";");
-    for (let index = parts.length - 1; index >= 0; index -= 1) {
-        const background = Number.parseInt(parts[index].trim(), 10);
-        if (!Number.isInteger(background) || background < 0 || background > 255)
-            continue;
-        return {
-            theme: luminance(hexToRgb(ansi256ToHex(background))) >= 0.5 ? "light" : "dark",
-            source: "COLORFGBG",
-            detail: `background color index ${background}`,
-            confidence: "high",
-        };
-    }
-    return { theme: "dark", source: "fallback", detail: "no terminal background hint found", confidence: "low" };
-}
-export async function detectPiTerminalBackgroundTheme(ui, timeoutMs, environment = process.env) {
-    try {
-        const rgb = await ui.queryTerminalBackgroundColor({ timeoutMs });
-        if (rgb) {
-            return {
-                theme: luminance(rgb) >= 0.5 ? "light" : "dark",
-                source: "terminal background",
-                detail: `OSC 11 background rgb(${rgb.r}, ${rgb.g}, ${rgb.b})`,
-                confidence: "high",
-            };
-        }
-    }
-    catch { }
-    return detectPiTerminalBackgroundFromEnv(environment);
-}
-export async function detectPiTerminalThemeForAuto(ui, timeoutMs, environment = process.env) {
-    let scheme;
-    try {
-        scheme = ui.queryTerminalColorScheme?.({ timeoutMs });
-    }
-    catch { }
-    const background = detectPiTerminalBackgroundTheme(ui, timeoutMs, environment);
-    try {
-        const value = await scheme;
-        if (value)
-            return value;
-    }
-    catch { }
-    return (await background).theme;
-}
-function startPiThemeWatcher(name) {
-    stopPiThemeWatcher();
-    if (isBuiltinThemeName(name))
-        return;
-    const path = customThemePath(name);
-    if (!existsSync(path))
-        return;
-    themeWatcher = watch(path, () => {
-        if (activeThemeName !== name)
-            return;
-        if (themeReloadTimer !== undefined)
-            clearTimeout(themeReloadTimer);
-        themeReloadTimer = setTimeout(() => {
-            themeReloadTimer = undefined;
-            if (activeThemeName !== name || !existsSync(path))
-                return;
-            try {
-                activeTheme = loadPiTheme(name, activeThemeMode);
-                notifyThemeChanged();
-            }
-            catch { }
-        }, 100);
-    });
-    themeWatcher.on("error", stopPiThemeWatcher);
-}
-function notifyThemeChanged() {
-    for (const listener of themeChangeListeners)
-        listener();
-}
-function customThemePath(name) {
-    return join(getAgentDir(), "themes", `${name}.json`);
-}
-function validateThemeJson(label, value) {
-    if (!isRecord(value) || typeof value.name !== "string" || !isRecord(value.colors)
-        || (value.vars !== undefined && !isRecord(value.vars))) {
-        throw new Error(`Invalid theme "${label}": expected name, colors, and optional vars objects`);
-    }
-    if (value.name.includes("/"))
-        throw new Error(`Invalid theme name "${value.name}"`);
-    for (const key of FOREGROUND_COLORS) {
-        if (key !== "thinkingMax" && value.colors[key] === undefined)
-            throw new Error(`Invalid theme "${label}": missing required color ${key}`);
-    }
-    for (const key of BACKGROUND_COLORS) {
-        if (key !== "scrollbarThumb" && value.colors[key] === undefined)
-            throw new Error(`Invalid theme "${label}": missing required color ${key}`);
-    }
-    const colors = {};
-    for (const [key, color] of Object.entries(value.colors)) {
-        validateColor(color, `${label}.colors.${key}`);
-        colors[key] = color;
-    }
-    const vars = {};
-    for (const [key, color] of Object.entries(value.vars ?? {})) {
-        validateColor(color, `${label}.vars.${key}`);
-        vars[key] = color;
-    }
-    return { name: value.name, colors, ...(Object.keys(vars).length === 0 ? {} : { vars }) };
-}
-function validateColor(value, label) {
-    if (typeof value === "string")
-        return;
-    if (Number.isInteger(value) && value >= 0 && value <= 255)
-        return;
-    throw new Error(`Invalid theme color: ${label}`);
-}
-function resolveVariable(value, vars, visited = new Set()) {
-    if (typeof value === "number" || value === "" || value.startsWith("#"))
-        return value;
-    if (visited.has(value))
-        throw new Error(`Circular variable reference detected: ${value}`);
-    if (!(value in vars))
-        throw new Error(`Variable reference not found: ${value}`);
-    visited.add(value);
-    return resolveVariable(vars[value], vars, visited);
-}
-function requiredColor(colors, key, label) {
-    const value = colors[key];
-    if (value === undefined)
-        throw new Error(`Invalid theme "${label}": missing required color ${key}`);
-    return value;
-}
-function luminance({ r, g, b }) {
-    const linear = (channel) => {
-        const value = channel / 255;
-        return value <= 0.03928 ? value / 12.92 : ((value + 0.055) / 1.055) ** 2.4;
-    };
-    return 0.2126 * linear(r) + 0.7152 * linear(g) + 0.0722 * linear(b);
-}
-function hexToRgb(hex) {
-    const value = hex.slice(1);
-    return { r: Number.parseInt(value.slice(0, 2), 16), g: Number.parseInt(value.slice(2, 4), 16), b: Number.parseInt(value.slice(4, 6), 16) };
-}
-function ansi256ToHex(index) {
-    const basic = [
-        "#000000", "#800000", "#008000", "#808000", "#000080", "#800080", "#008080", "#c0c0c0",
-        "#808080", "#ff0000", "#00ff00", "#ffff00", "#0000ff", "#ff00ff", "#00ffff", "#ffffff",
-    ];
-    if (index < 16)
-        return basic[index];
-    if (index < 232) {
-        const cube = index - 16;
-        const toHex = (value) => (value === 0 ? 0 : 55 + value * 40).toString(16).padStart(2, "0");
-        return `#${toHex(Math.floor(cube / 36))}${toHex(Math.floor((cube % 36) / 6))}${toHex(cube % 6)}`;
-    }
-    const gray = (8 + (index - 232) * 10).toString(16).padStart(2, "0");
-    return `#${gray}${gray}${gray}`;
-}
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-/**
- * Applies the theme the reader configured, as the engine does at startup. The
- * setting is either a theme's name or the `light/dark` pair meaning "follow the
- * terminal", and only the pair consults the terminal's own background. An
- * unreadable or absent setting falls back to that detection, which is what the
- * engine does with an unset theme.
- */
-export function applyConfiguredPiTheme(setting) {
-    const detected = detectPiTerminalBackgroundFromEnv();
-    const resolved = resolvePiThemeSetting(setting, detected.theme);
-    return applyPiTheme(resolved ?? detected.theme);
-}

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

@@ -1,164 +0,0 @@
-import { type AgentSessionRuntime, type AgentSessionServices, type SessionInfo } from "@earendil-works/pi-coding-agent";
-import { OWNED_UI_EXTENSION_CONTRACT_VERSION, OWNED_UI_EXTENSION_RENDER_CALLBACKS, OWNED_UI_EXTENSION_UI_CALLBACKS, OWNED_UI_EXTENSION_UI_PROPERTIES, type OwnedUiCommand, type OwnedUiCommandOutcome, type OwnedUiEvent, type OwnedUiSessionViewModel, type OwnedUiSnapshot } from "../owned-ui-contracts/index.js";
-import { type PiAuthenticationProviderOption, type PiBashWorkflowResult, type PiPinnedSettingsCallback, type PiPinnedSettingsSnapshot, type PiWorkflowAutocompleteCommand, type PiWorkflowHost, type PiWorkflowInteractionHost, type PiWorkflowOption, type PiWorkflowRequest, type PiWorkflowResult } from "./workflows.js";
-import type { AgentSettingsPort } from "../agent-engine-contracts/index.js";
-export interface PiEngineRuntimeFactoryInput {
-    readonly cwd: string;
-    readonly agentDir: string;
-    readonly sessionId: string;
-}
-export interface PiScopedModelDescriptor {
-    readonly provider: string;
-    readonly id: string;
-    readonly name: string;
-}
-export interface PiScopedModelsContext {
-    readonly models: readonly PiScopedModelDescriptor[];
-    readonly enabledModelIds: readonly string[] | null;
-}
-export interface PiProjectTrustUpdate {
-    readonly path: string;
-    readonly decision: boolean | null;
-}
-export interface PiProjectTrustContext {
-    readonly cwd: string;
-    readonly savedDecision: {
-        readonly path: string;
-        readonly decision: boolean;
-    } | null;
-    readonly projectTrusted: boolean;
-    readonly trustOptions: readonly {
-        readonly label: string;
-        readonly trusted: boolean;
-        readonly updates: readonly PiProjectTrustUpdate[];
-        readonly savedPath?: string;
-    }[];
-}
-export interface PiTreeSelectorContext {
-    readonly tree: readonly unknown[];
-    readonly currentLeafId: string | null;
-    readonly filterMode: "default" | "no-tools" | "user-only" | "labeled-only" | "all";
-    readonly skipSummaryPrompt: boolean;
-    readonly appendLabelChange: (entryId: string, label: string | undefined) => void;
-}
-export interface PiSessionSelectorContext {
-    readonly currentSessionFilePath: string | undefined;
-    readonly loadCurrentSessions: (onProgress?: (loaded: number, total: number) => void) => Promise<SessionInfo[]>;
-    readonly loadAllSessions: (onProgress?: (loaded: number, total: number) => void) => Promise<SessionInfo[]>;
-    readonly renameSession: (sessionFilePath: string, nextName: string | undefined) => Promise<void>;
-}
-export interface PiScopedModelsRefreshResult extends PiScopedModelsContext {
-    readonly status: string;
-    readonly statusKind: "success" | "warning";
-}
-type PiServicesApi = AgentSessionServices;
-export type PiEngineRuntimeFactory = (input: PiEngineRuntimeFactoryInput) => Promise<AgentSessionRuntime>;
-export interface OwnedPiResourceSummary {
-    readonly kind: "skill" | "prompt-template" | "agent-context" | "system-prompt" | "theme";
-    readonly id: string;
-    readonly label: string;
-    readonly sourcePath: string | null;
-    readonly diagnostic: string | null;
-}
-export interface OwnedPiExtensionResourceSummary {
-    readonly kind: "extension";
-    readonly id: string;
-    readonly sourcePath: string | null;
-    readonly resolvedPath: string | null;
-    readonly loaded: boolean;
-    readonly hidden: boolean;
-    readonly diagnostic: string | null;
-}
-export interface OwnedPiVisualExtensionSupport {
-    readonly available: boolean;
-    readonly contractComplete: true;
-    readonly contractVersion: typeof OWNED_UI_EXTENSION_CONTRACT_VERSION;
-    readonly binding: "bound" | "unbound";
-    readonly uiCallbacks: typeof OWNED_UI_EXTENSION_UI_CALLBACKS;
-    readonly uiProperties: typeof OWNED_UI_EXTENSION_UI_PROPERTIES;
-    readonly renderCallbacks: typeof OWNED_UI_EXTENSION_RENDER_CALLBACKS;
-    readonly diagnostic: string;
-}
-export interface PiEngineAdapterOptions {
-    readonly cwd?: string;
-    readonly agentDir?: string;
-    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[];
-    /**
-     * Startup extension-package update probe, mirroring pinned Pi's interactive
-     * mode. Returns display names of packages with updates available.
-     */
-    readonly checkPackageUpdates?: (settingsManager: PiServicesApi["settingsManager"]) => Promise<readonly string[]>;
-}
-export interface AdapterCommandResult {
-    readonly outcome: OwnedUiCommandOutcome;
-    readonly diagnostic: string | null;
-}
-export declare class PiEngineAdapter {
-    #private;
-    constructor(options?: PiEngineAdapterOptions);
-    setWorkflowInteractionHost(interaction: PiWorkflowInteractionHost): void;
-    get sessionId(): string;
-    get sessionGeneration(): number;
-    get agentDir(): string;
-    get disposed(): boolean;
-    start(): Promise<OwnedUiSessionViewModel>;
-    onEvent(listener: (event: OwnedUiEvent) => void): () => void;
-    flushEvents(): Promise<void>;
-    nonVisualResources(): readonly OwnedPiResourceSummary[];
-    extensionResources(): readonly OwnedPiExtensionResourceSummary[];
-    visualExtensionSupport(): OwnedPiVisualExtensionSupport;
-    bindExtensionUi(ui: unknown, shutdown?: () => void | Promise<void>): Promise<void>;
-    unbindExtensionUi(): Promise<void>;
-    workflowAutocompleteCommands(): readonly PiWorkflowAutocompleteCommand[];
-    cycleModelWorkflow(direction: "forward" | "backward"): Promise<PiWorkflowResult>;
-    /**
-     * 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(): string | undefined;
-    /** Settings port for the live runtime, or null before the runtime is available. */
-    settingsPort(): AgentSettingsPort | null;
-    pinnedModelSelectorContext(): {
-        readonly currentModel: unknown;
-        readonly settingsManager: unknown;
-        readonly modelRuntime: unknown;
-        readonly scopedModels: readonly unknown[];
-    };
-    pinnedProjectTrustContext(): PiProjectTrustContext;
-    persistProjectTrust(updates: readonly PiProjectTrustUpdate[]): void;
-    pinnedSessionSelectorContext(): PiSessionSelectorContext;
-    pinnedScopedModelsContext(): PiScopedModelsContext;
-    updateScopedModels(enabledModelIds: readonly string[] | null): void;
-    persistScopedModels(enabledModelIds: readonly string[] | null): void;
-    refreshScopedModels(signal: AbortSignal): Promise<PiScopedModelsRefreshResult>;
-    pinnedLoginOptions(authType?: "oauth" | "api_key"): readonly PiAuthenticationProviderOption[];
-    pinnedLoginMethodOptions(providerReference: string): {
-        readonly title: string;
-        readonly options: readonly PiWorkflowOption[];
-    };
-    pinnedLogoutOptions(): Promise<readonly PiAuthenticationProviderOption[]>;
-    pinnedForkOptions(): readonly PiWorkflowOption[];
-    pinnedTreeSelectorContext(): PiTreeSelectorContext;
-    pinnedSettingsSnapshot(): PiPinnedSettingsSnapshot;
-    pinnedMessageRenderer(customType: string): unknown;
-    pinnedToolDefinition(toolName: string): unknown;
-    clearQueuedWorkflows(): readonly string[];
-    abortBashWorkflow(): void;
-    executeBashWorkflow(command: string, excludeFromContext: boolean): Promise<PiBashWorkflowResult>;
-    applyPinnedSettingValue(callback: PiPinnedSettingsCallback, value: unknown): PiWorkflowResult;
-    executeWorkflow(request: PiWorkflowRequest): Promise<PiWorkflowResult>;
-    view(): OwnedUiSessionViewModel;
-    snapshot(): OwnedUiSnapshot;
-    execute(command: OwnedUiCommand): Promise<AdapterCommandResult>;
-    dispose(): Promise<void>;
-}
-export declare function createPiEngineAdapter(options?: PiEngineAdapterOptions): Promise<PiEngineAdapter>;
-export {};