NDLRMAF003: [AgentHandoffsTo] source class is not a declared agent¶

Q: What causes NDLRMAF003?

A class bearing [AgentHandoffsTo] is not itself decorated with [NeedlrAiAgent].

Q: How do I fix NDLRMAF003?

Add [NeedlrAiAgent] to the class that declares [AgentHandoffsTo].

Cause¶

A class bearing [AgentHandoffsTo] is not itself decorated with [NeedlrAiAgent].

Rule Description¶

A handoff relationship is only meaningful when the source of the handoff is itself a Needlr agent. If the class owning [AgentHandoffsTo] is not registered with [NeedlrAiAgent], it will not appear in the generated agent registry, and the handoff declaration has no effect at runtime.

How to Fix¶

Add [NeedlrAiAgent] to the class that declares [AgentHandoffsTo].

Before¶

[AgentHandoffsTo(typeof(SummaryAgent), When = "Summarization needed")]
public class TriageAgent { }   // ← missing [NeedlrAiAgent]

[NeedlrAiAgent(Instructions = "You summarize content.")]
public class SummaryAgent { }

After¶

[NeedlrAiAgent(Instructions = "Route the request.")]
[AgentHandoffsTo(typeof(SummaryAgent), When = "Summarization needed")]
public class TriageAgent { }   // ← registered

[NeedlrAiAgent(Instructions = "You summarize content.")]
public class SummaryAgent { }

When to Suppress¶

Only suppress if the class is a temporary scaffold during development.

#pragma warning disable NDLRMAF003
[AgentHandoffsTo(typeof(SummaryAgent))]
public class TriageAgent { }
#pragma warning restore NDLRMAF003