npm - agent-office-studio - Versions diffs - 0.8.0 → 0.9.2 - Mend

agent-office-studio 0.8.0 → 0.9.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (31) hide show

package/CHANGELOG.md +61 -0
package/README.md +12 -0
package/dist/assets/code-Dtdckl8K.js +32 -0
package/dist/assets/index-BcqWv4NW.css +1 -0
package/dist/assets/index-qdaAZdZT.js +5065 -0
package/dist/assets/pdf-BtCWNl9F.js +55 -0
package/dist/assets/pdf-CKZBNrtF.js +1 -0
package/dist/assets/pdf.worker.min-BJd0dv5W.js +53 -0
package/dist/assets/pdf.worker.min-D_0FwaWY.js +1 -0
package/dist/index.html +39 -35
package/dist/theme-boot.js +13 -0
package/docs/desktop.md +52 -0
package/docs/features.md +96 -0
package/package.json +19 -2
package/server/apps.js +146 -0
package/server/changes.js +13 -2
package/server/chief.js +20 -1
package/server/economy.js +26 -3
package/server/files.js +115 -0
package/server/guests.js +59 -21
package/server/index.js +897 -72
package/server/links.js +11 -4
package/server/machine.js +164 -0
package/server/office-mcp.js +26 -1
package/server/procstat.js +12 -6
package/server/settings.js +2 -0
package/server/telegram.js +320 -0
package/server/visits.js +14 -4
package/shared/shop.js +11 -4
package/dist/assets/index-BAvX7Imu.css +0 -1
package/dist/assets/index-C01GpSoa.js +0 -4999

package/dist/assets/pdf.worker.min-D_0FwaWY.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ function r(e){return new Worker("/assets/pdf.worker.min-BJd0dv5W.js",{name:e==null?void 0:e.name})}export{r as default};

package/dist/index.html CHANGED Viewed

@@ -11,27 +11,14 @@
     <link rel="manifest" href="/manifest.webmanifest" />
     <link rel="icon" href="/icon.svg" type="image/svg+xml" />
     <link rel="apple-touch-icon" href="/apple-touch-icon.png" />
-    <script>
-      // Before first paint, so a saved theme never flashes the default. theme.js owns it after that.
-      (function () {
-        try {
-          var t = localStorage.getItem('office.theme') || 'paper';
-          var m = localStorage.getItem('office.mode') || 'auto';
-          var d = m === 'dark' || (m === 'auto' && matchMedia('(prefers-color-scheme: dark)').matches);
-          var r = document.documentElement;
-          r.dataset.theme = t;
-          r.dataset.mode = d ? 'dark' : 'light';
-        } catch (e) {}
-      })();
-    </script>
+    <script src="/theme-boot.js"></script>
     <title>Office</title>
-    <script type="module" crossorigin src="/assets/index-C01GpSoa.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-BAvX7Imu.css">
+    <script type="module" crossorigin src="/assets/index-qdaAZdZT.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-BcqWv4NW.css">
   </head>
   <body>
     <div class="app" id="app" data-m="office">
       <aside class="side">
-        <div class="side-grip" id="side-grip" role="separator" aria-orientation="vertical" aria-label="Resize the side panel" tabindex="0"></div>
         <header class="brand">
           <div class="title">
             <span class="title-start">
@@ -105,12 +92,14 @@
           <button type="button" data-tab="chat" class="on">Chat</button>
           <button type="button" data-tab="jobs">Jobs <span id="jobCount"></span></button>
           <button type="button" data-tab="projects">Projects</button>
+          <button type="button" data-tab="apps">Apps</button>
           <button type="button" data-tab="team">Team</button>
+          <button type="button" data-tab="needs">Needs you <span id="needsCount"></span></button>
         </nav>
         <section class="pane" id="chatPane">
-          <div class="channels" id="channels" role="tablist" aria-label="Channels"></div>
-          <div class="msgs" id="msgs"></div>
-          <div class="typing" id="typing" hidden><span></span><span></span><span></span> Chief is reading</div>
+          <div class="d-fold d-top"><div class="d-fold-in"><div class="channels" id="channels" role="tablist" aria-label="Channels"></div>
+</div></div>          <div class="msgs" id="msgs"></div>
+          <div class="d-fold d-foot-fold"><div class="d-fold-in"><div class="typing" id="typing" hidden><span></span><span></span><span></span> Chief is reading</div>
           <form class="composer" id="composer">
             <div class="ac" id="ac" hidden></div>
             <div class="tray" id="tray" hidden></div>
@@ -155,20 +144,20 @@
               </select>
               <button class="primary small" type="submit">Send</button>
             </div>
-          </form>
+          </form></div></div>
         </section>
         <section class="pane" id="threadPane" hidden>
-          <header class="thread-head">
+          <div class="d-fold d-top"><div class="d-fold-in"><header class="thread-head">
             <button type="button" class="link" id="threadBack">← Chat</button>
             <b id="threadWhere">Thread</b>
-          </header>
+          </header></div></div>
           <div class="msgs" id="threadMsgs"></div>
