Consolidation: upstream v1.18.10 + all fork follow-ups (workbench split, webview bridges, ADR 0001)

.github/ISSUE_TEMPLATE/config.yml

@@ -2,4 +2,4 @@ blank_issues_enabled: false
 contact_links:
  - name: 💬 Discord Community
 url: https://discord.gg/opencode
-about: For quick questions or real-time discussion. Note that issues are searchable and help others with the same question.
+about: For support, troubleshooting, how-to questions, and real-time discussion.

.github/TEAM_MEMBERS

@@ -1,4 +1,5 @@
 adamdotdevin
+arvsrn
 Brendonovich
 fwang
 Hona
@@ -7,11 +8,14 @@ jayair
 jlongster
 kitlangton
 kommander
+ludvigrask
 MrMushrooooom
 nexxeln
 R44VC0RP
 rekram1-node
 thdxr
 simonklee
+Slickstef11
+usrnk1
 vimtor
-starptech
+StarpTech

.github/actions/setup-bun/action.yml

@@ -8,6 +8,13 @@ inputs:
 runs:
  using: "composite"
  steps:
+ # node-gyp@latest (invoked via bunx for native install scripts) requires Node >=22;
+ # some runner images ship an older system Node on PATH
+ - name: Setup Node
+ uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
+ with:
+ node-version: "24"
+
  - name: Get baseline download URL
  id: bun-url
  shell: bash

.github/workflows/compliance-close.yml

@@ -34,10 +34,48 @@ jobs:
 
  const now = Date.now();
  const twoHours = 2 * 60 * 60 * 1000;
