Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

[Feature] AffixIO attestation on pre_tool_call / post_tool_call for privileged actions

オープン 初心者向け
#85 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
61/100
issue の種類
ドキュメント
明瞭さ
おおむね明確
活発さ
活発
技術スタック
typescript
領域
documentation

調査の方向性

エージェントの DSL/コンパイラにおける pre_tool_call / post_tool_call フック(および before_reasoning / after_reasoning)を説明しているリポジトリのドキュメント、ならびに examples/ やサンプルスクリプトのディレクトリから読み始めてください。特権ツールの実行前に pre_tool_call 内で AffixIO のホスト側署名付き yes/no ゲートを示し、さらに任意の post_tool_call アテステーションを示す短いドキュメントノート(任意でサンプルスクリプト)を追加してください。完了の条件は、ドキュメントページがインストールコマンドとともにその例をレンダリングし、これがアイデンティティ/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_call without 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分
マージ済み PR(30日)
5

環境構築

Codespaces で開く

このプロジェクトの開発コンテナを、あなたの GitHub アカウントでブラウザ上に起動します。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

salesforce/agentscript のほかの issue

salesforce/agentscript の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。