@timurproko/a1 0.1.0 → 0.1.1-dev.10

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

@@ -1,6 +1,7 @@
-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";
+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;
@@ -50,206 +51,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;
@@ -282,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;
@@ -305,6 +113,13 @@ export declare class PiEngineAdapter {
     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;
@@ -318,12 +133,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;
@@ -340,4 +155,3 @@ export declare class PiEngineAdapter {
     dispose(): Promise<void>;
 }
 export declare function createPiEngineAdapter(options?: PiEngineAdapterOptions): Promise<PiEngineAdapter>;
-//# sourceMappingURL=adapter.d.ts.map