test(sessions): add access and resolution helper coverage

src/agents/tools/sessions-resolution.test.ts

@@ -0,0 +1,77 @@
+import { describe, expect, it } from "vitest";
+import type { OpenClawConfig } from "../../config/config.js";
+import {
+  looksLikeSessionId,
+  looksLikeSessionKey,
+  resolveDisplaySessionKey,
+  resolveInternalSessionKey,
+  resolveMainSessionAlias,
+  shouldResolveSessionIdInput,
+} from "./sessions-resolution.js";
+
+describe("resolveMainSessionAlias", () => {
+  it("uses normalized main key and global alias for global scope", () => {
+    const cfg = {
+      session: { mainKey: " Primary ", scope: "global" },
+    } as OpenClawConfig;
+
+    expect(resolveMainSessionAlias(cfg)).toEqual({
+      mainKey: "primary",
+      alias: "global",
+      scope: "global",
+    });
+  });
+
+  it("falls back to per-sender defaults", () => {
+    expect(resolveMainSessionAlias({} as OpenClawConfig)).toEqual({
+      mainKey: "main",
+      alias: "main",
+      scope: "per-sender",
+    });
+  });
+});
+
+describe("session key display/internal mapping", () => {
+  it("maps alias and main key to display main", () => {
+    expect(resolveDisplaySessionKey({ key: "global", alias: "global", mainKey: "main" })).toBe(
+      "main",
+    );
+    expect(resolveDisplaySessionKey({ key: "main", alias: "global", mainKey: "main" })).toBe(
+      "main",
+    );
+    expect(
+      resolveDisplaySessionKey({ key: "agent:ops:main", alias: "global", mainKey: "main" }),
+    ).toBe("agent:ops:main");
+  });
+
+  it("maps input main to alias for internal routing", () => {
+    expect(resolveInternalSessionKey({ key: "main", alias: "global", mainKey: "main" })).toBe(
+      "global",
+    );
+    expect(
+      resolveInternalSessionKey({ key: "agent:ops:main", alias: "global", mainKey: "main" }),
+    ).toBe("agent:ops:main");
+  });
+});
+
+describe("session reference shape detection", () => {
+  it("detects session ids", () => {
+    expect(looksLikeSessionId("d4f5a5a1-9f75-42cf-83a6-8d170e6a1538")).toBe(true);
+    expect(looksLikeSessionId("not-a-uuid")).toBe(false);
+  });
+
+  it("detects canonical session key families", () => {
+    expect(looksLikeSessionKey("main")).toBe(true);
+    expect(looksLikeSessionKey("agent:main:main")).toBe(true);
+    expect(looksLikeSessionKey("cron:daily-report")).toBe(true);
+    expect(looksLikeSessionKey("node:macbook")).toBe(true);
+    expect(looksLikeSessionKey("telegram:group:123")).toBe(true);
+    expect(looksLikeSessionKey("random-slug")).toBe(false);
+  });
+
+  it("treats non-keys as session-id candidates", () => {
+    expect(shouldResolveSessionIdInput("agent:main:main")).toBe(false);
+    expect(shouldResolveSessionIdInput("d4f5a5a1-9f75-42cf-83a6-8d170e6a1538")).toBe(true);
+    expect(shouldResolveSessionIdInput("random-slug")).toBe(true);
+  });
+});