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

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

@@ -0,0 +1 @@
+export * from "./requests/index.mjs";

package/dist/esm/api/resources/schedules/client/requests/CreateScheduleRequest.d.mts

@@ -0,0 +1,17 @@
+import type * as TrueForge from "../../../../index.mjs";
+/**
+ * @example
+ *     {
+ *         agentName: "agent_name",
+ *         manifest: {
+ *             cron: "cron",
+ *             task: "task"
+ *         },
+ *         name: "name"
+ *     }
+ */
+export interface CreateScheduleRequest {
+    agentName: TrueForge.ResourceName;
+    manifest: TrueForge.ScheduleManifest;
+    name: TrueForge.ResourceName;
+}

package/dist/esm/api/resources/schedules/client/requests/CreateScheduleRequest.mjs

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

package/dist/esm/api/resources/schedules/client/requests/CreateScheduleRunRequest.d.mts

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {
+ *         scheduleId: "schedule_id"
+ *     }
+ */
+export interface CreateScheduleRunRequest {
+    /** Immutable schedule identifier. */
+    scheduleId: string;
+}

package/dist/esm/api/resources/schedules/client/requests/CreateScheduleRunRequest.mjs

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

package/dist/esm/api/resources/schedules/client/requests/ListSchedulesRequest.d.mts

@@ -0,0 +1,14 @@
+/**
+ * @example
+ *     {}
+ */
+export interface ListSchedulesRequest {
+    /** Page size. Defaults to 25 */
+    limit?: number;
+    /** Opaque token from a previous response `next_page_token`. */
+    pageToken?: string;
+    /** Filter by one or more agent names (comma-separated). When set, at least one name is required. */
+    agentNames?: string;
+    /** When true, only schedules created by the authenticated subject. */
+    createdByMe?: boolean;
+}

package/dist/esm/api/resources/schedules/client/requests/ListSchedulesRequest.mjs

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

package/dist/esm/api/resources/schedules/client/requests/UpdateScheduleRequest.d.mts

@@ -0,0 +1,15 @@
+import type * as TrueForge from "../../../../index.mjs";
+/**
+ * @example
+ *     {
+ *         manifest: {
+ *             cron: "cron",
+ *             task: "task"
+ *         },
+ *         name: "name"
+ *     }
+ */
+export interface UpdateScheduleRequest {
+    manifest: TrueForge.ScheduleManifest;
+    name: TrueForge.ResourceName;
+}

package/dist/esm/api/resources/schedules/client/requests/UpdateScheduleRequest.mjs

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

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

@@ -0,0 +1,4 @@
+export type { CreateScheduleRequest } from "./CreateScheduleRequest.mjs";
+export type { CreateScheduleRunRequest } from "./CreateScheduleRunRequest.mjs";
+export type { ListSchedulesRequest } from "./ListSchedulesRequest.mjs";
+export type { UpdateScheduleRequest } from "./UpdateScheduleRequest.mjs";

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

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

package/dist/esm/api/resources/schedules/exports.d.mts

@@ -0,0 +1,2 @@
+export { SchedulesClient } from "./client/Client.mjs";
+export * from "./client/index.mjs";

package/dist/esm/api/resources/schedules/exports.mjs

@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+export { SchedulesClient } from "./client/Client.mjs";
+export * from "./client/index.mjs";

package/dist/esm/api/resources/schedules/index.d.mts

@@ -0,0 +1 @@
+export * from "./client/index.mjs";

package/dist/esm/api/resources/schedules/index.mjs

@@ -0,0 +1 @@
+export * from "./client/index.mjs";

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

