@roackb2/heddle 1.5.0 → 1.7.0

package/dist/src/core/memory/maintenance-integration.js

@@ -1,189 +1,184 @@
-import { mkdir, open, readFile, rm } from 'node:fs/promises';
-import { dirname, join, resolve } from 'node:path';
-import { readPendingKnowledgeCandidates, runKnowledgeMaintenance, } from './maintainer.js';
+import { mkdir } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { MemoryMaintenanceRepository } from './maintenance-repository.js';
+import { MemoryMaintenanceService } from './maintainer.js';
 const DEFAULT_LOCK_STALE_AFTER_MS = 10 * 60 * 1000;
 const DEFAULT_LOCK_POLL_MS = 250;
 const DEFAULT_LOCK_TIMEOUT_MS = 30 * 1000;
 const maintenanceQueues = new Map();
-export async function runMaintenanceForRecordedCandidates(options) {
-    return await enqueueMaintenance(options.memoryRoot, () => runMaintenanceForRecordedCandidatesNow(options));
-}
-async function runMaintenanceForRecordedCandidatesNow(options) {
-    const candidateIds = [...new Set(options.trace
-            .filter((event) => event.type === 'memory.candidate_recorded')
-            .map((event) => event.candidateId))];
-    if (candidateIds.length === 0) {
-        return { candidateIds, events: [] };
+/**
+ * Bridges turn traces into serialized memory maintenance runs.
+ */
+export class MemoryMaintenanceIntegrationService {
+    memoryRoot;
+    repository;
+    maintenance;
+    constructor(memoryRoot, repository = new MemoryMaintenanceRepository(memoryRoot), maintenance = new MemoryMaintenanceService(memoryRoot, repository)) {
+        this.memoryRoot = memoryRoot;
+        this.repository = repository;
+        this.maintenance = maintenance;
     }
-    const pending = await readPendingKnowledgeCandidates({ memoryRoot: options.memoryRoot });
-    const observations = pending.filter((candidate) => candidateIds.includes(candidate.id));
-    if (observations.length === 0) {
-        return { candidateIds, events: [] };
+    async runForRecordedCandidates(options) {
+        return await this.enqueue(() => this.runNow(options));
     }
-    const runId = `memory-run-${Date.now()}`;
-    const started = createEvent({
-        type: 'memory.maintenance_started',
-        runId,
-        candidateIds: observations.map((candidate) => candidate.id),
-        step: nextMemoryStep(options.trace),
-    });
-    options.onTraceEvent?.(started);
-    let lock;
-    try {
-        lock = await acquireMemoryMaintenanceLock({
-            memoryRoot: options.memoryRoot,
-            staleAfterMs: options.lockStaleAfterMs,
-            timeoutMs: options.lockTimeoutMs,
-        });
-        const maintenance = await runKnowledgeMaintenance({
-            memoryRoot: options.memoryRoot,
-            observations,
-            llm: options.llm,
-            source: options.source,
-            maxSteps: options.maxSteps,
-            nextRunId: () => runId,
-        });
-        if (maintenance.run.outcome === 'error' || maintenance.run.outcome === 'max_steps' || maintenance.run.outcome === 'interrupted') {
-            const failed = createEvent({
-                type: 'memory.maintenance_failed',
-                runId: maintenance.run.id,
-                error: maintenance.run.summary,
-                candidateIds: observations.map((candidate) => candidate.id),
-                step: nextMemoryStep(options.trace),
-            });
-            options.onTraceEvent?.(failed);
-            return { candidateIds, maintenance, events: [started, failed] };
+    async runNow(options) {
+        const candidateIds = MemoryMaintenanceIntegrationService.candidateIdsFromTrace(options.trace);
+        if (candidateIds.length === 0) {
+            return { candidateIds, events: [] };
         }
-        const finished = createEvent({
-            type: 'memory.maintenance_finished',
-            runId: maintenance.run.id,
-            outcome: maintenance.run.outcome,
-            summary: maintenance.run.summary,
-            processedCandidateIds: maintenance.run.processedCandidateIds,
-            failedCandidateIds: maintenance.run.failedCandidateIds,
-            step: nextMemoryStep(options.trace),
-        });
-        options.onTraceEvent?.(finished);
-        return { candidateIds, maintenance, events: [started, finished] };
-    }
-    catch (error) {
-        const failed = createEvent({
-            type: 'memory.maintenance_failed',
+        const pending = await this.repository.readPendingCandidates();
+        const observations = pending.filter((candidate) => candidateIds.includes(candidate.id));
+        if (observations.length === 0) {
+            return { candidateIds, events: [] };
+        }
+        const runId = `memory-run-${Date.now()}`;
+        const started = MemoryMaintenanceIntegrationService.createEvent({
+            type: 'memory.maintenance_started',
             runId,
-            error: error instanceof Error ? error.message : String(error),
             candidateIds: observations.map((candidate) => candidate.id),
-            step: nextMemoryStep(options.trace),
+            step: MemoryMaintenanceIntegrationService.nextMemoryStep(options.trace),
         });
-        options.onTraceEvent?.(failed);
-        return { candidateIds, events: [started, failed] };
-    }
-    finally {
-        await lock?.release();
-    }
-}
-async function acquireMemoryMaintenanceLock(options) {
-    const memoryRoot = resolve(options.memoryRoot);
-    const lockPath = join(memoryRoot, '_maintenance', 'maintenance.lock');
-    const lockId = `${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}`;
-    const startedAt = Date.now();
-    const timeoutMs = options.timeoutMs ?? DEFAULT_LOCK_TIMEOUT_MS;
-    const staleAfterMs = options.staleAfterMs ?? DEFAULT_LOCK_STALE_AFTER_MS;
-    await mkdir(dirname(lockPath), { recursive: true });
-    while (true) {
+        options.onTraceEvent?.(started);
+        let lock;
         try {
-            const handle = await open(lockPath, 'wx');
-            await handle.writeFile(JSON.stringify({
-                id: lockId,
-                pid: process.pid,
-                acquiredAt: new Date().toISOString(),
-            }) + '\n', 'utf8');
-            await handle.close();
-            return {
-                async release() {
-                    await releaseMemoryMaintenanceLock(lockPath, lockId);
-                },
-            };
+            lock = await this.acquireLock({
+                staleAfterMs: options.lockStaleAfterMs,
+                timeoutMs: options.lockTimeoutMs,
+            });
+            const maintenance = await this.maintenance.run({
+                observations,
+                llm: options.llm,
+                source: options.source,
+                maxSteps: options.maxSteps,
+                nextRunId: () => runId,
+            });
+            if (maintenance.run.outcome === 'error' || maintenance.run.outcome === 'max_steps' || maintenance.run.outcome === 'interrupted') {
+                const failed = MemoryMaintenanceIntegrationService.createEvent({
+                    type: 'memory.maintenance_failed',
+                    runId: maintenance.run.id,
+                    error: maintenance.run.summary,
+                    candidateIds: observations.map((candidate) => candidate.id),
+                    step: MemoryMaintenanceIntegrationService.nextMemoryStep(options.trace),
+                });
+                options.onTraceEvent?.(failed);
+                return { candidateIds, maintenance, events: [started, failed] };
+            }
+            const finished = MemoryMaintenanceIntegrationService.createEvent({
+                type: 'memory.maintenance_finished',
+                runId: maintenance.run.id,
+                outcome: maintenance.run.outcome,
+                summary: maintenance.run.summary,
+                processedCandidateIds: maintenance.run.processedCandidateIds,
+                failedCandidateIds: maintenance.run.failedCandidateIds,
+                step: MemoryMaintenanceIntegrationService.nextMemoryStep(options.trace),
+            });
+            options.onTraceEvent?.(finished);
+            return { candidateIds, maintenance, events: [started, finished] };
         }
         catch (error) {
-            if (!(error instanceof Error) || !('code' in error) || error.code !== 'EEXIST') {
-                throw error;
-            }
-            if (await removeStaleMemoryMaintenanceLock(lockPath, staleAfterMs)) {
-                continue;
+            const failed = MemoryMaintenanceIntegrationService.createEvent({
+                type: 'memory.maintenance_failed',
+                runId,
+                error: error instanceof Error ? error.message : String(error),
+                candidateIds: observations.map((candidate) => candidate.id),
+                step: MemoryMaintenanceIntegrationService.nextMemoryStep(options.trace),
+            });
+            options.onTraceEvent?.(failed);
+            return { candidateIds, events: [started, failed] };
+        }
+        finally {
+            await lock?.release();
+        }
+    }
+    async acquireLock(options) {
+        const lockPath = this.repository.maintenanceLockPath();
+        const lockId = `${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+        const startedAt = Date.now();
+        const timeoutMs = options.timeoutMs ?? DEFAULT_LOCK_TIMEOUT_MS;
+        const staleAfterMs = options.staleAfterMs ?? DEFAULT_LOCK_STALE_AFTER_MS;
+        await mkdir(dirname(lockPath), { recursive: true });
+        while (true) {
+            try {
+                await this.repository.writeLock(lockPath, {
+                    id: lockId,
+                    pid: process.pid,
+                    acquiredAt: new Date().toISOString(),
+                });
+                return {
+                    release: async () => {
+                        await this.releaseLock(lockPath, lockId);
+                    },
+                };
             }
-            if (Date.now() - startedAt >= timeoutMs) {
-                throw new Error(`Memory maintenance lock is busy: ${lockPath}`, { cause: error });
+            catch (error) {
+                if (!(error instanceof Error) || !('code' in error) || error.code !== 'EEXIST') {
+                    throw error;
+                }
+                if (await this.removeStaleLock(lockPath, staleAfterMs)) {
+                    continue;
+                }
+                if (Date.now() - startedAt >= timeoutMs) {
+                    throw new Error(`Memory maintenance lock is busy: ${lockPath}`, { cause: error });
+                }
+                await MemoryMaintenanceIntegrationService.sleep(DEFAULT_LOCK_POLL_MS);
             }
-            await sleep(DEFAULT_LOCK_POLL_MS);
         }
     }
-}
-async function releaseMemoryMaintenanceLock(lockPath, lockId) {
-    const current = await readMemoryMaintenanceLock(lockPath);
-    if (current?.id !== lockId) {
-        return;
-    }
-    await rm(lockPath, { force: true });
-}
-async function removeStaleMemoryMaintenanceLock(lockPath, staleAfterMs) {
-    const current = await readMemoryMaintenanceLock(lockPath);
-    if (!current) {
-        return false;
-    }
-    const acquiredAt = Date.parse(current.acquiredAt);
-    if (!Number.isFinite(acquiredAt) || Date.now() - acquiredAt < staleAfterMs) {
-        return false;
+    async releaseLock(lockPath, lockId) {
+        const current = await this.repository.readLock(lockPath);
+        if (current?.id !== lockId) {
+            return;
+        }
+        await this.repository.removeLock(lockPath);
     }
-    await rm(lockPath, { force: true });
-    return true;
-}
-async function readMemoryMaintenanceLock(lockPath) {
-    try {
-        const parsed = JSON.parse(await readFile(lockPath, 'utf8'));
-        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
-            return undefined;
+    async removeStaleLock(lockPath, staleAfterMs) {
+        const current = await this.repository.readLock(lockPath);
+        if (!current) {
+            return false;
+        }
+        const acquiredAt = Date.parse(current.acquiredAt);
+        if (!Number.isFinite(acquiredAt) || Date.now() - acquiredAt < staleAfterMs) {
+            return false;
         }
-        const candidate = parsed;
-        return typeof candidate.id === 'string' && typeof candidate.acquiredAt === 'string' ?
-            { id: candidate.id, acquiredAt: candidate.acquiredAt }
-            : undefined;
+        await this.repository.removeLock(lockPath);
+        return true;
     }
-    catch (error) {
-        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
-            return undefined;
+    async enqueue(run) {
+        const memoryRoot = resolve(this.memoryRoot);
+        const previous = maintenanceQueues.get(memoryRoot) ?? Promise.resolve();
+        let release;
+        const current = new Promise((resolvePromise) => {
+            release = resolvePromise;
+        });
+        const queued = previous.then(() => current, () => current);
+        maintenanceQueues.set(memoryRoot, queued);
+        await previous.catch(() => undefined);
+        try {
+            return await run();
+        }
+        finally {
+            release();
+            if (maintenanceQueues.get(memoryRoot) === queued) {
+                maintenanceQueues.delete(memoryRoot);
+            }
         }
-        return undefined;
     }
-}
-async function sleep(ms) {
-    await new Promise((resolve) => setTimeout(resolve, ms));
-}
-async function enqueueMaintenance(memoryRoot, run) {
-    const previous = maintenanceQueues.get(memoryRoot) ?? Promise.resolve();
-    let release;
-    const current = new Promise((resolve) => {
-        release = resolve;
-    });
-    const queued = previous.then(() => current, () => current);
-    maintenanceQueues.set(memoryRoot, queued);
-    await previous.catch(() => undefined);
-    try {
-        return await run();
+    static candidateIdsFromTrace(trace) {
+        return [...new Set(trace
+                .filter((event) => event.type === 'memory.candidate_recorded')
+                .map((event) => event.candidateId))];
     }
-    finally {
-        release();
-        if (maintenanceQueues.get(memoryRoot) === queued) {
-            maintenanceQueues.delete(memoryRoot);
-        }
+    static createEvent(event) {
+        return {
+            ...event,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    static nextMemoryStep(trace) {
+        return trace.reduce((max, event) => 'step' in event ? Math.max(max, event.step) : max, 0) + 1;
+    }
+    static async sleep(ms) {
+        await new Promise((resolvePromise) => setTimeout(resolvePromise, ms));
     }
-}
-function createEvent(event) {
-    return {
-        ...event,
-        timestamp: new Date().toISOString(),
-    };
-}
-function nextMemoryStep(trace) {
-    return trace.reduce((max, event) => 'step' in event ? Math.max(max, event.step) : max, 0) + 1;
 }
 //# sourceMappingURL=maintenance-integration.js.map

package/dist/src/core/memory/maintenance-integration.js.map

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

package/dist/src/core/memory/maintenance-repository.d.ts

@@ -0,0 +1,27 @@
+import type { KnowledgeCandidate, KnowledgeMaintenanceRunRecord, MemoryMaintenanceLockRecord } from './types.js';
+/**
+ * Owns memory maintenance JSONL files and lock-file persistence.
+ */
+export declare class MemoryMaintenanceRepository {
+    private readonly memoryRoot;
+    constructor(memoryRoot: string);
+    readPendingCandidates(): Promise<KnowledgeCandidate[]>;
+    appendCandidate(candidate: KnowledgeCandidate): Promise<void>;
+    appendCandidateStatusEvents(candidateIds: string[], runId: string, now: () => Date): Promise<void>;
+    appendMaintenanceRun(run: KnowledgeMaintenanceRunRecord): Promise<void>;
+    readRecentMaintenanceRuns(limit?: number): Promise<KnowledgeMaintenanceRunRecord[]>;
+    writeLock(lockPath: string, record: MemoryMaintenanceLockRecord): Promise<void>;
+    readLock(lockPath: string): Promise<MemoryMaintenanceLockRecord | undefined>;
+    removeLock(lockPath: string): Promise<void>;
+    maintenanceLockPath(): string;
+    private readCandidateLogEntries;
+    private candidatesPath;
+    private runsPath;
+    private appendJsonLine;
+    private appendJsonLines;
+    private readJsonlLines;
+    private parseCandidateLogEntry;
+    private parseMaintenanceRun;
+    private resolveRoot;
+}
+//# sourceMappingURL=maintenance-repository.d.ts.map

package/dist/src/core/memory/maintenance-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintenance-repository.d.ts","sourceRoot":"","sources":["../../../../src/core/memory/maintenance-repository.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,kBAAkB,EAElB,6BAA6B,EAC7B,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,2BAA2B;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,MAAM;IAEzC,qBAAqB,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAgBtD,eAAe,CAAC,SAAS,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D,2BAA2B,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAalG,oBAAoB,CAAC,GAAG,EAAE,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE,yBAAyB,CAAC,KAAK,SAAI,GAAG,OAAO,CAAC,6BAA6B,EAAE,CAAC;IAS9E,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/E,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,GAAG,SAAS,CAAC;IAa5E,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,mBAAmB,IAAI,MAAM;YAIf,uBAAuB;IAOrC,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,QAAQ;YAIF,cAAc;YAId,eAAe;YAKf,cAAc;IAY5B,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,WAAW;CAGpB"}

package/dist/src/core/memory/maintenance-repository.js

@@ -0,0 +1,134 @@
+import { appendFile, mkdir, open, readFile, rm } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
+import { MemorySchemas } from './schemas.js';
+/**
+ * Owns memory maintenance JSONL files and lock-file persistence.
+ */
+export class MemoryMaintenanceRepository {
+    memoryRoot;
+    constructor(memoryRoot) {
+        this.memoryRoot = memoryRoot;
+    }
+    async readPendingCandidates() {
+        const entries = await this.readCandidateLogEntries();
+        const processed = new Set();
+        const pending = [];
+        for (const entry of entries) {
+            if ('kind' in entry) {
+                processed.add(entry.candidateId);
+                continue;
+            }
+            pending.push(entry);
+        }
+        return pending.filter((candidate) => !processed.has(candidate.id));
+    }
+    async appendCandidate(candidate) {
+        await this.appendJsonLine(this.candidatesPath(), candidate);
+    }
+    async appendCandidateStatusEvents(candidateIds, runId, now) {
+        const recordedAt = now().toISOString();
+        const records = candidateIds.map((candidateId) => ({
+            kind: 'candidate_status',
+            candidateId,
+            status: 'processed',
+            runId,
+            recordedAt,
+        }));
+        await this.appendJsonLines(this.candidatesPath(), records);
+    }
+    async appendMaintenanceRun(run) {
+        await this.appendJsonLine(this.runsPath(), run);
+    }
+    async readRecentMaintenanceRuns(limit = 5) {
+        const lines = await this.readJsonlLines(this.runsPath());
+        return lines
+            .map((line) => this.parseMaintenanceRun(line))
+            .filter((run) => Boolean(run))
+            .slice(-limit)
+            .reverse();
+    }
+    async writeLock(lockPath, record) {
+        await mkdir(dirname(lockPath), { recursive: true });
+        const handle = await open(lockPath, 'wx');
+        try {
+            await handle.writeFile(`${JSON.stringify(record)}\n`, 'utf8');
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    async readLock(lockPath) {
+        try {
+            const parsed = JSON.parse(await readFile(lockPath, 'utf8'));
+            const result = MemorySchemas.parseMaintenanceLock(parsed);
+            return result.success ? result.data : undefined;
+        }
+        catch (error) {
+            if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+                return undefined;
+            }
+            return undefined;
+        }
+    }
+    async removeLock(lockPath) {
+        await rm(lockPath, { force: true });
+    }
+    maintenanceLockPath() {
+        return join(this.resolveRoot(), '_maintenance', 'maintenance.lock');
+    }
+    async readCandidateLogEntries() {
+        const lines = await this.readJsonlLines(this.candidatesPath());
+        return lines
+            .map((line) => this.parseCandidateLogEntry(line))
+            .filter((entry) => Boolean(entry));
+    }
+    candidatesPath() {
+        return join(this.resolveRoot(), '_maintenance', 'candidates.jsonl');
+    }
+    runsPath() {
+        return join(this.resolveRoot(), '_maintenance', 'runs.jsonl');
+    }
+    async appendJsonLine(path, record) {
+        await this.appendJsonLines(path, [record]);
+    }
+    async appendJsonLines(path, records) {
+        await mkdir(dirname(path), { recursive: true });
+        await appendFile(path, `${records.map((record) => JSON.stringify(record)).join('\n')}\n`, 'utf8');
+    }
+    async readJsonlLines(path) {
+        try {
+            const raw = await readFile(path, 'utf8');
+            return raw.split(/\r?\n/u).filter((line) => line.trim());
+        }
+        catch (error) {
+            if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+                return [];
+            }
+            throw error;
+        }
+    }
+    parseCandidateLogEntry(line) {
+        try {
+            const parsed = JSON.parse(line);
+            const result = MemorySchemas.parseCandidateLogEntry(parsed);
+            return result.success ? result.data : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    parseMaintenanceRun(line) {
+        try {
+            const parsed = JSON.parse(line);
+            const result = MemorySchemas.parseMaintenanceRun(parsed);
+            return result.success ? result.data : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    resolveRoot() {
+        return resolve(this.memoryRoot);
+    }
+}
+//# sourceMappingURL=maintenance-repository.js.map

package/dist/src/core/memory/maintenance-repository.js.map

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

package/dist/src/core/memory/note-service.d.ts

@@ -0,0 +1,23 @@
+import type { ToolResult } from '../../core/types.js';
+import type { ListMemoryNotesInput, ReadMemoryNoteInput, SearchMemoryNotesInput } from './types.js';
+/**
+ * Owns note-level memory reads, search, listing, and scoped note edits.
+ */
+export declare class MemoryNoteService {
+    private readonly memoryRoot;
+    constructor(memoryRoot: string);
+    list(input?: ListMemoryNotesInput): Promise<string[]>;
+    read(input: ReadMemoryNoteInput): Promise<string>;
+    search(input: SearchMemoryNotesInput): Promise<string>;
+    edit(raw: unknown): Promise<ToolResult>;
+    private resolvePath;
+    private listMarkdownNotes;
+    private searchWithCli;
+    private resolveRoot;
+    private static pageText;
+    private static sanitizeMaxResults;
+    private static isMarkdownPath;
+    private static trimSearchOutput;
+    private static runSearchCommand;
+}
+//# sourceMappingURL=note-service.d.ts.map

package/dist/src/core/memory/note-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"note-service.d.ts","sourceRoot":"","sources":["../../../../src/core/memory/note-service.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAIpG;;GAEG;AACH,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,MAAM;IAEzC,IAAI,CAAC,KAAK,GAAE,oBAAyB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAezD,IAAI,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAYjD,MAAM,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC;IAStD,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAW7C,OAAO,CAAC,WAAW;YAQL,iBAAiB;YAsBjB,aAAa;IA8B3B,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,MAAM,CAAC,QAAQ;IAOvB,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAQjC,OAAO,CAAC,MAAM,CAAC,cAAc;IAI7B,OAAO,CAAC,MAAM,CAAC,gBAAgB;mBASV,gBAAgB;CAgDtC"}