@abloatai/ablo 0.35.0 → 0.37.0

package/dist/index.d.ts

@@ -1,112 +1,3 @@
-/**
- * @abloatai/ablo — the collaboration layer for AI agents and people.
- *
- * ```ts
- * import Ablo from '@abloatai/ablo';
- *
- * const ablo = Ablo({ schema, apiKey: process.env.ABLO_API_KEY });
- * const report = await ablo.weatherReports.retrieve({ id: 'report_stockholm' });
- * await ablo.weatherReports.update({
- *   id: 'report_stockholm',
- *   data: { status: 'ready' },
- * });
- *
- * type Entry = Ablo.Peer;
- * ```
- *
- * `Ablo({ schema, apiKey })` returns typed model clients. Server-side agents,
- * MCP route handlers, and workers select `transport: 'http'`; both transports
- * keep the same `ablo.<model>` application surface.
- *
- * The whole package reaches you through one name: `Ablo` is at once a factory
- * function, a type, and a namespace. You call model clients with dot access on
- * the instance (`ablo.reports.retrieve(...)`) and reach every supporting type
- * through the namespace (`Ablo.Peer`, `Ablo.Claim`).
- *
- * Related surfaces live on their own import subpaths:
- *   @abloatai/ablo/schema   — defineSchema, model, z (Zod)
- *   @abloatai/ablo/react    — <AbloProvider>, useQuery, useMutate
- *   @abloatai/ablo/testing  — test harnesses and fixtures
- *
- * Reads come in two flavors, distinguished by where the data is fetched from.
- * `ablo.<model>.retrieve({ id })` and `.list({ where })` are asynchronous reads
- * that consult the local cache first and fall back to the network, de-duplicating
- * concurrent requests for the same row. They are the default, and the right
- * choice for stateless callers whose local graph starts empty.
- * `ablo.<model>.local.retrieve(id)`, `.local.list(...)`, and `.local.count(...)` are synchronous
- * snapshots of the already-loaded local graph with no network round-trip — use
- * them in reactive React selectors (`useAblo((ablo) => ablo.<model>.get(id))`)
- * once the graph is warm.
- *
- * What to import, in short:
- *   • `Ablo` (the default export), `AbloOptions`, and the `Model*Params` option
- *     bags cover what most applications and agents ever need.
- *   • the `Ablo*Error` classes let you discriminate failures in catch blocks.
- *
- * A handful of exports are for advanced use and are marked "Advanced" at their
- * declaration below, each with the one situation it is for:
- *   • `dataSource`                 — when your own database stays canonical.
- *   • `defaultPolicy`              — when you customize conflict resolution.
- *   • `defineMutators` / `createTransaction` — when you write custom mutators.
- * If you don't recognize one of these, you don't need it.
- */
-export { Ablo } from './client/Ablo.js';
-export { humans } from './client/humans.js';
-export type { HumansSurface } from './client/humans.js';
-export type { AbloCoreClient } from './client/coreClient.js';
-export type { AbloPlugin, PipelineStage, TransportCapabilities } from './transaction/plugin.js';
-export type { MutationExecutor } from './interfaces/index.js';
-export type { ModelUpdater, ContentionOptions } from './transaction/resources/functionalUpdate.js';
-export { DEFAULT_CONTENTION_RETRIES } from './transaction/resources/functionalUpdate.js';
-export type { AbloReads } from './client/abloClient.js';
-export { type AbloHttpClientOptions, type AbloHttpClient, type HttpModelClient, } from './transaction/transport/httpClient.js';
-export { ABLO_DEFAULT_BASE_URL, ABLO_HOSTED_API_DOMAIN, ABLO_HOSTED_HTTP_BASE_URL, normalizeAbloHostedBaseUrl, } from './transaction/auth/apiKey.js';
-export type { AbloOptions } from './client/Ablo.js';
-export type { LocalCountOptions, LocalReadOptions, ModelListScope, ServerReadOptions, ModelRetrieveParams, ModelCreateParams, ModelUpdateParams, ModelDeleteParams, } from './client/resourceTypes.js';
-/**
- * @deprecated Use `Ablo.Claim.Held`. This compatibility export remains until
- * the next major release because it was explicitly documented in 0.20.1.
- */
-export type { HeldClaim } from './client/resourceTypes.js';
-/** The resolved value of the row-free `ablo.<model>.claim(id)` overload — a
- *  held lease on a key whose row Ablo does not hold (a {@link HeldClaim} with
- *  no `.data`). */
-export type { HeldLease } from './client/resourceTypes.js';
-export type { AbloPersistence } from './transaction/persistence.js';
-export { durableWritesConfigSchema, durableWriteStoreSchema, pendingWriteSchema, } from './transactions/mutations/durableWriteStore.js';
-export type { DurableWritesConfig, DurableWriteStore, PendingWrite, } from './transactions/mutations/durableWriteStore.js';
-export { durableCommitEnvelopeSchema, } from './transaction/transactions/settlement/commitEnvelope.js';
-export type { CommitOutboxScope, DurableCommitEnvelope, } from './transaction/transactions/settlement/commitEnvelope.js';
-export { durableHttpCommitEnvelopeSchema, } from './transaction/transactions/settlement/httpCommitEnvelope.js';
-export type { DurableHttpCommitEnvelope, } from './transaction/transactions/settlement/httpCommitEnvelope.js';
-import { Ablo } from './client/Ablo.js';
-export default Ablo;
-export { dataSource, sourceEventForOperation, signAbloSourceRequest, verifyAbloSourceRequest, } from './source/index.js';
-export { createSourceConnector, type SourceConnector, type SourceConnectorOptions, type ConnectorStatus, } from './source/connector.js';
-export { defaultPolicy, capabilityPreemptPolicy, interpretConflictAxis } from './policy/index.js';
-export { AbloSessionError, SyncSessionError, AbloError, AbloAuthenticationError, AbloPermissionError, AbloRateLimitError, AbloIdempotencyError, AbloConnectionError, AbloValidationError, AbloNotFoundError, AbloServerError, AbloStaleContextError, AbloClaimedError, AbloContentionError, CapabilityError, translateHttpError, hasWireCode, errorFromWire, toAbloError, ERROR_CODES, ERROR_CONTRACT_VERSION, errorCodeSpec, isRetryableCode, classifyRecovery, recoveryClassSchema, RECOVERY_CLASSES, } from './transaction/errors.js';
-export type { RequiredCapability } from './transaction/errors.js';
-export type { ErrorCode, WireErrorCode, ErrorCategory, ErrorCodeSpec, RecoveryClass } from './transaction/errors.js';
-export { errorEnvelope, statusForType } from './transaction/wire/errorEnvelope.js';
-export type { ErrorEnvelope } from './transaction/wire/errorEnvelope.js';
-export { WS_BEARER_SUBPROTOCOL_PREFIX, WS_SYNC_SUBPROTOCOL } from './transaction/auth/credentialSource.js';
-export { ENVIRONMENTS, environmentSchema, normalizeEnvironment, environmentFromKeyPrefix, environmentToKeyPrefix, isSandboxEnvironment, } from './transaction/environment.js';
-export type { Environment, KeyPrefixEnvironment } from './transaction/environment.js';
-export { writeOptionsSchema, onStaleModeSchema, assertWriteOptions, } from './transaction/resources/writeOptionsSchema.js';
-export type { WriteOptionsInput } from './transaction/resources/writeOptionsSchema.js';
-export type { OnStaleMode } from './transaction/coordination/schema.js';
-export type { WriteOptions, MutationOptions } from './interfaces/index.js';
-export { staleNotificationSchema, readDependencySchema } from './transaction/coordination/schema.js';
-export type { StaleNotification, ReadDependency } from './transaction/coordination/schema.js';
-export { ClaimLog, formatClaim, formatConflict } from './coordination/ClaimLog.js';
-export type { ClaimLogEntry } from './coordination/ClaimLog.js';
-export type { ClaimEvent, ConflictEvent, SyncObservabilityProvider, } from './interfaces/index.js';
-export { noopObservability } from './RuntimeContext.js';
-export { IDBOpenTimeoutError, isStorageOpenTimeout } from './core/openIDBWithTimeout.js';
-export type { CommitLatencySample } from './transactions/mutations/commitLatency.js';
-export { PUBLIC_MODEL_VERBS, PUBLIC_LIST_OPTION_KEYS, PUBLIC_ABLO_OPTION_KEYS, } from './surface.js';
-export type { ModelVerb, ListOptionKey, AbloOptionKey } from './surface.js';
-export type { Register, DefaultSyncShape } from './transaction/types/global.js';
-export { defineMutators } from './mutators/defineMutators.js';
-export { createTransaction, type Transaction } from './mutators/Transaction.js';
-export { deepEqual, stableStringify } from './transaction/utils/json.js';
+export * from '@abloatai/transaction';
+export { Ablo as default } from '@abloatai/transaction';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -1,161 +1,3 @@
-/**
- * @abloatai/ablo — the collaboration layer for AI agents and people.
- *
- * ```ts
- * import Ablo from '@abloatai/ablo';
- *
- * const ablo = Ablo({ schema, apiKey: process.env.ABLO_API_KEY });
- * const report = await ablo.weatherReports.retrieve({ id: 'report_stockholm' });
- * await ablo.weatherReports.update({
- *   id: 'report_stockholm',
- *   data: { status: 'ready' },
- * });
- *
- * type Entry = Ablo.Peer;
- * ```
- *
- * `Ablo({ schema, apiKey })` returns typed model clients. Server-side agents,
- * MCP route handlers, and workers select `transport: 'http'`; both transports
- * keep the same `ablo.<model>` application surface.
- *
- * The whole package reaches you through one name: `Ablo` is at once a factory
- * function, a type, and a namespace. You call model clients with dot access on
- * the instance (`ablo.reports.retrieve(...)`) and reach every supporting type
- * through the namespace (`Ablo.Peer`, `Ablo.Claim`).
- *
- * Related surfaces live on their own import subpaths:
- *   @abloatai/ablo/schema   — defineSchema, model, z (Zod)
- *   @abloatai/ablo/react    — <AbloProvider>, useQuery, useMutate
- *   @abloatai/ablo/testing  — test harnesses and fixtures
- *
- * Reads come in two flavors, distinguished by where the data is fetched from.
- * `ablo.<model>.retrieve({ id })` and `.list({ where })` are asynchronous reads
- * that consult the local cache first and fall back to the network, de-duplicating
- * concurrent requests for the same row. They are the default, and the right
- * choice for stateless callers whose local graph starts empty.
- * `ablo.<model>.local.retrieve(id)`, `.local.list(...)`, and `.local.count(...)` are synchronous
- * snapshots of the already-loaded local graph with no network round-trip — use
- * them in reactive React selectors (`useAblo((ablo) => ablo.<model>.get(id))`)
- * once the graph is warm.
- *
- * What to import, in short:
- *   • `Ablo` (the default export), `AbloOptions`, and the `Model*Params` option
- *     bags cover what most applications and agents ever need.
- *   • the `Ablo*Error` classes let you discriminate failures in catch blocks.
- *
- * A handful of exports are for advanced use and are marked "Advanced" at their
- * declaration below, each with the one situation it is for:
- *   • `dataSource`                 — when your own database stays canonical.
- *   • `defaultPolicy`              — when you customize conflict resolution.
- *   • `defineMutators` / `createTransaction` — when you write custom mutators.
- * If you don't recognize one of these, you don't need it.
- */
-// ── Consumer API ──────────────────────────────────────────────────────────
-// These are the only symbols external consumers should need from this path.
-// Everything else is in a subpath.
-// The primary surface. `Ablo` is a function, a type, and a namespace sharing
-// one name. It is the default export, so `import Ablo from '@abloatai/ablo'`
-// works, and a named export, so `import { Ablo }` compiles too.
-export { Ablo } from './client/Ablo.js';
-// The reactive materialiser as a declared capability (ADR 0016): installed by
-// default on the socket client, named explicitly when the list is written out.
-// `AbloPlugin` is the one uniform shape every capability declares.
-export { humans } from './client/humans.js';
-export { DEFAULT_CONTENTION_RETRIES } from './transaction/resources/functionalUpdate.js';
-// The stateless HTTP client is constructed through `Ablo({ transport: 'http' })`.
-// There is no separate constructor to import; annotate values with the
-// `AbloHttpClient` type, which is the return type of that call.
-export {} from './transaction/transport/httpClient.js';
-export { ABLO_DEFAULT_BASE_URL, ABLO_HOSTED_API_DOMAIN, ABLO_HOSTED_HTTP_BASE_URL, normalizeAbloHostedBaseUrl, } from './transaction/auth/apiKey.js';
-export { durableWritesConfigSchema, durableWriteStoreSchema, pendingWriteSchema, } from './transactions/mutations/durableWriteStore.js';
-export { durableCommitEnvelopeSchema, } from './transaction/transactions/settlement/commitEnvelope.js';
-export { durableHttpCommitEnvelopeSchema, } from './transaction/transactions/settlement/httpCommitEnvelope.js';
-// Participant types live under `Ablo.Participant.*` —
-// `Ablo.Participant.Joined`, `Ablo.Participant.Manager`,
-// `Ablo.Participant.JoinOptions`, etc. Same dot-access shape as
-// `Ablo.Peer`, `Ablo.Claim`. No flat re-exports.
-import { Ablo } from './client/Ablo.js';
-export default Ablo;
-// Advanced, and rarely imported. The storage adapter for Data Source mode,
-// where Ablo coordinates state while the canonical rows stay in your own
-// database. The default is Ablo-managed storage; reach for this only when you
-// have deliberately chosen to keep your database canonical. The matching types
-// live under `Ablo.Source.*` (`Ablo.Source.Operation`, `Ablo.Source.Commit.Params`).
-export { dataSource, sourceEventForOperation, signAbloSourceRequest, verifyAbloSourceRequest, } from './source/index.js';
-// Serves the Data Source `commit`, `load`, and `list` operations over an
-// outbound WebSocket, so a database with no public inbound URL (running on a
-// developer's machine or inside a locked-down network) can still be reached by
-// dialing out to Ablo rather than accepting an inbound connection.
-export { createSourceConnector, } from './source/connector.js';
-// Schema DSL is intentionally published from `@abloatai/ablo/schema`.
-// Keeping it out of the root import preserves one clean runtime surface:
-// `import Ablo from '@abloatai/ablo'`.
-// Advanced, and rarely imported. The default conflict policy rejects writes
-// premised on stale data and is already applied on the server, so import
-// `defaultPolicy` only to build a custom policy on top of it. Leave it be and
-// stale writes are rejected safely. The matching types live under `Ablo.Conflict.*`.
-export { defaultPolicy, capabilityPreemptPolicy, interpretConflictAxis } from './policy/index.js';
-// The typed error hierarchy. One import brings in every class you need to
-// tell failures apart — by `e instanceof AbloX` or `e.type === 'AbloX'` — along
-// with the helper that translates an HTTP response into the right class.
-export { AbloSessionError, 
-// Deprecated alias, removed in 0.36.0. The barrel keeps re-exporting it until
-// then so consumers don't lose the name a version early.
-// eslint-disable-next-line @typescript-eslint/no-deprecated
-SyncSessionError, AbloError, AbloAuthenticationError, AbloPermissionError, AbloRateLimitError, AbloIdempotencyError, AbloConnectionError, AbloValidationError, AbloNotFoundError, AbloServerError, AbloStaleContextError, AbloClaimedError, AbloContentionError, CapabilityError, translateHttpError, hasWireCode, errorFromWire, toAbloError, ERROR_CODES, ERROR_CONTRACT_VERSION, errorCodeSpec, isRetryableCode, classifyRecovery, recoveryClassSchema, RECOVERY_CLASSES, } from './transaction/errors.js';
-// The wire contract for errors, with no dependencies: the JSON envelope shape
-// plus the table mapping each AbloError subclass to an HTTP status. A server
-// that returns Ablo errors can assert against these so its responses never
-// drift from what the client expects.
-export { errorEnvelope, statusForType } from './transaction/wire/errorEnvelope.js';
-export { WS_BEARER_SUBPROTOCOL_PREFIX, WS_SYNC_SUBPROTOCOL } from './transaction/auth/credentialSource.js';
-export { ENVIRONMENTS, environmentSchema, normalizeEnvironment, environmentFromKeyPrefix, environmentToKeyPrefix, isSandboxEnvironment, } from './transaction/environment.js';
-// The write-options contract: the single Zod schema for the option bag every
-// write accepts (`ablo.<model>.create/update/delete`, `commits.create`, and the
-// HTTP model routes). The SDK validates against it at each boundary, and it is
-// exported so you can validate or assemble options before a call — for example,
-// as the input schema of an agent tool. It is the runtime counterpart of the
-// `MutationOptions` type.
-export { writeOptionsSchema, onStaleModeSchema, assertWriteOptions, } from './transaction/resources/writeOptionsSchema.js';
-// The value handed back to a writer whose change hit a stale-context conflict
-// under `onStale: 'notify'`. Instead of throwing, the commit succeeds and
-// returns this notification so the caller can reconcile against the current
-// value and retry rather than discard its work.
-export { staleNotificationSchema, readDependencySchema } from './transaction/coordination/schema.js';
-// Collects claim events and stale-write collisions into an ordered list you can
-// print to inspect coordination, or read through `collisions()` to assert on in
-// tests. Pass `new ClaimLog()` as `Ablo({ observability })`.
-export { ClaimLog, formatClaim, formatConflict } from './coordination/ClaimLog.js';
-// Spread this to provide a custom `observability` that overrides only the hooks
-// you care about (e.g. captureClaim) and no-ops the rest.
-export { noopObservability } from './RuntimeContext.js';
-// Detects a stuck local store: use these to recognize when the browser's
-// IndexedDB backing store fails to open in time, so your app can show a
-// recovery screen instead of hanging.
-export { IDBOpenTimeoutError, isStorageOpenTimeout } from './core/openIDBWithTimeout.js';
-// A machine-readable manifest of the SDK's public verb and option names, bound
-// at compile time to the real types so the lists can never name a method or
-// option the API doesn't have. Useful for generating documentation or tooling
-// that needs to enumerate the surface.
-export { PUBLIC_MODEL_VERBS, PUBLIC_LIST_OPTION_KEYS, PUBLIC_ABLO_OPTION_KEYS, } from './surface.js';
-// Advanced, and rarely imported. Custom mutators. Ordinary writes go through
-// `ablo.<model>.create/update/delete`; reach for `defineMutators` only when you
-// need a named, multi-step mutation with its own undo behavior. The matching
-// types live under the `Ablo` namespace:
-//   Ablo.Mutator.Fn, Ablo.Mutator.Transaction
-//   Ablo.Mutator.UndoEntry, Ablo.Mutator.UndoScope, Ablo.Mutator.InverseOp
-export { defineMutators } from './mutators/defineMutators.js';
-// `createTransaction` lets callers outside React — server-side workers, agent
-// runtimes — run custom mutators without the `useMutators` hook. Build a
-// transaction from the client's schema, store, and organization id, then pass
-// it to your mutator function as `{ tx, args }`.
-export { createTransaction } from './mutators/Transaction.js';
-// Undo runtime is intentionally not part of the public root surface. App code
-// uses `useUndoScope` from `@abloatai/ablo/react`.
-// JSON comparison helpers. A `field.json()` value stored in a Postgres `jsonb`
-// column can come back with its object keys reordered, because jsonb does not
-// preserve key order. A naive `JSON.stringify(a) === JSON.stringify(b)` check
-// then reports a difference that isn't real — a common trap when reconciling an
-// Ablo row against external editor state. These compare independent of key
-// order, so use them instead.
-export { deepEqual, stableStringify } from './transaction/utils/json.js';
+export * from '@abloatai/transaction';
+export { Ablo as default } from '@abloatai/transaction';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/react.d.ts

