@kinqs/brainrouter-mcp-server 0.3.4

package/dist/memory/store/types.d.ts

@@ -0,0 +1,101 @@
+import type { GraphEdge, GraphNode, L0Record, L1FtsResult, L1Record, L2SceneRecord, L3PersonaRecord, SchedulerState, SkillHintsRecord, UserRecord, VectorSearchResult } from "../types.js";
+export interface IMemoryStore {
+    init(): void;
+    initVec(dimensions: number): void;
+    upsertL0(record: L0Record): void;
+    getRecentL0Messages(userId: string, sessionKey: string, limit: number, afterIsoTime?: string): L0Record[];
+    getUnextractedL0Count(userId: string, sessionKey: string): number;
+    upsertL1(record: L1Record): void;
+    invalidateL1Record(userId: string, recordId: string, supersededById: string): void;
+    searchL1Fts(userId: string, query: string, limit: number): L1FtsResult[];
+    searchL1FtsAsOf(userId: string, query: string, limit: number, asOf: string): L1FtsResult[];
+    upsertL1Vec(recordId: string, embedding: Float32Array): void;
+    searchL1Vec(userId: string, queryEmbedding: Float32Array, limit: number): VectorSearchResult[];
+    upsertContradiction(data: {
+        id: string;
+        userId: string;
+        recordIdA: string;
+        recordIdB: string;
+        reason: string;
+        confidence: number;
+        createdTime?: string;
+    }): void;
+    getPendingContradictions(userId: string): any[];
+    resolveContradiction(id: string, userId: string, status: "resolved" | "dismissed"): void;
+    upsertSkillHints(skillName: string, hints: string, sourceFile?: string): void;
+    listSkillHints(): SkillHintsRecord[];
+    getSkillHints(skillName: string): string | null;
+    upsertL2Scene(record: L2SceneRecord): void;
+    getTopL2Scenes(userId: string, limit?: number): L2SceneRecord[];
+    decayL2HeatScores(userId: string, decayFactor?: number): void;
+    boostL2HeatScore(userId: string, sceneName: string, boost?: number): void;
+    getL1sByScene(userId: string, sceneName: string, limit?: number): any[];
+    getL2SceneCount(userId: string): number;
+    getColdL2Scenes(userId: string, limit: number): L2SceneRecord[];
+    deleteL2Scenes(userId: string, sceneIds: string[]): void;
+    getL2SceneByName(userId: string, sceneName: string): L2SceneRecord | null;
+    getDistinctSceneNames(userId: string): string[];
+    renameSceneInL1Records(userId: string, oldName: string, canonicalName: string): void;
+    upsertL3Persona(record: L3PersonaRecord): void;
+    getL3Persona(userId: string): L3PersonaRecord | null;
+    getPersonaAndInstructionL1s(userId: string, limit?: number): any[];
+    getSchedulerState(userId: string): SchedulerState;
+    incrementSchedulerL1Count(userId: string, count: number): void;
+    resetSchedulerL2Count(userId: string): void;
+    resetSchedulerL3Count(userId: string): void;
+    getAllGraphNodes(userId: string): GraphNode[];
+    upsertGraphNode(node: GraphNode): void;
+    upsertGraphEdge(edge: GraphEdge): void;
+    getGraphNodeByEntity(userId: string, entity: string): GraphNode | null;
+    getGraphNeighbors(userId: string, entityId: string, skillTag?: string, maxHops?: number): {
+        nodes: GraphNode[];
+        edges: GraphEdge[];
+    };
+    markCited(userId: string, recordIds: string[]): void;
+    incrementNeverCited(userId: string, recordIds: string[]): {
+        recordId: string;
+        neverCitedCount: number;
+    }[];
+    archiveL1Record(userId: string, recordId: string): void;
+    getRecentSkillContextL1s(userId: string, limit: number): {
+        skillTag: string;
+        createdTime: string;
+    }[];
+    createUser(userId: string, apiKey: string, displayName?: string, isAdmin?: boolean): UserRecord;
+    getUserByApiKey(apiKey: string): UserRecord | null;
+    getUserByEmail(email: string): UserRecord | null;
+    getUserById(userId: string): UserRecord | null;
+    updateUserPassword(userId: string, passwordHash: string): void;
+    updateUserEmail(userId: string, email: string): void;
+    updateUserDisplayName(userId: string, displayName: string): void;
+    updateUserStatus(userId: string, status: "active" | "disabled"): void;
+    updateUserApiKey(userId: string, apiKey: string): void;
+    setInviteToken(userId: string, token: string | null): void;
+    redeemInviteToken(token: string): UserRecord | null;
+    listUsers(): UserRecord[];
+    deleteUser(userId: string): void;
+    listMemories(userId: string, filters?: {
+        type?: string;
+        scene?: string;
+        skill?: string;
+        archived?: boolean;
+    }): Array<{
+        recordId: string;
+        content: string;
+        type: string;
+        priority: number;
+        sceneName: string;
+        skillTag: string;
+        createdTime: string;
+        citationCount: number;
+        neverCitedCount: number;
+        archived: boolean;
+    }>;
+    getMemoryStats(userId: string): {
+        total: number;
+        archived: number;
+        byType: Record<string, number>;
+        citationRate: number;
+        lastRecallAt: string | null;
+    };
+}

