@opengeni/react 4.4.1 → 4.5.1-canary.39832248373001

package/dist/app/lib/composer-connectors.js

@@ -8,31 +8,31 @@ import {
   followWorkspaceConnectorPolicy,
   newSessionConnectorCustomizeState,
   sessionConnectorPolicyIsCustomized
-} from "../../chunk-X7ASQHR6.js";
-import "../../chunk-ZRJCGBVV.js";
+} from "../../chunk-IUK5QGP5.js";
+import "../../chunk-PVR5EELP.js";
 import "../../chunk-22NENBA3.js";
 import "../../chunk-L4OF77LE.js";
-import "../../chunk-4432A3HQ.js";
+import "../../chunk-A6T4FGE7.js";
 import "../../chunk-M357MHH3.js";
-import "../../chunk-L6RXRRN3.js";
+import "../../chunk-ILDOW2IQ.js";
 import "../../chunk-CUUJROYT.js";
-import "../../chunk-HRJQAFKR.js";
-import "../../chunk-R63QEVPK.js";
+import "../../chunk-AX6YJA5U.js";
+import "../../chunk-SJORXXLV.js";
 import "../../chunk-OYQQJL3J.js";
-import "../../chunk-H3LIIAGE.js";
 import "../../chunk-RZLBICR5.js";
+import "../../chunk-H3LIIAGE.js";
 import "../../chunk-VHB3E6PT.js";
 import "../../chunk-DNJ23AWQ.js";
 import "../../chunk-OB3YGXHQ.js";
 import "../../chunk-UNJPZGNK.js";
 import "../../chunk-PEHTX3V7.js";
-import "../../chunk-OBQVTCTW.js";
+import "../../chunk-ZX5H7LWD.js";
 import "../../chunk-J3BHDXQQ.js";
 import "../../chunk-XEA5BCMA.js";
 import "../../chunk-SJGAHTY5.js";
 import "../../chunk-4NHJ6EXL.js";
 import "../../chunk-TXS65BB2.js";
-import "../../chunk-5JZYPZ72.js";
+import "../../chunk-JFK7NTEA.js";
 export {
   addsConnectorOutsideDefaults,
   changedConnectorExclusions,

package/dist/app/lib/console-site.d.ts

@@ -0,0 +1,6 @@
+import type { SiteViewer } from "@opengeni/sdk";
+import type { SiteToolBridgeFactory } from "../../artifacts.js";
+/** The signed-in member as Site code sees them (`site.viewer`) in the console. */
+export declare function useConsoleSiteViewer(): SiteViewer;
+/** Console tool access for a `SiteView`, pinned to the loaded Site version. */
+export declare function useConsoleSiteToolBridge(workspaceId: string): SiteToolBridgeFactory;

package/dist/app/lib/console-site.js

@@ -0,0 +1,14 @@
+"use client";
+import {
+  useConsoleSiteToolBridge,
+  useConsoleSiteViewer
+} from "../../chunk-756MKA2J.js";
+import "../../chunk-LCRA6ZOV.js";
+import "../../chunk-L5HJ4UYB.js";
+import "../../chunk-IZUAIHR4.js";
+import "../../chunk-W6KAUGXO.js";
+export {
+  useConsoleSiteToolBridge,
+  useConsoleSiteViewer
+};
+//# sourceMappingURL=console-site.js.map

package/dist/app/lib/console-text.js

@@ -1,9 +1,9 @@
 "use client";
 import {
   t
-} from "../../chunk-HPPKLBTJ.js";
+} from "../../chunk-TJQDL3JH.js";
 import "../../chunk-A3KMTJZS.js";
-import "../../chunk-5JZYPZ72.js";
+import "../../chunk-JFK7NTEA.js";
 export {
   t
 };

package/dist/app/lib/events.js

@@ -8,36 +8,37 @@ import {
   reasoningSummaryText,
   sandboxProvisionInFlight,
   summarizeSessionFailure
-} from "../../chunk-63VGE4OH.js";
+} from "../../chunk-5HIOVXOX.js";
 import "../../chunk-IIFO2H3P.js";
