agentfootprint 9.41.0 → 9.44.0

package/dist/esm/adapters/hosting/firestoreSessions.d.ts

@@ -11,9 +11,9 @@
  * containers, one conversation" answer Google has.
  *
  * ── The shape, said plainly ─────────────────────────────────────────────────
- * One collection. One document per session. Six fields:
+ * One collection. One document per session. Seven fields:
  *
- *   sessionId · format · savedAt · envelope · owner · messageCount
+ *   sessionId · format · savedAt · envelope · owner · messageCount · expiresAt
  *
  * That is the SQLite table, moved. It is deliberately the same shape, because
  * the two stores implement the same port under the same laws, and a reader who
@@ -95,6 +95,45 @@
  * in, and names those fields rather than restating the service's message — see
  * {@link firestoreFailure} for why no Google text is ever echoed here.
  *
+ * ── Retention: a SECOND timestamp, not a converted one (9.42.0) ─────────────
+ * A native Firestore TTL policy deletes a document when a field of type
+ * **Timestamp** is in the past. `savedAt` is a NUMBER — epoch milliseconds —
+ * so until this release an operator could not point a policy at this
+ * collection at all without a library change. The fix is a second field,
+ * `expiresAt`, written as a `Date` (the client stores one as a Timestamp) on
+ * every persist, holding `savedAt + expireAfterMs`. Give the store no
+ * `expireAfterMs` and the field is written as `null`, which a TTL policy
+ * ignores, and nothing about this release changes.
+ *
+ * **`savedAt` was NOT converted, and that is the load-bearing decision.** It is
+ * the ordering key of the composite index, the field the listing sorts by, and
+ * the first half of every cursor this store has ever minted (`<savedAt>:<docId>`,
+ * parsed with `parseFloat` and handed back to `startAfter` as a number).
+ * Converting it would have meant a new index, a new cursor grammar, and every
+ * pagination token issued by an earlier release becoming unreadable — but the
+ * decisive one is quieter: **Firestore's value ordering sorts by TYPE first.**
+ * Every number sorts before every timestamp. A collection holding old
+ * number-`savedAt` documents beside new timestamp-`savedAt` ones would list
+ * them in two blocks, all of one type then all of the other, with a person's
+ * conversations silently out of order by the type of the field rather than by
+ * when they were written. A second field costs one small write per turn and
+ * has no such shadow.
+ *
+ * So the migration consequence, plainly:
+ *
+ *   • **Every document already stored stays readable and listable.** Nothing
+ *     about `savedAt`, the index, the cursor or the query changed, and a
+ *     document written by 9.33–9.41 is read by this release unchanged.
+ *   • **Old documents do not start expiring.** They carry no `expiresAt`, and
+ *     a TTL policy ignores a document whose field is missing. A conversation
+ *     that is still being used gains one on its next turn; a conversation
+ *     nobody ever writes to again keeps living. If those matter, delete them
+ *     by hand once (a query on `savedAt` plus `forget`, or a `gcloud`
+ *     bulk-delete) — this adapter will not walk your collection behind your
+ *     back.
+ *   • **The policy is still yours to create.** `retention().enableWith` prints
+ *     the exact command with your collection and database in it.
+ *
  * ── The ceiling, since a store should name its own ──────────────────────────
  * A Firestore document is capped at 1 MiB. A conversation whose stored envelope
  * approaches that is refused BY NAME before the write
@@ -122,8 +161,29 @@
  * for it. So the write is a transaction.
  *
  * ── How much of this is verified ────────────────────────────────────────────
