@revealui/sync 0.2.1 → 0.3.1

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