@seclai/sdk 1.1.4 → 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.4/
+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
   // ═══════════════════════════════════════════════════════════════════════════
@@ -2174,6 +2195,61 @@ var Seclai = class {
   async getModelRecommendations(modelId) {
     return await this.request("GET", `/models/${modelId}/recommendations`);
   }
+  /**
+   * List all enabled LLM models grouped by provider.
+   *
+   * @param opts - Optional filters.
+   */
+  async listModels(opts = {}) {
+    return await this.request("GET", "/models", {
+      query: { provider: opts.provider, supports_tool_use: opts.supportsToolUse, supports_thinking: opts.supportsThinking }
+    });
+  }
+  /**
+   * Get full details for a specific model.
+   *
+   * @param modelId - Model identifier.
+   */
+  async getModel(modelId) {
+    return await this.request("GET", `/models/${modelId}/details`);
+  }
+  // ═══════════════════════════════════════════════════════════════════════════
+  // Model Playground Experiments
+  // ═══════════════════════════════════════════════════════════════════════════
+  /**
+   * List model playground experiments.
+   *
+   * @param opts - Optional filters and pagination.
+   */
+  async listExperiments(opts = {}) {
+    return await this.request("GET", "/models/playground/experiments", {
+      query: { days: opts.days, start_date: opts.startDate, end_date: opts.endDate, limit: opts.limit, offset: opts.offset }
+    });
+  }
+  /**
+   * Create a model playground experiment.
+   *
+   * @param body - Experiment configuration.
+   */
+  async createExperiment(body) {
+    return await this.request("POST", "/models/playground/experiments", { json: body });
+  }
+  /**
+   * Get a model playground experiment by ID.
+   *
+   * @param experimentId - Experiment identifier.
+   */
+  async getExperiment(experimentId) {
+    return await this.request("GET", `/models/playground/experiments/${experimentId}`);
+  }
+  /**
+   * Cancel a running model playground experiment.
+   *
+   * @param experimentId - Experiment identifier.
+   */
+  async cancelExperiment(experimentId) {
+    return await this.request("POST", `/models/playground/experiments/${experimentId}/cancel`);
+  }
   // ═══════════════════════════════════════════════════════════════════════════
   // Search
   // ═══════════════════════════════════════════════════════════════════════════