import { type AgentToolDef } from "./defineAgentTool.js";
/** Metadata for IoC-style `@agent({ name })` registration (invoke comes from the decorated function). */
export type AgentCapabilityMeta<TInput extends Record<string, unknown> = Record<string, unknown>> = Omit<AgentToolDef<TInput>, "invoke"> & {
    /**
     * Optional guard run before the handler (scene/tab navigation, etc.).
     * Replaces a separate `*Controller.ts` when the only extra work is prepare.
     */
    before?: () => void | Promise<void>;
};
declare const AGENT_CAPABILITY: unique symbol;
export type AgentCapabilityHandler<TInput extends Record<string, unknown> = Record<string, unknown>> = (input: TInput) => Promise<unknown>;
export type AgentCapabilityDecorator<TInput extends Record<string, unknown> = Record<string, unknown>> = AgentCapabilityHandler<TInput> & {
    [AGENT_CAPABILITY]?: AgentCapabilityMeta<TInput>;
};
export declare function getAgentCapabilityMeta<TInput extends Record<string, unknown>>(handler: AgentCapabilityHandler<TInput>): AgentCapabilityMeta<TInput> | undefined;
/** Register a handler against tool metadata (shared by decorator + manual wiring). */
export declare function registerAgentCapability<TInput extends Record<string, unknown>>(meta: AgentCapabilityMeta<TInput>, handler: AgentCapabilityHandler<TInput>): AgentCapabilityDecorator<TInput>;
/**
 * IoC-style agent capability registration.
 *
 * ```ts
 * @agent({ name: "demo.ping", description: "…" })
 * export async function demoPing() {
 *   return { ok: true };
 * }
 *
 * // or HOF (no decorator flag):
 * export const demoPing = agent({ name: "demo.ping", description: "…" })(async () => ({ ok: true }));
 * ```
 *
 * Requires `experimentalDecorators: true` in tsconfig for `@agent` syntax.
 */
export declare function agent<TInput extends Record<string, unknown> = Record<string, unknown>>(meta: AgentCapabilityMeta<TInput>): AgentCapabilityDecorator<TInput> & ((handler: AgentCapabilityHandler<TInput>) => AgentCapabilityDecorator<TInput>);
/** Alias for teams preferring `@Agent({ … })` naming. */
export declare const Agent: typeof agent;
/** Eager-load capability modules (Vite `import.meta.glob` side effects). */
export declare function loadAgentCapabilities(modules: Record<string, unknown>, options?: {
    exclude?: RegExp;
}): void;
/** Optional: register exported handlers tagged via HOF `agent(meta)(fn)` without decorators. */
export declare function registerExportedAgentCapabilities(moduleExports: Record<string, unknown>): void;
export {};
//# sourceMappingURL=agentCapability.d.ts.map