grain-tools 0.10.17 → 0.10.19

package/dist/mcp-app-shell.html

@@ -0,0 +1,31 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>Grain Results</title>
+  <style>
+    body { margin: 0; padding: 12px; color: var(--vscode-foreground, #222); font: 13px var(--vscode-font-family, sans-serif); }
+    button { font: inherit; }
+    .row { margin: 0 0 8px; }
+    #columns { overflow-wrap: anywhere; }
+    #error { color: var(--vscode-errorForeground, #b00); }
+    #grid { width: 100%; height: 480px; border: 0; }
+    label { display: inline-flex; gap: 6px; align-items: center; }
+  </style>
+  <script type="module" crossorigin>(function(){const e=document.createElement("link").relList;if(e&&e.supports&&e.supports("modulepreload"))return;for(const t of document.querySelectorAll('link[rel="modulepreload"]'))s(t);new MutationObserver(t=>{for(const r of t)if(r.type==="childList")for(const u of r.addedNodes)u.tagName==="LINK"&&u.rel==="modulepreload"&&s(u)}).observe(document,{childList:!0,subtree:!0});function n(t){const r={};return t.integrity&&(r.integrity=t.integrity),t.referrerPolicy&&(r.referrerPolicy=t.referrerPolicy),t.crossOrigin==="use-credentials"?r.credentials="include":t.crossOrigin==="anonymous"?r.credentials="omit":r.credentials="same-origin",r}function s(t){if(t.ep)return;t.ep=!0;const r=n(t);fetch(t.href,r)}})();const l=new Map;let O=0,c,m=!1,i,f="",d=!1;function p(o,e={}){const n=++O;return new Promise(s=>{l.set(n,s),window.parent.postMessage({jsonrpc:"2.0",id:n,method:o,params:e},"*"),window.setTimeout(()=>{l.get(n)&&(l.delete(n),s({jsonrpc:"2.0",id:n,error:{message:"The host did not respond"}}))},1e4)})}function a(o){const e=document.querySelector("#error");e&&(e.textContent=o)}function y(o){const e=document.querySelector("#open");e&&(e.textContent=o)}function h(o){c?.contentWindow?.postMessage(o,"*")}function v(){!i||!m||h({jsonrpc:"2.0",method:"ui/notifications/tool-result",params:{structuredContent:i}})}window.addEventListener("message",o=>{const e=o.data;if(!(!e||e.jsonrpc!=="2.0")){if(o.source===c?.contentWindow){if(e.id!==void 0){const n=`frame-${String(e.id)}`;l.set(n,s=>{c?.contentWindow?.postMessage({...s,id:e.id},"*")}),window.parent.postMessage({...e,id:n},"*")}else window.parent.postMessage(e,"*"),e.method==="ui/notifications/initialized"&&(m=!0,v());return}if(e.id!==void 0&&l.has(e.id)){l.get(e.id)?.(e),l.delete(e.id);return}typeof e.method=="string"&&e.method.startsWith("ui/notifications/")&&(e.method==="ui/notifications/tool-result"?C(e.params):h(e))}});function C(o){if(!o||!o.structuredContent||typeof o.structuredContent!="object")return;i=o.structuredContent,v();const n=i.route==="editor",s=document.querySelector("#toggle-wrap");s&&(s.hidden=!n),y(n?"Open in Grain":"Open in workspace"),f=typeof i.cardPreferenceKey=="string"?i.cardPreferenceKey:"";const t=document.querySelector("#title"),r=document.querySelector("#count"),u=document.querySelector("#columns"),g=document.querySelector("#status");t&&(t.textContent=String(i.title||i.tabId||"Query result")),r&&(r.textContent=`${Number(i.rowCount??0).toLocaleString()} rows`),u&&(u.textContent=`Columns: ${(i.columns||[]).map(S=>S.name||"").join(", ")||"none"}`),g&&(g.textContent=`Status: ${i.status||"unknown"}`);try{d=f?window.localStorage.getItem(f)==="on":!1}catch{d=!1}const w=document.querySelector("#toggle");w&&(w.checked=d),(!n||d)&&b()}async function b(){if(c||!i)return;a("");const o=await p("resources/read",{uri:"ui://sql-preview/results-grid-full"}),n=o.result?.contents?.find(s=>typeof s.text=="string")?.text;if(o.error||!n){const s=i.route==="editor";a(s?"The full results view is unavailable. Open in Grain to see the result.":"The full results view is unavailable. Open in workspace to see the result."),y(s?"Open in Grain":"Open in workspace");return}c=document.createElement("iframe"),m=!1,c.id="grid",c.title="Full query results",c.srcdoc=n,document.body.append(c),document.querySelector("#card")?.classList.add("expanded")}document.querySelector("#open")?.addEventListener("click",async()=>{if(!i?.sessionId||!i.tabId){a("This result cannot be opened yet.");return}const o=i.route==="editor"?"open_in_grain":"open_in_workspace",e=await p("tools/call",{name:"open_result_view",arguments:{sessionId:i.sessionId,tabId:i.tabId,button:o}}),n=e.result,t=(n?.content||[]).map(u=>u.text).filter(Boolean).join(`
+`),r=n?.structuredContent?.url||t.match(/https?:\/\/[^\s)]+/)?.[0];if(r){if(!(await p("ui/open-link",{url:r})).error){a(t&&t!==r?t:"Opened the result workspace.");return}p("tools/call",{name:"record_ui_event",arguments:{event:"mcp_result_view_opened",button:o}}).catch(()=>{}),a(`${t||"Open this result in your browser:"}
+${r}`);return}t&&a(t),e.error&&a(`${o==="open_in_grain"?"Open in Grain":"Open in workspace"} is not available yet.`)});document.querySelector("#toggle")?.addEventListener("change",o=>{d=o.currentTarget.checked;try{f&&window.localStorage.setItem(f,d?"on":"off")}catch{d=o.currentTarget.checked}d?b():(c?.remove(),c=void 0,document.querySelector("#card")?.classList.remove("expanded"))});p("ui/initialize",{appInfo:{name:"Grain Results Card",version:"1.0.0"},appCapabilities:{},protocolVersion:"2025-11-25"}).then(()=>window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/initialized"},"*"));</script>
+</head>
+<body>
+  <main id="card">
+    <h2 id="title" class="row">Query result</h2>
+    <div id="count" class="row"></div>
+    <div id="columns" class="row"></div>
+    <div id="status" class="row"></div>
+    <div class="row"><button id="open">Open in Grain</button></div>
+    <label id="toggle-wrap"><input id="toggle" type="checkbox">Show in chat</label>
+    <div id="error" role="status" aria-live="polite"></div>
+  </main>
+</body>
+</html>

package/dist/mcp-app.html

@@ -12521,6 +12521,72 @@ function BaseHostProvider({
 }) {
   return /* @__PURE__ */ jsxRuntimeExports.jsx(HostContext.Provider, { value, children });
 }
+function useWorkspaceResultTarget() {
+  const [targets, setTargets] = reactExports.useState({});
+  const [resetToken, setResetToken] = reactExports.useState(0);
+  const remember = reactExports.useCallback((tabId, structured) => {
+    setResetToken((current) => current + 1);
+    const sessionId = structured?.["sessionId"];
+    const resultTabId = structured?.["tabId"];
+    if (structured?.["route"] === "chat" && typeof sessionId === "string" && typeof resultTabId === "string") {
+      setTargets((current) => ({ ...current, [tabId]: { sessionId, tabId: resultTabId } }));
+    }
+  }, []);
+  return { targetForTab: (tabId) => targets[tabId], remember, resetToken };
+}
+function WorkspaceResultAction({
+  target,
+  resetToken,
+  callServerTool,
+  sendMessage
+}) {
+  const [linkError, setLinkError] = reactExports.useState("");
+  reactExports.useEffect(() => setLinkError(""), [resetToken]);
+  const openWorkspace = async () => {
+    if (!target) {
+      return;
+    }
+    setLinkError("");
+    try {
+      const response = await callServerTool("open_result_view", {
+        ...target,
+        button: "open_in_workspace"
+      });
+      const structured = response.structuredContent;
+      if (typeof structured?.url === "string") {
+        try {
+          await sendMessage("openLink", { url: structured.url });
+        } catch {
+          void callServerTool("record_ui_event", {
+            event: "mcp_result_view_opened",
+            button: "open_in_workspace"
+          }).catch(() => void 0);
+          setLinkError(structured.url);
+        }
+      } else if (structured?.openedInEditor === true) {
+        setLinkError("Opened the result in Grain.");
+      } else {
+        throw new Error("The workspace link is unavailable");
+      }
+    } catch {
+      setLinkError("Could not open this result in the workspace.");
+    }
+  };
+  return /* @__PURE__ */ jsxRuntimeExports.jsxs(jsxRuntimeExports.Fragment, { children: [
+    target && /* @__PURE__ */ jsxRuntimeExports.jsx("button", { className: "sp-btn", onClick: () => void openWorkspace(), children: "Open in workspace" }),
+    linkError && /* @__PURE__ */ jsxRuntimeExports.jsx("pre", { className: "sp-error-bar", role: "status", "aria-live": "polite", children: linkError })
+  ] });
+}
+function copyResultToClipboard(result, copyText) {
+  if (!result || result.rows.length === 0) {
+    return;
+  }
+  const header = result.columns.map((column) => column.name).join("	");
+  const rows = result.rows.map(
+    (row) => result.columns.map((_, index) => String(row[index] ?? "")).join("	")
+  );
+  copyText([header, ...rows].join("\n"));
+}
 const createStoreImpl = (createState) => {
   let state;
   const listeners = /* @__PURE__ */ new Set();
@@ -147870,6 +147936,7 @@ function App() {
     updateTab
   } = useAppStore();
   const [isAppMode, setIsAppMode] = reactExports.useState(true);
+  const { targetForTab, remember, resetToken } = useWorkspaceResultTarget();
   const hasReceivedToolCall = reactExports.useRef(false);
   const hasFallbackFired = reactExports.useRef(false);
   const gridRef = reactExports.useRef(null);
@@ -147984,6 +148051,7 @@ function App() {
       const structured = params?.structuredContent && typeof params.structuredContent === "object" ? params.structuredContent : void 0;
       const resultSql = entry?.sql ?? (typeof rawCallKey === "string" ? rawCallKey : typeof structured?.["query"] === "string" ? structured["query"] : "");
       const tabId = entry?.tabId ?? createTab(resultSql, false);
+      remember(tabId, structured);
       setIsAppMode(true);
       if (params?.isError) {
         const text = params.content?.find((c) => c.type === "text")?.text;
@@ -148209,14 +148277,8 @@ function App() {
       copyTextSafe(csvString);
     }
   };
-  const handleCopy = () => {
-    if (!result || result.rows.length === 0) return;
-    const header = result.columns.map((c) => c.name).join("	");
-    const tsvRows = result.rows.map(
-      (row) => result.columns.map((_, i2) => String(row[i2] ?? "")).join("	")
-    );
-    copyTextSafe([header, ...tsvRows].join("\n"));
-  };
+  const workspaceTarget = targetForTab(activeTab?.id ?? "");
+  const handleCopy = () => copyResultToClipboard(result, copyTextSafe);
   if (!isReady || !activeTab)
     return /* @__PURE__ */ jsxRuntimeExports.jsx("div", { style: { display: "flex", justifyContent: "center", padding: "40px" }, children: /* @__PURE__ */ jsxRuntimeExports.jsx("div", { className: "spinner" }) });
   const showTabs = tabs.length > 1 || !isAppMode;
@@ -148276,7 +148338,8 @@ function App() {
             result && /* @__PURE__ */ jsxRuntimeExports.jsxs("span", { className: "sp-row-count", children: [
               /* @__PURE__ */ jsxRuntimeExports.jsx("strong", { children: result.rowCount ?? result.rows.length }),
               " rows"
-            ] })
+            ] }),
+            result && /* @__PURE__ */ jsxRuntimeExports.jsx(WorkspaceResultAction, { target: workspaceTarget, resetToken, callServerTool, sendMessage })
           ] }),
           /* @__PURE__ */ jsxRuntimeExports.jsx("div", { className: "sp-result-header-right", children: result && result.rows.length > 0 && /* @__PURE__ */ jsxRuntimeExports.jsxs(jsxRuntimeExports.Fragment, { children: [
             /* @__PURE__ */ jsxRuntimeExports.jsx("button", { className: "sp-btn", onClick: handleCopy, "aria-label": "Copy results", children: "Copy" }),
@@ -161939,11 +162002,15 @@ function MCPHostProvider({ children }) {
       };
     }
   });
-  const sendMessage = reactExports.useCallback((command, payload) => {
+  const sendMessage = reactExports.useCallback(async (command, payload) => {
     if (!appRef.current) return;
     switch (command) {
       case "openLink":
-        if (appRef.current.openLink) appRef.current.openLink(payload);
+        if (appRef.current.openLink) {
+          await appRef.current.openLink(payload);
+        } else {
+          throw new Error("The host cannot open links");
+        }
         break;
       default:
         console.warn("[MCPHost] Unknown command sent:", command);

package/dist/web-app.html

@@ -12553,13 +12553,16 @@ async function bootstrapLocalSession(location, history) {
   const params = new URLSearchParams(location.hash.replace(/^#/, ""));
   const capability = params.get("launch");
   const rawView = params.get("view");
+  const sessionId = params.get("sessionId");
+  const tabId = params.get("tabId");
+  const result = sessionId && tabId ? { sessionId, tabId } : void 0;
   let view = void 0;
   if (rawView === "connections" || rawView === "connections-add") {
     view = rawView;
   }
   history.replaceState({}, "", `${location.pathname}${location.search}`);
   if (!capability) {
-    return { session: "no-capability", view };
+    return { session: "no-capability", view, result };
   }
   try {
     const response = await fetch(LOCAL_EXCHANGE_PATH, {
@@ -12571,11 +12574,11 @@ async function bootstrapLocalSession(location, history) {
       body: JSON.stringify({ capability })
     });
     if (response.status === 204) {
-      return { session: "ok", view };
+      return { session: "ok", view, result };
     }
-    return { session: "failed", view };
+    return { session: "failed", view, result };
   } catch {
-    return { session: "failed", view };
+    return { session: "failed", view, result };
   }
 }
 async function authorizedFetch(input, init2) {
@@ -13065,6 +13068,10 @@ function useWebBootstrap() {
     return unsubscribe;
   }, []);
 }
+const RESULT_ROUTING_SCHEMA = {
+  events: ["mcp_result_routed", "mcp_result_view_opened"],
+  flagKeys: ["results-card-routing"]
+};
 const ALL_TOOLS = [
   "list_connectors",
   "run_query",
@@ -13087,7 +13094,8 @@ const ALL_TOOLS = [
   "list_charts",
   "ledger_stats",
   "verify_ledger",
-  "record_ui_event"
+  "record_ui_event",
+  "open_result_view"
 ];
 const WEB_PROXIED_TOOLS = [
   "list_connectors",
@@ -13110,6 +13118,7 @@ const TELEMETRY_EVENTS = [
   "query_confirmation_shown",
   "mcp_tool_invoked",
   "mcp_resource_read",
+  ...RESULT_ROUTING_SCHEMA.events,
   "daemon_crashed",
   "service_lifecycle",
   "mcp_http_error",
@@ -13584,6 +13593,7 @@ const TELEMETRY_FLAG_KEYS = [
   "sql_preview_credential_required_signal",
   "sql_preview_crash_diagnostics",
   "sql_preview_mcp_surface",
+  ...RESULT_ROUTING_SCHEMA.flagKeys,
   "unknown"
 ];
 const TELEMETRY_ACQUISITION_CHANNELS = ["marketplace", "open_vsx", "cli"];
@@ -14376,7 +14386,13 @@ function ReauthorizeNotice({
         }
       )
     ] }),
-    /* @__PURE__ */ jsxRuntimeExports.jsx("p", { className: "sp-web-reauth-detail", children: reason === "expired-link" ? "This link has expired or was already used." : reason === "unreachable" ? "Grain may have stopped, or restarted on a different port. If it stopped, start it again first." : "This tab needs a fresh workspace link." })
+    /* @__PURE__ */ jsxRuntimeExports.jsxs("p", { className: "sp-web-reauth-detail", children: [
+      reason === "expired-link" ? "This link has expired or was already used." : reason === "unreachable" ? "Grain may have stopped, or restarted on a different port. If it stopped, start it again first." : "This tab needs a fresh workspace link.",
+      " ",
+      "Using a browser other than your default? Run ",
+      /* @__PURE__ */ jsxRuntimeExports.jsx("code", { children: "grain ui --url" }),
+      " and paste the link here."
+    ] })
   ] });
 }
 function isUpdateMarkerStatus(value) {
@@ -150354,7 +150370,8 @@ const TOOL_ENTRIES = {
   ledger_stats: ["ledger", "Show ledger health and counts."],
   verify_ledger: ["ledger", "Verify the ledger hash chain."],
   list_sessions: ["sessions", "Show active MCP sessions and their tabs."],
-  record_ui_event: null
+  record_ui_event: null,
+  open_result_view: null
 };
 const MCP_TOOL_GROUPS = GROUPS.map((group) => ({
   label: group.label,
@@ -152731,6 +152748,33 @@ function AgentQueryHeading({
     /* @__PURE__ */ jsxRuntimeExports.jsx("div", { className: "sp-web-query-provenance", children: [tab.sessionDisplayName || tab.clientType, connectionName, ranAt].filter(Boolean).join(" · ") })
   ] });
 }
+function useWebAppInitialTarget(isReady, viewHint, resultTarget, tabs, showQuery, openSettingsPanel) {
+  const appliedHint = reactExports.useRef(false);
+  const appliedTarget = reactExports.useRef(void 0);
+  reactExports.useEffect(() => {
+    if (appliedHint.current || !viewHint) {
+      return;
+    }
+    appliedHint.current = true;
+    openSettingsPanel("connections", viewHint === "connections-add");
+  }, [viewHint, openSettingsPanel]);
+  reactExports.useEffect(() => {
+    if (!isReady || !resultTarget) {
+      return;
+    }
+    const targetKey = `${resultTarget.sessionId}\0${resultTarget.tabId}`;
+    if (appliedTarget.current === targetKey) {
+      return;
+    }
+    const target = tabs.find(
+      (tab) => tab.sessionId === resultTarget.sessionId && (tab.remoteId === resultTarget.tabId || tab.id === resultTarget.tabId)
+    );
+    if (target) {
+      appliedTarget.current = targetKey;
+      showQuery(target.id);
+    }
+  }, [isReady, resultTarget, tabs, showQuery]);
+}
 const THEME_KEY = "grain:web-theme";
 const SIDEBAR_DEFAULT_WIDTH = 220;
 const SIDEBAR_MIN_WIDTH = 160;
@@ -152738,7 +152782,7 @@ const SIDEBAR_MAX_WIDTH = 400;
 const SIDEBAR_AUTO_COLLAPSE_QUERY = "(max-width: 640px)";
 const SIDEBAR_WIDTH_STORAGE_KEY = "sql-preview:web-sidebar-width";
 const CONNECTIONS_COLLAPSED_KEY = "grain:web-connections-collapsed";
-function WebApp({ viewHint }) {
+function WebApp({ viewHint, resultTarget }) {
   const { onMessage, isReady, sendMessage, callServerTool, track } = useHostContext();
   const session = useWebSession();
   const {
@@ -152930,14 +152974,7 @@ function WebApp({ viewHint }) {
   reactExports.useEffect(() => {
     if (isReady) void fetchConnections();
   }, [isReady, fetchConnections]);
-  const hasAppliedHint = reactExports.useRef(false);
-  reactExports.useEffect(() => {
-    if (hasAppliedHint.current || !viewHint) {
-      return;
-    }
-    hasAppliedHint.current = true;
-    openSettingsPanel("connections", viewHint === "connections-add");
-  }, [viewHint, openSettingsPanel]);
+  useWebAppInitialTarget(isReady, viewHint, resultTarget, tabs, showQuery, openSettingsPanel);
   reactExports.useEffect(() => {
     const mediaQuery = window.matchMedia(SIDEBAR_AUTO_COLLAPSE_QUERY);
     const handleChange = (e2) => {
@@ -153527,7 +153564,13 @@ async function bootstrap() {
     return;
   }
   ReactDOM$1.createRoot(document.getElementById("root")).render(
-    /* @__PURE__ */ jsxRuntimeExports.jsx(React.StrictMode, { children: /* @__PURE__ */ jsxRuntimeExports.jsx(WebHostProvider, { children: /* @__PURE__ */ jsxRuntimeExports.jsx(WebApp, { viewHint: result.view }) }) })
+    /* @__PURE__ */ jsxRuntimeExports.jsx(React.StrictMode, { children: /* @__PURE__ */ jsxRuntimeExports.jsx(WebHostProvider, { children: /* @__PURE__ */ jsxRuntimeExports.jsx(
+      WebApp,
+      {
+        viewHint: result.view,
+        ...result.result ? { resultTarget: result.result } : {}
+      }
+    ) }) })
   );
 }
 bootstrap();</script>