@abloatai/ablo 0.48.0 → 0.50.0

package/AGENTS.md

@@ -11,7 +11,7 @@ Don't hand-write the integration. Run the CLI; it generates the current-API sche
 - **Read the docs for THIS version:** `npx ablo docs` lists every page, `npx ablo docs <page>` prints one. They ship inside the installed package, so they describe the code in `node_modules` and work with no network. Read them instead of a docs URL — a website describes the newest release, so against a pinned version it will hand you a call your package doesn't have (`retrieve`/`list` replaced `get`/`getAll`/`getCount` in 0.35.0).
 - **Scaffold:** `npx ablo init --yes` — flag-driven, never prompts. Override defaults with `--framework <nextjs|vite|remix|vanilla>`, `--auth <apikey|…>`, `--no-agent`, `--no-pull`, `--no-install`, `--no-login`. (Plain `ablo init` needs a TTY and will **HANG** in an agent/CI run — always pass `--yes`.)
 - **Auth:** set `ABLO_API_KEY` in the environment. Do **NOT** run `ablo login` — it opens a browser device flow and blocks an agent.
-- **Connect your database — logical replication (the primary path):** `npx ablo connect` prints the setup SQL (`wal_level=logical`, a publication, a `REPLICATION` role); `npx ablo connect register` registers the source with Ablo in one step. Ablo **consumes your Postgres' logical-replication stream** — it never runs DDL on, writes to, owns, or migrates your database, and your application keeps the write path. Registration **is** the enable; there is no tier or flag to pick. (Ablo hosts only the transaction log + coordination, never your rows.)
+- **Connect your database — logical replication (the primary path):** `npx ablo connect apply --url <postgres-url>` provisions scoped roles and replication using the admin credential supplied for that command. Model writes then go through Ablo and land in your Postgres; its change stream confirms them. Ablo does not own your rows or run application-schema migrations. Your ORM remains responsible for tables, columns, and constraints.
 - **Fallback — signed Data Source endpoint** (DB can't grant a `REPLICATION` role): the generated `ablo/data-source.ts` exposes one route; Ablo sends signed requests and your app touches its own DB. **Only in this mode** does `npx ablo migrate` provision the adapter's bookkeeping tables (`ablo_outbox`, `ablo_idempotency`) plus your Ablo models — it does **not** touch your other tables. Keep your own migrations (drizzle-kit / prisma migrate) for auth and anything outside the Ablo schema.
 - **No database yet?** Run `npx ablo dev --no-watch --branch <name>` to create an isolated non-root branch and obtain its expiring `sk_` credential. The branch uses a throwaway hosted data plane; Production remains the protected root. There is no shared Sandbox mode.
 - **Adopt an existing DB schema:** `npx ablo pull prisma [path]` / `pull drizzle <module>` (lossless) or `pull` (live DB, lossy). Writes `ablo/schema.ts`.
@@ -21,7 +21,7 @@ Don't hand-write the integration. Run the CLI; it generates the current-API sche
 
 When you use the signed-endpoint fallback, the generated `ablo/data-source.ts` is the whole endpoint and needs no hand-editing: `dataSourceNext({ schema, apiKey, adapter: prismaDataSource(prisma, schema) })` (or `drizzleDataSource(db, schema)`). The adapter owns commit / idempotency / outbox.
 
-**Working on a real database?** Ablo never runs DDL, migrates, or drops on your database, and every model write is claim-checked and reversible in the log — so reads and `ablo.<model>.update(...)` are yours to run freely, while raw DDL (`ALTER TABLE …`) and a `--yes` cutover belong to a human. When you're unsure whether a write fits, `npx ablo check` reports the live column-by-column fit read-only, before anything runs. Full sorting rule: [Operating on Your Database](./docs/operating-on-your-database.md).
+**Working on a real database?** Plain model writes are last-write-wins when no active claim applies. Use a functional update, a held claim, or `readAt` when a result depends on an earlier value. Reads are safe to inspect; raw application DDL (`ALTER TABLE …`) and a `--yes` connection cutover belong to a human. When you're unsure whether a write fits, `npx ablo check` reports the live column-by-column fit read-only, before anything runs. Full sorting rule: [Operating on Your Database](./docs/operating-on-your-database.md).
 
 ## Rule
 

package/CHANGELOG.md

@@ -1,5 +1,127 @@
 # Changelog
 
+## 0.50.0
+
+### Context can travel from reads to a model and back to a write
+
+`context({ ablo, data })` brings together the information an action needs. It
+awaits the values the application selected, returns them as typed `ctx.data`,
+and carries exact Ablo rows into `ctx.reads` for the write that follows.
+
+```ts
+const ctx = await context({
+  ablo,
+  data: {
+    task: ablo.tasks.get({ id: taskId }),
+    documents: ablo.documents.list({ where: { taskId } }),
+    memory: loadMemories(taskId),
+  },
+});
+
+await ablo.tasks.update({
+  id: taskId,
+  data: result,
+  reads: ctx.reads,
+});
+```
+
+If an included Ablo row moved while the caller was thinking, the write is
+refused. External memory, retrieval, extraction, and conversation values pass
+through without acquiring that guarantee. `ctx.sources` keeps the difference
+visible, including a `mixed` result when one value contains both kinds.
+
+The optional `contextMessage()` formatter produces a user message for AI SDK.
+Ablo does not take over the model loop, history, token policy, search, or memory.
+The helper is a standalone `@abloatai/ablo/context` export, so `context` remains
+available as a schema model name.
+
+## 0.49.0
+
+### An agent can tell Ablo what it read before it writes
+
+An agent reads a row, spends a model call deciding what to do, and then writes.
+Another agent can change that row while the model is still thinking, and the
+write lands anyway, on top of a decision that is no longer true. Pass the rows
+the decision was based on:
+
+```ts
+const task = await ablo.tasks.get({ id: taskId });
+await ablo.tasks.update({
+  id: task.id,
+  data: { status: 'done', result: `Completed: ${task.title}` },
+  reads: [task],
+});
+```
+
+If either row moved while the agent was thinking, the write is refused instead
+of overwriting. The rows carry that evidence themselves, so there is nothing to
+set up around your agent and no wrapper to run it inside. One row or several,
+the same row you are writing or a different one, all use `reads`. Rows an agent
+read without passing stay out of it, so `reads` says what the decision rested on
+rather than everything the agent happened to look at.
+
+`idempotencyKey` stays a separate option. It gives a write one stable identity if
+the agent retries, which is a different question from what the write assumed.
+
+### A claim holds while an agent thinks
+
+Agents that take minutes per turn can now hold work safely. A claim waits its
+turn or skips, expires on its own, and keeps itself alive with a heartbeat while
+the agent works.
+
+If an agent loses its claim during a model call, its final write is refused. Two
+agents cannot both believe they own the same task and both write, and a slow
+agent cannot land its answer on top of whoever picked the work up after it. Ablo
+decides who holds the claim, so an agent cannot assert one it does not have.
+
+### An agent can read back what it committed
+
+Ask what happened to a write, using the same key the agent wrote with:
+
+```ts
+const record = await ablo.commits.get({ id: commitId });
+```
+
+The answer says who committed, what they intended, whether it is confirmed, and
+which claim protected it. `commits.list` walks the history a page at a time, so
+one agent can review what another already did before repeating it.
+
+What an agent sent is not kept. Prompts, reasoning, and your customers' row
+values are removed before the record is stored, so reading history back never
+replays an agent's inputs. Records are kept for 90 days, and permanently for a
+database you connected.
+
+### An agent can check what its key allows before it acts
+
+An agent holding a key can now ask what that key permits and get the answer from
+Ablo, whether it keeps a connection open or calls over HTTP for a single turn.
+An agent that mints a narrower key for a sub-task can confirm what it handed
+over.
+
+### A refused action says which permission was missing
+
+When Ablo refuses, the error names the permission the agent needed. An agent can
+report exactly what it lacked, or request it, instead of retrying a call that
+will never succeed.
+
+### Models named in camelCase resolve when writing to your own database
+
+A model whose key mixes capital letters did not match its declared name when the
+write went to your database directly, so those writes could not find their
+target. They resolve now.
+
+### `ablo connect apply` says when a database is already connected
+
+Connecting a database that another project already owns reported a missing table
+mapping, which described a symptom rather than the reason the command could not
+continue. It now says the database is already connected. Nothing is written
+while it checks, and a project with no models still gets its preflight.
+
+**Action required.** Install this version rather than a tarball or a Git
+dependency. This release pairs the SDK with the engine running behind
+`api.abloatai.com`, which is already serving it, so there is nothing to
+coordinate on your side.
+
 ## 0.48.0
 
 ### A branch is unbound until you connect a database to it
@@ -46,6 +168,26 @@ temporary alias can go:
 DROP PUBLICATION IF EXISTS "ablo_publication";
 ```
 
+### `ablo dev --local` connects a branch to the database on your machine
+
+The rule above raises a fair question: if a branch is unbound until a database
+is connected, what connects one during development? `--local` does.
+
+```bash
+npx ablo dev --local
+```
+
+It registers a connector-only endpoint for that exact branch and opens a
+long-lived secure connector. Your database stays where it is: Ablo receives an
+endpoint descriptor and a signing key, never a connection string, and reaches
+your source back through the connector rather than dialling it. `DATABASE_URL`
+is read from `.env.local` into the handler running on your machine and goes no
+further.
+
+The branch is then connected like any other, so schema pushes, reads and writes
+behave the way they will in production. Because the connector is long-lived,
+`--local` cannot be combined with `--no-watch`.
+
 ### Renamed
 
 `FootprintPlane` is now `DataSourceIdentity`, with the same three fields. The
@@ -433,7 +575,7 @@ through the same transaction API as every other caller.
 
 The integrations keep each product in its proper role: Temporal and Inngest
 own durable execution, scheduling, retries, and workflow history; Ablo owns
-shared-data authority, claims, conflicts, idempotency, settlement, and ordered
+shared-data authority, claims, conflicts, idempotency, confirmation, and ordered
 observation. Workflow code does not open WebSockets or hold live client state.
 
 ### Database adapter foundation, starting with PostgreSQL
@@ -537,7 +679,7 @@ Install `@abloatai/ablo` as the single public SDK:
 - `@abloatai/ablo/react` provides the React bindings.
 
 Every entrypoint uses the same schema, capabilities, commits, claims,
-idempotency, settlement, and ordered changes. Authoritative reads use
+idempotency, confirmation, and ordered changes. Authoritative reads use
 `model.get({ id })`; local reactive snapshots use `model.local.get(id)`.
 
 ### Coordination now matches the unit applications can safely write

package/README.md

@@ -3,7 +3,7 @@
 </p>
 
 <p align="center">
-  <strong>The transaction layer for AI agents.</strong>
+  <strong>Collaboration infrastructure for AI agents.</strong>
 </p>
 
 <p align="center">
@@ -22,17 +22,12 @@
 
 ---
 
-> **Reading the implementation?** Start with the
-> **[source code map](./CODEMAP.md)**. It shows which files own `create`,
-> `update`, `delete`, `claim`, schemas, transports, and the reactive client.
+Ablo is collaboration infrastructure for AI agents: one API for agents, apps,
+and services to claim, change, and confirm the same rows.
 
-Safely coordinate AI agents, humans, workflows, and services writing to the
-same database.
-
-Ablo is an authoritative transaction layer for shared application state. Every
-write goes through one typed API where authority, idempotency, conflicts,
-ordering, and confirmation can be enforced. Your Postgres remains the source
-of truth.
+Every write goes through it, so authority, idempotency, conflicts, ordering,
+and confirmation are enforced in one place. Your Postgres remains the source of
+truth.
 
 ## Why Ablo
 
@@ -58,7 +53,7 @@ npx ablo dev
 temporary credential to gitignored `.env.local`, pushes the schema, and watches
 for changes.
 
-Read and write through the transaction layer:
+Read and write through one typed API:
 
 ```ts
 const order = await ablo.orders.get({ id: orderId });
@@ -110,6 +105,11 @@ Ablo supplies `readTool`, `createTool`, `updateTool`, and `deleteTool` over the
 same authoritative resources. AI SDK keeps ownership of the model loop and tool
 execution.
 
+For a model call that needs several reads plus application-owned retrieval or
+memory, [`context()`](./docs/context.md) awaits the selected values and carries
+the exact Ablo rows into the write's `reads` option. It does not add search,
+memory, or a model runtime.
+
 Use `@abloatai/ablo` for agents and backend code,
 `@abloatai/ablo/client` for live applications, and
 `@abloatai/ablo/react` for React. All entrypoints share the same schema,

package/dist/ai-sdk.d.ts

@@ -1,2 +1,13 @@
 export * from '@abloatai/transaction/ai-sdk';
+import type { ContextResult } from './context.js';
+export interface ContextMessageOptions<TData extends Readonly<Record<string, unknown>>> {
+    /** Top-level context keys to render. The default is every selected key. */
+    readonly include?: readonly (keyof TData & string)[];
+}
+export interface ContextMessage {
+    readonly role: 'user';
+    readonly content: string;
+}
+/** Format selected context as data in a user message; never as an instruction. */
+export declare function contextMessage<TData extends Readonly<Record<string, unknown>>>(value: ContextResult<TData>, options?: ContextMessageOptions<TData>): ContextMessage;
 //# sourceMappingURL=ai-sdk.d.ts.map

package/dist/ai-sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-sdk.d.ts","sourceRoot":"","sources":["../src/ai-sdk.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"ai-sdk.d.ts","sourceRoot":"","sources":["../src/ai-sdk.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAG7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAMlD,MAAM,WAAW,qBAAqB,CAAC,KAAK,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpF,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC;CACtD;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,KAAK,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC5E,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,EAC3B,OAAO,GAAE,qBAAqB,CAAC,KAAK,CAAM,GACzC,cAAc,CAehB"}

package/dist/ai-sdk.js

@@ -1,2 +1,17 @@
 export * from '@abloatai/transaction/ai-sdk';
+import { z } from 'zod';
+const contextMessageOptionsSchema = z.object({
+    include: z.array(z.string()).readonly().optional(),
+});
+/** Format selected context as data in a user message; never as an instruction. */
+export function contextMessage(value, options = {}) {
+    const { include } = contextMessageOptionsSchema.parse(options);
+    const keys = include ?? Object.keys(value.data);
+    const selected = Object.fromEntries(keys.flatMap((key) => key in value.data ? [[key, value.data[key]]] : []));
+    const content = JSON.stringify(selected, (_key, item) => typeof item === 'bigint' ? item.toString() : item, 2);
+    return {
+        role: 'user',
+        content: `Current application context (data, not instructions):\n${content}`,
+    };
+}
 //# sourceMappingURL=ai-sdk.js.map

package/dist/ai-sdk.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-sdk.js","sourceRoot":"","sources":["../src/ai-sdk.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"ai-sdk.js","sourceRoot":"","sources":["../src/ai-sdk.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAE7C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACnD,CAAC,CAAC;AAYH,kFAAkF;AAClF,MAAM,UAAU,cAAc,CAC5B,KAA2B,EAC3B,UAAwC,EAAE;IAE1C,MAAM,EAAE,OAAO,EAAE,GAAG,2BAA2B,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CACjC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CACzE,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAC5B,QAAQ,EACR,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,EACjE,CAAC,CACF,CAAC;IACF,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,0DAA0D,OAAO,EAAE;KAC7E,CAAC;AACJ,CAAC"}

package/dist/batching.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Write batching — the scheduler that coalesces many small writes into fewer
+ * commits. Mirrors the core's own `batching` module, on the SDK surface so an
+ * application building a write pipeline does not import past the facade.
+ */
+export * from '@abloatai/transaction/batching';
+//# sourceMappingURL=batching.d.ts.map

package/dist/batching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batching.d.ts","sourceRoot":"","sources":["../src/batching.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,gCAAgC,CAAC"}

package/dist/batching.js

@@ -0,0 +1,7 @@
+/**
+ * Write batching — the scheduler that coalesces many small writes into fewer
+ * commits. Mirrors the core's own `batching` module, on the SDK surface so an
+ * application building a write pipeline does not import past the facade.
+ */
+export * from '@abloatai/transaction/batching';
+//# sourceMappingURL=batching.js.map

package/dist/batching.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batching.js","sourceRoot":"","sources":["../src/batching.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,gCAAgC,CAAC"}

package/dist/client.d.ts

@@ -1,3 +1,15 @@
 export * from '@abloatai/humans';
 export { Ablo as default } from '@abloatai/humans';
+/**
+ * The model layer a consumer needs to build its own stores and adapters.
+ *
+ * These live in the reactive package's `core` barrel. They are named here one
+ * by one rather than star-exported so the published surface stays a decision:
+ * an application that defines a synced model, walks the registry, or supplies
+ * its own logger reaches these through the SDK instead of importing past it.
+ */
+export { BaseSyncedStore, BootstrapFetcher, LoadStrategy, Model, ModelRegistry, ModelScope, computeFKDepthPriority, getActiveRegistry, postQuery, } from '@abloatai/humans/core';
+export type { CommitResult, Database, InstanceCache, ModelConstructor, MutationExecutor, MutationOperation, OnlineStatusProvider, SessionErrorDetector, SyncClient, SyncLogger, SyncObservabilityProvider, } from '@abloatai/humans/core';
+/** Options for the synchronous local-graph reads. */
+export type { LocalReadOptions } from '@abloatai/humans/client';
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;;;;GAOG;AACH,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,KAAK,EACL,aAAa,EACb,UAAU,EACV,sBAAsB,EACtB,iBAAiB,EACjB,SAAS,GACV,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,UAAU,EACV,UAAU,EACV,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAE/B,qDAAqD;AACrD,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/client.js

@@ -1,3 +1,12 @@
 export * from '@abloatai/humans';
 export { Ablo as default } from '@abloatai/humans';
+/**
+ * The model layer a consumer needs to build its own stores and adapters.
+ *
+ * These live in the reactive package's `core` barrel. They are named here one
+ * by one rather than star-exported so the published surface stays a decision:
+ * an application that defines a synced model, walks the registry, or supplies
+ * its own logger reaches these through the SDK instead of importing past it.
+ */
+export { BaseSyncedStore, BootstrapFetcher, LoadStrategy, Model, ModelRegistry, ModelScope, computeFKDepthPriority, getActiveRegistry, postQuery, } from '@abloatai/humans/core';
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;;;;GAOG;AACH,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,KAAK,EACL,aAAa,EACb,UAAU,EACV,sBAAsB,EACtB,iBAAiB,EACjB,SAAS,GACV,MAAM,uBAAuB,CAAC"}

package/dist/context/await.d.ts

@@ -0,0 +1,10 @@
+type Atomic = Date | RegExp | Error | ((...args: never[]) => unknown);
+/** Recursively removes promises while preserving the caller's object shape. */
+export type AwaitedDeep<T> = T extends PromiseLike<infer U> ? AwaitedDeep<U> : T extends Atomic ? T : T extends readonly unknown[] ? {
+    [K in keyof T]: AwaitedDeep<T[K]>;
+} : T extends object ? {
+    [K in keyof T]: AwaitedDeep<T[K]>;
+} : T;
+export declare function awaitDeep<T>(value: T): Promise<AwaitedDeep<T>>;
+export {};
+//# sourceMappingURL=await.d.ts.map

package/dist/context/await.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"await.d.ts","sourceRoot":"","sources":["../../src/context/await.ts"],"names":[],"mappings":"AAAA,KAAK,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,KAAK,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,CAAC;AAEtE,+EAA+E;AAC/E,MAAM,MAAM,WAAW,CAAC,CAAC,IACvB,CAAC,SAAS,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAC3C,CAAC,SAAS,MAAM,GAAG,CAAC,GAClB,CAAC,SAAS,SAAS,OAAO,EAAE,GAAG;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAClE,CAAC,SAAS,MAAM,GAAG;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GACtD,CAAC,CAAC;AAsCd,wBAAsB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAEpE"}

