feat: add authorization_params to TokenVaultInterrupt (#55)

chore: document authorization_params

fix Google in LangChain

prevent automatic format of html

switch to llamaindex example to openai

fix llamaindex example

update langchain example

revisit langchain examples

update connect apis examples to use latest version of auth0-fastapi

improve examples by redirecting to correct url

fix: tweaked some tenant setup instructions

fix: add missing `openid` for all usage of `google-oauth2`

fix: add missing `openid` for all usage of `google-oauth2`

feat: bump @auth0/ai-components to v4.x.x

fix: review feedback

Author: pmalouin

.vscode/launch.json

@@ -0,0 +1,44 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Python: Start LangChain Examples",
+            "type": "debugpy",
+            "request": "launch",
+            "program": "${workspaceFolder}/examples/calling-apis/langchain-examples/scripts/start_debug.py",
+            "cwd": "${workspaceFolder}/examples/calling-apis/langchain-examples",
+            "justMyCode": false,
+            "console": "integratedTerminal",
+            "env": {
+                "PYTHONPATH": "${workspaceFolder}/examples/calling-apis/langchain-examples/src"
+            },
+            "python": "${workspaceFolder}/examples/calling-apis/langchain-examples/.venv/bin/python"
+        },
+        {
+            "name": "Python: LangGraph Up",
+            "type": "debugpy",
+            "request": "launch",
+            "program": "${workspaceFolder}/examples/calling-apis/langchain-examples/scripts/langgraph_up.py",
+            "cwd": "${workspaceFolder}/examples/calling-apis/langchain-examples",
+            "justMyCode": false,
+            "console": "integratedTerminal",
+            "env": {
+                "PYTHONPATH": "${workspaceFolder}/examples/calling-apis/langchain-examples/src"
+            },
+            "python": "${workspaceFolder}/examples/calling-apis/langchain-examples/.venv/bin/python"
+        },
+        {
+            "name": "Python: Start LlamaIndex Examples",
+            "type": "debugpy",
+            "request": "launch",
+            "program": "${workspaceFolder}/examples/calling-apis/llama-index-examples/scripts/start_debug.py",
+            "cwd": "${workspaceFolder}/examples/calling-apis/llama-index-examples",
+            "justMyCode": false,
+            "console": "integratedTerminal",
+            "env": {
+                "PYTHONPATH": "${workspaceFolder}/examples/calling-apis/llama-index-examples/src"
+            },
+            "python": "${workspaceFolder}/examples/calling-apis/llama-index-examples/.venv/bin/python"
+        }
+    ]
+}

.vscode/settings.json

@@ -1,6 +1,15 @@
 {
   "poetryMonorepo.appendExtraPaths": true,
   "python.analysis.extraPaths": [
+    "examples/calling-apis/langchain-examples/scripts",
+    "examples/calling-apis/llama-index-examples/src",
+    "examples/calling-apis/langchain-examples/src",
+    "packages/auth0-ai/auth0_ai",
+    "examples/calling-apis/llama-index-examples/.venv",
+    "packages/auth0-ai-llamaindex/auth0_ai_llamaindex",
+    "examples/calling-apis/llama-index-examples/scripts",
+    "packages/auth0-ai-langchain/auth0_ai_langchain",
+    "examples/calling-apis/langchain-examples/.venv",
     "examples/async-authorization/langchain-examples",
     "examples/async-authorization/llama-index-examples",
     "examples/async-authorization/sample-api",
@@ -27,5 +36,8 @@
       "source.fixAll": "always"
     },
     "editor.defaultFormatter": "ms-python.autopep8"
+  },
+  "[html]": {
+    "editor.formatOnSave": false
   }
 }

examples/calling-apis/langchain-examples/README.md

@@ -13,20 +13,25 @@
     - **Allowed Callback URLs**: `http://localhost:3000/auth/callback`
     - **Allowed Logout URLs**: `http://localhost:3000`
     - **Advanced Settings -> Grant Types**: `Refresh Token` and `Token Vault` (or `urn:auth0:params:oauth:grant-type:token-exchange:federated-connection-access-token`)
+    - **Allow Refresh Token Rotation**: currently you should disable this setting if you are using Token Vault for token exchanges with a refresh token.
   - Either **Google**, **Slack** or **Github** social connections enabled for the application:
     - **Google connection** set up instructions:
       - Create a [Google OAuth 2.0 Client](https://console.cloud.google.com/apis/credentials) configured with access to the `https://www.googleapis.com/auth/calendar.freebusy` scope (Google Calendar API).
       - On Auth0 Dashboard, set up the client ID and secret from the previously created Google client.
       - Enable following settings:
+        - **Use for Connected Accounts with Token Vault** enabled.
         - **Offline access** enabled.
         - **https://www.googleapis.com/auth/calendar.freebusy** scope granted.
-        - **Token Vault** enabled.
     - **Slack connection** set up instructions:
       - Create a [Slack App](https://api.slack.com/apps) and follow the [Auth0's Signin with Slack](https://marketplace.auth0.com/integrations/sign-in-with-slack) `installation` instructions to set up the connection.
-      - On Slack's OAuth & Permission settings, make sure to add the `channels:read` scope to the User Token scopes.
+      - Enable following settings:
+        - **Use for Connected Accounts with Token Vault** enabled.
+        - On Slack's OAuth & Permission settings, make sure to add the `channels:read` scope to the User Token scopes.
     - **Github connection** set up instructions:
       - Register a new app in [GitHub Developer Settings: OAuth Apps](https://github.com/settings/developers#oauth-apps) and follow the [Auth0's Github social connection](https://marketplace.auth0.com/integrations/github-social-connection) `installation` instructions to set up the connection.
       - On Auth0 Dashboard, set up the client ID and secret from the previously created Github App.
+      - Enable following settings:
+        - **Use for Connected Accounts with Token Vault** enabled.
 
 ### Setup