@truefoundry/trueforge-sdk 0.1.4-rc.1 → 0.2.0-rc.3

package/dist/esm/api/resources/settings/resources/mcpServers/client/Client.mjs

@@ -21,12 +21,10 @@ export class McpServersClient {
         this._options = 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}
@@ -35,91 +33,64 @@ export 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 = 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 = 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 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 handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/api/v1/settings/mcp-servers");
         });
     }
     /**

package/dist/esm/api/resources/settings/resources/mcpServers/client/requests/index.d.mts

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

package/dist/esm/api/resources/settings/resources/skills/client/Client.d.mts

@@ -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/esm/api/resources/settings/resources/skills/client/Client.mjs

@@ -101,6 +101,7 @@ export class SkillsClient {
      *
      * @throws {@link TrueForge.BadRequestError}
      * @throws {@link TrueForge.ConflictError}
+     * @throws {@link TrueForge.FailedDependencyError}
      * @throws {@link errors.TrueForgeError}
      * @throws {@link errors.TrueForgeTimeoutError}
      *
@@ -172,6 +173,14 @@ export 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,
@@ -190,6 +199,7 @@ export 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}
      *
@@ -253,6 +263,14 @@ export 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/esm/api/resources/skills/client/Client.d.mts

@@ -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/esm/api/resources/skills/client/Client.mjs

@@ -83,4 +83,79 @@ export class SkillsClient {
             return 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 = 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 handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/api/v1/skills/versions");
+        });
+    }
 }

package/dist/esm/api/resources/skills/client/index.d.mts

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

package/dist/esm/api/resources/skills/client/index.mjs

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

package/dist/esm/api/resources/skills/client/requests/ListVersionsSkillsRequest.d.mts

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

package/dist/esm/api/resources/skills/client/requests/ListVersionsSkillsRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/skills/client/requests/index.d.mts

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

package/dist/esm/api/resources/skills/client/requests/index.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/api/types/AgentCodeSnippets.d.mts

@@ -1,6 +1,6 @@
 import type * as TrueForge from "../index.mjs";
 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/esm/api/types/AgentSpec.d.mts

@@ -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/esm/api/types/AvailableSkill.d.mts

@@ -1,6 +1,8 @@
-import type * as TrueForge from "../index.mjs";
 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/esm/api/types/CatalogSkill.d.mts

@@ -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;
 }

package/dist/esm/api/types/CatalogSkillType.d.mts

@@ -0,0 +1 @@
+export type CatalogSkillType = "git";

package/dist/esm/api/types/CatalogSkillType.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/ConfiguredSkill.d.mts

@@ -1,5 +1,5 @@
 import type * as TrueForge from "../index.mjs";
 export interface ConfiguredSkill {
     manifest: TrueForge.SkillManifest;
-    name: TrueForge.ResourceName;
+    name: string;
 }

package/dist/esm/api/types/GetAvailableMcpServerResponse.d.mts

@@ -0,0 +1,4 @@
+import type * as TrueForge from "../index.mjs";
+export interface GetAvailableMcpServerResponse {
+    data: TrueForge.AvailableMcpServer;
+}

package/dist/esm/api/types/GetAvailableMcpServerResponse.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/GitSkill.d.mts

@@ -0,0 +1,13 @@
+import type * as TrueForge from "../index.mjs";
+export interface GitSkill {
+    /** Concise guidance for when the agent should use the skill. */
+    description: string;
+    name: TrueForge.ResourceName;
+    /** Path to the skill directory within the repository. Omit to use the repository root. */
+    path?: string;
+    /** Git ref — branch name, tag, or commit SHA. */
+    ref: string;
+    type: "git";
+    /** Full HTTPS URL of a GitHub or GitLab repository. */
+    url: string;
+}

package/dist/esm/api/types/GitSkill.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/ListAvailableMcpServersResponse.d.mts

@@ -1,5 +1,4 @@
 import type * as TrueForge from "../index.mjs";
 export interface ListAvailableMcpServersResponse {
     data: TrueForge.AvailableMcpServer[];
-    pagination: TrueForge.TokenPagination;
 }

package/dist/esm/api/types/ListMcpServersResponse.d.mts

@@ -1,5 +1,4 @@
 import type * as TrueForge from "../index.mjs";
 export interface ListMcpServersResponse {
     data: TrueForge.ConfiguredMcpServer[];
-    pagination: TrueForge.TokenPagination;
 }

package/dist/esm/api/types/ListPermissionsResponse.d.mts

@@ -0,0 +1,5 @@
+import type * as TrueForge from "../index.mjs";
+export interface ListPermissionsResponse {
+    /** Permissions granted to the caller, keyed by resource id. Missing or inaccessible ids are `[]`. */
+    data: Record<string, TrueForge.ResourcePermission[]>;
+}

package/dist/esm/api/types/ListPermissionsResponse.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/ListScheduleRunsResponse.d.mts

@@ -1,4 +1,5 @@
 import type * as TrueForge from "../index.mjs";
 export interface ListScheduleRunsResponse {
     data: TrueForge.ScheduleRun[];
+    pagination: TrueForge.TokenPagination;
 }

package/dist/esm/api/types/ListSkillVersionsResponse.d.mts

