@jaralabs/codex-bridge 0.2.0 → 0.4.0

package/lib/tools-registry.mjs

@@ -0,0 +1,57 @@
+// tools-registry: tracks the list of MCP tools available to the bridge.
+//
+// In a normal ChatGPT Plus setup, the model "knows" about its tools via a
+// system prompt that lists them. OpenCode does NOT inject the live MCP
+// catalog into /v1/chat/completions (it only sends `tools` when the AI SDK
+// explicitly enabled tool calling on the provider). To make the bridge feel
+// like Plus, we maintain a small registry that the OpenCode plugin can
+// populate via /v1/tools, and that handleChatCompletions injects into the
+// system prompt when the model has no other source of tool awareness.
+//
+// The registry is in-memory and process-local. A real deployment would
+// persist this to ~/.codex/tools_cache.json, but the bridge process is
+// short-lived enough (one process per TUI session is overkill; the TUI
+// restarts re-register via the plugin) that the in-memory map is fine.
+
+const tools = new Map(); // name -> { server, description, parameters, serverType, command?, url? }
+
+export function registerTool(name, meta) {
+  if (!name) return;
+  tools.set(name, {
+    server: meta.server || "unknown",
+    description: meta.description || "",
+    parameters: meta.parameters || { type: "object", properties: {} },
+    serverType: meta.serverType || "local",
+    command: meta.command,
+    url: meta.url,
+    registeredAt: Date.now(),
+  });
+}
+
+export function registerTools(list) {
+  if (!Array.isArray(list)) return;
+  for (const t of list) {
+    if (t?.name) registerTool(t.name, t);
+  }
+}
+
+export function listTools() {
+  return Array.from(tools.entries()).map(([name, meta]) => ({ name, ...meta }));
+}
+
+export function clearTools() {
+  tools.clear();
+}
+
+// Render the registry as a system-prompt block. We use a compact format
+// the model can parse: each tool on its own line with a JSON schema.
+export function renderToolsSystemBlock() {
+  if (tools.size === 0) return "";
+  const lines = ["You have access to the following tools. To call one, emit a tool_call with the matching name and JSON arguments."];
+  for (const [name, meta] of tools.entries()) {
+    const params = JSON.stringify(meta.parameters || { type: "object" });
+    const desc = meta.description ? ` — ${meta.description}` : "";
+    lines.push(`- ${name}${desc}  args=${params}`);
+  }
+  return lines.join("\n");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaralabs/codex-bridge",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "private": false,
   "description": "OpenAI-compatible HTTP bridge that reuses a local ChatGPT Business / Team / Plus session via codex, so OpenCode can list and call those models without paying for the OpenAI API.",
   "type": "module",
@@ -24,7 +24,7 @@
     "access": "public"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   },
   "scripts": {
     "start": "bin/codex-bridge start",
@@ -32,7 +32,10 @@
     "status": "bin/codex-bridge status",
     "sync": "bin/codex-bridge sync",
     "logs": "bin/codex-bridge logs",
-    "test": "node test/test.mjs"
+    "test": "node test/test.mjs",
+    "test:tools": "node test/test-tools.mjs",
+    "test:resilience": "node test/test-resilience.mjs",
+    "test:smoke": "node test/smoke.mjs"
   },
   "repository": {
     "type": "git",
@@ -51,5 +54,9 @@
     "coding-agent"
   ],
   "author": "Andrew Jaramillo <javamillog1999@outlook.com>",
-  "license": "MIT"
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^26.6.5",
+    "typescript": "^7.0.2"
+  }
 }