@dbx-tools/genie 0.9.99 → 0.9.105

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.
Files changed (5) hide show
  1. package/README.md +19 -14
  2. package/index.ts +1 -1
  3. package/lib/index.d.ts +1 -1
  4. package/lib/index.js +2 -2
  5. package/package.json +4 -4
package/README.md CHANGED
@@ -2,11 +2,19 @@
2
2
 
3
3
  Server-side Databricks Genie chat drivers.
4
4
 
5
- Import this package when Node or AppKit backend code needs to run one turn
6
- against a Genie space and consume either raw Genie message snapshots or a typed
7
- event stream. It preserves AppKit OBO auth when called inside an AppKit request,
8
- falls back to the Databricks SDK default auth outside AppKit, and supports
9
- caller-provided cancellation.
5
+ Run a Genie turn from Node or AppKit code and consume raw message snapshots or a
6
+ typed event stream. AppKit requests keep their OBO identity; standalone callers
7
+ use the Databricks SDK authentication chain. Both modes support cancellation.
8
+
9
+ ## Quick Start
10
+
11
+ ```ts
12
+ import { chat } from "@dbx-tools/genie";
13
+
14
+ for await (const event of chat.genieEventChat(spaceId, "Top stores by revenue?")) {
15
+ console.log(event.type, event);
16
+ }
17
+ ```
10
18
 
11
19
  Pure Genie schemas and event detector helpers live in
12
20
  [`@dbx-tools/shared-genie`](../../shared/genie).
@@ -29,7 +37,7 @@ Key features:
29
37
  CLI tools.
30
38
  - Fetches Genie space metadata and starter questions for UI suggestions.
31
39
 
32
- ## Why Not Just AppKit Genie?
40
+ ## Choose The Driver Or AppKit Genie
33
41
 
34
42
  Native AppKit's Genie plugin is the right choice for a standalone Genie chat
35
43
  experience: it provides named space aliases, SSE status updates, conversation
@@ -49,7 +57,7 @@ backend:
49
57
  - You need the same driver to work inside AppKit with OBO auth and outside
50
58
  AppKit from scripts using normal Databricks SDK auth.
51
59
 
52
- ## Stream Semantic Events
60
+ ## Handle Semantic Events
53
61
 
54
62
  ```ts
55
63
  import { chat } from "@dbx-tools/genie";
@@ -109,13 +117,10 @@ for (const prompt of prompts) {
109
117
  }
110
118
  ```
111
119
 
112
- The driver does not own multi-turn state. Callers read the conversation id from
113
- a yielded message/event and pass it into the next turn. That makes the package
114
- usable in stateless route handlers, durable thread stores, and one-off scripts.
115
-
116
- This split is deliberate: the package is a transport/driver layer, not a thread
117
- store. AppKit-Mastra persists thread state separately and passes the Genie
118
- conversation id back into this driver when a turn continues.
120
+ Callers keep multi-turn state by reading the conversation id from a yielded
121
+ message or event and passing it into the next turn. This works in stateless
122
+ route handlers, durable thread stores, and one-off scripts. AppKit-Mastra stores
123
+ the id with its thread and passes it back when a conversation continues.
119
124
 
120
125
  ## Resolve A Workspace Client
121
126
 
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/genie";
6
- export const PACKAGE_VERSION = "0.9.99";
6
+ export const PACKAGE_VERSION = "0.9.105";
7
7
  export * as agentMode from "./src/agent-mode.ts";
8
8
  export * as chat from "./src/chat.ts";
9
9
  export * as space from "./src/space.ts";
package/lib/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  export declare const PACKAGE_IDENTIFIER = "@dbx-tools/genie";
2
- export declare const PACKAGE_VERSION = "0.9.99";
2
+ export declare const PACKAGE_VERSION = "0.9.105";
3
3
  export * as agentMode from "./src/agent-mode.ts";
4
4
  export * as chat from "./src/chat.ts";
5
5
  export * as space from "./src/space.ts";
package/lib/index.js CHANGED
@@ -2,8 +2,8 @@
2
2
  // Regenerated from the exporting modules in ./src.
3
3
  // Hand edits are overwritten on the next watch; this file is read-only.
4
4
  export const PACKAGE_IDENTIFIER = "@dbx-tools/genie";
5
- export const PACKAGE_VERSION = "0.9.99";
5
+ export const PACKAGE_VERSION = "0.9.105";
6
6
  export * as agentMode from "./src/agent-mode.js";
7
7
  export * as chat from "./src/chat.js";
8
8
  export * as space from "./src/space.js";
