import type { AgentUiContext } from "@inupedia/spotlight-protocol";
import { type AgentTool, type ToolContextHint } from "./agentRegistry.js";
export type ToolFieldSchema = {
    type: "string" | "number" | "boolean";
    enum?: readonly (string | number | boolean)[];
    optional?: boolean;
    description?: string;
};
export type HostEffectConfig<TInput = unknown> = {
    type: string;
    target?: string | ((input: TInput) => string | undefined);
    payload?: Record<string, unknown> | ((input: TInput) => Record<string, unknown>);
};
/**
 * Declarative tool registration for consumer `service` modules.
 * Spotlight only executes; domain context / availability are supplied by the app.
 */
export type AgentToolDef<TInput = Record<string, unknown>> = {
    name: string;
    displayName?: string;
    description: string;
    input?: Record<string, ToolFieldSchema>;
    invoke: (input: TInput) => Promise<unknown>;
    host?: HostEffectConfig<TInput>;
    contextHint?: ToolContextHint;
    isAvailable?: (ctx: AgentUiContext) => boolean;
    requires?: string[];
    exposeToLoop?: boolean;
    executionMode?: "serial" | "parallel-safe";
    recovery?: AgentTool<TInput, unknown>["recovery"];
    summarizeResult?: AgentTool<TInput, unknown>["summarizeResult"];
    runtimeOnly?: boolean;
    executionTarget?: "host" | "runtime";
};
export declare function hostEffect<TInput = unknown>(config: HostEffectConfig<TInput>): Pick<AgentTool<TInput, unknown>, "executionTarget" | "buildHostEffect">;
export declare function defineAgentTool<TInput extends Record<string, unknown> = Record<string, unknown>>(def: AgentToolDef<TInput>): void;
//# sourceMappingURL=defineAgentTool.d.ts.map