openclaw/docs/tools
Josh Lehman a9f675839a
feat(memory): resolve the memory audience in the host (#162176)
* feat(memory): resolve the memory audience in the host

Memory providers had to re-derive whether a caller acts for the agent
owner privately or for one conversation, walking spawn lineage through
session lookups.

When the memory slot owner registers providerRuntime, the host mints a
MemoryAudience (owner-private, or one exact conversation) from the
admitted turn entry and, for spawned children, the exact parent key,
session ID, lifecycle revision (or its recorded absence), and captured
owner bit of every hop. Memory Core and other legacy owners resolve no
audience: their turns take no session leases, read no lineage, and log
nothing new. Native, ACP, and realtime voice consult children record the trusted
spawning sender's owner status and parent incarnation so that lineage
survives session creation, reset, and rollover. The receipt stores the
parent session id as spawnedBySessionId, so navigation's parentSessionId
and sessions.list stay unchanged; a child of a parent without a lifecycle revision,
such as a channel-created group row, records that absence. Incomplete or
stale lineage yields no audience; only a spawned row without the owner
receipt predates the lineage receipts, and it logs a respawn
instruction. A parent without a stored row spawns as before. Spawn rechecks
a stored parent on the session read worker immediately before the child
commits. Parent rows are read on the session read worker, and every captured hop holds
a session generation lease, so currency checks stay synchronous and
read-free. Audiences are bound to their session, released when the
owning attempt or run ends, and delegated to same-agent children bound
to the child's current incarnation. The host checks currency before and
after opening a provider and around every provider call, and the guard
it passes to a provider includes audience currency. The memory slot
owner's own tools, Active Memory, and project recall also recheck it
before their effects; other plugin tools reach memory only through the
provider guard and do not fail on a stale audience.

Session authority, plugin tool contexts, hook contexts, and Codex
dynamic tools carry the audience. Native consumers cut over to it:
Active Memory trigger, deep, and summary recall (caches keyed by
audience; default deep-recall tools from the slot owner's
recallToolNames; trigger recall runs only while tool policy allows every
recall tool the provider declares), project recall, Memory Wiki,
post-compaction provider refresh, doctor memory status and recall/search
checks, and the status scan, which report provider health instead of
legacy index counters. Legacy owners keep their trigger-recall gate,
doctor and status ordering, and post-compaction sync without loading or
calling the slot plugin to decide.

* test(memory): consolidate memory audience tests

Fold the real session-owner audience test into the shared real-lineage
fixture, drop the spawn lineage unit test that the real-SQLite spawn tests
already cover, share spawn parameters, and remove cases that only mirrored
implementation (log text, mock passthrough, per-kind passthrough).

* test(talk): expect lineage receipts on consult children
2026-10-02 15:19:58 -07:00
..
acp-agents fix: act for the person who asked when several people steer a turn (#160525) 2026-09-28 22:16:34 -07:00
browser refactor(doctor): drop pre-July-2026 config migrations 2026-10-02 00:45:32 +00:00
code-mode feat: retain required results without model polling (#162707) 2026-10-01 09:58:49 -04:00
skill-workshop fix(doctor): stop repeated warnings for archived Workshop backups (#161586) 2026-09-30 10:42:40 -07:00
subagents feat(memory): resolve the memory audience in the host (#162176) 2026-10-02 15:19:58 -07:00
tts test(config): author canonical agent rosters in fixtures and docs examples (#163475) 2026-10-02 04:42:31 -07:00
acp-agents-setup.md
acp-agents.md refactor: remove Tasks and TaskFlow runtime (#159179) 2026-09-27 10:40:29 -07:00
agent-send.md
apply-patch.md
ask-user.md
brave-search.md
browser-control.md
browser-linux-troubleshooting.md
browser-login.md
browser-wsl2-windows-remote-cdp-troubleshooting.md
browser.md
btw.md
chrome-extension.md fix(browser): keep tabs usable while Chrome Web Store is open (#156890) 2026-09-26 12:29:43 +05:30
code-execution.md
code-mode.md
creating-skills.md
custodian-skills.md
diffs.md
duckduckgo-search.md
elevated.md
exa-search.md
exec-approvals-advanced.md fix(exec): only name approval surfaces that can answer exec approvals (#159266) 2026-09-26 17:50:25 -07:00
exec-approvals.md
exec.md fix(agents): bound the shell snapshot cache (#162967) 2026-10-01 14:08:02 -07:00
firecrawl.md docs(firecrawl): link the Firecrawl site and where to get an API key (#157257) 2026-09-30 16:54:55 -07:00
gemini-search.md
goal.md perf(sessions): reuse registry relations across list reads (#160198) 2026-09-28 19:57:41 +00:00
grok-search.md
image-generation.md fix(agents): generated images in shared-main chats run in the background again (#161005) 2026-09-29 00:40:31 -07:00
index.md fix: act for the person who asked when several people steer a turn (#160525) 2026-09-28 22:16:34 -07:00
kimi-search.md
llm-task.md Support isolated sessions in the AgentsAPI and enable restricted dreaming sessions (#159246) 2026-09-26 18:27:06 -07:00
lobster.md test(config): author canonical agent rosters in fixtures and docs examples (#163475) 2026-10-02 04:42:31 -07:00
loop-detection.md test(config): author canonical agent rosters in fixtures and docs examples (#163475) 2026-10-02 04:42:31 -07:00
mcp.md feat: use MCP plugin apps across conversations and workspace files (#161747) 2026-10-02 07:02:35 -05:00
media-overview.md fix(media): view_image rejects Gateway screenshots in workspace-only sessions (#162285) 2026-10-01 02:32:00 -07:00
minimax-search.md
multi-agent-sandbox-tools.md test(config): author canonical agent rosters in fixtures and docs examples (#163475) 2026-10-02 04:42:31 -07:00
music-generation.md fix(agents): generated images in shared-main chats run in the background again (#161005) 2026-09-29 00:40:31 -07:00
ollama-search.md
parallel-search.md
pdf.md fix: PDF analysis uses the active vision model (#159593) 2026-09-28 03:17:57 +05:30
permission-modes.md
perplexity-search.md
plugin.md refactor: retire the TaskFlow Webhooks plugin (#158225) 2026-09-25 20:29:15 -07:00
progress-card.md fix(ui): hide progress card locally while retaining shared clear (#160871) 2026-10-02 19:39:03 +00:00
reactions.md feat: react to prompts and replies with emoji in shared sessions (#161053) 2026-09-30 09:12:24 +00:00
screen.md fix: let people with the same permissions steer each other's turns (#159850) 2026-09-28 13:52:08 +00:00
searxng-search.md
secrets.md
self-learning.md
show-widget.md fix: keep video widgets scrollable and preload initial frames (#163762) 2026-10-02 13:34:41 -07:00
skill-workshop.md
skills-config.md test(config): author canonical agent rosters in fixtures and docs examples (#163475) 2026-10-02 04:42:31 -07:00
skills.md fix(watch): complete cache migration and ignore unchanged invalidations (#161543) 2026-10-02 09:14:04 -07:00
slash-commands.md feat(codex): request Ultrafast by default when the catalog advertises it (#163320) 2026-10-02 06:53:00 +00:00
steer.md docs: explain that /acp steer runs after the in-flight ACP turn (#154372) 2026-09-26 17:41:34 -07:00
subagents.md fix: hide subagent scaffolding and redundant title prefixes (#163745) 2026-10-02 14:59:16 -07:00
swarm.md test(config): author canonical agent rosters in fixtures and docs examples (#163475) 2026-10-02 04:42:31 -07:00
tavily.md
theme.md fix: let people with the same permissions steer each other's turns (#159850) 2026-09-28 13:52:08 +00:00
thinking.md feat(models): detect Ultrafast on API-key OpenAI routes without a catalog (#163663) 2026-10-02 18:25:43 +00:00
tokenjuice.md
tool-search.md fix: guide direct-only tool calls out of catalog recovery loops (#161055) 2026-09-29 15:49:21 +08:00
trajectory.md
tts.md docs: correct ElevenLabs TTS model configuration key (#161917) 2026-09-30 22:42:58 +08:00
video-generation.md fix(agents): generated images in shared-main chats run in the background again (#161005) 2026-09-29 00:40:31 -07:00
web-fetch.md
web.md