+ const orgMemberAssociations = new Set(['OWNER', 'MEMBER']);
+ const agentLogin = 'opencode-agent[bot]';
+ const { data: file } = await github.rest.repos.getContent({
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ path: '.github/TEAM_MEMBERS',
+ ref: 'dev',
+ });
+ const teamMembers = new Set(
+ Buffer.from(file.content, 'base64')
+ .toString()
+ .split('\n')
+ .map((line) => line.trim().toLowerCase())
+ .filter(Boolean)
+ );
+
+ function isExempt(item) {
+ const login = item.user?.login?.toLowerCase();
+ return (
+ login === agentLogin ||
+ orgMemberAssociations.has(item.author_association) ||
+ (login && teamMembers.has(login))
+ );
+ }
 
  for (const item of items) {
  const isPR = !!item.pull_request;
  const kind = isPR ? 'PR' : 'issue';
+ const login = item.user?.login;
+
+ if (isExempt(item)) {
+ core.info(`Skipping ${kind} #${item.number}; author ${login || 'unknown'} is exempt`);
+ try {
+ await github.rest.issues.removeLabel({
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ issue_number: item.number,
+ name: 'needs:compliance',
+ });
+ } catch (e) {}
+ continue;
+ }
 
  const { data: comments } = await github.rest.issues.listComments({
  owner: context.repo.owner,

.github/workflows/duplicate-issues.yml

@@ -17,12 +17,31 @@ jobs:
  with:
  fetch-depth: 1
 
+ - name: Check exempt issue author
+ id: author
+ run: |
+ LOGIN="${{ github.event.issue.user.login }}"
+ ASSOCIATION="${{ github.event.issue.author_association }}"
+
+ if [ "$LOGIN" = "opencode-agent[bot]" ] ||
+ [ "$ASSOCIATION" = "OWNER" ] ||
+ [ "$ASSOCIATION" = "MEMBER" ] ||
+ grep -qxiF "$LOGIN" .github/TEAM_MEMBERS; then
+ echo "skip=true" >> "$GITHUB_OUTPUT"
+ echo "Skipping issue automation for exempt author: $LOGIN ($ASSOCIATION)"
+ else
+ echo "skip=false" >> "$GITHUB_OUTPUT"
+ fi
+
  - uses: ./.github/actions/setup-bun
+ if: steps.author.outputs.skip != 'true'
 
  - name: Install opencode
+ if: steps.author.outputs.skip != 'true'
  run: curl -fsSL https://opencode.ai/install | bash
 
  - name: Check duplicates and compliance
+ if: steps.author.outputs.skip != 'true'
  env:
  OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -38,6 +57,7 @@ jobs:
  opencode run -m opencode/claude-sonnet-4-6 "A new issue has been created:
 
  Issue number: ${{ github.event.issue.number }}
+ Issue author association: ${{ github.event.issue.author_association }}
 
  Lookup this issue with gh issue view ${{ github.event.issue.number }}.
 
@@ -49,6 +69,8 @@ jobs:
 
  Check whether the issue follows our contributing guidelines and issue templates.
 
+ If the issue author association is OWNER or MEMBER, skip this compliance check. Do not add the needs:compliance label for organization-owned issues.
+
  This project has three issue templates that every issue MUST use one of:
 
  1. Bug Report - requires a Description field with real content
@@ -83,7 +105,7 @@ jobs:
 
  Based on your findings, post a SINGLE comment on issue #${{ github.event.issue.number }}. Build the comment as follows:
 
- If the issue is NOT compliant, start the comment with:
+ If the issue is NOT compliant and the author association is not OWNER or MEMBER, start the comment with:
  <!-- issue-compliance -->
  Then explain what needs to be fixed and that they have 2 hours to edit the issue before it is automatically closed. Also add the label needs:compliance to the issue using: gh issue edit ${{ github.event.issue.number }} --add-label needs:compliance
 
@@ -129,12 +151,31 @@ jobs:
  with:
  fetch-depth: 1
 
+ - name: Check exempt issue author
+ id: author
+ run: |
+ LOGIN="${{ github.event.issue.user.login }}"
+ ASSOCIATION="${{ github.event.issue.author_association }}"
+
+ if [ "$LOGIN" = "opencode-agent[bot]" ] ||
+ [ "$ASSOCIATION" = "OWNER" ] ||
+ [ "$ASSOCIATION" = "MEMBER" ] ||
+ grep -qxiF "$LOGIN" .github/TEAM_MEMBERS; then
+ echo "skip=true" >> "$GITHUB_OUTPUT"
+ echo "Skipping issue automation for exempt author: $LOGIN ($ASSOCIATION)"
+ else
+ echo "skip=false" >> "$GITHUB_OUTPUT"
+ fi
+
  - uses: ./.github/actions/setup-bun
+ if: steps.author.outputs.skip != 'true'
 
  - name: Install opencode
+ if: steps.author.outputs.skip != 'true'
  run: curl -fsSL https://opencode.ai/install | bash
 
  - name: Recheck compliance
+ if: steps.author.outputs.skip != 'true'
  env:
  OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -148,9 +189,12 @@ jobs:
  }
  run: |
  opencode run -m opencode/claude-sonnet-4-6 "Issue #${{ github.event.issue.number }} was previously flagged as non-compliant and has been edited.
+ Issue author association: ${{ github.event.issue.author_association }}
 
  Lookup this issue with gh issue view ${{ github.event.issue.number }}.
 
+ If the issue author association is OWNER or MEMBER, remove the needs:compliance label if present, delete the previous compliance comment if present, and do not post a new comment.
+
  Re-check whether the issue now follows our contributing guidelines and issue templates.
 
  This project has three issue templates that every issue MUST use one of:

.github/workflows/publish.yml

@@ -219,7 +219,6 @@ jobs:
 
  build-electron:
  needs:
- - build-cli
  - version
  if: github.repository == 'anomalyco/opencode'
  continue-on-error: false
@@ -316,15 +315,13 @@ jobs:
  env:
  OPENCODE_VERSION: ${{ needs.version.outputs.version }}
  OPENCODE_CHANNEL: ${{ (github.ref_name == 'beta' && 'beta') || 'prod' }}
- OPENCODE_CLI_ARTIFACT: ${{ (runner.os == 'Windows' && 'opencode-cli-windows') || 'opencode-cli' }}
  RUST_TARGET: ${{ matrix.settings.target }}
- GH_TOKEN: ${{ github.token }}
- GITHUB_RUN_ID: ${{ github.run_id }}
 
  - name: Build
  run: bun run build
  working-directory: packages/desktop
  env:
+ NODE_OPTIONS: --max-old-space-size=4096
  OPENCODE_CHANNEL: ${{ (github.ref_name == 'beta' && 'beta') || 'prod' }}
  SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
  SENTRY_ORG: ${{ vars.SENTRY_ORG }}

.github/workflows/storybook.yml

@@ -9,6 +9,7 @@ on:
  - "bun.lock"
  - "packages/storybook/**"
  - "packages/ui/**"
+ - "packages/session-ui/**"
  pull_request:
  branches: [dev]
  paths:
@@ -17,6 +18,7 @@ on:
  - "bun.lock"
  - "packages/storybook/**"
  - "packages/ui/**"
+ - "packages/session-ui/**"
  workflow_dispatch:
 
 concurrency:

.github/workflows/test.yml

@@ -79,10 +79,15 @@ jobs:
 
  - name: Run unit tests
  timeout-minutes: 45
- run: bun turbo test --output-logs=errors-only --log-order=grouped --log-prefix=task
+ run: GITHUB_ACTIONS=false bun turbo test --output-logs=errors-only --log-order=grouped --log-prefix=task
  env:
  OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER: ${{ runner.os == 'Windows' && 'true' || 'false' }}
 
+ - name: Check generated client
+ if: runner.os == 'Linux'
+ working-directory: packages/client
+ run: bun run check:generated
+
  - name: Run HttpApi exerciser gates
  if: runner.os == 'Linux'
  working-directory: packages/opencode

.github/workflows/triage.yml

@@ -16,13 +16,32 @@ jobs:
  with:
  fetch-depth: 1
 
+ - name: Check exempt issue author
+ id: author
+ run: |
+ LOGIN="${{ github.event.issue.user.login }}"
+ ASSOCIATION="${{ github.event.issue.author_association }}"
+
+ if [ "$LOGIN" = "opencode-agent[bot]" ] ||
+ [ "$ASSOCIATION" = "OWNER" ] ||
+ [ "$ASSOCIATION" = "MEMBER" ] ||
+ grep -qxiF "$LOGIN" .github/TEAM_MEMBERS; then
+ echo "skip=true" >> "$GITHUB_OUTPUT"
+ echo "Skipping issue automation for exempt author: $LOGIN ($ASSOCIATION)"
+ else
+ echo "skip=false" >> "$GITHUB_OUTPUT"
+ fi
+
  - name: Setup Bun
+ if: steps.author.outputs.skip != 'true'
  uses: ./.github/actions/setup-bun
 
  - name: Install opencode
+ if: steps.author.outputs.skip != 'true'
  run: curl -fsSL https://opencode.ai/install | bash
 
  - name: Triage issue
+ if: steps.author.outputs.skip != 'true'
  env:
  OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.opencode/command/translate.md

@@ -1,6 +1,6 @@
 ---
 description: translate English to other languages
-model: opencode/claude-opus-4-8
+model: opencode/gpt-5.6-sol
 ---
 
 run git diff and translate changed english doc and UI copy files to other international languages. Translate all languages in parallel to save time.

.opencode/opencode.jsonc

@@ -2,9 +2,7 @@
  "$schema": "https://opencode.ai/config.json",
  "provider": {},
  "permission": {},
- // TODO: flip back to `references` once a release containing the v1 `reference` migration ships.
- // The release pipeline runs the latest published opencode against this file, which only knows `reference`.
- "reference": {
+ "references": {
  "effect": {
  "repository": "github.com/Effect-TS/effect-smol",
  "description": "Use for Effect v4 and effect-smol implementation details",

.opencode/tool/github-triage.ts

@@ -4,7 +4,7 @@ import { tool } from "@opencode-ai/plugin"
 const TEAM = {
  tui: ["kommander", "simonklee"],
  desktop_web: ["Hona", "Brendonovich"],
- core: ["jlongster", "rekram1-node", "nexxeln", "kitlangton", "starptech"],
+ core: ["jlongster", "rekram1-node", "nexxeln", "kitlangton"],
  inference: ["fwang", "MrMushrooooom", "starptech"],
  windows: ["Hona"],
 } as const

.prettierignore

@@ -1,2 +1,4 @@
 sst-env.d.ts
 packages/desktop/src/bindings.ts
+packages/client/src/generated/
+packages/client/src/generated-effect/

AGENTS.md

@@ -1,7 +1,15 @@
-- To regenerate the JavaScript SDK, run `./packages/sdk/js/script/build.ts`.
+- To regenerate the legacy JavaScript SDK, run `./packages/sdk/js/script/build.ts`.
+- After changing the public Protocol or Server `HttpApi`, run `bun run generate` from `packages/client`. Do not edit `src/generated` or `src/generated-effect` directly.
+- Keep runtime dependencies directed from Schema to Core and Protocol, then from Core and Protocol to Server. Client runtime code may depend on Schema and Protocol but never Core or Server; `sdk-next` composes Client, Core, and Server.
 - The default branch in this repo is `dev`.
 - Local `main` ref may not exist; use `dev` or `origin/dev` for diffs.
 
+## Branch Names
+
+Use a short branch name of at most three words, separated by hyphens. Do not use slashes or type prefixes such as `feat/` or `fix/`.
+
+Examples: `session-recovery`, `fix-scroll-state`, `regenerate-sdk`.
+
 ## Commits and PR Titles
 
 Use conventional commit-style messages and PR titles: `type(scope): summary`.
@@ -22,6 +30,7 @@ Examples: `fix(tui): simplify thinking toggle styling`, `docs: update contributi
 - Rely on type inference when possible; avoid explicit type annotations or interfaces unless necessary for exports or clarity
 - Prefer functional array methods (flatMap, filter, map) over for loops; use type guards on filter to maintain type inference downstream
 - In `src/config`, follow the existing self-export pattern at the top of the file (for example `export * as ConfigAgent from "./agent"`) when adding a new config module.
+- In Effect generators, bind services to named variables before calling methods. Do not use nested service yields such as `yield* (yield* Foo.Service).bar()`.
 
 Reduce total variable count by inlining when a value is only used once.
 
@@ -131,7 +140,7 @@ const table = sqliteTable("session", {
 
 ## Testing
 
-- Avoid mocks as much as possible
+- Avoid mocks as much as possible, you shouldn't be using globalThis.\* at all unless it's the only option.
 - Test actual implementation, do not duplicate logic into tests
 - Tests cannot run from repo root (guard: `do-not-run-tests-from-root`); run from package dirs like `packages/opencode`.
 
@@ -146,7 +155,7 @@ const table = sqliteTable("session", {
 - Keep `SessionExecution` process-global and Session-ID based. Its local implementation owns the process-local Session coordinator and discovers placement through `SessionStore` plus `LocationServiceMap.get(session.location)` only when a drain starts; no layer should take a Session ID. V2 interruption targets the active process-local ownership chain for that Session; idle or missing interruption is a no-op.
 - Keep `SessionRunner`, model resolution, tool registry, permissions, and filesystem Location-scoped. Omitted `Location.workspaceID` means implicit-local placement; explicit workspace identity remains reserved for future placement semantics.
 - Preserve one explicit `llm.stream(request)` call per provider turn and reload projected history before durable continuation. Do not bridge through legacy `SessionPrompt.loop(...)` or delegate orchestration to an in-memory tool loop.
-- Keep local Session drains process-local until clustering is implemented. `SessionRunCoordinator` joins explicit same-Session resumes, coalesces prompt wakeups, and allows different Sessions to run concurrently. Advisory wakes drain eligible durable inbox rows only; post-crash activity recovery requires a separate explicit design before it may retry provider work.
-- Keep delivery vocabulary explicit. Prompts steer by default and coalesce into the active activity at the next safe provider-turn boundary. Explicit `queue` inputs open FIFO future activities one at a time after the active activity settles.
+- Keep local Session drains process-local until clustering is implemented. `SessionRunCoordinator` joins explicit same-Session resumes, coalesces prompt wakeups, and allows different Sessions to run concurrently. Advisory wakes drain eligible durable inbox rows only; post-crash continuation recovery requires a separate explicit design before it may retry provider work. A drain has no durable identity or transcript boundary.
+- Keep delivery vocabulary explicit. Prompts steer by default and promote at the next safe provider-turn boundary while the current drain requires continuation. An explicit `queue` input remains pending until the Session would otherwise become idle; promote one queued input at that boundary, then reevaluate continuation before promoting another. Promoting any new user input resets the selected agent's provider-turn allowance; a batch of steers resets it once.
 - Keep EventV2 replay owner claims separate from clustered Session execution ownership.
 - Keep the System Context algebra, registry, and built-ins in `src/system-context`; keep Context Source producers with their observed domains, and keep Session History selection plus Context Epoch persistence Session-owned.

.github/ISSUE_TEMPLATE/config.yml

@@ -2,4 +2,4 @@ blank_issues_enabled: false
 contact_links:
  - name: 💬 Discord Community
 url: https://discord.gg/opencode
-about: For quick questions or real-time discussion. Note that issues are searchable and help others with the same question.
+about: For support, troubleshooting, how-to questions, and real-time discussion.

.github/TEAM_MEMBERS

@@ -1,4 +1,5 @@
 adamdotdevin
+arvsrn
 Brendonovich
 fwang
 Hona
@@ -7,11 +8,14 @@ jayair
 jlongster
 kitlangton
 kommander
+ludvigrask
 MrMushrooooom
 nexxeln
 R44VC0RP
 rekram1-node
 thdxr
 simonklee
+Slickstef11
+usrnk1
 vimtor
-starptech
+StarpTech

.github/actions/setup-bun/action.yml

@@ -8,6 +8,13 @@ inputs:
 runs:
  using: "composite"
  steps:
+ # node-gyp@latest (invoked via bunx for native install scripts) requires Node >=22;
+ # some runner images ship an older system Node on PATH
+ - name: Setup Node
+ uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
+ with:
+ node-version: "24"
+
  - name: Get baseline download URL
  id: bun-url
  shell: bash

.github/workflows/compliance-close.yml

@@ -34,10 +34,48 @@ jobs:
 
  const now = Date.now();
  const twoHours = 2 * 60 * 60 * 1000;
+ const orgMemberAssociations = new Set(['OWNER', 'MEMBER']);
+ const agentLogin = 'opencode-agent[bot]';
+ const { data: file } = await github.rest.repos.getContent({
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ path: '.github/TEAM_MEMBERS',
+ ref: 'dev',
+ });
+ const teamMembers = new Set(
+ Buffer.from(file.content, 'base64')
+ .toString()
+ .split('\n')
+ .map((line) => line.trim().toLowerCase())
+ .filter(Boolean)
+ );
+
+ function isExempt(item) {
+ const login = item.user?.login?.toLowerCase();
+ return (
+ login === agentLogin ||
+ orgMemberAssociations.has(item.author_association) ||
+ (login && teamMembers.has(login))
+ );
+ }
 
  for (const item of items) {
  const isPR = !!item.pull_request;
  const kind = isPR ? 'PR' : 'issue';
+ const login = item.user?.login;
+
+ if (isExempt(item)) {
+ core.info(`Skipping ${kind} #${item.number}; author ${login || 'unknown'} is exempt`);
+ try {
+ await github.rest.issues.removeLabel({
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ issue_number: item.number,
+ name: 'needs:compliance',
+ });
+ } catch (e) {}
+ continue;
+ }
 
  const { data: comments } = await github.rest.issues.listComments({
  owner: context.repo.owner,

.github/workflows/duplicate-issues.yml

@@ -17,12 +17,31 @@ jobs:
  with:
  fetch-depth: 1
 
+ - name: Check exempt issue author
+ id: author
+ run: |
+ LOGIN="${{ github.event.issue.user.login }}"
+ ASSOCIATION="${{ github.event.issue.author_association }}"
+
+ if [ "$LOGIN" = "opencode-agent[bot]" ] ||
+ [ "$ASSOCIATION" = "OWNER" ] ||
+ [ "$ASSOCIATION" = "MEMBER" ] ||
+ grep -qxiF "$LOGIN" .github/TEAM_MEMBERS; then
+ echo "skip=true" >> "$GITHUB_OUTPUT"
+ echo "Skipping issue automation for exempt author: $LOGIN ($ASSOCIATION)"
+ else
+ echo "skip=false" >> "$GITHUB_OUTPUT"
+ fi
+
  - uses: ./.github/actions/setup-bun
+ if: steps.author.outputs.skip != 'true'
 
  - name: Install opencode
+ if: steps.author.outputs.skip != 'true'
  run: curl -fsSL https://opencode.ai/install | bash
 
  - name: Check duplicates and compliance
+ if: steps.author.outputs.skip != 'true'
  env:
  OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -38,6 +57,7 @@ jobs:
  opencode run -m opencode/claude-sonnet-4-6 "A new issue has been created:
 
  Issue number: ${{ github.event.issue.number }}
+ Issue author association: ${{ github.event.issue.author_association }}
 
  Lookup this issue with gh issue view ${{ github.event.issue.number }}.
 
@@ -49,6 +69,8 @@ jobs:
 
  Check whether the issue follows our contributing guidelines and issue templates.
 
+ If the issue author association is OWNER or MEMBER, skip this compliance check. Do not add the needs:compliance label for organization-owned issues.
+
  This project has three issue templates that every issue MUST use one of:
 
  1. Bug Report - requires a Description field with real content
@@ -83,7 +105,7 @@ jobs:
 
  Based on your findings, post a SINGLE comment on issue #${{ github.event.issue.number }}. Build the comment as follows:
 
- If the issue is NOT compliant, start the comment with:
+ If the issue is NOT compliant and the author association is not OWNER or MEMBER, start the comment with:
  <!-- issue-compliance -->
  Then explain what needs to be fixed and that they have 2 hours to edit the issue before it is automatically closed. Also add the label needs:compliance to the issue using: gh issue edit ${{ github.event.issue.number }} --add-label needs:compliance
 
@@ -129,12 +151,31 @@ jobs:
  with:
  fetch-depth: 1
 
+ - name: Check exempt issue author
+ id: author
+ run: |
+ LOGIN="${{ github.event.issue.user.login }}"
+ ASSOCIATION="${{ github.event.issue.author_association }}"
+
+ if [ "$LOGIN" = "opencode-agent[bot]" ] ||
+ [ "$ASSOCIATION" = "OWNER" ] ||
+ [ "$ASSOCIATION" = "MEMBER" ] ||
+ grep -qxiF "$LOGIN" .github/TEAM_MEMBERS; then
+ echo "skip=true" >> "$GITHUB_OUTPUT"
+ echo "Skipping issue automation for exempt author: $LOGIN ($ASSOCIATION)"
+ else
+ echo "skip=false" >> "$GITHUB_OUTPUT"
+ fi
+
  - uses: ./.github/actions/setup-bun
+ if: steps.author.outputs.skip != 'true'
 
  - name: Install opencode
+ if: steps.author.outputs.skip != 'true'
  run: curl -fsSL https://opencode.ai/install | bash
 
  - name: Recheck compliance
+ if: steps.author.outputs.skip != 'true'
  env:
  OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -148,9 +189,12 @@ jobs:
  }
  run: |
  opencode run -m opencode/claude-sonnet-4-6 "Issue #${{ github.event.issue.number }} was previously flagged as non-compliant and has been edited.
+ Issue author association: ${{ github.event.issue.author_association }}
 
  Lookup this issue with gh issue view ${{ github.event.issue.number }}.
 
+ If the issue author association is OWNER or MEMBER, remove the needs:compliance label if present, delete the previous compliance comment if present, and do not post a new comment.
+
  Re-check whether the issue now follows our contributing guidelines and issue templates.
 
  This project has three issue templates that every issue MUST use one of:

.github/workflows/publish.yml

@@ -219,7 +219,6 @@ jobs:
 
  build-electron:
  needs:
- - build-cli
  - version
  if: github.repository == 'anomalyco/opencode'
  continue-on-error: false
@@ -316,15 +315,13 @@ jobs:
  env:
  OPENCODE_VERSION: ${{ needs.version.outputs.version }}
  OPENCODE_CHANNEL: ${{ (github.ref_name == 'beta' && 'beta') || 'prod' }}
- OPENCODE_CLI_ARTIFACT: ${{ (runner.os == 'Windows' && 'opencode-cli-windows') || 'opencode-cli' }}
  RUST_TARGET: ${{ matrix.settings.target }}
- GH_TOKEN: ${{ github.token }}
- GITHUB_RUN_ID: ${{ github.run_id }}
 
  - name: Build
  run: bun run build
  working-directory: packages/desktop
  env:
+ NODE_OPTIONS: --max-old-space-size=4096
  OPENCODE_CHANNEL: ${{ (github.ref_name == 'beta' && 'beta') || 'prod' }}
  SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
  SENTRY_ORG: ${{ vars.SENTRY_ORG }}

.github/workflows/storybook.yml

@@ -9,6 +9,7 @@ on:
  - "bun.lock"
  - "packages/storybook/**"
  - "packages/ui/**"
+ - "packages/session-ui/**"
  pull_request:
  branches: [dev]
  paths:
@@ -17,6 +18,7 @@ on:
  - "bun.lock"
  - "packages/storybook/**"
  - "packages/ui/**"
+ - "packages/session-ui/**"
  workflow_dispatch:
 
 concurrency:

.github/workflows/test.yml

@@ -79,10 +79,15 @@ jobs:
 
  - name: Run unit tests
  timeout-minutes: 45
- run: bun turbo test --output-logs=errors-only --log-order=grouped --log-prefix=task
+ run: GITHUB_ACTIONS=false bun turbo test --output-logs=errors-only --log-order=grouped --log-prefix=task
  env:
  OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER: ${{ runner.os == 'Windows' && 'true' || 'false' }}
 
+ - name: Check generated client
+ if: runner.os == 'Linux'
+ working-directory: packages/client
+ run: bun run check:generated
+
  - name: Run HttpApi exerciser gates
  if: runner.os == 'Linux'
  working-directory: packages/opencode

.github/workflows/triage.yml

@@ -16,13 +16,32 @@ jobs:
  with:
  fetch-depth: 1
 
+ - name: Check exempt issue author
+ id: author
+ run: |
+ LOGIN="${{ github.event.issue.user.login }}"
+ ASSOCIATION="${{ github.event.issue.author_association }}"
+
+ if [ "$LOGIN" = "opencode-agent[bot]" ] ||
+ [ "$ASSOCIATION" = "OWNER" ] ||
+ [ "$ASSOCIATION" = "MEMBER" ] ||
+ grep -qxiF "$LOGIN" .github/TEAM_MEMBERS; then
+ echo "skip=true" >> "$GITHUB_OUTPUT"
+ echo "Skipping issue automation for exempt author: $LOGIN ($ASSOCIATION)"
+ else
+ echo "skip=false" >> "$GITHUB_OUTPUT"
+ fi
+
  - name: Setup Bun
+ if: steps.author.outputs.skip != 'true'
  uses: ./.github/actions/setup-bun
 
  - name: Install opencode
+ if: steps.author.outputs.skip != 'true'
  run: curl -fsSL https://opencode.ai/install | bash
 
  - name: Triage issue
+ if: steps.author.outputs.skip != 'true'
  env:
  OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.opencode/command/translate.md

@@ -1,6 +1,6 @@
 ---
 description: translate English to other languages
-model: opencode/claude-opus-4-8
+model: opencode/gpt-5.6-sol
 ---
 
 run git diff and translate changed english doc and UI copy files to other international languages. Translate all languages in parallel to save time.

.opencode/opencode.jsonc

@@ -2,9 +2,7 @@
  "$schema": "https://opencode.ai/config.json",
  "provider": {},
  "permission": {},
- // TODO: flip back to `references` once a release containing the v1 `reference` migration ships.
- // The release pipeline runs the latest published opencode against this file, which only knows `reference`.
- "reference": {
+ "references": {
  "effect": {
  "repository": "github.com/Effect-TS/effect-smol",
  "description": "Use for Effect v4 and effect-smol implementation details",

.opencode/tool/github-triage.ts

@@ -4,7 +4,7 @@ import { tool } from "@opencode-ai/plugin"
 const TEAM = {
  tui: ["kommander", "simonklee"],
  desktop_web: ["Hona", "Brendonovich"],
- core: ["jlongster", "rekram1-node", "nexxeln", "kitlangton", "starptech"],
+ core: ["jlongster", "rekram1-node", "nexxeln", "kitlangton"],
  inference: ["fwang", "MrMushrooooom", "starptech"],
  windows: ["Hona"],
 } as const

.prettierignore

@@ -1,2 +1,4 @@
 sst-env.d.ts
 packages/desktop/src/bindings.ts
+packages/client/src/generated/
+packages/client/src/generated-effect/

AGENTS.md

@@ -1,7 +1,15 @@
-- To regenerate the JavaScript SDK, run `./packages/sdk/js/script/build.ts`.
+- To regenerate the legacy JavaScript SDK, run `./packages/sdk/js/script/build.ts`.
+- After changing the public Protocol or Server `HttpApi`, run `bun run generate` from `packages/client`. Do not edit `src/generated` or `src/generated-effect` directly.
+- Keep runtime dependencies directed from Schema to Core and Protocol, then from Core and Protocol to Server. Client runtime code may depend on Schema and Protocol but never Core or Server; `sdk-next` composes Client, Core, and Server.
 - The default branch in this repo is `dev`.
 - Local `main` ref may not exist; use `dev` or `origin/dev` for diffs.
 
+## Branch Names
+
+Use a short branch name of at most three words, separated by hyphens. Do not use slashes or type prefixes such as `feat/` or `fix/`.
+
+Examples: `session-recovery`, `fix-scroll-state`, `regenerate-sdk`.
+
 ## Commits and PR Titles
 
 Use conventional commit-style messages and PR titles: `type(scope): summary`.
@@ -22,6 +30,7 @@ Examples: `fix(tui): simplify thinking toggle styling`, `docs: update contributi
 - Rely on type inference when possible; avoid explicit type annotations or interfaces unless necessary for exports or clarity
 - Prefer functional array methods (flatMap, filter, map) over for loops; use type guards on filter to maintain type inference downstream
 - In `src/config`, follow the existing self-export pattern at the top of the file (for example `export * as ConfigAgent from "./agent"`) when adding a new config module.
+- In Effect generators, bind services to named variables before calling methods. Do not use nested service yields such as `yield* (yield* Foo.Service).bar()`.
 
 Reduce total variable count by inlining when a value is only used once.
 
@@ -131,7 +140,7 @@ const table = sqliteTable("session", {
 
 ## Testing
 
-- Avoid mocks as much as possible
+- Avoid mocks as much as possible, you shouldn't be using globalThis.\* at all unless it's the only option.
 - Test actual implementation, do not duplicate logic into tests
 - Tests cannot run from repo root (guard: `do-not-run-tests-from-root`); run from package dirs like `packages/opencode`.
 
@@ -146,7 +155,7 @@ const table = sqliteTable("session", {
 - Keep `SessionExecution` process-global and Session-ID based. Its local implementation owns the process-local Session coordinator and discovers placement through `SessionStore` plus `LocationServiceMap.get(session.location)` only when a drain starts; no layer should take a Session ID. V2 interruption targets the active process-local ownership chain for that Session; idle or missing interruption is a no-op.
 - Keep `SessionRunner`, model resolution, tool registry, permissions, and filesystem Location-scoped. Omitted `Location.workspaceID` means implicit-local placement; explicit workspace identity remains reserved for future placement semantics.
 - Preserve one explicit `llm.stream(request)` call per provider turn and reload projected history before durable continuation. Do not bridge through legacy `SessionPrompt.loop(...)` or delegate orchestration to an in-memory tool loop.
-- Keep local Session drains process-local until clustering is implemented. `SessionRunCoordinator` joins explicit same-Session resumes, coalesces prompt wakeups, and allows different Sessions to run concurrently. Advisory wakes drain eligible durable inbox rows only; post-crash activity recovery requires a separate explicit design before it may retry provider work.
-- Keep delivery vocabulary explicit. Prompts steer by default and coalesce into the active activity at the next safe provider-turn boundary. Explicit `queue` inputs open FIFO future activities one at a time after the active activity settles.
+- Keep local Session drains process-local until clustering is implemented. `SessionRunCoordinator` joins explicit same-Session resumes, coalesces prompt wakeups, and allows different Sessions to run concurrently. Advisory wakes drain eligible durable inbox rows only; post-crash continuation recovery requires a separate explicit design before it may retry provider work. A drain has no durable identity or transcript boundary.
+- Keep delivery vocabulary explicit. Prompts steer by default and promote at the next safe provider-turn boundary while the current drain requires continuation. An explicit `queue` input remains pending until the Session would otherwise become idle; promote one queued input at that boundary, then reevaluate continuation before promoting another. Promoting any new user input resets the selected agent's provider-turn allowance; a batch of steers resets it once.
 - Keep EventV2 replay owner claims separate from clustered Session execution ownership.
 - Keep the System Context algebra, registry, and built-ins in `src/system-context`; keep Context Source producers with their observed domains, and keep Session History selection plus Context Epoch persistence Session-owned.

.github/ISSUE_TEMPLATE/config.yml

@@ -2,4 +2,4 @@ blank_issues_enabled: false
 contact_links:
  - name: 💬 Discord Community
 url: https://discord.gg/opencode
-about: For quick questions or real-time discussion. Note that issues are searchable and help others with the same question.
+about: For support, troubleshooting, how-to questions, and real-time discussion.

.github/TEAM_MEMBERS

@@ -1,4 +1,5 @@
 adamdotdevin
+arvsrn
 Brendonovich
 fwang
 Hona
@@ -7,11 +8,14 @@ jayair
 jlongster
 kitlangton
 kommander
+ludvigrask
 MrMushrooooom
 nexxeln
 R44VC0RP
 rekram1-node
 thdxr
 simonklee
+Slickstef11
+usrnk1
 vimtor
-starptech
+StarpTech

.github/actions/setup-bun/action.yml

@@ -8,6 +8,13 @@ inputs:
 runs:
  using: "composite"
  steps:
+ # node-gyp@latest (invoked via bunx for native install scripts) requires Node >=22;
+ # some runner images ship an older system Node on PATH
+ - name: Setup Node
+ uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
+ with:
+ node-version: "24"
+
  - name: Get baseline download URL
  id: bun-url
  shell: bash

.github/workflows/compliance-close.yml

@@ -34,10 +34,48 @@ jobs:
 
  const now = Date.now();
  const twoHours = 2 * 60 * 60 * 1000;
+ const orgMemberAssociations = new Set(['OWNER', 'MEMBER']);
+ const agentLogin = 'opencode-agent[bot]';
+ const { data: file } = await github.rest.repos.getContent({
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ path: '.github/TEAM_MEMBERS',
+ ref: 'dev',
+ });
+ const teamMembers = new Set(
+ Buffer.from(file.content, 'base64')
+ .toString()
+ .split('\n')
+ .map((line) => line.trim().toLowerCase())
+ .filter(Boolean)
+ );
+
+ function isExempt(item) {
+ const login = item.user?.login?.toLowerCase();
+ return (
+ login === agentLogin ||
+ orgMemberAssociations.has(item.author_association) ||
+ (login && teamMembers.has(login))
+ );
+ }
 
  for (const item of items) {
  const isPR = !!item.pull_request;
  const kind = isPR ? 'PR' : 'issue';
+ const login = item.user?.login;
+
+ if (isExempt(item)) {
+ core.info(`Skipping ${kind} #${item.number}; author ${login || 'unknown'} is exempt`);
+ try {
+ await github.rest.issues.removeLabel({
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ issue_number: item.number,
+ name: 'needs:compliance',
+ });
+ } catch (e) {}
+ continue;
+ }
 
  const { data: comments } = await github.rest.issues.listComments({
  owner: context.repo.owner,

.github/workflows/duplicate-issues.yml

@@ -17,12 +17,31 @@ jobs:
  with:
  fetch-depth: 1
 
+ - name: Check exempt issue author
+ id: author
+ run: |
+ LOGIN="${{ github.event.issue.user.login }}"
+ ASSOCIATION="${{ github.event.issue.author_association }}"
+
+ if [ "$LOGIN" = "opencode-agent[bot]" ] ||
+ [ "$ASSOCIATION" = "OWNER" ] ||
+ [ "$ASSOCIATION" = "MEMBER" ] ||
+ grep -qxiF "$LOGIN" .github/TEAM_MEMBERS; then
+ echo "skip=true" >> "$GITHUB_OUTPUT"
+ echo "Skipping issue automation for exempt author: $LOGIN ($ASSOCIATION)"
+ else
+ echo "skip=false" >> "$GITHUB_OUTPUT"
+ fi
+
  - uses: ./.github/actions/setup-bun
+ if: steps.author.outputs.skip != 'true'
 
  - name: Install opencode
+ if: steps.author.outputs.skip != 'true'
  run: curl -fsSL https://opencode.ai/install | bash
 
  - name: Check duplicates and compliance
+ if: steps.author.outputs.skip != 'true'
  env:
  OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -38,6 +57,7 @@ jobs:
  opencode run -m opencode/claude-sonnet-4-6 "A new issue has been created:
 
  Issue number: ${{ github.event.issue.number }}
+ Issue author association: ${{ github.event.issue.author_association }}
 
  Lookup this issue with gh issue view ${{ github.event.issue.number }}.
 
@@ -49,6 +69,8 @@ jobs:
 
  Check whether the issue follows our contributing guidelines and issue templates.
 
+ If the issue author association is OWNER or MEMBER, skip this compliance check. Do not add the needs:compliance label for organization-owned issues.
+
  This project has three issue templates that every issue MUST use one of:
 
  1. Bug Report - requires a Description field with real content
@@ -83,7 +105,7 @@ jobs:
 
  Based on your findings, post a SINGLE comment on issue #${{ github.event.issue.number }}. Build the comment as follows:
 
- If the issue is NOT compliant, start the comment with:
+ If the issue is NOT compliant and the author association is not OWNER or MEMBER, start the comment with:
  <!-- issue-compliance -->
  Then explain what needs to be fixed and that they have 2 hours to edit the issue before it is automatically closed. Also add the label needs:compliance to the issue using: gh issue edit ${{ github.event.issue.number }} --add-label needs:compliance
 
@@ -129,12 +151,31 @@ jobs:
  with:
  fetch-depth: 1
 
+ - name: Check exempt issue author
+ id: author
+ run: |
+ LOGIN="${{ github.event.issue.user.login }}"
+ ASSOCIATION="${{ github.event.issue.author_association }}"
+
+ if [ "$LOGIN" = "opencode-agent[bot]" ] ||
+ [ "$ASSOCIATION" = "OWNER" ] ||
+ [ "$ASSOCIATION" = "MEMBER" ] ||
+ grep -qxiF "$LOGIN" .github/TEAM_MEMBERS; then
+ echo "skip=true" >> "$GITHUB_OUTPUT"
+ echo "Skipping issue automation for exempt author: $LOGIN ($ASSOCIATION)"
+ else
+ echo "skip=false" >> "$GITHUB_OUTPUT"
+ fi
+
  - uses: ./.github/actions/setup-bun
+ if: steps.author.outputs.skip != 'true'
 
  - name: Install opencode
+ if: steps.author.outputs.skip != 'true'
  run: curl -fsSL https://opencode.ai/install | bash
 
  - name: Recheck compliance
+ if: steps.author.outputs.skip != 'true'
  env:
  OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -148,9 +189,12 @@ jobs:
  }
  run: |
  opencode run -m opencode/claude-sonnet-4-6 "Issue #${{ github.event.issue.number }} was previously flagged as non-compliant and has been edited.
+ Issue author association: ${{ github.event.issue.author_association }}
 
  Lookup this issue with gh issue view ${{ github.event.issue.number }}.
 
+ If the issue author association is OWNER or MEMBER, remove the needs:compliance label if present, delete the previous compliance comment if present, and do not post a new comment.
+
  Re-check whether the issue now follows our contributing guidelines and issue templates.
 
  This project has three issue templates that every issue MUST use one of:

.github/workflows/publish.yml

@@ -219,7 +219,6 @@ jobs:
 
  build-electron:
  needs:
- - build-cli
  - version
  if: github.repository == 'anomalyco/opencode'
  continue-on-error: false
@@ -316,15 +315,13 @@ jobs:
  env:
  OPENCODE_VERSION: ${{ needs.version.outputs.version }}
  OPENCODE_CHANNEL: ${{ (github.ref_name == 'beta' && 'beta') || 'prod' }}
- OPENCODE_CLI_ARTIFACT: ${{ (runner.os == 'Windows' && 'opencode-cli-windows') || 'opencode-cli' }}
  RUST_TARGET: ${{ matrix.settings.target }}
- GH_TOKEN: ${{ github.token }}
- GITHUB_RUN_ID: ${{ github.run_id }}
 
  - name: Build
  run: bun run build
  working-directory: packages/desktop
  env:
+ NODE_OPTIONS: --max-old-space-size=4096
  OPENCODE_CHANNEL: ${{ (github.ref_name == 'beta' && 'beta') || 'prod' }}
  SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
  SENTRY_ORG: ${{ vars.SENTRY_ORG }}

.github/workflows/storybook.yml

@@ -9,6 +9,7 @@ on:
  - "bun.lock"
  - "packages/storybook/**"
  - "packages/ui/**"
+ - "packages/session-ui/**"
  pull_request:
  branches: [dev]
  paths:
@@ -17,6 +18,7 @@ on:
  - "bun.lock"
  - "packages/storybook/**"
  - "packages/ui/**"
+ - "packages/session-ui/**"
  workflow_dispatch:
 
 concurrency:

.github/workflows/test.yml

@@ -79,10 +79,15 @@ jobs:
 
  - name: Run unit tests
  timeout-minutes: 45
- run: bun turbo test --output-logs=errors-only --log-order=grouped --log-prefix=task
+ run: GITHUB_ACTIONS=false bun turbo test --output-logs=errors-only --log-order=grouped --log-prefix=task
  env:
  OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER: ${{ runner.os == 'Windows' && 'true' || 'false' }}
 
+ - name: Check generated client
+ if: runner.os == 'Linux'
+ working-directory: packages/client
+ run: bun run check:generated
+
  - name: Run HttpApi exerciser gates
  if: runner.os == 'Linux'
  working-directory: packages/opencode

.github/workflows/triage.yml

@@ -16,13 +16,32 @@ jobs:
  with:
  fetch-depth: 1
 
+ - name: Check exempt issue author
+ id: author
+ run: |
+ LOGIN="${{ github.event.issue.user.login }}"
+ ASSOCIATION="${{ github.event.issue.author_association }}"
+
+ if [ "$LOGIN" = "opencode-agent[bot]" ] ||
+ [ "$ASSOCIATION" = "OWNER" ] ||
+ [ "$ASSOCIATION" = "MEMBER" ] ||
+ grep -qxiF "$LOGIN" .github/TEAM_MEMBERS; then
+ echo "skip=true" >> "$GITHUB_OUTPUT"
+ echo "Skipping issue automation for exempt author: $LOGIN ($ASSOCIATION)"
+ else
+ echo "skip=false" >> "$GITHUB_OUTPUT"
+ fi
+
  - name: Setup Bun
+ if: steps.author.outputs.skip != 'true'
  uses: ./.github/actions/setup-bun
 
  - name: Install opencode
+ if: steps.author.outputs.skip != 'true'
  run: curl -fsSL https://opencode.ai/install | bash
 
  - name: Triage issue
+ if: steps.author.outputs.skip != 'true'
  env:
  OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.opencode/command/translate.md

@@ -1,6 +1,6 @@
 ---
 description: translate English to other languages
-model: opencode/claude-opus-4-8
+model: opencode/gpt-5.6-sol
 ---
 
 run git diff and translate changed english doc and UI copy files to other international languages. Translate all languages in parallel to save time.

.opencode/opencode.jsonc

@@ -2,9 +2,7 @@
  "$schema": "https://opencode.ai/config.json",
  "provider": {},
  "permission": {},
- // TODO: flip back to `references` once a release containing the v1 `reference` migration ships.
- // The release pipeline runs the latest published opencode against this file, which only knows `reference`.
- "reference": {
+ "references": {
  "effect": {
  "repository": "github.com/Effect-TS/effect-smol",
  "description": "Use for Effect v4 and effect-smol implementation details",

.opencode/tool/github-triage.ts

@@ -4,7 +4,7 @@ import { tool } from "@opencode-ai/plugin"
 const TEAM = {
  tui: ["kommander", "simonklee"],
  desktop_web: ["Hona", "Brendonovich"],
- core: ["jlongster", "rekram1-node", "nexxeln", "kitlangton", "starptech"],
+ core: ["jlongster", "rekram1-node", "nexxeln", "kitlangton"],
  inference: ["fwang", "MrMushrooooom", "starptech"],
  windows: ["Hona"],
 } as const

.prettierignore

@@ -1,2 +1,4 @@
 sst-env.d.ts
 packages/desktop/src/bindings.ts
+packages/client/src/generated/
+packages/client/src/generated-effect/

AGENTS.md

@@ -1,7 +1,15 @@
-- To regenerate the JavaScript SDK, run `./packages/sdk/js/script/build.ts`.
+- To regenerate the legacy JavaScript SDK, run `./packages/sdk/js/script/build.ts`.
+- After changing the public Protocol or Server `HttpApi`, run `bun run generate` from `packages/client`. Do not edit `src/generated` or `src/generated-effect` directly.
+- Keep runtime dependencies directed from Schema to Core and Protocol, then from Core and Protocol to Server. Client runtime code may depend on Schema and Protocol but never Core or Server; `sdk-next` composes Client, Core, and Server.
 - The default branch in this repo is `dev`.
 - Local `main` ref may not exist; use `dev` or `origin/dev` for diffs.
 
+## Branch Names
+
+Use a short branch name of at most three words, separated by hyphens. Do not use slashes or type prefixes such as `feat/` or `fix/`.
+
+Examples: `session-recovery`, `fix-scroll-state`, `regenerate-sdk`.
+
 ## Commits and PR Titles
 
 Use conventional commit-style messages and PR titles: `type(scope): summary`.
@@ -22,6 +30,7 @@ Examples: `fix(tui): simplify thinking toggle styling`, `docs: update contributi
 - Rely on type inference when possible; avoid explicit type annotations or interfaces unless necessary for exports or clarity
 - Prefer functional array methods (flatMap, filter, map) over for loops; use type guards on filter to maintain type inference downstream
 - In `src/config`, follow the existing self-export pattern at the top of the file (for example `export * as ConfigAgent from "./agent"`) when adding a new config module.
+- In Effect generators, bind services to named variables before calling methods. Do not use nested service yields such as `yield* (yield* Foo.Service).bar()`.
 
 Reduce total variable count by inlining when a value is only used once.
 
@@ -131,7 +140,7 @@ const table = sqliteTable("session", {
 
 ## Testing
 
-- Avoid mocks as much as possible
+- Avoid mocks as much as possible, you shouldn't be using globalThis.\* at all unless it's the only option.
 - Test actual implementation, do not duplicate logic into tests
 - Tests cannot run from repo root (guard: `do-not-run-tests-from-root`); run from package dirs like `packages/opencode`.
 
@@ -146,7 +155,7 @@ const table = sqliteTable("session", {
 - Keep `SessionExecution` process-global and Session-ID based. Its local implementation owns the process-local Session coordinator and discovers placement through `SessionStore` plus `LocationServiceMap.get(session.location)` only when a drain starts; no layer should take a Session ID. V2 interruption targets the active process-local ownership chain for that Session; idle or missing interruption is a no-op.
 - Keep `SessionRunner`, model resolution, tool registry, permissions, and filesystem Location-scoped. Omitted `Location.workspaceID` means implicit-local placement; explicit workspace identity remains reserved for future placement semantics.
 - Preserve one explicit `llm.stream(request)` call per provider turn and reload projected history before durable continuation. Do not bridge through legacy `SessionPrompt.loop(...)` or delegate orchestration to an in-memory tool loop.
-- Keep local Session drains process-local until clustering is implemented. `SessionRunCoordinator` joins explicit same-Session resumes, coalesces prompt wakeups, and allows different Sessions to run concurrently. Advisory wakes drain eligible durable inbox rows only; post-crash activity recovery requires a separate explicit design before it may retry provider work.
-- Keep delivery vocabulary explicit. Prompts steer by default and coalesce into the active activity at the next safe provider-turn boundary. Explicit `queue` inputs open FIFO future activities one at a time after the active activity settles.
+- Keep local Session drains process-local until clustering is implemented. `SessionRunCoordinator` joins explicit same-Session resumes, coalesces prompt wakeups, and allows different Sessions to run concurrently. Advisory wakes drain eligible durable inbox rows only; post-crash continuation recovery requires a separate explicit design before it may retry provider work. A drain has no durable identity or transcript boundary.
+- Keep delivery vocabulary explicit. Prompts steer by default and promote at the next safe provider-turn boundary while the current drain requires continuation. An explicit `queue` input remains pending until the Session would otherwise become idle; promote one queued input at that boundary, then reevaluate continuation before promoting another. Promoting any new user input resets the selected agent's provider-turn allowance; a batch of steers resets it once.
 - Keep EventV2 replay owner claims separate from clustered Session execution ownership.
 - Keep the System Context algebra, registry, and built-ins in `src/system-context`; keep Context Source producers with their observed domains, and keep Session History selection plus Context Epoch persistence Session-owned.

.github/ISSUE_TEMPLATE/config.yml

@@ -2,4 +2,4 @@ blank_issues_enabled: false
 contact_links:
  - name: 💬 Discord Community
 url: https://discord.gg/opencode
-about: For quick questions or real-time discussion. Note that issues are searchable and help others with the same question.
+about: For support, troubleshooting, how-to questions, and real-time discussion.

.github/TEAM_MEMBERS

@@ -1,4 +1,5 @@
 adamdotdevin
+arvsrn
 Brendonovich
 fwang
 Hona
@@ -7,11 +8,14 @@ jayair
 jlongster
 kitlangton
 kommander
+ludvigrask
 MrMushrooooom
 nexxeln
 R44VC0RP
 rekram1-node
 thdxr
 simonklee
+Slickstef11
+usrnk1
 vimtor
-starptech
+StarpTech

.github/actions/setup-bun/action.yml

@@ -8,6 +8,13 @@ inputs:
 runs:
  using: "composite"
  steps:
+ # node-gyp@latest (invoked via bunx for native install scripts) requires Node >=22;
+ # some runner images ship an older system Node on PATH
+ - name: Setup Node
+ uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
+ with:
+ node-version: "24"
+
  - name: Get baseline download URL
  id: bun-url
  shell: bash

.github/workflows/compliance-close.yml

@@ -34,10 +34,48 @@ jobs:
 
  const now = Date.now();
  const twoHours = 2 * 60 * 60 * 1000;
+ const orgMemberAssociations = new Set(['OWNER', 'MEMBER']);
+ const agentLogin = 'opencode-agent[bot]';
+ const { data: file } = await github.rest.repos.getContent({
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ path: '.github/TEAM_MEMBERS',
+ ref: 'dev',
+ });
+ const teamMembers = new Set(
+ Buffer.from(file.content, 'base64')
+ .toString()
+ .split('\n')
+ .map((line) => line.trim().toLowerCase())
+ .filter(Boolean)
+ );
+
+ function isExempt(item) {
+ const login = item.user?.login?.toLowerCase();
+ return (
+ login === agentLogin ||
+ orgMemberAssociations.has(item.author_association) ||
+ (login && teamMembers.has(login))
+ );
+ }
 
  for (const item of items) {
  const isPR = !!item.pull_request;
  const kind = isPR ? 'PR' : 'issue';
+ const login = item.user?.login;
+
+ if (isExempt(item)) {
+ core.info(`Skipping ${kind} #${item.number}; author ${login || 'unknown'} is exempt`);
+ try {
+ await github.rest.issues.removeLabel({
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ issue_number: item.number,
+ name: 'needs:compliance',
+ });
+ } catch (e) {}
+ continue;
+ }
 
  const { data: comments } = await github.rest.issues.listComments({
  owner: context.repo.owner,

.github/workflows/duplicate-issues.yml

@@ -17,12 +17,31 @@ jobs:
  with:
  fetch-depth: 1
 
+ - name: Check exempt issue author
+ id: author
+ run: |
+ LOGIN="${{ github.event.issue.user.login }}"
+ ASSOCIATION="${{ github.event.issue.author_association }}"
+
+ if [ "$LOGIN" = "opencode-agent[bot]" ] ||
+ [ "$ASSOCIATION" = "OWNER" ] ||
+ [ "$ASSOCIATION" = "MEMBER" ] ||
+ grep -qxiF "$LOGIN" .github/TEAM_MEMBERS; then
+ echo "skip=true" >> "$GITHUB_OUTPUT"
+ echo "Skipping issue automation for exempt author: $LOGIN ($ASSOCIATION)"
+ else
+ echo "skip=false" >> "$GITHUB_OUTPUT"
+ fi
+
  - uses: ./.github/actions/setup-bun
+ if: steps.author.outputs.skip != 'true'
 
  - name: Install opencode
+ if: steps.author.outputs.skip != 'true'
  run: curl -fsSL https://opencode.ai/install | bash
 
  - name: Check duplicates and compliance
+ if: steps.author.outputs.skip != 'true'
  env:
  OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -38,6 +57,7 @@ jobs:
  opencode run -m opencode/claude-sonnet-4-6 "A new issue has been created:
 
  Issue number: ${{ github.event.issue.number }}
+ Issue author association: ${{ github.event.issue.author_association }}
 
  Lookup this issue with gh issue view ${{ github.event.issue.number }}.
 
@@ -49,6 +69,8 @@ jobs:
 
  Check whether the issue follows our contributing guidelines and issue templates.
 
+ If the issue author association is OWNER or MEMBER, skip this compliance check. Do not add the needs:compliance label for organization-owned issues.
+
  This project has three issue templates that every issue MUST use one of:
 
  1. Bug Report - requires a Description field with real content
@@ -83,7 +105,7 @@ jobs:
 
  Based on your findings, post a SINGLE comment on issue #${{ github.event.issue.number }}. Build the comment as follows:
 
- If the issue is NOT compliant, start the comment with:
+ If the issue is NOT compliant and the author association is not OWNER or MEMBER, start the comment with:
  <!-- issue-compliance -->
  Then explain what needs to be fixed and that they have 2 hours to edit the issue before it is automatically closed. Also add the label needs:compliance to the issue using: gh issue edit ${{ github.event.issue.number }} --add-label needs:compliance
 
@@ -129,12 +151,31 @@ jobs:
  with:
  fetch-depth: 1
 
+ - name: Check exempt issue author
+ id: author
+ run: |
+ LOGIN="${{ github.event.issue.user.login }}"
+ ASSOCIATION="${{ github.event.issue.author_association }}"
+
+ if [ "$LOGIN" = "opencode-agent[bot]" ] ||
+ [ "$ASSOCIATION" = "OWNER" ] ||
+ [ "$ASSOCIATION" = "MEMBER" ] ||
+ grep -qxiF "$LOGIN" .github/TEAM_MEMBERS; then
+ echo "skip=true" >> "$GITHUB_OUTPUT"
+ echo "Skipping issue automation for exempt author: $LOGIN ($ASSOCIATION)"
+ else
+ echo "skip=false" >> "$GITHUB_OUTPUT"
+ fi
+
  - uses: ./.github/actions/setup-bun
+ if: steps.author.outputs.skip != 'true'
 
  - name: Install opencode
+ if: steps.author.outputs.skip != 'true'
  run: curl -fsSL https://opencode.ai/install | bash
 
  - name: Recheck compliance
+ if: steps.author.outputs.skip != 'true'
  env:
  OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -148,9 +189,12 @@ jobs:
  }
  run: |
  opencode run -m opencode/claude-sonnet-4-6 "Issue #${{ github.event.issue.number }} was previously flagged as non-compliant and has been edited.
+ Issue author association: ${{ github.event.issue.author_association }}
 
  Lookup this issue with gh issue view ${{ github.event.issue.number }}.
 
+ If the issue author association is OWNER or MEMBER, remove the needs:compliance label if present, delete the previous compliance comment if present, and do not post a new comment.
+
  Re-check whether the issue now follows our contributing guidelines and issue templates.
 
  This project has three issue templates that every issue MUST use one of:

.github/workflows/publish.yml

@@ -219,7 +219,6 @@ jobs:
 
  build-electron:
  needs:
- - build-cli
  - version
  if: github.repository == 'anomalyco/opencode'
  continue-on-error: false
@@ -316,15 +315,13 @@ jobs:
  env:
  OPENCODE_VERSION: ${{ needs.version.outputs.version }}
  OPENCODE_CHANNEL: ${{ (github.ref_name == 'beta' && 'beta') || 'prod' }}
- OPENCODE_CLI_ARTIFACT: ${{ (runner.os == 'Windows' && 'opencode-cli-windows') || 'opencode-cli' }}
  RUST_TARGET: ${{ matrix.settings.target }}
- GH_TOKEN: ${{ github.token }}
- GITHUB_RUN_ID: ${{ github.run_id }}
 
  - name: Build
  run: bun run build
  working-directory: packages/desktop
  env:
+ NODE_OPTIONS: --max-old-space-size=4096
  OPENCODE_CHANNEL: ${{ (github.ref_name == 'beta' && 'beta') || 'prod' }}
  SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
  SENTRY_ORG: ${{ vars.SENTRY_ORG }}

.github/workflows/storybook.yml

@@ -9,6 +9,7 @@ on:
  - "bun.lock"
  - "packages/storybook/**"
  - "packages/ui/**"
+ - "packages/session-ui/**"
  pull_request:
  branches: [dev]
  paths:
@@ -17,6 +18,7 @@ on:
  - "bun.lock"
  - "packages/storybook/**"
  - "packages/ui/**"
+ - "packages/session-ui/**"
  workflow_dispatch:
 
 concurrency:

.github/workflows/test.yml

@@ -79,10 +79,15 @@ jobs:
 
  - name: Run unit tests
  timeout-minutes: 45
- run: bun turbo test --output-logs=errors-only --log-order=grouped --log-prefix=task
+ run: GITHUB_ACTIONS=false bun turbo test --output-logs=errors-only --log-order=grouped --log-prefix=task
  env:
  OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER: ${{ runner.os == 'Windows' && 'true' || 'false' }}
 
+ - name: Check generated client
+ if: runner.os == 'Linux'
+ working-directory: packages/client
+ run: bun run check:generated
+
  - name: Run HttpApi exerciser gates
  if: runner.os == 'Linux'
  working-directory: packages/opencode

.github/workflows/triage.yml

@@ -16,13 +16,32 @@ jobs:
  with:
  fetch-depth: 1
 
+ - name: Check exempt issue author
+ id: author
+ run: |
+ LOGIN="${{ github.event.issue.user.login }}"
+ ASSOCIATION="${{ github.event.issue.author_association }}"
+
+ if [ "$LOGIN" = "opencode-agent[bot]" ] ||
+ [ "$ASSOCIATION" = "OWNER" ] ||
+ [ "$ASSOCIATION" = "MEMBER" ] ||
+ grep -qxiF "$LOGIN" .github/TEAM_MEMBERS; then
+ echo "skip=true" >> "$GITHUB_OUTPUT"
+ echo "Skipping issue automation for exempt author: $LOGIN ($ASSOCIATION)"
+ else
+ echo "skip=false" >> "$GITHUB_OUTPUT"
+ fi
+
  - name: Setup Bun
+ if: steps.author.outputs.skip != 'true'
  uses: ./.github/actions/setup-bun
 
  - name: Install opencode
+ if: steps.author.outputs.skip != 'true'
  run: curl -fsSL https://opencode.ai/install | bash
 
  - name: Triage issue
+ if: steps.author.outputs.skip != 'true'
  env:
  OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.opencode/command/translate.md

@@ -1,6 +1,6 @@
 ---
 description: translate English to other languages
-model: opencode/claude-opus-4-8
+model: opencode/gpt-5.6-sol
 ---
 
 run git diff and translate changed english doc and UI copy files to other international languages. Translate all languages in parallel to save time.

.opencode/opencode.jsonc

@@ -2,9 +2,7 @@
  "$schema": "https://opencode.ai/config.json",
  "provider": {},
  "permission": {},
- // TODO: flip back to `references` once a release containing the v1 `reference` migration ships.
- // The release pipeline runs the latest published opencode against this file, which only knows `reference`.
- "reference": {
+ "references": {
  "effect": {
  "repository": "github.com/Effect-TS/effect-smol",
  "description": "Use for Effect v4 and effect-smol implementation details",

.opencode/tool/github-triage.ts

@@ -4,7 +4,7 @@ import { tool } from "@opencode-ai/plugin"
 const TEAM = {
  tui: ["kommander", "simonklee"],
  desktop_web: ["Hona", "Brendonovich"],
- core: ["jlongster", "rekram1-node", "nexxeln", "kitlangton", "starptech"],
+ core: ["jlongster", "rekram1-node", "nexxeln", "kitlangton"],
  inference: ["fwang", "MrMushrooooom", "starptech"],
  windows: ["Hona"],
 } as const

.prettierignore

@@ -1,2 +1,4 @@
 sst-env.d.ts
 packages/desktop/src/bindings.ts
+packages/client/src/generated/
+packages/client/src/generated-effect/

AGENTS.md

@@ -1,7 +1,15 @@
-- To regenerate the JavaScript SDK, run `./packages/sdk/js/script/build.ts`.
+- To regenerate the legacy JavaScript SDK, run `./packages/sdk/js/script/build.ts`.
+- After changing the public Protocol or Server `HttpApi`, run `bun run generate` from `packages/client`. Do not edit `src/generated` or `src/generated-effect` directly.
+- Keep runtime dependencies directed from Schema to Core and Protocol, then from Core and Protocol to Server. Client runtime code may depend on Schema and Protocol but never Core or Server; `sdk-next` composes Client, Core, and Server.
 - The default branch in this repo is `dev`.
 - Local `main` ref may not exist; use `dev` or `origin/dev` for diffs.
 
+## Branch Names
+
+Use a short branch name of at most three words, separated by hyphens. Do not use slashes or type prefixes such as `feat/` or `fix/`.
+
+Examples: `session-recovery`, `fix-scroll-state`, `regenerate-sdk`.
+
 ## Commits and PR Titles
 
 Use conventional commit-style messages and PR titles: `type(scope): summary`.
@@ -22,6 +30,7 @@ Examples: `fix(tui): simplify thinking toggle styling`, `docs: update contributi
 - Rely on type inference when possible; avoid explicit type annotations or interfaces unless necessary for exports or clarity
 - Prefer functional array methods (flatMap, filter, map) over for loops; use type guards on filter to maintain type inference downstream
 - In `src/config`, follow the existing self-export pattern at the top of the file (for example `export * as ConfigAgent from "./agent"`) when adding a new config module.
+- In Effect generators, bind services to named variables before calling methods. Do not use nested service yields such as `yield* (yield* Foo.Service).bar()`.
 
 Reduce total variable count by inlining when a value is only used once.
 
@@ -131,7 +140,7 @@ const table = sqliteTable("session", {
 
 ## Testing
 
-- Avoid mocks as much as possible
+- Avoid mocks as much as possible, you shouldn't be using globalThis.\* at all unless it's the only option.
 - Test actual implementation, do not duplicate logic into tests
 - Tests cannot run from repo root (guard: `do-not-run-tests-from-root`); run from package dirs like `packages/opencode`.
 
@@ -146,7 +155,7 @@ const table = sqliteTable("session", {
 - Keep `SessionExecution` process-global and Session-ID based. Its local implementation owns the process-local Session coordinator and discovers placement through `SessionStore` plus `LocationServiceMap.get(session.location)` only when a drain starts; no layer should take a Session ID. V2 interruption targets the active process-local ownership chain for that Session; idle or missing interruption is a no-op.
 - Keep `SessionRunner`, model resolution, tool registry, permissions, and filesystem Location-scoped. Omitted `Location.workspaceID` means implicit-local placement; explicit workspace identity remains reserved for future placement semantics.
 - Preserve one explicit `llm.stream(request)` call per provider turn and reload projected history before durable continuation. Do not bridge through legacy `SessionPrompt.loop(...)` or delegate orchestration to an in-memory tool loop.
-- Keep local Session drains process-local until clustering is implemented. `SessionRunCoordinator` joins explicit same-Session resumes, coalesces prompt wakeups, and allows different Sessions to run concurrently. Advisory wakes drain eligible durable inbox rows only; post-crash activity recovery requires a separate explicit design before it may retry provider work.
-- Keep delivery vocabulary explicit. Prompts steer by default and coalesce into the active activity at the next safe provider-turn boundary. Explicit `queue` inputs open FIFO future activities one at a time after the active activity settles.
+- Keep local Session drains process-local until clustering is implemented. `SessionRunCoordinator` joins explicit same-Session resumes, coalesces prompt wakeups, and allows different Sessions to run concurrently. Advisory wakes drain eligible durable inbox rows only; post-crash continuation recovery requires a separate explicit design before it may retry provider work. A drain has no durable identity or transcript boundary.
+- Keep delivery vocabulary explicit. Prompts steer by default and promote at the next safe provider-turn boundary while the current drain requires continuation. An explicit `queue` input remains pending until the Session would otherwise become idle; promote one queued input at that boundary, then reevaluate continuation before promoting another. Promoting any new user input resets the selected agent's provider-turn allowance; a batch of steers resets it once.
 - Keep EventV2 replay owner claims separate from clustered Session execution ownership.
 - Keep the System Context algebra, registry, and built-ins in `src/system-context`; keep Context Source producers with their observed domains, and keep Session History selection plus Context Epoch persistence Session-owned.

.github/ISSUE_TEMPLATE/config.yml

@@ -2,4 +2,4 @@ blank_issues_enabled: false
 contact_links:
  - name: 💬 Discord Community
 url: https://discord.gg/opencode
-about: For quick questions or real-time discussion. Note that issues are searchable and help others with the same question.
+about: For support, troubleshooting, how-to questions, and real-time discussion.

.github/TEAM_MEMBERS

@@ -1,4 +1,5 @@
 adamdotdevin
+arvsrn
 Brendonovich
 fwang
 Hona
@@ -7,11 +8,14 @@ jayair
 jlongster
 kitlangton
 kommander
+ludvigrask
 MrMushrooooom
 nexxeln
 R44VC0RP
 rekram1-node
 thdxr
 simonklee
+Slickstef11
+usrnk1
 vimtor
-starptech
+StarpTech

.github/actions/setup-bun/action.yml

@@ -8,6 +8,13 @@ inputs:
 runs:
  using: "composite"
  steps:
+ # node-gyp@latest (invoked via bunx for native install scripts) requires Node >=22;
+ # some runner images ship an older system Node on PATH
+ - name: Setup Node
+ uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
+ with:
+ node-version: "24"
+
  - name: Get baseline download URL
  id: bun-url
  shell: bash

.github/workflows/compliance-close.yml

@@ -34,10 +34,48 @@ jobs:
 
  const now = Date.now();
  const twoHours = 2 * 60 * 60 * 1000;
+ const orgMemberAssociations = new Set(['OWNER', 'MEMBER']);
+ const agentLogin = 'opencode-agent[bot]';
+ const { data: file } = await github.rest.repos.getContent({
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ path: '.github/TEAM_MEMBERS',
+ ref: 'dev',
+ });
+ const teamMembers = new Set(
+ Buffer.from(file.content, 'base64')
+ .toString()
+ .split('\n')
+ .map((line) => line.trim().toLowerCase())
+ .filter(Boolean)
+ );
+
+ function isExempt(item) {
+ const login = item.user?.login?.toLowerCase();
+ return (
+ login === agentLogin ||
+ orgMemberAssociations.has(item.author_association) ||
+ (login && teamMembers.has(login))
+ );
+ }
 
  for (const item of items) {
  const isPR = !!item.pull_request;
  const kind = isPR ? 'PR' : 'issue';
+ const login = item.user?.login;
+
+ if (isExempt(item)) {
+ core.info(`Skipping ${kind} #${item.number}; author ${login || 'unknown'} is exempt`);
+ try {
+ await github.rest.issues.removeLabel({
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ issue_number: item.number,
+ name: 'needs:compliance',
+ });
+ } catch (e) {}
+ continue;
+ }
 
  const { data: comments } = await github.rest.issues.listComments({
  owner: context.repo.owner,

.github/workflows/duplicate-issues.yml

@@ -17,12 +17,31 @@ jobs:
  with:
  fetch-depth: 1
 
+ - name: Check exempt issue author
+ id: author
+ run: |
+ LOGIN="${{ github.event.issue.user.login }}"
+ ASSOCIATION="${{ github.event.issue.author_association }}"
+
+ if [ "$LOGIN" = "opencode-agent[bot]" ] ||
+ [ "$ASSOCIATION" = "OWNER" ] ||
+ [ "$ASSOCIATION" = "MEMBER" ] ||
+ grep -qxiF "$LOGIN" .github/TEAM_MEMBERS; then
+ echo "skip=true" >> "$GITHUB_OUTPUT"
+ echo "Skipping issue automation for exempt author: $LOGIN ($ASSOCIATION)"
+ else
+ echo "skip=false" >> "$GITHUB_OUTPUT"
+ fi
+
  - uses: ./.github/actions/setup-bun
+ if: steps.author.outputs.skip != 'true'
 
  - name: Install opencode
+ if: steps.author.outputs.skip != 'true'
  run: curl -fsSL https://opencode.ai/install | bash
 
  - name: Check duplicates and compliance
+ if: steps.author.outputs.skip != 'true'
  env:
  OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -38,6 +57,7 @@ jobs:
  opencode run -m opencode/claude-sonnet-4-6 "A new issue has been created:
 
  Issue number: ${{ github.event.issue.number }}
+ Issue author association: ${{ github.event.issue.author_association }}
 
  Lookup this issue with gh issue view ${{ github.event.issue.number }}.
 
@@ -49,6 +69,8 @@ jobs:
 
  Check whether the issue follows our contributing guidelines and issue templates.
 
+ If the issue author association is OWNER or MEMBER, skip this compliance check. Do not add the needs:compliance label for organization-owned issues.
+
  This project has three issue templates that every issue MUST use one of:
 
  1. Bug Report - requires a Description field with real content
@@ -83,7 +105,7 @@ jobs:
 
  Based on your findings, post a SINGLE comment on issue #${{ github.event.issue.number }}. Build the comment as follows:
 
- If the issue is NOT compliant, start the comment with:
+ If the issue is NOT compliant and the author association is not OWNER or MEMBER, start the comment with:
  <!-- issue-compliance -->
  Then explain what needs to be fixed and that they have 2 hours to edit the issue before it is automatically closed. Also add the label needs:compliance to the issue using: gh issue edit ${{ github.event.issue.number }} --add-label needs:compliance
 
@@ -129,12 +151,31 @@ jobs:
  with:
  fetch-depth: 1
 
+ - name: Check exempt issue author
+ id: author
+ run: |
+ LOGIN="${{ github.event.issue.user.login }}"
+ ASSOCIATION="${{ github.event.issue.author_association }}"
+
+ if [ "$LOGIN" = "opencode-agent[bot]" ] ||
+ [ "$ASSOCIATION" = "OWNER" ] ||
+ [ "$ASSOCIATION" = "MEMBER" ] ||
+ grep -qxiF "$LOGIN" .github/TEAM_MEMBERS; then
+ echo "skip=true" >> "$GITHUB_OUTPUT"
+ echo "Skipping issue automation for exempt author: $LOGIN ($ASSOCIATION)"
+ else
+ echo "skip=false" >> "$GITHUB_OUTPUT"
+ fi
+
  - uses: ./.github/actions/setup-bun
+ if: steps.author.outputs.skip != 'true'
 
  - name: Install opencode
+ if: steps.author.outputs.skip != 'true'
  run: curl -fsSL https://opencode.ai/install | bash
 
  - name: Recheck compliance
+ if: steps.author.outputs.skip != 'true'
  env:
  OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -148,9 +189,12 @@ jobs:
  }
  run: |
  opencode run -m opencode/claude-sonnet-4-6 "Issue #${{ github.event.issue.number }} was previously flagged as non-compliant and has been edited.
+ Issue author association: ${{ github.event.issue.author_association }}
 
  Lookup this issue with gh issue view ${{ github.event.issue.number }}.
 
+ If the issue author association is OWNER or MEMBER, remove the needs:compliance label if present, delete the previous compliance comment if present, and do not post a new comment.
+
  Re-check whether the issue now follows our contributing guidelines and issue templates.
 
  This project has three issue templates that every issue MUST use one of:

.github/workflows/publish.yml

@@ -219,7 +219,6 @@ jobs:
 
  build-electron:
  needs:
- - build-cli
  - version
  if: github.repository == 'anomalyco/opencode'
  continue-on-error: false
@@ -316,15 +315,13 @@ jobs:
  env:
  OPENCODE_VERSION: ${{ needs.version.outputs.version }}
  OPENCODE_CHANNEL: ${{ (github.ref_name == 'beta' && 'beta') || 'prod' }}
- OPENCODE_CLI_ARTIFACT: ${{ (runner.os == 'Windows' && 'opencode-cli-windows') || 'opencode-cli' }}
  RUST_TARGET: ${{ matrix.settings.target }}
- GH_TOKEN: ${{ github.token }}
- GITHUB_RUN_ID: ${{ github.run_id }}
 
  - name: Build
  run: bun run build
  working-directory: packages/desktop
  env:
+ NODE_OPTIONS: --max-old-space-size=4096
  OPENCODE_CHANNEL: ${{ (github.ref_name == 'beta' && 'beta') || 'prod' }}
  SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
  SENTRY_ORG: ${{ vars.SENTRY_ORG }}

.github/workflows/storybook.yml

@@ -9,6 +9,7 @@ on:
  - "bun.lock"
  - "packages/storybook/**"
  - "packages/ui/**"
+ - "packages/session-ui/**"
  pull_request:
  branches: [dev]
  paths:
@@ -17,6 +18,7 @@ on:
  - "bun.lock"
  - "packages/storybook/**"
  - "packages/ui/**"
+ - "packages/session-ui/**"
  workflow_dispatch:
 
 concurrency:

.github/workflows/test.yml

@@ -79,10 +79,15 @@ jobs:
 
  - name: Run unit tests
  timeout-minutes: 45
- run: bun turbo test --output-logs=errors-only --log-order=grouped --log-prefix=task
+ run: GITHUB_ACTIONS=false bun turbo test --output-logs=errors-only --log-order=grouped --log-prefix=task
  env:
  OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER: ${{ runner.os == 'Windows' && 'true' || 'false' }}
 
+ - name: Check generated client
+ if: runner.os == 'Linux'
+ working-directory: packages/client
+ run: bun run check:generated
+
  - name: Run HttpApi exerciser gates
  if: runner.os == 'Linux'
  working-directory: packages/opencode

.github/workflows/triage.yml

@@ -16,13 +16,32 @@ jobs:
  with:
  fetch-depth: 1
 
+ - name: Check exempt issue author
+ id: author
+ run: |
+ LOGIN="${{ github.event.issue.user.login }}"
+ ASSOCIATION="${{ github.event.issue.author_association }}"
+
+ if [ "$LOGIN" = "opencode-agent[bot]" ] ||
+ [ "$ASSOCIATION" = "OWNER" ] ||
+ [ "$ASSOCIATION" = "MEMBER" ] ||
+ grep -qxiF "$LOGIN" .github/TEAM_MEMBERS; then
+ echo "skip=true" >> "$GITHUB_OUTPUT"
+ echo "Skipping issue automation for exempt author: $LOGIN ($ASSOCIATION)"
+ else
+ echo "skip=false" >> "$GITHUB_OUTPUT"
+ fi
+
  - name: Setup Bun
+ if: steps.author.outputs.skip != 'true'
  uses: ./.github/actions/setup-bun
 
  - name: Install opencode
+ if: steps.author.outputs.skip != 'true'
  run: curl -fsSL https://opencode.ai/install | bash
 
  - name: Triage issue
+ if: steps.author.outputs.skip != 'true'
  env:
  OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.opencode/command/translate.md

@@ -1,6 +1,6 @@
 ---
 description: translate English to other languages
-model: opencode/claude-opus-4-8
+model: opencode/gpt-5.6-sol
 ---
 
 run git diff and translate changed english doc and UI copy files to other international languages. Translate all languages in parallel to save time.

.opencode/opencode.jsonc

@@ -2,9 +2,7 @@
  "$schema": "https://opencode.ai/config.json",
  "provider": {},
  "permission": {},
- // TODO: flip back to `references` once a release containing the v1 `reference` migration ships.
- // The release pipeline runs the latest published opencode against this file, which only knows `reference`.
- "reference": {
+ "references": {
  "effect": {
  "repository": "github.com/Effect-TS/effect-smol",
  "description": "Use for Effect v4 and effect-smol implementation details",

.opencode/tool/github-triage.ts

@@ -4,7 +4,7 @@ import { tool } from "@opencode-ai/plugin"
 const TEAM = {
  tui: ["kommander", "simonklee"],
  desktop_web: ["Hona", "Brendonovich"],
- core: ["jlongster", "rekram1-node", "nexxeln", "kitlangton", "starptech"],
+ core: ["jlongster", "rekram1-node", "nexxeln", "kitlangton"],
  inference: ["fwang", "MrMushrooooom", "starptech"],
  windows: ["Hona"],
 } as const

.prettierignore

@@ -1,2 +1,4 @@
 sst-env.d.ts
 packages/desktop/src/bindings.ts
+packages/client/src/generated/
+packages/client/src/generated-effect/

AGENTS.md

@@ -1,7 +1,15 @@
-- To regenerate the JavaScript SDK, run `./packages/sdk/js/script/build.ts`.
+- To regenerate the legacy JavaScript SDK, run `./packages/sdk/js/script/build.ts`.
+- After changing the public Protocol or Server `HttpApi`, run `bun run generate` from `packages/client`. Do not edit `src/generated` or `src/generated-effect` directly.
+- Keep runtime dependencies directed from Schema to Core and Protocol, then from Core and Protocol to Server. Client runtime code may depend on Schema and Protocol but never Core or Server; `sdk-next` composes Client, Core, and Server.
 - The default branch in this repo is `dev`.
 - Local `main` ref may not exist; use `dev` or `origin/dev` for diffs.
 
+## Branch Names
+
+Use a short branch name of at most three words, separated by hyphens. Do not use slashes or type prefixes such as `feat/` or `fix/`.
+
+Examples: `session-recovery`, `fix-scroll-state`, `regenerate-sdk`.
+
 ## Commits and PR Titles
 
 Use conventional commit-style messages and PR titles: `type(scope): summary`.
@@ -22,6 +30,7 @@ Examples: `fix(tui): simplify thinking toggle styling`, `docs: update contributi
 - Rely on type inference when possible; avoid explicit type annotations or interfaces unless necessary for exports or clarity
 - Prefer functional array methods (flatMap, filter, map) over for loops; use type guards on filter to maintain type inference downstream
 - In `src/config`, follow the existing self-export pattern at the top of the file (for example `export * as ConfigAgent from "./agent"`) when adding a new config module.
+- In Effect generators, bind services to named variables before calling methods. Do not use nested service yields such as `yield* (yield* Foo.Service).bar()`.
 
 Reduce total variable count by inlining when a value is only used once.
 
@@ -131,7 +140,7 @@ const table = sqliteTable("session", {
 
 ## Testing
 
-- Avoid mocks as much as possible
+- Avoid mocks as much as possible, you shouldn't be using globalThis.\* at all unless it's the only option.
 - Test actual implementation, do not duplicate logic into tests
 - Tests cannot run from repo root (guard: `do-not-run-tests-from-root`); run from package dirs like `packages/opencode`.
 
@@ -146,7 +155,7 @@ const table = sqliteTable("session", {
 - Keep `SessionExecution` process-global and Session-ID based. Its local implementation owns the process-local Session coordinator and discovers placement through `SessionStore` plus `LocationServiceMap.get(session.location)` only when a drain starts; no layer should take a Session ID. V2 interruption targets the active process-local ownership chain for that Session; idle or missing interruption is a no-op.
 - Keep `SessionRunner`, model resolution, tool registry, permissions, and filesystem Location-scoped. Omitted `Location.workspaceID` means implicit-local placement; explicit workspace identity remains reserved for future placement semantics.
 - Preserve one explicit `llm.stream(request)` call per provider turn and reload projected history before durable continuation. Do not bridge through legacy `SessionPrompt.loop(...)` or delegate orchestration to an in-memory tool loop.
-- Keep local Session drains process-local until clustering is implemented. `SessionRunCoordinator` joins explicit same-Session resumes, coalesces prompt wakeups, and allows different Sessions to run concurrently. Advisory wakes drain eligible durable inbox rows only; post-crash activity recovery requires a separate explicit design before it may retry provider work.
-- Keep delivery vocabulary explicit. Prompts steer by default and coalesce into the active activity at the next safe provider-turn boundary. Explicit `queue` inputs open FIFO future activities one at a time after the active activity settles.
+- Keep local Session drains process-local until clustering is implemented. `SessionRunCoordinator` joins explicit same-Session resumes, coalesces prompt wakeups, and allows different Sessions to run concurrently. Advisory wakes drain eligible durable inbox rows only; post-crash continuation recovery requires a separate explicit design before it may retry provider work. A drain has no durable identity or transcript boundary.
+- Keep delivery vocabulary explicit. Prompts steer by default and promote at the next safe provider-turn boundary while the current drain requires continuation. An explicit `queue` input remains pending until the Session would otherwise become idle; promote one queued input at that boundary, then reevaluate continuation before promoting another. Promoting any new user input resets the selected agent's provider-turn allowance; a batch of steers resets it once.
 - Keep EventV2 replay owner claims separate from clustered Session execution ownership.
 - Keep the System Context algebra, registry, and built-ins in `src/system-context`; keep Context Source producers with their observed domains, and keep Session History selection plus Context Epoch persistence Session-owned.

.github/ISSUE_TEMPLATE/config.yml

@@ -2,4 +2,4 @@ blank_issues_enabled: false
 contact_links:
  - name: 💬 Discord Community
 url: https://discord.gg/opencode
-about: For quick questions or real-time discussion. Note that issues are searchable and help others with the same question.
+about: For support, troubleshooting, how-to questions, and real-time discussion.

.github/TEAM_MEMBERS

@@ -1,4 +1,5 @@
 adamdotdevin
+arvsrn
 Brendonovich
 fwang
 Hona
@@ -7,11 +8,14 @@ jayair
 jlongster
 kitlangton
 kommander
+ludvigrask
 MrMushrooooom
 nexxeln
 R44VC0RP
 rekram1-node
 thdxr
 simonklee
+Slickstef11
+usrnk1
 vimtor
-starptech
+StarpTech

.github/actions/setup-bun/action.yml

@@ -8,6 +8,13 @@ inputs:
 runs:
  using: "composite"
  steps:
+ # node-gyp@latest (invoked via bunx for native install scripts) requires Node >=22;
+ # some runner images ship an older system Node on PATH
+ - name: Setup Node
+ uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
+ with:
+ node-version: "24"
+
  - name: Get baseline download URL
  id: bun-url
  shell: bash

.github/workflows/compliance-close.yml

@@ -34,10 +34,48 @@ jobs:
 
  const now = Date.now();
  const twoHours = 2 * 60 * 60 * 1000;
+ const orgMemberAssociations = new Set(['OWNER', 'MEMBER']);
+ const agentLogin = 'opencode-agent[bot]';
+ const { data: file } = await github.rest.repos.getContent({
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ path: '.github/TEAM_MEMBERS',
+ ref: 'dev',
+ });
+ const teamMembers = new Set(
+ Buffer.from(file.content, 'base64')
+ .toString()
+ .split('\n')
+ .map((line) => line.trim().toLowerCase())
+ .filter(Boolean)
+ );
+
+ function isExempt(item) {
+ const login = item.user?.login?.toLowerCase();
+ return (
+ login === agentLogin ||
+ orgMemberAssociations.has(item.author_association) ||
+ (login && teamMembers.has(login))
+ );
+ }
 
  for (const item of items) {
  const isPR = !!item.pull_request;
  const kind = isPR ? 'PR' : 'issue';
+ const login = item.user?.login;
+
+ if (isExempt(item)) {
+ core.info(`Skipping ${kind} #${item.number}; author ${login || 'unknown'} is exempt`);
+ try {
+ await github.rest.issues.removeLabel({
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ issue_number: item.number,
+ name: 'needs:compliance',
+ });
+ } catch (e) {}
+ continue;
+ }
 
  const { data: comments } = await github.rest.issues.listComments({
  owner: context.repo.owner,

.github/workflows/duplicate-issues.yml

@@ -17,12 +17,31 @@ jobs:
  with:
  fetch-depth: 1
 
+ - name: Check exempt issue author
+ id: author
+ run: |
+ LOGIN="${{ github.event.issue.user.login }}"
+ ASSOCIATION="${{ github.event.issue.author_association }}"
+
+ if [ "$LOGIN" = "opencode-agent[bot]" ] ||
+ [ "$ASSOCIATION" = "OWNER" ] ||
+ [ "$ASSOCIATION" = "MEMBER" ] ||
+ grep -qxiF "$LOGIN" .github/TEAM_MEMBERS; then
+ echo "skip=true" >> "$GITHUB_OUTPUT"
+ echo "Skipping issue automation for exempt author: $LOGIN ($ASSOCIATION)"
+ else
+ echo "skip=false" >> "$GITHUB_OUTPUT"
+ fi
+
  - uses: ./.github/actions/setup-bun
+ if: steps.author.outputs.skip != 'true'
 
  - name: Install opencode
+ if: steps.author.outputs.skip != 'true'
  run: curl -fsSL https://opencode.ai/install | bash
 
  - name: Check duplicates and compliance
+ if: steps.author.outputs.skip != 'true'
  env:
  OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -38,6 +57,7 @@ jobs:
  opencode run -m opencode/claude-sonnet-4-6 "A new issue has been created:
 
  Issue number: ${{ github.event.issue.number }}
+ Issue author association: ${{ github.event.issue.author_association }}
 
  Lookup this issue with gh issue view ${{ github.event.issue.number }}.
 
@@ -49,6 +69,8 @@ jobs:
 
  Check whether the issue follows our contributing guidelines and issue templates.
 
+ If the issue author association is OWNER or MEMBER, skip this compliance check. Do not add the needs:compliance label for organization-owned issues.
+
  This project has three issue templates that every issue MUST use one of:
 
  1. Bug Report - requires a Description field with real content
@@ -83,7 +105,7 @@ jobs:
 
  Based on your findings, post a SINGLE comment on issue #${{ github.event.issue.number }}. Build the comment as follows:
 
- If the issue is NOT compliant, start the comment with:
+ If the issue is NOT compliant and the author association is not OWNER or MEMBER, start the comment with:
  <!-- issue-compliance -->
  Then explain what needs to be fixed and that they have 2 hours to edit the issue before it is automatically closed. Also add the label needs:compliance to the issue using: gh issue edit ${{ github.event.issue.number }} --add-label needs:compliance
 
@@ -129,12 +151,31 @@ jobs:
  with:
  fetch-depth: 1
 
+ - name: Check exempt issue author
+ id: author
+ run: |
+ LOGIN="${{ github.event.issue.user.login }}"
+ ASSOCIATION="${{ github.event.issue.author_association }}"
+
+ if [ "$LOGIN" = "opencode-agent[bot]" ] ||
+ [ "$ASSOCIATION" = "OWNER" ] ||
+ [ "$ASSOCIATION" = "MEMBER" ] ||
+ grep -qxiF "$LOGIN" .github/TEAM_MEMBERS; then
+ echo "skip=true" >> "$GITHUB_OUTPUT"
+ echo "Skipping issue automation for exempt author: $LOGIN ($ASSOCIATION)"
+ else
+ echo "skip=false" >> "$GITHUB_OUTPUT"
+ fi
+
  - uses: ./.github/actions/setup-bun
+ if: steps.author.outputs.skip != 'true'
 
  - name: Install opencode
+ if: steps.author.outputs.skip != 'true'
  run: curl -fsSL https://opencode.ai/install | bash
 
  - name: Recheck compliance
+ if: steps.author.outputs.skip != 'true'
  env:
  OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -148,9 +189,12 @@ jobs:
  }
  run: |
  opencode run -m opencode/claude-sonnet-4-6 "Issue #${{ github.event.issue.number }} was previously flagged as non-compliant and has been edited.
+ Issue author association: ${{ github.event.issue.author_association }}
 
  Lookup this issue with gh issue view ${{ github.event.issue.number }}.
 
+ If the issue author association is OWNER or MEMBER, remove the needs:compliance label if present, delete the previous compliance comment if present, and do not post a new comment.
+
  Re-check whether the issue now follows our contributing guidelines and issue templates.
 
  This project has three issue templates that every issue MUST use one of:

.github/workflows/publish.yml

@@ -219,7 +219,6 @@ jobs:
 
  build-electron:
  needs:
- - build-cli
  - version
  if: github.repository == 'anomalyco/opencode'
  continue-on-error: false
@@ -316,15 +315,13 @@ jobs:
  env:
  OPENCODE_VERSION: ${{ needs.version.outputs.version }}
  OPENCODE_CHANNEL: ${{ (github.ref_name == 'beta' && 'beta') || 'prod' }}
- OPENCODE_CLI_ARTIFACT: ${{ (runner.os == 'Windows' && 'opencode-cli-windows') || 'opencode-cli' }}
  RUST_TARGET: ${{ matrix.settings.target }}
- GH_TOKEN: ${{ github.token }}
- GITHUB_RUN_ID: ${{ github.run_id }}
 
  - name: Build
  run: bun run build
  working-directory: packages/desktop
  env:
+ NODE_OPTIONS: --max-old-space-size=4096
  OPENCODE_CHANNEL: ${{ (github.ref_name == 'beta' && 'beta') || 'prod' }}
  SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
  SENTRY_ORG: ${{ vars.SENTRY_ORG }}

.github/workflows/storybook.yml

@@ -9,6 +9,7 @@ on:
  - "bun.lock"
  - "packages/storybook/**"
  - "packages/ui/**"
+ - "packages/session-ui/**"
  pull_request:
  branches: [dev]
  paths:
@@ -17,6 +18,7 @@ on:
  - "bun.lock"
  - "packages/storybook/**"
  - "packages/ui/**"
+ - "packages/session-ui/**"
  workflow_dispatch:
 
 concurrency:

.github/workflows/test.yml

@@ -79,10 +79,15 @@ jobs:
 
  - name: Run unit tests
  timeout-minutes: 45
- run: bun turbo test --output-logs=errors-only --log-order=grouped --log-prefix=task
+ run: GITHUB_ACTIONS=false bun turbo test --output-logs=errors-only --log-order=grouped --log-prefix=task
  env:
  OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER: ${{ runner.os == 'Windows' && 'true' || 'false' }}
 
+ - name: Check generated client
+ if: runner.os == 'Linux'
+ working-directory: packages/client
+ run: bun run check:generated
+
  - name: Run HttpApi exerciser gates
  if: runner.os == 'Linux'
  working-directory: packages/opencode

.github/workflows/triage.yml

@@ -16,13 +16,32 @@ jobs:
  with:
  fetch-depth: 1
 
+ - name: Check exempt issue author
+ id: author
+ run: |
+ LOGIN="${{ github.event.issue.user.login }}"
+ ASSOCIATION="${{ github.event.issue.author_association }}"
+
+ if [ "$LOGIN" = "opencode-agent[bot]" ] ||
+ [ "$ASSOCIATION" = "OWNER" ] ||
+ [ "$ASSOCIATION" = "MEMBER" ] ||
+ grep -qxiF "$LOGIN" .github/TEAM_MEMBERS; then
+ echo "skip=true" >> "$GITHUB_OUTPUT"
+ echo "Skipping issue automation for exempt author: $LOGIN ($ASSOCIATION)"
+ else
+ echo "skip=false" >> "$GITHUB_OUTPUT"
+ fi
+
  - name: Setup Bun
+ if: steps.author.outputs.skip != 'true'
  uses: ./.github/actions/setup-bun
 
  - name: Install opencode
+ if: steps.author.outputs.skip != 'true'
  run: curl -fsSL https://opencode.ai/install | bash
 
  - name: Triage issue
+ if: steps.author.outputs.skip != 'true'
  env:
  OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.opencode/command/translate.md

@@ -1,6 +1,6 @@
 ---
 description: translate English to other languages
-model: opencode/claude-opus-4-8
+model: opencode/gpt-5.6-sol
 ---
 
 run git diff and translate changed english doc and UI copy files to other international languages. Translate all languages in parallel to save time.

.opencode/opencode.jsonc

@@ -2,9 +2,7 @@
  "$schema": "https://opencode.ai/config.json",
  "provider": {},
  "permission": {},
- // TODO: flip back to `references` once a release containing the v1 `reference` migration ships.
- // The release pipeline runs the latest published opencode against this file, which only knows `reference`.
- "reference": {
+ "references": {
  "effect": {
  "repository": "github.com/Effect-TS/effect-smol",
  "description": "Use for Effect v4 and effect-smol implementation details",

.opencode/tool/github-triage.ts

@@ -4,7 +4,7 @@ import { tool } from "@opencode-ai/plugin"
 const TEAM = {
  tui: ["kommander", "simonklee"],
  desktop_web: ["Hona", "Brendonovich"],
- core: ["jlongster", "rekram1-node", "nexxeln", "kitlangton", "starptech"],
+ core: ["jlongster", "rekram1-node", "nexxeln", "kitlangton"],
  inference: ["fwang", "MrMushrooooom", "starptech"],
  windows: ["Hona"],
 } as const

.prettierignore

@@ -1,2 +1,4 @@
 sst-env.d.ts
 packages/desktop/src/bindings.ts
+packages/client/src/generated/
+packages/client/src/generated-effect/

AGENTS.md

@@ -1,7 +1,15 @@
-- To regenerate the JavaScript SDK, run `./packages/sdk/js/script/build.ts`.
+- To regenerate the legacy JavaScript SDK, run `./packages/sdk/js/script/build.ts`.
+- After changing the public Protocol or Server `HttpApi`, run `bun run generate` from `packages/client`. Do not edit `src/generated` or `src/generated-effect` directly.
+- Keep runtime dependencies directed from Schema to Core and Protocol, then from Core and Protocol to Server. Client runtime code may depend on Schema and Protocol but never Core or Server; `sdk-next` composes Client, Core, and Server.
 - The default branch in this repo is `dev`.
 - Local `main` ref may not exist; use `dev` or `origin/dev` for diffs.
 
+## Branch Names
+
+Use a short branch name of at most three words, separated by hyphens. Do not use slashes or type prefixes such as `feat/` or `fix/`.
+
+Examples: `session-recovery`, `fix-scroll-state`, `regenerate-sdk`.
+
 ## Commits and PR Titles
 
 Use conventional commit-style messages and PR titles: `type(scope): summary`.
@@ -22,6 +30,7 @@ Examples: `fix(tui): simplify thinking toggle styling`, `docs: update contributi
 - Rely on type inference when possible; avoid explicit type annotations or interfaces unless necessary for exports or clarity
 - Prefer functional array methods (flatMap, filter, map) over for loops; use type guards on filter to maintain type inference downstream
 - In `src/config`, follow the existing self-export pattern at the top of the file (for example `export * as ConfigAgent from "./agent"`) when adding a new config module.
+- In Effect generators, bind services to named variables before calling methods. Do not use nested service yields such as `yield* (yield* Foo.Service).bar()`.
 
 Reduce total variable count by inlining when a value is only used once.
 
@@ -131,7 +140,7 @@ const table = sqliteTable("session", {
 
 ## Testing
 
-- Avoid mocks as much as possible
+- Avoid mocks as much as possible, you shouldn't be using globalThis.\* at all unless it's the only option.
 - Test actual implementation, do not duplicate logic into tests
 - Tests cannot run from repo root (guard: `do-not-run-tests-from-root`); run from package dirs like `packages/opencode`.
 
@@ -146,7 +155,7 @@ const table = sqliteTable("session", {
 - Keep `SessionExecution` process-global and Session-ID based. Its local implementation owns the process-local Session coordinator and discovers placement through `SessionStore` plus `LocationServiceMap.get(session.location)` only when a drain starts; no layer should take a Session ID. V2 interruption targets the active process-local ownership chain for that Session; idle or missing interruption is a no-op.
 - Keep `SessionRunner`, model resolution, tool registry, permissions, and filesystem Location-scoped. Omitted `Location.workspaceID` means implicit-local placement; explicit workspace identity remains reserved for future placement semantics.
 - Preserve one explicit `llm.stream(request)` call per provider turn and reload projected history before durable continuation. Do not bridge through legacy `SessionPrompt.loop(...)` or delegate orchestration to an in-memory tool loop.
-- Keep local Session drains process-local until clustering is implemented. `SessionRunCoordinator` joins explicit same-Session resumes, coalesces prompt wakeups, and allows different Sessions to run concurrently. Advisory wakes drain eligible durable inbox rows only; post-crash activity recovery requires a separate explicit design before it may retry provider work.
-- Keep delivery vocabulary explicit. Prompts steer by default and coalesce into the active activity at the next safe provider-turn boundary. Explicit `queue` inputs open FIFO future activities one at a time after the active activity settles.
+- Keep local Session drains process-local until clustering is implemented. `SessionRunCoordinator` joins explicit same-Session resumes, coalesces prompt wakeups, and allows different Sessions to run concurrently. Advisory wakes drain eligible durable inbox rows only; post-crash continuation recovery requires a separate explicit design before it may retry provider work. A drain has no durable identity or transcript boundary.
+- Keep delivery vocabulary explicit. Prompts steer by default and promote at the next safe provider-turn boundary while the current drain requires continuation. An explicit `queue` input remains pending until the Session would otherwise become idle; promote one queued input at that boundary, then reevaluate continuation before promoting another. Promoting any new user input resets the selected agent's provider-turn allowance; a batch of steers resets it once.
 - Keep EventV2 replay owner claims separate from clustered Session execution ownership.
 - Keep the System Context algebra, registry, and built-ins in `src/system-context`; keep Context Source producers with their observed domains, and keep Session History selection plus Context Epoch persistence Session-owned.

.github/ISSUE_TEMPLATE/config.yml

@@ -2,4 +2,4 @@ blank_issues_enabled: false
 contact_links:
  - name: 💬 Discord Community
 url: https://discord.gg/opencode
-about: For quick questions or real-time discussion. Note that issues are searchable and help others with the same question.
+about: For support, troubleshooting, how-to questions, and real-time discussion.

.github/TEAM_MEMBERS

@@ -1,4 +1,5 @@
 adamdotdevin
+arvsrn
 Brendonovich
 fwang
 Hona
@@ -7,11 +8,14 @@ jayair
 jlongster
 kitlangton
 kommander
+ludvigrask
 MrMushrooooom
 nexxeln
 R44VC0RP
 rekram1-node
 thdxr
 simonklee
+Slickstef11
+usrnk1
 vimtor
-starptech
+StarpTech

.github/actions/setup-bun/action.yml

@@ -8,6 +8,13 @@ inputs:
 runs:
  using: "composite"
  steps:
+ # node-gyp@latest (invoked via bunx for native install scripts) requires Node >=22;
+ # some runner images ship an older system Node on PATH
+ - name: Setup Node
+ uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
+ with:
+ node-version: "24"
+
  - name: Get baseline download URL
  id: bun-url
  shell: bash

.github/workflows/compliance-close.yml

@@ -34,10 +34,48 @@ jobs:
 
  const now = Date.now();
  const twoHours = 2 * 60 * 60 * 1000;
+ const orgMemberAssociations = new Set(['OWNER', 'MEMBER']);
+ const agentLogin = 'opencode-agent[bot]';
+ const { data: file } = await github.rest.repos.getContent({
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ path: '.github/TEAM_MEMBERS',
+ ref: 'dev',
+ });
+ const teamMembers = new Set(
+ Buffer.from(file.content, 'base64')
+ .toString()
+ .split('\n')
+ .map((line) => line.trim().toLowerCase())
+ .filter(Boolean)
+ );
+
+ function isExempt(item) {
+ const login = item.user?.login?.toLowerCase();
+ return (
+ login === agentLogin ||
+ orgMemberAssociations.has(item.author_association) ||
+ (login && teamMembers.has(login))
+ );
+ }
 
  for (const item of items) {
  const isPR = !!item.pull_request;
  const kind = isPR ? 'PR' : 'issue';
+ const login = item.user?.login;
+
+ if (isExempt(item)) {
+ core.info(`Skipping ${kind} #${item.number}; author ${login || 'unknown'} is exempt`);
+ try {
+ await github.rest.issues.removeLabel({
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ issue_number: item.number,
+ name: 'needs:compliance',
+ });
+ } catch (e) {}
+ continue;
+ }
 
  const { data: comments } = await github.rest.issues.listComments({
  owner: context.repo.owner,

.github/workflows/duplicate-issues.yml

@@ -17,12 +17,31 @@ jobs:
  with:
  fetch-depth: 1
 
+ - name: Check exempt issue author
+ id: author
+ run: |
+ LOGIN="${{ github.event.issue.user.login }}"
+ ASSOCIATION="${{ github.event.issue.author_association }}"
+
+ if [ "$LOGIN" = "opencode-agent[bot]" ] ||
+ [ "$ASSOCIATION" = "OWNER" ] ||
+ [ "$ASSOCIATION" = "MEMBER" ] ||
+ grep -qxiF "$LOGIN" .github/TEAM_MEMBERS; then
+ echo "skip=true" >> "$GITHUB_OUTPUT"
+ echo "Skipping issue automation for exempt author: $LOGIN ($ASSOCIATION)"
+ else
+ echo "skip=false" >> "$GITHUB_OUTPUT"
+ fi
+
  - uses: ./.github/actions/setup-bun
+ if: steps.author.outputs.skip != 'true'
 
  - name: Install opencode
+ if: steps.author.outputs.skip != 'true'
  run: curl -fsSL https://opencode.ai/install | bash
 
  - name: Check duplicates and compliance
+ if: steps.author.outputs.skip != 'true'
  env:
  OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -38,6 +57,7 @@ jobs:
  opencode run -m opencode/claude-sonnet-4-6 "A new issue has been created:
 
  Issue number: ${{ github.event.issue.number }}
+ Issue author association: ${{ github.event.issue.author_association }}
 
  Lookup this issue with gh issue view ${{ github.event.issue.number }}.
 
@@ -49,6 +69,8 @@ jobs:
 
  Check whether the issue follows our contributing guidelines and issue templates.
 
+ If the issue author association is OWNER or MEMBER, skip this compliance check. Do not add the needs:compliance label for organization-owned issues.
+
  This project has three issue templates that every issue MUST use one of:
 
  1. Bug Report - requires a Description field with real content
@@ -83,7 +105,7 @@ jobs:
 
  Based on your findings, post a SINGLE comment on issue #${{ github.event.issue.number }}. Build the comment as follows:
 
- If the issue is NOT compliant, start the comment with:
+ If the issue is NOT compliant and the author association is not OWNER or MEMBER, start the comment with:
  <!-- issue-compliance -->
  Then explain what needs to be fixed and that they have 2 hours to edit the issue before it is automatically closed. Also add the label needs:compliance to the issue using: gh issue edit ${{ github.event.issue.number }} --add-label needs:compliance
 
@@ -129,12 +151,31 @@ jobs:
  with:
  fetch-depth: 1
 
+ - name: Check exempt issue author
+ id: author
+ run: |
+ LOGIN="${{ github.event.issue.user.login }}"
+ ASSOCIATION="${{ github.event.issue.author_association }}"
+
+ if [ "$LOGIN" = "opencode-agent[bot]" ] ||
+ [ "$ASSOCIATION" = "OWNER" ] ||
+ [ "$ASSOCIATION" = "MEMBER" ] ||
+ grep -qxiF "$LOGIN" .github/TEAM_MEMBERS; then
+ echo "skip=true" >> "$GITHUB_OUTPUT"
+ echo "Skipping issue automation for exempt author: $LOGIN ($ASSOCIATION)"
+ else
+ echo "skip=false" >> "$GITHUB_OUTPUT"
+ fi
+
  - uses: ./.github/actions/setup-bun
+ if: steps.author.outputs.skip != 'true'
 
  - name: Install opencode
+ if: steps.author.outputs.skip != 'true'
  run: curl -fsSL https://opencode.ai/install | bash
 
  - name: Recheck compliance
+ if: steps.author.outputs.skip != 'true'
  env:
  OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -148,9 +189,12 @@ jobs:
  }
  run: |
  opencode run -m opencode/claude-sonnet-4-6 "Issue #${{ github.event.issue.number }} was previously flagged as non-compliant and has been edited.
+ Issue author association: ${{ github.event.issue.author_association }}
 
  Lookup this issue with gh issue view ${{ github.event.issue.number }}.
 
+ If the issue author association is OWNER or MEMBER, remove the needs:compliance label if present, delete the previous compliance comment if present, and do not post a new comment.
+
  Re-check whether the issue now follows our contributing guidelines and issue templates.
 
  This project has three issue templates that every issue MUST use one of:

.github/workflows/publish.yml

@@ -219,7 +219,6 @@ jobs:
 
  build-electron:
  needs:
- - build-cli
  - version
  if: github.repository == 'anomalyco/opencode'
  continue-on-error: false
@@ -316,15 +315,13 @@ jobs:
  env:
  OPENCODE_VERSION: ${{ needs.version.outputs.version }}
  OPENCODE_CHANNEL: ${{ (github.ref_name == 'beta' && 'beta') || 'prod' }}
- OPENCODE_CLI_ARTIFACT: ${{ (runner.os == 'Windows' && 'opencode-cli-windows') || 'opencode-cli' }}
  RUST_TARGET: ${{ matrix.settings.target }}
- GH_TOKEN: ${{ github.token }}
- GITHUB_RUN_ID: ${{ github.run_id }}
 
  - name: Build
  run: bun run build
  working-directory: packages/desktop
  env:
+ NODE_OPTIONS: --max-old-space-size=4096
  OPENCODE_CHANNEL: ${{ (github.ref_name == 'beta' && 'beta') || 'prod' }}
  SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
  SENTRY_ORG: ${{ vars.SENTRY_ORG }}

.github/workflows/storybook.yml

@@ -9,6 +9,7 @@ on:
  - "bun.lock"
  - "packages/storybook/**"
  - "packages/ui/**"
+ - "packages/session-ui/**"
  pull_request:
  branches: [dev]
  paths:
@@ -17,6 +18,7 @@ on:
  - "bun.lock"
  - "packages/storybook/**"
  - "packages/ui/**"
+ - "packages/session-ui/**"
  workflow_dispatch:
 
 concurrency:

.github/workflows/test.yml

@@ -79,10 +79,15 @@ jobs:
 
  - name: Run unit tests
  timeout-minutes: 45
- run: bun turbo test --output-logs=errors-only --log-order=grouped --log-prefix=task
+ run: GITHUB_ACTIONS=false bun turbo test --output-logs=errors-only --log-order=grouped --log-prefix=task
  env:
  OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER: ${{ runner.os == 'Windows' && 'true' || 'false' }}
 
+ - name: Check generated client
+ if: runner.os == 'Linux'
+ working-directory: packages/client
+ run: bun run check:generated
+
  - name: Run HttpApi exerciser gates
  if: runner.os == 'Linux'
  working-directory: packages/opencode

.github/workflows/triage.yml

@@ -16,13 +16,32 @@ jobs:
  with:
  fetch-depth: 1
 
+ - name: Check exempt issue author
+ id: author
+ run: |
+ LOGIN="${{ github.event.issue.user.login }}"
+ ASSOCIATION="${{ github.event.issue.author_association }}"
+
+ if [ "$LOGIN" = "opencode-agent[bot]" ] ||
+ [ "$ASSOCIATION" = "OWNER" ] ||
+ [ "$ASSOCIATION" = "MEMBER" ] ||
+ grep -qxiF "$LOGIN" .github/TEAM_MEMBERS; then
+ echo "skip=true" >> "$GITHUB_OUTPUT"
+ echo "Skipping issue automation for exempt author: $LOGIN ($ASSOCIATION)"
+ else
+ echo "skip=false" >> "$GITHUB_OUTPUT"
+ fi
+
  - name: Setup Bun
+ if: steps.author.outputs.skip != 'true'
  uses: ./.github/actions/setup-bun
 
  - name: Install opencode
+ if: steps.author.outputs.skip != 'true'
  run: curl -fsSL https://opencode.ai/install | bash
 
  - name: Triage issue
+ if: steps.author.outputs.skip != 'true'
  env:
  OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.opencode/command/translate.md

@@ -1,6 +1,6 @@
 ---
 description: translate English to other languages
-model: opencode/claude-opus-4-8
+model: opencode/gpt-5.6-sol
 ---
 
 run git diff and translate changed english doc and UI copy files to other international languages. Translate all languages in parallel to save time.

.opencode/opencode.jsonc

@@ -2,9 +2,7 @@
  "$schema": "https://opencode.ai/config.json",
  "provider": {},
  "permission": {},
- // TODO: flip back to `references` once a release containing the v1 `reference` migration ships.
- // The release pipeline runs the latest published opencode against this file, which only knows `reference`.
- "reference": {
+ "references": {
  "effect": {
  "repository": "github.com/Effect-TS/effect-smol",
  "description": "Use for Effect v4 and effect-smol implementation details",

.opencode/tool/github-triage.ts

@@ -4,7 +4,7 @@ import { tool } from "@opencode-ai/plugin"
 const TEAM = {
  tui: ["kommander", "simonklee"],
  desktop_web: ["Hona", "Brendonovich"],
- core: ["jlongster", "rekram1-node", "nexxeln", "kitlangton", "starptech"],
+ core: ["jlongster", "rekram1-node", "nexxeln", "kitlangton"],
  inference: ["fwang", "MrMushrooooom", "starptech"],
  windows: ["Hona"],
 } as const

.prettierignore

@@ -1,2 +1,4 @@
 sst-env.d.ts
 packages/desktop/src/bindings.ts
+packages/client/src/generated/
+packages/client/src/generated-effect/

AGENTS.md

@@ -1,7 +1,15 @@
-- To regenerate the JavaScript SDK, run `./packages/sdk/js/script/build.ts`.
+- To regenerate the legacy JavaScript SDK, run `./packages/sdk/js/script/build.ts`.
+- After changing the public Protocol or Server `HttpApi`, run `bun run generate` from `packages/client`. Do not edit `src/generated` or `src/generated-effect` directly.
+- Keep runtime dependencies directed from Schema to Core and Protocol, then from Core and Protocol to Server. Client runtime code may depend on Schema and Protocol but never Core or Server; `sdk-next` composes Client, Core, and Server.
 - The default branch in this repo is `dev`.
 - Local `main` ref may not exist; use `dev` or `origin/dev` for diffs.
 
+## Branch Names
+
+Use a short branch name of at most three words, separated by hyphens. Do not use slashes or type prefixes such as `feat/` or `fix/`.
+
+Examples: `session-recovery`, `fix-scroll-state`, `regenerate-sdk`.
+
 ## Commits and PR Titles
 
 Use conventional commit-style messages and PR titles: `type(scope): summary`.
@@ -22,6 +30,7 @@ Examples: `fix(tui): simplify thinking toggle styling`, `docs: update contributi
 - Rely on type inference when possible; avoid explicit type annotations or interfaces unless necessary for exports or clarity
 - Prefer functional array methods (flatMap, filter, map) over for loops; use type guards on filter to maintain type inference downstream
 - In `src/config`, follow the existing self-export pattern at the top of the file (for example `export * as ConfigAgent from "./agent"`) when adding a new config module.
+- In Effect generators, bind services to named variables before calling methods. Do not use nested service yields such as `yield* (yield* Foo.Service).bar()`.
 
 Reduce total variable count by inlining when a value is only used once.
 
@@ -131,7 +140,7 @@ const table = sqliteTable("session", {
 
 ## Testing
 
-- Avoid mocks as much as possible
+- Avoid mocks as much as possible, you shouldn't be using globalThis.\* at all unless it's the only option.
 - Test actual implementation, do not duplicate logic into tests
 - Tests cannot run from repo root (guard: `do-not-run-tests-from-root`); run from package dirs like `packages/opencode`.
 
@@ -146,7 +155,7 @@ const table = sqliteTable("session", {
 - Keep `SessionExecution` process-global and Session-ID based. Its local implementation owns the process-local Session coordinator and discovers placement through `SessionStore` plus `LocationServiceMap.get(session.location)` only when a drain starts; no layer should take a Session ID. V2 interruption targets the active process-local ownership chain for that Session; idle or missing interruption is a no-op.
 - Keep `SessionRunner`, model resolution, tool registry, permissions, and filesystem Location-scoped. Omitted `Location.workspaceID` means implicit-local placement; explicit workspace identity remains reserved for future placement semantics.
 - Preserve one explicit `llm.stream(request)` call per provider turn and reload projected history before durable continuation. Do not bridge through legacy `SessionPrompt.loop(...)` or delegate orchestration to an in-memory tool loop.
-- Keep local Session drains process-local until clustering is implemented. `SessionRunCoordinator` joins explicit same-Session resumes, coalesces prompt wakeups, and allows different Sessions to run concurrently. Advisory wakes drain eligible durable inbox rows only; post-crash activity recovery requires a separate explicit design before it may retry provider work.
-- Keep delivery vocabulary explicit. Prompts steer by default and coalesce into the active activity at the next safe provider-turn boundary. Explicit `queue` inputs open FIFO future activities one at a time after the active activity settles.
+- Keep local Session drains process-local until clustering is implemented. `SessionRunCoordinator` joins explicit same-Session resumes, coalesces prompt wakeups, and allows different Sessions to run concurrently. Advisory wakes drain eligible durable inbox rows only; post-crash continuation recovery requires a separate explicit design before it may retry provider work. A drain has no durable identity or transcript boundary.
+- Keep delivery vocabulary explicit. Prompts steer by default and promote at the next safe provider-turn boundary while the current drain requires continuation. An explicit `queue` input remains pending until the Session would otherwise become idle; promote one queued input at that boundary, then reevaluate continuation before promoting another. Promoting any new user input resets the selected agent's provider-turn allowance; a batch of steers resets it once.
 - Keep EventV2 replay owner claims separate from clustered Session execution ownership.
 - Keep the System Context algebra, registry, and built-ins in `src/system-context`; keep Context Source producers with their observed domains, and keep Session History selection plus Context Epoch persistence Session-owned.

.github/ISSUE_TEMPLATE/config.yml

@@ -2,4 +2,4 @@ blank_issues_enabled: false
 contact_links:
  - name: 💬 Discord Community
 url: https://discord.gg/opencode
-about: For quick questions or real-time discussion. Note that issues are searchable and help others with the same question.
+about: For support, troubleshooting, how-to questions, and real-time discussion.

.github/TEAM_MEMBERS

@@ -1,4 +1,5 @@
 adamdotdevin
+arvsrn
 Brendonovich
 fwang
 Hona
@@ -7,11 +8,14 @@ jayair
 jlongster
 kitlangton
 kommander
+ludvigrask
 MrMushrooooom
 nexxeln
 R44VC0RP
 rekram1-node
 thdxr
 simonklee
+Slickstef11
+usrnk1
 vimtor
-starptech
+StarpTech

.github/actions/setup-bun/action.yml

@@ -8,6 +8,13 @@ inputs:
 runs:
  using: "composite"
  steps:
+ # node-gyp@latest (invoked via bunx for native install scripts) requires Node >=22;
+ # some runner images ship an older system Node on PATH
+ - name: Setup Node
+ uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
+ with:
+ node-version: "24"
+
  - name: Get baseline download URL
  id: bun-url
  shell: bash

.github/workflows/compliance-close.yml

@@ -34,10 +34,48 @@ jobs:
 
  const now = Date.now();
  const twoHours = 2 * 60 * 60 * 1000;
+ const orgMemberAssociations = new Set(['OWNER', 'MEMBER']);
+ const agentLogin = 'opencode-agent[bot]';
+ const { data: file } = await github.rest.repos.getContent({
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ path: '.github/TEAM_MEMBERS',
+ ref: 'dev',
+ });
+ const teamMembers = new Set(
+ Buffer.from(file.content, 'base64')
+ .toString()
+ .split('\n')
+ .map((line) => line.trim().toLowerCase())
+ .filter(Boolean)
+ );
+
+ function isExempt(item) {
+ const login = item.user?.login?.toLowerCase();
+ return (
+ login === agentLogin ||
+ orgMemberAssociations.has(item.author_association) ||
+ (login && teamMembers.has(login))
+ );
+ }
 
  for (const item of items) {
  const isPR = !!item.pull_request;
  const kind = isPR ? 'PR' : 'issue';
+ const login = item.user?.login;
+
+ if (isExempt(item)) {
+ core.info(`Skipping ${kind} #${item.number}; author ${login || 'unknown'} is exempt`);
+ try {
+ await github.rest.issues.removeLabel({
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ issue_number: item.number,
+ name: 'needs:compliance',
+ });
+ } catch (e) {}
+ continue;
+ }
 
  const { data: comments } = await github.rest.issues.listComments({
  owner: context.repo.owner,

.github/workflows/duplicate-issues.yml

@@ -17,12 +17,31 @@ jobs:
  with:
  fetch-depth: 1
 
+ - name: Check exempt issue author
+ id: author
+ run: |
+ LOGIN="${{ github.event.issue.user.login }}"
+ ASSOCIATION="${{ github.event.issue.author_association }}"
+
+ if [ "$LOGIN" = "opencode-agent[bot]" ] ||
+ [ "$ASSOCIATION" = "OWNER" ] ||
+ [ "$ASSOCIATION" = "MEMBER" ] ||
+ grep -qxiF "$LOGIN" .github/TEAM_MEMBERS; then
+ echo "skip=true" >> "$GITHUB_OUTPUT"
+ echo "Skipping issue automation for exempt author: $LOGIN ($ASSOCIATION)"
+ else
+ echo "skip=false" >> "$GITHUB_OUTPUT"
+ fi
+
  - uses: ./.github/actions/setup-bun
+ if: steps.author.outputs.skip != 'true'
 
  - name: Install opencode
+ if: steps.author.outputs.skip != 'true'
  run: curl -fsSL https://opencode.ai/install | bash
 
  - name: Check duplicates and compliance
+ if: steps.author.outputs.skip != 'true'
  env:
  OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -38,6 +57,7 @@ jobs:
  opencode run -m opencode/claude-sonnet-4-6 "A new issue has been created:
 
  Issue number: ${{ github.event.issue.number }}
+ Issue author association: ${{ github.event.issue.author_association }}
 
  Lookup this issue with gh issue view ${{ github.event.issue.number }}.
 
@@ -49,6 +69,8 @@ jobs:
 
  Check whether the issue follows our contributing guidelines and issue templates.
 
+ If the issue author association is OWNER or MEMBER, skip this compliance check. Do not add the needs:compliance label for organization-owned issues.
+
  This project has three issue templates that every issue MUST use one of:
 
  1. Bug Report - requires a Description field with real content
@@ -83,7 +105,7 @@ jobs:
 
  Based on your findings, post a SINGLE comment on issue #${{ github.event.issue.number }}. Build the comment as follows:
 
- If the issue is NOT compliant, start the comment with:
+ If the issue is NOT compliant and the author association is not OWNER or MEMBER, start the comment with:
  <!-- issue-compliance -->
  Then explain what needs to be fixed and that they have 2 hours to edit the issue before it is automatically closed. Also add the label needs:compliance to the issue using: gh issue edit ${{ github.event.issue.number }} --add-label needs:compliance
 
@@ -129,12 +151,31 @@ jobs:
  with:
  fetch-depth: 1
 
+ - name: Check exempt issue author
+ id: author
+ run: |
+ LOGIN="${{ github.event.issue.user.login }}"
+ ASSOCIATION="${{ github.event.issue.author_association }}"
+
+ if [ "$LOGIN" = "opencode-agent[bot]" ] ||
+ [ "$ASSOCIATION" = "OWNER" ] ||
+ [ "$ASSOCIATION" = "MEMBER" ] ||
+ grep -qxiF "$LOGIN" .github/TEAM_MEMBERS; then
+ echo "skip=true" >> "$GITHUB_OUTPUT"
+ echo "Skipping issue automation for exempt author: $LOGIN ($ASSOCIATION)"
+ else
+ echo "skip=false" >> "$GITHUB_OUTPUT"
+ fi
+
  - uses: ./.github/actions/setup-bun
+ if: steps.author.outputs.skip != 'true'
 
  - name: Install opencode
+ if: steps.author.outputs.skip != 'true'
  run: curl -fsSL https://opencode.ai/install | bash
 
  - name: Recheck compliance
+ if: steps.author.outputs.skip != 'true'
  env:
  OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -148,9 +189,12 @@ jobs:
  }
  run: |
  opencode run -m opencode/claude-sonnet-4-6 "Issue #${{ github.event.issue.number }} was previously flagged as non-compliant and has been edited.
+ Issue author association: ${{ github.event.issue.author_association }}
 
  Lookup this issue with gh issue view ${{ github.event.issue.number }}.
 
+ If the issue author association is OWNER or MEMBER, remove the needs:compliance label if present, delete the previous compliance comment if present, and do not post a new comment.
+
  Re-check whether the issue now follows our contributing guidelines and issue templates.
 
  This project has three issue templates that every issue MUST use one of:

.github/workflows/publish.yml

@@ -219,7 +219,6 @@ jobs:
 
  build-electron:
  needs:
- - build-cli
  - version
  if: github.repository == 'anomalyco/opencode'
  continue-on-error: false
@@ -316,15 +315,13 @@ jobs:
  env:
  OPENCODE_VERSION: ${{ needs.version.outputs.version }}
  OPENCODE_CHANNEL: ${{ (github.ref_name == 'beta' && 'beta') || 'prod' }}
- OPENCODE_CLI_ARTIFACT: ${{ (runner.os == 'Windows' && 'opencode-cli-windows') || 'opencode-cli' }}
  RUST_TARGET: ${{ matrix.settings.target }}
- GH_TOKEN: ${{ github.token }}
- GITHUB_RUN_ID: ${{ github.run_id }}
 
  - name: Build
  run: bun run build
  working-directory: packages/desktop
  env:
+ NODE_OPTIONS: --max-old-space-size=4096
  OPENCODE_CHANNEL: ${{ (github.ref_name == 'beta' && 'beta') || 'prod' }}
  SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
  SENTRY_ORG: ${{ vars.SENTRY_ORG }}

.github/workflows/storybook.yml

@@ -9,6 +9,7 @@ on:
  - "bun.lock"
  - "packages/storybook/**"
  - "packages/ui/**"
+ - "packages/session-ui/**"
  pull_request:
  branches: [dev]
  paths:
@@ -17,6 +18,7 @@ on:
  - "bun.lock"
  - "packages/storybook/**"
  - "packages/ui/**"
+ - "packages/session-ui/**"
  workflow_dispatch:
 
 concurrency:

.github/workflows/test.yml

@@ -79,10 +79,15 @@ jobs:
 
  - name: Run unit tests
  timeout-minutes: 45
- run: bun turbo test --output-logs=errors-only --log-order=grouped --log-prefix=task
+ run: GITHUB_ACTIONS=false bun turbo test --output-logs=errors-only --log-order=grouped --log-prefix=task
  env:
  OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER: ${{ runner.os == 'Windows' && 'true' || 'false' }}
 
+ - name: Check generated client
+ if: runner.os == 'Linux'
+ working-directory: packages/client
+ run: bun run check:generated
+
  - name: Run HttpApi exerciser gates
  if: runner.os == 'Linux'
  working-directory: packages/opencode

.github/workflows/triage.yml

@@ -16,13 +16,32 @@ jobs:
  with:
  fetch-depth: 1
 
+ - name: Check exempt issue author
+ id: author
+ run: |
+ LOGIN="${{ github.event.issue.user.login }}"
+ ASSOCIATION="${{ github.event.issue.author_association }}"
+
+ if [ "$LOGIN" = "opencode-agent[bot]" ] ||
+ [ "$ASSOCIATION" = "OWNER" ] ||
+ [ "$ASSOCIATION" = "MEMBER" ] ||
+ grep -qxiF "$LOGIN" .github/TEAM_MEMBERS; then
+ echo "skip=true" >> "$GITHUB_OUTPUT"
+ echo "Skipping issue automation for exempt author: $LOGIN ($ASSOCIATION)"
+ else
+ echo "skip=false" >> "$GITHUB_OUTPUT"
+ fi
+
  - name: Setup Bun
+ if: steps.author.outputs.skip != 'true'
  uses: ./.github/actions/setup-bun
 
  - name: Install opencode
+ if: steps.author.outputs.skip != 'true'
  run: curl -fsSL https://opencode.ai/install | bash
 
  - name: Triage issue
+ if: steps.author.outputs.skip != 'true'
  env:
  OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.opencode/command/translate.md

@@ -1,6 +1,6 @@
 ---
 description: translate English to other languages
-model: opencode/claude-opus-4-8
+model: opencode/gpt-5.6-sol
 ---
 
 run git diff and translate changed english doc and UI copy files to other international languages. Translate all languages in parallel to save time.

.opencode/opencode.jsonc

@@ -2,9 +2,7 @@
  "$schema": "https://opencode.ai/config.json",
  "provider": {},
  "permission": {},
- // TODO: flip back to `references` once a release containing the v1 `reference` migration ships.
- // The release pipeline runs the latest published opencode against this file, which only knows `reference`.
- "reference": {
+ "references": {
  "effect": {
  "repository": "github.com/Effect-TS/effect-smol",
  "description": "Use for Effect v4 and effect-smol implementation details",

.opencode/tool/github-triage.ts

@@ -4,7 +4,7 @@ import { tool } from "@opencode-ai/plugin"
 const TEAM = {
  tui: ["kommander", "simonklee"],
  desktop_web: ["Hona", "Brendonovich"],
- core: ["jlongster", "rekram1-node", "nexxeln", "kitlangton", "starptech"],
+ core: ["jlongster", "rekram1-node", "nexxeln", "kitlangton"],
  inference: ["fwang", "MrMushrooooom", "starptech"],
  windows: ["Hona"],
 } as const

.prettierignore

@@ -1,2 +1,4 @@
 sst-env.d.ts
 packages/desktop/src/bindings.ts
+packages/client/src/generated/
+packages/client/src/generated-effect/

AGENTS.md

@@ -1,7 +1,15 @@
-- To regenerate the JavaScript SDK, run `./packages/sdk/js/script/build.ts`.
+- To regenerate the legacy JavaScript SDK, run `./packages/sdk/js/script/build.ts`.
+- After changing the public Protocol or Server `HttpApi`, run `bun run generate` from `packages/client`. Do not edit `src/generated` or `src/generated-effect` directly.
+- Keep runtime dependencies directed from Schema to Core and Protocol, then from Core and Protocol to Server. Client runtime code may depend on Schema and Protocol but never Core or Server; `sdk-next` composes Client, Core, and Server.
 - The default branch in this repo is `dev`.
 - Local `main` ref may not exist; use `dev` or `origin/dev` for diffs.
 
+## Branch Names
+
+Use a short branch name of at most three words, separated by hyphens. Do not use slashes or type prefixes such as `feat/` or `fix/`.
+
+Examples: `session-recovery`, `fix-scroll-state`, `regenerate-sdk`.
+
 ## Commits and PR Titles
 
 Use conventional commit-style messages and PR titles: `type(scope): summary`.
@@ -22,6 +30,7 @@ Examples: `fix(tui): simplify thinking toggle styling`, `docs: update contributi
 - Rely on type inference when possible; avoid explicit type annotations or interfaces unless necessary for exports or clarity
 - Prefer functional array methods (flatMap, filter, map) over for loops; use type guards on filter to maintain type inference downstream
 - In `src/config`, follow the existing self-export pattern at the top of the file (for example `export * as ConfigAgent from "./agent"`) when adding a new config module.
+- In Effect generators, bind services to named variables before calling methods. Do not use nested service yields such as `yield* (yield* Foo.Service).bar()`.
 
 Reduce total variable count by inlining when a value is only used once.
 
@@ -131,7 +140,7 @@ const table = sqliteTable("session", {
 
 ## Testing
 
-- Avoid mocks as much as possible
+- Avoid mocks as much as possible, you shouldn't be using globalThis.\* at all unless it's the only option.
 - Test actual implementation, do not duplicate logic into tests
 - Tests cannot run from repo root (guard: `do-not-run-tests-from-root`); run from package dirs like `packages/opencode`.
 
@@ -146,7 +155,7 @@ const table = sqliteTable("session", {
 - Keep `SessionExecution` process-global and Session-ID based. Its local implementation owns the process-local Session coordinator and discovers placement through `SessionStore` plus `LocationServiceMap.get(session.location)` only when a drain starts; no layer should take a Session ID. V2 interruption targets the active process-local ownership chain for that Session; idle or missing interruption is a no-op.
 - Keep `SessionRunner`, model resolution, tool registry, permissions, and filesystem Location-scoped. Omitted `Location.workspaceID` means implicit-local placement; explicit workspace identity remains reserved for future placement semantics.
 - Preserve one explicit `llm.stream(request)` call per provider turn and reload projected history before durable continuation. Do not bridge through legacy `SessionPrompt.loop(...)` or delegate orchestration to an in-memory tool loop.
-- Keep local Session drains process-local until clustering is implemented. `SessionRunCoordinator` joins explicit same-Session resumes, coalesces prompt wakeups, and allows different Sessions to run concurrently. Advisory wakes drain eligible durable inbox rows only; post-crash activity recovery requires a separate explicit design before it may retry provider work.
-- Keep delivery vocabulary explicit. Prompts steer by default and coalesce into the active activity at the next safe provider-turn boundary. Explicit `queue` inputs open FIFO future activities one at a time after the active activity settles.
+- Keep local Session drains process-local until clustering is implemented. `SessionRunCoordinator` joins explicit same-Session resumes, coalesces prompt wakeups, and allows different Sessions to run concurrently. Advisory wakes drain eligible durable inbox rows only; post-crash continuation recovery requires a separate explicit design before it may retry provider work. A drain has no durable identity or transcript boundary.
+- Keep delivery vocabulary explicit. Prompts steer by default and promote at the next safe provider-turn boundary while the current drain requires continuation. An explicit `queue` input remains pending until the Session would otherwise become idle; promote one queued input at that boundary, then reevaluate continuation before promoting another. Promoting any new user input resets the selected agent's provider-turn allowance; a batch of steers resets it once.
 - Keep EventV2 replay owner claims separate from clustered Session execution ownership.
 - Keep the System Context algebra, registry, and built-ins in `src/system-context`; keep Context Source producers with their observed domains, and keep Session History selection plus Context Epoch persistence Session-owned.