agent-finance-cli-linux-arm64 0.3.0 → 0.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # agent-finance-cli-linux-arm64
2
2
 
3
- Prebuilt linux/arm64 binary package for `agent-finance-cli`.
3
+ Prebuilt linux/arm64 binary package for `agent-finance`.
4
4
 
5
- Install the main package instead:
5
+ Install the main npm package instead:
6
6
 
7
7
  ```bash
8
8
  npm install -g agent-finance-cli
package/bin/agent-finance CHANGED
Binary file
package/package.json CHANGED
@@ -1,15 +1,15 @@
1
1
  {
2
2
  "name": "agent-finance-cli-linux-arm64",
3
- "version": "0.3.0",
4
- "description": "Prebuilt linux/arm64 binary for agent-finance-cli.",
3
+ "version": "0.3.2",
4
+ "description": "Prebuilt linux/arm64 binary for agent-finance.",
5
5
  "license": "MIT OR Apache-2.0",
6
6
  "repository": {
7
7
  "type": "git",
8
- "url": "git+https://github.com/M4n5ter/agent-finance-cli.git"
8
+ "url": "git+https://github.com/M4n5ter/agent-finance.git"
9
9
  },
10
- "homepage": "https://github.com/M4n5ter/agent-finance-cli#readme",
10
+ "homepage": "https://github.com/M4n5ter/agent-finance#readme",
11
11
  "bugs": {
12
- "url": "https://github.com/M4n5ter/agent-finance-cli/issues"
12
+ "url": "https://github.com/M4n5ter/agent-finance/issues"
13
13
  },
14
14
  "os": [
15
15
  "linux"
@@ -5,20 +5,31 @@ description: Entry guide for agent-finance market price, sessions, crypto, histo
5
5
 
6
6
  # agent-finance core skill
7
7
 
8
- This skill is printed by the `agent-finance` CLI. It is the first thing an AI Agent should read before using the tool.
8
+ This is the runtime entry guide for using `agent-finance`.
9
9
 
10
- ## Start Here
10
+ ## Start
11
11
 
12
12
  ```bash
13
13
  agent-finance skills list
14
- agent-finance skills get core --full
15
14
  agent-finance market providers
16
15
  agent-finance capabilities
16
+ ```
17
+
18
+ ## Task Router
19
+
20
+ ```bash
21
+ agent-finance skills get price
22
+ agent-finance skills get history-indicators
23
+ agent-finance skills get research-data
17
24
  agent-finance skills get crypto
25
+ agent-finance skills get prediction-markets
26
+ agent-finance skills get providers
18
27
  agent-finance skills get profile
19
28
  ```
20
29
 
21
- ## Default Workflow
30
+ Load a narrow skill before task-specific commands. Use `skills get core --full` when you need the extended command map.
31
+
32
+ ## Default Evidence Flow
22
33
 
23
34
  1. Current observable price:
24
35
 
@@ -41,7 +52,7 @@ agent-finance market history LITE --interval 1d --range 1mo --adjustment auto --
41
52
  agent-finance market history LITE --interval 1m --range 5d --session extended --adjustment raw --no-actions --limit 120
42
53
  ```
43
54
 
44
- 4. Research data:
55
+ 4. Research and source context:
45
56
 
46
57
  ```bash
47
58
  agent-finance market fundamentals CRDO
@@ -76,7 +87,7 @@ agent-finance market crypto book BTC/USDT --provider okx --limit 20
76
87
  agent-finance market crypto discover --provider coingecko --kind trending
77
88
  ```
78
89
 
79
- 7. Signed trading profile and audit workflows:
90
+ 7. Signed Binance workflows:
80
91
 
81
92
  ```bash
82
93
  agent-finance skills get profile
@@ -94,25 +105,16 @@ agent-finance state submit INTENT_ID --profile default
94
105
  agent-finance audit export --json
95
106
  ```
96
107
 
97
- ## Rules
108
+ ## Decision Rules
98
109
 
99
110
  - Use `market price` for the default "what is the current price?" answer.
100
111
  - Use `market sessions` when premarket, postmarket, overnight, BOATS, provider differences, or proxy prices matter.
101
112
  - Use both daily and minute history before judging fills, limit-order quality, stop placement, or intraday action.
102
- - Use `market providers --json` when an Agent needs a machine-readable capability matrix.
113
+ - Use `market providers --json` for a machine-readable capability matrix.
103
114
  - Use `capabilities --json` for the unified terminal surface, including account/order/transfer/futures-state safety boundaries.
