Repository navigation
docs(j5): the agent tools after linked environments - #954
Merged
Merged
Conversation
Records the agent-tool rulings made for the v0.1.7 advance: J5 owns messaging, Peer Agents, peering, Crews and personas, and follows upstream for delegates, stopping and waiting. Peer Agents stay on j5_spawn_agent and can start on another J5 machine; j5_stop_agent retires for t3_thread_interrupt with a Captain rule; t3_thread_wait is admitted; t3_thread_launch is admitted for link sessions only. A delegate_task child is called a delegate (#952). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Jacksondr5
marked this pull request as ready for review
November 7, 2026 19:01
This was referenced Nov 7, 2026
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
J5's agent tools and upstream's overlap: both can spawn, stop, wait on and message agents. Upstream v0.1.7 adds linked environments, so the overlap now crosses machines too. Decision 3 of the v0.1.7 advance (J5-to-J5
delegate_task) couldn't be settled without first deciding where the line between J5's tools and upstream's sits. Jackson settled it on 2026-11-06 and 2026-11-07. This PR writes those rulings into the definitions, so the build follows them. Closes #952.What changed
Definitions only. They describe the end state; the code follows in later PRs.
delegate_taskchild is now called a delegate, and "Subagent" means only a provider's own subagent.delegate_taskis kept for what a provider's own subagent can't do. That settles Decide whether J5 agents keep delegate_task alongside spawn_agent, native Subagents and propose_crew #336.agent-tools.md,cross-device.md).j5_spawn_agent.environment_id, to start a Peer Agent on another J5 machine over a link. The spawner is passed along and recorded as outside agents are; the caller gets a participant id it can message at once.agent-tools.md).j5_stop_agentretires for upstream'st3_thread_interrupt, whosestop: trueis the full Stop. J5 keeps one rule on it: a Captain may stop its own seats whatever their access.t3_thread_waitandt3_thread_interruptare admitted.t3_thread_launchis admitted only for link sessions, so upstream's remote delegation works into a J5 machine. Threads it launches withdelegatedFromstay out of the ledger.t3_thread_sendstays hidden.j5_list_participantsrows carrythread_id.docs/j5/worklog/2026-11-07-agent-tool-boundary-session.mdhas the prior rulings, what was found, the rulings, and how each point from an adversarial review (GPT-6.1 Sol) was settled.Not changed on purpose:
agent-tools.md.tools.test.tspins them byte-for-byte to the shipped tool descriptions, so they change in the build PR together with the code.Overlap with open work:
agent-tools.mdaroundj5_spawn_agentanddelegate_task. Expect small conflicts in the input table and the kept-tools list.upstream.md. If this lands first, re-freeze the merge on top of it so it leaves D1, D2 and D42 alone.Checklist
agent-tools.md(tools.test.ts,EnvelopeFormatter.test.ts) pass.RemoteDelegation.ts).docs/j5/product/rewritten, plusdocs/j5/user/personas.mdfor the term.Drafted with Claude Opus 5.5 in J5 Code (Claude Code harness).
🤖 Generated with Claude Code