diff --git a/packages/bash/tool-bash/src/index.ts b/packages/bash/tool-bash/src/index.ts
index fe07b80989..cda683c5b4 100644
--- a/packages/bash/tool-bash/src/index.ts
+++ b/packages/bash/tool-bash/src/index.ts
@@ -457,7 +457,7 @@ export function apply(ctx: Context): void {
       )
     } catch (error: unknown) {
       // The ONE expected failure: the agent was disposed between task
-      // completion and this injection (ReactLoopAgent.inject throws
+      // completion and this injection (Agent.inject throws
       // `agent "<id>" is disposed`). That race is benign — drop the notice.
       // Anything else is a real bug and must surface, not be swallowed.
       if (error instanceof Error && error.message.includes('is disposed')) return
diff --git a/packages/ui/jsonrpc/src/server.ts b/packages/ui/jsonrpc/src/server.ts
index 352563f7f2..fe605a8536 100644
--- a/packages/ui/jsonrpc/src/server.ts
+++ b/packages/ui/jsonrpc/src/server.ts
@@ -62,6 +62,7 @@ interface SessionRecord {
 
 /** Recover the delegating parent carried by every service-owned subagent lifecycle event. */
 function subagentParentOf(carrier: Scoped<SubagentService>): Agent {
+  // SubagentService emits this lifecycle pair only through scopeTarget(this, parent).
   return carrierKeyOf(carrier) as Agent
 }