@cdot65/prisma-airs-sdk 0.6.3 → 0.6.5

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.3";
+var SDK_VERSION = "0.6.5";
 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);
@@ -522,7 +523,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 +536,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;
@@ -912,8 +919,8 @@ 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
 import { z as z16 } from "zod";
@@ -1076,12 +1083,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 +1257,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(),
@@ -1397,10 +1404,10 @@ var ModelSecurityPaginationSchema = z24.object({
 var LabelSchema = z24.object({
   key: z24.string(),
   value: z24.string()
-});
+}).passthrough();
 var LabelsCreateRequestSchema = z24.object({
   labels: z24.array(LabelSchema)
-});
+}).passthrough();
 var LabelsResponseSchema = z24.object({}).passthrough();
 var LabelKeyListSchema = z24.object({
   pagination: ModelSecurityPaginationSchema,
@@ -1441,7 +1448,7 @@ var ScanDetailsSchema = z24.object({
   scan_duration_ms: z24.number().int(),
   error_code: z24.string().nullable().optional(),
   error_message: z24.string().nullable().optional()
-});
+}).passthrough();
 var ScanCreateRequestSchema = z24.object({
   model_uri: z24.string(),
   security_group_uuid: z24.string(),
@@ -1453,7 +1460,7 @@ var ScanCreateRequestSchema = z24.object({
   model_name: z24.string().nullable().optional(),
   model_version: z24.string().nullable().optional(),
   scan_details: ScanDetailsSchema.nullable().optional()
-});
+}).passthrough();
 var ScanBaseResponseSchema = z24.object({
   uuid: z24.string(),
   tsg_id: z24.string(),
@@ -1591,7 +1598,7 @@ var ModelSecurityRuleInstanceUpdateRequestSchema = z24.object({
   security_group_uuid: z24.string(),
   state: z24.string().nullable().optional(),
   field_values: z24.record(z24.unknown()).nullable().optional()
-});
+}).passthrough();
 var ListModelSecurityRuleInstancesResponseSchema = z24.object({
   pagination: ModelSecurityPaginationSchema,
   rule_instances: z24.array(ModelSecurityRuleInstanceResponseSchema)
@@ -1601,7 +1608,7 @@ var ModelSecurityGroupCreateRequestSchema = z24.object({
   source_type: z24.string(),
   description: z24.string().optional().default(""),
   rule_configurations: z24.record(RuleConfigurationSchema).optional()
-});
+}).passthrough();
 var ModelSecurityGroupResponseSchema = z24.object({
   uuid: z24.string(),
   tsg_id: z24.string(),
@@ -1616,7 +1623,7 @@ var ModelSecurityGroupResponseSchema = z24.object({
 var ModelSecurityGroupUpdateRequestSchema = z24.object({
   name: z24.string().nullable().optional(),
   description: z24.string().nullable().optional()
-});
+}).passthrough();
 var ListModelSecurityGroupsResponseSchema = z24.object({
   pagination: ModelSecurityPaginationSchema,
   security_groups: z24.array(ModelSecurityGroupResponseSchema)
@@ -1823,12 +1830,12 @@ var TargetType = {
 // src/models/red-team.ts
 import { z as z25 } from "zod";
 var RedTeamPaginationSchema = z25.object({ total_items: z25.number().int().nullable().optional() }).passthrough();
-var CountByNameSchema = z25.object({ name: z25.string(), count: z25.number().int() });
+var CountByNameSchema = z25.object({ name: z25.string(), count: z25.number().int() }).passthrough();
 var ValidationErrorSchema = z25.object({
   loc: z25.array(z25.union([z25.string(), z25.number()])),
   msg: z25.string(),
   type: z25.string()
-});
+}).passthrough();
 var HTTPValidationErrorSchema = z25.object({ detail: z25.array(ValidationErrorSchema).optional() }).passthrough();
 var TargetBackgroundSchema = z25.object({
   industry: z25.string().nullable().optional(),
@@ -1911,7 +1918,7 @@ var ConnectionParamsSchema = z25.union([
 var TargetJobRequestSchema = z25.object({
   uuid: z25.string(),
   version: z25.number().int().nullable().optional()
-});
+}).passthrough();
 var JobTimeRecordSchema = z25.object({
   queued_at: z25.string().nullable().optional(),
   started_at: z25.string().nullable().optional(),
@@ -1972,7 +1979,7 @@ var JobCreateRequestSchema = z25.object({
   ]),
   version: z25.number().int().nullable().optional(),
   extra_info: z25.record(z25.unknown()).nullable().optional()
-});
+}).passthrough();
 var StaticJobReportStatsSchema = z25.object({
   output_completion_percentage: z25.number(),
   partial_report_unlocked: z25.boolean().optional(),
@@ -2043,12 +2050,12 @@ var JobListResponseSchema = z25.object({
 var JobAbortResponseSchema = z25.object({
   job_id: z25.string(),
   message: z25.string()
-});
+}).passthrough();
 var PrerequisiteModelSchema = z25.object({
   id: z25.string(),
   display_name: z25.string(),
   description: z25.string()
-});
+}).passthrough();
 var SubCategoryModelSchema = z25.object({
   id: z25.string(),
   display_name: z25.string(),
@@ -2342,17 +2349,17 @@ var CustomAttackOutputSchema = z25.object({
 var PropertyAssignmentSchema = z25.object({
   name: z25.string(),
   value: z25.string()
-});
+}).passthrough();
 var PropertyValueStatisticSchema = z25.object({
   value: z25.string(),
   successful_attack_count: z25.number().int(),
   total_attack_count: z25.number().int(),
   success_rate: z25.number()
-});
+}).passthrough();
 var PropertyStatisticSchema = z25.object({
   property_name: z25.string(),
   values: z25.array(PropertyValueStatisticSchema)
-});
+}).passthrough();
 var PromptSetSummarySchema = z25.object({
   prompt_set_id: z25.string(),
   prompt_set_name: z25.string(),
@@ -2413,16 +2420,16 @@ var ScanStatisticsResponseSchema = z25.object({
 var ScoreTrendSeriesSchema = z25.object({
   label: z25.string(),
   data: z25.array(z25.number().nullable())
-});
+}).passthrough();
 var ScoreTrendResponseSchema = z25.object({
   labels: z25.array(z25.string()),
   series: z25.array(ScoreTrendSeriesSchema)
-});
+}).passthrough();
 var SentimentRequestSchema = z25.object({
   job_id: z25.string(),
   up_vote: z25.boolean().optional(),
   down_vote: z25.boolean().optional()
-});
+}).passthrough();
 var SentimentResponseSchema = z25.object({
   job_id: z25.string(),
   up_vote: z25.boolean().optional(),
@@ -2432,12 +2439,12 @@ var QuotaDetailsSchema = z25.object({
   allocated: z25.number().int(),
   unlimited: z25.boolean(),
   consumed: z25.number().int()
-});
+}).passthrough();
 var QuotaSummarySchema = z25.object({
   static: QuotaDetailsSchema,
   dynamic: QuotaDetailsSchema,
   custom: QuotaDetailsSchema
-});
+}).passthrough();
 var ErrorLogSchema = z25.object({
   created_at: z25.string(),
   updated_at: z25.string(),
@@ -2564,7 +2571,7 @@ var TargetProfileResponseSchema = z25.object({
 var BaseResponseSchema = z25.object({
   message: z25.string(),
   status: z25.number().int()
-});
+}).passthrough();
 var PromptSetStatsSchema = z25.object({
   total_prompts: z25.number().int(),
   active_prompts: z25.number().int(),
@@ -2576,14 +2583,14 @@ var CustomPromptSetCreateRequestSchema = z25.object({
   name: z25.string(),
   description: z25.unknown().optional(),
   property_names: z25.array(z25.string()).optional()
-});
+}).passthrough();
 var CustomPromptSetUpdateRequestSchema = z25.object({
   name: z25.unknown().optional(),
   description: z25.unknown().optional(),
   archive: z25.unknown().optional(),
   property_names: z25.unknown().optional()
 }).passthrough();
-var CustomPromptSetArchiveRequestSchema = z25.object({ archive: z25.boolean() });
+var CustomPromptSetArchiveRequestSchema = z25.object({ archive: z25.boolean() }).passthrough();
 var CustomPromptSetResponseSchema = z25.object({
   uuid: z25.string(),
   name: z25.string(),
@@ -2642,7 +2649,7 @@ var CustomPromptCreateRequestSchema = z25.object({
   prompt_set_id: z25.string(),
   goal: z25.unknown().optional(),
   properties: z25.unknown().optional()
-});
+}).passthrough();
 var CustomPromptUpdateRequestSchema = z25.object({
   prompt: z25.unknown().optional(),
   goal: z25.unknown().optional(),
@@ -2679,15 +2686,15 @@ var CustomPromptListSchema = z25.object({
   pagination: RedTeamPaginationSchema,
   data: z25.array(CustomPromptListItemSchema).optional()
 }).passthrough();
-var PropertyNameCreateRequestSchema = z25.object({ name: z25.string() });
+var PropertyNameCreateRequestSchema = z25.object({ name: z25.string() }).passthrough();
 var PropertyValueCreateRequestSchema = z25.object({
   property_name: z25.string(),
   property_value: z25.string()
-});
+}).passthrough();
 var PropertyDefinitionSchema = z25.object({
   property_name: z25.string(),
   created_at: z25.string()
-});
+}).passthrough();
 var PropertyNamesListResponseSchema = z25.object({ data: z25.array(PropertyDefinitionSchema).optional() }).passthrough();
 var PropertyValuesResponseSchema = z25.object({
   name: z25.string(),
@@ -2744,12 +2751,18 @@ 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.
+   * @returns Nothing.
+   */
   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 +2771,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;
@@ -3953,6 +3967,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 +4204,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 +4239,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 +4259,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 +4277,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 +4295,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,13 +4312,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 */);
@@ -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 downloaded report data.
+   */
   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 data.
+   */
   async generatePartialReport(jobId) {
     validateJobId(jobId);
     const res = await managementHttpRequest({
@@ -4520,13 +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 */);
@@ -4541,7 +4622,11 @@ 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);
     const res = await managementHttpRequest({
@@ -4553,7 +4638,11 @@ 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);
     const res = await managementHttpRequest({
@@ -4565,7 +4654,13 @@ 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);
     if (!isValidUuid(promptSetId)) {
@@ -4574,7 +4669,7 @@ var RedTeamCustomAttackReportsClient = class {
         "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,7 +4681,12 @@ 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);
     if (!isValidUuid(promptId)) {
@@ -4604,10 +4704,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);
+    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,7 +4726,12 @@ 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);
     if (!isValidUuid(attackId)) {
@@ -4639,7 +4749,11 @@ 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);
     const res = await managementHttpRequest({
@@ -4654,13 +4768,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 +4797,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 +4816,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 +4837,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 +4864,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 +4885,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 +4901,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 +4922,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 +4948,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 +4965,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 +4981,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 +5001,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 +5017,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 +5035,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 +5053,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 +5069,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 +5085,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 +5099,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 data.
+   */
   async downloadTemplate(uuid) {
     validateUuid(uuid, "prompt set uuid");
     const res = await managementHttpRequest({
@@ -4947,7 +5115,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 +5150,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 +5166,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 +5186,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 +5204,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 +5224,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 +5245,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 +5259,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 +5275,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 +5290,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 +5311,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 +5330,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 +5407,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 +5426,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 +5448,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 +5462,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 +5476,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 +5498,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 +5519,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",