@launchchair/agent 0.5.0 → 0.5.2

package/mcp-widgets.mjs

@@ -0,0 +1,74 @@
+import { readFileSync } from "node:fs";
+import { createHash } from "node:crypto";
+
+const html = readFileSync(new URL("./mcp-widget.html", import.meta.url), "utf8");
+// Content-addressed resources prevent hosts from reusing an older UI bundle.
+export const WIDGET_URI = `ui://launchchair/project-${createHash("sha256").update(html).digest("hex").slice(0, 12)}.html`;
+const mimeType = "text/html;profile=mcp-app";
+const project = { projectId: { type: "string" }, projectName: { type: "string" } };
+
+export const MCP_WIDGET_TOOLS = [
+  ["show_choices", "Show the interactive, tabbed choice widget at a choice step or after selecting a choice. Reads the canonical options and saved selection. Users can save an explicit option and choose a next action.", { ...project, phaseKey: { type: "string" }, bucketKey: { type: "string" } }, ["phaseKey", "bucketKey"]],
+  ["show_phase_synthesis", "Show a tabbed phase synthesis widget after a phase completes. Reads the existing synthesis and verified bucket progress, with next actions. Incomplete phases are explicitly labeled in progress.", { ...project, phaseKey: { type: "string" } }, ["phaseKey"]],
+  ["show_validation_scores", "Show tabbed Product or Feature validation scorecards, their inputs, and separate direction options. Use after get_scorecards or when presenting validation results. Includes next actions.", project, []],
+].map(([shortName, description, properties, required]) => ({
+  name: `launchchair_${shortName}`,
+  description,
+  inputSchema: { type: "object", properties, required, additionalProperties: false },
+  annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
+  _meta: {
+    ui: { resourceUri: WIDGET_URI, visibility: ["model", "app"] },
+    "openai/outputTemplate": WIDGET_URI,
+    "openai/widgetAccessible": true,
+  },
+}));
+
+export const MCP_WIDGET_INSTRUCTIONS = "Use LaunchChair AUX widgets when presenting decisions and phase results: call launchchair_show_choices at user-choice checkpoints and after saving a selection, launchchair_show_phase_synthesis for each newly completed phase, and launchchair_show_validation_scores for validation results. These read tools render tabbed MCP Apps with Next action controls; keep using data tools to execute the workflow. If the host cannot render MCP Apps, summarize the returned structured data and provide the returned URLs. Never claim the widget rendered in a host without evidence.";
+
+export function listWidgetResources() {
+  return [{ uri: WIDGET_URI, name: "LaunchChair project widgets", description: "LaunchChair choices, phase synthesis and validation scores", mimeType }];
+}
+
+export function readWidgetResource(uri) {
+  if (uri !== WIDGET_URI) throw new Error("Unknown LaunchChair UI resource.");
+  return { contents: [{ uri: WIDGET_URI, mimeType, text: html, _meta: {
+    ui: { prefersBorder: false, csp: { connectDomains: [], resourceDomains: ["https://fonts.googleapis.com", "https://fonts.gstatic.com"] } },
+    "openai/widgetDescription": "LaunchChair design-system tabs, saved choices, synthesis and validation scores with Next action controls.",
+  } }] };
+}
+
+export async function callWidgetTool(name, args, { api, resolveProjectId, baseUrl }) {
+  const projectId = await resolveProjectId(args);
+  const root = `/api/agent/v1/projects/${encodeURIComponent(projectId)}`;
+  let data;
+  let type;
+  const renderArguments = { projectId };
+  if (name === "launchchair_show_choices") {
+    if (!args.phaseKey || !args.bucketKey) throw new Error("phaseKey and bucketKey are required.");
+    Object.assign(renderArguments, { phaseKey: args.phaseKey, bucketKey: args.bucketKey });
+    data = await api(`${root}/buckets/${encodeURIComponent(args.phaseKey)}/${encodeURIComponent(args.bucketKey)}`);
+    if (!data?.choice || !Array.isArray(data.choice.options)) throw new Error("This bucket does not expose generated choices. Update the LaunchChair API before using this widget.");
+    type = "choices";
+  } else if (name === "launchchair_show_phase_synthesis") {
+    if (!args.phaseKey) throw new Error("phaseKey is required.");
+    renderArguments.phaseKey = args.phaseKey;
+    data = await api(`${root}/exports/phase/${encodeURIComponent(args.phaseKey)}?format=json`);
+    if (typeof data?.markdown !== "string" || typeof data?.percentage !== "number" || !data?.spec || typeof data.spec !== "object") throw new Error("Structured synthesis is unavailable. Update the LaunchChair API before using this widget.");
+    // The rich view consumes spec; text-only clients get the narrative without a
+    // second copy of the complete spec from the Markdown export's appendix.
+    data.markdown = data.markdown.split("\n## Complete Phase Data")[0].trim();
+    type = "synthesis";
+  } else if (name === "launchchair_show_validation_scores") {
+    data = await api(`${root}/scorecards`);
+    if (!Array.isArray(data?.scorecards)) throw new Error("Validation scorecards are unavailable.");
+    data.url = new URL(`/app/phase-summary/market_validation?projectId=${encodeURIComponent(projectId)}`, baseUrl).toString();
+    type = "scores";
+  } else {
+    throw new Error("Unknown LaunchChair widget tool.");
+  }
+  const widget = { ...data, projectId, type, renderTool: name, renderArguments };
+  return {
+    structuredContent: { widget },
+    content: [{ type: "text", text: JSON.stringify(widget, null, 2) }],
+  };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@launchchair/agent",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "mcpName": "io.launchchair/agent",
   "description": "LaunchChair Agent CLI, MCP bridge, local bridge, and runners for Codex, Claude Code, ChatGPT, Claude, and Hermes workflows.",
   "type": "module",
@@ -16,6 +16,8 @@
     "local-bridge.mjs",
     "mcp-bridge-server.mjs",
     "mcp-capabilities.mjs",
+    "mcp-widgets.mjs",
+    "mcp-widget.html",
     "project-workspace.mjs",
     "runner-command.mjs",
     "codex-runner.mjs",

package/server.json

@@ -3,13 +3,13 @@
   "name": "io.launchchair/agent",
   "title": "LaunchChair",
   "description": "Plan, validate, and build products and features with LaunchChair.",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "websiteUrl": "https://www.launchchair.io/docs/mcp",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@launchchair/agent",
-      "version": "0.5.0",
+      "version": "0.5.2",
       "runtimeHint": "npx",
       "runtimeArguments": [
         {