@lattices/cli 0.3.0 → 0.4.0

package/docs/api.md

@@ -112,7 +112,10 @@ const win = await daemonCall('windows.get', { wid: 1234 })
 
 // Mutations
 await daemonCall('session.launch', { path: '/Users/you/dev/myapp' })
-await daemonCall('window.tile', { session: 'myapp-a1b2c3', position: 'left' })
+await daemonCall('window.place', {
+  session: 'myapp-a1b2c3',
+  placement: { kind: 'tile', value: 'left' }
+})
 
 // Custom timeout (default: 3000ms)
 await daemonCall('projects.scan', null, 10000)
@@ -190,6 +193,12 @@ Useful for agent self-discovery.
 
 **Params**: none
 
+CLI shortcut:
+
+```bash
+lattices call api.schema
+```
+
 #### `diagnostics.list`
 
 Return recent diagnostic log entries from the daemon.
@@ -210,13 +219,15 @@ Return recent diagnostic log entries from the daemon.
 | `windows.get` | read | Single window by ID |
 | `windows.search` | read | Search windows by query |
 | `spaces.list` | read | macOS display spaces |
-| `window.tile` | write | Tile a window to a position |
+| `window.place` | write | Place a window or session using a typed placement spec |
+| `window.tile` | write | Compatibility wrapper for session tiling |
 | `window.focus` | write | Focus a window / switch Spaces |
 | `window.move` | write | Move a window to another Space |
 | `window.assignLayer` | write | Tag a window to a layer |
 | `window.removeLayer` | write | Remove a window's layer tag |
 | `window.layerMap` | read | All window→layer assignments |
-| `layout.distribute` | write | Distribute windows evenly |
+| `space.optimize` | write | Optimize a set of windows using an explicit scope and strategy |
+| `layout.distribute` | write | Compatibility wrapper for visible-window balancing |
 
 #### `windows.list`
 
@@ -263,17 +274,50 @@ Get a single window by its CGWindowID.
 
 #### `windows.search`
 
-Search windows by text query, including OCR content.
+Search windows by text query across title, app name, session tags, and OCR content. Returns results with `matchSource` indicating how the match was found, and `ocrSnippet` for OCR matches.
 
 **Params**:
 
 | Field   | Type   | Required | Description                    |
 |---------|--------|----------|--------------------------------|
-| `query` | string | yes      | Search query (matches title, app, OCR text) |
+| `query` | string | yes      | Search query (matches title, app, session, OCR text) |
 | `ocr`   | boolean| no       | Include OCR text in search (default true) |
-| `limit` | number | no       | Max results (default 20)       |
+| `limit` | number | no       | Max results (default 50)       |
+
+**Returns**: array of window objects with additional search fields:
+
+```json
+[
+  {
+    "wid": 265,
+    "app": "iTerm2",
+    "title": "✳ Claude Code",
+    "matchSource": "ocr",
+    "ocrSnippet": "…~/dev/vox StatusBarIconFolder…",
+    "frame": { "x": 688, "y": 3, "w": 1720, "h": 720 },
+    "isOnScreen": true
+  }
+]
+```
 
-**Returns**: array of window objects matching the query.
+`matchSource` values: `"title"`, `"app"`, `"session"`, `"ocr"`.
+
+**CLI usage**:
+
+```bash
+# Basic search (uses windows.search)
+lattices search vox
+
+# Deep search — adds terminal tab/process inspection for ranking
+lattices search vox --deep
+
+# Pipeable output
+lattices search vox --wid
+lattices search vox --json
+
+# Search + focus + tile in one step
+lattices place vox right
+```
 
 #### `spaces.list`
 
