@roackb2/heddle 1.5.0 → 1.7.0

package/dist/src/core/llm/service.js

@@ -0,0 +1,44 @@
+import { ProviderCredentialRepository, } from '../../core/auth/index.js';
+import { BuiltinLlmProviderRegistry } from './registry/index.js';
+/**
+ * Main LLM application service. It is the public entry point for creating
+ * provider adapters and resolving provider/model ownership.
+ */
+export class LlmAdapterService {
+    static registry = BuiltinLlmProviderRegistry.create();
+    static create(input = {}) {
+        const provider = LlmAdapterService.resolveProvider(input);
+        return LlmAdapterService.registry.createAdapter(LlmAdapterService.withStoredOAuthCredential(input, provider));
+    }
+    static resolveProvider(input = {}) {
+        return LlmAdapterService.registry.resolveProvider(input).provider;
+    }
+    static inferProvider(model) {
+        return LlmAdapterService.registry.inferProvider(model);
+    }
+    static withStoredOAuthCredential(input, provider) {
+        const credentials = input.credentials;
+        if (credentials?.credential || LlmAdapterService.hasApiKey(credentials?.apiKey)) {
+            return input;
+        }
+        const credential = LlmAdapterService.resolveStoredOAuthCredential(provider, credentials?.credentialStorePath);
+        if (!credential) {
+            return input;
+        }
+        return {
+            ...input,
+            credentials: {
+                ...(credentials ?? {}),
+                credential,
+            },
+        };
+    }
+    static resolveStoredOAuthCredential(provider, storePath) {
+        const credential = new ProviderCredentialRepository({ storePath }).get(provider);
+        return credential?.type === 'oauth' ? credential : undefined;
+    }
+    static hasApiKey(value) {
+        return typeof value === 'string' && value.trim().length > 0;
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/src/core/llm/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../../src/core/llm/service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,GAE7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAGjE;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IACpB,MAAM,CAAU,QAAQ,GAAG,0BAA0B,CAAC,MAAM,EAAE,CAAC;IAEvE,MAAM,CAAC,MAAM,CAAC,QAA+B,EAAE;QAC7C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAC1D,OAAO,iBAAiB,CAAC,QAAQ,CAAC,aAAa,CAC7C,iBAAiB,CAAC,yBAAyB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAC7D,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,eAAe,CAAC,QAAoC,EAAE;QAC3D,OAAO,iBAAiB,CAAC,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC;IACpE,CAAC;IAED,MAAM,CAAC,aAAa,CAAC,KAAc;QACjC,OAAO,iBAAiB,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACzD,CAAC;IAEO,MAAM,CAAC,yBAAyB,CAAC,KAA4B,EAAE,QAAqB;QAC1F,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QACtC,IAAI,WAAW,EAAE,UAAU,IAAI,iBAAiB,CAAC,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,CAAC;YAChF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,UAAU,GAAG,iBAAiB,CAAC,4BAA4B,CAAC,QAAQ,EAAE,WAAW,EAAE,mBAAmB,CAAC,CAAC;QAC9G,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO;YACL,GAAG,KAAK;YACR,WAAW,EAAE;gBACX,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;gBACtB,UAAU;aACX;SACF,CAAC;IACJ,CAAC;IAEO,MAAM,CAAC,4BAA4B,CACzC,QAAqB,EACrB,SAAkB;QAElB,MAAM,UAAU,GAAG,IAAI,4BAA4B,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjF,OAAO,UAAU,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/D,CAAC;IAEO,MAAM,CAAC,SAAS,CAAC,KAAyB;QAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9D,CAAC"}

package/dist/src/core/llm/types.d.ts

@@ -1,4 +1,5 @@
 import type { AssistantDiagnostics, ToolCall, ToolDefinition } from '../types.js';
+import type { StoredProviderCredential } from '../../core/auth/index.js';
 export type LlmStreamEvent = {
     type: 'content.delta';
     delta: string;
@@ -12,7 +13,7 @@ export type LlmStreamEvent = {
     type: 'reasoning_summary.done';
     text: string;
 };
-export type LlmProvider = 'openai' | 'anthropic' | 'google';
+export type LlmProvider = 'openai' | 'anthropic' | 'google' | 'ollama' | 'huggingface';
 export type ReasoningEffort = 'low' | 'medium' | 'high' | 'ultrahigh';
 export type LlmAdapterCapabilities = {
     toolCalls: boolean;
@@ -68,4 +69,20 @@ export interface LlmAdapter {
     info?: LlmAdapterInfo;
     chat(messages: ChatMessage[], tools: ToolDefinition[], signal?: AbortSignal, onStreamEvent?: (event: LlmStreamEvent) => void): Promise<LlmResponse>;
 }
+export type LlmCredentialContext = {
+    apiKey?: string;
+    credential?: StoredProviderCredential;
+    credentialStorePath?: string;
+};
+export type LlmRuntimeContext = {
+    reasoningEffort?: ReasoningEffort;
+    fetchImpl?: (url: unknown, init?: unknown) => Promise<globalThis.Response>;
+};
+export type LlmAdapterCreateInput = {
+    provider?: LlmProvider;
+    model?: string;
+    credentials?: LlmCredentialContext;
+    runtime?: LlmRuntimeContext;
+};
+export type LlmProviderResolutionInput = Pick<LlmAdapterCreateInput, 'provider' | 'model'>;
 //# sourceMappingURL=types.d.ts.map

package/dist/src/core/llm/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/llm/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElF,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,yBAAyB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE5D,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAEtE,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,OAAO,CAAC;IACxB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,sBAAsB,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,IAAI,CACF,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,EAAE,cAAc,EAAE,EACvB,MAAM,CAAC,EAAE,WAAW,EACpB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAC9C,OAAO,CAAC,WAAW,CAAC,CAAC;CACzB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/llm/types.ts"],"names":[],"mappings":"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"}

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

@@ -1,46 +1,28 @@
+import type { BootstrapMemoryWorkspaceResult, MemoryCatalogLoadResult, MemoryCatalogShapeValidation, MemoryCategory } from './types.js';
 export declare const DEFAULT_MEMORY_ROOT_CATALOG_MAX_BYTES: number;
 export declare const DEFAULT_MEMORY_ROOT_CATALOG_TARGET_BYTES: number;
 export declare const DEFAULT_MEMORY_FOLDER_CATALOG_MAX_BYTES: number;
 export declare const DEFAULT_MEMORY_FOLDER_CATALOG_TARGET_BYTES: number;
-export type MemoryCategory = {
-    path: string;
-    title: string;
-    purpose: string;
-    readWhen: string;
-};
-export type BootstrapMemoryWorkspaceResult = {
-    memoryRoot: string;
-    createdPaths: string[];
-};
-export type MemoryCatalogLoadResult = {
-    memoryRoot: string;
-    catalogPath: string;
-    exists: boolean;
-    content: string;
-    truncated: boolean;
-    originalBytes: number;
-    maxBytes: number;
-};
-export type MemoryCatalogShapeValidation = {
-    ok: boolean;
-    memoryRoot: string;
-    missing: string[];
-};
 export declare const DEFAULT_MEMORY_CATEGORIES: MemoryCategory[];
-export declare function bootstrapMemoryWorkspace(options: {
-    memoryRoot: string;
-}): BootstrapMemoryWorkspaceResult;
-export declare function loadMemoryRootCatalog(options: {
-    memoryRoot: string;
-    maxBytes?: number;
-}): MemoryCatalogLoadResult;
-export declare function formatMemoryCatalogSystemContext(catalog: MemoryCatalogLoadResult): string;
-export declare function appendMemoryCatalogSystemContext(options: {
-    systemContext?: string;
-    memoryRoot: string;
-    maxBytes?: number;
-}): string;
-export declare function validateMemoryCatalogShape(options: {
-    memoryRoot: string;
-}): MemoryCatalogShapeValidation;
+/**
+ * Owns the cataloged memory workspace shape and the startup memory context.
+ */
+export declare class MemoryCatalogService {
+    private readonly memoryRoot;
+    constructor(memoryRoot: string);
+    bootstrap(): BootstrapMemoryWorkspaceResult;
+    loadRootCatalog(maxBytes?: number): MemoryCatalogLoadResult;
+    formatCatalogSystemContext(catalog: MemoryCatalogLoadResult): string;
+    appendCatalogSystemContext(options: {
+        systemContext?: string;
+        maxBytes?: number;
+    }): string;
+    validateShape(): MemoryCatalogShapeValidation;
+    private resolveRoot;
+    private static missingRootCatalog;
+    private static writeIfMissing;
+    private static createRootCatalogTemplate;
+    private static createFolderCatalogTemplate;
+    private static truncateUtf8;
+}
 //# sourceMappingURL=catalog.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../../src/core/memory/catalog.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,qCAAqC,QAAY,CAAC;AAC/D,eAAO,MAAM,wCAAwC,QAAW,CAAC;AACjE,eAAO,MAAM,uCAAuC,QAAW,CAAC;AAChE,eAAO,MAAM,0CAA0C,QAAW,CAAC;AAEnE,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,cAAc,EA2CrD,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,8BAA8B,CAiBxG;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,uBAAuB,CAgD1B;AAED,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAWzF;AAED,wBAAgB,gCAAgC,CAAC,OAAO,EAAE;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAMT;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,4BAA4B,CAYxG"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../../src/core/memory/catalog.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,8BAA8B,EAC9B,uBAAuB,EACvB,4BAA4B,EAC5B,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,qCAAqC,QAAY,CAAC;AAC/D,eAAO,MAAM,wCAAwC,QAAW,CAAC;AACjE,eAAO,MAAM,uCAAuC,QAAW,CAAC;AAChE,eAAO,MAAM,0CAA0C,QAAW,CAAC;AAEnE,eAAO,MAAM,yBAAyB,EAAE,cAAc,EA2CrD,CAAC;AAEF;;GAEG;AACH,qBAAa,oBAAoB;IACnB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,MAAM;IAE/C,SAAS,IAAI,8BAA8B;IAmB3C,eAAe,CAAC,QAAQ,SAAwC,GAAG,uBAAuB;IAgC1F,0BAA0B,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM;IAapE,0BAA0B,CAAC,OAAO,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAQ1F,aAAa,IAAI,4BAA4B;IAc7C,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAqBjC,OAAO,CAAC,MAAM,CAAC,cAAc;IAU7B,OAAO,CAAC,MAAM,CAAC,yBAAyB;IA2CxC,OAAO,CAAC,MAAM,CAAC,2BAA2B;IA0B1C,OAAO,CAAC,MAAM,CAAC,YAAY;CAY5B"}

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

@@ -49,25 +49,91 @@ export const DEFAULT_MEMORY_CATEGORIES = [
         readWhen: 'Use when current behavior has historical causes or the task resembles a past incident or decision.',
     },
 ];
-export function bootstrapMemoryWorkspace(options) {
-    const memoryRoot = resolve(options.memoryRoot);
-    const createdPaths = [];
-    mkdirSync(memoryRoot, { recursive: true });
-    writeIfMissing(join(memoryRoot, 'README.md'), createRootCatalogTemplate(), createdPaths, memoryRoot);
-    for (const category of DEFAULT_MEMORY_CATEGORIES) {
-        const categoryRoot = join(memoryRoot, category.path);
-        mkdirSync(categoryRoot, { recursive: true });
-        writeIfMissing(join(categoryRoot, 'README.md'), createFolderCatalogTemplate(category), createdPaths, memoryRoot);
+/**
+ * Owns the cataloged memory workspace shape and the startup memory context.
+ */
+export class MemoryCatalogService {
+    memoryRoot;
+    constructor(memoryRoot) {
+        this.memoryRoot = memoryRoot;
     }
-    mkdirSync(join(memoryRoot, '_maintenance'), { recursive: true });
-    writeIfMissing(join(memoryRoot, '_maintenance', 'runs.jsonl'), '', createdPaths, memoryRoot);
-    return { memoryRoot, createdPaths };
-}
-export function loadMemoryRootCatalog(options) {
-    const memoryRoot = resolve(options.memoryRoot);
-    const maxBytes = options.maxBytes ?? DEFAULT_MEMORY_ROOT_CATALOG_MAX_BYTES;
-    const catalogPath = join(memoryRoot, 'README.md');
-    if (!existsSync(catalogPath)) {
+    bootstrap() {
+        const memoryRoot = this.resolveRoot();
+        const createdPaths = [];
+        mkdirSync(memoryRoot, { recursive: true });
+        MemoryCatalogService.writeIfMissing(join(memoryRoot, 'README.md'), MemoryCatalogService.createRootCatalogTemplate(), createdPaths, memoryRoot);
+        for (const category of DEFAULT_MEMORY_CATEGORIES) {
+            const categoryRoot = join(memoryRoot, category.path);
+            mkdirSync(categoryRoot, { recursive: true });
+            MemoryCatalogService.writeIfMissing(join(categoryRoot, 'README.md'), MemoryCatalogService.createFolderCatalogTemplate(category), createdPaths, memoryRoot);
+        }
+        mkdirSync(join(memoryRoot, '_maintenance'), { recursive: true });
+        MemoryCatalogService.writeIfMissing(join(memoryRoot, '_maintenance', 'runs.jsonl'), '', createdPaths, memoryRoot);
+        return { memoryRoot, createdPaths };
+    }
+    loadRootCatalog(maxBytes = DEFAULT_MEMORY_ROOT_CATALOG_MAX_BYTES) {
+        const memoryRoot = this.resolveRoot();
+        const catalogPath = join(memoryRoot, 'README.md');
+        if (!existsSync(catalogPath)) {
+            return MemoryCatalogService.missingRootCatalog(memoryRoot, catalogPath, maxBytes);
+        }
+        const original = readFileSync(catalogPath, 'utf8').trim();
+        const originalBytes = Buffer.byteLength(original, 'utf8');
+        const truncatedContent = MemoryCatalogService.truncateUtf8(original, maxBytes);
+        const truncated = originalBytes > Buffer.byteLength(truncatedContent, 'utf8');
+        const content = truncated ?
+            [
+                truncatedContent,
+                '',
+                `[Memory catalog truncated to ${maxBytes} bytes from ${originalBytes} bytes. Use read_memory_note on README.md for the full catalog.]`,
+            ].join('\n')
+            : original;
+        return {
+            memoryRoot,
+            catalogPath,
+            exists: true,
+            content,
+            truncated,
+            originalBytes,
+            maxBytes,
+        };
+    }
+    formatCatalogSystemContext(catalog) {
+        const header = catalog.exists ? '## Workspace Memory Catalog' : '## Workspace Memory Catalog Missing';
+        return [
+            header,
+            '',
+            `Source: ${catalog.catalogPath}`,
+            '',
+            catalog.content,
+            '',
+            'Startup memory policy: this is the only memory document loaded automatically. Use memory tools to read relevant folder catalogs or notes before relying on deeper memory.',
+        ].join('\n');
+    }
+    appendCatalogSystemContext(options) {
+        const catalog = this.loadRootCatalog(options.maxBytes);
+        const memoryContext = this.formatCatalogSystemContext(catalog);
+        const domainContext = buildMemoryDomainSystemContext();
+        const context = `${domainContext}\n\n${memoryContext}`;
+        return options.systemContext ? `${context}\n\n${options.systemContext}` : context;
+    }
+    validateShape() {
+        const memoryRoot = this.resolveRoot();
+        const requiredPaths = [
+            'README.md',
+            ...DEFAULT_MEMORY_CATEGORIES.map((category) => join(category.path, 'README.md')),
+        ];
+        const missing = requiredPaths.filter((relativePath) => !existsSync(join(memoryRoot, relativePath)));
+        return {
+            ok: missing.length === 0,
+            memoryRoot,
+            missing,
+        };
+    }
+    resolveRoot() {
+        return resolve(this.memoryRoot);
+    }
+    static missingRootCatalog(memoryRoot, catalogPath, maxBytes) {
         const content = [
             'No workspace memory catalog exists yet.',
             '',
@@ -86,145 +152,90 @@ export function loadMemoryRootCatalog(options) {
             maxBytes,
         };
     }
-    const original = readFileSync(catalogPath, 'utf8').trim();
-    const originalBytes = Buffer.byteLength(original, 'utf8');
-    const truncatedContent = truncateUtf8(original, maxBytes);
-    const truncated = originalBytes > Buffer.byteLength(truncatedContent, 'utf8');
-    const content = truncated ?
-        [
-            truncatedContent,
-            '',
-            `[Memory catalog truncated to ${maxBytes} bytes from ${originalBytes} bytes. Use read_memory_note on README.md for the full catalog.]`,
-        ].join('\n')
-        : original;
-    return {
-        memoryRoot,
-        catalogPath,
-        exists: true,
-        content,
-        truncated,
-        originalBytes,
-        maxBytes,
-    };
-}
-export function formatMemoryCatalogSystemContext(catalog) {
-    const header = catalog.exists ? '## Workspace Memory Catalog' : '## Workspace Memory Catalog Missing';
-    return [
-        header,
-        '',
-        `Source: ${catalog.catalogPath}`,
-        '',
-        catalog.content,
-        '',
-        'Startup memory policy: this is the only memory document loaded automatically. Use memory tools to read relevant folder catalogs or notes before relying on deeper memory.',
-    ].join('\n');
-}
-export function appendMemoryCatalogSystemContext(options) {
-    const catalog = loadMemoryRootCatalog({ memoryRoot: options.memoryRoot, maxBytes: options.maxBytes });
-    const memoryContext = formatMemoryCatalogSystemContext(catalog);
-    const domainContext = buildMemoryDomainSystemContext();
-    const context = `${domainContext}\n\n${memoryContext}`;
-    return options.systemContext ? `${context}\n\n${options.systemContext}` : context;
-}
-export function validateMemoryCatalogShape(options) {
-    const memoryRoot = resolve(options.memoryRoot);
-    const requiredPaths = [
-        'README.md',
-        ...DEFAULT_MEMORY_CATEGORIES.map((category) => join(category.path, 'README.md')),
-    ];
-    const missing = requiredPaths.filter((relativePath) => !existsSync(join(memoryRoot, relativePath)));
-    return {
-        ok: missing.length === 0,
-        memoryRoot,
-        missing,
-    };
-}
-function writeIfMissing(path, content, createdPaths, memoryRoot) {
-    if (existsSync(path)) {
-        return;
+    static writeIfMissing(path, content, createdPaths, memoryRoot) {
+        if (existsSync(path)) {
+            return;
+        }
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, content, 'utf8');
+        createdPaths.push(path.slice(memoryRoot.length).replace(/^\/+/, '') || '.');
     }
-    mkdirSync(dirname(path), { recursive: true });
-    writeFileSync(path, content, 'utf8');
-    createdPaths.push(toMemoryRelativePath(memoryRoot, path));
-}
-function createRootCatalogTemplate() {
-    return [
-        '# Workspace Memory',
-        '',
-        'Purpose: durable workspace knowledge that helps future agents become operational quickly.',
-        '',
-        '## Authority And Freshness',
-        '',
-        '- Live workspace evidence wins over memory when they disagree.',
-        '- Current-state notes with recent verification are stronger than older focused notes.',
-        '- Historical notes explain decisions and incidents but may be stale.',
-        '- Important stale, disputed, or superseded facts should be marked rather than silently removed.',
-        '',
-        '## Fast Reading Path',
-        '',
-        '- New non-trivial task: read `current-state/README.md`, then the category that matches the task.',
-        '- Coding or architecture task: read `domain/README.md`, `operations/README.md`, and relevant preferences.',
-        '- Workflow, release, PR, or incident task: read `workflows/README.md`, `operations/README.md`, and relevant history.',
-        '- Coordination-heavy task: read `relationships/README.md`.',
-        '',
-        '## Category Index',
-        '',
-        ...DEFAULT_MEMORY_CATEGORIES.map((category) => `- [${category.title}](${category.path}/README.md): ${category.purpose}`),
-        '',
-        '## High-Value Notes',
-        '',
-        '- Add links here when notes become important enough for every fresh agent to notice.',
-        '',
-        '## Stale Or Disputed Notes',
-        '',
-        '- Add links here when a note should be treated with caution.',
-        '',
-        '## Maintenance Instructions',
-        '',
-        '- Keep this catalog short and navigable.',
-        '- Every folder that contains memory notes needs its own `README.md` catalog.',
-        '- Every durable note should be discoverable through this catalog or a folder catalog.',
-        '- Prefer updating existing notes over scattering small one-off notes.',
-        '- Do not store secrets.',
-        '',
-    ].join('\n');
-}
-function createFolderCatalogTemplate(category) {
-    return [
-        `# ${category.title}`,
-        '',
-        `Purpose: ${category.purpose}`,
-        '',
-        `When to read: ${category.readWhen}`,
-        '',
-        '## Notes Index',
-        '',
-        '- Add note links here as this folder grows.',
-        '',
-        '## Related Folders',
-        '',
-        '- `../README.md`: root memory catalog.',
-        '',
-        '## Maintenance Rules',
-        '',
-        '- Keep this catalog short enough to scan quickly.',
-        '- Add notes only when they preserve durable context for future work.',
-        '- Update this catalog whenever adding, renaming, or retiring notes in this folder.',
-        '- Mark stale, disputed, or superseded knowledge explicitly.',
-        '',
-    ].join('\n');
-}
-function truncateUtf8(value, maxBytes) {
-    if (maxBytes <= 0) {
-        return '';
+    static createRootCatalogTemplate() {
+        return [
+            '# Workspace Memory',
+            '',
+            'Purpose: durable workspace knowledge that helps future agents become operational quickly.',
+            '',
+            '## Authority And Freshness',
+            '',
+            '- Live workspace evidence wins over memory when they disagree.',
+            '- Current-state notes with recent verification are stronger than older focused notes.',
+            '- Historical notes explain decisions and incidents but may be stale.',
+            '- Important stale, disputed, or superseded facts should be marked rather than silently removed.',
+            '',
+            '## Fast Reading Path',
+            '',
+            '- New non-trivial task: read `current-state/README.md`, then the category that matches the task.',
+            '- Coding or architecture task: read `domain/README.md`, `operations/README.md`, and relevant preferences.',
+            '- Workflow, release, PR, or incident task: read `workflows/README.md`, `operations/README.md`, and relevant history.',
+            '- Coordination-heavy task: read `relationships/README.md`.',
+            '',
+            '## Category Index',
+            '',
+            ...DEFAULT_MEMORY_CATEGORIES.map((category) => `- [${category.title}](${category.path}/README.md): ${category.purpose}`),
+            '',
+            '## High-Value Notes',
+            '',
+            '- Add links here when notes become important enough for every fresh agent to notice.',
+            '',
+            '## Stale Or Disputed Notes',
+            '',
+            '- Add links here when a note should be treated with caution.',
+            '',
+            '## Maintenance Instructions',
+            '',
+            '- Keep this catalog short and navigable.',
+            '- Every folder that contains memory notes needs its own `README.md` catalog.',
+            '- Every durable note should be discoverable through this catalog or a folder catalog.',
+            '- Prefer updating existing notes over scattering small one-off notes.',
+            '- Do not store secrets.',
+            '',
+        ].join('\n');
     }
-    const bytes = Buffer.from(value, 'utf8');
-    if (bytes.length <= maxBytes) {
-        return value;
+    static createFolderCatalogTemplate(category) {
+        return [
+            `# ${category.title}`,
+            '',
+            `Purpose: ${category.purpose}`,
+            '',
+            `When to read: ${category.readWhen}`,
+            '',
+            '## Notes Index',
+            '',
+            '- Add note links here as this folder grows.',
+            '',
+            '## Related Folders',
+            '',
+            '- `../README.md`: root memory catalog.',
+            '',
+            '## Maintenance Rules',
+            '',
+            '- Keep this catalog short enough to scan quickly.',
+            '- Add notes only when they preserve durable context for future work.',
+            '- Update this catalog whenever adding, renaming, or retiring a note in this folder.',
+            '- Mark stale, disputed, or superseded knowledge explicitly.',
+            '',
+        ].join('\n');
+    }
+    static truncateUtf8(value, maxBytes) {
+        if (maxBytes <= 0) {
+            return '';
+        }
+        const bytes = Buffer.from(value, 'utf8');
+        if (bytes.length <= maxBytes) {
+            return value;
+        }
+        return bytes.subarray(0, maxBytes).toString('utf8').replace(/\uFFFD+$/u, '').trimEnd();
     }
-    return bytes.subarray(0, maxBytes).toString('utf8').replace(/\uFFFD+$/u, '').trimEnd();
-}
-function toMemoryRelativePath(memoryRoot, path) {
-    return path.slice(memoryRoot.length).replace(/^\/+/, '') || '.';
 }
 //# sourceMappingURL=catalog.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../../src/core/memory/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AAEpE,MAAM,CAAC,MAAM,qCAAqC,GAAG,EAAE,GAAG,IAAI,CAAC;AAC/D,MAAM,CAAC,MAAM,wCAAwC,GAAG,CAAC,GAAG,IAAI,CAAC;AACjE,MAAM,CAAC,MAAM,uCAAuC,GAAG,CAAC,GAAG,IAAI,CAAC;AAChE,MAAM,CAAC,MAAM,0CAA0C,GAAG,CAAC,GAAG,IAAI,CAAC;AA8BnE,MAAM,CAAC,MAAM,yBAAyB,GAAqB;IACzD;QACE,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,eAAe;QACtB,OAAO,EAAE,mFAAmF;QAC5F,QAAQ,EAAE,8EAA8E;KACzF;IACD;QACE,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,WAAW;QAClB,OAAO,EAAE,uFAAuF;QAChG,QAAQ,EAAE,4FAA4F;KACvG;IACD;QACE,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,aAAa;QACpB,OAAO,EAAE,4GAA4G;QACrH,QAAQ,EAAE,mFAAmF;KAC9F;IACD;QACE,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,sFAAsF;QAC/F,QAAQ,EAAE,sFAAsF;KACjG;IACD;QACE,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,YAAY;QACnB,OAAO,EAAE,iHAAiH;QAC1H,QAAQ,EAAE,kGAAkG;KAC7G;IACD;QACE,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,eAAe;QACtB,OAAO,EAAE,6FAA6F;QACtG,QAAQ,EAAE,8FAA8F;KACzG;IACD;QACE,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,kHAAkH;QAC3H,QAAQ,EAAE,oGAAoG;KAC/G;CACF,CAAC;AAEF,MAAM,UAAU,wBAAwB,CAAC,OAA+B;IACtE,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,cAAc,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,yBAAyB,EAAE,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;IAErG,KAAK,MAAM,QAAQ,IAAI,yBAAyB,EAAE,CAAC;QACjD,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QACrD,SAAS,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,cAAc,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,EAAE,2BAA2B,CAAC,QAAQ,CAAC,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;IACnH,CAAC;IAED,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,cAAc,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;IAE7F,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAGrC;IACC,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,qCAAqC,CAAC;IAC3E,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IAElD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG;YACd,yCAAyC;YACzC,EAAE;YACF,0BAA0B,WAAW,EAAE;YACvC,EAAE;YACF,kHAAkH;YAClH,2EAA2E;SAC5E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,OAAO;YACL,UAAU;YACV,WAAW;YACX,MAAM,EAAE,KAAK;YACb,OAAO;YACP,SAAS,EAAE,KAAK;YAChB,aAAa,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC;YACjD,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1D,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC1D,MAAM,gBAAgB,GAAG,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC1D,MAAM,SAAS,GAAG,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IAC9E,MAAM,OAAO,GACX,SAAS,CAAC,CAAC;QACT;YACE,gBAAgB;YAChB,EAAE;YACF,gCAAgC,QAAQ,eAAe,aAAa,kEAAkE;SACvI,CAAC,IAAI,CAAC,IAAI,CAAC;QACd,CAAC,CAAC,QAAQ,CAAC;IAEb,OAAO;QACL,UAAU;QACV,WAAW;QACX,MAAM,EAAE,IAAI;QACZ,OAAO;QACP,SAAS;QACT,aAAa;QACb,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,OAAgC;IAC/E,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,qCAAqC,CAAC;IACtG,OAAO;QACL,MAAM;QACN,EAAE;QACF,WAAW,OAAO,CAAC,WAAW,EAAE;QAChC,EAAE;QACF,OAAO,CAAC,OAAO;QACf,EAAE;QACF,2KAA2K;KAC5K,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,OAIhD;IACC,MAAM,OAAO,GAAG,qBAAqB,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACtG,MAAM,aAAa,GAAG,gCAAgC,CAAC,OAAO,CAAC,CAAC;IAChE,MAAM,aAAa,GAAG,8BAA8B,EAAE,CAAC;IACvD,MAAM,OAAO,GAAG,GAAG,aAAa,OAAO,aAAa,EAAE,CAAC;IACvD,OAAO,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,OAAO,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,OAA+B;IACxE,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,aAAa,GAAG;QACpB,WAAW;QACX,GAAG,yBAAyB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;KACjF,CAAC;IACF,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACpG,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC;QACxB,UAAU;QACV,OAAO;KACR,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,OAAe,EAAE,YAAsB,EAAE,UAAkB;IAC/F,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,OAAO;IACT,CAAC;IAED,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACrC,YAAY,CAAC,IAAI,CAAC,oBAAoB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,yBAAyB;IAChC,OAAO;QACL,oBAAoB;QACpB,EAAE;QACF,2FAA2F;QAC3F,EAAE;QACF,4BAA4B;QAC5B,EAAE;QACF,gEAAgE;QAChE,uFAAuF;QACvF,sEAAsE;QACtE,iGAAiG;QACjG,EAAE;QACF,sBAAsB;QACtB,EAAE;QACF,kGAAkG;QAClG,2GAA2G;QAC3G,sHAAsH;QACtH,4DAA4D;QAC5D,EAAE;QACF,mBAAmB;QACnB,EAAE;QACF,GAAG,yBAAyB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,QAAQ,CAAC,KAAK,KAAK,QAAQ,CAAC,IAAI,gBAAgB,QAAQ,CAAC,OAAO,EAAE,CAAC;QACxH,EAAE;QACF,qBAAqB;QACrB,EAAE;QACF,sFAAsF;QACtF,EAAE;QACF,4BAA4B;QAC5B,EAAE;QACF,8DAA8D;QAC9D,EAAE;QACF,6BAA6B;QAC7B,EAAE;QACF,0CAA0C;QAC1C,8EAA8E;QAC9E,uFAAuF;QACvF,uEAAuE;QACvE,yBAAyB;QACzB,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,2BAA2B,CAAC,QAAwB;IAC3D,OAAO;QACL,KAAK,QAAQ,CAAC,KAAK,EAAE;QACrB,EAAE;QACF,YAAY,QAAQ,CAAC,OAAO,EAAE;QAC9B,EAAE;QACF,iBAAiB,QAAQ,CAAC,QAAQ,EAAE;QACpC,EAAE;QACF,gBAAgB;QAChB,EAAE;QACF,6CAA6C;QAC7C,EAAE;QACF,oBAAoB;QACpB,EAAE;QACF,wCAAwC;QACxC,EAAE;QACF,sBAAsB;QACtB,EAAE;QACF,mDAAmD;QACnD,sEAAsE;QACtE,oFAAoF;QACpF,6DAA6D;QAC7D,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CAAC,KAAa,EAAE,QAAgB;IACnD,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACzC,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;AACzF,CAAC;AAED,SAAS,oBAAoB,CAAC,UAAkB,EAAE,IAAY;IAC5D,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;AAClE,CAAC"}
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../../src/core/memory/catalog.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,14 @@
+export { DEFAULT_MEMORY_CATEGORIES, DEFAULT_MEMORY_FOLDER_CATALOG_MAX_BYTES, DEFAULT_MEMORY_FOLDER_CATALOG_TARGET_BYTES, DEFAULT_MEMORY_ROOT_CATALOG_MAX_BYTES, DEFAULT_MEMORY_ROOT_CATALOG_TARGET_BYTES, MemoryCatalogService, } from './catalog.js';
+export { buildMemoryDomainSystemContext } from './domain-prompt.js';
+export { MemoryMaintenanceRepository } from './maintenance-repository.js';
+export { MemoryMaintainerPrompt } from './maintainer-prompt.js';
+export { MemoryMaintenanceService } from './maintainer.js';
+export { MemoryMaintenanceIntegrationService } from './maintenance-integration.js';
+export { createMemoryMaintainerTools } from './maintainer-tools.js';
+export { MemoryNoteService } from './note-service.js';
+export { MemorySchemas } from './schemas.js';
+export { createMemoryNoteTemplate, slugifyMemoryTitle } from './templates.js';
+export { MemoryValidationService } from './validation.js';
+export { MemoryVisibilityService } from './visibility.js';
+export type { BootstrapMemoryWorkspaceResult, KnowledgeCandidate, KnowledgeCandidateStatusRecord, KnowledgeMaintenanceRunRecord, ListMemoryNotesInput, MemoryCatalogLoadResult, MemoryCatalogShapeValidation, MemoryCategory, MemoryMaintenanceLockRecord, MemoryStatusView, MemoryValidationIssue, MemoryValidationResult, ReadMemoryNoteInput, RunKnowledgeMaintenanceOptions, RunKnowledgeMaintenanceResult, RunMaintenanceForRecordedCandidatesOptions, RunMaintenanceForRecordedCandidatesResult, SearchMemoryNotesInput, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,uCAAuC,EACvC,0CAA0C,EAC1C,qCAAqC,EACrC,wCAAwC,EACxC,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,mCAAmC,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,YAAY,EACV,8BAA8B,EAC9B,kBAAkB,EAClB,8BAA8B,EAC9B,6BAA6B,EAC7B,oBAAoB,EACpB,uBAAuB,EACvB,4BAA4B,EAC5B,cAAc,EACd,2BAA2B,EAC3B,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,8BAA8B,EAC9B,6BAA6B,EAC7B,0CAA0C,EAC1C,yCAAyC,EACzC,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,13 @@
+export { DEFAULT_MEMORY_CATEGORIES, DEFAULT_MEMORY_FOLDER_CATALOG_MAX_BYTES, DEFAULT_MEMORY_FOLDER_CATALOG_TARGET_BYTES, DEFAULT_MEMORY_ROOT_CATALOG_MAX_BYTES, DEFAULT_MEMORY_ROOT_CATALOG_TARGET_BYTES, MemoryCatalogService, } from './catalog.js';
+export { buildMemoryDomainSystemContext } from './domain-prompt.js';
+export { MemoryMaintenanceRepository } from './maintenance-repository.js';
+export { MemoryMaintainerPrompt } from './maintainer-prompt.js';
+export { MemoryMaintenanceService } from './maintainer.js';
+export { MemoryMaintenanceIntegrationService } from './maintenance-integration.js';
+export { createMemoryMaintainerTools } from './maintainer-tools.js';
+export { MemoryNoteService } from './note-service.js';
+export { MemorySchemas } from './schemas.js';
+export { createMemoryNoteTemplate, slugifyMemoryTitle } from './templates.js';
+export { MemoryValidationService } from './validation.js';
+export { MemoryVisibilityService } from './visibility.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,uCAAuC,EACvC,0CAA0C,EAC1C,qCAAqC,EACrC,wCAAwC,EACxC,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,mCAAmC,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/src/core/memory/maintainer-prompt.d.ts

@@ -0,0 +1,14 @@
+import type { KnowledgeCandidate } from './types.js';
+/**
+ * Owns the memory maintainer prompt text.
+ *
+ * Keep static instructions before dynamic catalog/candidate content so model
+ * providers can reuse token cache across maintenance runs.
+ */
+export declare class MemoryMaintainerPrompt {
+    private static readonly staticSystemContext;
+    static buildSystemContext(rootCatalog: string): string;
+    static buildMaintenanceGoal(observations: KnowledgeCandidate[]): string;
+    private static formatCandidates;
+}
+//# sourceMappingURL=maintainer-prompt.d.ts.map

package/dist/src/core/memory/maintainer-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintainer-prompt.d.ts","sourceRoot":"","sources":["../../../../src/core/memory/maintainer-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;;;;GAKG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAcgC;IAE3E,MAAM,CAAC,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAQtD,MAAM,CAAC,oBAAoB,CAAC,YAAY,EAAE,kBAAkB,EAAE,GAAG,MAAM;IAUvE,OAAO,CAAC,MAAM,CAAC,gBAAgB;CAmBhC"}