@raviolelabs/engram-mcp 0.2.0

package/dist/config/schema.d.ts

@@ -0,0 +1,466 @@
+import { z } from 'zod';
+export declare const EmbeddingsConfigSchema: z.ZodObject<{
+    provider: z.ZodDefault<z.ZodEnum<["ollama", "engram", "engram-hosted", "voyage", "openai", "openai-compatible"]>>;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    model: z.ZodString;
+    apiKey: z.ZodOptional<z.ZodString>;
+    dimensions: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    provider: "ollama" | "engram" | "engram-hosted" | "voyage" | "openai" | "openai-compatible";
+    model: string;
+    dimensions: number;
+    apiKey?: string | undefined;
+    baseUrl?: string | undefined;
+}, {
+    model: string;
+    apiKey?: string | undefined;
+    provider?: "ollama" | "engram" | "engram-hosted" | "voyage" | "openai" | "openai-compatible" | undefined;
+    baseUrl?: string | undefined;
+    dimensions?: number | undefined;
+}>;
+export type EmbeddingsConfig = z.infer<typeof EmbeddingsConfigSchema>;
+/**
+ * Optional, off-by-default. EngramMCP does NOT run a local LLM for property
+ * extraction by default — the calling agent (Claude/GPT/etc.) is already an
+ * LLM and should provide `title` + `tags` when it calls `add_note` or
+ * `remember_exchange`. Power users who want background auto-extraction can
+ * enable this and point at a local Ollama instance; Pro users will get
+ * hosted server-side extraction (Phase 2).
+ */
+export declare const PropertyExtractionConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    baseUrl: z.ZodDefault<z.ZodString>;
+    model: z.ZodDefault<z.ZodString>;
+    apiKey: z.ZodOptional<z.ZodString>;
+    maxTokens: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    baseUrl: string;
+    model: string;
+    enabled: boolean;
+    maxTokens: number;
+    apiKey?: string | undefined;
+}, {
+    apiKey?: string | undefined;
+    baseUrl?: string | undefined;
+    model?: string | undefined;
+    enabled?: boolean | undefined;
+    maxTokens?: number | undefined;
+}>;
+export type PropertyExtractionConfig = z.infer<typeof PropertyExtractionConfigSchema>;
+export declare const DriveOAuthSchema: z.ZodOptional<z.ZodObject<{
+    clientId: z.ZodString;
+    clientSecret: z.ZodString;
+    redirectPort: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    clientId: string;
+    clientSecret: string;
+    redirectPort: number;
+}, {
+    clientId: string;
+    clientSecret: string;
+    redirectPort?: number | undefined;
+}>>;
+export declare const NotionOAuthSchema: z.ZodOptional<z.ZodObject<{
+    clientId: z.ZodString;
+    clientSecret: z.ZodString;
+    redirectPort: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    clientId: string;
+    clientSecret: string;
+    redirectPort: number;
+}, {
+    clientId: string;
+    clientSecret: string;
+    redirectPort?: number | undefined;
+}>>;
+export declare const WhisperConfigSchema: z.ZodDefault<z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * "local" = whisper.cpp via nodejs-whisper (default, free)
+     * "engram-hosted" = Pro tier: POST audio to api.engram-mcp.com/api/whisper
+     */
+    provider: z.ZodOptional<z.ZodDefault<z.ZodEnum<["local", "engram-hosted"]>>>;
+    model: z.ZodDefault<z.ZodEnum<["tiny", "tiny.en", "base", "base.en", "small", "small.en", "medium", "medium.en"]>>;
+    language: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    model: "tiny" | "tiny.en" | "base" | "base.en" | "small" | "small.en" | "medium" | "medium.en";
+    enabled: boolean;
+    language: string;
+    provider?: "engram-hosted" | "local" | undefined;
+}, {
+    provider?: "engram-hosted" | "local" | undefined;
+    model?: "tiny" | "tiny.en" | "base" | "base.en" | "small" | "small.en" | "medium" | "medium.en" | undefined;
+    enabled?: boolean | undefined;
+    language?: string | undefined;
+}>>;
+export declare const YoutubeConfigSchema: z.ZodDefault<z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    preferLanguage: z.ZodDefault<z.ZodString>;
+    fallbackToYtdlp: z.ZodDefault<z.ZodBoolean>;
+    /** Channel RSS poll interval in ms. Configurable via config.json youtube.channelPollIntervalMs. Default 6h. */
+    channelPollIntervalMs: z.ZodOptional<z.ZodNumber>;
+    watchLaterPlaylistId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    preferLanguage: string;
+    fallbackToYtdlp: boolean;
+    channelPollIntervalMs?: number | undefined;
+    watchLaterPlaylistId?: string | undefined;
+}, {
+    enabled?: boolean | undefined;
+    preferLanguage?: string | undefined;
+    fallbackToYtdlp?: boolean | undefined;
+    channelPollIntervalMs?: number | undefined;
+    watchLaterPlaylistId?: string | undefined;
+}>>;
+export type WhisperConfig = z.infer<typeof WhisperConfigSchema>;
+export type YoutubeConfig = z.infer<typeof YoutubeConfigSchema>;
+export declare const ModuleEnabledSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+}, {
+    enabled?: boolean | undefined;
+}>;
+/**
+ * Engram cloud account config — populated by `engram-mcp pair`.
+ * This section is optional; absence means the user has not paired and
+ * all cloud features (transit poller, bridge relay) stay dormant.
+ */
+export declare const EngramAccountConfigSchema: z.ZodOptional<z.ZodObject<{
+    /** JWT for Plan J / Plan I auth — short-lived, refreshed automatically */
+    jwt: z.ZodString;
+    /** Refresh token — stored in oauth_tokens table, used to renew JWT */
+    refreshToken: z.ZodString;
+    /** Engram API key — issued by Plan I at pairing time */
+    apiKey: z.ZodString;
+    /**
+     * ID of the master key envelope persisted in module_state.
+     * The actual master key is derived at runtime from the user's passphrase
+     * and a salt stored here (never plaintext in config).
+     */
+    masterKeySalt: z.ZodString;
+    /** Pairing timestamp (ISO) — informational */
+    pairedAt: z.ZodOptional<z.ZodString>;
+    /** @deprecated baseUrl was previously configurable. It is now hardcoded
+     *  to https://api.engram-mcp.com (see src/cloud/endpoints.ts) — this field
+     *  is accepted for backward-compat parsing of older configs but ignored. */
+    baseUrl: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    jwt: string;
+    apiKey: string;
+    refreshToken: string;
+    masterKeySalt: string;
+    baseUrl?: string | undefined;
+    pairedAt?: string | undefined;
+}, {
+    jwt: string;
+    apiKey: string;
+    refreshToken: string;
+    masterKeySalt: string;
+    baseUrl?: string | undefined;
+    pairedAt?: string | undefined;
+}>>;
+export type EngramAccountConfig = z.infer<typeof EngramAccountConfigSchema>;
+export declare const SyncConfigSchema: z.ZodOptional<z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    /** @deprecated cloudBaseUrl is now hardcoded to https://api.engram-mcp.com
+     *  (see src/cloud/endpoints.ts). Field kept for legacy config parsing only. */
+    cloudBaseUrl: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    cloudBaseUrl?: string | undefined;
+}, {
+    enabled?: boolean | undefined;
+    cloudBaseUrl?: string | undefined;
+}>>;
+export type SyncConfig = z.infer<typeof SyncConfigSchema>;
+export declare const EngramConfigSchema: z.ZodObject<{
+    dataDir: z.ZodDefault<z.ZodString>;
+    embeddings: z.ZodObject<{
+        provider: z.ZodDefault<z.ZodEnum<["ollama", "engram", "engram-hosted", "voyage", "openai", "openai-compatible"]>>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        model: z.ZodString;
+        apiKey: z.ZodOptional<z.ZodString>;
+        dimensions: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        provider: "ollama" | "engram" | "engram-hosted" | "voyage" | "openai" | "openai-compatible";
+        model: string;
+        dimensions: number;
+        apiKey?: string | undefined;
+        baseUrl?: string | undefined;
+    }, {
+        model: string;
+        apiKey?: string | undefined;
+        provider?: "ollama" | "engram" | "engram-hosted" | "voyage" | "openai" | "openai-compatible" | undefined;
+        baseUrl?: string | undefined;
+        dimensions?: number | undefined;
+    }>;
+    drive: z.ZodOptional<z.ZodObject<{
+        clientId: z.ZodString;
+        clientSecret: z.ZodString;
+        redirectPort: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        clientId: string;
+        clientSecret: string;
+        redirectPort: number;
+    }, {
+        clientId: string;
+        clientSecret: string;
+        redirectPort?: number | undefined;
+    }>>;
+    notion: z.ZodOptional<z.ZodObject<{
+        clientId: z.ZodString;
+        clientSecret: z.ZodString;
+        redirectPort: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        clientId: string;
+        clientSecret: string;
+        redirectPort: number;
+    }, {
+        clientId: string;
+        clientSecret: string;
+        redirectPort?: number | undefined;
+    }>>;
+    propertyExtraction: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        baseUrl: z.ZodDefault<z.ZodString>;
+        model: z.ZodDefault<z.ZodString>;
+        apiKey: z.ZodOptional<z.ZodString>;
+        maxTokens: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        baseUrl: string;
+        model: string;
+        enabled: boolean;
+        maxTokens: number;
+        apiKey?: string | undefined;
+    }, {
+        apiKey?: string | undefined;
+        baseUrl?: string | undefined;
+        model?: string | undefined;
+        enabled?: boolean | undefined;
+        maxTokens?: number | undefined;
+    }>>;
+    whisper: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        /**
+         * "local" = whisper.cpp via nodejs-whisper (default, free)
+         * "engram-hosted" = Pro tier: POST audio to api.engram-mcp.com/api/whisper
+         */
+        provider: z.ZodOptional<z.ZodDefault<z.ZodEnum<["local", "engram-hosted"]>>>;
+        model: z.ZodDefault<z.ZodEnum<["tiny", "tiny.en", "base", "base.en", "small", "small.en", "medium", "medium.en"]>>;
+        language: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        model: "tiny" | "tiny.en" | "base" | "base.en" | "small" | "small.en" | "medium" | "medium.en";
+        enabled: boolean;
+        language: string;
+        provider?: "engram-hosted" | "local" | undefined;
+    }, {
+        provider?: "engram-hosted" | "local" | undefined;
+        model?: "tiny" | "tiny.en" | "base" | "base.en" | "small" | "small.en" | "medium" | "medium.en" | undefined;
+        enabled?: boolean | undefined;
+        language?: string | undefined;
+    }>>;
+    youtube: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        preferLanguage: z.ZodDefault<z.ZodString>;
+        fallbackToYtdlp: z.ZodDefault<z.ZodBoolean>;
+        /** Channel RSS poll interval in ms. Configurable via config.json youtube.channelPollIntervalMs. Default 6h. */
+        channelPollIntervalMs: z.ZodOptional<z.ZodNumber>;
+        watchLaterPlaylistId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        preferLanguage: string;
+        fallbackToYtdlp: boolean;
+        channelPollIntervalMs?: number | undefined;
+        watchLaterPlaylistId?: string | undefined;
+    }, {
+        enabled?: boolean | undefined;
+        preferLanguage?: string | undefined;
+        fallbackToYtdlp?: boolean | undefined;
+        channelPollIntervalMs?: number | undefined;
+        watchLaterPlaylistId?: string | undefined;
+    }>>;
+    modules: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+    }, {
+        enabled?: boolean | undefined;
+    }>>>;
+    mcp: z.ZodDefault<z.ZodObject<{
+        stdio: z.ZodDefault<z.ZodBoolean>;
+        httpPort: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        stdio: boolean;
+        httpPort: number;
+    }, {
+        stdio?: boolean | undefined;
+        httpPort?: number | undefined;
+    }>>;
+    engramAccount: z.ZodOptional<z.ZodObject<{
+        /** JWT for Plan J / Plan I auth — short-lived, refreshed automatically */
+        jwt: z.ZodString;
+        /** Refresh token — stored in oauth_tokens table, used to renew JWT */
+        refreshToken: z.ZodString;
+        /** Engram API key — issued by Plan I at pairing time */
+        apiKey: z.ZodString;
+        /**
+         * ID of the master key envelope persisted in module_state.
+         * The actual master key is derived at runtime from the user's passphrase
+         * and a salt stored here (never plaintext in config).
+         */
+        masterKeySalt: z.ZodString;
+        /** Pairing timestamp (ISO) — informational */
+        pairedAt: z.ZodOptional<z.ZodString>;
+        /** @deprecated baseUrl was previously configurable. It is now hardcoded
+         *  to https://api.engram-mcp.com (see src/cloud/endpoints.ts) — this field
+         *  is accepted for backward-compat parsing of older configs but ignored. */
+        baseUrl: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        jwt: string;
+        apiKey: string;
+        refreshToken: string;
+        masterKeySalt: string;
+        baseUrl?: string | undefined;
+        pairedAt?: string | undefined;
+    }, {
+        jwt: string;
+        apiKey: string;
+        refreshToken: string;
+        masterKeySalt: string;
+        baseUrl?: string | undefined;
+        pairedAt?: string | undefined;
+    }>>;
+    sync: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        /** @deprecated cloudBaseUrl is now hardcoded to https://api.engram-mcp.com
+         *  (see src/cloud/endpoints.ts). Field kept for legacy config parsing only. */
+        cloudBaseUrl: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        cloudBaseUrl?: string | undefined;
+    }, {
+        enabled?: boolean | undefined;
+        cloudBaseUrl?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    dataDir: string;
+    embeddings: {
+        provider: "ollama" | "engram" | "engram-hosted" | "voyage" | "openai" | "openai-compatible";
+        model: string;
+        dimensions: number;
+        apiKey?: string | undefined;
+        baseUrl?: string | undefined;
+    };
+    propertyExtraction: {
+        baseUrl: string;
+        model: string;
+        enabled: boolean;
+        maxTokens: number;
+        apiKey?: string | undefined;
+    };
+    whisper: {
+        model: "tiny" | "tiny.en" | "base" | "base.en" | "small" | "small.en" | "medium" | "medium.en";
+        enabled: boolean;
+        language: string;
+        provider?: "engram-hosted" | "local" | undefined;
+    };
+    youtube: {
+        enabled: boolean;
+        preferLanguage: string;
+        fallbackToYtdlp: boolean;
+        channelPollIntervalMs?: number | undefined;
+        watchLaterPlaylistId?: string | undefined;
+    };
+    modules: Record<string, {
+        enabled: boolean;
+    }>;
+    mcp: {
+        stdio: boolean;
+        httpPort: number;
+    };
+    drive?: {
+        clientId: string;
+        clientSecret: string;
+        redirectPort: number;
+    } | undefined;
+    notion?: {
+        clientId: string;
+        clientSecret: string;
+        redirectPort: number;
+    } | undefined;
+    engramAccount?: {
+        jwt: string;
+        apiKey: string;
+        refreshToken: string;
+        masterKeySalt: string;
+        baseUrl?: string | undefined;
+        pairedAt?: string | undefined;
+    } | undefined;
+    sync?: {
+        enabled: boolean;
+        cloudBaseUrl?: string | undefined;
+    } | undefined;
+}, {
+    embeddings: {
+        model: string;
+        apiKey?: string | undefined;
+        provider?: "ollama" | "engram" | "engram-hosted" | "voyage" | "openai" | "openai-compatible" | undefined;
+        baseUrl?: string | undefined;
+        dimensions?: number | undefined;
+    };
+    dataDir?: string | undefined;
+    drive?: {
+        clientId: string;
+        clientSecret: string;
+        redirectPort?: number | undefined;
+    } | undefined;
+    notion?: {
+        clientId: string;
+        clientSecret: string;
+        redirectPort?: number | undefined;
+    } | undefined;
+    propertyExtraction?: {
+        apiKey?: string | undefined;
+        baseUrl?: string | undefined;
+        model?: string | undefined;
+        enabled?: boolean | undefined;
+        maxTokens?: number | undefined;
+    } | undefined;
+    whisper?: {
+        provider?: "engram-hosted" | "local" | undefined;
+        model?: "tiny" | "tiny.en" | "base" | "base.en" | "small" | "small.en" | "medium" | "medium.en" | undefined;
+        enabled?: boolean | undefined;
+        language?: string | undefined;
+    } | undefined;
+    youtube?: {
+        enabled?: boolean | undefined;
+        preferLanguage?: string | undefined;
+        fallbackToYtdlp?: boolean | undefined;
+        channelPollIntervalMs?: number | undefined;
+        watchLaterPlaylistId?: string | undefined;
+    } | undefined;
+    modules?: Record<string, {
+        enabled?: boolean | undefined;
+    }> | undefined;
+    mcp?: {
+        stdio?: boolean | undefined;
+        httpPort?: number | undefined;
+    } | undefined;
+    engramAccount?: {
+        jwt: string;
+        apiKey: string;
+        refreshToken: string;
+        masterKeySalt: string;
+        baseUrl?: string | undefined;
+        pairedAt?: string | undefined;
+    } | undefined;
+    sync?: {
+        enabled?: boolean | undefined;
+        cloudBaseUrl?: string | undefined;
+    } | undefined;
+}>;
+export type EngramConfig = z.infer<typeof EngramConfigSchema>;
+export declare const defaultConfig: EngramConfig;
+//# sourceMappingURL=schema.d.ts.map