-          <form class="composer" id="threadComposer">
+          <div class="d-fold d-foot-fold"><div class="d-fold-in"><form class="composer" id="threadComposer">
             <textarea id="threadInput" rows="1" placeholder="Reply in thread" aria-label="Reply in thread"></textarea>
             <div class="controls">
               <button class="primary small" type="submit">Reply</button>
             </div>
-          </form>
+          </form></div></div>
         </section>
         <section class="pane" id="teamPane" hidden>
           <div class="viewbar" role="group" aria-label="View as">
@@ -184,6 +173,12 @@
           </div>
           <div class="projects" id="projects"></div>
         </section>
+        <section class="pane" id="appsPane" hidden>
+          <div class="home" id="home" aria-label="Apps"></div>
+        </section>
+        <section class="pane" id="needsPane" hidden>
+          <div class="jobs needs" id="needs"></div>
+        </section>
         <section class="pane" id="jobsPane" hidden>
           <div class="jobs" id="jobs"></div>
           <button class="ghost" id="clear" hidden>Clear finished</button>
@@ -195,7 +190,7 @@
         <div id="labels"></div>
         <div class="hud">
-          <button type="button" class="chip pot" id="shopBtn" aria-haspopup="dialog" aria-expanded="false" title="Shop and office pot" hidden><b>₦0</b><span>Shop</span></button>
+          <button type="button" class="chip pot" id="shopBtn" aria-haspopup="dialog" aria-expanded="false" aria-label="Shop and office pot" title="Shop and office pot" hidden><b>₦0</b><span>Shop</span></button>
           <button type="button" class="chip pot shop-door" data-shop-tab="rich" aria-haspopup="dialog" aria-label="Forbes list: the richest agents" title="Forbes list: the richest agents" hidden><i aria-hidden="true">👑</i><span>Forbes list</span></button>
           <button type="button" class="chip pot shop-door" data-shop-tab="looks" aria-haspopup="dialog" aria-label="Customise the office" title="Customise the office: layout, paint, floor and furniture" hidden><i aria-hidden="true">🎨</i><span>Customise</span></button>
           <div class="chip away" id="away" hidden></div>
@@ -210,6 +205,9 @@
             <button type="button" id="recenter" title="Recenter (R)" aria-label="Recenter">
               <svg viewBox="0 0 24 24"><circle cx="12" cy="12" r="3"/><path d="M12 2v3M12 19v3M2 12h3M19 12h3"/></svg>
             </button>
+            <button type="button" id="arrange" aria-pressed="false" title="Arrange the office: move desks, tables and furniture" aria-label="Arrange the office">
+              <svg viewBox="0 0 24 24"><path d="M12 2v20M2 12h20M12 2l-3 3M12 2l3 3M12 22l-3-3M12 22l3-3M2 12l3-3M2 12l3 3M22 12l-3-3M22 12l-3 3"/></svg>
+            </button>
             <button type="button" id="standup" title="Call a standup" aria-label="Call a standup">
               <svg viewBox="0 0 24 24"><circle cx="12" cy="5" r="2"/><circle cx="5" cy="15" r="2"/><circle cx="19" cy="15" r="2"/><path d="M8.5 20.5a7.5 7.5 0 0 0 7 0M3.5 10.5a8.5 8.5 0 0 1 4.5-5M20.5 10.5a8.5 8.5 0 0 0-4.5-5"/></svg>
             </button>
@@ -227,20 +225,26 @@
       <aside class="detail" id="detail" hidden></aside>
       <nav class="mnav" id="mnav" aria-label="Sections">
-        <button type="button" data-m="office" class="on">
-          <svg viewBox="0 0 24 24"><path d="M3 10.5L12 4l9 6.5"/><path d="M5 9.5V20h14V9.5"/><path d="M10 20v-5h4v5"/></svg>Office
+        <button type="button" data-m="office" title="Office" aria-label="Office" class="on">
+          <svg viewBox="0 0 24 24"><path d="M3 10.5L12 4l9 6.5"/><path d="M5 9.5V20h14V9.5"/><path d="M10 20v-5h4v5"/></svg><span class="lbl">Office</span>
+        </button>
+        <button type="button" data-m="chat" title="Chat" aria-label="Chat">
+          <svg viewBox="0 0 24 24"><path d="M4 5h16v11H9l-5 4z"/></svg><span class="lbl">Chat</span><i class="dot" id="mChatDot" hidden></i>
+        </button>
+        <button type="button" data-m="jobs" title="Jobs" aria-label="Jobs">
+          <svg viewBox="0 0 24 24"><path d="M4 7h16M4 12h16M4 17h10"/></svg><span class="lbl">Jobs</span><b id="mJobCount"></b>
         </button>
-        <button type="button" data-m="chat">
-          <svg viewBox="0 0 24 24"><path d="M4 5h16v11H9l-5 4z"/></svg>Chat<i class="dot" id="mChatDot" hidden></i>
+        <button type="button" data-m="projects" title="Projects" aria-label="Projects">
+          <svg viewBox="0 0 24 24"><path d="M3 7a2 2 0 0 1 2-2h4l2 2h8a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"/></svg><span class="lbl">Projects</span>
         </button>
