@happyvertical/smrt-core 0.38.18 → 0.38.20

package/dist/index.d.ts

@@ -37,6 +37,7 @@ export { type JunctionAttachOptions, type JunctionFilterOptions, SmrtJunction, }
 export * from './knowledge';
 export type { ConfigResolver, LazyConfigSentinel, ResolveLazyConfigOptions, } from './lazy-config';
 export { getClassConfigResolvers, getConfigResolver, isLazyConfigSentinel, listConfigResolvers, registerConfigResolver, resetConfigResolvers, resolveLazyConfig, unregisterConfigResolver, } from './lazy-config';
+export { DEFAULT_LEARNING_CONFIG, type LearningEpisode, LearningMemory, type LearningMemoryConfig, type LearningMemoryOptions, type LearningMemoryRecord, type LearningOutcome, type LearningRecallOptions, type LearningSemanticSearch, } from './learning/index';
 export * from './manifest/index';
 export type { DiffOptions } from './migrations/differ';
 export { generateSchemaDiff, getSQLFromDiff, hasActionableChanges, SchemaComparer, } from './migrations/differ';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -55,6 +55,7 @@ import { SmrtHierarchical } from "./hierarchical.js";
 import { SmrtJunction } from "./junction.js";
 import { buildDomainKnowledgeManifest } from "./knowledge.js";
 import { getClassConfigResolvers, getConfigResolver, isLazyConfigSentinel, listConfigResolvers, registerConfigResolver, resetConfigResolvers, resolveLazyConfig, unregisterConfigResolver } from "./lazy-config.js";
+import { DEFAULT_LEARNING_CONFIG, LearningMemory } from "./learning/memory.js";
 import { ManifestBuilder } from "./manifest/generator.js";
 import manifest, { getManifest, staticManifest } from "./manifest/index.js";
 import { SchemaComparer, generateSchemaDiff, getSQLFromDiff, hasActionableChanges } from "./migrations/differ.js";
@@ -68,4 +69,4 @@ import "./system/index.js";
 import { getTestDatabase } from "./testing/database.js";
 import "./tools/index.js";
 import { smrtPlugin } from "./vite-plugin/index.js";
