@tangle-network/sandbox-cli 0.9.2-develop.20260626173348.976a381 → 0.9.3-develop.20260627012805.bf68a85
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 +1 -1
- package/SKILL.md +5 -5
- package/hub-reference.md +34 -29
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -116,7 +116,7 @@ tangle agent task sbx_123 "Fix the failing tests"
|
|
|
116
116
|
# grant hub connections to the agent (see hub-reference.md for the 3 modes).
|
|
117
117
|
# the connection is an id or a provider name (resolved via `tangle hub connections`).
|
|
118
118
|
tangle agent task sbx_123 "triage issues" \
|
|
119
|
-
--connection github:github.issues.
|
|
119
|
+
--connection github:github.issues.search,github.issues.create
|
|
120
120
|
tangle agent task sbx_123 "file the report" --connection github:* --allow-writes
|
|
121
121
|
|
|
122
122
|
# state and operations
|
package/SKILL.md
CHANGED
|
@@ -98,7 +98,7 @@ tangle hub tools sources --json
|
|
|
98
98
|
tangle hub tools search "github issues" --provider github --json
|
|
99
99
|
|
|
100
100
|
# Describe a tool to see input/output schemas
|
|
101
|
-
tangle hub tools describe github.issues.
|
|
101
|
+
tangle hub tools describe github.issues.search --json
|
|
102
102
|
```
|
|
103
103
|
|
|
104
104
|
### Tool Execution
|
|
@@ -107,8 +107,8 @@ Two equivalent commands — `call` and `exec`:
|
|
|
107
107
|
|
|
108
108
|
```bash
|
|
109
109
|
# Basic call: <path tokens...> <json-input>
|
|
110
|
-
tangle hub call github issues
|
|
111
|
-
tangle hub exec github.issues.
|
|
110
|
+
tangle hub call github issues search '{"q":"repo:tangle-network/agent-dev-container is:issue"}'
|
|
111
|
+
tangle hub exec github.issues.search '{"q":"repo:tangle-network/agent-dev-container is:issue"}'
|
|
112
112
|
|
|
113
113
|
# With explicit connection
|
|
114
114
|
tangle hub call github issues createIssue '{"owner":"foo","repo":"bar","title":"Fix bug"}' --connection conn_xxx
|
|
@@ -125,7 +125,7 @@ tangle hub approvals approve <approval-id>
|
|
|
125
125
|
tangle hub approvals deny <approval-id>
|
|
126
126
|
|
|
127
127
|
# Set policy to always allow (skip future approvals)
|
|
128
|
-
tangle hub permissions set --connection conn_xxx --action github.issues.
|
|
128
|
+
tangle hub permissions set --connection conn_xxx --action github.issues.search --decision allow
|
|
129
129
|
|
|
130
130
|
# Set policy to always deny (block tool)
|
|
131
131
|
tangle hub permissions set --connection conn_xxx --action github.issues.deleteIssue --decision deny
|
|
@@ -287,7 +287,7 @@ tangle permissions add <sandboxId> --userId <userId> --role editor
|
|
|
287
287
|
| Goal | Commands |
|
|
288
288
|
|------|----------|
|
|
289
289
|
| Spin up sandbox, run agent | `tangle sandbox create --name X` → `tangle agent task <id> "..."` |
|
|
290
|
-
| Connect GitHub, read issues | `tangle hub connect github` → `tangle hub tools search "issues" --provider github` → `tangle hub call github issues
|
|
290
|
+
| Connect GitHub, read issues | `tangle hub connect github` → `tangle hub tools search "issues" --provider github` → `tangle hub call github issues search '{"q":"repo:X/Y is:issue"}'` |
|
|
291
291
|
| Push code from sandbox to GitHub | `tangle hub connect github` → `tangle git add <id> files` → `tangle git commit <id> -m "msg"` → `tangle git push <id>` |
|
|
292
292
|
| Save and restore state | `tangle snapshot create <id>` → ...work... → `tangle snapshot revert <id> <snap-id>` |
|
|
293
293
|
| Set secret for agent use | `tangle secret create GITHUB_TOKEN "..."` → agent reads via `process.env.GITHUB_TOKEN` |
|
package/hub-reference.md
CHANGED
|
@@ -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
|
|
|
@@ -311,7 +316,7 @@ The spec head is a connection id or a provider name (see
|
|
|
311
316
|
```bash
|
|
312
317
|
# Least privilege (recommended): the agent sees exactly these tool paths.
|
|
313
318
|
tangle agent task sbx_123 "triage issues" \
|
|
314
|
-
--connection github:github.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
322
|
tangle agent task sbx_123 "triage issues" --connection hubconn_github_a1:*
|
|
@@ -407,13 +412,13 @@ tangle hub status --json
|
|
|
407
412
|
# 3. Discover
|
|
408
413
|
tangle hub tools sources --json
|
|
409
414
|
tangle hub tools search "issues" --provider github --json
|
|
410
|
-
tangle hub tools describe github.issues.
|
|
415
|
+
tangle hub tools describe github.issues.search --json
|
|
411
416
|
|
|
412
417
|
# 4. Call with auto-approve
|
|
413
|
-
tangle hub exec github.issues.
|
|
418
|
+
tangle hub exec github.issues.search '{"q":"repo:tangle-network/agent-dev-container is:issue"}' --approve
|
|
414
419
|
|
|
415
420
|
# 5. Set permanent policy
|
|
416
|
-
tangle hub permissions set --connection hubconn_github_a1 --action github.issues.
|
|
421
|
+
tangle hub permissions set --connection hubconn_github_a1 --action github.issues.search --decision allow
|
|
417
422
|
```
|
|
418
423
|
|
|
419
424
|
### Batch Approvals
|
|
@@ -435,7 +440,7 @@ done
|
|
|
435
440
|
tangle hub permissions list --connection hubconn_github_a1 --json
|
|
436
441
|
|
|
437
442
|
# Set all read actions to allow, write actions to ask
|
|
438
|
-
tangle hub permissions set --connection hubconn_github_a1 --action github.issues.
|
|
443
|
+
tangle hub permissions set --connection hubconn_github_a1 --action github.issues.search --decision allow
|
|
439
444
|
tangle hub permissions set --connection hubconn_github_a1 --action github.issues.create --decision ask
|
|
440
445
|
```
|
|
441
446
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tangle-network/sandbox-cli",
|
|
3
|
-
"version": "0.9.
|
|
3
|
+
"version": "0.9.3-develop.20260627012805.bf68a85",
|
|
4
4
|
"description": "CLI for Tangle Sandbox operations",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -23,8 +23,8 @@
|
|
|
23
23
|
"dotenv": "17.2.3",
|
|
24
24
|
"ora": "^9.4.0",
|
|
25
25
|
"ws": "^8.20.0",
|
|
26
|
-
"@tangle-network/
|
|
27
|
-
"@tangle-network/
|
|
26
|
+
"@tangle-network/hub-sdk": "0.2.2",
|
|
27
|
+
"@tangle-network/sandbox": "0.9.3-develop.20260627012805.bf68a85"
|
|
28
28
|
},
|
|
29
29
|
"devDependencies": {
|
|
30
30
|
"@types/node": "25.6.0",
|