@felan-ai/ext-memory 0.8.0 → 0.10.0

package/dist/local/control.js

@@ -0,0 +1,183 @@
+import { sanitizeMemoryDiagnostic } from '../diagnostics.js';
+const safeMemoryText = (value) => sanitizeMemoryDiagnostic(value).replace(/\s+/gu, ' ').trim().slice(0, 500);
+const validMemoryRunId = (value) => /^[a-zA-Z0-9_-]{1,128}$/u.test(value);
+export function createMemoryControlExtension(options) {
+    return (pi) => {
+        let lifetime = new AbortController();
+        const views = new Set();
+        let activeContext;
+        let activeSessionId;
+        let activeCwd;
+        let unsubscribeStatus;
+        let statusRefresh = 0;
+        let lifecycle = 0;
+        let startupWarningPending = false;
+        const refreshActiveStatus = async () => {
+            const refresh = ++statusRefresh;
+            const ctx = activeContext;
+            if (!ctx)
+                return;
+            const status = await options.coordinator.status(ctx.cwd);
+            if (activeContext !== ctx || refresh !== statusRefresh)
+                return;
+            updateStatus(ctx, status);
+            if (startupWarningPending) {
+                if (status.autoDisabled) {
+                    startupWarningPending = false;
+                    notify(ctx, autoDisabledWarning(status), 'warning');
+                }
+                else if (status.memoryFingerprint !== undefined)
+                    startupWarningPending = false;
+            }
+        };
+        pi.registerCommand('memory', {
+            description: 'Inspect local memory, run processing, or open the memory directory',
+            handler: async (args, ctx) => {
+                if (lifetime.signal.aborted)
+                    return;
+                const [action, ...parameters] = args.trim().split(/\s+/u);
+                const command = action?.toLowerCase() || '';
+                const generation = lifecycle;
+                const refresh = ++statusRefresh;
+                const isCurrent = () => generation === lifecycle;
+                const report = (status) => {
+                    if (!isCurrent())
+                        return;
+                    if (refresh === statusRefresh)
+                        updateStatus(ctx, status);
+                    notify(ctx, formatStatus(status));
+                };
+                const start = (operation, message) => {
+                    notify(ctx, message, 'info');
+                    void operation.then(report).catch(() => {
+                        if (!isCurrent())
+                            return;
+                        notify(ctx, 'Memory processing request failed; inspect /memory.', 'warning');
+                    });
+                };
+                if (parameters.length > 0) {
+                    notify(ctx, 'Usage: /memory | /memory run | /memory open', 'warning');
+                    return;
+                }
+                if (command === '') {
+                    try {
+                        const status = await options.coordinator.status(ctx.cwd);
+                        if (!isCurrent() || lifetime.signal.aborted)
+                            return;
+                        const view = options.presentation.showHistory(ctx, options.agentDir, formatStatus(status), lifetime.signal);
+                        views.add(view);
+                        try {
+                            await view;
+                        }
+                        finally {
+                            views.delete(view);
+                        }
+                    }
+                    catch {
+                        if (isCurrent() && !lifetime.signal.aborted)
+                            notify(ctx, 'Memory overview could not be opened.', 'warning');
+                    }
+                    return;
+                }
+                if (command === 'run') {
+                    const operation = options.coordinator.status(ctx.cwd).then((status) => {
+                        const retry = status.autoDisabled !== undefined
+                            || (status.nextRetryAt !== undefined && Date.parse(status.nextRetryAt) > Date.now());
+                        return retry
+                            ? options.coordinator.retryProject(ctx.cwd)
+                            : options.coordinator.runNow(ctx.cwd);
+                    });
+                    start(operation, 'Memory processing requested.');
+                    return;
+                }
+                if (command === 'open') {
+                    const directory = await options.coordinator.canonicalDirectory(ctx.cwd);
+                    if (!isCurrent() || lifetime.signal.aborted)
+                        return;
+                    await options.presentation.openDirectory(directory, lifetime.signal);
+                    if (isCurrent())
+                        notify(ctx, 'Opened canonical local memory.', 'info');
+                    return;
+                }
+                notify(ctx, 'Usage: /memory | /memory run | /memory open', 'warning');
+            },
+        });
+        pi.on('session_start', async (_event, ctx) => {
+            const sessionId = ctx.sessionManager.getSessionId();
+            const replacement = activeSessionId !== sessionId || activeCwd !== ctx.cwd;
+            if (replacement) {
+                lifetime.abort();
+                await Promise.allSettled([...views]);
+                lifetime = new AbortController();
+                lifecycle += 1;
+                startupWarningPending = true;
+            }
+            activeContext = ctx;
+            activeSessionId = sessionId;
+            activeCwd = ctx.cwd;
+            const generation = lifecycle;
+            unsubscribeStatus?.();
+            unsubscribeStatus = options.coordinator.subscribeStatusChanges(() => {
+                if (generation !== lifecycle)
+                    return;
+                void refreshActiveStatus().catch(() => { });
+            });
+            try {
+                await refreshActiveStatus();
+            }
+            catch { }
+        });
+        pi.on('session_shutdown', async (_event, ctx) => {
+            if (activeSessionId !== ctx.sessionManager.getSessionId() || activeCwd !== ctx.cwd)
+                return;
+            lifecycle += 1;
+            statusRefresh += 1;
+            activeContext = undefined;
+            activeSessionId = undefined;
+            activeCwd = undefined;
+            startupWarningPending = false;
+            unsubscribeStatus?.();
+            unsubscribeStatus = undefined;
+            await pi.ui.removeStatus('memory').catch(() => { });
+            lifetime.abort();
+            await Promise.allSettled([...views]);
+        });
+        pi.on('model_select', ({ model }) => {
+            options.coordinator.setSelectedModel(model);
+        });
+        function updateStatus(ctx, status) {
+            const pending = status.pendingCheckpoints > 0 ? `${status.pendingCheckpoints} pending` : undefined;
+            const activity = status.state === 'processing' ? 'processing'
+                : status.nextRetryAt && Date.parse(status.nextRetryAt) > Date.now() ? 'backoff' : undefined;
+            const text = !status.enabled ? 'Memory: disabled'
+                : activity ? `Memory: ${[activity, pending].filter(Boolean).join(' · ')}`
+                    : pending ? `Memory: ${pending}` : undefined;
+            void (text === undefined ? pi.ui.removeStatus('memory') : pi.ui.status({ id: 'memory', kind: 'status', key: 'memory', value: { kind: 'text', text }, fallback: text })).catch(() => { });
+        }
+        function formatStatus(status) {
+            const enabled = status.enabled ? 'enabled' : 'disabled';
+            const details = [`Local memory: ${enabled}`, status.state, `${status.pendingCheckpoints} pending`];
+            if (status.consecutiveFailures)
+                details.push(`${status.consecutiveFailures} consecutive failures`);
+            if (status.nextRetryAt)
+                details.push(`retry at ${safeMemoryText(status.nextRetryAt)}`);
+            if (status.lastRunId && validMemoryRunId(status.lastRunId))
+                details.push(`run ${status.lastRunId}`);
+            if (status.autoDisabled)
+                details.push(autoDisabledWarning(status));
+            if (status.message)
+                details.push(safeMemoryText(status.message));
+            return details.join(' · ');
+        }
+        function autoDisabledWarning(status) {
+            const disabled = status.autoDisabled;
+            const run = validMemoryRunId(disabled.runId) ? ` Run: ${disabled.runId}.` : '';
+            const reason = safeMemoryText(disabled.reason) || 'repeated failures';
+            return `Memory processing automatically disabled for this project: ${reason}.${run} Open /memory to inspect the run; use /memory run to recover.`;
+        }
+        function notify(ctx, message, level = 'info') {
+            void pi.ui.notify({ text: message, level }).catch(() => { });
+        }
+    };
+}
+//# sourceMappingURL=control.js.map

