/**
 * PluginActionFactory：创建带 metadata 和 schema 的 plugin/action。
 *
 * 关键点（中文）
 * - `create_action` 让 action 的运行时 schema 与 TypeScript 输入类型保持一致。
 * - `create_plugin` 只做轻量对象装配，不强制继承 BasePlugin。
 * - 旧的 class extends BasePlugin 写法仍可继续使用。
 */
import type { z } from "zod";
import type { PluginContext } from "../../types/plugin/PluginContext.js";
import type { JsonValue } from "../../types/common/Json.js";
import type { PluginAction, PluginActionApi, PluginActionCommand, PluginActionExample, PluginActionInputSchema, PluginActionResult, PluginActions } from "../../types/plugin/PluginAction.js";
import type { Plugin } from "../../types/plugin/PluginDefinition.js";
import type { PluginAvailability, PluginHooks, PluginResolves } from "../../types/plugin/PluginRuntime.js";
import type { PluginLifecycle } from "../../types/plugin/PluginCommand.js";
import type { PluginHttpDefinition } from "../../types/plugin/PluginHttp.js";
import type { PluginExecutionContext } from "../../types/plugin/PluginExecutionContext.js";
/**
 * 从 Zod schema 推导 JSON 输入类型。
 */
type InferZodJson<TSchema extends z.ZodTypeAny> = z.infer<TSchema> extends JsonValue ? z.infer<TSchema> : JsonValue;
/**
 * create_action 参数。
 */
export interface CreatePluginActionOptions<P extends JsonValue, R extends JsonValue> {
    /** Action 用途说明。 */
    description?: string;
    /** Zod 输入 schema。 */
    input_schema?: z.ZodTypeAny | PluginActionInputSchema<P>;
    /** Action 调用示例。 */
    examples?: PluginActionExample<P>[];
    /** CLI 定义。 */
    command?: PluginActionCommand<P>;
    /** HTTP 定义。 */
    api?: PluginActionApi<P>;
    /** Action 执行器。 */
    execute: (params: {
        /** 当前执行上下文。 */
        context: PluginContext;
        /** 当前 action 所属 Session Turn 的只读执行快照。 */
        execution_context?: PluginExecutionContext;
        /** 已通过 schema 校验后的输入。 */
        input: P;
        /** 当前插件名称。 */
        plugin_name: string;
        /** 当前 Action 名称。 */
        action_name: string;
    }) => Promise<PluginActionResult<R>> | PluginActionResult<R>;
}
/**
 * create_plugin 参数。
 */
export interface CreatePluginOptions<TActions extends PluginActions> {
    /** Plugin 稳定名称。 */
    name: string;
    /** Plugin 展示标题。 */
    title?: string;
    /** Plugin 用途说明。 */
    description?: string;
    /** Plugin 显式 action 集合。 */
    actions?: TActions;
    /** Plugin hook 集合。 */
    hooks?: PluginHooks;
    /** Plugin resolve 集合。 */
    resolves?: PluginResolves;
    /** Plugin system 文本构建器。 */
    system?: (context: PluginContext, execution_context?: PluginExecutionContext) => string | Promise<string>;
    /** Plugin 生命周期定义。 */
    lifecycle?: PluginLifecycle;
    /** Plugin 可用性检查。 */
    availability?: (context: PluginContext) => Promise<PluginAvailability> | PluginAvailability;
    /** Plugin HTTP 注入定义。 */
    http?: PluginHttpDefinition;
}
/**
 * 创建带 metadata 的 action。
 */
export declare function create_action<TSchema extends z.ZodTypeAny, R extends JsonValue = JsonValue>(options: CreatePluginActionOptions<InferZodJson<TSchema>, R> & {
    /** Zod 输入 schema。 */
    input_schema?: TSchema | PluginActionInputSchema<InferZodJson<TSchema>>;
}): PluginAction<InferZodJson<TSchema>, R>;
export declare function create_action<R extends JsonValue = JsonValue>(options: CreatePluginActionOptions<JsonValue, R>): PluginAction<JsonValue, R>;
/**
 * 创建 plugin 对象。
 */
export declare function create_plugin<TActions extends PluginActions>(options: CreatePluginOptions<TActions>): Plugin & {
    actions: TActions;
};
export {};
//# sourceMappingURL=PluginActionFactory.d.ts.map