-- 工具未命中转人(2026-07-30,§6.2):**人是工具的一种实现**。
-- 系统里没有这件工具(无契约,或有契约无实现)时,不报错、不空转 —— 开一张执行卡请人做,
-- 人填回的表单值就是这次调用的出参,下一拍 invoke 直接取到。

-- 面向人的作业指导段:与面向 AI 的 description 分开写,随包版本冻结。
alter table sys.tool add column guide jsonb;

create table sys.tool_handoff (
  id text primary key,
  task_id text not null,
  tool text not null,
  -- 内容地址(工具 + 入参指纹):同一次调用只问人一次,重问拿同一份答案。
  -- 没有它,Loop 每拍都会为同一件事再发一张卡。
  call_key text not null,
  input jsonb not null,
  work_order_id text not null,
  state text not null default 'pending',
  -- 人填回的值 = 工具出参
  output jsonb,
  created_at timestamptz not null default now(),
  answered_at timestamptz
);
create unique index tool_handoff_call_key on sys.tool_handoff (task_id, call_key);
create index tool_handoff_order_idx on sys.tool_handoff (work_order_id);