@kortix/ui 0.14.12 → 0.14.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kortix/ui",
-  "version": "0.14.12",
+  "version": "0.14.14",
   "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",
@@ -181,6 +181,10 @@
       "types": "./dist/customize/index.d.ts",
       "import": "./dist/customize/index.js"
     },
+    "./customize/agents/agent-apps-grant": {
+      "types": "./dist/customize/agents/agent-apps-grant.d.ts",
+      "import": "./dist/customize/agents/agent-apps-grant.js"
+    },
     "./customize/agents/agent-detail-aside": {
       "types": "./dist/customize/agents/agent-detail-aside.d.ts",
       "import": "./dist/customize/agents/agent-detail-aside.js"
@@ -201,10 +205,6 @@
       "types": "./dist/customize/connectors/connectors-app-return-bar.d.ts",
       "import": "./dist/customize/connectors/connectors-app-return-bar.js"
     },
-    "./customize/connectors/connectors-page": {
-      "types": "./dist/customize/connectors/connectors-page.d.ts",
-      "import": "./dist/customize/connectors/connectors-page.js"
-    },
     "./customize/connectors/detail/app-page": {
       "types": "./dist/customize/connectors/detail/app-page.d.ts",
       "import": "./dist/customize/connectors/detail/app-page.js"
@@ -213,22 +213,6 @@
       "types": "./dist/customize/connectors/detail/connector-page.d.ts",
       "import": "./dist/customize/connectors/detail/connector-page.js"
     },
-    "./customize/migrate-to-v2/upgrade-view": {
-      "types": "./dist/customize/migrate-to-v2/upgrade-view.d.ts",
-      "import": "./dist/customize/migrate-to-v2/upgrade-view.js"
-    },
-    "./customize/models/models-page": {
-      "types": "./dist/customize/models/models-page.d.ts",
-      "import": "./dist/customize/models/models-page.js"
-    },
-    "./customize/project-settings/project-settings-page": {
-      "types": "./dist/customize/project-settings/project-settings-page.d.ts",
-      "import": "./dist/customize/project-settings/project-settings-page.js"
-    },
-    "./customize/secrets/secrets-page": {
-      "types": "./dist/customize/secrets/secrets-page.d.ts",
-      "import": "./dist/customize/secrets/secrets-page.js"
-    },
     "./customize/sections/add-account-fields": {
       "types": "./dist/customize/sections/add-account-fields.d.ts",
       "import": "./dist/customize/sections/add-account-fields.js"
@@ -381,17 +365,25 @@
       "types": "./dist/customize/settings/type.d.ts",
       "import": "./dist/customize/settings/type.js"
     },
+    "./customize/shared/agent-resource-scope": {
+      "types": "./dist/customize/shared/agent-resource-scope.d.ts",
+      "import": "./dist/customize/shared/agent-resource-scope.js"
+    },
     "./customize/shared/capability-access-gate": {
       "types": "./dist/customize/shared/capability-access-gate.d.ts",
       "import": "./dist/customize/shared/capability-access-gate.js"
     },
+    "./customize/shared/capability-page-shell": {
+      "types": "./dist/customize/shared/capability-page-shell.d.ts",
+      "import": "./dist/customize/shared/capability-page-shell.js"
+    },
     "./customize/shared/capability-skeleton": {
       "types": "./dist/customize/shared/capability-skeleton.d.ts",
       "import": "./dist/customize/shared/capability-skeleton.js"
     },
