[{"data":1,"prerenderedAt":373},["ShallowReactive",2],{"$f4ohwqm7pv3d0":3},{"href":4,"title":5,"description":6,"kind":7,"mark":7,"planned":8,"contributors":9,"provenance":7,"express":8,"bridge":8,"html":10,"headings":11},"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos","OS tools","The os.* tools a run can call: execution labels, gate summaries, questions for the CEO, self-improvement, mail, company state, shared context, unblocking runs, planning, the CEO’s brief and chat threads.",null,false,[],"\u003Cp>\u003Cem>Generated from the built-in tools registry. Do not edit by hand.\u003C\u002Fem>\u003C\u002Fp>\n\u003Cp>\u003Ccode>os.*\u003C\u002Fcode> tools are answered by the OS itself. They need no vendor binding, and none of them calls a vendor. A task still declares each one it calls in its \u003Ccode>tools\u003C\u002Fcode>, like any other tool.\u003C\u002Fp>\n\u003Cp>Shared context (\u003Ccode>os.set_context\u003C\u002Fcode>, \u003Ccode>os.get_context\u003C\u002Fcode>, \u003Ccode>os.delete_context\u003C\u002Fcode>) is a JSON value one run stores and a later run of any task can read. A task version names the key prefixes it wants, and those keys arrive in the run input as \u003Ccode>context\u003C\u002Fcode> before the model is called. It is bookkeeping between runs. It is not memory, and it is not a place for a secret.\u003C\u002Fp>\n\u003Cp>Everything the OS does not have to do itself (send mail, post a message, file an issue) is a vendor tool the enterprise binds, never an \u003Ccode>os.*\u003C\u002Fcode> tool. The CEO chat has a few \u003Ccode>os.*\u003C\u002Fcode> tools of its own: see \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fchat\">Chat tools\u003C\u002Fa>.\u003C\u002Fp>\n\u003Cp>Chat reaches every person-facing OS tool exposed over the API or MCP under the requester’s current permissions. Gates can be listed and decided directly, on the person’s instruction. Other operations are reached through \u003Ccode>os.use_tool\u003C\u002Fcode>: look up the named tool’s schema, then pass its arguments to call it. A tool written for a run (a member’s mailbox, a note about a task) is looked up in a person’s shape that names the member or task the run would supply, shown under “What chat reads”. Newly exposed writes ask for confirmation on every call; private mail remains the requester’s alone. Run-only tools keep their run context.\u003C\u002Fp>\n\u003Cp>The company-state tools (\u003Ccode>os.inspect_enterprise\u003C\u002Fcode>, \u003Ccode>os.directory\u003C\u002Fcode>, \u003Ccode>os.list_blockers\u003C\u002Fcode>, \u003Ccode>os.list_open_gates\u003C\u002Fcode>, \u003Ccode>os.list_waiting\u003C\u002Fcode>) only read. None of them approves, rejects, retries or clears anything, and calling one never opens or resolves a gate. The Waiting list is worked with \u003Ccode>os.finish_waiting\u003C\u002Fcode> and \u003Ccode>os.restart_waiting\u003C\u002Fcode>: by a person’s own agent over the API and the OS MCP server, and by a task that declares them, answered as its run under the same rules, a restart also sharing \u003Ccode>os.retry_run\u003C\u002Fcode>’s task retry cap (see \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fchat\">Chat tools\u003C\u002Fa>). A person’s own agent takes a stopped run off Blockers with \u003Ccode>os.clear_blocker\u003C\u002Fcode>, as its Clear or Cancel does; a run does not call that one. A person’s own agent decides a waiting gate with \u003Ccode>os.decide_gate\u003C\u002Fcode>, over the API and the OS MCP server under their own \u003Ccode>gates:write\u003C\u002Fcode>, as the card in Needs you does: the decision is recorded as them, and the run resumes, routes or ends as it does from the portal. A run never calls it, so a task that declares it is refused when it is saved (\u003Ccode>tool_not_run_callable\u003C\u002Fcode>).\u003C\u002Fp>\n\u003Cp>The unblocking tools (\u003Ccode>os.retry_run\u003C\u002Fcode>, \u003Ccode>os.route_run\u003C\u002Fcode>, \u003Ccode>os.clear_run\u003C\u002Fcode>, \u003Ccode>os.escalate_run\u003C\u002Fcode>) move the runs on Blockers: start one again, send its work to another stage of its pipeline, take one off, or hand one to its team lead or the CEO. None of them decides a gate.\u003C\u002Fp>\n\u003Cp>When work stops on a red default branch, the OS holds it on that shared cause and starts one run of the repair task the successor edge names, with the cause in its input as \u003Ccode>sharedCause\u003C\u002Fcode>. That run files the repair issue with the enterprise’s own code-host tools, then reports its number with \u003Ccode>os.attach_repair\u003C\u002Fcode>. The OS files nothing itself. Once the repair issue’s work item is done, the OS re-queues every run the cause held.\u003C\u002Fp>\n\u003Cp>The chat thread tools (\u003Ccode>os.chat_list\u003C\u002Fcode>, \u003Ccode>os.chat_read\u003C\u002Fcode>, \u003Ccode>os.chat_write\u003C\u002Fcode>, \u003Ccode>os.chat_open\u003C\u002Fcode>) are a member’s conversations with the enterprise’s people, as the mail tools are their mailbox. Every caller reads and writes as who it is. A run is its assigned member: it sees that member’s threads only, and what it writes is the member speaking, left for the people to read, so the run never waits for a reply. An API token or the MCP server is the person’s side: what it writes is a message to the member, who replies. A message a run writes is not something the member remembers when a person later talks to them in that thread.\u003C\u002Fp>\n\u003Cp>The Organisation tools (\u003Ccode>os.list_roles\u003C\u002Fcode>, \u003Ccode>os.read_role\u003C\u002Fcode>, \u003Ccode>os.create_role\u003C\u002Fcode>, \u003Ccode>os.update_role\u003C\u002Fcode>, \u003Ccode>os.delete_role\u003C\u002Fcode>, \u003Ccode>os.add_role_task\u003C\u002Fcode>, \u003Ccode>os.remove_role_task\u003C\u002Fcode>, \u003Ccode>os.add_role_member\u003C\u002Fcode>, \u003Ccode>os.remove_role_member\u003C\u002Fcode>) are the portal’s role forms for a person’s own agent, over the API, the OS MCP server and the CEO chat, under the person’s own \u003Ccode>roles:read\u003C\u002Fcode> or \u003Ccode>roles:write\u003C\u002Fcode>. A run never calls them, so a task that declares one is refused when it is saved (\u003Ccode>tool_not_run_callable\u003C\u002Fcode>): inside a run, a change to the organisation is a plan a person signs off.\u003C\u002Fp>\n\u003Cp>The task definition tools (\u003Ccode>os.list_task_definitions\u003C\u002Fcode>, \u003Ccode>os.read_task_definition\u003C\u002Fcode>) read the enterprise’s tasks as they are live, for a person’s own agent over the API and the OS MCP server, under the person’s own \u003Ccode>tasks:read\u003C\u002Fcode>. The list marks each task \u003Ccode>builtIn\u003C\u002Fcode> when it is a shared built-in definition, and the read gives one task’s skill text, declared fields, version number and current version id. They are not \u003Ccode>os.list_tasks\u003C\u002Fcode> and \u003Ccode>os.read_task\u003C\u002Fcode>, which answer which tasks a member may start. A run never calls them either, so a task that declares one is refused when it is saved (\u003Ccode>tool_not_run_callable\u003C\u002Fcode>): a task must not read and rewrite itself.\u003C\u002Fp>\n\u003Cp>The task write tools (\u003Ccode>os.create_task\u003C\u002Fcode>, \u003Ccode>os.publish_task_version\u003C\u002Fcode>) create an enterprise task and publish a new version of one, for a person’s own agent over the API and the OS MCP server, under the person’s own \u003Ccode>tasks:write\u003C\u002Fcode>. Publishing names the version that was read (\u003Ccode>baseVersionId\u003C\u002Fcode>, from \u003Ccode>os.read_task_definition\u003C\u002Fcode>). A field left out keeps its current value. Setting \u003Ccode>visibility\u003C\u002Fcode> to \u003Ccode>public\u003C\u002Fcode> or \u003Ccode>private\u003C\u002Fcode> on that publish also needs \u003Ccode>catalog:write\u003C\u002Fcode>. A run never calls them by these names, so a task that declares one is refused when it is saved (\u003Ccode>tool_not_run_callable\u003C\u002Fcode>); the names stay undeclarable. A task may reach them only through a bound connection to the OS’s own MCP server, with a gate on every write that server serves, and a run cannot publish the task it is running (\u003Ccode>self_publish_refused\u003C\u002Fcode>). A built-in task is not created or edited this way.\u003C\u002Fp>\n\u003Cp>The team tools (\u003Ccode>os.list_teams\u003C\u002Fcode>, \u003Ccode>os.read_team\u003C\u002Fcode>, \u003Ccode>os.create_team\u003C\u002Fcode>, \u003Ccode>os.update_team\u003C\u002Fcode>, \u003Ccode>os.delete_team\u003C\u002Fcode>, \u003Ccode>os.add_team_member\u003C\u002Fcode>, \u003Ccode>os.remove_team_member\u003C\u002Fcode>) are the portal’s team forms on the same terms as the Organisation tools, under the person’s own \u003Ccode>teams:read\u003C\u002Fcode> or \u003Ccode>teams:write\u003C\u002Fcode>. A model that proposes a team change starts the built-in \u003Ccode>team-create\u003C\u002Fcode>, \u003Ccode>team-update\u003C\u002Fcode> or \u003Ccode>team-delete\u003C\u002Fcode> task instead, with its CEO gate. A task belongs to a role, not a team: a team’s tasks are the tasks of the roles its members hold, so a team gets a task’s work by seating a holder of its role. A team’s charter is not an argument yet (#1433).\u003C\u002Fp>\n\u003Cp>The Work items tools (\u003Ccode>os.add_work_item\u003C\u002Fcode>, \u003Ccode>os.list_work_items\u003C\u002Fcode>, \u003Ccode>os.read_work_item\u003C\u002Fcode>, \u003Ccode>os.update_work_item\u003C\u002Fcode>, \u003Ccode>os.close_work_item\u003C\u002Fcode>) keep a team’s work list: a run, a person, the CEO chat and an outside agent add, list, read, change and close items under the same rules, under \u003Ccode>teams:read\u003C\u002Fcode> or \u003Ccode>teams:write\u003C\u002Fcode>. A run reaches only the teams its member sits on or leads: it adds to and lists the first of them, claims from each in turn, a \u003Ccode>teamId\u003C\u002Fcode> it passes is ignored, another team’s item is \u003Ccode>work_item_not_found\u003C\u002Fcode>, and a run whose member sits on no team gets \u003Ccode>no_team\u003C\u002Fcode>. Who added or changed an item is always the caller. Every change is kept as the item’s history, and a closed item stays readable and can no longer change.\u003C\u002Fp>\n\u003Cp>The catalog publish tools (\u003Ccode>os.publish_role\u003C\u002Fcode>, \u003Ccode>os.publish_team\u003C\u002Fcode>) publish one of the enterprise’s roles or teams to the catalog, where any company can clone it, for a person’s own agent over the API and the OS MCP server, under the person’s own \u003Ccode>catalog:write\u003C\u002Fcode>: the same as Share on a team’s page. A role travels as its name and slug. A team travels as one entry with its roles, a teammate slot per member carrying the roles they hold and nothing of the member, its KPIs and its schedule cadences, and publishing it again brings that entry up to date. A plan without catalog publishing is refused with its reason (\u003Ccode>catalog_publish_not_in_plan\u003C\u002Fcode>), as is a role slug another publisher holds (\u003Ccode>catalog_role_slug_taken\u003C\u002Fcode>) and a team with no roles (\u003Ccode>team_has_no_roles\u003C\u002Fcode>), and nothing is written. A run never calls them by these names, so a task that declares one is refused when it is saved (\u003Ccode>tool_not_run_callable\u003C\u002Fcode>); a task may reach them only through a bound connection to the OS’s own MCP server, with a gate on every write that server serves.\u003C\u002Fp>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Tool\u003C\u002Fth>\n\u003Cth>What it does\u003C\u002Fth>\n\u003Cth>Effect\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-set-execution-name\">\u003Ccode>os.set_execution_name\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Replace the execution's default title with a human-readable name.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-add-execution-link\">\u003Ccode>os.add_execution_link\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Attach an http(s) link to the execution: an issue, a pull request, a preview.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-wait-execution\">\u003Ccode>os.wait_execution\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Hold unfinished work with an owned follow-up and an explicit evidence condition.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-stop-execution\">\u003Ccode>os.stop_execution\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>End the whole execution this run belongs to, because its work is already done or abandoned.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-read-execution\">\u003Ccode>os.read_execution\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Read the execution this run belongs to as a whole: every run in order, and what repeats.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-set-gate-summary\">\u003Ccode>os.set_gate_summary\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Write what the person approving this run's next gate is deciding on.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-decide-gate\">\u003Ccode>os.decide_gate\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Decide one waiting gate as its Needs you card does: approve, reject, or send the work back.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-ask-ceo\">\u003Ccode>os.ask_ceo\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Ask the CEO questions, each with a recommended answer, and end the run on their decision.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-list-recommendations\">\u003Ccode>os.list_recommendations\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>List self-improvement recommendations: pending, decided, task-record, or outcomes to check.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-record-issue-outcome\">\u003Ccode>os.record_issue_outcome\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Record how an issue or pull request a recommendation cites ended.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-get-recommendation\">\u003Ccode>os.get_recommendation\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>One recommendation with its evidence.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-decide-recommendation\">\u003Ccode>os.decide_recommendation\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Decide one pending recommendation: decline, actioned, or implement.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-mail-list\">\u003Ccode>os.mail_list\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>List the assigned member's inbox, newest first: metadata and a snippet, no bodies.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-mail-read\">\u003Ccode>os.mail_read\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Read one message from the assigned member's inbox.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-mail-reply\">\u003Ccode>os.mail_reply\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Reply to a stored mail using its mailbox reply identity, once the CEO approves.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-mail-send\">\u003Ccode>os.mail_send\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Send a new mail from the assigned member’s mailbox, once the CEO approves.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-mail-contacts\">\u003Ccode>os.mail_contacts\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>List or search the assigned member's contacts: the people its mailbox has written to, and those added.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-mail-contact-save\">\u003Ccode>os.mail_contact_save\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Add a contact to the assigned member's mailbox, or name one already there.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-member-mailbox-actions\">\u003Ccode>os.member_mailbox_actions\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>List the one-click buttons a member's mailbox offers: the tasks that declare a mailbox action and run as a role the member holds.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-mail-set-label\">\u003Ccode>os.mail_set_label\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Set the labels on a mail in the assigned member’s inbox.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-mail-set-handled\">\u003Ccode>os.mail_set_handled\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Record whether a mail in the assigned member’s inbox has been handled.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-mail-set-many\">\u003Ccode>os.mail_set_many\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Set the labels, the handled state, or both on many mails in the assigned member’s inbox at once.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-mail-quiet-threads\">\u003Ccode>os.mail_quiet_threads\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>The threads the assigned member replied to that have gone quiet, oldest first, at most ten.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-mail-mark-chased\">\u003Ccode>os.mail_mark_chased\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Record that a quiet thread was answered today, so no second run today raises it again.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-mail-snooze\">\u003Ccode>os.mail_snooze\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Leave a quiet thread alone until a date, instead of drafting a follow-up.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-list\">\u003Ccode>os.my_mail_list\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>List the mail in your own mailbox, newest first: metadata and a snippet, no bodies.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-read\">\u003Ccode>os.my_mail_read\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Read one message from your own mailbox.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-attachment\">\u003Ccode>os.my_mail_attachment\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Fetch one attachment of a message in your own mailbox, base64-encoded.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-set-label\">\u003Ccode>os.my_mail_set_label\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Set the labels on a message in your own mailbox.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-set-handled\">\u003Ccode>os.my_mail_set_handled\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Record where a message in your own mailbox stands: unhandled, replied, skipped, or snoozed until a date.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-set-many\">\u003Ccode>os.my_mail_set_many\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Set the labels, the handled state, or both on many messages in your own mailbox at once.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-reply\">\u003Ccode>os.my_mail_reply\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Reply to a message in your own mailbox, from your own address, with no approval step.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-send\">\u003Ccode>os.my_mail_send\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Send a new mail from your own address, with no approval step.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-forward\">\u003Ccode>os.my_mail_forward\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Forward a message from your own mailbox to somebody else, from your own address, with no approval step.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-delete\">\u003Ccode>os.my_mail_delete\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Delete a message from your own mailbox for good.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-actions\">\u003Ccode>os.my_mail_actions\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>List the one-click buttons your inbox offers: the tasks that declare a mailbox action.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-start-action\">\u003Ccode>os.my_mail_start_action\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Press one of your inbox’s buttons: start that task over your own mailbox.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-schedule-action\">\u003Ccode>os.my_mail_schedule_action\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Press one of your inbox’s buttons on a cadence: each firing runs it over your own mailbox.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-unschedule-action\">\u003Ccode>os.my_mail_unschedule_action\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Stop pressing one of your inbox’s buttons on a cadence.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-contacts\">\u003Ccode>os.my_mail_contacts\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>List or search your own contacts: the people you have written to, and those you added.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-contact-save\">\u003Ccode>os.my_mail_contact_save\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Add a contact to your own mailbox, or name one already there.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-contact-delete\">\u003Ccode>os.my_mail_contact_delete\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Remove a contact from your own mailbox.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-signature\">\u003Ccode>os.my_mail_signature\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Read the signature the OS adds to every mail you send, reply and forward.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-signature-set\">\u003Ccode>os.my_mail_signature_set\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Set or clear the signature the OS adds to every mail you send.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-addresses\">\u003Ccode>os.my_mail_addresses\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>List your own extra addresses, each with the signature mail from it carries.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-address-signature-set\">\u003Ccode>os.my_mail_address_signature_set\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Set or clear the signature mail from one of your extra addresses carries.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-escalate-mail\">\u003Ccode>os.escalate_mail\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>The gate a mail that needs the CEO opens: the mail, why it matters, and what is suggested.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-mail-reply-draft\">\u003Ccode>os.mail_reply_draft\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>The gate a drafted reply opens, so no reply leaves without a decision on it.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-list-kpis\">\u003Ccode>os.list_kpis\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>List the signed-off KPIs the run's teams own and those its task is the source of, with their lights.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-record-kpi-reading\">\u003Ccode>os.record_kpi_reading\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Record a reading for a KPI whose source is this run's task.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-get-enterprise-kpis\">\u003Ccode>os.get_enterprise_kpis\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>The company's KPI targets, bands, cadence and source.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-set-enterprise-kpis\">\u003Ccode>os.set_enterprise_kpis\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Replace the company's KPI target list.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-get-team-kpis\">\u003Ccode>os.get_team_kpis\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>A team's KPI targets, including its key KPI.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-set-team-kpis\">\u003Ccode>os.set_team_kpis\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Replace a team's KPI target list and key KPI.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-set-context\">\u003Ccode>os.set_context\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Store a JSON value for the enterprise under a key, so a later run can read it.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-get-context\">\u003Ccode>os.get_context\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Read one enterprise context value, or null when the key has never been set.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-delete-context\">\u003Ccode>os.delete_context\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Remove one enterprise context key. A missing key is a success.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#kpi-record-reading\">\u003Ccode>kpi.record_reading\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Record one reading of a KPI by hand: the value, when it was taken, and who or what took it.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#kpi-list-readings\">\u003Ccode>kpi.list_readings\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>One KPI's readings, newest first, corrected ones included.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#role-list-kpis\">\u003Ccode>role.list_kpis\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>A role's KPIs, oldest first, with the team KPI each serves, its sign-off, light, trend and readings.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#role-define-kpi\">\u003Ccode>role.define_kpi\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Propose a KPI on a role, waiting for a person to sign it off.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#role-edit-kpi\">\u003Ccode>role.edit_kpi\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Change a role KPI's fields; a signed-off one only a person changes.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-inspect-enterprise\">\u003Ccode>os.inspect_enterprise\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>A snapshot of the company: teams, members, roles, and the tasks of the roles each member holds.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-directory\">\u003Ccode>os.directory\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Teams, members, roles, and the tasks of the roles each member holds: who to offload work to.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-list-blockers\">\u003Ccode>os.list_blockers\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>What has stopped: failed, stalled, blocked and spend-paused runs, and stopped pipelines, with who owns each.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-list-open-gates\">\u003Ccode>os.list_open_gates\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Every gate waiting on a decision, oldest first: the CEO inbox's own rows.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-list-waiting\">\u003Ccode>os.list_waiting\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Open work nothing is working on: no live or queued run, no waiting decision, not on Blockers, not finished.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-retry-run\">\u003Ccode>os.retry_run\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Start a stopped run again, with the same input, so its work moves.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-route-run\">\u003Ccode>os.route_run\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Send a stopped run's work to another task of its pipeline, instead of running the same task again.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-clear-run\">\u003Ccode>os.clear_run\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Take a stopped run off Blockers without running it again.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-escalate-run\">\u003Ccode>os.escalate_run\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Hand a stopped run to its team lead, or to the CEO, and record that you did.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-read-enterprise\">\u003Ccode>os.read_enterprise\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>The whole enterprise: teams, charters, roles, members and every task in full.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-search-catalog\">\u003Ccode>os.search_catalog\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Published catalog tasks that match a plain-English intent, best first.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-list-tool-bindings\">\u003Ccode>os.list_tool_bindings\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>The tool types this enterprise has bound, at which layer, and the tools each exposes.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-list-built-in-tools\">\u003Ccode>os.list_built_in_tools\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Every built-in tool a run can call, with its summary and whether it reads or writes.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-read-task\">\u003Ccode>os.read_task\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>One task in full, its pending recommendations, and the tasks that start it.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-assess-impact\">\u003Ccode>os.assess_impact\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>What points at a role, team, task or member a plan would delete.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-write-plan\">\u003Ccode>os.write_plan\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Write or replace this conversation's plan, checked before the CEO sees it.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-read-plan\">\u003Ccode>os.read_plan\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>This conversation's plan as it stands, with its version.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-chat-list\">\u003Ccode>os.chat_list\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>List chat threads, most recently active first: who each is with, its state and its last message.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-chat-read\">\u003Ccode>os.chat_read\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Read one chat thread: its messages, oldest first.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-chat-write\">\u003Ccode>os.chat_write\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Write one message in a chat thread, as yourself.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-chat-open\">\u003Ccode>os.chat_open\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Open a new chat thread with a member.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-list-roles\">\u003Ccode>os.list_roles\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>The enterprise's roles, by slug.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-read-role\">\u003Ccode>os.read_role\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>One role, with the members who hold it and the tasks that run as it.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-create-role\">\u003Ccode>os.create_role\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Create a role.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-update-role\">\u003Ccode>os.update_role\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Change a role's name or slug.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-delete-role\">\u003Ccode>os.delete_role\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Remove a role nobody holds and no task runs as.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-add-role-task\">\u003Ccode>os.add_role_task\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Give a role a task: the task runs as that role.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-remove-role-task\">\u003Ccode>os.remove_role_task\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Take a task away from a role.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-add-role-member\">\u003Ccode>os.add_role_member\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Give a role a member: the member holds it.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-remove-role-member\">\u003Ccode>os.remove_role_member\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Take a member away from a role.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-list-task-definitions\">\u003Ccode>os.list_task_definitions\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>The enterprise's tasks, built-in ones included, a page at a time, each marked builtIn.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-read-task-definition\">\u003Ccode>os.read_task_definition\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>One task in full: its skill text, declared fields, version number and current version id.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-create-task\">\u003Ccode>os.create_task\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Create one of the enterprise’s own tasks.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-publish-task-version\">\u003Ccode>os.publish_task_version\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Publish a new version of one of the enterprise’s tasks, naming the version it was read from.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-set-task-run-status\">\u003Ccode>os.set_task_run_status\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Enable or disable a task.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-set-task-schedule\">\u003Ccode>os.set_task_schedule\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Set a task schedule.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-remove-task-schedule\">\u003Ccode>os.remove_task_schedule\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Remove a task schedule.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-set-task-input-values\">\u003Ccode>os.set_task_input_values\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Set this enterprise's own values for a task's inputs.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-read-context\">\u003Ccode>os.read_context\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Read enterprise workflow context outside a run.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-write-context\">\u003Ccode>os.write_context\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Set enterprise workflow context outside a run.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-list-teams\">\u003Ccode>os.list_teams\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>The enterprise's teams, by name.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-read-team\">\u003Ccode>os.read_team\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>One team, with its members and the tasks its members’ roles run.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-create-team\">\u003Ccode>os.create_team\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Create a team, optionally with its own concurrent run limit.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-update-team\">\u003Ccode>os.update_team\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Change a team's name or concurrent run limit.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-delete-team\">\u003Ccode>os.delete_team\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Remove a team.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-add-team-member\">\u003Ccode>os.add_team_member\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Put a member on a team, optionally in a role.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-remove-team-member\">\u003Ccode>os.remove_team_member\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Take a member off a team.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-add-work-item\">\u003Ccode>os.add_work_item\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Add an item to a team's work list.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-list-work-items\">\u003Ccode>os.list_work_items\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>A team's work list, open items by default.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-read-work-item\">\u003Ccode>os.read_work_item\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>One work item, with every field.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-update-work-item\">\u003Ccode>os.update_work_item\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Change an open work item's fields.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-close-work-item\">\u003Ccode>os.close_work_item\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Close a work item as done or dropped.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-claim-work-item\">\u003Ccode>os.claim_work_item\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Take the next ready item of this run's team lists, so no other run can take it.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-read-work-item-draft\">\u003Ccode>os.read_work_item_draft\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>An item's draft as it is now: its latest version, text included.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-write-work-item-draft\">\u003Ccode>os.write_work_item_draft\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Write a new version of an item's draft.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-publish-role\">\u003Ccode>os.publish_role\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Publish one of the enterprise’s roles to the catalog, by its portable name and slug.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-publish-team\">\u003Ccode>os.publish_team\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Publish one of the enterprise’s teams to the catalog, with its roles, as the portal’s Share does.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-attach-repair\">\u003Ccode>os.attach_repair\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Report the repair issue you filed for the shared cause this run was started for.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Ch2 id=\"os-set-execution-name\">\u003Ccode>os.set_execution_name\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Replace the execution's default title with a human-readable name.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Set a human-readable name for this execution, shown on Executions and run detail instead of the first task name. Later calls replace it. Pass name, e.g. &quot;GitHub Issue #105 - Work keeps moving while decisions wait on the CEO&quot;.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>name\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>Shown on Executions instead of the first task name\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. The last successful call in the execution wins, so a repeat leaves the same name.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The name as stored: whitespace collapsed and trimmed.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Fexecution-name\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>name_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>name\u003C\u002Fcode> is missing, or blank once whitespace is trimmed.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>name_too_long:200\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>name\u003C\u002Fcode> is over 200 characters.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;name&quot;: &quot;Issue #12 - Export the monthly report as CSV&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-add-execution-link\">\u003Ccode>os.add_execution_link\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Attach an http(s) link to the execution: an issue, a pull request, a preview.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Attach a helpful http(s) link to this execution (issue, PR, preview, CRM profile). Shown on Executions and run detail. The same URL later updates the label. Pass name and url.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>name\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>Label, e.g. GitHub issue, Pull request, Preview\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>url\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>http(s) URL\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. The same URL updates its label rather than adding a second link.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Fexecution-links\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>name_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>name\u003C\u002Fcode> is missing, or blank once whitespace is trimmed.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>name_too_long:200\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>name\u003C\u002Fcode> is over 200 characters.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>url_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>url\u003C\u002Fcode> is missing or blank.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>url_too_long:2000\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>url\u003C\u002Fcode> is over 2000 characters.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>url_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>url\u003C\u002Fcode> is not an \u003Ccode>http:\u003C\u002Fcode> or \u003Ccode>https:\u003C\u002Fcode> URL.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;name&quot;: &quot;Pull request&quot;,\n  &quot;url&quot;: &quot;https:\u002F\u002Fgit.example.com\u002Facme\u002Fapp\u002Fpull\u002F34&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-wait-execution\">\u003Ccode>os.wait_execution\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Hold unfinished work with an owned follow-up and an explicit evidence condition.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Use for temporary dependency, CI or operator waits. Park this run on Blockers, retaining its member as owner, claimed work and lineage. Pass reason, resumeCondition (the fresh evidence required before continuing) and reviewAfterMinutes (1-1440). The durable follow-up is visible in run history; the owner must reassess it by reviewAt through normal retry\u002Froute. No automatic external action or approval is granted. Missing operational evidence stays unresolved. Do not cancel unfinished work. Existing human gates, rejection, retry caps and completed work remain authoritative.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>reason\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>Nonempty, at most 160 characters\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>resumeCondition\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>Nonempty, at most 2000 characters\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>reviewAfterMinutes\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>Integer from 1 to 1440\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The stored reason, resumeCondition, ownerMemberId, runId and reviewAt.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Fwait-execution\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>run_not_active\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The caller is not running or already waiting on this follow-up.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>wait_owner_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>No member owns the calling run.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>gate_authoritative\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A human gate is waiting, rejected or requests changes.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;reason&quot;: &quot;dependency_pending&quot;,\n  &quot;resumeCondition&quot;: &quot;Dependency complete and operational evidence recorded&quot;,\n  &quot;reviewAfterMinutes&quot;: 15\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-stop-execution\">\u003Ccode>os.stop_execution\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>End the whole execution this run belongs to, because its work is already done or abandoned.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">End the whole execution this run belongs to: every open run in it, this one included, ends cancelled, their gates close and nothing new starts. Call it when the work is already done or abandoned elsewhere. Temporary dependency, CI and operator waits use os.wait_execution with an evidence condition and an owner instead. Pass reason, a short text shown on the execution (e.g. pr_merged), and needsHuman: false ends the pipeline clean with no alert, true leaves it blocked for a human.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>reason\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>Why the execution stops, shown on Executions, e.g. pr_merged\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>needsHuman\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>true leaves the work blocked for a human; false ends it clean\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. A repeat call on an execution already stopped changes nothing and succeeds.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The reason as stored (trimmed) and needsHuman.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Fstop-execution\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>reason_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>reason\u003C\u002Fcode> is missing, or blank once trimmed.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>reason_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>reason\u003C\u002Fcode> is not text.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>reason_too_long:160\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>reason\u003C\u002Fcode> is over 160 characters.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>needs_human_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>needsHuman\u003C\u002Fcode> is missing.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>needs_human_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>needsHuman\u003C\u002Fcode> is not true or false.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>run_not_active\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The calling run is not running.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;reason&quot;: &quot;pr_merged&quot;,\n  &quot;needsHuman&quot;: false\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-read-execution\">\u003Ccode>os.read_execution\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Read the execution this run belongs to as a whole: every run in order, and what repeats.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Read the execution this run belongs to, as the OS recorded it: timeline (every run oldest first, with its task, version, status, outcome, the run it came from, cost, duration and failed tool calls), findings (laps per task, cycles, repeated outcomes, loop caps tripped, dead ends, whether its size or cost is an outlier against earlier executions that began with the same task, and how it ended) and evidence (the runs that matter, each with its latest events and failed tool calls). Facts only, never a model's reading of them. A long execution is shortened oldest first, and trimmed says how much; findings are always whole. Takes no arguments: it reads only this run's own execution.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Takes no arguments: no fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ lineageId, entryTaskId, timeline, evidence, findings, trimmed }\u003C\u002Fcode>. \u003Ccode>findings\u003C\u002Fcode> is read from the whole execution before anything is trimmed.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.read_execution\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>execution_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The OS holds no run of this execution, which only a run of another enterprise could see.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-set-gate-summary\">\u003Ccode>os.set_gate_summary\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Write what the person approving this run's next gate is deciding on.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Write, for whoever approves this run’s next gate, what they are deciding on. Markdown bullets: what the action does, and anything to watch out for. Shown on the approval card in Gates and the run page. Required before os.mail_reply, and before any call whose gate the task marks requiresSummary (a merge, say) — the call is handed back until you write one. A later call replaces it, title, why and previewUrl included, but never rewrites a gate already waiting. Pass summary, and the card’s title, why and previewUrl when you have them.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>summary\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>Markdown. Short headed sections of &quot;- &quot; bullets, e.g. &quot;## What changed&quot; then &quot;## Watch out for&quot;. No preamble.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>title\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Optional. The card’s title: what approving does, in plain words, e.g. &quot;Merge “Fix page titles” to production&quot;. One line, at most 120 characters. Without it the card is titled with the task.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>why\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Optional. One line under the title: why this waits for a person, e.g. &quot;Leaves the building: changes the live app&quot;. At most 160 characters.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>previewUrl\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Optional. An https address the person can open to see the result before deciding: a pull request, a preview deploy, a draft. Shown as Preview on the card.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. A later call replaces the summary, so a repeat leaves the same one.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Needs:\u003C\u002Fstrong>\n\u003Cul>\n\u003Cli>Called before \u003Ccode>os.mail_reply\u003C\u002Fcode>, which is handed back until it is.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The summary, and any title, why and previewUrl, as stored. The gate copies them when it opens, so a later call never rewrites a gate already waiting or decided.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Fgate-summary\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>summary_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>summary\u003C\u002Fcode> is missing or blank.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>summary_too_short:40\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>summary\u003C\u002Fcode> is under 40 characters.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>summary_too_long:6000\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>summary\u003C\u002Fcode> is over 6000 characters.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>title_too_long:120\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>title\u003C\u002Fcode> is over 120 characters.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>title_one_line\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>title\u003C\u002Fcode> runs over more than one line.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>why_too_long:160\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>why\u003C\u002Fcode> is over 160 characters.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>why_one_line\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>why\u003C\u002Fcode> runs over more than one line.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>preview_url_not_https\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>previewUrl\u003C\u002Fcode> is not an https address, or is over 2048 characters.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>summary_needs_bullets\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>summary\u003C\u002Fcode> has no markdown bullet (\u003Ccode>- \u003C\u002Fcode>, \u003Ccode>* \u003C\u002Fcode> or \u003Ccode>1. \u003C\u002Fcode>).\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>gate_summary_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A reply, or a call whose gate row is marked requiresSummary, arrives before this run has written a summary.\u003C\u002Ftd>\n\u003Ctd>Handed back\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>incomplete_read:&lt;tool&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A paged read in this run ended incomplete (\u003Ccode>tool_result_truncated\u003C\u002Fcode> with \u003Ccode>complete: false\u003C\u002Fcode>: still too big at a page of 1, or its server ignores the page size), and that same target has not since been read through as pages 1 onward at one page size, ending in a short or empty page. Nothing is recorded; the refusal lists each such read with its tool, arguments and size.\u003C\u002Ftd>\n\u003Ctd>Handed back\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;summary&quot;: &quot;## What changed\\n- Adds CSV export to the monthly report\\n\\n## Watch out for\\n- A migration runs on release&quot;,\n  &quot;title&quot;: &quot;Merge “CSV export for the monthly report” to production&quot;,\n  &quot;why&quot;: &quot;Leaves the building: changes the live app&quot;,\n  &quot;previewUrl&quot;: &quot;https:\u002F\u002Fexample.com\u002Fpull\u002F42&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-decide-gate\">\u003Ccode>os.decide_gate\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Decide one waiting gate as its Needs you card does: approve, reject, or send the work back.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Decide one gate waiting on a person, as its card in Needs you does. Pass gateId as os.list_open_gates lists it, and decision: approve, reject or request_changes. A question gate (toolName os.ask_ceo) is approved by answering it: answers holds one row per question, { number, answer }, or { number, requiresMoreDetail: true } to ask the run for more; a reject declines the whole ask and needs no answers. request_changes sends the work back with note as the feedback, only on a gate whose requestChanges is true. A gate that offers choices is decided through one: pass choice as its key, decision as the decision that choice records, and what the choice asks for in note (a time as ISO 8601). edit, with approve only, is the whole payload as it should run, changed only in the fields the gate’s editableFields names. The decision is recorded as you, and the run resumes, routes or ends exactly as it does from the portal. A gate already decided is refused.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>gateId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The gate, by the id os.list_open_gates lists it under.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>decision\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>approve\u003C\u002Fcode>, \u003Ccode>reject\u003C\u002Fcode>, \u003Ccode>request_changes\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>approve runs the gated call, or answers the questions; reject declines it; request_changes sends the work back with note as the feedback.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>note\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Optional. The reason for a rejection, the feedback for request_changes (required then), or what a choice asks for: a time as ISO 8601 for a datetime input.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>answers\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of object\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Approving a question gate: one object per question, { number, answer }, or { number, requiresMoreDetail: true } to ask for more. Every question the gate asks needs one.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>choice\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Optional. The key of the choice this decision is made through, from the gate’s choices; decision must be the decision that choice records.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>edit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>object\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Optional, with approve only. The gate’s whole payload as it should run, changed only in the fields its editableFields names.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Side effects:\u003C\u002Fstrong> The run the gate holds moves: an approve runs the gated call or resumes the run with the answers, request_changes resumes it with the feedback, a rejected question resumes it with the refusal, and a rejected action ends its run as decision_rejected. A rejected mail gate closes the mail it held.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. A decided gate is no longer waiting, so a repeat is refused with gate_not_waiting and decides nothing more.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The decided gate: \u003Ccode>status\u003C\u002Fcode> (\u003Ccode>approved\u003C\u002Fcode>, \u003Ccode>rejected\u003C\u002Fcode> or \u003Ccode>changes_requested\u003C\u002Fcode>), \u003Ccode>decidedAt\u003C\u002Fcode>, \u003Ccode>decisionNote\u003C\u002Fcode>, \u003Ccode>decisionChoice\u003C\u002Fcode>, \u003Ccode>answers\u003C\u002Fcode> (each question with its answer, on an answered question gate) and \u003Ccode>editedPayload\u003C\u002Fcode> when an edit was sent, with the \u003Ccode>runId\u003C\u002Fcode>, \u003Ccode>toolName\u003C\u002Fcode> and \u003Ccode>payload\u003C\u002Fcode> it holds.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fgates\u002F:gateId\u002Fdecision\u003C\u002Fcode> (\u003Ccode>gates:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>decision_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>decision\u003C\u002Fcode> is missing, or not approve, reject or request_changes (400).\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>answers_must_be_array\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>answers\u003C\u002Fcode> is given and is not a list (400).\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>gate_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>No gate by that id in your enterprise (404).\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>gate_not_waiting\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The gate was already decided, or cancelled with its run (409).\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>answer_required:&lt;number&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Approving a question gate with that question unanswered: no \u003Ccode>answer\u003C\u002Fcode> text and no \u003Ccode>requiresMoreDetail\u003C\u002Fcode> (400).\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>answer_unknown_question\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An \u003Ccode>answers\u003C\u002Fcode> row names a question number the gate did not ask (400).\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>note_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>request_changes\u003C\u002Fcode> without a \u003Ccode>note\u003C\u002Fcode>, or a choice whose input is required without one (400).\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>request_changes_not_routed\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The gate cannot be sent back: its task routes no feedback, so \u003Ccode>requestChanges\u003C\u002Fcode> is false (409).\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>choice_unknown\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>choice\u003C\u002Fcode> is not one the gate’s tool offers (400).\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>choice_decision_mismatch\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>decision\u003C\u002Fcode> is not the decision that \u003Ccode>choice\u003C\u002Fcode> records (400).\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>note_not_a_time\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A choice with a datetime input, and \u003Ccode>note\u003C\u002Fcode> is not a time (400).\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>edit_only_with_approve\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>edit\u003C\u002Fcode> sent with reject or request_changes (400).\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>field_not_editable:&lt;field&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>edit\u003C\u002Fcode> changes a field the gate’s \u003Ccode>editableFields\u003C\u002Fcode> does not name (400).\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example, Answering a question gate: every question the gate asks gets a row.:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;gateId&quot;: &quot;4b3e9c1a-0000-4000-8000-000000000001&quot;,\n  &quot;decision&quot;: &quot;approve&quot;,\n  &quot;answers&quot;: [\n    {\n      &quot;number&quot;: 1,\n      &quot;answer&quot;: &quot;Yes, schedule it now.&quot;\n    }\n  ]\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;gateId&quot;: &quot;4b3e9c1a-0000-4000-8000-000000000002&quot;,\n  &quot;decision&quot;: &quot;reject&quot;,\n  &quot;note&quot;: &quot;Not this quarter.&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;gateId&quot;: &quot;4b3e9c1a-0000-4000-8000-000000000003&quot;,\n  &quot;decision&quot;: &quot;request_changes&quot;,\n  &quot;note&quot;: &quot;Set the epic priority to High before filing.&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example, A gate with choices, decided through one: the choice’s input goes in note.:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;gateId&quot;: &quot;4b3e9c1a-0000-4000-8000-000000000004&quot;,\n  &quot;decision&quot;: &quot;approve&quot;,\n  &quot;choice&quot;: &quot;snooze&quot;,\n  &quot;note&quot;: &quot;2026-11-03T09:00:00Z&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-ask-ceo\">\u003Ccode>os.ask_ceo\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Ask the CEO questions, each with a recommended answer, and end the run on their decision.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Ask the CEO questions and stop. This run waits for their decision, then ends. Pass questions: one decision each, numbered from 1, each answerable on its own, each with context (why it blocks, the options you see) and ctoRecommendation (the answer you recommend and why; required). Give the card a title (what the CEO is deciding, e.g. &quot;Scope the CSV export&quot;) and a why (one line on why only they can answer) when you have them. The CEO answers each one: accepts your recommendation, answers it themselves, or asks you to explain further. Submit → outcome ceo_approved, Reject → ceo_rejected; the next task gets their answers as ceoAnswers and any note as ceoNote. Call it last.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>questions\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of object, at least 1\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>questions[].number\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, at least 1\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>questions[].question\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>One decision, answerable on its own\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>questions[].context\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Why it blocks, and the options you see\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>questions[].ctoRecommendation\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The answer you recommend, and a one-line reason. Never empty.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>context\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>One line on what is blocked, and the issue URL\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>title\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Optional. The card’s title: what the CEO is deciding, in plain words, e.g. &quot;Scope the CSV export&quot;. One line; cut at 120 characters. Without it the card is titled with the task.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>why\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Optional. One line under the title: why this waits for the CEO, e.g. &quot;Changes what customers are promised&quot;. Cut at 160 characters.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. The gate is found again by run and tool call, so a repeat never asks twice.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Needs:\u003C\u002Fstrong>\n\u003Cul>\n\u003Cli>A gate: the CEO decides every call, whatever the task declares.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The CEO's decision, as the run's outcome: \u003Ccode>ceo_approved\u003C\u002Fcode> with \u003Ccode>ceoAnswers\u003C\u002Fcode> (one per question) and \u003Ccode>ceoNote\u003C\u002Fcode>, or \u003Ccode>ceo_rejected\u003C\u002Fcode> with \u003Ccode>ceoNote\u003C\u002Fcode>. The next task receives them.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Fask-ceo\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>ceo_questions_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>No \u003Ccode>questions\u003C\u002Fcode>, or a question with a repeated or invalid number, no text or no \u003Ccode>ctoRecommendation\u003C\u002Fcode>. Recorded as \u003Ccode>ceo_questions_invalid:&lt;why&gt;\u003C\u002Fcode>, before any gate opens.\u003C\u002Ftd>\n\u003Ctd>Handed back\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;questions&quot;: [\n    {\n      &quot;number&quot;: 1,\n      &quot;question&quot;: &quot;Should the export include archived reports?&quot;,\n      &quot;context&quot;: &quot;Customers asked for both; including them doubles the file size.&quot;,\n      &quot;ctoRecommendation&quot;: &quot;No: archived reports are rarely opened, and a filter can add them later.&quot;\n    }\n  ],\n  &quot;context&quot;: &quot;Scoping https:\u002F\u002Fgit.example.com\u002Facme\u002Fapp\u002Fissues\u002F12&quot;,\n  &quot;title&quot;: &quot;Scope the CSV export&quot;,\n  &quot;why&quot;: &quot;Changes what customers are promised&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-list-recommendations\">\u003Ccode>os.list_recommendations\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>List self-improvement recommendations: pending, decided, task-record, or outcomes to check.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">List self-improvement recommendations. view: pending (default, oldest first, to decide), decided (the last 60 days across every task, to spot recurrence), task-record (actioned for implementation in the last 14 days, to follow up their issues), or outcomes (the issues and pull requests decided recommendations cite whose outcome is not known yet: read each with your own tools and record it with os.record_issue_outcome). Optional limit.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>view\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>pending\u003C\u002Fcode>, \u003Ccode>decided\u003C\u002Fcode>, \u003Ccode>task-record\u003C\u002Fcode>, \u003Ccode>outcomes\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>limit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, at least 1\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.list_recommendations\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>view_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>view\u003C\u002Fcode> is not one of the four.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;view&quot;: &quot;pending&quot;,\n  &quot;limit&quot;: 10\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;view&quot;: &quot;outcomes&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-record-issue-outcome\">\u003Ccode>os.record_issue_outcome\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Record how an issue or pull request a recommendation cites ended.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Record what became of an issue or pull request that decided recommendations cite, as you read it with your own tools: open, completed, not_planned, duplicate, merged (a pull request merged) or closed (closed with nothing more known, or a pull request closed unmerged). Every recommendation citing issueUrl keeps it as issueOutcome, which self-improvement reads so a change turned down is not proposed again. Pass issueUrl and outcome.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>issueUrl\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The issue or pull request URL, as the recommendation cites it\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>outcome\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>open\u003C\u002Fcode>, \u003Ccode>completed\u003C\u002Fcode>, \u003Ccode>not_planned\u003C\u002Fcode>, \u003Ccode>duplicate\u003C\u002Fcode>, \u003Ccode>merged\u003C\u002Fcode>, \u003Ccode>closed\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. Recording the same outcome twice leaves the same state.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.record_issue_outcome\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>issue_url_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>issueUrl\u003C\u002Fcode> is not an issue or pull request URL.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>outcome_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>outcome\u003C\u002Fcode> is not one of the six.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>issue_not_cited\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>No recommendation cites \u003Ccode>issueUrl\u003C\u002Fcode>. Record outcomes for the URLs view \u003Ccode>outcomes\u003C\u002Fcode> lists.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;issueUrl&quot;: &quot;https:\u002F\u002Fgit.example.com\u002Facme\u002Fapp\u002Fissues\u002F12&quot;,\n  &quot;outcome&quot;: &quot;completed&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-get-recommendation\">\u003Ccode>os.get_recommendation\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>One recommendation with its evidence.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">One recommendation with its evidence: the source run (status, recent events, failed tool calls), task versions newer than the one the source run ran, and every other recommendation for the same task. When the recommendation came from an execution (`recommendation.sourceLineageId`, with its `patternKey` and `recurrenceCount`), `execution` carries that execution as the self-improvement pass judged it: its `lineageId`, its `findings` untrimmed (laps by task, cycles, repeated outcomes, caps tripped, dead ends, outlier, how it ended, pattern key), a `timeline` of its newest 30 runs oldest first, and `trimmed.timelineRows`, the older runs left out. `execution` is null for a recommendation from one run, or when the execution has no runs left. Pass id.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.get_recommendation\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode> is missing.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000001&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-decide-recommendation\">\u003Ccode>os.decide_recommendation\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Decide one pending recommendation: decline, actioned, or implement.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Decide one pending recommendation. decision: decline (reason required), actioned (issueUrl of the issue or pull request that takes the work, and lane: os, repo-commands or local-stack), or implement (the task-record lane: issueUrl of the issue that tracks it; starts the implementer). Cite an open issue or a merged pull request in the repository the work belongs to: the OS checks only that issueUrl is an issue or pull request URL. Pass id, decision, reason, issueUrl, lane.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>decision\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>decline\u003C\u002Fcode>, \u003Ccode>actioned\u003C\u002Fcode>, \u003Ccode>implement\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>reason\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>issueUrl\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>An issue or pull request URL, e.g. https:\u002F\u002F&lt;host&gt;\u002F&lt;owner&gt;\u002F&lt;repo&gt;\u002Fissues\u002F&lt;n&gt;\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>lane\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>os\u003C\u002Fcode>, \u003Ccode>repo-commands\u003C\u002Fcode>, \u003Ccode>local-stack\u003C\u002Fcode>, \u003Ccode>task-record\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Side effects:\u003C\u002Fstrong> \u003Ccode>implement\u003C\u002Fcode> starts the implementing task.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. Keyed on the tool call: the same call sent twice decides once and returns the first answer. A different call on a decided recommendation is refused.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.decide_recommendation\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode> is missing.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>recommendation_not_pending:&lt;status&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Someone else already decided it. Only a \u003Ccode>pending\u003C\u002Fcode> recommendation can be decided.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>decision_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>decision\u003C\u002Fcode> is not one of the three.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>lane_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>actioned\u003C\u002Fcode> without a valid \u003Ccode>lane\u003C\u002Fcode>.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_record_uses_implement\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>actioned\u003C\u002Fcode> with lane \u003Ccode>task-record\u003C\u002Fcode>: decide \u003Ccode>implement\u003C\u002Fcode> instead.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>issue_url_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>actioned\u003C\u002Fcode> or \u003Ccode>implement\u003C\u002Fcode> without an issue or pull request URL.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000001&quot;,\n  &quot;decision&quot;: &quot;decline&quot;,\n  &quot;reason&quot;: &quot;Not reproduced on the source run&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000002&quot;,\n  &quot;decision&quot;: &quot;actioned&quot;,\n  &quot;reason&quot;: &quot;Covered by the retry change&quot;,\n  &quot;issueUrl&quot;: &quot;https:\u002F\u002Fgit.example.com\u002Facme\u002Fapp\u002Fissues\u002F12&quot;,\n  &quot;lane&quot;: &quot;os&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-mail-list\">\u003Ccode>os.mail_list\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>List the assigned member's inbox, newest first: metadata and a snippet, no bodies.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">List mail in the inbox of the member doing this run, newest first. Metadata and a snippet only, no bodies: read one with os.mail_read. Optional unreadOnly (only messages not yet opened), label (only mail carrying that label), handledState (only mail in that state), threadId (every mail in one conversation), search (only mail whose sender address or name, subject or text contains the words, any case), order (desc, the default, or asc), page and limit (default 25, max 200). Filters combine: label VIP with handledState unhandled lists only unhandled VIP mail. A full row is large: about 30 fit in one result. To work through a long backlog pass compact true, which returns only id, fromAddress, subject, receivedAt, labels, handledState, spamScore and spamFlag, so about 100 rows fit.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>unreadOnly\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only messages nobody has opened yet\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>label\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only mail carrying this label, e.g. VIP\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>handledState\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>unhandled\u003C\u002Fcode>, \u003Ccode>replied\u003C\u002Fcode>, \u003Ccode>skipped\u003C\u002Fcode>, \u003Ccode>snoozed\u003C\u002Fcode>, \u003Ccode>escalated\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only mail in this handled state\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>threadId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only mail in this conversation, from a row’s threadId\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>search\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only mail whose sender address or name, subject or text contains this, any case\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>order\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>desc\u003C\u002Fcode>, \u003Ccode>asc\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>By receivedAt. Default desc\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>page\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, at least 1\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>limit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, 1 to 200\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>compact\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only id, fromAddress, subject, receivedAt, labels, handledState, spamScore and spamFlag on each row\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cp>What chat reads, through \u003Ccode>os.use_tool\u003C\u002Fcode>:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">List mail in the inbox of one of the enterprise’s members, newest first. Pass id, the member’s id (os.directory lists them). Reading a member’s mailbox needs the person’s members:read; their own mailbox is os.my_mail_list. Metadata and a snippet only, no bodies: read one with os.mail_read, passing the same id and the mail’s id as emailId. Optional unreadOnly (only messages not yet opened), label (only mail carrying that label), handledState (only mail in that state), threadId (every mail in one conversation), search (only mail whose sender address or name, subject or text contains the words, any case), order (desc, the default, or asc), page and limit (default 25, max 200). Filters combine: label VIP with handledState unhandled lists only unhandled VIP mail. Pass compact true to get only id, fromAddress, subject, receivedAt, labels, handledState, spamScore and spamFlag on each row, so many more rows fit.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The member whose mailbox, by id, as os.directory lists them\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>unreadOnly\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only messages nobody has opened yet\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>label\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only mail carrying this label, e.g. VIP\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>handledState\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>unhandled\u003C\u002Fcode>, \u003Ccode>replied\u003C\u002Fcode>, \u003Ccode>skipped\u003C\u002Fcode>, \u003Ccode>snoozed\u003C\u002Fcode>, \u003Ccode>escalated\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only mail in this handled state\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>threadId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only mail in this conversation, from a row’s threadId\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>search\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only mail whose sender address or name, subject or text contains this, any case\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>order\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>desc\u003C\u002Fcode>, \u003Ccode>asc\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>By receivedAt. Default desc\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>page\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, at least 1\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>limit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, 1 to 200\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>compact\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only id, fromAddress, subject, receivedAt, labels, handledState, spamScore and spamFlag on each row\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API, the CEO chat.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Needs:\u003C\u002Fstrong>\n\u003Cul>\n\u003Cli>The run's assigned member. The mailbox is always theirs: a \u003Ccode>memberId\u003C\u002Fcode> in the payload is ignored, and an OS-owned task has no mailbox.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ data, total, page, limit, pages }\u003C\u002Fcode>. Each row has \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>fromAddress\u003C\u002Fcode>, \u003Ccode>fromName\u003C\u002Fcode>, \u003Ccode>subject\u003C\u002Fcode>, \u003Ccode>snippet\u003C\u002Fcode>, \u003Ccode>receivedAt\u003C\u002Fcode>, \u003Ccode>readAt\u003C\u002Fcode>, \u003Ccode>hasAttachments\u003C\u002Fcode>, \u003Ccode>threadKey\u003C\u002Fcode> (the same on every message in one conversation), \u003Ccode>direction\u003C\u002Fcode> (\u003Ccode>inbound\u003C\u002Fcode> when it arrived, \u003Ccode>outbound\u003C\u002Fcode> when the member sent it), \u003Ccode>to\u003C\u002Fcode>, \u003Ccode>cc\u003C\u002Fcode>, \u003Ccode>bcc\u003C\u002Fcode> (who a mail the mailbox sent went to unseen, \u003Ccode>[]\u003C\u002Fcode> on everything else), \u003Ccode>threadId\u003C\u002Fcode>, \u003Ccode>labels\u003C\u002Fcode> (free text, \u003Ccode>[]\u003C\u002Fcode> when none), \u003Ccode>handledState\u003C\u002Fcode> (\u003Ccode>unhandled\u003C\u002Fcode>, \u003Ccode>replied\u003C\u002Fcode>, \u003Ccode>skipped\u003C\u002Fcode>, \u003Ccode>snoozed\u003C\u002Fcode> or \u003Ccode>escalated\u003C\u002Fcode>) and \u003Ccode>snoozedUntil\u003C\u002Fcode> (only when \u003Ccode>snoozed\u003C\u002Fcode>), \u003Ccode>spamScore\u003C\u002Fcode> and \u003Ccode>spamFlag\u003C\u002Fcode> (null if the receiving edge has not scored the message). With \u003Ccode>compact\u003C\u002Fcode>, each row has only \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>fromAddress\u003C\u002Fcode>, \u003Ccode>subject\u003C\u002Fcode>, \u003Ccode>receivedAt\u003C\u002Fcode>, \u003Ccode>labels\u003C\u002Fcode>, \u003Ccode>handledState\u003C\u002Fcode>, \u003Ccode>spamScore\u003C\u002Fcode> and \u003Ccode>spamFlag\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fmembers\u002F:id\u002Femails\u003C\u002Fcode> (\u003Ccode>members:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_assigned_member\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run has no assigned member, so no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>member_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run's member no longer exists.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>handled_state_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>handledState is not one of the handled states.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;unreadOnly&quot;: true,\n  &quot;limit&quot;: 10\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;handledState&quot;: &quot;unhandled&quot;,\n  &quot;order&quot;: &quot;asc&quot;,\n  &quot;compact&quot;: true,\n  &quot;limit&quot;: 100\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-mail-read\">\u003Ccode>os.mail_read\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Read one message from the assigned member's inbox.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Read one message from the assigned member’s inbox: sender, subject, text and sanitised HTML bodies, and attachment names (not their contents). Reading marks it read for the member too. Pass id from os.mail_list.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>A message id from os.mail_list\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cp>What chat reads, through \u003Ccode>os.use_tool\u003C\u002Fcode>:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Read one message from the inbox of one of the enterprise’s members: sender, subject, text and sanitised HTML bodies, and attachment names (not their contents). Pass id, the member’s id, and emailId, the message’s id from os.mail_list. Reading a member’s mailbox needs the person’s members:read; their own mailbox is os.my_mail_read. Reading marks it read for the member, the same as opening it in the portal.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The member whose mailbox, by id, as os.directory lists them\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>emailId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>A message id from os.mail_list\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Side effects:\u003C\u002Fstrong> Marks the message read for the member, the same as opening it in the portal.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API, the CEO chat.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Needs:\u003C\u002Fstrong>\n\u003Cul>\n\u003Cli>The run's assigned member. The mailbox is always theirs: a \u003Ccode>memberId\u003C\u002Fcode> in the payload is ignored, and an OS-owned task has no mailbox.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The message: sender, subject, \u003Ccode>textBody\u003C\u002Fcode>, sanitised \u003Ccode>htmlBody\u003C\u002Fcode>, \u003Ccode>receivedAt\u003C\u002Fcode>, \u003Ccode>readAt\u003C\u002Fcode>, \u003Ccode>attachments\u003C\u002Fcode> (names and sizes, not contents), \u003Ccode>to\u003C\u002Fcode>, \u003Ccode>cc\u003C\u002Fcode>, \u003Ccode>bcc\u003C\u002Fcode> (who a mail the mailbox sent went to unseen, \u003Ccode>[]\u003C\u002Fcode> on everything else), \u003Ccode>threadId\u003C\u002Fcode>, \u003Ccode>labels\u003C\u002Fcode> (free text, \u003Ccode>[]\u003C\u002Fcode> when none), \u003Ccode>handledState\u003C\u002Fcode> (\u003Ccode>unhandled\u003C\u002Fcode>, \u003Ccode>replied\u003C\u002Fcode>, \u003Ccode>skipped\u003C\u002Fcode>, \u003Ccode>snoozed\u003C\u002Fcode> or \u003Ccode>escalated\u003C\u002Fcode>) and \u003Ccode>snoozedUntil\u003C\u002Fcode> (only when \u003Ccode>snoozed\u003C\u002Fcode>), \u003Ccode>spamScore\u003C\u002Fcode> and \u003Ccode>spamFlag\u003C\u002Fcode> (null if the receiving edge has not scored the message).\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fmembers\u002F:id\u002Femails\u002F:emailId\u003C\u002Fcode> (\u003Ccode>members:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_assigned_member\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run has no assigned member, so no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>member_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run's member no longer exists.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>email_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The id is not in this member's mailbox, including another member's message.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000003&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-mail-reply\">\u003Ccode>os.mail_reply\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Reply to a stored mail using its mailbox reply identity, once the CEO approves.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Reply to one message in the assigned member’s inbox. Pass id from os.mail_list and the reply. Write the body as `markdown`; the OS sends it formatted with a plain-text copy, and raw HTML in it is not passed through. Or pass text, with optional html for a body you formatted yourself, as before; give markdown or text, not both, and never markdown with html. The subject is taken from the message being answered. It goes to the sender of the message being answered. Pass replyAll true to answer everyone on the original too: everyone else on its To and Cc is copied in, but for this mailbox’s own addresses. Optional cc and bcc, each one address or a list, copy in more people, seen or unseen; 50 addresses at most in all. Replies use the arrival address unless its alias is configured to reply from the member’s primary address. Both addresses must still belong to this mailbox. The reply threads under the original in the recipient’s mail client. When the mailbox has a signature, the OS adds it after the body, in text and html, before the approval card opens; pass signature false to send without it. The OS then quotes the message being answered below the signature, under an `On &lt;date&gt;, &lt;name&gt; wrote:` line, as `&gt;` lines in text and a blockquote in html, also before the approval card opens; pass quote false to send without it. Every send waits for the CEO to approve this exact payload, signature, quote and every recipient included (a reply-all names everyone it copies in, in cc, before the approval card opens), and approval sends that and nothing else. The sent reply is filed in the member’s mailbox in the original’s thread, and the original is marked read and moves to handled state replied.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>A message id from os.mail_list: the mail this answers\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>markdown\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The body in Markdown: headings, emphasis, lists, links, quotes, code and tables. The OS sends it formatted, with a plain-text copy. Give this or text, not both\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>text\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The reply, as plain text, when not given as markdown\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>html\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Optional HTML body beside text. Plain text is sent either way\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>replyAll\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>true answers everyone on the original: its sender, and everyone else on its To and Cc but this mailbox\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>cc\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string or array of string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>More people to copy in, seen by every recipient: one address or a list\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>bcc\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string or array of string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>People sent the reply that no other recipient sees: one address or a list\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>signature\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>false sends without the mailbox’s signature. Left out, the OS adds it after the body\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>quote\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>false sends without the original quoted below. Left out, the OS quotes the message being answered after the body and signature\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Side effects:\u003C\u002Fstrong> Files the sent reply in the member’s mailbox, in the original’s thread, marks the original read and, once sent, moves it to handled state \u003Ccode>replied\u003C\u002Fcode> (clearing any snooze) and saves every recipient to the member’s contacts.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Not retry-safe: a repeat acts again. A repeat sends a second reply. Call it again only if the first reported a refusal.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Needs:\u003C\u002Fstrong>\n\u003Cul>\n\u003Cli>A gate: the CEO decides every call, whatever the task declares.\u003C\u002Fli>\n\u003Cli>The gate offers Approve and Reject, and beside them these choices. Stop Chasing (\u003Ccode>stop_chasing\u003C\u002Fcode>): Send nothing and mark this thread complete. Future chase passes skip it.\u003C\u002Fli>\n\u003Cli>The run's assigned member. The mailbox is always theirs: a \u003Ccode>memberId\u003C\u002Fcode> in the payload is ignored, and an OS-owned task has no mailbox.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ status, id }\u003C\u002Fcode>: \u003Ccode>sent\u003C\u002Fcode>, or \u003Ccode>send_failed\u003C\u002Fcode> with the provider’s \u003Ccode>error\u003C\u002Fcode> when it did not go out. \u003Ccode>id\u003C\u002Fcode> is the copy filed in the mailbox either way.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.mail_reply\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_assigned_member\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run has no assigned member, so no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>member_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run's member no longer exists.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>email_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The id is not in this member's mailbox, including another member's message.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>mail_field_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Neither markdown nor text says anything.\u003C\u002Ftd>\n\u003Ctd>Handed back\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>mail_body_conflict\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>markdown was given with text or with html.\u003C\u002Ftd>\n\u003Ctd>Handed back\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>recipient_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The stored message names no address that can be replied to, or an address in cc or bcc is not an email address. The error names the address.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>too_many_recipients\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The reply would go to more than 50 addresses in all, everyone a reply-all copies in counted.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>sender_not_own_mailbox\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The address the original arrived at does not deliver to this member's mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>gate_summary_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run has not written the recipient and gist the CEO should read on the approval card.\u003C\u002Ftd>\n\u003Ctd>Handed back\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000003&quot;,\n  &quot;markdown&quot;: &quot;Thursday at **10:00** works.&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000003&quot;,\n  &quot;replyAll&quot;: true,\n  &quot;markdown&quot;: &quot;Thursday at **10:00** works for all of us.&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-mail-send\">\u003Ccode>os.mail_send\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Send a new mail from the assigned member’s mailbox, once the CEO approves.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Send a new message from the assigned member’s mailbox: to, subject and the body. to, cc and bcc each take one address or a list of them. Everyone in to and cc sees who else the mail went to; nobody sees bcc. An address named twice gets one copy, and a mail goes to at most 50 addresses in all. Write the body as `markdown`; the OS sends it formatted with a plain-text copy, and raw HTML in it is not passed through. Or pass text, with optional html for a body you formatted yourself, as before; give markdown or text, not both, and never markdown with html. It goes out from the member’s own address unless from names another address that delivers to the same mailbox — any other sender is refused, whatever the payload says. When the mailbox has a signature, the OS adds it after the body, in text and html, before the approval card opens; pass signature false to send without it. Every send waits for the CEO to approve this exact payload, signature and every recipient included, and approval sends that and nothing else. The sent message is filed in the member’s mailbox. To answer a message already in the inbox, use os.mail_reply instead, so it threads.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>to\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string or array of string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>Who the mail is to: one email address, or a list\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>cc\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string or array of string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Who is copied in, seen by every recipient: one address or a list\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>bcc\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string or array of string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Who is sent the mail unseen by any other recipient: one address or a list\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>subject\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>markdown\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The body in Markdown: headings, emphasis, lists, links, quotes, code and tables. The OS sends it formatted, with a plain-text copy. Give this or text, not both\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>text\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The message, as plain text, when not given as markdown\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>html\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Optional HTML body beside text. Plain text is sent either way\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>from\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Another address that delivers to this member’s mailbox. Defaults to their own\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>signature\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>false sends without the mailbox’s signature. Left out, the OS adds it after the body\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Side effects:\u003C\u002Fstrong> Files the sent message in the member’s mailbox, every recipient on it, and, once sent, saves every recipient to its contacts.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Not retry-safe: a repeat acts again. A repeat sends a second message. Call it again only if the first reported a refusal.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Needs:\u003C\u002Fstrong>\n\u003Cul>\n\u003Cli>A gate: the CEO decides every call, whatever the task declares.\u003C\u002Fli>\n\u003Cli>The run's assigned member. The mailbox is always theirs: a \u003Ccode>memberId\u003C\u002Fcode> in the payload is ignored, and an OS-owned task has no mailbox.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ status, id }\u003C\u002Fcode>: \u003Ccode>sent\u003C\u002Fcode>, or \u003Ccode>send_failed\u003C\u002Fcode> with the provider’s \u003Ccode>error\u003C\u002Fcode> when it did not go out. \u003Ccode>id\u003C\u002Fcode> is the copy filed in the mailbox either way.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.mail_send\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_assigned_member\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run has no assigned member, so no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>member_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run's member no longer exists.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>mail_field_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Neither markdown nor text says anything.\u003C\u002Ftd>\n\u003Ctd>Handed back\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>mail_body_conflict\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>markdown was given with text or with html.\u003C\u002Ftd>\n\u003Ctd>Handed back\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>recipient_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An address in to, cc or bcc is not an email address, or to names nobody. The error names the address.\u003C\u002Ftd>\n\u003Ctd>Handed back\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>too_many_recipients\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>to, cc and bcc name more than 50 addresses in all.\u003C\u002Ftd>\n\u003Ctd>Handed back\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>sender_not_own_mailbox\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>from\u003C\u002Fcode> names an address that does not deliver to this member's mailbox. Leave \u003Ccode>from\u003C\u002Fcode> out to send from the member's own address.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;to&quot;: &quot;vip@acme.com&quot;,\n  &quot;subject&quot;: &quot;Thursday&quot;,\n  &quot;markdown&quot;: &quot;Thursday at **10:00** works for the CEO.&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;to&quot;: [\n    &quot;vip@acme.com&quot;,\n    &quot;ops@acme.com&quot;\n  ],\n  &quot;cc&quot;: &quot;assistant@acme.com&quot;,\n  &quot;subject&quot;: &quot;Thursday&quot;,\n  &quot;markdown&quot;: &quot;Thursday at **10:00** works for the CEO.&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-mail-contacts\">\u003Ccode>os.mail_contacts\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>List or search the assigned member's contacts: the people its mailbox has written to, and those added.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">List the contacts of the assigned member’s mailbox: everyone a send or reply from it went to, saved once it left, and everyone added by hand. Most recently written to first, then by name. Pass search to keep only contacts whose name or address contains it, any case: to mail Sarah from Acme, search Sarah or acme and use the address it returns in os.mail_send. Pass directory true to add the enterprise’s own people and members who have an address, after the contacts and each only once. limit is how many rows (default 50, max 200). Mail that arrived never makes a contact.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>search\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only contacts whose name or address contains this, any case\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>directory\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Also offer the enterprise’s own people and members who have an address\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>limit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, 1 to 200\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Rows to return. Default 50\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Needs:\u003C\u002Fstrong>\n\u003Cul>\n\u003Cli>The run's assigned member. The mailbox is always theirs: a \u003Ccode>memberId\u003C\u002Fcode> in the payload is ignored, and an OS-owned task has no mailbox.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ data }\u003C\u002Fcode>: each contact with \u003Ccode>id\u003C\u002Fcode> (null on a directory row), \u003Ccode>address\u003C\u002Fcode>, \u003Ccode>name\u003C\u002Fcode> (empty when none is known), \u003Ccode>source\u003C\u002Fcode> (\u003Ccode>auto\u003C\u002Fcode> when a send saved it, \u003Ccode>manual\u003C\u002Fcode> when it was added by hand, \u003Ccode>directory\u003C\u002Fcode> for one of the enterprise’s own people or members offered beside the contacts), \u003Ccode>nameByHand\u003C\u002Fcode> (a name set by hand, which no later send replaces), \u003Ccode>mailCount\u003C\u002Fcode> and \u003Ccode>lastMailedAt\u003C\u002Fcode> (null until the mailbox first writes to it).\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.mail_contacts\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_assigned_member\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run has no assigned member, so no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>member_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run's member no longer exists.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>contact_search_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>search is not text, or is longer than 200 characters.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>contact_limit_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>limit is not a whole number from 1 to 200.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;search&quot;: &quot;sarah&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;search&quot;: &quot;acme&quot;,\n  &quot;directory&quot;: true,\n  &quot;limit&quot;: 10\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-mail-contact-save\">\u003Ccode>os.mail_contact_save\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Add a contact to the assigned member's mailbox, or name one already there.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Save an address to the contacts of the assigned member’s mailbox. Pass address and, optionally, name. A new address is added as one saved by hand; an address already among the contacts keeps its history and takes the name when one is given. A name set here is kept: a later send never replaces it. Leave name out to keep the name a contact already has. It only records the contact, and sends nothing.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>address\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The contact’s email address\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>name\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The name the contact goes by. Kept over any a later send carries\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Needs:\u003C\u002Fstrong>\n\u003Cul>\n\u003Cli>The run's assigned member. The mailbox is always theirs: a \u003Ccode>memberId\u003C\u002Fcode> in the payload is ignored, and an OS-owned task has no mailbox.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The contact saved, with \u003Ccode>id\u003C\u002Fcode> (null on a directory row), \u003Ccode>address\u003C\u002Fcode>, \u003Ccode>name\u003C\u002Fcode> (empty when none is known), \u003Ccode>source\u003C\u002Fcode> (\u003Ccode>auto\u003C\u002Fcode> when a send saved it, \u003Ccode>manual\u003C\u002Fcode> when it was added by hand, \u003Ccode>directory\u003C\u002Fcode> for one of the enterprise’s own people or members offered beside the contacts), \u003Ccode>nameByHand\u003C\u002Fcode> (a name set by hand, which no later send replaces), \u003Ccode>mailCount\u003C\u002Fcode> and \u003Ccode>lastMailedAt\u003C\u002Fcode> (null until the mailbox first writes to it).\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.mail_contact_save\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_assigned_member\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run has no assigned member, so no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>member_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run's member no longer exists.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>contact_address_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>address is not one email address.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>contact_name_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>name is not text, or is longer than 200 characters.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;address&quot;: &quot;sarah@acme.com&quot;,\n  &quot;name&quot;: &quot;Sarah Jones&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-member-mailbox-actions\">\u003Ccode>os.member_mailbox_actions\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>List the one-click buttons a member's mailbox offers: the tasks that declare a mailbox action and run as a role the member holds.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">List the one-click buttons a member’s mailbox offers, as the member’s page shows them: each an active task of the enterprise whose current version declares a mailbox action (mailboxAction) and that runs as a role this member holds, since those are the runs that read the member’s mailbox. on says where the button sits: mailbox, over the whole mailbox, or mail, on one message. Start one with os.start_task by its taskId; for a button on one message pass the message’s id as the emailId input. The run reads the member’s mailbox as its tasks always have. Pass id, the member’s id. A member in another enterprise, or one holding no such role, offers nothing.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The member’s id\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ actions }\u003C\u002Fcode>: each \u003Ccode>{ taskId, catalogTaskId, slug, name, label, on }\u003C\u002Fcode>, \u003Ccode>taskId\u003C\u002Fcode> always set here, by label.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fmembers\u002F:id\u002Fmailbox-actions\u003C\u002Fcode> (\u003Ccode>members:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000031&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-mail-set-label\">\u003Ccode>os.mail_set_label\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Set the labels on a mail in the assigned member’s inbox.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Set the labels triage gives one message in the assigned member’s inbox. Pass id from os.mail_list and labels, the whole set the mail should carry: it replaces whatever labels it had, and an empty list clears them. Labels are free text (e.g. VIP, Needs reply); there is no fixed list to choose from. List mail by label with os.mail_list.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>A message id from os.mail_list\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>labels\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>Every label the mail should carry. Replaces the current set\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Needs:\u003C\u002Fstrong>\n\u003Cul>\n\u003Cli>The run's assigned member. The mailbox is always theirs: a \u003Ccode>memberId\u003C\u002Fcode> in the payload is ignored, and an OS-owned task has no mailbox.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ id, labels }\u003C\u002Fcode>: the mail and the labels it now carries.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.mail_set_label\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_assigned_member\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run has no assigned member, so no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>member_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run's member no longer exists.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>email_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The id is not in this member's mailbox, including another member's message.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>labels_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>labels is not a list of non-empty strings of at most 64 characters.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000003&quot;,\n  &quot;labels&quot;: [\n    &quot;VIP&quot;\n  ]\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-mail-set-handled\">\u003Ccode>os.mail_set_handled\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Record whether a mail in the assigned member’s inbox has been handled.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Record where one message in the assigned member’s inbox stands. Pass id from os.mail_list and handledState: unhandled, replied, skipped, snoozed or escalated. A mail is in one state at a time. snoozed needs snoozedUntil, the date and time it comes back (ISO 8601); every other state takes no date and clears any snooze. os.mail_reply moves the mail it answers to replied on its own.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>A message id from os.mail_list\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>handledState\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>unhandled\u003C\u002Fcode>, \u003Ccode>replied\u003C\u002Fcode>, \u003Ccode>skipped\u003C\u002Fcode>, \u003Ccode>snoozed\u003C\u002Fcode>, \u003Ccode>escalated\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>snoozedUntil\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>ISO 8601 date and time the mail comes back. Only with handledState snoozed\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Needs:\u003C\u002Fstrong>\n\u003Cul>\n\u003Cli>The run's assigned member. The mailbox is always theirs: a \u003Ccode>memberId\u003C\u002Fcode> in the payload is ignored, and an OS-owned task has no mailbox.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ id, handledState, snoozedUntil }\u003C\u002Fcode>: the state the mail is now in.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.mail_set_handled\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_assigned_member\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run has no assigned member, so no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>member_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run's member no longer exists.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>email_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The id is not in this member's mailbox, including another member's message.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>handled_state_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>handledState is not one of the handled states.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>snoozed_until_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>handledState is snoozed and snoozedUntil is missing or not a date.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>snoozed_until_not_allowed\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>snoozedUntil was given with a handledState other than snoozed.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000003&quot;,\n  &quot;handledState&quot;: &quot;snoozed&quot;,\n  &quot;snoozedUntil&quot;: &quot;2026-10-01T09:00:00Z&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-mail-set-many\">\u003Ccode>os.mail_set_many\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Set the labels, the handled state, or both on many mails in the assigned member’s inbox at once.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Record the same triage decision on many messages in the assigned member’s inbox in one call. Name the mail one way: ids (up to 200 message ids from os.mail_list), or fromAddress (every unhandled mail that arrived from that exact sender address; mail already handled and mail the member sent are never touched). Then pass labels (the whole set each mail should carry, replacing what it had), handledState (unhandled, replied, skipped, snoozed or escalated; snoozed needs snoozedUntil), or both. Use it to close a run of look-alike mail without reading each one. An id that is not in this mailbox changes nothing and comes back in notFound.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>ids\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of string, at least 1\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Up to 200 message ids from os.mail_list. Not together with fromAddress\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>fromAddress\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>A sender address, matched exactly: every unhandled mail that arrived from it. Not together with ids\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>labels\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Every label each mail should carry. Replaces the current set\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>handledState\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>unhandled\u003C\u002Fcode>, \u003Ccode>replied\u003C\u002Fcode>, \u003Ccode>skipped\u003C\u002Fcode>, \u003Ccode>snoozed\u003C\u002Fcode>, \u003Ccode>escalated\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>snoozedUntil\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>ISO 8601 date and time the mail comes back. Only with handledState snoozed\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Needs:\u003C\u002Fstrong>\n\u003Cul>\n\u003Cli>The run's assigned member. The mailbox is always theirs: a \u003Ccode>memberId\u003C\u002Fcode> in the payload is ignored, and an OS-owned task has no mailbox.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ updated, notFound }\u003C\u002Fcode>: how many mails were changed, and the ids given that are not in this mailbox (always \u003Ccode>[]\u003C\u002Fcode> when selecting by \u003Ccode>fromAddress\u003C\u002Fcode>).\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.mail_set_many\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_assigned_member\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run has no assigned member, so no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>member_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run's member no longer exists.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>mail_selector_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Neither ids nor fromAddress was given, or both were.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>mail_ids_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>ids is not a list of 1 to 200 non-empty message ids.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>mail_change_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Neither labels nor handledState was given, so there is nothing to record.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>labels_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>labels is not a list of non-empty strings of at most 64 characters.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>handled_state_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>handledState is not one of the handled states.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>snoozed_until_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>handledState is snoozed and snoozedUntil is missing or not a date.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>snoozed_until_not_allowed\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>snoozedUntil was given with a handledState other than snoozed.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;fromAddress&quot;: &quot;updates@example.com&quot;,\n  &quot;labels&quot;: [\n    &quot;Newsletter&quot;\n  ],\n  &quot;handledState&quot;: &quot;skipped&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;ids&quot;: [\n    &quot;5f0c1d2e-0000-4000-8000-000000000003&quot;,\n    &quot;5f0c1d2e-0000-4000-8000-000000000004&quot;\n  ],\n  &quot;handledState&quot;: &quot;skipped&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-mail-quiet-threads\">\u003Ccode>os.mail_quiet_threads\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>The threads the assigned member replied to that have gone quiet, oldest first, at most ten.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">List the conversations in the assigned member’s mailbox where the member had the last word and the correspondent has not answered for three clear weekdays, counted in the enterprise’s timezone. A thread already chased or snoozed today, one snoozed until a later date, and one whose original names no address a reply could go to are left out, so every row is one to act on today. At most the ten oldest.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Takes no arguments: no fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Needs:\u003C\u002Fstrong>\n\u003Cul>\n\u003Cli>The run's assigned member. The mailbox is always theirs: a \u003Ccode>memberId\u003C\u002Fcode> in the payload is ignored, and an OS-owned task has no mailbox.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ data }\u003C\u002Fcode>: each row has \u003Ccode>threadKey\u003C\u002Fcode>, \u003Ccode>replyToEmailId\u003C\u002Fcode> (the newest inbound message: pass it to os.mail_reply as \u003Ccode>id\u003C\u002Fcode>), \u003Ccode>correspondent\u003C\u002Fcode>, \u003Ccode>subject\u003C\u002Fcode> and \u003Ccode>lastOutboundAt\u003C\u002Fcode>. An empty list when nothing is quiet or the member has no mailbox.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.mail_quiet_threads\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_assigned_member\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run has no assigned member, so no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-mail-mark-chased\">\u003Ccode>os.mail_mark_chased\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Record that a quiet thread was answered today, so no second run today raises it again.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Record that one thread from os.mail_quiet_threads has been dealt with today. Call it before os.mail_reply on that thread: the reply waits for the CEO, and a second run the same day must not propose a second follow-up while the first is still waiting. The thread is offered again on a later weekday if it is still quiet.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>threadKey\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>A threadKey from os.mail_quiet_threads\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Side effects:\u003C\u002Fstrong> Stores when the thread was last chased on the member's chase record for it. Nothing is sent.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Needs:\u003C\u002Fstrong>\n\u003Cul>\n\u003Cli>The run's assigned member. The mailbox is always theirs: a \u003Ccode>memberId\u003C\u002Fcode> in the payload is ignored, and an OS-owned task has no mailbox.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ threadKey, chasedAt }\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.mail_mark_chased\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_assigned_member\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run has no assigned member, so no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>thread_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The threadKey names no conversation in this member's mailbox, including another member's.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;threadKey&quot;: &quot;&lt;0f1e2d3c@mail.example.com&gt;&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-mail-snooze\">\u003Ccode>os.mail_snooze\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Leave a quiet thread alone until a date, instead of drafting a follow-up.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Snooze one thread from os.mail_quiet_threads until a later date (YYYY-MM-DD or an ISO timestamp): it is not offered again until that date has passed or the member writes in the thread again, and it counts as dealt with today. Use it instead of a follow-up when chasing now would be premature. Nothing is sent.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>threadKey\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>A threadKey from os.mail_quiet_threads\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>until\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>When to raise it again: a date or timestamp after now\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Side effects:\u003C\u002Fstrong> Stores the snooze on the member's chase record for the thread. Nothing is sent.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Needs:\u003C\u002Fstrong>\n\u003Cul>\n\u003Cli>The run's assigned member. The mailbox is always theirs: a \u003Ccode>memberId\u003C\u002Fcode> in the payload is ignored, and an OS-owned task has no mailbox.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ threadKey, snoozedUntil }\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.mail_snooze\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_assigned_member\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run has no assigned member, so no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>thread_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The threadKey names no conversation in this member's mailbox, including another member's.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>snooze_until_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>until\u003C\u002Fcode> is not a date, or is not after now.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;threadKey&quot;: &quot;&lt;0f1e2d3c@mail.example.com&gt;&quot;,\n  &quot;until&quot;: &quot;2026-10-12&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-my-mail-list\">\u003Ccode>os.my_mail_list\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>List the mail in your own mailbox, newest first: metadata and a snippet, no bodies.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">List the mail in your own mailbox, newest first: the mailbox of the person who signed in or connected this app, in the enterprise this call is in, and never a member’s or anyone else’s. Metadata and a snippet only, no bodies: read one with os.my_mail_read. Optional unreadOnly (only messages not yet opened), label (only mail carrying that label), handledState (only mail in that state), threadId (every mail in one conversation), search (only mail whose sender address or name, subject or text contains the words, any case), order (desc, the default, or asc), page and limit (default 25, max 200). Filters combine: label VIP with handledState unhandled lists only unhandled VIP mail; search invoice with label Acme finds the Acme mail about an invoice. A full row is large: about 30 fit in one result. To work through a long backlog pass compact true, which returns only id, fromAddress, subject, receivedAt, labels, handledState, spamScore and spamFlag, so about 100 rows fit.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>unreadOnly\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only messages nobody has opened yet\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>label\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only mail carrying this label, e.g. VIP\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>handledState\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>unhandled\u003C\u002Fcode>, \u003Ccode>replied\u003C\u002Fcode>, \u003Ccode>skipped\u003C\u002Fcode>, \u003Ccode>snoozed\u003C\u002Fcode>, \u003Ccode>escalated\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only mail in this handled state\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>threadId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only mail in this conversation, from a row’s threadId\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>search\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only mail whose sender address or name, subject or text contains this, any case\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>order\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>desc\u003C\u002Fcode>, \u003Ccode>asc\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>By receivedAt. Default desc\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>page\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, at least 1\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The page of results, from 1\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>limit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, 1 to 200\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Rows per page. Default 25\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>compact\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only id, fromAddress, subject, receivedAt, labels, handledState, spamScore and spamFlag on each row\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ data, total, page, limit, pages }\u003C\u002Fcode>. Each row has \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>fromAddress\u003C\u002Fcode>, \u003Ccode>fromName\u003C\u002Fcode>, \u003Ccode>subject\u003C\u002Fcode>, \u003Ccode>snippet\u003C\u002Fcode>, \u003Ccode>receivedAt\u003C\u002Fcode>, \u003Ccode>readAt\u003C\u002Fcode>, \u003Ccode>hasAttachments\u003C\u002Fcode>, \u003Ccode>threadKey\u003C\u002Fcode> (the same on every message in one conversation), \u003Ccode>direction\u003C\u002Fcode> (\u003Ccode>inbound\u003C\u002Fcode> when it arrived, \u003Ccode>outbound\u003C\u002Fcode> when you sent it), \u003Ccode>to\u003C\u002Fcode>, \u003Ccode>cc\u003C\u002Fcode>, \u003Ccode>bcc\u003C\u002Fcode> (who a mail the mailbox sent went to unseen, \u003Ccode>[]\u003C\u002Fcode> on everything else), \u003Ccode>threadId\u003C\u002Fcode>, \u003Ccode>labels\u003C\u002Fcode> (free text, \u003Ccode>[]\u003C\u002Fcode> when none), \u003Ccode>handledState\u003C\u002Fcode> (\u003Ccode>unhandled\u003C\u002Fcode>, \u003Ccode>replied\u003C\u002Fcode>, \u003Ccode>skipped\u003C\u002Fcode>, \u003Ccode>snoozed\u003C\u002Fcode> or \u003Ccode>escalated\u003C\u002Fcode>) and \u003Ccode>snoozedUntil\u003C\u002Fcode> (only when \u003Ccode>snoozed\u003C\u002Fcode>), \u003Ccode>spamScore\u003C\u002Fcode> and \u003Ccode>spamFlag\u003C\u002Fcode> (null if the receiving edge has not scored the message). With \u003Ccode>compact\u003C\u002Fcode>, each row has only \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>fromAddress\u003C\u002Fcode>, \u003Ccode>subject\u003C\u002Fcode>, \u003Ccode>receivedAt\u003C\u002Fcode>, \u003Ccode>labels\u003C\u002Fcode>, \u003Ccode>handledState\u003C\u002Fcode>, \u003Ccode>spamScore\u003C\u002Fcode> and \u003Ccode>spamFlag\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fmail\u003C\u002Fcode> (\u003Ccode>mail:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>api_token_cannot_reach_mail\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An API token called it. A token belongs to the enterprise and to nobody, so it has no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>user_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The caller is no longer a member of the enterprise the call is in.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>handled_state_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>handledState is not one of the handled states.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;unreadOnly&quot;: true,\n  &quot;limit&quot;: 10\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;handledState&quot;: &quot;unhandled&quot;,\n  &quot;order&quot;: &quot;asc&quot;,\n  &quot;compact&quot;: true,\n  &quot;limit&quot;: 100\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-my-mail-read\">\u003Ccode>os.my_mail_read\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Read one message from your own mailbox.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Read one message from your own mailbox: sender, subject, text and sanitised HTML bodies, and attachment names and sizes (fetch one with os.my_mail_attachment). Reading marks it read for you too. Pass id from os.my_mail_list; an id from anyone else’s mailbox is not found.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>A message id from os.my_mail_list\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Side effects:\u003C\u002Fstrong> Marks the message read for you, the same as opening it.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The message: sender, subject, \u003Ccode>textBody\u003C\u002Fcode>, sanitised \u003Ccode>htmlBody\u003C\u002Fcode>, \u003Ccode>receivedAt\u003C\u002Fcode>, \u003Ccode>readAt\u003C\u002Fcode>, \u003Ccode>attachments\u003C\u002Fcode> (each with \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>filename\u003C\u002Fcode>, \u003Ccode>contentType\u003C\u002Fcode> and \u003Ccode>sizeBytes\u003C\u002Fcode>, not contents), \u003Ccode>to\u003C\u002Fcode>, \u003Ccode>cc\u003C\u002Fcode>, \u003Ccode>bcc\u003C\u002Fcode> (who a mail the mailbox sent went to unseen, \u003Ccode>[]\u003C\u002Fcode> on everything else), \u003Ccode>threadId\u003C\u002Fcode>, \u003Ccode>labels\u003C\u002Fcode> (free text, \u003Ccode>[]\u003C\u002Fcode> when none), \u003Ccode>handledState\u003C\u002Fcode> (\u003Ccode>unhandled\u003C\u002Fcode>, \u003Ccode>replied\u003C\u002Fcode>, \u003Ccode>skipped\u003C\u002Fcode>, \u003Ccode>snoozed\u003C\u002Fcode> or \u003Ccode>escalated\u003C\u002Fcode>) and \u003Ccode>snoozedUntil\u003C\u002Fcode> (only when \u003Ccode>snoozed\u003C\u002Fcode>), \u003Ccode>spamScore\u003C\u002Fcode> and \u003Ccode>spamFlag\u003C\u002Fcode> (null if the receiving edge has not scored the message).\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fmail\u002F:id\u003C\u002Fcode> (\u003Ccode>mail:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>api_token_cannot_reach_mail\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An API token called it. A token belongs to the enterprise and to nobody, so it has no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>user_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The caller is no longer a member of the enterprise the call is in.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>email_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The id is not in the caller's own mailbox, including a member's mail and another person's.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000003&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-my-mail-attachment\">\u003Ccode>os.my_mail_attachment\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Fetch one attachment of a message in your own mailbox, base64-encoded.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Fetch one attachment of a message in your own mailbox, as its file name, content type, size and base64-encoded bytes. Pass id, a message id from os.my_mail_list, and attachmentId from that message’s attachments in os.my_mail_read. A file over 4 MB is refused here: download it from the API instead (GET \u002Fv1\u002Fmail\u002F{id}\u002Fattachments\u002F{attachmentId} without format=json streams the bytes).\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>A message id from os.my_mail_list\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>attachmentId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>An attachment id from os.my_mail_read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ filename, contentType, sizeBytes, base64 }\u003C\u002Fcode>: the file, encoded.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fmail\u002F:id\u002Fattachments\u002F:attachmentId?format=json\u003C\u002Fcode> (\u003Ccode>mail:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>api_token_cannot_reach_mail\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An API token called it. A token belongs to the enterprise and to nobody, so it has no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>user_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The caller is no longer a member of the enterprise the call is in.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>email_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The id is not in the caller's own mailbox, including a member's mail and another person's.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>attachment_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The message has no attachment with that id.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>attachment_too_large\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The file is over 4 MB, more than a tool result carries. Download it from the API instead.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000003&quot;,\n  &quot;attachmentId&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000009&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-my-mail-set-label\">\u003Ccode>os.my_mail_set_label\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Set the labels on a message in your own mailbox.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Set the labels on one message in your own mailbox. Pass id from os.my_mail_list and labels, the whole set the mail should carry: it replaces whatever labels it had, and an empty list clears them. Labels are free text (e.g. VIP, Needs reply); there is no fixed list to choose from. List mail by label with os.my_mail_list.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>A message id from os.my_mail_list\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>labels\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>Every label the mail should carry. Replaces the current set\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ id, labels }\u003C\u002Fcode>: the mail and the labels it now carries.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>PATCH \u002Fv1\u002Fmail\u002F:id\u002Flabels\u003C\u002Fcode> (\u003Ccode>mail:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>api_token_cannot_reach_mail\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An API token called it. A token belongs to the enterprise and to nobody, so it has no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>user_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The caller is no longer a member of the enterprise the call is in.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>email_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The id is not in the caller's own mailbox, including a member's mail and another person's.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>labels_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>labels is not a list of non-empty strings of at most 64 characters.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000003&quot;,\n  &quot;labels&quot;: [\n    &quot;VIP&quot;\n  ]\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-my-mail-set-handled\">\u003Ccode>os.my_mail_set_handled\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Record where a message in your own mailbox stands: unhandled, replied, skipped, or snoozed until a date.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Record where one message in your own mailbox stands. Pass id from os.my_mail_list and handledState: unhandled, replied, skipped or snoozed. A mail is in one state at a time. snoozed needs snoozedUntil, the date and time it comes back (ISO 8601); every other state takes no date and clears any snooze. escalated is a member’s state, raised to the enterprise owner: your mail has nobody to raise to, so it is refused. os.my_mail_reply moves the mail it answers to replied on its own.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>A message id from os.my_mail_list\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>handledState\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>unhandled\u003C\u002Fcode>, \u003Ccode>replied\u003C\u002Fcode>, \u003Ccode>skipped\u003C\u002Fcode>, \u003Ccode>snoozed\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>Where the mail stands now\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>snoozedUntil\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>ISO 8601 date and time the mail comes back. Only with handledState snoozed\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ id, handledState, snoozedUntil }\u003C\u002Fcode>: the state the mail is now in.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>PATCH \u002Fv1\u002Fmail\u002F:id\u002Fhandled\u003C\u002Fcode> (\u003Ccode>mail:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>api_token_cannot_reach_mail\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An API token called it. A token belongs to the enterprise and to nobody, so it has no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>user_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The caller is no longer a member of the enterprise the call is in.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>email_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The id is not in the caller's own mailbox, including a member's mail and another person's.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>handled_state_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>handledState is not unhandled, replied, skipped or snoozed (escalated is a member’s state).\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>snoozed_until_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>handledState is snoozed and snoozedUntil is missing or not a date.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>snoozed_until_not_allowed\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>snoozedUntil was given with a handledState other than snoozed.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000003&quot;,\n  &quot;handledState&quot;: &quot;snoozed&quot;,\n  &quot;snoozedUntil&quot;: &quot;2026-11-03T09:00:00Z&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-my-mail-set-many\">\u003Ccode>os.my_mail_set_many\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Set the labels, the handled state, or both on many messages in your own mailbox at once.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Record the same decision on many messages in your own mailbox in one call. Name the mail one way: ids (up to 200 message ids from os.my_mail_list), or fromAddress (every unhandled mail that arrived from that exact sender address; mail already handled and mail you sent are never touched). Then pass labels (the whole set each mail should carry, replacing what it had), handledState (unhandled, replied, skipped or snoozed; snoozed needs snoozedUntil), or both. Use it to close a run of look-alike mail without reading each one. An id that is not in your mailbox changes nothing and comes back in notFound.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>ids\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Up to 200 message ids from os.my_mail_list. Not together with fromAddress\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>fromAddress\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>A sender address, matched exactly: every unhandled mail that arrived from it. Not together with ids\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>labels\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Every label each mail should carry. Replaces the current set\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>handledState\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>unhandled\u003C\u002Fcode>, \u003Ccode>replied\u003C\u002Fcode>, \u003Ccode>skipped\u003C\u002Fcode>, \u003Ccode>snoozed\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Where each mail stands now\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>snoozedUntil\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>ISO 8601 date and time the mail comes back. Only with handledState snoozed\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ updated, notFound }\u003C\u002Fcode>: how many mails were changed, and the ids given that are not in your mailbox (always \u003Ccode>[]\u003C\u002Fcode> when selecting by \u003Ccode>fromAddress\u003C\u002Fcode>).\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fmail\u002Ftriage\u003C\u002Fcode> (\u003Ccode>mail:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>api_token_cannot_reach_mail\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An API token called it. A token belongs to the enterprise and to nobody, so it has no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>user_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The caller is no longer a member of the enterprise the call is in.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>mail_selector_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Neither ids nor fromAddress was given, or both were.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>mail_ids_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>ids is not a list of 1 to 200 non-empty message ids.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>mail_change_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Neither labels nor handledState was given, so there is nothing to record.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>labels_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>labels is not a list of non-empty strings of at most 64 characters.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>handled_state_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>handledState is not unhandled, replied, skipped or snoozed (escalated is a member’s state).\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>snoozed_until_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>handledState is snoozed and snoozedUntil is missing or not a date.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>snoozed_until_not_allowed\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>snoozedUntil was given with a handledState other than snoozed.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;fromAddress&quot;: &quot;updates@example.com&quot;,\n  &quot;labels&quot;: [\n    &quot;Newsletter&quot;\n  ],\n  &quot;handledState&quot;: &quot;skipped&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;ids&quot;: [\n    &quot;5f0c1d2e-0000-4000-8000-000000000003&quot;,\n    &quot;5f0c1d2e-0000-4000-8000-000000000004&quot;\n  ],\n  &quot;handledState&quot;: &quot;skipped&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-my-mail-reply\">\u003Ccode>os.my_mail_reply\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Reply to a message in your own mailbox, from your own address, with no approval step.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Reply to one message in your own mailbox. Pass id from os.my_mail_list and the reply. Write the body as `markdown`; the OS sends it formatted with a plain-text copy, and raw HTML in it is not passed through. Or pass text, with optional html for a body you formatted yourself, as before; give markdown or text, not both, and never markdown with html. The subject comes from the message being answered, and the reply goes out from the address it arrived at, which has to be yours. It goes to the sender of the message being answered. Pass replyAll true to answer everyone on the original too: everyone else on its To and Cc is copied in, but for this mailbox’s own addresses. Optional cc and bcc, each one address or a list, copy in more people, seen or unseen; 50 addresses at most in all. Pass to, one address or a list, to send it to them in place of that sender; the subject, the address it leaves from and the threading still come from the original. With replyAll, anyone already in to is not copied in again. It threads under the original in the recipient’s mail client. Pass attachments to attach files: each by a public https link (url), by a file already on a mail in your mailbox (emailId and attachmentId), or inline as base64 for a small file. A mail carries up to 10 files, 7 MB together: a file past that, one that cannot be read or fetched, or an item that is not one is refused by name before anything leaves, and nothing is sent. Your signature, when you have set one, is added after the body; pass signature false to leave it off. The message you are answering is quoted below your reply and signature, under an `On &lt;date&gt;, &lt;name&gt; wrote:` line, as `&gt;` lines in text and a blockquote in html; pass quote false to leave it off. Your own mail is yours: nothing waits for anyone’s approval, and the message leaves in this call. The sent copy is filed in your mailbox in the original’s thread, listing the files it carried, and the original is marked read and moves to handled state replied.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>A message id from os.my_mail_list: the mail this answers\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>markdown\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The body in Markdown: headings, emphasis, lists, links, quotes, code and tables. The OS sends it formatted, with a plain-text copy. Give this or text, not both\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>text\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The reply, as plain text, when not given as markdown\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>html\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Optional HTML body beside text. Plain text is sent either way\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>to\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string or array of string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Who the reply goes to, in place of the sender of the message being answered: one address or a list. Left out, it goes to that sender\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>replyAll\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>true answers everyone on the original: its sender, and everyone else on its To and Cc but this mailbox\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>cc\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string or array of string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>More people to copy in, seen by every recipient: one address or a list\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>bcc\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string or array of string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>People sent the reply that no other recipient sees: one address or a list\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>attachments\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of object\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Optional files the reply carries: up to 10, 7 MB together. The message being answered’s own files are not attached unless you name them. Each item names one file in one of three ways: { url, filename?, contentType? }, a public https link the OS fetches, so a screenshot or any other hosted file is attached without writing out its bytes; { emailId, attachmentId, filename?, contentType? }, a file already on a mail in your mailbox, the ids as os.my_mail_read lists them; or { filename, contentType, base64 }, the bytes inline, for a small file. A link’s or a stored file’s filename and contentType are used unless you give your own; contentType is type\u002Fsubtype, such as image\u002Fpng. Refused whole, naming the file, before anything leaves: attachments_over_limit past the limits, attachment_unreadable for a stored file that is not in your mailbox or cannot be read, attachment_invalid for an item that is not one, attachment_link_refused for a link that is not a public https one or does not answer with the file\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>signature\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>false sends without your signature. Left out, the OS adds it when you have one\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>quote\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>false sends without the original quoted below. Left out, the OS quotes the message you are answering after the body and your signature\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Side effects:\u003C\u002Fstrong> Files the sent reply in your mailbox, in the original’s thread, marks the original read and, once sent, moves it to handled state \u003Ccode>replied\u003C\u002Fcode> (clearing any snooze) and saves every recipient to your contacts.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Not retry-safe: a repeat acts again. A repeat sends a second reply. Call it again only if the first reported a refusal.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ status, id }\u003C\u002Fcode>: \u003Ccode>sent\u003C\u002Fcode>, or \u003Ccode>send_failed\u003C\u002Fcode> with the provider’s \u003Ccode>error\u003C\u002Fcode> when it did not go out. \u003Ccode>id\u003C\u002Fcode> is the copy filed in your mailbox either way.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fmail\u002F:id\u002Freply\u003C\u002Fcode> (\u003Ccode>mail:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>api_token_cannot_reach_mail\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An API token called it. A token belongs to the enterprise and to nobody, so it has no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>user_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The caller is no longer a member of the enterprise the call is in.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>mail_field_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Neither markdown nor text says anything.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>mail_body_conflict\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>markdown was given with text or with html.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>email_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The id is not in the caller's own mailbox, including a member's mail and another person's.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_mail_address\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>You have no address in this enterprise yet, so nothing can leave as you. An owner gives one on People.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>recipient_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The stored message names no address that can be replied to, or an address in to, cc or bcc is not an email address. The error names the address.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>too_many_recipients\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The reply would go to more than 50 addresses in all, everyone a reply-all copies in counted.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>sender_not_own_mailbox\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The address the original arrived at is not yours, or its domain is not active for sending.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>sending_unavailable\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Sending from the enterprise’s own domain is not configured on this deployment.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>attachments_over_limit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>attachments name more than 10 files, or more than 7 MB together; the refusal names the files that do not fit, and nothing was sent.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>attachment_unreadable\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A file named by emailId and attachmentId is not on a mail in your mailbox, or could not be read; the refusal names it, and nothing was sent.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>attachment_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An item of attachments names no file or more than one, gives base64 without a filename or bytes that are not base64, or a contentType that is not type\u002Fsubtype; the refusal names it, and nothing was sent.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>attachment_link_refused\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A url is not https, points at an internal address (itself or through a redirect), does not answer in time, or answers with an error; the refusal names the link, and nothing was sent.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000003&quot;,\n  &quot;markdown&quot;: &quot;Thursday at **10:00** works.&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000003&quot;,\n  &quot;replyAll&quot;: true,\n  &quot;markdown&quot;: &quot;Thursday at **10:00** works for all of us.&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000003&quot;,\n  &quot;markdown&quot;: &quot;Fixed: the screenshot shows the new page, and the terms are attached again.&quot;,\n  &quot;attachments&quot;: [\n    {\n      &quot;url&quot;: &quot;https:\u002F\u002Ffiles.example.com\u002Fscreenshots\u002Ffixed.png&quot;\n    },\n    {\n      &quot;emailId&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000003&quot;,\n      &quot;attachmentId&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000009&quot;\n    }\n  ]\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-my-mail-send\">\u003Ccode>os.my_mail_send\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Send a new mail from your own address, with no approval step.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Send a new message from your own mailbox: to, subject and the body. to, cc and bcc each take one address or a list of them. Everyone in to and cc sees who else the mail went to; nobody sees bcc. An address named twice gets one copy, and a mail goes to at most 50 addresses in all. Write the body as `markdown`; the OS sends it formatted with a plain-text copy, and raw HTML in it is not passed through. Or pass text, with optional html for a body you formatted yourself, as before; give markdown or text, not both, and never markdown with html. It goes out from your own address in this enterprise, the one an owner gave you, or from one of your extra addresses when you name it as `from`. Pass attachments to attach files: each by a public https link (url), by a file already on a mail in your mailbox (emailId and attachmentId), or inline as base64 for a small file. A mail carries up to 10 files, 7 MB together: a file past that, one that cannot be read or fetched, or an item that is not one is refused by name before anything leaves, and nothing is sent. Your signature, when you have set one, is added after the body; pass signature false to leave it off. Your own mail is yours: nothing waits for anyone’s approval, and the message leaves in this call. The sent copy is filed in your mailbox, listing the files it carried. To answer a message already in your mailbox, use os.my_mail_reply instead, so it threads.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>to\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string or array of string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>Who the mail is to: one email address, or a list\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>cc\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string or array of string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Who is copied in, seen by every recipient: one address or a list\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>bcc\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string or array of string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Who is sent the mail unseen by any other recipient: one address or a list\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>subject\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The subject line\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>markdown\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The body in Markdown: headings, emphasis, lists, links, quotes, code and tables. The OS sends it formatted, with a plain-text copy. Give this or text, not both\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>text\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The message, as plain text, when not given as markdown\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>html\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Optional HTML body beside text. Plain text is sent either way\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>from\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Optional sender: one of your extra addresses in this enterprise. Left out, your own address is used\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>attachments\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of object\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Optional files the mail carries: up to 10, 7 MB together. Each item names one file in one of three ways: { url, filename?, contentType? }, a public https link the OS fetches, so a screenshot or any other hosted file is attached without writing out its bytes; { emailId, attachmentId, filename?, contentType? }, a file already on a mail in your mailbox, the ids as os.my_mail_read lists them; or { filename, contentType, base64 }, the bytes inline, for a small file. A link’s or a stored file’s filename and contentType are used unless you give your own; contentType is type\u002Fsubtype, such as image\u002Fpng. Refused whole, naming the file, before anything leaves: attachments_over_limit past the limits, attachment_unreadable for a stored file that is not in your mailbox or cannot be read, attachment_invalid for an item that is not one, attachment_link_refused for a link that is not a public https one or does not answer with the file\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>signature\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>false sends without your signature. Left out, the OS adds it when you have one\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Side effects:\u003C\u002Fstrong> Files the sent message in your mailbox, every recipient on it, and, once sent, saves every recipient to your contacts.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Not retry-safe: a repeat acts again. A repeat sends a second message. Call it again only if the first reported a refusal.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ status, id }\u003C\u002Fcode>: \u003Ccode>sent\u003C\u002Fcode>, or \u003Ccode>send_failed\u003C\u002Fcode> with the provider’s \u003Ccode>error\u003C\u002Fcode> when it did not go out. \u003Ccode>id\u003C\u002Fcode> is the copy filed in your mailbox either way.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fmail\u003C\u002Fcode> (\u003Ccode>mail:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>api_token_cannot_reach_mail\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An API token called it. A token belongs to the enterprise and to nobody, so it has no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>user_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The caller is no longer a member of the enterprise the call is in.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>mail_field_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Neither markdown nor text says anything.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>mail_body_conflict\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>markdown was given with text or with html.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_mail_address\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>You have no address in this enterprise yet, so nothing can leave as you. An owner gives one on People.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>recipient_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An address in to, cc or bcc is not an email address, or to names nobody. The error names the address.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>too_many_recipients\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>to, cc and bcc name more than 50 addresses in all.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>sender_not_own_mailbox\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Your address’s domain is not active for sending, or \u003Ccode>from\u003C\u002Fcode> is not an address you hold.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>sending_unavailable\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Sending from the enterprise’s own domain is not configured on this deployment.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>attachments_over_limit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>attachments name more than 10 files, or more than 7 MB together; the refusal names the files that do not fit, and nothing was sent.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>attachment_unreadable\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A file named by emailId and attachmentId is not on a mail in your mailbox, or could not be read; the refusal names it, and nothing was sent.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>attachment_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An item of attachments names no file or more than one, gives base64 without a filename or bytes that are not base64, or a contentType that is not type\u002Fsubtype; the refusal names it, and nothing was sent.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>attachment_link_refused\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A url is not https, points at an internal address (itself or through a redirect), does not answer in time, or answers with an error; the refusal names the link, and nothing was sent.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;to&quot;: &quot;vip@acme.com&quot;,\n  &quot;subject&quot;: &quot;Thursday&quot;,\n  &quot;markdown&quot;: &quot;Thursday at **10:00** works for me.&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;to&quot;: [\n    &quot;vip@acme.com&quot;,\n    &quot;ops@acme.com&quot;\n  ],\n  &quot;cc&quot;: &quot;assistant@acme.com&quot;,\n  &quot;subject&quot;: &quot;Thursday&quot;,\n  &quot;markdown&quot;: &quot;Thursday at **10:00** works for me.&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;to&quot;: &quot;support@acme.com&quot;,\n  &quot;subject&quot;: &quot;The error on checkout&quot;,\n  &quot;markdown&quot;: &quot;The screenshot shows the error.&quot;,\n  &quot;attachments&quot;: [\n    {\n      &quot;url&quot;: &quot;https:\u002F\u002Ffiles.example.com\u002Fscreenshots\u002Fcheckout-error.png&quot;\n    }\n  ]\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-my-mail-forward\">\u003Ccode>os.my_mail_forward\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Forward a message from your own mailbox to somebody else, from your own address, with no approval step.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Forward one message from your own mailbox to somebody else. Pass id from os.my_mail_list and to, who it goes to. to, cc and bcc each take one address or a list of them. Everyone in to and cc sees who else the mail went to; nobody sees bcc. An address named twice gets one copy, and a mail goes to at most 50 addresses in all. Optional markdown or text (not both) is a note placed above the forwarded message, sent formatted with a plain-text copy when written as markdown, and optional from is one of your extra addresses to send from. The new message carries the original under a forwarded-message line that says who wrote it and when: its text and, when it has HTML, its formatting, sanitised, with its pictures where they were; and the original’s files, its pictures among them, go with it. Pass attachments to add more files: each by a public https link (url), by a file already on a mail in your mailbox (emailId and attachmentId), or inline as base64 for a small file. The original’s files and yours count towards the 10 files, 7 MB a mail carries: past that, or when one of them cannot be read or fetched, or an item is not one, the forward is refused naming the files, and nothing is sent. Your signature, when you have set one, is added after your note and above the forwarded message; pass signature false to leave it off. Your own mail is yours: nothing waits for anyone’s approval, and the message leaves in this call. The sent copy is filed in your mailbox in the original’s thread, and the original is marked read; its handled state does not change.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>A message id from os.my_mail_list: the mail to pass on\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>to\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string or array of string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>Who the forward is to: one email address, or a list\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>cc\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string or array of string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Who is copied in, seen by every recipient: one address or a list\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>bcc\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string or array of string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Who is sent the forward unseen by any other recipient: one address or a list\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>markdown\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Optional note above the forwarded message, in Markdown. The OS sends it formatted, with a plain-text copy. Give this or text, not both\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>text\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Optional note above the forwarded message, as plain text\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>from\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Optional sender: one of your extra addresses in this enterprise. Left out, your own address is used\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>attachments\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of object\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Optional files added to the original’s, which go with the forward anyway: the original’s and these together up to 10 files, 7 MB. Each item names one file in one of three ways: { url, filename?, contentType? }, a public https link the OS fetches, so a screenshot or any other hosted file is attached without writing out its bytes; { emailId, attachmentId, filename?, contentType? }, a file already on a mail in your mailbox, the ids as os.my_mail_read lists them; or { filename, contentType, base64 }, the bytes inline, for a small file. A link’s or a stored file’s filename and contentType are used unless you give your own; contentType is type\u002Fsubtype, such as image\u002Fpng. Refused whole, naming the file, before anything leaves: attachments_over_limit past the limits, attachment_unreadable for a stored file that is not in your mailbox or cannot be read, attachment_invalid for an item that is not one, attachment_link_refused for a link that is not a public https one or does not answer with the file\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>signature\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>false sends without your signature. Left out, the OS adds it when you have one\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Side effects:\u003C\u002Fstrong> Files the forwarded message in your mailbox, in the original’s thread, marks the original read and, once sent, saves every recipient to your contacts.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Not retry-safe: a repeat acts again. A repeat forwards the message a second time. Call it again only if the first reported a refusal.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ status, id }\u003C\u002Fcode>: \u003Ccode>sent\u003C\u002Fcode>, or \u003Ccode>send_failed\u003C\u002Fcode> with the provider’s \u003Ccode>error\u003C\u002Fcode> when it did not go out. \u003Ccode>id\u003C\u002Fcode> is the copy filed in your mailbox either way.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fmail\u002F:id\u002Fforward\u003C\u002Fcode> (\u003Ccode>mail:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>api_token_cannot_reach_mail\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An API token called it. A token belongs to the enterprise and to nobody, so it has no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>user_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The caller is no longer a member of the enterprise the call is in.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>mail_body_conflict\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>markdown was given with text or with html.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>email_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The id is not in the caller's own mailbox, including a member's mail and another person's.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_mail_address\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>You have no address in this enterprise yet, so nothing can leave as you. An owner gives one on People.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>recipient_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An address in to, cc or bcc is not an email address, or to names nobody. The error names the address.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>too_many_recipients\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>to, cc and bcc name more than 50 addresses in all.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>sender_not_own_mailbox\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Your address’s domain is not active for sending, or \u003Ccode>from\u003C\u002Fcode> is not an address you hold.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>sending_unavailable\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Sending from the enterprise’s own domain is not configured on this deployment.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>attachments_over_limit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The original’s files and the attachments you add are past 10 files or 7 MB together; the refusal names the files that do not fit, and nothing was sent.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>attachment_unreadable\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>One of the original’s files could not be read, or a file named by emailId and attachmentId is not on a mail in your mailbox or could not be read; the refusal names it, and nothing was sent.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>attachment_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An item of attachments names no file or more than one, gives base64 without a filename or bytes that are not base64, or a contentType that is not type\u002Fsubtype; the refusal names it, and nothing was sent.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>attachment_link_refused\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A url is not https, points at an internal address (itself or through a redirect), does not answer in time, or answers with an error; the refusal names the link, and nothing was sent.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000003&quot;,\n  &quot;to&quot;: &quot;colleague@acme.com&quot;,\n  &quot;text&quot;: &quot;Can you take this one?&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000003&quot;,\n  &quot;to&quot;: &quot;colleague@acme.com&quot;,\n  &quot;text&quot;: &quot;Can you take this one? The screenshot shows where it fails.&quot;,\n  &quot;attachments&quot;: [\n    {\n      &quot;url&quot;: &quot;https:\u002F\u002Ffiles.example.com\u002Fscreenshots\u002Ffailure.png&quot;\n    }\n  ]\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-my-mail-delete\">\u003Ccode>os.my_mail_delete\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Delete a message from your own mailbox for good.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Delete one message from your own mailbox for good: the message, its attachments and their stored files are removed, and nothing brings them back. Pass id from os.my_mail_list. This is not the archive: to keep a mail out of the way, record it as skipped with os.my_mail_set_handled instead. An id from anyone else’s mailbox is not found.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>A message id from os.my_mail_list\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Side effects:\u003C\u002Fstrong> Removes the message, its attachment records and their stored files; their storage is no longer counted.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. A repeat finds no such message and reports email_not_found: the message is gone either way.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ id }\u003C\u002Fcode>: the message that is gone.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>DELETE \u002Fv1\u002Fmail\u002F:id\u003C\u002Fcode> (\u003Ccode>mail:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>api_token_cannot_reach_mail\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An API token called it. A token belongs to the enterprise and to nobody, so it has no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>user_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The caller is no longer a member of the enterprise the call is in.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>email_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The id is not in the caller's own mailbox, including a member's mail and another person's.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>mail_delete_failed\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The message’s stored files could not be removed, so the message was kept whole. Try again.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000003&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-my-mail-actions\">\u003Ccode>os.my_mail_actions\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>List the one-click buttons your inbox offers: the tasks that declare a mailbox action.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">List the one-click buttons your inbox offers. Each is a task whose current version declares a mailbox action: a task of the enterprise, which os.my_mail_start_action starts over your own mailbox (taskId set), or a public Catalog template that declares one and the enterprise holds no clone of, which has to be cloned first (catalogTaskId set). on says where the button sits: mailbox, over the whole mailbox, or mail, on one message, which starts the run with that message’s id. label is the button’s words, as the task declares them. schedule is your own cadence for a button, set with os.my_mail_schedule_action, or null.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Takes no arguments: no fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the CEO chat, the API, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ actions }\u003C\u002Fcode>: each \u003Ccode>{ taskId, catalogTaskId, slug, name, label, on, schedule }\u003C\u002Fcode>, exactly one of \u003Ccode>taskId\u003C\u002Fcode> and \u003Ccode>catalogTaskId\u003C\u002Fcode> set, by label. \u003Ccode>schedule\u003C\u002Fcode> is your own cadence for that button (\u003Ccode>{ cron, timezone, enabled, nextRunAt, lastFiredAt, lastRunId, refusalReason }\u003C\u002Fcode>), or null when you press it only by hand.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fmail\u002Factions\u003C\u002Fcode> (\u003Ccode>mail:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>api_token_cannot_reach_mail\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An API token called it. A token belongs to the enterprise and to nobody, so it has no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>user_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The caller is no longer a member of the enterprise the call is in.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-my-mail-start-action\">\u003Ccode>os.my_mail_start_action\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Press one of your inbox’s buttons: start that task over your own mailbox.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Press one of the buttons os.my_mail_actions lists: start the task by its taskId, over your own mailbox. The run reads and files your mail rather than its member’s, and the runs it chains do too. For a button on one message (on mail), pass emailId, the message it is pressed on, which the run receives as its emailId input. A busy task or member makes the run wait its turn as pending rather than refusing. A template (catalogTaskId set) cannot be started until it is cloned.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>taskId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The task to start: a taskId from os.my_mail_actions\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>emailId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>For a button on one message: that message’s id from os.my_mail_list\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Side effects:\u003C\u002Fstrong> Starts a run of the task, recorded as acting on your mailbox.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Not retry-safe: a repeat acts again. A repeat starts a second run. Read the first run before calling again.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the CEO chat, the API, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The run started: its \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>status\u003C\u002Fcode> (\u003Ccode>queued\u003C\u002Fcode>, or \u003Ccode>pending\u003C\u002Fcode> while it waits its turn) and \u003Ccode>taskId\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fmail\u002Factions\u002F:taskId\u002Fruns\u003C\u002Fcode> (\u003Ccode>mail:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>api_token_cannot_reach_mail\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An API token called it. A token belongs to the enterprise and to nobody, so it has no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>user_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The caller is no longer a member of the enterprise the call is in.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>taskId is not a task of this enterprise.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_not_runnable\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The task is deprecated, has no version yet, or nobody holds its role.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_disabled\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The task’s runs are switched off.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>input_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The task requires an input the button does not pass; the error names the field.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;taskId&quot;: &quot;0a7d2c9e-0000-4000-8000-000000000011&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;taskId&quot;: &quot;0a7d2c9e-0000-4000-8000-000000000012&quot;,\n  &quot;emailId&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000003&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-my-mail-schedule-action\">\u003Ccode>os.my_mail_schedule_action\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Press one of your inbox’s buttons on a cadence: each firing runs it over your own mailbox.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Put one of the buttons os.my_mail_actions lists on a cadence of your own: each firing presses it for you, over your own mailbox, as os.my_mail_start_action does, and the run is recorded as asked for by you. Only a button over the whole mailbox (on mailbox) can be scheduled; one on a single message needs a message. cron is five fields (*\u002F15 * * * * is every 15 minutes, *\u002F15 8-21 * * 1-5 the same on weekdays from 08:00 to 21:45); timezone is an IANA zone, or enterprise (the default) to follow the enterprise’s. enabled false keeps the cadence without firing it. Saving again changes it. A firing starts nothing while the button’s last run over your mailbox is still going, or failed and nobody cleared it, and says so in the schedule’s refusalReason.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>taskId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The button to schedule: a taskId from os.my_mail_actions, on mailbox\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>cron\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>Five-field cron, read in timezone, such as *\u002F15 * * * *\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>timezone\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>An IANA zone such as Europe\u002FMadrid, or enterprise (the default)\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>enabled\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>false keeps the cadence without firing it (default true)\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Side effects:\u003C\u002Fstrong> Saves your cadence for the button; each firing starts a run of the task over your mailbox.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. A repeat saves the same cadence again.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the CEO chat, the API, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The cadence as saved: \u003Ccode>{ cron, timezone, enabled, nextRunAt, lastFiredAt, lastRunId, refusalReason }\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>PUT \u002Fv1\u002Fmail\u002Factions\u002F:taskId\u002Fschedule\u003C\u002Fcode> (\u003Ccode>mail:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>api_token_cannot_reach_mail\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An API token called it. A token belongs to the enterprise and to nobody, so it has no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>user_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The caller is no longer a member of the enterprise the call is in.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>taskId is not a task of this enterprise.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>not_a_mailbox_action\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The task is not active or declares no button over the whole mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_mail_address\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>You have no mailbox in this enterprise yet.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_schedule\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>cron or timezone cannot be read, or the cadence never comes round.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;taskId&quot;: &quot;0a7d2c9e-0000-4000-8000-000000000011&quot;,\n  &quot;cron&quot;: &quot;*\u002F15 * * * *&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;taskId&quot;: &quot;0a7d2c9e-0000-4000-8000-000000000011&quot;,\n  &quot;cron&quot;: &quot;*\u002F15 8-21 * * 1-5&quot;,\n  &quot;timezone&quot;: &quot;Europe\u002FMadrid&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-my-mail-unschedule-action\">\u003Ccode>os.my_mail_unschedule_action\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Stop pressing one of your inbox’s buttons on a cadence.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Stop the cadence os.my_mail_schedule_action set for one of your inbox’s buttons. The button stays, and a run already started finishes. cleared says whether there was a cadence to stop.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>taskId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The button whose cadence to stop: a taskId from os.my_mail_actions\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Side effects:\u003C\u002Fstrong> Deletes your cadence for the button.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. A repeat finds no cadence and reports cleared false.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the CEO chat, the API, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ cleared }\u003C\u002Fcode>: true when a cadence was stopped, false when there was none.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>DELETE \u002Fv1\u002Fmail\u002Factions\u002F:taskId\u002Fschedule\u003C\u002Fcode> (\u003Ccode>mail:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>api_token_cannot_reach_mail\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An API token called it. A token belongs to the enterprise and to nobody, so it has no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>user_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The caller is no longer a member of the enterprise the call is in.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;taskId&quot;: &quot;0a7d2c9e-0000-4000-8000-000000000011&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-my-mail-contacts\">\u003Ccode>os.my_mail_contacts\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>List or search your own contacts: the people you have written to, and those you added.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">List the contacts of your own mailbox: everyone a send, reply or forward from it went to, saved as it left, and everyone you added by hand. Most recently written to first, then by name. Pass search to keep only contacts whose name or address contains it, any case: search Sarah, or acme.com, finds the address to write to. Pass directory true to add the enterprise’s own people and members who have an address, after your contacts and each only once. limit is how many rows (default 50, max 200). Mail that arrived never makes a contact, so nobody who only wrote to you is here until you write back.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>search\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only contacts whose name or address contains this, any case\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>directory\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Also offer the enterprise’s own people and members who have an address\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>limit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, 1 to 200\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Rows to return. Default 50\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ data }\u003C\u002Fcode>: each contact with \u003Ccode>id\u003C\u002Fcode> (null on a directory row), \u003Ccode>address\u003C\u002Fcode>, \u003Ccode>name\u003C\u002Fcode> (empty when none is known), \u003Ccode>source\u003C\u002Fcode> (\u003Ccode>auto\u003C\u002Fcode> when a send saved it, \u003Ccode>manual\u003C\u002Fcode> when it was added by hand, \u003Ccode>directory\u003C\u002Fcode> for one of the enterprise’s own people or members offered beside the contacts), \u003Ccode>nameByHand\u003C\u002Fcode> (a name set by hand, which no later send replaces), \u003Ccode>mailCount\u003C\u002Fcode> and \u003Ccode>lastMailedAt\u003C\u002Fcode> (null until the mailbox first writes to it).\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fmail\u002Fcontacts\u003C\u002Fcode> (\u003Ccode>mail:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>api_token_cannot_reach_mail\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An API token called it. A token belongs to the enterprise and to nobody, so it has no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>user_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The caller is no longer a member of the enterprise the call is in.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>contact_search_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>search is not text, or is longer than 200 characters.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>contact_limit_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>limit is not a whole number from 1 to 200.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;search&quot;: &quot;sarah&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;search&quot;: &quot;acme&quot;,\n  &quot;directory&quot;: true,\n  &quot;limit&quot;: 10\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-my-mail-contact-save\">\u003Ccode>os.my_mail_contact_save\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Add a contact to your own mailbox, or name one already there.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Save an address to the contacts of your own mailbox. Pass address and, optionally, name. A new address is added as one you saved by hand; an address already in your contacts keeps its place and history, and takes the name when you give one. A name you set here is yours: a later send never replaces it. Leave name out to keep the name a contact already has. An empty name clears it.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>address\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The contact’s email address\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>name\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The name the contact goes by. Kept over any a later send carries\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The contact saved, with \u003Ccode>id\u003C\u002Fcode> (null on a directory row), \u003Ccode>address\u003C\u002Fcode>, \u003Ccode>name\u003C\u002Fcode> (empty when none is known), \u003Ccode>source\u003C\u002Fcode> (\u003Ccode>auto\u003C\u002Fcode> when a send saved it, \u003Ccode>manual\u003C\u002Fcode> when it was added by hand, \u003Ccode>directory\u003C\u002Fcode> for one of the enterprise’s own people or members offered beside the contacts), \u003Ccode>nameByHand\u003C\u002Fcode> (a name set by hand, which no later send replaces), \u003Ccode>mailCount\u003C\u002Fcode> and \u003Ccode>lastMailedAt\u003C\u002Fcode> (null until the mailbox first writes to it).\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fmail\u002Fcontacts\u003C\u002Fcode> (\u003Ccode>mail:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>api_token_cannot_reach_mail\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An API token called it. A token belongs to the enterprise and to nobody, so it has no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>user_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The caller is no longer a member of the enterprise the call is in.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>contact_address_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>address is not one email address.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>contact_name_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>name is not text, or is longer than 200 characters.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;address&quot;: &quot;sarah@acme.com&quot;,\n  &quot;name&quot;: &quot;Sarah Jones&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-my-mail-contact-delete\">\u003Ccode>os.my_mail_contact_delete\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Remove a contact from your own mailbox.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Remove one contact from your own mailbox. Pass id from os.my_mail_contacts; a directory row has none, since it is not one of your contacts. Only the contact goes: mail to and from the address stays. A later send to the address saves it again.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>A contact id from os.my_mail_contacts\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. A repeat finds no such contact and reports contact_not_found: it is gone either way.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ id }\u003C\u002Fcode>: the contact that is gone.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>DELETE \u002Fv1\u002Fmail\u002Fcontacts\u002F:id\u003C\u002Fcode> (\u003Ccode>mail:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>api_token_cannot_reach_mail\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An API token called it. A token belongs to the enterprise and to nobody, so it has no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>user_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The caller is no longer a member of the enterprise the call is in.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>contact_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The id is not one of your contacts, including another mailbox’s.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;7c1e2f3a-0000-4000-8000-000000000021&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-my-mail-signature\">\u003Ccode>os.my_mail_signature\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Read the signature the OS adds to every mail you send, reply and forward.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Read your own mailbox’s signature: what the OS adds after the body of every mail you send, reply or forward, from the portal, the API or MCP, unless that send says signature false. Its html is the signature as you formatted it, sanitised; its text is the plain-text form, which a mail’s text part carries under a `-- ` line. Both are empty when you have no signature. With none of your own, your mail is signed with the enterprise’s signature template, filled in with your name, title and address, unless useTemplate is false. Mail from one of your extra addresses carries that address’s own signature instead, when it has one: see os.my_mail_addresses.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Takes no arguments: no fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> Your signature: \u003Ccode>html\u003C\u002Fcode> (sanitised, empty for a signature written as text), \u003Ccode>text\u003C\u002Fcode> (its plain-text form), \u003Ccode>updatedAt\u003C\u002Fcode> (null when you have none), \u003Ccode>useTemplate\u003C\u002Fcode> (whether the enterprise’s signature template signs your mail while you have no signature of your own) and \u003Ccode>template\u003C\u002Fcode> (that template filled in for you, \u003Ccode>{ html, text }\u003C\u002Fcode>, or null when the enterprise has none).\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fmail\u002Fsignature\u003C\u002Fcode> (\u003Ccode>mail:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>api_token_cannot_reach_mail\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An API token called it. A token belongs to the enterprise and to nobody, so it has no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>user_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The caller is no longer a member of the enterprise the call is in.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-my-mail-signature-set\">\u003Ccode>os.my_mail_signature_set\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Set or clear the signature the OS adds to every mail you send.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Set your own mailbox’s signature, which the OS adds after the body of every mail you send, reply or forward. Pass html for a formatted signature (bold, links, a few lines): it is sanitised to what mail may carry, and its plain-text form is derived from it, with each link written after its words. Or pass text alone for a plain signature. With html given, text is ignored. Each is at most 20 KB. Pass both empty to clear the signature: your mail then leaves with the enterprise’s signature template, filled in for you, or with none when there is no template or useTemplate is false. Pass useTemplate false to send with no signature at all while you have none of your own, true to use the template again; left out, it stays as it was. Given without html or text, your signature stays as it is. To sign mail from one of your extra addresses differently, use os.my_mail_address_signature_set.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>html\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The signature as HTML. Sanitised; its text form is derived\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>text\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The signature as plain text, used when no html is given\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>useTemplate\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Whether the enterprise’s signature template signs your mail while you have no signature of your own\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Side effects:\u003C\u002Fstrong> Every mail you send, reply or forward from now on carries it, unless that send says signature false.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> Your signature as saved: \u003Ccode>html\u003C\u002Fcode> (sanitised, empty for a signature written as text), \u003Ccode>text\u003C\u002Fcode> (its plain-text form), \u003Ccode>updatedAt\u003C\u002Fcode> (null when you have none), \u003Ccode>useTemplate\u003C\u002Fcode> (whether the enterprise’s signature template signs your mail while you have no signature of your own) and \u003Ccode>template\u003C\u002Fcode> (that template filled in for you, \u003Ccode>{ html, text }\u003C\u002Fcode>, or null when the enterprise has none).\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>PUT \u002Fv1\u002Fmail\u002Fsignature\u003C\u002Fcode> (\u003Ccode>mail:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>api_token_cannot_reach_mail\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An API token called it. A token belongs to the enterprise and to nobody, so it has no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>user_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The caller is no longer a member of the enterprise the call is in.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>signature_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>html or text is not text, or useTemplate is not true or false.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>signature_too_large\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>html or text is larger than 20 KB.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;html&quot;: &quot;&lt;p&gt;&lt;strong&gt;Sarah Jones&lt;\u002Fstrong&gt;&lt;br&gt;Head of Sales · &lt;a href=\\&quot;https:\u002F\u002Facme.com\\&quot;&gt;acme.com&lt;\u002Fa&gt;&lt;\u002Fp&gt;&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;text&quot;: &quot;Sarah Jones\\nHead of Sales&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;html&quot;: &quot;&quot;,\n  &quot;text&quot;: &quot;&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;html&quot;: &quot;&quot;,\n  &quot;text&quot;: &quot;&quot;,\n  &quot;useTemplate&quot;: false\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-my-mail-addresses\">\u003Ccode>os.my_mail_addresses\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>List your own extra addresses, each with the signature mail from it carries.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">List the extra addresses of your own mailbox: the further addresses at the enterprise’s domains an owner gave you, which deliver to your mailbox and which you can send from by naming one as `from` on os.my_mail_send or os.my_mail_forward. Your own address is not listed. Each comes with replyFromAlias and its own signature, which a mail leaving from that address carries in place of your mailbox’s; null means it signs as your mailbox does (os.my_mail_signature). Set or clear one with os.my_mail_address_signature_set. Adding and removing an address is an owner’s, on People.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Takes no arguments: no fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ aliases }\u003C\u002Fcode>: each of your extra addresses, by address, with \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>address\u003C\u002Fcode>, \u003Ccode>replyFromAlias\u003C\u002Fcode> (whether a reply to mail that arrived at it leaves from it, rather than from your own address) and \u003Ccode>signature\u003C\u002Fcode> (its own, \u003Ccode>{ html, text }\u003C\u002Fcode> with \u003Ccode>html\u003C\u002Fcode> sanitised and empty for one written as text, or null while it signs as your mailbox does). \u003Ccode>[]\u003C\u002Fcode> when you have none.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fmail\u002Faliases\u003C\u002Fcode> (\u003Ccode>mail:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>api_token_cannot_reach_mail\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An API token called it. A token belongs to the enterprise and to nobody, so it has no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>user_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The caller is no longer a member of the enterprise the call is in.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-my-mail-address-signature-set\">\u003Ccode>os.my_mail_address_signature_set\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Set or clear the signature mail from one of your extra addresses carries.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Set the signature of one of your own extra addresses: what the OS adds after the body of a mail you send or forward from that address, and of a reply that leaves from it, in place of your mailbox’s signature, unless that send says signature false. Pass id from os.my_mail_addresses, and html for a formatted signature: it is sanitised to what mail may carry, and its plain-text form is derived from it, with each link written after its words. Or pass text alone for a plain signature. With html given, text is ignored. Each is at most 20 KB. Pass both empty, or leave both out, to clear it: mail leaving from that address then carries your mailbox’s signature (os.my_mail_signature), or with none of your own, the enterprise’s signature template unless you switched it off, or nothing.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>An address id from os.my_mail_addresses\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>html\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The signature as HTML. Sanitised; its text form is derived\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>text\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The signature as plain text, used when no html is given\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Side effects:\u003C\u002Fstrong> Every mail that leaves from the address from now on carries it, unless that send says signature false.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ aliases }\u003C\u002Fcode>: every one of your extra addresses after the change, as os.my_mail_addresses lists them, with \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>address\u003C\u002Fcode>, \u003Ccode>replyFromAlias\u003C\u002Fcode> (whether a reply to mail that arrived at it leaves from it, rather than from your own address) and \u003Ccode>signature\u003C\u002Fcode> (its own, \u003Ccode>{ html, text }\u003C\u002Fcode> with \u003Ccode>html\u003C\u002Fcode> sanitised and empty for one written as text, or null while it signs as your mailbox does).\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>PUT \u002Fv1\u002Fmail\u002Faliases\u002F:id\u002Fsignature\u003C\u002Fcode> (\u003Ccode>mail:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>api_token_cannot_reach_mail\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An API token called it. A token belongs to the enterprise and to nobody, so it has no mailbox.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>user_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The caller is no longer a member of the enterprise the call is in.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>alias_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The id is not one of your extra addresses, including another mailbox’s.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>use_mailbox_owner_handoff\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The address has since become a member’s own address, so it is no longer one of yours to sign.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>alias_address_taken\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The address has since become a person’s own address, so it is no longer one of yours to sign.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>signature_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>html or text is not text.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>signature_too_large\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>html or text is larger than 20 KB.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;3b8e4d5f-0000-4000-8000-000000000031&quot;,\n  &quot;html&quot;: &quot;&lt;p&gt;&lt;strong&gt;Acme Sales&lt;\u002Fstrong&gt;&lt;br&gt;&lt;a href=\\&quot;https:\u002F\u002Facme.com\\&quot;&gt;acme.com&lt;\u002Fa&gt;&lt;\u002Fp&gt;&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;3b8e4d5f-0000-4000-8000-000000000031&quot;,\n  &quot;text&quot;: &quot;Acme Support\\nWe answer within a day&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;3b8e4d5f-0000-4000-8000-000000000031&quot;,\n  &quot;html&quot;: &quot;&quot;,\n  &quot;text&quot;: &quot;&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-escalate-mail\">\u003Ccode>os.escalate_mail\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>The gate a mail that needs the CEO opens: the mail, why it matters, and what is suggested.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Escalate a mail the CEO has to see (a VIP, something sensitive, or a question only they can answer), then stop. The gate carries the mail, why it matters and which of its three choices you suggest. It appears on the gates page and in the assigned member’s chat thread, where the CEO chooses Reply, Snooze or Leave it. Reply and Snooze end this run with outcome ceo_approved, the choice as ceoChoice (reply or snooze), this mail as mailId, and ceoNote: what the reply should say, or the ISO 8601 time the snooze ends. Leave it cancels this run and archives the mail. Call it last.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The mail the escalation is about\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>mailId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The same id, under the key both mail gates use\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>subject\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>fromAddress\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>summary\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>Why this mail needs the CEO\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>suggestion\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>Which choice you suggest (Reply, Snooze or Leave it) and why, in one or two sentences\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Side effects:\u003C\u002Fstrong> Opens one CEO gate for this run and parks the run until it is decided.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Not retry-safe: a repeat acts again. Escalating the same mail again opens a second gate carrying its own summary, so the CEO is asked twice. Whether a mail has already been escalated is triage’s to track, not this gate’s.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the OS itself, on nobody’s call.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Needs:\u003C\u002Fstrong>\n\u003Cul>\n\u003Cli>A gate: the CEO decides every call, whatever the task declares.\u003C\u002Fli>\n\u003Cli>The gate offers these choices in place of Approve and Reject. Reply (\u003Ccode>reply\u003C\u002Fcode>): A reply is drafted and comes back to you to approve before anything is sent. Snooze (\u003Ccode>snooze\u003C\u002Fcode>): Nothing is sent. The mail is set aside until the time you pick. Leave it (\u003Ccode>leave\u003C\u002Fcode>): No reply is sent and the mail is archived.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The CEO’s choice, to the task that runs next: \u003Ccode>ceoChoice\u003C\u002Fcode> (\u003Ccode>reply\u003C\u002Fcode> or \u003Ccode>snooze\u003C\u002Fcode>), \u003Ccode>ceoNote\u003C\u002Fcode> and \u003Ccode>mailId\u003C\u002Fcode>. Leave it hands nothing on: the run is cancelled and the mail archived.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000003&quot;,\n  &quot;subject&quot;: &quot;Renewal before Friday&quot;,\n  &quot;fromAddress&quot;: &quot;vip@acme.example&quot;,\n  &quot;summary&quot;: &quot;A VIP contact wants to renew before Friday and has asked for a call.&quot;,\n  &quot;suggestion&quot;: &quot;Reply: confirm the renewal terms and offer Thursday for the call.&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-mail-reply-draft\">\u003Ccode>os.mail_reply_draft\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>The gate a drafted reply opens, so no reply leaves without a decision on it.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Nobody calls this: the OS opens this gate itself when the CEO’s instruction on an escalated mail is to reply. It carries the mail the reply answers and the drafted body, and waits for a decision before anything is sent.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>mailId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The mail this reply answers\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>body\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The drafted reply, as it would be sent\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Not retry-safe: a repeat acts again. A second draft for the same mail opens a second gate, decided on its own: nothing folds it into the first.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the OS itself, on nobody’s call.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The decision on the draft: approved and it may be sent, or not, with the decider's note.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;mailId&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000003&quot;,\n  &quot;body&quot;: &quot;Thursday works — I will send an invitation shortly.&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-list-kpis\">\u003Ccode>os.list_kpis\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>List the signed-off KPIs the run's teams own and those its task is the source of, with their lights.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">List the KPIs this run may read: the KPIs of every team its member sits on or leads, and any KPI whose source is this run's task, whichever layer owns it. Only KPIs a person has signed off are listed. Each row carries its target (value, direction, AMBER band, on-target-worsening rule), cadence, owner (layer and id), source (kind and ref), latest reading, current light and whether it is overdue. The light is null when the KPI has no target or no reading yet. No arguments. Never a KPI of a team the member is not on unless its source is this run's task, and never another enterprise's.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Takes no arguments: no fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ data }\u003C\u002Fcode>: one row per KPI, each with \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>name\u003C\u002Fcode>, \u003Ccode>ownerLayer\u003C\u002Fcode> (\u003Ccode>company\u003C\u002Fcode>, \u003Ccode>team\u003C\u002Fcode>, \u003Ccode>role\u003C\u002Fcode>, \u003Ccode>task\u003C\u002Fcode>, or null for a company KPI set before layers), \u003Ccode>ownerId\u003C\u002Fcode>, \u003Ccode>sourceKind\u003C\u002Fcode> (\u003Ccode>task\u003C\u002Fcode> or \u003Ccode>person\u003C\u002Fcode>), \u003Ccode>sourceRef\u003C\u002Fcode> (the task or person id), \u003Ccode>target\u003C\u002Fcode>, \u003Ccode>cadenceMinutes\u003C\u002Fcode>, \u003Ccode>light\u003C\u002Fcode>, \u003Ccode>overdue\u003C\u002Fcode> and \u003Ccode>lastReading\u003C\u002Fcode> (\u003Ccode>id\u003C\u002Fcode>, \u003Ccode>value\u003C\u002Fcode>, \u003Ccode>takenAt\u003C\u002Fcode>, \u003Ccode>recordedBy\u003C\u002Fcode>, \u003Ccode>runId\u003C\u002Fcode>), or null before the first reading.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.list_kpis\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-record-kpi-reading\">\u003Ccode>os.record_kpi_reading\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Record a reading for a KPI whose source is this run's task.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Record one reading for the KPI named by kpiId (from os.list_kpis). Only a run of the task that KPI names as its source (sourceKind task, sourceRef this run's task) may record one, and only once a person has signed the KPI off. Pass value and, optionally, takenAt (ISO 8601; defaults to now). No other field is accepted: no os.* tool lets a run change a target, band, cadence or source. The reading is recorded as taken by this run (`recordedBy: run:&lt;runId&gt;`); a run cannot record on another run's behalf. It lands in the same history HQ's board and the KPI readings API read, so the light they show moves with it.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpiId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>A KPI id from os.list_kpis\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>value\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>number\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>takenAt\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>ISO 8601. Defaults to now.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. Keyed on the tool call, like every other os.* write tool: a repeat of the same call records once and returns the same reading.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The recorded reading and the KPI it landed on: \u003Ccode>kpiId\u003C\u002Fcode>, \u003Ccode>name\u003C\u002Fcode>, \u003Ccode>readingId\u003C\u002Fcode>, \u003Ccode>value\u003C\u002Fcode>, \u003Ccode>takenAt\u003C\u002Fcode>, \u003Ccode>recordedBy\u003C\u002Fcode> and \u003Ccode>runId\u003C\u002Fcode> (this run), \u003Ccode>target\u003C\u002Fcode>, and the KPI’s \u003Ccode>light\u003C\u002Fcode> as it now stands.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.record_kpi_reading\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpi_id_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>kpiId\u003C\u002Fcode> is missing.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>value_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>value\u003C\u002Fcode> is missing or not a number.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>taken_at_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>takenAt\u003C\u002Fcode> is not a timestamp anything can read.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpi_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>kpiId\u003C\u002Fcode> does not name a KPI this run may record: another enterprise's, one whose source is not this run's task, or one nobody has signed off yet.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;kpiId&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000009&quot;,\n  &quot;value&quot;: 42\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-get-enterprise-kpis\">\u003Ccode>os.get_enterprise_kpis\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>The company's KPI targets, bands, cadence and source.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">The company's KPI targets as set: unit, target and direction, AMBER band, cadence and source. A KPI waiting for a target has targetValue null. Each KPI carries signedOffAt: null while it waits for a person to sign it off, and until then no run sees it or records a reading for it.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Takes no arguments: no fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fenterprise\u002Fkpi-targets\u003C\u002Fcode> (\u003Ccode>enterprise:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"os-set-enterprise-kpis\">\u003Ccode>os.set_enterprise_kpis\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Replace the company's KPI target list.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Replace the company's complete KPI target list. A target needs its unit, direction, cadence and source; a no-target KPI is accepted. Uses the same validation as the portal. The answer's awaitingSignOff names every KPI still waiting for sign-off, or is null: an API token never signs a KPI off, so a KPI it adds or changes waits for a person.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpis\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of object\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The complete KPI target list. Every item is validated by the API.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpis[].id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpis[].name\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpis[].unit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpis[].targetValue\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>number\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpis[].targetDirection\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>at_least\u003C\u002Fcode>, \u003Ccode>at_most\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpis[].amberBand\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>number, at least 0\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpis[].amberBandType\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>absolute\u003C\u002Fcode>, \u003Ccode>percentage\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpis[].onTargetWorseningRule\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpis[].cadenceMinutes\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, at least 1\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpis[].sourceKind\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>task\u003C\u002Fcode>, \u003Ccode>person\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpis[].sourceRef\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpis[].isKey\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>PATCH \u002Fv1\u002Fenterprise\u002Fkpi-targets\u003C\u002Fcode> (\u003Ccode>enterprise:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_kpis\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A KPI is incomplete or malformed.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Ch2 id=\"os-get-team-kpis\">\u003Ccode>os.get_team_kpis\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>A team's KPI targets, including its key KPI.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">A team's own KPI targets as set, including which one is its key KPI. This is the target list, not the role and task KPI tree. Each KPI carries signedOffAt: null while it waits for a person to sign it off, and until then no run sees it or records a reading for it.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>teamId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The team whose KPI targets are read.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fteams\u002F:teamId\u002Fkpi-targets\u003C\u002Fcode> (\u003Ccode>teams:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>team_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The team is not in this enterprise.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Ch2 id=\"os-set-team-kpis\">\u003Ccode>os.set_team_kpis\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Replace a team's KPI target list and key KPI.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Replace a team's complete KPI target list. Two key KPIs are refused; a list with none marked is stored with no key KPI. Uses the same validation as the portal. The answer's awaitingSignOff names every KPI still waiting for sign-off, or is null: an API token never signs a KPI off, so a KPI it adds or changes waits for a person.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>teamId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The team whose KPI targets are replaced.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpis\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of object\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The complete KPI target list. Every item is validated by the API.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpis[].id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpis[].name\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpis[].unit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpis[].targetValue\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>number\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpis[].targetDirection\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>at_least\u003C\u002Fcode>, \u003Ccode>at_most\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpis[].amberBand\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>number, at least 0\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpis[].amberBandType\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>absolute\u003C\u002Fcode>, \u003Ccode>percentage\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpis[].onTargetWorseningRule\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpis[].cadenceMinutes\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, at least 1\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpis[].sourceKind\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>task\u003C\u002Fcode>, \u003Ccode>person\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpis[].sourceRef\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpis[].isKey\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>PATCH \u002Fv1\u002Fteams\u002F:teamId\u002Fkpi-targets\u003C\u002Fcode> (\u003Ccode>teams:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>team_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The team is not in this enterprise.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_kpis\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A KPI is incomplete or two KPIs are marked key.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Ch2 id=\"os-set-context\">\u003Ccode>os.set_context\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Store a JSON value for the enterprise under a key, so a later run can read it.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Store value at key for this enterprise. A later call with the same key replaces the value. Any later run of any task in the enterprise can read it, and a task version that declares a prefix of the key receives it in input.context when a run starts. value is JSON and at most 16KB. This is bookkeeping between runs, not memory, and not a place for a secret. A repeat of the same tool call returns the value that call stored and does not write again.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>key\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>A short key, such as sitemap:\u003Ca href=\"https:\u002F\u002Fexample.com\u002Fpricing\">https:\u002F\u002Fexample.com\u002Fpricing\u003C\u002Fa>. No spaces. Not a secret.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>value\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>any\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>Any JSON value, at most 16KB. Not a secret.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. Keyed on the tool call, like every other os.* write tool: a repeat of the same call stores once and returns the value that call stored.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ key, value }\u003C\u002Fcode>: the key and the JSON value now stored for it.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.set_context\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>key_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>key\u003C\u002Fcode> is missing.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>key_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>key\u003C\u002Fcode> is empty, longer than 512 characters, or contains whitespace or a control character.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>value_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>value\u003C\u002Fcode> is missing.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>value_not_json\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>value\u003C\u002Fcode> is not JSON.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>value_too_large\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>value\u003C\u002Fcode> is over 16KB.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;key&quot;: &quot;sitemap:https:\u002F\u002Fexample.com\u002Fpricing&quot;,\n  &quot;value&quot;: {\n    &quot;status&quot;: &quot;absorbed&quot;\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-get-context\">\u003Ccode>os.get_context\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Read one enterprise context value, or null when the key has never been set.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Read the JSON value stored at key for this enterprise. Returns value null when the key has never been set. A run whose task declares a prefix of the key already has it in input.context; this reads one key that was not loaded, or a key another run has changed since this run started.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>key\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>A short key, such as sitemap:\u003Ca href=\"https:\u002F\u002Fexample.com\u002Fpricing\">https:\u002F\u002Fexample.com\u002Fpricing\u003C\u002Fa>. No spaces. Not a secret.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ key, value }\u003C\u002Fcode>. \u003Ccode>value\u003C\u002Fcode> is null when the key has never been set.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.get_context\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>key_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>key\u003C\u002Fcode> is missing.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>key_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>key\u003C\u002Fcode> is empty, longer than 512 characters, or contains whitespace or a control character.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;key&quot;: &quot;sitemap:https:\u002F\u002Fexample.com\u002Fpricing&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-delete-context\">\u003Ccode>os.delete_context\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Remove one enterprise context key. A missing key is a success.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Remove key from this enterprise. A key that is not there is a success. Used when the thing the key tracked has gone, such as a URL that left the sitemap. A repeat of the same tool call returns the result that call stored and does not delete a key a later call has set.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>key\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>A short key, such as sitemap:\u003Ca href=\"https:\u002F\u002Fexample.com\u002Fpricing\">https:\u002F\u002Fexample.com\u002Fpricing\u003C\u002Fa>. No spaces. Not a secret.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. Keyed on the tool call, like every other os.* write tool: a repeat of the same call removes the key once and returns that call’s result.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ key, deleted }\u003C\u002Fcode>. \u003Ccode>deleted\u003C\u002Fcode> is false when the key was not there.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.delete_context\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>key_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>key\u003C\u002Fcode> is missing.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>key_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>key\u003C\u002Fcode> is empty, longer than 512 characters, or contains whitespace or a control character.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;key&quot;: &quot;sitemap:https:\u002F\u002Fexample.com\u002Fpricing&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"kpi-record-reading\">\u003Ccode>kpi.record_reading\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Record one reading of a KPI by hand: the value, when it was taken, and who or what took it.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Record one reading of a KPI by hand: the value, when it was taken, and who or what took it. Every reading is kept — correcting a wrong one means recording a new reading, never editing or deleting the old one — so a KPI history shows how it got to where it is. The light and the trend are read off the readings, so recording one is what moves them. A KPI nobody has signed off takes no reading: it is refused with 409 kpi_not_signed_off.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpiId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The KPI the reading belongs to.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>value\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>number\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The number read, in the KPI's own unit.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>takenAt\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>When the reading was taken, as an ISO 8601 timestamp, e.g. 2026-01-08T00:00:00Z.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>recordedBy\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>Who or what took the reading: a member id, or the agent or tool that read it.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Not retry-safe: a repeat acts again. Every call appends a reading, so a repeat records a second one.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The reading as recorded: \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>kpiId\u003C\u002Fcode>, \u003Ccode>value\u003C\u002Fcode>, \u003Ccode>takenAt\u003C\u002Fcode> (ISO 8601) and \u003Ccode>recordedBy\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fkpis\u002F:kpiId\u002Freadings\u003C\u002Fcode> (\u003Ccode>kpis:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpi_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>kpiId\u003C\u002Fcode> names no KPI in this enterprise, another enterprise's included.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpi_not_signed_off\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Nobody has signed the KPI off yet, so it takes no reading.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;kpiId&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000009&quot;,\n  &quot;value&quot;: 3.5,\n  &quot;takenAt&quot;: &quot;2026-01-08T00:00:00Z&quot;,\n  &quot;recordedBy&quot;: &quot;weekly-metrics-export&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"kpi-list-readings\">\u003Ccode>kpi.list_readings\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>One KPI's readings, newest first, corrected ones included.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">One KPI's readings, newest first: the value, when it was taken and who or what took it. This is the whole history behind the KPI's light and its trend, including any reading a later one corrected.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpiId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The KPI whose readings to list.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> Every reading of the KPI, newest by \u003Ccode>takenAt\u003C\u002Fcode> first, each with \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>kpiId\u003C\u002Fcode>, \u003Ccode>value\u003C\u002Fcode>, \u003Ccode>takenAt\u003C\u002Fcode> and \u003Ccode>recordedBy\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fkpis\u002F:kpiId\u002Freadings\u003C\u002Fcode> (\u003Ccode>kpis:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpi_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>kpiId\u003C\u002Fcode> names no KPI in this enterprise, another enterprise's included.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;kpiId&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000009&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"role-list-kpis\">\u003Ccode>role.list_kpis\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>A role's KPIs, oldest first, with the team KPI each serves, its sign-off, light, trend and readings.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">A role's KPIs, oldest first: each one's target, direction, AMBER band, cadence, source, the team KPI it serves (servesName names it; served is false for one that serves none), whether a person has signed it off, its light and trend (null until it is signed off) and its readings. Not found for a role in another enterprise.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>roleId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The role whose KPIs to list.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Froles\u002F:roleId\u002Fkpis\u003C\u002Fcode> (\u003Ccode>roles:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>role_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>roleId\u003C\u002Fcode> names no role in this enterprise, another enterprise's included.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Ch2 id=\"role-define-kpi\">\u003Ccode>role.define_kpi\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Propose a KPI on a role, waiting for a person to sign it off.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Propose a KPI on a role, with the same fields as a KPI on any other layer. It waits for a person to sign it off, and until then draws no light and takes no reading. A KPI may serve only a team’s KPI, any team’s, since a role is held across teams (400 role_kpi_serves_non_team otherwise); leave servesKpiId out for one that serves none. The response is the role's KPIs after the change.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>roleId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The role the KPI belongs to.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>name\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>What is measured, up to 200 characters.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>targetValue\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>number\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The target, in the KPI’s own unit. Set it with targetDirection, or leave both out for no target.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>targetDirection\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>at_least\u003C\u002Fcode>, \u003Ccode>at_most\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>at_least when higher is better, at_most when lower is better.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>amberBand\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>number, at least 0\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>How far past the target still reads AMBER rather than RED.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>onTargetWorseningRule\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>true to read AMBER when on target but worse than the reading before.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>cadenceMinutes\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, at least 1\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>How often it is read, in minutes; a reading older than this is overdue.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>servesKpiId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The KPI of the role’s own team this one serves.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>sourceKind\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>task\u003C\u002Fcode>, \u003Ccode>person\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Where readings come from: task (a task records them) or person (entered by hand).\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>sourceRef\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The task id, or the person’s human-user id, sourceKind names.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Not retry-safe: a repeat acts again. Every call adds a KPI to the role, so a repeat proposes a second one.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Froles\u002F:roleId\u002Fkpis\u003C\u002Fcode> (\u003Ccode>roles:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>role_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>roleId\u003C\u002Fcode> names no role in this enterprise, another enterprise's included.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>role_kpi_serves_non_team\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>servesKpiId\u003C\u002Fcode> names a KPI that is not a team’s: the company’s, a role’s or a task’s.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Ch2 id=\"role-edit-kpi\">\u003Ccode>role.edit_kpi\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Change a role KPI's fields; a signed-off one only a person changes.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Change a role KPI's fields; the ones left out keep their value. A KPI a person has signed off is changed only by a person, so this is refused with 403 kpi_signed_off_person_only for it. The response is the role's KPIs after the change.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>roleId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The role the KPI belongs to.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>name\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>What is measured, up to 200 characters.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>targetValue\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>number\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The target, in the KPI’s own unit. Set it with targetDirection, or leave both out for no target.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>targetDirection\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>at_least\u003C\u002Fcode>, \u003Ccode>at_most\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>at_least when higher is better, at_most when lower is better.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>amberBand\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>number, at least 0\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>How far past the target still reads AMBER rather than RED.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>onTargetWorseningRule\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>true to read AMBER when on target but worse than the reading before.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>cadenceMinutes\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, at least 1\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>How often it is read, in minutes; a reading older than this is overdue.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>servesKpiId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The KPI of the role’s own team this one serves.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>sourceKind\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>task\u003C\u002Fcode>, \u003Ccode>person\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Where readings come from: task (a task records them) or person (entered by hand).\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>sourceRef\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The task id, or the person’s human-user id, sourceKind names.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpiId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The KPI to change.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. The same fields set twice leave the KPI as the first call did.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>PATCH \u002Fv1\u002Froles\u002F:roleId\u002Fkpis\u002F:kpiId\u003C\u002Fcode> (\u003Ccode>roles:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>role_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>roleId\u003C\u002Fcode> names no role in this enterprise, another enterprise's included.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>role_kpi_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>kpiId\u003C\u002Fcode> names no KPI still on this role.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>role_kpi_serves_non_team\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>servesKpiId\u003C\u002Fcode> names a KPI that is not a team’s: the company’s, a role’s or a task’s.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kpi_signed_off_person_only\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A person has signed the KPI off, so only a person may change it.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Ch2 id=\"os-inspect-enterprise\">\u003Ccode>os.inspect_enterprise\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>A snapshot of the company: teams, members, roles, and the tasks of the roles each member holds.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Read the company as it is now: every team (id, name, slug) and every member (id, name, email, persona, roles), with each member’s tasks: every task of a role they hold, whatever team they sit on (not OS tasks). The same snapshot as os.directory. Use this to name who owns what before you assign, route or escalate work. Read-only; pass no arguments.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>No declared fields: the schema accepts any object.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ teams, members }\u003C\u002Fcode>: each team's id, name and slug, and each member's id, name, email, persona, roles, and every task of a role they hold, whatever team they sit on (not OS tasks).\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.inspect_enterprise\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"os-directory\">\u003Ccode>os.directory\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Teams, members, roles, and the tasks of the roles each member holds: who to offload work to.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">List teams, members, roles, and each member’s tasks: every task of a role they hold, whatever team they sit on (not OS tasks). Use this to find someone to offload work to.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>No declared fields: the schema accepts any object.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the CEO chat, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ teams, members }\u003C\u002Fcode>: each team's id, name and slug, and each member's id, name, email, persona, roles, and every task of a role they hold, whatever team they sit on (not OS tasks). The same snapshot as \u003Ccode>os.inspect_enterprise\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.directory\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"os-list-blockers\">\u003Ccode>os.list_blockers\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>What has stopped: failed, stalled, blocked and spend-paused runs, and stopped pipelines, with who owns each.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">What is stopping work right now, as the Blockers page shows it: failed runs not yet cleared (one page, with failedTotal counting them all), stalled, blocked and spend-paused runs, stopped pipelines, missing model tiers, exhausted LLM capacity, task definition problems, and teams with no lead, no metric or an overdue retro. Read-only: nothing is retried or cleared. Waiting gates are not here; use os.list_open_gates.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>failedPage\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, at least 1\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The page of failed runs to read, from 1. Defaults to 1. A page past the last reads the last.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>pageSize\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, 1 to 100\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Failed runs per page, up to 100. Defaults to 100 in a run, and to 20 over the API.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> What the portal shows as blockers. To a run: \u003Ccode>runs\u003C\u002Fcode>, each stopped run once, oldest first, with \u003Ccode>runId\u003C\u002Fcode>, the \u003Ccode>sections\u003C\u002Fcode> it is listed in (failed, stopped, blocked, stalled, paused), \u003Ccode>status\u003C\u002Fcode>, \u003Ccode>reason\u003C\u002Fcode>, \u003Ccode>blockClass\u003C\u002Fcode>, its \u003Ccode>task\u003C\u002Fcode>, \u003Ccode>team\u003C\u002Fcode>, team \u003Ccode>lead\u003C\u002Fcode> and \u003Ccode>assignee\u003C\u002Fcode>, the \u003Ccode>repo\u003C\u002Fcode>, \u003Ccode>issue\u003C\u002Fcode> and \u003Ccode>pr\u003C\u002Fcode> from its input, \u003Ccode>since\u003C\u002Fcode>, \u003Ccode>taskRetries\u003C\u002Fcode> (how many times tasks have retried its chain) and \u003Ccode>escalation\u003C\u002Fcode> (to whom, \u003Ccode>toYou\u003C\u002Fcode>, the note, when) once someone escalated it; then \u003Ccode>failedTotal\u003C\u002Fcode> (every uncleared failed run), the \u003Ccode>failedPage\u003C\u002Fcode> read and its \u003Ccode>pageSize\u003C\u002Fcode>, the team-health rows (\u003Ccode>missingLead\u003C\u002Fcode>, \u003Ccode>overdueRetro\u003C\u002Fcode>, and \u003Ccode>kpiHealth\u003C\u002Fcode>: a KPI that needs attention, with its \u003Ccode>condition\u003C\u002Fcode> (\u003Ccode>no_key_kpi\u003C\u002Fcode>, \u003Ccode>no_target\u003C\u002Fcode>, \u003Ccode>overdue\u003C\u002Fcode> or \u003Ccode>light\u003C\u002Fcode>), \u003Ccode>team\u003C\u002Fcode>, \u003Ccode>kpi\u003C\u002Fcode>, \u003Ccode>layer\u003C\u002Fcode>, \u003Ccode>light\u003C\u002Fcode>, \u003Ccode>trend\u003C\u002Fcode> and \u003Ccode>owner\u003C\u002Fcode>), \u003Ccode>spendEnabled\u003C\u002Fcode> and \u003Ccode>draining\u003C\u002Fcode>. Over the API: the portal rows as they are. Waiting gates are not here: read them with \u003Ccode>os.list_open_gates\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fblockers\u003C\u002Fcode> (\u003Ccode>blockers:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"os-list-open-gates\">\u003Ccode>os.list_open_gates\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Every gate waiting on a decision, oldest first: the CEO inbox's own rows.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Every gate waiting on a decision, oldest first: the run and task it belongs to, the tool call it holds (toolName, payload), its summary when the run wrote one, who owns the decision, when it times out, and whether the run can be sent back with changes requested. Read-only: deciding a gate is not a tool here.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Takes no arguments: no fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> Each waiting gate: \u003Ccode>runId\u003C\u002Fcode>, \u003Ccode>taskSlug\u003C\u002Fcode>, \u003Ccode>toolName\u003C\u002Fcode>, \u003Ccode>owner\u003C\u002Fcode>, \u003Ccode>payload\u003C\u002Fcode>, \u003Ccode>summary\u003C\u002Fcode> (when the run wrote one), \u003Ccode>createdAt\u003C\u002Fcode> and its age.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fgates?status=waiting\u003C\u002Fcode> (\u003Ccode>gates:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"os-list-waiting\">\u003Ccode>os.list_waiting\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Open work nothing is working on: no live or queued run, no waiting decision, not on Blockers, not finished.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Every piece of open work nothing is working on, as the Waiting list shows it: one row per issue, pull request or work item whose last run has ended, with no live or queued run, no decision waiting and nothing on Blockers, that is not finished: its last run did not end on an outcome its task declares as finishing the work, nobody has marked it finished, and no person cancelled its last run. Work stays listed however old it is. Read-only: nothing is restarted or finished. Pass no arguments.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Takes no arguments: no fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ rows, total }\u003C\u002Fcode>, longest waiting first. Each row: \u003Ccode>pipeline\u003C\u002Fcode> (\u003Ccode>owner\u002Fname#&lt;number&gt;\u003C\u002Fcode> for an issue or pull request, \u003Ccode>work:&lt;id&gt;\u003C\u002Fcode> for a work item), \u003Ccode>repo\u003C\u002Fcode> and \u003Ccode>number\u003C\u002Fcode> (null for a work item), \u003Ccode>workItem\u003C\u002Fcode> and \u003Ccode>workItemTitle\u003C\u002Fcode> (the item and its title; null for an issue or pull request), the newest \u003Ccode>runId\u003C\u002Fcode> and its \u003Ccode>taskId\u003C\u002Fcode>, \u003Ccode>endedAs\u003C\u002Fcode> (how that run ended: \u003Ccode>succeeded\u003C\u002Fcode>, \u003Ccode>failed\u003C\u002Fcode>, \u003Ccode>cancelled\u003C\u002Fcode>, or \u003Ccode>decision_rejected\u003C\u002Fcode>), the \u003Ccode>reason\u003C\u002Fcode> it gave and what the work \u003Ccode>waitsOn\u003C\u002Fcode> (each null when it named none), \u003Ccode>since\u003C\u002Fcode> (when it ended) and \u003Ccode>waitedMs\u003C\u002Fcode>. \u003Ccode>total\u003C\u002Fcode> is the number of rows.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fwaiting\u003C\u002Fcode> (\u003Ccode>runs:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"os-retry-run\">\u003Ccode>os.retry_run\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Start a stopped run again, with the same input, so its work moves.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Retry one stopped run: start a fresh run of the same task with the same input. Only a run on Blockers: failed, blocked, or finished on an outcome nothing follows, and not already cleared or retried. Pass runId and note (one line on why another run should get through, recorded on the run). Tasks may retry one chain 3 times; past that, escalate it.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>runId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The run id, as \u003Ccode>os.list_blockers\u003C\u002Fcode> names it\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>note\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>Why another run should get through, in one line\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Side effects:\u003C\u002Fstrong> Starts a paid run of the stopped run's task. A blocked run is cancelled as it is retried, and the issue it works is marked in flight again.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. Keyed on the tool call: the same call sent twice starts one run. A retried run is refused afterwards, so a later call starts nothing either.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ runId, retryRunId, status, taskRetries }\u003C\u002Fcode>: the new run, \u003Ccode>queued\u003C\u002Fcode>, or \u003Ccode>pending\u003C\u002Fcode> while its task or member is busy, and how many times tasks have now retried the chain.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.retry_run\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>run_id_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>runId\u003C\u002Fcode> is missing.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>note_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>note\u003C\u002Fcode> is missing or empty.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>run_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>No run with that id in this enterprise.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>own_run\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run named is the one calling.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>not_stopped:&lt;status&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run is not on Blockers: it was cancelled, it finished on an outcome its task follows, or (to retry or clear) it is still active. A stalled or spend-paused run can only be escalated.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>already_retried\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A later run already retried or routed it. Act on that run instead.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>already_cleared\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Someone already cleared it.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>retry_limit_reached\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Tasks have already retried this chain 3 times.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_not_runnable\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run's task is deprecated, has no current version, or has nobody to run it. Escalate it instead.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;runId&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000001&quot;,\n  &quot;note&quot;: &quot;Ran out of steps after pushing most of the change; the next run continues from the branch&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-route-run\">\u003Ccode>os.route_run\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Send a stopped run's work to another task of its pipeline, instead of running the same task again.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Route one stopped run: start a run of another task of its pipeline with the same input, in the same execution, when running the same task again would stop the same way. The task is one that already ran on the run's issue or pull request (send it back to an earlier stage), or one the stopped run's task names as a successor (move it on past this stage). Only a run on Blockers, as for os.retry_run. Pass runId, task (the slug to run next) and note (what that task should do, and why; the new run reads it as routedFrom in its input). Routes and retries share one limit: tasks may retry or route one chain 3 times; past that, escalate it.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>runId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The run id, as \u003Ccode>os.list_blockers\u003C\u002Fcode> names it\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The slug of the task to run next\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>note\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>What that task should do with it, and why, in a line or two\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Side effects:\u003C\u002Fstrong> Starts a paid run of the task named. A blocked run is cancelled as it is routed, and the issue it works is marked in flight again.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. Keyed on the tool call: the same call sent twice starts one run. A routed run is refused afterwards, so a later call starts nothing either.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ runId, routedRunId, task, status, taskRetries }\u003C\u002Fcode>: the new run, \u003Ccode>queued\u003C\u002Fcode>, or \u003Ccode>pending\u003C\u002Fcode> while its task or member is busy, and how many times tasks have now retried or routed the chain.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.route_run\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>run_id_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>runId\u003C\u002Fcode> is missing.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>note_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>note\u003C\u002Fcode> is missing or empty.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>run_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>No run with that id in this enterprise.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>own_run\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run named is the one calling.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>not_stopped:&lt;status&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run is not on Blockers: it was cancelled, it finished on an outcome its task follows, or (to retry or clear) it is still active. A stalled or spend-paused run can only be escalated.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>already_retried\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A later run already retried or routed it. Act on that run instead.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>already_cleared\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Someone already cleared it.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>task\u003C\u002Fcode> is missing.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>same_task\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>task\u003C\u002Fcode> is the stopped run's own task.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_not_in_pipeline\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>No run of that task is on the run's issue or pull request, and its task names no such successor.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>retry_limit_reached\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Tasks have already retried or routed this chain 3 times.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_not_runnable\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The task named is deprecated, has no current version, or has nobody to run it. Escalate it instead.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;runId&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000004&quot;,\n  &quot;task&quot;: &quot;write-red-suite&quot;,\n  &quot;note&quot;: &quot;The locked tests never cover the last acceptance criterion; add them, then implement runs on&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-clear-run\">\u003Ccode>os.clear_run\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Take a stopped run off Blockers without running it again.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Take one stopped run off Blockers without running it again, because nothing more is needed: its issue or pull request is closed or merged, or it is a leftover of a wait someone already ended. A failed run, or one that finished on an outcome nothing follows, is cleared; a blocked run is cancelled. Pass runId and note (why nothing more is needed, recorded on the run). To clear a stale repair escalation after a route, pass replacement with sourceRunId and acceptedRunId: the API verifies the tenant-scoped route audit, original lineage and priorRunId before clearing. A preview alone is refused. Choose workItemState: done only when you verified the work is complete, dropped when no longer wanted, ready only when it should be picked up again, or held to keep it parked. Omitted means held; clearing alone never requeues or completes work. A later run keeps its item.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>runId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The run id, as \u003Ccode>os.list_blockers\u003C\u002Fcode> names it\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>workItemState\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>held\u003C\u002Fcode>, \u003Ccode>ready\u003C\u002Fcode>, \u003Ccode>done\u003C\u002Fcode>, \u003Ccode>dropped\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>What happens to the stopped pipeline’s work item: held (default), ready to retry, done when verified complete, or dropped when no longer wanted.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>note\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>Why nothing more is needed, in one line\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>replacement\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>object\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Accepted replacement evidence when clearing a stale repair escalation after routing.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>replacement.sourceRunId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The original source run that was routed.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>replacement.acceptedRunId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The accepted routed run, never a preview.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Side effects:\u003C\u002Fstrong> Settles the stopped pipeline’s held item only as workItemState requests; omission keeps it held. Records the decision in the item history.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. The same call sent twice clears once. A cleared run is refused afterwards.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ runId, status, cleared }\u003C\u002Fcode>: the run as it now stands.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.clear_run\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>run_id_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>runId\u003C\u002Fcode> is missing.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>note_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>note\u003C\u002Fcode> is missing or empty.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>run_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>No run with that id in this enterprise.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>own_run\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run named is the one calling.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>not_stopped:&lt;status&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run is not on Blockers: it was cancelled, it finished on an outcome its task follows, or (to retry or clear) it is still active. A stalled or spend-paused run can only be escalated.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>already_retried\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A later run already retried or routed it. Act on that run instead.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>already_cleared\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Someone already cleared it.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>replacement_not_accepted\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The named replacement has no verified route acceptance with the source lineage and priorRunId.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_work_item_state\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>workItemState is not held, ready, done or dropped.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;runId&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000002&quot;,\n  &quot;note&quot;: &quot;The pull request merged by hand on 28 Sep&quot;,\n  &quot;workItemState&quot;: &quot;done&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-escalate-run\">\u003Ccode>os.escalate_run\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Hand a stopped run to its team lead, or to the CEO, and record that you did.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Hand one stopped run to someone who can decide it, and record it on the run so nobody hands it on twice. to: lead (the lead of the first of the running member's teams led by someone else, or the COO where there is none; they own the decision from then on) or ceo (record it before you put the question to the CEO with os.ask_ceo). Pass runId, to and note (what is stuck, what was tried, and the move you recommend). os.list_blockers shows the escalation on the row from then on.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>runId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The run id, as \u003Ccode>os.list_blockers\u003C\u002Fcode> names it\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>to\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>lead\u003C\u002Fcode>, \u003Ccode>ceo\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>note\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>What is stuck, what was tried, and the move you recommend\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. Escalating a run again to the same person records nothing new.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ runId, to, memberId, memberName, alreadyEscalated }\u003C\u002Fcode>: who now owns the decision. \u003Ccode>alreadyEscalated\u003C\u002Fcode> is true when the run was already escalated to them, and nothing new is recorded.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.escalate_run\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>run_id_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>runId\u003C\u002Fcode> is missing.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>note_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>note\u003C\u002Fcode> is missing or empty.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>run_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>No run with that id in this enterprise.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>own_run\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run named is the one calling.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>not_stopped:&lt;status&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run is not on Blockers: it was cancelled, it finished on an outcome its task follows, or (to retry or clear) it is still active. A stalled or spend-paused run can only be escalated.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>already_retried\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A later run already retried or routed it. Act on that run instead.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>already_cleared\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Someone already cleared it.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>to_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>to\u003C\u002Fcode> is not \u003Ccode>lead\u003C\u002Fcode> or \u003Ccode>ceo\u003C\u002Fcode>.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_lead\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>None of the running member's teams has a lead other than that member (or they sit on no team), and nobody holds the COO role to act as lead.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;runId&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000003&quot;,\n  &quot;to&quot;: &quot;lead&quot;,\n  &quot;note&quot;: &quot;Loop cap on recover-red-suite (2\u002F2): each lap found the same failing test outside the issue. Recommend closing the loop and filing the test separately.&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-read-enterprise\">\u003Ccode>os.read_enterprise\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>The whole enterprise: teams, charters, roles, members and every task in full.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Read the whole enterprise a plan is proposed against: every team with its charter, roles and members (persona and roles), the members on no team, and every task, OS-owned ones included, in full: goal, metric, guardrails, tools, gates, spend, successors, finishesOn (the outcomes a run ends on that finish its work), its assigneeRole and the members holding it (roleHolderIds; assigneeMemberId when exactly one does), teamIds (the teams that inherit it: each team where a member holds its role, seated or as lead), and lastRunStatus. A task is assigned to a role, never pinned to a member and never placed on a team: a team runs the tasks of the roles its members hold. With no arguments it returns everything. When that is too big to hand back (tool_result_truncated), read it in slices, each with its tasks in full: noTeam: true for the members on no team and the tasks whose role no team holds (OS-owned tasks among them), then team (a team id or slug) for each team, with its roles, members and the tasks of the roles its members hold. A task whose role is held on several teams is in each of their slices. When one team is too big, read it role by role: team with role (a role id or slug from allRoles in that team slice) for its tasks that run as that role, and team with noRole: true for its tasks that run as no role. Every slice lists allTeams, the id and slug of every team; every team slice also lists allRoles, every role its tasks can run as. Together the slices cover every member and task. OS-owned tasks only.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>team\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>A team id or slug: that team, its roles, members and the tasks of the roles its members hold.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>noTeam\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>true: the members on no team and the tasks whose role no team holds.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>role\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>With team only. A role id or slug from allRoles: that team's tasks that run as it.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>noRole\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>With team only. true: that team's tasks that run as no role.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.read_enterprise\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>os_owned_only\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run's task is not OS-owned. These tools read every team's work, so only an OS task may call them.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>team_not_found:&lt;team&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>No team in this enterprise has that id or slug. Read allTeams with noTeam: true.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>team_selector_conflict\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Both \u003Ccode>team\u003C\u002Fcode> and \u003Ccode>noTeam\u003C\u002Fcode> are set.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>role_requires_team\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>role\u003C\u002Fcode> or \u003Ccode>noRole\u003C\u002Fcode> is set without \u003Ccode>team\u003C\u002Fcode>: they narrow one team.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>role_not_found:&lt;role&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>No task on that team can run as a role with that id or slug. The message lists the team's allRoles.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>role_selector_conflict\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Both \u003Ccode>role\u003C\u002Fcode> and \u003Ccode>noRole\u003C\u002Fcode> are set.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;noTeam&quot;: true\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;team&quot;: &quot;engineering&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;team&quot;: &quot;engineering&quot;,\n  &quot;role&quot;: &quot;cto&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;team&quot;: &quot;engineering&quot;,\n  &quot;noRole&quot;: true\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-search-catalog\">\u003Ccode>os.search_catalog\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Published catalog tasks that match a plain-English intent, best first.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Find published catalog tasks that match a plain-English intent, best match first (at most 10), so a plan proposes something proven instead of inventing it. Scored on the words of the intent found in a task slug or name; an intent of only filler words matches nothing. Pass intent.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>intent\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.search_catalog\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>os_owned_only\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run's task is not OS-owned. These tools read every team's work, so only an OS task may call them.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;intent&quot;: &quot;Triage a new GitHub issue&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-list-tool-bindings\">\u003Ccode>os.list_tool_bindings\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>The tool types this enterprise has bound, at which layer, and the tools each exposes.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">List the tool types this enterprise has bound, the layer each is bound at, and the individual tools each one exposes, asked of its MCP server. A proposal may only name tools of a bound type. A server that will not answer lists no tools, and its binding is still reported.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Takes no arguments: no fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Needs:\u003C\u002Fstrong>\n\u003Cul>\n\u003Cli>Each binding's own credential, to ask its server which tools it exposes.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.list_tool_bindings\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>os_owned_only\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run's task is not OS-owned. These tools read every team's work, so only an OS task may call them.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-list-built-in-tools\">\u003Ccode>os.list_built_in_tools\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Every built-in tool a run can call, with its summary and whether it reads or writes.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">List every built-in tool a run can call: its name, a one-line summary, and its effect (read or write). A task may declare a built-in tool (os.*, workspace.*, memory.*, web.*) only from this list: saving a task that names any other is refused, as a tool that does not exist (tool_unknown) or one only the CEO chat offers (tool_not_run_callable). A row with gate is a tool a task may hold only if it also declares a CEO gate on the tool gate names: saving it without that gate is refused (gate_required_for_tool). Vendor tools are not here: os.list_tool_bindings lists what the enterprise has bound. Takes no arguments.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Takes no arguments: no fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>[{ name, summary, effect, gate? }]\u003C\u002Fcode>: one row per built-in tool a run can call, in reference order. \u003Ccode>gate\u003C\u002Fcode> is only on a tool a task may hold only with a CEO gate, and names the tool that gate is declared on.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Ftools\u002Fbuilt-in?callable=run\u003C\u002Fcode> (\u003Ccode>tools:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>os_owned_only\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run's task is not OS-owned. These tools read every team's work, so only an OS task may call them.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-read-task\">\u003Ccode>os.read_task\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>One task in full, its pending recommendations, and the tasks that start it.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">One task in full (as os.read_enterprise reads a task), the improvement recommendations still pending against it, and incomingSuccessors: the tasks whose successors start it. Its own successors are what it starts. The task also carries currentVersionId, the version this read is of: an update_task item you write from it names that as its baseVersionId. Pass taskId.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>taskId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.read_task\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>os_owned_only\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run's task is not OS-owned. These tools read every team's work, so only an OS task may call them.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_id_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>taskId\u003C\u002Fcode> is missing.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>No task in this enterprise has that id.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;taskId&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000001&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-assess-impact\">\u003Ccode>os.assess_impact\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>What points at a role, team, task or member a plan would delete.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">What points at a role, team, task or member a plan would delete. role: the members holding it and the tasks assigned to it. team: the roles held on it and the members on it; the tasks it runs belong to those roles and stay with their holders, so only its roster stands in the way of deleting it. task: the tasks whose successors name it and its runs in flight. member: the roles they hold, the teams they sit on and the tasks their roles run. Reported, never refused: the plan says what the deletion breaks. Pass kind and id.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kind\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>role\u003C\u002Fcode>, \u003Ccode>team\u003C\u002Fcode>, \u003Ccode>task\u003C\u002Fcode>, \u003Ccode>member\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.assess_impact\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>os_owned_only\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run's task is not OS-owned. These tools read every team's work, so only an OS task may call them.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode> is missing.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kind_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>kind\u003C\u002Fcode> is not role, team, task or member.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;kind&quot;: &quot;role&quot;,\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000002&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-write-plan\">\u003Ccode>os.write_plan\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Write or replace this conversation's plan, checked before the CEO sees it.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Write this conversation's plan for the CEO, or replace it: one plan per conversation, and a replace carries the version os.read_plan returned. The conversation is the chatSessionId you pass when you have one, else the planKey in your run's input, which the OS fills with the first proposing run's id and every later round carries, so you never pass planKey yourself. Every item is checked first, and the first problem comes back as the reason: a tool whose type this enterprise has not bound, a slug it already has, a task pinned to a member (set assigneeRole), a task placed on a team (a task belongs to a role: drop teamId and teamHandle and seat a holder of its role on the team instead), a task whose role nobody holds and no item in the plan gives to anyone, a task definition a saved task would fail, or an update_task item whose task has moved on from the version it names. An update_task item names the version it was written from as baseVersionId: the currentVersionId os.read_task returned. One that names none is given the version current as the plan is written. Fix it and write again. Pass summary, ceoIntent, kind (default os_change), items, the chatSessionId from your input when you have one and, to replace, version.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>chatSessionId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>summary\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>ceoIntent\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kind\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>items\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of object\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>version\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, at least 1\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Side effects:\u003C\u002Fstrong> Moves the plan to \u003Ccode>awaiting_ceo\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. A repeat replaces the same plan with the same content rather than adding a second. A repeat carrying a version the plan has moved past is refused as \u003Ccode>plan_version_conflict\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.write_plan\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>os_owned_only\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run's task is not OS-owned. These tools read every team's work, so only an OS task may call them.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>plan_key_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>No \u003Ccode>chatSessionId\u003C\u002Fcode> was passed and the run carries no \u003Ccode>planKey\u003C\u002Fcode> in its input, so the plan has no conversation to belong to.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>summary_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>summary\u003C\u002Fcode> is missing.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>plan_payload_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An item is not one the plan can apply (a missing handle, an unknown type).\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>tool_type_not_bound:&lt;type&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An item names a tool whose type this enterprise has not bound.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>slug_collision:&lt;slug&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An item creates a task, role or team with a slug the enterprise already has.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>assignee_member_removed\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A \u003Ccode>create_task\u003C\u002Fcode> item names \u003Ccode>assigneeMemberId\u003C\u002Fcode>. A task is assigned to a role: set \u003Ccode>assigneeRole\u003C\u002Fcode>.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_team_removed:&lt;slug&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A \u003Ccode>create_task\u003C\u002Fcode> or \u003Ccode>update_task\u003C\u002Fcode> item names \u003Ccode>teamId\u003C\u002Fcode> or \u003Ccode>teamHandle\u003C\u002Fcode>. A task belongs to a role, not a team: a team runs the tasks of the roles its members hold. Seat a holder of the task’s role on the team instead.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>role_unplaced:&lt;role&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A task runs as a role nobody holds, and no item in the plan creates a member who holds it, so it would never start.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>definition_issue:&lt;code&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A proposed task fails the check a saved task must pass (an unknown successor, a deterministic task with tools).\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>plan_version_conflict\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>version\u003C\u002Fcode> is not the version the plan is at now. Read it back with os.read_plan and write again.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_version_conflict\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>An \u003Ccode>update_task\u003C\u002Fcode> item's \u003Ccode>baseVersionId\u003C\u002Fcode> is not its task's current version: someone published since you read it. The reason names the current version. Read the task again with os.read_task and write the change against that.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;chatSessionId&quot;: &quot;chat-42&quot;,\n  &quot;ceoIntent&quot;: &quot;Hire a support lead&quot;,\n  &quot;summary&quot;: &quot;Creates a Support Lead role&quot;,\n  &quot;kind&quot;: &quot;os_change&quot;,\n  &quot;items&quot;: [\n    {\n      &quot;type&quot;: &quot;create_role&quot;,\n      &quot;handle&quot;: &quot;r1&quot;,\n      &quot;slug&quot;: &quot;support-lead&quot;,\n      &quot;name&quot;: &quot;Support Lead&quot;\n    }\n  ]\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-read-plan\">\u003Ccode>os.read_plan\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>This conversation's plan as it stands, with its version.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Read this conversation's plan as it stands, with the version a replacing os.write_plan must carry, so a feedback round continues it rather than starting again. The conversation is the chatSessionId you pass when you have one, else the planKey in your run's input, which every round of the conversation carries. Null when the conversation has no plan. With neither, the plan this run wrote.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>chatSessionId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.read_plan\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>os_owned_only\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run's task is not OS-owned. These tools read every team's work, so only an OS task may call them.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;chatSessionId&quot;: &quot;chat-42&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-chat-list\">\u003Ccode>os.chat_list\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>List chat threads, most recently active first: who each is with, its state and its last message.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">List chat threads, most recently active first: each thread’s id, its state (idle, replying or closed), and its last message. In a run these are the enterprise owner’s threads with the member doing the run, the ones the OS files into: never another person’s private chats, and memberId is ignored. Over the API they are the threads you own, or only one member’s when you pass memberId. No message bodies beyond the last: read a thread with os.chat_read. A conversation opened for one job, such as designing a task, is never listed.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>memberId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Over the API: only threads with this member. A run always lists its own member’s.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Needs:\u003C\u002Fstrong>\n\u003Cul>\n\u003Cli>In a run, the run's assigned member: the threads are always theirs, and an OS-owned task has none. Over the API and the MCP server, any thread of the enterprise the token can reach.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> To a run: \u003Ccode>{ threads }\u003C\u002Fcode>, each with \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>status\u003C\u002Fcode> (\u003Ccode>idle\u003C\u002Fcode>, \u003Ccode>replying\u003C\u002Fcode> or \u003Ccode>closed\u003C\u002Fcode>), \u003Ccode>lastMessage\u003C\u002Fcode> (\u003Ccode>role\u003C\u002Fcode>, \u003Ccode>content\u003C\u002Fcode>, \u003Ccode>createdAt\u003C\u002Fcode>, or null in an empty thread), \u003Ccode>lastReadAt\u003C\u002Fcode> (when a person last opened it, or null), \u003Ccode>createdAt\u003C\u002Fcode> and \u003Ccode>updatedAt\u003C\u002Fcode>. Over the API: the Chat page’s rows as they are, which add the \u003Ccode>member\u003C\u002Fcode> and the \u003Ccode>unread\u003C\u002Fcode> and \u003Ccode>unreadCount\u003C\u002Fcode> of the person’s side.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fchats\u003C\u002Fcode> (\u003Ccode>chats:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_assigned_member\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A run with no assigned member called it, so there is no thread.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-chat-read\">\u003Ccode>os.chat_read\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Read one chat thread: its messages, oldest first.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Read one chat thread: its messages, oldest first, each with who wrote it. Pass id from os.chat_list, and optionally limit to read only the newest messages (up to 200). In a run you get what was said (people’s messages and the member’s), the newest 50 unless you pass limit, in one of the threads os.chat_list shows you, and reading does not mark the thread read. Over the API you get every row, tool calls included, in a thread you own or reach by its link, and reading marks it read for its owner, as opening it in the portal does.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>A thread id from os.chat_list\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>limit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, 1 to 200\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only the newest messages, up to 200. In a run it defaults to 50; over the API, to all of them.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Side effects:\u003C\u002Fstrong> Over the API and the MCP server, marks the thread read, the same as opening it in the portal. In a run, nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Needs:\u003C\u002Fstrong>\n\u003Cul>\n\u003Cli>In a run, the run's assigned member: the threads are always theirs, and an OS-owned task has none. Over the API and the MCP server, any thread of the enterprise the token can reach.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> To a run: \u003Ccode>{ id, status, total, messages }\u003C\u002Fcode>, where \u003Ccode>total\u003C\u002Fcode> counts every message said in the thread and each message has \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>role\u003C\u002Fcode> (\u003Ccode>user\u003C\u002Fcode> for a person or an API token, \u003Ccode>assistant\u003C\u002Fcode> for the member), \u003Ccode>content\u003C\u002Fcode>, \u003Ccode>sender\u003C\u002Fcode> (the name of whoever wrote a \u003Ccode>user\u003C\u002Fcode> message, else null) and \u003Ccode>createdAt\u003C\u002Fcode>. Over the API: the thread as the portal reads it, with its \u003Ccode>member\u003C\u002Fcode> and every row, each with its \u003Ccode>sender\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fchats\u002F:id\u003C\u002Fcode> (\u003Ccode>chats:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_assigned_member\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A run with no assigned member called it, so there is no thread.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>chat_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>No thread has that id: in a run, including another member's thread, another person's, and a conversation opened for one job.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000021&quot;,\n  &quot;limit&quot;: 20\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-chat-write\">\u003Ccode>os.chat_write\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Write one message in a chat thread, as yourself.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Write one message in a chat thread, as yourself. Pass content: Markdown. In a run you write as the member doing the run, for the enterprise’s people to read, and it is drawn as the member’s formatted text: paragraphs with their line breaks kept, bulleted and numbered lists, bold, and links, written [text](https:\u002F\u002F…) or as a bare web address. It shows as unread until someone opens the thread, nobody replies to the run, and the run carries on. Leave id out to write in the enterprise owner’s open thread with the member (one the owner owns is opened if there is none), or pass id from os.chat_list. At most 4000 characters in a run. For a question you need answered, use os.ask_ceo. Over the API, id is required, you write as the person or token calling, shown as you typed it with web addresses linked, and the member replies: the response is the thread with that reply in it. Sends no mail and opens no gate. A repeat writes the message again.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The thread, from os.chat_list. A run may leave it out to write in the enterprise owner’s open thread with its member. Required over the API.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>content\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The message, as Markdown\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Side effects:\u003C\u002Fstrong> In a run, one message from the member in the thread. Over the API, one message from the caller and a reply turn by the member, which spends on the enterprise’s model keys.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Not retry-safe: a repeat acts again. A repeat writes the message again: call it once for each thing you have to say.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Needs:\u003C\u002Fstrong>\n\u003Cul>\n\u003Cli>In a run, the run's assigned member: the threads are always theirs, and an OS-owned task has none. Over the API and the MCP server, any thread of the enterprise the token can reach.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> To a run: \u003Ccode>{ written: true, id, messageId }\u003C\u002Fcode>, the thread it went in and the message. Over the API: the thread as os.chat_read returns it, with the member’s reply.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fchats\u002F:id\u002Fmessages\u003C\u002Fcode> (\u003Ccode>chats:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_assigned_member\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A run with no assigned member called it, so there is no thread.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>chat_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>No thread has that id: in a run, including another member's thread, another person's, and a conversation opened for one job.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>empty_message\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>content\u003C\u002Fcode> is missing, not text, or blank.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>message_too_long\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>In a run, \u003Ccode>content\u003C\u002Fcode> is longer than 4000 characters.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>chat_closed\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The thread is closed.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>chat_replying\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Over the API, the member is still replying to an earlier message in the thread.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;content&quot;: &quot;New enquiry\\nFrom: jo@example.com\\nAsking about: the Team plan&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example, Over the API: a person’s message to the member, answered in the response.:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000021&quot;,\n  &quot;content&quot;: &quot;Where did last week’s report go?&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-chat-open\">\u003Ccode>os.chat_open\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Open a new chat thread with a member.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Open a new, empty chat thread with a member, and get its id to write in with os.chat_write. Pass memberId. Nothing is said and nothing is spent until a message is written. A run cannot call it: a run’s os.chat_write opens its member’s thread when there is none.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>memberId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The member to talk to\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Not retry-safe: a repeat acts again. A repeat opens another thread with the same member.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The new thread: its \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>memberId\u003C\u002Fcode>, \u003Ccode>status\u003C\u002Fcode> (\u003Ccode>idle\u003C\u002Fcode>) and times.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fchats\u003C\u002Fcode> (\u003Ccode>chats:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>memberId_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>memberId\u003C\u002Fcode> is missing.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>member_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>No member of this enterprise has that id.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;memberId&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000007&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-list-roles\">\u003Ccode>os.list_roles\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>The enterprise's roles, by slug.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">List the enterprise's roles, ordered by slug: each one's id, name and slug. A role is a job across the enterprise, held by members on any team; it belongs to no team. No arguments. Never another enterprise's roles.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Takes no arguments: no fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the CEO chat, the API, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> One row per role, each with \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>name\u003C\u002Fcode> and \u003Ccode>slug\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Froles\u003C\u002Fcode> (\u003Ccode>roles:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-read-role\">\u003Ccode>os.read_role\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>One role, with the members who hold it and the tasks that run as it.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Read one role: its name and slug, the members who hold it (members), the teams those members sit on (teams, each with its holders), and the tasks that run as it (tasks). Not found for a role in another enterprise.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The role, by its id from os.list_roles.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the CEO chat, the API, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The role: \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>name\u003C\u002Fcode>, \u003Ccode>slug\u003C\u002Fcode>, \u003Ccode>members\u003C\u002Fcode> (who holds it), \u003Ccode>teams\u003C\u002Fcode> (where it is held, each with its holders) and \u003Ccode>tasks\u003C\u002Fcode> (what runs as it).\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Froles\u002F:id\u003C\u002Fcode> (\u003Ccode>roles:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>role_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode> names no role in this enterprise, another enterprise's included.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000011&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-create-role\">\u003Ccode>os.create_role\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Create a role.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Create a role with a name and, optionally, a slug. A slug left out is made from the name. A slug, or a name with no slug, another role already has is refused with role_slug_taken. A role belongs to no team: it is held by members, every holder runs the role’s tasks on whatever team they sit, and a team runs the tasks of the roles its members hold. The response is the role as created.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>name\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The role’s name, up to 200 characters.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>slug\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The role’s slug, unique in the enterprise. Made from the name when left out.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Not retry-safe: a repeat acts again. Every call creates a role. A repeat with the same slug is refused (role_slug_taken) rather than creating a second.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the CEO chat, the API, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The role as created: \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>name\u003C\u002Fcode>, \u003Ccode>slug\u003C\u002Fcode>, \u003Ccode>members\u003C\u002Fcode>, \u003Ccode>teams\u003C\u002Fcode> and \u003Ccode>tasks\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Froles\u003C\u002Fcode> (\u003Ccode>roles:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>role_slug_taken\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Another role in this enterprise already has that slug. A role given no slug takes one made from its name, so a name already taken is refused this way too.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;name&quot;: &quot;Support lead&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-update-role\">\u003Ccode>os.update_role\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Change a role's name or slug.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Change a role's name or slug; a field left out keeps its value. A slug another role already has is refused with role_slug_taken. The response is the role after the change.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The role, by its id from os.list_roles.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>name\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The role’s new name, up to 200 characters.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>slug\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The role’s new slug, unique in the enterprise. A task names its role by this slug.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. The same fields set twice leave the role as the first call did.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the CEO chat, the API, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The role after the change: \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>name\u003C\u002Fcode>, \u003Ccode>slug\u003C\u002Fcode>, \u003Ccode>members\u003C\u002Fcode>, \u003Ccode>teams\u003C\u002Fcode> and \u003Ccode>tasks\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>PATCH \u002Fv1\u002Froles\u002F:id\u003C\u002Fcode> (\u003Ccode>roles:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>role_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode> names no role in this enterprise, another enterprise's included.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>role_slug_taken\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Another role in this enterprise already has that slug. A role given no slug takes one made from its name, so a name already taken is refused this way too.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000011&quot;,\n  &quot;name&quot;: &quot;Support head&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-delete-role\">\u003Ccode>os.delete_role\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Remove a role nobody holds and no task runs as.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Remove a role. A role a member still holds, or a task still runs as, is refused with role_has_dependents, naming each: take them off it first. The call is the confirmation, so the tool takes no confirm argument.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The role, by its id from os.list_roles.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. A repeat finds the role already gone and is refused with role_not_found, removing nothing else.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the CEO chat, the API, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> Nothing: the role is gone.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>DELETE \u002Fv1\u002Froles\u002F:id?confirm=true\u003C\u002Fcode> (\u003Ccode>roles:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>role_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode> names no role in this enterprise, another enterprise's included.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>role_has_dependents\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A member still holds the role or a task still runs as it. The refusal names each.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000011&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-add-role-task\">\u003Ccode>os.add_role_task\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Give a role a task: the task runs as that role.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Give a role a task: the task runs as this role from now on, in place of any role it ran as before. The response is the role after the change.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The role, by its id from os.list_roles.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>taskId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The task that runs as the role.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. A task already on the role stays on it once.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the CEO chat, the API, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The role after the change, with the task among its \u003Ccode>tasks\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Froles\u002F:id\u002Ftasks\u003C\u002Fcode> (\u003Ccode>roles:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>role_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode> names no role in this enterprise, another enterprise's included.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>taskId\u003C\u002Fcode> names no task in this enterprise.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000011&quot;,\n  &quot;taskId&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000013&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-remove-role-task\">\u003Ccode>os.remove_role_task\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Take a task away from a role.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Take a task away from a role: the task runs as no role until it is given one. A task that does not run as this role is refused with task_not_on_role. The response is the role after the change.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The role, by its id from os.list_roles.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>taskId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The task to take off the role.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. A repeat finds the task already off the role and is refused with task_not_on_role, changing nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the CEO chat, the API, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The role after the change, without the task among its \u003Ccode>tasks\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>DELETE \u002Fv1\u002Froles\u002F:id\u002Ftasks\u002F:taskId\u003C\u002Fcode> (\u003Ccode>roles:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>role_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode> names no role in this enterprise, another enterprise's included.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>taskId\u003C\u002Fcode> names no task in this enterprise.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_not_on_role\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The task does not run as this role.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000011&quot;,\n  &quot;taskId&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000013&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-add-role-member\">\u003Ccode>os.add_role_member\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Give a role a member: the member holds it.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Give a role a member: the member holds the role from now on. The response is the role after the change.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The role, by its id from os.list_roles.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>memberId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The member who holds the role.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. A member who already holds the role holds it once.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the CEO chat, the API, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The role after the change, with the member among its \u003Ccode>members\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Froles\u002F:id\u002Fmembers\u003C\u002Fcode> (\u003Ccode>roles:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>role_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode> names no role in this enterprise, another enterprise's included.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>member_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>memberId\u003C\u002Fcode> names no member in this enterprise.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000011&quot;,\n  &quot;memberId&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000014&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-remove-role-member\">\u003Ccode>os.remove_role_member\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Take a member away from a role.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Take a member away from a role: the member no longer holds it. The response is the role after the change.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The role, by its id from os.list_roles.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>memberId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The member to take off the role.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. A member who no longer holds the role stays off it.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the CEO chat, the API, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The role after the change, without the member among its \u003Ccode>members\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>DELETE \u002Fv1\u002Froles\u002F:id\u002Fmembers\u002F:memberId\u003C\u002Fcode> (\u003Ccode>roles:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>role_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode> names no role in this enterprise, another enterprise's included.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>member_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>memberId\u003C\u002Fcode> names no member in this enterprise.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000011&quot;,\n  &quot;memberId&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000014&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-list-task-definitions\">\u003Ccode>os.list_task_definitions\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>The enterprise's tasks, built-in ones included, a page at a time, each marked builtIn.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">List the enterprise's tasks, a page at a time: the ones it wrote or copied, and the OS's built-in tasks every enterprise runs. Each row carries its id, slug, name, kind, status, origin, builtIn (true for a shared built-in definition, false for one of the enterprise’s own), its role and the teams that inherit it (teams: the teams where a member holds that role), currentVersionId and currentVersion (its version number and declared fields). Narrow it with search (slug, name or role), kind, status, origin, teamId, assigneeRole, memberId, name or slug, and sort it by slug, name, kind, status, createdAt or updatedAt. Read one task in full, its skill text included, with os.read_task_definition. The response is { data, total, page, limit, pages }. Never another enterprise's tasks.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>search\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only tasks whose slug, name or role contains this text.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kind\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>llm\u003C\u002Fcode>, \u003Ccode>deterministic\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only tasks of this kind.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>status\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>active\u003C\u002Fcode>, \u003Ccode>deprecated\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only tasks in this status.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>origin\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>tenant\u003C\u002Fcode>, \u003Ccode>os\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>tenant for the enterprise’s own tasks, os for the built-in ones.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>teamId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only the tasks of the roles held on this team, by a seated member or its lead.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>assigneeRole\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only the tasks that run as this role, by its slug.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>memberId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only the tasks of the roles this member holds in the enterprise.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>name\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only tasks whose name contains this text.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>slug\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only tasks whose slug contains this text.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>sort\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>slug\u003C\u002Fcode>, \u003Ccode>name\u003C\u002Fcode>, \u003Ccode>kind\u003C\u002Fcode>, \u003Ccode>status\u003C\u002Fcode>, \u003Ccode>createdAt\u003C\u002Fcode>, \u003Ccode>updatedAt\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The field to sort by. Defaults to slug.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>order\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>asc\u003C\u002Fcode>, \u003Ccode>desc\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The sort direction. Defaults to desc.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>page\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, at least 1\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The page to read, from 1. Defaults to 1.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>limit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, 1 to 200\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Tasks per page, up to 200. Defaults to 25.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the CEO chat, the API, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ data, total, page, limit, pages }\u003C\u002Fcode>, each task with \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>slug\u003C\u002Fcode>, \u003Ccode>name\u003C\u002Fcode>, \u003Ccode>kind\u003C\u002Fcode>, \u003Ccode>status\u003C\u002Fcode>, \u003Ccode>origin\u003C\u002Fcode>, \u003Ccode>builtIn\u003C\u002Fcode>, \u003Ccode>currentVersionId\u003C\u002Fcode> and \u003Ccode>currentVersion\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Ftasks\u003C\u002Fcode> (\u003Ccode>tasks:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;search&quot;: &quot;triage&quot;,\n  &quot;origin&quot;: &quot;tenant&quot;,\n  &quot;limit&quot;: 10\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-read-task-definition\">\u003Ccode>os.read_task_definition\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>One task in full: its skill text, declared fields, version number and current version id.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Read one of the enterprise's tasks in full, as it is live now: its skill text (skillMd), its current version (currentVersion, with its version number and its declared fields, inputs) and currentVersionId, the identity of that version, which a later change to the task names as the version it builds on, and this enterprise's own values for those inputs (inputValues). It also says whether the task is a shared built-in definition (builtIn), and carries its role, the teams that inherit it (teams: the teams where a member holds that role), its predecessors and successors. Pass id, from os.list_task_definitions. Not found for a task in another enterprise.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The task, by its id from os.list_task_definitions.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the CEO chat, the API, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The task with \u003Ccode>builtIn\u003C\u002Fcode>, \u003Ccode>skillMd\u003C\u002Fcode>, \u003Ccode>currentVersionId\u003C\u002Fcode> and \u003Ccode>currentVersion\u003C\u002Fcode> (its \u003Ccode>version\u003C\u002Fcode> number and declared \u003Ccode>inputs\u003C\u002Fcode>), and what the portal’s task page shows beside them.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Ftasks\u002F:id\u003C\u002Fcode> (\u003Ccode>tasks:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode> names no task in this enterprise, another enterprise's included.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000013&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-create-task\">\u003Ccode>os.create_task\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Create one of the enterprise’s own tasks.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Create one of the enterprise’s own tasks. Pass name, goal, metric ({ text }) and skillMd. A slug left out is made from the name. kind defaults to llm, and status and runStatus default to active. Leave gates out and the task is given the default CEO gates; send gates as [] to declare none. A task that declares this tool is refused when it is saved. A task reaches it only through a bound connection to the OS’s own MCP server, with a gate naming the tool, as with every write that server serves. The OS’s built-in tasks are created with a release, never through this tool, and a slug one of them holds is reserved. Give the task to a role with assigneeRole: a task belongs to a role, not a team, and a team runs it by seating a holder of that role. Over this tool the create is refused with definition_issues, and nothing is saved, while the definition carries a routing issue: outcome_not_routed, named with the word (the skill tells a run to end on an outcome that no successor, finishesOn entry or plain success handles), self_loop_unconditional (a successor back to its own slug with no delayMinutes, other than ceo_approved or ceo_changes_requested), or asks_ceo_without_resume (it asks the CEO, does more work after the answer, and has no ceo_approved successor back to its own slug). Fix each and create it again. The response is the task as created, including id and currentVersionId.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>name\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The task’s name, trimmed, at most 200 characters.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>slug\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>A slug of letters, digits and hyphens, at most 80 characters.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kind\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>llm\u003C\u002Fcode>, \u003Ccode>deterministic\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>llm or deterministic. A deterministic task has no tools.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>status\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>active\u003C\u002Fcode>, \u003Ccode>deprecated\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>active or deprecated.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>assigneeRole\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The role whose holders run the task, by the role’s slug. A task is given to a role, never a team: every holder of the role runs it, on whatever team they sit, and a team runs the tasks of the roles its members hold. assigneeMemberId is refused.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>goal\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>What the task is for, in one or two sentences.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>metric\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>object\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>How the task is judged, as { text }.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>guardrails\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Sentences the task must hold to. Each item is plain text.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>tools\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The tools the task may call. Each item is a tool name, as a string, such as &quot;acme.merge_pull_request&quot;. An entry that is an object, including one carrying its own gates or marked optional, cannot be sent through this tool: sending tools replaces them all, so leave tools out to keep the current ones.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>inputs\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of object\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The inputs, as { key, label, type, required?, configuration?, requiredGroup?, entries? }. type is string, number, boolean, link or file. configuration marks persistent enterprise setup. requiredGroup requires at least one input in the group; every member must agree on configuration. A string map may declare entries: { keyInput, separator }: comma-separated key\u002Fvalue entries must cover the resolved keyInput at each start. Missing required configuration prevents a run from starting.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>gates\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of object\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Gates on tools that reach outside. Each object is { tool, owner, approval }. On create, leave it out and the task is given the default CEO gates; on publish, leave it out and the current gates stay. Send [] to declare none, which is refused when a tool still requires a gate.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>spend\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>object\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Spend limits, as { moneyUsdPerRun, maxModelTier, model, maxSteps }. Leave model out, or send &quot;auto&quot;, and a model is chosen for each run by what the work needs, no higher than maxModelTier (economical, mid or frontier) when that is set. Send an exact model id as model to use that model for every run. maxSteps is how many steps a run gets, a whole number from 1 to 400; leave it out for the default for the tool shape (24, or 120 with workspace or Computer-Use tools). The run input maxSteps and the operator setting LLM_MAX_STEPS still win over it.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>workspace\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>object\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The clone the task may change, as { branch, onDefaultBranch, writeAllow, rewriteAllow, writeDeny, appendOnly, pushAllow, requireFiles, credentials }. Each list is strings but \u003Ccode>credentials\u003C\u002Fcode>, which is [{ tool, as, prop? }]: a bound tool's secret (or its custom prop) as the environment variable \u003Ccode>as\u003C\u002Fcode> of the run's repository commands; \u003Ccode>onDefaultBranch: true\u003C\u002Fcode> keeps the run on the default branch's tip, with no branch of its own and nothing to push; \u003Ccode>pushAllow\u003C\u002Fcode> lists the full ref globs (\u003Ccode>refs\u002Fheads\u002Fmain\u003C\u002Fcode>, \u003Ccode>refs\u002Ftags\u002Fv*\u003C\u002Fcode>) a run may push with \u003Ccode>workspace.git_push\u003C\u002Fcode>'s \u003Ccode>ref\u003C\u002Fcode> besides its own branch, and needs \u003Ccode>writeAllow\u003C\u002Fcode>.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>successors\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of object\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>What runs after this task. Each object is { slug, on, when, delayMinutes, maxRunsPerIssue, escalate, verificationAnyOf }. on is succeeded, failed or terminal.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>finishesOn\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Outcome names that finish the work. Each item is plain text, at most 16.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>maxRunsPerExecution\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, at least 1\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The most countable runs this task may have in one execution before its next start is logged or stopped, a whole number of at least 1. Counted per task across the execution, whichever handoff started each run. Never applied below the highest maxRunsPerIssue on a successor into the task. Left out on create, or never set, EXECUTION_MAX_TASK_RUNS applies; left out on publish, the current value stays.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>toolSlots\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of object\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Tool slots the task’s tools may be named by in place of one vendor’s tool type, at most 16. Each object is { key, label, description?, actions? }: key reads like a tool type (codehost), label is what a person choosing a binding reads. A tool named &quot;codehost&quot; or &quot;codehost.&lt;tool&gt;&quot; is then filled per enterprise by the binding that lists codehost among the slots it fills, and runs as that binding’s tool type. actions is a list of { name, description? }, at most 32, the actions the task names under the key (&quot;codehost.pr.merge&quot;); the filling binding maps each to one of its own tools, so the task names no vendor’s tool.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>callLimits\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of object\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>How often one run may make a call, at most 16. Each object is { tool, match?, perRun }: tool is one tool the task’s tools reach, by its exact name (&quot;acme.issue_write&quot;); match names payload fields the call must carry to count, as a gate’s match does ({ &quot;method&quot;: &quot;create&quot; }); perRun is a whole number of at least 1. A call past the limit is not sent, and the run reads call_limit_reached instead.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>mailboxAction\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>object\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Where a mailbox offers this task as a one-click button, as { on, label }. on is mailbox (a button above the mailbox’s list; the run starts with no input of the OS’s) or mail (a button on one open message; the run starts with that message’s id as its emailId input, so the task has to declare an input with that key). label is the button’s words, at most 40 characters. A public template that declares one is offered to clone on inboxes that have no such task yet. Leave it out to offer none.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>skillMd\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The skill text, markdown, telling the model how to do the job.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>contextPrefixes\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Key prefixes loaded into input.context when a run starts. Each item is plain text.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>trainGrants\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of object\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Team or enterprise notes a run of this task may write. Each object is { layer, eventIdPrefix }, layer team or enterprise. A team note goes to each team the running member sits on or leads.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>overlapPolicy\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>skip\u003C\u002Fcode>, \u003Ccode>os\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>skip waits behind the member’s other work. os runs beside it.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>serializeOn\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Input keys that partition this task’s work into lanes, up to 8. Each item is plain text.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>runStatus\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>active\u003C\u002Fcode>, \u003Ccode>disabled\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>active, the default, or disabled. disabled keeps runs from starting.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Not retry-safe: a repeat acts again. Every call creates a task. A repeat with the same slug is refused (task_slug_taken) rather than returning the first.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The task as created: \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>slug\u003C\u002Fcode>, \u003Ccode>currentVersionId\u003C\u002Fcode>, \u003Ccode>currentVersion\u003C\u002Fcode>, \u003Ccode>skillMd\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Ftasks\u003C\u002Fcode> (\u003Ccode>tasks:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_name\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>name\u003C\u002Fcode> is empty, or longer than 200 characters.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_slug\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The slug is empty once cleaned, or longer than 80 characters.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_slug_taken\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>This enterprise already has a task with that slug.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_team_removed\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The call names a team for the task. A task belongs to a role, not a team: a team runs the tasks of the roles its members hold. Seat a holder of the task’s role on the team instead.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_task_definition\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The definition fails a check: a deterministic task with tools, a merge or mail or plan gate that is missing, a successor the rules refuse, a call limit on a tool the task does not declare (call_limit_tool_not_declared).\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>definition_issues\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A create over the OS’s own MCP server whose definition would stop or loop its own pipeline: it carries outcome_not_routed (named with the word), self_loop_unconditional or asks_ceo_without_resume. Nothing is saved, and issues lists each one.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>call_limits_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>callLimits\u003C\u002Fcode> is not a list of up to 16 objects. The refusal names the fault instead when one limit is wrong: call_limit_tool_invalid (not one tool by its exact name), call_limit_match_invalid:&lt;tool&gt; (not a gate-shaped match) or call_limit_per_run_invalid:&lt;tool&gt; (not a whole number of at least 1).\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>serialize_on_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>serializeOn\u003C\u002Fcode> is not a list of up to 8 input keys.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>tool_entry_unreadable\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A \u003Ccode>tools\u003C\u002Fcode> entry names no tool.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>llm_model_not_in_catalogue\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>spend.model\u003C\u002Fcode> is not a model a connected provider offers.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>os_task_immutable\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The task is one of the OS's own: the same in every enterprise, changed only with a release.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;name&quot;: &quot;Triage new issues&quot;,\n  &quot;goal&quot;: &quot;Label a new issue and hand it to the right pipeline.&quot;,\n  &quot;metric&quot;: {\n    &quot;text&quot;: &quot;Each new issue is labelled or handed on within a day.&quot;\n  },\n  &quot;skillMd&quot;: &quot;# Triage new issues\\n\\nRead the issue and label it.\\n&quot;,\n  &quot;assigneeRole&quot;: &quot;engineer&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-publish-task-version\">\u003Ccode>os.publish_task_version\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Publish a new version of one of the enterprise’s tasks, naming the version it was read from.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Publish a new version of one of the enterprise’s tasks. Pass id and baseVersionId, the currentVersionId from os.read_task_definition. Send only the fields that change: a field left out keeps its current value. Sending null does not clear a field through this tool, because a null argument is dropped. Clear inputs, workspace, successors, finishesOn, toolSlots, callLimits, mailboxAction or maxRunsPerExecution over HTTP by sending null. name, slug, assigneeRole, serializeOn, status and kind change the task at once and are not part of the version. A save that changes nothing returns the current version with unchanged true. visibility public publishes the version to the catalog, listed on the task’s role when the enterprise has published that role, and private withdraws it and records the task as left out; either also needs catalog:write. Once the task is in the catalog, every version published after goes there too without visibility; a version the catalog refuses is still saved, and catalogPublication says why the catalog kept its version. A task that declares this tool is refused when it is saved. A task reaches it only through a bound connection to the OS’s own MCP server, with a gate naming the tool, as with every write that server serves, and a run cannot publish the task it is running (self_publish_refused). The OS’s built-in tasks are not edited this way. Give the task to a role with assigneeRole; a task has no team. A version that carries a routing issue is still saved, and definitionIssues lists each as a warning: outcome_not_routed, named with the word (the skill ends on a word no successor or finishesOn entry handles), self_loop_unconditional (a successor back to its own slug with no delayMinutes) or asks_ceo_without_resume (it asks the CEO and works on after the answer with no ceo_approved successor back to itself). The response is the version, and its id is the next baseVersionId.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The task, by its id from os.list_task_definitions.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>baseVersionId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The currentVersionId this change was read from.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>name\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The task’s name, trimmed, at most 200 characters.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>slug\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>A slug of letters, digits and hyphens, at most 80 characters.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kind\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>llm\u003C\u002Fcode>, \u003Ccode>deterministic\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>llm or deterministic. A deterministic task has no tools.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>status\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>active\u003C\u002Fcode>, \u003Ccode>deprecated\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>active or deprecated.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>assigneeRole\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The role whose holders run the task, by the role’s slug. A task is given to a role, never a team: every holder of the role runs it, on whatever team they sit, and a team runs the tasks of the roles its members hold. assigneeMemberId is refused.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>goal\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>What the task is for, in one or two sentences.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>metric\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>object\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>How the task is judged, as { text }.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>guardrails\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Sentences the task must hold to. Each item is plain text.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>tools\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The tools the task may call. Each item is a tool name, as a string, such as &quot;acme.merge_pull_request&quot;. An entry that is an object, including one carrying its own gates or marked optional, cannot be sent through this tool: sending tools replaces them all, so leave tools out to keep the current ones.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>inputs\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of object\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The inputs, as { key, label, type, required?, configuration?, requiredGroup?, entries? }. type is string, number, boolean, link or file. configuration marks persistent enterprise setup. requiredGroup requires at least one input in the group; every member must agree on configuration. A string map may declare entries: { keyInput, separator }: comma-separated key\u002Fvalue entries must cover the resolved keyInput at each start. Missing required configuration prevents a run from starting.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>gates\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of object\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Gates on tools that reach outside. Each object is { tool, owner, approval }. On create, leave it out and the task is given the default CEO gates; on publish, leave it out and the current gates stay. Send [] to declare none, which is refused when a tool still requires a gate.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>spend\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>object\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Spend limits, as { moneyUsdPerRun, maxModelTier, model, maxSteps }. Leave model out, or send &quot;auto&quot;, and a model is chosen for each run by what the work needs, no higher than maxModelTier (economical, mid or frontier) when that is set. Send an exact model id as model to use that model for every run. maxSteps is how many steps a run gets, a whole number from 1 to 400; leave it out for the default for the tool shape (24, or 120 with workspace or Computer-Use tools). The run input maxSteps and the operator setting LLM_MAX_STEPS still win over it.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>workspace\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>object\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The clone the task may change, as { branch, onDefaultBranch, writeAllow, rewriteAllow, writeDeny, appendOnly, pushAllow, requireFiles, credentials }. Each list is strings but \u003Ccode>credentials\u003C\u002Fcode>, which is [{ tool, as, prop? }]: a bound tool's secret (or its custom prop) as the environment variable \u003Ccode>as\u003C\u002Fcode> of the run's repository commands; \u003Ccode>onDefaultBranch: true\u003C\u002Fcode> keeps the run on the default branch's tip, with no branch of its own and nothing to push; \u003Ccode>pushAllow\u003C\u002Fcode> lists the full ref globs (\u003Ccode>refs\u002Fheads\u002Fmain\u003C\u002Fcode>, \u003Ccode>refs\u002Ftags\u002Fv*\u003C\u002Fcode>) a run may push with \u003Ccode>workspace.git_push\u003C\u002Fcode>'s \u003Ccode>ref\u003C\u002Fcode> besides its own branch, and needs \u003Ccode>writeAllow\u003C\u002Fcode>.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>successors\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of object\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>What runs after this task. Each object is { slug, on, when, delayMinutes, maxRunsPerIssue, escalate, verificationAnyOf }. on is succeeded, failed or terminal.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>finishesOn\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Outcome names that finish the work. Each item is plain text, at most 16.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>maxRunsPerExecution\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, at least 1\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The most countable runs this task may have in one execution before its next start is logged or stopped, a whole number of at least 1. Counted per task across the execution, whichever handoff started each run. Never applied below the highest maxRunsPerIssue on a successor into the task. Left out on create, or never set, EXECUTION_MAX_TASK_RUNS applies; left out on publish, the current value stays.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>toolSlots\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of object\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Tool slots the task’s tools may be named by in place of one vendor’s tool type, at most 16. Each object is { key, label, description?, actions? }: key reads like a tool type (codehost), label is what a person choosing a binding reads. A tool named &quot;codehost&quot; or &quot;codehost.&lt;tool&gt;&quot; is then filled per enterprise by the binding that lists codehost among the slots it fills, and runs as that binding’s tool type. actions is a list of { name, description? }, at most 32, the actions the task names under the key (&quot;codehost.pr.merge&quot;); the filling binding maps each to one of its own tools, so the task names no vendor’s tool.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>callLimits\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of object\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>How often one run may make a call, at most 16. Each object is { tool, match?, perRun }: tool is one tool the task’s tools reach, by its exact name (&quot;acme.issue_write&quot;); match names payload fields the call must carry to count, as a gate’s match does ({ &quot;method&quot;: &quot;create&quot; }); perRun is a whole number of at least 1. A call past the limit is not sent, and the run reads call_limit_reached instead.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>mailboxAction\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>object\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Where a mailbox offers this task as a one-click button, as { on, label }. on is mailbox (a button above the mailbox’s list; the run starts with no input of the OS’s) or mail (a button on one open message; the run starts with that message’s id as its emailId input, so the task has to declare an input with that key). label is the button’s words, at most 40 characters. A public template that declares one is offered to clone on inboxes that have no such task yet. Leave it out to offer none.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>skillMd\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The skill text, markdown, telling the model how to do the job.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>contextPrefixes\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Key prefixes loaded into input.context when a run starts. Each item is plain text.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>trainGrants\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of object\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Team or enterprise notes a run of this task may write. Each object is { layer, eventIdPrefix }, layer team or enterprise. A team note goes to each team the running member sits on or leads.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>overlapPolicy\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>skip\u003C\u002Fcode>, \u003Ccode>os\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>skip waits behind the member’s other work. os runs beside it.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>serializeOn\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Input keys that partition this task’s work into lanes, up to 8. Each item is plain text.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>allowSelfReaction\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Kept for versions written before it was retired: the OS no longer reads it, and a reaction is a call like any other. Leave it out.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>visibility\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>public\u003C\u002Fcode>, \u003Ccode>private\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>public publishes this version to the catalog, private withdraws it. Either also needs catalog:write. Left out, a task already in the catalog sends this version there too, and any other task changes only itself.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Not retry-safe: a repeat acts again. A repeat after a successful publish is refused (task_version_conflict): baseVersionId is then stale. Read the task again and send the new currentVersionId. A save that changes nothing returns the current version with unchanged true.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The version: \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>version\u003C\u002Fcode>, the definition, and \u003Ccode>unchanged\u003C\u002Fcode> (\u003Ccode>true\u003C\u002Fcode> when the save decided nothing). For a task in the catalog, or a save with \u003Ccode>visibility: public\u003C\u002Fcode>, \u003Ccode>catalogPublication\u003C\u002Fcode>: the entry’s \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>version\u003C\u002Fcode> and \u003Ccode>sourceVersion\u003C\u002Fcode> (the task version it holds), \u003Ccode>updated\u003C\u002Fcode> (whether this save reached the catalog) and \u003Ccode>refusal\u003C\u002Fcode> (\u003Ccode>error\u003C\u002Fcode> and \u003Ccode>message\u003C\u002Fcode> saying why the catalog kept its version, or null).\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Ftasks\u002F:id\u002Fversions\u003C\u002Fcode> (\u003Ccode>tasks:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>base_version_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>baseVersionId\u003C\u002Fcode> is missing or blank. Read the task and send its currentVersionId.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_version_conflict\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Someone published a newer version than \u003Ccode>baseVersionId\u003C\u002Fcode>. The body names \u003Ccode>currentVersionId\u003C\u002Fcode> and \u003Ccode>currentVersion\u003C\u002Fcode>.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode> names no task in this enterprise, another enterprise's included.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_definition_read_only\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The task is a clone: its definition belongs to the original's owner.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>os_task_immutable\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The task is one of the OS's own: the same in every enterprise, changed only with a release.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>skillMd_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The skill would be empty.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_name\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>name\u003C\u002Fcode> is empty, or longer than 200 characters.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_slug\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The slug is empty once cleaned, or longer than 80 characters.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_slug_taken\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>This enterprise already has a task with that slug.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_team_removed\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The call names a team for the task. A task belongs to a role, not a team: a team runs the tasks of the roles its members hold. Seat a holder of the task’s role on the team instead.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_task_definition\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The definition fails a check: a deterministic task with tools, a merge or mail or plan gate that is missing, a successor the rules refuse, a call limit on a tool the task does not declare (call_limit_tool_not_declared).\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>call_limits_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>callLimits\u003C\u002Fcode> is not a list of up to 16 objects. The refusal names the fault instead when one limit is wrong: call_limit_tool_invalid (not one tool by its exact name), call_limit_match_invalid:&lt;tool&gt; (not a gate-shaped match) or call_limit_per_run_invalid:&lt;tool&gt; (not a whole number of at least 1).\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>serialize_on_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>serializeOn\u003C\u002Fcode> is not a list of up to 8 input keys.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>tool_entry_unreadable\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A \u003Ccode>tools\u003C\u002Fcode> entry names no tool.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>llm_model_not_in_catalogue\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>spend.model\u003C\u002Fcode> is not a model a connected provider offers.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000013&quot;,\n  &quot;baseVersionId&quot;: &quot;6a1d2e3f-0000-4000-8000-000000000014&quot;,\n  &quot;guardrails&quot;: [\n    &quot;Never close an issue.&quot;\n  ]\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-set-task-run-status\">\u003Ccode>os.set_task_run_status\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Enable or disable a task.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Set runStatus to active or disabled. Enabling permits future starts; it does not start a run. Disabling prevents future starts without cancelling work already running. Built-in task controls remain protected by the API.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The task id from os.list_task_definitions.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>runStatus\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>active\u003C\u002Fcode>, \u003Ccode>disabled\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>Whether the task may start.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>PATCH \u002Fv1\u002Ftasks\u002F:id\u002Frun-status\u003C\u002Fcode> (\u003Ccode>tasks:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"os-set-task-schedule\">\u003Ccode>os.set_task_schedule\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Set a task schedule.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Replace a task schedule. Pass cron, optionally an IANA timezone (otherwise the enterprise timezone), enabled (defaults to true), and input matching the task fields. The API validates the schedule and refuses built-in tasks. A disabled task still cannot run. Read the schedule back with os.read_task_definition.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The task id from os.list_task_definitions.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>cron\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>A five-field cron expression.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>timezone\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>An IANA timezone, or enterprise to follow the enterprise timezone.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>enabled\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Whether the schedule should fire. Defaults to true.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>input\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>object\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Inputs supplied on each scheduled run.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>PUT \u002Fv1\u002Ftasks\u002F:id\u002Fschedule\u003C\u002Fcode> (\u003Ccode>tasks:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"os-remove-task-schedule\">\u003Ccode>os.remove_task_schedule\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Remove a task schedule.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Remove a task schedule so it no longer starts work on a cadence. Does not cancel existing runs. Built-in tasks are refused by the API.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The task id from os.list_task_definitions.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>DELETE \u002Fv1\u002Ftasks\u002F:id\u002Fschedule\u003C\u002Fcode> (\u003Ccode>tasks:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"os-set-task-input-values\">\u003Ccode>os.set_task_input_values\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Set this enterprise's own values for a task's inputs.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Replace this enterprise's own values for the inputs a task declares, keyed by input key; pass {} to clear them. Every run of the task takes them, however it starts: a value the start gives wins, then these, then the task version's defaults. Works on any task the enterprise runs, including a linked clone whose definition another enterprise owns; it changes no version. Each key must be an input the current version declares and each value of its declared type; a file input takes none. Built-in tasks are refused. Read them back with os.read_task_definition (inputValues, and ignoredInputValues for saved values the current version no longer takes).\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The task id from os.list_task_definitions.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>values\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>object\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>Input key to value: text, a number or true\u002Ffalse, as the input declares.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>PUT \u002Fv1\u002Ftasks\u002F:id\u002Finput-values\u003C\u002Fcode> (\u003Ccode>tasks:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"os-read-context\">\u003Ccode>os.read_context\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Read enterprise workflow context outside a run.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Read one enterprise context key. Returns key, value (null when absent), and updatedAt. This is workflow bookkeeping, separate from knowledge in memory.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>key\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>One enterprise context key, at most 512 characters, without whitespace.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fenterprise\u002Fcontext\u002F:key\u003C\u002Fcode> (\u003Ccode>enterprise:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"os-write-context\">\u003Ccode>os.write_context\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Set enterprise workflow context outside a run.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Store a JSON object under one enterprise context key, at most 16 KB encoded. Last write wins. Replaces the entire value, so read it before changing selected fields. Records the authenticated caller as the writer. Does not change task permissions, versions or schedules.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>key\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>One enterprise context key, at most 512 characters, without whitespace.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>value\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>object\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The complete JSON object to store, at most 16 KB.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>PUT \u002Fv1\u002Fenterprise\u002Fcontext\u002F:key\u003C\u002Fcode> (\u003Ccode>enterprise:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"os-list-teams\">\u003Ccode>os.list_teams\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>The enterprise's teams, by name.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">List the enterprise's teams, ordered by name: each one's id, name, slug, status, lead (leadMemberId and leadName, null for none), charter and concurrentRunLimit (null when it uses the enterprise's). No arguments. Never another enterprise's teams.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Takes no arguments: no fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the CEO chat, the API, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> One row per team, each with \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>name\u003C\u002Fcode>, \u003Ccode>slug\u003C\u002Fcode>, \u003Ccode>status\u003C\u002Fcode>, \u003Ccode>leadMemberId\u003C\u002Fcode>, \u003Ccode>leadName\u003C\u002Fcode> and \u003Ccode>concurrentRunLimit\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fteams\u003C\u002Fcode> (\u003Ccode>teams:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-read-team\">\u003Ccode>os.read_team\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>One team, with its members and the tasks its members’ roles run.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Read one team: its name, slug, status, lead, charter and concurrentRunLimit, the members on it (members) and the tasks it runs (tasks): the tasks of the roles its members hold, seated or as lead. A task belongs to a role, not a team, so the list changes as members join and leave. Not found for a team in another enterprise.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The team, by its id from os.list_teams.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the CEO chat, the API, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The team: \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>name\u003C\u002Fcode>, \u003Ccode>slug\u003C\u002Fcode>, \u003Ccode>concurrentRunLimit\u003C\u002Fcode> and the rest, \u003Ccode>members\u003C\u002Fcode> (who is on it) and \u003Ccode>tasks\u003C\u002Fcode> (the tasks of the roles its members hold).\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fteams\u002F:id\u003C\u002Fcode> (\u003Ccode>teams:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>team_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode> names no team in this enterprise, another enterprise's included.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000021&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-create-team\">\u003Ccode>os.create_team\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Create a team, optionally with its own concurrent run limit.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Create a team with a name and, optionally, its own concurrent run limit (concurrentRunLimit); left out, the team uses the enterprise's. Its slug is made from the name, so a name whose slug another team already has is refused with team_slug_taken. The response is the team as created.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>name\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The team’s name, up to 200 characters. Its slug is made from it.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>concurrentRunLimit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, at least 1\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>How many of the team’s runs may run at once, at least 1. Left out, the team uses the enterprise’s limit.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Not retry-safe: a repeat acts again. Every call creates a team. A repeat with the same name is refused (team_slug_taken) rather than creating a second.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the CEO chat, the API, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The team as created: \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>name\u003C\u002Fcode>, \u003Ccode>slug\u003C\u002Fcode>, \u003Ccode>concurrentRunLimit\u003C\u002Fcode> and the rest, \u003Ccode>members\u003C\u002Fcode> and \u003Ccode>tasks\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fteams\u003C\u002Fcode> (\u003Ccode>teams:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>team_slug_taken\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Another team in this enterprise already has the slug made from that name, so a repeat of a create is refused too.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>concurrent_run_limit_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>concurrentRunLimit\u003C\u002Fcode> is not a whole number of at least 1.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>concurrent_run_limit_over_enterprise\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Every team's limit together would exceed the enterprise's own concurrent run limit. The refusal says by how much.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;name&quot;: &quot;Support&quot;,\n  &quot;concurrentRunLimit&quot;: 2\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-update-team\">\u003Ccode>os.update_team\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Change a team's name or concurrent run limit.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Change a team's name or its concurrent run limit (concurrentRunLimit); a field left out keeps its value. A limit that would take every team's together past the enterprise's is refused with concurrent_run_limit_over_enterprise. The response is the team after the change.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The team, by its id from os.list_teams.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>name\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The team’s new name, up to 200 characters. Its slug stays as it is.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>concurrentRunLimit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, at least 1\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>How many of the team’s runs may run at once, at least 1. Every team’s limit together stays within the enterprise’s.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. The same fields set twice leave the team as the first call did.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the CEO chat, the API, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The team after the change: \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>name\u003C\u002Fcode>, \u003Ccode>slug\u003C\u002Fcode>, \u003Ccode>concurrentRunLimit\u003C\u002Fcode> and the rest, \u003Ccode>members\u003C\u002Fcode> and \u003Ccode>tasks\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>PATCH \u002Fv1\u002Fteams\u002F:id\u003C\u002Fcode> (\u003Ccode>teams:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>team_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode> names no team in this enterprise, another enterprise's included.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>concurrent_run_limit_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>concurrentRunLimit\u003C\u002Fcode> is not a whole number of at least 1.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>concurrent_run_limit_over_enterprise\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Every team's limit together would exceed the enterprise's own concurrent run limit. The refusal says by how much.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000021&quot;,\n  &quot;name&quot;: &quot;Customer support&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-delete-team\">\u003Ccode>os.delete_team\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Remove a team.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Remove a team. Its members come off it and keep their roles, and with them the tasks those roles run. The enterprise’s last team is refused with last_team: an enterprise keeps at least one. Any other refusal comes back with the API’s reason. The call is the confirmation, so the tool takes no confirm argument.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The team, by its id from os.list_teams.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. A repeat finds the team already gone and is refused with team_not_found, removing nothing else.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the CEO chat, the API, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> Nothing: the team is gone.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>DELETE \u002Fv1\u002Fteams\u002F:id\u003C\u002Fcode> (\u003Ccode>teams:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>team_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode> names no team in this enterprise, another enterprise's included.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>last_team\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The team is the last one the enterprise has.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000021&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-add-team-member\">\u003Ccode>os.add_team_member\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Put a member on a team, optionally in a role.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Put a member on a team, and, when roleId names one, give them that role too. The role is a convenience: a team can hold a member before it has a role to give them. The response is the team after the change.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The team, by its id from os.list_teams.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>memberId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The member to put on the team.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>roleId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>A role the member holds from now on as well. Left out, their roles are unchanged.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. A member already on the team stays on it once, and holds a role it names once.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the CEO chat, the API, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The team after the change, with the member among its \u003Ccode>members\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fteams\u002F:id\u002Fmembers\u003C\u002Fcode> (\u003Ccode>teams:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>team_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode> names no team in this enterprise, another enterprise's included.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>member_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>memberId\u003C\u002Fcode> names no member in this enterprise.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>role_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>roleId\u003C\u002Fcode> names no role in this enterprise.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000021&quot;,\n  &quot;memberId&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000014&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-remove-team-member\">\u003Ccode>os.remove_team_member\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Take a member off a team.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Take a member off a team. They keep their roles; a lead taken off no longer leads it. The response is the team after the change.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The team, by its id from os.list_teams.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>memberId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The member to take off the team.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. A member already off the team stays off it.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the CEO chat, the API, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The team after the change, without the member among its \u003Ccode>members\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>DELETE \u002Fv1\u002Fteams\u002F:id\u002Fmembers\u002F:memberId\u003C\u002Fcode> (\u003Ccode>teams:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>team_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode> names no team in this enterprise, another enterprise's included.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>member_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>memberId\u003C\u002Fcode> names no member in this enterprise.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000021&quot;,\n  &quot;memberId&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000014&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-add-work-item\">\u003Ccode>os.add_work_item\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Add an item to a team's work list.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Add an item to a team's work list: a title, a kind (one word you choose), and optionally a state, a priority, a short body (up to 16 KB), up to 20 links, a parent item on the same team (one level only) and a not-before date until which no run claims it. It starts proposed unless you give an open state, and goes to the end of its level. Who added it is recorded from the caller. A run adds to the first team its member sits on or leads, or, with forFunction, to the list of the team in its enterprise that holds that business function: as proposed, for that team's lead or a person to approve. An issue or pull request has one open item across the enterprise: a link to one another open item holds, on any team’s list, is refused with work_item_exists, and the issue is taken.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>teamId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The team whose list it is. A run leaves it out: the first team its member sits on or leads is used, and any other is ignored.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>title\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>What the work is, up to 200 characters.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kind\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>A word the task chooses for the kind of work (content, outreach, bug): one word, no spaces, up to 40 characters.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>state\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>proposed\u003C\u002Fcode>, \u003Ccode>ready\u003C\u002Fcode>, \u003Ccode>held\u003C\u002Fcode>, \u003Ccode>in_progress\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Where it starts: proposed (waiting for a person) unless given. held is parked until a person releases it. Closed states are set by os.close_work_item.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>priority\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>urgent\u003C\u002Fcode>, \u003Ccode>high\u003C\u002Fcode>, \u003Ccode>medium\u003C\u002Fcode>, \u003Ccode>low\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Its level, urgent first. Left out, it has none and lists after every level.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>body\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>A short body: plain text, up to 16 KB. Link a larger document instead.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>links\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Up to 20 http(s) URLs the work refers to.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>parentId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The item this one sits under, such as a campaign or an epic, by its id: an item on the same team that has no parent itself. Left out, it stands alone.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>notBefore\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The moment before which no run claims it, such as a check due 28 days after go-live: a date-time with an offset or Z (2026-12-03T09:00:00Z), or a date (2026-12-03) meaning the start of that day in the enterprise's timezone. It still lists in its usual place. Left out, it can be claimed as soon as it is ready.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>forFunction\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>support\u003C\u002Fcode>, \u003Ccode>marketing\u003C\u002Fcode>, \u003Ccode>sales\u003C\u002Fcode>, \u003Ccode>operations\u003C\u002Fcode>, \u003Ccode>engineering\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>A run only: put the item on another team's list, the team of your enterprise that holds this business function. It is added as proposed whatever state you give, for a person or that team's lead to approve: you can never approve it, and unless you sit on that team you cannot read or change it afterwards. With no such team, or more than one, nothing is added: the finding goes to a person on Blockers and the answer says raised. Naming your first team's function adds the item to your first team's list as proposed. Ignored outside a run, where teamId names the team.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. The same tool call sent again adds the item once and answers with the item it added.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the CEO chat, the API, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The item: \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>teamId\u003C\u002Fcode>, \u003Ccode>title\u003C\u002Fcode>, \u003Ccode>kind\u003C\u002Fcode>, \u003Ccode>state\u003C\u002Fcode>, \u003Ccode>priority\u003C\u002Fcode>, \u003Ccode>position\u003C\u002Fcode>, \u003Ccode>body\u003C\u002Fcode>, \u003Ccode>links\u003C\u002Fcode>, \u003Ccode>addedBy\u003C\u002Fcode>, \u003Ccode>createdAt\u003C\u002Fcode>, \u003Ccode>updatedAt\u003C\u002Fcode>, \u003Ccode>closedAt\u003C\u002Fcode>, \u003Ccode>closeReason\u003C\u002Fcode>, \u003Ccode>claimedByRunId\u003C\u002Fcode> and \u003Ccode>claimedAt\u003C\u002Fcode> (the run working it and since when, or null), \u003Ccode>parentId\u003C\u002Fcode> (the item it sits under, or null), \u003Ccode>notBefore\u003C\u002Fcode> (the UTC instant before which no run claims it, or null), and \u003Ccode>requestedBy\u003C\u002Fcode> (the person the work is for, \u003Ccode>{ id, name }\u003C\u002Fcode>, or null for nobody: set by the OS only when the item is added, from the person adding it or the person who asked for the run adding it, never from an argument). With forFunction, the answer is the item placed on the receiving team, with \u003Ccode>origin\u003C\u002Fcode> (the team and run that sent it), or, when no single team holds the function, \u003Ccode>{ raised: true, reason, forFunction, candidates }\u003C\u002Fcode>: nothing was added, a person was told on Blockers, and the run carries on.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fteams\u002F:teamId\u002Fwork-items\u003C\u002Fcode> (\u003Ccode>teams:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_team\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The member running the run sits on no team and leads none, so it has no list to keep.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>team_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>teamId\u003C\u002Fcode> names no team in this enterprise, another enterprise's included.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_work_item\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A title, kind, state, priority, position, link, reason or forFunction is missing or not one the list accepts; or a parent is the item itself, has a parent of its own, is given to an item that has children, or is not an item on the same team; or notBefore is not a date (YYYY-MM-DD), a date-time with an offset or Z, or none.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>body_too_large\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The body is over 16 KB. Keep a larger document elsewhere and put its address in \u003Ccode>links\u003C\u002Fcode>.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>work_item_exists\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A link names an issue or pull request that another open item in the enterprise already holds, on any team’s list. The issue is taken: leave it and pick another. Closing that item frees it.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;title&quot;: &quot;Draft the launch note&quot;,\n  &quot;kind&quot;: &quot;content&quot;,\n  &quot;priority&quot;: &quot;high&quot;,\n  &quot;links&quot;: [\n    &quot;https:\u002F\u002Fexample.com\u002Fbrief&quot;\n  ]\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-list-work-items\">\u003Ccode>os.list_work_items\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>A team's work list, open items by default.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">List a team's work items: the open ones (proposed, ready, held, in_progress) unless you ask for a state, optionally of one kind. Ordered by priority (urgent first, none last), then position, then age, in pages of 25 (up to 200). A run lists the first team its member sits on or leads. Each item carries its parentId and a rollup of its children, `children: { total, byState }`, closed children counted.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>teamId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The team whose list it is. A run leaves it out: the first team its member sits on or leads is used, and any other is ignored.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>state\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>open\u003C\u002Fcode>, \u003Ccode>proposed\u003C\u002Fcode>, \u003Ccode>ready\u003C\u002Fcode>, \u003Ccode>held\u003C\u002Fcode>, \u003Ccode>in_progress\u003C\u002Fcode>, \u003Ccode>done\u003C\u002Fcode>, \u003Ccode>dropped\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only items in this state, or open for every open state. Left out, every open state.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kind\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only items of this kind.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>page\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, at least 1\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Which page, from 1.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>limit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, 1 to 200\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Items per page: 25 unless given.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the CEO chat, the API, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ data, total, page, limit, pages }\u003C\u002Fcode>: \u003Ccode>data\u003C\u002Fcode> is one page of items, each as os.read_work_item gives it, \u003Ccode>claimedByRunStatus\u003C\u002Fcode>, \u003Ccode>children\u003C\u002Fcode> and \u003Ccode>requestedBy\u003C\u002Fcode> included.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fteams\u002F:teamId\u002Fwork-items\u003C\u002Fcode> (\u003Ccode>teams:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_team\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The member running the run sits on no team and leads none, so it has no list to keep.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>team_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>teamId\u003C\u002Fcode> names no team in this enterprise, another enterprise's included.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_work_item\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A title, kind, state, priority, position, link, reason or forFunction is missing or not one the list accepts; or a parent is the item itself, has a parent of its own, is given to an item that has children, or is not an item on the same team; or notBefore is not a date (YYYY-MM-DD), a date-time with an offset or Z, or none.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;state&quot;: &quot;ready&quot;,\n  &quot;kind&quot;: &quot;content&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-read-work-item\">\u003Ccode>os.read_work_item\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>One work item, with every field.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Read one work item with every field, open or closed, and claimedByRunStatus: the status now of the run holding it (live, waiting at a gate, ended, or null for none), which tells work being done from work waiting, finished without closing the item, or stopped. Not found for an item in another enterprise, or, for a run, on the list of a team its member is not on, unless it is the open item the run holds.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The item, by its id from os.list_work_items or os.add_work_item.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the CEO chat, the API, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The item: \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>teamId\u003C\u002Fcode>, \u003Ccode>title\u003C\u002Fcode>, \u003Ccode>kind\u003C\u002Fcode>, \u003Ccode>state\u003C\u002Fcode>, \u003Ccode>priority\u003C\u002Fcode>, \u003Ccode>position\u003C\u002Fcode>, \u003Ccode>body\u003C\u002Fcode>, \u003Ccode>links\u003C\u002Fcode>, \u003Ccode>addedBy\u003C\u002Fcode>, \u003Ccode>createdAt\u003C\u002Fcode>, \u003Ccode>updatedAt\u003C\u002Fcode>, \u003Ccode>closedAt\u003C\u002Fcode>, \u003Ccode>closeReason\u003C\u002Fcode>, \u003Ccode>claimedByRunId\u003C\u002Fcode> and \u003Ccode>claimedAt\u003C\u002Fcode> (the run working it and since when, or null), \u003Ccode>parentId\u003C\u002Fcode> (the item it sits under, or null), \u003Ccode>notBefore\u003C\u002Fcode> (the UTC instant before which no run claims it, or null), and \u003Ccode>requestedBy\u003C\u002Fcode> (the person the work is for, \u003Ccode>{ id, name }\u003C\u002Fcode>, or null for nobody: set by the OS only when the item is added, from the person adding it or the person who asked for the run adding it, never from an argument). Also \u003Ccode>claimedByRunStatus\u003C\u002Fcode>: the status of the run holding it now, or null; and \u003Ccode>children\u003C\u002Fcode>: \u003Ccode>{ total, byState }\u003C\u002Fcode>, how many items sit under it and how many in each state, closed ones included.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fwork-items\u002F:id\u003C\u002Fcode> (\u003Ccode>teams:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_team\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The member running the run sits on no team and leads none, so it has no list to keep.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>work_item_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode> names no item this caller can reach: none at all, another enterprise's, or, for a run, a team it is not on.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000031&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-update-work-item\">\u003Ccode>os.update_work_item\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Change an open work item's fields.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Change an open item's title, kind, state (among the open ones), priority, position, body, links, parent or not-before date. A field left out keeps its value. Each change is kept in the item’s history with who made it, and a call that changes nothing records nothing. A closed item cannot be changed (work_item_closed). Only a person approves a proposed item or releases a held one: a run that tries is refused (approval_requires_person).\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The item, by its id from os.list_work_items or os.add_work_item.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>title\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The new title, up to 200 characters.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kind\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>A word the task chooses for the kind of work (content, outreach, bug): one word, no spaces, up to 40 characters.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>state\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>proposed\u003C\u002Fcode>, \u003Ccode>ready\u003C\u002Fcode>, \u003Ccode>held\u003C\u002Fcode>, \u003Ccode>in_progress\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Move it between the open states: proposed waits for a person, ready can be claimed, held is parked until a person releases it. A run cannot move a proposed or held item out of that state. Use os.close_work_item to finish or drop it.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>priority\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>urgent\u003C\u002Fcode>, \u003Ccode>high\u003C\u002Fcode>, \u003Ccode>medium\u003C\u002Fcode>, \u003Ccode>low\u003C\u002Fcode>, \u003Ccode>none\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Its level, urgent first. none clears it, so it lists after every level.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>position\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Its place among items of the same level: lower lists first. A new item goes to the end.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>body\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The new body: plain text, up to 16 KB.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>links\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The whole new list of links: up to 20 http(s) URLs.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>parentId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The item this one sits under, by its id: an item on the same team that has no parent itself. none clears it. An item that has children takes no parent.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>notBefore\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Set or move the moment before which no run claims it: a date-time with an offset or Z (2026-12-03T09:00:00Z), or a date (2026-12-03) meaning the start of that day in the enterprise's timezone. none clears it. It keeps its state and place in the list; a run already holding it keeps it.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. The same tool call sent again changes the item once and answers with the first answer.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the CEO chat, the API, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The item after the change. The item: \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>teamId\u003C\u002Fcode>, \u003Ccode>title\u003C\u002Fcode>, \u003Ccode>kind\u003C\u002Fcode>, \u003Ccode>state\u003C\u002Fcode>, \u003Ccode>priority\u003C\u002Fcode>, \u003Ccode>position\u003C\u002Fcode>, \u003Ccode>body\u003C\u002Fcode>, \u003Ccode>links\u003C\u002Fcode>, \u003Ccode>addedBy\u003C\u002Fcode>, \u003Ccode>createdAt\u003C\u002Fcode>, \u003Ccode>updatedAt\u003C\u002Fcode>, \u003Ccode>closedAt\u003C\u002Fcode>, \u003Ccode>closeReason\u003C\u002Fcode>, \u003Ccode>claimedByRunId\u003C\u002Fcode> and \u003Ccode>claimedAt\u003C\u002Fcode> (the run working it and since when, or null), \u003Ccode>parentId\u003C\u002Fcode> (the item it sits under, or null), \u003Ccode>notBefore\u003C\u002Fcode> (the UTC instant before which no run claims it, or null), and \u003Ccode>requestedBy\u003C\u002Fcode> (the person the work is for, \u003Ccode>{ id, name }\u003C\u002Fcode>, or null for nobody: set by the OS only when the item is added, from the person adding it or the person who asked for the run adding it, never from an argument).\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>PATCH \u002Fv1\u002Fwork-items\u002F:id\u003C\u002Fcode> (\u003Ccode>teams:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_team\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The member running the run sits on no team and leads none, so it has no list to keep.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>work_item_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode> names no item this caller can reach: none at all, another enterprise's, or, for a run, a team it is not on.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>work_item_closed\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The item is closed (\u003Ccode>done\u003C\u002Fcode> or \u003Ccode>dropped\u003C\u002Fcode>), so it can no longer be changed or closed the other way.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_work_item\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A title, kind, state, priority, position, link, reason or forFunction is missing or not one the list accepts; or a parent is the item itself, has a parent of its own, is given to an item that has children, or is not an item on the same team; or notBefore is not a date (YYYY-MM-DD), a date-time with an offset or Z, or none.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>body_too_large\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The body is over 16 KB. Keep a larger document elsewhere and put its address in \u003Ccode>links\u003C\u002Fcode>.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>approval_requires_person\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A run tries to move a proposed or held item to another state: only a person approves or releases one.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>work_item_exists\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A link names an issue or pull request that another open item in the enterprise already holds, on any team’s list. The issue is taken: leave it and pick another. Closing that item frees it.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000031&quot;,\n  &quot;state&quot;: &quot;in_progress&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-close-work-item\">\u003Ccode>os.close_work_item\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Close a work item as done or dropped.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Close an item as done or dropped, with an optional reason. It stays readable with its whole history, and can no longer be changed. Closing it again the same way changes nothing; the other way is work_item_closed.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The item, by its id from os.list_work_items or os.add_work_item.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>state\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>done\u003C\u002Fcode>, \u003Ccode>dropped\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>done when the work is finished, dropped when it is not.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>reason\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Why, in a sentence, up to 2000 characters.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. Closing an item again in the same state changes nothing and answers with the item as closed.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the CEO chat, the API, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The item as closed, with \u003Ccode>closedAt\u003C\u002Fcode> set. The item: \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>teamId\u003C\u002Fcode>, \u003Ccode>title\u003C\u002Fcode>, \u003Ccode>kind\u003C\u002Fcode>, \u003Ccode>state\u003C\u002Fcode>, \u003Ccode>priority\u003C\u002Fcode>, \u003Ccode>position\u003C\u002Fcode>, \u003Ccode>body\u003C\u002Fcode>, \u003Ccode>links\u003C\u002Fcode>, \u003Ccode>addedBy\u003C\u002Fcode>, \u003Ccode>createdAt\u003C\u002Fcode>, \u003Ccode>updatedAt\u003C\u002Fcode>, \u003Ccode>closedAt\u003C\u002Fcode>, \u003Ccode>closeReason\u003C\u002Fcode>, \u003Ccode>claimedByRunId\u003C\u002Fcode> and \u003Ccode>claimedAt\u003C\u002Fcode> (the run working it and since when, or null), \u003Ccode>parentId\u003C\u002Fcode> (the item it sits under, or null), \u003Ccode>notBefore\u003C\u002Fcode> (the UTC instant before which no run claims it, or null), and \u003Ccode>requestedBy\u003C\u002Fcode> (the person the work is for, \u003Ccode>{ id, name }\u003C\u002Fcode>, or null for nobody: set by the OS only when the item is added, from the person adding it or the person who asked for the run adding it, never from an argument).\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fwork-items\u002F:id\u002Fclose\u003C\u002Fcode> (\u003Ccode>teams:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_team\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The member running the run sits on no team and leads none, so it has no list to keep.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>work_item_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode> names no item this caller can reach: none at all, another enterprise's, or, for a run, a team it is not on.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>work_item_closed\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The item is closed (\u003Ccode>done\u003C\u002Fcode> or \u003Ccode>dropped\u003C\u002Fcode>), so it can no longer be changed or closed the other way.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_work_item\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A title, kind, state, priority, position, link, reason or forFunction is missing or not one the list accepts; or a parent is the item itself, has a parent of its own, is given to an item that has children, or is not an item on the same team; or notBefore is not a date (YYYY-MM-DD), a date-time with an offset or Z, or none.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000031&quot;,\n  &quot;state&quot;: &quot;done&quot;,\n  &quot;reason&quot;: &quot;Published on Friday&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-claim-work-item\">\u003Ccode>os.claim_work_item\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Take the next ready item of this run's team lists, so no other run can take it.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Claim the highest-priority ready item on the lists of the teams you sit on or lead, your first team’s list first and the next team’s only when it has none, each in the order os.list_work_items gives (priority, then position, then age), optionally only of the kinds you give. A claim skips an item until its not-before date (notBefore), and takes the next one instead; from that moment it is claimed as before. Or give id to claim that one item, such as one you just added for the work you are handing on: it is taken if it is ready, or still in progress for a run that has ended; a held, proposed or closed item, one whose not-before date has not come, or one a live run holds, answers { item: null }. In the same step it moves to in_progress and is marked as worked by this run, so no other run can take it. A run holds one item: calling again answers with the item it already holds. When no item fits, the answer is { item: null }, not an error. The claim lasts while the run is live, gate waits included; if the run is cancelled without closing the item, it goes back to ready for the next run. If the run fails or is blocked, or its pipeline stops short, the item is held for a person, still naming the run: a retry takes it over, and clearing the run on Blockers or releasing the item puts it back to ready. When the run ends and hands off, every successor it starts receives the item as its workItem input and holds it in turn, so the runs on one item are one execution, its loop caps count laps on the item, and a task that declares its finish closes the item as done.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kinds\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of string, at least 1\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only items of these kinds: 1 to 20, each one word with no spaces, up to 40 characters. Left out, any kind.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Claim this one item of your teams’ lists instead of the next ready one. Not with kinds.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. The same tool call sent again answers with the first answer, and a run that already holds an item gets that item back: it never takes a second.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ item }\u003C\u002Fcode>: the item this run now holds, with \u003Ccode>claimedByRunId\u003C\u002Fcode> and \u003Ccode>claimedAt\u003C\u002Fcode> set, or null when no ready item fits. The item: \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>teamId\u003C\u002Fcode>, \u003Ccode>title\u003C\u002Fcode>, \u003Ccode>kind\u003C\u002Fcode>, \u003Ccode>state\u003C\u002Fcode>, \u003Ccode>priority\u003C\u002Fcode>, \u003Ccode>position\u003C\u002Fcode>, \u003Ccode>body\u003C\u002Fcode>, \u003Ccode>links\u003C\u002Fcode>, \u003Ccode>addedBy\u003C\u002Fcode>, \u003Ccode>createdAt\u003C\u002Fcode>, \u003Ccode>updatedAt\u003C\u002Fcode>, \u003Ccode>closedAt\u003C\u002Fcode>, \u003Ccode>closeReason\u003C\u002Fcode>, \u003Ccode>claimedByRunId\u003C\u002Fcode> and \u003Ccode>claimedAt\u003C\u002Fcode> (the run working it and since when, or null), \u003Ccode>parentId\u003C\u002Fcode> (the item it sits under, or null), \u003Ccode>notBefore\u003C\u002Fcode> (the UTC instant before which no run claims it, or null), and \u003Ccode>requestedBy\u003C\u002Fcode> (the person the work is for, \u003Ccode>{ id, name }\u003C\u002Fcode>, or null for nobody: set by the OS only when the item is added, from the person adding it or the person who asked for the run adding it, never from an argument).\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Fwork-items\u002Fclaim\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_team\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The member running the run sits on no team and leads none, so it has no list to keep.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_work_item\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>kinds\u003C\u002Fcode> is not a list of 1 to 20 kinds, each one word with no spaces, up to 40 characters; \u003Ccode>id\u003C\u002Fcode> is not text; or both are given.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>work_item_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode> names no item this caller can reach: none at all, another enterprise's, or, for a run, a team it is not on.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;kinds&quot;: [\n    &quot;content&quot;,\n    &quot;outreach&quot;\n  ]\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example, Any kind.:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example, The item you just added for an issue.:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;0192f7d4-5b1a-7c3e-9a2b-4c5d6e7f8a9b&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-read-work-item-draft\">\u003Ccode>os.read_work_item_draft\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>An item's draft as it is now: its latest version, text included.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Read the draft a work item holds: its latest version at the moment of the call, so an edit a person saved since the last run is what you get, or one earlier version in full when you give its number. A draft is markdown, up to 256 KB, and every version is kept. The item’s own read and list carry only `draft: { version, updatedAt, updatedBy }`, never the text: read the text here. Not found for an item in another enterprise, or on the list of a team your member is not on.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The item, by its id from os.list_work_items or os.add_work_item.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>version\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, at least 1\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>One version, by its number (from 1). Left out, the latest.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> read.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Safe: repeating the call changes nothing.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ draft }\u003C\u002Fcode>: the version, with \u003Ccode>version\u003C\u002Fcode> (its number, from 1), \u003Ccode>writtenAt\u003C\u002Fcode>, \u003Ccode>writtenBy\u003C\u002Fcode> (who wrote it: \u003Ccode>{ kind: &quot;run&quot;, runId, taskId, memberId }\u003C\u002Fcode>, \u003Ccode>{ kind: &quot;person&quot;, humanUserId }\u003C\u002Fcode>, \u003Ccode>{ kind: &quot;member&quot;, memberId }\u003C\u002Fcode> or \u003Ccode>{ kind: &quot;api_key&quot;, apiKeyId }\u003C\u002Fcode>) and \u003Ccode>content\u003C\u002Fcode>, the markdown. \u003Ccode>draft\u003C\u002Fcode> is null when the item has no draft, or no version of that number.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.read_work_item_draft\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_team\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The member running the run sits on no team and leads none, so it has no list to keep.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>work_item_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode> names no item this caller can reach: none at all, another enterprise's, or, for a run, a team it is not on.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000031&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Example, The first version.:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000031&quot;,\n  &quot;version&quot;: 1\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-write-work-item-draft\">\u003Ccode>os.write_work_item_draft\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Write a new version of an item's draft.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Write the draft a work item holds, as markdown of up to 256 KB of UTF-8 text: a new version written by this run, after every earlier one, all of which are kept for a person to read and edit on the item. Text the latest version already holds adds nothing and answers that version. Give baseVersion, the version you read, to be refused (draft_conflict) rather than go over a version saved since, such as a person’s edit; left out, the write goes on top of whatever is current. A closed item’s draft cannot be changed (work_item_closed). Each write is kept in the item’s history, without the text.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The item, by its id from os.list_work_items or os.add_work_item.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>content\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The whole draft, as markdown: up to 256 KB of UTF-8 text.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>baseVersion\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, at least 0\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The version you read and changed, 0 when the item had no draft. Left out, the write never conflicts.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. The same tool call sent again writes the version once and answers with the version it wrote.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The version this write made, or the current one when its text was unchanged: \u003Ccode>version\u003C\u002Fcode> (its number, from 1), \u003Ccode>writtenAt\u003C\u002Fcode>, \u003Ccode>writtenBy\u003C\u002Fcode> (who wrote it: \u003Ccode>{ kind: &quot;run&quot;, runId, taskId, memberId }\u003C\u002Fcode>, \u003Ccode>{ kind: &quot;person&quot;, humanUserId }\u003C\u002Fcode>, \u003Ccode>{ kind: &quot;member&quot;, memberId }\u003C\u002Fcode> or \u003Ccode>{ kind: &quot;api_key&quot;, apiKeyId }\u003C\u002Fcode>) and \u003Ccode>content\u003C\u002Fcode>, the markdown.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.write_work_item_draft\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>no_team\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The member running the run sits on no team and leads none, so it has no list to keep.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>work_item_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>id\u003C\u002Fcode> names no item this caller can reach: none at all, another enterprise's, or, for a run, a team it is not on.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>work_item_closed\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The item is closed (\u003Ccode>done\u003C\u002Fcode> or \u003Ccode>dropped\u003C\u002Fcode>), so it can no longer be changed or closed the other way.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_work_item\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>content\u003C\u002Fcode> is not text, or \u003Ccode>baseVersion\u003C\u002Fcode> is not a whole version number (0 when the item had no draft).\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>draft_too_large\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The draft is over 256 KB of UTF-8 text. Shorten it, or keep a larger document elsewhere and link it.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>draft_conflict\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>baseVersion\u003C\u002Fcode> is no longer the current version: someone (a person, or another run) saved a newer one since you read it. The refusal names the current version: read it again and make your change on that one.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;id&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000031&quot;,\n  &quot;content&quot;: &quot;# Launch note\\n\\nShipping on **Friday**.&quot;,\n  &quot;baseVersion&quot;: 1\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-publish-role\">\u003Ccode>os.publish_role\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Publish one of the enterprise’s roles to the catalog, by its portable name and slug.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Publish one of the enterprise’s roles to the catalog, where any company can clone it. Pass sourceRoleId, the role’s id from os.list_roles. Only the role’s name and slug are published: its members stay with the enterprise, and its tasks are listed with it once each is published to the catalog itself (those already published join it at once). Public role slugs are global, so a slug the catalog already holds is refused (catalog_role_slug_taken). A plan without catalog publishing is refused with its reason (catalog_publish_not_in_plan) and nothing is written. A task that declares this tool is refused when it is saved. A task reaches it only through a bound connection to the OS’s own MCP server, with a gate naming the tool, as with every write that server serves. The response is the public role, with its id and slug.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>sourceRoleId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The role to publish, by its id from os.list_roles.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Not retry-safe: a repeat acts again. A repeat after a successful publish is refused (catalog_role_slug_taken): the catalog then holds the role. Read the catalog’s roles to see it there.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The public role: \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>slug\u003C\u002Fcode>, \u003Ccode>name\u003C\u002Fcode>, \u003Ccode>visibility\u003C\u002Fcode> (\u003Ccode>public\u003C\u002Fcode>) and \u003Ccode>ownerEnterpriseId\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fcatalog\u002Froles\u003C\u002Fcode> (\u003Ccode>catalog:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>catalog_publish_not_in_plan\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The enterprise’s plan does not include catalog publishing. The refusal says so in a sentence and names \u002Fbilling. Nothing is written.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>catalog_role_slug_taken\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The catalog already holds a public role with this role’s slug. Public role slugs are global, so a role is published once; rename the role’s slug to publish it as another.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>role_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>sourceRoleId\u003C\u002Fcode> names no role in this enterprise, another enterprise’s included.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>source_role_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>sourceRoleId\u003C\u002Fcode> is missing or empty.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;sourceRoleId&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000021&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-publish-team\">\u003Ccode>os.publish_team\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Publish one of the enterprise’s teams to the catalog, with its roles, as the portal’s Share does.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Publish one of the enterprise’s teams to the catalog, as Share on the team’s page does. Pass teamId, the team’s id from os.list_teams. The team’s roles the catalog does not hold yet are published first, then the team as one entry under its slug: a teammate slot per member carrying the roles they hold and nothing of the member, its KPIs, the cadence of each schedule on a task the catalog holds, and its goal. Its tasks travel once each is published to the catalog itself. roleSlugs names the roles that go; the rest are left out, and stay left out when the team is published again without roleSlugs. name and description are the words the catalog shows, and default to the team’s name and goal; kindOfWork and businessFunction file it. Publishing a team that has an entry brings that entry up to date instead of adding a second. Refused on a plan without catalog publishing (catalog_publish_not_in_plan), for a team with no roles (team_has_no_roles), and while another publisher holds a public role of one of its slugs (catalog_role_slug_taken, naming the slugs); nothing is written then. A task that declares this tool is refused when it is saved. A task reaches it only through a bound connection to the OS’s own MCP server, with a gate naming the tool, as with every write that server serves. The response is the entry and the public roles it names.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>teamId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The team to publish, by its id from os.list_teams.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>roleSlugs\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The slugs of the team’s roles that go to the catalog; the rest are left out. Leave it out to keep what was left out last time.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>name\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The name the catalog shows, at most 200 characters. Leave it out for the team’s name.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>description\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>One line the catalog shows, at most 280 characters. Leave it out for the team’s goal.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kindOfWork\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The kind of work setup offers the team for: one lowercase word, such as support. Leave it out for none.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>businessFunction\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>support\u003C\u002Fcode>, \u003Ccode>marketing\u003C\u002Fcode>, \u003Ccode>sales\u003C\u002Fcode>, \u003Ccode>operations\u003C\u002Fcode>, \u003Ccode>engineering\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The business function the catalog files the team under. Leave it out for none.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Not retry-safe: a repeat acts again. A repeat publishes the team again: its entry is brought up to date from the team as it stands, and no second entry is made.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> The catalog entry as \u003Ccode>entry\u003C\u002Fcode> (\u003Ccode>id\u003C\u002Fcode>, \u003Ccode>slug\u003C\u002Fcode>, \u003Ccode>name\u003C\u002Fcode>, \u003Ccode>teammates\u003C\u002Fcode>), and the public roles it names as \u003Ccode>roles\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fcatalog\u002Fshare\u002Fteams\u002F:teamId\u003C\u002Fcode> (\u003Ccode>catalog:write\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>catalog_publish_not_in_plan\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The enterprise’s plan does not include catalog publishing. The refusal says so in a sentence and names \u002Fbilling. Nothing is written.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>catalog_role_slug_taken\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A public role with one of the team’s role slugs comes from another publisher. The refusal names them as \u003Ccode>slugs\u003C\u002Fcode>; rename those roles and publish again. Nothing is written.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>team_has_no_roles\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>No member of the team holds a role and none of its tasks runs as one, or \u003Ccode>roleSlugs\u003C\u002Fcode> leaves every role out, so a clone would have nothing to hold.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>team_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>teamId\u003C\u002Fcode> names no team in this enterprise, another enterprise’s included.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_catalog_team\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>name\u003C\u002Fcode> is longer than 200 characters, or \u003Ccode>description\u003C\u002Fcode> longer than 280.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_team_roles\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>roleSlugs\u003C\u002Fcode> is not a list of slugs, or names a role the team does not have.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_kind_of_work\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>kindOfWork\u003C\u002Fcode> is not one lowercase word (letters, digits and underscores, at most 64 characters), or is something_else.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_business_function\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>businessFunction\u003C\u002Fcode> is not one of support, marketing, sales, operations or engineering.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;teamId&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000022&quot;,\n  &quot;name&quot;: &quot;Support desk&quot;,\n  &quot;kindOfWork&quot;: &quot;support&quot;,\n  &quot;businessFunction&quot;: &quot;support&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-attach-repair\">\u003Ccode>os.attach_repair\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Report the repair issue you filed for the shared cause this run was started for.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Attach the repair issue you filed to the shared cause this run was started for (your input's sharedCause), so the OS resumes the work that cause holds once that issue's pipeline is done. Only a run the OS started for a cause can call it, and only for that cause. Pass issue (the number of the issue you filed) and, optionally, cause (sharedCause.key from your input). A cause keeps the first issue attached to it: a later call with another number changes nothing and answers with the first.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Required\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>issue\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, at least 1\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The number of the repair issue you filed\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>cause\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The cause's key, sharedCause.key from your input. Defaults to it.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>No other fields are accepted.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Effect:\u003C\u002Fstrong> write.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Side effects:\u003C\u002Fstrong> From then on the cause is finished when that issue's work item is done (its held runs are re-queued) or dropped (they return to Blockers, naming the cause).\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Idempotent: a repeat of the same call acts once, or leaves the same state. The same call sent twice attaches once. A cause keeps the first issue attached to it.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> a run, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ cause, issue, attached }\u003C\u002Fcode>: the cause, the repair issue it now waits on, and whether that is the issue you passed (false when the cause already had another).\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002Fself\u002Ftools\u002Fos.attach_repair\u003C\u002Fcode> (\u003Ccode>run:self\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Error\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003Cth>What happens\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>not_a_repair_run\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The calling run was not started by the OS for a shared cause: its input carries no \u003Ccode>sharedCause.key\u003C\u002Fcode>.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>cause_not_yours\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>cause\u003C\u002Fcode> names another cause than the one this run was started for.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>issue_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>issue\u003C\u002Fcode> is not a positive whole number.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>cause_not_open\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The cause has cleared, or holds no run any more: nothing waits on a repair for it.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>causes_unavailable\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>This OS keeps no shared causes, so there is nothing to attach to.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;issue&quot;: 949\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n",[12,16,19,22,25,28,31,34,37,40,43,46,49,52,55,58,61,64,67,70,73,76,79,82,85,88,91,94,97,100,103,106,109,112,115,118,121,124,127,130,133,136,139,142,145,148,151,154,157,160,163,166,169,172,175,178,181,184,187,190,193,196,199,202,205,208,211,214,217,220,223,226,229,232,235,238,241,244,247,250,253,256,259,262,265,268,271,274,277,280,283,286,289,292,295,298,301,304,307,310,313,316,319,322,325,328,331,334,337,340,343,346,349,352,355,358,361,364,367,370],{"id":13,"text":14,"level":15,"planned":8},"os-set-execution-name","os.set_execution_name",2,{"id":17,"text":18,"level":15,"planned":8},"os-add-execution-link","os.add_execution_link",{"id":20,"text":21,"level":15,"planned":8},"os-wait-execution","os.wait_execution",{"id":23,"text":24,"level":15,"planned":8},"os-stop-execution","os.stop_execution",{"id":26,"text":27,"level":15,"planned":8},"os-read-execution","os.read_execution",{"id":29,"text":30,"level":15,"planned":8},"os-set-gate-summary","os.set_gate_summary",{"id":32,"text":33,"level":15,"planned":8},"os-decide-gate","os.decide_gate",{"id":35,"text":36,"level":15,"planned":8},"os-ask-ceo","os.ask_ceo",{"id":38,"text":39,"level":15,"planned":8},"os-list-recommendations","os.list_recommendations",{"id":41,"text":42,"level":15,"planned":8},"os-record-issue-outcome","os.record_issue_outcome",{"id":44,"text":45,"level":15,"planned":8},"os-get-recommendation","os.get_recommendation",{"id":47,"text":48,"level":15,"planned":8},"os-decide-recommendation","os.decide_recommendation",{"id":50,"text":51,"level":15,"planned":8},"os-mail-list","os.mail_list",{"id":53,"text":54,"level":15,"planned":8},"os-mail-read","os.mail_read",{"id":56,"text":57,"level":15,"planned":8},"os-mail-reply","os.mail_reply",{"id":59,"text":60,"level":15,"planned":8},"os-mail-send","os.mail_send",{"id":62,"text":63,"level":15,"planned":8},"os-mail-contacts","os.mail_contacts",{"id":65,"text":66,"level":15,"planned":8},"os-mail-contact-save","os.mail_contact_save",{"id":68,"text":69,"level":15,"planned":8},"os-member-mailbox-actions","os.member_mailbox_actions",{"id":71,"text":72,"level":15,"planned":8},"os-mail-set-label","os.mail_set_label",{"id":74,"text":75,"level":15,"planned":8},"os-mail-set-handled","os.mail_set_handled",{"id":77,"text":78,"level":15,"planned":8},"os-mail-set-many","os.mail_set_many",{"id":80,"text":81,"level":15,"planned":8},"os-mail-quiet-threads","os.mail_quiet_threads",{"id":83,"text":84,"level":15,"planned":8},"os-mail-mark-chased","os.mail_mark_chased",{"id":86,"text":87,"level":15,"planned":8},"os-mail-snooze","os.mail_snooze",{"id":89,"text":90,"level":15,"planned":8},"os-my-mail-list","os.my_mail_list",{"id":92,"text":93,"level":15,"planned":8},"os-my-mail-read","os.my_mail_read",{"id":95,"text":96,"level":15,"planned":8},"os-my-mail-attachment","os.my_mail_attachment",{"id":98,"text":99,"level":15,"planned":8},"os-my-mail-set-label","os.my_mail_set_label",{"id":101,"text":102,"level":15,"planned":8},"os-my-mail-set-handled","os.my_mail_set_handled",{"id":104,"text":105,"level":15,"planned":8},"os-my-mail-set-many","os.my_mail_set_many",{"id":107,"text":108,"level":15,"planned":8},"os-my-mail-reply","os.my_mail_reply",{"id":110,"text":111,"level":15,"planned":8},"os-my-mail-send","os.my_mail_send",{"id":113,"text":114,"level":15,"planned":8},"os-my-mail-forward","os.my_mail_forward",{"id":116,"text":117,"level":15,"planned":8},"os-my-mail-delete","os.my_mail_delete",{"id":119,"text":120,"level":15,"planned":8},"os-my-mail-actions","os.my_mail_actions",{"id":122,"text":123,"level":15,"planned":8},"os-my-mail-start-action","os.my_mail_start_action",{"id":125,"text":126,"level":15,"planned":8},"os-my-mail-schedule-action","os.my_mail_schedule_action",{"id":128,"text":129,"level":15,"planned":8},"os-my-mail-unschedule-action","os.my_mail_unschedule_action",{"id":131,"text":132,"level":15,"planned":8},"os-my-mail-contacts","os.my_mail_contacts",{"id":134,"text":135,"level":15,"planned":8},"os-my-mail-contact-save","os.my_mail_contact_save",{"id":137,"text":138,"level":15,"planned":8},"os-my-mail-contact-delete","os.my_mail_contact_delete",{"id":140,"text":141,"level":15,"planned":8},"os-my-mail-signature","os.my_mail_signature",{"id":143,"text":144,"level":15,"planned":8},"os-my-mail-signature-set","os.my_mail_signature_set",{"id":146,"text":147,"level":15,"planned":8},"os-my-mail-addresses","os.my_mail_addresses",{"id":149,"text":150,"level":15,"planned":8},"os-my-mail-address-signature-set","os.my_mail_address_signature_set",{"id":152,"text":153,"level":15,"planned":8},"os-escalate-mail","os.escalate_mail",{"id":155,"text":156,"level":15,"planned":8},"os-mail-reply-draft","os.mail_reply_draft",{"id":158,"text":159,"level":15,"planned":8},"os-list-kpis","os.list_kpis",{"id":161,"text":162,"level":15,"planned":8},"os-record-kpi-reading","os.record_kpi_reading",{"id":164,"text":165,"level":15,"planned":8},"os-get-enterprise-kpis","os.get_enterprise_kpis",{"id":167,"text":168,"level":15,"planned":8},"os-set-enterprise-kpis","os.set_enterprise_kpis",{"id":170,"text":171,"level":15,"planned":8},"os-get-team-kpis","os.get_team_kpis",{"id":173,"text":174,"level":15,"planned":8},"os-set-team-kpis","os.set_team_kpis",{"id":176,"text":177,"level":15,"planned":8},"os-set-context","os.set_context",{"id":179,"text":180,"level":15,"planned":8},"os-get-context","os.get_context",{"id":182,"text":183,"level":15,"planned":8},"os-delete-context","os.delete_context",{"id":185,"text":186,"level":15,"planned":8},"kpi-record-reading","kpi.record_reading",{"id":188,"text":189,"level":15,"planned":8},"kpi-list-readings","kpi.list_readings",{"id":191,"text":192,"level":15,"planned":8},"role-list-kpis","role.list_kpis",{"id":194,"text":195,"level":15,"planned":8},"role-define-kpi","role.define_kpi",{"id":197,"text":198,"level":15,"planned":8},"role-edit-kpi","role.edit_kpi",{"id":200,"text":201,"level":15,"planned":8},"os-inspect-enterprise","os.inspect_enterprise",{"id":203,"text":204,"level":15,"planned":8},"os-directory","os.directory",{"id":206,"text":207,"level":15,"planned":8},"os-list-blockers","os.list_blockers",{"id":209,"text":210,"level":15,"planned":8},"os-list-open-gates","os.list_open_gates",{"id":212,"text":213,"level":15,"planned":8},"os-list-waiting","os.list_waiting",{"id":215,"text":216,"level":15,"planned":8},"os-retry-run","os.retry_run",{"id":218,"text":219,"level":15,"planned":8},"os-route-run","os.route_run",{"id":221,"text":222,"level":15,"planned":8},"os-clear-run","os.clear_run",{"id":224,"text":225,"level":15,"planned":8},"os-escalate-run","os.escalate_run",{"id":227,"text":228,"level":15,"planned":8},"os-read-enterprise","os.read_enterprise",{"id":230,"text":231,"level":15,"planned":8},"os-search-catalog","os.search_catalog",{"id":233,"text":234,"level":15,"planned":8},"os-list-tool-bindings","os.list_tool_bindings",{"id":236,"text":237,"level":15,"planned":8},"os-list-built-in-tools","os.list_built_in_tools",{"id":239,"text":240,"level":15,"planned":8},"os-read-task","os.read_task",{"id":242,"text":243,"level":15,"planned":8},"os-assess-impact","os.assess_impact",{"id":245,"text":246,"level":15,"planned":8},"os-write-plan","os.write_plan",{"id":248,"text":249,"level":15,"planned":8},"os-read-plan","os.read_plan",{"id":251,"text":252,"level":15,"planned":8},"os-chat-list","os.chat_list",{"id":254,"text":255,"level":15,"planned":8},"os-chat-read","os.chat_read",{"id":257,"text":258,"level":15,"planned":8},"os-chat-write","os.chat_write",{"id":260,"text":261,"level":15,"planned":8},"os-chat-open","os.chat_open",{"id":263,"text":264,"level":15,"planned":8},"os-list-roles","os.list_roles",{"id":266,"text":267,"level":15,"planned":8},"os-read-role","os.read_role",{"id":269,"text":270,"level":15,"planned":8},"os-create-role","os.create_role",{"id":272,"text":273,"level":15,"planned":8},"os-update-role","os.update_role",{"id":275,"text":276,"level":15,"planned":8},"os-delete-role","os.delete_role",{"id":278,"text":279,"level":15,"planned":8},"os-add-role-task","os.add_role_task",{"id":281,"text":282,"level":15,"planned":8},"os-remove-role-task","os.remove_role_task",{"id":284,"text":285,"level":15,"planned":8},"os-add-role-member","os.add_role_member",{"id":287,"text":288,"level":15,"planned":8},"os-remove-role-member","os.remove_role_member",{"id":290,"text":291,"level":15,"planned":8},"os-list-task-definitions","os.list_task_definitions",{"id":293,"text":294,"level":15,"planned":8},"os-read-task-definition","os.read_task_definition",{"id":296,"text":297,"level":15,"planned":8},"os-create-task","os.create_task",{"id":299,"text":300,"level":15,"planned":8},"os-publish-task-version","os.publish_task_version",{"id":302,"text":303,"level":15,"planned":8},"os-set-task-run-status","os.set_task_run_status",{"id":305,"text":306,"level":15,"planned":8},"os-set-task-schedule","os.set_task_schedule",{"id":308,"text":309,"level":15,"planned":8},"os-remove-task-schedule","os.remove_task_schedule",{"id":311,"text":312,"level":15,"planned":8},"os-set-task-input-values","os.set_task_input_values",{"id":314,"text":315,"level":15,"planned":8},"os-read-context","os.read_context",{"id":317,"text":318,"level":15,"planned":8},"os-write-context","os.write_context",{"id":320,"text":321,"level":15,"planned":8},"os-list-teams","os.list_teams",{"id":323,"text":324,"level":15,"planned":8},"os-read-team","os.read_team",{"id":326,"text":327,"level":15,"planned":8},"os-create-team","os.create_team",{"id":329,"text":330,"level":15,"planned":8},"os-update-team","os.update_team",{"id":332,"text":333,"level":15,"planned":8},"os-delete-team","os.delete_team",{"id":335,"text":336,"level":15,"planned":8},"os-add-team-member","os.add_team_member",{"id":338,"text":339,"level":15,"planned":8},"os-remove-team-member","os.remove_team_member",{"id":341,"text":342,"level":15,"planned":8},"os-add-work-item","os.add_work_item",{"id":344,"text":345,"level":15,"planned":8},"os-list-work-items","os.list_work_items",{"id":347,"text":348,"level":15,"planned":8},"os-read-work-item","os.read_work_item",{"id":350,"text":351,"level":15,"planned":8},"os-update-work-item","os.update_work_item",{"id":353,"text":354,"level":15,"planned":8},"os-close-work-item","os.close_work_item",{"id":356,"text":357,"level":15,"planned":8},"os-claim-work-item","os.claim_work_item",{"id":359,"text":360,"level":15,"planned":8},"os-read-work-item-draft","os.read_work_item_draft",{"id":362,"text":363,"level":15,"planned":8},"os-write-work-item-draft","os.write_work_item_draft",{"id":365,"text":366,"level":15,"planned":8},"os-publish-role","os.publish_role",{"id":368,"text":369,"level":15,"planned":8},"os-publish-team","os.publish_team",{"id":371,"text":372,"level":15,"planned":8},"os-attach-repair","os.attach_repair",1794928143345]