@kinqs/brainrouter-mcp-server 0.3.5 → 0.3.6

package/dist/memory/prompts/l1-extraction.js

@@ -1,114 +0,0 @@
-// ============================
-// System Prompt
-// ============================
-export const EXTRACT_MEMORIES_SYSTEM_PROMPT = `You are a Skill-Aware Memory Extraction Expert for a software engineering AI assistant.
-
-Your task is to analyze a conversation and extract durable, self-contained memories.
-
-### Scene Segmentation
-Determine if the topic has changed since the previous scene.
-If there are existing scenes, PREFER to reuse the most relevant existing scene name — only create a new name if the topic is genuinely different from ALL existing scenes.
-If reusing, use the EXACT existing name (no paraphrasing).
-If creating new, format: "AI helping [user role] with [goal activity]" (unique, max 50 chars).
-
-### Memory Types
-
-1. **persona** — Stable user traits, preferences, identity
-   - Format: "User [prefers/is/always/never] ..."
-   - Priority: 80-100 (core identity) / 50-70 (preferences) / skip if <50
-
-2. **episodic** — Objective events, decisions, results with timestamps
-   - Format: "User [did X] at [time] resulting in [Y]"
-   - Priority: 80-100 (major decisions) / 60-79 (significant events) / skip if <60
-
-3. **instruction** — Long-term rules the user gave the AI
-   - Format: "User requires AI to always/never ..."
-   - Priority: 90-100 (hard rules) / 70-89 (preferences) / skip if <70
-   - Instructions NEVER decay.
-
-4. **skill_context** — Observations about how the user runs THIS SKILL specifically
-   - Format: "When running [skill], user tends to ..."
-   - Only extract if a genuine behavioral pattern is visible, not a one-off.
-
-5. **tool_preference** — Stable preferences about tools, workflows, or command usage.
-6. **codebase_fact / api_contract / data_model** — Verified facts about code, public APIs, schemas, or storage models.
-7. **dependency_constraint / environment_constraint** — Version, runtime, platform, sandbox, or deployment constraints.
-8. **architecture_decision / implementation_decision / design_constraint** — Durable decisions and constraints that future agents must preserve.
-9. **security_policy / performance_baseline** — Security rules or measured performance facts. Extract only with direct evidence.
-10. **bug_finding / debug_trace / fix_summary / verification_result / failed_attempt / regression_risk** — Debugging history, fixes, checks, and risk notes.
-11. **task_state / handover_note / blocked_reason / review_comment / release_note** — Planning, review, release, and continuation state.
-12. **source_evidence / artifact_reference / file_history / command_knowledge** — Evidence-backed references to files, artifacts, file evolution, or command behavior.
-
-Allowed type values:
-persona, episodic, instruction, skill_context, tool_preference, codebase_fact, api_contract,
-data_model, dependency_constraint, environment_constraint, architecture_decision,
-implementation_decision, design_constraint, security_policy, performance_baseline,
-bug_finding, debug_trace, fix_summary, verification_result, failed_attempt, regression_risk,
-task_state, handover_note, blocked_reason, review_comment, release_note, source_evidence,
-artifact_reference, file_history, command_knowledge.
-
-### Quality Rules
-- Nothingness > Bad memory. Prefer empty over wrong.
-- Memory must stand alone without the conversation.
-- Merge causally-linked facts into one memory.
-- Do not extract AI outputs — only user behavior and statements.
-- Filter out: tool calls, one-time requests, casual greetings.
-- Evidence-gated types (api_contract, data_model, security_policy, performance_baseline) require a cited file path, command, test result, or explicit user statement.
-- Use confidence from 0.0 to 1.0. Use lower confidence for model inference, higher confidence for direct source or command output.
-- Classify sourceKind as user_instruction, source_file, command_output, test_result, model_inference, or prior_memory.
-- Extract filePaths, repoPaths, and commands when explicitly mentioned; otherwise use empty arrays.
-
-### Output
-Return ONLY a valid JSON array matching this format exactly:
-[
-  {
-    "scene_name": "current or inherited scene name",
-    "message_ids": ["id1"],
-    "memories": [
-      {
-        "type": "one allowed type value",
-        "content": "self-contained memory statement",
-        "priority": 85,
-        "skill_tag": "the active skill",
-        "source_message_ids": ["id1"],
-        "confidence": 0.75,
-        "sourceKind": "user_instruction|source_file|command_output|test_result|model_inference|prior_memory",
-        "verificationStatus": "verified|unverified|stale",
-        "repoPaths": [],
-        "filePaths": [],
-        "commands": [],
-        "metadata": {}
-      }
-    ]
-  }
-]
-`;
-// ============================
-// Prompt Builder
-// ============================
-export function formatExtractionPrompt(params) {
-    const { newMessages, backgroundMessages = [], previousSceneName = "None", existingSceneNames = [], activeSkill = "None", skillHints = "None" } = params;
-    const bgText = backgroundMessages.length > 0
-        ? backgroundMessages
-            .map((m) => `[${m.id}] [${m.role}] [${new Date(m.timestamp).toISOString()}]: ${m.messageText}`)
-            .join("\n\n")
-        : "None";
-    const newText = newMessages
-        .map((m) => `[${m.id}] [${m.role}] [${new Date(m.timestamp).toISOString()}]: ${m.messageText}`)
-        .join("\n\n");
-    const existingScenesNote = existingSceneNames.length > 0
-        ? `[EXISTING SCENES] (reuse one of these if the topic matches):\n${existingSceneNames.map(n => `  - ${n}`).join("\n")}`
-        : "[EXISTING SCENES]: None yet";
-    return `[PREVIOUS SCENE]: ${previousSceneName}
-${existingScenesNote}
-[ACTIVE SKILL]: ${activeSkill}
-[SKILL EXTRACTION HINTS]: ${skillHints}
-
-[BACKGROUND CONVERSATION] (Context only, DO NOT extract from here):
-${bgText}
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-[NEW MESSAGES TO EXTRACT FROM] (Extract memories ONLY from here):
-${newText}`;
-}

