@framers/agentos 0.6.30 → 0.7.0

package/dist/memory/io/extension/MemoryToolsExtension.d.ts

@@ -1,59 +0,0 @@
-/**
- * @fileoverview Extension-pack helpers for exposing the standalone SQLite
- * memory editor tools through the AgentOS extension system.
- *
- * The underlying tools already exist as `ITool` implementations; this module
- * adapts them into `tool` descriptors and extension packs so they can be
- * loaded through `ExtensionManager`, which is the same registry path consumed
- * by `ToolExecutor` and `ToolOrchestrator`.
- *
- * @module agentos/memory/extension/MemoryToolsExtension
- */
-import type { ExtensionPack } from '../../../extensions/manifest.js';
-import { type ToolDescriptor } from '../../../extensions/types.js';
-import type { Memory } from '../../io/facade/Memory.js';
-/**
- * Options controlling which memory tools are exposed and how their descriptors
- * are prioritised.
- */
-export interface MemoryToolsExtensionOptions {
-    /**
-     * Include the `memory_reflect` consolidation tool when available.
-     * Defaults to `true`.
-     */
-    includeReflect?: boolean;
-    /**
-     * Optional registry priority applied to all emitted tool descriptors.
-     */
-    priority?: number;
-    /**
-     * Optional pack name override.
-     * @default 'agentos-memory-tools'
-     */
-    name?: string;
-    /**
-     * Optional pack version override.
-     * @default '1.0.0'
-     */
-    version?: string;
-    /**
-     * Include the `rehydrate_memory` tool for inflating gisted/archived traces.
-     * Requires an `IMemoryArchive` to be provided via the archive option.
-     * Defaults to `false`.
-     */
-    includeRehydrate?: boolean;
-}
-/**
- * Convert a standalone `Memory` facade's built-in tool set into extension
- * descriptors that can be registered directly with `ExtensionManager`.
- */
-export declare function createMemoryToolDescriptors(memory: Pick<Memory, 'createTools'>, options?: Pick<MemoryToolsExtensionOptions, 'includeReflect' | 'priority'>): ToolDescriptor[];
-/**
- * Create an `ExtensionPack` exposing the standalone memory editor tools.
- *
- * Loading the returned pack through `ExtensionManager` makes the tools
- * immediately visible to `ToolExecutor`/`ToolOrchestrator` because they all
- * share the same `tool` registry.
- */
-export declare function createMemoryToolsPack(memory: Pick<Memory, 'createTools'>, options?: MemoryToolsExtensionOptions): ExtensionPack;
-//# sourceMappingURL=MemoryToolsExtension.d.ts.map

package/dist/memory/io/extension/MemoryToolsExtension.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"MemoryToolsExtension.d.ts","sourceRoot":"","sources":["../../../../src/memory/io/extension/MemoryToolsExtension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAExD;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAqBD;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,EACnC,OAAO,CAAC,EAAE,IAAI,CAAC,2BAA2B,EAAE,gBAAgB,GAAG,UAAU,CAAC,GACzE,cAAc,EAAE,CAIlB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,EACnC,OAAO,CAAC,EAAE,2BAA2B,GACpC,aAAa,CAMf"}

package/dist/memory/io/extension/MemoryToolsExtension.js

