vibe-match 0.1.0

package/dist/matchers/toBeSimilarTo.d.ts

@@ -0,0 +1,25 @@
+import { type LanguageModelV1 } from "ai";
+import type { VibeMatcher } from "../types";
+/** Re-export for inline model overrides */
+export type { LanguageModelV1 };
+export declare const DEFAULT_SIMILARITY_PROMPT = "You have a singular task. You will be given two strings of text and you need to make a determination if they are meaningfully semantically similar. There are 3 levels of similarity: loose, normal, and strict.\n\n## Loose Matches:\nThe strings mean roughly the same thing. As long as the main idea gets across, it's a loose match.\n\nExample of a loose match that should pass:\nActual: \"I enjoy eating pizza with cheese\"\nPassing:\n- \"Cheese pizza is my preference personally\"\n- \"I like pizza with cheese\"\n- \"I love cheese pizza!\"\n- \"Pizza with cheese is my favorite\"\n\nNot Passing:\n- \"Pizza with tomatoes are my favorite\" // Doesn't match the original meaning\n- \"I HATE cheese pizza\" // Not the same meaning\n- \"Cheese pizza\" // Not enough information\n\n## Normal Matches:\nThe strings are more meaningfully similar than loose however there may be some small ambiguities.\n\nExample of a normal match that should pass:\nActual: \"There are 1000 people in the room\"\nPassing:\n- \"There are one thousand folks in the room\"\n- \"There's 1000 people here\"\n\nNot Passing:\n- \"There are 500 people in the room\" // Wrong number\n- \"There's not 1000 people in the room\" // Inverted logic\n- \"Why are there 1000 people in the room?\" // Doesn't match the original meaning\n\n## Strict Matches:\nThe strings are functionally identical. They do not need to be word for word the same but the meaning should be unambiguously the same and in the same order.\n\nExample of a strict match that should pass:\nActual: \"Hi, how are you?\"\n\nPassing:\n- \"Hello, how are you?\"\n- \"Hi, how are you?\"\n- \"Hi, how are you doing?\"\n\nNot Passing:\n- \"Hello sir, what's up?\" // Doesn't match the tone\n- \"Hi\" // Too short\n- \"How are you hello?\" // Wrong order\n\nThe user will provide the two strings and the level of similarity they want to test. You will use that level of similarity to determine if the two strings pass or fail.";
+export interface ToBeSimilarToOptions {
+    level?: "loose" | "normal" | "strict";
+    threshold?: number;
+    samples?: number;
+    /**
+     * Custom system prompt for the LLM. Overrides both the default prompt
+     * and any global prompt set in vibeMatchers config.
+     */
+    systemPrompt?: string;
+    /**
+     * Override the language model for this specific matcher call.
+     * If not provided, uses the model from vibeMatchers config.
+     */
+    languageModel?: LanguageModelV1;
+}
+export declare const toBeSimilarTo: VibeMatcher<[
+    similarTo: unknown,
+    options?: ToBeSimilarToOptions
+]>;
+//# sourceMappingURL=toBeSimilarTo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toBeSimilarTo.d.ts","sourceRoot":"","sources":["../../src/matchers/toBeSimilarTo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,IAAI,CAAC;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,2CAA2C;AAC3C,YAAY,EAAE,eAAe,EAAE,CAAC;AAOhC,eAAO,MAAM,yBAAyB,s6DAgDmI,CAAC;AA0B1K,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,aAAa,CAAC,EAAE,eAAe,CAAC;CACjC;AAED,eAAO,MAAM,aAAa,EAAE,WAAW,CACrC;IAAC,SAAS,EAAE,OAAO;IAAE,OAAO,CAAC,EAAE,oBAAoB;CAAC,CA6CnD,CAAC"}

package/dist/matchers/toBeVectorSimilarTo.d.ts