package/dist/memory/prompts/l2-direction-shift.d.ts

@@ -1,5 +0,0 @@
-export declare const L2_DIRECTION_SHIFT_SYSTEM_PROMPT = "You are a context analyzer for a software engineering AI assistant.\n\nYour task is to determine if a new batch of memories represents a MAJOR shift away from the current active scene (topic/feature), or if it's a continuation of the same work.\n\nA major shift means:\n- The user has moved to a completely different feature, bug, or module.\n- The context of the active scene is no longer primarily relevant.\n\nA continuation means:\n- They are fixing bugs related to the active scene.\n- They are writing tests for the active scene.\n- They are continuing work on the active scene.\n\nOutput ONLY a JSON object with this exact schema:\n{\n  \"shift\": boolean,\n  \"confidence\": number (0.0 to 1.0),\n  \"reason\": \"short explanation\"\n}";
-export declare function formatL2DirectionShiftPrompt(activeScene: string, activeSceneSummary: string, newMemories: Array<{
-    content: string;
-    type: string;
-}>): string;

package/dist/memory/prompts/l2-direction-shift.js

@@ -1,32 +0,0 @@
-// ============================
-// L2 Direction Shift Detection Prompt
-// ============================
-export const L2_DIRECTION_SHIFT_SYSTEM_PROMPT = `You are a context analyzer for a software engineering AI assistant.
-
-Your task is to determine if a new batch of memories represents a MAJOR shift away from the current active scene (topic/feature), or if it's a continuation of the same work.
-
-A major shift means:
-- The user has moved to a completely different feature, bug, or module.
-- The context of the active scene is no longer primarily relevant.
-
-A continuation means:
-- They are fixing bugs related to the active scene.
-- They are writing tests for the active scene.
-- They are continuing work on the active scene.
-
-Output ONLY a JSON object with this exact schema:
-{
-  "shift": boolean,
-  "confidence": number (0.0 to 1.0),
-  "reason": "short explanation"
-}`;
-export function formatL2DirectionShiftPrompt(activeScene, activeSceneSummary, newMemories) {
-    const memLines = newMemories.map(m => `- [${m.type}] ${m.content}`).join("\n");
-    return `### Active Scene: ${activeScene}
-${activeSceneSummary}
-
-### New Memories:
-${memLines}
-
-Does the new batch of memories represent a major shift away from the active scene? Return JSON.`;
-}

package/dist/memory/prompts/l2-scene-cluster.d.ts