@@ -1,54 +0,0 @@
-/**
- * @fileoverview Extension-pack helpers for exposing the standalone SQLite
- * memory editor tools through the AgentOS extension system.
- *
- * The underlying tools already exist as `ITool` implementations; this module
- * adapts them into `tool` descriptors and extension packs so they can be
- * loaded through `ExtensionManager`, which is the same registry path consumed
- * by `ToolExecutor` and `ToolOrchestrator`.
- *
- * @module agentos/memory/extension/MemoryToolsExtension
- */
-import { EXTENSION_KIND_TOOL, } from '../../../extensions/types.js';
-function toToolDescriptor(tool, priority) {
-    return {
-        id: tool.name,
-        kind: EXTENSION_KIND_TOOL,
-        ...(priority !== undefined ? { priority } : {}),
-        payload: tool,
-        metadata: {
-            toolId: tool.id,
-            origin: 'memory-tools-pack',
-            category: tool.category ?? 'memory',
-        },
-        onDeactivate: async () => {
-            if (typeof tool.shutdown === 'function') {
-                await tool.shutdown();
-            }
-        },
-    };
-}
-/**
- * Convert a standalone `Memory` facade's built-in tool set into extension
- * descriptors that can be registered directly with `ExtensionManager`.
- */
-export function createMemoryToolDescriptors(memory, options) {
-    return memory
-        .createTools({ includeReflect: options?.includeReflect })
-        .map((tool) => toToolDescriptor(tool, options?.priority));
-}
-/**
- * Create an `ExtensionPack` exposing the standalone memory editor tools.
- *
- * Loading the returned pack through `ExtensionManager` makes the tools
- * immediately visible to `ToolExecutor`/`ToolOrchestrator` because they all
- * share the same `tool` registry.
- */
-export function createMemoryToolsPack(memory, options) {
-    return {
-        name: options?.name ?? 'agentos-memory-tools',
-        version: options?.version ?? '1.0.0',
-        descriptors: createMemoryToolDescriptors(memory, options),
-    };
-}
-//# sourceMappingURL=MemoryToolsExtension.js.map

package/dist/memory/io/extension/MemoryToolsExtension.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"MemoryToolsExtension.js","sourceRoot":"","sources":["../../../../src/memory/io/extension/MemoryToolsExtension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EACL,mBAAmB,GAEpB,MAAM,8BAA8B,CAAC;AAuCtC,SAAS,gBAAgB,CAAC,IAAW,EAAE,QAAiB;IACtD,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,IAAI;QACb,IAAI,EAAE,mBAAmB;QACzB,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE;YACR,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,MAAM,EAAE,mBAAmB;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,QAAQ;SACpC;QACD,YAAY,EAAE,KAAK,IAAI,EAAE;YACvB,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;gBACxC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;YACxB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,MAAmC,EACnC,OAA0E;IAE1E,OAAO,MAAM;SACV,WAAW,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;SACxD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAmC,EACnC,OAAqC;IAErC,OAAO;QACL,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,sBAAsB;QAC7C,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,OAAO;QACpC,WAAW,EAAE,2BAA2B,CAAC,MAAM,EAAE,OAAO,CAAC;KAC1D,CAAC;AACJ,CAAC"}

package/dist/memory/io/extension/StandaloneMemoryExtension.d.ts

@@ -1,27 +0,0 @@
-/**
- * @fileoverview Extension registration for the standalone SQLite-first
- * `Memory` facade.
- *
- * This exposes the facade through the generic `memory-provider` extension kind
- * so hosts can treat it like any other pluggable memory backend.
- *
- * @module agentos/memory/extension/StandaloneMemoryExtension
- */
-import { type MemoryProviderPayload, type MemoryProviderDescriptor } from '../../../extensions/types.js';
-export interface StandaloneMemoryDescriptorOptions {
-    /**
-     * When true, the descriptor's `shutdown()` will close the configured
-     * `Memory` instance.
-     * @default false
-     */
-    manageLifecycle?: boolean;
-    /**
-     * Optional payload overrides.
-     */
-    overrides?: Partial<MemoryProviderPayload>;
-}
-/**
- * Create a `memory-provider` descriptor for the standalone `Memory` facade.
- */
-export declare function createStandaloneMemoryDescriptor(options?: StandaloneMemoryDescriptorOptions): MemoryProviderDescriptor;
-//# sourceMappingURL=StandaloneMemoryExtension.d.ts.map

package/dist/memory/io/extension/StandaloneMemoryExtension.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"StandaloneMemoryExtension.d.ts","sourceRoot":"","sources":["../../../../src/memory/io/extension/StandaloneMemoryExtension.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC9B,MAAM,8BAA8B,CAAC;AAqBtC,MAAM,WAAW,iCAAiC;IAChD;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC5C;AAwDD;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,CAAC,EAAE,iCAAiC,GAC1C,wBAAwB,CAsE1B"}

package/dist/memory/io/extension/StandaloneMemoryExtension.js

