@graphext/cuery 0.6.1 → 0.6.3

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

@@ -14,9 +14,9 @@ export type * from './persona.schema.js';
 export type * from './brand.schema.js';
 export type * from './funnel.schema.js';
 export type * from './keyword.schema.js';
-export type * from './pipeline.schema.js';
 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,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.3",
   "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

@@ -14,9 +14,9 @@ export type * from './persona.schema.js';
 export type * from './brand.schema.js';
 export type * from './funnel.schema.js';
 export type * from './keyword.schema.js';
-export type * from './pipeline.schema.js';
 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,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; } });

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

@@ -1,146 +0,0 @@
-/**
- * Pipeline Context Type Definitions
- *
- * These types define the structure for pipeline execution contexts.
- * They are shared between client and server code.
- *
- * IMPORTANT: This type must be kept in sync with the dynamically generated
- * type from: supabase/functions/pipelines/workflows/audit.ts
- *
- * The actual pipeline generates:
- * export type AiAuditPromptsPipelineContext = OrchestratorRunContext<typeof promptsPipeline>;
- *
- * This static definition serves as a contract for client-side usage.
- * It represents the union of all context types required by the pipeline nodes.
- */
-import type { Brand, BrandContext, FlaggedBrand } from './brand.schema.js';
-import type { Funnel } from './funnel.schema.js';
-import type { ModelIdentifier } from './models.schema.js';
-import type { Persona } from './persona.schema.js';
-import type { TopicType } from './topics.schema.js';
-export interface KeywordPlannerOptions {
-    url?: string;
-    urlAsExpandRelevanceContext?: string;
-    generateIdeasFromSeeds?: boolean;
-}
-export interface AiAuditPromptsPipelineOptions {
-    filterLowRelevanceKeywords?: boolean;
-    /** When true, adds deduplicatedKeywords column with all keywords sharing the same metrics */
-    includeDeduplicatedKeywords?: boolean;
-    /** When true, includes seedKeywords column in output records. Defaults to false. */
-    includeSeedKeywords?: boolean;
-    /** When true, generates a separate dataset with all keywords (dedup by keyword only). Defaults to false. */
-    includeAllKeywordsDataset?: boolean;
-}
-/**
- * AI Audit Pipeline Request Structure
- *
- * This represents the structure of the request sent to the /pipelines/run endpoint.
- * The `context` field should match the AiAuditPromptsPipelineContext from the orchestrator.
- */
-export interface AiAuditPromptsPipelineRequest {
-    pipelineName: 'promptsPipeline';
-    context: AiAuditPromptsPipelineContext;
-}
-/**
- * AI Audit Answers Pipeline Request Structure
- *
- * This represents the structure of the request sent to the /pipelines/run endpoint.
- * The `context` field should match the AiAuditAnswersPipelineContext from the orchestrator.
- */
-export interface AiAuditAnswersPipelineRequest {
-    pipelineName: 'answersPipeline';
-    context: AiAuditAnswersPipelineContext;
-}
-/**
- * AI Audit Prompts Pipeline Context Data - Static Definition
- *
- * This represents the union of all context parameters required by the
- * various nodes in the AI audit prompts pipeline:
- *
- * - { keywordPlanner }: Keyword Planner parameters & seed sources
- * - { options }: Pipeline-level flags
- * - { workspaceId, projectName }: Project creation parameters
- * - { funnel }: Funnel assignment parameters
- * - { brand }: Brand-specific processing parameters
- * - { brands }: Brand collection parameters
- */
-export interface AiAuditPromptsPipelineContext {
-    clientUserEmail: string;
-    workspaceId: number;
-    projectName?: string;
-    /** Optional existing project to append prompts into. */
-    projectId?: number;
-    keywordPlanner: KeywordPlannerOptions;
-    /** ISO 639-1 language code for prompts/keywords (e.g., "en"). */
-    languageCode?: string;
-    /** ISO 3166-1 alpha-2 country code to localize sources (e.g., "US"). */
-    countryISOCode?: string;
-    /**
-     * Custom prompts provided by the user.
-     * These go directly to the prompt dataset without keyword expansion.
-     */
-    directPrompts?: Array<string>;
-    /**
-     * Custom seed keywords provided by the user.
-     * These are processed through keyword expansion like other seed keywords.
-     */
-    customSeedKeywords?: Array<string>;
-    funnel?: Funnel;
-    brand: BrandContext;
-    competitors: Array<FlaggedBrand | Brand>;
-    personas: Array<Persona>;
-    options?: AiAuditPromptsPipelineOptions;
-    topics?: Array<TopicType>;
-}
-/**
- * AI Audit Answers Pipeline Context Data
- *
- * Context parameters required by the answers pipeline.
- */
-export interface AiAuditAnswersPipelineContext {
-    clientUserEmail: string;
-    projectId: number;
-    promptIds: Array<number>;
-    models: Array<ModelIdentifier>;
-    countryISOCode?: string;
-    brand: BrandContext;
-    competitors?: Array<FlaggedBrand | Brand>;
-    /**
-     * Panel ID for grouping answers by execution source.
-     * When present (scheduled cron execution), answers are grouped by panelId.
-     */
-    panelId?: number;
-}
-/**
- * Persisted project configuration (pipeline context without user metadata).
- */
-export type AiAuditProjectConfig = Omit<AiAuditPromptsPipelineContext, 'clientUserEmail' | 'projectId'>;
-/**
- * Topic Update Pipeline Request Structure
- *
- * This represents the structure of the request sent to the /pipelines/run endpoint
- * for updating topic hierarchy in existing prompts.
- */
-export interface TopicUpdatePipelineRequest {
-    pipelineName: 'topicUpdatePipeline';
-    context: TopicUpdatePipelineContext;
-}
-/**
- * Topic Update Pipeline Context Data
- *
- * Context parameters required by the topic update pipeline.
- * This pipeline downloads the prompts dataset, re-assigns topics using AI
- * based on the provided taxonomy, and uploads the updated dataset back to the project.
- */
-export interface TopicUpdatePipelineContext {
-    clientUserEmail: string;
-    projectId: number;
-    /**
-     * The topics taxonomy to use for assigning topics.
-     * Each topic contains a name and a list of subtopics.
-     * The AI will classify each prompt into the appropriate topic/subtopic.
-     */
-    topics: Array<TopicType>;
-}
-//# sourceMappingURL=pipeline.schema.d.ts.map

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

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

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

