agentscore-py 1.0.0__tar.gz

agentscore_py-1.0.0/.claude/CLAUDE.md

@@ -0,0 +1,43 @@
+# agentscore-py
+
+Python client for the AgentScore trust and reputation API.
+
+## Architecture
+
+Single-package Python library published to PyPI.
+
+| File | Purpose |
+|------|---------|
+| `agentscore/` | Source code |
+| `tests/` | pytest tests |
+
+## Tooling
+
+- **uv** — package manager. Use `uv sync`, `uv run`.
+- **ruff** — linting + formatting. `uv run ruff check .` and `uv run ruff format --check .`.
+- **vulture** — dead code detection.
+- **pytest** — tests. `uv run pytest tests/`.
+- **Lefthook** — git hooks. Pre-commit: ruff. Pre-push: vulture.
+
+## Key Commands
+
+```bash
+uv sync --all-extras
+uv run ruff check .
+uv run ruff format .
+uv run pytest tests/
+```
+
+## Workflow
+
+1. Create a branch
+2. Make changes
+3. Lefthook runs ruff on commit, vulture on push
+4. Open a PR — CI runs automatically
+5. Merge (squash)
+
+## Rules
+
+- **No silent refactors**
+- **Never commit .env files or secrets**
+- **Use PRs** — never push directly to main

agentscore_py-1.0.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,21 @@
+---
+name: Bug Report
+about: Report a bug
+title: ''
+labels: bug
+assignees: ''
+---
+
+**Describe the bug**
+A clear description of what the bug is.
+
+**To reproduce**
+Steps to reproduce the behavior.
+
+**Expected behavior**
+What you expected to happen.
+
+**Environment**
+- Package version:
+- Runtime (Node.js/Python version):
+- OS:

agentscore_py-1.0.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,13 @@
+---
+name: Feature Request
+about: Suggest an improvement
+title: ''
+labels: enhancement
+assignees: ''
+---
+
+**Describe the feature**
+A clear description of what you'd like.
+
+**Use case**
+Why is this needed? What problem does it solve?

agentscore_py-1.0.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,7 @@
+## Summary
+
+<!-- What does this PR do? -->
+
+## Test plan
+
+<!-- How was this tested? -->

agentscore_py-1.0.0/.github/dependabot.yml

@@ -0,0 +1,20 @@
+version: 2
+updates:
+  - package-ecosystem: "uv"
+    directory: "/"
+    labels: ["dependencies", "python"]
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "06:00"
+      timezone: "America/New_York"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    labels: ["dependencies", "ci"]
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "06:00"
+      timezone: "America/New_York"
+

agentscore_py-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,22 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  ci:
+    runs-on: blacksmith-2vcpu-ubuntu-2404
+    steps:
+      - uses: actions/checkout@v6
+      - uses: astral-sh/setup-uv@v7
+      - run: uv sync --frozen --all-extras
+      - run: uv run ruff check .
+      - run: uv run ruff format --check .
+      - run: uv run vulture . vulture_whitelist.py --min-confidence 80 --exclude .venv
+      - run: uv run pytest tests/

agentscore_py-1.0.0/.github/workflows/publish.yml

@@ -0,0 +1,37 @@
+name: Publish
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: blacksmith-2vcpu-ubuntu-2404
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: astral-sh/setup-uv@v7
+
+      - name: Set version from tag
+        run: |
+          VERSION="${GITHUB_REF_NAME#v}"
+          sed -i "s/^version = .*/version = \"$VERSION\"/" pyproject.toml
+          echo "VERSION=$VERSION" >> "$GITHUB_ENV"
+
+      - run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+      - name: Commit version bump
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add pyproject.toml
+          git commit -m "chore: bump version to $VERSION" || true
+          git push origin HEAD:main
+

agentscore_py-1.0.0/.github/workflows/security.yml

@@ -0,0 +1,50 @@
+name: Security
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  osv-scan:
+    name: Dependency Scan
+    runs-on: blacksmith-2vcpu-ubuntu-2404
+    timeout-minutes: 5
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install osv-scanner
+        run: |
+          curl -fsSL https://github.com/google/osv-scanner/releases/download/v2.3.2/osv-scanner_linux_amd64 -o osv-scanner
+          chmod +x osv-scanner
+
+      - name: Scan dependencies
+        run: ./osv-scanner --lockfile=uv.lock --format=table || true
+
+  pip-audit:
+    name: Python Audit
+    runs-on: blacksmith-2vcpu-ubuntu-2404
+    timeout-minutes: 5
+    steps:
+      - uses: actions/checkout@v6
+      - uses: astral-sh/setup-uv@v7
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+
+      - name: Install pip-audit
+        run: pip install pip-audit
+
+      - name: Audit dependencies
+        run: |
+          uv export --format requirements-txt --no-hashes > requirements.txt
+          pip-audit -r requirements.txt --disable-pip --no-deps || true
+