- * **Contract-shaped and tested. NOT field-validated.** Nothing here has been run
- * against a live Firestore by this repository.
+ * **Field-validated except the ownership refusal (2026-08).** An independent
+ * field trial ran THIS adapter against a real Firestore and exercised seven of
+ * its eight areas live: the round trip, the server-side indexed listing with
+ * its document-name tiebreak and real cursor, the missing-index refusal, the
+ * hashed document name, the size ceiling, ownership derived from the envelope,
+ * and `forget`.
+ *
+ * The eighth is named because under-claiming and over-claiming are the same
+ * defect: **the refusal of a turn signed by somebody else** — the
+ * `resolveSessionOwner` conflict this file's `persist` raises out of the
+ * transaction — was NOT exercised, because it did not exist when the trial
+ * ran. It is held by tests here, including the contested-write case of the
+ * shared conformance battery, and by nothing in the field. Two writers racing
+ * for one fresh session against a real Firestore, with the real client's
+ * transaction retry underneath, is exactly the shape a double models by
+ * assumption; the sibling Vertex adapter's equivalent was found in the field
+ * and not in a test suite.
+ *
+ * This section said "NOT field-validated. Nothing here has been run against a
+ * live Firestore" for two releases after that stopped being true. Under-claiming
+ * is the safe direction and it is still the same defect class the trials keep
+ * reporting: a status that does not track the evidence is a status nobody can
+ * use, whichever way it is wrong.
  *
  * The pin is the `firestoreSessions` row of `GOOGLE_SURFACE_PINS` in
  * `test/adapters/google/googlePin.ts`, asserted by
@@ -148,7 +208,8 @@
  * everywhere. That the row spells those members the way Google does is held by a
  * hand check against a real install, not by a test that runs here.
  *
- * The DESIGN is informed by an independent field trial of a different Firestore
+ * The DESIGN was informed, before any of that, by an EARLIER and separate trial
+ * of a DIFFERENT Firestore
  * session adapter, which ran against a real Firestore and passed eight ownership
  * and history checks — and whose own report named the defect this adapter does
  * not reproduce: that adapter read every document for one owner, sorted them in
@@ -158,7 +219,7 @@
  * real service; it proves nothing about this file's query, cursor, transaction
  * or index, because that adapter had none of them.
  */
