@gencode/agents 0.0.1

package/dist/memory/provider.d.ts

@@ -0,0 +1,40 @@
+import type { MemoryProviderStatus, MemorySearchResult } from "./manager.js";
+export type MemoryProviderContext = {
+    dataDir: string;
+    memoryDir: string;
+    sessionId?: string;
+    pluginId?: string;
+    config?: Record<string, unknown>;
+    rootDir?: string;
+    source?: string;
+};
+export type MemorySearchOptions = {
+    limit?: number;
+    sources?: Array<"memory" | "sessions">;
+};
+export type MemoryChangeSource = "memory" | "sessions";
+export type MemoryChangedEvent = {
+    reason: string;
+    files: string[];
+    source: MemoryChangeSource;
+    sessionId?: string;
+    providerId?: string;
+    timestamp: string;
+};
+export type MemoryChangedHandler = (event: MemoryChangedEvent) => void | Promise<void>;
+export type MemoryProvider = {
+    id: string;
+    name?: string;
+    status: () => MemoryProviderStatus;
+    search: (query: string, options?: MemorySearchOptions) => Promise<MemorySearchResult[]>;
+    getLines: (file: string, startLine: number, endLine: number) => Promise<string[] | null>;
+    listFiles: () => Promise<string[]>;
+    append: (content: string) => Promise<void>;
+    updateFile: (file: string, content: string) => Promise<void>;
+    deleteFile: (file: string) => Promise<void>;
+    sync?: (reason?: string) => Promise<void>;
+    noteSessionUpdate?: (sessionFile: string) => void;
+    onMemoryChanged?: MemoryChangedHandler;
+};
+export type MemoryProviderFactory = (ctx: MemoryProviderContext) => MemoryProvider;
+//# sourceMappingURL=provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/memory/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAE7E,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,UAAU,CAAC,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEvD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEvF,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,oBAAoB,CAAC;IACnC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,KAAK,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACxF,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;IACzF,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACnC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,iBAAiB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,eAAe,CAAC,EAAE,oBAAoB,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,EAAE,qBAAqB,KAAK,cAAc,CAAC"}

package/dist/memory/provider.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider.js.map

package/dist/memory/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/memory/provider.ts"],"names":[],"mappings":""}

package/dist/memory/session-files.d.ts

@@ -0,0 +1,13 @@
+export type SessionFileEntry = {
+    path: string;
+    absPath: string;
+    mtimeMs: number;
+    size: number;
+    hash: string;
+    content: string;
+    lineMap?: number[];
+};
+export declare function sessionPathForFile(dataDir: string, absPath: string): string;
+export declare function listSessionFilesForAgent(dataDir: string): Promise<string[]>;
+export declare function buildSessionEntry(dataDir: string, absPath: string): Promise<SessionFileEntry | null>;
+//# sourceMappingURL=session-files.d.ts.map

package/dist/memory/session-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-files.d.ts","sourceRoot":"","sources":["../../src/memory/session-files.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAG3E;AAED,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAwBjF;AAuBD,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CA0D1G"}

package/dist/memory/session-files.js

