fix(agent): commit mutable setup at publication

Agent setup may await while a mutable contribution registry changes. The previous subagent path validated and committed its provisioning batch inside the setup callback. A revocation queued after that callback returned therefore treated the installation as resident and released it, even though AgentLoop had not published the child yet. AgentLoop could then admit and announce a child whose required capability had already disappeared.

Introduce AgentSetupCommit as the optional synchronous result of create and resume setup. AgentLoop now awaits setup, invokes that commit with no intervening asynchronous boundary, and only then enters the Session and Agent registries. A commit failure follows the existing private-transaction rollback, so neither identity is published and the caller can reuse the id.

Keep continuable-subagent installations provisional until this publication commit. Contribution removal still releases every installation immediately, but now marks an unpublished batch invalid so its commit rejects with ACTIVATION_SETUP_REVOKED. Once the commit succeeds, later removal remains ordinary live revocation.

Cover create and resume ordering, resume commit rejection and identity reuse, and an assembled microtask revocation that leaves only the parent Agent and Session. Update the public JSDoc, architecture flow, package contracts, current Agent Notes, Chinese counterparts, pairing records, and generated Cordis API to describe the new boundary.

Validated with the four focused Agent/subagent test files (91 tests), the isolated assembled regression, targeted TypeScript project builds, generated Cordis API freshness, export JSDoc verification, scoped translation pairing, Markdown wrapping, and Mermaid parsing.

This commit is contained in:

Tianyi Cui

2026-08-02 20:09:05 +08:00

parent dbe053fe08

commit b54381f3e7

28 changed files with 198 additions and 106 deletions

									
										packages/subagent/tool-subagent-report/README.i18n.yaml
									
		+2
		-2
	
												View File
												
				@@ -2,5 +2,5 @@

				# side as of the last confirmed-consistent state. Both languages carry equal authority;

				# after editing either side, bring the other along and re-record with:

				#   pnpm run verify-translation-pairing --write packages/subagent/tool-subagent-report/README.md

				README.md: c1cff4d023e35ff246e592f58b0c85c8a10f327a

				README.zh.md: 167a6338e8db9fbb5efce7037392f7c75e48f116

				README.md: cd73154dfb9c8b37f4a811c3beedbe6a63207f58

				README.zh.md: 4b31bed48ea0e50ec3a9d507548658defb94b8b8