fix(templates): register the local Agentex tracing processor so the developer UI traces tab shows spans

Every framework template registered only SGPTracingProcessorConfig, which
disables itself when SGP_API_KEY or SGP_ACCOUNT_ID is empty. Nothing else
creates a tracing processor, so spans derived by the unified harness were
never written to the backend /spans API and a scaffolded agent always showed
"No spans found for this task" in the developer UI, contradicting the README
("open the traces tab").

Register AgentexTracingProcessorConfig() ahead of the SGP block in all 16
framework templates (sync/default/temporal x openai-agents, pydantic-ai,
langgraph, claude-code, codex, plus the local-sandbox variant), fix a
sync-langgraph comment that claimed to register the Agentex processor, and
add a parametrized test asserting every framework template registers it.

Verified on a scaffolded sync Claude Code agent and a Temporal Claude Code
agent against a local backend: with the registration, message/turn spans
appear via POST /spans; without it, none do.

Claude-Session: https://claude.ai/code/session_01HCVKnA7LeJZ44nxZz1uzF3

Author: michaelxu2288

src/agentex/lib/cli/templates/default-claude-code/project/acp.py.j2

@@ -25,14 +25,17 @@ from agentex.lib.adk import ClaudeCodeTurn
 from agentex.lib.types.acp import SendEventParams, CancelTaskParams, CreateTaskParams
 from agentex.lib.core.harness import UnifiedEmitter
 from agentex.lib.types.fastacp import AsyncACPConfig
-from agentex.lib.types.tracing import SGPTracingProcessorConfig
+from agentex.lib.types.tracing import SGPTracingProcessorConfig, AgentexTracingProcessorConfig
 from agentex.lib.utils.logging import make_logger
 from agentex.types.text_content import TextContent
 from agentex.lib.sdk.fastacp.fastacp import FastACP
 from agentex.lib.core.tracing.tracing_processor_manager import add_tracing_processor_config
 
 logger = make_logger(__name__)
 
