thebird 1.2.1 → 1.2.3

package/README.md

@@ -2,24 +2,58 @@
 
 Anthropic SDK to multi-provider bridge. Drop-in adapter that translates Anthropic-style messages, tool calls, and content blocks to Google Gemini or any OpenAI-compatible API — with routing, transformers, streaming, vision, retry logic, and full TypeScript types.
 
+## How It Works
+
+thebird accepts **Anthropic SDK message format** — the same `{ role, content }` structure you use with `@anthropic-ai/sdk` — and translates it to Gemini or any OpenAI-compatible API. No proxy server needed. You write Anthropic-format messages, thebird streams them through Gemini.
+
+```
+Anthropic SDK format  →  thebird  →  Gemini / OpenAI-compatible API
+     (messages)         (bridge)         (native streaming)
+```
+
+This means you can use `@anthropic-ai/sdk` to build your messages and tool definitions, then pass them directly to thebird for execution against Gemini models.
+
 ## Install
 
 ```bash
-npm install thebird
+npm install thebird @anthropic-ai/sdk
 ```
 
 ## Quick Start
 
-**Gemini (direct)**
+**Anthropic SDK format → Gemini (streaming)**
+
+```js
+const Anthropic = require('@anthropic-ai/sdk');
+const { streamGemini } = require('thebird');
+
+// Build messages using Anthropic SDK format — same structure as client.messages.create()
+const messages = [
+  { role: 'user', content: 'Count from 1 to 5.' }
+];
+
+// Stream through Gemini — no server, no proxy
+const { fullStream } = streamGemini({
+  model: 'gemini-3-flash-preview',
+  system: 'You are a helpful assistant.',
+  messages
+});
+
+for await (const event of fullStream) {
+  if (event.type === 'text-delta') process.stdout.write(event.textDelta);
+}
+```
+
+**Anthropic SDK format → Gemini (non-streaming)**
 
 ```js
-const { generateGemini, streamGemini } = require('thebird');
-// requires GEMINI_API_KEY env var
+const { generateGemini } = require('thebird');
 
 const { text } = await generateGemini({
-  model: 'gemini-2.0-flash',
+  model: 'gemini-3-flash-preview',
   messages: [{ role: 'user', content: 'Hello!' }]
 });
+console.log(text);
 ```
 
 **Multi-provider router**

package/index.js

@@ -7,18 +7,18 @@ const { resolveTransformers, applyRequestTransformers } = require('./lib/transfo
 const openaiProv = require('./lib/providers/openai');
 
 function streamGemini({ model, system, messages, tools, onStepFinish, apiKey,
-  temperature, maxOutputTokens, topP, topK, safetySettings }) {
+  temperature, maxOutputTokens, topP, topK, safetySettings, responseModalities }) {
   return {
-    fullStream: createFullStream({ model, system, messages, tools, onStepFinish, apiKey, temperature, maxOutputTokens, topP, topK, safetySettings }),
+    fullStream: createFullStream({ model, system, messages, tools, onStepFinish, apiKey, temperature, maxOutputTokens, topP, topK, safetySettings, responseModalities }),
     warnings: Promise.resolve([])
   };
 }
 
-async function* createFullStream({ model, system, messages, tools, onStepFinish, apiKey, temperature, maxOutputTokens, topP, topK, safetySettings }) {
+async function* createFullStream({ model, system, messages, tools, onStepFinish, apiKey, temperature, maxOutputTokens, topP, topK, safetySettings, responseModalities }) {
   const client = getClient(apiKey);
   const modelId = extractModelId(model);
   let contents = convertMessages(messages);
-  const { config } = buildConfig({ system, tools, temperature, maxOutputTokens, topP, topK, safetySettings });
+  const { config } = buildConfig({ system, tools, temperature, maxOutputTokens, topP, topK, safetySettings, responseModalities });
   while (true) {
     yield { type: 'start-step' };
     try {
@@ -66,11 +66,11 @@ async function* createFullStream({ model, system, messages, tools, onStepFinish,
   }
 }
 
-async function generateGemini({ model, system, messages, tools, apiKey, temperature, maxOutputTokens, topP, topK, safetySettings }) {
+async function generateGemini({ model, system, messages, tools, apiKey, temperature, maxOutputTokens, topP, topK, safetySettings, responseModalities }) {
   const client = getClient(apiKey);
   const modelId = extractModelId(model);
   let contents = convertMessages(messages);
-  const { config } = buildConfig({ system, tools, temperature, maxOutputTokens, topP, topK, safetySettings });
+  const { config } = buildConfig({ system, tools, temperature, maxOutputTokens, topP, topK, safetySettings, responseModalities });
   while (true) {
     const response = await withRetry(() => client.models.generateContent({ model: modelId, contents, config }));
     const candidate = response.candidates?.[0];

package/lib/convert.js

@@ -69,7 +69,7 @@ function extractModelId(model) {
   return 'gemini-2.0-flash';
 }
 
-function buildConfig({ system, tools, temperature, maxOutputTokens, topP, topK, safetySettings } = {}) {
+function buildConfig({ system, tools, temperature, maxOutputTokens, topP, topK, safetySettings, responseModalities } = {}) {
   const geminiTools = convertTools(tools);
   const config = {
     maxOutputTokens: maxOutputTokens ?? 8192,
@@ -80,6 +80,7 @@ function buildConfig({ system, tools, temperature, maxOutputTokens, topP, topK,
   if (system) config.systemInstruction = system;
   if (geminiTools.length > 0) config.tools = [{ functionDeclarations: geminiTools }];
   if (safetySettings) config.safetySettings = safetySettings;
+  if (responseModalities) config.responseModalities = responseModalities;
   return { config, geminiTools };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thebird",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "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",