@thread-memory/core 0.1.0

package/dist/store.d.ts

@@ -0,0 +1,170 @@
+import Database from "better-sqlite3";
+import type { EventKind, SessionEvent } from "./events.js";
+import type { DecisionStatus, GoalStatus } from "./state.js";
+import { SpillPolicy } from "./governor.js";
+export declare const EVENTS_SCHEMA = "\nCREATE TABLE IF NOT EXISTS events (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  session_id TEXT NOT NULL,\n  kind TEXT NOT NULL,\n  ts TEXT NOT NULL,\n  seq INTEGER NOT NULL,\n  body TEXT NOT NULL,\n  meta TEXT,\n  truncated INTEGER NOT NULL DEFAULT 0,\n  project_key TEXT,\n  scope TEXT NOT NULL DEFAULT 'project',\n  origin TEXT,\n  spilled INTEGER NOT NULL DEFAULT 0,\n  isolation INTEGER NOT NULL DEFAULT 0\n);\nCREATE INDEX IF NOT EXISTS idx_events_session ON events(session_id, seq);\n\nCREATE VIRTUAL TABLE IF NOT EXISTS events_fts USING fts5(\n  body,\n  content='events',\n  content_rowid='id',\n  tokenize='unicode61'\n);\n\nCREATE TABLE IF NOT EXISTS episodes (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  session_id TEXT NOT NULL,\n  seq_start INTEGER NOT NULL,\n  seq_end INTEGER,\n  status TEXT NOT NULL DEFAULT 'active',\n  summary TEXT,\n  created_at TEXT NOT NULL\n);\nCREATE INDEX IF NOT EXISTS idx_episodes_session ON episodes(session_id, id);\n\nCREATE TABLE IF NOT EXISTS spills (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  event_id INTEGER NOT NULL REFERENCES events(id),\n  ref TEXT NOT NULL,\n  blob TEXT,\n  sha256 TEXT NOT NULL,\n  created_at TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS lineage_edges (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  session_id TEXT NOT NULL,\n  src_type TEXT NOT NULL,\n  src_id INTEGER,\n  dst_type TEXT NOT NULL,\n  dst_id INTEGER,\n  ref TEXT,\n  edge_type TEXT NOT NULL,\n  confidence REAL NOT NULL DEFAULT 1.0,\n  ts TEXT NOT NULL\n);\nCREATE INDEX IF NOT EXISTS idx_lineage_src ON lineage_edges(session_id, src_type, src_id);\nCREATE INDEX IF NOT EXISTS idx_lineage_dst ON lineage_edges(session_id, dst_type, dst_id);\n\nCREATE TABLE IF NOT EXISTS schema_version (\n  version INTEGER NOT NULL,\n  applied_at TEXT NOT NULL\n);\n";
+export declare const STRUCTURED_SCHEMA = "\nCREATE TABLE IF NOT EXISTS goals (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  session_id TEXT NOT NULL,\n  text TEXT NOT NULL,\n  status TEXT NOT NULL DEFAULT 'active',\n  source_event INTEGER,\n  created_at TEXT NOT NULL,\n  project_key TEXT,\n  scope TEXT NOT NULL DEFAULT 'project',\n  origin TEXT,\n  isolation INTEGER NOT NULL DEFAULT 0\n);\nCREATE INDEX IF NOT EXISTS idx_goals_session ON goals(session_id, id);\n\nCREATE TABLE IF NOT EXISTS decisions (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  session_id TEXT NOT NULL,\n  text TEXT NOT NULL,\n  status TEXT NOT NULL DEFAULT 'proposed',\n  superseded_by INTEGER,\n  source_event INTEGER,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  project_key TEXT,\n  scope TEXT NOT NULL DEFAULT 'project',\n  origin TEXT,\n  isolation INTEGER NOT NULL DEFAULT 0\n);\nCREATE INDEX IF NOT EXISTS idx_decisions_session ON decisions(session_id, status);\n\nCREATE TABLE IF NOT EXISTS feedback (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  session_id TEXT NOT NULL,\n  text TEXT NOT NULL,\n  kind TEXT NOT NULL DEFAULT 'preference',\n  source_event INTEGER,\n  created_at TEXT NOT NULL,\n  project_key TEXT,\n  scope TEXT NOT NULL DEFAULT 'project',\n  origin TEXT,\n  isolation INTEGER NOT NULL DEFAULT 0\n);\nCREATE INDEX IF NOT EXISTS idx_feedback_session ON feedback(session_id, id);\n\nCREATE TABLE IF NOT EXISTS session_isolation (\n  session_id TEXT PRIMARY KEY,\n  isolated INTEGER NOT NULL DEFAULT 0,\n  updated_at TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS lineage_edges (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  session_id TEXT NOT NULL,\n  src_type TEXT NOT NULL,\n  src_id INTEGER,\n  dst_type TEXT NOT NULL,\n  dst_id INTEGER,\n  ref TEXT,\n  edge_type TEXT NOT NULL,\n  confidence REAL NOT NULL DEFAULT 1.0,\n  ts TEXT NOT NULL\n);\nCREATE INDEX IF NOT EXISTS idx_lineage_src ON lineage_edges(session_id, src_type, src_id);\nCREATE INDEX IF NOT EXISTS idx_lineage_dst ON lineage_edges(session_id, dst_type, dst_id);\n\nCREATE TABLE IF NOT EXISTS schema_version (\n  version INTEGER NOT NULL,\n  applied_at TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS entities (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  name TEXT NOT NULL UNIQUE,\n  kind TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS decision_entities (\n  decision_id INTEGER NOT NULL REFERENCES decisions(id),\n  entity_id INTEGER NOT NULL REFERENCES entities(id),\n  edge TEXT NOT NULL DEFAULT 'references',\n  ts TEXT NOT NULL,\n  PRIMARY KEY (decision_id, entity_id)\n);\n\nCREATE TABLE IF NOT EXISTS metrics (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  event_id INTEGER,\n  name TEXT NOT NULL,\n  value REAL NOT NULL,\n  ts TEXT NOT NULL\n);\n";
+export interface ThreadStoreOptions {
+    eventsPath: string;
+    structuredPath: string;
+    projectKey?: string;
+}
+export interface AppendOptions {
+    projectKey?: string;
+    scope?: "global" | "project";
+    origin?: string;
+    spillRef?: string;
+    isolation?: boolean;
+}
+export interface StructuredWriteOptions {
+    sourceEvent?: number;
+    ts?: string;
+    scope?: "session" | "project" | "global";
+    projectKey?: string;
+    origin?: string;
+    isolation?: boolean;
+}
+export interface Episode {
+    id: number;
+    session_id: string;
+    seq_start: number;
+    seq_end: number | null;
+    status: string;
+    summary: string | null;
+    created_at: string;
+}
+export interface Goal {
+    id: number;
+    session_id: string;
+    text: string;
+    status: GoalStatus;
+    source_event: number | null;
+    created_at: string;
+    project_key?: string | null;
+    scope?: string;
+    origin?: string | null;
+    isolation?: number;
+}
+export interface Decision {
+    id: number;
+    session_id: string;
+    text: string;
+    status: DecisionStatus;
+    superseded_by: number | null;
+    source_event: number | null;
+    created_at: string;
+    updated_at: string;
+    project_key?: string | null;
+    scope?: string;
+    origin?: string | null;
+    isolation?: number;
+}
+export interface FeedbackRow {
+    id: number;
+    session_id: string;
+    text: string;
+    kind: "preference" | "correction";
+    source_event: number | null;
+    created_at: string;
+    project_key?: string | null;
+    scope?: string;
+    origin?: string | null;
+    isolation?: number;
+}
+export interface LineageNeighbor {
+    id: number;
+    session_id: string;
+    src_type: string;
+    src_id: number | null;
+    dst_type: string;
+    dst_id: number | null;
+    ref: string | null;
+    edge_type: string;
+    confidence: number;
+    ts: string;
+}
+export interface SearchHit {
+    id: number;
+    session_id: string;
+    kind: EventKind;
+    ts: string;
+    seq: number;
+    body: string;
+    truncated: boolean;
+    score: number;
+}
+export declare class ThreadStore {
+    readonly eventsDb: Database.Database;
+    readonly structuredDb: Database.Database;
+    readonly projectKey?: string;
+    private spillPolicy;
+    constructor(opts: ThreadStoreOptions, spillPolicy?: SpillPolicy);
+    getRecentSessionId(): string | undefined;
+    expand(eventId: number, opts?: {
+        sessionId?: string;
+    }): string;
+    hasAssistantTurn(sessionId: string, uuid: string): boolean;
+    close(): void;
+    append(event: Omit<SessionEvent, "id" | "seq" | "truncated">, opts?: AppendOptions): SessionEvent & {
+        project_key?: string;
+        scope?: string;
+        origin?: string;
+        spilled?: number;
+        isolation?: number;
+    };
+    transact<T>(fn: () => T): T;
+    search(query: string, opts?: {
+        limit?: number;
+        sessionId?: string;
+    }): SearchHit[];
+    getActiveEpisode(sessionId: string): Episode | undefined;
+    getLatestEpisodeWithSummary(sessionId: string): Episode | undefined;
+    addGoal(sessionId: string, text: string, opts?: StructuredWriteOptions): Goal;
+    getActiveGoals(sessionId: string): Goal[];
+    getFeedback(sessionId: string, limit?: number): FeedbackRow[];
+    getRecentEvents(sessionId: string, limit?: number): SessionEvent[];
+    updateGoalStatus(sessionId: string, goalId: number, status: GoalStatus): Goal | undefined;
+    addFeedback(sessionId: string, text: string, kind: "preference" | "correction", opts?: StructuredWriteOptions): FeedbackRow;
+    deleteFeedback(id: number): boolean;
+    proposeDecision(sessionId: string, text: string, opts?: StructuredWriteOptions): Decision;
+    private findByOrigin;
+    confirmLatestProposed(sessionId: string, opts?: {
+        ts?: string;
+    }): Decision | undefined;
+    revokeLatestActive(sessionId: string, opts?: {
+        ts?: string;
+    }): Decision | undefined;
+    supersedeLatestActive(sessionId: string, replacementText: string, opts?: {
+        sourceEvent?: number;
+        ts?: string;
+    }): {
+        superseded: Decision;
+        replacement: Decision;
+    } | undefined;
+    getActiveDecisions(sessionId: string): Decision[];
+    getActiveDecisionsMerged(sessionId: string, projectKey?: string): Decision[];
+    getActiveGoalsMerged(sessionId: string, projectKey?: string): Goal[];
+    getFeedbackMerged(sessionId: string, projectKey: string | undefined, limit?: number): FeedbackRow[];
+    setSessionIsolation(sessionId: string, isolated: boolean): void;
+    getSessionIsolation(sessionId: string): boolean;
+    unisolateRow(sessionId: string, table: "goals" | "decisions" | "feedback", id: number): boolean;
+    getLatestProposed(sessionId: string): Decision | undefined;
+    getDecisions(sessionId: string, status?: DecisionStatus): Decision[];
+    private lineageDb;
+    addLineageEdge(sessionId: string, srcType: string, srcId: number | null, dstType: string, dstId: number | null, edgeType: string, opts?: {
+        ref?: string;
+        confidence?: number;
+        ts?: string;
+    }): void;
+    getRelatedEvents(sessionId: string, eventId: number): LineageNeighbor[];
+    getRelatedEdges(sessionId: string, type: string, id: number): LineageNeighbor[];
+    getEventsForFile(sessionId: string, filePath: string): LineageNeighbor[];
+    private transitionDecision;
+    private nextSeq;
+    private updateEpisode;
+    private closeActiveEpisode;
+}
+export declare function applyScopePriority<T extends {
+    text: string;
+    scope?: string | null;
+}>(rows: T[]): T[];