Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

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

Ouverte Adaptée aux débutants
#85 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Évaluation

Difficulté
2/5
Temps estimé
1-3 heures
Accessibilité débutants
61/100
Type d'issue
Documentation
Clarté
Plutôt claire
Activité
Active
Stack technique
typescript
Domaine
documentation

Piste de recherche

Commencez dans la documentation du dépôt qui décrit les hooks pre_tool_call / post_tool_call (et before_reasoning / after_reasoning) dans le DSL/compiler de l'agent, ainsi que tout répertoire examples/ ou de scripts d'exemple. Ajoutez une courte note de documentation (éventuellement un script d'exemple) montrant un gate signé oui/non côté hôte AffixIO à l'intérieur de pre_tool_call avant l'exécution d'un outil privilégié, ainsi qu'une attestation facultative post_tool_call. L'intégration est terminée lorsque la page de documentation rend l'exemple avec les commandes d'installation et indique qu'il s'agit d'une attestation d'actions, pas d'identité/PII. Notez que l'auteur de l'issue attend les retours des maintainers avant tout PR.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

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.

Langage dominant
TypeScript
Étoiles
272
Forks
55
Merge moyen
12 h 18 min
PR mergées (30 j)
5

Préparer son environnement

Ouvrir dans Codespaces

Lance le conteneur de développement du projet dans votre navigateur, avec votre propre compte GitHub.

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de salesforce/agentscript

Toutes les issues de salesforce/agentscript

Issues similaires

Plus d'issues TypeScript

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.