import { type Token } from '@frontmcp/di';
import { z } from '@frontmcp/lazy-zod';
import { type ScopeEntry } from '../entries';
import { type HttpMethod, type ServerRequest } from '../interfaces';
declare module '@frontmcp/sdk' {
    interface ExtendFlows {
    }
}
export type FlowName = keyof ExtendFlows;
export type CanActivateFlow = (request: ServerRequest, scope: ScopeEntry) => Promise<boolean>;
export interface FlowMiddlewareOptions {
    path?: RegExp | string;
    method?: HttpMethod;
    canActivate?: CanActivateFlow[];
}
export type FlowRunOptions<Ctx, Plan extends FlowPlan<string>, Input, Output extends z.ZodObject<any> | z.ZodUnion<any> | z.ZodDiscriminatedUnion<any, any>, State extends z.ZodObject<any>> = {
    ctx: Ctx;
    plan: Plan;
    input: Input;
    output: Output;
    state: State;
    stage: StagesFromPlan<Plan>;
    executeStage: ExecuteStagesFromPlan<Plan>;
};
/**
 * Declarative metadata describing what a FrontMcpFlow contributes at app scope.
 */
export interface FlowMetadata<Name extends FlowName> {
    name: Name;
    description?: string;
    plan: FlowPlan<ExtendFlows[Name]['stage']>;
    inputSchema: ExtendFlows[Name]['input'];
    outputSchema: ExtendFlows[Name]['output'];
    access: 'public' | 'authorized';
    dependsOn?: Token[];
    middleware?: FlowMiddlewareOptions;
}
export type StepInfo = string | {
    title?: string;
    description?: string;
};
export type FlowPhase = 'pre' | 'execute' | 'post' | 'finalize' | 'error';
type Values<T> = T[keyof T];
type ArrayElem<T> = T extends ReadonlyArray<infer U> ? U : never;
export type StagesFromPlan<P extends FlowPlan<string>> = ArrayElem<Values<Required<P>>>;
export type ExecuteStagesFromPlan<P extends FlowPlan<string>> = ArrayElem<Required<P['execute']>>;
export type FlowPlan<Base extends string> = {
    steps?: Record<Base, StepInfo>;
} & Partial<Record<FlowPhase, Base[]>>;
export declare const frontMcpFlowMetadataSchema: import("@frontmcp/lazy-zod").ZodObject<{
    name: import("@frontmcp/lazy-zod").ZodString;
    description: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
    access: import("@frontmcp/lazy-zod").ZodDefault<import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodEnum<{
        authorized: "authorized";
        public: "public";
    }>>>;
    inputSchema: import("zod").ZodCustom<Object, Object>;
    outputSchema: import("@frontmcp/lazy-zod").ZodOptional<import("zod").ZodCustom<Object, Object>>;
    plan: import("zod").ZodCustom<Object, Object>;
    dependsOn: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodUnknown>>;
    middleware: import("@frontmcp/lazy-zod").ZodOptional<import("zod").ZodCustom<Object, Object>>;
}, import("zod/v4/core").$loose>;
export {};
//# sourceMappingURL=flow.metadata.d.ts.map