@@ -0,0 +1,116 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { isFileMissingError } from "./fs-utils.js";
+import { hashText } from "./internal.js";
+import { sessionsDir } from "../session/session.js";
+export function sessionPathForFile(dataDir, absPath) {
+    const root = sessionsDir(dataDir);
+    return path.relative(root, absPath).replace(/\\/g, "/");
+}
+export async function listSessionFilesForAgent(dataDir) {
+    const root = sessionsDir(dataDir);
+    try {
+        const entries = await fs.readdir(root, { withFileTypes: true });
+        const files = [];
+        for (const entry of entries) {
+            if (!entry.isDirectory()) {
+                continue;
+            }
+            const transcript = path.join(root, entry.name, "transcript.jsonl");
+            try {
+                const stat = await fs.stat(transcript);
+                if (stat.isFile()) {
+                    files.push(transcript);
+                }
+            }
+            catch { }
+        }
+        return files;
+    }
+    catch (err) {
+        if (isFileMissingError(err)) {
+            return [];
+        }
+        throw err;
+    }
+}
+function stringifyContent(raw) {
+    if (typeof raw === "string") {
+        return raw;
+    }
+    if (Array.isArray(raw)) {
+        return raw
+            .map((item) => {
+            if (typeof item === "string") {
+                return item;
+            }
+            if (item && typeof item === "object" && "text" in item) {
+                return String(item.text ?? "");
+            }
+            return "";
+        })
+            .filter(Boolean)
+            .join(" ");
+    }
+    return raw ? String(raw) : "";
+}
+export async function buildSessionEntry(dataDir, absPath) {
+    let stat;
+    try {
+        stat = await fs.stat(absPath);
+    }
+    catch (err) {
+        if (isFileMissingError(err)) {
+            return null;
+        }
+        throw err;
+    }
+    let content;
+    try {
+        content = await fs.readFile(absPath, "utf-8");
+    }
+    catch (err) {
+        if (isFileMissingError(err)) {
+            return null;
+        }
+        throw err;
+    }
+    const lines = [];
+    const lineMap = [];
+    const rawLines = content.split("\n");
+    for (let i = 0; i < rawLines.length; i += 1) {
+        const raw = rawLines[i];
+        const trimmed = raw?.trim();
+        if (!trimmed) {
+            continue;
+        }
+        try {
+            const parsed = JSON.parse(trimmed);
+            const role = parsed.role ?? "unknown";
+            const text = stringifyContent(parsed.content);
+            if (!text) {
+                continue;
+            }
+            const entryLines = text.split("\n");
+            for (const entryLine of entryLines) {
+                lines.push(`[${role}] ${entryLine}`);
+                lineMap.push(i + 1);
+            }
+        }
+        catch {
+            // skip malformed lines
+        }
+    }
+    const flattened = lines.join("\n");
+    const hash = hashText(flattened);
+    return {
+        path: path.join("sessions", sessionPathForFile(dataDir, absPath)).replace(/\\/g, "/"),
+        absPath,
+        mtimeMs: stat.mtimeMs,
+        size: stat.size,
+        hash,
+        content: flattened,
+        lineMap,
+    };
+}
+//# sourceMappingURL=session-files.js.map

package/dist/memory/session-files.js.map

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

package/dist/memory/sqlite-vec.d.ts

@@ -0,0 +1,10 @@
+import type { DatabaseSync } from "node:sqlite";
+export declare function loadSqliteVecExtension(params: {
+    db: DatabaseSync;
+    extensionPath?: string;
+}): Promise<{
+    ok: boolean;
+    extensionPath?: string;
+    error?: string;
+}>;
+//# sourceMappingURL=sqlite-vec.d.ts.map

package/dist/memory/sqlite-vec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-vec.d.ts","sourceRoot":"","sources":["../../src/memory/sqlite-vec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,wBAAsB,sBAAsB,CAAC,MAAM,EAAE;IACnD,EAAE,EAAE,YAAY,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAkBnE"}

package/dist/memory/sqlite-vec.js

@@ -0,0 +1,20 @@
+export async function loadSqliteVecExtension(params) {
+    try {
+        const sqliteVec = await import("sqlite-vec");
+        const resolvedPath = params.extensionPath?.trim() ? params.extensionPath.trim() : undefined;
+        const extensionPath = resolvedPath ?? sqliteVec.getLoadablePath();
+        params.db.enableLoadExtension(true);
+        if (resolvedPath) {
+            params.db.loadExtension(extensionPath);
+        }
+        else {
+            sqliteVec.load(params.db);
+        }
+        return { ok: true, extensionPath };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { ok: false, error: message };
+    }
+}
+//# sourceMappingURL=sqlite-vec.js.map

package/dist/memory/sqlite-vec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-vec.js","sourceRoot":"","sources":["../../src/memory/sqlite-vec.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,MAG5C;IACC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QAC7C,MAAM,YAAY,GAAG,MAAM,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5F,MAAM,aAAa,GAAG,YAAY,IAAI,SAAS,CAAC,eAAe,EAAE,CAAC;QAElE,MAAM,CAAC,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,CAAC,EAAE,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC5B,CAAC;QAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IACvC,CAAC;AACH,CAAC"}

