@mindstudio-ai/agent 0.1.107 → 0.1.108

package/dist/postinstall.js

@@ -1392,9 +1392,83 @@ function isReadOnlySql(sql) {
   const head = sql.trimStart().slice(0, 8).toUpperCase();
   return head.startsWith("SELECT") || head.startsWith("PRAGMA") || head.startsWith("EXPLAIN");
 }
-function getOrOpen(url) {
-  if (socket && socket.readyState === WS_OPEN) {
-    return Promise.resolve(socket);
+function clearPendingTimer(p) {
+  if (p.timer !== null) {
+    clearTimeout(p.timer);
+    p.timer = null;
+  }
+}
+function forget(self, id) {
+  self.pending.delete(id);
+  self.inbound.delete(id);
+  if (self.retired && self.pending.size === 0) {
+    try {
+      self.ws.close();
+    } catch {
+    }
+  }
+}
+function retire(self, reason) {
+  if (self.retired) {
+    return;
+  }
+  self.retired = true;
+  if (conn === self) {
+    conn = null;
+  }
+  try {
+    console.warn(
+      `[mindstudio] db: retiring WebSocket after ${reason}; next query reconnects.`
+    );
+  } catch {
+  }
+  if (self.pending.size === 0) {
+    try {
+      self.ws.close();
+    } catch {
+    }
+  }
+}
+function armIdleTimer(self, id, p) {
+  clearPendingTimer(p);
+  p.timer = setTimeout(() => {
+    forget(self, id);
+    retire(self, "a reply went silent");
+    p.reject(new DbWsTransportError("ws reply went silent", true));
+  }, WS_IDLE_TIMEOUT_MS);
+}
+function deliver(self, msg) {
+  const p = self.pending.get(msg.id);
+  if (!p) {
+    return;
+  }
+  clearPendingTimer(p);
+  forget(self, msg.id);
+  if (msg.error) {
+    p.reject(
+      new MindStudioError(
+        `[db] ${msg.error.message || "Database query failed"}`,
+        msg.error.code || "db_query_error",
+        400,
+        msg.error
+      )
+    );
+  } else {
+    p.resolve(msg.results);
+  }
+}
+function failTransport(self, id, err) {
+  const p = self.pending.get(id);
+  if (!p) {
+    return;
+  }
+  clearPendingTimer(p);
+  forget(self, id);
+  p.reject(err);
+}
+function getOrOpen(url, token) {
+  if (conn && !conn.retired && conn.ws.readyState === WS_OPEN) {
+    return Promise.resolve(conn);
   }
   if (opening) {
     return opening;
@@ -1407,17 +1481,22 @@ function getOrOpen(url) {
   }
   opening = new Promise((resolve, reject) => {
     let ws;
+    let self = null;
     const fail = (err) => {
       clearTimeout(openTimer);
-      if (socket === ws) {
-        socket = null;
+      if (self) {
+        self.retired = true;
+        if (conn === self) {
+          conn = null;
+        }
+        for (const [, p] of self.pending) {
+          clearPendingTimer(p);
+          p.reject(new DbWsTransportError(err.message, true));
+        }
+        self.pending.clear();
+        self.inbound.clear();
       }
       opening = null;
-      for (const [, p] of pending) {
-        clearTimeout(p.timer);
-        p.reject(new DbWsTransportError(err.message, true));
-      }
-      pending.clear();
       reject(err);
     };
     const openTimer = setTimeout(() => {
@@ -1428,16 +1507,26 @@ function getOrOpen(url) {
       fail(new DbWsTransportError("ws open timed out"));
     }, WS_OPEN_TIMEOUT_MS);
     try {
-      ws = new WebSocketCtor(url);
+      ws = new WebSocketCtor(url, ["auth", token, DB_WS_SUBPROTOCOL]);
     } catch (err) {
       fail(new DbWsTransportError(err?.message || "ws construct failed"));
       return;
     }
+    self = {
+      ws,
+      pending: /* @__PURE__ */ new Map(),
+      chunked: false,
+      inbound: /* @__PURE__ */ new Map(),
+      acksSeen: false,
+      retired: false
+    };
+    const c = self;
     ws.onopen = () => {
       clearTimeout(openTimer);
-      socket = ws;
+      c.chunked = ws.protocol === DB_WS_SUBPROTOCOL;
+      conn = c;
       opening = null;
-      resolve(ws);
+      resolve(c);
     };
     ws.onmessage = (ev) => {
       let msg;
@@ -1448,26 +1537,54 @@ function getOrOpen(url) {
       } catch {
         return;
       }
-      if (!msg || msg.t !== "db-result" || msg.id == null) {
+      if (!msg || msg.id == null) {
         return;
       }
-      const p = pending.get(msg.id);
-      if (!p) {
+      if (msg.t === "db-ack") {
+        c.acksSeen = true;
+        const p = c.pending.get(msg.id);
+        if (p && !p.acked) {
+          p.acked = true;
+          armIdleTimer(c, msg.id, p);
+        }
         return;
       }
-      clearTimeout(p.timer);
-      pending.delete(msg.id);
-      if (msg.error) {
-        p.reject(
-          new MindStudioError(
-            `[db] ${msg.error.message || "Database query failed"}`,
-            msg.error.code || "db_query_error",
-            400,
-            msg.error
-          )
-        );
-      } else {
-        p.resolve(msg.results);
+      if (msg.t === "db-chunk") {
+        const p = c.pending.get(msg.id);
+        if (!p || typeof msg.data !== "string") {
+          return;
+        }
+        const parts = c.inbound.get(msg.id);
+        if (parts) {
+          parts.push(msg.data);
+        } else {
+          c.inbound.set(msg.id, [msg.data]);
+        }
+        armIdleTimer(c, msg.id, p);
+        return;
+      }
+      if (msg.t === "db-end") {
+        const parts = c.inbound.get(msg.id);
+        if (!parts) {
+          return;
+        }
+        c.inbound.delete(msg.id);
+        let assembled;
+        try {
+          assembled = JSON.parse(parts.join(""));
+        } catch {
+          failTransport(
+            c,
+            msg.id,
+            new DbWsTransportError("chunked reply did not parse", true)
+          );
+          return;
+        }
+        deliver(c, assembled);
+        return;
+      }
+      if (msg.t === "db-result") {
+        deliver(c, msg);
       }
     };
     ws.onerror = () => fail(new DbWsTransportError("ws error"));
@@ -1475,41 +1592,75 @@ function getOrOpen(url) {
   });
   return opening;
 }
+function* outboundFrames(id, json) {
+  if (json.length <= WS_CHUNK_CHARS) {
+    yield json;
+    return;
+  }
+  let seq = 0;
+  for (let offset = 0; offset < json.length; offset += WS_CHUNK_CHARS) {
+    yield JSON.stringify({
+      t: "db-chunk",
+      id,
+      seq: seq++,
+      data: json.slice(offset, offset + WS_CHUNK_CHARS)
+    });
+  }
+  yield JSON.stringify({ t: "db-end", id });
+}
 async function executeDbBatchOverWs(url, token, databaseId, queries) {
   const id = ++idCounter;
   const frame = JSON.stringify({ t: "db", id, token, databaseId, queries });
-  if (frame.length > WS_MAX_FRAME_CHARS) {
+  const self = await getOrOpen(url, token);
+  if (!self.chunked && frame.length > WS_MAX_FRAME_CHARS) {
     throw new DbWsTransportError("payload too large for ws");
   }
-  const ws = await getOrOpen(url);
   return await new Promise((resolve, reject) => {
-    const timer = setTimeout(() => {
-      pending.delete(id);
-      reject(new DbWsTransportError("ws execute timed out", true));
-    }, WS_REQUEST_TIMEOUT_MS);
-    pending.set(id, { resolve, reject, timer });
+    const pending = { resolve, reject, timer: null, acked: false };
+    if (self.acksSeen) {
+      pending.timer = setTimeout(() => {
+        forget(self, id);
+        retire(self, "a request went unacknowledged");
+        reject(new DbWsTransportError("ws ack timed out", true));
+      }, WS_ACK_TIMEOUT_MS);
+    } else {
+      armIdleTimer(self, id, pending);
+    }
+    self.pending.set(id, pending);
+    let started = false;
+    let complete = false;
     try {
-      ws.send(frame);
+      for (const out of outboundFrames(id, frame)) {
+        self.ws.send(out);
+        started = true;
+      }
+      complete = true;
     } catch (err) {
-      clearTimeout(timer);
-      pending.delete(id);
+      clearPendingTimer(pending);
+      forget(self, id);
+      if (started) {
+        retire(self, "a partial request upload failed");
+      }
       reject(
         new DbWsTransportError(
           `ws send failed: ${err?.message || "unknown"}`,
-          false
+          complete
         )
       );
     }
   });
 }
-var WS_REQUEST_TIMEOUT_MS, WS_OPEN_TIMEOUT_MS, WS_OPEN, WS_MAX_FRAME_CHARS, DbWsTransportError, socket, opening, idCounter, pending;
+var DB_WS_SUBPROTOCOL, WS_ACK_TIMEOUT_MS, WS_IDLE_TIMEOUT_MS, WS_OPEN_TIMEOUT_MS, WS_OPEN, WS_CHUNK_CHARS, WS_MAX_FRAME_CHARS, DbWsTransportError, conn, opening, idCounter;
 var init_db_ws = __esm({
   "src/db-ws.ts"() {
     "use strict";
     init_errors();
-    WS_REQUEST_TIMEOUT_MS = 3e5;
+    DB_WS_SUBPROTOCOL = "ms-db-v2";
+    WS_ACK_TIMEOUT_MS = 2e4;
+    WS_IDLE_TIMEOUT_MS = 3e5;
     WS_OPEN_TIMEOUT_MS = 5e3;
     WS_OPEN = 1;
+    WS_CHUNK_CHARS = 256 * 1024;
     WS_MAX_FRAME_CHARS = 9e5;
     DbWsTransportError = class extends Error {
       constructor(message, sent = false) {
@@ -1518,10 +1669,9 @@ var init_db_ws = __esm({
       }
       name = "DbWsTransportError";
     };
-    socket = null;
+    conn = null;
     opening = null;
     idCounter = 0;
-    pending = /* @__PURE__ */ new Map();
   }
 });
 
@@ -4248,6 +4398,56 @@ var init_analytics = __esm({
   }
 });
 
+// src/email/index.ts
+function createEmail(call) {
+  return {
+    stats(options) {
+      return call("stats", {
+        start: iso(options?.start),
+        end: iso(options?.end),
+        buckets: options?.buckets
+      });
+    },
+    messages(options) {
+      return call("messages", {
+        ...options,
+        start: iso(options?.start),
+        end: iso(options?.end)
+      });
+    },
+    message(messageId) {
+      return call("message", { messageId });
+    },
+    batches(options) {
+      return call("batches", {
+        start: iso(options?.start),
+        end: iso(options?.end),
+        limit: options?.limit,
+        offset: options?.offset
+      });
+    },
+    batch(batchId) {
+      return call("batch", { batchId });
+    },
+    suppressions(options) {
+      return call("suppressions", options ?? {});
+    },
+    suppress(email) {
+      return call("suppress", { email });
+    },
+    unsuppress(email) {
+      return call("unsuppress", { email });
+    }
+  };
+}
+var iso;
+var init_email = __esm({
+  "src/email/index.ts"() {
+    "use strict";
+    iso = (v) => v === void 0 ? void 0 : v instanceof Date ? v.toISOString() : v;
+  }
+});
+
 // src/task/schema.ts
 function describe(value) {
   if (value === void 0) return "undefined";
@@ -5752,6 +5952,7 @@ var init_client = __esm({
     init_datasources();
     init_voice();
     init_analytics();
+    init_email();
     await init_task();
     await init_local();
     init_schema();
@@ -5795,6 +5996,7 @@ var init_client = __esm({
       _dataSources;
       _voice;
       _analytics;
+      _email;
       /** @internal Auth type — 'internal' for CALLBACK_TOKEN (managed mode), 'apiKey' otherwise. */
       _authType;
       /** @internal Usage source sent on step executions (from MINDSTUDIO_REQUEST_SOURCE).
@@ -6839,6 +7041,24 @@ var init_client = __esm({
           this._analyticsRequest.bind(this)
         );
       }
+      /**
+       * Outbound email: the per-recipient delivery log, blast stats, and this app's
+       * unsubscribe list. Sending is the `sendEmail` action, not this namespace.
+       *
+       * @example
+       * ```ts
+       * import { email } from '@mindstudio-ai/agent';
+       *
+       * // A support lookup: did this person get their mail?
+       * const { messages } = await email.messages({ recipient: 'a@b.com' });
+       *
+       * // How did the August newsletter do?
+       * const blast = await email.batch('newsletter-2026-08');
+       * ```
+       */
+      get email() {
+        return this._email ??= createEmail(this._emailRequest.bind(this));
+      }
       /**
        * Jewel surfaces: arrival-shaped triggers (`propose`) and the app-native
        * approval queue (`queue.list` / `queue.resolve`). See {@link JewelsApi}.
@@ -6977,6 +7197,18 @@ var init_client = __esm({
        * of surfacing as empty data. Deliberately single-shot and scoped to this
        * namespace — the other brokered transports keep their semantics.
        */
+      /**
+       * Brokered email transport. No 429 retry, unlike analytics: this namespace
+       * carries writes (suppress / unsuppress), and silently retrying a mutation is a
+       * different risk from retrying an idempotent read. A caller that wants one can
+       * retry a read itself.
+       */
+      async _emailRequest(op, body) {
+        return this._brokeredRequest("email", op, body, {
+          fallbackMessage: "Email API call failed",
+          fallbackCode: "email_error"
+        });
+      }
       async _analyticsRequest(op, body) {
         const call = () => this._brokeredRequest("analytics", op, body, {
           fallbackMessage: "Analytics read failed",
@@ -8295,7 +8527,7 @@ async function cmdAsk(question, options) {
     process.exit(1);
   }
 }
-var DEFAULT_BASE_URL2, ansi;
+var DEFAULT_BASE_URL2, color, ansi;
 var init_ask = __esm({
   async "src/ask/index.ts"() {
     "use strict";
@@ -8305,12 +8537,11 @@ var init_ask = __esm({
     init_tools();
     init_prompt();
     DEFAULT_BASE_URL2 = "https://v1.mindstudio-api.com";
+    color = process.stderr.isTTY;
     ansi = {
-      dim: (s) => `\x1B[2m${s}\x1B[0m`,
-      green: (s) => `\x1B[32m${s}\x1B[0m`,
-      red: (s) => `\x1B[31m${s}\x1B[0m`,
-      cyan: (s) => `\x1B[36m${s}\x1B[0m`,
-      bold: (s) => `\x1B[1m${s}\x1B[0m`
+      dim: (s) => color ? `\x1B[2m${s}\x1B[0m` : s,
+      cyan: (s) => color ? `\x1B[36m${s}\x1B[0m` : s,
+      bold: (s) => color ? `\x1B[1m${s}\x1B[0m` : s
     };
   }
 });
@@ -8375,7 +8606,7 @@ async function startMcpServer(options) {
           capabilities: { tools: {} },
           serverInfo: {
             name: "mindstudio-agent",
-            version: "0.1.107"
+            version: "0.1.108"
           },
           instructions: 'Welcome to MindStudio \u2014 a platform with 200+ AI models, 850+ third-party integrations, and pre-built agents.\n\nGetting started:\n1. Call `ask` with any question about the SDK \u2014 it knows every action, model, and connector and returns working code with real model IDs and config options. Examples: ask("generate an image with FLUX"), ask("what models support vision?"), ask("how do I send a Slack message?").\n2. Call `changeName` to set your display name \u2014 use your name or whatever your user calls you. This is how you\'ll appear in MindStudio request logs.\n3. If you have a profile picture, pass its public image URL to `changeProfilePicture`.\n4. For manual browsing, call `listActions` to discover all available actions.\n\nThen use the tools to generate text, images, video, audio, search the web, work with data sources, run agents, and more.\n\nImportant:\n- AI-powered actions (text generation, image generation, video, audio, etc.) cost money. Before running these, call `estimateActionCost` and confirm with the user before proceeding \u2014 unless they\'ve explicitly told you to go ahead.\n- Not all agents from `listAgents` are configured for API use. Do not try to run an agent just because it appears in the list \u2014 it will likely fail. Only run agents the user specifically asks you to run.'
         });
@@ -9263,7 +9494,7 @@ function isNewerVersion(current, latest) {
   return false;
 }
 async function checkForUpdate() {
-  const currentVersion = "0.1.107";
+  const currentVersion = "0.1.108";
   if (!currentVersion) return null;
   try {
     const { loadConfig: loadConfig2, saveConfig: saveConfig2 } = await Promise.resolve().then(() => (init_config(), config_exports));
@@ -9292,7 +9523,7 @@ async function checkForUpdate() {
   }
 }
 function printUpdateNotice(latestVersion) {
-  const currentVersion = "0.1.107";
+  const currentVersion = "0.1.108";
   process.stderr.write(
     `
   ${ansi2.cyanBright("Update available")} ${ansi2.gray(currentVersion + " \u2192")} ${ansi2.cyanBold(latestVersion)}
@@ -9305,7 +9536,7 @@ function isStandaloneBinary() {
   return !argv1.includes("node_modules");
 }
 async function cmdUpdate() {
-  const currentVersion = "0.1.107";
+  const currentVersion = "0.1.108";
   process.stderr.write(
     `  ${ansi2.gray("Current version:")} ${currentVersion}
 `
@@ -9420,7 +9651,7 @@ async function cmdLogin(options) {
   process.stderr.write("\n");
   printLogo();
   process.stderr.write("\n");
-  const ver = "0.1.107";
+  const ver = "0.1.108";
   process.stderr.write(
     `  ${ansi2.bold("MindStudio Agent")} ${ver ? " " + ansi2.gray("v" + ver) : ""}
 `
@@ -9731,7 +9962,7 @@ async function main() {
   try {
     if (command === "version" || command === "-v") {
       process.stdout.write(
-        "0.1.107\n"
+        "0.1.108\n"
       );
       return;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindstudio-ai/agent",
-  "version": "0.1.107",
+  "version": "0.1.108",
   "description": "TypeScript SDK for MindStudio direct step execution",
   "type": "module",
   "main": "./dist/index.js",