-import type { SessionLifecycle } from '../../hosting/types.js';
+import type { SessionExpiryPolicy, SessionLifecycle } from '../../hosting/types.js';
 /** One document as it came back. `firestore.d.ts` line 1605. */
 export interface FirestoreDocumentSnapshotLike {
     /** A PROPERTY, not a method — `readonly exists: boolean`. */
@@ -282,6 +343,39 @@ export interface FirestoreSessionsOptions {
      * still loading the module?" is a fair question to have answered here.
      */
     readonly firestore?: FirestoreLike;
+    /**
+     * How long after its last turn a conversation should expire, in
+     * milliseconds. Omit and nothing expires (9.42.0).
+     *
+     * Setting it makes every write stamp {@link EXPIRES_AT_FIELD} —
+     * `savedAt + expireAfterMs`, as a timestamp — which is the field a **native
+     * Firestore TTL policy** reads. The policy itself is yours to enable, once,
+     * with the command {@link FirestoreSessions.retention} hands you; this store
+     * writes what it reads and never deletes a document on a clock of its own.
+     * Both halves are needed and neither is silent about the other: with no
+     * policy the field is inert data, and with no `expireAfterMs` the policy has
+     * nothing to act on.
+     *
+     * **The clock is the conversation's own `savedAt`, not this process's.** So
+     * the expiry is IDLE time: every turn pushes it out, and a conversation dies
+     * `expireAfterMs` after somebody last spoke, which is what a session
+     * retention rule almost always means. It also makes the stamp a pure
+     * function of the envelope — the same conversation stamps the same instant
+     * on any machine, whatever its clock says.
+     *
+     * **It does not reach backwards.** Documents written before this was
+     * configured carry no expiry field, and a TTL policy ignores a document
+     * whose field is missing — so old conversations expire only once they are
+     * written again. See the module header for what to do about the ones that
+     * never will be.
+     *
+     * Named `expireAfterMs` rather than `ttlMs` deliberately, even though the
+     * artifact stores in this package spell their dial the second way: theirs is
+     * stamped once at mint and measured from creation, and this one is measured
+     * from the LAST turn and moves on every write. One word for two clocks would
+     * be the cheaper name and the more expensive mistake.
+     */
+    readonly expireAfterMs?: number;
     /**
      * @internal Test seam only — the `@google-cloud/firestore` module, injected.
      * Lets the suite exercise every path (including the refusals) without a
@@ -292,6 +386,34 @@ export interface FirestoreSessionsOptions {
 }
 /** Where sessions live when the caller names no collection. */
 export declare const DEFAULT_SESSION_COLLECTION = "agentfootprint_sessions";
+/**
+ * The document field a native TTL policy is configured against (9.42.0).
+ *
+ * A SECOND field beside `savedAt`, never a change to it — see the module
+ * header for why converting the ordering key would have re-sorted every
+ * conversation already in the collection.
+ *
+ * Exported because an operator has to type this name into the console or the
+ * `gcloud` line, and a field name that lives only inside a string literal is a
+ * field name somebody will mistype at 2am.
+ */
+export declare const EXPIRES_AT_FIELD = "expiresAt";
+/**
+ * The one step that turns the TTL policy on, with this store's own collection
+ * and database already in it.
+ *
+ * One spelling, shared by the retention answer and the documentation that
+ * quotes it, for the same reason the missing-index refusal prints the whole
+ * `gcloud` line: the person reading it can fix this in sixty seconds, and only
+ * if nobody makes them go and look up the flags first.
+ *
+ * `--database` is always printed, including for `(default)`, where gcloud
+ * would have assumed it — a project may hold several databases, and a policy
+ * created on the wrong one leaves conversations living forever with nothing to
+ * suggest why. Single-quoted, because `(default)` is bare parentheses and a
+ * syntax error in every shell this will be pasted into.
+ */
+export declare function ttlPolicyCommand(collection: string, database?: string): string;
 /**
  * Firestore's hard ceiling on one document, in bytes. Not ours — the service's.
  *
@@ -321,6 +443,21 @@ export interface FirestoreSessions extends SessionLifecycle {
     readonly collection: string;
     /** Forget one session. A session that was never there is not an error. */
     forget(sessionId: string): Promise<void>;
+    /**
+     * How conversations here stop existing: **the backend does it**, on a native
+     * TTL policy an operator enables once, against {@link EXPIRES_AT_FIELD}
+     * (9.42.0).
+     *
+     * Narrowed from the port's optional member to a required one, and to the one
+     * arm this store can be: a caller holding a `FirestoreSessions` needs no
+     * feature check and no branch, and gets a compile error rather than a
+     * runtime surprise if they reach for a sweep that does not exist here.
+     *
+     * `active` says whether this store was built with `expireAfterMs` and is
+     * therefore stamping anything; `enableWith` is the exact command, with this
+     * store's collection and database already filled in.
+     */
+    retention(): SessionExpiryPolicy;
     /**
      * The document name one session id maps to — the sha-256 above.
      *
@@ -401,20 +538,31 @@ export declare class EnvelopeTooLargeError extends Error {
  * Conversations in Firestore — a fleet-shared session store with no instance to
  * run.
  *
- * **Status: contract-shaped and tested, NOT field-validated.** Every SDK member
- * it calls was read off a real install of `@google-cloud/firestore` 9.0.0 and
- * hand-verified there; the test that re-checks those names against the real
- * package SKIPS in this repository, because the package is deliberately not
- * installed here. What runs in CI is the dispatch pin. No test here pretends to
- * have reached Google. See the module header for the full account, and for what
- * a field trial of a DIFFERENT adapter did and did not establish about this
- * design.
+ * **Status: field-validated except the ownership refusal (2026-08).** An
+ * independent field trial ran this adapter against a real Firestore and
+ * exercised seven of its eight areas live — round trip, indexed and cursored
+ * listing, the missing-index refusal, the hashed document name, the size
+ * ceiling, derived ownership and `forget`. The eighth, the refusal of a turn
+ * signed by somebody ELSE, was added after the trial and is held by tests
+ * here and by nothing in the field. Every SDK member it calls was read off a
+ * real install of `@google-cloud/firestore` 9.0.0 and hand-verified there; the
+ * test that re-checks those names against the real package SKIPS in this
+ * repository, because the package is deliberately not installed here. What
+ * runs in CI is the dispatch pin. See the module header for the full account.
  *
  * @throws FirestoreIndexMissingError from `listByUser` until the composite index
  *   exists — see the module header for the exact index.
  * @throws EnvelopeTooLargeError from `persist` for a conversation above
  *   {@link FIRESTORE_MAX_ENVELOPE_BYTES}. Never truncated.
  *
+ * @example  Conversations that expire 30 days after their last turn
+ *   const sessions = firestoreSessions({
+ *     project: 'my-project',
+ *     expireAfterMs: 30 * 24 * 60 * 60 * 1000,
+ *   });
+ *   // Then, ONCE, as an operator — the store prints the exact command:
+ *   console.log(sessions.retention().enableWith);
+ *
  * @example  A standing agent whose conversations are shared across instances
  *   import { standingAgent, nodeHost } from 'agentfootprint/hosting';
  *   import { firestoreSessions } from 'agentfootprint/hosting';

package/dist/esm/adapters/hosting/firestoreSessions.js

@@ -11,9 +11,9 @@
  * containers, one conversation" answer Google has.
  *
  * ── The shape, said plainly ─────────────────────────────────────────────────
- * One collection. One document per session. Six fields:
+ * One collection. One document per session. Seven fields:
  *
- *   sessionId · format · savedAt · envelope · owner · messageCount
+ *   sessionId · format · savedAt · envelope · owner · messageCount · expiresAt
  *
  * That is the SQLite table, moved. It is deliberately the same shape, because
  * the two stores implement the same port under the same laws, and a reader who
@@ -95,6 +95,45 @@
  * in, and names those fields rather than restating the service's message — see
  * {@link firestoreFailure} for why no Google text is ever echoed here.
  *
+ * ── Retention: a SECOND timestamp, not a converted one (9.42.0) ─────────────
+ * A native Firestore TTL policy deletes a document when a field of type
+ * **Timestamp** is in the past. `savedAt` is a NUMBER — epoch milliseconds —
+ * so until this release an operator could not point a policy at this
+ * collection at all without a library change. The fix is a second field,
+ * `expiresAt`, written as a `Date` (the client stores one as a Timestamp) on
+ * every persist, holding `savedAt + expireAfterMs`. Give the store no
+ * `expireAfterMs` and the field is written as `null`, which a TTL policy
+ * ignores, and nothing about this release changes.
+ *
+ * **`savedAt` was NOT converted, and that is the load-bearing decision.** It is
+ * the ordering key of the composite index, the field the listing sorts by, and
+ * the first half of every cursor this store has ever minted (`<savedAt>:<docId>`,
+ * parsed with `parseFloat` and handed back to `startAfter` as a number).
+ * Converting it would have meant a new index, a new cursor grammar, and every
+ * pagination token issued by an earlier release becoming unreadable — but the
+ * decisive one is quieter: **Firestore's value ordering sorts by TYPE first.**
+ * Every number sorts before every timestamp. A collection holding old
+ * number-`savedAt` documents beside new timestamp-`savedAt` ones would list
+ * them in two blocks, all of one type then all of the other, with a person's
+ * conversations silently out of order by the type of the field rather than by
+ * when they were written. A second field costs one small write per turn and
+ * has no such shadow.
+ *
+ * So the migration consequence, plainly:
+ *
+ *   • **Every document already stored stays readable and listable.** Nothing
+ *     about `savedAt`, the index, the cursor or the query changed, and a
+ *     document written by 9.33–9.41 is read by this release unchanged.
+ *   • **Old documents do not start expiring.** They carry no `expiresAt`, and
+ *     a TTL policy ignores a document whose field is missing. A conversation
+ *     that is still being used gains one on its next turn; a conversation
+ *     nobody ever writes to again keeps living. If those matter, delete them
+ *     by hand once (a query on `savedAt` plus `forget`, or a `gcloud`
+ *     bulk-delete) — this adapter will not walk your collection behind your
+ *     back.
+ *   • **The policy is still yours to create.** `retention().enableWith` prints
+ *     the exact command with your collection and database in it.
+ *
  * ── The ceiling, since a store should name its own ──────────────────────────
  * A Firestore document is capped at 1 MiB. A conversation whose stored envelope
  * approaches that is refused BY NAME before the write
@@ -122,8 +161,29 @@
  * for it. So the write is a transaction.
  *
  * ── How much of this is verified ────────────────────────────────────────────
- * **Contract-shaped and tested. NOT field-validated.** Nothing here has been run
- * against a live Firestore by this repository.
+ * **Field-validated except the ownership refusal (2026-08).** An independent
+ * field trial ran THIS adapter against a real Firestore and exercised seven of
+ * its eight areas live: the round trip, the server-side indexed listing with
+ * its document-name tiebreak and real cursor, the missing-index refusal, the
+ * hashed document name, the size ceiling, ownership derived from the envelope,
+ * and `forget`.
+ *
+ * The eighth is named because under-claiming and over-claiming are the same
+ * defect: **the refusal of a turn signed by somebody else** — the
+ * `resolveSessionOwner` conflict this file's `persist` raises out of the
+ * transaction — was NOT exercised, because it did not exist when the trial
+ * ran. It is held by tests here, including the contested-write case of the
+ * shared conformance battery, and by nothing in the field. Two writers racing
+ * for one fresh session against a real Firestore, with the real client's
+ * transaction retry underneath, is exactly the shape a double models by
+ * assumption; the sibling Vertex adapter's equivalent was found in the field
+ * and not in a test suite.
+ *
+ * This section said "NOT field-validated. Nothing here has been run against a
+ * live Firestore" for two releases after that stopped being true. Under-claiming
+ * is the safe direction and it is still the same defect class the trials keep
+ * reporting: a status that does not track the evidence is a status nobody can
+ * use, whichever way it is wrong.
  *
  * The pin is the `firestoreSessions` row of `GOOGLE_SURFACE_PINS` in
  * `test/adapters/google/googlePin.ts`, asserted by
@@ -148,7 +208,8 @@
  * everywhere. That the row spells those members the way Google does is held by a
  * hand check against a real install, not by a test that runs here.
  *
- * The DESIGN is informed by an independent field trial of a different Firestore
+ * The DESIGN was informed, before any of that, by an EARLIER and separate trial
+ * of a DIFFERENT Firestore
  * session adapter, which ran against a real Firestore and passed eight ownership
  * and history checks — and whose own report named the defect this adapter does
  * not reproduce: that adapter read every document for one owner, sorted them in
@@ -166,6 +227,42 @@ import { lazyRequire } from '../../lib/lazyRequire.js';
 const ADAPTER = 'firestoreSessions';
 /** Where sessions live when the caller names no collection. */
 export const DEFAULT_SESSION_COLLECTION = 'agentfootprint_sessions';
+/**
+ * The document field a native TTL policy is configured against (9.42.0).
+ *
+ * A SECOND field beside `savedAt`, never a change to it — see the module
+ * header for why converting the ordering key would have re-sorted every
+ * conversation already in the collection.
+ *
+ * Exported because an operator has to type this name into the console or the
+ * `gcloud` line, and a field name that lives only inside a string literal is a
+ * field name somebody will mistype at 2am.
+ */
+export const EXPIRES_AT_FIELD = 'expiresAt';
+/**
+ * The one step that turns the TTL policy on, with this store's own collection
+ * and database already in it.
+ *
+ * One spelling, shared by the retention answer and the documentation that
+ * quotes it, for the same reason the missing-index refusal prints the whole
+ * `gcloud` line: the person reading it can fix this in sixty seconds, and only
+ * if nobody makes them go and look up the flags first.
+ *
+ * `--database` is always printed, including for `(default)`, where gcloud
+ * would have assumed it — a project may hold several databases, and a policy
+ * created on the wrong one leaves conversations living forever with nothing to
+ * suggest why. Single-quoted, because `(default)` is bare parentheses and a
+ * syntax error in every shell this will be pasted into.
+ */
+export function ttlPolicyCommand(collection, database) {
+    const flagValue = `'${database ?? '<the database your Firestore client was built for>'}'`;
+    return (`gcloud firestore fields ttls update ${EXPIRES_AT_FIELD} ` +
+        `--collection-group=${collection} --enable-ttl --database=${flagValue}` +
+        (database === undefined
+            ? ` (this store did not build the Firestore client, so it cannot name the database — ` +
+                `fill that flag in from wherever the client was constructed)`
+            : ``));
+}
 /** How many rows one `listByUser` page carries when the caller names no limit. */
 const DEFAULT_PAGE = 50;
 /**
@@ -294,20 +391,31 @@ export class EnvelopeTooLargeError extends Error {
  * Conversations in Firestore — a fleet-shared session store with no instance to
  * run.
  *
- * **Status: contract-shaped and tested, NOT field-validated.** Every SDK member
- * it calls was read off a real install of `@google-cloud/firestore` 9.0.0 and
- * hand-verified there; the test that re-checks those names against the real
- * package SKIPS in this repository, because the package is deliberately not
- * installed here. What runs in CI is the dispatch pin. No test here pretends to
- * have reached Google. See the module header for the full account, and for what
- * a field trial of a DIFFERENT adapter did and did not establish about this
- * design.
+ * **Status: field-validated except the ownership refusal (2026-08).** An
+ * independent field trial ran this adapter against a real Firestore and
+ * exercised seven of its eight areas live — round trip, indexed and cursored
+ * listing, the missing-index refusal, the hashed document name, the size
+ * ceiling, derived ownership and `forget`. The eighth, the refusal of a turn
+ * signed by somebody ELSE, was added after the trial and is held by tests
+ * here and by nothing in the field. Every SDK member it calls was read off a
+ * real install of `@google-cloud/firestore` 9.0.0 and hand-verified there; the
+ * test that re-checks those names against the real package SKIPS in this
+ * repository, because the package is deliberately not installed here. What
+ * runs in CI is the dispatch pin. See the module header for the full account.
  *
  * @throws FirestoreIndexMissingError from `listByUser` until the composite index
  *   exists — see the module header for the exact index.
  * @throws EnvelopeTooLargeError from `persist` for a conversation above
  *   {@link FIRESTORE_MAX_ENVELOPE_BYTES}. Never truncated.
  *
+ * @example  Conversations that expire 30 days after their last turn
+ *   const sessions = firestoreSessions({
+ *     project: 'my-project',
+ *     expireAfterMs: 30 * 24 * 60 * 60 * 1000,
+ *   });
+ *   // Then, ONCE, as an operator — the store prints the exact command:
+ *   console.log(sessions.retention().enableWith);
+ *
  * @example  A standing agent whose conversations are shared across instances
  *   import { standingAgent, nodeHost } from 'agentfootprint/hosting';
  *   import { firestoreSessions } from 'agentfootprint/hosting';
@@ -359,6 +467,16 @@ export function firestoreSessions(options = {}) {
     };
     const collection = () => db.collection(collectionName);
     const docFor = (sessionId) => collection().doc(documentIdFor(sessionId));
+    /**
+     * When this conversation should expire, or `null` for a store that was not
+     * given a retention setting.
+     *
+     * Idle expiry, measured from the envelope's own `savedAt`: every turn moves
+     * it, so a live conversation never expires underneath somebody.
+     */
+    const expiresAtFor = (savedAt) => options.expireAfterMs === undefined || !Number.isFinite(options.expireAfterMs)
+        ? null
+        : new Date(savedAt + options.expireAfterMs);
     /** The stored row, read back without trusting any of its types. */
     const readRow = async (sessionId, operation) => {
         let snapshot;
@@ -423,6 +541,27 @@ export function firestoreSessions(options = {}) {
                 savedAt: checked.savedAt,
                 envelope: json,
                 messageCount: envelopeTranscript(checked).length,
+                // The TTL field (9.42.0) — a SECOND field, never a change to
+                // `savedAt`. See the module header: `savedAt` is the ordering key of
+                // the composite index and the first half of every cursor this store
+                // has ever minted, and Firestore sorts values by TYPE before value, so
+                // making it a timestamp would have put every document written from now
+                // on into a different sort bucket from every document already stored.
+                //
+                // A `Date`, which the client converts to a Timestamp on write — and a
+                // TTL policy acts only on a Timestamp. Writing one this way rather
+                // than through `Timestamp.fromMillis` is deliberate: it adds no member
+                // to the SDK surface this adapter dispatches (so the pin row is
+                // unchanged and no new name had to be hand-verified against a real
+                // install), and it works identically for a caller who passed their own
+                // client.
+                //
+                // `null` when nothing was configured, never `undefined`: the default
+                // client throws on `undefined`, and a TTL policy ignores a field that
+                // is null or missing — so an unconfigured store writes an inert field
+                // rather than an absent one, exactly as `owner` does one line down and
+                // for the same reason.
+                [EXPIRES_AT_FIELD]: expiresAtFor(checked.savedAt),
             };
             // WRITE ONCE for the owner, LAST WRITE WINS for everything else — the one
             // rule every store in this package shares, and since 9.36.1 the one
@@ -602,6 +741,36 @@ export function firestoreSessions(options = {}) {
                 throw firestoreFailure('forgetting a session', collectionName, err);
             }
         },
+        // ── Retention (9.42.0) ──────────────────────────────────────────────
+        //
+        // `'the-backend'`, and the honest answer rather than the convenient one.
+        // This store COULD have offered a sweep — query the old documents, delete
+        // them one at a time — and it would have been a worse answer at every
+        // scale: a full index read plus one write per document, billed, repeated
+        // nightly, to do a job the service already does for free and does not
+        // charge a delete for. A port member exists so a caller can find out what
+        // a store really does; a store that implemented the OTHER arm because it
+        // was implementable would be answering a different question.
+        //
+        // It works on a closed store on purpose — it reads no document and calls
+        // no SDK member. An operator asking "what expires these, and how do I turn
+        // it on?" during a shutdown or an incident should get the answer, not the
+        // refusal that guards the data plane.
+        retention: () => ({
+            deletedBy: 'the-backend',
+            // Whether this store is really stamping the field, which is a different
+            // fact from whether the mechanism exists. Reported rather than implied:
+            // "there is a TTL field" and "conversations are expiring" are the two
+            // things an auditor must not be allowed to confuse.
+            active: options.expireAfterMs !== undefined && Number.isFinite(options.expireAfterMs),
+            expiresOn: EXPIRES_AT_FIELD,
+            enableWith: `${ttlPolicyCommand(collectionName, databaseName)} — or Firestore console → ` +
+                `Time-to-live (TTL) → Create policy, on collection '${collectionName}' and field ` +
+                `'${EXPIRES_AT_FIELD}'. The policy deletes a document within 24 hours of the ` +
+                `instant in that field; it is not a hard deadline and the service says so. ` +
+                `Documents stored before 'expireAfterMs' was configured carry no such field and ` +
+                `are never deleted by it — they expire only once they are written again.`,
+        }),
         async close() {
             if (closed)
                 return;

package/dist/esm/adapters/hosting/firestoreSessions.js.map

@@ -1 +1 @@
-{"version":3,"file":"firestoreSessions.js","sourceRoot":"","sources":["../../../../src/adapters/hosting/firestoreSessions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"firestoreSessions.js","sourceRoot":"","sources":["../../../../src/adapters/hosting/firestoreSessions.ts"],"names":[],"mappings":"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"}

package/dist/esm/adapters/hosting/googleAgentEngine.d.ts

@@ -100,7 +100,7 @@
  * be read must never be answered with a fresh start — that failure is
  * indistinguishable, from the outside, from a brand-new user.
  */
-import type { CheckpointEnvelope, SessionLifecycle } from '../../hosting/types.js';
+import type { CheckpointEnvelope, SessionExpiryPolicy, SessionLifecycle } from '../../hosting/types.js';
 import { type AiPlatformConnection } from '../google/aiPlatform.js';
 /**
  * The `sessionState` key the envelope lives under.
@@ -195,6 +195,21 @@ export interface AgentEngineSessions extends SessionLifecycle {
     readonly parent: string;
     /** Forget one session. A session that was never there is not an error. */
     forget(sessionId: string): Promise<void>;
+    /**
+     * How conversations here stop existing: **the service does it**, on the
+     * `ttl` this store was built with (9.42.0).
+     *
+     * Narrowed from the port's optional member to a required one, and to the one
+     * arm this store can be — a caller holding an `AgentEngineSessions` needs no
+     * feature check, and reaching for a sweep that does not exist here is a
+     * compile error rather than a surprise at 3am.
+     *
+     * There is nothing to call and nothing for a cron job to do. `active` says
+     * whether a `ttl` was given at all; `enableWith` says what to pass and
+     * repeats the two facts a caller has to plan around — the service's 24-hour
+     * floor, and that the value is sent on CREATE only.
+     */
+    retention(): SessionExpiryPolicy;
     /**
      * Stop using this store. Idempotent, and **final** — reading or writing
      * afterwards refuses by name rather than quietly reconnecting, because a