@@ -1,2 +0,0 @@
-export declare const L2_SCENE_CLUSTER_SYSTEM_PROMPT = "You are a semantic text clustering expert for an AI agent's memory database.\n\nYour task is to review a list of work scene/session names and identify near-duplicate or highly overlapping scenes that should be merged to prevent memory fragmentation.\n\nRules:\n1. Group scenes that discuss the SAME overall goal, project, or task (e.g., \"monorepo migration setup\", \"monorepo architecture\", \"monorepo setup\" should all be one cluster).\n2. For each cluster, pick or write one clean, professional, and descriptive \"canonical\" name (e.g. \"AI helping lead engineer with monorepo architecture setup\").\n3. Put the near-duplicate scene names into the \"aliases\" array.\n4. If a scene does not have any duplicates or overlaps, you can skip including it, or place it in its own cluster with an empty aliases list.\n5. Every alias must be exactly as it appears in the input list.\n\nReturn ONLY a valid JSON array matching this format exactly:\n[\n  {\n    \"canonical\": \"AI helping lead engineer with monorepo architecture setup\",\n    \"aliases\": [\n      \"AI helping lead engineer with monorepo setup\",\n      \"AI helping Lead Engineer with Monorepo Architecture Migration\"\n    ]\n  }\n]\n";
-export declare function formatSceneClusterPrompt(sceneNames: string[]): string;

package/dist/memory/prompts/l2-scene-cluster.js

@@ -1,33 +0,0 @@
-// ============================
-// L2 Scene Clustering & Canonicalization Prompt
-// ============================
-export const L2_SCENE_CLUSTER_SYSTEM_PROMPT = `You are a semantic text clustering expert for an AI agent's memory database.
-
-Your task is to review a list of work scene/session names and identify near-duplicate or highly overlapping scenes that should be merged to prevent memory fragmentation.
-
-Rules:
-1. Group scenes that discuss the SAME overall goal, project, or task (e.g., "monorepo migration setup", "monorepo architecture", "monorepo setup" should all be one cluster).
-2. For each cluster, pick or write one clean, professional, and descriptive "canonical" name (e.g. "AI helping lead engineer with monorepo architecture setup").
-3. Put the near-duplicate scene names into the "aliases" array.
-4. If a scene does not have any duplicates or overlaps, you can skip including it, or place it in its own cluster with an empty aliases list.
-5. Every alias must be exactly as it appears in the input list.
-
-Return ONLY a valid JSON array matching this format exactly:
-[
-  {
-    "canonical": "AI helping lead engineer with monorepo architecture setup",
-    "aliases": [
-      "AI helping lead engineer with monorepo setup",
-      "AI helping Lead Engineer with Monorepo Architecture Migration"
-    ]
-  }
-]
-`;
-export function formatSceneClusterPrompt(sceneNames) {
-    return `Please analyze the following list of scene names and group any near-duplicates or highly overlapping topics into clusters.
-
-### Input Scene Names:
-${sceneNames.map(s => `- ${s}`).join("\n")}
-
-### Output Format (strict JSON array of clusters):`;
-}

package/dist/memory/prompts/l2-scene.d.ts

@@ -1,7 +0,0 @@
-export declare const L2_SCENE_SYSTEM_PROMPT = "You are a technical memory summarizer for a software engineering AI assistant.\n\nYour task is to synthesize a set of extracted memories about a specific work session into a concise, durable Scene Summary.\n\nThe summary must:\n- Be written as Markdown\n- Be accurate and grounded only in the provided memories \u2014 do NOT infer or fabricate\n- Be self-contained (readable without the original conversation)\n- Capture what was being worked on, key decisions, and outcomes\n- Be 2-4 sentences for the main summary, plus short bullet lists\n\nOutput ONLY the Markdown. No preamble, no explanation.";
-export declare function formatL2ScenePrompt(sceneName: string, memories: Array<{
-    content: string;
-    type: string;
-    priority: number;
-    skill_tag: string;
-}>, existingSceneNames?: string[]): string;

package/dist/memory/prompts/l2-scene.js

