@truefoundry/trueforge-sdk 0.1.4-rc.2 → 0.2.0-rc.4

package/dist/cjs/api/resources/schedules/client/Client.js

@@ -619,8 +619,10 @@ class SchedulesClient {
      * List runs of a schedule, newest `scheduled_for` first. Available to its creator or a manager of its agent.
      *
      * @param {string} schedule_id - Immutable schedule identifier.
+     * @param {TrueForge.ListRunsSchedulesRequest} request
      * @param {SchedulesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link TrueForge.BadRequestError}
      * @throws {@link TrueForge.ForbiddenError}
      * @throws {@link TrueForge.NotFoundError}
      * @throws {@link errors.TrueForgeError}
@@ -629,64 +631,91 @@ class SchedulesClient {
      * @example
      *     await client.schedules.listRuns("schedule_id")
      */
-    listRuns(schedule_id, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__listRuns(schedule_id, requestOptions));
-    }
-    __listRuns(schedule_id, requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const _authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
-            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
-                url: core.url.join((_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment)), `api/v1/schedules/${core.url.encodePathParam(schedule_id)}/runs`),
-                method: "GET",
-                headers: _headers,
-                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
-                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
-                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
-                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
-                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
-                logging: this._options.logging,
-            });
-            if (_response.ok) {
-                return {
-                    data: serializers.ListScheduleRunsResponse.parseOrThrow(_response.body, {
-                        unrecognizedObjectKeys: "passthrough",
-                        allowUnrecognizedUnionMembers: true,
-                        allowUnrecognizedEnumValues: true,
-                        skipValidation: true,
-                        breadcrumbsPrefix: ["response"],
-                    }),
-                    rawResponse: _response.rawResponse,
+    listRuns(schedule_id_1) {
+        return __awaiter(this, arguments, void 0, function* (schedule_id, request = {}, requestOptions) {
+            const list = core.HttpResponsePromise.interceptFunction((request) => __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+                const { limit = 25, pageToken } = request;
+                const _queryParams = {
+                    limit,
+                    page_token: pageToken,
                 };
-            }
-            if (_response.error.reason === "status-code") {
-                switch (_response.error.statusCode) {
-                    case 403:
-                        throw new TrueForge.ForbiddenError(serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {
-                            unrecognizedObjectKeys: "passthrough",
-                            allowUnrecognizedUnionMembers: true,
-                            allowUnrecognizedEnumValues: true,
-                            skipValidation: true,
-                            breadcrumbsPrefix: ["response"],
-                        }), _response.rawResponse);
-                    case 404:
-                        throw new TrueForge.NotFoundError(serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {
+                const _authRequest = yield this._options.authProvider.getAuthRequest();
+                const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+                const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                    url: core.url.join((_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment)), `api/v1/schedules/${core.url.encodePathParam(schedule_id)}/runs`),
+                    method: "GET",
+                    headers: _headers,
+                    queryString: core.url
+                        .queryBuilder()
+                        .addMany(_queryParams)
+                        .mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams)
+                        .build(),
+                    timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                    maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                    abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                    fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                    logging: this._options.logging,
+                });
+                if (_response.ok) {
+                    return {
+                        data: serializers.ListScheduleRunsResponse.parseOrThrow(_response.body, {
                             unrecognizedObjectKeys: "passthrough",
                             allowUnrecognizedUnionMembers: true,
                             allowUnrecognizedEnumValues: true,
                             skipValidation: true,
                             breadcrumbsPrefix: ["response"],
-                        }), _response.rawResponse);
-                    default:
-                        throw new errors.TrueForgeError({
-                            statusCode: _response.error.statusCode,
-                            body: _response.error.body,
-                            rawResponse: _response.rawResponse,
-                        });
+                        }),
+                        rawResponse: _response.rawResponse,
+                    };
                 }
-            }
-            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/api/v1/schedules/{schedule_id}/runs");
+                if (_response.error.reason === "status-code") {
+                    switch (_response.error.statusCode) {
+                        case 400:
+                            throw new TrueForge.BadRequestError(serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {
+                                unrecognizedObjectKeys: "passthrough",
+                                allowUnrecognizedUnionMembers: true,
+                                allowUnrecognizedEnumValues: true,
+                                skipValidation: true,
+                                breadcrumbsPrefix: ["response"],
+                            }), _response.rawResponse);
+                        case 403:
+                            throw new TrueForge.ForbiddenError(serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {
+                                unrecognizedObjectKeys: "passthrough",
+                                allowUnrecognizedUnionMembers: true,
+                                allowUnrecognizedEnumValues: true,
+                                skipValidation: true,
+                                breadcrumbsPrefix: ["response"],
+                            }), _response.rawResponse);
+                        case 404:
+                            throw new TrueForge.NotFoundError(serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {
+                                unrecognizedObjectKeys: "passthrough",
+                                allowUnrecognizedUnionMembers: true,
+                                allowUnrecognizedEnumValues: true,
+                                skipValidation: true,
+                                breadcrumbsPrefix: ["response"],
+                            }), _response.rawResponse);
+                        default:
+                            throw new errors.TrueForgeError({
+                                statusCode: _response.error.statusCode,
+                                body: _response.error.body,
+                                rawResponse: _response.rawResponse,
+                            });
+                    }
+                }
+                return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/api/v1/schedules/{schedule_id}/runs");
+            }));
+            const dataWithRawResponse = yield list(request).withRawResponse();
+            return new core.Page({
+                response: dataWithRawResponse.data,
+                rawResponse: dataWithRawResponse.rawResponse,
+                hasNextPage: (response) => (response === null || response === void 0 ? void 0 : response.pagination.nextPageToken) != null &&
+                    !(typeof (response === null || response === void 0 ? void 0 : response.pagination.nextPageToken) === "string" && (response === null || response === void 0 ? void 0 : response.pagination.nextPageToken) === ""),
+                getItems: (response) => { var _a; return (_a = response === null || response === void 0 ? void 0 : response.data) !== null && _a !== void 0 ? _a : []; },
+                loadPage: (response) => {
+                    return list(core.setObjectProperty(request, "pageToken", response === null || response === void 0 ? void 0 : response.pagination.nextPageToken));
+                },
+            });
         });
     }
 }

