@kortix/ui 0.14.6 → 0.14.8

package/dist/customize/connectors/detail/app-page.js

@@ -14,7 +14,7 @@ import { EntityAvatar } from '../../../primitives/entity-avatar.js';
 import { Skeleton } from '../../../primitives/skeleton.js';
 import { EmptyState } from '../../../primitives/empty-state.js';
 import { ErrorState } from '../../../primitives/error-state.js';
-import { appNameKey, catalogEntryConnectors, } from '../catalog/catalog-entry.js';
+import { appNameKey, catalogEntryConnectors, discoverEntryIcon, } from '../catalog/catalog-entry.js';
 import { listConnectCatalogPage, useConnectProviderStatus, } from '../catalog/use-catalog.js';
 import { connectorDisplayName, connectorSummary, } from '../connector-filter.js';
 import { appRefFromLocation, connectorHref, connectorsHref, } from '../connector-routes.js';
@@ -37,6 +37,22 @@ const SURFACE_ROW = 'flex items-center gap-3 px-4 py-3';
 /** One bordered group of rows, divided. Shared by both lists on the page. */
 const ROW_GROUP = 'bg-popover divide-y overflow-hidden rounded-md border';
 const surfaceLabel = (kind) => (kind === 'openapi' ? 'OpenAPI' : kind.toUpperCase());
+/**
+ * The app page's icon tile (`ConnectorAppIcon`, size `lg`): the resolved
+ * favicon, or the glyph tile when the record has none — and the same glyph
+ * tile when the URL fails to load, which used to render the browser's
+ * broken-image glyph beside the title. Mirrors the catalogue card's
+ * `ConnectorIcon`. The latch is per URL (`failedUrl`), so the late-arriving
+ * managed logo — which swaps the URL — gets a fresh try without a call-site
+ * key.
+ */
+function AppIcon({ icon, name }) {
+    const [failedUrl, setFailedUrl] = useState(null);
+    if (!icon || failedUrl === icon) {
+        return _jsx(EntityAvatar, { icon: GlobeIcon, size: "lg", label: name });
+    }
+    return (_jsx("span", { className: "flex size-9 shrink-0 items-center justify-center overflow-hidden rounded-sm", children: _jsx("img", { src: icon, alt: "", width: 36, height: 36, referrerPolicy: "no-referrer", className: "size-9 object-contain", onError: () => setFailedUrl(icon) }) }));
+}
 /**
  * `/projects/<id>/customize/connectors/<app>` — one catalogue app: what it is,
  * the one Install button, the connectors this project already has for it, and
@@ -148,9 +164,7 @@ export function AppPage({ projectId, appSegment }) {
         infoCells.push({ key: 'runs', label: t('infoRunsOver'), value: primary.kind });
     if (waysCount > 1)
         infoCells.push({ key: 'ways', label: t('waysToConnect'), value: String(waysCount) });
-    return (_jsxs(DetailPageShell, { children: [_jsx(Button, { asChild: true, variant: "text", size: "sm", className: "-ml-1 w-fit px-0 has-[>svg]:px-0", children: _jsxs(Link, { href: connectorsHref(projectId), children: [_jsx(CaretLeftIcon, { className: "size-3.5 shrink-0" }), tI18nComplete.raw('textc3d2e79ebdd0')] }) }), _jsxs("header", { className: "flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between", children: [_jsxs("div", { className: "flex min-w-0 items-center gap-3", children: [resolved.icon ? (
-                            // The connector page's icon tile (`ConnectorAppIcon`, size `lg`).
-                            _jsx("span", { className: "flex size-9 shrink-0 items-center justify-center overflow-hidden rounded-sm", children: _jsx("img", { src: resolved.icon, alt: "", width: 36, height: 36, referrerPolicy: "no-referrer", className: "size-9 object-contain" }) })) : (_jsx(EntityAvatar, { icon: GlobeIcon, size: "lg", label: resolved.name })), _jsx("h1", { className: "text-foreground min-w-0 text-xl font-medium text-balance wrap-break-word", children: resolved.name })] }), primary ? (_jsx("div", { className: "shrink-0", children: installMenu('header', primary.target, 'default', resolved.name) })) : null] }), infoCells.length > 0 || resolved.description ? (_jsxs("div", { className: "bg-popover divide-border divide-y overflow-hidden rounded-md border", children: [infoCells.length > 0 ? (_jsx("dl", { className: "flex flex-wrap gap-x-8 gap-y-3 px-4 py-3", children: infoCells.map((cell) => (_jsxs("div", { className: "min-w-0 space-y-0.5", children: [_jsxs("dt", { className: "text-muted-foreground flex h-4 items-center justify-between gap-2 text-xs", children: [_jsx("span", { children: cell.label }), cell.labelAddon] }), _jsx("dd", { className: "text-foreground truncate text-sm font-medium", children: cell.value })] }, cell.key))) })) : null, resolved.description ? (_jsxs("div", { className: "space-y-1.5 px-4 py-4", children: [_jsx("h2", { className: "text-muted-foreground text-xs", children: t('overview') }), _jsx("p", { className: "text-foreground text-sm text-pretty", children: resolved.description })] })) : null] })) : null, inProject.length > 0 ? (_jsxs("section", { className: "space-y-3", children: [_jsxs("div", { className: "space-y-1", children: [_jsx("h2", { className: "text-foreground text-sm font-medium", children: projectName ? t('installedIn', { project: projectName }) : t('installedHere') }), _jsx("p", { className: "text-muted-foreground text-xs", children: t('installedHint') })] }), _jsx("ul", { className: ROW_GROUP, children: inProject.map((connector) => {
+    return (_jsxs(DetailPageShell, { children: [_jsx(Button, { asChild: true, variant: "text", size: "sm", className: "-ml-1 w-fit px-0 has-[>svg]:px-0", children: _jsxs(Link, { href: connectorsHref(projectId), children: [_jsx(CaretLeftIcon, { className: "size-3.5 shrink-0" }), tI18nComplete.raw('textc3d2e79ebdd0')] }) }), _jsxs("header", { className: "flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between", children: [_jsxs("div", { className: "flex min-w-0 items-center gap-3", children: [_jsx(AppIcon, { icon: resolved.icon, name: resolved.name }), _jsx("h1", { className: "text-foreground min-w-0 text-xl font-medium text-balance wrap-break-word", children: resolved.name })] }), primary ? (_jsx("div", { className: "shrink-0", children: installMenu('header', primary.target, 'default', resolved.name) })) : null] }), infoCells.length > 0 || resolved.description ? (_jsxs("div", { className: "bg-popover divide-border divide-y overflow-hidden rounded-md border", children: [infoCells.length > 0 ? (_jsx("dl", { className: "flex flex-wrap gap-x-8 gap-y-3 px-4 py-3", children: infoCells.map((cell) => (_jsxs("div", { className: "min-w-0 space-y-0.5", children: [_jsxs("dt", { className: "text-muted-foreground flex h-4 items-center justify-between gap-2 text-xs", children: [_jsx("span", { children: cell.label }), cell.labelAddon] }), _jsx("dd", { className: "text-foreground truncate text-sm font-medium", children: cell.value })] }, cell.key))) })) : null, resolved.description ? (_jsxs("div", { className: "space-y-1.5 px-4 py-4", children: [_jsx("h2", { className: "text-muted-foreground text-xs", children: t('overview') }), _jsx("p", { className: "text-foreground text-sm text-pretty", children: resolved.description })] })) : null] })) : null, inProject.length > 0 ? (_jsxs("section", { className: "space-y-3", children: [_jsxs("div", { className: "space-y-1", children: [_jsx("h2", { className: "text-foreground text-sm font-medium", children: projectName ? t('installedIn', { project: projectName }) : t('installedHere') }), _jsx("p", { className: "text-muted-foreground text-xs", children: t('installedHint') })] }), _jsx("ul", { className: ROW_GROUP, children: inProject.map((connector) => {
                             const tone = connectorStatusTone(connector);
                             return (_jsx("li", { children: _jsxs(Link, { href: connectorHref(projectId, connector.slug, { app }), className: "hover:bg-muted/50 flex items-center gap-3 px-4 py-3 transition-colors", children: [_jsxs("span", { className: "min-w-0 flex-1", children: [_jsx("span", { className: "text-foreground block truncate text-sm font-medium", children: connectorDisplayName(connector) }), _jsx("span", { className: "text-muted-foreground block truncate text-xs", children: connectorSummary(connector, providerLabel(connector.provider)) })] }), _jsx("span", { className: "flex w-28 shrink-0 items-center", children: _jsx(ConnectorStatusBadge, { tone: tone }) }), _jsxs("span", { className: "text-muted-foreground flex w-16 shrink-0 items-center justify-end gap-1 text-xs", children: [t('open'), _jsx(CaretRightIcon, { "aria-hidden": true, className: "size-4" })] })] }) }, connector.slug));
                         }) })] })) : null, resolved.surfaces.length === 0 && resolved.references.length === 0 ? (_jsx(EmptyState, { icon: GlobeIcon, size: "sm", title: tI18nComplete.raw('text363579e1d66b'), description: tI18nComplete.raw('text4d286e47d580') })) : null, resolved.surfaces.length > 1 || resolved.references.length > 0 ? (_jsxs("section", { className: "space-y-3", children: [_jsx("h2", { className: "text-foreground text-sm font-medium", children: t('waysToConnect') }), _jsxs("ul", { className: ROW_GROUP, children: [resolved.surfaces.map((surface) => (_jsxs("li", { className: SURFACE_ROW, children: [_jsxs("span", { className: "flex min-w-0 flex-1 items-center gap-1.5", children: [_jsx("span", { className: "text-foreground truncate text-sm font-medium", children: surface.label }), surface.kind ? (_jsx(Badge, { variant: "muted", size: "xs", children: surface.kind })) : null] }), installMenu(surface.key, surface.target, 'secondary', surface.label)] }, surface.key))), resolved.references.map((reference) => (_jsxs("li", { className: SURFACE_ROW, children: [_jsxs("span", { className: "flex min-w-0 flex-1 items-center gap-1.5", children: [_jsx("span", { className: "text-foreground truncate text-sm font-medium", children: reference.label }), _jsx(Badge, { variant: "muted", size: "xs", children: reference.kind })] }), reference.href ? (_jsx(Button, { asChild: true, variant: "outline", size: "sm", className: "shrink-0", children: _jsxs("a", { href: reference.href, target: "_blank", rel: "noreferrer", children: [tI18nComplete.raw('text7af023c43013'), _jsx(ArrowSquareOutIcon, { className: "size-3.5 shrink-0" })] }) })) : (_jsx(Badge, { variant: "secondary", size: "sm", children: tI18nComplete.raw('textdf0453d185c4') }))] }, reference.key)))] })] })) : null, mcpApp ? (_jsx(AddMcpServerDialog, { projectId: projectId, app: mcpApp, open: true, onOpenChange: (open) => !open && setMcpApp(null), takenSlugs: connectors.map((connector) => connector.slug), onAdded: () => void connectorsQuery.refetch() }, mcpApp.url)) : null] }));
@@ -231,7 +245,7 @@ function useAppData(projectId, app) {
             name: managed?.name ?? detail.item.name,
             description: detail.item.description ?? managed?.description ?? null,
             // The managed logo is sharp where the catalogue's favicon is not.
-            icon: managed?.imgSrc ?? detail.item.icon,
+            icon: managed?.imgSrc ?? discoverEntryIcon(detail.item),
             surfaces: [
                 ...installableVariants(detail.variants).map((variant, index) => ({
                     key: `${variant.kind}:${variant.id}`,

package/dist/customize/connectors/detail/connector-modal.d.ts

@@ -1,4 +1,4 @@
-import { type AdminConnector } from '@kortix/sdk';
+import type { AdminConnector } from '@kortix/sdk';
 interface ConnectorModalProps {
     projectId: string;
     /** The connector to show, or `null` when it has not resolved yet. `open` is
@@ -6,10 +6,8 @@ interface ConnectorModalProps {
     connector: AdminConnector | null;
     canWrite: boolean;
     open: boolean;
-    /** Open on a selection whose record is still loading — `?c=<slug>` on a cold
-     *  page, which is how every OAuth 2.0 return arrives. Renders the shell so
-     *  the modal is present from the first frame instead of appearing on its own
-     *  once the list lands. */
+    /** Open on a selection whose record is still loading. Renders the shell so
+     *  the modal is present from the first frame. */
     isResolving?: boolean;
     onOpenChange: (open: boolean) => void;
     /** Refetch every authorization-derived query. Every mutation below calls it. */
