@forge/llm 0.2.0-next.2-experimental-f76634b → 0.2.0-next.4

package/CHANGELOG.md

@@ -0,0 +1,56 @@
+# @forge/llm
+
+## 0.2.0-next.4
+
+### Patch Changes
+
+- 9e49ce9: Excluded test files
+
+## 0.2.0-next.3
+
+### Minor Changes
+
+- 4adf05c: Add trace Id
+
+## 0.2.0-next.2
+
+### Patch Changes
+
+- Updated dependencies [def4ec3]
+  - @forge/api@6.3.0-next.2
+
+## 0.2.0-next.1
+
+### Minor Changes
+
+- 4f53a62: Add support for 'usage' attribute in the chat's response object
+
+## 0.1.1-next.0
+
+### Patch Changes
+
+- @forge/api@6.2.1-next.0
+
+## 0.1.0
+
+### Minor Changes
+
+- dd34523: Forge LLM SDK added
+- abe9c21: Forge LLM SDK core implementation
+
+### Patch Changes
+
+- Updated dependencies [0af355f]
+  - @forge/api@6.2.0
+
+## 0.1.0-next.1
+
+### Minor Changes
+
+- abe9c21: Forge LLM SDK core implementation
+
+## 0.1.0-next.0
+
+### Minor Changes
+
+- dd34523: Forge LLM SDK added