package/dist/memory/sqlite.d.ts

@@ -0,0 +1,2 @@
+export declare function requireNodeSqlite(): typeof import("node:sqlite");
+//# sourceMappingURL=sqlite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/memory/sqlite.ts"],"names":[],"mappings":"AAIA,wBAAgB,iBAAiB,IAAI,cAAc,aAAa,CAAC,CAUhE"}

package/dist/memory/sqlite.js

@@ -0,0 +1,12 @@
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+export function requireNodeSqlite() {
+    try {
+        return require("node:sqlite");
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`SQLite support is unavailable in this Node runtime (missing node:sqlite). ${message}`, { cause: err });
+    }
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/memory/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../../src/memory/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,aAAa,CAAiC,CAAC;IAChE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,IAAI,KAAK,CACb,6EAA6E,OAAO,EAAE,EACtF,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/memory/temporal-decay.d.ts

@@ -0,0 +1,26 @@
+export type TemporalDecayConfig = {
+    enabled: boolean;
+    halfLifeDays: number;
+};
+export declare const DEFAULT_TEMPORAL_DECAY_CONFIG: TemporalDecayConfig;
+export declare function toDecayLambda(halfLifeDays: number): number;
+export declare function calculateTemporalDecayMultiplier(params: {
+    ageInDays: number;
+    halfLifeDays: number;
+}): number;
+export declare function applyTemporalDecayToScore(params: {
+    score: number;
+    ageInDays: number;
+    halfLifeDays: number;
+}): number;
+export declare function applyTemporalDecayToHybridResults<T extends {
+    path: string;
+    score: number;
+    source: string;
+}>(params: {
+    results: T[];
+    temporalDecay?: Partial<TemporalDecayConfig>;
+    memoryRoot?: string;
+    nowMs?: number;
+}): Promise<T[]>;
+//# sourceMappingURL=temporal-decay.d.ts.map

package/dist/memory/temporal-decay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-decay.d.ts","sourceRoot":"","sources":["../../src/memory/temporal-decay.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,mBAG3C,CAAC;AAKF,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAK1D;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,MAAM,CAOT;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,MAAM,CAET;AA8ED,wBAAsB,iCAAiC,CACrD,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACzD,MAAM,EAAE;IACR,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,aAAa,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAuCf"}

package/dist/memory/temporal-decay.js

