Skip to content

docs: require approval before paid API calls - #93

Merged
eddiearc merged 8 commits into
mainfrom
codex/aisa-pricing-contract-docs
Sep 2, 2026
Merged

docs: require approval before paid API calls#93
eddiearc merged 8 commits into
mainfrom
codex/aisa-pricing-contract-docs

Conversation

@eddiearc

@eddiearc eddiearc commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

Paid / high-cost API approval-first 文档合同

本 PR 只改 docs/OpenAPI contract;不新增报价 API,不修改、合并或部署 MCP / 后端。

唯一来源、无派生产物

  • 唯一价格事实源openapi/similarweb.jsonx-aisa-pricing(已在 feat(openapi): add machine-readable x-aisa-pricing to agent-facing spec #92 存在);
  • 不生成 endpoint 价格文案:没有 pricing renderer、派生 description、手动生成步骤或 workflow check;
  • 不维护 SimilarWeb 专页:没有英文/中文价格专页或第二份价目表;
  • Agent 行为层:Quickstart 与 llms.txt 的 XML <IMPORTANT> 对每个付费、动态或可能高成本 API 生效。

安全合同

付费数据调用前,Agent 必须展示 exact endpoint/scope、公式或费率与已记录的最大 USD。
“直接查齐/调研/出报告”不是批准:Agent 必须等待用户在下一条消息中单独批准该 scope
与 cap。无法确认上限的 provider-controlled 维度仍 fail-closed;禁止 price probe/test。

对应评测集

user-journey-evals #5 现已覆盖无上限 snapshot、硬预算 SimilarSites、scope-drift 重确认和通用高价 API;其中前两项是可运行的零数据调用 case。完整报告保留实际样本和残余风险。

@eddiearc
eddiearc force-pushed the codex/aisa-pricing-contract-docs branch from 6a208c3 to 0e660d1 Compare September 1, 2026 05:11
@eddiearc
eddiearc force-pushed the codex/aisa-pricing-contract-docs branch from 0e660d1 to 5bb33e3 Compare September 1, 2026 07:17
@eddiearc
eddiearc force-pushed the codex/aisa-pricing-contract-docs branch from 5bb33e3 to f1950fb Compare September 1, 2026 08:07
@eddiearc eddiearc changed the title docs: disclose SimilarWeb dynamic pricing docs: require approval before paid API calls Sep 2, 2026
@eddiearc
eddiearc merged commit 220fd83 into main Sep 2, 2026
1 check passed
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.

1 participant