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

> ## Agent Instructions
> Treat availability labels as authoritative. Do not present planned surfaces as live.
> The product MCP can act on Actual Jobs; the documentation MCP cannot.

# Effect SDK

> The planned Actual-owned Effect-native client.

<Warning>`@actual/sdk-effect` is planned and is not currently published.</Warning>

Actual owns this SDK and derives it directly from the Effect `HttpApi`. It is not generated by Speakeasy and does not wrap the generated TypeScript SDK.

The intended client provides:

* tagged failures in the Effect error channel;
* configuration and dependency injection through `Layer`;
* resumable Job events as `Stream`;
* fiber interruption propagated to requests;
* caller-controlled `Schedule` values; and
* a typed test Layer with no network.

```bash theme={null}
# Planned package name; this command does not work until release.
bun add @actual/sdk-effect effect
```

Mutation retry behavior will preserve one semantic idempotency key. A typed unknown external outcome will not be retried as ordinary failure.