package/dist/cjs/api/resources/{mcpServers/client/requests/ListMcpServersRequest.d.ts → schedules/client/requests/ListRunsSchedulesRequest.d.ts}

@@ -2,8 +2,8 @@
  * @example
  *     {}
  */
-export interface ListMcpServersRequest {
-    /** Page size. Defaults to 100, max 200. */
+export interface ListRunsSchedulesRequest {
+    /** Page size. Defaults to 25 */
     limit?: number;
     /** Opaque token from a previous response `next_page_token`. */
     pageToken?: string;

package/dist/cjs/api/resources/schedules/client/requests/ListRunsSchedulesRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/schedules/client/requests/index.d.ts

@@ -1,4 +1,5 @@
 export type { CreateScheduleRequest } from "./CreateScheduleRequest.js";
 export type { CreateScheduleRunRequest } from "./CreateScheduleRunRequest.js";
+export type { ListRunsSchedulesRequest } from "./ListRunsSchedulesRequest.js";
 export type { ListSchedulesRequest } from "./ListSchedulesRequest.js";
 export type { UpdateScheduleRequest } from "./UpdateScheduleRequest.js";

package/dist/cjs/api/resources/sessions/client/requests/DownloadSandboxFileSessionsRequest.d.ts

@@ -5,6 +5,6 @@
  *     }
  */
 export interface DownloadSandboxFileSessionsRequest {
-    /** Absolute path of the file inside the sandbox, as listed in the assistant's `sandbox_artifacts` block. */
+    /** Absolute or sandbox-working-directory-relative file path, as listed in the assistant's `sandbox_artifacts` block. */
     path: string;
 }

package/dist/cjs/api/resources/settings/resources/mcpServers/client/Client.d.ts

@@ -11,12 +11,10 @@ export declare class McpServersClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<McpServersClient.Options>;
     constructor(options: McpServersClient.Options);
     /**
-     * Paginated MCP servers with auth_status. Header secrets are redacted.
+     * Configured MCP servers with auth_status. Header secrets are redacted.
      *
-     * @param {TrueForge.settings.ListMcpServersRequest} request
      * @param {McpServersClient.RequestOptions} requestOptions - Request-specific configuration.
      *
-     * @throws {@link TrueForge.BadRequestError}
      * @throws {@link TrueForge.UnauthorizedError}
      * @throws {@link TrueForge.ForbiddenError}
      * @throws {@link errors.TrueForgeError}
@@ -25,7 +23,8 @@ export declare class McpServersClient {
      * @example
      *     await client.settings.mcpServers.list()
      */
-    list(request?: TrueForge.settings.ListMcpServersRequest, requestOptions?: McpServersClient.RequestOptions): Promise<core.Page<TrueForge.ConfiguredMcpServer, TrueForge.ListMcpServersResponse>>;
+    list(requestOptions?: McpServersClient.RequestOptions): core.HttpResponsePromise<TrueForge.ListMcpServersResponse>;
+    private __list;
     /**
      * Creates an MCP server by `name`. Fails if `name` is already taken. Runs DCR registration when `auth.type` is `dcr`. Header secrets: real value required; redacted with no stored value returns 400.
      *

package/dist/cjs/api/resources/settings/resources/mcpServers/client/Client.js

@@ -57,12 +57,10 @@ class McpServersClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
-     * Paginated MCP servers with auth_status. Header secrets are redacted.
+     * Configured MCP servers with auth_status. Header secrets are redacted.
      *
-     * @param {TrueForge.settings.ListMcpServersRequest} request
      * @param {McpServersClient.RequestOptions} requestOptions - Request-specific configuration.
      *
-     * @throws {@link TrueForge.BadRequestError}
      * @throws {@link TrueForge.UnauthorizedError}
      * @throws {@link TrueForge.ForbiddenError}
      * @throws {@link errors.TrueForgeError}
@@ -71,91 +69,64 @@ class McpServersClient {
      * @example
      *     await client.settings.mcpServers.list()
      */
-    list() {
-        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
-            const list = core.HttpResponsePromise.interceptFunction((request) => __awaiter(this, void 0, void 0, function* () {
-                var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-                const { limit = 100, pageToken } = request;
-                const _queryParams = {
-                    limit,
-                    page_token: pageToken,
+    list(requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__list(requestOptions));
+    }
+    __list(requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                url: core.url.join((_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment)), "api/v1/settings/mcp-servers"),
+                method: "GET",
+                headers: _headers,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.ListMcpServersResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
                 };
-                const _authRequest = yield this._options.authProvider.getAuthRequest();
-                const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
-                const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
-                    url: core.url.join((_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment)), "api/v1/settings/mcp-servers"),
-                    method: "GET",
-                    headers: _headers,
-                    queryString: core.url
-                        .queryBuilder()
-                        .addMany(_queryParams)
-                        .mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams)
-                        .build(),
-                    timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
-                    maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
-                    abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
-                    fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
-                    logging: this._options.logging,
-                });
-                if (_response.ok) {
-                    return {
-                        data: serializers.ListMcpServersResponse.parseOrThrow(_response.body, {
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 401:
+                        throw new TrueForge.UnauthorizedError(serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {
                             unrecognizedObjectKeys: "passthrough",
                             allowUnrecognizedUnionMembers: true,
                             allowUnrecognizedEnumValues: true,
                             skipValidation: true,
                             breadcrumbsPrefix: ["response"],
-                        }),
-                        rawResponse: _response.rawResponse,
-                    };
-                }
-                if (_response.error.reason === "status-code") {
-                    switch (_response.error.statusCode) {
-                        case 400:
-                            throw new TrueForge.BadRequestError(serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {
-                                unrecognizedObjectKeys: "passthrough",
-                                allowUnrecognizedUnionMembers: true,
-                                allowUnrecognizedEnumValues: true,
-                                skipValidation: true,
-                                breadcrumbsPrefix: ["response"],
-                            }), _response.rawResponse);
-                        case 401:
-                            throw new TrueForge.UnauthorizedError(serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {
-                                unrecognizedObjectKeys: "passthrough",
-                                allowUnrecognizedUnionMembers: true,
-                                allowUnrecognizedEnumValues: true,
-                                skipValidation: true,
-                                breadcrumbsPrefix: ["response"],
-                            }), _response.rawResponse);
-                        case 403:
-                            throw new TrueForge.ForbiddenError(serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {
-                                unrecognizedObjectKeys: "passthrough",
-                                allowUnrecognizedUnionMembers: true,
-                                allowUnrecognizedEnumValues: true,
-                                skipValidation: true,
-                                breadcrumbsPrefix: ["response"],
-                            }), _response.rawResponse);
-                        default:
-                            throw new errors.TrueForgeError({
-                                statusCode: _response.error.statusCode,
-                                body: _response.error.body,
-                                rawResponse: _response.rawResponse,
-                            });
-                    }
+                        }), _response.rawResponse);
+                    case 403:
+                        throw new TrueForge.ForbiddenError(serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.TrueForgeError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
                 }