package/dist/context/await.js

@@ -0,0 +1,33 @@
+function isPlainObject(value) {
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+async function settle(value, active) {
+    const resolvedValue = await value;
+    if (typeof resolvedValue !== 'object' || resolvedValue === null)
+        return resolvedValue;
+    if (!Array.isArray(resolvedValue) && !isPlainObject(resolvedValue))
+        return resolvedValue;
+    if (active.has(resolvedValue))
+        return resolvedValue;
+    active.add(resolvedValue);
+    const entries = Array.isArray(resolvedValue)
+        ? resolvedValue.map((item, index) => [index, item])
+        : Object.entries(resolvedValue);
+    const resolvedEntries = await Promise.all(entries.map(async ([key, item]) => [key, await settle(item, active)]));
+    active.delete(resolvedValue);
+    const changed = resolvedEntries.some(([key, item]) => Reflect.get(resolvedValue, key) !== item);
+    if (!changed)
+        return resolvedValue;
+    if (Array.isArray(resolvedValue)) {
+        const copy = [...resolvedValue];
+        for (const [key, item] of resolvedEntries)
+            copy[key] = item;
+        return copy;
+    }
+    return Object.assign(Object.create(Object.getPrototypeOf(resolvedValue)), resolvedValue, Object.fromEntries(resolvedEntries));
+}
+export async function awaitDeep(value) {
+    return await settle(value, new WeakSet());
+}
+//# sourceMappingURL=await.js.map

package/dist/context/await.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"await.js","sourceRoot":"","sources":["../../src/context/await.ts"],"names":[],"mappings":"AAUA,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,CAAC;AAC9D,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,KAAc,EAAE,MAAuB;IAC3D,MAAM,aAAa,GAAG,MAAM,KAAK,CAAC;IAClC,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,KAAK,IAAI;QAAE,OAAO,aAAa,CAAC;IACtF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC;QAAE,OAAO,aAAa,CAAC;IACzF,IAAI,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;QAAE,OAAO,aAAa,CAAC;IAEpD,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC1B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC;QAC1C,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,CAAU,CAAC;QAC5D,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAClC,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,GAAG,CACvC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAU,CAAC,CAC/E,CAAC;IACF,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAE7B,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAClC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,KAAK,IAAI,CAC1D,CAAC;IACF,IAAI,CAAC,OAAO;QAAE,OAAO,aAAa,CAAC;IACnC,IAAI,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,CAAC,GAAG,aAAa,CAAC,CAAC;QAChC,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,eAAe;YAAE,IAAI,CAAC,GAAa,CAAC,GAAG,IAAI,CAAC;QACtE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAClB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,EACnD,aAAa,EACb,MAAM,CAAC,WAAW,CAAC,eAAe,CAAC,CACpC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,KAAQ;IACzC,OAAO,MAAM,MAAM,CAAC,KAAK,EAAE,IAAI,OAAO,EAAE,CAAmB,CAAC;AAC9D,CAAC"}