@@ -0,0 +1,21 @@
+import { type EmbeddingModel } from "ai";
+import type { VibeMatcher } from "../types";
+/** Re-export for inline model overrides */
+export type { EmbeddingModel };
+export interface VectorSimilarityOptions {
+    /**
+     * The minimum cosine similarity score required to pass (0-1).
+     * @default 0.85
+     */
+    threshold?: number;
+    /**
+     * Override the embedding model for this specific matcher call.
+     * If not provided, uses the model from vibeMatchers config.
+     */
+    embeddingModel?: EmbeddingModel<string>;
+}
+export declare const toBeVectorSimilarTo: VibeMatcher<[
+    expected: unknown,
+    options?: VectorSimilarityOptions
+]>;
+//# sourceMappingURL=toBeVectorSimilarTo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toBeVectorSimilarTo.d.ts","sourceRoot":"","sources":["../../src/matchers/toBeVectorSimilarTo.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,cAAc,EAAE,MAAM,IAAI,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,2CAA2C;AAC3C,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;CACzC;AAED,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAC3C;IAAC,QAAQ,EAAE,OAAO;IAAE,OAAO,CAAC,EAAE,uBAAuB;CAAC,CAiCrD,CAAC"}

package/dist/matchers/toMention.d.ts

@@ -0,0 +1,24 @@
+import { type LanguageModelV1 } from "ai";
+import type { VibeMatcher } from "../types";
+/** Re-export for inline model overrides */
+export type { LanguageModelV1 };
+export declare const DEFAULT_MENTION_PROMPT = "You have a singular task. You will be given a text and a concept, and you need to determine if the text mentions the concept.\n\nA text \"mentions\" a concept if it:\n- Directly references the concept by name\n- Describes the concept without necessarily naming it\n- Alludes to or implies the concept\n- Contains synonyms or related terms for the concept\n\nExamples that would PASS:\nText: \"I love programming in JavaScript\"\nConcept: \"JavaScript\" \u2192 PASS (direct mention)\n\nText: \"The cat sat on the mat\"\nConcept: \"animals\" \u2192 PASS (cat is an animal)\n\nText: \"We need to optimize our database queries\"\nConcept: \"performance\" \u2192 PASS (optimization implies performance)\n\nText: \"She was feeling blue today\"\nConcept: \"sadness\" \u2192 PASS (feeling blue implies sadness)\n\nExamples that would FAIL:\nText: \"I love programming in JavaScript\"\nConcept: \"Python\" \u2192 FAIL (different programming language, not mentioned)\n\nText: \"The weather is nice today\"\nConcept: \"sports\" \u2192 FAIL (no connection to sports)\n\nBe generous but accurate in your interpretation. The goal is to catch meaningful mentions for reliability testing purposes.";
+export interface ToMentionOptions {
+    threshold?: number;
+    samples?: number;
+    /**
+     * Custom system prompt for the LLM. Overrides both the default prompt
+     * and any global prompt set in vibeMatchers config.
+     */
+    systemPrompt?: string;
+    /**
+     * Override the language model for this specific matcher call.
+     * If not provided, uses the model from vibeMatchers config.
+     */
+    languageModel?: LanguageModelV1;
+}
+export declare const toMention: VibeMatcher<[
+    concept: unknown,
+    options?: ToMentionOptions
+]>;
+//# sourceMappingURL=toMention.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toMention.d.ts","sourceRoot":"","sources":["../../src/matchers/toMention.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,IAAI,CAAC;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,2CAA2C;AAC3C,YAAY,EAAE,eAAe,EAAE,CAAC;AAOhC,eAAO,MAAM,sBAAsB,kqCA4ByF,CAAC;AAwB7H,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,aAAa,CAAC,EAAE,eAAe,CAAC;CACjC;AAED,eAAO,MAAM,SAAS,EAAE,WAAW,CACjC;IAAC,OAAO,EAAE,OAAO;IAAE,OAAO,CAAC,EAAE,gBAAgB;CAAC,CAyC7C,CAAC"}

package/dist/matchers/toSatisfyCriteria.d.ts

