@graphext/cuery 0.6.0 → 0.6.2

package/esm/mod.d.ts

@@ -19,6 +19,7 @@ export * from './src/tools/sentiment.js';
 export * from './src/tools/summarize.js';
 export * from './src/tools/sources.js';
 export * from './src/tools/entities.js';
+export * from './src/tools/prompts.js';
 export * from './src/helpers/seedKeywords.js';
 export * from './src/tools/generic.js';
 export * from './src/api.js';

package/esm/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EACN,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,SAAS,GACd,MAAM,0BAA0B,CAAC;AAGlC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EACN,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,SAAS,GACd,MAAM,0BAA0B,CAAC;AAGlC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wBAAwB,CAAC"}

package/esm/mod.js

@@ -21,6 +21,7 @@ export * from './src/tools/sentiment.js';
 export * from './src/tools/summarize.js';
 export * from './src/tools/sources.js';
 export * from './src/tools/entities.js';
+export * from './src/tools/prompts.js';
 export * from './src/helpers/seedKeywords.js';
 export * from './src/tools/generic.js';
 export * from './src/api.js';

package/esm/src/llm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/src/llm.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,4CAA4C,CAAC;AACpE,OAAO,EAAuB,KAAK,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGhH,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG/G,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,MAAM;IACvC,2CAA2C;IAC3C,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,CAAC;IAC3B,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC7B,mCAAmC;IACnC,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC7B;AAYD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,CAAC,GAAG,MAAM,EAAE,EAC5C,MAAM,EACN,KAAK,EACL,MAAM,EACN,MAAM,EACN,UAAc,EACd,OAAiB,GACjB,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAwC3C;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,CAAC,GAAG,MAAM,EACtC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC,GACrD,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAEzB"}
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/src/llm.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,4CAA4C,CAAC;AAEpE,OAAO,EAEN,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG/G,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,MAAM;IACvC,2CAA2C;IAC3C,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,CAAC;IAC3B,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC7B,mCAAmC;IACnC,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC7B;AAYD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,CAAC,GAAG,MAAM,EAAE,EAC5C,MAAM,EACN,KAAK,EACL,MAAM,EACN,MAAM,EACN,UAAc,EACd,OAAiB,GACjB,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CA4C3C;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,CAAC,GAAG,MAAM,EACtC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC,GACrD,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAEzB"}

package/esm/src/llm.js

@@ -1,7 +1,8 @@
 /**
  * Unified LLM interface - provider-agnostic API for making LLM calls.
  */
-import { getProviderForModel } from './providers/index.js';
+import { SchemaValidationError } from './providers/errors.js';
+import { getProviderForModel, } from './providers/index.js';
 export { calculateCost } from './providers/index.js';
 /**
  * Normalize a prompt to a message array.
@@ -32,9 +33,9 @@ export async function askLLMSafe({ prompt, model, schema, params, maxRetries = 3
             error: response.error ?? new Error('Unknown error'),
         };
         if (attempt < maxRetries && response.error) {
-            // Add error context to messages for retry
-            const errorMessage = `Previous attempt failed with error: ${response.error.message}`;
-            if (response.text) {
+            let errorMessage;
+            if (response.error instanceof SchemaValidationError) {
+                errorMessage = `Previous attempt failed with Zod parsing error:\n${response.error.message}.`;
                 messages = [
                     ...messages,
                     {
@@ -43,7 +44,10 @@ export async function askLLMSafe({ prompt, model, schema, params, maxRetries = 3
                     },
                 ];
             }
-            console.log(`askLLMSafe retrying! Attempt ${attempt + 1} failed: ${response.error.message}`);
+            else {
+                errorMessage = `Previous attempt failed with error: ${response.error.message}`;
+            }
+            console.log(`askLLMSafe retrying! Attempt ${attempt + 1} failed with: ${errorMessage}`);
         }
     }
     if (onError === 'return') {

package/esm/src/providers/errors.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Error indicating model output failed schema validation.
+ */
+export declare class SchemaValidationError extends Error {
+    readonly cause?: unknown;
+    constructor(message: string, cause?: unknown);
+}
+//# sourceMappingURL=errors.d.ts.map

package/esm/src/providers/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/src/providers/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC/C,SAAkB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEtB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAK5C"}

package/esm/src/providers/errors.js

@@ -0,0 +1,11 @@
+/**
+ * Error indicating model output failed schema validation.
+ */
+export class SchemaValidationError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.name = 'SchemaValidationError';
+        this.cause = cause;
+    }
+}

