@theoremjs/web 0.3.4-next.781.g97bafb5 → 0.3.4-next.785.g899b273

package/README.md

@@ -282,13 +282,11 @@ const transport = withPageToolDispatch(
 
 ### Defaults
 
-A limit that stops a turn or refuses a request is unset unless you set it: `gateTtlMs`, `maxRequestBytes`, `pageToolTimeoutMs`, and a session store's `capacity`. Only what keeps stored data from growing without end has a default:
+A limit that stops a turn or refuses a request is unset unless you set it: `gateTtlMs`, `maxRequestBytes`, `pageToolTimeoutMs`, and a session store's `capacity`. The memory stores expire and evict nothing unless you set `ttlMs` and `maxSessions`, so they grow until the process ends. Set both on a public server. These have a default:
 
 | What | Default | Set it with |
 | --- | --- | --- |
 | A settled tool result | Kept 24 hours | `operationRetentionMs` |
-| A session in `createMemorySessionStore` | Dropped after 24 idle hours; at most 10,000 kept | `ttlMs`, `maxSessions` |
-| A conversation in `createMemoryConversationStore` | Dropped after 24 hours unsaved; at most 10,000 kept | `ttlMs`, `maxSessions` |
 | The session cookie | Lasts 30 days | `session` |
 
 A model profile that leaves out `maxSteps` makes at most 20 model calls a turn.
@@ -326,7 +324,7 @@ The session store keeps gates, permissions, and operations. The two stores are s
 
 | Store | Where the conversation is kept |
 | --- | --- |
-| `createMemoryConversationStore()` | Process memory, for one server instance. A conversation that is not saved for 24 hours expires. At most 10,000 conversations are kept; the one saved longest ago goes first. Set `ttlMs` and `maxSessions` to change these limits. |
+| `createMemoryConversationStore()` | Process memory, for one server instance. It keeps every conversation until the process ends. Set `ttlMs` to expire a conversation that is not saved for that long, and `maxSessions` to cap the count; the one saved longest ago goes first. |
 | `createSealedConversationStore({ keys, keyVersion })` | Nowhere on the server. The ref is the conversation itself, encrypted and signed with your key, and bound to the session. The browser cannot read it or change it. |
 | Your own `TheoremConversationStore` | Your database. |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theoremjs/web",
-  "version": "0.3.4-next.781.g97bafb5",
+  "version": "0.3.4-next.785.g899b273",
   "description": "Theorem on the web platform, with no UI framework: Web-standard server handlers that serve a profile, and the browser client that talks to them.",
   "license": "MIT",
   "type": "module",
@@ -25,6 +25,6 @@
   },
   "peerDependencies": {
     "zod": "^4.6.5",
-    "@theoremjs/agents": "^0.3.4-next.781.g97bafb5"
+    "@theoremjs/agents": "^0.3.4-next.785.g899b273"
   }
 }

package/server/conversation-store.d.ts

@@ -80,7 +80,7 @@ export interface TheoremConversationStore {
 }
 /** Refuses a ref the store does not know or cannot open: the browser reads `session.conversation_unknown`. */
 export declare function unknownConversation(cause?: unknown): TheoremError;
-/** Conversations in process memory: forgotten when idle, oldest evicted first. For one instance. */
+/** Conversations in process memory, until the limits it is given. For one instance. */
 export declare function createMemoryConversationStore(options?: Omit<MemorySessionStoreOptions, 'sessionLimits'>): TheoremConversationStore;
 export type SealedConversationStoreOptions = {
     /** Every sealing key still in use, by version: each at least 32 bytes, kept off the browser. */

package/server/conversation-store.js

@@ -49,7 +49,7 @@ export function unknownConversation(cause) {
         ...(cause === undefined ? {} : { cause }),
     });
 }
-/** Conversations in process memory: forgotten when idle, oldest evicted first. For one instance. */
+/** Conversations in process memory, until the limits it is given. For one instance. */
 export function createMemoryConversationStore(options = {}) {
     const { ttlMs, maxSessions } = memoryStoreLimits(options);
     const conversations = new Map();

package/server/session-store.d.ts

@@ -117,9 +117,9 @@ export declare function pruneGates<Gate extends {
 export type MemorySessionStoreOptions = {
     /** What it holds for one session. Unset, it holds any size. */
     capacity?: TheoremSessionCapacity;
-    /** invariant: Idle retention is in milliseconds. Protected authority remains. Default 24h. */
+    /** invariant: Idle retention is in milliseconds. Protected authority remains. Unset, nothing expires. */
     ttlMs?: number;
-    /** Oldest sessions are evicted past this count. Default 10 000. */
+    /** Oldest sessions are evicted past this count. Unset, nothing is evicted. */
     maxSessions?: number;
 };
 export declare function memoryStoreLimits(options: MemorySessionStoreOptions): {
@@ -131,7 +131,7 @@ export type PerSessionStore<T> = {
     load(sessionId: string): T | undefined | Promise<T | undefined>;
     save(sessionId: string, value: T): void | Promise<void>;
 };
-/** A per-session value kept in process memory: forgotten when idle, oldest evicted first. */
+/** A per-session value kept in process memory, until the limits it is given. */
 export declare function createMemorySessionMap<T>(options?: MemorySessionStoreOptions): {
     load(sessionId: string): T | undefined;
     save(sessionId: string, value: T): void;

package/server/session-store.js

@@ -198,19 +198,19 @@ export function pruneGates(gates, now, ttlMs) {
         : !gateExpired(gate.createdAt, now, ttlMs)));
 }
 export function memoryStoreLimits(options) {
-    const ttlMs = options.ttlMs ?? 24 * 60 * 60 * 1000;
-    const maxSessions = options.maxSessions ?? 10_000;
-    if (!Number.isFinite(ttlMs) ||
-        ttlMs <= 0 ||
-        !Number.isSafeInteger(maxSessions) ||
-        maxSessions <= 0) {
+    const { ttlMs, maxSessions } = options;
+    if ((ttlMs !== undefined && (!Number.isFinite(ttlMs) || ttlMs <= 0)) ||
+        (maxSessions !== undefined && (!Number.isSafeInteger(maxSessions) || maxSessions <= 0))) {
         throw new TheoremError('config', labelText('error.config'), {
             cause: { code: 'session_store_options', ttlMs, maxSessions },
         });
     }
-    return { ttlMs, maxSessions };
+    return {
+        ttlMs: ttlMs ?? Number.POSITIVE_INFINITY,
+        maxSessions: maxSessions ?? Number.POSITIVE_INFINITY,
+    };
 }
-/** A per-session value kept in process memory: forgotten when idle, oldest evicted first. */
+/** A per-session value kept in process memory, until the limits it is given. */
 export function createMemorySessionMap(options = {}) {
     const { ttlMs, maxSessions } = memoryStoreLimits(options);
     const sessions = new Map();