@truefoundry/trueforge-ui 0.3.0-rc.5 → 0.3.0-rc.7

package/dist/index.d.ts

@@ -592,7 +592,7 @@ type AgentOverviewProps = {
 };
 type AgentOverviewCardProps = {
     title: string;
-    icon: string;
+    icon?: string;
     count?: number;
     children: ReactNode;
 };
@@ -1504,15 +1504,16 @@ declare module '../theme/SlotsProvider.js' {
 type SaveAgentFormProps = {
     intent: 'create' | 'update';
     name: string;
+    description: string;
     spec: AgentSpec;
     saving: boolean;
     error: string | null;
     onNameChange: (name: string) => void;
-    onChange: (spec: AgentSpec) => void;
+    onDescriptionChange: (description: string) => void;
     onCancel: () => void;
     onSave: () => void;
 };
-declare function SaveAgentForm({ intent, name, spec, saving, error, onNameChange, onCancel, onSave, }: SaveAgentFormProps): react.JSX.Element;
+declare function SaveAgentForm({ intent, name, description, spec, saving, error, onNameChange, onDescriptionChange, onCancel, onSave, }: SaveAgentFormProps): react.JSX.Element;
 declare module '../theme/SlotsProvider.js' {
     interface AtomSlots {
         SaveAgentForm: typeof SaveAgentForm;
@@ -2044,6 +2045,7 @@ type IconButtonProps = Omit<ButtonProps, 'size' | 'children'> & {
     children: react__default.ReactNode;
 };
 
+type MenuPlacement = 'top' | 'bottom';
 type PopoverSelectOption<T extends string> = {
     value: T;
     label: string;
@@ -2055,8 +2057,8 @@ type CommonPopoverSelectProps<T extends string> = {
     disabled?: boolean;
     className?: string;
     menuClassName?: string;
-    /** Which edge of the trigger the menu opens toward. Default `bottom`. */
-    menuPlacement?: 'top' | 'bottom';
+    /** Preferred open edge; flips when that side lacks room. Default `bottom`. */
+    menuPlacement?: MenuPlacement;
     /** When set, renders a labeled chip trigger (label | value chip + chevron). */
     prefix?: string;
     emptyContent?: ReactNode;
@@ -2084,6 +2086,7 @@ type DropdownMenuProps = {
     open?: boolean;
     onOpenChange?: (open: boolean) => void;
     closeOnClick?: boolean;
+    lockScroll?: boolean;
 };
 
 type ResponsiveDropdownTriggerProps = {
@@ -2204,16 +2207,13 @@ type ScheduleFormFieldsProps = {
     values: ScheduleFormValues;
     onChange: (next: ScheduleFormValues) => void;
     agentId: string;
+    agentLabel: string;
     onAgentIdChange?: (agentId: string) => void;
-    agentOptions: Array<{
-        agentId: string;
-        name: string;
-    }>;
-    agentOptionsLoaded?: boolean;
+    onAgentPicked?: (agent: AgentLibraryEntry) => void;
     agentPickerDisabled?: boolean;
     onBuildAgent?: () => void;
 };
-declare function ScheduleFormFields({ values, onChange, agentId, onAgentIdChange, agentOptions, agentOptionsLoaded, agentPickerDisabled, onBuildAgent, }: ScheduleFormFieldsProps): react.JSX.Element;
+declare function ScheduleFormFields({ values, onChange, agentId, agentLabel, onAgentIdChange, onAgentPicked, agentPickerDisabled, onBuildAgent, }: ScheduleFormFieldsProps): react.JSX.Element;
 
 declare function ScheduleLastRunsCell({ runs }: {
     runs: readonly ScheduleRun[];
@@ -2417,6 +2417,8 @@ type ShellMode = {
     agentId?: string;
     /** Display / welcome label (often same as agentId). */
     agentName?: string;
+    /** Published-agent description, kept outside the executable agent spec. */
+    description?: string;
     /** Seed for mutable (draft) runtime. */
     agentSpec?: AgentSpec;
     locked: boolean;
@@ -2430,6 +2432,7 @@ type SelectLibraryAgentRequest = {
     isCreateAgent?: boolean;
     agentId?: string;
     agentName?: string;
+    description?: string;
     agentSpec?: AgentSpec;
 };
 type SettingsSection = 'models' | 'connectors' | 'skills' | 'sandbox';
@@ -2477,6 +2480,7 @@ type ShellModeContextValue = {
     bindMutableAgent: (req: {
         agentId: string;
         agentName: string;
+        description?: string;
         agentSpec: AgentSpec;
     }) => void;
     /** @deprecated Prefer `selectLibraryAgent({ isMutable: false, agentName })`. */

package/dist/index.js

@@ -1,7 +1,7 @@
 "use client";
 import {
   ThreadListContainer
-} from "./chunk-TFFTZB26.js";
+} from "./chunk-E33DFTVN.js";
 import {
   ApprovalNavContainer,
   AskUserContainer,
@@ -16,12 +16,12 @@ import {
   threadHasPendingMcpAuth,
   useApprovalNav,
   useComposerPauseView
-} from "./chunk-ERIIJKJY.js";
+} from "./chunk-F7YRYFAF.js";
 import {
   ServerInitLoader,
   TrueForgeUIShell,
   TrueFoundryChatProvider
-} from "./chunk-INY3J2BV.js";
+} from "./chunk-OWXPMQ7N.js";
 import "./chunk-DJUFS2BW.js";
 import {
   ComposerBusyProvider,
@@ -31,7 +31,7 @@ import {
 } from "./chunk-BSIPI3KV.js";
 import {
   AgentMetricChart
-} from "./chunk-IVDIBAVH.js";
+} from "./chunk-L7HNKKS2.js";
 import {
   createTrueFoundryServer
 } from "./chunk-7AAO4UDQ.js";
@@ -50,7 +50,7 @@ import {
   ScheduleStatusBadge,
   SchedulesPage,
   TestScheduleScreen
-} from "./chunk-DCVKW445.js";
+} from "./chunk-TMIILLHB.js";
 import {
   AgentCodeBlock,
   AgentConfigEditors,
@@ -192,14 +192,14 @@ import {
   useThemeMode,
   useToaster,
   useToasterOptional
-} from "./chunk-MMU55KCW.js";
-import "./chunk-3QWUHGNL.js";
+} from "./chunk-XANC4F2H.js";
+import "./chunk-T6QQV5LK.js";
 import {
   DraftCatalogProvider,
   Icon,
   registerIcons,
   useDraftCatalog
-} from "./chunk-IIHJ32YH.js";
+} from "./chunk-3ZW74FHC.js";
 import {
   DEFAULT_AGENT_CONFIG,
   ServerProvider,
@@ -222,14 +222,14 @@ import {
   useServer,
   useServerCapabilities,
   useShellMode
-} from "./chunk-TAABBM7F.js";
+} from "./chunk-2GIZY3JJ.js";
 import {
   useAui,
   useAuiState
 } from "./chunk-M6MHLVSO.js";
 import {
   OpenUiFenceBlock
-} from "./chunk-CFGLAGWH.js";
+} from "./chunk-CG75X77Q.js";
 import {
   PRESETS,
   ThemeProvider,
@@ -239,7 +239,7 @@ import {
   useOptionalContentClassNames,
   useTheme,
   useThemeIcons
-} from "./chunk-OWDH67NY.js";
+} from "./chunk-JCL3Q7RW.js";
 
 // src/icons/agent-2.svg
 import * as React from "react";
@@ -440,7 +440,7 @@ function ToolGroupContainer({ children, group }) {
 import { lazy, Suspense } from "react";
 import { jsx as jsx12 } from "react/jsx-runtime";
 var TrueForgeUIWithRouter = lazy(
-  () => import("./TrueForgeUIWithRouter-R3UXQZRY.js").then((m) => ({ default: m.TrueForgeUIWithRouter }))
+  () => import("./TrueForgeUIWithRouter-5OJFI3PF.js").then((m) => ({ default: m.TrueForgeUIWithRouter }))
 );
 function TrueForgeUI(props) {
   const isMcpAuthScreen = typeof window !== "undefined" && new URLSearchParams(window.location.search).get("screenType") === "mcp-auth";

package/dist/plugins/trueforge-agent-server-adapter/index.d.ts

@@ -264,7 +264,6 @@ interface AgentSpec<TModel extends Model = Model, TSkill extends SkillMount = Sk
     config?: TConfig;
     instructions?: string;
     variables?: Record<string, string>;
-    description?: string;
 }
 interface ListResult<T> {
     data: T[];
@@ -655,6 +654,8 @@ interface AgentDetail<TSpec extends AgentSpec = AgentSpec> {
     agentId: string;
     /** Display name (e.g. "release-notes-writer"). */
     name: string;
+    /** Published-agent description; not part of the executable agent spec. */
+    description?: string;
     agentSpec: TSpec;
 }
 /** Stream vs non-stream bodies for one language on the Use In Code tab. */

package/dist/plugins/trueforge-agent-server-adapter/index.js

@@ -344,6 +344,7 @@ function createHarnessAgentSessionsServer(options = {}) {
       return {
         agentId: data.id,
         name: data.name,
+        description: data.description,
         agentSpec: toUiAgentSpec(data.manifest)
       };
     },
@@ -377,6 +378,43 @@ function createHarnessAgentSessionsServer(options = {}) {
   };
 }
 
+// src/plugins/trueforge-agent-server-adapter/agentsList.ts
+var AGENTS_PAGE_DEFAULT = 50;
+var AGENTS_PAGE_LIMIT = 100;
+function clampAgentsPageSize(size) {
+  return Math.min(Math.max(size, 1), AGENTS_PAGE_LIMIT);
+}
+async function listAgentsPage({
+  client,
+  limit,
+  offset = 0,
+  agentName
+}) {
+  const pageSize = clampAgentsPageSize(limit);
+  const start = Math.max(0, offset);
+  const page = await client.agents.list({
+    limit: pageSize,
+    ...agentName === void 0 ? {} : { agentName }
+  });
+  let at = 0;
+  while (at < start) {
+    if (!page.hasNextPage()) return [];
+    await page.getNextPage();
+    at += pageSize;
+  }
+  return [...page.data];
+}
+async function drainAgentsList(client) {
+  const items = [];
+  const page = await client.agents.list({ limit: AGENTS_PAGE_DEFAULT });
+  for (; ; ) {
+    items.push(...page.data);
+    if (!page.hasNextPage()) break;
+    await page.getNextPage();
+  }
+  return items;
+}
+
 // src/plugins/trueforge-agent-server-adapter/catalogs/connectorCatalog.ts
 var DEFAULT_API_KEY_HEADER = "Authorization";
 function toUiAuthPublic(auth) {
@@ -619,6 +657,7 @@ function toLibraryEntry(agent) {
   return {
     name: agent.name,
     agentId: agent.id,
+    description: agent.description,
     agentSpec: toUiAgentSpec(agent.manifest),
     createdBySubject: agent.createdBySubject
   };
@@ -675,30 +714,42 @@ function createHarnessBuilderServer(options = {}) {
       );
     },
     async searchAgents(req) {
-      const { data } = await client.agents.list();
-      const query = req?.query?.trim().toLowerCase();
-      const filtered = query === void 0 || query === "" ? data : data.filter((agent) => agent.name.toLowerCase().includes(query));
+      const limit = clampAgentsPageSize(req?.limit ?? AGENTS_PAGE_DEFAULT);
       const offset = req?.offset ?? 0;
-      const limit = req?.limit ?? 50;
-      return filtered.slice(offset, offset + limit).map(toLibraryEntry);
+      const query = req?.query?.trim();
+      const rows = await listAgentsPage({
+        client,
+        limit,
+        offset,
+        ...query === void 0 || query === "" ? {} : { agentName: query }
+      });
+      return rows.map(toLibraryEntry);
     },
-    async saveAgent({ agentName, agentSpec, intent }) {
+    async saveAgent({ agentName, description: descriptionRaw, agentSpec, intent }) {
       const manifest = toHarnessAgentSpec(agentSpec);
+      const description = descriptionRaw?.trim();
       if (intent === "update") {
-        const { data } = await client.agents.list();
-        const existing = data.find((agent) => agent.name === agentName);
+        const agents = await drainAgentsList(client);
+        const existing = agents.find((agent) => agent.name === agentName);
         if (!existing) {
           return {};
         }
-        await client.agents.update(existing.id, { manifest });
+        await client.agents.update(existing.id, {
+          ...description ? { description } : {},
+          manifest
+        });
         return { agentId: existing.id };
       }
-      const created = await client.agents.create({ name: agentName, manifest });
+      const created = await client.agents.create({
+        name: agentName,
+        description: description || agentName,
+        manifest
+      });
       return { agentId: created.data.id };
     },
     async deleteAgent({ agentName }) {
-      const { data } = await client.agents.list();
-      const existing = data.find((agent) => agent.name === agentName);
+      const agents = await drainAgentsList(client);
+      const existing = agents.find((agent) => agent.name === agentName);
       if (!existing) return;
       await client.agents.delete(existing.id);
     }
@@ -1043,10 +1094,10 @@ function createHarnessPermissionsServer(options = {}) {
 // src/plugins/trueforge-agent-server-adapter/schedules/scheduleServer.ts
 var SCHEDULES_PAGE_LIMIT = 25;
 async function loadAgentIndex(client) {
-  const { data } = await client.agents.list();
+  const agents = await drainAgentsList(client);
   const idToName = /* @__PURE__ */ new Map();
   const nameToId = /* @__PURE__ */ new Map();
-  for (const agent of data) {
+  for (const agent of agents) {
     idToName.set(agent.id, agent.name);
     nameToId.set(agent.name, agent.id);
   }