plugins/_migrate_agents/api/migration_import.py.dox.md

# migration_import.py DOX

## Purpose

Commit a previously reviewed harness export into native Agent Zero storage.

## Contract

- Auth and CSRF use the default `ApiHandler` protections.
- Accepts the same multipart export as the preview endpoint plus category toggles.
- Creates new chat IDs; it never overwrites an existing chat.
- Writes imported knowledge below `usr/knowledge/_migrate_agents/` and skills below `usr/skills/_migrate_agents/` using unique directories and atomic files.
- Does not import credentials, provider keys, authentication state, schedules, channel bindings, or executable runtime services.

## Verification

Run `python -m pytest plugins/_migrate_agents/tests -q`, then exercise preview and import against the live framework runtime.