@abloatai/humans 0.61.0 → 0.62.0

package/dist/Ablo.d.ts

@@ -57,7 +57,7 @@ export type Ablo<S extends SchemaRecord> = AbloClient<S>;
  * const ablo = Ablo({ schema, session: { endpoint: '/api/ablo-session' } });
  * ```
  *
- * Server-side agents, workers, and services use `@abloatai/transaction`.
+ * Server-side agents, workers, and services use `@abloatai/ablo`.
  */
 export declare function Ablo<const S extends SchemaRecord, const P extends readonly AbloPlugin[]>(options: AbloOptions<S> & {
     plugins: P;
@@ -97,10 +97,10 @@ export declare namespace Ablo {
     type ClaimTarget = _Streams.ClaimTarget;
     type PresenceTarget = _Streams.PresenceTarget;
     type Duration = _Streams.Duration;
-    type PresenceStream = _Streams.PresenceStream;
+    type Presence = import('./presence/index.js').ReactivePresence;
+    type PresenceSession = import('@abloatai/transaction/presence').PresenceSession;
+    type PresenceActivity = import('@abloatai/transaction/presence').PresenceActivity;
     type ClaimStream = _Streams.ClaimStream;
-    type Peer = _Streams.Peer;
-    type Activity = _Streams.Activity;
     type Claim = _Streams.Claim;
     type ClaimRejection = _Streams.ClaimRejection;
     type ClaimLost = _Streams.ClaimLost;

package/dist/Ablo.js

@@ -39,7 +39,7 @@ export function Ablo(options) {
     //    resolver, the base URL, the logger, and this participant's identity —
     //    and fails on a misconfiguration before anything is constructed.
     const prelude = resolveClientPrelude(options);
-    const { internalOptions, authCredentials, logger, url, participantId, kind } = prelude;
+    const { internalOptions, authCredentials, presenceSession, logger, url, participantId, kind, } = prelude;
     // 2. The connection, built here in the composition root — before the plugin
     //    list resolves, so `PluginContext.transport` carries the instance a
     //    plugin holds for the client's lifetime. It holds no socket until
@@ -55,6 +55,7 @@ export function Ablo(options) {
             baseUrl: url,
             kind,
             getAuthToken: authCredentials.getAuthToken,
+            presenceSession,
             collaborationEvents: [...(internalOptions.collaborationEvents ?? [])],
             syncGroups: [...(internalOptions.syncGroups ?? [])],
             deferConnect: true,

package/dist/client.d.ts

@@ -11,7 +11,6 @@
  * the factory back and creating a cycle.
  */
 import type { Schema, SchemaRecord, Model, InferCreate, InferRow } from '@abloatai/transaction/schema/schema';
-import type { PresenceStream } from '@abloatai/transaction/types/streams';
 import type { InstanceCache } from './local/InstanceCache.js';
 import type { SyncStoreContract } from './react/context.js';
 import type { SyncWebSocket, CoreSyncEventMap } from './local/sync/SyncWebSocket.js';
@@ -21,6 +20,7 @@ import type { ClaimResource, CommitResource } from '@abloatai/transaction/client
 import type { EffectiveAuthority } from '@abloatai/transaction/auth';
 import type { ReadDependency } from '@abloatai/transaction/coordination';
 import type { CapturedRow } from '@abloatai/transaction/transport/http';
+import type { ReactivePresence } from './presence/index.js';
 export type { LocalReadOptions } from './local/client/resourceTypes.js';
 /** The typed sync engine client — one property per model in the schema */
 export type AbloClient<S extends SchemaRecord> = {
@@ -197,19 +197,14 @@ export type AbloClient<S extends SchemaRecord> = {
      * ```
      */
     readonly syncStatus: SyncStatus;
