@ai-matrx/agents 0.7.0 → 0.8.0

package/dist/catalog/react/index.d.cts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { ComponentType, ReactNode, Ref } from 'react';
+import { ComponentType, ReactNode, Ref, SVGProps } from 'react';
 
 /**
  * `@ai-matrx/agents/catalog` — the row shape and the per-consumer view state.
@@ -19,9 +19,20 @@ import { ComponentType, ReactNode, Ref } from 'react';
  * default row carries (byte-identical to the ref shape matrx-extend
  * `src/lib/mandates.ts` and matrx-local `desktop/src/lib/mandates.ts`
  * already hand back to their hosts).
+ *
+ * 🚨 The brand is a STRING LITERAL, never `unique symbol`. This package emits
+ * `./catalog` and `./catalog/react` as two separate bundles, so each `.d.ts`
+ * carries its own copy of these declarations. A `unique symbol` brand is
+ * NOMINAL: two copies of it are unrelated types, so `createAgentCatalog()`
+ * from `./catalog` was not assignable to `<AgentCatalogProvider catalog=…>`
+ * from `./catalog/react` — the exact two-import wiring the README, the
+ * CHANGELOG and every consumer use. A literal brand is structural, so the two
+ * copies unify, while a bare `string` still cannot be passed where an
+ * `AgentId` is required (which is the whole point of branding). Any future
+ * brand in this package follows the same rule.
  */
 type AgentId = string & {
-    readonly __agentId: unique symbol;
+    readonly __agentId: "ai-matrx.agent-id";
 };
 /** `agent_type` verbatim. Only `builtin` changes how a row is grouped. */
 type AgentCatalogAgentType = "user" | "builtin";
@@ -31,6 +42,39 @@ type AgentCatalogAgentType = "user" | "builtin";
  * itself rather than being coerced into a wrong one.
  */
 type AgentAccessLevel = "owner" | "admin" | "editor" | "viewer" | "system" | (string & {});
+/**
+ * Present on a catalog row ONLY when that agent is an **Orchestra** — a
+ * conductor that delegates to member agents at run time. Choosing one for a
+ * step, a chat or a workflow node runs the whole ensemble, so a person has to
+ * be able to SEE that before choosing, not discover it from the run.
+ *
+ * The DB decides. `agx_get_list_full` / `agx_get_list` / `agx_search` build
+ * this from `platform.associations` (the conductor self-edge plus its member
+ * edges) in one `agx_orchestra_badges()` join — never a second fetch, and
+ * never a per-row read. `null` for every ordinary agent.
+ *
+ * History: the badge lived only in the Python `GET /agents` route, so every
+ * client lost it when the pickers moved to the RPC. It is a ROW FIELD now, in
+ * the one read every client shares.
+ */
+interface OrchestraBadge {
+    /** How the ensemble runs: `supervisor` | `sequential` | `parallel` | `dag`, or a future mode verbatim. */
+    mode: string;
+    /** The composition's one-line description, when its author wrote one. */
+    tagline: string | null;
+    /**
+     * The per-composition delegation-depth budget AS DECLARED, or `null` when
+     * the composition declares none. Deliberately NOT defaulted here: the
+     * platform's fallback ceiling is enforced by the server that runs the
+     * ensemble, and a badge that invented a number would be reporting a promise
+     * nobody made.
+     */
+    depthBudget: number | null;
+    /** Member edges. From the ROW count, so an unlabelled ensemble still counts. */
+    memberCount: number;
+    /** Only REAL role titles — an ensemble with unlabelled edges yields `[]`. */
+    memberTitles: string[];
+}
 /**
  * One `agx_get_list_full()` row, camelCased. Nineteen columns, no more:
  * anything richer needs a different read and is a different type.
@@ -55,6 +99,12 @@ interface AgentSummary {
     isOwner: boolean | null;
     accessLevel: AgentAccessLevel | null;
     sharedByEmail: string | null;
+    /**
+     * The Orchestra badge, or `null` for an ordinary agent. Strict: every row
+     * carries the key, so a surface reads `agent.orchestra` and never has to ask
+     * whether the column existed.
+     */
+    orchestra: OrchestraBadge | null;
     /**
      * Set only on a mandate default row — the key it resolved through, so a
      * host can tell "the default" from a stored agent without parsing the id.
@@ -62,6 +112,21 @@ interface AgentSummary {
     mandateKey?: string;
 }
 type AgentSortOption = "updated-desc" | "created-desc" | "name-asc" | "name-desc" | "category-asc";
+/**
+ * The sort choices a picker offers, in order. PURE DATA, so it lives in the
+ * pure entry: a server-reachable manifest reads it at module scope, and
+ * importing it from the client-stamped `./catalog/react` bundle dragged React
+ * into a server graph for the sake of five string pairs. `./catalog/react`
+ * re-exports it unchanged, so no consumer has to move.
+ *
+ * (Written "client-stamped", never with the literal directive: this comment is
+ * emitted into `dist/catalog/index.d.ts`, and the tarball canary rightly
+ * refuses that directive anywhere in a PURE entry.)
+ */
+declare const SORT_OPTIONS: {
+    value: AgentSortOption;
+    label: string;
+}[];
 /** Which ownership tab is active in the agent list. */
 type AgentTab = "mine" | "shared" | "all" | "system";
 /** Favorite filter. */
