@zelari/core 2.6.3 → 2.8.0

package/dist/memory/schemas.js

@@ -0,0 +1,96 @@
+import { z } from 'zod';
+import { MEMORY_KINDS, MEMORY_RELATIONS, MEMORY_SCHEMA_VERSION, MEMORY_STATUSES, MEMORY_VISIBILITIES, } from './types.js';
+const isoDate = z.string().datetime({ offset: true });
+const unit = z.number().finite().min(0).max(1);
+const metadata = z.record(z.string(), z.unknown()).refine((value) => {
+    try {
+        return JSON.stringify(value).length <= 128_000;
+    }
+    catch {
+        return false;
+    }
+}, 'Memory metadata must be JSON-serializable and no larger than 128 KB.');
+export const MemoryKindSchema = z.enum(MEMORY_KINDS);
+export const MemoryStatusSchema = z.enum(MEMORY_STATUSES);
+export const MemoryRelationSchema = z.enum(MEMORY_RELATIONS);
+export const MemoryVisibilitySchema = z.enum(MEMORY_VISIBILITIES);
+export const MemorySourceSchema = z
+    .object({
+    agent: z.string().min(1).max(200).optional(),
+    sessionId: z.string().min(1).max(300).optional(),
+    missionId: z.string().min(1).max(300).optional(),
+    sliceId: z.string().min(1).max(300).optional(),
+    tentacleId: z.string().min(1).max(300).optional(),
+    councilMemberId: z.string().min(1).max(300).optional(),
+    skillId: z.string().min(1).max(300).optional(),
+    verificationId: z.string().min(1).max(300).optional(),
+    file: z.string().min(1).max(4_096).optional(),
+    symbol: z.string().min(1).max(1_000).optional(),
+    commit: z.string().min(1).max(200).optional(),
+    branch: z.string().min(1).max(500).optional(),
+    worktree: z.string().min(1).max(4_096).optional(),
+    toolCallId: z.string().min(1).max(300).optional(),
+    client: z.string().min(1).max(300).optional(),
+})
+    .strict();
+export const MemoryNodeInputSchema = z
+    .object({
+    id: z.string().min(1).max(300).optional(),
+    projectId: z.string().min(1).max(300).optional(),
+    kind: MemoryKindSchema,
+    content: z.string().min(1).max(64_000),
+    importance: unit.optional(),
+    confidence: unit.optional(),
+    status: MemoryStatusSchema.optional(),
+    visibility: MemoryVisibilitySchema.optional(),
+    tags: z.array(z.string().min(1).max(120)).max(64).optional(),
+    source: MemorySourceSchema.optional(),
+    createdAt: isoDate.optional(),
+    recordedAt: isoDate.optional(),
+    validFrom: isoDate.optional(),
+    validUntil: isoDate.optional(),
+    embeddingRef: z.string().min(1).max(2_000).optional(),
+    metadata: metadata.optional(),
+    writeClass: z.enum(['auto', 'candidate', 'manual']).optional(),
+})
+    .strict();
+export const MemoryNodeSchema = MemoryNodeInputSchema.omit({ writeClass: true })
+    .extend({
+    id: z.string().min(1).max(300),
+    schemaVersion: z.literal(MEMORY_SCHEMA_VERSION),
+    projectId: z.string().min(1).max(300),
+    importance: unit,
+    confidence: unit,
+    status: MemoryStatusSchema,
+    visibility: MemoryVisibilitySchema.default('project'),
+    tags: z.array(z.string().min(1).max(120)).max(64),
+    source: MemorySourceSchema,
+    createdAt: isoDate,
+    updatedAt: isoDate,
+    recordedAt: isoDate,
+    retractedAt: isoDate.optional(),
+    metadata,
+})
+    .strict();
+export const MemoryEdgeInputSchema = z
+    .object({
+    id: z.string().min(1).max(300).optional(),
+    from: z.string().min(1).max(300),
+    to: z.string().min(1).max(300),
+    relation: MemoryRelationSchema,
+    strength: unit.optional(),
+    confidence: unit.optional(),
+    createdBy: z.string().min(1).max(300).optional(),
+    validFrom: isoDate.optional(),
+    validUntil: isoDate.optional(),
+    metadata: metadata.optional(),
+})
+    .strict();
+export const MemoryEdgeSchema = MemoryEdgeInputSchema.extend({
+    id: z.string().min(1).max(300),
+    strength: unit,
+    confidence: unit,
+    createdAt: isoDate,
+    metadata,
+}).strict();
+//# sourceMappingURL=schemas.js.map

