@termfleet/core 0.2.0 → 0.2.1

package/dist/agent-session.d.ts

@@ -302,6 +302,21 @@ export declare function resolveClaudeTranscriptPath(options: {
     home?: string;
     sessionId: string;
 }): string | undefined;
+export declare function findLocalClaudeSession(sessionId: string, options?: {
+    home?: string;
+}): {
+    sessionId: string;
+    cwd: string | undefined;
+    transcriptPath: string;
+} | undefined;
+export declare function findLocalAgentSession(agentSessionId: string, options?: {
+    home?: string;
+}): {
+    agent: "claude" | "codex" | "gemini";
+    sessionId: string;
+    cwd: string | undefined;
+    transcriptPath: string;
+} | undefined;
 export declare function emptyClaudeSession(options: {
     cwd: string;
     home?: string;

package/dist/agent-session.js

@@ -74,6 +74,59 @@ export function resolveClaudeTranscriptPath(options) {
     const found = findClaudeTranscriptById(join(options.home ?? agentHome(), ".claude", "projects"), assertSafeAgentSessionId(normalizeClaudeSessionId(options.sessionId)));
     return existsSync(found) ? found : undefined;
 }
+// Read the working dir a Claude session ran in, straight from its transcript. The `cwd` is on the message
+// records, not always the first header line, so scan a bounded prefix (headers are small). undefined if absent.
+function readClaudeSessionCwd(transcriptPath, maxBytes = 65_536) {
+    let head;
+    try {
+        const fd = openSync(transcriptPath, "r");
+        try {
+            const buffer = Buffer.alloc(maxBytes);
+            const bytesRead = readSync(fd, buffer, 0, maxBytes, 0);
+            head = buffer.toString("utf8", 0, bytesRead);
+        }
+        finally {
+            closeSync(fd);
+        }
+    }
+    catch {
+        return undefined;
+    }
+    for (const line of head.split("\n")) {
+        if (!line)
+            continue;
+        try {
+            const row = JSON.parse(line);
+            if (typeof row.cwd === "string" && row.cwd)
+                return row.cwd;
+        }
+        catch { /* a truncated final line in the bounded read — ignore */ }
+    }
+    return undefined;
+}
+// Resolve a Claude session from its id ALONE (no cwd needed): find its transcript across every project dir and
+// read the session's cwd from it. Local + provider-free — the primitive any tool needs when it has a session
+// id but not its working dir (a session mirror, a resumer, a cross-project browser). undefined when the
+// transcript doesn't exist yet (a just-launched session writes it only once it produces messages).
+export function findLocalClaudeSession(sessionId, options = {}) {
+    const bareId = assertSafeAgentSessionId(normalizeClaudeSessionId(sessionId));
+    const transcriptPath = findClaudeTranscriptById(join(options.home ?? agentHome(), ".claude", "projects"), bareId);
+    if (!existsSync(transcriptPath))
+        return undefined;
+    return { sessionId: bareId, cwd: readClaudeSessionCwd(transcriptPath), transcriptPath };
+}
+// The agent-generic form: resolve a (prefixed or bare) agentSessionId → its provider, cwd, and transcript
+// path, locally. A bare id is treated as Claude. (Codex/Gemini keep transcripts elsewhere; extend here when
+// needed — non-Claude returns undefined for now.)
+export function findLocalAgentSession(agentSessionId, options = {}) {
+    const separator = agentSessionId.indexOf(":");
+    const prefix = separator > 0 ? agentSessionId.slice(0, separator) : "";
+    const agent = prefix === "codex" ? "codex" : prefix === "gemini" ? "gemini" : "claude";
+    if (agent !== "claude")
+        return undefined;
+    const resolved = findLocalClaudeSession(agentSessionId, options);
+    return resolved ? { agent, ...resolved } : undefined;
+}
 // A real, openable chat for a session that has no transcript yet — just an empty
 // conversation. Parsing empty JSONL yields a well-formed session with zero
 // messages, so a just-launched agent displays as an empty chat instead of 500ing.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@termfleet/core",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Termfleet core: contracts, the provider SDK, and the agent-transcript/session library (Claude Code / Codex / Gemini). The reusable layer, usable beyond the console.",
   "keywords": [
     "claude-code",