@openanonymity/nanomem 0.1.0 → 0.1.2

package/types/types.d.ts

@@ -77,6 +77,7 @@ export type ToolFunctionParameters = {
     properties: Record<string, {
         type: string;
         description?: string;
+        items?: object;
     }>;
     required: string[];
 };
@@ -136,6 +137,8 @@ export type ProgressEvent = {
     tool?: string | undefined;
     args?: Record<string, any> | undefined;
     result?: string | Record<string, any> | undefined;
+    toolState?: "started" | "finished" | undefined;
+    toolCallId?: string | undefined;
     paths?: string[] | undefined;
     iteration?: number | undefined;
     path?: string | undefined;
@@ -148,6 +151,16 @@ export type RetrievalResult = {
     paths: string[];
     assembledContext: string | null;
 };
+export type AugmentQueryResult = {
+    files: {
+        path: string;
+        content: string;
+    }[];
+    paths: string[];
+    reviewPrompt: string;
+    apiPrompt: string;
+    assembledContext: string | null;
+};
 export type IngestOptions = {
     updatedAt?: string | undefined;
     /**
@@ -176,11 +189,18 @@ export type ToolCallLogEntry = {
     result: string;
     toolCallId: string;
 };
+export type ToolCallEventMeta = {
+    status: "started" | "finished";
+    toolCallId: string;
+    iteration: number;
+    terminal?: boolean | undefined;
+};
 export type ToolLoopResult = {
     textResponse: string;
     terminalToolResult: {
         name: string;
         arguments: Record<string, any>;
+        result?: string;
     } | null;
     messages: LLMMessage[];
     iterations: number;
@@ -196,21 +216,24 @@ export type ToolLoopOptions = {
     maxIterations?: number | undefined;
     maxOutputTokens?: number | undefined;
     temperature?: number | undefined;
-    onToolCall?: ((name: string, args: Record<string, any>, result: string) => void) | null | undefined;
+    onToolCall?: ((name: string, args: Record<string, any>, result: string | null, meta: ToolCallEventMeta) => void) | null | undefined;
     onModelText?: ((text: string, iteration: number) => void) | null | undefined;
     onReasoning?: ((chunk: string, iteration: number) => void) | null | undefined;
     signal?: AbortSignal | null | undefined;
+    executeTerminalTool?: boolean | undefined;
 };
 export type ExtractionExecutorHooks = {
     normalizeContent?: ((content: string, path: string) => string) | undefined;
     mergeWithExisting?: ((existing: string | null, incoming: string, path: string) => string) | undefined;
     refreshIndex?: ((path: string) => Promise<void>) | undefined;
     onWrite?: ((path: string, before: string, after: string) => void) | undefined;
+    updatedAt?: string | undefined;
 };
 export type ToolExecutor = (args: any) => Promise<string>;
 export type StorageBackend = {
     init: () => Promise<void>;
     read: (path: string) => Promise<string | null>;
+    resolvePath?: ((path: string) => Promise<string | null>) | undefined;
     write: (path: string, content: string) => Promise<void>;
     delete: (path: string) => Promise<void>;
     exists: (path: string) => Promise<boolean>;
@@ -223,6 +246,7 @@ export type StorageBackend = {
 };
 export type StorageFacade = {
     read: (path: string) => Promise<string | null>;
+    resolvePath?: ((path: string) => Promise<string | null>) | undefined;
     write: (path: string, content: string) => Promise<void>;
     delete: (path: string) => Promise<void>;
     exists: (path: string) => Promise<boolean>;
@@ -239,6 +263,10 @@ export type MemoryBankLLMConfig = {
     model?: string | undefined;
     provider?: string | undefined;
     headers?: Record<string, string> | undefined;
+    enclaveURL?: string | undefined;
+    configRepo?: string | undefined;
+    attestationBundleURL?: string | undefined;
+    transport?: "ehbp" | "tls" | undefined;
 };
 export type MemoryBankConfig = {
     llm?: MemoryBankLLMConfig | undefined;
@@ -248,7 +276,7 @@ export type MemoryBankConfig = {
     storagePath?: string | undefined;
     onProgress?: ((event: ProgressEvent) => void) | undefined;
     onCompactProgress?: ((event: ProgressEvent) => void) | undefined;
-    onToolCall?: ((name: string, args: Record<string, any>, result: string) => void) | undefined;
+    onToolCall?: ((name: string, args: Record<string, any>, result: string | null, meta: ToolCallEventMeta) => void) | undefined;
     onModelText?: ((text: string) => void) | undefined;
 };
 export type Message = {
@@ -260,6 +288,87 @@ export type ChatGptSession = {
     messages: Message[];
     updatedAt: string | null;
 };
+export type MemoryImportConversation = {
+    title?: string | null | undefined;
+    messages: Message[];
+    updatedAt?: string | number | null | undefined;
+    mode?: "document" | "conversation" | undefined;
+};
+export type ImportFormat = "auto" | "normalized" | "oa-fastchat" | "chatgpt" | "messages" | "transcript" | "markdown";
+export type ImportProgressEvent = {
+    stage: "start" | "item_start" | "item_complete" | "complete";
+    totalItems: number;
+    itemIndex?: number | undefined;
+    itemTitle?: string | null | undefined;
+    itemStatus?: "processed" | "skipped" | "error" | undefined;
+    itemError?: string | null | undefined;
+};
+export type ImportDataOptions = {
+    format?: ImportFormat | undefined;
+    sourceName?: string | undefined;
+    sessionId?: string | undefined;
+    sessionTitle?: string | undefined;
+    mode?: "document" | "conversation" | undefined;
+    onProgress?: ((event: ImportProgressEvent) => void) | undefined;
+};
+export type ImportDataItemResult = {
+    title: string | null;
+    updatedAt: string | null;
+    status: "processed" | "skipped" | "error";
+    writeCalls: number;
+    error?: string | undefined;
+};
+export type ImportDataResult = {
+    totalItems: number;
+    imported: number;
+    skipped: number;
+    errors: number;
+    totalWriteCalls: number;
+    authError: string | null;
+    results: ImportDataItemResult[];
+};
+export type OmfMemoryItem = {
+    content: string;
+    category?: string | undefined;
+    tags?: string[] | undefined;
+    status?: "active" | "archived" | "expired" | undefined;
+    created_at?: string | undefined;
+    updated_at?: string | undefined;
+    expires_at?: string | undefined;
+    extensions?: Record<string, any> | undefined;
+};
+export type OmfDocument = {
+    omf: string;
+    exported_at: string;
+    source?: {
+        app?: string;
+    } | undefined;
+    memories: OmfMemoryItem[];
+};
+export type OmfImportOptions = {
+    includeArchived?: boolean | undefined;
+};
+export type OmfImportPreview = {
+    total: number;
+    filtered: number;
+    toImport: number;
+    duplicates: number;
+    newFiles: number;
+    existingFiles: number;
+    byFile: Record<string, {
+        new: number;
+        duplicate: number;
+        document?: boolean;
+    }>;
+};
+export type OmfImportResult = {
+    total: number;
+    imported: number;
+    duplicates: number;
+    skipped: number;
+    filesWritten: number;
+    errors: string[];
+};
 export type SessionSummary = {
     id: string;
     title: string;
@@ -280,11 +389,27 @@ export type BulletItem = {
 export type MemoryBank = {
     init: () => Promise<void>;
     retrieve: (query: string, conversationText?: string) => Promise<RetrievalResult | null>;
+    augmentQuery: (query: string, conversationText?: string) => Promise<AugmentQueryResult | null>;
     ingest: (messages: Message[], options?: IngestOptions) => Promise<IngestResult>;
+    importData: (input: string | unknown | MemoryImportConversation | MemoryImportConversation[] | Array<{
+        path: string;
+        content: string;
+    }>, options?: ImportDataOptions) => Promise<ImportDataResult>;
+    exportOmf: () => Promise<OmfDocument>;
+    previewOmfImport: (doc: OmfDocument, options?: OmfImportOptions) => Promise<OmfImportPreview>;
+    importOmf: (doc: OmfDocument, options?: OmfImportOptions) => Promise<OmfImportResult>;
     compact: () => Promise<{
         filesChanged: number;
         filesTotal: number;
     } | undefined>;
+    deleteContent?: ((query: string, options?: {
+        deep?: boolean;
+        mode?: string;
+    }) => Promise<{
+        status: string;
+        deleteCalls: number;
+        writes: Array<any>;
+    }>) | undefined;
     storage: StorageFacade;
     serialize: () => Promise<string>;
     toZip: () => Promise<Uint8Array>;