@cdot65/prisma-airs-sdk 0.6.4 → 0.6.6

package/dist/index.js

@@ -29,7 +29,7 @@ var MAX_NUMBER_OF_BATCH_SCAN_OBJECTS = 5;
 var MAX_CONNECTION_POOL_SIZE = 100;
 var MAX_NUMBER_OF_RETRIES = 5;
 var HTTP_FORCE_RETRY_STATUS_CODES = [500, 502, 503, 504];
-var SDK_VERSION = "0.6.4";
+var SDK_VERSION = "0.6.6";
 var USER_AGENT = `PAN-AIRS/${SDK_VERSION}-typescript-sdk`;
 var DEFAULT_MGMT_ENDPOINT = "https://api.sase.paloaltonetworks.com/aisec";
 var DEFAULT_TOKEN_ENDPOINT = "https://auth.apps.paloaltonetworks.com/oauth2/access_token";
@@ -194,7 +194,8 @@ function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 function backoffDelay(attempt) {
-  return Math.pow(2, attempt) * 1e3;
+  const maxDelay = Math.pow(2, attempt) * 1e3;
+  return Math.floor(Math.random() * (maxDelay + 1));
 }
 function isRetryableStatus(status) {
   return HTTP_FORCE_RETRY_STATUS_CODES.includes(status);
@@ -257,6 +258,11 @@ var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 function isValidUuid(value) {
   return UUID_RE.test(value);
 }
+function validateJobId(jobId) {
+  if (!isValidUuid(jobId)) {
+    throw new AISecSDKException(`Invalid job id: ${jobId}`, "AISEC_USER_REQUEST_PAYLOAD_ERROR" /* USER_REQUEST_PAYLOAD_ERROR */);
+  }
+}
 function generatePayloadHash(payload, secret) {
   return createHmac("sha256", secret).update(payload).digest("hex");
 }
@@ -522,7 +528,10 @@ var Content = class _Content {
   set toolEvent(value) {
     this._toolEvent = value;
   }
-  /** Total byte length of all text content fields. */
+  /**
+   * Total byte length of all text content fields.
+   * @returns Combined byte length of all text content fields.
+   */
   get length() {
     let total = 0;
     if (this._prompt) total += Buffer.byteLength(this._prompt);
@@ -532,7 +541,10 @@ var Content = class _Content {
     if (this._codeResponse) total += Buffer.byteLength(this._codeResponse);
     return total;
   }
-  /** Serialize to the API request format. */
+  /**
+   * Serialize to the API request format.
+   * @returns The content as a scan request contents inner object.
+   */
   toJSON() {
     const obj = {};
     if (this._prompt !== void 0) obj.prompt = this._prompt;
@@ -560,6 +572,7 @@ var Content = class _Content {
   /**
    * Load content from a JSON file.
    * @param filePath - Path to JSON file containing scan request contents.
+   * @returns A new Content instance populated from the JSON file.
    */
   static fromJSONFile(filePath) {
     const raw = readFileSync(filePath, "utf-8");
@@ -912,7 +925,7 @@ var ErrorResponseSchema = z15.object({
   retry_after: z15.object({
     interval: z15.number().optional(),
     unit: z15.string().optional()
-  }).optional()
+  }).passthrough().optional()
 }).passthrough();
 
 // src/models/mgmt-security-profile.ts
@@ -1076,12 +1089,12 @@ var ApiKeyCreateRequestSchema = z18.object({
   api_key_name: z18.string(),
   rotation_time_interval: z18.number(),
   rotation_time_unit: z18.string()
-});
+}).passthrough();
 var ApiKeyRegenerateRequestSchema = z18.object({
   rotation_time_interval: z18.number(),
   rotation_time_unit: z18.string(),
   updated_by: z18.string().optional()
-});
+}).passthrough();
 var ApiKeyListResponseSchema = z18.object({
   api_keys: z18.array(ApiKeySchema).optional(),
   next_offset: z18.number().optional()
@@ -1250,7 +1263,7 @@ import { z as z23 } from "zod";
 var ClientIdAndCustomerAppSchema = z23.object({
   client_id: z23.string(),
   customer_app: z23.string()
-});
+}).passthrough();
 var Oauth2TokenSchema = z23.object({
   token_type: z23.string().optional(),
   issued_at: z23.string().optional(),
@@ -2744,12 +2757,17 @@ var OAuthClient = class {
     });
     return this.pendingFetch;
   }
-  /** Clear the cached token, forcing a fresh fetch on next call. */
+  /**
+   * Clear the cached token, forcing a fresh fetch on next call.
+   */
   clearToken() {
     this.accessToken = null;
     this.expiresAt = 0;
   }