@@ -11,7 +11,7 @@ export declare class SessionsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<SessionsClient.Options>;
     constructor(options: SessionsClient.Options);
     /**
-     * List the caller's sessions (newest first by default), token-paginated. Results are scoped to the authenticated identity via the session store's `created_by` filter (not a client query param). Optional `agent_id` filters to sessions bound to that named agent. Pass `page_token` to fetch the next page, keeping the other query params constant.
+     * List the caller's sessions (newest first by default).
      *
      * @param {TrueForge.ListSessionsRequest} request
      * @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -46,7 +46,7 @@ export declare class SessionsClient {
     create(request: TrueForge.CreateSessionRequest, requestOptions?: SessionsClient.RequestOptions): core.HttpResponsePromise<TrueForge.GetSessionResponse>;
     private __create;
     /**
-     * Fetch a session by ID. Only the session creator (`created_by`) may fetch it.
+     * Fetch a session by ID. Only the session creator may fetch it.
      *
      * @param {string} session_id - Session identifier.
      * @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -62,7 +62,7 @@ export declare class SessionsClient {
     get(session_id: string, requestOptions?: SessionsClient.RequestOptions): core.HttpResponsePromise<TrueForge.GetSessionResponse>;
     private __get;
     /**
-     * Delete a session and all related turns, events, and internal state. Only the session creator (`created_by`) may delete it. Idempotent if already gone.
+     * Delete a session and all related turns, events, and internal state. Only the session creator may delete it. Idempotent if already gone.
      *
      * @param {string} session_id - Session identifier.
      * @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -77,7 +77,7 @@ export declare class SessionsClient {
     delete(session_id: string, requestOptions?: SessionsClient.RequestOptions): core.HttpResponsePromise<void>;
     private __delete;
     /**
-     * Update a session by replacing `agent` with `{ spec: AgentSpec }`. Named (reference) sessions reject agent updates. An empty body is a valid no-op that refreshes `updated_at`. Only the session creator (`created_by`) may update it.
+     * Update a session by replacing `agent` with `{ spec: AgentSpec }`. Named (reference) sessions reject agent updates. An empty body is a valid no-op that refreshes `updated_at`. Only the session creator may update it.
      *
      * @param {string} session_id - Session identifier.
      * @param {TrueForge.UpdateSessionRequest} request
@@ -96,7 +96,7 @@ export declare class SessionsClient {
     update(session_id: string, request?: TrueForge.UpdateSessionRequest, requestOptions?: SessionsClient.RequestOptions): core.HttpResponsePromise<TrueForge.GetSessionResponse>;
     private __update;
     /**
-     * Cancel the running last turn for a session. Only the session creator (`created_by`) may cancel.
+     * Cancel the running last turn for a session. Only the session creator may cancel.
      *
      * @param {string} session_id - Session identifier.
      * @param {TrueForge.CancelSessionRequest} request
@@ -114,7 +114,7 @@ export declare class SessionsClient {
     cancel(session_id: string, request?: TrueForge.CancelSessionRequest, requestOptions?: SessionsClient.RequestOptions): core.HttpResponsePromise<TrueForge.CancelSessionResponse>;
     private __cancel;
     /**
-     * List session events as `{ turn_id, event }` across the active turn branch (newest first), including persisted events from a running tip. Each turn contributes turn.created, content events (model.message, tool.call, …), and turn.done when terminal; streaming deltas are not included. Use `page_token` to paginate backward toward older events while retaining the original branch anchor. Only the session creator (`created_by`) may list events.
+     * List session events as `{ turn_id, event }` across the active turn branch (newest first), including persisted events from a running tip. Each turn contributes turn.created, content events (model.message, tool.call, …), and turn.done when terminal; streaming deltas are not included. Use `page_token` to paginate backward toward older events while retaining the original branch anchor. Only the session creator may list events.
      *
      * @param {string} session_id - Session identifier.
      * @param {TrueForge.ListEventsSessionsRequest} request
@@ -131,7 +131,7 @@ export declare class SessionsClient {
      */
     listEvents(session_id: string, request?: TrueForge.ListEventsSessionsRequest, requestOptions?: SessionsClient.RequestOptions): Promise<core.Page<TrueForge.SessionEventItem, TrueForge.ListSessionEventsResponse>>;
     /**
-     * List turns for a session (newest first by default), token-paginated. Only the session creator (`created_by`) may list turns.
+     * List turns for a session (newest first by default), token-paginated. Only the session creator may list turns.
      *
      * @param {string} session_id - Session identifier.
      * @param {TrueForge.ListTurnsSessionsRequest} request
@@ -149,7 +149,7 @@ export declare class SessionsClient {
     listTurns(session_id: string, request?: TrueForge.ListTurnsSessionsRequest, requestOptions?: SessionsClient.RequestOptions): Promise<core.Page<TrueForge.Turn, TrueForge.ListTurnsResponse>>;
     /**
      * Create a turn within a session and execute it.
-     * Only the session creator (`created_by`) may create turns.
+     * Only the session creator may create turns.
      * When `stream` is true (default), respond with a Server-Sent Events stream of turn events.
      * When `stream` is false, return the turn immediately with `state.status: "running"` while execution continues in the background; use get turn or subscribe to observe completion.
      * Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`); use `none` for a new root.
@@ -158,7 +158,7 @@ export declare class SessionsClient {
     private __createTurnStream;
     /**
      * Create a turn within a session and execute it.
-     * Only the session creator (`created_by`) may create turns.
+     * Only the session creator may create turns.
      * When `stream` is true (default), respond with a Server-Sent Events stream of turn events.
      * When `stream` is false, return the turn immediately with `state.status: "running"` while execution continues in the background; use get turn or subscribe to observe completion.
      * Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`); use `none` for a new root.
@@ -168,6 +168,7 @@ export declare class SessionsClient {
      * @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link TrueForge.BadRequestError}
+     * @throws {@link TrueForge.UnauthorizedError}
      * @throws {@link TrueForge.ForbiddenError}
      * @throws {@link TrueForge.NotFoundError}
      * @throws {@link TrueForge.PreconditionFailedError}
@@ -182,7 +183,7 @@ export declare class SessionsClient {
     createTurn(session_id: string, request: TrueForge.CreateTurnSessionsRequest, requestOptions?: SessionsClient.RequestOptions): core.HttpResponsePromise<TrueForge.GetTurnResponse>;
     private __createTurn;
     /**
-     * Fetch a single turn by ID. Only the session creator (`created_by`) may fetch it.
+     * Fetch a single turn by ID. Only the session creator may fetch it.
      *
      * @param {string} session_id - Session identifier.
      * @param {string} turn_id - Turn identifier.
@@ -199,7 +200,7 @@ export declare class SessionsClient {
     getTurn(session_id: string, turn_id: string, requestOptions?: SessionsClient.RequestOptions): core.HttpResponsePromise<TrueForge.GetTurnResponse>;
     private __getTurn;
     /**
-     * Download a file from the sandbox this turn ran in. Paths come from the assistant's `sandbox_artifacts` block. Only the session creator (`created_by`) may download.
+     * Download a file from the sandbox this turn ran in. Paths come from the assistant's `sandbox_artifacts` block. Only the session creator may download.
      *
      * @throws {@link TrueForge.BadRequestError}
      * @throws {@link TrueForge.ForbiddenError}
@@ -214,7 +215,7 @@ export declare class SessionsClient {
     downloadSandboxFile(session_id: string, turn_id: string, request: TrueForge.DownloadSandboxFileSessionsRequest, requestOptions?: SessionsClient.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
     private __downloadSandboxFile;
     /**
-     * Paginated persisted events for a turn (insertion order by default). Only the session creator (`created_by`) may list events.
+     * Paginated persisted events for a turn (insertion order by default). Only the session creator may list events.
      *
      * @param {string} session_id - Session identifier.
      * @param {string} turn_id - Turn identifier.
@@ -232,7 +233,7 @@ export declare class SessionsClient {
      */
     listTurnEvents(session_id: string, turn_id: string, request?: TrueForge.ListTurnEventsSessionsRequest, requestOptions?: SessionsClient.RequestOptions): Promise<core.Page<TrueForge.SessionEvent, TrueForge.ListTurnEventsResponse>>;
     /**
-     * Subscribe to the live SSE stream for a turn. Only the session creator (`created_by`) may subscribe. Pass `after_sequence_number` to resume after a disconnect (exclusive — events after this sequence number are replayed).
+     * Subscribe to the live SSE stream for a turn. Only the session creator may subscribe. Pass `after_sequence_number` to resume after a disconnect (exclusive — events after this sequence number are replayed).
      */
     subscribeToTurn(session_id: string, turn_id: string, request?: TrueForge.SubscribeToTurnSessionsRequest, requestOptions?: SessionsClient.RequestOptions): core.HttpResponsePromise<core.Stream<TrueForge.TurnStreamingEvent>>;
     private __subscribeToTurn;

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

