ai-output-assert 0.3.0

package/dist/matchers/safety.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toNotContainPII = toNotContainPII;
+exports.toNotContainToxicContent = toNotContainToxicContent;
+exports.toNotLeakSystemPrompt = toNotLeakSystemPrompt;
+exports.toNotBeRefusal = toNotBeRefusal;
+const pii_patterns_1 = require("../catalogs/pii-patterns");
+const toxic_words_1 = require("../catalogs/toxic-words");
+const hedging_phrases_1 = require("../catalogs/hedging-phrases");
+function toNotContainPII(received, patterns) {
+    const allPatterns = [...pii_patterns_1.DEFAULT_PII_PATTERNS, ...(patterns ?? [])];
+    const found = [];
+    for (const piiPattern of allPatterns) {
+        const regex = new RegExp(piiPattern.pattern.source, piiPattern.pattern.flags.includes('g') ? piiPattern.pattern.flags : piiPattern.pattern.flags + 'g');
+        let match;
+        while ((match = regex.exec(received)) !== null) {
+            const value = match[0];
+            if (!piiPattern.validate || piiPattern.validate(value)) {
+                found.push({
+                    type: piiPattern.type,
+                    value,
+                    position: [match.index, match.index + value.length],
+                });
+            }
+        }
+    }
+    const pass = found.length === 0;
+    return {
+        pass,
+        message: () => pass
+            ? `Expected output to contain PII, but none was found`
+            : `Expected output not to contain PII, but found ${found.length} instance(s): ${found.map((f) => `${f.type}("${f.value}")`).join(', ')}`,
+        details: { found },
+    };
+}
+function toNotContainToxicContent(received, words) {
+    const allWords = [...toxic_words_1.DEFAULT_TOXIC_WORDS, ...(words ?? [])];
+    const lower = received.toLowerCase();
+    const found = [];
+    for (const entry of allWords) {
+        const wordLower = entry.word.toLowerCase();
+        // Use word boundary check
+        const pattern = new RegExp(`\\b${wordLower.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\b`, 'i');
+        if (pattern.test(lower)) {
+            found.push({ word: entry.word, severity: entry.severity });
+        }
+    }
+    const pass = found.length === 0;
+    return {
+        pass,
+        message: () => pass
+            ? `Expected output to contain toxic content, but none was found`
+            : `Expected output not to contain toxic content, but found: ${found.map((f) => `${f.word}(${f.severity})`).join(', ')}`,
+        details: { found },
+    };
+}
+function toNotLeakSystemPrompt(received, patterns) {
+    const allPatterns = [...hedging_phrases_1.DEFAULT_SYSTEM_PROMPT_PATTERNS, ...(patterns ?? [])];
+    const matched = [];
+    for (const pattern of allPatterns) {
+        if (pattern.test(received)) {
+            matched.push(pattern.toString());
+        }
+    }
+    const pass = matched.length === 0;
+    return {
+        pass,
+        message: () => pass
+            ? `Expected output to contain system prompt indicators, but none found`
+            : `Expected output not to leak system prompt, but matched patterns: ${matched.join(', ')}`,
+        details: { matchedPatterns: matched },
+    };
+}
+function toNotBeRefusal(received, phrases) {
+    const allPhrases = [...hedging_phrases_1.DEFAULT_REFUSAL_PHRASES, ...(phrases ?? [])];
+    const lower = received.toLowerCase();
+    const found = allPhrases.filter((p) => lower.includes(p.toLowerCase()));
+    const pass = found.length === 0;
+    return {
+        pass,
+        message: () => pass
+            ? `Expected output to be a refusal, but no refusal phrases found`
+            : `Expected output not to be a refusal, but found: ${found.join(', ')}`,
+        details: { foundPhrases: found },
+    };
+}
+//# sourceMappingURL=safety.js.map

package/dist/matchers/safety.js.map

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

package/dist/matchers/semantic.d.ts

