@roackb2/heddle 1.5.0 → 1.7.0

package/dist/src/core/memory/validation.js

@@ -1,94 +1,109 @@
 import { readFile, stat } from 'node:fs/promises';
 import { basename, dirname, join, resolve } from 'node:path';
-import { DEFAULT_MEMORY_FOLDER_CATALOG_MAX_BYTES, DEFAULT_MEMORY_ROOT_CATALOG_MAX_BYTES, bootstrapMemoryWorkspace, validateMemoryCatalogShape, } from './catalog.js';
-import { readPendingKnowledgeCandidates } from './maintainer.js';
-import { listMemoryNotePaths } from './visibility.js';
-export async function validateMemoryWorkspace(options) {
-    const memoryRoot = resolve(options.memoryRoot);
-    const issues = [];
-    const shape = validateMemoryCatalogShape({ memoryRoot });
-    for (const path of shape.missing) {
-        issues.push({
-            type: 'missing_catalog',
-            severity: 'error',
-            path,
-            message: `Missing required memory catalog: ${path}`,
-        });
+import { DEFAULT_MEMORY_FOLDER_CATALOG_MAX_BYTES, DEFAULT_MEMORY_ROOT_CATALOG_MAX_BYTES, MemoryCatalogService, } from './catalog.js';
+import { MemoryMaintenanceRepository } from './maintenance-repository.js';
+import { MemoryVisibilityService } from './visibility.js';
+/**
+ * Owns memory workspace health checks and lightweight repair actions.
+ */
+export class MemoryValidationService {
+    memoryRoot;
+    catalog;
+    visibility;
+    maintenance;
+    constructor(memoryRoot, catalog = new MemoryCatalogService(memoryRoot), visibility = new MemoryVisibilityService(memoryRoot), maintenance = new MemoryMaintenanceRepository(memoryRoot)) {
+        this.memoryRoot = memoryRoot;
+        this.catalog = catalog;
+        this.visibility = visibility;
+        this.maintenance = maintenance;
     }
-    const notes = await listMemoryNotePaths({ memoryRoot });
-    await appendOversizedCatalogIssues(memoryRoot, notes, issues);
-    await appendOrphanNoteIssues(memoryRoot, notes, issues);
-    const pending = await readPendingKnowledgeCandidates({ memoryRoot });
-    if (pending.length > 0) {
-        issues.push({
-            type: 'pending_candidates',
-            severity: 'info',
-            count: pending.length,
-            message: `${pending.length} pending memory candidate${pending.length === 1 ? '' : 's'} waiting for maintenance.`,
-        });
-    }
-    return {
-        memoryRoot,
-        ok: issues.every((issue) => issue.severity !== 'error'),
-        issueCount: issues.length,
-        issues,
-    };
-}
-export async function repairMissingMemoryCatalogs(options) {
-    return bootstrapMemoryWorkspace({ memoryRoot: options.memoryRoot });
-}
-async function appendOversizedCatalogIssues(memoryRoot, notes, issues) {
-    for (const path of notes.filter((note) => basename(note).toLowerCase() === 'readme.md')) {
-        const fullPath = join(memoryRoot, path);
-        const info = await stat(fullPath);
-        const maxBytes = path === 'README.md' ? DEFAULT_MEMORY_ROOT_CATALOG_MAX_BYTES : DEFAULT_MEMORY_FOLDER_CATALOG_MAX_BYTES;
-        if (info.size <= maxBytes) {
-            continue;
+    async validate() {
+        const memoryRoot = resolve(this.memoryRoot);
+        const issues = [];
+        const shape = this.catalog.validateShape();
+        for (const path of shape.missing) {
+            issues.push({
+                type: 'missing_catalog',
+                severity: 'error',
+                path,
+                message: `Missing required memory catalog: ${path}`,
+            });
         }
-        issues.push({
-            type: 'oversized_catalog',
-            severity: 'warning',
-            path,
-            sizeBytes: info.size,
-            maxBytes,
-            message: `Memory catalog ${path} is ${info.size} bytes, above the ${maxBytes} byte cap.`,
-        });
+        const notes = await this.visibility.listNotePaths();
+        await this.appendOversizedCatalogIssues(memoryRoot, notes, issues);
+        await this.appendOrphanNoteIssues(memoryRoot, notes, issues);
+        const pending = await this.maintenance.readPendingCandidates();
+        if (pending.length > 0) {
+            issues.push({
+                type: 'pending_candidates',
+                severity: 'info',
+                count: pending.length,
+                message: `${pending.length} pending memory candidate${pending.length === 1 ? '' : 's'} waiting for maintenance.`,
+            });
+        }
+        return {
+            memoryRoot,
+            ok: issues.every((issue) => issue.severity !== 'error'),
+            issueCount: issues.length,
+            issues,
+        };
     }
-}
-async function appendOrphanNoteIssues(memoryRoot, notes, issues) {
-    const catalogPaths = notes.filter((note) => basename(note).toLowerCase() === 'readme.md');
-    const catalogTextByPath = new Map();
-    for (const catalogPath of catalogPaths) {
-        catalogTextByPath.set(catalogPath, await readFile(join(memoryRoot, catalogPath), 'utf8'));
+    repairMissingCatalogs() {
+        return this.catalog.bootstrap();
     }
-    for (const note of notes) {
-        if (basename(note).toLowerCase() === 'readme.md') {
-            continue;
+    async appendOversizedCatalogIssues(memoryRoot, notes, issues) {
+        for (const path of notes.filter((note) => basename(note).toLowerCase() === 'readme.md')) {
+            const fullPath = join(memoryRoot, path);
+            const info = await stat(fullPath);
+            const maxBytes = path === 'README.md' ? DEFAULT_MEMORY_ROOT_CATALOG_MAX_BYTES : DEFAULT_MEMORY_FOLDER_CATALOG_MAX_BYTES;
+            if (info.size <= maxBytes) {
+                continue;
+            }
+            issues.push({
+                type: 'oversized_catalog',
+                severity: 'warning',
+                path,
+                sizeBytes: info.size,
+                maxBytes,
+                message: `Memory catalog ${path} is ${info.size} bytes, above the ${maxBytes} byte cap.`,
+            });
         }
-        const folderCatalog = catalogPathForNote(note);
-        const folderCatalogText = catalogTextByPath.get(folderCatalog) ?? '';
-        const rootCatalogText = catalogTextByPath.get('README.md') ?? '';
-        const localName = basename(note);
-        const linkedFromFolder = folderCatalogText.includes(localName) || folderCatalogText.includes(note);
-        const linkedFromRoot = rootCatalogText.includes(note);
-        if (linkedFromFolder || linkedFromRoot) {
-            continue;
+    }
+    async appendOrphanNoteIssues(memoryRoot, notes, issues) {
+        const catalogPaths = notes.filter((note) => basename(note).toLowerCase() === 'readme.md');
+        const catalogTextByPath = new Map();
+        for (const catalogPath of catalogPaths) {
+            catalogTextByPath.set(catalogPath, await readFile(join(memoryRoot, catalogPath), 'utf8'));
+        }
+        for (const note of notes) {
+            if (basename(note).toLowerCase() === 'readme.md') {
+                continue;
+            }
+            const folderCatalog = MemoryValidationService.catalogPathForNote(note);
+            const folderCatalogText = catalogTextByPath.get(folderCatalog) ?? '';
+            const rootCatalogText = catalogTextByPath.get('README.md') ?? '';
+            const localName = basename(note);
+            const linkedFromFolder = folderCatalogText.includes(localName) || folderCatalogText.includes(note);
+            const linkedFromRoot = rootCatalogText.includes(note);
+            if (linkedFromFolder || linkedFromRoot) {
+                continue;
+            }
+            issues.push({
+                type: 'orphan_note',
+                severity: 'warning',
+                path: note,
+                message: MemoryValidationService.orphanNoteMessage(note, folderCatalog),
+            });
         }
-        issues.push({
-            type: 'orphan_note',
-            severity: 'warning',
-            path: note,
-            message: orphanNoteMessage(note, folderCatalog),
-        });
     }
-}
-function catalogPathForNote(path) {
-    const folder = dirname(path);
-    return folder === '.' ? 'README.md' : join(folder, 'README.md');
-}
-function orphanNoteMessage(note, folderCatalog) {
-    return folderCatalog === 'README.md' ?
-        `Memory note ${note} is not linked from README.md.`
-        : `Memory note ${note} is not linked from ${folderCatalog} or README.md.`;
+    static catalogPathForNote(path) {
+        const folder = dirname(path);
+        return folder === '.' ? 'README.md' : join(folder, 'README.md');
+    }
+    static orphanNoteMessage(note, folderCatalog) {
+        return folderCatalog === 'README.md' ?
+            `Memory note ${note} is not linked from README.md.`
+            : `Memory note ${note} is not linked from ${folderCatalog} or README.md.`;
+    }
 }
 //# sourceMappingURL=validation.js.map

package/dist/src/core/memory/validation.js.map

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

package/dist/src/core/memory/visibility.d.ts

@@ -1,42 +1,20 @@
-import { type KnowledgeMaintenanceRunRecord } from './maintainer.js';
-export type MemoryStatusView = {
-    memoryRoot: string;
-    catalog: {
-        ok: boolean;
-        missing: string[];
-    };
-    notes: {
-        count: number;
-    };
-    candidates: {
-        pending: number;
-    };
-    runs: {
-        latest: KnowledgeMaintenanceRunRecord[];
-    };
-};
-export declare function loadMemoryStatus(options: {
-    memoryRoot: string;
-    recentRunLimit?: number;
-}): Promise<MemoryStatusView>;
-export declare function listMemoryNotePaths(options: {
-    memoryRoot: string;
-    path?: string;
-}): Promise<string[]>;
-export declare function readMemoryNote(options: {
-    memoryRoot: string;
-    path: string;
-    offset?: number;
-    maxLines?: number;
-}): Promise<string>;
-export declare function searchMemoryNotes(options: {
-    memoryRoot: string;
-    query: string;
-    path?: string;
-    maxResults?: number;
-}): Promise<string>;
-export declare function readRecentMemoryMaintenanceRuns(options: {
-    memoryRoot: string;
-    limit?: number;
-}): Promise<KnowledgeMaintenanceRunRecord[]>;
+import { MemoryCatalogService } from './catalog.js';
+import { MemoryMaintenanceRepository } from './maintenance-repository.js';
+import { MemoryNoteService } from './note-service.js';
+import type { MemoryStatusView, ReadMemoryNoteInput, SearchMemoryNotesInput } from './types.js';
+/**
+ * Owns host-facing memory status and note visibility reads.
+ */
+export declare class MemoryVisibilityService {
+    private readonly memoryRoot;
+    private readonly notes;
+    private readonly maintenance;
+    private readonly catalog;
+    constructor(memoryRoot: string, notes?: MemoryNoteService, maintenance?: MemoryMaintenanceRepository, catalog?: MemoryCatalogService);
+    loadStatus(recentRunLimit?: number): Promise<MemoryStatusView>;
+    listNotePaths(path?: string): Promise<string[]>;
+    readNote(input: ReadMemoryNoteInput): Promise<string>;
+    searchNotes(input: SearchMemoryNotesInput): Promise<string>;
+    readRecentMaintenanceRuns(limit?: number): Promise<import("./types.js").KnowledgeMaintenanceRunRecord[]>;
+}
 //# sourceMappingURL=visibility.d.ts.map

package/dist/src/core/memory/visibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"visibility.d.ts","sourceRoot":"","sources":["../../../../src/core/memory/visibility.ts"],"names":[],"mappings":"AAIA,OAAO,EAAkC,KAAK,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAErG,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE;QACP,EAAE,EAAE,OAAO,CAAC;QACZ,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,UAAU,EAAE;QACV,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,IAAI,EAAE;QACJ,MAAM,EAAE,6BAA6B,EAAE,CAAC;KACzC,CAAC;CACH,CAAC;AAEF,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyB5B;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAa3G;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAUlB;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,MAAM,CAAC,CAUlB;AAED,wBAAsB,+BAA+B,CAAC,OAAO,EAAE;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,6BAA6B,EAAE,CAAC,CAc3C"}
+{"version":3,"file":"visibility.d.ts","sourceRoot":"","sources":["../../../../src/core/memory/visibility.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEhG;;GAEG;AACH,qBAAa,uBAAuB;IAEhC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAHP,UAAU,EAAE,MAAM,EAClB,KAAK,oBAAoC,EACzC,WAAW,8BAA8C,EACzD,OAAO,uBAAuC;IAG3D,UAAU,CAAC,cAAc,SAAI,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA0BzD,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAI/C,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAIrD,WAAW,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3D,yBAAyB,CAAC,KAAK,SAAI;CAG1C"}

package/dist/src/core/memory/visibility.js

@@ -1,156 +1,56 @@
-import { access, readdir, readFile } from 'node:fs/promises';
-import { isAbsolute, relative, resolve } from 'node:path';
-import { createReadMemoryNoteTool, createSearchMemoryNotesTool } from '../tools/toolkits/knowledge/memory-notes.js';
-import { validateMemoryCatalogShape } from './catalog.js';
-import { readPendingKnowledgeCandidates } from './maintainer.js';
-export async function loadMemoryStatus(options) {
-    const memoryRoot = resolve(options.memoryRoot);
-    const [notes, pending, latestRuns] = await Promise.all([
-        listMemoryNotePaths({ memoryRoot }),
-        readPendingKnowledgeCandidates({ memoryRoot }),
-        readRecentMemoryMaintenanceRuns({ memoryRoot, limit: options.recentRunLimit ?? 5 }),
-    ]);
-    const catalog = validateMemoryCatalogShape({ memoryRoot });
-    return {
-        memoryRoot,
-        catalog: {
-            ok: catalog.ok,
-            missing: catalog.missing,
-        },
-        notes: {
-            count: notes.length,
-        },
-        candidates: {
-            pending: pending.length,
-        },
-        runs: {
-            latest: latestRuns,
-        },
-    };
-}
-export async function listMemoryNotePaths(options) {
-    const memoryRoot = resolve(options.memoryRoot);
-    const target = resolveMemoryPath(memoryRoot, options.path ?? '.');
-    if (!target.ok) {
-        throw new Error(target.error);
-    }
-    if (!await pathExists(target.path)) {
-        return [];
-    }
-    const notes = await listMarkdownNotes(target.path);
-    return notes.map((path) => toMemoryRelativePath(memoryRoot, path)).sort();
-}
-export async function readMemoryNote(options) {
-    const result = await createReadMemoryNoteTool({ memoryRoot: options.memoryRoot }).execute({
-        path: options.path,
-        offset: options.offset,
-        maxLines: options.maxLines,
-    });
-    if (!result.ok) {
-        throw new Error(result.error);
-    }
-    return typeof result.output === 'string' ? result.output : JSON.stringify(result.output, null, 2);
-}
-export async function searchMemoryNotes(options) {
-    const result = await createSearchMemoryNotesTool({ memoryRoot: options.memoryRoot }).execute({
-        query: options.query,
-        path: options.path,
-        maxResults: options.maxResults,
-    });
-    if (!result.ok) {
-        throw new Error(result.error);
+import { resolve } from 'node:path';
+import { MemoryCatalogService } from './catalog.js';
+import { MemoryMaintenanceRepository } from './maintenance-repository.js';
+import { MemoryNoteService } from './note-service.js';
+/**
+ * Owns host-facing memory status and note visibility reads.
+ */
+export class MemoryVisibilityService {
+    memoryRoot;
+    notes;
+    maintenance;
+    catalog;
+    constructor(memoryRoot, notes = new MemoryNoteService(memoryRoot), maintenance = new MemoryMaintenanceRepository(memoryRoot), catalog = new MemoryCatalogService(memoryRoot)) {
+        this.memoryRoot = memoryRoot;
+        this.notes = notes;
+        this.maintenance = maintenance;
+        this.catalog = catalog;
+    }
+    async loadStatus(recentRunLimit = 5) {
+        const [notes, pending, latestRuns] = await Promise.all([
+            this.notes.list(),
+            this.maintenance.readPendingCandidates(),
+            this.maintenance.readRecentMaintenanceRuns(recentRunLimit),
+        ]);
+        const catalog = this.catalog.validateShape();
+        return {
+            memoryRoot: resolve(this.memoryRoot),
+            catalog: {
+                ok: catalog.ok,
+                missing: catalog.missing,
+            },
+            notes: {
+                count: notes.length,
+            },
+            candidates: {
+                pending: pending.length,
+            },
+            runs: {
+                latest: latestRuns,
+            },
+        };
+    }
+    async listNotePaths(path) {
+        return await this.notes.list({ path });
+    }
+    async readNote(input) {
+        return await this.notes.read(input);
+    }
+    async searchNotes(input) {
+        return await this.notes.search(input);
+    }
+    async readRecentMaintenanceRuns(limit = 5) {
+        return await this.maintenance.readRecentMaintenanceRuns(limit);
     }
-    return typeof result.output === 'string' ? result.output : JSON.stringify(result.output, null, 2);
-}
-export async function readRecentMemoryMaintenanceRuns(options) {
-    const memoryRoot = resolve(options.memoryRoot);
-    const raw = await readTextIfExists(resolve(memoryRoot, '_maintenance', 'runs.jsonl'));
-    if (!raw) {
-        return [];
-    }
-    return raw
-        .split(/\r?\n/u)
-        .filter((line) => line.trim())
-        .map(parseRunRecord)
-        .filter((run) => Boolean(run))
-        .slice(-(options.limit ?? 5))
-        .reverse();
-}
-function resolveMemoryPath(memoryRoot, requestedPath) {
-    if (!requestedPath.trim()) {
-        return { ok: false, error: `Memory note paths must be non-empty and stay inside ${memoryRoot}.` };
-    }
-    const targetPath = resolve(memoryRoot, requestedPath);
-    const rel = relative(memoryRoot, targetPath);
-    if (rel.startsWith('..') || isAbsolute(rel)) {
-        return { ok: false, error: `Memory note paths must stay inside ${memoryRoot}. Refusing to access ${targetPath}.` };
-    }
-    return { ok: true, path: targetPath };
-}
-async function listMarkdownNotes(root) {
-    const entries = await readdir(root, { withFileTypes: true });
-    const results = [];
-    for (const entry of entries) {
-        if (entry.name === '_maintenance') {
-            continue;
-        }
-        const nextPath = resolve(root, entry.name);
-        if (entry.isDirectory()) {
-            results.push(...await listMarkdownNotes(nextPath));
-            continue;
-        }
-        if (entry.isFile() && /\.md$/iu.test(entry.name)) {
-            results.push(nextPath);
-        }
-    }
-    return results;
-}
-async function pathExists(path) {
-    try {
-        await access(path);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-async function readTextIfExists(path) {
-    try {
-        return await readFile(path, 'utf8');
-    }
-    catch (error) {
-        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
-            return undefined;
-        }
-        throw error;
-    }
-}
-function parseRunRecord(line) {
-    try {
-        const parsed = JSON.parse(line);
-        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
-            return undefined;
-        }
-        const record = parsed;
-        return typeof record.id === 'string'
-            && typeof record.startedAt === 'string'
-            && typeof record.finishedAt === 'string'
-            && typeof record.source === 'string'
-            && typeof record.outcome === 'string'
-            && typeof record.summary === 'string'
-            && Array.isArray(record.candidateIds)
-            && Array.isArray(record.processedCandidateIds)
-            && Array.isArray(record.failedCandidateIds)
-            && typeof record.catalogValid === 'boolean'
-            && Array.isArray(record.catalogMissing) ?
-            record
-            : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-function toMemoryRelativePath(memoryRoot, filePath) {
-    return relative(memoryRoot, filePath) || '.';
 }
 //# sourceMappingURL=visibility.js.map

package/dist/src/core/memory/visibility.js.map

@@ -1 +1 @@
-{"version":3,"file":"visibility.js","sourceRoot":"","sources":["../../../../src/core/memory/visibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AACpH,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,8BAA8B,EAAsC,MAAM,iBAAiB,CAAC;AAmBrG,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAGtC;IACC,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACrD,mBAAmB,CAAC,EAAE,UAAU,EAAE,CAAC;QACnC,8BAA8B,CAAC,EAAE,UAAU,EAAE,CAAC;QAC9C,+BAA+B,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,cAAc,IAAI,CAAC,EAAE,CAAC;KACpF,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,0BAA0B,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IAE3D,OAAO;QACL,UAAU;QACV,OAAO,EAAE;YACP,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB;QACD,KAAK,EAAE;YACL,KAAK,EAAE,KAAK,CAAC,MAAM;SACpB;QACD,UAAU,EAAE;YACV,OAAO,EAAE,OAAO,CAAC,MAAM;SACxB;QACD,IAAI,EAAE;YACJ,MAAM,EAAE,UAAU;SACnB;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAA8C;IACtF,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,iBAAiB,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;IAClE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,CAAC,MAAM,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACnD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC5E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAKpC;IACC,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC;QACxF,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACpG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAKvC;IACC,MAAM,MAAM,GAAG,MAAM,2BAA2B,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC;QAC3F,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACpG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,+BAA+B,CAAC,OAGrD;IACC,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,UAAU,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC,CAAC;IACtF,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,GAAG;SACP,KAAK,CAAC,QAAQ,CAAC;SACf,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC7B,GAAG,CAAC,cAAc,CAAC;SACnB,MAAM,CAAC,CAAC,GAAG,EAAwC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;SACnE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;SAC5B,OAAO,EAAE,CAAC;AACf,CAAC;AAED,SAAS,iBAAiB,CAAC,UAAkB,EAAE,aAAqB;IAClE,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC;QAC1B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,uDAAuD,UAAU,GAAG,EAAE,CAAC;IACpG,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IACtD,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC7C,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,sCAAsC,UAAU,wBAAwB,UAAU,GAAG,EAAE,CAAC;IACrH,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AACxC,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,IAAY;IAC3C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAClC,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;YACnD,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACjD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,IAAY;IAC1C,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACzE,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;QAC3C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnE,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,MAAM,GAAG,MAAiC,CAAC;QACjD,OAAO,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ;eAC/B,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;eACpC,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;eACrC,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;eACjC,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;eAClC,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;eAClC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC;eAClC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAAC;eAC3C,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;eACxC,OAAO,MAAM,CAAC,YAAY,KAAK,SAAS;eACxC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;YACvC,MAAuC;YAC3C,CAAC,CAAC,SAAS,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,UAAkB,EAAE,QAAgB;IAChE,OAAO,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,GAAG,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"visibility.js","sourceRoot":"","sources":["../../../../src/core/memory/visibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD;;GAEG;AACH,MAAM,OAAO,uBAAuB;IAEf;IACA;IACA;IACA;IAJnB,YACmB,UAAkB,EAClB,QAAQ,IAAI,iBAAiB,CAAC,UAAU,CAAC,EACzC,cAAc,IAAI,2BAA2B,CAAC,UAAU,CAAC,EACzD,UAAU,IAAI,oBAAoB,CAAC,UAAU,CAAC;QAH9C,eAAU,GAAV,UAAU,CAAQ;QAClB,UAAK,GAAL,KAAK,CAAoC;QACzC,gBAAW,GAAX,WAAW,CAA8C;QACzD,YAAO,GAAP,OAAO,CAAuC;IAC9D,CAAC;IAEJ,KAAK,CAAC,UAAU,CAAC,cAAc,GAAG,CAAC;QACjC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACrD,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;YACjB,IAAI,CAAC,WAAW,CAAC,qBAAqB,EAAE;YACxC,IAAI,CAAC,WAAW,CAAC,yBAAyB,CAAC,cAAc,CAAC;SAC3D,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAE7C,OAAO;YACL,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;YACpC,OAAO,EAAE;gBACP,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,OAAO,EAAE,OAAO,CAAC,OAAO;aACzB;YACD,KAAK,EAAE;gBACL,KAAK,EAAE,KAAK,CAAC,MAAM;aACpB;YACD,UAAU,EAAE;gBACV,OAAO,EAAE,OAAO,CAAC,MAAM;aACxB;YACD,IAAI,EAAE;gBACJ,MAAM,EAAE,UAAU;aACnB;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,IAAa;QAC/B,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAA0B;QACvC,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAA6B;QAC7C,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,yBAAyB,CAAC,KAAK,GAAG,CAAC;QACvC,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACjE,CAAC;CACF"}

package/dist/src/core/observability/activity/conversation-activity-projector.d.ts

@@ -0,0 +1,24 @@
+import type { AgentLoopEvent } from '../../../core/runtime/loop/index.js';
+import type { TraceEvent } from '../../../core/types.js';
+import type { ApplyConversationActivityHandlerArgs, ConversationActivity, ConversationCompactionStatus } from './types.js';
+/**
+ * Projects raw runtime, trace, and compaction events into host-agnostic
+ * conversation activities. Activities retain their source event and only add
+ * derived fields when this boundary performs real semantic work.
+ */
+export declare class ConversationActivityProjector {
+    private static readonly traceProjectors;
+    private static readonly agentLoopProjectors;
+    private static readonly compactionProjectors;
+    static fromTraceEvent(event: TraceEvent): ConversationActivity[];
+    static fromAgentLoopEvent(event: AgentLoopEvent): ConversationActivity[];
+    static fromCompactionStatus(event: ConversationCompactionStatus): ConversationActivity[];
+    static applyHandler<Context, Result = void>(args: ApplyConversationActivityHandlerArgs<Context, Result>): Result | undefined;
+    private static traceActivity;
+    private static agentLoopActivity;
+    private static traceCorrelation;
+    private static agentLoopCorrelation;
+    private static formatCyberLoopMetrics;
+    private static formatMetric;
+}
+//# sourceMappingURL=conversation-activity-projector.d.ts.map

package/dist/src/core/observability/activity/conversation-activity-projector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-activity-projector.d.ts","sourceRoot":"","sources":["../../../../../src/core/observability/activity/conversation-activity-projector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EACV,oCAAoC,EAEpC,oBAAoB,EAGpB,4BAA4B,EAC7B,MAAM,YAAY,CAAC;AAepB;;;;GAIG;AACH,qBAAa,6BAA6B;IACxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAqCrC;IAEF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAczC;IAEF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAI1C;IAEF,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,oBAAoB,EAAE;IAKhE,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,cAAc,GAAG,oBAAoB,EAAE;IAKxE,MAAM,CAAC,oBAAoB,CAAC,KAAK,EAAE,4BAA4B,GAAG,oBAAoB,EAAE;IAKxF,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EACxC,IAAI,EAAE,oCAAoC,CAAC,OAAO,EAAE,MAAM,CAAC,GAC1D,MAAM,GAAG,SAAS;IAKrB,OAAO,CAAC,MAAM,CAAC,aAAa;IAa5B,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAahC,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAW/B,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAWnC,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAyBrC,OAAO,CAAC,MAAM,CAAC,YAAY;CAS5B"}