agentauthlayer 0.1.2__tar.gz → 0.1.3__tar.gz

{agentauthlayer-0.1.2 → agentauthlayer-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentauthlayer
-Version: 0.1.2
+Version: 0.1.3
 Summary: Library-first authentication and authorization SDK for AI agents
 Author: Vaibhav Ahluwalia
 License: MIT
@@ -39,7 +39,23 @@ pip install agentauthlayer
 
 ## Quickstart
 
-### 1. Log in once
+### 1. First-time developer setup
+
+For a fresh self-hosted deployment, complete the control plane setup before using `agentauth login`.
+
+1. Start your Agent Auth deployment.
+2. Open the UI in your browser.
+3. Create the first super admin password.
+4. Create your first project.
+5. Then log in from the CLI.
+
+Open the UI with:
+
+```bash
+agentauth ui --base-url http://127.0.0.1:8002
+```
+
+Then log in once:
 
 ```bash
 agentauth login --base-url http://127.0.0.1:8002
@@ -55,6 +71,8 @@ agentauth logout
 agentauth ui
 ```
 
+If the deployment has not been initialized yet, `agentauth login` will tell you to finish setup in the UI first.
+
 ### 2. Define tools and agents in code
 
 ```python
@@ -111,6 +129,15 @@ export AGENT_AUTH_URL=http://127.0.0.1:8002
 export AGENT_AUTH_TOKEN=YOUR_ADMIN_OR_SERVICE_TOKEN
 ```
 
+`AGENT_AUTH_TOKEN` is typically a bearer token, often represented as a long JWT string.
+
+Recommended usage:
+- use `agentauth login` for local human developer workflows
+- use `AGENT_AUTH_TOKEN` for CI, automation, or service-driven execution
+
+If an env token expires, requests will fail until you replace it or log in again.
+Avoid committing tokens into source control or long-lived shared `.env` files.
+
 Resolution order used by `AuthAPIClient()`:
 1. explicit constructor arguments
 2. environment variables

{agentauthlayer-0.1.2 → agentauthlayer-0.1.3}/README.md

@@ -19,7 +19,23 @@ pip install agentauthlayer
 
 ## Quickstart
 
-### 1. Log in once
+### 1. First-time developer setup
+
+For a fresh self-hosted deployment, complete the control plane setup before using `agentauth login`.
+
+1. Start your Agent Auth deployment.
+2. Open the UI in your browser.
+3. Create the first super admin password.
+4. Create your first project.
+5. Then log in from the CLI.
+
+Open the UI with:
+
+```bash
+agentauth ui --base-url http://127.0.0.1:8002
+```
+
+Then log in once:
 
 ```bash
 agentauth login --base-url http://127.0.0.1:8002
@@ -35,6 +51,8 @@ agentauth logout
 agentauth ui
 ```
 
+If the deployment has not been initialized yet, `agentauth login` will tell you to finish setup in the UI first.
+
 ### 2. Define tools and agents in code
 
 ```python
@@ -91,6 +109,15 @@ export AGENT_AUTH_URL=http://127.0.0.1:8002
 export AGENT_AUTH_TOKEN=YOUR_ADMIN_OR_SERVICE_TOKEN
 ```
 
+`AGENT_AUTH_TOKEN` is typically a bearer token, often represented as a long JWT string.
+
+Recommended usage:
+- use `agentauth login` for local human developer workflows
+- use `AGENT_AUTH_TOKEN` for CI, automation, or service-driven execution
+
+If an env token expires, requests will fail until you replace it or log in again.
+Avoid committing tokens into source control or long-lived shared `.env` files.
+
 Resolution order used by `AuthAPIClient()`:
 1. explicit constructor arguments
 2. environment variables

{agentauthlayer-0.1.2 → agentauthlayer-0.1.3}/agent_auth/cli.py

@@ -14,10 +14,48 @@ from agent_auth.credentials import clear_credentials, load_credentials, save_cre
 from agent_auth.registry import clear_registries, list_registered_agents, list_registered_tools
 
 
+def _response_detail(response: requests.Response) -> str:
+    try:
+        payload = response.json()
+        if isinstance(payload, dict) and payload.get('detail'):
+            return str(payload['detail'])
+    except Exception:
+        pass
+    return response.text.strip() or f'Request failed with status {response.status_code}'
+
+
+def _bootstrap_status(base_url: str) -> bool | None:
+    try:
+        response = requests.get(f"{base_url}/bootstrap/status", timeout=10)
+    except requests.RequestException:
+        return None
+    if not response.ok:
+        return None
+    try:
+        payload = response.json()
+        return bool(payload.get('is_setup'))
+    except Exception:
+        return None
+
+
 def login_command(args) -> int:
+    base_url = (args.base_url or 'http://127.0.0.1:8002').rstrip('/')
+    setup_status = _bootstrap_status(base_url)
+
+    if setup_status is False:
+        print(
+            '\nThis Agent Auth deployment has not been initialized yet.\n'
+            'First-time developer setup:\n'
+            f'  1. Open the UI: {base_url}\n'
+            '  2. Create the first super admin password\n'
+            '  3. Create your first project\n'
+            '  4. Run agentauth login again\n',
+            file=sys.stderr,
+        )
+        return 1
+
     email = args.email or input('Email: ').strip()
     password = args.password or getpass.getpass('Password: ')
-    base_url = (args.base_url or 'http://127.0.0.1:8002').rstrip('/')
 
     response = requests.post(
         f"{base_url}/users/login",
@@ -25,7 +63,15 @@ def login_command(args) -> int:
         timeout=30,
     )
     if not response.ok:
-        print(response.text, file=sys.stderr)
+        detail = _response_detail(response)
+        if response.status_code == 401 and setup_status is not True:
+            print(
+                f"{detail}\n\n"
+                'If this is your first time using this deployment, initialize it first in the UI, then try logging in again.',
+                file=sys.stderr,
+            )
+        else:
+            print(detail, file=sys.stderr)
         return 1
 
     payload = response.json()

{agentauthlayer-0.1.2 → agentauthlayer-0.1.3}/agentauthlayer.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentauthlayer
-Version: 0.1.2
+Version: 0.1.3
 Summary: Library-first authentication and authorization SDK for AI agents
 Author: Vaibhav Ahluwalia
 License: MIT
@@ -39,7 +39,23 @@ pip install agentauthlayer
 
 ## Quickstart
 
-### 1. Log in once
+### 1. First-time developer setup
+
+For a fresh self-hosted deployment, complete the control plane setup before using `agentauth login`.
+
+1. Start your Agent Auth deployment.
+2. Open the UI in your browser.
+3. Create the first super admin password.
+4. Create your first project.
+5. Then log in from the CLI.
+
+Open the UI with:
+
+```bash
+agentauth ui --base-url http://127.0.0.1:8002
+```
+
+Then log in once:
 
 ```bash
 agentauth login --base-url http://127.0.0.1:8002
@@ -55,6 +71,8 @@ agentauth logout
 agentauth ui
 ```
 
+If the deployment has not been initialized yet, `agentauth login` will tell you to finish setup in the UI first.
+
 ### 2. Define tools and agents in code
 
 ```python
@@ -111,6 +129,15 @@ export AGENT_AUTH_URL=http://127.0.0.1:8002
 export AGENT_AUTH_TOKEN=YOUR_ADMIN_OR_SERVICE_TOKEN
 ```
 
+`AGENT_AUTH_TOKEN` is typically a bearer token, often represented as a long JWT string.
+
+Recommended usage:
+- use `agentauth login` for local human developer workflows
+- use `AGENT_AUTH_TOKEN` for CI, automation, or service-driven execution
+
+If an env token expires, requests will fail until you replace it or log in again.
+Avoid committing tokens into source control or long-lived shared `.env` files.
+
 Resolution order used by `AuthAPIClient()`:
 1. explicit constructor arguments
 2. environment variables

{agentauthlayer-0.1.2 → agentauthlayer-0.1.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agentauthlayer"
-version = "0.1.2"
+version = "0.1.3"
 description = "Library-first authentication and authorization SDK for AI agents"
 readme = "README.md"
 requires-python = ">=3.10"