@spec list(ArchAstro.Client.t(), String.t()) ::
  {:ok, ArchAstro.Types.Operations.GetApiV1ThreadsThreadSettings.Response.t()}
  | {:error, ArchAstro.Error.reason()}

Retrieve thread settings

Returns the current settings for the specified thread. Settings control per-thread behavior such as whether the AI agent is enabled.

The authenticated user must own the thread or be a member of its workspace. If settings have never been explicitly configured, defaults are returned (for example, agent_enabled defaults to true).

Successful response

@spec replace(
  ArchAstro.Client.t(),
  String.t(),
  ArchAstro.Types.Operations.PutApiV1ThreadsThreadSettings.Input.t()
) ::
  {:ok, ArchAstro.Types.ThreadSettings.t()} | {:error, ArchAstro.Error.reason()}

Update thread settings

Updates the settings for the specified thread. Only fields included in the settings map are modified; omitted fields retain their current values.

The authenticated user must own the thread or be a member of its workspace. Returns the full settings object reflecting the state after the update. Validation errors are returned as 422 Unprocessable Entity.

The thread settings object after the update has been applied.