pi-umbra 0.1.2 → 0.1.4

package/node_modules/pi-umbra-ask/README.md

@@ -1,6 +1,18 @@
 # pi-umbra-ask
 
-A tool the model can call to ask you a question mid-turn. Answers are stripped of control and bidi characters before any renderer sees them.
+A tool the model can call to ask you a question mid-turn, instead of guessing or stopping.
+
+pi gives a model no way to put a question on screen and wait for the answer. Without one,
+an agent that reaches a fork either picks for you or ends the turn to ask, and both cost
+more than the question would have. This registers that tool.
+
+The questionnaire takes single or multiple choice. Layout is one column per element, so a
+row is exactly as wide checked as unchecked and nothing drifts when a glyph changes. There
+is no cursor column: the row under the cursor is coloured instead, which costs no width and
+cannot fall out of alignment.
+
+Answers are stripped of control and bidi characters before any renderer sees them, so an
+answer cannot rewrite the screen around it.
 
 ```
 pi-umbra-ask/

package/node_modules/pi-umbra-ask/package.json

@@ -1,37 +1,37 @@
-{
-  "name": "pi-umbra-ask",
-  "version": "0.1.0",
-  "description": "A tool the model can call to ask you a question mid-turn. Answers are stripped of control and bidi characters before any renderer sees them.",
-  "keywords": [
-    "pi-package",
-    "pi-extension",
-    "tool",
-    "prompt"
-  ],
-  "author": "grkn",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/grknbyk/pi-umbra.git",
-    "directory": "pi-umbra-ask"
-  },
-  "homepage": "https://github.com/grknbyk/pi-umbra/tree/main/pi-umbra-ask#readme",
-  "bugs": "https://github.com/grknbyk/pi-umbra/issues",
-  "type": "module",
-  "files": [
-    "extensions",
-    "lib",
-    "checks",
-    "README.md"
-  ],
-  "pi": {
-    "extensions": [
-      "./extensions"
-    ]
-  },
-  "peerDependencies": {
-    "@earendil-works/pi-ai": "*",
-    "@earendil-works/pi-coding-agent": "*",
-    "@earendil-works/pi-tui": "*"
-  }
-}
+{
+  "name": "pi-umbra-ask",
+  "version": "0.1.1",
+  "description": "A tool the model can call to ask you a question mid-turn. Answers are stripped of control and bidi characters before any renderer sees them.",
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "tool",
+    "prompt"
+  ],
+  "author": "grkn",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/grknbyk/pi-umbra.git",
+    "directory": "pi-umbra-ask"
+  },
+  "homepage": "https://github.com/grknbyk/pi-umbra/tree/main/pi-umbra-ask#readme",
+  "bugs": "https://github.com/grknbyk/pi-umbra/issues",
+  "type": "module",
+  "files": [
+    "extensions",
+    "lib",
+    "checks",
+    "README.md"
+  ],
+  "pi": {
+    "extensions": [
+      "./extensions"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
+  }
+}

package/node_modules/pi-umbra-copy-chat/README.md

@@ -1,6 +1,13 @@
 # pi-umbra-copy-chat
 
-/copy-chat puts the conversation on the clipboard.
+`/umb-copy-chat` puts the whole session on the clipboard as Markdown.
+
+pi has three commands nearby and none of them do this. `/export` writes HTML or JSONL to
+disk. `/copy` takes only the last message. `/share` uploads to a gist.
+
+This writes no file, spends no model turn and uploads nothing. Everything the session holds
+between the first user message and the last one goes to the clipboard, and that is the
+whole feature.
 
 ```
 pi-umbra-copy-chat/

package/node_modules/pi-umbra-copy-chat/package.json

