import type { AgentTool, ToolEffects } from "@apholdings/jensen-agent-core";
/**
 * Production tool-effect registry and validation.
 *
 * Every built-in tool must declare its effects on the tool object (the
 * `effects` field). This module centralizes the canonical expectations and
 * provides a validation used both by diagnostics and by tests that fail when a
 * new production tool is added without effect metadata.
 */
export declare class UndeclaredEffectsError extends Error {
    readonly toolName: string;
    constructor(toolName: string);
}
/** Tools that a policy engine must always treat conservatively if effects are unknown. */
export declare const REQUIRES_EFFECTS = true;
/**
 * Validate that every tool in the list declares effects. Returns the list of
 * undeclared tool names, or throws when `strict` is set.
 */
export declare function validateToolEffects<T extends AgentTool>(tools: T[], strict?: boolean): string[];
/** Canonical effect metadata for each built-in production tool. */
export declare const PRODUCTION_TOOL_EFFECTS: Record<string, ToolEffects>;
//# sourceMappingURL=effects.d.ts.map