examples: phase 0: skeleton, plan, requirements, ruff/pyright/pytest gates pass

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

Author: nficano

examples/.env.example

@@ -0,0 +1,45 @@
+# Environment variables recognized by examples/. None are required for the
+# default (scripted) run. Copy this file to `.env` and set what you need.
+
+# ---- LLM providers ------------------------------------------------------
+ARCP_EXAMPLES_ANTHROPIC_API_KEY=
+ARCP_EXAMPLES_OPENAI_API_KEY=
+ARCP_EXAMPLES_GEMINI_API_KEY=
+ARCP_EXAMPLES_ZHIPU_API_KEY=
+ARCP_EXAMPLES_DEEPSEEK_API_KEY=
+LITELLM_PROXY_URL=
+
+# ---- JWT signing (examples 3, 5, 6, 8) ----------------------------------
+# Either inline the PEM (escape newlines) or point to a file path.
+ARCP_EXAMPLES_JWT_PRIVATE_KEY=
+ARCP_EXAMPLES_JWT_PUBLIC_KEY=
+# Deterministic seed for golden tests; leave unset for ephemeral keys.
+ARCP_EXAMPLES_JWT_SEED=
+
+# ---- Destinations (example 3) -------------------------------------------
+NTFY_URL=https://ntfy.sh
+NTFY_TOPIC=
+TELEGRAM_BOT_TOKEN=
+TELEGRAM_CHAT_ID=
+SMTP_HOST=
+SMTP_PORT=587
+SMTP_USER=
+SMTP_PASS=
+EMAIL_TO=
+
+# ---- LDAP (example 6) ---------------------------------------------------
+OPENLDAP_URL=
+OPENLDAP_BIND_DN=
+OPENLDAP_BIND_PW=
+
+# ---- Observability (example 7) ------------------------------------------
+LANGFUSE_HOST=https://cloud.langfuse.com
+LANGFUSE_PUBLIC_KEY=
+LANGFUSE_SECRET_KEY=
+DD_API_KEY=
+DD_SITE=datadoghq.com
+OTEL_EXPORTER_OTLP_ENDPOINT=
+
+# ---- OpenClaw (example 8) -----------------------------------------------
+OPENCLAW_URL=
+AUTHENTIK_TOKEN=

examples/.ruff.toml

@@ -0,0 +1,58 @@
+# Mirrors the SDK's ruff configuration so `examples/` lints identically whether
+# invoked from the repository root via the SDK's `pyproject.toml` or standalone
+# inside this directory. Keep in sync with python-sdk/pyproject.toml [tool.ruff].
+
+line-length = 100
+target-version = "py313"
+src = ["."]
+
+[lint]
+select = [
+    "E", "W",
+    "F",
+    "I",
+    "N",
+    "UP",
+    "B",
+    "C4",
+    "SIM",
+    "RUF",
+    "PTH",
+    "PT",
+    "RET",
+    "TRY",
+    "ASYNC",
+    "ERA",
+    "ARG",
+    "SLF",
+    "TID",
+    "PERF",
+    "D",
+]
+ignore = [
+    "E501",
+    "TRY003",
+    "D107",
+    "D105",
+    "D203",
+    "D213",
+    # Examples are pedagogical scripts, not library code: a section-by-section
+    # narrative inside `main.py` is the documentation, so per-symbol docstrings
+    # add noise without adding clarity.
+    "D",
+    # Per the SDK config: tool handlers and inbound dispatchers have
+    # protocol-mandated signatures; unused-arg lints just create churn.
+    "ARG001",
+    "ARG002",
+]
+
+[lint.per-file-ignores]
+"*/tests/*" = ["B011", "ASYNC109", "SLF001"]
+"_shared/tests/*" = ["B011", "ASYNC109", "SLF001"]
+
+[lint.pydocstyle]
+convention = "google"
+
+[format]
+quote-style = "double"
+indent-style = "space"