62 lines
3.0 KiB
Markdown
62 lines
3.0 KiB
Markdown
|
# 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
|