@@ -140,13 +140,39 @@ function result(source: ClientSessionSource, action: ClientSessionAction, node:
140140 } ;
141141}
142142
143+ // Explicit session-id headers, tool-specific before generic (first match wins).
144+ // Evidence (2026-10-11, real-source survey):
145+ // - x-opencode-session OpenCode harness
146+ // - x-claude-code-session-id Claude Code 2.1.87+ (gateway protocol; also
147+ // paired with x-app: cli / x-stainless-*)
148+ // - claude-code-session-id non-x variant some Claude Code SDK clients send
149+ // - x-vscode-sessionid VSCode family — Google Antigravity sends it
150+ // per app launch (agproxy/Antigravity-Manager 抓包)
151+ // - x-session-id generic convention
152+ // - x-parent-session-id subagent lineage
153+ // - helicone-session-id Helicone proxy convention
154+ // Not added: x-machine-id (machine-granular — would fuse every conversation of
155+ // a machine into one affinity session); x-claude-code-agent-id/-parent-agent-id
156+ // (agent lineage, not conversation identity). SillyTavern has NO native session
157+ // header (thin-server: its Express backend sends only auth/content-type plus
158+ // user-configured additional headers — users can set x-session-id themselves).
159+ const SESSION_ID_HEADERS = [
160+ "x-opencode-session" ,
161+ "x-claude-code-session-id" ,
162+ "claude-code-session-id" ,
163+ "x-vscode-sessionid" ,
164+ "x-session-id" ,
165+ "x-parent-session-id" ,
166+ "helicone-session-id" ,
167+ ] ;
168+
143169function requestTraceContext ( req : Request , body : string | undefined ) : ExplicitTraceContext {
144170 const bodyTrace = bodyMetadataTrace ( body ) ;
145171 return {
146- requestId : firstHeader ( req . headers , [ "x-request-id" ] ) ?? bodyTrace . requestId ,
172+ requestId : firstHeader ( req . headers , [ "x-request-id" , "x-client-request-id" ] ) ?? bodyTrace . requestId ,
147173 traceId : firstHeader ( req . headers , [ "x-zcode-trace-id" ] ) ?? bodyTrace . traceId ,
148174 queryId : firstHeader ( req . headers , [ "x-query-id" ] ) ?? bodyTrace . queryId ,
149- sessionId : firstHeader ( req . headers , [ "x-opencode-session" , "x-claude-code-session-id" , "x-session-id" , "x-parent-session-id" , "helicone-session-id" ] )
175+ sessionId : firstHeader ( req . headers , SESSION_ID_HEADERS )
150176 ?? bodyTrace . sessionId ,
151177 } ;
152178}
0 commit comments