import type { OrcaHooks } from '../../shared/orca-yaml-hook-types' import type { ExecutionHostId } from '../../shared/execution-host' import type { SetupScriptImportCandidate } from '../../shared/workspace-setup/setup-script-imports' export type HooksApi = { /** `background`: a render-driven probe, refused (status 'error') rather than booting a stopped WSL distro. */ check: (args: { repoId: string; hostId?: ExecutionHostId; background?: boolean }) => Promise<{ status?: 'ok' | 'error' hasHooks: boolean hooks: OrcaHooks | null mayNeedUpdate: boolean /** A background check refused because the repo's WSL distro is stopped or didn't answer. */ unavailable?: 'wsl-distro-stopped' | 'wsl-distro-unverifiable' }> inspectSetupScriptImports: (args: { repoId: string hostId?: ExecutionHostId }) => Promise /** `wakeWslDistro`: a launch, a user act that may start the repo's stopped WSL distro. */ readIssueCommand: (args: { repoId: string hostId?: ExecutionHostId wakeWslDistro?: boolean }) => Promise<{ status?: 'ok' | 'error' localContent: string | null sharedContent: string | null effectiveContent: string | null localFilePath: string source: 'local' | 'shared' | 'none' localUntracked?: true refusedWslDistro?: string }> writeIssueCommand: (args: { repoId: string content: string hostId?: ExecutionHostId wakeWslDistro?: boolean }) => Promise }