better-codex 0.1.0

package/apps/backend/src/protocol/v2/ThreadResumeParams.ts

@@ -0,0 +1,35 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ResponseItem } from "../ResponseItem";
+import type { JsonValue } from "../serde_json/JsonValue";
+import type { AskForApproval } from "./AskForApproval";
+import type { SandboxMode } from "./SandboxMode";
+
+/**
+ * There are three ways to resume a thread:
+ * 1. By thread_id: load the thread from disk by thread_id and resume it.
+ * 2. By history: instantiate the thread from memory and resume it.
+ * 3. By path: load the thread from disk by path and resume it.
+ *
+ * The precedence is: history > path > thread_id.
+ * If using history or path, the thread_id param will be ignored.
+ *
+ * Prefer using thread_id whenever possible.
+ */
+export type ThreadResumeParams = { threadId: string, 
+/**
+ * [UNSTABLE] FOR CODEX CLOUD - DO NOT USE.
+ * If specified, the thread will be resumed with the provided history
+ * instead of loaded from disk.
+ */
+history: Array<ResponseItem> | null, 
+/**
+ * [UNSTABLE] Specify the rollout path to resume from.
+ * If specified, the thread_id param will be ignored.
+ */
+path: string | null, 
+/**
+ * Configuration overrides for the resumed thread, if any.
+ */
+model: string | null, modelProvider: string | null, cwd: string | null, approvalPolicy: AskForApproval | null, sandbox: SandboxMode | null, config: { [key in string]?: JsonValue } | null, baseInstructions: string | null, developerInstructions: string | null, };

package/apps/backend/src/protocol/v2/ThreadResumeResponse.ts

@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ReasoningEffort } from "../ReasoningEffort";
+import type { AskForApproval } from "./AskForApproval";
+import type { SandboxPolicy } from "./SandboxPolicy";
+import type { Thread } from "./Thread";
+
+export type ThreadResumeResponse = { thread: Thread, model: string, modelProvider: string, cwd: string, approvalPolicy: AskForApproval, sandbox: SandboxPolicy, reasoningEffort: ReasoningEffort | null, };

package/apps/backend/src/protocol/v2/ThreadStartParams.ts

@@ -0,0 +1,15 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { JsonValue } from "../serde_json/JsonValue";
+import type { AskForApproval } from "./AskForApproval";
+import type { SandboxMode } from "./SandboxMode";
+
+export type ThreadStartParams = { model: string | null, modelProvider: string | null, cwd: string | null, approvalPolicy: AskForApproval | null, sandbox: SandboxMode | null, config: { [key in string]?: JsonValue } | null, baseInstructions: string | null, developerInstructions: string | null, 
+/**
+ * If true, opt into emitting raw response items on the event stream.
+ *
+ * This is for internal use only (e.g. Codex Cloud).
+ * (TODO): Figure out a better way to categorize internal / experimental events & protocols.
+ */
+experimentalRawEvents: boolean, };

package/apps/backend/src/protocol/v2/ThreadStartResponse.ts

@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ReasoningEffort } from "../ReasoningEffort";
+import type { AskForApproval } from "./AskForApproval";
+import type { SandboxPolicy } from "./SandboxPolicy";
+import type { Thread } from "./Thread";
+
+export type ThreadStartResponse = { thread: Thread, model: string, modelProvider: string, cwd: string, approvalPolicy: AskForApproval, sandbox: SandboxPolicy, reasoningEffort: ReasoningEffort | null, };

package/apps/backend/src/protocol/v2/ThreadStartedNotification.ts

@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Thread } from "./Thread";
+
+export type ThreadStartedNotification = { thread: Thread, };

package/apps/backend/src/protocol/v2/ThreadTokenUsage.ts

@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { TokenUsageBreakdown } from "./TokenUsageBreakdown";
+
+export type ThreadTokenUsage = { total: TokenUsageBreakdown, last: TokenUsageBreakdown, modelContextWindow: number | null, };

package/apps/backend/src/protocol/v2/ThreadTokenUsageUpdatedNotification.ts

@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ThreadTokenUsage } from "./ThreadTokenUsage";
+
+export type ThreadTokenUsageUpdatedNotification = { threadId: string, turnId: string, tokenUsage: ThreadTokenUsage, };

package/apps/backend/src/protocol/v2/TokenUsageBreakdown.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type TokenUsageBreakdown = { totalTokens: number, inputTokens: number, cachedInputTokens: number, outputTokens: number, reasoningOutputTokens: number, };