9
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSwyQ0FBMkM7QUFDM0MsbURBQW1EO0FBQ25ELHdFQUF3RTtBQUV4RSxNQUFNLENBQUMsTUFBTSxrQkFBa0IsR0FBRyxrQkFBa0IsQ0FBQztBQUNyRCxNQUFNLENBQUMsTUFBTSxlQUFlLEdBQUcsUUFBUSxDQUFDO0FBQ3hDLE9BQU8sS0FBSyxTQUFTLE1BQU0scUJBQXFCLENBQUM7QUFDakQsT0FBTyxLQUFLLElBQUksTUFBTSxlQUFlLENBQUM7QUFDdEMsT0FBTyxLQUFLLEtBQUssTUFBTSxnQkFBZ0IsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8vIEdFTkVSQVRFRCBieSBwcm9qZW4gd2F0Y2ggLSBETyBOT1QgRURJVC5cbi8vIFJlZ2VuZXJhdGVkIGZyb20gdGhlIGV4cG9ydGluZyBtb2R1bGVzIGluIC4vc3JjLlxuLy8gSGFuZCBlZGl0cyBhcmUgb3ZlcndyaXR0ZW4gb24gdGhlIG5leHQgd2F0Y2g7IHRoaXMgZmlsZSBpcyByZWFkLW9ubHkuXG5cbmV4cG9ydCBjb25zdCBQQUNLQUdFX0lERU5USUZJRVIgPSBcIkBkYngtdG9vbHMvZ2VuaWVcIjtcbmV4cG9ydCBjb25zdCBQQUNLQUdFX1ZFUlNJT04gPSBcIjAuOS45OVwiO1xuZXhwb3J0ICogYXMgYWdlbnRNb2RlIGZyb20gXCIuL3NyYy9hZ2VudC1tb2RlLnRzXCI7XG5leHBvcnQgKiBhcyBjaGF0IGZyb20gXCIuL3NyYy9jaGF0LnRzXCI7XG5leHBvcnQgKiBhcyBzcGFjZSBmcm9tIFwiLi9zcmMvc3BhY2UudHNcIjtcbmV4cG9ydCB0eXBlIHsgR2VuaWVBZ2VudE1vZGVPcHRpb25zIH0gZnJvbSBcIi4vc3JjL2FnZW50LW1vZGUudHNcIjtcbmV4cG9ydCB0eXBlIHsgR2VuaWVDaGF0T3B0aW9ucyB9IGZyb20gXCIuL3NyYy9jaGF0LnRzXCI7XG5leHBvcnQgdHlwZSB7IEdldEdlbmllU3BhY2VPcHRpb25zIH0gZnJvbSBcIi4vc3JjL3NwYWNlLnRzXCI7XG4iXX0=
9
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSwyQ0FBMkM7QUFDM0MsbURBQW1EO0FBQ25ELHdFQUF3RTtBQUV4RSxNQUFNLENBQUMsTUFBTSxrQkFBa0IsR0FBRyxrQkFBa0IsQ0FBQztBQUNyRCxNQUFNLENBQUMsTUFBTSxlQUFlLEdBQUcsU0FBUyxDQUFDO0FBQ3pDLE9BQU8sS0FBSyxTQUFTLE1BQU0scUJBQXFCLENBQUM7QUFDakQsT0FBTyxLQUFLLElBQUksTUFBTSxlQUFlLENBQUM7QUFDdEMsT0FBTyxLQUFLLEtBQUssTUFBTSxnQkFBZ0IsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8vIEdFTkVSQVRFRCBieSBwcm9qZW4gd2F0Y2ggLSBETyBOT1QgRURJVC5cbi8vIFJlZ2VuZXJhdGVkIGZyb20gdGhlIGV4cG9ydGluZyBtb2R1bGVzIGluIC4vc3JjLlxuLy8gSGFuZCBlZGl0cyBhcmUgb3ZlcndyaXR0ZW4gb24gdGhlIG5leHQgd2F0Y2g7IHRoaXMgZmlsZSBpcyByZWFkLW9ubHkuXG5cbmV4cG9ydCBjb25zdCBQQUNLQUdFX0lERU5USUZJRVIgPSBcIkBkYngtdG9vbHMvZ2VuaWVcIjtcbmV4cG9ydCBjb25zdCBQQUNLQUdFX1ZFUlNJT04gPSBcIjAuOS4xMDVcIjtcbmV4cG9ydCAqIGFzIGFnZW50TW9kZSBmcm9tIFwiLi9zcmMvYWdlbnQtbW9kZS50c1wiO1xuZXhwb3J0ICogYXMgY2hhdCBmcm9tIFwiLi9zcmMvY2hhdC50c1wiO1xuZXhwb3J0ICogYXMgc3BhY2UgZnJvbSBcIi4vc3JjL3NwYWNlLnRzXCI7XG5leHBvcnQgdHlwZSB7IEdlbmllQWdlbnRNb2RlT3B0aW9ucyB9IGZyb20gXCIuL3NyYy9hZ2VudC1tb2RlLnRzXCI7XG5leHBvcnQgdHlwZSB7IEdlbmllQ2hhdE9wdGlvbnMgfSBmcm9tIFwiLi9zcmMvY2hhdC50c1wiO1xuZXhwb3J0IHR5cGUgeyBHZXRHZW5pZVNwYWNlT3B0aW9ucyB9IGZyb20gXCIuL3NyYy9zcGFjZS50c1wiO1xuIl19
package/package.json CHANGED
@@ -24,9 +24,9 @@
24
24
  },
25
25
  "dependencies": {
26
26
  "@databricks/appkit": "0.81.0",
27
- "@dbx-tools/appkit": "^0.9.99",
28
- "@dbx-tools/shared-core": "^0.9.99",
29
- "@dbx-tools/shared-genie": "^0.9.99"
27
+ "@dbx-tools/appkit": "^0.9.105",
28
+ "@dbx-tools/shared-core": "^0.9.105",
29
+ "@dbx-tools/shared-genie": "^0.9.105"
30
30
  },
31
31
  "main": "./lib/index.js",
32
32
  "license": "Apache-2.0",
@@ -54,7 +54,7 @@
54
54
  "./package.json": "./package.json"
55
55
  }
56
56
  },
57
- "version": "0.9.99",
57
+ "version": "0.9.105",
58
58
  "types": "./lib/index.d.ts",
59
59
  "dbxToolsConfig": {
60
60
  "tags": [