@felan-ai/ext-memory 0.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Felan contributors
+Copyright (c) 2026 Milko Slavov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,7 @@
+@felan-ai/ext-memory
+
+The Markdown memory schema and dreaming policy were adapted from Felan's
+filesystem-memory implementation and local-first memory architecture.
+
+The package otherwise contains original Felan project code and is distributed
+under the MIT License in LICENSE.

package/README.md

@@ -0,0 +1,69 @@
+# @felan-ai/ext-memory
+
+Portable local-first memory contracts, Markdown artifact policy, validation,
+and Pi extension behavior for Felan hosts.
+
+Applications bind the extension to their own storage and coordinator:
+
+```ts
+createMemoryExtension({
+  role: 'root',
+  host,
+});
+```
+
+`root` sessions read memory and report settled transcript cursors. `reader`
+sessions only read memory. The package does not choose a project/team scope,
+schedule workers, call a model, publish artifacts, or import a cloud/local host.
+After a root checkpoint is recorded, the application host decides whether to
+schedule processing. The portable extension never wakes a worker itself.
+
+Memory is a Markdown wiki containing `summary.md`, `index.md`, and topical
+pages under `pages/`. The summary is orientation only: substantive claims
+should follow the index to relevant area and topic pages and cite their paths
+and `Sources` session IDs. Hosts project a non-authoritative copy into each
+root session and retain canonical storage outside customer repositories.
+
+The extension appends one hidden, persisted memory-context message when a
+session starts. Later provider calls reuse that session context instead of
+injecting a new message on every `context` event. If compaction or tree
+navigation removes the message from the active branch, the extension restores
+one copy. The message is excluded from checkpoint evidence so memory cannot
+learn its own injected prompt.
+
+When a user explicitly asks to remember, forget, or change memory, the session
+prompt asks the agent to leave a concise, attributed memory note rather than
+claim an immediate canonical update. A later dreamer treats the original
+user-authored request as direct evidence; the assistant note is only a pointer
+to that request.
+
+Local Felan's host-owned coordinator runs dreaming as a disposable headless Pi
+session over staged `.dreaming/input` and `.memory` directories. The dreamer
+uses only read/list/edit/write file tools, has no normal extensions, skills,
+repository access, or process execution, and returns a summary only after
+editing the staged Markdown artifact. The host validates and publishes that
+filesystem output; failed or cancelled work remains pending. The local worker
+uses the host-selected authenticated session model and may fall back to another
+authenticated available model when that selection is unavailable. It does not
+impose separate turn, tool-call, or per-file I/O budgets; its only execution
+failsafe is a one-hour wall-clock timeout. The host-side evidence
+materializer is a separate boundary: it streams the checkpoint's visible
+active-branch delta from JSONL, ignores unrelated branches, redacts it, and
+caps each staged transcript at 256 KiB. Large source session files are not
+rejected solely for their total size. Deterministic source failures remain
+pending for retry, while valid checkpoints in the same batch can still be
+published.
+
+The memory schema asks the dreamer to update every affected topic, entity, and
+concept page; add meaningful cross-links; preserve valid historical citations;
+mark superseded guidance and unresolved contradictions; and run a bounded
+semantic lint for stale, duplicate, weakly linked, or missing knowledge without
+inventing facts, links, or sources.
+
+Source: `packages/ext-memory` in <https://github.com/felan-ai/felan>.
+
+```sh
+pnpm --filter @felan-ai/ext-memory build
+pnpm --filter @felan-ai/ext-memory type-check
+pnpm --filter @felan-ai/ext-memory test
+```

package/dist/checkpoint.d.ts

@@ -0,0 +1,16 @@
+import type { ExtensionContext } from '@felan-ai/agent-core';
+import type { SessionCheckpoint } from './contracts.js';
+export declare const MEMORY_CONTEXT_CUSTOM_TYPE = "felan-memory-context";
+type CheckpointSessionManager = Pick<ExtensionContext['sessionManager'], 'getBranch' | 'getLeafId' | 'getSessionFile' | 'getSessionId'>;
+export declare function createSessionCheckpoint(sessionManager: CheckpointSessionManager): SessionCheckpoint | null;
+export declare function isMemoryContextEntry(value: unknown): boolean;
+export declare function removeMemoryContextEntries(entries: readonly unknown[]): readonly Record<string, unknown>[];
+export declare function visibleMemoryContextLeafId(entries: readonly unknown[], leafId: string | null): string | null;
+export declare function digestActiveBranch(branch: readonly unknown[]): string;
+export interface ActiveBranchDigester {
+    update(entry: unknown): void;
+    digest(): string;
+}
+export declare function createActiveBranchDigester(): ActiveBranchDigester;
+export {};
+//# sourceMappingURL=checkpoint.d.ts.map