package/apps/backend/src/protocol/v2/ToolsV2.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ToolsV2 = { web_search: boolean | null, view_image: boolean | null, };

package/apps/backend/src/protocol/v2/Turn.ts

@@ -0,0 +1,18 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ThreadItem } from "./ThreadItem";
+import type { TurnError } from "./TurnError";
+import type { TurnStatus } from "./TurnStatus";
+
+export type Turn = { id: string, 
+/**
+ * Only populated on a `thread/resume` response.
+ * For all other responses and notifications returning a Turn,
+ * the items field will be an empty list.
+ */
+items: Array<ThreadItem>, status: TurnStatus, 
+/**
+ * Only populated when the Turn's status is failed.
+ */
+error: TurnError | null, };

package/apps/backend/src/protocol/v2/TurnCompletedNotification.ts

@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Turn } from "./Turn";
+
+export type TurnCompletedNotification = { threadId: string, turn: Turn, };

package/apps/backend/src/protocol/v2/TurnDiffUpdatedNotification.ts

@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Notification that the turn-level unified diff has changed.
+ * Contains the latest aggregated diff across all file changes in the turn.
+ */
+export type TurnDiffUpdatedNotification = { threadId: string, turnId: string, diff: string, };

package/apps/backend/src/protocol/v2/TurnError.ts

@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { CodexErrorInfo } from "./CodexErrorInfo";
+
+export type TurnError = { message: string, codexErrorInfo: CodexErrorInfo | null, };

package/apps/backend/src/protocol/v2/TurnInterruptParams.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type TurnInterruptParams = { threadId: string, turnId: string, };

package/apps/backend/src/protocol/v2/TurnInterruptResponse.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type TurnInterruptResponse = Record<string, never>;

package/apps/backend/src/protocol/v2/TurnPlanStep.ts

@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { TurnPlanStepStatus } from "./TurnPlanStepStatus";
+
+export type TurnPlanStep = { step: string, status: TurnPlanStepStatus, };

package/apps/backend/src/protocol/v2/TurnPlanStepStatus.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type TurnPlanStepStatus = "pending" | "inProgress" | "completed";

package/apps/backend/src/protocol/v2/TurnPlanUpdatedNotification.ts

@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { TurnPlanStep } from "./TurnPlanStep";
+
+export type TurnPlanUpdatedNotification = { threadId: string, turnId: string, explanation: string | null, plan: Array<TurnPlanStep>, };

package/apps/backend/src/protocol/v2/TurnStartParams.ts

@@ -0,0 +1,34 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ReasoningEffort } from "../ReasoningEffort";
+import type { ReasoningSummary } from "../ReasoningSummary";
+import type { AskForApproval } from "./AskForApproval";
+import type { SandboxPolicy } from "./SandboxPolicy";
+import type { UserInput } from "./UserInput";
+
+export type TurnStartParams = { threadId: string, input: Array<UserInput>, 
+/**
+ * Override the working directory for this turn and subsequent turns.
+ */
+cwd: string | null, 
+/**
+ * Override the approval policy for this turn and subsequent turns.
+ */
+approvalPolicy: AskForApproval | null, 
+/**
+ * Override the sandbox policy for this turn and subsequent turns.
+ */
+sandboxPolicy: SandboxPolicy | null, 
+/**
+ * Override the model for this turn and subsequent turns.
+ */
+model: string | null, 
+/**
+ * Override the reasoning effort for this turn and subsequent turns.
+ */
+effort: ReasoningEffort | null, 
+/**
+ * Override the reasoning summary for this turn and subsequent turns.
+ */
+summary: ReasoningSummary | null, };

package/apps/backend/src/protocol/v2/TurnStartResponse.ts

@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Turn } from "./Turn";
+
+export type TurnStartResponse = { turn: Turn, };

package/apps/backend/src/protocol/v2/TurnStartedNotification.ts

@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Turn } from "./Turn";
+
+export type TurnStartedNotification = { threadId: string, turn: Turn, };

package/apps/backend/src/protocol/v2/TurnStatus.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type TurnStatus = "completed" | "interrupted" | "failed" | "inProgress";

package/apps/backend/src/protocol/v2/UserInput.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type UserInput = { "type": "text", text: string, } | { "type": "image", url: string, } | { "type": "localImage", path: string, };

package/apps/backend/src/protocol/v2/WindowsWorldWritableWarningNotification.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type WindowsWorldWritableWarningNotification = { samplePaths: Array<string>, extraCount: number, failedScan: boolean, };