-        <button type="button" data-m="jobs">
-          <svg viewBox="0 0 24 24"><path d="M4 7h16M4 12h16M4 17h10"/></svg>Jobs<b id="mJobCount"></b>
+        <button type="button" data-m="apps" title="Apps" aria-label="Apps">
+          <svg viewBox="0 0 24 24"><rect x="4" y="4" width="6" height="6" rx="1.5"/><rect x="14" y="4" width="6" height="6" rx="1.5"/><rect x="4" y="14" width="6" height="6" rx="1.5"/><rect x="14" y="14" width="6" height="6" rx="1.5"/></svg><span class="lbl">Apps</span>
         </button>
-        <button type="button" data-m="projects">
-          <svg viewBox="0 0 24 24"><path d="M3 7a2 2 0 0 1 2-2h4l2 2h8a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"/></svg>Projects
+        <button type="button" data-m="team" title="Team" aria-label="Team">
+          <svg viewBox="0 0 24 24"><circle cx="9" cy="8" r="3.2"/><path d="M3 20a6 6 0 0 1 12 0"/><circle cx="17" cy="9" r="2.4"/><path d="M17 14.5a4.6 4.6 0 0 1 4 5.5"/></svg><span class="lbl">Team</span>
         </button>
-        <button type="button" data-m="team">
-          <svg viewBox="0 0 24 24"><circle cx="9" cy="8" r="3.2"/><path d="M3 20a6 6 0 0 1 12 0"/><circle cx="17" cy="9" r="2.4"/><path d="M17 14.5a4.6 4.6 0 0 1 4 5.5"/></svg>Team
+        <button type="button" data-m="needs" title="Needs you" aria-label="Needs you">
+          <svg viewBox="0 0 24 24"><path d="M6 17V11a6 6 0 0 1 12 0v6l1.5 2h-15z"/><path d="M10 21h4"/></svg><span class="lbl">Needs you</span><b id="mNeedsCount"></b>
         </button>
       </nav>
     </div>

package/dist/theme-boot.js ADDED Viewed

@@ -0,0 +1,13 @@
+// Before first paint, so a saved theme never flashes the default. theme.js owns it after that.
+// A file rather than inline, so the page's CSP can be script-src 'self'.
+(function () {
+  try {
+    var t = localStorage.getItem('office.theme') || 'paper';
+    var m = localStorage.getItem('office.mode') || 'auto';
+    var d = m === 'dark' || (m === 'auto' && matchMedia('(prefers-color-scheme: dark)').matches);
+    var r = document.documentElement;
+    r.dataset.theme = t;
+    r.dataset.mode = d ? 'dark' : 'light';
+    r.dataset.nav = localStorage.getItem('office.nav') === 'sidebar' ? 'sidebar' : 'dock';
+  } catch (e) {}
+})();

package/docs/desktop.md ADDED Viewed

@@ -0,0 +1,52 @@
+# Desktop app (Tauri)
+The desktop app is a thin Tauri shell around the same office server and web UI you get from `agentoffice`. The shell lives in `desktop/`; this page covers how the web side behaves inside it.
+## How the shell starts the office
+1. Binds `127.0.0.1:0` to get a free port `N`.
+2. Runs `$SHELL -lc 'exec node <Resources>/app/bin/agentoffice.js --port N'`. The login shell means a Finder-launched app still finds `node` and `claude` on `PATH`.
+3. Sets `OFFICE_ROOT` (the folder you pick on first run, remembered), leaves `OFFICE_DATA` at `~/.agent-office`, and sets `OFFICE_DESKTOP=1`.
+4. Waits until `N` accepts connections, reads `~/.agent-office/office-key`, and points the window at `http://127.0.0.1:N/?key=…`.
+5. On quit, sends `SIGTERM` to the server and waits, so it flushes its state.
+The server needs no desktop-specific behaviour: the phone QR code only prints with `--phone`, which the shell never passes.
+## External links
+The webview drops `target="_blank"` links and `window.open`. `web/src/desktop.js` detects `window.__TAURI__` and sends those URLs to the opener plugin (`window.__TAURI__.opener.openUrl`). It handles:
+- links to other sites (`https:`, `http:`, `mailto:`),
+- `window.open(url)`.
+It also adds a `desktop` class to `<html>` so CSS can adapt. In a normal browser the module does nothing.
+Links to the office itself are left alone: the system browser doesn't have the webview's HttpOnly key cookie and would get a 401, and the key is stripped from the page URL so it can't be appended.
+The shell must enable the opener plugin with a capability that allows the localhost page to call it.
+## Building it
+```
+cd desktop && npm install
+npm run dev     # runs the repo; needs a built dist/
+npm run build   # stages from HEAD, writes src-tauri/target/release/bundle/{macos,dmg}
+```
+Rust comes via rustup. The build log goes to `~/.agent-office/desktop.log`.
+## Opening a downloaded build
+The dmg is signed ad hoc (`signingIdentity: "-"` in `tauri.conf.json`) and is **not notarized**: that needs an Apple *Developer ID Application* certificate and an Apple notarization login, which the project doesn't have. So on another Mac, Gatekeeper blocks the first launch of a downloaded copy.
+Before the ad-hoc signing was added, the bundle carried only the linker's signature on the executable, with no sealed resources. Gatekeeper treats that as a broken signature and says "Agent Office is damaged and can't be opened". Now the signature is valid, and the message is the milder "can't be opened because Apple cannot check it for malicious software".
+For users, any one of:
+- Terminal: `xattr -cr "/Applications/Agent Office.app"`, then open it (drag it to Applications first). This strips the download quarantine flag.
+- Right-click the app, choose Open, then Open again.
+- macOS 15 and later: try to open it once, then System Settings, Privacy & Security, Open Anyway.
+To remove the warning properly: enrol in the Apple Developer Program, create a Developer ID Application certificate, then build with `APPLE_SIGNING_IDENTITY="Developer ID Application: …"` and either `APPLE_ID`, `APPLE_PASSWORD` (app-specific) and `APPLE_TEAM_ID`, or `APPLE_API_KEY`, `APPLE_API_ISSUER` and `APPLE_API_KEY_PATH`. Tauri then signs, notarizes and staples the dmg. Those variables take precedence over the ad-hoc identity.
+The dmg is arm64 only (Apple Silicon).

