@revealui/sync 0.2.1 → 0.3.1

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,34 +1,34 @@
 {
   "name": "@revealui/sync",
-  "version": "0.2.1",
-  "experimental": true,
-  "license": "MIT",
-  "files": [
-    "dist"
-  ],
+  "version": "0.3.1",
   "description": "ElectricSQL sync utilities for RevealUI",
+  "license": "MIT",
   "dependencies": {
     "@electric-sql/react": "^1.0.27",
     "lib0": "^0.2.117",
     "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.1",
+    "@revealui/contracts": "1.3.1"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "^6.6.4",
-    "@types/ws": "^8.5.14",
     "@testing-library/react": "^16.3.0",
     "@testing-library/react-hooks": "^8.0.1",
-    "@vitest/coverage-v8": "^4.0.18",
-    "jsdom": "^27.4.0",
+    "@types/ws": "^8.5.14",
+    "@vitest/coverage-v8": "^4.1.0",
+    "jsdom": "^29.0.1",
     "react": "^19.2.3",
     "react-dom": "^19.2.3",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.18",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.0",
     "dev": "0.0.1"
   },
+  "engines": {
+    "node": ">=24.13.0"
+  },
+  "experimental": true,
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -47,6 +47,9 @@
       "import": "./dist/collab/server-index.js"
     }
   },
+  "files": [
+    "dist"
+  ],
   "main": "./dist/index.js",
   "publishConfig": {
     "access": "public",
@@ -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"
   }