package/apps/backend/src/protocol/v2/WriteStatus.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type WriteStatus = "ok" | "okOverridden";

package/apps/backend/src/protocol/v2/index.ts

@@ -0,0 +1,123 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+export type { Account } from "./Account";
+export type { AccountLoginCompletedNotification } from "./AccountLoginCompletedNotification";
+export type { AccountRateLimitsUpdatedNotification } from "./AccountRateLimitsUpdatedNotification";
+export type { AccountUpdatedNotification } from "./AccountUpdatedNotification";
+export type { AgentMessageDeltaNotification } from "./AgentMessageDeltaNotification";
+export type { ApprovalDecision } from "./ApprovalDecision";
+export type { AskForApproval } from "./AskForApproval";
+export type { CancelLoginAccountParams } from "./CancelLoginAccountParams";
+export type { CancelLoginAccountResponse } from "./CancelLoginAccountResponse";
+export type { CancelLoginAccountStatus } from "./CancelLoginAccountStatus";
+export type { CodexErrorInfo } from "./CodexErrorInfo";
+export type { CommandAction } from "./CommandAction";
+export type { CommandExecParams } from "./CommandExecParams";
+export type { CommandExecResponse } from "./CommandExecResponse";
+export type { CommandExecutionOutputDeltaNotification } from "./CommandExecutionOutputDeltaNotification";
+export type { CommandExecutionRequestApprovalParams } from "./CommandExecutionRequestApprovalParams";
+export type { CommandExecutionRequestApprovalResponse } from "./CommandExecutionRequestApprovalResponse";
+export type { CommandExecutionStatus } from "./CommandExecutionStatus";
+export type { Config } from "./Config";
+export type { ConfigBatchWriteParams } from "./ConfigBatchWriteParams";
+export type { ConfigEdit } from "./ConfigEdit";
+export type { ConfigLayer } from "./ConfigLayer";
+export type { ConfigLayerMetadata } from "./ConfigLayerMetadata";
+export type { ConfigLayerSource } from "./ConfigLayerSource";
+export type { ConfigReadParams } from "./ConfigReadParams";
+export type { ConfigReadResponse } from "./ConfigReadResponse";
+export type { ConfigValueWriteParams } from "./ConfigValueWriteParams";
+export type { ConfigWriteResponse } from "./ConfigWriteResponse";
+export type { ContextCompactedNotification } from "./ContextCompactedNotification";
+export type { CreditsSnapshot } from "./CreditsSnapshot";
+export type { DeprecationNoticeNotification } from "./DeprecationNoticeNotification";
+export type { ErrorNotification } from "./ErrorNotification";
+export type { ExecPolicyAmendment } from "./ExecPolicyAmendment";
+export type { FeedbackUploadParams } from "./FeedbackUploadParams";
+export type { FeedbackUploadResponse } from "./FeedbackUploadResponse";
+export type { FileChangeOutputDeltaNotification } from "./FileChangeOutputDeltaNotification";
+export type { FileChangeRequestApprovalParams } from "./FileChangeRequestApprovalParams";
+export type { FileChangeRequestApprovalResponse } from "./FileChangeRequestApprovalResponse";
+export type { FileUpdateChange } from "./FileUpdateChange";
+export type { GetAccountParams } from "./GetAccountParams";
+export type { GetAccountRateLimitsResponse } from "./GetAccountRateLimitsResponse";
+export type { GetAccountResponse } from "./GetAccountResponse";
+export type { GitInfo } from "./GitInfo";
+export type { ItemCompletedNotification } from "./ItemCompletedNotification";
+export type { ItemStartedNotification } from "./ItemStartedNotification";
+export type { ListMcpServerStatusParams } from "./ListMcpServerStatusParams";
+export type { ListMcpServerStatusResponse } from "./ListMcpServerStatusResponse";
+export type { LoginAccountParams } from "./LoginAccountParams";
+export type { LoginAccountResponse } from "./LoginAccountResponse";
+export type { LogoutAccountResponse } from "./LogoutAccountResponse";
+export type { McpAuthStatus } from "./McpAuthStatus";
+export type { McpServerOauthLoginCompletedNotification } from "./McpServerOauthLoginCompletedNotification";
+export type { McpServerOauthLoginParams } from "./McpServerOauthLoginParams";
+export type { McpServerOauthLoginResponse } from "./McpServerOauthLoginResponse";
+export type { McpServerStatus } from "./McpServerStatus";
+export type { McpToolCallError } from "./McpToolCallError";
+export type { McpToolCallProgressNotification } from "./McpToolCallProgressNotification";
+export type { McpToolCallResult } from "./McpToolCallResult";
+export type { McpToolCallStatus } from "./McpToolCallStatus";
+export type { MergeStrategy } from "./MergeStrategy";
+export type { Model } from "./Model";
+export type { ModelListParams } from "./ModelListParams";
+export type { ModelListResponse } from "./ModelListResponse";
+export type { NetworkAccess } from "./NetworkAccess";
+export type { OverriddenMetadata } from "./OverriddenMetadata";
+export type { PatchApplyStatus } from "./PatchApplyStatus";
+export type { PatchChangeKind } from "./PatchChangeKind";
+export type { ProfileV2 } from "./ProfileV2";
+export type { RateLimitSnapshot } from "./RateLimitSnapshot";
+export type { RateLimitWindow } from "./RateLimitWindow";
+export type { RawResponseItemCompletedNotification } from "./RawResponseItemCompletedNotification";
+export type { ReasoningEffortOption } from "./ReasoningEffortOption";
+export type { ReasoningSummaryPartAddedNotification } from "./ReasoningSummaryPartAddedNotification";
+export type { ReasoningSummaryTextDeltaNotification } from "./ReasoningSummaryTextDeltaNotification";
+export type { ReasoningTextDeltaNotification } from "./ReasoningTextDeltaNotification";
+export type { ReviewDelivery } from "./ReviewDelivery";
+export type { ReviewStartParams } from "./ReviewStartParams";
+export type { ReviewStartResponse } from "./ReviewStartResponse";
+export type { ReviewTarget } from "./ReviewTarget";
+export type { SandboxMode } from "./SandboxMode";
+export type { SandboxPolicy } from "./SandboxPolicy";
+export type { SandboxWorkspaceWrite } from "./SandboxWorkspaceWrite";
+export type { SessionSource } from "./SessionSource";
+export type { SkillErrorInfo } from "./SkillErrorInfo";
+export type { SkillMetadata } from "./SkillMetadata";
+export type { SkillScope } from "./SkillScope";
+export type { SkillsListEntry } from "./SkillsListEntry";
+export type { SkillsListParams } from "./SkillsListParams";
+export type { SkillsListResponse } from "./SkillsListResponse";
+export type { TerminalInteractionNotification } from "./TerminalInteractionNotification";
+export type { Thread } from "./Thread";
+export type { ThreadArchiveParams } from "./ThreadArchiveParams";
+export type { ThreadArchiveResponse } from "./ThreadArchiveResponse";
+export type { ThreadItem } from "./ThreadItem";
+export type { ThreadListParams } from "./ThreadListParams";
+export type { ThreadListResponse } from "./ThreadListResponse";
+export type { ThreadResumeParams } from "./ThreadResumeParams";
+export type { ThreadResumeResponse } from "./ThreadResumeResponse";
+export type { ThreadStartParams } from "./ThreadStartParams";
+export type { ThreadStartResponse } from "./ThreadStartResponse";
+export type { ThreadStartedNotification } from "./ThreadStartedNotification";
+export type { ThreadTokenUsage } from "./ThreadTokenUsage";
+export type { ThreadTokenUsageUpdatedNotification } from "./ThreadTokenUsageUpdatedNotification";
+export type { TokenUsageBreakdown } from "./TokenUsageBreakdown";
+export type { ToolsV2 } from "./ToolsV2";
+export type { Turn } from "./Turn";
+export type { TurnCompletedNotification } from "./TurnCompletedNotification";
+export type { TurnDiffUpdatedNotification } from "./TurnDiffUpdatedNotification";
+export type { TurnError } from "./TurnError";
+export type { TurnInterruptParams } from "./TurnInterruptParams";
+export type { TurnInterruptResponse } from "./TurnInterruptResponse";
+export type { TurnPlanStep } from "./TurnPlanStep";
+export type { TurnPlanStepStatus } from "./TurnPlanStepStatus";
+export type { TurnPlanUpdatedNotification } from "./TurnPlanUpdatedNotification";
+export type { TurnStartParams } from "./TurnStartParams";
+export type { TurnStartResponse } from "./TurnStartResponse";
+export type { TurnStartedNotification } from "./TurnStartedNotification";
+export type { TurnStatus } from "./TurnStatus";
+export type { UserInput } from "./UserInput";
+export type { WindowsWorldWritableWarningNotification } from "./WindowsWorldWritableWarningNotification";
+export type { WriteStatus } from "./WriteStatus";