@@ -297,20 +341,53 @@ List macOS display spaces (virtual desktops).
 ]
 ```
 
-#### `window.tile`
+#### `window.place`
 
-Tile a session's terminal window to a screen position.
+Canonical window placement mutation. Use this when an agent needs a
+single, typed placement contract across voice, CLI, and daemon clients.
 
 **Params**:
 
-| Field      | Type   | Required | Description                         |
-|------------|--------|----------|-------------------------------------|
-| `session`  | string | yes      | Session name                        |
-| `position` | string | yes      | Tile position (see below)           |
+| Field       | Type            | Required | Description                              |
+|-------------|-----------------|----------|------------------------------------------|
+| `wid`       | number          | no       | Target window ID                          |
+| `session`   | string          | no       | Target lattices session                   |
+| `app`       | string          | no       | Target app name                           |
+| `title`     | string          | no       | Optional title substring for app matching |
+| `display`   | number          | no       | Target display index                      |
+| `placement` | string \| object | yes     | Placement shorthand or typed object       |
+
+Target resolution priority is `wid` → `session` → `app/title` → frontmost window.
 
-**Positions**: `left`, `right`, `top`, `bottom`, `top-left`, `top-right`,
+**Placement strings**: `left`, `right`, `top`, `bottom`, `top-left`, `top-right`,
 `bottom-left`, `bottom-right`, `left-third`, `center-third`, `right-third`,
-`maximize`, `center`
+`top-third`, `middle-third`, `bottom-third`, `left-quarter`, `right-quarter`,
+`top-quarter`, `bottom-quarter`, `maximize`, `center`, or `grid:CxR:C,R`.
+
+**Typed placement examples**:
+
+```json
+{ "kind": "tile", "value": "top-right" }
+{ "kind": "grid", "columns": 3, "rows": 2, "column": 2, "row": 0 }
+{ "kind": "fractions", "x": 0.5, "y": 0, "w": 0.5, "h": 1 }
+```
+
+**Returns**: execution receipt including resolved target, placement, and trace.
+
+#### `window.tile`
+
+Compatibility wrapper for `window.place` when the target is a lattices
+session window.
+
+**Params**:
+
+| Field      | Type   | Required | Description                             |
+|------------|--------|----------|-----------------------------------------|
+| `session`  | string | yes      | Session name                            |
+| `position` | string | yes      | Placement shorthand or grid syntax      |
+
+This method exists for compatibility. New integrations should prefer
+`window.place`.
 
 #### `window.focus`
 
@@ -375,9 +452,31 @@ Return all current window→layer assignments.
 
 Keys are CGWindowIDs (as strings), values are layer IDs.
 
+#### `space.optimize`
+
+Canonical space-balancing mutation. Use this when the goal is to make
+the current workspace coherent rather than placing one specific window.
+
+**Params**:
+
+| Field       | Type     | Required | Description                                         |
+|-------------|----------|----------|-----------------------------------------------------|
+| `scope`     | string   | no       | `visible`, `active-app`, `app`, or `selection`      |
+| `strategy`  | string   | no       | `balanced` or `mosaic`                              |
+| `app`       | string   | no       | App name for `app` scope                            |
+| `title`     | string   | no       | Optional title substring for app matching           |
+| `windowIds` | number[] | no       | Explicit window IDs for `selection` scope           |
+
+If `windowIds` is provided, scope is inferred as `selection`.
+If `app` is provided and `scope` is omitted, scope is inferred as `app`.
+
+**Returns**: execution receipt including resolved scope, strategy,
+affected window IDs, and trace.
+
 #### `layout.distribute`
 
-Distribute all visible lattices windows evenly across the screen.
+Compatibility wrapper for `space.optimize` with `scope=visible` and
+`strategy=balanced`.
 
 **Params**: none
 
@@ -512,7 +611,8 @@ Restart a specific pane's process within a session.
 | `projects.list` | read | Discovered projects |
 | `projects.scan` | write | Re-scan project directory |
 | `layers.list` | read | Workspace layers and active index |
-| `layer.switch` | write | Switch workspace layer |
+| `layer.activate` | write | Activate a workspace layer using an explicit mode |
+| `layer.switch` | write | Compatibility wrapper for launch-style layer activation |
 | `group.launch` | write | Launch a tab group |
 | `group.kill` | write | Kill a tab group |
 
@@ -569,20 +669,33 @@ List configured workspace layers and the active index.
 
 Returns empty `layers` array if no workspace config is loaded.
 
-#### `layer.switch`
+#### `layer.activate`
 
-Switch the active workspace layer. Focuses and tiles all windows in the
-target layer, launches any projects that aren't running yet, and posts
-a `layer.switched` event.
+Canonical layer mutation. Use this when an agent wants an explicit
+activation mode instead of implicit "switch" behavior.
 
 **Params**:
 
-| Field   | Type   | Required | Description                    |
-|---------|--------|----------|--------------------------------|
-| `index` | number | no       | Layer index (0-based)          |
-| `name`  | string | no       | Layer ID or label              |
+| Field   | Type   | Required | Description                                 |
+|---------|--------|----------|---------------------------------------------|
+| `index` | number | no       | Layer index (0-based)                       |
+| `name`  | string | no       | Layer ID or label                           |
+| `mode`  | string | no       | `launch`, `focus`, or `retile`              |
+
+Provide either `index` or `name`.
 
-Provide either `index` or `name`. If both are given, `name` takes priority.
+**Modes**:
+
+- `launch` — bring up the layer, launching missing projects and retiling
+- `focus` — raise the layer's windows in place
+- `retile` — re-apply the layer layout without launch semantics
+
+**Returns**: execution receipt including resolved layer, mode, and trace.
+
+#### `layer.switch`
+
+Compatibility wrapper for `layer.activate` with `mode=launch`.
+It keeps the old semantics and still posts a `layer.switched` event.
 
 #### `group.launch`
 
@@ -839,13 +952,19 @@ project knows how to control the workspace:
 This project uses lattices for workspace management. The daemon API
 is available at ws://127.0.0.1:9399.
 
-### Available commands
-- List windows: `daemonCall('windows.list')`
-- List sessions: `daemonCall('tmux.sessions')`
+### Search (find windows)
+- Search by content: `daemonCall('windows.search', { query: 'myproject' })`
+  Returns windows with `matchSource` ("title", "app", "session", "ocr") and `ocrSnippet`
+- Search terminals: `daemonCall('terminals.search', {})` — tabs, cwds, processes
+- CLI: `lattices search myproject` or `lattices search myproject --deep`
+
+### Actions
+- Focus a window: `daemonCall('window.focus', { wid: 1234 })`
+- Place a window: `daemonCall('window.place', { session: 'name', placement: 'left' })`
 - Launch a project: `daemonCall('session.launch', { path: '/absolute/path' })`
-- Tile a window: `daemonCall('window.tile', { session: 'name', position: 'left' })`
-- Switch layer: `daemonCall('layer.switch', { index: 0 })`
-- Switch layer by name: `daemonCall('layer.switch', { name: 'web' })`
+- Activate a layer: `daemonCall('layer.activate', { name: 'web', mode: 'launch' })`
+- Optimize the workspace: `daemonCall('space.optimize', { scope: 'visible', strategy: 'balanced' })`
+- CLI: `lattices place myproject left` (search + focus + tile in one step)
 
 ### Import
 \```js
@@ -872,8 +991,8 @@ const sessions = await daemonCall('tmux.sessions')
 const fe = sessions.find(s => s.name.startsWith('frontend'))
 const api = sessions.find(s => s.name.startsWith('api'))
 
-await daemonCall('window.tile', { session: fe.name, position: 'left' })
-await daemonCall('window.tile', { session: api.name, position: 'right' })
+await daemonCall('window.place', { session: fe.name, placement: 'left' })
+await daemonCall('window.place', { session: api.name, placement: 'right' })
 ```
 
 ### Reactive event pattern

