import { GlobalBrain } from './global-brain.js';
export type EdgeType = 'similarity' | 'causal' | 'temporal' | 'agent-handoff' | 'co-occurrence';
export interface WalkOptions {
    maxHops?: number;
    maxNodes?: number;
    scoreDecayPerHop?: number;
    edgeTypes?: EdgeType[];
}
export interface WalkEdgeRef {
    from: string;
    type: EdgeType;
    weight: number;
}
export interface WalkNode {
    memoryId: string;
    hopsFromSeed: number;
    scoreFromSeed: number;
    edgesIn: WalkEdgeRef[];
}
export interface WalkPath {
    seed: string;
    target: string;
    hops: Array<{
        memoryId: string;
        edgeType: EdgeType;
    }>;
    totalScore: number;
}
export interface WalkResult {
    seeds: string[];
    visited: WalkNode[];
    paths: WalkPath[];
    durationMs: number;
    hopHistogram: number[];
}
export declare class BrainGraphWalker {
    private readonly brain;
    private memoryCache;
    constructor(brain?: GlobalBrain);
    /** Walk the graph starting from seedMemoryIds. */
    walk(seedMemoryIds: string[], opts?: WalkOptions): Promise<WalkResult>;
    /** Embed the query, pick the top-3 ANN seeds, then walk. */
    relevantToQuery(query: string, opts?: WalkOptions): Promise<WalkResult>;
    private edgesFrom;
    private similarityEdges;
    private causalEdges;
    private temporalEdges;
    private handoffEdges;
    private coOccurrenceEdges;
    private memories;
}
export declare function getBrainGraphWalker(): BrainGraphWalker;
export declare function resetBrainGraphWalkerForTests(): void;
//# sourceMappingURL=brain-graph-walker.d.ts.map