@kortix/ui 0.14.8 → 0.14.10

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;

package/dist/customize/connectors/catalog/catalog-entry.js

@@ -1,18 +1,6 @@
 import { faviconUrlForHostname } from '../../../lib/favicon.js';
+import { discoverLogoSource } from '../../../internal/connector-logo/connector-logo-source.js';
 import { POPULAR_SECTION } from './connector-categories.js';
-/** Native platform provider. Each member's paired machine is one of its accounts. */
-export function computersCatalogEntry(tI18nComplete) {
-    return {
-        source: 'computer',
-        key: 'computer:computers',
-        slug: 'computers',
-        name: 'Computer',
-        description: tI18nComplete.raw('text070855f4fe8d'),
-        icon: null,
-        categories: ['developer-tools'],
-        popularity: null,
-    };
-}
 /**
  * The icon URL a Discover record's card loads.
  *
@@ -29,6 +17,25 @@ export function computersCatalogEntry(tI18nComplete) {
 export function discoverEntryIcon(connector) {
     return connector.icon ?? faviconUrlForHostname(connector.domain);
 }
+/** 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,
+    };
+}
 export function catalogEntryFromDiscover(connector) {
     return {
         source: 'discover',
@@ -42,19 +49,6 @@ export function catalogEntryFromDiscover(connector) {
         popularity: connector.popularity,
     };
 }
-export function catalogEntryFromEasyConnect(app) {
-    return {
-        source: 'easy-connect',
-        app,
-        key: `easy-connect:${app.slug}`,
-        slug: app.slug,
-        name: app.name,
-        description: app.description,
-        icon: app.imgSrc,
-        categories: app.categories,
-        popularity: null,
-    };
-}
 /**
  * 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
@@ -73,20 +67,15 @@ export function appNameKey(name) {
         .replace(/(mcp|mcpserver)$/, '');
 }
 export function catalogEntryKindLabel(entry) {
-    if (entry.source === 'computer')
-        return 'Native';
-    // An app with both ways to connect names both.
-    if (entry.source === 'easy-connect')
-        return entry.app?.directId ? 'App · MCP' : 'App';
-    if (entry.alsoApp && entry.connector.kind === 'mcp')
-        return 'MCP · App';
     switch (entry.connector.kind) {
+        case 'composio':
+            return 'Composio';
+        case 'kortix':
+            return 'Kortix';
         case 'mcp':
             return 'MCP';
         case 'graphql':
             return 'GraphQL';
-        case 'cli':
-            return 'CLI';
         default:
             return 'API';
     }
@@ -149,8 +138,6 @@ export function connectedCatalogKeys(connectors) {
     return keys;
 }
 export function isCatalogEntryConnected(entry, connectedKeys) {
-    if (entry.source === 'computer')
-        return connectedKeys.has('provider:computer');
     return connectedKeys.has(foldKey(entry.slug)) || connectedKeys.has(foldKey(entry.name));
 }
 /**
@@ -177,9 +164,6 @@ function tokenIdentifiesEntry(connectorToken, entryToken) {
  * `install/install.ts`.
  */
 export function catalogEntryConnectors(connectors, entry) {
-    if (entry.source === 'computer') {
-        return connectors.filter((connector) => connector.provider === 'computer');
-    }
     const tokens = [foldKey(entry.slug), foldKey(entry.name)].filter(Boolean);
     return connectors.filter((connector) => [foldKey(connector.slug), foldKey(connector.name ?? '')].some((connectorToken) => tokens.some((token) => tokenIdentifiesEntry(connectorToken, token))));
 }
@@ -187,3 +171,7 @@ export function catalogEntryConnectors(connectors, entry) {
  *  `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 function catalogEntryLogoSource(entry) {
+    return discoverLogoSource(entry.connector);
+}

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

@@ -10,34 +10,6 @@ export interface CatalogInstall {
     pendingKey: string | null;
     onInstall: (entry: CatalogEntry) => void;
 }
-/**
- * A catalog favicon, or a neutral glyph tile when the record has none or its
- * URL fails to load.
- *
- * A plain `<img>`, not `next/image`. These are third-party favicons on
- * arbitrary hosts, so the loader was already bypassed with `unoptimized` — which
- * left `fill` costing an absolutely-positioned child inside a `relative`
- * wrapper, per card, for no optimisation in return. Native `loading="lazy"`
- * defers every icon below the fold, which is most of them on a browse page.
- *
- * `width`/`height` are set so the box is reserved before the image arrives and
- * the grid never reflows around a late favicon.
- *
- * The broken-image state is the fallback the null case already had: a logo
- * URL that 404s used to render the browser's broken-image glyph inside the
- * tile, which is worse than no imagery at all. `onError` swaps to the same
- * glyph tile — the same fallback a record with no icon gets, so "missing" and
- * "unavailable" look identical. Mirrors `ConnectorAppIcon`'s broken state.
- *
- * The latch is per URL (`failedUrl`, not a boolean): a URL that failed stays
- * failed, while a swapped URL gets a fresh try without any call-site key —
- * merge-search swaps a merged twin's icon to the managed logo as catalogue
- * pages stream in.
- */
-export declare function ConnectorIcon({ icon, computer, }: {
-    icon: string | null;
-    computer?: boolean;
-}): import("react").JSX.Element;
 /**
  * The catalogue body: one flat, paginated, searchable grid.
  *
@@ -46,12 +18,11 @@ export declare function ConnectorIcon({ icon, computer, }: {
  * no per-category deepening loop, no reveal window uncovering already-loaded
  * cards.
  */
-export declare function ConnectorBrowse({ state, connectedKeys, hrefFor, onOpen, install, emptyTitle, emptyDescription, suppressNoMatch, }: {
+export declare function ConnectorBrowse({ state, connectedKeys, hrefFor, install, emptyTitle, emptyDescription, suppressNoMatch, }: {
     state: CatalogState;
     connectedKeys: ReadonlySet<string>;
-    /** The card's page, or `null` for an entry that opens in place. */
-    hrefFor: (entry: CatalogEntry) => string | null;
-    onOpen: (entry: CatalogEntry) => void;
+    /** The card's app page. */
+    hrefFor: (entry: CatalogEntry) => string;
     install: CatalogInstall;
     emptyTitle: string;
     emptyDescription: string;