@@ -1,122 +0,0 @@
-/**
- * @fileoverview Extension registration for the standalone SQLite-first
- * `Memory` facade.
- *
- * This exposes the facade through the generic `memory-provider` extension kind
- * so hosts can treat it like any other pluggable memory backend.
- *
- * @module agentos/memory/extension/StandaloneMemoryExtension
- */
-import { EXTENSION_KIND_MEMORY_PROVIDER, } from '../../../extensions/types.js';
-function isRuntimeMemory(value) {
-    return (typeof value === 'object' &&
-        value !== null &&
-        typeof value.remember === 'function' &&
-        typeof value.recall === 'function' &&
-        typeof value.forget === 'function' &&
-        typeof value.health === 'function');
-}
-function parseStoreInput(data) {
-    if (typeof data === 'string') {
-        return { content: data };
-    }
-    if (typeof data !== 'object' || data === null) {
-        throw new Error('Standalone memory store() expects a string or { content, options? }.');
-    }
-    const parsed = data;
-    if (typeof parsed.content !== 'string' || !parsed.content.trim()) {
-        throw new Error('Standalone memory store() requires a non-empty content string.');
-    }
-    return {
-        content: parsed.content,
-        options: parsed.options,
-    };
-}
-function parseQueryInput(query) {
-    if (typeof query === 'string') {
-        return { text: query };
-    }
-    if (typeof query !== 'object' || query === null) {
-        throw new Error('Standalone memory query() expects a string or { text|query, options? }.');
-    }
-    const parsed = query;
-    const text = parsed.text ?? parsed.query;
-    if (typeof text !== 'string' || !text.trim()) {
-        throw new Error('Standalone memory query() requires a non-empty query string.');
-    }
-    return {
-        text,
-        options: parsed.options,
-    };
-}
-/**
- * Create a `memory-provider` descriptor for the standalone `Memory` facade.
- */
-export function createStandaloneMemoryDescriptor(options) {
-    let memory = null;
-    const payload = {
-        name: 'standalone-memory',
-        description: 'SQLite-first standalone memory facade with remember/recall, document ingestion, and self-improving consolidation support.',
-        supportedTypes: ['episodic', 'semantic', 'procedural', 'prospective', 'relational'],
-        initialize: async (config) => {
-            const candidate = config.memory;
-            if (!isRuntimeMemory(candidate)) {
-                throw new Error('Standalone memory provider requires initialize({ memory }) with remember()/recall()/forget()/health() methods.');
-            }
-            memory = candidate;
-        },
-        store: async (_collectionId, data) => {
-            if (!memory) {
-                throw new Error('Standalone memory provider not initialized.');
-            }
-            const input = parseStoreInput(data);
-            const trace = await memory.remember(input.content, input.options);
-            return trace.id;
-        },
-        query: async (_collectionId, query) => {
-            if (!memory) {
-                throw new Error('Standalone memory provider not initialized.');
-            }
-            const input = parseQueryInput(query);
-            return (await memory.recall(input.text, input.options));
-        },
-        delete: async (_collectionId, ids) => {
-            if (!memory) {
-                throw new Error('Standalone memory provider not initialized.');
-            }
-            await Promise.all(ids.map((id) => memory.forget(id)));
-        },
-        getStats: async () => {
-            if (!memory) {
-                throw new Error('Standalone memory provider not initialized.');
-            }
-            const health = await memory.health();
-            return {
-                collections: Object.keys(health.tracesPerScope ?? {}).length,
-                documents: health.activeTraces,
-                size: health.totalTraces,
-            };
-        },
-        shutdown: async () => {
-            if (!memory)
-                return;
-            if (options?.manageLifecycle) {
-                await memory.close?.();
-            }
-            memory = null;
-        },
-        ...options?.overrides,
-    };
-    return {
-        id: 'agentos-standalone-memory',
-        kind: EXTENSION_KIND_MEMORY_PROVIDER,
-        priority: 100,
-        enableByDefault: true,
-        payload,
-        metadata: {
-            version: '1.0.0',
-            runtime: 'sqlite-first-memory-facade',
-        },
-    };
-}
-//# sourceMappingURL=StandaloneMemoryExtension.js.map

