@tonycasey/lisa 2.12.0 → 2.25.2

package/dist/lib/domain/errors/LlmErrors.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * LLM-specific error classes.
+ *
+ * Part of Phase 6A: LLM Provider Abstraction Layer.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LlmBudgetExceededError = exports.LlmFeatureDisabledError = exports.LlmConfigError = exports.LlmProviderError = exports.LlmDisabledError = void 0;
+const LisaError_1 = require("./LisaError");
+/**
+ * Error thrown when LLM is disabled but an LLM operation is requested.
+ */
+class LlmDisabledError extends LisaError_1.LisaError {
+    constructor(message) {
+        super(message || 'LLM features are disabled. Enable with: lisa llm config --enable', 'LLM_DISABLED');
+        this.name = 'LlmDisabledError';
+    }
+}
+exports.LlmDisabledError = LlmDisabledError;
+/**
+ * Error thrown when the LLM provider returns an error.
+ */
+class LlmProviderError extends LisaError_1.LisaError {
+    constructor(message, statusCode, data) {
+        super(message, 'LLM_PROVIDER_ERROR', { ...data, statusCode });
+        this.statusCode = statusCode;
+        this.name = 'LlmProviderError';
+    }
+}
+exports.LlmProviderError = LlmProviderError;
+/**
+ * Error thrown for invalid LLM configuration.
+ */
+class LlmConfigError extends LisaError_1.LisaError {
+    constructor(message, data) {
+        super(message, 'LLM_CONFIG_ERROR', data);
+        this.name = 'LlmConfigError';
+    }
+}
+exports.LlmConfigError = LlmConfigError;
+/**
+ * Error thrown when a specific LLM feature is disabled.
+ */
+class LlmFeatureDisabledError extends LisaError_1.LisaError {
+    constructor(feature, data) {
+        super(`LLM feature '${feature}' is disabled. Enable with: lisa llm features --enable ${feature}`, 'LLM_FEATURE_DISABLED', { ...data, feature });
+        this.feature = feature;
+        this.name = 'LlmFeatureDisabledError';
+    }
+}
+exports.LlmFeatureDisabledError = LlmFeatureDisabledError;
+/**
+ * Error thrown when the monthly LLM budget has been exceeded.
+ */
+class LlmBudgetExceededError extends LisaError_1.LisaError {
+    constructor(currentCost, budgetLimit, data) {
+        super(`Monthly LLM budget exceeded: $${currentCost.toFixed(4)} / $${budgetLimit.toFixed(2)} limit`, 'LLM_BUDGET_EXCEEDED', { ...data, currentCost, budgetLimit });
+        this.currentCost = currentCost;
+        this.budgetLimit = budgetLimit;
+        this.name = 'LlmBudgetExceededError';
+    }
+}
+exports.LlmBudgetExceededError = LlmBudgetExceededError;
+//# sourceMappingURL=LlmErrors.js.map

package/dist/lib/domain/errors/LlmErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LlmErrors.js","sourceRoot":"","sources":["../../../../src/lib/domain/errors/LlmErrors.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,2CAAwC;AAExC;;GAEG;AACH,MAAa,gBAAiB,SAAQ,qBAAS;IAC7C,YAAY,OAAgB;QAC1B,KAAK,CACH,OAAO,IAAI,kEAAkE,EAC7E,cAAc,CACf,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AARD,4CAQC;AAED;;GAEG;AACH,MAAa,gBAAiB,SAAQ,qBAAS;IAC7C,YACE,OAAe,EACC,UAAmB,EACnC,IAA8B;QAE9B,KAAK,CAAC,OAAO,EAAE,oBAAoB,EAAE,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QAH9C,eAAU,GAAV,UAAU,CAAS;QAInC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AATD,4CASC;AAED;;GAEG;AACH,MAAa,cAAe,SAAQ,qBAAS;IAC3C,YAAY,OAAe,EAAE,IAA8B;QACzD,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AALD,wCAKC;AAED;;GAEG;AACH,MAAa,uBAAwB,SAAQ,qBAAS;IACpD,YACkB,OAAe,EAC/B,IAA8B;QAE9B,KAAK,CACH,gBAAgB,OAAO,0DAA0D,OAAO,EAAE,EAC1F,sBAAsB,EACtB,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CACrB,CAAC;QAPc,YAAO,GAAP,OAAO,CAAQ;QAQ/B,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAZD,0DAYC;AAED;;GAEG;AACH,MAAa,sBAAuB,SAAQ,qBAAS;IACnD,YACkB,WAAmB,EACnB,WAAmB,EACnC,IAA8B;QAE9B,KAAK,CACH,iCAAiC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAC5F,qBAAqB,EACrB,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,CACtC,CAAC;QARc,gBAAW,GAAX,WAAW,CAAQ;QACnB,gBAAW,GAAX,WAAW,CAAQ;QAQnC,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAbD,wDAaC"}