-                return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/api/v1/settings/mcp-servers");
-            }));
-            const dataWithRawResponse = yield list(request).withRawResponse();
-            return new core.Page({
-                response: dataWithRawResponse.data,
-                rawResponse: dataWithRawResponse.rawResponse,
-                hasNextPage: (response) => (response === null || response === void 0 ? void 0 : response.pagination.nextPageToken) != null &&
-                    !(typeof (response === null || response === void 0 ? void 0 : response.pagination.nextPageToken) === "string" && (response === null || response === void 0 ? void 0 : response.pagination.nextPageToken) === ""),
-                getItems: (response) => { var _a; return (_a = response === null || response === void 0 ? void 0 : response.data) !== null && _a !== void 0 ? _a : []; },
-                loadPage: (response) => {
-                    return list(core.setObjectProperty(request, "pageToken", response === null || response === void 0 ? void 0 : response.pagination.nextPageToken));
-                },
-            });
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/api/v1/settings/mcp-servers");
         });
     }
     /**

package/dist/cjs/api/resources/settings/resources/mcpServers/client/requests/index.d.ts

@@ -1,3 +1,2 @@
 export type { CreateMcpServerRequest } from "./CreateMcpServerRequest.js";
-export type { ListMcpServersRequest } from "./ListMcpServersRequest.js";
 export type { UpdateMcpServerRequest } from "./UpdateMcpServerRequest.js";

package/dist/cjs/api/resources/settings/resources/skills/client/Client.d.ts

@@ -33,6 +33,7 @@ export declare class SkillsClient {
      *
      * @throws {@link TrueForge.BadRequestError}
      * @throws {@link TrueForge.ConflictError}
+     * @throws {@link TrueForge.FailedDependencyError}
      * @throws {@link errors.TrueForgeError}
      * @throws {@link errors.TrueForgeTimeoutError}
      *
@@ -56,6 +57,7 @@ export declare class SkillsClient {
      * @param {SkillsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link TrueForge.BadRequestError}
+     * @throws {@link TrueForge.FailedDependencyError}
      * @throws {@link errors.TrueForgeError}
      * @throws {@link errors.TrueForgeTimeoutError}
      *

package/dist/cjs/api/resources/settings/resources/skills/client/Client.js

@@ -137,6 +137,7 @@ class SkillsClient {
      *
      * @throws {@link TrueForge.BadRequestError}
      * @throws {@link TrueForge.ConflictError}
+     * @throws {@link TrueForge.FailedDependencyError}
      * @throws {@link errors.TrueForgeError}
      * @throws {@link errors.TrueForgeTimeoutError}
      *
@@ -208,6 +209,14 @@ class SkillsClient {
                             skipValidation: true,
                             breadcrumbsPrefix: ["response"],
                         }), _response.rawResponse);
+                    case 424:
+                        throw new TrueForge.FailedDependencyError(serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
                     default:
                         throw new errors.TrueForgeError({
                             statusCode: _response.error.statusCode,
@@ -226,6 +235,7 @@ class SkillsClient {
      * @param {SkillsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link TrueForge.BadRequestError}
+     * @throws {@link TrueForge.FailedDependencyError}
      * @throws {@link errors.TrueForgeError}
      * @throws {@link errors.TrueForgeTimeoutError}
      *
@@ -289,6 +299,14 @@ class SkillsClient {
                             skipValidation: true,
                             breadcrumbsPrefix: ["response"],
                         }), _response.rawResponse);
+                    case 424:
+                        throw new TrueForge.FailedDependencyError(serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
                     default:
                         throw new errors.TrueForgeError({
                             statusCode: _response.error.statusCode,

package/dist/cjs/api/resources/skills/client/Client.d.ts

@@ -24,4 +24,21 @@ export declare class SkillsClient {
      */
     list(requestOptions?: SkillsClient.RequestOptions): core.HttpResponsePromise<TrueForge.ListAvailableSkillsResponse>;
     private __list;
