@konstantdotcloud/boombox 0.2.0 → 0.3.0

package/dist/index.js

@@ -28044,47 +28044,55 @@ function registerAskGary(server, gateway) {
       const streamedArtifacts = /* @__PURE__ */ new Map();
       await emit(`asking Gary: "${input.question.slice(0, 80)}${input.question.length > 80 ? "\u2026" : ""}"${input.thread ? ` (thread=${input.thread})` : ""}${input.thread_id ? ` (thread_id=${input.thread_id})` : ""}${input.artifact_ref ? ` (artifact_ref=${input.artifact_ref})` : ""}${input.fresh ? " [fresh]" : ""}`);
       try {
-        await gateway.stream("/gateway/homebase/ask", body, async (evt) => {
-          const evType = typeof evt.event === "string" ? evt.event : "";
-          if (evType === "started") {
-            await emit(`session ${evt.session_id ?? "?"} thread ${evt.thread_id ?? "?"} \u2014 running\u2026`);
-          } else if (evType === "tool_start") {
-            await emit(`tool start: ${typeof evt.tool === "string" ? evt.tool : "unknown"}`);
-          } else if (evType === "tool_end") {
-            const toolName = typeof evt.tool === "string" ? evt.tool : "unknown";
-            const dur = typeof evt.duration_ms === "number" ? `${evt.duration_ms}ms` : "?ms";
-            const isError = evt.is_error === true;
-            await emit(`tool ${isError ? "failed" : "done"}: ${toolName} (${dur})`);
-          } else if (evType === "artifact_ready") {
-            const artifactId = typeof evt.artifact_id === "string" ? evt.artifact_id : "";
-            const viewUrl = typeof evt.view_url === "string" ? evt.view_url : "";
-            if (artifactId && viewUrl) {
-              streamedArtifacts.set(artifactId, {
-                artifact_id: artifactId,
-                view_url: viewUrl,
-                title: typeof evt.title === "string" ? evt.title : void 0,
-                type: typeof evt.type === "string" ? evt.type : void 0,
-                tool: typeof evt.tool === "string" ? evt.tool : void 0
-              });
-              await emit(`artifact ready: ${viewUrl}`);
-            }
-          } else if (evType === "text_delta") {
-            const delta = typeof evt.delta === "string" ? evt.delta : "";
-            const before = streamedAnswer.length;
-            streamedAnswer += delta;
-            const crossedBoundary = Math.floor(before / 200) !== Math.floor(streamedAnswer.length / 200);
-            if (crossedBoundary) {
-              await emit(`writing answer\u2026 (${streamedAnswer.length} chars)`);
-            }
-          } else if (evType === "message_end_text") {
-            const text2 = typeof evt.text === "string" ? evt.text : "";
-            if (text2.length > streamedAnswer.length) streamedAnswer = text2;
-          } else if (evType === "error") {
-            await emit(`error: ${typeof evt.message === "string" ? evt.message : "unknown"}`);
-          } else if (evType === "final") {
-            final = evt;
-          }
-        });
+        if (input.depth === "quick") {
+          await emit("using quick ask-fast path");
+          final = await gateway.call("/gateway/homebase/ask-fast", body);
+          if (typeof final.answer === "string") streamedAnswer = final.answer;
+        } else {
+          await gateway.stream("/gateway/homebase/ask", body, async (evt) => {
+            const evType = typeof evt.event === "string" ? evt.event : "";
+            if (evType === "started") {
+              await emit(`session ${evt.session_id ?? "?"} thread ${evt.thread_id ?? "?"} \u2014 running\u2026`);
+            } else if (evType === "tool_start") {
+              await emit(`tool start: ${typeof evt.tool === "string" ? evt.tool : "unknown"}`);
+            } else if (evType === "tool_end") {
+              const toolName = typeof evt.tool === "string" ? evt.tool : "unknown";
+              const dur = typeof evt.duration_ms === "number" ? `${evt.duration_ms}ms` : "?ms";
+              const isError = evt.is_error === true;
+              await emit(`tool ${isError ? "failed" : "done"}: ${toolName} (${dur})`);
+            } else if (evType === "keepalive") {
+              await emit("still working...");
+            } else if (evType === "artifact_ready") {
+              const artifactId = typeof evt.artifact_id === "string" ? evt.artifact_id : "";
+              const viewUrl = typeof evt.view_url === "string" ? evt.view_url : "";
+              if (artifactId && viewUrl) {
+                streamedArtifacts.set(artifactId, {
+                  artifact_id: artifactId,
+                  view_url: viewUrl,
+                  title: typeof evt.title === "string" ? evt.title : void 0,
+                  type: typeof evt.type === "string" ? evt.type : void 0,
+                  tool: typeof evt.tool === "string" ? evt.tool : void 0
+                });
+                await emit(`artifact ready: ${viewUrl}`);
+              }
+            } else if (evType === "text_delta") {
+              const delta = typeof evt.delta === "string" ? evt.delta : "";
+              const before = streamedAnswer.length;
+              streamedAnswer += delta;
+              const crossedBoundary = Math.floor(before / 200) !== Math.floor(streamedAnswer.length / 200);
+              if (crossedBoundary) {
+                await emit(`writing answer\u2026 (${streamedAnswer.length} chars)`);
+              }
+            } else if (evType === "message_end_text") {
+              const text2 = typeof evt.text === "string" ? evt.text : "";
+              if (text2.length > streamedAnswer.length) streamedAnswer = text2;
+            } else if (evType === "error") {
+              await emit(`error: ${typeof evt.message === "string" ? evt.message : "unknown"}`);
+            } else if (evType === "final") {
+              final = evt;
+            }
+          });
+        }
       } catch (error2) {
         const text2 = renderErrorText(error2);
         process.stderr.write(`[ask_gary] ${text2.split("\n")[0]}
@@ -28219,8 +28227,9 @@ var init_ask_gary = __esm({
       thread_id: external_exports2.string().optional().describe("Concrete thread_id to use instead of resolving a named alias. Useful when continuing an artifact discussion thread."),
       artifact_ref: external_exports2.string().optional().describe("Artifact id to pin as Gary context. Gary loads the artifact body and tags the resulting thread with artifact_ref."),
       fresh: external_exports2.boolean().optional().describe("If true, rotate the thread alias to a brand-new conversation, discarding prior history under that alias."),
-      model_tier: external_exports2.enum(["auto", "fast", "nano", "mini", "reason", "mid", "explore", "premium", "opus"]).optional().describe("Model tier override. Default 'explore' (Sonnet 4.6). Use 'premium' for Opus 4.8 at max thinking, 'opus' for Opus 4.8 standard."),
-      thinking_level: external_exports2.enum(["off", "minimal", "low", "medium", "high", "xhigh"]).optional().describe("Reasoning effort override. Default 'medium'."),
+      model_tier: external_exports2.enum(["auto", "fast", "nano", "mini", "reason", "mid", "explore", "premium", "opus"]).optional().describe("Model tier override. Default 'fast' (Sonnet 4.6 with low reasoning). Use 'premium' for Opus 4.8 at max thinking, 'opus' for Opus 4.8 standard."),
+      thinking_level: external_exports2.enum(["off", "minimal", "low", "medium", "high", "xhigh"]).optional().describe("Reasoning effort override. Default 'low'."),
+      depth: external_exports2.enum(["standard", "quick"]).optional().describe("'quick' routes to the direct map->retrieve->single-synthesis fast path (~5-10s, no agent loop); default 'standard' runs the full V2 chat-session turn."),
       intent: external_exports2.enum(["cassette_author"]).optional().describe("Set to cassette_author to load Gary cassette-authoring mode prompt/doctrine.")
     };
   }
@@ -29392,45 +29401,57 @@ function registerCassetteAuthoringVerbs(server, gateway) {
     "cassette_draft",
     "Start Gary cassette-authoring mode: create a cassette_drafts record, emit YAML, validate it, and ask one next question.",
     draftSchema,
-    async (input) => renderGatewayResult("cassette_draft", await gateway.call("/gateway/cassette/draft", { ...input, intent: "cassette_author" }))
+    async (input) => callAndRender("cassette_draft", () => gateway.call("/gateway/cassette/draft", { ...input, intent: "cassette_author" }))
   );
   server.tool(
     "cassette_refine",
     "Refine an owned cassette draft with answers or a YAML patch. Does not mutate published cassettes.",
     refineSchema,
-    async (input) => renderGatewayResult("cassette_refine", await gateway.call("/gateway/cassette/refine", input))
+    async (input) => {
+      const refineInput = { ...input, yaml_patch: input.yaml_patch ?? input.yaml };
+      delete refineInput.yaml;
+      return callAndRender("cassette_refine", () => gateway.call("/gateway/cassette/refine", refineInput));
+    }
   );
   server.tool(
     "cassette_dry_run",
     "Dry-run a cassette draft against sample inputs. Returns a DryRunReport and never writes WorkflowRunRecord.",
     dryRunSchema,
-    async (input) => renderGatewayResult("cassette_dry_run", await gateway.call("/gateway/cassette/dry-run", input))
+    async (input) => callAndRender("cassette_dry_run", () => gateway.call("/gateway/cassette/dry-run", input))
   );
   server.tool(
     "cassette_publish",
-    'Publish a dry-run-approved cassette draft. Gateway must enforce session.canDo("cassette.publish").',
+    'Publish a dry-run-approved cassette draft. Gateway must enforce session.canDo("cassette.publish"); name defaults to the draft spec id.',
     publishSchema,
-    async (input) => renderGatewayResult("cassette_publish", await gateway.call("/gateway/cassette/publish", input))
+    async (input) => callAndRender("cassette_publish", () => gateway.call("/gateway/cassette/publish", input))
   );
   server.tool(
     "cassette_get",
     "Get a cassette draft or published cassette as YAML plus describe payload.",
     getSchema,
-    async (input) => renderGatewayResult("cassette_get", await gateway.call("/gateway/cassette/get", input))
+    async (input) => callAndRender("cassette_get", () => gateway.call("/gateway/cassette/get", input))
   );
   server.tool(
     "cassette_list_drafts",
     "List cassette drafts visible to the caller.",
     listDraftsSchema,
-    async (input) => renderGatewayResult("cassette_list_drafts", await gateway.call("/gateway/cassette/list-drafts", input))
+    async (input) => callAndRender("cassette_list_drafts", () => gateway.call("/gateway/cassette/list-drafts", input))
   );
   server.tool(
     "cassette_list_capabilities",
     "List tenant capabilities Gary may use while authoring. Call before inventing or refining steps.",
     listCapabilitiesSchema,
-    async (input) => renderGatewayResult("cassette_list_capabilities", await gateway.call("/gateway/cassette/list-capabilities", input))
+    async (input) => callAndRender("cassette_list_capabilities", () => gateway.call("/gateway/cassette/list-capabilities", input))
   );
 }
+async function callAndRender(verb, call) {
+  try {
+    return renderGatewayResult(verb, await call());
+  } catch (error2) {
+    if (error2 instanceof GatewayError) return renderGatewayError(verb, error2);
+    throw error2;
+  }
+}
 function renderGatewayResult(verb, result) {
   const record2 = isRecord(result) ? result : { value: result };
   if (record2.ok === false || typeof record2.code === "string" && record2.ok !== true) {
@@ -29446,21 +29467,93 @@ function renderGatewayResult(verb, result) {
 function renderText2(verb, record2) {
   if (typeof record2.markdown === "string") return record2.markdown;
   if (typeof record2.text === "string") return record2.text;
+  if (verb === "cassette_dry_run" && isRecord(record2.report)) return renderDryRunReport(record2.report);
   if (typeof record2.yaml === "string") {
     const title = typeof record2.draft_id === "string" ? `${verb}: ${record2.draft_id}` : verb;
-    const next = typeof record2.next_question === "string" ? `
-
-Next question: ${record2.next_question}` : "";
     return `# ${title}
 
 \`\`\`yaml
 ${record2.yaml}
-\`\`\`${next}`;
+\`\`\`${renderOpenQuestions(record2)}`;
   }
   return `# ${verb}
 
 ${JSON.stringify(record2, null, 2)}`;
 }
+function renderGatewayError(verb, error2) {
+  const parsed = parseGatewayErrorBody(error2.body);
+  const diagnostics = parsed ? extractDiagnostics(parsed) : [];
+  const text = diagnostics.length > 0 ? `# ${verb} failed
+
+${diagnostics.map(formatDiagnostic).join("\n")}` : `${verb} failed: ${error2.message}`;
+  return {
+    content: [{ type: "text", text }],
+    ...parsed ? { structuredContent: parsed } : {},
+    isError: true
+  };
+}
+function renderOpenQuestions(record2) {
+  const questions = Array.isArray(record2.open_questions) ? record2.open_questions.filter((question) => typeof question === "string" && question.length > 0) : [];
+  if (questions.length === 0) return "";
+  return `
+
+Next questions:
+${questions.map((question) => `- ${question}`).join("\n")}`;
+}
+function renderDryRunReport(report) {
+  const lines = [`Dry-run verdict: ${typeof report.verdict === "string" ? report.verdict : "unknown"}`];
+  if (Array.isArray(report.blockers) && report.blockers.length > 0) {
+    lines.push("", "Blockers:");
+    for (const blocker of report.blockers) {
+      if (isRecord(blocker)) lines.push(`- ${formatBlocker(blocker)}`);
+    }
+  }
+  if (isRecord(report.artifact_preview)) {
+    lines.push("", "Artifact preview:", "```text", formatArtifactPreview(report.artifact_preview), "```");
+  }
+  return lines.join("\n");
+}
+function formatBlocker(blocker) {
+  const detail = typeof blocker.detail === "string" ? blocker.detail : "blocked";
+  const parts = [typeof blocker.kind === "string" ? `${blocker.kind}: ${detail}` : detail];
+  for (const key of ["capability_id", "scope", "path"]) {
+    if (typeof blocker[key] === "string") parts.push(`${key}=${blocker[key]}`);
+  }
+  return parts.join(" ");
+}
+function formatArtifactPreview(preview) {
+  const title = typeof preview.title === "string" ? preview.title : "Untitled artifact";
+  const template = typeof preview.template === "string" ? preview.template : "unknown";
+  const wordCount = typeof preview.word_count === "number" ? preview.word_count : 0;
+  const content = typeof preview.content === "string" ? preview.content.slice(0, 600) : "";
+  return [`${title}`, `template: ${template}`, `word_count: ${wordCount}`, "", content].join("\n");
+}
+function parseGatewayErrorBody(body) {
+  try {
+    const parsed = JSON.parse(body);
+    return isRecord(parsed) ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+function extractDiagnostics(record2) {
+  const details = isRecord(record2.details) ? record2.details : null;
+  const diagnostics = details && Array.isArray(details.diagnostics) ? details.diagnostics : [];
+  return diagnostics.flatMap((diagnostic) => {
+    if (!isRecord(diagnostic) || typeof diagnostic.message !== "string") return [];
+    return [{
+      message: diagnostic.message,
+      ...typeof diagnostic.line === "number" ? { line: diagnostic.line } : {},
+      ...typeof diagnostic.column === "number" ? { column: diagnostic.column } : {},
+      ...typeof diagnostic.path === "string" ? { path: diagnostic.path } : {}
+    }];
+  });
+}
+function formatDiagnostic(diagnostic) {
+  const location = typeof diagnostic.line === "number" ? `L${diagnostic.line}${typeof diagnostic.column === "number" ? `:${diagnostic.column}` : ""} ` : "";
+  const path4 = diagnostic.path ? ` (${diagnostic.path})` : "";
+  return `- ${location}${diagnostic.message}${path4}`;
+}
 function isRecord(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
@@ -29470,6 +29563,7 @@ var init_cassette_authoring = __esm({
     "use strict";
     init_esm_shims();
     init_zod();
+    init_gateway_client();
     recordSchema = external_exports2.record(external_exports2.unknown());
     draftSchema = {
       description: external_exports2.string().min(1).describe("Natural-language description of the cassette to author."),
@@ -29481,7 +29575,8 @@ var init_cassette_authoring = __esm({
     refineSchema = {
       draft_id: external_exports2.string().min(1),
       answers: recordSchema.optional(),
-      yaml_patch: external_exports2.string().min(1).optional()
+      yaml_patch: external_exports2.string().min(1).optional().describe("Full YAML replacement for the draft, not a partial patch."),
+      yaml: external_exports2.string().min(1).optional().describe("Full YAML replacement for the draft (alias of yaml_patch).")
     };
     dryRunSchema = {
       draft_id: external_exports2.string().min(1),
@@ -29489,7 +29584,7 @@ var init_cassette_authoring = __esm({
     };
     publishSchema = {
       draft_id: external_exports2.string().min(1),
-      name: external_exports2.string().min(1),
+      name: external_exports2.string().min(1).optional(),
       version: external_exports2.number().int().min(1).optional()
     };
     getSchema = {
@@ -34574,7 +34669,7 @@ init_esm_shims();
 init_esm_shims();
 
 // package.json
-var version = "0.2.0";
+var version = "0.3.0";
 
 // src/lib/version.ts
 var BOOMBOX_VERSION = version;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@konstantdotcloud/boombox",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Local Boombox runtime for Konstant cassettes — CLI, stdio MCP server, and local Hono proxy.",
   "license": "UNLICENSED",
   "type": "module",

package/ui/README.md

@@ -50,12 +50,14 @@ ui/
 ## Scripts
 
 ```bash
-pnpm install
-pnpm dev      # vite dev server, http://localhost:5173
-pnpm build    # tsc --noEmit && vite build → dist/
-pnpm test     # vitest run
+npm install
+npm run dev   # vite dev server, http://localhost:5173
+npm run build # tsc --noEmit && vite build → dist/
+npm test      # vitest run
 ```
 
+(The parent package builds this UI via `build:ui` = `cd ui && npm install && npm run build`.)
+
 ## Theme system
 
 `<ThemeProvider>` writes `data-theme` to `<html>` and persists to
@@ -111,10 +113,10 @@ that follow-up waves need to wire:
    already injects `Authorization: Bearer <api_key>` for `/api/*`. The UI
    should hit the proxy directly with no token, since the proxy adds it.
    `client.ts` accepts a null token for that path.
-3. **`boombox serve` static-serve integration.** Currently `pnpm build`
-   produces `ui/dist/`. The CLI's `boombox serve --http` should mount that
-   directory (or fetch the latest UI bundle from the gateway). Tracked as a
-   TODO in `src/cli/serve.ts`.
+3. **`boombox serve` static-serve integration.** ✅ DONE — `boombox serve --http`
+   mounts `ui/dist/` from the local Hono proxy, serving the SPA at `/` and returning
+   `503 ui_not_built` when the bundle is absent. Run `npm run build` here (or the
+   parent's `build:ui`) to produce `ui/dist/`.
 4. **Cloud API endpoint shapes.** `api/types.ts` mirrors the cassette
    substrate. Once Wave 5b-ApprovalGate endpoints stabilize, regenerate the
    types so this package stays a faithful client (instead of duplicating).