@thirdfy/agent-cli 0.2.85 → 0.3.0
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/CHANGELOG.md +12 -0
- package/README.md +5 -11
- package/package.json +1 -1
- package/src/cli/help.mjs +0 -3
- package/src/cli/manifest.mjs +0 -22
- package/src/commands/prompt.mjs +3 -4
- package/src/runtime/providerHints.mjs +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,18 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
|
|
|
4
4
|
|
|
5
5
|
## Unreleased
|
|
6
6
|
|
|
7
|
+
## [0.3.0] - 2026-10-10
|
|
8
|
+
|
|
9
|
+
### Removed
|
|
10
|
+
|
|
11
|
+
- **BREAKING: the `jeff` command group.** `jeff trade`, `jeff preflight` and `jeff status` were aliases and are gone. Jeff v1 is deprecated and Thirdfy API 4.0.0 no longer serves `jeff_*` tools. Use the generic commands they pointed at: `jeff trade` -> `run`, `jeff preflight` -> `preflight`, `jeff status` -> `intent-status`. Same flags. `docs/jeff-workflows.md` is removed; the Bitfinex onboarding recovery is in `docs/providers/bitfinex.md`. The `prompt` command now suggests `run`.
|
|
12
|
+
|
|
13
|
+
## [0.2.86] - 2026-10-10
|
|
14
|
+
|
|
15
|
+
### Changed
|
|
16
|
+
|
|
17
|
+
- **Bermuda hint: no privacy fee at launch.** The hint said private swaps carry a privacy fee. Thirdfy API turned the fee off (private actions pay only `write_private` credits), so the hint now says any fee is reported as `privacyFee` (0 at launch). `docs/providers/bermuda.md` says the same.
|
|
18
|
+
|
|
7
19
|
## [0.2.85] - 2026-10-10
|
|
8
20
|
|
|
9
21
|
### Fixed
|
package/README.md
CHANGED
|
@@ -40,11 +40,10 @@ Run without global install:
|
|
|
40
40
|
npx @thirdfy/agent-cli --help
|
|
41
41
|
```
|
|
42
42
|
|
|
43
|
-
## What's new in v0.
|
|
43
|
+
## What's new in v0.3.0
|
|
44
44
|
|
|
45
|
-
-
|
|
46
|
-
-
|
|
47
|
-
- See [CHANGELOG.md](./CHANGELOG.md) and GitHub Releases for older versions.
|
|
45
|
+
- **Removed: the `jeff` command group.** Jeff v1 is deprecated and Thirdfy API 4.0.0 no longer serves `jeff_*` tools. Replace `jeff trade` with `run`, `jeff preflight` with `preflight`, and `jeff status` with `intent-status` (same flags).
|
|
46
|
+
- See [CHANGELOG.md](./CHANGELOG.md) and the release notes for older versions.
|
|
48
47
|
|
|
49
48
|
## Quick start
|
|
50
49
|
|
|
@@ -301,13 +300,8 @@ thirdfy-agent run --agent-api-key "$AGENT_API_KEY" --action swap \
|
|
|
301
300
|
--params '{"tokenIn":"0x...","tokenOut":"0x...","amountInHuman":"1.5","tokenInDecimals":6,"chainId":8453}' --json
|
|
302
301
|
```
|
|
303
302
|
|
|
304
|
-
##
|
|
303
|
+
## Prompt shorthand
|
|
305
304
|
|
|
306
|
-
Jeff-friendly aliases map directly to core commands:
|
|
307
|
-
|
|
308
|
-
- `thirdfy-agent jeff preflight ...` -> alias of `preflight`
|
|
309
|
-
- `thirdfy-agent jeff trade ...` -> alias of `run`
|
|
310
|
-
- `thirdfy-agent jeff status --intent-id ...` -> alias of `intent-status`
|
|
311
305
|
- `thirdfy-agent prompt "<text>"` -> captures prompt intent and suggests deterministic execution commands
|
|
312
306
|
|
|
313
307
|
## Provider-specific workflows
|
|
@@ -321,7 +315,7 @@ Provider and venue guides are kept outside `README` so this page stays stable as
|
|
|
321
315
|
## Command groups
|
|
322
316
|
|
|
323
317
|
- Discovery: `catalogs list`, `signals` (data provider apps and their signals: fields with units, freshness, roles, credits, attribution; `--provider`, `--role`), `actions` (optional `--provider`, `--chain-id`, `--data-category`; see [`docs/command-reference.md`](./docs/command-reference.md) for trading vs earn vs prediction providers and case-insensitive matching)
|
|
324
|
-
- Execution: `preflight`, `run`, `intent-status
|
|
318
|
+
- Execution: `preflight`, `run`, `intent-status`
|
|
325
319
|
- Polymarket: `polymarket status`, `polymarket setup`, `polymarket dry-run`
|
|
326
320
|
- Venue tooling: `venue readiness`, `venue setup`, `venue fund` (`polymarket`, `hyperliquid`, `lighter`, `veranta`)
|
|
327
321
|
- Hummingbot: `hummingbot status`, `connectors`, `executor-schema`, `executor-create`, `executor-stop`, `gateway-networks`, `gateway-connectors`
|
package/package.json
CHANGED
package/src/cli/help.mjs
CHANGED
|
@@ -72,9 +72,6 @@ Core commands:
|
|
|
72
72
|
thirdfy-agent doctor self [--wallet-address <addr>] [--ows-wallet-name <name>] [--chain-id <id>] [--rpc-url <url>] [--json]
|
|
73
73
|
thirdfy-agent doctor auth [--chain-id <id>] [--json]
|
|
74
74
|
thirdfy-agent doctor certify execution [--no-write] [--run-mode <mode>] [--schema-digest <digest>] [--required-actions <csv>] [--json]
|
|
75
|
-
thirdfy-agent jeff preflight --agent-api-key <key> --action <id> --params <json> [--run-mode <mode>] [--json]
|
|
76
|
-
thirdfy-agent jeff trade --agent-api-key <key> --action <id> --params <json> [--run-mode <mode>] [--json]
|
|
77
|
-
thirdfy-agent jeff status --intent-id <id> [--json]
|
|
78
75
|
thirdfy-agent prompt "<natural language prompt>" [--json]
|
|
79
76
|
thirdfy-agent intent-status --intent-id <id> [--json]
|
|
80
77
|
thirdfy-agent credits balance --auth-token <token> [--json]
|
package/src/cli/manifest.mjs
CHANGED
|
@@ -10,7 +10,6 @@
|
|
|
10
10
|
* @property {string} [description]
|
|
11
11
|
* @property {object} [args] - Commander arguments, e.g. { email: '<address>' }
|
|
12
12
|
* @property {string} [trackKind] - for commandTrackList: 'actions' | 'events'
|
|
13
|
-
* @property {boolean} [jeffAlias] - maps jeff * to root handlers
|
|
14
13
|
*/
|
|
15
14
|
|
|
16
15
|
/** @type {ManifestEntry[]} */
|
|
@@ -200,27 +199,6 @@ export const CLI_MANIFEST = [
|
|
|
200
199
|
options: ['auth', 'delegation', 'bootstrap'],
|
|
201
200
|
description: 'Managed wallet + delegation setup',
|
|
202
201
|
},
|
|
203
|
-
{
|
|
204
|
-
path: ['jeff', 'trade'],
|
|
205
|
-
handler: 'commandRun',
|
|
206
|
-
tier: 'online',
|
|
207
|
-
options: ['auth', 'execution'],
|
|
208
|
-
description: 'Execute intent (jeff alias)',
|
|
209
|
-
},
|
|
210
|
-
{
|
|
211
|
-
path: ['jeff', 'preflight'],
|
|
212
|
-
handler: 'commandPreflight',
|
|
213
|
-
tier: 'online',
|
|
214
|
-
options: ['auth', 'execution'],
|
|
215
|
-
description: 'Governance preflight (jeff alias)',
|
|
216
|
-
},
|
|
217
|
-
{
|
|
218
|
-
path: ['jeff', 'status'],
|
|
219
|
-
handler: 'commandIntentStatus',
|
|
220
|
-
tier: 'online',
|
|
221
|
-
options: ['execution'],
|
|
222
|
-
description: 'Intent status (jeff alias)',
|
|
223
|
-
},
|
|
224
202
|
{ path: ['catalogs', 'list'], handler: 'commandCatalogsList', tier: 'online', description: 'List action catalogs' },
|
|
225
203
|
{
|
|
226
204
|
path: ['credits', 'balance'],
|
package/src/commands/prompt.mjs
CHANGED
|
@@ -6,16 +6,15 @@ async function commandPrompt(ctx, flags, capabilities, promptTokens) {
|
|
|
6
6
|
if (!prompt) {
|
|
7
7
|
throw new Error('Missing prompt text. Use: thirdfy-agent prompt "<text>"');
|
|
8
8
|
}
|
|
9
|
-
// Jeff rail: deterministic wrapper around existing run contract.
|
|
10
9
|
printEnvelope({
|
|
11
10
|
success: true,
|
|
12
11
|
code: 'PROMPT_RECEIVED',
|
|
13
|
-
message: 'Prompt captured; execute with `
|
|
12
|
+
message: 'Prompt captured; execute with `run` using --run-mode.',
|
|
14
13
|
data: {
|
|
15
14
|
prompt,
|
|
16
15
|
suggestedCommands: [
|
|
17
|
-
'thirdfy-agent
|
|
18
|
-
'thirdfy-agent
|
|
16
|
+
'thirdfy-agent run --run-mode self --agent-api-key ... --action ... --params ...',
|
|
17
|
+
'thirdfy-agent run --run-mode hybrid --agent-api-key ... --action ... --params ...',
|
|
19
18
|
],
|
|
20
19
|
},
|
|
21
20
|
meta: {
|
|
@@ -823,7 +823,7 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
|
|
|
823
823
|
],
|
|
824
824
|
supportedChains: [84532],
|
|
825
825
|
laneCompatibility:
|
|
826
|
-
'Base Sepolia shielded accounts (USDC, WETH, MetaMorpho vault shares). Catalog is flag-gated on the API host. Deposit is sent from the execution wallet; every other write is proven and relayed, so the execution wallet never appears: transfer, withdraw, private vault entry/exit (stealth earn/exit), private swap (stealth swap, best of Thirdfy routes and Uniswap v3, fresh burner per trade) and burner sweep. The regular swap takes private: true for the same private swap. Writes are capped at 5 USD; the sweep has no cap. Private writes bill the write_private tier
|
|
826
|
+
'Base Sepolia shielded accounts (USDC, WETH, MetaMorpho vault shares). Catalog is flag-gated on the API host. Deposit is sent from the execution wallet; every other write is proven and relayed, so the execution wallet never appears: transfer, withdraw, private vault entry/exit (stealth earn/exit), private swap (stealth swap, best of Thirdfy routes and Uniswap v3, fresh burner per trade) and burner sweep. The regular swap takes private: true for the same private swap. Writes are capped at 5 USD; the sweep has no cap. Private writes bill the write_private credit tier; any privacy fee is reported as privacyFee (0 at launch). Responses include privacyNotes.',
|
|
827
827
|
example:
|
|
828
828
|
'thirdfy-agent run --action get_bermuda_setup_status --params \'{"chainId":84532}\' --provider bermuda --json',
|
|
829
829
|
};
|