package/docs/app.md

@@ -143,10 +143,21 @@ highlight around it for ~1 second so you can spot it immediately.
 Grant Screen Recording and Accessibility permissions in System
 Settings > Privacy & Security for all three paths to work.
 
+## Voice commands
+
+> See [Voice Commands](/docs/voice) for the full guide.
+
+Press **Hyper+3** to open the voice command window. Hold **Option** to
+speak, release to stop. Lattices transcribes via Vox, matches to an
+intent, and executes. Built-in commands: find, show, open, tile, kill, scan.
+
+A Claude Haiku advisor runs in parallel, offering follow-up suggestions
+in the AI corner. Configure the model and budget in Settings > AI.
+
 ## Settings
 
 Open via the command palette or the gear icon in the main view.
-The settings window has three tabs:
+The settings window has four tabs:
 
 ### General
 
@@ -162,6 +173,17 @@ The settings window has three tabs:
   (helpful while getting used to tmux)
 - **Auto** — detaches sessions automatically (fewer prompts)
 
+### AI
+
+| Setting              | Default        | Description                              |
+|----------------------|----------------|------------------------------------------|
+| Claude CLI path      | Auto-detected  | Path to `claude` binary                  |
+| Advisor model        | Haiku          | `haiku` (fast) or `sonnet` (smarter)     |
+| Budget per session   | $0.50          | Max spend per Claude CLI invocation      |
+
+Shows live session stats: context usage %, session cost, and learned
+pattern count.
+
 ### Shortcuts
 
 Shows keyboard shortcut reference:
