grain-tools 0.10.7 → 0.10.8

package/README.md

@@ -274,7 +274,7 @@ settings JSON by hand.
 | `grain.alwaysRunInNewTab`  | `false`                    | Always open query results in a new tab                                                 |
 | `grain.mcpEnabled`         | `false`                    | Serve the local MCP surface for agent access. Off means `/mcp` is not registered (404) |
 | `grain.mcpSafeMode`        | `true`                     | Restrict MCP query execution to read-only statements                                   |
-| `grain.telemetry.enabled`  | `false`                    | Opt in to anonymous product telemetry                                                  |
+| `grain.telemetry.enabled`  | `true`                     | Anonymous product telemetry; follows your VS Code telemetry setting                    |
 | `grain.telemetryHost`      | `https://us.i.posthog.com` | Advanced PostHog-compatible telemetry endpoint                                         |
 
 Legacy connection settings such as `sqlPreview.host`, `sqlPreview.port`,

package/dist/web-app.html

@@ -1,14 +1,14 @@
-<!DOCTYPE html>
+<!doctype html>
 <html lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>Grain — Workbench</title>
+    <title>Grain</title>
     <meta name="theme-color" content="#1e1e1e" />
     <link
       rel="icon"
-      type="image/svg+xml"
-      href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Crect width='16' height='16' rx='3' fill='%23007acc'/%3E%3Cpath fill='white' d='M3.75 3A1.75 1.75 0 0 0 2 4.75v6.5c0 .966.784 1.75 1.75 1.75h8.5A1.75 1.75 0 0 0 14 11.25v-6.5A1.75 1.75 0 0 0 12.25 3h-8.5ZM3.5 7.75v3.5c0 .138.112.25.25.25h8.5a.25.25 0 0 0 .25-.25v-3.5H3.5ZM12.5 6.25H3.5V4.75c0-.138.112-.25.25-.25h8.5a.25.25 0 0 1 .25.25v1.5Z'/%3E%3C/svg%3E"
+      type="image/png"
+      href="data:image/png;base64,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"
     />
     <script type="module" crossorigin>var _a2, _b2, _c2;
 (function polyfill() {
@@ -12549,10 +12549,15 @@ function useWebSession() {
 async function bootstrapLocalSession(location, history) {
   const params = new URLSearchParams(location.hash.replace(/^#/, ""));
   const capability = params.get("launch");
-  if (!capability) {
-    return "no-capability";
+  const rawView = params.get("view");
+  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 };
+  }
   try {
     const response = await fetch(LOCAL_EXCHANGE_PATH, {
       method: "POST",
@@ -12563,11 +12568,11 @@ async function bootstrapLocalSession(location, history) {
       body: JSON.stringify({ capability })
     });
     if (response.status === 204) {
-      return "ok";
+      return { session: "ok", view };
     }
-    return "failed";
+    return { session: "failed", view };
   } catch {
-    return "failed";
+    return { session: "failed", view };
   }
 }
 async function authorizedFetch(input, init2) {
@@ -14323,10 +14328,10 @@ function ReauthorizeNotice({
   reason
 }) {
   return /* @__PURE__ */ jsxRuntimeExports.jsxs("div", { className: "sp-web-reauth", role: "alert", children: [
-    /* @__PURE__ */ jsxRuntimeExports.jsx("p", { className: "sp-web-reauth-title", children: reason === "unreachable" ? "Grain is no longer answering at this address" : "Grain needs to authorize this page again" }),
+    /* @__PURE__ */ jsxRuntimeExports.jsx("p", { className: "sp-web-reauth-title", children: reason === "unreachable" ? "Grain is no longer answering at this address" : reason === "expired-link" ? "This link has already been used" : "Open this workspace from your terminal" }),
     /* @__PURE__ */ jsxRuntimeExports.jsxs("p", { children: [
-      reason === "expired-link" && "This authorization link had already been used, or it expired.",
-      reason === "no-session" && "This page is no longer authorized. Grain restarts, a new tab, and a session left open for a while all end up here.",
+      reason === "expired-link" && "An authorization link works once, and only for a short while.",
+      reason === "no-session" && "A workspace session is short-lived. A new tab, a restart, or a session left open for a while all end up here.",
       reason === "unreachable" && "The service stopped, or it came back on a different port. This page cannot find it again on its own."
     ] }),
     /* @__PURE__ */ jsxRuntimeExports.jsxs("p", { children: [
@@ -151572,7 +151577,8 @@ function TabContextMenu({
 const LandingScreen = ({
   onNewConnection,
   onNewQueryFile,
-  onManageConnections
+  onManageConnections,
+  onTryDemo
 }) => {
   const { sendMessage, callServerTool, isReady } = useHostContext();
   const {
@@ -151629,6 +151635,13 @@ const LandingScreen = ({
       openSettingsPanel("connections");
     }
   };
+  const handleTryDemo = () => {
+    if (onTryDemo) {
+      onTryDemo();
+    } else {
+      sendMessage("openDemo");
+    }
+  };
   return /* @__PURE__ */ jsxRuntimeExports.jsx("div", { className: "sp-landing", role: "region", "aria-label": "Grain Welcome and Quick Actions", children: /* @__PURE__ */ jsxRuntimeExports.jsxs("div", { className: "sp-landing-card", children: [
     /* @__PURE__ */ jsxRuntimeExports.jsxs("div", { className: "sp-landing-header", children: [
       /* @__PURE__ */ jsxRuntimeExports.jsxs("h2", { className: "sp-landing-title", children: [
@@ -151695,6 +151708,19 @@ const LandingScreen = ({
             "Create Connection"
           ]
         }
+      ),
+      /* @__PURE__ */ jsxRuntimeExports.jsxs(
+        "button",
+        {
+          type: "button",
+          className: "sp-btn sp-landing-btn",
+          onClick: handleTryDemo,
+          "aria-label": "Try the Grain demo",
+          children: [
+            /* @__PURE__ */ jsxRuntimeExports.jsx(CodeIcon, { size: 14 }),
+            "Try the Demo"
+          ]
+        }
       )
     ] }),
     /* @__PURE__ */ jsxRuntimeExports.jsxs("div", { className: "sp-landing-footer", children: [
@@ -152597,7 +152623,7 @@ const SIDEBAR_MIN_WIDTH = 160;
 const SIDEBAR_MAX_WIDTH = 400;
 const SIDEBAR_AUTO_COLLAPSE_QUERY = "(max-width: 640px)";
 const SIDEBAR_WIDTH_STORAGE_KEY = "sql-preview:web-sidebar-width";
-function WebApp() {
+function WebApp({ viewHint }) {
   const { onMessage, isReady, sendMessage } = useHostContext();
   const session = useWebSession();
   const {
@@ -152607,7 +152633,8 @@ function WebApp() {
     setActiveTab,
     setTheme,
     projectionSessionId,
-    setProjectionSession
+    setProjectionSession,
+    openSettingsPanel
   } = useAppStore();
   const [sessions, setSessions] = reactExports.useState([]);
   const [monitorOpen, setMonitorOpen] = reactExports.useState(true);
@@ -152622,6 +152649,14 @@ function WebApp() {
     var _a3;
     (_a3 = sidebarRef.current) == null ? void 0 : _a3.style.setProperty("--sp-web-sidebar-width", `${sidebarWidth}px`);
   }, [sidebarWidth, monitorOpen]);
+  const hasAppliedHint = reactExports.useRef(false);
+  reactExports.useEffect(() => {
+    if (hasAppliedHint.current || !viewHint) {
+      return;
+    }
+    hasAppliedHint.current = true;
+    openSettingsPanel("connections", viewHint === "connections-add");
+  }, [viewHint, openSettingsPanel]);
   reactExports.useEffect(() => {
     const mediaQuery = window.matchMedia(SIDEBAR_AUTO_COLLAPSE_QUERY);
     const handleChange = (e2) => {
@@ -152964,14 +152999,14 @@ function WebApp() {
 }
 async function bootstrap() {
   const result = await bootstrapLocalSession(window.location, window.history);
-  if (result === "failed") {
+  if (result.session === "failed") {
     ReactDOM.createRoot(document.getElementById("root")).render(
       /* @__PURE__ */ jsxRuntimeExports.jsx(React$2.StrictMode, { children: /* @__PURE__ */ jsxRuntimeExports.jsx(ReauthorizeNotice, { reason: "expired-link" }) })
     );
     return;
   }
   ReactDOM.createRoot(document.getElementById("root")).render(
-    /* @__PURE__ */ jsxRuntimeExports.jsx(React$2.StrictMode, { children: /* @__PURE__ */ jsxRuntimeExports.jsx(WebHostProvider, { children: /* @__PURE__ */ jsxRuntimeExports.jsx(WebApp, {}) }) })
+    /* @__PURE__ */ jsxRuntimeExports.jsx(React$2.StrictMode, { children: /* @__PURE__ */ jsxRuntimeExports.jsx(WebHostProvider, { children: /* @__PURE__ */ jsxRuntimeExports.jsx(WebApp, { viewHint: result.view }) }) })
   );
 }
 bootstrap();</script>