@@ -18,15 +16,14 @@ interface ConnectorModalProps {
     onRemoved: () => void;
 }
 /**
- * Connector detail — header identity + tab nav + content pane.
+ * One connector over the agent editor, without leaving it (a navigation would
+ * drop the agent's unsaved draft). The body IS the connector page
+ * (`ConnectorDetailView`): the same header, status strip, notice, tabs and
+ * split credential sheet, so the modal and the page cannot drift. The modal
+ * adds only a close button and keeps its tab in state instead of the URL.
  *
- * Header: icon, name, description, primary connect action.
- * Left: Accounts / Tools / Triggers / Settings nav.
- * Right: the active tab.
- *
- * `ConnectorModalBody` is keyed on `connector.slug` so picking a different card
- * while the modal stays open resets the active tab without remounting
- * `Modal`/`ModalContent` (which would replay the open animation).
+ * The view is keyed on `connector.slug` so picking a different connector while
+ * the modal stays open resets the tab without replaying the open animation.
  */
 export declare function ConnectorModal({ projectId, connector, canWrite, open, isResolving, onOpenChange, onChanged, onRemoved, }: ConnectorModalProps): import("react").JSX.Element;
 export {};

package/dist/customize/connectors/detail/connector-modal.js

@@ -1,117 +1,34 @@
 'use client';
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useTranslations } from '../../../i18n/index.js';
-import { listPipedreamApps } from '@kortix/sdk';
-import { KeyIcon, PlusIcon } from '@phosphor-icons/react';
 import { VisuallyHidden } from '@radix-ui/react-visually-hidden';
-import { useQuery } from '@tanstack/react-query';
-import { useState } from 'react';
-import { Badge } from '../../../primitives/badge.js';
 import { Button } from '../../../primitives/button.js';
-import { InfoBanner } from '../../../primitives/info-banner.js';
-import Loading from '../../../primitives/loading.js';
-import { Modal, ModalBody, ModalClose, ModalContent, ModalHeader, ModalTitle, } from '../../../primitives/modal.js';
+import { Modal, ModalClose, ModalContent, ModalTitle } from '../../../primitives/modal.js';
 import { Skeleton } from '../../../primitives/skeleton.js';
-import { Tabs, TabsList, TabsTrigger } from '../../../primitives/tabs.js';
-import { ComputerConnectModal } from '../../../internal/tunnel/computer-connect.js';
-import { SetCredentialModal } from '../../sections/connectors-view.js';
-import { ConnectorAppIcon, ConnectorStatusBadge, } from '../connector-identity.js';
-import { cn } from '../../../internal/lib/utils.js';
-import { ButtonGroup } from '../../../primitives/button-group.js';
 import { Close } from '../../../icons/close.js';
