The open-source agent harness - the runtime layer that turns an LLM into a working agent.
feat(agents): Support agent description
Bhavesh Patel8c31eae6188b
diff --git a/.changeset/20260911065947-regenerate-sdk-from-openapi.md b/.changeset/20260911065947-regenerate-sdk-from-openapi.mdnew file mode 100644index 000000000..efd8ff00f--- /dev/null+++ b/.changeset/20260911065947-regenerate-sdk-from-openapi.md@@ -0,0 +1,5 @@+---+"@truefoundry/trueforge-sdk": patch+---++Regenerate SDK from updated OpenAPI spec.diff --git a/.changeset/agent-description-ui.md b/.changeset/agent-description-ui.mdnew file mode 100644index 000000000..41547498f--- /dev/null+++ b/.changeset/agent-description-ui.md@@ -0,0 +1,5 @@+---+"@truefoundry/trueforge-ui": patch+---++Round-trip agent description through save/load and show it in the library and agent details.diff --git a/.changeset/agent-description.md b/.changeset/agent-description.mdnew file mode 100644index 000000000..59884d1b6--- /dev/null+++ b/.changeset/agent-description.md@@ -0,0 +1,5 @@+---+"@truefoundry/trueforge": patch+---++Persist top-level agent description and sync it to ServiceFoundry on create/update.diff --git a/.github/fern/openapi/openapi.json b/.github/fern/openapi/openapi.jsonindex 9b076745f..357154849 100644--- a/.github/fern/openapi/openapi.json+++ b/.github/fern/openapi/openapi.json@@ -29,6 +29,11 @@"created_by_subject": {"$ref": "#/components/schemas/CreatedBySubject"},+ "description": {+ "maxLength": 1024,+ "minLength": 1,+ "type": "string"+ },"id": {"description": "Immutable server-generated agent identifier.","minLength": 1,@@ -44,6 +49,7 @@"required": ["id","name",+ "description","manifest","created_by_subject"],@@ -982,6 +988,11 @@"CreateAgentRequest": {"additionalProperties": false,"properties": {+ "description": {+ "maxLength": 1024,+ "minLength": 1,+ "type": "string"+ },"manifest": {"$ref": "#/components/schemas/AgentSpec"},@@ -991,6 +1002,7 @@},"required": ["name",+ "description","manifest"],"type": "object"@@ -5330,6 +5342,11 @@"UpdateAgentRequest": {"additionalProperties": false,"properties": {+ "description": {+ "maxLength": 1024,+ "minLength": 1,+ "type": "string"+ },"manifest": {"$ref": "#/components/schemas/AgentSpec"}@@ -6370,7 +6387,7 @@"x-fern-sdk-method-name": "get"},"put": {- "description": "Replaces the manifest for an existing agent keyed by immutable `agent_id`.",+ "description": "Update an existing agent by immutable id.","parameters": [{"description": "Immutable agent identifier.",diff --git a/docs/openapi.json b/docs/openapi.jsonindex 9b076745f..357154849 100644--- a/docs/openapi.json+++ b/docs/openapi.json@@ -29,6 +29,11 @@"created_by_subject": {"$ref": "#/components/schemas/CreatedBySubject"},+ "description": {+ "maxLength": 1024,+ "minLength": 1,+ "type": "string"+ },"id": {"description": "Immutable server-generated agent identifier.","minLength": 1,@@ -44,6 +49,7 @@"required": ["id","name",+ "description","manifest","created_by_subject"],@@ -982,6 +988,11 @@"CreateAgentRequest": {"additionalProperties": false,"properties": {+ "description": {+ "maxLength": 1024,+ "minLength": 1,+ "type": "string"+ },"manifest": {"$ref": "#/components/schemas/AgentSpec"},@@ -991,6 +1002,7 @@},"required": ["name",+ "description","manifest"],"type": "object"@@ -5330,6 +5342,11 @@"UpdateAgentRequest": {"additionalProperties": false,"properties": {+ "description": {+ "maxLength": 1024,+ "minLength": 1,+ "type": "string"+ },"manifest": {"$ref": "#/components/schemas/AgentSpec"}@@ -6370,7 +6387,7 @@"x-fern-sdk-method-name": "get"},"put": {- "description": "Replaces the manifest for an existing agent keyed by immutable `agent_id`.",+ "description": "Update an existing agent by immutable id.","parameters": [{"description": "Immutable agent identifier.",diff --git a/packages/frontend/package.json b/packages/frontend/package.jsonindex 7df484c6f..693fa3a78 100644--- a/packages/frontend/package.json+++ b/packages/frontend/package.json@@ -26,7 +26,7 @@"@assistant-ui/core": "0.2.22","@assistant-ui/react": "0.14.27","@assistant-ui/store": "0.2.21",- "@truefoundry/assistant-ui-runtime": "0.1.36",+ "@truefoundry/assistant-ui-runtime": "0.1.37","@truefoundry/trueforge-sdk": "workspace:*","@truefoundry/trueforge-ui": "workspace:*","monaco-editor": "^0.52.0",diff --git a/packages/trueforge-sdk/reference.md b/packages/trueforge-sdk/reference.mdindex fe932a62d..98c1d13f3 100644--- a/packages/trueforge-sdk/reference.md+++ b/packages/trueforge-sdk/reference.md@@ -158,6 +158,7 @@ Creates an agent and allocates an immutable id. Fails if `name` is already taken```typescriptawait client.agents.create({+ description: "description",manifest: {model: {name: "name"@@ -275,7 +276,7 @@ await client.agents.get("agent_id");<dl><dd>-Replaces the manifest for an existing agent keyed by immutable `agent_id`.+Update an existing agent by immutable id.</dd></dl></dd>diff --git a/packages/trueforge-sdk/src/api/resources/agents/client/Client.ts b/packages/trueforge-sdk/src/api/resources/agents/client/Client.tsindex c2aece33d..5a3ff0a29 100644--- a/packages/trueforge-sdk/src/api/resources/agents/client/Client.ts+++ b/packages/trueforge-sdk/src/api/resources/agents/client/Client.ts@@ -151,6 +151,7 @@ export class AgentsClient {** @example* await client.agents.create({+ * description: "description",* manifest: {* model: {* name: "name"@@ -346,7 +347,7 @@ export class AgentsClient {}/**- * Replaces the manifest for an existing agent keyed by immutable `agent_id`.+ * Update an existing agent by immutable id.** @param {string} agent_id - Immutable agent identifier.* @param {TrueForge.UpdateAgentRequest} requestdiff --git a/packages/trueforge-sdk/src/api/resources/agents/client/requests/CreateAgentRequest.ts b/packages/trueforge-sdk/src/api/resources/agents/client/requests/CreateAgentRequest.tsindex 0648583e5..bec02b543 100644--- a/packages/trueforge-sdk/src/api/resources/agents/client/requests/CreateAgentRequest.ts+++ b/packages/trueforge-sdk/src/api/resources/agents/client/requests/CreateAgentRequest.ts@@ -5,6 +5,7 @@ import type * as TrueForge from "../../../../index.js";/*** @example* {+ * description: "description",* manifest: {* model: {* name: "name"@@ -14,6 +15,7 @@ import type * as TrueForge from "../../../../index.js";* }*/export interface CreateAgentRequest {+ description: string;manifest: TrueForge.AgentSpec;name: TrueForge.ResourceName;}diff --git a/packages/trueforge-sdk/src/api/resources/agents/client/requests/UpdateAgentRequest.ts b/packages/trueforge-sdk/src/api/resources/agents/client/requests/UpdateAgentRequest.tsindex b92a833d5..4b4d7470b 100644--- a/packages/trueforge-sdk/src/api/resources/agents/client/requests/UpdateAgentRequest.ts+++ b/packages/trueforge-sdk/src/api/resources/agents/client/requests/UpdateAgentRequest.ts@@ -13,5 +13,6 @@ import type * as TrueForge from "../../../../index.js";* }*/export interface UpdateAgentRequest {+ description?: string;manifest: TrueForge.AgentSpec;}diff --git a/packages/trueforge-sdk/src/api/types/Agent.ts b/packages/trueforge-sdk/src/api/types/Agent.tsindex a912c1c39..497c56a02 100644--- a/packages/trueforge-sdk/src/api/types/Agent.ts+++ b/packages/trueforge-sdk/src/api/types/Agent.ts@@ -4,6 +4,7 @@ import type * as TrueForge from "../index.js";export interface Agent {createdBySubject: TrueForge.CreatedBySubject;+ description: string;/** Immutable server-generated agent identifier. */id: string;manifest: TrueForge.AgentSpec;diff --git a/packages/trueforge-sdk/src/serialization/resources/agents/client/requests/CreateAgentRequest.ts b/packages/trueforge-sdk/src/serialization/resources/agents/client/requests/CreateAgentRequest.tsindex 27456816a..1fff2647c 100644--- a/packages/trueforge-sdk/src/serialization/resources/agents/client/requests/CreateAgentRequest.ts+++ b/packages/trueforge-sdk/src/serialization/resources/agents/client/requests/CreateAgentRequest.ts@@ -10,12 +10,14 @@ export const CreateAgentRequest: core.serialization.Schema<serializers.CreateAgentRequest.Raw,TrueForge.CreateAgentRequest> = core.serialization.object({+ description: core.serialization.string(),manifest: AgentSpec,name: ResourceName,});export declare namespace CreateAgentRequest {export interface Raw {+ description: string;manifest: AgentSpec.Raw;name: ResourceName.Raw;}diff --git a/packages/trueforge-sdk/src/serialization/resources/agents/client/requests/UpdateAgentRequest.ts b/packages/trueforge-sdk/src/serialization/resources/agents/client/requests/UpdateAgentRequest.tsindex 5ead63d5b..e9431c780 100644--- a/packages/trueforge-sdk/src/serialization/resources/agents/client/requests/UpdateAgentRequest.ts+++ b/packages/trueforge-sdk/src/serialization/resources/agents/client/requests/UpdateAgentRequest.ts@@ -9,11 +9,13 @@ export const UpdateAgentRequest: core.serialization.Schema<serializers.UpdateAgentRequest.Raw,TrueForge.UpdateAgentRequest> = core.serialization.object({+ description: core.serialization.string().optional(),manifest: AgentSpec,});export declare namespace UpdateAgentRequest {export interface Raw {+ description?: string | null;manifest: AgentSpec.Raw;}}diff --git a/packages/trueforge-sdk/src/serialization/types/Agent.ts b/packages/trueforge-sdk/src/serialization/types/Agent.tsindex 21ce3103a..031634495 100644--- a/packages/trueforge-sdk/src/serialization/types/Agent.ts+++ b/packages/trueforge-sdk/src/serialization/types/Agent.ts@@ -10,6 +10,7 @@ import { ResourceName } from "./ResourceName.js";export const Agent: core.serialization.ObjectSchema<serializers.Agent.Raw, TrueForge.Agent> = core.serialization.object({createdBySubject: core.serialization.property("created_by_subject", CreatedBySubject),+ description: core.serialization.string(),id: core.serialization.string(),manifest: AgentSpec,name: ResourceName,@@ -19,6 +20,7 @@ export const Agent: core.serialization.ObjectSchema<serializers.Agent.Raw, TrueFexport declare namespace Agent {export interface Raw {created_by_subject: CreatedBySubject.Raw;+ description: string;id: string;manifest: AgentSpec.Raw;name: ResourceName.Raw;diff --git a/packages/trueforge-sdk/tests/wire/agents.test.ts b/packages/trueforge-sdk/tests/wire/agents.test.tsindex 0bdd448a3..111ecdc09 100644--- a/packages/trueforge-sdk/tests/wire/agents.test.ts+++ b/packages/trueforge-sdk/tests/wire/agents.test.ts@@ -17,6 +17,7 @@ describe("AgentsClient", () => {subject_id: "subject_id",subject_type: "subject_type",},+ description: "description",id: "id",manifest: { model: { name: "name" } },name: "name",@@ -41,6 +42,7 @@ describe("AgentsClient", () => {subjectId: "subject_id",subjectType: "subject_type",},+ description: "description",id: "id",manifest: {model: {@@ -93,7 +95,7 @@ describe("AgentsClient", () => {test("create (1)", async () => {const server = mockServerPool.createServer();const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });- const rawRequestBody = { manifest: { model: { name: "name" } }, name: "name" };+ const rawRequestBody = { description: "description", manifest: { model: { name: "name" } }, name: "name" };const rawResponseBody = {data: {created_by_subject: {@@ -101,6 +103,7 @@ describe("AgentsClient", () => {subject_id: "subject_id",subject_type: "subject_type",},+ description: "description",id: "id",manifest: {instructions: "instructions",@@ -124,6 +127,7 @@ describe("AgentsClient", () => {.build();const response = await client.agents.create({+ description: "description",manifest: {model: {name: "name",@@ -138,6 +142,7 @@ describe("AgentsClient", () => {subjectId: "subject_id",subjectType: "subject_type",},+ description: "description",id: "id",manifest: {instructions: "instructions",@@ -172,7 +177,7 @@ describe("AgentsClient", () => {test("create (2)", async () => {const server = mockServerPool.createServer();const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });- const rawRequestBody = { manifest: { model: { name: "x" } }, name: "xy" };+ const rawRequestBody = { description: "x", manifest: { model: { name: "x" } }, name: "xy" };const rawResponseBody = { error: { message: "message" } };server@@ -186,6 +191,7 @@ describe("AgentsClient", () => {await expect(async () => {return await client.agents.create({+ description: "x",manifest: {model: {name: "x",@@ -199,7 +205,7 @@ describe("AgentsClient", () => {test("create (3)", async () => {const server = mockServerPool.createServer();const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });- const rawRequestBody = { manifest: { model: { name: "x" } }, name: "xy" };+ const rawRequestBody = { description: "x", manifest: { model: { name: "x" } }, name: "xy" };const rawResponseBody = { error: { message: "message" } };server@@ -213,6 +219,7 @@ describe("AgentsClient", () => {await expect(async () => {return await client.agents.create({+ description: "x",manifest: {model: {name: "x",@@ -226,7 +233,7 @@ describe("AgentsClient", () => {test("create (4)", async () => {const server = mockServerPool.createServer();const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });- const rawRequestBody = { manifest: { model: { name: "x" } }, name: "xy" };+ const rawRequestBody = { description: "x", manifest: { model: { name: "x" } }, name: "xy" };const rawResponseBody = { error: { message: "message" } };server@@ -240,6 +247,7 @@ describe("AgentsClient", () => {await expect(async () => {return await client.agents.create({+ description: "x",manifest: {model: {name: "x",@@ -261,6 +269,7 @@ describe("AgentsClient", () => {subject_id: "subject_id",subject_type: "subject_type",},+ description: "description",id: "id",manifest: {instructions: "instructions",@@ -290,6 +299,7 @@ describe("AgentsClient", () => {subjectId: "subject_id",subjectType: "subject_type",},+ description: "description",id: "id",manifest: {instructions: "instructions",@@ -351,6 +361,7 @@ describe("AgentsClient", () => {subject_id: "subject_id",subject_type: "subject_type",},+ description: "description",id: "id",manifest: {instructions: "instructions",@@ -387,6 +398,7 @@ describe("AgentsClient", () => {subjectId: "subject_id",subjectType: "subject_type",},+ description: "description",id: "id",manifest: {instructions: "instructions",diff --git a/packages/trueforge-ui/package.json b/packages/trueforge-ui/package.jsonindex c2000135a..1607b781f 100644--- a/packages/trueforge-ui/package.json+++ b/packages/trueforge-ui/package.json@@ -95,7 +95,7 @@"@openuidev/react-headless": "^0.9.4","@openuidev/react-lang": "^0.2.9","@openuidev/react-ui": "^0.13.2",- "@truefoundry/assistant-ui-runtime": "0.1.36",+ "@truefoundry/assistant-ui-runtime": "0.1.37","@truefoundry/trueforge-sdk": "workspace:*","chart.js": "^4.5.1","clsx": "^2.1.1",diff --git a/packages/trueforge-ui/src/atoms/AgentOverflowMenu.tsx b/packages/trueforge-ui/src/atoms/AgentOverflowMenu.tsxindex c58d8352e..66ab7be54 100644--- a/packages/trueforge-ui/src/atoms/AgentOverflowMenu.tsx+++ b/packages/trueforge-ui/src/atoms/AgentOverflowMenu.tsx@@ -20,6 +20,7 @@ export function cloneAgentName(agentName: string): string {export type AgentOverflowMenuProps = {agentName: string;+ description?: string;agentSpec?: AgentSpec;/** Edit / Clone / Delete when composer is enabled. */canMutate: boolean;@@ -37,6 +38,7 @@ type PendingAction = 'clone' | 'delete' | null;export function AgentOverflowMenu({agentName,+ description,agentSpec,canMutate,canUse = true,@@ -72,6 +74,7 @@ export function AgentOverflowMenu({try {await builder.saveAgent({agentName: clonedName,+ ...(description === undefined ? {} : { description }),agentSpec,intent: 'create',});diff --git a/packages/trueforge-ui/src/atoms/AgentsLibrary.tsx b/packages/trueforge-ui/src/atoms/AgentsLibrary.tsxindex df8b4ce1c..436e07639 100644--- a/packages/trueforge-ui/src/atoms/AgentsLibrary.tsx+++ b/packages/trueforge-ui/src/atoms/AgentsLibrary.tsx@@ -189,10 +189,14 @@ export function AgentLibraryRow({const skillsTitle = skillNames.length ? skillNames.join(', ') : `${skillsCount} skills`;const hasConfiguration = modelLabel != null || skillsCount > 0 || mcpCount > 0;const hasNoSchedules = scheduleSummary != null && scheduleSummary.count === 0;+ const storedDescription = agent.description?.trim() || null;+ // Create falls back to name when description is missing; don't echo it under the title.+ const description = storedDescription != null && storedDescription !== agent.name ? storedDescription : null;return (<TableRow className={hasNoSchedules ? 'group' : undefined}>- <TableCell className="text-text-primary font-medium">+ {/* Fixed width so truncate works; 24rem = 1.5× the prior min-w-64 name column. */}+ <TableCell className="text-text-primary w-96 max-w-96 font-medium">{onOpen == null ? (<span className="block truncate">{agent.name}</span>) : (@@ -205,6 +209,15 @@ export function AgentLibraryRow({<span className="block truncate">{agent.name}</span></button>)}+ {description ? (+ <Tooltip+ content={description}+ className="max-w-sm whitespace-normal text-left"+ triggerClassName="block min-w-0 w-full max-w-full"+ >+ <span className="text-text-secondary block truncate text-xs font-normal">{description}</span>+ </Tooltip>+ ) : null}</TableCell><TableCell>{hasConfiguration ? (@@ -276,6 +289,7 @@ export function AgentLibraryRow({</PermissionGuard><AgentOverflowMenuagentName={agent.name}+ {...(storedDescription != null ? { description: storedDescription } : {})}{...(spec != null ? { agentSpec: spec } : {})}canMutate={canMutate}canUse={canUseAgent}@@ -440,6 +454,7 @@ export function AgentsLibrary({ onSelectAgent }: AgentsLibraryProps) {isCreateAgent: true,agentId: libraryAgentId(agent),agentName: agent.name,+ ...(agent.description === undefined ? {} : { description: agent.description }),agentSpec,});};@@ -519,7 +534,7 @@ export function AgentsLibrary({ onSelectAgent }: AgentsLibraryProps) {<Table><TableHeader><TableRow className="hover:bg-transparent">- <TableHead>Agent name</TableHead>+ <TableHead className="w-96 min-w-96">Agent name</TableHead><TableHead>Configuration</TableHead>{showCreatedByColumn ? <TableHead>Created by</TableHead> : null}{showSchedulesColumn ? <TableHead className="w-[14rem]">Schedules</TableHead> : null}diff --git a/packages/trueforge-ui/src/atoms/SaveAgentButton.tsx b/packages/trueforge-ui/src/atoms/SaveAgentButton.tsxindex e9c5c4fe8..c764dfb3e 100644--- a/packages/trueforge-ui/src/atoms/SaveAgentButton.tsx+++ b/packages/trueforge-ui/src/atoms/SaveAgentButton.tsx@@ -86,6 +86,7 @@ function SaveAgentButtonContent({const [open, setOpen] = useState(false);const [intent, setIntent] = useState<SaveIntent>('create');const [name, setName] = useState('');+ const [description, setDescription] = useState('');const [draftSpec, setDraftSpec] = useState<AgentSpec | null>(null);const [saving, setSaving] = useState(false);const [error, setError] = useState<string | null>(null);@@ -93,6 +94,7 @@ function SaveAgentButtonContent({const close = () => {if (saving) return;setOpen(false);+ setDescription('');setDraftSpec(null);setError(null);};@@ -111,6 +113,7 @@ function SaveAgentButtonContent({const currentName = shell?.mode.status === 'active' ? (shell.mode.agentName ?? shell.mode.agentId ?? '') : '';setIntent(currentName ? 'update' : 'create');setName(currentName);+ setDescription(currentName && shell?.mode.status === 'active' ? (shell.mode.description ?? '') : '');setDraftSpec(cloneAgentSpec(latestAgentSpec));setOpen(true);};@@ -120,11 +123,14 @@ function SaveAgentButtonContent({if (intent === 'update' && !canManageAgent) return;const normalizedName = name.trim();if (!normalizedName || !draftSpec.model.name.trim()) return;+ const normalizedDescription = description.trim();+ if (!normalizedDescription) return;setSaving(true);setError(null);try {const result = await builder.saveAgent({agentName: normalizedName,+ ...(normalizedDescription ? { description: normalizedDescription } : {}),agentSpec: draftSpec,intent,sessionId: draftSessionId,@@ -133,10 +139,12 @@ function SaveAgentButtonContent({shell?.bindMutableAgent({agentId: result.agentId ?? normalizedName,agentName: normalizedName,+ ...(normalizedDescription ? { description: normalizedDescription } : {}),agentSpec: draftSpec,});shell?.invalidateAgentsList();setOpen(false);+ setDescription('');setDraftSpec(null);} catch (caught) {setError(getErrorMessage(caught, 'Could not save agent'));@@ -180,11 +188,12 @@ function SaveAgentButtonContent({<SaveAgentFormintent={intent}name={name}+ description={description}spec={draftSpec}saving={saving}error={error}onNameChange={setName}- onChange={setDraftSpec}+ onDescriptionChange={setDescription}onCancel={close}onSave={() => void save()}/>diff --git a/packages/trueforge-ui/src/atoms/SaveAgentForm.tsx b/packages/trueforge-ui/src/atoms/SaveAgentForm.tsxindex 8c6d0f236..780aecebc 100644--- a/packages/trueforge-ui/src/atoms/SaveAgentForm.tsx+++ b/packages/trueforge-ui/src/atoms/SaveAgentForm.tsx@@ -9,11 +9,12 @@ import { Button } from './primitives/Button.js';export 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;};@@ -21,10 +22,12 @@ export type SaveAgentFormProps = {export function SaveAgentForm({intent,name,+ description,spec,saving,error,onNameChange,+ onDescriptionChange,onCancel,onSave,}: SaveAgentFormProps) {@@ -36,6 +39,8 @@ export function SaveAgentForm({errorRef.current?.scrollIntoView?.({ block: 'nearest', behavior: 'smooth' });}, [error]);+ const canSave = name.trim() !== '' && spec.model.name.trim() !== '' && description.trim() !== '';+return (<div className="flex min-h-0 w-full flex-1 flex-col"><div className="min-h-0 flex-1 overflow-y-auto px-5 py-3">@@ -50,18 +55,18 @@ export function SaveAgentForm({/></label>- {/* TODO: Uncomment the description field when the backend supports description */}- {/* <label className="mb-3 block">- <span className="mb-1.5 block text-sm font-medium">Description</span>- <textarea- value={spec.description ?? ''}- disabled={saving}- onChange={event => onChange({ ...spec, description: event.target.value })}- rows={4}- placeholder="Describe what this agent does."- className={auiInputClass('resize-y py-2 disabled:opacity-60')}- />- </label> */}+ <label className="mb-3 block">+ <span className="mb-1.5 block text-sm font-medium">Description</span>+ <textarea+ value={description}+ disabled={saving}+ onChange={event => onDescriptionChange(event.target.value)}+ rows={4}+ maxLength={1024}+ placeholder="Describe what this agent does."+ className={auiInputClass('resize-y py-2 disabled:opacity-60')}+ />+ </label>{error ? (<p@@ -78,7 +83,7 @@ export function SaveAgentForm({<Button.Secondary type="button" disabled={saving} onClick={onCancel}>Cancel</Button.Secondary>- <Button.Primary type="button" disabled={saving || !name.trim() || !spec.model.name.trim()} onClick={onSave}>+ <Button.Primary type="button" disabled={saving || !canSave} onClick={onSave}>{saving ? 'Saving…' : 'Save changes'}</Button.Primary></div>diff --git a/packages/trueforge-ui/src/atoms/agent-details/AgentDetailsHeader.tsx b/packages/trueforge-ui/src/atoms/agent-details/AgentDetailsHeader.tsxindex 617070bb2..3125c0431 100644--- a/packages/trueforge-ui/src/atoms/agent-details/AgentDetailsHeader.tsx+++ b/packages/trueforge-ui/src/atoms/agent-details/AgentDetailsHeader.tsx@@ -38,6 +38,7 @@ export function AgentDetailsHeader({ agentId, detail, onBack }: AgentDetailsHeadisCreateAgent: true,agentId: detail.agentId,agentName: detail.name,+ ...(detail.description === undefined ? {} : { description: detail.description }),agentSpec: detail.agentSpec,});};@@ -82,6 +83,7 @@ export function AgentDetailsHeader({ agentId, detail, onBack }: AgentDetailsHead{detail != null ? (<AgentOverflowMenuagentName={detail.name}+ {...(detail.description === undefined ? {} : { description: detail.description })}agentSpec={detail.agentSpec}canMutate={canMutate}canUse={canUse}diff --git a/packages/trueforge-ui/src/atoms/agent-details/AgentOverview.tsx b/packages/trueforge-ui/src/atoms/agent-details/AgentOverview.tsxindex 952b02e5c..d4c2d249a 100644--- a/packages/trueforge-ui/src/atoms/agent-details/AgentOverview.tsx+++ b/packages/trueforge-ui/src/atoms/agent-details/AgentOverview.tsx@@ -52,6 +52,7 @@ export default function AgentOverview({ detail }: AgentOverviewProps) {const config = isRecord(spec.config) ? spec.config : null;const sandbox = isRecord(config?.sandbox) ? config.sandbox : null;const instructions = spec.instructions?.trim() ? spec.instructions : null;+ const description = detail.description?.trim() ? detail.description : null;const execution = [['Sandbox', typeof sandbox?.enabled === 'boolean' ? (sandbox.enabled ? 'Enabled' : 'Disabled') : undefined],['Iteration limit', readRecordValue(config, 'iterationLimit', 'iteration_limit')],@@ -67,152 +68,161 @@ export default function AgentOverview({ detail }: AgentOverviewProps) {const toggleLabel = instructionsView === 'markdown' ? 'Raw' : 'Markdown';return (- <div className="grid min-h-0 flex-1 gap-3 overflow-auto p-4 md:grid-cols-[minmax(0,1fr)_18rem] md:overflow-hidden">- <section className="flex min-h-64 flex-col rounded-lg border border-border bg-card-bg p-4 text-text-primary">- <div className="mb-3 flex shrink-0 items-center justify-between gap-2">- <h2 className="flex items-center gap-1.5 text-sm font-semibold text-text-primary">- <Icon name="book-open" className="size-4 text-text-secondary" />- Instructions- </h2>- {instructions ? (- <div- className="inline-flex h-7 items-stretch overflow-hidden rounded-md border border-border bg-primary-bg text-xs font-medium text-text-secondary"- role="group"- aria-label="Instructions actions"- >- <button- type="button"- aria-label={`Show ${toggleLabel}`}- onClick={() => setInstructionsView(view => (view === 'markdown' ? 'raw' : 'markdown'))}- className="cursor-pointer px-2.5 transition-colors hover:bg-ghost-button-hover hover:text-text-primary"+ <div className="flex min-h-0 flex-1 flex-col gap-3 overflow-auto p-4 md:overflow-hidden">+ <div className="grid min-h-0 flex-1 gap-3 md:grid-cols-[minmax(0,1fr)_18rem] md:overflow-hidden">+ <section className="flex min-h-64 flex-col rounded-lg border border-border bg-card-bg p-4 text-text-primary">+ <div className="mb-3 flex shrink-0 items-center justify-between gap-2">+ <h2 className="flex items-center gap-1.5 text-sm font-semibold text-text-primary">+ <Icon name="book-open" className="size-4 text-text-secondary" />+ Instructions+ </h2>+ {instructions ? (+ <div+ className="inline-flex h-7 items-stretch overflow-hidden rounded-md border border-border bg-primary-bg text-xs font-medium text-text-secondary"+ role="group"+ aria-label="Instructions actions">- {toggleLabel}- </button>- <span className="w-px self-stretch bg-border" aria-hidden />- <button- type="button"- title={copied ? 'Copied!' : 'Copy'}- aria-label={copied ? 'Copied!' : 'Copy'}- onClick={() => {- void navigator.clipboard.writeText(instructions).then(() => {- setCopied(true);- setTimeout(() => setCopied(false), 2000);- });- }}- className="inline-flex cursor-pointer items-center justify-center px-2 transition-colors hover:bg-ghost-button-hover hover:text-text-primary"- >- <Icon name={copied ? 'check' : 'copy'} size={12} />- </button>- </div>- ) : null}- </div>- <div className="min-h-0 flex-1 overflow-auto">- {instructions ? (- instructionsView === 'markdown' ? (- <Markdown content={instructions} readOnly className="text-sm" />- ) : (- <pre className="whitespace-pre-wrap break-words font-mono text-sm text-text-primary">{instructions}</pre>- )- ) : (- <p className="text-sm text-text-secondary">No instructions for this agent.</p>- )}- </div>- </section>-- <aside className="flex min-h-0 min-w-0 flex-col gap-3 md:overflow-auto">- <AgentOverviewCard title="Model Configuration" icon="cpu">- <dl className="grid grid-cols-[auto_minmax(0,1fr)] gap-x-3 gap-y-1 text-xs">- <dt className="text-text-secondary">Model</dt>- <dd className={cn(valueClassName, 'truncate')} title={spec.model.name}>- {displayModelName(spec.model.name)}- </dd>- {typeof maxTokens === 'number' ? (- <>- <dt className="text-text-secondary">Max tokens</dt>- <dd className={valueClassName}>{maxTokens}</dd>- </>- ) : null}- {spec.model.params?.reasoningEffort !== undefined ? (- <>- <dt className="text-text-secondary">Reasoning</dt>- <dd className={valueClassName}>{spec.model.params.reasoningEffort}</dd>- </>- ) : null}- {typeof temperature === 'number' ? (- <>- <dt className="text-text-secondary">Temperature</dt>- <dd className={valueClassName}>{temperature}</dd>- </>- ) : null}- </dl>- </AgentOverviewCard>- <AgentOverviewCard title="MCP Servers" icon="plug" count={connectors.length}>- {connectors.length === 0 ? (- <p className="text-xs text-text-secondary">No connectors attached.</p>- ) : (- <ul className="space-y-1.5">- {connectors.map((connector, index) => (- <li- key={`${readName(connector) ?? 'connector'}-${index}`}- className="rounded-md bg-secondary-bg px-2 py-1.5 text-xs"+ <button+ type="button"+ aria-label={`Show ${toggleLabel}`}+ onClick={() => setInstructionsView(view => (view === 'markdown' ? 'raw' : 'markdown'))}+ className="cursor-pointer px-2.5 transition-colors hover:bg-ghost-button-hover hover:text-text-primary">- <span className="flex items-center justify-between gap-2">- <span className="truncate">{readName(connector) ?? `Connector ${index + 1}`}</span>- {hasAllTools(connector) ? (- <span className="shrink-0 rounded-full bg-primary-button-bg/10 px-1.5 py-0.5 text-[10px] text-primary-button-bg">- All tools- </span>- ) : null}- </span>- </li>- ))}- </ul>- )}- </AgentOverviewCard>-- <AgentOverviewCard title="Attached Skills" icon="lightbulb" count={skills.length}>- {skills.length === 0 ? (- <p className="text-xs text-text-secondary">No skills attached.</p>- ) : (- <ul className="space-y-1.5">- {skills.map((skill, index) => (- <li- key={`${readName(skill) ?? 'skill'}-${index}`}- className="rounded-md bg-secondary-bg px-2 py-1.5 text-xs"+ {toggleLabel}+ </button>+ <span className="w-px self-stretch bg-border" aria-hidden />+ <button+ type="button"+ title={copied ? 'Copied!' : 'Copy'}+ aria-label={copied ? 'Copied!' : 'Copy'}+ onClick={() => {+ void navigator.clipboard.writeText(instructions).then(() => {+ setCopied(true);+ setTimeout(() => setCopied(false), 2000);+ });+ }}+ className="inline-flex cursor-pointer items-center justify-center px-2 transition-colors hover:bg-ghost-button-hover hover:text-text-primary">- {readName(skill) ?? `Skill ${index + 1}`}- </li>- ))}- </ul>- )}- </AgentOverviewCard>+ <Icon name={copied ? 'check' : 'copy'} size={12} />+ </button>+ </div>+ ) : null}+ </div>+ <div className="min-h-0 flex-1 overflow-auto">+ {instructions ? (+ instructionsView === 'markdown' ? (+ <Markdown content={instructions} readOnly className="text-sm" />+ ) : (+ <pre className="whitespace-pre-wrap break-words font-mono text-sm text-text-primary">+ {instructions}+ </pre>+ )+ ) : (+ <p className="text-sm text-text-secondary">No instructions for this agent.</p>+ )}+ </div>+ </section>- {execution.length > 0 ? (- <AgentOverviewCard title="Execution" icon="terminal">- <dl className="space-y-1 text-xs">- {execution.map(([label, value]) => (- <div key={label} className="flex justify-between gap-3">- <dt className="text-text-secondary">{label}</dt>- <dd className={valueClassName}>{value}</dd>- </div>- ))}+ <aside className="flex min-h-0 min-w-0 flex-col gap-3 md:overflow-auto">+ {description ? (+ <AgentOverviewCard title="Description" icon="file">+ <p className="text-xs text-text-secondary">{description}</p>+ </AgentOverviewCard>+ ) : null}+ <AgentOverviewCard title="Model Configuration" icon="cpu">+ <dl className="grid grid-cols-[auto_minmax(0,1fr)] gap-x-3 gap-y-1 text-xs">+ <dt className="text-text-secondary">Model</dt>+ <dd className={cn(valueClassName, 'truncate')} title={spec.model.name}>+ {displayModelName(spec.model.name)}+ </dd>+ {typeof maxTokens === 'number' ? (+ <>+ <dt className="text-text-secondary">Max tokens</dt>+ <dd className={valueClassName}>{maxTokens}</dd>+ </>+ ) : null}+ {spec.model.params?.reasoningEffort !== undefined ? (+ <>+ <dt className="text-text-secondary">Reasoning</dt>+ <dd className={valueClassName}>{spec.model.params.reasoningEffort}</dd>+ </>+ ) : null}+ {typeof temperature === 'number' ? (+ <>+ <dt className="text-text-secondary">Temperature</dt>+ <dd className={valueClassName}>{temperature}</dd>+ </>+ ) : null}</dl></AgentOverviewCard>- ) : null}+ <AgentOverviewCard title="MCP Servers" icon="plug" count={connectors.length}>+ {connectors.length === 0 ? (+ <p className="text-xs text-text-secondary">No connectors attached.</p>+ ) : (+ <ul className="space-y-1.5">+ {connectors.map((connector, index) => (+ <li+ key={`${readName(connector) ?? 'connector'}-${index}`}+ className="rounded-md bg-secondary-bg px-2 py-1.5 text-xs"+ >+ <span className="flex items-center justify-between gap-2">+ <span className="truncate">{readName(connector) ?? `Connector ${index + 1}`}</span>+ {hasAllTools(connector) ? (+ <span className="shrink-0 rounded-full bg-primary-button-bg/10 px-1.5 py-0.5 text-[10px] text-primary-button-bg">+ All tools+ </span>+ ) : null}+ </span>+ </li>+ ))}+ </ul>+ )}+ </AgentOverviewCard>- {capabilities.length > 0 ? (- <AgentOverviewCard title="Capabilities" icon="cube">- <dl className="space-y-1 text-xs">- {capabilities.map(([label, enabled]) => (- <div key={label} className="flex justify-between gap-3">- <dt className="text-text-secondary">{label}</dt>- <dd className={valueClassName}>{enabled ? 'Enabled' : 'Disabled'}</dd>- </div>- ))}- </dl>+ <AgentOverviewCard title="Attached Skills" icon="lightbulb" count={skills.length}>+ {skills.length === 0 ? (+ <p className="text-xs text-text-secondary">No skills attached.</p>+ ) : (+ <ul className="space-y-1.5">+ {skills.map((skill, index) => (+ <li+ key={`${readName(skill) ?? 'skill'}-${index}`}+ className="rounded-md bg-secondary-bg px-2 py-1.5 text-xs"+ >+ {readName(skill) ?? `Skill ${index + 1}`}+ </li>+ ))}+ </ul>+ )}</AgentOverviewCard>- ) : null}- </aside>++ {execution.length > 0 ? (+ <AgentOverviewCard title="Execution" icon="terminal">+ <dl className="space-y-1 text-xs">+ {execution.map(([label, value]) => (+ <div key={label} className="flex justify-between gap-3">+ <dt className="text-text-secondary">{label}</dt>+ <dd className={valueClassName}>{value}</dd>+ </div>+ ))}+ </dl>+ </AgentOverviewCard>+ ) : null}++ {capabilities.length > 0 ? (+ <AgentOverviewCard title="Capabilities" icon="cube">+ <dl className="space-y-1 text-xs">+ {capabilities.map(([label, enabled]) => (+ <div key={label} className="flex justify-between gap-3">+ <dt className="text-text-secondary">{label}</dt>+ <dd className={valueClassName}>{enabled ? 'Enabled' : 'Disabled'}</dd>+ </div>+ ))}+ </dl>+ </AgentOverviewCard>+ ) : null}+ </aside>+ </div></div>);}diff --git a/packages/trueforge-ui/src/atoms/agent-details/AgentOverviewCard.tsx b/packages/trueforge-ui/src/atoms/agent-details/AgentOverviewCard.tsxindex eb1ba46a1..97ebb8c99 100644--- a/packages/trueforge-ui/src/atoms/agent-details/AgentOverviewCard.tsx+++ b/packages/trueforge-ui/src/atoms/agent-details/AgentOverviewCard.tsx@@ -5,7 +5,7 @@ export function AgentOverviewCard({ title, icon, count, children }: AgentOverviereturn (<section className="rounded-lg border border-border bg-card-bg p-3 text-text-primary"><h2 className="mb-2 flex items-center gap-1.5 text-xs font-semibold">- <Icon name={icon} className="size-3.5 text-text-secondary" />+ {icon ? <Icon name={icon} className="size-3.5 text-text-secondary" /> : null}{title}{count !== undefined ? <span className="text-text-secondary">({count})</span> : null}</h2>diff --git a/packages/trueforge-ui/src/atoms/agent-details/types.ts b/packages/trueforge-ui/src/atoms/agent-details/types.tsindex 147d5c6ec..b6e306d7d 100644--- a/packages/trueforge-ui/src/atoms/agent-details/types.ts+++ b/packages/trueforge-ui/src/atoms/agent-details/types.ts@@ -158,7 +158,7 @@ export type AgentOverviewProps = {export type AgentOverviewCardProps = {title: string;- icon: string;+ icon?: string;count?: number;children: ReactNode;};diff --git a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/agentSessionsServer.ts b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/agentSessionsServer.tsindex cf9c827e4..2d40f6b83 100644--- a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/agentSessionsServer.ts+++ b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/agentSessionsServer.ts@@ -52,6 +52,7 @@ export function createHarnessAgentSessionsServer(return {agentId: data.id,name: data.name,+ description: data.description,agentSpec: toUiAgentSpec(data.manifest),};},diff --git a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/builderServer.ts b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/builderServer.tsindex bdeeb1435..f00a7f7a0 100644--- a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/builderServer.ts+++ b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/builderServer.ts@@ -57,6 +57,7 @@ function toLibraryEntry(agent: TrueForgeApi.Agent): AgentLibraryEntry {return {name: agent.name,agentId: agent.id,+ description: agent.description,agentSpec: toUiAgentSpec(agent.manifest),createdBySubject: agent.createdBySubject,};@@ -133,19 +134,29 @@ export function createHarnessBuilderServer(return rows.map(toLibraryEntry);},- async saveAgent({ agentName, agentSpec, intent }) {- // TODO: TrueForge currently drops AgentSpec.description until its schema supports it.+ async saveAgent({ agentName, description: descriptionRaw, agentSpec, intent }) {const manifest = toHarnessAgentSpec(agentSpec);+ const description = descriptionRaw?.trim();if (intent === 'update') {const agents = await drainAgentsList(client);const existing = agents.find(agent => agent.name === agentName);if (!existing) {return {};}- await client.agents.update(existing.id, { manifest });+ // Omit empty description on update so a reloaded draft (no description in session+ // manifest) preserves the stored value instead of failing min(1).+ await client.agents.update(existing.id, {+ ...(description ? { description } : {}),+ manifest,+ });return { agentId: existing.id };}- const created = await client.agents.create({ name: agentName, manifest });+ // Create requires description; fall back to name for clone of pre-description agents.+ const created = await client.agents.create({+ name: agentName,+ description: description || agentName,+ manifest,+ });return { agentId: created.data.id };},diff --git a/packages/trueforge-ui/src/server/ShellModeContext.tsx b/packages/trueforge-ui/src/server/ShellModeContext.tsxindex 9d8901953..0d06fdf8f 100644--- a/packages/trueforge-ui/src/server/ShellModeContext.tsx+++ b/packages/trueforge-ui/src/server/ShellModeContext.tsx@@ -50,6 +50,8 @@ export 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;@@ -64,6 +66,7 @@ export type SelectLibraryAgentRequest = {isCreateAgent?: boolean;agentId?: string;agentName?: string;+ description?: string;agentSpec?: AgentSpec;};@@ -111,7 +114,7 @@ type ShellModeContextValue = {* Attach identity + agentSpec to the *current* mutable chat without remounting.* Used after `saveAgent` so the same draft session continues as an editable agent.*/- bindMutableAgent: (req: { agentId: string; agentName: string; agentSpec: AgentSpec }) => void;+ bindMutableAgent: (req: { agentId: string; agentName: string; description?: string; agentSpec: AgentSpec }) => void;/** @deprecated Prefer `selectLibraryAgent({ isMutable: false, agentName })`. */selectAgent: (agentName: string) => void;/** Open a simple New Chat (mutable, no agent-builder chrome). */@@ -411,6 +414,7 @@ export function ShellModeProvider({isCreateAgent,agentId: req.agentId,agentName: req.agentName,+ description: req.description,agentSpec: req.agentSpec ?? (kind === 'agent' ? agentSeedRef.current : chatSeedRef.current),locked: false,});@@ -451,7 +455,7 @@ export function ShellModeProvider({);const bindMutableAgent = useCallback(- (req: { agentId: string; agentName: string; agentSpec: AgentSpec }) => {+ (req: { agentId: string; agentName: string; description?: string; agentSpec: AgentSpec }) => {if (!isComposerEnabled) return;setMode(prev => {if (prev.status !== 'active' || !prev.isMutable) return prev;@@ -461,6 +465,7 @@ export function ShellModeProvider({isCreateAgent: true,agentId: req.agentId,agentName: req.agentName,+ description: req.description,agentSpec: req.agentSpec,locked: false,};diff --git a/packages/trueforge-ui/test/atoms/AgentDetailsPage.test.tsx b/packages/trueforge-ui/test/atoms/AgentDetailsPage.test.tsxindex 8d7f31bd8..31b0931b7 100644--- a/packages/trueforge-ui/test/atoms/AgentDetailsPage.test.tsx+++ b/packages/trueforge-ui/test/atoms/AgentDetailsPage.test.tsx@@ -79,6 +79,7 @@ beforeAll(() => {const detail: AgentDetail = {agentId: 'agent-1',name: 'release-notes-writer',+ description: 'Produces concise release notes from merged PRs.',agentSpec: {model: { name: 'openai/gpt-5.1', params: { maxTokens: 16000 } },instructions: '# Who you are\n\nWrite concise release notes.',@@ -193,6 +194,7 @@ describe('AgentDetailsPage', () => {const { getAgent } = renderPage();expect(await screen.findByText('release-notes-writer')).toBeInTheDocument();+ expect(await screen.findByText('Produces concise release notes from merged PRs.')).toBeInTheDocument();expect(await screen.findByText('Write concise release notes.')).toBeInTheDocument();expect(await screen.findByText('github')).toBeInTheDocument();expect(await screen.findByText('release-writing')).toBeInTheDocument();diff --git a/packages/trueforge-ui/test/atoms/AgentsLibrary.test.tsx b/packages/trueforge-ui/test/atoms/AgentsLibrary.test.tsxindex b9e338061..d4a604a66 100644--- a/packages/trueforge-ui/test/atoms/AgentsLibrary.test.tsx+++ b/packages/trueforge-ui/test/atoms/AgentsLibrary.test.tsx@@ -35,9 +35,9 @@ function mockServer(agents: Array<{name: string;agentId: string;+ description?: string;agentSpec?: {model: { name: string };- description?: string;skills?: Array<{ id: string; name: string }>;mcpServers?: Array<{ id: string; name: string }>;};@@ -146,7 +146,12 @@ describe('AgentsLibrary', () => {it('lists agents and selects a named agent (Try = immutable)', async () => {const server = mockServer([- { name: 'alpha-agent', agentId: 'alpha-agent' },+ {+ name: 'alpha-agent',+ agentId: 'alpha-agent',+ description: 'Alpha handles triage.',+ agentSpec: { model: { name: 'openai/gpt-4.1' } },+ },{ name: 'beta-agent', agentId: 'beta-agent' },]);const onSelectAgent = vi.fn();@@ -158,6 +163,7 @@ describe('AgentsLibrary', () => {await waitFor(() => {expect(screen.getByRole('button', { name: 'Try agent alpha-agent' })).toBeInTheDocument();});+ expect(screen.getByText('Alpha handles triage.')).toHaveClass('truncate');fireEvent.click(screen.getByRole('button', { name: 'Try agent beta-agent' }));expect(onSelectAgent).toHaveBeenCalledWith('beta-agent');@@ -166,6 +172,34 @@ describe('AgentsLibrary', () => {});});+ it('truncates long descriptions without hiding Try, and skips name-echo descriptions', async () => {+ const longDescription = `${'Lorem ipsum dolor sit amet, '.repeat(20)}consectetur.`;+ const server = mockServer([+ {+ name: 'verbose-agent',+ agentId: 'verbose-agent',+ description: longDescription,+ agentSpec: { model: { name: 'openai/gpt-4.1' } },+ },+ {+ name: 'echo-agent',+ agentId: 'echo-agent',+ description: 'echo-agent',+ agentSpec: { model: { name: 'openai/gpt-4.1' } },+ },+ ]);++ renderLibrary(<LibraryHarness />, { server });+ fireEvent.click(screen.getByRole('button', { name: 'Open library' }));++ await waitFor(() => {+ expect(screen.getByRole('button', { name: 'Try agent verbose-agent' })).toBeInTheDocument();+ });+ expect(screen.getByRole('columnheader', { name: 'Configuration' })).toBeInTheDocument();+ expect(screen.getByText(longDescription)).toHaveClass('truncate');+ expect(screen.queryByText('echo-agent', { selector: '.text-xs' })).not.toBeInTheDocument();+ });+it('shows Edit/Clone/Delete when composer is enabled and agentSpec is present', async () => {const server = mockServer([{@@ -240,6 +274,7 @@ describe('AgentsLibrary', () => {{name: 'writer',agentId: 'writer-id',+ description: 'Writes release notes.',agentSpec: { model: { name: 'openai-main/gpt-4.1' } },},]),@@ -263,6 +298,7 @@ describe('AgentsLibrary', () => {await waitFor(() => {expect(saveAgent).toHaveBeenCalledWith({agentName: 'writer-copy',+ description: 'Writes release notes.',agentSpec: { model: { name: 'openai-main/gpt-4.1' } },intent: 'create',});diff --git a/packages/trueforge-ui/test/atoms/SaveAgentButton.test.tsx b/packages/trueforge-ui/test/atoms/SaveAgentButton.test.tsxindex 720d032fa..6b64f4112 100644--- a/packages/trueforge-ui/test/atoms/SaveAgentButton.test.tsx+++ b/packages/trueforge-ui/test/atoms/SaveAgentButton.test.tsx@@ -102,7 +102,15 @@ function renderButton({};}-function BoundMutableSaveButton({ agentId, agentName }: { agentId: string; agentName?: string }) {+function BoundMutableSaveButton({+ agentId,+ agentName,+ description,+}: {+ agentId: string;+ agentName?: string;+ description?: string;+}) {const { selectLibraryAgent } = useShellMode();useEffect(() => {selectLibraryAgent({@@ -110,9 +118,10 @@ function BoundMutableSaveButton({ agentId, agentName }: { agentId: string; agentisCreateAgent: true,agentId,agentName,+ description,agentSpec,});- }, [agentId, agentName, selectLibraryAgent]);+ }, [agentId, agentName, description, selectLibraryAgent]);return <SaveAgentButton />;}@@ -205,7 +214,7 @@ describe('SaveAgentButton', () => {'text-text-primary','focus-visible:ring-focus-ring/40',);- expect(within(dialog).queryByLabelText('Description')).not.toBeInTheDocument();+ expect(within(dialog).getByLabelText('Description')).toBeInTheDocument();expect(within(dialog).queryByRole('button', { name: 'Edit Model' })).not.toBeInTheDocument();expect(within(dialog).queryByRole('button', { name: 'Edit Runtime Config' })).not.toBeInTheDocument();expect(within(dialog).queryByRole('button', { name: 'Edit Connectors' })).not.toBeInTheDocument();@@ -219,6 +228,7 @@ describe('SaveAgentButton', () => {const dialog = await screen.findByRole('dialog', { name: 'Save agent' });fireEvent.change(within(dialog).getByLabelText('Agent name'), { target: { value: 'writer' } });+ fireEvent.change(within(dialog).getByLabelText('Description'), { target: { value: 'Writes docs.' } });fireEvent.click(within(dialog).getByRole('button', { name: 'Save changes' }));await waitFor(() =>@@ -255,6 +265,7 @@ describe('SaveAgentButton', () => {const dialog = await screen.findByRole('dialog', { name: 'Save agent' });fireEvent.change(within(dialog).getByLabelText('Agent name'), { target: { value: 'latest-agent' } });+ fireEvent.change(within(dialog).getByLabelText('Description'), { target: { value: 'Latest agent description.' } });fireEvent.click(within(dialog).getByRole('button', { name: 'Save changes' }));await waitFor(() =>@@ -281,6 +292,7 @@ describe('SaveAgentButton', () => {fireEvent.click(screen.getByRole('button', { name: 'Save Agent' }));const dialog = await screen.findByRole('dialog', { name: 'Save agent' });fireEvent.change(within(dialog).getByLabelText('Agent name'), { target: { value: 'writer' } });+ fireEvent.change(within(dialog).getByLabelText('Description'), { target: { value: 'Writes docs.' } });fireEvent.click(within(dialog).getByRole('button', { name: 'Save changes' }));await waitFor(() =>@@ -307,6 +319,7 @@ describe('SaveAgentButton', () => {fireEvent.click(screen.getByRole('button', { name: 'Save Agent' }));const dialog = await screen.findByRole('dialog', { name: 'Save agent' });fireEvent.change(within(dialog).getByLabelText('Agent name'), { target: { value: 'writer' } });+ fireEvent.change(within(dialog).getByLabelText('Description'), { target: { value: 'Writes docs.' } });fireEvent.click(within(dialog).getByRole('button', { name: 'Save changes' }));expect(updateAgentSpec).toHaveBeenCalledWith({@@ -325,7 +338,7 @@ describe('SaveAgentButton', () => {const saveAgent = vi.fn(async (): Promise<SaveAgentResult> => ({ agentId: 'writer' }));renderButton({saveAgent,- children: <BoundMutableSaveButton agentId="writer" />,+ children: <BoundMutableSaveButton agentId="writer" description="Writes docs." />,});const trigger = await screen.findByRole('button', { name: 'Update Agent' });@@ -361,11 +374,13 @@ describe('SaveAgentButton', () => {fireEvent.click(screen.getByRole('button', { name: 'Save Agent' }));const dialog = await screen.findByRole('dialog', { name: 'Save agent' });fireEvent.change(within(dialog).getByLabelText('Agent name'), { target: { value: 'my-agent' } });+ fireEvent.change(within(dialog).getByLabelText('Description'), { target: { value: 'My agent description.' } });fireEvent.click(within(dialog).getByRole('button', { name: 'Save changes' }));await waitFor(() => expect(saveAgent).toHaveBeenCalledOnce());expect(saveAgent).toHaveBeenCalledWith({agentName: 'my-agent',+ description: 'My agent description.',agentSpec: {model: { name: 'openai/gpt-4.1', params: undefined },instructions: 'Be helpful.',@@ -395,6 +410,9 @@ describe('SaveAgentButton', () => {fireEvent.click(screen.getByRole('button', { name: 'Save Agent' }));const saveDialog = await screen.findByRole('dialog', { name: 'Save agent' });fireEvent.change(within(saveDialog).getByLabelText('Agent name'), { target: { value: 'preserved-agent' } });+ fireEvent.change(within(saveDialog).getByLabelText('Description'), {+ target: { value: 'Preserved agent description.' },+ });fireEvent.click(within(saveDialog).getByRole('button', { name: 'Save changes' }));await waitFor(() => expect(saveAgent).toHaveBeenCalledOnce());@@ -414,6 +432,7 @@ describe('SaveAgentButton', () => {fireEvent.click(screen.getByRole('button', { name: 'Save Agent' }));const dialog = await screen.findByRole('dialog', { name: 'Save agent' });fireEvent.change(within(dialog).getByLabelText('Agent name'), { target: { value: 'pending-agent' } });+ fireEvent.change(within(dialog).getByLabelText('Description'), { target: { value: 'Pending agent description.' } });fireEvent.click(within(dialog).getByRole('button', { name: 'Save changes' }));expect(within(dialog).getByLabelText('Agent name')).toBeDisabled();@@ -432,6 +451,9 @@ describe('SaveAgentButton', () => {fireEvent.click(screen.getByRole('button', { name: 'Save Agent' }));const dialog = await screen.findByRole('dialog', { name: 'Save agent' });fireEvent.change(within(dialog).getByLabelText('Agent name'), { target: { value: 'duplicate' } });+ fireEvent.change(within(dialog).getByLabelText('Description'), {+ target: { value: 'Duplicate agent description.' },+ });fireEvent.click(within(dialog).getByRole('button', { name: 'Save changes' }));expect(await within(dialog).findByRole('alert')).toHaveTextContent('Agent name already exists');@@ -452,10 +474,50 @@ describe('SaveAgentButton', () => {fireEvent.click(screen.getByRole('button', { name: 'Save Agent' }));const dialog = await screen.findByRole('dialog', { name: 'Save agent' });fireEvent.change(within(dialog).getByLabelText('Agent name'), { target: { value: 'bad name' } });+ fireEvent.change(within(dialog).getByLabelText('Description'), {+ target: { value: 'Bad name agent description.' },+ });fireEvent.click(within(dialog).getByRole('button', { name: 'Save changes' }));const alert = await within(dialog).findByRole('alert');expect(alert).toHaveClass('whitespace-pre-wrap');expect(alert.textContent).toBe('line one\nline two\tindented');});++ it('disables Save on create when description is empty', async () => {+ renderButton();+ fireEvent.click(screen.getByRole('button', { name: 'Save Agent' }));+ const dialog = await screen.findByRole('dialog', { name: 'Save agent' });+ fireEvent.change(within(dialog).getByLabelText('Agent name'), { target: { value: 'writer' } });+ expect(within(dialog).getByRole('button', { name: 'Save changes' })).toBeDisabled();+ fireEvent.change(within(dialog).getByLabelText('Description'), { target: { value: 'Writes docs.' } });+ expect(within(dialog).getByRole('button', { name: 'Save changes' })).toBeEnabled();+ });++ it('disables Save on update when description is empty', async () => {+ renderButton({+ children: <BoundMutableSaveButton agentId="writer" agentName="writer" description="Existing agent summary." />,+ });+ fireEvent.click(await screen.findByRole('button', { name: 'Update Agent' }));+ const dialog = await screen.findByRole('dialog', { name: 'Update agent' });+ expect(within(dialog).getByRole('button', { name: 'Save changes' })).toBeEnabled();+ fireEvent.change(within(dialog).getByLabelText('Description'), { target: { value: ' ' } });+ expect(within(dialog).getByRole('button', { name: 'Save changes' })).toBeDisabled();+ fireEvent.change(within(dialog).getByLabelText('Description'), { target: { value: 'Updated summary.' } });+ expect(within(dialog).getByRole('button', { name: 'Save changes' })).toBeEnabled();+ });++ it('prefills description on update intent', async () => {+ agentSpec = {+ model: { name: 'openai/gpt-4.1' },+ instructions: 'Be helpful.',+ };+ renderButton({+ children: <BoundMutableSaveButton agentId="writer" agentName="writer" description="Existing agent summary." />,+ });+ fireEvent.click(await screen.findByRole('button', { name: 'Update Agent' }));+ const dialog = await screen.findByRole('dialog', { name: 'Update agent' });+ expect(within(dialog).getByLabelText('Agent name')).toHaveValue('writer');+ expect(within(dialog).getByLabelText('Description')).toHaveValue('Existing agent summary.');+ });});diff --git a/packages/trueforge-ui/test/containers/TrueForgeUI.test.tsx b/packages/trueforge-ui/test/containers/TrueForgeUI.test.tsxindex f635c8ca5..b6c1380f1 100644--- a/packages/trueforge-ui/test/containers/TrueForgeUI.test.tsx+++ b/packages/trueforge-ui/test/containers/TrueForgeUI.test.tsx@@ -300,7 +300,7 @@ describe('TrueForgeUI', () => {fireEvent.click(await screen.findByRole('button', { name: 'Save Agent' }));const saveDialog = await screen.findByRole('dialog', { name: 'Save agent' });expect(within(saveDialog).getByLabelText('Agent name')).toBeInTheDocument();- expect(within(saveDialog).queryByLabelText('Description')).not.toBeInTheDocument();+ expect(within(saveDialog).getByLabelText('Description')).toBeInTheDocument();expect(within(saveDialog).queryByRole('button', { name: 'Edit Model' })).not.toBeInTheDocument();expect(within(saveDialog).queryByRole('button', { name: 'Edit Connectors' })).not.toBeInTheDocument();expect(getModels).toHaveBeenCalled();diff --git a/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/agentSessionsServer.test.ts b/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/agentSessionsServer.test.tsindex 8a9b72f48..3e8059b9b 100644--- a/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/agentSessionsServer.test.ts+++ b/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/agentSessionsServer.test.ts@@ -11,6 +11,7 @@ describe('createHarnessAgentSessionsServer', () => {data: {id: 'agent-1',name: 'writer',+ description: 'Writes docs.',manifest: { model: { name: 'openai/gpt-5' }, instructions: 'Write.' },},}));@@ -37,7 +38,11 @@ describe('createHarnessAgentSessionsServer', () => {assert.deepEqual(await server.getAgent({ agentId: 'agent-1' }), {agentId: 'agent-1',name: 'writer',- agentSpec: { model: { name: 'openai/gpt-5' }, instructions: 'Write.' },+ description: 'Writes docs.',+ agentSpec: {+ model: { name: 'openai/gpt-5' },+ instructions: 'Write.',+ },});assert.deepEqual(await server.getCodeSnippets({ agentId: 'agent-1' }), [{diff --git a/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/harnessBuilderServer.test.ts b/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/harnessBuilderServer.test.tsindex 39875b156..a762004e2 100644--- a/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/harnessBuilderServer.test.ts+++ b/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/harnessBuilderServer.test.ts@@ -305,11 +305,19 @@ describe('harnessBuilderServer', () => {return Response.json({data:agentName === 'write'- ? [{ id: 'agt_2', name: 'writer', manifest: { model: { name: 'test/model' } } }]+ ? [+ {+ id: 'agt_2',+ name: 'writer',+ description: 'Writes docs.',+ manifest: { model: { name: 'test/model' } },+ },+ ]: [{id: 'agt_1',name: 'reviewer',+ description: 'Reviews pull requests.',created_by_subject: {subject_id: 'user-1',subject_type: 'user',@@ -322,7 +330,12 @@ describe('harnessBuilderServer', () => {mcp_servers: [{ name: 'github', enable_tools: ['@all'] }],},},- { id: 'agt_2', name: 'writer', manifest: { model: { name: 'test/model' } } },+ {+ id: 'agt_2',+ name: 'writer',+ description: 'Writes docs.',+ manifest: { model: { name: 'test/model' } },+ },],pagination: { limit: 25 },});@@ -341,6 +354,7 @@ describe('harnessBuilderServer', () => {subjectType: 'user',subjectDisplayName: 'Alice',},+ description: 'Reviews pull requests.',agentSpec: {model: { name: 'test/model' },instructions: 'Review carefully.',@@ -440,6 +454,47 @@ describe('harnessBuilderServer', () => {assert.deepEqual(result, { agentId: 'agt_new' });assert.deepEqual(requests.at(-1)?.body, {name: 'saved-agent',+ description: 'saved-agent',+ manifest: {+ model: { name: 'test/model' },+ skills: [{ name: 'review', preload: false }],+ },+ });+ });++ it('saveAgent create sends top-level description and strips it from the manifest', async () => {+ const requests: { method: string; url: string; body?: unknown }[] = [];+ const fetchMock: typeof fetch = async (input, init) => {+ const url = input instanceof Request ? input.url : String(input);+ const method = init?.method ?? 'GET';+ if (url.endsWith('/api/v1/agents') && method === 'POST' && typeof init?.body === 'string') {+ requests.push({ method, url, body: JSON.parse(init.body) });+ return Response.json({+ data: {+ id: 'agt_desc',+ name: 'described-agent',+ description: 'Helps with reviews.',+ manifest: { model: { name: 'test/model' } },+ },+ });+ }+ return new Response(`Unexpected request: ${method} ${url}`, { status: 500 });+ };++ const builder = createHarnessBuilderServer({ fetch: fetchMock });+ await builder.saveAgent({+ agentName: 'described-agent',+ description: 'Helps with reviews.',+ agentSpec: {+ model: { name: 'test/model' },+ skills: [{ name: 'review' }],+ },+ intent: 'create',+ });++ assert.deepEqual(requests.at(-1)?.body, {+ name: 'described-agent',+ description: 'Helps with reviews.',manifest: {model: { name: 'test/model' },skills: [{ name: 'review', preload: false }],diff --git a/packages/trueforge/src/apis/agentImport.ts b/packages/trueforge/src/apis/agentImport.tsindex 24e144f75..a2cb00f8c 100644--- a/packages/trueforge/src/apis/agentImport.ts+++ b/packages/trueforge/src/apis/agentImport.ts@@ -46,6 +46,7 @@ export function createAgentImportRouter(deps: AgentImportRouterDeps) {const created = await agentStore.createAgent({tenant_id: agent.tenant_id,name: agent.name,+ description: agent.name,manifest: agent.manifest,external_id: null,created_by_subject: agent.created_by_subject,diff --git a/packages/trueforge/src/apis/agents.ts b/packages/trueforge/src/apis/agents.tsindex 836ac021b..fafe32daf 100644--- a/packages/trueforge/src/apis/agents.ts+++ b/packages/trueforge/src/apis/agents.ts@@ -48,6 +48,7 @@ function toWireAgent(record: AgentRecord): Agent {return {id: record.id,name: record.name,+ description: record.description,manifest: record.manifest,created_by_subject: record.created_by_subject,};@@ -117,6 +118,7 @@ export function createAgentsRouter<TTransaction>(deps: AgentsRouterDeps<TTransacconst record = await deps.resolveAgentStore(c).createAgent({tenant_id: requestContext.tenant_id,name: body.name,+ description: body.description,manifest,external_id: null,created_by_subject: createdBySubjectFromRequestContext(requestContext),@@ -219,6 +221,7 @@ export function createAgentsRouter<TTransaction>(deps: AgentsRouterDeps<TTransacconst record = await deps.resolveAgentStore(c).updateAgent({tenant_id: requestContext.tenant_id,id: agentId,+ ...(body.description === undefined ? {} : { description: body.description }),manifest,});if (record === undefined) {diff --git a/packages/trueforge/src/db/agentStore.ts b/packages/trueforge/src/db/agentStore.tsindex c796fc9bc..ac2a796d4 100644--- a/packages/trueforge/src/db/agentStore.ts+++ b/packages/trueforge/src/db/agentStore.ts@@ -16,6 +16,7 @@ export interface AgentRecord {id: string;tenant_id: string;name: ResourceName;+ description: string;manifest: AgentSpec;external_id: string | null;created_by_subject: CreatedBySubject;@@ -66,18 +67,20 @@ export interface AgentExternalIdRow {export interface CreateAgentInput {tenant_id: string;name: ResourceName;+ description: string;manifest: AgentSpec;external_id: string | null;created_by_subject: CreatedBySubject;}/**- * Patch an existing agent by immutable id. At least one of `manifest` or `external_id` is required.- * Provided fields replace the stored column; omitted fields are left unchanged.+ * Patch an existing agent by immutable id. At least one of `manifest`, `description`, or+ * `external_id` is required. Provided fields replace the stored column; omitted fields are left unchanged.*/export interface UpdateAgentInput {tenant_id: string;id: string;+ description?: string;manifest?: AgentSpec;external_id?: string | null;}@@ -128,7 +131,7 @@ export interface IAgentStore<TTransaction = never> {getAgent(input: GetAgentInput, transaction?: TTransaction): Promise<AgentRecord | undefined>;/** Inserts a new agent with a generated ULID. Throws AgentNameConflictError or AgentExternalIdConflictError on unique clash. */createAgent(input: CreateAgentInput, transaction?: TTransaction): Promise<AgentRecord>;- /** Patches `manifest` and/or `external_id`. Throws AgentExternalIdConflictError on unique clash. Returns undefined if missing. */+ /** Patches `manifest`, `description`, and/or `external_id`. Throws AgentExternalIdConflictError on unique clash. Returns undefined if missing. */updateAgent(input: UpdateAgentInput, transaction?: TTransaction): Promise<AgentRecord | undefined>;/** Deletes by immutable id. Idempotent if already missing. */deleteAgent(input: DeleteAgentInput, transaction?: TTransaction): Promise<void>;diff --git a/packages/trueforge/src/db/postgres/agent-store/PostgresAgentStore.ts b/packages/trueforge/src/db/postgres/agent-store/PostgresAgentStore.tsindex 02faf8ff9..5a647a839 100644--- a/packages/trueforge/src/db/postgres/agent-store/PostgresAgentStore.ts+++ b/packages/trueforge/src/db/postgres/agent-store/PostgresAgentStore.ts@@ -30,6 +30,7 @@ function toRecord(row: Selectable<AgentTable>): AgentRecord {id: row.id,tenant_id: row.tenant_id,name: row.name,+ description: row.description,manifest: parseStoredAgentSpec(row.manifest),external_id: row.external_id,created_by_subject: CreatedBySubjectSchema.parse(row.created_by_subject),@@ -147,6 +148,7 @@ export class PostgresAgentStore implements IAgentStore<Transaction<Database>> {id: newId(),tenant_id: input.tenant_id,name: input.name,+ description: input.description,manifest: json(input.manifest),external_id: input.external_id,created_by_subject: json(input.created_by_subject),@@ -170,8 +172,8 @@ export class PostgresAgentStore implements IAgentStore<Transaction<Database>> {}async updateAgent(input: UpdateAgentInput, transaction?: Transaction<Database>): Promise<AgentRecord | undefined> {- if (input.manifest === undefined && input.external_id === undefined) {- throw new Error('updateAgent requires manifest and/or external_id');+ if (input.manifest === undefined && input.description === undefined && input.external_id === undefined) {+ throw new Error('updateAgent requires manifest, description, and/or external_id');}const db = transaction ?? this.#db;try {@@ -179,6 +181,7 @@ export class PostgresAgentStore implements IAgentStore<Transaction<Database>> {.updateTable('agent').set({...(input.manifest === undefined ? {} : { manifest: json(input.manifest) }),+ ...(input.description === undefined ? {} : { description: input.description }),...(input.external_id === undefined ? {} : { external_id: input.external_id }),updated_at: now(),})diff --git a/packages/trueforge/src/db/postgres/migrations/20260909_000001_agent_description.ts b/packages/trueforge/src/db/postgres/migrations/20260909_000001_agent_description.tsnew file mode 100644index 000000000..9e3bd1f4a--- /dev/null+++ b/packages/trueforge/src/db/postgres/migrations/20260909_000001_agent_description.ts@@ -0,0 +1,16 @@+import { sql, type Kysely } from 'kysely';++/** Add agent `description`; backfill existing rows from `name`. */+export async function up(db: Kysely<unknown>): Promise<void> {+ await sql`SET LOCAL lock_timeout = '5s'`.execute(db);+ await db.schema+ .alterTable('agent')+ .addColumn('description', 'text', col => col.notNull().defaultTo(''))+ .execute();+ await sql`UPDATE agent SET description = name`.execute(db);+}++export async function down(db: Kysely<unknown>): Promise<void> {+ await sql`SET LOCAL lock_timeout = '5s'`.execute(db);+ await db.schema.alterTable('agent').dropColumn('description').execute();+}diff --git a/packages/trueforge/src/db/postgres/types.ts b/packages/trueforge/src/db/postgres/types.tsindex 357ea5877..cdc6bcd64 100644--- a/packages/trueforge/src/db/postgres/types.ts+++ b/packages/trueforge/src/db/postgres/types.ts@@ -383,6 +383,7 @@ export interface AgentTable {tenant_id: string;/** immutable natural uniqueness target within a tenant */name: string;+ description: string;/** AgentSpec document; replaced whole on every upsert */manifest: JSONColumnType<AgentSpec, AgentSpec, AgentSpec>;external_id: string | null;diff --git a/packages/trueforge/src/db/sqlite/agent-store/SqliteAgentStore.ts b/packages/trueforge/src/db/sqlite/agent-store/SqliteAgentStore.tsindex bfbad492a..27b1daa6a 100644--- a/packages/trueforge/src/db/sqlite/agent-store/SqliteAgentStore.ts+++ b/packages/trueforge/src/db/sqlite/agent-store/SqliteAgentStore.ts@@ -35,6 +35,7 @@ function recordColumns(eb: ExpressionBuilder<Database, 'agent'>) {'id' as const,'tenant_id' as const,'name' as const,+ 'description' as const,jsonText<AgentSpec>(eb.ref('manifest')).as('manifest'),'external_id' as const,jsonText<CreatedBySubject>(eb.ref('created_by_subject')).as('created_by_subject'),@@ -47,6 +48,7 @@ function toRecord(row: {id: string;tenant_id: string;name: AgentRecord['name'];+ description: string;manifest: AgentSpec;external_id: string | null;created_by_subject: CreatedBySubject;@@ -152,6 +154,7 @@ export class SqliteAgentStore implements IAgentStore<Transaction<Database>> {id: newId(),tenant_id: input.tenant_id,name: input.name,+ description: input.description,manifest: jsonbBind(input.manifest),external_id: input.external_id,created_by_subject: jsonbBind(input.created_by_subject),@@ -176,8 +179,8 @@ export class SqliteAgentStore implements IAgentStore<Transaction<Database>> {}async updateAgent(input: UpdateAgentInput, transaction?: Transaction<Database>): Promise<AgentRecord | undefined> {- if (input.manifest === undefined && input.external_id === undefined) {- throw new Error('updateAgent requires manifest and/or external_id');+ if (input.manifest === undefined && input.description === undefined && input.external_id === undefined) {+ throw new Error('updateAgent requires manifest, description, and/or external_id');}const db = transaction ?? this.#db;try {@@ -185,6 +188,7 @@ export class SqliteAgentStore implements IAgentStore<Transaction<Database>> {.updateTable('agent').set({...(input.manifest === undefined ? {} : { manifest: jsonbBind(input.manifest) }),+ ...(input.description === undefined ? {} : { description: input.description }),...(input.external_id === undefined ? {} : { external_id: input.external_id }),updated_at: nowIso(),})diff --git a/packages/trueforge/src/db/sqlite/migrations/20260911_000001_agent_description.ts b/packages/trueforge/src/db/sqlite/migrations/20260911_000001_agent_description.tsnew file mode 100644index 000000000..98cd85860--- /dev/null+++ b/packages/trueforge/src/db/sqlite/migrations/20260911_000001_agent_description.ts@@ -0,0 +1,15 @@+import { type Kysely, sql } from 'kysely';++/** Add agent `description`; backfill existing rows from `name`. Mirrors postgres. */+export async function up(db: Kysely<unknown>): Promise<void> {+ await db.transaction().execute(async trx => {+ await sql`ALTER TABLE agent ADD COLUMN description TEXT NOT NULL DEFAULT ''`.execute(trx);+ await sql`UPDATE agent SET description = name`.execute(trx);+ });+}++export async function down(db: Kysely<unknown>): Promise<void> {+ await db.transaction().execute(async trx => {+ await sql`ALTER TABLE agent DROP COLUMN description`.execute(trx);+ });+}diff --git a/packages/trueforge/src/db/sqlite/types.ts b/packages/trueforge/src/db/sqlite/types.tsindex 40cd28aa1..c4340877b 100644--- a/packages/trueforge/src/db/sqlite/types.ts+++ b/packages/trueforge/src/db/sqlite/types.ts@@ -227,6 +227,7 @@ export interface AgentTable {tenant_id: string;/** natural uniqueness target within a tenant */name: string;+ description: string;/** AgentSpec document; replaced whole on every upsert */manifest: JsonbColumn<AgentSpec>;external_id: string | null;diff --git a/packages/trueforge/src/routes/agentRoutes.ts b/packages/trueforge/src/routes/agentRoutes.tsindex cac16e525..aa1e88db7 100644--- a/packages/trueforge/src/routes/agentRoutes.ts+++ b/packages/trueforge/src/routes/agentRoutes.ts@@ -181,7 +181,7 @@ export const putAgentRoute = createRoute({path: '/{agent_id}',tags: [OpenApiTag.AGENTS],summary: 'Update an agent',- description: 'Replaces the manifest for an existing agent keyed by immutable `agent_id`.',+ description: 'Update an existing agent by immutable id.','x-fern-sdk-group-name': ['agents'],'x-fern-sdk-method-name': 'update',request: {diff --git a/packages/trueforge/src/schemas/agent.ts b/packages/trueforge/src/schemas/agent.tsindex 122e65fa4..4a77b7f4f 100644--- a/packages/trueforge/src/schemas/agent.ts+++ b/packages/trueforge/src/schemas/agent.ts@@ -12,20 +12,26 @@ import { NameSchema } from './common';const RESERVED_AGENT_NAMES = new Set(['tfg', 'trueforge']);+export const AGENT_DESCRIPTION_MAX_LENGTH = 1024;++export const AgentDescriptionSchema = z.string().trim().min(1).max(AGENT_DESCRIPTION_MAX_LENGTH);+/** Create body: unique immutable `name` plus manifest. `id` is never client-supplied. */export const CreateAgentRequestSchema = z.object({name: NameSchema.refine(name => !RESERVED_AGENT_NAMES.has(name), {message: 'Agent name is reserved, cannot be used',}),+ description: AgentDescriptionSchema,manifest: AgentSpecSchema,}).strict().openapi('CreateAgentRequest');-/** PUT body: full manifest replacement only. */+/** PUT body: full manifest replacement; `description` optional. */export const UpdateAgentRequestSchema = z.object({+ description: AgentDescriptionSchema.optional(),manifest: AgentSpecSchema,}).strict()@@ -36,12 +42,12 @@ export const AgentSchema = z.object({id: z.string().min(1).describe('Immutable server-generated agent identifier.'),name: NameSchema,+ description: AgentDescriptionSchema,manifest: AgentSpecSchema,created_by_subject: CreatedBySubjectSchema,}).strict().openapi('Agent');-export const GetAgentResponseSchema = z.object({ data: AgentSchema }).openapi('GetAgentResponse');export const ListAgentsResponseSchema = z.object({diff --git a/packages/trueforge/src/truefoundry/TrueFoundryAgentStore.ts b/packages/trueforge/src/truefoundry/TrueFoundryAgentStore.tsindex 4c9bfe819..46cec6cde 100644--- a/packages/trueforge/src/truefoundry/TrueFoundryAgentStore.ts+++ b/packages/trueforge/src/truefoundry/TrueFoundryAgentStore.ts@@ -15,6 +15,7 @@ import {} from '../db/agentStore';import { PostgresAgentStore } from '../db/postgres/agent-store/PostgresAgentStore';import type { Database } from '../db/postgres/types';+import { AGENT_DESCRIPTION_MAX_LENGTH } from '../schemas/agent';import { callerAccessToken, type ResolveAccessToken } from './accessToken';import {TrueFoundryServiceFoundryServerClient,@@ -27,14 +28,16 @@ function asError(value: unknown): Error {function toPutRemoteAgentPayload({name,+ description,manifest,}: {name: string;+ description: string;manifest: AgentSpec;}): Omit<PutRemoteAgentInput, 'accessToken'> {return {name,- description: name,+ description: (description || name).slice(0, AGENT_DESCRIPTION_MAX_LENGTH),model: manifest.model.name,mcp_servers: (manifest.mcp_servers ?? []).map(server => server.name),};@@ -55,11 +58,11 @@ function toPutRemoteAgentPayload({* update(external_id) fails after put: delete remote (if put returned an id), then* delete local; if cleanup also fails, AggregateError (primary + cleanup errors).*- * update (manifest)- * Happy path: lock → load row → put remote (new manifest) → write local.+ * update (manifest and/or description)+ * Happy path: lock → load row → put remote (new values) → write local.* Missing row: return undefined (no remote call).* putRemote fails: leave local unchanged; rethrow.- * local write fails after put: best-effort putRemote(old manifest); if restore fails,+ * local write fails after put: best-effort putRemote(old values); if restore fails,* AggregateError; if restore ok, rethrow the DB error (local still old, remote restored).* external_id-only patches skip ServiceFoundry and go straight to the inner store.*@@ -134,7 +137,11 @@ export class TrueFoundryAgentStore implements IAgentStore<Transaction<Database>>try {({ externalId } = await this.#client.putRemoteAgent({accessToken: await this.#resolveAccessToken(),- ...toPutRemoteAgentPayload({ name: input.name, manifest: input.manifest }),+ ...toPutRemoteAgentPayload({+ name: input.name,+ description: input.description,+ manifest: input.manifest,+ }),}));const updated = await this.#inner.updateAgent({ tenant_id: input.tenant_id, id: created.id, external_id: externalId },@@ -169,9 +176,8 @@ export class TrueFoundryAgentStore implements IAgentStore<Transaction<Database>>}async updateAgent(input: UpdateAgentInput, transaction?: Transaction<Database>): Promise<AgentRecord | undefined> {- const nextManifest = input.manifest;- if (nextManifest === undefined) {- // No manifest means only `external_id` changed; pass through to the inner store.+ if (input.manifest === undefined && input.description === undefined) {+ // No manifest/description means only `external_id` changed; pass through to the inner store.return this.#inner.updateAgent(input, transaction);}@@ -181,9 +187,16 @@ export class TrueFoundryAgentStore implements IAgentStore<Transaction<Database>>return undefined;}+ const nextManifest = input.manifest ?? previous.manifest;+ const nextDescription = input.description ?? previous.description;+const { externalId } = await this.#client.putRemoteAgent({accessToken: await this.#resolveAccessToken(),- ...toPutRemoteAgentPayload({ name: previous.name, manifest: nextManifest }),+ ...toPutRemoteAgentPayload({+ name: previous.name,+ description: nextDescription,+ manifest: nextManifest,+ }),});try {@@ -191,7 +204,8 @@ export class TrueFoundryAgentStore implements IAgentStore<Transaction<Database>>{tenant_id: input.tenant_id,id: input.id,- manifest: nextManifest,+ ...(input.manifest === undefined ? {} : { manifest: nextManifest }),+ ...(input.description === undefined ? {} : { description: nextDescription }),...(externalId === previous.external_id ? {} : { external_id: externalId }),},txn,@@ -202,6 +216,7 @@ export class TrueFoundryAgentStore implements IAgentStore<Transaction<Database>>accessToken: await this.#resolveAccessToken(),...toPutRemoteAgentPayload({name: previous.name,+ description: previous.description,manifest: previous.manifest,}),});diff --git a/packages/trueforge/tests/db/agentStoreContractSuite.ts b/packages/trueforge/tests/db/agentStoreContractSuite.tsindex e123b80f1..7393fdc1e 100644--- a/packages/trueforge/tests/db/agentStoreContractSuite.ts+++ b/packages/trueforge/tests/db/agentStoreContractSuite.ts@@ -30,12 +30,14 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'research',+ description: 'Research helper.',manifest: manifest(),external_id: null,});expect(created.tenant_id).toBe(TENANT);expect(created.name).toBe('research');+ expect(created.description).toBe('Research helper.');expect(created.id.length).toBeGreaterThan(0);expect(created.manifest).toEqual(manifest());expect(created.external_id).toBeNull();@@ -62,6 +64,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'research',+ description: 'Research helper.',manifest: manifest(),external_id: null,});@@ -70,6 +73,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {const updated = await store.updateAgent({tenant_id: TENANT,id: created.id,+ description: 'Updated research helper.',manifest: replacement,});@@ -77,6 +81,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {expect.objectContaining({id: created.id,name: 'research',+ description: 'Updated research helper.',manifest: replacement,created_at: created.created_at,}),@@ -107,6 +112,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'research',+ description: 'Test agent.',manifest: manifest(),external_id: null,});@@ -116,6 +122,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'research',+ description: 'Test agent.',manifest: manifest(),external_id: null,}),@@ -128,6 +135,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'zeta',+ description: 'Test agent.',manifest: manifest(),external_id: null,});@@ -135,6 +143,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'alpha',+ description: 'Test agent.',manifest: manifest({ instructions: 'Alpha agent.' }),external_id: null,});@@ -142,6 +151,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {tenant_id: 'other-tenant',created_by_subject: CREATED_BY_SUBJECT,name: 'research',+ description: 'Test agent.',manifest: manifest(),external_id: null,});@@ -162,6 +172,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'local-only',+ description: 'Test agent.',manifest: manifest(),external_id: null,});@@ -169,6 +180,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'linked',+ description: 'Test agent.',manifest: manifest(),external_id: 'sf-agent-1',});@@ -176,6 +188,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'other-linked',+ description: 'Test agent.',manifest: manifest(),external_id: 'sf-agent-2',});@@ -226,6 +239,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'alpha-bot',+ description: 'Test agent.',manifest: manifest(),external_id: null,});@@ -233,6 +247,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'bravo-bot',+ description: 'Test agent.',manifest: manifest(),external_id: null,});@@ -240,6 +255,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'unrelated',+ description: 'Test agent.',manifest: manifest(),external_id: null,});@@ -267,6 +283,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'charlie',+ description: 'Test agent.',manifest: manifest(),external_id: null,});@@ -274,6 +291,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'alpha',+ description: 'Test agent.',manifest: manifest(),external_id: null,});@@ -281,6 +299,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'bravo',+ description: 'Test agent.',manifest: manifest(),external_id: null,});@@ -312,6 +331,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'research',+ description: 'Test agent.',manifest: manifest(),external_id: null,});@@ -325,6 +345,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'research',+ description: 'Test agent.',manifest: manifest(),external_id: 'sf-agent-1',});@@ -338,6 +359,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'alpha',+ description: 'Test agent.',manifest: manifest(),external_id: 'shared-key',});@@ -346,6 +368,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'beta',+ description: 'Test agent.',manifest: manifest(),external_id: 'shared-key',}),@@ -354,6 +377,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {tenant_id: 'other-tenant',created_by_subject: CREATED_BY_SUBJECT,name: 'alpha',+ description: 'Test agent.',manifest: manifest(),external_id: 'shared-key',});@@ -361,6 +385,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'gamma',+ description: 'Test agent.',manifest: manifest(),external_id: null,});@@ -368,6 +393,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'delta',+ description: 'Test agent.',manifest: manifest(),external_id: null,});@@ -379,6 +405,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'research',+ description: 'Test agent.',manifest: manifest(),external_id: null,});@@ -402,6 +429,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'alpha',+ description: 'Test agent.',manifest: manifest(),external_id: 'shared-key',});@@ -409,6 +437,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'beta',+ description: 'Test agent.',manifest: manifest(),external_id: null,});diff --git a/packages/trueforge/tests/db/scheduleDispatchContractSuite.ts b/packages/trueforge/tests/db/scheduleDispatchContractSuite.tsindex 4d87c2df2..e7b922036 100644--- a/packages/trueforge/tests/db/scheduleDispatchContractSuite.ts+++ b/packages/trueforge/tests/db/scheduleDispatchContractSuite.ts@@ -71,6 +71,7 @@ export function runScheduleDispatchContractSuite<TTransaction>(deps: {tenant_id: TENANT,created_by_subject: USER_SUBJECT,name: `agent-${String(Date.now())}-${String(seq)}`,+ description: 'Test agent.',manifest: AgentSpecSchema.parse({model: { name: 'anthropic/claude-sonnet-4-6' },instructions: 'Be helpful.',diff --git a/packages/trueforge/tests/db/scheduleStoreContractSuite.ts b/packages/trueforge/tests/db/scheduleStoreContractSuite.tsindex 488fe53d3..3f2470daa 100644--- a/packages/trueforge/tests/db/scheduleStoreContractSuite.ts+++ b/packages/trueforge/tests/db/scheduleStoreContractSuite.ts@@ -31,6 +31,7 @@ export function runScheduleStoreContractSuite(deps: {tenant_id: TENANT,created_by_subject: USER_SUBJECT,name: `agent-${String(Date.now())}-${String(Math.random()).slice(2, 8)}`,+ description: 'Test agent.',manifest: AgentSpecSchema.parse({model: { name: 'anthropic/claude-sonnet-4-6' },instructions: 'Be helpful.',diff --git a/packages/trueforge/tests/unit/apis/agents.test.ts b/packages/trueforge/tests/unit/apis/agents.test.tsindex edf2ca0f7..dcdc1dd5f 100644--- a/packages/trueforge/tests/unit/apis/agents.test.ts+++ b/packages/trueforge/tests/unit/apis/agents.test.ts@@ -39,10 +39,12 @@ const manifest = {const writeBody = {name: 'research',+ description: 'Research helper.',manifest,};const updateBody = {+ description: 'Updated research agent.',manifest: {model: { name: 'anthropic/claude-sonnet-4-6' },instructions: 'Updated instructions.',@@ -52,6 +54,7 @@ const updateBody = {type WireAgent = {id: string;name: string;+ description: string;manifest: {model: { name: string };instructions?: string;@@ -115,12 +118,13 @@ describe('agents router', () => {});it('POST returns a wrapped Agent; PUT by immutable id keeps the same id', async () => {- const created = await router.request('/', jsonInit('POST', writeBody));+ const created = await router.request('/', jsonInit('POST', { ...writeBody, description: ' Research helper. ' }));expect(created.status).toBe(201);const createdJson = (await created.json()) as { data: WireAgent };expect(createdJson.data.id.length).toBeGreaterThan(0);expect(createdJson.data).toMatchObject({name: 'research',+ description: 'Research helper.',manifest: {model: { name: 'anthropic/claude-sonnet-4-6' },instructions: 'Be helpful.',@@ -141,10 +145,26 @@ describe('agents router', () => {const updatedJson = (await updated.json()) as { data: WireAgent };expect(updatedJson.data.id).toBe(createdJson.data.id);expect(updatedJson.data.name).toBe('research');+ expect(updatedJson.data.description).toBe('Updated research agent.');expect(updatedJson.data.manifest.instructions).toBe('Updated instructions.');expect(updatedJson.data).not.toHaveProperty('metadata');});+ it('PUT with only manifest keeps the stored description', async () => {+ const created = await router.request(+ '/',+ jsonInit('POST', { ...writeBody, name: 'keep-desc', description: 'Keep me.' }),+ );+ expect(created.status).toBe(201);+ const createdJson = (await created.json()) as { data: WireAgent };++ const updated = await router.request(`/${createdJson.data.id}`, jsonInit('PUT', { manifest: updateBody.manifest }));+ expect(updated.status).toBe(200);+ const updatedJson = (await updated.json()) as { data: WireAgent };+ expect(updatedJson.data.description).toBe('Keep me.');+ expect(updatedJson.data.manifest.instructions).toBe('Updated instructions.');+ });+it('PUT rejects metadata in the request body', async () => {const created = await router.request('/', jsonInit('POST', { ...writeBody, name: 'no-meta' }));expect(created.status).toBe(201);@@ -223,11 +243,21 @@ describe('agents router', () => {'/',jsonInit('POST', {name: 'other',+ description: 'Other agent.',manifest: { ...manifest, model: { name: 'missing/model' } },}),);expect(unknownModel.status).toBe(422);+ const blankDescription = await router.request(+ '/',+ jsonInit('POST', { ...writeBody, name: 'blank-desc', description: ' ' }),+ );+ expect(blankDescription.status).toBe(400);++ const missingDescription = await router.request('/', jsonInit('POST', { name: 'no-desc', manifest }));+ expect(missingDescription.status).toBe(400);+const first = await router.request('/', jsonInit('POST', { ...writeBody, name: 'alpha' }));expect(first.status).toBe(201);diff --git a/packages/trueforge/tests/unit/apis/schedules.test.ts b/packages/trueforge/tests/unit/apis/schedules.test.tsindex a9da14a3e..7be02cf23 100644--- a/packages/trueforge/tests/unit/apis/schedules.test.ts+++ b/packages/trueforge/tests/unit/apis/schedules.test.ts@@ -88,6 +88,7 @@ async function setup(authorizer: Authorizer = new TrueForgeAuthorizer()) {subject_display_name: 'alice',},name: 'reporter',+ description: 'Test agent.',manifest: AgentSpecSchema.parse({ model: { name: 'test-provider/test-model' }, instructions: 'test' }),external_id: 'reporter-external-id',});@@ -247,6 +248,7 @@ describe('schedule list agent_names filter', () => {subject_display_name: 'alice',},name: 'reporter-two',+ description: 'Test agent.',manifest: AgentSpecSchema.parse({ model: { name: 'test-provider/test-model' }, instructions: 'test' }),external_id: null,});@@ -436,6 +438,7 @@ describe('internal schedule execution', () => {subject_display_name: 'alice',},name: 'reporter',+ description: 'reporter description',manifest: AgentSpecSchema.parse({ model: { name: 'test-provider/test-model' }, instructions: 'test' }),external_id: 'reporter-external-id',});diff --git a/packages/trueforge/tests/unit/apis/sessionHttp.test.ts b/packages/trueforge/tests/unit/apis/sessionHttp.test.tsindex f4b51c7aa..2112b6fd1 100644--- a/packages/trueforge/tests/unit/apis/sessionHttp.test.ts+++ b/packages/trueforge/tests/unit/apis/sessionHttp.test.ts@@ -153,6 +153,7 @@ describe('sessions HTTP agent binding', () => {subject_display_name: STANDALONE_REQUEST_CONTEXT.subject.display_name,},name: 'named-agent',+ description: 'Test agent.',manifest: AgentSpecSchema.parse({model: { name: 'anthropic/claude-sonnet-4-6' },instructions: 'from-registry',@@ -185,6 +186,7 @@ describe('sessions HTTP agent binding', () => {subject_display_name: STANDALONE_REQUEST_CONTEXT.subject.display_name,},name: 'metrics-agent',+ description: 'Test agent.',manifest: inlineSpec,external_id: null,});@@ -244,6 +246,7 @@ describe('sessions HTTP agent binding', () => {tenant_id: 'default',created_by_subject: { subject_id: 'owner', subject_type: 'user', subject_display_name: 'Owner' },name: 'managed-agent',+ description: 'Test agent.',manifest: inlineSpec,external_id: 'managed-agent-external',});@@ -424,6 +427,7 @@ describe('sessions HTTP agent binding', () => {subject_display_name: STANDALONE_REQUEST_CONTEXT.subject.display_name,},name: 'named-agent',+ description: 'Test agent.',manifest: AgentSpecSchema.parse({model: { name: 'anthropic/claude-sonnet-4-6' },instructions: 'from-registry',@@ -605,6 +609,7 @@ describe('sessions HTTP agent binding', () => {subject_display_name: STANDALONE_REQUEST_CONTEXT.subject.display_name,},name: 'forbidden-agent',+ description: 'Test agent.',manifest: inlineSpec,external_id: null,});diff --git a/packages/trueforge/tests/unit/apis/turns.test.ts b/packages/trueforge/tests/unit/apis/turns.test.tsindex 426fbece4..42c872ad9 100644--- a/packages/trueforge/tests/unit/apis/turns.test.ts+++ b/packages/trueforge/tests/unit/apis/turns.test.ts@@ -124,6 +124,7 @@ describe('turns', () => {const agent = await agentStore.createAgent({tenant_id: 'default',name: 'managed-agent',+ description: 'Test agent.',manifest: AgentSpecSchema.parse({ model: { name: 'test-provider/test-model' } }),external_id: 'managed-agent-external',created_by_subject: { subject_id: 'owner', subject_type: 'user', subject_display_name: 'Owner' },@@ -433,6 +434,7 @@ describe('turns', () => {subject_display_name: STANDALONE_REQUEST_CONTEXT.subject.display_name,},name: 'named-for-turn',+ description: 'Test agent.',manifest: AgentSpecSchema.parse({model: { name: 'test-provider/test-model' },instructions: 'test',diff --git a/packages/trueforge/tests/unit/truefoundry/TrueFoundryAgentStore.test.ts b/packages/trueforge/tests/unit/truefoundry/TrueFoundryAgentStore.test.tsindex 12c1b1e97..9d66285fe 100644--- a/packages/trueforge/tests/unit/truefoundry/TrueFoundryAgentStore.test.ts+++ b/packages/trueforge/tests/unit/truefoundry/TrueFoundryAgentStore.test.ts@@ -59,6 +59,7 @@ function record(overrides: Partial<AgentRecord> = {}): AgentRecord {id: 'agent-1',tenant_id: TENANT,name: 'research',+ description: 'research',manifest: manifest(),external_id: null,created_by_subject: CREATED_BY_SUBJECT,@@ -183,6 +184,7 @@ describe('TrueFoundryAgentStore', () => {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'research',+ description: 'research',manifest: manifest({ mcp_servers: [{ name: 'slack' }] }),external_id: null,},@@ -220,6 +222,7 @@ describe('TrueFoundryAgentStore', () => {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'research',+ description: 'research',manifest: manifest(),external_id: null,},@@ -231,7 +234,7 @@ describe('TrueFoundryAgentStore', () => {expect(deleteRemoteAgent).not.toHaveBeenCalled();});- it('createAgent uses agent name as description even when instructions are empty', async () => {+ it('createAgent uses agent name as description when description is blank', async () => {const putRemoteAgent = jest.fn(async (input: PutRemoteAgentInput) => {expect(input.description).toBe('research');expect(input.mcp_servers).toEqual([]);@@ -249,6 +252,7 @@ describe('TrueFoundryAgentStore', () => {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'research',+ description: '',manifest: AgentSpecSchema.parse({ model: { name: 'openai-gateway/gpt-5' }, instructions: '' }),external_id: null,},@@ -257,6 +261,32 @@ describe('TrueFoundryAgentStore', () => {expect(putRemoteAgent).toHaveBeenCalled();});+ it('createAgent syncs description to ServiceFoundry', async () => {+ const putRemoteAgent = jest.fn(async (input: PutRemoteAgentInput) => {+ expect(input.description).toBe('Finds papers');+ return { externalId: 'sf-1' };+ });+ const createAgent = jest.fn(async () => record({ external_id: null, description: 'Finds papers' }));+ const updateAgent = jest.fn(async () => record({ external_id: 'sf-1', description: 'Finds papers' }));+ const store = tfStore({+ inner: mockInner({ createAgent, updateAgent }),+ client: mockClient({ putRemoteAgent }),+ });++ await store.createAgent(+ {+ tenant_id: TENANT,+ created_by_subject: CREATED_BY_SUBJECT,+ name: 'research',+ description: 'Finds papers',+ manifest: manifest(),+ external_id: null,+ },+ TXN,+ );+ expect(putRemoteAgent).toHaveBeenCalled();+ });+it('createAgent deletes the local row when putRemoteAgent fails', async () => {const local = record({ external_id: null });const createAgent = jest.fn(async () => local);@@ -277,6 +307,7 @@ describe('TrueFoundryAgentStore', () => {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'research',+ description: 'research',manifest: manifest(),external_id: null,},@@ -307,6 +338,7 @@ describe('TrueFoundryAgentStore', () => {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'research',+ description: 'research',manifest: manifest(),external_id: null,},@@ -343,6 +375,7 @@ describe('TrueFoundryAgentStore', () => {tenant_id: TENANT,created_by_subject: CREATED_BY_SUBJECT,name: 'research',+ description: 'research',manifest: manifest(),external_id: null,},diff --git a/packages/trueforge/tests/unit/truefoundry/TrueFoundryMcpServerStore.test.ts b/packages/trueforge/tests/unit/truefoundry/TrueFoundryMcpServerStore.test.tsindex 95c7c9586..2913b3870 100644--- a/packages/trueforge/tests/unit/truefoundry/TrueFoundryMcpServerStore.test.ts+++ b/packages/trueforge/tests/unit/truefoundry/TrueFoundryMcpServerStore.test.ts@@ -20,6 +20,7 @@ const AGENT: AgentRecord = {id: 'agent-1',tenant_id: TENANT,name: 'named',+ description: 'Test agent.',manifest: AgentSpecSchema.parse({ model: { name: 'p/m' } }),external_id: 'ext-agent',created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'User' },diff --git a/packages/trueforge/tests/unit/truefoundry/TrueFoundryModelProviderStore.test.ts b/packages/trueforge/tests/unit/truefoundry/TrueFoundryModelProviderStore.test.tsindex 652c42056..454c77ff0 100644--- a/packages/trueforge/tests/unit/truefoundry/TrueFoundryModelProviderStore.test.ts+++ b/packages/trueforge/tests/unit/truefoundry/TrueFoundryModelProviderStore.test.ts@@ -13,6 +13,7 @@ const AGENT: AgentRecord = {id: 'agent-1',tenant_id: TENANT,name: 'named',+ description: 'Test agent.',manifest: AgentSpecSchema.parse({ model: { name: 'p/m' } }),external_id: 'ext-agent',created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'User' },diff --git a/packages/trueforge/tests/unit/truefoundry/accessToken.test.ts b/packages/trueforge/tests/unit/truefoundry/accessToken.test.tsindex bddd67fc3..99b5143db 100644--- a/packages/trueforge/tests/unit/truefoundry/accessToken.test.ts+++ b/packages/trueforge/tests/unit/truefoundry/accessToken.test.ts@@ -24,6 +24,7 @@ const AGENT: AgentRecord = {id: 'agent-1',tenant_id: 'acme',name: 'named',+ description: 'Test agent.',manifest: AgentSpecSchema.parse({ model: { name: 'p/m' } }),external_id: 'ext-agent',created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'User' },diff --git a/pnpm-lock.yaml b/pnpm-lock.yamlindex d91ce6711..be90d6ee2 100644--- a/pnpm-lock.yaml+++ b/pnpm-lock.yaml@@ -69,8 +69,8 @@ importers:specifier: 0.2.21version: 0.2.21(@assistant-ui/[email protected](@types/[email protected])([email protected]))(@types/[email protected])([email protected])'@truefoundry/assistant-ui-runtime':- specifier: 0.1.36- version: 0.1.36(@assistant-ui/[email protected](@types/[email protected])([email protected]))(@types/[email protected])([email protected]([email protected](@opentelemetry/[email protected])))([email protected])([email protected](@opentelemetry/[email protected]))([email protected])([email protected](@types/[email protected])([email protected])([email protected]([email protected])))+ specifier: 0.1.37+ version: 0.1.37(@assistant-ui/[email protected](@types/[email protected])([email protected]))(@types/[email protected])([email protected]([email protected](@opentelemetry/[email protected])))([email protected])([email protected](@opentelemetry/[email protected]))([email protected])([email protected](@types/[email protected])([email protected])([email protected]([email protected])))'@truefoundry/trueforge-sdk':specifier: workspace:*version: link:../trueforge-sdk@@ -366,8 +366,8 @@ importers:specifier: ^0.13.2version: 0.13.3(@openuidev/[email protected]([email protected])([email protected](@types/[email protected])([email protected])([email protected]([email protected]))))(@openuidev/[email protected](@modelcontextprotocol/[email protected]([email protected])([email protected]))([email protected])([email protected]))(@types/[email protected](@types/[email protected]))(@types/[email protected])([email protected]([email protected]))([email protected])([email protected])([email protected])([email protected](@types/[email protected])([email protected])([email protected]([email protected])))'@truefoundry/assistant-ui-runtime':- specifier: 0.1.36- version: 0.1.36(@assistant-ui/[email protected](@types/[email protected])([email protected]))(@types/[email protected])([email protected]([email protected](@opentelemetry/[email protected])))([email protected])([email protected](@opentelemetry/[email protected]))([email protected])([email protected](@types/[email protected])([email protected])([email protected]([email protected])))+ specifier: 0.1.37+ version: 0.1.37(@assistant-ui/[email protected](@types/[email protected])([email protected]))(@types/[email protected])([email protected]([email protected](@opentelemetry/[email protected])))([email protected])([email protected](@opentelemetry/[email protected]))([email protected])([email protected](@types/[email protected])([email protected])([email protected]([email protected])))'@truefoundry/trueforge-sdk':specifier: workspace:*version: link:../trueforge-sdk@@ -1077,12 +1077,6 @@ packages:cpu: [ppc64]os: [aix]- '@esbuild/[email protected]':- resolution: {integrity: sha512-Svl7tq8k/08+p6CXPpRjQ1fKX+1odH/BQbb48fV6fj3CWHhsoIOoY87w1oHXm0qEpkIK3ZfVgp0hed3XBXzXMQ==}- engines: {node: '>=18'}- cpu: [ppc64]- os: [aix]-'@esbuild/[email protected]':resolution: {integrity: sha512-XExcO+dvLKvVtNTibSTBej1NCAbaGhWn9Ww1ZPx80qsahhPFe/8jgWP0IchNe0F3HwkU7n8ejhH8bjonqht8mQ==}engines: {node: '>=18'}@@ -1101,12 +1095,6 @@ packages:cpu: [arm64]os: [android]- '@esbuild/[email protected]':- resolution: {integrity: sha512-34EGEbCIAgosYz6goLcopX6Mo7NyGv9tfwEM2/7Ce2VcVRk568iSvniGWcUXIy7wEDR1wzolcxcriFVrWYcwBg==}- engines: {node: '>=18'}- cpu: [arm64]- os: [android]-'@esbuild/[email protected]':resolution: {integrity: sha512-5YfKeeI8qWfBZIX+u2xZC3Zlb3Os/gLS2sbEKM+I4ZOcsWmHS2WLysCcQZDAFRslDUU5Oiq44gf6PYN1vGwG5A==}engines: {node: '>=18'}@@ -1125,12 +1113,6 @@ packages:cpu: [arm]os: [android]- '@esbuild/[email protected]':- resolution: {integrity: sha512-0k2F129Xdio1TdJfzJ8sy1Q47vUD2NnwdhiAf7drUN1EBTfPf4hsFCtmMgu/6m8JSzsBrlmVjudMBQqOfG8usQ==}- engines: {node: '>=18'}- cpu: [arm]- os: [android]-'@esbuild/[email protected]':resolution: {integrity: sha512-kXXoiPVVGQcnIYGOeaovwOURpniDBpSq4A03qkQ+BMQqtGG6HYap3xne9C1O1yo4TR3qxlCX5IqqmX6fFo2Lqg==}engines: {node: '>=18'}@@ -1149,12 +1131,6 @@ packages:cpu: [x64]os: [android]- '@esbuild/[email protected]':- resolution: {integrity: sha512-dbwY7ltSMDWsRatcRpCnES4F+im88OCUgGZjy52shC7GqHRE/cYlxNbB4Z4UpJswpcc4Qxd2oE/ufM0p61IKng==}- engines: {node: '>=18'}- cpu: [x64]- os: [android]-'@esbuild/[email protected]':resolution: {integrity: sha512-O387ite7SzUyCcy3JQX4P4bLtEA7bLLkx+esve5JHnyYfNTxcVpXZo9jhdB0lTKN44gztELTdU7nS8Nr16Fs1Q==}engines: {node: '>=18'}@@ -1173,12 +1149,6 @@ packages:cpu: [arm64]os: [darwin]- '@esbuild/[email protected]':- resolution: {integrity: sha512-TZbWkQY7kvTAXbXUT7uVACR5cMHsDiSz9z7ZKAX/RTq/WJEk3QyRr0wZpNhBDX+/0CtdqUIJlOiodQcta6tY3Q==}- engines: {node: '>=18'}- cpu: [arm64]- os: [darwin]-'@esbuild/[email protected]':resolution: {integrity: sha512-n4KqkOQrraxHJcgjM1RvwbigfQKIKJVpM7xp+KsxiyUSrRdIXnt73VhrPAx0fV44hgfmIVKjxMN9J1t5jySVkw==}engines: {node: '>=18'}@@ -1197,12 +1167,6 @@ packages:cpu: [x64]os: [darwin]- '@esbuild/[email protected]':- resolution: {integrity: sha512-zfdzgK9ACBNZLI/CyHTOx81SyNbM6YXn7rxSgX97VjyiPl9W1i4Ka4fgKECEoFCKGpvBj5qArWIGgQjOwkgskQ==}- engines: {node: '>=18'}- cpu: [x64]- os: [darwin]-'@esbuild/[email protected]':resolution: {integrity: sha512-uq6suIWYP37qzGddBKPw5QEQPi6HiLGsO7UmkpfyaYNQ3D+rN6w6WfwH+nuqcGXWvawGwxOEroO4YGnFh95azw==}engines: {node: '>=18'}@@ -1221,12 +1185,6 @@ packages:cpu: [arm64]os: [freebsd]- '@esbuild/[email protected]':- resolution: {integrity: sha512-wG2EA8ENdEI0qhkSZMjfqrdY+ziCYCPMmtZjjIwOmXFjmyzEHn+UUxk5of+SYsjtfs3VpnlC7QLzSI5hY/rOAw==}- engines: {node: '>=18'}- cpu: [arm64]- os: [freebsd]-'@esbuild/[email protected]':resolution: {integrity: sha512-n+I0BTSRIoy+d6RPKnEVwql5UwBJolytvY4mAOIEJorKlqgPII8ix6slVVrfZ5Tnj7glIZvloylbB/EJPMWEXw==}engines: {node: '>=18'}@@ -1245,12 +1203,6 @@ packages:cpu: [x64]os: [freebsd]- '@esbuild/[email protected]':- resolution: {integrity: sha512-i7dZ9vQgnvSCzi/rYCXNgtF/U+eKZNJBzu3eTQbRgHnM7tNSizLOkRFAl3qzVc/Op/u5YkHHa4pf/3DOYHthLQ==}- engines: {node: '>=18'}- cpu: [x64]- os: [freebsd]-'@esbuild/[email protected]':resolution: {integrity: sha512-78XJTJkvPs0kz2w61301PJjXl4g7q3JqiYMZ/M/yVI73EHBrCRTgkhu9oqG7vPqq+a/yadEW8aD+agKlk5xrmg==}engines: {node: '>=18'}@@ -1269,12 +1221,6 @@ packages:cpu: [arm64]os: [linux]- '@esbuild/[email protected]':- resolution: {integrity: sha512-yHs+0uc8+nvEAfAfxrWQKK5peSNzBc4PegcMO0EJ2hT71uA7vB8Ihg2e77R2P7SG5uYjPbHlLLmve4LLLRCf0g==}- engines: {node: '>=18'}- cpu: [arm64]- os: [linux]-'@esbuild/[email protected]':resolution: {integrity: sha512-pW4AC0P3it8c7do9MVM4p51FzHzdM/TZrerurgRcHJ2WTa1VQ1CIq18xncfpBJw4ojkiZZrKW2yIBWBP92j6Ug==}engines: {node: '>=18'}@@ -1293,12 +1239,6 @@ packages:cpu: [arm]os: [linux]- '@esbuild/[email protected]':- resolution: {integrity: sha512-qVXBOHQS+d5Y722GwJzJUtOLlX7km3CraOaGormF1pDtPd2C/l1SHRPgjLunLGe51Sh5YYWKMFDyV4SxgMQYTQ==}- engines: {node: '>=18'}- cpu: [arm]- os: [linux]-'@esbuild/[email protected]':resolution: {integrity: sha512-XlDnu2q5yoqems+xay6wSAcg9DDD7K9RLKZEBOMZm3ckNpJBvOX20tSfby8KfrrhINDyv9V2YVZKY/SpoGJI8w==}engines: {node: '>=18'}@@ -1317,12 +1257,6 @@ packages:cpu: [ia32]os: [linux]- '@esbuild/[email protected]':- resolution: {integrity: sha512-d1z4ZuP0ajrfz/FhGT4vv278rX8KnPPJx8i5+AtK7TYbx9Le9F1hyzurZpkEyjkGa9dUGhQow4C1NmeGvqxN2w==}- engines: {node: '>=18'}- cpu: [ia32]- os: [linux]-'@esbuild/[email protected]':resolution: {integrity: sha512-CYbnj78HsIeA+DhgUKgFCfvNsTHFhMMrinUrMZpDXJXKN8T3XViTZ/+wtHeVxEWY8ewSzTFN+nRmSwO2tZaLUQ==}engines: {node: '>=18'}@@ -1341,12 +1275,6 @@ packages:cpu: [loong64]os: [linux]- '@esbuild/[email protected]':- resolution: {integrity: sha512-M5sRjUVZrkm1OAPR3dlOYzNmN+loZKGVi1VUQGrwuqLcbR6qeAz+famMhjASeH3YVKvZz+zT1jlh/keC3Rj/lg==}- engines: {node: '>=18'}- cpu: [loong64]- os: [linux]-'@esbuild/[email protected]':resolution: {integrity: sha512-buwkd8nsph4R+ajRvw0qM5Hja/TXQow3ptzWO2EbG/cqcIkHloRrdlBtQlshyYGTNFvfkfJ5tpPLVkY4DtsPfQ==}engines: {node: '>=18'}@@ -1365,12 +1293,6 @@ packages:cpu: [mips64el]os: [linux]- '@esbuild/[email protected]':- resolution: {integrity: sha512-mRObBZeHh2OxcBFPWE/FjylkRgZdYuiTR3vaTozquCGOH14iP9oN4x4Ge81CoIDYQrXmIxpFumJBu5MtZpnQJQ==}- engines: {node: '>=18'}- cpu: [mips64el]- os: [linux]-'@esbuild/[email protected]':resolution: {integrity: sha512-ZVykbDyk7519VwiNb9Lcj9m8XM6v5V9uKPvrEMkkEedVewf+0itkhahp4HDpgERXhwLRpWFypsGbG/J8s0QjJA==}engines: {node: '>=18'}@@ -1389,12 +1311,6 @@ packages:cpu: [ppc64]os: [linux]- '@esbuild/[email protected]':- resolution: {integrity: sha512-slScBsMAb3GFDcdrCgLwZtPYRoH2H/youv10QiZyRjmsP48fznoveWytSgCI/R0ZcUgpc0ZhIUEx6LHts8yrfQ==}- engines: {node: '>=18'}- cpu: [ppc64]- os: [linux]-'@esbuild/[email protected]':resolution: {integrity: sha512-CAXl+Dtd9UUuJd8pKKdwh6MLm3MUMiqMPmhZ3tTSXPqfyQ3vDl6R5hZdZ/kYojK4ofXtdfSv1tFq8XzWx3heNQ==}engines: {node: '>=18'}@@ -1413,12 +1329,6 @@ packages:cpu: [riscv64]os: [linux]- '@esbuild/[email protected]':- resolution: {integrity: sha512-kw0owk1o0GFETUJyW0jc0G4Yzs0BHZn0JDZ8JRT088vjJYX777BAs1fDGxAC+q831qOs2DTC96mNsG2opdfyyQ==}- engines: {node: '>=18'}- cpu: [riscv64]- os: [linux]-'@esbuild/[email protected]':resolution: {integrity: sha512-GeXCej4IQtU1B+QlDV8W/RRvbzI3O/Stss+/bCXv4lZls5WGRtu2a+3JkA3i4qIUlMXpcHebWpF8AkJhATowuA==}engines: {node: '>=18'}@@ -1437,12 +1347,6 @@ packages:cpu: [s390x]os: [linux]- '@esbuild/[email protected]':- resolution: {integrity: sha512-/lAIjX8aYFRByhh6L5rYtPEDRqa9de/4V/juOXcta5frjvzXO4/sqEtyytse0g3zZFuWu5cDN0MkLz2qRDD2Ag==}- engines: {node: '>=18'}- cpu: [s390x]- os: [linux]-'@esbuild/[email protected]':resolution: {integrity: sha512-3H1weTYZPxt/WOhByszQZybS9w5lKzUn1FDMsgEChbHWQwHYQQRfBxgCcZvPhjHfKyJjIievvMmEUawJrdY9Dg==}engines: {node: '>=18'}@@ -1461,12 +1365,6 @@ packages:cpu: [x64]os: [linux]- '@esbuild/[email protected]':- resolution: {integrity: sha512-u/anNYF2mmVOEDwLtnQ1wOr3EZ9sTNGLWrsYGYwHWzGA3Si84IOkHXlbWTD1NB+9/1lcnweYKO54uhxZydNzfA==}- engines: {node: '>=18'}- cpu: [x64]- os: [linux]-'@esbuild/[email protected]':resolution: {integrity: sha512-4xTZr1FUmSoQW4XIWmit3tzQrUTZM+N3P0XV8xROKYF50XfI7xeO90+1bZvNwxIufQ9hDQVRJH5YhgPVF8A/HQ==}engines: {node: '>=18'}@@ -1485,12 +1383,6 @@ packages:cpu: [arm64]os: [netbsd]- '@esbuild/[email protected]':- resolution: {integrity: sha512-oks0DYbLwWMmaakTsCb+zL4E+aHRVLom9IJZOAthMQEPiQmydXHkziYEsGYRx0uNV/IjEKGAV941JzH02pflqw==}- engines: {node: '>=18'}- cpu: [arm64]- os: [netbsd]-'@esbuild/[email protected]':resolution: {integrity: sha512-sSATRjPeDBg3pdgHoQfoYBob11Kk1FGa9lui5RIHZCoCkJa9QKlvl3/vKz2usCmYYjs7ymJR/2Nnsqe+Hjt5nw==}engines: {node: '>=18'}@@ -1509,12 +1401,6 @@ packages:cpu: [x64]os: [netbsd]- '@esbuild/[email protected]':- resolution: {integrity: sha512-aeL6lAnN89Hz43Mlh1G8ARasbuoYvSITDEx0tHh5b7jJnHcssqgjy9Yx430GDpmCa6OyrKoS0aNRjKundRizGg==}- engines: {node: '>=18'}- cpu: [x64]- os: [netbsd]-'@esbuild/[email protected]':resolution: {integrity: sha512-lqnzCV+mM0gIADaKihiCg6ifgfU2L3h5E33rNQBN1Y4MaVGnzryzmvvf7UHxprpQdE8hpqLolJ9Rl+SkIRDpyw==}engines: {node: '>=18'}@@ -1533,12 +1419,6 @@ packages:cpu: [arm64]os: [openbsd]- '@esbuild/[email protected]':- resolution: {integrity: sha512-MEFJe5C3R8pwXdZ5Y21oo6m7ePiS0d9pWucn99O/wvyJZChoIQKrQDxKrGeW8F5+T0okTHesAmDeiHDTIq0V/Q==}- engines: {node: '>=18'}- cpu: [arm64]- os: [openbsd]-'@esbuild/[email protected]':resolution: {integrity: sha512-AL2qJILH7lNjrDmCQDvdxMfAUIv8KMNZOvrwAQ8i8//ntL9FflhOyMJ8OZSMBb8/AWXe3/5v5S20y3zCoZWKoQ==}engines: {node: '>=18'}@@ -1557,12 +1437,6 @@ packages:cpu: [x64]os: [openbsd]- '@esbuild/[email protected]':- resolution: {integrity: sha512-i/ZLIOafE0Z8cI/XANJAixoJL/uRAoS2xOA3rb0xN+KK0K177cMAsQYkzHtBrtMXAKuAc7HGgcWiZ/sRC1Nxgw==}- engines: {node: '>=18'}- cpu: [x64]- os: [openbsd]-'@esbuild/[email protected]':resolution: {integrity: sha512-QtiuPytchRyC4rwUKhexJdQKvDuZ6hWloi3igqPQNUJCS1/v9EiO3UTOXR6A3FoMo4fnAKbWJdqaIwhOzh8qEw==}engines: {node: '>=18'}@@ -1581,12 +1455,6 @@ packages:cpu: [arm64]os: [openharmony]- '@esbuild/[email protected]':- resolution: {integrity: sha512-ge+Z7EXFNt2BO1oAMsVpiQ8EwndV9i1xXerAeTIK7AtPs3bKFXQM7nlRxDSIUIMeueR1CNXxqztLzdNeReKBJg==}- engines: {node: '>=18'}- cpu: [arm64]- os: [openharmony]-'@esbuild/[email protected]':resolution: {integrity: sha512-WkhYDmpTjLvGlScA1rwjRUmhl4k8oXR3cIbtqWmELgU/dFeHHlEllxDvdWcNJV9rbzCexB5vz8gtNewWLgCT7Q==}engines: {node: '>=18'}@@ -1605,12 +1473,6 @@ packages:cpu: [x64]os: [sunos]- '@esbuild/[email protected]':- resolution: {integrity: sha512-BEjgtECkL3vY+SaSQ6nzVfiALUeFxpawyp8Jmf5PtYhf1Ug40N1h/hxlhts+f1FvSvarEigdxS3BlSMI2PJLcQ==}- engines: {node: '>=18'}- cpu: [x64]- os: [sunos]-'@esbuild/[email protected]':resolution: {integrity: sha512-GPMSkTOtMnv2U2F8gxe4Io6qmVs+YKyp832Etqqxr0hFngmXQ3rzwytelm3GIn7T4VviRUlf3sOgBOiTdvaf7g==}engines: {node: '>=18'}@@ -1629,12 +1491,6 @@ packages:cpu: [arm64]os: [win32]- '@esbuild/[email protected]':- resolution: {integrity: sha512-lCv9eK/H6ZJWbE7bh2nw54CZ9M2nupBxJcTsdk/QQnWkdSjKGuxmmH8/GWrlT1eMmZfn4dGcCjRte397WqfQXA==}- engines: {node: '>=18'}- cpu: [arm64]- os: [win32]-'@esbuild/[email protected]':resolution: {integrity: sha512-PIhhEkE9uPBleRBrQEJpUn7MBnibZzbGzYWPmY3x+YoVg/95zbjB4CxPPOQ8l5tYYM4mMaCthF8/1DIfBQQyWQ==}engines: {node: '>=18'}@@ -1653,12 +1509,6 @@ packages:cpu: [ia32]os: [win32]- '@esbuild/[email protected]':- resolution: {integrity: sha512-zvb/mB2bSCoJOpoCBgYKKpX6YM6mJBlBUVUtVj41DlZJVEB6/0CKlRYxP5wWl1C1ILiCoAU5wZZ4q1P3qeS6Eg==}- engines: {node: '>=18'}- cpu: [ia32]- os: [win32]-'@esbuild/[email protected]':resolution: {integrity: sha512-YmJbfTlvU7Sdn9BB+4PRES4oB6pxgS37MAONj+hBr/cpXS1aBPKXxNnDbu+QCWPj0o9dgyxeq79g6c5P8KeuYA==}engines: {node: '>=18'}@@ -1677,12 +1527,6 @@ packages:cpu: [x64]os: [win32]- '@esbuild/[email protected]':- resolution: {integrity: sha512-bm4Mowrv+GXMlpWX++EcXw/iLyd1o3+bJkC2DkWXYVvgZCqD/bSj9ctZeAMC3cIxgjRVR2Dufaiu4YPxr5gW1A==}- engines: {node: '>=18'}- cpu: [x64]- os: [win32]-'@esbuild/[email protected]':resolution: {integrity: sha512-5ebpxr3nWMzrL/rnUI755Jkuee0bHL/Gq0WTF9lvcpv73wAp5eu8MfBUgWK9bhWvZjj7yX8etf/8tI8Ney695g==}engines: {node: '>=18'}@@ -3648,8 +3492,8 @@ packages:'@types/react-dom':optional: true- '@truefoundry/[email protected]':- resolution: {integrity: sha512-bjI3lRfvmTwy44hKHlf/RuJN8eLqIpm6ph9rjjBKXw/5D1fGWdGJCB/TDzeSDAHPGij63yJkFCvYXEbMdDx8Kg==}+ '@truefoundry/[email protected]':+ resolution: {integrity: sha512-nFWitRLb6umJofzjjd/1+XhL7QzJ77tw+hTyriCEdb+9E7R8Z4qwM8ZMmmkC4b7P7P18LqgGh+kqYinaqsTRQg==}peerDependencies:'@types/react': '*'react: ^18 || ^19@@ -4828,11 +4672,6 @@ packages:engines: {node: '>=18'}hasBin: true- resolution: {integrity: sha512-HrJrvZv5ayxBzPfwphOoNzkzOIIlifzk0KJrGK2c8R4+LKpMtpYLQeUdjnwjWv/LZlkH2laZk+4w78pi99D4Vw==}- engines: {node: '>=18'}- hasBin: true-resolution: {integrity: sha512-HKVLS8dvII+xoKW9kmqxbRKrnWEXfJJr/FZhhJmiqIB0e053QNYFqOBouTMO/k5sID4MvCiUCvv8b9M4h32wIA==}engines: {node: '>=18'}@@ -8497,9 +8336,6 @@ snapshots:'@esbuild/[email protected]':optional: true- '@esbuild/[email protected]':- optional: true-'@esbuild/[email protected]':optional: true@@ -8509,9 +8345,6 @@ snapshots:'@esbuild/[email protected]':optional: true- '@esbuild/[email protected]':- optional: true-'@esbuild/[email protected]':optional: true@@ -8521,9 +8354,6 @@ snapshots:'@esbuild/[email protected]':optional: true- '@esbuild/[email protected]':- optional: true-'@esbuild/[email protected]':optional: true@@ -8533,9 +8363,6 @@ snapshots:'@esbuild/[email protected]':optional: true- '@esbuild/[email protected]':- optional: true-'@esbuild/[email protected]':optional: true@@ -8545,9 +8372,6 @@ snapshots:'@esbuild/[email protected]':optional: true- '@esbuild/[email protected]':- optional: true-'@esbuild/[email protected]':optional: true@@ -8557,9 +8381,6 @@ snapshots:'@esbuild/[email protected]':optional: true- '@esbuild/[email protected]':- optional: true-'@esbuild/[email protected]':optional: true@@ -8569,9 +8390,6 @@ snapshots:'@esbuild/[email protected]':optional: true- '@esbuild/[email protected]':- optional: true-'@esbuild/[email protected]':optional: true@@ -8581,9 +8399,6 @@ snapshots:'@esbuild/[email protected]':optional: true- '@esbuild/[email protected]':- optional: true-'@esbuild/[email protected]':optional: true@@ -8593,9 +8408,6 @@ snapshots:'@esbuild/[email protected]':optional: true- '@esbuild/[email protected]':- optional: true-'@esbuild/[email protected]':optional: true@@ -8605,9 +8417,6 @@ snapshots:'@esbuild/[email protected]':optional: true- '@esbuild/[email protected]':- optional: true-'@esbuild/[email protected]':optional: true@@ -8617,9 +8426,6 @@ snapshots:'@esbuild/[email protected]':optional: true- '@esbuild/[email protected]':- optional: true-'@esbuild/[email protected]':optional: true@@ -8629,9 +8435,6 @@ snapshots:'@esbuild/[email protected]':optional: true- '@esbuild/[email protected]':- optional: true-'@esbuild/[email protected]':optional: true@@ -8641,9 +8444,6 @@ snapshots:'@esbuild/[email protected]':optional: true- '@esbuild/[email protected]':- optional: true-'@esbuild/[email protected]':optional: true@@ -8653,9 +8453,6 @@ snapshots:'@esbuild/[email protected]':optional: true- '@esbuild/[email protected]':- optional: true-'@esbuild/[email protected]':optional: true@@ -8665,9 +8462,6 @@ snapshots:'@esbuild/[email protected]':optional: true- '@esbuild/[email protected]':- optional: true-'@esbuild/[email protected]':optional: true@@ -8677,9 +8471,6 @@ snapshots:'@esbuild/[email protected]':optional: true- '@esbuild/[email protected]':- optional: true-'@esbuild/[email protected]':optional: true@@ -8689,9 +8480,6 @@ snapshots:'@esbuild/[email protected]':optional: true- '@esbuild/[email protected]':- optional: true-'@esbuild/[email protected]':optional: true@@ -8701,9 +8489,6 @@ snapshots:'@esbuild/[email protected]':optional: true- '@esbuild/[email protected]':- optional: true-'@esbuild/[email protected]':optional: true@@ -8713,9 +8498,6 @@ snapshots:'@esbuild/[email protected]':optional: true- '@esbuild/[email protected]':- optional: true-'@esbuild/[email protected]':optional: true@@ -8725,9 +8507,6 @@ snapshots:'@esbuild/[email protected]':optional: true- '@esbuild/[email protected]':- optional: true-'@esbuild/[email protected]':optional: true@@ -8737,9 +8516,6 @@ snapshots:'@esbuild/[email protected]':optional: true- '@esbuild/[email protected]':- optional: true-'@esbuild/[email protected]':optional: true@@ -8749,9 +8525,6 @@ snapshots:'@esbuild/[email protected]':optional: true- '@esbuild/[email protected]':- optional: true-'@esbuild/[email protected]':optional: true@@ -8761,9 +8534,6 @@ snapshots:'@esbuild/[email protected]':optional: true- '@esbuild/[email protected]':- optional: true-'@esbuild/[email protected]':optional: true@@ -8773,9 +8543,6 @@ snapshots:'@esbuild/[email protected]':optional: true- '@esbuild/[email protected]':- optional: true-'@esbuild/[email protected]':optional: true@@ -8785,9 +8552,6 @@ snapshots:'@esbuild/[email protected]':optional: true- '@esbuild/[email protected]':- optional: true-'@esbuild/[email protected]':optional: true@@ -8797,9 +8561,6 @@ snapshots:'@esbuild/[email protected]':optional: true- '@esbuild/[email protected]':- optional: true-'@esbuild/[email protected]':optional: true@@ -10908,7 +10669,7 @@ snapshots:'@types/react': 19.2.18'@types/react-dom': 19.2.5(@types/[email protected])- '@truefoundry/[email protected](@assistant-ui/[email protected](@types/[email protected])([email protected]))(@types/[email protected])([email protected]([email protected](@opentelemetry/[email protected])))([email protected])([email protected](@opentelemetry/[email protected]))([email protected])([email protected](@types/[email protected])([email protected])([email protected]([email protected])))':+ '@truefoundry/[email protected](@assistant-ui/[email protected](@types/[email protected])([email protected]))(@types/[email protected])([email protected]([email protected](@opentelemetry/[email protected])))([email protected])([email protected](@opentelemetry/[email protected]))([email protected])([email protected](@types/[email protected])([email protected])([email protected]([email protected])))':dependencies:'@assistant-ui/core': 0.2.22(@assistant-ui/[email protected](@assistant-ui/[email protected](@types/[email protected])([email protected]))(@types/[email protected])([email protected]))(@assistant-ui/[email protected](@types/[email protected])([email protected]))(@types/[email protected])([email protected]([email protected](@opentelemetry/[email protected])))([email protected])([email protected](@opentelemetry/[email protected]))([email protected](@types/[email protected])([email protected])([email protected]([email protected])))'@assistant-ui/store': 0.2.21(@assistant-ui/[email protected](@types/[email protected])([email protected]))(@types/[email protected])([email protected])@@ -11098,10 +10859,10 @@ snapshots:transitivePeerDependencies:- supports-color- '@typescript-eslint/[email protected](@typescript-eslint/[email protected]([email protected]([email protected])([email protected]))([email protected])([email protected]))([email protected]([email protected])([email protected]))([email protected])([email protected])':+ '@typescript-eslint/[email protected](@typescript-eslint/[email protected]([email protected]([email protected])([email protected]))([email protected])([email protected]))([email protected]([email protected])([email protected]))([email protected])([email protected])':dependencies:'@eslint-community/regexpp': 4.12.2- '@typescript-eslint/parser': 8.68.0([email protected]([email protected])([email protected]))([email protected])([email protected])+ '@typescript-eslint/parser': 8.68.0([email protected]([email protected])([email protected]))([email protected])([email protected])'@typescript-eslint/scope-manager': 8.68.0'@typescript-eslint/type-utils': 8.68.0([email protected]([email protected])([email protected]))([email protected])([email protected])'@typescript-eslint/utils': 8.68.0([email protected]([email protected])([email protected]))([email protected])([email protected])@@ -12169,35 +11930,6 @@ snapshots:'@esbuild/win32-ia32': 0.27.7'@esbuild/win32-x64': 0.27.7- optionalDependencies:- '@esbuild/aix-ppc64': 0.28.1- '@esbuild/android-arm': 0.28.1- '@esbuild/android-arm64': 0.28.1- '@esbuild/android-x64': 0.28.1- '@esbuild/darwin-arm64': 0.28.1- '@esbuild/darwin-x64': 0.28.1- '@esbuild/freebsd-arm64': 0.28.1- '@esbuild/freebsd-x64': 0.28.1- '@esbuild/linux-arm': 0.28.1- '@esbuild/linux-arm64': 0.28.1- '@esbuild/linux-ia32': 0.28.1- '@esbuild/linux-loong64': 0.28.1- '@esbuild/linux-mips64el': 0.28.1- '@esbuild/linux-ppc64': 0.28.1- '@esbuild/linux-riscv64': 0.28.1- '@esbuild/linux-s390x': 0.28.1- '@esbuild/linux-x64': 0.28.1- '@esbuild/netbsd-arm64': 0.28.1- '@esbuild/netbsd-x64': 0.28.1- '@esbuild/openbsd-arm64': 0.28.1- '@esbuild/openbsd-x64': 0.28.1- '@esbuild/openharmony-arm64': 0.28.1- '@esbuild/sunos-x64': 0.28.1- '@esbuild/win32-arm64': 0.28.1- '@esbuild/win32-ia32': 0.28.1- '@esbuild/win32-x64': 0.28.1-optionalDependencies:'@esbuild/aix-ppc64': 0.28.2@@ -12226,7 +11958,6 @@ snapshots:'@esbuild/win32-arm64': 0.28.2'@esbuild/win32-ia32': 0.28.2'@esbuild/win32-x64': 0.28.2- optional: true@@ -15304,7 +15035,7 @@ snapshots:dependencies:- esbuild: 0.28.1+ esbuild: 0.28.2optionalDependencies:fsevents: 2.3.3@@ -15339,7 +15070,7 @@ snapshots:[email protected]([email protected]([email protected])([email protected]))([email protected])([email protected]):dependencies:- '@typescript-eslint/eslint-plugin': 8.68.0(@typescript-eslint/[email protected]([email protected]([email protected])([email protected]))([email protected])([email protected]))([email protected]([email protected])([email protected]))([email protected])([email protected])+ '@typescript-eslint/eslint-plugin': 8.68.0(@typescript-eslint/[email protected]([email protected]([email protected])([email protected]))([email protected])([email protected]))([email protected]([email protected])([email protected]))([email protected])([email protected])'@typescript-eslint/parser': 8.68.0([email protected]([email protected])([email protected]))([email protected])([email protected])'@typescript-eslint/typescript-estree': 8.68.0([email protected])([email protected])'@typescript-eslint/utils': 8.68.0([email protected]([email protected])([email protected]))([email protected])([email protected])