/**
 * Shared agent override merge semantics.
 *
 * Defines the contract for the `agentOverrides.<agent-id>` escape hatch using
 * RFC 7396 JSON Merge Patch semantics.
 *
 * @experimental This API is unstable and may change without notice.
 */
import * as Effect from "effect/Effect";
/**
 * Per-agent override patch.
 *
 * @experimental This API is unstable and may change without notice.
 */
export type AgentOverrides = Readonly<Record<string, unknown>>;
/**
 * Override map keyed by agent id.
 *
 * @experimental This API is unstable and may change without notice.
 */
export type AllAgentOverrides = Readonly<Record<string, AgentOverrides>>;
/**
 * Merge agent-specific overrides on top of a computed field record.
 *
 * Implements RFC 7396 JSON Merge Patch semantics:
 *
 * - objects merge recursively
 * - `null` deletes a key at any depth
 * - arrays replace wholesale
 * - primitives replace
 * - type mismatches replace
 *
 * Returns a new object; does not mutate `fields`.
 *
 * @experimental This API is unstable and may change without notice.
 */
export declare const applyOverrides: (fields: Readonly<Record<string, unknown>>, overrides: AgentOverrides | undefined) => Record<string, unknown>;
/**
 * Log a warning for each `agentOverrides.<agent-id>` entry whose agent is not
 * configured for the current workspace.
 *
 * @experimental This API is unstable and may change without notice.
 */
export declare const warnOnOrphanOverrides: (subjectName: string, overrides: AllAgentOverrides | undefined, configuredAgentIds: ReadonlyArray<string>) => Effect.Effect<void>;
//# sourceMappingURL=agent-overrides.d.ts.map