> ## Documentation Index
> Fetch the complete documentation index at: https://developers.autoplay.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Migration 0.7.4

> Update deprecated autoplay_sdk import paths before 1.0.0.

## ⚡ Add this skill

<CardGroup cols={2}>
  <Card title="One command" icon="terminal">
    Add the Autoplay SDK import migration helper.

    <CodeGroup>
      ```bash CLI theme={null}
      uvx --from autoplay-sdk autoplay-install-skills --migrate
      ```
    </CodeGroup>

    <a className="skill-card-link" href="/sdk/migration-0.7.4">View the docs →</a>
  </Card>

  <Card title="Agent onboarding" icon="robot">
    Fetch this skill for Autoplay migration setup instructions.

    <CodeGroup>
      ```bash cURL theme={null}
      curl -s https://developers.autoplay.ai/autoplay-migrate-imports/SKILL.md
      ```
    </CodeGroup>

    <a className="skill-card-link" href="https://developers.autoplay.ai/autoplay-migrate-imports/SKILL.md" target="_blank">View the skill →</a>
  </Card>
</CardGroup>

`0.7.4` is a transition release. Old import paths still work, but emit `DeprecationWarning` and will be removed in `1.0.0`.

## What stays stable

* `from autoplay_sdk import ...` does not need changes.
* Runtime behavior is unchanged; this release is import-path reorganization only.

## Find deprecated imports

```bash theme={null}
rg "from autoplay_sdk\." -g "*.py" \
  | rg -v "from autoplay_sdk\.(core|chat|context|proactive|agent_state|api|rag|admin|integrations|skills|prompts|compat)" \
  | rg -v "from autoplay_sdk import"
```

Then update imports that are not already in canonical domains:
`core`, `chat`, `context`, `proactive`, `agent_state`, `api`, `rag`, `admin`, `integrations`, `prompts`, `skills`, `compat`.
For context-writer primitives (including `AsyncAgentContextWriter`), use `autoplay_sdk.context.*` paths.

`autoplay_sdk.rag` remains a stable alias in `0.7.4` and should be left unchanged.

## Common replacements

| Old                               | New                                  |
| --------------------------------- | ------------------------------------ |
| `autoplay_sdk.serve.fastapi`      | `autoplay_sdk.api.fastapi`           |
| `autoplay_sdk.proactive_triggers` | `autoplay_sdk.proactive.triggers`    |
| `autoplay_sdk.agent_states`       | `autoplay_sdk.agent_state.v1.states` |
| `autoplay_sdk.agent_state_v2`     | `autoplay_sdk.agent_state.v2.states` |
| `autoplay_sdk.rag_query`          | `autoplay_sdk.rag.query`             |
| `autoplay_sdk.agent_context`      | `autoplay_sdk.context.agent_context` |
| `autoplay_sdk.context_store`      | `autoplay_sdk.context.context_store` |
| `autoplay_sdk.models`             | `autoplay_sdk.core.models`           |

Full mapping is listed in [`CHANGELOG.md`](../../CHANGELOG.md).

## Verify

```bash theme={null}
python -m pytest tests/compat -v -W error::DeprecationWarning
```