package/dist/checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../src/checkpoint.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,eAAO,MAAM,0BAA0B,yBAAyB,CAAC;AAEjE,KAAK,wBAAwB,GAAG,IAAI,CAClC,gBAAgB,CAAC,gBAAgB,CAAC,EAClC,WAAW,GAAG,WAAW,GAAG,gBAAgB,GAAG,cAAc,CAC9D,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,wBAAwB,GACvC,iBAAiB,GAAG,IAAI,CAW1B;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAI5D;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,SAAS,OAAO,EAAE,GAC1B,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CA+BpC;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,GACpB,MAAM,GAAG,IAAI,CAiBf;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAIrE;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,MAAM,IAAI,MAAM,CAAC;CAClB;AAED,wBAAgB,0BAA0B,IAAI,oBAAoB,CAmBjE"}

package/dist/checkpoint.js

@@ -0,0 +1,127 @@
+import { createHash } from 'node:crypto';
+export const MEMORY_CONTEXT_CUSTOM_TYPE = 'felan-memory-context';
+export function createSessionCheckpoint(sessionManager) {
+    const sessionFile = sessionManager.getSessionFile();
+    if (!sessionFile)
+        return null;
+    const leafId = sessionManager.getLeafId();
+    const branch = removeMemoryContextEntries(sessionManager.getBranch(leafId ?? undefined));
+    return {
+        sessionId: sessionManager.getSessionId(),
+        sessionFile,
+        leafId,
+        transcriptDigest: digestActiveBranch(branch),
+    };
+}
+export function isMemoryContextEntry(value) {
+    return isRecord(value)
+        && value.type === 'custom_message'
+        && value.customType === MEMORY_CONTEXT_CUSTOM_TYPE;
+}
+export function removeMemoryContextEntries(entries) {
+    const records = entries.filter(isRecord);
+    const byId = new Map(records
+        .filter((entry) => typeof entry.id === 'string')
+        .map((entry) => [entry.id, entry]));
+    const memoryIds = new Set(records
+        .filter((entry) => isMemoryContextEntry(entry) && typeof entry.id === 'string')
+        .map((entry) => entry.id));
+    const resolveVisibleParent = (id) => {
+        let current = id;
+        const seen = new Set();
+        while (current !== null && memoryIds.has(current)) {
+            if (seen.has(current))
+                return null;
+            seen.add(current);
+            const parent = byId.get(current)?.parentId;
+            current = typeof parent === 'string' ? parent : null;
+        }
+        return current;
+    };
+    return records
+        .filter((entry) => !isMemoryContextEntry(entry))
+        .map((entry) => {
+        if (typeof entry.parentId !== 'string' || !memoryIds.has(entry.parentId))
+            return entry;
+        return { ...entry, parentId: resolveVisibleParent(entry.parentId) };
+    });
+}
+export function visibleMemoryContextLeafId(entries, leafId) {
+    if (leafId === null)
+        return null;
+    const byId = new Map(entries
+        .filter(isRecord)
+        .filter((entry) => typeof entry.id === 'string')
+        .map((entry) => [entry.id, entry]));
+    let current = leafId;
+    const seen = new Set();
+    while (current !== null && isMemoryContextEntry(byId.get(current))) {
+        if (seen.has(current))
+            return null;
+        seen.add(current);
+        const parent = byId.get(current)?.parentId;
+        current = typeof parent === 'string' ? parent : null;
+    }
+    return current;
+}
+export function digestActiveBranch(branch) {
+    const digester = createActiveBranchDigester();
+    for (const entry of branch)
+        digester.update(entry);
+    return digester.digest();
+}
+export function createActiveBranchDigester() {
+    const hash = createHash('sha256');
+    let entries = 0;
+    let finalized = false;
+    hash.update('[');
+    return {
+        update(entry) {
+            if (finalized)
+                throw new Error('Active branch digest is already finalized');
+            if (entries > 0)
+                hash.update(',');
+            updateCanonicalJson(hash, entry);
+            entries += 1;
+        },
+        digest() {
+            if (finalized)
+                throw new Error('Active branch digest is already finalized');
+            finalized = true;
+            hash.update(']');
+            return hash.digest('hex');
+        },
+    };
+}
+function updateCanonicalJson(hash, value) {
+    if (value === null || typeof value !== 'object') {
+        hash.update(JSON.stringify(value) ?? 'null');
+        return;
+    }
+    if (Array.isArray(value)) {
+        hash.update('[');
+        for (const [index, entry] of value.entries()) {
+            if (index > 0)
+                hash.update(',');
+            updateCanonicalJson(hash, entry);
+        }
+        hash.update(']');
+        return;
+    }
+    const entries = Object.entries(value)
+        .filter(([, entry]) => entry !== undefined)
+        .sort(([left], [right]) => left.localeCompare(right));
+    hash.update('{');
+    for (const [index, [key, entry]] of entries.entries()) {
+        if (index > 0)
+            hash.update(',');
+        hash.update(JSON.stringify(key));
+        hash.update(':');
+        updateCanonicalJson(hash, entry);
+    }
+    hash.update('}');
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/checkpoint.js.map

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

package/dist/contracts.d.ts

@@ -0,0 +1,86 @@
+export declare const MEMORY_ARTIFACT_VERSION: 1;
+export declare const MEMORY_INPUT_MANIFEST_VERSION: 1;
+export type MemoryRole = 'root' | 'reader';
+export interface MemoryFile {
+    /** POSIX path relative to the logical .memory root. */
+    readonly path: string;
+    readonly content: string;
+}
+export interface MemoryArtifact {
+    readonly version: typeof MEMORY_ARTIFACT_VERSION;
+    readonly files: readonly MemoryFile[];
+}
+export interface MemorySnapshot extends MemoryArtifact {
+    /** SHA-256 fingerprint of the complete canonical artifact. */
+    readonly fingerprint: string;
+    /** Agent-visible path of this session's non-authoritative projection. */
+    readonly memoryPath: string;
+}
+export interface SessionCheckpoint {
+    readonly sessionId: string;
+    readonly sessionFile: string;
+    readonly leafId: string | null;
+    readonly transcriptDigest: string;
+}
+export type MemoryProcessingState = 'disabled' | 'idle' | 'scheduled' | 'processing' | 'blocked' | 'error';
+export interface MemoryStatus {
+    readonly enabled: boolean;
+    readonly state: MemoryProcessingState;
+    readonly pendingCheckpoints: number;
+    readonly memoryFingerprint?: string;
+    readonly lastProcessedAt?: string;
+    /** Sanitized diagnostic which must not contain transcript content or credentials. */
+    readonly message?: string;
+}
+export interface MemoryHost {
+    readCurrent(): Promise<MemorySnapshot | null>;
+    recordCheckpoint(checkpoint: SessionCheckpoint): Promise<void>;
+    status(): Promise<MemoryStatus>;
+}
+export interface MemoryInputSession {
+    readonly checkpoint: SessionCheckpoint;
+    readonly metadataPath: string;
+    readonly transcriptPath: string;
+    readonly materializedDigest: string;
+    readonly byteLength: number;
+    readonly redactionCount: number;
+}
+export interface MemoryInputManifest {
+    readonly version: typeof MEMORY_INPUT_MANIFEST_VERSION;
+    readonly createdAt: string;
+    readonly baseMemoryFingerprint: string;
+    readonly sessions: readonly MemoryInputSession[];
+}
+export interface MemoryArtifactLimits {
+    readonly maxFiles: number;
+    readonly maxFileBytes: number;
+    readonly maxTotalBytes: number;
+    readonly maxAreas: number;
+    readonly maxPagesPerArea: number;
+}
+export declare const DEFAULT_MEMORY_ARTIFACT_LIMITS: MemoryArtifactLimits;
+export interface MemoryValidationOptions {
+    readonly limits?: Partial<MemoryArtifactLimits>;
+    readonly sourceSessionIds?: readonly string[];
+    readonly requireSources?: boolean;
+    readonly memoryPath?: string;
+}
+export interface MemoryValidationError {
+    readonly code: 'duplicate_path' | 'invalid_path' | 'unsupported_version' | 'invalid_file_type' | 'invalid_markdown' | 'missing_required_file' | 'file_too_large' | 'too_many_files' | 'too_many_areas' | 'too_many_pages' | 'total_too_large' | 'summary_has_links' | 'invalid_link' | 'broken_link' | 'unreachable_page' | 'missing_sources' | 'unknown_source';
+    readonly path?: string;
+    readonly message: string;
+}
+export interface MemoryValidationResult {
+    readonly ok: boolean;
+    readonly artifact?: MemoryArtifact;
+    readonly errors: readonly MemoryValidationError[];
+}
+export interface MemoryHydrationOptions extends MemoryValidationOptions {
+    readonly replace?: boolean;
+}
+export interface MemoryInputManifestOptions {
+    readonly baseMemoryFingerprint: string;
+    readonly sessions: readonly MemoryInputSession[];
+    readonly createdAt?: string;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/contracts.d.ts.map

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

package/dist/contracts.js

@@ -0,0 +1,10 @@
+export const MEMORY_ARTIFACT_VERSION = 1;
+export const MEMORY_INPUT_MANIFEST_VERSION = 1;
+export const DEFAULT_MEMORY_ARTIFACT_LIMITS = Object.freeze({
+    maxFiles: 256,
+    maxFileBytes: 256 * 1024,
+    maxTotalBytes: 4 * 1024 * 1024,
+    maxAreas: 32,
+    maxPagesPerArea: 32,
+});
+//# sourceMappingURL=contracts.js.map

package/dist/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAU,CAAC;AAClD,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAU,CAAC;AA6ExD,MAAM,CAAC,MAAM,8BAA8B,GAAyB,MAAM,CAAC,MAAM,CAAC;IAChF,QAAQ,EAAE,GAAG;IACb,YAAY,EAAE,GAAG,GAAG,IAAI;IACxB,aAAa,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;IAC9B,QAAQ,EAAE,EAAE;IACZ,eAAe,EAAE,EAAE;CACpB,CAAC,CAAC"}

package/dist/dreamer.d.ts

@@ -0,0 +1,6 @@
+export { createMemoryDreamerInstructions, createMemorySchemaMarkdown, } from './schema.js';
+export interface MemoryDreamWorkspace {
+    readonly memoryPath: string;
+    readonly inputPath: string;
+}
+//# sourceMappingURL=dreamer.d.ts.map

package/dist/dreamer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dreamer.d.ts","sourceRoot":"","sources":["../src/dreamer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAC/B,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B"}

package/dist/dreamer.js

@@ -0,0 +1,2 @@
+export { createMemoryDreamerInstructions, createMemorySchemaMarkdown, } from './schema.js';
+//# sourceMappingURL=dreamer.js.map

package/dist/dreamer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dreamer.js","sourceRoot":"","sources":["../src/dreamer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAC/B,0BAA0B,GAC3B,MAAM,aAAa,CAAC"}

package/dist/hydration.d.ts

@@ -0,0 +1,14 @@
+import { type MemoryArtifact, type MemoryFile, type MemoryHydrationOptions, type MemorySnapshot } from './contracts.js';
+export declare function memoryArtifactFingerprint(artifact: MemoryArtifact | readonly MemoryFile[]): string;
+export declare function createMemorySnapshot(artifact: MemoryArtifact | readonly MemoryFile[], memoryPath: string, options?: MemoryHydrationOptions): MemorySnapshot;
+/**
+ * Rebase root-index navigation for an agent-visible projection while retaining
+ * the fingerprint of the unchanged canonical artifact.
+ */
+export declare function createMemoryProjectionSnapshot(snapshot: MemorySnapshot, memoryPath: string): MemorySnapshot;
+export declare function createEmptyMemoryArtifact(memoryPath: string): MemoryArtifact;
+export declare function readMemoryDirectory(root: string, options?: MemoryHydrationOptions): Promise<MemoryArtifact>;
+export declare function hydrateMemoryDirectory(artifact: MemoryArtifact | readonly MemoryFile[], target: string, options?: MemoryHydrationOptions): Promise<void>;
+export declare function hydrateMemorySnapshot(snapshot: MemorySnapshot, target: string, options?: MemoryHydrationOptions): Promise<void>;
+export declare function validateMemoryDirectoryInput(artifact: MemoryArtifact | readonly MemoryFile[], options?: MemoryHydrationOptions): void;
+//# sourceMappingURL=hydration.d.ts.map

package/dist/hydration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydration.d.ts","sourceRoot":"","sources":["../src/hydration.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,cAAc,EAEnB,KAAK,UAAU,EACf,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AAYxB,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,UAAU,EAAE,GAAG,MAAM,CAWlG;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,cAAc,GAAG,SAAS,UAAU,EAAE,EAChD,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,sBAA2B,GACnC,cAAc,CAOhB;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,cAAc,EACxB,UAAU,EAAE,MAAM,GACjB,cAAc,CAchB;AAED,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAQ5E;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,cAAc,CAAC,CAczB;AAED,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,cAAc,GAAG,SAAS,UAAU,EAAE,EAChD,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAEf;AA0ED,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,cAAc,GAAG,SAAS,UAAU,EAAE,EAChD,OAAO,GAAE,sBAA2B,GACnC,IAAI,CAGN"}

package/dist/hydration.js

@@ -0,0 +1,160 @@
+import { createHash } from 'node:crypto';
+import { mkdtemp, mkdir, readFile, readdir, rename, rm, writeFile, lstat } from 'node:fs/promises';
+import { dirname, join, relative, sep } from 'node:path';
+import { DEFAULT_MEMORY_ARTIFACT_LIMITS, } from './contracts.js';
+import { createDefaultMemoryIndex, createMemoryNavigationGuide } from './schema.js';
+import { assertValidMemoryArtifact, isSafeMemoryPath, resolveMemoryLink, validateMemoryArtifact, } from './validation.js';
+const MARKDOWN_LINK_TARGET = /(!?\[[^\]]*\]\()([^)\s]+)((?:\s+['"][^'"]*['"])?\))/gu;
+const WIKI_LINK_TARGET = /(\[\[)([^\]|#]+)((?:#[^\]|]+)?(?:\|[^\]]+)?)\]\]/gu;
+export function memoryArtifactFingerprint(artifact) {
+    const files = 'files' in artifact ? artifact.files : artifact;
+    const sorted = [...files].sort((left, right) => left.path.localeCompare(right.path));
+    const hash = createHash('sha256');
+    for (const file of sorted) {
+        hash.update(file.path, 'utf8');
+        hash.update('\0', 'utf8');
+        hash.update(file.content, 'utf8');
+        hash.update('\0', 'utf8');
+    }
+    return hash.digest('hex');
+}
+export function createMemorySnapshot(artifact, memoryPath, options = {}) {
+    const normalized = assertValidMemoryArtifact(artifact, options);
+    return {
+        ...normalized,
+        fingerprint: memoryArtifactFingerprint(normalized),
+        memoryPath,
+    };
+}
+/**
+ * Rebase root-index navigation for an agent-visible projection while retaining
+ * the fingerprint of the unchanged canonical artifact.
+ */
+export function createMemoryProjectionSnapshot(snapshot, memoryPath) {
+    if (snapshot.memoryPath === memoryPath)
+        return snapshot;
+    const files = snapshot.files.map((file) => file.path === 'index.md'
+        ? {
+            ...file,
+            content: rebaseMemoryIndex(file.content, snapshot.memoryPath, memoryPath),
+        }
+        : file);
+    const projected = assertValidMemoryArtifact(files, { memoryPath });
+    return {
+        ...projected,
+        fingerprint: snapshot.fingerprint,
+        memoryPath,
+    };
+}
+export function createEmptyMemoryArtifact(memoryPath) {
+    return {
+        version: 1,
+        files: [
+            { path: 'summary.md', content: '' },
+            { path: 'index.md', content: createDefaultMemoryIndex(memoryPath) },
+        ],
+    };
+}
+export async function readMemoryDirectory(root, options = {}) {
+    const files = [];
+    let totalBytes = 0;
+    const rootStats = await lstat(root);
+    if (rootStats.isSymbolicLink() || !rootStats.isDirectory()) {
+        throw new Error('Memory root must be a regular directory');
+    }
+    await walk(root, root, files, options, (bytes) => {
+        totalBytes += bytes;
+        if (totalBytes > mergedLimits(options.limits).maxTotalBytes) {
+            throw new Error(`Memory directory exceeds the ${mergedLimits(options.limits).maxTotalBytes}-byte limit`);
+        }
+    });
+    return assertValidMemoryArtifact(files, options);
+}
+export async function hydrateMemoryDirectory(artifact, target, options = {}) {
+    const normalized = assertValidMemoryArtifact(artifact, options);
+    const parent = dirname(target);
+    await mkdir(parent, { recursive: true, mode: 0o700 });
+    const existing = await safeLstat(target);
+    if (existing && existing.isSymbolicLink())
+        throw new Error('Refusing to hydrate through a symlink');
+    if (existing && !options.replace)
+        throw new Error(`Memory target already exists: ${target}`);
+    const temporary = await mkdtemp(join(parent, '.memory-hydration-'));
+    try {
+        for (const file of normalized.files) {
+            if (!isSafeMemoryPath(file.path))
+                throw new Error(`Unsafe memory path: ${file.path}`);
+            const path = join(temporary, ...file.path.split('/'));
+            await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+            await writeFile(path, file.content, { encoding: 'utf8', mode: 0o600, flag: 'wx' });
+        }
+        if (existing)
+            await rm(target, { recursive: true, force: true });
+        await rename(temporary, target);
+    }
+    catch (error) {
+        await rm(temporary, { recursive: true, force: true });
+        throw error;
+    }
+}
+export async function hydrateMemorySnapshot(snapshot, target, options = {}) {
+    await hydrateMemoryDirectory(snapshot, target, options);
+}
+async function walk(root, current, files, options, onBytes) {
+    const entries = await readdir(current, { withFileTypes: true });
+    for (const entry of entries) {
+        const absolute = join(current, entry.name);
+        const relativePath = relative(root, absolute).split(sep).join('/');
+        const stats = await lstat(absolute);
+        if (stats.isSymbolicLink() || (!stats.isDirectory() && !stats.isFile())) {
+            throw new Error(`Unsafe memory entry type: ${relativePath}`);
+        }
+        if (stats.isDirectory()) {
+            await walk(root, absolute, files, options, onBytes);
+            continue;
+        }
+        const content = await readFile(absolute, 'utf8');
+        onBytes(Buffer.byteLength(content, 'utf8'));
+        files.push({ path: relativePath, content });
+    }
+}
+function safeLstat(path) {
+    return lstat(path).catch((error) => {
+        if (isMissing(error))
+            return undefined;
+        throw error;
+    });
+}
+function mergedLimits(overrides) {
+    return { ...DEFAULT_MEMORY_ARTIFACT_LIMITS, ...(overrides ?? {}) };
+}
+function rebaseMemoryIndex(content, sourceMemoryPath, targetMemoryPath) {
+    const sourceGuide = createMemoryNavigationGuide(sourceMemoryPath);
+    const targetGuide = createMemoryNavigationGuide(targetMemoryPath);
+    return content
+        .replace(sourceGuide, targetGuide)
+        .replace(MARKDOWN_LINK_TARGET, (match, opening, rawTarget, closing) => {
+        const rebased = rebaseMemoryLink(rawTarget, sourceMemoryPath, targetMemoryPath);
+        return rebased === undefined ? match : `${opening}${rebased}${closing}`;
+    })
+        .replace(WIKI_LINK_TARGET, (match, opening, rawTarget, suffix) => {
+        const rebased = rebaseMemoryLink(rawTarget, sourceMemoryPath, targetMemoryPath);
+        return rebased === undefined ? match : `${opening}${rebased}${suffix}]]`;
+    });
+}
+function rebaseMemoryLink(rawTarget, sourceMemoryPath, targetMemoryPath) {
+    const resolved = resolveMemoryLink('index.md', rawTarget, sourceMemoryPath);
+    if (!resolved)
+        return undefined;
+    const suffix = rawTarget.match(/[?#].*$/u)?.[0] ?? '';
+    return `${targetMemoryPath.replace(/\/$/u, '')}/${resolved}${suffix}`;
+}
+function isMissing(error) {
+    return typeof error === 'object' && error !== null && Reflect.get(error, 'code') === 'ENOENT';
+}
+export function validateMemoryDirectoryInput(artifact, options = {}) {
+    const result = validateMemoryArtifact(artifact, options);
+    if (!result.ok)
+        throw new Error(result.errors.map((error) => error.message).join('; '));
+}
+//# sourceMappingURL=hydration.js.map

package/dist/hydration.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+import type { FelanExtension } from '@felan-ai/agent-core';
+import type { MemoryHost, MemoryRole } from './contracts.js';
+export * from './checkpoint.js';
+export * from './contracts.js';
+export * from './dreamer.js';
+export * from './hydration.js';
+export * from './manifest.js';
+export * from './schema.js';
+export * from './validation.js';
+export interface CreateMemoryExtensionOptions {
+    readonly role: MemoryRole;
+    readonly host: MemoryHost;
+    readonly label?: string;
+}
+export declare function createMemoryExtension({ role, host, label, }: CreateMemoryExtensionOptions): FelanExtension;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAM7E,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG7D,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAEhC,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAID,wBAAgB,qBAAqB,CAAC,EACpC,IAAI,EACJ,IAAI,EACJ,KAAiB,GAClB,EAAE,4BAA4B,GAAG,cAAc,CAqD/C"}