@@ -21,7 +21,7 @@ export class SessionsClient {
         this._options = normalizeClientOptionsWithAuth(options);
     }
     /**
-     * List the caller's sessions (newest first by default), token-paginated. Results are scoped to the authenticated identity via the session store's `created_by` filter (not a client query param). Optional `agent_id` filters to sessions bound to that named agent. Pass `page_token` to fetch the next page, keeping the other query params constant.
+     * List the caller's sessions (newest first by default).
      *
      * @param {TrueForge.ListSessionsRequest} request
      * @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -37,7 +37,7 @@ export class SessionsClient {
         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 = 25, order, pageToken, startTimestamp, endTimestamp, agentId } = request;
+                const { limit = 25, order, pageToken, startTimestamp, endTimestamp, agentId, createdByMe } = request;
                 const _queryParams = {
                     limit,
                     order: order != null
@@ -52,6 +52,7 @@ export class SessionsClient {
                     start_timestamp: startTimestamp != null ? startTimestamp === null || startTimestamp === void 0 ? void 0 : startTimestamp.toISOString() : undefined,
                     end_timestamp: endTimestamp != null ? endTimestamp === null || endTimestamp === void 0 ? void 0 : endTimestamp.toISOString() : undefined,
                     agent_id: agentId,
+                    created_by_me: createdByMe,
                 };
                 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);
@@ -211,7 +212,7 @@ export class SessionsClient {
         });
     }
     /**
-     * Fetch a session by ID. Only the session creator (`created_by`) may fetch it.
+     * Fetch a session by ID. Only the session creator may fetch it.
      *
      * @param {string} session_id - Session identifier.
      * @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -285,7 +286,7 @@ export class SessionsClient {
         });
     }
     /**
-     * Delete a session and all related turns, events, and internal state. Only the session creator (`created_by`) may delete it. Idempotent if already gone.
+     * Delete a session and all related turns, events, and internal state. Only the session creator may delete it. Idempotent if already gone.
      *
      * @param {string} session_id - Session identifier.
      * @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -341,7 +342,7 @@ export class SessionsClient {
         });
     }
     /**
-     * Update a session by replacing `agent` with `{ spec: AgentSpec }`. Named (reference) sessions reject agent updates. An empty body is a valid no-op that refreshes `updated_at`. Only the session creator (`created_by`) may update it.
+     * Update a session by replacing `agent` with `{ spec: AgentSpec }`. Named (reference) sessions reject agent updates. An empty body is a valid no-op that refreshes `updated_at`. Only the session creator may update it.
      *
      * @param {string} session_id - Session identifier.
      * @param {TrueForge.UpdateSessionRequest} request
@@ -442,7 +443,7 @@ export class SessionsClient {
         });
     }
     /**
-     * Cancel the running last turn for a session. Only the session creator (`created_by`) may cancel.
+     * Cancel the running last turn for a session. Only the session creator may cancel.
      *
      * @param {string} session_id - Session identifier.
      * @param {TrueForge.CancelSessionRequest} request
@@ -534,7 +535,7 @@ export class SessionsClient {
         });
     }
     /**
-     * List session events as `{ turn_id, event }` across the active turn branch (newest first), including persisted events from a running tip. Each turn contributes turn.created, content events (model.message, tool.call, …), and turn.done when terminal; streaming deltas are not included. Use `page_token` to paginate backward toward older events while retaining the original branch anchor. Only the session creator (`created_by`) may list events.
+     * List session events as `{ turn_id, event }` across the active turn branch (newest first), including persisted events from a running tip. Each turn contributes turn.created, content events (model.message, tool.call, …), and turn.done when terminal; streaming deltas are not included. Use `page_token` to paginate backward toward older events while retaining the original branch anchor. Only the session creator may list events.
      *
      * @param {string} session_id - Session identifier.
      * @param {TrueForge.ListEventsSessionsRequest} request
@@ -638,7 +639,7 @@ export class SessionsClient {
         });
     }
     /**
-     * List turns for a session (newest first by default), token-paginated. Only the session creator (`created_by`) may list turns.
+     * List turns for a session (newest first by default), token-paginated. Only the session creator may list turns.
      *
      * @param {string} session_id - Session identifier.
      * @param {TrueForge.ListTurnsSessionsRequest} request
@@ -742,7 +743,7 @@ export class SessionsClient {
     }
     /**
      * Create a turn within a session and execute it.
-     * Only the session creator (`created_by`) may create turns.
+     * Only the session creator may create turns.
      * When `stream` is true (default), respond with a Server-Sent Events stream of turn events.
      * When `stream` is false, return the turn immediately with `state.status: "running"` while execution continues in the background; use get turn or subscribe to observe completion.
      * Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`); use `none` for a new root.
@@ -806,6 +807,14 @@ export class SessionsClient {
                             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",
@@ -859,7 +868,7 @@ export class SessionsClient {
     }
     /**
      * Create a turn within a session and execute it.
-     * Only the session creator (`created_by`) may create turns.
+     * Only the session creator may create turns.
      * When `stream` is true (default), respond with a Server-Sent Events stream of turn events.
      * When `stream` is false, return the turn immediately with `state.status: "running"` while execution continues in the background; use get turn or subscribe to observe completion.
      * Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`); use `none` for a new root.
@@ -869,6 +878,7 @@ export class SessionsClient {
      * @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link TrueForge.BadRequestError}
+     * @throws {@link TrueForge.UnauthorizedError}
      * @throws {@link TrueForge.ForbiddenError}
      * @throws {@link TrueForge.NotFoundError}
      * @throws {@link TrueForge.PreconditionFailedError}
@@ -929,6 +939,14 @@ export class SessionsClient {
                             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",
@@ -981,7 +999,7 @@ export class SessionsClient {
         });
     }
     /**
-     * Fetch a single turn by ID. Only the session creator (`created_by`) may fetch it.
+     * Fetch a single turn by ID. Only the session creator may fetch it.
      *
      * @param {string} session_id - Session identifier.
      * @param {string} turn_id - Turn identifier.
@@ -1056,7 +1074,7 @@ export class SessionsClient {
         });
     }
     /**
-     * Download a file from the sandbox this turn ran in. Paths come from the assistant's `sandbox_artifacts` block. Only the session creator (`created_by`) may download.
+     * Download a file from the sandbox this turn ran in. Paths come from the assistant's `sandbox_artifacts` block. Only the session creator may download.
      *
      * @throws {@link TrueForge.BadRequestError}
      * @throws {@link TrueForge.ForbiddenError}
@@ -1169,7 +1187,7 @@ export class SessionsClient {
         });
     }
     /**
-     * Paginated persisted events for a turn (insertion order by default). Only the session creator (`created_by`) may list events.
+     * Paginated persisted events for a turn (insertion order by default). Only the session creator may list events.
      *
      * @param {string} session_id - Session identifier.
      * @param {string} turn_id - Turn identifier.
@@ -1281,7 +1299,7 @@ export class SessionsClient {
         });
     }
     /**
-     * Subscribe to the live SSE stream for a turn. Only the session creator (`created_by`) may subscribe. Pass `after_sequence_number` to resume after a disconnect (exclusive — events after this sequence number are replayed).
+     * Subscribe to the live SSE stream for a turn. Only the session creator may subscribe. Pass `after_sequence_number` to resume after a disconnect (exclusive — events after this sequence number are replayed).
      */
     subscribeToTurn(session_id, turn_id, request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__subscribeToTurn(session_id, turn_id, request, requestOptions));