-export { AIError, APIGenerator, AiUsageCollector, AiUsagePersistenceHandler, CACHE_INVALIDATION_CHANNEL, CHANGE_FEED_INTERCEPTOR_NAME, CHANGE_FEED_TABLE, CHANGE_SIGNAL_CHANNEL, CLIGenerator, ConfigurationError, ContentHasher, CosineSimilarity, DEFAULT_AI_COST_RATES, DEFAULT_CHANGES_LIMIT, DEFAULT_EMBEDDING_CONFIG, DEFAULT_EVENTS_HEARTBEAT_MS, DEFAULT_EVENTS_MAX_SUBSCRIBERS, DEFAULT_EVENTS_RETRY_AFTER_SECONDS, DatabaseError, Dispatch, DispatchBus, DispatchCollection, DispatchSubscription, DispatchSubscriptionCollection, EmbeddingProvider, EmbeddingStorage, ErrorUtils, FilesystemError, GlobalInterceptors, MAX_CHANGES_LIMIT, MAX_SYNC_APPLY_BATCH_SIZE, MCPGenerator, ManifestBuilder, ManifestGenerator, ManifestManager, MetricsAdapter, NetworkError, ObjectRegistry, PRIVATE_READ_CACHE_CONTROL, PubSubAdapter, RuntimeError, SMRT_COLLECTION_BASE_NAMES, SYNC_APPLY_ROUTE_SEGMENTS, SYNC_APPLY_UUID_PATTERN, SchemaComparer, SignalBus, SignalSanitizer, SmrtClass, SmrtCollection, SmrtError, SmrtHierarchical, SmrtJunction, SmrtMCPServer, SmrtObject, SmrtPolymorphicAssociation, TenantIsolationError, ValidationError, ValidationReport, ValidationUtils, appendChange, applyOneToManyChildAccessors, applyPendingDecoratorRegistrations, applySyncWritablePolicy, broadcastCacheInvalidation, buildChangeEventStream, buildDomainKnowledgeManifest, bumpChangeFeed, canonicalReadRepresentation, changeEventSubscribersAtCapacity, childAccessorName, clone, computeBodyEtag, computeRuntimeWebManifestHash, computeTableVersionEtag, conditionalJsonResponse, config, convertTypeToJsonSchema, createDispatchBus, createInterceptorContext, createMCPServer, createQualifiedName, createRestServer, createSmrtClient, createSmrtServer, crossPackageRef, detectEngine, discoverManifestEntry, ensureCacheInvalidationListener, ensureChangeFeedTable, ensureDispatchSubscriptionsSystemTableCompatibility, ensureDispatchSystemTableCompatibility, ensureJobEventsSystemTableCompatibility, ensureJobsSystemTableCompatibility, ensureLegacySystemTableCompatibility, estimateAiUsageCost, eventStreamCapacityExceededResponse, executeToolCall, executeToolCalls, field, findManifestEntryByQualifiedName, foreignKey, formatToolResults, generateDDLForEngine, generateOpenAPISpec, generateSchemaDiff, generateToolFromMethod, generateToolManifest, getAdapterInfo, getCLIHandler, getCacheGeneration, getChangesSince, getClassConfigResolvers, getClassName, getConfigResolver, getManifest, getPackageFromQualifiedName, getSQLFromDiff, getTableVersion, getTenantScopedChangesSince, getTestDatabase, hasActionableChanges, ifNoneMatchHasConcreteMatch, ifNoneMatchSatisfied, invalidateCollectionCache, isDatabaseInterface, isFromPackage, isLazyConfigSentinel, isQualifiedName, isSmrtCollectionExtendsName, isStaleWrite, isTenantScopedClassResolved, isType, isValid, listConfigResolvers, loadExternalManifest, loadExternalManifestSync, loadLocalTestManifestSync, loadManifestFromPathSync, manifest, manyToMany, meta, normalizeEventsMaxSubscribers, oneToMany, parse, parseQualifiedName, parseSyncApplyBatch, payloadMatchesRow, processSyncApplyBatch, pruneChangeFeed, qualifiedNamesEqual, registerChangeFeedWriter, registerCompatibleFieldDecorator, registerConfigResolver, resetChangeFeedWarnings, resetChangeSignals, resetCollectionCache, resetConfigResolvers, resetVerifiedTables, resolveDatabase, resolveDbCacheKey, resolveDispatchTenantId, resolveDispatchTenantScope, resolveLazyConfig, resolveReadCacheControl, resolveTenantEtagDiscriminator, runWithTenantGate, safeParse, safeStringify, setDispatchTenantResolver, setTenantEntryPointRunner, setTenantScopedClassResolver, setupCLI, setupSwaggerUI, shouldIncludeMethod, signalVisibleToTenant, smrt, smrtPlugin, smrt as smrtRegistry, startRestServer, staticManifest, stopCacheInvalidationListeners, stopChangeSignalListeners, stringify, subscribeToChangeSignals, tableExists, tryReserveChangeEventSubscriberSlot, unregisterChangeFeedWriter, unregisterConfigResolver, validateSyncApplyItem, validateToolCall, versionConditionalResponse, warnIfSharedCacheNeutralized };
+export { AIError, APIGenerator, AiUsageCollector, AiUsagePersistenceHandler, CACHE_INVALIDATION_CHANNEL, CHANGE_FEED_INTERCEPTOR_NAME, CHANGE_FEED_TABLE, CHANGE_SIGNAL_CHANNEL, CLIGenerator, ConfigurationError, ContentHasher, CosineSimilarity, DEFAULT_AI_COST_RATES, DEFAULT_CHANGES_LIMIT, DEFAULT_EMBEDDING_CONFIG, DEFAULT_EVENTS_HEARTBEAT_MS, DEFAULT_EVENTS_MAX_SUBSCRIBERS, DEFAULT_EVENTS_RETRY_AFTER_SECONDS, DEFAULT_LEARNING_CONFIG, DatabaseError, Dispatch, DispatchBus, DispatchCollection, DispatchSubscription, DispatchSubscriptionCollection, EmbeddingProvider, EmbeddingStorage, ErrorUtils, FilesystemError, GlobalInterceptors, LearningMemory, MAX_CHANGES_LIMIT, MAX_SYNC_APPLY_BATCH_SIZE, MCPGenerator, ManifestBuilder, ManifestGenerator, ManifestManager, MetricsAdapter, NetworkError, ObjectRegistry, PRIVATE_READ_CACHE_CONTROL, PubSubAdapter, RuntimeError, SMRT_COLLECTION_BASE_NAMES, SYNC_APPLY_ROUTE_SEGMENTS, SYNC_APPLY_UUID_PATTERN, SchemaComparer, SignalBus, SignalSanitizer, SmrtClass, SmrtCollection, SmrtError, SmrtHierarchical, SmrtJunction, SmrtMCPServer, SmrtObject, SmrtPolymorphicAssociation, TenantIsolationError, ValidationError, ValidationReport, ValidationUtils, appendChange, applyOneToManyChildAccessors, applyPendingDecoratorRegistrations, applySyncWritablePolicy, broadcastCacheInvalidation, buildChangeEventStream, buildDomainKnowledgeManifest, bumpChangeFeed, canonicalReadRepresentation, changeEventSubscribersAtCapacity, childAccessorName, clone, computeBodyEtag, computeRuntimeWebManifestHash, computeTableVersionEtag, conditionalJsonResponse, config, convertTypeToJsonSchema, createDispatchBus, createInterceptorContext, createMCPServer, createQualifiedName, createRestServer, createSmrtClient, createSmrtServer, crossPackageRef, detectEngine, discoverManifestEntry, ensureCacheInvalidationListener, ensureChangeFeedTable, ensureDispatchSubscriptionsSystemTableCompatibility, ensureDispatchSystemTableCompatibility, ensureJobEventsSystemTableCompatibility, ensureJobsSystemTableCompatibility, ensureLegacySystemTableCompatibility, estimateAiUsageCost, eventStreamCapacityExceededResponse, executeToolCall, executeToolCalls, field, findManifestEntryByQualifiedName, foreignKey, formatToolResults, generateDDLForEngine, generateOpenAPISpec, generateSchemaDiff, generateToolFromMethod, generateToolManifest, getAdapterInfo, getCLIHandler, getCacheGeneration, getChangesSince, getClassConfigResolvers, getClassName, getConfigResolver, getManifest, getPackageFromQualifiedName, getSQLFromDiff, getTableVersion, getTenantScopedChangesSince, getTestDatabase, hasActionableChanges, ifNoneMatchHasConcreteMatch, ifNoneMatchSatisfied, invalidateCollectionCache, isDatabaseInterface, isFromPackage, isLazyConfigSentinel, isQualifiedName, isSmrtCollectionExtendsName, isStaleWrite, isTenantScopedClassResolved, isType, isValid, listConfigResolvers, loadExternalManifest, loadExternalManifestSync, loadLocalTestManifestSync, loadManifestFromPathSync, manifest, manyToMany, meta, normalizeEventsMaxSubscribers, oneToMany, parse, parseQualifiedName, parseSyncApplyBatch, payloadMatchesRow, processSyncApplyBatch, pruneChangeFeed, qualifiedNamesEqual, registerChangeFeedWriter, registerCompatibleFieldDecorator, registerConfigResolver, resetChangeFeedWarnings, resetChangeSignals, resetCollectionCache, resetConfigResolvers, resetVerifiedTables, resolveDatabase, resolveDbCacheKey, resolveDispatchTenantId, resolveDispatchTenantScope, resolveLazyConfig, resolveReadCacheControl, resolveTenantEtagDiscriminator, runWithTenantGate, safeParse, safeStringify, setDispatchTenantResolver, setTenantEntryPointRunner, setTenantScopedClassResolver, setupCLI, setupSwaggerUI, shouldIncludeMethod, signalVisibleToTenant, smrt, smrtPlugin, smrt as smrtRegistry, startRestServer, staticManifest, stopCacheInvalidationListeners, stopChangeSignalListeners, stringify, subscribeToChangeSignals, tableExists, tryReserveChangeEventSubscriberSlot, unregisterChangeFeedWriter, unregisterConfigResolver, validateSyncApplyItem, validateToolCall, versionConditionalResponse, warnIfSharedCacheNeutralized };

package/dist/interceptors.d.ts

@@ -22,6 +22,7 @@ export interface ListOptions {
     orderBy?: string | string[];
     limit?: number;
     offset?: number;
+    select?: readonly string[];
     include?: string[];
     [key: string]: unknown;
 }
