om-memory-system 3.0.0

package/dist/adapters/pi/provider.d.ts

@@ -0,0 +1,50 @@
+import type { CaptureSummary, CaptureSummaryRequest } from "../../core/host.js";
+/**
+ * Structural view of a Pi ExtensionContext's model surfaces, so the resolver
+ * stays testable without importing Pi runtime types.
+ */
+export interface PiModelContext {
+    modelRegistry: any;
+    model: any;
+}
+/**
+ * Active-model-first resolution: the explicit `piProvider`/`piModel`
+ * configuration when both are set, otherwise the active `ctx.model`.
+ */
+export declare function resolveModelFromContext(ctx: PiModelContext): PiModelHandle | null;
+/**
+ * Structural view of the pieces we use from Pi's ModelRegistry/Model so the
+ * bridge stays testable without importing Pi runtime types.
+ */
+export interface PiModelCallContext {
+    systemPrompt?: string;
+    messages: Array<{
+        role: "user";
+        content: string;
+        timestamp: number;
+    }>;
+}
+export interface PiModelHandle {
+    provider: string;
+    modelId: string;
+    complete(context: PiModelCallContext): Promise<PiAssistantReply>;
+}
+export interface PiAssistantReply {
+    content: Array<{
+        type: string;
+        text?: string;
+    }>;
+    stopReason?: string;
+    errorMessage?: string;
+}
+/**
+ * Bridge the shared structured-extraction port onto Pi's provider-aware model
+ * runtime (`ctx.modelRegistry.complete()`). The Pi adapter resolves the model
+ * (active `ctx.model`, or explicit `piProvider`/`piModel` configuration) and
+ * supplies it through `resolveModel`; failures surface as exceptions so the
+ * capture pipeline can defer or skip the work unit while manual memory
+ * operations stay available.
+ */
+export declare function createPiCaptureProvider(resolveModel: () => PiModelHandle | null): {
+    summarize(request: CaptureSummaryRequest): Promise<CaptureSummary | null>;
+};

package/dist/adapters/pi/provider.js

@@ -0,0 +1,77 @@
+import { CONFIG } from "../../config.js";
+import { buildBoundedSummaryPrompt } from "../../core/capture-context.js";
+import { buildCaptureSystemPrompt, captureSummaryToolSchema, parseCaptureSummary, } from "../../core/extraction.js";
+import { detectLanguage, getLanguageName } from "../../services/language-detector.js";
+import { log } from "../../services/logger.js";
+/**
+ * Active-model-first resolution: the explicit `piProvider`/`piModel`
+ * configuration when both are set, otherwise the active `ctx.model`.
+ */
+export function resolveModelFromContext(ctx) {
+    const registry = ctx?.modelRegistry;
+    if (!registry)
+        return null;
+    let model = null;
+    if (CONFIG.piProvider && CONFIG.piModel) {
+        model = registry.find(CONFIG.piProvider, CONFIG.piModel) ?? null;
+    }
+    if (!model)
+        model = ctx?.model ?? null;
+    if (!model)
+        return null;
+    return {
+        provider: typeof model.provider === "string" ? model.provider : "unknown",
+        modelId: typeof model.id === "string"
+            ? model.id
+            : typeof model.modelId === "string"
+                ? model.modelId
+                : "unknown",
+        complete: (context) => registry.complete(model, context),
+    };
+}
+function replyText(reply) {
+    return reply.content
+        .filter((block) => block.type === "text" && typeof block.text === "string")
+        .map((block) => block.text)
+        .join("\n")
+        .trim();
+}
+/**
+ * Bridge the shared structured-extraction port onto Pi's provider-aware model
+ * runtime (`ctx.modelRegistry.complete()`). The Pi adapter resolves the model
+ * (active `ctx.model`, or explicit `piProvider`/`piModel` configuration) and
+ * supplies it through `resolveModel`; failures surface as exceptions so the
+ * capture pipeline can defer or skip the work unit while manual memory
+ * operations stay available.
+ */
+export function createPiCaptureProvider(resolveModel) {
+    return {
+        async summarize(request) {
+            const model = resolveModel();
+            if (!model) {
+                throw new Error("omms: no Pi model available for auto-capture");
+            }
+            const targetLang = CONFIG.autoCaptureLanguage === "auto" || !CONFIG.autoCaptureLanguage
+                ? detectLanguage(request.userPrompt)
+                : CONFIG.autoCaptureLanguage;
+            const systemPrompt = buildCaptureSystemPrompt(getLanguageName(targetLang));
+            const userPrompt = buildBoundedSummaryPrompt(request.context, systemPrompt, captureSummaryToolSchema);
+            const reply = await model.complete({
+                systemPrompt,
+                messages: [{ role: "user", content: userPrompt, timestamp: Date.now() }],
+            });
+            if (reply.stopReason === "error") {
+                throw new Error(`omms: Pi extraction call failed: ${reply.errorMessage || "unknown error"}`);
+            }
+            const summary = parseCaptureSummary(replyText(reply));
+            if (!summary) {
+                log("Pi capture: model reply was not a valid capture summary", {
+                    provider: model.provider,
+                    modelId: model.modelId,
+                });
+                throw new Error("omms: Pi extraction returned an invalid summary payload");
+            }
+            return summary;
+        },
+    };
+}