@@ -0,0 +1,40 @@
+import { type LanguageModelV1 } from "ai";
+import type { VibeMatcher } from "../types";
+/** Re-export for inline model overrides */
+export type { LanguageModelV1 };
+export declare const DEFAULT_SATISFY_CRITERIA_PROMPT = "You have a singular task. You will be given a text and a criterion, and you must determine if the text satisfies the criterion.\n\nYour job is to make a binary YES/NO decision:\n- YES (pass: true): The text clearly meets the criterion\n- NO (pass: false): The text does not meet the criterion or it's ambiguous\n\nBe strict but fair. The criterion must be clearly satisfied, not just partially or arguably met.\n\nExamples:\n\nText: \"Hi John, I understand you're having trouble with your login. Here's how to reset your password: go to Settings > Security > Reset Password.\"\nCriterion: \"Addresses the user by name\"\n\u2192 PASS (the text says \"Hi John\")\n\nText: \"Hi John, I understand you're having trouble with your login. Here's how to reset your password: go to Settings > Security > Reset Password.\"\nCriterion: \"Provides a specific solution\"\n\u2192 PASS (gives clear steps to reset password)\n\nText: \"I'm sorry you're having issues. Let me know if you need help.\"\nCriterion: \"Provides a specific solution\"\n\u2192 FAIL (no specific solution is offered, just a vague offer to help)\n\nText: \"Thanks for reaching out! We'll look into this.\"\nCriterion: \"Acknowledges the specific issue reported\"\n\u2192 FAIL (generic acknowledgment, doesn't reference the specific issue)\n\nProvide a brief explanation for your decision.";
+export interface ToSatisfyCriteriaOptions {
+    /**
+     * How to aggregate results across criteria (only applies when multiple criteria are provided).
+     * - "all": Every criterion must pass (default)
+     * - "any": At least one criterion must pass
+     * - "threshold": A percentage of criteria must pass
+     */
+    mode?: "all" | "any" | "threshold";
+    /**
+     * For "threshold" mode: the minimum percentage of criteria that must pass (0-1).
+     * @default 0.75
+     */
+    threshold?: number;
+    /**
+     * Number of times to evaluate each criterion for reliability.
+     * The criterion passes if the majority of samples pass.
+     * @default 3
+     */
+    samples?: number;
+    /**
+     * Custom system prompt for the LLM. Overrides both the default prompt
+     * and any global prompt set in vibeMatchers config.
+     */
+    systemPrompt?: string;
+    /**
+     * Override the language model for this specific matcher call.
+     * If not provided, uses the model from vibeMatchers config.
+     */
+    languageModel?: LanguageModelV1;
+}
+export declare const toSatisfyCriteria: VibeMatcher<[
+    criteria: unknown,
+    options?: ToSatisfyCriteriaOptions
+]>;
+//# sourceMappingURL=toSatisfyCriteria.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toSatisfyCriteria.d.ts","sourceRoot":"","sources":["../../src/matchers/toSatisfyCriteria.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,IAAI,CAAC;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,2CAA2C;AAC3C,YAAY,EAAE,eAAe,EAAE,CAAC;AAOhC,eAAO,MAAM,+BAA+B,w0CA0BG,CAAC;AAgChD,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,WAAW,CAAC;IAEnC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,aAAa,CAAC,EAAE,eAAe,CAAC;CACjC;AAED,eAAO,MAAM,iBAAiB,EAAE,WAAW,CACzC;IAAC,QAAQ,EAAE,OAAO;IAAE,OAAO,CAAC,EAAE,wBAAwB;CAAC,CAiHtD,CAAC"}

package/dist/matchers.d.ts

@@ -0,0 +1,20 @@
+import type { MatcherFunction } from "expect";
+import type { VibeMatchConfig } from "./types";
+export declare const vibeMatchers: (config: VibeMatchConfig) => {
+    toBeSimilarTo: MatcherFunction<[similarTo: unknown, options?: import(".").ToBeSimilarToOptions | undefined]>;
+    toBeVectorSimilarTo: MatcherFunction<[expected: unknown, options?: import(".").VectorSimilarityOptions | undefined]>;
+    toMention: MatcherFunction<[concept: unknown, options?: import(".").ToMentionOptions | undefined]>;
+    toSatisfyCriteria: MatcherFunction<[criteria: unknown, options?: import(".").ToSatisfyCriteriaOptions | undefined]>;
+};
+type VibeMatchersReturnType = ReturnType<typeof vibeMatchers>;
+type VibeMatchersToJest<T, R> = {
+    [K in keyof T]: T[K] extends MatcherFunction<infer Args> ? (...args: Args) => R : never;
+};
+declare global {
+    namespace jest {
+        interface Matchers<R> extends VibeMatchersToJest<VibeMatchersReturnType, R> {
+        }
+    }
+}
+export {};
+//# sourceMappingURL=matchers.d.ts.map