@@ -0,0 +1,4 @@
+export { Ablo, humans } from '@abloatai/humans';
+export type { AbloOptions, AbloReads, HumansSurface } from '@abloatai/humans';
+export * from '@abloatai/humans/react';
+//# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC9E,cAAc,wBAAwB,CAAC"}

package/dist/react.js

@@ -0,0 +1,3 @@
+export { Ablo, humans } from '@abloatai/humans';
+export * from '@abloatai/humans/react';
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAEhD,cAAc,wBAAwB,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,2 @@
+export * from '@abloatai/transaction/schema';
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC"}

package/dist/schema.js

@@ -0,0 +1,2 @@
+export * from '@abloatai/transaction/schema';
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+export * from '@abloatai/transaction/server';
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC"}

package/dist/server.js

@@ -0,0 +1,2 @@
+export * from '@abloatai/transaction/server';
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC"}

package/dist/source-conformance.d.ts

@@ -0,0 +1,2 @@
+export * from '@abloatai/transaction/source/conformance';
+//# sourceMappingURL=source-conformance.d.ts.map

package/dist/source-conformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-conformance.d.ts","sourceRoot":"","sources":["../src/source-conformance.ts"],"names":[],"mappings":"AAAA,cAAc,0CAA0C,CAAC"}

package/dist/source-conformance.js

