vieval 0.0.10 → 0.0.12

package/dist/plugins/chat-models/index.d.mts

@@ -1,22 +1,14 @@
-import { D as TaskRunContext, R as ModelDefinition, f as MatrixDefinition, t as ConfigHookPlugin, w as TaskExecutionPolicy } from "../../index-D_aMeWqO.mjs";
+import { D as TaskRunContext, R as ModelDefinition, f as MatrixDefinition, t as ConfigHookPlugin, w as TaskExecutionPolicy } from "../../index-BLIlhiWT.mjs";
 
 //#region src/plugins/chat-models/runtime-config.d.ts
 /**
- * Runtime config consumed by OpenAI-compatible provider constructors.
+ * Union of normalized runtime configs for supported chat-model executors.
  */
-interface OpenAIChatModelRuntimeConfig {
-  /**
-   * Resolved inference executor kind.
-   */
-  inferenceExecutor: 'openai';
-  /**
-   * Concrete model name.
-   */
-  model: string;
-  /**
-   * Required API key.
-   */
-  apiKey: string;
+type ChatModelRuntimeConfig = OllamaChatModelRuntimeConfig | OpenAIChatModelRuntimeConfig | OpenRouterChatModelRuntimeConfig;
+/**
+ * Runtime config consumed by Ollama provider constructors.
+ */
+interface OllamaChatModelRuntimeConfig {
   /**
    * Optional base URL override.
    */
@@ -25,11 +17,6 @@ interface OpenAIChatModelRuntimeConfig {
    * Optional request headers.
    */
   headers?: ChatModelHeaders;
-}
-/**
- * Runtime config consumed by Ollama provider constructors.
- */
-interface OllamaChatModelRuntimeConfig {
   /**
    * Resolved inference executor kind.
    */
@@ -38,6 +25,15 @@ interface OllamaChatModelRuntimeConfig {
    * Concrete model name.
    */
   model: string;
+}
+/**
+ * Runtime config consumed by OpenAI-compatible provider constructors.
+ */
+interface OpenAIChatModelRuntimeConfig {
+  /**
+   * Required API key.
+   */
+  apiKey: string;
   /**
    * Optional base URL override.
    */
@@ -46,19 +42,19 @@ interface OllamaChatModelRuntimeConfig {
    * Optional request headers.
    */
   headers?: ChatModelHeaders;
-}
-/**
- * Runtime config consumed by OpenRouter provider constructors.
- */
-interface OpenRouterChatModelRuntimeConfig {
   /**
    * Resolved inference executor kind.
    */
-  inferenceExecutor: 'openrouter';
+  inferenceExecutor: 'openai';
   /**
    * Concrete model name.
    */
   model: string;
+}
+/**
+ * Runtime config consumed by OpenRouter provider constructors.
+ */
+interface OpenRouterChatModelRuntimeConfig {
   /**
    * Required API key.
    */
@@ -71,26 +67,29 @@ interface OpenRouterChatModelRuntimeConfig {
    * Optional request headers.
    */
   headers?: ChatModelHeaders;
+  /**
+   * Resolved inference executor kind.
+   */
+  inferenceExecutor: 'openrouter';
+  /**
+   * Concrete model name.
+   */
+  model: string;
 }
 /**
- * Union of normalized runtime configs for supported chat-model executors.
- */
-type ChatModelRuntimeConfig = OpenAIChatModelRuntimeConfig | OllamaChatModelRuntimeConfig | OpenRouterChatModelRuntimeConfig;
-/**
- * Normalizes one configured chat model into runtime executor config.
+ * Resolves Ollama runtime config from one resolved run-context model.
  *
  * Use when:
- * - eval code needs typed provider constructor options from a resolved model
- * - model parameters should be validated once with clear error messages
+ * - task execution already has a model resolved through chat-model helpers
+ * - eval code wants typed Ollama provider options with a concise helper name
  *
  * Expects:
- * - `model.inferenceExecutorId` to be one of the supported executor ids
- * - required OpenAI fields (apiKey) to exist in `model.parameters`
+ * - `model` to resolve to an Ollama-backed chat model
  *
  * Returns:
- * - validated runtime config union for OpenAI or Ollama
+ * - validated Ollama runtime config
  */
-declare function toChatModelRuntimeConfig(model: ModelDefinition): ChatModelRuntimeConfig;
+declare function ollamaFromRunContext(model: ModelDefinition): OllamaChatModelRuntimeConfig;
 /**
  * Resolves OpenAI runtime config from one resolved run-context model.
  *
@@ -106,35 +105,49 @@ declare function toChatModelRuntimeConfig(model: ModelDefinition): ChatModelRunt
  */
 declare function openaiFromRunContext(model: ModelDefinition): OpenAIChatModelRuntimeConfig;
 /**
- * Resolves Ollama runtime config from one resolved run-context model.
+ * Resolves OpenRouter runtime config from one resolved run-context model.
  *
  * Use when:
  * - task execution already has a model resolved through chat-model helpers
- * - eval code wants typed Ollama provider options with a concise helper name
+ * - eval code wants typed OpenRouter provider options with a concise helper name
  *
  * Expects:
- * - `model` to resolve to an Ollama-backed chat model
+ * - `model` to resolve to an OpenRouter-backed chat model
  *
  * Returns:
- * - validated Ollama runtime config
+ * - validated OpenRouter runtime config
  */
-declare function ollamaFromRunContext(model: ModelDefinition): OllamaChatModelRuntimeConfig;
+declare function openrouterFromRunContext(model: ModelDefinition): OpenRouterChatModelRuntimeConfig;
 /**
- * Resolves OpenRouter runtime config from one resolved run-context model.
+ * Normalizes one configured chat model into runtime executor config.
  *
  * Use when:
- * - task execution already has a model resolved through chat-model helpers
- * - eval code wants typed OpenRouter provider options with a concise helper name
+ * - eval code needs typed provider constructor options from a resolved model
+ * - model parameters should be validated once with clear error messages
  *
  * Expects:
- * - `model` to resolve to an OpenRouter-backed chat model
+ * - `model.inferenceExecutorId` to be one of the supported executor ids
+ * - required OpenAI fields (apiKey) to exist in `model.parameters`
  *
  * Returns:
- * - validated OpenRouter runtime config
+ * - validated runtime config union for OpenAI or Ollama
  */
-declare function openrouterFromRunContext(model: ModelDefinition): OpenRouterChatModelRuntimeConfig;
+declare function toChatModelRuntimeConfig(model: ModelDefinition): ChatModelRuntimeConfig;
 //#endregion
 //#region src/plugins/chat-models/telemetry.d.ts
+/**
+ * Provider identity attached to chat-model telemetry events.
+ */
+interface ChatModelTelemetryProvider {
+  /**
+   * Provider id, for example `openai`.
+   */
+  id: string;
+  /**
+   * Optional concrete model id/name.
+   */
+  model?: string;
+}
 /**
  * Represents one normalized chat-model tool call.
  *
@@ -146,52 +159,35 @@ declare function openrouterFromRunContext(model: ModelDefinition): OpenRouterCha
  * - `args` to be JSON-serializable
  */
 interface ChatModelToolCall {
-  /**
-   * Optional provider-assigned tool-call identifier.
-   */
-  id?: string;
-  /**
-   * Tool name.
-   */
-  name: string;
   /**
    * Parsed tool arguments object/value.
    */
   args: unknown;
-}
-/**
- * Provider identity attached to chat-model telemetry events.
- */
-interface ChatModelTelemetryProvider {
   /**
-   * Provider id, for example `openai`.
+   * Optional provider-assigned tool-call identifier.
    */
-  id: string;
+  id?: string;
   /**
-   * Optional concrete model id/name.
+   * Tool name.
    */
-  model?: string;
+  name: string;
 }
 /**
- * Input options for response telemetry emission.
+ * Input options for error telemetry emission.
  */
-interface EmitChatModelResponseTelemetryOptions {
+interface EmitChatModelErrorTelemetryOptions {
   /**
    * Optional case id for case-scoped telemetry events.
    */
   caseId?: string;
   /**
-   * Optional response latency in milliseconds.
+   * Error payload emitted by the inference client/runtime.
    */
-  latencyMs?: number;
+  error: unknown;
   /**
    * Optional provider identity payload.
    */
   provider?: ChatModelTelemetryProvider;
-  /**
-   * Raw chat-model response object from the inference library/provider.
-   */
-  response: unknown;
 }
 /**
  * Input options for request telemetry emission.
@@ -211,43 +207,46 @@ interface EmitChatModelRequestTelemetryOptions {
   provider?: ChatModelTelemetryProvider;
 }
 /**
- * Input options for error telemetry emission.
+ * Input options for response telemetry emission.
  */
-interface EmitChatModelErrorTelemetryOptions {
+interface EmitChatModelResponseTelemetryOptions {
   /**
    * Optional case id for case-scoped telemetry events.
    */
   caseId?: string;
   /**
-   * Error payload emitted by the inference client/runtime.
+   * Optional response latency in milliseconds.
    */
-  error: unknown;
+  latencyMs?: number;
   /**
    * Optional provider identity payload.
    */
   provider?: ChatModelTelemetryProvider;
+  /**
+   * Raw chat-model response object from the inference library/provider.
+   */
+  response: unknown;
 }
 /**
- * Extracts normalized tool calls from one chat-model response shape.
+ * Emits chat-model failure telemetry as a reportable task event.
  *
  * Use when:
- * - downstream scoring, reporting, or analysis should inspect tool call usage
- * - provider payload differences should stay hidden behind one stable shape
+ * - one inference call fails and report artifacts should include normalized error context
  *
- * Returns:
- * - normalized list of `{ id?, name, args }` tool calls
+ * Expects:
+ * - `context.reporterHooks?.onEvent` to be available in CLI execution paths
  */
-declare function extractChatModelToolCalls(response: unknown): ChatModelToolCall[];
+declare function emitChatModelErrorTelemetry(context: TaskRunContext, options: EmitChatModelErrorTelemetryOptions): void;
 /**
- * Extracts numeric metering dimensions from one chat-model response usage block.
+ * Emits chat-model request telemetry as a reportable task event.
  *
  * Use when:
- * - report events should capture usage dimensions in a modality-neutral map
+ * - task code submits one model request and wants request-side traceability
  *
- * Returns:
- * - numeric dimensions keyed by provider usage field names
+ * Expects:
+ * - `context.reporterHooks?.onEvent` to be available in CLI execution paths
  */
-declare function extractMeteringDimensions(response: unknown): Record<string, number>;
+declare function emitChatModelRequestTelemetry(context: TaskRunContext, options: EmitChatModelRequestTelemetryOptions): void;
 /**
  * Emits chat-model response telemetry as reportable task events.
  *
@@ -263,115 +262,80 @@ declare function extractMeteringDimensions(response: unknown): Record<string, nu
  */
 declare function emitChatModelResponseTelemetry(context: TaskRunContext, options: EmitChatModelResponseTelemetryOptions): void;
 /**
- * Emits chat-model request telemetry as a reportable task event.
+ * Extracts normalized tool calls from one chat-model response shape.
  *
  * Use when:
- * - task code submits one model request and wants request-side traceability
+ * - downstream scoring, reporting, or analysis should inspect tool call usage
+ * - provider payload differences should stay hidden behind one stable shape
  *
- * Expects:
- * - `context.reporterHooks?.onEvent` to be available in CLI execution paths
+ * Returns:
+ * - normalized list of `{ id?, name, args }` tool calls
  */
-declare function emitChatModelRequestTelemetry(context: TaskRunContext, options: EmitChatModelRequestTelemetryOptions): void;
+declare function extractChatModelToolCalls(response: unknown): ChatModelToolCall[];
 /**
- * Emits chat-model failure telemetry as a reportable task event.
+ * Extracts numeric metering dimensions from one chat-model response usage block.
  *
  * Use when:
- * - one inference call fails and report artifacts should include normalized error context
+ * - report events should capture usage dimensions in a modality-neutral map
  *
- * Expects:
- * - `context.reporterHooks?.onEvent` to be available in CLI execution paths
+ * Returns:
+ * - numeric dimensions keyed by provider usage field names
  */
-declare function emitChatModelErrorTelemetry(context: TaskRunContext, options: EmitChatModelErrorTelemetryOptions): void;
+declare function extractMeteringDimensions(response: unknown): Record<string, number>;
 //#endregion
 //#region src/plugins/chat-models/index.d.ts
 /**
- * Minimal inference-executor shape expected by chat model runtime callers.
+ * Chat-model specific specialization of the canonical `ModelDefinition`.
  */
-interface ChatModelExecutorLike {
-  chat: (model: string) => Record<string, unknown>;
-}
+type ChatModelDefinition = Omit<ModelDefinition, 'inferenceExecutor'> & {
+  inferenceExecutor: ChatModelExecutorInput;
+  provider?: string;
+  runtimeResolvers?: {
+    apiKey?: ChatModelResolverValue<string>;
+    baseURL?: ChatModelResolverValue<string>;
+    headers?: ChatModelResolverValue<ChatModelHeaders>;
+  };
+};
 /**
  * Inference-executor input accepted by `chatModelFrom`.
  */
-type ChatModelExecutorInput = string | ChatModelExecutorLike;
-/**
- * Chat-model header payload accepted by executor parameters.
- */
-type ChatModelHeaders = Record<string, string | string[]>;
-/**
- * Runtime env context passed to model callback resolvers.
- */
-interface ChatModelResolverContext {
-  env: Record<string, string>;
-}
-/**
- * Value-or-callback resolver used by model runtime fields.
- */
-type ChatModelResolverValue<TValue> = TValue | ((config: ChatModelResolverContext) => Promise<TValue> | TValue);
-/**
- * OpenAI-specific inference executor config shape.
- */
-interface OpenAIChatModelInferenceExecutor {
-  inferenceExecutor: 'openai';
-  apiKey?: ChatModelResolverValue<string>;
-  baseURL?: ChatModelResolverValue<string>;
-  headers?: ChatModelResolverValue<ChatModelHeaders>;
-}
-/**
- * Ollama-specific inference executor config shape.
- */
-interface OllamaChatModelInferenceExecutor {
-  inferenceExecutor: 'ollama';
-  baseURL?: ChatModelResolverValue<string>;
-  headers?: ChatModelResolverValue<ChatModelHeaders>;
-}
-/**
- * OpenRouter-specific inference executor config shape.
- */
-interface OpenRouterChatModelInferenceExecutor {
-  inferenceExecutor: 'openrouter';
-  apiKey?: ChatModelResolverValue<string>;
-  baseURL?: ChatModelResolverValue<string>;
-  headers?: ChatModelResolverValue<ChatModelHeaders>;
-}
+type ChatModelExecutorInput = ChatModelExecutorLike | string;
 /**
- * Generic inference executor config shape.
+ * Minimal inference-executor shape expected by chat model runtime callers.
  */
-interface GenericChatModelInferenceExecutor {
-  inferenceExecutor?: ChatModelExecutorInput;
+interface ChatModelExecutorLike {
+  chat: (model: string) => Record<string, unknown>;
 }
-/**
- * Union of supported inference executor config shapes for `chatModelFrom`.
- */
-type ChatModelInferenceExecutor = OpenAIChatModelInferenceExecutor | OllamaChatModelInferenceExecutor | OpenRouterChatModelInferenceExecutor | GenericChatModelInferenceExecutor;
 /**
  * Common builder input fields for `chatModelFrom`.
  */
 interface ChatModelFromBaseOptions {
   /**
-   * Provider id registered through `ChatProviders`.
-   *
-   * Use when:
-   * - model runtime transport and credentials should be delegated to a named provider preset
+   * Alias names used by `resolveModelByName`.
+   */
+  aliases?: string[];
+  /**
+   * Additional full task attempts allowed after the current attempt settles.
    *
-   * Expects:
-   * - one `ChatProviders` plugin entry to expose the same id
+   * @default 0
    */
-  provider?: string;
+  autoAttempt?: number;
   /**
-   * Inference-executor id or inference-executor instance.
+   * Additional retries allowed within the current attempt.
+   *
+   * @default 0
    */
-  inferenceExecutor?: ChatModelExecutorInput;
+  autoRetry?: number;
   /**
-   * Optional explicit inference-executor id for inference-executor instances.
+   * Delay in milliseconds before a retry starts.
    *
-   * @default 'custom'
+   * @default retryIndex => 500 * 2 ** (retryIndex - 1)
    */
-  inferenceExecutorId?: string;
+  autoRetryDelay?: TaskExecutionPolicy['autoRetryDelay'];
   /**
-   * Concrete model name.
+   * Optional execution policy hints attached to this model.
    */
-  model: string;
+  executionPolicy?: TaskExecutionPolicy;
   /**
    * Optional stable model id.
    *
@@ -379,72 +343,69 @@ interface ChatModelFromBaseOptions {
    */
   id?: string;
   /**
-   * Alias names used by `resolveModelByName`.
+   * Inference-executor id or inference-executor instance.
    */
-  aliases?: string[];
+  inferenceExecutor?: ChatModelExecutorInput;
   /**
-   * Optional execution policy hints attached to this model.
+   * Optional explicit inference-executor id for inference-executor instances.
+   *
+   * @default 'custom'
    */
-  executionPolicy?: TaskExecutionPolicy;
+  inferenceExecutorId?: string;
   /**
-   * Additional retries allowed within the current attempt.
-   *
-   * @default 0
+   * Concrete model name.
    */
-  autoRetry?: number;
+  model: string;
   /**
-   * Delay in milliseconds before a retry starts.
-   *
-   * @default retryIndex => 500 * 2 ** (retryIndex - 1)
+   * Optional model-level call parameters.
    */
-  autoRetryDelay?: TaskExecutionPolicy['autoRetryDelay'];
+  parameters?: Record<string, unknown>;
   /**
-   * Additional full task attempts allowed after the current attempt settles.
+   * Provider id registered through `ChatProviders`.
    *
-   * @default 0
+   * Use when:
+   * - model runtime transport and credentials should be delegated to a named provider preset
+   *
+   * Expects:
+   * - one `ChatProviders` plugin entry to expose the same id
    */
-  autoAttempt?: number;
+  provider?: string;
   /**
    * Timeout in milliseconds for model-backed work.
    */
   timeout?: number;
-  /**
-   * Optional model-level call parameters.
-   */
-  parameters?: Record<string, unknown>;
 }
 /**
  * Builder input for `chatModelFrom`.
  */
-type ChatModelFromOptions = ChatModelInferenceExecutor & ChatModelFromBaseOptions;
+type ChatModelFromOptions = ChatModelFromBaseOptions & ChatModelInferenceExecutor;
 /**
- * Chat-model specific specialization of the canonical `ModelDefinition`.
+ * Chat-model header payload accepted by executor parameters.
  */
-type ChatModelDefinition = Omit<ModelDefinition, 'inferenceExecutor'> & {
-  inferenceExecutor: ChatModelExecutorInput;
-  provider?: string;
-  runtimeResolvers?: {
-    apiKey?: ChatModelResolverValue<string>;
-    baseURL?: ChatModelResolverValue<string>;
-    headers?: ChatModelResolverValue<ChatModelHeaders>;
-  };
-};
+type ChatModelHeaders = Record<string, string | string[]>;
 /**
- * Env-key map for optional provider parameters.
- *
- * Use when:
- * - provider parameter values should be read from env keys
- * - missing keys should resolve to `undefined`
+ * Union of supported inference executor config shapes for `chatModelFrom`.
  */
-type OptionalProviderEnvMap = Record<string, string>;
+type ChatModelInferenceExecutor = GenericChatModelInferenceExecutor | OllamaChatModelInferenceExecutor | OpenAIChatModelInferenceExecutor | OpenRouterChatModelInferenceExecutor;
 /**
- * Env-key map for required provider parameters.
- *
- * Use when:
- * - provider parameter values must exist before model execution
- * - missing keys should throw with key-aware error messages
+ * Runtime env context passed to model callback resolvers.
  */
-type RequiredProviderEnvMap = Record<string, string>;
+interface ChatModelResolverContext {
+  env: Record<string, string>;
+}
+/**
+ * Value-or-callback resolver used by model runtime fields.
+ */
+type ChatModelResolverValue<TValue> = ((config: ChatModelResolverContext) => Promise<TValue> | TValue) | TValue;
+/**
+ * Options for the built-in `ChatModels` plugin.
+ */
+interface ChatModelsPluginOptions {
+  /**
+   * Chat model definitions to append to config.
+   */
+  models: readonly ChatModelDefinition[];
+}
 /**
  * One provider definition consumed by chat model presets.
  */
@@ -463,10 +424,6 @@ interface ChatProviderDefinition {
    * @default 'custom'
    */
   inferenceExecutorId?: string;
-  /**
-   * Optional literal provider-level parameters.
-   */
-  parameters?: Record<string, unknown>;
   /**
    * Optional provider parameters resolved via `envFrom`.
    *
@@ -475,6 +432,10 @@ interface ChatProviderDefinition {
    * - map value is the env key name
    */
   optionalEnv?: OptionalProviderEnvMap;
+  /**
+   * Optional literal provider-level parameters.
+   */
+  parameters?: Record<string, unknown>;
   /**
    * Required provider parameters resolved via `requiredEnvFrom`.
    *
@@ -492,97 +453,137 @@ interface ChatProviderFromOptions extends ChatProviderDefinition {}
  * Options for the built-in `ChatProviders` plugin.
  */
 interface ChatProvidersPluginOptions {
-  /**
-   * Provider definitions to append to config.
-   */
-  providers: readonly ChatProviderDefinition[];
   /**
    * Optional explicit env source used for env-backed provider parameters.
    *
    * @default process.env
    */
   env?: NodeJS.ProcessEnv;
+  /**
+   * Provider definitions to append to config.
+   */
+  providers: readonly ChatProviderDefinition[];
 }
 /**
- * Partial config shape needed by the chat models plugin.
+ * Generic inference executor config shape.
  */
-interface PluginConfig {
-  env?: NodeJS.ProcessEnv;
-  chatProviders?: ChatProviderDefinition[];
-  models?: ModelDefinition[];
+interface GenericChatModelInferenceExecutor {
+  inferenceExecutor?: ChatModelExecutorInput;
 }
 /**
- * Plugin type bound to the minimal config shape used by model plugins.
+ * Matrix scope that can carry a chat model selector.
  */
-type Plugin = ConfigHookPlugin<PluginConfig>;
+type MatrixModelScope = 'eval' | 'run';
 /**
- * Builds one normalized chat model definition.
- *
- * Use when:
- * - registering chat models through config plugins
- * - a single model needs aliases for matrix selection or judge lookup
+ * Options for resolving a chat model from a matrix axis.
  */
-declare function chatModelFrom(options: ChatModelFromOptions): ChatModelDefinition;
+interface ModelFromMatrixOptions {
+  /**
+   * Matrix axis whose selected value is a model id, model name, or alias.
+   */
+  axis: string;
+}
 /**
- * Builds one normalized chat provider definition.
- *
- * Use when:
- * - one provider preset should be reused across multiple chat models
- * - provider configuration should support required/optional env-backed parameters
+ * Ollama-specific inference executor config shape.
  */
-declare function chatProviderFrom(options: ChatProviderFromOptions): ChatProviderDefinition;
+interface OllamaChatModelInferenceExecutor {
+  baseURL?: ChatModelResolverValue<string>;
+  headers?: ChatModelResolverValue<ChatModelHeaders>;
+  inferenceExecutor: 'ollama';
+}
 /**
- * Options for the built-in `ChatModels` plugin.
+ * OpenAI-specific inference executor config shape.
  */
-interface ChatModelsPluginOptions {
-  /**
-   * Chat model definitions to append to config.
-   */
-  models: readonly ChatModelDefinition[];
+interface OpenAIChatModelInferenceExecutor {
+  apiKey?: ChatModelResolverValue<string>;
+  baseURL?: ChatModelResolverValue<string>;
+  headers?: ChatModelResolverValue<ChatModelHeaders>;
+  inferenceExecutor: 'openai';
 }
 /**
- * Matrix scope that can carry a chat model selector.
+ * OpenRouter-specific inference executor config shape.
  */
-type MatrixModelScope = 'eval' | 'run';
+interface OpenRouterChatModelInferenceExecutor {
+  apiKey?: ChatModelResolverValue<string>;
+  baseURL?: ChatModelResolverValue<string>;
+  headers?: ChatModelResolverValue<ChatModelHeaders>;
+  inferenceExecutor: 'openrouter';
+}
 /**
- * Options for resolving a chat model from a matrix axis.
+ * Env-key map for optional provider parameters.
+ *
+ * Use when:
+ * - provider parameter values should be read from env keys
+ * - missing keys should resolve to `undefined`
  */
-interface ModelFromMatrixOptions {
-  /**
-   * Matrix axis whose selected value is a model id, model name, or alias.
-   */
-  axis: string;
+type OptionalProviderEnvMap = Record<string, string>;
+/**
+ * Plugin type bound to the minimal config shape used by model plugins.
+ */
+type Plugin = ConfigHookPlugin<PluginConfig>;
+/**
+ * Partial config shape needed by the chat models plugin.
+ */
+interface PluginConfig {
+  chatProviders?: ChatProviderDefinition[];
+  env?: NodeJS.ProcessEnv;
+  models?: ModelDefinition[];
 }
+/**
+ * Env-key map for required provider parameters.
+ *
+ * Use when:
+ * - provider parameter values must exist before model execution
+ * - missing keys should throw with key-aware error messages
+ */
+type RequiredProviderEnvMap = Record<string, string>;
 type MatrixModelContext = Pick<TaskRunContext, 'models' | 'task'>;
 /**
- * Resolves a configured chat model from one scoped matrix axis.
+ * Builds one normalized chat model definition.
  *
  * Use when:
- * - a matrix axis selects the agent, judge, or another chat model role
- * - eval code should keep model lookup semantics inside the chat-models plugin
+ * - registering chat models through config plugins
+ * - a single model needs aliases for matrix selection or judge lookup
+ */
+declare function chatModelFrom(options: ChatModelFromOptions): ChatModelDefinition;
+/**
+ * Creates a run-matrix `model` axis from configured chat model names.
+ *
+ * Use when:
+ * - run matrix should iterate over explicit chat model ids/aliases
+ * - project configs want a concise model-axis helper
  *
  * Expects:
- * - `scope` to identify `context.task.matrix.run` or `context.task.matrix.eval`
- * - `options.axis` to exist and contain a model id, model name, or alias
+ * - each provided name to match a configured model id or alias at runtime
  *
  * Returns:
- * - the configured model matching the selected matrix value
+ * - matrix axis object compatible with `runMatrix.extend/override`
  */
-declare function modelFromMatrix(context: MatrixModelContext, scope: MatrixModelScope, options: ModelFromMatrixOptions): ModelDefinition;
+declare function chatModelMatrix(...names: string[]): MatrixDefinition;
 /**
- * Resolves a configured chat model from one run-matrix axis.
+ * Built-in chat models plugin that contributes model definitions to vieval config.
  *
  * Use when:
- * - run matrix selects the model used by the system under evaluation
- * - callers want the scoped helper instead of passing `scope: 'run'`
+ * - chat-model registration should stay in config-level plugin setup
+ * - tasks and assertions resolve models by name or alias at runtime
+ */
+declare function ChatModels(options: ChatModelsPluginOptions): Plugin;
+/**
+ * Builds one normalized chat provider definition.
  *
- * Expects:
- * - `options.axis` to exist in `context.task.matrix.run`
+ * Use when:
+ * - one provider preset should be reused across multiple chat models
+ * - provider configuration should support required/optional env-backed parameters
+ */
+declare function chatProviderFrom(options: ChatProviderFromOptions): ChatProviderDefinition;
+/**
+ * Built-in chat providers plugin that contributes provider presets to config.
  *
- * Returns:
- * - the configured model matching the selected run-matrix value
+ * Use when:
+ * - provider runtime config should be centralized and reusable
+ * - provider parameters should be resolved from env via `envFrom`/`requiredEnvFrom`
  */
-declare function modelFromRun(context: MatrixModelContext, options: ModelFromMatrixOptions): ModelDefinition;
+declare function ChatProviders(options: ChatProvidersPluginOptions): Plugin;
 /**
  * Resolves a configured chat model from one eval-matrix axis.
  *
@@ -598,35 +599,34 @@ declare function modelFromRun(context: MatrixModelContext, options: ModelFromMat
  */
 declare function modelFromEval(context: MatrixModelContext, options: ModelFromMatrixOptions): ModelDefinition;
 /**
- * Creates a run-matrix `model` axis from configured chat model names.
+ * Resolves a configured chat model from one scoped matrix axis.
  *
  * Use when:
- * - run matrix should iterate over explicit chat model ids/aliases
- * - project configs want a concise model-axis helper
+ * - a matrix axis selects the agent, judge, or another chat model role
+ * - eval code should keep model lookup semantics inside the chat-models plugin
  *
  * Expects:
- * - each provided name to match a configured model id or alias at runtime
+ * - `scope` to identify `context.task.matrix.run` or `context.task.matrix.eval`
+ * - `options.axis` to exist and contain a model id, model name, or alias
  *
  * Returns:
- * - matrix axis object compatible with `runMatrix.extend/override`
+ * - the configured model matching the selected matrix value
  */
-declare function chatModelMatrix(...names: string[]): MatrixDefinition;
+declare function modelFromMatrix(context: MatrixModelContext, scope: MatrixModelScope, options: ModelFromMatrixOptions): ModelDefinition;
 /**
- * Built-in chat providers plugin that contributes provider presets to config.
+ * Resolves a configured chat model from one run-matrix axis.
  *
  * Use when:
- * - provider runtime config should be centralized and reusable
- * - provider parameters should be resolved from env via `envFrom`/`requiredEnvFrom`
- */
-declare function ChatProviders(options: ChatProvidersPluginOptions): Plugin;
-/**
- * Built-in chat models plugin that contributes model definitions to vieval config.
+ * - run matrix selects the model used by the system under evaluation
+ * - callers want the scoped helper instead of passing `scope: 'run'`
  *
- * Use when:
- * - chat-model registration should stay in config-level plugin setup
- * - tasks and assertions resolve models by name or alias at runtime
+ * Expects:
+ * - `options.axis` to exist in `context.task.matrix.run`
+ *
+ * Returns:
+ * - the configured model matching the selected run-matrix value
  */
-declare function ChatModels(options: ChatModelsPluginOptions): Plugin;
+declare function modelFromRun(context: MatrixModelContext, options: ModelFromMatrixOptions): ModelDefinition;
 //#endregion
 export { ChatModelDefinition, ChatModelExecutorInput, ChatModelExecutorLike, ChatModelFromBaseOptions, ChatModelFromOptions, ChatModelHeaders, ChatModelInferenceExecutor, ChatModelResolverContext, ChatModelResolverValue, ChatModelRuntimeConfig, ChatModelTelemetryProvider, ChatModelToolCall, ChatModels, ChatModelsPluginOptions, ChatProviderDefinition, ChatProviderFromOptions, ChatProviders, ChatProvidersPluginOptions, EmitChatModelErrorTelemetryOptions, EmitChatModelRequestTelemetryOptions, EmitChatModelResponseTelemetryOptions, GenericChatModelInferenceExecutor, MatrixModelScope, ModelFromMatrixOptions, OllamaChatModelInferenceExecutor, OllamaChatModelRuntimeConfig, OpenAIChatModelInferenceExecutor, OpenAIChatModelRuntimeConfig, OpenRouterChatModelInferenceExecutor, OpenRouterChatModelRuntimeConfig, OptionalProviderEnvMap, Plugin, PluginConfig, RequiredProviderEnvMap, chatModelFrom, chatModelMatrix, chatProviderFrom, emitChatModelErrorTelemetry, emitChatModelRequestTelemetry, emitChatModelResponseTelemetry, extractChatModelToolCalls, extractMeteringDimensions, modelFromEval, modelFromMatrix, modelFromRun, ollamaFromRunContext, openaiFromRunContext, openrouterFromRunContext, toChatModelRuntimeConfig };
 //# sourceMappingURL=index.d.mts.map