agentproof-ai 0.1.1__tar.gz

agentproof_ai-0.1.1/.editorconfig

@@ -0,0 +1,13 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.py]
+indent_size = 4
+

agentproof_ai-0.1.1/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,33 @@
+name: Bug report
+description: Report a reproducible defect in agentproof
+title: "[bug] "
+labels: ["bug"]
+body:
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: What happened and what did you expect instead?
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Reproduction
+      description: Provide minimal code, inputs, or steps.
+      render: python
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: agentproof version
+      placeholder: 0.1.0
+    validations:
+      required: true
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: Python version, OS, and any relevant framework/runtime details.
+

agentproof_ai-0.1.1/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,6 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Security issue
+    url: https://github.com/bnovik0v/agentproof/security
+    about: Report security issues privately through GitHub Security Advisories.
+

agentproof_ai-0.1.1/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,25 @@
+name: Feature request
+description: Propose a new capability or change for agentproof
+title: "[feature] "
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What problem are you trying to solve?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposal
+      description: Describe the interface or behavior you want.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives
+      description: What alternatives did you consider?
+

agentproof_ai-0.1.1/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,12 @@
+## Summary
+
+Describe the user-visible change and the reasoning behind it.
+
+## Checks
+
+- [ ] Added or updated tests
+- [ ] Updated docs or README if behavior changed
+- [ ] Ran `uv run ruff check .`
+- [ ] Ran `uv run mypy .`
+- [ ] Ran `uv run pytest`
+

agentproof_ai-0.1.1/.github/dependabot.yml

@@ -0,0 +1,14 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 10
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 10
+

agentproof_ai-0.1.1/.github/workflows/ci.yml

