@abloatai/transaction 0.56.0 → 0.58.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abloatai/transaction",
-  "version": "0.56.0",
+  "version": "0.58.0",
   "description": "The headless Ablo transaction client and canonical contracts for reads, commits, confirmation, claims, and durable observation.",
   "license": "Apache-2.0",
   "type": "module",
@@ -42,11 +42,41 @@
       "import": "./dist/branches.js",
       "default": "./dist/branches.js"
     },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.js",
+      "default": "./dist/client/index.js"
+    },
     "./coordination": {
       "types": "./dist/coordination/index.d.ts",
       "import": "./dist/coordination/index.js",
       "default": "./dist/coordination/index.js"
     },
+    "./coordination/*": {
+      "types": "./dist/coordination/*.d.ts",
+      "import": "./dist/coordination/*.js",
+      "default": "./dist/coordination/*.js"
+    },
+    "./claims": {
+      "types": "./dist/claims/index.d.ts",
+      "import": "./dist/claims/index.js",
+      "default": "./dist/claims/index.js"
+    },
+    "./claims/*": {
+      "types": "./dist/claims/*.d.ts",
+      "import": "./dist/claims/*.js",
+      "default": "./dist/claims/*.js"
+    },
+    "./commit": {
+      "types": "./dist/commit/index.d.ts",
+      "import": "./dist/commit/index.js",
+      "default": "./dist/commit/index.js"
+    },
+    "./observation": {
+      "types": "./dist/observation/index.d.ts",
+      "import": "./dist/observation/index.js",
+      "default": "./dist/observation/index.js"
+    },
     "./wire": {
       "types": "./dist/wire/index.d.ts",
       "import": "./dist/wire/index.js",
@@ -62,6 +92,11 @@
       "import": "./dist/auth/index.js",
       "default": "./dist/auth/index.js"
     },
+    "./auth/*": {
+      "types": "./dist/auth/*.d.ts",
+      "import": "./dist/auth/*.js",
+      "default": "./dist/auth/*.js"
+    },
     "./keys": {
       "types": "./dist/keys/index.d.ts",
       "import": "./dist/keys/index.js",
@@ -82,10 +117,35 @@
       "import": "./dist/source/index.js",
       "default": "./dist/source/index.js"
     },