@@ -1,16 +0,0 @@
-/**
- * Pipeline Context Type Definitions
- *
- * These types define the structure for pipeline execution contexts.
- * They are shared between client and server code.
- *
- * IMPORTANT: This type must be kept in sync with the dynamically generated
- * type from: supabase/functions/pipelines/workflows/audit.ts
- *
- * The actual pipeline generates:
- * export type AiAuditPromptsPipelineContext = OrchestratorRunContext<typeof promptsPipeline>;
- *
- * This static definition serves as a contract for client-side usage.
- * It represents the union of all context types required by the pipeline nodes.
- */
-export {};

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

@@ -1,146 +0,0 @@
-/**
- * Pipeline Context Type Definitions
- *
- * These types define the structure for pipeline execution contexts.
- * They are shared between client and server code.
- *
- * IMPORTANT: This type must be kept in sync with the dynamically generated
- * type from: supabase/functions/pipelines/workflows/audit.ts
- *
- * The actual pipeline generates:
- * export type AiAuditPromptsPipelineContext = OrchestratorRunContext<typeof promptsPipeline>;
- *
- * This static definition serves as a contract for client-side usage.
- * It represents the union of all context types required by the pipeline nodes.
- */
-import type { Brand, BrandContext, FlaggedBrand } from './brand.schema.js';
-import type { Funnel } from './funnel.schema.js';
-import type { ModelIdentifier } from './models.schema.js';
-import type { Persona } from './persona.schema.js';
-import type { TopicType } from './topics.schema.js';
-export interface KeywordPlannerOptions {
-    url?: string;
-    urlAsExpandRelevanceContext?: string;
-    generateIdeasFromSeeds?: boolean;
-}
-export interface AiAuditPromptsPipelineOptions {
-    filterLowRelevanceKeywords?: boolean;
-    /** When true, adds deduplicatedKeywords column with all keywords sharing the same metrics */
-    includeDeduplicatedKeywords?: boolean;
-    /** When true, includes seedKeywords column in output records. Defaults to false. */
-    includeSeedKeywords?: boolean;
-    /** When true, generates a separate dataset with all keywords (dedup by keyword only). Defaults to false. */
-    includeAllKeywordsDataset?: boolean;
-}
-/**
- * AI Audit Pipeline Request Structure
- *
- * This represents the structure of the request sent to the /pipelines/run endpoint.
- * The `context` field should match the AiAuditPromptsPipelineContext from the orchestrator.
- */
-export interface AiAuditPromptsPipelineRequest {
-    pipelineName: 'promptsPipeline';
-    context: AiAuditPromptsPipelineContext;
-}
-/**
- * AI Audit Answers Pipeline Request Structure
- *
- * This represents the structure of the request sent to the /pipelines/run endpoint.
- * The `context` field should match the AiAuditAnswersPipelineContext from the orchestrator.
- */
-export interface AiAuditAnswersPipelineRequest {
-    pipelineName: 'answersPipeline';
-    context: AiAuditAnswersPipelineContext;
-}
-/**
- * AI Audit Prompts Pipeline Context Data - Static Definition
- *
- * This represents the union of all context parameters required by the
- * various nodes in the AI audit prompts pipeline:
- *
- * - { keywordPlanner }: Keyword Planner parameters & seed sources
- * - { options }: Pipeline-level flags
- * - { workspaceId, projectName }: Project creation parameters
- * - { funnel }: Funnel assignment parameters
- * - { brand }: Brand-specific processing parameters
- * - { brands }: Brand collection parameters
- */
-export interface AiAuditPromptsPipelineContext {
-    clientUserEmail: string;
-    workspaceId: number;
-    projectName?: string;
-    /** Optional existing project to append prompts into. */
-    projectId?: number;
-    keywordPlanner: KeywordPlannerOptions;
-    /** ISO 639-1 language code for prompts/keywords (e.g., "en"). */
-    languageCode?: string;
-    /** ISO 3166-1 alpha-2 country code to localize sources (e.g., "US"). */
-    countryISOCode?: string;
-    /**
-     * Custom prompts provided by the user.
-     * These go directly to the prompt dataset without keyword expansion.
-     */
-    directPrompts?: Array<string>;
-    /**
-     * Custom seed keywords provided by the user.
-     * These are processed through keyword expansion like other seed keywords.
-     */
-    customSeedKeywords?: Array<string>;
-    funnel?: Funnel;
-    brand: BrandContext;
-    competitors: Array<FlaggedBrand | Brand>;
-    personas: Array<Persona>;
-    options?: AiAuditPromptsPipelineOptions;
-    topics?: Array<TopicType>;
-}
-/**
- * AI Audit Answers Pipeline Context Data
- *
- * Context parameters required by the answers pipeline.
- */
-export interface AiAuditAnswersPipelineContext {
-    clientUserEmail: string;
-    projectId: number;
-    promptIds: Array<number>;
-    models: Array<ModelIdentifier>;
-    countryISOCode?: string;
-    brand: BrandContext;
-    competitors?: Array<FlaggedBrand | Brand>;
-    /**
-     * Panel ID for grouping answers by execution source.
-     * When present (scheduled cron execution), answers are grouped by panelId.
-     */
-    panelId?: number;
-}
-/**
- * Persisted project configuration (pipeline context without user metadata).
- */
-export type AiAuditProjectConfig = Omit<AiAuditPromptsPipelineContext, 'clientUserEmail' | 'projectId'>;
-/**
- * Topic Update Pipeline Request Structure
- *
- * This represents the structure of the request sent to the /pipelines/run endpoint
- * for updating topic hierarchy in existing prompts.
- */
-export interface TopicUpdatePipelineRequest {
-    pipelineName: 'topicUpdatePipeline';
-    context: TopicUpdatePipelineContext;
-}
-/**
- * Topic Update Pipeline Context Data
- *
- * Context parameters required by the topic update pipeline.
- * This pipeline downloads the prompts dataset, re-assigns topics using AI
- * based on the provided taxonomy, and uploads the updated dataset back to the project.
- */
-export interface TopicUpdatePipelineContext {
-    clientUserEmail: string;
-    projectId: number;
-    /**
-     * The topics taxonomy to use for assigning topics.
-     * Each topic contains a name and a list of subtopics.
-     * The AI will classify each prompt into the appropriate topic/subtopic.
-     */
-    topics: Array<TopicType>;
-}
-//# sourceMappingURL=pipeline.schema.d.ts.map

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

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

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

@@ -1,17 +0,0 @@
-"use strict";
-/**
- * Pipeline Context Type Definitions
- *
- * These types define the structure for pipeline execution contexts.
- * They are shared between client and server code.
- *
- * IMPORTANT: This type must be kept in sync with the dynamically generated
- * type from: supabase/functions/pipelines/workflows/audit.ts
- *
- * The actual pipeline generates:
- * export type AiAuditPromptsPipelineContext = OrchestratorRunContext<typeof promptsPipeline>;
- *
- * This static definition serves as a contract for client-side usage.
- * It represents the union of all context types required by the pipeline nodes.
- */
-Object.defineProperty(exports, "__esModule", { value: true });