@dsh-enhanced/personal-memory 0.1.3

package/lib/store.d.ts

@@ -0,0 +1,98 @@
+import type { ApprovedMemoryMutation, MemoryAgentContext, MemoryExportDocument, MemoryIdentity, MemoryMutation, MemoryProposalInput, MemoryRecord, MemorySearchHit, MemorySearchRequest, MemorySnapshot, MemorySnapshotRequest, StoredMemoryProposal, StoredMemoryProposalIntent } from './types.js';
+export type MemoryStoreErrorCode = 'content-too-large' | 'duplicate-content' | 'idempotency-conflict' | 'invalid-entry' | 'invalid-identity' | 'invalid-path' | 'not-found' | 'record-limit' | 'schema-too-new' | 'version-conflict';
+export declare class MemoryStoreError extends Error {
+    readonly code: MemoryStoreErrorCode;
+    constructor(code: MemoryStoreErrorCode, message: string);
+}
+export interface MemoryStoreOptions {
+    path: string;
+    maxContentBytes?: number;
+    maxRecordsPerIdentity?: number;
+    now?: () => number;
+}
+export interface PrepareMemoryProposalIntentInput extends MemoryProposalInput {
+    proposalId: string;
+    mutationHash: string;
+}
+export type PrepareMemoryProposalStateResult = Readonly<{
+    kind: 'proposal';
+    proposal: StoredMemoryProposal;
+}> | Readonly<{
+    kind: 'intent';
+    intent: StoredMemoryProposalIntent;
+    replayed: boolean;
+}> | Readonly<{
+    kind: 'conflict';
+}>;
+export interface SaveMemoryProposalInput {
+    proposalId: string;
+    policyProposalId: string;
+    idempotencyKey: string;
+    requester: string;
+    principal: string;
+    mutation: MemoryMutation;
+    mutationHash: string;
+    expiresAt: number;
+    version: number;
+}
+export type SettleMemoryProposalInput = {
+    proposalId: string;
+    policyStatus: 'approved' | 'expired' | 'rejected';
+    policyVersion: number;
+} | {
+    proposalId: string;
+    policyStatus: 'conflicted';
+};
+export interface SettleMemoryProposalResult {
+    proposal: StoredMemoryProposal;
+    record?: MemoryRecord;
+    replayed: boolean;
+}
+export declare function hashMemoryMutation(mutation: MemoryMutation): string;
+export declare function missingPolicyProposalId(proposalId: string, ttlMs: number, dispatch: MemoryProposalInput['dispatch']): string;
+export declare function isMissingPolicyProposalId(proposalId: string): boolean;
+export declare class MemoryStore {
+    #private;
+    constructor(options: MemoryStoreOptions);
+    close(): void;
+    get(identity: MemoryIdentity, id: string): MemoryRecord | undefined;
+    list(identity: MemoryIdentity, options?: {
+        includeRemoved?: boolean;
+    }): MemoryRecord[];
+    read(context: MemoryAgentContext, ids: readonly string[]): MemoryRecord[];
+    health(): {
+        activeRecords: number;
+        removedRecords: number;
+        expiredRecords: number;
+        pendingProposals: number;
+    };
+    search(request: MemorySearchRequest): MemorySearchHit[];
+    snapshot(request: MemorySnapshotRequest): MemorySnapshot;
+    exportDocument(context: MemoryAgentContext): MemoryExportDocument;
+    normalizeMutation(mutation: MemoryMutation, options?: {
+        preflight?: boolean;
+    }): MemoryMutation;
+    prepareProposalIntent(input: PrepareMemoryProposalIntentInput): PrepareMemoryProposalStateResult;
+    getProposalIntent(proposalId: string): StoredMemoryProposalIntent | undefined;
+    listProposalIntents(limit: number): StoredMemoryProposalIntent[];
+    deferProposalIntent(proposalId: string): void;
+    /** Fail closed after Policy atomically abandons or rejects exact recovery. */
+    conflictProposalIntent(proposalId: string): {
+        proposal: StoredMemoryProposal;
+        replayed: boolean;
+    };
+    saveProposal(input: SaveMemoryProposalInput): {
+        proposal: StoredMemoryProposal;
+        replayed: boolean;
+    };
+    getProposal(proposalId: string): StoredMemoryProposal | undefined;
+    /**
+     * List proposals still pending locally, oldest first. A reconciler pairs these
+     * with the policy decision to commit approvals that were decided out of band.
+     */
+    listPendingProposals(limit: number): StoredMemoryProposal[];
+    deferPendingProposal(proposalId: string): void;
+    settleProposal(input: SettleMemoryProposalInput): SettleMemoryProposalResult;
+    applyApprovedMutation(mutation: ApprovedMemoryMutation): MemoryRecord;
+}
+//# sourceMappingURL=store.d.ts.map

package/lib/store.d.ts.map

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