Orca is the place for working with a fleet of agents (e.g. Grok Bot, Claude Code). Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.
TypeScript adeagent-ideai-agentsautomationbotclaude-codecodexghosttygrok-bothermes-agentmobile-appmuseopenclawopencodeorchestrationpiruntimeterminalworktreesyc-backed
/** Desktop-only WSL host IPC; never part of the wire protocol (C7). */
import type { WslHostCopyParams } from './wsl-host-failure-copy'
export const WSL_HOST_STATUS_CHANNEL = 'wslHosts:statusChanged'
export type WslHostDistro = {
name: string
state: 'running' | 'stopped'
/** WSL 1 runs no Linux kernel, so it cannot host orcad; null when the registry did not say. */
version: 1 | 2 | null
environmentId: string | null
}
export type WslHostConnectionState =
| 'connecting'
| 'ready'
| 'reconnecting'
| 'distro-stopped'
| 'unverifiable'
| 'idle'
| 'failed'
| 'closed'
export type WslHostStatus = {
environmentId: string
distro: string
state: WslHostConnectionState
/** Why it failed or is unverifiable, in the main process's words. */
detail: string | null
/** `detail`'s WSL_HOST_STATUS_DETAIL_COPY code; absent when `detail` is verbatim diagnostic text. */
detailCode?: string
detailParams?: WslHostCopyParams
/** An app update the running server waits to take (e.g. live terminals); Update/Force retry it. */
deferredUpdate?: WslHostDeferredUpdate | null
/** A Remove that could not prove the server stopped; `detail` says why. Remove retries it. */
removalPending?: boolean
}
/** An explicit Update retries a skipped build behind the terminal census; Force also passes it. */
export type WslHostConnectIntent = 'update' | 'force'
/** A host a newer Orca runs refused this build: only Force (or updating Orca) changes that. */
export const ORCAD_HOST_NEWER_DEFERRAL_CODE = 'orcad_host_newer'
/** A project move to the host runs on this desktop; the update waits for it to finish. */
export const ORCAD_UPDATE_WSL_MOVE_RUNNING_CODE = 'orcad_update_wsl_move_running'
export type WslHostDeferredUpdate = {
candidateVersion: string
/** The update planner's deferral code, as Managed servers reports it. */
code: string
reason: string
/** False when forcing cannot make the update safe (e.g. it would strand terminals). */
forceable: boolean
}
export type WslHostCapability = {
/** False when the packaged orcad template is missing, so no WSL host can deploy or connect. */
serverFiles: boolean
/** False in serve-only: saved hosts work, but no host is added and no project moved. Absent from older mains. */
acceptsNewWork?: boolean
}
/**
* What removing a host left behind in its distro, in the census vocabulary: `live` when something
* is proven still running, `unverifiable` when Orca could not tell. `kept` (E11): the host stays
* listed with its stop pending, so Remove can retry; older mains removed it anyway.
*/
export type WslHostServerStop =
/** `keptForOtherDesktops`: another Orca shares the server, so only this desktop let go of it. */
| { stopped: true; keptForOtherDesktops?: string[] }
| {
stopped: false
reason: string
/** `reason`'s WSL_HOST_STATUS_DETAIL_COPY code, when it is one coded sentence. */
reasonCode?: string
reasonParams?: WslHostCopyParams
verdict?: 'live' | 'unverifiable'
kept?: boolean
}
export type WslHostAddFailureKind =
| 'unsupported-wsl1'
/** Its platform, libc or loader can't run Orca's server (e.g. NixOS, musl without libstdc++). */
| 'unsupported-distro'
| 'distro-stopped'
| 'already-added'
| 'ssh-managed'
| 'deferred'
| 'disabled'
| 'server-files-missing'
| 'failed'
export type WslHostAddResult =
| { ok: true; environmentId: string }
| {
ok: false
kind: WslHostAddFailureKind
message: string
/** `message`'s WSL_HOST_ADD_REFUSAL_COPY code; absent when `message` is verbatim error text. */
errorCode?: string
errorParams?: WslHostCopyParams
}
export function wslHostEnvironmentLabel(distro: string): string {
return `${distro} (WSL)`
}