@truefoundry/trueforge-sdk 0.1.4-rc.0 → 0.1.4-rc.2

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

@@ -20,10 +20,12 @@ export class McpServersClient {
         this._options = normalizeClientOptionsWithAuth(options);
     }
     /**
-     * MCP servers as a slim name/url list for the composer. No auth or auth_status.
+     * Paginated MCP servers as a slim name/url list for the composer.
      *
+     * @param {TrueForge.ListMcpServersRequest} request
      * @param {McpServersClient.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link TrueForge.BadRequestError}
      * @throws {@link TrueForge.UnauthorizedError}
      * @throws {@link errors.TrueForgeError}
      * @throws {@link errors.TrueForgeTimeoutError}
@@ -31,60 +33,87 @@ export class McpServersClient {
      * @example
      *     await client.mcpServers.list()
      */
-    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/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.ListAvailableMcpServersResponse.parseOrThrow(_response.body, {
-                        unrecognizedObjectKeys: "passthrough",
-                        allowUnrecognizedUnionMembers: true,
-                        allowUnrecognizedEnumValues: true,
-                        skipValidation: true,
-                        breadcrumbsPrefix: ["response"],
-                    }),
-                    rawResponse: _response.rawResponse,
+    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,
                 };
-            }
-            if (_response.error.reason === "status-code") {
-                switch (_response.error.statusCode) {
-                    case 401:
-                        throw new TrueForge.UnauthorizedError(serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {
+                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/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.ListAvailableMcpServersResponse.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 handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/api/v1/mcp-servers");
+                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);
+                        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/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));
+                },
+            });
         });
     }
     /**
-     * For servers without auth returns not_required, and for header credentials returns authenticated (no browser flow). For auth.type dcr, returns authenticated when a usable (or refreshable) token exists; otherwise runs DCR if needed and returns auth_required with an authorization URL. Optional return_to is where the OAuth callback then redirects the browser; without it the callback returns JSON.
+     * Returns current auth status. When OAuth is required, includes an authorization URL. Optional return_to is the post-consent landing path.
      *
      * @param {string} name - MCP server name.
      * @param {TrueForge.AuthorizeMcpServersRequest} request
@@ -194,7 +223,7 @@ export class McpServersClient {
         });
     }
     /**
-     * For auth.type dcr, deletes the stored OAuth token and returns the server with auth_status auth_required, keeping the dynamically registered OAuth client so the next authorize can reuse it. No-op for header or no-auth servers (returns the server unchanged).
+     * Disconnects OAuth for the MCP server when applicable and returns the updated server with auth_status. No-op when the server does not use stored OAuth tokens.
      *
      * @param {string} name - MCP server name.
      * @param {McpServersClient.RequestOptions} requestOptions - Request-specific configuration.

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

@@ -3,6 +3,6 @@
  *     {}
  */
 export interface AuthorizeMcpServersRequest {
-    /** Optional path to return to after OAuth. Must be a same-origin relative path; the OAuth callback redirects here with `isSuccess`/`reason` appended. */
+    /** Same-origin path to land in the browser after consent. */
     returnTo?: string;
 }

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

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

package/dist/esm/api/resources/mcpServers/client/requests/ListMcpServersRequest.mjs

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

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

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

package/dist/esm/api/resources/schedules/client/Client.d.mts

