@leaflow/sdk 0.0.0-dev.472.g83cc4b9 → 0.0.0-dev.476.gdbfc694

package/dist/fleet/v1/generated/functions.d.ts

@@ -201,9 +201,12 @@
  *    one second has passed, so that the offer carries them.
  * 3. Join with `POST /api/v1/sessions/{sessionId}/participants`, sending the public key and the
  *    offer. The answer carries the participant's signed authorization, the keys the service
- *    signs with, and the first PeerConnection: the session's SDP answer, its ICE candidates and
- *    the signed PeerAuthorization. Pass candidates gathered later with
- *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`.
+ *    signs with, and the first PeerConnection: the session's SDP answer, the ICE candidates it
+ *    has passed so far and the signed PeerAuthorization. Pass candidates gathered later with
+ *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`, and
+ *    read the session's later ones with
+ *    `GET …/participants/{participantId}/peer-connections/{peerConnectionId}` until
+ *    `candidates_complete`.
  * 4. Renew the participant with `POST …/participants/{participantId}:renew` well before
  *    `lease_expires_at`, every 15 seconds, presenting the PeerAuthorization of each
  *    PeerConnection; the answer renews them. A participant whose lease runs out ends, and its
@@ -235,7 +238,7 @@
  * revoked. A participant whose creation failed is not announced.
  * OpenAPI spec version: 1.0.0
  */
-import type { AccountList, AccountResource, ApproveEnrollmentRequest, CallMcpToolRequest, CallMcpToolResponse, CreateGroupMemberRequest, CreateGroupRequest, CreateMachineRegistrationRequest, CreateMachineRegistrationResponse, CreateParticipantRequest, CreateParticipantResponse, CreatePeerConnectionCandidatesRequest, CreatePeerConnectionRequest, CreateSessionRequest, DeleteMcpServerParams, DenyPrivilegeRequestRequest, EnrollmentResource, Error, FindEnrollmentByPairingCodeParams, FindEnrollmentResponse, GroupList, GroupResource, ListAccountsParams, ListGroupMembersParams, ListGroupsParams, ListMachineEventsParams, ListMachineRegistrationsParams, ListMachinesParams, ListMcpToolsParams, ListPrivilegeAutoApprovalsParams, ListPrivilegeRequestsParams, ListSessionsParams, MachineEventList, MachineList, MachineRegistrationList, MachineRegistrationResource, MachineResource, McpConfigurationFile, McpConfigurationResource, McpToolList, MigrationStep, ParticipantList, ParticipantResource, PeerConnection, PrivilegeAutoApprovalList, PrivilegeAutoApprovalResource, PrivilegeRequestList, PrivilegeRequestResource, RenewParticipantRequest, RenewParticipantResponse, ReplaceMcpConfigurationRequest, RtcConfiguration, RunCommandRequest, RunCommandResponse, SendMcpRequestRequest, SendMcpRequestResponse, SessionList, SessionResource, UpdateAccountRequest, UpdateGroupRequest, UpdateMachineRequest, UpdateMcpServerRequest, UpdateMcpServerResponse, UpdatePrivilegeAutoApprovalRequest } from "./models.js";
+import type { AccountList, AccountResource, ApproveEnrollmentRequest, CallMcpToolRequest, CallMcpToolResponse, CreateGroupMemberRequest, CreateGroupRequest, CreateMachineRegistrationRequest, CreateMachineRegistrationResponse, CreateParticipantRequest, CreateParticipantResponse, CreatePeerConnectionCandidatesRequest, CreatePeerConnectionRequest, CreateSessionRequest, DeleteMcpServerParams, DenyPrivilegeRequestRequest, EnrollmentResource, Error, FindEnrollmentByPairingCodeParams, FindEnrollmentResponse, GetPeerConnectionParams, GroupList, GroupResource, ListAccountsParams, ListGroupMembersParams, ListGroupsParams, ListMachineEventsParams, ListMachineRegistrationsParams, ListMachinesParams, ListMcpToolsParams, ListPrivilegeAutoApprovalsParams, ListPrivilegeRequestsParams, ListSessionsParams, MachineEventList, MachineList, MachineRegistrationList, MachineRegistrationResource, MachineResource, McpConfigurationFile, McpConfigurationResource, McpToolList, MigrationStep, ParticipantList, ParticipantResource, PeerConnection, PrivilegeAutoApprovalList, PrivilegeAutoApprovalResource, PrivilegeRequestList, PrivilegeRequestResource, RenewParticipantRequest, RenewParticipantResponse, ReplaceMcpConfigurationRequest, RtcConfiguration, RunCommandRequest, RunCommandResponse, SendMcpRequestRequest, SendMcpRequestResponse, SessionList, SessionResource, UpdateAccountRequest, UpdateGroupRequest, UpdateMachineRequest, UpdateMcpServerRequest, UpdateMcpServerResponse, UpdatePrivilegeAutoApprovalRequest } from "./models.js";
 export type HTTPStatusCode1xx = 100 | 101 | 102 | 103;
 export type HTTPStatusCode2xx = 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207;
 export type HTTPStatusCode3xx = 300 | 301 | 302 | 303 | 304 | 305 | 307 | 308;