@@ -169,6 +191,12 @@ Shows keyboard shortcut reference:
 | Shortcut          | Action              |
 |-------------------|----------------------|
 | Cmd+Shift+M       | Open command palette |
+| Hyper+1            | Screen map           |
+| Hyper+2            | Window bezel         |
+| Hyper+3            | Voice commands       |
+| Hyper+4            | Desktop inventory    |
+| Hyper+5            | Omni search          |
+| Hyper+6            | Cheat sheet          |
 | Cmd+Option+1/2/3  | Switch workspace layer |
 | Ctrl+B  D         | Detach from session  |
 | Ctrl+B  X         | Kill current pane    |

package/docs/config.md

@@ -141,9 +141,13 @@ Run `lattices init` in your project directory to generate a starter
 | `lattices windows [--json]`  | List all visible windows                          |
 | `lattices window assign <wid> <layer>` | Tag a window to a layer                |
 | `lattices window map [--json]` | Show all window→layer assignments                |
+| `lattices search <query>`      | Search windows by title, app, session, OCR       |
+| `lattices search <q> --deep`   | Deep search: index + live terminal inspection    |
+| `lattices search <q> --wid`    | Print matching window IDs only (pipeable)        |
+| `lattices place <query> [pos]` | Deep search + focus + tile (default: bottom-right)|
+| `lattices focus <session>`   | Focus a session's window and switch Spaces        |
 | `lattices scan search <query>` | Search indexed screen text                       |
 | `lattices diag [limit]`       | Show recent diagnostic entries                   |
-| `lattices focus <session>`   | Focus a session's window and switch Spaces        |
 | `lattices app`               | Launch the menu bar companion app                 |
 | `lattices app build`         | Rebuild the menu bar app from source              |
 | `lattices app restart`       | Rebuild and relaunch the menu bar app             |

package/docs/handsoff-test-scenarios.md