@@ -1,32 +1,32 @@
-{
-  "name": "pi-umbra-copy-chat",
-  "version": "0.1.0",
-  "description": "/copy-chat puts the conversation on the clipboard.",
-  "keywords": [
-    "pi-package",
-    "pi-extension",
-    "clipboard"
-  ],
-  "author": "grkn",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/grknbyk/pi-umbra.git",
-    "directory": "pi-umbra-copy-chat"
-  },
-  "homepage": "https://github.com/grknbyk/pi-umbra/tree/main/pi-umbra-copy-chat#readme",
-  "bugs": "https://github.com/grknbyk/pi-umbra/issues",
-  "type": "module",
-  "files": [
-    "extensions",
-    "README.md"
-  ],
-  "pi": {
-    "extensions": [
-      "./extensions"
-    ]
-  },
-  "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "*"
-  }
-}
+{
+  "name": "pi-umbra-copy-chat",
+  "version": "0.1.1",
+  "description": "/copy-chat puts the conversation on the clipboard.",
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "clipboard"
+  ],
+  "author": "grkn",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/grknbyk/pi-umbra.git",
+    "directory": "pi-umbra-copy-chat"
+  },
+  "homepage": "https://github.com/grknbyk/pi-umbra/tree/main/pi-umbra-copy-chat#readme",
+  "bugs": "https://github.com/grknbyk/pi-umbra/issues",
+  "type": "module",
+  "files": [
+    "extensions",
+    "README.md"
+  ],
+  "pi": {
+    "extensions": [
+      "./extensions"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*"
+  }
+}

package/node_modules/pi-umbra-help/README.md

@@ -1,6 +1,15 @@
 # pi-umbra-help
 
-Two commands over the pi-umbra family: /umb-help lists what is installed and how to configure it, /umb-doctor reports the faults that would otherwise stay silent.
+`/umb-help` says what is installed and how to configure it. `/umb-doctor` says what is
+broken.
+
+Two commands rather than one, because they answer different questions and a help screen
+that also lists faults buries the faults.
+
+Neither reads a written-down list, so neither can drift out of date. Commands come from
+`pi.getCommands()`, patches from the bundle on disk, skill roots from the directories pi
+itself walks. Install or remove a package and both commands notice without anything here
+being edited.
 
 ```
 pi-umbra-help/

package/node_modules/pi-umbra-help/package.json

@@ -1,34 +1,37 @@
-{
-  "name": "pi-umbra-help",
-  "version": "0.1.0",
-  "description": "Two commands over the pi-umbra family: /umb-help lists what is installed and how to configure it, /umb-doctor reports the faults that would otherwise stay silent.",
-  "keywords": [
-    "pi-package",
-    "pi",
-    "pi-extension",
-    "help",
-    "doctor",
-    "diagnostics"
-  ],
-  "author": "grkn",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/grknbyk/pi-umbra.git",
-    "directory": "pi-umbra-help"
-  },
-  "homepage": "https://github.com/grknbyk/pi-umbra/tree/main/pi-umbra-help#readme",
-  "bugs": "https://github.com/grknbyk/pi-umbra/issues",
-  "files": [
-    "extensions",
-    "checks",
-    "lib",
-    "README.md",
-    "LICENSE"
-  ],
-  "pi": {
-    "extensions": [
-      "./extensions"
-    ]
-  }
-}
+{
+  "name": "pi-umbra-help",
+  "version": "0.1.2",
+  "description": "Two commands over the pi-umbra family: /umb-help lists what is installed and how to configure it, /umb-doctor reports the faults that would otherwise stay silent.",
+  "keywords": [
+    "pi-package",
+    "pi",
+    "pi-extension",
+    "help",
+    "doctor",
+    "diagnostics"
+  ],
+  "author": "grkn",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/grknbyk/pi-umbra.git",
+    "directory": "pi-umbra-help"
+  },
+  "homepage": "https://github.com/grknbyk/pi-umbra/tree/main/pi-umbra-help#readme",
+  "bugs": "https://github.com/grknbyk/pi-umbra/issues",
+  "files": [
+    "extensions",
+    "checks",
+    "lib",
+    "README.md",
+    "LICENSE"
+  ],
+  "pi": {
+    "extensions": [
+      "./extensions"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*"
+  }
+}

package/node_modules/pi-umbra-inputbar/README.md

@@ -1,6 +1,16 @@
 # pi-umbra-inputbar
 
-pi's input bar, rebuilt: a chevron prompt, the session name on the border, a colour you pick, and a command to rename the session.
+The input box, with the session name on its top border and a border colour you pick.
+
+In a stack of terminals every pi looks the same. The name on the border says which session
+this window is without opening anything, and the colour tells two of them apart from across
+the screen.
+
+`/umb-color` sets the colour and keeps it in `~/.pi/agent/input-color`. The name is read
+from `pi.getSessionName()` at every render, so a rename shows on the next repaint.
+
+Nothing here is patched. It rides on `ctx.ui.setEditorComponent` with a `CustomEditor`
+subclass, which is pi's own extension point for exactly this.
 
 ```
 pi-umbra-inputbar/

