agentgui 1.0.110 → 1.0.111

package/lib/machines.ts

@@ -1,190 +0,0 @@
-/**
- * MACHINES.TS - XState state machines for conversations and sync
- * Guarantees valid state transitions and explicit error recovery
- * All possible paths tested and verified
- */
-
-import { createMachine, assign, actions } from 'xstate';
-import { SyncMachineContext, SyncState, ConversationStatus } from './types';
-
-const { send } = actions;
-
-// ============================================================================
-// CONVERSATION SYNC STATE MACHINE
-// ============================================================================
-
-export const conversationSyncMachine = createMachine(
-  {
-    id: 'conversationSync',
-    initial: 'idle',
-    context: {
-      conversationId: undefined,
-      messageId: undefined,
-      lastError: undefined,
-      retryCount: 0,
-      syncData: {},
-    },
-    states: {
-      // IDLE: Waiting for work
-      idle: {
-        on: {
-          LOAD_CONVERSATIONS: {
-            target: 'loading',
-            actions: assign({
-              retryCount: 0,
-              lastError: undefined,
-            }),
-          },
-          SYNC_CONVERSATIONS: {
-            target: 'syncing',
-            actions: assign({
-              retryCount: 0,
-              lastError: undefined,
-            }),
-          },
-          OFFLINE: 'offline',
-        },
-      },
-
-      // LOADING: Initial load of conversations
-      loading: {
-        on: {
-          LOAD_SUCCESS: {
-            target: 'synced',
-            actions: assign({
-              syncData: (context, event: any) => event.data,
-            }),
-          },
-          LOAD_ERROR: {
-            target: 'error',
-            actions: assign({
-              lastError: (context, event: any) => event.error,
-            }),
-          },
-          OFFLINE: 'offline',
-        },
-        after: {
-          30000: { // 30 second timeout
-            target: 'error',
-            actions: assign({
-              lastError: new Error('Load timeout (30s)'),
-            }),
-          },
-        },
-      },
-
-      // SYNCING: Active sync operation
-      syncing: {
-        on: {
-          SYNC_SUCCESS: {
-            target: 'synced',
-            actions: assign({
-              syncData: (context, event: any) => event.data,
-            }),
-          },
-          SYNC_ERROR: {
-            target: 'error',
-            actions: assign({
-              lastError: (context, event: any) => event.error,
-              retryCount: (context) => context.retryCount + 1,
-            }),
-          },
-          OFFLINE: 'offline',
-        },
-        after: {
-          60000: { // 60 second timeout
-            target: 'error',
-            actions: assign({
-              lastError: new Error('Sync timeout (60s)'),
-            }),
-          },
-        },
-      },
-
-      // SYNCED: Data is current
-      synced: {
-        on: {
-          CHANGE_DETECTED: 'syncing',
-          OFFLINE: 'offline',
-          REFRESH: 'loading',
-        },
-      },
-
-      // ERROR: Sync failed
-      error: {
-        on: {
-          RETRY: {
-            target: 'syncing',
-            cond: (context) => context.retryCount < 5,
-            actions: assign({
-              retryCount: (context) => context.retryCount + 1,
-            }),
-          },
-          MANUAL_RETRY: {
-            target: 'syncing',
-            actions: assign({
-              retryCount: 0,
-            }),
-          },
-          OFFLINE: 'offline',
-          RESET: 'idle',
-        },
-        after: {
-          // Exponential backoff: 1s, 2s, 4s, 8s, 16s
-          [Math.min(1000 * Math.pow(2, 0), 16000)]: {
-            target: 'syncing',
-            cond: (context) => context.retryCount < 5,
-            actions: assign({
-              retryCount: (context) => context.retryCount + 1,
-            }),
-          },
-        },
-      },
-
-      // OFFLINE: Network unavailable
-      offline: {
-        on: {
-          ONLINE: {
-            target: 'loading',
-            actions: assign({
-              retryCount: 0,
-            }),
-          },
-          RESET: 'idle',
-        },
-      },
-
-      // RECONCILING: Merging local and remote changes
-      reconciling: {
-        on: {
-          RECONCILE_SUCCESS: 'synced',
-          RECONCILE_FAILED: 'error',
-          OFFLINE: 'offline',
-        },
-        after: {
-          5000: {
-            target: 'error',
-            actions: assign({
-              lastError: new Error('Reconciliation timeout (5s)'),
-            }),
-          },
-        },
-      },
-    },
-  },
-  {
-    guards: {
-      canRetry: (context) => context.retryCount < 5,
-    },
-    actions: {
-      logError: (context, event) => {
-        console.error('[ConversationSync] Error:', (event as any).error?.message);
-      },
-      logRetry: (context) => {
-        const delay = Math.min(1000 * Math.pow(2, context.retryCount), 16000);
-        console.log(`[ConversationSync] Retrying in ${delay}ms (attempt ${context.retryCount + 1}/5)`);
-      },
-    },
-  }
-);
-

package/lib/schemas.ts

