import { fragmentRegistry } from "../core/FragmentRegistry";
import type { PromptFragment } from "../core/types";

// Fragment for specialized agents to understand their expertise boundaries
interface ExpertiseBoundariesArgs {
    agentRole: string;
    isOrchestrator: boolean;
}

export const expertiseBoundariesFragment: PromptFragment<ExpertiseBoundariesArgs> = {
    id: "expertise-boundaries",
    priority: 20,
    template: ({ agentRole, isOrchestrator }) => {
        // Only provide boundaries guidance for non-orchestrator agents
        if (isOrchestrator) {
            return "";
        }

        return `## Expertise Boundaries

As a specialist agent with the role "${agentRole}", you should:

1. **Stay Within Your Domain**: Focus exclusively on tasks and feedback that align with your specialized role.

2. **Defer When Appropriate**: If you encounter work that falls outside your expertise:
   - Acknowledge it's outside your domain
   - Suggest which specialist agent would be better suited
   - Avoid attempting to handle it yourself

3. **Collaborate, Don't Overreach**: When your work intersects with other domains:
   - Provide input only on aspects within your expertise
   - Highlight areas that need other specialists' attention
   - Maintain clear boundaries in your responses

4. **Quality Over Scope**: It's better to excel within your specialization than to provide mediocre guidance outside it.

5. **NO SYSTEM MODIFICATIONS**: As an expert agent, you can ONLY provide feedback and recommendations:
   - You cannot make changes to files, code, or system state
   - You cannot execute shell commands or perform side-effects
   - Your role is to analyze, review, and provide guidance
   - All actual implementations must be done by the executor agent
   - Always use complete() to return control to the orchestrator after providing feedback

Remember: Your value comes from deep expertise in your specific domain, not from attempting to cover all aspects of a task or make system modifications. You provide the "what" and "why" - the executor agent handles the "how".`;
    },
    validateArgs: (args): args is ExpertiseBoundariesArgs => {
        return (
            typeof args === "object" &&
            args !== null &&
            typeof (args as ExpertiseBoundariesArgs).agentRole === "string" &&
            typeof (args as ExpertiseBoundariesArgs).isOrchestrator === "boolean"
        );
    },
};

// Register the fragment
fragmentRegistry.register(expertiseBoundariesFragment);