thebird 1.2.33 → 1.2.35

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [Unreleased - agent-tools]
+
+### Added
+- `docs/agent-chat.js`: 3 new tools — `list_files` (IDB snapshot keys), `read_terminal` (xterm buffer snapshot, last N lines), `send_to_terminal` (write to jsh stdin via shellWriter); `read_file` falls back to IDB snapshot when container not ready; `write_file` writes to both container and IDB snapshot; `window.__debug.agent.lastTool` tracks last dispatched tool
+- `docs/terminal.js`: exposes `window.__debug.shellWriter` (jsh stdin writer), `window.__debug.idbSnapshot` (live file map), `window.__debug.idbPersist` (persist snapshot to IndexedDB)
+
 ## [Unreleased - browser-sdk]
 
 ### Added

package/CLAUDE.md

@@ -130,6 +130,9 @@ Run examples against real Gemini API to validate message translation.
 - Some models have different tool naming conventions — check provider docs
 - Streaming response parsing varies by provider — see lib/providers/ for details
 - OAuth tokens expire — gembird uses browser session instead of capturing tokens
+- Cannot bundle index.js directly for browser — it imports Node-only modules (oauth.js, config.js, cloud-generate.js) at top level. Create a separate browser entry that imports only lib/client.js, lib/errors.js, lib/convert.js. Use ESM wrapper (not CJS module.exports) to preserve named exports in bundle.
+- Tool parameter types must be lowercase for Gemini API — `object`, `string`, `number` not `OBJECT`, `STRING`, `NUMBER`. Uppercase types fail schema validation.
+- agentGenerate passes raw Anthropic-format messages to streamGemini internally, which calls convertMessages. Do NOT pre-convert in app.js — double-conversion breaks tool schemas.
 
 ## Files
 

package/docs/agent-chat.js

@@ -1,13 +1,27 @@
 import { streamGemini } from './vendor/thebird-browser.js';
 
+function idbRead(path) {
+  const snap = window.__debug.idbSnapshot;
+  if (!snap) throw new Error('idb snapshot not ready');
+  if (!(path in snap)) throw new Error('not found in snapshot: ' + path);
+  return snap[path];
+}
+
+function idbWrite(path, content) {
+  const snap = window.__debug.idbSnapshot;
+  if (!snap) throw new Error('idb snapshot not ready');
+  snap[path] = content;
+  window.__debug.idbPersist?.();
+}
+
 const TOOLS = {
   read_file: {
     description: 'Read a file from the filesystem',
     parameters: { type: 'object', properties: { path: { type: 'string' } }, required: ['path'] },
     execute: async ({ path }) => {
       const c = window.__debug.container;
-      if (!c) throw new Error('container not ready');
-      return await c.fs.readFile(path, 'utf-8');
+      if (c) return await c.fs.readFile(path, 'utf-8');
+      return idbRead(path);
     },
   },
   write_file: {
@@ -15,13 +29,22 @@ const TOOLS = {
     parameters: { type: 'object', properties: { path: { type: 'string' }, content: { type: 'string' } }, required: ['path', 'content'] },
     execute: async ({ path, content }) => {
       const c = window.__debug.container;
-      if (!c) throw new Error('container not ready');
-      await c.fs.writeFile(path, content);
+      if (c) await c.fs.writeFile(path, content);
+      idbWrite(path, content);
       return 'written: ' + path;
     },
   },
+  list_files: {
+    description: 'List files available in the filesystem',
+    parameters: { type: 'object', properties: { prefix: { type: 'string' } }, required: [] },
+    execute: async ({ prefix }) => {
+      const snap = window.__debug.idbSnapshot || {};
+      const keys = Object.keys(snap).sort();
+      return (prefix ? keys.filter(k => k.startsWith(prefix)) : keys).join('\n') || '(empty)';
+    },
+  },
   run_command: {
-    description: 'Run a shell command',
+    description: 'Run a shell command in the WebContainer',
     parameters: { type: 'object', properties: { command: { type: 'string' }, cwd: { type: 'string' } }, required: ['command'] },
     execute: async ({ command, cwd }) => {
       const c = window.__debug.container;
@@ -33,17 +56,46 @@ const TOOLS = {
       return out || '(no output)';
     },
   },
+  read_terminal: {
+    description: 'Read the current terminal display (last N lines)',
+    parameters: { type: 'object', properties: { lines: { type: 'number' } }, required: [] },
+    execute: async ({ lines = 50 }) => {
+      const term = window.__debug.term;
+      if (!term) throw new Error('terminal not ready');
+      const buf = term.buffer.active;
+      const end = buf.length;
+      const start = Math.max(0, end - lines);
+      const out = [];
+      for (let y = start; y < end; y++) {
+        const line = buf.getLine(y);
+        if (line) out.push(line.translateToString(true));
+      }
+      return out.join('\n').trimEnd() || '(empty)';
+    },
+  },
+  send_to_terminal: {
+    description: 'Send input to the terminal shell (use \\n for newline/Enter)',
+    parameters: { type: 'object', properties: { input: { type: 'string' } }, required: ['input'] },
+    execute: async ({ input }) => {
+      const w = window.__debug.shellWriter;
+      if (!w) throw new Error('shell not ready');
+      await w.write(input);
+      return 'sent: ' + JSON.stringify(input);
+    },
+  },
 };
 
 export async function agentGenerate(apiKey, model, messages, onChunk, onTool) {
   Object.assign(window.__debug = window.__debug || {}, {
-    agent: { model, active: true },
+    agent: { model, active: true, lastTool: null },
   });
   try {
     for await (const ev of streamGemini({ model, messages, tools: TOOLS, apiKey, maxOutputTokens: 8192 }).fullStream) {
       if (ev.type === 'text-delta') onChunk(ev.textDelta);
-      else if (ev.type === 'tool-call') onTool(ev.toolName, ev.args);
-      else if (ev.type === 'error') throw ev.error;
+      else if (ev.type === 'tool-call') {
+        window.__debug.agent.lastTool = { name: ev.toolName, args: ev.args };
+        onTool(ev.toolName, ev.args);
+      } else if (ev.type === 'error') throw ev.error;
     }
   } finally {
     window.__debug.agent.active = false;

package/docs/terminal.js

@@ -114,6 +114,9 @@ async function boot() {
   window.__debug.term = term;
   window.__debug.previewUrl = null;
   window.__debug.shell = shell;
+  window.__debug.shellWriter = writer;
+  window.__debug.idbSnapshot = files;
+  window.__debug.idbPersist = () => idbSave(JSON.stringify(window.__debug.idbSnapshot));
   window.__debug.srv = srv;
   window.__debug.validation = null;
   window.__debug.runAgent = async (key, task) => {

package/package.json

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