• AI reference · Area road

move

Pass on her taps. Pass on her own taps as moves (step done, skipped or snoozed, her answer to a question, I'm okay now with her words, her self-screen done, a notice off). Never a yes: her yes is her own tap.

Where it is

In the road area (her next step, her taps, coaching moments, her programme, immersives, her review, what waits for her yes, what was made, and her office as her phone reads it): open it with tools_for { area: "road" }, then call it with use_tool { name: "move", args }.

Does it need a yes?

Depends on what it changes: the everyday part runs at once, anything that reaches people or core files waits for the owner's yes. Here: her own taps as moves (step done, skipped, her answer, I'm okay now); each checked against the map, source mcp; never a yes.

Inputs

InputTypeNeededAbout
movesarray of objectyes1 to 20 items
moves[].event_idstringyesA new uuid per tap; the same one on a retry. · format `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$`
moves[].typestringyesThe map's event type, e.g. step.done, step.skipped, step.snoozed, question.answered, quiet.ended, safety.screen_done, signal.switched_off. · 1 to 60 characters
moves[].companystring or nullno
moves[].area"work" | "relationships" | "yourself" or nullno
moves[].atstringyesWhen she tapped, ISO time. · 10 to 40 characters
moves[].payloadobjectno
moves[].map_versionstringnoThe map's version (now's map_version); left out: the current one. · up to 20 characters
run_idstringyesThe run_id from start. Pass it on every call: it keeps your task held. · 1 to 100 characters

Example

{
  "name": "move",
  "arguments": {
    "moves": [
      {
        "event_id": "event id",
        "type": "step.done",
        "at": "at"
      }
    ],
    "run_id": "the run_id from start"
  }
}

When it is refused

  • invalid: The input isn't right. The sentence names the field and the fix; nothing was done. Fix it and call again.
  • not_found: No such thing in this company (a task, file, person, record). Check the number or name, or list first.
  • not_allowed: Not without another step: the owner's yes, your own task held with pick_up, or a setting the owner turns on. The sentence says which.
  • taken: Someone else holds it (another AI on that task). Pick another task.
  • stale: It changed since you read it. Read it again and use the new version.
  • failed: On our side or a service's, never your input. Try again in a minute; if it keeps failing, call report_problem.