alchemylab-opencode 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 opencode
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NODE_COMPAT.md

@@ -0,0 +1,184 @@
+# OpenCode Node.js Compatibility
+
+OpenCode serve mode has been patched to run on Node.js 24+ without Bun.
+This document describes what was changed, why, and how to run it.
+
+## Quick Start
+
+```bash
+# Requires Node.js 24+
+node --experimental-strip-types --experimental-transform-types \
+     --import ./packages/opencode/src/node-preload.mjs \
+     packages/opencode/src/serve.ts --port 4096
+
+# With per-project data isolation (recommended for alchemylab)
+node --experimental-strip-types --experimental-transform-types \
+     --import ./packages/opencode/src/node-preload.mjs \
+     packages/opencode/src/serve.ts --port 4096 --data-dir /path/to/project/.alchemy_lab/opencode
+```
+
+## Per-Project Data Isolation
+
+By default, OpenCode stores data in `~/.local/share/opencode/`. The `--data-dir` flag
+(or `OPENCODE_DATA_DIR` env var) redirects project-specific data to a custom directory:
+
+| Path | Default | With `--data-dir` |
+|------|---------|-------------------|
+| Database | `~/.local/share/opencode/opencode.db` | `<data-dir>/opencode.db` |
+| Auth | `~/.local/share/opencode/auth.json` | `<data-dir>/auth.json` |
+| Plans | `~/.local/share/opencode/plans/` | `<data-dir>/plans/` |
+| State/locks | `~/.local/state/opencode/` | `<data-dir>/state/` |
+| Logs | `~/.local/share/opencode/log/` | `<data-dir>/log/` |
+| Config | `~/.config/opencode/` | `~/.config/opencode/` (unchanged) |
+| Bin cache | `~/.cache/opencode/bin/` | `~/.cache/opencode/bin/` (unchanged) |
+
+Config and bin cache stay global so user preferences and downloaded tools are shared.
+
+## Why Node.js 24?
+
+| Node Version | Status | Issue |
+|--------------|--------|-------|
+| 22 LTS | ❌ | `tsx` injects esbuild `__name` helper that breaks Effect framework |
+| 23 | ❌ | V8 crash in async ESM module evaluation (`AsyncModuleExecutionFulfilled`) |
+| 24 LTS | ✅ | Native `--experimental-strip-types` avoids esbuild entirely |
+| 25+ | ✅ | Should work (untested) |
+
+Node 24's native TypeScript stripping means no transpiler is needed. The code runs
+as-is with types stripped at load time. This avoids the `__name` injection that
+`tsx`/`esbuild` add and that Bun provides globally but Node doesn't.
+
+## Architecture
+
+### Entry Point
+
+`src/serve.ts` — A minimal entry point that only imports the server path.
+The main `src/index.ts` eagerly imports TUI/CLI code that depends on Bun-specific
+packages (`bun`, `bun-pty`, `bun:ffi`). The serve entry point sidesteps all of that.
+
+### Node Preload (`src/node-preload.mjs`)
+
+Loaded via `--import` before any application code. Does two things:
+
+1. **Polyfills `globalThis.__name`** — Bun provides this globally (esbuild `--keep-names`
+   helper). The Effect framework and other dependencies rely on it.
+2. **Registers the custom ESM loader** via `node:module` `register()`.
+
+### Node Loader (`src/node-loader.mjs`)
+
+Custom ESM resolve + load hooks that bridge Bun/Node differences:
+
+- **Extensionless imports** → tries `.ts`, `.tsx`, `/index.ts`, `/index.tsx`
+- **`.txt` file imports** → reads file and exports as default string (Bun supports this natively)
+- **`bun:sqlite`** → redirected to `node:sqlite`
+- **`bun:ffi`** → stubbed (only used for Windows TUI, not serve)
+- **`bun` / `bun-pty`** → stubbed (only used for TUI/CLI)
+- **`.js` → `.ts` remapping** → for workspace packages where imports use `.js` but source is `.ts`
+- **`@/` and `@tui/` path aliases** → resolved to `src/` and `src/cli/cmd/tui/`
+
+## Files Changed
+
+### HTTP Server (`src/server/server.ts`)
+- **Already done in dev branch**: Uses `@hono/node-server` with `createAdaptorServer`
+- No Bun-specific code remains
+
+### WebSocket Proxy (`src/server/proxy.ts`)
+- **Before**: `import { upgradeWebSocket } from "hono/bun"`
+- **After**: `import { createNodeWebSocket } from "@hono/node-ws"`
+
+### Static File Serving (`src/server/instance.ts`)
+- **Before**: `Bun.file(match)` for embedded web UI
+- **After**: `fs.readFileSync(match)` with manual MIME type lookup
+
+### Prompt Async Route (`src/server/routes/session.ts`)
+- **Before**: `c.status(204)` + `stream()` — Node's `Response` rejects 204 with body
+- **After**: `c.status(202)` — semantically correct for "accepted for processing"
+
+### Database (`src/storage/db.ts`)
+- **Before**: `import { type SQLiteBunDatabase } from "drizzle-orm/bun-sqlite"` and
+  `import { migrate } from "drizzle-orm/bun-sqlite/migrator"`
+- **After**: Uses `drizzle-orm/node-sqlite` equivalents
+- **Migration**: `bun-sqlite` migrator accepts raw journal entries; `node-sqlite` migrator
+  requires `{ migrationsFolder }` config. Dev mode now passes the folder path.
+
+### Database Conditional Import (`package.json`)
+- **Before**: `"#db": { "default": "./src/storage/db.bun.ts" }`
+- **After**: `"#db": { "default": "./src/storage/db.node.ts" }`
+
+### File Watcher (`src/file/watcher.ts`)
+- **Before**: `require("@parcel/watcher-...")` — `require` doesn't exist in ESM
+- **After**: `import { createRequire } from "node:module"` then `createRequire(import.meta.url)`
+
+### OAuth Servers
+Both `src/mcp/oauth-callback.ts` and `src/plugin/codex.ts`:
+- **Before**: `Bun.serve({ port, fetch() {} })`
+- **After**: `http.createServer()` with manual Request/Response bridging
+
+### Lazy Imports (`src/index.ts`)
+These modules use `bun:sqlite` directly and would crash on import:
+- `JsonMigration` — now lazy: `import("./storage/json-migration").catch(() => null)`
+- `DbCommand` — now lazy, removed from yargs command registration
+
+## Dependencies Added
+
+- `@hono/node-ws` — Node.js WebSocket adapter for Hono (already had `@hono/node-server`)
+
+## Session Identity via _meta (Core Fix)
+
+Upstream OpenCode's `callTool` does not pass `_meta` on MCP tool calls. This means MCP
+servers cannot know which session a tool call belongs to — a critical problem when MCP
+processes are shared across sessions (which OpenCode does for efficiency).
+
+### The Fix
+
+- `src/mcp/index.ts`: Added `MCP.currentToolContext` (thread-local context) and modified
+  `convertMcpTool()` to include `_meta: { sessionId, messageId }` in every `callTool` request.
+- `src/session/prompt.ts`: Sets `MCP.currentToolContext` from the session's tool execution
+  context before each MCP tool call.
+
+### Result
+
+Every MCP tool call now carries `_meta.sessionId` and `_meta.messageId`. The alchemy MCP
+server uses these directly (via `request.params._meta.sessionId`) instead of expensive HTTP
+discovery. This eliminates session identity races when MCP processes are shared across
+concurrent sessions.
+
+### Verified
+
+```
+[11:58:36] read_files | _meta-debug {
+  "has_meta": true,
+  "sessionId": "ses_2986f17c8ffefuXAJN3qDIHzND",
+  "messageId": "msg_d67cf04da001EdSMwdFednSJES"
+}
+```
+
+## Known Limitations
+
+1. **Plugin CJS loading** — Alchemy plugins compiled as CJS fail with "not a function"
+   under Node's ESM import. The IIFE wrapper in `MCPClientConfigurer.ts` handles this
+   for Bun/OpenCode; same approach needed for Node.
+
+2. **`opencode db` CLI command** — Not available (uses `bun:sqlite` directly). Only
+   affects database admin tasks, not serve mode.
+
+3. **JSON migration** — Skipped on Node.js (migrates legacy JSON storage to SQLite).
+   Only relevant for users upgrading from very old opencode versions.
+
+4. **ExperimentalWarning** — Node 24 prints warnings for `strip-types`, `transform-types`,
+   and `SQLite`. These are harmless and can be suppressed with `--no-warnings`.
+
+## Tested Endpoints
+
+All passing on Node.js 24.14.1:
+
+- `GET /session` — list sessions
+- `POST /session` — create session
+- `GET /session/:id` — get session
+- `DELETE /session/:id` — delete session
+- `POST /session/:id/prompt_async` — send async prompt
+- `GET /session/:id/message` — get messages
+- `GET /event` — SSE event stream
+- `GET /global/health` — health check
+- `GET /config/providers` — provider configuration
+- `GET /auth/:provider` — auth status
+- `GET /doc` — OpenAPI specification