@@ -0,0 +1,84 @@
+# Hands-Off Mode — Test Scenarios
+
+Press Ctrl+Cmd+M, say the phrase, press Ctrl+Cmd+M again. Check the result.
+
+## 1. Basic awareness
+
+| # | Say | Expected | Check |
+|---|-----|----------|-------|
+| 1.1 | "What's the frontmost window?" | Names the app + project/title, no wid | Correct window? No numbers? |
+| 1.2 | "How many monitors do I have?" | Correct count + sizes | Matches reality? |
+| 1.3 | "What terminals do I have open?" | Lists terminals with projects/cwds | Does it know the projects? |
+| 1.4 | "Which ones are running Claude Code?" | Lists only Claude terminals + their projects | Correct? Uses hasClaude? |
+| 1.5 | "What's on my second monitor?" | Describes windows on the non-main display | Correct display? |
+
+## 2. Simple tiling
+
+| # | Say | Expected | Check |
+|---|-----|----------|-------|
+| 2.1 | "Tile Chrome left" | Chrome moves to left half | Did it move? Spoken confirmation? |
+| 2.2 | "Put iTerm on the right" | iTerm moves to right half | Correct window? |
+| 2.3 | "Maximize this window" | Frontmost window maximizes | Right window? |
+| 2.4 | "Center the Finder window" | Finder centers | Correct? |
+
+## 3. Multi-window layouts
+
+| # | Say | Expected | Check |
+|---|-----|----------|-------|
+| 3.1 | "Split Chrome and iTerm" | Chrome left, iTerm right | Both move? Spoken narration? |
+| 3.2 | "Put everything in a grid" | distribute intent fires | Windows arrange? |
+| 3.3 | "Thirds with Chrome, iTerm, and Finder" | Three apps in left/center/right thirds | Correct apps + positions? |
+| 3.4 | "Quadrants" | Four windows in corners | Reasonable choices? |
+
+## 4. Focus + switching
+
+| # | Say | Expected | Check |
+|---|-----|----------|-------|
+| 4.1 | "Focus on Slack" | Slack comes to front | Did it switch? |
+| 4.2 | "Switch to Chrome" | Chrome comes to front | Correct? |
+| 4.3 | "Go to the lattices terminal" | Focuses the iTerm in ~/dev/lattices | Right terminal? |
+| 4.4 | "Show me the Hudson Claude Code" | Focuses iTerm with hasClaude + cwd hudson | Correct? |
+
+## 5. Conversational context
+
+| # | Say | Expected | Check |
+|---|-----|----------|-------|
+| 5.1 | "Tile Chrome left" then "Now put iTerm on the right" | Two separate turns, both work | Context from turn 1 used? |
+| 5.2 | "Tile Chrome left" then "Swap them" | Chrome right, iTerm left | Understood "them"? |
+| 5.3 | "What terminals do I have?" then "Organize those" | Lists, then distributes the terminals | Connected the turns? |
+| 5.4 | "Put it back" (after any tiling) | Reverses last action | Worked? (may not be supported yet) |
+
+## 6. Intelligence
+
+| # | Say | Expected | Check |
+|---|-----|----------|-------|
+| 6.1 | "Set up for coding" | Intelligent layout based on visible apps | Reasonable? Explained reasoning? |
+| 6.2 | "I'm going to do a code review" | Suggests/applies review layout | Smart choice? |
+| 6.3 | "Clean up my desktop" | Distributes or suggests organization | Actionable? |
+| 6.4 | "Too many windows, simplify" | Suggests hiding some, focuses key ones | Reasonable? |
+
+## 7. Error handling
+
+| # | Say | Expected | Check |
+|---|-----|----------|-------|
+| 7.1 | "Focus on Firefox" | "I don't see Firefox. You have Chrome and Safari." | Honest? Names real apps? |
+| 7.2 | "Tile the Photoshop window" | "Photoshop isn't open right now." | No hallucination? |
+| 7.3 | (mumble something unclear) | "I didn't catch that. Can you say it again?" | Graceful? |
+
+## 8. Actions actually execute
+
+| # | Say | Expected | Check |
+|---|-----|----------|-------|
+| 8.1 | "Distribute my windows" | spoken + distribute action | Actions array not empty? |
+| 8.2 | "Organize my terminals" | spoken + distribute or tile actions | Actions actually fire? |
+| 8.3 | Any action command | Hear narration BEFORE windows move | Sequence correct? |
+
+## Scoring
+
+For each test:
+- ✅ Works correctly
+- ⚠️ Partially works (note what's wrong)
+- ❌ Broken (note error)
+- 🔇 No audio feedback
+
+Track in a copy of this file or in the terminal.

package/docs/layers.md

@@ -28,13 +28,13 @@ Add `groups` to `~/.lattices/workspace.json`:
   "name": "my-setup",
   "groups": [
     {
-      "id": "talkie",
-      "label": "Talkie",
+      "id": "vox",
+      "label": "Vox",
       "tabs": [
-        { "path": "/Users/you/dev/talkie-ios", "label": "iOS" },
-        { "path": "/Users/you/dev/talkie-macos", "label": "macOS" },
-        { "path": "/Users/you/dev/talkie-web", "label": "Website" },
-        { "path": "/Users/you/dev/talkie-api", "label": "API" }
+        { "path": "/Users/you/dev/vox-ios", "label": "iOS" },
+        { "path": "/Users/you/dev/vox-macos", "label": "macOS" },
+        { "path": "/Users/you/dev/vox-web", "label": "Website" },
+        { "path": "/Users/you/dev/vox-api", "label": "API" }
       ]
     }
   ]
@@ -46,10 +46,10 @@ to per-project configs.
 
 ### How it works
 
-- Session name follows the pattern `lattices-group-<id>` (e.g. `lattices-group-talkie`)
+- Session name follows the pattern `lattices-group-<id>` (e.g. `lattices-group-vox`)
 - 1 group = 1 tmux session. Each tab is a tmux window, and each window
   gets its own panes from that project's `.lattices.json`
-- You can still launch projects independently: `cd talkie-ios && lattices`
+- You can still launch projects independently: `cd vox-ios && lattices`
   creates its own standalone session as before
 
 ### Tab group fields
@@ -73,9 +73,9 @@ lattices tab <group> [tab]  # Switch tab by label or index
 Examples:
 
 ```bash
-lattices group talkie       # Launch all Talkie tabs
-lattices tab talkie iOS     # Switch to the iOS tab
-lattices tab talkie 0       # Switch to first tab (by index)
+lattices group vox       # Launch all Vox tabs
+lattices tab vox iOS     # Switch to the iOS tab
+lattices tab vox 0       # Switch to first tab (by index)
 ```
 
 ### Menu bar app
@@ -151,7 +151,7 @@ fields instead of `path`:
       "label": "Main",
       "projects": [
         { "app": "Google Chrome", "title": "GitHub", "tile": "left" },
-        { "app": "Talkie", "tile": "top-right", "launch": "open -a Talkie" },
+        { "app": "Vox", "tile": "top-right", "launch": "open -a Vox" },
         { "path": "/Users/you/dev/frontend", "tile": "bottom-right" }
       ]
     },