package/node_modules/pi-umbra-inputbar/package.json

@@ -1,33 +1,37 @@
-{
-  "name": "pi-umbra-inputbar",
-  "version": "0.1.0",
-  "description": "pi's input bar, rebuilt: a chevron prompt, the session name on the border, a colour you pick, and a command to rename the session.",
-  "keywords": [
-    "pi-package",
-    "pi",
-    "pi-extension",
-    "tui",
-    "editor",
-    "prompt"
-  ],
-  "author": "grkn",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/grknbyk/pi-umbra.git",
-    "directory": "pi-umbra-inputbar"
-  },
-  "homepage": "https://github.com/grknbyk/pi-umbra/tree/main/pi-umbra-inputbar#readme",
-  "bugs": "https://github.com/grknbyk/pi-umbra/issues",
-  "files": [
-    "extensions",
-    "checks",
-    "README.md",
-    "LICENSE"
-  ],
-  "pi": {
-    "extensions": [
-      "./extensions"
-    ]
-  }
-}
+{
+  "name": "pi-umbra-inputbar",
+  "version": "0.1.2",
+  "description": "pi's input bar, rebuilt: a chevron prompt, the session name on the border, a colour you pick, and a command to rename the session.",
+  "keywords": [
+    "pi-package",
+    "pi",
+    "pi-extension",
+    "tui",
+    "editor",
+    "prompt"
+  ],
+  "author": "grkn",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/grknbyk/pi-umbra.git",
+    "directory": "pi-umbra-inputbar"
+  },
+  "homepage": "https://github.com/grknbyk/pi-umbra/tree/main/pi-umbra-inputbar#readme",
+  "bugs": "https://github.com/grknbyk/pi-umbra/issues",
+  "files": [
+    "extensions",
+    "checks",
+    "README.md",
+    "LICENSE"
+  ],
+  "pi": {
+    "extensions": [
+      "./extensions"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
+  }
+}

package/node_modules/pi-umbra-preview/README.md

@@ -1,6 +1,13 @@
 # pi-umbra-preview
 
-Render a document with pandoc and open it in the browser, from inside pi.
+`/umb-preview` renders a document with pandoc and opens it in the browser.
+
+Reading a Markdown file in a terminal means reading its source: fences, pipes, link
+brackets. This renders it instead. pandoc turns the document into one self-contained HTML
+file and the system browser opens that.
+
+A PDF or an HTML file is opened directly. pandoc reads neither, and converting a PDF to
+HTML in order to look at a PDF is work with nothing at the end of it.
 
 ```
 pi-umbra-preview/
@@ -13,7 +20,8 @@ pi-umbra-preview/
 ## Needs pandoc
 
 Not bundled, never installed for you. It is looked for when a preview is asked for, not at
-load, so a missing pandoc costs one message rather than a failed extension.
+load, so a missing pandoc costs one message rather than a failed extension. The message
+names the install command for the platform it is printed on.
 
 | | |
 |---|---|
@@ -21,8 +29,6 @@ load, so a missing pandoc costs one message rather than a failed extension.
 | macOS | `brew install pandoc` |
 | Linux | `sudo apt install pandoc` |
 
-A PDF or an HTML file opens directly and needs no pandoc.
-
 ## Install
 
 ```sh