package/package.json

@@ -0,0 +1,112 @@
+{
+  "name": "alchemylab-opencode",
+  "version": "1.0.0",
+  "description": "OpenCode server runtime for AlchemyLab",
+  "type": "module",
+  "license": "MIT",
+  "scripts": {
+    "postinstall": "node postinstall.cjs"
+  },
+  "files": [
+    "packages/opencode/src/**",
+    "packages/opencode/migration/**",
+    "packages/opencode/package.json",
+    "packages/plugin/src/**",
+    "packages/plugin/package.json",
+    "packages/sdk/src/**",
+    "packages/sdk/package.json",
+    "packages/util/src/**",
+    "packages/util/package.json",
+    "packages/script/src/**",
+    "packages/script/package.json",
+    "postinstall.cjs",
+    "NODE_COMPAT.md"
+  ],
+  "dependencies": {
+    "@agentclientprotocol/sdk": "0.16.1",
+    "@ai-sdk/amazon-bedrock": "^4.0.91",
+    "@ai-sdk/anthropic": "3.0.67",
+    "@ai-sdk/azure": "3.0.49",
+    "@ai-sdk/cerebras": "2.0.41",
+    "@ai-sdk/cohere": "3.0.27",
+    "@ai-sdk/deepinfra": "2.0.41",
+    "@ai-sdk/gateway": "3.0.80",
+    "@ai-sdk/google": "3.0.53",
+    "@ai-sdk/google-vertex": "4.0.95",
+    "@ai-sdk/groq": "3.0.31",
+    "@ai-sdk/mistral": "3.0.27",
+    "@ai-sdk/openai": "3.0.48",
+    "@ai-sdk/openai-compatible": "2.0.37",
+    "@ai-sdk/perplexity": "3.0.26",
+    "@ai-sdk/provider": "3.0.8",
+    "@ai-sdk/provider-utils": "4.0.23",
+    "@ai-sdk/togetherai": "2.0.41",
+    "@ai-sdk/vercel": "2.0.39",
+    "@ai-sdk/xai": "3.0.75",
+    "@aws-sdk/credential-providers": "^3.1025.0",
+    "@clack/prompts": "1.0.0-alpha.1",
+    "@effect/platform-node": "4.0.0-beta.43",
+    "@gitlab/gitlab-ai-provider": "3.6.0",
+    "@gitlab/opencode-gitlab-auth": "1.3.3",
+    "@hono/node-server": "1.19.11",
+    "@hono/node-ws": "1.3.0",
+    "@hono/standard-validator": "^0.2.2",
+    "@hono/zod-validator": "0.4.2",
+    "@lydell/node-pty": "1.2.0-beta.10",
+    "@modelcontextprotocol/sdk": "1.27.1",
+    "@npmcli/arborist": "9.4.0",
+    "@openrouter/ai-sdk-provider": "2.4.2",
+    "@parcel/watcher": "2.5.1",
+    "@standard-community/standard-json": "^0.3.5",
+    "@standard-community/standard-openapi": "^0.2.9",
+    "@standard-schema/spec": "^1.1.0",
+    "@zip.js/zip.js": "2.7.62",
+    "ai": "6.0.149",
+    "bonjour-service": "1.3.0",
+    "chokidar": "4.0.3",
+    "cross-spawn": "7.0.6",
+    "decimal.js": "10.5.0",
+    "diff": "8.0.2",
+    "drizzle-orm": "1.0.0-beta.19-d95b7a4",
+    "effect": "4.0.0-beta.43",
+    "fuzzysort": "3.1.0",
+    "gitlab-ai-provider": "^6.4.1",
+    "glob": "13.0.5",
+    "google-auth-library": "^10.6.2",
+    "gray-matter": "4.0.3",
+    "gtoken": "^8.0.0",
+    "hono": "4.10.7",
+    "hono-openapi": "1.1.2",
+    "ignore": "7.0.5",
+    "ioredis": "^5.10.1",
+    "jsonc-parser": "3.3.1",
+    "mime-types": "3.0.2",
+    "minimatch": "10.0.3",
+    "npm-package-arg": "13.0.2",
+    "open": "10.1.2",
+    "opencode-gitlab-auth": "2.0.1",
+    "opencode-poe-auth": "0.0.1",
+    "partial-json": "0.1.7",
+    "quansync": "^1.0.0",
+    "remeda": "2.26.0",
+    "semver": "^7.6.3",
+    "turndown": "7.2.0",
+    "ulid": "3.0.1",
+    "venice-ai-sdk-provider": "2.0.1",
+    "vscode-jsonrpc": "8.2.1",
+    "web-tree-sitter": "0.25.10",
+    "which": "6.0.1",
+    "xdg-basedir": "5.1.0",
+    "yargs": "18.0.0",
+    "zod": "4.1.8",
+    "zod-to-json-schema": "3.24.5"
+  },
+  "trustedDependencies": [
+    "esbuild",
+    "node-pty",
+    "web-tree-sitter"
+  ],
+  "engines": {
+    "node": ">=24.0.0"
+  }
+}

