feat: add account_id filter for sources in search_beliefs

[Copilot]

Sensor.search_beliefs and related methods could filter sources by id or type, but not by the account that owns the source. This adds account_id as a first-class filter parameter throughout the belief query stack.

Core changes

• data/queries/utils.py: New source_account_criterion() function; account_id: int | list[int] | None added to get_source_criteria(). Accepts both integer IDs and Account model instances. Empty list [] at the search_beliefs level matches nothing (consistent with SQL IN () semantics).
• data/models/time_series.py: account_id parameter threaded through Sensor.search_beliefs() and TimedBelief.search()
• data/models/generic_assets.py: account_id parameter added to GenericAsset.search_beliefs()
• data/schemas/account.py: New AccountIdOrListField class that natively accepts int | list[int], validates each ID against the DB, rejects empty lists, and always deserializes to list[Account]. AccountIdField._deserialize updated to use @with_appcontext_if_needed() instead of @with_appcontext, allowing the field to be used outside CLI contexts. The normalization is encapsulated in the field definition (rather than a schema-level @pre_load hook) so future OpenAPI generation can emit a oneOf schema for it.
• data/schemas/reporting/__init__.py: account_id = AccountIdOrListField() added to BeliefsSearchConfigSchema — enables account filtering in reporter/scheduler/forecaster configurations. Both 42 and [42] are accepted; empty lists are rejected at the field level.
• data/schemas/io.py: Same field added to Input schema, which is what PandasReporter and AggregatorReporter actually deserialize for their input list entries.

Usage

# Filter beliefs to only those from sources owned by a specific account
bdf = sensor.search_beliefs(account_id=42)

# Or multiple accounts
bdf = sensor.search_beliefs(account_id=[42, 99])

# In a reporter input config (both forms accepted)
{"sensor": 1, "source_types": ["user"], "account_id": 42}
{"sensor": 1, "source_types": ["user"], "account_id": [42, 99]}

Note: account_id filtering only matches data sources with an explicit account association. DataSources created by reporters, schedulers, and forecasters have account_id=None and will not be matched by this filter — it is most useful for filtering input data by the account of the user who recorded it.

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Reporters/schedulers/forecasters can filter by source account</issue_title>
<issue_description>Depends on #2047

These actuators can filter by data source id/type, but we most likely would like to filter by the account of the source (as well, probably in combination with type).

• add the account_id parameter for filtering sources (search_beliefs)
• enhance/create a test</issue_description>

<agent_instructions>- Create a PR to tackle issue #2046, using a new branch branched off of copilot/add-account-id-to-data-source (using that as the base branch for the PR).

• Prompt subagents while reminding them to update their own instruction files, making atomic commits and running precommit hooks.
• Use the architecture specialist to create the search filter.
• Use the test specialist to create the tests.
• Run the documentation specialist to update documentation, e.g. regarding forecasting, scheduling, reporting and plugins.
• Run the coordinator.</agent_instructions>

Comments on the Issue (you are @copilot in this section)

Custom agent used: review-lead
Orchestrates team of specialist agents for comprehensive code reviews and synthesizes their findings into unified recommendations

• Fixes Reporters/schedulers/forecasters can filter by source account #2048

---

📱 Kick off Copilot coding agent tasks wherever you are with GitHub Mobile, available on iOS and Android.

[read-the-docs-community]

Documentation build overview

📚 flexmeasures | 🛠️ Build #32234024 | 📁 Comparing 4859a78 against latest (45db49a)

  🔍 Preview build  

Show files changed (9 files in total): 📝 9 modified | ➕ 0 added | ➖ 0 deleted

File	Status
changelog.html	📝 modified
genindex.html	📝 modified
_autosummary/flexmeasures.data.models.generic_assets.html	📝 modified
_autosummary/flexmeasures.data.models.time_series.html	📝 modified
_autosummary/flexmeasures.data.queries.utils.html	📝 modified
_autosummary/flexmeasures.data.schemas.account.html	📝 modified
_autosummary/flexmeasures.data.services.data_sources.html	📝 modified
api/v3_0.html	📝 modified
features/reporting.html	📝 modified