@tcb-sandbox/cli 0.3.7
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/CHANGELOG.md +19 -0
- package/README.md +67 -0
- package/dist/bundled-docs.d.ts +769 -0
- package/dist/bundled-docs.js +528 -0
- package/dist/cli.d.ts +2 -0
- package/dist/cli.js +1234 -0
- package/dist/sdk-client.js +50 -0
- package/dist/serve.d.ts +13 -0
- package/dist/serve.js +197 -0
- package/dist/trw-embedded.js +2719 -0
- package/dist/trw-version.json +1 -0
- package/docs/README.md +13 -0
- package/docs/local-mode.md +76 -0
- package/docs/quick-start.md +82 -0
- package/docs/thin-client.md +100 -0
- package/package.json +49 -0
|
@@ -0,0 +1,528 @@
|
|
|
1
|
+
export const BUNDLED_API_DOCS = {
|
|
2
|
+
service: "remote-workspace",
|
|
3
|
+
protocol: "HTTP REST",
|
|
4
|
+
auth: {
|
|
5
|
+
required_header: "X-Cloudbase-Session-Id",
|
|
6
|
+
},
|
|
7
|
+
endpoints: {
|
|
8
|
+
health: "GET /health",
|
|
9
|
+
docs: "GET /api/docs",
|
|
10
|
+
tools: "POST /api/tools/{tool}",
|
|
11
|
+
},
|
|
12
|
+
tools: [
|
|
13
|
+
{
|
|
14
|
+
name: "read",
|
|
15
|
+
description: "Read file contents (line-numbered). Also lists directory contents.",
|
|
16
|
+
endpoint: "POST /api/tools/read",
|
|
17
|
+
input_schema: {
|
|
18
|
+
type: "object",
|
|
19
|
+
required: ["path"],
|
|
20
|
+
properties: {
|
|
21
|
+
path: { type: "string" },
|
|
22
|
+
offset: { type: "integer", minimum: 1 },
|
|
23
|
+
limit: { type: "integer", minimum: 1 },
|
|
24
|
+
},
|
|
25
|
+
},
|
|
26
|
+
limits: { default_limit: 2000 },
|
|
27
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
28
|
+
},
|
|
29
|
+
{
|
|
30
|
+
name: "write",
|
|
31
|
+
description: "Create or overwrite a file atomically. Returns a unified diff of changes.",
|
|
32
|
+
endpoint: "POST /api/tools/write",
|
|
33
|
+
input_schema: {
|
|
34
|
+
type: "object",
|
|
35
|
+
required: ["path", "content"],
|
|
36
|
+
properties: { path: { type: "string" }, content: { type: "string" } },
|
|
37
|
+
},
|
|
38
|
+
limits: {},
|
|
39
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
40
|
+
},
|
|
41
|
+
{
|
|
42
|
+
name: "edit",
|
|
43
|
+
description: "Replace a specific string in a file with fuzzy matching fallbacks.",
|
|
44
|
+
endpoint: "POST /api/tools/edit",
|
|
45
|
+
input_schema: {
|
|
46
|
+
type: "object",
|
|
47
|
+
required: ["path", "oldString", "newString"],
|
|
48
|
+
properties: {
|
|
49
|
+
path: { type: "string" },
|
|
50
|
+
oldString: { type: "string" },
|
|
51
|
+
newString: { type: "string" },
|
|
52
|
+
replaceAll: { type: "boolean" },
|
|
53
|
+
},
|
|
54
|
+
},
|
|
55
|
+
limits: {},
|
|
56
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
57
|
+
},
|
|
58
|
+
{
|
|
59
|
+
name: "add_mcp_servers",
|
|
60
|
+
description: "Merge stdio MCP servers into session .mcporter/mcporter.json (idempotent by name). Returns available_mcp_servers.",
|
|
61
|
+
endpoint: "POST /api/tools/add_mcp_servers",
|
|
62
|
+
input_schema: {
|
|
63
|
+
type: "object",
|
|
64
|
+
additionalProperties: true,
|
|
65
|
+
properties: {
|
|
66
|
+
mcpServers: {
|
|
67
|
+
oneOf: [{ type: "object", additionalProperties: true }, { type: "string" }],
|
|
68
|
+
},
|
|
69
|
+
serverName: { type: "string" },
|
|
70
|
+
name: { type: "string" },
|
|
71
|
+
server: { type: "string" },
|
|
72
|
+
command: { type: "string" },
|
|
73
|
+
args: { type: "array", items: { type: "string" } },
|
|
74
|
+
env: { type: "object" },
|
|
75
|
+
capabilityIds: { type: "object", additionalProperties: { type: "string" } },
|
|
76
|
+
},
|
|
77
|
+
},
|
|
78
|
+
limits: {},
|
|
79
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
80
|
+
},
|
|
81
|
+
{
|
|
82
|
+
name: "remove_mcp_servers",
|
|
83
|
+
description: "Remove MCP server(s) from session mcporter by name(s); returns updated available_mcp_servers (pairs with add_mcp_servers).",
|
|
84
|
+
endpoint: "POST /api/tools/remove_mcp_servers",
|
|
85
|
+
input_schema: {
|
|
86
|
+
type: "object",
|
|
87
|
+
additionalProperties: false,
|
|
88
|
+
properties: {
|
|
89
|
+
serverNames: {
|
|
90
|
+
oneOf: [
|
|
91
|
+
{ type: "array", items: { type: "string" } },
|
|
92
|
+
{ type: "string" },
|
|
93
|
+
],
|
|
94
|
+
},
|
|
95
|
+
serverName: { type: "string" },
|
|
96
|
+
name: { type: "string" },
|
|
97
|
+
server: { type: "string" },
|
|
98
|
+
},
|
|
99
|
+
},
|
|
100
|
+
limits: {},
|
|
101
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
102
|
+
},
|
|
103
|
+
{
|
|
104
|
+
name: "bash",
|
|
105
|
+
description: "Execute a shell command in the workspace (default execute, explicit dry_run supported with riskSummary/decision/changeSet).",
|
|
106
|
+
endpoint: "POST /api/tools/bash",
|
|
107
|
+
input_schema: {
|
|
108
|
+
type: "object",
|
|
109
|
+
required: ["command"],
|
|
110
|
+
properties: {
|
|
111
|
+
command: { type: "string" },
|
|
112
|
+
timeout: { type: "integer", minimum: 1 },
|
|
113
|
+
mode: { type: "string", enum: ["execute", "dry_run"] },
|
|
114
|
+
},
|
|
115
|
+
},
|
|
116
|
+
limits: { timeout_default_ms: 300000, timeout_max_ms: 600000 },
|
|
117
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
118
|
+
},
|
|
119
|
+
{
|
|
120
|
+
name: "grep",
|
|
121
|
+
description: "Search file contents by regex pattern. Returns matching lines with paths.",
|
|
122
|
+
endpoint: "POST /api/tools/grep",
|
|
123
|
+
input_schema: {
|
|
124
|
+
type: "object",
|
|
125
|
+
required: ["pattern"],
|
|
126
|
+
properties: {
|
|
127
|
+
pattern: { type: "string" },
|
|
128
|
+
path: { type: "string" },
|
|
129
|
+
include: { type: "string" },
|
|
130
|
+
},
|
|
131
|
+
},
|
|
132
|
+
limits: { result_limit: 100 },
|
|
133
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
134
|
+
},
|
|
135
|
+
{
|
|
136
|
+
name: "glob",
|
|
137
|
+
description: "Find files by glob pattern (e.g. '**/*.ts').",
|
|
138
|
+
endpoint: "POST /api/tools/glob",
|
|
139
|
+
input_schema: {
|
|
140
|
+
type: "object",
|
|
141
|
+
required: ["pattern"],
|
|
142
|
+
properties: { pattern: { type: "string" }, path: { type: "string" } },
|
|
143
|
+
},
|
|
144
|
+
limits: { result_limit: 100 },
|
|
145
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
146
|
+
},
|
|
147
|
+
{
|
|
148
|
+
name: "list_mcp_servers",
|
|
149
|
+
description: "List MCP server names from session mcporter config (available_mcp_servers). Read-only.",
|
|
150
|
+
endpoint: "POST /api/tools/list_mcp_servers",
|
|
151
|
+
input_schema: { type: "object", properties: {} },
|
|
152
|
+
limits: {},
|
|
153
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
154
|
+
},
|
|
155
|
+
{
|
|
156
|
+
name: "mcporter_cli",
|
|
157
|
+
description: "Execute mcporter CLI commands in the sandbox to manage MCP servers and CloudBase tools. " +
|
|
158
|
+
"Allowed subcommands: help, list, call, config. Session MCPORTER_CONFIG and credentials are automatic.",
|
|
159
|
+
endpoint: "POST /api/tools/mcporter_cli",
|
|
160
|
+
input_schema: {
|
|
161
|
+
type: "object",
|
|
162
|
+
required: ["command"],
|
|
163
|
+
properties: {
|
|
164
|
+
command: { type: "string", description: "Mcporter subcommand (without 'mcporter' prefix)" },
|
|
165
|
+
timeout: { type: "integer", description: "Timeout in ms (default 300000)" },
|
|
166
|
+
},
|
|
167
|
+
},
|
|
168
|
+
limits: { default_timeout_ms: 300_000, allowed_subcommands: ["help", "list", "call", "config"] },
|
|
169
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
170
|
+
},
|
|
171
|
+
{
|
|
172
|
+
name: "ls",
|
|
173
|
+
description: "List directory tree with common noise dirs excluded.",
|
|
174
|
+
endpoint: "POST /api/tools/ls",
|
|
175
|
+
input_schema: {
|
|
176
|
+
type: "object",
|
|
177
|
+
properties: {
|
|
178
|
+
path: { type: "string" },
|
|
179
|
+
ignore: { type: "array", items: { type: "string" } },
|
|
180
|
+
},
|
|
181
|
+
},
|
|
182
|
+
limits: { result_limit: 100 },
|
|
183
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
184
|
+
},
|
|
185
|
+
{
|
|
186
|
+
name: "pty_create",
|
|
187
|
+
description: "Create a session-scoped PTY process.",
|
|
188
|
+
endpoint: "POST /api/tools/pty_create",
|
|
189
|
+
input_schema: {
|
|
190
|
+
type: "object",
|
|
191
|
+
properties: {
|
|
192
|
+
cmd: { type: "string" },
|
|
193
|
+
args: { type: "array", items: { type: "string" } },
|
|
194
|
+
cwd: { type: "string" },
|
|
195
|
+
envs: { type: "object" },
|
|
196
|
+
cols: { type: "integer" },
|
|
197
|
+
rows: { type: "integer" },
|
|
198
|
+
},
|
|
199
|
+
},
|
|
200
|
+
limits: {},
|
|
201
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
202
|
+
},
|
|
203
|
+
{
|
|
204
|
+
name: "pty_send_input",
|
|
205
|
+
description: "Send base64 input bytes to PTY by pid.",
|
|
206
|
+
endpoint: "POST /api/tools/pty_send_input",
|
|
207
|
+
input_schema: {
|
|
208
|
+
type: "object",
|
|
209
|
+
required: ["pid", "inputBase64"],
|
|
210
|
+
properties: { pid: { type: "integer" }, inputBase64: { type: "string" } },
|
|
211
|
+
},
|
|
212
|
+
limits: {},
|
|
213
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
214
|
+
},
|
|
215
|
+
{
|
|
216
|
+
name: "pty_resize",
|
|
217
|
+
description: "Resize PTY by pid.",
|
|
218
|
+
endpoint: "POST /api/tools/pty_resize",
|
|
219
|
+
input_schema: {
|
|
220
|
+
type: "object",
|
|
221
|
+
required: ["pid", "cols", "rows"],
|
|
222
|
+
properties: {
|
|
223
|
+
pid: { type: "integer" },
|
|
224
|
+
cols: { type: "integer", minimum: 1 },
|
|
225
|
+
rows: { type: "integer", minimum: 1 },
|
|
226
|
+
},
|
|
227
|
+
},
|
|
228
|
+
limits: {},
|
|
229
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
230
|
+
},
|
|
231
|
+
{
|
|
232
|
+
name: "pty_read_output",
|
|
233
|
+
description: "Read buffered PTY output events by pid.",
|
|
234
|
+
endpoint: "POST /api/tools/pty_read_output",
|
|
235
|
+
input_schema: {
|
|
236
|
+
type: "object",
|
|
237
|
+
required: ["pid"],
|
|
238
|
+
properties: {
|
|
239
|
+
pid: { type: "integer" },
|
|
240
|
+
afterSeq: { type: "integer", minimum: 0 },
|
|
241
|
+
limit: { type: "integer", minimum: 1 },
|
|
242
|
+
},
|
|
243
|
+
},
|
|
244
|
+
limits: { default_limit: 128, max_limit: 512, buffer_size_events: 512 },
|
|
245
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
246
|
+
},
|
|
247
|
+
{
|
|
248
|
+
name: "pty_kill",
|
|
249
|
+
description: "Kill PTY by pid.",
|
|
250
|
+
endpoint: "POST /api/tools/pty_kill",
|
|
251
|
+
input_schema: {
|
|
252
|
+
type: "object",
|
|
253
|
+
required: ["pid"],
|
|
254
|
+
properties: { pid: { type: "integer" }, signal: { type: "string" } },
|
|
255
|
+
},
|
|
256
|
+
limits: {},
|
|
257
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
258
|
+
},
|
|
259
|
+
{
|
|
260
|
+
name: "secrets_set",
|
|
261
|
+
description: "Set or overwrite a session secret.",
|
|
262
|
+
endpoint: "POST /api/tools/secrets_set",
|
|
263
|
+
input_schema: {
|
|
264
|
+
type: "object",
|
|
265
|
+
required: ["key", "value"],
|
|
266
|
+
properties: { key: { type: "string" }, value: { type: "string" } },
|
|
267
|
+
},
|
|
268
|
+
limits: {},
|
|
269
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
270
|
+
},
|
|
271
|
+
{
|
|
272
|
+
name: "secrets_get",
|
|
273
|
+
description: "Get plaintext session secret.",
|
|
274
|
+
endpoint: "POST /api/tools/secrets_get",
|
|
275
|
+
input_schema: {
|
|
276
|
+
type: "object",
|
|
277
|
+
required: ["key"],
|
|
278
|
+
properties: { key: { type: "string" } },
|
|
279
|
+
},
|
|
280
|
+
limits: {},
|
|
281
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
282
|
+
},
|
|
283
|
+
{
|
|
284
|
+
name: "secrets_list",
|
|
285
|
+
description: "List session secret keys.",
|
|
286
|
+
endpoint: "POST /api/tools/secrets_list",
|
|
287
|
+
input_schema: { type: "object", properties: {} },
|
|
288
|
+
limits: {},
|
|
289
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
290
|
+
},
|
|
291
|
+
{
|
|
292
|
+
name: "secrets_delete",
|
|
293
|
+
description: "Delete a session secret.",
|
|
294
|
+
endpoint: "POST /api/tools/secrets_delete",
|
|
295
|
+
input_schema: {
|
|
296
|
+
type: "object",
|
|
297
|
+
required: ["key"],
|
|
298
|
+
properties: { key: { type: "string" } },
|
|
299
|
+
},
|
|
300
|
+
limits: {},
|
|
301
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
302
|
+
},
|
|
303
|
+
{
|
|
304
|
+
name: "preview_ports",
|
|
305
|
+
description: "List previewable ports for session.",
|
|
306
|
+
endpoint: "POST /api/tools/preview_ports",
|
|
307
|
+
input_schema: {
|
|
308
|
+
type: "object",
|
|
309
|
+
properties: {
|
|
310
|
+
endpoint: { type: "string" },
|
|
311
|
+
includeSessionQuery: { type: "boolean" },
|
|
312
|
+
},
|
|
313
|
+
},
|
|
314
|
+
limits: {},
|
|
315
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
316
|
+
},
|
|
317
|
+
{
|
|
318
|
+
name: "preview_url",
|
|
319
|
+
description: "Build preview URL for a port.",
|
|
320
|
+
endpoint: "POST /api/tools/preview_url",
|
|
321
|
+
input_schema: {
|
|
322
|
+
type: "object",
|
|
323
|
+
required: ["port"],
|
|
324
|
+
properties: {
|
|
325
|
+
port: { type: "integer" },
|
|
326
|
+
endpoint: { type: "string" },
|
|
327
|
+
includeSessionQuery: { type: "boolean" },
|
|
328
|
+
},
|
|
329
|
+
},
|
|
330
|
+
limits: {},
|
|
331
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
332
|
+
},
|
|
333
|
+
{
|
|
334
|
+
name: "files_upload",
|
|
335
|
+
description: "Upload file bytes as base64 payload.",
|
|
336
|
+
endpoint: "POST /api/tools/files_upload",
|
|
337
|
+
input_schema: {
|
|
338
|
+
type: "object",
|
|
339
|
+
required: ["path", "contentBase64"],
|
|
340
|
+
properties: { path: { type: "string" }, contentBase64: { type: "string" } },
|
|
341
|
+
},
|
|
342
|
+
limits: { max_bytes_per_transfer: 6 * 1024 * 1024 },
|
|
343
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
344
|
+
},
|
|
345
|
+
{
|
|
346
|
+
name: "files_download",
|
|
347
|
+
description: "Download file bytes as base64 payload.",
|
|
348
|
+
endpoint: "POST /api/tools/files_download",
|
|
349
|
+
input_schema: {
|
|
350
|
+
type: "object",
|
|
351
|
+
required: ["path"],
|
|
352
|
+
properties: { path: { type: "string" } },
|
|
353
|
+
},
|
|
354
|
+
limits: { max_bytes_per_transfer: 6 * 1024 * 1024 },
|
|
355
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
356
|
+
},
|
|
357
|
+
{
|
|
358
|
+
name: "batch",
|
|
359
|
+
description: "Execute multiple tool calls in parallel chunks.",
|
|
360
|
+
endpoint: "POST /api/tools/batch",
|
|
361
|
+
input_schema: {
|
|
362
|
+
type: "object",
|
|
363
|
+
required: ["tool_calls"],
|
|
364
|
+
properties: { tool_calls: { type: "array" } },
|
|
365
|
+
},
|
|
366
|
+
limits: { max_tool_calls: 25, max_parallel_per_chunk: 5 },
|
|
367
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
368
|
+
},
|
|
369
|
+
{
|
|
370
|
+
name: "capability_list",
|
|
371
|
+
description: "List available capabilities (built-in + registered).",
|
|
372
|
+
endpoint: "POST /api/tools/capability_list",
|
|
373
|
+
input_schema: {
|
|
374
|
+
type: "object",
|
|
375
|
+
properties: {
|
|
376
|
+
includeBuiltins: { type: "boolean" },
|
|
377
|
+
revealPaths: { type: "boolean" },
|
|
378
|
+
},
|
|
379
|
+
},
|
|
380
|
+
limits: {},
|
|
381
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
382
|
+
},
|
|
383
|
+
{
|
|
384
|
+
name: "capability_install",
|
|
385
|
+
description: "Return install guidance only. Caller executes installation/configuration and then registers metadata.",
|
|
386
|
+
endpoint: "POST /api/tools/capability_install",
|
|
387
|
+
input_schema: {
|
|
388
|
+
type: "object",
|
|
389
|
+
required: ["id"],
|
|
390
|
+
properties: {
|
|
391
|
+
id: { type: "string" },
|
|
392
|
+
kind: { type: "string", enum: ["cli", "mcp", "skill"] },
|
|
393
|
+
package: { type: "string" },
|
|
394
|
+
version: { type: "string" },
|
|
395
|
+
bin: { type: "string" },
|
|
396
|
+
serverName: { type: "string" },
|
|
397
|
+
},
|
|
398
|
+
},
|
|
399
|
+
limits: {},
|
|
400
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
401
|
+
},
|
|
402
|
+
{
|
|
403
|
+
name: "capability_register",
|
|
404
|
+
description: "Register externally prepared capability runtime metadata.",
|
|
405
|
+
endpoint: "POST /api/tools/capability_register",
|
|
406
|
+
input_schema: {
|
|
407
|
+
type: "object",
|
|
408
|
+
required: ["id", "kind"],
|
|
409
|
+
properties: {
|
|
410
|
+
id: { type: "string" },
|
|
411
|
+
kind: { type: "string", enum: ["cli", "mcp", "skill"] },
|
|
412
|
+
source: { type: "string", enum: ["managed", "external"] },
|
|
413
|
+
description: { type: "string" },
|
|
414
|
+
command: { type: "string" },
|
|
415
|
+
args: { type: "array", items: { type: "string" } },
|
|
416
|
+
env: { type: "object" },
|
|
417
|
+
serverName: { type: "string" },
|
|
418
|
+
packagePath: { type: "string" },
|
|
419
|
+
entryFile: { type: "string" },
|
|
420
|
+
},
|
|
421
|
+
},
|
|
422
|
+
limits: {},
|
|
423
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
424
|
+
},
|
|
425
|
+
{
|
|
426
|
+
name: "capability_remove",
|
|
427
|
+
description: "Remove a registered capability.",
|
|
428
|
+
endpoint: "POST /api/tools/capability_remove",
|
|
429
|
+
input_schema: {
|
|
430
|
+
type: "object",
|
|
431
|
+
required: ["id"],
|
|
432
|
+
properties: {
|
|
433
|
+
id: { type: "string" },
|
|
434
|
+
},
|
|
435
|
+
},
|
|
436
|
+
limits: {},
|
|
437
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
438
|
+
},
|
|
439
|
+
{
|
|
440
|
+
name: "capability_describe",
|
|
441
|
+
description: "Describe capability actions and schemas.",
|
|
442
|
+
endpoint: "POST /api/tools/capability_describe",
|
|
443
|
+
input_schema: {
|
|
444
|
+
type: "object",
|
|
445
|
+
required: ["id"],
|
|
446
|
+
properties: {
|
|
447
|
+
id: { type: "string" },
|
|
448
|
+
revealPaths: { type: "boolean" },
|
|
449
|
+
},
|
|
450
|
+
},
|
|
451
|
+
limits: {},
|
|
452
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
453
|
+
},
|
|
454
|
+
{
|
|
455
|
+
name: "capability_invoke",
|
|
456
|
+
description: "Invoke capability action only for capabilities that execute directly in capability layer.",
|
|
457
|
+
endpoint: "POST /api/tools/capability_invoke",
|
|
458
|
+
input_schema: {
|
|
459
|
+
type: "object",
|
|
460
|
+
required: ["id", "action"],
|
|
461
|
+
properties: {
|
|
462
|
+
id: { type: "string" },
|
|
463
|
+
action: { type: "string" },
|
|
464
|
+
parameters: { type: "object" },
|
|
465
|
+
},
|
|
466
|
+
},
|
|
467
|
+
limits: {},
|
|
468
|
+
notes: [
|
|
469
|
+
"Only native data-plane capabilities execute here (for example secrets-store/files-transfer/preview-service/pty-service/git-archive).",
|
|
470
|
+
],
|
|
471
|
+
},
|
|
472
|
+
{
|
|
473
|
+
name: "git_push",
|
|
474
|
+
description: "Commit all workspace changes and push to archive repository.",
|
|
475
|
+
endpoint: "POST /api/tools/git_push",
|
|
476
|
+
input_schema: {
|
|
477
|
+
type: "object",
|
|
478
|
+
properties: {
|
|
479
|
+
message: { type: "string" },
|
|
480
|
+
},
|
|
481
|
+
},
|
|
482
|
+
limits: {},
|
|
483
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
484
|
+
},
|
|
485
|
+
{
|
|
486
|
+
name: "workspace_snapshot",
|
|
487
|
+
description: "Create async workspace snapshot uploaded to S3. Returns snapshot_id immediately.",
|
|
488
|
+
endpoint: "POST /api/tools/workspace_snapshot",
|
|
489
|
+
input_schema: {
|
|
490
|
+
type: "object",
|
|
491
|
+
properties: {
|
|
492
|
+
exclude: { type: "array", items: { type: "string" } },
|
|
493
|
+
include_all: { type: "boolean" },
|
|
494
|
+
},
|
|
495
|
+
},
|
|
496
|
+
limits: { max_concurrent: 2 },
|
|
497
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
498
|
+
},
|
|
499
|
+
{
|
|
500
|
+
name: "workspace_snapshot_status",
|
|
501
|
+
description: "Check snapshot task status by snapshot_id or list all session tasks.",
|
|
502
|
+
endpoint: "POST /api/tools/workspace_snapshot_status",
|
|
503
|
+
input_schema: {
|
|
504
|
+
type: "object",
|
|
505
|
+
properties: {
|
|
506
|
+
snapshot_id: { type: "string" },
|
|
507
|
+
},
|
|
508
|
+
},
|
|
509
|
+
limits: {},
|
|
510
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
511
|
+
},
|
|
512
|
+
{
|
|
513
|
+
name: "workspace_restore",
|
|
514
|
+
description: 'Restore workspace from snapshot. mode="merge" overlays, mode="replace" cleans first.',
|
|
515
|
+
endpoint: "POST /api/tools/workspace_restore",
|
|
516
|
+
input_schema: {
|
|
517
|
+
type: "object",
|
|
518
|
+
required: ["snapshot_id"],
|
|
519
|
+
properties: {
|
|
520
|
+
snapshot_id: { type: "string" },
|
|
521
|
+
mode: { type: "string", enum: ["merge", "replace"] },
|
|
522
|
+
},
|
|
523
|
+
},
|
|
524
|
+
limits: {},
|
|
525
|
+
notes: ["Bundled fallback docs snapshot."],
|
|
526
|
+
},
|
|
527
|
+
],
|
|
528
|
+
};
|
package/dist/cli.d.ts
ADDED