@@ -0,0 +1,2 @@
+export * from '@abloatai/transaction/source/conformance';
+//# sourceMappingURL=source-conformance.js.map

package/dist/source-conformance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-conformance.js","sourceRoot":"","sources":["../src/source-conformance.ts"],"names":[],"mappings":"AAAA,cAAc,0CAA0C,CAAC"}

package/dist/source-drizzle.d.ts

@@ -0,0 +1,2 @@
+export * from '@abloatai/transaction/source/drizzle';
+//# sourceMappingURL=source-drizzle.d.ts.map

package/dist/source-drizzle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-drizzle.d.ts","sourceRoot":"","sources":["../src/source-drizzle.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAC"}

package/dist/source-drizzle.js

@@ -0,0 +1,2 @@
+export * from '@abloatai/transaction/source/drizzle';
+//# sourceMappingURL=source-drizzle.js.map

package/dist/source-drizzle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-drizzle.js","sourceRoot":"","sources":["../src/source-drizzle.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAC"}

package/dist/source-kysely.d.ts

@@ -0,0 +1,2 @@
+export * from '@abloatai/transaction/source/kysely';
+//# sourceMappingURL=source-kysely.d.ts.map

package/dist/source-kysely.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-kysely.d.ts","sourceRoot":"","sources":["../src/source-kysely.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC"}

