Clarify ACP workspace resolution

docs/core-data-structures/subagent.i18n.yaml

@@ -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
-subagent.md: b5e041dc54d43dcf3609885cfd3dc2c93fa09f25
-subagent.zh.md: 22fb3cd32bded30beff00a79ed4920ebacdd691a
+subagent.md: 8a134b7be641323057135bcf772bf4cccec5c9a3
+subagent.zh.md: a66ad6b6c3b503b81fac97387577a689848edad2

docs/core-data-structures/subagent.md

@@ -46,7 +46,8 @@ interface SubagentStartRequest {
   readonly prompt: ContentBlock[]
   /**
    * The spawning agent. In-process providers derive workspace, lineage, and
-   * delegation depth from its durable session state; ACP uses only its cwd.
+   * delegation depth from its durable session state. ACP reads only its cwd,
+   * and only when no deployment `cwd` override is configured.
    */
   readonly parent: Agent
   /**

docs/core-data-structures/subagent.zh.md

@@ -46,7 +46,8 @@ interface SubagentStartRequest {
   readonly prompt: ContentBlock[]
   /**
    * The spawning agent. In-process providers derive workspace, lineage, and
-   * delegation depth from its durable session state; ACP uses only its cwd.
+   * delegation depth from its durable session state. ACP reads only its cwd,
+   * and only when no deployment `cwd` override is configured.
    */
   readonly parent: Agent
   /**

packages/subagent/subagent/src/types.ts

@@ -49,7 +49,8 @@ export interface SubagentStartRequest {
   readonly prompt: ContentBlock[]
   /**
    * The spawning agent. In-process providers derive workspace, lineage, and
-   * delegation depth from its durable session state; ACP uses only its cwd.
+   * delegation depth from its durable session state. ACP reads only its cwd,
+   * and only when no deployment `cwd` override is configured.
    */
   readonly parent: Agent
   /**