-    "./source/*": {
-      "types": "./dist/source/*.d.ts",
-      "import": "./dist/source/*.js",
-      "default": "./dist/source/*.js"
+    "./source/adapters": {
+      "types": "./dist/source/adapters/index.d.ts",
+      "import": "./dist/source/adapters/index.js",
+      "default": "./dist/source/adapters/index.js"
+    },
+    "./source/adapters/*": {
+      "types": "./dist/source/adapters/*.d.ts",
+      "import": "./dist/source/adapters/*.js",
+      "default": "./dist/source/adapters/*.js"
+    },
+    "./source/connector": {
+      "types": "./dist/source/connector/index.d.ts",
+      "import": "./dist/source/connector/index.js",
+      "default": "./dist/source/connector/index.js"
+    },
+    "./source/delivery": {
+      "types": "./dist/source/delivery/index.d.ts",
+      "import": "./dist/source/delivery/index.js",
+      "default": "./dist/source/delivery/index.js"
+    },
+    "./source/endpoint": {
+      "types": "./dist/source/endpoint/index.d.ts",
+      "import": "./dist/source/endpoint/index.js",
+      "default": "./dist/source/endpoint/index.js"
+    },
+    "./source/outbox": {
+      "types": "./dist/source/outbox/index.d.ts",
+      "import": "./dist/source/outbox/index.js",
+      "default": "./dist/source/outbox/index.js"
     },
     "./server": {
       "types": "./dist/server/index.d.ts",
@@ -97,6 +157,26 @@
       "import": "./dist/server/*.js",
       "default": "./dist/server/*.js"
     },
+    "./transport": {
+      "types": "./dist/transport/index.d.ts",
+      "import": "./dist/transport/index.js",
+      "default": "./dist/transport/index.js"
+    },
+    "./transport/connection": {
+      "types": "./dist/transport/connection/index.d.ts",
+      "import": "./dist/transport/connection/index.js",
+      "default": "./dist/transport/connection/index.js"
+    },
+    "./transport/http": {
+      "types": "./dist/transport/http/index.d.ts",
+      "import": "./dist/transport/http/index.js",
+      "default": "./dist/transport/http/index.js"
+    },
+    "./transport/websocket": {
+      "types": "./dist/transport/websocket/index.d.ts",
+      "import": "./dist/transport/websocket/index.js",
+      "default": "./dist/transport/websocket/index.js"
+    },
     "./batching": {
       "types": "./dist/batching/index.d.ts",
       "import": "./dist/batching/index.js",
@@ -142,10 +222,50 @@
       "import": "./dist/docs/*.js",
       "default": "./dist/docs/*.js"
     },
-    "./*": {
-      "types": "./dist/*.d.ts",
-      "import": "./dist/*.js",
-      "default": "./dist/*.js"
+    "./client/resources/*": {
+      "types": "./dist/client/resources/*.d.ts",
+      "import": "./dist/client/resources/*.js",
+      "default": "./dist/client/resources/*.js"
+    },
+    "./testing/fixtures/*": {
+      "types": "./dist/testing/fixtures/*.d.ts",
+      "import": "./dist/testing/fixtures/*.js",
+      "default": "./dist/testing/fixtures/*.js"
+    },
+    "./types/*": {
+      "types": "./dist/types/*.d.ts",
+      "import": "./dist/types/*.js",
+      "default": "./dist/types/*.js"
+    },
+    "./utils/*": {
+      "types": "./dist/utils/*.d.ts",
+      "import": "./dist/utils/*.js",
+      "default": "./dist/utils/*.js"
+    },
+    "./wire/*": {
+      "types": "./dist/wire/*.d.ts",
+      "import": "./dist/wire/*.js",
+      "default": "./dist/wire/*.js"
+    },
+    "./errors": {
+      "types": "./dist/errors.d.ts",
+      "import": "./dist/errors.js",
+      "default": "./dist/errors.js"
+    },
+    "./footprint": {
+      "types": "./dist/footprint.d.ts",
+      "import": "./dist/footprint.js",
+      "default": "./dist/footprint.js"
+    },
+    "./logger": {
+      "types": "./dist/logger.d.ts",
+      "import": "./dist/logger.js",
+      "default": "./dist/logger.js"
+    },
+    "./observability": {
+      "types": "./dist/observability.d.ts",
+      "import": "./dist/observability.js",
+      "default": "./dist/observability.js"
     }
   },
   "files": [
@@ -173,7 +293,7 @@
     "postpack": "node ../ablo/scripts/restore-source-condition.mjs",
     "pack:check": "node ../ablo/scripts/pack-check.mjs",
     "lint:pkg": "publint",
-    "test": "vitest run src/headlessClient.test.ts && jest",
+    "test": "vitest run src/client/headless.test.ts && jest",
     "typecheck": "tsc --noEmit && tsc -p typetests/tsconfig.json"
   },
   "dependencies": {

package/src/ai-sdk/modelTools.ts

@@ -13,13 +13,13 @@ import type {
   ClaimSkipParams,
   ModelCreateParams,
   ModelDeleteParams,
-  ModelRetrieveParams,
-} from '../resources/modelOperations.js';
+  ModelReadParams,
+} from '../client/resources/modelOperations.js';
 import type { HeldClaim } from '../types/streams.js';
 import type { ModelToolOptions } from './toolOptions.js';
 
 export interface ToolModel<T, CreateInput = Partial<T>, Fields = T> {
-  get(params: ModelRetrieveParams): Promise<T | undefined>;
+  read(params: ModelReadParams): Promise<T | undefined>;
   create(params: ModelCreateParams<T, CreateInput>): Promise<T>;
   delete(params: ModelDeleteParams<T, Fields>): Promise<void>;
   claim(
@@ -40,7 +40,7 @@ export type ReadToolResult<T> =
   | { readonly status: 'not_found'; readonly message: string };
 
 export function readTool<TInput, T>(
-  model: Pick<ToolModel<T>, 'get'>,
+  model: Pick<ToolModel<T>, 'read'>,
   options: ReadToolOptions<TInput, T>,
 ) {
   return tool<TInput, ReadToolResult<T>>({
@@ -54,7 +54,7 @@ export function readTool<TInput, T>(
     toModelOutput: options.toModelOutput,
     execute: async (input) => {
       const id = options.id(input);
-      const row = await model.get({ id });
+      const row = await model.read({ id });
       return row === undefined
         ? {
             status: 'not_found',

package/src/ai-sdk/updateTool.ts

@@ -40,17 +40,15 @@
  *   `ablo.<model>.update(id, current => apply(current, input))`. The runtime
  *   re-reads and re-applies `apply` on top of every concurrent write, backing off
  *   between rounds, so many agents accumulate into one row and the model never
- *   sees a conflict. This requires the model's agent conflict policy to be
- *   `reject` (the default, or `agentsReject()`). A model that declares
- *   `agentsNotify()` holds the losing write instead of rejecting it, which
- *   defeats the reconcile loop — there, use `'claim'` or `'queue'`, or change the
+ *   sees a conflict. Stale conditional writes always reject, which drives the
+ *   reconcile loop. For long or side-effecting work, use `'claim'` or `'queue'`; otherwise change the
  *   policy.
  *
  * - `'claim'` gives mutual exclusion. It takes a fail-fast claim; if another
  *   participant holds the row, it returns `{ status: 'claimed' }` and leaves the
  *   decision to retry up to the model. A visible signal serves the agent better
  *   than a hidden wait when it might spend its turn on something else. Works under
- *   any conflict policy.
+ *   the fixed foreign-claim rejection rule.
  *
  * - `'queue'` joins Ablo's server-owned FIFO queue. The model calls once and
  *   the tool waits for the canonical claim grant; it does not recreate queueing
@@ -63,8 +61,8 @@ import type {
   ClaimSkipParams,
   ClaimParams,
   ModelUpdateParams,
-} from '../resources/modelOperations.js';
-import type { ModelUpdater, FunctionalUpdateOptions } from '../resources/functionalUpdate.js';
+} from '../client/resources/modelOperations.js';
+import type { ModelUpdater, FunctionalUpdateOptions } from '../client/resources/functionalUpdate.js';
 import type { HeldClaim } from '../types/streams.js';
 import type { ModelToolOptions } from './toolOptions.js';
 

package/src/auth/capability.ts

@@ -308,6 +308,11 @@ export type CapabilityMintResponse = z.infer<typeof capabilityMintResponseSchema
 export const capabilityRequestSchema = z.object({
   participantKind: participantKindSchema,
   participantId: z.string().min(1).optional(),
+  onBehalfOf: z
+    .object({
+      user: z.object({ id: z.string().min(1) }),
+    })
+    .optional(),
   /**
    * Mint into another organization. Reserved for a platform secret carrying
    * `organization:act-as`; ordinary tenant keys may omit only.

package/src/auth/capabilityLifecycle.ts

@@ -9,7 +9,7 @@ import type {
   RotateSessionParams,
   SessionRevocation,
   SessionRotation,
-} from '../resources/httpResources.js';
+} from '../client/resources/httpResources.js';
 
 export const sessionRevocationResponseSchema = z.object({
   id: z.string().min(1),

package/src/auth/credentialPolicy.ts

@@ -16,7 +16,7 @@
  */
 
 import { AbloAuthenticationError } from '../errors.js';
-import type { exchangeApiKey, mintUserSessionKey, resolveIdentity } from './index.js';
+import type { exchangeApiKey, mintUserSessionKey, resolveIdentity } from './runtime.js';
 import {
   classifyCredentialKind,
   type CredentialKind,

package/src/auth/identity.ts

@@ -17,20 +17,20 @@
 
 import { AbloAuthenticationError } from '../errors.js';
 import type { ParticipantKind } from '../types/participant.js';
-import { exchangeApiKey } from '../auth/index.js';
-import { mintUserSessionKey } from '../auth/index.js';
-import { resolveIdentity } from '../auth/index.js';
+import { exchangeApiKey } from './runtime.js';
+import { mintUserSessionKey } from './runtime.js';
+import { resolveIdentity } from './runtime.js';
 import {
   createRefreshScheduler,
   type RefreshScheduler,
-} from '../auth/index.js';
+} from './runtime.js';
 import {
   resolveCredential,
   type ResolvedCredential,
-} from '../auth/credentialPolicy.js';
-import type { BootstrapScope } from '../auth/bootstrapScope.js';
+} from './credentialPolicy.js';
+import type { BootstrapScope } from './bootstrapScope.js';
 import type { Logger } from '../logger.js';
-import type { AuthCredentialSource } from '../auth/credentialSource.js';
+import type { AuthCredentialSource } from './credentialSource.js';
 import type { CredentialProvider } from './credentialResult.js';
 import { resolveApiKeyValue, resolveBootstrapBaseUrl } from './apiKey.js';
 import type { DeliveryPartitionRoute } from './deliveryPartition.js';