@tangle-network/agent-app 0.44.41 → 0.44.46

package/dist/session-shell/index.d.ts

@@ -0,0 +1,275 @@
+/**
+ * Session shell — the app-shell mechanism every agent product needs around the
+ * chat surface: a list of past sessions in the rail, an entry point for a new
+ * one, and a paged history view behind it.
+ *
+ * `/web-react` already owns the chat SURFACE (composer, transcript, cards); it
+ * owned no session SHELL, so all four products hand-rolled one and drifted.
+ * This module is the shell's pure half: no React, no DOM, no peer imports, so a
+ * server loader can call `readRailCollapsedCookie` without dragging React into
+ * a worker bundle (`/web-react` holds the rendered half).
+ *
+ * Domain stays a parameter. A "session" here is only an id, a title and a
+ * timestamp — a gtm thread, a tax session and a legal matter are all the same
+ * shape to the shell, and the product supplies routing through `hrefForSession`
+ * rather than the shell knowing any URL.
+ */
+/** One session as the shell needs to see it. Products map their own row
+ *  (thread / session / matter) onto this before handing it over. */
+interface SessionSummary {
+    id: string;
+    /** `null`/empty renders as the untitled placeholder rather than a blank row. */
+    title: string | null;
+    /** ISO-8601. `null` when the product has no timestamp to show. */
+    updatedAt: string | null;
+    isPinned?: boolean;
+    /** Unread for the viewer. Use `resolveSessionUnread` to fold live overlays in. */
+    unread?: boolean;
+    /** Free-form product label (gtm categories, legal matter types). Passed
+     *  through untouched — the shell never interprets it. */
+    category?: string | null;
+}
+/** One fetched page of sessions with an optional continuation cursor. */
+interface SessionPage {
+    items: SessionSummary[];
+    /** Opaque continuation token; absent/null ⇒ no further pages. */
+    nextCursor?: string | null;
+}
+/** Sort order for the history view. The product's fetcher decides what these
+ *  mean against its own storage; the shell only round-trips the value. */
+type SessionSort = 'newest' | 'oldest';
+/**
+ * These mirror `@tangle-network/sandbox-ui/dashboard`'s `SidebarLayoutNavItem`
+ * / `RailExpandableSubItem` STRUCTURALLY rather than importing them, so this
+ * module stays free of the optional peer (invariant 3 — structural over
+ * hard-dep when the surface is small). `tests/session-shell/rail-contract.test.ts`
+ * assigns the builder output to the real sandbox-ui types, so a drift in either
+ * direction fails CI instead of silently dropping a field at runtime.
+ *
+ * `TIcon` is the product's icon component type (lucide, custom, anything) —
+ * generic so this file needs no React types.
+ */
+interface SessionRailAction<TIcon = unknown> {
+    id: string;
+    label: string;
+    icon?: TIcon;
+    destructive?: boolean;
+    onSelect: () => void;
+}
+type RailPrefetch = 'none' | 'intent' | 'render' | 'viewport';
+interface SessionRailSubItem<TIcon = unknown> {
+    id: string;
+    label: string;
+    href: string;
+    prefetch?: RailPrefetch;
+    /** Live working indicator — the session is mid-turn. */
+    isLoading?: boolean;
+    /** Bold + leading dot. sandbox-ui suppresses it while `isLoading`. */
+    unread?: boolean;
+    /** Emphasised row, used for the trailing "view all" overflow link. */
+    emphasis?: boolean;
+    actions?: SessionRailAction<TIcon>[];
+}
+interface SessionRailNavItem<TIcon = unknown> {
+    id: string;
+    /** REQUIRED, mirroring sandbox-ui — the rail renders `<Icon />` unguarded, so
+     *  an omitted icon is a blank/crashing row rather than a styling nit. */
+    icon: TIcon;
+    label: string;
+    href: string;
+    badge?: number;
+    expandable?: boolean;
+    defaultOpen?: boolean;
+    subItems?: SessionRailSubItem<TIcon>[];
+    subActiveIds?: string[];
+    emptyLabel?: string;
+    prefetch?: RailPrefetch;
+}
+/** Per-row rename/delete wiring. Supplied by the layout that owns the dialogs;
+ *  omitted (or `canEdit: false`) leaves rows read-only. */
+interface SessionRowActions<TIcon = unknown> {
+    canEdit: boolean;
+    renameIcon?: TIcon;
+    deleteIcon?: TIcon;
+    renameLabel?: string;
+    deleteLabel?: string;
+    onRename: (session: SessionSummary) => void;
+    onDelete: (session: SessionSummary) => void;
+}
+declare const UNTITLED_SESSION_LABEL = "Untitled chat";
+/** Display title for a session row — trims, and falls back rather than
+ *  rendering an empty row the user cannot aim at. */
+declare function sessionLabel(session: SessionSummary, untitled?: string): string;
+interface BuildSessionSubItemsOptions<TIcon = unknown> {
+    sessions: SessionSummary[];
+    /** The product's route for one session. The shell never builds a URL itself. */
+    hrefForSession: (sessionId: string) => string;
+    /** Ids currently mid-turn — renders the working indicator. */
+    respondingSessionIds?: ReadonlySet<string>;
+    actions?: SessionRowActions<TIcon>;
+    untitledLabel?: string;
+    prefetch?: RailPrefetch;
+    /** Trailing "view all" row, appended when the capped list hides sessions. */
+    overflow?: {
+        href: string;
+        label?: string;
+    };
+}
+/** Session rows for the rail's expandable history item. */
+declare function buildSessionSubItems<TIcon = unknown>({ sessions, hrefForSession, respondingSessionIds, actions, untitledLabel, prefetch, overflow, }: BuildSessionSubItemsOptions<TIcon>): SessionRailSubItem<TIcon>[];
+interface BuildSessionNavItemOptions<TIcon = unknown> extends BuildSessionSubItemsOptions<TIcon> {
+    /** Nav id the product highlights against (`activeNavId === id`). */
+    id?: string;
+    label?: string;
+    /** The product's icon component. Required — see `SessionRailNavItem.icon`. */
+    icon: TIcon;
+    /** The expandable row's own destination — the full history page. */
+    href: string;
+    /** Session currently open, highlighted inside the expandable. */
+    activeSessionId?: string | null;
+    emptyLabel?: string;
+    defaultOpen?: boolean;
+}
+/**
+ * The rail's session entry: one expandable nav row whose sub-items are the
+ * recent sessions. This is the structure the owner asked for — history lives IN
+ * the rail, not in a second sidebar panel beside it.
+ */
+declare function buildSessionNavItem<TIcon = unknown>({ id, label, icon, href, activeSessionId, emptyLabel, defaultOpen, ...subItemOptions }: BuildSessionNavItemOptions<TIcon>): SessionRailNavItem<TIcon>;
+interface ActiveSessionIdOptions {
+    pathname: string;
+    /** Workspace-scoped route base, e.g. `/app/ws_123`. */
+    base: string;
+    /** Route segment sessions live under. Default `chat` ⇒ `${base}/chat/:id`.
+     *  Pass `''` when sessions sit DIRECTLY under the base (`/app/:sessionId`),
+     *  which is how one product routes them — then `reserved` is mandatory. */
+    segment?: string;
+    /** Segment that means "composing a new session", not an id. Default `new`. */
+    newSegment?: string;
+    /**
+     * First segments that are OTHER routes, not session ids. Only meaningful
+     * with `segment: ''`, where `/app/settings` is otherwise indistinguishable
+     * from a session called `settings` — and resolving it as one would highlight
+     * and prefetch a session that does not exist. Pass the product's own nav
+     * paths; unknown-but-reserved is a routing bug, so this fails closed.
+     */
+    reserved?: readonly string[];
+}
+/**
+ * The session id the current route has open, or `null` on the new-session
+ * composer / anywhere else.
+ *
+ * Anchored at `base` on purpose. A bare `/\/chat\/([^/]+)/` scan — the shape
+ * three products shipped — matches the FIRST `/chat/` anywhere in the path, so
+ * a workspace or vault folder named `chat` resolves a neighbouring segment as a
+ * session id and the rail highlights (and prefetches) a session the user is not
+ * in. Same class as attaching to a stale box: it looks right and points at the
+ * wrong row.
+ */
+declare function activeSessionIdFromPath({ pathname, base, segment, newSegment, reserved, }: ActiveSessionIdOptions): string | null;
+/** One rail destination. `path` is relative to the workspace base. */
+interface NavRouteDef {
+    id: string;
+    path: string;
+}
+interface ResolveActiveNavIdOptions {
+    pathname: string;
+    base: string;
+    /** The product's rail rows, in any order — resolution is longest-prefix. */
+    routes: NavRouteDef[];
+    /** Extra prefixes that light an existing row: `{ '/agents': 'integrations' }`.
+     *  Participates in the same longest-prefix contest. */
+    aliases?: Record<string, string>;
+    /** Prefixes that deliberately highlight NOTHING, beating any shorter match.
+     *  gtm uses this so an open chat lights no rail row while `/chat/new` still
+     *  lights "New". */
+    claimsNothing?: string[];
+}
+/**
+ * The rail row to highlight for the current route.
+ *
+ * Longest-prefix wins, so declaration order cannot change the answer. The
+ * per-product versions this replaces were first-match over an array, which made
+ * `/chat/new` vs `/chat` an ordering accident rather than a rule.
+ */
+declare function resolveActiveNavId({ pathname, base, routes, aliases, claimsNothing, }: ResolveActiveNavIdOptions): string | undefined;
+interface ResolveSessionUnreadOptions {
+    sessionId: string;
+    /** Server-computed unread from the route loader. */
+    loaderUnread: boolean;
+    /** Live "went unread" ids from the workspace channel. */
+    liveUnreadIds?: ReadonlySet<string>;
+    /** Ids this tab has already opened since the loader ran. */
+    locallyReadIds?: ReadonlySet<string>;
+    /** The open session is never unread to its own viewer. */
+    currentSessionId?: string | null;
+}
+/**
+ * Effective unread for one row. The loader's value can be stale — a layout
+ * loader that survives same-workspace navigation keeps reporting a session as
+ * unread after the user opened it — so live and local overlays win over it, and
+ * the currently-open session always reads as read.
+ */
+declare function resolveSessionUnread({ sessionId, loaderUnread, liveUnreadIds, locallyReadIds, currentSessionId, }: ResolveSessionUnreadOptions): boolean;
+interface ComposeSidebarSessionsOptions {
+    /** Server-rendered rows, already ordered by the product's query. */
+    loaderSessions: SessionSummary[];
+    /** Optimistic rows from the live channel (a chat created in another tab). */
+    optimisticSessions?: SessionSummary[];
+    /** Rail cap. The full list lives on the history page. */
+    limit: number;
+    /** Total sessions the product holds, used to decide the overflow row. */
+    totalCount?: number;
+    liveUnreadIds?: ReadonlySet<string>;
+    locallyReadIds?: ReadonlySet<string>;
+    currentSessionId?: string | null;
+}
+interface ComposedSidebarSessions {
+    sessions: SessionSummary[];
+    /** More sessions exist than the rail shows ⇒ render the "view all" row. */
+    hasMore: boolean;
+}
+/**
+ * The rail's session list: optimistic rows first, then the loader's, capped,
+ * with unread resolved per row.
+ *
+ * Optimistic rows are deduped against the loader by id — once a revalidation
+ * brings a live-created session back from the server it must not appear twice
+ * (duplicate React keys, and the row's actions would target the same session
+ * from two places).
+ */
+declare function composeSidebarSessions({ loaderSessions, optimisticSessions, limit, totalCount, liveUnreadIds, locallyReadIds, currentSessionId, }: ComposeSidebarSessionsOptions): ComposedSidebarSessions;
+/**
+ * Append a fetched page to held rows, dropping ids already shown. A session
+ * bumped to the top between two page fetches otherwise arrives twice — once in
+ * the page it moved out of and once in the page it moved into.
+ */
+declare function mergeSessionPages(existing: SessionSummary[], incoming: SessionSummary[]): SessionSummary[];
+declare const DEFAULT_RAIL_COOKIE_NAME = "agent-sidebar-rail-collapsed";
+/**
+ * Read the persisted rail-collapse state from a request's `Cookie` header, so
+ * the server renders the rail in the state the user left it and the first
+ * client render does not re-flow.
+ *
+ * Parses the header rather than building a `RegExp` from the cookie name (the
+ * shape the products shipped): a name containing a regex metacharacter would
+ * silently match the wrong cookie or none at all.
+ */
+declare function readRailCollapsedCookie(cookieHeader: string | null | undefined, name?: string): boolean;
+interface RailCookieOptions {
+    name?: string;
+    /** Seconds. Default one year. */
+    maxAge?: number;
+    path?: string;
+    /** Omit to auto-detect: `secure` on https, off on http://localhost — a Secure
+     *  cookie is dropped there and the rail state would not persist in dev. */
+    secure?: boolean;
+}
+/** The cookie string for a collapse state. Usable as `document.cookie` or as a
+ *  `Set-Cookie` value. Exported separately so it is testable without a DOM. */
+declare function railCollapsedCookie(collapsed: boolean, { name, maxAge, path, secure }?: RailCookieOptions): string;
+/** Persist the rail-collapse state from the browser. No-op without a document
+ *  so a shared toggle handler is safe to call during SSR. */
+declare function writeRailCollapsedCookie(collapsed: boolean, options?: RailCookieOptions): void;
+
+export { type ActiveSessionIdOptions, type BuildSessionNavItemOptions, type BuildSessionSubItemsOptions, type ComposeSidebarSessionsOptions, type ComposedSidebarSessions, DEFAULT_RAIL_COOKIE_NAME, type NavRouteDef, type RailCookieOptions, type RailPrefetch, type ResolveActiveNavIdOptions, type ResolveSessionUnreadOptions, type SessionPage, type SessionRailAction, type SessionRailNavItem, type SessionRailSubItem, type SessionRowActions, type SessionSort, type SessionSummary, UNTITLED_SESSION_LABEL, activeSessionIdFromPath, buildSessionNavItem, buildSessionSubItems, composeSidebarSessions, mergeSessionPages, railCollapsedCookie, readRailCollapsedCookie, resolveActiveNavId, resolveSessionUnread, sessionLabel, writeRailCollapsedCookie };