package/dist/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;EAQjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;EAMzC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;GAMhB,CAAC;AAEd,eAAO,MAAM,iBAAiB;;;;;;;;;;;;GAMjB,CAAC;AAEd,eAAO,MAAM,mBAAmB;;IAG5B;;;OAGG;;;;;;;;;;;;;;GAYH,CAAC;AAEL,eAAO,MAAM,mBAAmB;;;;IAK5B,+GAA+G;;;;;;;;;;;;;;;GAQ/G,CAAC;AAEL,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,mBAAmB;;;;;;EAE9B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,yBAAyB;IAElC,0EAA0E;;IAE1E,sEAAsE;;IAEtE,wDAAwD;;IAExD;;;;OAIG;;IAEH,8CAA8C;;IAE9C;;gFAE4E;;;;;;;;;;;;;;;;GAGnE,CAAC;AAEd,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,gBAAgB;;IAGzB;mFAC+E;;;;;;;;GAGtE,CAAC;AAEd,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAhF3B;;;WAGG;;;;;;;;;;;;;;;;;;;QAmBH,+GAA+G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAwB/G,0EAA0E;;QAE1E,sEAAsE;;QAEtE,wDAAwD;;QAExD;;;;WAIG;;QAEH,8CAA8C;;QAE9C;;oFAE4E;;;;;;;;;;;;;;;;;;;QAU5E;uFAC+E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+BjF,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,aAAa,EAAE,YAkC3B,CAAC"}

