@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 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 and bundles the reviewed `@databricks/sdk-*`
12
- 0.21.0 modules so generated service clients own stable API serialization and authentication.
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
- `DatabricksPreviewClient` remains only for APIs absent from the modular SDK: Agent Services, Genie
76
- Agent Mode streaming, Genie ACLs, Workspace object import/export, MLflow 3 tracing, and AI
77
- Gateway/model-service discovery.
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. A source-boundary test prevents this exception from spreading to stable services.
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 { DatabricksPreviewClient, databricksAgentServices } from '@fabric-harness/databricks';
145
+ import { databricks, databricksPrincipalFromEnv } from '@fabric-harness/databricks';
143
146
 
144
- const services = databricksAgentServices(
145
- new DatabricksPreviewClient({ host: process.env.DATABRICKS_HOST!, token: process.env.DATABRICKS_TOKEN! }),
146
- { acknowledgeBeta: true },
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',