@ai-matrx/agents 0.7.1 → 0.9.0

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"])
   };
 }
 
@@ -317,6 +337,51 @@ function writeCachedDefaultRow(storage, resolved) {
   } catch {
   }
 }
+function parseCachedDefaultRow(mandateKey, raw) {
+  try {
+    if (!raw) return null;
+    const parsed = JSON.parse(raw);
+    if (!isRecord2(parsed)) return null;
+    const holderId = parsed["holderId"];
+    const holderName = parsed["holderName"];
+    if (typeof holderId !== "string" || typeof holderName !== "string") {
+      return null;
+    }
+    const description = parsed["holderDescription"];
+    const provenance = parsed["provenance"];
+    const at = parsed["at"];
+    return {
+      mandateKey,
+      holderId,
+      holderName,
+      holderDescription: typeof description === "string" ? description : null,
+      provenance: typeof provenance === "string" ? provenance : "system",
+      at: typeof at === "number" ? at : 0
+    };
+  } catch {
+    return null;
+  }
+}
+async function readCachedDefaultRowAsync(storage, mandateKey) {
+  let raw;
+  try {
+    raw = await storage.getItem(
+      CACHE_PREFIX + mandateKey
+    );
+  } catch {
+    return null;
+  }
+  return parseCachedDefaultRow(mandateKey, raw);
+}
+async function writeCachedDefaultRowAsync(storage, resolved) {
+  try {
+    await storage.setItem(
+      CACHE_PREFIX + resolved.mandateKey,
+      JSON.stringify(resolved)
+    );
+  } catch {
+  }
+}
 function defaultRowFromResolution(resolved) {
   return {
     id: mandateAgentId(resolved.mandateKey),
@@ -338,6 +403,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
   };
 }
@@ -353,7 +421,7 @@ function detectDefaultRowDrift(cached, live) {
 }
 async function resolveDefaultRow(args) {
   const { mandateKey, transport, client, storage, lookupRow } = args;
-  const cached = readCachedDefaultRow(storage, mandateKey);
+  const cached = await readCachedDefaultRowAsync(storage, mandateKey);
   const verdict = await askTheServer(transport, mandateKey);
   if (verdict.holderType !== "agent") {
     throw new MandateDefaultRowError({
@@ -390,7 +458,7 @@ async function resolveDefaultRow(args) {
     at: Date.now()
   };
   const drift = detectDefaultRowDrift(cached, resolved);
-  writeCachedDefaultRow(storage, resolved);
+  await writeCachedDefaultRowAsync(storage, resolved);
   return { resolved, row: defaultRowFromResolution(resolved), drift };
 }
 
@@ -442,10 +510,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 +557,8 @@ async function assertAgentCatalogSchema(client, options = {}) {
     missing,
     unreachable,
     answered,
-    favoriteWritable
+    favoriteWritable,
+    orchestraColumn
   };
   if (!ok && throwOnViolation) {
     const parts = [];
@@ -503,6 +576,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 +955,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 +1370,7 @@ export {
   DEFAULT_AGENT_CATALOG_LABELS,
   DEFAULT_AGENT_CONSUMER_STATE,
   MandateDefaultRowError,
+  SORT_OPTIONS,
   _resetCatalogGlobalState,
   agentConsumerHasActiveFilters,
   agentListEmptyLabel,
@@ -1295,9 +1402,14 @@ export {
   memoize1,
   memoize2,
   memoize3,
+  orchestraDelegatesLine,
+  orchestraDepthLine,
+  orchestraLabel,
+  orchestraModeLabel,
   parseMandateResolution,
   readAgentCatalogRows,
   readCachedDefaultRow,
+  readCachedDefaultRowAsync,
   readSingleAgentRow,
   resolveDefaultRow,
   searchAgentsOnServer,
@@ -1316,6 +1428,7 @@ export {
   sortFilteredAgents,
   toAgentSummary,
   writeAgentFavorite,
-  writeCachedDefaultRow
+  writeCachedDefaultRow,
+  writeCachedDefaultRowAsync
 };
 //# sourceMappingURL=index.js.map