package/dist/config/schema.js

@@ -0,0 +1,171 @@
+import { z } from 'zod';
+export const EmbeddingsConfigSchema = z.object({
+    provider: z
+        .enum(['ollama', 'engram', 'engram-hosted', 'voyage', 'openai', 'openai-compatible'])
+        .default('ollama'),
+    baseUrl: z.string().url().optional(),
+    model: z.string(),
+    apiKey: z.string().optional(),
+    dimensions: z.number().int().positive().default(768),
+});
+/**
+ * Optional, off-by-default. EngramMCP does NOT run a local LLM for property
+ * extraction by default — the calling agent (Claude/GPT/etc.) is already an
+ * LLM and should provide `title` + `tags` when it calls `add_note` or
+ * `remember_exchange`. Power users who want background auto-extraction can
+ * enable this and point at a local Ollama instance; Pro users will get
+ * hosted server-side extraction (Phase 2).
+ */
+export const PropertyExtractionConfigSchema = z.object({
+    enabled: z.boolean().default(false),
+    baseUrl: z.string().url().default('http://localhost:11434'),
+    model: z.string().default('llama3.2:3b'),
+    apiKey: z.string().optional(),
+    maxTokens: z.number().int().positive().default(300),
+});
+export const DriveOAuthSchema = z
+    .object({
+    clientId: z.string(),
+    clientSecret: z.string(),
+    redirectPort: z.number().int().positive().default(7777),
+})
+    .optional();
+export const NotionOAuthSchema = z
+    .object({
+    clientId: z.string(),
+    clientSecret: z.string(),
+    redirectPort: z.number().int().positive().default(7777),
+})
+    .optional();
+export const WhisperConfigSchema = z
+    .object({
+    enabled: z.boolean().default(true),
+    /**
+     * "local" = whisper.cpp via nodejs-whisper (default, free)
+     * "engram-hosted" = Pro tier: POST audio to api.engram-mcp.com/api/whisper
+     */
+    provider: z.enum(['local', 'engram-hosted']).default('local').optional(),
+    model: z
+        .enum(['tiny', 'tiny.en', 'base', 'base.en', 'small', 'small.en', 'medium', 'medium.en'])
+        .default('small.en'),
+    language: z.string().default('auto'),
+})
+    .default({
+    enabled: true,
+    provider: 'local',
+    model: 'small.en',
+    language: 'auto',
+});
+export const YoutubeConfigSchema = z
+    .object({
+    enabled: z.boolean().default(true),
+    preferLanguage: z.string().default('en'),
+    fallbackToYtdlp: z.boolean().default(true),
+    /** Channel RSS poll interval in ms. Configurable via config.json youtube.channelPollIntervalMs. Default 6h. */
+    channelPollIntervalMs: z.number().int().positive().optional(),
+    watchLaterPlaylistId: z.string().optional(),
+})
+    .default({
+    enabled: true,
+    preferLanguage: 'en',
+    fallbackToYtdlp: true,
+});
+export const ModuleEnabledSchema = z.object({
+    enabled: z.boolean().default(true),
+});
+/**
+ * Engram cloud account config — populated by `engram-mcp pair`.
+ * This section is optional; absence means the user has not paired and
+ * all cloud features (transit poller, bridge relay) stay dormant.
+ */
+export const EngramAccountConfigSchema = z
+    .object({
+    /** JWT for Plan J / Plan I auth — short-lived, refreshed automatically */
+    jwt: z.string(),
+    /** Refresh token — stored in oauth_tokens table, used to renew JWT */
+    refreshToken: z.string(),
+    /** Engram API key — issued by Plan I at pairing time */
+    apiKey: z.string(),
+    /**
+     * ID of the master key envelope persisted in module_state.
+     * The actual master key is derived at runtime from the user's passphrase
+     * and a salt stored here (never plaintext in config).
+     */
+    masterKeySalt: z.string(), // hex-encoded 32-byte Argon2id salt
+    /** Pairing timestamp (ISO) — informational */
+    pairedAt: z.string().optional(),
+    /** @deprecated baseUrl was previously configurable. It is now hardcoded
+     *  to https://api.engram-mcp.com (see src/cloud/endpoints.ts) — this field
+     *  is accepted for backward-compat parsing of older configs but ignored. */
+    baseUrl: z.string().url().optional(),
+})
+    .optional();
+export const SyncConfigSchema = z
+    .object({
+    enabled: z.boolean().default(false),
+    /** @deprecated cloudBaseUrl is now hardcoded to https://api.engram-mcp.com
+     *  (see src/cloud/endpoints.ts). Field kept for legacy config parsing only. */
+    cloudBaseUrl: z.string().url().optional(),
+})
+    .optional();
+export const EngramConfigSchema = z.object({
+    dataDir: z.string().default('~/.engram'),
+    embeddings: EmbeddingsConfigSchema,
+    drive: DriveOAuthSchema,
+    notion: NotionOAuthSchema,
+    propertyExtraction: PropertyExtractionConfigSchema.default({
+        enabled: false,
+        baseUrl: 'http://localhost:11434',
+        model: 'llama3.2:3b',
+        maxTokens: 300,
+    }),
+    whisper: WhisperConfigSchema,
+    youtube: YoutubeConfigSchema,
+    modules: z.record(z.string(), ModuleEnabledSchema).default({}),
+    mcp: z
+        .object({
+        stdio: z.boolean().default(true),
+        httpPort: z.number().int().positive().default(7777),
+    })
+        .default({ stdio: true, httpPort: 7777 }),
+    // Plan K addition — optional; absence = not paired, all cloud features dormant
+    engramAccount: EngramAccountConfigSchema,
+    // Plan N addition — optional; ops-log bidirectional sync
+    sync: SyncConfigSchema,
+});
+export const defaultConfig = {
+    dataDir: process.env.DATA_DIR ?? '~/.engram',
+    embeddings: {
+        provider: 'ollama',
+        baseUrl: 'http://localhost:11434',
+        model: 'nomic-embed-text',
+        dimensions: 768,
+    },
+    propertyExtraction: {
+        enabled: false,
+        baseUrl: 'http://localhost:11434',
+        model: 'llama3.2:3b',
+        maxTokens: 300,
+    },
+    whisper: {
+        enabled: true,
+        provider: 'local',
+        model: 'small.en',
+        language: 'auto',
+    },
+    youtube: {
+        enabled: true,
+        preferLanguage: 'en',
+        fallbackToYtdlp: true,
+    },
+    modules: {
+        notes: { enabled: true },
+        conversations: { enabled: true },
+        drive: { enabled: true },
+        notion: { enabled: true },
+        audio: { enabled: true },
+        youtube: { enabled: true },
+    },
+    mcp: { stdio: true, httpPort: 7777 },
+};
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

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

package/dist/core/db/index.d.ts

@@ -0,0 +1,7 @@
+import Database from 'better-sqlite3';
+export declare function getDb(): Database.Database;
+export declare function closeDb(): void;
+export declare function initDb(dataDir: string): Database.Database;
+export declare function getLocalLamport(db: Database.Database): number;
+export declare function incrementLamport(db: Database.Database, deviceId: string): number;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/db/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/db/index.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAetC,wBAAgB,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAGzC;AAED,wBAAgB,OAAO,IAAI,IAAI,CAK9B;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAuBzD;AA+CD,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAS7D;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOhF"}