@kortix/ui 0.14.8 → 0.14.9

package/dist/customize/agents/agent-policy-sets.d.ts

@@ -0,0 +1,43 @@
+import type { AgentGrantSetV2 } from '@kortix/sdk';
+/**
+ * The agent side of connector policy sets: `agents.<a>.policy_sets` maps a
+ * connector slug to one of that connector's sets (`connectors[].policy_sets`).
+ * An absent key means the base rules.
+ */
+export interface PolicySetOption {
+    name: string;
+    description?: string;
+}
+/**
+ * Every connector's set names, read from the root kortix.yaml. The agent page
+ * already holds the raw manifest, so the editor needs no request per connector.
+ * ponytail: connectors declared in an `imports:` file are not read; an agent
+ * that names a set on one still shows its value, flagged as missing.
+ */
+export declare function connectorPolicySetOptions(manifestRaw: string | null | undefined): Record<string, PolicySetOption[]>;
+/**
+ * One connector's set choice; `null` (or `base`) clears it. Clearing the last
+ * entry returns `{}`, never `undefined`: the config PUT keeps the declared
+ * `policy_sets` when the key is omitted, so `{}` is what removes it.
+ *
+ * Entries on connectors the agent no longer holds are kept on purpose: they
+ * are inert until the connector is granted again, and dropping one is a set
+ * change that needs project.connector.write.
+ */
+export declare function withPolicySet(policySets: Record<string, string> | undefined, slug: string, name: string | null): Record<string, string>;
+export interface PolicySetRow {
+    slug: string;
+    options: PolicySetOption[];
+    /** The set the agent names, or null for the base rules. */
+    value: string | null;
+    /** The agent names a set the connector does not define: calls are blocked. */
+    missing: boolean;
+}
+/**
+ * The rows of the agent's "Rule sets" list: every granted connector that
+ * defines at least one set, plus every connector the agent already names a set
+ * on (so a stale entry is visible and can be cleared).
+ */
+export declare function policySetRows(grant: AgentGrantSetV2 | undefined, catalog: Record<string, PolicySetOption[]>, policySets: Record<string, string> | undefined, 
+/** Slugs of the project's connectors, in display order. */
+connectorSlugs: readonly string[]): PolicySetRow[];

package/dist/customize/agents/agent-policy-sets.js

@@ -0,0 +1,72 @@
+import { parseManifestText } from '../../_vendor/kortix-shared.js';
+/**
+ * Every connector's set names, read from the root kortix.yaml. The agent page
+ * already holds the raw manifest, so the editor needs no request per connector.
+ * ponytail: connectors declared in an `imports:` file are not read; an agent
+ * that names a set on one still shows its value, flagged as missing.
+ */
+export function connectorPolicySetOptions(manifestRaw) {
+    let manifest = {};
+    try {
+        manifest = manifestRaw ? parseManifestText(manifestRaw, 'yaml') : {};
+    }
+    catch {
+        return {};
+    }
+    const out = Object.create(null);
+    const connectors = Array.isArray(manifest.connectors) ? manifest.connectors : [];
+    for (const entry of connectors) {
+        if (!entry || typeof entry !== 'object')
+            continue;
+        const { slug, policy_sets: sets } = entry;
+        if (typeof slug !== 'string' || !sets || typeof sets !== 'object' || Array.isArray(sets))
+            continue;
+        const options = Object.entries(sets).map(([name, set]) => {
+            const description = set?.description;
+            return typeof description === 'string' && description ? { name, description } : { name };
+        });
+        if (options.length > 0)
+            out[slug] = options;
+    }
+    return out;
+}
+/**
+ * One connector's set choice; `null` (or `base`) clears it. Clearing the last
+ * entry returns `{}`, never `undefined`: the config PUT keeps the declared
+ * `policy_sets` when the key is omitted, so `{}` is what removes it.
+ *
+ * Entries on connectors the agent no longer holds are kept on purpose: they
+ * are inert until the connector is granted again, and dropping one is a set
+ * change that needs project.connector.write.
+ */
+export function withPolicySet(policySets, slug, name) {
+    const next = Object.fromEntries(Object.entries(policySets ?? {}).filter(([key]) => key !== slug));
+    if (name && name !== 'base')
+        next[slug] = name;
+    return next;
+}
+/**
+ * The rows of the agent's "Rule sets" list: every granted connector that
+ * defines at least one set, plus every connector the agent already names a set
+ * on (so a stale entry is visible and can be cleared).
+ */
+export function policySetRows(grant, catalog, policySets, 
+/** Slugs of the project's connectors, in display order. */
+connectorSlugs) {
+    const granted = (slug) => grant === 'all' || (Array.isArray(grant) && grant.includes(slug));
+    const assigned = policySets ?? {};
+    const slugs = [
+        ...connectorSlugs.filter((slug) => granted(slug) && (catalog[slug]?.length || Object.hasOwn(assigned, slug))),
+        ...Object.keys(assigned).filter((slug) => !connectorSlugs.includes(slug)),
+    ];
+    return slugs.map((slug) => {
+        const options = catalog[slug] ?? [];
+        const value = Object.hasOwn(assigned, slug) ? (assigned[slug] ?? null) : null;
+        return {
+            slug,
+            options,
+            value,
+            missing: value !== null && !options.some((option) => option.name === value),
+        };
+    });
+}