package/node_modules/pi-umbra-preview/package.json

@@ -1,33 +1,36 @@
-{
-  "name": "pi-umbra-preview",
-  "version": "0.1.0",
-  "description": "Render a document with pandoc and open it in the browser, from inside pi.",
-  "keywords": [
-    "pi-package",
-    "pi",
-    "pi-extension",
-    "pandoc",
-    "preview",
-    "markdown"
-  ],
-  "author": "grkn",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/grknbyk/pi-umbra.git",
-    "directory": "pi-umbra-preview"
-  },
-  "homepage": "https://github.com/grknbyk/pi-umbra/tree/main/pi-umbra-preview#readme",
-  "bugs": "https://github.com/grknbyk/pi-umbra/issues",
-  "files": [
-    "extensions",
-    "checks",
-    "README.md",
-    "LICENSE"
-  ],
-  "pi": {
-    "extensions": [
-      "./extensions"
-    ]
-  }
-}
+{
+  "name": "pi-umbra-preview",
+  "version": "0.1.2",
+  "description": "Render a document with pandoc and open it in the browser, from inside pi.",
+  "keywords": [
+    "pi-package",
+    "pi",
+    "pi-extension",
+    "pandoc",
+    "preview",
+    "markdown"
+  ],
+  "author": "grkn",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/grknbyk/pi-umbra.git",
+    "directory": "pi-umbra-preview"
+  },
+  "homepage": "https://github.com/grknbyk/pi-umbra/tree/main/pi-umbra-preview#readme",
+  "bugs": "https://github.com/grknbyk/pi-umbra/issues",
+  "files": [
+    "extensions",
+    "checks",
+    "README.md",
+    "LICENSE"
+  ],
+  "pi": {
+    "extensions": [
+      "./extensions"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*"
+  }
+}

package/node_modules/pi-umbra-rename/README.md

@@ -1,6 +1,13 @@
 # pi-umbra-rename
 
-One command that renames a pi session and the terminal window title together, which pi keeps behind two separate APIs.
+`/umb-rename` sets the session name and the terminal window title in one command.
+
+pi keeps them behind two APIs: `setSessionName` on the extension object, `setTitle` on the
+command context's UI. Set only one and the session selector and the window tab disagree
+about what this window is, which is the whole reason you renamed it.
+
+Called with a name it renames straight away. Called bare it prompts, seeded with the
+current name.
 
 ```
 pi-umbra-rename/

package/node_modules/pi-umbra-rename/package.json

@@ -1,33 +1,36 @@
-{
-  "name": "pi-umbra-rename",
-  "version": "0.1.0",
-  "description": "One command that renames a pi session and the terminal window title together, which pi keeps behind two separate APIs.",
-  "keywords": [
-    "pi-package",
-    "pi",
-    "pi-extension",
-    "session",
-    "rename",
-    "title"
-  ],
-  "author": "grkn",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/grknbyk/pi-umbra.git",
-    "directory": "pi-umbra-rename"
-  },
-  "homepage": "https://github.com/grknbyk/pi-umbra/tree/main/pi-umbra-rename#readme",
-  "bugs": "https://github.com/grknbyk/pi-umbra/issues",
-  "files": [
-    "extensions",
-    "checks",
-    "README.md",
-    "LICENSE"
-  ],
-  "pi": {
-    "extensions": [
-      "./extensions"
-    ]
-  }
-}
+{
+  "name": "pi-umbra-rename",
+  "version": "0.1.2",
+  "description": "One command that renames a pi session and the terminal window title together, which pi keeps behind two separate APIs.",
+  "keywords": [
+    "pi-package",
+    "pi",
+    "pi-extension",
+    "session",
+    "rename",
+    "title"
+  ],
+  "author": "grkn",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/grknbyk/pi-umbra.git",
+    "directory": "pi-umbra-rename"
+  },
+  "homepage": "https://github.com/grknbyk/pi-umbra/tree/main/pi-umbra-rename#readme",
+  "bugs": "https://github.com/grknbyk/pi-umbra/issues",
+  "files": [
+    "extensions",
+    "checks",
+    "README.md",
+    "LICENSE"
+  ],
+  "pi": {
+    "extensions": [
+      "./extensions"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*"
+  }
+}

package/node_modules/pi-umbra-shimmer/README.md

@@ -1,6 +1,19 @@
 # pi-umbra-shimmer
 
-A wave of colour running through pi's working indicator, over both the spinner and the text. Needs the umbra bundle patches; without them it does nothing.
+A wave of colour running through pi's working indicator, over both the spinner and the
+text.
+
+The highlight is not one colour. It travels from white down to the theme's own main colour
+and back, blending the whole way rather than stepping, so the band changes tone while it
+moves.
+
+pi builds the working indicator with a colour function already in hand, and paints custom
+spinner frames verbatim without running them through that step at all. Both points are
+past what the extension API exposes, so reaching them needs a bundle patch, which is not
+published in this repo.
+
+Installed alone this package does nothing. The patches are inert without it. With neither
+present pi keeps its own behaviour, so nothing here can half-apply.
 
 ```
 pi-umbra-shimmer/

