mcp-ai-agent-guidelines/dist/tools/prompt/prompt-hierarchy.d.ts

A comprehensive Model Context Protocol server providing advanced tools, resources, and prompts for implementing AI agent best practices

import { z } from "zod";
/**
 * Unified Prompt Hierarchy Tool
 *
 * Consolidates prompt hierarchy tools into a single interface with mode-based routing:
 * - 'build': Create structured hierarchical prompts (context → goal → requirements)
 * - 'select': (Deprecated) Alias for 'select-level', use 'select-level' instead
 * - 'select-level': Recommend optimal hierarchy level based on task and agent characteristics
 * - 'evaluate': Score and analyze existing prompts against hierarchy criteria
 * - 'chain': Build sequential prompt chains with dependencies
 * - 'flow': Build declarative prompt flows with branching and parallelism
 * - 'quick': Generate quick developer prompts from the Best of 25 bundle
 *
 * This tool provides a unified API for all prompt hierarchy operations while maintaining
 * backward compatibility with existing tool implementations.
 */
export declare const promptHierarchySchema: z.ZodObject<{
    mode: z.ZodEnum<["build", "select", "select-level", "evaluate", "chain", "flow", "quick"]>;
    context: z.ZodOptional<z.ZodString>;
    goal: z.ZodOptional<z.ZodString>;
    requirements: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
    outputFormat: z.ZodOptional<z.ZodString>;
    audience: z.ZodOptional<z.ZodString>;
    taskDescription: z.ZodOptional<z.ZodString>;
    agentCapability: z.ZodOptional<z.ZodEnum<["novice", "intermediate", "advanced", "expert"]>>;
    taskComplexity: z.ZodOptional<z.ZodEnum<["simple", "moderate", "complex", "very-complex"]>>;
    autonomyPreference: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
    promptText: z.ZodOptional<z.ZodString>;
    targetLevel: z.ZodOptional<z.ZodEnum<["independent", "indirect", "direct", "modeling", "scaffolding", "full-physical"]>>;
    chainName: z.ZodOptional<z.ZodString>;
    steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
        name: z.ZodString;
        description: z.ZodOptional<z.ZodString>;
        prompt: z.ZodString;
        outputKey: z.ZodOptional<z.ZodString>;
        dependencies: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
        errorHandling: z.ZodOptional<z.ZodEnum<["skip", "retry", "abort"]>>;
    }, "strip", z.ZodTypeAny, {
        name: string;
        prompt: string;
        description?: string | undefined;
        dependencies?: string[] | undefined;
        outputKey?: string | undefined;
        errorHandling?: "skip" | "retry" | "abort" | undefined;
    }, {
        name: string;
        prompt: string;
        description?: string | undefined;
        dependencies?: string[] | undefined;
        outputKey?: string | undefined;
        errorHandling?: "skip" | "retry" | "abort" | undefined;
    }>, "many">>;
    executionStrategy: z.ZodOptional<z.ZodEnum<["sequential", "parallel-where-possible"]>>;
    flowName: z.ZodOptional<z.ZodString>;
    nodes: z.ZodOptional<z.ZodArray<z.ZodObject<{
        id: z.ZodString;
        type: z.ZodEnum<["prompt", "condition", "loop", "parallel", "merge", "transform"]>;
        name: z.ZodString;
        description: z.ZodOptional<z.ZodString>;
        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
    }, "strip", z.ZodTypeAny, {
        type: "prompt" | "condition" | "loop" | "parallel" | "merge" | "transform";
        name: string;
        id: string;
        description?: string | undefined;
        config?: Record<string, unknown> | undefined;
    }, {
        type: "prompt" | "condition" | "loop" | "parallel" | "merge" | "transform";
        name: string;
        id: string;
        description?: string | undefined;
        config?: Record<string, unknown> | undefined;
    }>, "many">>;
    edges: z.ZodOptional<z.ZodArray<z.ZodObject<{
        from: z.ZodString;
        to: z.ZodString;
        condition: z.ZodOptional<z.ZodString>;
    }, "strip", z.ZodTypeAny, {
        from: string;
        to: string;
        condition?: string | undefined;
    }, {
        from: string;
        to: string;
        condition?: string | undefined;
    }>, "many">>;
    entryPoint: z.ZodOptional<z.ZodString>;
    category: z.ZodOptional<z.ZodEnum<["all", "strategy-planning", "code-quality", "testing", "documentation", "devops"]>>;
    includeExamples: z.ZodOptional<z.ZodBoolean>;
    includeReferences: z.ZodOptional<z.ZodBoolean>;
    includeRecommendations: z.ZodOptional<z.ZodBoolean>;
    includeMetadata: z.ZodOptional<z.ZodBoolean>;
    includeFrontmatter: z.ZodOptional<z.ZodBoolean>;
    includeDisclaimer: z.ZodOptional<z.ZodBoolean>;
    includeVisualization: z.ZodOptional<z.ZodBoolean>;
    includeExecutionGuide: z.ZodOptional<z.ZodBoolean>;
}, "strip", z.ZodTypeAny, {
    mode: "select" | "flow" | "build" | "evaluate" | "select-level" | "chain" | "quick";
    context?: string | undefined;
    includeFrontmatter?: boolean | undefined;
    includeReferences?: boolean | undefined;
    includeMetadata?: boolean | undefined;
    goal?: string | undefined;
    requirements?: string[] | undefined;
    outputFormat?: string | undefined;
    audience?: string | undefined;
    includeDisclaimer?: boolean | undefined;
    chainName?: string | undefined;
    steps?: {
        name: string;
        prompt: string;
        description?: string | undefined;
        dependencies?: string[] | undefined;
        outputKey?: string | undefined;
        errorHandling?: "skip" | "retry" | "abort" | undefined;
    }[] | undefined;
    flowName?: string | undefined;
    nodes?: {
        type: "prompt" | "condition" | "loop" | "parallel" | "merge" | "transform";
        name: string;
        id: string;
        description?: string | undefined;
        config?: Record<string, unknown> | undefined;
    }[] | undefined;
    category?: "documentation" | "testing" | "all" | "code-quality" | "devops" | "strategy-planning" | undefined;
    includeExamples?: boolean | undefined;
    taskDescription?: string | undefined;
    promptText?: string | undefined;
    targetLevel?: "independent" | "scaffolding" | "modeling" | "indirect" | "direct" | "full-physical" | undefined;
    includeRecommendations?: boolean | undefined;
    agentCapability?: "advanced" | "novice" | "intermediate" | "expert" | undefined;
    taskComplexity?: "moderate" | "simple" | "complex" | "very-complex" | undefined;
    autonomyPreference?: "low" | "medium" | "high" | undefined;
    includeVisualization?: boolean | undefined;
    executionStrategy?: "sequential" | "parallel-where-possible" | undefined;
    edges?: {
        from: string;
        to: string;
        condition?: string | undefined;
    }[] | undefined;
    entryPoint?: string | undefined;
    includeExecutionGuide?: boolean | undefined;
}, {
    mode: "select" | "flow" | "build" | "evaluate" | "select-level" | "chain" | "quick";
    context?: string | undefined;
    includeFrontmatter?: boolean | undefined;
    includeReferences?: boolean | undefined;
    includeMetadata?: boolean | undefined;
    goal?: string | undefined;
    requirements?: string[] | undefined;
    outputFormat?: string | undefined;
    audience?: string | undefined;
    includeDisclaimer?: boolean | undefined;
    chainName?: string | undefined;
    steps?: {
        name: string;
        prompt: string;
        description?: string | undefined;
        dependencies?: string[] | undefined;
        outputKey?: string | undefined;
        errorHandling?: "skip" | "retry" | "abort" | undefined;
    }[] | undefined;
    flowName?: string | undefined;
    nodes?: {
        type: "prompt" | "condition" | "loop" | "parallel" | "merge" | "transform";
        name: string;
        id: string;
        description?: string | undefined;
        config?: Record<string, unknown> | undefined;
    }[] | undefined;
    category?: "documentation" | "testing" | "all" | "code-quality" | "devops" | "strategy-planning" | undefined;
    includeExamples?: boolean | undefined;
    taskDescription?: string | undefined;
    promptText?: string | undefined;
    targetLevel?: "independent" | "scaffolding" | "modeling" | "indirect" | "direct" | "full-physical" | undefined;
    includeRecommendations?: boolean | undefined;
    agentCapability?: "advanced" | "novice" | "intermediate" | "expert" | undefined;
    taskComplexity?: "moderate" | "simple" | "complex" | "very-complex" | undefined;
    autonomyPreference?: "low" | "medium" | "high" | undefined;
    includeVisualization?: boolean | undefined;
    executionStrategy?: "sequential" | "parallel-where-possible" | undefined;
    edges?: {
        from: string;
        to: string;
        condition?: string | undefined;
    }[] | undefined;
    entryPoint?: string | undefined;
    includeExecutionGuide?: boolean | undefined;
}>;
export type PromptHierarchyInput = z.infer<typeof promptHierarchySchema>;
/**
 * Unified prompt hierarchy tool handler
 * Routes to appropriate sub-tool based on mode parameter
 */
export declare function promptHierarchy(args: unknown): Promise<{
    mode: "select" | "flow" | "build" | "evaluate" | "select-level" | "chain" | "quick";
    prompt: string;
    metadata: {
        source: string;
    };
    content?: Array<{
        type: string;
        text: string;
    }>;
}>;
//# sourceMappingURL=prompt-hierarchy.d.ts.map