@@ -0,0 +1,119 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+export const DEFAULT_TEMPORAL_DECAY_CONFIG = {
+    enabled: false,
+    halfLifeDays: 30,
+};
+const DAY_MS = 24 * 60 * 60 * 1000;
+const DATED_MEMORY_PATH_RE = /(?:^|\/)(?:memory)\/(\d{4})-(\d{2})-(\d{2})\.md$/;
+export function toDecayLambda(halfLifeDays) {
+    if (!Number.isFinite(halfLifeDays) || halfLifeDays <= 0) {
+        return 0;
+    }
+    return Math.LN2 / halfLifeDays;
+}
+export function calculateTemporalDecayMultiplier(params) {
+    const lambda = toDecayLambda(params.halfLifeDays);
+    const clampedAge = Math.max(0, params.ageInDays);
+    if (lambda <= 0 || !Number.isFinite(clampedAge)) {
+        return 1;
+    }
+    return Math.exp(-lambda * clampedAge);
+}
+export function applyTemporalDecayToScore(params) {
+    return params.score * calculateTemporalDecayMultiplier(params);
+}
+function parseMemoryDateFromPath(filePath) {
+    const normalized = filePath.replaceAll("\\", "/").replace(/^\.\//, "");
+    const match = DATED_MEMORY_PATH_RE.exec(normalized);
+    if (!match) {
+        return null;
+    }
+    const year = Number(match[1]);
+    const month = Number(match[2]);
+    const day = Number(match[3]);
+    if (!Number.isInteger(year) || !Number.isInteger(month) || !Number.isInteger(day)) {
+        return null;
+    }
+    const timestamp = Date.UTC(year, month - 1, day);
+    const parsed = new Date(timestamp);
+    if (parsed.getUTCFullYear() !== year ||
+        parsed.getUTCMonth() !== month - 1 ||
+        parsed.getUTCDate() !== day) {
+        return null;
+    }
+    return parsed;
+}
+function isEvergreenMemoryPath(filePath) {
+    const normalized = filePath.replaceAll("\\", "/").replace(/^\.\//, "");
+    if (normalized === "MEMORY.md" || normalized === "memory.md") {
+        return true;
+    }
+    if (!normalized.startsWith("memory/")) {
+        return false;
+    }
+    return !DATED_MEMORY_PATH_RE.test(normalized);
+}
+async function extractTimestamp(params) {
+    const fromPath = parseMemoryDateFromPath(params.filePath);
+    if (fromPath) {
+        return fromPath;
+    }
+    if (params.source === "memory" && isEvergreenMemoryPath(params.filePath)) {
+        return null;
+    }
+    if (!params.memoryRoot) {
+        return null;
+    }
+    const absolutePath = path.isAbsolute(params.filePath)
+        ? params.filePath
+        : path.resolve(params.memoryRoot, params.filePath);
+    try {
+        const stat = await fs.stat(absolutePath);
+        if (!Number.isFinite(stat.mtimeMs)) {
+            return null;
+        }
+        return new Date(stat.mtimeMs);
+    }
+    catch {
+        return null;
+    }
+}
+function ageInDaysFromTimestamp(timestamp, nowMs) {
+    const ageMs = Math.max(0, nowMs - timestamp.getTime());
+    return ageMs / DAY_MS;
+}
+export async function applyTemporalDecayToHybridResults(params) {
+    const config = { ...DEFAULT_TEMPORAL_DECAY_CONFIG, ...params.temporalDecay };
+    if (!config.enabled) {
+        return [...params.results];
+    }
+    const nowMs = params.nowMs ?? Date.now();
+    const timestampPromiseCache = new Map();
+    return Promise.all(params.results.map(async (entry) => {
+        const cacheKey = `${entry.source}:${entry.path}`;
+        let timestampPromise = timestampPromiseCache.get(cacheKey);
+        if (!timestampPromise) {
+            timestampPromise = extractTimestamp({
+                filePath: entry.path,
+                source: entry.source,
+                memoryRoot: params.memoryRoot,
+            });
+            timestampPromiseCache.set(cacheKey, timestampPromise);
+        }
+        const timestamp = await timestampPromise;
+        if (!timestamp) {
+            return entry;
+        }
+        const decayedScore = applyTemporalDecayToScore({
+            score: entry.score,
+            ageInDays: ageInDaysFromTimestamp(timestamp, nowMs),
+            halfLifeDays: config.halfLifeDays,
+        });
+        return {
+            ...entry,
+            score: decayedScore,
+        };
+    }));
+}
+//# sourceMappingURL=temporal-decay.js.map

package/dist/memory/temporal-decay.js.map

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

package/dist/memory/watch-bridge.d.ts

@@ -0,0 +1,20 @@
+import fsSync from "node:fs";
+import type { MemoryChangedHandler, MemoryProvider } from "./provider.js";
+type WatchCallback = (eventType: string, filename: string | Buffer | null) => void;
+type WatcherLike = {
+    close: () => void;
+    on?: (event: "error", listener: () => void) => void;
+};
+type WatchFactory = (target: string, options: fsSync.WatchOptions, listener: WatchCallback) => WatcherLike;
+export type MemoryWatchBridgeOptions = {
+    dataDir: string;
+    sessionId?: string;
+    providerId?: string;
+    provider?: MemoryProvider;
+    debounceMs?: number;
+    onMemoryChanged?: MemoryChangedHandler;
+    watchFactory?: WatchFactory;
+};
+export declare function startMemoryWatchBridge(options: MemoryWatchBridgeOptions): () => void;
+export {};
+//# sourceMappingURL=watch-bridge.d.ts.map

package/dist/memory/watch-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-bridge.d.ts","sourceRoot":"","sources":["../../src/memory/watch-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,SAAS,CAAC;AAE7B,OAAO,KAAK,EAAsB,oBAAoB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE9F,KAAK,aAAa,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;AAEnF,KAAK,WAAW,GAAG;IACjB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CACrD,CAAC;AAEF,KAAK,YAAY,GAAG,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,YAAY,EAC5B,QAAQ,EAAE,aAAa,KACpB,WAAW,CAAC;AASjB,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,oBAAoB,CAAC;IACvC,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B,CAAC;AA+CF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,IAAI,CA0FpF"}

package/dist/memory/watch-bridge.js

@@ -0,0 +1,128 @@
+import fsSync from "node:fs";
+import path from "node:path";
+function normalizeFilename(filename) {
+    if (!filename) {
+        return null;
+    }
+    const value = typeof filename === "string" ? filename : filename.toString("utf-8");
+    const normalized = value.replace(/\\/g, "/").replace(/^\.\//, "").trim();
+    return normalized.length > 0 ? normalized : null;
+}
+function resolveWatchFiles(params) {
+    const file = normalizeFilename(params.filename);
+    if (params.kind === "memory-file") {
+        return ["MEMORY.md"];
+    }
+    if (params.kind === "memory-file-lower") {
+        return ["memory.md"];
+    }
+    if (params.kind === "memory-dir") {
+        if (!file) {
+            return ["memory"];
+        }
+        const base = path.basename(file).replace(/\\/g, "/");
+        if (!base.endsWith(".md")) {
+            return [];
+        }
+        return [`memory/${base}`];
+    }
+    if (!file) {
+        return ["MEMORY.md", "memory"];
+    }
+    if (file === "MEMORY.md" || file === "memory.md") {
+        return [file];
+    }
+    if (file === "memory") {
+        return ["memory"];
+    }
+    if (file.startsWith("memory/")) {
+        return file.endsWith(".md") ? [file] : ["memory"];
+    }
+    return [];
+}
+export function startMemoryWatchBridge(options) {
+    const watch = options.watchFactory ?? ((target, watchOptions, listener) => fsSync.watch(target, watchOptions, listener));
+    const memoryRoot = path.join(options.dataDir, ".aimax");
+    const watchTargets = [
+        { target: path.join(memoryRoot, "MEMORY.md"), kind: "memory-file" },
+        { target: path.join(memoryRoot, "memory.md"), kind: "memory-file-lower" },
+        { target: path.join(memoryRoot, "memory"), kind: "memory-dir" },
+        { target: memoryRoot, kind: "memory-root" },
+    ];
+    const watchers = [];
+    const pendingFiles = new Set();
+    let timer = null;
+    const debounceMs = Number.isFinite(options.debounceMs) && (options.debounceMs ?? 0) > 0
+        ? Math.floor(options.debounceMs)
+        : 1500;
+    const flush = async () => {
+        const files = Array.from(pendingFiles);
+        pendingFiles.clear();
+        if (files.length === 0) {
+            return;
+        }
+        const event = {
+            reason: "external-watch",
+            files,
+            source: "memory",
+            sessionId: options.sessionId,
+            providerId: options.providerId,
+            timestamp: new Date().toISOString(),
+        };
+        if (options.provider?.sync) {
+            await options.provider.sync("external-watch").catch(() => { });
+        }
+        if (options.provider?.onMemoryChanged) {
+            await Promise.resolve(options.provider.onMemoryChanged(event)).catch(() => { });
+        }
+        if (options.onMemoryChanged) {
+            await Promise.resolve(options.onMemoryChanged(event)).catch(() => { });
+        }
+    };
+    const scheduleFlush = () => {
+        if (timer) {
+            clearTimeout(timer);
+        }
+        timer = setTimeout(() => {
+            timer = null;
+            void flush();
+        }, debounceMs);
+    };
+    for (const entry of watchTargets) {
+        try {
+            const watcher = watch(entry.target, { recursive: false }, (_eventType, filename) => {
+                const files = resolveWatchFiles({ kind: entry.kind, filename });
+                if (files.length === 0) {
+                    return;
+                }
+                for (const file of files) {
+                    pendingFiles.add(file);
+                }
+                scheduleFlush();
+            });
+            watcher.on?.("error", () => {
+                try {
+                    watcher.close();
+                }
+                catch { }
+            });
+            watchers.push(watcher);
+        }
+        catch {
+            // Ignore missing/unwatchable paths.
+        }
+    }
+    return () => {
+        if (timer) {
+            clearTimeout(timer);
+            timer = null;
+        }
+        for (const watcher of watchers) {
+            try {
+                watcher.close();
+            }
+            catch { }
+        }
+    };
+}
+//# sourceMappingURL=watch-bridge.js.map

package/dist/memory/watch-bridge.js.map

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

package/dist/plugins/boundary-file-read.d.ts

@@ -0,0 +1,13 @@
+export type BoundaryFileOpenResult = {
+    ok: true;
+    fd: number;
+} | {
+    ok: false;
+    reason: "path" | "unsafe" | "hardlink" | "stat";
+};
+export declare function openBoundaryFileSync(params: {
+    absolutePath: string;
+    rootPath: string;
+    rejectHardlinks?: boolean;
+}): BoundaryFileOpenResult;
+//# sourceMappingURL=boundary-file-read.d.ts.map

package/dist/plugins/boundary-file-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundary-file-read.d.ts","sourceRoot":"","sources":["../../src/plugins/boundary-file-read.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,sBAAsB,GAC9B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACxB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAA;CAAE,CAAC;AAEnE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,sBAAsB,CAyBzB"}

package/dist/plugins/boundary-file-read.js

@@ -0,0 +1,31 @@
+import fs from "node:fs";
+import { isPathInside, safeRealpathSync } from "./path-safety.js";
+export function openBoundaryFileSync(params) {
+    const rejectHardlinks = params.rejectHardlinks ?? true;
+    const rootRealPath = safeRealpathSync(params.rootPath);
+    const fileRealPath = safeRealpathSync(params.absolutePath);
+    if (!rootRealPath || !fileRealPath) {
+        return { ok: false, reason: "path" };
+    }
+    if (!isPathInside(rootRealPath, fileRealPath)) {
+        return { ok: false, reason: "unsafe" };
+    }
+    let stat;
+    try {
+        stat = fs.lstatSync(fileRealPath);
+    }
+    catch {
+        return { ok: false, reason: "stat" };
+    }
+    if (rejectHardlinks && typeof stat.nlink === "number" && stat.nlink > 1) {
+        return { ok: false, reason: "hardlink" };
+    }
+    try {
+        const fd = fs.openSync(fileRealPath, "r");
+        return { ok: true, fd };
+    }
+    catch {
+        return { ok: false, reason: "path" };
+    }
+}
+//# sourceMappingURL=boundary-file-read.js.map

package/dist/plugins/boundary-file-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundary-file-read.js","sourceRoot":"","sources":["../../src/plugins/boundary-file-read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAMlE,MAAM,UAAU,oBAAoB,CAAC,MAIpC;IACC,MAAM,eAAe,GAAG,MAAM,CAAC,eAAe,IAAI,IAAI,CAAC;IACvD,MAAM,YAAY,GAAG,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvD,MAAM,YAAY,GAAG,gBAAgB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC3D,IAAI,CAAC,YAAY,IAAI,CAAC,YAAY,EAAE,CAAC;QACnC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACvC,CAAC;IACD,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,YAAY,CAAC,EAAE,CAAC;QAC9C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IACzC,CAAC;IACD,IAAI,IAAc,CAAC;IACnB,IAAI,CAAC;QACH,IAAI,GAAG,EAAE,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACvC,CAAC;IACD,IAAI,eAAe,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QACxE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC3C,CAAC;IACD,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;QAC1C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACvC,CAAC;AACH,CAAC"}