ai-database 2.1.3 → 2.3.0

package/dist/schema/union-fallback.js

@@ -162,9 +162,11 @@ export async function searchUnionTypes(types, query, options) {
         searchOrder: [],
         fallbackTriggered: false,
         allTypesExhausted: false,
-        belowThresholdMatches: options.includeBelowThreshold ? [] : undefined,
         errors: [],
     };
+    if (options.includeBelowThreshold) {
+        result.belowThresholdMatches = [];
+    }
     // Handle empty types array
     if (!types || types.length === 0) {
         result.allTypesExhausted = true;
@@ -191,10 +193,10 @@ async function searchOrdered(types, query, options, result) {
             result.fallbackTriggered = true;
         }
         try {
-            const matches = await searcher(type, query, {
-                threshold,
-                limit: options.limit,
-            });
+            const searchOpts = { threshold };
+            if (options.limit !== undefined)
+                searchOpts.limit = options.limit;
+            const matches = await searcher(type, query, searchOpts);
             // Filter by threshold
             const { above, below } = filterByThreshold(matches, threshold, includeBelowThreshold);
             // Collect below-threshold matches for debugging
@@ -214,11 +216,13 @@ async function searchOrdered(types, query, options, result) {
                 throw error;
             }
             // Continue mode: record error and try next type
-            result.errors.push({
+            const searchError = {
                 type,
                 message: error instanceof Error ? error.message : String(error),
-                error: error instanceof Error ? error : undefined,
-            });
+            };
+            if (error instanceof Error)
+                searchError.error = error;
+            result.errors.push(searchError);
         }
     }
     // No matches found in any type
