pi-studio 0.4.2 → 0.5.0

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to `pi-studio` are documented here.
 
+## [0.4.3] — 2026-03-04
+
+### Added
+- **Export right preview as PDF** action in Studio response controls, using server-side pandoc + LaTeX (`xelatex`) for high-quality math/typesetting output.
+- Footer metadata now includes model **and thinking level** (e.g., `provider/model (xhigh)`) plus terminal/session label.
+- Footer braille-dot activity spinner (`⠋⠙⠹…`) driven by existing websocket lifecycle state.
+
+### Changed
+- Footer layout is now two-line and less crowded: status/meta on the left with shortcuts aligned to the right.
+- Status text is now user-facing (removed `WS:` jargon and redundant `Ready` wording).
+
 ## [0.4.2] — 2026-03-03
 
 ### Added
@@ -77,7 +88,18 @@ All notable changes to `pi-studio` are documented here.
 
 ## [Unreleased]
 
+## [0.5.0] — 2026-03-05
+
 ### Added
+- Response history browser controls in Studio response actions (`Prev response` / `Next response` + `History: i/n`) with read-only browsing of prior assistant responses.
+- New response action: **Load response prompt into editor** (loads the user prompt that generated the currently selected history response, when available).
+- Annotation mode toggle (`Annotations: On|Off`) with explicit send behavior:
+  - **On**: keep/send `[an: ...]` markers
+  - **Off**: strip `[an: ...]` markers before Run/Critique
+- New editor action: **Save .annotated.md** (saves full editor text, including annotation markers).
+- Startup npm update check with terminal notification when installed version is behind npm latest.
+- Footer now shows live context usage (`used / window` and `%`) when available.
+- Footer action: **Compact context** button to trigger pi compaction directly from Studio.
 - Single-workspace flow (no mode switching): always-on **Editor** pane + **Response** pane.
 - Explicit annotation scaffold action: **Insert annotation header** (upserts header and source metadata in-editor).
 - Clear top-level critique controls: **Critique editor text** + **Critique focus**.
@@ -101,6 +123,9 @@ All notable changes to `pi-studio` are documented here.
 - Client-side Mermaid rendering for fenced `mermaid` code blocks in both Preview panes.
 
 ### Changed
+- Browser tab title now mirrors runtime metadata: `pi Studio · <terminal/session> · <model>`.
+- Inserted annotation scaffold now includes explicit syntax line: `annotation syntax: [an: your note]`.
+- Editor preview rendering now follows annotation mode (`On` highlights `[an: ...]` markers; `Off` hides them by stripping before preview render).
 - Removed Annotate/Critique tabs and related mode state.
 - Right pane now always shows the latest assistant output (reply or critique).
 - Response badge now reports response type + timestamp (`assistant response` / `assistant critique`).
@@ -119,6 +144,8 @@ All notable changes to `pi-studio` are documented here.
 - Hardened Studio preview HTTP handling and added client-side preview-request timeout to avoid stuck "Rendering preview…" states.
 
 ### Fixed
+- Fixed runtime model label staleness in Studio footer/state broadcasts by tracking canonical model metadata separately from command context.
+- Tightened editor/raw-highlight scroll synchronization for long documents and viewport changes (extra sync on keyup/mouseup/resize + post-update resync).
 - Studio boot blocker caused by unescaped preview HTML class-string quotes in inline script output.
 - `hydrateLatestAssistant` now infers response kind from hydrated markdown instead of reusing stale prior kind.
 - Added explicit `return` at end of `send_to_editor_request` handler for safer future handler additions.
@@ -127,9 +154,6 @@ All notable changes to `pi-studio` are documented here.
 - Preview sanitization now preserves MathML profile and strips MathML annotation tags to avoid duplicate raw TeX text beside rendered equations.
 - Preview now shows an inline warning when Mermaid is unavailable or diagram rendering fails, instead of failing silently.
 
