Skip to contents

Pause recording

cellucid_history_recording_pause.Rd

Pause the history of a tracker: changes still apply but make no step until it is resumed, and an agent's change cannot be undone on its own meanwhile. Ask the person first.

Usage

cellucid_history_recording_pause(viewer, tracker)

Arguments

viewer

A viewer cellucid_view() or cellucid_serve() returned.

tracker

A tracker by its name or its id (history_summary lists them); the tracker in use when left out. Text (at least 1 character). Left out unless given (the viewer then chooses as its own control does).

Value

A cellucid_action_request, at once and invisibly: the action is sent now, or when the viewer's channel opens. cellucid_action_result(request) returns its outcome: a list of head (The step shown now), since (When it was paused (milliseconds since 1970)).

Details

The viewer's action history.recording.pause (History). It moves the viewer's history, as the person's Undo, Redo or a click on a step does: it makes no step of the history.

When an agent (Claude, ChatGPT) runs it, the viewer asks the person first (pauses-recording); from R it is not asked.

See also

cellucid_act() sends any action by its type, and cellucid_action_result() collects its answer.

Examples

if (interactive() && requireNamespace("SeuratObject", quietly = TRUE)) {
  data("pbmc_small", package = "SeuratObject")
  viewer <- cellucid_view(SeuratObject::UpdateSeuratObject(pbmc_small))
  request <- cellucid_history_recording_pause(viewer)
  print(request)
  # cellucid_action_result(request) waits for its outcome.
  cellucid_stop(viewer)
}