@felan-ai/ext-memory 0.7.0 → 0.9.0

package/dist/local/run.js

@@ -0,0 +1,361 @@
+import { removeIfPresent } from './context.js';
+import { pruneMemoryRuns } from './run-retention.js';
+import { randomUUID } from 'node:crypto';
+import { basename, join } from 'node:path';
+import { SessionManager } from '@felan-ai/agent-core';
+import { sanitizeMemoryDiagnostic } from '../index.js';
+export const MEMORY_RUN_ENTRY = 'felan-memory-run';
+export class LocalMemoryRun {
+    environment;
+    options;
+    directory;
+    workspace;
+    sessionManager;
+    #metadata;
+    #appended = 0;
+    #journalFailure;
+    constructor(environment, options, sessionManager, metadata) {
+        this.environment = environment;
+        this.options = options;
+        this.sessionManager = sessionManager;
+        this.#metadata = metadata;
+        this.directory = join(options.projectDirectory, 'runs', metadata.sessionId);
+        this.workspace = join(this.directory, 'workspace');
+    }
+    static async reconcile(environment, options, outcome) {
+        if (!validRunId(outcome.runId))
+            throw new Error('Invalid memory run identity');
+        const metadata = await readRetainedMetadata(environment, options, outcome.runId);
+        if (!metadata)
+            return;
+        if (metadata.projectKey !== options.projectKey)
+            throw new Error('Retained memory identity does not match the project');
+        if (metadata.status !== 'started' && metadata.status !== 'worker_completed')
+            return;
+        const status = outcome.status === 'success' ? 'completed'
+            : outcome.status === 'cancelled' ? 'cancelled' : 'failed';
+        await writeRetainedMetadata(environment, options, {
+            ...metadata, status, finishedAt: outcome.at,
+            ...(status === 'failed' ? { error: 'The memory attempt failed before diagnostics were finalized' } : {}),
+        });
+        await removeTerminalWorkspace(environment, options.projectDirectory, outcome.runId);
+        await pruneMemoryRuns(environment, options);
+    }
+    static async reconcileAbandoned(environment, options, activeRunIds, now = Date.now()) {
+        const runsDirectory = join(options.projectDirectory, 'runs');
+        let entries;
+        try {
+            const root = await environment.runtime.files.inspect(runsDirectory);
+            if (root.kind !== 'directory')
+                throw new Error('Invalid retained memory directory');
+            entries = await environment.runtime.listFiles(runsDirectory, { includeDirectories: true, includeOther: true });
+        }
+        catch (error) {
+            if (isMissingFile(error))
+                return;
+            throw error;
+        }
+        const active = new Set(activeRunIds);
+        for (const runId of entries) {
+            if (!validRunId(runId))
+                throw new Error('Invalid retained memory run entry');
+            const directory = join(runsDirectory, runId);
+            const stat = await environment.runtime.files.inspect(directory);
+            if (stat.kind !== 'directory')
+                throw new Error('Invalid retained memory run directory');
+            const metadata = await readRetainedMetadata(environment, options, runId);
+            if (!metadata)
+                throw new Error('Retained memory metadata is missing');
+            if (metadata.projectKey !== options.projectKey || active.has(runId)
+                || (metadata.status !== 'started' && metadata.status !== 'worker_completed'))
+                continue;
+            await writeRetainedMetadata(environment, options, {
+                ...metadata,
+                status: 'cancelled',
+                finishedAt: new Date(now).toISOString(),
+                error: 'The previous memory worker ended before completion was confirmed; evidence remains pending',
+            });
+            await removeTerminalWorkspace(environment, options.projectDirectory, runId);
+        }
+        await pruneMemoryRuns(environment, options);
+    }
+    static async create(environment, options) {
+        await privateDirectory(environment, options.projectDirectory);
+        await privateDirectory(environment, join(options.projectDirectory, 'runs'));
+        await privateDirectory(environment, options.sessionDirectory);
+        await pruneMemoryRuns(environment, options);
+        const created = SessionManager.inMemory(options.projectRoot);
+        const header = created.getHeader();
+        const sessionFile = join(options.sessionDirectory, `${header.timestamp.replace(/[:.]/gu, '-')}_${header.id}.jsonl`);
+        await environment.runtime.writeFile(sessionFile, new TextEncoder().encode(`${JSON.stringify(created.getHeader())}\n`), { noFollow: true, exclusive: true });
+        const sessionManager = created;
+        sessionManager.getSessionFile = () => sessionFile;
+        sessionManager.getSessionDir = () => options.sessionDirectory;
+        const metadata = {
+            version: 1,
+            kind: 'memory',
+            sessionId: sessionManager.getSessionId(),
+            sessionFile: basename(sessionFile),
+            projectKey: options.projectKey,
+            projectRoot: options.projectRoot,
+            startedAt: new Date().toISOString(),
+            status: 'started',
+            phase: 'materialize',
+            checkpoints: options.checkpoints,
+            baseFingerprint: options.baseFingerprint,
+        };
+        const run = new LocalMemoryRun(environment, options, sessionManager, metadata);
+        await privateDirectory(environment, run.directory);
+        await privateDirectory(environment, run.workspace);
+        sessionManager.appendSessionInfo(`Memory: ${basename(options.projectRoot)}`);
+        await run.record({});
+        return run;
+    }
+    async flushJournal() {
+        if (this.#journalFailure)
+            throw this.#journalFailure;
+        const entries = this.sessionManager.getEntries();
+        const text = entries.slice(this.#appended).map(entry => JSON.stringify(entry.type === 'message' && entry.message.role === 'assistant' && entry.message.errorMessage
+            ? { ...entry, message: { ...entry.message, errorMessage: sanitizeMemoryDiagnostic(entry.message.errorMessage) } }
+            : entry)).join('\n');
+        if (!text)
+            return;
+        try {
+            await this.environment.runtime.files.append(this.sessionManager.getSessionFile(), new TextEncoder().encode(`${text}\n`));
+            this.#appended = entries.length;
+        }
+        catch (error) {
+            this.#journalFailure = error;
+            throw error;
+        }
+    }
+    get metadata() { return this.#metadata; }
+    async record(update) {
+        const next = { ...this.#metadata, ...update };
+        this.sessionManager.appendCustomEntry(MEMORY_RUN_ENTRY, next);
+        await this.flushJournal();
+        const path = join(this.directory, 'manifest.json');
+        const temporary = `${path}.${randomUUID()}.tmp`;
+        try {
+            await this.environment.runtime.writeFile(temporary, new TextEncoder().encode(`${JSON.stringify(next, null, 2)}\n`), { noFollow: true, exclusive: true });
+            await this.environment.runtime.files.move(temporary, path);
+            this.#metadata = next;
+        }
+        finally {
+            await removeIfPresent(this.environment, temporary);
+        }
+    }
+    async model(model, thinking) {
+        await this.record({
+            phase: 'model',
+            ...(model.provider && model.id ? {
+                model: { provider: model.provider, id: model.id, ...(thinking ? { thinking } : {}) },
+            } : {}),
+        });
+    }
+    async finish(status, error) {
+        await this.record({
+            status,
+            finishedAt: new Date().toISOString(),
+            ...(error === undefined ? {} : { error: sanitizeMemoryDiagnostic(error) }),
+        });
+        await removeIfPresent(this.environment, this.workspace, { recursive: true });
+        await this.enforceRetention();
+    }
+    async enforceRetention() {
+        await pruneMemoryRuns(this.environment, {
+            ...this.options,
+            protectedRunIds: [...(this.options.protectedRunIds ?? []), this.metadata.sessionId],
+        });
+    }
+}
+const MEMORY_RUN_METADATA_BYTES = 64 * 1_024;
+const MEMORY_RUN_RECONCILE_SESSION_BYTES = 16 * 1_024 * 1_024;
+const MEMORY_RUN_STATUSES = new Set([
+    'started', 'worker_completed', 'completed', 'failed', 'cancelled', 'blocked', 'interrupted',
+]);
+const MEMORY_RUN_PHASES = new Set(['materialize', 'model', 'validate', 'publish']);
+async function readRetainedMetadata(environment, options, runId) {
+    const path = join(options.projectDirectory, 'runs', runId, 'manifest.json');
+    try {
+        for (const directory of [join(options.projectDirectory, 'runs'), join(options.projectDirectory, 'runs', runId)]) {
+            const info = await environment.runtime.files.inspect(directory);
+            if (info.kind !== 'directory')
+                throw new Error('Invalid retained memory directory');
+        }
+        const snapshot = await environment.runtime.files.snapshot(path, MEMORY_RUN_METADATA_BYTES);
+        if (snapshot.truncated)
+            throw new Error('Invalid retained memory metadata');
+        const value = JSON.parse(new TextDecoder().decode(snapshot.content));
+        if (!isMemoryRunMetadata(value, runId))
+            throw new Error('Invalid retained memory metadata');
+        return value;
+    }
+    catch (error) {
+        if (isMissingFile(error))
+            return undefined;
+        throw error;
+    }
+}
+async function writeRetainedMetadata(environment, options, metadata) {
+    if (!isMemoryRunMetadata(metadata, metadata.sessionId))
+        throw new Error('Invalid retained memory metadata');
+    const directory = join(options.projectDirectory, 'runs', metadata.sessionId);
+    const stat = await environment.runtime.files.inspect(directory);
+    if (stat.kind !== 'directory')
+        throw new Error('Invalid retained memory run directory');
+    const path = join(directory, 'manifest.json');
+    await appendReconciledSessionMetadata(environment, options.sessionDirectory, metadata);
+    const temporary = `${path}.${randomUUID()}.tmp`;
+    try {
+        const text = `${JSON.stringify(metadata, null, 2)}\n`;
+        if (Buffer.byteLength(text, 'utf8') > MEMORY_RUN_METADATA_BYTES)
+            throw new Error('Invalid retained memory metadata');
+        await environment.runtime.writeFile(temporary, new TextEncoder().encode(text), { noFollow: true, exclusive: true });
+        await environment.runtime.files.move(temporary, path);
+    }
+    finally {
+        await removeIfPresent(environment, temporary);
+    }
+}
+async function removeTerminalWorkspace(environment, projectDirectory, runId) {
+    const path = join(projectDirectory, 'runs', runId, 'workspace');
+    let info;
+    try {
+        info = await environment.runtime.files.inspect(path);
+    }
+    catch (error) {
+        if (isMissingFile(error))
+            return;
+        throw error;
+    }
+    if (info.kind === 'symlink') {
+        await removeIfPresent(environment, path);
+        return;
+    }
+    if (info.kind !== 'directory')
+        throw new Error('Invalid retained memory workspace');
+    await removeIfPresent(environment, path, { recursive: true });
+}
+async function appendReconciledSessionMetadata(environment, sessionDirectory, metadata) {
+    const directory = await environment.runtime.files.inspect(sessionDirectory);
+    if (directory.kind !== 'directory')
+        throw new Error('Invalid retained memory session directory');
+    const sessionPath = join(sessionDirectory, metadata.sessionFile);
+    const inspected = await inspectRetainedSession(environment, sessionPath, metadata);
+    const latest = inspected.latest;
+    if (latest?.status === metadata.status && latest.finishedAt === metadata.finishedAt)
+        return;
+    await environment.runtime.files.append(sessionPath, new TextEncoder().encode(`${JSON.stringify({
+        type: 'custom', customType: MEMORY_RUN_ENTRY, data: metadata, id: randomUUID(),
+        parentId: inspected.lastEntryId, timestamp: new Date().toISOString(),
+    })}\n`), inspected.stat);
+}
+async function inspectRetainedSession(environment, sessionPath, metadata) {
+    const snapshot = await environment.runtime.files.snapshot(sessionPath, MEMORY_RUN_RECONCILE_SESSION_BYTES);
+    if (snapshot.truncated)
+        throw new Error('Invalid or oversized retained memory session file');
+    const text = new TextDecoder().decode(snapshot.content);
+    const opened = snapshot.info;
+    if (!text.endsWith('\n'))
+        throw new Error('Retained memory session is incomplete');
+    const lines = text.slice(0, -1).split('\n');
+    const header = parseRecord(lines.shift());
+    if (header?.type !== 'session' || header.id !== metadata.sessionId || header.cwd !== metadata.projectRoot) {
+        throw new Error('Retained memory session identity does not match its metadata');
+    }
+    const ids = new Set();
+    let ownershipProven = false;
+    let latest;
+    let lastEntryId = null;
+    for (const line of lines) {
+        const entry = parseRecord(line);
+        if (!entry || typeof entry.type !== 'string' || typeof entry.id !== 'string' || ids.has(entry.id)
+            || (entry.parentId !== null && (typeof entry.parentId !== 'string' || !ids.has(entry.parentId)))) {
+            throw new Error('Invalid retained memory session entries');
+        }
+        ids.add(entry.id);
+        lastEntryId = entry.id;
+        if (!ownershipProven) {
+            if (entry.type === 'custom' && entry.customType === MEMORY_RUN_ENTRY) {
+                if (!matchingMemoryMarker(entry.data, metadata))
+                    throw new Error('Retained memory session ownership is unverified');
+                ownershipProven = true;
+            }
+            else if (!['session_info', 'model_change', 'thinking_level_change'].includes(entry.type)) {
+                throw new Error('Retained memory session ownership is unverified');
+            }
+        }
+        if (entry.type === 'custom' && entry.customType === MEMORY_RUN_ENTRY
+            && matchingMemoryMarker(entry.data, metadata))
+            latest = entry.data;
+    }
+    if (!ownershipProven)
+        throw new Error('Retained memory session ownership is unverified');
+    return { stat: opened, lastEntryId, ...(latest ? { latest } : {}) };
+}
+function matchingMemoryMarker(value, metadata) {
+    return isMemoryRunMetadata(value, metadata.sessionId)
+        && value.sessionFile === metadata.sessionFile
+        && value.projectKey === metadata.projectKey
+        && value.projectRoot === metadata.projectRoot;
+}
+function parseRecord(value) {
+    if (!value)
+        return undefined;
+    try {
+        const parsed = JSON.parse(value);
+        return parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)
+            ? parsed
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function isMemoryRunMetadata(value, runId) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const data = value;
+    return data.version === 1 && data.kind === 'memory' && data.sessionId === runId
+        && validRunId(runId) && typeof data.sessionFile === 'string' && basename(data.sessionFile) === data.sessionFile
+        && typeof data.projectKey === 'string' && typeof data.projectRoot === 'string'
+        && typeof data.startedAt === 'string' && Number.isFinite(Date.parse(data.startedAt))
+        && typeof data.status === 'string' && MEMORY_RUN_STATUSES.has(data.status)
+        && typeof data.phase === 'string' && MEMORY_RUN_PHASES.has(data.phase)
+        && typeof data.baseFingerprint === 'string' && Array.isArray(data.checkpoints)
+        && data.checkpoints.every((checkpoint) => checkpoint && typeof checkpoint === 'object'
+            && typeof checkpoint.sessionId === 'string' && typeof checkpoint.sessionFile === 'string'
+            && (checkpoint.leafId === null || typeof checkpoint.leafId === 'string')
+            && typeof checkpoint.transcriptDigest === 'string')
+        && (data.finishedAt === undefined || (typeof data.finishedAt === 'string' && Number.isFinite(Date.parse(data.finishedAt))))
+        && (data.error === undefined || typeof data.error === 'string');
+}
+function validRunId(value) {
+    return /^[a-zA-Z0-9_-]{1,128}$/u.test(value);
+}
+function isMissingFile(error) {
+    return error !== null && typeof error === 'object' && 'code' in error && error.code === 'ENOENT';
+}
+export function memoryRunUsage(entries) {
+    const result = {};
+    for (const entry of entries) {
+        const usage = entry.type === 'compaction' ? entry.usage
+            : entry.type === 'message' && entry.message.role === 'assistant' ? entry.message.usage : undefined;
+        if (!usage)
+            continue;
+        for (const key of ['input', 'output', 'cacheRead', 'cacheWrite', 'totalTokens']) {
+            const value = usage[key];
+            if (typeof value === 'number' && Number.isFinite(value) && value >= 0)
+                result[key] = (result[key] ?? 0) + value;
+        }
+        const cost = usage.cost?.total;
+        if (typeof cost === 'number' && Number.isFinite(cost) && cost >= 0)
+            result.costUsd = (result.costUsd ?? 0) + cost;
+    }
+    return Object.keys(result).length > 0 ? result : undefined;
+}
+async function privateDirectory(environment, path) {
+    await environment.runtime.files.ensurePrivateDirectory(path, { recursive: true });
+}
+//# sourceMappingURL=run.js.map

package/dist/local/run.js.map

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

package/dist/local/store.d.ts

@@ -0,0 +1,117 @@
+import type { MemoryContext } from './context.js';
+import { type MemoryArtifact, type MemorySnapshot, type SessionCheckpoint } from '../index.js';
+import type { LocalMemoryProject } from './project.js';
+import type { LocalMemoryLease } from './lease.js';
+export declare const MEMORY_ATTEMPT_TIMEOUT_MS: number;
+export declare const MEMORY_RETRY_DELAYS_MS: readonly [60000, 300000];
+export interface StoredCheckpoint {
+    readonly checkpoint: SessionCheckpoint;
+    readonly recordedAt: string;
+    readonly acceptedUpdates?: number;
+}
+export interface ProcessedCheckpoint extends StoredCheckpoint {
+    readonly processedAt: string;
+    readonly memoryFingerprint: string;
+}
+export declare const STATE_VERSION: 1;
+export interface LocalMemoryState {
+    readonly version: typeof STATE_VERSION;
+    readonly memoryFingerprint: string;
+    readonly pending: Readonly<Record<string, StoredCheckpoint>>;
+    readonly processed: Readonly<Record<string, ProcessedCheckpoint>>;
+    readonly updatedAt: string;
+}
+export interface LocalMemoryProcessingSnapshot {
+    readonly artifact: MemoryArtifact;
+    readonly fingerprint: string;
+    readonly checkpoints: readonly StoredCheckpoint[];
+    readonly state: LocalMemoryState;
+}
+export interface LocalMemoryAttemptIdentity {
+    readonly runId: string;
+    readonly generation: number;
+}
+export interface LocalMemoryAttempt extends LocalMemoryAttemptIdentity {
+    readonly leaseToken: string;
+    readonly startedAt: string;
+    readonly deadlineAt: string;
+    readonly baseFingerprint: string;
+    readonly checkpoints: readonly StoredCheckpoint[];
+    readonly published?: {
+        readonly fingerprint: string;
+        readonly at: string;
+    };
+}
+export interface BeginLocalMemoryAttempt {
+    readonly runId: string;
+    readonly baseFingerprint: string;
+    readonly checkpoints: readonly StoredCheckpoint[];
+    readonly deadlineAt?: string;
+    readonly bypassRetryAt?: boolean;
+}
+export type LocalMemoryAttemptOutcome = {
+    readonly status: 'success';
+} | {
+    readonly status: 'failure';
+    readonly reason: string;
+} | {
+    readonly status: 'cancelled';
+    readonly reason?: string;
+};
+export interface LocalMemoryControl {
+    readonly version: 1;
+    readonly generation: number;
+    readonly consecutiveFailures: number;
+    readonly nextRetryAt?: string;
+    readonly autoDisabled?: {
+        readonly reason: string;
+        readonly runId: string;
+        readonly at: string;
+    };
+    readonly lastDisabledRunId?: string;
+    readonly activeAttempt?: LocalMemoryAttempt;
+    readonly lastOutcome?: LocalMemoryAttemptIdentity & {
+        readonly status: LocalMemoryAttemptOutcome['status'];
+        readonly at: string;
+    };
+    readonly updatedAt: string;
+}
+export declare class LocalMemoryControlError extends Error {
+    constructor(path: string);
+}
+export interface LocalMemoryStoreOptions {
+    readonly memoryPath?: string;
+    readonly retryDelaysMs?: readonly [number, number];
+}
+export declare class LocalMemoryStore {
+    #private;
+    readonly environment: MemoryContext;
+    readonly agentDir: string;
+    readonly project: LocalMemoryProject;
+    readonly projectDirectory: string;
+    readonly currentDirectory: string;
+    readonly stagingDirectory: string;
+    readonly statePath: string;
+    readonly controlPath: string;
+    readonly projectionName = ".memory";
+    constructor(environment: MemoryContext, agentDir: string, project: LocalMemoryProject, options?: LocalMemoryStoreOptions);
+    initialize(now?: number): Promise<void>;
+    readCurrent(): Promise<MemorySnapshot>;
+    projectTo(sessionStorageRoot: string, snapshot?: MemorySnapshot): Promise<MemorySnapshot>;
+    recordCheckpoint(checkpoint: SessionCheckpoint): Promise<boolean>;
+    status(): Promise<LocalMemoryState>;
+    pendingAcceptedUpdates(include?: (checkpoint: SessionCheckpoint) => boolean): Promise<number>;
+    readControl(): Promise<LocalMemoryControl>;
+    beginAttempt(lease: LocalMemoryLease, input: BeginLocalMemoryAttempt, now?: number): Promise<LocalMemoryAttempt | undefined>;
+    finishAttempt(lease: LocalMemoryLease | undefined, attempt: LocalMemoryAttemptIdentity, outcome: LocalMemoryAttemptOutcome, now?: number): Promise<LocalMemoryControl>;
+    resetProjectControl(now?: number, isLocallyEligible?: () => boolean): Promise<LocalMemoryControl>;
+    cancelActiveAttempt(now?: number): Promise<LocalMemoryControl>;
+    reconcileAbandonedAttempt(lease: LocalMemoryLease, now?: number): Promise<LocalMemoryControl>;
+    processingSnapshot(maxSessions?: number, include?: (checkpoint: SessionCheckpoint) => boolean): Promise<LocalMemoryProcessingSnapshot>;
+    createStagingDirectory(): Promise<string>;
+    commit(lease: LocalMemoryLease, baseFingerprint: string, artifact: MemoryArtifact, processed: readonly StoredCheckpoint[], attempt?: LocalMemoryAttemptIdentity): Promise<string>;
+    clearStaging(): Promise<void>;
+    get memoryPath(): string;
+    readState(): Promise<LocalMemoryState>;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/local/store.d.ts.map

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