agentscore_py-1.0.0/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.pyc
+.venv/
+dist/
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+.env
+coverage/

agentscore_py-1.0.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,31 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints and experiences
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+- Showing empathy towards other community members
+
+Examples of unacceptable behavior:
+
+- The use of sexualized language or imagery, and sexual attention or advances of any kind
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information without explicit permission
+- Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the project team at engineering@agentscore.sh. All complaints will be reviewed and investigated promptly and fairly.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 2.1.

agentscore_py-1.0.0/CONTRIBUTING.md

@@ -0,0 +1,37 @@
+# Contributing to AgentScore
+
+Thanks for your interest in contributing! Here's how to get started.
+
+## Development Setup
+
+1. Fork the repo and clone it locally
+2. Install dependencies (see README for tooling)
+3. Create a branch from `main`
+4. Make your changes
+5. Run linting and tests
+6. Open a pull request
+
+## Pull Requests
+
+- All PRs require 1 approval before merging
+- Squash merge to `main` is the standard
+- Keep PRs focused — one feature or fix per PR
+- Include tests for new functionality
+- Make sure CI passes before requesting review
+
+## Reporting Issues
+
+Open an issue on GitHub with:
+- A clear description of the problem
+- Steps to reproduce
+- Expected vs actual behavior
+- Environment details (OS, runtime version)
+
+## Code Style
+
+- **TypeScript repos**: ESLint handles formatting and style. Run `bun run lint` before committing.
+- **Python repos**: Ruff handles linting and formatting. Run `uv run ruff check .` and `uv run ruff format .` before committing.
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the MIT License.

agentscore_py-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AgentScore
+
+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.

