@awebai/oats 0.38.0 → 0.38.2

package/docs/desktop-instance-start.md

@@ -17,14 +17,20 @@ Enter a model or leave the field blank to use the selected launch's default.
 An old harness's model is not carried to a different harness. Available local model
 suggestions are advisory; a model ID can also be typed. Start uses the saved
 briefing and state in a new harness conversation; it does not resume an old
-harness conversation ID. After the launch appears in the roster, Desktop
-opens the instance's terminal.
+harness conversation ID. Once the kernel accepts the start or restart, the
+dialog closes and Desktop opens the instance's terminal as soon as its row is
+running with a terminal session, so whatever the harness shows first (a
+confirmation such as Claude Code's development-channels prompt, an error, the
+session) is visible there. If the terminal is not ready within the wait, a
+notice says so and the instance's row opens it later. A refused launch keeps
+the dialog open with the kernel's error.
 
 If an ordinary Start dialog finds the instance already running, its action becomes
 **Open terminal**. A failed or timed-out start requires **Refresh status** before
 another attempt, because the launch may have succeeded before the reply was
 lost. Changing workspaces dismisses the dialog and prevents a delayed launch
-reply from opening a terminal in the wrong workspace.
+reply, or a terminal that becomes ready later, from opening in the wrong
+workspace.
 
 **Restart with…** is explicit: after validating the new configuration, the
 kernel stops the current harness and starts the selected one. It does not

package/docs/desktop.md

@@ -89,10 +89,15 @@ new PATH.
 
 ## Opening a workspace
 