package/dist/memory/store/types.js

@@ -0,0 +1 @@
+export {};

package/dist/memory/types.d.ts

@@ -0,0 +1,207 @@
+/**
+ * BrainRouter Memory Types
+ *
+ * Defines the types and boundaries for the BrainRouter memory engine.
+ * Inspired by the reference architecture but scoped explicitly for MCP + Multi-tenant.
+ */
+export interface BrainRouterMemoryContext {
+    /** User identifier — REQUIRED. Enables multi-tenant isolation. */
+    userId: string;
+    /** Session identifier (unique per conversation session). */
+    sessionKey: string;
+    /** Sub-session identifier (optional). */
+    sessionId?: string;
+    /** Which BrainRouter skill is currently active (if any) */
+    activeSkill?: string;
+}
+export interface L0Record {
+    id: string;
+    userId: string;
+    sessionKey: string;
+    sessionId: string;
+    role: string;
+    messageText: string;
+    recordedAt: string;
+    timestamp: number;
+    skillTag: string;
+}
+export type MemoryType = "persona" | "episodic" | "instruction" | "skill_context";
+export interface L1Record {
+    id: string;
+    userId: string;
+    sessionKey: string;
+    sessionId: string;
+    content: string;
+    type: MemoryType;
+    priority: number;
+    sceneName: string;
+    skillTag: string;
+    halfLifeDays: number | null;
+    supersededBy: string | null;
+    invalidAt?: string | null;
+    timestampStr: string;
+    timestampStart: string;
+    timestampEnd: string;
+    createdTime: string;
+    updatedTime: string;
+    metadata: Record<string, unknown>;
+    citationCount: number;
+    lastCitedAt: string | null;
+    neverCitedCount: number;
+    archived: boolean;
+}
+export interface VectorSearchResult {
+    record_id: string;
+    user_id: string;
+    content: string;
+    type: string;
+    priority: number;
+    scene_name: string;
+    skill_tag: string;
+    score: number;
+    timestamp_str: string;
+    timestamp_start: string;
+    timestamp_end: string;
+    session_key: string;
+    session_id: string;
+    metadata_json: string;
+    created_time: string;
+}
+export interface L1FtsResult {
+    record_id: string;
+    user_id: string;
+    content: string;
+    type: string;
+    priority: number;
+    scene_name: string;
+    skill_tag: string;
+    score: number;
+    timestamp_str: string;
+    timestamp_start: string;
+    timestamp_end: string;
+    session_key: string;
+    session_id: string;
+    metadata_json: string;
+    created_time: string;
+    /** ACE feedback: number of times this memory was cited by the agent. */
+    citation_count?: number;
+}
+export interface RecalledMemory {
+    content: string;
+    score: number;
+    type: string;
+    recordId: string;
+    skillTag?: string;
+}
+export interface RecallResult {
+    /** L1 relevant memories — prepended to user prompt text (dynamic, per-turn). */
+    prependContext?: string;
+    /** Stable recall context appended to system prompt (persona, scene nav, tools guide). */
+    appendSystemContext?: string;
+    /** Recalled L1 memories with scores (for metrics/debugging). */
+    recalledL1Memories?: RecalledMemory[];
+    /** Strategy used. Phase 1 = keyword. */
+    recallStrategy: string;
+    /** L3 persona markdown (for metrics/debugging). */
+    personaSummary?: string;
+    /** Current most active scene name (for metrics/debugging). */
+    activeScene?: string;
+}
+export interface CaptureResult {
+    /** Number of L0 messages recorded. */
+    l0RecordedCount: number;
+    /** Whether L1 extraction was triggered this turn. */
+    l1ExtractionTriggered: boolean;
+    /** Number of L1 memories extracted (if triggered). */
+    l1ExtractedCount: number;
+}
+export interface EmbeddingServiceConfig {
+    endpoint?: string;
+    apiKey?: string;
+    model?: string;
+    dimensions?: number;
+}
+export interface RerankerServiceConfig {
+    endpoint?: string;
+    apiKey?: string;
+    model?: string;
+    topN?: number;
+}
+export interface SkillHintsRecord {
+    skillName: string;
+    hints: string;
+    sourceFile: string;
+    registeredAt: string;
+}
+export interface UserRecord {
+    userId: string;
+    apiKey: string;
+    passwordHash: string | null;
+    displayName: string;
+    email: string;
+    isAdmin: boolean;
+    status: "active" | "disabled";
+    inviteToken: string | null;
+    createdAt: string;
+}
+export interface PublicUserRecord {
+    userId: string;
+    displayName: string;
+    email: string;
+    isAdmin: boolean;
+    status: "active" | "disabled";
+    inviteToken: string | null;
+    createdAt: string;
+}
+export interface LLMRunParams {
+    prompt: string;
+    systemPrompt?: string;
+    taskId: string;
+    timeoutMs?: number;
+}
+export interface LLMRunner {
+    run(params: LLMRunParams): Promise<string>;
+}
+export interface L2SceneRecord {
+    id: string;
+    userId: string;
+    sceneName: string;
+    summaryMd: string;
+    heatScore: number;
+    lastActiveTime: string;
+    createdTime: string;
+    updatedTime: string;
+}
+export interface L3PersonaRecord {
+    userId: string;
+    personaMd: string;
+    l1CountAtGeneration: number;
+    createdTime: string;
+    updatedTime: string;
+}
+export interface SchedulerState {
+    l1CountSinceLastL2: number;
+    l1CountSinceLastL3: number;
+    totalL1Count: number;
+}
+export interface GraphNode {
+    id: string;
+    userId: string;
+    entity: string;
+    entityType: string;
+    skillTag: string;
+    confidence: number;
+    sourceRecordId: string;
+    createdTime: string;
+}
+export interface GraphEdge {
+    id: string;
+    userId: string;
+    fromNodeId: string;
+    toNodeId: string;
+    relation: string;
+    skillTag: string;
+    confidence: number;
+    sourceRecordId: string;
+    createdTime: string;
+}

package/dist/memory/types.js

@@ -0,0 +1,7 @@
+/**
+ * BrainRouter Memory Types
+ *
+ * Defines the types and boundaries for the BrainRouter memory engine.
+ * Inspired by the reference architecture but scoped explicitly for MCP + Multi-tenant.
+ */
+export {};