@fabric-harness/databricks 4.4.1 → 4.7.0

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
@@ -78,6 +78,18 @@ discovery, and the ResponsesAgent custom request schema. Its exhaustive method-a
78
78
  rejects every other route before credential resolution or network I/O. Callers use typed bundle
79
79
  capabilities rather than constructing that transport.
80
80
 
81
+ Fabric verticals must import this package instead of implementing local Databricks authentication,
82
+ clients, credential exchange, polling, or retry logic. Applications retain only domain resource
83
+ names, policies, and readiness composition.
84
+
85
+ ### Fabric Platform integration
86
+
87
+ The optional `@fabric-harness/databricks/platform` subpath maps Databricks resource identity and
88
+ execution results into the provider-neutral contracts shipped by `@fabricorg/platform@^0.8.0`.
89
+ It records workspace resource references and effective principal delegation without tokens or
90
+ secrets. Platform remains the canonical business-mutation and approval ledger; Harness returns
91
+ technical execution attestations to that invocation.
92
+
81
93
  Two compatibility exceptions are deliberately quarantined in SDK 0.21. The generated Genie
82
94
  query-result parser rejects Databricks' real row-array payload, and the shared JSON decoder attempts
83
95
  to convert a floating-point AI Search score to `BigInt`. Fabric retries only those read-only responses
@@ -185,6 +197,16 @@ Run the opt-in credential/connection smoke with `FABRIC_DATABRICKS_LAKEBASE_TEST
185
197
  `DATABRICKS_HOST`, either `DATABRICKS_TOKEN` or M2M client credentials, `ENDPOINT_NAME`, `PGHOST`,
186
198
  `PGDATABASE`, and `PGUSER`.
187
199
 
200
+ ## Vertical application control-plane seams
201
+
202
+ Vertical applications import Databricks behavior from this package instead of maintaining their
203
+ own token, SQL, or discovery clients. `createDatabricksAuthenticatedFetch()` adapts the canonical
204
+ principal to third-party SDKs with a bounded authentication retry. `runStatement()` uses the
205
+ generated Statement Execution client. `databricks(...).aiGateway` discovers both system model
206
+ services and governed model-provider services, while `databricks(...).sqlWarehouses.list()` covers
207
+ the reviewed SDK gap for warehouse discovery. Credentials remain outside returned evidence and
208
+ application mutation parameters.
209
+
188
210
  ## SQL Warehouse sandbox
189
211
 
190
212
  ```ts
package/dist/agent.d.ts CHANGED
@@ -2,6 +2,8 @@ import type { AgentDefinition, AgentProfile, AgentRunContext, DefinedAgent, Json
2
2
  import type { DatabricksBundle, DatabricksBundleConfig } from "./index.js";
3
3
  export type DefineDatabricksAgentOptions<TInput = JsonObject, TOutput = unknown> = Omit<AgentDefinition<TInput, TOutput>, "run" | "tools"> & {
4
4
  databricks?: DatabricksBundleConfig;
5
+ /** Configure the governed Genie + SELECT-only SQL + cost-reporting product spine from env. */
6
+ analyticsCopilot?: boolean;
5
7
  modelProvider?: ModelProvider;
6
8
  tools?: Array<ToolDef | string>;
7
9
  sandbox?: SandboxBackend;
@@ -1 +1 @@
1
- {"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEf,YAAY,EACZ,eAAe,EACf,YAAY,EAGZ,UAAU,EACV,aAAa,EACb,cAAc,EACd,OAAO,EACR,MAAM,qBAAqB,CAAC;AAO7B,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAI3E,MAAM,MAAM,4BAA4B,CAAC,MAAM,GAAG,UAAU,EAAE,OAAO,GAAG,OAAO,IAAI,IAAI,CACrF,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,KAAK,GAAG,OAAO,CAChB,GAAG;IACF,UAAU,CAAC,EAAE,sBAAsB,CAAC;IACpC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,KAAK,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,GAAG,CAAC,EAAE,CACJ,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG;QAAE,UAAU,EAAE,gBAAgB,CAAA;KAAE,KAChE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACjC,CAAC;AAkEF,wBAAgB,qBAAqB,CAAC,MAAM,GAAG,UAAU,EAAE,OAAO,GAAG,OAAO,EAC1E,OAAO,GAAE,4BAA4B,CAAC,MAAM,EAAE,OAAO,CAAM,GAC1D,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CA6C/B;AAuBD,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAgCnF"}
1
+ {"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEf,YAAY,EACZ,eAAe,EACf,YAAY,EAGZ,UAAU,EACV,aAAa,EACb,cAAc,EACd,OAAO,EACR,MAAM,qBAAqB,CAAC;AAS7B,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAI3E,MAAM,MAAM,4BAA4B,CAAC,MAAM,GAAG,UAAU,EAAE,OAAO,GAAG,OAAO,IAAI,IAAI,CACrF,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,KAAK,GAAG,OAAO,CAChB,GAAG;IACF,UAAU,CAAC,EAAE,sBAAsB,CAAC;IACpC,8FAA8F;IAC9F,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,KAAK,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,GAAG,CAAC,EAAE,CACJ,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG;QAAE,UAAU,EAAE,gBAAgB,CAAA;KAAE,KAChE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACjC,CAAC;AAkEF,wBAAgB,qBAAqB,CAAC,MAAM,GAAG,UAAU,EAAE,OAAO,GAAG,OAAO,EAC1E,OAAO,GAAE,4BAA4B,CAAC,MAAM,EAAE,OAAO,CAAM,GAC1D,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAoD/B;AA0ED,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAiCnF"}