diff --git a/apps/android/src/types.ts b/apps/android/src/types.ts new file mode 100644 index 0000000..0c4831a --- /dev/null +++ b/apps/android/src/types.ts @@ -0,0 +1,516 @@ +import type { TransportStats } from '@dsh-remote/protocol' +import type { AdaptiveConnectionDetails } from '@dsh-remote/webrtc' +import { strings as zhCN } from './locales/i18n' + +export type AgentBackend = 'harness' | 'codex' | 'cursor' | 'antigravity' | 'pi' | 'opencode' | 'claude' | 'hermes' + +export type ConnectionPhase = + | 'disconnected' + | 'connecting' + | 'connected' + | 'reconnecting' + | 'offline' + +export type ConnectionStage = + | 'authenticating' + | 'transport' + | 'secure' + | 'loading' + | 'ready' + +export type ConnectionProbeTransport = 'lan' | 'p2p' | 'turn' | 'relay' + +export type LoginMethod = 'oauth' | 'github-oauth' | 'google-oauth' | 'password' + +export type RedirectLoginMethod = Exclude + +export interface ServerConfig { + baseUrl: string + account?: string + loginMethod?: LoginMethod +} + +export interface DeviceIdentity { + deviceId: string + name: string + platform: 'android' + publicKey: string + privateKey: string +} + +export interface DeviceCredentials { + serverUrl: string + deviceId: string + authorizationMethod: 'account' | 'owned_device' + account?: string + accessToken: string + accessTokenExpiresAt: number + refreshToken: string + refreshTokenExpiresAt: number +} + +/** A Host visible through same-account membership, with its pinned identity key. */ +export interface RemoteDevice { + deviceId: string + name: string + platform: string + /** Pinned Noise static X25519 public key; never replaced by a Server response. */ + identityKey: string + membershipId: string + online: boolean + role?: 'host' | 'client' + clientVersion?: string + harnessVersion?: string + lastSeenAt?: number + fingerprint?: string + trusted: boolean +} + +export interface DevicePresence { + deviceId: string + online: boolean + lastSeenAt?: number +} + +export interface HostDescriptor { + version: string + cwd: string + provider?: string + model?: string + attachedSessions: number + canOpenPath: boolean +} + +export interface WorkspaceView { + workspaceId: string + backend?: AgentBackend + nativeId?: string + path: string + title: string + sessionIds: string[] + createdAt: string + updatedAt: string +} + +export interface WorkspaceList { + items: WorkspaceView[] + archivedSessionIds: string[] +} + +/** Locally remembered workspace shortcut: a favorite, or a recently visited workspace. */ +export interface WorkspaceShortcut { + deviceId: string + /** Host name snapshot so the link still renders while the device is offline. */ + deviceName: string + /** Durable identity from `workspaceStableKey`; survives CodeX project id changes. */ + key: string + workspaceId: string + backend: AgentBackend + title: string + path: string + /** When this shortcut was recorded: favorited time, or last visit for recent items. */ + addedAt: number +} + +export interface DirectoryEntry { + name: string + path: string + hidden: boolean +} + +export interface DirectoryListing { + path: string + home: string + crumbs: DirectoryEntry[] + entries: DirectoryEntry[] + truncated: boolean +} + +export interface ModelSelection { + provider: string + model: string + reasoningEffort?: string +} + +export interface ModelReasoningEffort { + id: string + name: string + description?: string +} + +export interface ModelReasoning { + efforts: ModelReasoningEffort[] + defaultEffort?: string +} + +export interface ModelCatalogModel { + id: string + name: string + description?: string + reasoning?: ModelReasoning +} + +export interface ModelProviderGroup { + id: string + name: string + models: ModelCatalogModel[] +} + +export interface ModelCatalogFailure { + id: string + name: string + message: string +} + +export interface SessionModels { + current: ModelSelection + routable: boolean + groups: ModelProviderGroup[] + failures: ModelCatalogFailure[] +} + +/** Native Harness session row projection. */ +/** One durable roster row from the session's `agentTeam` projection. */ +export interface TeamMemberSnapshot { + id: string + /** Present on wire rows for real members; the Lead pseudo-row may omit it. */ + name?: string + /** Role description shown as the member's identity in the team list. */ + description?: string + provider?: string + context?: 'fresh' | 'fork' + phase?: 'provisioning' | 'active' | 'failed' + error?: string +} + +/** One durable task row from the session's `agentTeam` projection. */ +export interface TeamTaskSnapshot { + id: string + revision: number + subject: string + description: string + status: 'pending' | 'in_progress' | 'completed' | 'deleted' + /** Owning member's session id; absent = unassigned. */ + ownerId?: string + blockedBy: string[] + writeScopes: string[] +} + +/** Team state published through the `agentTeam` session projection. */ +export interface AgentTeamState { + id: string + members: TeamMemberSnapshot[] + tasks: TeamTaskSnapshot[] + failure?: string +} + +export interface RemoteSession { + sessionId: string + backend?: AgentBackend + nativeId?: string + updatedAt: number + running: boolean + blank: boolean + title?: string + parentSessionId?: string + origin?: 'subagent' + cwd?: string + agentPreset?: string + projections?: { + values?: Record + } +} + +export interface PermissionPresetOption { + value: string + name: string + description?: string +} + +/** One agent-preset (mode) roster row from the Host. */ +export interface AgentPresetOption { + id: string + isDefault: boolean + name?: string + description?: string + broken?: string +} + +export interface PermissionSelect { + currentValue: string + options: PermissionPresetOption[] +} + +export type CodexPermissionPreset = 'workspace-write' | 'danger-full-access' + +/** Shared presets supported by both Harness and CodeX; default preserves backend behavior. */ +export type DefaultPermissionPreset = 'default' | CodexPermissionPreset + +export interface HistoryEntry { + event: NativeSessionEvent + view?: { for: 'call' | 'result'; view: unknown } +} + +export interface SessionHistoryPage { + events: HistoryEntry[] + hasMore: boolean + activeTurnId?: string + throughSeq?: number +} + +export interface ChatItemBase { + id: string + sessionId: string + createdAt: number + /** Authoritative event coordinates; absent on optimistic/non-timestamped frames. */ + nativeSeq?: number + nativeTime?: number + /** First event position, retained when a tool result updates the same row. */ + nativeOrderSeq?: number + /** Latest update, including the carrier's fractional transient chunk positions. */ + nativeRevisionSeq?: number + turn?: string + /** Authoritative turn/end evidence; no reply sequence is replaced by this event. */ + turnEnd?: { reason: 'completed' | 'stopped' | 'failed'; time: number; detail?: string } +} + +export interface ChatMessage extends ChatItemBase { + kind: 'message' + role: 'user' | 'assistant' | 'system' + text: string + /** Native turn identifier used to merge multiple reasoning segments in one reply. */ + replyGroup?: string + reasoning?: string + images?: ChatImage[] + streaming?: boolean + streamingPhase?: 'reasoning' | 'text' + /** Native session.prompt rpcId used to reconcile an optimistic user message. */ + requestRpcId?: string + /** + * Delivery state of a local optimistic user message. + * `queued`: the Host accepted the prompt into its queue (authoritative via + * the `inbox` projection) — hidden from the timeline and shown in the queue + * dock until an inbox update releases it or a `user/message` echo replaces it. + * `failed`: the Host rejected the prompt — kept with a retry affordance. + * `unconfirmed`: timeout/disconnect, or leaving the inbox without an echo, + * left the outcome unknown — visible until a + * history/inbox reconciliation decides its fate (never judged by timers). + * `canceled`: reconciliation found the queued prompt neither echoed nor in + * the inbox (removed remotely); kept quiet in the timeline, and a late echo + * still replaces it. + */ + sendState?: 'queued' | 'failed' | 'unconfirmed' | 'canceled' + /** Human-readable delivery failure reason kept on the row (single error surface). */ + sendError?: string + /** The Host inbox adopted this local prompt — it must never re-enter the local queue fallback. */ + queuedAdopted?: boolean + /** Original prompt image payloads kept for retries (the row's `images` are display-only). */ + promptImages?: PromptImage[] + context?: boolean + feedback?: 'positive' | 'negative' + usage?: { inputTokens: number; outputTokens: number; totalTokens?: number; cacheReadTokens?: number; cacheWriteTokens?: number; reasoningTokens?: number } +} + +export type ImageMediaType = 'image/png' | 'image/jpeg' | 'image/webp' | 'image/gif' + +/** + * Outcome of one send attempt. + * `sent`: the Host accepted the prompt (or the command ran). + * `kept`: delivery failed but the message row (and its retry material) is kept + * in the timeline with an inline state — the caller must not restore the draft. + * `rejected`: nothing was persisted (command failure / empty input) — the + * caller should restore the draft. + */ +export type SendMessageResult = 'sent' | 'kept' | 'rejected' + +/** Temporary image bytes carried only in one native session.prompt request. */ +export interface PromptImage { + uri: string + mediaType: ImageMediaType + data: string + bytes: number + width: number + height: number + name?: string +} + +/** Image presentation; durable references remain bound to their owning session. */ +export interface ChatImage { + attachmentId?: string + sessionId?: string + uri?: string + name?: string + mediaType?: string + /** Encoded byte length of a durable Host attachment, required by the 0.2.2 read contract. */ + bytes?: number + width?: number + height?: number +} + +export interface ImageAttachmentLimits { + maxImageBytes: number + maxImagesPerMessage: number + maxMessageImageBytes: number + maxImagePixels: number + maxImageDimension: number + mediaTypes: readonly ImageMediaType[] +} + +export interface ToolActivity extends ChatItemBase { + remoteDetail?: {threadId: string; detailId: string} + kind: 'tool' + toolName: string + /** Original official tool name, separate from its localized display title. */ + toolKey?: string + images?: ChatImage[] + arguments?: string + summary?: string + callDetail?: ToolDisplayDetail + resultDetail?: ToolDisplayDetail + /** Complete native tool-result metadata; never truncated into ToolDisplayDetail. */ + uiResultMeta?: unknown + state: 'running' | 'finished' | 'failed' +} + +export interface ToolDisplayDetail { + text: string + format: 'code' | 'markdown' + truncated?: boolean +} + +export interface ApprovalActivity extends ChatItemBase { + kind: 'approval' + approvalId: string + toolName: string + callId?: string + reason?: string + frameRpcId?: string + outcome?: ApprovalOutcome +} + +export type ApprovalOutcome = 'allowed-once' | 'rejected' | 'cancelled' | 'unavailable' + +export interface QuestionActivity extends ChatItemBase { + kind: 'question' + callId?: string + questionState?: 'open' | 'continued' + deadline?: number + frameRpcId?: string + questions: AskUserQuestionItem[] + outcome?: 'answered' | 'cancelled' | 'queued' +} + +export type ChatItem = ChatMessage | ToolActivity | ApprovalActivity | QuestionActivity + +/** Wire-safe question surface (mirrors @deepseek-ai/dsh-user-questions/types). */ +export interface AskUserQuestionOption { + label: string + description?: string +} + +export interface AskUserQuestionItem { + id: string + question: string + detail?: string + header?: string + options?: AskUserQuestionOption[] + multiSelect?: boolean + intent?: { kind: 'plan-review'; approve: string } +} + +export interface AskUserQuestionAnswer { + answers: Array<{ id: string; selected: string[]; custom?: string }> +} + +/** Structural mirror of @deepseek-ai/dsh-session SessionEvent (wire subset used by chat). */ +export interface NativeSessionEvent { + type: string + seq: number + time: number + data: Record + sourceEventSeqs?: number[] + surfaceOp?: 'append' + | { op: 'replace'; start: number; end: number } + | { op: 'replace'; startSeq: number; endSeq: number } + ignorable?: true +} + +export interface MuxFrame { + type: string + sessionId?: string + turn?: string | number + key?: string + value?: unknown + seq?: number + event?: NativeSessionEvent + view?: unknown + lastSeq?: number + approvalId?: string + toolName?: string + callId?: string + reason?: string + outcome?: string + questions?: AskUserQuestionItem[] + questionState?: 'open' | 'continued' + deadline?: number + questionRpcId?: string + error?: unknown +} + +/** One mux stream frame with its native rpcId (needed to answer approvals/questions). */ +export interface MuxStreamFrame { + rpcId: string + payload: MuxFrame +} + +export interface HarnessApiFrame { + streamId: string + frame: { rpcId: string; payload: MuxFrame } +} + +export interface ConnectionSnapshot { + phase: ConnectionPhase + stats: TransportStats + error?: string + errorCode?: string + /** False for protocol/security refusals or a replaced connection. */ + retryable?: boolean +} + +/** Diagnostics for the currently selected network path. Kept in memory only. */ +export type ConnectionNetworkDetails = AdaptiveConnectionDetails + +export interface PairLink { + server?: string +} + +/** Client-side transport routing preference (mirrors the Web Remote console). */ +export type TransportPreference = 'auto' | 'turn' | 'relay' + +export interface TransportPreferenceOption { + value: TransportPreference + name: string + description: string +} + +export function transportPreferenceOptions(): TransportPreferenceOption[] { + return [ + { value: 'auto', name: zhCN.transport.auto, description: zhCN.transport.autoDescription }, + { value: 'turn', name: zhCN.transport.turn, description: zhCN.transport.turnDescription }, + { value: 'relay', name: zhCN.transport.relay, description: zhCN.transport.relayDescription }, + ] +} + +export type { + ScheduleCatalogEntry, + ScheduleCreateRequest, + ScheduleDeleteResult, + ScheduleDeliveryHistoryResult, + ScheduleDeliveryReceipt, + ScheduleDeliveryRecord, + ScheduleKind, + ScheduleRecord, + ScheduleTimingChange, + ScheduleUpdateRequest, + ScheduleUpdateResult, +} from '@dsh-remote/client-core'