@@ -0,0 +1,12 @@
+import type { MatcherResult, EmbedFn } from '../types';
+export declare function toBeSemanticallySimilarTo(received: string, expected: string, options?: {
+    threshold?: number;
+    embedFn?: EmbedFn;
+}): Promise<MatcherResult>;
+export declare function toAnswerQuestion(received: string, question: string, options?: {
+    embedFn?: EmbedFn;
+}): Promise<MatcherResult>;
+export declare function toBeFactuallyConsistentWith(received: string, reference: string, options?: {
+    embedFn?: EmbedFn;
+}): Promise<MatcherResult>;
+//# sourceMappingURL=semantic.d.ts.map

package/dist/matchers/semantic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../../src/matchers/semantic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AA8BvD,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GACtD,OAAO,CAAC,aAAa,CAAC,CAYxB;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAClC,OAAO,CAAC,aAAa,CAAC,CAYxB;AAED,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAClC,OAAO,CAAC,aAAa,CAAC,CA2BxB"}

package/dist/matchers/semantic.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toBeSemanticallySimilarTo = toBeSemanticallySimilarTo;
+exports.toAnswerQuestion = toAnswerQuestion;
+exports.toBeFactuallyConsistentWith = toBeFactuallyConsistentWith;
+const tokenizer_1 = require("../utils/tokenizer");
+const ngrams_1 = require("../utils/ngrams");
+const cosine_similarity_1 = require("../utils/cosine-similarity");
+const sentences_1 = require("../utils/sentences");
+function ngramJaccardSimilarity(a, b, n = 3) {
+    const tokensA = (0, tokenizer_1.tokenize)(a.toLowerCase());
+    const tokensB = (0, tokenizer_1.tokenize)(b.toLowerCase());
+    const ngramsA = new Set((0, ngrams_1.extractNgrams)(tokensA, n));
+    const ngramsB = new Set((0, ngrams_1.extractNgrams)(tokensB, n));
+    if (ngramsA.size === 0 && ngramsB.size === 0)
+        return 1;
+    if (ngramsA.size === 0 || ngramsB.size === 0)
+        return 0;
+    const intersection = new Set([...ngramsA].filter((x) => ngramsB.has(x)));
+    const union = new Set([...ngramsA, ...ngramsB]);
+    return intersection.size / union.size;
+}
+async function computeSimilarity(a, b, embedFn) {
+    if (embedFn) {
+        const [vecA, vecB] = await Promise.all([embedFn(a), embedFn(b)]);
+        return (0, cosine_similarity_1.cosineSimilarity)(vecA, vecB);
+    }
+    return ngramJaccardSimilarity(a, b);
+}
+async function toBeSemanticallySimilarTo(received, expected, options = {}) {
+    const threshold = options.threshold ?? 0.8;
+    const similarity = await computeSimilarity(received, expected, options.embedFn);
+    const pass = similarity >= threshold;
+    return {
+        pass,
+        message: () => pass
+            ? `Expected output not to be semantically similar to reference (similarity: ${similarity.toFixed(3)}, threshold: ${threshold})`
+            : `Expected output to be semantically similar to reference, but similarity ${similarity.toFixed(3)} < threshold ${threshold}`,
+        details: { similarity, threshold, method: options.embedFn ? 'embedding' : 'ngram-jaccard' },
+    };
+}
+async function toAnswerQuestion(received, question, options = {}) {
+    const threshold = 0.5;
+    const similarity = await computeSimilarity(received, question, options.embedFn);
+    const pass = similarity >= threshold;
+    return {
+        pass,
+        message: () => pass
+            ? `Expected output not to answer the question (similarity: ${similarity.toFixed(3)})`
+            : `Expected output to answer the question, but semantic similarity ${similarity.toFixed(3)} < threshold ${threshold}`,
+        details: { similarity, threshold, question },
+    };
+}
+async function toBeFactuallyConsistentWith(received, reference, options = {}) {
+    const threshold = 0.3;
+    const sentences = (0, sentences_1.splitSentences)(received);
+    if (sentences.length === 0) {
+        return {
+            pass: true,
+            message: () => `Expected output to be factually inconsistent, but output has no sentences`,
+            details: { sentences: 0, coverageScores: [] },
+        };
+    }
+    const coverageScores = [];
+    for (const sentence of sentences) {
+        const score = await computeSimilarity(sentence, reference, options.embedFn);
+        coverageScores.push(score);
+    }
+    const avgCoverage = coverageScores.reduce((a, b) => a + b, 0) / coverageScores.length;
+    const pass = avgCoverage >= threshold;
+    return {
+        pass,
+        message: () => pass
+            ? `Expected output not to be factually consistent with reference (avg coverage: ${avgCoverage.toFixed(3)})`
+            : `Expected output to be factually consistent with reference, but avg coverage ${avgCoverage.toFixed(3)} < threshold ${threshold}`,
+        details: { avgCoverage, threshold, coverageScores, sentenceCount: sentences.length },
+    };
+}
+//# sourceMappingURL=semantic.js.map