package/docs/features.md ADDED Viewed

@@ -0,0 +1,96 @@
+# Agent Office: every feature
+Compiled 2026-10-18 from the code, the docs and the changelog (as of 0.9.2).
+## 1. The office itself (3D)
+- A 3D office (three.js) with desks, library, server room, research window, whiteboard, break room, pool table, reception, a guest wing.
+- Agents walk to where their work happens: Read/Grep/Glob → library, Bash → server room, web/MCP → research window, plans/todos → whiteboard, edits → their desk.
+- Camera: drag, right-drag or Q/E to turn, scroll to zoom, double-click to glide, WASD pan, R recenter; nearest walls drop so you can see in.
+- Themes (Paper, Ocean, Forest, Sunset, Lavender), light/dark/auto.
+- Lite rendering on phones (override with `?lite=0/1`).
+- Build mode: pick up desks, the table, pool table or bought items, move on a snapped grid, saved per layout. Free layouts to switch between.
+- Windows: Chat, Jobs, Projects, Team in draggable, resizable windows on wide screens (remembered); sidebar on phones. Dock mode with draggable job card.
+- Right-click menu on the floor: tidy windows, open/close, recenter, appearance, settings.
+- Header/footer fold away while scrolling lists.
+- Header shows owner, level ring, usage gauges.
+## 2. Chat and the chief of staff
+- Chat with `@agent` and `#project` tagging. Untagged messages go to the chief of staff.
+- The chief: picks project and agent, hands follow-ups live to a running agent, resumes finished sessions, asks when unsure, can hand out several jobs from one message (one per person), reads screenshots.
+- Chief picks the model (Haiku/Sonnet/Opus) to fit the work; moves a failed job up a rung.
+- Attachments: paperclip, paste, drag-drop. Voice notes.
+- Channels (Slack style): `#general`, `#chill-room`, your own; each message belongs to one channel; unread counts.
+- Threads: job updates collect under the message that started the job.
+- Slash commands: `/standup`, `/restart`, `/telegram`, "clear context".
+- "Needs you" strip and pane: jobs waiting on you; dismiss one or all; answering clears it.
+- Avatars drawn from each agent's look.
+## 3. Jobs
+- Each job is a real `claude -p` process in a project folder, stdin open so messages reach it mid-task.
+- Clearance per job: Plan only / Edit files / Full autonomy; grant more when blocked; approve a finished plan to build it.
+- Model picker per job, switchable mid-job (resumes the same session).
+- Auto-escalation on failure (Haiku → Sonnet → Opus) with a fresh session and summary.
+- "What changed": git-tree snapshots before/after, files, lines +/-, per-file patch, Edit button per file; "Files edited" where git can't say.
+- Job drawer: log, model, context size, cost and time (folded under Details).
+- Context management: agents' `clear_context` with notes to self; auto-nudge past 150k tokens; the boss can say "clear context"; notes survive clears.
+- Jobs survive server restarts (sessions resume).
+- Machine care: limit on agents working at once (default 4), hold when memory/CPU struggles ("On hold" notice), turn-taking for heavy builds (`heavy_work`), leftover processes killed at job end, `keep_running` to keep one.
+- Quality badges and XP; levels hire more agents (3 at level 1 up to 8).
+## 4. Agents and the team
+- Roster of named agents with roles, personalities, looks and voices; rename them (one word); Team tab with list/icons toggle; "Meet your team" onboarding.
+- Agent office tools (MCP): `office_roster`, `message_colleague` (optionally wait for reply), `hand_off`, `flag_for_boss`, `attach_files` (6 files, 25 MB each), `restart_office`, `clear_context`, `heavy_work`, `keep_running`, `add_app`, `office_shop`, `buy_item`, `bets`, `place_bet`, `take_bet`, `cancel_bet`, channel tools (`list_channels`, `create_channel`, `invite_to_channel`, `post_to_channel`).
+- Hand-offs only to free colleagues, max depth two; shown as "Ada → Tunde".
+- Daily standup at 9:30 on weekdays (or on demand): done / today / blockers, chief's wrap-up.
+- Break room: small-talk written by a small model, eight-ball pool played shot by shot; results to `#chill-room`; can be turned off.
+- Economy: agents are paid for finished work (more on lighter models), a shop for desk items, and bets between colleagues on jobs (stakes, take, cancel, voided if a party hands the job over).
+## 5. Projects and files
+- Projects are the subfolders of the root folder; Projects tab (list/icons).
+- Edit files in the office: folder tree and CodeMirror editor (syntax highlighting, line numbers, folding, bracket matching, find, undo, themed); Cmd/Ctrl+S saves; refuses to save if the file changed on disk.
+- PDF viewer (pdf.js), served only if truly a PDF.
+- Image/file attachments from agents shown in chat.
+## 6. Apps on the home screen
+- Agents build self-contained HTML apps and register them with `add_app`; each gets an icon and opens in a sandboxed window (`data/apps.json`, `/api/apps`).
+## 7. Telegram
+- Talk to the office from your phone through your own bot (made with @BotFather). The office long-polls, so no tunnel or webhook is needed.
+- Setup: `/telegram <token>` in the office, then `/telegram pair` for a one-time code (valid 15 minutes, 5 tries), then `/pair 123456` to the bot. `/telegram off` forgets the bot; `/telegram` shows status.
+- Only the paired account works; everyone else and any group chat is dropped unread. The token is kept in `data/telegram.json` (0600), not in state or chat.
+- Messages go to the office as chat; replies, finished jobs and flags come back. Reply to a message to answer in its thread.
+- `/grant` (reply to a blocked job) gives full autonomy; `/grant all` for every blocked job; `/auto <request>` starts a job at full autonomy.
+- Photos, videos, voice notes, audio and documents come in (up to 20 MB); agent attachments go out as photos, video, audio or files (up to 50 MB).
+- Long messages are clipped with a pointer to the office; sending retries on rate limits and keeps order. Break-room chatter is never sent.
+## 8. Talking and hearing
+- Dictation with whisper.cpp and a different Piper voice per agent, all local; mute and chime controls; desktop notifications when a job ships.
+## 9. Linked offices
+- Pair two offices with a one-time code; agents appear as visitors in a guest wing (12 hot desks, coffee bar, meeting table, up to 10 visitors).
+- Invite guests to use your agents (pick which agents, projects, clearance, daily token limit), or let their agents work in your projects (read only, or edit a copy you review and apply or discard).
+- Tag a host's agents from your chat (`@Ada@host`) and send yours to their project (`#repo@host`). Job titles shared only if you allow it.
+## 10. Leaderboard
+- Optional board of jobs, tokens and agent time; a handle is separate from sharing; nothing shared until you join.
+## 11. Claude access and usage
+- Claude Code login or API key; plan usage meters; token limit and compaction point; context limit settable in the office.
+## 12. Settings
+- Settings page: owner, token limit, compaction point, chief model, standup time and weekends, job-title sharing, break-room talk, agents working at once. Saved values beat environment variables; "Use the default" reverts.
+- Environment options include `OFFICE_ROOT`, `OFFICE_DATA`, `PORT`, `CLAUDE_BIN`, `STANDUP_AT`, `BANTER*`, `WHISPER_*`, `PIPER_BIN`, `FFMPEG_BIN`, `OFFICE_LEADERBOARD_URL`, `OFFICE_MAX_AGENTS`.
+## 13. Phone, desktop and install
+- `agentoffice --phone` listens on the LAN and prints a QR code; or "Make a public address" starts a Cloudflare quick tunnel with a QR code (off until pressed; the key stays the only way in).
+- Installable as a PWA.
+- Desktop app (Tauri, macOS) with a designed DMG; starts the office on a free port.
+- `npm install -g agent-office-studio`, then `agentoffice` or `agentstudio`; picks a free port; `--link` reprints the key link.
+## 14. Security
+- Listens on localhost only by default; page, API and socket need a key (`data/office-key`, 0600), the key cookie holds a MAC, and a CSP limits images and forms.
+- Only the office's own page may call the API; malformed URLs don't crash it.
+- Guests' jobs don't get your MCP servers, settings, hooks or memory; their tokens are counted per call; unlinked guests' jobs are stopped.
+- Git runs with fsmonitor and external diff drivers off; snapshots never run clean/smudge filters.
+- Below Full autonomy, `attach_files` takes only files from the job's own project; job tokens stay out of the projects folder.
+- Dependencies pinned and patched (ws, Vite/esbuild); CI plus npm publish on `v*` tags.

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "agent-office-studio",
-  "version": "0.8.0",
+  "version": "0.9.2",
   "description": "A 3D office where the staff are Claude Code agents.",
   "license": "MIT",
   "files": [
@@ -42,10 +42,11 @@
   "scripts": {
     "dev": "concurrently -k -n server,web -c blue,magenta \"node --watch server/index.js\" \"vite\"",
     "build": "vite build",
+    "watch": "vite build --watch",
     "start": "vite build && node server/supervise.js",
     "voice:model": "mkdir -p data/whisper && curl -L --progress-bar -o data/whisper/ggml-base.en.bin https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-base.en.bin",
     "voice:piper": "python3 -m venv data/piper/venv && data/piper/venv/bin/pip install -q piper-tts && data/piper/venv/bin/python -m piper.download_voices --data-dir data/piper/voices en_GB-cori-high en_US-amy-medium en_GB-alan-medium en_US-kristin-medium en_US-ryan-high en_GB-alba-medium en_GB-aru-medium en_US-john-medium en_US-hfc_female-medium",
-    "test": "node scripts/economy.mjs && node scripts/wagers.mjs && node scripts/smoke.mjs && node scripts/talk.mjs && node scripts/guests.mjs && node scripts/remote.mjs && node scripts/lent-home.mjs && node scripts/visits.mjs && node scripts/phone.mjs && node scripts/wagers-server.mjs",
+    "test": "node scripts/economy.mjs && node scripts/wagers.mjs && node scripts/smoke.mjs && node scripts/machine.mjs && node scripts/talk.mjs && node scripts/guests.mjs && node scripts/remote.mjs && node scripts/lent-home.mjs && node scripts/visits.mjs && node scripts/phone.mjs && node scripts/desktop-gate.mjs && node scripts/hardening-gate.mjs && node scripts/guest-gate.mjs && node scripts/wagers-server.mjs && node scripts/chief-gate.mjs && node scripts/files.mjs && node scripts/apps.mjs && node scripts/telegram.mjs",
     "prepack": "vite build"
   },
   "dependencies": {
@@ -54,10 +55,26 @@
     "ws": "8.22.0"
   },
   "devDependencies": {
+    "@codemirror/autocomplete": "6.20.3",
+    "@codemirror/commands": "6.11.1",
+    "@codemirror/lang-css": "6.3.1",
+    "@codemirror/lang-html": "6.4.12",
+    "@codemirror/lang-javascript": "6.2.5",
+    "@codemirror/lang-json": "6.0.2",
+    "@codemirror/lang-markdown": "6.5.2",
+    "@codemirror/lang-python": "6.2.1",
+    "@codemirror/lang-yaml": "6.1.3",
+    "@codemirror/language": "6.13.1",
+    "@codemirror/search": "6.7.2",
+    "@codemirror/state": "6.7.6",
+    "@codemirror/view": "6.43.14",
     "@fontsource-variable/inter": "5.3.0",
     "@fontsource/jetbrains-mono": "5.3.0",
+    "@lezer/highlight": "1.2.5",
+    "codemirror": "6.0.2",
     "concurrently": "10.0.6",
     "marked": "^18.1.0",
+    "pdfjs-dist": "6.4.299",
     "three": "0.186.1",
     "vite": "6.4.3"
   }

package/server/apps.js ADDED Viewed

@@ -0,0 +1,146 @@
+// The office's apps: what the home screen shows. Each app is one manifest
+// entry in data/apps.json. The boss asks for an app, an agent builds it and
+// registers it with the add_app tool (or POST /api/apps), and it gets an icon.
+//
+// `kind` says how an app opens. KINDS checks what each kind needs; the web
+// side (web/src/apps.js) has the matching opener. To add a kind, add it in
+// both places.
+//
+// A manifest entry:
+//   id           slug, unique; made from the name if not given
+//   name         what the icon says
+//   icon         an emoji (or a few characters)
+//   color        the icon's tile, #rgb or #rrggbb (optional)
+//   description  one line, shown on hover (optional)
+//   kind         'page': a self-contained HTML file in a project, run sandboxed
+//   repo, path   for 'page': the project folder and the file inside it
+//   w, h         the window's starting size (optional)
+//   addedBy, addedAt
+import fs from 'node:fs';
+import path from 'node:path';
+import * as files from './files.js';
+const fail = (code, msg) => Object.assign(new Error(msg), { code });
+const MAX_APPS = 200;
+const DATA_MAX = 1e6;
+const ID_RE = /^[a-z0-9][a-z0-9-]{0,39}$/;
+export const slug = (s) => String(s || '').toLowerCase().normalize('NFKD').replace(/[^\w\s-]/g, '').trim().replace(/[\s_-]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 40);
+const text = (v, label, max, need = false) => {
+  if (v == null || v === '') { if (need) throw fail(400, `An app needs a ${label}.`); return ''; }
+  if (typeof v !== 'string') throw fail(400, `The ${label} must be text.`);
+  v = v.trim().replace(/\s+/g, ' ');
+  if (need && !v) throw fail(400, `An app needs a ${label}.`);
+  if (v.length > max) throw fail(400, `The ${label} is limited to ${max} characters.`);
+  return v;
+};
+// What each kind needs, checked when an app is added. `repoPath` turns a
+// project name into its folder, or null.
+export const KINDS = {
+  page: {
+    clean(a, { repoPath }) {
+      const repo = text(a.repo, 'project folder', 200, true);
+      const dir = repoPath(repo);
+      if (!dir) throw fail(400, `There is no project folder called "${repo}".`);
+      const rel = text(a.path, 'file path', 500, true).replace(/^\/+/, '');
+      files.page(dir, rel); // throws if it is missing, not HTML or too big
+      return { repo, path: rel };
+    },
+  },
+};
+export class Apps {
+  constructor(dataDir, { repoPath, onChange = () => {} }) {
+    this.file = path.join(dataDir, 'apps.json');
+    this.repoPath = repoPath;
+    this.onChange = onChange;
+    this.apps = [];
+    try {
+      const saved = JSON.parse(fs.readFileSync(this.file, 'utf8'));
+      if (Array.isArray(saved.apps)) this.apps = saved.apps.filter((a) => a && ID_RE.test(a.id) && KINDS[a.kind]);
+    } catch {}
+  }
+  list() { return this.apps.map((a) => ({ ...a })); }
+  get(id) { return this.apps.find((a) => a.id === id) || null; }
+  // Adds an app, or replaces the one with the same id (so re-registering an
+  // app after a rebuild updates it). Returns the stored entry.
+  add(input, by = 'boss') {
+    if (!input || typeof input !== 'object') throw fail(400, 'Nothing to add.');
+    const name = text(input.name, 'name', 40, true);
+    const kind = text(input.kind || 'page', 'kind', 20);
+    if (!KINDS[kind]) throw fail(400, `Unknown kind of app "${kind}". Known: ${Object.keys(KINDS).join(', ')}.`);
+    const id = input.id ? text(input.id, 'id', 40) : slug(name);
+    if (!ID_RE.test(id)) throw fail(400, 'The id must be lowercase letters, numbers and dashes.');
+    const icon = text(input.icon, 'icon', 8) || name.slice(0, 1).toUpperCase();
+    const color = text(input.color, 'colour', 7);
+    if (color && !/^#([0-9a-f]{3}|[0-9a-f]{6})$/i.test(color)) throw fail(400, 'The colour must be a hex colour like #1d4ed8.');
+    for (const v of [input.w, input.h]) if (v != null && !(Number.isInteger(v) && v >= 300 && v <= 4000)) throw fail(400, 'Window sizes are whole pixels from 300 to 4000.');
+    const description = text(input.description, 'description', 200);
+    const was = this.get(id);
+    if (!was && this.apps.length >= MAX_APPS) throw fail(400, `The home screen holds ${MAX_APPS} apps; remove one first.`);
+    const app = {
+      id, name, icon, kind,
+      ...(color && { color }),
+      ...(description && { description }),
+      ...KINDS[kind].clean(input, { repoPath: this.repoPath }),
+      ...(input.w && { w: input.w }), ...(input.h && { h: input.h }),
+      addedBy: was?.addedBy || by, addedAt: was?.addedAt || Date.now(),
+      ...(was && { updatedAt: Date.now() }),
+    };
+    this.apps = was ? this.apps.map((a) => (a.id === id ? app : a)) : [...this.apps, app];
+    this.save();
+    return app;
+  }
+  remove(id) {
+    if (!this.get(id)) throw fail(404, 'No app with that id.');
+    this.apps = this.apps.filter((a) => a.id !== id);
+    this.save();
+  }
+  // The order the icons sit in. Ids not given keep their place at the end.
+  reorder(ids) {
+    if (!Array.isArray(ids)) throw fail(400, 'Give the app ids in order.');
+    const rank = new Map(ids.map((id, i) => [id, i]));
+    this.apps = [...this.apps].sort((a, b) => (rank.get(a.id) ?? 1e9) - (rank.get(b.id) ?? 1e9));
+    this.save();
+  }
+  // What an app keeps for itself (its page has no storage of its own): one
+  // JSON value per app in app-data/<id>.json, so every window onto this
+  // office (a browser tab, the desktop app on whatever port) sees the same.
+  dataFile(id) {
+    if (!ID_RE.test(id || '')) throw fail(400, 'No app with that id.');
+    return path.join(path.dirname(this.file), 'app-data', `${id}.json`);
+  }
+  readData(id) {
+    try { return JSON.parse(fs.readFileSync(this.dataFile(id), 'utf8')); } catch (err) {
+      if (err.code === 400) throw err;
+      return null;
+    }
+  }
+  writeData(id, value) {
+    const file = this.dataFile(id);
+    const text = JSON.stringify(value ?? null);
+    if (text.length > DATA_MAX) throw fail(413, 'That is more than an app can keep (1 MB).');
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file + '.tmp', text);
+    fs.renameSync(file + '.tmp', file);
+  }
+  save() {
+    fs.mkdirSync(path.dirname(this.file), { recursive: true });
+    const tmp = this.file + '.tmp';
+    fs.writeFileSync(tmp, JSON.stringify({ apps: this.apps }, null, 2));
+    fs.renameSync(tmp, this.file);
+    this.onChange(this.list());
+  }
+}

package/server/changes.js CHANGED Viewed

@@ -18,6 +18,16 @@ const git = (cwd, args, env = {}) => new Promise((resolve, reject) => {
   });
 });