package/dist/local/control.js.map

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

package/dist/local/coordinator.d.ts

@@ -0,0 +1,93 @@
+import { LocalMemoryStore } from './store.js';
+import type { MemoryContext } from './context.js';
+import { type MemoryHost, type MemoryProcessingState, type MemorySnapshot, type MemoryStatus, type SessionCheckpoint } from '../index.js';
+import { type ModelsService, type Api, type Classifier, type Model } from '@felan-ai/agent-core';
+import type { LocalMemoryLeaseOptions } from './lease.js';
+import type { LocalMemoryProject } from './project.js';
+import type { LocalMemoryDreamRunner } from './dreamer.js';
+import type { LocalMemoryAttempt } from './store.js';
+import type { LocalMemoryControl } from './store.js';
+export interface ProjectContext {
+    readonly project: LocalMemoryProject;
+    readonly cwd: string;
+    readonly sessionDir?: string;
+    readonly store: LocalMemoryStore;
+    ready: Promise<void> | undefined;
+    initialized: boolean;
+    recovery: Promise<void> | undefined;
+    recoveryAbort: AbortController | undefined;
+    recoveryRetryAt: number | undefined;
+    recoveryCompleted: boolean;
+    diagnosticsReconciled: boolean;
+    timer: ReturnType<typeof setTimeout> | undefined;
+    timerDueAt: number | undefined;
+    run: Promise<void> | undefined;
+    readonly followUps: Set<Promise<void>>;
+    abort: AbortController | undefined;
+    attempt: LocalMemoryAttempt | undefined;
+    storageBlocked: boolean;
+    writerBlocked: boolean;
+    statusSignature: string | undefined;
+    blocked: Map<string, MemoryCheckpointCursor>;
+    state: MemoryProcessingState;
+    message: string | undefined;
+}
+interface MemoryCheckpointCursor {
+    readonly leafId: string | null;
+    readonly transcriptDigest: string;
+}
+export interface LocalMemoryCoordinatorOptions {
+    readonly agentDir: string;
+    readonly models: ModelsService;
+    readonly sessionDir?: string;
+    readonly enabled?: boolean;
+    readonly unavailableReason?: string;
+    readonly debounceMs?: number;
+    readonly batchSize?: number;
+    readonly maxInputBytes?: number;
+    readonly maxTranscriptBytes?: number;
+    readonly recoveryStableMs?: number;
+    /** Delay before the single retry of a startup recovery whose session listing failed. */
+    readonly recoveryRetryMs?: number;
+    readonly recover?: boolean;
+    readonly dreamRunner?: LocalMemoryDreamRunner;
+    readonly selectedModel?: Model<Api>;
+    readonly scopedModels?: readonly Model<Api>[];
+    readonly classifier?: Classifier;
+    readonly leaseOptions?: LocalMemoryLeaseOptions;
+    readonly retryDelaysMs?: readonly [number, number];
+    readonly monitorIntervalMs?: number;
+    readonly now?: () => number;
+}
+export interface LocalMemoryStatus extends MemoryStatus {
+    readonly consecutiveFailures?: number;
+    readonly nextRetryAt?: string;
+    readonly autoDisabled?: LocalMemoryControl['autoDisabled'];
+    readonly lastRunId?: string;
+}
+export interface LocalMemorySessionHostOptions {
+    readonly cwd: string;
+    readonly sessionStorageRoot: string;
+}
+export declare class LocalMemoryCoordinator {
+    #private;
+    readonly environment: MemoryContext;
+    constructor(environment: MemoryContext, options: LocalMemoryCoordinatorOptions);
+    createSessionHost(options: LocalMemorySessionHostOptions): MemoryHost;
+    isEnabled(): boolean;
+    hasActiveWork(): boolean;
+    subscribeStatusChanges(listener: () => void): () => void;
+    setModelSelection(model: Model<Api> | undefined, scopedModels: readonly Model<Api>[] | undefined, classifier?: Classifier): void;
+    setSelectedModel(model: Model<Api> | undefined): void;
+    setEnabled(enabled: boolean): void;
+    status(cwd: string): Promise<LocalMemoryStatus>;
+    readCurrent(cwd: string, sessionStorageRoot: string): Promise<MemorySnapshot>;
+    recordCheckpoint(cwd: string, checkpoint: SessionCheckpoint): Promise<void>;
+    runNow(cwd: string): Promise<LocalMemoryStatus>;
+    retryProject(cwd: string): Promise<LocalMemoryStatus>;
+    canonicalDirectory(cwd: string): Promise<string>;
+    drain(): Promise<void>;
+    dispose(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=coordinator.d.ts.map

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

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