import type { HostUsageObservation } from '../../contracts/execution-usage.js'; import type { AvailableModel } from '../routing/model-resolver.js'; import type { HostCapabilityContract } from '../../contracts/host-capability.js'; export type HostLogLevel = 'debug' | 'info' | 'warn' | 'error'; export type HostEventKind = 'session-idle' | 'session-error' | 'session-deleted' | 'session-status' | 'session-diff' | 'session-compacted' | 'todo-updated' | 'permission-asked' | 'permission-replied' | 'file-edited' | 'file-watcher-updated' | 'lsp-diagnostics' | 'installation-updated' | 'unknown'; export interface HostEvent { kind: HostEventKind; rawType: string; sessionID?: string; properties: Record; filePaths: string[]; status: string; permission?: { id?: string; reply: 'once' | 'always' | 'reject' | 'unknown'; decision: 'allow' | 'deny' | 'unknown'; patterns: string[]; }; error?: HostAssistantError; } export interface HostAssistantError { name?: string; message: string; isRetryable?: boolean; statusCode?: number; } export interface HostAssistantResult { text: string; model?: { model?: string; variant?: string; message_id?: string; }; usage?: HostUsageObservation; error?: HostAssistantError; } export interface HostCapabilityView { childSessions: boolean; asyncPrompt: boolean; syncPrompt: boolean; abort: boolean; providerInventory: boolean; appLog: boolean; sessionStatus: boolean; childSessionList: boolean; sessionTodo: boolean; sessionDiff: boolean; sessionFork: boolean; sessionSummarize: boolean; sessionRevert: boolean; sessionUnrevert: boolean; workerRuntime: boolean; degraded: string[]; contracts: HostCapabilityContract[]; } export interface HostNativeSessionPort { diff(sessionID: string): Promise; revert(sessionID: string, messageID?: string): Promise; } export interface HostPort { capabilities: HostCapabilityView; nativeSession: HostNativeSessionPort; log(level: HostLogLevel, message: string, extra?: Record): Promise; refreshRuntimeInventory(reason: string): Promise; getModels(): AvailableModel[]; readAssistantResult(sessionID: string, limit?: number): Promise; sessionStatus(sessionID: string): Promise; continueSession(sessionID: string, text: string, metadata: Record): Promise; } export interface ChildWorkspaceRequest { workspaceID: string; directory: string; } export interface ChildSessionCreateRequest { parentSessionID: string; title: string; role: string; model?: string; variant?: string; workspace?: ChildWorkspaceRequest; forkFromSession?: string; } export interface ChildSessionCreateResult { child: { id?: string; workspaceID?: string; directory?: string; }; fork: { requested: boolean; nativeAvailable: boolean; used: false; reason?: string; }; } export type HostChildSessionStatus = 'idle' | 'busy' | 'retry' | 'unknown'; export interface ChildSessionPort { capabilities: { create: boolean; prompt: boolean; abort: boolean; status: boolean; diff: boolean; summarize: boolean; fork: boolean; }; create(request: ChildSessionCreateRequest): Promise; prompt(sessionID: string, text: string, role?: string, model?: string, variant?: string, tools?: Record): Promise; abort(sessionID: string): Promise<'server' | 'server-reconciled' | 'client' | 'client-reconciled' | 'unavailable'>; status(sessionID: string): Promise; diff(sessionID: string): Promise; summarize(sessionID: string): Promise; }