@office-kit/pptx-dev 0.2.4 → 0.4.0

package/README.md

@@ -17,7 +17,7 @@ npm run dev
 ```
 
 Open the local URL printed by the server. Save a slide file, `theme.ts` or `deck.tsx` to rebuild. The viewer
-has a vertical thumbnail strip and a large slide canvas. Click a thumbnail or use
+has a vertical thumbnail strip, a large slide canvas and an AI chat panel on the right. Click a thumbnail or use
 arrow keys, Page Up/Down, Home/End to navigate. Fit/zoom and Present (Escape to
 exit) are viewing controls; the canvas has no editing, dragging or resize handles.
 Changes are made only in TSX, including when an AI agent edits the presentation.
@@ -43,7 +43,70 @@ The generated `CLAUDE.md` explains authoring conventions. VSCode picks up the
 included `tsconfig.json` for completion and diagnostics. Start the **Preview
 presentation** task, then use **Simple Browser: Show** with the printed URL and
 move it to a side editor group. No custom editor extension is needed for this
-workflow. Preview-to-source selection is not implemented.
+workflow. Clicking a slide supplies chat context; opening its exact TSX location is not implemented.
+
+## Chat in the preview
+
+The right panel defaults to **Claude Code**. Click **Start** to open the locally
+installed `claude` CLI in an interactive terminal. Install and sign in to Claude
+Code first. Use a current version with HTTP `UserPromptSubmit` hook support.
+The session runs in the deck entry's directory and uses your normal account,
+user/project settings, CLAUDE.md, plugins, skills, MCP servers and hooks.
+
+Type `/model` to choose a model, `/config` to change settings, or `/` to browse
+available commands and skills. Bash and other tools are available according to
+Claude Code's own configuration, and permission prompts are answered directly in
+the panel. The preview does not force `acceptEdits`, restrict the tool list or
+bypass permissions. Installation and account setup use the CLI's usual flow.
+Markdown responses are displayed by Claude Code's terminal renderer; its native
+formatting may differ from a web Markdown page. OS-specific actions such as
+opening an external editor still use your local environment.
+
+Each submitted Claude prompt receives the focused slide's **1-based number,
+text, slide count, preview revision, deck entry and source dependency paths**,
+plus any build error, through a session-scoped `UserPromptSubmit` HTTP hook.
+The preview captures context with terminal input before forwarding it to the
+CLI. Navigation while Claude is replying does not change that turn's context.
+Stale input is rejected with a retry message. If your Claude settings or managed
+policy disable hooks, automatic context attachment is unavailable; enable the
+preview hook in Claude Code to use it. No project settings file is rewritten.
+Dependency paths are source candidates, not an exact slide-to-file mapping.
+“This slide” requests a focused patch; requests about another slide or the
+whole deck can edit other files or shared styling.
+
+Reloading the browser reconnects to the same process and replays its recent
+terminal output (up to 2 MB). One browser tab controls the session; other tabs
+can view it. Keep the owning tab open, or end the session there before moving to
+another tab. **End session** stops the process; saved edits remain. Start opens
+a new session, and Claude's `/resume` command can restore an earlier conversation.
+Stopping the dev server also stops the embedded session. This is independent of
+the Claude Code conversation that may have launched your dev server.
+
+Select **Codex** while Claude Code is stopped to use the existing message-based
+chat. Codex replies render Markdown (including lists, code blocks and tables);
+raw HTML, unsafe links and remote images are not rendered. Codex still uses
+`exec --json` with the `workspace-write` sandbox and its installed CLI login.
+Operations requiring interactive approval are not supported in this adapter.
+The most recent 12 messages (bounded text) and the focused slide are sent with
+each request. The dev server retains up to 100 messages until it exits.
+**New chat** clears this history; **Stop** cancels the running edit. Ctrl/Cmd+Enter
+sends a message. Model/settings menus in the embedded terminal are currently
+specific to Claude Code.
+
+Use **Chat** in the header to hide/show the panel. On narrow screens the panel
+moves below the preview. Presentation mode hides it without ending the session.
+Both providers save TSX directly, which triggers the usual automatic rebuild.
+The server binds to loopback and requires same-origin JSON for terminal control;
+the local context hook uses a separate per-server token.
+
+The terminal uses `node-pty` and xterm.js. Linux systems without a matching PTY
+prebuild need the native build prerequisites documented by
+[node-pty](https://github.com/microsoft/node-pty). With pnpm, allow `node-pty`'s
+install script (`pnpm approve-builds`) if your project blocks dependency scripts.
+
+References: [Claude Code commands](https://code.claude.com/docs/en/commands),
+[Claude Code hooks](https://code.claude.com/docs/en/hooks), and
+[Codex non-interactive mode](https://developers.openai.com/codex/noninteractive).
 
 ## Edit only what changed
 
@@ -86,7 +149,7 @@ preview server binds to `127.0.0.1` and rejects unexpected Host headers.
 
 Programmatic exports: `buildDeck`, `exportDeck`, `initProject`, `inspectTemplate`.
 `buildDeck` returns PPTX bytes, SVG slides, aspect ratio, module dependencies and
-core validation diagnostics. Browser APIs and DOM globals are not available in
+slide text and core validation diagnostics. Browser APIs and DOM globals are not available in
 TSX evaluation.
 
 ## Developing in this monorepo