Skip to content

docs: document attestation/reputation API, fix tagline; bump to 0.3.2#6

Merged
refined-element merged 1 commit into
masterfrom
docs/readme-attestation
Jul 3, 2026
Merged

docs: document attestation/reputation API, fix tagline; bump to 0.3.2#6
refined-element merged 1 commit into
masterfrom
docs/readme-attestation

Conversation

@refined-element

Copy link
Copy Markdown
Owner

Fixes #5 (2026-07-03 docs audit, findings agent-sdks-3 / agent-sdks-4).

Changes

  • Tagline: "Discover, negotiate, and settle..." -> "Discover, request, and settle agent-to-agent services over Nostr with L402 Lightning payments." The SDK has no negotiate API; the ASA flow is discover -> request -> settle -> attest. Same one-word fix applied to the package docstring in __init__.py.
  • Protocol section: now lists all four Nostr event kinds, adding 38403 -- Agent Attestation (post-completion review, rating 1-5, on-protocol reputation).
  • API Reference:
    • AgentAttestation model row added to Core Classes.
    • New Reputation methods table for publish_attestation, get_attestations, get_reputation_score — signatures verified against src/le_agent_sdk/agent/manager.py.
    • Short runnable attest-and-check-reputation example.
  • Version: pyproject bumped 0.3.1 -> 0.3.2 for the docs republish (no tag pushed — tagging/publishing is the owner's call). __init__.__version__ synced (was stale at 0.3.0).

Tests

python -m pytest — 137 passed.

🤖 Generated with Claude Code

https://claude.ai/code/session_01FeVJ1dSozozhHDmNHiPj5f

- Tagline: "Discover, negotiate, and settle" -> "Discover, request, and
  settle" (the SDK has no negotiate API; ASA flow is
  discover -> request -> settle -> attest). Also fixed the same wording
  in the package docstring.
- Protocol section: add kind 38403 (Agent Attestation) alongside
  38400/38401/38402.
- API Reference: add AgentAttestation model row plus a Reputation
  methods table (publish_attestation / get_attestations /
  get_reputation_score, signatures verified against agent/manager.py)
  and a runnable attest-and-check-reputation example.
- Bump version to 0.3.2 for a docs republish; sync __version__ in
  __init__.py (was stale at 0.3.0 vs pyproject 0.3.1). No tag pushed.

Closes #5

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FeVJ1dSozozhHDmNHiPj5f
@refined-element refined-element merged commit ca54a8e into master Jul 3, 2026
3 checks passed
@refined-element refined-element deleted the docs/readme-attestation branch July 3, 2026 22:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

README: attestation/reputation half of the SDK missing; "negotiate" tagline inaccurate

1 participant