@seclai/sdk 1.2.0 → 1.3.0

package/README.md

@@ -104,7 +104,7 @@ or set environment variables:
 
 Online API documentation (latest):
 
-https://seclai.github.io/seclai-javascript/1.2.0/
+https://seclai.github.io/seclai-javascript/1.3.0/
 
 ## Resources
 
@@ -202,6 +202,12 @@ const result = await client.runAgentAndPoll(
 ### Agent input uploads
 
 ```ts
+// Discover which files (if any) the agent expects before staging uploads
+const refs = await client.getAgentAttachmentReferences("agent_id");
+if (refs.requires_uploads) {
+  // refs.agent lists the exact_names / indexes_max / patterns a run batch must satisfy
+}
+
 const upload = await client.uploadAgentInput("agent_id", {
   file: new Uint8Array([...]),
   fileName: "input.pdf",
@@ -209,6 +215,15 @@ const upload = await client.uploadAgentInput("agent_id", {
 const status = await client.getAgentInputUploadStatus("agent_id", upload.upload_id);
 ```
 
+### Agent run attachments
+
+```ts
+// Download a file emitted by a step in an agent run. The attachment_id is the
+// URL-safe-base64 storage_key surfaced in run output manifests / webhooks.
+const resp = await client.downloadAgentRunAttachment("run_id", "attachment_id");
+const blob = await resp.blob(); // raw Response — stream or save the bytes
+```
+
 ### Agent AI assistant
 
 ```ts
@@ -441,6 +456,13 @@ await client.markModelAlertRead("alert_id");
 await client.markAllModelAlertsRead();
 const unread = await client.getUnreadModelAlertCount();
 const recs = await client.getModelRecommendations("model_id");
+
+// Model playground experiments
+const experiment = await client.createExperiment({ model_ids: ["model_id"], prompt: "..." });
+const experiments = await client.listExperiments();
+const detail = await client.getExperiment("experiment_id");
+await client.cancelExperiment("experiment_id");
+await client.deleteExperiment("experiment_id"); // soft-delete, preserves audit history
 ```
 
 ### Search

package/dist/index.cjs

@@ -1211,6 +1211,37 @@ var Seclai = class {
   async getAgentInputUploadStatus(agentId, uploadId) {
     return await this.request("GET", `/agents/${agentId}/input-uploads/${uploadId}`);
   }
+  /**
+   * Get the static attachment-reference contract for an agent — what files (if
+   * any) its definition expects on a run.
+   *
+   * Call this before staging uploads to learn whether the agent accepts files
+   * at all (`requires_uploads`) and which specific filenames, indexes, or glob
+   * patterns its templates reference. A run-time upload batch that doesn't
+   * satisfy every declared selector is rejected with HTTP 400.
+   *
+   * @param agentId - Agent identifier.
+   * @returns The agent's attachment-reference contract.
+   */
+  async getAgentAttachmentReferences(agentId) {
+    return await this.request("GET", `/agents/${agentId}/attachment-references`);
+  }
+  /**
+   * Download a file attachment emitted by a step in an agent run.
+   *
+   * Returns the raw `Response` so you can stream or save the binary data.
+   *
+   * @param runId - Run identifier.
+   * @param attachmentId - URL-safe-base64-encoded `storage_key` of the attachment
+   *   (as surfaced in run output manifests and webhook/email payloads).
+   * @param opts - Optional `downloadName` filename hint for the download disposition.
+   * @returns Raw response with the attachment bytes.
+   */
+  async downloadAgentRunAttachment(runId, attachmentId, opts = {}) {
+    return await this.requestRaw("GET", `/v2/agent-runs/${runId}/attachments/${attachmentId}`, {
+      query: { download_name: opts.downloadName }
+    });
+  }
   // ═══════════════════════════════════════════════════════════════════════════
   // Agent AI Assistant (Steps Generation)
   // ═══════════════════════════════════════════════════════════════════════════
@@ -2250,6 +2281,17 @@ var Seclai = class {
   async cancelExperiment(experimentId) {
     return await this.request("POST", `/models/playground/experiments/${experimentId}/cancel`);
   }
+  /**
+   * Soft-delete a model playground experiment.
+   *
+   * Removes the experiment from list/detail views while preserving audit
+   * history. Returns HTTP 204 with no body.
+   *
+   * @param experimentId - Experiment identifier.
+   */
+  async deleteExperiment(experimentId) {
+    await this.request("DELETE", `/models/playground/experiments/${experimentId}`);
+  }
   // ═══════════════════════════════════════════════════════════════════════════
   // Search
   // ═══════════════════════════════════════════════════════════════════════════