agent-rating-protocol 0.1.0__tar.gz

agent_rating_protocol-0.1.0/LICENSE

@@ -0,0 +1,121 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work.
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner.
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND.
+
+   8. Limitation of Liability. In no event and under no legal theory shall
+      any Contributor be liable to You for damages.
+
+   9. Accepting Warranty or Additional Liability.
+
+   Copyright 2026 AB Support LLC
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

agent_rating_protocol-0.1.0/PKG-INFO

@@ -0,0 +1,225 @@
+Metadata-Version: 2.4
+Name: agent-rating-protocol
+Version: 0.1.0
+Summary: Decentralized agent reputation protocol — multidimensional ratings with bilateral blind commit-reveal and Sybil-resistant weighting
+Author-email: AB Support <info@vibeagentmaking.com>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://vibeagentmaking.com
+Project-URL: Repository, https://github.com/brycebostick/agent-rating-protocol
+Project-URL: Whitepaper, https://vibeagentmaking.com/whitepaper.html
+Keywords: agent,rating,reputation,decentralized,provenance,trust
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+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 :: Software Development :: Libraries
+Classifier: Topic :: Security
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: coc
+Requires-Dist: chain-of-consciousness>=0.1.0; extra == "coc"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Dynamic: license-file
+
+# Agent Rating Protocol
+
+[![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-green.svg)](https://www.python.org/downloads/)
+
+Decentralized agent reputation protocol — multidimensional ratings with bilateral blind commit-reveal and Sybil-resistant weighting. Companion to the [Chain of Consciousness](https://vibeagentmaking.com/whitepaper.html) specification.
+
+## Quickstart
+
+```python
+from agent_rating_protocol import RatingRecord, RatingStore, get_reputation
+
+store = RatingStore("ratings.jsonl")
+store.append_rating(RatingRecord(rater_id="agent-a", ratee_id="agent-b", reliability=85, accuracy=90, rater_chain_age_days=100, rater_total_ratings_given=50))
+print(get_reputation(store, "agent-b"))
+```
+
+## Install
+
+```bash
+pip install agent-rating-protocol
+```
+
+With optional Chain of Consciousness integration:
+
+```bash
+pip install agent-rating-protocol[coc]
+```
+
+## Features
+
+- **5-dimension rating** — reliability, accuracy, latency, protocol_compliance, cost_efficiency (1-100 scale)
+- **Bilateral blind protocol** — commit-reveal ensures neither party sees the other's rating until both submit
+- **Sybil-resistant weighting** — W = log2(1 + age) × log2(1 + ratings_given). Score received never affects weight.
+- **Append-only store** — JSONL-backed, tamper-evident via SHA-256 record hashes
+- **Rolling windows** — default 365-day window prevents stale reputation
+- **Confidence scoring** — new agents show high uncertainty, not zero trust
+- **Zero required dependencies** — stdlib only for core. Optional CoC integration.
+- **Identity-agnostic** — works with DIDs, URIs, ERC-8004, or plain strings
+
+## API Reference
+
+### RatingRecord
+
+```python
+from agent_rating_protocol import RatingRecord
+
+record = RatingRecord(
+    rater_id="did:example:alice",
+    ratee_id="did:example:bob",
+    interaction_id="task-uuid-here",
+    reliability=85,
+    accuracy=90,
+    latency=75,
+    protocol_compliance=95,
+    cost_efficiency=70,
+    rater_chain_age_days=365,
+    rater_total_ratings_given=100,
+)
+
+record.to_dict()       # JSON-serializable dict
+record.to_json()       # JSON string
+record.verify_hash()   # True if record_hash is valid
+record.compute_hash()  # Recompute SHA-256 hash
+
+RatingRecord.from_dict(d)  # Deserialize from dict
+```
+
+### RatingStore
+
+```python
+from agent_rating_protocol import RatingStore
+
+store = RatingStore("ratings.jsonl")
+
+store.append_rating(record)               # Append (validates hash first)
+store.get_ratings_for("agent-b")          # Ratings received by agent
+store.get_ratings_by("agent-a")           # Ratings submitted by agent
+store.get_rating("uuid")                  # Look up by rating_id
+store.count()                             # Total ratings
+store.stats()                             # Summary statistics
+store.agents()                            # Per-agent rating counts
+```
+
+### Reputation Queries
+
+```python
+from agent_rating_protocol import get_reputation
+
+# All dimensions
+result = get_reputation(store, "agent-b", window_days=365)
+# {'agent_id': 'agent-b', 'num_ratings': 5, 'confidence': 0.3333, 'scores': {...}}
+
+# Single dimension
+result = get_reputation(store, "agent-b", dimension="reliability")
+# {'agent_id': 'agent-b', 'score': 85.0, 'dimension': 'reliability', ...}
+```
+
+### Bilateral Blind Protocol
+
+```python
+from agent_rating_protocol import BlindExchange, generate_nonce
+
+exchange = BlindExchange(interaction_id="task-001")
+
+# Agent A commits
+nonce_a = generate_nonce()
+exchange.submit_commitment("agent-a", rating_a.to_dict(), nonce_a)
+
+# Agent B commits
+nonce_b = generate_nonce()
+exchange.submit_commitment("agent-b", rating_b.to_dict(), nonce_b)
+
+# Both reveal (triggered when both committed)
+exchange.reveal_rating("agent-a", rating_a.to_dict(), nonce_a)
+exchange.reveal_rating("agent-b", rating_b.to_dict(), nonce_b)
+
+# Get simultaneous results
+rating_a_result, rating_b_result = exchange.get_results()
+```
+
+### Weight Calculation
+
+```python
+from agent_rating_protocol import rater_weight, confidence
+
+w = rater_weight(chain_age_days=365, total_ratings_given=100)  # ≈ 56.4
+c = confidence(num_ratings=50)  # ≈ 0.833
+```
+
+## CLI Reference
+
+```bash
+# Submit a rating
+agent-rating rate agent-b --rater agent-a --reliability 85 --accuracy 90
+
+# Query reputation
+agent-rating query agent-b
+agent-rating query agent-b --dimension reliability --window 180
+
+# Verify a rating hash
+agent-rating verify <rating-uuid>
+
+# Store statistics
+agent-rating status
+
+# All commands support --json for machine-readable output
+agent-rating query agent-b --json
+
+# Custom store path
+agent-rating --store /path/to/ratings.jsonl status
+```
+
+## CoC Integration
+
+If [chain-of-consciousness](https://pypi.org/project/chain-of-consciousness/) is installed and the `COC_CHAIN_FILE` environment variable is set, ratings are automatically recorded as `RATING_SUBMITTED` chain entries:
+
+```bash
+export COC_CHAIN_FILE=chain.jsonl
+agent-rating rate agent-b --rater agent-a --reliability 85
+# -> Rating stored in ratings.jsonl AND recorded in chain.jsonl
+```
+
+## Rating Dimensions
+
+| Dimension | Measures | Scale |
+|-----------|----------|-------|
+| reliability | Task completion, uptime | 1-100 |
+| accuracy | Output correctness | 1-100 |
+| latency | Response speed vs. complexity | 1-100 |
+| protocol_compliance | Message format, handshake correctness | 1-100 |
+| cost_efficiency | Resource usage vs. value | 1-100 |
+
+Score buckets: 1-20 poor, 21-40 below average, 41-60 average, 61-80 good, 81-100 excellent.
+
+## Weight Formula
+
+```
+W(rater) = log2(1 + chain_age_days) × log2(1 + total_ratings_given)
+```
+
+Governance weight equals rating weight by design — both derived from tenure and participation, never from score received.
+
+## Design Specification
+
+Full protocol design, game theory analysis, and governance model: see the [Agent Rating System Design](https://vibeagentmaking.com/whitepaper.html) specification.
+
+## Security Disclaimer (VAM-SEC v1.0)
+
+This software is provided for research and development purposes. The rating protocol includes cryptographic commitments (SHA-256) and a bilateral blind protocol, but has NOT been formally audited by a third-party security firm. Before using in production environments where reputation scores influence high-stakes decisions, conduct an independent security review. The append-only store provides tamper evidence but not tamper prevention — an attacker with filesystem access can modify the JSONL file directly. For stronger guarantees, use CoC integration with external anchoring (OTS + TSA).
+
+## License
+
+Apache 2.0 — see [LICENSE](LICENSE).

agent_rating_protocol-0.1.0/README.md

@@ -0,0 +1,194 @@
+# Agent Rating Protocol
+
+[![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-green.svg)](https://www.python.org/downloads/)
+
+Decentralized agent reputation protocol — multidimensional ratings with bilateral blind commit-reveal and Sybil-resistant weighting. Companion to the [Chain of Consciousness](https://vibeagentmaking.com/whitepaper.html) specification.
+
+## Quickstart
+
+```python
+from agent_rating_protocol import RatingRecord, RatingStore, get_reputation
+
+store = RatingStore("ratings.jsonl")
+store.append_rating(RatingRecord(rater_id="agent-a", ratee_id="agent-b", reliability=85, accuracy=90, rater_chain_age_days=100, rater_total_ratings_given=50))
+print(get_reputation(store, "agent-b"))
+```
+
+## Install
+
+```bash
+pip install agent-rating-protocol
+```
+
+With optional Chain of Consciousness integration:
+
+```bash
+pip install agent-rating-protocol[coc]
+```
+
+## Features
+
+- **5-dimension rating** — reliability, accuracy, latency, protocol_compliance, cost_efficiency (1-100 scale)
+- **Bilateral blind protocol** — commit-reveal ensures neither party sees the other's rating until both submit
+- **Sybil-resistant weighting** — W = log2(1 + age) × log2(1 + ratings_given). Score received never affects weight.
+- **Append-only store** — JSONL-backed, tamper-evident via SHA-256 record hashes
+- **Rolling windows** — default 365-day window prevents stale reputation
+- **Confidence scoring** — new agents show high uncertainty, not zero trust
+- **Zero required dependencies** — stdlib only for core. Optional CoC integration.
+- **Identity-agnostic** — works with DIDs, URIs, ERC-8004, or plain strings
+
+## API Reference
+
+### RatingRecord
+
+```python
+from agent_rating_protocol import RatingRecord
+
+record = RatingRecord(
+    rater_id="did:example:alice",
+    ratee_id="did:example:bob",
+    interaction_id="task-uuid-here",
+    reliability=85,
+    accuracy=90,
+    latency=75,
+    protocol_compliance=95,
+    cost_efficiency=70,
+    rater_chain_age_days=365,
+    rater_total_ratings_given=100,
+)
+
+record.to_dict()       # JSON-serializable dict
+record.to_json()       # JSON string
+record.verify_hash()   # True if record_hash is valid
+record.compute_hash()  # Recompute SHA-256 hash
+
+RatingRecord.from_dict(d)  # Deserialize from dict
+```
+
+### RatingStore
+
+```python
+from agent_rating_protocol import RatingStore
+
+store = RatingStore("ratings.jsonl")
+
+store.append_rating(record)               # Append (validates hash first)
+store.get_ratings_for("agent-b")          # Ratings received by agent
+store.get_ratings_by("agent-a")           # Ratings submitted by agent
+store.get_rating("uuid")                  # Look up by rating_id
+store.count()                             # Total ratings
+store.stats()                             # Summary statistics
+store.agents()                            # Per-agent rating counts
+```
+
+### Reputation Queries
+
+```python
+from agent_rating_protocol import get_reputation
+
+# All dimensions
+result = get_reputation(store, "agent-b", window_days=365)
+# {'agent_id': 'agent-b', 'num_ratings': 5, 'confidence': 0.3333, 'scores': {...}}
+
+# Single dimension
+result = get_reputation(store, "agent-b", dimension="reliability")
+# {'agent_id': 'agent-b', 'score': 85.0, 'dimension': 'reliability', ...}
+```
+
+### Bilateral Blind Protocol
+
+```python
+from agent_rating_protocol import BlindExchange, generate_nonce
+
+exchange = BlindExchange(interaction_id="task-001")
+
+# Agent A commits
+nonce_a = generate_nonce()
+exchange.submit_commitment("agent-a", rating_a.to_dict(), nonce_a)
+
+# Agent B commits
+nonce_b = generate_nonce()
+exchange.submit_commitment("agent-b", rating_b.to_dict(), nonce_b)
+
+# Both reveal (triggered when both committed)
+exchange.reveal_rating("agent-a", rating_a.to_dict(), nonce_a)
+exchange.reveal_rating("agent-b", rating_b.to_dict(), nonce_b)
+
+# Get simultaneous results
+rating_a_result, rating_b_result = exchange.get_results()
+```
+
+### Weight Calculation
+
+```python
+from agent_rating_protocol import rater_weight, confidence
+
+w = rater_weight(chain_age_days=365, total_ratings_given=100)  # ≈ 56.4
+c = confidence(num_ratings=50)  # ≈ 0.833
+```
+
+## CLI Reference
+
+```bash
+# Submit a rating
+agent-rating rate agent-b --rater agent-a --reliability 85 --accuracy 90
+
+# Query reputation
+agent-rating query agent-b
+agent-rating query agent-b --dimension reliability --window 180
+
+# Verify a rating hash
+agent-rating verify <rating-uuid>
+
+# Store statistics
+agent-rating status
+
+# All commands support --json for machine-readable output
+agent-rating query agent-b --json
+
+# Custom store path
+agent-rating --store /path/to/ratings.jsonl status
+```
+
+## CoC Integration
+
+If [chain-of-consciousness](https://pypi.org/project/chain-of-consciousness/) is installed and the `COC_CHAIN_FILE` environment variable is set, ratings are automatically recorded as `RATING_SUBMITTED` chain entries:
+
+```bash
+export COC_CHAIN_FILE=chain.jsonl
+agent-rating rate agent-b --rater agent-a --reliability 85
+# -> Rating stored in ratings.jsonl AND recorded in chain.jsonl
+```
+
+## Rating Dimensions
+
+| Dimension | Measures | Scale |
+|-----------|----------|-------|
+| reliability | Task completion, uptime | 1-100 |
+| accuracy | Output correctness | 1-100 |
+| latency | Response speed vs. complexity | 1-100 |
+| protocol_compliance | Message format, handshake correctness | 1-100 |
+| cost_efficiency | Resource usage vs. value | 1-100 |
+
+Score buckets: 1-20 poor, 21-40 below average, 41-60 average, 61-80 good, 81-100 excellent.
+
+## Weight Formula
+
+```
+W(rater) = log2(1 + chain_age_days) × log2(1 + total_ratings_given)
+```
+
+Governance weight equals rating weight by design — both derived from tenure and participation, never from score received.
+
+## Design Specification
+
+Full protocol design, game theory analysis, and governance model: see the [Agent Rating System Design](https://vibeagentmaking.com/whitepaper.html) specification.
+
+## Security Disclaimer (VAM-SEC v1.0)
+
+This software is provided for research and development purposes. The rating protocol includes cryptographic commitments (SHA-256) and a bilateral blind protocol, but has NOT been formally audited by a third-party security firm. Before using in production environments where reputation scores influence high-stakes decisions, conduct an independent security review. The append-only store provides tamper evidence but not tamper prevention — an attacker with filesystem access can modify the JSONL file directly. For stronger guarantees, use CoC integration with external anchoring (OTS + TSA).
+
+## License
+
+Apache 2.0 — see [LICENSE](LICENSE).

agent_rating_protocol-0.1.0/agent_rating_protocol/__init__.py

@@ -0,0 +1,31 @@
+"""Agent Rating Protocol — decentralized agent reputation system.
+
+A pip-installable implementation of the Decentralized Agent Rating Protocol,
+companion to the Chain of Consciousness specification.
+"""
+
+from .blind import BlindExchange, BlindCommitment, commit, generate_nonce, reveal
+from .query import get_reputation, verify_rating
+from .rating import DIMENSIONS, InteractionEvidence, RatingRecord
+from .store import RatingStore
+from .weight import confidence, rater_weight, weighted_score, weighted_scores_all
+
+__all__ = [
+    "BlindCommitment",
+    "BlindExchange",
+    "DIMENSIONS",
+    "InteractionEvidence",
+    "RatingRecord",
+    "RatingStore",
+    "commit",
+    "confidence",
+    "generate_nonce",
+    "get_reputation",
+    "rater_weight",
+    "reveal",
+    "verify_rating",
+    "weighted_score",
+    "weighted_scores_all",
+]
+
+__version__ = "0.1.0"