@abloatai/transaction 0.48.0 → 0.49.0

package/dist/transport/httpClient.js

@@ -20,7 +20,10 @@
 import { createHttpTransport, } from './httpTransport.js';
 import { modelWireNames } from '../auth/capability.js';
 import { omittedModelError } from '../schema/select.js';
+import { reconcileFunctionalUpdate, } from '../resources/functionalUpdate.js';
 import { AbloConnectionError, AbloValidationError } from '../errors.js';
+import { abortReadSetCommit, capturePointRead, createReadSetContext, consumeReadSet, prepareReadSet, } from '../readSetContext.js';
+import { recordHttpCommitReceipt } from '../commitRecordRuntime.js';
 /**
  * Private transport members that pass straight through the facade. Everything
  * else must be a declared schema model; there is no dynamic fallback namespace.
@@ -32,6 +35,7 @@ const PROTOCOL_MEMBERS = new Set([
     'commits',
     'claims',
     'logs',
+    'identity',
     'getAuthToken',
     'sessions',
 ]);
@@ -45,9 +49,10 @@ function isProtocolMember(prop) {
  * receipts because functional updates need them. This is the single boundary
  * that unwraps those transport details for application code.
  */
-function createHttpModelClient(protocol) {
+function createHttpModelClient(protocol, modelName, clientIdentity, readSetContext) {
     async function readRow(id) {
         const read = await protocol.get({ id });
+        capturePointRead(readSetContext, clientIdentity, modelName, id, read.data, read.stamp);
         return read.data;
     }
     async function requireUpdatedRow(id) {
@@ -68,40 +73,148 @@ function createHttpModelClient(protocol) {
             ...(claim !== undefined ? { claim } : {}),
         };
     }
+    function preparedMutation(params) {
+        const prepared = prepareReadSet(readSetContext, clientIdentity, params.readAt, params.onStale, params.idempotencyKey, params.reads);
+        return {
+            options: {
+                ...mutationOptions(params),
+                ...(prepared.readAt !== undefined ? { readAt: prepared.readAt } : {}),
+                ...(prepared.onStale !== undefined ? { onStale: prepared.onStale } : {}),
+                ...(prepared.reads !== undefined ? { reads: prepared.reads } : {}),
+                ...(prepared.idempotencyKey !== undefined
+                    ? { idempotencyKey: prepared.idempotencyKey }
+                    : {}),
+            },
+            consumed: prepared.consumed,
+            automaticCommit: prepared.automaticCommit,
+        };
+    }
     async function update(arg, updater, options) {
         if (typeof arg === 'string') {
             if (!updater) {
                 throw new AbloValidationError('Functional update requires an updater function.', { code: 'write_options_invalid' });
             }
-            const receipt = await protocol.update(arg, updater, options);
+            const receipt = await reconcileFunctionalUpdate(updater, options, {
+                model: modelName,
+                id: arg,
+                readFresh: async () => {
+                    const read = await protocol.get({ id: arg });
+                    capturePointRead(readSetContext, clientIdentity, modelName, arg, read.data, read.stamp);
+                    return { data: read.data, stamp: read.stamp };
+                },
+                writeNext: async (patch, readAt) => {
+                    const prepared = preparedMutation({
+                        readAt,
+                        onStale: 'reject',
+                        reads: options?.reads,
+                    });
+                    try {
+                        const result = await protocol.update({
+                            ...prepared.options,
+                            id: arg,
+                            data: patch,
+                        });
+                        consumeReadSet(readSetContext, clientIdentity, prepared.consumed, prepared.automaticCommit);
+                        return result;
+                    }
+                    catch (error) {
+                        abortReadSetCommit(readSetContext, prepared.automaticCommit);
+                        throw error;
+                    }
+                },
+            });
             return receipt === undefined ? undefined : requireUpdatedRow(arg);
         }
-        await protocol.update({
-            ...mutationOptions(arg),
-            data: arg.data,
-        });
+        const prepared = preparedMutation(arg);
+        try {
+            await protocol.update({
+                ...prepared.options,
+                id: arg.id,
+                data: arg.data,
+            });
+        }
+        catch (error) {
+            abortReadSetCommit(readSetContext, prepared.automaticCommit);
+            throw error;
+        }
+        consumeReadSet(readSetContext, clientIdentity, prepared.consumed, prepared.automaticCommit);
         return requireUpdatedRow(arg.id);
     }
     const get = async (params) => {
         const read = await protocol.get(params);
+        capturePointRead(readSetContext, clientIdentity, modelName, params.id, read.data, read.stamp);
         return read.data;
     };
+    const list = async (options) => {
+        const snapshot = await protocol.list(options);
+        const registry = readSetContext?.getStore();
+        if (!registry)
+            return [...snapshot.data];
+        if (!snapshot.evidence) {
+            throw new AbloConnectionError(`${modelName}.list did not return row evidence. Upgrade the Ablo server or use get({ id }).`, { code: 'commit_no_result' });
+        }
+        const byId = new Map(snapshot.evidence.map((entry) => [entry.id, entry.stamp]));
+        for (const row of snapshot.data) {
+            const id = typeof row === 'object' && row !== null
+                ? Reflect.get(row, 'id')
+                : undefined;
+            const stamp = typeof id === 'string' ? byId.get(id) : undefined;
+            if (typeof id !== 'string' || stamp === undefined) {
+                throw new AbloConnectionError(`${modelName}.list returned a row without matching evidence.`, { code: 'commit_no_result' });
+            }
+            capturePointRead(readSetContext, clientIdentity, modelName, id, row, stamp);
+        }
+        return [...snapshot.data];
+    };
+    // Claim acquisition performs its authoritative read only after the grant.
+    // Preserve that exact post-grant watermark while retaining the callable
+    // namespace and all of its state/queue/release members through the proxy.
+    const claim = new Proxy(protocol.claim, {
+        apply(target, thisArg, argArray) {
+            const result = Reflect.apply(target, thisArg, argArray);
+            return result.then((held) => {
+                if (held && held.readAt !== undefined) {
+                    capturePointRead(readSetContext, clientIdentity, modelName, held.target.id, held.data, held.readAt);
+                }
+                return held;
+            });
+        },
+    });
     return {
         get,
         retrieve: get,
-        list: (options) => protocol.list(options),
+        list,
         async create(params) {
-            const row = await protocol.create({
-                ...mutationOptions(params),
-                data: params.data,
-            });
+            const id = params.id ?? '';
+            const prepared = preparedMutation(params);
+            let row;
+            try {
+                row = await protocol.create({
+                    ...prepared.options,
+                    ...(params.id !== undefined ? { id: params.id } : {}),
+                    data: params.data,
+                });
+            }
+            catch (error) {
+                abortReadSetCommit(readSetContext, prepared.automaticCommit);
+                throw error;
+            }
+            consumeReadSet(readSetContext, clientIdentity, prepared.consumed, prepared.automaticCommit);
             return row;
         },
         update,
         async delete(params) {
-            await protocol.delete(mutationOptions(params));
+            const prepared = preparedMutation(params);
+            try {
+                await protocol.delete({ ...prepared.options, id: params.id });
+            }
+            catch (error) {
+                abortReadSetCommit(readSetContext, prepared.automaticCommit);
+                throw error;
+            }
+            consumeReadSet(readSetContext, clientIdentity, prepared.consumed, prepared.automaticCommit);
         },
-        claim: protocol.claim,
+        claim,
         track: (params) => protocol.track(params),
     };
 }
@@ -113,21 +226,27 @@ function createHttpModelClient(protocol) {
  */
 /** @internal Constructed only through the public `Ablo({ transport: 'http' })` factory. */
 export function createAbloHttpClient(options) {
-    const { schema, ...rest } = options;
+    const { schema, onCommitReceipt, ...rest } = options;
+    const readSetContext = createReadSetContext();
     const transport = createHttpTransport({
         ...rest,
         // Derived from the schema this client is bound to, never assembled by hand
         // — see `auth/capability.ts`.
         modelTypenames: modelWireNames(schema.models),
+        onCommitReceipt: (observation) => {
+            recordHttpCommitReceipt(readSetContext, observation);
+            onCommitReceipt?.(observation);
+        },
     });
     const schemaModels = new Set(Object.keys(schema.models));
+    const clientIdentity = {};
     const omittedModels = new Set(schema.omittedModels ?? []);
     const models = new Map();
     const model = (name) => {
         const cached = models.get(name);
         if (cached)
             return cached;
-        const created = createHttpModelClient(transport.model(name));
+        const created = createHttpModelClient(transport.model(name), name, clientIdentity, readSetContext);
         models.set(name, created);
         return created;
     };

package/dist/transport/httpClient.js.map

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

package/dist/transport/httpOptions.d.ts

@@ -12,7 +12,8 @@
 import type { Schema, SchemaRecord } from '../schema/schema.js';
 import type { AuthClientOptions } from '../auth/apiKey.js';
 import type { CoordinationObservability } from '../observability.js';
-import type { CommitOutboxScope } from '../transactions/settlement/commitEnvelope.js';
+import type { CommitOutboxScope } from '../transactions/confirmation/commitEnvelope.js';
+import type { CommitReceiptWire } from '../wire/commit.js';
 import type { DurableWriteStore, DurableWritesConfig } from '../durableWrites.js';
 export interface HttpClientConfig<S extends SchemaRecord = SchemaRecord> extends AuthClientOptions {
     schema: Schema<S>;
@@ -30,5 +31,12 @@ export interface HttpClientConfig<S extends SchemaRecord = SchemaRecord> extends
     commitOutboxScope?: CommitOutboxScope;
     /** Which transport carries this client's traffic. */
     transport?: 'websocket' | 'http' | undefined;
+    /** @internal Exact receipt phases observed while dispatching one HTTP commit. */
+    onCommitReceipt?: (observation: {
+        readonly receipt: CommitReceiptWire;
+        readonly method: string;
+        readonly path: string;
+        readonly body: unknown;
+    }) => void;
 }
 //# sourceMappingURL=httpOptions.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"httpOptions.d.ts","sourceRoot":"","sources":["../../src/transport/httpOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AACtF,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,CAGrE,SAAQ,iBAAiB;IACzB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAClB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,KAAK,GAAG,SAAS,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IAC9D,aAAa,CAAC,EAAE,yBAAyB,CAAC;IAC1C,iFAAiF;IACjF,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,2DAA2D;IAC3D,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,qDAAqD;IACrD,SAAS,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;CAC9C"}
+{"version":3,"file":"httpOptions.d.ts","sourceRoot":"","sources":["../../src/transport/httpOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACxF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,CAGrE,SAAQ,iBAAiB;IACzB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAClB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,KAAK,GAAG,SAAS,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IAC9D,aAAa,CAAC,EAAE,yBAAyB,CAAC;IAC1C,iFAAiF;IACjF,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,2DAA2D;IAC3D,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,qDAAqD;IACrD,SAAS,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;IAC7C,iFAAiF;IACjF,eAAe,CAAC,EAAE,CAAC,WAAW,EAAE;QAC9B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;QACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;KACxB,KAAK,IAAI,CAAC;CACZ"}

package/dist/transport/httpTransport.d.ts

@@ -7,6 +7,7 @@
  */
 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';
 /** @internal Private options for the schema-agnostic HTTP protocol transport. */
@@ -47,6 +48,8 @@ export interface HttpTransport {
      */
     readonly claims: HttpClaimsResource;
     readonly logs: HttpLogsResource;
+    /** Server-confirmed authority of the active bearer, populated by `ready()`. */
+    readonly identity: EffectiveAuthority | null;
     model<T = Record<string, unknown>, Fields = T>(name: string): HttpTransportModel<T, Fields>;
     /**
      * Resolve the active bearer credential this client authenticates with — the

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

@@ -1 +1 @@
-{"version":3,"file":"httpTransport.d.ts","sourceRoot":"","sources":["../../src/transport/httpTransport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0DH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAKV,cAAc,EAGd,kBAAkB,EAClB,kBAAkB,EAKlB,gBAAgB,EAIhB,eAAe,EAChB,MAAM,+BAA+B,CAAC;AA2BvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AA+BxD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAcrE,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;AAYjD,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,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;AA4CD,2DAA2D;AAC3D,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CA4sDhF"}
+{"version":3,"file":"httpTransport.d.ts","sourceRoot":"","sources":["../../src/transport/httpTransport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAKV,cAAc,EAGd,kBAAkB,EAClB,kBAAkB,EAKlB,gBAAgB,EAIhB,eAAe,EAChB,MAAM,+BAA+B,CAAC;AAOvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAqBhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAgCxD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAcrE,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;AAYjD,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,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;AA4CD,2DAA2D;AAC3D,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAizDhF"}

package/dist/transport/httpTransport.js

@@ -10,7 +10,7 @@ import { v5 as uuidv5 } from 'uuid';
 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 { commitReceiptSchema } from '../wire/commit.js';
+import { commitReceiptSchema, 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';
@@ -37,10 +37,10 @@ function heldHeartbeatReply(reply, label) {
 }
 import { claimAttemptFailure, claimQueueView, emitClaimStatus, resolveClaimContentionOptions, } from '../resources/modelOperations.js';
 import { claimDescription } from '../coordination/schema.js';
-import { subTarget, streamTarget, batchFence, fenceTokenFor, } from '../coordination/locator.js';
+import { subTarget, streamTarget, batchFence, claimIdFor, fenceTokenFor, } from '../coordination/locator.js';
 import { declaredMeta, wireMeta } from '../coordination/claimMeta.js';
 import { assertWriteOptions } from '../resources/writeOptionsSchema.js';
-import { createDurableHttpCommitEnvelope, canonicalHttpCommitBody, durableHttpCommitEnvelopeSchema, httpCommitEnvelopeRecordId, isHttpCommitReplayExpired, } from '../transactions/settlement/httpCommitEnvelope.js';
+import { createDurableHttpCommitEnvelope, canonicalHttpCommitBody, durableHttpCommitEnvelopeSchema, httpCommitEnvelopeRecordId, isHttpCommitReplayExpired, } from '../transactions/confirmation/httpCommitEnvelope.js';
 import { resolveDurableWrites } from '../durableWrites.js';
 /** @internal Default per-request deadline for the private HTTP transport. */
 export const DEFAULT_REQUEST_TIMEOUT_MS = 30_000;
@@ -155,6 +155,7 @@ export function createHttpTransport(options) {
     });
     let httpOutboxScopeNamespace = null;
     let readyPromise = null;
+    let effectiveAuthority = null;
     let httpCommitLane = Promise.resolve();
     function runInHttpCommitLane(work) {
         const result = httpCommitLane.then(work);
@@ -187,7 +188,7 @@ export function createHttpTransport(options) {
         });
         return httpOutboxScopeNamespace;
     }
-    async function ready() {
+    async function prepare() {
         if (readyPromise)
             return readyPromise;
         readyPromise = (async () => {
@@ -202,6 +203,13 @@ export function createHttpTransport(options) {
             throw error;
         }
     }
+    async function ready() {
+        await prepare();
+        if (!effectiveAuthority) {
+            const rawIdentity = await requestRaw('/auth/identity', { method: 'GET' }, true);
+            effectiveAuthority = parseIdentityResolveResponse(rawIdentity).authority;
+        }
+    }
     async function authHeaders(sealedProtocolVersion) {
         const apiKey = await resolveApiKeyValue(configuredApiKey);
         const token = apiKey ?? configuredAuthToken;
@@ -250,7 +258,7 @@ export function createHttpTransport(options) {
      */
     async function requestRaw(path, init, skipReady = false) {
         if (!skipReady)
-            await ready();
+            await prepare();
         const { idempotencyKey, sealedProtocolVersion, ...requestInit } = init;
         const headers = await authHeaders(sealedProtocolVersion);
         if (idempotencyKey)
@@ -356,7 +364,7 @@ export function createHttpTransport(options) {
             await commitOutbox.remove(recordId);
         }
         catch (cause) {
-            // Do not report the remote outcome until local settlement is durable.
+            // Do not report the remote outcome until local confirmation is durable.
             // The retained record can still be replayed inside the safe window.
             throw new AbloConnectionError('The server settled the commit, but its local outbox record could not be cleared.', { code: 'db_not_opened', cause });
         }
@@ -392,6 +400,32 @@ export function createHttpTransport(options) {
         }
         return accepted;
     }
+    function observeCommitReceipt(request, receipt) {
+        // A successful receipt carries the same server-authored authority as the
+        // identity exchange. Reuse it so startup replay does not add a redundant
+        // auth request before callers can inspect `identity`.
+        effectiveAuthority = receipt.authority;
+        if (!options.onCommitReceipt)
+            return;
+        let body = request.body;
+        try {
+            body = JSON.parse(request.body);
+        }
+        catch {
+            // Preserve the exact opaque body for observability if it is not JSON.
+        }
+        try {
+            options.onCommitReceipt({
+                receipt,
+                method: request.method,
+                path: request.path,
+                body,
+            });
+        }
+        catch {
+            // Receipt observation must never change the commit outcome.
+        }
+    }
     function replicationLagTimeout(request, response) {
         return new AbloConnectionError(`The source accepted commit ${request.idempotencyKey}, but its replication echo did not arrive within ${requestTimeoutMs}ms.`, {
             code: 'replication_lag_timeout',
@@ -436,6 +470,7 @@ export function createHttpTransport(options) {
                     signal: confirmationController.signal,
                 }, true);
                 const next = parseSuccessfulCommitResponse(raw, request.idempotencyKey);
+                observeCommitReceipt(request, next);
                 if (next.correlationId !== correlationId) {
                     throw new AbloIdempotencyError('The same HTTP commit replay returned different source correlation evidence.', { code: 'idempotency_conflict' });
                 }
@@ -501,6 +536,13 @@ export function createHttpTransport(options) {
                     body: envelope.request.body,
                 }, true);
                 const response = parseSuccessfulCommitResponse(raw, envelope.idempotencyKey);
+                observeCommitReceipt({
+                    idempotencyKey: envelope.idempotencyKey,
+                    method: envelope.request.method,
+                    path: envelope.request.path,
+                    body: envelope.request.body,
+                    sealedProtocolVersion: envelope.protocolVersion,
+                }, response);
                 if (envelope.correlationId !== undefined &&
                     response.correlationId !== envelope.correlationId) {
                     throw new AbloIdempotencyError('The saved HTTP commit replay returned different source correlation evidence.', { code: 'idempotency_conflict' });
@@ -602,10 +644,10 @@ export function createHttpTransport(options) {
         await commitOutbox.seal(envelope, []);
         return envelope;
     }
-    async function dispatchHttpCommit(input, beforeSettlement) {
+    async function dispatchHttpCommit(input, beforeConfirmation) {
         return runInHttpCommitLane(async () => {
-            await ready();
-            // `ready()` covers startup. Re-draining here makes every later write wait
+            await prepare();
+            // Startup preparation covers replay. Re-draining here makes every later write wait
             // behind an ambiguous predecessor from this same process.
             const replayed = await replayHttpCommitOutbox();
             const prior = replayed.get(input.idempotencyKey);
@@ -635,7 +677,7 @@ export function createHttpTransport(options) {
                     }
                 }
                 if (priorResponse.status === 'confirmed') {
-                    await beforeSettlement?.(priorResponse);
+                    await beforeConfirmation?.(priorResponse);
                     await settleHttpEnvelope(prior.envelope.id);
                 }
                 return priorResponse;
@@ -660,6 +702,7 @@ export function createHttpTransport(options) {
                     body: exactRequest.body,
                 }, true);
                 response = parseSuccessfulCommitResponse(raw, input.idempotencyKey);
+                observeCommitReceipt(exactRequest, response);
                 if (durableEnvelope && response.status === 'queued') {
                     await persistHttpAcceptance(durableEnvelope, response);
                 }
@@ -673,12 +716,12 @@ export function createHttpTransport(options) {
                 }
                 throw error;
             }
-            // A model-create readback can participate in settlement: if it fails,
+            // A model-create readback can participate in confirmation: if it fails,
             // retain the exact write so a same-key retry recovers the generated id.
             // A queued source receipt cannot be read back from the log yet and stays
             // durable until a later confirmed replay.
             if (response.status === 'confirmed') {
-                await beforeSettlement?.(response);
+                await beforeConfirmation?.(response);
                 if (durableEnvelope)
                     await settleHttpEnvelope(durableEnvelope.id);
             }
@@ -700,13 +743,14 @@ export function createHttpTransport(options) {
             ? crypto.randomUUID()
             : `id_${Date.now()}_${Math.random().toString(36).slice(2, 10)}`;
     }
-    function normalizeCommitOperation(op, defaults, fence) {
+    function normalizeCommitOperation(op, defaults, fence, claim) {
         return {
             action: op.action,
             model: op.model,
             id: op.id ?? null,
             data: op.data ?? null,
             transactionId: op.transactionId ?? null,
+            claimId: op.claimId ?? claimIdFor(claim?.target, claim?.id, op.model, op.id ?? null),
             readAt: op.readAt ?? defaults.readAt ?? null,
             onStale: op.onStale ?? defaults.onStale ?? null,
             fenceToken: op.fenceToken ?? fenceTokenFor(fence, op.model, op.id ?? null),
@@ -718,7 +762,7 @@ export function createHttpTransport(options) {
                 code: 'commit_operation_required',
             });
         }
-        return commitOptions.operations.map((op) => normalizeCommitOperation(op, commitOptions, fence));
+        return commitOptions.operations.map((op) => normalizeCommitOperation(op, commitOptions, fence, commitOptions.claim ?? null));
     }
     async function listClaimState(target) {
         const params = new URLSearchParams();
@@ -860,6 +904,8 @@ export function createHttpTransport(options) {
                 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
@@ -899,7 +945,7 @@ export function createHttpTransport(options) {
             // `requestJson` throws via `translateHttpError` on any non-2xx, so
             // reaching here implies success and `body` is already the success-only
             // receipt union — a rejection is a separate type that never arrives here.
-            // The settlement status therefore passes through verbatim: no branch may
+            // The confirmation status therefore passes through verbatim: no branch may
             // collapse a state the server reported into a different one.
             return {
                 id: body.id ?? body.clientTxId,
@@ -911,6 +957,30 @@ export function createHttpTransport(options) {
                 ...(body.missingIds && body.missingIds.length > 0 ? { missingIds: body.missingIds } : {}),
             };
         },
+        get({ id }) {
+            if (!id) {
+                throw new AbloValidationError('commits.get requires a non-empty id.', {
+                    code: 'write_options_invalid',
+                    param: 'id',
+                });
+            }
+            return requestJson(`/v1/commits/${encodeURIComponent(id)}`, { method: 'GET' }, commitRecordSchema.nullable());
+        },
+        list(options = {}) {
+            const parsed = commitRecordListOptionsSchema.parse(options);
+            const where = commitRecordWhereSchema.parse(parsed.where ?? {});
+            const params = new URLSearchParams();
+            if (where.actorId)
+                params.set('actorId', where.actorId);
+            if (where.status)
+                params.set('status', where.status);
+            if (parsed.cursor)
+                params.set('cursor', parsed.cursor);
+            if (parsed.limit !== undefined)
+                params.set('limit', String(parsed.limit));
+            const query = params.size > 0 ? `?${params.toString()}` : '';
+            return requestJson(`/v1/commits${query}`, { method: 'GET' }, commitRecordListSchema);
+        },
     };
     const logs = {
         list(logOptions = {}) {
@@ -959,7 +1029,10 @@ export function createHttpTransport(options) {
         // transport is schema-agnostic — it moves rows for whatever schema the
         // caller declared, and `T` is that declaration. Row validation belongs to
         // the typed facade above, which holds the model's schema.
-        return res.data;
+        return {
+            data: res.data,
+            ...(res.evidence ? { evidence: res.evidence } : {}),
+        };
     }
     async function retrieveModel(modelName, params) {
         await applyClaimedPolicy({ model: modelName, id: params.id }, params);
@@ -987,12 +1060,16 @@ export function createHttpTransport(options) {
      * multi-operation envelopes; this helper handles the one-operation,
      * one-record case.
      */
-    async function mutateModel(action, modelName, id, data, options, beforeSettlement) {
+    async function mutateModel(action, modelName, id, data, options, beforeConfirmation) {
         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}`);
         const clientTxId = createClientTxId(options?.idempotencyKey);
         const encModel = encodeURIComponent(modelName);
@@ -1014,6 +1091,8 @@ export function createHttpTransport(options) {
             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,
@@ -1033,7 +1112,7 @@ export function createHttpTransport(options) {
                 // confirmation. Early queued receipts remain available through the
                 // lower-level `commits.create` lifecycle surface.
                 wait: 'confirmed',
-            }, beforeSettlement);
+            }, beforeConfirmation);
         }
         catch (error) {
             // The per-model write door (`ablo.<model>.update/create/delete`). Capture
@@ -1042,7 +1121,7 @@ export function createHttpTransport(options) {
             throw error;
         }
         // Same contract as `commits.create` above: a non-2xx already threw, so
-        // `body` is the success-only receipt union and its settlement status passes
+        // `body` is the success-only receipt union and its confirmation status passes
         // through verbatim rather than through a catch-all branch.
         return {
             id: body.serverTxId,
@@ -1258,7 +1337,14 @@ export function createHttpTransport(options) {
             if (!claimInput)
                 return run(input);
             if (isClaimHandle(claimInput)) {
-                return run({ ...input, claimRef: { id: claimInput.id }, claim: undefined });
+                return run({
+                    ...input,
+                    claimRef: { id: claimInput.id },
+                    ...(claimInput.fenceToken !== undefined
+                        ? { fenceToken: claimInput.fenceToken }
+                        : {}),
+                    claim: undefined,
+                });
             }
             // `isClaimHandle` ruled out the handle form above; the generic mismatch
             // (the union carries `Claim`, the guard narrows `Claim<T>`) keeps the
@@ -1338,7 +1424,7 @@ export function createHttpTransport(options) {
                         created = read.data;
                     });
                     if (created === undefined) {
-                        throw new AbloConnectionError('Create settlement did not return its row.', {
+                        throw new AbloConnectionError('Create confirmation did not return its row.', {
                             code: 'commit_no_result',
                         });
                     }
@@ -1379,8 +1465,9 @@ export function createHttpTransport(options) {
     }
     return {
         ready,
+        get identity() { return effectiveAuthority; },
         waitForFlush: () => runInHttpCommitLane(async () => {
-            await ready();
+            await prepare();
             const replayed = await replayHttpCommitOutbox();
             await confirmReplayedHttpCommits(replayed);
         }),