@@ -1438,7 +1441,8 @@ export declare const getCreateParticipantUrl: (sessionId: string) => string;
  * Admits one participant with the given public key to the session: signs its authorization,
  * has the session accept it, and starts its first PeerConnection with the offer. The answer
  * carries the participant, its authorization and the PeerConnection with the session's
- * answer. The participant lasts while it is renewed.
+ * answer and the ICE candidates the session has passed so far; read its later candidates
+ * with `get-peer-connection`. The participant lasts while it is renewed.
  *
  * Joining again with the public key of one of the caller's participants of the session that
  * has not ended, with the same `client_name`, `read_only` and `permissions`, returns that
@@ -1610,8 +1614,9 @@ export type createPeerConnectionResponse = createPeerConnectionResponseSuccess |
 export declare const getCreatePeerConnectionUrl: (sessionId: string, participantId: number) => string;
 /**
  * Starts another PeerConnection of the participant with the offer, such as after a path
- * failed, and returns the session's answer, its ICE candidates and the signed
- * PeerAuthorization. Move the participant's connection to it with
+ * failed, and returns the session's answer, the ICE candidates it has passed so far and the
+ * signed PeerAuthorization; read its later candidates with `get-peer-connection`. Move the
+ * participant's connection to it with
  * `prepare-participant-migration` and `commit-participant-migration`.
  *
  * Only the participant's user may start one.
@@ -1627,6 +1632,43 @@ export declare const getCreatePeerConnectionUrl: (sessionId: string, participant
  * @summary Start a PeerConnection
  */
 export declare const createPeerConnection: (sessionId: string, participantId: number, createPeerConnectionRequest: CreatePeerConnectionRequest, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<createPeerConnectionResponse>;
+export type getPeerConnectionResponse200 = {
+    data: PeerConnection;
+    status: 200;
+};
+export type getPeerConnectionResponseDefault = {
+    data: Error;
+    status: Exclude<HTTPStatusCodes, 200>;
+};
+export type getPeerConnectionResponseSuccess = getPeerConnectionResponse200 & {
+    headers: Headers;
+};
+export type getPeerConnectionResponseError = getPeerConnectionResponseDefault & {
+    headers: Headers;
+};
+export type getPeerConnectionResponse = getPeerConnectionResponseSuccess | getPeerConnectionResponseError;
+export declare const getGetPeerConnectionUrl: (sessionId: string, participantId: number, peerConnectionId: string, params?: GetPeerConnectionParams) => string;
+/**
+ * Returns the PeerConnection with the ICE candidates the session has passed so far. The
+ * session passes its candidates as it gathers them (RFC 8838), so most arrive after the
+ * PeerConnection started: read it until `candidates_complete`, and add the candidates that
+ * are new since the last read to the PeerConnection. A client keeps those that arrive before
+ * it has set the answer as the remote description, and adds them once it has.
+ *
+ * With `known_candidates`, the request waits until the session has passed more candidates
+ * than that or reported the end of its candidates, for at most 20 seconds, and then returns
+ * the PeerConnection as it is.
+ *
+ * A PeerConnection can be read for 5 minutes after it started. Only the participant's user
+ * may read it.
+ *
+ * Fails with:
+ * - `PARTICIPANT_NOT_FOUND` when the participant has ended;
+ * - `PEER_CONNECTION_NOT_FOUND` when the participant has no such PeerConnection, it was
+ *   abandoned, the session gave it up, or it started more than 5 minutes ago.
+ * @summary Get a PeerConnection
+ */
+export declare const getPeerConnection: (sessionId: string, participantId: number, peerConnectionId: string, params?: GetPeerConnectionParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getPeerConnectionResponse>;
 export type deletePeerConnectionResponse204 = {
     data: void;
     status: 204;

package/dist/fleet/v1/generated/functions.js

@@ -1319,7 +1319,8 @@ export const getCreateParticipantUrl = (sessionId) => {
  * Admits one participant with the given public key to the session: signs its authorization,
  * has the session accept it, and starts its first PeerConnection with the offer. The answer
  * carries the participant, its authorization and the PeerConnection with the session's
- * answer. The participant lasts while it is renewed.
+ * answer and the ICE candidates the session has passed so far; read its later candidates
+ * with `get-peer-connection`. The participant lasts while it is renewed.
  *
  * Joining again with the public key of one of the caller's participants of the session that
  * has not ended, with the same `client_name`, `read_only` and `permissions`, returns that
@@ -1534,8 +1535,9 @@ export const getCreatePeerConnectionUrl = (sessionId, participantId) => {
 };
 /**
  * Starts another PeerConnection of the participant with the offer, such as after a path
- * failed, and returns the session's answer, its ICE candidates and the signed
- * PeerAuthorization. Move the participant's connection to it with
+ * failed, and returns the session's answer, the ICE candidates it has passed so far and the
+ * signed PeerAuthorization; read its later candidates with `get-peer-connection`. Move the
+ * participant's connection to it with
  * `prepare-participant-migration` and `commit-participant-migration`.
  *
  * Only the participant's user may start one.
@@ -1576,6 +1578,47 @@ export const createPeerConnection = async (sessionId, participantId, createPeerC
     const data = body ? JSON.parse(body) : {};
     return { data, status: res.status, headers: res.headers };
 };
+export const getGetPeerConnectionUrl = (sessionId, participantId, peerConnectionId, params) => {
+    const normalizedParams = new URLSearchParams();
+    Object.entries(params || {}).forEach(([key, value]) => {
+        if (value !== undefined) {
+            normalizedParams.append(key, value === null ? "null" : String(value));
+        }
+    });
+    const stringifiedParams = normalizedParams.toString();
+    return stringifiedParams.length > 0
+        ? `https://fleet.leaflow.cloud/api/v1/sessions/${encodeURIComponent(String(sessionId))}/participants/${encodeURIComponent(String(participantId))}/peer-connections/${encodeURIComponent(String(peerConnectionId))}?${stringifiedParams}`
+        : `https://fleet.leaflow.cloud/api/v1/sessions/${encodeURIComponent(String(sessionId))}/participants/${encodeURIComponent(String(participantId))}/peer-connections/${encodeURIComponent(String(peerConnectionId))}`;
+};
+/**
+ * Returns the PeerConnection with the ICE candidates the session has passed so far. The
+ * session passes its candidates as it gathers them (RFC 8838), so most arrive after the
+ * PeerConnection started: read it until `candidates_complete`, and add the candidates that
+ * are new since the last read to the PeerConnection. A client keeps those that arrive before
+ * it has set the answer as the remote description, and adds them once it has.
+ *
+ * With `known_candidates`, the request waits until the session has passed more candidates
+ * than that or reported the end of its candidates, for at most 20 seconds, and then returns
+ * the PeerConnection as it is.
+ *
+ * A PeerConnection can be read for 5 minutes after it started. Only the participant's user
+ * may read it.
+ *
+ * Fails with:
+ * - `PARTICIPANT_NOT_FOUND` when the participant has ended;
+ * - `PEER_CONNECTION_NOT_FOUND` when the participant has no such PeerConnection, it was
+ *   abandoned, the session gave it up, or it started more than 5 minutes ago.
+ * @summary Get a PeerConnection
+ */
+export const getPeerConnection = async (sessionId, participantId, peerConnectionId, params, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getGetPeerConnectionUrl(sessionId, participantId, peerConnectionId, params), {
+        ...options,
+        method: "GET",
+    });
+    const body = [204, 205, 304].includes(res.status) ? null : await res.text();
+    const data = body ? JSON.parse(body) : {};
+    return { data, status: res.status, headers: res.headers };
+};
 export const getDeletePeerConnectionUrl = (sessionId, participantId, peerConnectionId) => {
     return `https://fleet.leaflow.cloud/api/v1/sessions/${encodeURIComponent(String(sessionId))}/participants/${encodeURIComponent(String(participantId))}/peer-connections/${encodeURIComponent(String(peerConnectionId))}`;
 };

package/dist/fleet/v1/generated/models.d.ts

@@ -201,9 +201,12 @@
  *    one second has passed, so that the offer carries them.
  * 3. Join with `POST /api/v1/sessions/{sessionId}/participants`, sending the public key and the
  *    offer. The answer carries the participant's signed authorization, the keys the service
- *    signs with, and the first PeerConnection: the session's SDP answer, its ICE candidates and
- *    the signed PeerAuthorization. Pass candidates gathered later with
- *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`.
+ *    signs with, and the first PeerConnection: the session's SDP answer, the ICE candidates it
+ *    has passed so far and the signed PeerAuthorization. Pass candidates gathered later with
+ *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`, and
+ *    read the session's later ones with
+ *    `GET …/participants/{participantId}/peer-connections/{peerConnectionId}` until
+ *    `candidates_complete`.
  * 4. Renew the participant with `POST …/participants/{participantId}:renew` well before
  *    `lease_expires_at`, every 15 seconds, presenting the PeerAuthorization of each
  *    PeerConnection; the answer renews them. A participant whose lease runs out ends, and its
@@ -1265,13 +1268,13 @@ export interface PeerConnection {
     /** The session's SDP answer (RFC 8866); it holds ICE credentials, so never log it */
     answer: string;
     /**
-     * The session's ICE candidates that arrived until it reported the end of its candidates, or
-     * 500 milliseconds after one candidate of each type its ICE servers yield had arrived
-     * (server reflexive when the RTC configuration has STUN servers and the policy is not
-     * `relay`, relayed when it has TURN servers), and at most until 10 seconds after its
-     * answer. Candidates the session gathers later are not passed on.
+     * The session's ICE candidates passed so far, at most 64, in the order the session sent
+     * them. Later reads return the same ones first.
+     * @maxItems 64
      */
     candidates: IceCandidate[];
+    /** The session reported that it has gathered all its candidates; no more follow */
+    candidates_complete: boolean;
     /** The signed `PeerAuthorization` of the PeerConnection, the same one the session holds */
     authorization: SignedMessage;
 }
@@ -1580,3 +1583,13 @@ export type ListSessionsParams = {
      */
     include_closed?: boolean;
 };
+export type GetPeerConnectionParams = {
+    /**
+     * The number of the session's candidates the caller already has. The request waits until
+     * there are more or the session reported the end of its candidates, for at most 20
+     * seconds. Without it, the request returns at once.
+     * @minimum 0
+     * @maximum 64
+     */
+    known_candidates?: number;
+};

package/dist/fleet/v1/generated/schemas.zod.d.ts

@@ -201,9 +201,12 @@
  *    one second has passed, so that the offer carries them.
  * 3. Join with `POST /api/v1/sessions/{sessionId}/participants`, sending the public key and the
  *    offer. The answer carries the participant's signed authorization, the keys the service
- *    signs with, and the first PeerConnection: the session's SDP answer, its ICE candidates and
- *    the signed PeerAuthorization. Pass candidates gathered later with
- *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`.
+ *    signs with, and the first PeerConnection: the session's SDP answer, the ICE candidates it
+ *    has passed so far and the signed PeerAuthorization. Pass candidates gathered later with
+ *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`, and
+ *    read the session's later ones with
+ *    `GET …/participants/{participantId}/peer-connections/{peerConnectionId}` until
+ *    `candidates_complete`.
  * 4. Renew the participant with `POST …/participants/{participantId}:renew` well before
  *    `lease_expires_at`, every 15 seconds, presenting the PeerAuthorization of each
  *    PeerConnection; the answer renews them. A participant whose lease runs out ends, and its
@@ -960,7 +963,8 @@ export declare const GetSessionRtcConfigurationParams: zod.ZodObject<{
  * Admits one participant with the given public key to the session: signs its authorization,
  * has the session accept it, and starts its first PeerConnection with the offer. The answer
  * carries the participant, its authorization and the PeerConnection with the session's
- * answer. The participant lasts while it is renewed.
+ * answer and the ICE candidates the session has passed so far; read its later candidates
+ * with `get-peer-connection`. The participant lasts while it is renewed.
  *
  * Joining again with the public key of one of the caller's participants of the session that
  * has not ended, with the same `client_name`, `read_only` and `permissions`, returns that
@@ -1105,8 +1109,9 @@ export declare const CommitParticipantMigrationBody: zod.ZodObject<{
 }, zod.z.core.$strict>;
 /**
  * Starts another PeerConnection of the participant with the offer, such as after a path
- * failed, and returns the session's answer, its ICE candidates and the signed
- * PeerAuthorization. Move the participant's connection to it with
+ * failed, and returns the session's answer, the ICE candidates it has passed so far and the
+ * signed PeerAuthorization; read its later candidates with `get-peer-connection`. Move the
+ * participant's connection to it with
  * `prepare-participant-migration` and `commit-participant-migration`.
  *
  * Only the participant's user may start one.
@@ -1130,6 +1135,38 @@ export declare const CreatePeerConnectionParams: zod.ZodObject<{
 export declare const CreatePeerConnectionBody: zod.ZodObject<{
     offer: zod.ZodString;
 }, zod.z.core.$strict>;
+/**
+ * Returns the PeerConnection with the ICE candidates the session has passed so far. The
+ * session passes its candidates as it gathers them (RFC 8838), so most arrive after the
+ * PeerConnection started: read it until `candidates_complete`, and add the candidates that
+ * are new since the last read to the PeerConnection. A client keeps those that arrive before
+ * it has set the answer as the remote description, and adds them once it has.
+ *
+ * With `known_candidates`, the request waits until the session has passed more candidates
+ * than that or reported the end of its candidates, for at most 20 seconds, and then returns
+ * the PeerConnection as it is.
+ *
+ * A PeerConnection can be read for 5 minutes after it started. Only the participant's user
+ * may read it.
+ *
+ * Fails with:
+ * - `PARTICIPANT_NOT_FOUND` when the participant has ended;
+ * - `PEER_CONNECTION_NOT_FOUND` when the participant has no such PeerConnection, it was
+ *   abandoned, the session gave it up, or it started more than 5 minutes ago.
+ * @summary Get a PeerConnection
+ */
+export declare const getPeerConnectionPathSessionIdMax = 40;
+export declare const getPeerConnectionPathSessionIdRegExp: RegExp;
+export declare const GetPeerConnectionParams: zod.ZodObject<{
+    sessionId: zod.ZodString;
+    participantId: zod.ZodInt;
+    peerConnectionId: zod.ZodUUID;
+}, zod.z.core.$strict>;
+export declare const getPeerConnectionQueryKnownCandidatesMin = 0;
+export declare const getPeerConnectionQueryKnownCandidatesMax = 64;
+export declare const GetPeerConnectionQueryParams: zod.ZodObject<{
+    known_candidates: zod.ZodOptional<zod.ZodInt>;
+}, zod.z.core.$strict>;
 /**
  * Tells the session to give up the PeerConnection and close it. Abandoning a PeerConnection
  * that has ended succeeds.

package/dist/fleet/v1/generated/schemas.zod.js

@@ -201,9 +201,12 @@
  *    one second has passed, so that the offer carries them.
  * 3. Join with `POST /api/v1/sessions/{sessionId}/participants`, sending the public key and the
  *    offer. The answer carries the participant's signed authorization, the keys the service
- *    signs with, and the first PeerConnection: the session's SDP answer, its ICE candidates and
- *    the signed PeerAuthorization. Pass candidates gathered later with
- *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`.
+ *    signs with, and the first PeerConnection: the session's SDP answer, the ICE candidates it
+ *    has passed so far and the signed PeerAuthorization. Pass candidates gathered later with
+ *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`, and
+ *    read the session's later ones with
+ *    `GET …/participants/{participantId}/peer-connections/{peerConnectionId}` until
+ *    `candidates_complete`.
  * 4. Renew the participant with `POST …/participants/{participantId}:renew` well before
  *    `lease_expires_at`, every 15 seconds, presenting the PeerAuthorization of each
  *    PeerConnection; the answer renews them. A participant whose lease runs out ends, and its
@@ -1069,7 +1072,8 @@ export const GetSessionRtcConfigurationParams = zod.strictObject({
  * Admits one participant with the given public key to the session: signs its authorization,
  * has the session accept it, and starts its first PeerConnection with the offer. The answer
  * carries the participant, its authorization and the PeerConnection with the session's
- * answer. The participant lasts while it is renewed.
+ * answer and the ICE candidates the session has passed so far; read its later candidates
+ * with `get-peer-connection`. The participant lasts while it is renewed.
  *
  * Joining again with the public key of one of the caller's participants of the session that
  * has not ended, with the same `client_name`, `read_only` and `permissions`, returns that
@@ -1208,8 +1212,9 @@ export const CommitParticipantMigrationParams = zod.strictObject({
 export const CommitParticipantMigrationBody = MigrationStep;
 /**
  * Starts another PeerConnection of the participant with the offer, such as after a path
- * failed, and returns the session's answer, its ICE candidates and the signed
- * PeerAuthorization. Move the participant's connection to it with
+ * failed, and returns the session's answer, the ICE candidates it has passed so far and the
+ * signed PeerAuthorization; read its later candidates with `get-peer-connection`. Move the
+ * participant's connection to it with
  * `prepare-participant-migration` and `commit-participant-migration`.
  *
  * Only the participant's user may start one.
@@ -1235,6 +1240,47 @@ export const CreatePeerConnectionParams = zod.strictObject({
     participantId: zod.int().min(1),
 });
 export const CreatePeerConnectionBody = CreatePeerConnectionRequest;
+/**
+ * Returns the PeerConnection with the ICE candidates the session has passed so far. The
+ * session passes its candidates as it gathers them (RFC 8838), so most arrive after the
+ * PeerConnection started: read it until `candidates_complete`, and add the candidates that
+ * are new since the last read to the PeerConnection. A client keeps those that arrive before
+ * it has set the answer as the remote description, and adds them once it has.
+ *
+ * With `known_candidates`, the request waits until the session has passed more candidates
+ * than that or reported the end of its candidates, for at most 20 seconds, and then returns
+ * the PeerConnection as it is.
+ *
+ * A PeerConnection can be read for 5 minutes after it started. Only the participant's user
+ * may read it.
+ *
+ * Fails with:
+ * - `PARTICIPANT_NOT_FOUND` when the participant has ended;
+ * - `PEER_CONNECTION_NOT_FOUND` when the participant has no such PeerConnection, it was
+ *   abandoned, the session gave it up, or it started more than 5 minutes ago.
+ * @summary Get a PeerConnection
+ */
+export const getPeerConnectionPathSessionIdMax = 40;
+export const getPeerConnectionPathSessionIdRegExp = new RegExp("^[a-z0-9-]+$");
+export const GetPeerConnectionParams = zod.strictObject({
+    sessionId: zod
+        .string()
+        .min(1)
+        .max(getPeerConnectionPathSessionIdMax)
+        .regex(getPeerConnectionPathSessionIdRegExp),
+    participantId: zod.int().min(1),
+    peerConnectionId: zod.uuid(),
+});
+export const getPeerConnectionQueryKnownCandidatesMin = 0;
+export const getPeerConnectionQueryKnownCandidatesMax = 64;
+export const GetPeerConnectionQueryParams = zod.strictObject({
+    known_candidates: zod
+        .int()
+        .min(getPeerConnectionQueryKnownCandidatesMin)
+        .max(getPeerConnectionQueryKnownCandidatesMax)
+        .optional()
+        .describe("The number of the session's candidates the caller already has. The request waits until\nthere are more or the session reported the end of its candidates, for at most 20\nseconds. Without it, the request returns at once."),
+});
 /**
  * Tells the session to give up the PeerConnection and close it. Abandoning a PeerConnection
  * that has ended succeeds.

package/dist/fleet/v1/generated/validators/accountList.zod.d.ts

@@ -201,9 +201,12 @@
  *    one second has passed, so that the offer carries them.
  * 3. Join with `POST /api/v1/sessions/{sessionId}/participants`, sending the public key and the
  *    offer. The answer carries the participant's signed authorization, the keys the service
- *    signs with, and the first PeerConnection: the session's SDP answer, its ICE candidates and
- *    the signed PeerAuthorization. Pass candidates gathered later with
- *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`.
+ *    signs with, and the first PeerConnection: the session's SDP answer, the ICE candidates it
+ *    has passed so far and the signed PeerAuthorization. Pass candidates gathered later with
+ *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`, and
+ *    read the session's later ones with
+ *    `GET …/participants/{participantId}/peer-connections/{peerConnectionId}` until
+ *    `candidates_complete`.
  * 4. Renew the participant with `POST …/participants/{participantId}:renew` well before
  *    `lease_expires_at`, every 15 seconds, presenting the PeerAuthorization of each
  *    PeerConnection; the answer renews them. A participant whose lease runs out ends, and its

package/dist/fleet/v1/generated/validators/accountList.zod.js

@@ -201,9 +201,12 @@
  *    one second has passed, so that the offer carries them.
  * 3. Join with `POST /api/v1/sessions/{sessionId}/participants`, sending the public key and the
  *    offer. The answer carries the participant's signed authorization, the keys the service
- *    signs with, and the first PeerConnection: the session's SDP answer, its ICE candidates and
- *    the signed PeerAuthorization. Pass candidates gathered later with
- *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`.
+ *    signs with, and the first PeerConnection: the session's SDP answer, the ICE candidates it
+ *    has passed so far and the signed PeerAuthorization. Pass candidates gathered later with
+ *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`, and
+ *    read the session's later ones with
+ *    `GET …/participants/{participantId}/peer-connections/{peerConnectionId}` until
+ *    `candidates_complete`.
  * 4. Renew the participant with `POST …/participants/{participantId}:renew` well before
  *    `lease_expires_at`, every 15 seconds, presenting the PeerAuthorization of each
  *    PeerConnection; the answer renews them. A participant whose lease runs out ends, and its

package/dist/fleet/v1/generated/validators/accountResource.zod.d.ts

@@ -201,9 +201,12 @@
  *    one second has passed, so that the offer carries them.
  * 3. Join with `POST /api/v1/sessions/{sessionId}/participants`, sending the public key and the
  *    offer. The answer carries the participant's signed authorization, the keys the service
- *    signs with, and the first PeerConnection: the session's SDP answer, its ICE candidates and
- *    the signed PeerAuthorization. Pass candidates gathered later with
- *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`.
+ *    signs with, and the first PeerConnection: the session's SDP answer, the ICE candidates it
+ *    has passed so far and the signed PeerAuthorization. Pass candidates gathered later with
+ *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`, and
+ *    read the session's later ones with
+ *    `GET …/participants/{participantId}/peer-connections/{peerConnectionId}` until
+ *    `candidates_complete`.
  * 4. Renew the participant with `POST …/participants/{participantId}:renew` well before
  *    `lease_expires_at`, every 15 seconds, presenting the PeerAuthorization of each
  *    PeerConnection; the answer renews them. A participant whose lease runs out ends, and its

package/dist/fleet/v1/generated/validators/accountResource.zod.js

@@ -201,9 +201,12 @@
  *    one second has passed, so that the offer carries them.
  * 3. Join with `POST /api/v1/sessions/{sessionId}/participants`, sending the public key and the
  *    offer. The answer carries the participant's signed authorization, the keys the service
- *    signs with, and the first PeerConnection: the session's SDP answer, its ICE candidates and
- *    the signed PeerAuthorization. Pass candidates gathered later with
- *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`.
+ *    signs with, and the first PeerConnection: the session's SDP answer, the ICE candidates it
+ *    has passed so far and the signed PeerAuthorization. Pass candidates gathered later with
+ *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`, and
+ *    read the session's later ones with
+ *    `GET …/participants/{participantId}/peer-connections/{peerConnectionId}` until
+ *    `candidates_complete`.
  * 4. Renew the participant with `POST …/participants/{participantId}:renew` well before
  *    `lease_expires_at`, every 15 seconds, presenting the PeerAuthorization of each
  *    PeerConnection; the answer renews them. A participant whose lease runs out ends, and its

package/dist/fleet/v1/generated/validators/approveEnrollmentRequest.zod.d.ts

@@ -201,9 +201,12 @@
  *    one second has passed, so that the offer carries them.
  * 3. Join with `POST /api/v1/sessions/{sessionId}/participants`, sending the public key and the
  *    offer. The answer carries the participant's signed authorization, the keys the service
- *    signs with, and the first PeerConnection: the session's SDP answer, its ICE candidates and
- *    the signed PeerAuthorization. Pass candidates gathered later with
- *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`.
+ *    signs with, and the first PeerConnection: the session's SDP answer, the ICE candidates it
+ *    has passed so far and the signed PeerAuthorization. Pass candidates gathered later with
+ *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`, and
+ *    read the session's later ones with
+ *    `GET …/participants/{participantId}/peer-connections/{peerConnectionId}` until
+ *    `candidates_complete`.
  * 4. Renew the participant with `POST …/participants/{participantId}:renew` well before
  *    `lease_expires_at`, every 15 seconds, presenting the PeerAuthorization of each
  *    PeerConnection; the answer renews them. A participant whose lease runs out ends, and its

package/dist/fleet/v1/generated/validators/approveEnrollmentRequest.zod.js

@@ -201,9 +201,12 @@
  *    one second has passed, so that the offer carries them.
  * 3. Join with `POST /api/v1/sessions/{sessionId}/participants`, sending the public key and the
  *    offer. The answer carries the participant's signed authorization, the keys the service
- *    signs with, and the first PeerConnection: the session's SDP answer, its ICE candidates and
- *    the signed PeerAuthorization. Pass candidates gathered later with
- *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`.
+ *    signs with, and the first PeerConnection: the session's SDP answer, the ICE candidates it
+ *    has passed so far and the signed PeerAuthorization. Pass candidates gathered later with
+ *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`, and
+ *    read the session's later ones with
+ *    `GET …/participants/{participantId}/peer-connections/{peerConnectionId}` until
+ *    `candidates_complete`.
  * 4. Renew the participant with `POST …/participants/{participantId}:renew` well before
  *    `lease_expires_at`, every 15 seconds, presenting the PeerAuthorization of each
  *    PeerConnection; the answer renews them. A participant whose lease runs out ends, and its

package/dist/fleet/v1/generated/validators/callMcpToolRequest.zod.d.ts

@@ -201,9 +201,12 @@
  *    one second has passed, so that the offer carries them.
  * 3. Join with `POST /api/v1/sessions/{sessionId}/participants`, sending the public key and the
  *    offer. The answer carries the participant's signed authorization, the keys the service
- *    signs with, and the first PeerConnection: the session's SDP answer, its ICE candidates and
- *    the signed PeerAuthorization. Pass candidates gathered later with
- *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`.
+ *    signs with, and the first PeerConnection: the session's SDP answer, the ICE candidates it
+ *    has passed so far and the signed PeerAuthorization. Pass candidates gathered later with
+ *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`, and
+ *    read the session's later ones with
+ *    `GET …/participants/{participantId}/peer-connections/{peerConnectionId}` until
+ *    `candidates_complete`.
  * 4. Renew the participant with `POST …/participants/{participantId}:renew` well before
  *    `lease_expires_at`, every 15 seconds, presenting the PeerAuthorization of each
  *    PeerConnection; the answer renews them. A participant whose lease runs out ends, and its

package/dist/fleet/v1/generated/validators/callMcpToolRequest.zod.js

@@ -201,9 +201,12 @@
  *    one second has passed, so that the offer carries them.
  * 3. Join with `POST /api/v1/sessions/{sessionId}/participants`, sending the public key and the
  *    offer. The answer carries the participant's signed authorization, the keys the service
- *    signs with, and the first PeerConnection: the session's SDP answer, its ICE candidates and
- *    the signed PeerAuthorization. Pass candidates gathered later with
- *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`.
+ *    signs with, and the first PeerConnection: the session's SDP answer, the ICE candidates it
+ *    has passed so far and the signed PeerAuthorization. Pass candidates gathered later with
+ *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`, and
+ *    read the session's later ones with
+ *    `GET …/participants/{participantId}/peer-connections/{peerConnectionId}` until
+ *    `candidates_complete`.
  * 4. Renew the participant with `POST …/participants/{participantId}:renew` well before
  *    `lease_expires_at`, every 15 seconds, presenting the PeerAuthorization of each
  *    PeerConnection; the answer renews them. A participant whose lease runs out ends, and its

package/dist/fleet/v1/generated/validators/callMcpToolResponse.zod.d.ts

@@ -201,9 +201,12 @@
  *    one second has passed, so that the offer carries them.
  * 3. Join with `POST /api/v1/sessions/{sessionId}/participants`, sending the public key and the
  *    offer. The answer carries the participant's signed authorization, the keys the service
- *    signs with, and the first PeerConnection: the session's SDP answer, its ICE candidates and
- *    the signed PeerAuthorization. Pass candidates gathered later with
- *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`.
+ *    signs with, and the first PeerConnection: the session's SDP answer, the ICE candidates it
+ *    has passed so far and the signed PeerAuthorization. Pass candidates gathered later with
+ *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`, and
+ *    read the session's later ones with
+ *    `GET …/participants/{participantId}/peer-connections/{peerConnectionId}` until
+ *    `candidates_complete`.
  * 4. Renew the participant with `POST …/participants/{participantId}:renew` well before
  *    `lease_expires_at`, every 15 seconds, presenting the PeerAuthorization of each
  *    PeerConnection; the answer renews them. A participant whose lease runs out ends, and its

package/dist/fleet/v1/generated/validators/callMcpToolResponse.zod.js

@@ -201,9 +201,12 @@
  *    one second has passed, so that the offer carries them.
  * 3. Join with `POST /api/v1/sessions/{sessionId}/participants`, sending the public key and the
  *    offer. The answer carries the participant's signed authorization, the keys the service
- *    signs with, and the first PeerConnection: the session's SDP answer, its ICE candidates and
- *    the signed PeerAuthorization. Pass candidates gathered later with
- *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`.
+ *    signs with, and the first PeerConnection: the session's SDP answer, the ICE candidates it
+ *    has passed so far and the signed PeerAuthorization. Pass candidates gathered later with
+ *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`, and
+ *    read the session's later ones with
+ *    `GET …/participants/{participantId}/peer-connections/{peerConnectionId}` until
+ *    `candidates_complete`.
  * 4. Renew the participant with `POST …/participants/{participantId}:renew` well before
  *    `lease_expires_at`, every 15 seconds, presenting the PeerAuthorization of each
  *    PeerConnection; the answer renews them. A participant whose lease runs out ends, and its

package/dist/fleet/v1/generated/validators/createGroupMemberRequest.zod.d.ts

@@ -201,9 +201,12 @@
  *    one second has passed, so that the offer carries them.
  * 3. Join with `POST /api/v1/sessions/{sessionId}/participants`, sending the public key and the
  *    offer. The answer carries the participant's signed authorization, the keys the service
- *    signs with, and the first PeerConnection: the session's SDP answer, its ICE candidates and
- *    the signed PeerAuthorization. Pass candidates gathered later with
- *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`.
+ *    signs with, and the first PeerConnection: the session's SDP answer, the ICE candidates it
+ *    has passed so far and the signed PeerAuthorization. Pass candidates gathered later with
+ *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`, and
+ *    read the session's later ones with
+ *    `GET …/participants/{participantId}/peer-connections/{peerConnectionId}` until
+ *    `candidates_complete`.
  * 4. Renew the participant with `POST …/participants/{participantId}:renew` well before
  *    `lease_expires_at`, every 15 seconds, presenting the PeerAuthorization of each
  *    PeerConnection; the answer renews them. A participant whose lease runs out ends, and its

package/dist/fleet/v1/generated/validators/createGroupMemberRequest.zod.js

@@ -201,9 +201,12 @@
  *    one second has passed, so that the offer carries them.
  * 3. Join with `POST /api/v1/sessions/{sessionId}/participants`, sending the public key and the
  *    offer. The answer carries the participant's signed authorization, the keys the service
- *    signs with, and the first PeerConnection: the session's SDP answer, its ICE candidates and
- *    the signed PeerAuthorization. Pass candidates gathered later with
- *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`.
+ *    signs with, and the first PeerConnection: the session's SDP answer, the ICE candidates it
+ *    has passed so far and the signed PeerAuthorization. Pass candidates gathered later with
+ *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`, and
+ *    read the session's later ones with
+ *    `GET …/participants/{participantId}/peer-connections/{peerConnectionId}` until
+ *    `candidates_complete`.
  * 4. Renew the participant with `POST …/participants/{participantId}:renew` well before
  *    `lease_expires_at`, every 15 seconds, presenting the PeerAuthorization of each
  *    PeerConnection; the answer renews them. A participant whose lease runs out ends, and its

package/dist/fleet/v1/generated/validators/createGroupRequest.zod.d.ts

@@ -201,9 +201,12 @@
  *    one second has passed, so that the offer carries them.
  * 3. Join with `POST /api/v1/sessions/{sessionId}/participants`, sending the public key and the
  *    offer. The answer carries the participant's signed authorization, the keys the service
- *    signs with, and the first PeerConnection: the session's SDP answer, its ICE candidates and
- *    the signed PeerAuthorization. Pass candidates gathered later with
- *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`.
+ *    signs with, and the first PeerConnection: the session's SDP answer, the ICE candidates it
+ *    has passed so far and the signed PeerAuthorization. Pass candidates gathered later with
+ *    `POST …/participants/{participantId}/peer-connections/{peerConnectionId}/candidates`, and
+ *    read the session's later ones with
+ *    `GET …/participants/{participantId}/peer-connections/{peerConnectionId}` until
+ *    `candidates_complete`.
  * 4. Renew the participant with `POST …/participants/{participantId}:renew` well before
  *    `lease_expires_at`, every 15 seconds, presenting the PeerAuthorization of each
  *    PeerConnection; the answer renews them. A participant whose lease runs out ends, and its