@seclai/sdk 1.1.5 → 1.3.0

package/dist/index.js

@@ -747,7 +747,7 @@ var Seclai = class {
     await this.request("DELETE", `/agents/${agentId}`);
   }
   // ═══════════════════════════════════════════════════════════════════════════
-  // Agent Export
+  // Agent Export / Import
   // ═══════════════════════════════════════════════════════════════════════════
   /**
    * Export an agent definition as a portable JSON snapshot.
@@ -761,6 +761,27 @@ var Seclai = class {
       query: { download }
     });
   }
+  /**
+   * Validate an `agent_definition` payload (same shape as {@link exportAgent})
+   * without creating or modifying any agent.
+   *
+   * Use this before {@link createAgent} or {@link updateAgent} with an
+   * `agent_definition` to surface `unresolved_refs` — workflow references to
+   * knowledge bases, memory banks, source connections, or sub-agents that
+   * don't exist in the target account. Pass the returned ids back in
+   * `entity_remap` on the commit call to substitute them.
+   *
+   * @param body - The preview payload (`{ agent_definition: ... }`).
+   * @returns Summary of the validated payload (step counts, schedules,
+   *   alert configs, evaluation criteria, governance policies, and any
+   *   `unresolved_refs`).
+   * @throws {SeclaiAPIValidationError} On HTTP 422 — the body is an
+   *   {@link AgentDefinitionImportErrorResponse} with 1-indexed
+   *   line/column-anchored errors against a canonical `source` echo.
+   */
+  async previewImportAgent(body) {
+    return await this.request("POST", "/agents/preview-import", { json: body });
+  }
   // ═══════════════════════════════════════════════════════════════════════════
   // Agent Definitions
   // ═══════════════════════════════════════════════════════════════════════════
@@ -1140,6 +1161,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)
   // ═══════════════════════════════════════════════════════════════════════════
@@ -2179,6 +2231,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
   // ═══════════════════════════════════════════════════════════════════════════