package/dist/lib/domain/interfaces/IConsolidationService.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Consolidation Service Interface.
+ *
+ * Defines the contract for consolidating duplicate or related memory facts.
+ * Supports merging facts into a single retained fact, archiving duplicates,
+ * or keeping all facts unchanged.
+ *
+ * Part of Phase 5C: Curation & Compaction.
+ */
+/**
+ * Action to take when consolidating facts.
+ */
+export type ConsolidationAction = 'merge' | 'archive-duplicates' | 'keep-all';
+/**
+ * All valid consolidation actions.
+ */
+export declare const CONSOLIDATION_ACTION_VALUES: readonly ConsolidationAction[];
+/**
+ * Result of a consolidation operation.
+ */
+export interface IConsolidationResult {
+    /** The action that was performed */
+    readonly action: ConsolidationAction;
+    /** UUID of the retained (or newly created) fact */
+    readonly retainedUuid: string;
+    /** UUIDs of facts that were archived (expired) */
+    readonly archivedUuids: readonly string[];
+    /** Number of supersedes relationships created */
+    readonly relationshipsCreated: number;
+}
+/**
+ * Options for consolidation.
+ */
+export interface IConsolidationOptions {
+    /** UUID of the fact to keep (for archive-duplicates). Defaults to newest. */
+    retainUuid?: string;
+    /** Merged text for the new fact (for merge action). */
+    mergedText?: string;
+}
+/**
+ * Consolidation service interface.
+ *
+ * Provides operations for consolidating duplicate or related facts.
+ */
+export interface IConsolidationService {
+    /**
+     * Consolidate a set of facts.
+     *
+     * Actions:
+     * - `merge`: Create new fact with mergedText, expire all originals,
+     *   create supersedes relationships from new fact to each original
+     * - `archive-duplicates`: Keep the fact with retainUuid (or newest),
+     *   expire the rest, create supersedes relationships
+     * - `keep-all`: No-op, return empty result
+     *
+     * @param groupId - Group ID the facts belong to
+     * @param factUuids - UUIDs of facts to consolidate (minimum 2)
+     * @param action - Consolidation action to perform
+     * @param options - Additional options (retainUuid, mergedText)
+     * @throws Error if fewer than 2 UUIDs provided
+     * @throws Error if retainUuid is not in the provided UUIDs
+     */
+    consolidate(groupId: string, factUuids: readonly string[], action: ConsolidationAction, options?: IConsolidationOptions): Promise<IConsolidationResult>;
+}
+//# sourceMappingURL=IConsolidationService.d.ts.map

package/dist/lib/domain/interfaces/IConsolidationService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IConsolidationService.d.ts","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/IConsolidationService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,oBAAoB,GAAG,UAAU,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,SAAS,mBAAmB,EAI5D,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,oCAAoC;IACpC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,mDAAmD;IACnD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,kDAAkD;IAClD,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,iDAAiD;IACjD,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;;;;;;;;;;;OAgBG;IACH,WAAW,CACT,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAClC"}

package/dist/lib/domain/interfaces/IConsolidationService.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Consolidation Service Interface.
+ *
+ * Defines the contract for consolidating duplicate or related memory facts.
+ * Supports merging facts into a single retained fact, archiving duplicates,
+ * or keeping all facts unchanged.
+ *
+ * Part of Phase 5C: Curation & Compaction.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONSOLIDATION_ACTION_VALUES = void 0;
+/**
+ * All valid consolidation actions.
+ */
+exports.CONSOLIDATION_ACTION_VALUES = [
+    'merge',
+    'archive-duplicates',
+    'keep-all',
+];
+//# sourceMappingURL=IConsolidationService.js.map

