contracts.ts

export type ProjectStatus = "running" | "stopped" | "unknown"

export type AgentProvider = "codex" | "opencode" | "claude" | "custom"

export type AgentStatus = "starting" | "running" | "stopping" | "stopped" | "exited" | "failed"

export type ProjectSummary = {
  readonly id: string
  readonly displayName: string
  readonly repoUrl: string
  readonly repoRef: string
  readonly status: ProjectStatus
  readonly statusLabel: string
}

export type ProjectDetails = ProjectSummary & {
  readonly containerName: string
  readonly serviceName: string
  readonly sshUser: string
  readonly sshPort: number
  readonly targetDir: string
  readonly projectDir: string
  readonly sshCommand: string
  readonly envGlobalPath: string
  readonly envProjectPath: string
  readonly codexAuthPath: string
  readonly codexHome: string
}

export type CreateProjectRequest = {
  readonly repoUrl?: string | undefined
  readonly repoRef?: string | undefined
  readonly targetDir?: string | undefined
  readonly sshPort?: string | undefined
  readonly sshUser?: string | undefined
  readonly containerName?: string | undefined
  readonly serviceName?: string | undefined
  readonly volumeName?: string | undefined
  readonly secretsRoot?: string | undefined
  readonly authorizedKeysPath?: string | undefined
  readonly envGlobalPath?: string | undefined
  readonly envProjectPath?: string | undefined
  readonly codexAuthPath?: string | undefined
  readonly codexHome?: string | undefined
  readonly cpuLimit?: string | undefined
  readonly ramLimit?: string | undefined
  readonly dockerNetworkMode?: string | undefined
  readonly dockerSharedNetworkName?: string | undefined
  readonly enableMcpPlaywright?: boolean | undefined
  readonly outDir?: string | undefined
  readonly gitTokenLabel?: string | undefined
  readonly codexTokenLabel?: string | undefined
  readonly claudeTokenLabel?: string | undefined
  readonly agentAutoMode?: string | undefined
  readonly up?: boolean | undefined
  readonly openSsh?: boolean | undefined
  readonly force?: boolean | undefined
  readonly forceEnv?: boolean | undefined
}

export type AgentEnvVar = {
  readonly key: string
  readonly value: string
}

export type CreateAgentRequest = {
  readonly provider: AgentProvider
  readonly command?: string | undefined
  readonly args?: ReadonlyArray<string> | undefined
  readonly cwd?: string | undefined
  readonly env?: ReadonlyArray<AgentEnvVar> | undefined
  readonly label?: string | undefined
}

export type AgentSession = {
  readonly id: string
  readonly projectId: string
  readonly provider: AgentProvider
  readonly label: string
  readonly command: string
  readonly containerName: string
  readonly status: AgentStatus
  readonly source: string
  readonly pidFile: string
  readonly hostPid: number | null
  readonly startedAt: string
  readonly updatedAt: string
  readonly stoppedAt?: string | undefined
  readonly exitCode?: number | undefined
  readonly signal?: string | undefined
}

export type AgentLogLine = {
  readonly at: string
  readonly stream: "stdout" | "stderr"
  readonly line: string
}

export type AgentAttachInfo = {
  readonly projectId: string
  readonly agentId: string
  readonly containerName: string
  readonly pidFile: string
  readonly inspectCommand: string
  readonly shellCommand: string
}

export type ForgeFedTicket = {
  readonly id: string
  readonly attributedTo: string
  readonly summary: string
  readonly content: string
  readonly mediaType?: string | undefined
  readonly source?: string | undefined
  readonly published?: string | undefined
  readonly updated?: string | undefined
  readonly url?: string | undefined
}

export type FederationIssueStatus = "offered" | "accepted" | "rejected"

export type FederationIssueRecord = {
  readonly issueId: string
  readonly offerId?: string | undefined
  readonly tracker?: string | undefined
  readonly status: FederationIssueStatus
  readonly receivedAt: string
  readonly ticket: ForgeFedTicket
}

export type CreateFollowRequest = {
  readonly actor?: string | undefined
  readonly object: string
  readonly domain?: string | undefined
  readonly inbox?: string | undefined
  readonly to?: ReadonlyArray<string> | undefined
  readonly capability?: string | undefined
}

export type FollowStatus = "pending" | "accepted" | "rejected"

export type ActivityPubFollowActivity = {
  readonly "@context": string | ReadonlyArray<string>
  readonly id: string
  readonly type: "Follow"
  readonly actor: string
  readonly object: string
  readonly to?: ReadonlyArray<string> | undefined
  readonly capability?: string | undefined
}