package/node_modules/pi-umbra-shimmer/package.json

@@ -1,33 +1,36 @@
-{
-  "name": "pi-umbra-shimmer",
-  "version": "0.1.0",
-  "description": "A wave of colour running through pi's working indicator, over both the spinner and the text. Needs the umbra bundle patches; without them it does nothing.",
-  "keywords": [
-    "pi-package",
-    "pi",
-    "pi-extension",
-    "tui",
-    "spinner",
-    "animation"
-  ],
-  "author": "grkn",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/grknbyk/pi-umbra.git",
-    "directory": "pi-umbra-shimmer"
-  },
-  "homepage": "https://github.com/grknbyk/pi-umbra/tree/main/pi-umbra-shimmer#readme",
-  "bugs": "https://github.com/grknbyk/pi-umbra/issues",
-  "files": [
-    "extensions",
-    "checks",
-    "README.md",
-    "LICENSE"
-  ],
-  "pi": {
-    "extensions": [
-      "./extensions"
-    ]
-  }
-}
+{
+  "name": "pi-umbra-shimmer",
+  "version": "0.1.2",
+  "description": "A wave of colour running through pi's working indicator, over both the spinner and the text. Needs the umbra bundle patches; without them it does nothing.",
+  "keywords": [
+    "pi-package",
+    "pi",
+    "pi-extension",
+    "tui",
+    "spinner",
+    "animation"
+  ],
+  "author": "grkn",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/grknbyk/pi-umbra.git",
+    "directory": "pi-umbra-shimmer"
+  },
+  "homepage": "https://github.com/grknbyk/pi-umbra/tree/main/pi-umbra-shimmer#readme",
+  "bugs": "https://github.com/grknbyk/pi-umbra/issues",
+  "files": [
+    "extensions",
+    "checks",
+    "README.md",
+    "LICENSE"
+  ],
+  "pi": {
+    "extensions": [
+      "./extensions"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*"
+  }
+}

package/node_modules/pi-umbra-skill-matcher/README.md

@@ -1,6 +1,23 @@
 # pi-umbra-skill-matcher
 