package/dist/memory/schemas.js.map

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

package/dist/memory/scoring.d.ts

@@ -0,0 +1,22 @@
+import type { MemoryCandidate, MemoryNode, RecallResult } from './types.js';
+export interface MemoryScoringWeights {
+    semanticRelevance: number;
+    lexicalRelevance: number;
+    importance: number;
+    confidence: number;
+    recency: number;
+    graphProximity: number;
+    verificationBonus: number;
+}
+export declare const DEFAULT_MEMORY_SCORING_WEIGHTS: Readonly<MemoryScoringWeights>;
+export declare function memoryTokens(text: string): string[];
+export declare function lexicalRelevance(query: string, node: MemoryNode): number;
+export declare function recencyScore(updatedAt: string, now?: number, halfLifeDays?: number): number;
+/** Score one candidate, redistributing unavailable semantic weight. */
+export declare function scoreMemoryCandidate(candidate: MemoryCandidate, query: string, options?: {
+    weights?: Partial<MemoryScoringWeights>;
+    now?: number;
+    recencyHalfLifeDays?: number;
+}): RecallResult;
+export declare function rankMemoryCandidates(candidates: MemoryCandidate[], query: string, options?: Parameters<typeof scoreMemoryCandidate>[2]): RecallResult[];
+//# sourceMappingURL=scoring.d.ts.map

package/dist/memory/scoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../src/memory/scoring.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,YAAY,EAEb,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,8BAA8B,EAAE,QAAQ,CAAC,oBAAoB,CAQzE,CAAC;AAEF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAMnD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CASxE;AAED,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,GAAG,SAAa,EAChB,YAAY,SAAK,GAChB,MAAM,CAKR;AAMD,uEAAuE;AACvE,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACzB,GACL,YAAY,CA0Bd;AAED,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,eAAe,EAAE,EAC7B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC,CAAM,GACvD,YAAY,EAAE,CAIhB"}

package/dist/memory/scoring.js

@@ -0,0 +1,64 @@
+export const DEFAULT_MEMORY_SCORING_WEIGHTS = {
+    semanticRelevance: 0.30,
+    lexicalRelevance: 0.20,
+    importance: 0.15,
+    confidence: 0.10,
+    recency: 0.10,
+    graphProximity: 0.10,
+    verificationBonus: 0.05,
+};
+export function memoryTokens(text) {
+    return text
+        .toLocaleLowerCase()
+        .split(/[^\p{L}\p{N}_-]+/u)
+        .map((token) => token.trim())
+        .filter((token) => token.length >= 2);
+}
+export function lexicalRelevance(query, node) {
+    const queryTokens = new Set(memoryTokens(query));
+    if (queryTokens.size === 0)
+        return 0;
+    const haystack = new Set(memoryTokens(`${node.content} ${node.tags.join(' ')}`));
+    let hits = 0;
+    for (const token of queryTokens) {
+        if (haystack.has(token))
+            hits += 1;
+    }
+    return Math.min(1, hits / Math.max(1, queryTokens.size));
+}
+export function recencyScore(updatedAt, now = Date.now(), halfLifeDays = 30) {
+    const at = Date.parse(updatedAt);
+    if (!Number.isFinite(at))
+        return 0;
+    const ageDays = Math.max(0, now - at) / 86_400_000;
+    return Math.max(0, Math.min(1, Math.pow(0.5, ageDays / halfLifeDays)));
+}
+function verified(node) {
+    return node.source.verificationId || node.metadata.verified === true ? 1 : 0;
+}
+/** Score one candidate, redistributing unavailable semantic weight. */
+export function scoreMemoryCandidate(candidate, query, options = {}) {
+    const node = candidate.node;
+    const signals = {
+        semanticRelevance: Math.max(0, Math.min(1, candidate.semanticRelevance ?? 0)),
+        lexicalRelevance: Math.max(0, Math.min(1, candidate.lexicalRelevance ?? lexicalRelevance(query, node))),
+        importance: node.importance,
+        confidence: node.confidence,
+        recency: recencyScore(node.updatedAt, options.now, options.recencyHalfLifeDays),
+        graphProximity: Math.max(0, Math.min(1, candidate.graphProximity ?? 0)),
+        verificationBonus: verified(node),
+    };
+    const weights = { ...DEFAULT_MEMORY_SCORING_WEIGHTS, ...options.weights };
+    const semanticAvailable = candidate.semanticRelevance !== undefined;
+    const activeEntries = Object.entries(weights).filter(([key]) => semanticAvailable || key !== 'semanticRelevance');
+    const totalWeight = activeEntries.reduce((sum, [, weight]) => sum + Math.max(0, weight), 0);
+    const weighted = activeEntries.reduce((sum, [key, weight]) => sum + signals[key] * Math.max(0, weight), 0);
+    const score = totalWeight > 0 ? weighted / totalWeight : 0;
+    return { node, score: Math.max(0, Math.min(1, score)), signals };
+}
+export function rankMemoryCandidates(candidates, query, options = {}) {
+    return candidates
+        .map((candidate) => scoreMemoryCandidate(candidate, query, options))
+        .sort((a, b) => b.score - a.score || b.node.updatedAt.localeCompare(a.node.updatedAt));
+}
+//# sourceMappingURL=scoring.js.map

