@kortix/ui 0.14.12 → 0.14.14

package/dist/terminal/session-terminal-connect-bar.js

@@ -25,7 +25,7 @@ export function SessionTerminalConnectBar({ projectSessionId }) {
 export function SessionTerminalConnectSteps({ id, projectSessionId, }) {
     const tI18nComplete = useTranslations('hardcodedUi.i18nComplete');
     const installCmd = useDeploymentCliInstallCommand(undefined);
-    // A shell through the Kortix PTY: it works on every harness. `sessions connect` attaches OpenCode's own TUI and fails on pi.
+    // A shell through the Kortix PTY.
     const connectCmd = `kortix sessions shell ${projectSessionId}`;
     return (_jsxs("ol", { id: id, className: "space-y-3 pr-1.5 pb-3 pl-3", children: [_jsx(CommandStep, { label: tI18nComplete.raw('textd236e9cd730b'), command: installCmd }), _jsx(CommandStep, { label: tI18nComplete.raw('text842bad27af42'), command: connectCmd })] }));
 }

package/dist/workspace/admin/project-admin-dashboard.d.ts

@@ -0,0 +1,53 @@
+/**
+ * /projects/[id]/admin/<section> — Project admin.
+ *
+ * Customize is agent-first: an agent's page configures what that agent draws
+ * on. Project admin is the project-wide view, one full page with a rail in two
+ * groups:
+ *
+ *  - **Project resources**: the GLOBAL variant of every library page
+ *    (Connectors, Skills, Triggers, Models, Secrets, Apps, and Repo
+ *    with `drives` on), mounted with no props beyond `projectId`. This is
+ *    their only home: Customize keeps Agents and Review (Marko, 2026-10-27).
+ *    A page below a section (a connector, `/admin/connectors/<app>`) renders
+ *    in that section's pane through `content`.
+ *  - **Settings**: every section of the project Settings page
+ *    (`project-settings-sections.ts`), plus the Members link.
+ *
+ * The section is the path segment (`projectAdminHref`); `/admin` alone opens
+ * the first resource the caller may open. Only the active section mounts, and
+ * each one is a lazy chunk: opening Project admin loads one catalog, not all
+ * of them. A section this caller cannot open, or a legacy `?section=`, is
+ * rewritten to the section that opened, so the URL always names the pane.
+ *
+ * Gated on `project.settings.write`, the Settings page's own leaf. Each row
+ * then follows the rule its own surface already applies: a resource row
+ * follows `capabilityAccess` (the Customize rule), a settings row follows
+ * `isCustomizeSectionVisible` (the Settings page rule). Nothing renders until
+ * those probes, the `drives` flag and the project detail (Members needs its
+ * account) answer, so a row never appears and then leaves.
+ *
+ * The page's `SettingsNav` catches `navigate(tab)` calls from a pane. A pane
+ * that pushes its own route (ConnectorsPage opening a connector) still leaves
+ * for that route: the resource pages take no base-path prop yet.
+ *
+ * Apps is a page of the host app, not of this package. The host passes it in
+ * `hostSections`; a row without a page is not listed. Loops were one until
+ * 2026-10-28: they are triggers on the Triggers page now.
+ */
+import { type ComponentType, type ReactNode } from 'react';
+export { buildProjectAdminNav } from './project-admin-nav.js';
+export { DEFAULT_PROJECT_ADMIN_SECTION, parseProjectAdminSection, projectAdminHref, type ProjectAdminSectionKey, } from '../../customize/project-settings/project-admin-sections.js';
+type SectionPage = ComponentType<{
+    projectId: string;
+}>;
+/** Pages that live in the host app (`apps/web`), passed in by its route. */
+export type ProjectAdminHostSections = Partial<Record<'apps', SectionPage>>;
+export declare function ProjectAdminDashboard({ projectId, section, content, hostSections, }: {
+    projectId: string;
+    /** The `/admin/<section>` segment. Absent: the first section the caller may open. */
+    section?: string;
+    /** A page below the section (`/admin/connectors/<app>`), shown in its pane. */
+    content?: ReactNode;
+    hostSections?: ProjectAdminHostSections;
+}): import("react").JSX.Element;

package/dist/workspace/admin/project-admin-dashboard.js

@@ -0,0 +1,252 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * /projects/[id]/admin/<section> — Project admin.
+ *
+ * Customize is agent-first: an agent's page configures what that agent draws
+ * on. Project admin is the project-wide view, one full page with a rail in two
+ * groups:
+ *
+ *  - **Project resources**: the GLOBAL variant of every library page
+ *    (Connectors, Skills, Triggers, Models, Secrets, Apps, and Repo
+ *    with `drives` on), mounted with no props beyond `projectId`. This is
+ *    their only home: Customize keeps Agents and Review (Marko, 2026-10-27).
+ *    A page below a section (a connector, `/admin/connectors/<app>`) renders
+ *    in that section's pane through `content`.
+ *  - **Settings**: every section of the project Settings page
+ *    (`project-settings-sections.ts`), plus the Members link.
+ *
+ * The section is the path segment (`projectAdminHref`); `/admin` alone opens
+ * the first resource the caller may open. Only the active section mounts, and
+ * each one is a lazy chunk: opening Project admin loads one catalog, not all
+ * of them. A section this caller cannot open, or a legacy `?section=`, is
+ * rewritten to the section that opened, so the URL always names the pane.
+ *
+ * Gated on `project.settings.write`, the Settings page's own leaf. Each row
+ * then follows the rule its own surface already applies: a resource row
+ * follows `capabilityAccess` (the Customize rule), a settings row follows
+ * `isCustomizeSectionVisible` (the Settings page rule). Nothing renders until
+ * those probes, the `drives` flag and the project detail (Members needs its
+ * account) answer, so a row never appears and then leaves.
+ *
+ * The page's `SettingsNav` catches `navigate(tab)` calls from a pane. A pane
+ * that pushes its own route (ConnectorsPage opening a connector) still leaves
+ * for that route: the resource pages take no base-path prop yet.
+ *
+ * Apps is a page of the host app, not of this package. The host passes it in
+ * `hostSections`; a row without a page is not listed. Loops were one until
+ * 2026-10-28: they are triggers on the Triggers page now.
+ */
+import { lazy, Suspense, useCallback, useEffect, useMemo } from 'react';
+import { useQuery, useQueryClient } from '@tanstack/react-query';
+import { getProjectDetail } from '@kortix/sdk';
+import { contract, invalidatePermissionProbes, qk, useFeatureFlag } from '@kortix/sdk/react';
+import { useTranslations as useI18nTranslations } from '../../i18n/index.js';
+import { Button } from '../../primitives/button.js';
+import { EmptyState } from '../../primitives/empty-state.js';
+import { ErrorState } from '../../primitives/error-state.js';
+import { FadedScrollArea } from '../../primitives/faded-scroll-area.js';
+import { SettingsSectionHeader } from '../../primitives/settings-section-header.js';
+import { Skeleton } from '../../primitives/skeleton.js';
+import { Tabs, TabsList, TabsTrigger } from '../../primitives/tabs.js';
+import { UiLink as Link, useUiRouter, useUiSearchParams } from '../../providers/ui-provider.js';
+import { CapabilitiesSkeleton } from '../../customize/shared/capability-skeleton.js';
+import { projectSettingsSections } from '../../customize/project-settings/project-settings-sections.js';
+import { SETTINGS_SIDEBAR_WIDTH_PX } from '../../internal/account-hub/account-settings-shell.js';
+import { useIsMobile } from '../../internal/hooks/index.js';
+import { RAIL_HORIZONTAL_ROW_CLASS, RAIL_ROW_CLASS, RailGroup } from '../../internal/components/nav-rail.js';
+import { capabilityAccess } from '../../internal/layout/project-settings-nav.js';
+import { SettingsNavProvider } from '../../internal/layout/settings-nav-context.js';
+import { withStaleChunkRecovery } from '../../internal/lib/chunk-reload.js';
+import { CUSTOMIZE_SECTION_GATE_ACTIONS, isCustomizeSectionVisible, PROJECT_ACTIONS, } from '../../internal/lib/project-actions.js';
+import { useProjectCans, useProjectPageCans } from '../../internal/lib/use-project-can.js';
+import { cn } from '../../internal/lib/utils.js';
+import { useSettingsPanelStore } from '../../internal/stores/settings-panel-store.js';
+import { buildProjectAdminNav } from './project-admin-nav.js';
+import { DEFAULT_PROJECT_ADMIN_SECTION, isProjectAdminResource, RESOURCE_LABEL_KEYS, parseProjectAdminSection, PROJECT_ADMIN_RESOURCES, projectAdminHref, } from '../../customize/project-settings/project-admin-sections.js';
+export { buildProjectAdminNav } from './project-admin-nav.js';
+export { DEFAULT_PROJECT_ADMIN_SECTION, parseProjectAdminSection, projectAdminHref, } from '../../customize/project-settings/project-admin-sections.js';
+function lazyPage(load, pick) {
+    return lazy(withStaleChunkRecovery(() => load().then((mod) => ({ default: pick(mod) }))));
+}
+/* The package's own pages, one lazy chunk each, mounted exactly as their
+   Customize routes mount them. */
+const RESOURCE_PAGES = {
+    connectors: lazyPage(() => import('../../customize/connectors/connectors-page.js'), (m) => m.ConnectorsPage),
+    skills: lazyPage(() => import('../../customize/skills/skills-page.js'), (m) => m.SkillsPage),
+    tools: lazyPage(() => import('../../customize/skills/skills-page.js'), (m) => m.ToolsPage),
+    extensions: lazyPage(() => import('../../customize/skills/skills-page.js'), (m) => m.ExtensionsPage),
+    drives: lazyPage(() => import('../../customize/agents/agent-drives-section.js'), (m) => m.AgentDrivesSection),
+    triggers: lazyPage(() => import('../../customize/triggers/triggers-page.js'), (m) => m.TriggersPage),
+    models: lazyPage(() => import('../../customize/models/models-page.js'), (m) => m.ModelsPage),
+    secrets: lazyPage(() => import('../../customize/secrets/secrets-page.js'), (m) => m.SecretsPage),
+    repo: lazyPage(() => import('../layout/project-files-view.js'), (m) => m.ProjectFilesView),
+};
+/* A host page owns a full-viewport root (`AppsView` is `h-svh`). Inside this
+   pane that box would overflow by the header's height and clip its last row,
+   so the pane bounds its direct child to the pane's own height. */
+const HOST_PANE_CLASS = '*:h-full';
+/* The Settings page's panes, mounted with the same props and in the same
+   order `ProjectSettingsSectionPane` mounts them. */
+const SETTINGS_PAGES = {
+    general: lazyPage(() => import('../../customize/settings/tabs/general-tab.js'), (m) => m.GeneralTab),
+    git: lazyPage(() => import('../../customize/sections/view/git-view.js'), (m) => {
+        const { GitView } = m;
+        return function GitSection({ projectId }) {
+            const tI18nComplete = useI18nTranslations('hardcodedUi.i18nComplete');
+            return (_jsxs("div", { className: "mx-auto w-full max-w-2xl space-y-8", children: [_jsx(SettingsSectionHeader, { title: tI18nComplete.raw('text95ddc9c4dfd3'), description: tI18nComplete.raw('texte0d7209f4c07'), className: "pb-1" }), _jsx(GitView, { projectId: projectId })] }));
+        };
+    }),
+    sandbox: lazyPage(() => Promise.all([
+        import('../../customize/settings/tabs/sandbox-tab.js'),
+        import('../../customize/settings/tabs/snapshots-tab.js'),
+    ]), ([sandbox, snapshots]) => {
+        const { SandboxTab } = sandbox;
+        const { SnapshotsTab } = snapshots;
+        return function SandboxSection({ projectId }) {
+            return (_jsxs("div", { className: "space-y-8", children: [_jsx(SandboxTab, { projectId: projectId }), _jsx(SnapshotsTab, { projectId: projectId })] }));
+        };
+    }),
+    'feature-flags': lazyPage(() => import('../../customize/settings/tabs/experimental-tab.js'), (m) => m.ExperimentalTab),
+};
+/** A verdict the engine returned: not a probe in flight, not a failed probe. */
+function receivedDenial(result) {
+    return !!result && !result.isLoading && !result.isError && !result.allowed;
+}
+function answered(caps, actions) {
+    return actions.every((action) => caps[action] && !caps[action].isLoading);
+}
+const NO_HOST_SECTIONS = {};
+export function ProjectAdminDashboard({ projectId, section, content, hostSections = NO_HOST_SECTIONS, }) {
+    const tI18nComplete = useI18nTranslations('hardcodedUi.i18nComplete');
+    const tAdmin = useI18nTranslations('projectAdmin');
+    const isMobile = useIsMobile();
+    const searchParams = useUiSearchParams();
+    const router = useUiRouter();
+    const queryClient = useQueryClient();
+    const detail = useQuery({
+        queryKey: qk.project.detail(projectId),
+        queryFn: () => getProjectDetail(projectId),
+        enabled: !!projectId,
+        ...contract('config'),
+    });
+    const accountId = detail.data?.project?.account_id;
+    // One batch for the page gate, the resource rows and Members: the same
+    // `PROJECT_PAGE_ACTIONS` batch the sidebar has usually cached already.
+    const pageCans = useProjectPageCans(projectId);
+    const settingsCans = useProjectCans(projectId, CUSTOMIZE_SECTION_GATE_ACTIONS, { accountId });
+    const canAdmin = pageCans[PROJECT_ACTIONS.PROJECT_SETTINGS_WRITE];
+    const drives = useFeatureFlag(projectId, 'drives');
+    // The Customize rule for each library, without its flag clauses: a flag-off
+    // Loops page explains its own gate (`FeatureGateScreen`) instead of
+    // disappearing from the rail. Repo applies `drives` itself, below.
+    const resources = capabilityAccess(pageCans, { drives: true, reminders: true });
+    const settingsAnswered = answered(settingsCans, CUSTOMIZE_SECTION_GATE_ACTIONS);
+    const settingsProbeFailed = CUSTOMIZE_SECTION_GATE_ACTIONS.some((action) => settingsCans[action]?.isError);
+    const settled = !!canAdmin &&
+        !canAdmin.isLoading &&
+        resources.settled &&
+        settingsAnswered &&
+        !drives.isLoading &&
+        // Members needs the account id: wait for the detail so it never pops in.
+        detail.isFetched;
+    // `resources.tabs` is a fresh array each render; its contents are the key.
+    const allowedTabs = resources.tabs.join(',');
+    const drivesOn = drives.enabled;
+    const resourceRows = useMemo(() => {
+        const allowed = new Set(allowedTabs.split(','));
+        return PROJECT_ADMIN_RESOURCES.filter((r) => (r.host ? !!hostSections[r.key] : true))
+            .filter((r) => !r.capability || allowed.has(r.capability))
+            .filter((r) => r.flag !== 'drives' || drivesOn)
+            .map((r) => {
+            const legacy = RESOURCE_LABEL_KEYS[r.key];
+            return { key: r.key, label: legacy ? tI18nComplete.raw(legacy) : tAdmin(r.key), icon: r.icon };
+        });
+    }, [hostSections, allowedTabs, drivesOn, tI18nComplete, tAdmin]);
+    const settingsRows = useMemo(() => projectSettingsSections(tI18nComplete)
+        .filter((s) => s.key !== 'review')
+        // The Settings page's rule: a failed probe hides nothing. The pane
+        // itself reports a 403 if the server refuses it.
+        .filter((s) => settingsProbeFailed ||
+        isCustomizeSectionVisible(s.gate, (action) => settingsCans[action]?.allowed === true))
+        .map((s) => ({ key: s.key, label: s.label, icon: s.icon })), [settingsCans, settingsProbeFailed, tI18nComplete]);
+    const rows = [...resourceRows, ...settingsRows];
+    // A section named in the URL but not listed for this caller falls back to
+    // the first listed row, so a stale link lands on a real pane. A legacy
+    // `?section=` still names one.
+    const named = section ?? searchParams.get('section');
+    const requested = parseProjectAdminSection(named);
+    const active = (requested && rows.some((r) => r.key === requested) ? requested : undefined) ??
+        (rows.some((r) => r.key === DEFAULT_PROJECT_ADMIN_SECTION) ? DEFAULT_PROJECT_ADMIN_SECTION : rows[0]?.key);
+    // The rail is final once `settled`: move a legacy `?section=` or a fallen-
+    // back segment onto `/admin/<section>`, so a copied link names the pane on
+    // screen. A page below a section (`content`) keeps its own URL.
+    const legacyQuery = searchParams.get('section') !== null;
+    useEffect(() => {
+        if (!settled || !active || content)
+            return;
+        if (!legacyQuery && named === active)
+            return;
+        if (!legacyQuery && named === null && section === undefined)
+            return;
+        router.replace(projectAdminHref(projectId, active));
+    }, [settled, active, named, legacyQuery, section, content, projectId, router]);
+    const membersTab = useSettingsPanelStore((s) => s.membersTab);
+    const navigateTo = useCallback((href) => router.push(href), [router]);
+    const settingsNav = useMemo(() => buildProjectAdminNav({
+        projectId,
+        section: active ?? DEFAULT_PROJECT_ADMIN_SECTION,
+        membersTab,
+        accountId,
+        navigateTo,
+    }), [projectId, active, membersTab, accountId, navigateTo]);
+    // The gate probe failed: say so once, instead of guessing either way.
+    if (canAdmin?.isError) {
+        return (_jsx(AdminAccessCheckFailed, { onRetry: () => {
+                void invalidatePermissionProbes(queryClient, { accountId });
+                void queryClient.invalidateQueries({ queryKey: qk.project.detail(projectId) });
+            } }));
+    }
+    if (settled && (receivedDenial(canAdmin) || rows.length === 0)) {
+        return _jsx(AdminAccessDenied, { projectId: projectId });
+    }
+    const ActivePage = !active
+        ? null
+        : isProjectAdminResource(active)
+            ? (RESOURCE_PAGES[active] ?? hostSections[active] ?? null)
+            : SETTINGS_PAGES[active];
+    const title = tI18nComplete.raw('text73738b374f4b');
+    // The Customize bar above names every library and Settings, and holds Members.
+    // A library page runs full width; a settings section keeps a short sub-nav
+    // of the settings sections only (Jay, 2026-10-29: prod's layout).
+    const showRail = !!active && !isProjectAdminResource(active) && settingsRows.length > 1;
+    return (_jsx(SettingsNavProvider, { value: settingsNav, children: _jsxs("div", { className: cn('min-h-0 flex-1 overflow-hidden', isMobile || !showRail ? 'flex flex-col' : 'grid'), 
+            // The Settings page's rail width, so the two settings surfaces are one shape.
+            style: isMobile || !showRail ? undefined : { gridTemplateColumns: `${SETTINGS_SIDEBAR_WIDTH_PX}px 1fr` }, children: [!showRail ? null : isMobile ? (_jsxs("nav", { "aria-label": title, className: "border-border/60 bg-background flex shrink-0 flex-col border-b", children: [_jsx("h1", { className: "text-foreground px-4 pt-3 text-sm font-medium", children: title }), _jsx(FadedScrollArea, { orientation: "horizontal", fadeColor: "from-background", className: "min-w-0 flex-1 py-2", children: settled ? (_jsx("div", { className: "flex w-fit items-center gap-2", children: _jsx(Tabs, { value: active, className: "w-fit", children: _jsx(TabsList, { orientation: "horizontal", className: "w-fit", children: settingsRows.map((row) => (_jsx(RailTrigger, { projectId: projectId, row: row, horizontal: true }, row.key))) }) }) })) : (_jsx(Skeleton, { className: "mx-3 h-7 w-64 rounded-md" })) })] })) : (_jsx("aside", { className: "flex min-h-0 flex-col border-r bg-inherit", children: _jsx("nav", { "aria-label": title, className: "flex min-h-0 flex-1 [scrollbar-width:none] flex-col gap-4 overflow-y-auto px-2 pt-4 pb-2 [-ms-overflow-style:none] [&::-webkit-scrollbar]:hidden", children: settled ? (_jsx(Tabs, { value: active, orientation: "vertical", className: "gap-4", children: _jsx(RailGroup, { label: tI18nComplete.raw('text74a883a037bc'), children: settingsRows.map((row) => (_jsx(RailTrigger, { projectId: projectId, row: row }, row.key))) }) })) : (_jsx(RailSkeleton, {})) }) })), _jsx("main", { className: "bg-background flex min-h-0 min-w-0 flex-1 flex-col overflow-hidden", children: settled && ActivePage && active ? (_jsx(Suspense, { fallback: _jsx(CapabilitiesSkeleton, {}), children: isProjectAdminResource(active) ? (_jsx("div", { className: cn('flex min-h-0 flex-1 flex-col overflow-hidden', active === 'apps' && HOST_PANE_CLASS), children: content ?? _jsx(ActivePage, { projectId: projectId }) })) : (_jsx("div", { className: "mx-auto flex min-h-0 w-full flex-1 flex-col space-y-6 overflow-y-auto px-4 py-10 pb-20 lg:py-14", children: _jsx(ActivePage, { projectId: projectId }) })) }, active)) : (_jsx(CapabilitiesSkeleton, {})) })] }) }));
+}
+/* ------------------------------------------------------------------ rail */
+/** One row: a real link inside the trigger, since the section is URL state. */
+function RailTrigger({ projectId, row, horizontal = false, }) {
+    const Glyph = row.icon;
+    return (_jsx(TabsTrigger, { value: row.key, asChild: true, size: horizontal ? undefined : 'md', className: horizontal ? RAIL_HORIZONTAL_ROW_CLASS : RAIL_ROW_CLASS, children: _jsxs(Link, { href: projectAdminHref(projectId, row.key), prefetch: true, children: [_jsx(Glyph, { className: "size-4 shrink-0" }), _jsx("span", { className: cn(!horizontal && 'truncate'), children: row.label })] }) }));
+}
+/** The loaded rail's shape: two labelled groups of icon + label rows. */
+const RAIL_SKELETON_GROUPS = [
+    ['w-20', 'w-12', 'w-16', 'w-12', 'w-14', 'w-14', 'w-10'],
+    ['w-14', 'w-16', 'w-28', 'w-20', 'w-16', 'w-16'],
+];
+function RailSkeleton() {
+    return (_jsx("div", { className: "space-y-4", "aria-hidden": true, children: RAIL_SKELETON_GROUPS.map((group, g) => (_jsxs("div", { className: "space-y-1", children: [_jsx(Skeleton, { className: "mx-2.5 my-2 h-3 w-20 rounded-sm" }), group.map((width, i) => (_jsxs("div", { className: "flex h-8 items-center gap-2 px-2.5", children: [_jsx(Skeleton, { className: "size-4 shrink-0 rounded-sm" }), _jsx(Skeleton, { className: cn('h-3.5 rounded-sm', width) })] }, i)))] }, g))) }));
+}
+/* ----------------------------------------------------------------- states */
+function AdminAccessDenied({ projectId }) {
+    const tI18nComplete = useI18nTranslations('hardcodedUi.i18nComplete');
+    // The voice rule for a refused action (voice-and-tone.md section 4): name
+    // the grant in mono once, then say who can grant it.
+    const [beforeGrant, afterGrant] = tI18nComplete.raw('textb24d48611918').split('{grant}');
+    return (_jsx("div", { className: "flex min-h-0 flex-1 items-center justify-center px-4 py-8", children: _jsx(EmptyState, { size: "sm", title: tI18nComplete.raw('text078931e34187'), description: _jsxs(_Fragment, { children: [beforeGrant, _jsx("code", { className: "font-mono", children: PROJECT_ACTIONS.PROJECT_SETTINGS_WRITE }), afterGrant] }), action: _jsx(Button, { asChild: true, variant: "outline", size: "sm", children: _jsx(Link, { href: `/projects/${projectId}`, children: tI18nComplete.raw('text37737d817d12') }) }) }) }));
+}
+function AdminAccessCheckFailed({ onRetry }) {
+    const tI18nComplete = useI18nTranslations('hardcodedUi.i18nComplete');
+    return (_jsx("div", { className: "flex min-h-0 flex-1 items-center justify-center px-4 py-8", children: _jsx(ErrorState, { size: "sm", title: tI18nComplete.raw('text9eebeabf6094'), description: tI18nComplete.raw('texta0c2cc1374d9'), action: _jsx(Button, { variant: "outline", size: "sm", onClick: onRetry, children: tI18nComplete.raw('textd8b8392e2c54') }) }) }));
+}

package/dist/workspace/admin/project-admin-nav.d.ts

@@ -0,0 +1,20 @@
+import type { SettingsNav } from '../../internal/layout/settings-nav-context.js';
+import { type MembersTab } from '../../internal/stores/settings-panel-store.js';
+import { type ProjectAdminSectionKey } from '../../customize/project-settings/project-admin-sections.js';
+/**
+ * The `SettingsNav` for panes mounted in Project admin. Panes still speak the
+ * overlay's vocabulary (`navigate('llm-providers')`, `navigate('experimental')`):
+ * an id that names a section of this page stays on this page. Everything else
+ * (`members`, `review`, account sections, personal overlay tabs) resolves the
+ * way it does on every standalone capability page.
+ *
+ * It catches `navigate(tab)` calls only. A pane that pushes its own route
+ * (ConnectorsPage opening a connector) still leaves this page.
+ */
+export declare function buildProjectAdminNav(state: {
+    projectId: string;
+    section: ProjectAdminSectionKey;
+    membersTab: MembersTab;
+    accountId?: string;
+    navigateTo: (href: string) => void;
+}): SettingsNav;

package/dist/workspace/admin/project-admin-nav.js

@@ -0,0 +1,41 @@
+import { buildStandaloneCapabilityNav } from '../../customize/shared/standalone-settings-nav.js';
+import { useSettingsPanelStore } from '../../internal/stores/settings-panel-store.js';
+import { projectAdminHref, projectAdminNavTarget } from '../../customize/project-settings/project-admin-sections.js';
+/**
+ * The `SettingsNav` for panes mounted in Project admin. Panes still speak the
+ * overlay's vocabulary (`navigate('llm-providers')`, `navigate('experimental')`):
+ * an id that names a section of this page stays on this page. Everything else
+ * (`members`, `review`, account sections, personal overlay tabs) resolves the
+ * way it does on every standalone capability page.
+ *
+ * It catches `navigate(tab)` calls only. A pane that pushes its own route
+ * (ConnectorsPage opening a connector) still leaves this page.
+ */
+export function buildProjectAdminNav(state) {
+    const fallback = buildStandaloneCapabilityNav({
+        projectId: state.projectId,
+        activeTab: state.section,
+        membersTab: state.membersTab,
+        accountId: state.accountId,
+        navigateTo: state.navigateTo,
+    });
+    return {
+        ...fallback,
+        navigate: (tab, opts) => {
+            const target = projectAdminNavTarget(tab);
+            if (!target) {
+                fallback.navigate(tab, opts);
+                return;
+            }
+            if (opts?.membersTab) {
+                useSettingsPanelStore.setState({ membersTab: opts.membersTab });
+            }
+            if (tab === 'channels') {
+                state.navigateTo(projectAdminHref(state.projectId, 'connectors', { scope: 'channels' }));
+            }
+            else if (target !== state.section) {
+                state.navigateTo(projectAdminHref(state.projectId, target));
+            }
+        },
+    };
+}

package/dist/workspace/home/welcome-body.js

@@ -1,8 +1,17 @@
 'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useLayoutEffect, useState } from 'react';
+import { HashIcon, XIcon } from '@phosphor-icons/react';
 import { SessionWelcome } from '../../session/thread/session-welcome.js';
-import { useProjectName } from '@kortix/sdk/react';
+import { agentsInSpace, listSpaces } from '@kortix/sdk';
+import { useProjectConfig, useProjectName } from '@kortix/sdk/react';
+import { useTranslations } from '../../i18n/index.js';
+import { AgentMark } from '../../internal/components/agent-mark.js';
+import { agentHref } from '../../internal/lib/capability-tab-routes.js';
+import { useActiveSpace } from '../../internal/stores/active-space-store.js';
+import { uiRoutes } from '../../lib/routes.js';
+import { Button } from '../../primitives/button.js';
+import { UiLink as Link } from '../../providers/ui-provider.js';
 import { HOME_GREETINGS, HOME_GREETING_STORAGE_KEY, greetingIndexFor, spaceBefore, } from './home-greeting.js';
 /**
  * The project-home empty state: ONE centred column.
@@ -36,11 +45,24 @@ import { HOME_GREETINGS, HOME_GREETING_STORAGE_KEY, greetingIndexFor, spaceBefor
 export function ProjectHomeWelcomeBody({ projectId, composer, sentTurn, onPickSuggestion, }) {
     // One source for the project name — see `useProjectName`'s doc comment.
     const name = useProjectName(projectId) ?? '';
+    // The active space (the last space opened, or its New session). The heading
+    // names the space, its description reads as its brief, and the composer
+    // below starts only this space's agents. Leave clears it.
+    const [activeSpace, setActiveSpace] = useActiveSpace(projectId);
+    const config = useProjectConfig(projectId);
+    // Declared or only referenced by an agent; a stale selection (the space was
+    // removed) is no space.
+    const space = activeSpace
+        ? listSpaces(config).find((candidate) => candidate.name === activeSpace)
+        : undefined;
+    const spaceLabel = space ? space.label || space.name : null;
+    const spaceAgents = space ? agentsInSpace(space.name, config?.agents ?? []) : [];
+    const tSpaces = useTranslations('spaces');
     // One word, not two. The name sits inside the sentence in `text-foreground`
     // while the rest is muted, so the fallback has to read as a NAME in that
     // slot — "this project" is a description wearing a name's highlight, and it
     // stretches the line for a case where we know the least.
-    const displayName = name.trim() || 'it';
+    const displayName = spaceLabel ?? (name.trim() || 'it');
     // Variant 0 on the server and through hydration; the stored visit count
     // picks the real one before first paint. See `home-greeting.ts`.
     const [greeting, setGreeting] = useState(HOME_GREETINGS[0]);
@@ -58,7 +80,7 @@ export function ProjectHomeWelcomeBody({ projectId, composer, sentTurn, onPickSu
             // Storage blocked (private mode, an in-app WebView): variant 0 stays.
         }
     }, []);
-    return (_jsx("div", { className: "relative z-10 flex min-h-0 flex-1 flex-col overflow-y-auto", children: _jsx("div", { className: "m-auto flex w-full max-w-3xl shrink-0 flex-col gap-10 py-8 sm:px-4", children: _jsxs("div", { className: "flex w-full flex-col gap-6", children: [_jsxs("h1", { className: "text-muted-foreground w-full px-4 text-3xl leading-[1.2] tracking-tight text-balance max-sm:text-2xl", hidden: !!sentTurn, children: [greeting.before, ' ', _jsx("span", { className: "text-foreground", children: displayName }), spaceBefore(greeting.after) ? ' ' : '', greeting.after] }), sentTurn ? _jsx("div", { className: "w-full px-4", children: sentTurn }) : null, composer ? _jsx("div", { className: "flex w-full flex-col gap-4", children: composer }) : null] }) }) }));
+    return (_jsx("div", { className: "relative z-10 flex min-h-0 flex-1 flex-col overflow-y-auto", children: _jsx("div", { className: "m-auto flex w-full max-w-3xl shrink-0 flex-col gap-10 py-8 sm:px-4", children: _jsxs("div", { className: "flex w-full flex-col gap-6", children: [spaceLabel && !sentTurn ? (_jsxs("div", { className: "flex items-center gap-1 px-4", children: [_jsxs(Link, { href: uiRoutes().space(projectId, space.name) ?? uiRoutes().project(projectId), className: "hover:bg-hover text-foreground flex min-w-0 items-center gap-1 rounded-sm px-1 text-sm font-medium transition-colors", children: [_jsx(HashIcon, { className: "text-muted-foreground size-3.5 shrink-0" }), _jsx("span", { className: "truncate", children: spaceLabel })] }), _jsx(Button, { size: "icon-xs", variant: "ghost", onClick: () => setActiveSpace(null), "aria-label": tSpaces('leave', { name: spaceLabel }), children: _jsx(XIcon, {}) }), spaceAgents.length ? (_jsx("span", { role: "group", className: "ml-auto flex items-center gap-1", "aria-label": tSpaces('agents'), children: spaceAgents.map((name) => (_jsx(Link, { href: agentHref(projectId, name), className: "rounded-sm", "aria-label": tSpaces('openAgent', { name }), children: _jsx(AgentMark, { slug: name }) }, name))) })) : null] })) : null, _jsxs("h1", { className: "text-muted-foreground w-full px-4 text-2xl tracking-tight text-balance", hidden: !!sentTurn, children: [greeting.before, ' ', _jsx("span", { className: "text-foreground", children: displayName }), spaceBefore(greeting.after) ? ' ' : '', greeting.after] }), space?.description && !sentTurn ? (_jsx("p", { className: "text-muted-foreground w-full px-4 text-sm text-pretty", children: space.description })) : null, sentTurn ? _jsx("div", { className: "w-full px-4", children: sentTurn }) : null, composer ? _jsx("div", { className: "flex w-full flex-col gap-4", children: composer }) : null] }) }) }));
 }
 /** The wallpaper behind the hero. Pointer-transparent and inert — it is
  *  scenery, and nothing in it is reachable. */

package/dist/workspace/index.d.ts

@@ -7,7 +7,6 @@ export { ProjectPageHeader } from '../internal/layout/project-page-header.js';
 export { useCapabilityAccess, useProjectNavRows } from '../internal/layout/project-settings-nav.js';
 export { SidebarToggle } from '../internal/layout/sidebar-toggle.js';
 export { activeCapabilityTab, agentHref, capabilityTabHref, channelsHref, remindersHref, reviewHref, } from '../internal/lib/capability-tab-routes.js';
-export { detectManifestVersion, manifestFilename, manifestNeedsUpgrade, useProjectManifestVersion, type ManifestVersion, } from '../internal/lib/manifest-version.js';
 export { CUSTOMIZE_SECTION_ACCESS, CUSTOMIZE_SECTION_GATE_ACTIONS, PROJECT_ACTIONS, isCustomizeSectionVisible, type CustomizeSection, type ProjectAction, } from '../internal/lib/project-actions.js';
 export { usePermission, usePermissions, usePermissionsFor } from '../internal/lib/use-permission.js';
 export { PROJECT_PAGE_ACTIONS, useProjectCan, useProjectCans, useProjectPageCans, type CanResult, } from '../internal/lib/use-project-can.js';
@@ -29,4 +28,9 @@ export { CompanyMemoryPage } from './memory/company-memory-page.js';
 export { ProjectSessionList } from './sidebar/project-session-list.js';
 export { ProjectSidebar } from './sidebar/project-sidebar.js';
 export { ShareSessionModal } from './sidebar/modal/share-session-modal.js';
-export { formatGoalTime, GoalHealthDot, goalHref, goalNeedsYou, goalOpenAsks, goalProgress, GoalStatusBadge, useGoalClock, useGoalIssueText, } from '../internal/goals/goal-meta.js';
+export { formatGoalTime, goalAssignedTo, GoalHealthDot, goalHref, goalNeedsYou, goalNeedsAttention, goalLastWake, useGoalPerson, useStartGoal, goalOpenAsks, goalProgress, GoalStatusBadge, useGoalClock, useGoalIssueText, } from '../internal/goals/goal-meta.js';
+export { useActiveSpace } from '../internal/stores/active-space-store.js';
+export { ALL_SPACES } from '../customize/shared/catalog/catalog-space-tabs.js';
+export { SpaceFilterTabs, spaceFilterLabel } from './space/space-filter-tabs.js';
+export { useSpaceFilter } from './space/use-space-filter.js';
+export { SPACES_FLAG, spaceScope, useSpacesEnabled } from '../internal/lib/space-scope.js';

package/dist/workspace/index.js

@@ -3,11 +3,15 @@
  * resizable side panel), the project sidebar, sessions list, project home, and the
  * permission and route helpers they share.
  */