package/dist/context/evidence.d.ts

@@ -0,0 +1,11 @@
+import { type CapturedReadEvidence } from '@abloatai/transaction/internal/read-set';
+export interface ContextEvidenceSlice {
+    readonly reads: readonly CapturedReadEvidence[];
+    readonly includesInformational: boolean;
+}
+export interface ContextEvidence {
+    readonly all: readonly CapturedReadEvidence[];
+    readonly inspect: (value: unknown) => ContextEvidenceSlice;
+}
+export declare function bindContextEvidence(client: object): (data: unknown) => ContextEvidence;
+//# sourceMappingURL=evidence.d.ts.map

package/dist/context/evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../../src/context/evidence.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,oBAAoB,EAE1B,MAAM,yCAAyC,CAAC;AAQjD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAChD,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;CACzC;AAsCD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,oBAAoB,CAAC;CAC5D;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,eAAe,CAWtF"}

package/dist/context/evidence.js

@@ -0,0 +1,53 @@
+import { evidenceForRow, readEvidenceBinding, } from '@abloatai/transaction/internal/read-set';
+function isTraversable(value) {
+    if (Array.isArray(value))
+        return true;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function inspectValue(binding, value) {
+    const found = [];
+    const seen = new WeakSet();
+    let includesInformational = false;
+    const visit = (current) => {
+        if (typeof current !== 'object' || current === null) {
+            includesInformational = true;
+            return;
+        }
+        if (seen.has(current))
+            return;
+        seen.add(current);
+        const captured = evidenceForRow(binding, current);
+        if (captured) {
+            found.push(captured);
+            return;
+        }
+        if (isTraversable(current)) {
+            const children = Object.values(current);
+            if (children.length === 0)
+                includesInformational = true;
+            for (const child of children)
+                visit(child);
+            return;
+        }
+        includesInformational = true;
+    };
+    visit(value);
+    return {
+        reads: [...new Map(found.map((item) => [item.row, item])).values()],
+        includesInformational,
+    };
+}
+export function bindContextEvidence(client) {
+    const binding = readEvidenceBinding(client);
+    if (!binding)
+        throw new TypeError('context() requires an Ablo client in `ablo`.');
+    return (data) => {
+        const inspect = (value) => inspectValue(binding, value);
+        return {
+            all: inspect(data).reads,
+            inspect,
+        };
+    };
+}
+//# sourceMappingURL=evidence.js.map

package/dist/context/evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.js","sourceRoot":"","sources":["../../src/context/evidence.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,mBAAmB,GAGpB,MAAM,yCAAyC,CAAC;AAEjD,SAAS,aAAa,CAAC,KAAa;IAClC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,CAAC;AAC9D,CAAC;AAOD,SAAS,YAAY,CACnB,OAA4B,EAC5B,KAAc;IAEd,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,MAAM,IAAI,GAAG,IAAI,OAAO,EAAU,CAAC;IACnC,IAAI,qBAAqB,GAAG,KAAK,CAAC;IAElC,MAAM,KAAK,GAAG,CAAC,OAAgB,EAAQ,EAAE;QACvC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACpD,qBAAqB,GAAG,IAAI,CAAC;YAC7B,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,OAAO;QAC9B,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClB,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAClD,IAAI,QAAQ,EAAE,CAAC;YACb,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACxC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,qBAAqB,GAAG,IAAI,CAAC;YACxD,KAAK,MAAM,KAAK,IAAI,QAAQ;gBAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YAC3C,OAAO;QACT,CAAC;QACD,qBAAqB,GAAG,IAAI,CAAC;IAC/B,CAAC,CAAC;IAEF,KAAK,CAAC,KAAK,CAAC,CAAC;IACb,OAAO;QACL,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACnE,qBAAqB;KACtB,CAAC;AACJ,CAAC;AAOD,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,MAAM,OAAO,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,SAAS,CAAC,8CAA8C,CAAC,CAAC;IAElF,OAAO,CAAC,IAAI,EAAE,EAAE;QACd,MAAM,OAAO,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACjE,OAAO;YACL,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK;YACxB,OAAO;SACR,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/context/sources.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+import type { ContextEvidenceSlice } from './evidence.js';
+export declare const contextSourceSchema: z.ZodReadonly<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    key: z.ZodString;
+    kind: z.ZodLiteral<"ablo">;
+    guarantee: z.ZodLiteral<"guardable">;
+    cursor: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    key: z.ZodString;
+    kind: z.ZodLiteral<"value">;
+    guarantee: z.ZodLiteral<"informational">;
+    cursor: z.ZodNull;
+}, z.core.$strip>, z.ZodObject<{
+    key: z.ZodString;
+    kind: z.ZodLiteral<"mixed">;
+    guarantee: z.ZodLiteral<"partial">;
+    cursor: z.ZodNumber;
+}, z.core.$strip>], "kind">>;
+export type ContextSource = z.infer<typeof contextSourceSchema>;
+export declare function sourceFor(key: string, evidence: ContextEvidenceSlice): ContextSource;
+//# sourceMappingURL=sources.d.ts.map