package/dist/source-kysely.js

@@ -0,0 +1,2 @@
+export * from '@abloatai/transaction/source/kysely';
+//# sourceMappingURL=source-kysely.js.map

package/dist/source-kysely.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-kysely.js","sourceRoot":"","sources":["../src/source-kysely.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC"}

package/dist/source-next.d.ts

@@ -0,0 +1,2 @@
+export * from '@abloatai/transaction/source/next';
+//# sourceMappingURL=source-next.d.ts.map

package/dist/source-next.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-next.d.ts","sourceRoot":"","sources":["../src/source-next.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAC"}

package/dist/source-next.js

@@ -0,0 +1,2 @@
+export * from '@abloatai/transaction/source/next';
+//# sourceMappingURL=source-next.js.map

package/dist/source-next.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-next.js","sourceRoot":"","sources":["../src/source-next.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAC"}

package/dist/source.d.ts

@@ -0,0 +1,2 @@
+export * from '@abloatai/transaction/source';
+//# sourceMappingURL=source.d.ts.map

package/dist/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../src/source.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC"}

package/dist/source.js

@@ -0,0 +1,2 @@
+export * from '@abloatai/transaction/source';
+//# sourceMappingURL=source.js.map

package/dist/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../src/source.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC"}

package/dist/wire.d.ts

