import type { FabricExecutionOutcomeV1 } from "../audit/trace.js";
import type { EntryRange, MemoryCoverage } from "./index.js";
import type { MemoryBranches } from "./lineage.js";
import type { SearchResult } from "./search.js";
import { type MemoryQueryMatch, type MemoryQueryMode } from "./tokenize.js";
export declare const RECALL_DEFAULT_PAGE_SIZE = 10;
export declare const RECALL_MAX_PAGE_SIZE = 50;
export declare const RECALL_DEFAULT_SNIPPET_CHARS = 480;
export declare const RECALL_MAX_SNIPPET_CHARS = 2000;
export declare const RECALL_MAX_RESPONSE_CHARS = 30000;
export interface MemoryRecallCallArgs {
    query?: string;
    queryMode?: MemoryQueryMode;
    queryMatch?: MemoryQueryMatch;
    expectedSourceHash?: string;
    expectedLineageFingerprint?: string;
    branches?: MemoryBranches;
    scope?: string;
    offset?: number;
    pageSize?: number;
    snippetChars?: number;
    role?: string;
    tool?: string;
    ref?: string;
    provider?: string;
    action?: string;
    outcome?: FabricExecutionOutcomeV1;
    since?: number;
    until?: number;
    entryRange?: EntryRange;
    source?: string;
}
interface MemoryExpandCallArgs {
    session: string;
    source?: string;
    expectedSourceHash?: string;
    expectedLineageFingerprint?: string;
    branches?: MemoryBranches;
    indices?: number[];
    entryIds?: string[];
    operationAddresses?: string[];
    entryRange?: EntryRange;
    before?: number;
    after?: number;
    entryOffset?: number;
    textOffset?: number;
    maxChars?: number;
    maxEntries?: number;
}
interface MemoryExpandFollow {
    ref: "memory.expand";
    args: MemoryExpandCallArgs;
}
interface MemoryRecallFollow {
    ref: "memory.recall";
    args: MemoryRecallCallArgs;
}
interface MemoryRecallEntryHit {
    kind: "entry";
    sessionId: string;
    tier: "hot" | "cold";
    index: number;
    entryId: string | null;
    parentId: string | null;
    operationAddress: string | null;
    type: string;
    role: string | null;
    tool: string | null;
    ref: string | null;
    provider: string | null;
    action: string | null;
    timestamp: number | null;
    isError: boolean;
    outcome?: FabricExecutionOutcomeV1;
    score: number;
    snippet: string;
    truncated: boolean;
    follow: MemoryExpandFollow;
}
interface MemoryRecallSessionHit {
    kind: "session";
    sessionId: string;
    tier: "cold";
    cwd: string;
    lastTimestamp: number | null;
    score: number;
    matchedTerms: number;
    matchedStructuralEntries: number;
    follow: MemoryRecallFollow;
}
type MemoryRecallHit = MemoryRecallEntryHit | MemoryRecallSessionHit;
interface MemoryRecallContinuation {
    ref: "memory.recall";
    args: MemoryRecallCallArgs;
}
export interface MemoryRecallResponse {
    total: number;
    hits: MemoryRecallHit[];
    next: MemoryRecallContinuation | null;
    coverage: MemoryCoverage;
}
interface RecallPresentationInput {
    result: SearchResult;
    query?: string;
    queryMode: MemoryQueryMode;
    coverage: MemoryCoverage;
    offset?: number;
    pageSize: number;
    snippetChars: number;
    requestArgs: MemoryRecallCallArgs;
}
export declare const presentRecall: (input: RecallPresentationInput) => MemoryRecallResponse;
export {};
//# sourceMappingURL=context.d.ts.map