@granular-software/sdk 0.3.2 → 0.3.4

package/dist/adapters/anthropic.d.mts

@@ -1,4 +1,4 @@
-import { T as ToolWithHandler } from '../types-CnX4jXYQ.mjs';
+import { T as ToolWithHandler } from '../types-D5B8WlF4.mjs';
 
 /**
  * Anthropic tool_use block from message response

package/dist/adapters/anthropic.d.ts

@@ -1,4 +1,4 @@
-import { T as ToolWithHandler } from '../types-CnX4jXYQ.js';
+import { T as ToolWithHandler } from '../types-D5B8WlF4.js';
 
 /**
  * Anthropic tool_use block from message response

package/dist/adapters/langchain.d.mts

@@ -1,5 +1,5 @@
 import { StructuredTool } from '@langchain/core/tools';
-import { T as ToolWithHandler } from '../types-CnX4jXYQ.mjs';
+import { T as ToolWithHandler } from '../types-D5B8WlF4.mjs';
 
 /**
  * Helper to convert LangChain tools to Granular tools.

package/dist/adapters/langchain.d.ts

@@ -1,5 +1,5 @@
 import { StructuredTool } from '@langchain/core/tools';
-import { T as ToolWithHandler } from '../types-CnX4jXYQ.js';
+import { T as ToolWithHandler } from '../types-D5B8WlF4.js';
 
 /**
  * Helper to convert LangChain tools to Granular tools.

package/dist/adapters/mastra.d.mts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { T as ToolWithHandler } from '../types-CnX4jXYQ.mjs';
+import { T as ToolWithHandler } from '../types-D5B8WlF4.mjs';
 
 /**
  * Mastra tool definition interface

package/dist/adapters/mastra.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { T as ToolWithHandler } from '../types-CnX4jXYQ.js';
+import { T as ToolWithHandler } from '../types-D5B8WlF4.js';
 
 /**
  * Mastra tool definition interface

package/dist/adapters/openai.d.mts

@@ -1,4 +1,4 @@
-import { T as ToolWithHandler } from '../types-CnX4jXYQ.mjs';
+import { T as ToolWithHandler } from '../types-D5B8WlF4.mjs';
 
 /**
  * OpenAI tool call from chat completion response

package/dist/adapters/openai.d.ts

@@ -1,4 +1,4 @@
-import { T as ToolWithHandler } from '../types-CnX4jXYQ.js';
+import { T as ToolWithHandler } from '../types-D5B8WlF4.js';
 
 /**
  * OpenAI tool call from chat completion response

package/dist/cli/index.js

@@ -4,10 +4,12 @@
 var fs = require('fs');
 var path = require('path');
 var readline = require('readline');
+var http = require('http');
+var child_process = require('child_process');
+var crypto = require('crypto');
 var process6 = require('process');
 var os = require('os');
 var tty = require('tty');
-var child_process = require('child_process');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
@@ -32,6 +34,7 @@ function _interopNamespace(e) {
 var fs__namespace = /*#__PURE__*/_interopNamespace(fs);
 var path__namespace = /*#__PURE__*/_interopNamespace(path);
 var readline__namespace = /*#__PURE__*/_interopNamespace(readline);
+var http__namespace = /*#__PURE__*/_interopNamespace(http);
 var process6__default = /*#__PURE__*/_interopDefault(process6);
 var os__default = /*#__PURE__*/_interopDefault(os);
 var tty__default = /*#__PURE__*/_interopDefault(tty);
@@ -5455,6 +5458,12 @@ function loadApiUrl() {
   if (process.env.GRANULAR_API_URL) return process.env.GRANULAR_API_URL;
   return "https://cf-api-gateway.arthur6084.workers.dev/granular";
 }