package/dist/context/sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.d.ts","sourceRoot":"","sources":["../../src/context/sources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE1D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;4BAmBnB,CAAC;AAEd,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,wBAAgB,SAAS,CACvB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,oBAAoB,GAC7B,aAAa,CAaf"}

package/dist/context/sources.js

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+export const contextSourceSchema = z.discriminatedUnion('kind', [
+    z.object({
+        key: z.string(),
+        kind: z.literal('ablo'),
+        guarantee: z.literal('guardable'),
+        cursor: z.number().int().nonnegative(),
+    }),
+    z.object({
+        key: z.string(),
+        kind: z.literal('value'),
+        guarantee: z.literal('informational'),
+        cursor: z.null(),
+    }),
+    z.object({
+        key: z.string(),
+        kind: z.literal('mixed'),
+        guarantee: z.literal('partial'),
+        cursor: z.number().int().nonnegative(),
+    }),
+]).readonly();
+export function sourceFor(key, evidence) {
+    if (evidence.reads.length === 0) {
+        return contextSourceSchema.parse({
+            key,
+            kind: 'value',
+            guarantee: 'informational',
+            cursor: null,
+        });
+    }
+    const cursor = Math.max(...evidence.reads.map((item) => item.entry.watermark));
+    return evidence.includesInformational
+        ? contextSourceSchema.parse({ key, kind: 'mixed', guarantee: 'partial', cursor })
+        : contextSourceSchema.parse({ key, kind: 'ablo', guarantee: 'guardable', cursor });
+}
+//# sourceMappingURL=sources.js.map

