Skip to content

Commit 2444f58

Browse files
vvillait88claude
andcommitted
docs(llms-txt): correct Memory contract emission points (1.3.5)
Auto-generated llms.txt's Memory contract section claimed first-encounter 403s emitted agent_memory; in practice the API emits on POST /v1/sessions success, POST /v1/credentials first-mint, POST /v1/credentials/wallets first-seen, AND on bootstrap missing_identity denials. Merchants emit on their 200 success bodies (store hand-rolls; martin uses firstEncounterAgentMemory). Update the auto-generated text to describe both the merchant-side 200 emit and the three AgentScore API emission points, so agents reading the SDK's auto-llms.txt see the same picture as agents reading martin's hand-curated llms.txt. Em-dash sweep on the surrounding identity section (4 instances replaced with colon / semicolon / parens). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent c13bb38 commit 2444f58

3 files changed

Lines changed: 13 additions & 10 deletions

File tree

agentscore_commerce/discovery/llms_txt.py

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -31,24 +31,27 @@ def llms_txt_identity_section(input: LlmsTxtIdentitySectionInput) -> str:
3131
compliance_note = f"\n\nCompliance: {', '.join(parts)}."
3232
return (
3333
"## Choose your identity header\n\n"
34-
"AgentScore provides cross-merchant identity one KYC works for every AgentScore-gated endpoint, "
34+
"AgentScore provides cross-merchant identity: one KYC works for every AgentScore-gated endpoint, "
3535
"no re-verification per site. Pick the right header based on how you plan to pay:\n\n"
3636
"- **Wallet-auth** (preferred for agents with a stable crypto wallet): send `X-Wallet-Address: 0x...`. "
37-
"Only works on rails that carry a wallet signature Tempo MPP and x402 EIP-3009. "
37+
"Only works on rails that carry a wallet signature (Tempo MPP and x402 EIP-3009). "
3838
"The wallet you claim MUST sign the payment; we verify that the payment signer resolves to the same "
3939
"operator as the claimed wallet. No TTL, no rotation.\n"
4040
"- **Operator-token** (works for every rail): send `X-Operator-Token: opc_...`. Required when paying "
4141
"with Stripe SPT or card (those rails have no wallet signer). Reusable across every AgentScore "
4242
"merchant until the token expires.\n"
43-
"- **Neither**: you'll get 403 with `verify_url` + `poll_secret` complete the session flow once, "
43+
"- **Neither**: you'll get 403 with `verify_url` + `poll_secret`; complete the session flow once, "
4444
"then reuse the credential (or any wallet that pays under it) forever.\n\n"
4545
"If you reach another AgentScore-gated endpoint in the future, the same credential and/or any "
46-
"linked wallet already works skip the session flow.\n\n"
46+
"linked wallet already works; skip the session flow.\n\n"
4747
"## Memory contract\n\n"
48-
"First-encounter 403 responses (and the POST /v1/sessions success body) include an `agent_memory` "
49-
"block describing how AgentScore identity works across merchants. LLM-hosted agents should persist "
50-
"its contents (the pattern, never secrets) so subsequent AgentScore-gated endpoints become "
51-
f"returning-customer encounters.{compliance_note}"
48+
"AgentScore-gated merchants emit an `agent_memory` block in their 200 success bodies "
49+
"describing how AgentScore identity works across merchants. The AgentScore API's "
50+
"POST /v1/sessions, POST /v1/credentials, and POST /v1/credentials/wallets first-mint "
51+
"success bodies also include it. LLM-hosted agents should persist its contents (the "
52+
"pattern, never secrets) so subsequent AgentScore-gated endpoints become returning-"
53+
"customer encounters. The operator_token or linked wallet you use here is reusable "
54+
f"everywhere.{compliance_note}"
5255
)
5356

5457

pyproject.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
44

55
[project]
66
name = "agentscore-commerce"
7-
version = "1.3.4"
7+
version = "1.3.5"
88
description = "Agent commerce SDK for Python — identity middleware (FastAPI, Flask, Django, AIOHTTP, Sanic, ASGI) + payment helpers + 402 builders + discovery + Stripe multichain. The full merchant-side toolkit for AgentScore-powered agent commerce."
99
readme = "README.md"
1010
license = "MIT"

uv.lock

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)