@seed-ship/mcp-ui-solid 3.0.1 → 3.0.3

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA;AAGjG,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAA;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AAGhE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAG9D,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAA;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAA;AAE1E,YAAY,EACV,uBAAuB,EACvB,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,cAAc,CAAA;AAErB,YAAY,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAA;AAC5E,YAAY,EAAE,iBAAiB,IAAI,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AAChG,YAAY,EAAE,+BAA+B,EAAE,MAAM,yCAAyC,CAAA;AAC9F,YAAY,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAA;AAC5E,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AACtG,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC9D,YAAY,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AACxE,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AACjF,YAAY,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAA;AAClF,YAAY,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAA;AAGjH,OAAO,EACL,cAAc,EACd,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,QAAQ,EACR,eAAe,EACf,kBAAkB,EAElB,WAAW,EACX,SAAS,EAET,eAAe,GAChB,MAAM,SAAS,CAAA;AAEhB,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,0BAA0B,EAC1B,cAAc,EACd,qBAAqB,EACrB,yBAAyB,EACzB,wBAAwB,EAExB,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,UAAU,EAEV,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,SAAS,CAAA;AAGhB,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAE/F,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,+BAA+B,CAAA;AAEtC,YAAY,EACV,qBAAqB,EACrB,sBAAsB,EACtB,aAAa,EACb,YAAY,GACb,MAAM,WAAW,CAAA;AAElB,YAAY,EACV,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,+BAA+B,CAAA;AAItC,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,WAAW,CAAA;AAMlB,YAAY,EACV,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EAEnB,eAAe,EACf,aAAa,EACb,eAAe,EACf,mBAAmB,EAEnB,gBAAgB,EAChB,iBAAiB,EAEjB,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EAExB,SAAS,EACT,oBAAoB,EAEpB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EAEjB,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EAEpB,mBAAmB,EACnB,SAAS,EACT,kBAAkB,EAElB,YAAY,EACZ,iBAAiB,EAEjB,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,sBAAsB,IAAI,0BAA0B,EAEpD,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,SAAS,CAAA;AAGhB,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,uBAAuB,GACxB,MAAM,YAAY,CAAA;AAGnB,YAAY,EACV,aAAa,EACb,UAAU,EACV,YAAY,EACZ,OAAO,EACP,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,SAAS,EACT,QAAQ,EACR,aAAa,EACb,kBAAkB,GACnB,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -22,6 +22,7 @@ import { ComponentToolbar } from "./components/ComponentToolbar.js";
 import { ChatBusProvider, useChatBus } from "./hooks/useChatBus.js";
 import { ChatPrompt } from "./components/ChatPrompt.js";
 import { ScratchpadPanel } from "./components/ScratchpadPanel.js";
+import { dispatchScratchpad, useScratchpadState } from "./stores/scratchpad-store.js";
 import { GhostText, GhostTextInput } from "./components/GhostText.js";
 import { AutocompleteDropdown } from "./components/AutocompleteDropdown.js";
 import { AutocompleteFormField } from "./components/AutocompleteFormField.js";
