From 8ada835396a021a7dce8f72d6b025dcd3a264c15 Mon Sep 17 00:00:00 2001
From: Tianyi Cui <53024+tianyicui@users.noreply.github.com>
Date: Tue, 14 Jul 2026 08:03:33 +0800
Subject: [PATCH] docs: remove links to private subagent helpers

---
 packages/subagent/subagent-subprocess/src/index.ts | 12 +++++-------
 packages/subagent/tool-subagent/src/index.ts       | 10 +++++-----
 2 files changed, 10 insertions(+), 12 deletions(-)

diff --git a/packages/subagent/subagent-subprocess/src/index.ts b/packages/subagent/subagent-subprocess/src/index.ts
index 2ee2745985..bd792e7f23 100644
--- a/packages/subagent/subagent-subprocess/src/index.ts
+++ b/packages/subagent/subagent-subprocess/src/index.ts
@@ -2,11 +2,10 @@
  * Shared machinery for OUT-OF-PROCESS subagent backends — providers that spawn
  * an external agent as a child process and must keep the parent deployment's
  * credentials out of it, tear it down to quiescence, and isolate it from the
- * host user's on-disk CLI state. The pieces: the credential env scrub
- * ({@link SENSITIVE_ENV_PATTERN} / {@link buildChildEnv}), the spawn-failure
- * capture ({@link spawnFailure}), the child-exit waits ({@link waitForExit} /
- * {@link exitsWithin}), the stdin-EOF → SIGTERM → SIGKILL dispose ladder
- * ({@link disposeChildProcess}), and the per-run isolated config dir
+ * host user's on-disk CLI state. The pieces: credential-shaped env scrubbing
+ * ({@link buildChildEnv}), spawn-failure capture ({@link spawnFailure}),
+ * bounded child-exit waits inside the stdin-EOF → SIGTERM → SIGKILL dispose
+ * ladder ({@link disposeChildProcess}), and the per-run isolated config dir
  * ({@link createIsolatedConfigDir}).
  *
  * This package owns no provider and registers nothing; it is a pure library
@@ -37,8 +36,7 @@ const SENSITIVE_ENV_PATTERN = /KEY|SECRET|TOKEN/i
 /**
  * The ambient env minus credential-shaped vars, plus the caller's explicit
  * env. `PATH`, `HOME`, `TMPDIR`, locale, and proxy vars survive the scrub, so
- * a child CLI runs normally; only {@link SENSITIVE_ENV_PATTERN}-shaped names
- * are dropped.
+ * a child CLI runs normally; only credential-shaped names are dropped.
  * @param extra - explicit vars layered on top AFTER the scrub, so a
  * credential-shaped name supplied deliberately still reaches the child.
  * @returns the environment to spawn the child with.
diff --git a/packages/subagent/tool-subagent/src/index.ts b/packages/subagent/tool-subagent/src/index.ts
index 426753dbb9..ff54bc109a 100644
--- a/packages/subagent/tool-subagent/src/index.ts
+++ b/packages/subagent/tool-subagent/src/index.ts
@@ -12,11 +12,11 @@
  * sees only `{ description, prompt }`.
  *
  * The tool DESCRIPTION is derived from the bound provider's conversation-history
- * descriptor ({@link providerWording}): a fresh-conversation provider (spawn,
- * ACP) gets the standalone-prompt wording, while a seeded-conversation provider
- * (fork) tells the model the child already sees the conversation's completed
- * turns. This descriptor says nothing about Cordis scope, services, tools, or
- * authority. The tool MIRRORS the
+ * descriptor ({@link SubagentProvider.inheritsParentContext}): a
+ * fresh-conversation provider (spawn, ACP) gets the standalone-prompt wording,
+ * while a seeded-conversation provider (fork) tells the model the child already
+ * sees the conversation's completed turns. This descriptor says nothing about
+ * Cordis scope, services, tools, or authority. The tool MIRRORS the
  * provider's lifecycle via `subagent/provider-added`/`-removed` — it registers
  * when the provider is (or becomes) available and unregisters when the
  * provider goes away — so no load-order requirement exists and an HMR reload