motebit 1.9.0 → 1.11.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 +57 -10
- package/dist/index.js +92486 -90345
- package/package.json +16 -16
- package/schema/motebit-yaml-v1.json +53 -47
package/README.md
CHANGED
|
@@ -32,6 +32,9 @@ motebit delegate "review owner/repo#42" # Discover worker → submit → get re
|
|
|
32
32
|
--target <motebit-id> # Skip discovery, delegate to specific agent
|
|
33
33
|
--budget 10 # Max spend in USD
|
|
34
34
|
--plan # Decompose into steps, multi-agent orchestration
|
|
35
|
+
--sovereign # Pay agents directly via Solana wallet (no relay settlement)
|
|
36
|
+
--pay-new-agents # Allow paid P2P delegation to agents with no trust history
|
|
37
|
+
# (cold-start opt-in; default off)
|
|
35
38
|
|
|
36
39
|
# Account
|
|
37
40
|
motebit balance # Show balance + recent transactions
|
|
@@ -43,17 +46,46 @@ motebit run --price 0.50 # Daemon mode — accept tasks at $0.50/tas
|
|
|
43
46
|
motebit serve --price 0.50 # MCP server mode — same pricing, HTTP transport
|
|
44
47
|
```
|
|
45
48
|
|
|
49
|
+
## Standing delegations
|
|
50
|
+
|
|
51
|
+
Signed, revocable spend grants — scoped capabilities, a lifetime ceiling, short lifetimes by design. See [spec/standing-delegation-v1.md](https://github.com/motebit/motebit/blob/main/spec/standing-delegation-v1.md).
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
motebit grant create # Mint a standing-delegation grant
|
|
55
|
+
--scope <caps> # Capabilities the grant covers
|
|
56
|
+
--subject <s> # Who may spend under it
|
|
57
|
+
--lifetime-usd <n> # Hard lifetime ceiling in USD
|
|
58
|
+
--days 7 # Grant lifetime (default 7, max 30 — money grants live short)
|
|
59
|
+
motebit grant list # List stored grants (state, subject, ceiling)
|
|
60
|
+
motebit grant show <id> # Show a grant + its tick schedule
|
|
61
|
+
motebit grant revoke <id> # Sign the terminal revocation + propagate to the relay
|
|
62
|
+
```
|
|
63
|
+
|
|
46
64
|
## Identity & trust
|
|
47
65
|
|
|
48
66
|
```bash
|
|
67
|
+
motebit id # Show your identity (motebit_id, did:key, public key)
|
|
68
|
+
motebit wallet # Show your sovereign Solana wallet (address, USDC balance)
|
|
69
|
+
motebit wallet swap <sol> # Convert SOL → USDC working capital
|
|
49
70
|
motebit export # Export signed identity bundle (motebit.md)
|
|
50
71
|
motebit verify motebit.md # Verify an identity file signature
|
|
51
72
|
motebit rotate --reason "scheduled" # Rotate keypair with succession chain
|
|
73
|
+
motebit seed # Recovery-seed backup status
|
|
74
|
+
motebit seed reveal # Print the seed once (passphrase-gated) for paper
|
|
75
|
+
motebit keychain enroll # Opt-in: store the passphrase in the macOS login
|
|
76
|
+
# Keychain (your macOS account is the protection —
|
|
77
|
+
# not biometrics; never replaces the seed backup)
|
|
78
|
+
motebit restore [motebit.md] # Recover an identity — full-bundle from a motebit.md,
|
|
79
|
+
# or seed-only (re-derives a sovereign id); also
|
|
80
|
+
# resets a forgotten passphrase when the seed
|
|
81
|
+
# matches the key already on this machine
|
|
52
82
|
motebit register # Register identity with relay
|
|
53
83
|
motebit credentials # List earned credentials
|
|
54
84
|
motebit ledger <goal-id> # Show execution ledger for a goal
|
|
55
85
|
```
|
|
56
86
|
|
|
87
|
+
No operator can recover your key — the seed is yours. Record it with `motebit seed reveal` before you need it; `motebit restore` is the door it opens.
|
|
88
|
+
|
|
57
89
|
## Daemon & server
|
|
58
90
|
|
|
59
91
|
```bash
|
|
@@ -72,8 +104,13 @@ motebit serve --identity motebit.md # MCP server — expose tools via HTTP/stdi
|
|
|
72
104
|
motebit goal add "Research X" --every 6h # Scheduled goal
|
|
73
105
|
motebit goal list # List goals with status
|
|
74
106
|
motebit goal outcomes <goal-id> # Execution history
|
|
107
|
+
motebit goal pause <goal-id> # Pause a scheduled goal
|
|
108
|
+
motebit goal resume <goal-id> # Resume a paused goal
|
|
109
|
+
motebit goal remove <goal-id> # Remove a scheduled goal
|
|
75
110
|
motebit approvals list # Pending tool call approvals
|
|
111
|
+
motebit approvals show <id> # Show approval detail
|
|
76
112
|
motebit approvals approve <id> # Approve a pending call
|
|
113
|
+
motebit approvals deny <id> # Deny a pending call [--reason <text>]
|
|
77
114
|
```
|
|
78
115
|
|
|
79
116
|
## Federation
|
|
@@ -91,18 +128,20 @@ motebit federation mesh <url1> <url2> ... # Pair-wise peer N relays
|
|
|
91
128
|
User-installable procedural-knowledge files (agentskills.io-compatible) with
|
|
92
129
|
motebit's sovereign extensions: cryptographic provenance, sensitivity-tiered
|
|
93
130
|
loading, hardware-attestation gating. Install is permissive; auto-load is
|
|
94
|
-
provenance-gated. See
|
|
131
|
+
provenance-gated. See [spec/skills-v1.md](https://github.com/motebit/motebit/blob/main/spec/skills-v1.md).
|
|
95
132
|
|
|
96
133
|
```bash
|
|
97
134
|
motebit skills list # List installed skills with status badges
|
|
98
|
-
motebit skills install <
|
|
135
|
+
motebit skills install <dir | did:key:…/name@version> # Install from a local directory or the registry
|
|
99
136
|
--force # Overwrite existing version
|
|
137
|
+
motebit skills publish <directory> # Sign a skill directory with your identity key + submit to the relay registry
|
|
100
138
|
motebit skills enable <name> # Enable for selection (default after install)
|
|
101
139
|
motebit skills disable <name> # Skip in selection without removing
|
|
102
140
|
motebit skills trust <name> # Operator-attest an unsigned skill — auto-load eligible
|
|
103
141
|
motebit skills untrust <name> # Revoke operator-attested trust
|
|
104
142
|
motebit skills verify <name> # Re-verify the envelope signature
|
|
105
143
|
motebit skills remove <name> # Delete + emit audit event
|
|
144
|
+
motebit skills audit [name] # Show the audit log (trust grants, removals, consent) [--event-type=…] [--limit=N] [--json]
|
|
106
145
|
motebit skills run-script <skill> <script> [args...] # Phase 2 — gated script execution
|
|
107
146
|
--auto-approve # Skip the prompt (still records the audit row)
|
|
108
147
|
```
|
|
@@ -125,10 +164,17 @@ subdirectories. Audit events (trust grants, removals) append to
|
|
|
125
164
|
|
|
126
165
|
## Providers
|
|
127
166
|
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
|
131
|
-
|
|
|
167
|
+
The intelligence is pluggable: a motebit's identity, memory, and trust persist independently of its model provider. Configure an inference source:
|
|
168
|
+
|
|
169
|
+
| Provider | Setup |
|
|
170
|
+
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
171
|
+
| **Anthropic** | `export ANTHROPIC_API_KEY=sk-ant-...` (default) |
|
|
172
|
+
| **OpenAI** | `export OPENAI_API_KEY=sk-...`, `motebit --provider openai` |
|
|
173
|
+
| **Google** | `export GOOGLE_API_KEY=AIza...`, `motebit --provider google` |
|
|
174
|
+
| **Groq** | `export GROQ_API_KEY=gsk_...`, `motebit --provider groq` |
|
|
175
|
+
| **DeepSeek** | `export DEEPSEEK_API_KEY=sk-...`, `motebit --provider deepseek` |
|
|
176
|
+
| **Local server** | [Ollama](https://ollama.ai), LM Studio, llama.cpp, vLLM, or any OpenAI-compatible endpoint — `motebit --provider local-server` (alias: `ollama`); no API key needed |
|
|
177
|
+
| **Motebit Cloud** | `motebit --provider proxy` — subscription via the relay |
|
|
132
178
|
|
|
133
179
|
## Troubleshooting
|
|
134
180
|
|
|
@@ -146,22 +192,23 @@ See [docs.motebit.com](https://docs.motebit.com) for full documentation.
|
|
|
146
192
|
|
|
147
193
|
## How it ships
|
|
148
194
|
|
|
149
|
-
`motebit` is the bundled reference runtime — relay, policy engine, sync engine, MCP server, and wallet adapters all inlined into a single
|
|
195
|
+
`motebit` is the bundled reference runtime — relay, policy engine, sync engine, MCP server, and wallet adapters all inlined into a single package at build time. The CLI is its primary operator-facing surface; there are no internal package versions to track.
|
|
150
196
|
|
|
151
197
|
**The public promise of `motebit@1.0` is that operator-facing surface — subcommands, flags, exit codes, `~/.motebit/` layout, relay HTTP routes, MCP server tool list — not the internal workspace package graph.** Breaking changes to that surface require a major bump.
|
|
152
198
|
|
|
153
|
-
For the wire-format contract third parties build against, see the Apache-2.0 packages: [`@motebit/protocol`](https://www.npmjs.com/package/@motebit/protocol), [`@motebit/crypto`](https://www.npmjs.com/package/@motebit/crypto), [`@motebit/sdk`](https://www.npmjs.com/package/@motebit/sdk), and the [
|
|
199
|
+
For the wire-format contract third parties build against, see the Apache-2.0 packages: [`@motebit/protocol`](https://www.npmjs.com/package/@motebit/protocol), [`@motebit/crypto`](https://www.npmjs.com/package/@motebit/crypto), [`@motebit/sdk`](https://www.npmjs.com/package/@motebit/sdk), and the [34 open specs](https://github.com/motebit/motebit/tree/main/spec). Those promise stability independently and are gated by `check-api-surface`.
|
|
154
200
|
|
|
155
201
|
## Related
|
|
156
202
|
|
|
157
203
|
- [`@motebit/protocol`](https://www.npmjs.com/package/@motebit/protocol) — wire-format types (Apache-2.0, zero deps)
|
|
158
204
|
- [`@motebit/sdk`](https://www.npmjs.com/package/@motebit/sdk) — developer contract for building Motebit-powered agents
|
|
159
205
|
- [`@motebit/crypto`](https://www.npmjs.com/package/@motebit/crypto) — signing and verification primitives (Apache-2.0, zero deps)
|
|
206
|
+
- [`@motebit/verify`](https://www.npmjs.com/package/@motebit/verify) — the `motebit-verify` CLI a human installs to check any signed artifact (Apache-2.0)
|
|
160
207
|
- [`@motebit/verifier`](https://www.npmjs.com/package/@motebit/verifier) — offline third-party verifier library (Apache-2.0)
|
|
161
208
|
- [`create-motebit`](https://www.npmjs.com/package/create-motebit) — scaffold a signed agent identity
|
|
162
209
|
|
|
163
210
|
## License
|
|
164
211
|
|
|
165
|
-
|
|
212
|
+
Business Source License 1.1 (BUSL-1.1) — see [LICENSE](./LICENSE).
|
|
166
213
|
|
|
167
|
-
"Motebit" is a trademark. The
|
|
214
|
+
"Motebit" is a trademark. The Business Source License grants rights to this software, not to any Motebit trademarks, logos, or branding. You may not use Motebit branding in a way that suggests endorsement or affiliation without written permission.
|