@@ -0,0 +1,146 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.mjs";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as TrueForge from "../../../index.mjs";
+export declare namespace SchedulesClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class SchedulesClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<SchedulesClient.Options>;
+    constructor(options: SchedulesClient.Options);
+    /**
+     * List schedules for the tenant, newest first.
+     *
+     * @param {TrueForge.ListSchedulesRequest} request
+     * @param {SchedulesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link TrueForge.BadRequestError}
+     * @throws {@link TrueForge.UnauthorizedError}
+     * @throws {@link errors.TrueForgeError}
+     * @throws {@link errors.TrueForgeTimeoutError}
+     *
+     * @example
+     *     await client.schedules.list()
+     */
+    list(request?: TrueForge.ListSchedulesRequest, requestOptions?: SchedulesClient.RequestOptions): Promise<core.Page<TrueForge.Schedule, TrueForge.ListSchedulesResponse>>;
+    /**
+     * Create a schedule for an existing agent (by name) and add its first pending run when active.
+     *
+     * @param {TrueForge.CreateScheduleRequest} request
+     * @param {SchedulesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link TrueForge.BadRequestError}
+     * @throws {@link TrueForge.NotFoundError}
+     * @throws {@link TrueForge.ConflictError}
+     * @throws {@link errors.TrueForgeError}
+     * @throws {@link errors.TrueForgeTimeoutError}
+     *
+     * @example
+     *     await client.schedules.create({
+     *         agentName: "agent_name",
+     *         manifest: {
+     *             cron: "cron",
+     *             task: "task"
+     *         },
+     *         name: "name"
+     *     })
+     */
+    create(request: TrueForge.CreateScheduleRequest, requestOptions?: SchedulesClient.RequestOptions): core.HttpResponsePromise<TrueForge.GetScheduleResponse>;
+    private __create;
+    /**
+     * Start a schedule run immediately using the schedule task. Does not replace or advance the cron pending run.
+     *
+     * @param {TrueForge.CreateScheduleRunRequest} request
+     * @param {SchedulesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link TrueForge.BadRequestError}
+     * @throws {@link TrueForge.ForbiddenError}
+     * @throws {@link TrueForge.NotFoundError}
+     * @throws {@link TrueForge.ConflictError}
+     * @throws {@link TrueForge.UnprocessableEntityError}
+     * @throws {@link errors.TrueForgeError}
+     * @throws {@link errors.TrueForgeTimeoutError}
+     *
+     * @example
+     *     await client.schedules.createRun({
+     *         scheduleId: "schedule_id"
+     *     })
+     */
+    createRun(request: TrueForge.CreateScheduleRunRequest, requestOptions?: SchedulesClient.RequestOptions): core.HttpResponsePromise<TrueForge.CreateScheduleRunResponse>;
+    private __createRun;
+    /**
+     * Get a schedule by id.
+     *
+     * @param {string} schedule_id - Immutable schedule identifier.
+     * @param {SchedulesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link TrueForge.ForbiddenError}
+     * @throws {@link TrueForge.NotFoundError}
+     * @throws {@link errors.TrueForgeError}
+     * @throws {@link errors.TrueForgeTimeoutError}
+     *
+     * @example
+     *     await client.schedules.get("schedule_id")
+     */
+    get(schedule_id: string, requestOptions?: SchedulesClient.RequestOptions): core.HttpResponsePromise<TrueForge.GetScheduleResponse>;
+    private __get;
+    /**
+     * Replace name and manifest; replaces or drops the pending run when status/cron/timezone change.
+     *
+     * @param {string} schedule_id - Immutable schedule identifier.
+     * @param {TrueForge.UpdateScheduleRequest} request
+     * @param {SchedulesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link TrueForge.BadRequestError}
+     * @throws {@link TrueForge.ForbiddenError}
+     * @throws {@link TrueForge.NotFoundError}
+     * @throws {@link TrueForge.ConflictError}
+     * @throws {@link errors.TrueForgeError}
+     * @throws {@link errors.TrueForgeTimeoutError}
+     *
+     * @example
+     *     await client.schedules.update("schedule_id", {
+     *         manifest: {
+     *             cron: "cron",
+     *             task: "task"
+     *         },
+     *         name: "name"
+     *     })
+     */
+    update(schedule_id: string, request: TrueForge.UpdateScheduleRequest, requestOptions?: SchedulesClient.RequestOptions): core.HttpResponsePromise<TrueForge.GetScheduleResponse>;
+    private __update;
+    /**
+     * Delete a schedule and its runs. Idempotent.
+     *
+     * @param {string} schedule_id - Immutable schedule identifier.
+     * @param {SchedulesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link TrueForge.UnauthorizedError}
+     * @throws {@link TrueForge.ForbiddenError}
+     * @throws {@link errors.TrueForgeError}
+     * @throws {@link errors.TrueForgeTimeoutError}
+     *
+     * @example
+     *     await client.schedules.delete("schedule_id")
+     */
+    delete(schedule_id: string, requestOptions?: SchedulesClient.RequestOptions): core.HttpResponsePromise<TrueForge.DeleteScheduleResponse>;
+    private __delete;
+    /**
+     * 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 {SchedulesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link TrueForge.ForbiddenError}
+     * @throws {@link TrueForge.NotFoundError}
+     * @throws {@link errors.TrueForgeError}
+     * @throws {@link errors.TrueForgeTimeoutError}
+     *
+     * @example
+     *     await client.schedules.listRuns("schedule_id")
+     */
+    listRuns(schedule_id: string, requestOptions?: SchedulesClient.RequestOptions): core.HttpResponsePromise<TrueForge.ListScheduleRunsResponse>;
+    private __listRuns;
+}