@@ -1,40 +0,0 @@
-// ============================
-// L2 Scene Summary Prompt
-// ============================
-export const L2_SCENE_SYSTEM_PROMPT = `You are a technical memory summarizer for a software engineering AI assistant.
-
-Your task is to synthesize a set of extracted memories about a specific work session into a concise, durable Scene Summary.
-
-The summary must:
-- Be written as Markdown
-- Be accurate and grounded only in the provided memories — do NOT infer or fabricate
-- Be self-contained (readable without the original conversation)
-- Capture what was being worked on, key decisions, and outcomes
-- Be 2-4 sentences for the main summary, plus short bullet lists
-
-Output ONLY the Markdown. No preamble, no explanation.`;
-export function formatL2ScenePrompt(sceneName, memories, existingSceneNames = []) {
-    const memLines = memories
-        .map(m => `- [${m.type}${m.skill_tag ? `|${m.skill_tag}` : ""}] ${m.content}`)
-        .join("\n");
-    const existingNote = existingSceneNames.length > 0
-        ? `\n### Existing Scenes (for your context — avoid duplicating these):\n${existingSceneNames.map(s => `- ${s}`).join("\n")}`
-        : "";
-    return `Generate a Scene Summary for the following work session.${existingNote}
-
-## Scene: ${sceneName}
-
-### Extracted Memories:
-${memLines}
-
-### Output Format (strict Markdown):
-## ${sceneName}
-**Summary**: [2-3 sentence distillation of what happened and the outcome]
-
-**Key Decisions**:
-- [decision 1]
-- [decision 2]
-
-**Skills Active**: [comma-separated skill names, or "none" if absent]
-**Memory Types**: [which types appeared: persona / episodic / instruction / skill_context]`;
-}

package/dist/memory/prompts/l3-persona.d.ts

@@ -1,6 +0,0 @@
-export declare const L3_PERSONA_SYSTEM_PROMPT = "You are a user profiling expert for a software engineering AI assistant.\n\nYour task is to synthesize a set of durable user memories (persona traits and instructions) into a concise, structured 4-layer Narrative Profile.\n\nRules:\n- Be STRICTLY grounded in the provided memories. Do NOT infer or fabricate traits.\n- If a trait appears only once and is ambiguous, omit it.\n- Prefer concrete observations over vague generalizations.\n- Instructions (hard rules the user gave) must be listed verbatim in \"Hard Rules\".\n- DEDUPLICATE Hard Rules: if multiple instruction memories express the same constraint (even with different wording), merge them into one canonical rule. Prefer the most specific and complete version.\n- Output ONLY the Markdown profile. No preamble.";
-export declare function formatL3PersonaPrompt(memories: Array<{
-    content: string;
-    type: string;
-    priority: number;
-}>): string;

package/dist/memory/prompts/l3-persona.js

@@ -1,60 +0,0 @@
-// ============================
-// L3 Persona Synthesis Prompt
-// ============================
-export const L3_PERSONA_SYSTEM_PROMPT = `You are a user profiling expert for a software engineering AI assistant.
-
-Your task is to synthesize a set of durable user memories (persona traits and instructions) into a concise, structured 4-layer Narrative Profile.
-
-Rules:
-- Be STRICTLY grounded in the provided memories. Do NOT infer or fabricate traits.
-- If a trait appears only once and is ambiguous, omit it.
-- Prefer concrete observations over vague generalizations.
-- Instructions (hard rules the user gave) must be listed verbatim in "Hard Rules".
-- DEDUPLICATE Hard Rules: if multiple instruction memories express the same constraint (even with different wording), merge them into one canonical rule. Prefer the most specific and complete version.
-- Output ONLY the Markdown profile. No preamble.`;
-export function formatL3PersonaPrompt(memories) {
-    const personaLines = memories
-        .filter(m => m.type === "persona")
-        .sort((a, b) => b.priority - a.priority)
-        .map(m => `- ${m.content}`)
-        .join("\n");
-    const instructionLines = memories
-        .filter(m => m.type === "instruction")
-        .sort((a, b) => b.priority - a.priority)
-        .map(m => `- ${m.content}`)
-        .join("\n");
-    return `Synthesize a structured Narrative Profile from the following user memories.
-
-### Persona Memories (stable traits, preferences):
-${personaLines || "- (none)"}
-
-### Instruction Memories (hard rules from the user):
-${instructionLines || "- (none)"}
-
-### Output Format (strict Markdown):
-## User Narrative Profile
-
-### Layer 1 — Base Anchors
-(Stable identity: role, years of experience, core domain, language preferences)
-- [anchor 1]
-- [anchor 2]
-
-### Layer 2 — Interest Graph
-(Topics they care about most: architecture, performance, DX, shipping speed, etc.)
-- [interest 1]
-- [interest 2]
-
-### Layer 3 — Skill Map  
-(Concrete tools, frameworks, languages, and patterns they use or prefer)
-- [skill/tool 1]
-- [skill/tool 2]
-
-### Layer 4 — Behavioural Patterns
-(Observable working styles: how they iterate, what they avoid, what they reward)
-- [pattern 1]
-- [pattern 2]
-
-### Hard Rules (must never be violated)
-- [verbatim instruction 1]
-- [verbatim instruction 2]`;
-}

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/store/types.js

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

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 {};