agentscore_py-1.0.0/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.4
+Name: agentscore-py
+Version: 1.0.0
+Summary: Python client for the AgentScore trust and reputation API
+Project-URL: Homepage, https://docs.agentscore.sh
+Project-URL: Repository, https://github.com/agentscore/python-sdk
+Project-URL: Issues, https://github.com/agentscore/python-sdk/issues
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent,agentic-payments,agentscore,ai-agent,blockchain,erc-8004,reputation,trust,wallet,x402
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.9
+Requires-Dist: httpx<1.0.0,>=0.25.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# agentscore-py
+
+[![PyPI version](https://img.shields.io/pypi/v/agentscore-py.svg)](https://pypi.org/project/agentscore-py/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+Python client for the [AgentScore](https://agentscore.sh) trust and reputation API. Score, verify, and assess AI agent wallets in the [x402](https://github.com/coinbase/x402) payment ecosystem and [ERC-8004](https://eips.ethereum.org/EIPS/eip-8004) agent registry.
+
+## Install
+
+```bash
+pip install agentscore-py
+```
+
+## Quick Start
+
+```python
+from agentscore import AgentScore
+
+client = AgentScore(api_key="ask_...")
+
+# Free reputation lookup
+rep = client.get_reputation("0x1234...")
+print(rep["grade"], rep["score"])
+
+# Trust decision with policy
+decision = client.get_decision("0x1234...", min_grade="C", min_transactions=5)
+print(decision["decision"]["allow"])
+```
+
+### Async
+
+```python
+async with AgentScore(api_key="ask_...") as client:
+    rep = await client.aget_reputation("0x1234...")
+    print(rep["grade"])
+```
+
+### Context Manager
+
+```python
+with AgentScore(api_key="ask_...") as client:
+    rep = client.get_reputation("0x1234...")
+```
+
+## Configuration
+
+| Parameter  | Default                     | Description              |
+|------------|----------------------------|--------------------------|
+| `api_key`  | `None`                     | API key from [agentscore.sh](https://agentscore.sh) |
+| `base_url` | `https://api.agentscore.sh` | API base URL             |
+| `timeout`  | `10.0`                     | Request timeout (seconds)|
+
+## Error Handling
+
+```python
+from agentscore import AgentScore, AgentScoreError
+
+try:
+    rep = client.get_reputation("0xinvalid")
+except AgentScoreError as e:
+    print(e.code, e.status_code, str(e))
+```
+
+## Documentation
+
+- [API Reference](https://docs.agentscore.sh)
+- [ERC-8004 Standard](https://eips.ethereum.org/EIPS/eip-8004)
+- [x402 Protocol](https://github.com/coinbase/x402)
+
+## License
+
+[MIT](LICENSE)

agentscore_py-1.0.0/README.md

@@ -0,0 +1,72 @@
+# agentscore-py
+
+[![PyPI version](https://img.shields.io/pypi/v/agentscore-py.svg)](https://pypi.org/project/agentscore-py/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+Python client for the [AgentScore](https://agentscore.sh) trust and reputation API. Score, verify, and assess AI agent wallets in the [x402](https://github.com/coinbase/x402) payment ecosystem and [ERC-8004](https://eips.ethereum.org/EIPS/eip-8004) agent registry.
+
+## Install
+
+```bash
+pip install agentscore-py
+```
+
+## Quick Start
+
+```python
+from agentscore import AgentScore
+
+client = AgentScore(api_key="ask_...")
+
+# Free reputation lookup
+rep = client.get_reputation("0x1234...")
+print(rep["grade"], rep["score"])
+
+# Trust decision with policy
+decision = client.get_decision("0x1234...", min_grade="C", min_transactions=5)
+print(decision["decision"]["allow"])
+```
+
+### Async
+
+```python
+async with AgentScore(api_key="ask_...") as client:
+    rep = await client.aget_reputation("0x1234...")
+    print(rep["grade"])
+```
+
+### Context Manager
+
+```python
+with AgentScore(api_key="ask_...") as client:
+    rep = client.get_reputation("0x1234...")
+```
+
+## Configuration
+
+| Parameter  | Default                     | Description              |
+|------------|----------------------------|--------------------------|
+| `api_key`  | `None`                     | API key from [agentscore.sh](https://agentscore.sh) |
+| `base_url` | `https://api.agentscore.sh` | API base URL             |
+| `timeout`  | `10.0`                     | Request timeout (seconds)|
+
+## Error Handling
+
+```python
+from agentscore import AgentScore, AgentScoreError
+
+try:
+    rep = client.get_reputation("0xinvalid")
+except AgentScoreError as e:
+    print(e.code, e.status_code, str(e))
+```
+
+## Documentation
+
+- [API Reference](https://docs.agentscore.sh)
+- [ERC-8004 Standard](https://eips.ethereum.org/EIPS/eip-8004)
+- [x402 Protocol](https://github.com/coinbase/x402)
+
+## License
+
+[MIT](LICENSE)

agentscore_py-1.0.0/SECURITY.md

@@ -0,0 +1,23 @@
+# Security Policy
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability, please report it responsibly.
+
+**Do not open a public GitHub issue for security vulnerabilities.**
+
+Instead, email us at **security@agentscore.sh** with:
+
+- Description of the vulnerability
+- Steps to reproduce
+- Potential impact
+- Suggested fix (if any)
+
+We will acknowledge receipt within 48 hours and aim to release a fix within 7 days for critical issues.
+
+## Supported Versions
+
+| Version | Supported |
+|---------|-----------|
+| 1.x     | ✅        |
+| < 1.0   | ❌        |

agentscore_py-1.0.0/agentscore/__init__.py

@@ -0,0 +1,35 @@
+from agentscore._version import __version__
+from agentscore.client import AgentScore
+from agentscore.errors import AgentScoreError
+from agentscore.types import (
+    AgentRecord,
+    AgentsListResponse,
+    AssessResponse,
+    DecisionPolicy,
+    EntityType,
+    Grade,
+    ReputationResponse,
+    ReputationStatus,
+    StatsERC8004,
+    StatsPayments,
+    StatsReputation,
+    StatsResponse,
+)
+
+__all__ = [
+    "AgentRecord",
+    "AgentScore",
+    "AgentScoreError",
+    "AgentsListResponse",
+    "AssessResponse",
+    "DecisionPolicy",
+    "EntityType",
+    "Grade",
+    "ReputationResponse",
+    "ReputationStatus",
+    "StatsERC8004",
+    "StatsPayments",
+    "StatsReputation",
+    "StatsResponse",
+    "__version__",
+]

agentscore_py-1.0.0/agentscore/_version.py

@@ -0,0 +1 @@
+__version__ = "1.0.0"