package/packages/opencode/migration/20260127222353_familiar_lady_ursula/migration.sql

@@ -0,0 +1,90 @@
+CREATE TABLE `project` (
+	`id` text PRIMARY KEY,
+	`worktree` text NOT NULL,
+	`vcs` text,
+	`name` text,
+	`icon_url` text,
+	`icon_color` text,
+	`time_created` integer NOT NULL,
+	`time_updated` integer NOT NULL,
+	`time_initialized` integer,
+	`sandboxes` text NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE `message` (
+	`id` text PRIMARY KEY,
+	`session_id` text NOT NULL,
+	`time_created` integer NOT NULL,
+	`time_updated` integer NOT NULL,
+	`data` text NOT NULL,
+	CONSTRAINT `fk_message_session_id_session_id_fk` FOREIGN KEY (`session_id`) REFERENCES `session`(`id`) ON DELETE CASCADE
+);
+--> statement-breakpoint
+CREATE TABLE `part` (
+	`id` text PRIMARY KEY,
+	`message_id` text NOT NULL,
+	`session_id` text NOT NULL,
+	`time_created` integer NOT NULL,
+	`time_updated` integer NOT NULL,
+	`data` text NOT NULL,
+	CONSTRAINT `fk_part_message_id_message_id_fk` FOREIGN KEY (`message_id`) REFERENCES `message`(`id`) ON DELETE CASCADE
+);
+--> statement-breakpoint
+CREATE TABLE `permission` (
+	`project_id` text PRIMARY KEY,
+	`time_created` integer NOT NULL,
+	`time_updated` integer NOT NULL,
+	`data` text NOT NULL,
+	CONSTRAINT `fk_permission_project_id_project_id_fk` FOREIGN KEY (`project_id`) REFERENCES `project`(`id`) ON DELETE CASCADE
+);
+--> statement-breakpoint
+CREATE TABLE `session` (
+	`id` text PRIMARY KEY,
+	`project_id` text NOT NULL,
+	`parent_id` text,
+	`slug` text NOT NULL,
+	`directory` text NOT NULL,
+	`title` text NOT NULL,
+	`version` text NOT NULL,
+	`share_url` text,
+	`summary_additions` integer,
+	`summary_deletions` integer,
+	`summary_files` integer,
+	`summary_diffs` text,
+	`revert` text,
+	`permission` text,
+	`time_created` integer NOT NULL,
+	`time_updated` integer NOT NULL,
+	`time_compacting` integer,
+	`time_archived` integer,
+	CONSTRAINT `fk_session_project_id_project_id_fk` FOREIGN KEY (`project_id`) REFERENCES `project`(`id`) ON DELETE CASCADE
+);
+--> statement-breakpoint
+CREATE TABLE `todo` (
+	`session_id` text NOT NULL,
+	`content` text NOT NULL,
+	`status` text NOT NULL,
+	`priority` text NOT NULL,
+	`position` integer NOT NULL,
+	`time_created` integer NOT NULL,
+	`time_updated` integer NOT NULL,
+	CONSTRAINT `todo_pk` PRIMARY KEY(`session_id`, `position`),
+	CONSTRAINT `fk_todo_session_id_session_id_fk` FOREIGN KEY (`session_id`) REFERENCES `session`(`id`) ON DELETE CASCADE
+);
+--> statement-breakpoint
+CREATE TABLE `session_share` (
+	`session_id` text PRIMARY KEY,
+	`id` text NOT NULL,
+	`secret` text NOT NULL,
+	`url` text NOT NULL,
+	`time_created` integer NOT NULL,
+	`time_updated` integer NOT NULL,
+	CONSTRAINT `fk_session_share_session_id_session_id_fk` FOREIGN KEY (`session_id`) REFERENCES `session`(`id`) ON DELETE CASCADE
+);
+--> statement-breakpoint
+CREATE INDEX `message_session_idx` ON `message` (`session_id`);--> statement-breakpoint
+CREATE INDEX `part_message_idx` ON `part` (`message_id`);--> statement-breakpoint
+CREATE INDEX `part_session_idx` ON `part` (`session_id`);--> statement-breakpoint
+CREATE INDEX `session_project_idx` ON `session` (`project_id`);--> statement-breakpoint
+CREATE INDEX `session_parent_idx` ON `session` (`parent_id`);--> statement-breakpoint
+CREATE INDEX `todo_session_idx` ON `todo` (`session_id`);