thebird 1.2.17 → 1.2.19

package/CHANGELOG.md

@@ -5,3 +5,10 @@
 ### Added
 - `wasi/cli.ts`: Deno CLI — Anthropic-format prompt → Gemini streaming via REST, flags: `--model`, `--system`
 - `deno.json`: tasks `cli` (run) and `cli:compile` (single binary)
+
+## [Unreleased - 2]
+
+### Added
+- `server.js`: HTTP proxy on port 3456, serves Anthropic Messages API wire format (streaming SSE + non-streaming JSON), backed by thebird → Gemini. Observability at `GET /debug/server`.
+- `examples/sdk-validate.js`: Anthropic SDK (`@anthropic-ai/sdk`) client pointing at local proxy, validates both streaming and non-streaming paths.
+- `@anthropic-ai/sdk` added to dependencies.

package/CLAUDE.md

@@ -119,3 +119,11 @@ Run examples against real Gemini API to validate message translation.
 - `index.js`: Main entry point, streaming and generation wrappers
 - `index.d.ts`: TypeScript type definitions
 - `examples/`: Working examples using Anthropic SDK format
+- `wasi/cli.ts`: Deno streaming CLI — `deno run --allow-net --allow-env wasi/cli.ts [--model M] [--system S] <prompt>`
+- `deno.json`: tasks `cli` (run) and `cli:compile` (→ `dist/thebird` binary)
+
+## Environment Notes
+
+- Repo remote: `https://github.com/AnEntrypoint/thebird.git` (capital A)
+- Deno 2.1.3 available; `exec:bash` uses PowerShell — use `exec:cmd` with `set KEY=val && cmd` syntax for env vars
+- Windows `KEY=val cmd` inline env syntax fails in PowerShell

package/examples/sdk-validate.js

@@ -0,0 +1,31 @@
+const Anthropic = require('@anthropic-ai/sdk').default;
+
+const client = new Anthropic({
+  apiKey: 'placeholder',
+  baseURL: process.env.THEBIRD_URL || 'http://localhost:3456',
+});
+
+async function main() {
+  process.stdout.write('[streaming] ');
+  const stream = client.messages.stream({
+    model: 'gemini-2.5-flash',
+    max_tokens: 256,
+    messages: [{ role: 'user', content: 'Say exactly: thebird works' }],
+  });
+  for await (const ev of stream) {
+    if (ev.type === 'content_block_delta' && ev.delta.type === 'text_delta') {
+      process.stdout.write(ev.delta.text);
+    }
+  }
+  process.stdout.write('\n');
+
+  process.stdout.write('[non-streaming] ');
+  const msg = await client.messages.create({
+    model: 'gemini-2.5-flash',
+    max_tokens: 256,
+    messages: [{ role: 'user', content: 'Say exactly: thebird works' }],
+  });
+  console.log(msg.content[0].text);
+}
+
+main().catch(e => { process.stderr.write(e.message + '\n'); process.exit(1); });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thebird",
-  "version": "1.2.17",
+  "version": "1.2.19",
   "description": "Anthropic SDK to Gemini streaming bridge — drop-in proxy that translates Anthropic message format and tool calls to Google Gemini",
   "main": "index.js",
   "types": "index.d.ts",
@@ -35,9 +35,9 @@
     "url": "https://github.com/AnEntrypoint/thebird.git"
   },
   "dependencies": {
+    "@anthropic-ai/sdk": "^0.88.0",
     "@google/genai": "^1.0.0"
   },
-  "peerDependencies": {},
   "engines": {
     "node": ">=18"
   }

package/server.js

@@ -0,0 +1,77 @@
+const http = require('http');
+const { streamGemini, generateGemini } = require('./index.js');
+
+const PORT = process.env.PORT || 3456;
+const state = { requests: 0, errors: 0, active: 0 };
+
+const sse = (ev, data) => `event: ${ev}\ndata: ${JSON.stringify(data)}\n\n`;
+
+const msgId = () => 'msg_' + Math.random().toString(36).slice(2, 12);
+
+async function handleMessages(req, res) {
+  let body = '';
+  for await (const chunk of req) body += chunk;
+  const { model, messages, system, stream, max_tokens } = JSON.parse(body);
+  const apiKey = process.env.GEMINI_API_KEY;
+  if (!apiKey) { res.writeHead(500); res.end(JSON.stringify({ error: 'GEMINI_API_KEY required' })); return; }
+  const params = { model: model || 'gemini-2.5-flash', messages, system, apiKey, maxOutputTokens: max_tokens || 8192 };
+
+  if (!stream) {
+    const result = await generateGemini(params);
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({
+      id: msgId(), type: 'message', role: 'assistant', model: params.model,
+      content: [{ type: 'text', text: result.text }],
+      stop_reason: 'end_turn', usage: { input_tokens: 0, output_tokens: 0 },
+    }));
+    return;
+  }
+
+  res.writeHead(200, {
+    'Content-Type': 'text/event-stream',
+    'Cache-Control': 'no-cache',
+    'Connection': 'keep-alive',
+  });
+
+  const id = msgId();
+  res.write(sse('message_start', { type: 'message_start', message: { id, type: 'message', role: 'assistant', content: [], model: params.model, stop_reason: null, usage: { input_tokens: 0, output_tokens: 0 } } }));
+  res.write(sse('content_block_start', { type: 'content_block_start', index: 0, content_block: { type: 'text', text: '' } }));
+  res.write(sse('ping', { type: 'ping' }));
+
+  let outputTokens = 0;
+  for await (const ev of streamGemini(params).fullStream) {
+    if (ev.type === 'text-delta') {
+      outputTokens += ev.textDelta.length;
+      res.write(sse('content_block_delta', { type: 'content_block_delta', index: 0, delta: { type: 'text_delta', text: ev.textDelta } }));
+    }
+  }
+
+  res.write(sse('content_block_stop', { type: 'content_block_stop', index: 0 }));
+  res.write(sse('message_delta', { type: 'message_delta', delta: { stop_reason: 'end_turn', stop_sequence: null }, usage: { output_tokens: outputTokens } }));
+  res.write(sse('message_stop', { type: 'message_stop' }));
+  res.end();
+}
+
+http.createServer(async (req, res) => {
+  state.requests++;
+  state.active++;
+  try {
+    if (req.method === 'GET' && req.url === '/debug/server') {
+      res.writeHead(200, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify(state));
+      return;
+    }
+    if (req.method === 'POST' && req.url === '/v1/messages') {
+      await handleMessages(req, res);
+      return;
+    }
+    res.writeHead(404);
+    res.end(JSON.stringify({ error: 'not found' }));
+  } catch (err) {
+    state.errors++;
+    res.writeHead(500);
+    res.end(JSON.stringify({ error: err.message }));
+  } finally {
+    state.active--;
+  }
+}).listen(PORT, () => process.stderr.write(`thebird proxy listening on ${PORT}\n`));