docs: deprecate request options the API ignores

Author: vvillait88

README.md

@@ -58,11 +58,8 @@ status = client.poll_session(session["session_id"], session["poll_secret"])
 if status["status"] == "verified":
     print(status["operator_token"])  # "opc_...", use for future requests
 
-# Optional pre-association: attach the session to a known wallet or refresh KYC
-# for an existing operator credential.
-client.create_session(address="0x...")
-client.create_session(operator_token="opc_...")  # KYC refresh
-client.create_session(kind="sign_in")  # registration-only: account sign-in, no identity documents
+# Registration-only session: the buyer signs in with an AgentScore account, no identity documents.
+client.create_session(kind="sign_in")
 ```
 
 ### Wallet resolution

agentscore/client.py

@@ -257,7 +257,9 @@ def assess(
         aip_token: str | None = None,
         aip_signature: AipSignatureMaterial | None = None,
     ) -> AssessResponse:
-        """Assess a wallet or operator (paid, writes score on-the-fly).
+        """Assess a wallet or operator against a compliance policy.
+
+        ``refresh`` is deprecated: the API ignores it, and every assess is evaluated live.
 
         ``signer`` opts into server-side wallet-signer-match: when supplied,
         the API resolves the signer wallet against the claimed ``address`` and emits
@@ -303,9 +305,8 @@ def create_session(
     ) -> SessionCreateResponse:
         """Create a verification or sign-in session.
 
-        ``address`` pre-associates the session with a known wallet (EVM ``0x...`` or
-        Solana base58). ``operator_token`` pre-associates with an existing ``opc_...``:
-        e.g. refresh KYC for a credential. ``kind`` selects the session kind: ``"kyc"``
+        ``address`` and ``operator_token`` are deprecated: the API ignores them, so a
+        session is never pre-associated with a wallet or credential. ``kind`` selects the session kind: ``"kyc"``
         (the API 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, for merchants that key durable state on the account
@@ -406,7 +407,9 @@ async def aassess(
         aip_token: str | None = None,
         aip_signature: AipSignatureMaterial | None = None,
     ) -> AssessResponse:
-        """Assess a wallet or operator (paid, writes score on-the-fly).
+        """Assess a wallet or operator against a compliance policy.
+
+        ``refresh`` is deprecated: the API ignores it, and every assess is evaluated live.
 
         ``signer`` opts into server-side wallet-signer-match; ``aip_token`` (+ ``aip_signature``)
         supplies an AIP Agent Identity Token. Async mirror of :meth:`assess`.
@@ -445,9 +448,8 @@ async def acreate_session(
     ) -> SessionCreateResponse:
         """Create a verification or sign-in session.
 
-        ``address`` pre-associates the session with a known wallet (EVM ``0x...`` or
-        Solana base58). ``operator_token`` pre-associates with an existing ``opc_...``:
-        e.g. refresh KYC for a credential. ``kind`` selects the session kind: ``"kyc"``
+        ``address`` and ``operator_token`` are deprecated: the API ignores them, so a
+        session is never pre-associated with a wallet or credential. ``kind`` selects the session kind: ``"kyc"``
         (the API 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, for merchants that key durable state on the account