docs(sdk-python): Add connect() and SecurityConfig.from_env() documentation

[beonde]

Summary

Documents the new SDK features from PRs #29 (capiscio-sdk-python) and #27 (capiscio-server).

Changes

SDK Reference Index (docs/reference/sdk-python/index.md)

• Added CapiscIO.connect() card to API reference grid

Config Reference (docs/reference/sdk-python/config.md)

• Added SecurityConfig.from_env() section with environment variable table
• Documents: CAPISCIO_REQUIRE_SIGNATURES, CAPISCIO_FAIL_MODE, CAPISCIO_MIN_TRUST_LEVEL, CAPISCIO_RATE_LIMIT_RPM

Related PRs

• fix(connect): Create agent when name specified but not found capiscio-sdk-python#29 - SDK connect flow improvements
• capiscio/capiscio-server#27 - API key auth in UpdateAgent/GetAgent handlers

Documentation Additions

New Features Documented:

1. CapiscIO.connect(name="...") - Name-based agent lookup/creation
2. CapiscioMiddleware(config=SecurityConfig) - Middleware accepts config parameter
3. SecurityConfig.from_env() - Load configuration from environment variables

Environment Variables:

Variable	Description	Default
CAPISCIO_REQUIRE_SIGNATURES	Require badge on requests	true
CAPISCIO_FAIL_MODE	block, monitor, or log	block
CAPISCIO_MIN_TRUST_LEVEL	Minimum trust level (0-4)	0
CAPISCIO_RATE_LIMIT_RPM	Rate limit (requests/min)	1000

[github-actions]

✅ Documentation Build Successful

The documentation build completed successfully and passed validation checks.

• ✅ Build completed without errors
• ✅ Critical files present (index.html, sitemap.xml, robots.txt)
• ✅ Link validation completed

This PR will deploy to dev-docs.capisc.io when merged to main.

[Copilot]

Pull request overview

Adds Python SDK reference documentation for newly introduced connection flow and environment-based security configuration, aligning the docs site with recent SDK/server feature work.

Changes:

• Added a new API reference “card” for CapiscIO.connect() in the Python SDK reference index.
• Added a SecurityConfig.from_env() section describing supported environment variables and an example .env.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File	Description
docs/reference/sdk-python/index.md	Adds CapiscIO.connect() entry to the SDK reference landing grid.
docs/reference/sdk-python/config.md	Documents SecurityConfig.from_env() and environment variables in the SDK config reference.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

The "Connect API" link points to the in-page anchor #capiscioconnect, but this page doesn't define that anchor (no capiscioconnect heading/id elsewhere). This will render as a broken link; either add a corresponding section (e.g., a heading/mkdocstrings block for CapiscIO.connect) or link to an existing page that documents CapiscIO.connect() (and ensure the target exists).

[Copilot]

This environment variable table conflicts with the existing SecurityConfig.from_env() documentation in docs/reference/configuration.md (e.g., CAPISCIO_REQUIRE_SIGNATURES default is documented as false there, and CAPISCIO_RATE_LIMIT_RPM default as 60, not true/1000). Also, the description "Require badge on requests" appears mismatched for CAPISCIO_REQUIRE_SIGNATURES (it maps to signature enforcement in the other doc). Please align the defaults/wording with the canonical configuration reference (or update both consistently) to avoid publishing contradictory docs.

Suggested change

	| `CAPISCIO_REQUIRE_SIGNATURES` | Require badge on requests | `true` |
	| `CAPISCIO_FAIL_MODE` | `block`, `monitor`, or `log` | `block` |
	| `CAPISCIO_MIN_TRUST_LEVEL` | Minimum trust level (0-4) | `0` |
	| `CAPISCIO_RATE_LIMIT_RPM` | Rate limit (requests/min) | `1000` |
	**Example `.env` file:**
	```bash
	CAPISCIO_REQUIRE_SIGNATURES=true
	CAPISCIO_FAIL_MODE=block
	CAPISCIO_MIN_TRUST_LEVEL=0
	| `CAPISCIO_REQUIRE_SIGNATURES` | Require signatures on requests | `false` |
	| `CAPISCIO_FAIL_MODE` | `block`, `monitor`, or `log` | `block` |
	| `CAPISCIO_MIN_TRUST_LEVEL` | Minimum trust level (0-4) | `0` |
	| `CAPISCIO_RATE_LIMIT_RPM` | Rate limit (requests/min) | `60` |
	**Example `.env` file:**
	```bash
	CAPISCIO_REQUIRE_SIGNATURES=false
	CAPISCIO_FAIL_MODE=block
	CAPISCIO_MIN_TRUST_LEVEL=0
	CAPISCIO_RATE_LIMIT_RPM=60

[beonde]

Closing: SDK docs belong in capiscio-sdk-python/docs/ per project conventions. Documentation updates are in SDK PR #29.