agent-office-studio 0.0.0-stage → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,57 @@
+# Changelog
+
+Notable changes to Agent Office. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and versions follow
+[Semantic Versioning](https://semver.org/).
+
+## Unreleased
+
+## 0.2.0 — 2026-10-12
+
+### Install
+- Published as `agent-office-studio`. `npm install -g agent-office-studio`, then
+  run `agentoffice` (or `agentstudio`) in the folder that holds your projects.
+  State lives in `~/.agent-office`; `OFFICE_DATA` and `OFFICE_ROOT` override.
+
+### Fixed
+- A job whose agent flagged a question, decision or blocker is no longer
+  reported as done when their turn ends. The chief posts "Waiting on you"
+  instead, and no shipped count, XP or celebration is given until it resumes.
+
+### Leaderboard
+- An optional leaderboard: join under a claimed handle and compare jobs
+  finished, tokens used and agent time, weekly and all time. Off until you
+  join; only per-day counters are shared. The service is a Cloudflare Worker in
+  `leaderboard/`. A local ledger (`data/activity.json`) now keeps those counters.
+
+## 0.1.0 — 2026-10-11
+
+The first public release.
+
+### The office
+- A 3D office where each agent is a Claude Code session. Agents walk to the
+  library to read, the server room to run commands and their desk to write.
+- Chat with `@agent` and `#project` tags; a chief of staff routes everything
+  else, hands follow-ups to whoever is on the job, and asks when unsure.
+- Slack-style channels and threads; attachments, including screenshots the
+  chief can read.
+- A daily standup at the whiteboard, and a break room where idle agents talk
+  (in #chill-room) and play eight-ball.
+- Levels: shipped jobs earn XP, and each level hires another agent.
+- Themes, light and dark mode, and an installable app for desktop and phone.
+
+### Jobs
+- Clearance per job: plan only, edit files, or full autonomy, with the option
+  to grant more mid-job.
+- The chief picks Haiku, Sonnet or Opus to fit the work and steps up a rung
+  when a job fails.
+- Agents message each other and hand work to free colleagues.
+- "What changed": each job's diff, from working-tree snapshots that never
+  touch the repo's own index or history.
+- Jobs resume after a server restart.
+
+### Setup
+- Claude access: the Claude Code login on the machine, or an Anthropic API key.
+- Plan usage meters for the Claude Code login.
+- Voice: dictation with whisper.cpp and a Piper voice per agent, all local.
+- An opt-in terminal in a drawer under the office.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Onuoha Obinna
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,86 @@
-# Temporary Holding Version
+# Agent Office
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![CI](https://github.com/onuohasilver/agent-office/actions/workflows/ci.yml/badge.svg)](https://github.com/onuohasilver/agent-office/actions/workflows/ci.yml)
+[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+A 3D office where the staff are Claude Code agents. Hand someone a job and they
+walk to a desk and do it for real, in that project folder, with `claude -p`.
+
+![The office: chat on the left, the floor with desks, a break room, a pool table and the chief of staff at reception](docs/images/office.jpg)
+
+```bash
+npm install -g agent-office-studio
+cd ~/projects        # the folder whose subfolders are your projects
+agentoffice          # or: agentstudio. Serves on http://localhost:4317
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/onuohasilver/agent-office.git
+cd agent-office
+npm install
+npm start            # builds, then serves on http://localhost:4317
+```
+
+You need Node.js 20+, git, and [Claude Code](https://docs.anthropic.com/en/docs/claude-code)
+signed in on this machine (or an Anthropic API key). Your projects are the
+folders next to this one (or, with `agentoffice`, in the folder you run it from) — see [Getting started](docs/getting-started.md).
+
+## What it does
+
+- **You chat; the office does the rest.** `@Ada #storefront fix the checkout
+  bar` goes straight to Ada. Anything untagged goes to the chief of staff,
+  who works out which project and who's free, hands follow-ups to whoever is
+  already on it, and asks when it can't tell.
+- **Real work, visibly.** Every job is a `claude` process in that project.
+  Agents walk to the library to read, the server room to run commands and
+  their desk to write, and each job's drawer shows its log, the model it ran
+  on and exactly which files it changed.
+- **You stay in charge.** Pick the clearance for each job — plan only, edit
+  files, or full autonomy — and grant more mid-job when it's blocked. The
+  chief picks Haiku, Sonnet or Opus to fit the work and steps up a rung when
+  a job fails.
+- **A team, not a queue.** Agents message each other mid-task and hand work
+  to free colleagues. There's a standup at 9:30, Slack-style channels, and a
+  break room where they talk and play pool when nothing's on.
+- **Talk to it.** Dictate with whisper.cpp and hear replies in a different
+  voice per agent — all on this machine.
+- **Yours, on your machine.** It listens on localhost only. Use it on your
+  Claude plan or with an API key.
+
+## Guides
+
+- [Your first job](docs/guides/your-first-job.md) — from a fresh install to a change you've reviewed
+- [Working with the team](docs/guides/working-with-the-team.md) — briefs that work, clearance, channels, cost
+- [Troubleshooting](docs/guides/troubleshooting.md) — common problems and their fixes
+- [Updating](docs/guides/updating.md) — getting new versions without losing your office
+
+## Documentation
+
+| | |
+|---|---|
+| [Getting started](docs/getting-started.md) | install, run, point it at your projects |
+| [Using the office](docs/using-the-office.md) | the chat, channels, threads, standup, the break room |
+| [Jobs](docs/jobs.md) | clearance, which model, what changed |
+| [The leaderboard](docs/leaderboard.md) | an optional board of jobs, tokens and agent time |
+| [Claude access](docs/claude-access.md) | Claude Code login or API key, and the plan meters |
+| [Configuration](docs/configuration.md) | every setting |
+| [Talking out loud](docs/voice.md) | speech in and voices out |
+| [The terminal](docs/terminal.md) | a real shell under the office |
+| [On your phone](docs/phone.md) | install it like an app |
+| [How the office works](docs/how-it-works.md) | jobs, office tools, where things are kept |
+| [Security](docs/security.md) | who can reach it and what jobs may do |
+| [Development](docs/development.md) | dev server, shipping, testing safely |
+| [Packaging roadmap](docs/packaging.md) | from a clone to an install |
+
+## Contributing
+
+Bug reports, ideas and pull requests are welcome — see
+[CONTRIBUTING.md](CONTRIBUTING.md). Report security problems privately, as
+described in [SECURITY.md](SECURITY.md). What's changed between versions is in
+[CHANGELOG.md](CHANGELOG.md).
+
+## Licence
+
+[MIT](LICENSE).

package/bin/agentoffice.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+// `agentoffice` starts the office. Projects are the folders next to where you
+// run it; the office's own state lives in ~/.agent-office, so upgrading the
+// package never touches it. OFFICE_ROOT and OFFICE_DATA override both.
+
+import os from 'node:os';
+import path from 'node:path';
+import fs from 'node:fs';
+import { fileURLToPath } from 'node:url';
+
+const HERE = path.dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(fs.readFileSync(path.join(HERE, '..', 'package.json'), 'utf8'));
+const arg = process.argv[2];
+
+if (arg === '--version' || arg === '-v') {
+  console.log(pkg.version);
+  process.exit(0);
+}
+if (arg === '--help' || arg === '-h') {
+  console.log(`agentoffice ${pkg.version}
+
+Usage: agentoffice   (or agentstudio)
+
+Starts the office at http://localhost:\${PORT:-4317}. Needs Claude Code
+(\`claude\`) installed and signed in.
+
+  OFFICE_ROOT   folder whose subfolders are your projects (default: this folder)
+  OFFICE_DATA   where the office keeps its state (default: ~/.agent-office)
+  PORT          port to listen on (default: 4317)
+
+Docs: ${pkg.homepage}`);
+  process.exit(0);
+}
+
+process.env.OFFICE_ROOT ||= process.cwd();
+process.env.OFFICE_DATA ||= path.join(os.homedir(), '.agent-office');
+
+await import('../server/supervise.js');

package/dist/assets/_commonjsHelpers-CqkleIqs.js

@@ -0,0 +1 @@
+function e(t){return t&&t.__esModule&&Object.prototype.hasOwnProperty.call(t,"default")?t.default:t}export{e as g};

package/dist/assets/addon-fit-BwprjgOP.js

@@ -0,0 +1 @@
+import{g as f}from"./_commonjsHelpers-CqkleIqs.js";function g(i,n){for(var o=0;o<n.length;o++){const t=n[o];if(typeof t!="string"&&!Array.isArray(t)){for(const e in t)if(e!=="default"&&!(e in i)){const r=Object.getOwnPropertyDescriptor(t,e);r&&Object.defineProperty(i,e,r.get?r:{enumerable:!0,get:()=>t[e]})}}}return Object.freeze(Object.defineProperty(i,Symbol.toStringTag,{value:"Module"}))}var l={exports:{}};(function(i,n){(function(o,t){i.exports=t()})(self,()=>(()=>{var o={};return(()=>{var t=o;Object.defineProperty(t,"__esModule",{value:!0}),t.FitAddon=void 0,t.FitAddon=class{activate(e){this._terminal=e}dispose(){}fit(){const e=this.proposeDimensions();if(!e||!this._terminal||isNaN(e.cols)||isNaN(e.rows))return;const r=this._terminal._core;this._terminal.rows===e.rows&&this._terminal.cols===e.cols||(r._renderService.clear(),this._terminal.resize(e.cols,e.rows))}proposeDimensions(){if(!this._terminal||!this._terminal.element||!this._terminal.element.parentElement)return;const e=this._terminal._core,r=e._renderService.dimensions;if(r.css.cell.width===0||r.css.cell.height===0)return;const c=this._terminal.options.scrollback===0?0:e.viewport.scrollBarWidth,a=window.getComputedStyle(this._terminal.element.parentElement),d=parseInt(a.getPropertyValue("height")),m=Math.max(0,parseInt(a.getPropertyValue("width"))),s=window.getComputedStyle(this._terminal.element),h=d-(parseInt(s.getPropertyValue("padding-top"))+parseInt(s.getPropertyValue("padding-bottom"))),u=m-(parseInt(s.getPropertyValue("padding-right"))+parseInt(s.getPropertyValue("padding-left")))-c;return{cols:Math.max(2,Math.floor(u/r.css.cell.width)),rows:Math.max(1,Math.floor(h/r.css.cell.height))}}}})(),o})())})(l);var p=l.exports;const _=f(p),w=g({__proto__:null,default:_},[p]);export{w as a};