Opencode

Work with Effect v4 / effect-smol TypeScript code in this repo

This package vendors a Drizzle Effect SQLite adapter for this repo.

- Prefer HttpClient.HttpClient / HttpClientResponse.HttpClientResponse over web fetch / Response at package boundaries. - Use Stream.Stream for streaming data flow. Avoid ad hoc async generators or manual web reader loops unless an Effect Stream API cannot model the behavior. - Use Effect Schema codecs for JSON encode/decode (Schema.fromJsonString(...)) instead of direct JSON.p

This folder owns Core's one local tool representation, process and Location registration, effective lookup, and settlement.

- NEVER try to restart the app, or the server process, EVER.

Build AI agents on Cloudflare Workers using the Agents SDK. Load when creating stateful agents, durable workflows, real-time WebSocket apps, scheduled tasks, MCP servers, or chat applications. Covers Agent class, state management, callable RPC, Workflows integration, and React hooks.

Comprehensive Cloudflare platform skill covering Workers, Pages, storage (KV, D1, R2), AI (Workers AI, Vectorize, Agents SDK), networking (Tunnel, Spectrum), security (WAF, DDoS), and infrastructure-as-code (Terraform, Pulumi). Use for any Cloudflare development task.

Use these patterns for server and HttpApi middleware tests in this directory.

The tmpdir function in fixture/fixture.ts creates temporary directories for tests with automatic cleanup.

- Schema: Drizzle schema lives in packages/core/src//.sql.ts. - Migrations: database migrations live in packages/core and are applied by core.

Use HttpApiBuilder.group(...) for normal HTTP endpoints, including streaming HTTP responses such as server-sent events. Handlers should yield stable services once while building the handler layer, then close over those services in endpoint implementations.

../llm.ts is the opencode session LLM service. It owns opencode concerns: auth, config, model/provider resolution, plugins, permissions, telemetry headers, and runtime selection. It is the only file in this area that should know about the full session request shape.

- To regenerate the JavaScript SDK, run ./packages/sdk/js/script/build.ts. - The default branch in this repo is dev. - Local main ref may not exist; use dev or origin/dev for diffs.