+function loadAuthUrl() {
+  if (process.env.GRANULAR_AUTH_URL) {
+    return process.env.GRANULAR_AUTH_URL;
+  }
+  return "https://app.granular.software";
+}
 function saveApiKey(apiKey) {
   const envLocalPath = getEnvLocalPath();
   let content = "";
@@ -5722,6 +5731,347 @@ var ApiClient = class {
     });
   }
 };
+var CALLBACK_HOST = "127.0.0.1";
+var CALLBACK_PATH = "/callback";
+var DEFAULT_TIMEOUT_MS = 3 * 60 * 1e3;
+function normalizeAuthBaseUrl(input) {
+  const url = new URL(input);
+  if (url.protocol !== "https:" && url.protocol !== "http:") {
+    throw new Error("Auth URL must start with http:// or https://");
+  }
+  return url;
+}
+function escapeHtml(input) {
+  return input.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+function generateSquirclePath(size = 128, radius = 56, exp = 4, steps = 72) {
+  const center = size / 2;
+  const points = [];
+  for (let i = 0; i <= steps; i++) {
+    const angle = i / steps * 2 * Math.PI;
+    const cosA = Math.cos(angle);
+    const sinA = Math.sin(angle);
+    const r = 1 / Math.pow(
+      Math.pow(Math.abs(cosA), exp) + Math.pow(Math.abs(sinA), exp),
+      1 / exp
+    );
+    const x = center + r * cosA * radius;
+    const y = center + r * sinA * radius;
+    points.push(`${x.toFixed(3)} ${y.toFixed(3)}`);
+  }
+  return `M ${points.join(" L ")} Z`;
+}
+function generateHilbertPath(order = 4, size = 128, radius = 51) {
+  const n = 1 << order;
+  const center = size / 2;
+  const squircleExp = 4;
+  const points = [];
+  function squareToSquircle(u, v) {
+    if (Math.abs(u) < 1e-3 && Math.abs(v) < 1e-3) return [u, v];
+    const angle = Math.atan2(v, u);
+    const cosA = Math.cos(angle);
+    const sinA = Math.sin(angle);
+    const squircleR = 1 / Math.pow(
+      Math.pow(Math.abs(cosA), squircleExp) + Math.pow(Math.abs(sinA), squircleExp),
+      1 / squircleExp
+    );
+    const squareDist = Math.max(Math.abs(u), Math.abs(v));
+    const newDist = squareDist * squircleR;
+    return [newDist * cosA, newDist * sinA];
+  }
+  function d2xy(d) {
+    let x = 0;
+    let y = 0;
+    let t = d;
+    for (let s = 1; s < n; s *= 2) {
+      const rx = 1 & Math.floor(t) / 2;
+      const ry = 1 & (Math.floor(t) ^ rx);
+      if (ry === 0) {
+        if (rx === 1) {
+          x = s - 1 - x;
+          y = s - 1 - y;
+        }
+        [x, y] = [y, x];
+      }
+      x += s * rx;
+      y += s * ry;
+      t = Math.floor(t) / 4;
+    }
+    return [x, y];
+  }
+  for (let i = 0; i < n * n; i++) {
+    const [x, y] = d2xy(i);
+    const normX = x / (n - 1) * 2 - 1;
+    const normY = y / (n - 1) * 2 - 1;
+    const [sqX, sqY] = squareToSquircle(normX, normY);
+    points.push([center + sqX * radius, center + sqY * radius]);
+  }
+  return points.map(([x, y], i) => `${i === 0 ? "M" : "L"} ${x.toFixed(3)} ${y.toFixed(3)}`).join(" ");
+}
+function renderLogoSvg() {
+  const squirclePath = generateSquirclePath();
+  const hilbertPath = generateHilbertPath();
+  return `<svg class="logo" viewBox="0 0 128 128" role="img" aria-label="Granular logo" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <linearGradient id="granular-logo-gradient" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#ff8a54" />
+      <stop offset="55%" stop-color="#ff6b35" />
+      <stop offset="100%" stop-color="#e34b1f" />
+    </linearGradient>
+    <filter id="granular-logo-glow" x="-30%" y="-30%" width="160%" height="160%">
+      <feGaussianBlur stdDeviation="1.6" result="blur" />
+      <feMerge>
+        <feMergeNode in="blur" />
+        <feMergeNode in="SourceGraphic" />
+      </feMerge>
+    </filter>
+  </defs>
+  <path d="${squirclePath}" fill="rgba(255,255,255,0.05)" stroke="rgba(255,255,255,0.25)" stroke-width="1.2" />
+  <path d="${hilbertPath}" fill="none" stroke="url(#granular-logo-gradient)" stroke-width="2.8" stroke-linecap="round" stroke-linejoin="round" filter="url(#granular-logo-glow)" />
+</svg>`;
+}
+function renderHtmlPage(title, message, variant) {
+  const safeTitle = escapeHtml(title);
+  const safeMessage = escapeHtml(message);
+  const accent = variant === "success" ? "#ff6b35" : "#ff5c6b";
+  const badge = variant === "success" ? "Success" : "Auth Error";
+  return `<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>${safeTitle}</title>
+  <style>
+    :root { color-scheme: dark; }
+    * { box-sizing: border-box; }
+    body {
+      margin: 0;
+      min-height: 100vh;
+      display: grid;
+      place-items: center;
+      padding: 28px;
+      font-family: "Avenir Next", "SF Pro Display", "Segoe UI", sans-serif;
+      color: #f8f8f8;
+      background:
+        radial-gradient(1000px 480px at 12% -10%, rgba(255, 110, 58, 0.26), transparent 60%),
+        radial-gradient(760px 480px at 100% 120%, rgba(99, 102, 241, 0.22), transparent 65%),
+        linear-gradient(140deg, #0f0f12 0%, #131319 45%, #11131a 100%);
+    }
+    .panel {
+      width: min(520px, 100%);
+      border-radius: 24px;
+      border: 1px solid rgba(255, 255, 255, 0.16);
+      background: linear-gradient(160deg, rgba(255,255,255,0.08), rgba(255,255,255,0.03));
+      backdrop-filter: blur(8px);
+      box-shadow:
+        0 18px 60px rgba(0, 0, 0, 0.45),
+        inset 0 1px 0 rgba(255, 255, 255, 0.18);
+      padding: 26px 26px 24px;
+    }
+    .head {
+      display: flex;
+      align-items: center;
+      gap: 14px;
+      margin-bottom: 14px;
+    }
+    .logo-wrap {
+      width: 62px;
+      height: 62px;
+      border-radius: 18px;
+      border: 1px solid rgba(255,255,255,0.2);
+      background: radial-gradient(circle at 25% 20%, rgba(255,255,255,0.17), rgba(255,255,255,0.02));
+      display: grid;
+      place-items: center;
+      flex: 0 0 auto;
+    }
+    .logo {
+      width: 46px;
+      height: 46px;
+      display: block;
+    }
+    .badge {
+      display: inline-flex;
+      align-items: center;
+      border-radius: 999px;
+      padding: 5px 11px;
+      border: 1px solid ${accent}66;
+      background: ${accent}26;
+      color: ${accent};
+      font-size: 12px;
+      font-weight: 600;
+      letter-spacing: 0.04em;
+      text-transform: uppercase;
+      margin-bottom: 8px;
+    }
+    h1 {
+      margin: 0;
+      font-size: 25px;
+      line-height: 1.2;
+      letter-spacing: 0.01em;
+      color: #ffffff;
+    }
+    p {
+      margin: 0;
+      color: #d7d8df;
+      font-size: 15px;
+      line-height: 1.6;
+    }
+    .footer {
+      margin-top: 18px;
+      padding-top: 14px;
+      border-top: 1px solid rgba(255, 255, 255, 0.11);
+      font-size: 12px;
+      color: #9ea3b2;
+      letter-spacing: 0.02em;
+    }
+  </style>
+</head>
+<body>
+  <main class="panel">
+    <div class="head">
+      <div class="logo-wrap">${renderLogoSvg()}</div>
+      <div>
+        <div class="badge">${badge}</div>
+        <h1>${safeTitle}</h1>
+      </div>
+    </div>
+    <p>${safeMessage}</p>
+    <div class="footer">Granular CLI authentication flow completed.</div>
+  </main>
+</body>
+</html>`;
+}
+function describeAuthError(code) {
+  switch (code) {
+    case "unauthorized":
+      return "You must sign in before authorizing the CLI.";
+    case "no_organization":
+      return "Your account is not associated with an organization.";
+    case "key_creation_failed":
+      return "Failed to create an API key for CLI login.";
+    case "missing_key_value":
+      return "The auth server did not return an API key value.";
+    case "auth_failed":
+      return "Authentication failed on the server.";
+    default:
+      return code;
+  }
+}
+function openExternalUrl(url) {
+  const platform = process.platform;
+  return new Promise((resolve) => {
+    let child;
+    if (platform === "darwin") {
+      child = child_process.spawn("open", [url], { stdio: "ignore" });
+    } else if (platform === "win32") {
+      child = child_process.spawn("cmd", ["/c", "start", "", url], {
+        stdio: "ignore",
+        windowsHide: true
+      });
+    } else {
+      child = child_process.spawn("xdg-open", [url], { stdio: "ignore" });
+    }
+    child.once("error", () => resolve(false));
+    child.once("spawn", () => resolve(true));
+  });
+}
+function closeServer(server) {
+  return new Promise((resolve) => {
+    server.close(() => resolve());
+  });
+}
+async function loginWithBrowser(options) {
+  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  const authBaseUrl = normalizeAuthBaseUrl(options.authBaseUrl);
+  const state = crypto.randomBytes(24).toString("hex");
+  const server = http__namespace.createServer();
+  await new Promise((resolve, reject) => {
+    server.once("error", reject);
+    server.listen(0, CALLBACK_HOST, () => resolve());
+  });
+  const address = server.address();
+  if (!address || typeof address === "string") {
+    await closeServer(server);
+    throw new Error("Could not start local callback server.");
+  }
+  const callbackUrl = `http://${CALLBACK_HOST}:${address.port}${CALLBACK_PATH}`;
+  const authUrl = new URL("/api/cli/auth/start", authBaseUrl);
+  authUrl.searchParams.set("callback", callbackUrl);
+  authUrl.searchParams.set("state", state);
+  const browserOpened = await openExternalUrl(authUrl.toString());
+  options.onAuthUrl?.(authUrl.toString(), browserOpened);
+  let settled = false;
+  try {
+    const apiKey = await new Promise((resolve, reject) => {
+      const timeout = setTimeout(() => {
+        if (settled) return;
+        settled = true;
+        reject(new Error(`Timed out after ${Math.round(timeoutMs / 1e3)}s waiting for browser authentication.`));
+      }, timeoutMs);
+      server.on("request", (req, res) => {
+        const url = new URL(req.url || "/", `http://${CALLBACK_HOST}`);
+        if (url.pathname !== CALLBACK_PATH) {
+          res.statusCode = 404;
+          res.end("Not found");
+          return;
+        }
+        const returnedState = url.searchParams.get("state");
+        const apiKey2 = url.searchParams.get("api_key");
+        const error2 = url.searchParams.get("error");
+        if (!returnedState || returnedState !== state) {
+          res.statusCode = 400;
+          res.setHeader("Content-Type", "text/html; charset=utf-8");
+          res.end(renderHtmlPage("Granular login failed", "State mismatch. Please close this window and retry.", "error"));
+          if (!settled) {
+            settled = true;
+            clearTimeout(timeout);
+            reject(new Error("Browser auth state mismatch."));
+          }
+          return;
+        }
+        if (error2) {
+          res.statusCode = 400;
+          res.setHeader("Content-Type", "text/html; charset=utf-8");
+          res.end(
+            renderHtmlPage(
+              "Granular login failed",
+              `${describeAuthError(error2)} You can close this window and return to the CLI.`,
+              "error"
+            )
+          );
+          if (!settled) {
+            settled = true;
+            clearTimeout(timeout);
+            reject(new Error(describeAuthError(error2)));
+          }
+          return;
+        }
+        if (!apiKey2) {
+          res.statusCode = 400;
+          res.setHeader("Content-Type", "text/html; charset=utf-8");
+          res.end(renderHtmlPage("Granular login failed", "No API key was returned. Please retry.", "error"));
+          if (!settled) {
+            settled = true;
+            clearTimeout(timeout);
+            reject(new Error("No API key returned from browser auth."));
+          }
+          return;
+        }
+        res.statusCode = 200;
+        res.setHeader("Content-Type", "text/html; charset=utf-8");
+        res.end(renderHtmlPage("Granular login complete", "Authentication succeeded. You can close this window.", "success"));
+        if (!settled) {
+          settled = true;
+          clearTimeout(timeout);
+          resolve(apiKey2);
+        }
+      });
+    });
+    return apiKey;
+  } finally {
+    await closeServer(server);
+  }
+}
 
 // ../../node_modules/.bun/chalk@5.4.1/node_modules/chalk/source/vendor/ansi-styles/index.js
 var ANSI_BACKGROUND_OFFSET = 10;
@@ -7311,12 +7661,15 @@ function prompt(question, defaultValue) {
     });
   });
 }
