pi-design-deck 0.3.3 → 0.3.5

package/README.md

@@ -4,7 +4,7 @@
 
 # Design Deck
 
-A tool for [Pi coding agent](https://github.com/badlogic/pi-mono/) that presents multi-slide visual decision decks in the browser. Each slide shows 2-4 high-fidelity previews — code diffs, architecture diagrams, UI mockups — and you pick one per slide. The agent gets back a clean selection map and moves on to implementation.
+A tool for [Pi coding agent](https://github.com/badlogic/pi-mono/) that presents multi-slide visual decision decks. On macOS, uses [Glimpse](https://github.com/nicobailon/glimpseui) to render in a native WKWebView window; falls back to a browser tab on other platforms. Each slide shows 2-4 high-fidelity previews — code diffs, architecture diagrams, UI mockups — and you pick one per slide. The agent gets back a clean selection map and moves on to implementation.
 
 <img width="1340" alt="Design Deck screenshot" src="https://github.com/user-attachments/assets/20864ac6-9223-4e2e-ba3c-db3eaae0abd8" />
 
@@ -41,7 +41,7 @@ Restart pi to load the extension and the bundled `design-deck` skill.
 
 **Requirements:**
 - pi-agent v0.35.0 or later (extensions API)
-- Optional on macOS: `glimpseui` for native window launch (`npm install -g glimpseui`)
+- For native macOS window: `pi install npm:glimpseui` (optional, falls back to browser if not installed)
 
 https://github.com/user-attachments/assets/aff1bac6-8bc2-461a-8828-f588ce655f7f
 

package/index.ts

@@ -411,11 +411,24 @@ export default function (pi: ExtensionAPI) {
 			"When the user requests more options, tool returns generate-more instructions — " +
 			'call design_deck with action:"add-options" to push all new options at once. ' +
 			"previewBlocks for code/architecture comparisons, previewHtml for custom UI mockups.",
+		promptSnippet:
+			"Use this to present architecture/UI/code choices visually. Start with {slides: <deck-json-string>} and wait for completion. " +
+			"If it returns generate-more instructions, call design_deck with action:\"add-options\" and slideId to push all new options.",
 		parameters: DeckParams,
 
 		async execute(_toolCallId, params, signal, onUpdate, ctx) {
 			const p = params as Record<string, unknown>;
 
+			if (!p.action && typeof p.slides === "string") {
+				try {
+					const parsed = JSON.parse(p.slides);
+					if (parsed && typeof parsed === "object" && !Array.isArray(parsed) && typeof parsed.action === "string") {
+						Object.assign(p, parsed);
+						delete p.slides;
+					}
+				} catch {}
+			}
+
 			if (!ctx.hasUI && p.action !== "list" && p.action !== "export") {
 				throw new Error(
 					"design_deck requires interactive mode with browser support. " +
@@ -1057,6 +1070,8 @@ export default function (pi: ExtensionAPI) {
 	pi.registerTool({
 		name: "deck_generate",
 		description: "Generate text using a specific model (for design deck option generation). Use this when the generate-more prompt specifies a model override.",
+		promptSnippet:
+			"Use when design_deck generate-more/regenerate asks for a specific model. Provide {model: \"provider/model-id\", task: \"prompt\"} and return the raw generated text.",
 		parameters: Type.Object({
 			model: Type.String({ description: "Full model ID in 'provider/model-id' format (e.g., 'anthropic/claude-haiku-4-5')" }),
 			task: Type.String({ description: "The generation task/prompt" }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-design-deck",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "Visual design deck for presenting multi-slide options with high-fidelity previews",
   "author": "Nico Bailon",
   "license": "MIT",