Skip to content

armgit / orca

Public Imported from GitHub
0

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.

1.5 KB
Raw Blame
/** Host-resolved Orca session identity comes from the injected environment, never flags. Terminal agents lack it;
 * orca status --json publishes it as caller. */
export type OrchestrationCallerSession = {
  orcaSessionId: string
  live: boolean
}

/** The host refused the session this process names, so it cannot act as it right now. */
export type OrchestrationCallerRefusal = {
  live: false
  refusal: { code: string; message: string }
}

/** Absent for non-session callers, unreachable runtimes or hosts predating orchestration.callerShow. */
export type CliStatusCaller = OrchestrationCallerSession | OrchestrationCallerRefusal

/** `null`: the caller is not an Orca session. */
export type OrchestrationCallerShowResult = { caller: OrchestrationCallerSession | null }

/** `orchestration.sessionAddress`: a session's Orca session ID, its `/clear` root's. */
export type OrchestrationSessionAddressResult = { orcaSessionId: string }

/** Where a party is now: a chat at its `/clear` lineage's live session, or a terminal. */
export type OrchestrationPartyLocation =
  | { kind: 'chat'; sessionId: string; worktreeId: string }
  | { kind: 'terminal'; handle: string }

/** `orchestration.partyLocation`: a null location is a party this host does not find. `lost` says
 *  it proved that party gone, and what it was; absent, the host cannot tell (one it does not run). */
export type OrchestrationPartyLocationResult = {
  location: OrchestrationPartyLocation | null
  lost?: 'chat' | 'terminal'
}