@abloatai/transaction 0.54.0 → 0.56.0

package/dist/wire/deltaDelivery.d.ts

@@ -0,0 +1,45 @@
+/**
+ * What `GET /v1/logs/delivery` answers: of the changes this plane recorded,
+ * how many could reach anyone.
+ *
+ * The engine already knows. A delta whose `sync_groups` is empty is an upstream
+ * invariant violation — `buildDeltaSyncGroups` guarantees at least one group —
+ * so the fan-out excludes it from delivery, counts it, and warns. All three land
+ * on Ablo's side of the boundary. The row is in the customer's database, the
+ * commit confirmed, every configuration check green, and nobody is told. This
+ * response moves that fact to the side the person debugging it is standing on.
+ *
+ * Counts and one sample, never row data: `model` and `id` are what the warning
+ * already names, and they are what turns "realtime is broken" into a row to look
+ * at.
+ */
+import { z } from 'zod';
+/** The model and row of one undeliverable change — enough to find it, no more. */
+export declare const deliverySampleSchema: z.ZodObject<{
+    model: z.ZodString;
+    id: z.ZodString;
+    at: z.ZodString;
+}, z.core.$strip>;
+export type DeliverySample = z.infer<typeof deliverySampleSchema>;
+/**
+ * `GET /v1/logs/delivery` — the plane's fan-out verdict over a fixed recent
+ * window.
+ *
+ * `recorded` and `unroutable` are the verdict and always present. `sample` is
+ * optional in the reader's stance the rest of this surface takes: a deployment
+ * that omits it must still be readable, because refusing to parse would refuse
+ * the diagnosis along with it.
+ */
+export declare const logDeliveryResponseSchema: z.ZodObject<{
+    object: z.ZodOptional<z.ZodLiteral<"log_delivery">>;
+    window_seconds: z.ZodNumber;
+    recorded: z.ZodNumber;
+    unroutable: z.ZodNumber;
+    sample: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        model: z.ZodString;
+        id: z.ZodString;
+        at: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type LogDeliveryResponse = z.infer<typeof logDeliveryResponseSchema>;
+//# sourceMappingURL=deltaDelivery.d.ts.map

package/dist/wire/deltaDelivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deltaDelivery.d.ts","sourceRoot":"","sources":["../../src/wire/deltaDelivery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,kFAAkF;AAClF,eAAO,MAAM,oBAAoB;;;;iBAI/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;iBAUpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/wire/deltaDelivery.js

@@ -0,0 +1,43 @@
+/**
+ * What `GET /v1/logs/delivery` answers: of the changes this plane recorded,
+ * how many could reach anyone.
+ *
+ * The engine already knows. A delta whose `sync_groups` is empty is an upstream
+ * invariant violation — `buildDeltaSyncGroups` guarantees at least one group —
+ * so the fan-out excludes it from delivery, counts it, and warns. All three land
+ * on Ablo's side of the boundary. The row is in the customer's database, the
+ * commit confirmed, every configuration check green, and nobody is told. This
+ * response moves that fact to the side the person debugging it is standing on.
+ *
+ * Counts and one sample, never row data: `model` and `id` are what the warning
+ * already names, and they are what turns "realtime is broken" into a row to look
+ * at.
+ */
+import { z } from 'zod';
+/** The model and row of one undeliverable change — enough to find it, no more. */
+export const deliverySampleSchema = z.object({
+    model: z.string(),
+    id: z.string(),
+    at: z.string(),
+});
+/**
+ * `GET /v1/logs/delivery` — the plane's fan-out verdict over a fixed recent
+ * window.
+ *
+ * `recorded` and `unroutable` are the verdict and always present. `sample` is
+ * optional in the reader's stance the rest of this surface takes: a deployment
+ * that omits it must still be readable, because refusing to parse would refuse
+ * the diagnosis along with it.
+ */
+export const logDeliveryResponseSchema = z.object({
+    object: z.literal('log_delivery').optional(),
+    /** The window the counts cover, so a reader never hardcodes it. */
+    window_seconds: z.number(),
+    /** Deltas this plane recorded in the window. */
+    recorded: z.number(),
+    /** Of those, the ones excluded from delivery for having no sync group. */
+    unroutable: z.number(),
+    /** The most recent undeliverable change, when there is one. */
+    sample: deliverySampleSchema.nullable().optional(),
+});
+//# sourceMappingURL=deltaDelivery.js.map

package/dist/wire/deltaDelivery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deltaDelivery.js","sourceRoot":"","sources":["../../src/wire/deltaDelivery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,kFAAkF;AAClF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;CACf,CAAC,CAAC;AAGH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE;IAC5C,mEAAmE;IACnE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,gDAAgD;IAChD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,0EAA0E;IAC1E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,+DAA+D;IAC/D,MAAM,EAAE,oBAAoB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACnD,CAAC,CAAC"}

package/dist/wire/index.d.ts

@@ -23,6 +23,8 @@ export { claimEventSchema } from './claimEvent.js';
 export type { ClaimEvent } from './claimEvent.js';
 export { feedEventSchema, logListResponseSchema, logQuerySchema, } from './feedEvent.js';
 export type { FeedEvent, LogListResponse, LogQuery } from './feedEvent.js';
+export { logDeliveryResponseSchema, deliverySampleSchema } from './deltaDelivery.js';
+export type { LogDeliveryResponse, DeliverySample } from './deltaDelivery.js';
 export { feedCursorSchema, parseFeedCursor, formatFeedCursor, feedCursorAdvanced, FEED_CURSOR_START, FEED_CURSOR_FORMAT, FEED_CURSOR_EXAMPLE, } from './feedCursor.js';
 export type { FeedCursor } from './feedCursor.js';
 export { bootstrapReasonSchema } from './bootstrapReason.js';

package/dist/wire/index.d.ts.map

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

package/dist/wire/index.js

@@ -21,6 +21,9 @@ export { listEnvelopeSchema, listEnvelope, CURSOR_PARAM, CURSOR_PARAM_ALIAS, CUR
 // carries a position in each.
 export { claimEventSchema } from './claimEvent.js';
 export { feedEventSchema, logListResponseSchema, logQuerySchema, } from './feedEvent.js';
+// The same feed's delivery verdict — how much of what it recorded could reach
+// anyone. Read by `ablo doctor`.
+export { logDeliveryResponseSchema, deliverySampleSchema } from './deltaDelivery.js';
 export { feedCursorSchema, parseFeedCursor, formatFeedCursor, feedCursorAdvanced, FEED_CURSOR_START, FEED_CURSOR_FORMAT, FEED_CURSOR_EXAMPLE, } from './feedCursor.js';
 export { bootstrapReasonSchema } from './bootstrapReason.js';
 // The write-path frame contract: the message shapes shared by the client and

package/dist/wire/index.js.map

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

package/dist/wire/modelMutations.js

@@ -15,7 +15,8 @@
  * the server validates against this and the reference is generated from it.
  */
 import { z } from 'zod';
-import { onStaleModeSchema, MAX_READ_SET_ENTRIES, readDependencyListSchema, readSetProjectionEntryCount, readSetWatermarkSchema, trackDependencyListSchema, } from '../coordination/schema.js';
+import { logPositionSchema } from '../syncLog/contract.js';
+import { onStaleModeSchema, MAX_READ_SET_ENTRIES, readDependencyListSchema, readSetProjectionEntryCount, trackDependencyListSchema, } from '../coordination/schema.js';
 export const modelMutationRequestSchema = z.object({
     /** The record. Its shape is your schema's; everything around it is protocol. */
     data: z.record(z.string(), z.unknown()).nullish(),
@@ -41,7 +42,7 @@ export const modelMutationRequestSchema = z.object({
      * the read. Ablo rejects the write if the row moved in between, which is
      * what makes read → decide → write safe without a lock across the deciding.
      */
-    readAt: readSetWatermarkSchema.nullish(),
+    readAt: logPositionSchema.nullish(),
     /** Commit-lifetime dependencies checked with the single model operation. */
     reads: readDependencyListSchema.nullish(),
     /** Durable dependencies registered with the single model operation. */

package/dist/wire/modelMutations.js.map

@@ -1 +1 @@
-{"version":3,"file":"modelMutations.js","sourceRoot":"","sources":["../../src/wire/modelMutations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACxB,2BAA2B,EAC3B,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,gFAAgF;IAChF,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACjD;;;;;;;;;;;OAWG;IACH,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IACxB,gEAAgE;IAChE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IAC3B,2EAA2E;IAC3E,OAAO,EAAE,iBAAiB,CAAC,OAAO,EAAE;IACpC;;;;OAIG;IACH,MAAM,EAAE,sBAAsB,CAAC,OAAO,EAAE;IACxC,4EAA4E;IAC5E,KAAK,EAAE,wBAAwB,CAAC,OAAO,EAAE;IACzC,uEAAuE;IACvE,KAAK,EAAE,yBAAyB,CAAC,OAAO,EAAE;IAC1C;;;OAGG;IACH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IAChC,wEAAwE;IACxE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,2BAA2B,CAAC,KAAK,CAAC,IAAI,oBAAoB,EAAE;IAC/E,IAAI,EAAE,CAAC,OAAO,CAAC;IACf,OAAO,EAAE,uCAAuC,oBAAoB,mBAAmB;CACxF,CAAC,CAAC"}
+{"version":3,"file":"modelMutations.js","sourceRoot":"","sources":["../../src/wire/modelMutations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,gFAAgF;IAChF,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACjD;;;;;;;;;;;OAWG;IACH,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IACxB,gEAAgE;IAChE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IAC3B,2EAA2E;IAC3E,OAAO,EAAE,iBAAiB,CAAC,OAAO,EAAE;IACpC;;;;OAIG;IACH,MAAM,EAAE,iBAAiB,CAAC,OAAO,EAAE;IACnC,4EAA4E;IAC5E,KAAK,EAAE,wBAAwB,CAAC,OAAO,EAAE;IACzC,uEAAuE;IACvE,KAAK,EAAE,yBAAyB,CAAC,OAAO,EAAE;IAC1C;;;OAGG;IACH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IAChC,wEAAwE;IACxE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,2BAA2B,CAAC,KAAK,CAAC,IAAI,oBAAoB,EAAE;IAC/E,IAAI,EAAE,CAAC,OAAO,CAAC;IACf,OAAO,EAAE,uCAAuC,oBAAoB,mBAAmB;CACxF,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abloatai/transaction",
-  "version": "0.54.0",
+  "version": "0.56.0",
   "description": "The headless Ablo transaction client and canonical contracts for reads, commits, confirmation, claims, and durable observation.",
   "license": "Apache-2.0",
   "type": "module",

package/src/auth/hostedEndpoints.ts

@@ -1,10 +1,13 @@
 /**
- * The hosted Ablo Cloud endpoint constants, with no dependencies of their own.
+ * The hosted Ablo hosts, with no dependencies of their own.
  *
- * This is the single place the hosted API host is declared. URL resolution, the
- * CLI's default URL, the data-source connector's base, the generated OpenAPI
- * server entry, and the network probe's default all import from here, so
- * changing the API domain is a one-line edit.
+ * This is the single place each published Ablo domain is declared: the API the
+ * SDK calls, the documentation site every error link and descriptor points at,
+ * and the marketing site that carries signup and the legal pages. URL
+ * resolution, the CLI's default URL, the data-source connector's base, the
+ * generated OpenAPI server entry, the error registry's `doc_url`, and the
+ * published discovery descriptors all import from here, so changing a domain is
+ * a one-line edit.
  *
  * These constants are kept dependency-free deliberately: several low-level
  * modules consume them, and routing those modules through the auth layer would
@@ -22,3 +25,18 @@ export const ABLO_HOSTED_HTTP_BASE_URL = `https://${ABLO_HOSTED_API_DOMAIN}`;
  *  {@link ABLO_HOSTED_HTTP_BASE_URL}; kept as a distinct name because it is
  *  the documented client-options default. */
 export const ABLO_DEFAULT_BASE_URL = ABLO_HOSTED_HTTP_BASE_URL;
+
+/**
+ * The documentation site. Canonical target of every error `doc_url`, of the
+ * published OpenAPI document, and of the discovery descriptors under
+ * `/.well-known`, which is why it is declared beside the API host rather than
+ * retyped at each of those call sites.
+ */
+export const ABLO_DOCS_BASE_URL = 'https://docs.abloatai.com';
+
+/**
+ * The marketing site: signup, the CLI device-flow approval page, and the legal
+ * pages a machine-readable onboarding descriptor has to cite. The apex
+ * redirects here, so this is the form to publish.
+ */
+export const ABLO_SITE_BASE_URL = 'https://www.abloatai.com';

package/src/auth/index.ts

@@ -26,18 +26,13 @@ import type {
 } from './capability.js';
 export {
   ABLO_DEFAULT_BASE_URL,
+  ABLO_DOCS_BASE_URL,
   ABLO_HOSTED_API_DOMAIN,
   ABLO_HOSTED_HTTP_BASE_URL,
+  ABLO_SITE_BASE_URL,
 } from './hostedEndpoints.js';
 export { normalizeAbloBaseUrl } from './baseUrl.js';
 
-/**
- * @deprecated Use {@link CapabilityMintResponse}. Removed in 0.55.0. This is a
- * type-only rename bridge; both names resolve to the same canonical Zod
- * contract and no runtime parser or schema is duplicated.
- */
-export type CapabilityExchangeResponse = CapabilityMintResponse;
-
 export type {
   EphemeralKeyResponse,
   IdentityResolveResponse,

package/src/coordination/index.ts

@@ -22,8 +22,8 @@ export {
   targetRefSchema,
   // Layer 3 — optimistic stale-context
   onStaleModeSchema,
-  MAX_READ_SET_ENTRIES,
   readSetWatermarkSchema,
+  MAX_READ_SET_ENTRIES,
   readSetRowTargetSchema,
   readSetGroupTargetSchema,
   commitReadSetTargetSchema,

package/src/coordination/schema.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { logPositionSchema, type LogPosition } from '../syncLog/contract.js';
 import {
   syncGroupInputSchema,
   syncGroupRefSchema,
@@ -267,9 +268,12 @@ const streamTargetSchema = targetRefSchema
 export const onStaleModeSchema = z.enum(['reject', 'overwrite', 'notify']);
 export type OnStaleMode = z.infer<typeof onStaleModeSchema>;
 
-/** The exact authoritative position retained for one ReadSet entry. */
-export const readSetWatermarkSchema = z.number().int().nonnegative();
-export type ReadSetWatermark = z.infer<typeof readSetWatermarkSchema>;
+/** @deprecated A ReadSet entry retains a {@link logPositionSchema} like every
+ *  other position; the reader is the owner, and the owner belongs in the field
+ *  name rather than in a second type. Removed in 0.57.0. */
+export const readSetWatermarkSchema = logPositionSchema;
+/** @deprecated Use {@link LogPosition}. Removed in 0.57.0. */
+export type ReadSetWatermark = LogPosition;
 
 /** Maximum decision-input entries one logical commit may ask the server to scan. */
 export const MAX_READ_SET_ENTRIES = 500;
@@ -285,7 +289,7 @@ export type TrackOnStale = z.infer<typeof trackOnStaleSchema>;
  * claim — see the claim layer below.
  */
 export const writeGuardSchema = z.object({
-  readAt: readSetWatermarkSchema.nullish(),
+  readAt: logPositionSchema.nullish(),
   onStale: onStaleModeSchema.nullish(),
   bypass: z.boolean().optional(),
 });
@@ -489,7 +493,7 @@ export type PersistedReadSetTarget = z.infer<typeof persistedReadSetTargetSchema
 /** One exact input to the decision made by this commit. */
 export const commitReadSetEntrySchema = z.object({
   target: commitReadSetTargetSchema,
-  watermark: readSetWatermarkSchema,
+  watermark: logPositionSchema,
   lifetime: z.literal('commit'),
   onStale: onStaleModeSchema,
 });
@@ -498,7 +502,7 @@ export type CommitReadSetEntry = z.infer<typeof commitReadSetEntrySchema>;
 /** One exact input retained after the declaring commit settles. */
 export const persistedReadSetEntrySchema = z.object({
   target: persistedReadSetTargetSchema,
-  watermark: readSetWatermarkSchema,
+  watermark: logPositionSchema,
   lifetime: z.literal('persisted'),
   onStale: trackOnStaleSchema,
 });

package/src/errors.ts

@@ -17,6 +17,9 @@
 
 import { z } from 'zod';
 import type { ErrorCode } from './errorCodes.js';
+// Dependency-free by design, so the error registry can name the docs host
+// without pulling the auth layer into this module's import graph.
+import { ABLO_DOCS_BASE_URL } from './auth/hostedEndpoints.js';
 import { errorCodeSpec, classifyRecovery } from './errorCodes.js';
 import {
   wireClaimSummarySchema,
@@ -156,7 +159,7 @@ export class AbloError extends Error {
  * a `doc_url` automatically.
  */
 export function docUrlForCode(code: ErrorCode): string {
-  return `https://docs.abloatai.com/errors#${code}`;
+  return `${ABLO_DOCS_BASE_URL}/errors#${code}`;
 }
 
 /** 401 — invalid/missing/expired credentials. */

package/src/resources/writeOptionsSchema.ts

@@ -17,6 +17,7 @@
  */
 
 import { z } from 'zod';
+import { logPositionSchema } from '../syncLog/contract.js';
 import type { MutationOptions } from '../resources/mutationOptions.js';
 import { AbloValidationError } from '../errors.js';
 import { commitWaitSchema } from '../wire/commit.js';
@@ -24,7 +25,6 @@ import {
   onStaleModeSchema,
   MAX_READ_SET_ENTRIES,
   readDependencyListSchema,
-  readSetWatermarkSchema,
   readSetProjectionEntryCount,
   trackDependencyListSchema,
 } from '../coordination/schema.js';
@@ -46,7 +46,7 @@ export const writeOptionsSchema = z.object({
   /** Resolve when queued locally (default) or once the server confirms. */
   wait: commitWaitSchema.optional(),
   /** Stale guard: the sync watermark the caller's reasoning was based on. */
-  readAt: readSetWatermarkSchema.nullish(),
+  readAt: logPositionSchema.nullish(),
   /** What the server does when the target moved past `readAt`. */
   onStale: onStaleModeSchema.nullish(),
   /** The held claim's fencing token (Option B), sourced from the claim handle

package/src/schema/openapi.ts

@@ -56,6 +56,7 @@ import { errorEnvelopeSchema } from '../wire/errorEnvelope.js';
 import { modelReadResponseSchema, modelListResponseSchema } from '../wire/modelResponses.js';
 import { modelMutationRequestSchema } from '../wire/modelMutations.js';
 import { logListResponseSchema, logQuerySchema } from '../wire/feedEvent.js';
+import { logDeliveryResponseSchema } from '../wire/deltaDelivery.js';
 import { schemaReadResponseSchema } from '../wire/accountResponses.js';
 import {
   ephemeralKeyRequestSchema,
@@ -161,6 +162,7 @@ const ABLO_OPERATION_IDS: Readonly<Record<string, string>> = {
   'POST /v1/capabilities/{id}/rotate': 'rotateCapability',
   'GET /v1/schema': 'getSchema',
   'GET /v1/logs': 'listLogEntries',
+  'GET /v1/logs/delivery': 'getLogDelivery',
   'GET /v1/commits': 'listCommits',
   'POST /v1/commits': 'commit',
   'GET /v1/commits/{id}': 'getCommit',
@@ -902,6 +904,25 @@ export function abloOpenApi(options: SchemaToOpenApiOptions = {}): Json {
         },
       },
     },
+    '/v1/logs/delivery': {
+      get: {
+        tags: ['logs'],
+        summary: 'How much of what was recorded could reach anyone',
+        description:
+          'The fan-out verdict for your plane over a recent window. `recorded` ' +
+          'counts the changes the log accepted; `unroutable` counts the ones ' +
+          'excluded from delivery because they carried no sync group, which is ' +
+          'the state a row reaches when it was written into your database ' +
+          'outside Ablo and so carries no tenancy value. Any number above zero ' +
+          'means writes are landing that no subscriber is told about.',
+        responses: {
+          '200': jsonResp(
+            'The counts, plus the most recent undeliverable change when there is one.',
+            derive(logDeliveryResponseSchema, 'output'),
+          ),
+        },
+      },
+    },
     '/v1/commits': {
       get: {
         tags: ['commits'],

package/src/syncLog/contract.ts

@@ -1,9 +1,58 @@
-/** Canonical sync-log identity and position contracts shared by client/server. */
+/**
+ * Canonical sync-log identity and position contracts shared by client/server.
+ *
+ * ## A log position means ONE thing
+ *
+ * It is an ordinal in `sync_deltas`: a point in the single, totally ordered
+ * log. Nothing else. Every number in this engine that answers "how far along"
+ * is this type, and there is one definition of it, below.
+ *
+ * What varies is never the meaning. It is **who is making the claim**, and the
+ * owner belongs in the field name, never in a second type:
+ *
+ * | Owner                              | Claims                                    |
+ * | ---------------------------------- | ----------------------------------------- |
+ * | `current_settled_sync_id()`        | nothing at or below is still in flight    |
+ * | `getCommittedSyncId`               | committed, without waiting for the barrier|
+ * | `sync_broadcast_cursors.published_through` | the fan-out published through     |
+ * | `Client.lastSentSyncId`            | this recipient was offered through        |
+ * | `Client.lastAckedSyncId`           | this recipient confirmed through          |
+ * | `LogPosition.applied`              | the client processed on arrival through   |
+ * | `LogPosition.persisted`            | the client durably holds through, in
+ *                                        DELIVERED order, not numeric order       |
+ * | `RowWatermarks`                    | this one row reflects the log through     |
+ * | `sync_state_checkpoint.up_to_sync_id` | the checkpoint folded through          |
+ *
+ * ## The comparison that is not safe
+ *
+ * `current_settled_sync_id` takes a per-plane advisory lock but reads the
+ * GLOBAL sequence, so its value moves for writers in other planes. Every other
+ * owner above is scoped: to a plane, a project, a recipient, or a row. "The
+ * head of the log" and "how far I have been served" are therefore different
+ * questions, and a scoped cursor sitting below the global head is the normal
+ * resting state, not a gap.
+ *
+ * Treating one as the other is what left every client permanently short of its
+ * own head, re-taking the plane lock on every catch-up poll
+ * (docs/plans/delivery-verify-at-read.md). Before comparing two positions, say
+ * out loud which owner each belongs to.
+ */
 
 import { z } from 'zod';
 
-export const deltaPositionSchema = z.number().int().nonnegative();
-export type DeltaPosition = z.infer<typeof deltaPositionSchema>;
+/**
+ * A point in the sync log. The one definition; every other position name in
+ * the codebase derives from this one rather than restating the primitive.
+ */
+export const logPositionSchema = z.number().int().nonnegative();
+export type LogPosition = z.infer<typeof logPositionSchema>;
+
+/** @deprecated One position type, one name: use {@link logPositionSchema}.
+ *  This spelling is removed in 0.57.0. It resolves to the definition above, so
+ *  the two cannot drift while both are exported. */
+export const deltaPositionSchema = logPositionSchema;
+/** @deprecated One position type, one name: use {@link LogPosition}. Removed in 0.57.0. */
+export type DeltaPosition = LogPosition;
 
 export const clientMutationIdSchema = z.string().min(1).max(255);
 export type ClientMutationId = z.infer<typeof clientMutationIdSchema>;
@@ -21,8 +70,8 @@ export const commitDispatchMarkerSchema = z.strictObject({
   kind: z.literal('sync_deltas'),
   organizationId: z.string().min(1),
   branchId: z.string().min(1),
-  firstSyncId: deltaPositionSchema,
-  lastSyncId: deltaPositionSchema,
+  firstSyncId: logPositionSchema,
+  lastSyncId: logPositionSchema,
 }).superRefine((value, ctx) => {
   if (value.firstSyncId <= 0 || value.lastSyncId < value.firstSyncId) {
     ctx.addIssue({ code: 'custom', message: 'invalid delta position range' });

package/src/wire/auth.ts

@@ -34,9 +34,12 @@ export const ephemeralKeyRequestSchema = z.object({
   /** The participant this session acts as. */
   user: ephemeralKeyUserSchema,
   /**
-   * Mint into this organization instead of the caller's own. Requires the
-   * `organization:act-as` scope — without it a secret key can never mint a
-   * session into another tenant.
+   * Open the session in a DIFFERENT organization, one the caller does not
+   * belong to. Requires the `organization:act-as` scope. This is the identity
+   * provider case, where each organization is an account in its own right.
+   *
+   * A platform serving its own customers does not use this: its customers are
+   * rows in its own schema, and a session reaches them through `syncGroups`.
    */
   organizationId: z.string().min(1).optional(),
   /**

package/src/wire/commit.ts

@@ -18,6 +18,7 @@
  */
 
 import { z } from 'zod';
+import { logPositionSchema } from '../syncLog/contract.js';
 import {
   onStaleModeSchema,
   MAX_READ_SET_ENTRIES,
@@ -25,7 +26,6 @@ import {
   readSetRowTargetSchema,
   readSetProjectionEntryCount,
   readSetSchema,
-  readSetWatermarkSchema,
   participantKindSchema,
   staleNotificationSchema,
   trackDependencyListSchema,
@@ -61,7 +61,7 @@ export const confirmedCommitStatusSchema = z
   .strictObject({
     status: confirmedStatusSchema,
     statusAt: commitTimestampSchema,
-    lastSyncId: readSetWatermarkSchema,
+    lastSyncId: logPositionSchema,
     correlationId: correlationIdSchema.optional(),
   })
   .refine(({ correlationId, lastSyncId }) => correlationId === undefined || lastSyncId > 0, {
@@ -375,7 +375,7 @@ export type MutationCommitResult = z.infer<typeof mutationCommitResultSchema>;
 export const clientCommitReceiptSchema = z.strictObject({
   id: z.string().min(1),
   status: z.union([queuedStatusSchema, confirmedStatusSchema]),
-  lastSyncId: readSetWatermarkSchema.optional(),
+  lastSyncId: logPositionSchema.optional(),
   notifications: notificationsSchema.optional(),
   missingIds: missingIdsSchema.optional(),
   operationResults: operationResultsSchema.optional(),
@@ -400,7 +400,7 @@ export const commitOperationControlShape = {
   id: z.string().nullish(),
   transactionId: z.string().nullish(),
   claimId: z.string().min(1).nullish(),
-  readAt: readSetWatermarkSchema.nullish(),
+  readAt: logPositionSchema.nullish(),
   onStale: onStaleModeSchema.nullish(),
   fenceToken: z.number().nullish(),
 };

package/src/wire/deltaDelivery.ts

@@ -0,0 +1,47 @@
+/**
+ * What `GET /v1/logs/delivery` answers: of the changes this plane recorded,
+ * how many could reach anyone.
+ *
+ * The engine already knows. A delta whose `sync_groups` is empty is an upstream
+ * invariant violation — `buildDeltaSyncGroups` guarantees at least one group —
+ * so the fan-out excludes it from delivery, counts it, and warns. All three land
+ * on Ablo's side of the boundary. The row is in the customer's database, the
+ * commit confirmed, every configuration check green, and nobody is told. This
+ * response moves that fact to the side the person debugging it is standing on.
+ *
+ * Counts and one sample, never row data: `model` and `id` are what the warning
+ * already names, and they are what turns "realtime is broken" into a row to look
+ * at.
+ */
+
+import { z } from 'zod';
+
+/** The model and row of one undeliverable change — enough to find it, no more. */
+export const deliverySampleSchema = z.object({
+  model: z.string(),
+  id: z.string(),
+  at: z.string(),
+});
+export type DeliverySample = z.infer<typeof deliverySampleSchema>;
+
+/**
+ * `GET /v1/logs/delivery` — the plane's fan-out verdict over a fixed recent
+ * window.
+ *
+ * `recorded` and `unroutable` are the verdict and always present. `sample` is
+ * optional in the reader's stance the rest of this surface takes: a deployment
+ * that omits it must still be readable, because refusing to parse would refuse
+ * the diagnosis along with it.
+ */
+export const logDeliveryResponseSchema = z.object({
+  object: z.literal('log_delivery').optional(),
+  /** The window the counts cover, so a reader never hardcodes it. */
+  window_seconds: z.number(),
+  /** Deltas this plane recorded in the window. */
+  recorded: z.number(),
+  /** Of those, the ones excluded from delivery for having no sync group. */
+  unroutable: z.number(),
+  /** The most recent undeliverable change, when there is one. */
+  sample: deliverySampleSchema.nullable().optional(),
+});
+export type LogDeliveryResponse = z.infer<typeof logDeliveryResponseSchema>;

package/src/wire/index.ts

@@ -41,6 +41,11 @@ export {
   logQuerySchema,
 } from './feedEvent.js';
 export type { FeedEvent, LogListResponse, LogQuery } from './feedEvent.js';
+
+// The same feed's delivery verdict — how much of what it recorded could reach
+// anyone. Read by `ablo doctor`.
+export { logDeliveryResponseSchema, deliverySampleSchema } from './deltaDelivery.js';
+export type { LogDeliveryResponse, DeliverySample } from './deltaDelivery.js';
 export {
   feedCursorSchema,
   parseFeedCursor,

package/src/wire/modelMutations.ts

@@ -16,12 +16,12 @@
  */
 
 import { z } from 'zod';
+import { logPositionSchema } from '../syncLog/contract.js';
 import {
   onStaleModeSchema,
   MAX_READ_SET_ENTRIES,
   readDependencyListSchema,
   readSetProjectionEntryCount,
-  readSetWatermarkSchema,
   trackDependencyListSchema,
 } from '../coordination/schema.js';
 
@@ -50,7 +50,7 @@ export const modelMutationRequestSchema = z.object({
    * the read. Ablo rejects the write if the row moved in between, which is
    * what makes read → decide → write safe without a lock across the deciding.
    */
-  readAt: readSetWatermarkSchema.nullish(),
+  readAt: logPositionSchema.nullish(),
   /** Commit-lifetime dependencies checked with the single model operation. */
   reads: readDependencyListSchema.nullish(),
   /** Durable dependencies registered with the single model operation. */