package/dist/config.d.ts

@@ -0,0 +1,290 @@
+import { isPlaceholderApiKey } from "./services/ai/api-key-placeholder.js";
+interface OmmsConfig {
+    storagePath?: string;
+    userEmailOverride?: string;
+    userNameOverride?: string;
+    memory?: {
+        defaultScope?: "project" | "all-projects";
+    };
+    embeddingModel?: string;
+    embeddingDimensions?: number;
+    embeddingApiUrl?: string;
+    embeddingApiKey?: string;
+    /** Opt-in Nomic task prefixes (`search_document:` / `search_query:`). Default false. */
+    embeddingUseTaskPrefixes?: boolean;
+    similarityThreshold?: number;
+    maxMemories?: number;
+    maxProfileItems?: number;
+    injectProfile?: boolean;
+    containerTagPrefix?: string;
+    autoCaptureEnabled?: boolean;
+    autoCaptureMaxIterations?: number;
+    autoCaptureIterationTimeout?: number;
+    autoCaptureMaxRetries?: number;
+    autoCaptureMaxContextBytes?: number;
+    autoCaptureLanguage?: string;
+    memoryProvider?: "openai-chat" | "openai-responses" | "anthropic" | "minimax" | "orcarouter";
+    memoryModel?: string;
+    memoryApiUrl?: string;
+    memoryApiKey?: string;
+    memoryTemperature?: number | false;
+    memoryExtraParams?: Record<string, unknown>;
+    opencodeProvider?: string;
+    opencodeModel?: string;
+    /** Pi adapter: explicit provider/model for capture extraction. Default: inherit active Pi model. */
+    piProvider?: string;
+    piModel?: string;
+    aiSessionRetentionDays?: number;
+    webServerEnabled?: boolean;
+    webServerPort?: number;
+    webServerHost?: string;
+    webServerAuthPassword?: string;
+    webServerAuthUsername?: string;
+    webServerApiToken?: string;
+    maxVectorsPerShard?: number;
+    autoCleanupEnabled?: boolean;
+    autoCleanupRetentionDays?: number;
+    deduplicationEnabled?: boolean;
+    deduplicationSimilarityThreshold?: number;
+    userProfileAnalysisInterval?: number;
+    userProfileMaxContextBytes?: number;
+    userProfileDisplayPreferences?: number;
+    userProfileDisplayPatterns?: number;
+    userProfileDisplayWorkflows?: number;
+    userProfileStaleDays?: number;
+    userProfileInjectPreferences?: number;
+    userProfileInjectPatterns?: number;
+    userProfileInjectWorkflows?: number;
+    userProfileConfidenceDecayDays?: number;
+    userProfileChangelogRetentionCount?: number;
+    userProfileEmbeddingThresholdSameCat?: number;
+    userProfileEmbeddingThresholdSameCatWeak?: number;
+    userProfileEmbeddingThresholdCrossCat?: number;
+    userProfileEmbeddingThresholdCrossCatWeak?: number;
+    userProfileCentroidDriftThreshold?: number;
+    userProfileEmbeddingMinDescriptionLength?: number;
+    userProfileMinEvidenceForRetention?: number;
+    userProfileAutoCleanupEnabled?: boolean;
+    userProfileAutoCleanupInterval?: number;
+    userProfileValidationEnabled?: boolean;
+    showAutoCaptureToasts?: boolean;
+    showUserProfileToasts?: boolean;
+    showErrorToasts?: boolean;
+    compaction?: {
+        enabled?: boolean;
+        memoryLimit?: number;
+    };
+    chatMessage?: {
+        enabled?: boolean;
+        maxMemories?: number;
+        excludeCurrentSession?: boolean;
+        maxAgeDays?: number;
+        injectOn?: "first" | "always";
+    };
+}
+export declare function normalizeAutoCaptureMaxContextBytes(value: number): number;
+export declare function normalizeAutoCleanupRetentionDays(value: number): number;
+declare function buildConfig(fileConfig: OmmsConfig): {
+    storagePath: string;
+    userEmailOverride: string | undefined;
+    userNameOverride: string | undefined;
+    embeddingModel: string;
+    embeddingDimensions: number;
+    embeddingUseTaskPrefixes: boolean;
+    embeddingApiUrl: string | undefined;
+    embeddingApiKey: string | undefined;
+    similarityThreshold: number;
+    maxMemories: number;
+    maxProfileItems: number;
+    injectProfile: boolean;
+    containerTagPrefix: string;
+    autoCaptureEnabled: boolean;
+    autoCaptureMaxIterations: number;
+    autoCaptureIterationTimeout: number;
+    autoCaptureMaxRetries: number;
+    autoCaptureMaxContextBytes: number;
+    autoCaptureLanguage: string | undefined;
+    memoryProvider: "openai-chat" | "openai-responses" | "anthropic" | "minimax" | "orcarouter";
+    memoryModel: string | undefined;
+    memoryApiUrl: string | undefined;
+    memoryApiKey: string | undefined;
+    memoryTemperature: number | false | undefined;
+    memoryExtraParams: Record<string, unknown> | undefined;
+    opencodeProvider: string | undefined;
+    opencodeModel: string | undefined;
+    piProvider: string | undefined;
+    piModel: string | undefined;
+    autoCaptureProviderStatus: AutoCaptureProviderStatus;
+    aiSessionRetentionDays: number;
+    webServerEnabled: boolean;
+    webServerPort: number;
+    webServerHost: string;
+    webServerAuthPassword: string | undefined;
+    webServerAuthUsername: string | undefined;
+    webServerApiToken: string | undefined;
+    maxVectorsPerShard: number;
+    autoCleanupEnabled: boolean;
+    autoCleanupRetentionDays: number;
+    deduplicationEnabled: boolean;
+    deduplicationSimilarityThreshold: number;
+    userProfileAnalysisInterval: number;
+    userProfileMaxContextBytes: number;
+    userProfileDisplayPreferences: number;
+    userProfileDisplayPatterns: number;
+    userProfileDisplayWorkflows: number;
+    userProfileInjectPreferences: number;
+    userProfileInjectPatterns: number;
+    userProfileInjectWorkflows: number;
+    userProfileConfidenceDecayDays: number;
+    userProfileChangelogRetentionCount: number;
+    userProfileEmbeddingThresholdSameCat: number;
+    userProfileEmbeddingThresholdSameCatWeak: number;
+    userProfileEmbeddingThresholdCrossCat: number;
+    userProfileEmbeddingThresholdCrossCatWeak: number;
+    userProfileCentroidDriftThreshold: number;
+    userProfileEmbeddingMinDescriptionLength: number;
+    userProfileMinEvidenceForRetention: number;
+    userProfileAutoCleanupEnabled: boolean;
+    userProfileAutoCleanupInterval: number;
+    userProfileValidationEnabled: boolean;
+    userProfileStaleDays: number;
+    showAutoCaptureToasts: boolean;
+    showUserProfileToasts: boolean;
+    showErrorToasts: boolean;
+    memory: {
+        defaultScope: "project" | "all-projects" | undefined;
+    };
+    compaction: {
+        enabled: boolean | undefined;
+        memoryLimit: number | undefined;
+    };
+    chatMessage: {
+        enabled: boolean | undefined;
+        maxMemories: number | undefined;
+        excludeCurrentSession: boolean | undefined;
+        maxAgeDays: number | undefined;
+        injectOn: "first" | "always";
+    };
+};
+export declare let CONFIG: {
+    storagePath: string;
+    userEmailOverride: string | undefined;
+    userNameOverride: string | undefined;
+    embeddingModel: string;
+    embeddingDimensions: number;
+    embeddingUseTaskPrefixes: boolean;
+    embeddingApiUrl: string | undefined;
+    embeddingApiKey: string | undefined;
+    similarityThreshold: number;
+    maxMemories: number;
+    maxProfileItems: number;
+    injectProfile: boolean;
+    containerTagPrefix: string;
+    autoCaptureEnabled: boolean;
+    autoCaptureMaxIterations: number;
+    autoCaptureIterationTimeout: number;
+    autoCaptureMaxRetries: number;
+    autoCaptureMaxContextBytes: number;
+    autoCaptureLanguage: string | undefined;
+    memoryProvider: "openai-chat" | "openai-responses" | "anthropic" | "minimax" | "orcarouter";
+    memoryModel: string | undefined;
+    memoryApiUrl: string | undefined;
+    memoryApiKey: string | undefined;
+    memoryTemperature: number | false | undefined;
+    memoryExtraParams: Record<string, unknown> | undefined;
+    opencodeProvider: string | undefined;
+    opencodeModel: string | undefined;
+    piProvider: string | undefined;
+    piModel: string | undefined;
+    autoCaptureProviderStatus: AutoCaptureProviderStatus;
+    aiSessionRetentionDays: number;
+    webServerEnabled: boolean;
+    webServerPort: number;
+    webServerHost: string;
+    webServerAuthPassword: string | undefined;
+    webServerAuthUsername: string | undefined;
+    webServerApiToken: string | undefined;
+    maxVectorsPerShard: number;
+    autoCleanupEnabled: boolean;
+    autoCleanupRetentionDays: number;
+    deduplicationEnabled: boolean;
+    deduplicationSimilarityThreshold: number;
+    userProfileAnalysisInterval: number;
+    userProfileMaxContextBytes: number;
+    userProfileDisplayPreferences: number;
+    userProfileDisplayPatterns: number;
+    userProfileDisplayWorkflows: number;
+    userProfileInjectPreferences: number;
+    userProfileInjectPatterns: number;
+    userProfileInjectWorkflows: number;
+    userProfileConfidenceDecayDays: number;
+    userProfileChangelogRetentionCount: number;
+    userProfileEmbeddingThresholdSameCat: number;
+    userProfileEmbeddingThresholdSameCatWeak: number;
+    userProfileEmbeddingThresholdCrossCat: number;
+    userProfileEmbeddingThresholdCrossCatWeak: number;
+    userProfileCentroidDriftThreshold: number;
+    userProfileEmbeddingMinDescriptionLength: number;
+    userProfileMinEvidenceForRetention: number;
+    userProfileAutoCleanupEnabled: boolean;
+    userProfileAutoCleanupInterval: number;
+    userProfileValidationEnabled: boolean;
+    userProfileStaleDays: number;
+    showAutoCaptureToasts: boolean;
+    showUserProfileToasts: boolean;
+    showErrorToasts: boolean;
+    memory: {
+        defaultScope: "project" | "all-projects" | undefined;
+    };
+    compaction: {
+        enabled: boolean | undefined;
+        memoryLimit: number | undefined;
+    };
+    chatMessage: {
+        enabled: boolean | undefined;
+        maxMemories: number | undefined;
+        excludeCurrentSession: boolean | undefined;
+        maxAgeDays: number | undefined;
+        injectOn: "first" | "always";
+    };
+};
+type RuntimeConfig = ReturnType<typeof buildConfig>;
+interface AutoCaptureProviderRuntimeConfig {
+    opencodeProvider?: string;
+    opencodeModel?: string;
+    memoryProvider?: string;
+    memoryModel?: string;
+    memoryApiUrl?: string;
+    memoryApiKey?: string;
+}
+export type AutoCaptureProviderStatus = {
+    ready: true;
+    mode: "opencode" | "manual";
+    issues: [];
+} | {
+    ready: false;
+    issues: string[];
+};
+export { isPlaceholderApiKey };
+export declare function getAutoCaptureProviderStatus(config: AutoCaptureProviderRuntimeConfig): AutoCaptureProviderStatus;
+export declare function hasAutoCaptureProviderConfig(config?: RuntimeConfig): boolean;
+export declare function initConfig(directory: string): void;
+/**
+ * initConfig plus the one-time legacy store migration (decision D13).
+ *
+ * The migration only applies while the resolved store sits on a DEFAULT
+ * layout (legacy ~/.opencode-mem/data or omms ~/.omms/data). The legacy
+ * config template pinned "storagePath": "~/.opencode-mem/data" explicitly,
+ * so key-presence cannot be the skip signal; a genuinely custom store path
+ * (the user pointing storage elsewhere) skips migration entirely.
+ * OMMS_SKIP_LEGACY_MIGRATION=1 (set by the test preload) disables the
+ * automatic run without affecting resolution.
+ */
+export declare function initConfigWithLegacyMigration(directory: string): void;
+export declare function isConfigured(): boolean;
+/**
+ * The containerTagPrefix explicitly set in the merged config files, or
+ * undefined when only the default applies. The tag prefix migration warns
+ * when this is "opencode" after migration (the override matches no rows).
+ */
+export declare function getExplicitContainerTagPrefix(): string | undefined;