@agentmemory/agentmemory 0.7.2 → 0.7.3

package/src/types.ts

@@ -1,769 +0,0 @@
-export interface Session {
-  id: string;
-  project: string;
-  cwd: string;
-  startedAt: string;
-  endedAt?: string;
-  status: "active" | "completed" | "abandoned";
-  observationCount: number;
-  model?: string;
-  tags?: string[];
-}
-
-export interface RawObservation {
-  id: string;
-  sessionId: string;
-  timestamp: string;
-  hookType: HookType;
-  toolName?: string;
-  toolInput?: unknown;
-  toolOutput?: unknown;
-  userPrompt?: string;
-  assistantResponse?: string;
-  raw: unknown;
-}
-
-export interface CompressedObservation {
-  id: string;
-  sessionId: string;
-  timestamp: string;
-  type: ObservationType;
-  title: string;
-  subtitle?: string;
-  facts: string[];
-  narrative: string;
-  concepts: string[];
-  files: string[];
-  importance: number;
-  confidence?: number;
-}
-
-export type ObservationType =
-  | "file_read"
-  | "file_write"
-  | "file_edit"
-  | "command_run"
-  | "search"
-  | "web_fetch"
-  | "conversation"
-  | "error"
-  | "decision"
-  | "discovery"
-  | "subagent"
-  | "notification"
-  | "task"
-  | "other";
-
-export interface Memory {
-  id: string;
-  createdAt: string;
-  updatedAt: string;
-  type: "pattern" | "preference" | "architecture" | "bug" | "workflow" | "fact";
-  title: string;
-  content: string;
-  concepts: string[];
-  files: string[];
-  sessionIds: string[];
-  strength: number;
-  version: number;
-  parentId?: string;
-  supersedes?: string[];
-  relatedIds?: string[];
-  sourceObservationIds?: string[];
-  isLatest: boolean;
-  forgetAfter?: string;
-}
-
-export interface SessionSummary {
-  sessionId: string;
-  project: string;
-  createdAt: string;
-  title: string;
-  narrative: string;
-  keyDecisions: string[];
-  filesModified: string[];
-  concepts: string[];
-  observationCount: number;
-}
-
-export type HookType =
-  | "session_start"
-  | "prompt_submit"
-  | "pre_tool_use"
-  | "post_tool_use"
-  | "post_tool_failure"
-  | "pre_compact"
-  | "subagent_start"
-  | "subagent_stop"
-  | "notification"
-  | "task_completed"
-  | "stop"
-  | "session_end";
-
-export interface HookPayload {
-  hookType: HookType;
-  sessionId: string;
-  project: string;
-  cwd: string;
-  timestamp: string;
-  data: unknown;
-}
-
-export interface ProviderConfig {
-  provider: ProviderType;
-  model: string;
-  maxTokens: number;
-}
-
-export type ProviderType = "agent-sdk" | "anthropic" | "gemini" | "openrouter";
-
-export interface MemoryProvider {
-  name: string;
-  compress(systemPrompt: string, userPrompt: string): Promise<string>;
-  summarize(systemPrompt: string, userPrompt: string): Promise<string>;
-}
-
-export interface AgentMemoryConfig {
-  engineUrl: string;
-  restPort: number;
-  streamsPort: number;
-  provider: ProviderConfig;
-  tokenBudget: number;
-  maxObservationsPerSession: number;
-  compressionModel: string;
-  dataDir: string;
-}
-
-export interface SearchResult {
-  observation: CompressedObservation;
-  score: number;
-  sessionId: string;
-}
-
-export interface ContextBlock {
-  type: "summary" | "observation" | "memory";
-  content: string;
-  tokens: number;
-  recency: number;
-}
-
-export interface EvalResult {
-  valid: boolean;
-  errors: string[];
-  qualityScore: number;
-  latencyMs: number;
-  functionId: string;
-}
-
-export interface FunctionMetrics {
-  functionId: string;
-  totalCalls: number;
-  successCount: number;
-  failureCount: number;
-  avgLatencyMs: number;
-  avgQualityScore: number;
-}
-
-export interface HealthSnapshot {
-  connectionState: string;
-  workers: Array<{ id: string; name: string; status: string }>;
-  memory: {
-    heapUsed: number;
-    heapTotal: number;
-    rss: number;
-    external: number;
-  };
-  cpu: { userMicros: number; systemMicros: number; percent: number };
-  eventLoopLagMs: number;
-  uptimeSeconds: number;
-  kvConnectivity?: { status: string; latencyMs?: number; error?: string };
-  status: "healthy" | "degraded" | "critical";
-  alerts: string[];
-}
-
-export interface CircuitBreakerState {
-  state: "closed" | "open" | "half-open";
-  failures: number;
-  lastFailureAt: number | null;
-  openedAt: number | null;
-}
-
-export interface EmbeddingProvider {
-  name: string;
-  dimensions: number;
-  embed(text: string): Promise<Float32Array>;
-  embedBatch(texts: string[]): Promise<Float32Array[]>;
-}
-
-export interface MemoryRelation {
-  type: "supersedes" | "extends" | "derives" | "contradicts" | "related";
-  sourceId: string;
-  targetId: string;
-  createdAt: string;
-  confidence?: number;
-}
-
-export interface HybridSearchResult {
-  observation: CompressedObservation;
-  bm25Score: number;
-  vectorScore: number;
-  graphScore: number;
-  combinedScore: number;
-  sessionId: string;
-  graphContext?: string;
-}
-
-export interface CompactSearchResult {
-  obsId: string;
-  sessionId: string;
-  title: string;
-  type: ObservationType;
-  score: number;
-  timestamp: string;
-}
-
-export interface TimelineEntry {
-  observation: CompressedObservation;
-  sessionId: string;
-  relativePosition: number;
-}
-
-export interface ProjectProfile {
-  project: string;
-  updatedAt: string;
-  topConcepts: Array<{ concept: string; frequency: number }>;
-  topFiles: Array<{ file: string; frequency: number }>;
-  conventions: string[];
-  commonErrors: string[];
-  recentActivity: string[];
-  sessionCount: number;
-  totalObservations: number;
-  summary?: string;
-}
-
-export interface ExportPagination {
-  offset: number;
-  limit: number;
-  total: number;
-  hasMore: boolean;
-}
-
-export interface ExportData {
-  version: "0.3.0" | "0.4.0" | "0.5.0" | "0.6.0" | "0.6.1" | "0.7.0" | "0.7.2";
-  exportedAt: string;
-  sessions: Session[];
-  observations: Record<string, CompressedObservation[]>;
-  memories: Memory[];
-  summaries: SessionSummary[];
-  profiles?: ProjectProfile[];
-  graphNodes?: GraphNode[];
-  graphEdges?: GraphEdge[];
-  semanticMemories?: SemanticMemory[];
-  proceduralMemories?: ProceduralMemory[];
-  actions?: Action[];
-  actionEdges?: ActionEdge[];
-  routines?: Routine[];
-  signals?: Signal[];
-  checkpoints?: Checkpoint[];
-  sentinels?: Sentinel[];
-  sketches?: Sketch[];
-  crystals?: Crystal[];
-  facets?: Facet[];
-  lessons?: Lesson[];
-  pagination?: ExportPagination;
-}
-
-export interface EmbeddingConfig {
-  provider?: string;
-  bm25Weight: number;
-  vectorWeight: number;
-}
-
-export interface FallbackConfig {
-  providers: ProviderType[];
-}
-
-export interface ClaudeBridgeConfig {
-  enabled: boolean;
-  projectPath: string;
-  memoryFilePath: string;
-  lineBudget: number;
-}
-
-export interface StandaloneConfig {
-  dataDir: string;
-  persistPath: string;
-  agentType?: string;
-}
-
-export type GraphNodeType =
-  | "file"
-  | "function"
-  | "concept"
-  | "error"
-  | "decision"
-  | "pattern"
-  | "library"
-  | "person"
-  | "project"
-  | "preference"
-  | "location"
-  | "organization"
-  | "event";
-
-export interface GraphNode {
-  id: string;
-  type: GraphNodeType;
-  name: string;
-  properties: Record<string, unknown>;
-  sourceObservationIds: string[];
-  createdAt: string;
-  updatedAt?: string;
-  aliases?: string[];
-  stale?: boolean;
-}
-
-export type GraphEdgeType =
-  | "uses"
-  | "imports"
-  | "modifies"
-  | "causes"
-  | "fixes"
-  | "depends_on"
-  | "related_to"
-  | "works_at"
-  | "prefers"
-  | "blocked_by"
-  | "caused_by"
-  | "optimizes_for"
-  | "rejected"
-  | "avoids"
-  | "located_in"
-  | "succeeded_by";
-
-export interface GraphEdge {
-  id: string;
-  type: GraphEdgeType;
-  sourceNodeId: string;
-  targetNodeId: string;
-  weight: number;
-  sourceObservationIds: string[];
-  createdAt: string;
-  tcommit?: string;
-  tvalid?: string;
-  tvalidEnd?: string;
-  context?: EdgeContext;
-  version?: number;
-  supersededBy?: string;
-  isLatest?: boolean;
-  stale?: boolean;
-}
-
-export interface EdgeContext {
-  reasoning?: string;
-  sentiment?: string;
-  alternatives?: string[];
-  situationalFactors?: string[];
-  confidence?: number;
-}
-
-export interface GraphQueryResult {
-  nodes: GraphNode[];
-  edges: GraphEdge[];
-  depth: number;
-}
-
-export type ConsolidationTier =
-  | "working"
-  | "episodic"
-  | "semantic"
-  | "procedural";
-
-export interface SemanticMemory {
-  id: string;
-  fact: string;
-  confidence: number;
-  sourceSessionIds: string[];
-  sourceMemoryIds: string[];
-  accessCount: number;
-  lastAccessedAt: string;
-  strength: number;
-  createdAt: string;
-  updatedAt: string;
-}
-
-export interface ProceduralMemory {
-  id: string;
-  name: string;
-  steps: string[];
-  triggerCondition: string;
-  frequency: number;
-  sourceSessionIds: string[];
-  strength: number;
-  createdAt: string;
-  updatedAt: string;
-}
-
-export interface TeamConfig {
-  teamId: string;
-  userId: string;
-  mode: "shared" | "private";
-}
-
-export interface TeamSharedItem {
-  id: string;
-  sharedBy: string;
-  sharedAt: string;
-  type: "observation" | "memory" | "pattern";
-  content: unknown;
-  project: string;
-  visibility: "shared" | "private";
-}
-
-export interface TeamProfile {
-  teamId: string;
-  members: string[];
-  topConcepts: Array<{ concept: string; frequency: number }>;
-  topFiles: Array<{ file: string; frequency: number }>;
-  sharedPatterns: string[];
-  totalSharedItems: number;
-  updatedAt: string;
-}
-
-export interface AuditEntry {
-  id: string;
-  timestamp: string;
-  operation:
-    | "observe"
-    | "compress"
-    | "remember"
-    | "forget"
-    | "evolve"
-    | "consolidate"
-    | "share"
-    | "delete"
-    | "import"
-    | "export"
-    | "action_create"
-    | "action_update"
-    | "lease_acquire"
-    | "lease_release"
-    | "routine_run"
-    | "signal_send"
-    | "checkpoint_resolve"
-    | "mesh_sync"
-    | "sentinel_create"
-    | "sentinel_trigger"
-    | "sketch_create"
-    | "sketch_promote"
-    | "sketch_discard"
-    | "crystallize"
-    | "diagnose"
-    | "heal"
-    | "facet_tag"
-    | "lesson_save"
-    | "lesson_recall"
-    | "lesson_strengthen"
-    | "obsidian_export";
-  userId?: string;
-  functionId: string;
-  targetIds: string[];
-  details: Record<string, unknown>;
-  qualityScore?: number;
-}
-
-export interface GovernanceFilter {
-  type?: string[];
-  dateFrom?: string;
-  dateTo?: string;
-  project?: string;
-  qualityBelow?: number;
-}
-
-export interface SnapshotMeta {
-  id: string;
-  commitHash: string;
-  createdAt: string;
-  message: string;
-  stats: {
-    sessions: number;
-    observations: number;
-    memories: number;
-    graphNodes: number;
-  };
-}
-
-export interface SnapshotDiff {
-  fromCommit: string;
-  toCommit: string;
-  added: { memories: number; observations: number; graphNodes: number };
-  removed: { memories: number; observations: number; graphNodes: number };
-}
-
-export interface Action {
-  id: string;
-  title: string;
-  description: string;
-  status: "pending" | "active" | "done" | "blocked" | "cancelled";
-  priority: number;
-  createdAt: string;
-  updatedAt: string;
-  createdBy: string;
-  assignedTo?: string;
-  project?: string;
-  tags: string[];
-  sourceObservationIds: string[];
-  sourceMemoryIds: string[];
-  result?: string;
-  parentId?: string;
-  metadata?: Record<string, unknown>;
-  sketchId?: string;
-  crystallizedInto?: string;
-}
-
-export type ActionEdgeType =
-  | "requires"
-  | "unlocks"
-  | "spawned_by"
-  | "gated_by"
-  | "conflicts_with";
-
-export interface ActionEdge {
-  id: string;
-  type: ActionEdgeType;
-  sourceActionId: string;
-  targetActionId: string;
-  createdAt: string;
-  metadata?: Record<string, unknown>;
-}
-
-export interface Lease {
-  id: string;
-  actionId: string;
-  agentId: string;
-  acquiredAt: string;
-  expiresAt: string;
-  renewedAt?: string;
-  status: "active" | "expired" | "released";
-}
-
-export interface Routine {
-  id: string;
-  name: string;
-  description: string;
-  steps: RoutineStep[];
-  createdAt: string;
-  updatedAt: string;
-  frozen: boolean;
-  tags: string[];
-  sourceProceduralIds: string[];
-}
-
-export interface RoutineStep {
-  order: number;
-  title: string;
-  description: string;
-  actionTemplate: Partial<Action>;
-  dependsOn: number[];
-}
-
-export interface RoutineRun {
-  id: string;
-  routineId: string;
-  status: "running" | "completed" | "failed" | "paused";
-  startedAt: string;
-  completedAt?: string;
-  actionIds: string[];
-  stepStatus: Record<number, "pending" | "active" | "done" | "failed">;
-  initiatedBy: string;
-}
-
-export interface Signal {
-  id: string;
-  from: string;
-  to?: string;
-  threadId?: string;
-  replyTo?: string;
-  type: "info" | "request" | "response" | "alert" | "handoff";
-  content: string;
-  metadata?: Record<string, unknown>;
-  createdAt: string;
-  readAt?: string;
-  expiresAt?: string;
-}
-
-export interface Checkpoint {
-  id: string;
-  name: string;
-  description: string;
-  status: "pending" | "passed" | "failed" | "expired";
-  type: "ci" | "approval" | "deploy" | "external" | "timer";
-  createdAt: string;
-  resolvedAt?: string;
-  resolvedBy?: string;
-  result?: unknown;
-  expiresAt?: string;
-  linkedActionIds: string[];
-}
-
-export interface Sketch {
-  id: string;
-  title: string;
-  description: string;
-  status: "active" | "promoted" | "discarded";
-  actionIds: string[];
-  project?: string;
-  createdAt: string;
-  expiresAt: string;
-  promotedAt?: string;
-  discardedAt?: string;
-}
-
-export interface Facet {
-  id: string;
-  targetId: string;
-  targetType: "action" | "memory" | "observation";
-  dimension: string;
-  value: string;
-  createdAt: string;
-}
-
-export interface Sentinel {
-  id: string;
-  name: string;
-  type: "webhook" | "timer" | "threshold" | "pattern" | "approval" | "custom";
-  status: "watching" | "triggered" | "cancelled" | "expired";
-  config: Record<string, unknown>;
-  result?: unknown;
-  createdAt: string;
-  triggeredAt?: string;
-  expiresAt?: string;
-  linkedActionIds: string[];
-  escalatedAt?: string;
-}
-
-export interface Crystal {
-  id: string;
-  narrative: string;
-  keyOutcomes: string[];
-  filesAffected: string[];
-  lessons: string[];
-  sourceActionIds: string[];
-  sessionId?: string;
-  project?: string;
-  createdAt: string;
-}
-
-export interface Lesson {
-  id: string;
-  content: string;
-  context: string;
-  confidence: number;
-  reinforcements: number;
-  source: "crystal" | "manual" | "consolidation";
-  sourceIds: string[];
-  project?: string;
-  tags: string[];
-  createdAt: string;
-  updatedAt: string;
-  lastReinforcedAt?: string;
-  lastDecayedAt?: string;
-  decayRate: number;
-  deleted?: boolean;
-}
-
-export interface DiagnosticCheck {
-  name: string;
-  category: string;
-  status: "pass" | "warn" | "fail";
-  message: string;
-  fixable: boolean;
-}
-
-export interface MeshPeer {
-  id: string;
-  url: string;
-  name: string;
-  lastSyncAt?: string;
-  status: "connected" | "disconnected" | "syncing" | "error";
-  sharedScopes: string[];
-  syncFilter?: { project?: string };
-}
-
-
-export interface EnrichedChunk {
-  id: string;
-  originalObsId: string;
-  sessionId: string;
-  content: string;
-  resolvedEntities: Record<string, string>;
-  preferences: string[];
-  contextBridges: string[];
-  windowStart: number;
-  windowEnd: number;
-  createdAt: string;
-}
-
-export interface LatentEmbedding {
-  obsId: string;
-  contentEmbedding: string;
-  latentEmbedding: string;
-  sessionId: string;
-}
-
-export interface QueryExpansion {
-  original: string;
-  reformulations: string[];
-  temporalConcretizations: string[];
-  entityExtractions: string[];
-}
-
-export interface TripleStreamResult {
-  observation: CompressedObservation;
-  vectorScore: number;
-  bm25Score: number;
-  graphScore: number;
-  combinedScore: number;
-  sessionId: string;
-  graphContext?: string;
-}
-
-export interface TemporalQuery {
-  entityName: string;
-  asOf?: string;
-  from?: string;
-  to?: string;
-  includeHistory?: boolean;
-}
-
-export interface TemporalState {
-  entity: GraphNode;
-  currentEdges: GraphEdge[];
-  historicalEdges: GraphEdge[];
-  timeline: Array<{
-    edge: GraphEdge;
-    validFrom: string;
-    validTo?: string;
-    context?: EdgeContext;
-  }>;
-}
-
-export interface RetentionScore {
-  memoryId: string;
-  score: number;
-  salience: number;
-  temporalDecay: number;
-  reinforcementBoost: number;
-  lastAccessed: string;
-  accessCount: number;
-}
-
-export interface DecayConfig {
-  lambda: number;
-  sigma: number;
-  tierThresholds: {
-    hot: number;
-    warm: number;
-    cold: number;
-  };
-}