@@ -182,11 +182,11 @@ This lets you tile a whole group into a screen position:
   "name": "my-setup",
   "groups": [
     {
-      "id": "talkie",
-      "label": "Talkie",
+      "id": "vox",
+      "label": "Vox",
       "tabs": [
-        { "path": "/Users/you/dev/talkie-ios", "label": "iOS" },
-        { "path": "/Users/you/dev/talkie-web", "label": "Website" }
+        { "path": "/Users/you/dev/vox-ios", "label": "iOS" },
+        { "path": "/Users/you/dev/vox-web", "label": "Website" }
       ]
     }
   ],
@@ -195,7 +195,7 @@ This lets you tile a whole group into a screen position:
       "id": "main",
       "label": "Main",
       "projects": [
-        { "group": "talkie", "tile": "top-left" },
+        { "group": "vox", "tile": "top-left" },
         { "path": "/Users/you/dev/design-system", "tile": "right" }
       ]
     }
@@ -204,7 +204,7 @@ This lets you tile a whole group into a screen position:
 ```
 
 When switching to this layer, lattices launches (or focuses) the
-"talkie" group session and tiles it to the top-left quarter, alongside
+"vox" group session and tiles it to the top-left quarter, alongside
 the design-system project on the right.
 
 ### Layer fields
@@ -340,7 +340,7 @@ header and search field in the menu bar panel:
 ```json
 {
   "projects": [
-    { "path": "/Users/you/dev/talkie" }
+    { "path": "/Users/you/dev/vox" }
   ]
 }
 ```
@@ -374,7 +374,7 @@ No `tile` — just focuses the window wherever it is.
 ```json
 {
   "projects": [
-    { "group": "talkie", "tile": "left" },
+    { "group": "vox", "tile": "left" },
     { "path": "/Users/you/dev/api", "tile": "right" }
   ]
 }

package/docs/ocr.md

@@ -59,17 +59,26 @@ contextual snippets.
 ### From the CLI
 
 ```bash
+# Search windows by title, app, session, and OCR content
+lattices search "error"
+
+# Deep search — also inspects terminal tabs and processes
+lattices search "myproject" --deep
+
+# Search + focus + tile the top result
+lattices place "myproject" left
+
 # View current OCR snapshot
-lattices ocr
+lattices scan
 
-# Search OCR history
-lattices ocr search "error OR failed"
+# Search OCR history directly (FTS5 syntax)
+lattices scan search "error OR failed"
 
 # Trigger an immediate deep scan
-lattices ocr scan
+lattices scan deep
 
 # View OCR history for a specific window ID
-lattices ocr history 12345
+lattices scan history 12345
 ```
 
 ### From the agent API

package/docs/overview.md

@@ -65,7 +65,10 @@ Agents get the same control programmatically:
 ```js
 import { daemonCall } from '@lattices/cli'
 await daemonCall('session.launch', { path: '/Users/you/dev/frontend' })
-await daemonCall('window.tile', { session: 'frontend-a1b2c3', position: 'left' })
+await daemonCall('window.place', {
+  session: 'frontend-a1b2c3',
+  placement: { kind: 'tile', value: 'left' }
+})
 ```
 
 ## Who it's for
@@ -91,4 +94,5 @@ await daemonCall('window.tile', { session: 'frontend-a1b2c3', position: 'left' }
 - [Configuration](/docs/config): `.lattices.json` format and CLI commands
 - [Screen scanning](/docs/ocr): AX text extraction, Vision OCR, and full-text search
 - [Concepts](/docs/concepts): architecture, glossary, and how it all works
+- [Agent Guide](/docs/agents): canonical action contracts for voice, CLI, and daemon clients
 - [Agent API](/docs/api): RPC method reference for agents and scripts