openclaw - 💡(How to fix) Fix Fix Codex /btw parent thread lookup after compaction checkpoints [1 pull requests]

session-1.jsonl.codex-app-server.json

---

${resolvedSessionFile}.codex-app-server.json

---

session-1.checkpoint.<id>.jsonl

---

session-1.checkpoint.<id>.jsonl.codex-app-server.json

---

Codex /btw needs an active Codex thread. Send a normal message first, then try /btw again.

---

commands-btw.ts
  -> runBtwSideQuestion()
  -> resolveBtwSessionTranscriptPath()
  -> resolveSessionFilePath()
  -> harness.runSideQuestion()
  -> runCodexAppServerSideQuestion()
  -> readCodexAppServerBinding(sessionFile)

---

export function resolveBtwSessionTranscriptPath(params: {
  sessionId: string;
  sessionEntry?: StoredSessionEntry;
  sessionKey?: string;
  storePath?: string;
}): string | undefined {
  try {
    const agentId = params.sessionKey?.split(":")[1];
    const pathOpts = resolveSessionFilePathOptions({
      agentId,
      storePath: params.storePath,
    });
    return resolveSessionFilePath(params.sessionId, params.sessionEntry, pathOpts);
  } catch (error) {
    diag.debug(
      `resolveSessionTranscriptPath failed: sessionId=${params.sessionId} err=${String(error)}`,
    );
    return undefined;
  }
}

---

export function resolveBtwSessionTranscriptPath(params: {
  sessionId: string;
  sessionEntry?: StoredSessionEntry;
  sessionKey?: string;
  storePath?: string;
}): string | undefined {
  try {
    const agentId = params.sessionKey?.split(":")[1];
    const pathOpts = resolveSessionFilePathOptions({
      agentId,
      storePath: params.storePath,
    });
    const sessionFile = resolveSessionFilePath(params.sessionId, params.sessionEntry, pathOpts);
    return (
      resolvePostCompactionSessionTranscriptPath({
        sessionFile,
        sessionEntry: params.sessionEntry,
        pathOpts,
      }) ?? sessionFile
    );
  } catch (error) {
    diag.debug(
      `resolveSessionTranscriptPath failed: sessionId=${params.sessionId} err=${String(error)}`,
    );
    return undefined;
  }
}

---

function resolvePostCompactionSessionTranscriptPath(params: {
  sessionFile: string;
  sessionEntry?: StoredSessionEntry;
  pathOpts?: ReturnType<typeof resolveSessionFilePathOptions>;
}): string | undefined {
  const checkpoints = params.sessionEntry?.compactionCheckpoints;
  if (!Array.isArray(checkpoints) || checkpoints.length === 0) {
    return undefined;
  }
  const resolvedSessionFile = path.resolve(params.sessionFile);
  for (let index = checkpoints.length - 1; index >= 0; index -= 1) {
    const checkpoint = checkpoints[index];
    const preSessionId = checkpoint.preCompaction.sessionId?.trim();
    if (!preSessionId) {
      continue;
    }
    const preSessionFile = resolveSessionFilePath(
      preSessionId,
      { sessionFile: checkpoint.preCompaction.sessionFile },
      params.pathOpts,
    );
    if (path.resolve(preSessionFile) !== resolvedSessionFile) {
      continue;
    }
    const postSessionId = checkpoint.postCompaction.sessionId?.trim();
    if (!postSessionId) {
      return undefined;
    }
    return resolveSessionFilePath(
      postSessionId,
      { sessionFile: checkpoint.postCompaction.sessionFile },
      params.pathOpts,
    );
  }
  return undefined;
}

---

src/agents/btw-transcript.test.ts

---

it("uses the active post-compaction transcript when the stored session file points at a checkpoint", () => {
  const sessionsDir = "/tmp/openclaw-btw-session";
  const sessionId = "session-1";
  const checkpointFile = path.join(
    sessionsDir,
    "session-1.checkpoint.98904e8a-a402-4d92-8795-4a2d7bba2276.jsonl",
  );
  const postCompactionFile = path.join(sessionsDir, "session-1.jsonl");
  const entry: SessionEntry = {
    sessionId,
    sessionFile: checkpointFile,
    compactionCheckpoints: [
      {
        checkpointId: "98904e8a-a402-4d92-8795-4a2d7bba2276",
        sessionKey: "agent:main:telegram:direct:user",
        sessionId,
        createdAt: 1_779_695_000_000,
        reason: "threshold",
        preCompaction: {
          sessionId,
          sessionFile: checkpointFile,
          leafId: "pre-leaf",
        },
        postCompaction: {
          sessionId,
          sessionFile: postCompactionFile,
          leafId: "post-leaf",
        },
      },
    ],
  };

  expect(
    resolveBtwSessionTranscriptPath({
      sessionId,
      sessionEntry: entry,
      sessionKey: "agent:main:telegram:direct:user",
      storePath: path.join(sessionsDir, "sessions.json"),
    }),
  ).toBe(postCompactionFile);
});

---

./node_modules/.bin/vitest run src/agents/btw-transcript.test.ts src/agents/btw.test.ts extensions/codex/src/app-server/side-question.test.ts

---

Test Files  5 passed (5)
Tests       83 passed (83)