-  /** Check if the current token has passed its expiry time. Returns true if no token exists. */
+  /**
+   * Check if the current token has passed its expiry time. Returns true if no token exists.
+   * @returns Whether the token is expired.
+   */
   isTokenExpired() {
     if (!this.accessToken) return true;
     return Date.now() >= this.expiresAt;
@@ -2758,6 +2776,7 @@ var OAuthClient = class {
    * Check if the token is within the pre-expiry buffer window.
    * Returns true if no token exists.
    * @param bufferMs - Custom buffer in ms. Defaults to the configured `tokenBufferMs`.
+   * @returns Whether the token is expiring soon.
    */
   isTokenExpiringSoon(bufferMs) {
     if (!this.accessToken) return true;
@@ -3086,7 +3105,7 @@ var TopicsClient = class {
   /**
    * Force-delete a custom topic, removing it from any referencing profiles.
    * @param topicId - UUID of the topic to force-delete.
-   * @param updatedBy - Email of the user performing the deletion.
+   * @param updatedBy - Optional. Email of the user performing the deletion.
    * @returns Deletion confirmation message.
    */
   async forceDelete(topicId, updatedBy) {
@@ -3953,6 +3972,7 @@ var ModelSecurityGroupsClient = class {
   /**
    * Delete a security group.
    * @param uuid - Security group UUID.
+   * @returns Resolves when the security group is deleted.
    */
   async delete(uuid) {
     if (!isValidUuid(uuid)) {
@@ -4189,14 +4209,16 @@ var ModelSecurityClient = class {
   }
 };
 
-// src/red-team/scans-client.ts
-function buildListParams(opts) {
+// src/red-team/list-params.ts
+function buildRedTeamListParams(opts) {
   const params = {};
   if (opts?.skip !== void 0) params.skip = String(opts.skip);
   if (opts?.limit !== void 0) params.limit = String(opts.limit);
   if (opts?.search !== void 0) params.search = opts.search;
   return params;
 }
+
+// src/red-team/scans-client.ts
 var RedTeamScansClient = class {
   baseUrl;
   oauthClient;
@@ -4222,9 +4244,13 @@ var RedTeamScansClient = class {
     });
     return res.data;
   }
-  /** List red team scan jobs with optional filters. */
+  /**
+   * List red team scan jobs with optional filters.
+   * @param opts - Optional pagination, search, and filter options.
+   * @returns The paginated list of scan jobs.
+   */
   async list(opts) {
-    const params = buildListParams(opts);
+    const params = buildRedTeamListParams(opts);
     if (opts?.status !== void 0) params.status = opts.status;
     if (opts?.job_type !== void 0) params.job_type = opts.job_type;
     if (opts?.target_id !== void 0) params.target_id = opts.target_id;
@@ -4238,7 +4264,11 @@ var RedTeamScansClient = class {
     });
     return res.data;
   }
-  /** Get a single scan job by ID. */
+  /**
+   * Get a single scan job by ID.
+   * @param jobId - The job UUID.
+   * @returns The job response.
+   */
   async get(jobId) {
     if (!isValidUuid(jobId)) {
       throw new AISecSDKException(`Invalid job id: ${jobId}`, "AISEC_USER_REQUEST_PAYLOAD_ERROR" /* USER_REQUEST_PAYLOAD_ERROR */);
@@ -4252,7 +4282,11 @@ var RedTeamScansClient = class {
     });
     return res.data;
   }
-  /** Abort a running scan job. */
+  /**
+   * Abort a running scan job.
+   * @param jobId - The job UUID.
+   * @returns The abort response.
+   */
   async abort(jobId) {
     if (!isValidUuid(jobId)) {
       throw new AISecSDKException(`Invalid job id: ${jobId}`, "AISEC_USER_REQUEST_PAYLOAD_ERROR" /* USER_REQUEST_PAYLOAD_ERROR */);
@@ -4266,7 +4300,10 @@ var RedTeamScansClient = class {
     });
     return res.data;
   }
-  /** Get all categories with subcategories. */
+  /**
+   * Get all categories with subcategories.
+   * @returns The list of category models.
+   */
   async getCategories() {
     const res = await managementHttpRequest({
       method: "GET",
@@ -4280,18 +4317,6 @@ var RedTeamScansClient = class {
 };
 
 // src/red-team/reports-client.ts
-function buildListParams2(opts) {
-  const params = {};
-  if (opts?.skip !== void 0) params.skip = String(opts.skip);
-  if (opts?.limit !== void 0) params.limit = String(opts.limit);
-  if (opts?.search !== void 0) params.search = opts.search;
-  return params;
-}
-function validateJobId(jobId) {
-  if (!isValidUuid(jobId)) {
-    throw new AISecSDKException(`Invalid job id: ${jobId}`, "AISEC_USER_REQUEST_PAYLOAD_ERROR" /* USER_REQUEST_PAYLOAD_ERROR */);
-  }
-}
 var RedTeamReportsClient = class {
   baseUrl;
   oauthClient;
@@ -4304,10 +4329,15 @@ var RedTeamReportsClient = class {
   // -----------------------------------------------------------------------
   // Static (attack library) report endpoints
   // -----------------------------------------------------------------------
-  /** List attacks for a static scan. */
+  /**
+   * List attacks for a static scan.
+   * @param jobId - The job UUID.
+   * @param opts - Optional pagination, search, and filter options.
+   * @returns The paginated list of attacks.
+   */
   async listAttacks(jobId, opts) {
     validateJobId(jobId);
-    const params = buildListParams2(opts);
+    const params = buildRedTeamListParams(opts);
     if (opts?.status !== void 0) params.status = opts.status;
     if (opts?.severity !== void 0) params.severity = opts.severity;
     if (opts?.category !== void 0) params.category = opts.category;
@@ -4324,7 +4354,12 @@ var RedTeamReportsClient = class {
     });
     return res.data;
   }
-  /** Get attack details for a static scan. */
+  /**
+   * Get attack details for a static scan.
+   * @param jobId - The job UUID.
+   * @param attackId - The attack UUID.
+   * @returns The attack detail response.
+   */
   async getAttackDetail(jobId, attackId) {
     validateJobId(jobId);
     if (!isValidUuid(attackId)) {
@@ -4342,7 +4377,12 @@ var RedTeamReportsClient = class {
     });
     return res.data;
   }
-  /** Get multi-turn attack details for a static scan. */
+  /**
+   * Get multi-turn attack details for a static scan.
+   * @param jobId - The job UUID.
+   * @param attackId - The attack UUID.
+   * @returns The multi-turn attack detail response.
+   */
   async getMultiTurnAttackDetail(jobId, attackId) {
     validateJobId(jobId);
     if (!isValidUuid(attackId)) {
@@ -4360,7 +4400,11 @@ var RedTeamReportsClient = class {
     });
     return res.data;
   }
-  /** Get the attack library report for a static scan. */
+  /**
+   * Get the attack library report for a static scan.
+   * @param jobId - The job UUID.
+   * @returns The static job report.
+   */
   async getStaticReport(jobId) {
     validateJobId(jobId);
     const res = await managementHttpRequest({
@@ -4372,7 +4416,11 @@ var RedTeamReportsClient = class {
     });
     return res.data;
   }
-  /** Get remediation recommendations for a static scan. */
+  /**
+   * Get remediation recommendations for a static scan.
+   * @param jobId - The job UUID.
+   * @returns The remediation response.
+   */
   async getStaticRemediation(jobId) {
     validateJobId(jobId);
     const res = await managementHttpRequest({
@@ -4384,7 +4432,11 @@ var RedTeamReportsClient = class {
     });
     return res.data;
   }
-  /** Get runtime security profile config for a static scan. */
+  /**
+   * Get runtime security profile config for a static scan.
+   * @param jobId - The job UUID.
+   * @returns The runtime security profile response.
+   */
   async getStaticRuntimePolicy(jobId) {
     validateJobId(jobId);
     const res = await managementHttpRequest({
@@ -4399,7 +4451,11 @@ var RedTeamReportsClient = class {
   // -----------------------------------------------------------------------
   // Dynamic (agent) report endpoints
   // -----------------------------------------------------------------------
-  /** Get the agent scan report for a dynamic scan. */
+  /**
+   * Get the agent scan report for a dynamic scan.
+   * @param jobId - The job UUID.
+   * @returns The dynamic job report.
+   */
   async getDynamicReport(jobId) {
     validateJobId(jobId);
     const res = await managementHttpRequest({
@@ -4411,7 +4467,11 @@ var RedTeamReportsClient = class {
     });
     return res.data;
   }
-  /** Get remediation recommendations for a dynamic scan. */
+  /**
+   * Get remediation recommendations for a dynamic scan.
+   * @param jobId - The job UUID.
+   * @returns The remediation response.
+   */
   async getDynamicRemediation(jobId) {
     validateJobId(jobId);
     const res = await managementHttpRequest({
@@ -4423,7 +4483,11 @@ var RedTeamReportsClient = class {
     });
     return res.data;
   }
-  /** Get runtime security profile config for a dynamic scan. */
+  /**
+   * Get runtime security profile config for a dynamic scan.
+   * @param jobId - The job UUID.
+   * @returns The runtime security profile response.
+   */
   async getDynamicRuntimePolicy(jobId) {
     validateJobId(jobId);
     const res = await managementHttpRequest({
@@ -4435,10 +4499,15 @@ var RedTeamReportsClient = class {
     });
     return res.data;
   }
-  /** List goals for a dynamic scan. */
+  /**
+   * List goals for a dynamic scan.
+   * @param jobId - The job UUID.
+   * @param opts - Optional pagination, search, and filter options.
+   * @returns The paginated list of goals.
+   */
   async listGoals(jobId, opts) {
     validateJobId(jobId);
-    const params = buildListParams2(opts);
+    const params = buildRedTeamListParams(opts);
     if (opts?.goal_type !== void 0) params.goal_type = opts.goal_type;
     if (opts?.status !== void 0) params.status = opts.status;
     if (opts?.count !== void 0) params.count = String(opts.count);
@@ -4452,7 +4521,13 @@ var RedTeamReportsClient = class {
     });
     return res.data;
   }
-  /** List streams for a goal in a dynamic scan. */
+  /**
+   * List streams for a goal in a dynamic scan.
+   * @param jobId - The job UUID.
+   * @param goalId - The goal UUID.
+   * @param opts - Optional pagination and search options.
+   * @returns The paginated list of streams.
+   */
   async listGoalStreams(jobId, goalId, opts) {
     validateJobId(jobId);
     if (!isValidUuid(goalId)) {
@@ -4465,7 +4540,7 @@ var RedTeamReportsClient = class {
       method: "GET",
       baseUrl: this.baseUrl,
       path: `${RED_TEAM_REPORT_DYNAMIC_PATH}/${jobId}/goal/${goalId}/list-streams`,
-      params: buildListParams2(opts),
+      params: buildRedTeamListParams(opts),
       oauthClient: this.oauthClient,
       numRetries: this.numRetries
     });
@@ -4474,7 +4549,11 @@ var RedTeamReportsClient = class {
   // -----------------------------------------------------------------------
   // Common report endpoints
   // -----------------------------------------------------------------------
-  /** Get stream details by stream ID. */
+  /**
+   * Get stream details by stream ID.
+   * @param streamId - The stream UUID.
+   * @returns The stream detail response.
+   */
   async getStreamDetail(streamId) {
     if (!isValidUuid(streamId)) {
       throw new AISecSDKException(
@@ -4491,7 +4570,12 @@ var RedTeamReportsClient = class {
     });
     return res.data;
   }
-  /** Download a report in the specified format. */
+  /**
+   * Download a report in the specified format.
+   * @param jobId - The job UUID.
+   * @param format - The file format (e.g. "pdf", "csv").
+   * @returns The report data in the requested format (untyped — shape depends on `format`).
+   */
   async downloadReport(jobId, format) {
     validateJobId(jobId);
     const params = { file_format: format };
@@ -4505,7 +4589,11 @@ var RedTeamReportsClient = class {
     });
     return res.data;
   }
-  /** Generate a partial report for a running scan. */
+  /**
+   * Generate a partial report for a running scan.
+   * @param jobId - The job UUID.
+   * @returns The partial report payload (untyped — schema not yet defined by the API).
+   */
   async generatePartialReport(jobId) {
     validateJobId(jobId);
     const res = await managementHttpRequest({
@@ -4520,18 +4608,6 @@ var RedTeamReportsClient = class {
 };
 
 // src/red-team/custom-attack-reports-client.ts
-function buildListParams3(opts) {
-  const params = {};
-  if (opts?.skip !== void 0) params.skip = String(opts.skip);
-  if (opts?.limit !== void 0) params.limit = String(opts.limit);
-  if (opts?.search !== void 0) params.search = opts.search;
-  return params;
-}
-function validateJobId2(jobId) {
-  if (!isValidUuid(jobId)) {
-    throw new AISecSDKException(`Invalid job id: ${jobId}`, "AISEC_USER_REQUEST_PAYLOAD_ERROR" /* USER_REQUEST_PAYLOAD_ERROR */);
-  }
-}
 var RedTeamCustomAttackReportsClient = class {
   baseUrl;
   oauthClient;
@@ -4541,9 +4617,13 @@ var RedTeamCustomAttackReportsClient = class {
     this.oauthClient = opts.oauthClient;
     this.numRetries = opts.numRetries;
   }
-  /** Get custom attack report for a scan. */
+  /**
+   * Get custom attack report for a scan.
+   * @param jobId - The job UUID.
+   * @returns The custom attack report response.
+   */
   async getReport(jobId) {
-    validateJobId2(jobId);
+    validateJobId(jobId);
     const res = await managementHttpRequest({
       method: "GET",
       baseUrl: this.baseUrl,
@@ -4553,9 +4633,13 @@ var RedTeamCustomAttackReportsClient = class {
     });
     return res.data;
   }
-  /** Get prompt sets for a custom attack scan. */
+  /**
+   * Get prompt sets for a custom attack scan.
+   * @param jobId - The job UUID.
+   * @returns The prompt sets report response.
+   */
   async getPromptSets(jobId) {
-    validateJobId2(jobId);
+    validateJobId(jobId);
     const res = await managementHttpRequest({
       method: "GET",
       baseUrl: this.baseUrl,
@@ -4565,16 +4649,22 @@ var RedTeamCustomAttackReportsClient = class {
     });
     return res.data;
   }
-  /** Get prompts for a specific prompt set in a scan. */
+  /**
+   * Get prompts for a specific prompt set in a scan.
+   * @param jobId - The job UUID.
+   * @param promptSetId - The prompt set UUID.
+   * @param opts - Optional pagination, search, and filter options.
+   * @returns The list of prompt detail responses.
+   */
   async getPromptsBySet(jobId, promptSetId, opts) {
-    validateJobId2(jobId);
+    validateJobId(jobId);
     if (!isValidUuid(promptSetId)) {
       throw new AISecSDKException(
         `Invalid prompt set id: ${promptSetId}`,
         "AISEC_USER_REQUEST_PAYLOAD_ERROR" /* USER_REQUEST_PAYLOAD_ERROR */
       );
     }
-    const params = buildListParams3(opts);
+    const params = buildRedTeamListParams(opts);
     if (opts?.is_threat !== void 0) params.is_threat = String(opts.is_threat);
     const res = await managementHttpRequest({
       method: "GET",
@@ -4586,9 +4676,14 @@ var RedTeamCustomAttackReportsClient = class {
     });
     return res.data;
   }
-  /** Get details for a specific prompt. */
+  /**
+   * Get details for a specific prompt.
+   * @param jobId - The job UUID.
+   * @param promptId - The prompt UUID.
+   * @returns The prompt detail response.
+   */
   async getPromptDetail(jobId, promptId) {
-    validateJobId2(jobId);
+    validateJobId(jobId);
     if (!isValidUuid(promptId)) {
       throw new AISecSDKException(
         `Invalid prompt id: ${promptId}`,
@@ -4604,10 +4699,15 @@ var RedTeamCustomAttackReportsClient = class {
     });
     return res.data;
   }
-  /** List custom attacks for a scan. */
+  /**
+   * List custom attacks for a scan.
+   * @param jobId - The job UUID.
+   * @param opts - Optional pagination, search, and filter options.
+   * @returns The paginated list of custom attacks.
+   */
   async listCustomAttacks(jobId, opts) {
-    validateJobId2(jobId);
-    const params = buildListParams3(opts);
+    validateJobId(jobId);
+    const params = buildRedTeamListParams(opts);
     if (opts?.threat !== void 0) params.threat = String(opts.threat);
     if (opts?.prompt_set_id !== void 0) params.prompt_set_id = opts.prompt_set_id;
     if (opts?.property_value !== void 0) params.property_value = opts.property_value;
@@ -4621,9 +4721,14 @@ var RedTeamCustomAttackReportsClient = class {
     });
     return res.data;
   }
-  /** Get attack outputs for a custom attack. */
+  /**
+   * Get attack outputs for a custom attack.
+   * @param jobId - The job UUID.
+   * @param attackId - The attack UUID.
+   * @returns The list of attack outputs.
+   */
   async getAttackOutputs(jobId, attackId) {
-    validateJobId2(jobId);
+    validateJobId(jobId);
     if (!isValidUuid(attackId)) {
       throw new AISecSDKException(
         `Invalid attack id: ${attackId}`,
@@ -4639,9 +4744,13 @@ var RedTeamCustomAttackReportsClient = class {
     });
     return res.data;
   }
-  /** Get property statistics for a custom attack scan. */
+  /**
+   * Get property statistics for a custom attack scan.
+   * @param jobId - The job UUID.
+   * @returns The list of property statistics.
+   */
   async getPropertyStats(jobId) {
-    validateJobId2(jobId);
+    validateJobId(jobId);
     const res = await managementHttpRequest({
       method: "GET",
       baseUrl: this.baseUrl,
@@ -4654,13 +4763,6 @@ var RedTeamCustomAttackReportsClient = class {
 };
 
 // src/red-team/targets-client.ts
-function buildListParams4(opts) {
-  const params = {};
-  if (opts?.skip !== void 0) params.skip = String(opts.skip);
-  if (opts?.limit !== void 0) params.limit = String(opts.limit);
-  if (opts?.search !== void 0) params.search = opts.search;
-  return params;
-}
 var RedTeamTargetsClient = class {
   baseUrl;
   oauthClient;
@@ -4690,9 +4792,13 @@ var RedTeamTargetsClient = class {
     });
     return res.data;
   }
-  /** List targets with optional filters. */
+  /**
+   * List targets with optional filters.
+   * @param opts - Optional pagination, search, and filter options.
+   * @returns The paginated list of targets.
+   */
   async list(opts) {
-    const params = buildListParams4(opts);
+    const params = buildRedTeamListParams(opts);
     if (opts?.target_type !== void 0) params.target_type = opts.target_type;
     if (opts?.status !== void 0) params.status = opts.status;
     const res = await managementHttpRequest({
@@ -4705,7 +4811,11 @@ var RedTeamTargetsClient = class {
     });
     return res.data;
   }
-  /** Get a target by UUID. */
+  /**
+   * Get a target by UUID.
+   * @param uuid - The target UUID.
+   * @returns The target response.
+   */
   async get(uuid) {
     if (!isValidUuid(uuid)) {
       throw new AISecSDKException(
@@ -4722,7 +4832,13 @@ var RedTeamTargetsClient = class {
     });
     return res.data;
   }
-  /** Update a target. */
+  /**
+   * Update a target.
+   * @param uuid - The target UUID.
+   * @param request - Target update request body.
+   * @param opts - Optional operation options (e.g. validate connection).
+   * @returns The updated target response.
+   */
   async update(uuid, request, opts) {
     if (!isValidUuid(uuid)) {
       throw new AISecSDKException(
@@ -4743,7 +4859,11 @@ var RedTeamTargetsClient = class {
     });
     return res.data;
   }
-  /** Delete a target. */
+  /**
+   * Delete a target.
+   * @param uuid - The target UUID.
+   * @returns The delete response.
+   */
   async delete(uuid) {
     if (!isValidUuid(uuid)) {
       throw new AISecSDKException(
@@ -4760,7 +4880,11 @@ var RedTeamTargetsClient = class {
     });
     return res.data;
   }
-  /** Run profiling probes on a target. */
+  /**
+   * Run profiling probes on a target.
+   * @param request - The probe request body.
+   * @returns The target response after probing.
+   */
   async probe(request) {
     const res = await managementHttpRequest({
       method: "POST",
@@ -4772,7 +4896,11 @@ var RedTeamTargetsClient = class {
     });
     return res.data;
   }
-  /** Get profiling results for a target. */
+  /**
+   * Get profiling results for a target.
+   * @param uuid - The target UUID.
+   * @returns The target profile response.
+   */
   async getProfile(uuid) {
     if (!isValidUuid(uuid)) {
       throw new AISecSDKException(
@@ -4789,7 +4917,12 @@ var RedTeamTargetsClient = class {
     });
     return res.data;
   }
-  /** Update a target profile (background + additional context). */
+  /**
+   * Update a target profile (background + additional context).
+   * @param uuid - The target UUID.
+   * @param request - The context update request body.
+   * @returns The updated target response.
+   */
   async updateProfile(uuid, request) {
     if (!isValidUuid(uuid)) {
       throw new AISecSDKException(
@@ -4810,13 +4943,6 @@ var RedTeamTargetsClient = class {
 };
 
 // src/red-team/custom-attacks-client.ts
-function buildListParams5(opts) {
-  const params = {};
-  if (opts?.skip !== void 0) params.skip = String(opts.skip);
-  if (opts?.limit !== void 0) params.limit = String(opts.limit);
-  if (opts?.search !== void 0) params.search = opts.search;
-  return params;
-}
 function validateUuid(uuid, label) {
   if (!isValidUuid(uuid)) {
     throw new AISecSDKException(`Invalid ${label}: ${uuid}`, "AISEC_USER_REQUEST_PAYLOAD_ERROR" /* USER_REQUEST_PAYLOAD_ERROR */);
@@ -4834,7 +4960,11 @@ var RedTeamCustomAttacksClient = class {
   // -----------------------------------------------------------------------
   // Prompt Set operations
   // -----------------------------------------------------------------------
-  /** Create a new custom prompt set. */
+  /**
+   * Create a new custom prompt set.
+   * @param request - Prompt set creation request body.
+   * @returns The created prompt set response.
+   */
   async createPromptSet(request) {
     const res = await managementHttpRequest({
       method: "POST",
@@ -4846,9 +4976,13 @@ var RedTeamCustomAttacksClient = class {
     });
     return res.data;
   }
-  /** List custom prompt sets. */
+  /**
+   * List custom prompt sets.
+   * @param opts - Optional pagination, search, and filter options.
+   * @returns The paginated list of prompt sets.
+   */
   async listPromptSets(opts) {
-    const params = buildListParams5(opts);
+    const params = buildRedTeamListParams(opts);
     if (opts?.status !== void 0) params.status = opts.status;
     if (opts?.active !== void 0) params.active = String(opts.active);
     if (opts?.archive !== void 0) params.archive = String(opts.archive);
@@ -4862,7 +4996,11 @@ var RedTeamCustomAttacksClient = class {
     });
     return res.data;
   }
-  /** Get a prompt set by UUID. */
+  /**
+   * Get a prompt set by UUID.
+   * @param uuid - The prompt set UUID.
+   * @returns The prompt set response.
+   */
   async getPromptSet(uuid) {
     validateUuid(uuid, "prompt set uuid");
     const res = await managementHttpRequest({
@@ -4874,7 +5012,12 @@ var RedTeamCustomAttacksClient = class {
     });
     return res.data;
   }
-  /** Update a prompt set. */
+  /**
+   * Update a prompt set.
+   * @param uuid - The prompt set UUID.
+   * @param request - Prompt set update request body.
+   * @returns The updated prompt set response.
+   */
   async updatePromptSet(uuid, request) {
     validateUuid(uuid, "prompt set uuid");
     const res = await managementHttpRequest({
@@ -4887,7 +5030,12 @@ var RedTeamCustomAttacksClient = class {
     });
     return res.data;
   }
-  /** Archive or unarchive a prompt set. */
+  /**
+   * Archive or unarchive a prompt set.
+   * @param uuid - The prompt set UUID.
+   * @param request - Archive request body.
+   * @returns The updated prompt set response.
+   */
   async archivePromptSet(uuid, request) {
     validateUuid(uuid, "prompt set uuid");
     const res = await managementHttpRequest({
@@ -4900,7 +5048,11 @@ var RedTeamCustomAttacksClient = class {
     });
     return res.data;
   }
-  /** Resolve a prompt set reference for data plane consumption. */
+  /**
+   * Resolve a prompt set reference for data plane consumption.
+   * @param uuid - The prompt set UUID.
+   * @returns The prompt set reference.
+   */
   async getPromptSetReference(uuid) {
     validateUuid(uuid, "prompt set uuid");
     const res = await managementHttpRequest({
@@ -4912,7 +5064,11 @@ var RedTeamCustomAttacksClient = class {
     });
     return res.data;
   }
-  /** Get version information for a prompt set. */
+  /**
+   * Get version information for a prompt set.
+   * @param uuid - The prompt set UUID.
+   * @returns The prompt set version info.
+   */
   async getPromptSetVersionInfo(uuid) {
     validateUuid(uuid, "prompt set uuid");
     const res = await managementHttpRequest({
@@ -4924,7 +5080,10 @@ var RedTeamCustomAttacksClient = class {
     });
     return res.data;
   }
-  /** List active prompt sets (for data plane). */
+  /**
+   * List active prompt sets (for data plane).
+   * @returns The list of active prompt sets.
+   */
   async listActivePromptSets() {
     const res = await managementHttpRequest({
       method: "GET",
@@ -4935,7 +5094,11 @@ var RedTeamCustomAttacksClient = class {
     });
     return res.data;
   }
-  /** Download CSV template for a prompt set. */
+  /**
+   * Download CSV template for a prompt set.
+   * @param uuid - The prompt set UUID.
+   * @returns The CSV template content (untyped — raw response from the API).
+   */
   async downloadTemplate(uuid) {
     validateUuid(uuid, "prompt set uuid");
     const res = await managementHttpRequest({
@@ -4947,7 +5110,12 @@ var RedTeamCustomAttacksClient = class {
     });
     return res.data;
   }
-  /** Upload a CSV file of custom prompts for a prompt set. */
+  /**
+   * Upload a CSV file of custom prompts for a prompt set.
+   * @param promptSetUuid - The prompt set UUID.
+   * @param file - The CSV file blob.
+   * @returns The upload response.
+   */
   async uploadPromptsCsv(promptSetUuid, file) {
     validateUuid(promptSetUuid, "prompt set uuid");
     const token = await this.oauthClient.getToken();
@@ -4977,7 +5145,11 @@ var RedTeamCustomAttacksClient = class {
   // -----------------------------------------------------------------------
   // Prompt operations
   // -----------------------------------------------------------------------
-  /** Create a new custom prompt. */
+  /**
+   * Create a new custom prompt.
+   * @param request - Prompt creation request body.
+   * @returns The created prompt response.
+   */
   async createPrompt(request) {
     const res = await managementHttpRequest({
       method: "POST",
@@ -4989,10 +5161,15 @@ var RedTeamCustomAttacksClient = class {
     });
     return res.data;
   }
-  /** List prompts in a prompt set. */
+  /**
+   * List prompts in a prompt set.
+   * @param promptSetUuid - The prompt set UUID.
+   * @param opts - Optional pagination, search, and filter options.
+   * @returns The paginated list of prompts.
+   */
   async listPrompts(promptSetUuid, opts) {
     validateUuid(promptSetUuid, "prompt set uuid");
-    const params = buildListParams5(opts);
+    const params = buildRedTeamListParams(opts);
     if (opts?.active !== void 0) params.active = String(opts.active);
     const res = await managementHttpRequest({
       method: "GET",
@@ -5004,7 +5181,12 @@ var RedTeamCustomAttacksClient = class {
     });
     return res.data;
   }
-  /** Get a prompt by UUID. */
+  /**
+   * Get a prompt by UUID.
+   * @param promptSetUuid - The prompt set UUID.
+   * @param promptUuid - The prompt UUID.
+   * @returns The prompt response.
+   */
   async getPrompt(promptSetUuid, promptUuid) {
     validateUuid(promptSetUuid, "prompt set uuid");
     validateUuid(promptUuid, "prompt uuid");
@@ -5017,7 +5199,13 @@ var RedTeamCustomAttacksClient = class {
     });
     return res.data;
   }
-  /** Update a prompt. */
+  /**
+   * Update a prompt.
+   * @param promptSetUuid - The prompt set UUID.
+   * @param promptUuid - The prompt UUID.
+   * @param request - Prompt update request body.
+   * @returns The updated prompt response.
+   */
   async updatePrompt(promptSetUuid, promptUuid, request) {
     validateUuid(promptSetUuid, "prompt set uuid");
     validateUuid(promptUuid, "prompt uuid");
@@ -5031,7 +5219,12 @@ var RedTeamCustomAttacksClient = class {
     });
     return res.data;
   }
-  /** Delete a prompt. */
+  /**
+   * Delete a prompt.
+   * @param promptSetUuid - The prompt set UUID.
+   * @param promptUuid - The prompt UUID.
+   * @returns The delete response.
+   */
   async deletePrompt(promptSetUuid, promptUuid) {
     validateUuid(promptSetUuid, "prompt set uuid");
     validateUuid(promptUuid, "prompt uuid");
@@ -5047,7 +5240,10 @@ var RedTeamCustomAttacksClient = class {
   // -----------------------------------------------------------------------
   // Property operations
   // -----------------------------------------------------------------------
-  /** Get all property names. */
+  /**
+   * Get all property names.
+   * @returns The list of property names.
+   */
   async getPropertyNames() {
     const res = await managementHttpRequest({
       method: "GET",
@@ -5058,7 +5254,11 @@ var RedTeamCustomAttacksClient = class {
     });
     return res.data;
   }
-  /** Create a new property name. */
+  /**
+   * Create a new property name.
+   * @param request - Property name creation request body.
+   * @returns The creation response.
+   */
   async createPropertyName(request) {
     const res = await managementHttpRequest({
       method: "POST",
@@ -5070,7 +5270,11 @@ var RedTeamCustomAttacksClient = class {
     });
     return res.data;
   }
-  /** Get values for a property name. */
+  /**
+   * Get values for a property name.
+   * @param propertyName - The property name to look up.
+   * @returns The property values response.
+   */
   async getPropertyValues(propertyName) {
     const res = await managementHttpRequest({
       method: "GET",
@@ -5081,7 +5285,11 @@ var RedTeamCustomAttacksClient = class {
     });
     return res.data;
   }
-  /** Get values for multiple property names. */
+  /**
+   * Get values for multiple property names.
+   * @param propertyNames - Array of property names to look up.
+   * @returns The property values for all requested names.
+   */
   async getPropertyValuesMultiple(propertyNames) {
     const url = new URL(`https://placeholder${RED_TEAM_CUSTOM_ATTACK_PATH}/property-values`);
     for (const name of propertyNames) {
@@ -5098,7 +5306,11 @@ var RedTeamCustomAttacksClient = class {
     });
     return res.data;
   }
-  /** Create a property value. */
+  /**
+   * Create a property value.
+   * @param request - Property value creation request body.
+   * @returns The creation response.
+   */
   async createPropertyValue(request) {
     const res = await managementHttpRequest({
       method: "POST",
@@ -5113,13 +5325,6 @@ var RedTeamCustomAttacksClient = class {
 };
 
 // src/red-team/client.ts
-function buildListParams6(opts) {
-  const params = {};
-  if (opts?.skip !== void 0) params.skip = String(opts.skip);
-  if (opts?.limit !== void 0) params.limit = String(opts.limit);
-  if (opts?.search !== void 0) params.search = opts.search;
-  return params;
-}
 var RedTeamClient = class {
   /** Data plane scan operations. */
   scans;
@@ -5197,7 +5402,11 @@ var RedTeamClient = class {
   // -----------------------------------------------------------------------
   // Data plane convenience methods
   // -----------------------------------------------------------------------
-  /** Get scan statistics and risk profile (data plane dashboard). */
+  /**
+   * Get scan statistics and risk profile (data plane dashboard).
+   * @param params - Optional date range and target ID filters.
+   * @returns The scan statistics response.
+   */
   async getScanStatistics(params) {
     const p = {};
     if (params?.date_range !== void 0) p.date_range = params.date_range;
@@ -5212,7 +5421,11 @@ var RedTeamClient = class {
     });
     return res.data;
   }
-  /** Get score trend for a target (data plane dashboard). */
+  /**
+   * Get score trend for a target (data plane dashboard).
+   * @param targetId - The target UUID.
+   * @returns The score trend response.
+   */
   async getScoreTrend(targetId) {
     if (!isValidUuid(targetId)) {
       throw new AISecSDKException(
@@ -5230,7 +5443,10 @@ var RedTeamClient = class {
     });
     return res.data;
   }
-  /** Get quota summary. */
+  /**
+   * Get quota summary.
+   * @returns The quota summary.
+   */
   async getQuota() {
     const res = await managementHttpRequest({
       method: "POST",
@@ -5241,7 +5457,12 @@ var RedTeamClient = class {
     });
     return res.data;
   }
-  /** List error logs for a scan job. */
+  /**
+   * List error logs for a scan job.
+   * @param jobId - The job UUID.
+   * @param opts - Optional pagination and search options.
+   * @returns The paginated list of error logs.
+   */
   async getErrorLogs(jobId, opts) {
     if (!isValidUuid(jobId)) {
       throw new AISecSDKException(`Invalid job id: ${jobId}`, "AISEC_USER_REQUEST_PAYLOAD_ERROR" /* USER_REQUEST_PAYLOAD_ERROR */);
@@ -5250,13 +5471,17 @@ var RedTeamClient = class {
       method: "GET",
       baseUrl: this.dataEndpoint,
       path: `${RED_TEAM_ERROR_LOG_PATH}/${jobId}`,
-      params: buildListParams6(opts),
+      params: buildRedTeamListParams(opts),
       oauthClient: this.oauthClient,
       numRetries: this.numRetries
     });
     return res.data;
   }
-  /** Update sentiment for a scan report. */
+  /**
+   * Update sentiment for a scan report.
+   * @param request - The sentiment request body.
+   * @returns The sentiment response.
+   */
   async updateSentiment(request) {
     const res = await managementHttpRequest({
       method: "POST",
@@ -5268,7 +5493,11 @@ var RedTeamClient = class {
     });
     return res.data;
   }
-  /** Get sentiment for a scan report. */
+  /**
+   * Get sentiment for a scan report.
+   * @param jobId - The job UUID.
+   * @returns The sentiment response.
+   */
   async getSentiment(jobId) {
     if (!isValidUuid(jobId)) {
       throw new AISecSDKException(`Invalid job id: ${jobId}`, "AISEC_USER_REQUEST_PAYLOAD_ERROR" /* USER_REQUEST_PAYLOAD_ERROR */);
@@ -5285,7 +5514,10 @@ var RedTeamClient = class {
   // -----------------------------------------------------------------------
   // Management plane convenience methods
   // -----------------------------------------------------------------------
-  /** Get management dashboard overview. */
+  /**
+   * Get management dashboard overview.
+   * @returns The dashboard overview response.
+   */
   async getDashboardOverview() {
     const res = await managementHttpRequest({
       method: "GET",