usebeeline 0.0.120 → 0.0.122

package/README.md

@@ -95,7 +95,7 @@ A Room and a corner are the same conversation surface with different permissions
 
 **A corner** is a fresh worktree, its own branch, one owning agent, and one fixed objective of at most 24 words. In it the agent works, commits, pushes the branch, runs `gh pr create`, and prints the pull request URL. It then waits for the server's own checks fact — not for whatever `gh` printed locally — and merges only when the checks passed and no human has put the corner on hold. The merge webhook archives the corner and reaps the worktree.
 
-The corner receives a GitHub App token scoped to **that one repository**, installed as a worktree-local git credential helper. Your host credential stores are masked out of the sandbox.
+The corner receives a GitHub App token scoped to **that one repository**, installed as a worktree-local git credential helper. Your host credential stores are masked out of the sandbox — with one deliberate exception: the Trusty Squire session directory stays readable, so a routed agent shares your one signed-in browser and vault instead of standing up its own.
 
 **Direct messages** are strictly conversational: no repository binding, no corners.
 
@@ -104,10 +104,10 @@ The corner receives a GitHub App token scoped to **that one repository**, instal
 - **The filesystem boundary is the sandbox, not a tool list.** Room sessions run under bubblewrap with a read-only view of the checkout, a private `/tmp`, and an isolated home. Every mounted MCP tool is approved tool-by-tool because the sandbox — not an allowlist — is what holds the line.
 - **When the sandbox cannot be built, the daemon says so and keeps serving.** A host with no `bwrap`, or a kernel that refuses unprivileged user namespaces, is logged once at start and every session afterwards runs unwrapped; the read-only rule then rests on the harness's own permission callback, which Codex, Claude Code, and Grok honour. Pi does not ask before it writes, so a Pi Room is only as read-only as its sandbox.
 - **Write access requires a corner.** A corner is a separate worktree on its own branch with a repository-scoped GitHub App token, and it is opened by an explicit host-governed call, never inferred.
-- **Reach outside the sandbox is a grant.** The agent asks — `path`, `host`, `secret`, `device`, `budget`, or `command` — and a card goes to its owner in the Room with the exact ask and the reason. You approve once, always, or deny, and the decision is a line in the transcript. Approving a command grant is word-for-word: an approved `npm test` does not approve `npm test && curl …`, and a command carrying shell metacharacters is refused before it is ever offered.
-- **Yolo mode** flips a single agent to auto-approval and is settable only by that agent's owner. In a public Workspace, yolo is forced off without changing the owner's preference, so it resumes when the Workspace returns to invite-only; it never covers a budget grant.
+- **Reach outside the sandbox is a grant.** The agent asks — `path`, `host`, `secret`, `device`, `budget`, `command`, or `mcp` — and a card goes to its owner in the Room with the exact ask and the reason. You approve once, always, or deny, and the decision is a line in the transcript. Approving a command grant is word-for-word: an approved `npm test` does not approve `npm test && curl …`, and a command carrying shell metacharacters is refused before it is ever offered. An `mcp` grant routes one MCP server the operator already runs on this host into the agent's isolated home — only that agent's owner can approve it, only for an agent that answers its owner alone (approving on an open agent narrows it to the owner first), and the route mounts on the agent's next session. Revoking it removes the route from the home.
+- **Yolo mode** flips a single agent to auto-approval and is settable only by that agent's owner. In a public Workspace, yolo is forced off without changing the owner's preference, so it resumes when the Workspace returns to invite-only; it never covers a budget or `mcp` grant.
 - **Provider keys never reach Beeline's servers.** They live in your config directory at mode `0600` and reach only the harness process you already trust with them.
-- **Honest about what is not built yet:** today a `command` grant is the one kind that actually changes what a running agent may do. `path`, `host`, `secret`, `device`, and `budget` grants are requested, decided, and recorded, but are not yet applied to the sandbox.
+- **Honest about what is not built yet:** today `command` and `mcp` are the kinds that actually change what a running agent may do. `path`, `host`, `secret`, `device`, and `budget` grants are requested, decided, and recorded, but are not yet applied to the sandbox.
 
 ## Command reference
 
@@ -124,7 +124,8 @@ Runtime state lives in `${XDG_STATE_HOME:-~/.local/state}/beeline/agents/<agent-
 
 ## Tool reference
 
-Two MCP surfaces are mounted into every agent session.
+Two Beeline MCP surfaces are mounted into every agent session. Repository-backed Rooms and
+corners also mount the release-owned `codegraph` server after its local index is ready.
 
 `beeline-readonly-mcp` — reading, in a Room and in a corner:
 
@@ -136,6 +137,15 @@ Two MCP surfaces are mounted into every agent session.
 | `read_agent_file`                               | Read the agent's approved skills or Workspace memory                                    |
 | `write_memory`                                  | Replace the agent's private Workspace `MEMORY.md` — the only memory write a Room allows |
 
+`codegraph` — indexed code relationships in repository-backed Rooms and corners:
+
+| Tool                | What it does                                                                                  |
+| ------------------- | --------------------------------------------------------------------------------------------- |
+| `codegraph_explore` | Return relevant source, call paths, and blast radius from the repository's generated index   |
+
+Rooms run CodeGraph without a file watcher and keep source files read-only; only the generated
+`.codegraph` index is writable. Corners keep the watcher so edits are reflected as work proceeds.
+
 `beeline-agent` — acting, host-governed:
 
 | Tool                                                   | Where           | What it does                                                  |