Przejdź do treści
Biblioteka skilli
AI i agenci · Przegląd i audyt

agent-spend-guards

/agent-spend-guards

Sprawdza planowaną transakcję agenta AI wobec limitów kwotowych, dziennych i wyłącznika awaryjnego, zanim agent podpisze zlecenie.

Repozytorium
three.ws ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

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

  1. Local check (no token)
  2. Hosted policy (owner token required)
  3. Rules for the agent
Sekcje z nagłówków SKILL.md, w oryginale · 58 linii, 318 słów
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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.