package/dist/memory/scoring.js.map

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

package/dist/memory/semantic.d.ts

@@ -0,0 +1,30 @@
+import type { CognitiveMemoryBackend, MemoryCandidate, MemoryEmbeddingProvider, MemoryIndexRequest, MemoryIndexResult, MemoryQuery, MemorySemanticStatus } from './types.js';
+export interface SemanticMemoryControllerOptions {
+    now?: () => Date;
+    lazyIndexLimit?: number;
+    minRelevance?: number;
+    onFailure?: (reason: string) => void;
+}
+/**
+ * Optional semantic orchestration. Persistence and embedding generation stay
+ * behind injected seams, keeping the core dependency-light and lexical-safe.
+ */
+export declare class SemanticMemoryController {
+    private readonly projectId;
+    private readonly backend;
+    private readonly provider;
+    private readonly now;
+    private readonly lazyIndexLimit;
+    private readonly onFailure?;
+    private readonly minRelevance;
+    constructor(projectId: string, backend: CognitiveMemoryBackend, provider: MemoryEmbeddingProvider, options?: SemanticMemoryControllerOptions);
+    get model(): string;
+    get available(): boolean;
+    index(input?: MemoryIndexRequest): Promise<MemoryIndexResult>;
+    search(query: MemoryQuery, text: string): Promise<MemoryCandidate[]>;
+    status(): Promise<MemorySemanticStatus>;
+    private disabled;
+    private interrupted;
+    private degraded;
+}
+//# sourceMappingURL=semantic.d.ts.map

package/dist/memory/semantic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../../src/memory/semantic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,eAAe,EACf,uBAAuB,EAEvB,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAYpB,MAAM,WAAW,+BAA+B;IAC9C,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED;;;GAGG;AACH,qBAAa,wBAAwB;IAOjC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAR3B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAA2B;IACtD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAGnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,sBAAsB,EAC/B,QAAQ,EAAE,uBAAuB,EAClD,OAAO,GAAE,+BAAoC;IAQ/C,IAAI,KAAK,IAAI,MAAM,CAAgC;IAEnD,IAAI,SAAS,IAAI,OAAO,CAMvB;IAEK,KAAK,CAAC,KAAK,GAAE,kBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAqEjE,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAqBpE,MAAM,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAa7C,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,QAAQ;CAajB"}

package/dist/memory/semantic.js

