@kortix/ui 0.14.8 → 0.14.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kortix/ui",
-  "version": "0.14.8",
+  "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"
@@ -955,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"
@@ -1027,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"
@@ -1467,10 +1467,6 @@
       "types": "./dist/markdown/setup-links/api-base.d.ts",
       "import": "./dist/markdown/setup-links/api-base.js"
     },
-    "./markdown/setup-links/app-credentials-form": {
-      "types": "./dist/markdown/setup-links/app-credentials-form.d.ts",
-      "import": "./dist/markdown/setup-links/app-credentials-form.js"
-    },
     "./markdown/setup-links/approval-decision": {
       "types": "./dist/markdown/setup-links/approval-decision.d.ts",
       "import": "./dist/markdown/setup-links/approval-decision.js"
@@ -1561,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"
@@ -1577,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"
@@ -2025,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"
@@ -2165,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.8",
+    "@kortix/llm-catalog": "0.14.9",
     "@lezer/highlight": "1.2.3",
     "@paper-design/shaders-react": "^0.0.76",
     "@phosphor-icons/react": "2.1.10",
@@ -2197,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",
@@ -2219,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",
@@ -2254,7 +2245,7 @@
     "zustand": "^5.0.3"
   },
   "peerDependencies": {
-    "@kortix/sdk": "^0.14.8",
+    "@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/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;

package/dist/customize/sections/connector-connection-header.js

@@ -1,33 +0,0 @@
-'use client';
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { PlugIcon } from '@phosphor-icons/react';
-import { UiImage as Image } from '../../providers/ui-provider.js';
-import { EntityAvatar } from '../../primitives/entity-avatar.js';
-import { cn } from '../../internal/lib/utils.js';
-/**
- * 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 function ConnectorConnectionIcon({ src, name }) {
-    if (src) {
-        return (_jsx("span", { className: "border-border/60 bg-card relative flex size-10 shrink-0 items-center justify-center overflow-hidden rounded-sm border", children: _jsx(Image, { src: src, alt: "", referrerPolicy: "no-referrer", fill: true, sizes: "40px", className: "object-contain", unoptimized: true }) }));
-    }
-    return _jsx(EntityAvatar, { icon: PlugIcon, size: "lg", label: name });
-}
-/**
- * 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 function ConnectorConnectionHeader({ icon, name, nameSlot, byline, meta, status, description, className, }) {
-    return (_jsxs("div", { className: cn('flex items-start gap-3.5', className), children: [icon, _jsxs("div", { className: "min-w-0 flex-1 space-y-0", children: [_jsxs("div", { className: "flex flex-wrap items-center gap-x-2 gap-y-1", children: [nameSlot ?? (_jsx("span", { className: "text-foreground truncate text-lg font-semibold", children: name })), status] }), byline || meta ? (_jsxs("div", { className: "text-muted-foreground flex flex-wrap items-center gap-x-2 gap-y-1 text-xs", children: [byline ? _jsx("span", { children: byline }) : null, meta] })) : null, description ? (_jsx("p", { className: "text-muted-foreground text-sm text-pretty", children: description })) : null] })] }));
-}

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

@@ -1,34 +0,0 @@
-import { type EasyConnectConnectionInput } from './connector-connection-form.js';
-/**
- * The "Add connector" dialog: connection header + one primary button.
- *
- * Defaults (app name, proposed slug) are always valid, so a non-technical user
- * reads the header and presses "+ Add connector" without meeting "slug". That
- * field stays behind a collapsed disclosure for the rare rename case. The
- * disclosure force-opens when the slug inside it becomes invalid, so a submit
- * that would silently refuse never hides its reason.
- *
- * There is no owner choice here any more. A connector is a capability with no
- * identity; WHO it runs as is a property of each account on its Accounts tab,
- * where both a shared and a private account can exist at the same time.
- */
-export declare function ConnectorConnectionModal({ open, idPrefix, title, initialName, initialSlug, existingSlugs, pending, icon, byline, summary, submitLabel, onOpenChange, onSubmit, }: {
-    open: boolean;
-    idPrefix: string;
-    title: string;
-    description: string;
-    initialName: string;
-    initialSlug: string;
-    existingSlugs: readonly string[];
-    pending: boolean;
-    /** The app tile — `ConnectorConnectionIcon` over the catalogue record. */
-    icon?: React.ReactNode;
-    /** e.g. "by Pipedream". */
-    byline?: string | null;
-    /** The catalogue description, when the source publishes one. */
-    summary?: string | null;
-    /** Defaults to `+ Add connector`. */
-    submitLabel?: string;
-    onOpenChange: (open: boolean) => void;
-    onSubmit: (connection: EasyConnectConnectionInput) => void;
-}): import("react").JSX.Element;