The open-source agent harness - the runtime layer that turns an LLM into a working agent.
// This file was auto-generated by Fern from our API Definition.
import * as TrueForgeTypes from "../../src/api/index";
import { TrueForge } from "../../src/Client";
import { mockServerPool } from "../mock-server/MockServerPool";
describe("AgentsClient", () => {
test("list (1)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
const rawResponseBody = {
data: [
{
created_by_subject: {
subject_display_name: "subject_display_name",
subject_id: "subject_id",
subject_type: "subject_type",
},
description: "description",
id: "id",
manifest: { model: { name: "name" } },
name: "name",
},
],
pagination: { limit: 1, next_page_token: "next_page_token", previous_page_token: "previous_page_token" },
};
server
.mockEndpoint({ once: false })
.get("/api/v1/agents")
.respondWith()
.statusCode(200)
.jsonBody(rawResponseBody)
.build();
const expected = {
data: [
{
createdBySubject: {
subjectDisplayName: "subject_display_name",
subjectId: "subject_id",
subjectType: "subject_type",
},
description: "description",
id: "id",
manifest: {
model: {
name: "name",
},
},
name: "name",
},
],
pagination: {
limit: 1,
nextPageToken: "next_page_token",
previousPageToken: "previous_page_token",
},
};
const page = await client.agents.list();
expect(expected.data).toEqual(page.data);
expect(page.hasNextPage()).toBe(true);
const nextPage = await page.getNextPage();
expect(expected.data).toEqual(nextPage.data);
});
test("list (2)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
const rawResponseBody = { error: { message: "message" } };
server.mockEndpoint().get("/api/v1/agents").respondWith().statusCode(400).jsonBody(rawResponseBody).build();
await expect(async () => {
return await client.agents.list();
}).rejects.toThrow(TrueForgeTypes.BadRequestError);
});
test("list (3)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
const rawResponseBody = { error: { message: "message" } };
server.mockEndpoint().get("/api/v1/agents").respondWith().statusCode(401).jsonBody(rawResponseBody).build();
await expect(async () => {
return await client.agents.list();
}).rejects.toThrow(TrueForgeTypes.UnauthorizedError);
});
test("create (1)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
const rawRequestBody = { description: "description", manifest: { model: { name: "name" } }, name: "name" };
const rawResponseBody = {
data: {
created_by_subject: {
subject_display_name: "subject_display_name",
subject_id: "subject_id",
subject_type: "subject_type",
},
description: "description",
id: "id",
manifest: {
instructions: "instructions",
mcp_servers: [{ name: "name" }],
messages: [{ content: "content", type: "user.message" }],
model: { name: "name" },
response_format: { type: "json_object" },
skills: [{ name: "name" }],
},
name: "name",
},
};
server
.mockEndpoint()
.post("/api/v1/agents")
.jsonBody(rawRequestBody)
.respondWith()
.statusCode(200)
.jsonBody(rawResponseBody)
.build();
const response = await client.agents.create({
description: "description",
manifest: {
model: {
name: "name",
},
},
name: "name",
});
expect(response).toEqual({
data: {
createdBySubject: {
subjectDisplayName: "subject_display_name",
subjectId: "subject_id",
subjectType: "subject_type",
},
description: "description",
id: "id",
manifest: {
instructions: "instructions",
mcpServers: [
{
name: "name",
},
],
messages: [
{
content: "content",
type: "user.message",
},
],
model: {
name: "name",
},
responseFormat: {
type: "json_object",
},
skills: [
{
name: "name",
},
],
},
name: "name",
},
});
});
test("create (2)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
const rawRequestBody = { description: "x", manifest: { model: { name: "x" } }, name: "xy" };
const rawResponseBody = { error: { message: "message" } };
server
.mockEndpoint()
.post("/api/v1/agents")
.jsonBody(rawRequestBody)
.respondWith()
.statusCode(400)
.jsonBody(rawResponseBody)
.build();
await expect(async () => {
return await client.agents.create({
description: "x",
manifest: {
model: {
name: "x",
},
},
name: "xy",
});
}).rejects.toThrow(TrueForgeTypes.BadRequestError);
});
test("create (3)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
const rawRequestBody = { description: "x", manifest: { model: { name: "x" } }, name: "xy" };
const rawResponseBody = { error: { message: "message" } };
server
.mockEndpoint()
.post("/api/v1/agents")
.jsonBody(rawRequestBody)
.respondWith()
.statusCode(409)
.jsonBody(rawResponseBody)
.build();
await expect(async () => {
return await client.agents.create({
description: "x",
manifest: {
model: {
name: "x",
},
},
name: "xy",
});
}).rejects.toThrow(TrueForgeTypes.ConflictError);
});
test("create (4)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
const rawRequestBody = { description: "x", manifest: { model: { name: "x" } }, name: "xy" };
const rawResponseBody = { error: { message: "message" } };
server
.mockEndpoint()
.post("/api/v1/agents")
.jsonBody(rawRequestBody)
.respondWith()
.statusCode(422)
.jsonBody(rawResponseBody)
.build();
await expect(async () => {
return await client.agents.create({
description: "x",
manifest: {
model: {
name: "x",
},
},
name: "xy",
});
}).rejects.toThrow(TrueForgeTypes.UnprocessableEntityError);
});
test("get (1)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
const rawResponseBody = {
data: {
created_by_subject: {
subject_display_name: "subject_display_name",
subject_id: "subject_id",
subject_type: "subject_type",
},
description: "description",
id: "id",
manifest: {
instructions: "instructions",
mcp_servers: [{ name: "name" }],
messages: [{ content: "content", type: "user.message" }],
model: { name: "name" },
response_format: { type: "json_object" },
skills: [{ name: "name" }],
},
name: "name",
},
};
server
.mockEndpoint()
.get("/api/v1/agents/agent_id")
.respondWith()
.statusCode(200)
.jsonBody(rawResponseBody)
.build();
const response = await client.agents.get("agent_id");
expect(response).toEqual({
data: {
createdBySubject: {
subjectDisplayName: "subject_display_name",
subjectId: "subject_id",
subjectType: "subject_type",
},
description: "description",
id: "id",
manifest: {
instructions: "instructions",
mcpServers: [
{
name: "name",
},
],
messages: [
{
content: "content",
type: "user.message",
},
],
model: {
name: "name",
},
responseFormat: {
type: "json_object",
},
skills: [
{
name: "name",
},
],
},
name: "name",
},
});
});
test("get (2)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
const rawResponseBody = { error: { message: "message" } };
server
.mockEndpoint()
.get("/api/v1/agents/agent_id")
.respondWith()
.statusCode(404)
.jsonBody(rawResponseBody)
.build();
await expect(async () => {
return await client.agents.get("agent_id");
}).rejects.toThrow(TrueForgeTypes.NotFoundError);
});
test("update (1)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
const rawRequestBody = { manifest: { model: { name: "name" } } };
const rawResponseBody = {
data: {
created_by_subject: {
subject_display_name: "subject_display_name",
subject_id: "subject_id",
subject_type: "subject_type",
},
description: "description",
id: "id",
manifest: {
instructions: "instructions",
mcp_servers: [{ name: "name" }],
messages: [{ content: "content", type: "user.message" }],
model: { name: "name" },
response_format: { type: "json_object" },
skills: [{ name: "name" }],
},
name: "name",
},
};
server
.mockEndpoint()
.put("/api/v1/agents/agent_id")
.jsonBody(rawRequestBody)
.respondWith()
.statusCode(200)
.jsonBody(rawResponseBody)
.build();
const response = await client.agents.update("agent_id", {
manifest: {
model: {
name: "name",
},
},
});
expect(response).toEqual({
data: {
createdBySubject: {
subjectDisplayName: "subject_display_name",
subjectId: "subject_id",
subjectType: "subject_type",
},
description: "description",
id: "id",
manifest: {
instructions: "instructions",
mcpServers: [
{
name: "name",
},
],
messages: [
{
content: "content",
type: "user.message",
},
],
model: {
name: "name",
},
responseFormat: {
type: "json_object",
},
skills: [
{
name: "name",
},
],
},
name: "name",
},
});
});
test("update (2)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
const rawRequestBody = { manifest: { model: { name: "x" } } };
const rawResponseBody = { error: { message: "message" } };
server
.mockEndpoint()
.put("/api/v1/agents/agent_id")
.jsonBody(rawRequestBody)
.respondWith()
.statusCode(400)
.jsonBody(rawResponseBody)
.build();
await expect(async () => {
return await client.agents.update("agent_id", {
manifest: {
model: {
name: "x",
},
},
});
}).rejects.toThrow(TrueForgeTypes.BadRequestError);
});
test("update (3)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
const rawRequestBody = { manifest: { model: { name: "x" } } };
const rawResponseBody = { error: { message: "message" } };
server
.mockEndpoint()
.put("/api/v1/agents/agent_id")
.jsonBody(rawRequestBody)
.respondWith()
.statusCode(404)
.jsonBody(rawResponseBody)
.build();
await expect(async () => {
return await client.agents.update("agent_id", {
manifest: {
model: {
name: "x",
},
},
});
}).rejects.toThrow(TrueForgeTypes.NotFoundError);
});
test("update (4)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
const rawRequestBody = { manifest: { model: { name: "x" } } };
const rawResponseBody = { error: { message: "message" } };
server
.mockEndpoint()
.put("/api/v1/agents/agent_id")
.jsonBody(rawRequestBody)
.respondWith()
.statusCode(422)
.jsonBody(rawResponseBody)
.build();
await expect(async () => {
return await client.agents.update("agent_id", {
manifest: {
model: {
name: "x",
},
},
});
}).rejects.toThrow(TrueForgeTypes.UnprocessableEntityError);
});
test("delete (1)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
const rawResponseBody = {};
server
.mockEndpoint()
.delete("/api/v1/agents/agent_id")
.respondWith()
.statusCode(200)
.jsonBody(rawResponseBody)
.build();
const response = await client.agents.delete("agent_id");
expect(response).toEqual({});
});
test("delete (2)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
const rawResponseBody = { error: { message: "message" } };
server
.mockEndpoint()
.delete("/api/v1/agents/agent_id")
.respondWith()
.statusCode(401)
.jsonBody(rawResponseBody)
.build();
await expect(async () => {
return await client.agents.delete("agent_id");
}).rejects.toThrow(TrueForgeTypes.UnauthorizedError);
});
test("delete (3)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
const rawResponseBody = { error: { message: "message" } };
server
.mockEndpoint()
.delete("/api/v1/agents/agent_id")
.respondWith()
.statusCode(404)
.jsonBody(rawResponseBody)
.build();
await expect(async () => {
return await client.agents.delete("agent_id");
}).rejects.toThrow(TrueForgeTypes.NotFoundError);
});
});