agentv 5.3.1-next.1 → 5.3.2-next.1

package/dist/contracts-DsZmZLl8.d.ts

@@ -0,0 +1,742 @@
+import { d, m, P, e } from './ts-eval-loader-kf6J7wSc.js';
+
+var __createBinding = (undefined && undefined.__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 __exportStar = (undefined && undefined.__exportStar) || function(m, exports$1) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports$1, p)) __createBinding(exports$1, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./errors.cjs"), exports);
+__exportStar(require("./helpers/parseUtil.cjs"), exports);
+__exportStar(require("./helpers/typeAliases.cjs"), exports);
+__exportStar(require("./helpers/util.cjs"), exports);
+__exportStar(require("./types.cjs"), exports);
+__exportStar(require("./ZodError.cjs"), exports);
+
+declare namespace z {
+  export {  };
+}
+
+type TargetRuntimeMode = 'host' | 'profile' | 'sandbox';
+interface TargetRuntimeConfig {
+    readonly mode: TargetRuntimeMode;
+    readonly [key: string]: unknown;
+}
+
+/**
+ * Strict normalized schema for CLI target configuration.
+ * This is the final validated shape after environment variable resolution
+ * and internal field normalization.
+ *
+ * Uses .strict() to reject unknown properties, ensuring configuration
+ * errors are caught early rather than silently ignored.
+ *
+ * @example
+ * ```typescript
+ * const config: CliNormalizedConfig = {
+ *   command: 'agent run {PROMPT}',
+ *   timeoutMs: 120000,
+ *   verbose: true,
+ * };
+ * CliTargetConfigSchema.parse(config); // Validates the normalized config
+ * ```
+ */
+declare const CliTargetConfigSchema: undefined<{
+    command: undefined;
+    filesFormat: undefined<undefined>;
+    cwd: undefined<undefined>;
+    timeoutMs: undefined<undefined>;
+    healthcheck: undefined<undefined<[undefined<{
+        url: undefined;
+        timeoutMs: undefined<undefined>;
+    }, "strict", undefined, {
+        url: string;
+        timeoutMs?: number | undefined;
+    }, {
+        url: string;
+        timeoutMs?: number | undefined;
+    }>, undefined<{
+        command: undefined;
+        cwd: undefined<undefined>;
+        timeoutMs: undefined<undefined>;
+    }, "strict", undefined, {
+        command: string;
+        cwd?: string | undefined;
+        timeoutMs?: number | undefined;
+    }, {
+        command: string;
+        cwd?: string | undefined;
+        timeoutMs?: number | undefined;
+    }>]>>;
+    verbose: undefined<undefined>;
+    keepTempFiles: undefined<undefined>;
+}, "strict", undefined, {
+    command: string;
+    cwd?: string | undefined;
+    timeoutMs?: number | undefined;
+    healthcheck?: {
+        url: string;
+        timeoutMs?: number | undefined;
+    } | {
+        command: string;
+        cwd?: string | undefined;
+        timeoutMs?: number | undefined;
+    } | undefined;
+    verbose?: boolean | undefined;
+    filesFormat?: string | undefined;
+    keepTempFiles?: boolean | undefined;
+}, {
+    command: string;
+    cwd?: string | undefined;
+    timeoutMs?: number | undefined;
+    healthcheck?: {
+        url: string;
+        timeoutMs?: number | undefined;
+    } | {
+        command: string;
+        cwd?: string | undefined;
+        timeoutMs?: number | undefined;
+    } | undefined;
+    verbose?: boolean | undefined;
+    filesFormat?: string | undefined;
+    keepTempFiles?: boolean | undefined;
+}>;
+type CliNormalizedConfig = undefined<typeof CliTargetConfigSchema>;
+/**
+ * Resolved CLI configuration type derived from CliTargetConfigSchema.
+ * This is the final validated shape used by the CLI provider at runtime.
+ * Using Readonly to ensure immutability for runtime safety.
+ */
+type CliResolvedConfig = Readonly<CliNormalizedConfig>;
+interface RetryConfig {
+    readonly maxRetries?: number;
+    readonly initialDelayMs?: number;
+    readonly maxDelayMs?: number;
+    readonly backoffFactor?: number;
+    readonly retryableStatusCodes?: readonly number[];
+}
+/**
+ * Selects which OpenAI-compatible API endpoint to use.
+ * - "chat" (default): POST /chat/completions — universally supported by all OpenAI-compatible providers.
+ * - "responses": POST /responses — only supported by api.openai.com.
+ *
+ * Maps to Vercel AI SDK methods: "chat" → provider.chat(model), "responses" → provider(model).
+ */
+type ApiFormat = 'chat' | 'responses';
+/**
+ * Azure OpenAI settings.
+ *
+ * Note: `api_format` was removed — AgentV always routes Azure targets through
+ * pi-ai's Responses API path. Chat-completions-only Azure deployments must
+ * use `provider: openai` with a deployment-scoped `base_url`.
+ */
+interface AzureResolvedConfig {
+    readonly resourceName: string;
+    readonly deploymentName: string;
+    readonly apiKey: string;
+    readonly version?: string;
+    readonly temperature?: number;
+    readonly maxOutputTokens?: number;
+    readonly retry?: RetryConfig;
+}
+/**
+ * OpenAI-compatible settings used by the Vercel AI SDK.
+ */
+interface OpenAIResolvedConfig {
+    readonly baseURL: string;
+    readonly apiKey: string;
+    readonly model: string;
+    readonly apiFormat?: ApiFormat;
+    readonly temperature?: number;
+    readonly maxOutputTokens?: number;
+    readonly retry?: RetryConfig;
+}
+/**
+ * OpenRouter settings used by the Vercel AI SDK provider.
+ */
+interface OpenRouterResolvedConfig {
+    readonly apiKey: string;
+    readonly model: string;
+    readonly temperature?: number;
+    readonly maxOutputTokens?: number;
+    readonly retry?: RetryConfig;
+}
+/**
+ * Anthropic Claude settings used by the Vercel AI SDK.
+ */
+interface AnthropicResolvedConfig {
+    readonly apiKey: string;
+    readonly model: string;
+    readonly temperature?: number;
+    readonly maxOutputTokens?: number;
+    readonly thinkingBudget?: number;
+    readonly retry?: RetryConfig;
+}
+/**
+ * Google Gemini settings used by the Vercel AI SDK.
+ */
+interface GeminiResolvedConfig {
+    readonly apiKey: string;
+    readonly model: string;
+    readonly temperature?: number;
+    readonly maxOutputTokens?: number;
+    readonly retry?: RetryConfig;
+}
+interface CodexResolvedConfig {
+    readonly model?: string;
+    readonly modelReasoningEffort?: CodexModelReasoningEffort;
+    readonly modelVerbosity?: CodexModelVerbosity;
+    readonly baseUrl?: string;
+    readonly apiKey?: string;
+    readonly apiFormat?: ApiFormat;
+    readonly sandboxMode?: CodexSandboxMode;
+    readonly approvalPolicy?: CodexApprovalPolicy;
+    readonly command?: readonly string[];
+    readonly runtime: CodingAgentRuntimeConfig;
+    readonly cwd?: string;
+    readonly timeoutMs?: number;
+    readonly logDir?: string;
+    /** New stream_log field. false=no stream log (default), 'raw'=per-event, 'summary'=consolidated. */
+    readonly streamLog?: false | 'raw' | 'summary';
+    readonly systemPrompt?: string;
+}
+type CodingAgentRuntimeMode = 'host' | 'profile' | 'sandbox';
+interface CodingAgentRuntimeConfig {
+    readonly mode: CodingAgentRuntimeMode;
+    readonly home?: string;
+    readonly codexHome?: string;
+    readonly tmpDir?: string;
+    readonly env?: Readonly<Record<string, string>>;
+    readonly envAllowlist?: readonly string[];
+}
+interface CopilotCliResolvedConfig {
+    readonly command: readonly string[];
+    readonly executable: string;
+    readonly model?: string;
+    readonly args?: readonly string[];
+    readonly cwd?: string;
+    readonly timeoutMs?: number;
+    readonly logDir?: string;
+    readonly logFormat?: 'summary' | 'json';
+    /** New stream_log field. false=no stream log (default), 'raw'=per-event, 'summary'=consolidated. */
+    readonly streamLog?: false | 'raw' | 'summary';
+    readonly systemPrompt?: string;
+    readonly customProvider?: CopilotCustomProviderConfig;
+}
+interface CopilotCustomProviderConfig {
+    readonly type?: string;
+    readonly baseUrl: string;
+    readonly apiKey?: string;
+    readonly bearerToken?: string;
+    readonly apiVersion?: string;
+    readonly wireApi?: string;
+    readonly modelId?: string;
+    readonly wireModel?: string;
+}
+interface CopilotSdkResolvedConfig {
+    readonly cliUrl?: string;
+    readonly cliPath?: string;
+    readonly args?: readonly string[];
+    readonly githubToken?: string;
+    readonly model?: string;
+    readonly cwd?: string;
+    readonly timeoutMs?: number;
+    readonly logDir?: string;
+    readonly logFormat?: 'summary' | 'json';
+    /** New stream_log field. false=no stream log (default), 'raw'=per-event, 'summary'=consolidated. */
+    readonly streamLog?: false | 'raw' | 'summary';
+    readonly systemPrompt?: string;
+    readonly customProvider?: CopilotCustomProviderConfig;
+}
+interface PiCodingAgentResolvedConfig {
+    readonly subprovider?: string;
+    readonly model?: string;
+    readonly apiKey?: string;
+    readonly baseUrl?: string;
+    readonly tools?: string;
+    readonly thinking?: string;
+    readonly cwd?: string;
+    readonly timeoutMs?: number;
+    readonly logDir?: string;
+    readonly logFormat?: 'summary' | 'json';
+    /** New stream_log field. false=no stream log (default), 'raw'=per-event, 'summary'=consolidated. */
+    readonly streamLog?: false | 'raw' | 'summary';
+    readonly systemPrompt?: string;
+}
+interface PiCliResolvedConfig {
+    readonly command: readonly string[];
+    readonly executable: string;
+    readonly subprovider?: string;
+    readonly model?: string;
+    readonly apiKey?: string;
+    readonly baseUrl?: string;
+    readonly tools?: string;
+    readonly thinking?: string;
+    readonly cwd?: string;
+    readonly timeoutMs?: number;
+    readonly logDir?: string;
+    readonly logFormat?: 'summary' | 'json';
+    /** New stream_log field. false=no stream log (default), 'raw'=per-event, 'summary'=consolidated. */
+    readonly streamLog?: false | 'raw' | 'summary';
+    readonly systemPrompt?: string;
+    readonly runtime: PiRuntimeResolvedConfig;
+}
+interface PiRpcResolvedConfig {
+    readonly command: readonly string[];
+    readonly subprovider?: string;
+    readonly model?: string;
+    readonly apiKey?: string;
+    readonly baseUrl?: string;
+    readonly tools?: string;
+    readonly thinking?: string;
+    readonly cwd?: string;
+    readonly timeoutMs?: number;
+    readonly logDir?: string;
+    readonly logFormat?: 'summary' | 'json';
+    readonly streamLog?: false | 'raw' | 'summary';
+    readonly systemPrompt?: string;
+    readonly runtime: PiRuntimeResolvedConfig;
+}
+interface PiRuntimeResolvedConfig {
+    readonly mode: 'host' | 'profile' | 'sandbox';
+    readonly home?: string;
+    readonly env?: Readonly<Record<string, string>>;
+    readonly [key: string]: unknown;
+}
+interface ClaudeResolvedConfig {
+    readonly command: readonly string[];
+    readonly executable: string;
+    readonly model?: string;
+    readonly systemPrompt?: string;
+    readonly cwd?: string;
+    readonly timeoutMs?: number;
+    readonly maxTurns?: number;
+    readonly maxBudgetUsd?: number;
+    readonly logDir?: string;
+    readonly logFormat?: 'summary' | 'json';
+    /** New stream_log field. false=no stream log (default), 'raw'=per-event, 'summary'=consolidated. */
+    readonly streamLog?: false | 'raw' | 'summary';
+    /** When true (default), passes --dangerously-skip-permissions to the Claude CLI. Matches ClaudeSdkProvider behavior. */
+    readonly bypassPermissions?: boolean;
+}
+interface MockResolvedConfig {
+    readonly response?: string;
+    readonly delayMs?: number;
+    readonly delayMinMs?: number;
+    readonly delayMaxMs?: number;
+}
+interface VSCodeResolvedConfig {
+    readonly executable: string;
+    readonly waitForResponse: boolean;
+    readonly dryRun: boolean;
+    readonly subagentRoot?: string;
+    readonly timeoutMs?: number;
+}
+interface AgentVResolvedConfig {
+    readonly model: string;
+    readonly temperature: number;
+}
+interface ReplayResolvedConfig {
+    readonly source?: ReplayResolvedSource;
+    readonly fixturesPath?: string;
+    readonly transcriptsPath?: string;
+    readonly sourceTarget: string;
+    readonly suite?: string;
+    readonly evalPath?: string;
+    readonly variant?: string;
+}
+type ReplayResolvedSource = {
+    readonly kind: 'fixtures';
+    readonly path: string;
+} | {
+    readonly kind: 'execution_traces';
+    readonly path: string;
+} | {
+    readonly kind: 'transcripts';
+    readonly path: string;
+};
+type CodexModelReasoningEffort = 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
+type CodexModelVerbosity = 'low' | 'medium' | 'high';
+type CodexSandboxMode = 'read-only' | 'workspace-write' | 'danger-full-access';
+type CodexApprovalPolicy = 'never' | 'on-request' | 'on-failure' | 'untrusted';
+declare function resolveProviderDefinitionEnvironments(definitions: readonly P[], baseDir: string, options?: {
+    readonly location?: string;
+}): Promise<readonly P[]>;
+/** Base fields shared by all resolved provider backends. */
+interface ResolvedProviderBackendBase {
+    readonly name: string;
+    readonly label?: string;
+    readonly runtime?: TargetRuntimeConfig;
+    readonly environment?: d;
+    readonly graderTarget?: string;
+    readonly workers?: number;
+    /**
+     * Whether this target can be executed via executor subagents in subagent mode.
+     * Defaults to `true` for all non-CLI providers. Set `false` in targets.yaml
+     * to force CLI invocation even in subagent mode.
+     */
+    readonly subagentModeAllowed?: boolean;
+    /**
+     * Ordered list of target names to try when the primary target fails after
+     * exhausting retries. Each fallback is attempted in order.
+     */
+    readonly fallbackTargets?: readonly string[];
+}
+type ResolvedProviderBackend = (ResolvedProviderBackendBase & {
+    readonly kind: 'openai';
+    readonly config: OpenAIResolvedConfig;
+}) | (ResolvedProviderBackendBase & {
+    readonly kind: 'openrouter';
+    readonly config: OpenRouterResolvedConfig;
+}) | (ResolvedProviderBackendBase & {
+    readonly kind: 'azure';
+    readonly config: AzureResolvedConfig;
+}) | (ResolvedProviderBackendBase & {
+    readonly kind: 'anthropic';
+    readonly config: AnthropicResolvedConfig;
+}) | (ResolvedProviderBackendBase & {
+    readonly kind: 'gemini';
+    readonly config: GeminiResolvedConfig;
+}) | (ResolvedProviderBackendBase & {
+    readonly kind: 'codex-cli' | 'codex-app-server' | 'codex-sdk';
+    readonly config: CodexResolvedConfig;
+}) | (ResolvedProviderBackendBase & {
+    readonly kind: 'copilot-sdk';
+    readonly config: CopilotSdkResolvedConfig;
+}) | (ResolvedProviderBackendBase & {
+    readonly kind: 'copilot-cli';
+    readonly config: CopilotCliResolvedConfig;
+}) | (ResolvedProviderBackendBase & {
+    readonly kind: 'pi-sdk' | 'pi-coding-agent';
+    readonly config: PiCodingAgentResolvedConfig;
+}) | (ResolvedProviderBackendBase & {
+    readonly kind: 'pi-cli';
+    readonly config: PiCliResolvedConfig;
+}) | (ResolvedProviderBackendBase & {
+    readonly kind: 'pi-rpc';
+    readonly config: PiRpcResolvedConfig;
+}) | (ResolvedProviderBackendBase & {
+    readonly kind: 'claude-cli';
+    readonly config: ClaudeResolvedConfig;
+}) | (ResolvedProviderBackendBase & {
+    readonly kind: 'claude-sdk';
+    readonly config: ClaudeResolvedConfig;
+}) | (ResolvedProviderBackendBase & {
+    readonly kind: 'mock';
+    readonly config: MockResolvedConfig;
+}) | (ResolvedProviderBackendBase & {
+    readonly kind: 'vscode' | 'vscode-insiders';
+    readonly config: VSCodeResolvedConfig;
+}) | (ResolvedProviderBackendBase & {
+    readonly kind: 'agentv';
+    readonly config: AgentVResolvedConfig;
+}) | (ResolvedProviderBackendBase & {
+    readonly kind: 'cli';
+    readonly config: CliResolvedConfig;
+}) | (ResolvedProviderBackendBase & {
+    readonly kind: 'transcript';
+    readonly config: Record<string, never>;
+}) | (ResolvedProviderBackendBase & {
+    readonly kind: 'replay';
+    readonly config: ReplayResolvedConfig;
+});
+declare function resolveDelegatedProviderDefinition(name: string, definitions: ReadonlyMap<string, P>, env?: e): P | undefined;
+declare function resolveProviderDefinition(definition: P, env?: e, evalFilePath?: string, options?: {
+    readonly emitDeprecationWarnings?: boolean;
+}): ResolvedProviderBackend;
+
+/**
+ * Extensible provider registry.
+ *
+ * Replaces the hardcoded switch/case dispatch in createProvider() with
+ * a registry of named factory functions. Built-in providers are registered
+ * at startup; users can add custom providers via the registry API or by
+ * dropping files in `.agentv/providers/`.
+ */
+
+/**
+ * Factory function that creates a Provider instance from a resolved target.
+ */
+type ProviderFactoryFn = (target: ResolvedProviderBackend) => m;
+/**
+ * Registry of provider factory functions keyed by provider kind.
+ *
+ * Built-in providers are registered at startup. Custom providers can be
+ * registered via the `register()` method.
+ */
+declare class ProviderRegistry {
+    private readonly factories;
+    /** Register a factory function for a provider kind. */
+    register(kind: string, factory: ProviderFactoryFn): this;
+    /** Get the factory function for a provider kind. */
+    get(kind: string): ProviderFactoryFn | undefined;
+    /** Check if a factory is registered for the given kind. */
+    has(kind: string): boolean;
+    /** List all registered provider kind names. */
+    list(): string[];
+    /**
+     * Create a provider instance from a resolved target.
+     * Falls back to CLI provider for unknown kinds (custom provider escape hatch).
+     */
+    create(target: ResolvedProviderBackend): m;
+}
+
+/**
+ * Create and return the default provider registry with all built-in providers.
+ */
+declare function createBuiltinProviderRegistry(): ProviderRegistry;
+/**
+ * Create a provider from a resolved target using the default registry.
+ * Custom providers can be registered via `createBuiltinProviderRegistry().register()`.
+ */
+declare function createProvider(target: ResolvedProviderBackend): m;
+declare function resolveAndCreateProvider(definition: P, env?: e): m;
+
+/**
+ * Typed configuration file support for AgentV.
+ *
+ * Provides `defineConfig()` for use in `agentv.config.ts` files. Supports
+ * auto-discovery, Zod validation, and IDE autocomplete.
+ *
+ * @example
+ * ```typescript
+ * // agentv.config.ts
+ * import { defineConfig } from 'agentv';
+ *
+ * export default defineConfig({
+ *   execution: {
+ *     maxConcurrency: 5,
+ *     maxRetries: 2,
+ *     agentTimeoutMs: 120_000,
+ *   },
+ *   output: {
+ *     dir: './results',
+ *   },
+ * });
+ * ```
+ *
+ * @module
+ */
+
+/**
+ * Schema for AgentV project-level configuration.
+ */
+declare const AgentVConfigSchema: undefined<{
+    /** Default execution settings */
+    execution: undefined<undefined<undefined<undefined<{
+        /** General eval parallelism (default: 3) */
+        maxConcurrency: undefined<undefined>;
+        /** Maximum retries on failure (default: 2) */
+        maxRetries: undefined<undefined>;
+        /** Agent timeout in milliseconds. No timeout if not set. */
+        agentTimeoutMs: undefined<undefined>;
+        /** Enable verbose logging */
+        verbose: undefined<undefined>;
+        /** Always keep temp workspaces after eval */
+        keepWorkspaces: undefined<undefined>;
+    }, "passthrough", undefined, undefined<{
+        /** General eval parallelism (default: 3) */
+        maxConcurrency: undefined<undefined>;
+        /** Maximum retries on failure (default: 2) */
+        maxRetries: undefined<undefined>;
+        /** Agent timeout in milliseconds. No timeout if not set. */
+        agentTimeoutMs: undefined<undefined>;
+        /** Enable verbose logging */
+        verbose: undefined<undefined>;
+        /** Always keep temp workspaces after eval */
+        keepWorkspaces: undefined<undefined>;
+    }, undefined, "passthrough">, undefined<{
+        /** General eval parallelism (default: 3) */
+        maxConcurrency: undefined<undefined>;
+        /** Maximum retries on failure (default: 2) */
+        maxRetries: undefined<undefined>;
+        /** Agent timeout in milliseconds. No timeout if not set. */
+        agentTimeoutMs: undefined<undefined>;
+        /** Enable verbose logging */
+        verbose: undefined<undefined>;
+        /** Always keep temp workspaces after eval */
+        keepWorkspaces: undefined<undefined>;
+    }, undefined, "passthrough">>, undefined<{
+        /** General eval parallelism (default: 3) */
+        maxConcurrency: undefined<undefined>;
+        /** Maximum retries on failure (default: 2) */
+        maxRetries: undefined<undefined>;
+        /** Agent timeout in milliseconds. No timeout if not set. */
+        agentTimeoutMs: undefined<undefined>;
+        /** Enable verbose logging */
+        verbose: undefined<undefined>;
+        /** Always keep temp workspaces after eval */
+        keepWorkspaces: undefined<undefined>;
+    }, undefined, "passthrough">, undefined<{
+        /** General eval parallelism (default: 3) */
+        maxConcurrency: undefined<undefined>;
+        /** Maximum retries on failure (default: 2) */
+        maxRetries: undefined<undefined>;
+        /** Agent timeout in milliseconds. No timeout if not set. */
+        agentTimeoutMs: undefined<undefined>;
+        /** Enable verbose logging */
+        verbose: undefined<undefined>;
+        /** Always keep temp workspaces after eval */
+        keepWorkspaces: undefined<undefined>;
+    }, undefined, "passthrough">>, {
+        keepWorkspaces?: boolean | undefined;
+        verbose?: boolean | undefined;
+        agentTimeoutMs?: number | undefined;
+        maxRetries?: number | undefined;
+        maxConcurrency?: number | undefined;
+    }, undefined<{
+        /** General eval parallelism (default: 3) */
+        maxConcurrency: undefined<undefined>;
+        /** Maximum retries on failure (default: 2) */
+        maxRetries: undefined<undefined>;
+        /** Agent timeout in milliseconds. No timeout if not set. */
+        agentTimeoutMs: undefined<undefined>;
+        /** Enable verbose logging */
+        verbose: undefined<undefined>;
+        /** Always keep temp workspaces after eval */
+        keepWorkspaces: undefined<undefined>;
+    }, undefined, "passthrough">>>;
+    /** Output settings */
+    output: undefined<undefined<{
+        /** Default eval run artifact directory */
+        dir: undefined<undefined>;
+    }, "strict", undefined, {
+        dir?: string | undefined;
+    }, {
+        dir?: string | undefined;
+    }>>;
+    /** Response caching */
+    cache: undefined<undefined<{
+        /** Enable response caching */
+        enabled: undefined<undefined>;
+        /** Response cache directory */
+        path: undefined<undefined>;
+    }, "strip", undefined, {
+        path?: string | undefined;
+        enabled?: boolean | undefined;
+    }, {
+        path?: string | undefined;
+        enabled?: boolean | undefined;
+    }>>;
+    /** Cost and duration limits */
+    limits: undefined<undefined<{
+        /** Maximum cost per run in USD */
+        maxCostUsd: undefined<undefined>;
+        /** Maximum duration per run in milliseconds */
+        maxDurationMs: undefined<undefined>;
+    }, "strip", undefined, {
+        maxDurationMs?: number | undefined;
+        maxCostUsd?: number | undefined;
+    }, {
+        maxDurationMs?: number | undefined;
+        maxCostUsd?: number | undefined;
+    }>>;
+    /** Lifecycle hooks */
+    hooks: undefined<undefined<{
+        /**
+         * Shell command to run once at agentv startup, before any command executes.
+         * stdout is parsed for env var exports (`KEY=value` or `export KEY="value"`)
+         * and injected into process.env. Keys already set in the environment are
+         * not overwritten — existing env always takes priority.
+         * stderr is forwarded to the user. Non-zero exit aborts with an error.
+         */
+        beforeSession: undefined<undefined>;
+    }, "strip", undefined, {
+        beforeSession?: string | undefined;
+    }, {
+        beforeSession?: string | undefined;
+    }>>;
+    /** Project-local reusable references for fields that support ref://name */
+    refs: undefined<undefined<undefined, undefined>>;
+}, "strip", undefined, {
+    output?: {
+        dir?: string | undefined;
+    } | undefined;
+    execution?: {
+        keepWorkspaces?: boolean | undefined;
+        verbose?: boolean | undefined;
+        agentTimeoutMs?: number | undefined;
+        maxRetries?: number | undefined;
+        maxConcurrency?: number | undefined;
+    } | undefined;
+    hooks?: {
+        beforeSession?: string | undefined;
+    } | undefined;
+    refs?: Record<string, string> | undefined;
+    cache?: {
+        path?: string | undefined;
+        enabled?: boolean | undefined;
+    } | undefined;
+    limits?: {
+        maxDurationMs?: number | undefined;
+        maxCostUsd?: number | undefined;
+    } | undefined;
+}, {
+    output?: {
+        dir?: string | undefined;
+    } | undefined;
+    execution?: undefined<{
+        /** General eval parallelism (default: 3) */
+        maxConcurrency: undefined<undefined>;
+        /** Maximum retries on failure (default: 2) */
+        maxRetries: undefined<undefined>;
+        /** Agent timeout in milliseconds. No timeout if not set. */
+        agentTimeoutMs: undefined<undefined>;
+        /** Enable verbose logging */
+        verbose: undefined<undefined>;
+        /** Always keep temp workspaces after eval */
+        keepWorkspaces: undefined<undefined>;
+    }, undefined, "passthrough"> | undefined;
+    hooks?: {
+        beforeSession?: string | undefined;
+    } | undefined;
+    refs?: Record<string, string> | undefined;
+    cache?: {
+        path?: string | undefined;
+        enabled?: boolean | undefined;
+    } | undefined;
+    limits?: {
+        maxDurationMs?: number | undefined;
+        maxCostUsd?: number | undefined;
+    } | undefined;
+}>;
+/**
+ * AgentV project-level configuration type.
+ * Inferred from the Zod schema for full type safety.
+ */
+type AgentVConfig = undefined<typeof AgentVConfigSchema>;
+/**
+ * Define a typed AgentV configuration.
+ *
+ * Use this in `agentv.config.ts` at your project root. The configuration
+ * is validated at load time and provides full IDE autocomplete.
+ *
+ * @param config - Configuration object
+ * @returns Validated configuration
+ *
+ * @example
+ * ```typescript
+ * import { defineConfig } from 'agentv';
+ *
+ * export default defineConfig({
+ *   execution: { maxConcurrency: 5 },
+ *   output: { dir: './results' },
+ *   limits: { maxCostUsd: 10.0 },
+ * });
+ * ```
+ */
+declare function defineConfig(config: AgentVConfig): AgentVConfig;
+type TraceSummaryWire = Record<string, unknown>;
+type TraceWire = Record<string, unknown>;
+type EvaluationResultWire = Record<string, unknown>;
+
+export { type AgentVConfig as A, type EvaluationResultWire as E, type ProviderFactoryFn as P, type ResolvedProviderBackend as R, type TraceSummaryWire as T, createProvider as a, resolveDelegatedProviderDefinition as b, createBuiltinProviderRegistry as c, defineConfig as d, resolveProviderDefinition as e, resolveProviderDefinitionEnvironments as f, type TraceWire as g, resolveAndCreateProvider as r, z };