Skip to content

The open-source agent harness - the runtime layer that turns an LLM into a working agent.

18.8 KB
Raw Blame
// 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);
    });
});