package/dist/session-shell/index.js

@@ -0,0 +1,31 @@
+import {
+  DEFAULT_RAIL_COOKIE_NAME,
+  UNTITLED_SESSION_LABEL,
+  activeSessionIdFromPath,
+  buildSessionNavItem,
+  buildSessionSubItems,
+  composeSidebarSessions,
+  mergeSessionPages,
+  railCollapsedCookie,
+  readRailCollapsedCookie,
+  resolveActiveNavId,
+  resolveSessionUnread,
+  sessionLabel,
+  writeRailCollapsedCookie
+} from "../chunk-3E4MW5LR.js";
+export {
+  DEFAULT_RAIL_COOKIE_NAME,
+  UNTITLED_SESSION_LABEL,
+  activeSessionIdFromPath,
+  buildSessionNavItem,
+  buildSessionSubItems,
+  composeSidebarSessions,
+  mergeSessionPages,
+  railCollapsedCookie,
+  readRailCollapsedCookie,
+  resolveActiveNavId,
+  resolveSessionUnread,
+  sessionLabel,
+  writeRailCollapsedCookie
+};
+//# sourceMappingURL=index.js.map

package/dist/session-shell/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/teams-react/index.js

@@ -1,12 +1,12 @@
+import {
+  MembersPanel
+} from "../chunk-S564OFTL.js";
 import {
   InvitationsPanel
 } from "../chunk-5SXS3YAB.js";
 import {
   InviteAcceptPage
 } from "../chunk-VCPZ3HTN.js";