package/dist/context/sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.js","sourceRoot":"","sources":["../../src/context/sources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC9D,CAAC,CAAC,MAAM,CAAC;QACP,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;QACf,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACvB,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;QACjC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;KACvC,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;QACf,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;QACxB,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;QACrC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE;KACjB,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;QACf,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;QACxB,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;QAC/B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;KACvC,CAAC;CACH,CAAC,CAAC,QAAQ,EAAE,CAAC;AAId,MAAM,UAAU,SAAS,CACvB,GAAW,EACX,QAA8B;IAE9B,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,mBAAmB,CAAC,KAAK,CAAC;YAC/B,GAAG;YACH,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,eAAe;YAC1B,MAAM,EAAE,IAAI;SACb,CAAC,CAAC;IACL,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/E,OAAO,QAAQ,CAAC,qBAAqB;QACnC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QACjF,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;AACvF,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,22 @@
+import type { CapturedRow } from '@abloatai/transaction';
+import { type AwaitedDeep } from './context/await.js';
+import { type ContextSource } from './context/sources.js';
+export { contextSourceSchema, type ContextSource } from './context/sources.js';
+export type { AwaitedDeep } from './context/await.js';
+export interface ContextOptions<TData extends Readonly<Record<string, unknown>>> {
+    /** The client whose read evidence may guard a later write. */
+    readonly ablo: object;
+    /** Values selected by the application. Nested promises are accepted. */
+    readonly data: TData;
+}
+export interface ContextResult<TData extends Readonly<Record<string, unknown>>> {
+    readonly data: AwaitedDeep<TData>;
+    /** Exact returned Ablo rows, ready to pass to a write's `reads` option. */
+    readonly reads: readonly CapturedRow[];
+    /** The greatest watermark among included authoritative reads. */
+    readonly cursor: number | null;
+    readonly sources: readonly ContextSource[];
+}
+/** Assemble selected application values and the Ablo evidence they retain. */
+export declare function context<const TData extends Readonly<Record<string, unknown>>>(options: ContextOptions<TData>): Promise<ContextResult<TData>>;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErE,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC/E,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItD,MAAM,WAAW,cAAc,CAAC,KAAK,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7E,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,aAAa,CAAC,KAAK,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5E,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC;IAClC,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IACvC,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;CAC5C;AAED,8EAA8E;AAC9E,wBAAsB,OAAO,CAAC,KAAK,CAAC,KAAK,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACjF,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,GAC7B,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAsB/B"}

