@seclai/sdk 1.1.5 → 1.2.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.2.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

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
   // ═══════════════════════════════════════════════════════════════════════════