# Todo — OpenCode v1.17.12 SDK Migration

## Phase 1: `session.interrupt()` — server-side abort propagation

- [ ] Bump `@opencode-ai/sdk` to `^1.17.12` in all `package.json` files
- [ ] Add `session.interrupt()` mock to `session-actions.test.ts`
- [ ] Replace `session.abort()` → `session.interrupt()` in `abortCurrentOperation()` (line 717)
- [ ] Replace `session.abort()` → `session.interrupt()` in `revertToMessage()` (line 910)
- [ ] Replace `session.abort()` → `session.interrupt()` in `unrevertSession()` (line 1042)
- [ ] Add `interruptSession()` wrapper to `client.ts` (optional)
- [ ] Run `bun run type-check` in `packages/ui`
- [ ] Run `bun test packages/ui/src/sync/session-actions.test.ts`
- [ ] Manual: verify STOP button aborts session and propagates to provider

## Phase 2: `session.events()` — per-session event stream

- [ ] Verify `session.events()` exists in SDK v1.17.12 types
- [ ] Add `subscribeSessionEvents()` to `client.ts`
- [ ] Use per-session stream in ChatContainer (reduce global firehose routing)
- [ ] Keep global pipeline as fallback for non-active sessions
- [ ] Run `bun run type-check` in `packages/ui`
- [ ] Manual: verify events arrive for active session only

## Phase 3: Migrate all message operations to Session3 API

### Step 1: Switch `session.messages()` calls from `Session2` to `Session3` API

- [ ] Pass `cursor` param in `fetchMessages()` (`use-sync.ts` line 326)
- [ ] Pass `cursor` param in `materializeSessionFromServer()` (`sync-context.tsx` line 240)
- [ ] Pass `cursor` param in `resyncDirectoryAfterReconnect()` (`sync-context.tsx` line 1207)
- [ ] Pass `cursor` param in `refetchSessionMessages()` (`session-actions.ts` line 1010)
- [ ] Pass `cursor` param in `fetchMessagesForSession()` (`session-actions.ts` line 1147)
- [ ] Pass `cursor` param in `getSessionMessages()` (`client.ts` line 547)
- [ ] Remove `directory` param from per-call args (set at client creation via scoped client)
- [ ] Replace `before` param with `cursor`

### Step 2: Add `session.message()` on the same Session3 API

- [ ] Add `getMessage()` wrapper to `client.ts` using `Session3.message()`
- [ ] Use in `revertToMessage()` as fallback when message not in store
- [ ] Use in `forkFromMessage()` as fallback when message not in store

### Validation

- [ ] Run `bun run type-check` in `packages/ui`
- [ ] Manual: load a session with 100+ messages, scroll up — smooth, no jank
- [ ] Manual: revert an evicted session — works without full history load

## Phase 4: `session.permission` — programmatic endpoints

- [ ] Verify `session.permission.create` / `fetch` exist in SDK v1.17.12
- [ ] Add wrappers to `client.ts`
- [ ] Use in permission auto-accept flow (`sync-context.tsx` line 1118-1143)
- [ ] Run `bun run type-check` in `packages/ui`
- [ ] Manual: verify permission create/fetch flow

## Blockers

- SDK v1.17.12 must be published and installable
- `session.events()` and `session.permission` must be confirmed in SDK types
- `Session3` API compatibility with current `Session2` usage must be verified