+    /**
+     * Versions for one skill.
+     *
+     * @param {TrueForge.ListVersionsSkillsRequest} request
+     * @param {SkillsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link TrueForge.UnauthorizedError}
+     * @throws {@link errors.TrueForgeError}
+     * @throws {@link errors.TrueForgeTimeoutError}
+     *
+     * @example
+     *     await client.skills.listVersions({
+     *         name: "name"
+     *     })
+     */
+    listVersions(request: TrueForge.ListVersionsSkillsRequest, requestOptions?: SkillsClient.RequestOptions): core.HttpResponsePromise<TrueForge.ListSkillVersionsResponse>;
+    private __listVersions;
 }

package/dist/cjs/api/resources/skills/client/Client.js

@@ -119,5 +119,80 @@ class SkillsClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/api/v1/skills");
         });
     }
+    /**
+     * Versions for one skill.
+     *
+     * @param {TrueForge.ListVersionsSkillsRequest} request
+     * @param {SkillsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link TrueForge.UnauthorizedError}
+     * @throws {@link errors.TrueForgeError}
+     * @throws {@link errors.TrueForgeTimeoutError}
+     *
+     * @example
+     *     await client.skills.listVersions({
+     *         name: "name"
+     *     })
+     */
+    listVersions(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listVersions(request, requestOptions));
+    }
+    __listVersions(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { name } = request;
+            const _queryParams = {
+                name,
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                url: core.url.join((_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment)), "api/v1/skills/versions"),
+                method: "GET",
+                headers: _headers,
+                queryString: core.url
+                    .queryBuilder()
+                    .addMany(_queryParams)
+                    .mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams)
+                    .build(),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.ListSkillVersionsResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 401:
+                        throw new TrueForge.UnauthorizedError(serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.TrueForgeError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/api/v1/skills/versions");
+        });
+    }
 }
 exports.SkillsClient = SkillsClient;

