@jungjaehoon/mama-core 1.4.2 → 1.6.0

package/dist/memory/api.d.ts

@@ -1,55 +1,42 @@
+import { type WikiPageIndexRecord } from '../cases/wiki-page-index.js';
 import { resolveMemoryEvolution } from './evolution-engine.js';
 import { getChannelSummary, upsertChannelSummary } from './channel-summary-store.js';
-import type { MemoryKind, MemoryAgentBootstrap, MemoryAuditAck, MemoryEdge, MemoryScopeRef, MemoryStatus, ProfileSnapshot, RecallBundle, IngestConversationInput, ExtractedMemoryUnit, IngestConversationResult } from './types.js';
-interface SaveMemoryInput {
-    topic: string;
-    kind: MemoryKind;
-    summary: string;
-    details: string;
-    confidence?: number;
-    status?: MemoryStatus;
-    scopes: MemoryScopeRef[];
-    source: {
-        package: 'mama-core' | 'mcp-server' | 'standalone' | 'claude-code-plugin';
-        source_type: string;
-        user_id?: string;
-        channel_id?: string;
-        project_id?: string;
-    };
-    /** IDs to exclude from supersede candidates (e.g., sibling facts from same ingestion batch) */
-    excludeIds?: string[];
-    /**
-     * ISO 8601 date string for when the event actually occurred (e.g. "2023-01-15").
-     * Stored in the event_date column. Defaults to created_at if omitted.
-     */
-    eventDate?: string;
-}
-interface RecallMemoryOptions {
-    scopes?: MemoryScopeRef[];
-    includeProfile?: boolean;
-    includeHistory?: boolean;
-    skipGraphExpansion?: boolean;
-    topicPrefix?: string;
-}
-interface IngestMemoryInput {
-    content: string;
-    scopes?: MemoryScopeRef[];
-    source: SaveMemoryInput['source'];
-    eventDate?: string;
+import { type SearchHitDiagnostics } from '../search/search-quality.js';
+import type { MemoryAgentBootstrap, MemoryAuditAck, MemoryEdge, MemoryRecord, MemoryScopeRef, ProfileSnapshot, PublicIngestMemoryInput, PublicSaveMemoryInput, RecallBundle, IngestConversationInput, ExtractedMemoryUnit, IngestConversationResult, RecallMemoryOptions } from './types.js';
+import { type TrustedMemoryWriteOptions } from './provenance.js';
+type SaveMemoryInput = PublicSaveMemoryInput;
+type IngestMemoryInput = PublicIngestMemoryInput;
+export interface FusedHit {
+    source_type: 'decision' | 'wiki_page';
+    source_id: string;
+    record: MemoryRecord | WikiPageIndexRecord;
+    fused_rank_score: number;
+    page_type?: WikiPageIndexRecord['page_type'];
+    case_id?: string | null;
+    retrieval_diagnostics?: SearchHitDiagnostics;
 }
 export declare const LEXICAL_STOPWORDS: Set<string>;
 export declare function getLexicalQueryTokens(query: string): string[];
 export declare function loadEdgesForIds(ids: string[]): Promise<MemoryEdge[]>;
-export declare function saveMemory(input: SaveMemoryInput): Promise<{
+type SaveMemoryResult = {
     success: boolean;
     id: string;
-}>;
+    saved_decision_id?: string;
+    timeline_event_id?: string | null;
+    timeline_event_ids?: string[];
+};
+export declare function saveMemory(input: SaveMemoryInput): Promise<SaveMemoryResult>;
+export declare function saveMemoryWithTrustedProvenance(input: SaveMemoryInput, options: TrustedMemoryWriteOptions): Promise<SaveMemoryResult>;
 export declare function buildProfile(scopes: MemoryScopeRef[]): Promise<ProfileSnapshot>;
 export declare function recallMemory(query: string, options?: RecallMemoryOptions): Promise<RecallBundle>;
 export declare function ingestMemory(input: IngestMemoryInput): Promise<{
     success: boolean;
     id: string;
 }>;
+export declare function ingestWithTrustedProvenance(input: IngestMemoryInput, options: TrustedMemoryWriteOptions): Promise<{
+    success: boolean;
+    id: string;
+}>;
 export declare function evolveMemory(input: Parameters<typeof resolveMemoryEvolution>[0]): Promise<import("./evolution-engine.js").EvolutionResult>;
 export declare function buildMemoryBootstrap(params: {
     scopes: MemoryScopeRef[];
@@ -77,5 +64,6 @@ export declare function recordMemoryAudit(input: {
 declare function callExtractionLLM(prompt: string, options: NonNullable<IngestConversationInput['extract']>): Promise<ExtractedMemoryUnit[]>;
 export declare function setExtractionFn(fn: typeof callExtractionLLM | null): void;
 export declare function ingestConversation(input: IngestConversationInput): Promise<IngestConversationResult>;
+export declare function ingestConversationWithTrustedProvenance(input: IngestConversationInput, options: TrustedMemoryWriteOptions): Promise<IngestConversationResult>;
 export { upsertChannelSummary, getChannelSummary };
 //# sourceMappingURL=api.d.ts.map