docs(sdk): add minimal Python example

examples/jsonrpc-agent/minimal.py

@@ -0,0 +1,42 @@
+#!/usr/bin/env python3
+"""Run one minimal-agent turn through the bundled Python SDK runtime."""
+
+from __future__ import annotations
+
+import argparse
+from pathlib import Path
+
+from deepseek_harness import DeepSeekHarness
+
+
+CONFIG = Path(__file__).with_name("minimal.cordis.yml")
+
+
+def main() -> None:
+    """Parse one task and print the agent's final response."""
+    parser = argparse.ArgumentParser()
+    parser.add_argument("prompt", help="Task for the minimal agent")
+    parser.add_argument("--workspace", type=Path, default=Path.cwd())
+    parser.add_argument("--session-root", type=Path, default=Path(".dsh-sessions"))
+    parser.add_argument("--session-id")
+    parser.add_argument("--provider", default="deepseek-official")
+    parser.add_argument("--model", default="deepseek-v4-flash")
+    parser.add_argument("--max-tokens", type=int)
+    args = parser.parse_args()
+
+    workspace = args.workspace.resolve()
+    session_root = args.session_root.resolve()
+    with DeepSeekHarness(
+        provider=args.provider,
+        model=args.model,
+        max_tokens=args.max_tokens,
+        cwd=str(workspace),
+        session_root=str(session_root),
+        cordis=str(CONFIG.resolve()),
+    ) as harness:
+        result = harness.run(args.prompt, session_id=args.session_id)
+    print(result.final_response)
+
+
+if __name__ == "__main__":
+    main()