Skip to content

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.md
new file mode 100644
index 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.md
new file mode 100644
index 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.md
new file mode 100644
index 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.json
index 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.json
index 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.json
index 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.md
index 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
```typescript
await 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.ts
index 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} request
diff --git a/packages/trueforge-sdk/src/api/resources/agents/client/requests/CreateAgentRequest.ts b/packages/trueforge-sdk/src/api/resources/agents/client/requests/CreateAgentRequest.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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, TrueF
export 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.ts
index 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.json
index 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.tsx
index 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.tsx
index 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>
<AgentOverflowMenu
agentName={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.tsx
index 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({
<SaveAgentForm
intent={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.tsx
index 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.tsx
index 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 }: AgentDetailsHead
isCreateAgent: 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 ? (
<AgentOverflowMenu
agentName={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.tsx
index 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.tsx
index 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 }: AgentOvervie
return (
<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.ts
index 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.ts
index 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.ts
index 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.tsx
index 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.tsx
index 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.tsx
index 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.tsx
index 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; agent
isCreateAgent: 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.tsx
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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<TTransac
const 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<TTransac
const 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.ts
index 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.ts
index 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.ts
new file mode 100644
index 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.ts
index 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.ts
index 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.ts
new file mode 100644
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.yaml
index d91ce6711..be90d6ee2 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -69,8 +69,8 @@ importers:
specifier: 0.2.21
'@truefoundry/assistant-ui-runtime':
- specifier: 0.1.36
+ specifier: 0.1.37
'@truefoundry/trueforge-sdk':
specifier: workspace:*
version: link:../trueforge-sdk
@@ -366,8 +366,8 @@ importers:
specifier: ^0.13.2
'@truefoundry/assistant-ui-runtime':
- specifier: 0.1.36
+ specifier: 0.1.37
'@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])
dependencies:
'@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
dependencies:
'@eslint-community/regexpp': 4.12.2
'@typescript-eslint/scope-manager': 8.68.0
@@ -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.2
optionalDependencies:
fsevents: 2.3.3
@@ -15339,7 +15070,7 @@ snapshots:
dependencies:
'@typescript-eslint/typescript-estree': 8.68.0([email protected])([email protected])