104
- - Use `skills get profile` before touching signed account, order, transfer, futures state, risk, or audit commands.
105
- - Signed read commands return a typed `SignedReadSnapshot` envelope with `profile`, `provider`, `environment`, `kind`, typed `request` scope, and raw provider data under `payload`.
106
- - Signed read snapshot kinds are command discriminators: `account permissions` -> `api-permissions`, `account balances` -> `spot-balances`, `account positions` -> `usds-futures-positions`, `order query` -> `order-query`, `order open` -> `open-orders`, `transfer history` -> `transfer-history`.
107
- - Signed submit commands return a typed `SubmitSnapshot` envelope with `profile`, `provider`, `environment`, `intent_id`, `intent_kind`, `mode`, `risk`, `execution.kind`, and execution data under `execution.payload`.
108
- - Run `profile doctor` before live writes; it checks `[permissions]` against the risk policy, reports Binance API permission checks when HMAC env vars are set, and live submit rechecks exchange permissions before claiming the intent.
109
- - Signed order test/live submit checks locally checkable Binance exchangeInfo filters before sending an order; dry-run remains offline.
110
- - Live market orders are blocked until risk notional can be derived from fresh exchange data instead of user-supplied `valuation_price`.
111
- - USD-M futures leverage, margin type, and Binance futures account position mode changes use separate `state` intents; order submit never changes account state implicitly.
112
- - Position mode changes every symbol; Binance UM/CM share `dualSidePosition`, and the exchange rejects the change when either side has open orders or open positions.
113
- - Position mode policy is not in the default profile template; add an explicit `[[risk.allowed_futures_state_changes]]` entry with `kind = "position-mode"` and the intended `mode` before creating that intent.
114
115
  - Treat crypto as 24/7 market data. Use Binance/Coinbase/OKX/CoinGecko through capability-first crypto commands, then force providers only for cross-checking.
115
116
  - Spot is crypto spot; USD-M futures / TradFi perps are derivatives and proxy instruments.
116
117
  - Treat Polymarket as quantifiable prediction-market sentiment and event-probability evidence only; it is not an equity quote or primary-source fact.
117
118
  - `market read-url` is a text extraction fallback, not a real browser. For dynamic, login-gated, screenshot-sensitive, or noisy pages, use an available browser tool such as agent-browser or opencli.
118
119
  - JSON output preserves structured fields for downstream computation. Human output is for quick inspection.
120
+ - Use `skills get profile` before touching signed account, order, transfer, futures state, risk, or audit commands.
@@ -126,6 +126,4 @@ Transfer history reads Binance SAPI live account data and requires a reviewed li
126
126
 
127
127
  The CLI respects `--proxy`, `AGENT_FINANCE_PROXY`, and standard proxy environment variables. It does not hardcode a local proxy.
128
128
 
129
- Polymarket uses the official SDK by default. When `--proxy` or `--no-proxy` is explicit, it uses public REST fallback through the CLI HTTP stack so those network controls are honored.
130
-
131
129
  `market read-url` is a text extraction fallback. For dynamic, login-gated, screenshot-sensitive, or noisy pages, open the original page with an available real browser tool such as agent-browser or opencli.
@@ -56,12 +56,9 @@ agent-finance market crypto stream BTCUSDT --instrument swap --kind mark-price -
56
56
  - Use capability-first crypto commands for all normal work; provider eligibility is determined by capability plus `--instrument`.
57
57
  - Binance, Coinbase, OKX, and CoinGecko are tier-1 no-key crypto providers in this CLI, but they answer different questions.
58
58
  - Binance/OKX are stronger for exchange microstructure and derivatives evidence. Coinbase is a spot exchange cross-check. CoinGecko is stronger for aggregate breadth, trending, metadata, and exchange discovery.
59
- - Binance integration uses self-maintained clients for official public REST and WebSocket paths; do not add the generated Binance SDK unless a future version proves cleaner than these local abstractions.
60
- - Spot WebSocket uses Binance's market-data-only `data-stream.binance.vision` endpoint because this CLI only needs public market data.
61
- - USD-M Futures WebSocket routes streams through Binance's current `/market/ws` and `/public/ws` paths; do not route futures streams through the legacy root `/ws` path.
62
59
  - Prefer `market crypto snapshot` for current observable market state.
63
60
  - Prefer `market crypto sentiment` for futures leverage, funding, open interest, long/short, taker flow, and basis.
64
- - Prefer `market crypto quote/book/trades/candles/funding/open-interest/discover --json` when an Agent needs provider evidence for reasoning.
61
+ - Prefer `market crypto quote/book/trades/candles/funding/open-interest/discover --json` for provider evidence in downstream reasoning.
65
62
  - Use `--json` for downstream computation and `--raw` when auditing provider payloads.
66
63
  - The `market crypto` command surface is read-only market data. Signed Binance account/order/transfer/futures-state workflows live under `account`, `order`, `transfer`, `state`, `risk`, `audit`, and the `profile` skill.
