agentshield-gateway-sdk 0.1.0__tar.gz

agentshield_gateway_sdk-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AgentShield
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

agentshield_gateway_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,87 @@
+Metadata-Version: 2.4
+Name: agentshield-gateway-sdk
+Version: 0.1.0
+Summary: Python client for the AgentShield Tool Security Gateway
+License-Expression: MIT
+Keywords: agentshield,ai-security,ai-agents,gateway,authorization
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Security
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests<3,>=2.31
+Dynamic: license-file
+
+# agentshield-gateway-sdk
+
+Python client for the AgentShield Tool Security Gateway. Call `evaluate()` from
+inside your agent's tool-calling loop before it actually runs a tool, and act on
+the decision AgentShield returns.
+
+## Install
+
+Once published to PyPI, anyone can install it with no local files at all:
+
+```bash
+pip install agentshield-gateway-sdk
+```
+
+Until then (or for local development), install from a local checkout of the
+AgentShield repo:
+
+```bash
+pip install /path/to/agentshield/sdk
+# or, for local development (picks up edits without reinstalling):
+pip install -e /path/to/agentshield/sdk
+```
+
+Or from git, without cloning first:
+
+```bash
+pip install "git+https://github.com/<org>/<repo>.git#subdirectory=sdk"
+```
+
+All three install the same distribution, `agentshield-gateway-sdk`, which
+provides the importable module `sdk` (matching the code snippet shown in the
+dashboard's "Get gateway credentials" step) - the import is identical no matter
+which install method you used.
+
+## Get a credential first
+
+The client needs a gateway credential for the specific agent it's acting on
+behalf of. Get one from the dashboard: **Add Agent → Connect its tools → Get
+gateway credentials** (step 6 of onboarding), or via the API:
+`POST /v1/agents/{id}/credentials`. The token is shown only once - store it
+securely (e.g. an environment variable), not in source control.
+
+## Usage
+
+```python
+import os
+from sdk.client import AgentShieldClient
+# or: from sdk import AgentShieldClient
+
+shield = AgentShieldClient(
+    base_url="https://your-agentshield-host",
+    credential=os.environ["AGENTSHIELD_CREDENTIAL"],
+)
+
+result = shield.evaluate(
+    tool="email.send",
+    action="send",
+    target="customer@example.com",
+    data_classification="confidential",
+)
+
+if result.allowed:
+    ...  # actually send the email
+else:
+    print(f"{result.decision}: {result.reason}")
+    # handle BLOCK / REQUIRE_APPROVAL / QUARANTINE - do not proceed
+```
+
+`evaluate()` returns an `EvaluationResult` with `decision`, `risk_score`,
+`risk_breakdown`, `policy`, `reason`, and the `allowed` convenience property
+(`True` only when `decision == "ALLOW"`).

agentshield_gateway_sdk-0.1.0/README.md

@@ -0,0 +1,71 @@
+# agentshield-gateway-sdk
+
+Python client for the AgentShield Tool Security Gateway. Call `evaluate()` from
+inside your agent's tool-calling loop before it actually runs a tool, and act on
+the decision AgentShield returns.
+
+## Install
+
+Once published to PyPI, anyone can install it with no local files at all:
+
+```bash
+pip install agentshield-gateway-sdk
+```
+
+Until then (or for local development), install from a local checkout of the
+AgentShield repo:
+
+```bash
+pip install /path/to/agentshield/sdk
+# or, for local development (picks up edits without reinstalling):
+pip install -e /path/to/agentshield/sdk
+```
+
+Or from git, without cloning first:
+
+```bash
+pip install "git+https://github.com/<org>/<repo>.git#subdirectory=sdk"
+```
+
+All three install the same distribution, `agentshield-gateway-sdk`, which
+provides the importable module `sdk` (matching the code snippet shown in the
+dashboard's "Get gateway credentials" step) - the import is identical no matter
+which install method you used.
+
+## Get a credential first
+
+The client needs a gateway credential for the specific agent it's acting on
+behalf of. Get one from the dashboard: **Add Agent → Connect its tools → Get
+gateway credentials** (step 6 of onboarding), or via the API:
+`POST /v1/agents/{id}/credentials`. The token is shown only once - store it
+securely (e.g. an environment variable), not in source control.
+
+## Usage
+
+```python
+import os
+from sdk.client import AgentShieldClient
+# or: from sdk import AgentShieldClient
+
+shield = AgentShieldClient(
+    base_url="https://your-agentshield-host",
+    credential=os.environ["AGENTSHIELD_CREDENTIAL"],
+)
+
+result = shield.evaluate(
+    tool="email.send",
+    action="send",
+    target="customer@example.com",
+    data_classification="confidential",
+)
+
+if result.allowed:
+    ...  # actually send the email
+else:
+    print(f"{result.decision}: {result.reason}")
+    # handle BLOCK / REQUIRE_APPROVAL / QUARANTINE - do not proceed
+```
+
+`evaluate()` returns an `EvaluationResult` with `decision`, `risk_score`,
+`risk_breakdown`, `policy`, `reason`, and the `allowed` convenience property
+(`True` only when `decision == "ALLOW"`).

agentshield_gateway_sdk-0.1.0/__init__.py

@@ -0,0 +1,3 @@
+from sdk.client import AgentShieldClient, EvaluationResult
+
+__all__ = ["AgentShieldClient", "EvaluationResult"]

agentshield_gateway_sdk-0.1.0/agentshield_gateway_sdk.egg-info/PKG-INFO

@@ -0,0 +1,87 @@
+Metadata-Version: 2.4
+Name: agentshield-gateway-sdk
+Version: 0.1.0
+Summary: Python client for the AgentShield Tool Security Gateway
+License-Expression: MIT
+Keywords: agentshield,ai-security,ai-agents,gateway,authorization
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Security
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests<3,>=2.31
+Dynamic: license-file
+
+# agentshield-gateway-sdk
+
+Python client for the AgentShield Tool Security Gateway. Call `evaluate()` from
+inside your agent's tool-calling loop before it actually runs a tool, and act on
+the decision AgentShield returns.
+
+## Install
+
+Once published to PyPI, anyone can install it with no local files at all:
+
+```bash
+pip install agentshield-gateway-sdk
+```
+
+Until then (or for local development), install from a local checkout of the
+AgentShield repo:
+
+```bash
+pip install /path/to/agentshield/sdk
+# or, for local development (picks up edits without reinstalling):
+pip install -e /path/to/agentshield/sdk
+```
+
+Or from git, without cloning first:
+
+```bash
+pip install "git+https://github.com/<org>/<repo>.git#subdirectory=sdk"
+```
+
+All three install the same distribution, `agentshield-gateway-sdk`, which
+provides the importable module `sdk` (matching the code snippet shown in the
+dashboard's "Get gateway credentials" step) - the import is identical no matter
+which install method you used.
+
+## Get a credential first
+
+The client needs a gateway credential for the specific agent it's acting on
+behalf of. Get one from the dashboard: **Add Agent → Connect its tools → Get
+gateway credentials** (step 6 of onboarding), or via the API:
+`POST /v1/agents/{id}/credentials`. The token is shown only once - store it
+securely (e.g. an environment variable), not in source control.
+
+## Usage
+
+```python
+import os
+from sdk.client import AgentShieldClient
+# or: from sdk import AgentShieldClient
+
+shield = AgentShieldClient(
+    base_url="https://your-agentshield-host",
+    credential=os.environ["AGENTSHIELD_CREDENTIAL"],
+)
+
+result = shield.evaluate(
+    tool="email.send",
+    action="send",
+    target="customer@example.com",
+    data_classification="confidential",
+)
+
+if result.allowed:
+    ...  # actually send the email
+else:
+    print(f"{result.decision}: {result.reason}")
+    # handle BLOCK / REQUIRE_APPROVAL / QUARANTINE - do not proceed
+```
+
+`evaluate()` returns an `EvaluationResult` with `decision`, `risk_score`,
+`risk_breakdown`, `policy`, `reason`, and the `allowed` convenience property
+(`True` only when `decision == "ALLOW"`).

agentshield_gateway_sdk-0.1.0/agentshield_gateway_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+__init__.py
+client.py
+pyproject.toml
+./__init__.py
+./client.py
+agentshield_gateway_sdk.egg-info/PKG-INFO
+agentshield_gateway_sdk.egg-info/SOURCES.txt
+agentshield_gateway_sdk.egg-info/dependency_links.txt
+agentshield_gateway_sdk.egg-info/requires.txt
+agentshield_gateway_sdk.egg-info/top_level.txt

agentshield_gateway_sdk-0.1.0/agentshield_gateway_sdk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

agentshield_gateway_sdk-0.1.0/agentshield_gateway_sdk.egg-info/requires.txt

@@ -0,0 +1 @@
+requests<3,>=2.31

agentshield_gateway_sdk-0.1.0/agentshield_gateway_sdk.egg-info/top_level.txt

@@ -0,0 +1 @@
+sdk

agentshield_gateway_sdk-0.1.0/client.py

@@ -0,0 +1,65 @@
+"""
+Minimal Python SDK for calling the AgentShield Tool Security Gateway from inside
+an agent's tool-calling loop (blueprint section 5). Authenticates with the
+gateway credential issued in step 6 of onboarding (POST /v1/agents/{id}/credentials).
+
+    from sdk.client import AgentShieldClient
+
+    shield = AgentShieldClient(base_url="http://localhost:8000", credential="ash_...")
+    result = shield.evaluate(tool="email.send", action="send", target="ext@example.com",
+                              data_classification="confidential")
+    if result.decision != "ALLOW":
+        raise PermissionError(f"{result.decision}: {result.reason}")
+"""
+from dataclasses import dataclass
+
+import requests
+
+
+@dataclass
+class EvaluationResult:
+    action_id: str
+    decision: str
+    risk_score: int
+    risk_breakdown: dict
+    policy: str | None
+    reason: str
+
+    @property
+    def allowed(self) -> bool:
+        return self.decision == "ALLOW"
+
+
+class AgentShieldClient:
+    def __init__(self, base_url: str, credential: str, timeout: float = 5.0):
+        self.base_url = base_url.rstrip("/")
+        self.credential = credential
+        self.timeout = timeout
+
+    def evaluate(
+        self,
+        *,
+        tool: str,
+        action: str,
+        target: str | None = None,
+        destination: str | None = None,
+        data_classification: str | None = None,
+        amount: float | None = None,
+        raw_input: str | None = None,
+    ) -> EvaluationResult:
+        response = requests.post(
+            f"{self.base_url}/v1/actions/evaluate",
+            headers={"Authorization": f"Bearer {self.credential}"},
+            json={
+                "tool": tool,
+                "action": action,
+                "target": target,
+                "destination": destination,
+                "data_classification": data_classification,
+                "amount": amount,
+                "raw_input": raw_input,
+            },
+            timeout=self.timeout,
+        )
+        response.raise_for_status()
+        return EvaluationResult(**response.json())

agentshield_gateway_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "agentshield-gateway-sdk"
+version = "0.1.0"
+description = "Python client for the AgentShield Tool Security Gateway"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = ["agentshield", "ai-security", "ai-agents", "gateway", "authorization"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+    "Intended Audience :: Developers",
+    "Topic :: Security",
+]
+dependencies = [
+    "requests>=2.31,<3",
+]
+
+[tool.setuptools]
+# The distribution is named "agentshield-gateway-sdk" (what you `pip install`), but
+# the importable module stays "sdk" (what you `import`) - matching the snippet
+# shown in the dashboard's "Get gateway credentials" step.
+packages = ["sdk"]
+
+[tool.setuptools.package-dir]
+sdk = "."

agentshield_gateway_sdk-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+