docs(sdk): document confirmation_inheritance in Node and Python SDK READMEs

Adds documentation for the new confirmation_inheritance field in both
Node and Python SDK READMEs, explaining the three modes:
- auto_approve (default): child runs auto-approve all Ask decisions
- deny_on_ask: child runs fail immediately on Ask
- inherit_parent: child runs inherit parent's confirmation policy

Includes code examples showing how to configure worker agents with
different confirmation inheritance modes for both SDKs.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: claude

sdk/node/README.md

@@ -135,6 +135,7 @@ const session = agent.session('/my-project', {
       model: 'openai/gpt-4o',
       maxSteps: 24,
       prompt: 'Keep patches focused and run the narrowest relevant check.',
+      confirmationInheritance: 'auto_approve',  // child runs auto-approve Ask decisions
     },
     { name: 'review-cow', description: 'Adversarial review', kind: 'reviewer' },
   ],
@@ -159,6 +160,27 @@ session.registerWorkerAgent({
 
 For a worker as the top-level actor, use `agent.sessionForWorker(workspace, spec)`.
 
+### Confirmation Inheritance
+
+Control how child runs resolve Ask decisions with `confirmationInheritance`:
+
+- `'auto_approve'` (default): Child runs auto-approve all Ask decisions
+- `'deny_on_ask'`: Child runs fail immediately when encountering an Ask
+- `'inherit_parent'`: Child runs inherit the parent's confirmation policy
+
+```js
+const session = agent.session('/my-project', {
+  workerAgents: [
+    {
+      name: 'restricted-writer',
+      description: 'Write files with parent confirmation',
+      kind: 'implementer',
+      confirmationInheritance: 'inherit_parent',  // requires parent approval
+    },
+  ],
+})
+```
+
 ## AHP-Supervised Advice
 
 Background advice belongs in the host or AHP harness. A3S Code forwards hooks,

sdk/python/README.md

@@ -135,6 +135,7 @@ frontend = WorkerAgentSpec.implementer("frontend-cow", "Small verified frontend
 frontend.model = "openai/gpt-4o"
 frontend.max_steps = 24
 frontend.prompt = "Keep patches focused and run the narrowest relevant check."
+frontend.confirmation_inheritance = "auto_approve"  # child runs auto-approve Ask decisions
 opts.add_worker_agent(frontend)
 session = agent.session("/my-project", opts)
 session.task({
@@ -143,6 +144,14 @@ session.task({
     "prompt": "Find and fix the loading-state regression, then summarize verification.",
 })
 
+# Confirmation inheritance controls how child runs resolve Ask decisions:
+# - "auto_approve" (default): Child runs auto-approve all Ask decisions
+# - "deny_on_ask": Child runs fail immediately when encountering an Ask
+# - "inherit_parent": Child runs inherit the parent's confirmation policy
+restricted = WorkerAgentSpec("restricted-writer", "Write files with parent confirmation", "implementer")
+restricted.confirmation_inheritance = "inherit_parent"  # requires parent approval
+opts.add_worker_agent(restricted)
+
 # Object-shaped direct tools
 session.git({"command": "status"})
 session.git({"command": "worktree", "subcommand": "list"})