Просмотр исходного кода

docs: remove links to private subagent helpers

Tianyi Cui 3 месяцев назад
Родитель
Сommit
8ada835396

+ 5 - 7
packages/subagent/subagent-subprocess/src/index.ts

@@ -2,11 +2,10 @@
  * Shared machinery for OUT-OF-PROCESS subagent backends — providers that spawn
  * 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
  * 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
  * 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}).
  * ({@link createIsolatedConfigDir}).
  *
  *
  * This package owns no provider and registers nothing; it is a pure library
  * 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
  * The ambient env minus credential-shaped vars, plus the caller's explicit
  * env. `PATH`, `HOME`, `TMPDIR`, locale, and proxy vars survive the scrub, so
  * 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
  * @param extra - explicit vars layered on top AFTER the scrub, so a
  * credential-shaped name supplied deliberately still reaches the child.
  * credential-shaped name supplied deliberately still reaches the child.
  * @returns the environment to spawn the child with.
  * @returns the environment to spawn the child with.

+ 5 - 5
packages/subagent/tool-subagent/src/index.ts

@@ -12,11 +12,11 @@
  * sees only `{ description, prompt }`.
  * sees only `{ description, prompt }`.
  *
  *
  * The tool DESCRIPTION is derived from the bound provider's conversation-history
  * 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
  * provider's lifecycle via `subagent/provider-added`/`-removed` — it registers
  * when the provider is (or becomes) available and unregisters when the
  * when the provider is (or becomes) available and unregisters when the
  * provider goes away — so no load-order requirement exists and an HMR reload
  * provider goes away — so no load-order requirement exists and an HMR reload