cleanupSessionLifecycleArtifacts,

createSessionEntryWithTranscript,

listSessionEntries,

loadExactSessionEntry,

loadSessionEntry,

loadTranscriptEvents,

patchSessionEntry,

);

});

it("keeps exact persisted-key lookup separate from canonical entry reads", async () => {

it("resolves canonical entry reads without requiring exact key casing", async () => {

fs.writeFileSync(

storePath,

JSON.stringify({

storePath,

};

expect(loadSessionEntry(mixedCaseScope)?.sessionId).toBe("session-1");

expect(loadExactSessionEntry(mixedCaseScope)).toBeUndefined();

expect(loadExactSessionEntry({ sessionKey: "agent:main:main", storePath })).toEqual({

sessionKey: "agent:main:main",

entry: expect.objectContaining({

expect(loadSessionEntry(mixedCaseScope)).toEqual(

expect.objectContaining({

sessionId: "session-1",

model: "gpt-5.5",

}),

});

);

});

it("updates existing entries without creating missing sessions", async () => {

entry: SessionEntry;

};

/** Session entry read by the exact persisted session key, without alias resolution. */

export type ExactSessionEntry = {

sessionKey: string;

entry: SessionEntry;

};

/** Raw transcript record for non-message events; message records use appendTranscriptMessage. */

export type TranscriptEvent = unknown;

return getSessionEntry(scope);

}

/**

* Returns only the row persisted under the exact key provided.

* Use this for authorization-sensitive routing where alias canonicalization

* could cross an account or agent boundary.

*/

export function loadExactSessionEntry(scope: SessionAccessScope): ExactSessionEntry | undefined {

const sessionKey = scope.sessionKey.trim();

if (!sessionKey) {

return undefined;

}

const store = loadSessionStore(resolveAccessStorePath(scope), {

...(scope.clone === false ? { clone: false } : {}),

...(scope.hydrateSkillPromptRefs === false ? { hydrateSkillPromptRefs: false } : {}),

});

const entry = Object.hasOwn(store, sessionKey) ? store[sessionKey] : undefined;

return entry ? { sessionKey, entry } : undefined;

}

/** Lists entries from the resolved store, preserving the persisted key for each row. */

export function listSessionEntries(

scope: Partial<Omit<SessionAccessScope, "sessionKey">> = {},