+# Local Agentex backend: spans appear in the developer UI's traces tab.
+add_tracing_processor_config(AgentexTracingProcessorConfig())
+
 add_tracing_processor_config(
     SGPTracingProcessorConfig(
         sgp_api_key=os.environ.get("SGP_API_KEY", ""),

src/agentex/lib/cli/templates/default-codex/project/acp.py.j2

@@ -35,14 +35,17 @@ from agentex.lib.types.acp import SendEventParams, CancelTaskParams, CreateTaskP
 from agentex.types.text_content import TextContent
 from agentex.lib.core.harness import UnifiedEmitter
 from agentex.lib.types.fastacp import AsyncACPConfig
-from agentex.lib.types.tracing import SGPTracingProcessorConfig
+from agentex.lib.types.tracing import SGPTracingProcessorConfig, AgentexTracingProcessorConfig
 from agentex.lib.utils.logging import make_logger
 from agentex.lib.utils.model_utils import BaseModel
 from agentex.lib.sdk.fastacp.fastacp import FastACP
 from agentex.lib.core.tracing.tracing_processor_manager import add_tracing_processor_config
 
 logger = make_logger(__name__)
 
+# Local Agentex backend: spans appear in the developer UI's traces tab.
+add_tracing_processor_config(AgentexTracingProcessorConfig())
+
 add_tracing_processor_config(
     SGPTracingProcessorConfig(
         sgp_api_key=os.environ.get("SGP_API_KEY", ""),

src/agentex/lib/cli/templates/default-langgraph/project/acp.py.j2

@@ -20,7 +20,7 @@ from agentex.lib.core.tracing.tracing_processor_manager import add_tracing_proce
 from agentex.lib.sdk.fastacp.fastacp import FastACP
 from agentex.protocol.acp import SendEventParams, CancelTaskParams, CreateTaskParams
 from agentex.lib.types.fastacp import AsyncACPConfig
-from agentex.lib.types.tracing import SGPTracingProcessorConfig
+from agentex.lib.types.tracing import SGPTracingProcessorConfig, AgentexTracingProcessorConfig
 from agentex.lib.utils.logging import make_logger
 from agentex.types.text_content import TextContent
 from agentex.lib.adk import LangGraphTurn
@@ -29,6 +29,9 @@ from project.graph import create_graph
 
 logger = make_logger(__name__)
 
+# Local Agentex backend: spans appear in the developer UI's traces tab.
+add_tracing_processor_config(AgentexTracingProcessorConfig())
+
 add_tracing_processor_config(
     SGPTracingProcessorConfig(
         sgp_api_key=os.environ.get("SGP_API_KEY", ""),

src/agentex/lib/cli/templates/default-openai-agents/project/acp.py.j2

@@ -25,7 +25,7 @@ from agents import Agent, Runner, function_tool, set_tracing_disabled
 from agentex.lib import adk
 from agentex.lib.types.acp import SendEventParams, CancelTaskParams, CreateTaskParams
 from agentex.lib.types.fastacp import AsyncACPConfig
-from agentex.lib.types.tracing import SGPTracingProcessorConfig
+from agentex.lib.types.tracing import SGPTracingProcessorConfig, AgentexTracingProcessorConfig
 from agentex.lib.utils.logging import make_logger
 from agentex.types.text_content import TextContent
 from agentex.lib.utils.model_utils import BaseModel
@@ -48,6 +48,9 @@ if _litellm_key and not os.environ.get("OPENAI_API_KEY"):
 
 _sgp_api_key = os.environ.get("SGP_API_KEY", "")
 _sgp_account_id = os.environ.get("SGP_ACCOUNT_ID", "")
+# Local Agentex backend: spans appear in the developer UI's traces tab.
+add_tracing_processor_config(AgentexTracingProcessorConfig())
+
 if _sgp_api_key and _sgp_account_id:
     add_tracing_processor_config(
         SGPTracingProcessorConfig(

src/agentex/lib/cli/templates/default-pydantic-ai/project/acp.py.j2

@@ -27,7 +27,7 @@ import agentex.lib.adk as adk
 from agentex.protocol.acp import SendEventParams, CancelTaskParams, CreateTaskParams
 from agentex.lib.core.harness import UnifiedEmitter
 from agentex.lib.types.fastacp import AsyncACPConfig
-from agentex.lib.types.tracing import SGPTracingProcessorConfig
+from agentex.lib.types.tracing import SGPTracingProcessorConfig, AgentexTracingProcessorConfig
 from agentex.lib.utils.logging import make_logger
 from agentex.types.text_content import TextContent
 from agentex.lib.utils.model_utils import BaseModel
@@ -42,6 +42,9 @@ logger = make_logger(__name__)
 # so they show up in the per-task spans dropdown out of the box.
 SGP_API_KEY = os.environ.get("SGP_API_KEY", "")
 SGP_ACCOUNT_ID = os.environ.get("SGP_ACCOUNT_ID", "")
+# Local Agentex backend: spans appear in the developer UI's traces tab.
+add_tracing_processor_config(AgentexTracingProcessorConfig())
+
 if SGP_API_KEY and SGP_ACCOUNT_ID:
     add_tracing_processor_config(
         SGPTracingProcessorConfig(

src/agentex/lib/cli/templates/sync-claude-code/project/acp.py.j2

@@ -25,7 +25,7 @@ import agentex.lib.adk as adk
 from agentex.lib.adk import ClaudeCodeTurn
 from agentex.lib.types.acp import SendMessageParams
 from agentex.lib.core.harness import UnifiedEmitter
-from agentex.lib.types.tracing import SGPTracingProcessorConfig
+from agentex.lib.types.tracing import SGPTracingProcessorConfig, AgentexTracingProcessorConfig
 from agentex.lib.utils.logging import make_logger
 from agentex.types.text_content import TextContent
 from agentex.lib.sdk.fastacp.fastacp import FastACP
@@ -35,6 +35,9 @@ from agentex.lib.core.tracing.tracing_processor_manager import add_tracing_proce
 
 logger = make_logger(__name__)
 
+# Local Agentex backend: spans appear in the developer UI's traces tab.
+add_tracing_processor_config(AgentexTracingProcessorConfig())
+
 add_tracing_processor_config(
     SGPTracingProcessorConfig(
         sgp_api_key=os.environ.get("SGP_API_KEY", ""),

src/agentex/lib/cli/templates/sync-codex/project/acp.py.j2

@@ -34,7 +34,7 @@ import agentex.lib.adk as adk
 from agentex.lib.adk import CodexTurn
 from agentex.lib.types.acp import SendMessageParams
 from agentex.lib.core.harness import UnifiedEmitter
-from agentex.lib.types.tracing import SGPTracingProcessorConfig
+from agentex.lib.types.tracing import SGPTracingProcessorConfig, AgentexTracingProcessorConfig
 from agentex.lib.utils.logging import make_logger
 from agentex.types.text_content import TextContent
 from agentex.lib.sdk.fastacp.fastacp import FastACP
@@ -44,6 +44,9 @@ from agentex.lib.core.tracing.tracing_processor_manager import add_tracing_proce
 
 logger = make_logger(__name__)
 
+# Local Agentex backend: spans appear in the developer UI's traces tab.
+add_tracing_processor_config(AgentexTracingProcessorConfig())
+
 add_tracing_processor_config(
     SGPTracingProcessorConfig(
         sgp_api_key=os.environ.get("SGP_API_KEY", ""),

src/agentex/lib/cli/templates/sync-langgraph/project/acp.py.j2

@@ -12,7 +12,7 @@ from agentex.lib.core.harness import UnifiedEmitter
 from agentex.lib.core.tracing.tracing_processor_manager import add_tracing_processor_config
 from agentex.lib.sdk.fastacp.fastacp import FastACP
 from agentex.protocol.acp import SendMessageParams
-from agentex.lib.types.tracing import SGPTracingProcessorConfig
+from agentex.lib.types.tracing import SGPTracingProcessorConfig, AgentexTracingProcessorConfig
 from agentex.lib.utils.logging import make_logger
 from agentex.types.text_content import TextContent
 from agentex.lib.adk import LangGraphTurn
@@ -33,7 +33,10 @@ from project.graph import create_graph
 
 logger = make_logger(__name__)
 
-# Register the Agentex tracing processor so spans are shipped to the backend
+# Local Agentex backend: spans appear in the developer UI's traces tab.
+add_tracing_processor_config(AgentexTracingProcessorConfig())
+
+# Register the Scale GenAI Platform (SGP) tracing processor
 add_tracing_processor_config(
     SGPTracingProcessorConfig(
         sgp_api_key=os.environ.get("SGP_API_KEY", ""),

src/agentex/lib/cli/templates/sync-openai-agents-local-sandbox/project/acp.py.j2

@@ -21,7 +21,7 @@ load_dotenv()
 from agentex.lib import adk
 from project.agent import run_agent
 from agentex.protocol.acp import SendMessageParams
-from agentex.lib.types.tracing import SGPTracingProcessorConfig
+from agentex.lib.types.tracing import SGPTracingProcessorConfig, AgentexTracingProcessorConfig
 from agentex.lib.utils.logging import make_logger
 from agentex.types.text_content import TextContent
 from agentex.lib.sdk.fastacp.fastacp import FastACP
@@ -42,6 +42,9 @@ SGP_API_KEY = os.environ.get("SGP_API_KEY", "")
 SGP_ACCOUNT_ID = os.environ.get("SGP_ACCOUNT_ID", "")
 SGP_CLIENT_BASE_URL = os.environ.get("SGP_CLIENT_BASE_URL", "")
 
+# Local Agentex backend: spans appear in the developer UI's traces tab.
+add_tracing_processor_config(AgentexTracingProcessorConfig())
+
 if SGP_API_KEY and SGP_ACCOUNT_ID:
     add_tracing_processor_config(
         SGPTracingProcessorConfig(

src/agentex/lib/cli/templates/sync-openai-agents/project/acp.py.j2

@@ -6,7 +6,7 @@ from agentex.lib.adk.providers._modules.sync_provider import SyncStreamingProvid
 from agentex.lib.sdk.fastacp.fastacp import FastACP
 from agentex.protocol.acp import SendMessageParams
 from agentex.lib.core.tracing.tracing_processor_manager import add_tracing_processor_config
-from agentex.lib.types.tracing import SGPTracingProcessorConfig
+from agentex.lib.types.tracing import SGPTracingProcessorConfig, AgentexTracingProcessorConfig
 from agentex.lib.utils.model_utils import BaseModel
 
 from agentex.types.task_message_update import TaskMessageUpdate, StreamTaskMessageFull
@@ -32,6 +32,9 @@ SGP_API_KEY = os.environ.get("SGP_API_KEY", "")
 SGP_ACCOUNT_ID = os.environ.get("SGP_ACCOUNT_ID", "")
 SGP_CLIENT_BASE_URL = os.environ.get("SGP_CLIENT_BASE_URL", "")
 
+# Local Agentex backend: spans appear in the developer UI's traces tab.
+add_tracing_processor_config(AgentexTracingProcessorConfig())
+
 if SGP_API_KEY and SGP_ACCOUNT_ID:
     add_tracing_processor_config(
         SGPTracingProcessorConfig(