@@ -248,6 +313,18 @@ interface AgentCatalogSchemaReport {
     answered: string[];
     /** True when `agent.definition.is_favorite` is writable by this caller. */
     favoriteWritable: boolean | null;
+    /**
+     * Whether `agx_get_list_full` carries the `orchestra` badge column (added to
+     * the platform 2026-09-08).
+     *
+     * NOT a violation when absent — the picker degrades to no conductor marker,
+     * which is honest — but it is never SILENT either: a `false` here is the one
+     * signal that tells a host "this database predates the badge" instead of
+     * leaving someone to wonder why their Orchestra looks like a plain agent.
+     * `null` means the probe could not tell (the caller can see no agents at
+     * all), never "fine".
+     */
+    orchestraColumn: boolean | null;
 }
 interface AssertAgentCatalogSchemaOptions {
     /**
@@ -634,12 +711,8 @@ declare function AgentListInlinePicker({ consumerId, onSelect, activeAgentId, cl
  * catalog/react/types.ts — VERBATIM port of matrx-frontend
  * `features/agents/components/agent-listings/core/types.ts`.
  */
-
 type RightPanel = "detail" | "sort" | "categories" | "tags" | null;
-declare const SORT_OPTIONS: {
-    value: AgentSortOption;
-    label: string;
-}[];
+
 declare const PANEL_HEIGHT = "528px";
 /**
  * 🚨 THE PANEL NEVER OUTGROWS THE SPACE IT HAS.
@@ -805,4 +878,43 @@ declare function SidePanelHeader({ title, onClose, }: {
     onClose: () => void;
 }): react.JSX.Element;
 
-export { type AgentCatalogLinkComponent, AgentCatalogProvider, type AgentCatalogProviderProps, type AgentCatalogRenderModelRef, type AgentCatalogUiPorts, AgentCategoriesPanel, type AgentCategoriesPanelProps, AgentDetailCard, type AgentDetailCardProps, AgentFilterBar, type AgentFilterBarProps, AgentListContent, type AgentListContentProps, type AgentListCoreOptions, AgentListDropdown, type AgentListDropdownProps, AgentListInlinePicker, type AgentListInlinePickerProps, type AgentListTabCounts, AgentListTabs, AgentMobileSubView, type AgentMobileSubViewProps, AgentRow, type AgentRowProps, AgentSortPanel, type AgentSortPanelProps, AgentTagsPanel, type AgentTagsPanelProps, CheckRow, FavoriteAgentButton, FilterChip, HOVER_GRACE_MS, LIST_MAX_HEIGHT, OptionRow, PANEL_HEIGHT, type RightPanel, SORT_OPTIONS, SearchInput, SidePanelHeader, type UseAgentConsumerReturn, coerceVisibleTab, useAgentCatalog, useAgentCatalogRows, useAgentCatalogState, useAgentCatalogUiPorts, useAgentConsumer, useAgentListCore };
+type IconProps = SVGProps<SVGSVGElement> & {
+    className?: string;
+};
+/**
+ * The Orchestra marker (Lucide `music-4`): the glyph the Workflow Studio's
+ * picker used for a conductor, kept identical so the same agent wears the same
+ * mark in every client.
+ */
+declare function Music4Icon(props: IconProps): react.JSX.Element;
+
+/**
+ * catalog/orchestra.ts — @ai-matrx/agents/catalog
+ *
+ * Creator words for an Orchestra badge. A VERBATIM port of the helpers the
+ * Workflow Studio's hand-rolled picker carried (`apps/workflow-studio/src/
+ * hooks/use-agents.ts` before `c0f958b43`), lifted here so every client says
+ * the same sentence about the same ensemble.
+ *
+ * Pure — no React, no DOM. The row shape is `OrchestraBadge` in `./types`.
+ */
+
+declare function orchestraModeLabel(mode: string): string;
+/** Human label for a badge: "Orchestra · supervisor · 3 members" (singular-safe). */
+declare function orchestraLabel(badge: OrchestraBadge): string;
+/**
+ * The member-call ceiling in Creator language ("Team members can call helpers
+ * up to 2 levels deep"), or `null` when the composition declared none. A badge
+ * never invents the platform default: the server that runs the ensemble owns
+ * that number, and printing a promise nobody made is worse than printing
+ * nothing.
+ */
+declare function orchestraDepthLine(badge: OrchestraBadge): string | null;
+/**
+ * One visible line naming who the Orchestra delegates to, collapsing past
+ * `limit` into "+N more". `null` when no member carries a real role title —
+ * "Member, Member, Member" is noise that reads like data.
+ */
+declare function orchestraDelegatesLine(badge: OrchestraBadge, limit?: number): string | null;
+
+export { type AgentCatalogLinkComponent, AgentCatalogProvider, type AgentCatalogProviderProps, type AgentCatalogRenderModelRef, type AgentCatalogUiPorts, AgentCategoriesPanel, type AgentCategoriesPanelProps, AgentDetailCard, type AgentDetailCardProps, AgentFilterBar, type AgentFilterBarProps, AgentListContent, type AgentListContentProps, type AgentListCoreOptions, AgentListDropdown, type AgentListDropdownProps, AgentListInlinePicker, type AgentListInlinePickerProps, type AgentListTabCounts, AgentListTabs, AgentMobileSubView, type AgentMobileSubViewProps, AgentRow, type AgentRowProps, AgentSortPanel, type AgentSortPanelProps, AgentTagsPanel, type AgentTagsPanelProps, CheckRow, FavoriteAgentButton, FilterChip, HOVER_GRACE_MS, type IconProps, LIST_MAX_HEIGHT, Music4Icon, OptionRow, type OrchestraBadge, PANEL_HEIGHT, type RightPanel, SORT_OPTIONS, SearchInput, SidePanelHeader, type UseAgentConsumerReturn, coerceVisibleTab, orchestraDelegatesLine, orchestraDepthLine, orchestraLabel, orchestraModeLabel, useAgentCatalog, useAgentCatalogRows, useAgentCatalogState, useAgentCatalogUiPorts, useAgentConsumer, useAgentListCore };

package/dist/catalog/react/index.d.ts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { ComponentType, ReactNode, Ref } from 'react';
+import { ComponentType, ReactNode, Ref, SVGProps } from 'react';
 
 /**
  * `@ai-matrx/agents/catalog` — the row shape and the per-consumer view state.
@@ -19,9 +19,20 @@ import { ComponentType, ReactNode, Ref } from 'react';
  * default row carries (byte-identical to the ref shape matrx-extend
  * `src/lib/mandates.ts` and matrx-local `desktop/src/lib/mandates.ts`
  * already hand back to their hosts).
+ *
+ * 🚨 The brand is a STRING LITERAL, never `unique symbol`. This package emits
+ * `./catalog` and `./catalog/react` as two separate bundles, so each `.d.ts`
+ * carries its own copy of these declarations. A `unique symbol` brand is
+ * NOMINAL: two copies of it are unrelated types, so `createAgentCatalog()`
+ * from `./catalog` was not assignable to `<AgentCatalogProvider catalog=…>`
+ * from `./catalog/react` — the exact two-import wiring the README, the
+ * CHANGELOG and every consumer use. A literal brand is structural, so the two
+ * copies unify, while a bare `string` still cannot be passed where an
+ * `AgentId` is required (which is the whole point of branding). Any future
+ * brand in this package follows the same rule.
  */
 type AgentId = string & {
-    readonly __agentId: unique symbol;
+    readonly __agentId: "ai-matrx.agent-id";
 };
 /** `agent_type` verbatim. Only `builtin` changes how a row is grouped. */
 type AgentCatalogAgentType = "user" | "builtin";
@@ -31,6 +42,39 @@ type AgentCatalogAgentType = "user" | "builtin";
  * itself rather than being coerced into a wrong one.
  */
 type AgentAccessLevel = "owner" | "admin" | "editor" | "viewer" | "system" | (string & {});
+/**
+ * Present on a catalog row ONLY when that agent is an **Orchestra** — a
+ * conductor that delegates to member agents at run time. Choosing one for a
+ * step, a chat or a workflow node runs the whole ensemble, so a person has to
+ * be able to SEE that before choosing, not discover it from the run.
+ *
+ * The DB decides. `agx_get_list_full` / `agx_get_list` / `agx_search` build
+ * this from `platform.associations` (the conductor self-edge plus its member
+ * edges) in one `agx_orchestra_badges()` join — never a second fetch, and
+ * never a per-row read. `null` for every ordinary agent.
+ *
+ * History: the badge lived only in the Python `GET /agents` route, so every
+ * client lost it when the pickers moved to the RPC. It is a ROW FIELD now, in
+ * the one read every client shares.
+ */
+interface OrchestraBadge {
+    /** How the ensemble runs: `supervisor` | `sequential` | `parallel` | `dag`, or a future mode verbatim. */
+    mode: string;
+    /** The composition's one-line description, when its author wrote one. */
+    tagline: string | null;
+    /**
+     * The per-composition delegation-depth budget AS DECLARED, or `null` when
+     * the composition declares none. Deliberately NOT defaulted here: the
+     * platform's fallback ceiling is enforced by the server that runs the
+     * ensemble, and a badge that invented a number would be reporting a promise
+     * nobody made.
+     */
+    depthBudget: number | null;
+    /** Member edges. From the ROW count, so an unlabelled ensemble still counts. */
+    memberCount: number;
+    /** Only REAL role titles — an ensemble with unlabelled edges yields `[]`. */
+    memberTitles: string[];
+}
 /**
  * One `agx_get_list_full()` row, camelCased. Nineteen columns, no more:
  * anything richer needs a different read and is a different type.
@@ -55,6 +99,12 @@ interface AgentSummary {
     isOwner: boolean | null;
     accessLevel: AgentAccessLevel | null;
     sharedByEmail: string | null;
+    /**
+     * The Orchestra badge, or `null` for an ordinary agent. Strict: every row
+     * carries the key, so a surface reads `agent.orchestra` and never has to ask
+     * whether the column existed.
+     */
+    orchestra: OrchestraBadge | null;
     /**
      * Set only on a mandate default row — the key it resolved through, so a
      * host can tell "the default" from a stored agent without parsing the id.
@@ -62,6 +112,21 @@ interface AgentSummary {
     mandateKey?: string;
 }
 type AgentSortOption = "updated-desc" | "created-desc" | "name-asc" | "name-desc" | "category-asc";
+/**
+ * The sort choices a picker offers, in order. PURE DATA, so it lives in the
+ * pure entry: a server-reachable manifest reads it at module scope, and
+ * importing it from the client-stamped `./catalog/react` bundle dragged React
+ * into a server graph for the sake of five string pairs. `./catalog/react`
+ * re-exports it unchanged, so no consumer has to move.
+ *
+ * (Written "client-stamped", never with the literal directive: this comment is
+ * emitted into `dist/catalog/index.d.ts`, and the tarball canary rightly
+ * refuses that directive anywhere in a PURE entry.)
+ */
+declare const SORT_OPTIONS: {
+    value: AgentSortOption;
+    label: string;
+}[];
 /** Which ownership tab is active in the agent list. */
 type AgentTab = "mine" | "shared" | "all" | "system";
 /** Favorite filter. */
@@ -248,6 +313,18 @@ interface AgentCatalogSchemaReport {
     answered: string[];
     /** True when `agent.definition.is_favorite` is writable by this caller. */
     favoriteWritable: boolean | null;
+    /**
+     * Whether `agx_get_list_full` carries the `orchestra` badge column (added to
+     * the platform 2026-09-08).
+     *
+     * NOT a violation when absent — the picker degrades to no conductor marker,
+     * which is honest — but it is never SILENT either: a `false` here is the one
+     * signal that tells a host "this database predates the badge" instead of
+     * leaving someone to wonder why their Orchestra looks like a plain agent.
+     * `null` means the probe could not tell (the caller can see no agents at
+     * all), never "fine".
+     */
+    orchestraColumn: boolean | null;
 }
 interface AssertAgentCatalogSchemaOptions {
     /**
@@ -634,12 +711,8 @@ declare function AgentListInlinePicker({ consumerId, onSelect, activeAgentId, cl
  * catalog/react/types.ts — VERBATIM port of matrx-frontend
  * `features/agents/components/agent-listings/core/types.ts`.
  */
-
 type RightPanel = "detail" | "sort" | "categories" | "tags" | null;
-declare const SORT_OPTIONS: {
-    value: AgentSortOption;
-    label: string;
-}[];
+
 declare const PANEL_HEIGHT = "528px";
 /**
  * 🚨 THE PANEL NEVER OUTGROWS THE SPACE IT HAS.
@@ -805,4 +878,43 @@ declare function SidePanelHeader({ title, onClose, }: {
     onClose: () => void;
 }): react.JSX.Element;
 
-export { type AgentCatalogLinkComponent, AgentCatalogProvider, type AgentCatalogProviderProps, type AgentCatalogRenderModelRef, type AgentCatalogUiPorts, AgentCategoriesPanel, type AgentCategoriesPanelProps, AgentDetailCard, type AgentDetailCardProps, AgentFilterBar, type AgentFilterBarProps, AgentListContent, type AgentListContentProps, type AgentListCoreOptions, AgentListDropdown, type AgentListDropdownProps, AgentListInlinePicker, type AgentListInlinePickerProps, type AgentListTabCounts, AgentListTabs, AgentMobileSubView, type AgentMobileSubViewProps, AgentRow, type AgentRowProps, AgentSortPanel, type AgentSortPanelProps, AgentTagsPanel, type AgentTagsPanelProps, CheckRow, FavoriteAgentButton, FilterChip, HOVER_GRACE_MS, LIST_MAX_HEIGHT, OptionRow, PANEL_HEIGHT, type RightPanel, SORT_OPTIONS, SearchInput, SidePanelHeader, type UseAgentConsumerReturn, coerceVisibleTab, useAgentCatalog, useAgentCatalogRows, useAgentCatalogState, useAgentCatalogUiPorts, useAgentConsumer, useAgentListCore };
+type IconProps = SVGProps<SVGSVGElement> & {
+    className?: string;
+};
+/**
+ * The Orchestra marker (Lucide `music-4`): the glyph the Workflow Studio's
+ * picker used for a conductor, kept identical so the same agent wears the same
+ * mark in every client.
+ */
+declare function Music4Icon(props: IconProps): react.JSX.Element;
+
+/**
+ * catalog/orchestra.ts — @ai-matrx/agents/catalog
+ *
+ * Creator words for an Orchestra badge. A VERBATIM port of the helpers the
+ * Workflow Studio's hand-rolled picker carried (`apps/workflow-studio/src/
+ * hooks/use-agents.ts` before `c0f958b43`), lifted here so every client says
+ * the same sentence about the same ensemble.
+ *
+ * Pure — no React, no DOM. The row shape is `OrchestraBadge` in `./types`.
+ */
+
+declare function orchestraModeLabel(mode: string): string;
+/** Human label for a badge: "Orchestra · supervisor · 3 members" (singular-safe). */
+declare function orchestraLabel(badge: OrchestraBadge): string;
+/**
+ * The member-call ceiling in Creator language ("Team members can call helpers
+ * up to 2 levels deep"), or `null` when the composition declared none. A badge
+ * never invents the platform default: the server that runs the ensemble owns
+ * that number, and printing a promise nobody made is worse than printing
+ * nothing.
+ */
+declare function orchestraDepthLine(badge: OrchestraBadge): string | null;
+/**
+ * One visible line naming who the Orchestra delegates to, collapsing past
+ * `limit` into "+N more". `null` when no member carries a real role title —
+ * "Member, Member, Member" is noise that reads like data.
+ */
+declare function orchestraDelegatesLine(badge: OrchestraBadge, limit?: number): string | null;
+
+export { type AgentCatalogLinkComponent, AgentCatalogProvider, type AgentCatalogProviderProps, type AgentCatalogRenderModelRef, type AgentCatalogUiPorts, AgentCategoriesPanel, type AgentCategoriesPanelProps, AgentDetailCard, type AgentDetailCardProps, AgentFilterBar, type AgentFilterBarProps, AgentListContent, type AgentListContentProps, type AgentListCoreOptions, AgentListDropdown, type AgentListDropdownProps, AgentListInlinePicker, type AgentListInlinePickerProps, type AgentListTabCounts, AgentListTabs, AgentMobileSubView, type AgentMobileSubViewProps, AgentRow, type AgentRowProps, AgentSortPanel, type AgentSortPanelProps, AgentTagsPanel, type AgentTagsPanelProps, CheckRow, FavoriteAgentButton, FilterChip, HOVER_GRACE_MS, type IconProps, LIST_MAX_HEIGHT, Music4Icon, OptionRow, type OrchestraBadge, PANEL_HEIGHT, type RightPanel, SORT_OPTIONS, SearchInput, SidePanelHeader, type UseAgentConsumerReturn, coerceVisibleTab, orchestraDelegatesLine, orchestraDepthLine, orchestraLabel, orchestraModeLabel, useAgentCatalog, useAgentCatalogRows, useAgentCatalogState, useAgentCatalogUiPorts, useAgentConsumer, useAgentListCore };

package/dist/catalog/react/index.js

@@ -88,6 +88,13 @@ import { useCallback as useCallback2, useEffect, useRef, useState } from "react"
 function isMandateAgentId(id) {
   return id.startsWith("mandate:");
 }
+var SORT_OPTIONS = [
+  { value: "updated-desc", label: "Recent" },
+  { value: "created-desc", label: "Created" },
+  { value: "name-asc", label: "A \u2192 Z" },
+  { value: "name-desc", label: "Z \u2192 A" },
+  { value: "category-asc", label: "Category" }
+];
 var AGENT_NONE_SENTINEL = "__none__";
 var DEFAULT_AGENT_CONSUMER_STATE = {
   tab: "mine",
@@ -916,6 +923,14 @@ function AlertTriangleIcon(props) {
     /* @__PURE__ */ jsx2("path", { d: "M12 17h.01" })
   ] });
 }