-    "./customize/shared/capability-tabs": {
-      "types": "./dist/customize/shared/capability-tabs.d.ts",
-      "import": "./dist/customize/shared/capability-tabs.js"
+    "./customize/shared/customize-tab-bar": {
+      "types": "./dist/customize/shared/customize-tab-bar.d.ts",
+      "import": "./dist/customize/shared/customize-tab-bar.js"
     },
     "./customize/shared/entity/entity-files": {
       "types": "./dist/customize/shared/entity/entity-files.d.ts",
@@ -409,10 +401,6 @@
       "types": "./dist/customize/shared/with-search.d.ts",
       "import": "./dist/customize/shared/with-search.js"
     },
-    "./customize/skills/skills-page": {
-      "types": "./dist/customize/skills/skills-page.d.ts",
-      "import": "./dist/customize/skills/skills-page.js"
-    },
     "./customize/triggers/schedule-view": {
       "types": "./dist/customize/triggers/schedule-view.d.ts",
       "import": "./dist/customize/triggers/schedule-view.js"
@@ -421,10 +409,6 @@
       "types": "./dist/customize/triggers/schedule/schedule-copy.d.ts",
       "import": "./dist/customize/triggers/schedule/schedule-copy.js"
     },
-    "./customize/triggers/triggers-page": {
-      "types": "./dist/customize/triggers/triggers-page.d.ts",
-      "import": "./dist/customize/triggers/triggers-page.js"
-    },
     "./data-grid": {
       "types": "./dist/primitives/data-grid.d.ts",
       "import": "./dist/primitives/data-grid.js"
@@ -1151,9 +1135,9 @@
       "types": "./dist/internal/lib/kortix-cli.d.ts",
       "import": "./dist/internal/lib/kortix-cli.js"
     },
-    "./internal/lib/manifest-version": {
-      "types": "./dist/internal/lib/manifest-version.d.ts",
-      "import": "./dist/internal/lib/manifest-version.js"
+    "./internal/lib/manifest-health": {
+      "types": "./dist/internal/lib/manifest-health.d.ts",
+      "import": "./dist/internal/lib/manifest-health.js"
     },
     "./internal/lib/mobile-store-urls": {
       "types": "./dist/internal/lib/mobile-store-urls.d.ts",
@@ -1295,10 +1279,6 @@
       "types": "./dist/internal/notifications/web-push.d.ts",
       "import": "./dist/internal/notifications/web-push.js"
     },
-    "./internal/reminders/use-refetch-after-fire": {
-      "types": "./dist/internal/reminders/use-refetch-after-fire.d.ts",
-      "import": "./dist/internal/reminders/use-refetch-after-fire.js"
-    },
     "./internal/session-types/index": {
       "types": "./dist/internal/session-types/index.d.ts",
       "import": "./dist/internal/session-types/index.js"
@@ -1455,10 +1435,6 @@
       "types": "./dist/primitives/label.d.ts",
       "import": "./dist/primitives/label.js"
     },
-    "./lib/favicon": {
-      "types": "./dist/lib/favicon.d.ts",
-      "import": "./dist/lib/favicon.js"
-    },
     "./lib/host-env": {
       "types": "./dist/lib/host-env.d.ts",
       "import": "./dist/lib/host-env.js"
@@ -1499,6 +1475,22 @@
       "types": "./dist/markdown/copy-button.d.ts",
       "import": "./dist/markdown/copy-button.js"
     },
+    "./markdown/doc-editor/doc-embed": {
+      "types": "./dist/markdown/doc-editor/doc-embed.d.ts",
+      "import": "./dist/markdown/doc-editor/doc-embed.js"
+    },
+    "./markdown/doc-editor/doc-extensions": {
+      "types": "./dist/markdown/doc-editor/doc-extensions.d.ts",
+      "import": "./dist/markdown/doc-editor/doc-extensions.js"
+    },
+    "./markdown/doc-editor/doc-menus": {
+      "types": "./dist/markdown/doc-editor/doc-menus.d.ts",
+      "import": "./dist/markdown/doc-editor/doc-menus.js"
+    },
+    "./markdown/doc-editor/markdown": {
+      "types": "./dist/markdown/doc-editor/markdown.d.ts",
+      "import": "./dist/markdown/doc-editor/markdown.js"
+    },
     "./markdown/setup-links/api-base": {
       "types": "./dist/markdown/setup-links/api-base.d.ts",
       "import": "./dist/markdown/setup-links/api-base.js"
@@ -1977,6 +1969,10 @@
       "types": "./dist/workspace/index.d.ts",
       "import": "./dist/workspace/index.js"
     },
+    "./workspace/admin/project-admin-dashboard": {
+      "types": "./dist/workspace/admin/project-admin-dashboard.d.ts",
+      "import": "./dist/workspace/admin/project-admin-dashboard.js"
+    },
     "./workspace/home/access-requests-bell": {
       "types": "./dist/workspace/home/access-requests-bell.d.ts",
       "import": "./dist/workspace/home/access-requests-bell.js"
@@ -2089,10 +2085,6 @@
       "types": "./dist/workspace/review/types.d.ts",
       "import": "./dist/workspace/review/types.js"
     },
-    "./workspace/sidebar/customize-sidebar-modal": {
-      "types": "./dist/workspace/sidebar/customize-sidebar-modal.d.ts",
-      "import": "./dist/workspace/sidebar/customize-sidebar-modal.js"
-    },
     "./workspace/sidebar/footer/project-apps-nav": {
       "types": "./dist/workspace/sidebar/footer/project-apps-nav.d.ts",
       "import": "./dist/workspace/sidebar/footer/project-apps-nav.js"
@@ -2105,9 +2097,9 @@
       "types": "./dist/workspace/sidebar/footer/project-computer-nav.d.ts",
       "import": "./dist/workspace/sidebar/footer/project-computer-nav.js"
     },
-    "./workspace/sidebar/footer/project-manifest-upgrade-alert": {
-      "types": "./dist/workspace/sidebar/footer/project-manifest-upgrade-alert.d.ts",
-      "import": "./dist/workspace/sidebar/footer/project-manifest-upgrade-alert.js"
+    "./workspace/sidebar/footer/project-manifest-issues-alert": {
+      "types": "./dist/workspace/sidebar/footer/project-manifest-issues-alert.d.ts",
+      "import": "./dist/workspace/sidebar/footer/project-manifest-issues-alert.js"
     },
     "./workspace/sidebar/footer/project-mcp-nav": {
       "types": "./dist/workspace/sidebar/footer/project-mcp-nav.d.ts",
@@ -2156,6 +2148,10 @@
     "./workspace/sidebar/workspace-menu-section": {
       "types": "./dist/workspace/sidebar/workspace-menu-section.d.ts",
       "import": "./dist/workspace/sidebar/workspace-menu-section.js"
+    },
+    "./workspace/space/space-page": {
+      "types": "./dist/workspace/space/space-page.d.ts",
+      "import": "./dist/workspace/space/space-page.js"
     }
   },
   "publishConfig": {
@@ -2193,7 +2189,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.12",
+    "@kortix/llm-catalog": "0.14.14",
     "@lezer/highlight": "1.2.3",
     "@paper-design/shaders-react": "^0.0.76",
     "@phosphor-icons/react": "2.1.10",
@@ -2282,10 +2278,17 @@
     "uqr": "0.1.3",
     "use-intl": "^4.13.4",
     "vaul": "^1.1.2",
-    "zustand": "^5.0.3"
+    "zustand": "^5.0.3",
+    "@tiptap/extension-code": "3.30.5",
+    "@tiptap/extension-code-block": "3.30.5",
+    "@tiptap/extension-image": "3.30.5",
+    "marked": "^16.4.2",
+    "turndown": "^7.2.1",
+    "turndown-plugin-gfm": "^1.0.2",
+    "yaml": "^2.8.2"
   },
   "peerDependencies": {
-    "@kortix/sdk": "^0.14.12",
+    "@kortix/sdk": "^0.14.14",
     "@tanstack/react-query": "^5.75.2",
     "@types/react": ">=18",
     "react": ">=19",

package/skills/kortix-ui/SKILL.md

@@ -114,7 +114,7 @@ One entry per module. Its curated names are the public API (semver). Every name,
 | `@kortix/ui/files` | Project files (git repo), sandbox files, `FilePreviewHost` | `ProjectFilesView` (workspace); `<FilePreviewHost />` once on a page without a side panel |
 | `@kortix/ui/file-viewer` | Any file kind: pdf, docx, xlsx, csv, pptx, zip, images, code | `<FileViewer content fileName />`; `FileContentRenderer` in `FileSourceProvider` |
 | `@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/markdown`, `@kortix/ui/genui` | Markdown with code, math, links; GenUI blocks | `<UnifiedMarkdown content trust="agent" />`; `genui` renders GenUI fences |
 | `@kortix/ui/diff`, `@kortix/ui/changes` | One diff; a change list | `<DiffView before after />` |
 | `@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 />` |

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

@@ -188,20 +188,21 @@ pass stable objects (module scope):
 | `link` | a plain `<a>` | its router's link, called with `href` |
 | `navigation` | full page loads; `usePathname` / `useSearchParams` read `window.location` | `{ useRouter, usePathname, useSearchParams, useParams }` of its router |
 | `config` | `{ connectorsEnabled: true, managedModelsEnabled: false }` | `managedModelsEnabled: true` when the deployment serves its model lineup. Billing is the SDK flag `billingEnabled` of `createKortix({ backendUrl, getToken, billingEnabled })`, which every billing gate reads. It is for Kortix's own app: its upgrade actions open the Kortix plan dialog that apps/web mounts. A custom host leaves it off, so no upgrade control renders. |
-| `resolvePreviewUrl` | the SDK preview URL, with the SDK token | an async function of the request (it returns a Promise) that resolves to the framed URL with the host's own scoped token, or to `null` to keep the SDK preview URL (a host whose origin is not the Kortix backend). `config.terminalEnabled: false` hides the Terminal when the host's proxy cannot upgrade a WebSocket. `config.cliConnectEnabled` (default true): false hides the Terminal's "Connect from your machine" bar, for a host that serves no `<origin>/install` installer and ships no Kortix CLI. `config.publicSharesEnabled` (default true): false hides every public-link control, for a host that serves no page at `share.public_path` (`/share/session/<token>`). `config.commandPaletteShortcut` / `config.settingsShortcut` (default false): true when the host opens a command palette on ⌘K or settings on ⌘,; only then does the composer hint at them. `config.providerIconBaseUrl`: where the host serves provider logos (`<base>/<icon>.svg`); without it they load from models.dev, and the Kortix provider draws `useBrand`'s icon. `config.accountApiEnabled` (default true): false for a host that fronts one operator key and blocks the account routes; then no IAM probe, billing or session-oversight request runs, billing state stays empty, and every permission gate shows its control (the server enforces each route). |
-| `components` | no slots: each control that opens one is hidden | `ShareSessionModal` (`@kortix/ui/workspace` exports Kortix's), `HomeAnnouncement`, `Wallpaper`, `ProjectProviderModal`, `ProviderAccountsModal`, `ConnectorConnectModal` |
+| `resolvePreviewUrl` | the SDK preview URL, with the SDK token | an async function of the request (it returns a Promise) that resolves to the framed URL with the host's own scoped token, or to `null` to keep the SDK preview URL (a host whose origin is not the Kortix backend). `config.terminalEnabled: false` hides the Terminal when the host's proxy cannot upgrade a WebSocket. `config.cliConnectEnabled` (default true): false hides the Terminal's "Connect from your machine" bar, for a host that serves no `<origin>/install` installer and ships no Kortix CLI. `config.publicSharesEnabled` (default true): false hides every public-link control, for a host that serves no page at `share.public_path` (`/share/session/<token>`). `config.commandPaletteShortcut` / `config.settingsShortcut` (default false): true when the host opens a command palette on ⌘K or settings on ⌘,; only then does the composer hint at them. `config.providerIconBaseUrl`: where the host serves provider logos (`<base>/<icon>.svg`); without it they load from models.dev, and the Kortix provider draws `useBrand`'s icon. `config.accountApiEnabled` (default true): false for a host that fronts one operator key and blocks the account routes; then no IAM probe, billing or session-oversight request runs, billing state stays empty, and every permission gate shows its control (the server enforces each route). `config.modelPickerEnabled`, `contextMeterEnabled`, `sessionOverridesEnabled`, `runtimeSlashEnabled` (default true): false hides the model and effort pickers, the context ring, the session-overrides gear, or the runtime's skills and commands in the `/` menu. `config.offeredAgents` and `agentLabels`: the agents the composer's picker offers, and their display names. `config.takeFiles` and `attachAccept`: the host takes the composer's files itself, and the attach picker's `accept` list. |
+| `components` | no slots: each control that opens one is hidden | `ShareSessionModal` (`@kortix/ui/workspace` exports Kortix's), `HomeAnnouncement`, `Wallpaper`, `ProjectProviderModal`, `ProviderAccountsModal`, `ConnectorConnectModal`, `ArtifactViewer` (without it, the panel shows an artifact read-only), `RoomPanel` (flag `agent_rooms`) |
 | `useBrand` | the Kortix marks | a hook that returns `{ app_name, logo_url, icon_url }` |
 | `image` | a plain `<img>` | its image component |
 | `i18n` | the bundled English catalog | `{ useTranslations, useLocale }` (next-intl signatures) or `{ locale, messages }` |
 | `strings` | English copy of the primitives | the keys it translates |
 | `useViewerId` | no viewer: a one-person session names nobody, and a stopped turn never says "Stopped by" | a hook that returns the signed-in Kortix user's id (the owner of the token the SDK sends). A session several people write in needs it to name the other senders |
+| `useViewer`, `updateViewerMetadata` | `{ id }` from `useViewerId`; preferences stay in this browser | a hook that returns the signed-in user (`id`, `email`, `metadata` with `name`, `full_name`, `avatar_url`); a function that saves profile fields, so UI preferences follow the user across devices |
 
 A Next.js host passes `next/link` and `{ useRouter, usePathname, useSearchParams, useParams }` from
 `next/navigation` unchanged.
 
 ## 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), `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
+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>/admin/sandbox`, `customize` `/projects/<id>/customize/<page>` (agents, skills, connectors, triggers, reminders, models, secrets, review, settings), `admin` `/projects/<id>/admin/<section>` (it follows `customize` when you map only `customize`), `rooms` `/projects/<id>/rooms` (flag `agent_rooms`), `goals` `/projects/<id>/goals` (flag `goals`), `artifacts` `/projects/<id>/artifacts` (flag `artifacts`), and, while the project's `project_channels` flag is on, `space` `/projects/<id>/spaces/<slug>`, `memory` `/projects/<id>/memory`, `channel` `/projects/<id>/c/<slug>` and `dm` `/projects/<id>/dm/<agent>`. 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
@@ -376,9 +377,14 @@ setUiRoutes({
   sessions: () => null,
   drive: () => null,
   apps: () => null,
+  rooms: () => null,
+  goals: () => null,
+  artifacts: () => null,
+  space: () => null,
+  memory: () => null,
   members: () => null,
   sandboxSettings: () => null,
-  customize: () => null,
+  customize: () => null, // `admin` follows it
 });
 
 const router = createBrowserRouter([

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

@@ -76,7 +76,7 @@ Names: `createTranslator`, `UiI18nHost`, `localizeUiCatalog`, `translateUiCatalo
 
 Source: `src/markdown/index.tsx`. Assistant and document markdown: code, math, links, GenUI fences, frontmatter.
 
-Props: `UnifiedMarkdown`: `content`, `trust` (`'agent'` for model text), `variant` (`'document'` for a file), `documentPath`, `isStreaming`, `className`.
+Props: `UnifiedMarkdown`: `content`, `trust` (`'agent'` for model text), `variant` (`'document'` for a file), `documentPath`, `isStreaming`, `genui` (render `openui` fences as GenUI blocks), `className`.
 
 ```tsx
 import { UnifiedMarkdown } from '@kortix/ui/markdown';
@@ -95,15 +95,15 @@ Names: `markdownPolicy`, `MarkdownPolicy`, `MarkdownTrust`, `MarkdownVariant`, `
 
 Source: `src/markdown/genui/index.ts`. Typed UI blocks inside assistant markdown: the block renderer, the component set, telemetry, copy-as-text.
 
-Props: none to mount: `UnifiedMarkdown` renders GenUI fences.
+Props: none to mount: `UnifiedMarkdown` with `genui` renders `openui` fences as blocks (the session thread sets it). Without `genui`, a fence is a code block. The viewer's preference (`useGenuiEnabled`, default on) can turn the blocks off.
 
 ```tsx
 import { mayHoldGenui } from '@kortix/ui/genui';
 import { UnifiedMarkdown } from '@kortix/ui/markdown';
 
-// GenUI fences render inside UnifiedMarkdown; mayHoldGenui is a cheap pre-check.
+// GenUI fences render inside UnifiedMarkdown with `genui`; mayHoldGenui is a cheap pre-check.
 export function Reply({ text }: { text: string }) {
-  return <UnifiedMarkdown content={text} trust="agent" className={mayHoldGenui(text) ? 'min-h-24' : undefined} />;
+  return <UnifiedMarkdown content={text} trust="agent" genui className={mayHoldGenui(text) ? 'min-h-24' : undefined} />;
 }
 ```
 
@@ -155,7 +155,7 @@ Names: `ChangeList`, `ChangeSummary`, `DiffLayoutToggle`, `ExpandAllButton`, `us
 
 Source: `src/files/index.ts`. Browse and edit files. Project files are the git-backed repo; sandbox files are a live session workspace.
 
-Mount: Project files: inside `ProjectFilesProvider` (`projectId`, optional git `ref`). Sandbox files: inside a mounted `useSession`. `FilePreviewHost`: once, on a page with no session side panel; a file open (`openPreview`) shows there. `SessionThread` mounts it already. `DriveUploadTray`: once per project shell; it lists the Drive uploads in flight and stays mounted across pages.
+Mount: Project files: inside `ProjectFilesProvider` (`value`: `projectId`, the git `ref`, optional `defaultBranch`). Sandbox files: inside a mounted `useSession`. `FilePreviewHost`: once, on a page with no session side panel; a file open (`openPreview`) shows there. `SessionThread` mounts it already. `DriveUploadTray`: once per project shell; it lists the Drive uploads in flight and stays mounted across pages.
 
 Props: `ProjectFilesView` (`@kortix/ui/workspace`): `projectId`. It fills its parent (`h-full`): the parent sets the height, or only the header shows. `FileExplorerPage`: `embedded`. `SandboxFileExplorer`: `embedded`, `shareContext`, `leading`. `FilePreviewHost`: none.
 
@@ -336,7 +336,7 @@ Source: `src/session/panel/index.ts`. The session side panel: provider, panel bo
 
 Mount: Inside `SessionPanelProvider` (`sessionId`, `projectId`, `projectSessionId`).
 
-Props: `SessionPanelProvider`: `sessionId` (runtime id), `projectId`, `projectSessionId`, `isSessionBusy`. `ActionPanel` takes none. `openSessionQuickView(view, source, target?)` opens a view (`browser`, `terminal`, `files`, `audit`) in the panel; with no panel mounted, `SessionThread` shows it in a dialog.
+Props: `SessionPanelProvider`: `sessionId` (runtime id), `projectId`, `projectSessionId`, `isSessionBusy`. `ActionPanel` takes none. `openSessionQuickView(view, source, target?)` opens a view (`browser`, `terminal`, `files`, `audit`, `reminders`, `desktop`) in the panel; with no panel mounted, `SessionThread` shows it in a dialog.
 
 ```tsx
 import { ActionPanel, SessionPanelProvider } from '@kortix/ui/session-panel';
@@ -395,11 +395,13 @@ 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).
+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), `goalNeedsAttention` (a health issue no person was asked about), `goalLastWake` (when the goal last woke), `goalAssignedTo` (the goal is for this person), `useGoalPerson` (who a goal is for, by name), `useStartGoal` (starts a goal: a session that writes GOAL.md).
 
 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`
+Spaces (Work in progress, behind the `project_channels` flag; a space is a channel declared in kortix.yaml `spaces:`): `SPACES_FLAG` is that flag key. `useSpacesEnabled` (`projectId`) is true only while it is on. `spaceScope` (`items`, `config`, `enabled`, `bindingOf`) returns `{ spaces, groups, spaceOf }` for a list page; off, it offers no spaces and every item is project-wide. `useActiveSpace` (`projectId`) is the viewer's active space and its setter; off, it reads `null`. `useSpaceFilter` (`projectId`) is a list page's space filter value and setter; off, it is always `ALL_SPACES`. `SpaceFilterTabs` (`spaces`, `groups`, `value`, `onValueChange`) is the filter, and renders nothing without spaces. `spaceFilterLabel` (`value`, `spaces`, `projectWide`) names a filter value for an empty state.
+
+Names: `SpaceView`, `SpaceViewProps`, `SpaceTarget`, `SpaceFolder`, `ChannelGlyph`, `agentLabel`, `MemoryView`, `MemoryViewProps`, `CompanyMemoryPage`, `MemoryLayerRef`, `useMemoryPageHref`, `ProjectPageHeader`, `useCapabilityAccess`, `useProjectNavRows`, `SidebarToggle`, `activeCapabilityTab`, `agentHref`, `capabilityTabHref`, `channelsHref`, `remindersHref`, `reviewHref`, `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/dist/_vendor/shared/meta-agent.d.ts

@@ -1,7 +0,0 @@
-export declare const META_AGENT_NAME = "meta";
-export declare const META_SANDBOX_SLUG = "meta";
-/** Meta — the platform coordinator's DISPLAY name. The internal id stays `meta`
- *  (it keys the grant, the sandbox slug, and the project default agent); this is
- *  the brand name every UI renders. */
-export declare const META_AGENT_DISPLAY_NAME = "Meta";
-export declare function isMetaAgentName(name: string | null | undefined): boolean;

package/dist/customize/agents/agent-grant-pages.d.ts

@@ -1,37 +0,0 @@
-import type { AgentDraft } from '../sections/view/agent-editor.js';
-import { type ProjectConfigSummary } from '@kortix/sdk';
-import { type PolicySetOption } from './agent-policy-sets.js';
-export declare function SkillsGrantPage({ projectId, config, editor, }: {
-    projectId: string;
-    config: ProjectConfigSummary;
-    editor: AgentDraft;
-}): import("react").JSX.Element;
-export declare function ConnectorsGrantPage({ projectId, editor, policySetOptions, }: {
-    projectId: string;
-    editor: AgentDraft;
-    /** Each connector's policy sets (`connectorPolicySetOptions`), read from the
-     *  manifest the page already holds. */
-    policySetOptions?: Record<string, PolicySetOption[]>;
-}): import("react").JSX.Element;
-export declare function SecretsGrantPage({ projectId, editor }: {
-    projectId: string;
-    editor: AgentDraft;
-}): import("react").JSX.Element;
-/**
- * Which Kortix Apps this agent may open — `agents.<name>.apps` in
- * kortix.yaml, the same All · Pick · None machine as Connectors and the same
- * cards.
- *
- * The grant decides admission for a `restricted` or `private` App only. A
- * `project` App admits any agent that holds `project.app.read`, a `public` App
- * admits everyone, and a `password` App admits no agent at all — so a row for
- * one of those is still grantable (its mode can change) but is flagged as not
- * currently load-bearing.
- *
- * Enforcement is the App gate (`agentAppAccessDecision`, apps/api/src/apps/
- * access.ts).
- */
-export declare function AppsGrantPage({ projectId, editor }: {
-    projectId: string;
-    editor: AgentDraft;
-}): import("react").JSX.Element;