import type { Fact, Contradiction, Insight, NodeRef, AgentSelf, Scopes, StructuredStore, Logger, QueryResult } from '@kybernesis/arcana-contracts';
export interface QueryStatsResult {
    memoryCount: number;
    entityCount: number;
    factCount: number;
    contradictionCount: number;
    insightCount: number;
}
export interface QueryDeps {
    structured: StructuredStore;
    logger: Logger;
}
export interface QueryApi {
    /**
     * Look up facts for an entity. Optionally narrow by attribute.
     *
     * `asOf` (ISO 8601) narrows to facts that were valid at that instant —
     * facts with `expiresAt ≤ asOf` are excluded. Omitting `asOf` returns
     * all facts regardless of expiry (backward-compatible).
     */
    queryFacts(entity: string, attribute?: string, asOf?: string): Promise<QueryResult<Fact[]>>;
    /** Walk the graph N hops out from a node. */
    getNeighbors(node: NodeRef, hops?: number): Promise<QueryResult<NodeRef[]>>;
    /** Aggregate counts across the brain. */
    stats(scopes?: Scopes): Promise<QueryResult<QueryStatsResult>>;
    /** Outstanding or resolved contradictions. */
    listContradictions(status?: Contradiction['status']): Promise<QueryResult<Contradiction[]>>;
    /** Reasoning-derived insights, optionally per entity. */
    listInsights(entityId?: string): Promise<QueryResult<Insight[]>>;
    /** Read one of the agent's own memory blocks (persona, objectives, etc.). */
    readBlock(label: string): Promise<QueryResult<string | null>>;
    /** History of changes to an agent-self block. */
    getBlockHistory(label: string): Promise<QueryResult<AgentSelf['history']>>;
}
export declare function createQuery(deps: QueryDeps): QueryApi;
//# sourceMappingURL=index.d.ts.map