thebird 1.2.6 → 1.2.8

package/.github/workflows/pages.yml

@@ -0,0 +1,31 @@
+name: Deploy GitHub Pages
+
+on:
+  push:
+    branches: [main]
+    paths: [docs/**]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deploy.outputs.page_url }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/configure-pages@v4
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs
+      - id: deploy
+        uses: actions/deploy-pages@v4

package/docs/app.js

@@ -0,0 +1,162 @@
+import { createElement, applyDiff } from 'webjsx';
+
+const MODELS = [
+  'gemini-2.0-flash',
+  'gemini-2.0-flash-thinking-exp',
+  'gemini-1.5-pro',
+  'gemini-1.5-flash',
+];
+
+function convertMessages(messages) {
+  const contents = [];
+  for (const m of messages) {
+    const role = m.role === 'assistant' ? 'model' : 'user';
+    if (typeof m.content === 'string') {
+      if (m.content) contents.push({ role, parts: [{ text: m.content }] });
+      continue;
+    }
+    if (Array.isArray(m.content)) {
+      const parts = m.content.map(b => {
+        if (b.type === 'text' && b.text) return { text: b.text };
+        if (b.type === 'tool_use') return { functionCall: { name: b.name, args: b.input || {} } };
+        if (b.type === 'tool_result') {
+          let resp;
+          try { resp = typeof b.content === 'string' ? JSON.parse(b.content) : (b.content || {}); }
+          catch { resp = { result: b.content }; }
+          return { functionResponse: { name: b.name || 'unknown', response: resp } };
+        }
+        return null;
+      }).filter(Boolean);
+      if (parts.length) contents.push({ role, parts });
+    }
+  }
+  return contents;
+}
+
+function buildConfig({ system, temperature } = {}) {
+  const config = { maxOutputTokens: 8192, temperature: temperature ?? 0.7 };
+  if (system) config.systemInstruction = system;
+  return config;
+}
+
+class BirdChat extends HTMLElement {
+  constructor() {
+    super();
+    this.state = {
+      messages: [],
+      streaming: false,
+      model: MODELS[0],
+      apiKey: localStorage.getItem('gemini_api_key') || '',
+      status: '',
+      streamingText: '',
+    };
+    window.__debug = { get state() { return this.state; }.bind(this), get messages() { return this.state.messages; }.bind(this) };
+  }
+
+  connectedCallback() { this.render(); }
+
+  setState(patch) { Object.assign(this.state, patch); this.render(); }
+
+  render() {
+    const { messages, streaming, model, apiKey, status, streamingText } = this.state;
+    applyDiff(this, (
+      <div class="flex flex-col h-full">
+        <header class="navbar bg-base-200 border-b border-base-300 gap-2 flex-wrap px-4 py-2">
+          <span class="text-primary font-bold text-lg mr-2">🐦 thebird</span>
+          <span class="text-base-content/50 text-xs hidden sm:inline">Anthropic SDK format → Gemini API</span>
+          <div class="flex gap-2 flex-1 min-w-0 items-center flex-wrap">
+            <input
+              id="api-key-input"
+              type="password"
+              class="input input-sm input-bordered flex-1 min-w-[160px]"
+              placeholder="GEMINI_API_KEY"
+              value={apiKey}
+              onchange={e => { const v = e.target.value.trim(); localStorage.setItem('gemini_api_key', v); this.setState({ apiKey: v }); }}
+            />
+            <select
+              class="select select-sm select-bordered"
+              value={model}
+              onchange={e => this.setState({ model: e.target.value })}
+            >
+              {MODELS.map(m => <option value={m} selected={m === model}>{m}</option>)}
+            </select>
+            <button class="btn btn-sm btn-ghost" onclick={() => this.setState({ messages: [], status: '' })}>Clear</button>
+          </div>
+        </header>
+
+        <div id="msg-list" class="flex-1 overflow-y-auto flex flex-col gap-3 p-4">
+          {messages.map((m, i) => (
+            <div key={i} class={`flex ${m.role === 'user' ? 'justify-end' : 'justify-start'}`}>
+              <div class={`msg-bubble card px-4 py-3 text-sm leading-relaxed ${m.role === 'user' ? 'bg-primary text-primary-content' : 'bg-base-200 text-base-content'}`}>
+                {m.content}
+              </div>
+            </div>
+          ))}
+          {streamingText && (
+            <div class="flex justify-start">
+              <div class="msg-bubble card bg-base-200 text-base-content px-4 py-3 text-sm leading-relaxed">{streamingText}<span class="animate-pulse ml-1">▋</span></div>
+            </div>
+          )}
+          {!streamingText && streaming && (
+            <div class="flex justify-start">
+              <div class="card bg-base-200 px-4 py-3"><span class="loading loading-dots loading-sm"></span></div>
+            </div>
+          )}
+        </div>
+
+        {status && <div class="text-xs text-error px-4 pb-1">{status}</div>}
+
+        <form class="flex gap-2 p-3 border-t border-base-300 bg-base-200" onsubmit={e => { e.preventDefault(); this.send(); }}>
+          <textarea
+            id="chat-input"
+            class="textarea textarea-bordered flex-1 resize-none min-h-[42px] max-h-[120px] text-sm"
+            placeholder="Message… (Shift+Enter for newline)"
+            rows="1"
+            disabled={streaming}
+            onkeydown={e => { if (e.key === 'Enter' && !e.shiftKey) { e.preventDefault(); this.send(); } }}
+            oninput={e => { e.target.style.height = 'auto'; e.target.style.height = Math.min(e.target.scrollHeight, 120) + 'px'; }}
+          ></textarea>
+          <button type="submit" class="btn btn-primary self-end" disabled={streaming}>
+            {streaming ? <span class="loading loading-spinner loading-sm"></span> : 'Send'}
+          </button>
+        </form>
+      </div>
+    ));
+  }
+
+  async send() {
+    const input = this.querySelector('#chat-input');
+    const text = input?.value.trim();
+    if (!text || this.state.streaming) return;
+    const { apiKey, model } = this.state;
+    if (!apiKey) { this.setState({ status: 'Enter a Gemini API key above.' }); return; }
+    input.value = '';
+    input.style.height = 'auto';
+    const messages = [...this.state.messages, { role: 'user', content: text }];
+    this.setState({ messages, streaming: true, status: '', streamingText: '' });
+    try {
+      const { GoogleGenAI } = await import('https://esm.sh/@google/genai@1');
+      const ai = new GoogleGenAI({ apiKey });
+      const stream = await ai.models.generateContentStream({
+        model,
+        contents: convertMessages(messages),
+        config: buildConfig(),
+      });
+      let full = '';
+      for await (const chunk of stream) {
+        for (const candidate of (chunk.candidates || [])) {
+          for (const part of (candidate.content?.parts || [])) {
+            if (part.text && !part.thought) { full += part.text; this.setState({ streamingText: full }); }
+          }
+        }
+      }
+      const list = document.getElementById('msg-list');
+      if (list) list.scrollTop = list.scrollHeight;
+      this.setState({ messages: [...messages, { role: 'assistant', content: full || '(empty)' }], streaming: false, streamingText: '' });
+    } catch (err) {
+      this.setState({ streaming: false, streamingText: '', status: 'Error: ' + (err?.message || String(err)) });
+    }
+  }
+}
+
+customElements.define('bird-chat', BirdChat);

package/docs/index.html

@@ -0,0 +1,22 @@
+<!DOCTYPE html>
+<html lang="en" data-theme="dark">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>thebird — Gemini chat</title>
+<script src="https://cdn.tailwindcss.com"></script>
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/rippleui@1.12.1/dist/css/styles.css" />
+<script type="importmap">{"imports":{"webjsx":"https://unpkg.com/webjsx/dist/index.js"}}</script>
+<style>
+  :root { --bg: #0f1117; }
+  html, body { height: 100%; background: var(--bg); }
+  bird-chat { display: flex; flex-direction: column; height: 100dvh; }
+  .msg-bubble { max-width: 680px; white-space: pre-wrap; word-break: break-word; }
+  #msg-list { scroll-behavior: smooth; }
+</style>
+</head>
+<body class="bg-base-100 text-base-content">
+<bird-chat></bird-chat>
+<script type="module" src="app.js"></script>
+</body>
+</html>

package/package.json

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

package/wasi/component.js

@@ -0,0 +1,70 @@
+import { GoogleGenAI } from '@google/genai';
+
+function cleanSchema(s) {
+  if (!s || typeof s !== 'object') return s;
+  if (Array.isArray(s)) return s.map(cleanSchema);
+  const out = {};
+  for (const [k, v] of Object.entries(s)) {
+    if (k === 'additionalProperties' || k === '$schema') continue;
+    out[k] = cleanSchema(v);
+  }
+  return out;
+}
+
+function partToGemini(b) {
+  if (b.kind === 'text' && b.text) return { text: b.text };
+  if (b.kind === 'tool_use') return { functionCall: { name: b.toolName || '', args: b.toolInput ? JSON.parse(b.toolInput) : {} } };
+  if (b.kind === 'tool_result') {
+    let resp;
+    try { resp = JSON.parse(b.text || '{}'); } catch { resp = { result: b.text }; }
+    return { functionResponse: { name: b.toolName || 'unknown', response: resp } };
+  }
+  return null;
+}
+
+function convertMessages(messages) {
+  const contents = [];
+  for (const m of messages) {
+    const role = m.role === 'assistant' ? 'model' : 'user';
+    const parts = m.content.map(partToGemini).filter(Boolean);
+    if (parts.length) contents.push({ role, parts });
+  }
+  return contents;
+}
+
+function buildConfig({ system, temperature, maxOutputTokens } = {}) {
+  const config = {
+    maxOutputTokens: maxOutputTokens ?? 8192,
+    temperature: temperature ?? 0.7,
+  };
+  if (system) config.systemInstruction = system;
+  return config;
+}
+
+export async function generate(messages, config) {
+  const { apiKey, model, system, temperature, maxOutputTokens } = config;
+  if (!apiKey) return { text: '', error: 'apiKey required' };
+  try {
+    const ai = new GoogleGenAI({ apiKey });
+    const contents = convertMessages(messages);
+    const geminiConfig = buildConfig({ system, temperature, maxOutputTokens });
+    const response = await ai.models.generateContent({
+      model: model || 'gemini-2.0-flash',
+      contents,
+      config: geminiConfig,
+    });
+    const candidate = response.candidates?.[0];
+    if (!candidate) return { text: '', error: 'no candidates returned' };
+    const text = (candidate.content?.parts || [])
+      .filter(p => p.text && !p.thought)
+      .map(p => p.text)
+      .join('');
+    return { text, error: null };
+  } catch (err) {
+    return { text: '', error: err?.message || String(err) };
+  }
+}
+
+export function convertMessagesExport(messages) {
+  return JSON.stringify(convertMessages(messages));
+}

package/wasi/demo.js

@@ -0,0 +1,23 @@
+import { generate } from './dist/js/component.js';
+
+const apiKey = process.env.GEMINI_API_KEY;
+if (!apiKey) throw new Error('GEMINI_API_KEY env var required');
+
+const messages = [
+  {
+    role: 'user',
+    content: [{ kind: 'text', text: 'Say hello in exactly 5 words.' }],
+  },
+];
+
+const config = {
+  model: 'gemini-2.0-flash',
+  apiKey,
+  system: null,
+  temperature: 0.7,
+  maxOutputTokens: 256,
+};
+
+const result = await generate(messages, config);
+if (result.error) throw new Error('generate failed: ' + result.error);
+console.log(result.text);

package/wasi/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "thebird-wasi",
+  "version": "0.1.0",
+  "description": "WASI component wrapper for thebird — runs thebird in any WASI runtime or Node.js via jco transpile",
+  "type": "module",
+  "scripts": {
+    "build": "jco componentize component.js --wit wit/world.wit --world-name thebird --out dist/component.wasm",
+    "transpile": "jco transpile dist/component.wasm --out-dir dist/js",
+    "run": "jco run dist/component.wasm",
+    "demo": "node demo.js"
+  },
+  "devDependencies": {
+    "@bytecodealliance/jco": "^1.0.0"
+  },
+  "dependencies": {
+    "@google/genai": "^1.0.0"
+  }
+}

package/wasi/wit/world.wit

@@ -0,0 +1,45 @@
+package thebird:core@0.1.0;
+
+interface types {
+  record content-part {
+    kind: string,
+    text: option<string>,
+    tool-name: option<string>,
+    tool-input: option<string>,
+    tool-id: option<string>,
+  }
+
+  record message {
+    role: string,
+    content: list<content-part>,
+  }
+
+  record generate-config {
+    model: string,
+    api-key: string,
+    system: option<string>,
+    temperature: option<f32>,
+    max-output-tokens: option<u32>,
+  }
+
+  record generate-result {
+    text: string,
+    error: option<string>,
+  }
+
+  record stream-chunk {
+    chunk-type: string,
+    text-delta: option<string>,
+    tool-call-id: option<string>,
+    tool-name: option<string>,
+    finish-reason: option<string>,
+    error: option<string>,
+  }
+}
+
+world thebird {
+  use types.{message, generate-config, generate-result, stream-chunk};
+
+  export generate: func(messages: list<message>, config: generate-config) -> generate-result;
+  export convert-messages: func(messages: list<message>) -> string;
+}