Core types

All types are exported from @equationalapplications/core-llm-wiki. This is an abridged view. Your editor’s IntelliSense has the full JSDoc.

WikiFact

interface WikiFact {
  id: string;
  entity_id: string;
  title: string;
  body: string;
  tags: string[];
  confidence: 'certain' | 'inferred' | 'tentative';
  source_type: 'user_stated' | 'librarian_inferred' | 'user_confirmed' | 'immutable_document';
  source_ref: string | null;
  source_hash: string | null;
  created_at: number;           // epoch ms
  updated_at: number;
  last_accessed_at: number | null;
  access_count: number;
  deleted_at: number | null;    // soft delete
  okf_type?: string | null;     // ontology node type
  lifecycle_status?: 'draft' | 'stable' | 'deprecated';
  valid_from?: number | null;   // temporal window [valid_from, valid_to)
  valid_to?: number | null;
  superseded_by?: string | null;
  // …plus OKF provenance: okf_sources, okf_verified, generated_by, stale_after, …
}

WikiEvent

interface WikiEvent {
  id: string;
  entity_id: string;
  event_type: 'observation' | 'decision' | 'action' | 'outcome';
  summary: string;
  related_entry_id?: string | null;
  created_at: number;           // ingestion time (ordering key)
  occurred_at?: number | null;  // real-world time
}

MemoryBundle

interface MemoryBundle {
  facts: WikiFact[];
  tasks: WikiTask[];
  events: WikiEvent[];
  edges?: WikiEdge[];
  summary?: string;
  librarian_watermark?: { at: number; id: string }; // set by export only
  factScores?: Record<string, number>; // multi-entity reads with a non-empty query
  metadata?: {                         // multi-entity reads
    query: string;
    entityIds: string[];
    tierWeights?: Record<string, number>;
    tierFloors?: Record<string, number>;
  };
}

librarian_watermark is the source store’s librarian position, set by exportDump() and getMemoryBundle() when the entity has one. A merge import trusts events at or before it as already consolidated at the source and keeps their dates.

WikiEdge

interface WikiEdge {
  id: string;
  entity_id: string;
  source_id: string;
  target_id: string;
  edge_type: string;
  created_at: number;
}

OntologyManifest

interface OntologyManifest {
  node_types: Array<{ type: string; description: string; parent_type?: string }>;
  edge_types: Array<{ type: string; source_type: string; target_type: string; description: string }>;
}
type OntologyMode = 'off' | 'strict' | 'emergent';

ReadOptions

interface ReadOptions {
  maxResults?: number;
  preFilterLimit?: number | null;   // null disables a config-level value
  hybridWeight?: number;
  tierWeights?: Record<string, number>;
  tierFloors?: Record<string, number>;
  includeZeroWeightEntities?: boolean;
  excludeDrafts?: boolean;
  asOf?: number;
  tokenBudget?: number;
}

Ingest result

{
  chunks: number;           // LLM calls made
  ingestedChunks: number;   // chunks whose facts were committed
  failedChunks: number;
  truncated: boolean;       // a hard split happened
  parseFailures?: ChunkFailure[]; // present when failedChunks > 0
}