@mindstudio-ai/agent 0.1.105 → 0.1.106

package/dist/index.d.ts

@@ -2811,6 +2811,15 @@ interface CrawlerHit {
 interface Analytics {
     /** The general read: metrics × dimensions × filters × time. */
     query(spec: AnalyticsQuerySpec): Promise<AnalyticsQueryResponse>;
+    /**
+     * Up to 10 queries in one round trip, results in request order — the right
+     * shape for a page composed of several reads (KPIs + timeseries + a few
+     * breakdowns), instead of a parallel burst of `query()` calls competing
+     * with each other against the per-app rate limit. Each query in the batch
+     * counts as one read against the limit. One invalid query fails the whole
+     * batch (the error names its index).
+     */
+    batch(specs: AnalyticsQuerySpec[]): Promise<AnalyticsQueryResponse[]>;
     /** Who's on the app right now (Redis presence, no time window). */
     live(): Promise<LiveNow>;
     /**
@@ -3534,6 +3543,12 @@ declare class MindStudioAgent$1 {
     /**
      * @internal Transport for the `analytics` namespace —
      * POST /_internal/v2/analytics/<op> with the raw hook token.
+     *
+     * Retries a single 429 after a short jittered backoff: analytics reads are
+     * idempotent and a 429 means the read never executed, so one retry lets a
+     * momentary burst (a page's fan-out racing a live poller) self-heal instead
+     * of surfacing as empty data. Deliberately single-shot and scoped to this
+     * namespace — the other brokered transports keep their semantics.
      */
     private _analyticsRequest;
     /**

package/dist/index.js

@@ -2784,6 +2784,10 @@ function createAnalytics(call) {
     query(spec) {
       return call("query", spec);
     },
+    async batch(specs) {
+      const res = await call("query-batch", { queries: specs });
+      return res.results;
+    },
     live() {
       return call("live", {});
     },
@@ -6655,12 +6659,29 @@ var MindStudioAgent = class {
   /**
    * @internal Transport for the `analytics` namespace —
    * POST /_internal/v2/analytics/<op> with the raw hook token.
+   *
+   * Retries a single 429 after a short jittered backoff: analytics reads are
+   * idempotent and a 429 means the read never executed, so one retry lets a
+   * momentary burst (a page's fan-out racing a live poller) self-heal instead
+   * of surfacing as empty data. Deliberately single-shot and scoped to this
+   * namespace — the other brokered transports keep their semantics.
    */
   async _analyticsRequest(op, body) {
-    return this._brokeredRequest("analytics", op, body, {
+    const call = () => this._brokeredRequest("analytics", op, body, {
       fallbackMessage: "Analytics read failed",
       fallbackCode: "analytics_error"
     });
+    try {
+      return await call();
+    } catch (err) {
+      if (err instanceof MindStudioError && err.status === 429) {
+        await new Promise(
+          (resolve) => setTimeout(resolve, 750 + Math.random() * 750)
+        );
+        return call();
+      }
+      throw err;
+    }
   }
   /**
    * @internal Shared shape for the brokered `/_internal/v2/<ns>/<op>` data