Merge remote-tracking branch 'origin/master' into worktree/provider-routed-llm-adapters

# Conflicts:
#	docs/config-catalog.md
#	docs/cordis-catalog/events.md
#	docs/cordis-catalog/services.md
#	docs/core-data-structures/core.md
#	docs/event-producer-consumer.md
#	docs/persistence-catalog.md
#	examples/acp-agent/tests/snapshots/advanced-toolchain/session.1.jsonl
#	examples/acp-agent/tests/snapshots/advanced-toolchain/session.2.jsonl
#	examples/acp-agent/tests/snapshots/advanced-toolchain/session.jsonl
#	examples/acp-agent/tests/snapshots/both-mode-turn/session.jsonl
#	examples/acp-agent/tests/snapshots/hook-cc-pretool-ask/session.jsonl
#	examples/acp-agent/tests/snapshots/skill-load/session.jsonl
#	examples/acp-agent/tests/snapshots/text-turn/session.jsonl
#	examples/sandbox-acp-agent/cordis.yml
#	examples/sandbox-acp-agent/tests/snapshots/escalation-approved/session.jsonl
#	examples/sandbox-acp-agent/tests/snapshots/escalation-rejected/session.jsonl
#	examples/sandbox-acp-agent/tests/snapshots/mode-switching/session.jsonl
#	packages/compact/compact-basic/README.md
#	packages/compact/compact-basic/src/index.ts
#	packages/compact/compact-basic/tests/compact-basic.spec.ts
#	packages/core/agent-loop/README.md
#	packages/core/agent-loop/src/loop.ts
#	packages/core/agent-loop/tests/properties.spec.ts
#	packages/core/session/README.md
#	packages/core/session/src/types.ts
#	packages/core/session/tests/derived-cache.spec.ts
#	packages/llm/llm-deepseek/src/index.ts
#	packages/llm/llm-pi-ai/README.md
#	packages/llm/llm-pi-ai/src/adapter.ts
#	packages/llm/llm-pi-ai/src/convert.ts
#	packages/llm/llm-pi-ai/tests/adapter.spec.ts
#	packages/llm/llm/README.md
#	packages/llm/llm/src/call-config.ts
#	packages/llm/llm/src/index.ts
#	packages/ui/acp-agent/src/index.ts
#	packages/ui/acp/tests/harness.ts
#	packages/ui/jsonrpc/README.md
#	packages/ui/jsonrpc/src/server.ts
#	packages/ui/stdio-agent/README.md
#	packages/ui/stdio-agent/src/index.ts
#	python/sdk/README.i18n.yaml

python/sdk-runtime/src/deepseek_harness_runtime/runtime/cordis.yml

@@ -1,46 +1,30 @@
-# Default runtime configuration for the bundled dsh-jsonrpc-agent. The runtime
-# binary has NO built-in fallback — it always requires an explicit config via
-# `$DSH_CORDIS_CONFIG` (wins) or an argv positional path. The Python client SDK
-# injects THIS file's path via `$DSH_CORDIS_CONFIG` when the caller supplies
-# no config and the launch resolves to the bundled runtime; that explicit
-# injection is what restores the zero-config experience. The runtime bin only
-# boots this config; the serving surface (the stdio JSON-RPC server) comes
-# from the @deepseek-ai/dsh-jsonrpc entry below.
-#
-# $DSH_SESSION_ROOT and $DSH_CWD are set by the SDK per launch; the `!!js`
-# fallbacks keep this file usable when the runtime is driven manually.
+# Bundled default config. The runtime still requires an explicit
+# $DSH_CORDIS_CONFIG or argv path; the SDK injects this path for bundled
+# zero-config launches. SDK-set session-root and cwd variables have manual-run fallbacks.
 
-# The serving surface: HarnessSdkServer + line-delimited JSON-RPC transport on
-# stdio. Without this entry the runtime boots an agent nobody can talk to.
+# Stdio JSON-RPC serving surface; without it the agent has no SDK client.
 - id: jsonrpc
   name: '@deepseek-ai/dsh-jsonrpc'
 
-# The agent spine bundle: session store, system prompt, tool registry, agent
-# registry, and the agent loop. No pre-created agents — the SDK server creates
-# one per session/prompt sessionId.
+# Agent spine; the SDK server creates agents per sessionId.
 - id: agent-core
   name: '@deepseek-ai/dsh-agent-core'
 
-# The DeepSeek adapter, preloaded for the stock models. The adapter fails loud
-# at load without an API key, so keyless boots must still export a dummy
-# DEEPSEEK_API_KEY (initialize/shutdown never call the model). baseURL falls
-# back to the public endpoint when unset.
+# Stock DeepSeek adapters. Loading requires an API key; initialize and shutdown
+# may use a dummy key because they do not call the model.
 - id: llm-deepseek
   name: '@deepseek-ai/dsh-llm-deepseek'
   config:
     apiKey: !!js process.env.DEEPSEEK_API_KEY
     baseURL: !!js process.env.DEEPSEEK_BASE_URL
 
-# JSONL session persistence. $DSH_SESSION_ROOT (set by the SDK whenever
-# `session_root` is configured) wins; otherwise ./.sessions relative to the
-# runtime process cwd.
+# JSONL persistence; $DSH_SESSION_ROOT wins over ./.sessions in the process cwd.
 - id: sessions
   name: '@deepseek-ai/dsh-session-persistence-jsonl'
   config:
     root: !!js process.env.DSH_SESSION_ROOT ?? './.sessions'
 
-# Local bash executor behind the spine's `bash` tool. $DSH_CWD (always set by
-# the SDK) wins; otherwise the runtime process cwd.
+# Local bash executor; $DSH_CWD wins over the process cwd.
 - id: bash
   name: '@deepseek-ai/dsh-bash-local'
   config: