ai-memory-layer 2.0.0

package/dist/core/quick.js

@@ -0,0 +1,300 @@
+import { createInMemoryAdapterWithEmbeddings } from '../adapters/memory/index.js';
+import { createSQLiteAdapter, createSQLiteAdapterWithEmbeddings } from '../adapters/sqlite/index.js';
+import { createLocalEmbeddingGenerator } from '../embeddings/local.js';
+import { createOpenAIEmbeddingGenerator } from '../embeddings/openai.js';
+import { createVoyageEmbeddingGenerator } from '../embeddings/voyage.js';
+import { createCompositeExtractor, createHeuristicExtractor, createRegexExtractor, } from './extractor.js';
+import { createMemoryManager, } from './manager.js';
+import { resolveMemoryManagerPreset } from './presets.js';
+import { createSessionId } from './tokens.js';
+import { createClaudeSummarizer } from '../summarizers/claude.js';
+import { createExtractiveSummarizer } from '../summarizers/extractive.js';
+import { createOpenAISummarizer } from '../summarizers/openai.js';
+import { createClaudeExtractor, createOpenAIExtractor } from '../summarizers/extractor.js';
+import { emitMemoryEvent } from './telemetry.js';
+const QUALITY_MODE_CONFIG = {
+    fast_adoption: {
+        extractionPolicy: {
+            requireGroundingForTrusted: false,
+            minimumEvidenceCountForTrusted: 1,
+            trustPromotionThreshold: 0.55,
+            trustProvisionalThreshold: 0.15,
+            contradictionDisputeThreshold: 0.5,
+        },
+        contextPolicy: {
+            trustWeight: 0.8,
+            contradictionPenalty: 1,
+            provisionalPenalty: 0.15,
+        },
+        maintenancePolicy: {
+            trustedCoreRetentionDays: 60,
+            provisionalRetentionDays: 21,
+            reverificationCadenceDays: 60,
+            requireReconfirmationForProjectFacts: false,
+        },
+    },
+    balanced_memory: {
+        extractionPolicy: {
+            requireGroundingForTrusted: true,
+            minimumEvidenceCountForTrusted: 2,
+            trustPromotionThreshold: 0.7,
+            trustProvisionalThreshold: 0.45,
+            contradictionDisputeThreshold: 0.35,
+        },
+        contextPolicy: {
+            trustWeight: 1.3,
+            contradictionPenalty: 1.5,
+            provisionalPenalty: 0.75,
+        },
+        maintenancePolicy: {
+            trustedCoreRetentionDays: 365,
+            provisionalRetentionDays: 14,
+            reverificationCadenceDays: 30,
+            requireReconfirmationForProjectFacts: true,
+        },
+    },
+    high_fidelity_memory: {
+        extractionPolicy: {
+            requireGroundingForTrusted: true,
+            minimumEvidenceCountForTrusted: 2,
+            minConfidenceForPromotion: 'high',
+            trustPromotionThreshold: 0.82,
+            trustProvisionalThreshold: 0.55,
+            contradictionDisputeThreshold: 0.25,
+        },
+        contextPolicy: {
+            trustWeight: 1.6,
+            contradictionPenalty: 2,
+            provisionalPenalty: 1.2,
+            trustedCoreLimit: 10,
+            taskRelevantLimit: 10,
+        },
+        maintenancePolicy: {
+            trustedCoreRetentionDays: 730,
+            provisionalRetentionDays: 10,
+            reverificationCadenceDays: 14,
+            requireReconfirmationForProjectFacts: true,
+        },
+    },
+};
+function resolveQualityMode(options) {
+    if (options.qualityMode)
+        return options.qualityMode;
+    switch (options.qualityTier) {
+        case 'offline_default':
+            return 'balanced_memory';
+        case 'provider_backed':
+            return 'high_fidelity_memory';
+        case 'local_semantic':
+        default:
+            return 'balanced_memory';
+    }
+}
+function hasProviderEmbeddingEnv() {
+    return Boolean(process.env.OPENAI_API_KEY || process.env.VOYAGE_API_KEY);
+}
+function resolveScope(scope) {
+    if (typeof scope === 'string') {
+        return {
+            tenant_id: 'default',
+            system_id: 'default',
+            scope_id: scope,
+        };
+    }
+    return (scope ?? {
+        tenant_id: 'default',
+        system_id: 'default',
+        scope_id: 'default',
+    });
+}
+function resolveAdapter(adapter, path, logger, onEvent, qualityTier) {
+    if (!adapter && path === ':memory:') {
+        const memory = createInMemoryAdapterWithEmbeddings({ logger, onEvent });
+        return { adapter: memory, embeddingAdapter: memory.embeddings };
+    }
+    if (!adapter || adapter === 'sqlite') {
+        if (!qualityTier ||
+            qualityTier === 'offline_default' ||
+            qualityTier === 'local_semantic' ||
+            qualityTier === 'provider_backed' ||
+            hasProviderEmbeddingEnv()) {
+            const sqlite = createSQLiteAdapterWithEmbeddings(path, { logger, onEvent });
+            return { adapter: sqlite, embeddingAdapter: sqlite.embeddings };
+        }
+        return { adapter: createSQLiteAdapter(path, { logger, onEvent }) };
+    }
+    if (adapter === 'memory') {
+        const memory = createInMemoryAdapterWithEmbeddings({ logger, onEvent });
+        return { adapter: memory, embeddingAdapter: memory.embeddings };
+    }
+    return { adapter };
+}
+function resolveSummarizer(summarizer, options) {
+    if (!summarizer || summarizer === 'extractive') {
+        return createExtractiveSummarizer();
+    }
+    if (summarizer === 'claude') {
+        return createClaudeSummarizer(options);
+    }
+    if (summarizer === 'openai') {
+        return createOpenAISummarizer(options);
+    }
+    return summarizer;
+}
+function resolveExtractor(extractor, options) {
+    if (extractor === false) {
+        return undefined;
+    }
+    if (!extractor) {
+        return createCompositeExtractor(createHeuristicExtractor(), createRegexExtractor());
+    }
+    if (extractor === 'heuristic') {
+        return createHeuristicExtractor();
+    }
+    if (extractor === 'regex') {
+        return createRegexExtractor();
+    }
+    if (extractor === 'claude') {
+        return createClaudeExtractor(options);
+    }
+    if (extractor === 'openai') {
+        return createOpenAIExtractor(options);
+    }
+    return extractor;
+}
+function resolveEmbeddingGenerator(embedding, embeddingAdapter, qualityTier) {
+    if (embedding === false) {
+        return undefined;
+    }
+    if (typeof embedding === 'function') {
+        return embedding;
+    }
+    if (!embeddingAdapter) {
+        return undefined;
+    }
+    if (process.env.OPENAI_API_KEY) {
+        return createOpenAIEmbeddingGenerator();
+    }
+    if (process.env.VOYAGE_API_KEY) {
+        return createVoyageEmbeddingGenerator();
+    }
+    if (embedding === 'local' || qualityTier === 'offline_default' || qualityTier === 'local_semantic') {
+        return createLocalEmbeddingGenerator();
+    }
+    return undefined;
+}
+function resolveCapabilityProfile(input) {
+    const storageKind = input.options.asyncAdapter
+        ? 'async_custom'
+        : !input.options.adapter && (input.options.path ?? ':memory:') === ':memory:'
+            ? 'memory'
+            : input.options.adapter === 'memory'
+                ? 'memory'
+                : input.options.adapter === 'sqlite' || input.options.path
+                    ? 'sqlite'
+                    : 'custom';
+    const extractorTier = input.options.extractor === false
+        ? 'disabled'
+        : input.options.extractor === 'claude' || input.options.extractor === 'openai'
+            ? 'provider'
+            : input.options.extractor === 'regex'
+                ? 'regex_enhanced'
+                : input.options.extractor === 'heuristic' || input.options.extractor == null
+                    ? 'local_heuristic'
+                    : typeof input.options.extractor === 'function'
+                        ? 'custom'
+                        : input.extractor
+                            ? 'configured'
+                            : 'disabled';
+    const embeddingTier = !input.embeddingGenerator && !input.resolvedAdapter.embeddingAdapter
+        ? 'disabled'
+        : process.env.OPENAI_API_KEY || process.env.VOYAGE_API_KEY
+            ? 'provider'
+            : input.embeddingGenerator
+                ? 'local_semantic'
+                : 'storage_only';
+    return {
+        qualityMode: resolveQualityMode(input.options),
+        qualityTier: input.options.qualityTier ?? 'offline_default',
+        storageKind,
+        durableStorage: storageKind === 'sqlite' && (input.options.path ?? ':memory:') !== ':memory:',
+        extractorTier,
+        embeddingTier,
+        semanticSearchEnabled: Boolean(input.embeddingGenerator && input.resolvedAdapter.embeddingAdapter),
+        providerBacked: input.options.summarizer === 'claude' ||
+            input.options.summarizer === 'openai' ||
+            input.options.extractor === 'claude' ||
+            input.options.extractor === 'openai' ||
+            embeddingTier === 'provider',
+        localFallbackActive: extractorTier !== 'provider' || embeddingTier !== 'provider',
+        nativeAddonRequiredAtBootstrap: storageKind === 'sqlite',
+    };
+}
+export function createMemory(options = {}) {
+    return createMemoryInternal(options);
+}
+export function createMemoryWithAsyncAdapter(options) {
+    return createMemoryInternal(options);
+}
+function createMemoryInternal(options) {
+    const scope = resolveScope(options.scope);
+    const preset = resolveMemoryManagerPreset(options.preset);
+    const qualityMode = resolveQualityMode(options);
+    const qualityConfig = QUALITY_MODE_CONFIG[qualityMode];
+    const resolvedAdapter = options.asyncAdapter
+        ? { adapter: undefined, embeddingAdapter: options.embeddingAdapter }
+        : resolveAdapter(options.adapter, options.path ?? ':memory:', options.logger, options.onEvent, options.qualityTier);
+    const summarizer = resolveSummarizer(options.summarizer, options.summarizerOptions);
+    const extractor = resolveExtractor(options.extractor, options.extractorOptions);
+    const embeddingAdapter = options.embeddingAdapter ?? resolvedAdapter.embeddingAdapter;
+    const embeddingGenerator = resolveEmbeddingGenerator(options.embeddingGenerator, embeddingAdapter, options.qualityTier ?? 'offline_default');
+    const manager = createMemoryManager({
+        ...(options.asyncAdapter
+            ? { asyncAdapter: options.asyncAdapter }
+            : { adapter: resolvedAdapter.adapter }),
+        scope,
+        sessionId: options.sessionId ?? createSessionId(scope),
+        summarizer,
+        extractor,
+        embeddingAdapter,
+        embeddingGenerator,
+        logger: options.logger,
+        onEvent: options.onEvent,
+        eventEmitter: options.eventEmitter,
+        redactText: options.redactText,
+        autoCompact: options.autoCompact ?? preset.autoCompact,
+        autoExtract: options.autoExtract ?? (extractor ? preset.autoExtract : false),
+        crossScopeLevel: options.crossScopeLevel ?? preset.crossScopeLevel,
+        monitorPolicy: {
+            ...preset.monitorPolicy,
+            ...qualityConfig.monitorPolicy,
+            ...options.policies?.monitor,
+        },
+        extractionPolicy: {
+            ...preset.extractionPolicy,
+            ...qualityConfig.extractionPolicy,
+            ...options.policies?.extraction,
+        },
+        contextPolicy: {
+            ...preset.contextPolicy,
+            ...qualityConfig.contextPolicy,
+            ...options.policies?.context,
+        },
+        maintenancePolicy: {
+            ...preset.maintenancePolicy,
+            ...qualityConfig.maintenancePolicy,
+            ...options.policies?.maintenance,
+        },
+        failurePolicy: options.failurePolicy,
+        tokenEstimator: options.tokenEstimator,
+    });
+    emitMemoryEvent('capability', scope, { logger: options.logger, onEvent: options.onEvent }, 0, resolveCapabilityProfile({
+        options,
+        resolvedAdapter,
+        scope,
+        extractor,
+        embeddingGenerator,
+    }));
+    return manager;
+}
+//# sourceMappingURL=quick.js.map

package/dist/core/quick.js.map

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

package/dist/core/retrieval.d.ts

@@ -0,0 +1,29 @@
+import type { MemoryScope } from '../contracts/identity.js';
+import type { ContextPolicy } from '../contracts/policy.js';
+import type { KnowledgeMemory, SearchOptions } from '../contracts/types.js';
+export declare function getClassImportanceScore(knowledge: KnowledgeMemory, policy?: Pick<Required<ContextPolicy>, 'classImportanceOverrides'>): number;
+export declare function getEvidenceDensityScore(knowledge: KnowledgeMemory, policy: Pick<Required<ContextPolicy>, 'evidenceSaturationCount'>): number;
+export declare function getScopeRelationScore(current: MemoryScope, candidate: KnowledgeMemory, policy: Pick<Required<ContextPolicy>, 'collaborationScopeScore' | 'systemScopeScore' | 'tenantScopeScore'>): number;
+export declare function getLineageScore(currentScopeId: string, candidateScopeId: string): number;
+export declare function rankKnowledge(input: {
+    knowledge: KnowledgeMemory;
+    lexicalScore: number;
+    semanticScore: number;
+    recencyScore: number;
+    importanceScore: number;
+    policy: Required<ContextPolicy>;
+    scope: MemoryScope;
+    relevanceTexts?: string[];
+    preferLocalTrusted?: boolean;
+    preferLineageMemory?: boolean;
+}): {
+    finalScore: number;
+    trustScore: number;
+    classImportanceScore: number;
+    evidenceDensityScore: number;
+    objectiveLinkScore: number;
+    scopeRelationScore: number;
+    lineageScore: number;
+};
+export declare function matchesKnowledgeSearchOptions(knowledge: KnowledgeMemory, options?: SearchOptions): boolean;
+//# sourceMappingURL=retrieval.d.ts.map

