@cdot65/prisma-airs-sdk 0.6.4 → 0.6.6

package/dist/index.cjs

@@ -430,7 +430,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";
@@ -595,7 +595,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);
@@ -658,6 +659,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 (0, import_node_crypto.createHmac)("sha256", secret).update(payload).digest("hex");
 }
@@ -923,7 +929,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);
@@ -933,7 +942,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;
@@ -961,6 +973,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 = (0, import_node_fs.readFileSync)(filePath, "utf-8");
@@ -1313,7 +1326,7 @@ var ErrorResponseSchema = import_zod15.z.object({
   retry_after: import_zod15.z.object({
     interval: import_zod15.z.number().optional(),
     unit: import_zod15.z.string().optional()
-  }).optional()
+  }).passthrough().optional()
 }).passthrough();
 
 // src/models/mgmt-security-profile.ts
@@ -1477,12 +1490,12 @@ var ApiKeyCreateRequestSchema = import_zod18.z.object({
   api_key_name: import_zod18.z.string(),
   rotation_time_interval: import_zod18.z.number(),
   rotation_time_unit: import_zod18.z.string()
-});
+}).passthrough();
 var ApiKeyRegenerateRequestSchema = import_zod18.z.object({
   rotation_time_interval: import_zod18.z.number(),
   rotation_time_unit: import_zod18.z.string(),
   updated_by: import_zod18.z.string().optional()
-});
+}).passthrough();
 var ApiKeyListResponseSchema = import_zod18.z.object({
   api_keys: import_zod18.z.array(ApiKeySchema).optional(),
   next_offset: import_zod18.z.number().optional()
@@ -1651,7 +1664,7 @@ var import_zod23 = require("zod");
 var ClientIdAndCustomerAppSchema = import_zod23.z.object({
   client_id: import_zod23.z.string(),
   customer_app: import_zod23.z.string()
-});
+}).passthrough();
 var Oauth2TokenSchema = import_zod23.z.object({
   token_type: import_zod23.z.string().optional(),
   issued_at: import_zod23.z.string().optional(),
@@ -3145,12 +3158,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;
@@ -3159,6 +3177,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;
@@ -3487,7 +3506,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) {
@@ -4354,6 +4373,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)) {
@@ -4590,14 +4610,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;
@@ -4623,9 +4645,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;
@@ -4639,7 +4665,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 */);
@@ -4653,7 +4683,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 */);
@@ -4667,7 +4701,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",
@@ -4681,18 +4718,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;
@@ -4705,10 +4730,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;
@@ -4725,7 +4755,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)) {
@@ -4743,7 +4778,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)) {
@@ -4761,7 +4801,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({
@@ -4773,7 +4817,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({
@@ -4785,7 +4833,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({
@@ -4800,7 +4852,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({
@@ -4812,7 +4868,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({
@@ -4824,7 +4884,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({
@@ -4836,10 +4900,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);
@@ -4853,7 +4922,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)) {
@@ -4866,7 +4941,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
     });
@@ -4875,7 +4950,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(
@@ -4892,7 +4971,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 };
@@ -4906,7 +4990,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({
@@ -4921,18 +5009,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;
@@ -4942,9 +5018,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,
@@ -4954,9 +5034,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,
@@ -4966,16 +5050,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",
@@ -4987,9 +5077,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}`,
@@ -5005,10 +5100,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;
@@ -5022,9 +5122,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}`,
@@ -5040,9 +5145,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,
@@ -5055,13 +5164,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;
@@ -5091,9 +5193,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({
@@ -5106,7 +5212,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(
@@ -5123,7 +5233,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(
@@ -5144,7 +5260,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(
@@ -5161,7 +5281,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",
@@ -5173,7 +5297,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(
@@ -5190,7 +5318,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(
@@ -5211,13 +5344,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 */);
@@ -5235,7 +5361,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",
@@ -5247,9 +5377,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);
@@ -5263,7 +5397,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({
@@ -5275,7 +5413,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({
@@ -5288,7 +5431,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({
@@ -5301,7 +5449,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({
@@ -5313,7 +5465,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({
@@ -5325,7 +5481,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",
@@ -5336,7 +5495,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({
@@ -5348,7 +5511,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();
@@ -5378,7 +5546,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",
@@ -5390,10 +5562,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",
@@ -5405,7 +5582,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");
@@ -5418,7 +5600,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");
@@ -5432,7 +5620,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");
@@ -5448,7 +5641,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",
@@ -5459,7 +5655,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",
@@ -5471,7 +5671,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",
@@ -5482,7 +5686,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) {
@@ -5499,7 +5707,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",
@@ -5514,13 +5726,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;
@@ -5598,7 +5803,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;
@@ -5613,7 +5822,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(
@@ -5631,7 +5844,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",
@@ -5642,7 +5858,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 */);
@@ -5651,13 +5872,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",
@@ -5669,7 +5894,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 */);
@@ -5686,7 +5915,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",