wontopos 2.2.31 → 2.2.32

package/dist/wontopos.d.ts

@@ -148,9 +148,17 @@ export interface StatusResult {
 /**
  * An image attached to a memory, passed to `add`/`store` via `opts.image`.
  *
- * The bytes are used ONCE, to embed the image, and are not kept. If you want the
- * original back later, either let the service keep it (then `getImage` returns it) or
- * put your own URL in `reference` — we store that string and never open it.
+ * What the service keeps is NOT your original. An image whose long edge is over
+ * 1568px is downscaled to 1568 before anything else happens, and that smaller
+ * picture is what gets embedded, stored, and handed back by `getImage`. Nothing in
+ * the retrieval path ever looks above 1568 — the embedder and the reader both
+ * shrink to it — so the extra pixels would be bytes nobody reads. This is a memory
+ * service, not a photo host: the picture it holds has the resolution of a memory.
+ *
+ * Keep your own copy if you need the full-resolution file. Either archive it
+ * yourself, or put its URL in `reference` — we store that string and never open it.
+ *
+ * You are billed for the picture we keep, so downscaling never costs you more.
  */
 export interface ImageInput {
     /** base64 of the image. A `data:image/...;base64,` prefix is accepted and stripped. */
@@ -166,9 +174,14 @@ export interface ImageInput {
      */
     taken_at?: string;
 }
-/** `getImage` → the original bytes plus what they actually are. */
+/** `getImage` → the picture the service holds, plus what it actually is. */
 export interface ImageBytes {
-    /** The raw image. Write it to a file, or wrap it in a Blob to show it. */
+    /**
+     * The image as stored. Write it to a file, or wrap it in a Blob to show it.
+     *
+     * This is the service's copy, not necessarily your upload: anything over 1568px
+     * on its long edge was downscaled on the way in (see `ImageInput`).
+     */
     bytes: Uint8Array;
     /** Sniffed from the BYTES, not from whatever the upload was named — e.g. `image/jpeg`. */
     contentType: string;
@@ -650,9 +663,13 @@ export declare class Client {
     /** Collect ALL of a store's memories into an array (original text + metadata, no vectors). */
     exportMemories(userId?: string): Promise<Memory[]>;
     /**
-     * Fetch the ORIGINAL bytes of an image memory.
+     * Fetch the bytes of an image memory — the picture the SERVICE holds.
      *
-     * Returns what was uploaded, with the type sniffed from the bytes themselves rather
+     * Not necessarily your upload: an image whose long edge was over 1568px was
+     * downscaled to 1568 on the way in, and that is what was embedded, stored and
+     * comes back here. Nothing in the retrieval path looks above 1568, so the extra
+     * pixels would be bytes nobody reads. Keep your own copy for the full-resolution
+     * file. The type is sniffed from the bytes themselves rather
      * than from whatever the file was called. Rejects with `NotFoundError` when this
      * memory has no image, or when the service was not configured to keep originals —
      * it says "no" instead of handing back something empty, so "a memory with no image"

package/dist/wontopos.js

@@ -37,7 +37,7 @@
  * runtime's (never disabled by this SDK; Node 18+ floors TLS at 1.2). Prefer
  * `Client.fromEnv()` over keys in source code.
  */
-const VERSION = "2.2.31";
+const VERSION = "2.2.32";
 /** Runtime info helps support debug a report ("node 18 on Windows...") —
  * platform only, never anything identifying. Browsers have no `process` (and
  * silently drop the UA header anyway). */
@@ -689,9 +689,13 @@ export class Client {
     }
     // ----- images (Tablet 2 and newer) -----
     /**
-     * Fetch the ORIGINAL bytes of an image memory.
+     * Fetch the bytes of an image memory — the picture the SERVICE holds.
      *
-     * Returns what was uploaded, with the type sniffed from the bytes themselves rather
+     * Not necessarily your upload: an image whose long edge was over 1568px was
+     * downscaled to 1568 on the way in, and that is what was embedded, stored and
+     * comes back here. Nothing in the retrieval path looks above 1568, so the extra
+     * pixels would be bytes nobody reads. Keep your own copy for the full-resolution
+     * file. The type is sniffed from the bytes themselves rather
      * than from whatever the file was called. Rejects with `NotFoundError` when this
      * memory has no image, or when the service was not configured to keep originals —
      * it says "no" instead of handing back something empty, so "a memory with no image"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wontopos",
-  "version": "2.2.31",
+  "version": "2.2.32",
   "description": "Wontopos — long-term memory for AI agents. Pure semantic retrieval, identical recall in every language, ~100× lower LLM bill.",
   "keywords": [
     "memory",