@@ -0,0 +1,180 @@
+function bounded(value, fallback, max) {
+    if (!Number.isFinite(value))
+        return fallback;
+    return Math.max(1, Math.min(Math.floor(value), max));
+}
+function validVector(vector) {
+    return Array.isArray(vector) && vector.length > 0 && vector.length <= 65_536 &&
+        vector.every((value) => typeof value === 'number' && Number.isFinite(value));
+}
+/**
+ * Optional semantic orchestration. Persistence and embedding generation stay
+ * behind injected seams, keeping the core dependency-light and lexical-safe.
+ */
+export class SemanticMemoryController {
+    projectId;
+    backend;
+    provider;
+    now;
+    lazyIndexLimit;
+    onFailure;
+    minRelevance;
+    constructor(projectId, backend, provider, options = {}) {
+        this.projectId = projectId;
+        this.backend = backend;
+        this.provider = provider;
+        this.now = options.now ?? (() => new Date());
+        this.lazyIndexLimit = bounded(options.lazyIndexLimit, 32, 256);
+        this.minRelevance = Math.max(0, Math.min(options.minRelevance ?? 0.15, 1));
+        this.onFailure = options.onFailure;
+    }
+    get model() { return this.provider.model; }
+    get available() {
+        return Boolean(this.backend.listSemanticSources &&
+            this.backend.upsertSemanticEmbeddings &&
+            this.backend.semanticSearch);
+    }
+    async index(input = {}) {
+        if (!this.available)
+            return this.disabled('backend has no semantic index capability');
+        if (input.signal?.aborted)
+            return this.interrupted();
+        const limit = bounded(input.limit, 1_000, 100_000);
+        const batchSize = bounded(input.batchSize, 32, 256);
+        let indexed = 0;
+        let scanned = 0;
+        let cursor;
+        while (scanned < limit) {
+            let sources;
+            try {
+                sources = await this.backend.listSemanticSources(this.projectId, this.model, {
+                    force: input.force,
+                    limit: Math.min(limit - scanned, Math.max(batchSize, 512)),
+                    ...(cursor ? { cursor } : {}),
+                });
+            }
+            catch (error) {
+                return this.degraded(error, scanned, indexed);
+            }
+            if (sources.length === 0)
+                break;
+            scanned += sources.length;
+            cursor = sources.at(-1).node.id;
+            for (let offset = 0; offset < sources.length; offset += batchSize) {
+                if (input.signal?.aborted) {
+                    return {
+                        status: 'degraded', model: this.model, scanned,
+                        indexed, skipped: 0, failed: 0, interrupted: true,
+                    };
+                }
+                const batch = sources.slice(offset, offset + batchSize);
+                let embedded;
+                try {
+                    embedded = await this.provider.embed(batch.map(({ node }) => node.content));
+                }
+                catch (error) {
+                    return this.degraded(error, scanned, indexed, batch.length);
+                }
+                if ('error' in embedded) {
+                    return this.degraded(embedded.error, scanned, indexed, batch.length);
+                }
+                if (embedded.length !== batch.length || !embedded.every(validVector)) {
+                    return this.degraded('embedding provider returned invalid vectors', scanned, indexed, batch.length);
+                }
+                const dimensions = embedded[0].length;
+                if (!embedded.every((vector) => vector.length === dimensions)) {
+                    return this.degraded('embedding dimensions differ within one batch', scanned, indexed, batch.length);
+                }
+                const at = this.now().toISOString();
+                const records = batch.map((source, index) => ({
+                    memoryId: source.node.id,
+                    projectId: this.projectId,
+                    model: this.model,
+                    contentHash: source.contentHash,
+                    vector: embedded[index],
+                    indexedAt: at,
+                }));
+                try {
+                    await this.backend.upsertSemanticEmbeddings(records);
+                }
+                catch (error) {
+                    return this.degraded(error, scanned, indexed, batch.length);
+                }
+                indexed += records.length;
+            }
+        }
+        return {
+            status: 'ready', model: this.model, scanned,
+            indexed, skipped: 0, failed: 0, interrupted: false,
+        };
+    }
+    async search(query, text) {
+        if (!this.available || !text.trim() || query.asOf)
+            return [];
+        // A small synchronous lazy pass makes fresh memories searchable without a
+        // mandatory background daemon. Large rebuilds remain explicit/interruptible.
+        const indexed = await this.index({ limit: this.lazyIndexLimit });
+        if (indexed.status === 'degraded')
+            this.onFailure?.(indexed.error ?? 'semantic indexing degraded');
+        let result;
+        try {
+            result = await this.provider.embed([text]);
+        }
+        catch (error) {
+            this.onFailure?.(String(error));
+            return [];
+        }
+        if ('error' in result) {
+            this.onFailure?.(result.error);
+            return [];
+        }
+        const vector = result[0];
+        if (!validVector(vector)) {
+            this.onFailure?.('invalid semantic query vector');
+            return [];
+        }
+        try {
+            return (await this.backend.semanticSearch(query, vector, this.model))
+                .filter((candidate) => (candidate.semanticRelevance ?? 0) >= this.minRelevance);
+        }
+        catch (error) {
+            this.onFailure?.(error instanceof Error ? error.message : String(error));
+            return [];
+        }
+    }
+    async status() {
+        if (!this.available || !this.backend.semanticStatus) {
+            return { state: 'disabled', model: this.model, indexed: 0, stale: 0 };
+        }
+        try {
+            return await this.backend.semanticStatus(this.projectId, this.model);
+        }
+        catch (error) {
+            return {
+                state: 'degraded', model: this.model, indexed: 0, stale: 0,
+                detail: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    disabled(error) {
+        return {
+            status: 'disabled', model: this.model, scanned: 0, indexed: 0,
+            skipped: 0, failed: 0, interrupted: false, error,
+        };
+    }
+    interrupted() {
+        return {
+            status: 'degraded', model: this.model, scanned: 0, indexed: 0,
+            skipped: 0, failed: 0, interrupted: true,
+        };
+    }
+    degraded(error, scanned = 0, indexed = 0, failed = 0) {
+        const detail = error instanceof Error ? error.message : String(error);
+        this.onFailure?.(detail);
+        return {
+            status: 'degraded', model: this.model, scanned, indexed, skipped: 0,
+            failed, interrupted: false, error: detail,
+        };
+    }
+}
+//# sourceMappingURL=semantic.js.map

package/dist/memory/semantic.js.map

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

package/dist/memory/service.d.ts

@@ -0,0 +1,45 @@
+import type { CognitiveMemoryBackend, ConsolidationRequest, ConsolidationResult, EdgeQuery, LinkMemoryInput, MemoryContext, MemoryContextRequest, MemoryDoctorResult, MemoryEdge, MemoryEventSink, MemoryEmbeddingProvider, MemoryExport, MemoryIndexRequest, MemoryIndexResult, MemoryNode, MemorySanitizer, MemoryService, MemoryStats, MemoryVersion, RecallQuery, RecallResult, RememberInput } from './types.js';
+export declare class MemoryPolicyError extends Error {
+    constructor(message: string);
+}
+export interface DefaultMemoryServiceOptions {
+    sanitizer?: MemorySanitizer;
+    onEvent?: MemoryEventSink;
+    now?: () => Date;
+    defaultContextChars?: number;
+    /** Optional host-owned embedder. Omitting it leaves retrieval lexical. */
+    embeddingProvider?: MemoryEmbeddingProvider;
+    lazySemanticIndexLimit?: number;
+    minSemanticRelevance?: number;
+}
+export declare class DefaultMemoryService implements MemoryService {
+    private readonly backend;
+    readonly projectId: string;
+    private readonly sanitizer;
+    private readonly onEvent?;
+    private readonly now;
+    private readonly defaultContextChars;
+    private readonly semantic?;
+    constructor(projectId: string, backend: CognitiveMemoryBackend, options?: DefaultMemoryServiceOptions);
+    private emit;
+    remember(raw: RememberInput): Promise<MemoryNode>;
+    get(memoryId: string): Promise<MemoryNode | null>;
+    recall(raw: RecallQuery): Promise<RecallResult[]>;
+    connect(raw: LinkMemoryInput): Promise<MemoryEdge>;
+    related(memoryId: string, options?: EdgeQuery): Promise<Array<{
+        edge: MemoryEdge;
+        node: MemoryNode;
+    }>>;
+    history(memoryId: string): Promise<MemoryVersion[]>;
+    getAt(memoryId: string, timestamp: string): Promise<MemoryNode | null>;
+    retract(memoryId: string, reason?: string): Promise<void>;
+    forget(memoryId: string): Promise<boolean>;
+    buildContext(input: MemoryContextRequest): Promise<MemoryContext>;
+    consolidate(input?: ConsolidationRequest): Promise<ConsolidationResult>;
+    index(input?: MemoryIndexRequest): Promise<MemoryIndexResult>;
+    stats(): Promise<MemoryStats>;
+    doctor(): Promise<MemoryDoctorResult>;
+    export(): Promise<MemoryExport>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/memory/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/memory/service.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,SAAS,EACT,eAAe,EAEf,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,EAEV,eAAe,EACf,uBAAuB,EACvB,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,aAAa,EAEb,WAAW,EACX,aAAa,EACb,WAAW,EACX,YAAY,EACZ,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;IAC5C,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AA+BD,qBAAa,oBAAqB,YAAW,aAAa;IAUtD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAT1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAA2B;gBAGnD,SAAS,EAAE,MAAM,EACA,OAAO,EAAE,sBAAsB,EAChD,OAAO,GAAE,2BAAgC;IAkB3C,OAAO,CAAC,IAAI;IAUN,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IAsFjD,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAKjD,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAyEjD,OAAO,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAqClD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC;IAWtG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAInD,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAUtE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzD,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ1C,YAAY,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC;IAoBjE,WAAW,CAAC,KAAK,GAAE,oBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAkF3E,KAAK,CAAC,KAAK,GAAE,kBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAOjE,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;IAiC7B,MAAM,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAqBrC,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;IAyB/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}