[{"data":1,"prerenderedAt":70},["ShallowReactive",2],{"$f2nrqr0um70z4g":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\u002Fchat","Chat tools","The os.* tools the CEO chat offers a member: the company's directory, its tasks, and starting and checking runs.",null,false,[],"\u003Cp>\u003Cem>Generated from the built-in tools registry. Do not edit by hand.\u003C\u002Fem>\u003C\u002Fp>\n\u003Cp>When the CEO talks to a member in the portal, the member can use these tools, and the member's own connected tools beside them. Chat has no gates of its own; spend still applies.\u003C\u002Fp>\n\u003Cp>A conversation opened for one job, such as creating a task, also gets the tools kept for that job. A member’s everyday thread never does.\u003C\u002Fp>\n\u003Cp>A run never answers a chat-only tool, so a task that declares one is refused when it is saved (\u003Ccode>tool_not_run_callable\u003C\u002Fcode>).\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\u002Fchat#os-list-tasks\">\u003Ccode>os.list_tasks\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>The tasks of the roles the chatting member holds, plus OS-owned tasks.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fchat#os-start-task\">\u003Ccode>os.start_task\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Queue a run of a task of a role you hold, an OS task, or a colleague's task.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fchat#os-get-run\">\u003Ccode>os.get_run\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>A run's status, why it stopped, and its recent events.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fchat#os-read-run-log\">\u003Ccode>os.read_run_log\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Read a bounded slice of a retained run log, including earlier command diagnostics.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fchat#os-hand-off-task-brief\">\u003Ccode>os.hand_off_task_brief\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Hand the brief a person agreed to over to the OS, which designs the task from it.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fchat#os-list-runs\">\u003Ccode>os.list_runs\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>The enterprise's runs, newest first, a page at a time.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fchat#os-kpi-board\">\u003Ccode>os.kpi_board\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>The enterprise's KPI board: every signed-off company KPI and each team's key KPI, with its light.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fchat#os-list-enterprise-kpis\">\u003Ccode>os.list_enterprise_kpis\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Every KPI of the enterprise, with its owner, target, cadence, light and last reading.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fchat#os-finish-waiting\">\u003Ccode>os.finish_waiting\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Mark a Waiting row’s work finished, so it leaves the list. Touches no issue tracker.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fchat#os-restart-waiting\">\u003Ccode>os.restart_waiting\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Restart a Waiting row’s work at a step of its pipeline, and get the new run.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fchat#os-clear-blocker\">\u003Ccode>os.clear_blocker\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Take a stopped run off Blockers without running it again, as its Clear or Cancel does.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fchat#os-inspect-task-contract\">\u003Ccode>os.inspect_task_contract\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Inspect the pinned or current task contract of a source run.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fchat#os-inspect-execution\">\u003Ccode>os.inspect_execution\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Inspect a source run’s execution graph, history and latest continuation.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fchat#os-preview-run-route\">\u003Ccode>os.preview_run_route\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Preview supported recovery targets without starting work.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fchat#os-export-workflow-evidence\">\u003Ccode>os.export_workflow_evidence\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Export a bounded, safe workflow evidence snapshot.\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fchat#os-return-file\">\u003Ccode>os.return_file\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Hand back a text, Markdown or CSV file under your reply in this conversation.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fchat#os-set-steps\">\u003Ccode>os.set_steps\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Record the steps you have lined up for the current request, each with its state, shown in the thread.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fchat#os-connect-tool\">\u003Ccode>os.connect_tool\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Show the person a Connect card for each tool they ask to connect, and hold what they asked to do with those tools until they are connected.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fchat#os-use-tool\">\u003Ccode>os.use_tool\u003C\u002Fcode>\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Look up and call any other user-facing OS operation.\u003C\u002Ftd>\n\u003Ctd>write\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Also offered here: \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fmemory#memory-ask\">\u003Ccode>memory.ask\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fmemory#memory-train\">\u003Ccode>memory.train\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-decide-gate\">\u003Ccode>os.decide_gate\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-mail-list\">\u003Ccode>os.mail_list\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-mail-read\">\u003Ccode>os.mail_read\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-member-mailbox-actions\">\u003Ccode>os.member_mailbox_actions\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-list\">\u003Ccode>os.my_mail_list\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-read\">\u003Ccode>os.my_mail_read\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-attachment\">\u003Ccode>os.my_mail_attachment\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-set-label\">\u003Ccode>os.my_mail_set_label\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-set-handled\">\u003Ccode>os.my_mail_set_handled\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-set-many\">\u003Ccode>os.my_mail_set_many\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-reply\">\u003Ccode>os.my_mail_reply\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-send\">\u003Ccode>os.my_mail_send\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-forward\">\u003Ccode>os.my_mail_forward\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-delete\">\u003Ccode>os.my_mail_delete\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-actions\">\u003Ccode>os.my_mail_actions\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-start-action\">\u003Ccode>os.my_mail_start_action\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-schedule-action\">\u003Ccode>os.my_mail_schedule_action\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-unschedule-action\">\u003Ccode>os.my_mail_unschedule_action\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-contacts\">\u003Ccode>os.my_mail_contacts\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-contact-save\">\u003Ccode>os.my_mail_contact_save\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-contact-delete\">\u003Ccode>os.my_mail_contact_delete\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-signature\">\u003Ccode>os.my_mail_signature\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-signature-set\">\u003Ccode>os.my_mail_signature_set\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-addresses\">\u003Ccode>os.my_mail_addresses\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-my-mail-address-signature-set\">\u003Ccode>os.my_mail_address_signature_set\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-get-enterprise-kpis\">\u003Ccode>os.get_enterprise_kpis\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-set-enterprise-kpis\">\u003Ccode>os.set_enterprise_kpis\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-get-team-kpis\">\u003Ccode>os.get_team_kpis\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-set-team-kpis\">\u003Ccode>os.set_team_kpis\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#kpi-record-reading\">\u003Ccode>kpi.record_reading\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#kpi-list-readings\">\u003Ccode>kpi.list_readings\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#role-list-kpis\">\u003Ccode>role.list_kpis\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#role-define-kpi\">\u003Ccode>role.define_kpi\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#role-edit-kpi\">\u003Ccode>role.edit_kpi\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-directory\">\u003Ccode>os.directory\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-list-blockers\">\u003Ccode>os.list_blockers\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-list-open-gates\">\u003Ccode>os.list_open_gates\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-list-waiting\">\u003Ccode>os.list_waiting\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-list-built-in-tools\">\u003Ccode>os.list_built_in_tools\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-chat-list\">\u003Ccode>os.chat_list\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-chat-read\">\u003Ccode>os.chat_read\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-chat-write\">\u003Ccode>os.chat_write\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-chat-open\">\u003Ccode>os.chat_open\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-list-roles\">\u003Ccode>os.list_roles\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-read-role\">\u003Ccode>os.read_role\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-create-role\">\u003Ccode>os.create_role\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-update-role\">\u003Ccode>os.update_role\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-delete-role\">\u003Ccode>os.delete_role\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-add-role-task\">\u003Ccode>os.add_role_task\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-remove-role-task\">\u003Ccode>os.remove_role_task\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-add-role-member\">\u003Ccode>os.add_role_member\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-remove-role-member\">\u003Ccode>os.remove_role_member\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-list-task-definitions\">\u003Ccode>os.list_task_definitions\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-read-task-definition\">\u003Ccode>os.read_task_definition\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-create-task\">\u003Ccode>os.create_task\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-publish-task-version\">\u003Ccode>os.publish_task_version\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-set-task-run-status\">\u003Ccode>os.set_task_run_status\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-set-task-schedule\">\u003Ccode>os.set_task_schedule\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-remove-task-schedule\">\u003Ccode>os.remove_task_schedule\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-set-task-input-values\">\u003Ccode>os.set_task_input_values\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-read-context\">\u003Ccode>os.read_context\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-write-context\">\u003Ccode>os.write_context\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fmemory#memory-upload\">\u003Ccode>memory.upload\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-list-teams\">\u003Ccode>os.list_teams\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-read-team\">\u003Ccode>os.read_team\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-create-team\">\u003Ccode>os.create_team\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-update-team\">\u003Ccode>os.update_team\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-delete-team\">\u003Ccode>os.delete_team\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-add-team-member\">\u003Ccode>os.add_team_member\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-remove-team-member\">\u003Ccode>os.remove_team_member\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-add-work-item\">\u003Ccode>os.add_work_item\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-list-work-items\">\u003Ccode>os.list_work_items\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-read-work-item\">\u003Ccode>os.read_work_item\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-update-work-item\">\u003Ccode>os.update_work_item\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-close-work-item\">\u003Ccode>os.close_work_item\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-publish-role\">\u003Ccode>os.publish_role\u003C\u002Fcode>\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Ftools\u002Fbuilt-in\u002Fos#os-publish-team\">\u003Ccode>os.publish_team\u003C\u002Fcode>\u003C\u002Fa>, which a run can call too.\u003C\u002Fp>\n\u003Ch2 id=\"os-list-tasks\">\u003Ccode>os.list_tasks\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>The tasks of the roles the chatting member holds, plus OS-owned tasks.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">List every task of a role you hold, whatever team you sit on, plus OS-owned tasks. OS tasks are not a person.\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> the CEO chat, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Ftasks\u002Fheld-by\u002F:memberId\u003C\u002Fcode> (\u003Ccode>tasks:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"os-start-task\">\u003Ccode>os.start_task\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Queue a run of a task of a role you hold, an OS task, or a colleague's task.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Start a run of a task of a role you hold, an OS task, or a colleague’s task. Pass taskId or slug, and input matching the task’s fields; a field you leave out takes the task’s default. The run goes to a free member holding the task’s role, who may not be you; when every holder is busy it queues as pending. This only queues the run: check it with os.get_run before reporting on 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>taskId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>The task id; pass exactly one of taskId or slug.\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 task slug; pass exactly one of taskId or slug.\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>Input matching the task fields.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>idempotencyKey\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Required over MCP\u002FAPI: a stable key for this start, at most 200 characters. Reuse on retries; use a new key for new work.\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. Chat keys on its session and tool call. MCP\u002FAPI requires an idempotencyKey, scoped to the authenticated caller and task; a replay returns the original run, even if inputs differ.\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>{ runId, status, taskId, slug, origin }\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u003C\u002Fcode> (\u003Ccode>runs: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>task_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>No task in this enterprise has that id or slug.\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;slug&quot;: &quot;weekly-report&quot;,\n  &quot;input&quot;: {\n    &quot;week&quot;: &quot;2026-W39&quot;\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-get-run\">\u003Ccode>os.get_run\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>A run's status, why it stopped, and its recent events.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">One run's status, why it stopped (blockedReason, when it is blocked), task id and input, and its last eight events. Not found for another enterprise's run.\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.\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> Status, \u003Ccode>blockedReason\u003C\u002Fcode> (why a \u003Ccode>blocked\u003C\u002Fcode> run stopped, otherwise null), task id, input, the last eight events, \u003Ccode>latestRun\u003C\u002Fcode> (the newest later run on the same work: its id, task and status now; null when this run is the newest) and \u003Ccode>handOff\u003C\u002Fcode> (\u003Ccode>state\u003C\u002Fcode> \u003Ccode>none\u003C\u002Fcode>, \u003Ccode>handed_on\u003C\u002Fcode> or \u003Ccode>not_started\u003C\u002Fcode>, the successor runs with their status, and each hand-off not started with its slug and reason).\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fruns\u002F:runId\u002Fos-tool\u003C\u002Fcode> (\u003Ccode>runs: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>runId_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>run_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>No run 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;runId&quot;: &quot;5f0c1d2e-0000-4000-8000-000000000004&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-read-run-log\">\u003Ccode>os.read_run_log\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Read a bounded slice of a retained run log, including earlier command diagnostics.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Read the retained log of a run in this enterprise, including earlier tool results and failure diagnostics that are no longer in its recent events. Pass a real runId from os.list_runs or os.get_run. Read from offset 0, then follow nextOffset until null; each slice is at most 16000 characters. A missing log is an evidence gap, not proof that no failure occurred. Read-only; never retries, routes, clears or changes a run.\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.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>offset\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, at least 0\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Character offset, from 0; use the previous nextOffset to continue.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>limit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, 1 to 16000\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Characters to read, up to 16000. Defaults to 8000.\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> \u003Ccode>{ runId, url, offset, body, total, nextOffset }\u003C\u002Fcode>: the configured portal evidence link (null when no origin is configured), retained log text, its total character count, and the next offset or null when complete.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fruns\u002F:runId\u002Flog-slice\u003C\u002Fcode> (\u003Ccode>runs: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>runId_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>run_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>No run in this enterprise has that id.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>log_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run has no retained log.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_offset\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>offset\u003C\u002Fcode> is not a nonnegative safe integer.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_limit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>limit\u003C\u002Fcode> is not an integer from 1 to 16000.\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;limit&quot;: 8000\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-hand-off-task-brief\">\u003Ccode>os.hand_off_task_brief\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Hand the brief a person agreed to over to the OS, which designs the task from it.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Hand the brief the person agreed to over to the OS, which designs the new task from it and asks the CEO to sign off on its definition before anything is created. Call it once, only after they have said yes to your read-back summary, with every part of the brief in their own words. It starts the design and returns its run; it does not create the task.\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>brief\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>object\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>What the person agreed to, each part in plain language.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>brief.goal\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>What the job is.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>brief.success\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>How to tell it was done well.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>brief.owner\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The existing team and role that should own it.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>brief.trigger\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>When it runs: on demand, on a schedule said in words, or after another task.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>brief.inputs\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>What it needs each time it runs.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>brief.tools\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The connected tools it needs, naming any that is not connected.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>brief.limits\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>What it must never do, what needs approval, and its budget.\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 conversation and the tool call: the same call sent twice starts one run.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the CEO chat, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Offered in:\u003C\u002Fstrong> a conversation opened for \u003Ccode>create_task\u003C\u002Fcode> only, never in a member's everyday thread.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ runId, status, taskId }\u003C\u002Fcode>: the run designing the task.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Ftasks\u002Ffrom-brief\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>brief_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>brief\u003C\u002Fcode> is missing, or says nothing about what the job is.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_designer_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The enterprise has no task-designing task to hand the brief 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;brief&quot;: {\n    &quot;goal&quot;: &quot;Chase unpaid invoices&quot;,\n    &quot;success&quot;: &quot;Every invoice over 30 days old gets one polite reminder&quot;,\n    &quot;owner&quot;: &quot;Finance team, accounts role&quot;,\n    &quot;trigger&quot;: &quot;Every Monday morning&quot;,\n    &quot;inputs&quot;: &quot;The list of overdue invoices&quot;,\n    &quot;tools&quot;: &quot;Email, which is connected&quot;,\n    &quot;limits&quot;: &quot;Never contact a customer twice in a week; refunds need approval; two dollars a run&quot;\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-list-runs\">\u003Ccode>os.list_runs\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>The enterprise's runs, newest first, a page at a time.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">List the enterprise's runs, newest first, one page at a time. Each run carries its status, task (id, name, slug), the member it runs as, compact work references, and when it was created, started and finished. The response is { data, total, page, limit, pages }.\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>status\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>pending\u003C\u002Fcode>, \u003Ccode>queued\u003C\u002Fcode>, \u003Ccode>running\u003C\u002Fcode>, \u003Ccode>waiting_on_gate\u003C\u002Fcode>, \u003Ccode>waiting_on_run\u003C\u002Fcode>, \u003Ccode>paused_spend\u003C\u002Fcode>, \u003Ccode>paused_plan\u003C\u002Fcode>, \u003Ccode>paused_team\u003C\u002Fcode>, \u003Ccode>paused\u003C\u002Fcode>, \u003Ccode>succeeded\u003C\u002Fcode>, \u003Ccode>failed\u003C\u002Fcode>, \u003Ccode>cancelled\u003C\u002Fcode>, \u003Ccode>skipped_overlap\u003C\u002Fcode>, \u003Ccode>blocked\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only runs in this status.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>taskId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Only runs of this task.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>live\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>boolean\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>true for only runs still in progress: not finished, not blocked, and not paused on spend, a plan limit or a switched-off team.\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>Runs 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> a run, 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 run with status, task, member, compact work references and times. Full inputs, ceoAnswers, checkpoints and storage keys are omitted. To a run: its own enterprise's runs alone, each \u003Ccode>{ id, status, taskId, taskName, taskSlug, memberId, assigneeName, input, blockedReason, stoppedReason, notBefore, createdAt, startedAt, finishedAt }\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fruns\u002Fsummary\u003C\u002Fcode> (\u003Ccode>runs:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Example:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  &quot;status&quot;: &quot;failed&quot;,\n  &quot;limit&quot;: 5\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-kpi-board\">\u003Ccode>os.kpi_board\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>The enterprise's KPI board: every signed-off company KPI and each team's key KPI, with its light.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">The enterprise's KPI board, as HQ shows it: every company KPI the owner has signed off and each team's key KPI with its light (red off target, amber at risk, green on target), its trend (up, down, flat), when it was last read, the cadence it is read on, and whether that reading is overdue. A KPI nobody has read yet has no light (`rag` is null): it is never read and overdue, not green. A KPI still waiting for sign-off is not on the board. A team that has set no key KPI is named with none rather than left out. The response is { enterprise, teams }. Read-only: recording a reading 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> the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ enterprise, teams }\u003C\u002Fcode>: each signed-off company KPI, and each team with its key KPI or \u003Ccode>key: null\u003C\u002Fcode> when it has none. Every KPI carries its light, trend, \u003Ccode>lastReadAt\u003C\u002Fcode>, \u003Ccode>cadenceDays\u003C\u002Fcode> and whether it is \u003Ccode>overdue\u003C\u002Fcode> — derived from the readings themselves, so it matches HQ's board KPI for KPI.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fenterprise\u002Fkpis\u003C\u002Fcode> (\u003Ccode>enterprise:read\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"os-list-enterprise-kpis\">\u003Ccode>os.list_enterprise_kpis\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Every KPI of the enterprise, with its owner, target, cadence, light and last reading.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">List every KPI of the enterprise, whatever layer owns it and whether or not it has been signed off, ordered by name then id. Each row carries its id (the kpiId the readings tools take), name, owner (layer and id), source (kind and ref), target (value, direction, AMBER band, on-target-worsening rule), cadence, current light, whether it is overdue, when it was signed off (null while it waits for sign-off, when it takes no reading), and its latest reading. The light is null when the KPI has no target or no reading yet. No arguments. Never another enterprise's KPIs.\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> 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>, \u003Ccode>target\u003C\u002Fcode>, \u003Ccode>cadenceMinutes\u003C\u002Fcode>, \u003Ccode>light\u003C\u002Fcode>, \u003Ccode>overdue\u003C\u002Fcode>, \u003Ccode>signedOffAt\u003C\u002Fcode> (ISO 8601, or null) 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>GET \u002Fv1\u002Fkpis\u003C\u002Fcode> (\u003Ccode>kpis: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-finish-waiting\">\u003Ccode>os.finish_waiting\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Mark a Waiting row’s work finished, so it leaves the list. Touches no issue tracker.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Mark one piece of work on the Waiting list finished, as its Mark finished button does. Pass pipeline as os.list_waiting names it. The finish is recorded on the work’s newest run, attributed to you (a task’s call is attributed to its run), and takes it off the list; no run is started or stopped, and the issue or pull request is not touched. Refused when the work is not on the list, or when its execution is still doing other work. A later run on the same pipeline lists it again once that run ends.\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>pipeline\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The work, as \u003Ccode>owner\u002Fname#&lt;number&gt;\u003C\u002Fcode>, the way os.list_waiting names 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. A finished row is off the list, so a repeat is refused with not_waiting and records nothing more.\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>{ finished: true }\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fwaiting\u002Ffinish\u003C\u002Fcode> (\u003Ccode>runs: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>waiting_field_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>pipeline\u003C\u002Fcode> is missing or empty (400).\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>not_waiting\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The work is not on the Waiting list, or its execution is still doing other work (409).\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;pipeline&quot;: &quot;acme\u002Frocket#935&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-restart-waiting\">\u003Ccode>os.restart_waiting\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Restart a Waiting row’s work at a step of its pipeline, and get the new run.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Restart one piece of work on the Waiting list at a step, as its Restart button does. Pass pipeline as os.list_waiting names it, and task: the slug of the step to run. The same task as the newest run retries it; another task of its pipeline routes the work there. The new run is open, so the work leaves the list, and the newest run records that you restarted it and where. Refused when the work is not on the list. A task’s restart is attributed to its run. Every restart is refused while the work’s execution is still doing other work, and preserves os.retry_run’s existing cap: a chain may be retried, routed or restarted 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>pipeline\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The work, as \u003Ccode>owner\u002Fname#&lt;number&gt;\u003C\u002Fcode>, the way os.list_waiting 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: the newest run’s own task to retry it, or another task of its pipeline.\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.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Retry:\u003C\u002Fstrong> Not retry-safe: a repeat acts again. While the run it started is open the work is off the list, so a repeat is refused with not_waiting. Once that run ends, a repeat starts another. A task’s call is keyed on the tool call: the same call sent twice starts one run and the repeat answers with it.\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> The new run: its \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>status\u003C\u002Fcode> (\u003Ccode>queued\u003C\u002Fcode>, or \u003Ccode>pending\u003C\u002Fcode> while its task or member is busy), \u003Ccode>taskId\u003C\u002Fcode> and \u003Ccode>input\u003C\u002Fcode>, with the rest of the run’s fields. A task’s call answers with \u003Ccode>id\u003C\u002Fcode>, \u003Ccode>status\u003C\u002Fcode>, \u003Ccode>taskId\u003C\u002Fcode> and \u003Ccode>input\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fwaiting\u002Frestart\u003C\u002Fcode> (\u003Ccode>runs: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>active_continuation\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The execution is still doing other work.\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 waiting, rejected or changes-requested gate still controls this work.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>waiting_field_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>pipeline\u003C\u002Fcode> or \u003Ccode>task\u003C\u002Fcode> is missing or empty (400).\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>not_waiting\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The work is not on the Waiting list (409).\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>The task is neither a successor of the newest run’s task nor one that already ran on this pipeline (409).\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>This chain has already been retried, routed or restarted 3 times. Waiting restart preserves the existing retry budget for people and tasks alike.\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;pipeline&quot;: &quot;acme\u002Frocket#935&quot;,\n  &quot;task&quot;: &quot;review-pr&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-clear-blocker\">\u003Ccode>os.clear_blocker\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Take a stopped run off Blockers without running it again, as its Clear or Cancel does.\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, merged or parked, or it is a stale escalation nobody has to decide. A failed run, or one that finished on an outcome nothing follows, is cleared; a blocked run is cancelled. Pass runId as os.list_blockers names it, and note: why nothing more is needed, recorded on the run with your name. 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 os.list_blockers 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\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. A cleared or cancelled run is off Blockers, so a repeat is refused and 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 run as it now stands: \u003Ccode>cancelled\u003C\u002Fcode> for a blocked run, otherwise its own status with \u003Ccode>clearedAt\u003C\u002Fcode> set.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fruns\u002F:runId\u002Fclear-stopped\u003C\u002Fcode> (\u003Ccode>runs: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_work_item_state\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>workItemState is not held, ready, done or dropped (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>note\u003C\u002Fcode> is missing or empty (400).\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 (404).\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 is still working, or it finished on an outcome its task follows (409).\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 (409). 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 (409).\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;note&quot;: &quot;Parked until its sibling closes; the escalation has nothing to decide&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-inspect-task-contract\">\u003Ccode>os.inspect_task_contract\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Inspect the pinned or current task contract of a source run.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Read the task and exact version a source run was pinned to (default version: pinned), or version: current for comparison. Includes structured outcome\u002Ffinish contract, successors with conditions and caps, tools and approval gates. Skill text is paged (offset in characters, limit up to 16000), with its content hash and exact version provenance. A repaired current task does not change a historical pinned contract. No binding values, checkpoints or storage addresses.\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 source run id in this enterprise.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>version\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>pinned\u003C\u002Fcode>, \u003Ccode>current\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Pinned historical contract (default) or current task version.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>offset\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, at least 0\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Offset from the previous nextOffset; starts at zero.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>limit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, 1 to 16000\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Skill characters per page, defaults to 4000.\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> Tenant-scoped evidence with exact run and version provenance, pagination and explicit omissions. Refusals are evidence gaps; never infer success, rerun work or ask for credentials.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fruns\u002F:runId\u002Ftask-contract\u003C\u002Fcode> (\u003Ccode>runs: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>run_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The source run does not exist in this enterprise.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_contract_unavailable\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The source task or selected version is unavailable. Ask the workflow owner to inspect the retained definition.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>execution_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>No retained execution can be read. Preserve this evidence gap.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_offset\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The offset is not a nonnegative integer.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_limit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The limit is outside the documented bound.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>workflow_diagnostics_unavailable\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The API deployment does not provide the inspectors. Send the deployment gap to the workflow owner.\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}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-inspect-execution\">\u003Ccode>os.inspect_execution\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Inspect a source run’s execution graph, history and latest continuation.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Read the source execution graph with version provenance, runs, causal links, paged event headers and latest continuation. Inspect the latest continuation before routing or escalating: pending and running work must not be restarted. Raw input, ceoAnswers, payloads, credentials and checkpoints are omitted. Acceptance of a continuation is separate from validation and delivery.\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 source run id in this enterprise.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>offset\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, at least 0\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Offset from the previous nextOffset; starts at zero.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>limit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, 1 to 100\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Event headers per page, at most 100; 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> a run, the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> Tenant-scoped evidence with exact run and version provenance, pagination and explicit omissions. Refusals are evidence gaps; never infer success, rerun work or ask for credentials.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fruns\u002F:runId\u002Fexecution-evidence\u003C\u002Fcode> (\u003Ccode>runs: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>run_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The source run does not exist in this enterprise.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_contract_unavailable\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The source task or selected version is unavailable. Ask the workflow owner to inspect the retained definition.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>execution_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>No retained execution can be read. Preserve this evidence gap.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_offset\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The offset is not a nonnegative integer.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_limit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The limit is outside the documented bound.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>workflow_diagnostics_unavailable\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The API deployment does not provide the inspectors. Send the deployment gap to the workflow owner.\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}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-preview-run-route\">\u003Ccode>os.preview_run_route\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Preview supported recovery targets without starting work.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">List actual supported recovery targets for this source run, or validate task (a target slug). Reports supported\u002Fallowed and actionable refusal, latest continuation and the unchanged retry limit. A preview is read-only and reserves nothing. os.route_run revalidates at acceptance; caps, spend and gates still apply. Workflow contract defects go to the workflow owner, never an invented application test stage.\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 source run id in this enterprise.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Optional target slug to validate; omit to list supported targets.\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> Tenant-scoped evidence with exact run and version provenance, pagination and explicit omissions. Refusals are evidence gaps; never infer success, rerun work or ask for credentials.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fruns\u002F:runId\u002Froute-preview\u003C\u002Fcode> (\u003Ccode>runs: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>run_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The source run does not exist in this enterprise.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_contract_unavailable\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The source task or selected version is unavailable. Ask the workflow owner to inspect the retained definition.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>execution_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>No retained execution can be read. Preserve this evidence gap.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_offset\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The offset is not a nonnegative integer.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_limit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The limit is outside the documented bound.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>workflow_diagnostics_unavailable\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The API deployment does not provide the inspectors. Send the deployment gap to the workflow owner.\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}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-export-workflow-evidence\">\u003Ccode>os.export_workflow_evidence\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Export a bounded, safe workflow evidence snapshot.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Export pinned\u002Fcurrent structured task contracts with text hashes, execution graph, causal history and route diagnostics. Includes capture time, exact provenance, pagination and explicit omissions. Omits skill prose, raw inputs\u002FceoAnswers, tool and result payloads, binding values, checkpoints and storage addresses. Follow execution.history.nextOffset; inspect_task_contract explicitly pages skill text when needed.\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 source run id in this enterprise.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>offset\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, at least 0\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Offset from the previous nextOffset; starts at zero.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>limit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>integer, 1 to 100\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Event headers per page, at most 100; 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> a run, the API, the CEO chat, the OS MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> Tenant-scoped evidence with exact run and version provenance, pagination and explicit omissions. Refusals are evidence gaps; never infer success, rerun work or ask for credentials.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>GET \u002Fv1\u002Fruns\u002F:runId\u002Fworkflow-export\u003C\u002Fcode> (\u003Ccode>runs: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>run_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The source run does not exist in this enterprise.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>task_contract_unavailable\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The source task or selected version is unavailable. Ask the workflow owner to inspect the retained definition.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>execution_not_found\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>No retained execution can be read. Preserve this evidence gap.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_offset\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The offset is not a nonnegative integer.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>invalid_limit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The limit is outside the documented bound.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>workflow_diagnostics_unavailable\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The API deployment does not provide the inspectors. Send the deployment gap to the workflow owner.\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}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-return-file\">\u003Ccode>os.return_file\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Hand back a text, Markdown or CSV file under your reply in this conversation.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Hand the person a file in this conversation: a drafted document as Markdown or text, or an export as CSV. Pass the filename, ending .md, .txt or .csv, and the whole file as text; it is saved as UTF-8. The file shows under the reply that ends this turn, where anyone who may work in this conversation can download it. A person’s file limits apply: 10 MB per file and 5 files per reply, within the plan’s storage. A refused file comes back as an error saying why, and nothing is saved. The response is { id, filename, sizeBytes, type }.\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>filename\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The name the file is saved under, ending .md, .txt or .csv.\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 file, as text.\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 conversation and the tool call: the same call sent twice stores one file.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the CEO chat, the API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ id, filename, sizeBytes, type }\u003C\u002Fcode>: the file as it shows under your reply.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>API:\u003C\u002Fstrong> \u003Ccode>POST \u002Fv1\u002Fchats\u002F:id\u002Ffiles\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>filename_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>filename\u003C\u002Fcode> is missing or empty.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>content_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>content\u003C\u002Fcode> is missing or is not text.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>chat_file_unsupported_type\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The filename does not end .txt, .md or .csv: a teammate returns text, Markdown or CSV only.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>chat_file_limit_exceeded\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The file is over 10 MB, or 5 files already wait for this reply.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>plan_limit_reached\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The file would take the enterprise past its plan’s storage.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>chat_files_not_stored\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>This conversation has nowhere to store a file.\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;filename&quot;: &quot;q3-revenue.csv&quot;,\n  &quot;content&quot;: &quot;Quarter,Revenue\\nQ3,1200\\n&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-set-steps\">\u003Ccode>os.set_steps\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Record the steps you have lined up for the current request, each with its state, shown in the thread.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Write down the steps you have lined up for the person’s current request, and where each one stands, so the person sees them in this conversation just above where they write. Send the whole list every time, in order: each call replaces the list this conversation keeps, so send every step again with its state brought up to date, and send an empty list to clear it. A state is todo, in_progress, done or skipped; mark a step skipped when the person tells you to skip it, rather than leaving it out. At most 20 steps, each title one line of at most 200 characters. The list belongs to this conversation alone, and you are shown it again at the start of every turn. The response is { steps }: the list as it is now kept.\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>steps\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of object\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The whole list, in order: at most 20 steps. An empty list clears it.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>steps[].title\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>What the step is, in a few words: at most 200 characters.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>steps[].state\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>todo\u003C\u002Fcode>, \u003Ccode>in_progress\u003C\u002Fcode>, \u003Ccode>done\u003C\u002Fcode>, \u003Ccode>skipped\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>Where the step stands: todo, in_progress (under way), done, or skipped when the person said to skip 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. Keyed on the conversation and the tool call: the same call sent twice sets the list once. Each call replaces the whole list, so a repeat leaves the same list.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the CEO chat.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ steps }\u003C\u002Fcode>: the whole list as it is now kept, each \u003Ccode>{ title, state }\u003C\u002Fcode>, and an empty list once cleared.\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>steps_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>steps\u003C\u002Fcode> is missing or is not a list.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>steps_too_many\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The list has more than 20 steps. Nothing is kept.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>step_title_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A step’s title is missing, or blank once trimmed. Nothing is kept.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>step_title_too_long\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A step’s title is over 200 characters once trimmed. Nothing is kept.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>step_state_invalid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A step’s state is not todo, in_progress, done or skipped. Nothing is kept.\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;steps&quot;: [\n    {\n      &quot;title&quot;: &quot;Read the brief&quot;,\n      &quot;state&quot;: &quot;done&quot;\n    },\n    {\n      &quot;title&quot;: &quot;Draft the plan&quot;,\n      &quot;state&quot;: &quot;in_progress&quot;\n    },\n    {\n      &quot;title&quot;: &quot;Send it round for comments&quot;,\n      &quot;state&quot;: &quot;todo&quot;\n    }\n  ]\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-connect-tool\">\u003Ccode>os.connect_tool\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Show the person a Connect card for each tool they ask to connect, and hold what they asked to do with those tools until they are connected.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Answer a request to connect tools, such as &quot;connect Slack&quot; or &quot;connect Slack to Linear and post this week’s open bugs&quot;. Pass the person’s words as request, each tool they named as they wrote it in tools, and anything they asked you to do once the tools are connected in afterwards. Each tool is answered in its own result: card (a Connect card is shown in the thread; the person signs in there), connected (it already is: say so and carry on), expired (its sign-in no longer works, so a card is shown to connect it again), which_one or did_you_mean (ask the person the question in message before anything else), not_in_chat (it cannot be connected from the chat yet: give the person the message, which links the Tools page) or not_allowed (this person may not connect tools: tell them who can, in the message’s own words). With afterwards and a tool still to connect, the request is held: say up front what you will do once they are connected, and do nothing of it until then. The OS tells you here when they are, and you do it then. Never ask the person for a key, a token or a password: the card is how a tool is connected. Disconnecting is only on the Tools page.\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>request\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>What the person asked, in their own words.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>tools\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>array of string\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>Each tool the person asked to connect, as they named it.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>afterwards\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>What the person asked you to do once the tools are connected, in a few words. Leave it out when they only asked to connect.\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 tool asked for twice in one conversation keeps one card, and a repeat holds the same request again in place of the one held.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the CEO chat.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Returns:\u003C\u002Fstrong> \u003Ccode>{ results, held?, message }\u003C\u002Fcode>: one result per tool named, each \u003Ccode>{ name, kind, state?, message }\u003C\u002Fcode> with display names only, \u003Ccode>held\u003C\u002Fcode> (\u003Ccode>{ request, afterwards, waitingFor, done }\u003C\u002Fcode>) when what the person asked waits on a tool, and \u003Ccode>message\u003C\u002Fcode>, what to tell the person.\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>tools_required\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>tools\u003C\u002Fcode> is missing or names no tool.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>not_allowed\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Whoever sent the turn may not connect the company’s tools. No card is shown and nothing is held.\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;request&quot;: &quot;connect Slack to Linear and post this week’s open bugs&quot;,\n  &quot;tools&quot;: [\n    &quot;Slack&quot;,\n    &quot;Linear&quot;\n  ],\n  &quot;afterwards&quot;: &quot;post this week’s open bugs&quot;\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"os-use-tool\">\u003Ccode>os.use_tool\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cp>Look up and call any other user-facing OS operation.\u003C\u002Fp>\n\u003Cp>What the model reads:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Access the full OS tool catalog. Pass tool only to read its exact input schema and instructions. Then call again with tool and arguments to perform it. Calls use the current requester’s permissions, attribution and normal confirmations. Only the listed OS operations are accepted; run-only and vendor tools cannot be called through this entry point.\nmemory.ask: Ask enterprise memory a question, and get an answer with its evidence.\nmemory.train: Teach enterprise memory one note about a task, at the task's layer by default.\nos.mail_list: List a member's inbox, newest first: metadata and a snippet, no bodies.\nos.mail_read: Read one message from a member's inbox.\nos.member_mailbox_actions: 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.\nos.my_mail_list: List the mail in your own mailbox, newest first: metadata and a snippet, no bodies.\nos.my_mail_read: Read one message from your own mailbox.\nos.my_mail_attachment: Fetch one attachment of a message in your own mailbox, base64-encoded.\nos.my_mail_set_label: Set the labels on a message in your own mailbox.\nos.my_mail_set_handled: Record where a message in your own mailbox stands: unhandled, replied, skipped, or snoozed until a date.\nos.my_mail_set_many: Set the labels, the handled state, or both on many messages in your own mailbox at once.\nos.my_mail_reply: Reply to a message in your own mailbox, from your own address, with no approval step.\nos.my_mail_send: Send a new mail from your own address, with no approval step.\nos.my_mail_forward: Forward a message from your own mailbox to somebody else, from your own address, with no approval step.\nos.my_mail_delete: Delete a message from your own mailbox for good.\nos.my_mail_contacts: List or search your own contacts: the people you have written to, and those you added.\nos.my_mail_contact_save: Add a contact to your own mailbox, or name one already there.\nos.my_mail_contact_delete: Remove a contact from your own mailbox.\nos.my_mail_signature: Read the signature the OS adds to every mail you send, reply and forward.\nos.my_mail_signature_set: Set or clear the signature the OS adds to every mail you send.\nos.my_mail_addresses: List your own extra addresses, each with the signature mail from it carries.\nos.my_mail_address_signature_set: Set or clear the signature mail from one of your extra addresses carries.\nos.get_enterprise_kpis: The company's KPI targets, bands, cadence and source.\nos.set_enterprise_kpis: Replace the company's KPI target list.\nos.get_team_kpis: A team's KPI targets, including its key KPI.\nos.set_team_kpis: Replace a team's KPI target list and key KPI.\nkpi.record_reading: Record one reading of a KPI by hand: the value, when it was taken, and who or what took it.\nkpi.list_readings: One KPI's readings, newest first, corrected ones included.\nrole.list_kpis: A role's KPIs, oldest first, with the team KPI each serves, its sign-off, light, trend and readings.\nrole.define_kpi: Propose a KPI on a role, waiting for a person to sign it off.\nrole.edit_kpi: Change a role KPI's fields; a signed-off one only a person changes.\nos.list_blockers: What has stopped: failed, stalled, blocked and spend-paused runs, and stopped pipelines, with who owns each.\nos.list_waiting: Open work nothing is working on: no live or queued run, no waiting decision, not on Blockers, not finished.\nos.list_built_in_tools: Every built-in tool a run can call, with its summary and whether it reads or writes.\nos.chat_list: List chat threads, most recently active first: who each is with, its state and its last message.\nos.chat_read: Read one chat thread: its messages, oldest first.\nos.chat_write: Write one message in a chat thread, as yourself.\nos.chat_open: Open a new chat thread with a member.\nos.read_run_log: Read a bounded slice of a retained run log, including earlier command diagnostics.\nos.list_runs: The enterprise's runs, newest first, a page at a time.\nos.kpi_board: The enterprise's KPI board: every signed-off company KPI and each team's key KPI, with its light.\nos.list_enterprise_kpis: Every KPI of the enterprise, with its owner, target, cadence, light and last reading.\nos.finish_waiting: Mark a Waiting row’s work finished, so it leaves the list. Touches no issue tracker.\nos.restart_waiting: Restart a Waiting row’s work at a step of its pipeline, and get the new run.\nos.clear_blocker: Take a stopped run off Blockers without running it again, as its Clear or Cancel does.\nos.inspect_task_contract: Inspect the pinned or current task contract of a source run.\nos.inspect_execution: Inspect a source run’s execution graph, history and latest continuation.\nos.preview_run_route: Preview supported recovery targets without starting work.\nos.export_workflow_evidence: Export a bounded, safe workflow evidence snapshot.\nos.create_task: Create one of the enterprise’s own tasks.\nos.publish_task_version: Publish a new version of one of the enterprise’s tasks, naming the version it was read from.\nos.set_task_run_status: Enable or disable a task.\nos.set_task_schedule: Set a task schedule.\nos.remove_task_schedule: Remove a task schedule.\nos.set_task_input_values: Set this enterprise's own values for a task's inputs.\nos.read_context: Read enterprise workflow context outside a run.\nos.write_context: Set enterprise workflow context outside a run.\nmemory.upload: Upload one note to a team or the whole enterprise.\nos.publish_role: Publish one of the enterprise’s roles to the catalog, by its portable name and slug.\nos.publish_team: Publish one of the enterprise’s teams to the catalog, with its roles, as the portal’s Share 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>tool\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>string, one of \u003Ccode>memory.ask\u003C\u002Fcode>, \u003Ccode>memory.train\u003C\u002Fcode>, \u003Ccode>os.mail_list\u003C\u002Fcode>, \u003Ccode>os.mail_read\u003C\u002Fcode>, \u003Ccode>os.member_mailbox_actions\u003C\u002Fcode>, \u003Ccode>os.my_mail_list\u003C\u002Fcode>, \u003Ccode>os.my_mail_read\u003C\u002Fcode>, \u003Ccode>os.my_mail_attachment\u003C\u002Fcode>, \u003Ccode>os.my_mail_set_label\u003C\u002Fcode>, \u003Ccode>os.my_mail_set_handled\u003C\u002Fcode>, \u003Ccode>os.my_mail_set_many\u003C\u002Fcode>, \u003Ccode>os.my_mail_reply\u003C\u002Fcode>, \u003Ccode>os.my_mail_send\u003C\u002Fcode>, \u003Ccode>os.my_mail_forward\u003C\u002Fcode>, \u003Ccode>os.my_mail_delete\u003C\u002Fcode>, \u003Ccode>os.my_mail_contacts\u003C\u002Fcode>, \u003Ccode>os.my_mail_contact_save\u003C\u002Fcode>, \u003Ccode>os.my_mail_contact_delete\u003C\u002Fcode>, \u003Ccode>os.my_mail_signature\u003C\u002Fcode>, \u003Ccode>os.my_mail_signature_set\u003C\u002Fcode>, \u003Ccode>os.my_mail_addresses\u003C\u002Fcode>, \u003Ccode>os.my_mail_address_signature_set\u003C\u002Fcode>, \u003Ccode>os.get_enterprise_kpis\u003C\u002Fcode>, \u003Ccode>os.set_enterprise_kpis\u003C\u002Fcode>, \u003Ccode>os.get_team_kpis\u003C\u002Fcode>, \u003Ccode>os.set_team_kpis\u003C\u002Fcode>, \u003Ccode>kpi.record_reading\u003C\u002Fcode>, \u003Ccode>kpi.list_readings\u003C\u002Fcode>, \u003Ccode>role.list_kpis\u003C\u002Fcode>, \u003Ccode>role.define_kpi\u003C\u002Fcode>, \u003Ccode>role.edit_kpi\u003C\u002Fcode>, \u003Ccode>os.list_blockers\u003C\u002Fcode>, \u003Ccode>os.list_waiting\u003C\u002Fcode>, \u003Ccode>os.list_built_in_tools\u003C\u002Fcode>, \u003Ccode>os.chat_list\u003C\u002Fcode>, \u003Ccode>os.chat_read\u003C\u002Fcode>, \u003Ccode>os.chat_write\u003C\u002Fcode>, \u003Ccode>os.chat_open\u003C\u002Fcode>, \u003Ccode>os.read_run_log\u003C\u002Fcode>, \u003Ccode>os.list_runs\u003C\u002Fcode>, \u003Ccode>os.kpi_board\u003C\u002Fcode>, \u003Ccode>os.list_enterprise_kpis\u003C\u002Fcode>, \u003Ccode>os.finish_waiting\u003C\u002Fcode>, \u003Ccode>os.restart_waiting\u003C\u002Fcode>, \u003Ccode>os.clear_blocker\u003C\u002Fcode>, \u003Ccode>os.inspect_task_contract\u003C\u002Fcode>, \u003Ccode>os.inspect_execution\u003C\u002Fcode>, \u003Ccode>os.preview_run_route\u003C\u002Fcode>, \u003Ccode>os.export_workflow_evidence\u003C\u002Fcode>, \u003Ccode>os.create_task\u003C\u002Fcode>, \u003Ccode>os.publish_task_version\u003C\u002Fcode>, \u003Ccode>os.set_task_run_status\u003C\u002Fcode>, \u003Ccode>os.set_task_schedule\u003C\u002Fcode>, \u003Ccode>os.remove_task_schedule\u003C\u002Fcode>, \u003Ccode>os.set_task_input_values\u003C\u002Fcode>, \u003Ccode>os.read_context\u003C\u002Fcode>, \u003Ccode>os.write_context\u003C\u002Fcode>, \u003Ccode>memory.upload\u003C\u002Fcode>, \u003Ccode>os.publish_role\u003C\u002Fcode>, \u003Ccode>os.publish_team\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>yes\u003C\u002Ftd>\n\u003Ctd>The OS operation to look up or call.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>arguments\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>object\u003C\u002Ftd>\n\u003Ctd>no\u003C\u002Ftd>\n\u003Ctd>Omit to look up the schema. Supply an object (including {} for no inputs) to call the operation.\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 schema lookup only reads. An executed operation retains its own effect and retry rules.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Called by:\u003C\u002Fstrong> the CEO chat.\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>tool_not_offered\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The requested tool is not in the user-facing OS catalog.\u003C\u002Ftd>\n\u003Ctd>Tool error\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n",[12,16,19,22,25,28,31,34,37,40,43,46,49,52,55,58,61,64,67],{"id":13,"text":14,"level":15,"planned":8},"os-list-tasks","os.list_tasks",2,{"id":17,"text":18,"level":15,"planned":8},"os-start-task","os.start_task",{"id":20,"text":21,"level":15,"planned":8},"os-get-run","os.get_run",{"id":23,"text":24,"level":15,"planned":8},"os-read-run-log","os.read_run_log",{"id":26,"text":27,"level":15,"planned":8},"os-hand-off-task-brief","os.hand_off_task_brief",{"id":29,"text":30,"level":15,"planned":8},"os-list-runs","os.list_runs",{"id":32,"text":33,"level":15,"planned":8},"os-kpi-board","os.kpi_board",{"id":35,"text":36,"level":15,"planned":8},"os-list-enterprise-kpis","os.list_enterprise_kpis",{"id":38,"text":39,"level":15,"planned":8},"os-finish-waiting","os.finish_waiting",{"id":41,"text":42,"level":15,"planned":8},"os-restart-waiting","os.restart_waiting",{"id":44,"text":45,"level":15,"planned":8},"os-clear-blocker","os.clear_blocker",{"id":47,"text":48,"level":15,"planned":8},"os-inspect-task-contract","os.inspect_task_contract",{"id":50,"text":51,"level":15,"planned":8},"os-inspect-execution","os.inspect_execution",{"id":53,"text":54,"level":15,"planned":8},"os-preview-run-route","os.preview_run_route",{"id":56,"text":57,"level":15,"planned":8},"os-export-workflow-evidence","os.export_workflow_evidence",{"id":59,"text":60,"level":15,"planned":8},"os-return-file","os.return_file",{"id":62,"text":63,"level":15,"planned":8},"os-set-steps","os.set_steps",{"id":65,"text":66,"level":15,"planned":8},"os-connect-tool","os.connect_tool",{"id":68,"text":69,"level":15,"planned":8},"os-use-tool","os.use_tool",1794928143332]