-Type /huh and reach skill:huh. pi lists every skill under its bare name, which is not the name that dispatches.
+Type `/huh` and reach `skill:huh`. Complete a skill anywhere in the line, not only at the
+start of it.
+
+pi lists every skill in the completion dropdown under its bare name, but only `/skill:huh`
+runs one. So the dropdown offers `/huh`, you press enter, and pi answers "Unknown command".
+The fuzzy matching is not the problem; the name it matches against is. This wraps the
+built-in provider and rewrites every skill row to the form that dispatches, then re-runs
+the match against the prefixed name so `/skill:hu` still finds it after the built-in pass
+has given up.
+
+It also fills the mid-sentence slash menu. pi gates that menu on the line starting with
+`/`, so a `/name` written inside a sentence never reaches a provider at all. Lifting the
+gate needs a bundle patch, which is not published in this repo. What appears behind the
+gate is decided here.
+
+The mid-sentence match stays deliberately narrow, so a path keeps behaving like a path:
+the token must be the last one on the line, hold no space, and follow real text ending in
+whitespace. `src/foo` and an indented `/foo` both fail those tests and are left to pi.
 
 ```
 pi-umbra-skill-matcher/

package/node_modules/pi-umbra-skill-matcher/package.json

@@ -1,35 +1,35 @@
-{
-  "name": "pi-umbra-skill-matcher",
-  "version": "0.1.0",
-  "description": "Type /huh and reach skill:huh. pi lists every skill under its bare name, which is not the name that dispatches.",
-  "keywords": [
-    "pi-package",
-    "pi-extension",
-    "autocomplete",
-    "skills"
-  ],
-  "author": "grkn",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/grknbyk/pi-umbra.git",
-    "directory": "pi-umbra-skill-matcher"
-  },
-  "homepage": "https://github.com/grknbyk/pi-umbra/tree/main/pi-umbra-skill-matcher#readme",
-  "bugs": "https://github.com/grknbyk/pi-umbra/issues",
-  "type": "module",
-  "files": [
-    "extensions",
-    "checks",
-    "README.md"
-  ],
-  "pi": {
-    "extensions": [
-      "./extensions"
-    ]
-  },
-  "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "*",
-    "@earendil-works/pi-tui": "*"
-  }
-}
+{
+  "name": "pi-umbra-skill-matcher",
+  "version": "0.1.1",
+  "description": "Type /huh and reach skill:huh. pi lists every skill under its bare name, which is not the name that dispatches.",
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "autocomplete",
+    "skills"
+  ],
+  "author": "grkn",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/grknbyk/pi-umbra.git",
+    "directory": "pi-umbra-skill-matcher"
+  },
+  "homepage": "https://github.com/grknbyk/pi-umbra/tree/main/pi-umbra-skill-matcher#readme",
+  "bugs": "https://github.com/grknbyk/pi-umbra/issues",
+  "type": "module",
+  "files": [
+    "extensions",
+    "checks",
+    "README.md"
+  ],
+  "pi": {
+    "extensions": [
+      "./extensions"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
+  }
+}

package/node_modules/pi-umbra-theme/README.md

@@ -1,6 +1,35 @@
 # pi-umbra-theme
 
-pi's look in one package: seven umbra themes and the terminal background they set, a status footer, a gutter beside model text, a frame around every tool call, and a working line that names the running tool.
+Seven dark themes, and the five extensions that dress everything a theme cannot reach.
+
+A pi theme colours pi's own text: the selected line, your message, the three tool boxes.
+The window behind all of it, the space beside model output, the status line and the frame
+around a tool call sit outside a theme, and pi ships no theme token for any of them.
+
+**umbra-background** reads the active theme's `export.pageBg` and sets the terminal
+background to it with OSC 11, then puts it back on exit with OSC 111. pi only ever sends
+the query form of OSC 11, so it reads your background and leaves it alone. A theme without
+an `export.pageBg` is left alone too, so nothing is guessed.
+
+**umbra-gutter** draws a bar beside everything the model says, so your text and its text
+stay separable in a long session. It is a Markdown quote rather than a literal prefix: a
+literal prefix breaks the opening fence of a code block, and every code block in the answer
+then renders as paragraph text.
+
+**umbra-toolbox** frames each tool call, so a long transcript reads as blocks instead of
+one stream. It wraps `ToolExecutionComponent.prototype.render`, which pi exports and which
+follows the `Component` contract every pi component implements. The wrapper only puts a
+border around lines pi already drew, so highlighting, diffs, images and the expand
+affordance keep working.
+
+**umbra-footer** puts two columns under the conversation. On the left the model and its
+thinking level, context used against the window, and the turn cost when the provider
+reports one. On the right the working directory and the git branch. A terminal too narrow
+for both drops the right column whole rather than truncating a path into nonsense.
+
+**umbra-working** replaces pi's fixed "Working" with the tool that is running, how long the
+turn has taken and how many output tokens it has cost so far. The words map onto pi's own
+`ToolCallEvent` union, so the grouping is not a guess about which tools exist.
 
 ```
 pi-umbra-theme/

