@kortix/ui 0.14.8 → 0.14.9

package/dist/i18n/ui-catalog/localize-ui-catalog.js

@@ -25,6 +25,8 @@ const DISPLAY_PROPERTIES = new Set([
     'title',
     'tooltip',
 ]);
+/** Structural keys: a discriminant or an address, never copy. Translating one breaks the shape (2026-10-28: Italian turned `kind: 'steps'` into 'passaggi' and the /it/slack build crashed). */
+const STRUCTURAL_PROPERTIES = new Set(['kind', 'type', 'id', 'href', 'variant', 'icon', 'tone', 'status']);
 export function translateUiCatalogText(value, tI18nComplete, translationKeys) {
     if (value.length === 0)
         return value;
@@ -41,6 +43,8 @@ export function localizeUiCatalog(value, tI18nComplete, translationKeys) {
     if (!value || typeof value !== 'object' || '$$typeof' in value)
         return value;
     return Object.fromEntries(Object.entries(value).map(([key, entry]) => {
+        if (STRUCTURAL_PROPERTIES.has(key))
+            return [key, entry];
         if (typeof entry === 'string' && DISPLAY_PROPERTIES.has(key)) {
             return [key, translateUiCatalogText(entry, tI18nComplete, translationKeys)];
         }

package/dist/i18n/ui-catalog/remaining-ui-translation-keys.generated.js

@@ -1,5 +1,17 @@
 // Generated from the final user-visible i18n audit. Keys are SHA-256(message)[0:12].
 export const REMAINING_UI_TRANSLATION_KEYS = {
+    "Connector events": 'text0ba357fa63f8',
+    "Connector event": 'textca395c4d19b2',
+    "connector event": 'text6064256ee716',
+    "New connector event": 'text85a6c98e5584',
+    "Search connector events": 'text165d9237c163',
+    "No connector events yet": 'texta9caf7909165',
+    "Have an agent run when one of your Kortix Apps emits an event.": 'text451ef98453d2',
+    "App event": 'text5441e7146193',
+    "New App event": 'text064694999e1f',
+    "Search App events": 'text1934aa0740bb',
+    "No App events yet": 'text25db7e5609e5',
+    "An App starts agents by emitting events. Add a trigger with on: { event, app } in kortix.yaml.": 'text9f8f92588517',
     Drive: 'text6312b4b9baf1',
     Drives: 'text729fe0e7b138',
     '{label} has finished.': 'text27d628c8b427',
@@ -201,9 +213,9 @@ export const REMAINING_UI_TRANSLATION_KEYS = {
     'Every tool runs without asking. Only the rules below can stop one.': 'texta63fb2eebd02',
     'Everything an owner can do except deleting the account or transferring ownership. Also Manager on every project.': 'textc8ef36aed650',
     Expired: 'text424a2551d356',
-    'Converts the v1 kortix.toml into the governance-first kortix.yaml, refreshes platform-managed skills to the latest marketplace baseline, and opens a change request for review.': 'textc3d1545dd522',
+    'Moves kortix.toml or a version 2 kortix.yaml to version 3: the project registers skills, tools, commands and extensions, and each agent enables them by name. Refreshes platform-managed skills and opens a change request for review.': 'text7823a1f3af93',
     Extensions: 'textfe3436af86b4',
-    'Migrate manifest to v2 (kortix.yaml)': 'textd85a383e851d',
+    'Upgrade manifest to v3 (kortix.yaml)': 'text08edd5b6dcdc',
     Failed: 'text031a8f0f659d',
     Favicon: 'text4295528943df',
     'Fetching deals updated ≤ 7d': 'text5bae674104b6',
@@ -778,7 +790,7 @@ export const REMAINING_UI_TRANSLATION_KEYS = {
     'What does an agent actually run on?': 'text7b84ea95f8ae',
     'Its own machine. Every session boots an isolated Linux cloud computer with your repo and your tools already on it, on its own git branch — the session id, the sandbox id and the branch name are one and the same string. The agent can install, run and break anything inside it; only what it commits survives, because the machine is destroyed with everything on it.': 'text97bbd1c3b346',
     'What stops it doing something I did not want?': 'textc145665dd580',
-    'You set allow, ask or block per action, and a rule can match on a glob, a regular expression, or the arguments of the call itself. Be aware that nothing is switched on for you: a project with no policy declared runs every action, so this is a thing you configure rather than a thing you inherit. Session work reaches main through a change request, and merge is default-deny for an agent — an admin has to grant it in kortix.yaml, and that grant is itself an edit somebody else has to merge.': 'texta9fe46474f33',
+    'You set allow, ask or block per action, and a rule can match on a glob, a regular expression, or the arguments of the call itself. Be aware that nothing is switched on for you: a project with no policy declared runs every action, so this is a thing you configure rather than a thing you inherit. Session work reaches main through a change request, and merge is default-deny for an agent unless an admin grants it.': 'texta9fe46474f33',
     'Can I see everything an agent did?': 'text3a8d0e57770e',
     'It is all recorded, on every plan. Recording is never gated — actions, approvals and the session transcript are captured whatever you pay. Reading, exporting and streaming that audit trail out to your own SIEM is an Enterprise entitlement, so on the lower plans the record exists but the export does not.': 'text36814e8d3c88',
     'Is my company data yours?': 'text618ad8d1c91a',

package/dist/index.d.ts

@@ -25,11 +25,11 @@ export { Message, MessageAvatar, MessageContent, MessageFooter, MessageGroup, Me
 export { Marker, MarkerContent, MarkerIcon, markerVariants, } from './primitives/marker.js';
 export { useDebounce } from './hooks/use-debounce.js';
 export { useIsMobile } from './hooks/use-mobile.js';
-export { useMediaQuery } from './internal/hooks/use-media-query.js';
+export { useMediaQuery } from './hooks/use-media-query.js';
 export { useSlashFocus } from './internal/hooks/use-slash-focus.js';
 export { faviconUrlForHostname } from './lib/favicon.js';
 export { setUiHostEnv } from './lib/host-env.js';
-export { defaultUiRoutes, setUiRoutes, uiRoutes, type UiRoutes } from './lib/routes.js';
+export { decodeSpaceSegment, defaultUiRoutes, setUiRoutes, uiRoutes, type UiRoutes } from './lib/routes.js';
 export { DEFAULT_ICON_WEIGHT, ICON_WEIGHTS, SHIPPED_ICON_WEIGHTS } from './lib/icon-config.js';
 export { lazyClient } from './lib/lazy-client.js';
 export { spring } from './lib/springs.js';

package/dist/index.js

@@ -34,11 +34,11 @@ export { Message, MessageAvatar, MessageContent, MessageFooter, MessageGroup, Me
 export { Marker, MarkerContent, MarkerIcon, markerVariants, } from './primitives/marker.js';
 export { useDebounce } from './hooks/use-debounce.js';
 export { useIsMobile } from './hooks/use-mobile.js';
-export { useMediaQuery } from './internal/hooks/use-media-query.js';
+export { useMediaQuery } from './hooks/use-media-query.js';
 export { useSlashFocus } from './internal/hooks/use-slash-focus.js';
 export { faviconUrlForHostname } from './lib/favicon.js';
 export { setUiHostEnv } from './lib/host-env.js';
-export { defaultUiRoutes, setUiRoutes, uiRoutes } from './lib/routes.js';
+export { decodeSpaceSegment, defaultUiRoutes, setUiRoutes, uiRoutes } from './lib/routes.js';
 export { DEFAULT_ICON_WEIGHT, ICON_WEIGHTS, SHIPPED_ICON_WEIGHTS } from './lib/icon-config.js';
 export { lazyClient } from './lib/lazy-client.js';
 export { spring } from './lib/springs.js';

package/dist/internal/account-hub/account-settings-sidebar.js

@@ -47,7 +47,7 @@ const ROW_CLASS = 'text-sidebar-foreground/75 font-medium hover:bg-hover hover:t
 // stay put. Same two targets the user menu's Help group lists first.
 const FOOTER_LINKS = [
     { label: 'Docs', href: '/docs', icon: BookOpenIcon },
-    { label: 'Support', href: '/support', icon: QuestionIcon },
+    { label: 'Support', href: '/contact', icon: QuestionIcon },
 ];
 function NavRow({ entry }) {
     const { isMobile, setOpenMobile } = useSidebar();

package/dist/internal/account-hub/hub-sheet.d.ts

@@ -18,7 +18,8 @@
  * footer (`AccessDialog`) goes in `body` alone and draws its own sticky
  * footer: it reads `useInAccountHubSheetBody()`.
  */
-import { type ReactNode } from 'react';
+import { type ComponentProps, type ReactNode } from 'react';
+import { SelectionBar } from '../selection/selection-bar.js';
 export interface AccountHubSheetContent {
     title: ReactNode;
     description?: ReactNode;
@@ -29,6 +30,13 @@ export interface AccountHubSheet {
     open: (content: AccountHubSheetContent) => void;
     close: () => void;
 }
+/**
+ * A pane's bulk-action bar: the shared `SelectionBar`, pinned to the bottom of
+ * the hub's page column. The column scrolls, so `sticky` would stop under a
+ * short list: this renders into a slot that overlays the column's bottom edge
+ * and never scrolls. Render it only while something is selected.
+ */
+export declare function AccountHubSelectionBar(props: ComponentProps<typeof SelectionBar>): import("react").ReactPortal | null;
 /** True inside the hub sheet's body: a form there draws the sheet layout, not a modal. */
 export declare function useInAccountHubSheetBody(): boolean;
 /** Opens and closes the hub's split sheet. Throws outside the hub shell. */

package/dist/internal/account-hub/hub-sheet.js

@@ -19,10 +19,25 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * footer (`AccessDialog`) goes in `body` alone and draws its own sticky
  * footer: it reads `useInAccountHubSheetBody()`.
  */
-import { createContext, useCallback, useContext, useMemo, useState } from 'react';
+import { createContext, useCallback, useContext, useMemo, useState, } from 'react';
+import { createPortal } from 'react-dom';
+import { SelectionBar } from '../selection/selection-bar.js';
 import { SplitSheet, SplitSheetBody, SplitSheetContent, SplitSheetDescription, SplitSheetFooter, SplitSheetHeader, SplitSheetMain, SplitSheetTitle, } from '../../primitives/split-sheet.js';
 const AccountHubSheetContext = createContext(null);
 const SheetBodyContext = createContext(false);
+const BottomBarSlotContext = createContext(null);
+/**
+ * A pane's bulk-action bar: the shared `SelectionBar`, pinned to the bottom of
+ * the hub's page column. The column scrolls, so `sticky` would stop under a
+ * short list: this renders into a slot that overlays the column's bottom edge
+ * and never scrolls. Render it only while something is selected.
+ */
+export function AccountHubSelectionBar(props) {
+    const slot = useContext(BottomBarSlotContext);
+    if (!slot)
+        return null;
+    return createPortal(_jsx("div", { className: "pointer-events-auto w-full max-w-xl", children: _jsx(SelectionBar, { ...props }) }), slot);
+}
 /** True inside the hub sheet's body: a form there draws the sheet layout, not a modal. */
 export function useInAccountHubSheetBody() {
     return useContext(SheetBodyContext);
@@ -39,8 +54,9 @@ export function AccountHubSheetProvider({ children }) {
     const [content, setContent] = useState(null);
     const close = useCallback(() => setContent(null), []);
     const sheet = useMemo(() => ({ open: setContent, close }), [close]);
-    return (_jsx(AccountHubSheetContext.Provider, { value: sheet, children: _jsxs(SplitSheet, { open: content !== null, onOpenChange: (next) => {
-                if (!next)
-                    close();
-            }, size: "md", children: [_jsx(SplitSheetMain, { children: children }), content ? (_jsxs(SplitSheetContent, { children: [_jsxs(SplitSheetHeader, { children: [_jsx(SplitSheetTitle, { children: content.title }), content.description ? (_jsx(SplitSheetDescription, { children: content.description })) : null] }), _jsx(SplitSheetBody, { children: _jsx(SheetBodyContext.Provider, { value: true, children: content.body }) }), content.footer ? _jsx(SplitSheetFooter, { children: content.footer }) : null] })) : null] }) }));
+    const [barSlot, setBarSlot] = useState(null);
+    return (_jsx(AccountHubSheetContext.Provider, { value: sheet, children: _jsx(BottomBarSlotContext.Provider, { value: barSlot, children: _jsxs(SplitSheet, { open: content !== null, onOpenChange: (next) => {
+                    if (!next)
+                        close();
+                }, size: "md", children: [_jsx(SplitSheetMain, { children: children }), _jsx("div", { ref: setBarSlot, className: "pointer-events-none z-10 col-start-1 row-start-1 flex justify-center self-end px-4 pb-4 empty:hidden" }), content ? (_jsxs(SplitSheetContent, { children: [_jsxs(SplitSheetHeader, { children: [_jsx(SplitSheetTitle, { children: content.title }), content.description ? (_jsx(SplitSheetDescription, { children: content.description })) : null] }), _jsx(SplitSheetBody, { children: _jsx(SheetBodyContext.Provider, { value: true, children: content.body }) }), content.footer ? _jsx(SplitSheetFooter, { children: content.footer }) : null] })) : null] }) }) }));
 }

package/dist/internal/account-hub/sections.d.ts

@@ -43,7 +43,7 @@ export declare function localizedAccountPaneMeta(tI18nComplete: UiTranslator): P
  * next step up, and the usage ledger needs the room a table with seven
  * columns takes.
  */
-/** `fluid`: the whole pane, Linear's members table — no centred column. */
+/** `fluid`: the whole pane, for the members and project tables — no centred column. */
 export type AccountPaneWidth = 'default' | 'wide' | 'full' | 'fluid';
 export declare function paneWidth(section: AccountSection): AccountPaneWidth;
 /**

package/dist/internal/account-hub/sections.js

@@ -127,7 +127,6 @@ export function localizedAccountPaneMeta(tI18nComplete) {
 }
 const WIDE_SECTIONS = [
     'groups',
-    'access-projects',
     'roles',
     'identity',
     'help',
@@ -135,7 +134,9 @@ const WIDE_SECTIONS = [
     'billing',
 ];
 const PANE_WIDTH = {
+    // The Members table and the project tables share one width: the whole pane.
     members: 'fluid',
+    'access-projects': 'fluid',
     ...Object.fromEntries(WIDE_SECTIONS.map((section) => [section, 'wide'])),
     transactions: 'full',
 };

package/dist/internal/auth/auth-card-shell.js

@@ -23,9 +23,9 @@ export function AuthLegalFooter({ variant = 'default' }) {
         if (openExternalRoute(href))
             event.preventDefault();
     };
-    const terms = (_jsx(Link, { href: "/legal/terms", onClick: (event) => onLegalClick(event, '/legal/terms'), className: "hover:text-muted-foreground transition-colors", children: t('termsOfService') }));
-    const privacy = (_jsx(Link, { href: "/legal?tab=privacy", onClick: (event) => onLegalClick(event, '/legal?tab=privacy'), className: "hover:text-muted-foreground transition-colors", children: t('privacyPolicy') }));
-    return (_jsx("footer", { className: "text-muted-foreground/60 mx-auto max-w-[380px] px-6 pb-10 text-center text-sm text-balance", children: variant === 'continue'
+    const terms = (_jsx(Link, { href: "/legal/terms", onClick: (event) => onLegalClick(event, '/legal/terms'), className: "hover:text-foreground transition-colors", children: t('termsOfService') }));
+    const privacy = (_jsx(Link, { href: "/legal?tab=privacy", onClick: (event) => onLegalClick(event, '/legal?tab=privacy'), className: "hover:text-foreground transition-colors", children: t('privacyPolicy') }));
+    return (_jsx("footer", { className: "text-muted-foreground mx-auto max-w-[380px] px-6 pb-10 text-center text-sm text-balance", children: variant === 'continue'
             ? t.rich('byContinuingYouAgree', {
                 termsOfService: () => terms,
                 privacyPolicy: () => privacy,

package/dist/internal/components/agent-mark.js

@@ -22,7 +22,10 @@ export function agentMarkVars(slug) {
 }
 /** The bare pixel figure, painted with `--mark-ink` from an ancestor. */
 export function AgentMarkGlyph({ slug, size }) {
-    return (_jsx("svg", { "aria-hidden": true, width: size, height: size, viewBox: `0 0 ${PIXEL_MARK_SIZE} ${PIXEL_MARK_SIZE}`, shapeRendering: "crispEdges", className: "shrink-0", children: _jsx("path", { d: pixelMark(slug).path, className: "fill-(--mark-ink)" }) }));
+    return (_jsx("svg", { "aria-hidden": true, width: size, height: size, 
+        // Inline, so a host's `[&_svg]:size-4` default (menu rows) cannot rescale
+        // the 7-pixel grid off whole device pixels.
+        style: { width: size, height: size }, viewBox: `0 0 ${PIXEL_MARK_SIZE} ${PIXEL_MARK_SIZE}`, shapeRendering: "crispEdges", className: "shrink-0", children: _jsx("path", { d: pixelMark(slug).path, className: "fill-(--mark-ink)" }) }));
 }
 /**
  * An agent's pixel mark on its tile — the agent's face wherever it appears:
@@ -30,7 +33,7 @@ export function AgentMarkGlyph({ slug, size }) {
  */
 export function AgentMark({ slug, size = 14, tile = TILE[size], label, className, }) {
     // A mark is a face, not a name: the hover hint says whose face it is.
-    const mark = (_jsx("span", { "aria-hidden": true, style: { ...agentMarkVars(slug), width: tile, height: tile }, className: cn('inline-flex shrink-0 items-center justify-center bg-(--mark-tile)', size >= 28 ? 'rounded-md' : 'rounded-sm', className), children: _jsx(AgentMarkGlyph, { slug: slug, size: size }) }));
+    const mark = (_jsx("span", { "aria-hidden": true, "data-slot": "agent-mark", style: { ...agentMarkVars(slug), width: tile, height: tile }, className: cn('inline-flex shrink-0 items-center justify-center bg-(--mark-tile)', size >= 28 ? 'rounded-md' : 'rounded-sm', className), children: _jsx(AgentMarkGlyph, { slug: slug, size: size }) }));
     return (_jsx(Hint, { side: "top", sideOffset: 6, alignOffset: 0, label: label ?? agentLabel(slug), children: mark }));
 }
 function agentLabel(slug) {

package/dist/internal/connector-logo/connector-logo-source.d.ts

@@ -0,0 +1,63 @@
+/** @internal Kortix apps only. No semver: it may change in any release. */
+/**
+ * Which logo a connector shows. ONE rule for every surface — catalogue card,
+ * app page, connector page, Connected list, account rows, pickers, channel
+ * heroes, approvals — so an app looks the same wherever it appears.
+ *
+ * 1. A Kortix-built connector (Slack, Teams, Email, Telegram, Computer) shows
+ *    its banner mark: the Slack and Teams brand components, the Phosphor
+ *    envelope, plane and monitor glyphs (`ConnectorLogo` draws them). The
+ *    files under `apps/web/public/connector-icons/<app>.svg` are the same
+ *    marks, for consumers that need a URL, so an icon URL pointing at one is
+ *    read as that app too.
+ * 2. Else the app's own icon URL: the catalogue record's, or the one the API
+ *    resolved for an installed connector (`AdminConnector.iconUrl`).
+ * 3. Else the favicon of a PUBLIC catalogue domain. Never of a connector's own
+ *    URL: a custom MCP or API host may be private, and the favicon service
+ *    would learn it (the API holds the same line, `connector-icon.ts`).
+ * 4. Else the neutral fallback glyph.
+ */
+export type NativeConnectorApp = 'slack' | 'teams' | 'email' | 'telegram' | 'computer';
+/** Whatever a surface knows about the connector; every field optional. */
+export interface ConnectorLogoSource {
+    /** Connector slug (`kortix_email`, `computer`) or catalogue id (`native:email`). */
+    slug?: string | null;
+    /** `AdminConnector.provider`: `channel`, `computer`, `composio`, `mcp`, … */
+    provider?: string | null;
+    /** A channel connector's platform. */
+    platform?: string | null;
+    /** The Kortix app a catalogue record names (`DiscoverConnector.kortix.app`). */
+    nativeApp?: string | null;
+    /** The app's own icon URL, when the source has one. */
+    icon?: string | null;
+    /** A public catalogue domain (never a connector's own URL). */
+    domain?: string | null;
+}
+export type ConnectorLogoKind = {
+    kind: 'native';
+    app: NativeConnectorApp;
+} | {
+    kind: 'image';
+    src: string;
+} | {
+    kind: 'none';
+};
+export declare function nativeConnectorApp(source: ConnectorLogoSource): NativeConnectorApp | null;
+export declare function resolveConnectorLogo(source: ConnectorLogoSource): ConnectorLogoKind;
+/** A catalogue record (Discover) as a logo source. */
+export declare function discoverLogoSource(connector: {
+    id?: string | null;
+    slug?: string | null;
+    icon?: string | null;
+    domain?: string | null;
+    kortix?: {
+        app?: string | null;
+    } | null;
+}): ConnectorLogoSource;
+/** An installed connector (`AdminConnector`) as a logo source. */
+export declare function installedConnectorLogoSource(connector: {
+    slug: string;
+    provider?: string | null;
+    platform?: string | null;
+    iconUrl?: string | null;
+}): ConnectorLogoSource;

package/dist/internal/connector-logo/connector-logo-source.js

@@ -0,0 +1,48 @@
+import { faviconUrlForHostname } from '../../lib/favicon.js';
+const NATIVE_APPS = ['slack', 'teams', 'email', 'telegram', 'computer'];
+function isNative(value) {
+    return !!value && NATIVE_APPS.includes(value);
+}
+export function nativeConnectorApp(source) {
+    if (isNative(source.nativeApp))
+        return source.nativeApp;
+    if (source.provider === 'computer')
+        return 'computer';
+    if (source.provider === 'channel' && isNative(source.platform))
+        return source.platform;
+    const slug = (source.slug ?? '').toLowerCase();
+    const match = /^(?:native:|kortix_)(slack|teams|email|telegram|computer)$/.exec(slug);
+    if (match)
+        return match[1];
+    if (slug === 'computer' || slug === 'computers')
+        return 'computer';
+    const file = /\/connector-icons\/(slack|teams|email|telegram|computer)\.svg$/.exec(source.icon ?? '');
+    return file ? file[1] : null;
+}
+export function resolveConnectorLogo(source) {
+    const native = nativeConnectorApp(source);
+    if (native)
+        return { kind: 'native', app: native };
+    if (source.icon)
+        return { kind: 'image', src: source.icon };
+    const domain = source.domain?.trim();
+    return domain ? { kind: 'image', src: faviconUrlForHostname(domain) } : { kind: 'none' };
+}
+/** A catalogue record (Discover) as a logo source. */
+export function discoverLogoSource(connector) {
+    return {
+        slug: connector.id ?? connector.slug,
+        nativeApp: connector.kortix?.app ?? null,
+        icon: connector.icon,
+        domain: connector.domain,
+    };
+}
+/** An installed connector (`AdminConnector`) as a logo source. */
+export function installedConnectorLogoSource(connector) {
+    return {
+        slug: connector.slug,
+        provider: connector.provider,
+        platform: connector.platform,
+        icon: connector.iconUrl,
+    };
+}

package/dist/internal/connector-logo/connector-logo.d.ts

@@ -0,0 +1,39 @@
+/** @internal Kortix apps only. No semver: it may change in any release. */
+import { type ComponentType } from 'react';
+import { type ConnectorLogoSource, type NativeConnectorApp } from './connector-logo-source.js';
+export type { ConnectorLogoSource } from './connector-logo-source.js';
+declare const TILE: {
+    readonly xs: "size-5 rounded-sm";
+    readonly sm: "size-6 rounded-sm";
+    readonly md: "size-8 rounded-md";
+    readonly lg: "size-9 rounded-md";
+    readonly xl: "size-14 rounded-xl";
+};
+export type ConnectorLogoSize = keyof typeof TILE;
+/**
+ * The marks of the Kortix-built connectors, as their channel banners draw
+ * them; brand marks keep their colours. `apps/web/public/connector-icons/<app>.svg`
+ * is this mark rendered on its tile (`connector-mark-files.tsx`), so the URL
+ * the API catalogue sends and this component are one image.
+ */
+export declare const NATIVE_MARK: Record<NativeConnectorApp, {
+    Mark: ComponentType<{
+        className?: string;
+    }>;
+    brand: boolean;
+}>;
+/**
+ * A connector's logo — the only one. Every connector, app and account surface
+ * renders this, so the same app shows the same mark everywhere
+ * (`connector-logo-source.ts` holds the rule).
+ *
+ * Kortix-built connectors and connectors with no logo draw a mark on the
+ * banner tile. A catalogue logo is the bare image: its own shape is the edge.
+ * A URL that fails to load latches per URL (a swapped URL gets a fresh try)
+ * and shows the neutral fallback, so "missing" and "broken" look identical.
+ */
+export declare function ConnectorLogo({ source, size, className, }: {
+    source: ConnectorLogoSource;
+    size?: ConnectorLogoSize;
+    className?: string;
+}): import("react").JSX.Element;

package/dist/internal/connector-logo/connector-logo.js

@@ -0,0 +1,56 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { EnvelopeSimpleIcon, MonitorIcon, PlugIcon } from '@phosphor-icons/react';
+import { useState } from 'react';
+import { MicrosoftTeams } from '../icons/microsoft-teams.js';
+import { Slack } from '../icons/slack.js';
+import { Telegram } from '../icons/telegram.js';
+import { cn } from '../lib/utils.js';
+import { resolveConnectorLogo, } from './connector-logo-source.js';
+const TILE = {
+    xs: 'size-5 rounded-sm',
+    sm: 'size-6 rounded-sm',
+    md: 'size-8 rounded-md',
+    lg: 'size-9 rounded-md',
+    xl: 'size-14 rounded-xl',
+};
+const MARK = { xs: 'size-3', sm: 'size-3.5', md: 'size-4', lg: 'size-5', xl: 'size-7' };
+/**
+ * The marks of the Kortix-built connectors, as their channel banners draw
+ * them; brand marks keep their colours. `apps/web/public/connector-icons/<app>.svg`
+ * is this mark rendered on its tile (`connector-mark-files.tsx`), so the URL
+ * the API catalogue sends and this component are one image.
+ */
+export const NATIVE_MARK = {
+    slack: { Mark: Slack, brand: true },
+    teams: { Mark: MicrosoftTeams, brand: true },
+    telegram: { Mark: Telegram, brand: true },
+    email: { Mark: EnvelopeSimpleIcon, brand: false },
+    computer: { Mark: MonitorIcon, brand: false },
+};
+/** The tile a mark sits on: the channel banner's (background, hairline border). */
+function MarkTile({ size, className, children, }) {
+    return (_jsx("span", { "aria-hidden": true, className: cn('bg-background flex shrink-0 items-center justify-center border', TILE[size], className), children: children }));
+}
+/**
+ * A connector's logo — the only one. Every connector, app and account surface
+ * renders this, so the same app shows the same mark everywhere
+ * (`connector-logo-source.ts` holds the rule).
+ *
+ * Kortix-built connectors and connectors with no logo draw a mark on the
+ * banner tile. A catalogue logo is the bare image: its own shape is the edge.
+ * A URL that fails to load latches per URL (a swapped URL gets a fresh try)
+ * and shows the neutral fallback, so "missing" and "broken" look identical.
+ */
+export function ConnectorLogo({ source, size = 'lg', className, }) {
+    const logo = resolveConnectorLogo(source);
+    const [failedUrl, setFailedUrl] = useState(null);
+    if (logo.kind === 'native') {
+        const { Mark, brand } = NATIVE_MARK[logo.app];
+        return (_jsx(MarkTile, { size: size, className: className, children: _jsx(Mark, { className: cn('shrink-0', MARK[size], !brand && 'text-muted-foreground') }) }));
+    }
+    if (logo.kind === 'none' || failedUrl === logo.src) {
+        return (_jsx(MarkTile, { size: size, className: className, children: _jsx(PlugIcon, { className: cn('text-muted-foreground shrink-0', MARK[size]) }) }));
+    }
+    return (_jsx("span", { "aria-hidden": true, className: cn('flex shrink-0 items-center justify-center overflow-hidden', TILE[size], className), children: _jsx("img", { src: logo.src, alt: "", loading: "lazy", decoding: "async", referrerPolicy: "no-referrer", draggable: false, className: cn('size-full object-contain select-none', TILE[size]), onError: () => setFailedUrl(logo.src) }) }));
+}

package/dist/internal/connector-logo/connector-mark-files.d.ts

@@ -0,0 +1,11 @@
+/** @internal Kortix apps only. No semver: it may change in any release. */
+import type { NativeConnectorApp } from './connector-logo-source.js';
+/**
+ * The SVG file for a Kortix-built connector's logo
+ * (`apps/web/public/connector-icons/<app>.svg`): its `ConnectorLogo` mark on
+ * the tile, rendered from the same component. Written by
+ * `scripts/write-connector-marks.tsx`; `connector-mark-files.test.ts` fails
+ * when a committed file and this output differ.
+ */
+export declare function nativeMarkFileSvg(app: NativeConnectorApp): string;
+export declare const NATIVE_MARK_APPS: NativeConnectorApp[];

package/dist/internal/connector-logo/connector-mark-files.js

@@ -0,0 +1,35 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { renderToStaticMarkup } from 'react-dom/server';
+import { NATIVE_MARK } from './connector-logo.js';
+/** `MarkTile`'s look, as a file: white ground, hairline border, rounded corners. */
+const TILE_FILL = '#FFFFFF';
+const TILE_BORDER = '#E4E4E7';
+/** `text-muted-foreground` on the light ground, for the glyph marks. */
+const GLYPH_COLOR = '#71717A';
+const LABEL = {
+    slack: 'Slack',
+    teams: 'Microsoft Teams',
+    telegram: 'Telegram',
+    email: 'Email',
+    computer: 'Computer',
+};
+/**
+ * The SVG file for a Kortix-built connector's logo
+ * (`apps/web/public/connector-icons/<app>.svg`): its `ConnectorLogo` mark on
+ * the tile, rendered from the same component. Written by
+ * `scripts/write-connector-marks.tsx`; `connector-mark-files.test.ts` fails
+ * when a committed file and this output differ.
+ */
+export function nativeMarkFileSvg(app) {
+    const { Mark, brand } = NATIVE_MARK[app];
+    const markup = renderToStaticMarkup(_jsx(Mark, {}));
+    const open = markup.slice(0, markup.indexOf('>'));
+    // The mark's own size and class give way to its place on the tile.
+    const placed = open.replace(/ (?:class|width|height)="[^"]*"/g, '').replace(/^<svg/, '<svg x="8" y="8" width="20" height="20"');
+    const mark = (placed + markup.slice(open.length))
+        .replaceAll('currentColor', brand ? 'currentColor' : GLYPH_COLOR);
+    return (`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 36 36" role="img" aria-label="${LABEL[app]}">` +
+        `<rect x="0.5" y="0.5" width="35" height="35" rx="7.5" fill="${TILE_FILL}" stroke="${TILE_BORDER}"/>` +
+        `${mark}</svg>\n`);
+}
+export const NATIVE_MARK_APPS = Object.keys(LABEL);

package/dist/internal/files/file-read-retry.d.ts

@@ -25,4 +25,17 @@ export declare const SANDBOX_PARKED_REFETCH_INTERVAL_MS = 30000;
  * the file appears on its own in seconds. A parked box takes the slow lane.
  */
 export declare function sandboxWakingRefetchInterval(error: unknown, parked: boolean): number | false;
+/** The image wait's polls (R38): 1, 2, 4, 8 s, then every 10 s, about 2 min in all. */
+export declare const IMAGE_WAKING_ATTEMPTS = 15;
+/**
+ * The poll interval of an image read while the session runtime is still
+ * starting (`isRuntimeStartingError`), after its `failures`-th failed read:
+ * 1 s doubling to a 10 s cap; `false` (stop) after `IMAGE_WAKING_ATTEMPTS`,
+ * when the tile says the image is unavailable and offers Try again; `false`
+ * for any other error. A file viewer keeps `sandboxWakingRefetchInterval`
+ * (a parked box can take longer than an image tile should wait).
+ */
+export declare function imageWakingRefetchInterval(error: unknown, failures: number): number | false;
+/** True once an image read gave up waiting for the runtime (`imageWakingRefetchInterval`). */
+export declare function imageWaitedOut(error: unknown, failures: number): boolean;
 export declare function shouldRetryFileRead(filePath: string | null | undefined, failureCount: number, error: unknown): boolean;

package/dist/internal/files/file-read-retry.js

@@ -1,4 +1,4 @@
-import { isSandboxNotReadyError } from '@kortix/sdk';
+import { isRuntimeStartingError } from '@kortix/sdk';
 export const UPLOADED_FILE_READ_RETRY_DELAY_MS = 2_000;
 export const UPLOADED_FILE_READ_RETRY_WINDOW_MS = 60_000;
 export const UPLOADED_FILE_READ_MAX_RETRIES = Math.ceil(UPLOADED_FILE_READ_RETRY_WINDOW_MS / UPLOADED_FILE_READ_RETRY_DELAY_MS);
@@ -87,16 +87,36 @@ export const SANDBOX_PARKED_REFETCH_INTERVAL_MS = 30_000;
  * the file appears on its own in seconds. A parked box takes the slow lane.
  */
 export function sandboxWakingRefetchInterval(error, parked) {
-    if (!isSandboxNotReadyError(error))
+    // Also the runtime URL not pinned yet ("Server URL not ready"): it clears on its own too.
+    if (!isRuntimeStartingError(error))
         return false;
     return parked ? SANDBOX_PARKED_REFETCH_INTERVAL_MS : SANDBOX_WAKING_REFETCH_INTERVAL_MS;
 }
+/** The image wait's polls (R38): 1, 2, 4, 8 s, then every 10 s, about 2 min in all. */
+export const IMAGE_WAKING_ATTEMPTS = 15;
+/**
+ * The poll interval of an image read while the session runtime is still
+ * starting (`isRuntimeStartingError`), after its `failures`-th failed read:
+ * 1 s doubling to a 10 s cap; `false` (stop) after `IMAGE_WAKING_ATTEMPTS`,
+ * when the tile says the image is unavailable and offers Try again; `false`
+ * for any other error. A file viewer keeps `sandboxWakingRefetchInterval`
+ * (a parked box can take longer than an image tile should wait).
+ */
+export function imageWakingRefetchInterval(error, failures) {
+    if (!isRuntimeStartingError(error) || failures > IMAGE_WAKING_ATTEMPTS)
+        return false;
+    return Math.min(1000 * 2 ** Math.max(0, failures - 1), 10_000);
+}
+/** True once an image read gave up waiting for the runtime (`imageWakingRefetchInterval`). */
+export function imageWaitedOut(error, failures) {
+    return isRuntimeStartingError(error) && failures > IMAGE_WAKING_ATTEMPTS;
+}
 export function shouldRetryFileRead(filePath, failureCount, error) {
     // A parked/booting sandbox is not a failed read. Fail fast out of the inline
     // retry loop so the viewer can render its "waking up" state immediately; the
     // query-level poll (SANDBOX_WAKING_REFETCH_INTERVAL_MS) re-reads until the
     // sandbox is back.
-    if (isSandboxNotReadyError(error))
+    if (isRuntimeStartingError(error))
         return false;
     if (isUploadedWorkspacePath(filePath)) {
         if (isPermanentFileReadFailure(error) && !isMissingFileReadFailure(error))

package/dist/internal/files/session-drive-files.d.ts

@@ -37,7 +37,11 @@ interface DriveFilesScope {
     sessionId: string;
     queryClient: QueryClient;
 }
-/** Make `next` the session drive paths resolve against; returns its undo. */
+/**
+ * Make `next` the session drive paths resolve against; returns its undo. The
+ * undo restores the scope it replaced: a review item's files open over a
+ * session page, and closing them must not drop that page's scope.
+ */
 export declare function setSessionDriveFilesScope(next: DriveFilesScope): () => void;
 /** Make the open session's mounts the ones drive paths resolve against. */
 export declare function useSessionDriveFilesScope(projectId: string, sessionId: string): void;

package/dist/internal/files/session-drive-files.js

@@ -38,12 +38,17 @@ export function resolveSessionDriveFile(filePath, mounts) {
     return { driveId: best.driveId, path: `${stripTrailingSlashes(best.subdir)}${rest}` || '/' };
 }
 let scope = null;
-/** Make `next` the session drive paths resolve against; returns its undo. */
+/**
+ * Make `next` the session drive paths resolve against; returns its undo. The
+ * undo restores the scope it replaced: a review item's files open over a
+ * session page, and closing them must not drop that page's scope.
+ */
 export function setSessionDriveFilesScope(next) {
+    const previous = scope;
     scope = next;
     return () => {
         if (scope === next)
-            scope = null;
+            scope = previous;
     };
 }
 /** Make the open session's mounts the ones drive paths resolve against. */