package/dist/lib/domain/interfaces/IConsolidationService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IConsolidationService.js","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/IConsolidationService.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAOH;;GAEG;AACU,QAAA,2BAA2B,GAAmC;IACzE,OAAO;IACP,oBAAoB;IACpB,UAAU;CACF,CAAC"}

package/dist/lib/domain/interfaces/ICurationService.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Curation Service Interface.
+ *
+ * Defines the contract for curating memory facts — marking them as
+ * authoritative, draft, deprecated, or needing review. Also provides
+ * quality scoring to rank facts by reliability.
+ *
+ * Part of Phase 5C: Curation & Compaction.
+ */
+import type { IMemoryItem } from './types';
+/**
+ * Curation mark for a memory fact.
+ */
+export type CurationMark = 'authoritative' | 'draft' | 'deprecated' | 'needs-review';
+/**
+ * All valid curation marks.
+ */
+export declare const CURATION_MARK_VALUES: readonly CurationMark[];
+/**
+ * Check if a string is a valid CurationMark.
+ *
+ * @param value - The string to check
+ * @returns true if valid curation mark
+ */
+export declare function isValidCurationMark(value: string): value is CurationMark;
+/**
+ * Resolve a curation mark to its corresponding tag string.
+ *
+ * @param mark - The curation mark
+ * @returns Tag string, e.g. 'curated:authoritative'
+ */
+export declare function resolveCurationTag(mark: CurationMark): string;
+/**
+ * Parse the curation mark from a tag array.
+ * Looks for tags matching 'curated:<mark>'.
+ *
+ * @param tags - Array of tags to search
+ * @returns The curation mark found, or null if none present
+ */
+export declare function parseCurationTag(tags: readonly string[]): CurationMark | null;
+/**
+ * Curation service interface.
+ *
+ * Provides operations for curating facts (marking quality)
+ * and computing quality scores for ranking.
+ */
+export interface ICurationService {
+    /**
+     * Mark a fact with a curation status.
+     *
+     * Side effects by mark:
+     * - `deprecated`: Also expires the fact
+     * - `authoritative`: Promotes confidence to `verified`
+     *
+     * @param groupId - Group ID the fact belongs to
+     * @param uuid - UUID of the fact to mark
+     * @param mark - The curation mark to apply
+     */
+    markFact(groupId: string, uuid: string, mark: CurationMark): Promise<void>;
+    /**
+     * Compute a quality score for a memory item.
+     *
+     * Formula: confidenceScore × sourceWeight × recencyBonus
+     * - confidenceScore: from CONFIDENCE_SCORES (0.1–1.0)
+     * - sourceWeight: varies by source type (0.3–1.0)
+     * - recencyBonus: 1.0 for <7 days, decays linearly to 0.5 at 90 days
+     *
+     * @param item - The memory item to score
+     * @returns Quality score between 0.0 and 1.0
+     */
+    computeQualityScore(item: IMemoryItem): number;
+    /**
+     * Sort memory items by quality score descending.
+     * Returns a new sorted array (immutable).
+     *
+     * @param items - Items to rank
+     * @returns New array sorted by quality score descending
+     */
+    rankByQuality(items: readonly IMemoryItem[]): readonly IMemoryItem[];
+}
+//# sourceMappingURL=ICurationService.d.ts.map

package/dist/lib/domain/interfaces/ICurationService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICurationService.d.ts","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/ICurationService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,eAAe,GAAG,OAAO,GAAG,YAAY,GAAG,cAAc,CAAC;AAErF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,YAAY,EAK9C,CAAC;AAOX;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,YAAY,CAExE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAE7D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY,GAAG,IAAI,CAU7E;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;;OAUG;IACH,QAAQ,CACN,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;;;;OAUG;IACH,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IAE/C;;;;;;OAMG;IACH,aAAa,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,SAAS,WAAW,EAAE,CAAC;CACtE"}

