Skip to content
Agent Dev Lab Agent Dev Lab

SystemPromptConflictStrategy

SystemPromptConflictStrategy = "keep-pinned" | "use-current"

Defined in: packages/core/src/agent/types.ts:126

What to do when a different agent runs on a memoryScope whose pinned system prompt differs from this agent’s. Calling the same agent again on that scope is the normal conversation pattern and is never a conflict (including a hot-reloaded definition — the pin still wins).

  • "keep-pinned" (default): reuse the stored prompt.
  • "use-current": apply this agent’s prompt for this episode only. The stored pin is not rewritten.

A warning is emitted unless AgentRunInput.suppressSystemPromptConflictWarning is set. Prompts are not concatenated — the AI SDK system option is a single string, and stacking identities is usually worse than picking one.