Bohdan Triapitsyn
68f1c1efe3
Keep always-on instructions concise and route specialized work through focused skills. Split large skills into progressive references and add dedicated change, desktop, sync, and performance guidance.
50 lines
2.7 KiB
Markdown
50 lines
2.7 KiB
Markdown
# Runtime Implementation Map
|
|
|
|
## Shared UI
|
|
|
|
- `packages/ui/src/lib/opencode/client.ts`: OpenCode v2 SDK wrapper, current-directory handling, runtime-aware SDK client.
|
|
- `packages/ui/src/lib/runtime-fetch.ts`: runtime HTTP URL resolution and auth while preserving SDK `Request` fidelity.
|
|
- `packages/ui/src/lib/runtime-url.ts`: browser/realtime URL construction.
|
|
- `packages/ui/src/lib/runtime-auth.ts`: bearer state and short-lived URL-token minting.
|
|
- `packages/ui/src/lib/api/types.ts`: shared `RuntimeAPIs` contract.
|
|
- `packages/ui/src/contexts/RuntimeAPIProvider.tsx`: React provider and runtime API wrappers.
|
|
- `packages/ui/src/hooks/useRuntimeAPIs.ts`: React consumption path.
|
|
|
|
## Web And Server
|
|
|
|
- `packages/web/src/runtimeConfig.ts`: initializes runtime URL/auth and web APIs.
|
|
- `packages/web/src/api/index.ts`: composes web `RuntimeAPIs`.
|
|
- `packages/web/server/lib/opencode/core-routes.js`: installs OpenChamber route families.
|
|
- `packages/web/server/lib/opencode/feature-routes-runtime.js`: explicit feature route registration.
|
|
- `packages/web/server/lib/opencode/proxy.js`: generic OpenCode proxy fallback.
|
|
- `packages/web/server/lib/ui-auth/ui-auth.js`: session and URL-token route gates.
|
|
|
|
Explicit OpenChamber routes must register before the generic `/api/*` OpenCode proxy.
|
|
|
|
## VS Code
|
|
|
|
- `packages/vscode/webview/main.tsx`: webview fetch routing and local-route handling.
|
|
- `packages/vscode/webview/api/index.ts`: webview `RuntimeAPIs` composition.
|
|
- `packages/vscode/webview/api/bridge.ts`: request, session-message, and SSE bridge helpers.
|
|
- `packages/vscode/webview/requestBodyTransport.ts`: byte-preserving request-body extraction.
|
|
- `packages/vscode/src/bridge-proxy-runtime.ts`: extension-host OpenCode forwarding.
|
|
- `packages/vscode/src/bridge-*-runtime.ts`: owning native/local handlers.
|
|
|
|
## Runtime Switching
|
|
|
|
`packages/ui/src/lib/runtime-switch.ts` updates endpoint/auth state and emits the runtime-change event. App roots reconnect SDK clients and reset runtime-scoped stores/transports.
|
|
|
|
Review every cache keyed only by session ID, directory, URL, or entity ID. Add runtime identity when local and remote runtimes can collide.
|
|
|
|
## Tests To Prefer
|
|
|
|
- HTTP/request fidelity: `packages/ui/src/lib/runtime-fetch.test.ts`
|
|
- URL/auth: `packages/ui/src/lib/runtime-url.test.ts`, `runtime-auth.test.ts`
|
|
- Server auth: `packages/web/server/lib/ui-auth/ui-auth.test.js`
|
|
- Generic proxy: `packages/web/server/opencode-proxy.test.js`
|
|
- Preview proxy: `packages/web/server/lib/preview/proxy-runtime.test.js`
|
|
- VS Code bridge: `packages/vscode/webview/api/bridge.test.ts`
|
|
- VS Code proxy: `packages/vscode/src/bridge-proxy-runtime.test.js`
|
|
|
|
Also run focused tests beside new runtime implementations and validation required by each affected workspace.
|