-import "../../chunk-HPPKLBTJ.js";
+import "../../chunk-TJQDL3JH.js";
 import "../../chunk-A3KMTJZS.js";
-import "../../chunk-X7L4H4VG.js";
+import "../../chunk-F33EDYS7.js";
 import "../../chunk-B27E3V37.js";
-import "../../chunk-3KVWXKD6.js";
+import "../../chunk-LQ47YL6E.js";
 import "../../chunk-UD2PSIIX.js";
-import "../../chunk-5MZTJMZ3.js";
-import "../../chunk-R63QEVPK.js";
+import "../../chunk-6MRY2RUZ.js";
+import "../../chunk-SJORXXLV.js";
 import "../../chunk-OYQQJL3J.js";
-import "../../chunk-H3LIIAGE.js";
 import "../../chunk-RZLBICR5.js";
+import "../../chunk-H3LIIAGE.js";
 import "../../chunk-VHB3E6PT.js";
 import "../../chunk-YSRBFJMQ.js";
-import "../../chunk-TQGJN5UZ.js";
+import "../../chunk-AW3QEFOF.js";
 import "../../chunk-HEVQKE27.js";
-import "../../chunk-ANHUMDJX.js";
-import "../../chunk-STUCI6QA.js";
+import "../../chunk-WNDTLK44.js";
+import "../../chunk-ULYQEFNH.js";
+import "../../chunk-LEKBNKLD.js";
 import "../../chunk-DNJ23AWQ.js";
 import "../../chunk-OB3YGXHQ.js";
 import "../../chunk-UNJPZGNK.js";
 import "../../chunk-PEHTX3V7.js";
-import "../../chunk-OBQVTCTW.js";
+import "../../chunk-ZX5H7LWD.js";
 import "../../chunk-J3BHDXQQ.js";
 import "../../chunk-XEA5BCMA.js";
 import "../../chunk-SJGAHTY5.js";
 import "../../chunk-4NHJ6EXL.js";
 import "../../chunk-TXS65BB2.js";
-import "../../chunk-5JZYPZ72.js";
+import "../../chunk-JFK7NTEA.js";
 export {
   eventDisplayLabel,
   eventLabel,

package/dist/app/lib/failed-session-copy.js

@@ -2,14 +2,14 @@
 import {
   classifyProviderFailure,
   failedSessionCopy
-} from "../../chunk-HQG4SLTE.js";
+} from "../../chunk-DYJGYGPB.js";
 import "../../chunk-ILBSBZGC.js";
 import "../../chunk-PYSONAMV.js";
-import "../../chunk-HPPKLBTJ.js";
+import "../../chunk-TJQDL3JH.js";
 import "../../chunk-A3KMTJZS.js";
 import "../../chunk-CFEFYPNR.js";
 import "../../chunk-4NHJ6EXL.js";
-import "../../chunk-5JZYPZ72.js";
+import "../../chunk-JFK7NTEA.js";
 export {
   classifyProviderFailure,
   failedSessionCopy

package/dist/app/lib/model-access-onboarding.js

@@ -8,11 +8,11 @@ import {
   creditsModelForCheckout,
   includedDefaultModel,
   preferredConnectedModelId
-} from "../../chunk-CSHBR2IZ.js";
-import "../../chunk-HPPKLBTJ.js";
+} from "../../chunk-GDLDBR6B.js";
+import "../../chunk-TJQDL3JH.js";
 import "../../chunk-A3KMTJZS.js";
 import "../../chunk-CFEFYPNR.js";
-import "../../chunk-5JZYPZ72.js";
+import "../../chunk-JFK7NTEA.js";
 export {
   applyConnectedModelToNewSessionDraft,
   composerFallbackModel,

package/dist/app/lib/move-chat-to-machine.js

@@ -3,11 +3,11 @@ import {
   isPersonalMachine,
   machineUseMessage,
   moveChatToMachine
-} from "../../chunk-AZVANYMB.js";
-import "../../chunk-HPPKLBTJ.js";
+} from "../../chunk-KUNFUSZ7.js";
+import "../../chunk-TJQDL3JH.js";
 import "../../chunk-A3KMTJZS.js";
 import "../../chunk-BOG2FED3.js";