package/dist/esm/api/resources/sessions/client/requests/CreateSessionRequest.d.mts

@@ -9,4 +9,5 @@ import type * as TrueForge from "../../../../index.mjs";
  */
 export interface CreateSessionRequest {
     agent: TrueForge.CreateSessionAgent;
+    metadata?: TrueForge.SessionMetadata;
 }

package/dist/esm/api/resources/sessions/client/requests/ListSessionsRequest.d.mts

@@ -16,4 +16,6 @@ export interface ListSessionsRequest {
     endTimestamp?: Date;
     /** When set, only sessions bound to this agent id are returned. */
     agentId?: string;
+    /** When true, only sessions created by the authenticated subject. */
+    createdByMe?: boolean;
 }

package/dist/esm/api/resources/sessions/client/requests/UpdateSessionRequest.d.mts

@@ -5,4 +5,5 @@ import type * as TrueForge from "../../../../index.mjs";
  */
 export interface UpdateSessionRequest {
     agent?: TrueForge.SessionAgentSpecBody;
+    metadata?: TrueForge.SessionMetadata;
 }

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

@@ -11,10 +11,12 @@ export declare class McpServersClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<McpServersClient.Options>;
     constructor(options: McpServersClient.Options);
     /**
-     * All MCP servers with nested auth_status (settings / admin projection). Header auth values are redacted.
+     * Paginated 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}
@@ -23,8 +25,7 @@ export declare class McpServersClient {
      * @example
      *     await client.settings.mcpServers.list()
      */
