@volter/supercode-interchange 0.1.9 → 0.1.11

package/jsonl.mjs

@@ -30,13 +30,17 @@ async function readHeader(reader, harness) {
 }
 
 async function descriptor(path, harness, reader, header, facts, nativeTopic) {
-  const sessionId = header.session_id ?? basename(path, extname(path));
+  // A Claude subagent's transcript (`<session>/subagents/agent-<id>.jsonl`) carries its parent's sessionId in every
+  // record: named by that id it would share its parent's index key, replace the parent's row and, as a child, drop
+  // the parent from discovery. It is named by its own file, under its parent.
+  const subagentOf = harness === 'claude-code' && basename(dirname(path)) === 'subagents' ? basename(dirname(dirname(path))) : null;
+  const sessionId = subagentOf ? basename(path, extname(path)) : header.session_id ?? basename(path, extname(path));
   let title = header.title ?? header.topic;
   if (title == null && harness === 'codex') {
     if (typeof nativeTopic !== 'function') throw new Error('Codex metadata requires its native thread-name source');
     title = await nativeTopic(path, sessionId);
   }
-  const parent = header.parent_session_id ?? (harness === 'claude-code' && basename(dirname(path)) === 'subagents' ? basename(dirname(dirname(path))) : null);
+  const parent = header.parent_session_id ?? subagentOf;
   return finalizeNouns({
     locator: { harness, session_id: sessionId, storage: { kind: 'file', path } },
     cwd: header.cwd, title, updated_at_ms: facts.last_turn_ms ?? reader.modified_ms,

package/metadata.mjs

@@ -119,7 +119,7 @@ export function headerFacts(records, harness) {
     applyHeaderRecord(result, value, harness);
     if (headerComplete(result, harness)) break;
   }
-  if (result.session_id == null && result.cwd == null) throw new Error(`no recognizable ${harness} session header`);
+  if (result.session_id == null && result.cwd == null) throw Object.assign(new Error(`no recognizable ${harness} session header`), { code: 'not_a_session' });
   return result;
 }
 

package/openclaw.mjs

@@ -44,7 +44,7 @@ async function scanCounts(reader, previous) {
     headerPieces = []; headerSize = 0;
     if (!nativeTrim(text)) return;
     const value = parseJsonLine(bytes, { strictUtf8: true });
-    if (value?.type !== 'session') throw new Error(`${reader.path} has no OpenClaw session header`);
+    if (value?.type !== 'session') throw Object.assign(new Error(`${reader.path} has no OpenClaw session header`), { code: 'not_a_session' });
     header = value; headerTerminated = terminated;
   };
   while (offset < reader.size) {
@@ -72,7 +72,7 @@ async function scanCounts(reader, previous) {
   }
   utf8.decode(); // A truncated multibyte sequence is a failed part, not none.
   if (header == null && headerSize) acceptHeader(false);
-  if (header == null) throw new Error(`${reader.path} has no OpenClaw session header`);
+  if (header == null) throw Object.assign(new Error(`${reader.path} has no OpenClaw session header`), { code: 'not_a_session' });
   count.match_tail = overlap.toString('base64');
   return { count, header, header_terminated: headerTerminated };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/supercode-interchange",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "type": "module",
   "description": "Read-only harness metadata, transcript codecs and session projections for Supercode",
   "license": "MIT OR Apache-2.0",

package/source-files.mjs

@@ -46,7 +46,7 @@ async function geminiHeader(reader) {
   const bytes = await reader.read(0, Math.min(64 * 1024, reader.size));
   const newline = bytes.indexOf(10), end = newline < 0 ? bytes.length : newline;
   const header = parseJsonLine(bytes.subarray(0, end), { strictUtf8: true });
-  if (typeof header?.sessionId !== 'string') throw new Error(`${reader.path} has no Gemini sessionId header`);
+  if (typeof header?.sessionId !== 'string') throw Object.assign(new Error(`${reader.path} has no Gemini sessionId header`), { code: 'not_a_session' });
   const after = newline < 0 ? bytes.length : newline + 1;
   const decoration = bytes.subarray(after, Math.min(bytes.length, after + 4 * 1024));
   let model = null, modelTerminated = false;

package/source-layout.mjs

@@ -37,7 +37,13 @@ export async function sessionPartFor(harness, root, path) {
   const name = basename(path);
   if (harness === 'claude-code' || harness === 'pi') return name.endsWith('.jsonl') ? path : null;
   if (harness === 'codex') return name.endsWith('.jsonl') || name.endsWith('.jsonl.zst') ? path : null;
-  if (harness === 'openclaw') return name.endsWith('.jsonl') && !name.endsWith('.trajectory.jsonl') ? path : null;
+  // OpenClaw keeps its sessions in `agents/<id>/sessions/` only (native discover_openclaw); the rest of its state
+  // folder (logs, cron, workspace) holds JSONL that is not a session.
+  if (harness === 'openclaw') {
+    const part = relative(root, path).split(sep);
+    return part.length === 4 && part[0] === 'agents' && part[2] === 'sessions'
+      && name.endsWith('.jsonl') && !name.endsWith('.trajectory.jsonl') ? path : null;
+  }
   if (harness === 'gemini') return name.endsWith('.jsonl') && pathUnder(join(root, 'tmp'), path) ? path : null;
   if (harness === 'grok') {
     const part = relative(root, path).split(sep);