Merge remote-tracking branch 'origin/master' into feat/tui-package

# Conflicts:
#	docs/architecture.md
#	docs/config-catalog.md
#	docs/cordis-catalog/events.md
#	docs/event-producer-consumer.md
#	docs/module-graph.md
#	examples/coding-agent/cordis.yml
#	examples/echo-agent/cordis.yml
#	knip.json
#	packages/core/agent-loop/README.md
#	packages/core/agent-loop/tests/config-session-id.spec.ts
#	packages/examples/README.md
#	packages/examples/stdio-demo/README.md
#	packages/examples/stdio-demo/tests/stdio-agent.spec.ts

examples/echo-agent/composition.md

@@ -16,6 +16,8 @@ flowchart LR
   cfg --> plugin_echo_echo_tool
   plugin_echo_bash["bash<br/>@deepseek-ai/dsh-bash-local"]
   cfg --> plugin_echo_bash
+  plugin_echo_fs_local["fs-local<br/>@deepseek-ai/dsh-fs-local"]
+  cfg --> plugin_echo_fs_local
   plugin_echo_stdio_agent["stdio-agent<br/>@deepseek-ai/dsh-stdio-demo"]
   cfg --> plugin_echo_stdio_agent
   plugin_echo_stdio_agent --> bundle_agent_core["@deepseek-ai/dsh-agent-spine-demo"]
@@ -33,6 +35,7 @@ flowchart LR
 | `mock-llm` | `./src/mock-llm.ts` |
 | `echo-tool` | `./src/echo-tool.ts` |
 | `bash` | `@deepseek-ai/dsh-bash-local` |
+| `fs-local` | `@deepseek-ai/dsh-fs-local` |
 | `stdio-agent` | `@deepseek-ai/dsh-stdio-demo` |
 
 Source config: [`examples/echo-agent/cordis.yml`](cordis.yml).

examples/echo-agent/cordis.yml

@@ -16,17 +16,28 @@
 - id: echo-tool
   name: './src/echo-tool.ts'
 
-# Local bash executor: agent-core ships the `tool-bash` consumer schema, so the
+# Local bash executor: agent-spine-demo ships the `tool-bash` consumer schema, so the
 # leaf provides the executor it runs on (the echo demo doesn't drive bash, but
 # the tool is part of the shared spine).
 - id: bash
   name: '@deepseek-ai/dsh-bash-local'
 
-# The app pre-creates `main` on the mock model and supplies persistence plus TTY-selected `dsh-tui`/`dsh-stdio` front doors.
+# Local filesystem provider for agent-spine-demo's workspace-context loader. This
+# does not expose model-facing read/write/edit tools in the echo demo.
+- id: fs-local
+  name: '@deepseek-ai/dsh-fs-local'
+  config:
+    cwd: !!js process.cwd()
+
+# The app pre-creates `main` on the mock model and supplies persistence plus
+# TTY-selected `dsh-tui`/`dsh-stdio` front doors; readline mode also owns logging.
 - id: stdio-agent
   name: '@deepseek-ai/dsh-stdio-demo'
   config:
+    provider: mock
     model: mock-echo
     persona: 'You are echo-agent, a demo agent.'
     welcome: 'echo-agent ready. Type a message ("echo <text>" triggers the tool).'
     persistenceRoot: './.sessions'
+    workspaceContext:
+      maxBytes: 65536

examples/echo-agent/src/mock-llm.ts

@@ -55,5 +55,5 @@ export const name = 'mock-llm'
 export const inject = ['llm']
 
 export function apply(ctx: Context) {
-  ctx.llm.registerAdapter(['mock-echo'], new MockEchoAdapter())
+  ctx.llm.registerAdapter(['mock'], new MockEchoAdapter())
 }

examples/echo-agent/tests/fixtures/context/time-context/cordis.yml

@@ -0,0 +1,19 @@
+# Test-only composition: keep time-context opt-in while exercising its real Loader/app path.
+- id: mock-llm
+  name: '../../../../src/mock-llm.ts'
+
+- id: bash
+  name: '@deepseek-ai/dsh-bash-local'
+
+- id: time-context
+  name: '@deepseek-ai/dsh-time-context'
+
+- id: stdio-agent
+  name: '@deepseek-ai/dsh-stdio-demo'
+  config:
+    provider: mock
+    model: mock-echo
+    persona: 'Test the time-context plugin.'
+    welcome: 'time-context e2e ready.'
+    persistenceRoot: './.sessions'
+    workspaceContext: false