package/dist/memory/io/extension/StandaloneMemoryExtension.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"StandaloneMemoryExtension.js","sourceRoot":"","sources":["../../../../src/memory/io/extension/StandaloneMemoryExtension.ts"],"names":[],"mappings":"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"}

package/dist/memory/io/facade/Memory.d.ts

@@ -1,385 +0,0 @@
-/**
- * @fileoverview Memory facade -- unified public API for the complete memory system.
- *
- * The `Memory` class wires together every subsystem built in Tasks 1-12:
- * - Brain (unified SQLite connection with WAL, full schema)
- * - SqlKnowledgeGraph (IKnowledgeGraph backed by SQLite)
- * - SqlMemoryGraph (IMemoryGraph with spreading activation)
- * - LoaderRegistry (document loaders: text, md, html, pdf, docx)
- * - FolderScanner (recursive directory scanning)
- * - ChunkingEngine (4 chunking strategies)
- * - RetrievalFeedbackSignal (used/ignored detection)
- * - ConsolidationLoop (6-step self-improvement)
- * - I/O exporters and importers (JSON, Markdown, Obsidian, SQLite, ChatGPT)
- *
- * Consumers only need to import this single class to interact with the entire
- * memory subsystem.
- *
- * @module memory/facade/Memory
- */
-import type { MemoryTrace } from '../../core/types.js';
-import type { ITool } from '../../../core/tools/ITool.js';
-import type { MemoryConfig, RememberOptions, RecallOptions, IngestOptions, IngestResult, ExportOptions, ImportOptions, ImportResult, ConsolidationResult, MemoryHealth } from './types.js';
-import type { IKnowledgeGraph, KnowledgeEntity, KnowledgeRelation } from '../../retrieval/graph/knowledge/IKnowledgeGraph.js';
-import type { RetrievalFeedback } from '../../retrieval/feedback/RetrievalFeedbackSignal.js';
-/**
- * A memory trace paired with its retrieval relevance score.
- *
- * Returned by {@link Memory.recall} as a ranked list of matches.
- */
-export interface ScoredTrace {
-    /** The full memory trace envelope. */
-    trace: MemoryTrace;
-    /** Composite relevance score; higher is better. */
-    score: number;
-}
-/**
- * Unified public API for the AgentOS memory system.
- *
- * One `Memory` instance manages the full lifecycle of an agent's memories:
- * storing, retrieving, ingesting documents, building a knowledge graph,
- * self-improving through consolidation, and importing/exporting data.
- *
- * ## Quick start
- * ```ts
- * const mem = await Memory.create({ store: 'sqlite', path: './brain.sqlite' });
- *
- * await mem.remember('The user prefers dark mode');
- * const results = await mem.recall('dark mode preference');
- * console.log(results[0].trace.content);
- *
- * await mem.close();
- * ```
- */
-export declare class Memory {
-    private readonly _brain;
-    private readonly _knowledgeGraph;
-    private readonly _memoryGraph;
-    private _loaderRegistry;
-    private _folderScanner;
-    private _ingestionToolsPromise;
-    private readonly _chunkingEngine;
-    private readonly _feedbackSignal;
-    private readonly _consolidationLoop;
-    private readonly _config;
-    private _initPromise;
-    /** HNSW sidecar index for O(log n) vector search alongside SQLite. */
-    private _hnswSidecar;
-    /** Optional embedding function for vector search (set via config.embed). */
-    private readonly _embed;
-    /**
-     * Private constructor. Receives an already-opened Brain and
-     * pre-computed configuration. Use {@link Memory.create} to instantiate.
-     */
-    private constructor();
-    /**
-     * Create a new Memory instance and wire together all subsystems.
-     *
-     * Initialization sequence:
-     * 1. Merge `config` with defaults (store='sqlite', path=tmpdir, graph=true,
-     *    selfImprove=true, decay=true).
-     * 2. Await `Brain.openSqlite(config.path)`.
-     * 3. Check embedding dimension compatibility (warn on mismatch).
-     * 4. Create `SqlKnowledgeGraph(brain)`.
-     * 5. Create `SqlMemoryGraph(brain)` and call `.initialize()`.
-     * 6. Create `ChunkingEngine()`.
-     * 7. Lazily create ingestion loaders on first `ingest()` call.
-     * 8. If `selfImprove`: create `RetrievalFeedbackSignal(brain)` and
-     *    `ConsolidationLoop(brain, memoryGraph)`.
-     *
-     * @param config - Optional configuration; see {@link MemoryConfig}.
-     * @returns A fully initialised Memory instance.
-     */
-    /**
-     * Open a Memory backed by SQLite. Defaults to a tmp file when no path is given.
-     *
-     * Accepts either a path string + opts, or a `MemoryConfig` object for
-     * compatibility with the old `Memory.create(config)` shape.
-     *
-     * @example
-     * ```ts
-     * await Memory.createSqlite('./brain.sqlite');
-     * await Memory.createSqlite('./brain.sqlite', { graph: true });
-     * await Memory.createSqlite({ path: './brain.sqlite', graph: true });
-     * ```
-     */
-    /**
-     * Backwards-compatible alias for {@link Memory.createSqlite}. The earlier
-     * surface accepted `Memory.create(config)` and several published docs and
-     * blog posts still reference it; rather than break those examples we
-     * forward to `createSqlite` (the modern, more explicit factory).
-     *
-     * For non-SQLite backends call {@link Memory.createPostgres} or
-     * {@link Memory.createWithAdapter} directly.
-     */
-    static create(pathOrConfig?: string | MemoryConfig, opts?: Omit<MemoryConfig, 'store' | 'path'> & {
-        brainId?: string;
-        priority?: ('better-sqlite3' | 'sqljs' | 'indexeddb')[];
-    }): Promise<Memory>;
-    static createSqlite(pathOrConfig?: string | MemoryConfig, opts?: Omit<MemoryConfig, 'store' | 'path'> & {
-        brainId?: string;
-        priority?: ('better-sqlite3' | 'sqljs' | 'indexeddb')[];
-    }): Promise<Memory>;
-    /**
-     * Open a Memory backed by PostgreSQL. Requires the `pg` npm package.
-     *
-     * @param connectionString - Standard Postgres connection URL.
-     * @param opts.brainId - REQUIRED. Multi-tenant scope per query.
-     * @param opts.poolSize - pg pool max size. Defaults to 10.
-     * @param opts - Plus standard Memory options (graph, selfImprove, decay,
-     *   embeddings).
-     */
-    static createPostgres(connectionString: string, opts: Omit<MemoryConfig, 'store' | 'path'> & {
-        brainId: string;
-        poolSize?: number;
-    }): Promise<Memory>;
-    /**
-     * Open a Memory with a pre-resolved StorageAdapter. Use when sharing an
-     * adapter across subsystems or when you need full control over adapter
-     * resolution.
-     */
-    static createWithAdapter(adapter: import('@framers/sql-storage-adapter').StorageAdapter, opts?: Omit<MemoryConfig, 'store' | 'path'> & {
-        brainId?: string;
-    }): Promise<Memory>;
-    /**
-     * Internal common initialization path for all three factories.
-     * Wires the Memory facade around an already-opened Brain.
-     */
-    private static _initialize;
-    /**
-     * Generate a default temp SQLite path for `createSqlite()` when no
-     * explicit path is supplied. Node-only; browsers must pass a path
-     * (typically `:memory:` or an indexeddb-backed adapter).
-     */
-    private static _defaultSqlitePath;
-    /**
-     * Store a new memory trace.
-     *
-     * Creates a trace in the `memory_traces` table with a unique ID, content
-     * hash for deduplication, and optional type/scope/tags metadata. If the
-     * memory graph is available the trace is also added as a graph node.
-     *
-     * @param content - The text content to remember.
-     * @param options - Optional metadata (type, scope, tags, importance, etc.).
-     * @returns The created MemoryTrace-like object.
-     */
-    remember(content: string, options?: RememberOptions): Promise<MemoryTrace>;
-    /**
-     * Search for memory traces matching a natural-language query.
-     *
-     * Uses FTS5 full-text search with the Porter tokenizer. Results are ranked
-     * by `strength * abs(fts_rank)` and filtered by optional type/scope/strength
-     * criteria.
-     *
-     * @param query   - Natural-language search query.
-     * @param options - Optional filters (limit, type, scope, minStrength).
-     * @returns Ranked array of {@link ScoredTrace} results.
-     */
-    recall(query: string, options?: RecallOptions): Promise<ScoredTrace[]>;
-    /**
-     * Soft-delete a memory trace by setting `deleted = 1`.
-     *
-     * The trace remains in the database for audit/recovery purposes but is
-     * excluded from all recall queries and health reports.
-     *
-     * @param traceId - The ID of the trace to forget.
-     */
-    forget(traceId: string): Promise<void>;
-    /**
-     * Ingest documents from a file, directory, or URL.
-     *
-     * Workflow:
-     * 1. Detect source type (file, directory, or URL).
-     * 2. Load document(s) using the appropriate loader.
-     * 3. Chunk each document using the configured strategy.
-     * 4. For each chunk: insert into `document_chunks`, create a memory trace.
-     * 5. Record the document in the `documents` table.
-     *
-     * @param source  - File path, directory path, or URL.
-     * @param options - Optional ingestion settings (recursive, include/exclude globs).
-     * @returns Summary of the ingestion run.
-     */
-    ingest(source: string, options?: IngestOptions): Promise<IngestResult>;
-    private _ensureIngestionTools;
-    /**
-     * Add or update an entity in the knowledge graph.
-     *
-     * Delegates to `SqlKnowledgeGraph.upsertEntity()`. Accepts a partial
-     * entity; `id`, `createdAt`, and `updatedAt` are auto-generated when omitted.
-     *
-     * @param entity - Partial entity descriptor.
-     * @returns The complete, persisted entity.
-     */
-    addEntity(entity: Partial<KnowledgeEntity>): Promise<KnowledgeEntity>;
-    /**
-     * Add or update a relation (edge) in the knowledge graph.
-     *
-     * Delegates to `SqlKnowledgeGraph.upsertRelation()`. Accepts a partial
-     * relation; `id` and `createdAt` are auto-generated when omitted.
-     *
-     * @param relation - Partial relation descriptor.
-     * @returns The complete, persisted relation.
-     */
-    addRelation(relation: Partial<KnowledgeRelation>): Promise<KnowledgeRelation>;
-    /**
-     * Access the underlying IKnowledgeGraph implementation.
-     *
-     * Useful for advanced queries (traversal, semantic search, neighbourhood
-     * lookups) that are not exposed on the facade directly.
-     */
-    get graph(): IKnowledgeGraph;
-    /**
-     * Run one consolidation cycle (prune, merge, strengthen, derive, compact,
-     * re-index).
-     *
-     * @param options - Optional topic filter (reserved for future use).
-     * @returns Statistics from the consolidation run.
-     * @throws {Error} When `selfImprove` was set to `false` in the config.
-     */
-    consolidate(options?: {
-        topic?: string;
-    }): Promise<ConsolidationResult>;
-    /**
-     * Record retrieval feedback for a memory trace.
-     *
-     * The feedback is persisted asynchronously. This method returns a Promise
-     * that resolves once the feedback has been written.
-     *
-     * @param traceId - The ID of the trace being evaluated.
-     * @param signal  - Whether the trace was `'used'` or `'ignored'` by the LLM.
-     * @param query   - Optional retrieval context, typically the original user query.
-     */
-    feedback(traceId: string, signal: 'used' | 'ignored', query?: string): Promise<void>;
-    /**
-     * Detect and persist used/ignored feedback for a batch of injected traces
-     * based on the assistant's final response text.
-     *
-     * This is the high-level bridge used by long-term-memory integrations that
-     * already know which traces were injected into the prompt.
-     */
-    feedbackFromResponse(injectedTraces: MemoryTrace[], response: string, query?: string): Promise<RetrievalFeedback[]>;
-    /**
-     * Export the memory store to a file or directory.
-     *
-     * Format is detected from `options.format` or the file extension:
-     * - `.json` -> JSON
-     * - `.sqlite` / `.db` -> SQLite file copy
-     * - directory path -> Markdown or Obsidian (based on `options.format`)
-     *
-     * @param outputPath - Path to write the export to.
-     * @param options    - Optional format and content controls.
-     */
-    export(outputPath: string, options?: ExportOptions): Promise<void>;
-    /**
-     * Import memory data from a file or directory.
-     *
-     * Format is detected from `options.format`, the file extension, or by
-     * inspecting the content.
-     *
-     * @param source  - Path to the import source (file or directory).
-     * @param options - Optional format hint and dedup settings.
-     * @returns Summary of the import operation.
-     */
-    importFrom(source: string, options?: ImportOptions): Promise<ImportResult>;
-    /**
-     * Import memory data from a string without filesystem access.
-     *
-     * Supports JSON and CSV formats. Useful in browser environments or when
-     * the data is already in memory.
-     *
-     * @param content - The raw string content to import.
-     * @param format  - The format of the content: `'json'` or `'csv'`.
-     * @param options - Optional deduplication controls.
-     * @returns Summary of the import operation.
-     */
-    importFromString(content: string, format: 'json' | 'csv', options?: Pick<ImportOptions, 'dedup'>): Promise<ImportResult>;
-    /**
-     * Export the full brain state as a JSON string without filesystem access.
-     *
-     * Useful in browser environments or when the data needs to be sent over
-     * a network connection.
-     *
-     * @param options - Optional export configuration (embeddings, conversations).
-     * @returns Pretty-printed JSON string of the full brain payload.
-     */
-    exportToString(options?: ExportOptions): Promise<string>;
-    /**
-     * Create runtime `ITool` instances backed by this memory facade's SQLite brain.
-     *
-     * This is the supported bridge from the standalone memory engine into
-     * AgentOS tool registration. The returned tools share this `Memory`
-     * instance's underlying SQLite database and consolidation loop.
-     *
-     * Typical usage:
-     * ```ts
-     * for (const tool of memory.createTools()) {
-     *   await agentos.getToolOrchestrator().registerTool(tool);
-     * }
-     * ```
-     *
-     * When self-improvement is disabled, `memory_reflect` is omitted because
-     * there is no backing {@link ConsolidationLoop} instance.
-     */
-    createTools(options?: {
-        includeReflect?: boolean;
-    }): ITool[];
-    /**
-     * Return a health snapshot of the memory store.
-     *
-     * Queries aggregate statistics from all tables and returns a
-     * {@link MemoryHealth} report.
-     */
-    health(): Promise<MemoryHealth>;
-    /**
-     * Close the Memory instance and release all resources.
-     *
-     * Flushes the SQLite WAL and releases the file lock. Must be called when
-     * the agent shuts down.
-     */
-    close(): Promise<void>;
-    /**
-     * Convert a raw `memory_traces` row into a `MemoryTrace` object.
-     */
-    private _buildTrace;
-    /**
-     * Find an active trace previously stored with the same content hash.
-     *
-     * Checks both the facade-native `content_hash` metadata key and the
-     * importer-used `import_hash` key so dedup works across facade and import
-     * workflows.
-     */
-    private _findExistingTraceByHash;
-    /**
-     * Apply spaced-repetition access updates to recalled rows and persist the
-     * updated retrieval metadata back to SQLite.
-     */
-    private _applyRecallAccessUpdates;
-    /**
-     * Persist one loaded document into the documents/chunks/traces tables.
-     *
-     * Document-level dedup is keyed by `documents.content_hash`, so re-ingesting
-     * the same source content is idempotent.
-     */
-    private _ingestLoadedDocument;
-    /**
-     * Rebuild the external-content FTS index after bulk import operations.
-     */
-    private _rebuildFtsIndex;
-    private _recallWithoutFts;
-    /**
-     * Rebuild the HNSW sidecar after bulk import operations.
-     *
-     * Imports bypass `remember()`, so any embedded traces need to be replayed
-     * into the ANN sidecar explicitly to keep hybrid recall accurate.
-     */
-    private _rebuildHnswIndex;
-    /**
-     * Detect the export format from options or file extension.
-     */
-    private _detectExportFormat;
-    /**
-     * Detect the import format from options, file extension, or content inspection.
-     */
-    private _detectImportFormat;
-}
-//# sourceMappingURL=Memory.d.ts.map