-import "../../chunk-5JZYPZ72.js";
+import "../../chunk-JFK7NTEA.js";
 export {
   isPersonalMachine,
   machineUseMessage,

package/dist/app/lib/navigation.d.ts

@@ -42,6 +42,11 @@ export type LinkProps = NavigateOptions & Omit<AnchorHTMLAttributes<HTMLAnchorEl
     }) => ReactNode) | undefined;
     preload?: false | "intent" | "viewport" | "render" | undefined;
     disabled?: boolean | undefined;
+    /** When the link counts as the current page (`aria-current`); the router's default otherwise. */
+    activeOptions?: {
+        exact?: boolean | undefined;
+        includeSearch?: boolean | undefined;
+    } | undefined;
     ref?: Ref<HTMLAnchorElement> | undefined;
 };
 /**

package/dist/app/lib/navigation.js

@@ -10,7 +10,7 @@ import {
   useRouterState,
   useSearch,
   useStringifySearch
-} from "../../chunk-MYNUBDU7.js";
+} from "../../chunk-VYKW6TB2.js";
 import "../../chunk-IZUAIHR4.js";
 export {
   Link,

package/dist/app/lib/routes.d.ts

@@ -37,3 +37,20 @@ export type ArtifactReturnSearch = {
 };
 export type SiteDetailTab = "versions" | "conversations" | "data" | "settings";
 export declare function artifactReturnSearch(search: Record<string, unknown>): ArtifactReturnSearch;
+/** The Site view: the Site with its conversations beside it, one of them open. */
+export type SiteViewSearch = {
+    conversation?: string | undefined;
+};
+export declare function siteViewSearch(search: Record<string, unknown>): SiteViewSearch;
+export declare function workspaceSitePath(workspaceId: string, siteId: string, conversation?: string | undefined): string;
+/**
+ * What the rail marks as open for a location: a session page's session, or a
+ * Site view's Site and its selected conversation.
+ */
+export declare function railRouteSelection(location: {
+    pathname: string;
+    search: Record<string, unknown>;
+}): {
+    sessionId: string | null;
+    siteId: string | null;
+};

package/dist/app/lib/routes.js

@@ -3,24 +3,30 @@ import {
   artifactReturnSearch,
   orgSettingsPath,
   parseCheckoutOutcome,
+  railRouteSelection,
+  siteViewSearch,
   workspaceAgentPath,
   workspaceInsightsPath,
   workspaceMemoryPath,
   workspacePath,
   workspaceSessionPath,
   workspaceSessionsPath,
-  workspaceSettingsPath
-} from "../../chunk-WRLWLGEF.js";
+  workspaceSettingsPath,
+  workspaceSitePath
+} from "../../chunk-Y5E3XQ2S.js";
 export {
   artifactReturnSearch,
   orgSettingsPath,
   parseCheckoutOutcome,
+  railRouteSelection,
+  siteViewSearch,
   workspaceAgentPath,
   workspaceInsightsPath,
   workspaceMemoryPath,
   workspacePath,
   workspaceSessionPath,
   workspaceSessionsPath,
-  workspaceSettingsPath
+  workspaceSettingsPath,
+  workspaceSitePath
 };
 //# sourceMappingURL=routes.js.map

package/dist/app/lib/session-branch-cache.js

@@ -9,30 +9,31 @@ import {
   sessionBranchSummaryDecision,
   sessionBranchSummaryKey,
   upsertSessionBranchChild
-} from "../../chunk-EU6XSQFM.js";
-import "../../chunk-BJIZ7PL7.js";
+} from "../../chunk-HPB4KSV3.js";
+import "../../chunk-D64Z4V26.js";
 import "../../chunk-UBJWSGD4.js";
 import "../../chunk-K3TJNJSU.js";
