@chanl/scenarios-core 0.4.0

package/dist/execution/strategies/default.strategy.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultPersonaStrategy = void 0;
+const persona_llm_1 = require("../persona-llm");
+/**
+ * Default persona strategy — wraps the existing persona-llm.ts behavior.
+ * No internal tools, no dynamic prompt mutation. Backward compatible.
+ */
+class DefaultPersonaStrategy {
+    constructor() {
+        this.type = 'default';
+    }
+    async generateOpening(ctx) {
+        return (0, persona_llm_1.generatePersonaOpening)({
+            personaSystemPrompt: ctx.systemPrompt,
+            scenarioPrompt: ctx.scenarioPrompt,
+            adapterType: ctx.adapterType,
+            adapterConfig: ctx.adapterConfig,
+        });
+    }
+    async generateUtterance(ctx) {
+        return (0, persona_llm_1.generatePersonaUtterance)({
+            personaSystemPrompt: ctx.systemPrompt,
+            history: ctx.history,
+            adapterType: ctx.adapterType,
+            adapterConfig: ctx.adapterConfig,
+        });
+    }
+}
+exports.DefaultPersonaStrategy = DefaultPersonaStrategy;
+//# sourceMappingURL=default.strategy.js.map

package/dist/execution/strategies/default.strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.strategy.js","sourceRoot":"","sources":["../../../src/execution/strategies/default.strategy.ts"],"names":[],"mappings":";;;AAIA,gDAGwB;AAExB;;;GAGG;AACH,MAAa,sBAAsB;IAAnC;QACW,SAAI,GAAG,SAAS,CAAC;IAmB5B,CAAC;IAjBC,KAAK,CAAC,eAAe,CAAC,GAA2B;QAC/C,OAAO,IAAA,oCAAsB,EAAC;YAC5B,mBAAmB,EAAE,GAAG,CAAC,YAAY;YACrC,cAAc,EAAE,GAAG,CAAC,cAAc;YAClC,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,aAAa,EAAE,GAAG,CAAC,aAAa;SACjC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,GAA2B;QACjD,OAAO,IAAA,sCAAwB,EAAC;YAC9B,mBAAmB,EAAE,GAAG,CAAC,YAAY;YACrC,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,aAAa,EAAE,GAAG,CAAC,aAAa;SACjC,CAAC,CAAC;IACL,CAAC;CACF;AApBD,wDAoBC"}

package/dist/execution/strategies/reactive.strategy.d.ts

@@ -0,0 +1,28 @@
+import { PersonaStrategy, PersonaStrategyContext, PersonaToolDefinition } from '../persona-strategy.interface';
+/**
+ * Reactive persona strategy — tool-augmented persona that reasons about
+ * the agent's behavior before generating its visible response.
+ *
+ * How it works:
+ * 1. Persona LLM receives internal tools + conversation history
+ * 2. LLM calls tools (e.g., analyze_response → "dismissive") as chain-of-thought
+ * 3. Tool results feed back as tool_result messages
+ * 4. LLM generates final customer-facing response informed by its analysis
+ * 5. Max 3 tool call iterations per turn to bound cost
+ */
+export declare class ReactivePersonaStrategy implements PersonaStrategy {
+    readonly type = "reactive";
+    getInternalTools(): PersonaToolDefinition[];
+    generateOpening(ctx: PersonaStrategyContext): Promise<string | null>;
+    generateUtterance(ctx: PersonaStrategyContext): Promise<string | null>;
+    /**
+     * Call persona LLM with internal tools using the adapter's native tool_use support.
+     * Uses buildToolCallHistory + formatToolResult for proper tool role messages.
+     */
+    private callPersonaLlmWithTools;
+    /**
+     * Simple LLM call without tools (for opening messages).
+     */
+    private callPersonaLlm;
+}
+//# sourceMappingURL=reactive.strategy.d.ts.map

package/dist/execution/strategies/reactive.strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactive.strategy.d.ts","sourceRoot":"","sources":["../../../src/execution/strategies/reactive.strategy.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,+BAA+B,CAAC;AAuHvC;;;;;;;;;;GAUG;AACH,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,QAAQ,CAAC,IAAI,cAAc;IAE3B,gBAAgB,IAAI,qBAAqB,EAAE;IAIrC,eAAe,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKpE,iBAAiB,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI5E;;;OAGG;YACW,uBAAuB;IA0DrC;;OAEG;YACW,cAAc;CA8B7B"}

