@ai-matrx/agents 0.7.0 → 0.8.0

package/dist/catalog/index.d.cts

@@ -16,9 +16,20 @@
  * 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";
 };
 /** Brand a raw string as an `AgentId`. */
 declare function asAgentId(value: string): AgentId;
@@ -34,6 +45,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.
@@ -58,6 +102,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.
@@ -65,6 +115,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. */
@@ -402,6 +467,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 {
     /**
@@ -582,9 +659,14 @@ declare function writeAgentFavorite(client: AgentCatalogClient, agentId: string,
  * catalog/rows.ts — @ai-matrx/agents/catalog
  *
  * The ONE ingress for a database row. `agx_get_list_full()` and `agx_search()`
- * return the same 19 columns (search adds two ranking columns), so both come
+ * return the same list columns (search adds two ranking columns), so both come
  * through here and produce the identical `AgentSummary`.
  *
+ * UNKNOWN COLUMNS ARE IGNORED, BY DESIGN. Every column is read by NAME, so an
+ * additive platform migration (the way `orchestra` arrived) reaches consumers
+ * on `latest` without a package release, and an older database simply yields
+ * `null` for a column it does not have yet.
+ *
  * Typed over `unknown` on purpose: the truth of this boundary is a
  * HOST-generated Supabase type this package cannot see (the `@ai-matrx/data`
  * 0.2.1 lesson). Narrowing happens here, once, loudly — a row that is not an
@@ -598,6 +680,35 @@ declare function writeAgentFavorite(client: AgentCatalogClient, agentId: string,
  */
 declare function toAgentSummary(raw: unknown): AgentSummary | null;
 
+/**
+ * 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;
+
 /**
  * catalog/default-row.ts — @ai-matrx/agents/catalog
  *
@@ -854,4 +965,4 @@ declare const selectTotalFavoriteAgentsCount: (a: readonly AgentSummary[]) => nu
 /** @internal Test-only: forget every session-shared value. */
 declare function _resetCatalogGlobalState(): void;
 
-export { AGENT_CARDS_LIMIT_DESKTOP, AGENT_CARDS_LIMIT_MOBILE, AGENT_LIST_ITEMS_PER_PAGE, AGENT_NONE_SENTINEL, AGENT_SEARCH_LIMIT, type AgentAccessFilter, type AgentAccessLevel, type AgentArchFilter, type AgentCatalog, type AgentCatalogAgentType, type AgentCatalogClient, type AgentCatalogConfig, AgentCatalogConfigError, type AgentCatalogErrorSink, type AgentCatalogIdentity, type AgentCatalogLabels, type AgentCatalogNavigate, type AgentCatalogNotifier, type AgentCatalogOpenPeek, AgentCatalogReadError, type AgentCatalogResolveHref, type AgentCatalogRpcCall, type AgentCatalogSchemaReport, type AgentCatalogState, type AgentCatalogStatus, type AgentCatalogStorage, type AgentCatalogTableQuery, type AgentCatalogTransport, type AgentConsumerPatch, type AgentConsumerState, type AgentFavFilter, type AgentId, type AgentListPage, type AgentSearchable, type AgentServerSearchResult, type AgentSortOption, type AgentSummary, type AgentTab, type AssertAgentCatalogSchemaOptions, DEFAULT_AGENT_CATALOG_LABELS, DEFAULT_AGENT_CONSUMER_STATE, type DefaultRowState, MandateDefaultRowError, type MandateResolutionVerdict, type PgErrorLike, type PgResultLike, type ResolveDefaultRowArgs, type ResolveDefaultRowOutcome, type ResolvedDefaultRow, _resetCatalogGlobalState, agentConsumerHasActiveFilters, agentListEmptyLabel, agentMatchesSearch, applyAgentSortComparator, asAgentId, assertAgentCatalogSchema, computeAgentSearchScore, createAgentCatalog, createMemoryStorage, defaultRowFromResolution, defaultStorage, detectDefaultRowDrift, filterBuiltinTypeAgents, filterUserTypeAgents, getRegisteredAgentCatalog, isMandateAgentId, makeSelectFilteredAgents, makeSelectFilteredAgentsCount, makeSelectFilteredBuiltinAgents, makeSelectFilteredBuiltinAgentsCount, makeSelectFilteredOwnedAgents, makeSelectFilteredSharedAgents, makeSelectOwnedAgentCards, makeSelectOwnedAgentListItems, makeSelectSharedAgentCards, makeSelectSharedAgentListItems, mandateAgentId, memoize1, memoize2, memoize3, parseMandateResolution, readAgentCatalogRows, readCachedDefaultRow, readSingleAgentRow, resolveDefaultRow, searchAgentsOnServer, selectAllAgentCategories, selectAllAgentTags, selectAllSystemAgentCategories, selectAllSystemAgentTags, selectBuiltinTypeAgents, selectTotalBuiltinAgentsCount, selectTotalFavoriteAgentsCount, selectTotalOwnedAgentsCount, selectTotalSharedAgentsCount, selectTotalUserAgentsCount, selectUserTypeAgents, shouldDefaultAgentListToPublicTab, sortFilteredAgents, toAgentSummary, writeAgentFavorite, writeCachedDefaultRow };
+export { AGENT_CARDS_LIMIT_DESKTOP, AGENT_CARDS_LIMIT_MOBILE, AGENT_LIST_ITEMS_PER_PAGE, AGENT_NONE_SENTINEL, AGENT_SEARCH_LIMIT, type AgentAccessFilter, type AgentAccessLevel, type AgentArchFilter, type AgentCatalog, type AgentCatalogAgentType, type AgentCatalogClient, type AgentCatalogConfig, AgentCatalogConfigError, type AgentCatalogErrorSink, type AgentCatalogIdentity, type AgentCatalogLabels, type AgentCatalogNavigate, type AgentCatalogNotifier, type AgentCatalogOpenPeek, AgentCatalogReadError, type AgentCatalogResolveHref, type AgentCatalogRpcCall, type AgentCatalogSchemaReport, type AgentCatalogState, type AgentCatalogStatus, type AgentCatalogStorage, type AgentCatalogTableQuery, type AgentCatalogTransport, type AgentConsumerPatch, type AgentConsumerState, type AgentFavFilter, type AgentId, type AgentListPage, type AgentSearchable, type AgentServerSearchResult, type AgentSortOption, type AgentSummary, type AgentTab, type AssertAgentCatalogSchemaOptions, DEFAULT_AGENT_CATALOG_LABELS, DEFAULT_AGENT_CONSUMER_STATE, type DefaultRowState, MandateDefaultRowError, type MandateResolutionVerdict, type OrchestraBadge, type PgErrorLike, type PgResultLike, type ResolveDefaultRowArgs, type ResolveDefaultRowOutcome, type ResolvedDefaultRow, SORT_OPTIONS, _resetCatalogGlobalState, agentConsumerHasActiveFilters, agentListEmptyLabel, agentMatchesSearch, applyAgentSortComparator, asAgentId, assertAgentCatalogSchema, computeAgentSearchScore, createAgentCatalog, createMemoryStorage, defaultRowFromResolution, defaultStorage, detectDefaultRowDrift, filterBuiltinTypeAgents, filterUserTypeAgents, getRegisteredAgentCatalog, isMandateAgentId, makeSelectFilteredAgents, makeSelectFilteredAgentsCount, makeSelectFilteredBuiltinAgents, makeSelectFilteredBuiltinAgentsCount, makeSelectFilteredOwnedAgents, makeSelectFilteredSharedAgents, makeSelectOwnedAgentCards, makeSelectOwnedAgentListItems, makeSelectSharedAgentCards, makeSelectSharedAgentListItems, mandateAgentId, memoize1, memoize2, memoize3, orchestraDelegatesLine, orchestraDepthLine, orchestraLabel, orchestraModeLabel, parseMandateResolution, readAgentCatalogRows, readCachedDefaultRow, readSingleAgentRow, resolveDefaultRow, searchAgentsOnServer, selectAllAgentCategories, selectAllAgentTags, selectAllSystemAgentCategories, selectAllSystemAgentTags, selectBuiltinTypeAgents, selectTotalBuiltinAgentsCount, selectTotalFavoriteAgentsCount, selectTotalOwnedAgentsCount, selectTotalSharedAgentsCount, selectTotalUserAgentsCount, selectUserTypeAgents, shouldDefaultAgentListToPublicTab, sortFilteredAgents, toAgentSummary, writeAgentFavorite, writeCachedDefaultRow };

package/dist/catalog/index.d.ts

@@ -16,9 +16,20 @@
  * 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";
 };
 /** Brand a raw string as an `AgentId`. */
 declare function asAgentId(value: string): AgentId;