@@ -237,10 +241,10 @@ async function searchParallel(types, query, options, result) {
     const searchPromises = types.map(async (type) => {
         const threshold = getThresholdForType(type, options);
         try {
-            const matches = await searcher(type, query, {
-                threshold,
-                limit: options.limit,
-            });
+            const searchOpts = { threshold };
+            if (options.limit !== undefined)
+                searchOpts.limit = options.limit;
+            const matches = await searcher(type, query, searchOpts);
             return { type, matches, error: null };
         }
         catch (error) {
@@ -312,10 +316,12 @@ async function searchParallel(types, query, options, result) {
  */
 export function createProviderSearcher(provider) {
     return async (type, query, options) => {
-        const results = await provider.semanticSearch(type, query, {
-            minScore: options?.threshold,
+        const searchOpts = {
             limit: options?.limit ?? 10,
-        });
+        };
+        if (options?.threshold !== undefined)
+            searchOpts.minScore = options.threshold;
+        const results = await provider.semanticSearch(type, query, searchOpts);
         return results.map((r) => ({
             ...r,
             $type: type,

package/dist/schema/union-fallback.js.map

@@ -1 +1 @@
-{"version":3,"file":"union-fallback.js","sourceRoot":"","sources":["../../src/schema/union-fallback.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"union-fallback.js","sourceRoot":"","sources":["../../src/schema/union-fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAiHH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACxC,OAAO,EAAE,CAAA;IACX,CAAC;IAED,sCAAsC;IACtC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC1C,IAAI,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;QAEnB,4CAA4C;QAC5C,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAA;QAC1E,IAAI,cAAc,EAAE,CAAC;YACnB,IAAI,GAAG,cAAc,CAAC,CAAC,CAAE,CAAA;QAC3B,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC,CAAC,CAAA;IAEF,4DAA4D;IAC5D,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;AAC1C,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,MAAM,UAAU,GAA2B,EAAE,CAAA;IAE7C,IAAI,CAAC,QAAQ;QAAE,OAAO,UAAU,CAAA;IAEhC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAEjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAA;QAC5E,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,GAAG,KAAK,CAAA;YACxC,MAAM,SAAS,GAAG,UAAU,CAAC,YAAa,CAAC,CAAA;YAC3C,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;gBAC1D,UAAU,CAAC,QAAS,CAAC,GAAG,SAAS,CAAA;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAA;AACnB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,mBAAmB,CAAC,IAAY,EAAE,OAA8B;IACvE,sCAAsC;IACtC,IAAI,OAAO,CAAC,UAAU,IAAI,IAAI,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACrD,OAAO,OAAO,CAAC,UAAU,CAAC,IAAI,CAAE,CAAA;IAClC,CAAC;IACD,2DAA2D;IAC3D,OAAO,OAAO,CAAC,SAAS,IAAI,CAAC,CAAA;AAC/B,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CACxB,OAAqB,EACrB,SAAiB,EACjB,qBAA+B;IAE/B,MAAM,KAAK,GAAiB,EAAE,CAAA;IAC9B,MAAM,KAAK,GAAiB,EAAE,CAAA;IAE9B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACnB,CAAC;aAAM,IAAI,qBAAqB,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACnB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;AACzB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAwB,EACxB,KAAa,EACb,OAA8B;IAE9B,oBAAoB;IACpB,MAAM,MAAM,GAAsB;QAChC,OAAO,EAAE,EAAE;QACX,aAAa,EAAE,EAAE;QACjB,WAAW,EAAE,EAAE;QACf,iBAAiB,EAAE,KAAK;QACxB,iBAAiB,EAAE,KAAK;QACxB,MAAM,EAAE,EAAE;KACX,CAAA;IACD,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;QAClC,MAAM,CAAC,qBAAqB,GAAG,EAAE,CAAA;IACnC,CAAC;IAED,2BAA2B;IAC3B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,CAAC,iBAAiB,GAAG,IAAI,CAAA;QAC/B,OAAO,MAAM,CAAA;IACf,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAChC,OAAO,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;IACtD,CAAC;SAAM,CAAC;QACN,OAAO,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;IACrD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,aAAa,CAC1B,KAAwB,EACxB,KAAa,EACb,OAA8B,EAC9B,MAAyB;IAEzB,MAAM,EAAE,QAAQ,EAAE,qBAAqB,EAAE,OAAO,GAAG,OAAO,EAAE,GAAG,OAAO,CAAA;IAEtE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAA;QACtB,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QAEpD,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC/B,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAE7B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACV,MAAM,CAAC,iBAAiB,GAAG,IAAI,CAAA;QACjC,CAAC;QAED,IAAI,CAAC;YACH,MAAM,UAAU,GAA2C,EAAE,SAAS,EAAE,CAAA;YACxE,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;gBAAE,UAAU,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;YACjE,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,CAAA;YAEvD,sBAAsB;YACtB,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,iBAAiB,CAAC,OAAO,EAAE,SAAS,EAAE,qBAAqB,CAAC,CAAA;YAErF,gDAAgD;YAChD,IAAI,qBAAqB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9C,MAAM,CAAC,qBAAsB,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAA;YAC9C,CAAC;YAED,sDAAsD;YACtD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,MAAM,CAAC,OAAO,GAAG,KAAK,CAAA;gBACtB,MAAM,CAAC,WAAW,GAAG,IAAI,CAAA;gBACzB,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;gBAC3D,OAAO,MAAM,CAAA;YACf,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;gBACxB,MAAM,KAAK,CAAA;YACb,CAAC;YACD,gDAAgD;YAChD,MAAM,WAAW,GAAgB;gBAC/B,IAAI;gBACJ,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAChE,CAAA;YACD,IAAI,KAAK,YAAY,KAAK;gBAAE,WAAW,CAAC,KAAK,GAAG,KAAK,CAAA;YACrD,MAAM,CAAC,MAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QAClC,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,MAAM,CAAC,iBAAiB,GAAG,IAAI,CAAA;IAC/B,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,cAAc,CAC3B,KAAwB,EACxB,KAAa,EACb,OAA8B,EAC9B,MAAyB;IAEzB,MAAM,EAAE,QAAQ,EAAE,SAAS,GAAG,KAAK,EAAE,qBAAqB,EAAE,OAAO,GAAG,UAAU,EAAE,GAAG,OAAO,CAAA;IAE5F,6BAA6B;IAC7B,MAAM,CAAC,aAAa,GAAG,CAAC,GAAG,KAAK,CAAC,CAAA;IACjC,MAAM,CAAC,WAAW,GAAG,CAAC,GAAG,KAAK,CAAC,CAAA;IAE/B,+BAA+B;IAC/B,MAAM,cAAc,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QAC9C,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QAEpD,IAAI,CAAC;YACH,MAAM,UAAU,GAA2C,EAAE,SAAS,EAAE,CAAA;YACxE,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;gBAAE,UAAU,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;YACjE,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,CAAA;YACvD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,IAAI;gBACJ,OAAO,EAAE,EAAkB;gBAC3B,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;aACjE,CAAA;QACH,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;IAEjD,iCAAiC;IACjC,MAAM,UAAU,GAAiB,EAAE,CAAA;IACnC,MAAM,iBAAiB,GAAiB,EAAE,CAAA;IAE1C,KAAK,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,OAAO,EAAE,CAAC;QAC/C,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;gBACxB,MAAM,KAAK,CAAA;YACb,CAAC;YACD,MAAM,CAAC,MAAO,CAAC,IAAI,CAAC;gBAClB,IAAI;gBACJ,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,KAAK;aACN,CAAC,CAAA;YACF,SAAQ;QACV,CAAC;QAED,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QACpD,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,iBAAiB,CAAC,OAAO,EAAE,SAAS,EAAE,qBAAqB,CAAC,CAAA;QAErF,UAAU,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAA;QACzB,IAAI,qBAAqB,EAAE,CAAC;YAC1B,iBAAiB,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAA;QAClC,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAA;IAC9C,MAAM,CAAC,qBAAqB,GAAG,iBAAiB,CAAA;IAEhD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,CAAC,iBAAiB,GAAG,IAAI,CAAA;QAC/B,OAAO,MAAM,CAAA;IACf,CAAC;IAED,0CAA0C;IAC1C,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,CAAC,OAAO,GAAG,UAAU,CAAA;IAC7B,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,OAAO,GAAG,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC,CAAA;IACnC,CAAC;IAED,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,KAAK,CAAA;IAC7C,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,MAAM,CAAA;IAE7C,iEAAiE;IACjE,MAAM,CAAC,iBAAiB,GAAG,MAAM,CAAC,WAAW,KAAK,KAAK,CAAC,CAAC,CAAC,CAAA;IAE1D,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAMtC;IACC,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACpC,MAAM,UAAU,GAA0C;YACxD,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE;SAC5B,CAAA;QACD,IAAI,OAAO,EAAE,SAAS,KAAK,SAAS;YAAE,UAAU,CAAC,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAA;QAC7E,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,CAAA;QAEtE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzB,GAAG,CAAC;YACJ,KAAK,EAAE,IAAI;SACZ,CAAC,CAAiB,CAAA;IACrB,CAAC,CAAA;AACH,CAAC"}

package/dist/schema/value-generators/ai.d.ts

@@ -0,0 +1,54 @@
+/**
+ * AIValueGenerator Implementation
+ *
+ * Generates values using AI/LLM integration for production use.
+ * Supports context-aware generation with parent chain and array context.
+ *
+ * @packageDocumentation
+ */
+import type { ValueGenerator, GenerationRequest, GenerationResult, AIFunction } from './types.js';
+/**
+ * Configuration for AIValueGenerator
+ */
+export interface AIValueGeneratorConfig {
+    /** AI function for generating values */
+    aiFunction: AIFunction;
+    /** Model to use for generation */
+    model?: string;
+    /** Maximum tokens for generation */
+    maxTokens?: number;
+    /** Temperature for generation */
+    temperature?: number;
+    /** Whether to fall back to placeholder on AI errors */
+    fallbackToPlaceholder?: boolean;
+}
+/**
+ * AIValueGenerator
+ *
+ * Generates values using an AI function for production use.
+ * Builds rich context from parent chain, previous generations, and array context.
+ */
+export declare class AIValueGenerator implements ValueGenerator {
+    private aiFunction;
+    private model?;
+    private maxTokens?;
+    private temperature?;
+    private fallbackToPlaceholder;
+    private placeholderGenerator;
+    constructor(config: AIValueGeneratorConfig);
+    /**
+     * Generate a value using AI
+     *
+     * @param request - The generation request
+     * @returns Promise resolving to the generated value with metadata
+     */
+    generate(request: GenerationRequest): Promise<GenerationResult>;
+    /**
+     * Build a prompt from the generation request
+     *
+     * Combines field info, context, hints, and generation context
+     * into a comprehensive prompt for the AI.
+     */
+    private buildPrompt;
+}
+//# sourceMappingURL=ai.d.ts.map

package/dist/schema/value-generators/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../../src/schema/value-generators/ai.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAGjG;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,wCAAwC;IACxC,UAAU,EAAE,UAAU,CAAA;IACtB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,uDAAuD;IACvD,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAChC;AAED;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,cAAc;IACrD,OAAO,CAAC,UAAU,CAAY;IAC9B,OAAO,CAAC,KAAK,CAAC,CAAQ;IACtB,OAAO,CAAC,SAAS,CAAC,CAAQ;IAC1B,OAAO,CAAC,WAAW,CAAC,CAAQ;IAC5B,OAAO,CAAC,qBAAqB,CAAS;IACtC,OAAO,CAAC,oBAAoB,CAA2B;gBAE3C,MAAM,EAAE,sBAAsB;IAS1C;;;;;OAKG;IACG,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA6BrE;;;;;OAKG;IACH,OAAO,CAAC,WAAW;CAsEpB"}

package/dist/schema/value-generators/ai.js

@@ -0,0 +1,136 @@
+/**
+ * AIValueGenerator Implementation
+ *
+ * Generates values using AI/LLM integration for production use.
+ * Supports context-aware generation with parent chain and array context.
+ *
+ * @packageDocumentation
+ */
+import { PlaceholderValueGenerator } from './placeholder.js';
+/**
+ * AIValueGenerator
+ *
+ * Generates values using an AI function for production use.
+ * Builds rich context from parent chain, previous generations, and array context.
+ */
+export class AIValueGenerator {
+    aiFunction;
+    model;
+    maxTokens;
+    temperature;
+    fallbackToPlaceholder;
+    placeholderGenerator;
+    constructor(config) {
+        this.aiFunction = config.aiFunction;
+        if (config.model !== undefined)
+            this.model = config.model;
+        if (config.maxTokens !== undefined)
+            this.maxTokens = config.maxTokens;
+        if (config.temperature !== undefined)
+            this.temperature = config.temperature;
+        this.fallbackToPlaceholder = config.fallbackToPlaceholder ?? false;
+        this.placeholderGenerator = new PlaceholderValueGenerator();
+    }
+    /**
+     * Generate a value using AI
+     *
+     * @param request - The generation request
+     * @returns Promise resolving to the generated value with metadata
+     */
+    async generate(request) {
+        try {
+            const prompt = this.buildPrompt(request);
+            const response = await this.aiFunction(prompt);
+            const metadata = {
+                source: 'ai',
+            };
+            if (this.model !== undefined)
+                metadata.model = this.model;
+            if (response.usage?.tokens !== undefined)
+                metadata.tokens = response.usage.tokens;
+            return {
+                value: response.text,
+                metadata,
+            };
+        }
+        catch (error) {
+            if (this.fallbackToPlaceholder) {
+                const placeholderResult = await this.placeholderGenerator.generate(request);
+                return {
+                    value: placeholderResult.value,
+                    metadata: {
+                        source: 'placeholder',
+                        fallback: true,
+                    },
+                };
+            }
+            throw error;
+        }
+    }
+    /**
+     * Build a prompt from the generation request
+     *
+     * Combines field info, context, hints, and generation context
+     * into a comprehensive prompt for the AI.
+     */
+    buildPrompt(request) {
+        const parts = [];
+        // Add field and type context
+        parts.push(`Generate a value for field "${request.fieldName}" on type "${request.type}".`);
+        // Add full context if available
+        if (request.fullContext) {
+            parts.push(`Context: ${request.fullContext}`);
+        }
+        // Add hint if available
+        if (request.hint) {
+            parts.push(`Hint: ${request.hint}`);
+        }
+        // Add parent data context
+        if (request.parentData && Object.keys(request.parentData).length > 0) {
+            const parentEntries = Object.entries(request.parentData)
+                .filter(([key, value]) => !key.startsWith('$') && !key.startsWith('_') && typeof value === 'string')
+                .map(([key, value]) => `${key}: ${value}`)
+                .join(', ');
+            if (parentEntries) {
+                parts.push(`Parent data: ${parentEntries}`);
+            }
+        }
+        // Add generation context if available
+        const genCtx = request.generationContext;
+        if (genCtx) {
+            // Add parent chain context
+            if (genCtx.parentChain && genCtx.parentChain.length > 0) {
+                const chainInfo = genCtx.parentChain
+                    .map((entity) => {
+                    const name = entity['name'] || entity['title'] || entity.$id;
+                    return `${entity.$type}: ${name}`;
+                })
+                    .join(' > ');
+                parts.push(`Parent chain: ${chainInfo}`);
+            }
+            // Add previously generated entities
+            if (genCtx.previouslyGenerated && genCtx.previouslyGenerated.length > 0) {
+                const prevInfo = genCtx.previouslyGenerated
+                    .map((entity) => {
+                    const name = entity['name'] || entity['title'] || entity.$id;
+                    return `${entity.$type}: ${name}`;
+                })
+                    .join(', ');
+                parts.push(`Previously generated: ${prevInfo}`);
+            }
+            // Add array context
+            if (genCtx.arrayContext) {
+                const { fieldName, previousItems, index } = genCtx.arrayContext;
+                parts.push(`Array field: ${fieldName}, generating item ${index + 1}`);
+                if (previousItems.length > 0) {
+                    const prevItemsInfo = previousItems
+                        .map((item) => item['name'] || item['title'] || item.$id)
+                        .join(', ');
+                    parts.push(`Previous items: ${prevItemsInfo}`);
+                }
+            }
+        }
+        return parts.join('\n');
+    }
+}
+//# sourceMappingURL=ai.js.map

package/dist/schema/value-generators/ai.js.map

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

package/dist/schema/value-generators/index.d.ts

@@ -0,0 +1,126 @@
+/**
+ * ValueGenerator Module
+ *
+ * Strategy pattern for value generation during entity creation.
+ * Supports both placeholder (deterministic test fixtures) and
+ * AI-powered (production) generation.
+ *
+ * @example
+ * ```typescript
+ * // Use placeholder generator for testing
+ * const generator = createValueGenerator({ type: 'placeholder' })
+ * const result = await generator.generate({
+ *   fieldName: 'name',
+ *   type: 'Person',
+ *   fullContext: 'tech entrepreneur startup',
+ * })
+ *
+ * // Configure global generator for AI in production
+ * configureValueGenerator({
+ *   type: 'ai',
+ *   aiFunction: async (prompt) => ({ text: await callAI(prompt) }),
+ * })
+ * ```
+ *
+ * @packageDocumentation
+ */
+export type { GenerationRequest, GenerationResult, GenerationMetadata, ValueGenerator, ValueGeneratorConfig, AIFunction, ArrayContext, GenerationContextData, } from './types.js';
+export { PlaceholderValueGenerator } from './placeholder.js';
+export { AIValueGenerator } from './ai.js';
+export type { AIValueGeneratorConfig } from './ai.js';
+import type { ValueGenerator, ValueGeneratorConfig } from './types.js';
+/**
+ * Create a ValueGenerator based on configuration
+ *
+ * @param config - Generator configuration
+ * @returns A new ValueGenerator instance
+ * @throws Error if AI type is specified without aiFunction
+ *
+ * @example
+ * ```typescript
+ * // Create placeholder generator (default)
+ * const placeholderGen = createValueGenerator()
+ *
+ * // Create placeholder generator explicitly
+ * const placeholderGen = createValueGenerator({ type: 'placeholder' })
+ *
+ * // Create AI generator
+ * const aiGen = createValueGenerator({
+ *   type: 'ai',
+ *   aiFunction: async (prompt) => ({ text: 'AI response' }),
+ * })
+ * ```
+ */
+export declare function createValueGenerator(config?: ValueGeneratorConfig): ValueGenerator;
+/**
+ * Configure the global default value generator
+ *
+ * Call this at application startup to set the default generator
+ * that will be used throughout the application.
+ *
+ * @param config - Generator configuration
+ *
+ * @example
+ * ```typescript
+ * // Use placeholder for testing
+ * configureValueGenerator({ type: 'placeholder' })
+ *
+ * // Use AI for production
+ * configureValueGenerator({
+ *   type: 'ai',
+ *   aiFunction: myAIFunction,
+ *   model: 'claude-3',
+ *   fallbackToPlaceholder: true,
+ * })
+ * ```
+ */
+export declare function configureValueGenerator(config: ValueGeneratorConfig): void;
+/**
+ * Get the current global value generator
+ *
+ * Returns the configured generator instance, creating one if needed.
+ * Use this to get the generator configured via configureValueGenerator.
+ *
+ * @returns The current ValueGenerator instance
+ *
+ * @example
+ * ```typescript
+ * const generator = getValueGenerator()
+ * const result = await generator.generate({
+ *   fieldName: 'description',
+ *   type: 'Product',
+ * })
+ * ```
+ */
+export declare function getValueGenerator(): ValueGenerator;
+/**
+ * Generate a context-aware value for a field
+ *
+ * This is a convenience function that uses the global generator.
+ * Equivalent to calling `getValueGenerator().generate(request)`.
+ *
+ * @deprecated Use `getValueGenerator().generate()` instead
+ *
+ * @param fieldName - The name of the field being generated
+ * @param type - The entity type name
+ * @param fullContext - Combined context string
+ * @param hint - Optional hint text for guiding generation
+ * @param parentData - Parent entity data for context inheritance
+ * @returns A generated string value
+ */
+export declare function generateContextAwareValue(fieldName: string, type: string, fullContext: string, hint: string | undefined, parentData?: Record<string, unknown>): Promise<string>;
+/**
+ * Synchronous wrapper for generateContextAwareValue
+ *
+ * Uses the PlaceholderValueGenerator directly for synchronous calls.
+ * This maintains backward compatibility with existing cascade.ts code.
+ *
+ * @param fieldName - The name of the field being generated
+ * @param type - The entity type name
+ * @param fullContext - Combined context string
+ * @param hint - Optional hint text for guiding generation
+ * @param parentData - Parent entity data for context inheritance
+ * @returns A generated string value
+ */
+export declare function generateContextAwareValueSync(fieldName: string, type: string, fullContext: string, hint: string | undefined, parentData?: Record<string, unknown>): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/schema/value-generators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/schema/value-generators/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,UAAU,EACV,YAAY,EACZ,qBAAqB,GACtB,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAA;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAC1C,YAAY,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAErD,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AActE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,oBAAyB,GAAG,cAAc,CAmBtF;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAG1E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACvC,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACvC,MAAM,CA8CR"}

package/dist/schema/value-generators/index.js

@@ -0,0 +1,219 @@
+/**
+ * ValueGenerator Module
+ *
+ * Strategy pattern for value generation during entity creation.
+ * Supports both placeholder (deterministic test fixtures) and
+ * AI-powered (production) generation.
+ *
+ * @example
+ * ```typescript
+ * // Use placeholder generator for testing
+ * const generator = createValueGenerator({ type: 'placeholder' })
+ * const result = await generator.generate({
+ *   fieldName: 'name',
+ *   type: 'Person',
+ *   fullContext: 'tech entrepreneur startup',
+ * })
+ *
+ * // Configure global generator for AI in production
+ * configureValueGenerator({
+ *   type: 'ai',
+ *   aiFunction: async (prompt) => ({ text: await callAI(prompt) }),
+ * })
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Re-export implementations
+export { PlaceholderValueGenerator } from './placeholder.js';
+export { AIValueGenerator } from './ai.js';
+import { PlaceholderValueGenerator } from './placeholder.js';
+import { AIValueGenerator } from './ai.js';
+// =============================================================================
+// Global Generator Configuration
+// =============================================================================
+/** Current global generator instance */
+let currentGenerator = null;
+/** Current configuration */
+let currentConfig = { type: 'placeholder' };
+/**
+ * Create a ValueGenerator based on configuration
+ *
+ * @param config - Generator configuration
+ * @returns A new ValueGenerator instance
+ * @throws Error if AI type is specified without aiFunction
+ *
+ * @example
+ * ```typescript
+ * // Create placeholder generator (default)
+ * const placeholderGen = createValueGenerator()
+ *
+ * // Create placeholder generator explicitly
+ * const placeholderGen = createValueGenerator({ type: 'placeholder' })
+ *
+ * // Create AI generator
+ * const aiGen = createValueGenerator({
+ *   type: 'ai',
+ *   aiFunction: async (prompt) => ({ text: 'AI response' }),
+ * })
+ * ```
+ */
+export function createValueGenerator(config = {}) {
+    const type = config.type ?? 'placeholder';
+    if (type === 'ai') {
+        if (!config.aiFunction) {
+            throw new Error('aiFunction is required when creating an AI value generator');
+        }
+        const aiConfig = {
+            aiFunction: config.aiFunction,
+        };
+        if (config.model !== undefined)
+            aiConfig.model = config.model;
+        if (config.maxTokens !== undefined)
+            aiConfig.maxTokens = config.maxTokens;
+        if (config.temperature !== undefined)
+            aiConfig.temperature = config.temperature;
+        if (config.fallbackToPlaceholder !== undefined)
+            aiConfig.fallbackToPlaceholder = config.fallbackToPlaceholder;
+        return new AIValueGenerator(aiConfig);
+    }
+    return new PlaceholderValueGenerator();
+}
+/**
+ * Configure the global default value generator
+ *
+ * Call this at application startup to set the default generator
+ * that will be used throughout the application.
+ *
+ * @param config - Generator configuration
+ *
+ * @example
+ * ```typescript
+ * // Use placeholder for testing
+ * configureValueGenerator({ type: 'placeholder' })
+ *
+ * // Use AI for production
+ * configureValueGenerator({
+ *   type: 'ai',
+ *   aiFunction: myAIFunction,
+ *   model: 'claude-3',
+ *   fallbackToPlaceholder: true,
+ * })
+ * ```
+ */
+export function configureValueGenerator(config) {
+    currentConfig = { ...config };
+    currentGenerator = null; // Reset so next getValueGenerator creates a new instance
+}
+/**
+ * Get the current global value generator
+ *
+ * Returns the configured generator instance, creating one if needed.
+ * Use this to get the generator configured via configureValueGenerator.
+ *
+ * @returns The current ValueGenerator instance
+ *
+ * @example
+ * ```typescript
+ * const generator = getValueGenerator()
+ * const result = await generator.generate({
+ *   fieldName: 'description',
+ *   type: 'Product',
+ * })
+ * ```
+ */
+export function getValueGenerator() {
+    if (!currentGenerator) {
+        currentGenerator = createValueGenerator(currentConfig);
+    }
+    return currentGenerator;
+}
+// =============================================================================
+// Legacy Compatibility
+// =============================================================================
+/**
+ * Generate a context-aware value for a field
+ *
+ * This is a convenience function that uses the global generator.
+ * Equivalent to calling `getValueGenerator().generate(request)`.
+ *
+ * @deprecated Use `getValueGenerator().generate()` instead
+ *
+ * @param fieldName - The name of the field being generated
+ * @param type - The entity type name
+ * @param fullContext - Combined context string
+ * @param hint - Optional hint text for guiding generation
+ * @param parentData - Parent entity data for context inheritance
+ * @returns A generated string value
+ */
+export async function generateContextAwareValue(fieldName, type, fullContext, hint, parentData = {}) {
+    const generator = getValueGenerator();
+    const request = {
+        fieldName,
+        type,
+        fullContext,
+        parentData,
+    };
+    if (hint !== undefined)
+        request.hint = hint;
+    const result = await generator.generate(request);
+    return result.value;
+}
+/**
+ * Synchronous wrapper for generateContextAwareValue
+ *
+ * Uses the PlaceholderValueGenerator directly for synchronous calls.
+ * This maintains backward compatibility with existing cascade.ts code.
+ *
+ * @param fieldName - The name of the field being generated
+ * @param type - The entity type name
+ * @param fullContext - Combined context string
+ * @param hint - Optional hint text for guiding generation
+ * @param parentData - Parent entity data for context inheritance
+ * @returns A generated string value
+ */
+export function generateContextAwareValueSync(fieldName, type, fullContext, hint, parentData = {}) {
+    // Use placeholder generator directly for sync calls
+    const generator = new PlaceholderValueGenerator();
+    // Access the private generateValue method via the generate interface
+    // Since we know PlaceholderValueGenerator.generate is sync-compatible
+    const request = {
+        fieldName,
+        type,
+        fullContext,
+        parentData,
+    };
+    if (hint !== undefined)
+        request.hint = hint;
+    // We can safely synchronously return since PlaceholderValueGenerator
+    // doesn't actually do any async work in its current implementation
+    let result = '';
+    void generator.generate(request).then((r) => {
+        result = r.value;
+    });
+    // For true sync behavior, we need to inline the logic
+    // This duplicates the logic but maintains backward compatibility
+    const value = parentData[fieldName];
+    if (typeof value === 'string' && value) {
+        return value;
+    }
+    if (!fullContext || fullContext.trim() === '') {
+        return `Generated ${fieldName} for ${type}`;
+    }
+    const contextLower = fullContext.toLowerCase();
+    const hintLower = (hint || '').toLowerCase();
+    // Minimal subset of field handlers for common cases
+    // Full logic is in PlaceholderValueGenerator
+    if (fieldName === 'name') {
+        if (hintLower.includes('philosopher') || contextLower.includes('philosopher'))
+            return 'Aristotle';
+        if (hintLower.includes('tech entrepreneur') || hintLower.includes('startup'))
+            return 'Alex Chen';
+        if (hint && hint.trim())
+            return `${type}: ${hint}`;
+        return `Generated ${fieldName} for ${type}`;
+    }
+    // For all other fields, use a basic fallback
+    return `${fieldName}: ${fullContext}`;
+}
+//# sourceMappingURL=index.js.map