@@ -0,0 +1,2 @@
+export * from '@abloatai/transaction/wire';
+//# sourceMappingURL=wire.d.ts.map

package/dist/wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../src/wire.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC"}

package/dist/wire.js

@@ -0,0 +1,2 @@
+export * from '@abloatai/transaction/wire';
+//# sourceMappingURL=wire.js.map

package/dist/wire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.js","sourceRoot":"","sources":["../src/wire.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC"}

package/docs/agents.md

@@ -34,7 +34,7 @@ const ablo = Ablo({ schema, apiKey: process.env.ABLO_API_KEY, transport: "http"
 // `retrieve` resolves to the row, or `undefined` when none matches.
 const open = await ablo.tasks.list({ where: { status: "todo" } });
 
-const task = await ablo.tasks.retrieve({ id: open[0].id });
+const task = await ablo.tasks.get({ id: open[0].id });
 if (!task) throw new Error("task not found");
 
 console.log(task.title);
@@ -47,7 +47,7 @@ and `claim`. It does **not** expose the stateful-only surface (`get` /
 live connection, so with `transport: 'http'` the return type narrows and they
 are a *compile error*, not a runtime surprise.
 
-## Coordination — claim, queue, reorder
+## Coordination: claim, queue, reorder
 
 The differentiator. A claim is a **durable lease + FIFO wait-line** on a row —
 "who's working on this, who's waiting" — and it's request/response, so an agent

package/docs/api-keys.md

@@ -21,9 +21,9 @@ Pick your row:
 
 | Where your code runs | What to pass | Example |
 |---|---|---|
-| **Server / worker / CLI** (can hold a secret) | your secret `sk_` — it defaults to `ABLO_API_KEY`, so usually pass **nothing** | `Ablo({ schema })` |
-| **Browser — read-only** | a publishable `pk_` (safe to ship, like a Stripe `pk_`) | `Ablo({ schema, apiKey: process.env.NEXT_PUBLIC_ABLO_PUBLISHABLE_KEY })` |
-| **Browser — writing as the signed-in user** | `authEndpoint` — the route on your own backend that mints a short-lived per-user token | `Ablo({ schema, authEndpoint: '/api/ablo-session' })` |
+| **Server / worker / CLI** (can hold a secret) | your secret `sk_`: it defaults to `ABLO_API_KEY`, so usually pass **nothing** | `Ablo({ schema })` |
+| **Browser: read-only** | a publishable `pk_` (safe to ship, like a Stripe `pk_`) | `Ablo({ schema, apiKey: process.env.NEXT_PUBLIC_ABLO_PUBLISHABLE_KEY })` |
+| **Browser: writing as the signed-in user** | `authEndpoint`: the route on your own backend that mints a short-lived per-user token | `Ablo({ schema, authEndpoint: '/api/ablo-session' })` |
 
 That's the whole story: one knob, filled by audience.
 
@@ -31,10 +31,10 @@ That's the whole story: one knob, filled by audience.
 
 | Stripe | Ablo | Where it goes |
 |---|---|---|
-| publishable `pk_` (client-safe) | `pk_` | browser — read-only |
-| secret `sk_` (server, full) | `sk_` | server — full authority |
-| restricted `rk_` (granular) | `rk_` | scoped agent sessions (`sessions.create({ agent, can })`) |
-| ephemeral key (client, customer-scoped) | `ek_` | per-user browser sessions (`sessions.create({ user })`) |
+| publishable `pk_` (client-safe) | `pk_` | browser: read-only |
+| secret `sk_` (server, full) | `sk_` | server: full authority |
+| restricted `rk_` (granular) | `rk_` | scoped agents (`agents.create({ can })`) |
+| ephemeral key (client, customer-scoped) | `ek_` | per-user browser sessions (`sessions.create({ user, can })`) |
 
 Mode lives in the prefix too — `sk_test_` / `sk_live_` — exactly like Stripe. The
 `apiKey` resolver fetching an `ek_` is Ablo's ephemeral-key flow: server mints, client holds.
@@ -42,7 +42,7 @@ Mode lives in the prefix too — `sk_test_` / `sk_live_` — exactly like Stripe
 **Why a function for browser writes?** Anything you ship to a browser must be public, and a
 public `pk_` is **read-only** — it can't carry one specific user's write authority. So when
 the browser writes *as the logged-in user*, your backend (which holds the secret `sk_` and
-knows who's signed in) mints a short-lived per-user token with `sessions.create({ user })`,
+knows who's signed in) mints a short-lived per-user token with `sessions.create({ user, can })`,
 and the browser's `apiKey` function fetches it. You don't manage refresh — the SDK calls the
 function once before connecting and then keeps the token fresh (re-mint before expiry, and on
 tab-focus / network-online / device-wake). This is the Stripe ephemeral-key / Supabase
@@ -58,10 +58,11 @@ knobs, and you set exactly one.
 
 | Mint | Call | Result |
 |---|---|---|
-| Human end-user session | `await server.sessions.create({ user: { id } })` | `ek_` (full user authority) |
-| Scoped delegated agent | `await server.sessions.create({ agent: { id }, can: { Task: ['update'] } })` | `rk_` (scoped to `can`) |
+| Human end-user session | `await server.sessions.create({ user: { id }, can: { tasks: ['read'] } })` | `ek_` (scoped to `can`) |
+| Ready agent client | `await server.agents.create({ can: { tasks: ['update'] } })` | Auto-refreshing client scoped to `can` |
+| Raw delegated agent token | `await server.sessions.create({ agent: { id }, can: { tasks: ['update'] } })` | `rk_` for another runtime |
 
-The principal kind comes from *which* shape you pass — `{ user }` → `user`, `{ agent, can }` → `agent`.
+The principal kind comes from *which* shape you pass — `{ user, can }` → `user`, `{ agent, can }` → `agent`.
 
 ## Server-Side API Keys
 
@@ -74,7 +75,7 @@ Use API keys from trusted (server-side) runtimes:
 
 Never ship a secret API key to a browser bundle.
 
-## Publishable key (`pk_`) — browser-safe, read-only
+## Publishable key (`pk_`): browser-safe, read-only
 
 For a read-only browser experience, a publishable key is safe to ship in the
 bundle. Like a Stripe `pk_` or a Supabase anon key, it is long-lived,