Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

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

Aperta Adatta ai principianti
  • Qualcosa non va?
#85 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
61/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
typescript
Ambito
documentation

Direzione di ricerca

Partisci dalla documentazione del repository che descrive gli hook pre_tool_call / post_tool_call (e before_reasoning / after_reasoning) nel DSL/compiler dell'agent, oltre a eventuali directory examples/ o di script di esempio. Aggiungi una breve nota di documentazione (facoltativamente uno script di esempio) che mostri un gate firmato sì/no lato host AffixIO all'interno di pre_tool_call prima dell'esecuzione di uno strumento privilegiato, e un'opzionale attestazione post_tool_call. Si è conclusi quando la pagina di documentazione rende l'esempio con i comandi di installazione e afferma che si tratta di attestazione di azioni, non di identità/PII. Nota: l'autore dell'issue è in attesa di risposta dei maintainer prima di qualsiasi PR.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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.

Lingua principale
TypeScript
Stelle
272
Fork
56
Merge medio
12h 18m
PR unite (30g)
5

Preparare l'ambiente

Apri in Codespaces

Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di salesforce/agentscript

Tutte le issue di salesforce/agentscript

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.