@mysten-incubation/sui-agent-pass 0.1.9 → 0.1.11
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 +4 -3
- package/deployments/mainnet.json +1 -0
- package/deployments/testnet.json +1 -0
- package/dist/describe.js +5 -2
- package/dist/domain.js +48 -20
- package/dist/explorer.js +16 -0
- package/dist/float.js +3 -1
- package/dist/mcp.js +22 -1
- package/dist/owner.js +3 -1
- package/dist/plugin.js +42 -9
- package/dist/server.js +2 -1
- package/dist/signer.js +8 -7
- package/dist/storage.js +13 -1
- package/docs/AGENT.md +6 -1
- package/docs/PLAYBOOK.md +21 -8
- package/package.json +3 -3
- package/skills/agent-pass/SKILL.md +21 -8
- package/web-dist/assets/{index-Bt0vwsup.js → index-7G6YmGOW.js} +62 -62
- package/web-dist/assets/{mount-D_hAnWmA.js → mount-62qnVZBM.js} +1 -1
- package/web-dist/deployments/mainnet.json +1 -0
- package/web-dist/deployments/testnet.json +1 -0
- package/web-dist/index.html +1 -1
|
@@ -83,14 +83,22 @@ the allowance back. A supply-and-withdraw or stake-and-unstake cycle costs the a
|
|
|
83
83
|
size lending and staking limits for the cycles the agent will run, and tell the owner when they
|
|
84
84
|
ask for something like "restake with a better validator".
|
|
85
85
|
|
|
86
|
-
**Term and gas.** `days` is the agent's term, 1 to
|
|
86
|
+
**Term and gas.** `days` is the agent's term, from 1 up to the network's `maxTermDays` in
|
|
87
|
+
`list_passes`. `gasSui` (default 0.05) is a stipend sent
|
|
87
88
|
to the agent key, outside the rules. `gasCapSui` (default 0.1) is a separate allowance the key
|
|
88
|
-
draws on to top up its gas, and `gasDailySui` (default a fifth of `gasCapSui`) its
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
89
|
+
draws on to top up its gas, and `gasDailySui` (default a fifth of `gasCapSui`) its limit per 24
|
|
90
|
+
hours from the first top-up. Call it that, not a limit per UTC day like the asset limits.
|
|
91
|
+
|
|
92
|
+
**What the owner needs.** Signing moves only the agent's gas stipend and pays the fee, so that is
|
|
93
|
+
all the owner must hold, in SUI. The caps are limits on what the rules may draw later, not money
|
|
94
|
+
needed now. Allowances draw only from the owner's address balance, never from coin objects; the
|
|
95
|
+
signature converts the owner's coin objects into that balance as far as each cap needs and they
|
|
96
|
+
have them, and the converted coins stay theirs. When a cap reaches past what the owner holds,
|
|
97
|
+
signing still works: each action runs while the balance covers it, and swap proceeds landing
|
|
98
|
+
there count right away, which is how a chain like TAKE to SUI to USDC funds its later legs. Pass
|
|
99
|
+
`owner` to `propose_authorization` when you know the address, and tell the owner about any
|
|
100
|
+
`warnings` it returns before they sign. An action refused because the balance was short is not
|
|
101
|
+
one of the owner's rules; say so.
|
|
94
102
|
|
|
95
103
|
Before you call anything, show the owner the rules you intend to propose as one short list and
|
|
96
104
|
ask for a yes, unless they already stated every rule explicitly.
|
|
@@ -130,6 +138,11 @@ Start with `session_info`. It returns:
|
|
|
130
138
|
- `directory`, `sdk` and `server`: the session directory, how to install and import the SDK,
|
|
131
139
|
and this server's version (after an upgrade the client must restart the server).
|
|
132
140
|
|
|
141
|
+
**Key alert.** When `list_passes` or `session_info` carries `keyAlert`, the chain shows
|
|
142
|
+
transactions from the agent key that this machine never signed: a copy of the key is in use
|
|
143
|
+
elsewhere. Stop acting, tell the owner at once with the digests, and offer `revoke_pass` so they
|
|
144
|
+
can stop the agent from the pass page.
|
|
145
|
+
|
|
133
146
|
**Updates.** When `server.update` is present in `list_passes` or `session_info`, a newer release
|
|
134
147
|
is out. Tell the owner once per conversation, with `server.update.command` and the reminder to
|
|
135
148
|
restart the agent afterwards, then carry on with the task; never run the command yourself.
|
|
@@ -177,7 +190,7 @@ enforcement. `submit` tops up your gas from the gas allowance when it runs low.
|
|
|
177
190
|
`@mysten/sui` following the guide, sign it with `sign_transaction` and execute it yourself. Every
|
|
178
191
|
spend takes the allowance object and a withdrawal input right after the pass. On this path gas is
|
|
179
192
|
yours: when the key holds under 0.01 SUI, draw on the gas allowance as the guide shows. That
|
|
180
|
-
allowance has its own cap and
|
|
193
|
+
allowance has its own cap and 24-hour limit and never touches the asset caps.
|
|
181
194
|
|
|
182
195
|
## 4. Report the state
|
|
183
196
|
|