@kinqs/brainrouter-mcp-server 0.3.4 → 0.3.6

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

@@ -1,101 +0,0 @@
-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/types.d.ts

@@ -1,207 +0,0 @@
-/**
- * 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

@@ -1,7 +0,0 @@
-/**
- * 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 {};