-import "../../chunk-GTQ3SNEI.js";
+import "../../chunk-E36IC3LU.js";
 import "../../chunk-5TLEWXAB.js";
-import "../../chunk-HPPKLBTJ.js";
+import "../../chunk-TJQDL3JH.js";
 import "../../chunk-A3KMTJZS.js";
-import "../../chunk-Z5WMLJKI.js";
+import "../../chunk-F2RMKGDQ.js";
 import "../../chunk-LY6727IF.js";
-import "../../chunk-I6VUUEXH.js";
-import "../../chunk-LJUMYUBO.js";
-import "../../chunk-TQGJN5UZ.js";
+import "../../chunk-6AFSZKZA.js";
+import "../../chunk-AW3QEFOF.js";
 import "../../chunk-HEVQKE27.js";
-import "../../chunk-ANHUMDJX.js";
+import "../../chunk-LJUMYUBO.js";
+import "../../chunk-WNDTLK44.js";
 import "../../chunk-IZV5FTJC.js";
-import "../../chunk-STUCI6QA.js";
+import "../../chunk-ULYQEFNH.js";
+import "../../chunk-LEKBNKLD.js";
 import "../../chunk-DNJ23AWQ.js";
 import "../../chunk-OB3YGXHQ.js";
 import "../../chunk-DHXKEJBH.js";
 import "../../chunk-CFEFYPNR.js";
 import "../../chunk-SJGAHTY5.js";
 import "../../chunk-4NHJ6EXL.js";
-import "../../chunk-5JZYPZ72.js";
+import "../../chunk-JFK7NTEA.js";
 export {
   authoritativeSessionBranchChannels,
   beginSessionBranchRequest,

package/dist/app/lib/session-create.js

@@ -16,11 +16,11 @@ import {
   sessionDraftFromNewSessionDraftOptions,
   submissionFromSessionDraft,
   workspaceDefaultRigOptionLabel
-} from "../../chunk-JXT5QDJC.js";
-import "../../chunk-T6JQPVHA.js";
+} from "../../chunk-KNFDWNCH.js";
 import "../../chunk-L6Y4ALSM.js";
 import "../../chunk-FIDD34ZF.js";
 import "../../chunk-74JEZLLQ.js";
+import "../../chunk-T6JQPVHA.js";
 import "../../chunk-NRP4REXE.js";
 export {
   buildCreateSessionRequest,

package/dist/app/lib/session-deep-link.js

@@ -7,8 +7,8 @@ import {
   sessionDeepLinkReturnPath,
   sessionReadWorkspaceIds,
   shouldRedirectSessionDeepLink
-} from "../../chunk-FBMU3VK5.js";
-import "../../chunk-WRLWLGEF.js";
+} from "../../chunk-6DCEDIF6.js";
+import "../../chunk-Y5E3XQ2S.js";
 export {
   authorizedSessionReadWorkspaceIds,
   canonicalSessionDeepLinkTarget,

package/dist/app/lib/session-failure-toasts.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Toast the session page's read failures, once per error. The read hooks keep
+ * transient failures (a rolling deploy, a network blip) quiet while they retry
+ * and keep one stable error per outage, so an error reaches here only when it
+ * is definitive or outlasted the quiet window. A 404 renders the unavailable
+ * route instead of a toast.
+ */
+export declare function useSessionFailureToasts(loadError: Error | null, streamError: Error | null): void;

package/dist/app/lib/session-group-pagination.js

@@ -4,30 +4,31 @@ import {
   sessionPaginationGroupQuery,
   sessionPaginationLocalDateKey,
   sessionPaginationProjectGroup
-} from "../../chunk-QRVNI5V6.js";
-import "../../chunk-BJIZ7PL7.js";
+} from "../../chunk-SCNEQFIW.js";
+import "../../chunk-D64Z4V26.js";
 import "../../chunk-UBJWSGD4.js";
 import "../../chunk-K3TJNJSU.js";
