@kortix/ui 0.14.7 → 0.14.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kortix/ui",
-  "version": "0.14.7",
+  "version": "0.14.9",
   "description": "Kortix UI: the shared React component library for apps/web, Kortix Apps and SDK hosts. Tailwind v4 classes, themed by CSS variables.",
   "type": "module",
   "license": "Elastic-2.0",
@@ -88,6 +88,10 @@
       "types": "./dist/apps/index.d.ts",
       "import": "./dist/apps/index.js"
     },
+    "./artifacts": {
+      "types": "./dist/artifacts/index.d.ts",
+      "import": "./dist/artifacts/index.js"
+    },
     "./avatar": {
       "types": "./dist/primitives/avatar.d.ts",
       "import": "./dist/primitives/avatar.js"
@@ -189,10 +193,6 @@
       "types": "./dist/customize/agents/agents-page.d.ts",
       "import": "./dist/customize/agents/agents-page.js"
     },
-    "./customize/connectors/catalog/use-catalog": {
-      "types": "./dist/customize/connectors/catalog/use-catalog.d.ts",
-      "import": "./dist/customize/connectors/catalog/use-catalog.js"
-    },
     "./customize/connectors/connector-routes": {
       "types": "./dist/customize/connectors/connector-routes.d.ts",
       "import": "./dist/customize/connectors/connector-routes.js"
@@ -233,6 +233,10 @@
       "types": "./dist/customize/sections/add-account-fields.d.ts",
       "import": "./dist/customize/sections/add-account-fields.js"
     },
+    "./customize/sections/component/email-connect-form": {
+      "types": "./dist/customize/sections/component/email-connect-form.d.ts",
+      "import": "./dist/customize/sections/component/email-connect-form.js"
+    },
     "./customize/sections/component/manifest-copy-block": {
       "types": "./dist/customize/sections/component/manifest-copy-block.d.ts",
       "import": "./dist/customize/sections/component/manifest-copy-block.js"
@@ -257,10 +261,6 @@
       "types": "./dist/customize/sections/component/telegram-channel-row.d.ts",
       "import": "./dist/customize/sections/component/telegram-channel-row.js"
     },
-    "./customize/sections/connector-connection-form": {
-      "types": "./dist/customize/sections/connector-connection-form.d.ts",
-      "import": "./dist/customize/sections/connector-connection-form.js"
-    },
     "./customize/sections/connector-oauth2": {
       "types": "./dist/customize/sections/connector-oauth2.d.ts",
       "import": "./dist/customize/sections/connector-oauth2.js"
@@ -273,10 +273,6 @@
       "types": "./dist/customize/sections/connector-oauth2-fields.d.ts",
       "import": "./dist/customize/sections/connector-oauth2-fields.js"
     },
-    "./customize/sections/connectors-view": {
-      "types": "./dist/customize/sections/connectors-view.d.ts",
-      "import": "./dist/customize/sections/connectors-view.js"
-    },
     "./customize/sections/gateway-view": {
       "types": "./dist/customize/sections/gateway-view.d.ts",
       "import": "./dist/customize/sections/gateway-view.js"
@@ -682,6 +678,10 @@
       "types": "./dist/primitives/empty.d.ts",
       "import": "./dist/primitives/empty.js"
     },
+    "./empty-art": {
+      "types": "./dist/primitives/empty-art.d.ts",
+      "import": "./dist/primitives/empty-art.js"
+    },
     "./empty-state": {
       "types": "./dist/primitives/empty-state.d.ts",
       "import": "./dist/primitives/empty-state.js"
@@ -911,6 +911,10 @@
       "types": "./dist/internal/capture/use-capture-area.d.ts",
       "import": "./dist/internal/capture/use-capture-area.js"
     },
+    "./internal/components/agent-mark": {
+      "types": "./dist/internal/components/agent-mark.d.ts",
+      "import": "./dist/internal/components/agent-mark.js"
+    },
     "./internal/components/hover-prefetch-link": {
       "types": "./dist/internal/components/hover-prefetch-link.d.ts",
       "import": "./dist/internal/components/hover-prefetch-link.js"
@@ -951,6 +955,10 @@
       "types": "./dist/internal/hooks/channels/use-channels-installations.d.ts",
       "import": "./dist/internal/hooks/channels/use-channels-installations.js"
     },
+    "./internal/hooks/channels/use-email-inboxes": {
+      "types": "./dist/internal/hooks/channels/use-email-inboxes.d.ts",
+      "import": "./dist/internal/hooks/channels/use-email-inboxes.js"
+    },
     "./internal/hooks/connectors/use-add-managed-account": {
       "types": "./dist/internal/hooks/connectors/use-add-managed-account.d.ts",
       "import": "./dist/internal/hooks/connectors/use-add-managed-account.js"
@@ -1023,10 +1031,6 @@
       "types": "./dist/internal/icons/home.d.ts",
       "import": "./dist/internal/icons/home.js"
     },
-    "./internal/icons/kortix": {
-      "types": "./dist/internal/icons/kortix.d.ts",
-      "import": "./dist/internal/icons/kortix.js"
-    },
     "./internal/icons/microsoft-teams": {
       "types": "./dist/internal/icons/microsoft-teams.d.ts",
       "import": "./dist/internal/icons/microsoft-teams.js"
@@ -1553,10 +1557,6 @@
       "types": "./dist/primitives/project-icon-picker.d.ts",
       "import": "./dist/primitives/project-icon-picker.js"
     },
-    "./providers/session-ids": {
-      "types": "./dist/providers/session-ids.d.ts",
-      "import": "./dist/providers/session-ids.js"
-    },
     "./providers/ui-provider": {
       "types": "./dist/providers/ui-provider.d.ts",
       "import": "./dist/providers/ui-provider.js"
@@ -1569,6 +1569,10 @@
       "types": "./dist/primitives/resizable.d.ts",
       "import": "./dist/primitives/resizable.js"
     },
