Skip to content

feat: add user_handle and topic tags to root agent spans #303

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Kyle-Verhoog merged 2 commits into from
Mar 16, 2026
+15 −4
Merged

feat: add user_handle and topic tags to root agent spans #303

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c481429
feat: add user_handle tag to root agent spans via DD_USER_HANDLE env var
Kyle-Verhoog Mar 16, 2026
589cb45
feat: persist conversation topic across turns and tag on root spans
Kyle-Verhoog Mar 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 15 additions & 4 deletions ddapm_test_agent/claude_hooks.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,7 @@

_HOSTNAME = socket.gethostname()
_USERNAME = os.environ.get("HOST_USER") or getpass.getuser()
_USER_HANDLE = os.environ.get("DD_USER_HANDLE", "")

MODEL_CONTEXT_LIMITS: Dict[str, int] = {} # empty; default fallback handles all models

Expand Down Expand Up @@ -409,7 +410,9 @@ def _handle_user_prompt_submit(self, session_id: str, body: Dict[str, Any]) -> N
session.pending_tools = {}
session.deferred_agent_spans = {}
session.claimed_task_tools = set()
session.conversation_title = ""
# Don't reset conversation_title — it persists across turns so
# subsequent interactions on the same topic reuse the title.
# The haiku summarization call will update it when the topic changes.
session.root_span_emitted = False

prompt = body.get("user_prompt", body.get("prompt", ""))
Expand Down Expand Up @@ -437,7 +440,9 @@ def _handle_user_prompt_submit(self, session_id: str, body: Dict[str, Any]) -> N
"source:claude-code-hooks",
"language:python",
f"hostname:{_HOSTNAME}",
],
]
+ ([f"user_handle:{_USER_HANDLE}"] if _USER_HANDLE else [])
+ ([f"topic:{session.conversation_title}"] if session.conversation_title else []),
"meta": {
"span": {"kind": "agent"},
"input": {"value": prompt},
Expand Down Expand Up @@ -896,12 +901,16 @@ def _handle_stop(self, session_id: str, body: Dict[str, Any]) -> None:
if context_delta:
session.last_known_input_tokens = context_delta["last_input_tokens"]

root_span_name = session.conversation_title or "claude-code-request"
root_span_name = "claude-code-request"

estimated_permission_wait_ms = self._sum_estimated_permission_wait_ms(trace_id=session.trace_id)

if root_span:
root_span["name"] = root_span_name
if session.conversation_title:
topic_tag = f"topic:{session.conversation_title}"
# Replace existing topic tag (set from preliminary span) or append
root_span["tags"] = [t for t in root_span["tags"] if not t.startswith("topic:")] + [topic_tag]
root_span["duration"] = duration
root_span["meta"]["input"]["value"] = input_value
root_span["meta"]["output"]["value"] = output_value
Expand Down Expand Up @@ -944,7 +953,9 @@ def _handle_stop(self, session_id: str, body: Dict[str, Any]) -> None:
"language:python",
f"hostname:{_HOSTNAME}",
f"user_name:{_USERNAME}",
],
]
+ ([f"user_handle:{_USER_HANDLE}"] if _USER_HANDLE else [])
+ ([f"topic:{session.conversation_title}"] if session.conversation_title else []),
"meta": {
"span": {"kind": "agent"},
"input": {"value": input_value},
Expand Down
Loading