import axios from 'axios' import type { AgentState, ClearOpencodeSessionCallbackRequest, ClearOpencodeSessionResponse, CreateMachineResponse, CreateSessionResponse, RunnerState, Machine, MachineMetadata, Metadata, Session } from '@/api/types' import { applyHubSessionSummaryContract } from '@/modules/common/sessionSummaryInstruction' import type { LocalResumeTarget, ResumableSession } from '@hapi/protocol' import { AgentStateSchema, ClearOpencodeSessionResponseSchema, CreateMachineResponseSchema, CreateSessionResponseSchema, GetSessionResponseSchema, LocalHandoffResponseSchema, LocalResumeTargetResponseSchema, RunnerStateSchema, MachineMetadataSchema, MetadataSchema, ResumableSessionsResponseSchema } from '@/api/types' import { configuration } from '@/configuration' import { getAuthToken } from '@/api/auth' import { apiValidationError } from '@/utils/errorUtils' import { ApiMachineClient } from './apiMachine' import { ApiSessionClient, type ApiSessionClientOptions } from './apiSession' import { buildHubRequestHeaders } from './hubExtraHeaders' export class ApiClient { static async create(): Promise { return new ApiClient(getAuthToken()) } private constructor(private readonly token: string) { } private authHeaders(): Record { return buildHubRequestHeaders({ Authorization: `Bearer ${this.token}`, 'Content-Type': 'application/json' }) } async getOrCreateSession(opts: { id?: string /** Bind a hub-preallocated stub (requires id). */ adopt?: boolean tag: string metadata: Metadata state: AgentState | null model?: string modelReasoningEffort?: string effort?: string machine?: { id: string metadata: MachineMetadata runnerState?: RunnerState } timeoutMs?: number signal?: AbortSignal }): Promise { const response = await axios.post( `${configuration.apiUrl}/cli/sessions`, { id: opts.id, ...(opts.adopt === true ? { adopt: true } : {}), tag: opts.tag, metadata: opts.metadata, agentState: opts.state, model: opts.model, modelReasoningEffort: opts.modelReasoningEffort, effort: opts.effort, machine: opts.machine ? { id: opts.machine.id, metadata: opts.machine.metadata, runnerState: opts.machine.runnerState ?? null } : undefined }, { headers: buildHubRequestHeaders({ Authorization: `Bearer ${this.token}`, 'Content-Type': 'application/json' }), timeout: opts.timeoutMs ?? 60_000, signal: opts.signal } ) const parsed = CreateSessionResponseSchema.safeParse(response.data) if (!parsed.success) { throw apiValidationError('Invalid /cli/sessions response', response) } if (typeof parsed.data.sessionSummaryContract === 'boolean') { applyHubSessionSummaryContract(parsed.data.sessionSummaryContract) } const raw = parsed.data.session const metadata = (() => { if (raw.metadata == null) return null const parsedMetadata = MetadataSchema.safeParse(raw.metadata) return parsedMetadata.success ? parsedMetadata.data : null })() const agentState = (() => { if (raw.agentState == null) return null const parsedAgentState = AgentStateSchema.safeParse(raw.agentState) return parsedAgentState.success ? parsedAgentState.data : null })() return { id: raw.id, namespace: raw.namespace, seq: raw.seq, createdAt: raw.createdAt, updatedAt: raw.updatedAt, active: raw.active, activeAt: raw.activeAt, metadata, metadataVersion: raw.metadataVersion, agentState, agentStateVersion: raw.agentStateVersion, thinking: raw.thinking, thinkingAt: raw.thinkingAt, todos: raw.todos, model: raw.model, modelReasoningEffort: raw.modelReasoningEffort, effort: raw.effort, serviceTier: raw.serviceTier, permissionMode: raw.permissionMode, collaborationMode: raw.collaborationMode } } async getSession(sessionId: string): Promise { const response = await axios.get( `${configuration.apiUrl}/cli/sessions/${encodeURIComponent(sessionId)}`, { headers: this.authHeaders(), timeout: 60_000 } ) const parsed = GetSessionResponseSchema.safeParse(response.data) if (!parsed.success) { throw apiValidationError('Invalid /cli/sessions/:id response', response) } if (typeof parsed.data.sessionSummaryContract === 'boolean') { applyHubSessionSummaryContract(parsed.data.sessionSummaryContract) } const raw = parsed.data.session const metadata = (() => { if (raw.metadata == null) return null const parsedMetadata = MetadataSchema.safeParse(raw.metadata) return parsedMetadata.success ? parsedMetadata.data : null })() const agentState = (() => { if (raw.agentState == null) return null const parsedAgentState = AgentStateSchema.safeParse(raw.agentState) return parsedAgentState.success ? parsedAgentState.data : null })() return { id: raw.id, namespace: raw.namespace, seq: raw.seq, createdAt: raw.createdAt, updatedAt: raw.updatedAt, active: raw.active, activeAt: raw.activeAt, metadata, metadataVersion: raw.metadataVersion, agentState, agentStateVersion: raw.agentStateVersion, thinking: raw.thinking, thinkingAt: raw.thinkingAt, todos: raw.todos, model: raw.model, modelReasoningEffort: raw.modelReasoningEffort, effort: raw.effort, serviceTier: raw.serviceTier, permissionMode: raw.permissionMode, collaborationMode: raw.collaborationMode } } async getOrCreateMachine(opts: { machineId: string metadata: MachineMetadata runnerState?: RunnerState }): Promise { const response = await axios.post( `${configuration.apiUrl}/cli/machines`, { id: opts.machineId, metadata: opts.metadata, runnerState: opts.runnerState ?? null }, { headers: buildHubRequestHeaders({ Authorization: `Bearer ${this.token}`, 'Content-Type': 'application/json' }), timeout: 60_000 } ) const parsed = CreateMachineResponseSchema.safeParse(response.data) if (!parsed.success) { throw apiValidationError('Invalid /cli/machines response', response) } const raw = parsed.data.machine const metadata = (() => { if (raw.metadata == null) return null const parsedMetadata = MachineMetadataSchema.safeParse(raw.metadata) return parsedMetadata.success ? parsedMetadata.data : null })() const runnerState = (() => { if (raw.runnerState == null) return null const parsedRunnerState = RunnerStateSchema.safeParse(raw.runnerState) return parsedRunnerState.success ? parsedRunnerState.data : null })() return { id: raw.id, namespace: raw.namespace, seq: raw.seq, createdAt: raw.createdAt, updatedAt: raw.updatedAt, active: raw.active, activeAt: raw.activeAt, metadata, metadataVersion: raw.metadataVersion, runnerState, runnerStateVersion: raw.runnerStateVersion } } async listResumableSessions(machineId?: string): Promise { const qs = machineId ? `?machineId=${encodeURIComponent(machineId)}` : '' const response = await axios.get( `${configuration.apiUrl}/cli/sessions/resumable${qs}`, { headers: this.authHeaders(), timeout: 60_000 } ) const parsed = ResumableSessionsResponseSchema.safeParse(response.data) if (!parsed.success) { throw apiValidationError('Invalid /cli/sessions/resumable response', response) } return parsed.data.sessions } async getLocalResumeTarget(sessionId: string): Promise { const response = await axios.get( `${configuration.apiUrl}/cli/sessions/${encodeURIComponent(sessionId)}/resume-target`, { headers: this.authHeaders(), timeout: 60_000 } ) const parsed = LocalResumeTargetResponseSchema.safeParse(response.data) if (!parsed.success) { throw apiValidationError('Invalid /cli/sessions/:id/resume-target response', response) } return parsed.data.target } async handoffSessionToLocal(sessionId: string): Promise { const response = await axios.post( `${configuration.apiUrl}/cli/sessions/${encodeURIComponent(sessionId)}/handoff-local`, {}, { headers: this.authHeaders(), timeout: 60_000 } ) const parsed = LocalHandoffResponseSchema.safeParse(response.data) if (!parsed.success || !parsed.data.ok) { throw apiValidationError('Invalid /cli/sessions/:id/handoff-local response', response) } } async clearOpenCodeSession(sessionId: string): Promise { const response = await axios.post( `${configuration.apiUrl}/cli/sessions/${encodeURIComponent(sessionId)}/clear-opencode`, {}, { headers: this.authHeaders(), timeout: 60_000 } ) const parsed = ClearOpencodeSessionResponseSchema.safeParse(response.data) if (!parsed.success) { throw apiValidationError('Invalid /cli/sessions/:id/clear-opencode response', response) } return parsed.data.sessionId } async reserveOpenCodeClearSession(sessionId: string): Promise { const response = await axios.post( `${configuration.apiUrl}/cli/sessions/${encodeURIComponent(sessionId)}/clear-opencode/reserve`, {}, { headers: this.authHeaders(), timeout: 60_000 } ) const parsed = ClearOpencodeSessionResponseSchema.safeParse(response.data) if (!parsed.success) throw apiValidationError('Invalid clear reservation response', response) return parsed.data.sessionId } async abortOpenCodeClearSession(sessionId: string, replacementSessionId: string): Promise { const response = await axios.post( `${configuration.apiUrl}/cli/sessions/${encodeURIComponent(sessionId)}/clear-opencode/abort`, { replacementSessionId } satisfies ClearOpencodeSessionCallbackRequest, { headers: this.authHeaders(), timeout: 60_000 } ) const parsed = ClearOpencodeSessionResponseSchema.safeParse(response.data) if (!parsed.success) throw apiValidationError('Invalid clear abort response', response) return parsed.data.sessionId } async confirmOpenCodeClearCleanup(sessionId: string, replacementSessionId: string): Promise { const response = await axios.post( `${configuration.apiUrl}/cli/sessions/${encodeURIComponent(sessionId)}/clear-opencode/confirm-cleanup`, { replacementSessionId } satisfies ClearOpencodeSessionCallbackRequest, { headers: this.authHeaders(), timeout: 60_000 } ) const parsed = ClearOpencodeSessionResponseSchema.safeParse(response.data) if (!parsed.success) throw apiValidationError('Invalid clear cleanup confirmation response', response) return parsed.data.sessionId } sessionSyncClient(session: Session, options?: ApiSessionClientOptions): ApiSessionClient { return new ApiSessionClient(this.token, session, options) } machineSyncClient(machine: Machine, options?: { workspaceRoots?: string[] }): ApiMachineClient { return new ApiMachineClient(this.token, machine, options?.workspaceRoots) } }