+    "./resize-seam": {
+      "types": "./dist/primitives/resize-seam.d.ts",
+      "import": "./dist/primitives/resize-seam.js"
+    },
     "./scroll-area": {
       "types": "./dist/primitives/scroll-area.d.ts",
       "import": "./dist/primitives/scroll-area.js"
@@ -2017,14 +2021,6 @@
       "types": "./dist/workspace/projects/modal/project-icon-field.d.ts",
       "import": "./dist/workspace/projects/modal/project-icon-field.js"
     },
-    "./workspace/projects/onboarding/app-logo": {
-      "types": "./dist/workspace/projects/onboarding/app-logo.d.ts",
-      "import": "./dist/workspace/projects/onboarding/app-logo.js"
-    },
-    "./workspace/projects/onboarding/connect-app": {
-      "types": "./dist/workspace/projects/onboarding/connect-app.d.ts",
-      "import": "./dist/workspace/projects/onboarding/connect-app.js"
-    },
     "./workspace/projects/policies-panel": {
       "types": "./dist/workspace/projects/policies-panel.d.ts",
       "import": "./dist/workspace/projects/policies-panel.js"
@@ -2157,7 +2153,7 @@
     "@extend-ai/react-docx": "^0.7.5",
     "@extend-ai/react-xlsx": "0.13.4",
     "@glideapps/glide-data-grid": "6.0.4-alpha24",
-    "@kortix/llm-catalog": "0.14.7",
+    "@kortix/llm-catalog": "0.14.9",
     "@lezer/highlight": "1.2.3",
     "@paper-design/shaders-react": "^0.0.76",
     "@phosphor-icons/react": "2.1.10",
@@ -2189,12 +2185,15 @@
     "@tiptap/extension-document": "3.30.5",
     "@tiptap/extension-floating-menu": "3.30.5",
     "@tiptap/extension-hard-break": "3.30.5",
+    "@tiptap/extension-list": "3.30.5",
     "@tiptap/extension-paragraph": "3.30.5",
     "@tiptap/extension-placeholder": "3.30.5",
+    "@tiptap/extension-table": "3.30.5",
     "@tiptap/extension-text": "3.30.5",
     "@tiptap/extensions": "3.30.5",
     "@tiptap/pm": "3.30.5",
     "@tiptap/react": "3.30.5",
+    "@tiptap/starter-kit": "3.30.5",
     "@tiptap/suggestion": "3.30.5",
     "@uiw/codemirror-extensions-langs": "^4.23.10",
     "@uiw/codemirror-themes": "4.23.10",
@@ -2211,7 +2210,7 @@
     "date-fns": "^3.6.0",
     "diff": "^8.0.3",
     "frimousse": "^0.3.0",
-    "heic2any": "0.0.4",
+    "heic-to": "1.6.7",
     "i18next": "^26.3.6",
     "jszip": "^3.10.1",
     "katex": "^0.18.7",
@@ -2246,7 +2245,7 @@
     "zustand": "^5.0.3"
   },
   "peerDependencies": {
-    "@kortix/sdk": "^0.14.7",
+    "@kortix/sdk": "^0.14.9",
     "@tanstack/react-query": "^5.75.2",
     "@types/react": ">=18",
     "react": ">=19",

package/skills/kortix-ui/SKILL.md

@@ -7,7 +7,7 @@ description: "Build React UI with @kortix/ui, the Kortix component library and t
 
 `@kortix/ui` is the one React component library for every Kortix surface: `apps/web`, Kortix Apps, the
 white-label demo and SDK customer apps. Components are Tailwind v4 class strings that read CSS variables.
-Docs: https://kortix.com/docs/sdk/ui. Live catalog: https://kortix.com/design-system.
+Docs: https://kortix.com/docs/developers#kortix-ui. Live catalog: https://kortix.com/design-system.
 
 Install: `npm i @kortix/ui @kortix/sdk`, the same version of each (peers: `references/custom-dashboard.md`).
 Module entries and `@kortix/ui/theme` need 0.14.4+. Inside `kortix-ai/suna`: `"workspace:*"`. Never copy component source.
@@ -91,7 +91,7 @@ Theme with `@kortix/ui/theme`, never by forking a component: `themeToCss(theme)`
 | `@kortix/ui` (primitives, not for feature code: section 3) | `Dialog`, `DialogClose`, `DialogContent`, `DialogDescription`, `DialogFooter`, `DialogHeader`, `DialogOverlay`, `DialogPortal`, `DialogTitle`, `DialogTrigger`, `Tooltip`, `TooltipContent`, `TooltipProvider`, `TooltipTrigger` |
 | `@kortix/ui` (navigation) | `FilterBar`, `FilterBarItem`, `Tabs`, `TabsContent`, `TabsList`, `TabsListCompact`, `TabsTrigger`, `TabsTriggerCompact`, `tabsTriggerHeightVariants`, `tabsTriggerPaddingVariants`, `tabsTriggerTextVariants`, `TabsListType`, `TabsSize`, `TabsTriggerSize`, `TabsTriggerVariant`, `TabsUnderlineSize` |
 | `@kortix/ui` (conversation) | `Bubble`, `BubbleContent`, `BubbleGroup`, `BubbleReactions`, `bubbleVariants`, `Message`, `MessageAvatar`, `MessageContent`, `MessageFooter`, `MessageGroup`, `MessageHeader`, `Marker`, `MarkerContent`, `MarkerIcon`, `markerVariants` |
-| `@kortix/ui` (hooks, helpers) | `UiLink`, `UiImage`, `useUiViewer`, `UiViewer`, `UiHostComponents`, `UiPreviewUrlResolver`, `UiPreviewRequest`, `useDebounce`, `useIsMobile`, `useMediaQuery`, `useSlashFocus`, `lazyClient`, `spring`, `floatingZ`, `dialogContentZ`, `dialogOverlayZ`, `useDialogDepth`, `hasOpenFloatingLayer`, `hasOpenNestedDialog`, `DEFAULT_ICON_WEIGHT`, `ICON_WEIGHTS`, `SHIPPED_ICON_WEIGHTS`, `faviconUrlForHostname`, `setUiTelemetry`, `setUiHostEnv`, `setUiRoutes`, `uiRoutes`, `defaultUiRoutes`, `UiRoutes` |
+| `@kortix/ui` (hooks, helpers) | `UiLink`, `UiImage`, `useUiViewer`, `UiViewer`, `UiHostComponents`, `UiPreviewUrlResolver`, `UiPreviewRequest`, `useDebounce`, `useIsMobile`, `useMediaQuery`, `useSlashFocus`, `lazyClient`, `spring`, `floatingZ`, `dialogContentZ`, `dialogOverlayZ`, `useDialogDepth`, `hasOpenFloatingLayer`, `hasOpenNestedDialog`, `DEFAULT_ICON_WEIGHT`, `ICON_WEIGHTS`, `SHIPPED_ICON_WEIGHTS`, `faviconUrlForHostname`, `setUiTelemetry`, `setUiHostEnv`, `setUiRoutes`, `uiRoutes`, `defaultUiRoutes`, `decodeSpaceSegment`, `UiRoutes` |
 | `@kortix/ui/theme` | `KortixTheme`, `themeToCss`, `themeToCssVars`, `ThemeScope`, `ThemeScopeProps`, `THEME_COLOR_VARS`, `ThemeColor`, `ThemeColors`, `ThemeCssVars`, `ThemeTextStep`, `ThemeShadowStep`, `ThemeDurationStep`, `ThemeEasing`, `WALLPAPERS`, `DEFAULT_WALLPAPER_ID`, `getWallpaperById`, `Wallpaper` |
 | `@kortix/ui/session` (whole thread) | `SessionThread`, `SessionThreadProps` |
 | `@kortix/ui/session` (blocks) | `UserMessage`, `ThrottledMarkdown`, `UnifiedMarkdown`, `UnifiedMarkdownProps`, `ToolPartRenderer`, `SessionChatInput`, `SessionChatInputProps`, `AgentSelector`, `ModelSelector`, `ModelSelectorProps`, `SessionPermissionPrompt`, `QuestionPrompt`, `QuestionPromptHandle`, `TurnErrorDisplay`, `SessionBusyIndicator`, `SessionStartingLoader` |
@@ -116,7 +116,7 @@ One entry per module. Its curated names are the public API (semver). Every name,
 | `@kortix/ui/terminal`, `@kortix/ui/browser` | The session shell; the sandbox browser | the runtime ids of a mounted `useSession` |
 | `@kortix/ui/markdown`, `@kortix/ui/genui` | Markdown with code, math, links; GenUI blocks | `<UnifiedMarkdown content trust="agent" />` |
 | `@kortix/ui/diff`, `@kortix/ui/changes` | One diff; a change list | `<DiffView before after />` |
-| `@kortix/ui/apps` | App frames, the frame pool, the App view model | none |
+| `@kortix/ui/apps`, `@kortix/ui/artifacts` | App frames, the frame pool, the App view model; artifact frames and session cards | none |
 | `@kortix/ui/access`, `@kortix/ui/customize` | Sharing and roles; project configuration pages | `<ConnectorsPage projectId />` |
 | `@kortix/ui/theme`, `@kortix/ui/i18n`, `@kortix/ui/icons` | Theme; `useTranslations`, `useLocale` (next-intl signatures); glyphs | none |
 

package/skills/kortix-ui/references/custom-dashboard.md

@@ -201,7 +201,7 @@ A Next.js host passes `next/link` and `{ useRouter, usePathname, useSearchParams
 
 ## 5. The project shell
 
-Your sidebar chrome around Kortix's session list. Every URL the components link to comes from one route table, `setUiRoutes` (`@kortix/ui`), called once at module load. The defaults are Kortix's own paths: `project` `/projects/<id>`, `session` `/projects/<id>/sessions/<sessionId>`, `sessions` `/projects/<id>/sessions` (`?view=archived|deleted`), `files` `/projects/<id>/files`, `drive` `/projects/<id>/drive`, `apps` `/projects/<id>/apps`, `members` `/projects/<id>/members`, `sandboxSettings` `/projects/<id>/config?section=sandbox`, `customize` `/projects/<id>/customize/<page>` (agents, skills, connectors, triggers, reminders, models, secrets, review, settings). Return your own path for a page you serve elsewhere. Return `null` for a page you do not serve: every link to it is hidden. `project` and `session` cannot be null. This app serves the project
+Your sidebar chrome around Kortix's session list. Every URL the components link to comes from one route table, `setUiRoutes` (`@kortix/ui`), called once at module load. The defaults are Kortix's own paths: `project` `/projects/<id>`, `session` `/projects/<id>/sessions/<sessionId>`, `sessions` `/projects/<id>/sessions` (`?view=archived|deleted`), `files` `/projects/<id>/files`, `drive` `/projects/<id>/drive`, `apps` `/projects/<id>/apps`, `members` `/projects/<id>/members`, `sandboxSettings` `/projects/<id>/config?section=sandbox`, `customize` `/projects/<id>/customize/<page>` (agents, skills, connectors, triggers, reminders, models, secrets, review, settings), `channel` `/projects/<id>/c/<slug>` and `dm` `/projects/<id>/dm/<agent>` (the sidebar links them while the project's `project_channels` flag is on). Return your own path for a page you serve elsewhere. Return `null` for a page you do not serve: every link to it is hidden. `project`, `session`, `channel` and `dm` cannot be null. This app serves the project
 home, its files and a session (section 7), so it maps the other pages to `null`.
 
 ```tsx
@@ -456,9 +456,9 @@ The modules compose at any depth (`modules.md` has every entry with its props an
   composed screens need the two scopes those screens mount: `KortixProjectProvider` (`@kortix/sdk/react`)
   and `SessionIdsProvider` (`@kortix/ui`) with the project and session ids.
 - To draw every part yourself: `useChatTurns` and `renderParts` from `@kortix/sdk/react`
-  (https://kortix.com/docs/sdk/react#build-a-chat-ui).
+  (https://kortix.com/docs/developers#react).
 - Other data for a dashboard: `useProjectApps`, `useProjectTriggers`, `useChangeRequests`,
-  `useGatewayOverview`, `useCan` (https://kortix.com/docs/sdk/react#hooks).
+  `useGatewayOverview`, `useCan` (https://kortix.com/docs/developers#react-hooks).
 
 ## 10. Verify
 

package/skills/kortix-ui/references/modules.md

@@ -87,7 +87,9 @@ export function Answer({ text }: { text: string }) {
 }
 ```
 
-Names: `markdownPolicy`, `MarkdownPolicy`, `MarkdownTrust`, `MarkdownVariant`, `UnifiedMarkdown`, `UnifiedMarkdownProps`, `CopyOverlay`, `HighlightedCode`, `CopyButton`, `MarkdownWithFrontmatter`, `languageLabel`, `normalizeLanguage`
+Code outside markdown: `CodeHighlight` (`code`, `language`) draws one highlighted block without the markdown parser; `INLINE_CODE` is the class string of an inline code chip.
+
+Names: `markdownPolicy`, `MarkdownPolicy`, `MarkdownTrust`, `MarkdownVariant`, `UnifiedMarkdown`, `UnifiedMarkdownProps`, `CopyOverlay`, `CodeHighlight`, `HighlightedCode`, `INLINE_CODE`, `CopyButton`, `MarkdownWithFrontmatter`, `languageLabel`, `normalizeLanguage`
 
 ## `@kortix/ui/genui`
 
@@ -177,7 +179,7 @@ export function PreviewHost() {
 }
 ```
 
-Names: `saveDriveFile`, `useDismissDriveConflict`, `useDriveAvailability`, `useDriveConflicts`, `useDriveFolder`, `useFolderAccess`, `useFolderPrincipals`, `useInvalidateDrives`, `useProjectDrive`, `useShareFolder`, `useUnshareFolder`, `FilesStoreProvider`, `getFileIcon`, `FilePreviewHost`, `ChangeRequestDetailDialog`, `DiffRenderer`, `DriveExplorer`, `DriveUploadTray`, `FileExplorerPage`, `FileThumbnail`, `ProjectFilesProvider`, `useProjectContext`, `FileExplorerSourceProvider`, `ExplorerQueryResult`, `FileExplorerSource`, `gitRefExplorerSource`, `useChangeRequestRecovery`, `changeRequestKeys`, `openChangeRequestListQuery`, `useChangeRequestDiff`, `useChangeRequestMergePreview`, `useCloseChangeRequest`, `useMergeChangeRequest`, `useRequestChangesOnChangeRequest`, `useSelectedVersion`, `workspaceFileSource`, `useWorkspaceSearch`, `SandboxFileExplorer`
+Names: `saveDriveFile`, `useDismissDriveConflict`, `useDriveAvailability`, `useDriveConflicts`, `useDriveFolder`, `useFolderAccess`, `useFolderPrincipals`, `useInvalidateDrives`, `useProjectDrive`, `useShareFolder`, `useUnshareFolder`, `FilesStoreProvider`, `getFileIcon`, `FilePreviewHost`, `ChangeRequestDetailDialog`, `DiffRenderer`, `DriveExplorer`, `DriveUploadTray`, `FileExplorerPage`, `FileThumbnail`, `ProjectFilesProvider`, `useProjectContext`, `FileExplorerSourceProvider`, `ExplorerQueryResult`, `FileExplorerSource`, `gitRefExplorerSource`, `useChangeRequestRecovery`, `changeRequestKeys`, `openChangeRequestListQuery`, `useChangeRequestDiff`, `useChangeRequestMergePreview`, `useCloseChangeRequest`, `useMergeChangeRequest`, `useRequestChangesOnChangeRequest`, `useSelectedVersion`, `workspaceFileSource`, `useWorkspaceSearch`, `SandboxFileExplorer`, `CodeEditor` (the CodeMirror editor, loaded as its own chunk on first render)
 
 ## `@kortix/ui/file-viewer`
 
@@ -256,6 +258,26 @@ export function AppLink({ url }: { url: string }) {
 
 Names: `AppPreview`, `AppPreviewOverlay`, `PREVIEW_SPINNER_DELAY_MS`, `PREVIEW_TILE_ASPECT`, `PREVIEW_VIEWPORT_HEIGHT`, `PREVIEW_VIEWPORT_WIDTH`, `framePlacement`, `previewScale`, `scheduleSlowPreview`, `ensureFrame`, `frameKey`, `framesKeepAlive`, `pruneFrames`, `reloadFrame`, `ANONYMOUS_MODES`, `DEPLOYMENT_COPY`, `appCan`, `appCommand`, `appHost`, `appStatus`, `appTabLabel`, `cardPreviewApp`, `childApps`, `deployNotice`, `gridApps`, `localizedAppCopy`, `isKortixAppUrl`
 
+The frame pool: `ensureFrame` creates a parked frame, `claimFrame` (`key`, `slot`, `placement`) shows it in `slot` and returns the release, `restyleFrame` restyles the current claim, `useFrameStatus` (`key`) reads `loading`, `loaded` or `failed`; `FramePlacement` is a slot's class, style and `interactive`. The Apps page: `hiddenApps` (neither a card nor a tab), `appTriggers` (the triggers that call an App and the ones its events start), `backgroundSummary` (running, asleep, undeployed, external counts), `appSizeLabel` ("2 vCPU · 4 GB · 20 GB"), `DeployCommand` (`code`: a shell command with a copy button).
+
+## `@kortix/ui/artifacts`
+
+Source: `src/artifacts/index.ts`. Kortix Artifacts in any host: the frame policy and link parsing (server-safe), the pooled page frame, and the session views. Artifact frames share the `@kortix/ui/apps` frame pool; their keys start with `ARTIFACT_FRAME_PREFIX`.
+
+Props: `ArtifactFrame`: `frameKey` (`artifactFrameKey(artifact, version)`), `src`, `title`, `preview` (no input), `className`. `ShowArtifactCard`: `url`, `fallback` (drawn when the viewer cannot open it). `ArtifactPanelPreview`: `url`, `onClose`.
+
+```tsx
+import { parseArtifactUrl } from '@kortix/ui/artifacts';
+
+// A link to an artifact opens it in your viewer; any other link stays a link.
+export function ArtifactLink({ url }: { url: string }) {
+  const artifact = parseArtifactUrl(url);
+  return <a href={url}>{artifact ? `Artifact ${artifact.artifactId}` : url}</a>;
+}
+```
+
+Names: `ARTIFACT_FRAME_ALLOW`, `ARTIFACT_FRAME_PREFIX`, `ARTIFACT_IFRAME_SANDBOX`, `artifactFrameKey`, `parseArtifactUrl`, `printArtifact` (a doc's print view in a hidden frame: Export as PDF), `ArtifactFrame`, `ensureArtifactFrame`, `ArtifactPanelPreview`, `ShowArtifactCard`
+
 ## `@kortix/ui/composer`
 
 Source: `src/session/composer/index.ts`. The message composer: drop-in inputs, chrome, tiptap editor parts and the send pipeline.
@@ -344,7 +366,7 @@ Mount: `SessionWorkspace` takes `session` (the `useSession` result): the thread
 Props:
 - `SessionWorkspace`: `session` (the `useSession` result, required), `children` (replaces the thread), `hideHeader`, `readOnly`, `className`.
 - `SessionLayout`: `sessionId` (runtime id), `projectId`, `projectSessionId`, `children` (the thread), `bootStage`, `transient`.
-- `ProjectHome`: `projectId`; `beforeSend` (runs first, throw to refuse); `onSend` + `busy` (replace the send).
+- `ProjectHome`: `projectId`; `beforeSend` (runs first, throw to refuse); `onSend` + `busy` (replace the send); `onboarding` (opt in: a project not yet onboarded opens on the onboarding chat and sends "Onboard me" once a model is usable).
 - `useProjectHomeSend(projectId, { beforeSend })` returns `{ send, sending }`.
 - `ProjectSessionList`, `ProjectSessionsView`, `ProjectFilesView`: `projectId`. `ProjectSidebar`: `projectId`, `menu`, `onOpenSearch` (the header shows Search only with it); its Files, Apps and Customize rows read `projectId`, not the route.
 
@@ -375,7 +397,9 @@ export function Sessions({ projectId }: { projectId: string }) {
 
 Goals (behind the `goals` flag): `GoalStatusBadge` (a goal's status), `GoalHealthDot` (green running, orange needs attention, grey closed), `useGoalIssueText` (one sentence per health issue), `goalProgress` (met and total criteria), `goalOpenAsks` (asks waiting on a person), `goalNeedsYou` (an open ask or a health issue), `formatGoalTime` (the reminders time format), `goalHref` (the goal's page, or null), `useGoalClock` (the current time, re-read every 30 s).
 
-Names: `ProjectPageHeader`, `useCapabilityAccess`, `useProjectNavRows`, `SidebarToggle`, `activeCapabilityTab`, `agentHref`, `capabilityTabHref`, `channelsHref`, `remindersHref`, `reviewHref`, `detectManifestVersion`, `manifestFilename`, `manifestNeedsUpgrade`, `useProjectManifestVersion`, `ManifestVersion`, `CUSTOMIZE_SECTION_ACCESS`, `CUSTOMIZE_SECTION_GATE_ACTIONS`, `PROJECT_ACTIONS`, `isCustomizeSectionVisible`, `CustomizeSection`, `ProjectAction`, `usePermission`, `usePermissions`, `usePermissionsFor`, `PROJECT_PAGE_ACTIONS`, `useProjectCan`, `useProjectCans`, `useProjectPageCans`, `CanResult`, `formatFireTime`, `nearestFire`, `reminderTitle`, `scheduleLabel`, `ProjectHomeWallpaper`, `ProjectHomeWelcomeBody`, `InstantSessionShell`, `ProjectFilesView`, `ProjectHome`, `ProjectHomeSendOptions`, `useProjectHomeSend`, `UseProjectHomeSendOptions`, `SavedSessionSkeleton`, `SessionLayout`, `SessionWorkspace`, `SessionLayoutProps`, `SessionWorkspaceProps`, `ProjectSessionsView`, `ProjectSessionList`, `ProjectSidebar`, `ShareSessionModal`
+Channels and memory (behind the `project_channels` flag): `SpaceView` (`projectId`, `target`: a `SpaceTarget`, `{ kind: 'channel', slug }` or `{ kind: 'dm', agentName }`; `beforeSend`; `renderFolder` draws a `SpaceFolder`, one space's Files tab; `renderApps`) is a channel or DM page with its threads, files, memory, apps, links and triggers. `ChannelGlyph` (`visibility`) is `#` or a lock. `agentLabel` (`name`) is an agent's display name. `MemoryView` (`projectId`, `layerKey`: `company` or a space id, `place`) is one memory layer's pages; `CompanyMemoryPage` (`projectId`) is the project's Company memory. `useMemoryPageHref` (`projectId`) returns `(layer: MemoryLayerRef, pageId) => href | null`: the page's link, null when the host serves no such page.
+
+Names: `SpaceView`, `SpaceViewProps`, `SpaceTarget`, `SpaceFolder`, `ChannelGlyph`, `agentLabel`, `MemoryView`, `MemoryViewProps`, `CompanyMemoryPage`, `MemoryLayerRef`, `useMemoryPageHref`, `ProjectPageHeader`, `useCapabilityAccess`, `useProjectNavRows`, `SidebarToggle`, `activeCapabilityTab`, `agentHref`, `capabilityTabHref`, `channelsHref`, `remindersHref`, `reviewHref`, `detectManifestVersion`, `manifestFilename`, `manifestNeedsUpgrade`, `useProjectManifestVersion`, `ManifestVersion`, `CUSTOMIZE_SECTION_ACCESS`, `CUSTOMIZE_SECTION_GATE_ACTIONS`, `PROJECT_ACTIONS`, `isCustomizeSectionVisible`, `CustomizeSection`, `ProjectAction`, `usePermission`, `usePermissions`, `usePermissionsFor`, `PROJECT_PAGE_ACTIONS`, `useProjectCan`, `useProjectCans`, `useProjectPageCans`, `CanResult`, `formatFireTime`, `nearestFire`, `reminderTitle`, `scheduleLabel`, `ProjectHomeWallpaper`, `ProjectHomeWelcomeBody`, `InstantSessionShell`, `ProjectFilesView`, `ProjectHome`, `ProjectHomeSendOptions`, `useProjectHomeSend`, `UseProjectHomeSendOptions`, `SavedSessionSkeleton`, `SessionLayout`, `SessionWorkspace`, `SessionLayoutProps`, `SessionWorkspaceProps`, `ProjectSessionsView`, `ProjectSessionList`, `ProjectSidebar`, `ShareSessionModal`
 
 ## `@kortix/ui/access`
 

package/skills/kortix-ui/references/theming.md

@@ -95,7 +95,7 @@ Shared values (both modes):
 | `durations.<step>`, `easing.<curve>` | `--duration-*`, `--ease-*` | Motion: `fast` … `slower`; `default`, `in`, `out`, `inOut` |
 | `vars` | any `--name` | Anything else |
 
-Defaults and the fixed values (scrims, 10–12px captions, a few keyframe durations): https://kortix.com/docs/sdk/ui#tokens.
+Defaults and the fixed values (scrims, 10–12px captions, a few keyframe durations): https://kortix.com/docs/developers#tokens.
 
 ## 5. Rules
 

package/dist/customize/agents/agent-nav.prototype.d.ts

@@ -1,35 +0,0 @@
-import { type ReactNode } from 'react';
-export declare const PROTOTYPE_ENABLED: boolean;
-export declare const NAV_VARIANTS: readonly [{
-    readonly key: "rail";
-}, {
-    readonly key: "tabs";
-}, {
-    readonly key: "groups";
-}, {
-    readonly key: "inline";
-}];
-export type NavVariant = (typeof NAV_VARIANTS)[number]['key'];
-export declare function useNavVariant(): NavVariant;
-export interface NavItem {
-    key: string;
-    label: string;
-    group: string;
-}
-interface NavProps {
-    groups: {
-        group: string;
-        items: NavItem[];
-    }[];
-    section: string;
-    href: (key: string) => string;
-    /** The current value per topic — "All", "2 picked", the model name. */
-    summaries?: Partial<Record<string, string>>;
-}
-export declare function GroupedUnderlineTabs({ groups, section, href }: NavProps): import("react").JSX.Element;
-export declare function GroupSwitchTabs({ groups, section, href }: NavProps): import("react").JSX.Element;
-export declare function InlineVerticalTabs({ groups, section, href, summaries, children, }: NavProps & {
-    children: ReactNode;
-}): import("react").JSX.Element;
-export declare function PrototypeSwitcher(): import("react").JSX.Element | null;
-export {};

package/dist/customize/agents/agent-nav.prototype.js

@@ -1,95 +0,0 @@
-'use client';
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-/**
- * PROTOTYPE — throwaway. Answers one question: what replaces the agent page's
- * left rail? Rendered on the real agent page, switched with `?variant=`:
- *
- *   rail     — today's left rail (the baseline; no param)
- *   tabs     — grouped underline tabs under the header, no rail
- *   groups   — General / Access / Runtime switch + that group's tabs
- *   inline   — vertical tabs beside the content column, each with its value
- *
- * Read-only navigation over the same `?section=` links; nothing here mutates.
- * Once a variant wins, fold it into `agent-page.tsx` properly and delete this
- * file and the switcher. Dev builds only (`PROTOTYPE_ENABLED`).
- */
-import { CaretLeftIcon, CaretRightIcon } from '@phosphor-icons/react';
-import { useCallback, useEffect } from 'react';
-import { useTranslations } from '../../i18n/index.js';
-import { cn } from '../../internal/lib/utils.js';
-import { Tabs, TabsList, TabsTrigger } from '../../primitives/tabs.js';
-import { UiLink as Link, useUiPathname as usePathname, useUiRouter as useRouter, useUiSearchParams as useSearchParams, } from '../../providers/ui-provider.js';
-export const PROTOTYPE_ENABLED = process.env.NODE_ENV !== 'production';
-export const NAV_VARIANTS = [{ key: 'rail' }, { key: 'tabs' }, { key: 'groups' }, { key: 'inline' }];
-export function useNavVariant() {
-    const raw = useSearchParams().get('variant');
-    if (!PROTOTYPE_ENABLED)
-        return 'rail';
-    return NAV_VARIANTS.some((v) => v.key === raw) ? raw : 'rail';
-}
-/** `?section=` link that keeps `?variant=` so switching topics stays in the variant. */
-function useVariantHref(href) {
-    const variant = useSearchParams().get('variant');
-    return (key) => (variant ? `${href(key)}&variant=${variant}` : href(key));
-}
-// ─── tabs: grouped underline tabs ──────────────────────────────────────────
-export function GroupedUnderlineTabs({ groups, section, href }) {
-    const to = useVariantHref(href);
-    return (_jsx("nav", { className: "border-border/60 flex shrink-0 items-end gap-8 overflow-x-auto border-b px-5 pt-1", children: groups.map((g) => (_jsxs("div", { className: "flex shrink-0 flex-col gap-1", children: [_jsx("span", { className: "text-muted-foreground px-2 text-xs", children: g.group }), _jsx(Tabs, { value: section, children: _jsx(TabsList, { type: "underline", className: "h-auto gap-1 border-b-0", children: g.items.map((item) => (_jsx(TabsTrigger, { value: item.key, asChild: true, className: "w-fit flex-none px-2", children: _jsx(Link, { href: to(item.key), prefetch: true, children: item.label }) }, item.key))) }) })] }, g.group))) }));
-}
-// ─── groups: group switch + sub tabs ───────────────────────────────────────
-export function GroupSwitchTabs({ groups, section, href }) {
-    const to = useVariantHref(href);
-    const active = groups.find((g) => g.items.some((i) => i.key === section)) ?? groups[0];
-    return (_jsxs("nav", { className: "border-border/60 flex shrink-0 items-center gap-5 overflow-x-auto border-b px-5 py-2", children: [_jsx(Tabs, { value: active?.group, children: _jsx(TabsList, { children: groups.map((g) => (_jsx(TabsTrigger, { value: g.group, asChild: true, className: "w-fit flex-none", children: _jsx(Link, { href: to(g.items[0].key), prefetch: true, children: g.group }) }, g.group))) }) }), _jsx(Tabs, { value: section, children: _jsx(TabsList, { type: "underline", className: "h-auto gap-1 border-b-0", children: active?.items.map((item) => (_jsx(TabsTrigger, { value: item.key, asChild: true, className: "w-fit flex-none px-2", children: _jsx(Link, { href: to(item.key), prefetch: true, children: item.label }) }, item.key))) }) })] }));
-}
-// ─── inline: vertical tabs beside the content, with values ────────────────
-export function InlineVerticalTabs({ groups, section, href, summaries, children, }) {
-    const to = useVariantHref(href);
-    return (_jsxs("div", { className: "mx-auto flex w-full max-w-5xl items-start gap-14 px-4 py-10 pb-32 lg:py-14", children: [_jsx("nav", { className: "sticky top-0 flex w-52 shrink-0 flex-col gap-4", children: groups.map((g) => (_jsxs("div", { className: "flex flex-col gap-0.5", children: [_jsx("span", { className: "text-muted-foreground px-2.5 pb-1 text-xs", children: g.group }), g.items.map((item) => {
-                            const isActive = item.key === section;
-                            return (_jsxs(Link, { href: to(item.key), prefetch: true, "aria-current": isActive ? 'page' : undefined, className: cn('flex items-center justify-between gap-3 rounded-md px-2.5 py-1.5 text-sm transition-none', isActive
-                                    ? 'bg-active text-foreground font-medium'
-                                    : 'text-muted-foreground hover:bg-hover hover:text-foreground'), children: [_jsx("span", { className: "truncate", children: item.label }), summaries?.[item.key] ? (_jsx("span", { className: "text-muted-foreground shrink-0 text-xs font-normal tabular-nums", children: summaries[item.key] })) : null] }, item.key));
-                        })] }, g.group))) }), _jsx("div", { className: "min-w-0 max-w-2xl flex-1", children: children })] }));
-}
-// ─── the floating switcher ────────────────────────────────────────────────
-export function PrototypeSwitcher() {
-    const router = useRouter();
-    const pathname = usePathname();
-    const search = useSearchParams();
-    const current = useNavVariant();
-    const t = useTranslations('agentNavPrototype');
-    const labels = {
-        rail: t('variantRail'),
-        tabs: t('variantTabs'),
-        groups: t('variantGroups'),
-        inline: t('variantInline'),
-    };
-    const index = NAV_VARIANTS.findIndex((v) => v.key === current);
-    const go = useCallback((step) => {
-        const next = NAV_VARIANTS[(index + step + NAV_VARIANTS.length) % NAV_VARIANTS.length];
-        const params = new URLSearchParams(search.toString());
-        if (next.key === 'rail')
-            params.delete('variant');
-        else
-            params.set('variant', next.key);
-        router.replace(`${pathname}?${params.toString()}`, { scroll: false });
-    }, [index, pathname, router, search]);
-    useEffect(() => {
-        const onKey = (event) => {
-            const target = event.target;
-            if (target?.closest('input, textarea, select, [contenteditable="true"]'))
-                return;
-            if (event.key === 'ArrowLeft')
-                go(-1);
-            if (event.key === 'ArrowRight')
-                go(1);
-        };
-        window.addEventListener('keydown', onKey);
-        return () => window.removeEventListener('keydown', onKey);
-    }, [go]);
-    if (!PROTOTYPE_ENABLED)
-        return null;
-    return (_jsx("div", { className: "pointer-events-none fixed inset-x-0 bottom-20 z-50 flex justify-center", children: _jsxs("div", { className: "bg-foreground text-background pointer-events-auto flex items-center gap-1 rounded-full p-1 shadow-lg", children: [_jsx("button", { type: "button", "aria-label": t('previousVariant'), onClick: () => go(-1), className: "flex size-7 items-center justify-center rounded-full hover:bg-background/15", children: _jsx(CaretLeftIcon, { className: "size-3.5" }) }), _jsxs("span", { className: "min-w-56 px-2 text-center text-xs tabular-nums", children: [String.fromCharCode(65 + index), " \u00B7 ", labels[NAV_VARIANTS[index].key]] }), _jsx("button", { type: "button", "aria-label": t('nextVariant'), onClick: () => go(1), className: "flex size-7 items-center justify-center rounded-full hover:bg-background/15", children: _jsx(CaretRightIcon, { className: "size-3.5" }) })] }) }));
-}

package/dist/customize/connectors/catalog/merge-search.d.ts

@@ -1,10 +0,0 @@
-import { type CatalogEntry } from './catalog-entry.js';
-/**
- * One search result list from both catalogues.
- *
- * Managed results keep their order. An app both list shows once, as its
- * API/MCP entry (MCP is the default way to connect) with the managed logo,
- * which is sharp where the catalogue's favicon is not. API/MCP-only apps
- * follow.
- */
-export declare function mergeSearchEntries(managed: readonly CatalogEntry[], direct: readonly CatalogEntry[]): CatalogEntry[];

package/dist/customize/connectors/catalog/merge-search.js

@@ -1,26 +0,0 @@
-import { appNameKey as appKey } from './catalog-entry.js';
-/**
- * One search result list from both catalogues.
- *
- * Managed results keep their order. An app both list shows once, as its
- * API/MCP entry (MCP is the default way to connect) with the managed logo,
- * which is sharp where the catalogue's favicon is not. API/MCP-only apps
- * follow.
- */
-export function mergeSearchEntries(managed, direct) {
-    const directByName = new Map();
-    for (const entry of direct) {
-        const key = appKey(entry.name);
-        if (!directByName.has(key))
-            directByName.set(key, entry);
-    }
-    const used = new Set();
-    const merged = managed.map((entry) => {
-        const twin = directByName.get(appKey(entry.name));
-        if (!twin || used.has(twin))
-            return entry;
-        used.add(twin);
-        return { ...twin, icon: entry.icon ?? twin.icon, alsoApp: true };
-    });
-    return merged.concat(direct.filter((entry) => !used.has(entry)));
-}

package/dist/customize/connectors/detail/find-easy-connect-app.d.ts

@@ -1,29 +0,0 @@
-/** One page of the managed catalogue, as `listConnectCatalogPage` returns it. */
-type ListApps<A> = (input: {
-    projectId: string;
-    provider: 'composio' | 'pipedream';
-    q: string;
-    limit: number;
-}) => Promise<{
-    apps: A[];
-}>;
-/**
- * Resolve one managed (Composio or Pipedream) app from its slug.
- *
- * The catalogue has no by-slug route, so this searches and keeps the exact
- * slug match. The second query spells the slug as words, for a catalogue whose
- * search matches names and not slugs (`google_sheets` → "google sheets").
- *
- * `list` is passed in so this module stays free of the catalogue hook's
- * imports and can be tested with a fake.
- */
-export declare function findEasyConnectApp<A extends {
-    slug: string;
-}>(list: ListApps<A>, input: {
-    projectId: string;
-    provider: 'composio' | 'pipedream';
-    slug: string;
-}): Promise<(A & {
-    provider: 'composio' | 'pipedream';
-}) | null>;
-export {};

package/dist/customize/connectors/detail/find-easy-connect-app.js

@@ -1,22 +0,0 @@
-/**
- * Resolve one managed (Composio or Pipedream) app from its slug.
- *
- * The catalogue has no by-slug route, so this searches and keeps the exact
- * slug match. The second query spells the slug as words, for a catalogue whose
- * search matches names and not slugs (`google_sheets` → "google sheets").
- *
- * `list` is passed in so this module stays free of the catalogue hook's
- * imports and can be tested with a fake.
- */
-export async function findEasyConnectApp(list, input) {
-    const words = input.slug.replace(/[_-]+/g, ' ');
-    for (const q of words === input.slug ? [input.slug] : [input.slug, words]) {
-        // ponytail: one page of 48 per query; an exact slug ranked below 48 results
-        // reads as not found. Add a by-slug API route if that happens.
-        const page = await list({ projectId: input.projectId, provider: input.provider, q, limit: 48 });
-        const app = page.apps.find((candidate) => candidate.slug === input.slug);
-        if (app)
-            return { ...app, provider: input.provider };
-    }
-    return null;
-}

package/dist/customize/migrate-to-v2/use-migrate-to-v2.d.ts

@@ -1,9 +0,0 @@
-export interface MigrateToV2 {
-    /** Mint + navigate to the migration session. Safe to call repeatedly —
-     *  ignored while a session is already being created. */
-    start: () => void;
-    /** True while a session is being created — callers should disable their
-     *  trigger and/or show a spinner. */
-    pending: boolean;
-}
-export declare function useMigrateToV2(projectId: string): MigrateToV2;

package/dist/customize/migrate-to-v2/use-migrate-to-v2.js

@@ -1,24 +0,0 @@
-'use client';
-/**
- * useMigrateToV2 — start an agent-led "migrate this project's manifest to v2"
- * session from anywhere in Customize.
- *
- * Same shape as `useConfigureThread` (the sibling "Create new agent/skill/
- * command" flow): the only way config changes land is through a session that
- * edits the repo on a branch and opens a change request, so this mints a
- * fresh session, stashes the migration prompt as its first message, closes
- * the Customize overlay, and drops the user into the thread — the instant
- * shell auto-sends the stashed prompt once the runtime is ready.
- *
- * Deliberately does NOT pass `agent_name` — the session boots the project's
- * default agent (the one with git/CR powers), matching how the migration
- * prompt expects to be run.
- */
-import { useCallback } from 'react';
-import { MIGRATE_TO_V2_PROMPT } from './migration-prompt.js';
-import { useRunUpgrade } from './use-run-upgrade.js';
-export function useMigrateToV2(projectId) {
-    const run = useRunUpgrade(projectId);
-    const start = useCallback(() => run.start(MIGRATE_TO_V2_PROMPT), [run]);
-    return { start, pending: run.pending };
-}

package/dist/customize/sections/connector-connection-header.d.ts

@@ -1,36 +0,0 @@
-import type { ReactNode } from 'react';
-/**
- * The icon tile for a connector that does not exist yet. `ConnectorAppIcon`
- * (`connectors-view.tsx:729`) needs an `AdminConnector`; the add flow has a
- * catalogue app — an image URL and a name, nothing more. Same 40px bordered
- * tile, same `object-contain` treatment, so the two are indistinguishable on
- * screen.
- */
-export declare function ConnectorConnectionIcon({ src, name }: {
-    src?: string | null;
-    name: string;
-}): import("react").JSX.Element;
-/**
- * A connector's identity block — icon, name, byline, description —
- * shared by the add flow (`ConnectorConnectionModal`) and the detail modal
- * (`connector-modal.tsx`), so "what is this thing?" is answered by the same
- * layout in both places.
- *
- * Everything except `icon` and `name` is optional; a custom connector with
- * no catalogue record simply renders less. `nameSlot` swaps the plain name
- * for a caller-owned control (the detail modal's inline rename, or Radix's
- * `ModalTitle`) without changing the rhythm around it.
- */
-export declare function ConnectorConnectionHeader({ icon, name, nameSlot, byline, meta, status, description, className, }: {
-    icon: ReactNode;
-    name: string;
-    nameSlot?: ReactNode;
-    /** e.g. "by Pipedream" — the catalogue the app came from. */
-    byline?: string | null;
-    /** Small muted facts after the byline: tool count, slug. */
-    meta?: ReactNode;
-    /** Badges trailing the name: provider, connection status. */
-    status?: ReactNode;
-    description?: string | null;
-    className?: string;
-}): import("react").JSX.Element;