@softprobe/opencode-plugin 0.1.5 → 0.1.7

package/README.md

@@ -8,6 +8,9 @@ and used to improve agents.
 
 ## Install
 
+Full guide: [Agent QA · OpenCode](https://docs.softprobe.ai/en/agent-qa/opencode)
+(Explorer can also give you a short pasteable OpenCode chat prompt).
+
 Enable OpenTelemetry and add the plugin in `opencode.json` / `opencode.jsonc`:
 
 ```json
@@ -69,16 +72,18 @@ credentials when `SPCODE_MODE` is on (see softprobe-code
 
 ### Sub-agent sessions
 
-OpenCode runs sub-agents (the `task` tool) in child sessions. The plugin nests
-each child session's turn under the dispatching task span, so a whole agent
-run — root session plus any sub-agents, recursively — forms a single trace
-instead of several disconnected ones. The link comes from the task part's
+OpenCode runs sub-agents (the `task` tool) in child OpenCode sessions. The
+plugin nests each child turn under the dispatching task span (`parent_span_id`)
+and stamps the **root** OpenCode session id as `sp.session.id` /
+`gen_ai.conversation.id` on every nested span — one product Session for the
+whole chat. Child `ses_*` ids stay internal to the plugin graph and are never
+the product session key. Linkage comes from the task part's
 `state.metadata.sessionId` (authoritative), with `task_id` resume and
 parentID + task-call inference as fallbacks; ambiguous dispatches (e.g.
-parallel identical task calls) are left unnested rather than guessed. Each
-span keeps its own `sp.session.id`; the parent side is recorded as
-`sp.metadata.opencode.parentSessionID` / `sp.metadata.opencode.parentTaskCallID`
-on the child turn and `sp.child.session.id` on the task span.
+parallel identical task calls) are left unnested rather than guessed. Nested
+turns also carry `sp.metadata.opencode.parentSessionID` /
+`sp.metadata.opencode.parentTaskCallID`, and the task span records
+`sp.child.session.id` for the OpenCode child session id.
 
 Session lifecycle is isolated per session: a sub-agent session going idle
 finalizes only its own spans, never the parent session's in-flight work.

package/dist/session-graph.d.ts

@@ -47,6 +47,8 @@ export declare class SessionGraph {
     markRoot(sessionID: string): void;
     isRoot(sessionID: string): boolean;
     parentOf(sessionID: string): string | undefined;
+    /** Walk parent links to the product (root) session id. */
+    rootSessionId(sessionID: string): string;
     registerTaskCall(callID: string, sessionID: string, args: TaskCallArgs): void;
     endTaskCall(callID: string): void;
     bind(binding: TaskBinding): void;

package/dist/session-graph.js

@@ -67,6 +67,20 @@ export class SessionGraph {
     parentOf(sessionID) {
         return this.parents.get(sessionID);
     }
+    /** Walk parent links to the product (root) session id. */
+    rootSessionId(sessionID) {
+        let current = sessionID;
+        const seen = new Set();
+        while (true) {
+            if (seen.has(current))
+                return current;
+            seen.add(current);
+            const parent = this.parents.get(current);
+            if (!parent)
+                return current;
+            current = parent;
+        }
+    }
     registerTaskCall(callID, sessionID, args) {
         const existing = this.taskCalls.get(callID);
         if (existing) {

package/dist/softprobe.js

@@ -391,8 +391,11 @@ export class SoftprobeSessionTracer {
             this.generationParents.get(sessionID));
     }
     sessionAttrs(sessionID) {
+        // Product session is always the root OpenCode session; child ses_* scopes
+        // keep their own bookkeeping keys but stamp the root on every span.
+        const productSessionId = this.sessionGraph.rootSessionId(sessionID);
         return {
-            sessionId: sessionID,
+            sessionId: productSessionId,
             ...(this.userId ? { userId: this.userId } : {}),
         };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softprobe/opencode-plugin",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "OpenCode plugin that sends session telemetry to Softprobe",
   "type": "module",
   "main": "./dist/index.js",
@@ -25,7 +25,7 @@
     "lint": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@softprobe/tracing": "0.1.5"
+    "@softprobe/tracing": "0.1.7"
   },
   "peerDependencies": {
     "@opencode-ai/plugin": ">=1.15.0",