@turns/dev 0.0.26 → 0.0.28

package/dist/local-session-sources.js

@@ -964,6 +964,45 @@ function firstRecords(descriptor, limit = 32, maxBytes = 1024 * 1024) {
         return [];
     }
 }
+/** Claude copies a backgrounded session into a new transcript and ends the
+ * old one with `{"type":"continued-in","continuedInSessionId":...}`, followed
+ * only by small bookkeeping rows. Read just the file's tail for that marker. */
+function claudeContinuedInSessionId(file) {
+    let handle;
+    try {
+        const stat = fs.statSync(file);
+        const bytesToRead = Math.min(stat.size, 16 * 1024);
+        handle = fs.openSync(file, 'r');
+        const buffer = Buffer.alloc(bytesToRead);
+        const bytesRead = fs.readSync(handle, buffer, 0, buffer.length, stat.size - bytesToRead);
+        const text = buffer.subarray(0, bytesRead).toString('utf8');
+        if (!text.includes('"continued-in"'))
+            return '';
+        let continuedIn = '';
+        for (const line of text.split('\n')) {
+            if (!line.includes('"continued-in"'))
+                continue;
+            try {
+                const record = jsonObject(JSON.parse(line));
+                const id = String(record?.continuedInSessionId || '').trim();
+                if (record?.type === 'continued-in' && /^[0-9a-f-]{8,64}$/iu.test(id))
+                    continuedIn = id;
+            }
+            catch { }
+        }
+        return continuedIn;
+    }
+    catch {
+        return '';
+    }
+    finally {
+        try {
+            if (handle !== undefined)
+                fs.closeSync(handle);
+        }
+        catch { }
+    }
+}
 /** Native identity and parentage carried by a bounded transcript prefix. */
 export function nativeDescriptorLineage(descriptor) {
     const sourcePath = String(descriptor?.sourcePath || descriptor?.file || '').replaceAll('\\', '/');
@@ -1042,10 +1081,14 @@ export function nativeDescriptorLineage(descriptor) {
     }
     if (parentNativeSessionId)
         isSubagent = true;
+    const continuedInNativeSessionId = descriptor?.harness === 'claude' && !isSubagent && descriptor?.file
+        ? claudeContinuedInSessionId(String(descriptor.file))
+        : '';
     const value = {
         nativeSessionId,
         parentNativeSessionId,
         isSubagent,
+        ...(continuedInNativeSessionId ? { continuedInNativeSessionId } : {}),
         ...(structural?.uploadable === false ? { uploadable: false } : {}),
         ...(parentSourcePath ? { parentSourcePath } : {}),
         ...(claudeMetadata?.description ? { nativeTitle: claudeMetadata.description } : {}),

package/dist/upload-sessions.js

@@ -317,6 +317,19 @@ export function linkNativeSessionParents(machine, descriptors) {
         candidates.push(record.descriptor);
         byNativeId.set(key, candidates);
     }
+    // A continued transcript names its successor; key it by the successor's
+    // store directory so equal native IDs in other projects never match.
+    const nativeDirectory = (descriptor) => path.posix.dirname(String(descriptor?.sourcePath || '').replaceAll('\\', '/'));
+    const predecessorsBySuccessor = new Map();
+    for (const record of records) {
+        const successorId = record.lineage.continuedInNativeSessionId;
+        if (!successorId || successorId === record.lineage.nativeSessionId)
+            continue;
+        const key = `${record.descriptor.harness}\0${nativeDirectory(record.descriptor)}\0${successorId}`;
+        const candidates = predecessorsBySuccessor.get(key) || [];
+        candidates.push(record.descriptor);
+        predecessorsBySuccessor.set(key, candidates);
+    }
     const grokParentsByChildId = new Map();
     for (const record of records) {
         if (record.descriptor.harness !== 'grok')
@@ -367,6 +380,10 @@ export function linkNativeSessionParents(machine, descriptors) {
         // native upload until its store exposes enough lineage to nest it safely.
         if (isSubagent && !parentSourcePath)
             return [];
+        const predecessors = !isSubagent && lineage.nativeSessionId
+            ? predecessorsBySuccessor.get(`${descriptor.harness}\0${nativeDirectory(descriptor)}\0${lineage.nativeSessionId}`) || []
+            : [];
+        const predecessor = predecessors.length === 1 ? predecessors[0] : null;
         return [
             {
                 ...descriptor,
@@ -379,6 +396,9 @@ export function linkNativeSessionParents(machine, descriptors) {
                         parentSessionId: stableNativeSessionId(machine, descriptor.harness, parentSourcePath),
                     }
                     : {}),
+                ...(predecessor
+                    ? { supersedesSessionId: stableNativeSessionId(machine, descriptor.harness, predecessor.sourcePath) }
+                    : {}),
             },
         ];
     });
@@ -391,6 +411,8 @@ export function nativeDescriptorFingerprint(descriptor) {
         String(descriptor.parentSessionId || ''),
         NATIVE_DESCRIPTOR_VERSION,
         nativeDescriptorMetadataFingerprint(descriptor),
+        // Appended only when present so unrelated sessions keep their fingerprint.
+        ...(descriptor.supersedesSessionId ? [String(descriptor.supersedesSessionId)] : []),
     ]);
 }
 function nativeDescriptorMetadataFingerprint(descriptor) {
@@ -994,6 +1016,7 @@ export async function uploadNativeSession(rpc, machine, descriptor, cursor = {},
             ...(descriptor.readOnly === true ? { readOnly: true } : {}),
             ...(agentSessionId ? { agentSessionId } : {}),
             ...(descriptor.parentSessionId ? { parentSessionId: descriptor.parentSessionId } : {}),
+            ...(descriptor.supersedesSessionId ? { supersedesSessionId: descriptor.supersedesSessionId } : {}),
         },
     });
     if (opened.type === 'session_tombstoned') {
@@ -1592,7 +1615,8 @@ async function uploadNative(options, machine, redactor = DEFAULT_REDACTOR) {
                     Number(previous?.[1]) === Number(descriptor.mtimeMs) &&
                     String(previous?.[3] || '') === String(descriptor.parentSessionId || '') &&
                     Number(previous?.[4]) === NATIVE_DESCRIPTOR_VERSION &&
-                    String(previous?.[5] || '') === nativeDescriptorMetadataFingerprint(descriptor)) {
+                    String(previous?.[5] || '') === nativeDescriptorMetadataFingerprint(descriptor) &&
+                    String(previous?.[6] || '') === String(descriptor.supersedesSessionId || '')) {
                     fingerprint = previousFingerprint;
                 }
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@turns/dev",
-  "version": "0.0.26",
+  "version": "0.0.28",
   "description": "Upload local AI agent sessions to turns.dev",
   "license": "MIT",
   "type": "module",