-import "../../chunk-GTQ3SNEI.js";
+import "../../chunk-E36IC3LU.js";
 import "../../chunk-5TLEWXAB.js";
-import "../../chunk-HPPKLBTJ.js";
+import "../../chunk-TJQDL3JH.js";
 import "../../chunk-A3KMTJZS.js";
-import "../../chunk-Z5WMLJKI.js";
+import "../../chunk-F2RMKGDQ.js";
 import "../../chunk-LY6727IF.js";
-import "../../chunk-I6VUUEXH.js";
-import "../../chunk-LJUMYUBO.js";
-import "../../chunk-TQGJN5UZ.js";
+import "../../chunk-6AFSZKZA.js";
+import "../../chunk-AW3QEFOF.js";
 import "../../chunk-HEVQKE27.js";
-import "../../chunk-ANHUMDJX.js";
+import "../../chunk-LJUMYUBO.js";
+import "../../chunk-WNDTLK44.js";
 import "../../chunk-IZV5FTJC.js";
-import "../../chunk-STUCI6QA.js";
+import "../../chunk-ULYQEFNH.js";
+import "../../chunk-LEKBNKLD.js";
 import "../../chunk-DNJ23AWQ.js";
 import "../../chunk-OB3YGXHQ.js";
 import "../../chunk-DHXKEJBH.js";
 import "../../chunk-CFEFYPNR.js";
 import "../../chunk-SJGAHTY5.js";
 import "../../chunk-4NHJ6EXL.js";
-import "../../chunk-5JZYPZ72.js";
+import "../../chunk-JFK7NTEA.js";
 export {
   sessionMatchesPaginationGroup,
   sessionPaginationGroupQuery,

package/dist/app/lib/session-hover-facts.js

@@ -4,26 +4,27 @@ import {
   nextCheckLabel,
   sessionHoverDescription,
   sessionHoverFacts
-} from "../../chunk-HOJGAJAB.js";
+} from "../../chunk-4MQLGMV2.js";
 import "../../chunk-XVVJBNUQ.js";
-import "../../chunk-BJIZ7PL7.js";
+import "../../chunk-D64Z4V26.js";
 import "../../chunk-UBJWSGD4.js";
 import "../../chunk-K3TJNJSU.js";
-import "../../chunk-GTQ3SNEI.js";
+import "../../chunk-E36IC3LU.js";
 import "../../chunk-5TLEWXAB.js";
-import "../../chunk-HPPKLBTJ.js";
+import "../../chunk-TJQDL3JH.js";
 import "../../chunk-XG57V2BN.js";
 import "../../chunk-KS57MLGE.js";
 import "../../chunk-A3KMTJZS.js";
-import "../../chunk-Z5WMLJKI.js";
+import "../../chunk-F2RMKGDQ.js";
 import "../../chunk-LY6727IF.js";
-import "../../chunk-I6VUUEXH.js";
-import "../../chunk-LJUMYUBO.js";
-import "../../chunk-TQGJN5UZ.js";
+import "../../chunk-6AFSZKZA.js";
+import "../../chunk-AW3QEFOF.js";
 import "../../chunk-HEVQKE27.js";
-import "../../chunk-ANHUMDJX.js";
+import "../../chunk-LJUMYUBO.js";
+import "../../chunk-WNDTLK44.js";
 import "../../chunk-IZV5FTJC.js";
-import "../../chunk-STUCI6QA.js";
+import "../../chunk-ULYQEFNH.js";
+import "../../chunk-LEKBNKLD.js";
 import "../../chunk-DNJ23AWQ.js";
 import "../../chunk-OB3YGXHQ.js";
 import "../../chunk-DHXKEJBH.js";
@@ -32,7 +33,7 @@ import "../../chunk-CFEFYPNR.js";
 import "../../chunk-SJGAHTY5.js";
 import "../../chunk-4NHJ6EXL.js";
 import "../../chunk-TXS65BB2.js";