@@ -1,190 +0,0 @@
-/**
- * SCHEMAS.TS - Zod validation schemas for all data structures
- * Ensures data integrity at every boundary (API, database, client)
- * Provides type-safe parsing and validation
- */
-
-import { z } from 'zod';
-
-// ============================================================================
-// CONVERSATION SCHEMAS
-// ============================================================================
-
-export const ConversationStatusSchema = z.enum(['active', 'archived', 'deleted']);
-
-export const ConversationSchema = z.object({
-  id: z.string().min(1),
-  agentId: z.string().min(1),
-  title: z.string().nullable().optional(),
-  created_at: z.number().int().positive(),
-  updated_at: z.number().int().positive(),
-  status: ConversationStatusSchema,
-  agentType: z.string().optional(),
-  source: z.enum(['gui', 'imported']).optional(),
-  externalId: z.string().optional(),
-  firstPrompt: z.string().optional(),
-  messageCount: z.number().int().nonnegative().optional(),
-  projectPath: z.string().optional(),
-  gitBranch: z.string().optional(),
-  sourcePath: z.string().optional(),
-  lastSyncedAt: z.number().int().optional(),
-});
-
-export const ConversationCreateInputSchema = z.object({
-  agentId: z.string().min(1, 'agentId is required'),
-  title: z.string().max(500).nullable().optional(),
-});
-
-export const ConversationUpdateInputSchema = z.object({
-  title: z.string().max(500).optional(),
-  status: ConversationStatusSchema.optional(),
-});
-
-export const ConversationsListSchema = z.object({
-  conversations: z.array(ConversationSchema),
-  total: z.number().int().nonnegative(),
-});
-
-// ============================================================================
-// MESSAGE SCHEMAS
-// ============================================================================
-
-export const MessageRoleSchema = z.enum(['user', 'assistant', 'system']);
-
-export const MessageSchema = z.object({
-  id: z.string().min(1),
-  conversationId: z.string().min(1),
-  role: MessageRoleSchema,
-  content: z.string(),
-  created_at: z.number().int().positive(),
-});
-
-export const MessageCreateInputSchema = z.object({
-  conversationId: z.string().min(1),
-  role: MessageRoleSchema,
-  content: z.string().min(1, 'content cannot be empty').max(1000000),
-  idempotencyKey: z.string().optional(),
-});
-
-export const MessagesListSchema = z.object({
-  messages: z.array(MessageSchema),
-  total: z.number().int().nonnegative(),
-  hasMore: z.boolean(),
-});
-
-// ============================================================================
-// SESSION SCHEMAS
-// ============================================================================
-
-export const SessionStatusSchema = z.enum(['pending', 'processing', 'completed', 'error', 'cancelled']);
-
-export const SessionResponseSchema = z.object({
-  text: z.string(),
-  messageId: z.string().min(1),
-});
-
-export const SessionSchema = z.object({
-  id: z.string().min(1),
-  conversationId: z.string().min(1),
-  status: SessionStatusSchema,
-  started_at: z.number().int().positive(),
-  completed_at: z.number().int().positive().optional(),
-  response: SessionResponseSchema.optional(),
-  error: z.string().optional(),
-});
-
-// ============================================================================
-// SYNC STATE SCHEMAS
-// ============================================================================
-
-export const SyncStateSchema = z.enum(['idle', 'loading', 'synced', 'error', 'offline', 'reconciling']);
-
-export const SyncStatusSchema = z.object({
-  state: SyncStateSchema,
-  lastSyncTime: z.number().int().optional(),
-  nextRetryTime: z.number().int().optional(),
-  error: z.string().optional(),
-  retryCount: z.number().int().nonnegative(),
-  maxRetries: z.number().int().positive(),
-});
-
-export const SyncEventTypeSchema = z.enum([
-  'conversation_created',
-  'conversation_updated',
-  'conversation_deleted',
-  'message_created',
-  'message_updated',
-  'message_deleted',
-  'sync_started',
-  'sync_completed',
-  'sync_failed',
-  'offline_detected',
-  'online_detected',
-]);
-
-export const SyncEventSchema = z.object({
-  type: SyncEventTypeSchema,
-  timestamp: z.number().int().positive(),
-  data: z.record(z.unknown()),
-});
-
-// ============================================================================
-// PAGINATION SCHEMAS
-// ============================================================================
-
-export const PaginationParamsSchema = z.object({
-  limit: z.number().int().positive().max(100),
-  offset: z.number().int().nonnegative(),
-});
-
-export const PaginatedResultSchema = <T extends z.ZodTypeAny>(itemSchema: T) =>
-  z.object({
-    items: z.array(itemSchema),
-    total: z.number().int().nonnegative(),
-    limit: z.number().int().positive(),
-    offset: z.number().int().nonnegative(),
-    hasMore: z.boolean(),
-  });
-
-// ============================================================================
-// IDEMPOTENCY SCHEMAS
-// ============================================================================
-
-export const IdempotencyKeySchema = z.object({
-  key: z.string().min(1),
-  value: z.string(),
-  created_at: z.number().int().positive(),
-  ttl: z.number().int().positive(),
-});
-
-// ============================================================================
-// API RESPONSE SCHEMAS
-// ============================================================================
-
-export const ApiResponseSchema = <T extends z.ZodTypeAny>(dataSchema: T) =>
-  z.object({
-    data: dataSchema.optional(),
-    error: z.string().optional(),
-    timestamp: z.number().int().positive(),
-  });
-
-// ============================================================================
-// VALIDATION HELPER FUNCTIONS
-// ============================================================================
-
-export function validateConversation(data: unknown) {
-  try {
-    return { valid: true, data: ConversationSchema.parse(data) };
-  } catch (error) {
-    return { valid: false, error: String(error) };
-  }
-}
-
-export function validateMessage(data: unknown) {
-  try {
-    return { valid: true, data: MessageSchema.parse(data) };
-  } catch (error) {
-    return { valid: false, error: String(error) };
-  }
-}
-