@dbx-tools/cli 0.9.60 → 0.9.64
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 +175 -81
- package/bin/dbx-genie.ts +10 -0
- package/index.ts +13 -1
- package/lib/bin/dbx-genie.d.ts +2 -0
- package/lib/bin/dbx-genie.js +10 -0
- package/lib/index.d.ts +13 -1
- package/lib/index.js +10 -2
- package/lib/src/auth/cli.js +13 -2
- package/lib/src/auth/options.d.ts +4 -0
- package/lib/src/auth/options.js +5 -1
- package/lib/src/cli.js +19 -4
- package/lib/src/genie-code/cli.d.ts +19 -0
- package/lib/src/genie-code/cli.js +36 -0
- package/lib/src/genie-code/config.d.ts +38 -0
- package/lib/src/genie-code/config.js +108 -0
- package/lib/src/genie-code/install.d.ts +21 -0
- package/lib/src/genie-code/install.js +69 -0
- package/lib/src/genie-code/options.d.ts +7 -0
- package/lib/src/genie-code/options.js +7 -0
- package/lib/src/genie-code/runner.d.ts +21 -0
- package/lib/src/genie-code/runner.js +90 -0
- package/lib/src/genie-code/runtime.d.ts +49 -0
- package/lib/src/genie-code/runtime.js +169 -0
- package/lib/src/graphiti/cli.js +2 -2
- package/lib/src/lakebase-proxy/cli.js +2 -2
- package/lib/src/model-gateway/cli.js +3 -3
- package/lib/src/model-gateway/server.d.ts +3 -0
- package/lib/src/model-gateway/server.js +39 -6
- package/lib/tsconfig.tsbuildinfo +1 -1
- package/package.json +40 -18
- package/src/auth/cli.ts +11 -1
- package/src/auth/options.ts +4 -0
- package/src/cli.ts +17 -6
- package/src/genie-code/cli.ts +58 -0
- package/src/genie-code/config.ts +157 -0
- package/src/genie-code/install.ts +103 -0
- package/src/genie-code/options.ts +14 -0
- package/src/genie-code/runner.ts +106 -0
- package/src/genie-code/runtime.ts +231 -0
- package/src/graphiti/cli.ts +1 -1
- package/src/lakebase-proxy/cli.ts +1 -1
- package/src/model-gateway/cli.ts +6 -2
- package/src/model-gateway/server.ts +40 -5
package/README.md
CHANGED
|
@@ -8,12 +8,11 @@ applications through a gated public URL.
|
|
|
8
8
|
|
|
9
9
|
```sh
|
|
10
10
|
bun add --global @dbx-tools/cli
|
|
11
|
-
dbx auth login --profile MY-PROFILE
|
|
12
|
-
dbx auth status --profile MY-PROFILE
|
|
13
11
|
```
|
|
14
12
|
|
|
15
|
-
`dbx-tools` is an alias for `dbx`.
|
|
16
|
-
|
|
13
|
+
`dbx-tools` is an alias for `dbx`. Authentication and a configured Databricks
|
|
14
|
+
profile are resolved automatically. Pass `--profile` only to override that
|
|
15
|
+
selection; examples that use `MY-PROFILE` show the explicit form.
|
|
17
16
|
|
|
18
17
|
## Serve Models To Local Tools
|
|
19
18
|
|
|
@@ -24,6 +23,67 @@ dbx model-gateway --profile MY-PROFILE --port 4000
|
|
|
24
23
|
Point an OpenAI-compatible client at `http://127.0.0.1:4000/v1`. The generated
|
|
25
24
|
command reference includes all gateway and desktop-service options.
|
|
26
25
|
|
|
26
|
+
Requests may omit `model` to select the best available chat endpoint. Set a
|
|
27
|
+
gateway default with `--model` or `--model-class`, or select a class per request
|
|
28
|
+
with the `x-dbx-tools-model-class` header.
|
|
29
|
+
|
|
30
|
+
## Run Genie Code
|
|
31
|
+
|
|
32
|
+
`dbx genie` runs the Databricks Genie Code CLI with dbx-tools model discovery,
|
|
33
|
+
authentication, and configuration. It removes the setup steps normally required
|
|
34
|
+
before the first non-interactive Genie command:
|
|
35
|
+
|
|
36
|
+
- No Genie onboarding or separate `genie` initialization.
|
|
37
|
+
- No Genie configuration profile to create or pass.
|
|
38
|
+
- No manual provider URL, token command, workspace header, or `config.toml`.
|
|
39
|
+
- No required `--profile` when dbx-tools can discover a configured Databricks
|
|
40
|
+
profile automatically.
|
|
41
|
+
- No restriction to Genie Code's default model. Select any compatible model
|
|
42
|
+
available in the workspace, including GPT, Grok, Claude, Gemini, and custom
|
|
43
|
+
serving endpoints.
|
|
44
|
+
|
|
45
|
+
With no model option, dbx-tools selects the best available tool-capable chat
|
|
46
|
+
model. Use either `--model` for fuzzy or exact model selection, or
|
|
47
|
+
`--model-class` for a capability band:
|
|
48
|
+
|
|
49
|
+
```sh
|
|
50
|
+
# Select the best available chat model.
|
|
51
|
+
dbx genie
|
|
52
|
+
|
|
53
|
+
# Select the best fast chat model.
|
|
54
|
+
dbx genie --model-class chat-fast
|
|
55
|
+
|
|
56
|
+
# Select the best matching GPT model.
|
|
57
|
+
dbx genie --model gpt
|
|
58
|
+
|
|
59
|
+
# Select another model family.
|
|
60
|
+
dbx genie --model grok
|
|
61
|
+
|
|
62
|
+
# Pin an exact model or serving endpoint.
|
|
63
|
+
dbx genie --profile MY-PROFILE --model databricks-gpt-5-6-sol
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
`dbx-genie` is the equivalent installed binary:
|
|
67
|
+
|
|
68
|
+
```sh
|
|
69
|
+
dbx-genie --model gpt
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
The command installs the pinned Genie Code package under `~/.dbx-tools` and
|
|
73
|
+
creates one persistent home per exact Databricks profile. Models share that
|
|
74
|
+
home's conversation state and project trust, while each invocation receives a
|
|
75
|
+
model-specific overlay with an independent local gateway port and credential.
|
|
76
|
+
|
|
77
|
+
Unknown flags, prompts, and extra arguments are forwarded to Genie Code:
|
|
78
|
+
|
|
79
|
+
```sh
|
|
80
|
+
dbx genie --model gpt "Summarize the changes since the latest release."
|
|
81
|
+
dbx genie --model claude -- exec --ephemeral "Review this repository."
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
Use `--` only when a wrapper option such as `--model` must be sent to Genie
|
|
85
|
+
instead of being consumed by `dbx genie`.
|
|
86
|
+
|
|
27
87
|
## Connect To Lakebase
|
|
28
88
|
|
|
29
89
|
```sh
|
|
@@ -72,8 +132,8 @@ bun run barrels
|
|
|
72
132
|
|
|
73
133
|
See [`@dbx-tools/projen`](../../../../projen) for workspace configuration and
|
|
74
134
|
generation. Command implementations are available from `@dbx-tools/cli/appkit`,
|
|
75
|
-
`/auth`, `/graphiti`, `/lakebase-proxy`, `/model-gateway`, and
|
|
76
|
-
Node caller needs to embed one parser.
|
|
135
|
+
`/auth`, `/genie`, `/graphiti`, `/lakebase-proxy`, `/model-gateway`, and
|
|
136
|
+
`/tunnel` when a Node caller needs to embed one parser.
|
|
77
137
|
|
|
78
138
|
<!-- cli-reference:start -->
|
|
79
139
|
|
|
@@ -89,15 +149,16 @@ dbx [command]
|
|
|
89
149
|
|
|
90
150
|
#### Commands
|
|
91
151
|
|
|
92
|
-
| Command
|
|
93
|
-
|
|
|
94
|
-
| `dev [projenArgs...]`
|
|
95
|
-
| `appkit`
|
|
96
|
-
| `auth [options]`
|
|
97
|
-
| `tunnel [options] [command...]`
|
|
98
|
-
| `lakebase-proxy [options]`
|
|
99
|
-
| `model-gateway [options]`
|
|
100
|
-
| `
|
|
152
|
+
| Command | Description |
|
|
153
|
+
| -------------------------------- | ----------------------------------------------------------------------- |
|
|
154
|
+
| `dev [projenArgs...]` | Bootstrap or repair a dbx-tools workspace, then forward to projen |
|
|
155
|
+
| `appkit` | AppKit helpers: resolve the environment an AppKit app would start with. |
|
|
156
|
+
| `auth [options]` | Authenticate to Databricks with user or machine OAuth |
|
|
157
|
+
| `tunnel [options] [command...]` | Front a command with a public tunnel and passwordless auth |
|
|
158
|
+
| `lakebase-proxy [options]` | Run a loopback PostgreSQL proxy for Databricks Lakebase |
|
|
159
|
+
| `model-gateway [options]` | Run or manage the AppKit Databricks model gateway |
|
|
160
|
+
| `genie [options] [genieArgs...]` | Run Genie Code through an authenticated local Databricks model gateway |
|
|
161
|
+
| `graphiti [options]` | Run Graphiti or manage its current-user desktop service |
|
|
101
162
|
|
|
102
163
|
### `dbx dev`
|
|
103
164
|
|
|
@@ -118,7 +179,7 @@ dbx dev [projenArgs...]
|
|
|
118
179
|
AppKit helpers: resolve the environment an AppKit app would start with.
|
|
119
180
|
|
|
120
181
|
```sh
|
|
121
|
-
appkit [command]
|
|
182
|
+
dbx appkit [command]
|
|
122
183
|
```
|
|
123
184
|
|
|
124
185
|
#### Commands
|
|
@@ -132,7 +193,7 @@ appkit [command]
|
|
|
132
193
|
Run AppKit auto-config and print new/changed env vars.
|
|
133
194
|
|
|
134
195
|
```sh
|
|
135
|
-
appkit env [options]
|
|
196
|
+
dbx appkit env [options]
|
|
136
197
|
```
|
|
137
198
|
|
|
138
199
|
#### Options
|
|
@@ -148,7 +209,7 @@ appkit env [options]
|
|
|
148
209
|
Authenticate to Databricks with user or machine OAuth
|
|
149
210
|
|
|
150
211
|
```sh
|
|
151
|
-
auth [options] [command]
|
|
212
|
+
dbx auth [options] [command]
|
|
152
213
|
```
|
|
153
214
|
|
|
154
215
|
#### Options
|
|
@@ -170,6 +231,7 @@ auth [options] [command]
|
|
|
170
231
|
| ----------------- | ------------------------------------------------------ |
|
|
171
232
|
| `login` | Force browser login and return an access token |
|
|
172
233
|
| `token [options]` | Return a valid access token, logging in when needed |
|
|
234
|
+
| `headers` | Return current Databricks authentication headers |
|
|
173
235
|
| `profile` | Print the configured or automatically detected profile |
|
|
174
236
|
| `logout` | Delete the stored credential for the selected profile |
|
|
175
237
|
| `status` | Show the resolved authentication client configuration |
|
|
@@ -179,7 +241,7 @@ auth [options] [command]
|
|
|
179
241
|
Force browser login and return an access token
|
|
180
242
|
|
|
181
243
|
```sh
|
|
182
|
-
auth login
|
|
244
|
+
dbx auth login
|
|
183
245
|
```
|
|
184
246
|
|
|
185
247
|
### `dbx auth token`
|
|
@@ -187,24 +249,33 @@ auth login
|
|
|
187
249
|
Return a valid access token, logging in when needed
|
|
188
250
|
|
|
189
251
|
```sh
|
|
190
|
-
auth token [options]
|
|
252
|
+
dbx auth token [options]
|
|
191
253
|
```
|
|
192
254
|
|
|
193
255
|
#### Options
|
|
194
256
|
|
|
195
|
-
| Option | Description
|
|
196
|
-
| -------------------- |
|
|
197
|
-
| `--force-refresh` | Refresh the token before returning it. (default: false, env: FORCE_REFRESH)
|
|
198
|
-
| `--no-force-refresh` | Disable refresh the token before returning it.
|
|
199
|
-
| `--login` | Log in when credentials are missing or invalid. (default: true, env: LOGIN)
|
|
200
|
-
| `--no-login` | Disable log in when credentials are missing or invalid.
|
|
257
|
+
| Option | Description |
|
|
258
|
+
| -------------------- | ------------------------------------------------------------------------------------------------------------------ |
|
|
259
|
+
| `--force-refresh` | Refresh the token before returning it. (default: false, env: FORCE_REFRESH) |
|
|
260
|
+
| `--no-force-refresh` | Disable refresh the token before returning it. |
|
|
261
|
+
| `--login` | Log in when credentials are missing or invalid. (default: true, env: LOGIN) |
|
|
262
|
+
| `--no-login` | Disable log in when credentials are missing or invalid. |
|
|
263
|
+
| `--format <value>` | Output structured token metadata or only the access token. (choices: "json", "text", default: "json", env: FORMAT) |
|
|
264
|
+
|
|
265
|
+
### `dbx auth headers`
|
|
266
|
+
|
|
267
|
+
Return current Databricks authentication headers
|
|
268
|
+
|
|
269
|
+
```sh
|
|
270
|
+
dbx auth headers
|
|
271
|
+
```
|
|
201
272
|
|
|
202
273
|
### `dbx auth profile`
|
|
203
274
|
|
|
204
275
|
Print the configured or automatically detected profile
|
|
205
276
|
|
|
206
277
|
```sh
|
|
207
|
-
auth profile
|
|
278
|
+
dbx auth profile
|
|
208
279
|
```
|
|
209
280
|
|
|
210
281
|
### `dbx auth logout`
|
|
@@ -212,7 +283,7 @@ auth profile
|
|
|
212
283
|
Delete the stored credential for the selected profile
|
|
213
284
|
|
|
214
285
|
```sh
|
|
215
|
-
auth logout
|
|
286
|
+
dbx auth logout
|
|
216
287
|
```
|
|
217
288
|
|
|
218
289
|
### `dbx auth status`
|
|
@@ -220,7 +291,7 @@ auth logout
|
|
|
220
291
|
Show the resolved authentication client configuration
|
|
221
292
|
|
|
222
293
|
```sh
|
|
223
|
-
auth status
|
|
294
|
+
dbx auth status
|
|
224
295
|
```
|
|
225
296
|
|
|
226
297
|
### `dbx tunnel`
|
|
@@ -228,7 +299,7 @@ auth status
|
|
|
228
299
|
Front a command with a public tunnel and passwordless auth
|
|
229
300
|
|
|
230
301
|
```sh
|
|
231
|
-
tunnel [options] [command] [command...]
|
|
302
|
+
dbx tunnel [options] [command] [command...]
|
|
232
303
|
```
|
|
233
304
|
|
|
234
305
|
#### Arguments
|
|
@@ -280,7 +351,7 @@ tunnel [options] [command] [command...]
|
|
|
280
351
|
Wrap a command (the default action)
|
|
281
352
|
|
|
282
353
|
```sh
|
|
283
|
-
tunnel run [options] <command...>
|
|
354
|
+
dbx tunnel run [options] <command...>
|
|
284
355
|
```
|
|
285
356
|
|
|
286
357
|
#### Arguments
|
|
@@ -324,7 +395,7 @@ tunnel run [options] <command...>
|
|
|
324
395
|
Resolve the configuration and print it
|
|
325
396
|
|
|
326
397
|
```sh
|
|
327
|
-
tunnel status [options]
|
|
398
|
+
dbx tunnel status [options]
|
|
328
399
|
```
|
|
329
400
|
|
|
330
401
|
#### Options
|
|
@@ -362,7 +433,7 @@ tunnel status [options]
|
|
|
362
433
|
Install public tunnel client binaries and exit
|
|
363
434
|
|
|
364
435
|
```sh
|
|
365
|
-
tunnel install [transport]
|
|
436
|
+
dbx tunnel install [transport]
|
|
366
437
|
```
|
|
367
438
|
|
|
368
439
|
#### Arguments
|
|
@@ -376,7 +447,7 @@ tunnel install [transport]
|
|
|
376
447
|
Run a loopback PostgreSQL proxy for Databricks Lakebase
|
|
377
448
|
|
|
378
449
|
```sh
|
|
379
|
-
lakebase-proxy [options] [command]
|
|
450
|
+
dbx lakebase-proxy [options] [command]
|
|
380
451
|
```
|
|
381
452
|
|
|
382
453
|
#### Options
|
|
@@ -401,7 +472,7 @@ lakebase-proxy [options] [command]
|
|
|
401
472
|
Format a local PostgreSQL URL for a Lakebase target
|
|
402
473
|
|
|
403
474
|
```sh
|
|
404
|
-
lakebase-proxy url [options]
|
|
475
|
+
dbx lakebase-proxy url [options]
|
|
405
476
|
```
|
|
406
477
|
|
|
407
478
|
#### Options
|
|
@@ -416,7 +487,7 @@ lakebase-proxy url [options]
|
|
|
416
487
|
Install and manage the desktop service
|
|
417
488
|
|
|
418
489
|
```sh
|
|
419
|
-
lakebase-proxy service [command]
|
|
490
|
+
dbx lakebase-proxy service [command]
|
|
420
491
|
```
|
|
421
492
|
|
|
422
493
|
#### Commands
|
|
@@ -435,7 +506,7 @@ lakebase-proxy service [command]
|
|
|
435
506
|
Install the service for the current user and start it
|
|
436
507
|
|
|
437
508
|
```sh
|
|
438
|
-
lakebase-proxy service install [options]
|
|
509
|
+
dbx lakebase-proxy service install [options]
|
|
439
510
|
```
|
|
440
511
|
|
|
441
512
|
#### Options
|
|
@@ -453,7 +524,7 @@ lakebase-proxy service install [options]
|
|
|
453
524
|
Start the installed service
|
|
454
525
|
|
|
455
526
|
```sh
|
|
456
|
-
lakebase-proxy service start
|
|
527
|
+
dbx lakebase-proxy service start
|
|
457
528
|
```
|
|
458
529
|
|
|
459
530
|
### `dbx lakebase-proxy service stop`
|
|
@@ -461,7 +532,7 @@ lakebase-proxy service start
|
|
|
461
532
|
Stop the running service
|
|
462
533
|
|
|
463
534
|
```sh
|
|
464
|
-
lakebase-proxy service stop
|
|
535
|
+
dbx lakebase-proxy service stop
|
|
465
536
|
```
|
|
466
537
|
|
|
467
538
|
### `dbx lakebase-proxy service restart`
|
|
@@ -469,7 +540,7 @@ lakebase-proxy service stop
|
|
|
469
540
|
Restart the installed service
|
|
470
541
|
|
|
471
542
|
```sh
|
|
472
|
-
lakebase-proxy service restart
|
|
543
|
+
dbx lakebase-proxy service restart
|
|
473
544
|
```
|
|
474
545
|
|
|
475
546
|
### `dbx lakebase-proxy service status`
|
|
@@ -477,7 +548,7 @@ lakebase-proxy service restart
|
|
|
477
548
|
Print service installation and process state as JSON
|
|
478
549
|
|
|
479
550
|
```sh
|
|
480
|
-
lakebase-proxy service status
|
|
551
|
+
dbx lakebase-proxy service status
|
|
481
552
|
```
|
|
482
553
|
|
|
483
554
|
### `dbx lakebase-proxy service uninstall`
|
|
@@ -485,7 +556,7 @@ lakebase-proxy service status
|
|
|
485
556
|
Stop and remove the service for the current user
|
|
486
557
|
|
|
487
558
|
```sh
|
|
488
|
-
lakebase-proxy service uninstall
|
|
559
|
+
dbx lakebase-proxy service uninstall
|
|
489
560
|
```
|
|
490
561
|
|
|
491
562
|
### `dbx model-gateway`
|
|
@@ -493,19 +564,21 @@ lakebase-proxy service uninstall
|
|
|
493
564
|
Run or manage the AppKit Databricks model gateway
|
|
494
565
|
|
|
495
566
|
```sh
|
|
496
|
-
model-gateway [options] [command]
|
|
567
|
+
dbx model-gateway [options] [command]
|
|
497
568
|
```
|
|
498
569
|
|
|
499
570
|
#### Options
|
|
500
571
|
|
|
501
|
-
| Option
|
|
502
|
-
|
|
|
503
|
-
| `-v, --version`
|
|
504
|
-
| `--
|
|
505
|
-
| `--
|
|
506
|
-
| `--
|
|
507
|
-
| `--
|
|
508
|
-
| `--
|
|
572
|
+
| Option | Description |
|
|
573
|
+
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
574
|
+
| `-v, --version` | output the version number |
|
|
575
|
+
| `--model <value>` | Optional fuzzy or exact model name. (env: MODEL) |
|
|
576
|
+
| `--model-class <value>` | Optional model capability class used when selecting a default model. (choices: "chat-thinking", "chat-balanced", "chat-fast", "embedding", env: MODEL_CLASS) |
|
|
577
|
+
| `--listen <value>` | Loopback listener address. (default: tcp://localhost:4000, env: LISTEN) |
|
|
578
|
+
| `--profile <value>` | Databricks profile used for model discovery and requests. (env: DATABRICKS_CONFIG_PROFILE) |
|
|
579
|
+
| `--body-limit <value>` | Maximum JSON request body size. (default: "100mb", env: BODY_LIMIT) |
|
|
580
|
+
| `--runtime-info` | Print runtime implementation metadata. (default: false, env: RUNTIME_INFO) |
|
|
581
|
+
| `--no-runtime-info` | Disable print runtime implementation metadata. |
|
|
509
582
|
|
|
510
583
|
#### Commands
|
|
511
584
|
|
|
@@ -518,7 +591,7 @@ model-gateway [options] [command]
|
|
|
518
591
|
Install and manage the desktop service
|
|
519
592
|
|
|
520
593
|
```sh
|
|
521
|
-
model-gateway service [command]
|
|
594
|
+
dbx model-gateway service [command]
|
|
522
595
|
```
|
|
523
596
|
|
|
524
597
|
#### Commands
|
|
@@ -537,7 +610,7 @@ model-gateway service [command]
|
|
|
537
610
|
Install the service for the current user and start it
|
|
538
611
|
|
|
539
612
|
```sh
|
|
540
|
-
model-gateway service install [options]
|
|
613
|
+
dbx model-gateway service install [options]
|
|
541
614
|
```
|
|
542
615
|
|
|
543
616
|
#### Options
|
|
@@ -551,7 +624,7 @@ model-gateway service install [options]
|
|
|
551
624
|
Start the installed service
|
|
552
625
|
|
|
553
626
|
```sh
|
|
554
|
-
model-gateway service start
|
|
627
|
+
dbx model-gateway service start
|
|
555
628
|
```
|
|
556
629
|
|
|
557
630
|
### `dbx model-gateway service stop`
|
|
@@ -559,7 +632,7 @@ model-gateway service start
|
|
|
559
632
|
Stop the running service
|
|
560
633
|
|
|
561
634
|
```sh
|
|
562
|
-
model-gateway service stop
|
|
635
|
+
dbx model-gateway service stop
|
|
563
636
|
```
|
|
564
637
|
|
|
565
638
|
### `dbx model-gateway service restart`
|
|
@@ -567,7 +640,7 @@ model-gateway service stop
|
|
|
567
640
|
Restart the installed service
|
|
568
641
|
|
|
569
642
|
```sh
|
|
570
|
-
model-gateway service restart
|
|
643
|
+
dbx model-gateway service restart
|
|
571
644
|
```
|
|
572
645
|
|
|
573
646
|
### `dbx model-gateway service status`
|
|
@@ -575,7 +648,7 @@ model-gateway service restart
|
|
|
575
648
|
Print service installation and process state as JSON
|
|
576
649
|
|
|
577
650
|
```sh
|
|
578
|
-
model-gateway service status
|
|
651
|
+
dbx model-gateway service status
|
|
579
652
|
```
|
|
580
653
|
|
|
581
654
|
### `dbx model-gateway service uninstall`
|
|
@@ -583,34 +656,55 @@ model-gateway service status
|
|
|
583
656
|
Stop and remove the service for the current user
|
|
584
657
|
|
|
585
658
|
```sh
|
|
586
|
-
model-gateway service uninstall
|
|
659
|
+
dbx model-gateway service uninstall
|
|
587
660
|
```
|
|
588
661
|
|
|
662
|
+
### `dbx genie`
|
|
663
|
+
|
|
664
|
+
Run Genie Code through an authenticated local Databricks model gateway
|
|
665
|
+
|
|
666
|
+
```sh
|
|
667
|
+
dbx genie [options] [genieArgs...]
|
|
668
|
+
```
|
|
669
|
+
|
|
670
|
+
#### Arguments
|
|
671
|
+
|
|
672
|
+
| Argument | Description |
|
|
673
|
+
| ----------- | --------------------------------------------------------------------------------------------- |
|
|
674
|
+
| `genieArgs` | arguments and unknown flags forwarded to Genie Code; wrapper options may be separated with -- |
|
|
675
|
+
|
|
676
|
+
#### Options
|
|
677
|
+
|
|
678
|
+
| Option | Description |
|
|
679
|
+
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
680
|
+
| `--model <value>` | Optional fuzzy or exact model name. (env: MODEL) |
|
|
681
|
+
| `--model-class <value>` | Optional chat capability class used when selecting a default model. (choices: "chat-thinking", "chat-balanced", "chat-fast", env: MODEL_CLASS) |
|
|
682
|
+
| `--profile <value>` | Databricks profile used by the model-gateway sidecar. (env: DATABRICKS_CONFIG_PROFILE) |
|
|
683
|
+
| `--gateway-listen <value>` | Loopback listener allocated for the model-gateway sidecar. (default: tcp://127.0.0.1:0, env: GATEWAY_LISTEN) |
|
|
684
|
+
|
|
589
685
|
### `dbx graphiti`
|
|
590
686
|
|
|
591
687
|
Run Graphiti or manage its current-user desktop service
|
|
592
688
|
|
|
593
689
|
```sh
|
|
594
|
-
graphiti [options] [command]
|
|
690
|
+
dbx graphiti [options] [command]
|
|
595
691
|
```
|
|
596
692
|
|
|
597
693
|
#### Options
|
|
598
694
|
|
|
599
|
-
| Option | Description
|
|
600
|
-
| ---------------------------------- |
|
|
601
|
-
| `-v, --version` | output the version number
|
|
602
|
-
| `--profile <value>` | Databricks profile used for model discovery and authentication. (env: DATABRICKS_CONFIG_PROFILE)
|
|
603
|
-
| `--graphiti-home <value>` | Application-owned Graphiti runtime directory. (env: GRAPHITI_HOME)
|
|
604
|
-
| `--model <value>`
|
|
605
|
-
| `--temperature <value>` | Sampling temperature forwarded to the Graphiti LLM client. (default: 1, env: TEMPERATURE)
|
|
606
|
-
| `--
|
|
607
|
-
| `--
|
|
608
|
-
| `--
|
|
609
|
-
| `--
|
|
610
|
-
| `--
|
|
611
|
-
| `--
|
|
612
|
-
| `--database-schema <value>` | PostgreSQL schema used for Lakebase graph tables. (default: "dbx_tools_graphiti", env: GRAPHITI_DATABASE_SCHEMA) |
|
|
613
|
-
| `--postgres-role <value>` | PostgreSQL role assumed after authentication. (env: DBX_TOOLS_POSTGRES_ROLE) |
|
|
695
|
+
| Option | Description |
|
|
696
|
+
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
697
|
+
| `-v, --version` | output the version number |
|
|
698
|
+
| `--profile <value>` | Databricks profile used for model discovery and authentication. (env: DATABRICKS_CONFIG_PROFILE) |
|
|
699
|
+
| `--graphiti-home <value>` | Application-owned Graphiti runtime directory. (env: GRAPHITI_HOME) |
|
|
700
|
+
| `--model-class <value>` | Optional chat capability class used when selecting a default model. (choices: "chat-thinking", "chat-balanced", "chat-fast", default: "chat-fast", env: MODEL_CLASS) |
|
|
701
|
+
| `--temperature <value>` | Sampling temperature forwarded to the Graphiti LLM client. (default: 1, env: TEMPERATURE) |
|
|
702
|
+
| `--structured-output-mode <value>` | Structured-output mode forwarded to Graphiti's OpenAI provider. (default: "json_object", env: LLM_STRUCTURED_OUTPUT_MODE) |
|
|
703
|
+
| `--startup-timeout-ms <value>` | Maximum milliseconds allowed for the Graphiti runtime to become ready. (default: 180000, env: DBX_TOOLS_GRAPHITI_STARTUP_TIMEOUT_MS) |
|
|
704
|
+
| `--listen <value>` | Graphiti HTTP listener. (default: tcp://127.0.0.1:7272, env: GRAPHITI_LISTEN) |
|
|
705
|
+
| `--database-url <value>` | PostgreSQL URL or Lakebase target. Omit it to use persistent embedded PostgreSQL. (env: LAKEBASE_ENDPOINT) |
|
|
706
|
+
| `--database-schema <value>` | PostgreSQL schema used for Lakebase graph tables. (default: "dbx_tools_graphiti", env: GRAPHITI_DATABASE_SCHEMA) |
|
|
707
|
+
| `--postgres-role <value>` | PostgreSQL role assumed after authentication. (env: DBX_TOOLS_POSTGRES_ROLE) |
|
|
614
708
|
|
|
615
709
|
#### Commands
|
|
616
710
|
|
|
@@ -623,7 +717,7 @@ graphiti [options] [command]
|
|
|
623
717
|
Install and manage the desktop service
|
|
624
718
|
|
|
625
719
|
```sh
|
|
626
|
-
graphiti service [command]
|
|
720
|
+
dbx graphiti service [command]
|
|
627
721
|
```
|
|
628
722
|
|
|
629
723
|
#### Commands
|
|
@@ -642,7 +736,7 @@ graphiti service [command]
|
|
|
642
736
|
Install the service for the current user and start it
|
|
643
737
|
|
|
644
738
|
```sh
|
|
645
|
-
graphiti service install [options]
|
|
739
|
+
dbx graphiti service install [options]
|
|
646
740
|
```
|
|
647
741
|
|
|
648
742
|
#### Options
|
|
@@ -656,7 +750,7 @@ graphiti service install [options]
|
|
|
656
750
|
Start the installed service
|
|
657
751
|
|
|
658
752
|
```sh
|
|
659
|
-
graphiti service start
|
|
753
|
+
dbx graphiti service start
|
|
660
754
|
```
|
|
661
755
|
|
|
662
756
|
### `dbx graphiti service stop`
|
|
@@ -664,7 +758,7 @@ graphiti service start
|
|
|
664
758
|
Stop the running service
|
|
665
759
|
|
|
666
760
|
```sh
|
|
667
|
-
graphiti service stop
|
|
761
|
+
dbx graphiti service stop
|
|
668
762
|
```
|
|
669
763
|
|
|
670
764
|
### `dbx graphiti service restart`
|
|
@@ -672,7 +766,7 @@ graphiti service stop
|
|
|
672
766
|
Restart the installed service
|
|
673
767
|
|
|
674
768
|
```sh
|
|
675
|
-
graphiti service restart
|
|
769
|
+
dbx graphiti service restart
|
|
676
770
|
```
|
|
677
771
|
|
|
678
772
|
### `dbx graphiti service status`
|
|
@@ -680,7 +774,7 @@ graphiti service restart
|
|
|
680
774
|
Print service installation and process state as JSON
|
|
681
775
|
|
|
682
776
|
```sh
|
|
683
|
-
graphiti service status
|
|
777
|
+
dbx graphiti service status
|
|
684
778
|
```
|
|
685
779
|
|
|
686
780
|
### `dbx graphiti service uninstall`
|
|
@@ -688,7 +782,7 @@ graphiti service status
|
|
|
688
782
|
Stop and remove the service for the current user
|
|
689
783
|
|
|
690
784
|
```sh
|
|
691
|
-
graphiti service uninstall
|
|
785
|
+
dbx graphiti service uninstall
|
|
692
786
|
```
|
|
693
787
|
|
|
694
788
|
<!-- cli-reference:end -->
|
package/bin/dbx-genie.ts
ADDED
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
#!/usr/bin/env bun
|
|
2
|
+
|
|
3
|
+
import { buildProgram } from "../src/genie-code/cli.ts";
|
|
4
|
+
import { RUNNER_OPTIONS_ENV, runGenieCodeChild } from "../src/genie-code/runner.ts";
|
|
5
|
+
|
|
6
|
+
if (process.env[RUNNER_OPTIONS_ENV]) {
|
|
7
|
+
await runGenieCodeChild();
|
|
8
|
+
} else {
|
|
9
|
+
await buildProgram("dbx-genie").parseAsync(process.argv);
|
|
10
|
+
}
|
package/index.ts
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
// Hand edits are overwritten on the next watch; this file is read-only.
|
|
4
4
|
|
|
5
5
|
export const PACKAGE_IDENTIFIER = "@dbx-tools/cli";
|
|
6
|
-
export const PACKAGE_VERSION = "0.9.
|
|
6
|
+
export const PACKAGE_VERSION = "0.9.64";
|
|
7
7
|
export * as appkitCli from "./src/appkit/cli.ts";
|
|
8
8
|
export * as appkitEnvExport from "./src/appkit/env-export.ts";
|
|
9
9
|
export * as authCli from "./src/auth/cli.ts";
|
|
@@ -11,6 +11,12 @@ export * as authOptions from "./src/auth/options.ts";
|
|
|
11
11
|
export * as bootstrap from "./src/bootstrap.ts";
|
|
12
12
|
export * as bun from "./src/bun.ts";
|
|
13
13
|
export * as cli from "./src/cli.ts";
|
|
14
|
+
export * as genieCodeCli from "./src/genie-code/cli.ts";
|
|
15
|
+
export * as genieCodeConfig from "./src/genie-code/config.ts";
|
|
16
|
+
export * as genieCodeInstall from "./src/genie-code/install.ts";
|
|
17
|
+
export * as genieCodeOptions from "./src/genie-code/options.ts";
|
|
18
|
+
export * as genieCodeRunner from "./src/genie-code/runner.ts";
|
|
19
|
+
export * as genieCodeRuntime from "./src/genie-code/runtime.ts";
|
|
14
20
|
export * as graphitiCli from "./src/graphiti/cli.ts";
|
|
15
21
|
export * as graphitiOptions from "./src/graphiti/options.ts";
|
|
16
22
|
export * as lakebaseProxyCancellation from "./src/lakebase-proxy/cancellation.ts";
|
|
@@ -30,6 +36,12 @@ export type { EnvExportFormat, EnvCommandOptions } from "./src/appkit/env-export
|
|
|
30
36
|
export { AuthCliOptionsSchema, TokenCommandOptionsSchema } from "./src/auth/options.ts";
|
|
31
37
|
export type { AuthCliOptions, TokenCommandOptions } from "./src/auth/options.ts";
|
|
32
38
|
export { resolveBunArgv } from "./src/bun.ts";
|
|
39
|
+
export type { GenieCodeCliDependencies } from "./src/genie-code/cli.ts";
|
|
40
|
+
export { GENIE_CODE_GATEWAY_PROVIDER } from "./src/genie-code/config.ts";
|
|
41
|
+
export type { WriteGenieCodeConfigOptions, GenieCodeProfileHome, GenieCodeHome } from "./src/genie-code/config.ts";
|
|
42
|
+
export type { InstallGenieCodeOptions } from "./src/genie-code/install.ts";
|
|
43
|
+
export { RUNNER_OPTIONS_ENV } from "./src/genie-code/runner.ts";
|
|
44
|
+
export type { GenieCodeRuntimeDependencies, RunGenieCodeOptions, PreparedGenieCodeRuntime } from "./src/genie-code/runtime.ts";
|
|
33
45
|
export type { GraphitiCliDependencies, GraphitiServiceOptions } from "./src/graphiti/cli.ts";
|
|
34
46
|
export { CancellationRegistry } from "./src/lakebase-proxy/cancellation.ts";
|
|
35
47
|
export type { CancellationTarget, CancellationForwarder } from "./src/lakebase-proxy/cancellation.ts";
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
#!/usr/bin/env bun
|
|
2
|
+
import { buildProgram } from "../src/genie-code/cli.js";
|
|
3
|
+
import { RUNNER_OPTIONS_ENV, runGenieCodeChild } from "../src/genie-code/runner.js";
|
|
4
|
+
if (process.env[RUNNER_OPTIONS_ENV]) {
|
|
5
|
+
await runGenieCodeChild();
|
|
6
|
+
}
|
|
7
|
+
else {
|
|
8
|
+
await buildProgram("dbx-genie").parseAsync(process.argv);
|
|
9
|
+
}
|
|
10
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGJ4LWdlbmllLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vYmluL2RieC1nZW5pZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBRUEsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBQ3hELE9BQU8sRUFBRSxrQkFBa0IsRUFBRSxpQkFBaUIsRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBRXBGLElBQUksT0FBTyxDQUFDLEdBQUcsQ0FBQyxrQkFBa0IsQ0FBQyxFQUFFLENBQUM7SUFDcEMsTUFBTSxpQkFBaUIsRUFBRSxDQUFDO0FBQzVCLENBQUM7S0FBTSxDQUFDO0lBQ04sTUFBTSxZQUFZLENBQUMsV0FBVyxDQUFDLENBQUMsVUFBVSxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztBQUMzRCxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiIyEvdXNyL2Jpbi9lbnYgYnVuXG5cbmltcG9ydCB7IGJ1aWxkUHJvZ3JhbSB9IGZyb20gXCIuLi9zcmMvZ2VuaWUtY29kZS9jbGkudHNcIjtcbmltcG9ydCB7IFJVTk5FUl9PUFRJT05TX0VOViwgcnVuR2VuaWVDb2RlQ2hpbGQgfSBmcm9tIFwiLi4vc3JjL2dlbmllLWNvZGUvcnVubmVyLnRzXCI7XG5cbmlmIChwcm9jZXNzLmVudltSVU5ORVJfT1BUSU9OU19FTlZdKSB7XG4gIGF3YWl0IHJ1bkdlbmllQ29kZUNoaWxkKCk7XG59IGVsc2Uge1xuICBhd2FpdCBidWlsZFByb2dyYW0oXCJkYngtZ2VuaWVcIikucGFyc2VBc3luYyhwcm9jZXNzLmFyZ3YpO1xufVxuIl19
|
package/lib/index.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
export declare const PACKAGE_IDENTIFIER = "@dbx-tools/cli";
|
|
2
|
-
export declare const PACKAGE_VERSION = "0.9.
|
|
2
|
+
export declare const PACKAGE_VERSION = "0.9.64";
|
|
3
3
|
export * as appkitCli from "./src/appkit/cli.ts";
|
|
4
4
|
export * as appkitEnvExport from "./src/appkit/env-export.ts";
|
|
5
5
|
export * as authCli from "./src/auth/cli.ts";
|
|
@@ -7,6 +7,12 @@ export * as authOptions from "./src/auth/options.ts";
|
|
|
7
7
|
export * as bootstrap from "./src/bootstrap.ts";
|
|
8
8
|
export * as bun from "./src/bun.ts";
|
|
9
9
|
export * as cli from "./src/cli.ts";
|
|
10
|
+
export * as genieCodeCli from "./src/genie-code/cli.ts";
|
|
11
|
+
export * as genieCodeConfig from "./src/genie-code/config.ts";
|
|
12
|
+
export * as genieCodeInstall from "./src/genie-code/install.ts";
|
|
13
|
+
export * as genieCodeOptions from "./src/genie-code/options.ts";
|
|
14
|
+
export * as genieCodeRunner from "./src/genie-code/runner.ts";
|
|
15
|
+
export * as genieCodeRuntime from "./src/genie-code/runtime.ts";
|
|
10
16
|
export * as graphitiCli from "./src/graphiti/cli.ts";
|
|
11
17
|
export * as graphitiOptions from "./src/graphiti/options.ts";
|
|
12
18
|
export * as lakebaseProxyCancellation from "./src/lakebase-proxy/cancellation.ts";
|
|
@@ -26,6 +32,12 @@ export type { EnvExportFormat, EnvCommandOptions } from "./src/appkit/env-export
|
|
|
26
32
|
export { AuthCliOptionsSchema, TokenCommandOptionsSchema } from "./src/auth/options.ts";
|
|
27
33
|
export type { AuthCliOptions, TokenCommandOptions } from "./src/auth/options.ts";
|
|
28
34
|
export { resolveBunArgv } from "./src/bun.ts";
|
|
35
|
+
export type { GenieCodeCliDependencies } from "./src/genie-code/cli.ts";
|
|
36
|
+
export { GENIE_CODE_GATEWAY_PROVIDER } from "./src/genie-code/config.ts";
|
|
37
|
+
export type { WriteGenieCodeConfigOptions, GenieCodeProfileHome, GenieCodeHome } from "./src/genie-code/config.ts";
|
|
38
|
+
export type { InstallGenieCodeOptions } from "./src/genie-code/install.ts";
|
|
39
|
+
export { RUNNER_OPTIONS_ENV } from "./src/genie-code/runner.ts";
|
|
40
|
+
export type { GenieCodeRuntimeDependencies, RunGenieCodeOptions, PreparedGenieCodeRuntime } from "./src/genie-code/runtime.ts";
|
|
29
41
|
export type { GraphitiCliDependencies, GraphitiServiceOptions } from "./src/graphiti/cli.ts";
|
|
30
42
|
export { CancellationRegistry } from "./src/lakebase-proxy/cancellation.ts";
|
|
31
43
|
export type { CancellationTarget, CancellationForwarder } from "./src/lakebase-proxy/cancellation.ts";
|