package/dist/matchers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchers.d.ts","sourceRoot":"","sources":["../src/matchers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,KAAK,EACV,eAAe,EAIhB,MAAM,SAAS,CAAC;AA6CjB,eAAO,MAAM,YAAY,GAAI,QAAQ,eAAe;;;;;CASnD,CAAC;AAGF,KAAK,sBAAsB,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AAG9D,KAAK,kBAAkB,CAAC,CAAC,EAAE,CAAC,IAAI;KAC7B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,eAAe,CAAC,MAAM,IAAI,CAAC,GACpD,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,GACpB,KAAK;CACV,CAAC;AAGF,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,IAAI,CAAC;QACb,UAAU,QAAQ,CAAC,CAAC,CAClB,SAAQ,kBAAkB,CAAC,sBAAsB,EAAE,CAAC,CAAC;SAAG;KAC3D;CACF"}

package/dist/providers.d.ts

@@ -0,0 +1,38 @@
+import type { LanguageModelV1, EmbeddingModel } from "ai";
+import type { VibeMatchApiKeys } from "./types";
+/**
+ * Providers supported by vibe-match for language models.
+ */
+type LanguageProvider = "openai" | "anthropic" | "google" | "mistral" | "xai";
+/**
+ * Providers that support embedding models.
+ * Note: Anthropic and xAI do not provide embedding models.
+ */
+type EmbeddingProvider = "openai" | "google" | "mistral";
+/**
+ * Language model string in the format "provider:model-name".
+ *
+ * The model name is validated at runtime by the AI SDK provider.
+ *
+ * @example "openai:gpt-4o-mini"
+ * @example "anthropic:claude-sonnet-4-20250514"
+ * @example "google:gemini-2.0-flash"
+ * @example "mistral:mistral-small-latest"
+ * @example "xai:grok-2-1212"
+ */
+export type LanguageModelString = `${LanguageProvider}:${string}`;
+/**
+ * Embedding model string in the format "provider:model-name".
+ *
+ * The model name is validated at runtime by the AI SDK provider.
+ * Only openai, google, and mistral support embedding models.
+ *
+ * @example "openai:text-embedding-3-small"
+ * @example "google:text-embedding-004"
+ * @example "mistral:mistral-embed"
+ */
+export type EmbeddingModelString = `${EmbeddingProvider}:${string}`;
+export declare function resolveLanguageModel(modelString: LanguageModelString, apiKeys: VibeMatchApiKeys): LanguageModelV1;
+export declare function resolveEmbeddingModel(modelString: EmbeddingModelString, apiKeys: VibeMatchApiKeys): EmbeddingModel<string>;
+export {};
+//# sourceMappingURL=providers.d.ts.map

package/dist/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;AAM1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD;;GAEG;AACH,KAAK,gBAAgB,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAC;AAE9E;;;GAGG;AACH,KAAK,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEzD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,mBAAmB,GAAG,GAAG,gBAAgB,IAAI,MAAM,EAAE,CAAC;AAElE;;;;;;;;;GASG;AACH,MAAM,MAAM,oBAAoB,GAAG,GAAG,iBAAiB,IAAI,MAAM,EAAE,CAAC;AAkCpE,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,mBAAmB,EAChC,OAAO,EAAE,gBAAgB,GACxB,eAAe,CAkDjB;AAED,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,oBAAoB,EACjC,OAAO,EAAE,gBAAgB,GACxB,cAAc,CAAC,MAAM,CAAC,CAmCxB"}

package/dist/types.d.ts

