testflow-ai 0.1.0

package/dist/parser.js

@@ -0,0 +1,189 @@
+"use strict";
+/**
+ * YAML and Markdown parsers for test flows and project context.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseYaml = parseYaml;
+exports.parseYamlFile = parseYamlFile;
+exports.parseContext = parseContext;
+exports.parseContextFile = parseContextFile;
+exports.discoverTestFiles = discoverTestFiles;
+const yaml_1 = require("yaml");
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+// -- YAML parsing --
+/** Parse a YAML string into a TestFlow. */
+function parseYaml(content) {
+    const parsed = (0, yaml_1.parse)(content);
+    return normalizeFlow(parsed);
+}
+/** Read and parse a YAML test file. */
+async function parseYamlFile(filePath) {
+    const content = await fs.readFile(filePath, 'utf-8');
+    return parseYaml(content);
+}
+function normalizeFlow(data) {
+    const obj = data;
+    if (!obj.name || !obj.steps) {
+        throw new Error('Test flow must have "name" and "steps" fields');
+    }
+    return {
+        name: obj.name,
+        description: obj.description,
+        tags: obj.tags,
+        steps: obj.steps.map(normalizeStep),
+    };
+}
+function normalizeStep(data) {
+    const obj = data;
+    if (!obj.name || !obj.request) {
+        throw new Error('Step must have "name" and "request" fields');
+    }
+    const req = obj.request;
+    return {
+        name: obj.name,
+        description: obj.description,
+        request: {
+            method: (req.method || 'GET').toUpperCase(),
+            url: req.url,
+            headers: req.headers,
+            body: req.body,
+            graphql: req.graphql,
+        },
+        capture: obj.capture,
+        assertions: obj.assertions,
+        waitUntil: obj.waitUntil,
+    };
+}
+// -- Context parsing --
+/** Parse a markdown string into ProjectContext. */
+function parseContext(content, fallbackName = 'API') {
+    const sections = extractSections(content);
+    return {
+        name: sections['name'] || fallbackName,
+        description: sections['description'] || '',
+        baseUrls: parseKeyValues(sections['base urls'] || sections['urls'] || ''),
+        endpoints: parseEndpoints(sections['endpoints'] || ''),
+        rules: parseList(sections['rules'] || sections['business rules'] || ''),
+        ai: parseAiConfig(sections['ai configuration'] || sections['ai'] || ''),
+    };
+}
+/** Read and parse a markdown context file. */
+async function parseContextFile(filePath) {
+    const content = await fs.readFile(filePath, 'utf-8');
+    return parseContext(content, path.basename(filePath, '.md'));
+}
+function extractSections(content) {
+    const sections = {};
+    const lines = content.split('\n');
+    let currentSection = 'description';
+    let buffer = [];
+    for (const line of lines) {
+        const h1 = line.match(/^#\s+(.+)$/);
+        const heading = line.match(/^#{2,}\s+(.+)$/);
+        if (h1 && !sections['name']) {
+            // Top-level H1 becomes the project name.
+            if (buffer.length)
+                sections[currentSection.toLowerCase()] = buffer.join('\n').trim();
+            sections['name'] = h1[1].trim();
+            currentSection = 'description';
+            buffer = [];
+        }
+        else if (heading) {
+            if (buffer.length)
+                sections[currentSection.toLowerCase()] = buffer.join('\n').trim();
+            currentSection = heading[1];
+            buffer = [];
+        }
+        else {
+            buffer.push(line);
+        }
+    }
+    if (buffer.length)
+        sections[currentSection.toLowerCase()] = buffer.join('\n').trim();
+    return sections;
+}
+function parseKeyValues(content) {
+    const result = {};
+    for (const line of content.split('\n')) {
+        const m = line.match(/^-?\s*(\w+):\s*(.+)$/);
+        if (m)
+            result[m[1]] = m[2].trim();
+    }
+    return result;
+}
+function parseEndpoints(content) {
+    const endpoints = [];
+    for (const line of content.split('\n')) {
+        const m = line.match(/^-\s+(?:(\w+):\s+)?(GET|POST|PUT|DELETE|PATCH)\s+(\S+)(?:\s+-\s+(.+))?$/i);
+        if (m) {
+            endpoints.push({
+                name: m[1] || `${m[2]} ${m[3]}`,
+                method: m[2].toUpperCase(),
+                path: m[3],
+                description: m[4],
+            });
+        }
+    }
+    return endpoints;
+}
+function parseList(content) {
+    const items = [];
+    for (const line of content.split('\n')) {
+        const m = line.match(/^-\s+(.+)$/);
+        if (m)
+            items.push(m[1].trim());
+    }
+    return items;
+}
+function parseAiConfig(content) {
+    if (!content)
+        return undefined;
+    const kv = parseKeyValues(content);
+    if (!kv['url'] && !kv['model'])
+        return undefined;
+    return {
+        url: kv['url'] || 'http://localhost:11434',
+        model: kv['model'] || 'llama3.2:3b',
+    };
+}
+// -- File discovery --
+/** Recursively find all `.yaml` / `.yml` test files in a directory. */
+async function discoverTestFiles(dir) {
+    const { glob } = await import('glob');
+    return glob(path.join(dir, '**/*.{yaml,yml}'));
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

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

package/dist/reporter.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Report generators — narrative, console, and JSON output.
+ */
+import type { FlowResult, TestReport } from './types.js';
+/** Generate a human-readable narrative from flow results. */
+export declare function generateNarrative(results: FlowResult[]): string;
+/** Aggregate flow results into a TestReport. */
+export declare function generateTechnicalReport(results: FlowResult[]): TestReport;
+/** Print a colored report to stdout. */
+export declare function printConsoleReport(report: TestReport): void;
+/** Serialize a report to a JSON string. */
+export declare function toJSON(report: TestReport): string;
+/** Render a report as a markdown string. */
+export declare function toMarkdown(report: TestReport): string;
+//# sourceMappingURL=reporter.d.ts.map

package/dist/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAIzD,6DAA6D;AAC7D,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CA8B/D;AAID,gDAAgD;AAChD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,UAAU,CAWzE;AAID,wCAAwC;AACxC,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAqC3D;AAID,2CAA2C;AAC3C,wBAAgB,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAEjD;AAID,4CAA4C;AAC5C,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAwCrD"}

package/dist/reporter.js

@@ -0,0 +1,152 @@
+"use strict";
+/**
+ * Report generators — narrative, console, and JSON output.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateNarrative = generateNarrative;
+exports.generateTechnicalReport = generateTechnicalReport;
+exports.printConsoleReport = printConsoleReport;
+exports.toJSON = toJSON;
+exports.toMarkdown = toMarkdown;
+// -- Narrative --
+/** Generate a human-readable narrative from flow results. */
+function generateNarrative(results) {
+    const lines = [];
+    for (const flow of results) {
+        const icon = flow.success ? '✅' : '❌';
+        lines.push(`\n${icon} **${flow.flow.name}**`);
+        if (flow.flow.description)
+            lines.push(`   _${flow.flow.description}_`);
+        for (const step of flow.steps) {
+            lines.push(`   ${step.success ? '→' : '✗'} ${step.step.name}`);
+            for (const [name, value] of Object.entries(step.captures)) {
+                const display = value == null
+                    ? String(value)
+                    : typeof value === 'string'
+                        ? value.substring(0, 50) + (value.length > 50 ? '…' : '')
+                        : JSON.stringify(value).substring(0, 50);
+                lines.push(`     📦 ${name}: ${display}`);
+            }
+            for (const a of step.assertions) {
+                if (!a.success)
+                    lines.push(`     ⚠️  ${a.message}`);
+            }
+            if (step.error)
+                lines.push(`     ❌ ${step.error}`);
+        }
+    }
+    return lines.join('\n');
+}
+// -- Technical report --
+/** Aggregate flow results into a TestReport. */
+function generateTechnicalReport(results) {
+    const passed = results.filter((r) => r.success).length;
+    return {
+        timestamp: new Date(),
+        duration: results.reduce((sum, r) => sum + r.duration, 0),
+        totalFlows: results.length,
+        passedFlows: passed,
+        failedFlows: results.length - passed,
+        flows: results,
+        narrative: generateNarrative(results),
+    };
+}
+// -- Console --
+/** Print a colored report to stdout. */
+function printConsoleReport(report) {
+    const c = colors;
+    console.log('\n' + c.bold('═'.repeat(60)));
+    console.log(c.bold('  TESTFLOW AI — RESULTS'));
+    console.log(c.bold('═'.repeat(60)));
+    console.log(`\n${c.cyan('Summary:')}`);
+    console.log(`  Total:    ${report.totalFlows} flows`);
+    console.log(`  ${c.green('Passed:')}  ${report.passedFlows}`);
+    console.log(`  ${c.red('Failed:')}  ${report.failedFlows}`);
+    console.log(`  ${c.dim('Duration:')} ${report.duration}ms`);
+    console.log(`\n${c.cyan('Narrative:')}`);
+    console.log(formatNarrative(report.narrative));
+    const failed = report.flows.filter((f) => !f.success);
+    if (failed.length > 0) {
+        console.log(`\n${c.red('Failures:')}`);
+        for (const flow of failed) {
+            console.log(`\n  ${c.red('✗')} ${c.bold(flow.flow.name)}`);
+            for (const step of flow.steps) {
+                if (!step.success) {
+                    console.log(`    ${c.yellow('Step:')} ${step.step.name}`);
+                    if (step.error)
+                        console.log(`    ${c.red('Error:')} ${step.error}`);
+                    for (const a of step.assertions) {
+                        if (!a.success) {
+                            console.log(`    ${c.red('Assert:')} ${a.message}`);
+                            console.log(`    ${c.dim('Actual:')} ${JSON.stringify(a.actual)}`);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    console.log('\n' + c.bold('═'.repeat(60)) + '\n');
+}
+// -- JSON --
+/** Serialize a report to a JSON string. */
+function toJSON(report) {
+    return JSON.stringify(report, null, 2);
+}
+// -- Markdown --
+/** Render a report as a markdown string. */
+function toMarkdown(report) {
+    const lines = [
+        '# Test Report',
+        '',
+        `**Date:** ${report.timestamp.toISOString()}`,
+        `**Duration:** ${report.duration}ms`,
+        '',
+        '## Summary',
+        '',
+        '| Metric | Value |',
+        '|--------|-------|',
+        `| Total | ${report.totalFlows} |`,
+        `| Passed | ${report.passedFlows} |`,
+        `| Failed | ${report.failedFlows} |`,
+        '',
+        '## Narrative',
+        '',
+        report.narrative,
+        '',
+    ];
+    const failed = report.flows.filter((f) => !f.success);
+    if (failed.length > 0) {
+        lines.push('## Failures', '');
+        for (const flow of failed) {
+            lines.push(`### ${flow.flow.name}`, '');
+            for (const step of flow.steps) {
+                if (!step.success) {
+                    lines.push(`**Step:** ${step.step.name}`);
+                    if (step.error)
+                        lines.push(`- Error: ${step.error}`);
+                    for (const a of step.assertions) {
+                        if (!a.success)
+                            lines.push(`- ${a.message}`);
+                    }
+                    lines.push('');
+                }
+            }
+        }
+    }
+    return lines.join('\n');
+}
+// -- Helpers --
+function formatNarrative(narrative) {
+    return narrative
+        .replace(/\*\*([^*]+)\*\*/g, '\x1b[1m$1\x1b[0m')
+        .replace(/_([^_]+)_/g, '\x1b[2m$1\x1b[0m');
+}
+const colors = {
+    bold: (s) => `\x1b[1m${s}\x1b[0m`,
+    dim: (s) => `\x1b[2m${s}\x1b[0m`,
+    red: (s) => `\x1b[31m${s}\x1b[0m`,
+    green: (s) => `\x1b[32m${s}\x1b[0m`,
+    yellow: (s) => `\x1b[33m${s}\x1b[0m`,
+    cyan: (s) => `\x1b[36m${s}\x1b[0m`,
+};
+//# sourceMappingURL=reporter.js.map

package/dist/reporter.js.map

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

package/dist/runner.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Test runner — orchestrates discovery, execution, and reporting.
+ */
+import type { TestReport, AiConfig } from './types.js';
+/** Options for `runTests()` and `TestRunner`. */
+export interface RunnerOptions {
+    /** Path to a context markdown file. */
+    contextFile?: string;
+    /** Directory containing YAML test files. */
+    testDir?: string;
+    /** Explicit list of test file paths. */
+    testFiles?: string[];
+    /** Only run flows matching these tags. */
+    tags?: string[];
+    /** Output format (default: `console`). */
+    format?: 'console' | 'json' | 'markdown';
+    /** Print verbose logs during execution. */
+    verbose?: boolean;
+    /** Ollama AI configuration (optional). */
+    ai?: Partial<AiConfig>;
+}
+export declare class TestRunner {
+    private opts;
+    constructor(options?: RunnerOptions);
+    /** Run all matching tests and produce a report. */
+    run(): Promise<TestReport>;
+}
+/** Convenience wrapper: create a runner and execute. */
+export declare function runTests(options: RunnerOptions): Promise<TestReport>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAwB,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE7E,iDAAiD;AACjD,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;IACzC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0CAA0C;IAC1C,EAAE,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;CACxB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,IAAI,CAAsE;gBAEtE,OAAO,GAAE,aAAkB;IAIvC,mDAAmD;IAC7C,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;CA4DjC;AAED,wDAAwD;AACxD,wBAAsB,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAE1E"}

package/dist/runner.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * Test runner — orchestrates discovery, execution, and reporting.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestRunner = void 0;
+exports.runTests = runTests;
+const parser_js_1 = require("./parser.js");
+const executor_js_1 = require("./executor.js");
+const reporter_js_1 = require("./reporter.js");
+class TestRunner {
+    opts;
+    constructor(options = {}) {
+        this.opts = { format: 'console', verbose: false, ...options };
+    }
+    /** Run all matching tests and produce a report. */
+    async run() {
+        // Context
+        const context = this.opts.contextFile
+            ? await (0, parser_js_1.parseContextFile)(this.opts.contextFile)
+            : undefined;
+        if (context && this.opts.verbose)
+            console.log(`📚 Context: ${context.name}`);
+        // Discover files
+        let files = this.opts.testFiles ? [...this.opts.testFiles] : [];
+        if (this.opts.testDir) {
+            files = [...files, ...(await (0, parser_js_1.discoverTestFiles)(this.opts.testDir))];
+        }
+        if (files.length === 0)
+            throw new Error('No test files found');
+        if (this.opts.verbose)
+            console.log(`📁 ${files.length} test file(s)`);
+        // Parse & filter
+        const flows = [];
+        for (const file of files) {
+            try {
+                const flow = await (0, parser_js_1.parseYamlFile)(file);
+                if (this.opts.tags?.length) {
+                    if (!flow.tags || !this.opts.tags.some((t) => flow.tags?.includes(t)))
+                        continue;
+                }
+                flows.push(flow);
+            }
+            catch (err) {
+                console.error(`⚠️  Failed to parse ${file}: ${err}`);
+            }
+        }
+        if (flows.length === 0)
+            throw new Error('No valid test flows found (check tags filter)');
+        // Execute
+        const executor = new executor_js_1.FlowExecutor(context, this.opts.verbose, this.opts.ai);
+        const results = [];
+        for (const flow of flows) {
+            const result = await executor.executeFlow(flow);
+            results.push(result);
+            if (this.opts.verbose) {
+                console.log(`\n${result.success ? '✅ PASSED' : '❌ FAILED'}: ${flow.name} (${result.duration}ms)`);
+            }
+        }
+        // Report
+        const report = (0, reporter_js_1.generateTechnicalReport)(results);
+        switch (this.opts.format) {
+            case 'console':
+                (0, reporter_js_1.printConsoleReport)(report);
+                break;
+            case 'json':
+                console.log(JSON.stringify(report, null, 2));
+                break;
+            case 'markdown':
+                console.log((0, reporter_js_1.toMarkdown)(report));
+                break;
+        }
+        return report;
+    }
+}
+exports.TestRunner = TestRunner;
+/** Convenience wrapper: create a runner and execute. */
+async function runTests(options) {
+    return new TestRunner(options).run();
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Core type definitions for testflow-ai.
+ */
+/** Project context loaded from a markdown file. */
+export interface ProjectContext {
+    name: string;
+    description: string;
+    baseUrls: Record<string, string>;
+    endpoints: EndpointDefinition[];
+    rules: string[];
+    ai?: AiContextConfig;
+}
+/** API endpoint definition extracted from the context file. */
+export interface EndpointDefinition {
+    name: string;
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    path: string;
+    description?: string;
+}
+/** AI configuration from the context file. */
+export interface AiContextConfig {
+    url: string;
+    model: string;
+}
+/** A complete test flow: a named sequence of steps. */
+export interface TestFlow {
+    name: string;
+    description?: string;
+    tags?: string[];
+    steps: TestStep[];
+}
+/** A single test step inside a flow. */
+export interface TestStep {
+    name: string;
+    description?: string;
+    request: RequestDefinition;
+    capture?: CaptureDefinition[];
+    assertions?: AssertionDefinition[];
+    /** Poll until a condition is met (useful for async operations). */
+    waitUntil?: WaitUntilConfig;
+}
+/** HTTP request definition. */
+export interface RequestDefinition {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    url: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+    graphql?: GraphQLRequest;
+}
+/** GraphQL-specific request fields. */
+export interface GraphQLRequest {
+    query: string;
+    variables?: Record<string, unknown>;
+    operationName?: string;
+}
+/** Capture a value from the response into a named variable. */
+export interface CaptureDefinition {
+    name: string;
+    /** Dot-notation path to extract from the response body (e.g. `data.user.id`). */
+    path: string;
+}
+/** Assert a condition on the response. */
+export interface AssertionDefinition {
+    /** Dot-notation path to the value to check (`status` for HTTP status code). */
+    path: string;
+    operator: 'equals' | 'notEquals' | 'contains' | 'notContains' | 'exists' | 'notExists' | 'greaterThan' | 'lessThan' | 'matches' | 'ai-evaluate';
+    /** Expected value, or evaluation prompt for `ai-evaluate`. */
+    value?: unknown;
+    /** Custom message shown on failure. */
+    message?: string;
+}
+/** Polling configuration for async operations. */
+export interface WaitUntilConfig {
+    path: string;
+    operator: 'equals' | 'notEquals' | 'exists' | 'notExists';
+    value?: unknown;
+    /** Max wait time in ms (default: 30 000). */
+    timeout?: number;
+    /** Poll interval in ms (default: 2 000). */
+    interval?: number;
+}
+/** Result of executing a complete flow. */
+export interface FlowResult {
+    flow: TestFlow;
+    success: boolean;
+    duration: number;
+    steps: StepResult[];
+    variables: Record<string, unknown>;
+}
+/** Result of executing a single step. */
+export interface StepResult {
+    step: TestStep;
+    success: boolean;
+    duration: number;
+    request: {
+        method: string;
+        url: string;
+        body?: unknown;
+    };
+    response?: {
+        status: number;
+        headers: Record<string, string>;
+        body: unknown;
+    };
+    captures: Record<string, unknown>;
+    assertions: AssertionResult[];
+    error?: string;
+}
+/** Result of a single assertion evaluation. */
+export interface AssertionResult {
+    assertion: AssertionDefinition;
+    success: boolean;
+    actual?: unknown;
+    message: string;
+}
+/** Aggregated test report. */
+export interface TestReport {
+    timestamp: Date;
+    duration: number;
+    totalFlows: number;
+    passedFlows: number;
+    failedFlows: number;
+    flows: FlowResult[];
+    narrative: string;
+}
+/** AI evaluator configuration. */
+export interface AiConfig {
+    /** Ollama API URL (default: `http://localhost:11434`). */
+    url: string;
+    /** Model name (default: `llama3.2:3b`). */
+    model: string;
+    /** Request timeout in ms (default: 30 000). */
+    timeout: number;
+}
+/** Result returned by the AI evaluator. */
+export interface AiEvaluation {
+    pass: boolean;
+    confidence: number;
+    reason: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Core type definitions for testflow-ai.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}