orca/src/main/ai-vault/session-scanner-opencode-sqlite-worker-protocol.ts

import type { AiVaultScanIssue, AiVaultSession } from '../../shared/ai-vault-types'
import type { SessionSearchCapturedMessage } from './session-search-capture'
import type { SessionFileCandidate } from './session-scanner-types'

// Why: request/response shapes shared by the worker entry and the main-thread
// client. Kept type-only (and electron-free) so importing it into the worker
// bundle can never pull the client's Electron dependency across the boundary.

export type OpenCodeSqliteListRequest = {
  id: number
  kind: 'list'
  dbPaths: readonly string[]
  limit: number
}

export type OpenCodeSqliteParseRequest = {
  id: number
  kind: 'parse'
  dbPath: string
  sessionId: string
  platform: NodeJS.Platform
  // Set when the caller parses inside a search-capture scope: AsyncLocalStorage
  // does not cross threads, so the worker sends acknowledged capture batches.
  capture?: boolean
}

export type OpenCodeSqliteWorkerRequest = OpenCodeSqliteListRequest | OpenCodeSqliteParseRequest

// The list leg returns candidates plus the issues it accumulated; the worker
// mutates a local array and hands it back so the caller can merge it into the
// scan's shared issue list.
export type OpenCodeSqliteListValue = {
  candidates: SessionFileCandidate[]
  issues: AiVaultScanIssue[]
}

// Final metadata follows acknowledgement of every capture batch.
export type OpenCodeSqliteParseValue = {
  session: AiVaultSession | null
}

export type OpenCodeSqliteWorkerResponse =
  | { id: number; ok: true; value: unknown; captureBatch?: number }
  | { id: number; ok: false; error: string }

export type OpenCodeSqliteCaptureAck = { id: number; kind: 'captureAck'; batch: number }
export type OpenCodeSqliteParentMessage = OpenCodeSqliteWorkerRequest | OpenCodeSqliteCaptureAck
export type OpenCodeSqliteCaptureBatch = {
  id: number
  ok: true
  captureBatch: number
  value: SessionSearchCapturedMessage[]
}

export type OpenCodeSqliteRequestBody =
  | Omit<OpenCodeSqliteListRequest, 'id'>
  | Omit<OpenCodeSqliteParseRequest, 'id'>