@tangle-network/sandbox-cli 0.8.3-develop.20260623200213.63e05e9 → 0.8.3
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 +101 -16
- package/SKILL.md +108 -29
- package/dist/index.mjs +22 -12
- package/hub-reference.md +46 -40
- package/package.json +8 -5
package/hub-reference.md
CHANGED
|
@@ -65,9 +65,9 @@ Anywhere a command takes a connection (`--connection`, `connections revoke`,
|
|
|
65
65
|
`agent --connection`), you may pass a raw connection id (`hubconn_...`) or a
|
|
66
66
|
human reference instead:
|
|
67
67
|
|
|
68
|
-
- `<provider
|
|
68
|
+
- `<provider>`, for example `github`, resolves when you hold exactly one connection
|
|
69
69
|
for that provider.
|
|
70
|
-
- `<provider>:<account
|
|
70
|
+
- `<provider>:<account>`, for example `gmail:alice@example.com`, disambiguates when
|
|
71
71
|
you hold several connections for one provider (matches `accountDisplay` or
|
|
72
72
|
`displayName`).
|
|
73
73
|
|
|
@@ -75,7 +75,7 @@ A reference resolves against `tangle hub connections`; revoked connections are
|
|
|
75
75
|
skipped. If it matches no connection, or more than one, the CLI fails loud and
|
|
76
76
|
lists the candidates so you can pass an id or `provider:account`. Raw ids never
|
|
77
77
|
contact the hub for resolution. The `agent --connection` head is followed by
|
|
78
|
-
`:capabilities`, so it accepts a provider or an id but not `provider:account
|
|
78
|
+
`:capabilities`, so it accepts a provider or an id but not `provider:account`;
|
|
79
79
|
use an id when a provider is ambiguous there.
|
|
80
80
|
|
|
81
81
|
### OAuth Connect
|
|
@@ -132,10 +132,10 @@ tangle hub tools search "github issues" --provider github --json
|
|
|
132
132
|
{
|
|
133
133
|
"tools": [
|
|
134
134
|
{
|
|
135
|
-
"path": "github.issues.
|
|
135
|
+
"path": "github.issues.search",
|
|
136
136
|
"providerId": "github",
|
|
137
|
-
"title": "
|
|
138
|
-
"description": "
|
|
137
|
+
"title": "Search issues and pull requests",
|
|
138
|
+
"description": "Search GitHub issues and pull requests with a query",
|
|
139
139
|
"connectionRequired": true,
|
|
140
140
|
"connectionStatus": "connected",
|
|
141
141
|
"requiredConnectionProviderId": "github",
|
|
@@ -150,33 +150,35 @@ Tool `policyState`: `allow`, `ask`, `deny`, `unknown`.
|
|
|
150
150
|
### Tool Describe
|
|
151
151
|
|
|
152
152
|
```bash
|
|
153
|
-
tangle hub tools describe github.issues.
|
|
153
|
+
tangle hub tools describe github.issues.search --json
|
|
154
154
|
```
|
|
155
155
|
|
|
156
156
|
```json
|
|
157
157
|
{
|
|
158
158
|
"tool": {
|
|
159
|
-
"path": "github.issues.
|
|
159
|
+
"path": "github.issues.search",
|
|
160
160
|
"providerId": "github",
|
|
161
|
-
"title": "
|
|
162
|
-
"description": "
|
|
161
|
+
"title": "Search issues and pull requests",
|
|
162
|
+
"description": "Search GitHub issues and pull requests with a query",
|
|
163
163
|
"connectionRequired": true,
|
|
164
164
|
"connectionStatus": "connected",
|
|
165
165
|
"requiredConnectionProviderId": "github",
|
|
166
166
|
"policyState": "ask",
|
|
167
167
|
"inputSchema": {
|
|
168
168
|
"type": "object",
|
|
169
|
-
"required": ["
|
|
169
|
+
"required": ["q"],
|
|
170
170
|
"properties": {
|
|
171
|
-
"
|
|
172
|
-
"
|
|
173
|
-
"
|
|
174
|
-
"labels": { "type": "array", "items": { "type": "string" } }
|
|
171
|
+
"q": { "type": "string" },
|
|
172
|
+
"sort": { "type": "string", "enum": ["comments", "created", "updated"] },
|
|
173
|
+
"order": { "type": "string", "enum": ["asc", "desc"] }
|
|
175
174
|
}
|
|
176
175
|
},
|
|
177
176
|
"outputSchema": {
|
|
178
|
-
"type": "
|
|
179
|
-
"
|
|
177
|
+
"type": "object",
|
|
178
|
+
"properties": {
|
|
179
|
+
"total_count": { "type": "integer" },
|
|
180
|
+
"items": { "type": "array", "items": { "$ref": "#/components/schemas/Issue" } }
|
|
181
|
+
}
|
|
180
182
|
}
|
|
181
183
|
}
|
|
182
184
|
}
|
|
@@ -185,20 +187,23 @@ tangle hub tools describe github.issues.listIssues --json
|
|
|
185
187
|
### Tool Call / Exec
|
|
186
188
|
|
|
187
189
|
```bash
|
|
188
|
-
tangle hub call github issues
|
|
189
|
-
tangle hub exec github.issues.
|
|
190
|
+
tangle hub call github issues search '{"q":"repo:tangle-network/agent-dev-container is:issue"}'
|
|
191
|
+
tangle hub exec github.issues.search '{"q":"repo:tangle-network/agent-dev-container is:issue"}'
|
|
190
192
|
```
|
|
191
193
|
|
|
192
194
|
```json
|
|
193
195
|
{
|
|
194
|
-
"result":
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
196
|
+
"result": {
|
|
197
|
+
"total_count": 1,
|
|
198
|
+
"items": [
|
|
199
|
+
{
|
|
200
|
+
"number": 42,
|
|
201
|
+
"title": "Fix auth middleware",
|
|
202
|
+
"state": "open",
|
|
203
|
+
"createdAt": "2026-06-01T10:00:00Z"
|
|
204
|
+
}
|
|
205
|
+
]
|
|
206
|
+
}
|
|
202
207
|
}
|
|
203
208
|
```
|
|
204
209
|
|
|
@@ -301,23 +306,23 @@ tangle hub permissions set --connection hubconn_github_a1 --action github.issues
|
|
|
301
306
|
|
|
302
307
|
### Granting connections to an agent
|
|
303
308
|
|
|
304
|
-
`tangle agent prompt
|
|
305
|
-
|
|
306
|
-
|
|
309
|
+
`tangle agent prompt` exposes granted hub connections to the agent as MCP tools
|
|
310
|
+
with `--connection <spec>` (repeatable). Three modes, from least to most
|
|
311
|
+
privilege:
|
|
307
312
|
|
|
308
313
|
The spec head is a connection id or a provider name (see
|
|
309
314
|
[Connection references](#connection-references)).
|
|
310
315
|
|
|
311
316
|
```bash
|
|
312
317
|
# Least privilege (recommended): the agent sees exactly these tool paths.
|
|
313
|
-
tangle agent
|
|
314
|
-
--connection github:github.issues.
|
|
318
|
+
tangle agent prompt sbx_123 "triage issues" \
|
|
319
|
+
--connection github:github.issues.search,github.issues.create
|
|
315
320
|
|
|
316
321
|
# All capabilities of one connection (by id when a provider is ambiguous).
|
|
317
|
-
tangle agent
|
|
322
|
+
tangle agent prompt sbx_123 "triage issues" --connection hubconn_github_a1:*
|
|
318
323
|
|
|
319
324
|
# All capabilities of every connected provider (broadest).
|
|
320
|
-
tangle agent
|
|
325
|
+
tangle agent prompt sbx_123 "do the thing" --connection '*:*'
|
|
321
326
|
```
|
|
322
327
|
|
|
323
328
|
A grant controls what the agent can **see**. Each call is still policy-gated
|
|
@@ -332,11 +337,12 @@ actions still prompt. The grant is persistent and scoped to the named
|
|
|
332
337
|
connections only.
|
|
333
338
|
|
|
334
339
|
```bash
|
|
335
|
-
tangle agent
|
|
340
|
+
tangle agent prompt sbx_123 "file the weekly report" \
|
|
336
341
|
--connection github:* --allow-writes
|
|
337
342
|
```
|
|
338
343
|
|
|
339
|
-
Revert the bulk grant at any time
|
|
344
|
+
Revert the bulk grant at any time.
|
|
345
|
+
It deletes only the rows `--allow-writes`
|
|
340
346
|
created, leaving manual `permissions set` decisions intact:
|
|
341
347
|
|
|
342
348
|
```bash
|
|
@@ -407,13 +413,13 @@ tangle hub status --json
|
|
|
407
413
|
# 3. Discover
|
|
408
414
|
tangle hub tools sources --json
|
|
409
415
|
tangle hub tools search "issues" --provider github --json
|
|
410
|
-
tangle hub tools describe github.issues.
|
|
416
|
+
tangle hub tools describe github.issues.search --json
|
|
411
417
|
|
|
412
418
|
# 4. Call with auto-approve
|
|
413
|
-
tangle hub exec github.issues.
|
|
419
|
+
tangle hub exec github.issues.search '{"q":"repo:tangle-network/agent-dev-container is:issue"}' --approve
|
|
414
420
|
|
|
415
421
|
# 5. Set permanent policy
|
|
416
|
-
tangle hub permissions set --connection hubconn_github_a1 --action github.issues.
|
|
422
|
+
tangle hub permissions set --connection hubconn_github_a1 --action github.issues.search --decision allow
|
|
417
423
|
```
|
|
418
424
|
|
|
419
425
|
### Batch Approvals
|
|
@@ -435,7 +441,7 @@ done
|
|
|
435
441
|
tangle hub permissions list --connection hubconn_github_a1 --json
|
|
436
442
|
|
|
437
443
|
# Set all read actions to allow, write actions to ask
|
|
438
|
-
tangle hub permissions set --connection hubconn_github_a1 --action github.issues.
|
|
444
|
+
tangle hub permissions set --connection hubconn_github_a1 --action github.issues.search --decision allow
|
|
439
445
|
tangle hub permissions set --connection hubconn_github_a1 --action github.issues.create --decision ask
|
|
440
446
|
```
|
|
441
447
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tangle-network/sandbox-cli",
|
|
3
|
-
"version": "0.8.3
|
|
3
|
+
"version": "0.8.3",
|
|
4
4
|
"description": "CLI for Tangle Sandbox operations",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -15,15 +15,17 @@
|
|
|
15
15
|
"hub-reference.md"
|
|
16
16
|
],
|
|
17
17
|
"dependencies": {
|
|
18
|
-
"@tangle-network/agent-
|
|
19
|
-
"@tangle-network/agent-
|
|
18
|
+
"@tangle-network/agent-core": "0.8.0",
|
|
19
|
+
"@tangle-network/agent-eval": "0.145.11",
|
|
20
|
+
"@tangle-network/agent-interface": "0.52.0",
|
|
21
|
+
"@tangle-network/agent-runtime": "0.135.0",
|
|
20
22
|
"chalk": "^5.4.1",
|
|
21
23
|
"commander": "12.1.0",
|
|
22
24
|
"dotenv": "17.2.3",
|
|
23
25
|
"ora": "^9.4.0",
|
|
24
26
|
"ws": "^8.20.0",
|
|
25
|
-
"@tangle-network/hub-sdk": "0.
|
|
26
|
-
"@tangle-network/sandbox": "0.
|
|
27
|
+
"@tangle-network/hub-sdk": "0.8.8",
|
|
28
|
+
"@tangle-network/sandbox": "0.26.2"
|
|
27
29
|
},
|
|
28
30
|
"devDependencies": {
|
|
29
31
|
"@types/node": "25.6.0",
|
|
@@ -54,6 +56,7 @@
|
|
|
54
56
|
"scripts": {
|
|
55
57
|
"build": "tsdown",
|
|
56
58
|
"dev": "tsx src/index.ts",
|
|
59
|
+
"check-types": "tsc --noEmit",
|
|
57
60
|
"verify-dist": "bash scripts/verify-dist.sh",
|
|
58
61
|
"test": "vitest run",
|
|
59
62
|
"test:watch": "vitest watch",
|