export type ActivityPubPerson = {
  readonly "@context": "https://www.w3.org/ns/activitystreams"
  readonly type: "Person"
  readonly id: string
  readonly name: string
  readonly preferredUsername: string
  readonly summary: string
  readonly inbox: string
  readonly outbox: string
  readonly followers: string
  readonly following: string
  readonly liked: string
}

export type ActivityPubOrderedCollection = {
  readonly "@context": "https://www.w3.org/ns/activitystreams"
  readonly type: "OrderedCollection"
  readonly id: string
  readonly totalItems: number
  readonly orderedItems: ReadonlyArray<unknown>
}

export type FollowSubscription = {
  readonly id: string
  readonly activityId: string
  readonly actor: string
  readonly object: string
  readonly inbox?: string | undefined
  readonly to: ReadonlyArray<string>
  readonly capability?: string | undefined
  status: FollowStatus
  readonly createdAt: string
  updatedAt: string
  readonly activity: ActivityPubFollowActivity
}

export type FollowSubscriptionCreated = {
  readonly subscription: FollowSubscription
  readonly activity: ActivityPubFollowActivity
}

export type FederationInboxResult =
  | {
    readonly kind: "issue.offer"
    readonly issue: FederationIssueRecord
  }
  | {
    readonly kind: "issue.ticket"
    readonly issue: FederationIssueRecord
  }
  | {
    readonly kind: "follow.accept"
    readonly subscription: FollowSubscription
  }
  | {
    readonly kind: "follow.reject"
    readonly subscription: FollowSubscription
  }

export type ApiEventType =
  | "snapshot"
  | "project.created"
  | "project.deleted"
  | "project.deployment.status"
  | "project.deployment.log"
  | "agent.started"
  | "agent.output"
  | "agent.exited"
  | "agent.stopped"
  | "agent.error"

export type ApiEvent = {
  readonly seq: number
  readonly projectId: string
  readonly type: ApiEventType
  readonly at: string
  readonly payload: unknown
}

// Auth
export type AuthStatusResponse = { readonly message: string }

export type AuthGithubLoginRequest = {
  readonly label?: string | null | undefined
  readonly token?: string | null | undefined
  readonly scopes?: string | null | undefined
  readonly envGlobalPath: string
}

export type AuthGithubStatusRequest = {
  readonly envGlobalPath: string
}

export type AuthGithubLogoutRequest = {
  readonly label?: string | null | undefined
  readonly envGlobalPath: string
}

export type AuthCodexLoginRequest = {
  readonly label?: string | null | undefined
  readonly codexAuthPath: string
}

export type AuthCodexStatusRequest = {
  readonly label?: string | null | undefined
  readonly codexAuthPath: string
}

export type AuthCodexLogoutRequest = {
  readonly label?: string | null | undefined
  readonly codexAuthPath: string
}

export type AuthClaudeLoginRequest = {
  readonly label?: string | null | undefined
  readonly claudeAuthPath: string
}

export type AuthClaudeStatusRequest = {
  readonly label?: string | null | undefined
  readonly claudeAuthPath: string
}

export type AuthClaudeLogoutRequest = {
  readonly label?: string | null | undefined
  readonly claudeAuthPath: string
}

// State
export type StateInitRequest = {
  readonly repoUrl: string
  readonly repoRef?: string | undefined
}

export type StateCommitRequest = {
  readonly message: string
}

export type StateSyncRequest = {
  readonly message?: string | null | undefined
}

export type StatePathResponse = { readonly path: string }

export type StateOutputResponse = { readonly output: string }

// Scrap
export type ScrapExportRequest = {
  readonly projectDir: string
  readonly archivePath?: string | undefined
}

export type ScrapImportRequest = {
  readonly projectDir: string
  readonly archivePath: string
  readonly wipe?: boolean | undefined
}

// Sessions
export type SessionsListRequest = {
  readonly projectDir: string
  readonly includeDefault?: boolean | undefined
}

export type SessionsKillRequest = {
  readonly projectDir: string
  readonly pid: number
}

export type SessionsLogsRequest = {
  readonly projectDir: string
  readonly pid: number
  readonly lines?: number | undefined
}

export type SessionsOutput = { readonly output: string }

// MCP Playwright
export type McpPlaywrightUpRequest = {
  readonly projectDir: string
  readonly runUp?: boolean | undefined
}

// Apply (project config)
export type ApplyRequest = {
  readonly runUp?: boolean | undefined
  readonly gitTokenLabel?: string | undefined
  readonly codexTokenLabel?: string | undefined
  readonly claudeTokenLabel?: string | undefined
  readonly cpuLimit?: string | undefined
  readonly ramLimit?: string | undefined
  readonly enableMcpPlaywright?: boolean | undefined
}