+// Clean and smudge filters are commands a project's config names, and
+// `add -A`, `write-tree` or a checkout would run them. These blank every one
+// configured, for one call: git then passes the content through as it is.
+export async function noFilters(cwd) {
+  let out = '';
+  try { out = await git(cwd, ['config', '--name-only', '--get-regexp', '^filter\\.']); } catch { return []; }
+  const names = new Set(out.split('\n').map((k) => k.match(/^filter\.(.+)\.[^.]+$/)?.[1]).filter(Boolean));
+  return [...names].flatMap((n) => [...['clean', 'smudge', 'process'].map((k) => `filter.${n}.${k}=`), `filter.${n}.required=false`].flatMap((c) => ['-c', c]));
+}
 // A tree sha for the working tree as it is right now, or null outside a repo.
 export async function snapshotTree(cwd) {
   const tmp = path.join(os.tmpdir(), `office-index-${process.pid}-${Math.random().toString(36).slice(2)}`);
@@ -26,8 +36,9 @@ export async function snapshotTree(cwd) {
     // Seeding from the real index keeps `add -A` quick on a big tree.
     try { fs.copyFileSync(real, tmp); } catch {}
     const env = { GIT_INDEX_FILE: tmp };
-    await git(cwd, ['add', '-A'], env);
-    return (await git(cwd, ['write-tree'], env)).trim();
+    const nf = await noFilters(cwd);
+    await git(cwd, [...nf, 'add', '-A'], env);
+    return (await git(cwd, [...nf, 'write-tree'], env)).trim();
   } catch {
     return null;
   } finally {

package/server/chief.js CHANGED Viewed

@@ -24,7 +24,7 @@ export function canSee(files) {
 const SCHEMA = {
   type: 'object',
   properties: {
-    action: { type: 'string', enum: ['followup', 'new', 'dismiss', 'recall', 'clear', 'standup', 'ask', 'chat'] },
+    action: { type: 'string', enum: ['followup', 'new', 'dismiss', 'recall', 'clear', 'standup', 'restart', 'takeover', 'ask', 'chat'] },
     jobId: { type: 'string' },
     agentId: { type: 'string' },
     agentIds: { type: 'array', items: { type: 'string' } },
@@ -32,6 +32,22 @@ const SCHEMA = {
     brief: { type: 'string' },
     model: { type: 'string', enum: ['haiku', 'sonnet', 'opus'] },
     escalate: { type: 'boolean' },
+    // More than one piece of new work from a single message, one per job.
+    jobs: {
+      type: 'array',
+      items: {
+        type: 'object',
+        properties: {
+          agentId: { type: 'string' },
+          repo: { type: 'string' },
+          brief: { type: 'string' },
+          model: { type: 'string', enum: ['haiku', 'sonnet', 'opus'] },
+          say: { type: 'string' },
+        },
+        required: ['repo', 'brief'],
+        additionalProperties: false,
+      },
+    },
     say: { type: 'string' },
   },
   required: ['action', 'say'],
@@ -43,9 +59,12 @@ const SYSTEM = `You are the chief of staff in an office of coding agents. The bo
 Actions:
 - "followup": the message adds to, corrects, or asks about a job that already exists (working, queued or recently finished). Give its jobId. Prefer this whenever the message plausibly relates to an open job, especially the job of an agent the boss tagged. Set "escalate": true only when the boss is saying a finished job's work is wrong, incomplete, or that the agent missed the point — the second go then runs on a stronger model.
 - "new": a new piece of work. Give "repo" (exactly one name from Projects), "brief" (the task in the boss's own words, plus any context from recent chat that the agent needs; never add requirements), "agentId" (the tagged agent's id; otherwise a free agent whose role in Staff clearly fits the work; otherwise "" for whoever is free), and "model" (see Sizing the work). Never pick a busy or dismissed agent unless the boss tagged them.
+  You can hand out several jobs from one message. When the boss tags more than one agent for work, or asks for separate pieces of work, give "jobs" instead: one entry per job, each with its own "repo", "brief", "agentId", "model" and a short "say" line for that job. Every tagged agent gets a job: the same brief for each when the boss wants them all on it (e.g. two agents doing a review pass), or a part each when the work splits naturally. Never tell the boss you can only hand out one job at a time.
 - "dismiss": the boss wants agents sent home (dismissed, let go for now, off the floor). Give "agentIds": the ids of exactly who they mean, worked out from Staff (e.g. "everyone who's free except Mira" means every free agent but Mira). Only free agents can go; leave out anyone working.
 - "recall": the boss wants dismissed agents back in. Give "agentIds" (every dismissed agent if they say "everyone").
 - "clear": the boss wants agents to clear their context (start fresh, forget the conversation so far). Do it yourself; never hand it out as a job. Give "agentIds" for the agents they name, or leave it empty when they mean everyone.
+- "restart": the boss says an agent is stuck, frozen or not responding and wants it nudged, unstuck or restarted. Give the jobId of that agent's working job. Do it yourself: a stuck session can't read messages, so never send it a followup.
+- "takeover": the boss wants someone else to help with, take over or finish a working agent's job (often because it is stuck). Give its jobId, and "agentId" if they named who should take it (otherwise "" for whoever is free). Never pick the agent who was on it.
 - "standup": the boss wants the team to hold a standup now (e.g. "standup time", "let's do standup", "gather everyone for a status update").
 - "ask": you can't tell which project new work belongs to, or the request is too unclear to start. Ask one short question.
 - "chat": greetings, thanks, or questions about the office itself (who is doing what). Answer from the context given. If your answer is about one particular job, give its jobId too, so the boss gets a link to where that job's updates are collecting.