@@ -0,0 +1,4 @@
+import type * as TrueForge from "../index.mjs";
+export interface ListSkillVersionsResponse {
+    data: TrueForge.SkillVersion[];
+}

package/dist/esm/api/types/ListSkillVersionsResponse.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/PermissionResourceType.d.mts

@@ -0,0 +1,7 @@
+/** Resource type to evaluate permissions for. */
+export declare const PermissionResourceType: {
+    readonly Agent: "agent";
+    readonly Schedule: "schedule";
+    readonly Session: "session";
+};
+export type PermissionResourceType = (typeof PermissionResourceType)[keyof typeof PermissionResourceType];

package/dist/esm/api/types/PermissionResourceType.mjs

@@ -0,0 +1,7 @@
+// This file was auto-generated by Fern from our API Definition.
+/** Resource type to evaluate permissions for. */
+export const PermissionResourceType = {
+    Agent: "agent",
+    Schedule: "schedule",
+    Session: "session",
+};

package/dist/esm/api/types/ResourcePermission.d.mts

@@ -0,0 +1,7 @@
+/** Granted action on a resource. */
+export declare const ResourcePermission: {
+    readonly Use: "USE";
+    readonly Manage: "MANAGE";
+    readonly Delete: "DELETE";
+};
+export type ResourcePermission = (typeof ResourcePermission)[keyof typeof ResourcePermission];

package/dist/esm/api/types/ResourcePermission.mjs

@@ -0,0 +1,7 @@
+// This file was auto-generated by Fern from our API Definition.
+/** Granted action on a resource. */
+export const ResourcePermission = {
+    Use: "USE",
+    Manage: "MANAGE",
+    Delete: "DELETE",
+};

package/dist/esm/api/types/ScheduleRun.d.mts

@@ -4,6 +4,7 @@ export interface ScheduleRun {
     createdBySubject: TrueForge.CreatedBySubject;
     id: string;
     name: string;
+    reason: string | null;
     scheduleId: string;
     scheduledFor: Date;
     status: TrueForge.ScheduleRunStatus;

package/dist/esm/api/types/Session.d.mts

@@ -8,6 +8,7 @@ export interface Session {
     id: string;
     metadata: TrueForge.SessionMetadata;
     metrics: TrueForge.SessionMetrics;
+    source: TrueForge.SessionSource | null;
     /** Optional human-readable title; null until set. */
     title: string | null;
     /** ISO 8601 last-update timestamp. */

package/dist/esm/api/types/SessionMetrics.d.mts

@@ -2,7 +2,8 @@
  * Rolled-up cost, duration, and turn counters for a session.
  */
 export interface SessionMetrics {
-    totalCostInUsd: number;
+    /** Estimated total cost in USD for this session */
+    totalCostInUsd?: number;
     totalDurationMs: number;
     totalTurns: number;
 }

package/dist/esm/api/types/SessionSource.d.mts

@@ -0,0 +1,11 @@
+/**
+ * How this session was created (e.g. a schedule run). Null for interactive sessions.
+ */
+export interface SessionSource {
+    /** Schedule id. */
+    id: string;
+    /** Schedule run id. */
+    runId: string;
+    /** Session was created by a schedule run. */
+    type: "schedule";
+}

package/dist/esm/api/types/SessionSource.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/SessionSourceSchedule.d.mts

@@ -0,0 +1,8 @@
+export interface SessionSourceSchedule {
+    /** Schedule id. */
+    id: string;
+    /** Schedule run id. */
+    runId: string;
+    /** Session was created by a schedule run. */
+    type: "schedule";
+}

package/dist/esm/api/types/SessionSourceSchedule.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/SessionSourceType.d.mts

@@ -0,0 +1,4 @@
+/**
+ * When set, returns only sessions created by this source type.
+ */
+export type SessionSourceType = "schedule";

package/dist/esm/api/types/SessionSourceType.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/Skill.d.mts

@@ -1,4 +1,6 @@
 export interface Skill {
-    /** Name of a configured skill (also used as the skill directory name in the sandbox). */
+    /** Skill name. */
     name: string;
+    /** Inline SKILL.md into the prompt. */
+    preload?: boolean;
 }

package/dist/esm/api/types/SkillManifest.d.mts

@@ -1,13 +1,2 @@
 import type * as TrueForge from "../index.mjs";
-export interface SkillManifest {
-    /** Concise guidance for when the agent should use the skill. */
-    description: string;
-    name: TrueForge.ResourceName;
-    /** Path to the skill directory within the repository. Omit to use the repository root. */
-    path?: string;
-    /** Git ref — branch name, tag, or commit SHA. */
-    ref: string;
-    type: TrueForge.SkillType;
-    /** Full HTTPS URL of a GitHub or GitLab repository. */
-    url: string;
-}
+export type SkillManifest = TrueForge.GitSkill | TrueForge.TrueFoundryRegistrySkill;

package/dist/esm/api/types/SkillVersion.d.mts

@@ -0,0 +1,7 @@
+export interface SkillVersion {
+    /** Concise guidance for when the agent should use the skill. */
+    description: string;
+    displayName: string;
+    name: string;
+    version: number;
+}