Add the session kind option to create_session

[vvillait88]

Summary

create_session and acreate_session gain an optional kind ("kyc" | "sign_in"). The API already accepts it on POST /v1/sessions: kyc (its default) runs identity verification, sign_in is registration-only (the buyer signs in with an AgentScore account, no identity documents) and mints a sign_in-scoped credential. Merchants that key durable state on the buyer's account without any compliance policy, such as a prepaid metered store, could not mint that kind through the SDK, so their identity bootstrap either did not exist or forced a KYC flow the merchant does not need. SessionCreateResponse also gains the optional kind the API echoes back. When kind is None the body omits it, so the API default is unchanged for every existing caller. Parity with the node SDK change of the same day.

Type of change

• Bug fix (no breaking change)
• New feature (no breaking change)
• Breaking change (existing callers must update)
• Docs, tests, or internal maintenance only

Public API

create_session(..., kind: Literal["kyc", "sign_in"] | None = None) and the same on acreate_session (new, optional, keyword). SessionCreateResponse.kind (new, optional). No migration.

Test plan

tests/test_client.py: the first-class-fields test now passes kind="sign_in" and asserts it lands in the body; the omit-none test asserts kind is absent when not passed. Locally: uv run ruff check, uv run ruff format --check, uv run ty check agentscore/, uv run pytest (183 passed, 8 skipped, 99.85% coverage against the 95% floor).

Checklist

• Tests cover the new behavior, and the suite passes locally
• Lint, format, and type checks pass
• Docs and README examples updated if the public surface changed
• No secrets, credentials, or personal data in the diff or the tests

Worked with Varun. Version bumped to 2.6.9; the tag follows the merge.

🤖 Generated with Claude Code