+// NOTE: ProjectAdminDashboard is intentionally NOT re-exported here. It pulls
+// every capability data hook (connectors/triggers/reminders/models/secrets/
+// review); since Turbopack does not tree-shake this barrel in dev, re-exporting
+// it made all ~44 routes that import `@kortix/ui/workspace` compile that graph.
+// The /admin route imports it directly from '@kortix/ui/workspace/admin/project-admin-dashboard'.
 export { ProjectPageHeader } from '../internal/layout/project-page-header.js';
 export { useCapabilityAccess, useProjectNavRows } from '../internal/layout/project-settings-nav.js';
 export { SidebarToggle } from '../internal/layout/sidebar-toggle.js';
 export { activeCapabilityTab, agentHref, capabilityTabHref, channelsHref, remindersHref, reviewHref, } from '../internal/lib/capability-tab-routes.js';
-export { detectManifestVersion, manifestFilename, manifestNeedsUpgrade, useProjectManifestVersion, } from '../internal/lib/manifest-version.js';
 export { CUSTOMIZE_SECTION_ACCESS, CUSTOMIZE_SECTION_GATE_ACTIONS, PROJECT_ACTIONS, isCustomizeSectionVisible, } from '../internal/lib/project-actions.js';
 export { usePermission, usePermissions, usePermissionsFor } from '../internal/lib/use-permission.js';
 export { PROJECT_PAGE_ACTIONS, useProjectCan, useProjectCans, useProjectPageCans, } from '../internal/lib/use-project-can.js';