-### Changed
-- Added npm metadata fields (`repository`, `homepage`, `bugs`) so npm package page links to GitHub.
-
 ## [0.1.0-alpha.1] - 2026-02-26
 
 Initial alpha baseline.

package/README.md

@@ -1,104 +1,57 @@
 # pi-studio
 
-Experimental extension for [pi](https://github.com/badlogic/pi-mono) that opens a local browser workspace for annotating model responses/files, running edited prompts, and requesting critiques.
+Experimental extension for [pi](https://github.com/badlogic/pi-mono) that opens a local browser workspace with editor and response panes for interacting with pi: annotating model responses/files, running edited prompts, requesting critiques, browsing history, and rendering previews.
 
 ## Screenshots
 
-**Markdown workspace — dark** (syntax-highlighted editor + rendered preview with Julia code block, inline math, blockquotes)
+**Dark**
 
-![Dark workspace](./assets/screenshots/dark-workspace.png)
+![Pi Studio workspace (dark)](./assets/screenshots/dark-workspace.png)
 
-**Markdown workspace — light**
+**Light**
 
-![Light workspace](./assets/screenshots/light-workspace.png)
+![Pi Studio workspace (light)](./assets/screenshots/light-workspace.png)
 
-**Math rendering — dark** (LaTeX source → MathML: PDEs, matrices, display equations)
+## What it does
 
-![Dark math](./assets/screenshots/dark-math.png)
-
-**Structured critique — dark** (assessment + numbered critiques with rendered math, "Edited since response" sync badge)
-
-![Dark critique](./assets/screenshots/dark-critique.png)
-
-**Math rendering — light**
-
-![Light math](./assets/screenshots/light-math.png)
-
-**Mermaid diagrams — dark** (fenced mermaid block → rendered flowchart with theme-aware colors)
-
-![Dark mermaid](./assets/screenshots/dark-mermaid.png)
-
-**Code mode — dark** (TypeScript file loaded with language auto-detected from extension)
-
-![Dark code mode](./assets/screenshots/dark-code-mode.png)
-
-**Code mode — light**
-
-![Light code mode](./assets/screenshots/light-code-mode.png)
-
-**Focus mode — dark** (editor pane full-screen, `Cmd/Ctrl+Esc` or `F10` to toggle, `Esc` to exit)
-
-![Dark focus mode](./assets/screenshots/dark-focus-mode.png)
-
-## Features
-
-- Single workspace: Editor (left) + Response (right)
-- **Run editor text** sends editor content as-is
-- **Insert annotation header** adds/updates annotated-reply scaffold
-- **Critique editor text** requests structured critique (auto/writing/code focus)
-- Response load helpers:
-  - non-critique: **Load response into editor**
-  - critique: **Load critique notes into editor** / **Load full critique into editor**
-- File/editor actions: **Save editor as…**, **Save editor**, **Load file content**, **Send to pi editor**, **Load from pi editor**
-- View toggles: panel header dropdowns for `Editor (Raw|Preview)` and `Response (Raw|Preview) | Editor (Preview)`
-- **Editor Preview in response pane**: side-by-side source/rendered view (Overleaf-style) — select `Right: Editor (Preview)` to render editor text in the right pane with live updates
-- Preview mode supports MathML equations and Mermaid fenced diagrams
-- **Language-aware syntax highlighting** with selectable language mode:
-  - Markdown (default): headings, links, code fences, lists, quotes, inline code
-  - Code languages: JavaScript, TypeScript, Python, Bash, JSON, Rust, C, C++, Julia, Fortran, R, MATLAB, LaTeX, Diff
-  - Keywords, strings, comments, numbers, and variables highlighted using theme syntax color tokens
-  - **Diff highlighting**: added/removed lines shown with green/red backgrounds in both raw and preview modes
-  - Language auto-detected from file extension on file load; manually selectable via `Lang:` dropdown
-  - Applies to both editor Raw view (highlight overlay) and fenced code blocks in markdown
-  - Preview mode renders syntax-highlighted code when a non-markdown language is selected
-- **LaTeX file support**: `.tex`/`.latex` files detected by content, rendered via pandoc with proper title block (title, author, date, abstract) styling
-- **Diff file support**: `.diff`/`.patch` files rendered with coloured add/remove line backgrounds
-- **Image embedding**: images in markdown and LaTeX files embedded as base64 data URIs via pandoc `--embed-resources`, with no external file serving required
-- **Working directory**: "Set working dir" button for uploaded files — resolves relative image paths and enables "Save editor" for uploaded content
-- **Live theme sync**: changing the pi theme in the terminal updates the studio browser UI automatically (polled every 2 seconds)
-- Separate syntax highlight toggles for editor and response Raw views, with local preference persistence
-- Keyboard shortcuts: `Cmd/Ctrl+Enter` runs **Run editor text** when editor pane is active; `Cmd/Ctrl+Esc` / `F10` toggles focus mode; `Esc` exits focus mode
-- Footer status reflects Studio/terminal activity phases (connecting, ready, submitting, terminal activity)
-- Theme-aware browser UI derived from current pi theme
-- View mode selectors integrated into panel headers for a cleaner layout
+- Opens a two-pane browser workspace: **Editor** (left) + **Response/Editor Preview** (right)
+- Runs editor text directly, or asks for structured critique (auto/writing/code focus)
+- Browses response history (`Prev/Next`) and loads either:
+  - response text
+  - critique notes/full critique
+  - the prompt that generated a selected response
+- Supports an annotation workflow for `[an: ...]` markers:
+  - inserts/removes the annotated-reply header
+  - shows/hides annotation markers in preview
+  - strips markers before send (optional)
+  - saves `.annotated.md`
+- Renders Markdown/LaTeX/code previews (math + Mermaid), theme-synced with pi
+- Exports right-pane preview as PDF (pandoc + LaTeX)
+- Shows model/session/context usage in the footer, plus a compact-context action
 
 ## Commands
 
 | Command | Description |
-|---------|-------------|
-| `/studio` | Open studio with last assistant response (fallback: blank) |
-| `/studio <path>` | Open studio with file preloaded |
-| `/studio --last` | Force load from last assistant response |
-| `/studio --blank` | Force blank editor start |
+|---|---|
+| `/studio` | Open with last assistant response (fallback: blank) |
+| `/studio <path>` | Open with file preloaded |
+| `/studio --last` | Force last response |
+| `/studio --blank` | Force blank editor |
 | `/studio --status` | Show studio server status |
 | `/studio --stop` | Stop studio server |
-| `/studio --help` | Show command help |
+| `/studio --help` | Show help |
 
 ## Install
 
-From GitHub:
-
-```bash
-pi install https://github.com/omaclaren/pi-studio
-```
-
-From npm:
-
 ```bash
+# npm
 pi install npm:pi-studio
+
+# GitHub
+pi install https://github.com/omaclaren/pi-studio
 ```
 
-Run without installing:
+Run once without installing:
 
 ```bash
 pi -e https://github.com/omaclaren/pi-studio
@@ -106,18 +59,11 @@ pi -e https://github.com/omaclaren/pi-studio
 
 ## Notes
 
-- Local-only server (`127.0.0.1`) with rotating session tokens.
-- One studio request at a time.
-- Pi Studio supports both markdown workflows (model responses, plans, and notes) and code file editing with language-aware syntax highlighting.
-- Studio URLs include a token query parameter; avoid sharing full Studio URLs.
-- Preview panes render markdown via `pandoc` (`gfm+tex_math_dollars` → HTML5 + MathML), including pandoc code syntax highlighting, sanitized in-browser with `dompurify`. LaTeX files are rendered from `latex` input format with title block styling.
-- Images referenced in markdown or via `\includegraphics` in LaTeX are embedded as base64 data URIs when a file path or working directory is available. For uploaded files without a working directory set, a notice suggests setting one.
-- Preview markdown/code colors are mapped from active theme markdown (`md*`) and syntax (`syntax*`) tokens for closer terminal-vs-browser parity.
-- Mermaid fenced `mermaid` code blocks are rendered client-side in preview mode (Mermaid v11 loaded from jsDelivr), with palette-driven defaults for better theme fit.
-- If Mermaid cannot load or a diagram fails to render, preview shows an inline warning and keeps source text visible.
-- Preview rendering normalizes Obsidian wiki-image syntax (`![[path]]`, `![[path|alt]]`) into standard markdown images.
-- Install pandoc for full preview rendering (`brew install pandoc` on macOS).
-- If `pandoc` is unavailable, preview falls back to plain markdown text with an inline warning.
+- Local-only server (`127.0.0.1`) with rotating tokenized URLs.
+- Studio is designed as a complement to terminal pi, not a replacement.
+- Full preview/PDF quality depends on `pandoc` (and `xelatex` for PDF):
+  - `brew install pandoc`
+  - install TeX Live/MacTeX for PDF export
 
 ## License
 

package/WORKFLOW.md

@@ -15,13 +15,14 @@ Studio uses a **single workspace** (no tab/mode switching):
 
 ## Core actions
 
-## 1) Insert annotation header (optional prep)
+## 1) Insert annotated reply header (optional prep)
 
 Adds/updates an `annotated-reply` compatible scaffold in the editor:
 
 ```md
 annotated reply below:
 original source: <last model response | file <path> | studio editor>
+annotation syntax: [an: your note]
 
 ---
 
@@ -32,7 +33,7 @@ Studio does **not** auto-send this scaffold; it is an explicit editor transform.
 
 ## 2) Run editor text (plain send)
 
-Sends current editor text to the model unchanged.
+Sends current editor text to the model. If `Annotations: Hidden`, `[an: ...]` markers are stripped before send.
 
 ## 3) Critique editor text (structured review request)
 
@@ -77,8 +78,8 @@ Rules:
 - Header actions: **Save As…**, **Save file** (file-backed), **Load file in editor**
 - Header view toggles: `Left: Editor (Raw|Preview)`, `Right: Response (Raw|Preview) | Editor (Preview)`
 - Preview mode uses server-side `pandoc` rendering (math-aware) with plain-markdown fallback when renderer is unavailable.
-- Editor actions: **Insert annotation header**, **Run editor text**, **Critique editor text** (+ critique focus), **Send to pi editor**, **Copy editor text**
-- Response actions include `Auto-update response: On|Off` + **Get latest response**
+- Editor actions: **Insert/Remove annotated reply header**, **Annotations: On|Hidden**, **Strip annotations…**, **Run editor text**, **Critique editor text** (+ critique focus), **Send to pi editor**, **Copy editor text**, **Save .annotated.md**
+- Response actions include `Auto-update response: On|Off`, **Get latest response**, response-history browse (`Prev/Next`), and **Load response prompt into editor**
 - Source badge: `blank | last model response | file <path> | upload`
 - Response badge: `none | assistant response | assistant critique` (+ timestamp)
 - Sync badge: `No response loaded | In sync with response | Edited since response`
@@ -89,7 +90,7 @@ Rules:
 ## Acceptance criteria
 
 1. `/studio --last` opens with editor loaded and no required mode selection.
-2. **Run editor text** sends the current editor content as-is and returns response to right pane.
+2. **Run editor text** respects annotation mode (`On` send as-is, `Off` strip `[an: ...]`) and returns response to right pane.
 3. **Insert annotation header** updates the scaffold source metadata without duplicating headers.
 4. **Critique editor text** runs on current editor text and returns structured package when model complies.
 5. Structured critique helpers (`Load critique (notes)` / `Load critique (full)`) enable only when critique structure is present.