@abloatai/transaction 0.57.0 → 0.58.0

package/dist/transport/http/subscription.js

@@ -0,0 +1,146 @@
+import { AbloStaleContextError, translateHttpError, } from '../../errors.js';
+const INITIAL_RECONNECT_CAP_MS = 5_000;
+const MAX_RECONNECT_DELAY_MS = 30_000;
+/** POST the existing reads and consume one `stale_context` SSE event. */
+export function createHttpReadOnChange(deps) {
+    return (reads, listener) => {
+        if (reads.length === 0)
+            return () => undefined;
+        const controller = new AbortController();
+        deps.register(controller);
+        let stopped = false;
+        const stop = () => {
+            if (stopped)
+                return;
+            stopped = true;
+            controller.abort();
+            deps.unregister(controller);
+        };
+        void (async () => {
+            let failures = 0;
+            while (!stopped) {
+                try {
+                    await deps.prepare();
+                    const response = await deps.fetch(deps.endpoint(), {
+                        method: 'POST',
+                        headers: {
+                            ...(await deps.authHeaders()),
+                            Accept: 'text/event-stream',
+                            'Cache-Control': 'no-cache',
+                            'Content-Type': 'application/json',
+                        },
+                        body: JSON.stringify({ reads }),
+                        signal: controller.signal,
+                    });
+                    if (!response.ok) {
+                        const body = await parseResponseBody(response);
+                        throw translateHttpError(response.status, body, response.headers.get('x-request-id') ?? undefined);
+                    }
+                    failures = 0;
+                    const stale = await readStaleContextEvent(response);
+                    if (stale) {
+                        stop();
+                        listener(stale);
+                        return;
+                    }
+                }
+                catch (error) {
+                    if (stopped || controller.signal.aborted)
+                        return;
+                    void error;
+                }
+                failures += 1;
+                await abortableDelay(reconnectDelayMs(failures), controller.signal);
+            }
+        })().finally(() => deps.unregister(controller));
+        return stop;
+    };
+}
+/** Full-jitter reconnect delay; exported only for transport unit tests. */
+export function reconnectDelayMs(failures, random = Math.random) {
+    const cap = Math.min(MAX_RECONNECT_DELAY_MS, INITIAL_RECONNECT_CAP_MS * 2 ** Math.max(0, failures - 1));
+    return random() * cap;
+}
+async function parseResponseBody(response) {
+    const text = await response.text();
+    if (text === '')
+        return null;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+async function readStaleContextEvent(response) {
+    if (!response.body)
+        return undefined;
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = '';
+    while (true) {
+        const { value, done } = await reader.read();
+        buffer += decoder.decode(value, { stream: !done });
+        let boundary = eventBoundary(buffer);
+        while (boundary) {
+            const block = buffer.slice(0, boundary.index);
+            buffer = buffer.slice(boundary.index + boundary.length);
+            const parsed = parseEventBlock(block);
+            if (parsed?.event === 'stale_context') {
+                let body;
+                try {
+                    body = JSON.parse(parsed.data);
+                }
+                catch {
+                    body = parsed.data;
+                }
+                const error = translateHttpError(409, body);
+                return error instanceof AbloStaleContextError
+                    ? error
+                    : new AbloStaleContextError(error.message, {
+                        code: 'stale_context',
+                        cause: error,
+                    });
+            }
+            boundary = eventBoundary(buffer);
+        }
+        if (done)
+            return undefined;
+    }
+}
+function eventBoundary(value) {
+    const match = /\r?\n\r?\n/.exec(value);
+    return match ? { index: match.index, length: match[0].length } : undefined;
+}
+function parseEventBlock(block) {
+    let event = 'message';
+    const data = [];
+    for (const line of block.split(/\r?\n/)) {
+        if (line.startsWith(':'))
+            continue;
+        const separator = line.indexOf(':');
+        const field = separator < 0 ? line : line.slice(0, separator);
+        let value = separator < 0 ? '' : line.slice(separator + 1);
+        if (value.startsWith(' '))
+            value = value.slice(1);
+        if (field === 'event')
+            event = value;
+        if (field === 'data')
+            data.push(value);
+    }
+    return data.length > 0 ? { event, data: data.join('\n') } : undefined;
+}
+async function abortableDelay(ms, signal) {
+    if (signal.aborted)
+        return;
+    await new Promise((resolve) => {
+        const timer = setTimeout(done, ms);
+        signal.addEventListener('abort', done, { once: true });
+        function done() {
+            clearTimeout(timer);
+            signal.removeEventListener('abort', done);
+            resolve();
+        }
+    });
+}
+//# sourceMappingURL=subscription.js.map

package/dist/transport/http/subscription.js.map

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

package/dist/transport/{httpTransport.d.ts → http/transport.d.ts}

@@ -5,11 +5,12 @@
  * facade in `httpClient.ts` is the application boundary; this module owns
  * transport envelopes, watermarks, replay, and route details.
  */
-import type { HttpClientConfig } from './httpOptions.js';
-import type { CommitResource, HttpClaimsResource, HttpTransportModel, HttpLogsResource, SessionResource } from '../resources/httpResources.js';
-import type { EffectiveAuthority } from '../auth/capability.js';
-import type { SchemaRecord } from '../schema/schema.js';
-import type { CoordinationObservability } from '../observability.js';
+import type { HttpClientConfig } from './options.js';
+import type { CommitResource, HttpClaimsResource, HttpTransportModel, HttpLogsResource, SessionResource } from '../../client/resources/httpResources.js';
+import type { EffectiveAuthority } from '../../auth/capability.js';
+import type { SchemaRecord } from '../../schema/schema.js';
+import type { CoordinationObservability } from '../../observability.js';
+import { type HttpReadOnChange } from './subscription.js';
 /** @internal Private options for the schema-agnostic HTTP protocol transport. */
 export type HttpTransportOptions = Omit<HttpClientConfig, 'schema'> & {
     readonly bootstrapBaseUrl?: string | undefined;
@@ -41,6 +42,8 @@ export interface HttpTransport {
     /** Drains scheduled commits and active requests. */
     dispose(): Promise<void>;
     purge(): Promise<void>;
+    /** @internal Live check used only by `context().onChange`. */
+    readonly onChange: HttpReadOnChange;
     readonly commits: CommitResource;
     /**
      * Claim-ticket operations keyed by `claimId` — the id a queued acquire
@@ -69,4 +72,4 @@ export interface HttpTransport {
 }
 /** @internal Constructed only by the typed HTTP facade. */
 export declare function createHttpTransport(options: HttpTransportOptions): HttpTransport;
-//# sourceMappingURL=httpTransport.d.ts.map
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport/http/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/transport/http/transport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAKV,cAAc,EAGd,kBAAkB,EAClB,kBAAkB,EAMlB,gBAAgB,EAIhB,eAAe,EAChB,MAAM,yCAAyC,CAAC;AAOjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAOnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAqC3D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AA4BxE,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAElF,iFAAiF;AACjF,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,GAAG;IACpE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,iFAAiF;IACjF,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IACvE;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,yBAAyB,CAAC;IACnD;;;;;;;;OAQG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAMjD,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,oDAAoD;IACpD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC7C,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,EAC3C,IAAI,EAAE,MAAM,GACX,kBAAkB,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACjC;;;;;;OAMG;IACH,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACvC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;CAClD;AAID,2DAA2D;AAC3D,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CA83DhF"}

package/dist/transport/{httpTransport.js → http/transport.js}

@@ -5,38 +5,34 @@
  * facade in `httpClient.ts` is the application boundary; this module owns
  * transport envelopes, watermarks, replay, and route details.
  */
-import { AbloClaimedError, AbloError, AbloAuthenticationError, AbloConnectionError, AbloIdempotencyError, AbloValidationError, AbloNotFoundError, claimedError, translateHttpError, } from '../errors.js';
-import { reconcileFunctionalUpdate, } from '../resources/functionalUpdate.js';
-import { assertBrowserSafety, readProcessEnv, resolveApiKey, resolveApiKeyValue, resolveAuthToken, resolveBaseURL, resolveBootstrapBaseUrl, rejectRemovedDatabaseUrlOption, warnIfCliKeyMismatch, } from '../auth/apiKey.js';
-import { PROTOCOL_VERSION, PROTOCOL_VERSION_HEADER } from '../wire/protocolVersion.js';
-import { commitRecordSchema, commitRecordListSchema, commitRecordListOptionsSchema, commitRecordWhereSchema, } from '../wire/commit.js';
-import { logListResponseSchema } from '../wire/feedEvent.js';
-import { claimAcquireResponseSchema, claimHeartbeatBatchReplySchema, claimHeartbeatReplySchema, claimListResponseSchema, claimStateSchema, } from '../wire/claims.js';
-import { modelListResponseSchema, modelReadResponseSchema, } from '../wire/modelResponses.js';
-import { toMs } from '../utils/duration.js';
-import { heartbeatCadenceMs, resolveHeartbeatOptions, resolveHeartbeatPlan, startClaimHeartbeatLoop, } from '../coordination/claimHeartbeatLoop.js';
-import { mintSession } from '../auth/sessionMint.js';
-import { revokeCapability, rotateCapability, } from '../auth/capabilityLifecycle.js';
-import { parseIdentityResolveResponse } from '../auth/schemas.js';
-import { claimFromModelClaim, heldHeartbeatReply, parseSuccessfulCommitResponse, } from './httpTransportHelpers.js';
-import { claimAttemptFailure, claimQueueView, emitClaimStatus, resolveClaimContentionOptions, } from '../resources/modelOperations.js';
-import { claimDescription } from '../coordination/schema.js';
-import { subTarget, streamTarget, batchFence, } from '../coordination/locator.js';
-import { declaredMeta, wireMeta } from '../coordination/claimMeta.js';
-import { assertWriteOptions, assertWriteTarget, } from '../resources/writeOptionsSchema.js';
-import { createModelId, resolveCreatedRows, resolveCreateId, } from '../resources/modelCreate.js';
-import { normalizeWhere } from '../resources/where.js';
-import { createDurableHttpCommitEnvelope, canonicalHttpCommitBody, durableHttpCommitEnvelopeSchema, httpCommitEnvelopeRecordId, isHttpCommitReplayExpired, } from '../transactions/confirmation/httpCommitEnvelope.js';
-import { createClientTxId, normalizeCommitOperations, replicationLagTimeout, } from './httpCommitRequest.js';
-import { resolveDurableWrites } from '../durableWrites.js';
+import { AbloClaimedError, AbloError, AbloAuthenticationError, AbloConnectionError, AbloIdempotencyError, AbloValidationError, AbloNotFoundError, claimedError, translateHttpError, } from '../../errors.js';
+import { reconcileFunctionalUpdate, } from '../../client/resources/functionalUpdate.js';
+import { assertBrowserSafety, readProcessEnv, resolveApiKey, resolveApiKeyValue, resolveAuthToken, resolveBaseURL, resolveBootstrapBaseUrl, rejectRemovedDatabaseUrlOption, warnIfCliKeyMismatch, } from '../../auth/apiKey.js';
+import { PROTOCOL_VERSION, PROTOCOL_VERSION_HEADER } from '../../wire/protocolVersion.js';
+import { commitRecordSchema, commitRecordListSchema, commitRecordListOptionsSchema, commitRecordWhereSchema, } from '../../commit/contract.js';
+import { logListResponseSchema } from '../../observation/feedContract.js';
+import { claimAcquireResponseSchema, claimHeartbeatBatchReplySchema, claimHeartbeatReplySchema, claimListResponseSchema, claimStateSchema, DEFAULT_CLAIM_TTL_MS, } from '../../claims/contract.js';
+import { modelListResponseSchema, modelReadResponseSchema, } from '../../wire/modelResponses.js';
+import { toMs } from '../../utils/duration.js';
+import { heartbeatCadenceMs, resolveHeartbeatOptions, resolveHeartbeatPlan, startClaimHeartbeatLoop, } from '../../claims/heartbeat.js';
+import { mintSession } from '../../auth/sessionMint.js';
+import { revokeCapability, rotateCapability, } from '../../auth/capabilityLifecycle.js';
+import { parseIdentityResolveResponse } from '../../auth/schemas.js';
+import { claimFromModelClaim, heldHeartbeatReply, parseSuccessfulCommitResponse, } from './helpers.js';
+import { claimAttemptFailure, claimQueueView, emitClaimStatus, resolveClaimContentionOptions, } from '../../client/resources/modelOperations.js';
+import { claimDescription } from '../../coordination/schema.js';
+import { subTarget, streamTarget, batchFence, } from '../../claims/locator.js';
+import { declaredMeta, wireMeta } from '../../claims/meta.js';
+import { assertWriteOptions, assertWriteTarget, } from '../../client/resources/writeOptionsSchema.js';
+import { createModelId, resolveCreatedRows, resolveCreateId, } from '../../client/resources/modelCreate.js';
+import { normalizeWhere } from '../../client/resources/where.js';
+import { createDurableHttpCommitEnvelope, canonicalHttpCommitBody, durableHttpCommitEnvelopeSchema, httpCommitEnvelopeRecordId, isHttpCommitReplayExpired, } from '../../commit/confirmation/httpCommitEnvelope.js';
+import { createClientTxId, normalizeCommitOperations, replicationLagTimeout, } from '../../commit/httpRequest.js';
+import { resolveDurableWrites } from '../../commit/durableWrites.js';
+import { createHttpReadOnChange } from './subscription.js';
 /** @internal Default per-request deadline for the private HTTP transport. */
 export const DEFAULT_REQUEST_TIMEOUT_MS = 30_000;
 const HTTP_CONFIRMATION_POLL_INTERVAL_MS = 250;
-/**
- * The server's acquire window, mirrored here as the client-side default for a
- * claim that names no `ttl` — it sets the auto-heartbeat cadence.
- */
-const DEFAULT_CLAIM_TTL_MS = 60_000;
 /** @internal Constructed only by the typed HTTP facade. */
 export function createHttpTransport(options) {
     const env = readProcessEnv();
@@ -71,8 +67,7 @@ export function createHttpTransport(options) {
         const code = errorRecord?.code;
         const isConflict = code === 'stale_context' ||
             code === 'claim_conflict' ||
-            code === 'entity_claimed' ||
-            (typeof code === 'string' && code.startsWith('policy:'));
+            code === 'entity_claimed';
         if (!isConflict)
             return;
         const rawConflicts = errorRecord?.conflicts;
@@ -112,6 +107,7 @@ export function createHttpTransport(options) {
     let activeRequests = 0;
     let requestIdleWaiters = [];
     let disposePromise = null;
+    const readChangeControllers = new Set();
     function requestStarted() {
         activeRequests += 1;
     }
@@ -219,7 +215,23 @@ export function createHttpTransport(options) {
         }
         return target.toString();
     }
+    function subscriptionEndpoint() {
+        const target = new URL(endpoint('/v1/subscriptions'));
+        const partition = effectiveAuthority?.deliveryPartition;
+        if (partition) {
+            target.searchParams.set('deliveryPartition', `${partition.index}-${partition.count}`);
+        }
+        return target.toString();
+    }
     const requestTimeoutMs = options.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+    const onChange = createHttpReadOnChange({
+        fetch: fetchImpl,
+        endpoint: subscriptionEndpoint,
+        authHeaders,
+        prepare: ready,
+        register: (controller) => readChangeControllers.add(controller),
+        unregister: (controller) => readChangeControllers.delete(controller),
+    });
     /**
      * Issues one request and returns its decoded body without a contract.
      *
@@ -838,11 +850,9 @@ export function createHttpTransport(options) {
             assertWriteOptions({
                 idempotencyKey: commitOptions.idempotencyKey,
                 readAt: commitOptions.readAt,
-                onStale: commitOptions.onStale,
                 wait: commitOptions.wait,
                 claim: commitOptions.claim,
                 reads: commitOptions.reads,
-                track: commitOptions.track,
             }, 'commits.create');
             const clientTxId = createClientTxId(commitOptions.idempotencyKey);
             // Same claim vocabulary as the WS client's `commits.create`: a handle
@@ -851,12 +861,10 @@ export function createHttpTransport(options) {
             const operations = normalizeCommitOperations({
                 ...commitOptions,
                 readAt: commitOptions.readAt ?? claim?.readAt ?? null,
-                onStale: commitOptions.onStale ?? (claim?.readAt !== undefined ? 'reject' : null),
             }, batchFence(claim?.target, claim?.fenceToken));
             const requestBody = {
                 operations,
                 reads: commitOptions.reads,
-                track: commitOptions.track,
             };
             const wait = commitOptions.wait ?? 'confirmed';
             let body;
@@ -888,9 +896,6 @@ export function createHttpTransport(options) {
                 id: body.id ?? body.clientTxId,
                 status: body.status,
                 lastSyncId: body.lastSyncId,
-                ...(body.notifications && body.notifications.length > 0
-                    ? { notifications: body.notifications }
-                    : {}),
                 ...(body.missingIds && body.missingIds.length > 0 ? { missingIds: body.missingIds } : {}),
                 ...(body.operationResults && body.operationResults.length > 0
                     ? { operationResults: body.operationResults }
@@ -995,11 +1000,11 @@ export function createHttpTransport(options) {
             ...(res.evidence ? { evidence: res.evidence } : {}),
         };
     }
-    async function retrieveModel(modelName, params) {
+    async function readModel(modelName, params) {
         await applyClaimedPolicy({ model: modelName, id: params.id }, params);
         const query = await requestJson(`/v1/models/${encodeURIComponent(modelName)}/${encodeURIComponent(params.id)}`, { method: 'GET' }, modelReadResponseSchema);
         // A miss is `data: undefined`, not a thrown error. The WebSocket client's
-        // `retrieve` returns `T | undefined` for a missing row; throwing only here
+        // `read` returns `T | undefined` for a missing row; throwing only here
         // made the obvious read ("does this row exist?") a hard edge that an agent
         // had to wrap in try/catch. Both transports agree: an absent row means absent
         // data. Callers branch on `.data` (the documented `.data?.x` usage).
@@ -1025,12 +1030,10 @@ export function createHttpTransport(options) {
         assertWriteOptions(options && {
             idempotencyKey: options.idempotencyKey,
             readAt: options.readAt,
-            onStale: options.onStale,
             claim: options.claim,
             claimRef: options.claimRef,
             fenceToken: options.fenceToken,
             reads: options.reads,
-            track: options.track,
         }, `${modelName} ${action}`);
         if (action !== 'create')
             assertWriteTarget(action, modelName, id);
@@ -1052,10 +1055,8 @@ export function createHttpTransport(options) {
         const readAt = options?.readAt ?? claimHandle?.readAt;
         const requestBody = {
             claim: normalizeClaimId(options?.claimRef) ?? claimHandle?.id,
-            onStale: options?.onStale ?? (claimHandle?.readAt !== undefined ? 'reject' : undefined),
             readAt,
             reads: options?.reads,
-            track: options?.track,
             // The claim's fencing token (Option B), so the per-model HTTP write door
             // fences the same as the WS proxy and `commits.create`.
             fenceToken: options?.fenceToken ?? claimHandle?.fenceToken,
@@ -1184,7 +1185,15 @@ export function createHttpTransport(options) {
             }, claimHeartbeatReplySchema);
             return heldHeartbeatReply(reply, `claim ${claimId} on ${name}/${id}`);
         };
-        async function claimImpl(params) {
+        async function claimImpl(idOrParams, opts) {
+            // The row-free form names a key by id alone. Ablo has never held that
+            // row, so there is no snapshot to take after the grant and no `data` on
+            // the handle: the lease is the whole answer. The object form re-reads
+            // the row under the lease and hands back a `HeldClaim`.
+            const rowFree = typeof idOrParams === 'string';
+            const params = rowFree
+                ? { ...(opts ?? {}), id: idOrParams }
+                : idOrParams;
             let acquired;
             try {
                 acquired = await acquireClaim(params);
@@ -1210,13 +1219,6 @@ export function createHttpTransport(options) {
                 id: params.id,
                 description: claimDescription(params),
             });
-            const { data, stamp } = await retrieveModel(name, { id: params.id });
-            // A held claim hands back a snapshot; the typed `HeldClaim.data` is `T`.
-            // `retrieve` now reports a miss as `undefined` rather than throwing, but a
-            // claim on a row that doesn't exist has nothing to hold — surface it.
-            if (data === undefined) {
-                throw new AbloNotFoundError(`Cannot claim ${name}/${params.id}: it does not exist (or is outside this credential's scope).`, [params.id]);
-            }
             // One reading of the heartbeat options — cadence and callbacks from
             // whichever spelling the caller used (plan object, shorthand, or the
             // deprecated flat callbacks).
@@ -1249,10 +1251,9 @@ export function createHttpTransport(options) {
             // way. `subTarget` is wire-shaped by contract, including here, where the
             // value happens to have started out declared.
             const { meta, ...narrowed } = subTarget(params, name);
-            return {
+            const lease = {
                 object: 'claim',
                 id: claimId,
-                readAt: stamp,
                 ...(fenceToken !== undefined ? { fenceToken } : {}),
                 target: {
                     ...streamTarget({ model: name, id: params.id }),
@@ -1260,7 +1261,6 @@ export function createHttpTransport(options) {
                     ...(meta !== undefined ? { meta: declaredMeta(meta) } : {}),
                 },
                 description: claimDescription(params),
-                data,
                 release,
                 revoke: () => {
                     void release().catch(() => { });
@@ -1268,6 +1268,21 @@ export function createHttpTransport(options) {
                 heartbeat,
                 [Symbol.asyncDispose]: release,
             };
+            if (rowFree)
+                return lease;
+            const { data, stamp } = await readModel(name, { id: params.id });
+            // A held claim hands back a snapshot; the typed `HeldClaim.data` is `T`.
+            // `retrieve` reports a miss as `undefined`, and a claim on a row that does
+            // not exist has nothing to hold. The grant came BEFORE this read, so the
+            // miss must give the lease back first: otherwise the key stays held under
+            // this credential until the TTL lapses, behind no handle anyone can
+            // release, and every other participant is refused for the duration.
+            if (data === undefined) {
+                await release().catch(() => undefined);
+                throw new AbloNotFoundError(`Cannot claim ${name}/${params.id}: it does not exist (or is outside this credential's scope). ` +
+                    `To hold a key before its row exists, claim it by id alone: claim('${params.id}') returns a lease without a snapshot.`, [params.id]);
+            }
+            return { ...lease, readAt: stamp, data };
         }
         const claimsForEntity = (params) => requestJson(`/v1/claims?model=${encodeURIComponent(name)}&id=${encodeURIComponent(params.id)}${''}`, { method: 'GET' }, claimListResponseSchema);
         const claim = Object.assign(claimImpl, {
@@ -1278,6 +1293,19 @@ export function createHttpTransport(options) {
                 const first = res.data.find((row) => row.status !== 'queued');
                 return first ? claimFromModelClaim(first) : null;
             },
+            // Every holder, from the same one read `state` takes its first entry
+            // from: the server lists holders before waiters, and the caller's own
+            // lease before its peers'. (This member was missing for as long as the
+            // namespace was cast to its type instead of typed as it.)
+            list: async (params) => {
+                const res = await claimsForEntity(params);
+                return {
+                    object: 'list',
+                    data: res.data
+                        .filter((row) => row.status !== 'queued')
+                        .map(claimFromModelClaim),
+                };
+            },
             queue: async (params) => {
                 const res = await claimsForEntity(params);
                 return claimQueueView(res.data
@@ -1307,7 +1335,7 @@ export function createHttpTransport(options) {
                 // handle. The result was mutual exclusion without lost-update
                 // detection, on the transport agents run, under code that reads as
                 // though it had both. The reactive client binds the same three values
-                // from the claim it holds; a caller's own `readAt`/`onStale` win.
+                // from the claim it holds; a caller's own `readAt` wins.
                 return run({
                     ...input,
                     claimRef: { id: claimInput.id },
@@ -1317,9 +1345,6 @@ export function createHttpTransport(options) {
                     ...(input?.readAt === undefined && claimInput.readAt !== undefined
                         ? { readAt: claimInput.readAt }
                         : {}),
-                    ...(input?.onStale === undefined && claimInput.readAt !== undefined
-                        ? { onStale: 'reject' }
-                        : {}),
                     claim: undefined,
                 });
             }
@@ -1345,7 +1370,7 @@ export function createHttpTransport(options) {
         function updateModel(arg, updater, contention) {
             // Functional form: update(id, current => next). The SDK owns the
             // read-fresh → compute → compare-and-swap → reconcile loop; correctness
-            // rides on the row's watermark (readAt + onStale:'reject'), so no claim
+            // rides on the row's watermark (`readAt`), so no claim
             // or per-participant identity is needed and contention never clobbers.
             if (typeof arg === 'string') {
                 const id = arg;
@@ -1357,12 +1382,11 @@ export function createHttpTransport(options) {
                     model: name,
                     id,
                     readFresh: async () => {
-                        const read = await retrieveModel(name, { id });
+                        const read = await readModel(name, { id });
                         return { data: read.data, stamp: read.stamp };
                     },
                     writeNext: (patch, readAt) => mutateModel('update', name, id, patch, {
                         readAt,
-                        onStale: 'reject',
                     }),
                 });
             }
@@ -1374,11 +1398,8 @@ export function createHttpTransport(options) {
         }
         return {
             claim,
-            get(params) {
-                return retrieveModel(name, params);
-            },
-            retrieve(params) {
-                return retrieveModel(name, params);
+            read(params) {
+                return readModel(name, params);
             },
             list(options) {
                 return listModel(name, options);
@@ -1394,7 +1415,7 @@ export function createHttpTransport(options) {
                     // an existing id, the existing row rather than the caller's input.
                     let created;
                     await mutateModel('create', name, id, params.data, options, async () => {
-                        const read = await retrieveModel(name, { id });
+                        const read = await readModel(name, { id });
                         if (read.data === undefined) {
                             throw new AbloNotFoundError(`create ${name}/${id} did not yield a readable row (the write did not confirm).`, [id]);
                         }
@@ -1448,7 +1469,7 @@ export function createHttpTransport(options) {
                     ids,
                     operationResults: receipt.operationResults,
                     readRow: async (id) => {
-                        const read = await retrieveModel(name, { id });
+                        const read = await readModel(name, { id });
                         return read.data;
                     },
                 });
@@ -1460,29 +1481,6 @@ export function createHttpTransport(options) {
                     return mutateModel('delete', name, params.id, undefined, options);
                 });
             },
-            async track(params) {
-                const dependency = {
-                    model: name.toLowerCase(),
-                    id: params.id,
-                    ...(params.readAt !== undefined ? { readAt: params.readAt } : {}),
-                };
-                // A track carries no write, so it rides the commit lane as a
-                // zero-operation body — the shape `/v1/commits` accepts for registering
-                // a premise without one. Going through the same durable lane as every
-                // other commit means a disconnect replays the registration rather than
-                // dropping it, and a notification that had already fired is not lost to
-                // a retry.
-                const body = await dispatchHttpCommit({
-                    path: '/v1/commits',
-                    method: 'POST',
-                    idempotencyKey: createClientTxId(),
-                    body: { track: [dependency] },
-                    wait: 'confirmed',
-                });
-                return body.notifications && body.notifications.length > 0
-                    ? { notifications: body.notifications }
-                    : {};
-            },
         };
     }
     return {
@@ -1495,6 +1493,9 @@ export function createHttpTransport(options) {
         }),
         dispose() {
             if (!disposePromise) {
+                for (const controller of readChangeControllers)
+                    controller.abort();
+                readChangeControllers.clear();
                 const scheduledCommits = httpCommitLane;
                 disposePromise = (async () => {
                     await scheduledCommits;
@@ -1504,6 +1505,7 @@ export function createHttpTransport(options) {
             return disposePromise;
         },
         async purge() { },
+        onChange,
         commits,
         claims,
         logs,
@@ -1577,4 +1579,4 @@ function parseBody(bodyText) {
         return bodyText;
     }
 }
-//# sourceMappingURL=httpTransport.js.map
+//# sourceMappingURL=transport.js.map