thebird 1.2.24 → 1.2.26

package/CHANGELOG.md

@@ -2,6 +2,9 @@
 
 ## [Unreleased]
 
+### Fixed
+- `docs/terminal.js`: build nested WebContainer mount tree from flat path keys (fixes `EIO: invalid file name` for files in subdirectories like `lib/providers/openai.js`); bump IDB_KEY to `thebird_fs_v2` to force re-fetch of defaults.json for users with stale cache
+
 ### Added
 - `docs/defaults.json`: JSON blob of all thebird lib files + `server.js` + `agent.js` fetched by terminal.js on first boot
 - `docs/terminal.js`: fetches `defaults.json` instead of hardcoded DEFAULT_FILES; jsh PTY shell with resize; `server-ready` wires iframe src + `window.__debug.previewUrl`; all debug keys registered

package/CLAUDE.md

@@ -122,8 +122,21 @@ Run examples against real Gemini API to validate message translation.
 - `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)
 
+## WebContainer Terminal in docs/
+
+Interactive terminal in docs/index.html runs thebird + Node.js server in WebContainer API.
+
+### Architecture
+
+- **defaults.json**: docs/defaults.json is a 46KB single-line JSON blob containing all container files (package.json, lib/*.js, index.js, server.js, agent.js). Fetched by terminal.js on first boot instead of hardcoding DEFAULT_FILES inline (avoids 200-line limit).
+- **Flat mount object**: WebContainer accepts `{'lib/client.js': ...}` directly — no nested directory tree needed.
+- **COEP window.coi fix**: Add `<script>window.coi = { coepDegrade: () => false };</script>` BEFORE coi-serviceworker.js. Prevents degradation from credentialless to require-corp, which blocks Tailwind CDN. Key is `window.coi` (not `window.__coi_serviceworker`).
+- **iframe allow attribute**: Remove `allow="cross-origin-isolated"` — not a valid Feature Policy keyword. WebContainer iframes work without it.
+- **agent.js routing**: Inside container, agent.js uses `@anthropic-ai/sdk` with `baseURL: "http://localhost:3000"` pointing at thebird proxy (server.js), which translates Anthropic format → Gemini.
+
 ## 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
+- CI workflow commits version bump after every push to main — always `git pull --rebase origin main` before pushing to avoid fast-forward rejection

package/README.md

@@ -156,21 +156,6 @@ Pass options as a nested array: `["maxtoken", { "max_tokens": 16384 }]`.
 
 `streamGemini` / `generateGemini` bypass routing and call Gemini natively via `@google/genai`. Requires `GEMINI_API_KEY`.
 
-### Params
-
-| Param | Type | Default | Description |
-|---|---|---|---|
-| `model` | `string \| { id }` | `'gemini-2.0-flash'` | Model id |
-| `messages` | `Message[]` | required | Conversation history |
-| `system` | `string` | — | System instruction |
-| `tools` | `Tools` | — | Tool definitions |
-| `apiKey` | `string` | `GEMINI_API_KEY` | Override API key |
-| `temperature` | `number` | `0.5` | Sampling temperature |
-| `maxOutputTokens` | `number` | `8192` | Max tokens |
-| `topP` | `number` | `0.95` | Top-p |
-| `topK` | `number` | — | Top-k |
-| `safetySettings` | `SafetySetting[]` | — | Safety thresholds |
-
 ## Message Format
 
 Messages follow the Anthropic SDK format. All image block variants are supported:
@@ -193,18 +178,22 @@ Messages follow the Anthropic SDK format. All image block variants are supported
 | `finish-step` | `finishReason` | Step completed |
 | `error` | `error` | Error during step |
 
-## TypeScript
+## Browser Demo
 
-```ts
-import { createRouter, streamRouter, generateGemini, RouterConfiguration, ProviderConfig, RouterConfig } from 'thebird';
-```
+Live at **[anentrypoint.github.io/thebird](https://anentrypoint.github.io/thebird/)**
 
-## Utilities
+- **Chat tab** — Gemini chat via direct API (Gemini API key stored in localStorage)
+- **Terminal tab** — WebContainer (in-browser Node.js) booting thebird's full stack: `npm install`, `node server.js` (Anthropic→Gemini proxy on port 3000), then a `jsh` shell
+- **Preview tab** — iframe pointed at the WebContainer's HTTP server, live-updated when the server starts
 
-```js
-const { convertMessages, convertTools, cleanSchema } = require('thebird');
+Run the agentic CLI inside the terminal tab:
+
+```
+GEMINI_API_KEY=<key> node agent.js "your task"
 ```
 
+`agent.js` uses `@anthropic-ai/sdk` pointing at `http://localhost:3000` (thebird proxy) with tools: `read_file`, `write_file`, `run_command`.
+
 ## License
 
 MIT

package/docs/terminal.js

@@ -2,7 +2,7 @@ import { WebContainer } from 'https://esm.sh/@webcontainer/api';
 import { Terminal } from 'https://esm.sh/@xterm/xterm';
 import { FitAddon } from 'https://esm.sh/@xterm/addon-fit';
 
-const IDB_KEY = 'thebird_fs';
+const IDB_KEY = 'thebird_fs_v2';
 
 async function idbLoad() {
   return new Promise((res, rej) => {
@@ -59,13 +59,17 @@ async function boot() {
     files = await r.json();
   }
 
-  const mountTree = Object.fromEntries(
-    Object.entries(files).map(([p, c]) => {
-      const parts = p.split('/');
-      if (parts.length === 1) return [p, { file: { contents: c } }];
-      return [p, { file: { contents: c } }];
-    })
-  );
+  const mountTree = {};
+  for (const [path, contents] of Object.entries(files)) {
+    const parts = path.split('/');
+    const name = parts.pop();
+    let node = mountTree;
+    for (const dir of parts) {
+      if (!node[dir]) node[dir] = { directory: {} };
+      node = node[dir].directory;
+    }
+    node[name] = { file: { contents } };
+  }
 
   term.write('Booting WebContainer...\r\n');
   let container;

package/package.json

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