2026 05 22 api sync

[burgaard]

No description provided.

[Copilot]

Pull request overview

Syncs the Python SDK to the latest API schema, adding support for agent import workflows (preview + commit), richer import validation errors/warnings, and a few additional response fields in agent-related models.

Changes:

• Added preview_import_agent convenience methods (sync/async) plus tests and README usage example.
• Updated OpenAPI + generated client/models to support agent_definition + entity_remap, import preview request/response, and import validation error payloads.
• Extended generated agent models/docs (e.g., import_warnings, proposed-action preview, governance policy refs and scan/governance statuses on runs) and updated step-type documentation strings.

Reviewed changes

Copilot reviewed 32 out of 32 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
tests/test_new_methods.py	Adds sync/async tests covering the new preview_import_agent convenience methods.
seclai/seclai.py	Adds sync/async preview_import_agent methods (raw request wrappers) with docstrings.
seclai/_generated/models/update_agent_request.py	Adds agent_definition and entity_remap fields to the generated update-agent request model.
seclai/_generated/models/update_agent_request_entity_remap_type_0.py	New generated model backing the entity_remap mapping for update-agent.
seclai/_generated/models/update_agent_request_agent_definition_type_0.py	New generated model backing the agent_definition payload for update-agent.
seclai/_generated/models/proposed_action_response.py	Adds optional preview field to proposed actions and parsing/serialization support.
seclai/_generated/models/proposed_action_response_preview_type_0.py	New generated model for proposed-action preview payloads.
seclai/_generated/models/import_skip_response.py	New generated model describing per-item import skips/substitutions (import_warnings).
seclai/_generated/models/import_skip_response_details.py	New generated “details” object for ImportSkipResponse.
seclai/_generated/models/import_field_error_model.py	New generated model for structured field errors (line/column/path/message).
seclai/_generated/models/governance_policy_ref_response.py	New generated model for governance policy references (id/name).
seclai/_generated/models/generate_step_config_request.py	Updates the docstring text describing example step_type values.
seclai/_generated/models/create_agent_request.py	Adds agent_definition and entity_remap fields to the generated create-agent request model.
seclai/_generated/models/create_agent_request_entity_remap_type_0.py	New generated model backing the entity_remap mapping for create-agent.
seclai/_generated/models/create_agent_request_agent_definition_type_0.py	New generated model backing the agent_definition payload for create-agent.
seclai/_generated/models/agent_summary_response.py	Adds import_warnings field to agent summaries with parsing/serialization support.
seclai/_generated/models/agent_run_response.py	Adds governance and scan-related fields plus blocked/flagged policy lists.
seclai/_generated/models/agent_import_preview_response.py	New generated model for successful preview-import responses.
seclai/_generated/models/agent_import_preview_response_unresolved_refs_item.py	New generated model for unresolved_refs list items in preview-import response.
seclai/_generated/models/agent_import_preview_request.py	New generated model for preview-import request payload.
seclai/_generated/models/agent_import_preview_request_agent_definition.py	New generated model for the agent_definition object within preview-import request.
seclai/_generated/models/agent_definition_response.py	Updates documentation strings for step-type lists (more current set).
seclai/_generated/models/agent_definition_response_definition.py	Updates documentation strings for step-type lists (more current set).
seclai/_generated/models/agent_definition_import_error_response.py	New generated model for 422 import-validation error bodies.
seclai/_generated/models/__init__.py	Exposes newly generated models in the package exports list.
seclai/_generated/api/agents/update_agent_definition_api_agents_agent_id_definition_put.py	Updates endpoint docstrings describing available step types.
seclai/_generated/api/agents/update_agent_api_agents_agent_id_put.py	Updates 422 response type to AgentDefinitionImportErrorResponse and expands docs for workflow replacement.
seclai/_generated/api/agents/preview_import_agent_api_agents_preview_import_post.py	New generated endpoint module for POST /agents/preview-import.
seclai/_generated/api/agents/get_agent_definition_api_agents_agent_id_definition_get.py	Updates endpoint docstrings describing available step types and streaming constraints.
seclai/_generated/api/agents/create_agent_api_agents_post.py	Updates 422 response type to AgentDefinitionImportErrorResponse and adds import workflow documentation.
README.md	Adds an export → preview-import → create-agent example, including entity_remap usage.
openapi/seclai.openapi.json	Updates OpenAPI spec to include preview-import endpoint, import error/warning schemas, new request fields, and updated docs.

Comments suppressed due to low confidence (1)

seclai/seclai.py:4974

• Same issue as the sync variant: this docstring claims SeclaiAPIValidationError is raised on HTTP 422, but await self.request(...) raises SeclaiAPIStatusError for any non-success status without parsing validation details. Update the docstring or add explicit 422 parsing/exception handling for the import-validation error response.