-The app starts on the directory it was launched with (its own folder by
-default). To view a deployment, open the workspace switcher in the sidebar
-and choose **Add workspace → Browse**, then point it at an OATS deployment —
-the directory (the operator's choice) holding `oats-local.yaml` and `agents/`.
+The app opens the workspaces you had open, plus the directory it was
+launched with (`--dir`, or the folder it was started from) when that is an
+OATS deployment — the directory (the operator's choice) holding
+`oats-local.yaml` and `agents/`. A folder that is not a deployment is never
+opened: started from Finder, with nothing open to restore, the window shows
+the workspace switcher instead. It lists the deployments on this computer
+under **On this computer** (those directly inside `~/Agents`, and a saved
+one that is not open); click one to open it in this window. **Add local
+workspace… → Browse** points it at any other deployment.
 A picked folder without `oats-local.yaml` is offered onboarding instead. The
 Desktop never parses the deployment: its members, lock state and header come
 from `oats workspace status`, and its instances from the deployment's one
@@ -246,6 +251,21 @@ any other exit code. Closing the tab ends the reconnecting. Reconnecting
 never stops or restarts the agent on the server: only the local ssh viewer
 ends.
 
+## Copy from a terminal
+
+Drag over an agent's output to select it. When you release the mouse, the
+selection is copied to the clipboard, ready to paste anywhere. ⌘C, Edit › Copy
+and the right-click menu then copy nothing new: the text is already there. The
+selection is tmux's own (copy mode), so it can run past the visible screen
+into the scrollback, and tmux sends its copy to the Desktop, which writes it to
+the clipboard. Nothing in a terminal can read the clipboard.
+
+If the agent's program uses the mouse itself, the drag goes to it instead. Hold
+**Option** (macOS) or **Shift** while dragging to select in the terminal itself,
+then copy with ⌘C or the right-click menu. If your `~/.tmux.conf` sets
+`set-clipboard off`, tmux keeps its copies to itself: use Option-drag. ⌘V
+pastes into the agent's draft as before.
+
 ## Attach files and screenshots
 
 Drop a file onto an agent terminal to insert its path into that agent's draft.
@@ -284,7 +304,7 @@ error in the terminal. Each drop/paste accepts up to 16 files totaling 25 MB.
 | "Compatible oats CLI required" card | No CLI, or a version outside the range the card itself states. Copy the card's install command, or **Choose oats…** to point at the right binary; **Retry** re-probes. Spawn is disabled until a compatible CLI is verified. |
 | Spawn disabled, no card | The probe hasn't settled yet (transient, resolves in ms). If it persists, the backend is unreachable — restart the app. |
 | Terminals fail to open ("could not attach") | tmux missing, or no live session for that instance. Install tmux (`tmux -V`); check `tmux ls`. |
-| Can't select/copy text in a terminal tab | The terminal runs with tmux mouse handling, so a plain drag scrolls/passes through. Hold **Option** (macOS) or **Shift** while dragging to make a local selection, then copy (Cmd+C / right-click → Copy). |
+| Can't select/copy text in a terminal tab | A plain drag copies on release ([Copy from a terminal](#copy-from-a-terminal)). If nothing reaches the clipboard, the program in the pane has the mouse, or your tmux config sets `set-clipboard off`: hold **Option** (macOS) or **Shift** while dragging, then copy (Cmd+C / right-click → Copy). |
 | macOS "app is damaged / can't be opened" | Ad-hoc-signed (not notarized) build + quarantine. Right-click → Open, or clear the quarantine attribute (above). If it persists, verify the bundle: `codesign --verify --deep --strict --verbose=2 "/Applications/OATS Desktop.app"` — a non-zero exit means a broken artifact, report it. |
 | Roster empty | The opened directory isn't an OATS deployment (it needs `oats-local.yaml` and `agents/`). Use the workspace switcher → Add workspace to select the right folder. |
 

package/docs/integrations.md

@@ -41,7 +41,7 @@ arrives from.
 # oats-workspace.yaml: one default per slot, for every soul
 packages:
   oats.okf: v4.1.1
-  oats.aweb: v1.19.0
+  oats.aweb: v1.20.0
   oats.linear: v1.0.1
   oats.jira: v1.0.1
 defaults:
@@ -89,7 +89,10 @@ operations in full.
   `knowledge-maintainer` package soul reviews the resulting PRs.
 - **`oats.aweb`** mints a messaging identity for each instance at spawn and
   removes it at retire, contributes the aweb messaging skills, and wires the
-  channel so sessions are woken by mail. `oats aweb roster` lists the team.
+  channel so sessions are woken by mail. `oats aweb roster` lists the team:
+  its membership certificates and workspaces, one entry per alias with its
+  sources, status and kind (global identities first), and says when either
+  source is incomplete.
 - **`oats.jira`** teaches the `jira-tasks` protocol and adds an advisory spawn
   hook that names the configured site and project.
 - **`oats.linear`** provides JSON-first `oats linear` commands, the

package/docs/official-catalog.md

@@ -11,7 +11,7 @@ or workspace membership alone does not make a package official.
 |---|---|---|---|
 | `oats.framework` | `oats-framework/v1.5.0` (this repository) | `oats.core`, `oats.setup`, `oats.knowledge-theory` | `knowledge-theory-expert` |
 | `oats.okf` | `v4.1.1` | `oats.okf` (knowledge), `oats.okf-harvest`, `oats.okf-maintenance` | `knowledge-harvester`, `knowledge-maintainer` |
-| `oats.aweb` | `v1.19.0` | `oats.aweb` (messaging) | |
+| `oats.aweb` | `v1.20.0` | `oats.aweb` (messaging) | |
 | `oats.engineering` | `v1.5.0` | `oats.engineering-expert`, `oats.developer`, `oats.code-review` | `code-reviewer` |
 | `oats.authoring` | `v1.0.3` | `oats.authoring` | |
 | `oats.jira` | `v1.0.1` | `oats.jira` (tasks) | |

package/docs/packages.md

@@ -76,7 +76,7 @@ members:
 packages:
   oats.framework: v1.5.0
   oats.okf: v4.1.1
-  oats.aweb: v1.19.0
+  oats.aweb: v1.20.0
 teams:
   platform: { team: "platform:acme.aweb.ai", description: Platform engineering }
 defaults:
@@ -134,7 +134,7 @@ Declaring a package in the workspace's `packages:` is the trust decision
 ## `oats package add | remove`
 
 ```bash
-oats package add oats.aweb v1.19.0                         # a catalog version
+oats package add oats.aweb v1.20.0                         # a catalog version
 oats package add acme.tools git:github.com/acme/tools@v0.4.0
 oats package remove acme.tools
 ```

package/docs/release-notes/v0.38.1.md

@@ -0,0 +1,50 @@
+# OATS 0.38.1
+
+## Changed
+
+- **oats.aweb 1.20.0: `oats aweb roster` lists who is on the team and says
+  what each entry is** (awebai/oats-aweb#46). The roster printed only the
+  team's membership certificates (`aw id team members`). That listing omits
+  identities the registry does not list, such as a team's retained global
+  coordinator and dashboard humans. It also listed deployment roots and
+  certificates with no workspace exactly like agents. The roster is now the
+  union of those certificates and the team's workspace presence
+  (`aw workspace status`), read from the minting root. Each entry has its
+  sources (`certificate`, `presence` or both), its status (active, when last
+  seen, or `certificate only: no workspace record`) and a kind:
+  - `global identity`, from the identity scope, listed first;
+  - `human` and `hosted agent`, from the session context;
+  - `instance` and `deployment root`, from the workspace path;
+  - `unknown`.
+  An inferred kind says so, and nothing is called retired. aw does not mark a
+  team's coordinator, and the roster says so. When a source cannot be read,
+  or presence is past its 200-workspace cap, the roster still lists what it
+  has and says it is incomplete. `oats aweb roster --json` is now an oats.aweb
+  document (`{team, members, certificatesComplete, presenceComplete,
+  problems}`) instead of aw's raw listing. The oats-aweb skill, the inject
+  and the spawn brief say what the roster shows and what it can't tell you.
+
+## Fixed
+
+- **The Desktop opened from Finder no longer shows `/` as its workspace**
+  (awebai/oats#518). A Finder launch starts in `/`, and when no saved
+  workspace was a deployment, the Desktop served `/`. It titled the window
+  `/`, showed `E_NO_DEPLOYMENT` in Instances, and remembered `/` in
+  `windows.json` for every later launch. A folder that is not a deployment is
+  now never served, bound to a window or saved. With no deployment to open,
+  the window opens on the workspace switcher, which lists the deployments
+  directly inside `~/Agents` under "On this computer": one click opens one in
+  that window. A window remembered on `/` is forgotten at launch.
+
+- **A window with no workspace lists the workspaces served after it opened**
+  (awebai/oats#521). Its choices were fixed when it opened, so remote
+  workspaces arriving a few seconds after launch never appeared and the
+  switcher said "No workspace choices reported."
+
+- **Copying an agent's output in the Desktop** (awebai/oats#520). A plain
+  drag over a terminal now selects the text (tmux's copy mode, so it can
+  reach into the scrollback) and copies it to the clipboard on release;
+  ⌘C, Edit › Copy and the right-click menu find it there. The Desktop takes
+  tmux's copies (OSC 52) write-only: nothing in a terminal can read the
+  clipboard. Remote terminals (`oats session attach --server`) bind the same
+  drag. ⌘V is unchanged; Option-drag still makes a terminal-only selection.

package/docs/release-notes/v0.38.2.md

@@ -0,0 +1,13 @@
+# OATS 0.38.2
+
+## Fixed
+
+- **The Desktop's Start and Restart dialog no longer stays open after the
+  launch** (awebai/oats#525). Since 0.36.0 the dialog's wait for the
+  terminal never recognised the started instance's row, so every Start or
+  Restart ended on "no running harness was observed" with the dialog left
+  open, while the harness (for Claude Code under channel delivery, its
+  development-channels confirmation) waited unseen. The dialog now closes
+  as soon as the launch is accepted, and the instance's terminal opens once
+  its row is ready, showing whatever the harness shows first. A refused
+  launch keeps the dialog with its error.

package/lib/session-viewer.mjs

@@ -27,6 +27,7 @@ export function prepareSessionViewer(target, { exec = execFileSync } = {}) {
     run(["set-option", "-t", viewer, "status", "off"]);
     run(["unbind-key", "-a", "-q", "-T", "oatsview-locked"]);
     run(["bind-key", "-T", "oatsview-locked", "WheelUpPane", "if-shell", "-F", "#{||:#{pane_in_mode},#{mouse_any_flag}}", "send-keys -M", "copy-mode -e; send-keys -M"]);
+    run(["bind-key", "-T", "oatsview-locked", "MouseDrag1Pane", "if-shell", "-F", "#{||:#{pane_in_mode},#{mouse_any_flag}}", "send-keys -M", "copy-mode -M"]);
     run(["set-option", "-t", viewer, "mouse", "on"]);
     const env = { ...process.env }; delete env.TMUX;
     return { binary: "tmux", args: ["-u", "-S", target.socket, "attach-session", "-t", `=${viewer}`], env, cleanup };

package/package-catalog.json

@@ -8,7 +8,7 @@
     },
     "oats.aweb": {
       "url": "https://github.com/awebai/oats-aweb.git",
-      "ref": "v1.19.0",
+      "ref": "v1.20.0",
       "path": "oats-package"
     },
     "oats.jira": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awebai/oats",
-  "version": "0.38.0",
+  "version": "0.38.2",
   "description": "OATS (Open Agent Team Specification) — durable souls, disposable instances, targetable capability packages, and the runtime-neutral oats CLI/kernel.",
   "keywords": [
     "agents",