SEP-1686: Tasks (#1645)

examples/servers/simple-task-interactive/README.md

@@ -0,0 +1,74 @@
+# Simple Interactive Task Server
+
+A minimal MCP server demonstrating interactive tasks with elicitation and sampling.
+
+## Running
+
+```bash
+cd examples/servers/simple-task-interactive
+uv run mcp-simple-task-interactive
+```
+
+The server starts on `http://localhost:8000/mcp` by default. Use `--port` to change.
+
+## What it does
+
+This server exposes two tools:
+
+### `confirm_delete` (demonstrates elicitation)
+
+Asks the user for confirmation before "deleting" a file.
+
+- Uses `task.elicit()` to request user input
+- Shows the elicitation flow: task -> input_required -> response -> complete
+
+### `write_haiku` (demonstrates sampling)
+
+Asks the LLM to write a haiku about a topic.
+
+- Uses `task.create_message()` to request LLM completion
+- Shows the sampling flow: task -> input_required -> response -> complete
+
+## Usage with the client
+
+In one terminal, start the server:
+
+```bash
+cd examples/servers/simple-task-interactive
+uv run mcp-simple-task-interactive
+```
+
+In another terminal, run the interactive client:
+
+```bash
+cd examples/clients/simple-task-interactive-client
+uv run mcp-simple-task-interactive-client
+```
+
+## Expected server output
+
+When a client connects and calls the tools, you'll see:
+
+```text
+Starting server on http://localhost:8000/mcp
+
+[Server] confirm_delete called for 'important.txt'
+[Server] Task created: <task-id>
+[Server] Sending elicitation request to client...
+[Server] Received elicitation response: action=accept, content={'confirm': True}
+[Server] Completing task with result: Deleted 'important.txt'
+
+[Server] write_haiku called for topic 'autumn leaves'
+[Server] Task created: <task-id>
+[Server] Sending sampling request to client...
+[Server] Received sampling response: Cherry blossoms fall
+Softly on the quiet pon...
+[Server] Completing task with haiku
+```
+
+## Key concepts
+
+1. **ServerTaskContext**: Provides `elicit()` and `create_message()` for user interaction
+2. **run_task()**: Spawns background work, auto-completes/fails, returns immediately
+3. **TaskResultHandler**: Delivers queued messages and routes responses
+4. **Response routing**: Responses are routed back to waiting resolvers