@revealui/sync 0.2.1 → 0.3.0

package/README.md

@@ -1,15 +1,15 @@
 # @revealui/sync
 
-ElectricSQL sync utilities for RevealUI - real-time data synchronization with local-first architecture.
+ElectricSQL sync utilities for RevealUI — real-time data synchronization with local-first architecture.
 
 ## Features
 
-- **ElectricSQL Integration**: Real-time sync with ElectricSQL
-- **React Hooks**: Use sync data in React components
+- **ElectricSQL Integration**: Real-time sync via shape subscriptions
+- **React Hooks**: Subscribe to synced data in React components
+- **Mutations**: Create, update, and delete records via authenticated REST endpoints
 - **Type-safe**: Full TypeScript support with database types
-- **Local-first**: Works offline, syncs when online
 - **React Provider**: Easy setup with `ElectricProvider`
-- **Optimistic Updates**: Instant UI updates with server reconciliation
+- **Yjs Collaboration**: CRDT-based real-time collaborative editing
 
 ## Installation
 
@@ -28,27 +28,29 @@ import { ElectricProvider } from '@revealui/sync/provider'
 
 export default function App() {
   return (
-    <ElectricProvider>
+    <ElectricProvider proxyBaseUrl="https://cms.revealui.com">
       <YourComponents />
     </ElectricProvider>
   )
 }
 ```
 
-### Use Synced Data
+### Read Synced Data
+
+Hooks subscribe to ElectricSQL shapes via authenticated proxy routes. Data updates in real-time as the database changes.
 
 ```typescript
 import { useAgentContexts } from '@revealui/sync'
 
 function MyComponent() {
-  const { data: contexts, isLoading } = useAgentContexts()
+  const { contexts, isLoading } = useAgentContexts()
 
   if (isLoading) return <div>Loading...</div>
 
   return (
     <ul>
       {contexts.map(context => (
-        <li key={context.id}>{context.name}</li>
+        <li key={context.id}>{JSON.stringify(context.context)}</li>
       ))}
     </ul>
   )
@@ -57,18 +59,29 @@ function MyComponent() {
 
 ### Mutations
 
+Each hook returns `create`, `update`, and `remove` functions. Mutations go through authenticated REST endpoints at `/api/sync/*`. ElectricSQL picks up the database changes and pushes updates to all subscribers automatically.
+
 ```typescript
 import { useAgentContexts } from '@revealui/sync'
 
 function CreateContext() {
-  const { create } = useAgentContexts()
+  const { contexts, create, update, remove } = useAgentContexts()
 
   const handleCreate = async () => {
-    await create({
-      name: 'New Context',
-      agent_id: 'agent-123',
-      // ... other fields
+    const result = await create({
+      agent_id: 'assistant',
+      context: { theme: 'dark', language: 'en' },
+      priority: 0.8,
     })
+    if (!result.success) console.error(result.error)
+  }
+
+  const handleUpdate = async (id: string) => {
+    await update(id, { context: { theme: 'light' } })
+  }
+
+  const handleDelete = async (id: string) => {
+    await remove(id)
   }
 
   return <button onClick={handleCreate}>Create</button>
@@ -79,139 +92,96 @@ function CreateContext() {
 
 ### `useAgentContexts()`
 
-Sync agent contexts (task context, working memory, etc.)
+Subscribe to agent contexts (task context, working memory).
 
 ```typescript
 const {
-  data,        // Agent contexts array
-  isLoading,   // Loading state
-  error,       // Error state
-  create,      // Create function
-  update,      // Update function
-  remove       // Delete function
+  contexts,    // AgentContextRecord[]
+  isLoading,   // boolean
+  error,       // Error | null
+  create,      // (data: CreateAgentContextInput) => Promise<MutationResult>
+  update,      // (id: string, data: UpdateAgentContextInput) => Promise<MutationResult>
+  remove,      // (id: string) => Promise<MutationResult>
 } = useAgentContexts()
 ```
 
-### `useAgentMemory()`
+### `useAgentMemory(agentId)`
 
-Sync agent memory (episodic, semantic, working)
+Subscribe to agent memory (episodic, semantic, working) filtered by agent ID.
 
 ```typescript
 const {
-  data,        // Memory entries array
-  isLoading,
-  error,
-  create,
-  update,
-  remove
-} = useAgentMemory()
+  memories,    // AgentMemoryRecord[]
+  isLoading,   // boolean
+  error,       // Error | null
+  create,      // (data: CreateAgentMemoryInput) => Promise<MutationResult>
+  update,      // (id: string, data: UpdateAgentMemoryInput) => Promise<MutationResult>
+  remove,      // (id: string) => Promise<MutationResult>
+} = useAgentMemory('assistant')
 ```
 
-### `useConversations()`
+### `useConversations(userId)`
 
-Sync conversation history
+Subscribe to conversation history. Server-side proxy enforces row-level filtering by session — the `userId` parameter is for API compatibility but filtering is handled server-side.
 
 ```typescript
 const {
-  data,        // Conversations array
-  isLoading,
-  error,
-  create,
-  update,
-  remove
-} = useConversations()
+  conversations,  // ConversationRecord[]
+  isLoading,      // boolean
+  error,          // Error | null
+  create,         // (data: CreateConversationInput) => Promise<MutationResult>
+  update,         // (id: string, data: UpdateConversationInput) => Promise<MutationResult>
+  remove,         // (id: string) => Promise<MutationResult>
+} = useConversations(userId)
 ```
 
 ## How It Works
 
-1. **ElectricSQL Service**: Runs as a sync service between Postgres and clients
-2. **Shape Subscriptions**: Subscribe to "shapes" of data (queries)
-3. **Local Cache**: Data cached locally in browser
-4. **Real-time Updates**: Changes propagate instantly to all connected clients
-5. **Conflict Resolution**: CRDT-based conflict resolution for offline edits
+1. **Reads**: ElectricSQL shape subscriptions via authenticated CMS proxy (`/api/shapes/*`)
+2. **Writes**: REST mutations via CMS API (`/api/sync/*`) → Postgres → ElectricSQL replication
+3. **Real-time**: Database changes propagate to all shape subscribers automatically
+4. **Auth**: All endpoints require a valid session cookie
 
-## Environment Variables
+## Collaboration (Yjs)
 
-```env
-# ElectricSQL service URL
-NEXT_PUBLIC_ELECTRIC_SERVICE_URL=http://localhost:5133
+The collab layer provides CRDT-based collaborative editing:
 
-# Optional: Server-side Electric URL (if different)
-ELECTRIC_SERVICE_URL=http://localhost:5133
+```typescript
+import { useCollaboration } from '@revealui/sync'
+
+function Editor() {
+  const { doc, synced, connectedUsers } = useCollaboration({
+    documentId: 'doc-uuid',
+    serverUrl: 'ws://localhost:4000',
+  })
+  // ...
+}
 ```
 
-## Development
+Server-side agents can use `AgentCollabClient` from `@revealui/sync/collab/server`.
 
-```bash
-# Build package
-pnpm --filter @revealui/sync build
+## Environment Variables
 
-# Watch mode
-pnpm --filter @revealui/sync dev
+```env
+# ElectricSQL service URL (used by CMS proxy)
+ELECTRIC_SERVICE_URL=http://localhost:5133
 
-# Run tests
-pnpm --filter @revealui/sync test
+# Optional: Electric auth secret
+ELECTRIC_SECRET=your-secret
 
-# Type check
-pnpm --filter @revealui/sync typecheck
+# Client-side (stored in provider context)
+NEXT_PUBLIC_ELECTRIC_SERVICE_URL=http://localhost:5133
 ```
 
-## Testing
+## Development
 
 ```bash
-# Run all tests
-pnpm --filter @revealui/sync test
-
-# Watch mode
-pnpm --filter @revealui/sync test:watch
-
-# Coverage
-pnpm --filter @revealui/sync test:coverage
+pnpm --filter @revealui/sync build      # Build
+pnpm --filter @revealui/sync dev        # Watch mode
+pnpm --filter @revealui/sync test       # Run tests
+pnpm --filter @revealui/sync typecheck  # Type check
 ```
 
-## Architecture
-
-```
-┌─────────────────┐
-│  React Component │
-│  (useAgentContexts) │
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│  ElectricSQL    │
-│  Shape Hook     │
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│  Electric Sync  │
-│  Service        │
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│  PostgreSQL     │
-│  Database       │
-└─────────────────┘
-```
-
-## Limitations
-
-⚠️ **CRITICAL**: ElectricSQL API endpoints need independent verification before production use.
-
-**Status:** ⚠️ NEEDS VERIFICATION
-- ElectricSQL integration exists but requires testing
-- API endpoints based on assumptions
-- No integration tests performed yet
-- Verify against your deployment before relying on sync in production
-
-## Related Documentation
-
-- [ElectricSQL Documentation](https://electric-sql.com/docs) - Official ElectricSQL docs
-- [Architecture](../../docs/ARCHITECTURE.md) - System architecture overview
-- [Database Guide](../../docs/DATABASE.md) - Database setup
-
 ## License
 
 MIT

package/dist/collab/agent-client-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-client-factory.d.ts","sourceRoot":"","sources":["../../src/collab/agent-client-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAsB,MAAM,mBAAmB,CAAA;AAIzE,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CAgBtF;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,wBAAwB,GAAG;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7D,OAAO,CAAC,iBAAiB,CAAC,CAK5B"}
+{"version":3,"file":"agent-client-factory.d.ts","sourceRoot":"","sources":["../../src/collab/agent-client-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAsB,MAAM,mBAAmB,CAAC;AAI1E,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CAgBtF;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,wBAAwB,GAAG;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7D,OAAO,CAAC,iBAAiB,CAAC,CAK5B"}

package/dist/collab/agent-client.d.ts

@@ -31,6 +31,7 @@ export declare class AgentCollabClient extends Observable<string> {
     private updateHandler;
     private awarenessUpdateHandler;
     private destroyed;
+    private pendingSyncAbort;
     constructor(options: AgentCollabClientOptions);
     connect(): void;
     disconnect(): void;

package/dist/collab/agent-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-client.d.ts","sourceRoot":"","sources":["../../src/collab/agent-client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C,OAAO,KAAK,iBAAiB,MAAM,uBAAuB,CAAA;AAE1D,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAQxB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,aAAa,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,qBAAa,iBAAkB,SAAQ,UAAU,CAAC,MAAM,CAAC;IACvD,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAA;IACnB,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC,SAAS,CAAA;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;IAExC,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,iBAAiB,CAAI;IAC7B,OAAO,CAAC,cAAc,CAA6C;IACnE,OAAO,CAAC,aAAa,CAA+D;IACpF,OAAO,CAAC,sBAAsB,CAGrB;IACT,OAAO,CAAC,SAAS,CAAQ;gBAEb,OAAO,EAAE,wBAAwB;IA0B7C,OAAO,IAAI,IAAI;IAcf,UAAU,IAAI,IAAI;IAkBlB,WAAW,IAAI,CAAC,CAAC,GAAG;IAIpB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI;IAI9B,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAMrC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAI/D,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAI9D,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAQhD,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI;IAU5D,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAUzD,WAAW,CAAC,SAAS,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB5C,OAAO,IAAI,IAAI;IASf,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,UAAU;IAoClB,OAAO,CAAC,aAAa;IA+BrB,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,eAAe;CAOxB"}
+{"version":3,"file":"agent-client.d.ts","sourceRoot":"","sources":["../../src/collab/agent-client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,KAAK,iBAAiB,MAAM,uBAAuB,CAAC;AAE3D,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAOzB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,aAAa,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,iBAAkB,SAAQ,UAAU,CAAC,MAAM,CAAC;IACvD,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC,SAAS,CAAC;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IAEzC,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,aAAa,CAAgE;IACrF,OAAO,CAAC,sBAAsB,CAGpB;IACV,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,gBAAgB,CAA6B;gBAEzC,OAAO,EAAE,wBAAwB;IA0B7C,OAAO,IAAI,IAAI;IAcf,UAAU,IAAI,IAAI;IAkBlB,WAAW,IAAI,CAAC,CAAC,GAAG;IAIpB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI;IAI9B,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAIrC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAI/D,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAI9D,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAQhD,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI;IAU5D,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAUzD,WAAW,CAAC,SAAS,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA+B5C,OAAO,IAAI,IAAI;IAUf,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,UAAU;IAoClB,OAAO,CAAC,aAAa;IAoCrB,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,eAAe;CAOxB"}

package/dist/collab/agent-client.js

@@ -5,8 +5,7 @@ import WebSocket from 'ws';
 import * as awarenessProtocol from 'y-protocols/awareness';
 import * as syncProtocol from 'y-protocols/sync';
 import * as Y from 'yjs';
-const MESSAGE_SYNC = 0;
-const MESSAGE_AWARENESS = 1;
+import { MESSAGE_AWARENESS, MESSAGE_SYNC } from './protocol-constants.js';
 const MAX_RECONNECT_ATTEMPTS = 5;
 const BASE_RECONNECT_DELAY = 1000;
 const RECONNECT_MULTIPLIER = 2;
@@ -26,6 +25,7 @@ export class AgentCollabClient extends Observable {
     updateHandler = null;
     awarenessUpdateHandler;
     destroyed = false;
+    pendingSyncAbort = null;
     constructor(options) {
         super();
         this.serverUrl = options.serverUrl;
@@ -83,8 +83,6 @@ export class AgentCollabClient extends Observable {
         return this.doc.getText(name ?? this.defaultTextName);
     }
     getTextContent(name) {
-        // Y.Text.toString() returns the text content — ESLint doesn't recognize this
-        // eslint-disable-next-line @typescript-eslint/no-base-to-string
         return this.getText(name).toString();
     }
     insertText(index, content, name) {
@@ -122,22 +120,33 @@ export class AgentCollabClient extends Observable {
         if (this.synced)
             return Promise.resolve();
         return new Promise((resolve, reject) => {
-            const timeout = setTimeout(() => {
+            const cleanup = () => {
+                clearTimeout(timeout);
                 this.off('sync', handler);
+                if (this.pendingSyncAbort === abort)
+                    this.pendingSyncAbort = null;
+            };
+            const timeout = setTimeout(() => {
+                cleanup();
                 reject(new Error(`Sync timeout after ${timeoutMs}ms`));
             }, timeoutMs);
             const handler = (isSynced) => {
                 if (isSynced) {
-                    clearTimeout(timeout);
-                    this.off('sync', handler);
+                    cleanup();
                     resolve();
                 }
             };
+            const abort = () => {
+                cleanup();
+                reject(new Error('Client destroyed while waiting for sync'));
+            };
+            this.pendingSyncAbort = abort;
             this.on('sync', handler);
         });
     }
     destroy() {
         this.destroyed = true;
+        this.pendingSyncAbort?.();
         this.awareness.off('update', this.awarenessUpdateHandler);
         this.disconnect();
         this.awareness.destroy();

package/dist/collab/index.d.ts

@@ -1,3 +1,4 @@
+export { MESSAGE_AWARENESS, MESSAGE_SYNC } from './protocol-constants.js';
 export type { CollabDocumentState } from './use-collab-document.js';
 export { useCollabDocument } from './use-collab-document.js';
 export type { CollaborationIdentity, UseCollaborationOptions, UseCollaborationResult, } from './use-collaboration.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collab/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collab/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC1E,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/collab/index.js

@@ -1,3 +1,4 @@
+export { MESSAGE_AWARENESS, MESSAGE_SYNC } from './protocol-constants.js';
 export { useCollabDocument } from './use-collab-document.js';
 export { useCollaboration } from './use-collaboration.js';
 export { CollabProvider } from './yjs-websocket-provider.js';

package/dist/collab/protocol-constants.d.ts

@@ -0,0 +1,5 @@
+/** Yjs sync protocol message type */
+export declare const MESSAGE_SYNC = 0;
+/** Yjs awareness protocol message type */
+export declare const MESSAGE_AWARENESS = 1;
+//# sourceMappingURL=protocol-constants.d.ts.map

