stilt.Model.register_pending#

Model.register_pending(receptors=None, *, scene_id=None)[source]#

Persist model inputs and register one batch of pending work.

This is the output registration boundary shared by local runs, queue-backed workers, and the CLI stilt register command.

Registration is idempotent: calling this multiple times with the same receptors does not create duplicate index entries. The underlying index backend uses an upsert (ON CONFLICT DO UPDATE) so existing rows are updated in place rather than duplicated.

Parameters:
  • receptors (iterable of Receptor, optional) – Receptors to register. When omitted, the model’s current receptor inputs are used.

  • scene_id (str, optional) – Optional grouping label stored on all registered simulations.

Returns:

Registered simulation identifiers.

Return type:

list[str]