@@ -0,0 +1,66 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  quality:
+    name: Quality
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev,docs]"
+
+      - name: Run Ruff
+        run: python -m ruff check .
+
+      - name: Run Mypy
+        run: python -m mypy .
+
+      - name: Run tests
+        run: python -m pytest
+
+      - name: Build package
+        run: python -m build
+
+      - name: Build docs
+        run: python -m mkdocs build --strict
+
+  test-matrix:
+    name: Tests (${{ matrix.os }}, py${{ matrix.python-version }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+
+      - name: Run tests
+        run: python -m pytest
+

agentproof_ai-0.1.1/.github/workflows/docs.yml

@@ -0,0 +1,56 @@
+name: Docs
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[docs]"
+
+      - name: Configure Pages
+        uses: actions/configure-pages@v5
+
+      - name: Build docs
+        run: python -m mkdocs build --strict
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: site/
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+

agentproof_ai-0.1.1/.github/workflows/release.yml

@@ -0,0 +1,75 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    name: Build distributions
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tooling
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build
+
+      - name: Build distributions
+        run: python -m build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    needs: build
+    permissions:
+      id-token: write
+    environment:
+      name: pypi
+      url: https://pypi.org/p/agentproof-ai
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release:
+    name: Create GitHub release
+    runs-on: ubuntu-latest
+    needs: build
+    permissions:
+      contents: write
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Create release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: gh release create "${GITHUB_REF_NAME}" dist/*

agentproof_ai-0.1.1/.gitignore

@@ -0,0 +1,12 @@
+.coverage
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.venv/
+build/
+dist/
+site/
+__pycache__/
+*.egg-info/
+coverage.xml
+

agentproof_ai-0.1.1/.pre-commit-config.yaml

@@ -0,0 +1,7 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.11.0
+    hooks:
+      - id: ruff-check
+      - id: ruff-format
+

agentproof_ai-0.1.1/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+## 0.1.1 - 2026-03-06
+
+- Fixed GitHub release creation workflow by checking out the repository before invoking `gh release`
+- Polished README, repository metadata, issue templates, and demo project
+- Added an automated integration test for the local demo app
+
+## 0.1.0 - 2026-03-06
+
+- Initial release candidate for the `agentproof` library
+- Published distribution name is `agentproof-ai`
+- Added `proof_of_work` and `semantic_math_lock` challenge families
+- Added CLI, tests, docs, and GitHub workflows

agentproof_ai-0.1.1/CITATION.cff

@@ -0,0 +1,10 @@
+cff-version: 1.2.0
+title: agentproof
+message: If you use this project, please cite the repository.
+type: software
+authors:
+  - family-names: Novikov
+    given-names: Borislav
+    email: bnovikov012@gmail.com
+repository-code: https://github.com/bnovik0v/agentproof
+license: MIT

agentproof_ai-0.1.1/CODE_OF_CONDUCT.md

@@ -0,0 +1,10 @@
+# Code of Conduct
+
+This project follows a simple standard: be respectful, direct, and constructive.
+
+Unacceptable behavior includes harassment, personal attacks, deliberate disruption,
+and publishing private information without consent.
+
+Project maintainers may remove comments, commits, or contributions that do not meet
+this standard.
+

agentproof_ai-0.1.1/CONTRIBUTING.md

@@ -0,0 +1,27 @@
+# Contributing
+
+## Setup
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev,docs]"
+```
+
+## Quality checks
+
+```bash
+ruff check .
+ruff format .
+mypy .
+pytest
+python -m build
+```
+
+## Pull requests
+
+- Keep the public API typed and documented
+- Add tests for every behavior change
+- Update docs and changelog for user-facing changes
+- Prefer deterministic verification logic over heuristic checks
+

agentproof_ai-0.1.1/LICENSE

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

agentproof_ai-0.1.1/PKG-INFO

@@ -0,0 +1,278 @@
+Metadata-Version: 2.4
+Name: agentproof-ai
+Version: 0.1.1
+Summary: Agent-oriented verification challenges for Python applications.
+Project-URL: Homepage, https://github.com/bnovik0v/agentproof
+Project-URL: Documentation, https://bnovik0v.github.io/agentproof/
+Project-URL: Issues, https://github.com/bnovik0v/agentproof/issues
+Project-URL: Source, https://github.com/bnovik0v/agentproof
+Author-email: Borislav <bnovikov012@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent,ai,captcha,challenge-response,verification
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet
+Classifier: Topic :: Security
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Provides-Extra: demo
+Requires-Dist: fastapi>=0.115; extra == 'demo'
+Requires-Dist: httpx>=0.28; extra == 'demo'
+Requires-Dist: uvicorn>=0.34; extra == 'demo'
+Provides-Extra: dev
+Requires-Dist: build>=1.2.2; extra == 'dev'
+Requires-Dist: mypy>=1.15; extra == 'dev'
+Requires-Dist: pytest-cov>=6.0; extra == 'dev'
+Requires-Dist: pytest>=8.3; extra == 'dev'
+Requires-Dist: ruff>=0.11; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: mkdocs-material>=9.6; extra == 'docs'
+Requires-Dist: mkdocs>=1.6; extra == 'docs'
+Description-Content-Type: text/markdown
+
+# agentproof
+
+![Distribution](https://img.shields.io/badge/distribution-agentproof--ai-0f766e)
+![Python](https://img.shields.io/badge/python-3.10%20to%203.13-1f6feb)
+![CI](https://github.com/bnovik0v/agentproof/actions/workflows/ci.yml/badge.svg)
+![Docs](https://github.com/bnovik0v/agentproof/actions/workflows/docs.yml/badge.svg)
+[![License](https://img.shields.io/github/license/bnovik0v/agentproof)](LICENSE)
+
+![agentproof overview](assets/agentproof-hero.svg)
+
+`agentproof` is an open-source Python library for agent-oriented verification challenges.
+It gives Python services a clean way to issue deterministic, machine-checkable challenges that
+are easier for programmatic agents to solve than for humans to complete manually.
+
+The library does not claim cryptographic proof of model provenance. It focuses on a narrower,
+defensible goal: structured challenge-response verification.
+
+## Why this exists
+
+Traditional CAPTCHA systems try to separate humans from bots. `agentproof` flips that framing:
+it helps you design challenge-response checks that favor capable software agents and remain
+verifiable on the server.
+
+This is useful when you want to:
+
+- gate access to agent-focused endpoints
+- experiment with reverse-CAPTCHA style flows
+- add a deterministic challenge layer to evaluation or abuse-control pipelines
+- prototype agent-friendly verification without inventing your own format from scratch
+
+## Design goals
+
+- Keep verification deterministic and easy to reason about
+- Make payloads JSON-friendly for APIs and job systems
+- Keep the public API narrow and typed
+- Document the threat model instead of overselling the guarantees
+- Stay lightweight enough for experiments and production prototypes
+
+## Features
+
+- Typed Python API with a small public surface
+- Deterministic challenge generation, solving, and verification
+- Pluggable challenge families behind a shared protocol
+- JSON-serializable payloads for APIs, queues, and services
+- Reference CLI for demos and integration tests
+- Built-in documentation, examples, CI, and release automation
+
+## Challenge families
+
+| Challenge type | Purpose | Verification style |
+| --- | --- | --- |
+| `proof_of_work` | Add deterministic compute cost | Leading-zero SHA256 check |
+| `semantic_math_lock` | Favor structured text generation | Exact word constraints and ASCII initial sum |
+
+## Installation
+
+```bash
+pip install agentproof-ai
+```
+
+The published distribution name is `agentproof-ai`, while the import remains `agentproof`:
+
+```python
+import agentproof
+```
+
+For local development:
+
+```bash
+uv sync --extra dev --extra docs --extra demo
+```
+
+## Public API
+
+```python
+from agentproof import ChallengeSpec, generate_challenge, solve_challenge, verify_response
+```
+
+## Quickstart
+
+```python
+from agentproof import ChallengeSpec, generate_challenge, solve_challenge, verify_response
+
+spec = ChallengeSpec(challenge_type="proof_of_work", difficulty=18, ttl_seconds=120)
+challenge = generate_challenge(spec)
+response = solve_challenge(challenge)
+result = verify_response(challenge, response)
+
+assert result.ok
+```
+
+### Example output
+
+```json
+{
+  "ok": true,
+  "reason": "ok",
+  "details": {
+    "hash": "0007f5...",
+    "nonce": "18423"
+  }
+}
+```
+
+### Semantic challenge example
+
+```python
+from agentproof import ChallengeSpec, generate_challenge, solve_challenge, verify_response
+
+challenge = generate_challenge(
+    ChallengeSpec(
+        challenge_type="semantic_math_lock",
+        ttl_seconds=90,
+        options={"topic": "security", "word_count": 7},
+    )
+)
+response = solve_challenge(challenge)
+result = verify_response(challenge, response)
+
+assert result.ok
+print(response.payload["text"])
+```
+
+### Service integration example
+
+```python
+from agentproof import AgentResponse, Challenge, ChallengeSpec, generate_challenge, verify_response
+
+challenge = generate_challenge(
+    ChallengeSpec(challenge_type="semantic_math_lock", options={"topic": "security", "word_count": 7})
+)
+
+# ... send challenge.to_dict() to a client ...
+
+response = AgentResponse(
+    challenge_id=challenge.challenge_id,
+    challenge_type=challenge.challenge_type,
+    payload={"text": "security demands careful metrics metrics metrics metrics"},
+)
+
+result = verify_response(challenge, response)
+```
+
+### CLI roundtrip
+
+```bash
+agentproof generate proof_of_work --difficulty 16 --output challenge.json
+agentproof solve challenge.json --output response.json
+agentproof verify challenge.json response.json
+```
+
+## Verification model
+
+```mermaid
+sequenceDiagram
+    participant S as Service
+    participant A as Agent client
+    S->>A: Issue challenge JSON
+    A->>A: Solve challenge
+    A->>S: Submit structured response
+    S->>S: Verify deterministically
+    S-->>A: Accept or reject
+```
+
+## CLI
+
+Generate a challenge:
+
+```bash
+agentproof generate proof_of_work --difficulty 18
+```
+
+Solve a challenge from a file:
+
+```bash
+agentproof solve challenge.json
+```
+
+Verify a response:
+
+```bash
+agentproof verify challenge.json response.json
+```
+
+## Demo project
+
+A runnable local demo lives in [`demo/`](/home/borislav/VSCode/agentproof/demo). It is intended
+for opening in VSCode and trying the package end-to-end with a small UI and example service flow.
+
+## Threat model
+
+`agentproof` helps with agent-oriented challenge-response flows. It does **not** prove:
+
+- model provenance
+- provider identity
+- hardware-backed execution
+- immunity against determined scripted attackers
+
+Use it as one verification signal, not as a complete trust system.
+
+## Security and scope
+
+`agentproof` is not an identity or attestation system. It does not prove that a request came
+from a specific model provider or hardware-backed agent. The current scope is challenge-response
+verification with explicit tradeoffs documented in the threat model.
+
+## Modern repo defaults
+
+- GitHub Actions CI across Python 3.10 to 3.13
+- Typed package with `py.typed`
+- Coverage gate at 90%+
+- MkDocs documentation site
+- Dependabot config and issue templates
+- PyPI release workflow prepared for trusted publishing
+
+## Development
+
+```bash
+uv run ruff check .
+uv run mypy .
+uv run pytest
+uv run python -m build
+uv run mkdocs build --strict
+```
+
+## Release model
+
+- `main` runs lint, type checks, tests, package builds, and docs builds in GitHub Actions
+- version tags trigger package publishing through the release workflow
+- PyPI publishing is configured for trusted publishing, so the repository should be linked to the
+  target PyPI project before pushing a release tag
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for local setup and quality checks.
+
+## License
+
+MIT