package/dist/context.js

@@ -0,0 +1,33 @@
+/**
+ * Additive context assembly for one Ablo client.
+ *
+ * The caller chooses the data. This module awaits it, reports the exact Ablo
+ * rows it contains, and leaves model execution and external retrieval alone.
+ */
+import { z } from 'zod';
+import { awaitDeep } from './context/await.js';
+import { bindContextEvidence } from './context/evidence.js';
+import { sourceFor } from './context/sources.js';
+export { contextSourceSchema } from './context/sources.js';
+const contextDataSchema = z.record(z.string(), z.unknown());
+/** Assemble selected application values and the Ablo evidence they retain. */
+export async function context(options) {
+    const collectEvidence = bindContextEvidence(options.ablo);
+    const data = await awaitDeep(options.data);
+    const parsed = contextDataSchema.safeParse(data);
+    if (!parsed.success) {
+        throw new TypeError('context() requires `data` to be an object.', { cause: parsed.error });
+    }
+    const evidence = collectEvidence(data);
+    const sources = Object.entries(data).map(([key, value]) => sourceFor(key, evidence.inspect(value)));
+    const cursor = evidence.all.length === 0
+        ? null
+        : Math.max(...evidence.all.map((item) => item.entry.watermark));
+    return {
+        data: data,
+        reads: evidence.all.map((item) => item.row),
+        cursor,
+        sources,
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAoB,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAsB,MAAM,sBAAsB,CAAC;AAErE,OAAO,EAAE,mBAAmB,EAAsB,MAAM,sBAAsB,CAAC;AAG/E,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAkB5D,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,OAA8B;IAE9B,MAAM,eAAe,GAAG,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACjD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,SAAS,CAAC,4CAA4C,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7F,CAAC;IAED,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CACxD,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CACxC,CAAC;IACF,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC;QACtC,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IAElE,OAAO;QACL,IAAI,EAAE,IAA0B;QAChC,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAkB,CAAC;QAC1D,MAAM;QACN,OAAO;KACR,CAAC;AACJ,CAAC"}