package/dist/collab/protocol-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-constants.d.ts","sourceRoot":"","sources":["../../src/collab/protocol-constants.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B,0CAA0C;AAC1C,eAAO,MAAM,iBAAiB,IAAI,CAAC"}

package/dist/collab/protocol-constants.js

@@ -0,0 +1,4 @@
+/** Yjs sync protocol message type */
+export const MESSAGE_SYNC = 0;
+/** Yjs awareness protocol message type */
+export const MESSAGE_AWARENESS = 1;

package/dist/collab/server-index.d.ts

@@ -2,4 +2,5 @@ export type { AgentCollabClientOptions, AgentIdentity } from './agent-client.js'
 export { AgentCollabClient } from './agent-client.js';
 export type { CreateAgentClientOptions } from './agent-client-factory.js';
 export { createAgentClient, createAndConnectAgentClient } from './agent-client-factory.js';
+export { MESSAGE_AWARENESS, MESSAGE_SYNC } from './protocol-constants.js';
 //# sourceMappingURL=server-index.d.ts.map

package/dist/collab/server-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-index.d.ts","sourceRoot":"","sources":["../../src/collab/server-index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,YAAY,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA;AACzE,OAAO,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAA"}
+{"version":3,"file":"server-index.d.ts","sourceRoot":"","sources":["../../src/collab/server-index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAC3F,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/collab/server-index.js

@@ -1,2 +1,3 @@
 export { AgentCollabClient } from './agent-client.js';
 export { createAgentClient, createAndConnectAgentClient } from './agent-client-factory.js';
+export { MESSAGE_AWARENESS, MESSAGE_SYNC } from './protocol-constants.js';

package/dist/collab/use-collab-document.d.ts

@@ -4,5 +4,5 @@ export interface CollabDocumentState {
     isLoading: boolean;
     error: Error | null;
 }
-export declare function useCollabDocument(documentId: string, electricUrl: string): CollabDocumentState;
+export declare function useCollabDocument(documentId: string): CollabDocumentState;
 //# sourceMappingURL=use-collab-document.d.ts.map

package/dist/collab/use-collab-document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-collab-document.d.ts","sourceRoot":"","sources":["../../src/collab/use-collab-document.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,UAAU,GAAG,IAAI,CAAA;IAC/B,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB;AAKD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,mBAAmB,CA+C9F"}
+{"version":3,"file":"use-collab-document.d.ts","sourceRoot":"","sources":["../../src/collab/use-collab-document.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,UAAU,GAAG,IAAI,CAAC;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAKD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,mBAAmB,CAiDzE"}

package/dist/collab/use-collab-document.js

@@ -1,18 +1,21 @@
 import { useShape } from '@electric-sql/react';
+import { fetchWithTimeout } from '../fetch-with-timeout.js';
+import { useElectricConfig } from '../provider/index.js';
 // UUID v4 pattern — only format accepted as a yjs_documents PK
 const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-export function useCollabDocument(documentId, electricUrl) {
+export function useCollabDocument(documentId) {
+    const { proxyBaseUrl } = useElectricConfig();
     // Validate before interpolating into the WHERE clause. yjs_documents PKs are
     // always UUIDs — reject anything else so no untrusted string enters the query.
     const isValidId = UUID_RE.test(documentId);
     // Hook must always be called (Rules of Hooks). Pass an impossible WHERE when
     // the ID is invalid so the shape returns no rows but the hook still runs.
     const { data, isLoading, error } = useShape({
-        url: `${electricUrl}/v1/shape`,
+        url: `${proxyBaseUrl}/api/shapes/yjs-documents`,
         params: {
-            table: 'yjs_documents',
-            where: isValidId ? `id = '${documentId}'` : `id = 'invalid'`,
+            document_id: isValidId ? documentId : '__invalid__',
         },
+        fetchClient: fetchWithTimeout,
     });
     if (!isValidId) {
         return {

package/dist/collab/use-collaboration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-collaboration.d.ts","sourceRoot":"","sources":["../../src/collab/use-collaboration.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAE5D,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAA;IACxB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,YAAY,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAChC,QAAQ,CAAC,EAAE,qBAAqB,CAAA;CACjC;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,IAAI,CAAA;IACjB,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAA;IAC/B,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;CAC1C;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,UAAU,EACV,SAAS,EACT,OAAc,EACd,YAAmB,EACnB,QAAQ,GACT,EAAE,uBAAuB,GAAG,sBAAsB,CAqElD"}
+{"version":3,"file":"use-collaboration.d.ts","sourceRoot":"","sources":["../../src/collab/use-collaboration.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC;IAClB,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC3C;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,UAAU,EACV,SAAS,EACT,OAAc,EACd,YAAmB,EACnB,QAAQ,GACT,EAAE,uBAAuB,GAAG,sBAAsB,CAqElD"}

package/dist/collab/yjs-websocket-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"yjs-websocket-provider.d.ts","sourceRoot":"","sources":["../../src/collab/yjs-websocket-provider.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,KAAK,iBAAiB,MAAM,uBAAuB,CAAA;AAE1D,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAQxB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAC3C;AAED,qBAAa,cAAe,SAAQ,UAAU,CAAC,MAAM,CAAC;IACpD,GAAG,EAAE,CAAC,CAAC,GAAG,CAAA;IACV,SAAS,EAAE,iBAAiB,CAAC,SAAS,CAAA;IACtC,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,iBAAiB,CAAI;IAC7B,OAAO,CAAC,cAAc,CAA6C;IACnE,OAAO,CAAC,aAAa,CAA+D;IACpF,OAAO,CAAC,sBAAsB,CAGrB;gBAGP,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,CAAC,CAAC,GAAG,EACV,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;KAAE;IA2BhD,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAI9C,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC;IAU9C,OAAO,IAAI,IAAI;IAuFf,UAAU,IAAI,IAAI;IAmBlB,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,eAAe;IAQvB,OAAO,IAAI,IAAI;CAMhB"}
+{"version":3,"file":"yjs-websocket-provider.d.ts","sourceRoot":"","sources":["../../src/collab/yjs-websocket-provider.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,iBAAiB,MAAM,uBAAuB,CAAC;AAE3D,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAOzB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C;AAED,qBAAa,cAAe,SAAQ,UAAU,CAAC,MAAM,CAAC;IACpD,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC;IACX,SAAS,EAAE,iBAAiB,CAAC,SAAS,CAAC;IACvC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,aAAa,CAAgE;IACrF,OAAO,CAAC,sBAAsB,CAGpB;gBAGR,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,CAAC,CAAC,GAAG,EACV,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;KAAE;IA2BhD,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAI9C,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC;IAU9C,OAAO,IAAI,IAAI;IAuFf,UAAU,IAAI,IAAI;IAmBlB,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,eAAe;IAQvB,OAAO,IAAI,IAAI;CAMhB"}

package/dist/collab/yjs-websocket-provider.js

@@ -4,8 +4,7 @@ import { Observable } from 'lib0/observable';
 import * as awarenessProtocol from 'y-protocols/awareness';
 import * as syncProtocol from 'y-protocols/sync';
 import * as Y from 'yjs';
-const MESSAGE_SYNC = 0;
-const MESSAGE_AWARENESS = 1;
+import { MESSAGE_AWARENESS, MESSAGE_SYNC } from './protocol-constants.js';
 const MAX_RECONNECT_ATTEMPTS = 10;
 const BASE_RECONNECT_DELAY = 1000;
 const RECONNECT_MULTIPLIER = 1.5;

package/dist/fetch-with-timeout.d.ts

@@ -0,0 +1,7 @@
+/**
+ * A fetch wrapper that aborts requests after {@link SHAPE_FETCH_TIMEOUT_MS} (10 s).
+ * Passed as `fetchClient` to ElectricSQL `useShape` so that shape subscription
+ * requests to the CMS proxy do not hang indefinitely.
+ */
+export declare function fetchWithTimeout(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
+//# sourceMappingURL=fetch-with-timeout.d.ts.map

package/dist/fetch-with-timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-with-timeout.d.ts","sourceRoot":"","sources":["../src/fetch-with-timeout.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAoBhG"}

package/dist/fetch-with-timeout.js

@@ -0,0 +1,27 @@
+/** Default timeout for Electric shape proxy fetch requests (milliseconds). */
+const SHAPE_FETCH_TIMEOUT_MS = 10_000;
+/**
+ * A fetch wrapper that aborts requests after {@link SHAPE_FETCH_TIMEOUT_MS} (10 s).
+ * Passed as `fetchClient` to ElectricSQL `useShape` so that shape subscription
+ * requests to the CMS proxy do not hang indefinitely.
+ */
+export function fetchWithTimeout(input, init) {
+    // If the caller already provides a signal, respect it and compose with our timeout.
+    const externalSignal = init?.signal;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), SHAPE_FETCH_TIMEOUT_MS);
+    // If the external signal aborts, forward to our controller.
+    if (externalSignal) {
+        if (externalSignal.aborted) {
+            controller.abort(externalSignal.reason);
+        }
+        else {
+            externalSignal.addEventListener('abort', () => controller.abort(externalSignal.reason), {
+                once: true,
+            });
+        }
+    }
+    return fetch(input, { ...init, signal: controller.signal }).finally(() => {
+        clearTimeout(timeout);
+    });
+}

package/dist/hooks/useAgentContexts.d.ts

@@ -0,0 +1,29 @@
+import type { MutationResult } from '../mutations.js';
+export interface AgentContextRecord {
+    id: string;
+    session_id: string;
+    agent_id: string;
+    context: Record<string, unknown>;
+    priority: number;
+    created_at: string;
+    updated_at: string;
+}
+export interface CreateAgentContextInput {
+    agent_id: string;
+    context?: Record<string, unknown>;
+    priority?: number;
+}
+export interface UpdateAgentContextInput {
+    context?: Record<string, unknown>;
+    priority?: number;
+}
+export interface UseAgentContextsResult {
+    contexts: AgentContextRecord[];
+    isLoading: boolean;
+    error: Error | null;
+    create: (data: CreateAgentContextInput) => Promise<MutationResult<AgentContextRecord>>;
+    update: (id: string, data: UpdateAgentContextInput) => Promise<MutationResult<AgentContextRecord>>;
+    remove: (id: string) => Promise<MutationResult<void>>;
+}
+export declare function useAgentContexts(): UseAgentContextsResult;
+//# sourceMappingURL=useAgentContexts.d.ts.map

package/dist/hooks/useAgentContexts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentContexts.d.ts","sourceRoot":"","sources":["../../src/hooks/useAgentContexts.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAKtD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,CAAC,IAAI,EAAE,uBAAuB,KAAK,OAAO,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACvF,MAAM,EAAE,CACN,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,uBAAuB,KAC1B,OAAO,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACjD,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;CACvD;AAED,wBAAgB,gBAAgB,IAAI,sBAAsB,CAqBzD"}

package/dist/hooks/useAgentContexts.js

@@ -0,0 +1,22 @@
+'use client';
+import { useShape } from '@electric-sql/react';
+import { fetchWithTimeout } from '../fetch-with-timeout.js';
+import { useSyncMutations } from '../mutations.js';
+import { useElectricConfig } from '../provider/index.js';
+import { toRecords } from '../shape-utils.js';
+export function useAgentContexts() {
+    const { proxyBaseUrl } = useElectricConfig();
+    const { data, isLoading, error } = useShape({
+        url: `${proxyBaseUrl}/api/shapes/agent-contexts`,
+        fetchClient: fetchWithTimeout,
+    });
+    const { create, update, remove } = useSyncMutations('agent-contexts');
+    return {
+        contexts: toRecords(data),
+        isLoading,
+        error: error || null,
+        create,
+        update,
+        remove,
+    };
+}

package/dist/hooks/useAgentMemory.d.ts

@@ -0,0 +1,34 @@
+import type { MutationResult } from '../mutations.js';
+export interface AgentMemoryRecord {
+    id: string;
+    agent_id: string;
+    content: string;
+    type: string;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    expires_at: string | null;
+}
+export interface CreateAgentMemoryInput {
+    agent_id: string;
+    content: string;
+    type: string;
+    source: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    expires_at?: string | null;
+}
+export interface UpdateAgentMemoryInput {
+    content?: string;
+    type?: string;
+    metadata?: Record<string, unknown>;
+    expires_at?: string | null;
+}
+export interface UseAgentMemoryResult {
+    memories: AgentMemoryRecord[];
+    isLoading: boolean;
+    error: Error | null;
+    create: (data: CreateAgentMemoryInput) => Promise<MutationResult<AgentMemoryRecord>>;
+    update: (id: string, data: UpdateAgentMemoryInput) => Promise<MutationResult<AgentMemoryRecord>>;
+    remove: (id: string) => Promise<MutationResult<void>>;
+}
+export declare function useAgentMemory(agentId: string): UseAgentMemoryResult;
+//# sourceMappingURL=useAgentMemory.d.ts.map

package/dist/hooks/useAgentMemory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentMemory.d.ts","sourceRoot":"","sources":["../../src/hooks/useAgentMemory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAOtD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACrF,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,KAAK,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACjG,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;CACvD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAuCpE"}

package/dist/hooks/useAgentMemory.js

@@ -0,0 +1,37 @@
+'use client';
+import { useShape } from '@electric-sql/react';
+import { fetchWithTimeout } from '../fetch-with-timeout.js';
+import { useSyncMutations } from '../mutations.js';
+import { useElectricConfig } from '../provider/index.js';
+import { toRecords } from '../shape-utils.js';
+const AGENT_ID_RE = /^[a-zA-Z0-9_-]+$/;
+export function useAgentMemory(agentId) {
+    const { proxyBaseUrl } = useElectricConfig();
+    const isValid = agentId.length > 0 && AGENT_ID_RE.test(agentId);
+    // Hook must always be called (Rules of Hooks). Pass an impossible WHERE when
+    // the ID is invalid so the shape returns no rows but the hook still runs.
+    const { data, isLoading, error } = useShape({
+        url: `${proxyBaseUrl}/api/shapes/agent-memories`,
+        params: { agent_id: isValid ? agentId : '00000000-0000-0000-0000-000000000000' },
+        fetchClient: fetchWithTimeout,
+    });
+    const { create, update, remove } = useSyncMutations('agent-memories');
+    if (!isValid) {
+        return {
+            memories: [],
+            isLoading: false,
+            error: new Error('Invalid agentId: must be non-empty alphanumeric, hyphens, underscores only'),
+            create,
+            update,
+            remove,
+        };
+    }
+    return {
+        memories: toRecords(data),
+        isLoading,
+        error: error || null,
+        create,
+        update,
+        remove,
+    };
+}

package/dist/hooks/useConversations.d.ts

@@ -1,11 +1,31 @@
-type ConversationRecord = {
-    id: string | number;
+import type { MutationResult } from '../mutations.js';
+export interface ConversationRecord {
+    id: string;
+    user_id: string;
+    agent_id: string;
     title?: string | null;
-};
-export declare function useConversations(_userId: string): {
+    status: string;
+    device_id?: string | null;
+    version: number;
+    created_at: string;
+    updated_at: string;
+}
+export interface CreateConversationInput {
+    agent_id: string;
+    title?: string;
+    device_id?: string;
+}
+export interface UpdateConversationInput {
+    title?: string;
+    status?: string;
+}
+export interface UseConversationsResult {
     conversations: ConversationRecord[];
     isLoading: boolean;
     error: Error | null;
-};
-export {};
+    create: (data: CreateConversationInput) => Promise<MutationResult<ConversationRecord>>;
+    update: (id: string, data: UpdateConversationInput) => Promise<MutationResult<ConversationRecord>>;
+    remove: (id: string) => Promise<MutationResult<void>>;
+}
+export declare function useConversations(_userId: string): UseConversationsResult;
 //# sourceMappingURL=useConversations.d.ts.map

package/dist/hooks/useConversations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useConversations.d.ts","sourceRoot":"","sources":["../../src/hooks/useConversations.ts"],"names":[],"mappings":"AAIA,KAAK,kBAAkB,GAAG;IACxB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB,CAAA;AAID,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM;;;WAU5B,KAAK,GAAG,IAAI;EAE/B"}
+{"version":3,"file":"useConversations.d.ts","sourceRoot":"","sources":["../../src/hooks/useConversations.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAKtD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,kBAAkB,EAAE,CAAC;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,CAAC,IAAI,EAAE,uBAAuB,KAAK,OAAO,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACvF,MAAM,EAAE,CACN,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,uBAAuB,KAC1B,OAAO,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACjD,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;CACvD;AAID,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB,CAuBxE"}

package/dist/hooks/useConversations.js

@@ -1,16 +1,26 @@
 'use client';
 import { useShape } from '@electric-sql/react';
+import { fetchWithTimeout } from '../fetch-with-timeout.js';
+import { useSyncMutations } from '../mutations.js';
+import { useElectricConfig } from '../provider/index.js';
+import { toRecords } from '../shape-utils.js';
 // _userId kept for API compatibility — filtering is enforced by the server-side
 // proxy at /api/shapes/conversations, which reads the session cookie directly.
 export function useConversations(_userId) {
+    const { proxyBaseUrl } = useElectricConfig();
     // The proxy validates the session and enforces row-level filtering server-side.
     // Client-provided params are not forwarded — the proxy overrides them.
     const { data, isLoading, error } = useShape({
-        url: `/api/shapes/conversations`,
+        url: `${proxyBaseUrl}/api/shapes/conversations`,
+        fetchClient: fetchWithTimeout,
     });
+    const { create, update, remove } = useSyncMutations('conversations');
     return {
-        conversations: Array.isArray(data) ? data : [],
+        conversations: toRecords(data),
         isLoading,
-        error: error,
+        error: error || null,
+        create,
+        update,
+        remove,
     };
 }

package/dist/hooks/useCoordinationSessions.d.ts

@@ -0,0 +1,35 @@
+import type { MutationResult } from '../mutations.js';
+export interface CoordinationSessionRecord {
+    id: string;
+    agent_id: string;
+    started_at: string;
+    ended_at: string | null;
+    task: string;
+    status: string;
+    pid: number | null;
+    tools: Record<string, number> | null;
+    metadata: Record<string, unknown> | null;
+}
+export interface CreateCoordinationSessionInput {
+    agent_id: string;
+    task?: string;
+    pid?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateCoordinationSessionInput {
+    task?: string;
+    status?: string;
+    ended_at?: string;
+    tools?: Record<string, number>;
+    metadata?: Record<string, unknown>;
+}
+export interface UseCoordinationSessionsResult {
+    sessions: CoordinationSessionRecord[];
+    isLoading: boolean;
+    error: Error | null;
+    create: (data: CreateCoordinationSessionInput) => Promise<MutationResult<CoordinationSessionRecord>>;
+    update: (id: string, data: UpdateCoordinationSessionInput) => Promise<MutationResult<CoordinationSessionRecord>>;
+    remove: (id: string) => Promise<MutationResult<void>>;
+}
+export declare function useCoordinationSessions(): UseCoordinationSessionsResult;
+//# sourceMappingURL=useCoordinationSessions.d.ts.map

package/dist/hooks/useCoordinationSessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCoordinationSessions.d.ts","sourceRoot":"","sources":["../../src/hooks/useCoordinationSessions.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAKtD,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,yBAAyB,EAAE,CAAC;IACtC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,CACN,IAAI,EAAE,8BAA8B,KACjC,OAAO,CAAC,cAAc,CAAC,yBAAyB,CAAC,CAAC,CAAC;IACxD,MAAM,EAAE,CACN,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,8BAA8B,KACjC,OAAO,CAAC,cAAc,CAAC,yBAAyB,CAAC,CAAC,CAAC;IACxD,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;CACvD;AAED,wBAAgB,uBAAuB,IAAI,6BAA6B,CAqBvE"}

package/dist/hooks/useCoordinationSessions.js

@@ -0,0 +1,22 @@
+'use client';
+import { useShape } from '@electric-sql/react';
+import { fetchWithTimeout } from '../fetch-with-timeout.js';
+import { useSyncMutations } from '../mutations.js';
+import { useElectricConfig } from '../provider/index.js';
+import { toRecords } from '../shape-utils.js';
+export function useCoordinationSessions() {
+    const { proxyBaseUrl } = useElectricConfig();
+    const { data, isLoading, error } = useShape({
+        url: `${proxyBaseUrl}/api/shapes/coordination-sessions`,
+        fetchClient: fetchWithTimeout,
+    });
+    const { create, update, remove } = useSyncMutations('coordination-sessions');
+    return {
+        sessions: toRecords(data),
+        isLoading,
+        error: error || null,
+        create,
+        update,
+        remove,
+    };
+}

package/dist/hooks/useCoordinationWorkItems.d.ts

@@ -0,0 +1,41 @@
+import type { MutationResult } from '../mutations.js';
+export interface CoordinationWorkItemRecord {
+    id: string;
+    title: string;
+    description: string | null;
+    status: string;
+    priority: number;
+    owner_agent: string | null;
+    owner_session: string | null;
+    parent_id: string | null;
+    metadata: Record<string, unknown> | null;
+    created_at: string;
+    updated_at: string;
+    completed_at: string | null;
+}
+export interface CreateCoordinationWorkItemInput {
+    title: string;
+    description?: string;
+    priority?: number;
+    owner_agent?: string;
+    parent_id?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateCoordinationWorkItemInput {
+    title?: string;
+    description?: string;
+    status?: string;
+    priority?: number;
+    owner_agent?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface UseCoordinationWorkItemsResult {
+    workItems: CoordinationWorkItemRecord[];
+    isLoading: boolean;
+    error: Error | null;
+    create: (data: CreateCoordinationWorkItemInput) => Promise<MutationResult<CoordinationWorkItemRecord>>;
+    update: (id: string, data: UpdateCoordinationWorkItemInput) => Promise<MutationResult<CoordinationWorkItemRecord>>;
+    remove: (id: string) => Promise<MutationResult<void>>;
+}
+export declare function useCoordinationWorkItems(): UseCoordinationWorkItemsResult;
+//# sourceMappingURL=useCoordinationWorkItems.d.ts.map

package/dist/hooks/useCoordinationWorkItems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCoordinationWorkItems.d.ts","sourceRoot":"","sources":["../../src/hooks/useCoordinationWorkItems.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAKtD,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,+BAA+B;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,+BAA+B;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,8BAA8B;IAC7C,SAAS,EAAE,0BAA0B,EAAE,CAAC;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,CACN,IAAI,EAAE,+BAA+B,KAClC,OAAO,CAAC,cAAc,CAAC,0BAA0B,CAAC,CAAC,CAAC;IACzD,MAAM,EAAE,CACN,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,+BAA+B,KAClC,OAAO,CAAC,cAAc,CAAC,0BAA0B,CAAC,CAAC,CAAC;IACzD,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;CACvD;AAED,wBAAgB,wBAAwB,IAAI,8BAA8B,CAqBzE"}

package/dist/hooks/useCoordinationWorkItems.js

@@ -0,0 +1,22 @@
+'use client';
+import { useShape } from '@electric-sql/react';
+import { fetchWithTimeout } from '../fetch-with-timeout.js';
+import { useSyncMutations } from '../mutations.js';
+import { useElectricConfig } from '../provider/index.js';
+import { toRecords } from '../shape-utils.js';
+export function useCoordinationWorkItems() {
+    const { proxyBaseUrl } = useElectricConfig();
+    const { data, isLoading, error } = useShape({
+        url: `${proxyBaseUrl}/api/shapes/coordination-work-items`,
+        fetchClient: fetchWithTimeout,
+    });
+    const { create, update, remove } = useSyncMutations('coordination-work-items');
+    return {
+        workItems: toRecords(data),
+        isLoading,
+        error: error || null,
+        create,
+        update,
+        remove,
+    };
+}

package/dist/index.d.ts

@@ -1,10 +1,26 @@
 /**
- * @experimental ElectricSQL sync is not yet functional.
- * The ElectricProvider is currently a passthrough that renders children without
- * establishing any sync connection. Do not use in production.
+ * @revealui/sync — Real-time collaboration and sync primitives.
+ *
+ * The collab layer (Yjs-based) is fully functional.
+ * ElectricProvider provides proxyBaseUrl config to child hooks. All hooks route
+ * through the authenticated CMS proxy at /api/shapes/* — no direct Electric client.
+ *
+ * Reads use ElectricSQL shape subscriptions for real-time updates.
+ * Writes use REST mutations via /api/sync/* — changes propagate to all
+ * subscribers automatically through ElectricSQL replication.
  */
 export type { CollabDocumentState, UseCollaborationOptions, UseCollaborationResult, } from './collab/index.js';
 export { CollabProvider, useCollabDocument, useCollaboration, } from './collab/index.js';
+export type { AgentContextRecord, CreateAgentContextInput, UpdateAgentContextInput, UseAgentContextsResult, } from './hooks/useAgentContexts.js';
+export { useAgentContexts } from './hooks/useAgentContexts.js';
+export type { AgentMemoryRecord, CreateAgentMemoryInput, UpdateAgentMemoryInput, UseAgentMemoryResult, } from './hooks/useAgentMemory.js';
+export { useAgentMemory } from './hooks/useAgentMemory.js';
+export type { ConversationRecord, CreateConversationInput, UpdateConversationInput, UseConversationsResult, } from './hooks/useConversations.js';
 export { useConversations } from './hooks/useConversations.js';
-export { ElectricProvider } from './provider/index.js';
+export type { CoordinationSessionRecord, CreateCoordinationSessionInput, UpdateCoordinationSessionInput, UseCoordinationSessionsResult, } from './hooks/useCoordinationSessions.js';
+export { useCoordinationSessions } from './hooks/useCoordinationSessions.js';
+export type { CoordinationWorkItemRecord, CreateCoordinationWorkItemInput, UpdateCoordinationWorkItemInput, UseCoordinationWorkItemsResult, } from './hooks/useCoordinationWorkItems.js';
+export { useCoordinationWorkItems } from './hooks/useCoordinationWorkItems.js';
+export type { MutationResult } from './mutations.js';
+export { ElectricProvider, useElectricConfig } from './provider/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,YAAY,EACV,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,YAAY,EACV,yBAAyB,EACzB,8BAA8B,EAC9B,8BAA8B,EAC9B,6BAA6B,GAC9B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,YAAY,EACV,0BAA0B,EAC1B,+BAA+B,EAC/B,+BAA+B,EAC/B,8BAA8B,GAC/B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -1,8 +1,18 @@
 /**
- * @experimental ElectricSQL sync is not yet functional.
- * The ElectricProvider is currently a passthrough that renders children without
- * establishing any sync connection. Do not use in production.
+ * @revealui/sync — Real-time collaboration and sync primitives.
+ *
+ * The collab layer (Yjs-based) is fully functional.
+ * ElectricProvider provides proxyBaseUrl config to child hooks. All hooks route
+ * through the authenticated CMS proxy at /api/shapes/* — no direct Electric client.
+ *
+ * Reads use ElectricSQL shape subscriptions for real-time updates.
+ * Writes use REST mutations via /api/sync/* — changes propagate to all
+ * subscribers automatically through ElectricSQL replication.
  */
 export { CollabProvider, useCollabDocument, useCollaboration, } from './collab/index.js';
+export { useAgentContexts } from './hooks/useAgentContexts.js';
+export { useAgentMemory } from './hooks/useAgentMemory.js';
 export { useConversations } from './hooks/useConversations.js';
-export { ElectricProvider } from './provider/index.js';
+export { useCoordinationSessions } from './hooks/useCoordinationSessions.js';
+export { useCoordinationWorkItems } from './hooks/useCoordinationWorkItems.js';
+export { ElectricProvider, useElectricConfig } from './provider/index.js';

package/dist/mutations.d.ts

@@ -0,0 +1,14 @@
+export interface MutationResult<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: string;
+}
+/**
+ * Hook that returns mutation functions for a given sync API endpoint.
+ */
+export declare function useSyncMutations<TCreate, TUpdate, TRecord>(endpoint: string): {
+    create: (data: TCreate) => Promise<MutationResult<TRecord>>;
+    update: (id: string, data: TUpdate) => Promise<MutationResult<TRecord>>;
+    remove: (id: string) => Promise<MutationResult<void>>;
+};
+//# sourceMappingURL=mutations.d.ts.map

package/dist/mutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../src/mutations.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA0CD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM;mBAK3D,OAAO,KAAG,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;iBAO5C,MAAM,QAAQ,OAAO,KAAG,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;iBAOxD,MAAM,KAAG,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;EAOpD"}

package/dist/mutations.js

@@ -0,0 +1,53 @@
+'use client';
+import { useCallback } from 'react';
+import { useElectricConfig } from './provider/index.js';
+/** Default timeout for mutation fetch requests (milliseconds). */
+const MUTATION_FETCH_TIMEOUT_MS = 10_000;
+/**
+ * Make an authenticated mutation request to the CMS API.
+ * Credentials are included so the session cookie is sent cross-origin.
+ * Requests are aborted after {@link MUTATION_FETCH_TIMEOUT_MS} (10 s).
+ */
+async function mutationFetch(url, method, body) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), MUTATION_FETCH_TIMEOUT_MS);
+    let response;
+    try {
+        response = await fetch(url, {
+            method,
+            credentials: 'include',
+            signal: controller.signal,
+            headers: body !== undefined ? { 'Content-Type': 'application/json' } : undefined,
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+    if (!response.ok) {
+        const errorData = (await response.json().catch(() => null));
+        return {
+            success: false,
+            error: errorData?.error ?? `Request failed with status ${response.status}`,
+        };
+    }
+    const data = (await response.json());
+    return { success: true, data };
+}
+/**
+ * Hook that returns mutation functions for a given sync API endpoint.
+ */
+export function useSyncMutations(endpoint) {
+    const { proxyBaseUrl } = useElectricConfig();
+    const baseUrl = `${proxyBaseUrl}/api/sync/${endpoint}`;
+    const create = useCallback(async (data) => {
+        return mutationFetch(baseUrl, 'POST', data);
+    }, [baseUrl]);
+    const update = useCallback(async (id, data) => {
+        return mutationFetch(`${baseUrl}/${encodeURIComponent(id)}`, 'PATCH', data);
+    }, [baseUrl]);
+    const remove = useCallback(async (id) => {
+        return mutationFetch(`${baseUrl}/${encodeURIComponent(id)}`, 'DELETE');
+    }, [baseUrl]);
+    return { create, update, remove };
+}

package/dist/provider/index.d.ts

@@ -1,11 +1,35 @@
-import type { ReactNode } from 'react';
+import { type ReactNode } from 'react';
+interface ElectricContextValue {
+    /**
+     * Direct Electric service URL (e.g. the Railway instance).
+     * Stored in context for future use — not consumed by the current proxy-based hooks.
+     * All hooks use proxyBaseUrl + /api/shapes/* instead.
+     */
+    serviceUrl: string | null;
+    /**
+     * Base URL prefix for authenticated CMS shape proxy routes.
+     * Default '' keeps all hook URLs relative (works for same-origin apps).
+     * Set to 'https://cms.revealui.com' when consuming from a different origin.
+     */
+    proxyBaseUrl: string;
+    debug: boolean;
+}
 /**
- * @experimental This provider is a passthrough — ElectricSQL integration is not yet implemented.
- * Children are rendered without any sync functionality.
+ * Provides ElectricSQL configuration to child hooks (`useConversations`, `useCollabDocument`).
+ *
+ * Provides proxyBaseUrl (and optional serviceUrl/debug) to child hooks via context.
+ * All hooks use the CMS proxy pattern — no direct Electric connection is established here.
  */
-export declare function ElectricProvider({ children, }: {
+export declare function ElectricProvider(props: {
     children: ReactNode;
     serviceUrl?: string;
+    proxyBaseUrl?: string;
     debug?: boolean;
-}): import("react/jsx-runtime").JSX.Element;
+}): ReactNode;
+/**
+ * Access the ElectricSQL configuration provided by `ElectricProvider`.
+ * Returns `{ serviceUrl: null, debug: false }` if no provider is present.
+ */
+export declare function useElectricConfig(): ElectricContextValue;
+export {};
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/provider/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,SAAS,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,2CAIA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/provider/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,SAAS,EAAgB,MAAM,OAAO,CAAC;AAEpE,UAAU,oBAAoB;IAC5B;;;;OAIG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;CAChB;AAQD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,QAAQ,EAAE,SAAS,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,SAAS,CAWZ;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,oBAAoB,CAExD"}

package/dist/provider/index.js

@@ -1,11 +1,29 @@
 'use client';
-import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, use, useMemo } from 'react';
+const ElectricContext = createContext({
+    serviceUrl: null,
+    proxyBaseUrl: '',
+    debug: false,
+});
 /**
- * @experimental This provider is a passthrough — ElectricSQL integration is not yet implemented.
- * Children are rendered without any sync functionality.
+ * Provides ElectricSQL configuration to child hooks (`useConversations`, `useCollabDocument`).
+ *
+ * Provides proxyBaseUrl (and optional serviceUrl/debug) to child hooks via context.
+ * All hooks use the CMS proxy pattern — no direct Electric connection is established here.
  */
-export function ElectricProvider({ children, }) {
-    // For now, just pass through children
-    // useShape hooks work directly with proxy API endpoints
-    return _jsx(_Fragment, { children: children });
+export function ElectricProvider(props) {
+    const value = useMemo(() => ({
+        serviceUrl: props.serviceUrl ?? null,
+        proxyBaseUrl: props.proxyBaseUrl ?? '',
+        debug: props.debug ?? false,
+    }), [props.serviceUrl, props.proxyBaseUrl, props.debug]);
+    return _jsx(ElectricContext, { value: value, children: props.children });
+}
+/**
+ * Access the ElectricSQL configuration provided by `ElectricProvider`.
+ * Returns `{ serviceUrl: null, debug: false }` if no provider is present.
+ */
+export function useElectricConfig() {
+    return use(ElectricContext);
 }

package/dist/shape-utils.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Cast ElectricSQL shape data to a typed record array.
+ *
+ * ElectricSQL's `useShape` returns `Row[]` (i.e. `Record<string, Value>[]`).
+ * Our record interfaces describe the exact same shape but lack the index
+ * signature that `Row` carries, so TypeScript rejects a direct assignment.
+ * This helper encapsulates the boundary cast in one place and returns an
+ * empty array when data is falsy.
+ */
+export declare function toRecords<T>(data: unknown[] | undefined): T[];
+//# sourceMappingURL=shape-utils.d.ts.map

package/dist/shape-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape-utils.d.ts","sourceRoot":"","sources":["../src/shape-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,SAAS,GAAG,CAAC,EAAE,CAG7D"}

package/dist/shape-utils.js

@@ -0,0 +1,14 @@
+/**
+ * Cast ElectricSQL shape data to a typed record array.
+ *
+ * ElectricSQL's `useShape` returns `Row[]` (i.e. `Record<string, Value>[]`).
+ * Our record interfaces describe the exact same shape but lack the index
+ * signature that `Row` carries, so TypeScript rejects a direct assignment.
+ * This helper encapsulates the boundary cast in one place and returns an
+ * empty array when data is falsy.
+ */
+export function toRecords(data) {
+    if (!Array.isArray(data))
+        return [];
+    return data;
+}

package/dist/test-setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-setup.d.ts","sourceRoot":"","sources":["../src/test-setup.ts"],"names":[],"mappings":"AAAA,OAAO,kCAAkC,CAAA"}
+{"version":3,"file":"test-setup.d.ts","sourceRoot":"","sources":["../src/test-setup.ts"],"names":[],"mappings":"AAAA,OAAO,kCAAkC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@revealui/sync",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "experimental": true,
   "license": "MIT",
   "files": [
@@ -13,8 +13,8 @@
     "ws": "^8.18.0",
     "y-protocols": "^1.0.7",
     "yjs": "^13.6.29",
-    "@revealui/contracts": "1.1.0",
-    "@revealui/db": "0.2.1"
+    "@revealui/db": "0.3.0",
+    "@revealui/contracts": "1.2.0"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "^6.6.4",
@@ -29,6 +29,9 @@
     "vitest": "^4.0.18",
     "dev": "0.0.1"
   },
+  "engines": {
+    "node": ">=24.13.0"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -59,9 +62,8 @@
     "clean": "rm -rf dist",
     "dev": "tsc --watch",
     "lint": "biome check .",
-    "lint:eslint": "eslint .",
     "test": "vitest run",
-    "test:coverage": "vitest run --coverage",
+    "test:coverage": "vitest run --coverage --coverage.reporter=json-summary --coverage.reporter=html --coverage.reporter=text",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit"
   }