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

package/reference.md

@@ -277,7 +277,7 @@ await client.agents.update("agent_id", {
 <dl>
 <dd>
 
-Delete a configured agent by immutable id. Idempotent if already gone.
+Delete a configured agent by immutable id.
 </dd>
 </dl>
 </dd>
@@ -341,7 +341,7 @@ await client.agents.delete("agent_id");
 <dl>
 <dd>
 
-Returns the authenticated caller identity. When auth is enabled this requires a valid `id_token` cookie or `Authorization: Bearer` ID token (401 otherwise). When auth is disabled, returns the default identity.
+Returns the authenticated caller identity (`type`, `tenant_id`, `subject`, `roles`) wrapped as `{ data }`. `type` is `oidc-connected` when browser OIDC is enabled, otherwise `default`. When auth is enabled this requires a valid `id_token` cookie or `Authorization: Bearer` token (401 otherwise). When auth is disabled, returns the standalone default identity.
 </dd>
 </dl>
 </dd>
@@ -441,7 +441,7 @@ await client.server.getCapabilities();
 </details>
 
 ## MCP Servers
-<details><summary><code>client.mcpServers.<a href="/src/api/resources/mcpServers/client/Client.ts">list</a>() -> TrueForge.ListAvailableMcpServersResponse</code></summary>
+<details><summary><code>client.mcpServers.<a href="/src/api/resources/mcpServers/client/Client.ts">list</a>({ ...params }) -> core.Page&lt;TrueForge.AvailableMcpServer, TrueForge.ListAvailableMcpServersResponse&gt;</code></summary>
 <dl>
 <dd>
 
@@ -453,7 +453,7 @@ await client.server.getCapabilities();
 <dl>
 <dd>
 
-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.
 </dd>
 </dl>
 </dd>
@@ -484,6 +484,14 @@ await client.mcpServers.list();
 <dl>
 <dd>
 
+**request:** `TrueForge.ListMcpServersRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **requestOptions:** `McpServersClient.RequestOptions` 
     
 </dd>
@@ -508,7 +516,7 @@ await client.mcpServers.list();
 <dl>
 <dd>
 
-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.
 </dd>
 </dl>
 </dd>
@@ -579,7 +587,7 @@ await client.mcpServers.authorize("name");
 <dl>
 <dd>
 
-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.
 </dd>
 </dl>
 </dd>
@@ -749,8 +757,8 @@ await client.models.list();
 </dl>
 </details>
 
-## Sessions
-<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">list</a>({ ...params }) -> core.Page&lt;TrueForge.Session, TrueForge.ListSessionsResponse&gt;</code></summary>
+## Schedules
+<details><summary><code>client.schedules.<a href="/src/api/resources/schedules/client/Client.ts">list</a>({ ...params }) -> core.Page&lt;TrueForge.Schedule, TrueForge.ListSchedulesResponse&gt;</code></summary>
 <dl>
 <dd>
 
@@ -762,7 +770,7 @@ await client.models.list();
 <dl>
 <dd>
 
-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 schedules for the tenant, newest first.
 </dd>
 </dl>
 </dd>
@@ -777,7 +785,7 @@ List the caller's sessions (newest first by default), token-paginated. Results a
 <dd>
 
 ```typescript
-await client.sessions.list();
+await client.schedules.list();
 
 ```
 </dd>
@@ -793,7 +801,7 @@ await client.sessions.list();
 <dl>
 <dd>
 
-**request:** `TrueForge.ListSessionsRequest` 
+**request:** `TrueForge.ListSchedulesRequest` 
     
 </dd>
 </dl>
@@ -801,7 +809,7 @@ await client.sessions.list();
 <dl>
 <dd>
 
-**requestOptions:** `SessionsClient.RequestOptions` 
+**requestOptions:** `SchedulesClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -813,7 +821,7 @@ await client.sessions.list();
 </dl>
 </details>
 
-<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">create</a>({ ...params }) -> TrueForge.GetSessionResponse</code></summary>
+<details><summary><code>client.schedules.<a href="/src/api/resources/schedules/client/Client.ts">create</a>({ ...params }) -> TrueForge.GetScheduleResponse</code></summary>
 <dl>
 <dd>
 
@@ -825,7 +833,7 @@ await client.sessions.list();
 <dl>
 <dd>
 
-Create a session with `agent` as either `{ name }` (named registry binding) or `{ spec: AgentSpec }` (inline). Named sessions snapshot the agent name at create and resolve the live agent on each turn. Responses use `{ type: "reference", name, id }` or `{ type: "inline", spec }`.
+Create a schedule for an existing agent (by name) and add its first pending run when active.
 </dd>
 </dl>
 </dd>
@@ -840,10 +848,13 @@ Create a session with `agent` as either `{ name }` (named registry binding) or `
 <dd>
 
 ```typescript
-await client.sessions.create({
-    agent: {
-        name: "name"
-    }
+await client.schedules.create({
+    agentName: "agent_name",
+    manifest: {
+        cron: "cron",
+        task: "task"
+    },
+    name: "name"
 });
 
 ```
@@ -860,7 +871,7 @@ await client.sessions.create({
 <dl>
 <dd>
 
-**request:** `TrueForge.CreateSessionRequest` 
+**request:** `TrueForge.CreateScheduleRequest` 
     
 </dd>
 </dl>
@@ -868,7 +879,7 @@ await client.sessions.create({
 <dl>
 <dd>
 
-**requestOptions:** `SessionsClient.RequestOptions` 
+**requestOptions:** `SchedulesClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -880,7 +891,7 @@ await client.sessions.create({
 </dl>
 </details>
 
-<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">get</a>(session_id) -> TrueForge.GetSessionResponse</code></summary>
+<details><summary><code>client.schedules.<a href="/src/api/resources/schedules/client/Client.ts">createRun</a>({ ...params }) -> TrueForge.CreateScheduleRunResponse</code></summary>
 <dl>
 <dd>
 
@@ -892,7 +903,7 @@ await client.sessions.create({
 <dl>
 <dd>
 
-Fetch a session by ID. Only the session creator (`created_by`) may fetch it.
+Start a schedule run immediately using the schedule task. Does not replace or advance the cron pending run.
 </dd>
 </dl>
 </dd>
@@ -907,7 +918,9 @@ Fetch a session by ID. Only the session creator (`created_by`) may fetch it.
 <dd>
 
 ```typescript
-await client.sessions.get("session_id");
+await client.schedules.createRun({
+    scheduleId: "schedule_id"
+});
 
 ```
 </dd>
@@ -923,7 +936,7 @@ await client.sessions.get("session_id");
 <dl>
 <dd>
 
-**session_id:** `string` — Session identifier.
+**request:** `TrueForge.CreateScheduleRunRequest` 
     
 </dd>
 </dl>
@@ -931,7 +944,7 @@ await client.sessions.get("session_id");
 <dl>
 <dd>
 
-**requestOptions:** `SessionsClient.RequestOptions` 
+**requestOptions:** `SchedulesClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -943,7 +956,7 @@ await client.sessions.get("session_id");
 </dl>
 </details>
 
-<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">delete</a>(session_id) -> void</code></summary>
+<details><summary><code>client.schedules.<a href="/src/api/resources/schedules/client/Client.ts">get</a>(schedule_id) -> TrueForge.GetScheduleResponse</code></summary>
 <dl>
 <dd>
 
@@ -955,7 +968,7 @@ await client.sessions.get("session_id");
 <dl>
 <dd>
 
-Delete a session and all related turns, events, and internal state. Only the session creator (`created_by`) may delete it. Idempotent if already gone.
+Get a schedule by id.
 </dd>
 </dl>
 </dd>
@@ -970,7 +983,7 @@ Delete a session and all related turns, events, and internal state. Only the ses
 <dd>
 
 ```typescript
-await client.sessions.delete("session_id");
+await client.schedules.get("schedule_id");
 
 ```
 </dd>
@@ -986,7 +999,7 @@ await client.sessions.delete("session_id");
 <dl>
 <dd>
 
-**session_id:** `string` — Session identifier.
+**schedule_id:** `string` — Immutable schedule identifier.
     
 </dd>
 </dl>
@@ -994,7 +1007,7 @@ await client.sessions.delete("session_id");
 <dl>
 <dd>
 
-**requestOptions:** `SessionsClient.RequestOptions` 
+**requestOptions:** `SchedulesClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1006,7 +1019,7 @@ await client.sessions.delete("session_id");
 </dl>
 </details>
 
-<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">update</a>(session_id, { ...params }) -> TrueForge.GetSessionResponse</code></summary>
+<details><summary><code>client.schedules.<a href="/src/api/resources/schedules/client/Client.ts">update</a>(schedule_id, { ...params }) -> TrueForge.GetScheduleResponse</code></summary>
 <dl>
 <dd>
 
@@ -1018,7 +1031,7 @@ await client.sessions.delete("session_id");
 <dl>
 <dd>
 
-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.
+Replace name and manifest; replaces or drops the pending run when status/cron/timezone change.
 </dd>
 </dl>
 </dd>
@@ -1033,7 +1046,13 @@ Update a session by replacing `agent` with `{ spec: AgentSpec }`. Named (referen
 <dd>
 
 ```typescript
-await client.sessions.update("session_id");
+await client.schedules.update("schedule_id", {
+    manifest: {
+        cron: "cron",
+        task: "task"
+    },
+    name: "name"
+});
 
 ```
 </dd>
@@ -1049,7 +1068,7 @@ await client.sessions.update("session_id");
 <dl>
 <dd>
 
-**session_id:** `string` — Session identifier.
+**schedule_id:** `string` — Immutable schedule identifier.
     
 </dd>
 </dl>
@@ -1057,7 +1076,7 @@ await client.sessions.update("session_id");
 <dl>
 <dd>
 
-**request:** `TrueForge.UpdateSessionRequest` 
+**request:** `TrueForge.UpdateScheduleRequest` 
     
 </dd>
 </dl>
@@ -1065,7 +1084,7 @@ await client.sessions.update("session_id");
 <dl>
 <dd>
 
-**requestOptions:** `SessionsClient.RequestOptions` 
+**requestOptions:** `SchedulesClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1077,7 +1096,7 @@ await client.sessions.update("session_id");
 </dl>
 </details>
 
-<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">cancel</a>(session_id, { ...params }) -> TrueForge.CancelSessionResponse</code></summary>
+<details><summary><code>client.schedules.<a href="/src/api/resources/schedules/client/Client.ts">delete</a>(schedule_id) -> TrueForge.DeleteScheduleResponse</code></summary>
 <dl>
 <dd>
 
@@ -1089,7 +1108,7 @@ await client.sessions.update("session_id");
 <dl>
 <dd>
 
-Cancel the running last turn for a session. Only the session creator (`created_by`) may cancel.
+Delete a schedule and its runs. Idempotent.
 </dd>
 </dl>
 </dd>
@@ -1104,7 +1123,7 @@ Cancel the running last turn for a session. Only the session creator (`created_b
 <dd>
 
 ```typescript
-await client.sessions.cancel("session_id");
+await client.schedules.delete("schedule_id");
 
 ```
 </dd>
@@ -1120,15 +1139,7 @@ await client.sessions.cancel("session_id");
 <dl>
 <dd>
 
-**session_id:** `string` — Session identifier.
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `TrueForge.CancelSessionRequest` 
+**schedule_id:** `string` — Immutable schedule identifier.
     
 </dd>
 </dl>
@@ -1136,7 +1147,7 @@ await client.sessions.cancel("session_id");
 <dl>
 <dd>
 
-**requestOptions:** `SessionsClient.RequestOptions` 
+**requestOptions:** `SchedulesClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1148,7 +1159,7 @@ await client.sessions.cancel("session_id");
 </dl>
 </details>
 
-<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">listEvents</a>(session_id, { ...params }) -> core.Page&lt;TrueForge.SessionEventItem, TrueForge.ListSessionEventsResponse&gt;</code></summary>
+<details><summary><code>client.schedules.<a href="/src/api/resources/schedules/client/Client.ts">listRuns</a>(schedule_id) -> TrueForge.ListScheduleRunsResponse</code></summary>
 <dl>
 <dd>
 
@@ -1160,7 +1171,7 @@ await client.sessions.cancel("session_id");
 <dl>
 <dd>
 
-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 runs of a schedule, newest `scheduled_for` first. Available to its creator or a manager of its agent.
 </dd>
 </dl>
 </dd>
@@ -1175,7 +1186,7 @@ List session events as `{ turn_id, event }` across the active turn branch (newes
 <dd>
 
 ```typescript
-await client.sessions.listEvents("session_id");
+await client.schedules.listRuns("schedule_id");
 
 ```
 </dd>
@@ -1191,15 +1202,7 @@ await client.sessions.listEvents("session_id");
 <dl>
 <dd>
 
-**session_id:** `string` — Session identifier.
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `TrueForge.ListEventsSessionsRequest` 
+**schedule_id:** `string` — Immutable schedule identifier.
     
 </dd>
 </dl>
@@ -1207,7 +1210,7 @@ await client.sessions.listEvents("session_id");
 <dl>
 <dd>
 
-**requestOptions:** `SessionsClient.RequestOptions` 
+**requestOptions:** `SchedulesClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1219,7 +1222,8 @@ await client.sessions.listEvents("session_id");
 </dl>
 </details>
 
-<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">listTurns</a>(session_id, { ...params }) -> core.Page&lt;TrueForge.Turn, TrueForge.ListTurnsResponse&gt;</code></summary>
+## Sessions
+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">list</a>({ ...params }) -> core.Page&lt;TrueForge.Session, TrueForge.ListSessionsResponse&gt;</code></summary>
 <dl>
 <dd>
 
@@ -1231,7 +1235,7 @@ await client.sessions.listEvents("session_id");
 <dl>
 <dd>
 
-List turns for a session (newest first by default), token-paginated. Only the session creator (`created_by`) may list turns.
+List the sessions (newest first by default).
 </dd>
 </dl>
 </dd>
@@ -1246,7 +1250,7 @@ List turns for a session (newest first by default), token-paginated. Only the se
 <dd>
 
 ```typescript
-await client.sessions.listTurns("session_id");
+await client.sessions.list();
 
 ```
 </dd>
@@ -1262,15 +1266,7 @@ await client.sessions.listTurns("session_id");
 <dl>
 <dd>
 
-**session_id:** `string` — Session identifier.
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `TrueForge.ListTurnsSessionsRequest` 
+**request:** `TrueForge.ListSessionsRequest` 
     
 </dd>
 </dl>
@@ -1290,7 +1286,7 @@ await client.sessions.listTurns("session_id");
 </dl>
 </details>
 
-<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">createTurnStream</a>(session_id, { ...params }) -> core.Stream&lt;TrueForge.TurnStreamingEvent&gt;</code></summary>
+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">create</a>({ ...params }) -> TrueForge.GetSessionResponse</code></summary>
 <dl>
 <dd>
 
@@ -1302,11 +1298,7 @@ await client.sessions.listTurns("session_id");
 <dl>
 <dd>
 
-Create a turn within a session and execute it.
-Only the session creator (`created_by`) 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.
+Create a session with `agent` as either `{ name }` (named registry binding) or `{ spec: AgentSpec }` (inline). Named sessions snapshot the agent name at create and resolve the live agent on each turn. Responses use `{ type: "reference", name, id }` or `{ type: "inline", spec }`.
 </dd>
 </dl>
 </dd>
@@ -1321,10 +1313,11 @@ Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`);
 <dd>
 
 ```typescript
-const response = await client.sessions.createTurnStream("session_id", {});
-for await (const item of response) {
-    console.log(item);
-}
+await client.sessions.create({
+    agent: {
+        name: "name"
+    }
+});
 
 ```
 </dd>
@@ -1340,15 +1333,7 @@ for await (const item of response) {
 <dl>
 <dd>
 
-**session_id:** `string` — Session identifier.
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `TrueForge.CreateTurnSessionsStreamRequest` 
+**request:** `TrueForge.CreateSessionRequest` 
     
 </dd>
 </dl>
@@ -1368,7 +1353,7 @@ for await (const item of response) {
 </dl>
 </details>
 
-<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">createTurn</a>(session_id, { ...params }) -> TrueForge.GetTurnResponse</code></summary>
+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">get</a>(session_id) -> TrueForge.GetSessionResponse</code></summary>
 <dl>
 <dd>
 
@@ -1380,11 +1365,7 @@ for await (const item of response) {
 <dl>
 <dd>
 
-Create a turn within a session and execute it.
-Only the session creator (`created_by`) 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.
+Fetch a session by ID. Only the session creator may fetch it.
 </dd>
 </dl>
 </dd>
@@ -1399,7 +1380,7 @@ Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`);
 <dd>
 
 ```typescript
-await client.sessions.createTurn("session_id", {});
+await client.sessions.get("session_id");
 
 ```
 </dd>
@@ -1423,14 +1404,6 @@ await client.sessions.createTurn("session_id", {});
 <dl>
 <dd>
 
-**request:** `TrueForge.CreateTurnSessionsRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
 **requestOptions:** `SessionsClient.RequestOptions` 
     
 </dd>
@@ -1443,7 +1416,7 @@ await client.sessions.createTurn("session_id", {});
 </dl>
 </details>
 
-<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">getTurn</a>(session_id, turn_id) -> TrueForge.GetTurnResponse</code></summary>
+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">delete</a>(session_id) -> void</code></summary>
 <dl>
 <dd>
 
@@ -1455,7 +1428,7 @@ await client.sessions.createTurn("session_id", {});
 <dl>
 <dd>
 
-Fetch a single turn by ID. Only the session creator (`created_by`) may fetch it.
+Delete a session and all related turns, events, and internal state. Only the session creator may delete it. Idempotent if already gone.
 </dd>
 </dl>
 </dd>
@@ -1470,7 +1443,7 @@ Fetch a single turn by ID. Only the session creator (`created_by`) may fetch it.
 <dd>
 
 ```typescript
-await client.sessions.getTurn("session_id", "turn_id");
+await client.sessions.delete("session_id");
 
 ```
 </dd>
@@ -1494,14 +1467,6 @@ await client.sessions.getTurn("session_id", "turn_id");
 <dl>
 <dd>
 
-**turn_id:** `string` — Turn identifier.
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
 **requestOptions:** `SessionsClient.RequestOptions` 
     
 </dd>
@@ -1514,7 +1479,7 @@ await client.sessions.getTurn("session_id", "turn_id");
 </dl>
 </details>
 
-<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">downloadSandboxFile</a>(session_id, turn_id, { ...params }) -> core.BinaryResponse</code></summary>
+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">update</a>(session_id, { ...params }) -> TrueForge.GetSessionResponse</code></summary>
 <dl>
 <dd>
 
@@ -1526,7 +1491,7 @@ await client.sessions.getTurn("session_id", "turn_id");
 <dl>
 <dd>
 
-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.
+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.
 </dd>
 </dl>
 </dd>
@@ -1541,9 +1506,7 @@ Download a file from the sandbox this turn ran in. Paths come from the assistant
 <dd>
 
 ```typescript
-await client.sessions.downloadSandboxFile("session_id", "turn_id", {
-    path: "x"
-});
+await client.sessions.update("session_id");
 
 ```
 </dd>
@@ -1567,15 +1530,7 @@ await client.sessions.downloadSandboxFile("session_id", "turn_id", {
 <dl>
 <dd>
 
-**turn_id:** `string` — Turn identifier.
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `TrueForge.DownloadSandboxFileSessionsRequest` 
+**request:** `TrueForge.UpdateSessionRequest` 
     
 </dd>
 </dl>
@@ -1595,7 +1550,7 @@ await client.sessions.downloadSandboxFile("session_id", "turn_id", {
 </dl>
 </details>
 
-<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">listTurnEvents</a>(session_id, turn_id, { ...params }) -> core.Page&lt;TrueForge.SessionEvent, TrueForge.ListTurnEventsResponse&gt;</code></summary>
+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">cancel</a>(session_id, { ...params }) -> TrueForge.CancelSessionResponse</code></summary>
 <dl>
 <dd>
 
@@ -1607,7 +1562,7 @@ await client.sessions.downloadSandboxFile("session_id", "turn_id", {
 <dl>
 <dd>
 
-Paginated persisted events for a turn (insertion order by default). Only the session creator (`created_by`) may list events.
+Cancel the running last turn for a session. Only the session creator may cancel.
 </dd>
 </dl>
 </dd>
@@ -1622,7 +1577,7 @@ Paginated persisted events for a turn (insertion order by default). Only the ses
 <dd>
 
 ```typescript
-await client.sessions.listTurnEvents("session_id", "turn_id");
+await client.sessions.cancel("session_id");
 
 ```
 </dd>
@@ -1646,15 +1601,7 @@ await client.sessions.listTurnEvents("session_id", "turn_id");
 <dl>
 <dd>
 
-**turn_id:** `string` — Turn identifier.
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `TrueForge.ListTurnEventsSessionsRequest` 
+**request:** `TrueForge.CancelSessionRequest` 
     
 </dd>
 </dl>
@@ -1674,7 +1621,7 @@ await client.sessions.listTurnEvents("session_id", "turn_id");
 </dl>
 </details>
 
-<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">subscribeToTurn</a>(session_id, turn_id, { ...params }) -> core.Stream&lt;TrueForge.TurnStreamingEvent&gt;</code></summary>
+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">listEvents</a>(session_id, { ...params }) -> core.Page&lt;TrueForge.SessionEventItem, TrueForge.ListSessionEventsResponse&gt;</code></summary>
 <dl>
 <dd>
 
@@ -1686,7 +1633,7 @@ await client.sessions.listTurnEvents("session_id", "turn_id");
 <dl>
 <dd>
 
-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).
+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.
 </dd>
 </dl>
 </dd>
@@ -1701,10 +1648,7 @@ Subscribe to the live SSE stream for a turn. Only the session creator (`created_
 <dd>
 
 ```typescript
-const response = await client.sessions.subscribeToTurn("session_id", "turn_id");
-for await (const item of response) {
-    console.log(item);
-}
+await client.sessions.listEvents("session_id");
 
 ```
 </dd>
@@ -1728,15 +1672,7 @@ for await (const item of response) {
 <dl>
 <dd>
 
-**turn_id:** `string` — Turn identifier.
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `TrueForge.SubscribeToTurnSessionsRequest` 
+**request:** `TrueForge.ListEventsSessionsRequest` 
     
 </dd>
 </dl>
@@ -1756,8 +1692,7 @@ for await (const item of response) {
 </dl>
 </details>
 
-## Skills
-<details><summary><code>client.skills.<a href="/src/api/resources/skills/client/Client.ts">list</a>() -> TrueForge.ListAvailableSkillsResponse</code></summary>
+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">listTurns</a>(session_id, { ...params }) -> core.Page&lt;TrueForge.Turn, TrueForge.ListTurnsResponse&gt;</code></summary>
 <dl>
 <dd>
 
@@ -1769,7 +1704,7 @@ for await (const item of response) {
 <dl>
 <dd>
 
-Configured skills as a slim name/description list for the composer.
+List turns for a session (newest first by default), token-paginated. Only the session creator may list turns.
 </dd>
 </dl>
 </dd>
@@ -1784,7 +1719,7 @@ Configured skills as a slim name/description list for the composer.
 <dd>
 
 ```typescript
-await client.skills.list();
+await client.sessions.listTurns("session_id");
 
 ```
 </dd>
@@ -1800,7 +1735,23 @@ await client.skills.list();
 <dl>
 <dd>
 
-**requestOptions:** `SkillsClient.RequestOptions` 
+**session_id:** `string` — Session identifier.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `TrueForge.ListTurnsSessionsRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `SessionsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1812,8 +1763,7 @@ await client.skills.list();
 </dl>
 </details>
 
-## Catalogs McpServers
-<details><summary><code>client.catalogs.mcpServers.<a href="/src/api/resources/catalogs/resources/mcpServers/client/Client.ts">list</a>() -> TrueForge.GetMcpServerCatalogResponse</code></summary>
+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">createTurnStream</a>(session_id, { ...params }) -> core.Stream&lt;TrueForge.TurnStreamingEvent&gt;</code></summary>
 <dl>
 <dd>
 
@@ -1825,7 +1775,11 @@ await client.skills.list();
 <dl>
 <dd>
 
-Shipped MCP server presets (discovery-only). Copy into PUT /settings/mcp-servers to configure.
+Create a turn within a session and execute it.
+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.
 </dd>
 </dl>
 </dd>
@@ -1840,7 +1794,10 @@ Shipped MCP server presets (discovery-only). Copy into PUT /settings/mcp-servers
 <dd>
 
 ```typescript
-await client.catalogs.mcpServers.list();
+const response = await client.sessions.createTurnStream("session_id", {});
+for await (const item of response) {
+    console.log(item);
+}
 
 ```
 </dd>
@@ -1856,7 +1813,23 @@ await client.catalogs.mcpServers.list();
 <dl>
 <dd>
 
-**requestOptions:** `McpServersClient.RequestOptions` 
+**session_id:** `string` — Session identifier.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `TrueForge.CreateTurnSessionsStreamRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `SessionsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1868,8 +1841,7 @@ await client.catalogs.mcpServers.list();
 </dl>
 </details>
 
-## Catalogs ModelProviders
-<details><summary><code>client.catalogs.modelProviders.<a href="/src/api/resources/catalogs/resources/modelProviders/client/Client.ts">list</a>() -> TrueForge.GetModelProviderCatalogResponse</code></summary>
+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">createTurn</a>(session_id, { ...params }) -> TrueForge.GetTurnResponse</code></summary>
 <dl>
 <dd>
 
@@ -1881,7 +1853,11 @@ await client.catalogs.mcpServers.list();
 <dl>
 <dd>
 
-Shipped model-provider presets (discovery-only). Copy into PUT /settings/model-providers to configure. Includes a `custom` sentinel with `supported_reasoning_efforts`.
+Create a turn within a session and execute it.
+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.
 </dd>
 </dl>
 </dd>
@@ -1896,7 +1872,7 @@ Shipped model-provider presets (discovery-only). Copy into PUT /settings/model-p
 <dd>
 
 ```typescript
-await client.catalogs.modelProviders.list();
+await client.sessions.createTurn("session_id", {});
 
 ```
 </dd>
@@ -1912,19 +1888,516 @@ await client.catalogs.modelProviders.list();
 <dl>
 <dd>
 
-**requestOptions:** `ModelProvidersClient.RequestOptions` 
+**session_id:** `string` — Session identifier.
     
 </dd>
 </dl>
-</dd>
-</dl>
 
+<dl>
+<dd>
 
+**request:** `TrueForge.CreateTurnSessionsRequest` 
+    
 </dd>
 </dl>
-</details>
 
-## Catalogs SandboxProviders
+<dl>
+<dd>
+
+**requestOptions:** `SessionsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">getTurn</a>(session_id, turn_id) -> TrueForge.GetTurnResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Fetch a single turn by ID. Only the session creator may fetch it.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.sessions.getTurn("session_id", "turn_id");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**session_id:** `string` — Session identifier.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**turn_id:** `string` — Turn identifier.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `SessionsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">downloadSandboxFile</a>(session_id, turn_id, { ...params }) -> core.BinaryResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+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.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.sessions.downloadSandboxFile("session_id", "turn_id", {
+    path: "x"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**session_id:** `string` — Session identifier.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**turn_id:** `string` — Turn identifier.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `TrueForge.DownloadSandboxFileSessionsRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `SessionsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">listTurnEvents</a>(session_id, turn_id, { ...params }) -> core.Page&lt;TrueForge.SessionEvent, TrueForge.ListTurnEventsResponse&gt;</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Paginated persisted events for a turn (insertion order by default). Only the session creator may list events.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.sessions.listTurnEvents("session_id", "turn_id");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**session_id:** `string` — Session identifier.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**turn_id:** `string` — Turn identifier.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `TrueForge.ListTurnEventsSessionsRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `SessionsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">subscribeToTurn</a>(session_id, turn_id, { ...params }) -> core.Stream&lt;TrueForge.TurnStreamingEvent&gt;</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+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).
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+const response = await client.sessions.subscribeToTurn("session_id", "turn_id");
+for await (const item of response) {
+    console.log(item);
+}
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**session_id:** `string` — Session identifier.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**turn_id:** `string` — Turn identifier.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `TrueForge.SubscribeToTurnSessionsRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `SessionsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+## Skills
+<details><summary><code>client.skills.<a href="/src/api/resources/skills/client/Client.ts">list</a>() -> TrueForge.ListAvailableSkillsResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Configured skills as a slim name/description list for the composer.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.skills.list();
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**requestOptions:** `SkillsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+## Catalogs McpServers
+<details><summary><code>client.catalogs.mcpServers.<a href="/src/api/resources/catalogs/resources/mcpServers/client/Client.ts">list</a>() -> TrueForge.GetMcpServerCatalogResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Shipped MCP server presets (discovery-only). Copy into PUT /settings/mcp-servers to configure.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.catalogs.mcpServers.list();
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**requestOptions:** `McpServersClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+## Catalogs ModelProviders
+<details><summary><code>client.catalogs.modelProviders.<a href="/src/api/resources/catalogs/resources/modelProviders/client/Client.ts">list</a>() -> TrueForge.GetModelProviderCatalogResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Shipped model-provider presets (discovery-only). Copy into PUT /settings/model-providers to configure. Includes a `custom` sentinel with `supported_reasoning_efforts`.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.catalogs.modelProviders.list();
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**requestOptions:** `ModelProvidersClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+## Catalogs SandboxProviders
 <details><summary><code>client.catalogs.sandboxProviders.<a href="/src/api/resources/catalogs/resources/sandboxProviders/client/Client.ts">list</a>() -> TrueForge.GetSandboxProviderCatalogResponse</code></summary>
 <dl>
 <dd>
@@ -1937,7 +2410,119 @@ await client.catalogs.modelProviders.list();
 <dl>
 <dd>
 
-Shipped sandbox-provider presets (discovery-only). Copy into PUT /settings/sandbox-providers to configure.
+Shipped sandbox-provider presets (discovery-only). Copy into PUT /settings/sandbox-providers to configure.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.catalogs.sandboxProviders.list();
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**requestOptions:** `SandboxProvidersClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+## Catalogs Skills
+<details><summary><code>client.catalogs.skills.<a href="/src/api/resources/catalogs/resources/skills/client/Client.ts">list</a>() -> TrueForge.GetSkillCatalogResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Shipped skill presets (discovery-only). Copy into PUT /settings/skills to configure.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.catalogs.skills.list();
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**requestOptions:** `SkillsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+## Internal Metrics
+<details><summary><code>client.internal.metrics.<a href="/src/api/resources/internal/resources/metrics/client/Client.ts">listCharts</a>() -> TrueForge.GetSessionMetricsChartResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+List available session metric charts.
 </dd>
 </dl>
 </dd>
@@ -1952,7 +2537,7 @@ Shipped sandbox-provider presets (discovery-only). Copy into PUT /settings/sandb
 <dd>
 
 ```typescript
-await client.catalogs.sandboxProviders.list();
+await client.internal.metrics.listCharts();
 
 ```
 </dd>
@@ -1968,7 +2553,7 @@ await client.catalogs.sandboxProviders.list();
 <dl>
 <dd>
 
-**requestOptions:** `SandboxProvidersClient.RequestOptions` 
+**requestOptions:** `MetricsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1980,8 +2565,7 @@ await client.catalogs.sandboxProviders.list();
 </dl>
 </details>
 
-## Catalogs Skills
-<details><summary><code>client.catalogs.skills.<a href="/src/api/resources/catalogs/resources/skills/client/Client.ts">list</a>() -> TrueForge.GetSkillCatalogResponse</code></summary>
+<details><summary><code>client.internal.metrics.<a href="/src/api/resources/internal/resources/metrics/client/Client.ts">getChartData</a>({ ...params }) -> TrueForge.GetSessionMetricsChartDataResponse</code></summary>
 <dl>
 <dd>
 
@@ -1993,7 +2577,7 @@ await client.catalogs.sandboxProviders.list();
 <dl>
 <dd>
 
-Shipped skill presets (discovery-only). Copy into PUT /settings/skills to configure.
+Return one chart for the caller's sessions on a named agent over an inclusive creation-time window. Uses hourly buckets for windows up to 24 hours and daily UTC buckets otherwise.
 </dd>
 </dl>
 </dd>
@@ -2008,7 +2592,12 @@ Shipped skill presets (discovery-only). Copy into PUT /settings/skills to config
 <dd>
 
 ```typescript
-await client.catalogs.skills.list();
+await client.internal.metrics.getChartData({
+    agentId: "agent_id",
+    startTimestamp: new Date("2024-01-15T09:30:00.000Z"),
+    endTimestamp: new Date("2024-01-15T09:30:00.000Z"),
+    chartName: "sessions_over_time"
+});
 
 ```
 </dd>
@@ -2024,7 +2613,215 @@ await client.catalogs.skills.list();
 <dl>
 <dd>
 
-**requestOptions:** `SkillsClient.RequestOptions` 
+**request:** `TrueForge.internal.GetChartDataMetricsRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `MetricsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.internal.metrics.<a href="/src/api/resources/internal/resources/metrics/client/Client.ts">getMeters</a>({ ...params }) -> TrueForge.GetSessionMetricsMeterResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Aggregate the caller's session meters for a named agent over an inclusive creation-time window.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.internal.metrics.getMeters({
+    agentId: "agent_id",
+    startTimestamp: new Date("2024-01-15T09:30:00.000Z"),
+    endTimestamp: new Date("2024-01-15T09:30:00.000Z")
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `TrueForge.internal.GetMetersMetricsRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `MetricsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+## Internal Sessions
+<details><summary><code>client.internal.sessions.<a href="/src/api/resources/internal/resources/sessions/client/Client.ts">getOrCreateByExternalId</a>({ ...params }) -> TrueForge.GetSessionResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Idempotent get-or-create: returns the existing session for this `external_id`, or creates one
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.internal.sessions.getOrCreateByExternalId({
+    agent: {
+        name: "name"
+    },
+    externalId: "external_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `TrueForge.internal.GetOrCreateSessionByExternalIdRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `SessionsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+## Internal Agents
+<details><summary><code>client.internal.agents.<a href="/src/api/resources/internal/resources/agents/client/Client.ts">getCodeSnippets</a>(agent_id) -> TrueForge.GetAgentCodeSnippetsResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+TypeScript TrueForge SDK samples (stream and non-stream) for creating a session and turn against this agent.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.internal.agents.getCodeSnippets("agent_id");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**agent_id:** `string` — Immutable agent identifier.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -2037,7 +2834,7 @@ await client.catalogs.skills.list();
 </details>
 
 ## Settings McpServers
-<details><summary><code>client.settings.mcpServers.<a href="/src/api/resources/settings/resources/mcpServers/client/Client.ts">list</a>() -> TrueForge.ListMcpServersResponse</code></summary>
+<details><summary><code>client.settings.mcpServers.<a href="/src/api/resources/settings/resources/mcpServers/client/Client.ts">list</a>({ ...params }) -> core.Page&lt;TrueForge.ConfiguredMcpServer, TrueForge.ListMcpServersResponse&gt;</code></summary>
 <dl>
 <dd>
 
@@ -2049,7 +2846,7 @@ await client.catalogs.skills.list();
 <dl>
 <dd>
 
-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.
 </dd>
 </dl>
 </dd>
@@ -2080,6 +2877,14 @@ await client.settings.mcpServers.list();
 <dl>
 <dd>
 
+**request:** `TrueForge.settings.ListMcpServersRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **requestOptions:** `McpServersClient.RequestOptions` 
     
 </dd>
@@ -2174,7 +2979,7 @@ await client.settings.mcpServers.create({
 <dl>
 <dd>
 
-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).
 </dd>
 </dl>
 </dd>
@@ -2244,7 +3049,7 @@ await client.settings.mcpServers.createOrUpdate({
 <dl>
 <dd>
 
-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.
 </dd>
 </dl>
 </dd>