@seclai/sdk 1.1.5 → 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.1.5/
+https://seclai.github.io/seclai-javascript/1.3.0/
 
 ## Resources
 
@@ -121,6 +121,25 @@ await client.deleteAgent("agent_id");
 // Definition (step workflow)
 const def = await client.getAgentDefinition("agent_id");
 await client.updateAgentDefinition("agent_id", { steps: [...], change_id: def.change_id });
+
+// Export / import an agent
+const exported = await client.exportAgent("agent_id");
+
+// Validate the payload first to surface unresolved entity refs in this account
+const preview = await client.previewImportAgent({ agent_definition: exported });
+const unresolved = (preview.unresolved_refs ?? []) as Array<{ ref_id: string }>;
+const entity_remap = Object.fromEntries(
+  unresolved.map((ref) => [ref.ref_id, /* picked target uuid */ ""]),
+);
+
+// Commit — `entity_remap` substitutes workflow refs before save
+const imported = await client.createAgent({
+  name: "Imported",
+  trigger_type: "dynamic_input",
+  agent_definition: exported,
+  entity_remap,
+});
+// `imported.import_warnings` lists any items that couldn't be applied.
 ```
 
 ### Agent runs
@@ -183,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",
@@ -190,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
@@ -422,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

@@ -797,7 +797,7 @@ var Seclai = class {
     await this.request("DELETE", `/agents/${agentId}`);
   }
   // ═══════════════════════════════════════════════════════════════════════════
-  // Agent Export
+  // Agent Export / Import
   // ═══════════════════════════════════════════════════════════════════════════
   /**
    * Export an agent definition as a portable JSON snapshot.
@@ -811,6 +811,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
   // ═══════════════════════════════════════════════════════════════════════════
@@ -1190,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)
   // ═══════════════════════════════════════════════════════════════════════════
@@ -2229,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
   // ═══════════════════════════════════════════════════════════════════════════