package/dist/lib/domain/interfaces/ICurationService.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * Curation Service Interface.
+ *
+ * Defines the contract for curating memory facts — marking them as
+ * authoritative, draft, deprecated, or needing review. Also provides
+ * quality scoring to rank facts by reliability.
+ *
+ * Part of Phase 5C: Curation & Compaction.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CURATION_MARK_VALUES = void 0;
+exports.isValidCurationMark = isValidCurationMark;
+exports.resolveCurationTag = resolveCurationTag;
+exports.parseCurationTag = parseCurationTag;
+/**
+ * All valid curation marks.
+ */
+exports.CURATION_MARK_VALUES = [
+    'authoritative',
+    'draft',
+    'deprecated',
+    'needs-review',
+];
+/**
+ * Tag prefix used for curation tags.
+ */
+const CURATION_TAG_PREFIX = 'curated:';
+/**
+ * Check if a string is a valid CurationMark.
+ *
+ * @param value - The string to check
+ * @returns true if valid curation mark
+ */
+function isValidCurationMark(value) {
+    return exports.CURATION_MARK_VALUES.includes(value);
+}
+/**
+ * Resolve a curation mark to its corresponding tag string.
+ *
+ * @param mark - The curation mark
+ * @returns Tag string, e.g. 'curated:authoritative'
+ */
+function resolveCurationTag(mark) {
+    return `${CURATION_TAG_PREFIX}${mark}`;
+}
+/**
+ * Parse the curation mark from a tag array.
+ * Looks for tags matching 'curated:<mark>'.
+ *
+ * @param tags - Array of tags to search
+ * @returns The curation mark found, or null if none present
+ */
+function parseCurationTag(tags) {
+    for (const tag of tags) {
+        if (tag.startsWith(CURATION_TAG_PREFIX)) {
+            const mark = tag.slice(CURATION_TAG_PREFIX.length);
+            if (exports.CURATION_MARK_VALUES.includes(mark)) {
+                return mark;
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=ICurationService.js.map

package/dist/lib/domain/interfaces/ICurationService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICurationService.js","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/ICurationService.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AA8BH,kDAEC;AAQD,gDAEC;AASD,4CAUC;AApDD;;GAEG;AACU,QAAA,oBAAoB,GAA4B;IAC3D,eAAe;IACf,OAAO;IACP,YAAY;IACZ,cAAc;CACN,CAAC;AAEX;;GAEG;AACH,MAAM,mBAAmB,GAAG,UAAU,CAAC;AAEvC;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,KAAa;IAC/C,OAAO,4BAAoB,CAAC,QAAQ,CAAC,KAAqB,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,IAAkB;IACnD,OAAO,GAAG,mBAAmB,GAAG,IAAI,EAAE,CAAC;AACzC,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAC,IAAuB;IACtD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,mBAAmB,CAAC,MAAM,CAAiB,CAAC;YACnE,IAAI,4BAAoB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxC,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/lib/domain/interfaces/IDeduplicationService.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Deduplication Service Interfaces.
+ *
+ * Domain contracts for detecting duplicate memory facts.
+ * Detection only — consolidation (acting on duplicates) is separate.
+ */
+import type { IMemoryItem } from './types';
+/**
+ * Reason why facts were grouped as duplicates.
+ */
+export type DuplicateReason = 'exact-match' | 'tag-overlap' | 'similar-content' | 'llm-semantic';
+/**
+ * A group of duplicate facts.
+ */
+export interface IDuplicateGroup {
+    /** Why these facts were grouped as duplicates */
+    readonly reason: DuplicateReason;
+    /** The duplicate facts */
+    readonly facts: readonly IMemoryItem[];
+    /** Similarity score between group members (0.0–1.0) */
+    readonly similarity: number;
+    /** LLM-suggested merged text for the group (only for llm-semantic groups) */
+    readonly suggestedMerge?: string;
+}
+/**
+ * Result of a deduplication scan.
+ */
+export interface IDeduplicationResult {
+    /** Total facts scanned */
+    readonly totalFactsScanned: number;
+    /** Groups of detected duplicates */
+    readonly duplicateGroups: readonly IDuplicateGroup[];
+    /** Total number of duplicate groups found */
+    readonly totalDuplicates: number;
+}
+/**
+ * Options for deduplication detection.
+ */
+export interface IDeduplicationOptions {
+    /** Minimum Jaccard similarity threshold for similar-content detection (default: 0.6) */
+    readonly minSimilarity?: number;
+    /** Maximum number of duplicate groups to return (default: 10) */
+    readonly limit?: number;
+    /** Only scan facts created after this date */
+    readonly since?: Date;
+    /** Enable LLM-assisted semantic deduplication as a 4th pass (default: false) */
+    readonly aiAssist?: boolean;
+}
+/**
+ * Deduplication detection service.
+ * Detects duplicate facts without mutating them.
+ */
+export interface IDeduplicationService {
+    /**
+     * Detect duplicate facts within a group.
+     *
+     * Three-pass detection:
+     * 1. Exact match — identical normalized text (similarity: 1.0)
+     * 2. Tag overlap — same type:* tag with 3+ shared words (similarity: 0.5–0.8)
+     * 3. Similar content — Jaccard similarity above threshold (similarity: configurable)
+     *
+     * @param groupId - Group ID to scan
+     * @param options - Detection options (threshold, limit, date filter)
+     */
+    detectDuplicates(groupId: string, options?: IDeduplicationOptions): Promise<IDeduplicationResult>;
+}
+//# sourceMappingURL=IDeduplicationService.d.ts.map

package/dist/lib/domain/interfaces/IDeduplicationService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IDeduplicationService.d.ts","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/IDeduplicationService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,aAAa,GAAG,iBAAiB,GAAG,cAAc,CAAC;AAEjG;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,0BAA0B;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IACvC,uDAAuD;IACvD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,6EAA6E;IAC7E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,0BAA0B;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,oCAAoC;IACpC,QAAQ,CAAC,eAAe,EAAE,SAAS,eAAe,EAAE,CAAC;IACrD,6CAA6C;IAC7C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wFAAwF;IACxF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,iEAAiE;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC;IACtB,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;;;;;OAUG;IACH,gBAAgB,CACd,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAClC"}

package/dist/lib/domain/interfaces/IDeduplicationService.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Deduplication Service Interfaces.
+ *
+ * Domain contracts for detecting duplicate memory facts.
+ * Detection only — consolidation (acting on duplicates) is separate.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IDeduplicationService.js.map

package/dist/lib/domain/interfaces/IDeduplicationService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IDeduplicationService.js","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/IDeduplicationService.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/lib/domain/interfaces/ILlmConfigService.d.ts

@@ -0,0 +1,36 @@
+/**
+ * LLM Configuration Service Interface.
+ *
+ * Domain contract for managing LLM provider configuration.
+ * Configuration is persisted via PreferenceStore with env var overrides.
+ *
+ * Part of Phase 6A: LLM Provider Abstraction Layer.
+ */
+import type { LlmProvider, ILlmConfig } from './ILlmService';
+/**
+ * Service for reading and writing LLM configuration.
+ */
+export interface ILlmConfigService {
+    /**
+     * Get the resolved LLM configuration.
+     * Merge order: defaults <- preferences <- environment variables.
+     */
+    getConfig(): Promise<ILlmConfig>;
+    /** Set the LLM provider. */
+    setProvider(provider: LlmProvider): Promise<void>;
+    /** Set the model name. */
+    setModel(model: string): Promise<void>;
+    /** Set a custom endpoint URL. */
+    setEndpoint(endpoint: string): Promise<void>;
+    /** Set the API key. */
+    setApiKey(apiKey: string): Promise<void>;
+    /** Enable or disable LLM features. */
+    setEnabled(enabled: boolean): Promise<void>;
+    /** Set the default max output tokens. */
+    setMaxTokens(maxTokens: number): Promise<void>;
+    /** Set the default temperature. */
+    setTemperature(temperature: number): Promise<void>;
+    /** Reset all LLM configuration to defaults (clears stored preferences). */
+    reset(): Promise<void>;
+}
+//# sourceMappingURL=ILlmConfigService.d.ts.map

package/dist/lib/domain/interfaces/ILlmConfigService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILlmConfigService.d.ts","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/ILlmConfigService.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IAEjC,4BAA4B;IAC5B,WAAW,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD,0BAA0B;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC,iCAAiC;IACjC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C,uBAAuB;IACvB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC,sCAAsC;IACtC,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C,yCAAyC;IACzC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C,mCAAmC;IACnC,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD,2EAA2E;IAC3E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/dist/lib/domain/interfaces/ILlmConfigService.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * LLM Configuration Service Interface.
+ *
+ * Domain contract for managing LLM provider configuration.
+ * Configuration is persisted via PreferenceStore with env var overrides.
+ *
+ * Part of Phase 6A: LLM Provider Abstraction Layer.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ILlmConfigService.js.map

package/dist/lib/domain/interfaces/ILlmConfigService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILlmConfigService.js","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/ILlmConfigService.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG"}

package/dist/lib/domain/interfaces/ILlmGuard.d.ts

@@ -0,0 +1,35 @@
+/**
+ * LLM Guard Interface.
+ *
+ * Policy decorator over ILlmService that enforces budget limits,
+ * per-feature toggles, and usage tracking. All LLM consumers
+ * should go through the guard rather than calling ILlmService directly.
+ *
+ * Part of Phase 6B: Cost/Privacy Controls.
+ */
+import type { ILlmResponse, ILlmRequestOptions } from './ILlmService';
+import type { LlmFeature } from './ILlmUsageTracker';
+/**
+ * Guarded LLM completion service.
+ * Enforces budget, feature toggles, and records usage.
+ */
+export interface ILlmGuard {
+    /**
+     * Send a completion request with policy enforcement.
+     *
+     * @param prompt - The user prompt text
+     * @param feature - Which LLM feature is making the request
+     * @param options - Optional request overrides
+     * @throws LlmFeatureDisabledError if the feature is toggled off
+     * @throws LlmBudgetExceededError if over the monthly budget
+     * @throws LlmDisabledError if LLM is disabled globally
+     * @throws LlmProviderError if the provider returns an error
+     */
+    complete(prompt: string, feature: LlmFeature, options?: ILlmRequestOptions): Promise<ILlmResponse>;
+    /**
+     * Check whether a specific LLM feature is enabled.
+     * Checks both the master switch and per-feature toggles.
+     */
+    isFeatureEnabled(feature: LlmFeature): Promise<boolean>;
+}
+//# sourceMappingURL=ILlmGuard.d.ts.map

package/dist/lib/domain/interfaces/ILlmGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILlmGuard.d.ts","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/ILlmGuard.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;;;;;;OAUG;IACH,QAAQ,CACN,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,UAAU,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB;;;OAGG;IACH,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzD"}

package/dist/lib/domain/interfaces/ILlmGuard.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * LLM Guard Interface.
+ *
+ * Policy decorator over ILlmService that enforces budget limits,
+ * per-feature toggles, and usage tracking. All LLM consumers
+ * should go through the guard rather than calling ILlmService directly.
+ *
+ * Part of Phase 6B: Cost/Privacy Controls.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ILlmGuard.js.map

package/dist/lib/domain/interfaces/ILlmGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILlmGuard.js","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/ILlmGuard.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG"}

package/dist/lib/domain/interfaces/ILlmService.d.ts

@@ -0,0 +1,87 @@
+/**
+ * LLM Service Interfaces.
+ *
+ * Domain contracts for interacting with Large Language Model providers.
+ * Supports multiple backends: Anthropic (Claude), OpenAI, and Ollama (local).
+ *
+ * Part of Phase 6A: LLM Provider Abstraction Layer.
+ */
+/**
+ * Supported LLM providers.
+ */
+export type LlmProvider = 'anthropic' | 'openai' | 'ollama';
+/**
+ * All valid LLM provider values.
+ */
+export declare const LLM_PROVIDER_VALUES: readonly LlmProvider[];
+/**
+ * Type guard for LlmProvider.
+ */
+export declare function isValidLlmProvider(value: string): value is LlmProvider;
+/**
+ * LLM configuration.
+ */
+export interface ILlmConfig {
+    readonly provider: LlmProvider;
+    readonly model: string;
+    readonly endpoint?: string;
+    readonly apiKey?: string;
+    readonly enabled: boolean;
+    readonly maxTokens: number;
+    readonly temperature: number;
+}
+/**
+ * Default LLM configuration.
+ */
+export declare function getDefaultLlmConfig(): ILlmConfig;
+/**
+ * Token usage from an LLM call.
+ */
+export interface ILlmUsage {
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly totalTokens: number;
+}
+/**
+ * Response from an LLM call.
+ */
+export interface ILlmResponse {
+    readonly text: string;
+    readonly usage: ILlmUsage;
+    readonly model: string;
+    readonly provider: LlmProvider;
+}
+/**
+ * Options for an LLM completion request.
+ */
+export interface ILlmRequestOptions {
+    readonly maxTokens?: number;
+    readonly temperature?: number;
+    readonly systemPrompt?: string;
+}
+/**
+ * LLM completion service.
+ * Sends prompts to an LLM provider and returns structured responses.
+ */
+export interface ILlmService {
+    /**
+     * Send a completion request to the configured LLM provider.
+     *
+     * @param prompt - The user prompt text
+     * @param options - Optional request overrides (tokens, temperature, system prompt)
+     * @throws LlmDisabledError if LLM is disabled
+     * @throws LlmConfigError if configuration is invalid (e.g. missing API key)
+     * @throws LlmProviderError if the provider returns an error
+     */
+    complete(prompt: string, options?: ILlmRequestOptions): Promise<ILlmResponse>;
+    /**
+     * Check whether the LLM provider is available and configured.
+     * Returns false if disabled or provider unreachable.
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Get the current resolved LLM configuration.
+     */
+    getConfig(): Promise<ILlmConfig>;
+}
+//# sourceMappingURL=ILlmService.d.ts.map

package/dist/lib/domain/interfaces/ILlmService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILlmService.d.ts","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/ILlmService.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,WAAW,EAI5C,CAAC;AAEX;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW,CAEtE;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,UAAU,CAQhD;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE9E;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhC;;OAEG;IACH,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;CAClC"}

package/dist/lib/domain/interfaces/ILlmService.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * LLM Service Interfaces.
+ *
+ * Domain contracts for interacting with Large Language Model providers.
+ * Supports multiple backends: Anthropic (Claude), OpenAI, and Ollama (local).
+ *
+ * Part of Phase 6A: LLM Provider Abstraction Layer.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLM_PROVIDER_VALUES = void 0;
+exports.isValidLlmProvider = isValidLlmProvider;
+exports.getDefaultLlmConfig = getDefaultLlmConfig;
+/**
+ * All valid LLM provider values.
+ */
+exports.LLM_PROVIDER_VALUES = [
+    'anthropic',
+    'openai',
+    'ollama',
+];
+/**
+ * Type guard for LlmProvider.
+ */
+function isValidLlmProvider(value) {
+    return exports.LLM_PROVIDER_VALUES.includes(value);
+}
+/**
+ * Default LLM configuration.
+ */
+function getDefaultLlmConfig() {
+    return {
+        provider: 'anthropic',
+        model: 'claude-sonnet-4-20250514',
+        enabled: false,
+        maxTokens: 1024,
+        temperature: 0.3,
+    };
+}
+//# sourceMappingURL=ILlmService.js.map

package/dist/lib/domain/interfaces/ILlmService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILlmService.js","sourceRoot":"","sources":["../../../../src/lib/domain/interfaces/ILlmService.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAmBH,gDAEC;AAkBD,kDAQC;AAxCD;;GAEG;AACU,QAAA,mBAAmB,GAA2B;IACzD,WAAW;IACX,QAAQ;IACR,QAAQ;CACA,CAAC;AAEX;;GAEG;AACH,SAAgB,kBAAkB,CAAC,KAAa;IAC9C,OAAO,2BAAmB,CAAC,QAAQ,CAAC,KAAoB,CAAC,CAAC;AAC5D,CAAC;AAeD;;GAEG;AACH,SAAgB,mBAAmB;IACjC,OAAO;QACL,QAAQ,EAAE,WAAW;QACrB,KAAK,EAAE,0BAA0B;QACjC,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,IAAI;QACf,WAAW,EAAE,GAAG;KACjB,CAAC;AACJ,CAAC"}