-import "../../chunk-5JZYPZ72.js";
+import "../../chunk-JFK7NTEA.js";
 export {
   formatWaitDuration,
   nextCheckLabel,

package/dist/app/lib/session-model.js

@@ -1,10 +1,10 @@
 "use client";
 import {
   resolveSessionComposerModel
-} from "../../chunk-KZHW27BV.js";
+} from "../../chunk-WYEPUXGL.js";
 import {
   isCodexProductModel
-} from "../../chunk-Z5WMLJKI.js";
+} from "../../chunk-F2RMKGDQ.js";
 import "../../chunk-DHXKEJBH.js";
 import "../../chunk-CFEFYPNR.js";
 export {

package/dist/app/lib/session-rail.js

@@ -9,19 +9,20 @@ import {
   sessionStatusLabel,
   sessionWaitLabel,
   visualTreeDepth
-} from "../../chunk-GTQ3SNEI.js";
+} from "../../chunk-E36IC3LU.js";
 import {
   sessionHasUpcomingSchedule,
   sessionInputWait
-} from "../../chunk-Z5WMLJKI.js";
+} from "../../chunk-F2RMKGDQ.js";
 import "../../chunk-LY6727IF.js";
-import "../../chunk-I6VUUEXH.js";
-import "../../chunk-LJUMYUBO.js";
-import "../../chunk-TQGJN5UZ.js";
+import "../../chunk-6AFSZKZA.js";
+import "../../chunk-AW3QEFOF.js";
 import "../../chunk-HEVQKE27.js";
-import "../../chunk-ANHUMDJX.js";
+import "../../chunk-LJUMYUBO.js";
+import "../../chunk-WNDTLK44.js";
 import "../../chunk-IZV5FTJC.js";
-import "../../chunk-STUCI6QA.js";
+import "../../chunk-ULYQEFNH.js";
+import "../../chunk-LEKBNKLD.js";
 import "../../chunk-DNJ23AWQ.js";
 import "../../chunk-OB3YGXHQ.js";
 import "../../chunk-DHXKEJBH.js";

package/dist/app/lib/session-rename.js

@@ -3,12 +3,12 @@ import {
   performRename,
   renameSeedValue,
   useInlineRename
-} from "../../chunk-4EAF3HSD.js";
+} from "../../chunk-7J7PZB4S.js";
 import {
   SESSION_TITLE_MAX_LENGTH,
   resolveRenameSubmission,
   sessionDisplayTitle
-} from "../../chunk-Z5WMLJKI.js";
+} from "../../chunk-F2RMKGDQ.js";
 import "../../chunk-DHXKEJBH.js";
 import "../../chunk-CFEFYPNR.js";
 export {

package/dist/app/lib/session-ui-features.d.ts

@@ -14,8 +14,13 @@ export type SessionUiFeatures = Readonly<{
      * chat, ⌘/Ctrl+K, next and previous chat, the shortcut sheet).
      */
     keyboardShortcuts: boolean;
-    /** The Opengeni logo and wordmark at the top of the chat list. */
+    /** The Opengeni logo and wordmark at the top of the chat list and the mobile header. */
     brand: boolean;
+    /**
+     * Opengeni's suggested first tasks under the new-chat composer (connect
+     * Slack, GitHub or Linear, schedule a brief, and so on).
+     */
+    starters: boolean;
 }>;
 export type SessionUiPreset = "app" | "companion" | "embed";
 export declare const SESSION_UI_PRESETS: Readonly<Record<SessionUiPreset, SessionUiFeatures>>;

package/dist/app/lib/session-ui-features.js