package/dist/execution/strategies/reactive.strategy.js

@@ -0,0 +1,220 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReactivePersonaStrategy = void 0;
+const persona_llm_1 = require("../persona-llm");
+const openai_adapter_1 = require("../../adapters/openai.adapter");
+const anthropic_adapter_1 = require("../../adapters/anthropic.adapter");
+/**
+ * Maximum number of internal tool call iterations per turn.
+ * Keeps cost bounded (~$0.001-0.005 per tool call).
+ */
+const MAX_TOOL_ITERATIONS = 3;
+const USER_TURN = 'Respond as the customer with your next message only. Stay in character. Keep it to one or two short sentences. No role labels or quotes.';
+/**
+ * Internal persona tools — self-reflective structured output.
+ * The LLM fills in the tool arguments as chain-of-thought reasoning
+ * about the agent's behavior before generating its visible response.
+ */
+const PERSONA_TOOLS = [
+    {
+        name: 'analyze_response',
+        description: 'Analyze the agent\'s last response to determine if it addressed your concern and decide your emotional reaction.',
+        parameters: {
+            type: 'object',
+            properties: {
+                assessment: {
+                    type: 'string',
+                    enum: ['helpful', 'unhelpful', 'confusing', 'dismissive', 'promising', 'evasive'],
+                    description: 'How well the agent addressed your concern',
+                },
+                emotional_reaction: {
+                    type: 'string',
+                    description: 'How you feel about this response (e.g., grateful, frustrated, skeptical, impatient)',
+                },
+                key_quote: {
+                    type: 'string',
+                    description: 'The most relevant quote from the agent\'s response',
+                },
+            },
+            required: ['assessment', 'emotional_reaction'],
+        },
+    },
+    {
+        name: 'assess_progress',
+        description: 'Evaluate whether this conversation is making progress toward resolving your issue.',
+        parameters: {
+            type: 'object',
+            properties: {
+                progress_percentage: {
+                    type: 'number',
+                    description: 'How close you are to resolution (0-100)',
+                },
+                next_action: {
+                    type: 'string',
+                    enum: ['continue_cooperatively', 'push_harder', 'accept_offer', 'threaten_to_leave', 'request_supervisor'],
+                    description: 'What you should do next',
+                },
+                turns_until_impatient: {
+                    type: 'number',
+                    description: 'How many more turns before you escalate or give up',
+                },
+            },
+            required: ['progress_percentage', 'next_action'],
+        },
+    },
+    {
+        name: 'escalate_pressure',
+        description: 'When the agent is not making progress, decide how to escalate your frustration or demand.',
+        parameters: {
+            type: 'object',
+            properties: {
+                escalation_level: {
+                    type: 'string',
+                    enum: ['restate_firmly', 'express_disappointment', 'threaten_escalation', 'demand_supervisor', 'threaten_to_leave'],
+                    description: 'How aggressively to escalate',
+                },
+                reason: {
+                    type: 'string',
+                    description: 'Why you are escalating now',
+                },
+                new_demand: {
+                    type: 'string',
+                    description: 'What you are now demanding (may be higher than before)',
+                },
+            },
+            required: ['escalation_level', 'reason'],
+        },
+    },
+    {
+        name: 'detect_vulnerability',
+        description: 'Identify if the agent made a mistake, admission, or offered something you can use to negotiate.',
+        parameters: {
+            type: 'object',
+            properties: {
+                vulnerability_type: {
+                    type: 'string',
+                    enum: ['price_room', 'policy_exception', 'authority_limitation', 'admission_of_fault', 'none'],
+                    description: 'Type of vulnerability detected',
+                },
+                quote: {
+                    type: 'string',
+                    description: 'The exact agent quote that reveals the vulnerability',
+                },
+                exploit_strategy: {
+                    type: 'string',
+                    description: 'How to use this to negotiate a better outcome',
+                },
+            },
+            required: ['vulnerability_type'],
+        },
+    },
+];
+/**
+ * Reactive persona strategy — tool-augmented persona that reasons about
+ * the agent's behavior before generating its visible response.
+ *
+ * How it works:
+ * 1. Persona LLM receives internal tools + conversation history
+ * 2. LLM calls tools (e.g., analyze_response → "dismissive") as chain-of-thought
+ * 3. Tool results feed back as tool_result messages
+ * 4. LLM generates final customer-facing response informed by its analysis
+ * 5. Max 3 tool call iterations per turn to bound cost
+ */
+class ReactivePersonaStrategy {
+    constructor() {
+        this.type = 'reactive';
+    }
+    getInternalTools() {
+        return PERSONA_TOOLS;
+    }
+    async generateOpening(ctx) {
+        // Opening doesn't need reactive tools — just generate normally
+        return this.callPersonaLlm(ctx, `Situation: ${ctx.scenarioPrompt}\n\nYou are starting the conversation as this customer. Say your opening line only — one or two short sentences.`, []);
+    }
+    async generateUtterance(ctx) {
+        return this.callPersonaLlmWithTools(ctx);
+    }
+    /**
+     * Call persona LLM with internal tools using the adapter's native tool_use support.
+     * Uses buildToolCallHistory + formatToolResult for proper tool role messages.
+     */
+    async callPersonaLlmWithTools(ctx) {
+        const resolved = (0, persona_llm_1.resolvePersonaLlmKey)(ctx.adapterType, ctx.adapterConfig);
+        if (!resolved)
+            return null;
+        try {
+            const adapter = resolved.kind === 'openai' ? new openai_adapter_1.OpenAIAdapter() : new anthropic_adapter_1.AnthropicAdapter();
+            const model = resolved.kind === 'openai'
+                ? (resolved.model || 'gpt-4o-mini')
+                : (resolved.model || 'claude-3-5-haiku-20241022');
+            await adapter.connect({
+                apiKey: resolved.apiKey,
+                model,
+                temperature: 0.85,
+                maxTokens: 512,
+                systemPrompt: ctx.systemPrompt,
+                tools: PERSONA_TOOLS.map((t) => ({
+                    name: t.name,
+                    description: t.description,
+                    parameters: t.parameters,
+                })),
+            });
+            const history = [...ctx.history];
+            let response = await adapter.sendMessage(USER_TURN, history);
+            // Tool call loop: persona reasons about agent behavior via tool_use
+            let iterations = 0;
+            while (response.toolCalls?.length && iterations < MAX_TOOL_ITERATIONS) {
+                iterations++;
+                // Build tool results — for self-reflective tools, the "result" is just
+                // an acknowledgment. The reasoning is in the tool call arguments themselves.
+                const resolvedResults = response.toolCalls.map((tc) => ({
+                    id: tc.id,
+                    name: tc.name,
+                    result: `Analysis recorded: ${tc.name}. Use this insight for your response.`,
+                }));
+                // Use adapter's native tool call history builder (handles role: 'tool',
+                // tool_call_id, providerData — the same pattern used by the agent adapter)
+                const historyMessages = adapter.buildToolCallHistory(response, resolvedResults);
+                history.push(...historyMessages);
+                // Call LLM again — it now has tool results and can generate the text response
+                response = await adapter.sendMessage('', history);
+            }
+            await adapter.disconnect();
+            const text = (response.content || '').trim();
+            return text.length > 0 ? text : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Simple LLM call without tools (for opening messages).
+     */
+    async callPersonaLlm(ctx, message, history) {
+        const resolved = (0, persona_llm_1.resolvePersonaLlmKey)(ctx.adapterType, ctx.adapterConfig);
+        if (!resolved)
+            return null;
+        try {
+            const adapter = resolved.kind === 'openai' ? new openai_adapter_1.OpenAIAdapter() : new anthropic_adapter_1.AnthropicAdapter();
+            const model = resolved.kind === 'openai'
+                ? (resolved.model || 'gpt-4o-mini')
+                : (resolved.model || 'claude-3-5-haiku-20241022');
+            await adapter.connect({
+                apiKey: resolved.apiKey,
+                model,
+                temperature: 0.8,
+                maxTokens: 200,
+                systemPrompt: ctx.systemPrompt,
+            });
+            const res = await adapter.sendMessage(message, history);
+            await adapter.disconnect();
+            const text = (res.content || '').trim();
+            return text.length > 0 ? text : null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+exports.ReactivePersonaStrategy = ReactivePersonaStrategy;
+//# sourceMappingURL=reactive.strategy.js.map

package/dist/execution/strategies/reactive.strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactive.strategy.js","sourceRoot":"","sources":["../../../src/execution/strategies/reactive.strategy.ts"],"names":[],"mappings":"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"}

package/dist/execution/template-renderer.d.ts

@@ -0,0 +1,52 @@
+import { PersonaTraits } from '../simulator/persona-simulator.service';
+/**
+ * Variable context available in Liquid persona templates.
+ *
+ * OSS version provides: persona.*, scenario.*, and custom promptVariables.
+ * chanl cloud extends with: derived.*, behavior.*, conversationTraits.*,
+ * and runtime variable overrides.
+ */
+export interface TemplateVariables {
+    persona: {
+        name: string;
+        emotion: string;
+        speechStyle: string;
+        intentClarity: string;
+        description?: string;
+        backstory?: string;
+        gender?: string;
+        language?: string;
+        accent?: string;
+        [key: string]: string | undefined;
+    };
+    scenario: {
+        prompt: string;
+        name?: string;
+        description?: string;
+        category?: string;
+        difficulty?: string;
+        [key: string]: string | undefined;
+    };
+    [key: string]: unknown;
+}
+/**
+ * Build the variable context for Liquid template rendering.
+ */
+export declare function buildTemplateVariables(persona: PersonaTraits, scenarioPrompt: string, scenarioMeta?: {
+    name?: string;
+    description?: string;
+    category?: string;
+    difficulty?: string;
+    promptVariables?: Array<{
+        name: string;
+        defaultValue: string;
+    }>;
+}): TemplateVariables;
+/**
+ * Render a Liquid template with persona + scenario variables.
+ *
+ * Returns the rendered string, or null if rendering fails (with a warning).
+ * Callers should fall back to the code-generated prompt on null.
+ */
+export declare function renderPersonaTemplate(template: string, variables: TemplateVariables): Promise<string | null>;
+//# sourceMappingURL=template-renderer.d.ts.map

package/dist/execution/template-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-renderer.d.ts","sourceRoot":"","sources":["../../src/execution/template-renderer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AASvE;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;KACnC,CAAC;IACF,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;KACnC,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,aAAa,EACtB,cAAc,EAAE,MAAM,EACtB,YAAY,CAAC,EAAE;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjE,GACA,iBAAiB,CAkDnB;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,iBAAiB,GAC3B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAaxB"}

package/dist/execution/template-renderer.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTemplateVariables = buildTemplateVariables;
+exports.renderPersonaTemplate = renderPersonaTemplate;
+const liquidjs_1 = require("liquidjs");
+const common_1 = require("@nestjs/common");
+const logger = new common_1.Logger('TemplateRenderer');
+const liquid = new liquidjs_1.Liquid({
+    strictVariables: false,
+    strictFilters: false,
+    lenientIf: true,
+});
+/**
+ * Build the variable context for Liquid template rendering.
+ */
+function buildTemplateVariables(persona, scenarioPrompt, scenarioMeta) {
+    const vars = {
+        persona: {
+            name: persona.name,
+            emotion: persona.emotion,
+            speechStyle: persona.speechStyle,
+            intentClarity: persona.intentClarity,
+            description: persona.description,
+            backstory: persona.backstory,
+            gender: persona.gender,
+            language: persona.language,
+            accent: persona.accent,
+        },
+        scenario: {
+            prompt: scenarioPrompt,
+            name: scenarioMeta?.name,
+            description: scenarioMeta?.description,
+            category: scenarioMeta?.category,
+            difficulty: scenarioMeta?.difficulty,
+        },
+    };
+    // Add behavioral traits as flat keys for template convenience
+    if (persona.behavior) {
+        const b = persona.behavior;
+        if (b.cooperationLevel)
+            vars.persona['cooperationLevel'] = b.cooperationLevel;
+        if (b.patience)
+            vars.persona['patience'] = b.patience;
+        if (b.communicationStyle)
+            vars.persona['communicationStyle'] = b.communicationStyle;
+        if (b.personality)
+            vars.persona['personality'] = b.personality;
+        if (b.emotionalState)
+            vars.persona['emotionalState'] = b.emotionalState;
+    }
+    // Merge persona custom variables (from UI key-value editor)
+    // Available as {{persona.product_name}}, {{persona.order_id}}, etc.
+    if (persona.variables) {
+        for (const [k, v] of Object.entries(persona.variables)) {
+            if (k && v != null)
+                vars.persona[k] = String(v);
+        }
+    }
+    // Add custom promptVariables as top-level keys
+    if (scenarioMeta?.promptVariables) {
+        for (const v of scenarioMeta.promptVariables) {
+            if (v.name && v.defaultValue != null) {
+                vars[v.name] = v.defaultValue;
+            }
+        }
+    }
+    return vars;
+}
+/**
+ * Render a Liquid template with persona + scenario variables.
+ *
+ * Returns the rendered string, or null if rendering fails (with a warning).
+ * Callers should fall back to the code-generated prompt on null.
+ */
+async function renderPersonaTemplate(template, variables) {
+    try {
+        const rendered = await liquid.parseAndRender(template, variables);
+        const trimmed = rendered.trim();
+        if (!trimmed) {
+            logger.warn('Liquid template rendered to empty string — falling back to code-generated prompt');
+            return null;
+        }
+        return trimmed;
+    }
+    catch (err) {
+        logger.warn(`Liquid template rendering failed: ${err?.message || err} — falling back to code-generated prompt`);
+        return null;
+    }
+}
+//# sourceMappingURL=template-renderer.js.map

package/dist/execution/template-renderer.js.map

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

package/dist/generation/index.d.ts

@@ -0,0 +1,2 @@
+export { generateTestSuite, type GenerateRequest, type GeneratedSuite, type GeneratedScenario, type GeneratedPersona, type GeneratedScorecard, type GeneratedCriterion, } from './scenario-generator.service';
+//# sourceMappingURL=index.d.ts.map

package/dist/generation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,8BAA8B,CAAC"}

package/dist/generation/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateTestSuite = void 0;
+var scenario_generator_service_1 = require("./scenario-generator.service");
+Object.defineProperty(exports, "generateTestSuite", { enumerable: true, get: function () { return scenario_generator_service_1.generateTestSuite; } });
+//# sourceMappingURL=index.js.map

package/dist/generation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generation/index.ts"],"names":[],"mappings":";;;AAAA,2EAQsC;AAPpC,+HAAA,iBAAiB,OAAA"}

package/dist/generation/scenario-generator.service.d.ts

@@ -0,0 +1,77 @@
+export interface GenerateRequest {
+    systemPrompt: string;
+    count?: number;
+    difficulties?: ('easy' | 'medium' | 'hard')[];
+    includeAdversarial?: boolean;
+    domain?: string;
+    adapterType?: string;
+    adapterConfig?: Record<string, any>;
+}
+export interface GeneratedScenario {
+    name: string;
+    description: string;
+    prompt: string;
+    category: string;
+    difficulty: string;
+    tags: string[];
+    context?: {
+        situation?: string;
+        objective?: string;
+        background?: string;
+        constraints?: string[];
+    };
+    groundTruth?: string;
+}
+export interface GeneratedPersona {
+    name: string;
+    gender: string;
+    emotion: string;
+    language: string;
+    accent: string;
+    intentClarity: string;
+    speechStyle: string;
+    backgroundNoise: boolean;
+    allowInterruptions: boolean;
+    description: string;
+    backstory: string;
+    behavior: {
+        personality: string;
+        cooperationLevel: string;
+        patience: string;
+        communicationStyle: string;
+    };
+    variables: Record<string, string>;
+    tags: string[];
+}
+export interface GeneratedCriterion {
+    key: string;
+    name: string;
+    description: string;
+    type: string;
+    settings: Record<string, any>;
+    threshold?: Record<string, any>;
+}
+export interface GeneratedScorecard {
+    name: string;
+    description: string;
+    criteria: GeneratedCriterion[];
+}
+export interface GeneratedSuite {
+    scenarios: GeneratedScenario[];
+    personas: GeneratedPersona[];
+    scorecard: GeneratedScorecard;
+    summary: string;
+    domain: string;
+}
+/** @internal Exported for testing */
+export declare function validateScenario(s: any): GeneratedScenario | null;
+/** @internal Exported for testing */
+export declare function validatePersona(p: any): GeneratedPersona | null;
+/** @internal Exported for testing */
+export declare function validateCriterion(c: any): GeneratedCriterion | null;
+/** @internal Exported for testing */
+export declare function validateScorecard(sc: any): GeneratedScorecard | null;
+/** @internal Exported for testing */
+export declare function parseJsonResponse(text: string): any;
+export declare function generateTestSuite(request: GenerateRequest): Promise<GeneratedSuite>;
+//# sourceMappingURL=scenario-generator.service.d.ts.map

package/dist/generation/scenario-generator.service.d.ts.map

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