@@ -70,6 +71,7 @@ export {
   createGroqPlugin,
   createRestPlugin,
   createSupabasePlugin,
+  dispatchScratchpad,
   evaluateCondition,
   getIframeSandbox,
   mergeScratchpadSections,
@@ -86,6 +88,7 @@ export {
   useMCPActionSafe,
   useModal,
   useResize,
+  useScratchpadState,
   useStreamingUI,
   useToolAction,
   validateComponent,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/stores/scratchpad-store.cjs

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const store = require("solid-js/store");
+const [scratchpadStore, setScratchpadStore] = store.createStore({ current: null, pinned: false });
+function useScratchpadState() {
+  return {
+    state: () => scratchpadStore.current,
+    pinned: () => scratchpadStore.pinned,
+    close: () => setScratchpadStore({ current: null, pinned: false })
+  };
+}
+function dispatchScratchpad(event) {
+  var _a, _b;
+  if (event.action === "create") {
+    console.info(
+      `%c[MCP-UI] dispatchScratchpad%c create id=${event.id} sections=${((_a = event.sections) == null ? void 0 : _a.length) || 0} status=${event.status || "loading"}${event.pinned ? " pinned" : ""}`,
+      "color: #10b981; font-weight: bold",
+      "color: inherit"
+    );
+    setScratchpadStore({
+      current: {
+        id: event.id,
+        title: event.title || "",
+        sections: event.sections || [],
+        filters: event.filters || {},
+        preview: event.preview,
+        agentMessages: event.agentMessages || [],
+        status: event.status || "loading",
+        previewEndpoint: event.previewEndpoint,
+        previewDebounce: event.previewDebounce,
+        previewMethod: event.previewMethod,
+        previewHeaders: event.previewHeaders,
+        turn: event.turn,
+        totalTurns: event.totalTurns,
+        turnHistory: event.turnHistory
+      },
+      pinned: event.pinned || false
+    });
+  } else if (event.action === "update") {
+    console.info(
+      `%c[MCP-UI] dispatchScratchpad%c update id=${event.id} sectionMode=${event.sectionMode || "replace"} sections=${((_b = event.sections) == null ? void 0 : _b.length) || 0} status=${event.status || "-"}`,
+      "color: #3b82f6; font-weight: bold",
+      "color: inherit"
+    );
+    setScratchpadStore(store.produce((s) => {
+      var _a2;
+      if (!s.current || s.current.id !== event.id) {
+        console.warn(`[MCP-UI] dispatchScratchpad: update for id=${event.id} but current is ${((_a2 = s.current) == null ? void 0 : _a2.id) || "null"}. Ignoring.`);
+        return;
+      }
+      if (event.sections) {
+        const mode = event.sectionMode || "replace";
+        if (mode === "replace") {
+          s.current.sections = event.sections;
+        } else if (mode === "append") {
+          s.current.sections = [...s.current.sections, ...event.sections];
+        } else if (mode === "upsert") {
+          let matchCount = 0;
+          for (const incoming of event.sections) {
+            const idx = s.current.sections.findIndex((sec) => sec.id === incoming.id);
+            if (idx >= 0) {
+              s.current.sections[idx] = incoming;
+              matchCount++;
+            } else {
+              s.current.sections.push(incoming);
+            }
+          }
+          if (matchCount === 0 && event.sections.length > 0) {
+            console.warn(
+              `[MCP-UI] dispatchScratchpad: sectionMode='upsert' but no IDs matched. Incoming: [${event.sections.map((s2) => s2.id).join(", ")}] Existing: [${s.current.sections.map((s2) => s2.id).join(", ")}]. All appended.`
+            );
+          }
+        }
+      }
+      if (event.agentMessages) s.current.agentMessages = event.agentMessages;
+      if (event.status) s.current.status = event.status;
+      if (event.filters) s.current.filters = event.filters;
+      if (event.preview) s.current.preview = event.preview;
+      if (event.pinned != null) s.pinned = event.pinned;
+      if (event.turnHistory) s.current.turnHistory = event.turnHistory;
+      if (event.turn != null) s.current.turn = event.turn;
+    }));
+  } else if (event.action === "close") {
+    console.info(`%c[MCP-UI] dispatchScratchpad%c close id=${event.id}`, "color: #6b7280; font-weight: bold", "color: inherit");
+    setScratchpadStore({ current: null, pinned: false });
+  }
+}
+exports.dispatchScratchpad = dispatchScratchpad;
+exports.useScratchpadState = useScratchpadState;
+//# sourceMappingURL=scratchpad-store.cjs.map

package/dist/stores/scratchpad-store.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"scratchpad-store.cjs","sources":["../../src/stores/scratchpad-store.ts"],"sourcesContent":["/**\n * Scratchpad Store — singleton reactive state for HITL scratchpad\n * v3.0.3: Eliminates ChatBus relay chain race condition\n *\n * @experimental\n *\n * Parser calls dispatchScratchpad() → store updates → ScratchpadPanel reads reactively.\n * Zero bus, zero relay, zero race condition.\n */\n\nimport { createStore, produce } from 'solid-js/store'\nimport type { ScratchpadState, ScratchpadEvent, ScratchpadSection } from '../types/chat-bus'\n\nconst [scratchpadStore, setScratchpadStore] = createStore<{\n  current: ScratchpadState | null\n  pinned: boolean\n}>({ current: null, pinned: false })\n\n/**\n * Hook for the COMPONENT — reads the scratchpad state reactively.\n *\n * @example\n * const { state, pinned, close } = useScratchpadState()\n * <Show when={state()}>\n *   <ScratchpadPanel state={state()!} pinned={pinned()} onClose={close} />\n * </Show>\n */\nexport function useScratchpadState() {\n  return {\n    state: () => scratchpadStore.current,\n    pinned: () => scratchpadStore.pinned,\n    close: () => setScratchpadStore({ current: null, pinned: false }),\n  }\n}\n\n/**\n * Function for the PARSER/STORE — mutates the scratchpad state.\n * Called from the SSE callback, no bus needed.\n *\n * @example\n * // In your SSE parser callback — ONE LINE\n * onScratchpad: (data) => dispatchScratchpad(data as ScratchpadEvent)\n */\nexport function dispatchScratchpad(event: ScratchpadEvent): void {\n  // DX1: lifecycle logging\n  if (event.action === 'create') {\n    console.info(\n      `%c[MCP-UI] dispatchScratchpad%c create id=${event.id} sections=${event.sections?.length || 0} status=${event.status || 'loading'}${event.pinned ? ' pinned' : ''}`,\n      'color: #10b981; font-weight: bold', 'color: inherit'\n    )\n    setScratchpadStore({\n      current: {\n        id: event.id,\n        title: event.title || '',\n        sections: event.sections || [],\n        filters: event.filters || {},\n        preview: event.preview,\n        agentMessages: event.agentMessages || [],\n        status: event.status || 'loading',\n        previewEndpoint: (event as any).previewEndpoint,\n        previewDebounce: (event as any).previewDebounce,\n        previewMethod: (event as any).previewMethod,\n        previewHeaders: (event as any).previewHeaders,\n        turn: (event as any).turn,\n        totalTurns: (event as any).totalTurns,\n        turnHistory: (event as any).turnHistory,\n      },\n      pinned: event.pinned || false,\n    })\n  } else if (event.action === 'update') {\n    console.info(\n      `%c[MCP-UI] dispatchScratchpad%c update id=${event.id} sectionMode=${event.sectionMode || 'replace'} sections=${event.sections?.length || 0} status=${event.status || '-'}`,\n      'color: #3b82f6; font-weight: bold', 'color: inherit'\n    )\n    setScratchpadStore(produce((s) => {\n      if (!s.current || s.current.id !== event.id) {\n        console.warn(`[MCP-UI] dispatchScratchpad: update for id=${event.id} but current is ${s.current?.id || 'null'}. Ignoring.`)\n        return\n      }\n\n      if (event.sections) {\n        const mode = event.sectionMode || 'replace'\n        if (mode === 'replace') {\n          s.current.sections = event.sections\n        } else if (mode === 'append') {\n          s.current.sections = [...s.current.sections, ...event.sections]\n        } else if (mode === 'upsert') {\n          let matchCount = 0\n          for (const incoming of event.sections) {\n            const idx = s.current.sections.findIndex((sec: ScratchpadSection) => sec.id === incoming.id)\n            if (idx >= 0) {\n              s.current.sections[idx] = incoming\n              matchCount++\n            } else {\n              s.current.sections.push(incoming)\n            }\n          }\n          if (matchCount === 0 && event.sections.length > 0) {\n            console.warn(\n              `[MCP-UI] dispatchScratchpad: sectionMode='upsert' but no IDs matched. ` +\n              `Incoming: [${event.sections.map((s: ScratchpadSection) => s.id).join(', ')}] ` +\n              `Existing: [${s.current.sections.map((s: ScratchpadSection) => s.id).join(', ')}]. All appended.`\n            )\n          }\n        }\n      }\n      if (event.agentMessages) s.current.agentMessages = event.agentMessages\n      if (event.status) s.current.status = event.status\n      if (event.filters) s.current.filters = event.filters\n      if (event.preview) s.current.preview = event.preview\n      if (event.pinned != null) s.pinned = event.pinned\n      if ((event as any).turnHistory) s.current.turnHistory = (event as any).turnHistory\n      if ((event as any).turn != null) s.current.turn = (event as any).turn\n    }))\n  } else if (event.action === 'close') {\n    console.info(`%c[MCP-UI] dispatchScratchpad%c close id=${event.id}`, 'color: #6b7280; font-weight: bold', 'color: inherit')\n    setScratchpadStore({ current: null, pinned: false })\n  }\n}\n"],"names":["createStore","produce","_a","s"],"mappings":"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"}

package/dist/stores/scratchpad-store.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Scratchpad Store — singleton reactive state for HITL scratchpad
+ * v3.0.3: Eliminates ChatBus relay chain race condition
+ *
+ * @experimental
+ *
+ * Parser calls dispatchScratchpad() → store updates → ScratchpadPanel reads reactively.
+ * Zero bus, zero relay, zero race condition.
+ */
+import type { ScratchpadState, ScratchpadEvent } from '../types/chat-bus';
+/**
+ * Hook for the COMPONENT — reads the scratchpad state reactively.
+ *
+ * @example
+ * const { state, pinned, close } = useScratchpadState()
+ * <Show when={state()}>
+ *   <ScratchpadPanel state={state()!} pinned={pinned()} onClose={close} />
+ * </Show>
+ */
+export declare function useScratchpadState(): {
+    state: () => ScratchpadState | null;
+    pinned: () => boolean;
+    close: () => void;
+};
+/**
+ * Function for the PARSER/STORE — mutates the scratchpad state.
+ * Called from the SSE callback, no bus needed.
+ *
+ * @example
+ * // In your SSE parser callback — ONE LINE
+ * onScratchpad: (data) => dispatchScratchpad(data as ScratchpadEvent)
+ */
+export declare function dispatchScratchpad(event: ScratchpadEvent): void;
+//# sourceMappingURL=scratchpad-store.d.ts.map

package/dist/stores/scratchpad-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scratchpad-store.d.ts","sourceRoot":"","sources":["../../src/stores/scratchpad-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAqB,MAAM,mBAAmB,CAAA;AAO5F;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB;;;;EAMjC;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CA2E/D"}

package/dist/stores/scratchpad-store.js

@@ -0,0 +1,90 @@
+import { createStore, produce } from "solid-js/store";
+const [scratchpadStore, setScratchpadStore] = createStore({ current: null, pinned: false });
+function useScratchpadState() {
+  return {
+    state: () => scratchpadStore.current,
+    pinned: () => scratchpadStore.pinned,
+    close: () => setScratchpadStore({ current: null, pinned: false })
+  };
+}
+function dispatchScratchpad(event) {
+  var _a, _b;
+  if (event.action === "create") {
+    console.info(
+      `%c[MCP-UI] dispatchScratchpad%c create id=${event.id} sections=${((_a = event.sections) == null ? void 0 : _a.length) || 0} status=${event.status || "loading"}${event.pinned ? " pinned" : ""}`,
+      "color: #10b981; font-weight: bold",
+      "color: inherit"
+    );
+    setScratchpadStore({
+      current: {
+        id: event.id,
+        title: event.title || "",
+        sections: event.sections || [],
+        filters: event.filters || {},
+        preview: event.preview,
+        agentMessages: event.agentMessages || [],
+        status: event.status || "loading",
+        previewEndpoint: event.previewEndpoint,
+        previewDebounce: event.previewDebounce,
+        previewMethod: event.previewMethod,
+        previewHeaders: event.previewHeaders,
+        turn: event.turn,
+        totalTurns: event.totalTurns,
+        turnHistory: event.turnHistory
+      },
+      pinned: event.pinned || false
+    });
+  } else if (event.action === "update") {
+    console.info(
+      `%c[MCP-UI] dispatchScratchpad%c update id=${event.id} sectionMode=${event.sectionMode || "replace"} sections=${((_b = event.sections) == null ? void 0 : _b.length) || 0} status=${event.status || "-"}`,
+      "color: #3b82f6; font-weight: bold",
+      "color: inherit"
+    );
+    setScratchpadStore(produce((s) => {
+      var _a2;
+      if (!s.current || s.current.id !== event.id) {
+        console.warn(`[MCP-UI] dispatchScratchpad: update for id=${event.id} but current is ${((_a2 = s.current) == null ? void 0 : _a2.id) || "null"}. Ignoring.`);
+        return;
+      }
+      if (event.sections) {
+        const mode = event.sectionMode || "replace";
+        if (mode === "replace") {
+          s.current.sections = event.sections;
+        } else if (mode === "append") {
+          s.current.sections = [...s.current.sections, ...event.sections];
+        } else if (mode === "upsert") {
+          let matchCount = 0;
+          for (const incoming of event.sections) {
+            const idx = s.current.sections.findIndex((sec) => sec.id === incoming.id);
+            if (idx >= 0) {
+              s.current.sections[idx] = incoming;
+              matchCount++;
+            } else {
+              s.current.sections.push(incoming);
+            }
+          }
+          if (matchCount === 0 && event.sections.length > 0) {
+            console.warn(
+              `[MCP-UI] dispatchScratchpad: sectionMode='upsert' but no IDs matched. Incoming: [${event.sections.map((s2) => s2.id).join(", ")}] Existing: [${s.current.sections.map((s2) => s2.id).join(", ")}]. All appended.`
+            );
+          }
+        }
+      }
+      if (event.agentMessages) s.current.agentMessages = event.agentMessages;
+      if (event.status) s.current.status = event.status;
+      if (event.filters) s.current.filters = event.filters;
+      if (event.preview) s.current.preview = event.preview;
+      if (event.pinned != null) s.pinned = event.pinned;
+      if (event.turnHistory) s.current.turnHistory = event.turnHistory;
+      if (event.turn != null) s.current.turn = event.turn;
+    }));
+  } else if (event.action === "close") {
+    console.info(`%c[MCP-UI] dispatchScratchpad%c close id=${event.id}`, "color: #6b7280; font-weight: bold", "color: inherit");
+    setScratchpadStore({ current: null, pinned: false });
+  }
+}
+export {
+  dispatchScratchpad,
+  useScratchpadState
+};
+//# sourceMappingURL=scratchpad-store.js.map

package/dist/stores/scratchpad-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scratchpad-store.js","sources":["../../src/stores/scratchpad-store.ts"],"sourcesContent":["/**\n * Scratchpad Store — singleton reactive state for HITL scratchpad\n * v3.0.3: Eliminates ChatBus relay chain race condition\n *\n * @experimental\n *\n * Parser calls dispatchScratchpad() → store updates → ScratchpadPanel reads reactively.\n * Zero bus, zero relay, zero race condition.\n */\n\nimport { createStore, produce } from 'solid-js/store'\nimport type { ScratchpadState, ScratchpadEvent, ScratchpadSection } from '../types/chat-bus'\n\nconst [scratchpadStore, setScratchpadStore] = createStore<{\n  current: ScratchpadState | null\n  pinned: boolean\n}>({ current: null, pinned: false })\n\n/**\n * Hook for the COMPONENT — reads the scratchpad state reactively.\n *\n * @example\n * const { state, pinned, close } = useScratchpadState()\n * <Show when={state()}>\n *   <ScratchpadPanel state={state()!} pinned={pinned()} onClose={close} />\n * </Show>\n */\nexport function useScratchpadState() {\n  return {\n    state: () => scratchpadStore.current,\n    pinned: () => scratchpadStore.pinned,\n    close: () => setScratchpadStore({ current: null, pinned: false }),\n  }\n}\n\n/**\n * Function for the PARSER/STORE — mutates the scratchpad state.\n * Called from the SSE callback, no bus needed.\n *\n * @example\n * // In your SSE parser callback — ONE LINE\n * onScratchpad: (data) => dispatchScratchpad(data as ScratchpadEvent)\n */\nexport function dispatchScratchpad(event: ScratchpadEvent): void {\n  // DX1: lifecycle logging\n  if (event.action === 'create') {\n    console.info(\n      `%c[MCP-UI] dispatchScratchpad%c create id=${event.id} sections=${event.sections?.length || 0} status=${event.status || 'loading'}${event.pinned ? ' pinned' : ''}`,\n      'color: #10b981; font-weight: bold', 'color: inherit'\n    )\n    setScratchpadStore({\n      current: {\n        id: event.id,\n        title: event.title || '',\n        sections: event.sections || [],\n        filters: event.filters || {},\n        preview: event.preview,\n        agentMessages: event.agentMessages || [],\n        status: event.status || 'loading',\n        previewEndpoint: (event as any).previewEndpoint,\n        previewDebounce: (event as any).previewDebounce,\n        previewMethod: (event as any).previewMethod,\n        previewHeaders: (event as any).previewHeaders,\n        turn: (event as any).turn,\n        totalTurns: (event as any).totalTurns,\n        turnHistory: (event as any).turnHistory,\n      },\n      pinned: event.pinned || false,\n    })\n  } else if (event.action === 'update') {\n    console.info(\n      `%c[MCP-UI] dispatchScratchpad%c update id=${event.id} sectionMode=${event.sectionMode || 'replace'} sections=${event.sections?.length || 0} status=${event.status || '-'}`,\n      'color: #3b82f6; font-weight: bold', 'color: inherit'\n    )\n    setScratchpadStore(produce((s) => {\n      if (!s.current || s.current.id !== event.id) {\n        console.warn(`[MCP-UI] dispatchScratchpad: update for id=${event.id} but current is ${s.current?.id || 'null'}. Ignoring.`)\n        return\n      }\n\n      if (event.sections) {\n        const mode = event.sectionMode || 'replace'\n        if (mode === 'replace') {\n          s.current.sections = event.sections\n        } else if (mode === 'append') {\n          s.current.sections = [...s.current.sections, ...event.sections]\n        } else if (mode === 'upsert') {\n          let matchCount = 0\n          for (const incoming of event.sections) {\n            const idx = s.current.sections.findIndex((sec: ScratchpadSection) => sec.id === incoming.id)\n            if (idx >= 0) {\n              s.current.sections[idx] = incoming\n              matchCount++\n            } else {\n              s.current.sections.push(incoming)\n            }\n          }\n          if (matchCount === 0 && event.sections.length > 0) {\n            console.warn(\n              `[MCP-UI] dispatchScratchpad: sectionMode='upsert' but no IDs matched. ` +\n              `Incoming: [${event.sections.map((s: ScratchpadSection) => s.id).join(', ')}] ` +\n              `Existing: [${s.current.sections.map((s: ScratchpadSection) => s.id).join(', ')}]. All appended.`\n            )\n          }\n        }\n      }\n      if (event.agentMessages) s.current.agentMessages = event.agentMessages\n      if (event.status) s.current.status = event.status\n      if (event.filters) s.current.filters = event.filters\n      if (event.preview) s.current.preview = event.preview\n      if (event.pinned != null) s.pinned = event.pinned\n      if ((event as any).turnHistory) s.current.turnHistory = (event as any).turnHistory\n      if ((event as any).turn != null) s.current.turn = (event as any).turn\n    }))\n  } else if (event.action === 'close') {\n    console.info(`%c[MCP-UI] dispatchScratchpad%c close id=${event.id}`, 'color: #6b7280; font-weight: bold', 'color: inherit')\n    setScratchpadStore({ current: null, pinned: false })\n  }\n}\n"],"names":["_a","s"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seed-ship/mcp-ui-solid",
-  "version": "3.0.1",
+  "version": "3.0.3",
   "description": "SolidJS components for rendering MCP-generated UI resources",
   "type": "module",
   "main": "./dist/index.cjs",

package/src/components/ScratchpadPanel.tsx

@@ -63,10 +63,49 @@ export const ScratchpadPanel: Component<ScratchpadPanelProps> = (props) => {
     console.log(`[ScratchpadPanel:${props.state.id}] ${event}`, data || '')
   }
 
+  // ─── DX1: Proactive console messages (always, not just debug) ───
+
+  const VALID_TRANSITIONS: Record<string, string[]> = {
+    loading: ['processing', 'waiting_human', 'error'],
+    waiting_human: ['processing', 'ready', 'complete', 'error'],
+    processing: ['ready', 'complete', 'error', 'waiting_human'],
+    ready: ['processing', 'complete', 'error', 'waiting_human'],
+    complete: [],
+    error: ['processing', 'ready', 'waiting_human'],
+  }
+  let prevStatus = props.state.status
+
+  // Etape 1: create log
+  console.info(
+    `%c[MCP-UI] Scratchpad created%c id=${props.state.id} sections=${props.state.sections?.length || 0} status=${props.state.status}${props.pinned ? ' pinned=true' : ''}`,
+    'color: #10b981; font-weight: bold', 'color: inherit'
+  )
+
+  // Etape 3: status transitions + Etape 4: auto-close info
+  createEffect(() => {
+    const newStatus = props.state.status
+    if (newStatus !== prevStatus) {
+      console.info(`%c[MCP-UI] Scratchpad status%c ${props.state.id}: ${prevStatus} → ${newStatus}`, 'color: #3b82f6; font-weight: bold', 'color: inherit')
+      if (!VALID_TRANSITIONS[prevStatus]?.includes(newStatus)) {
+        console.warn(`[MCP-UI] Scratchpad ${props.state.id}: unusual transition ${prevStatus} → ${newStatus}. Expected: ${VALID_TRANSITIONS[prevStatus]?.join(', ') || 'none (terminal)'}`)
+      }
+      prevStatus = newStatus
+    }
+    // Etape 4
+    if (props.autoCloseDelay && newStatus !== 'complete') {
+      console.info(`[MCP-UI] Scratchpad ${props.state.id}: autoCloseDelay=${props.autoCloseDelay}ms but status='${newStatus}' — auto-close will NOT trigger.`)
+    }
+  })
+
   // Action aliases that auto-close the scratchpad
   const CLOSE_ALIASES = new Set(['done', 'close', 'dismiss', 'validate', 'cancel', 'sufficient'])
 
   const handleAction = (action: string, data?: unknown) => {
+    // DX1 Etape 5: action dispatch
+    console.info(`%c[MCP-UI] Action dispatched%c value='${action}' asyncAction=${!!props.asyncAction}`, 'color: #f59e0b; font-weight: bold', 'color: inherit')
+    if (!props.asyncAction && /^(try_alt:|retry|fetch|load)/.test(action)) {
+      console.warn(`[MCP-UI] ScratchpadPanel: action '${action}' looks async but asyncAction prop is not set. The button will NOT show a loading state.`)
+    }
     debugLog('onAction', { action, asyncAction: props.asyncAction, data })
     if (props.asyncAction && !CLOSE_ALIASES.has(action)) {
       setLoadingAction(action)
@@ -503,6 +542,9 @@ const EmbeddedFormSection: Component<{
         .filter(([, v]) => v !== undefined && v !== '' && !(Array.isArray(v) && v.length === 0))
     )
 
+    // DX1 Etape 7: form submit log
+    console.info(`%c[MCP-UI] Form submitted%c section=${props.sectionId} fields=${Object.keys(values).join(',')}`, 'color: #8b5cf6; font-weight: bold', 'color: inherit')
+
     if (props.onSubmit) {
       props.onSubmit(props.sectionId, values)
     } else {
@@ -849,7 +891,10 @@ const ErrorSectionRenderer: Component<{
   const [showDetails, setShowDetails] = createSignal(false)
   const data = () => {
     const c = props.content as any
-    return { message: c?.message || 'Error', severity: c?.severity || 'error', retryAction: c?.retryAction, retryLabel: c?.retryLabel || 'Retry', details: c?.details, timestamp: c?.timestamp }
+    const d = { message: c?.message || 'Error', severity: c?.severity || 'error', retryAction: c?.retryAction, retryLabel: c?.retryLabel || 'Retry', details: c?.details, timestamp: c?.timestamp }
+    // DX1 Etape 8
+    console.info(`%c[MCP-UI] Error section rendered%c severity=${d.severity} retry=${!!d.retryAction}`, 'color: #ef4444; font-weight: bold', 'color: inherit')
+    return d
   }
   const isWarning = () => data().severity === 'warning'
 

package/src/index.ts

@@ -42,6 +42,7 @@ export { ComponentToolbar } from './components/ComponentToolbar'
 export { ChatBusProvider, useChatBus } from './hooks/useChatBus'
 export { ChatPrompt } from './components/ChatPrompt'
 export { ScratchpadPanel } from './components/ScratchpadPanel'
+export { dispatchScratchpad, useScratchpadState } from './stores/scratchpad-store'
 
 // Autocomplete Components
 export { GhostText, GhostTextInput } from './components/GhostText'

package/src/stores/scratchpad-store.ts

@@ -0,0 +1,119 @@
+/**
+ * Scratchpad Store — singleton reactive state for HITL scratchpad
+ * v3.0.3: Eliminates ChatBus relay chain race condition
+ *
+ * @experimental
+ *
+ * Parser calls dispatchScratchpad() → store updates → ScratchpadPanel reads reactively.
+ * Zero bus, zero relay, zero race condition.
+ */
+
+import { createStore, produce } from 'solid-js/store'
+import type { ScratchpadState, ScratchpadEvent, ScratchpadSection } from '../types/chat-bus'
+
+const [scratchpadStore, setScratchpadStore] = createStore<{
+  current: ScratchpadState | null
+  pinned: boolean
+}>({ current: null, pinned: false })
+
+/**
+ * Hook for the COMPONENT — reads the scratchpad state reactively.
+ *
+ * @example
+ * const { state, pinned, close } = useScratchpadState()
+ * <Show when={state()}>
+ *   <ScratchpadPanel state={state()!} pinned={pinned()} onClose={close} />
+ * </Show>
+ */
+export function useScratchpadState() {
+  return {
+    state: () => scratchpadStore.current,
+    pinned: () => scratchpadStore.pinned,
+    close: () => setScratchpadStore({ current: null, pinned: false }),
+  }
+}
+
+/**
+ * Function for the PARSER/STORE — mutates the scratchpad state.
+ * Called from the SSE callback, no bus needed.
+ *
+ * @example
+ * // In your SSE parser callback — ONE LINE
+ * onScratchpad: (data) => dispatchScratchpad(data as ScratchpadEvent)
+ */
+export function dispatchScratchpad(event: ScratchpadEvent): void {
+  // DX1: lifecycle logging
+  if (event.action === 'create') {
+    console.info(
+      `%c[MCP-UI] dispatchScratchpad%c create id=${event.id} sections=${event.sections?.length || 0} status=${event.status || 'loading'}${event.pinned ? ' pinned' : ''}`,
+      'color: #10b981; font-weight: bold', 'color: inherit'
+    )
+    setScratchpadStore({
+      current: {
+        id: event.id,
+        title: event.title || '',
+        sections: event.sections || [],
+        filters: event.filters || {},
+        preview: event.preview,
+        agentMessages: event.agentMessages || [],
+        status: event.status || 'loading',
+        previewEndpoint: (event as any).previewEndpoint,
+        previewDebounce: (event as any).previewDebounce,
+        previewMethod: (event as any).previewMethod,
+        previewHeaders: (event as any).previewHeaders,
+        turn: (event as any).turn,
+        totalTurns: (event as any).totalTurns,
+        turnHistory: (event as any).turnHistory,
+      },
+      pinned: event.pinned || false,
+    })
+  } else if (event.action === 'update') {
+    console.info(
+      `%c[MCP-UI] dispatchScratchpad%c update id=${event.id} sectionMode=${event.sectionMode || 'replace'} sections=${event.sections?.length || 0} status=${event.status || '-'}`,
+      'color: #3b82f6; font-weight: bold', 'color: inherit'
+    )
+    setScratchpadStore(produce((s) => {
+      if (!s.current || s.current.id !== event.id) {
+        console.warn(`[MCP-UI] dispatchScratchpad: update for id=${event.id} but current is ${s.current?.id || 'null'}. Ignoring.`)
+        return
+      }
+
+      if (event.sections) {
+        const mode = event.sectionMode || 'replace'
+        if (mode === 'replace') {
+          s.current.sections = event.sections
+        } else if (mode === 'append') {
+          s.current.sections = [...s.current.sections, ...event.sections]
+        } else if (mode === 'upsert') {
+          let matchCount = 0
+          for (const incoming of event.sections) {
+            const idx = s.current.sections.findIndex((sec: ScratchpadSection) => sec.id === incoming.id)
+            if (idx >= 0) {
+              s.current.sections[idx] = incoming
+              matchCount++
+            } else {
+              s.current.sections.push(incoming)
+            }
+          }
+          if (matchCount === 0 && event.sections.length > 0) {
+            console.warn(
+              `[MCP-UI] dispatchScratchpad: sectionMode='upsert' but no IDs matched. ` +
+              `Incoming: [${event.sections.map((s: ScratchpadSection) => s.id).join(', ')}] ` +
+              `Existing: [${s.current.sections.map((s: ScratchpadSection) => s.id).join(', ')}]. All appended.`
+            )
+          }
+        }
+      }
+      if (event.agentMessages) s.current.agentMessages = event.agentMessages
+      if (event.status) s.current.status = event.status
+      if (event.filters) s.current.filters = event.filters
+      if (event.preview) s.current.preview = event.preview
+      if (event.pinned != null) s.pinned = event.pinned
+      if ((event as any).turnHistory) s.current.turnHistory = (event as any).turnHistory
+      if ((event as any).turn != null) s.current.turn = (event as any).turn
+    }))
+  } else if (event.action === 'close') {
+    console.info(`%c[MCP-UI] dispatchScratchpad%c close id=${event.id}`, 'color: #6b7280; font-weight: bold', 'color: inherit')
+    setScratchpadStore({ current: null, pinned: false })
+  }
+}