@@ -0,0 +1,210 @@
+import type { MatcherFunction } from "expect";
+import type { LanguageModelV1, EmbeddingModel } from "ai";
+import type { LanguageModelString, EmbeddingModelString } from "./providers";
+/**
+ * Prompt configuration for customizing LLM behavior.
+ * Each matcher can have its default prompt overridden globally here,
+ * and can be further overridden per-call via matcher options.
+ */
+export interface VibeMatchPrompts {
+    /**
+     * System prompt for the toBeSimilarTo matcher.
+     * Receives: actual, similarTo, level
+     */
+    toBeSimilarTo?: string;
+    /**
+     * System prompt for the toMention matcher.
+     * Receives: actual, concept
+     */
+    toMention?: string;
+    /**
+     * System prompt for the toSatisfyCriteria matcher.
+     * Receives: text, criterion
+     */
+    toSatisfyCriteria?: string;
+}
+/**
+ * API keys for each provider.
+ * Only provide keys for the providers you intend to use.
+ */
+export interface VibeMatchApiKeys {
+    /**
+     * OpenAI API key.
+     * Required if using openai models.
+     */
+    openai?: string;
+    /**
+     * Anthropic API key.
+     * Required if using anthropic models.
+     */
+    anthropic?: string;
+    /**
+     * Google Generative AI API key.
+     * Required if using google models.
+     */
+    google?: string;
+    /**
+     * Mistral API key.
+     * Required if using mistral models.
+     */
+    mistral?: string;
+    /**
+     * xAI API key.
+     * Required if using xai models.
+     */
+    xai?: string;
+}
+/**
+ * Configuration for vibe-match
+ *
+ * Models are specified as strings in the format "provider:model-name".
+ *
+ * @example
+ * ```typescript
+ * const config: VibeMatchConfig = {
+ *   apiKeys: {
+ *     openai: process.env.OPENAI_API_KEY,
+ *   },
+ *   languageModel: "openai:gpt-4o-mini",
+ *   embeddingModel: "openai:text-embedding-3-small",
+ * };
+ * ```
+ */
+export interface VibeMatchStringConfig {
+    /**
+     * API keys for each provider.
+     * Only provide keys for the providers you intend to use.
+     */
+    apiKeys: VibeMatchApiKeys;
+    /**
+     * The language model to use for semantic matching.
+     *
+     * Format: "provider:model-name"
+     *
+     * Supported providers: openai, anthropic, google, mistral, xai
+     *
+     * @example "openai:gpt-4o-mini"
+     * @example "anthropic:claude-sonnet-4-20250514"
+     * @example "google:gemini-2.0-flash"
+     */
+    languageModel: LanguageModelString;
+    /**
+     * The embedding model to use for vector similarity.
+     *
+     * Format: "provider:model-name"
+     *
+     * Supported providers: openai, google, mistral
+     * (anthropic and xai do not provide embedding models)
+     *
+     * @example "openai:text-embedding-3-small"
+     * @example "google:text-embedding-004"
+     */
+    embeddingModel: EmbeddingModelString;
+    /**
+     * Optional prompt overrides for each matcher.
+     * These serve as defaults that can be further overridden per-call.
+     */
+    prompts?: VibeMatchPrompts;
+}
+/**
+ * Configuration for vibe-match using custom AI SDK model instances.
+ *
+ * Use this when you need to use a custom provider, OpenAI-compatible API,
+ * or configure models with custom options.
+ *
+ * @example
+ * ```typescript
+ * import { createOpenAI } from "@ai-sdk/openai";
+ *
+ * // Use OpenRouter with custom models
+ * const openrouter = createOpenAI({
+ *   baseURL: "https://openrouter.ai/api/v1",
+ *   apiKey: process.env.OPENROUTER_API_KEY,
+ * });
+ *
+ * const config: VibeMatchConfig = {
+ *   languageModel: openrouter("anthropic/claude-sonnet-4"),
+ *   embeddingModel: openrouter.embedding("openai/text-embedding-3-small"),
+ * };
+ * ```
+ */
+export interface VibeMatchCustomModelConfig {
+    /**
+     * A custom language model instance from the AI SDK.
+     *
+     * Create using any AI SDK provider (built-in or custom).
+     *
+     * @example
+     * ```typescript
+     * import { createOpenAI } from "@ai-sdk/openai";
+     * const openai = createOpenAI({ apiKey: "..." });
+     * const languageModel = openai("gpt-4o-mini");
+     * ```
+     */
+    languageModel: LanguageModelV1;
+    /**
+     * A custom embedding model instance from the AI SDK.
+     *
+     * Create using any AI SDK provider that supports embeddings.
+     *
+     * @example
+     * ```typescript
+     * import { createOpenAI } from "@ai-sdk/openai";
+     * const openai = createOpenAI({ apiKey: "..." });
+     * const embeddingModel = openai.embedding("text-embedding-3-small");
+     * ```
+     */
+    embeddingModel: EmbeddingModel<string>;
+    /**
+     * Optional prompt overrides for each matcher.
+     * These serve as defaults that can be further overridden per-call.
+     */
+    prompts?: VibeMatchPrompts;
+}
+/**
+ * Configuration for vibe-match.
+ *
+ * Supports two configuration styles:
+ *
+ * 1. **String-based** (built-in providers): Use model strings like "openai:gpt-4o-mini"
+ *    with API keys for automatic model resolution.
+ *
+ * 2. **Custom models**: Pass AI SDK model instances directly for custom providers,
+ *    OpenAI-compatible APIs (OpenRouter, Together AI, etc.), or advanced configuration.
+ *
+ * @example String-based configuration
+ * ```typescript
+ * const config: VibeMatchConfig = {
+ *   apiKeys: { openai: process.env.OPENAI_API_KEY },
+ *   languageModel: "openai:gpt-4o-mini",
+ *   embeddingModel: "openai:text-embedding-3-small",
+ * };
+ * ```
+ *
+ * @example Custom model configuration
+ * ```typescript
+ * import { createOpenAI } from "@ai-sdk/openai";
+ *
+ * const openrouter = createOpenAI({
+ *   baseURL: "https://openrouter.ai/api/v1",
+ *   apiKey: process.env.OPENROUTER_API_KEY,
+ * });
+ *
+ * const config: VibeMatchConfig = {
+ *   languageModel: openrouter("anthropic/claude-sonnet-4"),
+ *   embeddingModel: openrouter.embedding("openai/text-embedding-3-small"),
+ * };
+ * ```
+ */
+export type VibeMatchConfig = VibeMatchStringConfig | VibeMatchCustomModelConfig;
+/**
+ * Internal resolved configuration with actual model instances.
+ * Used by matchers after string configs are resolved.
+ */
+export interface ResolvedVibeMatchConfig {
+    languageModel: LanguageModelV1;
+    embeddingModel: EmbeddingModel<string>;
+    prompts?: VibeMatchPrompts;
+}
+export type VibeMatcher<T extends any[]> = (config: ResolvedVibeMatchConfig) => MatcherFunction<T>;
+//# 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":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAE7E;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,OAAO,EAAE,gBAAgB,CAAC;IAC1B;;;;;;;;;;OAUG;IACH,aAAa,EAAE,mBAAmB,CAAC;IAEnC;;;;;;;;;;OAUG;IACH,cAAc,EAAE,oBAAoB,CAAC;IAErC;;;OAGG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;;;;;;;;OAWG;IACH,aAAa,EAAE,eAAe,CAAC;IAE/B;;;;;;;;;;;OAWG;IACH,cAAc,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAEvC;;;OAGG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,MAAM,eAAe,GACvB,qBAAqB,GACrB,0BAA0B,CAAC;AAE/B;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,eAAe,CAAC;IAC/B,cAAc,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IACvC,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,GAAG,EAAE,IAAI,CACzC,MAAM,EAAE,uBAAuB,KAC5B,eAAe,CAAC,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "vibe-match",
+  "version": "0.1.0",
+  "description": "AI-powered semantic matchers for testing with vitest and jest",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --target node && bun run build:types",
+    "build:types": "tsc --declaration --emitDeclarationOnly --outDir ./dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": [
+    "testing",
+    "vitest",
+    "jest",
+    "ai",
+    "semantic",
+    "llm",
+    "matcher",
+    "assertions"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/your-username/vibe-match.git"
+  },
+  "license": "MIT",
+  "author": "",
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/jest": "latest",
+    "prettier": "^3.6.2",
+    "vitest": "^4.0.16"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "@ai-sdk/anthropic": "^1.2.0",
+    "@ai-sdk/google": "^1.2.0",
+    "@ai-sdk/mistral": "^1.2.0",
+    "@ai-sdk/openai": "^1.3.0",
+    "@ai-sdk/xai": "^1.2.0",
+    "ai": "^4.3.0",
+    "zod": "^3.23.8"
+  }
+}