-function promptSecret(question) {
+function waitForEnter(message) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    return Promise.resolve();
+  }
   const rl = readline__namespace.createInterface({ input: process.stdin, output: process.stdout });
   return new Promise((resolve) => {
-    rl.question(`  ${question}: `, (answer) => {
+    rl.question(`  ${message}`, () => {
       rl.close();
-      resolve(answer.trim());
+      resolve();
     });
   });
 }
@@ -7339,13 +7692,27 @@ async function initCommand(projectName, options) {
   }
   let apiKey = loadApiKey();
   if (!apiKey) {
-    info("No API key found. Let's set one up.");
-    console.log();
-    dim("Get your API key at https://granular.dev/dashboard/api-keys");
+    info("No API key found. Starting browser login...");
+    await waitForEnter("Press Enter to open the login page in your browser...");
     console.log();
-    apiKey = await promptSecret("Enter your API key");
-    if (!apiKey) {
-      error("API key is required.");
+    const waiting = spinner("Opening browser and waiting for authentication...");
+    try {
+      apiKey = await loginWithBrowser({
+        authBaseUrl: loadAuthUrl(),
+        onAuthUrl: (authUrl, opened) => {
+          if (!opened) {
+            waiting.stop();
+            warn("Could not open your browser automatically.");
+            dim(`Open this URL to continue:
+  ${authUrl}`);
+            waiting.start();
+          }
+        }
+      });
+      waiting.succeed("  Browser authentication completed.");
+    } catch (err) {
+      waiting.fail(`  Browser authentication failed: ${err.message}`);
+      dim("Run `granular login --manual` to paste an API key directly.");
       process.exit(1);
     }
   } else {
@@ -7439,7 +7806,7 @@ async function initCommand(projectName, options) {
   hint("granular simulate", "opens app.granular.software/simulator for this sandbox");
   console.log();
 }
-function promptSecret2(question) {
+function promptSecret(question) {
   const rl = readline__namespace.createInterface({ input: process.stdin, output: process.stdout });
   return new Promise((resolve) => {
     rl.question(`  ${question}: `, (answer) => {
@@ -7448,26 +7815,73 @@ function promptSecret2(question) {
     });
   });
 }
-async function loginCommand() {
+function waitForEnter2(message) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    return Promise.resolve();
+  }
+  const rl = readline__namespace.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(`  ${message}`, () => {
+      rl.close();
+      resolve();
+    });
+  });
+}
+function maskApiKey(apiKey) {
+  if (apiKey.length < 10) return `${apiKey}...`;
+  return `${apiKey.substring(0, 10)}...`;
+}
+async function loginCommand(options = {}) {
   printHeader();
   const existing = loadApiKey();
   if (existing) {
     info("An API key is already configured.");
-    dim(`Current: ${existing.substring(0, 10)}...`);
+    dim(`Current: ${maskApiKey(existing)}`);
     console.log();
   }
-  dim("Get your API key at https://granular.dev/dashboard/api-keys");
-  console.log();
-  const apiKey = await promptSecret2("Enter your API key");
+  const apiUrl = loadApiUrl();
+  let apiKey = options.apiKey?.trim();
+  if (!apiKey) {
+    if (options.manual) {
+      dim("Get your API key at https://app.granular.software/w/default/api-keys");
+      console.log();
+      apiKey = await promptSecret("Enter your API key");
+    } else {
+      const timeoutMs = options.timeout && options.timeout > 0 ? options.timeout * 1e3 : void 0;
+      await waitForEnter2("Press Enter to open the login page in your browser...");
+      console.log();
+      const waiting = spinner("Opening browser and waiting for authentication...");
+      try {
+        apiKey = await loginWithBrowser({
+          authBaseUrl: loadAuthUrl(),
+          timeoutMs,
+          onAuthUrl: (authUrl, opened) => {
+            if (!opened) {
+              waiting.stop();
+              warn("Could not open your browser automatically.");
+              dim(`Open this URL to continue:
+  ${authUrl}`);
+              waiting.start();
+            }
+          }
+        });
+        waiting.succeed("  Browser authentication completed.");
+      } catch (err) {
+        waiting.fail(`  Browser authentication failed: ${err.message}`);
+        dim("Retry with `granular login --manual` to paste an API key directly.");
+        process.exit(1);
+      }
+    }
+  }
   if (!apiKey) {
     error("API key is required.");
     process.exit(1);
   }
-  if (!apiKey.startsWith("sk_")) {
-    warn('API key should start with "sk_". Continuing anyway...');
+  if (!apiKey.startsWith("sk_") && !apiKey.startsWith("gn_sk_")) {
+    warn("API key does not look like a recognized Granular/WorkOS key. Continuing anyway...");
   }
   const spinner2 = spinner("Validating...");
-  const api = new ApiClient(apiKey, loadApiUrl());
+  const api = new ApiClient(apiKey, apiUrl);
   const valid = await api.validateKey();
   if (!valid) {
     spinner2.fail("  Invalid API key.");
@@ -7475,7 +7889,7 @@ async function loginCommand() {
   }
   saveApiKey(apiKey);
   spinner2.succeed("  Authenticated successfully.");
-  dim("API key saved to .env.local");
+  dim("API key saved to .env.local (used by CLI and SDK examples)");
   console.log();
 }
 
@@ -8217,9 +8631,16 @@ program2.command("init [project-name]").description("Initialize a new Granular p
     process.exit(1);
   }
 });
-program2.command("login").description("Authenticate with your Granular API key").action(async () => {
+program2.command("login").description("Authenticate with Granular (browser by default)").option("--manual", "Prompt for API key instead of browser login").option("--api-key <key>", "Use a provided API key directly").option("--timeout <seconds>", "Browser auth timeout in seconds", (value) => {
+  const n = Number.parseInt(value, 10);
+  return Number.isFinite(n) ? n : 180;
+}).action(async (opts) => {
   try {
-    await loginCommand();
+    await loginCommand({
+      manual: opts.manual,
+      apiKey: opts.apiKey,
+      timeout: opts.timeout
+    });
   } catch (err) {
     error(err.message);
     process.exit(1);

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import * as Automerge from '@automerge/automerge';
-import { W as WSClientOptions, T as ToolWithHandler, P as PublishToolsResult, J as Job, a as ToolHandler, I as InstanceToolHandler, b as ToolInfo, c as ToolsChangedEvent, D as DomainState, G as GranularOptions, R as RecordUserOptions, U as User, C as ConnectOptions, E as EnvironmentData, d as GraphQLResult, e as DefineRelationshipOptions, f as RelationshipInfo, M as ModelRef, g as ManifestContent, h as RecordObjectOptions, i as RecordObjectResult, S as SandboxListResponse, j as Sandbox, k as CreateSandboxData, l as DeleteResponse, m as PermissionProfile, n as CreatePermissionProfileData, o as CreateEnvironmentData, p as Subject, A as AssignmentListResponse } from './types-CnX4jXYQ.mjs';
-export { a2 as APIError, u as Assignment, z as Build, F as BuildListResponse, B as BuildPolicy, y as BuildStatus, v as EnvironmentListResponse, r as GranularAuth, H as JobStatus, K as JobSubmitResult, w as Manifest, a0 as ManifestImport, x as ManifestListResponse, $ as ManifestOperation, Z as ManifestPropertySpec, _ as ManifestRelationshipDef, a1 as ManifestVolume, t as PermissionProfileListResponse, s as PermissionRules, L as Prompt, N as RPCRequest, V as RPCRequestFromServer, O as RPCResponse, Q as SyncMessage, X as ToolInvokeParams, Y as ToolResultParams, q as ToolSchema } from './types-CnX4jXYQ.mjs';
+import { W as WSClientOptions, T as ToolWithHandler, P as PublishToolsResult, J as Job, a as ToolHandler, I as InstanceToolHandler, b as ToolInfo, c as ToolsChangedEvent, D as DomainState, G as GranularOptions, R as RecordUserOptions, U as User, C as ConnectOptions, E as EnvironmentData, d as GraphQLResult, e as DefineRelationshipOptions, f as RelationshipInfo, M as ModelRef, g as ManifestContent, h as RecordObjectOptions, i as RecordObjectResult, S as SandboxListResponse, j as Sandbox, k as CreateSandboxData, l as DeleteResponse, m as PermissionProfile, n as CreatePermissionProfileData, o as CreateEnvironmentData, p as Subject, A as AssignmentListResponse } from './types-D5B8WlF4.mjs';
+export { a4 as APIError, u as Assignment, z as Build, F as BuildListResponse, B as BuildPolicy, y as BuildStatus, v as EnvironmentListResponse, r as GranularAuth, H as JobStatus, K as JobSubmitResult, w as Manifest, a2 as ManifestImport, x as ManifestListResponse, a1 as ManifestOperation, $ as ManifestPropertySpec, a0 as ManifestRelationshipDef, a3 as ManifestVolume, t as PermissionProfileListResponse, s as PermissionRules, L as Prompt, Q as RPCRequest, Y as RPCRequestFromServer, V as RPCResponse, X as SyncMessage, Z as ToolInvokeParams, _ as ToolResultParams, q as ToolSchema, N as WSDisconnectInfo, O as WSReconnectErrorInfo } from './types-D5B8WlF4.mjs';
 import { Doc } from '@automerge/automerge/slim';
 
 declare class WSClient {
@@ -24,6 +24,9 @@ declare class WSClient {
      * @returns {Promise<void>} Resolves when connection is open
      */
     connect(): Promise<void>;
+    private normalizeReason;
+    private rejectPending;
+    private buildDisconnectError;
     private handleDisconnect;
     private handleMessage;
     /**
@@ -638,6 +641,8 @@ declare class Granular {
     private apiUrl;
     private httpUrl;
     private WebSocketCtor?;
+    private onUnexpectedClose?;
+    private onReconnectError?;
     /** Sandbox-level effect registry: sandboxId → (toolName → ToolWithHandler) */
     private sandboxEffects;
     /** Active environments tracker: sandboxId → Environment[] */

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as Automerge from '@automerge/automerge';
-import { W as WSClientOptions, T as ToolWithHandler, P as PublishToolsResult, J as Job, a as ToolHandler, I as InstanceToolHandler, b as ToolInfo, c as ToolsChangedEvent, D as DomainState, G as GranularOptions, R as RecordUserOptions, U as User, C as ConnectOptions, E as EnvironmentData, d as GraphQLResult, e as DefineRelationshipOptions, f as RelationshipInfo, M as ModelRef, g as ManifestContent, h as RecordObjectOptions, i as RecordObjectResult, S as SandboxListResponse, j as Sandbox, k as CreateSandboxData, l as DeleteResponse, m as PermissionProfile, n as CreatePermissionProfileData, o as CreateEnvironmentData, p as Subject, A as AssignmentListResponse } from './types-CnX4jXYQ.js';
-export { a2 as APIError, u as Assignment, z as Build, F as BuildListResponse, B as BuildPolicy, y as BuildStatus, v as EnvironmentListResponse, r as GranularAuth, H as JobStatus, K as JobSubmitResult, w as Manifest, a0 as ManifestImport, x as ManifestListResponse, $ as ManifestOperation, Z as ManifestPropertySpec, _ as ManifestRelationshipDef, a1 as ManifestVolume, t as PermissionProfileListResponse, s as PermissionRules, L as Prompt, N as RPCRequest, V as RPCRequestFromServer, O as RPCResponse, Q as SyncMessage, X as ToolInvokeParams, Y as ToolResultParams, q as ToolSchema } from './types-CnX4jXYQ.js';
+import { W as WSClientOptions, T as ToolWithHandler, P as PublishToolsResult, J as Job, a as ToolHandler, I as InstanceToolHandler, b as ToolInfo, c as ToolsChangedEvent, D as DomainState, G as GranularOptions, R as RecordUserOptions, U as User, C as ConnectOptions, E as EnvironmentData, d as GraphQLResult, e as DefineRelationshipOptions, f as RelationshipInfo, M as ModelRef, g as ManifestContent, h as RecordObjectOptions, i as RecordObjectResult, S as SandboxListResponse, j as Sandbox, k as CreateSandboxData, l as DeleteResponse, m as PermissionProfile, n as CreatePermissionProfileData, o as CreateEnvironmentData, p as Subject, A as AssignmentListResponse } from './types-D5B8WlF4.js';
+export { a4 as APIError, u as Assignment, z as Build, F as BuildListResponse, B as BuildPolicy, y as BuildStatus, v as EnvironmentListResponse, r as GranularAuth, H as JobStatus, K as JobSubmitResult, w as Manifest, a2 as ManifestImport, x as ManifestListResponse, a1 as ManifestOperation, $ as ManifestPropertySpec, a0 as ManifestRelationshipDef, a3 as ManifestVolume, t as PermissionProfileListResponse, s as PermissionRules, L as Prompt, Q as RPCRequest, Y as RPCRequestFromServer, V as RPCResponse, X as SyncMessage, Z as ToolInvokeParams, _ as ToolResultParams, q as ToolSchema, N as WSDisconnectInfo, O as WSReconnectErrorInfo } from './types-D5B8WlF4.js';
 import { Doc } from '@automerge/automerge/slim';
 
 declare class WSClient {
@@ -24,6 +24,9 @@ declare class WSClient {
      * @returns {Promise<void>} Resolves when connection is open
      */
     connect(): Promise<void>;
+    private normalizeReason;
+    private rejectPending;
+    private buildDisconnectError;
     private handleDisconnect;
     private handleMessage;
     /**
@@ -638,6 +641,8 @@ declare class Granular {
     private apiUrl;
     private httpUrl;
     private WebSocketCtor?;
+    private onUnexpectedClose?;
+    private onReconnectError?;
     /** Sandbox-level effect registry: sandboxId → (toolName → ToolWithHandler) */
     private sandboxEffects;
     /** Active environments tracker: sandboxId → Environment[] */