@fabric-harness/databricks 3.0.3 → 4.0.1
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 +17 -12
- package/dist/agent.js +495 -29
- package/dist/agent.js.map +1 -1
- package/dist/app-user-authorization.d.ts.map +1 -1
- package/dist/app.d.ts +6 -0
- package/dist/app.d.ts.map +1 -1
- package/dist/authoring-certification.d.ts +18 -2
- package/dist/authoring-certification.d.ts.map +1 -1
- package/dist/capabilities.d.ts.map +1 -1
- package/dist/certification-sweeper.d.ts +11 -0
- package/dist/certification-sweeper.d.ts.map +1 -1
- package/dist/certify.js +2141 -1993
- package/dist/certify.js.map +1 -1
- package/dist/client.d.ts.map +1 -1
- package/dist/compatibility.d.ts +4 -2
- package/dist/compatibility.d.ts.map +1 -1
- package/dist/genie-authoring.d.ts.map +1 -1
- package/dist/index.d.ts +30 -16
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +581 -464
- package/dist/index.js.map +1 -1
- package/dist/native-sdk.d.ts +4 -0
- package/dist/native-sdk.d.ts.map +1 -1
- package/dist/serving-admin.d.ts +29 -4
- package/dist/serving-admin.d.ts.map +1 -1
- package/dist/sql-sandbox.js +69 -7
- package/dist/sql-sandbox.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -8,8 +8,8 @@ First-party Databricks integration helpers for Fabric Harness, with mock-first l
|
|
|
8
8
|
npm install @fabric-harness/databricks @fabric-harness/sdk
|
|
9
9
|
```
|
|
10
10
|
|
|
11
|
-
Node 22 or newer is required. The package pins
|
|
12
|
-
0.21.0
|
|
11
|
+
Node 22 or newer is required. The package exact-pins every reviewed `@databricks/sdk-*` module to
|
|
12
|
+
SDK release `0.21.0`, so generated service clients own stable API serialization and authentication.
|
|
13
13
|
|
|
14
14
|
Add `@fabric-harness/node` and `pg` only when using the Node persistence helpers.
|
|
15
15
|
|
|
@@ -71,16 +71,19 @@ await jobs.runJob({ jobId: 42, idempotencyToken: submission.id });
|
|
|
71
71
|
|
|
72
72
|
`databricks({ ... }).sdk` exposes the principal-bound generated clients to custom agent runs. Fabric
|
|
73
73
|
adds governance, approval, lifecycle safety, retries for explicitly idempotent operations, lineage,
|
|
74
|
-
and durable state; it does not reimplement stable Databricks service APIs. A small
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
74
|
+
and durable state; it does not reimplement stable Databricks service APIs. A small private preview
|
|
75
|
+
transport remains only for APIs absent from the modular SDK: Agent Services, Genie Agent Mode
|
|
76
|
+
streaming, Genie ACLs, Workspace object import/export, MLflow 3 tracing, AI Gateway/model-service
|
|
77
|
+
discovery, and the ResponsesAgent custom request schema. Its exhaustive method-and-path allowlist
|
|
78
|
+
rejects every other route before credential resolution or network I/O. Callers use typed bundle
|
|
79
|
+
capabilities rather than constructing that transport.
|
|
78
80
|
|
|
79
81
|
One compatibility exception is deliberately quarantined: SDK 0.21's generated Genie query-result
|
|
80
82
|
parser rejects Databricks' real row-array payload. Genie retries that one decoded response through the
|
|
81
83
|
preview transport only when the generated client raises the exact schema error. Authentication,
|
|
82
84
|
conversation lifecycle, polling, and unrelated failures continue through or fail from the official
|
|
83
|
-
client.
|
|
85
|
+
client. Source-boundary and runtime-denial tests prevent this exception from spreading to stable
|
|
86
|
+
services.
|
|
84
87
|
|
|
85
88
|
## Shipped surface
|
|
86
89
|
|
|
@@ -139,12 +142,14 @@ See [Databricks resource management](https://harness.fabric.pro/docs/databricks/
|
|
|
139
142
|
## Unity Catalog Agent Services
|
|
140
143
|
|
|
141
144
|
```ts
|
|
142
|
-
import {
|
|
145
|
+
import { databricks, databricksPrincipalFromEnv } from '@fabric-harness/databricks';
|
|
143
146
|
|
|
144
|
-
const
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
147
|
+
const workspace = databricks({
|
|
148
|
+
host: process.env.DATABRICKS_HOST!,
|
|
149
|
+
principal: databricksPrincipalFromEnv(process.env),
|
|
150
|
+
agentServices: { acknowledgeBeta: true },
|
|
151
|
+
});
|
|
152
|
+
const services = workspace.agentServices!;
|
|
148
153
|
|
|
149
154
|
await services.create({
|
|
150
155
|
catalog: 'main',
|