-import {
-  MembersPanel
-} from "../chunk-S564OFTL.js";
 import "../chunk-6XIAPIW6.js";
 export {
   InvitationsPanel,

package/dist/web/index.d.ts

@@ -79,6 +79,16 @@ interface SecurityHeaderOptions {
     /** Extra headers to set. */
     extra?: Record<string, string>;
 }
+/** Canonical generic response headers used by {@link addSecurityHeaders}.
+ * Exported so static-asset hosts can apply the same policy without copying
+ * values that silently drift from Worker/API responses. */
+declare const STANDARD_SECURITY_HEADERS: Readonly<{
+    readonly 'Strict-Transport-Security': "max-age=31536000; includeSubDomains; preload";
+    readonly 'X-Content-Type-Options': "nosniff";
+    readonly 'X-Frame-Options': "SAMEORIGIN";
+    readonly 'Referrer-Policy': "same-origin";
+    readonly 'X-XSS-Protection': "1; mode=block";
+}>;
 /** Set standard security headers on a response (HSTS, nosniff, frame-options,
  *  referrer-policy, XSS) + optional product disclaimer/retention. The security
  *  set is generic; the disclaimer/retention are the product's. */
@@ -96,4 +106,4 @@ declare function addSecurityHeaders(response: Response, opts?: SecurityHeaderOpt
  */
 declare function assertMediaUrl(url: string, what?: string): void;
 
-export { type CookieOptions, type JsonObject, type KvLike, type RateLimitResult, type RequestContext, type SecurityHeaderOptions, addSecurityHeaders, assertMediaUrl, checkRateLimit, clearCookieHeader, extractRequestContext, parseJsonObjectBody, readCookieValue, requireString, serializeCookie };
+export { type CookieOptions, type JsonObject, type KvLike, type RateLimitResult, type RequestContext, STANDARD_SECURITY_HEADERS, type SecurityHeaderOptions, addSecurityHeaders, assertMediaUrl, checkRateLimit, clearCookieHeader, extractRequestContext, parseJsonObjectBody, readCookieValue, requireString, serializeCookie };

package/dist/web/index.js

@@ -1,4 +1,5 @@
 import {
+  STANDARD_SECURITY_HEADERS,
   addSecurityHeaders,
   assertMediaUrl,
   checkRateLimit,
@@ -8,8 +9,9 @@ import {
   readCookieValue,
   requireString,
   serializeCookie
-} from "../chunk-PTUMBMVH.js";
+} from "../chunk-J25RST7G.js";
 export {
+  STANDARD_SECURITY_HEADERS,
   addSecurityHeaders,
   assertMediaUrl,
   checkRateLimit,

package/dist/web-react/index.d.ts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { ReactNode } from 'react';
+import { ReactNode, RefObject } from 'react';
 import { C as ChatInteractionField, I as InteractionAnswers, a as ChatInteractionStatus, b as ChatInteraction, c as InteractionCancelData, d as ChatSelectField, e as InteractionRequestWire } from '../contract-CQNvv5th.js';
 export { f as ChatFreeTextField, g as ComposerAnswerDelivery, h as INTERACTION_CANCEL_EVENT, i as INTERACTION_EVENT, j as INTERACTION_RESOLVED_EVENT, k as InteractionAnswerValue, l as InteractionPersistedPart, N as NoticeKind, m as NoticePersistedPart, P as ParseInteractionAnswersResult, n as ParseInteractionResult, o as canTransitionInteractionStatus, p as cancelStatusFor, q as composerAnswerData, r as composerAnswerDeliveries, s as dedupeQuestionInteractionsByContent, t as fieldAcceptsFreeText, u as interactionFromWireRequest, v as interactionPartKey, w as interactionToPersistedPart, x as isRenderableInteractionKind, y as isSafeInteractionFieldKey, z as isTerminalInteractionStatus, A as noticePart, B as noticePartKey, D as parseInteractionAnswers, E as parseInteractionCancel, F as parseInteractionRequest, G as persistedPartToInteraction, H as questionInteractionContentSignature, J as stampInteractionAnswers } from '../contract-CQNvv5th.js';
 import { ChatPlan } from '../plans/index.js';
@@ -17,6 +17,7 @@ import { a as ReviewQueueItem, c as ReviewQueueState } from '../queue-VTBA5ONX.j
 export { p as parseReviewQueueItem } from '../queue-VTBA5ONX.js';
 export { S as SandboxTerminalConnection, a as SandboxTerminalConnectionResponse, U as UseSandboxTerminalConnectionOptions, b as UseSandboxTerminalConnectionResult, t as tabTerminalConnectionId, u as useSandboxTerminalConnection } from '../sandbox-terminal-ChNEdHF8.js';
 import { i as ProductSeatOffer } from '../billing-BibxgALe.js';
+import { SessionSort, SessionPage, SessionSummary } from '../session-shell/index.js';
 import { CatalogModel } from '../catalog/index.js';
 import { Harness } from '../harness/index.js';
 export { a as ATTACHMENT_ACCEPT, e as FileIndexReadyResponse, f as FileIndexResponse, g as FileIndexWarmingResponse } from '../attachment-validation-CsmUzuI3.js';
@@ -1089,6 +1090,163 @@ interface SeatPaywallProps {
  */
 declare function SeatPaywall({ product, onCheckout, priceUsd, includedUsageUsd, offer, tagline, ctaLabel, benefits, footnote, }: SeatPaywallProps): ReactNode;
 
+interface UseInfiniteScrollOptions {
+    /** Only fire `onLoadMore` while true (a next page exists, none in flight). */
+    enabled: boolean;
+    /** Scroll container the sentinel lives in. Defaults to the viewport. */
+    root?: RefObject<HTMLElement | null>;
+    /** Prefetch distance before the sentinel is actually reached. */
+    rootMargin?: string;
+}
+/**
+ * Fires `onLoadMore` when a sentinel element scrolls into view. Returns a ref
+ * callback for that sentinel (typically the last element in a list).
+ *
+ * The observer is re-created whenever `enabled` flips, so a short first page
+ * that leaves the sentinel on-screen keeps loading: when a load finishes and
+ * `enabled` returns to true, the fresh observer re-reads the current
+ * intersection state and fires again until the sentinel is pushed off-screen.
+ */
+declare function useInfiniteScroll(onLoadMore: () => void, { enabled, root, rootMargin }: UseInfiniteScrollOptions): (node: HTMLElement | null) => void;
+interface SessionPageQuery {
+    /** Trimmed search term; empty string means no filter. */
+    q: string;
+    sort: SessionSort;
+    /** `null` for the first page. */
+    cursor: string | null;
+    /** Aborted when the view changes or the component unmounts. */
+    signal: AbortSignal;
+}
+/** Data port — one page of sessions for the current view. */
+type FetchSessionPage = (query: SessionPageQuery) => Promise<SessionPage>;
+interface UseSessionHistoryOptions {
+    fetchPage: FetchSessionPage;
+    /** Trimmed search term driving the fetch. */
+    q: string;
+    sort: SessionSort;
+    /** SSR page 1 of the default view, so the first paint costs no request. */
+    initialPage: SessionPage;
+    /** The sort `initialPage` was rendered for. Default `'newest'`. */
+    defaultSort?: SessionSort;
+}
+interface SessionHistoryState {
+    items: SessionSummary[];
+    hasMore: boolean;
+    isLoadingFirst: boolean;
+    isLoadingMore: boolean;
+    isError: boolean;
+    loadMore: () => void;
+    /** Re-run whichever load failed. */
+    retry: () => void;
+    /** Refetch page 1 — call after a client-side mutation (e.g. a delete). */
+    reload: () => void;
+}
+/**
+ * Infinite-scroll data source for the history view. Seeds from `initialPage`
+ * for the default view (no fetch) and otherwise fetches page 1 for the current
+ * search/sort; `loadMore` appends the next cursor page.
+ *
+ * Raw promises + `AbortController` rather than a router fetcher, so a filter
+ * change cancels in-flight requests, pages accumulate, and a late response from
+ * a superseded view is dropped by the monotonic `seq` guard.
+ */
+declare function useSessionHistory({ fetchPage, q, sort, initialPage, defaultSort, }: UseSessionHistoryOptions): SessionHistoryState;
+interface SessionActionsOptions {
+    /** Persist a new title. Reject to surface the error in the dialog. */
+    renameSession: (sessionId: string, title: string) => Promise<void>;
+    deleteSession: (sessionId: string) => Promise<void>;
+    /** Called after a successful rename/delete — revalidate the rail here. */
+    onChanged?: () => void;
+    /** Called after deleting the session the user is currently viewing, so the
+     *  product can navigate away from a route that no longer resolves. */
+    onDeletedCurrent?: () => void;
+    /** The open session, compared against the delete target. */
+    currentSessionId?: string | null;
+    /** Product toast/log seam. Errors also render inside the dialog. */
+    notify?: (level: 'success' | 'error', message: string) => void;
+    labels?: Partial<SessionActionLabels>;
+}
+interface SessionActionLabels {
+    renameTitle: string;
+    renameField: string;
+    renameSubmit: string;
+    deleteTitle: string;
+    deleteBody: (title: string) => string;
+    deleteSubmit: string;
+    cancel: string;
+    renamed: string;
+    deleted: string;
+    renameFailed: string;
+    deleteFailed: string;
+}
+interface SessionActions {
+    openRename: (session: SessionSummary) => void;
+    openDelete: (session: SessionSummary) => void;
+    /** Render once, anywhere that survives navigation (the layout). */
+    dialogs: ReactNode;
+    busy: boolean;
+}
+/**
+ * Rename + delete for one session, shared by the rail kebab and the history
+ * row menu so both drive the same dialogs and the same product mutations.
+ *
+ * Dialogs are owned here rather than returned as raw state: two surfaces
+ * needing the same confirm step is exactly how a product ends up with two
+ * subtly different delete confirmations.
+ */
+declare function useSessionActions({ renameSession, deleteSession, onChanged, onDeletedCurrent, currentSessionId, notify, labels, }: SessionActionsOptions): SessionActions;
+interface SessionHistoryPanelProps {
+    history: SessionHistoryState;
+    /** Whether the workspace has any sessions at all — decided by the SSR page,
+     *  independent of the active search, so filtering to zero shows "no matches"
+     *  rather than the first-run empty state. */
+    hasAnySessions: boolean;
+    query: string;
+    onQueryChange: (value: string) => void;
+    sort: SessionSort;
+    onSortChange: (value: SessionSort) => void;
+    /** Product route for one session row. */
+    hrefForSession: (sessionId: string) => string;
+    /** Rendered as the row link. Defaults to an `<a>`; pass a router Link to keep
+     *  client-side navigation. */
+    linkComponent?: LinkLikeComponent;
+    /** Ids currently mid-turn — renders the responding treatment. */
+    respondingSessionIds?: ReadonlySet<string>;
+    onRename?: (session: SessionSummary) => void;
+    onDelete?: (session: SessionSummary) => void;
+    /** New-session destination for the header action. Omitted ⇒ no button. */
+    newSessionHref?: string;
+    title?: string;
+    untitledLabel?: string;
+    emptyTitle?: string;
+    emptyDescription?: string;
+    /** Absolute → relative timestamp. Defaults to a compact built-in. */
+    formatTimestamp?: (isoDate: string | null) => string;
+    /** Max width of the reading column. `'full'` opts out for a product whose
+     *  surface really is a wide table. Default keeps title and timestamp inside
+     *  one scannable line rather than at opposite edges of a 1440px viewport. */
+    contentWidth?: 'reading' | 'full';
+    className?: string;
+}
+interface LinkLikeProps {
+    to: string;
+    className?: string;
+    children?: ReactNode;
+}
+type LinkLikeComponent = (props: LinkLikeProps) => ReactNode;
+/** Compact relative time. Overridable — a product with its own i18n passes
+ *  `formatTimestamp` rather than this being the only option. */
+declare function formatSessionTimestamp(isoDate: string | null): string;
+/**
+ * The full session history: search, sort, cursor-paged rows with per-row
+ * actions, and the states in between (first-run empty, loading, no matches,
+ * error + retry).
+ *
+ * This is the surface the rail's capped list overflows into — the reason the
+ * rail can stay short without hiding the user's work.
+ */
+declare function SessionHistoryPanel({ history, hasAnySessions, query, onQueryChange, sort, onSortChange, hrefForSession, linkComponent: Link, respondingSessionIds, onRename, onDelete, newSessionHref, title, untitledLabel, emptyTitle, emptyDescription, formatTimestamp, contentWidth, className, }: SessionHistoryPanelProps): react.JSX.Element;
+
 /**
  * Keyboard + pointer model for a trigger-and-popover pair, dependency-free.
  * Outside-mousedown and Escape both close; Escape also returns focus to the
@@ -1384,4 +1542,4 @@ declare function useThinkingSeconds(active: boolean): number;
  */
 declare function ChatMessages({ messages, messageSize, models, renderMarkdown, renderExtras, durableCards, userLabel, agentLabel, loading, approval, onToolCallClick, toolRenderers, error, onRetry, renderEmpty, emptyState, header, resolveAttachmentUrl, workProductCards, }: ChatMessagesProps): react.JSX.Element;
 
-export { type ActivityTone, type AgentActivityPage, AgentActivityPanel, type AgentActivityPanelProps, type AgentActivityRecord, AgentSessionControls, type AgentSessionControlsProps, type AttachmentFileResult, CatalogModel, ChatAttachmentInput, ChatAttachmentKind, ChatAttachmentPart, ChatComposer, type ChatComposerProps, type ChatEmptyDoor, ChatEmptyState, type ChatEmptyStateProps, ChatInteraction, ChatInteractionField, type ChatInteractionRestoreMode, ChatInteractionStatus, ChatMentionPart, type ChatMessageMetrics, type ChatMessageSegment, ChatMessages, type ChatMessagesProps, ChatSelectField, type ChatStreamCallbacks, type ChatStreamToolCall, type ChatStreamToolResult, type ChatToolCallInfo, type ChatUiMessage, type ComposerFile, type ComposerFilePart, type ConsumeChatStreamResult, DEFAULT_EFFORT_LEVELS, type DurableChatCard, DurableChatCards, type DurableChatCardsProps, type DurableInteractionAnswerSubmitterOptions, DurablePlanCard, type DurablePlanCardProps, DurablePlanClientError, type DurablePlanCurrentInput, type DurablePlanDecision, type DurablePlanDecisionClient, type DurablePlanDecisionClientOptions, type DurablePlanDecisionInput, type DurablePlanDecisionResult, type DurablePlanFollowUpReceipt, type EffortLevel, EffortPicker, type EffortPickerProps, EvidenceLineageTable, type EvidenceLineageTableProps, ExceptionList, type ExceptionListProps, type FieldValues, FlowWaterfall, type FlowWaterfallProps, INTERACTION_SUBMIT_TIMEOUT_MESSAGE, INTERACTION_SUBMIT_TIMEOUT_MS, InteractionActionButton, type InteractionAnswerSubmission, type InteractionAnswerSubmitterOptions, InteractionAnswers, type InteractionAttemptStore, InteractionBadge, type InteractionBadgeVariant, InteractionCancelData, InteractionPlanCard, type InteractionPlanCardProps, InteractionQuestionCard, type InteractionQuestionCardProps, InteractionRequestWire, type InteractionSubmitResult, type MentionTextSegment, MessageAttachments, type MessageAttachmentsProps, MissionActivityLane, type MissionActivityLaneProps, ModelPicker, type ModelPickerProps, type ProposalApprovalHandlers, ProvenanceStamp, type ProvenanceStampProps, ProviderLogo, type ProviderLogoProps, QualityCheckList, type QualityCheckListProps, QuestionOptionList, type QuestionOptionListProps, type RestoreChatInteractionsOptions, ReviewQueueItem, type ReviewQueuePage, ReviewQueuePanel, type ReviewQueuePanelProps, ReviewQueueState, RunDrillIn, type RunDrillInProps, SeatPaywall, type SeatPaywallProps, type SmoothRevealOptions, type StreamChatOptions, type SubmitInteractionAnswer, type ToolDetailRenderers, type ToolRunRecord, type ToolRunStep, type UseChatInteractionsOptions, type UseChatInteractionsResult, type UseComposerAttachmentsOptions, type UseComposerAttachmentsResult, type UseDurablePlanFlowOptions, type UseDurablePlanFlowResult, type WaterfallRow, WorkProductCard, type WorkProductCardProps, __resetAttachmentFileCacheForTests, activityTone, buildAnswerData, cancelChatInteraction, consumeChatStream, createDurableInteractionAnswerSubmitter, createDurablePlanDecisionClient, createInteractionAnswerSubmitter, createMemoryInteractionAttemptStore, createSessionInteractionAttemptStore, dispatchChatStreamLine, durableChatCardsFromParts, fieldAnswer, fieldValuesFromAnswers, formatActivityCost, formatActivityDuration, formatModelCost, formatTokensPerSecond, hasSecretField, hydrateChatInteractions, interactionStatusLabels, interactionSubmissionSignature, interactionTerminalNotes, isLateAnswerableStatus, lateAnswerMessage, loadAttachmentFile, mergeActivityPages, mergeReviewQueuePages, nextRevealCount, pendingApprovalOf, resolveChatInteraction, responseErrorMessage, restoreChatInteractions, reviewQueueStateLabel, segmentMentionContent, settleInteractionSubmit, streamChatTurn, terminalizePendingChatInteractions, triggerAttachmentDownload, upsertChatInteraction, useChatInteractions, useComposerAttachments, useDurablePlanFlow, usePending, usePopover, useSmoothText, useThinkingSeconds, waterfallLayout, workProductPartsFromMessageParts, workProductStatusLabel };
+export { type ActivityTone, type AgentActivityPage, AgentActivityPanel, type AgentActivityPanelProps, type AgentActivityRecord, AgentSessionControls, type AgentSessionControlsProps, type AttachmentFileResult, CatalogModel, ChatAttachmentInput, ChatAttachmentKind, ChatAttachmentPart, ChatComposer, type ChatComposerProps, type ChatEmptyDoor, ChatEmptyState, type ChatEmptyStateProps, ChatInteraction, ChatInteractionField, type ChatInteractionRestoreMode, ChatInteractionStatus, ChatMentionPart, type ChatMessageMetrics, type ChatMessageSegment, ChatMessages, type ChatMessagesProps, ChatSelectField, type ChatStreamCallbacks, type ChatStreamToolCall, type ChatStreamToolResult, type ChatToolCallInfo, type ChatUiMessage, type ComposerFile, type ComposerFilePart, type ConsumeChatStreamResult, DEFAULT_EFFORT_LEVELS, type DurableChatCard, DurableChatCards, type DurableChatCardsProps, type DurableInteractionAnswerSubmitterOptions, DurablePlanCard, type DurablePlanCardProps, DurablePlanClientError, type DurablePlanCurrentInput, type DurablePlanDecision, type DurablePlanDecisionClient, type DurablePlanDecisionClientOptions, type DurablePlanDecisionInput, type DurablePlanDecisionResult, type DurablePlanFollowUpReceipt, type EffortLevel, EffortPicker, type EffortPickerProps, EvidenceLineageTable, type EvidenceLineageTableProps, ExceptionList, type ExceptionListProps, type FetchSessionPage, type FieldValues, FlowWaterfall, type FlowWaterfallProps, INTERACTION_SUBMIT_TIMEOUT_MESSAGE, INTERACTION_SUBMIT_TIMEOUT_MS, InteractionActionButton, type InteractionAnswerSubmission, type InteractionAnswerSubmitterOptions, InteractionAnswers, type InteractionAttemptStore, InteractionBadge, type InteractionBadgeVariant, InteractionCancelData, InteractionPlanCard, type InteractionPlanCardProps, InteractionQuestionCard, type InteractionQuestionCardProps, InteractionRequestWire, type InteractionSubmitResult, type LinkLikeComponent, type LinkLikeProps, type MentionTextSegment, MessageAttachments, type MessageAttachmentsProps, MissionActivityLane, type MissionActivityLaneProps, ModelPicker, type ModelPickerProps, type ProposalApprovalHandlers, ProvenanceStamp, type ProvenanceStampProps, ProviderLogo, type ProviderLogoProps, QualityCheckList, type QualityCheckListProps, QuestionOptionList, type QuestionOptionListProps, type RestoreChatInteractionsOptions, ReviewQueueItem, type ReviewQueuePage, ReviewQueuePanel, type ReviewQueuePanelProps, ReviewQueueState, RunDrillIn, type RunDrillInProps, SeatPaywall, type SeatPaywallProps, type SessionActionLabels, type SessionActions, type SessionActionsOptions, SessionHistoryPanel, type SessionHistoryPanelProps, type SessionHistoryState, type SessionPageQuery, type SmoothRevealOptions, type StreamChatOptions, type SubmitInteractionAnswer, type ToolDetailRenderers, type ToolRunRecord, type ToolRunStep, type UseChatInteractionsOptions, type UseChatInteractionsResult, type UseComposerAttachmentsOptions, type UseComposerAttachmentsResult, type UseDurablePlanFlowOptions, type UseDurablePlanFlowResult, type UseInfiniteScrollOptions, type UseSessionHistoryOptions, type WaterfallRow, WorkProductCard, type WorkProductCardProps, __resetAttachmentFileCacheForTests, activityTone, buildAnswerData, cancelChatInteraction, consumeChatStream, createDurableInteractionAnswerSubmitter, createDurablePlanDecisionClient, createInteractionAnswerSubmitter, createMemoryInteractionAttemptStore, createSessionInteractionAttemptStore, dispatchChatStreamLine, durableChatCardsFromParts, fieldAnswer, fieldValuesFromAnswers, formatActivityCost, formatActivityDuration, formatModelCost, formatSessionTimestamp, formatTokensPerSecond, hasSecretField, hydrateChatInteractions, interactionStatusLabels, interactionSubmissionSignature, interactionTerminalNotes, isLateAnswerableStatus, lateAnswerMessage, loadAttachmentFile, mergeActivityPages, mergeReviewQueuePages, nextRevealCount, pendingApprovalOf, resolveChatInteraction, responseErrorMessage, restoreChatInteractions, reviewQueueStateLabel, segmentMentionContent, settleInteractionSubmit, streamChatTurn, terminalizePendingChatInteractions, triggerAttachmentDownload, upsertChatInteraction, useChatInteractions, useComposerAttachments, useDurablePlanFlow, useInfiniteScroll, usePending, usePopover, useSessionActions, useSessionHistory, useSmoothText, useThinkingSeconds, waterfallLayout, workProductPartsFromMessageParts, workProductStatusLabel };

package/dist/web-react/index.js

@@ -26,6 +26,7 @@ import {
   QuestionOptionList,
   RunDrillIn,
   SeatPaywall,
+  SessionHistoryPanel,
   __resetAttachmentFileCacheForTests,
   activityTone,
   buildAnswerData,
@@ -43,6 +44,7 @@ import {
   formatActivityCost,
   formatActivityDuration,
   formatModelCost,
+  formatSessionTimestamp,
   formatTokensPerSecond,
   hasSecretField,
   hydrateChatInteractions,
@@ -68,13 +70,17 @@ import {
   useChatInteractions,
   useDurablePlanFlow,
   useFileMentions,
+  useInfiniteScroll,
   usePending,
   usePopover,
+  useSessionActions,
+  useSessionHistory,
   useSmoothText,
   useThinkingSeconds,
   waterfallLayout
-} from "../chunk-LNRDDXME.js";
+} from "../chunk-T3TYG3VW.js";
 import "../chunk-FBVLEGEG.js";
+import "../chunk-3E4MW5LR.js";
 import {
   EvidenceLineageTable,
   ExceptionList,
@@ -193,6 +199,7 @@ export {
   ReviewQueuePanel,
   RunDrillIn,
   SeatPaywall,
+  SessionHistoryPanel,
   WorkProductCard,
   __resetAttachmentFileCacheForTests,
   activityTone,
@@ -225,6 +232,7 @@ export {
   formatActivityCost,
   formatActivityDuration,
   formatModelCost,
+  formatSessionTimestamp,
   formatTokensPerSecond,
   hasSecretField,
   hydrateChatInteractions,
@@ -274,9 +282,12 @@ export {
   useComposerAttachments,
   useDurablePlanFlow,
   useFileMentions,
+  useInfiniteScroll,
   usePending,
   usePopover,
   useSandboxTerminalConnection,
+  useSessionActions,
+  useSessionHistory,
   useSmoothText,
   useThinkingSeconds,
   waterfallLayout,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-app",
-  "version": "0.44.41",
+  "version": "0.44.46",
   "packageManager": "pnpm@10.33.4",
   "description": "Application-shell framework for Tangle agent products: a bounded tool loop, the structured agent→app tool side channel, integration-hub client, per-workspace billing, and crypto — composed over the Tangle agent substrate through typed seams.",
   "keywords": [
@@ -207,6 +207,11 @@
       "import": "./dist/missions/index.js",
       "default": "./dist/missions/index.js"
     },
+    "./session-shell": {
+      "types": "./dist/session-shell/index.d.ts",
+      "import": "./dist/session-shell/index.js",
+      "default": "./dist/session-shell/index.js"
+    },
     "./web": {
       "types": "./dist/web/index.d.ts",
       "import": "./dist/web/index.js",

package/dist/DesignCanvas-Z362I3R3.js

@@ -1,10 +0,0 @@
-import {
-  DesignCanvas
-} from "./chunk-O63WWYET.js";
-import "./chunk-VTWKH4YU.js";
-import "./chunk-VWOPOLVO.js";
-import "./chunk-PTUMBMVH.js";
-export {
-  DesignCanvas
-};
-//# sourceMappingURL=DesignCanvas-Z362I3R3.js.map