67
64
  - Crypto trades 24/7; do not apply equity regular/pre/post/overnight session assumptions.
@@ -5,7 +5,7 @@ description: Use Polymarket prediction-market data as quantifiable sentiment and
5
5
 
6
6
  # agent-finance prediction-markets skill
7
7
 
8
- Use this skill when an AI Agent needs prediction-market sentiment, event probabilities, or "what capital is pricing in" for a public event.
8
+ Use this skill for prediction-market sentiment, event probabilities, or "what capital is pricing in" for a public event.
9
9
 
10
10
  ## Commands
11
11
 
@@ -48,5 +48,4 @@ agent-finance market polymarket market MARKET_ID_OR_SLUG --limit 20 --refresh
48
48
 
49
49
  - This CLI is read-only for Polymarket.
50
50
  - It does not accept private keys, derive API keys, place orders, cancel orders, or manage Polymarket positions.
51
- - Default transport uses the official SDK. Explicit `--proxy` or `--no-proxy` uses public REST fallback through the CLI HTTP stack so those network controls are honored.
52
51
  - Holder data is reported as preview rows returned by the API limit, not as a total holder count.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: profile
3
- description: Configure agent-finance trading profiles, Binance HMAC env references, risk policy, intent-first live writes, audit logs, and safe AI Agent workflows.
3
+ description: Configure agent-finance trading profiles, Binance HMAC env references, risk policy, intent-first live writes, audit logs, and guarded signed workflows.
4
4
  ---
5
5
 
6
6
  # agent-finance profile skill
@@ -133,71 +133,6 @@ agent-finance audit tail --limit 20
133
133
  agent-finance audit export --json
