refactor(install): prefer native plugin install across targets (#609)

Co-authored-by: John Cavanaugh <cavanaug@users.noreply.github.com>

src/utils/codex-content.ts

@@ -1,6 +1,7 @@
 export type CodexInvocationTargets = {
   promptTargets: Record<string, string>
   skillTargets: Record<string, string>
+  agentTargets?: Record<string, string>
 }
 
 export type CodexTransformOptions = {
@@ -27,20 +28,34 @@ export function transformContentForCodex(
   let result = body
   const promptTargets = targets?.promptTargets ?? {}
   const skillTargets = targets?.skillTargets ?? {}
+  const agentTargets = targets?.agentTargets ?? {}
   const unknownSlashBehavior = options.unknownSlashBehavior ?? "prompt"
 
   const taskPattern = /^(\s*-?\s*)Task\s+([a-z][a-z0-9:-]*)\(([^)]*)\)/gm
   result = result.replace(taskPattern, (_match, prefix: string, agentName: string, args: string) => {
+    const agentTarget = resolveAgentTarget(agentName, agentTargets)
+    const trimmedArgs = args.trim()
+    if (agentTarget) {
+      return trimmedArgs
+        ? `${prefix}Spawn the custom agent \`${agentTarget}\` with task: ${trimmedArgs}`
+        : `${prefix}Spawn the custom agent \`${agentTarget}\``
+    }
+
     // For namespaced calls like "compound-engineering:research:repo-research-analyst",
-    // use only the final segment as the skill name.
+    // use only the final segment as the skill name when no custom agent target exists.
     const finalSegment = agentName.includes(":") ? agentName.split(":").pop()! : agentName
     const skillName = normalizeCodexName(finalSegment)
-    const trimmedArgs = args.trim()
     return trimmedArgs
       ? `${prefix}Use the $${skillName} skill to: ${trimmedArgs}`
       : `${prefix}Use the $${skillName} skill`
   })
 
+  const backtickedAgentPattern = /`([a-z][a-z0-9-]*(?::[a-z][a-z0-9-]*){1,2})`/gi
+  result = result.replace(backtickedAgentPattern, (match, agentName: string) => {
+    const agentTarget = resolveAgentTarget(agentName, agentTargets)
+    return agentTarget ? `custom agent \`${agentTarget}\`` : match
+  })
+
   const slashCommandPattern = /(?<![:\w>}\]\)])\/([a-z][a-z0-9_:-]*?)(?=[\s,."')\]}`]|$)/gi
   result = result.replace(slashCommandPattern, (match, commandName: string) => {
     if (commandName.includes("/")) return match
@@ -65,6 +80,8 @@ export function transformContentForCodex(
 
   const agentRefPattern = /@([a-z][a-z0-9-]*-(?:agent|reviewer|researcher|analyst|specialist|oracle|sentinel|guardian|strategist))/gi
   result = result.replace(agentRefPattern, (_match, agentName: string) => {
+    const agentTarget = resolveAgentTarget(agentName, agentTargets)
+    if (agentTarget) return `custom agent \`${agentTarget}\``
     const skillName = normalizeCodexName(agentName)
     return `$${skillName} skill`
   })
@@ -72,6 +89,21 @@ export function transformContentForCodex(
   return result
 }
 
+function resolveAgentTarget(value: string, agentTargets: Record<string, string>): string | null {
+  const parts = value.split(":").filter(Boolean)
+  const candidates = [
+    normalizeCodexName(value),
+    parts.length >= 2 ? normalizeCodexName(parts.slice(-2).join(":")) : "",
+    parts.length >= 1 ? normalizeCodexName(parts[parts.length - 1]) : "",
+  ].filter(Boolean)
+
+  for (const candidate of candidates) {
+    const target = agentTargets[candidate]
+    if (target) return target
+  }
+  return null
+}
+
 export function normalizeCodexName(value: string): string {
   const trimmed = value.trim()
   if (!trimmed) return "item"