[Feature] AffixIO attestation on pre_tool_call / post_tool_call for privileged actions
还没有人认领这个 Issue。
评估
- 难度
- 2/5
- 预计耗时
- 1-3 小时
- 新手友好度
- 61/100
- Issue 类型
- 文档
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 技术栈
- typescript
调研方向
从仓库文档中关于 agent DSL/compiler 里的 pre_tool_call / post_tool_call 钩子（以及 before_reasoning / after_reasoning）的说明读起，同时查看任何 examples/ 或示例脚本目录。添加一段简短的文档说明（可选附一个示例脚本），展示在特权工具运行之前、于 pre_tool_call 内部使用 AffixIO 主机侧签名的是/否门控，以及可选的 post_tool_call 证明（attestation）。完成标准是：文档页面渲染出该示例并附带安装命令，且声明这是操作证明（action attestation），而非身份/PII。请注意，该 issue 作者正在等待维护者反馈，之后才会提交任何 PR。
由索引模型根据 Issue 内容生成。
描述
Problem Statement
Agent Script already exposes deterministic tool lifecycle hooks (pre_tool_call, post_tool_call, plus before_reasoning / after_reasoning). Teams running agents that can call privileged tools (secrets, remediations, admin actions) still need a host-side proof that an approval gate ran before the tool executed.
Today those hooks can gate and observe, but there is no documented pattern for attaching a signed host-side yes/no attestation to that gate.
Proposed Solution
Document (and optionally sample) AffixIO on pre_tool_call / post_tool_call:
- pre_tool_call: require AffixIO host-side approval before a privileged tool runs. AffixIO returns a signed yes/no that the action gate completed.
- post_tool_call: optionally record/attest that the privileged action finished (still action attestation, not identity).
AffixIO proves a host-side action completed (signed yes/no). It is not person/age/KYC. PII stays on the host.
Install:
npm i affixio
# optional local MCP (stdio)
npm i @affixio/[email protected]
Links:
This is a documentation / example ask against the existing hook surface, not a request to embed AffixIO in the runtime.
Alternatives Considered
- Custom policy only inside
pre_tool_callwithout attestation: works, but no portable signed proof the gate ran. - Full AffixIO dialect/runtime wrap: too heavy; Kris/AffixIO prefer a thin hook example over middleware wraps.
Additional Context
Compiler already models pre_tool_call / post_tool_call in the agent DSL. A short docs note or example script showing AffixIO in those callbacks would be enough.
Happy to contribute a minimal example if maintainers want it. Will wait for feedback before any PR.
- 主要语言
- TypeScript
- 星标
- 272
- 派生
- 56
- 平均合并
- 12 小时 18 分钟
- 30 天内合并 PR
- 5
环境准备
在浏览器里用你自己的 GitHub 账号启动这个项目的开发容器。
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
salesforce/agentscript 的其他 Issue
-
README Quick Start fails on macOS: Node 26 incompatibility and missing tree-sitter CLI prerequisite可能重新可做 @dsorajisto 于 158 天前认领，目前没有进行中的 PR。 未关闭
难度 2/5 半天 新手友好度 75/100
salesforce/agentscript#33 · 2 条评论 ·
-
[Bug] Compiler rewrites literal @variables text in expressions可能已有人在做 @BichengWang 于 2 天前认领。 未关闭
难度 3/5 1-2 天 新手友好度 72/100
salesforce/agentscript#96 ·
-
[Bug] List type parameters silently accept non-type expressions可能已有人在做 @BichengWang 于 8 天前认领。 未关闭
难度 3/5 半天 新手友好度 55/100
salesforce/agentscript#91 ·
-
难度 4/5 3-5 天 新手友好度 52/100
salesforce/agentscript#73 ·
-
[bug]: @sf-agentscript/[email protected] (latest) still unusable — dist/ compiled against a newer @sf-agentscript/language than package.json pins (missing export `nullLiteralValidationPass`)可能已有人在做 @srikolagani 于 42 天前认领。 未关闭
难度 3/5 1-2 天 新手友好度 55/100
salesforce/agentscript#71 · 1 条评论 ·
查看 salesforce/agentscript 的全部 Issue
相似的 Issue
-
area:security documentation effort:S priority:P2
难度 2/5 1-3 小时 新手友好度 65/100
维护者通常 1 天内回复
-
app:web meta:ops
难度 2/5 半天 新手友好度 78/100
osu-tournament-rating/otr#1113 ·
维护者通常 1 天内回复
-
bug
难度 2/5 1-3 小时 新手友好度 82/100
-
难度 2/5 1-3 小时 新手友好度 65/100
typegoose/mongodb-memory-server#1040 ·
-
bug
难度 2/5 1-3 小时 新手友好度 92/100