-    list(requestOptions?: McpServersClient.RequestOptions): core.HttpResponsePromise<TrueForge.ListMcpServersResponse>;
-    private __list;
+    list(request?: TrueForge.settings.ListMcpServersRequest, requestOptions?: McpServersClient.RequestOptions): Promise<core.Page<TrueForge.ConfiguredMcpServer, TrueForge.ListMcpServersResponse>>;
     /**
      * 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.
      *
@@ -34,6 +35,7 @@ export declare class McpServersClient {
      * @throws {@link TrueForge.BadRequestError}
      * @throws {@link TrueForge.ConflictError}
      * @throws {@link TrueForge.UnprocessableEntityError}
+     * @throws {@link TrueForge.FailedDependencyError}
      * @throws {@link errors.TrueForgeError}
      * @throws {@link errors.TrueForgeTimeoutError}
      *
@@ -50,13 +52,14 @@ export declare class McpServersClient {
     create(request: TrueForge.settings.CreateMcpServerRequest, requestOptions?: McpServersClient.RequestOptions): core.HttpResponsePromise<TrueForge.GetMcpServerResponse>;
     private __create;
     /**
-     * Create or replace by `name`. Does not start DCR or change oauth client columns. Header secrets: real value sets/rotates; redacted keeps existing (400 if none).
+     * Create or replace by `name`. Header secrets: real value sets/rotates; redacted keeps existing (400 if none).
      *
      * @param {TrueForge.settings.UpdateMcpServerRequest} request
      * @param {McpServersClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link TrueForge.BadRequestError}
      * @throws {@link TrueForge.UnprocessableEntityError}
+     * @throws {@link TrueForge.FailedDependencyError}
      * @throws {@link errors.TrueForgeError}
      * @throws {@link errors.TrueForgeTimeoutError}
      *
@@ -73,7 +76,7 @@ export declare class McpServersClient {
     createOrUpdate(request: TrueForge.settings.UpdateMcpServerRequest, requestOptions?: McpServersClient.RequestOptions): core.HttpResponsePromise<TrueForge.GetMcpServerResponse>;
     private __createOrUpdate;
     /**
-     * A single MCP server by name, with nested auth_status (settings / admin projection). Header auth values are redacted.
+     * A single MCP server by name, with nested live auth_status (settings / admin projection). Header auth values are redacted.
      *
      * @param {string} name - MCP server name.
      * @param {McpServersClient.RequestOptions} requestOptions - Request-specific configuration.