vrr/agent-zero
2
0
Fork 0
mirror of https://github.com/agent0ai/agent-zero.git synced 2026-10-19 15:33:54 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1

Document remaining tool arguments in prompts and DOX

Browse source 
Add model-facing tool arguments found by a manual audit: call_subordinate name, office_artifact sheet plus edit count and preview_chars, browser skill value, paths, ref, keys, and selectors, and computer_use_remote include_hidden, include_offscreen, max_windows, mode, target, value, and path. Keep prompts canonical-only and record legacy aliases and action-value spellings in the owning DOX files for browser, a0_connector, office, text_editor, code_execution, goal, call_subordinate, and parallel.

Verified the argument flows against tool source in three independent manual audit passes covering core tools, plugin tools, helpers, and WebUI handlers. Verified prompt catalog and plugin scan tests in the framework runtime and kept the mirrored core instance in sync for live testing.
This commit is contained in:
linkliti 2026-09-10 16:59:47 +03:00
parent 60c6a7fed2
commit bd06096a3d
12 changed files with 23 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

1
tools/call_subordinate.py.dox.md
View file

@ -36,6 +36,7 @@
- Active parallel children cannot be continued concurrently; await or cancel their job first.
- Child contexts inherit the caller's project and selected chat-model override, are saved before execution and again on exit, and remain reusable after model/API failures.
- The direct tool result includes `context_id`; parallel job snapshots expose the same stable child ID separately from their per-invocation job ID.
- Legacy args `agent_id` for `context_id` and `agent_profile` for `profile` still resolve; prompts document only canonical names.
- Existing same-context linear subordinates remain reusable for saved-chat compatibility, but new children use child contexts and a private per-parent registry.
- Imported dependency areas include: `agent`, `extensions.python.hist_add_tool_result`, `helpers`, `helpers.errors`, `helpers.tool`.

1
tools/parallel.py.dox.md
View file

@ -28,6 +28,7 @@
- `action="await"` waits for requested job IDs until completion or `timeout`; timeout returns running job handles without canceling them.
- `action="collect"` returns completed job results without waiting.
- `action="cancel"` requests cancellation for requested job IDs.
- Legacy action values `background` (start with `wait=false`) and `wait` (same as `await`) still resolve; prompts document only canonical `start`/`await`/`collect`/`cancel`.
- Recursive use of `parallel` from inside a direct background tool worker is blocked before execution; numbered subordinate child chats can use normal child-chat tools, including `parallel`, to create their next-level descendants.
- Wrapped `call_subordinate` uses the same lifecycle as a top-level call. `job_id` identifies one parallel invocation, while its returned `context_id` identifies the reusable child agent for later `reset=false` calls.
- The wrapper tool does not create its own visible process-step log; each wrapped child call owns the visible log row, and the wrapper result is recorded only in model history.