@crewai-ts/core 0.1.13 → 0.2.1

package/dist/memory.d.ts

@@ -1,915 +0,0 @@
-import { type LLM } from "./llm.js";
-import { BaseTool, type BaseToolOptions } from "./tools.js";
-import type { Tool } from "./types.js";
-export declare function _passthrough<T>(value: T): T;
-export declare function _default_embedder(): unknown;
-export type MemoryRecordOptions = {
-    id?: string;
-    content: string;
-    scope?: string;
-    categories?: readonly string[];
-    metadata?: Record<string, unknown>;
-    importance?: number;
-    source?: string | null;
-    private?: boolean;
-    createdAt?: Date | string;
-    created_at?: Date | string;
-    lastAccessed?: Date | string;
-    last_accessed?: Date | string;
-    embedding?: readonly number[] | null;
-};
-export type MemoryRecordJSON = Omit<MemoryRecordOptions, "embedding" | "lastAccessed" | "last_accessed"> & {
-    lastAccessed?: Date;
-    last_accessed?: Date;
-};
-export declare class MemoryRecord {
-    readonly id: string;
-    readonly content: string;
-    readonly scope: string;
-    readonly categories: readonly string[];
-    readonly metadata: Record<string, unknown>;
-    readonly importance: number;
-    readonly source: string | null;
-    readonly private: boolean;
-    readonly createdAt: Date;
-    readonly created_at?: Date;
-    readonly lastAccessed?: Date;
-    readonly last_accessed?: Date;
-    readonly embedding?: readonly number[] | null;
-    constructor(options: MemoryRecordOptions);
-    toJSON(): MemoryRecordJSON;
-}
-export type MemoryMatchOptions = {
-    record: MemoryRecord | MemoryRecordOptions;
-    score: number;
-    matchReasons?: readonly string[];
-    match_reasons?: readonly string[];
-    evidenceGaps?: readonly string[];
-    evidence_gaps?: readonly string[];
-};
-export declare class MemoryMatch {
-    readonly record: MemoryRecord;
-    readonly score: number;
-    readonly matchReasons: readonly string[];
-    readonly match_reasons: readonly string[];
-    readonly evidenceGaps: readonly string[];
-    readonly evidence_gaps: readonly string[];
-    constructor(options: MemoryMatchOptions);
-    format(): string;
-    toJSON(): {
-        record: ReturnType<MemoryRecord["toJSON"]>;
-        score: number;
-        matchReasons: readonly string[];
-        match_reasons: readonly string[];
-        evidenceGaps: readonly string[];
-        evidence_gaps: readonly string[];
-    };
-}
-export type MemoryOptions = {
-    readOnly?: boolean;
-    read_only?: boolean;
-    rootScope?: string | null;
-    root_scope?: string | null;
-    llm?: LLM | null;
-    embedder?: unknown;
-} & ConstructorParameters<typeof MemoryConfig>[0];
-export type MemoryUpdateOptions = {
-    content?: string | null;
-    scope?: string | null;
-    categories?: readonly string[] | null;
-    metadata?: Record<string, unknown> | null;
-    importance?: number | null;
-};
-export declare class ExtractedMetadata {
-    readonly entities: readonly string[];
-    readonly dates: readonly string[];
-    readonly topics: readonly string[];
-    constructor(options?: {
-        entities?: readonly string[];
-        dates?: readonly string[];
-        topics?: readonly string[];
-    });
-}
-export declare class MemoryAnalysis {
-    readonly suggestedScope: string;
-    readonly suggested_scope: string;
-    readonly categories: readonly string[];
-    readonly importance: number;
-    readonly extractedMetadata: ExtractedMetadata;
-    readonly extracted_metadata: ExtractedMetadata;
-    constructor(options?: {
-        suggestedScope?: string;
-        suggested_scope?: string;
-        categories?: readonly string[];
-        importance?: number;
-        extractedMetadata?: ExtractedMetadata | Record<string, unknown>;
-        extracted_metadata?: ExtractedMetadata | Record<string, unknown>;
-    });
-}
-export declare class QueryAnalysis {
-    readonly keywords: readonly string[];
-    readonly suggestedScopes: readonly string[];
-    readonly suggested_scopes: readonly string[];
-    readonly complexity: string;
-    readonly recallQueries: readonly string[];
-    readonly recall_queries: readonly string[];
-    readonly timeFilter: string | null;
-    readonly time_filter: string | null;
-    constructor(options?: {
-        keywords?: readonly string[];
-        suggestedScopes?: readonly string[];
-        suggested_scopes?: readonly string[];
-        complexity?: string;
-        recallQueries?: readonly string[];
-        recall_queries?: readonly string[];
-        timeFilter?: string | null;
-        time_filter?: string | null;
-    });
-}
-export declare class ExtractedMemories {
-    readonly memories: readonly string[];
-    constructor(options?: {
-        memories?: readonly string[];
-    });
-}
-export declare class ConsolidationAction {
-    readonly action: string;
-    readonly recordId: string;
-    readonly record_id: string;
-    readonly newContent: string | null;
-    readonly new_content: string | null;
-    readonly reason: string;
-    constructor(options: {
-        action: string;
-        recordId?: string;
-        record_id?: string;
-        newContent?: string | null;
-        new_content?: string | null;
-        reason?: string;
-    });
-}
-export declare class ConsolidationPlan {
-    readonly actions: readonly ConsolidationAction[];
-    readonly insertNew: boolean;
-    readonly insert_new: boolean;
-    readonly insertReason: string;
-    readonly insert_reason: string;
-    constructor(options?: {
-        actions?: readonly (ConsolidationAction | Record<string, unknown>)[];
-        insertNew?: boolean;
-        insert_new?: boolean;
-        insertReason?: string;
-        insert_reason?: string;
-    });
-}
-export type ScopeInfoOptions = {
-    path: string;
-    count?: number;
-    recordCount?: number;
-    record_count?: number;
-    categories?: readonly string[];
-    lastUpdated?: Date | string | null;
-    last_updated?: Date | string | null;
-    oldestRecord?: Date | string | null;
-    oldest_record?: Date | string | null;
-    newestRecord?: Date | string | null;
-    newest_record?: Date | string | null;
-    childScopes?: readonly string[];
-    child_scopes?: readonly string[];
-};
-export declare class ScopeInfo {
-    readonly path: string;
-    readonly count: number;
-    readonly recordCount: number;
-    readonly record_count: number;
-    readonly categories: readonly string[];
-    readonly lastUpdated: Date | null;
-    readonly last_updated: Date | null;
-    readonly oldestRecord: Date | null;
-    readonly oldest_record: Date | null;
-    readonly newestRecord: Date | null;
-    readonly newest_record: Date | null;
-    readonly childScopes: readonly string[];
-    readonly child_scopes: readonly string[];
-    constructor(options: ScopeInfoOptions);
-}
-export declare class MemoryConfig {
-    readonly recencyWeight: number;
-    readonly recency_weight: number;
-    readonly semanticWeight: number;
-    readonly semantic_weight: number;
-    readonly importanceWeight: number;
-    readonly importance_weight: number;
-    readonly recencyHalfLifeDays: number;
-    readonly recency_half_life_days: number;
-    readonly consolidationThreshold: number;
-    readonly consolidation_threshold: number;
-    readonly consolidationLimit: number;
-    readonly consolidation_limit: number;
-    readonly batchDedupThreshold: number;
-    readonly batch_dedup_threshold: number;
-    readonly defaultImportance: number;
-    readonly default_importance: number;
-    readonly confidenceThresholdHigh: number;
-    readonly confidence_threshold_high: number;
-    readonly confidenceThresholdLow: number;
-    readonly confidence_threshold_low: number;
-    readonly complexQueryThreshold: number;
-    readonly complex_query_threshold: number;
-    readonly explorationBudget: number;
-    readonly exploration_budget: number;
-    readonly recallOversampleFactor: number;
-    readonly recall_oversample_factor: number;
-    readonly queryAnalysisThreshold: number;
-    readonly query_analysis_threshold: number;
-    constructor(options?: {
-        recencyWeight?: number;
-        recency_weight?: number;
-        semanticWeight?: number;
-        semantic_weight?: number;
-        importanceWeight?: number;
-        importance_weight?: number;
-        recencyHalfLifeDays?: number;
-        recency_half_life_days?: number;
-        consolidationThreshold?: number;
-        consolidation_threshold?: number;
-        consolidationLimit?: number;
-        consolidation_limit?: number;
-        batchDedupThreshold?: number;
-        batch_dedup_threshold?: number;
-        defaultImportance?: number;
-        default_importance?: number;
-        confidenceThresholdHigh?: number;
-        confidence_threshold_high?: number;
-        confidenceThresholdLow?: number;
-        confidence_threshold_low?: number;
-        complexQueryThreshold?: number;
-        complex_query_threshold?: number;
-        explorationBudget?: number;
-        exploration_budget?: number;
-        recallOversampleFactor?: number;
-        recall_oversample_factor?: number;
-        queryAnalysisThreshold?: number;
-        query_analysis_threshold?: number;
-    });
-}
-export declare class ItemState {
-    readonly content: string;
-    scope: string | null;
-    categories: readonly string[] | null;
-    metadata: Record<string, unknown> | null;
-    importance: number | null;
-    source: string | null;
-    private: boolean;
-    rootScope: string | null;
-    root_scope: string | null;
-    resolvedScope: string;
-    resolved_scope: string;
-    resolvedCategories: readonly string[];
-    resolved_categories: readonly string[];
-    resolvedMetadata: Record<string, unknown>;
-    resolved_metadata: Record<string, unknown>;
-    resolvedImportance: number;
-    resolved_importance: number;
-    resolvedSource: string | null;
-    resolved_source: string | null;
-    resolvedPrivate: boolean;
-    resolved_private: boolean;
-    embedding: number[];
-    dropped: boolean;
-    similarRecords: MemoryRecord[];
-    similar_records: MemoryRecord[];
-    topSimilarity: number;
-    top_similarity: number;
-    plan: ConsolidationPlan | null;
-    resultRecord: MemoryRecord | null;
-    result_record: MemoryRecord | null;
-    constructor(content?: string, options?: {
-        scope?: string | null;
-        categories?: readonly string[] | null;
-        metadata?: Record<string, unknown> | null;
-        importance?: number | null;
-        source?: string | null;
-        private?: boolean;
-        rootScope?: string | null;
-        root_scope?: string | null;
-        resolvedScope?: string;
-        resolved_scope?: string;
-        resolvedCategories?: readonly string[];
-        resolved_categories?: readonly string[];
-        resolvedMetadata?: Record<string, unknown>;
-        resolved_metadata?: Record<string, unknown>;
-        resolvedImportance?: number;
-        resolved_importance?: number;
-        resolvedSource?: string | null;
-        resolved_source?: string | null;
-        resolvedPrivate?: boolean;
-        resolved_private?: boolean;
-        embedding?: readonly number[];
-        dropped?: boolean;
-        similarRecords?: readonly MemoryRecord[];
-        similar_records?: readonly MemoryRecord[];
-        topSimilarity?: number;
-        top_similarity?: number;
-        plan?: ConsolidationPlan | null;
-        resultRecord?: MemoryRecord | null;
-        result_record?: MemoryRecord | null;
-    });
-}
-export declare class EncodingState {
-    readonly id: `${string}-${string}-${string}-${string}-${string}`;
-    readonly items: ItemState[];
-    records_inserted: number;
-    records_updated: number;
-    records_deleted: number;
-    items_dropped_dedup: number;
-    constructor(options?: {
-        items?: readonly (ItemState | string)[];
-    });
-}
-export declare class EncodingFlow {
-    readonly storage: unknown;
-    readonly llm: unknown;
-    readonly embedder: unknown;
-    readonly config: MemoryConfig;
-    readonly state: EncodingState;
-    constructor(storage?: unknown, llm?: unknown, embedder?: unknown, config?: MemoryConfig);
-    batch_embed(): void;
-    batchEmbed(): void;
-    intra_batch_dedup(): void;
-    intraBatchDedup(): void;
-    parallel_find_similar(): void;
-    parallelFindSimilar(): void;
-    _search_one(item: ItemState): Array<readonly [MemoryRecord, number]>;
-    parallel_analyze(): Promise<void>;
-    parallelAnalyze(): Promise<void>;
-    static _cosine_similarity(a: readonly number[], b: readonly number[]): number;
-    _apply_defaults(item: ItemState): void;
-    private applyEncodingAnalysis;
-    private listStorageScopes;
-    private listStorageCategories;
-    execute_plans(): void;
-    executePlans(): void;
-}
-export declare class RecallState {
-    id: string;
-    query: string;
-    scope: string | null;
-    categories: readonly string[] | null;
-    timeCutoff: Date | null;
-    time_cutoff: Date | null;
-    source: string | null;
-    includePrivate: boolean;
-    include_private: boolean;
-    limit: number;
-    queryEmbeddings: Array<readonly [string, readonly number[]]>;
-    query_embeddings: Array<readonly [string, readonly number[]]>;
-    queryAnalysis: QueryAnalysis | null;
-    query_analysis: QueryAnalysis | null;
-    candidateScopes: string[];
-    candidate_scopes: string[];
-    chunkFindings: unknown[];
-    chunk_findings: unknown[];
-    evidenceGaps: string[];
-    evidence_gaps: string[];
-    confidence: number;
-    finalResults: MemoryMatch[];
-    final_results: MemoryMatch[];
-    explorationBudget: number;
-    exploration_budget: number;
-    constructor(options?: {
-        id?: string;
-        query?: string;
-        scope?: string | null;
-        categories?: readonly string[] | null;
-        timeCutoff?: Date | string | null;
-        time_cutoff?: Date | string | null;
-        source?: string | null;
-        includePrivate?: boolean;
-        include_private?: boolean;
-        limit?: number;
-        queryEmbeddings?: Array<readonly [string, readonly number[]]>;
-        query_embeddings?: Array<readonly [string, readonly number[]]>;
-        queryAnalysis?: QueryAnalysis | null;
-        query_analysis?: QueryAnalysis | null;
-        candidateScopes?: readonly string[];
-        candidate_scopes?: readonly string[];
-        chunkFindings?: readonly unknown[];
-        chunk_findings?: readonly unknown[];
-        evidenceGaps?: readonly string[];
-        evidence_gaps?: readonly string[];
-        confidence?: number;
-        finalResults?: readonly MemoryMatch[];
-        final_results?: readonly MemoryMatch[];
-        explorationBudget?: number;
-        exploration_budget?: number;
-    });
-}
-export declare const VECTOR_NAME = "memory";
-export declare const DEFAULT_VECTOR_DIM = 1536;
-export type MemoryVectorSearchOptions = {
-    scope_prefix?: string | null;
-    scopePrefix?: string | null;
-    categories?: readonly string[] | null;
-    metadata_filter?: Record<string, unknown> | null;
-    metadataFilter?: Record<string, unknown> | null;
-    limit?: number;
-    min_score?: number;
-    minScore?: number;
-};
-export type MemoryVectorStorageLike = {
-    search(embedding: readonly number[], options?: MemoryVectorSearchOptions): Array<readonly [MemoryRecord, number]>;
-};
-export type QdrantEdgeConfig = {
-    vectors: Record<string, {
-        size: number;
-        distance: "Cosine";
-    }>;
-};
-export type QdrantScopeFilter = {
-    must: readonly [{
-        key: "scope_ancestors";
-        match: {
-            value: string;
-        };
-    }];
-};
-export type QdrantPoint = {
-    id: number;
-    vector: Record<typeof VECTOR_NAME, readonly number[]>;
-    payload: {
-        record_id: string;
-        content: string;
-        scope: string;
-        scope_ancestors: readonly string[];
-        categories: readonly string[];
-        metadata: Record<string, unknown>;
-        importance: number;
-        created_at: string;
-        last_accessed: string;
-        source: string;
-        private: boolean;
-    };
-};
-export type QdrantShardHandle = {
-    path: string;
-    points: QdrantPoint[];
-    closed: boolean;
-    close: () => void;
-    flush: () => void;
-};
-export declare class QdrantEdgeStorage implements MemoryVectorStorageLike {
-    private readonly records;
-    readonly path: string | null;
-    readonly vectorDim: number;
-    readonly vector_dim: number;
-    readonly _base_path: string | null;
-    readonly _central_path: string | null;
-    readonly _local_path: string | null;
-    _local_has_data: boolean;
-    _closed: boolean;
-    _indexes_created: boolean;
-    constructor(options?: string | {
-        path?: string | null;
-        vectorDim?: number | null;
-        vector_dim?: number | null;
-    } | null);
-    save(records: MemoryRecord | MemoryRecordOptions | readonly (MemoryRecord | MemoryRecordOptions)[]): void;
-    search(embedding: readonly number[], optionsOrScopePrefix?: MemoryVectorSearchOptions | string | null, categoriesArg?: readonly string[] | null, metadataFilterArg?: Record<string, unknown> | null, limitArg?: number, minScoreArg?: number): Array<readonly [MemoryRecord, number]>;
-    get_record(record_id: string): MemoryRecord | null;
-    getRecord(recordId: string): MemoryRecord | null;
-    update(record: MemoryRecord | MemoryRecordOptions): void;
-    touch_records(record_ids: readonly string[]): void;
-    touchRecords(recordIds: readonly string[]): void;
-    list_records(scope_prefix?: string | null, limit?: number, offset?: number): MemoryRecord[];
-    listRecords(scopePrefix?: string | null, limit?: number, offset?: number): MemoryRecord[];
-    delete(scope_prefix?: string | null, categories?: readonly string[] | null, record_ids?: readonly string[] | null, older_than?: Date | string | null, metadata_filter?: Record<string, unknown> | null): number;
-    reset(scope_prefix?: string | null): void;
-    get_scope_info(scope: string): ScopeInfo;
-    getScopeInfo(scope: string): ScopeInfo;
-    list_scopes(parent?: string): string[];
-    listScopes(parent?: string): string[];
-    list_categories(scope_prefix?: string | null): Record<string, number>;
-    listCategories(scopePrefix?: string | null): Record<string, number>;
-    count(scope_prefix?: string | null): number;
-    asave(records: MemoryRecord | MemoryRecordOptions | readonly (MemoryRecord | MemoryRecordOptions)[]): Promise<void>;
-    asearch(embedding: readonly number[], scope_prefix?: string | null, categories?: readonly string[] | null, metadata_filter?: Record<string, unknown> | null, limit?: number, min_score?: number): Promise<Array<readonly [MemoryRecord, number]>>;
-    adelete(scope_prefix?: string | null, categories?: readonly string[] | null, record_ids?: readonly string[] | null, older_than?: Date | string | null, metadata_filter?: Record<string, unknown> | null): Promise<number>;
-    optimize(): void;
-    flush_to_central(): void;
-    flushToCentral(): void;
-    close(): void;
-    aclose(): Promise<void>;
-    _build_config(dim: number): QdrantEdgeConfig;
-    _open_shard(path: string): QdrantShardHandle;
-    _ensure_indexes(_shard: QdrantShardHandle): void;
-    _record_to_point(record: MemoryRecord): QdrantPoint;
-    _payload_to_record(payload: QdrantPoint["payload"] | Record<string, unknown>, vector?: Record<typeof VECTOR_NAME, readonly number[]> | null): MemoryRecord;
-    _build_scope_filter(scope_prefix: string | null): QdrantScopeFilter | null;
-    _scroll_all(shard: QdrantShardHandle, _filter?: QdrantScopeFilter | null, _with_vector?: boolean): QdrantPoint[];
-    _delete_from_shard(shard: QdrantShardHandle, scope_prefix: string | null, categories: readonly string[] | null, record_ids: readonly string[] | null, older_than: Date | string | null, metadata_filter: Record<string, unknown> | null): number;
-    _delete_from_shard_path(shard_path: string, scope_prefix: string | null, categories: readonly string[] | null, record_ids: readonly string[] | null, older_than: Date | string | null, metadata_filter: Record<string, unknown> | null): number;
-    _upsert_to_central(points: readonly QdrantPoint[]): void;
-    _cleanup_orphaned_shards(): void;
-}
-export type LanceDBStorageOptions = {
-    path?: string | null;
-    tableName?: string;
-    table_name?: string;
-    vectorDim?: number | null;
-    vector_dim?: number | null;
-    compactEvery?: number;
-    compact_every?: number;
-};
-export type LanceDBRow = {
-    id: string;
-    content: string;
-    scope: string;
-    categories_str: string;
-    metadata_str: string;
-    importance: number;
-    created_at: string;
-    last_accessed: string;
-    source: string;
-    private: boolean;
-    vector: readonly number[];
-};
-export declare class LanceDBStorage extends QdrantEdgeStorage {
-    readonly tableName: string;
-    readonly table_name: string;
-    readonly compactEvery: number;
-    readonly compact_every: number;
-    _save_count: number;
-    constructor(options?: string | LanceDBStorageOptions | null);
-    save(records: MemoryRecord | MemoryRecordOptions | readonly (MemoryRecord | MemoryRecordOptions)[]): void;
-    _infer_dim_from_table(table: {
-        schema?: Iterable<{
-            name?: string;
-            type?: {
-                list_size?: unknown;
-                listSize?: unknown;
-            };
-        }>;
-    }): number;
-    _ensure_table(_vector_dim?: number | null): this;
-    _create_table(vector_dim: number): this;
-    _do_write(op: string, ...args: unknown[]): unknown;
-    _ensure_scope_index(): void;
-    _compact_if_needed(): void;
-    _compact_async(): void;
-    _compact_safe(): void;
-    _record_to_row(record: MemoryRecord): LanceDBRow;
-    _row_to_record(row: LanceDBRow | Record<string, unknown>): MemoryRecord;
-    _scan_rows(scope_prefix?: string | null, limit?: number, columns?: readonly string[] | null): Record<string, unknown>[];
-}
-export declare class StorageBackend extends QdrantEdgeStorage {
-}
-export declare class RecallFlow {
-    private readonly storage;
-    private readonly llm;
-    private readonly embedder;
-    private readonly config;
-    readonly _skip_auto_memory = true;
-    readonly state: RecallState;
-    constructor(storage: MemoryVectorStorageLike, llm?: unknown, embedder?: unknown, config?: MemoryConfig);
-    analyze_query_step(): QueryAnalysis;
-    analyzeQueryStep(): QueryAnalysis;
-    private recallStorageListScopes;
-    private recallStorageScopeInfo;
-    private analyzeRecallQuerySync;
-    private callRecallLLMSync;
-    filter_and_chunk(): string[];
-    filterAndChunk(): string[];
-    _merged_categories(): readonly string[] | null;
-    private mergedCategories;
-    _search_one(embedding: readonly number[], scope: string): [string, Array<readonly [MemoryRecord, number]>];
-    _do_search(): Array<{
-        scope: string;
-        results: Array<readonly [MemoryRecord, number]>;
-        top_score: number;
-    }>;
-    private doSearch;
-    search_chunks(): Array<{
-        scope: string;
-        results: Array<readonly [MemoryRecord, number]>;
-        top_score: number;
-    }>;
-    searchChunks(): Array<{
-        scope: string;
-        results: Array<readonly [MemoryRecord, number]>;
-        top_score: number;
-    }>;
-    decide_depth(): "explore_deeper" | "synthesize";
-    decideDepth(): "explore_deeper" | "synthesize";
-    recursive_exploration(): Array<{
-        scope: string;
-        extraction: unknown;
-        results: unknown;
-    }>;
-    recursiveExploration(): Array<{
-        scope: string;
-        extraction: unknown;
-        results: unknown;
-    }>;
-    re_search(): Array<{
-        scope: string;
-        results: Array<readonly [MemoryRecord, number]>;
-        top_score: number;
-    }>;
-    reSearch(): Array<{
-        scope: string;
-        results: Array<readonly [MemoryRecord, number]>;
-        top_score: number;
-    }>;
-    re_decide_depth(): "explore_deeper" | "synthesize";
-    reDecideDepth(): "explore_deeper" | "synthesize";
-    synthesize_results(): MemoryMatch[];
-    synthesizeResults(): MemoryMatch[];
-    kickoff(options?: {
-        inputs?: Partial<RecallState>;
-    }): MemoryMatch[];
-}
-export type MemoryInfo = {
-    totalRecords: number;
-    total_records: number;
-    scopes: readonly string[] | readonly ScopeInfo[];
-    categories: Record<string, number> | Record<string, {
-        count: number;
-        scopes: readonly string[];
-    }>;
-    readOnly: boolean;
-    read_only: boolean;
-};
-export type MemoryTreeNode = {
-    path: string;
-    count: number;
-    children: Record<string, MemoryTreeNode>;
-    categories?: readonly string[];
-};
-export declare class Memory {
-    readonly memoryKind = "memory";
-    readonly memory_kind = "memory";
-    readonly readOnly: boolean;
-    readonly read_only: boolean;
-    readonly rootScope: string | null;
-    readonly root_scope: string | null;
-    readonly llm: LLM | null;
-    readonly embedder: unknown;
-    private embedderInstance;
-    private config;
-    private readonly configOptions;
-    private readonly records;
-    private readonly pendingWrites;
-    constructor(options?: MemoryOptions);
-    modelPostInit(_context?: unknown): void;
-    model_post_init(_context?: unknown): void;
-    __deepcopy__(_memo?: Record<PropertyKey, unknown> | null): Memory;
-    get _llm(): LLM | null;
-    get _embedder(): unknown;
-    _submit_save(fn: (...args: readonly unknown[]) => MemoryRecord[], ...args: readonly unknown[]): {
-        result: () => MemoryRecord[];
-    };
-    _on_save_done(future: {
-        exception?: () => unknown;
-    } | null): void;
-    _encode_batch(contents: readonly string[], scope?: string | null, categories?: readonly string[] | null, metadata?: Record<string, unknown> | null, importance?: number | null, source?: string | null, privateMemory?: boolean, rootScope?: string | null): MemoryRecord[];
-    _background_encode_batch(contents: readonly string[], scope?: string | null, categories?: readonly string[] | null, metadata?: Record<string, unknown> | null, importance?: number | null, source?: string | null, privateMemory?: boolean, agentRole?: string | null, rootScope?: string | null): MemoryRecord[];
-    remember(content: string, options?: {
-        scope?: string | null;
-        categories?: readonly string[] | null;
-        metadata?: Record<string, unknown> | null;
-        importance?: number | null;
-        source?: string | null;
-        private?: boolean;
-        agentRole?: string | null;
-        rootScope?: string | null;
-        root_scope?: string | null;
-    }): MemoryRecord | null;
-    rememberMany(contents: readonly string[], options?: Parameters<Memory["remember"]>[1]): MemoryRecord[];
-    remember_many(contents: readonly string[], options?: Parameters<Memory["remember"]>[1]): MemoryRecord[];
-    aremember(content: string, options?: Parameters<Memory["remember"]>[1]): Promise<MemoryRecord | null>;
-    private resolveSaveOptions;
-    private resolveSaveOptionsSync;
-    private findSimilarRecords;
-    private applyConsolidationPlan;
-    aremember_many(contents: readonly string[], options?: Parameters<Memory["remember"]>[1]): Promise<MemoryRecord[]>;
-    extractMemories(content: string): readonly string[];
-    extract_memories(content: string): readonly string[];
-    aextract_memories(content: string): Promise<readonly string[]>;
-    recall(query: string, options?: {
-        scope?: string | null;
-        categories?: readonly string[] | null;
-        limit?: number;
-        scoreThreshold?: number | null;
-        source?: string | null;
-        includePrivate?: boolean;
-        depth?: "shallow" | "deep";
-    }): MemoryMatch[];
-    arecall(query: string, options?: Parameters<Memory["recall"]>[1]): Promise<MemoryMatch[]>;
-    private touchRecords;
-    private shallowRecall;
-    private deepRecall;
-    forget(options?: {
-        scope?: string | null;
-        categories?: readonly string[] | null;
-        recordIds?: readonly string[] | null;
-        record_ids?: readonly string[] | null;
-        olderThan?: Date | string | null;
-        older_than?: Date | string | null;
-        metadataFilter?: Record<string, unknown> | null;
-        metadata_filter?: Record<string, unknown> | null;
-    }): number;
-    get_record(recordId: string): MemoryRecord | null;
-    getRecord(recordId: string): MemoryRecord | null;
-    update(record: MemoryRecord | MemoryRecordOptions): MemoryRecord | null;
-    update(recordId: string, updates: MemoryUpdateOptions): MemoryRecord | null;
-    drainWrites(): void;
-    drain_writes(): void;
-    close(): void;
-    reset(scope?: string | null | {
-        scope_prefix?: string | null;
-        scopePrefix?: string | null;
-    }): void;
-    scope(path: string): MemoryScope;
-    slice(scopes: readonly string[] | string, options?: {
-        categories?: readonly string[] | null;
-        readOnly?: boolean;
-    }): MemorySlice;
-    listScopes(full?: boolean): readonly string[] | readonly ScopeInfo[];
-    listScopes(path: string | null): readonly string[];
-    list_scopes(full?: boolean): readonly string[] | readonly ScopeInfo[];
-    list_scopes(path: string | null): readonly string[];
-    listCategories(full?: boolean): Record<string, number> | Record<string, {
-        count: number;
-        scopes: readonly string[];
-    }>;
-    listCategories(path: string | null): Record<string, number>;
-    list_categories(full?: boolean): Record<string, number> | Record<string, {
-        count: number;
-        scopes: readonly string[];
-    }>;
-    list_categories(path: string | null): Record<string, number>;
-    listRecords(scope?: string | null, limit?: number, offset?: number): MemoryRecord[];
-    list_records(scope?: string | null, limit?: number, offset?: number): MemoryRecord[];
-    info(full?: boolean): MemoryInfo;
-    info(path: string | null): ScopeInfo;
-    tree(full?: boolean, maxDepth?: number): MemoryTreeNode;
-    tree(path: string | null, maxDepth?: number): string;
-    allRecords(): readonly MemoryRecord[];
-    private runBackgroundSave;
-    private runResolvedBackgroundSave;
-    private applyBatchSavePlans;
-    private createMemoryRecordFromResolvedItem;
-    private embeddingForText;
-    private attachBatchEmbeddings;
-    private memoryVectorStorage;
-    private scopePath;
-    private effectivePath;
-    private recordsForScope;
-    private immediateChildScopes;
-    private scopeInfoForPath;
-    private formatTree;
-    private scopeInfos;
-}
-export declare function embed_text(embedder: unknown, text: string): number[];
-export declare function embed_texts(embedder: unknown, texts: readonly string[]): number[][];
-export declare function compute_composite_score(record: MemoryRecord, semantic_score: number, config?: MemoryConfig): [number, string[]];
-export declare function sanitize_scope_name(name: unknown): string;
-export declare function normalize_scope_path(path: string): string;
-declare function buildScopeAncestors(scope: string): string[];
-export declare const _build_scope_ancestors: typeof buildScopeAncestors;
-export declare function _uuid_to_point_id(value: string): number;
-export declare function _parse_dt(value: unknown): Date;
-export declare const join_scope_paths: typeof joinScopePaths;
-type MemoryRememberOptions = NonNullable<Parameters<Memory["remember"]>[1]>;
-type MemoryRecallOptions = NonNullable<Parameters<Memory["recall"]>[1]>;
-type MemoryForgetOptions = NonNullable<Parameters<Memory["forget"]>[0]>;
-export declare function _ensure_memory_kind<T>(value: T): T;
-export declare function _walk(memory: Memory, lines: string[], path: string, depth: number, prefix: string, maxDepth: number): void;
-export declare class MemoryScope {
-    readonly memoryKind = "scope";
-    readonly memory_kind = "scope";
-    memory: Memory | null;
-    readonly rootPath: string;
-    readonly root_path: string;
-    constructor(memory: Memory | null, rootPath?: string);
-    static _accept_memory(data: unknown): MemoryScope;
-    get readOnly(): boolean;
-    get read_only(): boolean;
-    _requireMemory(): Memory;
-    _require_memory(): Memory;
-    _scopePath(scope?: string | null): string;
-    _scope_path(scope?: string | null): string;
-    remember(content: string, options?: MemoryRememberOptions): MemoryRecord | null;
-    recall(query: string, options?: MemoryRecallOptions): MemoryMatch[];
-    rememberMany(contents: readonly string[], options?: MemoryRememberOptions): MemoryRecord[];
-    remember_many(contents: readonly string[], options?: MemoryRememberOptions): MemoryRecord[];
-    extractMemories(content: string): readonly string[];
-    extract_memories(content: string): readonly string[];
-    forget(options?: MemoryForgetOptions): number;
-    reset(scope?: string | null): void;
-    listScopes(full?: boolean): readonly string[] | readonly ScopeInfo[];
-    listScopes(path: string | null): readonly string[];
-    list_scopes(full?: boolean): readonly string[] | readonly ScopeInfo[];
-    list_scopes(path: string | null): readonly string[];
-    info(full?: boolean): MemoryInfo;
-    info(path: string | null): ScopeInfo;
-    listCategories(full?: boolean): Record<string, number> | Record<string, {
-        count: number;
-        scopes: readonly string[];
-    }>;
-    listCategories(path: string | null): Record<string, number>;
-    list_categories(full?: boolean): Record<string, number> | Record<string, {
-        count: number;
-        scopes: readonly string[];
-    }>;
-    list_categories(path: string | null): Record<string, number>;
-    tree(full?: boolean, maxDepth?: number): MemoryTreeNode;
-    tree(path: string | null, maxDepth?: number): string;
-    subscope(path: string): MemoryScope;
-    bind(memory: Memory): this;
-}
-export declare class MemorySlice {
-    readonly memoryKind = "slice";
-    readonly memory_kind = "slice";
-    memory: Memory | null;
-    readonly scopes: readonly string[];
-    readonly categories: readonly string[] | null;
-    private readonly readOnlyValue;
-    constructor(memory: Memory | null, scopes: readonly string[], options?: {
-        categories?: readonly string[] | null;
-        readOnly?: boolean;
-    });
-    static _accept_memory(data: unknown): MemorySlice;
-    get readOnly(): boolean;
-    get read_only(): boolean;
-    _requireMemory(): Memory;
-    _require_memory(): Memory;
-    remember(content: string, options?: MemoryRememberOptions): MemoryRecord | null;
-    rememberMany(contents: readonly string[], options?: MemoryRememberOptions): MemoryRecord[];
-    remember_many(contents: readonly string[], options?: MemoryRememberOptions): MemoryRecord[];
-    recall(query: string, options?: Omit<MemoryRecallOptions, "scope">): MemoryMatch[];
-    extractMemories(content: string): readonly string[];
-    extract_memories(content: string): readonly string[];
-    subscope(path: string): MemorySlice;
-    listScopes(full?: boolean): readonly string[] | readonly ScopeInfo[];
-    listScopes(path: string | null): readonly string[];
-    list_scopes(full?: boolean): readonly string[] | readonly ScopeInfo[];
-    list_scopes(path: string | null): readonly string[];
-    info(full?: boolean): MemoryInfo;
-    info(path: string | null): ScopeInfo;
-    listCategories(full?: boolean): Record<string, number> | Record<string, {
-        count: number;
-        scopes: readonly string[];
-    }>;
-    listCategories(path: string | null): Record<string, number>;
-    list_categories(full?: boolean): Record<string, number> | Record<string, {
-        count: number;
-        scopes: readonly string[];
-    }>;
-    list_categories(path: string | null): Record<string, number>;
-    tree(full?: boolean, maxDepth?: number): MemoryTreeNode;
-    bind(memory: Memory): this;
-    private recordsInSlice;
-    private slicePath;
-}
-export declare const RecallMemorySchema: {
-    queries: {
-        type: "array";
-        required: true;
-        description: string;
-    };
-};
-export declare class RecallMemoryTool extends BaseTool {
-    readonly memory: Memory | MemoryScope | MemorySlice;
-    constructor(options: Partial<BaseToolOptions> & {
-        memory: Memory | MemoryScope | MemorySlice;
-    });
-    protected _run(args: Record<string, unknown>): string;
-}
-export declare const RememberSchema: {
-    contents: {
-        type: "array";
-        required: true;
-        description: string;
-    };
-};
-export declare class RememberTool extends BaseTool {
-    readonly memory: Memory | MemoryScope | MemorySlice;
-    constructor(options: Partial<BaseToolOptions> & {
-        memory: Memory | MemoryScope | MemorySlice;
-    });
-    protected _run(args: Record<string, unknown>): string;
-}
-export declare function createMemoryTools(memory: Memory | MemoryScope | MemorySlice): Tool[];
-export declare const create_memory_tools: typeof createMemoryTools;
-export declare function extractMemoriesFromContent(content: string, llm: LLM): Promise<readonly string[]>;
-export declare const extract_memories_from_content: typeof extractMemoriesFromContent;
-export declare function analyzeQuery(query: string, availableScopes: readonly string[], scopeInfo: ScopeInfo | null, llm: LLM): Promise<QueryAnalysis>;
-export declare const analyze_query: typeof analyzeQuery;
-export declare function analyzeForSave(content: string, existingScopes: readonly string[], existingCategories: readonly string[], llm: LLM): Promise<MemoryAnalysis>;
-export declare const analyze_for_save: typeof analyzeForSave;
-export declare function analyzeForConsolidation(newContent: string, existingRecords: readonly MemoryRecord[], llm: LLM): Promise<ConsolidationPlan>;
-export declare const analyze_for_consolidation: typeof analyzeForConsolidation;
-export declare function joinScopePaths(root: string | null | undefined, child: string | null | undefined): string;
-export {};