package/dist/cjs/api/resources/skills/client/index.d.ts

@@ -1 +1 @@
-export {};
+export * from "./requests/index.js";

package/dist/cjs/api/resources/skills/client/index.js

@@ -1,2 +1,17 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./requests/index.js"), exports);

package/dist/cjs/api/resources/skills/client/requests/ListVersionsSkillsRequest.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {
+ *         name: "name"
+ *     }
+ */
+export interface ListVersionsSkillsRequest {
+    /** Skill name. */
+    name: string;
+}

package/dist/cjs/api/resources/skills/client/requests/ListVersionsSkillsRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/skills/client/requests/index.d.ts

@@ -0,0 +1 @@
+export type { ListVersionsSkillsRequest } from "./ListVersionsSkillsRequest.js";

package/dist/cjs/api/resources/skills/client/requests/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/AgentCodeSnippets.d.ts

@@ -1,6 +1,6 @@
 import type * as TrueForge from "../index.js";
 export interface AgentCodeSnippets {
-    /** Origin to pass as the TrueForge SDK `baseUrl`. */
+    /** Public base URL for the TrueForge SDK `baseUrl`. */
     baseUrl: string;
     snippets: TrueForge.AgentCodeSnippet[];
 }

package/dist/cjs/api/types/AgentSpec.d.ts

@@ -12,6 +12,6 @@ export interface AgentSpec {
     messages?: TrueForge.InitialUserMessage[];
     model: TrueForge.Model;
     responseFormat?: TrueForge.ResponseFormat;
-    /** Optional name-only skill references. Requires `config.sandbox.enabled: true`. */
+    /** Skills used in this agent. */
     skills?: TrueForge.Skill[];
 }

package/dist/cjs/api/types/AvailableSkill.d.ts

@@ -1,6 +1,8 @@
-import type * as TrueForge from "../index.js";
 export interface AvailableSkill {
     /** Concise guidance for when the agent should use the skill. */
     description: string;
-    name: TrueForge.ResourceName;
+    /** Optional skill metadata. */
+    metadata?: Record<string, string>;
+    /** Skill name. */
+    name: string;
 }

package/dist/cjs/api/types/CatalogSkill.d.ts

@@ -7,7 +7,7 @@ export interface CatalogSkill {
     path?: string;
     /** Git ref — branch name, tag, or commit SHA. */
     ref: string;
-    type: TrueForge.SkillType;
+    type: TrueForge.CatalogSkillType;
     /** Full HTTPS URL of a GitHub or GitLab repository. */
     url: string;
 }