@athenaintel/react 0.28.0 → 0.30.0

package/dist/threads/sessions-query.cjs

@@ -0,0 +1,235 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const DEFAULT_COLLAB_CHANNEL = "default";
+const SESSION_RUN_STATUSES = [
+  "needs_input",
+  "running",
+  "queued",
+  "scheduled",
+  "completed",
+  "failed",
+  "canceled"
+];
+const SESSION_SESSION_STATUSES = ["active", "needs_input", "idle", "error"];
+const SERVER_FIELD = {
+  search: "search",
+  collabAgentIds: "collab_agent_ids",
+  collabChannelIds: "collab_channel_ids",
+  startChannels: "start_channels",
+  createdAfter: "created_after",
+  createdBefore: "created_before",
+  updatedAfter: "updated_after",
+  updatedBefore: "updated_before",
+  favoritesOnly: "favorites_only",
+  unreadOnly: "unread_only",
+  runStatuses: "run_statuses",
+  sessionStatuses: "session_statuses",
+  hasPullRequests: "has_pull_requests",
+  createdByMe: "created_by_me",
+  excludeDismissed: "exclude_dismissed",
+  excludeTriggered: "exclude_triggered",
+  sort: "sort",
+  direction: "direction"
+};
+const LEGACY_THREAD_LIST_FILTERS = /* @__PURE__ */ new Set([
+  "search",
+  "exclude_triggered",
+  "app_id",
+  "start_channel",
+  "created_after",
+  "include_pull_requests"
+]);
+function normalizeSessionsQuery(query) {
+  var _a;
+  const out = {};
+  const search = (_a = query.search) == null ? void 0 : _a.trim();
+  if (search) out.search = search;
+  const list = (values) => {
+    if (!values || values.length === 0) return void 0;
+    return [...new Set(values)].sort();
+  };
+  const collabAgentIds = list(query.collabAgentIds);
+  if (collabAgentIds) out.collabAgentIds = collabAgentIds;
+  const collabChannelIds = list(query.collabChannelIds);
+  if (collabChannelIds && collabAgentIds) out.collabChannelIds = collabChannelIds;
+  const startChannels = list(query.startChannels);
+  if (startChannels) out.startChannels = startChannels;
+  for (const bound of ["createdAfter", "createdBefore", "updatedAfter", "updatedBefore"]) {
+    const value = query[bound];
+    if (value) out[bound] = value;
+  }
+  if (query.favoritesOnly) out.favoritesOnly = true;
+  if (query.unreadOnly) out.unreadOnly = true;
+  const runStatuses = list(query.runStatuses);
+  if (runStatuses) out.runStatuses = runStatuses;
+  const sessionStatuses = list(query.sessionStatuses);
+  if (sessionStatuses) out.sessionStatuses = sessionStatuses;
+  if (query.hasPullRequests !== void 0) out.hasPullRequests = query.hasPullRequests;
+  if (query.createdByMe !== void 0) out.createdByMe = query.createdByMe;
+  if (query.excludeDismissed) out.excludeDismissed = true;
+  if (query.excludeTriggered) out.excludeTriggered = true;
+  if (query.sort && query.sort !== "updated") out.sort = query.sort;
+  if (query.direction && query.direction !== "desc") out.direction = query.direction;
+  return out;
+}
+function sessionsQueryKey(query) {
+  const normalized = normalizeSessionsQuery(query);
+  return JSON.stringify(
+    Object.keys(normalized).sort().map((key) => [key, normalized[key]])
+  );
+}
+function sessionsQueryFromKey(key) {
+  const entries = JSON.parse(key);
+  if (!Array.isArray(entries)) return {};
+  const query = {};
+  for (const entry of entries) {
+    if (Array.isArray(entry) && typeof entry[0] === "string") query[entry[0]] = entry[1];
+  }
+  return normalizeSessionsQuery(query);
+}
+function activeSessionsQueryFields(query) {
+  const normalized = normalizeSessionsQuery(query);
+  return Object.keys(SERVER_FIELD).filter(
+    (field) => normalized[field] !== void 0
+  );
+}
+function unavailableSessionsQueryFields(options) {
+  const supported = options.supportedFilters ?? LEGACY_THREAD_LIST_FILTERS;
+  const testable = {
+    includePullRequests: options.includePullRequests,
+    rowsCarryCreatedByMe: options.supportedFilters !== null
+  };
+  return Object.keys(SERVER_FIELD).filter(
+    (field) => field !== "sort" && field !== "direction" && !supported.has(SERVER_FIELD[field]) && !locallyTestable(field, testable)
+  );
+}
+function locallyTestable(field, options) {
+  switch (field) {
+    case "excludeDismissed":
+      return false;
+    case "hasPullRequests":
+      return options.includePullRequests;
+    case "createdByMe":
+      return options.rowsCarryCreatedByMe;
+    default:
+      return true;
+  }
+}
+function planSessionsQuery(query, options) {
+  const normalized = normalizeSessionsQuery(query);
+  const supported = options.supportedFilters ?? LEGACY_THREAD_LIST_FILTERS;
+  const rowsCarryCreatedByMe = options.supportedFilters !== null;
+  const body = {};
+  const degraded = [];
+  const unavailable = [];
+  const local = {};
+  const assignLocal = (field) => {
+    local[field] = normalized[field];
+  };
+  for (const field of activeSessionsQueryFields(normalized)) {
+    const serverField = SERVER_FIELD[field];
+    if (supported.has(serverField)) {
+      Object.assign(body, { [serverField]: normalized[field] });
+      if (field !== "search" && locallyTestable(field, {
+        includePullRequests: options.includePullRequests,
+        rowsCarryCreatedByMe
+      })) {
+        assignLocal(field);
+      }
+      continue;
+    }
+    if (field === "sort" || field === "direction") {
+      degraded.push(field);
+      assignLocal(field);
+      continue;
+    }
+    if (locallyTestable(field, {
+      includePullRequests: options.includePullRequests,
+      rowsCarryCreatedByMe
+    })) {
+      degraded.push(field);
+      assignLocal(field);
+    } else {
+      unavailable.push(field);
+    }
+  }
+  if (normalized.sort) local.sort = normalized.sort;
+  if (normalized.direction) local.direction = normalized.direction;
+  return { body, degraded, unavailable, local };
+}
+function timestamp(value) {
+  if (!value) return null;
+  const parsed = Date.parse(value);
+  return Number.isFinite(parsed) ? parsed : null;
+}
+function withinBounds(value, after, before) {
+  if (after === void 0 && before === void 0) return true;
+  const at = timestamp(value);
+  if (at === null) return false;
+  const afterMs = timestamp(after);
+  const beforeMs = timestamp(before);
+  if (afterMs !== null && at < afterMs) return false;
+  if (beforeMs !== null && at >= beforeMs) return false;
+  return true;
+}
+function matchesSessionsQuery(row, query) {
+  var _a;
+  if (query.search && !(row.title ?? "").toLowerCase().includes(query.search.toLowerCase())) {
+    return false;
+  }
+  if (query.collabAgentIds && !query.collabAgentIds.includes(row.collabAgentId ?? "")) return false;
+  if (query.collabChannelIds) {
+    const channel = row.collabChannelId || DEFAULT_COLLAB_CHANNEL;
+    if (!query.collabChannelIds.includes(channel)) return false;
+  }
+  if (query.startChannels && !query.startChannels.includes(row.sourceChannel ?? "")) return false;
+  if (!withinBounds(row.createdAt, query.createdAfter, query.createdBefore)) return false;
+  if (!withinBounds(row.updatedAt, query.updatedAfter, query.updatedBefore)) return false;
+  if (query.favoritesOnly && row.isFavorited !== true) return false;
+  if (query.unreadOnly && !row.isUnread) return false;
+  if (query.runStatuses && !query.runStatuses.includes(row.runStatus ?? "")) {
+    return false;
+  }
+  if (query.sessionStatuses && !query.sessionStatuses.includes(row.sessionStatus ?? "")) {
+    return false;
+  }
+  if (query.hasPullRequests !== void 0 && row.pullRequests !== void 0 && row.pullRequests !== null) {
+    if (query.hasPullRequests !== row.pullRequests.length > 0) return false;
+  }
+  if (query.createdByMe !== void 0 && row.createdByMe !== void 0) {
+    if (query.createdByMe !== row.createdByMe) return false;
+  }
+  if (query.excludeTriggered) {
+    const trigger = ((_a = row.triggerType) == null ? void 0 : _a.trim().toLowerCase()) ?? "";
+    if (trigger && trigger !== "manual") return false;
+  }
+  return true;
+}
+function sortSessions(rows, query) {
+  const key = query.sort === "created" ? "createdAt" : "updatedAt";
+  const sign = query.direction === "asc" ? 1 : -1;
+  return rows.map((row, index) => ({ row, index, at: timestamp(row[key]) })).sort((a, b) => {
+    if (a.at === null || b.at === null) {
+      if (a.at === b.at) return a.index - b.index;
+      return a.at === null ? 1 : -1;
+    }
+    return (a.at - b.at) * sign || a.index - b.index;
+  }).map(({ row }) => row);
+}
+function supportedFiltersFromResponse(supported) {
+  return Array.isArray(supported) ? new Set(supported) : null;
+}
+exports.DEFAULT_COLLAB_CHANNEL = DEFAULT_COLLAB_CHANNEL;
+exports.LEGACY_THREAD_LIST_FILTERS = LEGACY_THREAD_LIST_FILTERS;
+exports.SESSION_RUN_STATUSES = SESSION_RUN_STATUSES;
+exports.SESSION_SESSION_STATUSES = SESSION_SESSION_STATUSES;
+exports.activeSessionsQueryFields = activeSessionsQueryFields;
+exports.matchesSessionsQuery = matchesSessionsQuery;
+exports.normalizeSessionsQuery = normalizeSessionsQuery;
+exports.planSessionsQuery = planSessionsQuery;
+exports.sessionsQueryFromKey = sessionsQueryFromKey;
+exports.sessionsQueryKey = sessionsQueryKey;
+exports.sortSessions = sortSessions;
+exports.supportedFiltersFromResponse = supportedFiltersFromResponse;
+exports.unavailableSessionsQueryFields = unavailableSessionsQueryFields;
+//# sourceMappingURL=sessions-query.cjs.map

