@agentmemory/agentmemory 0.7.0

package/src/types.ts

@@ -0,0 +1,769 @@
+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";
+  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;
+  };
+}