@graphext/cuery 0.6.1 → 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/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.1",
+  "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/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; } });