@@ -34,6 +45,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.
@@ -58,6 +102,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.
@@ -65,6 +115,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. */
@@ -402,6 +467,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 {
     /**
@@ -582,9 +659,14 @@ declare function writeAgentFavorite(client: AgentCatalogClient, agentId: string,
  * catalog/rows.ts — @ai-matrx/agents/catalog
  *
  * The ONE ingress for a database row. `agx_get_list_full()` and `agx_search()`
- * return the same 19 columns (search adds two ranking columns), so both come
+ * return the same list columns (search adds two ranking columns), so both come
  * through here and produce the identical `AgentSummary`.
  *
+ * UNKNOWN COLUMNS ARE IGNORED, BY DESIGN. Every column is read by NAME, so an
+ * additive platform migration (the way `orchestra` arrived) reaches consumers
+ * on `latest` without a package release, and an older database simply yields
+ * `null` for a column it does not have yet.
+ *
  * Typed over `unknown` on purpose: the truth of this boundary is a
  * HOST-generated Supabase type this package cannot see (the `@ai-matrx/data`
  * 0.2.1 lesson). Narrowing happens here, once, loudly — a row that is not an
@@ -598,6 +680,35 @@ declare function writeAgentFavorite(client: AgentCatalogClient, agentId: string,
  */
 declare function toAgentSummary(raw: unknown): AgentSummary | null;
 
+/**
+ * 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;
+
 /**
  * catalog/default-row.ts — @ai-matrx/agents/catalog
  *
@@ -854,4 +965,4 @@ declare const selectTotalFavoriteAgentsCount: (a: readonly AgentSummary[]) => nu
 /** @internal Test-only: forget every session-shared value. */
 declare function _resetCatalogGlobalState(): void;
 
-export { AGENT_CARDS_LIMIT_DESKTOP, AGENT_CARDS_LIMIT_MOBILE, AGENT_LIST_ITEMS_PER_PAGE, AGENT_NONE_SENTINEL, AGENT_SEARCH_LIMIT, type AgentAccessFilter, type AgentAccessLevel, type AgentArchFilter, type AgentCatalog, type AgentCatalogAgentType, type AgentCatalogClient, type AgentCatalogConfig, AgentCatalogConfigError, type AgentCatalogErrorSink, type AgentCatalogIdentity, type AgentCatalogLabels, type AgentCatalogNavigate, type AgentCatalogNotifier, type AgentCatalogOpenPeek, AgentCatalogReadError, type AgentCatalogResolveHref, type AgentCatalogRpcCall, type AgentCatalogSchemaReport, type AgentCatalogState, type AgentCatalogStatus, type AgentCatalogStorage, type AgentCatalogTableQuery, type AgentCatalogTransport, type AgentConsumerPatch, type AgentConsumerState, type AgentFavFilter, type AgentId, type AgentListPage, type AgentSearchable, type AgentServerSearchResult, type AgentSortOption, type AgentSummary, type AgentTab, type AssertAgentCatalogSchemaOptions, DEFAULT_AGENT_CATALOG_LABELS, DEFAULT_AGENT_CONSUMER_STATE, type DefaultRowState, MandateDefaultRowError, type MandateResolutionVerdict, type PgErrorLike, type PgResultLike, type ResolveDefaultRowArgs, type ResolveDefaultRowOutcome, type ResolvedDefaultRow, _resetCatalogGlobalState, agentConsumerHasActiveFilters, agentListEmptyLabel, agentMatchesSearch, applyAgentSortComparator, asAgentId, assertAgentCatalogSchema, computeAgentSearchScore, createAgentCatalog, createMemoryStorage, defaultRowFromResolution, defaultStorage, detectDefaultRowDrift, filterBuiltinTypeAgents, filterUserTypeAgents, getRegisteredAgentCatalog, isMandateAgentId, makeSelectFilteredAgents, makeSelectFilteredAgentsCount, makeSelectFilteredBuiltinAgents, makeSelectFilteredBuiltinAgentsCount, makeSelectFilteredOwnedAgents, makeSelectFilteredSharedAgents, makeSelectOwnedAgentCards, makeSelectOwnedAgentListItems, makeSelectSharedAgentCards, makeSelectSharedAgentListItems, mandateAgentId, memoize1, memoize2, memoize3, parseMandateResolution, readAgentCatalogRows, readCachedDefaultRow, readSingleAgentRow, resolveDefaultRow, searchAgentsOnServer, selectAllAgentCategories, selectAllAgentTags, selectAllSystemAgentCategories, selectAllSystemAgentTags, selectBuiltinTypeAgents, selectTotalBuiltinAgentsCount, selectTotalFavoriteAgentsCount, selectTotalOwnedAgentsCount, selectTotalSharedAgentsCount, selectTotalUserAgentsCount, selectUserTypeAgents, shouldDefaultAgentListToPublicTab, sortFilteredAgents, toAgentSummary, writeAgentFavorite, writeCachedDefaultRow };
+export { AGENT_CARDS_LIMIT_DESKTOP, AGENT_CARDS_LIMIT_MOBILE, AGENT_LIST_ITEMS_PER_PAGE, AGENT_NONE_SENTINEL, AGENT_SEARCH_LIMIT, type AgentAccessFilter, type AgentAccessLevel, type AgentArchFilter, type AgentCatalog, type AgentCatalogAgentType, type AgentCatalogClient, type AgentCatalogConfig, AgentCatalogConfigError, type AgentCatalogErrorSink, type AgentCatalogIdentity, type AgentCatalogLabels, type AgentCatalogNavigate, type AgentCatalogNotifier, type AgentCatalogOpenPeek, AgentCatalogReadError, type AgentCatalogResolveHref, type AgentCatalogRpcCall, type AgentCatalogSchemaReport, type AgentCatalogState, type AgentCatalogStatus, type AgentCatalogStorage, type AgentCatalogTableQuery, type AgentCatalogTransport, type AgentConsumerPatch, type AgentConsumerState, type AgentFavFilter, type AgentId, type AgentListPage, type AgentSearchable, type AgentServerSearchResult, type AgentSortOption, type AgentSummary, type AgentTab, type AssertAgentCatalogSchemaOptions, DEFAULT_AGENT_CATALOG_LABELS, DEFAULT_AGENT_CONSUMER_STATE, type DefaultRowState, MandateDefaultRowError, type MandateResolutionVerdict, type OrchestraBadge, type PgErrorLike, type PgResultLike, type ResolveDefaultRowArgs, type ResolveDefaultRowOutcome, type ResolvedDefaultRow, SORT_OPTIONS, _resetCatalogGlobalState, agentConsumerHasActiveFilters, agentListEmptyLabel, agentMatchesSearch, applyAgentSortComparator, asAgentId, assertAgentCatalogSchema, computeAgentSearchScore, createAgentCatalog, createMemoryStorage, defaultRowFromResolution, defaultStorage, detectDefaultRowDrift, filterBuiltinTypeAgents, filterUserTypeAgents, getRegisteredAgentCatalog, isMandateAgentId, makeSelectFilteredAgents, makeSelectFilteredAgentsCount, makeSelectFilteredBuiltinAgents, makeSelectFilteredBuiltinAgentsCount, makeSelectFilteredOwnedAgents, makeSelectFilteredSharedAgents, makeSelectOwnedAgentCards, makeSelectOwnedAgentListItems, makeSelectSharedAgentCards, makeSelectSharedAgentListItems, mandateAgentId, memoize1, memoize2, memoize3, orchestraDelegatesLine, orchestraDepthLine, orchestraLabel, orchestraModeLabel, parseMandateResolution, readAgentCatalogRows, readCachedDefaultRow, readSingleAgentRow, resolveDefaultRow, searchAgentsOnServer, selectAllAgentCategories, selectAllAgentTags, selectAllSystemAgentCategories, selectAllSystemAgentTags, selectBuiltinTypeAgents, selectTotalBuiltinAgentsCount, selectTotalFavoriteAgentsCount, selectTotalOwnedAgentsCount, selectTotalSharedAgentsCount, selectTotalUserAgentsCount, selectUserTypeAgents, shouldDefaultAgentListToPublicTab, sortFilteredAgents, toAgentSummary, writeAgentFavorite, writeCachedDefaultRow };

package/dist/catalog/index.js

@@ -8,6 +8,13 @@ function mandateAgentId(mandateKey) {
 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",
@@ -77,6 +84,18 @@ function stringArray(value) {
 function agentType(value) {
   return value === "builtin" ? "builtin" : "user";
 }
+function orchestraBadge(value) {
+  if (!isRecord(value)) return null;
+  const depth = value["depth_budget"];
+  const count = value["member_count"];
+  return {
+    mode: str(value["mode"]) ?? "supervisor",
+    tagline: str(value["tagline"]),
+    depthBudget: typeof depth === "number" && Number.isFinite(depth) && depth > 0 ? depth : null,
+    memberCount: typeof count === "number" && Number.isFinite(count) && count >= 0 ? count : 0,
+    memberTitles: stringArray(value["member_titles"])
+  };
+}
 function toAgentSummary(raw) {
   if (!isRecord(raw)) return null;
   const id = str(raw["id"]);
@@ -100,7 +119,8 @@ function toAgentSummary(raw) {
     updatedAt: str(raw["updated_at"]),
     isOwner: boolOrNull(raw["is_owner"]),
     accessLevel: str(raw["access_level"]),
-    sharedByEmail: str(raw["shared_by_email"])
+    sharedByEmail: str(raw["shared_by_email"]),
+    orchestra: orchestraBadge(raw["orchestra"])
   };
 }
 
@@ -338,6 +358,9 @@ function defaultRowFromResolution(resolved) {
     isOwner: null,
     accessLevel: null,
     sharedByEmail: null,
+    // A mandate default row is a live reference to whichever agent the mandate
+    // resolves to; the badge belongs to the RESOLVED agent's own catalog row.
+    orchestra: null,
     mandateKey: resolved.mandateKey
   };
 }
@@ -442,10 +465,14 @@ async function assertAgentCatalogSchema(client, options = {}) {
   const missing = [];
   const unreachable = [];
   const answered = [];
+  let orchestraColumn = null;
   for (const fn of names) {
     const args = DEMANDED_RPCS[fn] ?? {};
     try {
-      const { error } = await client.rpc(fn, args);
+      const { data, error } = await client.rpc(fn, args);
+      if (fn === "agx_get_list_full" && error == null) {
+        orchestraColumn = readsOrchestraColumn(data);
+      }
       if (error == null) answered.push(fn);
       else if (isMissingFunctionError(error)) missing.push(fn);
       else answered.push(fn);
@@ -485,7 +512,8 @@ async function assertAgentCatalogSchema(client, options = {}) {
     missing,
     unreachable,
     answered,
-    favoriteWritable
+    favoriteWritable,
+    orchestraColumn
   };
   if (!ok && throwOnViolation) {
     const parts = [];
@@ -503,6 +531,12 @@ async function assertAgentCatalogSchema(client, options = {}) {
   }
   return report;
 }
+function readsOrchestraColumn(data) {
+  if (!Array.isArray(data) || data.length === 0) return null;
+  return data.some(
+    (row) => typeof row === "object" && row !== null && Object.prototype.hasOwnProperty.call(row, "orchestra")
+  );
+}
 function isPermissionRefusal(error) {
   if (!error) return false;
   const code = error.code;
@@ -876,6 +910,33 @@ function getRegisteredAgentCatalog(catalogId = "default") {
   return found;
 }
 
+// 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/labels.ts
 function agentListEmptyLabel(tab, labels) {
   switch (tab) {
@@ -1264,6 +1325,7 @@ export {
   DEFAULT_AGENT_CATALOG_LABELS,
   DEFAULT_AGENT_CONSUMER_STATE,
   MandateDefaultRowError,
+  SORT_OPTIONS,
   _resetCatalogGlobalState,
   agentConsumerHasActiveFilters,
   agentListEmptyLabel,
@@ -1295,6 +1357,10 @@ export {
   memoize1,
   memoize2,
   memoize3,
+  orchestraDelegatesLine,
+  orchestraDepthLine,
+  orchestraLabel,
+  orchestraModeLabel,
   parseMandateResolution,
   readAgentCatalogRows,
   readCachedDefaultRow,