bosa-connectors-binary 0.0.10__cp312-cp312-macosx_14_0_arm64.whl → 0.1.0__cp312-cp312-macosx_14_0_arm64.whl

bosa_connectors.pyi

@@ -21,9 +21,11 @@ import requests
 import requests.exceptions
 import bosa_connectors.auth.ApiKeyAuthenticator
 import pydantic
+import langchain_core
+import langchain_core.tools
 import uuid
-import cgi
 import random
 import time
-import inspect
-import gllm_agents
+import cgi
+import legacy_cgi
+import inspect

{bosa_connectors_binary-0.0.10.dist-info → bosa_connectors_binary-0.1.0.dist-info}/METADATA

@@ -1,17 +1,18 @@
 Metadata-Version: 2.1
 Name: bosa-connectors-binary
-Version: 0.0.10
+Version: 0.1.0
 Summary: BOSA Connectors
 Author: Bosa Engineers
 Author-email: bosa-eng@gdplabs.id
-Requires-Python: >=3.11,<3.13
+Requires-Python: >=3.11,<3.14
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Provides-Extra: flag-embedding
 Provides-Extra: langchain-huggingface
 Provides-Extra: semantic-router
-Requires-Dist: gllm-agents-binary (==0.0.2)
+Requires-Dist: langchain-core (>=0.3.61,<0.4.0)
+Requires-Dist: legacy-cgi (>=2.6.3,<3.0.0)
 Requires-Dist: pydantic (>=2.9.2,<3.0.0)
 Requires-Dist: requests (>=2.31.0,<3.0.0)
 Description-Content-Type: text/markdown
@@ -31,6 +32,30 @@ A Python SDK for seamlessly connecting to APIs that implement BOSA's Plugin Arch
 - Retry support for requests that fail (429 or 5xx)
 - Response fields filtering based on action and output
 
+## Prerequisites
+After the `bosa-api` ready, you can perform the following tasks:
+- Ensure Bosa API is running. If you want to test locally, or you can use Staging or Production environments.
+- Create Client
+    - You can send a `create-client` request to the `bosa-api` using Postman with the following header and body:
+        - Header
+            - `x-api-user`: KEY1
+        - Body
+            - `name`: "`{client name}`"
+    - Response :
+      ```json
+      {
+           "data": {
+               "id": "{client_id}",
+               "name": "admin",
+               "api_key": "{client_api_key}",
+               "is_active": true
+           },
+           "meta": null
+      }
+        ```
+- Register the user, see the details [here](/python/bosa-connectors/README.md#user-authentication).
+
+
 ## Installation
 
 ### Prerequisites
@@ -79,9 +104,10 @@ bosa = BosaConnector(api_base_url="YOUR_BOSA_API_BASE_URL", api_key="YOUR_API_KE
 
 After initializing the connector, you can authenticate with your BOSA API key.
 
+
 ```python
 # User token from authentication
-user_token = "Enter your key here from authentication, or refer to User Authentication section below"
+user_token = "Enter your key (bearer token) here from authentication, or refer to User Authentication section below"
 
 # Check if a user has an integration for a connector
 has_integration = bosa.user_has_integration("github", user_token)
@@ -111,21 +137,16 @@ It is the basic way to execute actions, where you need to provide the connector
 ```python
 # Prepare input parameters
 params = {
-    "owner": "gdp-admin",
-    "author": "samuellusandi",
-    "per_page": 1,
-    "sort": "author_date",
-    "created_date_start": "2025-02-01",
-    "created_date_end": "2025-02-02"
+    "repo": "my-local-repo", # try to use your local repo for testing
+    "owner": "rexywjy",
 }
 
 # Execute the action with user token
-data, status = bosa.execute("github", "search_commits", token=user_token, max_attempts=1, input_=params)
-
-# Print the result
+data, status = bosa.execute("github", "list_collaborators", token=user_token, max_attempts=1, input_=params)
 print(data)
 print(status)
 ```
+More details about parameters and actions in bosa-api docs `{domain}/docs`
 
 ### Alternative Approach (Fluent Interface)
 
@@ -335,18 +356,25 @@ The connector includes built-in error handling for:
 The BOSA Connector supports user-based authentication which allows for user-specific actions and third-party integrations:
 
 ```python
-# Create a new BOSA user
+# Step 1: Create a new BOSA user
 user_data = bosa.create_bosa_user("username")
 # Save the secret for later use
 user_secret = user_data.secret
 
-# Authenticate a user and get their token
+# Step 2: Authenticate the user and obtain their token
 token = bosa.authenticate_bosa_user("username", user_secret)
 
-# Get user information
+# Step 3: Retrieve user information using the obtained token
 user_info = bosa.get_user_info(token.token)
 ```
 
+### ❗ Important Notes
+
+***🛡️ Best Practice:*** Since bearer tokens can have a long lifespan, it is highly recommended to **reuse existing tokens** whenever possible. While creating new tokens is functionally acceptable, be aware that older tokens may become dangling and can pose a security risk if they are exposed or misused.
+
+***⚠️ Security Reminder:*** When you register a new BOSA user, you will receive a token that starts with **"sk-user-..."**. It is essential to keep this token safe, as it **cannot be recovered if lost**, and currently, there is **no option to reset** it.
+
+
 ## Integration Management
 
 The BOSA Connector provides methods to manage third-party integrations for authenticated users:

bosa_connectors_binary-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+bosa_connectors.build/.gitignore,sha256=aEiIwOuxfzdCmLZe4oB1JsBmCUxwG8x-u-HBCV9JT8E,1
+bosa_connectors.cpython-312-darwin.so,sha256=oftysH4d_UqF58rTvAgz3gKrigijVCwDLe0snGDqPxk,1006072
+bosa_connectors.pyi,sha256=klto3AY3o5l8lA5NKYApY68UZ8FyQR07O37aQafpJZA,676
+bosa_connectors_binary-0.1.0.dist-info/METADATA,sha256=LUuzOJ78WglpDnC3USCNKDzotW2gy9-n7AV9GrB42qc,15944
+bosa_connectors_binary-0.1.0.dist-info/WHEEL,sha256=yhFWDruQeL16y7AZmR-YzCRfHXG6441RPQ3U5xtqaLo,106
+bosa_connectors_binary-0.1.0.dist-info/RECORD,,

bosa_connectors_binary-0.0.10.dist-info/RECORD

@@ -1,6 +0,0 @@
-bosa_connectors.build/.gitignore,sha256=aEiIwOuxfzdCmLZe4oB1JsBmCUxwG8x-u-HBCV9JT8E,1
-bosa_connectors.cpython-312-darwin.so,sha256=TaDTkxTmSexyuUwM18mqgRp36Am4gDYm9VjfdUMKYAU,952104
-bosa_connectors.pyi,sha256=DVKPEVM_E3Q_f92puZ_mV4XD7Beo4LYPSEnoYz_BPKE,627
-bosa_connectors_binary-0.0.10.dist-info/METADATA,sha256=9mJXL_lo0ApAGaELFdIdPlUJAY1EXk3gzcrhJkrqMEs,14460
-bosa_connectors_binary-0.0.10.dist-info/WHEEL,sha256=yhFWDruQeL16y7AZmR-YzCRfHXG6441RPQ3U5xtqaLo,106
-bosa_connectors_binary-0.0.10.dist-info/RECORD,,