wontopos 2.2.35 → 2.2.36

package/README.md

@@ -25,7 +25,7 @@ const ctx = await mem.recall("what does alice drink?", "alice");
 
 - **The same in every language** — identical recall whichever language a memory was written in (Korean · Japanese · Chinese · English).
 - **No LLM in the loop** — `store` / `search` / `recall` never call a language model. You pay retrieval, not generation.
-- **Bounded retrieval** — `recall()` returns a small, fixed-size slice (~1,200 tokens) regardless of how much you've stored.
+- **Bounded retrieval** — `recall()` returns a small, fixed-size slice regardless of how much you've stored (~1,000 tokens on `tablet-2`, the default engine).
 
 ## Methods
 
@@ -89,7 +89,14 @@ Built in, no configuration needed:
   exponential backoff + jitter, honoring the server's `Retry-After`. Tune with
   `new Client({ maxRetries })`; `0` disables.
 - **Redirects refused** — the API key never follows a 3xx to another host.
-- **Timeouts** — 30s per attempt by default (`timeoutMs`).
+- **Timeouts** — 30s per attempt by default (`timeoutMs`), and a total budget for
+  the whole call across every retry with `deadlineMs` / `withDeadline(ms)`. At the
+  defaults one call can hold for 30s + backoff + 30s + backoff + 30s, which a
+  request handler with five seconds cannot use.
+- **Cancellable** — pass the caller's `AbortSignal` (`new Client({ signal })` or
+  `withSignal(signal)`). Aborting ends the request in flight and any backoff sleep
+  waiting to retry it.
+- **CommonJS and ESM** — `require("wontopos")` and `import` both resolve.
 - **Key never in logs** — `JSON.stringify(client)` and Node's `console.log(client)`
   print a masked key.
 - **Wipe guard** — `delete()` without a `memoryId` throws instead of silently
@@ -175,10 +182,13 @@ try {
 }
 ```
 
-## Self-host
+## A different API host
+
+Point the client somewhere other than the default endpoint - a dedicated region,
+a proxy of your own, or a local test server:
 
 ```ts
-const mem = new Client({ apiKey: "...", baseUrl: "https://wos.your-host.com" });
+const mem = new Client({ apiKey: "...", baseUrl: "https://api.example.com" });
 ```
 
 ## Links
@@ -207,6 +217,28 @@ default engine, and 2.2.35 gives `search` the count range `recall` has always ha
 rule you can bend without saying so is not a rule, so both are stated rather than left
 for a reader to hit.
 
+- **2.2.36** — an outside review, read by a different model with no knowledge of why
+  any of this was written. The one that mattered: `recall()` promised in its own
+  documentation that a count outside 5–20 was refused rather than clamped, and
+  nothing checked — so `{ limit: 500 }` travelled to the service and failed there, for a
+  mistake visible before opening a socket. `context_limit` (0–20) was unchecked the same way.
+  Both are refused here now, and `0` still passes for `context_limit` because "attach none" is
+  an answer, not a missing value.
+  An argument mistake now throws a plain `Error`, not a `WosError`. A `WosError` with
+  status 0 is `APIConnectionError` — "the request never got a response" — so
+  `if (e.status === 0) retry()` would have retried a typo forever. And `recall` is
+  now `async`: validating inside a non-async method threw synchronously, so
+  `mem.recall(...).catch(h)` walked past the handler while the same mistake in
+  `search` landed in it.
+  New `deadlineMs` / `withDeadline(ms)`: a TOTAL budget for one call across every
+  retry. `timeoutMs` bounds one ATTEMPT, so at the defaults a call could hold for 30s
+  + backoff + 30s + backoff + 30s and a request handler with five seconds had no way
+  to say so. New `signal` / `withSignal(signal)`: cancel work in flight — an abort
+  ends the request AND any backoff sleep waiting to retry it.
+  `require("wontopos")` now resolves: the package ships CommonJS and ESM from one
+  source. Previously `"type": "module"` with no `require` condition meant Node's CJS
+  resolver could not resolve this package at all.
+  `replayed` is set only when the service did not send that field itself.
 - **2.2.35** — fixes, and **two behaviour changes**, both listed first because a patch
   release is not the place to find one by surprise.
 

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}