@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/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>` e.g. `github`, resolves when you hold exactly one connection
68
+ - `<provider>`, for example `github`, resolves when you hold exactly one connection
69
69
  for that provider.
70
- - `<provider>:<account>` e.g. `gmail:alice@example.com`, disambiguates when
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.listIssues",
135
+ "path": "github.issues.search",
136
136
  "providerId": "github",
137
- "title": "List GitHub Issues",
138
- "description": "List issues in a repository",
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.listIssues --json
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.listIssues",
159
+ "path": "github.issues.search",
160
160
  "providerId": "github",
161
- "title": "List GitHub Issues",
162
- "description": "List issues in a repository",
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": ["owner", "repo"],
169
+ "required": ["q"],
170
170
  "properties": {
171
- "owner": { "type": "string" },
172
- "repo": { "type": "string" },
173
- "state": { "type": "string", "enum": ["open", "closed", "all"] },
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": "array",
179
- "items": { "$ref": "#/components/schemas/Issue" }
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 listIssues '{"owner":"tangle-network","repo":"agent-dev-container"}'
189
- tangle hub exec github.issues.listIssues '{"owner":"tangle-network","repo":"agent-dev-container"}'
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
- "number": 42,
197
- "title": "Fix auth middleware",
198
- "state": "open",
199
- "createdAt": "2026-06-01T10:00:00Z"
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`/`tangle agent task` expose granted hub connections to the
305
- agent as MCP tools with `--connection <spec>` (repeatable). Three modes, from
306
- least to most privilege:
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 task sbx_123 "triage issues" \
314
- --connection github:github.issues.listIssues,github.issues.create
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 task sbx_123 "triage issues" --connection hubconn_github_a1:*
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 task sbx_123 "do the thing" --connection '*:*'
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 task sbx_123 "file the weekly report" \
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 — it deletes only the rows `--allow-writes`
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.listIssues --json
416
+ tangle hub tools describe github.issues.search --json
411
417
 
412
418
  # 4. Call with auto-approve
413
- tangle hub exec github.issues.listIssues '{"owner":"tangle-network","repo":"agent-dev-container"}' --approve
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.listIssues --decision allow
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.listIssues --decision allow
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-develop.20260623200213.63e05e9",
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-eval": "^0.99.0",
19
- "@tangle-network/agent-runtime": "^0.76.0",
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.2.2",
26
- "@tangle-network/sandbox": "0.8.3-develop.20260623200213.63e05e9"
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",