thebird 1.2.112 → 1.2.114

package/AGENTS.md

@@ -0,0 +1,21 @@
+## thebird Virtual Filesystem Architecture
+
+### defaults.json as idbSnapshot Seed
+
+`defaults.json` is a 46KB single-line JSON blob that seeds `window.__debug.idbSnapshot` — the virtual filesystem visible inside thebird's web-based shell. This is NOT the source for running JavaScript modules. Actual modules (app.js, terminal.js, shell.js, vendor bundles, etc.) load from `docs/*.js` over HTTP via the web server.
+
+The virtual FS uses a flat mount object: `{'lib/client.js': {...}, 'sys/node-builtins.js': {...}}` directly, no nested directory tree. WebContainer mounts this structure at shell startup.
+
+### System vs User Namespace
+
+- **System internals** (85+ files): app.js, terminal.js, shell.js, lib/*, vendor/*, node-builtins.js, builtins, etc. → prefix with `sys/`
+- **User-facing project**: README.md, index.html, style.css, package.json → prefix with `home/`
+- **Shell context**: `ctx.cwd` defaults to `/home` (set in shell.js:27)
+
+This convention separates implementation from user project namespace. When adding new system features visible in the virtual FS, use `sys/` prefix. Starter content for users goes under `home/`.
+
+### Agent Tool Filtering & Preview Behavior
+
+- **agent-chat.js `list_files` tool**: defaults to `prefix='home/'` to show only user project files. Agents can explicitly request `prefix:'sys/'` to access system internals, but the default privacy-filters system away from user view.
+- **Preview pane** (`docs/index.html` `refreshPreview`): prefers `home/index.html` over root `index.html`, ignores all `sys/*.html` files. UX isolation of system from user-visible preview.
+

package/docs/index.html

@@ -31,6 +31,7 @@
   font-family: var(--ff-mono);
   font-size: 13px;
   line-height: 1.5;
+  height: 100dvh;
   min-height: 100vh;
   display: flex;
   flex-direction: column;
@@ -121,12 +122,24 @@
 @keyframes pulse { 0%,100%{opacity:1} 50%{opacity:0.4} }
 
 /* ── page panels ── */
-.page-panel { display: none; flex: 1; flex-direction: column; }
+.page-panel { display: none; flex: 1 1 auto; flex-direction: column; min-height: 0; }
 .page-panel.active { display: flex; }
 
 /* ── overview page ── */
 #page-overview { overflow-y: auto; }
 
+/* ── live app sizing — flex-fill all the way down ── */
+#page-app .app-embed { flex: 1 1 auto; min-height: 0; }
+#page-app .tui-tabs { flex: 0 0 auto; }
+#page-app #pane-chat,
+#page-app #pane-term,
+#page-app #pane-preview { flex: 1 1 auto; min-height: 0; }
+bird-chat { display: flex; flex: 1 1 auto; flex-direction: column; min-height: 0; height: 100%; }
+#term-container { width: 100%; height: 100%; min-height: 0; }
+#term-container .xterm,
+#term-container .xterm-viewport,
+#term-container .xterm-screen { width: 100% !important; height: 100% !important; }
+
 /* ── hero ── */
 .hero {
   padding: 64px 2ch 48px 2ch;
@@ -677,17 +690,9 @@ function switchPage(p) {
     document.getElementById('page-' + id).classList.toggle('active', id === p);
     document.getElementById('ptab-' + id).classList.toggle('active', id === p);
   });
-  if (p === 'app') {
-    document.getElementById('page-app').style.height = (window.innerHeight - 40) + 'px';
-  }
+  if (p === 'app') requestAnimationFrame(() => window.dispatchEvent(new Event('resize')));
 }
 
-window.addEventListener('resize', () => {
-  if (document.getElementById('page-app').classList.contains('active')) {
-    document.getElementById('page-app').style.height = (window.innerHeight - 40) + 'px';
-  }
-});
-
 function copyInstall() {
   navigator.clipboard?.writeText('npm install acptoapi');
   const btn = document.querySelector('#install-strip .copy-btn');
@@ -756,6 +761,7 @@ function switchTab(t) {
     tab.classList.toggle('active', id === t);
   });
   if (t === 'preview') refreshPreview();
+  if (t === 'term') requestAnimationFrame(() => window.dispatchEvent(new Event('resize')));
 }
 window.showPreview = () => switchTab('preview');
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thebird",
-  "version": "1.2.112",
+  "version": "1.2.114",
   "description": "Anthropic SDK to Gemini streaming bridge — drop-in proxy that translates Anthropic message format and tool calls to Google Gemini",
   "scripts": {
     "start": "node serve.js"