@@ -29,4 +33,10 @@ export { CompanyMemoryPage } from './memory/company-memory-page.js';
 export { ProjectSessionList } from './sidebar/project-session-list.js';
 export { ProjectSidebar } from './sidebar/project-sidebar.js';
 export { ShareSessionModal } from './sidebar/modal/share-session-modal.js';
-export { formatGoalTime, GoalHealthDot, goalHref, goalNeedsYou, goalOpenAsks, goalProgress, GoalStatusBadge, useGoalClock, useGoalIssueText, } from '../internal/goals/goal-meta.js';
+export { formatGoalTime, goalAssignedTo, GoalHealthDot, goalHref, goalNeedsYou, goalNeedsAttention, goalLastWake, useGoalPerson, useStartGoal, goalOpenAsks, goalProgress, GoalStatusBadge, useGoalClock, useGoalIssueText, } from '../internal/goals/goal-meta.js';
+// Spaces: the per-viewer active space and the space filter the Goals and Artifacts pages share.
+export { useActiveSpace } from '../internal/stores/active-space-store.js';
+export { ALL_SPACES } from '../customize/shared/catalog/catalog-space-tabs.js';
+export { SpaceFilterTabs, spaceFilterLabel } from './space/space-filter-tabs.js';
+export { useSpaceFilter } from './space/use-space-filter.js';
+export { SPACES_FLAG, spaceScope, useSpacesEnabled } from '../internal/lib/space-scope.js';

