agent-spend-guards
/agent-spend-guards
Sprawdza planowaną transakcję agenta AI wobec limitów kwotowych, dziennych i wyłącznika awaryjnego, zanim agent podpisze zlecenie.
- Autor
- nirholas ↗
- Repozytorium
- three.ws ↗
- Licencja
- Apache-2.0
- Ostatnia zmiana repozytorium
- 13.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 1
Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
Co robi i kiedy
Sprawdza planowaną transakcję agenta AI wobec limitów kwotowych, dziennych i wyłącznika awaryjnego, zanim agent podpisze zlecenie.
Oryginalny opis (EN)
Check a proposed agent trade or spend against per-trade, daily, price-impact, kill-switch and allowlist limits using @three-ws/agent-guards. Use when building or reviewing an autonomous agent that can move funds and needs hard caps before signing.
Jak działa
- Local check (no token)
- Hosted policy (owner token required)
- Rules for the agent
Podgląd SKILL.md
---
name: agent-spend-guards
description: Check a proposed agent trade or spend against per-trade, daily, price-impact, kill-switch and allowlist limits using @three-ws/agent-guards. Use when building or reviewing an autonomous agent that can move funds and needs hard caps before signing.
---
# Agent spend guards
`@three-ws/agent-guards` (Node 18+, zero dependencies, ESM) has two halves:
1. Local pure functions (`policy`, `guard`, `check*`) that need no network and no token.
2. A client (`guards(agentId, opts)` or `createGuards(opts)`) for the hosted three.ws policy endpoints.
Install: `npm install @three-ws/agent-guards`
## Local check (no token)
```js
import { policy, guard } from '@three-ws/agent-guards';
const p = policy({ per_trade_sol: 0.5, daily_budget_sol: 2, max_concurrent: 3 });
const d = guard({ side: 'buy', amountSol: 0.9, priceImpactPct: 2 }, p);
// d.allow === false, d.reason === 'per_trade_cap', d.message explains the fix
```
Policy keys: `per_trade_sol`, `daily_budget_sol`, `max_price_impact_pct`, `max_slippage_bps`,
`max_concurrent`, `kill_switch`, `daily_usd`, `per_tx_usd`, `withdraw_allowlist`, `frozen`.
An unset ceiling means no cap.
Transaction fields (`GuardTx`): `side` (`buy`|`sell`), `category` (`trade`|`snipe`|`x402`|`withdraw`),
`amountSol` or `amountLamports`, `priceImpactPct`, `walletLamports`, `spentLamports` (rolling 24h),
`openCount`, `usdValue`, `spentUsd`, `destination`. A guard whose input is omitted is skipped, so
supply every number you want enforced.
Reason codes: `kill_switch`, `wallet_frozen`, `per_trade_cap`, `daily_budget`, `per_tx_exceeded`,
`daily_exceeded`, `max_positions`, `price_impact`, `insufficient_sol`, `destination_not_allowed`.
Individual predicates are exported too: `checkKillSwitch`, `checkFrozen`, `checkConcurrency`,
`checkPerTradeCap`, `checkDailyBudgetLamports`, `checkSolHeadroom`, `checkPriceImpact`,
`checkPerTxUsd`, `checkDailyUsd`, `checkAllowlist`. Each returns `null` (pass) or `{reason, detail}`.
## Hosted policy (owner token required)
```js
import { guards } from '@three-ws/agent-guards';
const a = guards('agent_abc123', { token: process.env.THREE_WS_TOKEN });
await a.setTradeLimits({ per_trade_sol: 0.5, daily_budget_sol: 2 });
const decision = await a.checkTrade({ side: 'buy', mint, amount: 0.3 }); // simulates, moves no funds
if (decision.allowed) await a.trade({ side: 'buy', mint, amount: 0.3 }); // really executes
await a.setTradeLimits({ kill_switch: true }); // reject every discretionary trade
```
Other methods: `getTradeLimits()`, `getSpendLimits({network})`, `setSpendLimits(patch, {network})`.
Endpoints used: `/api/agents/:id/trade`, `/trade/quote`, `/trade/limits`, `/wallet/limits` on
`https://three.ws` (override with `baseUrl`). Env: `THREE_WS_TOKEN` (owner bearer token).
## Rules for the agent
- Run `guard()` or `checkTrade()` before every signing step. Do not call `trade()` on a blocked decision.
- `trade()` moves real funds. Show the user side, mint and amount, and wait for an explicit yes first.
- Never put the token in code or logs.
Wersje
W bazie nie ma innych skilli o nazwie agent-spend-guards.
Migawka bazy z 13.11.2026 · wersja paczki 94c4375c1942 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100agent-kill-switch
Daje człowiekowi wyłącznik awaryjny i licznik kosztów dla agentów kodujących na komputerze dzięki ClawMetry: zatrzymanie agenta, podgląd działań i wydatków, limity i zatwierdzanie ryzykownych wywołań. - 100iblai-api-spend-caps
Zarządza limitami wydatków na LLM w organizacji ibl.ai przez API: limity dla organizacji, agenta lub użytkownika, okno czasowe, tryb blokady albo alertu i progi ostrzeżeń. - 100agent-oversight
Dodaje do agenta AI nadzór w czasie działania: domyślną odmowę dostępu do narzędzi, limity, zatwierdzanie ryzykownych działań, wyłącznik awaryjny i dziennik decyzji. - 90daily-budget-check
Sprawdza dzienne wydatki względem dziennego budżetu na dashboardzie Agent Monitor: wydatek dziś, tempo w ciągu dnia i prognozowane przekroczenie. - 100daily-log
Opisuje konwencje dziennych logów pamięci agenta między sesjami, w tym notatkę dnia i sprawdzanie kontekstu na starcie sesji. - 100openclaw-agent-wallet
Dodaje limity wydatków, zatwierdzanie płatności i dziennik audytu do autonomicznych agentów AI.