package/apps/backend/src/reviews/service.ts

@@ -0,0 +1,27 @@
+import { ReviewStore, type ReviewSessionRow } from './store'
+
+export type ReviewUpsertInput = ReviewSessionRow
+
+export class ReviewService {
+  constructor(private readonly store: ReviewStore) {}
+
+  init(): void {
+    this.store.init()
+  }
+
+  upsert(session: ReviewUpsertInput): void {
+    this.store.upsert(session)
+  }
+
+  complete(id: string, review: string | null, completedAt = Date.now()): void {
+    this.store.complete(id, review, completedAt)
+  }
+
+  list(params: { profileId?: string; limit?: number; offset?: number }): ReviewSessionRow[] {
+    return this.store.list({
+      profileId: params.profileId,
+      limit: params.limit ?? 100,
+      offset: params.offset ?? 0,
+    })
+  }
+}

package/apps/backend/src/reviews/store.ts

@@ -0,0 +1,124 @@
+import { Database } from 'bun:sqlite'
+
+export type ReviewSessionRow = {
+  id: string
+  threadId: string
+  profileId: string
+  label: string | null
+  status: 'pending' | 'running' | 'completed' | 'failed'
+  startedAt: number
+  completedAt: number | null
+  model: string | null
+  cwd: string | null
+  review: string | null
+}
+
+export class ReviewStore {
+  private readonly db: Database
+
+  constructor(private readonly dbPath: string) {
+    this.db = new Database(dbPath)
+  }
+
+  init(): void {
+    this.db.exec(`
+      pragma journal_mode = wal;
+      create table if not exists review_sessions (
+        id text primary key,
+        thread_id text not null,
+        profile_id text not null,
+        label text,
+        status text not null,
+        started_at integer not null,
+        completed_at integer,
+        model text,
+        cwd text,
+        review text
+      );
+      create index if not exists review_sessions_profile on review_sessions(profile_id);
+      create index if not exists review_sessions_thread on review_sessions(thread_id);
+      create index if not exists review_sessions_status on review_sessions(status);
+      create index if not exists review_sessions_started_at on review_sessions(started_at);
+    `)
+  }
+
+  upsert(session: ReviewSessionRow): void {
+    this.db
+      .prepare(
+        `insert into review_sessions
+          (id, thread_id, profile_id, label, status, started_at, completed_at, model, cwd, review)
+         values
+          ($id, $thread_id, $profile_id, $label, $status, $started_at, $completed_at, $model, $cwd, $review)
+         on conflict(id) do update set
+          thread_id = excluded.thread_id,
+          profile_id = excluded.profile_id,
+          label = coalesce(excluded.label, review_sessions.label),
+          status = excluded.status,
+          started_at = excluded.started_at,
+          completed_at = coalesce(excluded.completed_at, review_sessions.completed_at),
+          model = coalesce(excluded.model, review_sessions.model),
+          cwd = coalesce(excluded.cwd, review_sessions.cwd),
+          review = coalesce(excluded.review, review_sessions.review)
+        `
+      )
+      .run({
+        $id: session.id,
+        $thread_id: session.threadId,
+        $profile_id: session.profileId,
+        $label: session.label,
+        $status: session.status,
+        $started_at: session.startedAt,
+        $completed_at: session.completedAt,
+        $model: session.model,
+        $cwd: session.cwd,
+        $review: session.review,
+      })
+  }
+
+  complete(id: string, review: string | null, completedAt: number): void {
+    this.db
+      .prepare(
+        `update review_sessions
+         set status = 'completed', review = $review, completed_at = $completed_at
+         where id = $id
+        `
+      )
+      .run({
+        $id: id,
+        $review: review,
+        $completed_at: completedAt,
+      })
+  }
+
+  list(params: { profileId?: string; limit: number; offset: number }): ReviewSessionRow[] {
+    const limit = Math.min(200, Math.max(1, params.limit))
+    const offset = Math.max(0, params.offset)
+    if (params.profileId) {
+      return this.db
+        .prepare(
+          `select * from review_sessions
+           where profile_id = $profile_id
+           order by started_at desc
+           limit $limit offset $offset
+          `
+        )
+        .all({
+          $profile_id: params.profileId,
+          $limit: limit,
+          $offset: offset,
+        }) as ReviewSessionRow[]
+    }
+
+    return this.db
+      .prepare(
+        `select * from review_sessions
+         order by started_at desc
+         limit $limit offset $offset
+        `
+      )
+      .all({
+        $limit: limit,
+        $offset: offset,
+      }) as ReviewSessionRow[]
+  }
+}