-import { foldKey } from '../catalog/catalog-entry.js';
-import { ConnectorDetailTabs } from './connector-detail-tabs.js';
-import { CONNECTOR_TAB_LABEL_KEY, connectorTabs } from './connector-tabs.js';
-import { useConnectorEventTriggers } from './connector-triggers.js';
-import { useConnectorDetail } from './use-connector-detail.js';
+import { ConnectorDetailView } from './connector-page.js';
+/** The scroll column inside the modal: the page's column, tighter. */
+const MODAL_COLUMN = 'w-full space-y-6 px-6 py-6';
 /**
- * Connector detail — header identity + tab nav + content pane.
+ * One connector over the agent editor, without leaving it (a navigation would
+ * drop the agent's unsaved draft). The body IS the connector page
+ * (`ConnectorDetailView`): the same header, status strip, notice, tabs and
+ * split credential sheet, so the modal and the page cannot drift. The modal
+ * adds only a close button and keeps its tab in state instead of the URL.
  *
- * Header: icon, name, description, primary connect action.
- * Left: Accounts / Tools / Triggers / Settings nav.
- * Right: the active tab.
- *
- * `ConnectorModalBody` is keyed on `connector.slug` so picking a different card
- * while the modal stays open resets the active tab without remounting
- * `Modal`/`ModalContent` (which would replay the open animation).
+ * The view is keyed on `connector.slug` so picking a different connector while
+ * the modal stays open resets the tab without replaying the open animation.
  */
 export function ConnectorModal({ projectId, connector, canWrite, open, isResolving = false, onOpenChange, onChanged, onRemoved, }) {
-    return (_jsx(Modal, { open: open, onOpenChange: onOpenChange, children: _jsx(ModalContent, { className: "bg-popover h-[80vh] space-y-0 lg:max-w-6xl", "aria-describedby": undefined, showCloseButton: false, children: connector ? (_jsx(ConnectorModalBody, { projectId: projectId, connector: connector, canWrite: canWrite, onChanged: onChanged, onRemoved: onRemoved }, connector.slug)) : isResolving ? (_jsx(ConnectorModalSkeleton, {})) : null }) }));
+    const tI18nComplete = useTranslations('hardcodedUi.i18nComplete');
+    return (_jsx(Modal, { open: open, onOpenChange: onOpenChange, children: _jsx(ModalContent, { className: "bg-background flex max-h-[92vh] min-h-[85vh] flex-col space-y-0 overflow-hidden p-0 lg:max-w-5xl", "aria-describedby": undefined, showCloseButton: false, children: connector ? (_jsx("div", { className: "flex min-h-0 flex-1 flex-col", children: _jsx(ConnectorDetailView, { projectId: projectId, connector: connector, canWrite: canWrite, onChanged: onChanged, onRemoved: onChanged, onLeave: onRemoved, urlState: false, columnClassName: MODAL_COLUMN, wrapTitle: (title) => _jsx(ModalTitle, { asChild: true, children: title }), headerEnd: _jsx(ModalClose, { asChild: true, children: _jsx(Button, { variant: "secondary", size: "icon-sm", className: "shrink-0", "aria-label": tI18nComplete.raw('text7d9eb7acb13e'), children: _jsx(Close, { className: "text-foreground size-4 stroke-1" }) }) }) }, connector.slug) })) : isResolving ? (_jsx(ConnectorModalSkeleton, {})) : null }) }));
 }
 /**
- * The shell, while `?c=<slug>` is resolving against a list that has not
- * arrived. Shape-matched to `ConnectorModalBody` — same header height, same
- * left rail width — so the handover fills the placeholders in place instead of
- * relaying the modal out from under the pointer.
- *
- * The `ModalTitle` is real and visually hidden: Radix's Dialog needs an
- * accessible name at all times, and a screen reader announcing "Loading
- * connector" is the honest answer during this window.
+ * The shell while the selection resolves. Shape-matched to the view — icon and
+ * name, the strip, the tabs, two rows — so the handover fills it in place.
+ * The visually hidden title gives the dialog its accessible name meanwhile.
  */
 function ConnectorModalSkeleton() {
     const tI18nComplete = useTranslations('hardcodedUi.i18nComplete');
-    return (_jsxs(_Fragment, { children: [_jsxs(ModalHeader, { className: "flex-row items-start gap-2.5 border-b pb-4", children: [_jsx(VisuallyHidden, { children: _jsx(ModalTitle, { children: tI18nComplete.raw('text0c21b0363778') }) }), _jsx("span", { className: "p-1", children: _jsx(Skeleton, { className: "size-10 rounded-md" }) }), _jsxs("div", { className: "min-w-0 flex-1 space-y-2 pt-1", children: [_jsx(Skeleton, { className: "h-4 w-40 rounded-sm" }), _jsx(Skeleton, { className: "h-3 w-64 rounded-sm" })] })] }), _jsx(ModalBody, { className: "max-h-[70vh] overflow-hidden p-0", children: _jsxs("div", { className: "flex min-h-0 flex-col lg:h-[70vh] lg:flex-row", children: [_jsx("div", { className: "lg:border-border shrink-0 gap-1 p-3 lg:h-full lg:w-64 lg:border-r", children: _jsx("div", { className: "hidden space-y-1.5 lg:block", children: [0, 1, 2].map((i) => (_jsx(Skeleton, { className: "h-9 w-full rounded-md" }, i))) }) }), _jsxs("div", { className: "min-w-0 flex-1 space-y-3 px-5 py-4 lg:px-6", children: [_jsx(Skeleton, { className: "h-5 w-32 rounded-sm" }), _jsx(Skeleton, { className: "h-20 w-full rounded-md" }), _jsx(Skeleton, { className: "h-20 w-full rounded-md" })] })] }) })] }));
-}
-function ConnectorModalBody({ projectId, connector, canWrite, onChanged, onRemoved, }) {
-    const tI18nComplete = useTranslations('hardcodedUi.i18nComplete');
-    const { displayName, isManagedProvider, isChannel, isComputer, connectionsQuery, connected, canManageConnections, headerCta, connectPending, refreshAccounts, replaceSoleAccount, startPrivateSession, credentialTarget, setCredentialTarget, computerOpen, setComputerOpen, } = useConnectorDetail({ projectId, connector, canWrite, onChanged });
-    // Opens the account list's "Add account" dialog: name and who may use it.
-    const [addRequest, setAddRequest] = useState(0);
-    const tSharing = useTranslations('accessSharing');
-    const isPipedream = connector.provider === 'pipedream';
-    const eventTriggers = useConnectorEventTriggers(projectId, connector);
-    const tabs = connectorTabs(connector, { canWrite, hasEvents: eventTriggers.hasEvents });
-    const [selectedTab, setSelectedTab] = useState('accounts');
-    const tab = tabs.includes(selectedTab) ? selectedTab : (tabs[0] ?? 'accounts');
-    // Best-effort catalogue description. Never blocks first paint — the header
-    // renders without it, then fills in. That is the main open-latency fix:
-    // previously this query sat in the critical path of feeling "ready".
-    const appDescriptionQuery = useQuery({
-        queryKey: ['connector-app-description', projectId, connector.slug, displayName],
-        queryFn: async () => {
-            const result = await listPipedreamApps(projectId, displayName);
-            const match = result.apps.find((app) => foldKey(app.slug) === foldKey(connector.slug) ||
-                foldKey(app.name) === foldKey(displayName));
-            return match?.description ?? null;
-        },
-        enabled: isPipedream,
-        staleTime: 5 * 60_000,
-    });
-    const appDescription = isPipedream ? (appDescriptionQuery.data ?? null) : null;
-    const addAccountMenu = isComputer ? (_jsxs(Button, { size: "sm", className: "gap-1.5", onClick: () => setComputerOpen(true), children: [_jsx(PlusIcon, { className: "size-4 shrink-0", weight: "bold" }), tI18nComplete.raw('text1a2303ede074')] })) : (_jsxs(Button, { size: "sm", className: "gap-1.5", onClick: () => {
-            setSelectedTab('accounts');
-            setAddRequest((n) => n + 1);
-        }, disabled: connectPending, children: [_jsx(PlusIcon, { className: "size-4 shrink-0", weight: "bold" }), tSharing('addAccount')] }));
-    return (_jsxs(_Fragment, { children: [_jsxs(ModalHeader, { className: "flex-row items-start gap-2.5 border-b pb-4", children: [_jsx("span", { className: "p-1", children: _jsx(ConnectorAppIcon, { connector: connector, size: "lg" }) }), _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: [_jsx(ModalTitle, { className: "truncate text-lg font-semibold", children: displayName }), _jsx(ConnectorStatusBadge, { connector: connector })] }), appDescription ? (_jsx("p", { className: "text-muted-foreground text-sm text-pretty", children: appDescription })) : null] }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsxs(ButtonGroup, { className: "shrink-0", children: [headerCta === 'connect' ? addAccountMenu : null, headerCta === 'finish' ? (_jsxs(Button, { size: "sm", variant: "outline", className: "gap-1.5 active:scale-[0.96]", onClick: () => setSelectedTab('accounts'), children: [_jsx(KeyIcon, { className: "size-4 shrink-0" }), isManagedProvider
-                                                ? tI18nComplete.raw('text1a2303ede074')
-                                                : tI18nComplete.raw('text3d6627454174')] })) : null, headerCta === 'replace' ? (_jsxs(Button, { size: "sm", variant: "outline", className: "gap-1.5 active:scale-[0.96]", onClick: replaceSoleAccount, disabled: connectPending, children: [isManagedProvider ? (connectPending ? (_jsx(Loading, { className: "size-4 shrink-0" })) : null) : (_jsx(KeyIcon, { className: "size-4 shrink-0" })), isManagedProvider
-                                                ? tI18nComplete.raw('textbf8a9eab9e7e')
-                                                : tI18nComplete.raw('text54483ce856e0')] })) : null] }), _jsx(ModalClose, { asChild: true, children: _jsx(Button, { variant: "secondary", size: "icon", className: "size-8 shrink-0 rounded-md", "aria-label": tI18nComplete.raw('text7d9eb7acb13e'), children: _jsx(Close, { className: "text-foreground size-4 stroke-1" }) }) })] })] }), _jsxs(ModalBody, { className: "flex max-h-[70vh] flex-col overflow-hidden p-0", children: [!connected && !isChannel && !isComputer && connectionsQuery.isSuccess ? (_jsx(InfoBanner, { tone: "warning", title: tI18nComplete('text6506d9ea4341', { value0: displayName }), className: "shrink-0 rounded-none border-x-0 border-t-0", action: headerCta === 'connect' ? (addAccountMenu) : headerCta === 'finish' ? (_jsx(Button, { size: "sm", variant: "outline", onClick: () => setSelectedTab('accounts'), children: isManagedProvider
-                                ? tI18nComplete.raw('text1a2303ede074')
-                                : tI18nComplete.raw('text3d6627454174') })) : undefined, children: canWrite
-                            ? tI18nComplete.raw('text929505ef815a')
-                            : tI18nComplete.raw('text6a05ddf8cca1') })) : null, _jsxs(Tabs, { value: tab, onValueChange: (next) => setSelectedTab(next), className: "flex min-h-0 flex-1 flex-col gap-0 overflow-y-auto lg:flex-row lg:overflow-hidden", children: [_jsx(TabsList, { type: "underline", underlineSize: "md", size: "sm", "aria-label": `${displayName} sections`, className: cn('h-auto w-full shrink-0 justify-start gap-1 rounded-none px-2', 'overflow-x-auto', 'lg:border-border lg:h-full lg:w-64 lg:flex-col lg:items-stretch lg:gap-0.5', 'lg:overflow-x-visible lg:overflow-y-auto lg:border-r lg:border-b-0 lg:p-3', 'lg:**:data-[slot=tabs-trigger]:after:hidden', 'lg:**:data-[slot=tabs-trigger]:h-auto lg:**:data-[slot=tabs-trigger]:w-full', 'lg:**:data-[slot=tabs-trigger]:justify-between lg:**:data-[slot=tabs-trigger]:rounded-md', 'lg:**:data-[slot=tabs-trigger]:px-3 lg:**:data-[slot=tabs-trigger]:py-2', 'lg:**:data-[slot=tabs-trigger]:data-[state=active]:bg-primary/6', 'lg:**:data-[slot=tabs-trigger]:data-[state=active]:font-medium', 'lg:**:data-[slot=tabs-trigger]:data-[state=inactive]:hover:bg-primary/3'), children: tabs.map((value) => (_jsxs(TabsTrigger, { value: value, className: "w-fit flex-none gap-2 px-3 py-2.5 active:scale-[0.98] lg:w-full", children: [tI18nComplete.raw(CONNECTOR_TAB_LABEL_KEY[value]), value === 'triggers' ? (_jsx(Badge, { variant: "secondary", size: "sm", children: eventTriggers.rows.length })) : null] }, value))) }), _jsx("div", { className: "bg-popover min-w-0 flex-1 overflow-hidden overflow-y-auto px-5 py-4 lg:px-6", children: _jsx(ConnectorDetailTabs, { connectionsQuery: connectionsQuery, accounts: {
-                                        projectId,
-                                        connector,
-                                        displayName,
-                                        canWrite,
-                                        canManageConnections,
-                                        onChanged,
-                                        onStartSession: startPrivateSession,
-                                        addRequest,
-                                        onAddRequestHandled: () => setAddRequest(0),
-                                        onRemoved,
-                                    }, settings: {
-                                        projectId: projectId,
-                                        connector: connector,
-                                        displayName: displayName,
-                                        onChanged: onChanged,
-                                        onRemoved: onRemoved,
-                                    } }) })] })] }), _jsx(SetCredentialModal, { projectId: projectId, connector: credentialTarget ? connector : null, connectionId: credentialTarget?.connectionId ?? null, owner: credentialTarget?.owner ?? 'me', open: credentialTarget !== null, onOpenChange: (open) => {
-                    if (!open)
-                        setCredentialTarget(null);
-                }, onSaved: () => {
-                    setCredentialTarget(null);
-                    refreshAccounts();
-                } }), isComputer ? (_jsx(ComputerConnectModal, { projectId: projectId, open: computerOpen, onOpenChange: setComputerOpen, onConnected: refreshAccounts })) : null] }));
+    return (_jsxs("div", { className: MODAL_COLUMN, "aria-busy": true, children: [_jsx(VisuallyHidden, { children: _jsx(ModalTitle, { children: tI18nComplete.raw('text0c21b0363778') }) }), _jsxs("div", { className: "flex items-center gap-3", children: [_jsx(Skeleton, { className: "size-9 rounded-md" }), _jsx(Skeleton, { className: "h-6 w-48 rounded-sm" })] }), _jsx(Skeleton, { className: "h-16 w-full rounded-md" }), _jsx(Skeleton, { className: "h-9 w-64 rounded-md" }), _jsx(Skeleton, { className: "h-20 w-full rounded-md" })] }));
 }