package/dist/core/retrieval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval.d.ts","sourceRoot":"","sources":["../../src/core/retrieval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAgC5E,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,eAAe,EAC1B,MAAM,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,0BAA0B,CAAC,GACjE,MAAM,CAMR;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,eAAe,EAC1B,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,yBAAyB,CAAC,GAC/D,MAAM,CAER;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,eAAe,EAC1B,MAAM,EAAE,IAAI,CACV,QAAQ,CAAC,aAAa,CAAC,EACvB,yBAAyB,GAAG,kBAAkB,GAAG,kBAAkB,CACpE,GACA,MAAM,CA0BR;AAED,wBAAgB,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAexF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,SAAS,EAAE,eAAe,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;IAChC,KAAK,EAAE,WAAW,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,GAAG;IACF,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;CACtB,CAqDA;AAED,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,eAAe,EAC1B,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAsBT"}

package/dist/core/retrieval.js

@@ -0,0 +1,150 @@
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .split(/[^a-z0-9]+/g)
+        .filter((token) => token.length > 1);
+}
+function overlapScore(source, targets) {
+    const sourceTokens = new Set(tokenize(source));
+    if (sourceTokens.size === 0)
+        return 0;
+    const targetTokens = new Set(targets.flatMap((target) => tokenize(target)));
+    if (targetTokens.size === 0)
+        return 0;
+    let matches = 0;
+    for (const token of sourceTokens) {
+        if (targetTokens.has(token))
+            matches += 1;
+    }
+    return matches / sourceTokens.size;
+}
+const DEFAULT_CLASS_IMPORTANCE = {
+    identity: 1,
+    constraint: 0.95,
+    preference: 0.85,
+    strategy: 0.8,
+    procedure: 0.75,
+    project_fact: 0.6,
+    episodic_fact: 0.4,
+    anti_pattern: 0.45,
+};
+export function getClassImportanceScore(knowledge, policy) {
+    const override = policy?.classImportanceOverrides?.[knowledge.knowledge_class];
+    if (override != null) {
+        return override;
+    }
+    return DEFAULT_CLASS_IMPORTANCE[knowledge.knowledge_class] ?? 0.5;
+}
+export function getEvidenceDensityScore(knowledge, policy) {
+    return Math.min(1, knowledge.evidence_count / Math.max(1, policy.evidenceSaturationCount));
+}
+export function getScopeRelationScore(current, candidate, policy) {
+    const currentWorkspaceId = current.workspace_id ?? 'default';
+    const currentCollaborationId = current.collaboration_id ?? '';
+    if (candidate.tenant_id === current.tenant_id &&
+        candidate.system_id === current.system_id &&
+        candidate.workspace_id === currentWorkspaceId &&
+        candidate.collaboration_id === currentCollaborationId &&
+        candidate.scope_id === current.scope_id) {
+        return 1;
+    }
+    if (candidate.tenant_id === current.tenant_id &&
+        currentCollaborationId.length > 0 &&
+        candidate.collaboration_id === currentCollaborationId) {
+        return policy.collaborationScopeScore;
+    }
+    if (candidate.tenant_id === current.tenant_id && candidate.system_id === current.system_id) {
+        return policy.systemScopeScore;
+    }
+    if (candidate.tenant_id === current.tenant_id) {
+        return policy.tenantScopeScore;
+    }
+    return 0;
+}
+export function getLineageScore(currentScopeId, candidateScopeId) {
+    if (currentScopeId === candidateScopeId)
+        return 1;
+    const split = (value) => value.split(/[/:>|]/g).filter(Boolean);
+    const currentParts = split(currentScopeId);
+    const candidateParts = split(candidateScopeId);
+    let shared = 0;
+    while (shared < currentParts.length &&
+        shared < candidateParts.length &&
+        currentParts[shared] === candidateParts[shared]) {
+        shared += 1;
+    }
+    if (shared === 0)
+        return 0;
+    return shared / Math.max(currentParts.length, candidateParts.length);
+}
+export function rankKnowledge(input) {
+    const { knowledge, policy } = input;
+    const trustScore = knowledge.trust_score ?? 0;
+    const classImportanceScore = getClassImportanceScore(knowledge, policy);
+    const evidenceDensityScore = getEvidenceDensityScore(knowledge, policy);
+    const objectiveLinkScore = input.relevanceTexts && input.relevanceTexts.length > 0
+        ? overlapScore(knowledge.fact, input.relevanceTexts)
+        : 0;
+    const scopeRelationScore = getScopeRelationScore(input.scope, knowledge, policy);
+    const lineageScore = input.preferLineageMemory && knowledge.scope_id !== input.scope.scope_id
+        ? getLineageScore(input.scope.scope_id, knowledge.scope_id)
+        : 0;
+    const localTrustedBonus = input.preferLocalTrusted &&
+        trustScore >= policy.localTrustedThreshold &&
+        knowledge.scope_id === input.scope.scope_id
+        ? policy.localTrustedBonus
+        : 0;
+    const lineageBonus = input.preferLineageMemory ? lineageScore * policy.lineageWeight : 0;
+    const unrelatedCrossScopePenalty = input.preferLineageMemory && knowledge.scope_id !== input.scope.scope_id
+        ? (1 - lineageScore) * policy.unrelatedLineagePenalty
+        : 0;
+    const provisionalPenalty = knowledge.knowledge_state === 'provisional' ? policy.provisionalPenalty : 0;
+    const finalScore = input.lexicalScore * policy.lexicalWeight +
+        input.semanticScore * policy.semanticWeight +
+        input.recencyScore * policy.recencyWeight +
+        input.importanceScore * policy.importanceWeight +
+        trustScore * policy.trustWeight +
+        classImportanceScore * policy.durabilityWeight +
+        evidenceDensityScore * policy.evidenceWeight +
+        objectiveLinkScore * policy.objectiveLinkWeight +
+        scopeRelationScore * policy.scopeRelationWeight +
+        localTrustedBonus +
+        lineageBonus -
+        unrelatedCrossScopePenalty -
+        knowledge.contradiction_score * policy.contradictionPenalty -
+        provisionalPenalty;
+    return {
+        finalScore,
+        trustScore,
+        classImportanceScore,
+        evidenceDensityScore,
+        objectiveLinkScore,
+        scopeRelationScore,
+        lineageScore,
+    };
+}
+export function matchesKnowledgeSearchOptions(knowledge, options) {
+    if (!options)
+        return true;
+    if (!options.includeProvisional && knowledge.knowledge_state === 'provisional') {
+        return false;
+    }
+    if (!options.includeDisputed && knowledge.knowledge_state === 'disputed') {
+        return false;
+    }
+    if (options.minimumTrustScore != null && knowledge.trust_score < options.minimumTrustScore) {
+        return false;
+    }
+    if (options.knowledgeStates && options.knowledgeStates.length > 0) {
+        if (!options.knowledgeStates.includes(knowledge.knowledge_state)) {
+            return false;
+        }
+    }
+    if (options.knowledgeClasses && options.knowledgeClasses.length > 0) {
+        if (!options.knowledgeClasses.includes(knowledge.knowledge_class)) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=retrieval.js.map

package/dist/core/retrieval.js.map

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

package/dist/core/runtime.d.ts

@@ -0,0 +1,67 @@
+import type { WorkItem } from '../contracts/types.js';
+import { type FormatOptions, type SessionBootstrap } from './formatter.js';
+import type { MemoryManager } from './manager.js';
+import type { MemoryContext } from './context.js';
+export interface RuntimeWorkItemSuggestion {
+    title: string;
+    kind?: WorkItem['kind'];
+    status?: WorkItem['status'];
+    detail?: string;
+}
+export interface MemoryRuntimeOptions {
+    format?: FormatOptions;
+    inferWorkItems?: (input: {
+        userInput: string;
+        assistantOutput: string;
+    }) => RuntimeWorkItemSuggestion[] | Promise<RuntimeWorkItemSuggestion[]>;
+}
+export interface BeforeModelCallInput {
+    input: string;
+    relevanceQuery?: string;
+    format?: FormatOptions;
+    asOf?: number;
+    includeProvisionalKnowledge?: boolean;
+    includeDisputedKnowledge?: boolean;
+}
+export interface BeforeModelCallResult {
+    bootstrap: SessionBootstrap;
+    context: MemoryContext;
+    bootstrapPrompt: string;
+    prompt: string;
+    messages: Array<{
+        role: 'system';
+        content: string;
+    }>;
+}
+export interface AfterModelCallInput {
+    userInput: string;
+    assistantOutput: string;
+    actors?: {
+        user?: string;
+        assistant?: string;
+    };
+    workItems?: RuntimeWorkItemSuggestion[];
+}
+export interface MemoryRuntime {
+    startSession(relevanceQuery?: string, format?: FormatOptions): Promise<{
+        bootstrap: SessionBootstrap;
+        bootstrapPrompt: string;
+    }>;
+    resumeSession(relevanceQuery?: string, format?: FormatOptions): Promise<{
+        bootstrap: SessionBootstrap;
+        bootstrapPrompt: string;
+    }>;
+    beforeModelCall(input: string | BeforeModelCallInput): Promise<BeforeModelCallResult>;
+    afterModelCall(input: AfterModelCallInput): Promise<{
+        exchange: Awaited<ReturnType<MemoryManager['processExchange']>>;
+        trackedWorkItems: WorkItem[];
+    }>;
+    wrapModelCall(modelCall: (payload: BeforeModelCallResult) => Promise<string>, input: string | BeforeModelCallInput, actors?: AfterModelCallInput['actors']): Promise<{
+        result: string;
+        runtime: BeforeModelCallResult;
+        exchange: Awaited<ReturnType<MemoryManager['processExchange']>>;
+        trackedWorkItems: WorkItem[];
+    }>;
+}
+export declare function createMemoryRuntime(manager: MemoryManager, options?: MemoryRuntimeOptions): MemoryRuntime;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/core/runtime.d.ts.map

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