-    /** The underlying schema */
-    readonly schema: Schema<S>;
     /**
-     * A real-time presence livestream — who else is connected on this engine's
-     * sync groups, what they're doing, and a write surface for announcing this
-     * user's own activity. It rides the engine's existing WebSocket; opening a
-     * participant for presence does not open a second socket. See
-     * {@link PresenceStream}.
-     *
-     * The reference is stable for the engine's lifetime — the underlying connection
-     * is rotated on `dispose()`, but this object stays the same.
+     * Session-owned live activity projected from this client's existing
+     * connection. Use `active` for every visible activity, `others` to exclude
+     * this session, and `forModel(model, id?)` for a model-native view.
      */
-    readonly presence: PresenceStream;
+    readonly presence: ReactivePresence;
+    /** The underlying schema */
+    readonly schema: Schema<S>;
     /**
      * @internal The supported coordination API is `ablo.<model>.claim`. This
      * accessor is the internal stream that surface is built on and is not part of

package/dist/humans.d.ts

@@ -6,10 +6,10 @@
  * contracts.
  */
 import type { PluginContext, AppliedChange } from './plugin.js';
-import { type AttachablePresenceStream } from './presenceStream.js';
+import { type AttachablePresence } from './presence/index.js';
 import { kStoreCluster, type InternalAbloOptions, type StoreCluster } from './local/client/storeCluster.js';
 export interface HumansSurface {
-    readonly presence: AttachablePresenceStream;
+    readonly presence: AttachablePresence;
     readonly [kStoreCluster]?: StoreCluster;
 }
 export declare function humans(): {

package/dist/humans.js

@@ -1,5 +1,5 @@
 import { AbloValidationError } from '@abloatai/transaction/errors';
-import { createPresenceStream } from './presenceStream.js';
+import { createPresence } from './presence/index.js';
 import { buildStoreCluster, kStoreCluster, } from './local/client/storeCluster.js';
 export function humans() {
     let applyChanges = null;
@@ -22,11 +22,7 @@ export function humans() {
                 applyChanges = (changes) => { cluster.store.applyChangesToPool(changes); };
             }
             return {
-                presence: createPresenceStream({
-                    participantId: context.participant?.id ?? '',
-                    syncGroups: [...(context.syncGroups ?? [])],
-                    isAgent: context.participant?.kind === 'agent',
-                }, context.transport ?? null),
+                presence: createPresence(context.transport ?? null),
                 ...(cluster ? { [kStoreCluster]: cluster } : {}),
             };
         },

package/dist/local/BaseSyncedStore.d.ts

@@ -18,7 +18,7 @@ import type { SyncClient } from './SyncClient.js';
 import type { Database, BootstrapResult, BootstrapRequirements } from './Database.js';
 import type { InstanceCache } from './InstanceCache.js';
 import { ModelRegistry } from './ModelRegistry.js';
-import { SyncWebSocket, type SyncDelta, type SyncGroupChangePayload, type GroupAddedPayload, type GroupRemovedPayload, type BootstrapHint, type BootstrapDataEvent, type PresenceUpdate, type EventMap, type DefaultCollaborationEvents, type SyncWebSocketEventMap } from './sync/SyncWebSocket.js';
+import { SyncWebSocket, type SyncDelta, type SyncGroupChangePayload, type GroupAddedPayload, type GroupRemovedPayload, type BootstrapHint, type BootstrapDataEvent, type EventMap, type DefaultCollaborationEvents, type SyncWebSocketEventMap } from './sync/SyncWebSocket.js';
 import { QueryProcessor } from './query/QueryProcessor.js';
 import { Model } from './Model.js';
 import type { RuntimeContext } from './RuntimeContext.js';
@@ -153,7 +153,7 @@ export declare const BOOTSTRAP_CONFIG: {
     readonly RETRY_DELAY_MS: 500;
 };
 export { ModelScope };
-export type { SyncDelta, SyncGroupChangePayload, GroupAddedPayload, GroupRemovedPayload, BootstrapHint, BootstrapDataEvent, PresenceUpdate, };
+export type { SyncDelta, SyncGroupChangePayload, GroupAddedPayload, GroupRemovedPayload, BootstrapHint, BootstrapDataEvent, };
 export { deriveSyncPlanFromSchema } from './sync/syncPlan.js';
 /**
  * The abstract base class that application-specific sync stores extend. It
@@ -791,8 +791,6 @@ export declare class BaseSyncedStore<TCollaboration extends EventMap<TCollaborat
     protected handleBootstrapRequired(_hint: BootstrapHint): void;
     /** Handle bootstrap_data event. Override in subclass. */
     protected handleBootstrapData(_data: BootstrapDataEvent): void;
-    /** Handle presence_update event. Override in subclass. */
-    protected handlePresenceUpdate(_data: PresenceUpdate): void;
     protected incrementPendingChanges(): void;
     protected decrementPendingChanges(): void;
     protected updateSyncStatus(updates: Partial<SyncStatus>): void;

package/dist/local/BaseSyncedStore.js

@@ -1105,7 +1105,6 @@ export class BaseSyncedStore {
             applyDeltaFrame: (deltas) => { this.applyDeltaFrame(deltas); },
             handleBootstrapRequired: (hint) => { this.handleBootstrapRequired(hint); },
             handleBootstrapData: (data) => { this.handleBootstrapData(data); },
-            handlePresenceUpdate: (data) => { this.handlePresenceUpdate(data); },
             performCredentialRefresh: () => this.performCredentialRefresh(),
             handleTerminalSessionError: (error) => { this.terminalSessionLifecycle.start(error); },
             nudgeReconnect: () => { this.nudgeReconnect(); },
@@ -1466,8 +1465,6 @@ export class BaseSyncedStore {
     handleBootstrapData(_data) {
         this.updateSyncStatus({ state: 'syncing' });
     }
-    /** Handle presence_update event. Override in subclass. */
-    handlePresenceUpdate(_data) { }
     // ── Pending changes tracking ─────────────────────────────────────────────
     incrementPendingChanges() {
         runInAction(() => { this.syncStatus.pendingChanges++; });

package/dist/local/SyncClient.d.ts

@@ -392,7 +392,7 @@ export declare class SyncClient extends EventEmitter {
             awaitingDeltaCount: number;
             awaitingDeltaTransactions: {
                 id: string;
-                type: "update" | "create" | "delete" | "archive" | "unarchive";
+                type: "create" | "update" | "delete" | "archive" | "unarchive";
                 modelName: string;
                 modelId: string;
                 syncIdNeeded: number | undefined;
@@ -401,13 +401,13 @@ export declare class SyncClient extends EventEmitter {
             }[];
             pendingTransactions: {
                 id: string;
-                type: "update" | "create" | "delete" | "archive" | "unarchive";
+                type: "create" | "update" | "delete" | "archive" | "unarchive";
                 modelName: string;
                 modelId: string;
             }[];
             executingTransactions: {
                 id: string;
-                type: "update" | "create" | "delete" | "archive" | "unarchive";
+                type: "create" | "update" | "delete" | "archive" | "unarchive";
                 modelName: string;
                 modelId: string;
             }[];

package/dist/local/client/clientPrelude.d.ts

@@ -15,6 +15,7 @@ import type { ParticipantKind } from '@abloatai/transaction/types/participant';
 import type { Logger } from '@abloatai/transaction/logger';
 import type { SchemaRecord } from '@abloatai/transaction/schema/schema';
 import { type AuthCredentialSource } from '@abloatai/transaction/auth/credentialSource';
+import { type PresenceSessionSource } from '@abloatai/transaction/presence';
 import { type CredentialProvider } from '@abloatai/transaction/auth/apiKey';
 import type { AbloOptions, InternalAbloOptions } from './options.js';
 /** What one pass over the options bag settles, for the builders downstream. */
@@ -31,6 +32,7 @@ export interface ClientPrelude<S extends SchemaRecord> {
      */
     readonly credentialResolver: CredentialProvider | null;
     readonly authCredentials: AuthCredentialSource;
+    readonly presenceSession: PresenceSessionSource;
     readonly logger: Logger;
     readonly url: string;
     /**

package/dist/local/client/clientPrelude.js

@@ -11,7 +11,9 @@
  * `./Ablo.ts` calls this once and hands the result to whichever client the
  * plugin list selected.
  */
+import { AbloValidationError } from '@abloatai/transaction/errors';
 import { createAuthCredentialSource, } from '@abloatai/transaction/auth/credentialSource';
+import { createPresenceSessionSource, } from '@abloatai/transaction/presence';
 import { assertBrowserSafety, readProcessEnv, rejectRemovedDatabaseUrlOption, resolveApiKey, resolveAuthToken, resolveBaseURL, resolveCredentialResolver, warnIfCliKeyMismatch, } from '@abloatai/transaction/auth/apiKey';
 import { createConsoleLogger, resolveLogLevel } from './consoleLogger.js';
 /**
@@ -22,6 +24,14 @@ import { createConsoleLogger, resolveLogLevel } from './consoleLogger.js';
  * different project than the one being addressed (a warning, not a throw).
  */
 export function resolveClientPrelude(options) {
+    // This package owns the reactive materialiser, not transport selection.
+    // TypeScript can miss excess properties on generic calls and object spreads,
+    // so reject a misplaced selector before resolving any credentials or
+    // constructing local state. The core `Ablo` client owns `transport`.
+    if ('transport' in options) {
+        throw new AbloValidationError("The reactive client does not accept `transport`. Import `Ablo` from " +
+            "'@abloatai/ablo' when selecting HTTP or WebSocket transport.", { code: 'invalid_options', param: 'transport' });
+    }
     const env = readProcessEnv();
     const internalOptions = {
         ...options,
@@ -32,9 +42,10 @@ export function resolveClientPrelude(options) {
     const configuredApiKey = resolveApiKey(authInput);
     const configuredAuthToken = resolveAuthToken(authInput);
     const credentialResolver = resolveCredentialResolver(configuredApiKey);
+    const presenceSession = createPresenceSessionSource();
     const authCredentials = createAuthCredentialSource(
     // eslint-disable-next-line @typescript-eslint/no-deprecated -- load-bearing on the self-hosted path; server-internal cap-mint (Phase 3) not shipped
-    internalOptions.capabilityToken ?? configuredAuthToken);
+    internalOptions.capabilityToken ?? configuredAuthToken, presenceSession);
     rejectRemovedDatabaseUrlOption(options);
     assertBrowserSafety({
         apiKey: configuredApiKey,
@@ -56,6 +67,7 @@ export function resolveClientPrelude(options) {
         configuredAuthToken,
         credentialResolver,
         authCredentials,
+        presenceSession,
         logger,
         url: resolveBaseURL(authInput),
         participantId,

package/dist/local/client/createInternalComponents.js

@@ -39,6 +39,7 @@ export function createInternalComponents(input) {
         syncGroups: options.syncGroups,
         instantModels: deriveInstantModels(schema),
         getAuthToken: auth?.getAuthToken,
+        presenceSession: auth?.presenceSession,
         runtime,
     });
     const database = new Database(modelRegistry, bootstrapHelper, {
@@ -61,6 +62,7 @@ export function createInternalComponents(input) {
         schema,
         baseUrl: bootstrapBaseUrl,
         getAuthToken: auth?.getAuthToken,
+        presenceSession: auth?.presenceSession,
         runtime,
         // The one canonical log position; the loader reads its floor when a query
         // leaves so a late answer cannot overwrite a row the pool already knows to

package/dist/local/client/createModelOperations.d.ts

@@ -22,6 +22,7 @@ export type { Claim, ClaimHeartbeat, ClaimHeartbeatOptions, HeldClaim, HeldLease
 import type { ClaimApi, ClaimAttemptEvent, LocalCountOptions, LocalReadOptions } from '@abloatai/transaction/client/resources/modelOperations';
 import type { HttpModelClient } from '@abloatai/transaction/transport/http';
 import type { ParticipantKind } from '@abloatai/transaction/types/participant';
+import type { PresenceSession } from '@abloatai/transaction/presence';
 import { type ReadSetContext } from '@abloatai/transaction/internal/read-set';
 export interface ModelClientMeta {
     readonly key: string;
@@ -34,6 +35,8 @@ export declare function getModelClientMeta(modelClient: unknown): ModelClientMet
  */
 type EntityHalf = Pick<ModelTarget, 'model' | 'id'>;
 export interface ModelCollaboration {
+    /** Session projections already held by this client's one presence store. */
+    presence(model: string, recordId?: string): readonly PresenceSession[];
     /** Exact point evidence from the HTTP read boundary (stamp captured before data). */
     readPoint(model: string, id: string): Promise<{
         data: unknown;
@@ -187,6 +190,8 @@ export interface LocalReads<T> {
 interface ReactiveModelSurface<T, Fields = T> {
     /** The synchronous local-graph reads. */
     local: LocalReads<T>;
+    /** Sessions currently active on this model, optionally narrowed to one record. */
+    presence(recordId?: string): readonly PresenceSession[];
     /**
      * Claim a row so other writers wait or are rejected until you're done, and
      * inspect or manage that coordination through the same namespace. Call it to

package/dist/local/client/createModelOperations.js

@@ -829,6 +829,7 @@ hydration, collaboration, readSetContext) {
     }
     const operations = {
         local,
+        presence: (recordId) => collaboration?.presence(registeredModelName, recordId) ?? [],
         get,
         read,
         // No automatic scope enrolment on bulk `list`: that would subscribe to an

package/dist/local/client/reactiveEngine.d.ts

@@ -14,7 +14,7 @@
 import type { SchemaRecord } from '@abloatai/transaction/schema/schema';
 import type { StoreCluster } from './storeCluster.js';
 import type { SyncWebSocket } from '../sync/SyncWebSocket.js';
-import type { AttachablePresenceStream } from '../../presenceStream.js';
+import { type AttachablePresence } from '../../presence/index.js';
 import type { AbloOptions } from './options.js';
 import type { ClientPrelude } from './clientPrelude.js';
 import type { AbloClient as Ablo } from '../../client.js';
@@ -36,7 +36,7 @@ export interface ReactiveEngineInputs<S extends SchemaRecord> extends ClientPrel
     transport: SyncWebSocket;
     /** The humans() plugin's contribution — built by its `init`, already
      *  attached to the connection the context carried. */
-    presence: AttachablePresenceStream;
+    presence: AttachablePresence;
     /**
      * The store cluster `humans().init` constructed from the widened context:
      * this client's runtime, the component graph, and the store. The engine

package/dist/local/client/reactiveEngine.js

@@ -20,6 +20,7 @@ import { startStoreLifecycle } from './storeLifecycle.js';
 import { createClaimStream } from '../sync/createClaimStream.js';
 import { awaitClaimGrant } from '@abloatai/transaction/claims';
 import { bindClaimLifetime, claimLifetimeOf, } from '@abloatai/transaction/claims/lifetime';
+import { attachPresenceToClient, } from '../../presence/index.js';
 import { resolveApiKeyValue, resolveBootstrapBaseUrl } from '@abloatai/transaction/auth/apiKey';
 import { claimAttemptFailure, emitClaimStatus, } from '@abloatai/transaction/client/resources/modelOperations';
 import { createModelOperations } from './createModelOperations.js';
@@ -80,7 +81,7 @@ export function buildReactiveEngine(inputs) {
     // filter own echoes by participant id, seeded in `ready()` alongside the
     // locals above.
     const presenceStream = presence;
-    const claimStream = createClaimStream({ participantId, logger }, transport);
+    const claimStream = createClaimStream({ logger }, transport, presenceStream);
     // 6. Validate options up front — fail loudly on obviously wrong inputs so
     //    strangers don't get silent empty results. Validation errors are written
     //    into `store.syncStatus` (the single source of truth).
@@ -131,17 +132,11 @@ export function buildReactiveEngine(inputs) {
         kind,
         logger,
         validationError: _validationError,
-        onIdentityResolved: ({ userId, participantKind, accountScope, syncGroups, authority }) => {
+        onIdentityResolved: ({ userId, participantKind, accountScope, authority }) => {
             selfParticipantId = userId;
             selfParticipantKind = participantKind;
             _resolvedOrganizationId = accountScope;
             _resolvedIdentity = authority;
-            presenceStream.setParticipant({
-                id: userId,
-                kind: participantKind,
-                syncGroups: [...syncGroups],
-            });
-            claimStream.setParticipant({ id: userId });
         },
     });
     const ready = lifecycle.ready;
@@ -398,6 +393,7 @@ export function buildReactiveEngine(inputs) {
     for (const [schemaKey, modelDef] of Object.entries(schema.models)) {
         const registeredModelName = modelDef.typename ?? schemaKey;
         modelProxies[schemaKey] = createModelOperations(schemaKey, registeredModelName, objectPool, syncClient, modelRegistry, hydration, {
+            presence: (model, recordId) => presenceStream.forModel(model, recordId),
             createClaim: (claimOptions) => publicClaims.create(claimOptions),
             // Lazily referenced: `commits` is declared below this loop, and this
             // only runs when someone actually writes a batch.
@@ -599,6 +595,10 @@ export function buildReactiveEngine(inputs) {
         get syncStatus() {
             return store.syncStatus;
         },
+        // The humans capability owns the connection-backed presence projection.
+        // Keep it on the base client as well as in the plugin surface so the
+        // concrete AbloClient contract and runtime object agree before layering.
+        presence: presenceStream,
         schema,
         // ── Internal accessors for framework integration ─────────────────
         // These expose internal components for consumers that need direct
@@ -611,13 +611,11 @@ export function buildReactiveEngine(inputs) {
         get _pool() { return objectPool; },
         /** The SyncWebSocket — for collaboration events (selection, cursors). */
         get _ws() { return store.getSyncWebSocket(); },
-        /** Presence livestream — same socket as entity sync, no second
-         *  connection. Stable reference across the engine's lifetime. */
-        presence: presenceStream,
         /** Claim livestream — same socket. Stable reference. */
         claims: publicClaims,
         commits,
     };
+    attachPresenceToClient(engine, presenceStream);
     Object.defineProperty(engine, kReadEvidence, {
         value: {
             context: cluster.readSetContext,

package/dist/local/query/client.d.ts

@@ -15,6 +15,7 @@ import type { QueryBatch, QueryBatchResult } from './types.js';
 import { type RecoveryClass } from '@abloatai/transaction/errorCodes';
 import { type AuthTokenGetter } from '@abloatai/transaction/auth/credentialSource';
 import type { RuntimeContext } from '../RuntimeContext.js';
+import type { PresenceSessionSource } from '@abloatai/transaction/presence';
 export interface PostQueryOptions {
     /**
      * Full base URL of the sync server including the `/api` prefix.
@@ -38,6 +39,8 @@ export interface PostQueryOptions {
      * effect without rebuilding the client.
      */
     capabilityToken?: string;
+    /** Server-bound attribution shared with the owning WebSocket. */
+    presenceSession?: PresenceSessionSource;
     /**
      * An optional hook that tries to recover from a rejected credential. When a
      * query comes back with a 401, its {@link RecoveryClass} is passed here: a

package/dist/local/query/client.js

@@ -74,7 +74,7 @@ export async function postQuery(options, batch) {
         try {
             // Recomputed per attempt: `withAuthHeaders` reads the live credential
             // source, so a replay after recovery carries the freshly-minted key.
-            const headers = withAuthHeaders(options.getAuthToken, { 'Content-Type': 'application/json' }, options.capabilityToken);
+            const headers = withAuthHeaders(options.getAuthToken, { 'Content-Type': 'application/json' }, options.capabilityToken, options.presenceSession);
             const response = await fetch(url, {
                 method: 'POST',
                 headers,

package/dist/local/sync/BootstrapFetcher.d.ts

@@ -94,6 +94,8 @@ export interface BootstrapOptions {
      * {@link BootstrapFetcher.setAuthToken}.
      */
     getAuthToken?: AuthTokenGetter;
+    /** Server-bound attribution shared with the owning WebSocket. */
+    presenceSession?: import('@abloatai/transaction/presence').PresenceSessionSource;
     /** The owning client's runtime. Defaults to the module-global bridge. */
     runtime?: RuntimeContext;
 }

package/dist/local/sync/BootstrapFetcher.js

@@ -172,7 +172,7 @@ export class BootstrapFetcher {
         try {
             const res = await fetch(`${this.options.baseUrl}/schema`, {
                 method: 'GET',
-                headers: withAuthHeaders(this.options.getAuthToken, {}, this.options.authToken),
+                headers: withAuthHeaders(this.options.getAuthToken, {}, this.options.authToken, this.options.presenceSession),
             });
             if (!res.ok)
                 throw new Error(`schema read-back ${res.status}`);
@@ -570,7 +570,7 @@ export class BootstrapFetcher {
         // conditional revalidation (If-None-Match) implement it at their own
         // level where they own the cache-key namespace. The 304 branch below
         // remains defensively in place for when a caller enables revalidation.
-        const headers = withAuthHeaders(this.options.getAuthToken, { 'Content-Type': 'application/json' }, this.options.authToken);
+        const headers = withAuthHeaders(this.options.getAuthToken, { 'Content-Type': 'application/json' }, this.options.authToken, this.options.presenceSession);
         const controller = new AbortController();
         this.activeControllers.set(controller, 'bootstrap');
         try {
@@ -738,7 +738,7 @@ export class BootstrapFetcher {
                     'Content-Type': 'application/json',
                     'Cache-Control': 'no-cache, no-store, must-revalidate',
                     Pragma: 'no-cache',
-                }, this.options.authToken),
+                }, this.options.authToken, this.options.presenceSession),
                 signal: controller.signal,
                 cache: 'no-store', // Force browser to not cache
             });
@@ -797,7 +797,7 @@ export class BootstrapFetcher {
                 method: 'GET',
                 headers: withAuthHeaders(this.options.getAuthToken, {
                     'Content-Type': 'application/json',
-                }, this.options.authToken),
+                }, this.options.authToken, this.options.presenceSession),
                 signal: controller.signal,
             });
         }

package/dist/local/sync/OnDemandLoader.d.ts

@@ -37,6 +37,7 @@ import type { LoadWhere, WhereClause } from '../query/types.js';
 import { normalizeWhere } from '@abloatai/transaction/client/resources/where';
 import type { Schema } from '@abloatai/transaction/schema/schema';
 import type { LogPositionPort } from '../logPosition.js';
+import type { PresenceSessionSource } from '@abloatai/transaction/presence';
 export interface OnDemandLoaderOptions {
     readonly objectPool: InstanceCache;
     /**
@@ -53,6 +54,7 @@ export interface OnDemandLoaderOptions {
      * propagate without re-instantiating the coordinator.
      */
     readonly getAuthToken?: () => string | null;
+    readonly presenceSession?: PresenceSessionSource;
     /** @deprecated Use `getAuthToken`. */
     readonly getCapabilityToken?: () => string | null;
     /** The owning client's runtime. Defaults to the module-global bridge. */

package/dist/local/sync/OnDemandLoader.js

@@ -452,6 +452,7 @@ export class OnDemandLoader {
             getAuthToken: this.authTokenProvider ?? undefined,
             recoverCredential: this.credentialRecovery ?? undefined,
             runtime: this.opts.runtime,
+            presenceSession: this.opts.presenceSession,
         }, { queries: [query] });
         const rows = Array.isArray(result.results[0]) ? result.results[0] : [];
         const evidence = result.evidence?.[0] ?? [];

package/dist/local/sync/SyncWebSocket.d.ts

@@ -12,7 +12,7 @@
 import { type ClientSyncDelta } from '@abloatai/transaction/observation';
 import { WsTransport, type WsTransportOptions, type EventMap, type DefaultCollaborationEvents } from '@abloatai/transaction/transport/websocket';
 export type { CommitAck } from './commitFrames.js';
-export type { SyncCapabilities, BootstrapHint, BootstrapDataEvent, PresenceUpdate, CoreSyncEventMap, DefaultCollaborationEvents, EventMap, SyncWebSocketEventMap, } from '@abloatai/transaction/transport/websocket';
+export type { SyncCapabilities, BootstrapHint, BootstrapDataEvent, CoreSyncEventMap, DefaultCollaborationEvents, EventMap, SyncWebSocketEventMap, } from '@abloatai/transaction/transport/websocket';
 /**
  * The wire delta the client receives. It is inferred from the canonical
  * `clientSyncDeltaSchema` so the client and server share one contract rather
@@ -67,7 +67,7 @@ export declare class SyncWebSocket<TCollaboration extends EventMap<TCollaboratio
     protected resumeCursor(): string;
     /**
      * The open ritual, run by the transport between its `connected` emit and the
-     * heartbeat start: announce presence, tell the server where we left off,
+     * heartbeat start: tell the server where we left off,
      * request the deltas we missed, and start the catch-up poll.
      */
     protected onOpened(): void;
@@ -121,19 +121,6 @@ export declare class SyncWebSocket<TCollaboration extends EventMap<TCollaboratio
      * Public wrapper for sending ack from outside the class
      */
     acknowledge(syncId: number): void;
-    /**
-     * Send presence update to server.
-     * Use this for:
-     * - Updating timezone (improves localTime accuracy shown to other users)
-     * - Manual status changes (away, custom status)
-     *
-     * Note: "online" status is automatically set by server on WebSocket connect,
-     * and "offline" is set on disconnect. You don't need to call this for basic online/offline.
-     *
-     * @param status - "online", "away", or custom status string
-     * @param customStatus - Optional custom status message
-     */
-    sendPresenceUpdate(status?: 'online' | 'away' | 'offline', customStatus?: string): void;
     /**
      * Stop the periodic catchup interval
      */

package/dist/local/sync/SyncWebSocket.js

@@ -53,13 +53,10 @@ export class SyncWebSocket extends WsTransport {
     }
     /**
      * The open ritual, run by the transport between its `connected` emit and the
-     * heartbeat start: announce presence, tell the server where we left off,
+     * heartbeat start: tell the server where we left off,
      * request the deltas we missed, and start the catch-up poll.
      */
     onOpened() {
-        // Send presence update with timezone (server sets presence to "online" on connect,
-        // this improves localTime accuracy by providing the user's actual timezone)
-        this.sendPresenceUpdate('online');
         // Immediately request incremental sync based on our stored cursor.
         // `requestIncrementalSync` is async — a bare call inside try/catch is a
         // rejection hole (the catch never sees it); route failures through
@@ -224,38 +221,6 @@ export class SyncWebSocket extends WsTransport {
     acknowledge(syncId) {
         this.sendAck(syncId);
     }
-    /**
-     * Send presence update to server.
-     * Use this for:
-     * - Updating timezone (improves localTime accuracy shown to other users)
-     * - Manual status changes (away, custom status)
-     *
-     * Note: "online" status is automatically set by server on WebSocket connect,
-     * and "offline" is set on disconnect. You don't need to call this for basic online/offline.
-     *
-     * @param status - "online", "away", or custom status string
-     * @param customStatus - Optional custom status message
-     */
-    sendPresenceUpdate(status = 'online', customStatus) {
-        if (!this.isConnected())
-            return;
-        const timezone = (() => {
-            try {
-                return Intl.DateTimeFormat().resolvedOptions().timeZone;
-            }
-            catch {
-                return 'UTC';
-            }
-        })();
-        this.send({
-            type: 'presence_update',
-            payload: {
-                status,
-                timezone,
-                ...(customStatus ? { customStatus } : {}),
-            },
-        });
-    }
     /**
      * Stop the periodic catchup interval
      */