package/dist/customize/agents/agent-triggers-section.js

@@ -34,7 +34,7 @@ import { useProjectFeatureFlags } from '../../internal/lib/use-project-feature-f
 import { cn } from '../../internal/lib/utils.js';
 import { listProjectTriggers } from '@kortix/sdk';
 import { contract, qk } from '@kortix/sdk/react';
-import { LightningIcon, PlusIcon, PulseIcon, TimerIcon, WebhooksLogoIcon, } from '@phosphor-icons/react';
+import { AppWindowIcon, LightningIcon, PlusIcon, PulseIcon, TimerIcon, WebhooksLogoIcon, } from '@phosphor-icons/react';
 import { useQuery, useQueryClient } from '@tanstack/react-query';
 import { useCallback, useMemo, useState } from 'react';
 const KIND_ICON = {
@@ -42,6 +42,7 @@ const KIND_ICON = {
     webhook: WebhooksLogoIcon,
     monitor: PulseIcon,
     event: LightningIcon,
+    app: AppWindowIcon,
 };
 /**
  * Whether `trigger` starts `agentName`. A trigger that names no agent is

package/dist/customize/connectors/add-mcp/add-mcp-server-dialog.d.ts

@@ -6,11 +6,16 @@ import type { McpServerApp } from '../install/mcp-first.js';
  * provider's consent page. It replaced eight steps through the custom
  * connector form, Sign in and Add account.
  */
-export declare function AddMcpServerDialog({ projectId, open, onOpenChange, takenSlugs, onAdded, app, }: {
+export declare function AddMcpServerDialog({ projectId, open, onOpenChange, takenSlugs, onAdded, app, initial, }: {
     projectId: string;
     /** A catalogue app's own MCP server: the URL is filled in and the dialog
      *  is titled for the app. Null for a server the user pastes. */
     app?: McpServerApp | null;
+    /** A pasted server prefilled from a link (an agent's `setup_url`): a person confirms it here. */
+    initial?: {
+        url: string;
+        name?: string;
+    } | null;
     open: boolean;
     onOpenChange: (open: boolean) => void;
     /** Slugs of the project's connectors: a new server never reuses one. */

package/dist/customize/connectors/add-mcp/add-mcp-server-dialog.js

@@ -28,7 +28,7 @@ const NO_PICKS = { memberIds: [], groupIds: [], agentIds: [] };
  * provider's consent page. It replaced eight steps through the custom
  * connector form, Sign in and Add account.
  */
-export function AddMcpServerDialog({ projectId, open, onOpenChange, takenSlugs, onAdded, app = null, }) {
+export function AddMcpServerDialog({ projectId, open, onOpenChange, takenSlugs, onAdded, app = null, initial = null, }) {
     const t = useTranslations('connectorPages');
     const tSharing = useTranslations('accessSharing');
     const tI18nComplete = useTranslations('hardcodedUi.i18nComplete');
@@ -46,7 +46,7 @@ export function AddMcpServerDialog({ projectId, open, onOpenChange, takenSlugs,
     const everyoneLabel = projectName
         ? tSharing('everyone', { project: projectName })
         : tSharing('visibilityEveryone');
-    const [url, setUrl] = useState(app?.url ?? '');
+    const [url, setUrl] = useState(app?.url ?? initial?.url ?? '');
     const [audience, setAudience] = useState({ audience: 'private', picked: NO_PICKS });
     // The catalogue app's own server, unchanged: named after the app, and its
     // sign-in is known to be one click (`mcpServerFor`).
@@ -57,10 +57,14 @@ export function AddMcpServerDialog({ projectId, open, onOpenChange, takenSlugs,
             ? mcpAppIdentity(app.name, takenSlugs)
             : mcpServerIdentity(url, takenSlugs);
     const urlInvalid = url.trim() !== '' && identity === null;
+    // The profile's name: proposed from the app or the URL until the user edits it.
+    const [nameEdit, setNameEdit] = useState(initial?.name ?? null);
+    const name = (nameEdit ?? identity?.name ?? '').trim();
     const add = useMutation({
         mutationFn: () => addMcpServer(projectId, {
             url,
-            ...(appServer ? { appName: app.name, signIn: true } : {}),
+            ...(name ? { appName: name } : {}),
+            ...(appServer ? { signIn: true } : {}),
             audience: audience.audience,
             grantees: newAccountGrantees(audience.picked),
             takenSlugs,
@@ -94,6 +98,7 @@ export function AddMcpServerDialog({ projectId, open, onOpenChange, takenSlugs,
         audience.picked.groupIds.length +
         (audience.picked.agentIds?.length ?? 0);
     const canSubmit = identity !== null &&
+        /[a-z0-9]/i.test(name) &&
         !add.isPending &&
         (audience.audience === 'private' ||
             (canManageConnections && (audience.audience === 'project' || (Boolean(accountId) && picks > 0))));
@@ -103,6 +108,7 @@ export function AddMcpServerDialog({ projectId, open, onOpenChange, takenSlugs,
         onOpenChange(next);
         if (!next) {
             setUrl(app?.url ?? '');
+            setNameEdit(null);
             setAudience({ audience: 'private', picked: NO_PICKS });
         }
     };
@@ -110,5 +116,5 @@ export function AddMcpServerDialog({ projectId, open, onOpenChange, takenSlugs,
                         event.preventDefault();
                         if (canSubmit)
                             add.mutate();
-                    }, children: [_jsxs(ModalBody, { className: "max-h-[60vh] space-y-4 overflow-y-auto", children: [_jsxs(Field, { children: [_jsx(FieldLabel, { htmlFor: `${id}-url`, children: t('addMcpUrlLabel') }), _jsx(Input, { id: `${id}-url`, type: "url", inputMode: "url", autoComplete: "off", spellCheck: false, value: url, onChange: (event) => setUrl(event.target.value), placeholder: "https://mcp.example.com/mcp", "aria-invalid": urlInvalid || undefined, disabled: add.isPending, autoFocus: !app }), urlInvalid ? (_jsx(FieldDescription, { className: "text-destructive", role: "alert", children: t('addMcpUrlInvalid') })) : (_jsx(FieldDescription, { children: identity ? t('addMcpUrlNamed', { name: identity.name }) : t('addMcpUrlHint') }))] }), _jsx(AudienceFields, { projectId: projectId, value: audience, onChange: setAudience, canShare: canManageConnections, accountId: accountId, everyoneLabel: everyoneLabel, shareRequiresLabel: tSharing('shareRequiresManage'), disabled: add.isPending })] }), _jsxs(ModalFooter, { className: "sm:justify-between", children: [_jsx(Button, { type: "button", variant: "outline-ghost", onClick: () => close(false), disabled: add.isPending, children: tI18nComplete.raw('text19766ed6ccb2') }), _jsxs(Button, { type: "submit", disabled: !canSubmit, children: [add.isPending ? _jsx(Loading, { className: "size-4 shrink-0" }) : null, t('addMcpConnect')] })] })] })] }) }));
+                    }, children: [_jsxs(ModalBody, { className: "max-h-[60vh] space-y-4 overflow-y-auto", children: [app ? null : (_jsxs(Field, { children: [_jsx(FieldLabel, { htmlFor: `${id}-url`, children: t('addMcpUrlLabel') }), _jsx(Input, { id: `${id}-url`, type: "url", inputMode: "url", autoComplete: "off", spellCheck: false, value: url, onChange: (event) => setUrl(event.target.value), placeholder: "https://mcp.example.com/mcp", "aria-invalid": urlInvalid || undefined, disabled: add.isPending, autoFocus: !app }), urlInvalid ? (_jsx(FieldDescription, { className: "text-destructive", role: "alert", children: t('addMcpUrlInvalid') })) : (_jsx(FieldDescription, { children: t('addMcpUrlHint') }))] })), app && nameEdit === null ? null : (_jsxs(Field, { children: [_jsx(FieldLabel, { htmlFor: `${id}-name`, children: t('installNameLabel') }), _jsx(Input, { id: `${id}-name`, value: nameEdit ?? identity?.name ?? '', onChange: (event) => setNameEdit(event.target.value), autoComplete: "off", disabled: add.isPending || identity === null }), _jsx(FieldDescription, { children: t('installProfileHint') })] })), _jsx(AudienceFields, { projectId: projectId, value: audience, onChange: setAudience, canShare: canManageConnections, accountId: accountId, everyoneLabel: everyoneLabel, shareRequiresLabel: tSharing('shareRequiresManage'), disabled: add.isPending })] }), _jsxs(ModalFooter, { className: "sm:justify-between", children: [app && nameEdit === null ? (_jsx(Button, { type: "button", variant: "text", size: "sm", className: "px-0", onClick: () => setNameEdit(identity?.name ?? app.name), disabled: add.isPending, children: t('installRename') })) : null, _jsx(Button, { type: "button", variant: "outline-ghost", className: app && nameEdit === null ? 'sm:ml-auto' : undefined, onClick: () => close(false), disabled: add.isPending, children: tI18nComplete.raw('text19766ed6ccb2') }), _jsxs(Button, { type: "submit", disabled: !canSubmit, children: [add.isPending ? _jsx(Loading, { className: "size-4 shrink-0" }) : null, t('addMcpConnect')] })] })] })] }) }));
 }

package/dist/customize/connectors/agent-access.d.ts

@@ -0,0 +1,35 @@
+import type { AgentGrantSet } from '@kortix/sdk';
+/**
+ * Which agents can use which connector, and with which rule set, read from
+ * the root kortix.yaml (v2/v3): `agents.<a>.connectors` is the grant and
+ * `agents.<a>.policy_sets.<slug>` the set. The connector page's Agents tab and
+ * the Rules matrix both read this, and both write through `setAgentScope`.
+ *
+ * ponytail: agents declared in an `imports:` file are not read. Read the
+ * merged grants from the API when it serves them (`GET …/connectors/{slug}/agents`).
+ */
+export interface AgentConnectorAccess {
+    granted: boolean;
+    /** The set the agent names on this connector, or null for the base rules. */
+    policySet: string | null;
+}
+export interface AgentGrants {
+    /** `all`, or the granted slugs. An absent grant is none (v2 denies by default). */
+    connectors: 'all' | string[];
+    policySets: Record<string, string>;
+}
+/** Every declared agent's connector grant and sets, by agent name. Null when the manifest is not v2/v3 YAML. */
+export declare function manifestAgentGrants(manifestRaw: string | null | undefined): Record<string, AgentGrants> | null;
+export declare function agentConnectorAccess(grants: AgentGrants | undefined, slug: string): AgentConnectorAccess;
+/**
+ * The agent's connector grant after giving or taking one connector. Taking one
+ * from `all` lists every other connector the project has.
+ */
+export declare function withConnectorGrant(grants: AgentGrants | undefined, slug: string, on: boolean, allSlugs: readonly string[]): AgentGrantSet;
+/** One rule set of a connector and how many agents use it. */
+export interface RuleSetUsage {
+    name: string;
+    agents: number;
+}
+/** Each connector's rule sets (`connectors[].policy_sets`) with their agent count, by slug. */
+export declare function connectorRuleSetUsage(manifestRaw: string | null | undefined): Record<string, RuleSetUsage[]>;

package/dist/customize/connectors/agent-access.js

@@ -0,0 +1,77 @@
+import { parseManifestText } from '../../_vendor/kortix-shared.js';
+/** Every declared agent's connector grant and sets, by agent name. Null when the manifest is not v2/v3 YAML. */
+export function manifestAgentGrants(manifestRaw) {
+    if (!manifestRaw)
+        return null;
+    let manifest;
+    try {
+        manifest = parseManifestText(manifestRaw, 'yaml');
+    }
+    catch {
+        return null;
+    }
+    const version = Number(manifest.kortix_version);
+    const agents = manifest.agents;
+    if (!(version >= 2))
+        return null;
+    if (!agents || typeof agents !== 'object' || Array.isArray(agents))
+        return {};
+    const out = Object.create(null);
+    for (const [name, block] of Object.entries(agents)) {
+        const entry = (block && typeof block === 'object' ? block : {});
+        const connectors = entry.connectors === 'all'
+            ? 'all'
+            : Array.isArray(entry.connectors)
+                ? entry.connectors.filter((slug) => typeof slug === 'string')
+                : [];
+        const sets = entry.policy_sets && typeof entry.policy_sets === 'object' && !Array.isArray(entry.policy_sets)
+            ? Object.fromEntries(Object.entries(entry.policy_sets).filter((pair) => typeof pair[1] === 'string'))
+            : {};
+        out[name] = { connectors, policySets: sets };
+    }
+    return out;
+}
+export function agentConnectorAccess(grants, slug) {
+    if (!grants)
+        return { granted: false, policySet: null };
+    return {
+        granted: grants.connectors === 'all' || grants.connectors.includes(slug),
+        policySet: grants.policySets[slug] ?? null,
+    };
+}
+/**
+ * The agent's connector grant after giving or taking one connector. Taking one
+ * from `all` lists every other connector the project has.
+ */
+export function withConnectorGrant(grants, slug, on, allSlugs) {
+    const current = grants?.connectors ?? [];
+    if (current === 'all')
+        return on ? 'all' : allSlugs.filter((other) => other !== slug);
+    if (on)
+        return current.includes(slug) ? current : [...current, slug];
+    return current.filter((other) => other !== slug);
+}
+/** Each connector's rule sets (`connectors[].policy_sets`) with their agent count, by slug. */
+export function connectorRuleSetUsage(manifestRaw) {
+    const grants = manifestAgentGrants(manifestRaw);
+    if (!grants || !manifestRaw)
+        return {};
+    let manifest;
+    try {
+        manifest = parseManifestText(manifestRaw, 'yaml');
+    }
+    catch {
+        return {};
+    }
+    const out = Object.create(null);
+    for (const entry of Array.isArray(manifest.connectors) ? manifest.connectors : []) {
+        const { slug, policy_sets: sets } = (entry ?? {});
+        if (typeof slug !== 'string' || !sets || typeof sets !== 'object' || Array.isArray(sets))
+            continue;
+        out[slug] = Object.keys(sets).map((name) => ({
+            name,
+            agents: Object.values(grants).filter((agent) => agent.policySets[slug] === name).length,
+        }));
+    }
+    return out;
+}

package/dist/customize/connectors/catalog/browse-sections.d.ts

@@ -1,10 +1,7 @@
-import type { ConnectSectionsPage, ConnectToolkit, DiscoverSectionsPage, PipedreamApp, PipedreamCategory, PipedreamSection } from '@kortix/sdk';
+import type { DiscoverSectionsPage, PipedreamCategory } from '@kortix/sdk';
 import { type CatalogEntry } from './catalog-entry.js';
 import type { CatalogSection } from './use-catalog.js';
-export type EasyConnectApp = PipedreamApp & {
-    provider?: 'composio' | 'pipedream';
-};
-/** The browse page in one shape for every catalogue, cards already mapped. */
+/** The browse page, cards already mapped. */
 export interface BrowseSectionsPage {
     /** The top of the whole catalogue by rank. Only Discover ranks its apps. */
     popular: CatalogEntry[];
@@ -16,24 +13,6 @@ export interface BrowseSectionsPage {
     }>;
     categories: PipedreamCategory[];
 }
-/** A Composio toolkit as the card the Easy Connect grid renders. The paged
- *  catalogue and the browse sections both use this, so a card is identical in
- *  a section and behind its "View all". */
-export declare function connectToolkitApp(toolkit: ConnectToolkit): EasyConnectApp;
-/**
- * The Composio browse page.
- *
- * Labels are replaced by keys. Composio's category names are lowercase
- * ("server monitoring"), and the paged grid titles a category by humanizing its
- * key — so titling by key keeps a section heading and the header of the
- * category it opens spelling the same name.
- */
-export declare function sectionsPageFromConnect(page: ConnectSectionsPage): BrowseSectionsPage;
-/** The Pipedream browse page. Pipedream publishes readable labels, kept as-is. */
-export declare function sectionsPageFromPipedream(page: {
-    sections: PipedreamSection[];
-    categories: PipedreamCategory[];
-}): BrowseSectionsPage;
 /**
  * The Discover browse page. Titled by key: Discover sections are the shared
  * curated buckets, and `localizedSectionTitle` resolves a curated key to our
@@ -49,14 +28,8 @@ export declare function sectionsPageFromDiscover(page: DiscoverSectionsPage): Br
  * Popular leads when the catalogue ranks anything. It is a per-item rank, not a
  * category, so its total is its own slice and it never offers "View all" into a
  * bucket with no more members.
- *
- * `native` is the Computers card. No catalogue publishes it, and the browse
- * page is where it is discovered, so it leads the section for the category it
- * claims. It does not change that section's `total`, which counts the
- * catalogue the heading's "View all" opens.
  */
 export declare function browseSections(page: BrowseSectionsPage, opts: {
-    native: CatalogEntry | null;
     cardCount: number;
     title: (label: string) => string;
 }): CatalogSection[];

package/dist/customize/connectors/catalog/browse-sections.js

@@ -1,61 +1,5 @@
-import { catalogEntryFromDiscover, catalogEntryFromEasyConnect, foldKey, } from './catalog-entry.js';
+import { catalogEntryFromDiscover } from './catalog-entry.js';
 import { POPULAR_SECTION } from './connector-categories.js';
-/** A Composio toolkit as the card the Easy Connect grid renders. The paged
- *  catalogue and the browse sections both use this, so a card is identical in
- *  a section and behind its "View all". */
-export function connectToolkitApp(toolkit) {
-    return {
-        slug: toolkit.slug,
-        name: toolkit.name,
-        description: toolkit.description ?? null,
-        imgSrc: toolkit.logo,
-        authType: toolkit.isNoAuth ? 'none' : 'oauth',
-        categories: toolkit.categories ?? [],
-        hasActions: true,
-        hasTriggers: false,
-        featuredWeight: 0,
-        provider: 'composio',
-        directId: toolkit.directId ?? null,
-        directMcpUrl: toolkit.directMcpUrl ?? null,
-    };
-}
-/**
- * The Composio browse page.
- *
- * Labels are replaced by keys. Composio's category names are lowercase
- * ("server monitoring"), and the paged grid titles a category by humanizing its
- * key — so titling by key keeps a section heading and the header of the
- * category it opens spelling the same name.
- */
-export function sectionsPageFromConnect(page) {
-    return {
-        popular: [],
-        sections: page.sections.map((section) => ({
-            key: section.key,
-            label: section.key,
-            total: section.total,
-            items: section.toolkits.map((toolkit) => catalogEntryFromEasyConnect(connectToolkitApp(toolkit))),
-        })),
-        categories: page.categories.map((category) => ({
-            key: category.key,
-            label: category.key,
-            count: category.count,
-        })),
-    };
-}
-/** The Pipedream browse page. Pipedream publishes readable labels, kept as-is. */
-export function sectionsPageFromPipedream(page) {
-    return {
-        popular: [],
-        sections: page.sections.map((section) => ({
-            key: section.key,
-            label: section.label,
-            total: section.total,
-            items: section.apps.map(catalogEntryFromEasyConnect),
-        })),
-        categories: page.categories,
-    };
-}
 /**
  * The Discover browse page. Titled by key: Discover sections are the shared
  * curated buckets, and `localizedSectionTitle` resolves a curated key to our
@@ -86,14 +30,8 @@ export function sectionsPageFromDiscover(page) {
  * Popular leads when the catalogue ranks anything. It is a per-item rank, not a
  * category, so its total is its own slice and it never offers "View all" into a
  * bucket with no more members.
- *
- * `native` is the Computers card. No catalogue publishes it, and the browse
- * page is where it is discovered, so it leads the section for the category it
- * claims. It does not change that section's `total`, which counts the
- * catalogue the heading's "View all" opens.
  */
 export function browseSections(page, opts) {
-    const nativeKeys = new Set((opts.native?.categories ?? []).map(foldKey));
     const popularItems = page.popular.slice(0, opts.cardCount);
     const popular = popularItems.length > 0
         ? [
@@ -105,15 +43,10 @@ export function browseSections(page, opts) {
             },
         ]
         : [];
-    return popular.concat(page.sections.map((section) => {
-        const withNative = opts.native && nativeKeys.has(foldKey(section.key))
-            ? [opts.native, ...section.items]
-            : section.items;
-        return {
-            key: section.key,
-            label: opts.title(section.label),
-            total: section.total,
-            items: withNative.slice(0, opts.cardCount),
-        };
-    }));
+    return popular.concat(page.sections.map((section) => ({
+        key: section.key,
+        label: opts.title(section.label),
+        total: section.total,
+        items: section.items.slice(0, opts.cardCount),
+    })));
 }

package/dist/customize/connectors/catalog/catalog-entry.d.ts

@@ -1,51 +1,26 @@
-import type { UiTranslator } from '../../../i18n/index.js';
-import type { AdminConnector, DiscoverConnector, PipedreamApp } from '@kortix/sdk';
+import type { AdminConnector, ConnectToolkit, DiscoverConnector, PipedreamApp } from '@kortix/sdk';
+import { type ConnectorLogoSource } from '../../../internal/connector-logo/connector-logo-source.js';
 import { POPULAR_SECTION } from './connector-categories.js';
-/**
- * Which catalogue an entry came from. This is not cosmetic — it decides which
- * install the app page's Install runs. A `discover` entry installs from its
- * template (`discoverInstallTarget`); an `easy-connect` entry installs as a
- * managed OAuth app via Pipedream (`easyConnectInstallTarget`). The two build
- * different connectors and cannot be swapped.
- */
-export type CatalogSource = 'discover' | 'easy-connect';
 interface CatalogEntryFields {
-    /** Stable React key. Prefixed by source, because the two catalogues are
-     *  independent namespaces and both publish a `slack`. */
+    /** Stable React key: `discover:<record id>`. */
     key: string;
     slug: string;
     name: string;
     description: string | null;
     icon: string | null;
     categories: string[];
-    /** Only Discover ranks its catalogue. Easy Connect entries are always
-     *  `null`, which keeps them out of the Popular section rather than sorting
-     *  them to the bottom of it. */
+    /** The catalogue's rank; `null` keeps a record out of the Popular section. */
     popularity: number | null;
 }
 /**
- * One card in the catalogue, normalised across the two sources so the grid,
- * the search, the category grouping and the connected-state join are written
- * once instead of twice.
- *
- * The raw item rides along on the union arm so the page can hand it straight
- * back to the matching add flow without a lookup.
+ * One card in the catalogue: a Discover record (Kortix apps, integrations.sh
+ * servers and APIs, Composio apps). The raw record rides along so the page can
+ * hand it straight to the install flow without a lookup.
  */
-export type CatalogEntry = (CatalogEntryFields & {
+export type CatalogEntry = CatalogEntryFields & {
     source: 'discover';
     connector: DiscoverConnector;
-    /** The managed catalogue lists the same app too (`mergeSearchEntries`). */
-    alsoApp?: boolean;
-}) | (CatalogEntryFields & {
-    source: 'easy-connect';
-    app: PipedreamApp & {
-        provider?: 'composio' | 'pipedream';
-    };
-}) | (CatalogEntryFields & {
-    source: 'computer';
-});
-/** Native platform provider. Each member's paired machine is one of its accounts. */
-export declare function computersCatalogEntry(tI18nComplete: UiTranslator): CatalogEntry;
+};
 /**
  * The icon URL a Discover record's card loads.
  *
@@ -60,10 +35,14 @@ export declare function computersCatalogEntry(tI18nComplete: UiTranslator): Cata
  * reads the same as the glyph it replaced.
  */
 export declare function discoverEntryIcon(connector: Pick<DiscoverConnector, 'icon' | 'domain'>): string | null;
-export declare function catalogEntryFromDiscover(connector: DiscoverConnector): CatalogEntry;
-export declare function catalogEntryFromEasyConnect(app: PipedreamApp & {
+export type EasyConnectApp = PipedreamApp & {
     provider?: 'composio' | 'pipedream';
-}): CatalogEntry;
+};
+/** A Composio toolkit as the card the Easy Connect grid renders. The paged
+ *  catalogue and the browse sections both use this, so a card is identical in
+ *  a section and behind its "View all". */
+export declare function connectToolkitApp(toolkit: ConnectToolkit): EasyConnectApp;
+export declare function catalogEntryFromDiscover(connector: DiscoverConnector): CatalogEntry;
 /**
  * The one fact that varies between cards: HOW this entry connects. Short
  * nouns, shown as the card's quiet line under the title — every card gets
@@ -123,3 +102,5 @@ export declare function catalogEntryConnectors(connectors: readonly AdminConnect
  *  `browseSections` in `browse-sections.ts`. Defined in `connector-categories.ts`
  *  and re-exported here for the modules that already import this one. */
 export { POPULAR_SECTION };
+/** The logo source of a catalogue card (`ConnectorLogo`): same rule as every other surface. */
+export declare function catalogEntryLogoSource(entry: CatalogEntry): ConnectorLogoSource;