package/dist/workspace/layout/new-session-create.js

@@ -1,4 +1,4 @@
-import { isMetaAgentName, META_SANDBOX_SLUG } from '../../_vendor/kortix-shared.js';
+import { isMyKortixAgentName, MY_KORTIX_SANDBOX_SLUG } from '../../_vendor/kortix-shared.js';
 /**
  * Build the session-create payload from the composer's send options.
  *
@@ -15,8 +15,8 @@ import { isMetaAgentName, META_SANDBOX_SLUG } from '../../_vendor/kortix-shared.
  */
 export function buildNewSessionCreateInput(options = {}) {
     const input = {};
-    if (isMetaAgentName(options.agent)) {
-        input.sandbox_slug = META_SANDBOX_SLUG;
+    if (isMyKortixAgentName(options.agent)) {
+        input.sandbox_slug = MY_KORTIX_SANDBOX_SLUG;
     }
     else if (options.sandbox_slug) {
         input.sandbox_slug = options.sandbox_slug;

package/dist/workspace/layout/project-home.js

@@ -16,7 +16,7 @@ import { ProjectScope } from '../../internal/project-scope.js';
 import { useUiComponents, useUiRouter, useUiSearchParams } from '../../providers/ui-provider.js';
 import { getProjectDetail, listProjectAccessRequests, listProjectSandboxes, setProjectOnboardingComplete, } from '@kortix/sdk';
 import { contract, invalidateProject, qk } from '@kortix/sdk/react';
-import { META_SANDBOX_SLUG, isMetaAgentName } from '../../_vendor/kortix-shared.js';
+import { MY_KORTIX_SANDBOX_SLUG, isMyKortixAgentName } from '../../_vendor/kortix-shared.js';
 import { AccessRequestsBell } from '../home/access-requests-bell.js';
 import { notificationCenterOn } from '../../internal/hooks/use-notification-center.js';
 import { FirstChat } from '../home/first-chat.js';
@@ -70,7 +70,7 @@ function ProjectHomeView({ projectId, onSend, busy, beforeSend, onboarding: onbo
     const sandboxItems = sandboxesQuery.data?.items ?? [];
     const defaultSlug = sandboxesQuery.data?.default_slug ?? 'default';
     const activeSlug = selectedSlug ?? defaultSlug;
-    const metaSelected = isMetaAgentName(selectedAgent);
+    const metaSelected = isMyKortixAgentName(selectedAgent);
     useEffect(() => {
         if (metaSelected)
             setSelectedSlug(null);
@@ -144,7 +144,7 @@ function ProjectHomeView({ projectId, onSend, busy, beforeSend, onboarding: onbo
         const sent = Promise.resolve(send(text, files, {
             ...options,
             ...(metaSelected
-                ? { sandbox_slug: META_SANDBOX_SLUG }
+                ? { sandbox_slug: MY_KORTIX_SANDBOX_SLUG }
                 : selectedSlug
                     ? { sandbox_slug: selectedSlug }
                     : {}),

package/dist/workspace/memory/memory-labels.js

@@ -13,6 +13,11 @@ export const MEMORY_TYPE_ICON = {
     playbooks: BookOpenIcon,
     note: NoteIcon,
     other: FileTextIcon,
+    // My Kortix's own page types: no screen lists them, so they read as any other file.
+    user: FileTextIcon,
+    feedback: FileTextIcon,
+    project: FileTextIcon,
+    reference: FileTextIcon,
 };
 /**
  * A named person or agent wrote the change. A file with no front-matter author

package/dist/workspace/repository-disconnected.js

@@ -9,7 +9,7 @@ import { PlugsIcon } from '@phosphor-icons/react';
 import { useState } from 'react';
 import { useTranslations } from '../i18n/index.js';
 import { ReconnectGitHubButton, RepositoryDisconnectText, useRepositoryDisconnect, } from '../internal/components/repository-disconnected.js';
-import { customizePath } from '../lib/routes.js';
+import { adminPath } from '../lib/routes.js';
 import { Button } from '../primitives/button.js';
 import { UiLink as Link } from '../providers/ui-provider.js';
 import { SidebarAlert, SidebarAlertActions, SidebarAlertBody, SidebarAlertText, } from './sidebar/footer/sidebar-alert.js';
@@ -20,7 +20,7 @@ export function ProjectRepositoryDisconnectedAlertView({ projectId, disconnect,
     const [open, setOpen] = useState(defaultOpen);
     if (!disconnect)
         return null;
-    return (_jsxs(SidebarAlert, { tone: "warning", icon: _jsx(PlugsIcon, { className: "size-4" }), label: t('title'), open: open, onOpenChange: setOpen, children: [_jsx(SidebarAlertBody, { children: _jsx(SidebarAlertText, { children: _jsx(RepositoryDisconnectText, { disconnect: disconnect }) }) }), _jsxs(SidebarAlertActions, { children: [_jsx(ReconnectGitHubButton, { projectId: projectId, className: "w-full" }), _jsx(Button, { asChild: true, size: "sm", variant: "ghost", className: "w-full", children: _jsx(Link, { href: customizePath(projectId, 'settings?section=git'), children: t('openSettings') }) })] })] }));
+    return (_jsxs(SidebarAlert, { tone: "warning", icon: _jsx(PlugsIcon, { className: "size-4" }), label: t('title'), open: open, onOpenChange: setOpen, children: [_jsx(SidebarAlertBody, { children: _jsx(SidebarAlertText, { children: _jsx(RepositoryDisconnectText, { disconnect: disconnect }) }) }), _jsxs(SidebarAlertActions, { children: [_jsx(ReconnectGitHubButton, { projectId: projectId, className: "w-full" }), _jsx(Button, { asChild: true, size: "sm", variant: "ghost", className: "w-full", children: _jsx(Link, { href: adminPath(projectId, 'git'), children: t('openSettings') }) })] })] }));
 }
 /** Project-wide: the sidebar footer shows it on every project page. */
 export function ProjectRepositoryDisconnectedAlert({ projectId }) {

package/dist/workspace/sessions/board-dispatch.d.ts

@@ -0,0 +1,52 @@
+/**
+ * The agent board's dispatch input and keyboard, as pure functions.
+ *
+ * The input does two jobs, as Claude Code's agent view does. Filter tokens at
+ * the start (`s:working`, `a:reviewer`) narrow the board. Anything else is a
+ * prompt: Enter starts a new session with it. `@agent` as the first word, or a
+ * first word that names a project agent, runs that agent.
+ */
+import type { SessionBoardState } from '@kortix/sdk';
+/** Claude Code rejects a dispatch under 4 characters with "Too short". */
+export declare const DISPATCH_MIN_CHARS = 4;
+export interface BoardInput {
+    /** States from `s:` tokens; empty for none. */
+    states: SessionBoardState[];
+    /** Agents from `a:` tokens; empty for none. */
+    agents: string[];
+    /** The text after the filter tokens: the prompt to dispatch, or nothing. */
+    rest: string;
+}
+/** Split the leading `s:` / `a:` filter tokens off the input. An unknown state word is prompt text. */
+export declare function parseBoardInput(input: string): BoardInput;
+export type DispatchResult = {
+    kind: 'empty';
+} | {
+    kind: 'too_short';
+} | {
+    kind: 'dispatch';
+    prompt: string;
+    agent?: string;
+};
+/**
+ * What Enter does with the prompt part of the input. `agents` is the project's
+ * agent names; a match is case-insensitive and returns the agent's own spelling.
+ */
+export declare function parseDispatch(text: string, agents: readonly string[]): DispatchResult;
+export type BoardKeyAction = 'up' | 'down' | 'peek' | 'open' | 'stop' | 'close';
+/**
+ * The board's keys when the list has focus: ↑/↓ move, Space opens or closes the
+ * peek, Enter opens the session, x stops it, Escape closes the peek. A key typed
+ * into a field, or with a modifier, belongs to the field or the browser.
+ */
+export declare function boardKeyAction(event: Pick<KeyboardEvent, 'key' | 'altKey' | 'ctrlKey' | 'metaKey' | 'shiftKey'>, target: {
+    tagName?: string;
+    isContentEditable?: boolean;
+} | null): BoardKeyAction | null;
+/** The row the selection moves to; it stays inside the list. */
+export declare function moveBoardSelection(order: readonly string[], current: string | null, step: 1 | -1): string | null;
+/** `?view=board` is the board; any other view (or none) is the list. */
+export type SessionsLayout = 'list' | 'board';
+export declare const sessionsLayoutOf: (view: string | null | undefined) => SessionsLayout;
+/** The query string after the List/Board toggle: `view=board`, or no `view` for the list. */
+export declare function withSessionsLayout(search: string, layout: SessionsLayout): string;