@superatomai/sdk-node 0.0.95-dsp → 0.0.96-dsp

package/dist/index.d.mts

@@ -1463,10 +1463,12 @@ declare const MessageSchema: z.ZodObject<{
     from: z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         type: z.ZodOptional<z.ZodString>;
+        parcels: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
     to: z.ZodOptional<z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         type: z.ZodOptional<z.ZodString>;
+        parcels: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     payload: z.ZodUnknown;
 }, z.core.$strip>;
@@ -1477,10 +1479,12 @@ declare const IncomingMessageSchema: z.ZodObject<{
     from: z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         type: z.ZodOptional<z.ZodString>;
+        parcels: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
     to: z.ZodOptional<z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         type: z.ZodOptional<z.ZodString>;
+        parcels: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     payload: z.ZodUnknown;
 }, z.core.$strip>;
@@ -6069,6 +6073,8 @@ declare class SuperatomSDK {
     private parcelClient;
     private outgoing;
     private incoming;
+    /** The client sockets that said they read parcels; only they get large JSON as parcels or parts. */
+    private parcelReaders;
     constructor(config: SuperatomSDKConfig);
     /**
      * Initialize PromptLoader and load prompts into memory

package/dist/index.d.ts

@@ -1463,10 +1463,12 @@ declare const MessageSchema: z.ZodObject<{
     from: z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         type: z.ZodOptional<z.ZodString>;
+        parcels: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
     to: z.ZodOptional<z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         type: z.ZodOptional<z.ZodString>;
+        parcels: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     payload: z.ZodUnknown;
 }, z.core.$strip>;
@@ -1477,10 +1479,12 @@ declare const IncomingMessageSchema: z.ZodObject<{
     from: z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         type: z.ZodOptional<z.ZodString>;
+        parcels: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
     to: z.ZodOptional<z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         type: z.ZodOptional<z.ZodString>;
+        parcels: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     payload: z.ZodUnknown;
 }, z.core.$strip>;
@@ -6069,6 +6073,8 @@ declare class SuperatomSDK {
     private parcelClient;
     private outgoing;
     private incoming;
+    /** The client sockets that said they read parcels; only they get large JSON as parcels or parts. */
+    private parcelReaders;
     constructor(config: SuperatomSDKConfig);
     /**
      * Initialize PromptLoader and load prompts into memory

package/dist/index.js

@@ -348,7 +348,9 @@ var UsersDataSchema = import_zod3.z.object({
 });
 var MessageParticipantSchema = import_zod3.z.object({
   id: import_zod3.z.string().optional(),
-  type: import_zod3.z.string().optional()
+  type: import_zod3.z.string().optional(),
+  /** On `from`: the sending client reads parcels and parts (see parcels/ParcelReaders). */
+  parcels: import_zod3.z.boolean().optional()
 });
 var MessageSchema = import_zod3.z.object({
   id: import_zod3.z.string().optional(),
@@ -28581,6 +28583,26 @@ var recipientOf = (message) => {
   const id = message.to?.id;
   return typeof id === "string" ? id : "";
 };
+var MAX_READERS = 1e4;
+var ParcelReaders = class {
+  constructor(max = MAX_READERS) {
+    this.max = max;
+    this.ids = /* @__PURE__ */ new Set();
+  }
+  /** Notes what a received message says about its sender. */
+  noteSender(message) {
+    const from = message?.from;
+    if (typeof from?.id !== "string" || !from.id) return;
+    this.ids.delete(from.id);
+    if (from.parcels !== true) return;
+    this.ids.add(from.id);
+    if (this.ids.size > this.max) this.ids.delete(this.ids.values().next().value);
+  }
+  /** Whether the message is addressed to a socket that said it reads parcels. */
+  reads(message) {
+    return this.ids.has(recipientOf(message));
+  }
+};
 var InOrder = class {
   /** `onIdle` runs each time the last waiting task finishes. */
   constructor(onIdle) {
@@ -28602,15 +28624,19 @@ var InOrder = class {
   }
 };
 var OutgoingParcels = class {
-  constructor(client, jsonParcels, deliver, threshold = PARCEL_THRESHOLD_BYTES) {
+  constructor(client, jsonParcels, deliver, readers = null, threshold = PARCEL_THRESHOLD_BYTES) {
     this.client = client;
     this.jsonParcels = jsonParcels;
     this.deliver = deliver;
+    this.readers = readers;
     this.threshold = threshold;
     /** Only recipients with something waiting; a queue is dropped once it empties. */
     this.queues = /* @__PURE__ */ new Map();
     this.warnedNoClient = false;
   }
+  readsParcels(message) {
+    return this.readers ? this.readers.reads(message) : true;
+  }
   /**
    * Same contract as the SDK's `send`: never throws, returns whether the message
    * went out (or, for a queued one, was accepted).
@@ -28630,7 +28656,7 @@ var OutgoingParcels = class {
       files = false;
     }
     if (!files) {
-      if (!this.jsonParcels || !this.client) return this.now(message);
+      if (!this.jsonParcels || !this.client || !this.readsParcels(message)) return this.now(message);
       let wire;
       try {
         wire = JSON.stringify(message);
@@ -28692,6 +28718,12 @@ var OutgoingParcels = class {
     }
     const size = Buffer.byteLength(wire, "utf8");
     if (size < this.threshold) return [{ message: current, wire }];
+    if (!this.readsParcels(message)) {
+      if (size > MAX_INLINE_BYTES) {
+        logger.warn(`[parcels] ${message.type} (${size} bytes) is for a client that doesn't read parcels \u2014 sent inline; the relay may refuse it`);
+      }
+      return [{ message: current, wire }];
+    }
     let reason = "large-JSON parcels are off";
     if (this.jsonParcels && !storage.down) {
       const started = Date.now();
@@ -30152,6 +30184,8 @@ var SuperatomSDK = class {
     // since an outage of unknown length shouldn't grow this without limit.
     this.pendingOutbox = [];
     this.MAX_OUTBOX_SIZE = 50;
+    /** The client sockets that said they read parcels; only they get large JSON as parcels or parts. */
+    this.parcelReaders = new ParcelReaders();
     /**
      * The dashboard contract, as registered by the browser bundle that holds it.
      *
@@ -30178,7 +30212,8 @@ var SuperatomSDK = class {
     this.outgoing = new OutgoingParcels(
       this.parcelClient,
       jsonParcels,
-      (message, wire) => this.deliver(message, wire)
+      (message, wire) => this.deliver(message, wire),
+      this.parcelReaders
     );
     this.incoming = new IncomingParcels(this.parcelClient, (parsed) => this.dispatchMessage(parsed));
     this.anthropicApiKey = config2.ANTHROPIC_API_KEY || process.env.ANTHROPIC_API_KEY || "";
@@ -30345,6 +30380,7 @@ var SuperatomSDK = class {
       logger.error("Failed to parse incoming message:", error);
       return;
     }
+    this.parcelReaders.noteSender(parsed);
     this.incoming.receive(parsed, data);
   }
   /** Routes one parsed message — everything `handleMessage` did after parsing. */

package/dist/index.mjs

@@ -228,7 +228,9 @@ var UsersDataSchema = z3.object({
 });
 var MessageParticipantSchema = z3.object({
   id: z3.string().optional(),
-  type: z3.string().optional()
+  type: z3.string().optional(),
+  /** On `from`: the sending client reads parcels and parts (see parcels/ParcelReaders). */
+  parcels: z3.boolean().optional()
 });
 var MessageSchema = z3.object({
   id: z3.string().optional(),
@@ -28461,6 +28463,26 @@ var recipientOf = (message) => {
   const id = message.to?.id;
   return typeof id === "string" ? id : "";
 };
+var MAX_READERS = 1e4;
+var ParcelReaders = class {
+  constructor(max = MAX_READERS) {
+    this.max = max;
+    this.ids = /* @__PURE__ */ new Set();
+  }
+  /** Notes what a received message says about its sender. */
+  noteSender(message) {
+    const from = message?.from;
+    if (typeof from?.id !== "string" || !from.id) return;
+    this.ids.delete(from.id);
+    if (from.parcels !== true) return;
+    this.ids.add(from.id);
+    if (this.ids.size > this.max) this.ids.delete(this.ids.values().next().value);
+  }
+  /** Whether the message is addressed to a socket that said it reads parcels. */
+  reads(message) {
+    return this.ids.has(recipientOf(message));
+  }
+};
 var InOrder = class {
   /** `onIdle` runs each time the last waiting task finishes. */
   constructor(onIdle) {
@@ -28482,15 +28504,19 @@ var InOrder = class {
   }
 };
 var OutgoingParcels = class {
-  constructor(client, jsonParcels, deliver, threshold = PARCEL_THRESHOLD_BYTES) {
+  constructor(client, jsonParcels, deliver, readers = null, threshold = PARCEL_THRESHOLD_BYTES) {
     this.client = client;
     this.jsonParcels = jsonParcels;
     this.deliver = deliver;
+    this.readers = readers;
     this.threshold = threshold;
     /** Only recipients with something waiting; a queue is dropped once it empties. */
     this.queues = /* @__PURE__ */ new Map();
     this.warnedNoClient = false;
   }
+  readsParcels(message) {
+    return this.readers ? this.readers.reads(message) : true;
+  }
   /**
    * Same contract as the SDK's `send`: never throws, returns whether the message
    * went out (or, for a queued one, was accepted).
@@ -28510,7 +28536,7 @@ var OutgoingParcels = class {
       files = false;
     }
     if (!files) {
-      if (!this.jsonParcels || !this.client) return this.now(message);
+      if (!this.jsonParcels || !this.client || !this.readsParcels(message)) return this.now(message);
       let wire;
       try {
         wire = JSON.stringify(message);
@@ -28572,6 +28598,12 @@ var OutgoingParcels = class {
     }
     const size = Buffer.byteLength(wire, "utf8");
     if (size < this.threshold) return [{ message: current, wire }];
+    if (!this.readsParcels(message)) {
+      if (size > MAX_INLINE_BYTES) {
+        logger.warn(`[parcels] ${message.type} (${size} bytes) is for a client that doesn't read parcels \u2014 sent inline; the relay may refuse it`);
+      }
+      return [{ message: current, wire }];
+    }
     let reason = "large-JSON parcels are off";
     if (this.jsonParcels && !storage.down) {
       const started = Date.now();
@@ -30032,6 +30064,8 @@ var SuperatomSDK = class {
     // since an outage of unknown length shouldn't grow this without limit.
     this.pendingOutbox = [];
     this.MAX_OUTBOX_SIZE = 50;
+    /** The client sockets that said they read parcels; only they get large JSON as parcels or parts. */
+    this.parcelReaders = new ParcelReaders();
     /**
      * The dashboard contract, as registered by the browser bundle that holds it.
      *
@@ -30058,7 +30092,8 @@ var SuperatomSDK = class {
     this.outgoing = new OutgoingParcels(
       this.parcelClient,
       jsonParcels,
-      (message, wire) => this.deliver(message, wire)
+      (message, wire) => this.deliver(message, wire),
+      this.parcelReaders
     );
     this.incoming = new IncomingParcels(this.parcelClient, (parsed) => this.dispatchMessage(parsed));
     this.anthropicApiKey = config2.ANTHROPIC_API_KEY || process.env.ANTHROPIC_API_KEY || "";
@@ -30225,6 +30260,7 @@ var SuperatomSDK = class {
       logger.error("Failed to parse incoming message:", error);
       return;
     }
+    this.parcelReaders.noteSender(parsed);
     this.incoming.receive(parsed, data);
   }
   /** Routes one parsed message — everything `handleMessage` did after parsing. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superatomai/sdk-node",
-  "version": "0.0.95-dsp",
+  "version": "0.0.96-dsp",
   "description": "Node.js TypeScript SDK for Superatom",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",