@felan-ai/ext-memory 0.10.1 → 0.13.0

package/dist/local/coordinator.d.ts

@@ -1,47 +1,13 @@
-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 MemoryHost, 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;
@@ -51,14 +17,37 @@ export interface LocalMemoryCoordinatorOptions {
     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 writerRetryMs?: number;
     readonly now?: () => number;
 }
+export interface LocalMemoryAttachmentOptions {
+    readonly environment: MemoryContext;
+    readonly models: ModelsService;
+    readonly scheduling: boolean;
+    readonly persistent?: boolean;
+    readonly unavailableReason?: string;
+    readonly selectedModel?: Model<Api>;
+    readonly scopedModels?: readonly Model<Api>[];
+    readonly classifier?: Classifier;
+}
+export interface LocalMemoryAttachment {
+    createSessionHost(options: LocalMemorySessionHostOptions): MemoryHost;
+    readCurrent(cwd: string, sessionStorageRoot: string): Promise<MemorySnapshot>;
+    recordCheckpoint(cwd: string, checkpoint: SessionCheckpoint): Promise<void>;
+    status(cwd: string): Promise<LocalMemoryStatus>;
+    runNow(cwd: string): Promise<LocalMemoryStatus>;
+    retryProject(cwd: string): Promise<LocalMemoryStatus>;
+    canonicalDirectory(cwd: string): Promise<string>;
+    setSelectedModel(model: Model<Api> | undefined): void;
+    setModelSelection(model: Model<Api> | undefined, scopedModels: readonly Model<Api>[] | undefined, classifier?: Classifier): void;
+    setScheduling(scheduling: boolean, unavailableReason?: string): void;
+    subscribeStatusChanges(listener: () => void): () => void;
+    busy(): boolean;
+    settle(mode: 'drain' | 'force'): Promise<void>;
+    detach(): Promise<void>;
+}
 export interface LocalMemoryStatus extends MemoryStatus {
     readonly consecutiveFailures?: number;
     readonly nextRetryAt?: string;
@@ -71,23 +60,13 @@ export interface LocalMemorySessionHostOptions {
 }
 export declare class LocalMemoryCoordinator {
     #private;
-    readonly environment: MemoryContext;
-    constructor(environment: MemoryContext, options: LocalMemoryCoordinatorOptions);
-    createSessionHost(options: LocalMemorySessionHostOptions): MemoryHost;
+    constructor(options: LocalMemoryCoordinatorOptions);
+    attach(options: LocalMemoryAttachmentOptions): LocalMemoryAttachment;
     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

@@ -1 +1 @@
-{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../src/local/coordinator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../src/local/coordinator.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAA0E,KAAK,UAAU,EAA8B,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAElN,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,GAAG,EACR,KAAK,UAAU,EACf,KAAK,KAAK,EACX,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAG1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAG3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAyCrD,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,wFAAwF;IACxF,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,sBAAsB,CAAC;IAC9C,QAAQ,CAAC,YAAY,CAAC,EAAE,uBAAuB,CAAC;IAChD,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAGD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;CAClC;AAGD,MAAM,WAAW,qBAAqB;IACpC,iBAAiB,CAAC,OAAO,EAAE,6BAA6B,GAAG,UAAU,CAAC;IACtE,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC9E,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAChD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAChD,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACtD,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjD,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC;IACtD,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,EAAE,YAAY,EAAE,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,SAAS,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACjI,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrE,sBAAsB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IACzD,IAAI,IAAI,OAAO,CAAC;IAChB,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAkBD,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,kBAAkB,CAAC,cAAc,CAAC,CAAC;IAC3D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAGD,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC;AAoBD,qBAAa,sBAAsB;;gBAYrB,OAAO,EAAE,6BAA6B;IAMlD,MAAM,CAAC,OAAO,EAAE,4BAA4B,GAAG,qBAAqB;IAsDpE,SAAS,IAAI,OAAO;IAIpB,aAAa,IAAI,OAAO;IAIxB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAuBxD,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAoM5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB5B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAqqBzB"}