134
134
  ```
135
135
 
136
- ## Gated Smoke Tests
137
-
138
- These checks are for maintainers and AI Agents validating signed Binance workflows.
139
- They require exported `BINANCE_API_KEY` and `BINANCE_PRIVATE_KEY`; the test profiles store only env var names.
140
-
141
- Live read-only signed smoke, no orders or transfers:
142
-
143
- ```bash
144
- AGENT_FINANCE_LIVE_BINANCE_SIGNED=1 cargo test --test binance_live binance_live_signed_read_only_surface_is_usable -- --ignored --exact --nocapture
145
- ```
146
-
147
- Testnet signed order-test smoke, uses Binance test endpoints and does not place a live order:
148
-
149
- ```bash
150
- AGENT_FINANCE_TESTNET_BINANCE_SIGNED=1 cargo test --test binance_live binance_testnet_signed_order_test_surface_is_usable -- --ignored --exact --nocapture
151
- ```
152
-
153
- Testnet order-flow smoke places a Binance testnet spot `LIMIT_MAKER` order, checks open orders and order query, then cancels it.
154
- It uses the Binance testnet environment and skips live SAPI permission probing; it does not touch live Binance funds, but it still requires testnet credentials, explicit ACK, a deliberately post-only order, and enough testnet balance.
155
- If the testnet price would take liquidity, Binance should reject the `LIMIT_MAKER` submit and the smoke fails before open/query/cancel assertions:
156
-
157
- ```bash
158
- AGENT_FINANCE_TESTNET_BINANCE_ORDER_FLOW=1 \
159
- AGENT_FINANCE_TESTNET_BINANCE_ORDER_FLOW_ACK=I_UNDERSTAND_THIS_PLACES_A_TESTNET_ORDER \
160
- AGENT_FINANCE_TESTNET_BINANCE_ORDER_SYMBOL=BTCUSDT \
161
- AGENT_FINANCE_TESTNET_BINANCE_ORDER_SIDE=buy \
162
- AGENT_FINANCE_TESTNET_BINANCE_ORDER_QUANTITY=0.0004 \
163
- AGENT_FINANCE_TESTNET_BINANCE_ORDER_PRICE=30000 \
164
- AGENT_FINANCE_TESTNET_BINANCE_ORDER_MAX_NOTIONAL_USDT=15 \
165
- cargo test --test binance_live_write binance_testnet_order_open_query_cancel_flow_is_usable -- --ignored --exact --nocapture
166
- ```
167
-
168
- Live place-and-cancel smoke places a real Binance spot `LIMIT_MAKER` post-only order and then cancels it.
169
- The test also reads the live Binance order book and fails before submit unless buy price is below best bid or sell price is above best ask.
170
- Use only with a deliberately non-marketable tiny order that still satisfies Binance min-notional filters; do not fix min-notional failures by making the price marketable.
171
- Prefer a liquid low-notional symbol such as `DOGEUSDT` when the account only has a few USDT. Compute the smoke price from the live book and keep buy orders at least 3% below best bid, or sell orders at least 3% above best ask. After the smoke, query open orders and balances to confirm no order or locked balance remains.
172
- Binance cancel responses may identify the original order with `origClientOrderId`; `clientOrderId` can refer to the cancel request itself.
173
- Set `AGENT_FINANCE_LIVE_BINANCE_SMOKE_DATA_HOME` to a persistent local directory so audit events and daily live notional limits survive between smoke runs.
174
-
175
- ```bash
176
- AGENT_FINANCE_LIVE_BINANCE_PLACE_AND_CANCEL_ORDER=1 \
177
- AGENT_FINANCE_LIVE_BINANCE_WRITE_ACK=I_UNDERSTAND_THIS_PLACES_A_LIVE_ORDER \
178
- AGENT_FINANCE_LIVE_BINANCE_SMOKE_DATA_HOME=$HOME/.local/state/agent-finance-live-smoke \
179
- AGENT_FINANCE_LIVE_BINANCE_ORDER_SYMBOL=DOGEUSDT \
180
- AGENT_FINANCE_LIVE_BINANCE_ORDER_MARKET=spot \
181
- AGENT_FINANCE_LIVE_BINANCE_ORDER_SIDE=buy \
182
- AGENT_FINANCE_LIVE_BINANCE_ORDER_QUANTITY=15 \
183
- AGENT_FINANCE_LIVE_BINANCE_ORDER_PRICE=0.07638 \
184
- AGENT_FINANCE_LIVE_BINANCE_ORDER_MAX_NOTIONAL_USDT=5 \
185
- cargo test --test binance_live_write binance_live_order_cancel_smoke_is_usable -- --ignored --exact --nocapture
186
- ```
187
-
188
- Live transfer smoke moves real funds between Spot and USD-M. Run it only with a tiny amount and an explicit direction:
189
-
190
- ```bash
191
- AGENT_FINANCE_LIVE_BINANCE_TRANSFERS=1 \
192
- AGENT_FINANCE_LIVE_BINANCE_TRANSFER_ACK=I_UNDERSTAND_THIS_MOVES_FUNDS \
193
- AGENT_FINANCE_LIVE_BINANCE_SMOKE_DATA_HOME=$HOME/.local/state/agent-finance-live-smoke \
194
- AGENT_FINANCE_LIVE_BINANCE_TRANSFER_ASSET=USDT \
195
- AGENT_FINANCE_LIVE_BINANCE_TRANSFER_DIRECTION=spot-to-usds-futures \
196
- AGENT_FINANCE_LIVE_BINANCE_TRANSFER_AMOUNT=0.1 \
197
- AGENT_FINANCE_LIVE_BINANCE_TRANSFER_MAX_AMOUNT=0.1 \
198
- cargo test --test binance_live_write binance_live_transfer_smoke_is_usable -- --ignored --exact --nocapture
199
- ```
200
-
201
136
  ## Guardrails
202
137
 
203
138
  - Never put API secrets in TOML, Markdown, command history, audit logs, or prompts.
@@ -25,7 +25,6 @@ agent-finance market providers --json
25
25
  - Stooq live can provide no-key daily/weekly/monthly history; intraday bulk data requires explicit imported ZIP cache.
26
26
  - Crypto: use capability-first commands such as `market crypto quote/book/trades/candles/funding/open-interest/discover`, then force `--provider binance|coinbase|okx|coingecko` only when cross-checking or auditing.
27
27
  - Binance Spot and USD-M Futures are tier-1 crypto market-data providers. Use `agent-finance skills get crypto`.
28
- - Binance uses local clients against official public REST/WebSocket paths, not the generated Binance SDK.
29
28
  - Binance USD-M futures / TradFi perps are derivative instruments and proxy price-discovery sources, not legal equity.
30
29
  - Coinbase is a spot exchange cross-check for products, tickers, stats, books, trades, candles, and volume summary.
31
30
  - OKX is a spot/derivatives exchange cross-check for instruments, tickers, books, trades, candles, funding, mark price, and open interest.
@@ -34,4 +33,4 @@ agent-finance market providers --json
34
33
 
35
34
  ## Browser Boundary
36
35
 
37
- The CLI uses HTTP requests with browser-like TLS behavior where possible, but it is not a full browser. Dynamic, login-gated, screenshot-sensitive, or noisy pages require a real browser tool. Polymarket uses the official SDK by default; explicit `--proxy` or `--no-proxy` uses public REST fallback through the CLI HTTP stack.
36
+ The CLI can read many public HTTP sources, but it is not a full browser. Dynamic, login-gated, screenshot-sensitive, or noisy pages require a real browser tool.