Distillation

Date: Sep 8, 2026

• 🟡 (19:03) User requested a read-only investigation of /home/byk/Code/opencode tracing how the web/desktop client loads provider/model lists and creates a new session for a selected project directory.
• 🟡 (19:03) User asked the investigation to identify: 1. HTTP endpoints called and how directory is passed; 2. every path yielding HTTP 499 or client-aborted responses; 3. project-bootstrap work shared by provider discovery and session creation; 4. likely project-specific failure modes when no .opencode config exists; 5. exact expected log messages/errors.
• 🔴 [enforced-read-only] (19:03) User required current-source-only inspection with exact file:line citations, no file edits, and no tests.
• 🟡 (19:03) User requested concise findings and a ranked diagnostic checklist.
• 🟡 (19:04) Repository file search returned exactly Found 100 matches (more matches available) and reported that results were truncated to the first 100; matches included client generated sources under /home/byk/Code/opencode/packages/client/src/, opencode server/session tests under /home/byk/Code/opencode/packages/opencode/test/, and /home/byk/Code/opencode/packages/opencode/specs/v2/api.ts.
• 🟡 (19:05) /home/byk/Code/opencode/packages/app/src contained 21 entries: addons/, app.tsx, assets/, components/, constants/, context/, custom-elements.d.ts, desktop-menu.test.ts, desktop-menu.ts, entry.tsx, env.d.ts, hooks/, i18n/, index.css, index.ts, pages/, sst-env.d.ts, theme-preload.test.ts, updater.ts, utils/, wsl/.
• 🟡 (19:05) /home/byk/Code/opencode/packages/desktop/src contained main/, preload/, and renderer/.
• 🟡 (19:06) Source search returned exactly Found 100 matches (more matches available) for provider/session-related terms; relevant hits included /home/byk/Code/opencode/packages/app/src/utils/server-compat.ts:164 calling legacy(value?.location ?? undefined).session.create(...), /home/byk/Code/opencode/packages/app/src/context/global-sync/bootstrap.ts:233 calling legacy.provider.list(), /home/byk/Code/opencode/packages/app/src/context/global-sync/bootstrap.ts:238 calling sdk.provider.list(location), and /home/byk/Code/opencode/packages/app/src/components/prompt-input/submit.ts:404 calling .api.session.create(...).
• 🔴 (19:06) User-provided project instructions require always preferring createStore over multiple createSignal calls.
• 🔴 (19:06) User-provided project instructions require an i18n key for all visible copy, placeholders, accessible labels, tooltips, menus, dialogs, toasts, empty states, and displayed errors; production code must never hardcode user-visible English strings.
• 🔴 (19:06) User-provided project instructions require never changing existing English text or English keys to facilitate translation; English is intentional designer-written source copy, and locale translations/i18n mechanics must adapt around it.
• 🔴 (19:06) User-provided project instructions require translation-review notes to name the corpora used and identify uncertain or region-specific terminology for native-speaker review.
• 🔴 [enforced-workflow] (19:06) User-provided project instructions require ALWAYS USE PARALLEL TOOLS WHEN APPLICABLE.
• 🔴 [enforced-workflow] (19:06) User-provided project instructions require never attempting to restart the app or server process.
• 🟡 (19:07) /home/byk/Code/opencode/packages/app/src/context/global-sync/bootstrap.ts:330-359 defines bootstrapDirectory(input) with directory, scope, mcp, sdk, a combined API containing agent, command, mcp, permission, project, question, reference, session, and vcs, plus store, setStore, vcsCache, loadSessions, translate, global config/path/project/provider, queryClient, optional session, optional protocol, and optional connected.
• 🟡 (19:07) bootstrapDirectory() seeds project/path/config and sets partial loading state at /home/byk/Code/opencode/packages/app/src/context/global-sync/bootstrap.ts:365-373; provider revisions are scoped using ScopedKey.from(input.scope, input.directory) at lines 375-377.
• 🟡 (19:07) /home/byk/Code/opencode/packages/app/src/context/global-sync/bootstrap.ts:379-542 builds a parallel slow bootstrap task list containing: session loading; agent loading; v1 config loading; v1 session status; current project lookup; path lookup; v1 VCS loading; optional commands; references; permissions and session warming; questions and session warming; optional MCP state; optional MCP resources; and provider loading.
• 🟡 (19:07) Directory propagation in bootstrap includes loadSessions(input.directory) at /home/byk/Code/opencode/packages/app/src/context/global-sync/bootstrap.ts:380, loadAgentsQuery(input.scope, input.directory, ...) at lines 381-384, input.api.project.current({ location: { directory: input.directory } }) at lines 417-421, loadPathQuery(input.scope, input.directory, ...) at lines 422-429, loadCommands(input.directory, ...) at lines 439-443, loadReferencesQuery(input.scope, input.directory, ...) at lines 444-447, permission request location at lines 451-454, question request location at lines 487-490, MCP query directory at lines 520-529, and provider query directory at lines 530-533.
• 🟡 (19:07) /home/byk/Code/opencode/packages/app/src/context/global-sync/bootstrap.ts:412-414 resolves all session IDs from status concurrently with Promise.all; permission and question warming similarly use Promise.all at lines 460-462 and 496-498.
• 🟡 (19:07) Provider-load failure handling at /home/byk/Code/opencode/packages/app/src/context/global-sync/bootstrap.ts:530-541 catches the error, suppresses the toast if connected() is false, derives the project via getFilename(input.directory), and shows an error toast using i18n key toast.project.reloadFailed.title and formatServerError(err, input.translate).
• 🟡 (19:07) Bootstrap waits for paint, runs all slow tasks, and gathers rejected reasons at /home/byk/Code/opencode/packages/app/src/context/global-sync/bootstrap.ts:544-545; if errors exist, line 547 emits exact log prefix "Failed to finish bootstrap instance" with slowErrs[0], and lines 548-554 conditionally show the same project reload-failed toast using formatServerError(slowErrs[0], input.translate).
• 🟡 (19:07) /home/byk/Code/opencode/packages/app/src/context/global-sync/bootstrap.ts:557 marks status "complete" only when loading and slowErrs.length === 0; bootstrapDirectory() is fire-and-forget through an async IIFE at lines 378-558.
• 🟡 (19:08) /home/byk/Code/opencode/packages/app/src/components/prompt-input/submit.ts:333-347 aborts a working request if the prompt has no trimmed text, images, or comments; submission without a current model or agent shows prompt.toast.modelAgentRequired.title and prompt.toast.modelAgentRequired.description.
• 🟡 (19:08) New-session submission derives projectDirectory = sdk().directory, isNewSession = !params.id, and default worktree selection "main" at /home/byk/Code/opencode/packages/app/src/components/prompt-input/submit.ts:353-360.
• 🟡 (19:08) Worktree creation calls client.worktree.create({ directory: projectDirectory }) at /home/byk/Code/opencode/packages/app/src/components/prompt-input/submit.ts:362-366; failures show prompt.toast.worktreeCreateFailed.title with errorMessage(err) at lines 367-373, while a response lacking createdWorktree.directory shows the same title with common.requestFailed at lines 375-380.
• 🟡 (19:08) For a selected non-main existing worktree, /home/byk/Code/opencode/packages/app/src/components/prompt-input/submit.ts:386-388 assigns that selection to sessionDirectory; when it differs from the project directory, lines 390-396 create a directory-scoped client with { directory: sessionDirectory, throwOnError: true } and call serverSync().child(sessionDirectory).
• 🟡 (19:08) New-session creation calls sdk().api.session.create({ agent: currentAgent.name, model: { id: currentModel.id, providerID: currentModel.provider.id, variant }, location: { directory: sessionDirectory } }) at /home/byk/Code/opencode/packages/app/src/components/prompt-input/submit.ts:401-409.
• 🟡 (19:08) Session-create errors are caught at /home/byk/Code/opencode/packages/app/src/components/prompt-input/submit.ts:410-416 and shown with i18n key prompt.toast.sessionCreateFailed.title plus errorMessage(err); failure to obtain any session later shows prompt.toast.promptSendFailed.title and prompt.toast.promptSendFailed.description at lines 436-441.
• 🟡 (19:08) Successful session creation seeds the session by directory, optionally enables auto-accept, promotes local session state, transfers tabs, optionally promotes a draft, navigates to /${base64Encode(sessionDirectory)}/session/${session.id}, and retargets submission at /home/byk/Code/opencode/packages/app/src/components/prompt-input/submit.ts:417-433.
• 🟡 (19:09) Client source enumeration found /home/byk/Code/opencode/packages/client/src/index.ts, generated files generated/types.ts, generated/index.ts, generated/client.ts, generated/client-error.ts, generated Effect equivalents, effect.ts, and contract.ts; a subsequent search returned No files found.
• 🟡 (19:10) CatalogApi was referenced in /home/byk/Code/opencode/packages/app/src/context/global-sync/bootstrap.ts at lines 15, 145, 224, and 335, and in /home/byk/Code/opencode/packages/app/src/context/global-sync/bootstrap.test.ts at lines 5, 231, and 258.
• 🟡 (19:11) /home/byk/Code/opencode/packages/client/package.json:3 names the package @opencode-ai/client; exports are "." → "./src/index.ts" and "./effect" → "./src/effect.ts" at lines 7-10.
• 🟡 (19:11) /home/byk/Code/opencode/packages/client/package.json:11-15 scripts are generate: bun run script/build.ts, check:generated: bun run generate && git diff --exit-code -- src/generated src/generated-effect, test: bun test --timeout 5000, and typecheck: tsgo --noEmit.
• 🟡 (19:12) /home/byk/Code/opencode/packages/client/src/index.ts:1-2 exports everything from ./generated/index and aliases EventsSubscribeOutput as OpenCodeEvent.
• 🟡 (19:13) /home/byk/Code/opencode/packages/app/package.json:2-3 identifies @opencode-ai/app version 1.18.16.
• 🟡 (19:13) /home/byk/Code/opencode/packages/app/package.json:57 depends on @opencode-ai/client via the vendored archive file:vendor/opencode-ai-client-1.17.13-v2.tgz, while workspace packages include @opencode-ai/core, @opencode-ai/schema, @opencode-ai/sdk, @opencode-ai/session-ui, and @opencode-ai/ui at lines 58-62.
• 🟡 (19:14) /home/byk/Code/opencode/packages/app/vendor contains exactly opencode-ai-client-1.17.13-v2.tgz; two adjacent searches returned No files found.
• 🟡 (19:15) Root /home/byk/Code/opencode/node_modules/@opencode-ai contained only plugin/, script/, and sdk/, whereas /home/byk/Code/opencode/packages/app/node_modules/@opencode-ai contained client/, core/, schema/, sdk/, session-ui/, and ui/.
• 🟡 (19:16) /home/byk/Code/opencode/packages/app/node_modules/@opencode-ai/client contained dist/, package.json, and README.md.
• 🟡 (19:16) Server search found /home/byk/Code/opencode/packages/server/src/api.ts:3 importing SessionLocationMiddleware from ./middleware/session-location and line 7 exposing sessionLocationMiddleware: SessionLocationMiddleware.
• 🟡 (19:17) /home/byk/Code/opencode/packages/server/src contained 9 entries: api.ts, auth.ts, cors.ts, handlers.ts, handlers/, location.ts, middleware/, pty-environment.ts, and routes.ts.