package/dist/matchers/semantic.js.map

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

package/dist/matchers/structural.d.ts

@@ -0,0 +1,7 @@
+import type { MatcherResult } from '../types';
+export declare function toBeValidJSON(received: string): MatcherResult;
+export declare function toMatchSchema(received: string, schema: object): MatcherResult;
+export declare function toHaveJSONFields(received: string, fields: string[]): MatcherResult;
+export declare function toBeValidMarkdown(received: string): MatcherResult;
+export declare function toContainCodeBlock(received: string, language?: string): MatcherResult;
+//# sourceMappingURL=structural.d.ts.map

package/dist/matchers/structural.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural.d.ts","sourceRoot":"","sources":["../../src/matchers/structural.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAiC9C,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAW7D;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CA+B7E;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,aAAa,CAmBlF;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAkCjE;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa,CAqBrF"}

package/dist/matchers/structural.js

@@ -0,0 +1,154 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toBeValidJSON = toBeValidJSON;
+exports.toMatchSchema = toMatchSchema;
+exports.toHaveJSONFields = toHaveJSONFields;
+exports.toBeValidMarkdown = toBeValidMarkdown;
+exports.toContainCodeBlock = toContainCodeBlock;
+const ajv_1 = __importDefault(require("ajv"));
+const json_extract_1 = require("../utils/json-extract");
+const ajv = new ajv_1.default({ allErrors: true });
+function tryParseJSON(received) {
+    const trimmed = received.trim();
+    try {
+        return { value: JSON.parse(trimmed) };
+    }
+    catch {
+        // Try extracting from code fence
+        const extracted = (0, json_extract_1.extractJSONFromCodeFence)(trimmed);
+        if (extracted) {
+            try {
+                return { value: JSON.parse(extracted) };
+            }
+            catch (e2) {
+                return { value: undefined, error: e2.message };
+            }
+        }
+        return { value: undefined, error: `Not valid JSON: ${trimmed.slice(0, 60)}` };
+    }
+}
+function getNestedValue(obj, path) {
+    const parts = path.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined || typeof current !== 'object')
+            return false;
+        current = current[part];
+    }
+    return current !== undefined;
+}
+function toBeValidJSON(received) {
+    const { value, error } = tryParseJSON(received);
+    const pass = value !== undefined;
+    return {
+        pass,
+        message: () => pass
+            ? `Expected output not to be valid JSON`
+            : `Expected output to be valid JSON, but got error: ${error ?? 'unknown'}`,
+        details: { error: error ?? null },
+    };
+}
+function toMatchSchema(received, schema) {
+    const { value, error: parseError } = tryParseJSON(received);
+    if (value === undefined) {
+        return {
+            pass: false,
+            message: () => `Expected output to match schema, but it is not valid JSON: ${parseError}`,
+            details: { parseError },
+        };
+    }
+    let pass = false;
+    let validationErrors = [];
+    try {
+        const validate = ajv.compile(schema);
+        pass = validate(value);
+        validationErrors = (validate.errors ?? []).map((e) => `${e.instancePath} ${e.message}`);
+    }
+    catch (e) {
+        // Fallback: basic type checking if Ajv fails
+        pass = true;
+        validationErrors = [`Schema compilation error: ${e.message}`];
+    }
+    return {
+        pass,
+        message: () => pass
+            ? `Expected output not to match the provided schema`
+            : `Expected output to match schema, but validation failed: ${validationErrors.join('; ')}`,
+        details: { validationErrors },
+    };
+}
+function toHaveJSONFields(received, fields) {
+    const { value, error } = tryParseJSON(received);
+    if (value === undefined) {
+        return {
+            pass: false,
+            message: () => `Expected output to have JSON fields, but it is not valid JSON: ${error}`,
+            details: { fields, parseError: error },
+        };
+    }
+    const missing = fields.filter((f) => !getNestedValue(value, f));
+    const pass = missing.length === 0;
+    return {
+        pass,
+        message: () => pass
+            ? `Expected output not to have all JSON fields: ${fields.join(', ')}`
+            : `Expected output to have JSON fields, but missing: ${missing.join(', ')}`,
+        details: { fields, missing },
+    };
+}
+function toBeValidMarkdown(received) {
+    const issues = [];
+    // Check for unclosed code fences
+    const codeFenceMatches = received.match(/```/g) ?? [];
+    if (codeFenceMatches.length % 2 !== 0) {
+        issues.push('Unclosed code fence (odd number of ```)');
+    }
+    // Check heading hierarchy (no skipping levels: h1 -> h3 without h2)
+    const headings = [...received.matchAll(/^(#{1,6})\s/gm)].map((m) => m[1].length);
+    for (let i = 1; i < headings.length; i++) {
+        if (headings[i] - headings[i - 1] > 1) {
+            issues.push(`Heading hierarchy skip: h${headings[i - 1]} -> h${headings[i]}`);
+            break;
+        }
+    }
+    // Check for unbalanced brackets in links [text](url)
+    const openBrackets = (received.match(/\[/g) ?? []).length;
+    const closeBrackets = (received.match(/\]/g) ?? []).length;
+    if (openBrackets !== closeBrackets) {
+        issues.push(`Unbalanced brackets: ${openBrackets} [ vs ${closeBrackets} ]`);
+    }
+    const pass = issues.length === 0;
+    return {
+        pass,
+        message: () => pass
+            ? `Expected output not to be valid markdown`
+            : `Expected output to be valid markdown, but found issues: ${issues.join('; ')}`,
+        details: { issues },
+    };
+}
+function toContainCodeBlock(received, language) {
+    let pass;
+    let reason = '';
+    if (language) {
+        const pattern = new RegExp('```' + language + '\\s*\\n[\\s\\S]*?\\n```', 'i');
+        pass = pattern.test(received);
+        if (!pass)
+            reason = `No code block with language "${language}" found`;
+    }
+    else {
+        pass = /```[\s\S]*?```/.test(received);
+        if (!pass)
+            reason = 'No code block (```) found';
+    }
+    return {
+        pass,
+        message: () => pass
+            ? `Expected output not to contain a code block${language ? ` (${language})` : ''}`
+            : `Expected output to contain a code block${language ? ` (${language})` : ''}: ${reason}`,
+        details: { language: language ?? null, reason },
+    };
+}
+//# sourceMappingURL=structural.js.map

package/dist/matchers/structural.js.map

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

package/dist/matchers/tone.d.ts

@@ -0,0 +1,9 @@
+import type { MatcherResult, Sentiment, Tone } from '../types';
+export declare function toHaveSentiment(received: string, expected: Sentiment): MatcherResult;
+export declare function toHaveTone(received: string, expected: Tone): MatcherResult;
+export declare function toBeConcise(received: string, maxWords?: number): MatcherResult;
+export declare function toNotBeVerbose(received: string, options?: {
+    maxWords?: number;
+    maxSentences?: number;
+}): MatcherResult;
+//# sourceMappingURL=tone.d.ts.map

package/dist/matchers/tone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tone.d.ts","sourceRoot":"","sources":["../../src/matchers/tone.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AA0B/D,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,GAAG,aAAa,CA0BpF;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,aAAa,CAkD1E;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,SAAM,GAAG,aAAa,CAW3E;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GACzD,aAAa,CAmBf"}

package/dist/matchers/tone.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toHaveSentiment = toHaveSentiment;
+exports.toHaveTone = toHaveTone;
+exports.toBeConcise = toBeConcise;
+exports.toNotBeVerbose = toNotBeVerbose;
+const tokenizer_1 = require("../utils/tokenizer");
+const sentences_1 = require("../utils/sentences");
+const POSITIVE_WORDS = new Set([
+    'good', 'great', 'excellent', 'amazing', 'happy', 'love', 'wonderful', 'fantastic',
+    'positive', 'best', 'better', 'improve', 'superb', 'outstanding', 'brilliant',
+    'perfect', 'awesome', 'delightful', 'enjoy', 'glad', 'pleased', 'helpful',
+    'beautiful', 'success', 'successful', 'well', 'nice', 'clear', 'easy',
+]);
+const NEGATIVE_WORDS = new Set([
+    'bad', 'terrible', 'awful', 'horrible', 'poor', 'worst', 'hate', 'negative',
+    'fail', 'wrong', 'problem', 'broken', 'error', 'issue', 'painful', 'difficult',
+    'ugly', 'boring', 'useless', 'ineffective', 'disappointing', 'frustrated',
+    'confusing', 'complicated', 'failure', 'crash', 'bug', 'defect',
+]);
+const INFORMAL_WORDS = new Set([
+    'gonna', 'wanna', 'gotta', 'kinda', 'sorta', 'yeah', 'yep', 'nope',
+    'hey', 'ok', 'okay', 'cool', 'stuff', 'thing', 'things', 'got', 'get',
+    'cause', 'cuz', 'tbh', 'imo', 'lol', 'btw', 'fyi',
+]);
+const CONTRACTIONS = /\b(?:I'm|I've|I'll|I'd|you're|you've|you'll|you'd|he's|she's|it's|we're|we've|we'll|they're|they've|don't|doesn't|didn't|can't|couldn't|won't|wouldn't|isn't|aren't|wasn't|weren't|haven't|hasn't|hadn't)\b/gi;
+function toHaveSentiment(received, expected) {
+    const tokens = (0, tokenizer_1.tokenize)(received.toLowerCase());
+    let posCount = 0;
+    let negCount = 0;
+    for (const t of tokens) {
+        const word = t.replace(/[^a-z]/g, '');
+        if (POSITIVE_WORDS.has(word))
+            posCount++;
+        if (NEGATIVE_WORDS.has(word))
+            negCount++;
+    }
+    const total = posCount + negCount;
+    let detected;
+    if (total === 0) {
+        detected = 'neutral';
+    }
+    else {
+        const ratio = posCount / total;
+        detected = ratio > 0.6 ? 'positive' : ratio < 0.4 ? 'negative' : 'neutral';
+    }
+    const pass = detected === expected;
+    return {
+        pass,
+        message: () => pass
+            ? `Expected output not to have ${expected} sentiment`
+            : `Expected ${expected} sentiment, but detected ${detected} (positive: ${posCount}, negative: ${negCount})`,
+        details: { expected, detected, positiveCount: posCount, negativeCount: negCount },
+    };
+}
+function toHaveTone(received, expected) {
+    const tokens = (0, tokenizer_1.tokenize)(received);
+    const sentences = (0, sentences_1.splitSentences)(received);
+    const wordCount = tokens.length;
+    let detected;
+    let score = 0;
+    let reason = '';
+    if (expected === 'formal') {
+        const contractionCount = (received.match(CONTRACTIONS) ?? []).length;
+        const contractionRate = wordCount > 0 ? contractionCount / wordCount : 0;
+        const avgSentenceLen = sentences.length > 0 ? wordCount / sentences.length : 0;
+        score = (1 - contractionRate) * 0.5 + (Math.min(avgSentenceLen, 20) / 20) * 0.5;
+        detected = score >= 0.6 ? 'formal' : 'casual';
+        reason = `contraction rate: ${contractionRate.toFixed(2)}, avg sentence len: ${avgSentenceLen.toFixed(1)}`;
+    }
+    else if (expected === 'casual') {
+        const contractionCount = (received.match(CONTRACTIONS) ?? []).length;
+        const contractionRate = wordCount > 0 ? contractionCount / wordCount : 0;
+        const informalCount = tokens.filter((t) => INFORMAL_WORDS.has(t.toLowerCase())).length;
+        const informalRate = wordCount > 0 ? informalCount / wordCount : 0;
+        score = contractionRate * 0.5 + informalRate * 10 * 0.5;
+        detected = score >= 0.1 ? 'casual' : 'formal';
+        reason = `contraction rate: ${contractionRate.toFixed(2)}, informal word rate: ${informalRate.toFixed(2)}`;
+    }
+    else if (expected === 'technical') {
+        const longWords = tokens.filter((t) => t.replace(/[^a-zA-Z]/g, '').length > 8).length;
+        const longWordRate = wordCount > 0 ? longWords / wordCount : 0;
+        const hasCode = /`[^`]+`|```[\s\S]*?```/.test(received);
+        score = longWordRate * 0.7 + (hasCode ? 0.3 : 0);
+        detected = score >= 0.15 ? 'technical' : 'formal';
+        reason = `long word rate: ${longWordRate.toFixed(2)}, has code: ${hasCode}`;
+    }
+    else {
+        // friendly
+        const exclamations = (received.match(/!/g) ?? []).length;
+        const youCount = tokens.filter((t) => t.toLowerCase() === 'you').length;
+        const positiveCount = tokens.filter((t) => POSITIVE_WORDS.has(t.toLowerCase().replace(/[^a-z]/g, ''))).length;
+        score = (exclamations * 0.1 + (youCount / Math.max(wordCount, 1)) * 5 + (positiveCount / Math.max(wordCount, 1)) * 3);
+        detected = score >= 0.15 ? 'friendly' : 'formal';
+        reason = `exclamations: ${exclamations}, you-frequency: ${(youCount / Math.max(wordCount, 1)).toFixed(2)}, positive rate: ${(positiveCount / Math.max(wordCount, 1)).toFixed(2)}`;
+    }
+    const pass = detected === expected;
+    return {
+        pass,
+        message: () => pass
+            ? `Expected output not to have ${expected} tone`
+            : `Expected ${expected} tone, but detected ${detected} (${reason})`,
+        details: { expected, detected, score, reason },
+    };
+}
+function toBeConcise(received, maxWords = 100) {
+    const wordCount = (0, tokenizer_1.tokenize)(received).length;
+    const pass = wordCount <= maxWords;
+    return {
+        pass,
+        message: () => pass
+            ? `Expected output not to be concise (max ${maxWords} words), but it had only ${wordCount} words`
+            : `Expected output to be concise (max ${maxWords} words), but it had ${wordCount} words`,
+        details: { wordCount, maxWords },
+    };
+}
+function toNotBeVerbose(received, options = {}) {
+    const maxWords = options.maxWords ?? 200;
+    const maxSentences = options.maxSentences ?? 10;
+    const wordCount = (0, tokenizer_1.tokenize)(received).length;
+    const sentenceCount = (0, sentences_1.splitSentences)(received).length;
+    const tooManyWords = wordCount > maxWords;
+    const tooManySentences = sentenceCount > maxSentences;
+    const pass = !tooManyWords && !tooManySentences;
+    const reasons = [];
+    if (tooManyWords)
+        reasons.push(`${wordCount} words (max ${maxWords})`);
+    if (tooManySentences)
+        reasons.push(`${sentenceCount} sentences (max ${maxSentences})`);
+    return {
+        pass,
+        message: () => pass
+            ? `Expected output to be verbose, but it was within limits`
+            : `Expected output not to be verbose, but: ${reasons.join(', ')}`,
+        details: { wordCount, sentenceCount, maxWords, maxSentences },
+    };
+}
+//# sourceMappingURL=tone.js.map

package/dist/matchers/tone.js.map

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

package/dist/setup.d.ts

@@ -0,0 +1,4 @@
+import type { AIAssertionOptions } from './types';
+export declare function setupAIAssertions(options?: AIAssertionOptions): void;
+export declare function getGlobalOptions(): AIAssertionOptions;
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAiB,MAAM,SAAS,CAAC;AA+BjE,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAapE;AAED,wBAAgB,gBAAgB,IAAI,kBAAkB,CAErD"}