package/dist/customize/connectors/detail/connector-notice.js

@@ -72,8 +72,12 @@ export function noticeButton(notice, target, managed) {
 }
 /** A failure line split for the log row: `MCP tools/list failed: HTTP 401` → `401` + `MCP tools/list failed`. */
 export function splitNoticeReason(reason) {
-    const match = /[:\s]*\bHTTP (\d{3})\b/.exec(reason);
+    const match = /\bHTTP (\d{3})\b/.exec(reason);
     if (!match)
         return { code: null, detail: reason };
-    return { code: match[1], detail: reason.replace(match[0], '').trim() };
+    // Drop the `: ` before the status with a loop: a `[:\s]*` regex prefix is quadratic on long whitespace runs.
+    let end = match.index;
+    while (end > 0 && /[:\s]/.test(reason[end - 1]))
+        end--;
+    return { code: match[1], detail: (reason.slice(0, end) + reason.slice(match.index + match[0].length)).trim() };
 }

package/dist/customize/connectors/detail/connector-page.d.ts

@@ -1,3 +1,5 @@
+import { type AdminConnector } from '@kortix/sdk';
+import { type ReactNode } from 'react';
 /** The column `CapabilityPageShell` gives the list page beside this one. */
 /**
  * `/projects/<id>/customize/connectors/<app>/<connector>` — one connector, as
@@ -12,6 +14,34 @@ export declare function ConnectorPage({ projectId, appSegment, connectorSlug, }:
     appSegment: string;
     connectorSlug: string;
 }): import("react").JSX.Element;
+export interface ConnectorDetailViewProps {
+    projectId: string;
+    connector: AdminConnector;
+    canWrite: boolean;
+    onChanged: () => void;
+    /** The connector was deleted: refresh everything but its own queries. */
+    onRemoved: () => void;
+    /** Above the header: the page's Back link. */
+    back?: ReactNode;
+    /** At the header's right edge, after its actions: the modal's close button. */
+    headerEnd?: ReactNode;
+    /** Wraps the `h1`: the modal passes `ModalTitle asChild` for its accessible name. */
+    wrapTitle?: (title: ReactNode) => ReactNode;
+    /** The view's own connector is gone: leave it (the page routes back, the
+     *  modal closes). */
+    onLeave: () => void;
+    /** The tab and the install hand-offs live in the URL on the page. The modal
+     *  keeps its tab in state, so it never rewrites its host page's URL. */
+    urlState?: boolean;
+    /** The scroll column's classes; the modal uses tighter padding. */
+    columnClassName?: string;
+}
+/**
+ * One connector — the strip, its notice, and the Accounts / Tools / Settings
+ * tabs. The page (`/connectors/<app>/<connector>`) and the agent editor's
+ * connector modal render this same view, so the two cannot drift.
+ */
+export declare function ConnectorDetailView({ projectId, connector, canWrite, onChanged, onRemoved, back, headerEnd, wrapTitle, onLeave, urlState, columnClassName, }: ConnectorDetailViewProps): import("react").JSX.Element;
 /**
  * The strip's bottom row when something is wrong: a one-line title, the raw
  * failure as a quiet log line, and the buttons that fix it. No icon tile; the

package/dist/customize/connectors/detail/connector-page.js

@@ -99,7 +99,17 @@ export function ConnectorPage({ projectId, appSegment, connectorSlug, }) {
     }
     return (_jsx(ConnectorPageBody, { projectId: projectId, connector: connector, canWrite: canWrite, backHref: backHref, onChanged: invalidate, onRemoved: invalidateAfterRemove }, connector.slug));
 }
-function ConnectorPageBody({ projectId, connector, canWrite, backHref, onChanged, onRemoved, }) {
+function ConnectorPageBody({ backHref, ...props }) {
+    const tI18nComplete = useTranslations('hardcodedUi.i18nComplete');
+    const router = useUiRouter();
+    return (_jsx(ConnectorDetailView, { ...props, back: _jsx(Button, { asChild: true, variant: "text", size: "sm", className: "-ml-1 w-fit px-0 has-[>svg]:px-0", children: _jsxs(Link, { href: backHref, children: [_jsx(CaretLeftIcon, { className: "size-3.5 shrink-0" }), tI18nComplete.raw('textc3d2e79ebdd0')] }) }), onLeave: () => router.push(connectorsHref(props.projectId, 'connected')) }));
+}
+/**
+ * One connector — the strip, its notice, and the Accounts / Tools / Settings
+ * tabs. The page (`/connectors/<app>/<connector>`) and the agent editor's
+ * connector modal render this same view, so the two cannot drift.
+ */
+export function ConnectorDetailView({ projectId, connector, canWrite, onChanged, onRemoved, back, headerEnd, wrapTitle = (title) => title, onLeave, urlState = true, columnClassName = PAGE_COLUMN, }) {
     const t = useTranslations('connectorPages');
     const tI18nComplete = useTranslations('hardcodedUi.i18nComplete');
     const tSharing = useTranslations('accessSharing');
@@ -116,19 +126,22 @@ function ConnectorPageBody({ projectId, connector, canWrite, backHref, onChanged
     // The tab is in the URL, so a link opens the right one.
     const eventTriggers = useConnectorEventTriggers(projectId, connector);
     const tabs = connectorTabs(connector, { canWrite, hasEvents: eventTriggers.hasEvents });
-    const requestedTab = search?.get('tab');
+    const [localTab, setLocalTab] = useState('accounts');
+    const requestedTab = urlState ? search?.get('tab') : localTab;
     const tab = tabs.find((value) => value === requestedTab) ?? tabs[0] ?? 'accounts';
-    const setTab = (next) => replaceParams((params) => {
-        if (next === 'accounts')
-            params.delete('tab');
-        else
-            params.set('tab', next);
-    });
+    const setTab = (next) => urlState
+        ? replaceParams((params) => {
+            if (next === 'accounts')
+                params.delete('tab');
+            else
+                params.set('tab', next);
+        })
+        : setLocalTab(next);
     // The install hand-off: `?connect=<connection id>` opens credential entry
     // for that account once, then leaves the URL. The id is untrusted, so
     // `connectHandoff` opens only one of THIS connector's accounts and takes the
     // owner from the row; the URL's `owner` param is stripped, never read.
-    const connectId = search?.get('connect') ?? null;
+    const connectId = urlState ? (search?.get('connect') ?? null) : null;
     // Same cache entry as the probe in `useConnectorDetail`; read here for its
     // loading state, so a shared account is not refused before the answer lands.
     const accountId = useProjectAccountId(projectId);
@@ -195,7 +208,7 @@ function ConnectorPageBody({ projectId, connector, canWrite, backHref, onChanged
     };
     // Right after Install (`?add=1`): ask for the first account once, then
     // leave the URL. Adjusted during render, not in an effect.
-    const addParam = search?.get('add') === '1';
+    const addParam = urlState && search?.get('add') === '1';
     const [addHandled, setAddHandled] = useState(false);
     if (addParam && !addHandled && canWrite && !isChannel) {
         setAddHandled(true);
@@ -301,7 +314,7 @@ function ConnectorPageBody({ projectId, connector, canWrite, backHref, onChanged
             setCredentialTarget(null);
     };
     const addAccountControl = isComputer ? (_jsxs(Button, { size: "sm", className: "gap-1.5", onClick: () => setComputerOpen(true), children: [_jsx(PlusIcon, { className: "size-4 shrink-0" }), tI18nComplete.raw('text1a2303ede074')] })) : (_jsxs(Button, { size: "sm", className: "gap-1.5", onClick: requestAdd, disabled: connectPending, children: [_jsx(PlusIcon, { className: "size-4 shrink-0" }), tSharing('addAccount')] }));
-    return (_jsxs(SplitSheet, { open: sheetOpen, onOpenChange: closeCredential, size: "lg", className: "flex-1", children: [_jsx(SplitSheetMain, { children: _jsxs("div", { className: PAGE_COLUMN, children: [_jsx(Button, { asChild: true, variant: "text", size: "sm", className: "-ml-1 w-fit px-0 has-[>svg]:px-0", children: _jsxs(Link, { href: backHref, children: [_jsx(CaretLeftIcon, { className: "size-3.5 shrink-0" }), tI18nComplete.raw('textc3d2e79ebdd0')] }) }), _jsxs("header", { className: "flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between", children: [_jsxs("div", { className: "flex min-w-0 items-center gap-3", children: [_jsx(ConnectorAppIcon, { connector: connector, size: "lg" }), _jsx("h1", { ref: headingRef, tabIndex: -1, className: "text-foreground min-w-0 text-xl font-medium text-balance wrap-break-word", children: displayName })] }), _jsxs("div", { className: "flex shrink-0 flex-wrap items-center gap-2", children: [isComputer && headerCta === 'connect' ? addAccountControl : null, connected ? (_jsx(Button, { size: "sm", variant: "outline", onClick: () => startPrivateSession(), children: t('newSession') })) : null] })] }), _jsxs("div", { className: "bg-popover divide-border divide-y overflow-hidden rounded-md border", children: [_jsx("dl", { className: "divide-border flex divide-x", children: stripCells.map((cell) => (_jsxs("div", { className: "min-w-0 flex-1 space-y-0.5 px-4 py-2.5", children: [_jsxs("dt", { className: "text-muted-foreground flex h-4 items-center justify-between gap-2 text-xs", children: [_jsx("span", { className: "truncate", children: cell.label }), cell.labelAddon] }), _jsx("dd", { className: "text-foreground flex min-w-0 items-center gap-1.5 truncate text-sm font-medium", children: cell.value })] }, cell.key))) }), notice.kind !== 'none' ? (_jsxs(ConnectorNoticeRow, { title: t(NOTICE_TITLE[notice.kind], { name: displayName }), detail: notice.kind === 'error' && notice.reason ? (_jsx(NoticeLogLine, { reason: notice.reason })) : (_jsx("p", { className: "text-muted-foreground text-xs text-pretty", children: t(notice.kind === 'needs_credential' && isManagedProvider
+    return (_jsxs(SplitSheet, { open: sheetOpen, onOpenChange: closeCredential, size: "lg", className: "flex-1", children: [_jsx(SplitSheetMain, { children: _jsxs("div", { className: columnClassName, children: [back, _jsxs("header", { className: "flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between", children: [_jsxs("div", { className: "flex min-w-0 items-center gap-3", children: [_jsx(ConnectorAppIcon, { connector: connector, size: "lg" }), wrapTitle(_jsx("h1", { ref: headingRef, tabIndex: -1, className: "text-foreground min-w-0 text-xl font-medium text-balance wrap-break-word", children: displayName }))] }), _jsxs("div", { className: "flex shrink-0 flex-wrap items-center gap-2", children: [isComputer && headerCta === 'connect' ? addAccountControl : null, connected ? (_jsx(Button, { size: "sm", variant: "outline", onClick: () => startPrivateSession(), children: t('newSession') })) : null, headerEnd] })] }), _jsxs("div", { className: "bg-popover divide-border divide-y overflow-hidden rounded-md border", children: [_jsx("dl", { className: "divide-border flex divide-x", children: stripCells.map((cell) => (_jsxs("div", { className: "min-w-0 flex-1 space-y-0.5 px-4 py-2.5", children: [_jsxs("dt", { className: "text-muted-foreground flex h-4 items-center justify-between gap-2 text-xs", children: [_jsx("span", { className: "truncate", children: cell.label }), cell.labelAddon] }), _jsx("dd", { className: "text-foreground flex min-w-0 items-center gap-1.5 truncate text-sm font-medium", children: cell.value })] }, cell.key))) }), notice.kind !== 'none' ? (_jsxs(ConnectorNoticeRow, { title: t(NOTICE_TITLE[notice.kind], { name: displayName }), detail: notice.kind === 'error' && notice.reason ? (_jsx(NoticeLogLine, { reason: notice.reason })) : (_jsx("p", { className: "text-muted-foreground text-xs text-pretty", children: t(notice.kind === 'needs_credential' && isManagedProvider
                                             ? 'noticeReconnectBody'
                                             : NOTICE_BODY[notice.kind], { name: displayName }) })), children: [notice.kind === 'error' && canWrite ? (_jsxs(Button, { size: "sm", variant: "ghost", className: "gap-1.5", onClick: () => retry.mutate(), disabled: retry.isPending, children: [retry.isPending ? _jsx(Loading, { className: "size-4 shrink-0" }) : null, tI18nComplete.raw('text942087cc2d41')] })) : null, fix?.kind === 'add_account' ? (addAccountControl) : fix?.kind === 'sign_in' ? (_jsxs(Button, { size: "sm", className: "gap-1.5", onClick: runFix, disabled: signIn.isPending, children: [signIn.isPending ? _jsx(SessionDotMatrix, { size: 14, className: "shrink-0" }) : null, t('noticeSignInAction')] })) : fix ? (
                                         // Fix it here: credential entry for a direct account, the
@@ -321,7 +334,7 @@ function ConnectorPageBody({ projectId, connector, canWrite, backHref, onChanged
                                         onStartSession: startPrivateSession,
                                         addRequest,
                                         onAddRequestHandled: () => setAddRequest(0),
-                                        onRemoved: () => router.push(connectorsHref(projectId, 'connected')),
+                                        onRemoved: onLeave,
                                         onSetCredential: setCredentialTarget,
                                         onConnect: needsSignIn ? connectAccount : undefined,
                                         showAccountInfo: true,
@@ -331,7 +344,7 @@ function ConnectorPageBody({ projectId, connector, canWrite, backHref, onChanged
                                         displayName: displayName,
                                         onChanged: onChanged,
                                         onRemoved: () => {
-                                            router.push(connectorsHref(projectId, 'connected'));
+                                            onLeave();
                                             onRemoved();
                                         },
                                     } })] })] }) }), credentialTarget ? (

package/dist/customize/migrate-to-v2/migration-prompt.d.ts

@@ -24,5 +24,6 @@
  * Kept as a plain exported constant (not inlined at the call site) so it's
  * independently testable and diffable — this is the load-bearing artifact of
  * the feature, not the wiring around it.
+ * @deprecated Moves a v1 project to the OpenCode-era v2 layout (harnesses/opencode). OpenCode is sunset (2026-10-23); migrate with `kortix migrate` to kortix_version 3.
  */
 export declare const MIGRATE_TO_V2_PROMPT = "Migrate this project's manifest from kortix_version 1 (kortix.toml) to kortix_version 2 (kortix.yaml), and move its files to the root layout. Read everything first, then make the change, then land it as a change request \u2014 do not merge it yourself.\n\n## 1. Read before you write\n\n- The current manifest: `kortix.toml` (or `kortix.yaml` if this project already partially moved \u2014 check `kortix_version` at the top either way).\n- Any `[[agents]]` entries in the v1 manifest \u2014 these carry `connectors`, `kortix_permissions` (older manifests spell it `kortix_cli`), and `env` grants per agent name. An agent name with NO `[[agents]]` entry at all is today unrestricted (v1's back-compat default is \"all\" when a grant key is omitted).\n- `.kortix/opencode/opencode.jsonc` \u2014 if it sets a top-level `default_agent`, that is the project's existing default; use it. If it doesn't, pick the agent whose `.kortix/opencode/agents/*.md` frontmatter has `mode: primary` and reads as the general/primary one (usually the first-created or the one with the broadest permissions). Record which you picked and why in the change request description \u2014 a human reviews this before it merges, so a defensible choice beats blocking on it.\n- **You do NOT need to read each agent's `.md` frontmatter to migrate it.** v1's frontmatter (mode/model/temperature/permission/prompt/\u2026) is ALREADY valid v2 OpenCode behavior \u2014 its content stays unchanged. Only the file moves (section 5). The manifest conversion is governance-only.\n- The current layout: v1 projects keep agents in `.kortix/opencode/agents/`, skills in `.kortix/opencode/skills/`, the other OpenCode files in `.kortix/opencode/`, and memory in `.kortix/memory/`. A v1 manifest that sets `opencode.config_dir` uses that directory instead of `.kortix/opencode`.\n\n## 2. Bring the platform baseline up to date first\n\nA project still on a v1 manifest is usually also running stale platform skills. Refresh them BEFORE touching the manifest so the migration lands on a current baseline:\n\n1. `kortix marketplace updates` \u2014 a hash-diff report of every marketplace-tracked item (the kortix-managed skills like `kortix-system`/`kortix-memory`, plus any marketplace skills the user installed).\n2. If updates are listed, apply them: `kortix marketplace update --all`. **This commits directly to `main` through the platform's own hash-safe update path \u2014 it is intentionally NOT part of your change request.** It only rewrites files whose installed hash no longer matches the catalog, so untouched user files are never clobbered.\n3. Sync your session branch on top of the refreshed main: `git fetch origin && git rebase origin/main`.\n4. Items reported as `orphaned` (no longer in the catalog) are not updatable \u2014 leave them alone and mention them in the change request description.\n5. Marketplace-tracked items are the ONLY thing you refresh this way. Do NOT hand-update anything else \"to latest\": agents' `.md` files, the memory directory, `opencode.jsonc`, the continuation plugin, `tools/*.ts`, and custom skills are user- or platform-owned files with no update tracking \u2014 leave every one of them untouched. Section 5 moves some of them and rewrites their old paths; that is the only change they get.\n\n## 3. The authoritative schema is one command away\n\nWhenever you are unsure about a field name, an allowed value, or whether a key survived into v2, consult the canonical JSON Schema instead of guessing:\n\n- `kortix schema --version 2` \u2014 prints the exact v2 schema the validator and the CR-merge gate enforce. Works offline inside your sandbox. `kortix schema --version 1` prints the v1 shape you are migrating FROM.\n- The same documents are published at `https://kortix.com/schema/kortix.v2.schema.json` (and `kortix.v1.schema.json`, plus the combined `kortix.schema.json` that dispatches on `kortix_version`).\n\nThe schema, this prompt, and `kortix validate` all enforce the same rules \u2014 if they ever appear to disagree, trust `kortix validate`'s output and say so in the change request description.\n\n## 4. The v2 shape you're producing\n\nv2's `agents:` map is GOVERNANCE ONLY \u2014 connectors/secrets/skills/kortix_permissions/workspace/enabled. OpenCode behavior (mode/model/temperature/permission/the prompt itself) is NOT part of the manifest at all; it lives entirely in each agent's own `.md` frontmatter + body, exactly as it does today. After section 5 that file is `agents/<name>.md`, and the agent's `file:` key names it.\n\n```yaml\nkortix_version: 2\ndefault_agent: <name>          # REQUIRED \u2014 must resolve to a declared, enabled agent below\n\nagents:\n  <name>:\n    file: agents/<name>.md       # the agent's .md, repo-relative (section 5 moves it there)\n    enabled: true                # optional; false = can't start sessions (default true)\n    connectors: all               # connector slugs | \"all\" | \"none\"\n    secrets: all                  # renamed from v1's \"env\" \u2014 names | \"all\" | \"none\"\n    kortix_permissions: all        # project.* permission names | \"all\" | \"none\"\n    skills: all                    # names of skills/* this agent may invoke | \"all\" | \"none\"\n    workspace:\n      project_repository: false    # optional \u2014 true (default) | false\n```\n\nThat's the WHOLE block. No `description`, no `model`, no `opencode:` sub-object, no `mode`/`temperature`/`permission`/`prompt` \u2014 every one of those is a hard schema error if authored here. They already live in the `.md` and are staying there.\n\nRules that the schema enforces (get these right or `kortix validate` fails):\n\n- `agents` is a MAP (`name: {...}`), not the v1 `[[agents]]` array of tables.\n- `default_agent` is required at the top level and must name a declared, enabled (`enabled` not `false`) agent.\n- Any behavioral field (`description`, `model`, `mode`, `temperature`, `top_p`, `steps`, `variant`, `color`, `hidden`, `permission`, `prompt`, or a nested `opencode:` block) authored on the manifest agent block is a hard error, pointing you at the agent's own `.md` frontmatter instead \u2014 because that's where it already lives, untouched.\n- `disable` is a hard error too \u2014 it's the manifest-governance `enabled` (inverted): write `enabled: false` instead. (This is unrelated to a NATIVE `disable` key that might already be hand-authored in an agent's own `.md` frontmatter \u2014 leave that alone; it's a different, runtime-level concept.)\n- `env` is a hard error in v2 \u2014 it is renamed `secrets`. **v2 defaults every omitted grant (`connectors`/`secrets`/`kortix_permissions`/`skills`) to `\"none\"` (deny-by-default), unlike v1 which defaulted an omitted grant to `\"all\"`.** To avoid silently narrowing an agent's access during migration, write the EXPLICIT value that reproduces today's behavior for every agent \u2014 if a v1 agent had no `[[agents]]` entry, or its `env`/`connectors`/`kortix_cli` (or `kortix_permissions`) were omitted or set to `all`, write `secrets: all`, `connectors: all`, `kortix_permissions: all` explicitly in its v2 block. Only narrow a grant if the v1 manifest already narrowed it (an explicit list, or `none`) \u2014 carry that exact list over. `skills` has no v1 equivalent; default new agents to `all` unless you have a specific reason to narrow.\n- `channels` is removed entirely in v2 \u2014 delete any `[[channels]]` block. Channel\u2194agent routing now lives in the dashboard (Customize \u2192 Channels), not in git. Do not try to replicate it in the manifest.\n- Every other top-level section (`project`, `env` for required/optional documentation vars \u2014 NOT the per-agent grant, `sandbox`, `triggers`, `connectors`, `apps`) keeps its v1 shape unchanged \u2014 translated to YAML, not restructured. `opencode.config_dir` is the one exception: section 5 sets it. If `triggers[].agent` names an agent, make sure that name still exists in the new `agents` map (rename references if you renamed an agent).\n- If an agent has no `.md` today (a bare `[[agents]]` entry with no matching OpenCode agent file), still declare it in `agents:` with its governance grants carried over \u2014 don't drop it. Omit its `file:` key. It has no behavior until someone adds `agents/<name>.md`.\n\n## 5. Move to the root layout\n\nv2 projects keep harness-neutral files at the repo root. Move this project in the same change request. Use `git mv`, so git records every move as a rename and keeps each file's history.\n\n| From | To |\n| --- | --- |\n| `.kortix/opencode/agents/<name>.md` | `agents/<name>.md` |\n| `.kortix/opencode/skills/<name>/` | `skills/<name>/` |\n| `.kortix/memory/` | `memory/` |\n| the rest of `.kortix/opencode/` (`opencode.jsonc`, `package.json`, `bun.lock`, `plugins/`, `tools/`, `commands/`) | `harnesses/opencode/` |\n\nIf the v1 manifest sets `opencode.config_dir`, that directory is the source instead of `.kortix/opencode`. Skip a row when its source does not exist.\n\n```\nmkdir -p harnesses\ngit mv .kortix/opencode/agents agents\ngit mv .kortix/opencode/skills skills\ngit mv .kortix/memory memory\ngit mv .kortix/opencode harnesses/opencode\n```\n\n`git mv <dir> <target>` moves `<dir>` INTO `<target>` when `<target>` already exists. Check each target with `ls` first. When it exists, move the entries one at a time (`git mv .kortix/opencode/skills/<name> skills/<name>`).\n\nThen:\n\n1. Set the OpenCode config dir in `kortix.yaml`: `opencode:` with `config_dir: harnesses/opencode`.\n2. Give every agent whose `.md` you moved a `file:` key: `file: agents/<name>.md`.\n3. Update `.gitignore`: rewrite each `.kortix/opencode/<path>` entry as `harnesses/opencode/<path>`, and each `.kortix/memory/<path>` entry as `memory/<path>`. Keep `.kortix/state/` \u2014 runtime state stays there.\n4. Find every remaining reference to an old path: `git grep -n -e '.kortix/opencode' -e '.kortix/memory'`. Replace each one with its new path. For example, `tools/memory.ts` hard-codes `.kortix/memory`, and agent prompts often name it. Change only the path. Leave `.kortix/state/` and `.kortix/link.json` references alone.\n\nEdge cases:\n\n- A root `agents/`, `memory/`, or `harnesses/` directory that already holds files unrelated to Kortix: do not merge into it. Skip this whole section, steps 1\u20134 included, keep the legacy layout (Kortix still reads it), and say why in the change request description.\n- A skill that already exists in `skills/<name>/` (the marketplace update in section 2 can install it there): keep the root copy and remove the legacy copy with `git rm -r`.\n\n## 6. Legacy keys v2 refuses \u2014 drop these while you convert\n\nv1 tolerates several retired keys with a deprecation warning; v2 makes every one of them a hard error. Remove them as part of the conversion and note each removal in the change request description:\n\n- **Retired `kortix_permissions` actions** \u2014 `project.session.exec`, `project.gateway.routing.edit`, `project.schedule.read`, `project.schedule.write`, `project.webhook.read`, `project.webhook.write`, `channel.read`, `channel.connect`, `channel.send`, `channel.disconnect`. These were removed from the enforcement catalog and have been no-ops for a while \u2014 granting or omitting them never had any effect, so deleting them from a grant list changes nothing. Do NOT substitute a broader grant (e.g. `all`) to \"cover\" a deleted action.\n- **`credential = \"per_user\"` on a `[[connectors]]` entry** \u2014 the per-user credential mode was removed; every connector is `\"shared\"` now. Delete the `credential` key (or write `shared` explicitly if the entry already spelled it out).\n- **`agent_scope` on a `[[connectors]]` entry** \u2014 retired; the runtime no longer reads it. Per-agent connector access is expressed from the OTHER side now: each agent's `connectors:` grant in the `agents:` map. If a v1 connector had `agent_scope = [\"a\", \"b\"]`, make sure agents outside that list don't get that connector slug in their `connectors` grant (use an explicit slug list instead of `all` for the agents that should keep access), then delete the key.\n- **Legacy singular `[sandbox]` image keys** (`image`, `dockerfile`, `cpu`, `memory`, `disk`, \u2026) \u2014 already an error in v1's validator; if `kortix validate` flags them, move the image definition under `[[sandbox.templates]]` \u2192 `sandbox.templates:` with a named slug.\n\n## 7. Worked example\n\nA representative v1 `kortix.toml`:\n\n```toml\nkortix_version = 1\n\n[project]\nname = \"acme-ops\"\n\n[env]\nrequired = [\"DATABASE_URL\"]\n\n[[agents]]\nname = \"dev\"\nconnectors = [\"github\", \"linear\"]\nenv = \"all\"\nkortix_cli = [\"project.file.read\", \"project.file.write\", \"project.session.exec\"]\n\n[[agents]]\nname = \"support\"\n# no grants declared \u2014 v1 treats omitted grants as \"all\"\n\n[[channels]]\ntype = \"slack\"\nagent = \"support\"\n\n[[triggers]]\nslug = \"weekly-summary\"\ntype = \"cron\"\ncron = \"0 9 * * 1\"\nagent = \"dev\"\nprompt = \"Post the weekly summary.\"\n\n[[connectors]]\nslug = \"github\"\nprovider = \"github\"\ncredential = \"per_user\"\nagent_scope = [\"dev\"]\n```\n\nbecomes this v2 `kortix.yaml`:\n\n```yaml\nkortix_version: 2\ndefault_agent: dev\n\nproject:\n  name: acme-ops\n\nenv:\n  required:\n    - DATABASE_URL\n\nopencode:\n  config_dir: harnesses/opencode\n\nagents:\n  dev:\n    file: agents/dev.md\n    connectors:\n      - github\n      - linear\n    secrets: all          # v1 \"env = all\", renamed\n    kortix_permissions:   # renamed from v1's kortix_cli; project.session.exec dropped \u2014 retired no-op action\n      - project.file.read\n      - project.file.write\n    skills: all\n  support:\n    file: agents/support.md\n    # v1 had no grants (implicit all) \u2014 but the github connector was\n    # agent_scoped to dev only, so \"all\" would WIDEN support's access.\n    # An explicit list preserves today's effective behavior instead.\n    connectors: none\n    secrets: all\n    kortix_permissions: all\n    skills: all\n\ntriggers:\n  - slug: weekly-summary\n    type: cron\n    cron: \"0 9 * * 1\"\n    agent: dev\n    prompt: Post the weekly summary.\n\nconnectors:\n  - slug: github\n    provider: github\n    # credential/agent_scope removed \u2014 connectors are shared; per-agent\n    # access now lives in the agents map above.\n```\n\nNote what happened: the `[[channels]]` block is gone (dashboard-owned now), each agent names its moved `.md` with `file:`, `opencode.config_dir` points at `harnesses/opencode`, `env` became `secrets`, the retired CLI action and connector keys were dropped, every omitted-in-v1 grant was written out explicitly, and the old `agent_scope` was honored by adjusting the AGENTS' `connectors` grants rather than copied over. Your project will differ \u2014 apply the rules, not this output verbatim.\n\n## 8. Leave every agent's `.md` alone\n\nBeyond the move and the path updates in section 5, do not edit or reformat any agent's `.md` as part of this migration. Its frontmatter (mode/model/permission/temperature/\u2026) and body (the system prompt) are ALREADY the agent's v2 behavior \u2014 nothing else about them needs to change. This is what keeps the manifest conversion governance-only and comparatively small: you're translating one array-of-tables into one map of governance grants, full stop.\n\n## 9. Write the file, remove the old one\n\n- Write the fully assembled manifest to `kortix.yaml` at the repo root (same directory as the old `kortix.toml`).\n- If the project has more than ~10 triggers, or long multi-line prompts, keep `kortix.yaml` readable: add `imports: [triggers/]` to the root and write the triggers into YAML files under `triggers/` (one file per trigger or per group; each file is a `triggers:` list). Every other key stays in `kortix.yaml`. Slugs must stay unique across all files.\n- Carry over meaningful TOML comments as YAML comments next to the same keys \u2014 hand-written context in a manifest is documentation someone chose to leave; don't strip it.\n- Delete the old `kortix.toml` in the same commit \u2014 don't leave both files (the platform always prefers `kortix.yaml` when both exist, but a stale v1 file next to it is confusing for the next person who edits by hand).\n- You do not need to touch any project setting outside git \u2014 the platform resolves `kortix.yaml` automatically once it exists, regardless of the configured manifest filename.\n\n## 10. Validate before you're done\n\nRun `kortix validate` (it auto-detects `kortix.yaml`). Fix every error it reports \u2014 do not open the change request with a manifest that fails validation. Warnings are fine to leave if they're informational, but read them. If an error surprises you, cross-check the field against `kortix schema --version 2`.\n\n## 11. Land it as a change request \u2014 never merge\n\nFirst, re-sync: `git fetch origin` and check whether `origin/main` advanced while you worked (`git log HEAD..origin/main --oneline`) \u2014 on active projects it will (connectors added from the dashboard, other sessions merging). If it moved, rebase; if the rebase conflicts on `kortix.toml` (main changed the manifest you deleted), don't fight it \u2014 `git rebase --abort`, `git reset --hard origin/main`, and redo the conversion against the CURRENT manifest, then continue. Never revert main's changes to win a conflict.\n\nThen commit, **push the branch**, and open the change request. A commit that is never pushed leaves the CR empty (\"No changes detected\") and un-appliable \u2014 the platform refuses such a CR outright (`422 CR_HEAD_NOT_AHEAD`):\n\n```\ngit add -A && git commit -m \"Migrate to kortix_version 2 (kortix.yaml) and the root layout\"\ngit push origin HEAD\nkortix cr open --head <your-branch> --title \"Migrate to kortix_version 2 (kortix.yaml) and the root layout\" --description \"<what you converted, which files you moved, which agent you picked as default_agent and why, every legacy key you removed, and any grant you had to leave narrowed>\"\n```\n\nIf the push is rejected because the remote session branch moved, `git fetch origin` then `git push --force-with-lease origin HEAD` \u2014 your own session branch only, never any other branch.\n\nThen verify the CR actually carries your diff: run `kortix cr diff <number>` \u2014 if it reports no changes, your push didn't land; push again and re-check (the CR updates automatically, do not open a second one).\n\nDo **not** run `kortix cr merge`. This is a human-reviewed change like any other \u2014 stop once the CR is open and verified non-empty, and tell the user its number so they can review the diff and merge it themselves.";

package/dist/customize/migrate-to-v2/migration-prompt.js

@@ -24,6 +24,7 @@
  * Kept as a plain exported constant (not inlined at the call site) so it's
  * independently testable and diffable — this is the load-bearing artifact of
  * the feature, not the wiring around it.
+ * @deprecated Moves a v1 project to the OpenCode-era v2 layout (harnesses/opencode). OpenCode is sunset (2026-10-23); migrate with `kortix migrate` to kortix_version 3.
  */
 export const MIGRATE_TO_V2_PROMPT = `Migrate this project's manifest from kortix_version 1 (kortix.toml) to kortix_version 2 (kortix.yaml), and move its files to the root layout. Read everything first, then make the change, then land it as a change request — do not merge it yourself.
 

package/dist/customize/sections/llm-provider/custom-provider-form.js

@@ -6,6 +6,7 @@ import { InfoBanner } from '../../../primitives/info-banner.js';
 import { Input } from '../../../primitives/input.js';
 import { InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, } from '../../../primitives/input-group.js';
 import Loading from '../../../primitives/loading.js';
+import { Switch } from '../../../primitives/switch.js';
 import { successToast } from '../../../primitives/toast.js';
 import { useTranslations } from '../../../i18n/index.js';
 import { upsertProjectSecret } from '@kortix/sdk';
@@ -52,7 +53,12 @@ export function CustomProviderForm({ projectId, initialId = '', onSaved, }) {
             const name = form.name.trim();
             const baseUrl = form.baseURL.trim();
             const apiKey = form.apiKey.trim();
-            const model = { id: form.modelId.trim(), name: form.modelName.trim() };
+            const model = {
+                id: form.modelId.trim(),
+                name: form.modelName.trim(),
+                ...(form.attachment !== undefined ? { attachment: form.attachment } : {}),
+                ...(form.reasoning !== undefined ? { reasoning: form.reasoning } : {}),
+            };
             if (!providerId || !name || !baseUrl) {
                 throw new Error('Provider ID, name, and base URL are required');
             }
@@ -69,11 +75,7 @@ export function CustomProviderForm({ projectId, initialId = '', onSaved, }) {
                 throw new Error('Model ID cannot contain spaces');
             }
             const existing = custom.providers.find((p) => p.id === providerId && p.configured);
-            await custom.save(providerId, {
-                name,
-                base_url: baseUrl,
-                models: [...(existing?.models ?? []).filter((m) => m.id !== model.id), model],
-            });
+            // The key first: saving the endpoint reads its `GET /models` for each model's limits.
             if (apiKey) {
                 // LLM provider credentials are always project-wide (see
                 // api-key-connect-form.tsx) — a per-user key is invisible to the
@@ -85,6 +87,21 @@ export function CustomProviderForm({ projectId, initialId = '', onSaved, }) {
                     consumer: 'llm_gateway',
                 });
             }
+            await custom.save(providerId, {
+                name,
+                base_url: baseUrl,
+                models: [
+                    ...(existing?.models ?? [])
+                        .filter((m) => m.id !== model.id)
+                        .map(({ id, name, attachment, reasoning }) => ({
+                        id,
+                        name,
+                        ...(attachment !== undefined ? { attachment } : {}),
+                        ...(reasoning !== undefined ? { reasoning } : {}),
+                    })),
+                    model,
+                ],
+            });
             return providerId;
         },
         onSuccess: (providerId) => {
@@ -110,5 +127,5 @@ export function CustomProviderForm({ projectId, initialId = '', onSaved, }) {
                                         // app — a pasted key used to sit in plaintext on screen.
                                         type: revealKey ? 'text' : 'password', autoComplete: "off", spellCheck: false, "data-1p-ignore": "", "data-lpignore": "true", "data-form-type": "other", value: form.apiKey, onChange: (e) => setField('apiKey', e.target.value), placeholder: tI18nComplete.raw('textb009c6c5299f'), className: "font-mono font-normal" }), form.apiKey ? (_jsx(InputGroupAddon, { align: "inline-end", children: _jsx(InputGroupButton, { size: "icon-xs", onClick: () => setRevealKey((current) => !current), title: revealKey ? 'Hide' : 'Show', "aria-label": revealKey
                                                 ? tI18nComplete.raw('text3d0d8c59beb7')
-                                                : tI18nComplete.raw('textcb0b50a0d111'), "aria-pressed": revealKey, className: "text-muted-foreground hover:text-foreground", children: revealKey ? _jsx(EyeSlash, { className: "size-3.5" }) : _jsx(Eye, { className: "size-3.5" }) }) })) : null] }), form.providerId.trim() ? (_jsx("code", { className: "text-muted-foreground font-mono text-xs break-all", children: customProviderSecretName(form.providerId) })) : null] }), _jsxs("div", { className: "flex gap-3", children: [_jsx(FormField, { htmlFor: "custom-model-id", label: tI18nComplete.raw('text089ef2b6dbb3'), children: _jsx(Input, { id: "custom-model-id", type: "text", value: form.modelId, onChange: (e) => setField('modelId', e.target.value), placeholder: tI18nComplete.raw('text34d316295094'), className: "font-mono font-normal" }) }), _jsx(FormField, { htmlFor: "custom-model-name", label: tI18nComplete.raw('texta3c3370cc732'), children: _jsx(Input, { id: "custom-model-name", type: "text", value: form.modelName, onChange: (e) => setField('modelName', e.target.value), placeholder: tI18nComplete.raw('textb70354a1faae'), className: "font-normal" }) })] }), error ? (_jsx(InfoBanner, { tone: "destructive", icon: TriangleAlert, title: tI18nComplete.raw('text464de08899db'), children: error })) : null, _jsx("div", { className: "flex gap-2 pt-1", children: _jsx(Button, { type: "submit", size: "sm", disabled: save.isPending, className: "gap-1.5", children: save.isPending ? (_jsxs(_Fragment, { children: [_jsx(Loading, { className: "size-3.5 shrink-0" }), t('saving')] })) : (t('saveProvider')) }) })] }) }) }));
+                                                : tI18nComplete.raw('textcb0b50a0d111'), "aria-pressed": revealKey, className: "text-muted-foreground hover:text-foreground", children: revealKey ? _jsx(EyeSlash, { className: "size-3.5" }) : _jsx(Eye, { className: "size-3.5" }) }) })) : null] }), form.providerId.trim() ? (_jsx("code", { className: "text-muted-foreground font-mono text-xs break-all", children: customProviderSecretName(form.providerId) })) : null] }), _jsxs("div", { className: "flex gap-3", children: [_jsx(FormField, { htmlFor: "custom-model-id", label: tI18nComplete.raw('text089ef2b6dbb3'), children: _jsx(Input, { id: "custom-model-id", type: "text", value: form.modelId, onChange: (e) => setField('modelId', e.target.value), placeholder: tI18nComplete.raw('text34d316295094'), className: "font-mono font-normal" }) }), _jsx(FormField, { htmlFor: "custom-model-name", label: tI18nComplete.raw('texta3c3370cc732'), children: _jsx(Input, { id: "custom-model-name", type: "text", value: form.modelName, onChange: (e) => setField('modelName', e.target.value), placeholder: tI18nComplete.raw('textb70354a1faae'), className: "font-normal" }) })] }), _jsxs(Field, { className: "gap-2", children: [_jsxs("div", { className: "text-foreground flex flex-wrap items-center gap-x-5 gap-y-2 text-sm", children: [_jsxs("label", { className: "flex items-center gap-2", children: [_jsx(Switch, { checked: form.attachment === true, onCheckedChange: (attachment) => setField('attachment', attachment) }), t('readsImages')] }), _jsxs("label", { className: "flex items-center gap-2", children: [_jsx(Switch, { checked: form.reasoning === true, onCheckedChange: (reasoning) => setField('reasoning', reasoning) }), t('reasoning')] })] }), _jsx(FieldDescription, { children: t('traitsHint') })] }), error ? (_jsx(InfoBanner, { tone: "destructive", icon: TriangleAlert, title: tI18nComplete.raw('text464de08899db'), children: error })) : null, _jsx("div", { className: "flex gap-2 pt-1", children: _jsx(Button, { type: "submit", size: "sm", disabled: save.isPending, className: "gap-1.5", children: save.isPending ? (_jsxs(_Fragment, { children: [_jsx(Loading, { className: "size-3.5 shrink-0" }), t('saving')] })) : (t('saveProvider')) }) })] }) }) }));
 }