package/dist/threads/sessions-query.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions-query.cjs","sources":["../../src/threads/sessions-query.ts"],"sourcesContent":["/**\n * The session-list query behind `SessionsPage` and `Inbox`: what the person\n * asked to see, how it maps onto `POST /api/conversations/threads/list`, and\n * what happens on a server that cannot apply part of it.\n *\n * Every filter is applied by the server as a predicate of its one page\n * statement, so a page is exact and `Load more` continues the filtered set.\n * The server ignores request fields it does not know, so a filter an older\n * agora cannot apply comes back unapplied; the list response names the fields\n * the server applies (`supported_filters`). `planSessionsQuery` splits a query\n * into what to send, what to apply to the loaded rows instead (`degraded`:\n * exact per loaded page, but a page may come back short), and what cannot be\n * applied at all on that server (`unavailable`: the UI disables those\n * controls).\n */\nimport type { ConversationSummary } from '@athenaintel/agent-runtime';\nimport type { ThreadListFilterBody } from './api';\n\nexport type AthenaSessionsSort = 'updated' | 'created';\nexport type AthenaSessionsDirection = 'desc' | 'asc';\n\n/** The collab-channel token for an agent's default channel (sessions with no channel stamp). */\nexport const DEFAULT_COLLAB_CHANNEL = 'default';\n\n/** status_v2 run statuses, in the order a status filter offers them. */\nexport const SESSION_RUN_STATUSES = [\n  'needs_input',\n  'running',\n  'queued',\n  'scheduled',\n  'completed',\n  'failed',\n  'canceled',\n] as const;\nexport type SessionRunStatus = (typeof SESSION_RUN_STATUSES)[number];\n\n/** status_v2 session statuses. */\nexport const SESSION_SESSION_STATUSES = ['active', 'needs_input', 'idle', 'error'] as const;\nexport type SessionSessionStatus = (typeof SESSION_SESSION_STATUSES)[number];\n\n/**\n * What a session list shows. Multi-value fields match any of their values;\n * different fields combine (AND). Unset fields do not filter.\n */\nexport interface AthenaSessionsQuery {\n  /** Case-insensitive title search. */\n  search?: string;\n  /** Collab agents the session started as. */\n  collabAgentIds?: readonly string[];\n  /** Agent channels (modes); `DEFAULT_COLLAB_CHANNEL` is the agent's default channel. Needs `collabAgentIds`. */\n  collabChannelIds?: readonly string[];\n  /** Channels the session started from (`web`, `github`, `email`, …). */\n  startChannels?: readonly string[];\n  /** ISO 8601 bounds; `*After` inclusive, `*Before` exclusive. */\n  createdAfter?: string;\n  createdBefore?: string;\n  updatedAfter?: string;\n  updatedBefore?: string;\n  /** Only sessions the viewer pinned. */\n  favoritesOnly?: boolean;\n  /** Only sessions the viewer has not read since they last changed. */\n  unreadOnly?: boolean;\n  /** status_v2 run statuses (`running` excludes runs silent for 12 hours, as every list does). */\n  runStatuses?: readonly SessionRunStatus[];\n  /** status_v2 session statuses. */\n  sessionStatuses?: readonly SessionSessionStatus[];\n  /** `true` only sessions that opened a pull request; `false` only those that opened none. */\n  hasPullRequests?: boolean;\n  /** `true` only the viewer's own sessions; `false` only sessions shared with them. */\n  createdByMe?: boolean;\n  /** Leave out sessions dismissed from the inbox. */\n  excludeDismissed?: boolean;\n  /** Hide sessions started by an automation (a schedule, an email, …). */\n  excludeTriggered?: boolean;\n  /** Sort key (default `updated`). */\n  sort?: AthenaSessionsSort;\n  /** Sort direction (default `desc`, newest first). */\n  direction?: AthenaSessionsDirection;\n}\n\nexport type AthenaSessionsQueryField = keyof AthenaSessionsQuery;\n\n/** The REST field each query field travels as. */\nconst SERVER_FIELD: Record<AthenaSessionsQueryField, string> = {\n  search: 'search',\n  collabAgentIds: 'collab_agent_ids',\n  collabChannelIds: 'collab_channel_ids',\n  startChannels: 'start_channels',\n  createdAfter: 'created_after',\n  createdBefore: 'created_before',\n  updatedAfter: 'updated_after',\n  updatedBefore: 'updated_before',\n  favoritesOnly: 'favorites_only',\n  unreadOnly: 'unread_only',\n  runStatuses: 'run_statuses',\n  sessionStatuses: 'session_statuses',\n  hasPullRequests: 'has_pull_requests',\n  createdByMe: 'created_by_me',\n  excludeDismissed: 'exclude_dismissed',\n  excludeTriggered: 'exclude_triggered',\n  sort: 'sort',\n  direction: 'direction',\n};\n\n/**\n * The fields every thread-list server has applied, including those that\n * predate `supported_filters` — what a response without the list supports.\n */\nexport const LEGACY_THREAD_LIST_FILTERS: ReadonlySet<string> = new Set([\n  'search',\n  'exclude_triggered',\n  'app_id',\n  'start_channel',\n  'created_after',\n  'include_pull_requests',\n]);\n\n/** The query with unset, empty and default-valued fields dropped and arrays canonicalized. */\nexport function normalizeSessionsQuery(query: AthenaSessionsQuery): AthenaSessionsQuery {\n  const out: AthenaSessionsQuery = {};\n  const search = query.search?.trim();\n  if (search) out.search = search;\n  const list = <T extends string>(values: readonly T[] | undefined): T[] | undefined => {\n    if (!values || values.length === 0) return undefined;\n    return [...new Set(values)].sort();\n  };\n  const collabAgentIds = list(query.collabAgentIds);\n  if (collabAgentIds) out.collabAgentIds = collabAgentIds;\n  const collabChannelIds = list(query.collabChannelIds);\n  if (collabChannelIds && collabAgentIds) out.collabChannelIds = collabChannelIds;\n  const startChannels = list(query.startChannels);\n  if (startChannels) out.startChannels = startChannels;\n  for (const bound of ['createdAfter', 'createdBefore', 'updatedAfter', 'updatedBefore'] as const) {\n    const value = query[bound];\n    if (value) out[bound] = value;\n  }\n  if (query.favoritesOnly) out.favoritesOnly = true;\n  if (query.unreadOnly) out.unreadOnly = true;\n  const runStatuses = list(query.runStatuses);\n  if (runStatuses) out.runStatuses = runStatuses;\n  const sessionStatuses = list(query.sessionStatuses);\n  if (sessionStatuses) out.sessionStatuses = sessionStatuses;\n  if (query.hasPullRequests !== undefined) out.hasPullRequests = query.hasPullRequests;\n  if (query.createdByMe !== undefined) out.createdByMe = query.createdByMe;\n  if (query.excludeDismissed) out.excludeDismissed = true;\n  if (query.excludeTriggered) out.excludeTriggered = true;\n  if (query.sort && query.sort !== 'updated') out.sort = query.sort;\n  if (query.direction && query.direction !== 'desc') out.direction = query.direction;\n  return out;\n}\n\n/** A stable cache identity: semantically equal queries share one key. */\nexport function sessionsQueryKey(query: AthenaSessionsQuery): string {\n  const normalized = normalizeSessionsQuery(query) as Record<string, unknown>;\n  return JSON.stringify(\n    Object.keys(normalized)\n      .sort()\n      .map((key) => [key, normalized[key]]),\n  );\n}\n\n/** The normalized query a `sessionsQueryKey` stands for. */\nexport function sessionsQueryFromKey(key: string): AthenaSessionsQuery {\n  const entries: unknown = JSON.parse(key);\n  if (!Array.isArray(entries)) return {};\n  const query: Record<string, unknown> = {};\n  for (const entry of entries) {\n    if (Array.isArray(entry) && typeof entry[0] === 'string') query[entry[0]] = entry[1];\n  }\n  return normalizeSessionsQuery(query as AthenaSessionsQuery);\n}\n\n/** The fields a query sets (after normalization), in a fixed order. */\nexport function activeSessionsQueryFields(query: AthenaSessionsQuery): AthenaSessionsQueryField[] {\n  const normalized = normalizeSessionsQuery(query);\n  return (Object.keys(SERVER_FIELD) as AthenaSessionsQueryField[]).filter(\n    (field) => normalized[field] !== undefined,\n  );\n}\n\n/**\n * Every query field a backend can apply nowhere — what a filter UI disables\n * whatever is selected. `supportedFilters` as for `planSessionsQuery`.\n */\nexport function unavailableSessionsQueryFields(options: {\n  supportedFilters: ReadonlySet<string> | null;\n  includePullRequests: boolean;\n}): AthenaSessionsQueryField[] {\n  const supported = options.supportedFilters ?? LEGACY_THREAD_LIST_FILTERS;\n  const testable = {\n    includePullRequests: options.includePullRequests,\n    rowsCarryCreatedByMe: options.supportedFilters !== null,\n  };\n  return (Object.keys(SERVER_FIELD) as AthenaSessionsQueryField[]).filter(\n    (field) =>\n      field !== 'sort' &&\n      field !== 'direction' &&\n      !supported.has(SERVER_FIELD[field]) &&\n      !locallyTestable(field, testable),\n  );\n}\n\nexport interface SessionsQueryPlan {\n  /** Sent to the server (`search` / `exclude_triggered` and `ThreadListFilterBody`). */\n  body: ThreadListFilterBody;\n  /** Applied to the loaded rows because the server cannot: exact per page, pages may be short. */\n  degraded: AthenaSessionsQueryField[];\n  /** Cannot be applied on this server at all (the rows carry nothing to test). */\n  unavailable: AthenaSessionsQueryField[];\n  /** The part of the query the loaded rows are checked against (`matchesSessionsQuery`). */\n  local: AthenaSessionsQuery;\n}\n\n/**\n * Which fields a row can be tested on locally, given what this list fetches:\n * pull-request state only rides rows when the list asked for it, and\n * `createdByMe` only on servers new enough to send it.\n */\nfunction locallyTestable(\n  field: AthenaSessionsQueryField,\n  options: { includePullRequests: boolean; rowsCarryCreatedByMe: boolean },\n): boolean {\n  switch (field) {\n    case 'excludeDismissed':\n      return false;\n    case 'hasPullRequests':\n      return options.includePullRequests;\n    case 'createdByMe':\n      return options.rowsCarryCreatedByMe;\n    default:\n      return true;\n  }\n}\n\n/**\n * Split a query for one server. `supportedFilters` is the server's\n * `supported_filters` (`null` for a server that predates it: only\n * `LEGACY_THREAD_LIST_FILTERS` apply there).\n */\nexport function planSessionsQuery(\n  query: AthenaSessionsQuery,\n  options: { supportedFilters: ReadonlySet<string> | null; includePullRequests: boolean },\n): SessionsQueryPlan {\n  const normalized = normalizeSessionsQuery(query);\n  const supported = options.supportedFilters ?? LEGACY_THREAD_LIST_FILTERS;\n  // A server that echoes `supported_filters` also sends `created_by_me` on rows.\n  const rowsCarryCreatedByMe = options.supportedFilters !== null;\n  const body: SessionsQueryPlan['body'] = {};\n  const degraded: AthenaSessionsQueryField[] = [];\n  const unavailable: AthenaSessionsQueryField[] = [];\n  const local: AthenaSessionsQuery = {};\n  const assignLocal = <K extends AthenaSessionsQueryField>(field: K) => {\n    local[field] = normalized[field];\n  };\n  for (const field of activeSessionsQueryFields(normalized)) {\n    const serverField = SERVER_FIELD[field];\n    if (supported.has(serverField)) {\n      Object.assign(body, { [serverField]: normalized[field] });\n      // Server-applied fields are still checked on the loaded rows, so a row\n      // a live push changed (read, unpinned, finished) leaves a view it no\n      // longer matches; the server already guaranteed the fetched page. The\n      // title search is not: the server matches the stored title, while a\n      // row shows a display title that may come from its last message.\n      if (\n        field !== 'search' &&\n        locallyTestable(field, {\n          includePullRequests: options.includePullRequests,\n          rowsCarryCreatedByMe,\n        })\n      ) {\n        assignLocal(field);\n      }\n      continue;\n    }\n    if (field === 'sort' || field === 'direction') {\n      // Sorting the loaded rows is always possible; it is degraded only in\n      // that older pages arrived in the server's default order.\n      degraded.push(field);\n      assignLocal(field);\n      continue;\n    }\n    if (\n      locallyTestable(field, {\n        includePullRequests: options.includePullRequests,\n        rowsCarryCreatedByMe,\n      })\n    ) {\n      degraded.push(field);\n      assignLocal(field);\n    } else {\n      unavailable.push(field);\n    }\n  }\n  // Sort/direction also order the loaded rows when the server applied them,\n  // so a live update keeps its place.\n  if (normalized.sort) local.sort = normalized.sort;\n  if (normalized.direction) local.direction = normalized.direction;\n  return { body, degraded, unavailable, local };\n}\n\nfunction timestamp(value: string | null | undefined): number | null {\n  if (!value) return null;\n  const parsed = Date.parse(value);\n  return Number.isFinite(parsed) ? parsed : null;\n}\n\nfunction withinBounds(\n  value: string | null | undefined,\n  after: string | undefined,\n  before: string | undefined,\n): boolean {\n  if (after === undefined && before === undefined) return true;\n  const at = timestamp(value);\n  if (at === null) return false;\n  const afterMs = timestamp(after);\n  const beforeMs = timestamp(before);\n  if (afterMs !== null && at < afterMs) return false;\n  if (beforeMs !== null && at >= beforeMs) return false;\n  return true;\n}\n\n/** The fields of a row `matchesSessionsQuery` reads. */\nexport type SessionsQueryRow = Pick<\n  ConversationSummary,\n  | 'title'\n  | 'updatedAt'\n  | 'createdAt'\n  | 'sourceChannel'\n  | 'triggerType'\n  | 'isUnread'\n  | 'isFavorited'\n  | 'runStatus'\n  | 'sessionStatus'\n  | 'collabAgentId'\n  | 'collabChannelId'\n  | 'pullRequests'\n  | 'createdByMe'\n>;\n\n/**\n * Whether a loaded row matches the locally applicable part of a query\n * (`SessionsQueryPlan.local`). Fields the row does not carry pass, so a\n * missing value never hides a row the server returned.\n */\nexport function matchesSessionsQuery(row: SessionsQueryRow, query: AthenaSessionsQuery): boolean {\n  if (query.search && !(row.title ?? '').toLowerCase().includes(query.search.toLowerCase())) {\n    return false;\n  }\n  if (query.collabAgentIds && !query.collabAgentIds.includes(row.collabAgentId ?? '')) return false;\n  if (query.collabChannelIds) {\n    const channel = row.collabChannelId || DEFAULT_COLLAB_CHANNEL;\n    if (!query.collabChannelIds.includes(channel)) return false;\n  }\n  if (query.startChannels && !query.startChannels.includes(row.sourceChannel ?? '')) return false;\n  if (!withinBounds(row.createdAt, query.createdAfter, query.createdBefore)) return false;\n  if (!withinBounds(row.updatedAt, query.updatedAfter, query.updatedBefore)) return false;\n  if (query.favoritesOnly && row.isFavorited !== true) return false;\n  if (query.unreadOnly && !row.isUnread) return false;\n  if (query.runStatuses && !(query.runStatuses as readonly string[]).includes(row.runStatus ?? '')) {\n    return false;\n  }\n  if (\n    query.sessionStatuses &&\n    !(query.sessionStatuses as readonly string[]).includes(row.sessionStatus ?? '')\n  ) {\n    return false;\n  }\n  if (query.hasPullRequests !== undefined && row.pullRequests !== undefined && row.pullRequests !== null) {\n    if (query.hasPullRequests !== row.pullRequests.length > 0) return false;\n  }\n  if (query.createdByMe !== undefined && row.createdByMe !== undefined) {\n    if (query.createdByMe !== row.createdByMe) return false;\n  }\n  if (query.excludeTriggered) {\n    const trigger = row.triggerType?.trim().toLowerCase() ?? '';\n    if (trigger && trigger !== 'manual') return false;\n  }\n  return true;\n}\n\n/** Rows in the query's order (stable; unparseable times last). */\nexport function sortSessions<T extends Pick<ConversationSummary, 'updatedAt' | 'createdAt'>>(\n  rows: readonly T[],\n  query: Pick<AthenaSessionsQuery, 'sort' | 'direction'>,\n): T[] {\n  const key = query.sort === 'created' ? 'createdAt' : 'updatedAt';\n  const sign = query.direction === 'asc' ? 1 : -1;\n  return rows\n    .map((row, index) => ({ row, index, at: timestamp(row[key]) }))\n    .sort((a, b) => {\n      if (a.at === null || b.at === null) {\n        if (a.at === b.at) return a.index - b.index;\n        return a.at === null ? 1 : -1;\n      }\n      return (a.at - b.at) * sign || a.index - b.index;\n    })\n    .map(({ row }) => row);\n}\n\n/** The server fields a response says it applies, or `null` when it predates the list. */\nexport function supportedFiltersFromResponse(\n  supported: readonly string[] | undefined,\n): ReadonlySet<string> | null {\n  return Array.isArray(supported) ? new Set(supported) : null;\n}\n"],"names":[],"mappings":"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"}

package/dist/threads/sessions-query.d.ts

@@ -0,0 +1,119 @@
+/**
+ * The session-list query behind `SessionsPage` and `Inbox`: what the person
+ * asked to see, how it maps onto `POST /api/conversations/threads/list`, and
+ * what happens on a server that cannot apply part of it.
+ *
+ * Every filter is applied by the server as a predicate of its one page
+ * statement, so a page is exact and `Load more` continues the filtered set.
+ * The server ignores request fields it does not know, so a filter an older
+ * agora cannot apply comes back unapplied; the list response names the fields
+ * the server applies (`supported_filters`). `planSessionsQuery` splits a query
+ * into what to send, what to apply to the loaded rows instead (`degraded`:
+ * exact per loaded page, but a page may come back short), and what cannot be
+ * applied at all on that server (`unavailable`: the UI disables those
+ * controls).
+ */
+import type { ConversationSummary } from '@athenaintel/agent-runtime';
+import type { ThreadListFilterBody } from './api';
+export type AthenaSessionsSort = 'updated' | 'created';
+export type AthenaSessionsDirection = 'desc' | 'asc';
+/** The collab-channel token for an agent's default channel (sessions with no channel stamp). */
+export declare const DEFAULT_COLLAB_CHANNEL = "default";
+/** status_v2 run statuses, in the order a status filter offers them. */
+export declare const SESSION_RUN_STATUSES: readonly ['needs_input', 'running', 'queued', 'scheduled', 'completed', 'failed', 'canceled'];
+export type SessionRunStatus = (typeof SESSION_RUN_STATUSES)[number];
+/** status_v2 session statuses. */
+export declare const SESSION_SESSION_STATUSES: readonly ['active', 'needs_input', 'idle', 'error'];
+export type SessionSessionStatus = (typeof SESSION_SESSION_STATUSES)[number];
+/**
+ * What a session list shows. Multi-value fields match any of their values;
+ * different fields combine (AND). Unset fields do not filter.
+ */
+export interface AthenaSessionsQuery {
+    /** Case-insensitive title search. */
+    search?: string;
+    /** Collab agents the session started as. */
+    collabAgentIds?: readonly string[];
+    /** Agent channels (modes); `DEFAULT_COLLAB_CHANNEL` is the agent's default channel. Needs `collabAgentIds`. */
+    collabChannelIds?: readonly string[];
+    /** Channels the session started from (`web`, `github`, `email`, …). */
+    startChannels?: readonly string[];
+    /** ISO 8601 bounds; `*After` inclusive, `*Before` exclusive. */
+    createdAfter?: string;
+    createdBefore?: string;
+    updatedAfter?: string;
+    updatedBefore?: string;
+    /** Only sessions the viewer pinned. */
+    favoritesOnly?: boolean;
+    /** Only sessions the viewer has not read since they last changed. */
+    unreadOnly?: boolean;
+    /** status_v2 run statuses (`running` excludes runs silent for 12 hours, as every list does). */
+    runStatuses?: readonly SessionRunStatus[];
+    /** status_v2 session statuses. */
+    sessionStatuses?: readonly SessionSessionStatus[];
+    /** `true` only sessions that opened a pull request; `false` only those that opened none. */
+    hasPullRequests?: boolean;
+    /** `true` only the viewer's own sessions; `false` only sessions shared with them. */
+    createdByMe?: boolean;
+    /** Leave out sessions dismissed from the inbox. */
+    excludeDismissed?: boolean;
+    /** Hide sessions started by an automation (a schedule, an email, …). */
+    excludeTriggered?: boolean;
+    /** Sort key (default `updated`). */
+    sort?: AthenaSessionsSort;
+    /** Sort direction (default `desc`, newest first). */
+    direction?: AthenaSessionsDirection;
+}
+export type AthenaSessionsQueryField = keyof AthenaSessionsQuery;
+/**
+ * The fields every thread-list server has applied, including those that
+ * predate `supported_filters` — what a response without the list supports.
+ */
+export declare const LEGACY_THREAD_LIST_FILTERS: ReadonlySet<string>;
+/** The query with unset, empty and default-valued fields dropped and arrays canonicalized. */
+export declare function normalizeSessionsQuery(query: AthenaSessionsQuery): AthenaSessionsQuery;
+/** A stable cache identity: semantically equal queries share one key. */
+export declare function sessionsQueryKey(query: AthenaSessionsQuery): string;
+/** The normalized query a `sessionsQueryKey` stands for. */
+export declare function sessionsQueryFromKey(key: string): AthenaSessionsQuery;
+/** The fields a query sets (after normalization), in a fixed order. */
+export declare function activeSessionsQueryFields(query: AthenaSessionsQuery): AthenaSessionsQueryField[];
+/**
+ * Every query field a backend can apply nowhere — what a filter UI disables
+ * whatever is selected. `supportedFilters` as for `planSessionsQuery`.
+ */
+export declare function unavailableSessionsQueryFields(options: {
+    supportedFilters: ReadonlySet<string> | null;
+    includePullRequests: boolean;
+}): AthenaSessionsQueryField[];
+export interface SessionsQueryPlan {
+    /** Sent to the server (`search` / `exclude_triggered` and `ThreadListFilterBody`). */
+    body: ThreadListFilterBody;
+    /** Applied to the loaded rows because the server cannot: exact per page, pages may be short. */
+    degraded: AthenaSessionsQueryField[];
+    /** Cannot be applied on this server at all (the rows carry nothing to test). */
+    unavailable: AthenaSessionsQueryField[];
+    /** The part of the query the loaded rows are checked against (`matchesSessionsQuery`). */
+    local: AthenaSessionsQuery;
+}
+/**
+ * Split a query for one server. `supportedFilters` is the server's
+ * `supported_filters` (`null` for a server that predates it: only
+ * `LEGACY_THREAD_LIST_FILTERS` apply there).
+ */
+export declare function planSessionsQuery(query: AthenaSessionsQuery, options: {
+    supportedFilters: ReadonlySet<string> | null;
+    includePullRequests: boolean;
+}): SessionsQueryPlan;
+/** The fields of a row `matchesSessionsQuery` reads. */
+export type SessionsQueryRow = Pick<ConversationSummary, 'title' | 'updatedAt' | 'createdAt' | 'sourceChannel' | 'triggerType' | 'isUnread' | 'isFavorited' | 'runStatus' | 'sessionStatus' | 'collabAgentId' | 'collabChannelId' | 'pullRequests' | 'createdByMe'>;
+/**
+ * Whether a loaded row matches the locally applicable part of a query
+ * (`SessionsQueryPlan.local`). Fields the row does not carry pass, so a
+ * missing value never hides a row the server returned.
+ */
+export declare function matchesSessionsQuery(row: SessionsQueryRow, query: AthenaSessionsQuery): boolean;
+/** Rows in the query's order (stable; unparseable times last). */
+export declare function sortSessions<T extends Pick<ConversationSummary, 'updatedAt' | 'createdAt'>>(rows: readonly T[], query: Pick<AthenaSessionsQuery, 'sort' | 'direction'>): T[];
+/** The server fields a response says it applies, or `null` when it predates the list. */
+export declare function supportedFiltersFromResponse(supported: readonly string[] | undefined): ReadonlySet<string> | null;

package/dist/threads/sessions-query.js

@@ -0,0 +1,235 @@
+const DEFAULT_COLLAB_CHANNEL = "default";
+const SESSION_RUN_STATUSES = [
+  "needs_input",
+  "running",
+  "queued",
+  "scheduled",
+  "completed",
+  "failed",
+  "canceled"
+];
+const SESSION_SESSION_STATUSES = ["active", "needs_input", "idle", "error"];
+const SERVER_FIELD = {
+  search: "search",
+  collabAgentIds: "collab_agent_ids",
+  collabChannelIds: "collab_channel_ids",
+  startChannels: "start_channels",
+  createdAfter: "created_after",
+  createdBefore: "created_before",
+  updatedAfter: "updated_after",
+  updatedBefore: "updated_before",
+  favoritesOnly: "favorites_only",
+  unreadOnly: "unread_only",
+  runStatuses: "run_statuses",
+  sessionStatuses: "session_statuses",
+  hasPullRequests: "has_pull_requests",
+  createdByMe: "created_by_me",
+  excludeDismissed: "exclude_dismissed",
+  excludeTriggered: "exclude_triggered",
+  sort: "sort",
+  direction: "direction"
+};
+const LEGACY_THREAD_LIST_FILTERS = /* @__PURE__ */ new Set([
+  "search",
+  "exclude_triggered",
+  "app_id",
+  "start_channel",
+  "created_after",
+  "include_pull_requests"
+]);
+function normalizeSessionsQuery(query) {
+  var _a;
+  const out = {};
+  const search = (_a = query.search) == null ? void 0 : _a.trim();
+  if (search) out.search = search;
+  const list = (values) => {
+    if (!values || values.length === 0) return void 0;
+    return [...new Set(values)].sort();
+  };
+  const collabAgentIds = list(query.collabAgentIds);
+  if (collabAgentIds) out.collabAgentIds = collabAgentIds;
+  const collabChannelIds = list(query.collabChannelIds);
+  if (collabChannelIds && collabAgentIds) out.collabChannelIds = collabChannelIds;
+  const startChannels = list(query.startChannels);
+  if (startChannels) out.startChannels = startChannels;
+  for (const bound of ["createdAfter", "createdBefore", "updatedAfter", "updatedBefore"]) {
+    const value = query[bound];
+    if (value) out[bound] = value;
+  }
+  if (query.favoritesOnly) out.favoritesOnly = true;
+  if (query.unreadOnly) out.unreadOnly = true;
+  const runStatuses = list(query.runStatuses);
+  if (runStatuses) out.runStatuses = runStatuses;
+  const sessionStatuses = list(query.sessionStatuses);
+  if (sessionStatuses) out.sessionStatuses = sessionStatuses;
+  if (query.hasPullRequests !== void 0) out.hasPullRequests = query.hasPullRequests;
+  if (query.createdByMe !== void 0) out.createdByMe = query.createdByMe;
+  if (query.excludeDismissed) out.excludeDismissed = true;
+  if (query.excludeTriggered) out.excludeTriggered = true;
+  if (query.sort && query.sort !== "updated") out.sort = query.sort;
+  if (query.direction && query.direction !== "desc") out.direction = query.direction;
+  return out;
+}
+function sessionsQueryKey(query) {
+  const normalized = normalizeSessionsQuery(query);
+  return JSON.stringify(
+    Object.keys(normalized).sort().map((key) => [key, normalized[key]])
+  );
+}
+function sessionsQueryFromKey(key) {
+  const entries = JSON.parse(key);
+  if (!Array.isArray(entries)) return {};
+  const query = {};
+  for (const entry of entries) {
+    if (Array.isArray(entry) && typeof entry[0] === "string") query[entry[0]] = entry[1];
+  }
+  return normalizeSessionsQuery(query);
+}
+function activeSessionsQueryFields(query) {
+  const normalized = normalizeSessionsQuery(query);
+  return Object.keys(SERVER_FIELD).filter(
+    (field) => normalized[field] !== void 0
+  );
+}
+function unavailableSessionsQueryFields(options) {
+  const supported = options.supportedFilters ?? LEGACY_THREAD_LIST_FILTERS;
+  const testable = {
+    includePullRequests: options.includePullRequests,
+    rowsCarryCreatedByMe: options.supportedFilters !== null
+  };
+  return Object.keys(SERVER_FIELD).filter(
+    (field) => field !== "sort" && field !== "direction" && !supported.has(SERVER_FIELD[field]) && !locallyTestable(field, testable)
+  );
+}
+function locallyTestable(field, options) {
+  switch (field) {
+    case "excludeDismissed":
+      return false;
+    case "hasPullRequests":
+      return options.includePullRequests;
+    case "createdByMe":
+      return options.rowsCarryCreatedByMe;
+    default:
+      return true;
+  }
+}
+function planSessionsQuery(query, options) {
+  const normalized = normalizeSessionsQuery(query);
+  const supported = options.supportedFilters ?? LEGACY_THREAD_LIST_FILTERS;
+  const rowsCarryCreatedByMe = options.supportedFilters !== null;
+  const body = {};
+  const degraded = [];
+  const unavailable = [];
+  const local = {};
+  const assignLocal = (field) => {
+    local[field] = normalized[field];
+  };
+  for (const field of activeSessionsQueryFields(normalized)) {
+    const serverField = SERVER_FIELD[field];
+    if (supported.has(serverField)) {
+      Object.assign(body, { [serverField]: normalized[field] });
+      if (field !== "search" && locallyTestable(field, {
+        includePullRequests: options.includePullRequests,
+        rowsCarryCreatedByMe
+      })) {
+        assignLocal(field);
+      }
+      continue;
+    }
+    if (field === "sort" || field === "direction") {
+      degraded.push(field);
+      assignLocal(field);
+      continue;
+    }
+    if (locallyTestable(field, {
+      includePullRequests: options.includePullRequests,
+      rowsCarryCreatedByMe
+    })) {
+      degraded.push(field);
+      assignLocal(field);
+    } else {
+      unavailable.push(field);
+    }
+  }
+  if (normalized.sort) local.sort = normalized.sort;
+  if (normalized.direction) local.direction = normalized.direction;
+  return { body, degraded, unavailable, local };
+}
+function timestamp(value) {
+  if (!value) return null;
+  const parsed = Date.parse(value);
+  return Number.isFinite(parsed) ? parsed : null;
+}
+function withinBounds(value, after, before) {
+  if (after === void 0 && before === void 0) return true;
+  const at = timestamp(value);
+  if (at === null) return false;
+  const afterMs = timestamp(after);
+  const beforeMs = timestamp(before);
+  if (afterMs !== null && at < afterMs) return false;
+  if (beforeMs !== null && at >= beforeMs) return false;
+  return true;
+}
+function matchesSessionsQuery(row, query) {
+  var _a;
+  if (query.search && !(row.title ?? "").toLowerCase().includes(query.search.toLowerCase())) {
+    return false;
+  }
+  if (query.collabAgentIds && !query.collabAgentIds.includes(row.collabAgentId ?? "")) return false;
+  if (query.collabChannelIds) {
+    const channel = row.collabChannelId || DEFAULT_COLLAB_CHANNEL;
+    if (!query.collabChannelIds.includes(channel)) return false;
+  }
+  if (query.startChannels && !query.startChannels.includes(row.sourceChannel ?? "")) return false;
+  if (!withinBounds(row.createdAt, query.createdAfter, query.createdBefore)) return false;
+  if (!withinBounds(row.updatedAt, query.updatedAfter, query.updatedBefore)) return false;
+  if (query.favoritesOnly && row.isFavorited !== true) return false;
+  if (query.unreadOnly && !row.isUnread) return false;
+  if (query.runStatuses && !query.runStatuses.includes(row.runStatus ?? "")) {
+    return false;
+  }
+  if (query.sessionStatuses && !query.sessionStatuses.includes(row.sessionStatus ?? "")) {
+    return false;
+  }
+  if (query.hasPullRequests !== void 0 && row.pullRequests !== void 0 && row.pullRequests !== null) {
+    if (query.hasPullRequests !== row.pullRequests.length > 0) return false;
+  }
+  if (query.createdByMe !== void 0 && row.createdByMe !== void 0) {
+    if (query.createdByMe !== row.createdByMe) return false;
+  }
+  if (query.excludeTriggered) {
+    const trigger = ((_a = row.triggerType) == null ? void 0 : _a.trim().toLowerCase()) ?? "";
+    if (trigger && trigger !== "manual") return false;
+  }
+  return true;
+}
+function sortSessions(rows, query) {
+  const key = query.sort === "created" ? "createdAt" : "updatedAt";
+  const sign = query.direction === "asc" ? 1 : -1;
+  return rows.map((row, index) => ({ row, index, at: timestamp(row[key]) })).sort((a, b) => {
+    if (a.at === null || b.at === null) {
+      if (a.at === b.at) return a.index - b.index;
+      return a.at === null ? 1 : -1;
+    }
+    return (a.at - b.at) * sign || a.index - b.index;
+  }).map(({ row }) => row);
+}
+function supportedFiltersFromResponse(supported) {
+  return Array.isArray(supported) ? new Set(supported) : null;
+}
+export {
+  DEFAULT_COLLAB_CHANNEL,
+  LEGACY_THREAD_LIST_FILTERS,
+  SESSION_RUN_STATUSES,
+  SESSION_SESSION_STATUSES,
+  activeSessionsQueryFields,
+  matchesSessionsQuery,
+  normalizeSessionsQuery,
+  planSessionsQuery,
+  sessionsQueryFromKey,
+  sessionsQueryKey,
+  sortSessions,
+  supportedFiltersFromResponse,
+  unavailableSessionsQueryFields
+};
+//# sourceMappingURL=sessions-query.js.map