@future-explorer/lib 1.0.10 → 1.0.11

package/README.md

@@ -87,10 +87,9 @@ const SentimentSchema = z.object({
 });
 
 // Generate structured response
-const result = await client.generateStructuredResponse({
-  schema: SentimentSchema,
-  userPrompt: 'I absolutely love this product!',
-  systemMessage: 'You are a sentiment analysis expert.',
+const result = await client.generateStructuredResponse(SentimentSchema, {
+  prompt: 'I absolutely love this product!',
+  system: 'You are a sentiment analysis expert.',
 });
 
 console.log(result.sentiment); // 'positive'
@@ -108,7 +107,7 @@ console.log(result.summary); // '...'
 
 ### Methods
 
-- `generateStructuredResponse<T>(params: GenerateObjectParams<T>)`: Generates a structured response matching the Zod schema. Accepts `schema`, `userPrompt`, `systemMessage`, plus any additional `generateObject()` options
+- `generateStructuredResponse<T>(schema: ZodSchema<T>, params: GenerateObjectParams<T>)`: Generates a structured response matching the Zod schema. Accepts `prompt`, `system`, plus any additional options
 - `getModel()`: Returns the underlying LanguageModel instance
 
 ## Development

package/dist/clients/ai/unified/unified-ai-client.d.ts

@@ -1,4 +1,5 @@
 import { LanguageModel } from 'ai';
+import { ZodSchema } from 'zod';
 import { GenerateObjectParams, Provider } from './unified-ai-client.model';
 /**
  * Unified AI Client that supports multiple AI providers (OpenAI, XAI, Gemini)
@@ -12,8 +13,10 @@ export declare class UnifiedAiClient {
      *
      * @template T - The type inferred from the Zod schema
      *
-     * @param params - Configuration object for the structured response generation.
-     *                  See {@link GenerateObjectParams} for all available options.
+     * @param schema - Zod schema defining the expected response structure.
+     *                 The AI model will be constrained to return data matching this schema.
+     * @param params - Configuration object with prompt, system message, and any additional options.
+     *                 See {@link GenerateObjectParams} for all available options.
      *
      * @returns Promise resolving to the validated object matching the schema type T
      *
@@ -29,16 +32,15 @@ export declare class UnifiedAiClient {
      * });
      *
      * // Generate structured response
-     * const result = await service.generateStructuredResponse({
-     *   schema: SentimentSchema,
-     *   userPrompt: 'I absolutely love this product!',
-     *   systemMessage: 'You are a sentiment analysis expert. Be precise with confidence scores.',
+     * const result = await service.generateStructuredResponse(SentimentSchema, {
+     *   prompt: 'I absolutely love this product!',
+     *   system: 'You are a sentiment analysis expert. Be precise with confidence scores.',
      * });
      *
      * console.log(result.sentiment);   // 'positive'
      * console.log(result.confidence);  // 0.95
      */
-    generateStructuredResponse<T>(params: GenerateObjectParams<T>): Promise<T>;
+    generateStructuredResponse<T>(schema: ZodSchema<T>, params: GenerateObjectParams<T>): Promise<T>;
     /**
      * Retrieves the underlying LanguageModel instance.
      * @returns The LanguageModel instance used by the UnifiedAiClient.

package/dist/clients/ai/unified/unified-ai-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unified-ai-client.d.ts","sourceRoot":"","sources":["../../../../src/clients/ai/unified/unified-ai-client.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkB,aAAa,EAAE,MAAM,IAAI,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE3E;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAgB;gBAEjB,QAAQ,EAAE,QAAQ;IAI9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACG,0BAA0B,CAAC,CAAC,EAAE,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAchF;;;OAGG;IACH,QAAQ,IAAI,aAAa;IAIzB,OAAO,CAAC,WAAW;CAYpB"}
+{"version":3,"file":"unified-ai-client.d.ts","sourceRoot":"","sources":["../../../../src/clients/ai/unified/unified-ai-client.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkB,aAAa,EAAE,MAAM,IAAI,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE3E;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAgB;gBAEjB,QAAQ,EAAE,QAAQ;IAI9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACG,0BAA0B,CAAC,CAAC,EAChC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EACpB,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC9B,OAAO,CAAC,CAAC,CAAC;IAcb;;;OAGG;IACH,QAAQ,IAAI,aAAa;IAIzB,OAAO,CAAC,WAAW;CAYpB"}

package/dist/clients/ai/unified/unified-ai-client.js

@@ -20,8 +20,10 @@ class UnifiedAiClient {
      *
      * @template T - The type inferred from the Zod schema
      *
-     * @param params - Configuration object for the structured response generation.
-     *                  See {@link GenerateObjectParams} for all available options.
+     * @param schema - Zod schema defining the expected response structure.
+     *                 The AI model will be constrained to return data matching this schema.
+     * @param params - Configuration object with prompt, system message, and any additional options.
+     *                 See {@link GenerateObjectParams} for all available options.
      *
      * @returns Promise resolving to the validated object matching the schema type T
      *
@@ -37,23 +39,22 @@ class UnifiedAiClient {
      * });
      *
      * // Generate structured response
-     * const result = await service.generateStructuredResponse({
-     *   schema: SentimentSchema,
-     *   userPrompt: 'I absolutely love this product!',
-     *   systemMessage: 'You are a sentiment analysis expert. Be precise with confidence scores.',
+     * const result = await service.generateStructuredResponse(SentimentSchema, {
+     *   prompt: 'I absolutely love this product!',
+     *   system: 'You are a sentiment analysis expert. Be precise with confidence scores.',
      * });
      *
      * console.log(result.sentiment);   // 'positive'
      * console.log(result.confidence);  // 0.95
      */
-    async generateStructuredResponse(params) {
-        const { schema, userPrompt, systemMessage, ...rest } = params;
+    async generateStructuredResponse(schema, params) {
+        const { prompt, system, ...rest } = params;
         const result = await (0, ai_1.generateObject)({
             ...rest,
             model: this.model,
             schema: schema, // Option 2: Use jsonSchema instead of Zod directly: schema: jsonSchema<T>(zodToJsonSchema(schema) as any),
-            prompt: userPrompt,
-            system: systemMessage,
+            prompt: prompt,
+            system: system,
         });
         return result.object;
     }

package/dist/clients/ai/unified/unified-ai-client.model.d.ts

@@ -1,21 +1,19 @@
-import { generateObject } from 'ai';
-import { ZodSchema } from 'zod';
 /**
  * Options for generating a structured response from the AI model.
  *
- * @template T - The type inferred from the Zod schema
+ * Includes the core params (`prompt`, `system`) plus any additional options
+ * (e.g. `mode`, `schemaName`, `schemaDescription`, `maxTokens`, `temperature`, etc.).
+ * Extra properties are passed through as-is.
  *
- * Includes the core params (schema, userPrompt, systemMessage) plus
- * any additional options supported by the underlying `generateObject()` call
- * (e.g. mode, schemaName, schemaDescription, maxTokens, temperature, etc.).
+ * Note: The Zod `schema` is passed as a separate argument to `generateStructuredResponse()`.
  */
-export interface GenerateObjectParams<T> extends Omit<Parameters<typeof generateObject>[0], 'model' | 'schema' | 'prompt' | 'system' | 'messages'> {
-    /** Zod schema defining the expected response structure. */
-    schema: ZodSchema<T>;
+export interface GenerateObjectParams<T> {
     /** User input/message to send to the AI model (role: user). */
-    userPrompt: string;
+    prompt: string;
     /** Optional system instructions that define the AI's behavior, persona, and task context (role: system). */
-    systemMessage?: string;
+    system?: string;
+    /** Any additional options are passed through to the underlying AI call. */
+    [key: string]: unknown;
 }
 /**
  * Enum representing supported AI providers.

package/dist/clients/ai/unified/unified-ai-client.model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unified-ai-client.model.d.ts","sourceRoot":"","sources":["../../../../src/clients/ai/unified/unified-ai-client.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAEhC;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,CACrC,SAAQ,IAAI,CACV,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,EACpC,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CACtD;IACD,2DAA2D;IAC3D,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACrB,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,4GAA4G;IAC5G,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,oBAAY,QAAQ;IAClB;;OAEG;IACH,MAAM,WAAW;IACjB;;OAEG;IACH,GAAG,QAAQ;IACX;;OAEG;IACH,MAAM,WAAW;CAClB"}
+{"version":3,"file":"unified-ai-client.model.d.ts","sourceRoot":"","sources":["../../../../src/clients/ai/unified/unified-ai-client.model.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,4GAA4G;IAC5G,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,oBAAY,QAAQ;IAClB;;OAEG;IACH,MAAM,WAAW;IACjB;;OAEG;IACH,GAAG,QAAQ;IACX;;OAEG;IACH,MAAM,WAAW;CAClB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@future-explorer/lib",
-  "version": "1.0.10",
+  "version": "1.0.11",
   "description": "Shared utilities and clients for Future Explorer projects",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -52,14 +52,17 @@
     "zod": "^4.2.0"
   },
   "devDependencies": {
-    "@types/node": "^24.5.2",
+    "@types/node": "^24.10.12",
     "@typescript-eslint/eslint-plugin": "^8.0.0",
     "@typescript-eslint/parser": "^8.0.0",
+    "dotenv": "^17.2.4",
     "eslint": "^9.20.1",
     "eslint-config-prettier": "^10.0.1",
     "eslint-plugin-prettier": "^5.2.3",
     "prettier": "^3.5.1",
     "rimraf": "^6.0.1",
-    "typescript": "^5.6.3"
+    "ts-node": "^10.9.2",
+    "typescript": "^5.6.3",
+    "zod": "4.2.0"
   }
 }