@@ -57,7 +58,7 @@ export interface CollectionInterceptor {
     /**
      * Called before list() operations
      * @param className - Name of the class being listed
-     * @param options - List options (where, orderBy, limit, etc.)
+     * @param options - List options (where, orderBy, limit, select, etc.)
      * @param context - Operation context
      * @returns Modified options or void to pass through
      */

package/dist/interceptors.d.ts.map

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

package/dist/interceptors.js.map

@@ -1 +1 @@
-{"version":3,"file":"interceptors.js","names":[],"sources":["../src/interceptors.ts"],"sourcesContent":["/**\n * Global Interceptors System for SMRT Collections and Objects\n *\n * Provides a plugin architecture for intercepting collection and object operations.\n * This enables external packages (like @happyvertical/smrt-tenancy) to register\n * interceptors without creating circular dependencies.\n *\n * Pattern: Static methods on GlobalInterceptors class with globalThis state\n * (matches ObjectRegistry pattern for cross-module state sharing)\n *\n * @example Basic interceptor registration\n * ```typescript\n * import { GlobalInterceptors } from '@happyvertical/smrt-core';\n *\n * // Register a beforeList interceptor\n * GlobalInterceptors.register({\n *   beforeList(className, options) {\n *     console.log(`Listing ${className}`);\n *     return options; // Return modified options\n *   }\n * });\n * ```\n *\n * @example Tenancy interceptor (from smrt-tenancy)\n * ```typescript\n * GlobalInterceptors.register({\n *   beforeList(className, options, context) {\n *     const tenantId = getCurrentTenantId();\n *     if (tenantId && isTenantScoped(className)) {\n *       return {\n *         ...options,\n *         where: { ...options.where, tenantId }\n *       };\n *     }\n *     return options;\n *   },\n *   beforeSave(instance, context) {\n *     // Validate tenant on save\n *   }\n * });\n * ```\n *\n * @see https://github.com/happyvertical/smrt/issues/675\n */\n\nimport type { SmrtObject } from './object.js';\n\n/**\n * Context passed to interceptors with operation metadata\n */\nexport interface InterceptorContext {\n  /** Name of the SMRT class being operated on */\n  className: string;\n  /** Name of the collection (if applicable) */\n  collectionName?: string;\n  /** Timestamp of the operation */\n  timestamp: Date;\n  /** Operation type for debugging */\n  operation: 'list' | 'get' | 'query' | 'save' | 'delete';\n  /** Additional metadata */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Options for list operations\n */\nexport interface ListOptions {\n  where?: Record<string, unknown>;\n  orderBy?: string | string[];\n  limit?: number;\n  offset?: number;\n  include?: string[];\n  [key: string]: unknown;\n}\n\n/**\n * Options for query operations (raw SQL)\n */\nexport interface QueryOptions {\n  /** The raw SQL query */\n  sql: string;\n  /** Query parameters */\n  params: unknown[];\n  /** If true, allow raw SQL on tenant-scoped classes (requires explicit opt-in) */\n  allowRawOnTenantScoped?: boolean;\n}\n\n/**\n * Result from query interceptor - can modify SQL or throw to block\n */\nexport interface QueryInterceptResult {\n  sql: string;\n  params: unknown[];\n}\n\n/**\n * Interface for collection/object interceptors\n *\n * All methods are optional. Return void to pass through unchanged,\n * or return modified data to transform the operation.\n */\nexport interface CollectionInterceptor {\n  /** Unique identifier for this interceptor (for debugging/unregistration) */\n  name?: string;\n\n  /** Priority for execution order (higher = earlier). Default: 0 */\n  priority?: number;\n\n  /**\n   * Called before list() operations\n   * @param className - Name of the class being listed\n   * @param options - List options (where, orderBy, limit, etc.)\n   * @param context - Operation context\n   * @returns Modified options or void to pass through\n   */\n  beforeList?(\n    className: string,\n    options: ListOptions,\n    context: InterceptorContext,\n  ): ListOptions | Promise<ListOptions> | void | Promise<void>;\n\n  /**\n   * Called after list() operations with results\n   * @param className - Name of the class\n   * @param results - Array of hydrated instances\n   * @param context - Operation context\n   * @returns Modified results or void to pass through\n   */\n  afterList?<T extends SmrtObject>(\n    className: string,\n    results: T[],\n    context: InterceptorContext,\n  ): T[] | Promise<T[]> | void | Promise<void>;\n\n  /**\n   * Called before get() operations\n   * @param className - Name of the class\n   * @param filter - ID, slug, or filter object\n   * @param context - Operation context\n   * @returns Modified filter or void to pass through\n   */\n  beforeGet?(\n    className: string,\n    filter: string | Record<string, unknown>,\n    context: InterceptorContext,\n  ):\n    | string\n    | Record<string, unknown>\n    | Promise<string | Record<string, unknown>>\n    | void\n    | Promise<void>;\n\n  /**\n   * Called after get() operations with result\n   * @param className - Name of the class\n   * @param instance - Hydrated instance or null if not found\n   * @param context - Operation context\n   * @returns Modified instance, null, or void to pass through\n   */\n  afterGet?<T extends SmrtObject>(\n    className: string,\n    instance: T | null,\n    context: InterceptorContext,\n  ): T | null | Promise<T | null> | void | Promise<void>;\n\n  /**\n   * Called before query() operations (raw SQL)\n   * @param className - Name of the class\n   * @param options - Query options with SQL and params\n   * @param context - Operation context\n   * @returns Modified query options, or throw to block the query\n   */\n  beforeQuery?(\n    className: string,\n    options: QueryOptions,\n    context: InterceptorContext,\n  ):\n    | QueryInterceptResult\n    | Promise<QueryInterceptResult>\n    | void\n    | Promise<void>;\n\n  /**\n   * Called after query() operations with results\n   * @param className - Name of the class\n   * @param results - Array of hydrated instances\n   * @param context - Operation context\n   * @returns Modified results or void to pass through\n   */\n  afterQuery?<T extends SmrtObject>(\n    className: string,\n    results: T[],\n    context: InterceptorContext,\n  ): T[] | Promise<T[]> | void | Promise<void>;\n\n  /**\n   * Called before save() operations\n   * @param instance - The object being saved\n   * @param context - Operation context\n   * @returns void (modify instance in place) or throw to block\n   */\n  beforeSave?(\n    instance: SmrtObject,\n    context: InterceptorContext,\n  ): void | Promise<void>;\n\n  /**\n   * Called after save() operations\n   * @param instance - The saved object\n   * @param context - Operation context\n   */\n  afterSave?(\n    instance: SmrtObject,\n    context: InterceptorContext,\n  ): void | Promise<void>;\n\n  /**\n   * Called before delete() operations\n   * @param instance - The object being deleted\n   * @param context - Operation context\n   * @returns void or throw to block\n   */\n  beforeDelete?(\n    instance: SmrtObject,\n    context: InterceptorContext,\n  ): void | Promise<void>;\n\n  /**\n   * Called after delete() operations\n   * @param instance - The deleted object\n   * @param context - Operation context\n   */\n  afterDelete?(\n    instance: SmrtObject,\n    context: InterceptorContext,\n  ): void | Promise<void>;\n}\n\n/**\n * Extend globalThis to include interceptors state.\n * Using globalThis ensures all module instances share the same interceptors,\n * which is critical in monorepos where the same package can be loaded\n * from different paths.\n *\n * @see ObjectRegistry for similar pattern\n */\ndeclare global {\n  // eslint-disable-next-line no-var\n  var __smrtInterceptors: unknown[] | undefined;\n}\n\n/**\n * Global Interceptors Registry\n *\n * Manages collection/object interceptors for the SMRT framework.\n * External packages can register interceptors to hook into operations\n * without modifying core code.\n */\nexport class GlobalInterceptors {\n  /**\n   * Get the global interceptors array (lazy-initialized)\n   */\n  private static get interceptors(): CollectionInterceptor[] {\n    if (!globalThis.__smrtInterceptors) {\n      globalThis.__smrtInterceptors = [];\n    }\n    return globalThis.__smrtInterceptors as CollectionInterceptor[];\n  }\n\n  /**\n   * Register an interceptor\n   *\n   * @param interceptor - The interceptor to register\n   * @example\n   * ```typescript\n   * GlobalInterceptors.register({\n   *   name: 'tenancy',\n   *   priority: 100,\n   *   beforeList(className, options) {\n   *     // Add tenant filtering\n   *     return { ...options, where: { ...options.where, tenantId: 'xxx' } };\n   *   }\n   * });\n   * ```\n   */\n  static register(interceptor: CollectionInterceptor): void {\n    // Check for duplicate by name\n    if (interceptor.name) {\n      const existing = this.interceptors.findIndex(\n        (i) => i.name === interceptor.name,\n      );\n      if (existing >= 0) {\n        // Replace existing interceptor with same name\n        this.interceptors[existing] = interceptor;\n        this.sortByPriority();\n        return;\n      }\n    }\n\n    this.interceptors.push(interceptor);\n    this.sortByPriority();\n  }\n\n  /**\n   * Unregister an interceptor by reference or name\n   *\n   * @param interceptorOrName - The interceptor instance or name to remove\n   * @returns true if removed, false if not found\n   */\n  static unregister(\n    interceptorOrName: CollectionInterceptor | string,\n  ): boolean {\n    const idx =\n      typeof interceptorOrName === 'string'\n        ? this.interceptors.findIndex((i) => i.name === interceptorOrName)\n        : this.interceptors.indexOf(interceptorOrName);\n\n    if (idx >= 0) {\n      this.interceptors.splice(idx, 1);\n      return true;\n    }\n    return false;\n  }\n\n  /**\n   * Clear all interceptors (useful for testing)\n   */\n  static clear(): void {\n    globalThis.__smrtInterceptors = [];\n  }\n\n  /**\n   * Get all registered interceptors (readonly)\n   */\n  static getAll(): readonly CollectionInterceptor[] {\n    return [...this.interceptors];\n  }\n\n  /**\n   * Check if any interceptors are registered\n   */\n  static hasInterceptors(): boolean {\n    return this.interceptors.length > 0;\n  }\n\n  /**\n   * Sort interceptors by priority (higher priority first)\n   */\n  private static sortByPriority(): void {\n    this.interceptors.sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));\n  }\n\n  // ─────────────────────────────────────────────────────────────────────────\n  // Execution methods - called by SmrtCollection and SmrtObject\n  // ─────────────────────────────────────────────────────────────────────────\n\n  /**\n   * Execute beforeList interceptors\n   * @internal Called by SmrtCollection.list()\n   */\n  static async executeBeforeList(\n    className: string,\n    options: ListOptions,\n    context: InterceptorContext,\n  ): Promise<ListOptions> {\n    let result = options;\n\n    for (const interceptor of this.interceptors) {\n      if (interceptor.beforeList) {\n        const modified = await interceptor.beforeList(\n          className,\n          result,\n          context,\n        );\n        if (modified !== undefined && modified !== null) {\n          result = modified;\n        }\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Execute afterList interceptors\n   * @internal Called by SmrtCollection.list()\n   */\n  static async executeAfterList<T extends SmrtObject>(\n    className: string,\n    results: T[],\n    context: InterceptorContext,\n  ): Promise<T[]> {\n    let result = results;\n\n    for (const interceptor of this.interceptors) {\n      if (interceptor.afterList) {\n        const modified = await interceptor.afterList(\n          className,\n          result,\n          context,\n        );\n        if (modified !== undefined && modified !== null) {\n          result = modified as T[];\n        }\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Execute beforeGet interceptors\n   * @internal Called by SmrtCollection.get()\n   */\n  static async executeBeforeGet(\n    className: string,\n    filter: string | Record<string, unknown>,\n    context: InterceptorContext,\n  ): Promise<string | Record<string, unknown>> {\n    let result = filter;\n\n    for (const interceptor of this.interceptors) {\n      if (interceptor.beforeGet) {\n        const modified = await interceptor.beforeGet(\n          className,\n          result,\n          context,\n        );\n        if (modified !== undefined && modified !== null) {\n          result = modified;\n        }\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Execute afterGet interceptors\n   * @internal Called by SmrtCollection.get()\n   */\n  static async executeAfterGet<T extends SmrtObject>(\n    className: string,\n    instance: T | null,\n    context: InterceptorContext,\n  ): Promise<T | null> {\n    let result = instance;\n\n    for (const interceptor of this.interceptors) {\n      if (interceptor.afterGet) {\n        const modified = await interceptor.afterGet(className, result, context);\n        if (modified !== undefined) {\n          result = modified as T | null;\n        }\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Execute beforeQuery interceptors\n   * @internal Called by SmrtCollection.query()\n   */\n  static async executeBeforeQuery(\n    className: string,\n    options: QueryOptions,\n    context: InterceptorContext,\n  ): Promise<QueryInterceptResult> {\n    let result: QueryInterceptResult = {\n      sql: options.sql,\n      params: options.params,\n    };\n\n    for (const interceptor of this.interceptors) {\n      if (interceptor.beforeQuery) {\n        const modified = await interceptor.beforeQuery(\n          className,\n          { ...options, ...result },\n          context,\n        );\n        if (modified !== undefined && modified !== null) {\n          result = modified;\n        }\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Execute afterQuery interceptors\n   * @internal Called by SmrtCollection.query()\n   */\n  static async executeAfterQuery<T extends SmrtObject>(\n    className: string,\n    results: T[],\n    context: InterceptorContext,\n  ): Promise<T[]> {\n    let result = results;\n\n    for (const interceptor of this.interceptors) {\n      if (interceptor.afterQuery) {\n        const modified = await interceptor.afterQuery(\n          className,\n          result,\n          context,\n        );\n        if (modified !== undefined && modified !== null) {\n          result = modified as T[];\n        }\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Execute beforeSave interceptors\n   * @internal Called by SmrtObject.save()\n   */\n  static async executeBeforeSave(\n    instance: SmrtObject,\n    context: InterceptorContext,\n  ): Promise<void> {\n    for (const interceptor of this.interceptors) {\n      if (interceptor.beforeSave) {\n        await interceptor.beforeSave(instance, context);\n      }\n    }\n  }\n\n  /**\n   * Execute afterSave interceptors\n   * @internal Called by SmrtObject.save()\n   */\n  static async executeAfterSave(\n    instance: SmrtObject,\n    context: InterceptorContext,\n  ): Promise<void> {\n    for (const interceptor of this.interceptors) {\n      if (interceptor.afterSave) {\n        await interceptor.afterSave(instance, context);\n      }\n    }\n  }\n\n  /**\n   * Execute beforeDelete interceptors\n   * @internal Called by SmrtObject.delete()\n   */\n  static async executeBeforeDelete(\n    instance: SmrtObject,\n    context: InterceptorContext,\n  ): Promise<void> {\n    for (const interceptor of this.interceptors) {\n      if (interceptor.beforeDelete) {\n        await interceptor.beforeDelete(instance, context);\n      }\n    }\n  }\n\n  /**\n   * Execute afterDelete interceptors\n   * @internal Called by SmrtObject.delete()\n   */\n  static async executeAfterDelete(\n    instance: SmrtObject,\n    context: InterceptorContext,\n  ): Promise<void> {\n    for (const interceptor of this.interceptors) {\n      if (interceptor.afterDelete) {\n        await interceptor.afterDelete(instance, context);\n      }\n    }\n  }\n}\n\n/**\n * Helper function to create an interceptor context\n * @internal\n */\nexport function createInterceptorContext(\n  className: string,\n  operation: InterceptorContext['operation'],\n  collectionName?: string,\n  metadata?: Record<string, unknown>,\n): InterceptorContext {\n  return {\n    className,\n    collectionName,\n    operation,\n    timestamp: new Date(),\n    metadata,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"interceptors.js","names":[],"sources":["../src/interceptors.ts"],"sourcesContent":["/**\n * Global Interceptors System for SMRT Collections and Objects\n *\n * Provides a plugin architecture for intercepting collection and object operations.\n * This enables external packages (like @happyvertical/smrt-tenancy) to register\n * interceptors without creating circular dependencies.\n *\n * Pattern: Static methods on GlobalInterceptors class with globalThis state\n * (matches ObjectRegistry pattern for cross-module state sharing)\n *\n * @example Basic interceptor registration\n * ```typescript\n * import { GlobalInterceptors } from '@happyvertical/smrt-core';\n *\n * // Register a beforeList interceptor\n * GlobalInterceptors.register({\n *   beforeList(className, options) {\n *     console.log(`Listing ${className}`);\n *     return options; // Return modified options\n *   }\n * });\n * ```\n *\n * @example Tenancy interceptor (from smrt-tenancy)\n * ```typescript\n * GlobalInterceptors.register({\n *   beforeList(className, options, context) {\n *     const tenantId = getCurrentTenantId();\n *     if (tenantId && isTenantScoped(className)) {\n *       return {\n *         ...options,\n *         where: { ...options.where, tenantId }\n *       };\n *     }\n *     return options;\n *   },\n *   beforeSave(instance, context) {\n *     // Validate tenant on save\n *   }\n * });\n * ```\n *\n * @see https://github.com/happyvertical/smrt/issues/675\n */\n\nimport type { SmrtObject } from './object.js';\n\n/**\n * Context passed to interceptors with operation metadata\n */\nexport interface InterceptorContext {\n  /** Name of the SMRT class being operated on */\n  className: string;\n  /** Name of the collection (if applicable) */\n  collectionName?: string;\n  /** Timestamp of the operation */\n  timestamp: Date;\n  /** Operation type for debugging */\n  operation: 'list' | 'get' | 'query' | 'save' | 'delete';\n  /** Additional metadata */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Options for list operations\n */\nexport interface ListOptions {\n  where?: Record<string, unknown>;\n  orderBy?: string | string[];\n  limit?: number;\n  offset?: number;\n  select?: readonly string[];\n  include?: string[];\n  [key: string]: unknown;\n}\n\n/**\n * Options for query operations (raw SQL)\n */\nexport interface QueryOptions {\n  /** The raw SQL query */\n  sql: string;\n  /** Query parameters */\n  params: unknown[];\n  /** If true, allow raw SQL on tenant-scoped classes (requires explicit opt-in) */\n  allowRawOnTenantScoped?: boolean;\n}\n\n/**\n * Result from query interceptor - can modify SQL or throw to block\n */\nexport interface QueryInterceptResult {\n  sql: string;\n  params: unknown[];\n}\n\n/**\n * Interface for collection/object interceptors\n *\n * All methods are optional. Return void to pass through unchanged,\n * or return modified data to transform the operation.\n */\nexport interface CollectionInterceptor {\n  /** Unique identifier for this interceptor (for debugging/unregistration) */\n  name?: string;\n\n  /** Priority for execution order (higher = earlier). Default: 0 */\n  priority?: number;\n\n  /**\n   * Called before list() operations\n   * @param className - Name of the class being listed\n   * @param options - List options (where, orderBy, limit, select, etc.)\n   * @param context - Operation context\n   * @returns Modified options or void to pass through\n   */\n  beforeList?(\n    className: string,\n    options: ListOptions,\n    context: InterceptorContext,\n  ): ListOptions | Promise<ListOptions> | void | Promise<void>;\n\n  /**\n   * Called after list() operations with results\n   * @param className - Name of the class\n   * @param results - Array of hydrated instances\n   * @param context - Operation context\n   * @returns Modified results or void to pass through\n   */\n  afterList?<T extends SmrtObject>(\n    className: string,\n    results: T[],\n    context: InterceptorContext,\n  ): T[] | Promise<T[]> | void | Promise<void>;\n\n  /**\n   * Called before get() operations\n   * @param className - Name of the class\n   * @param filter - ID, slug, or filter object\n   * @param context - Operation context\n   * @returns Modified filter or void to pass through\n   */\n  beforeGet?(\n    className: string,\n    filter: string | Record<string, unknown>,\n    context: InterceptorContext,\n  ):\n    | string\n    | Record<string, unknown>\n    | Promise<string | Record<string, unknown>>\n    | void\n    | Promise<void>;\n\n  /**\n   * Called after get() operations with result\n   * @param className - Name of the class\n   * @param instance - Hydrated instance or null if not found\n   * @param context - Operation context\n   * @returns Modified instance, null, or void to pass through\n   */\n  afterGet?<T extends SmrtObject>(\n    className: string,\n    instance: T | null,\n    context: InterceptorContext,\n  ): T | null | Promise<T | null> | void | Promise<void>;\n\n  /**\n   * Called before query() operations (raw SQL)\n   * @param className - Name of the class\n   * @param options - Query options with SQL and params\n   * @param context - Operation context\n   * @returns Modified query options, or throw to block the query\n   */\n  beforeQuery?(\n    className: string,\n    options: QueryOptions,\n    context: InterceptorContext,\n  ):\n    | QueryInterceptResult\n    | Promise<QueryInterceptResult>\n    | void\n    | Promise<void>;\n\n  /**\n   * Called after query() operations with results\n   * @param className - Name of the class\n   * @param results - Array of hydrated instances\n   * @param context - Operation context\n   * @returns Modified results or void to pass through\n   */\n  afterQuery?<T extends SmrtObject>(\n    className: string,\n    results: T[],\n    context: InterceptorContext,\n  ): T[] | Promise<T[]> | void | Promise<void>;\n\n  /**\n   * Called before save() operations\n   * @param instance - The object being saved\n   * @param context - Operation context\n   * @returns void (modify instance in place) or throw to block\n   */\n  beforeSave?(\n    instance: SmrtObject,\n    context: InterceptorContext,\n  ): void | Promise<void>;\n\n  /**\n   * Called after save() operations\n   * @param instance - The saved object\n   * @param context - Operation context\n   */\n  afterSave?(\n    instance: SmrtObject,\n    context: InterceptorContext,\n  ): void | Promise<void>;\n\n  /**\n   * Called before delete() operations\n   * @param instance - The object being deleted\n   * @param context - Operation context\n   * @returns void or throw to block\n   */\n  beforeDelete?(\n    instance: SmrtObject,\n    context: InterceptorContext,\n  ): void | Promise<void>;\n\n  /**\n   * Called after delete() operations\n   * @param instance - The deleted object\n   * @param context - Operation context\n   */\n  afterDelete?(\n    instance: SmrtObject,\n    context: InterceptorContext,\n  ): void | Promise<void>;\n}\n\n/**\n * Extend globalThis to include interceptors state.\n * Using globalThis ensures all module instances share the same interceptors,\n * which is critical in monorepos where the same package can be loaded\n * from different paths.\n *\n * @see ObjectRegistry for similar pattern\n */\ndeclare global {\n  // eslint-disable-next-line no-var\n  var __smrtInterceptors: unknown[] | undefined;\n}\n\n/**\n * Global Interceptors Registry\n *\n * Manages collection/object interceptors for the SMRT framework.\n * External packages can register interceptors to hook into operations\n * without modifying core code.\n */\nexport class GlobalInterceptors {\n  /**\n   * Get the global interceptors array (lazy-initialized)\n   */\n  private static get interceptors(): CollectionInterceptor[] {\n    if (!globalThis.__smrtInterceptors) {\n      globalThis.__smrtInterceptors = [];\n    }\n    return globalThis.__smrtInterceptors as CollectionInterceptor[];\n  }\n\n  /**\n   * Register an interceptor\n   *\n   * @param interceptor - The interceptor to register\n   * @example\n   * ```typescript\n   * GlobalInterceptors.register({\n   *   name: 'tenancy',\n   *   priority: 100,\n   *   beforeList(className, options) {\n   *     // Add tenant filtering\n   *     return { ...options, where: { ...options.where, tenantId: 'xxx' } };\n   *   }\n   * });\n   * ```\n   */\n  static register(interceptor: CollectionInterceptor): void {\n    // Check for duplicate by name\n    if (interceptor.name) {\n      const existing = this.interceptors.findIndex(\n        (i) => i.name === interceptor.name,\n      );\n      if (existing >= 0) {\n        // Replace existing interceptor with same name\n        this.interceptors[existing] = interceptor;\n        this.sortByPriority();\n        return;\n      }\n    }\n\n    this.interceptors.push(interceptor);\n    this.sortByPriority();\n  }\n\n  /**\n   * Unregister an interceptor by reference or name\n   *\n   * @param interceptorOrName - The interceptor instance or name to remove\n   * @returns true if removed, false if not found\n   */\n  static unregister(\n    interceptorOrName: CollectionInterceptor | string,\n  ): boolean {\n    const idx =\n      typeof interceptorOrName === 'string'\n        ? this.interceptors.findIndex((i) => i.name === interceptorOrName)\n        : this.interceptors.indexOf(interceptorOrName);\n\n    if (idx >= 0) {\n      this.interceptors.splice(idx, 1);\n      return true;\n    }\n    return false;\n  }\n\n  /**\n   * Clear all interceptors (useful for testing)\n   */\n  static clear(): void {\n    globalThis.__smrtInterceptors = [];\n  }\n\n  /**\n   * Get all registered interceptors (readonly)\n   */\n  static getAll(): readonly CollectionInterceptor[] {\n    return [...this.interceptors];\n  }\n\n  /**\n   * Check if any interceptors are registered\n   */\n  static hasInterceptors(): boolean {\n    return this.interceptors.length > 0;\n  }\n\n  /**\n   * Sort interceptors by priority (higher priority first)\n   */\n  private static sortByPriority(): void {\n    this.interceptors.sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));\n  }\n\n  // ─────────────────────────────────────────────────────────────────────────\n  // Execution methods - called by SmrtCollection and SmrtObject\n  // ─────────────────────────────────────────────────────────────────────────\n\n  /**\n   * Execute beforeList interceptors\n   * @internal Called by SmrtCollection.list()\n   */\n  static async executeBeforeList(\n    className: string,\n    options: ListOptions,\n    context: InterceptorContext,\n  ): Promise<ListOptions> {\n    let result = options;\n\n    for (const interceptor of this.interceptors) {\n      if (interceptor.beforeList) {\n        const modified = await interceptor.beforeList(\n          className,\n          result,\n          context,\n        );\n        if (modified !== undefined && modified !== null) {\n          result = modified;\n        }\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Execute afterList interceptors\n   * @internal Called by SmrtCollection.list()\n   */\n  static async executeAfterList<T extends SmrtObject>(\n    className: string,\n    results: T[],\n    context: InterceptorContext,\n  ): Promise<T[]> {\n    let result = results;\n\n    for (const interceptor of this.interceptors) {\n      if (interceptor.afterList) {\n        const modified = await interceptor.afterList(\n          className,\n          result,\n          context,\n        );\n        if (modified !== undefined && modified !== null) {\n          result = modified as T[];\n        }\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Execute beforeGet interceptors\n   * @internal Called by SmrtCollection.get()\n   */\n  static async executeBeforeGet(\n    className: string,\n    filter: string | Record<string, unknown>,\n    context: InterceptorContext,\n  ): Promise<string | Record<string, unknown>> {\n    let result = filter;\n\n    for (const interceptor of this.interceptors) {\n      if (interceptor.beforeGet) {\n        const modified = await interceptor.beforeGet(\n          className,\n          result,\n          context,\n        );\n        if (modified !== undefined && modified !== null) {\n          result = modified;\n        }\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Execute afterGet interceptors\n   * @internal Called by SmrtCollection.get()\n   */\n  static async executeAfterGet<T extends SmrtObject>(\n    className: string,\n    instance: T | null,\n    context: InterceptorContext,\n  ): Promise<T | null> {\n    let result = instance;\n\n    for (const interceptor of this.interceptors) {\n      if (interceptor.afterGet) {\n        const modified = await interceptor.afterGet(className, result, context);\n        if (modified !== undefined) {\n          result = modified as T | null;\n        }\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Execute beforeQuery interceptors\n   * @internal Called by SmrtCollection.query()\n   */\n  static async executeBeforeQuery(\n    className: string,\n    options: QueryOptions,\n    context: InterceptorContext,\n  ): Promise<QueryInterceptResult> {\n    let result: QueryInterceptResult = {\n      sql: options.sql,\n      params: options.params,\n    };\n\n    for (const interceptor of this.interceptors) {\n      if (interceptor.beforeQuery) {\n        const modified = await interceptor.beforeQuery(\n          className,\n          { ...options, ...result },\n          context,\n        );\n        if (modified !== undefined && modified !== null) {\n          result = modified;\n        }\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Execute afterQuery interceptors\n   * @internal Called by SmrtCollection.query()\n   */\n  static async executeAfterQuery<T extends SmrtObject>(\n    className: string,\n    results: T[],\n    context: InterceptorContext,\n  ): Promise<T[]> {\n    let result = results;\n\n    for (const interceptor of this.interceptors) {\n      if (interceptor.afterQuery) {\n        const modified = await interceptor.afterQuery(\n          className,\n          result,\n          context,\n        );\n        if (modified !== undefined && modified !== null) {\n          result = modified as T[];\n        }\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Execute beforeSave interceptors\n   * @internal Called by SmrtObject.save()\n   */\n  static async executeBeforeSave(\n    instance: SmrtObject,\n    context: InterceptorContext,\n  ): Promise<void> {\n    for (const interceptor of this.interceptors) {\n      if (interceptor.beforeSave) {\n        await interceptor.beforeSave(instance, context);\n      }\n    }\n  }\n\n  /**\n   * Execute afterSave interceptors\n   * @internal Called by SmrtObject.save()\n   */\n  static async executeAfterSave(\n    instance: SmrtObject,\n    context: InterceptorContext,\n  ): Promise<void> {\n    for (const interceptor of this.interceptors) {\n      if (interceptor.afterSave) {\n        await interceptor.afterSave(instance, context);\n      }\n    }\n  }\n\n  /**\n   * Execute beforeDelete interceptors\n   * @internal Called by SmrtObject.delete()\n   */\n  static async executeBeforeDelete(\n    instance: SmrtObject,\n    context: InterceptorContext,\n  ): Promise<void> {\n    for (const interceptor of this.interceptors) {\n      if (interceptor.beforeDelete) {\n        await interceptor.beforeDelete(instance, context);\n      }\n    }\n  }\n\n  /**\n   * Execute afterDelete interceptors\n   * @internal Called by SmrtObject.delete()\n   */\n  static async executeAfterDelete(\n    instance: SmrtObject,\n    context: InterceptorContext,\n  ): Promise<void> {\n    for (const interceptor of this.interceptors) {\n      if (interceptor.afterDelete) {\n        await interceptor.afterDelete(instance, context);\n      }\n    }\n  }\n}\n\n/**\n * Helper function to create an interceptor context\n * @internal\n */\nexport function createInterceptorContext(\n  className: string,\n  operation: InterceptorContext['operation'],\n  collectionName?: string,\n  metadata?: Record<string, unknown>,\n): InterceptorContext {\n  return {\n    className,\n    collectionName,\n    operation,\n    timestamp: new Date(),\n    metadata,\n  };\n}\n"],"mappings":"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"}

package/dist/learning/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Learning primitives — confidence-scored, self-correcting memory (L1 of the
+ * tenant-learning-agents epic, #1885 / #1886).
+ *
+ * @module
+ */
+export { DEFAULT_LEARNING_CONFIG, type LearningEpisode, LearningMemory, type LearningMemoryConfig, type LearningMemoryOptions, type LearningMemoryRecord, type LearningOutcome, type LearningRecallOptions, type LearningSemanticSearch, } from './memory.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/learning/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/learning/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,uBAAuB,EACvB,KAAK,eAAe,EACpB,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,aAAa,CAAC"}

package/dist/learning/memory.d.ts

@@ -0,0 +1,226 @@
+import { DatabaseInterface } from '@happyvertical/sql';
+/**
+ * A relevance-scored memory returned by {@link LearningMemory.recall}.
+ *
+ * Records sourced from keyed `_smrt_contexts` lookups carry reinforcement
+ * counters; records sourced from semantic embedding search carry a
+ * `similarity` score (mirrored into `confidence` for uniform ranking).
+ */
+export interface LearningMemoryRecord {
+    /** Row id in `_smrt_contexts`, or the matched object id for semantic hits. */
+    id: string;
+    /** Hierarchical scope the memory is filed under. */
+    scope: string;
+    /** Lookup key within the scope. */
+    key: string;
+    /** The stored value (JSON-parsed for context rows; the matched object for semantic hits). */
+    value: unknown;
+    /** Confidence in `[0, 1]`. For semantic hits this equals `similarity`. */
+    confidence: number;
+    /** Number of captured successes reinforcing this memory. */
+    successCount: number;
+    /** Number of captured failures decaying this memory. */
+    failureCount: number;
+    /** Last time this memory was recalled or reinforced. */
+    lastUsedAt: Date | null;
+    /** Where the record came from. */
+    source: 'context' | 'semantic';
+    /** Cosine similarity for semantic hits (absent for context rows). */
+    similarity?: number;
+}
+/**
+ * The outcome of acting on a recalled (or freshly generated) memory.
+ *
+ * A boolean `success` signal is the common case; a numeric `metric` delta is
+ * supported as a convenience (positive → success, non-positive → failure).
+ */
+export type LearningOutcome = {
+    success: boolean;
+    error?: string;
+} | {
+    metric: number;
+    error?: string;
+};
+/**
+ * The episode being reinforced — the scope/key of the memory the agent acted
+ * on, plus (for a first capture) the value to persist.
+ */
+export interface LearningEpisode {
+    /** Scope the memory is filed under (e.g. `'sample/parse-invoice'`). */
+    scope: string;
+    /** Lookup key within the scope. */
+    key: string;
+    /**
+     * The value (strategy) this outcome pertains to. Seeds a new memory when none
+     * exists for `(scope, key)`, and refreshes the stored value when one does — so
+     * a regenerated strategy supersedes a decayed one. Omit to reinforce an
+     * existing memory's confidence without touching its stored value.
+     */
+    value?: unknown;
+    /** Optional metadata to persist on a first capture. */
+    metadata?: Record<string, unknown>;
+    /** Optional expiry after which recall ignores the memory. */
+    expiresAt?: Date;
+}
+/**
+ * Tunable thresholds for the reinforcement loop. Defaults mirror the proven
+ * `praeco` behaviour.
+ */
+export interface LearningMemoryConfig {
+    /** Reuse floor — recall omits memories below this confidence. Default 0.7. */
+    minConfidence: number;
+    /** Confidence a brand-new memory is seeded at on a first success. Default 0.9. */
+    successConfidence: number;
+    /** Target a memory decays toward on failure. Default 0.3. */
+    failureConfidence: number;
+    /**
+     * Blend weight in `[0, 1]` for each reinforcement step. At 0.5 a single
+     * failure from any confident value (>= 0.7) always lands below the 0.7 floor
+     * (`0.5·c + 0.15 <= 0.65`). Default 0.5.
+     */
+    reinforcement: number;
+    /**
+     * Optional half-life (ms) for time-based confidence decay. When set, recall
+     * discounts a memory's stored confidence by `0.5 ^ (age / halfLife)` based on
+     * `last_used_at`, so stale memory falls below the floor over time even
+     * without an explicit failure. Off (no time decay) when undefined.
+     */
+    decayHalfLifeMs?: number;
+}
+/** Default reinforcement thresholds. */
+export declare const DEFAULT_LEARNING_CONFIG: LearningMemoryConfig;
+/**
+ * A semantic search over stored embeddings, injected so `LearningMemory` never
+ * reaches into a collection's internals. Matches the shape of
+ * `SmrtCollection.semanticSearch`.
+ */
+export type LearningSemanticSearch = (query: string, options: {
+    limit?: number;
+    minSimilarity?: number;
+    where?: Record<string, unknown>;
+}) => Promise<Array<{
+    id?: string;
+    _similarity: number;
+} & Record<string, unknown>>>;
+/** Options for {@link LearningMemory.recall}. */
+export interface LearningRecallOptions {
+    /** Exact key to look up within the scope. Omit for a scope-wide recall. */
+    key?: string;
+    /** Free-text query for semantic recall (only used when a searcher is wired). */
+    query?: string;
+    /** Override the reuse floor for this call. */
+    minConfidence?: number;
+    /** Walk up the scope hierarchy when no match is found at `scope`. Default true. */
+    includeAncestors?: boolean;
+    /** Cap on returned records. */
+    limit?: number;
+    /** Cap on semantic hits requested from the searcher. Default 10. */
+    semanticLimit?: number;
+    /** Minimum cosine similarity for semantic hits. Default 0. */
+    minSimilarity?: number;
+    /** Reference time for decay/expiry evaluation (injectable for tests). */
+    now?: Date;
+}
+/** Constructor options for {@link LearningMemory}. */
+export interface LearningMemoryOptions {
+    /** System database handle (an owning object's `systemDb`). */
+    db: DatabaseInterface;
+    /** `owner_class` the memories are filed under. */
+    ownerClass: string;
+    /** `owner_id` the memories are filed under (isolates memory per owner). */
+    ownerId: string;
+    /**
+     * Optional tenant id. When set it is threaded into the semantic searcher's
+     * `where` filter so embedding recall stays tenant-scoped. Keyed-context
+     * recall is already isolated by `owner_id`.
+     */
+    tenantId?: string | null;
+    /** Optional embedding search for the semantic recall arm. */
+    semanticSearch?: LearningSemanticSearch;
+    /** Threshold overrides; merged over {@link DEFAULT_LEARNING_CONFIG}. */
+    config?: Partial<LearningMemoryConfig>;
+}
+/**
+ * Confidence-scored, self-correcting memory over `_smrt_contexts` and
+ * (optionally) semantic embedding search.
+ *
+ * @example
+ * ```typescript
+ * const memory = new LearningMemory({
+ *   db: agent.systemDb,
+ *   ownerClass: 'InvoiceAgent',
+ *   ownerId: agent.id,
+ *   tenantId: agent.tenantId,
+ * });
+ *
+ * // Recall a confident strategy for this task.
+ * const [hit] = await memory.recall('parser/acme', { key: docUrl });
+ * const strategy = hit?.value ?? (await generateStrategy(docUrl));
+ *
+ * // ...act on `strategy`, then reinforce the outcome.
+ * await memory.capture(
+ *   { scope: 'parser/acme', key: docUrl, value: strategy },
+ *   { success: extracted.length > 0 },
+ * );
+ * ```
+ */
+export declare class LearningMemory {
+    private readonly db;
+    private readonly ownerClass;
+    private readonly ownerId;
+    private readonly tenantId;
+    private readonly semanticSearch?;
+    private readonly config;
+    constructor(options: LearningMemoryOptions);
+    /** The resolved reinforcement thresholds (defaults merged with overrides). */
+    get thresholds(): LearningMemoryConfig;
+    /**
+     * Recall confidence-filtered, relevant memories for a scope.
+     *
+     * Unions two arms:
+     * 1. **Keyed context recall** over `_smrt_contexts` — owner-scoped (and thus
+     *    tenant-isolated), filtered by the confidence floor, expiry, and optional
+     *    time-decay, with hierarchical scope fallback. Surviving rows have their
+     *    `last_used_at` refreshed.
+     * 2. **Semantic recall** over stored embeddings (only when a searcher was
+     *    wired and a `query` is given) — tenant-scoped via the searcher's `where`.
+     *
+     * @returns Records sorted by confidence (then similarity) descending.
+     */
+    recall(scope: string, options?: LearningRecallOptions): Promise<LearningMemoryRecord[]>;
+    /**
+     * Reinforce a memory from an observed outcome.
+     *
+     * - Wires the dormant reinforcement columns: increments `success_count` on
+     *   success, `failure_count` on failure.
+     * - Adjusts `confidence`: success strengthens toward 1.0; failure decays
+     *   toward `failureConfidence` (default 0.3), dropping a confident memory
+     *   below the reuse floor in a single step.
+     * - Refreshes `last_used_at` and `updated_at`, and (when the episode carries a
+     *   `value`) the stored value — so a regenerated strategy supersedes a decayed
+     *   one instead of the old value resurfacing on the next success.
+     * - Seeds a new memory when none exists for `(scope, key)` and the episode
+     *   carries a `value` (a failed first attempt is retained at low confidence
+     *   for self-correction context).
+     *
+     * @returns The updated (or seeded) record, or `null` when there was nothing
+     *   to reinforce (no existing memory and no value to seed).
+     */
+    capture(episode: LearningEpisode, outcome: LearningOutcome): Promise<LearningMemoryRecord | null>;
+    /**
+     * Compute the next confidence from the current value and an outcome.
+     *
+     * Success strengthens toward 1.0; failure blends toward `failureConfidence`.
+     * Exposed as a pure step so callers/tests can reason about the curve.
+     */
+    nextConfidence(current: number, success: boolean): number;
+    private recallContexts;
+    private selectContextRows;
+    private filterAndRank;
+    private applyTimeDecay;
+    private recallSemantic;
+    private touch;
+    private scopeChain;
+    private parseMetadata;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/learning/memory.d.ts.map

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