@arcdot/agent 0.1.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/README.md +67 -0
- package/bin/arcdot.mjs +2 -0
- package/dist/cli.js +685 -0
- package/dist/cli.js.map +1 -0
- package/dist/index.cjs +678 -0
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.cts +204 -0
- package/dist/index.d.ts +204 -0
- package/dist/index.js +633 -0
- package/dist/index.js.map +1 -0
- package/package.json +64 -0
package/README.md
ADDED
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
# @arcdot/agent
|
|
2
|
+
|
|
3
|
+
Buyer agent client for **arcdot.** — local wallet, auto-settle on Arc, MCP proxy for Cursor.
|
|
4
|
+
|
|
5
|
+
**Buyer keys never leave your machine.** The arcdot. server does not hold or spend your USDC.
|
|
6
|
+
|
|
7
|
+
## Install
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
# one-shot CLI
|
|
11
|
+
npx --yes @arcdot/agent wallet create
|
|
12
|
+
|
|
13
|
+
# as a dependency
|
|
14
|
+
npm install @arcdot/agent
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
From this monorepo (contributors):
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
cd packages/arcdot-agent && npm install && npm run build && npm link
|
|
21
|
+
arcdot wallet create
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
## Quick start
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
# 1) Create a dedicated agent wallet (saved to ~/.arcdot/wallet.json)
|
|
28
|
+
npx --yes @arcdot/agent wallet create
|
|
29
|
+
|
|
30
|
+
# 2) Fund the printed address with native USDC on Arc Mainnet (chain 5042)
|
|
31
|
+
|
|
32
|
+
# 3a) Cursor / IDE — local MCP proxy (auto-pays on tool calls)
|
|
33
|
+
# mcp.json:
|
|
34
|
+
# {
|
|
35
|
+
# "mcpServers": {
|
|
36
|
+
# "arcdot": {
|
|
37
|
+
# "command": "npx",
|
|
38
|
+
# "args": ["--yes", "@arcdot/agent", "mcp", "--origin", "https://YOUR_HOST"]
|
|
39
|
+
# }
|
|
40
|
+
# }
|
|
41
|
+
# }
|
|
42
|
+
|
|
43
|
+
# 3b) Or unlock from the CLI
|
|
44
|
+
npx --yes @arcdot/agent unlock \
|
|
45
|
+
--origin https://YOUR_HOST --service quick-brief --prompt "Hi"
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
## SDK
|
|
49
|
+
|
|
50
|
+
```ts
|
|
51
|
+
import { createArcdotAgent } from "@arcdot/agent";
|
|
52
|
+
|
|
53
|
+
const agent = await createArcdotAgent({ origin: "https://YOUR_HOST" });
|
|
54
|
+
await agent.unlock({ service: "quick-brief", input: { prompt: "Hi" } });
|
|
55
|
+
await agent.callMcpTool("arcdot_quick_brief", { prompt: "Hi" });
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
## Env
|
|
59
|
+
|
|
60
|
+
| Variable | Meaning |
|
|
61
|
+
|----------|---------|
|
|
62
|
+
| `ARCDOT_ORIGIN` | Default host |
|
|
63
|
+
| `ARCDOT_PRIVATE_KEY` | Override wallet file |
|
|
64
|
+
| `AGENT_PRIVATE_KEY` | Alias |
|
|
65
|
+
| `ARC_RPC_URL` | Arc RPC |
|
|
66
|
+
| `ARCDOT_GATEWAY` | Gateway address override |
|
|
67
|
+
| `ARCDOT_HOME` | Config directory (default `~/.arcdot`) |
|
package/bin/arcdot.mjs
ADDED