package/esm/src/providers/google.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../../src/src/providers/google.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC,EAAE,MAAM,+CAA+C,CAAC;AAElE,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAuCpF;;GAEG;AACH,qBAAa,cAAe,YAAW,WAAW;IACjD,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,CAAC,EAAE,MAAM;IAUrB,QAAQ,CAAC,CAAC,EACf,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,EAC3B,MAAM,CAAC,EAAE,cAAc,GACrB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CA8D1B"}
+{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../../src/src/providers/google.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC,EAAE,MAAM,+CAA+C,CAAC;AAGlE,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAuCpF;;GAEG;AACH,qBAAa,cAAe,YAAW,WAAW;IACjD,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,CAAC,EAAE,MAAM;IAUrB,QAAQ,CAAC,CAAC,EACf,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,EAC3B,MAAM,CAAC,EAAE,cAAc,GACrB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CAiE1B"}

package/esm/src/providers/google.js

@@ -4,6 +4,7 @@
 import * as dntShim from "../../_dnt.shims.js";
 import { GoogleGenAI } from '@google/genai';
 import { z } from '../../deps/jsr.io/@zod/zod/4.3.6/src/index.js';
+import { SchemaValidationError } from './errors.js';
 /**
  * Convert messages to Gemini content format.
  * Handles system prompts by prepending them as context.
@@ -88,7 +89,7 @@ export class GoogleProvider {
                         parsed: null,
                         text,
                         usage,
-                        error: error instanceof Error ? error : new Error(String(error)),
+                        error: new SchemaValidationError(error instanceof Error ? error.message : String(error), error),
                     };
                 }
             }

package/esm/src/providers/index.d.ts

@@ -8,6 +8,7 @@
 export { getProvider, getProviderForModel } from './registry.js';
 export { OpenAIProvider } from './openai.js';
 export { GoogleProvider } from './google.js';
+export { SchemaValidationError } from './errors.js';
 export { getModelPricing, getModelInfo, calculateCost, type ModelPricing, type ModelInfo, } from './pricing.js';
 export type { Message, LLMResponse, LLMProvider, ProviderParams, LLMConversation, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/esm/src/providers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGjE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EACN,eAAe,EACf,YAAY,EACZ,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,SAAS,GACd,MAAM,cAAc,CAAC;AAGtB,YAAY,EACX,OAAO,EACP,WAAW,EACX,WAAW,EACX,cAAc,EACd,eAAe,GACf,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGjE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGpD,OAAO,EACN,eAAe,EACf,YAAY,EACZ,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,SAAS,GACd,MAAM,cAAc,CAAC;AAGtB,YAAY,EACX,OAAO,EACP,WAAW,EACX,WAAW,EACX,cAAc,EACd,eAAe,GACf,MAAM,YAAY,CAAC"}

package/esm/src/providers/index.js

@@ -10,5 +10,6 @@ export { getProvider, getProviderForModel } from './registry.js';
 // Re-export provider implementations
 export { OpenAIProvider } from './openai.js';
 export { GoogleProvider } from './google.js';
+export { SchemaValidationError } from './errors.js';
 // Re-export pricing utilities
 export { getModelPricing, getModelInfo, calculateCost, } from './pricing.js';

package/esm/src/providers/openai.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/src/providers/openai.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC,EAAE,MAAM,+CAA+C,CAAC;AAElE,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAyFpF;;GAEG;AACH,qBAAa,cAAe,YAAW,WAAW;IACjD,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,CAAC,EAAE,MAAM;IAarB,QAAQ,CAAC,CAAC,EACf,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,EAC3B,MAAM,CAAC,EAAE,cAAc,GACrB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CAkD1B"}
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/src/providers/openai.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC,EAAE,MAAM,+CAA+C,CAAC;AAGlE,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA0FpF;;GAEG;AACH,qBAAa,cAAe,YAAW,WAAW;IACjD,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,CAAC,EAAE,MAAM;IAarB,QAAQ,CAAC,CAAC,EACf,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,EAC3B,MAAM,CAAC,EAAE,cAAc,GACrB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CAuD1B"}

package/esm/src/providers/openai.js

@@ -4,9 +4,8 @@
 import * as dntShim from "../../_dnt.shims.js";
 import OpenAI from 'openai';
 import { z } from '../../deps/jsr.io/@zod/zod/4.3.6/src/index.js';
+import { SchemaValidationError } from './errors.js';
 const zodTextFormatCache = new Map();
-class ZodValidationError extends Error {
-}
 /**
  * Sanitizes a JSON schema for OpenAI compatibility.
  * OpenAI's structured output has strict requirements:
@@ -67,7 +66,7 @@ function zodTextFormat(zodObject, name) {
                 return zodObject.parse(JSON.parse(content));
             }
             catch (error) {
-                return new ZodValidationError(error instanceof Error ? error.message : String(error));
+                return new SchemaValidationError(error instanceof Error ? error.message : String(error), error);
             }
         },
         __output: undefined,
@@ -115,11 +114,15 @@ export class OpenAIProvider {
                 }
                 : null;
             if (response.output_parsed instanceof Error) {
+                const parseError = response.output_parsed;
+                const error = parseError instanceof SchemaValidationError
+                    ? parseError
+                    : new SchemaValidationError(parseError.message, parseError);
                 return {
                     parsed: null,
                     text: response.output_text,
                     usage,
-                    error: response.output_parsed,
+                    error,
                 };
             }
             return {

package/esm/src/schemas/index.d.ts

@@ -19,4 +19,5 @@ export type * from './models.schema.js';
 export type * from './seedKeyword.schema.js';
 export type * from './topics.schema.js';
 export type * from './summary.schema.js';
+export type * from './prompt.schema.js';
 //# sourceMappingURL=index.d.ts.map

package/esm/src/schemas/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,sBAAsB,CAAC;AAC1C,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,sBAAsB,CAAC;AAC1C,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,oBAAoB,CAAC"}

package/esm/src/schemas/prompt.schema.d.ts

@@ -0,0 +1,59 @@
+import { z } from '../../deps/jsr.io/@zod/zod/4.3.6/src/index.js';
+/**
+ * Zod schemas for AI visibility prompt generation.
+ *
+ * ⚠️ This file should contain ONLY schema definitions.
+ * No business logic, prompts, or function implementations.
+ */
+export declare const PromptIntentSchema: z.ZodEnum<{
+    local: "local";
+    comparison: "comparison";
+    informational: "informational";
+    navigational: "navigational";
+    transactional: "transactional";
+    commercial: "commercial";
+    troubleshooting: "troubleshooting";
+}>;
+export type PromptIntent = z.infer<typeof PromptIntentSchema>;
+export declare const PromptIdeaSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    intent: z.ZodEnum<{
+        local: "local";
+        comparison: "comparison";
+        informational: "informational";
+        navigational: "navigational";
+        transactional: "transactional";
+        commercial: "commercial";
+        troubleshooting: "troubleshooting";
+    }>;
+}, z.core.$strip>;
+export type PromptIdea = z.infer<typeof PromptIdeaSchema>;
+export declare const PromptListSchema: z.ZodArray<z.ZodObject<{
+    prompt: z.ZodString;
+    intent: z.ZodEnum<{
+        local: "local";
+        comparison: "comparison";
+        informational: "informational";
+        navigational: "navigational";
+        transactional: "transactional";
+        commercial: "commercial";
+        troubleshooting: "troubleshooting";
+    }>;
+}, z.core.$strip>>;
+export type PromptList = z.infer<typeof PromptListSchema>;
+export declare const PromptListResponseSchema: z.ZodObject<{
+    prompts: z.ZodArray<z.ZodObject<{
+        prompt: z.ZodString;
+        intent: z.ZodEnum<{
+            local: "local";
+            comparison: "comparison";
+            informational: "informational";
+            navigational: "navigational";
+            transactional: "transactional";
+            commercial: "commercial";
+            troubleshooting: "troubleshooting";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PromptListResponse = z.infer<typeof PromptListResponseSchema>;
+//# sourceMappingURL=prompt.schema.d.ts.map

package/esm/src/schemas/prompt.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.schema.d.ts","sourceRoot":"","sources":["../../../src/src/schemas/prompt.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,+CAA+C,CAAC;AAElE;;;;;GAKG;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;EAQ7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,gBAAgB;;;;;;;;;;;iBAG3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,gBAAgB;;;;;;;;;;;kBAC2B,CAAC;AAEzD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;iBAEnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/esm/src/schemas/prompt.schema.js

@@ -0,0 +1,25 @@
+import { z } from '../../deps/jsr.io/@zod/zod/4.3.6/src/index.js';
+/**
+ * Zod schemas for AI visibility prompt generation.
+ *
+ * ⚠️ This file should contain ONLY schema definitions.
+ * No business logic, prompts, or function implementations.
+ */
+export const PromptIntentSchema = z.enum([
+    'informational',
+    'navigational',
+    'transactional',
+    'commercial',
+    'comparison',
+    'troubleshooting',
+    'local'
+]);
+export const PromptIdeaSchema = z.object({
+    prompt: z.string().min(3).describe('A realistic natural-language prompt a user would type into an LLM search engine.'),
+    intent: PromptIntentSchema.describe('Primary intent of the prompt.')
+});
+export const PromptListSchema = z.array(PromptIdeaSchema)
+    .describe('Generated prompt ideas with intent labels.');
+export const PromptListResponseSchema = z.object({
+    prompts: PromptListSchema
+});

package/esm/src/tools/prompts.d.ts

@@ -0,0 +1,53 @@
+import type { z } from '../../deps/jsr.io/@zod/zod/4.3.6/src/index.js';
+import { Tool, type ModelConfig } from '../tool.js';
+import type { Message } from '../llm.js';
+import { type PromptList, type PromptListResponse, type PromptIntent } from '../schemas/prompt.schema.js';
+export interface PromptGeneratorConfig {
+    /** Minimum number of prompts to generate (default: 5) */
+    minPrompts?: number;
+    /** Maximum number of prompts to generate (default: 100) */
+    maxPrompts?: number;
+    /** Language for prompts (default: inferred from instructions) */
+    language?: string;
+    /** Optional topic context to guide prompt generation */
+    topics?: Array<string | {
+        topic: string;
+        subtopics?: Array<string>;
+    }>;
+    /** Optional persona context to guide prompt generation */
+    personas?: Array<string | {
+        name: string;
+        description?: string;
+    }>;
+    /** Optional intent whitelist to focus generation */
+    intents?: Array<PromptIntent>;
+    /** Optional extra instructions to always apply */
+    instructions?: string;
+}
+/**
+ * A tool that generates realistic LLM prompts for AI visibility analysis.
+ * Input is a single "instructions" string describing the topic and constraints.
+ */
+export declare class PromptGenerator extends Tool<string | null, PromptListResponse, PromptList> {
+    private readonly systemPrompt;
+    private readonly contextBlocks;
+    private readonly responseSchema;
+    constructor(config: PromptGeneratorConfig | undefined, modelConfig: ModelConfig);
+    protected schema(): z.ZodType<{
+        prompts: {
+            prompt: string;
+            intent: "local" | "comparison" | "informational" | "navigational" | "transactional" | "commercial" | "troubleshooting";
+        }[];
+    }, unknown, z.core.$ZodTypeInternals<{
+        prompts: {
+            prompt: string;
+            intent: "local" | "comparison" | "informational" | "navigational" | "transactional" | "commercial" | "troubleshooting";
+        }[];
+    }, unknown>>;
+    protected prompt(instructions: string | null): Message[];
+    protected isEmpty(instructions: string | null): boolean;
+    protected extractResult(parsed: PromptListResponse): PromptList;
+}
+export type { PromptList, PromptListResponse, PromptIdea, PromptIntent } from '../schemas/prompt.schema.js';
+export { PromptListSchema, PromptListResponseSchema, PromptIdeaSchema, PromptIntentSchema } from '../schemas/prompt.schema.js';
+//# sourceMappingURL=prompts.d.ts.map

package/esm/src/tools/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/src/tools/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,+CAA+C,CAAC;AACvE,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAGN,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,MAAM,6BAA6B,CAAC;AA6BrC,MAAM,WAAW,qBAAqB;IACrC,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC,CAAC;IACtE,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,oDAAoD;IACpD,OAAO,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAC9B,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,kBAAkB,EAAE,UAAU,CAAC;IACvF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgC;gBAEnD,MAAM,EAAE,qBAAqB,YAAK,EAAE,WAAW,EAAE,WAAW;cAiErD,MAAM;;;;;;;;;;;IAIzB,SAAS,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,EAAE;cAQrC,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;cAI7C,aAAa,CAAC,MAAM,EAAE,kBAAkB,GAAG,UAAU;CAGxE;AAED,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC5G,OAAO,EACN,gBAAgB,EAChB,wBAAwB,EACxB,gBAAgB,EAChB,kBAAkB,EAClB,MAAM,6BAA6B,CAAC"}

package/esm/src/tools/prompts.js

@@ -0,0 +1,106 @@
+import { Tool } from '../tool.js';
+import { PromptListSchema, PromptListResponseSchema } from '../schemas/prompt.schema.js';
+import { dedent } from '../helpers/utils.js';
+const PROMPT_SYSTEM = dedent(`
+You generate realistic natural-language prompts for AI visibility testing with LLM search engines.
+
+Follow the user's instructions exactly and only use the context they provide.
+
+Output requirements:
+- Return a JSON object with a "prompts" array.
+- Each object must include: prompt, intent.
+- The "intent" must be one of: informational, navigational, transactional, commercial, comparison, troubleshooting, local.
+- Generate between {min} and {max} prompts unless the instructions request a number within that range.
+- If the instructions specify how many prompts to generate, follow that.
+
+Quality rules:
+- Prompts should read like real user questions or requests for an AI assistant, not keyword fragments.
+- Cover a mix of intents and realistic personas; avoid repeating the same intent across many prompts.
+- If topics or personas are provided, use them as context to shape prompts (but do not output them).
+- Avoid brand names unless the instructions explicitly include them.
+- Keep prompts focused on the topic and avoid hallucinated claims.
+`);
+const PROMPT_USER = dedent(`
+# Instructions
+
+{instructions}
+`);
+/**
+ * A tool that generates realistic LLM prompts for AI visibility analysis.
+ * Input is a single "instructions" string describing the topic and constraints.
+ */
+export class PromptGenerator extends Tool {
+    systemPrompt;
+    contextBlocks;
+    responseSchema;
+    constructor(config = {}, modelConfig) {
+        super(modelConfig);
+        const { minPrompts = 5, maxPrompts = 100, language, topics, personas, intents, instructions } = config;
+        if (minPrompts < 0) {
+            throw new Error('minPrompts must be >= 0');
+        }
+        if (maxPrompts < minPrompts) {
+            throw new Error('maxPrompts must be >= minPrompts');
+        }
+        const contextParts = [];
+        if (instructions && instructions.trim() !== '') {
+            contextParts.push(dedent(`
+			# Additional Instructions
+
+			${instructions}
+			`));
+        }
+        if (language) {
+            contextParts.push(dedent(`
+			# Language
+
+			Generate prompts in: ${language}
+			`));
+        }
+        if (topics && topics.length > 0) {
+            contextParts.push(dedent(`
+			# Topics (Optional Context)
+
+			${JSON.stringify(topics, null, 2)}
+			`));
+        }
+        if (personas && personas.length > 0) {
+            contextParts.push(dedent(`
+			# Personas (Optional Context)
+
+			${JSON.stringify(personas, null, 2)}
+			`));
+        }
+        if (intents && intents.length > 0) {
+            contextParts.push(dedent(`
+			# Intent Focus (Optional)
+
+			${JSON.stringify(intents, null, 2)}
+			`));
+        }
+        this.contextBlocks = contextParts.join('\n\n');
+        this.systemPrompt = PROMPT_SYSTEM
+            .replace('{min}', String(minPrompts))
+            .replace('{max}', String(maxPrompts));
+        this.responseSchema = PromptListResponseSchema.extend({
+            prompts: PromptListSchema.min(minPrompts).max(maxPrompts)
+        });
+    }
+    schema() {
+        return this.responseSchema;
+    }
+    prompt(instructions) {
+        const userPrompt = PROMPT_USER.replace('{instructions}', instructions ?? '');
+        return [
+            { role: 'system', content: this.systemPrompt },
+            { role: 'user', content: this.contextBlocks ? `${userPrompt}\n\n${this.contextBlocks}` : userPrompt }
+        ];
+    }
+    isEmpty(instructions) {
+        return instructions == null || instructions.trim() === '';
+    }
+    extractResult(parsed) {
+        return parsed.prompts;
+    }
+}
+export { PromptListSchema, PromptListResponseSchema, PromptIdeaSchema, PromptIntentSchema } from '../schemas/prompt.schema.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graphext/cuery",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Cuery tools for AI-powered keyword research and brand analysis",
   "repository": {
     "type": "git",

package/script/mod.d.ts

@@ -19,6 +19,7 @@ export * from './src/tools/sentiment.js';
 export * from './src/tools/summarize.js';
 export * from './src/tools/sources.js';
 export * from './src/tools/entities.js';
+export * from './src/tools/prompts.js';
 export * from './src/helpers/seedKeywords.js';
 export * from './src/tools/generic.js';
 export * from './src/api.js';

package/script/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EACN,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,SAAS,GACd,MAAM,0BAA0B,CAAC;AAGlC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EACN,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,SAAS,GACd,MAAM,0BAA0B,CAAC;AAGlC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wBAAwB,CAAC"}

package/script/mod.js

@@ -44,6 +44,7 @@ __exportStar(require("./src/tools/sentiment.js"), exports);
 __exportStar(require("./src/tools/summarize.js"), exports);
 __exportStar(require("./src/tools/sources.js"), exports);
 __exportStar(require("./src/tools/entities.js"), exports);
+__exportStar(require("./src/tools/prompts.js"), exports);
 __exportStar(require("./src/helpers/seedKeywords.js"), exports);
 __exportStar(require("./src/tools/generic.js"), exports);
 __exportStar(require("./src/api.js"), exports);

package/script/src/llm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/src/llm.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,4CAA4C,CAAC;AACpE,OAAO,EAAuB,KAAK,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGhH,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG/G,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,MAAM;IACvC,2CAA2C;IAC3C,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,CAAC;IAC3B,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC7B,mCAAmC;IACnC,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC7B;AAYD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,CAAC,GAAG,MAAM,EAAE,EAC5C,MAAM,EACN,KAAK,EACL,MAAM,EACN,MAAM,EACN,UAAc,EACd,OAAiB,GACjB,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAwC3C;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,CAAC,GAAG,MAAM,EACtC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC,GACrD,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAEzB"}
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/src/llm.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,4CAA4C,CAAC;AAEpE,OAAO,EAEN,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG/G,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,MAAM;IACvC,2CAA2C;IAC3C,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,CAAC;IAC3B,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC7B,mCAAmC;IACnC,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC7B;AAYD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,CAAC,GAAG,MAAM,EAAE,EAC5C,MAAM,EACN,KAAK,EACL,MAAM,EACN,MAAM,EACN,UAAc,EACd,OAAiB,GACjB,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CA4C3C;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,CAAC,GAAG,MAAM,EACtC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC,GACrD,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAEzB"}

package/script/src/llm.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.calculateCost = void 0;
 exports.askLLMSafe = askLLMSafe;
 exports.askLLM = askLLM;
+const errors_js_1 = require("./providers/errors.js");
 const index_js_1 = require("./providers/index.js");
 var index_js_2 = require("./providers/index.js");
 Object.defineProperty(exports, "calculateCost", { enumerable: true, get: function () { return index_js_2.calculateCost; } });
@@ -38,9 +39,9 @@ async function askLLMSafe({ prompt, model, schema, params, maxRetries = 3, onErr
             error: response.error ?? new Error('Unknown error'),
         };
         if (attempt < maxRetries && response.error) {
-            // Add error context to messages for retry
-            const errorMessage = `Previous attempt failed with error: ${response.error.message}`;
-            if (response.text) {
+            let errorMessage;
+            if (response.error instanceof errors_js_1.SchemaValidationError) {
+                errorMessage = `Previous attempt failed with Zod parsing error:\n${response.error.message}.`;
                 messages = [
                     ...messages,
                     {
@@ -49,7 +50,10 @@ async function askLLMSafe({ prompt, model, schema, params, maxRetries = 3, onErr
                     },
                 ];
             }
-            console.log(`askLLMSafe retrying! Attempt ${attempt + 1} failed: ${response.error.message}`);
+            else {
+                errorMessage = `Previous attempt failed with error: ${response.error.message}`;
+            }
+            console.log(`askLLMSafe retrying! Attempt ${attempt + 1} failed with: ${errorMessage}`);
         }
     }
     if (onError === 'return') {

package/script/src/providers/errors.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Error indicating model output failed schema validation.
+ */
+export declare class SchemaValidationError extends Error {
+    readonly cause?: unknown;
+    constructor(message: string, cause?: unknown);
+}
+//# sourceMappingURL=errors.d.ts.map

package/script/src/providers/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/src/providers/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC/C,SAAkB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEtB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAK5C"}

package/script/src/providers/errors.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchemaValidationError = void 0;
+/**
+ * Error indicating model output failed schema validation.
+ */
+class SchemaValidationError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.name = 'SchemaValidationError';
+        this.cause = cause;
+    }
+}
+exports.SchemaValidationError = SchemaValidationError;

package/script/src/providers/google.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../../src/src/providers/google.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC,EAAE,MAAM,+CAA+C,CAAC;AAElE,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAuCpF;;GAEG;AACH,qBAAa,cAAe,YAAW,WAAW;IACjD,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,CAAC,EAAE,MAAM;IAUrB,QAAQ,CAAC,CAAC,EACf,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,EAC3B,MAAM,CAAC,EAAE,cAAc,GACrB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CA8D1B"}
+{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../../src/src/providers/google.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC,EAAE,MAAM,+CAA+C,CAAC;AAGlE,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAuCpF;;GAEG;AACH,qBAAa,cAAe,YAAW,WAAW;IACjD,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,CAAC,EAAE,MAAM;IAUrB,QAAQ,CAAC,CAAC,EACf,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,EAC3B,MAAM,CAAC,EAAE,cAAc,GACrB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CAiE1B"}

package/script/src/providers/google.js

@@ -40,6 +40,7 @@ exports.GoogleProvider = void 0;
 const dntShim = __importStar(require("../../_dnt.shims.js"));
 const genai_1 = require("@google/genai");
 const index_js_1 = require("../../deps/jsr.io/@zod/zod/4.3.6/src/index.js");
+const errors_js_1 = require("./errors.js");
 /**
  * Convert messages to Gemini content format.
  * Handles system prompts by prepending them as context.
@@ -124,7 +125,7 @@ class GoogleProvider {
                         parsed: null,
                         text,
                         usage,
-                        error: error instanceof Error ? error : new Error(String(error)),
+                        error: new errors_js_1.SchemaValidationError(error instanceof Error ? error.message : String(error), error),
                     };
                 }
             }

package/script/src/providers/index.d.ts

@@ -8,6 +8,7 @@
 export { getProvider, getProviderForModel } from './registry.js';
 export { OpenAIProvider } from './openai.js';
 export { GoogleProvider } from './google.js';
+export { SchemaValidationError } from './errors.js';
 export { getModelPricing, getModelInfo, calculateCost, type ModelPricing, type ModelInfo, } from './pricing.js';
 export type { Message, LLMResponse, LLMProvider, ProviderParams, LLMConversation, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/script/src/providers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGjE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EACN,eAAe,EACf,YAAY,EACZ,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,SAAS,GACd,MAAM,cAAc,CAAC;AAGtB,YAAY,EACX,OAAO,EACP,WAAW,EACX,WAAW,EACX,cAAc,EACd,eAAe,GACf,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGjE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGpD,OAAO,EACN,eAAe,EACf,YAAY,EACZ,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,SAAS,GACd,MAAM,cAAc,CAAC;AAGtB,YAAY,EACX,OAAO,EACP,WAAW,EACX,WAAW,EACX,cAAc,EACd,eAAe,GACf,MAAM,YAAY,CAAC"}

package/script/src/providers/index.js

@@ -7,7 +7,7 @@
  * - Cost calculation utilities
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.calculateCost = exports.getModelInfo = exports.getModelPricing = exports.GoogleProvider = exports.OpenAIProvider = exports.getProviderForModel = exports.getProvider = void 0;
+exports.calculateCost = exports.getModelInfo = exports.getModelPricing = exports.SchemaValidationError = exports.GoogleProvider = exports.OpenAIProvider = exports.getProviderForModel = exports.getProvider = void 0;
 // Re-export provider registry functions
 var registry_js_1 = require("./registry.js");
 Object.defineProperty(exports, "getProvider", { enumerable: true, get: function () { return registry_js_1.getProvider; } });
@@ -17,6 +17,8 @@ var openai_js_1 = require("./openai.js");
 Object.defineProperty(exports, "OpenAIProvider", { enumerable: true, get: function () { return openai_js_1.OpenAIProvider; } });
 var google_js_1 = require("./google.js");
 Object.defineProperty(exports, "GoogleProvider", { enumerable: true, get: function () { return google_js_1.GoogleProvider; } });
+var errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "SchemaValidationError", { enumerable: true, get: function () { return errors_js_1.SchemaValidationError; } });
 // Re-export pricing utilities
 var pricing_js_1 = require("./pricing.js");
 Object.defineProperty(exports, "getModelPricing", { enumerable: true, get: function () { return pricing_js_1.getModelPricing; } });

package/script/src/providers/openai.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/src/providers/openai.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC,EAAE,MAAM,+CAA+C,CAAC;AAElE,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAyFpF;;GAEG;AACH,qBAAa,cAAe,YAAW,WAAW;IACjD,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,CAAC,EAAE,MAAM;IAarB,QAAQ,CAAC,CAAC,EACf,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,EAC3B,MAAM,CAAC,EAAE,cAAc,GACrB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CAkD1B"}
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/src/providers/openai.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC,EAAE,MAAM,+CAA+C,CAAC;AAGlE,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA0FpF;;GAEG;AACH,qBAAa,cAAe,YAAW,WAAW;IACjD,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,CAAC,EAAE,MAAM;IAarB,QAAQ,CAAC,CAAC,EACf,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,EAC3B,MAAM,CAAC,EAAE,cAAc,GACrB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CAuD1B"}

package/script/src/providers/openai.js

@@ -43,9 +43,8 @@ exports.OpenAIProvider = void 0;
 const dntShim = __importStar(require("../../_dnt.shims.js"));
 const openai_1 = __importDefault(require("openai"));
 const index_js_1 = require("../../deps/jsr.io/@zod/zod/4.3.6/src/index.js");
+const errors_js_1 = require("./errors.js");
 const zodTextFormatCache = new Map();
-class ZodValidationError extends Error {
-}
 /**
  * Sanitizes a JSON schema for OpenAI compatibility.
  * OpenAI's structured output has strict requirements:
@@ -106,7 +105,7 @@ function zodTextFormat(zodObject, name) {
                 return zodObject.parse(JSON.parse(content));
             }
             catch (error) {
-                return new ZodValidationError(error instanceof Error ? error.message : String(error));
+                return new errors_js_1.SchemaValidationError(error instanceof Error ? error.message : String(error), error);
             }
         },
         __output: undefined,
@@ -154,11 +153,15 @@ class OpenAIProvider {
                 }
                 : null;
             if (response.output_parsed instanceof Error) {
+                const parseError = response.output_parsed;
+                const error = parseError instanceof errors_js_1.SchemaValidationError
+                    ? parseError
+                    : new errors_js_1.SchemaValidationError(parseError.message, parseError);
                 return {
                     parsed: null,
                     text: response.output_text,
                     usage,
-                    error: response.output_parsed,
+                    error,
                 };
             }
             return {

package/script/src/schemas/index.d.ts

@@ -19,4 +19,5 @@ export type * from './models.schema.js';
 export type * from './seedKeyword.schema.js';
 export type * from './topics.schema.js';
 export type * from './summary.schema.js';
+export type * from './prompt.schema.js';
 //# sourceMappingURL=index.d.ts.map

package/script/src/schemas/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,sBAAsB,CAAC;AAC1C,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,sBAAsB,CAAC;AAC1C,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,oBAAoB,CAAC"}

package/script/src/schemas/prompt.schema.d.ts

@@ -0,0 +1,59 @@
+import { z } from '../../deps/jsr.io/@zod/zod/4.3.6/src/index.js';
+/**
+ * Zod schemas for AI visibility prompt generation.
+ *
+ * ⚠️ This file should contain ONLY schema definitions.
+ * No business logic, prompts, or function implementations.
+ */
+export declare const PromptIntentSchema: z.ZodEnum<{
+    local: "local";
+    comparison: "comparison";
+    informational: "informational";
+    navigational: "navigational";
+    transactional: "transactional";
+    commercial: "commercial";
+    troubleshooting: "troubleshooting";
+}>;
+export type PromptIntent = z.infer<typeof PromptIntentSchema>;
+export declare const PromptIdeaSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    intent: z.ZodEnum<{
+        local: "local";
+        comparison: "comparison";
+        informational: "informational";
+        navigational: "navigational";
+        transactional: "transactional";
+        commercial: "commercial";
+        troubleshooting: "troubleshooting";
+    }>;
+}, z.core.$strip>;
+export type PromptIdea = z.infer<typeof PromptIdeaSchema>;
+export declare const PromptListSchema: z.ZodArray<z.ZodObject<{
+    prompt: z.ZodString;
+    intent: z.ZodEnum<{
+        local: "local";
+        comparison: "comparison";
+        informational: "informational";
+        navigational: "navigational";
+        transactional: "transactional";
+        commercial: "commercial";
+        troubleshooting: "troubleshooting";
+    }>;
+}, z.core.$strip>>;
+export type PromptList = z.infer<typeof PromptListSchema>;
+export declare const PromptListResponseSchema: z.ZodObject<{
+    prompts: z.ZodArray<z.ZodObject<{
+        prompt: z.ZodString;
+        intent: z.ZodEnum<{
+            local: "local";
+            comparison: "comparison";
+            informational: "informational";
+            navigational: "navigational";
+            transactional: "transactional";
+            commercial: "commercial";
+            troubleshooting: "troubleshooting";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PromptListResponse = z.infer<typeof PromptListResponseSchema>;
+//# sourceMappingURL=prompt.schema.d.ts.map

package/script/src/schemas/prompt.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.schema.d.ts","sourceRoot":"","sources":["../../../src/src/schemas/prompt.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,+CAA+C,CAAC;AAElE;;;;;GAKG;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;EAQ7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,gBAAgB;;;;;;;;;;;iBAG3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,gBAAgB;;;;;;;;;;;kBAC2B,CAAC;AAEzD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;iBAEnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/script/src/schemas/prompt.schema.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromptListResponseSchema = exports.PromptListSchema = exports.PromptIdeaSchema = exports.PromptIntentSchema = void 0;
+const index_js_1 = require("../../deps/jsr.io/@zod/zod/4.3.6/src/index.js");
+/**
+ * Zod schemas for AI visibility prompt generation.
+ *
+ * ⚠️ This file should contain ONLY schema definitions.
+ * No business logic, prompts, or function implementations.
+ */
+exports.PromptIntentSchema = index_js_1.z.enum([
+    'informational',
+    'navigational',
+    'transactional',
+    'commercial',
+    'comparison',
+    'troubleshooting',
+    'local'
+]);
+exports.PromptIdeaSchema = index_js_1.z.object({
+    prompt: index_js_1.z.string().min(3).describe('A realistic natural-language prompt a user would type into an LLM search engine.'),
+    intent: exports.PromptIntentSchema.describe('Primary intent of the prompt.')
+});
+exports.PromptListSchema = index_js_1.z.array(exports.PromptIdeaSchema)
+    .describe('Generated prompt ideas with intent labels.');
+exports.PromptListResponseSchema = index_js_1.z.object({
+    prompts: exports.PromptListSchema
+});

package/script/src/tools/prompts.d.ts

@@ -0,0 +1,53 @@
+import type { z } from '../../deps/jsr.io/@zod/zod/4.3.6/src/index.js';
+import { Tool, type ModelConfig } from '../tool.js';
+import type { Message } from '../llm.js';
+import { type PromptList, type PromptListResponse, type PromptIntent } from '../schemas/prompt.schema.js';
+export interface PromptGeneratorConfig {
+    /** Minimum number of prompts to generate (default: 5) */
+    minPrompts?: number;
+    /** Maximum number of prompts to generate (default: 100) */
+    maxPrompts?: number;
+    /** Language for prompts (default: inferred from instructions) */
+    language?: string;
+    /** Optional topic context to guide prompt generation */
+    topics?: Array<string | {
+        topic: string;
+        subtopics?: Array<string>;
+    }>;
+    /** Optional persona context to guide prompt generation */
+    personas?: Array<string | {
+        name: string;
+        description?: string;
+    }>;
+    /** Optional intent whitelist to focus generation */
+    intents?: Array<PromptIntent>;
+    /** Optional extra instructions to always apply */
+    instructions?: string;
+}
+/**
+ * A tool that generates realistic LLM prompts for AI visibility analysis.
+ * Input is a single "instructions" string describing the topic and constraints.
+ */
+export declare class PromptGenerator extends Tool<string | null, PromptListResponse, PromptList> {
+    private readonly systemPrompt;
+    private readonly contextBlocks;
+    private readonly responseSchema;
+    constructor(config: PromptGeneratorConfig | undefined, modelConfig: ModelConfig);
+    protected schema(): z.ZodType<{
+        prompts: {
+            prompt: string;
+            intent: "local" | "comparison" | "informational" | "navigational" | "transactional" | "commercial" | "troubleshooting";
+        }[];
+    }, unknown, z.core.$ZodTypeInternals<{
+        prompts: {
+            prompt: string;
+            intent: "local" | "comparison" | "informational" | "navigational" | "transactional" | "commercial" | "troubleshooting";
+        }[];
+    }, unknown>>;
+    protected prompt(instructions: string | null): Message[];
+    protected isEmpty(instructions: string | null): boolean;
+    protected extractResult(parsed: PromptListResponse): PromptList;
+}
+export type { PromptList, PromptListResponse, PromptIdea, PromptIntent } from '../schemas/prompt.schema.js';
+export { PromptListSchema, PromptListResponseSchema, PromptIdeaSchema, PromptIntentSchema } from '../schemas/prompt.schema.js';
+//# sourceMappingURL=prompts.d.ts.map

package/script/src/tools/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/src/tools/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,+CAA+C,CAAC;AACvE,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAGN,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,MAAM,6BAA6B,CAAC;AA6BrC,MAAM,WAAW,qBAAqB;IACrC,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC,CAAC;IACtE,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,oDAAoD;IACpD,OAAO,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAC9B,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,kBAAkB,EAAE,UAAU,CAAC;IACvF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgC;gBAEnD,MAAM,EAAE,qBAAqB,YAAK,EAAE,WAAW,EAAE,WAAW;cAiErD,MAAM;;;;;;;;;;;IAIzB,SAAS,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,EAAE;cAQrC,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;cAI7C,aAAa,CAAC,MAAM,EAAE,kBAAkB,GAAG,UAAU;CAGxE;AAED,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC5G,OAAO,EACN,gBAAgB,EAChB,wBAAwB,EACxB,gBAAgB,EAChB,kBAAkB,EAClB,MAAM,6BAA6B,CAAC"}

package/script/src/tools/prompts.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromptIntentSchema = exports.PromptIdeaSchema = exports.PromptListResponseSchema = exports.PromptListSchema = exports.PromptGenerator = void 0;
+const tool_js_1 = require("../tool.js");
+const prompt_schema_js_1 = require("../schemas/prompt.schema.js");
+const utils_js_1 = require("../helpers/utils.js");
+const PROMPT_SYSTEM = (0, utils_js_1.dedent)(`
+You generate realistic natural-language prompts for AI visibility testing with LLM search engines.
+
+Follow the user's instructions exactly and only use the context they provide.
+
+Output requirements:
+- Return a JSON object with a "prompts" array.
+- Each object must include: prompt, intent.
+- The "intent" must be one of: informational, navigational, transactional, commercial, comparison, troubleshooting, local.
+- Generate between {min} and {max} prompts unless the instructions request a number within that range.
+- If the instructions specify how many prompts to generate, follow that.
+
+Quality rules:
+- Prompts should read like real user questions or requests for an AI assistant, not keyword fragments.
+- Cover a mix of intents and realistic personas; avoid repeating the same intent across many prompts.
+- If topics or personas are provided, use them as context to shape prompts (but do not output them).
+- Avoid brand names unless the instructions explicitly include them.
+- Keep prompts focused on the topic and avoid hallucinated claims.
+`);
+const PROMPT_USER = (0, utils_js_1.dedent)(`
+# Instructions
+
+{instructions}
+`);
+/**
+ * A tool that generates realistic LLM prompts for AI visibility analysis.
+ * Input is a single "instructions" string describing the topic and constraints.
+ */
+class PromptGenerator extends tool_js_1.Tool {
+    systemPrompt;
+    contextBlocks;
+    responseSchema;
+    constructor(config = {}, modelConfig) {
+        super(modelConfig);
+        const { minPrompts = 5, maxPrompts = 100, language, topics, personas, intents, instructions } = config;
+        if (minPrompts < 0) {
+            throw new Error('minPrompts must be >= 0');
+        }
+        if (maxPrompts < minPrompts) {
+            throw new Error('maxPrompts must be >= minPrompts');
+        }
+        const contextParts = [];
+        if (instructions && instructions.trim() !== '') {
+            contextParts.push((0, utils_js_1.dedent)(`
+			# Additional Instructions
+
+			${instructions}
+			`));
+        }
+        if (language) {
+            contextParts.push((0, utils_js_1.dedent)(`
+			# Language
+
+			Generate prompts in: ${language}
+			`));
+        }
+        if (topics && topics.length > 0) {
+            contextParts.push((0, utils_js_1.dedent)(`
+			# Topics (Optional Context)
+
+			${JSON.stringify(topics, null, 2)}
+			`));
+        }
+        if (personas && personas.length > 0) {
+            contextParts.push((0, utils_js_1.dedent)(`
+			# Personas (Optional Context)
+
+			${JSON.stringify(personas, null, 2)}
+			`));
+        }
+        if (intents && intents.length > 0) {
+            contextParts.push((0, utils_js_1.dedent)(`
+			# Intent Focus (Optional)
+
+			${JSON.stringify(intents, null, 2)}
+			`));
+        }
+        this.contextBlocks = contextParts.join('\n\n');
+        this.systemPrompt = PROMPT_SYSTEM
+            .replace('{min}', String(minPrompts))
+            .replace('{max}', String(maxPrompts));
+        this.responseSchema = prompt_schema_js_1.PromptListResponseSchema.extend({
+            prompts: prompt_schema_js_1.PromptListSchema.min(minPrompts).max(maxPrompts)
+        });
+    }
+    schema() {
+        return this.responseSchema;
+    }
+    prompt(instructions) {
+        const userPrompt = PROMPT_USER.replace('{instructions}', instructions ?? '');
+        return [
+            { role: 'system', content: this.systemPrompt },
+            { role: 'user', content: this.contextBlocks ? `${userPrompt}\n\n${this.contextBlocks}` : userPrompt }
+        ];
+    }
+    isEmpty(instructions) {
+        return instructions == null || instructions.trim() === '';
+    }
+    extractResult(parsed) {
+        return parsed.prompts;
+    }
+}
+exports.PromptGenerator = PromptGenerator;
+var prompt_schema_js_2 = require("../schemas/prompt.schema.js");
+Object.defineProperty(exports, "PromptListSchema", { enumerable: true, get: function () { return prompt_schema_js_2.PromptListSchema; } });
+Object.defineProperty(exports, "PromptListResponseSchema", { enumerable: true, get: function () { return prompt_schema_js_2.PromptListResponseSchema; } });
+Object.defineProperty(exports, "PromptIdeaSchema", { enumerable: true, get: function () { return prompt_schema_js_2.PromptIdeaSchema; } });
+Object.defineProperty(exports, "PromptIntentSchema", { enumerable: true, get: function () { return prompt_schema_js_2.PromptIntentSchema; } });