package/node_modules/pi-umbra-theme/package.json

@@ -1,45 +1,45 @@
-{
-  "name": "pi-umbra-theme",
-  "version": "0.1.0",
-  "description": "pi's look in one package: seven umbra themes and the terminal background they set, a status footer, a gutter beside model text, a frame around every tool call, and a working line that names the running tool.",
-  "keywords": [
-    "pi-package",
-    "pi",
-    "pi-extension",
-    "pi-theme",
-    "tui",
-    "theme",
-    "footer"
-  ],
-  "author": "grkn",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/grknbyk/pi-umbra.git",
-    "directory": "pi-umbra-theme"
-  },
-  "homepage": "https://github.com/grknbyk/pi-umbra/tree/main/pi-umbra-theme#readme",
-  "bugs": "https://github.com/grknbyk/pi-umbra/issues",
-  "type": "module",
-  "files": [
-    "extensions",
-    "checks",
-    "lib",
-    "themes",
-    "README.md",
-    "LICENSE"
-  ],
-  "pi": {
-    "extensions": [
-      "./extensions"
-    ],
-    "themes": [
-      "./themes"
-    ]
-  },
-  "peerDependencies": {
-    "@earendil-works/pi-ai": "*",
-    "@earendil-works/pi-coding-agent": "*",
-    "@earendil-works/pi-tui": "*"
-  }
-}
+{
+  "name": "pi-umbra-theme",
+  "version": "0.1.1",
+  "description": "pi's look in one package: seven umbra themes and the terminal background they set, a status footer, a gutter beside model text, a frame around every tool call, and a working line that names the running tool.",
+  "keywords": [
+    "pi-package",
+    "pi",
+    "pi-extension",
+    "pi-theme",
+    "tui",
+    "theme",
+    "footer"
+  ],
+  "author": "grkn",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/grknbyk/pi-umbra.git",
+    "directory": "pi-umbra-theme"
+  },
+  "homepage": "https://github.com/grknbyk/pi-umbra/tree/main/pi-umbra-theme#readme",
+  "bugs": "https://github.com/grknbyk/pi-umbra/issues",
+  "type": "module",
+  "files": [
+    "extensions",
+    "checks",
+    "lib",
+    "themes",
+    "README.md",
+    "LICENSE"
+  ],
+  "pi": {
+    "extensions": [
+      "./extensions"
+    ],
+    "themes": [
+      "./themes"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-umbra",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Every small thing pi does not build in, in one install: seven themes and the chrome around them, the input bar, session rename, a shimmer through the working indicator, mid-prompt skill completion, ask, copy-chat, preview and help.",
   "keywords": [
     "pi-package",
@@ -42,11 +42,11 @@
     "pi-umbra-theme": "0.1.1",
     "pi-umbra-ask": "0.1.1",
     "pi-umbra-copy-chat": "0.1.1",
-    "pi-umbra-help": "0.1.1",
-    "pi-umbra-inputbar": "0.1.1",
-    "pi-umbra-preview": "0.1.1",
-    "pi-umbra-rename": "0.1.1",
-    "pi-umbra-shimmer": "0.1.1",
+    "pi-umbra-help": "0.1.2",
+    "pi-umbra-inputbar": "0.1.2",
+    "pi-umbra-preview": "0.1.2",
+    "pi-umbra-rename": "0.1.2",
+    "pi-umbra-shimmer": "0.1.2",
     "pi-umbra-skill-matcher": "0.1.1"
   },
   "bundledDependencies": [