@@ -3,7 +3,7 @@ import {
   SESSION_UI_PRESETS,
   SessionUiFeaturesProvider,
   useSessionUiFeature
-} from "../../chunk-XFNLU7EW.js";
+} from "../../chunk-H5M33DAL.js";
 export {
   SESSION_UI_PRESETS,
   SessionUiFeaturesProvider,

package/dist/app/lib/sessions-group.d.ts

@@ -1,10 +1,15 @@
 import { type SessionSiteOrigin } from "./session-site-origin.js";
-import type { SessionListTotals } from "@opengeni/sdk";
+import type { SessionListTotals, SiteConversationGroup } from "@opengeni/sdk";
 import type { RailSession as Session } from "./session-list-entry.js";
 export { compareSessionActivity, compareSessionPins, groupSessionsForRail, isRunningStatus, partitionPinnedSessions, recencyGroupFor, relativeTimeLabel, SESSION_GROUP_LABELS, SESSION_GROUP_ORDER, sessionActivityTime, type GroupedSessions, type SessionRecencyBucket, type SessionRecencyGroup, } from "../../session-list-model.js";
 export type SessionTreeNode = {
     /** Presentation-only group; never persisted or used for session actions. */
     siteGroup?: SessionSiteOrigin | undefined;
+    /**
+     * A Site row's complete server counts, independent of which conversations
+     * are loaded. Absent when the row was built from loaded conversations only.
+     */
+    siteSummary?: SiteRowSummary | undefined;
     session: Session;
     children: SessionTreeNode[];
     /** A descendant (any depth, not the node itself) is running/queued/awaiting action. */
@@ -139,8 +144,37 @@ export declare function scheduledTaskIdOf(session: Session): string | null;
  * never pushes a live run down the rail.
  */
 export declare function groupScheduledRuns(roots: SessionTreeNode[]): SessionTreeNode[];
-/** Explicit project placement wins; pins have already been split out. */
-export declare function groupSiteConversations(roots: SessionTreeNode[]): SessionTreeNode[];
+export type SiteRowSummary = Omit<SiteConversationGroup, "siteId" | "channelId" | "title">;
+/**
+ * A Site row's stable id. Rows are per project when the rail shows projects,
+ * so a Site used from two projects appears in each; otherwise one per Site.
+ */
+export declare function siteRowKey(siteId: string, channelId?: string | null): string;
+/** The Site and project a Site row stands for, or null for an ordinary id. */
+export declare function parseSiteRowKey(key: string): {
+    siteId: string;
+    channelId?: string | null | undefined;
+} | null;
+/**
+ * Fold Site conversations into stable Site rows. `groups` are the complete
+ * rows from the server; loaded conversations (an expanded Site, the open
+ * session, a legacy labelled chat) join their row, so which session is
+ * selected never decides whether a Site or its conversations are listed.
+ * Pins have already been split out.
+ */
+export declare function attachSiteRows(roots: SessionTreeNode[], options?: {
+    groups?: readonly SiteConversationGroup[] | undefined;
+    /** Rows per project when the rail shows projects. */
+    byProject?: boolean | undefined;
+    workspaceId?: string | undefined;
+    creator?: Session["createdBy"] | undefined;
+}): SessionTreeNode[];
+/**
+ * How many conversations a Site row stands for, loaded or not. The server
+ * counts Site conversations; an older chat that only carries a Site label
+ * joins the row when loaded, so the count can grow by those on expansion.
+ */
+export declare function siteRowConversationCount(node: SessionTreeNode): number;
 export declare function categorizeRailRoots(rootNodes: SessionTreeNode[], now?: Date): SessionForest;
 /**
  * Build the rail forest: roots (parentSessionId null, or parent absent from the
@@ -169,6 +203,12 @@ export declare function projectRailSessions<T extends Session>(sessions: T[], hi
 /** Build the complete, explicit-pin, and ordinary rail projections together. */
 export declare function buildPinnedRailSections(sessions: Session[], now?: Date, options?: {
     groupSites?: boolean | undefined;
+    /** Complete Site rows from a grouped root page. */
+    siteGroups?: readonly SiteConversationGroup[] | undefined;
+    /** Split Site rows by project (the rail's project view). */
+    siteRowsByProject?: boolean | undefined;
+    workspaceId?: string | undefined;
+    creator?: Session["createdBy"] | undefined;
 }): PinnedRailSections;
 /** The selected descendant under a collapsed node, projected one level deeper. */
 export declare function selectedDescendantNode(node: SessionTreeNode, selectedSessionId: string | null): SessionTreeNode | null;