package/out/fetch-wrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-wrapper.d.ts","sourceRoot":"","sources":["../src/fetch-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,WAAW,EAAe,MAAM,YAAY,CAAC;AAEnE,wBAAgB,eAAe,IAAI,WAAW,CAW7C"}
+{"version":3,"file":"fetch-wrapper.d.ts","sourceRoot":"","sources":["../src/fetch-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,WAAW,EAAe,MAAM,YAAY,CAAC;AAEjF,wBAAgB,eAAe,IAAI,WAAW,CAc7C"}

package/out/fetch-wrapper.js

@@ -1,14 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getFetchWrapper = void 0;
+const api_1 = require("@forge/api");
 function getFetchWrapper() {
+    const { tracing } = (0, api_1.__getRuntime)();
     return async function (path, options) {
         const model = path?.split('/').pop();
         return await global.__forge_fetch__({ type: 'llm', model: model }, path, {
             ...options,
             headers: {
                 ...options?.headers,
-                'Content-Type': 'application/json'
+                'Content-Type': 'application/json',
+                'x-b3-traceid': tracing.traceId,
+                'x-b3-spanid': tracing.spanId
             }
         });
     };

package/out/utils/error-handling.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-handling.d.ts","sourceRoot":"","sources":["../../src/utils/error-handling.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuC,UAAU,EAAoB,MAAM,WAAW,CAAC;AAE9F,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAMzC,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,UAAU,CAE9D;AAED,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB7E;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAMnE"}
+{"version":3,"file":"error-handling.d.ts","sourceRoot":"","sources":["../../src/utils/error-handling.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuC,UAAU,EAAoB,MAAM,WAAW,CAAC;AAE9F,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAQzC,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,UAAU,CAE9D;AAED,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB7E;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAMnE"}

package/out/utils/error-handling.js

@@ -4,7 +4,7 @@ exports.safeGetParsedBody = exports.checkResponseError = exports.isForgeError =
 const errors_1 = require("../errors");
 const text_1 = require("../text");
 function extractTraceId(response) {
-    return response.headers.get('x-b3-traceid') || response.headers.get('x-trace-id');
+    return (response.headers.get('x-b3-traceid') || response.headers.get('x-trace-id') || response.headers.get('atl-traceid'));
 }
 function isForgeError(body) {
     return typeof body === 'object' && body !== null && 'code' in body && 'message' in body;

package/package.json

@@ -1,16 +1,13 @@
 {
   "name": "@forge/llm",
-  "version": "0.2.0-next.2-experimental-f76634b",
+  "version": "0.2.0-next.4",
   "description": "Forge LLM SDK",
   "main": "out/index.js",
   "types": "out/index.d.ts",
-  "files": [
-    "out"
-  ],
   "author": "Atlassian",
   "license": "SEE LICENSE IN LICENSE.txt",
   "dependencies": {
-    "@forge/api": "^6.3.0-next.2-experimental-f76634b"
+    "@forge/api": "^6.3.0-next.2"
   },
   "devDependencies": {
     "@types/node": "20.19.1",

package/out/__test__/error-handling.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=error-handling.test.d.ts.map

package/out/__test__/error-handling.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"error-handling.test.d.ts","sourceRoot":"","sources":["../../src/__test__/error-handling.test.ts"],"names":[],"mappings":""}

package/out/__test__/error-handling.test.js

@@ -1,105 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const errors_1 = require("../errors");
-const error_handling_1 = require("../utils/error-handling");
-describe('Error Handling', () => {
-    it('should handle a 400 response and return a ForgeLlmAPIError', async () => {
-        const code = 'UNSUPPORTED_AI_MODEL';
-        const message = 'Requested claude-3-5-sonnet-v2@20241022 not available for vendor: Claude';
-        const traceId = 'trace-123';
-        const apiResponse = new Response(JSON.stringify({
-            code: code,
-            message: message
-        }), {
-            status: 400,
-            statusText: 'Bad Request',
-            headers: {
-                'x-trace-id': traceId,
-                'Forge-Proxy-Error': 'UNSUPPORTED_AI_MODEL'
-            }
-        });
-        await expect(async () => (0, error_handling_1.checkResponseError)(apiResponse)).rejects.toMatchError(new errors_1.ForgeLlmAPIError({
-            status: 400,
-            statusText: 'Bad Request',
-            traceId
-        }, { code, message }));
-    });
-    it('should handle an Unknown error, that is a Forge error, with empty body and return a ForgeLlmAPIError', async () => {
-        const code = 'UNKNOWN_ERROR';
-        const traceId = 'trace-123';
-        const apiResponse = new Response(undefined, {
-            status: 500,
-            statusText: 'Internal Server Error',
-            headers: {
-                'x-trace-id': traceId
-            }
-        });
-        await expect(async () => (0, error_handling_1.checkResponseError)(apiResponse)).rejects.toMatchError(new errors_1.ForgeLlmAPIError({
-            status: 500,
-            statusText: 'Internal Server Error',
-            traceId
-        }, { code, message: 'Unexpected error in Forge LLM API', context: { responseText: '' } }));
-    });
-    it('should handle an Unknown error response, that is not a Forge error, with a json body and return a ForgeLlmAPIError', async () => {
-        const code = 'UNKNOWN_ERROR';
-        const body = JSON.stringify({
-            unknownError: 'Unexpected error with a non-json body'
-        });
-        const traceId = 'trace-123';
-        const apiResponse = new Response(body, {
-            status: 500,
-            statusText: 'Internal Server Error',
-            headers: {
-                'x-trace-id': traceId
-            }
-        });
-        await expect(async () => (0, error_handling_1.checkResponseError)(apiResponse)).rejects.toMatchError(new errors_1.ForgeLlmAPIError({
-            status: 500,
-            statusText: 'Internal Server Error',
-            traceId
-        }, {
-            message: 'Unexpected error in Forge LLM API',
-            code: code,
-            context: {
-                responseText: body
-            }
-        }));
-    });
-    it('should include context fields in the error when provided by the API', async () => {
-        const code = 'QUOTA_EXCEEDED';
-        const message = 'You have exceeded your quota';
-        const context = { quota: '1000', usage: '1500' };
-        const traceId = 'trace-123';
-        const apiResponse = new Response(JSON.stringify({ code, message, context }), {
-            status: 500,
-            statusText: 'Internal Server Error',
-            headers: {
-                'x-trace-id': traceId
-            }
-        });
-        await expect(async () => (0, error_handling_1.checkResponseError)(apiResponse)).rejects.toMatchError(new errors_1.ForgeLlmAPIError({
-            status: 500,
-            statusText: 'Internal Server Error',
-            traceId
-        }, { code, message, context }));
-    });
-    it('should include any extra fields in the error context when provided by the API', async () => {
-        const code = 'QUOTA_EXCEEDED';
-        const message = 'You have exceeded your quota';
-        const context = { quota: '1000', usage: '1500' };
-        const extraFields = { retryAfter: 30, plan: 'pro' };
-        const traceId = 'trace-123';
-        const apiResponse = new Response(JSON.stringify({ code, message, context, ...extraFields }), {
-            status: 500,
-            statusText: 'Internal Server Error',
-            headers: {
-                'x-trace-id': traceId
-            }
-        });
-        await expect(async () => (0, error_handling_1.checkResponseError)(apiResponse)).rejects.toMatchError(new errors_1.ForgeLlmAPIError({
-            status: 500,
-            statusText: 'Internal Server Error',
-            traceId
-        }, { code, message, context, ...extraFields }));
-    });
-});

package/out/__test__/fetch-wrapper-test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=fetch-wrapper-test.d.ts.map

package/out/__test__/fetch-wrapper-test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fetch-wrapper-test.d.ts","sourceRoot":"","sources":["../../src/__test__/fetch-wrapper-test.ts"],"names":[],"mappings":""}

package/out/__test__/fetch-wrapper-test.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const fetch_wrapper_1 = require("../fetch-wrapper");
-describe('FetchWrapper', () => {
-    it('should construct the args correctly', async () => {
-        const mockFetch = jest.fn().mockResolvedValue({ status: 200 });
-        global.__forge_fetch__ = mockFetch;
-        const fetchWrapper = (0, fetch_wrapper_1.getFetchWrapper)();
-        await fetchWrapper('https://llm/model-id', { method: 'POST' });
-        expect(mockFetch).toHaveBeenCalledTimes(1);
-        const [firstArg] = mockFetch.mock.calls[0];
-        expect(firstArg).toEqual({ type: 'llm', model: 'model-id' });
-    });
-});

package/out/__test__/index.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.test.d.ts.map

package/out/__test__/index.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/__test__/index.test.ts"],"names":[],"mappings":""}

package/out/__test__/index.test.js

@@ -1,37 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const index_1 = require("../index");
-const test_helpers_1 = require("./test-helpers");
-const llm_api_1 = require("../llm-api");
-const errors_1 = require("../errors");
-jest.mock('../../src/fetch-wrapper', () => ({
-    getFetchWrapper: jest.fn(() => 'FAKE_FETCH_WRAPPER')
-}));
-jest.mock('../../src/llm-api', () => {
-    return {
-        LlmApiImpl: jest.fn().mockImplementation(() => ({
-            chat: jest.fn(async (...promptArgs) => ({ inputArgs: promptArgs }))
-        }))
-    };
-});
-describe('Chat', () => {
-    it('should call LlmApiImpl.chat with provided prompt payload', async () => {
-        const promptPayload = (0, test_helpers_1.constructPrompt)();
-        const result = await (0, index_1.chat)(promptPayload);
-        const llmApi = llm_api_1.LlmApiImpl.mock.results[0].value;
-        expect(llmApi.chat).toHaveBeenCalledWith(promptPayload);
-        expect(result).toEqual({ inputArgs: [promptPayload] });
-    });
-    it('should propagate Forge errors returned', async () => {
-        const prompt = (0, test_helpers_1.constructPrompt)();
-        const llmApi = llm_api_1.LlmApiImpl.mock.results[0].value;
-        llmApi.chat.mockRejectedValueOnce(new errors_1.ForgeLlmAPIError({ status: 400, statusText: 'bad request' }, { code: 'INVALID_BODY', message: 'Bad request' }));
-        await expect((0, index_1.chat)(prompt)).rejects.toThrow(errors_1.ForgeLlmAPIError);
-    });
-    it('should propagate validation errors', async () => {
-        const prompt = 'invalid_prompt';
-        const llmApi = llm_api_1.LlmApiImpl.mock.results[0].value;
-        llmApi.chat.mockRejectedValueOnce(new errors_1.PromptValidationError('The payload is invalid: Prompt is required and must be a valid object.'));
-        await expect((0, index_1.chat)(prompt)).rejects.toThrow(errors_1.PromptValidationError);
-    });
-});

package/out/__test__/llm-api.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=llm-api.test.d.ts.map

package/out/__test__/llm-api.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"llm-api.test.d.ts","sourceRoot":"","sources":["../../src/__test__/llm-api.test.ts"],"names":[],"mappings":""}

package/out/__test__/llm-api.test.js

@@ -1,104 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-const fetch_wrapper_1 = require("../fetch-wrapper");
-const llm_api_1 = require("../llm-api");
-const errors_1 = require("../errors");
-const test_helpers_1 = require("./test-helpers");
-const responseMapper = tslib_1.__importStar(require("../response-mapper"));
-function setupEnvironment(response) {
-    const mockedFetch = jest.fn().mockResolvedValue(response || new Response(null, { status: 200 }));
-    global.__forge_fetch__ = jest.fn((_ctx, path, options) => mockedFetch(path, options));
-}
-describe('llm api', () => {
-    it('should make ForgeLlm request', async () => {
-        const llmResponse = (0, test_helpers_1.constructLlmResponse)();
-        const apiResponse = new Response(JSON.stringify(llmResponse), {
-            status: 200
-        });
-        const mockedFetch = jest.fn().mockResolvedValue(apiResponse);
-        global.__forge_fetch__ = jest.fn((_ctx, path, options) => mockedFetch(path, options));
-        const llmAPI = new llm_api_1.LlmApiImpl((0, fetch_wrapper_1.getFetchWrapper)());
-        const promptBody = {
-            model: 'claude-sonnet-4-20250514',
-            messages: [
-                { role: 'user', content: [{ type: 'text', text: 'Hello, how are you?' }] },
-                { role: 'system', content: [{ type: 'text', text: 'You are a creative agent' }] }
-            ],
-            temperature: 0.7,
-            max_completion_tokens: 1000,
-            top_p: 0.9
-        };
-        const prompt = (0, test_helpers_1.constructPrompt)(promptBody);
-        await llmAPI.chat(prompt);
-        const [[path, options]] = mockedFetch.mock.calls;
-        expect(path).toBe('https://llm/claude-sonnet-4-20250514');
-        expect(options.method).toBe('POST');
-        expect(options.headers).toEqual({ 'Content-Type': 'application/json' });
-        expect(JSON.parse(options.body)).toEqual({
-            messages: [
-                {
-                    role: 'user',
-                    content: [
-                        {
-                            type: 'text',
-                            text: 'Hello, how are you?'
-                        }
-                    ]
-                },
-                {
-                    role: 'system',
-                    content: [
-                        {
-                            type: 'text',
-                            text: 'You are a creative agent'
-                        }
-                    ]
-                }
-            ],
-            temperature: 0.7,
-            max_completion_tokens: 1000,
-            top_p: 0.9
-        });
-    });
-    it('should throw a validation error when prompt is invalid', async () => {
-        const promptWithEmptyMessages = (0, test_helpers_1.constructPrompt)({ messages: [] });
-        const llmAPI = new llm_api_1.LlmApiImpl((0, fetch_wrapper_1.getFetchWrapper)());
-        await expect(llmAPI.chat(promptWithEmptyMessages)).rejects.toThrow(errors_1.PromptValidationError);
-    });
-    it('should return a ChatResponse for a 200 success response', async () => {
-        const llmResponse = (0, test_helpers_1.constructLlmResponse)({
-            finish_reason: 'tool_calls',
-            index: 19,
-            message: {
-                role: 'assistant',
-                content: [
-                    {
-                        type: 'text',
-                        text: "It's 20 degrees celsius"
-                    }
-                ]
-            }
-        });
-        const apiResponse = new Response(JSON.stringify(llmResponse), {
-            status: 200
-        });
-        setupEnvironment(apiResponse);
-        const llmAPI = new llm_api_1.LlmApiImpl((0, fetch_wrapper_1.getFetchWrapper)());
-        const prompt = (0, test_helpers_1.constructPrompt)();
-        const mapResponseSpy = jest.spyOn(responseMapper, 'mapForgeLLMResponse');
-        const response = await llmAPI.chat(prompt);
-        expect(mapResponseSpy).toHaveBeenCalledWith(apiResponse);
-        expect(response.choices).toEqual(llmResponse.choices);
-        expect(response.usage).toEqual(llmResponse.usage);
-    });
-    it('should throw an error for a non-200 response', async () => {
-        const apiResponse = new Response(JSON.stringify({}), {
-            status: 400
-        });
-        setupEnvironment(apiResponse);
-        const llmAPI = new llm_api_1.LlmApiImpl((0, fetch_wrapper_1.getFetchWrapper)());
-        const prompt = (0, test_helpers_1.constructPrompt)();
-        await expect(llmAPI.chat(prompt)).rejects.toThrow(errors_1.ForgeLlmAPIError);
-    });
-});

package/out/__test__/response-mapper.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=response-mapper.test.d.ts.map

package/out/__test__/response-mapper.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"response-mapper.test.d.ts","sourceRoot":"","sources":["../../src/__test__/response-mapper.test.ts"],"names":[],"mappings":""}

package/out/__test__/response-mapper.test.js

@@ -1,73 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const response_mapper_1 = require("../response-mapper");
-const test_helpers_1 = require("./test-helpers");
-describe('response mapper', () => {
-    it('should map the Forge LLM response to a user response (choices empty)', async () => {
-        const llmResponseBody = { choices: [] };
-        const apiResponse = (0, test_helpers_1.makeApiResponse)({ json: () => Promise.resolve(llmResponseBody) });
-        const mappedResponse = await (0, response_mapper_1.mapForgeLLMResponse)(apiResponse);
-        expect(mappedResponse).toEqual({ choices: [], usage: undefined });
-    });
-    it('should map the Forge LLM response', async () => {
-        const llmResponseBody = {
-            choices: [
-                {
-                    finish_reason: 'tool_calls',
-                    index: 19,
-                    message: {
-                        role: 'assistant',
-                        content: [
-                            { type: 'text', text: 'It is warm outside' },
-                            { type: 'text', text: "It's 20 degrees celsius" }
-                        ],
-                        tool_calls: [
-                            {
-                                id: 'tool-call-123',
-                                type: 'function',
-                                function: {
-                                    name: 'WeatherTool',
-                                    arguments: {
-                                        location: 'San Francisco, CA',
-                                        unit: 'celsius'
-                                    }
-                                }
-                            }
-                        ]
-                    }
-                }
-            ]
-        };
-        const apiResponse = (0, test_helpers_1.makeApiResponse)({ json: () => Promise.resolve(llmResponseBody) });
-        const mappedResponse = await (0, response_mapper_1.mapForgeLLMResponse)(apiResponse);
-        expect(mappedResponse).toEqual({ choices: llmResponseBody.choices, usage: undefined });
-    });
-    it('should map the Forge LLM response with usage attribute', async () => {
-        const llmResponseBody = {
-            choices: [
-                {
-                    finish_reason: 'stop',
-                    message: {
-                        role: 'assistant',
-                        content: [{ type: 'text', text: 'Hello!' }]
-                    }
-                }
-            ],
-            usage: {
-                input_token: 10,
-                output_token: 20,
-                total_token: 30
-            }
-        };
-        const apiResponse = (0, test_helpers_1.makeApiResponse)({ json: () => Promise.resolve(llmResponseBody) });
-        const mappedResponse = await (0, response_mapper_1.mapForgeLLMResponse)(apiResponse);
-        expect(mappedResponse).toEqual({
-            choices: llmResponseBody.choices,
-            usage: {
-                input_token: 10,
-                output_token: 20,
-                total_token: 30
-            }
-        });
-    });
-});

package/out/__test__/test-helpers.d.ts

@@ -1,20 +0,0 @@
-import { Prompt } from '../interfaces/types';
-import { APIResponse } from '@forge/api';
-import { Choice } from '../interfaces/llm-api';
-export declare const constructPrompt: (overrides?: {}) => Prompt;
-export declare const makeApiResponse: (overrides: Partial<APIResponse>) => APIResponse;
-export declare const constructLlmResponse: (overrides?: Partial<Choice>) => {
-    choices: {
-        finish_reason: string;
-        index: number;
-        message: import("../interfaces/llm-api").AssistantMessage | {
-            role: string;
-            content: {
-                type: string;
-                text: string;
-            }[];
-        };
-    }[];
-    usage: {};
-};
-//# sourceMappingURL=test-helpers.d.ts.map

package/out/__test__/test-helpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../../src/__test__/test-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C,eAAO,MAAM,eAAe,sBAAqB,MAU/C,CAAC;AAEH,eAAO,MAAM,eAAe,cAAe,QAAQ,WAAW,CAAC,KAAG,WAWjE,CAAC;AAEF,eAAO,MAAM,oBAAoB,eAAe,QAAQ,MAAM,CAAC;;;;;;;;;;;;;CAkB7D,CAAC"}

package/out/__test__/test-helpers.js

@@ -1,48 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.constructLlmResponse = exports.makeApiResponse = exports.constructPrompt = void 0;
-const constructPrompt = (overrides = {}) => ({
-    model: 'claude-sonnet-4-20250514',
-    messages: [
-        { role: 'user', content: [{ type: 'text', text: 'Hello, how are you?' }] },
-        { role: 'system', content: [{ type: 'text', text: 'You are a creative agent' }] }
-    ],
-    temperature: 0.7,
-    max_completion_tokens: 1000,
-    top_p: 0.9,
-    ...overrides
-});
-exports.constructPrompt = constructPrompt;
-const makeApiResponse = (overrides) => {
-    return {
-        status: 200,
-        statusText: 'OK',
-        headers: new Headers({
-            'Content-Type': 'application/json'
-        }),
-        json: async () => Promise.resolve({}),
-        text: async () => JSON.stringify({}),
-        ...overrides
-    };
-};
-exports.makeApiResponse = makeApiResponse;
-const constructLlmResponse = (overrides = {}) => ({
-    choices: [
-        {
-            finish_reason: 'tool_calls',
-            message: {
-                role: 'assistant',
-                content: [
-                    {
-                        type: 'text',
-                        text: "It's 20 degrees celsius"
-                    }
-                ]
-            },
-            index: 19,
-            ...overrides
-        }
-    ],
-    usage: {}
-});
-exports.constructLlmResponse = constructLlmResponse;

package/out/__test__/validators.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=validators.test.d.ts.map

package/out/__test__/validators.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"validators.test.d.ts","sourceRoot":"","sources":["../../src/__test__/validators.test.ts"],"names":[],"mappings":""}

package/out/__test__/validators.test.js

@@ -1,95 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const validators_1 = require("../validators");
-const errors_1 = require("../errors");
-const test_helpers_1 = require("./test-helpers");
-describe('Validators', () => {
-    describe('required fields', () => {
-        it('should validate a correct prompt', () => {
-            const validPrompt = (0, test_helpers_1.constructPrompt)();
-            expect(() => (0, validators_1.validatePrompt)(validPrompt)).not.toThrow();
-        });
-        it('should fail if no prompt is provided', () => {
-            const emptyPrompt = undefined;
-            expect(() => (0, validators_1.validatePrompt)(emptyPrompt)).toMatchError(new errors_1.PromptValidationError('The payload is invalid: Prompt is required and must be a valid object.'));
-        });
-        describe('model validation', () => {
-            it('should throw an error for a missing model', () => {
-                const prompt = (0, test_helpers_1.constructPrompt)({ model: undefined });
-                expect(() => (0, validators_1.validatePrompt)(prompt)).toMatchError(new errors_1.PromptValidationError('The payload is invalid: Model is required.'));
-            });
-        });
-        describe('messages validation', () => {
-            it('should throw an error when no messages are provided', () => {
-                const prompt = (0, test_helpers_1.constructPrompt)({ messages: undefined });
-                expect(() => (0, validators_1.validatePrompt)(prompt)).toMatchError(new errors_1.PromptValidationError('The payload is invalid: No messages were provided. Provide at least one message.'));
-            });
-            it('should throw an error when a message body is missing the role field', () => {
-                const prompt = (0, test_helpers_1.constructPrompt)({ messages: [{ content: 'Hello' }] });
-                expect(() => (0, validators_1.validatePrompt)(prompt)).toMatchError(new errors_1.PromptValidationError('The payload is invalid: Invalid role at index 0: . Role must be present and one of [system, user, assistant, tool].'));
-            });
-            it('should throw an error when a message body has an invalid role type', () => {
-                const prompt = (0, test_helpers_1.constructPrompt)({ messages: [{ content: 'Hello', role: 'unknown-role' }] });
-                expect(() => (0, validators_1.validatePrompt)(prompt)).toMatchError(new errors_1.PromptValidationError('The payload is invalid: Invalid role at index 0: unknown-role. Role must be present and one of [system, user, assistant, tool].'));
-            });
-            it('should throw an error when a message body is missing the content field', () => {
-                const prompt = (0, test_helpers_1.constructPrompt)({ messages: [{ role: 'user' }] });
-                expect(() => (0, validators_1.validatePrompt)(prompt)).toMatchError(new errors_1.PromptValidationError('The payload is invalid: Message content at index 0 must be a non-empty string.'));
-            });
-        });
-    });
-    describe('optional fields', () => {
-        describe('temperature validation', () => {
-            it('should throw an error for a temperature under 0', () => {
-                const prompt = (0, test_helpers_1.constructPrompt)({ temperature: -1 });
-                expect(() => (0, validators_1.validatePrompt)(prompt)).toMatchError(new errors_1.PromptValidationError('The payload is invalid: Invalid temperature -1: Temperature must be between 0 and 1.'));
-            });
-            it('should throw an error for a temperature above 1', () => {
-                const prompt = (0, test_helpers_1.constructPrompt)({ temperature: 2 });
-                expect(() => (0, validators_1.validatePrompt)(prompt)).toMatchError(new errors_1.PromptValidationError('The payload is invalid: Invalid temperature 2: Temperature must be between 0 and 1.'));
-            });
-            it('should not throw an error for a non-numeric temperature', () => {
-                const prompt = (0, test_helpers_1.constructPrompt)({ temperature: undefined });
-                expect(() => (0, validators_1.validatePrompt)(prompt)).not.toThrow();
-            });
-            it('should throw an error for a non-finite temperature', () => {
-                const prompt = (0, test_helpers_1.constructPrompt)({ temperature: 'NaN' });
-                expect(() => (0, validators_1.validatePrompt)(prompt)).toMatchError(new errors_1.PromptValidationError('The payload is invalid: Invalid temperature NaN: Temperature must be between 0 and 1.'));
-            });
-        });
-        describe('max_completion_tokens validation', () => {
-            const invalidValues = [NaN, 0, -5, 10.5];
-            invalidValues.forEach((value) => {
-                it(`should throw an error for invalid max_completion_tokens value ${value}`, () => {
-                    const prompt = (0, test_helpers_1.constructPrompt)({ max_completion_tokens: value });
-                    expect(() => (0, validators_1.validatePrompt)(prompt)).toMatchError(new errors_1.PromptValidationError(`The payload is invalid: Invalid max_completion_tokens ${value}: max_completion_tokens must be a positive integer.`));
-                });
-            });
-            it('should not throw when max_completion_tokens is undefined', () => {
-                const prompt = (0, test_helpers_1.constructPrompt)({ max_completion_tokens: undefined });
-                expect(() => (0, validators_1.validatePrompt)(prompt)).not.toThrow();
-            });
-            it('should not throw when max_completion_tokens is a valid positive integer', () => {
-                const prompt = (0, test_helpers_1.constructPrompt)({ max_completion_tokens: 256 });
-                expect(() => (0, validators_1.validatePrompt)(prompt)).not.toThrow();
-            });
-        });
-        describe('top_p validation', () => {
-            it('should not throw an error when top_p is not provided', () => {
-                const prompt = (0, test_helpers_1.constructPrompt)({ top_p: undefined });
-                expect(() => (0, validators_1.validatePrompt)(prompt)).not.toThrow();
-            });
-            it('should not throw an error for a valid top_p', () => {
-                const prompt = (0, test_helpers_1.constructPrompt)({ top_p: 0.9 });
-                expect(() => (0, validators_1.validatePrompt)(prompt)).not.toThrow();
-            });
-            const invalidTopPValues = [-0.1, 1.5, NaN, 'string'];
-            invalidTopPValues.forEach((value) => {
-                it(`should throw an error for invalid top_p value ${value}`, () => {
-                    const prompt = (0, test_helpers_1.constructPrompt)({ top_p: value });
-                    expect(() => (0, validators_1.validatePrompt)(prompt)).toMatchError(new errors_1.PromptValidationError(`The payload is invalid: Invalid top_p ${value}: top_p must be between 0 and 1.`));
-                });
-            });
-        });
-    });
-});