Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 20 additions & 5 deletions docs/reference/required-work-context.md
Original file line number Diff line number Diff line change
Expand Up @@ -221,9 +221,17 @@ applies during explicit Todo selection when work and quota spending are
still disabled. A complete scan can still hit the summary's display limit.
The initial view then also keeps the exact omitted count and reconciliation
guidance. The required read and its existing cursor deliver the scoped request
rows. The captured summary remains available at its original address. An
incomplete scan, unavailable scan records or an unmatched read keeps the whole
summary inline.
rows. With `--attention-only`, each incoming page keeps full `items` for
requests still needing their briefs and `open_request_summaries` for requests
whose latest delivered conclusion leaves remaining work. Follow `next_cursor`
even on summary-only pages. The same cursor continues to open sent requests
after the incoming rows. Pages with only sent summaries do not deliver or
consume results. A nonzero `unavailable_count` calls for receipt recovery.
Use `--request-id` without `--attention-only` to read a complete incoming
brief. Inspect a sent Goal request with `manager-inbox status` using the
summary's receiver `agent_id` and exact `request_id` in the same Goal.
The captured summary remains available at its original address. An incomplete
scan, unavailable scan records or an unmatched read keeps the whole summary inline.
Adoption and queued returns are intermediate states. Read the full current request before
assessing, executing or returning it. Use the existing scoped request and
consumption routes for those actions.
Expand Down Expand Up @@ -434,8 +442,15 @@ full/delta 字节比较计入这些 reader 命令元数据;既有进程内引
首读包含有界 `unfinished_delegations` 投影和 `read_complete` 标记。已准入的普通
工作 Turn 若有大型委派摘要、扫描完整,且必读列表中有同一条管家收件箱命令,首读保留
收发请求计数、扫描状态和必读命令。扫描完整但摘要达到展示上限时,首读同时保留精确的
省略数量与核对指引。逐条请求通过必读命令及其现有分页游标交付。原摘要仍可从同一
捕获取回。扫描不完整、扫描记录不可读或没有匹配必读命令时,首读保留完整摘要。
省略数量与核对指引。逐条请求通过必读命令及其现有分页游标交付。`--attention-only`
下,需要原简报的收件仍在 `items`,最近一次结论已送达且有剩余工作的收件在
`open_request_summaries`。只有摘要的页也继续跟随 `next_cursor`,收件读完后
沿同一游标查阅未结外发委派。只含外发摘要的续页不送达或消费结果。
`unavailable_count` 大于零时须恢复对应收执。收件全文用不带
`--attention-only` 的 `--request-id` 精读。Goal 外发委派可在同一 Goal 下用
摘要中的接收方 `agent_id` 和精确 `request_id` 查阅 `manager-inbox status`。
原摘要仍可从同一捕获取回。
扫描不完整、扫描记录不可读或没有匹配必读命令时,首读保留完整摘要。
采纳和回传入队是中间状态,评估、执行或回传前须读当前请求全文,并沿已有范围约束和
消费入口办理。

Expand Down
7 changes: 7 additions & 0 deletions loopx/capabilities/manager_context/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,13 @@ and governed-delegation tool descriptions. Keep reader, language, corrections
and result destination with the original work; do not maintain a second copy in
a private manager configuration or an installed skill.
The heartbeat hook's required Inbox read uses the same CLI entrypoint.
It requests `read --attention-only`. An unfinished incoming request with a
verified delivered partial answer for its current revision stays on the compact
agenda, with its remaining work and the unfiltered read command. Requests
without that proof, including queued or unreadable returns, still supply the
full brief before work. Read a request's full current brief with `--request-id`
before resuming it or returning an answer. Peer returns, native child results
and operation handoffs use their usual readers.

The rule calls for a useful outcome first, explained terms and comparisons with
units and direction. Full evidence, negative results, unknown costs and remaining
Expand Down
1 change: 1 addition & 0 deletions loopx/capabilities/manager_context/__init__.py
Original file line number Diff line number Diff line change
Expand Up @@ -292,6 +292,7 @@ def produce():
str(runtime_root),
"manager-inbox",
"read",
"--attention-only",
*(["--format", "markdown"] if model_read else []),
"--goal-id",
goal_id,
Expand Down
7 changes: 6 additions & 1 deletion loopx/cli_commands/manager_inbox.py
Original file line number Diff line number Diff line change
Expand Up @@ -236,6 +236,8 @@ def register_manager_inbox(subparsers, add_format):
parser.add_argument("--sender-id", help="For configuring a new delivery source: its independently verified sender.")
parser.add_argument("--execute", action="store_true")
parser.add_argument("--request-id", help="For read: inspect this exact current or concluded request instead of the pending inbox.")
parser.add_argument("--attention-only", action="store_true",
help="For read: page through incoming briefs, summaries of partial conclusions and open sent requests.")
parser.add_argument(
"--phase", choices=("decision", "conclusion"), default="conclusion"
)
Expand Down Expand Up @@ -263,6 +265,9 @@ def handle_manager_inbox(args, registry_path, runtime_root):
try:
remainder = getattr(args, "remaining_work", None)
resume = getattr(args, "resume_when", None)
attention_only = getattr(args, "attention_only", False)
if attention_only and (args.manager_inbox_action != "read" or getattr(args, "request_id", None) is not None):
raise ValueError("--attention-only requires read without --request-id")
if remainder is not None or resume is not None:
if args.manager_inbox_action != "report" or remainder is None or resume is None:
raise ValueError("--remaining-work and --resume-when require report and each other")
Expand Down Expand Up @@ -465,7 +470,7 @@ def handle_manager_inbox(args, registry_path, runtime_root):
# Only the invocation-bound host reader can record Turn delivery.
result = read_inbox(runtime_root, registry_path, args.goal_id, args.agent_id,
workspace=Path.cwd(), cursor=cursor, operation_cursor=operation_cursor,
request_id=request_id)
request_id=request_id, attention_only=attention_only)
result["instruction"] += " " + collaboration_answer_instruction()
if request_id is None:
result["followthrough"] += (
Expand Down
Loading
Loading