+function Music4Icon(props) {
+  return /* @__PURE__ */ jsxs(Svg, { ...props, children: [
+    /* @__PURE__ */ jsx2("path", { d: "M9 18V5l12-2v13" }),
+    /* @__PURE__ */ jsx2("path", { d: "m9 9 12-2" }),
+    /* @__PURE__ */ jsx2("circle", { cx: "6", cy: "18", r: "3" }),
+    /* @__PURE__ */ jsx2("circle", { cx: "18", cy: "16", r: "3" })
+  ] });
+}
 
 // catalog/react/primitives.tsx
 import { jsx as jsx3, jsxs as jsxs2 } from "react/jsx-runtime";
@@ -1160,6 +1175,33 @@ function FavoriteAgentButton({
   );
 }
 
+// catalog/orchestra.ts
+var ORCHESTRA_MODE_LABEL = {
+  supervisor: "supervisor",
+  sequential: "in order",
+  parallel: "together",
+  dag: "custom flow"
+};
+function orchestraModeLabel(mode) {
+  return ORCHESTRA_MODE_LABEL[mode] ?? mode;
+}
+function orchestraLabel(badge) {
+  const n = badge.memberCount;
+  return `Orchestra \xB7 ${orchestraModeLabel(badge.mode)} \xB7 ${n} ${n === 1 ? "member" : "members"}`;
+}
+function orchestraDepthLine(badge) {
+  const n = badge.depthBudget;
+  if (typeof n !== "number" || n <= 0) return null;
+  return `Team members can call helpers up to ${n} ${n === 1 ? "level" : "levels"} deep`;
+}
+function orchestraDelegatesLine(badge, limit = 3) {
+  const titles = badge.memberTitles;
+  if (titles.length === 0) return null;
+  const shown = titles.slice(0, limit);
+  const extra = titles.length - shown.length;
+  return `Delegates to: ${shown.join(", ")}${extra > 0 ? ` +${extra} more` : ""}`;
+}
+
 // catalog/react/AgentDetailCard.tsx
 import { Fragment, jsx as jsx6, jsxs as jsxs4 } from "react/jsx-runtime";
 function AgentDetailCard({ agent, onSelect }) {
@@ -1186,6 +1228,22 @@ function AgentDetailCard({ agent, onSelect }) {
     ] }) }),
     /* @__PURE__ */ jsx6("div", { className: "h-px bg-border mx-3" }),
     /* @__PURE__ */ jsxs4("div", { className: "flex-1 overflow-y-auto px-4 py-3 space-y-3", children: [
+      agent.orchestra && /* @__PURE__ */ jsxs4("div", { className: "rounded-md border border-primary/20 bg-primary/5 px-2.5 py-2", children: [
+        /* @__PURE__ */ jsxs4("div", { className: "flex items-center gap-1.5", children: [
+          /* @__PURE__ */ jsx6(Music4Icon, { className: "w-3.5 h-3.5 text-primary shrink-0" }),
+          /* @__PURE__ */ jsx6("span", { className: "text-[11px] font-medium text-primary", children: orchestraLabel(agent.orchestra) })
+        ] }),
+        agent.orchestra.tagline && /* @__PURE__ */ jsx6("p", { className: "mt-1 text-xs text-foreground/80 leading-relaxed", children: agent.orchestra.tagline }),
+        orchestraDelegatesLine(agent.orchestra) && /* @__PURE__ */ jsx6(
+          "p",
+          {
+            className: "mt-1 text-[11px] text-muted-foreground",
+            title: `Delegates to: ${agent.orchestra.memberTitles.join(", ")}`,
+            children: orchestraDelegatesLine(agent.orchestra)
+          }
+        ),
+        orchestraDepthLine(agent.orchestra) && /* @__PURE__ */ jsx6("p", { className: "mt-0.5 text-[11px] text-muted-foreground", children: orchestraDepthLine(agent.orchestra) })
+      ] }),
       agent.description && /* @__PURE__ */ jsxs4("div", { children: [
         /* @__PURE__ */ jsx6("p", { className: "text-[11px] font-medium text-muted-foreground uppercase tracking-wider mb-1", children: "Description" }),
         /* @__PURE__ */ jsx6("p", { className: "text-xs text-foreground/80 leading-relaxed", children: agent.description })
@@ -1302,13 +1360,6 @@ var iconButtonClass = "flex items-center justify-center h-7 w-7 rounded-md borde
 import { useEffect as useEffect3, useRef as useRef3 } from "react";
 
 // catalog/react/types.ts
-var SORT_OPTIONS = [
-  { value: "updated-desc", label: "Recent" },
-  { value: "created-desc", label: "Created" },
-  { value: "name-asc", label: "A \u2192 Z" },
-  { value: "name-desc", label: "Z \u2192 A" },
-  { value: "category-asc", label: "Category" }
-];
 var PANEL_HEIGHT = "528px";
 var LIST_MAX_HEIGHT = "min(528px, var(--radix-popper-available-height, 528px))";
 
@@ -1486,6 +1537,17 @@ function AgentRow({
                   children: agent.name || "Untitled"
                 }
               ),
+              agent.orchestra && /* @__PURE__ */ jsxs7(
+                "span",
+                {
+                  className: "flex shrink-0 items-center gap-0.5 rounded-sm bg-primary/10 px-1 py-px text-[9px] font-medium text-primary",
+                  title: orchestraDelegatesLine(agent.orchestra) ?? orchestraLabel(agent.orchestra),
+                  children: [
+                    /* @__PURE__ */ jsx9(Music4Icon, { className: "w-2.5 h-2.5" }),
+                    agent.orchestra.memberCount
+                  ]
+                }
+              ),
               agent.agentType === "builtin" ? /* @__PURE__ */ jsx9("span", { className: "text-[9px] font-medium text-primary bg-primary/10 px-1 py-px rounded shrink-0 ml-auto", children: labels.systemBadge }) : agent.isOwner === false ? /* @__PURE__ */ jsx9("span", { className: "text-[9px] text-muted-foreground bg-muted px-1 py-px rounded shrink-0 ml-auto", children: "shared" }) : null
             ]
           }
@@ -2324,12 +2386,17 @@ export {
   FilterChip,
   HOVER_GRACE_MS,
   LIST_MAX_HEIGHT,
+  Music4Icon,
   OptionRow,
   PANEL_HEIGHT,
   SORT_OPTIONS,
   SearchInput,
   SidePanelHeader,
   coerceVisibleTab,
+  orchestraDelegatesLine,
+  orchestraDepthLine,
+  orchestraLabel,
+  orchestraModeLabel,
   useAgentCatalog,
   useAgentCatalogRows,
   useAgentCatalogState,