@fabric-harness/databricks 4.7.0 → 4.8.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 +25 -0
- package/dist/platform.d.ts +5 -1
- package/dist/platform.d.ts.map +1 -1
- package/dist/platform.js +12 -0
- package/dist/platform.js.map +1 -1
- package/dist/runtime.d.ts +33 -0
- package/dist/runtime.d.ts.map +1 -0
- package/dist/runtime.js +53046 -0
- package/dist/runtime.js.map +1 -0
- package/package.json +15 -11
- package/dist/agent-services.js +0 -142
- package/dist/agent-services.js.map +0 -1
- package/dist/ai-gateway.js +0 -51
- package/dist/ai-gateway.js.map +0 -1
- package/dist/ai-search-admin.js +0 -194
- package/dist/ai-search-admin.js.map +0 -1
- package/dist/ai.js +0 -22
- package/dist/ai.js.map +0 -1
- package/dist/app.js +0 -143
- package/dist/app.js.map +0 -1
- package/dist/authoring-certification.js +0 -476
- package/dist/authoring-certification.js.map +0 -1
- package/dist/capabilities.js +0 -633
- package/dist/capabilities.js.map +0 -1
- package/dist/certification-resource.js +0 -17
- package/dist/certification-resource.js.map +0 -1
- package/dist/certification-sweeper.js +0 -128
- package/dist/certification-sweeper.js.map +0 -1
- package/dist/certification.js +0 -236
- package/dist/certification.js.map +0 -1
- package/dist/client.d.ts +0 -58
- package/dist/client.d.ts.map +0 -1
- package/dist/client.js +0 -184
- package/dist/client.js.map +0 -1
- package/dist/compatibility.js +0 -88
- package/dist/compatibility.js.map +0 -1
- package/dist/consumption.js +0 -85
- package/dist/consumption.js.map +0 -1
- package/dist/cost-budget-actuals.js +0 -316
- package/dist/cost-budget-actuals.js.map +0 -1
- package/dist/embeddings.js +0 -24
- package/dist/embeddings.js.map +0 -1
- package/dist/feature-serving.js +0 -29
- package/dist/feature-serving.js.map +0 -1
- package/dist/genie-agent-mode.js +0 -374
- package/dist/genie-agent-mode.js.map +0 -1
- package/dist/genie-authoring.js +0 -898
- package/dist/genie-authoring.js.map +0 -1
- package/dist/genie.js +0 -405
- package/dist/genie.js.map +0 -1
- package/dist/governance.js +0 -353
- package/dist/governance.js.map +0 -1
- package/dist/identity.js +0 -229
- package/dist/identity.js.map +0 -1
- package/dist/jobs-authoring.js +0 -570
- package/dist/jobs-authoring.js.map +0 -1
- package/dist/jobs.js +0 -173
- package/dist/jobs.js.map +0 -1
- package/dist/lakebase.js +0 -110
- package/dist/lakebase.js.map +0 -1
- package/dist/lakeflow-authoring.js +0 -115
- package/dist/lakeflow-authoring.js.map +0 -1
- package/dist/lakeflow.js +0 -75
- package/dist/lakeflow.js.map +0 -1
- package/dist/managed-resource.js +0 -197
- package/dist/managed-resource.js.map +0 -1
- package/dist/mlflow-tracing.js +0 -167
- package/dist/mlflow-tracing.js.map +0 -1
- package/dist/mock-provider.js +0 -66
- package/dist/mock-provider.js.map +0 -1
- package/dist/model.js +0 -173
- package/dist/model.js.map +0 -1
- package/dist/persistence.js +0 -82
- package/dist/persistence.js.map +0 -1
- package/dist/rag-chain.js +0 -212
- package/dist/rag-chain.js.map +0 -1
- package/dist/rag-eval.js +0 -151
- package/dist/rag-eval.js.map +0 -1
- package/dist/secrets-authoring.js +0 -78
- package/dist/secrets-authoring.js.map +0 -1
- package/dist/secrets.js +0 -25
- package/dist/secrets.js.map +0 -1
- package/dist/serving-admin.js +0 -255
- package/dist/serving-admin.js.map +0 -1
- package/dist/serving-usage.js +0 -100
- package/dist/serving-usage.js.map +0 -1
- package/dist/sql-exec.js +0 -36
- package/dist/sql-exec.js.map +0 -1
- package/dist/telemetry-sink.js +0 -180
- package/dist/telemetry-sink.js.map +0 -1
- package/dist/tools.js +0 -167
- package/dist/tools.js.map +0 -1
- package/dist/unity-catalog-admin.js +0 -166
- package/dist/unity-catalog-admin.js.map +0 -1
- package/dist/vector-search.js +0 -65
- package/dist/vector-search.js.map +0 -1
- package/dist/volumes-attachment-store.js +0 -172
- package/dist/volumes-attachment-store.js.map +0 -1
- package/dist/workspace-authoring.js +0 -78
- package/dist/workspace-authoring.js.map +0 -1
package/README.md
CHANGED
|
@@ -82,6 +82,27 @@ Fabric verticals must import this package instead of implementing local Databric
|
|
|
82
82
|
clients, credential exchange, polling, or retry logic. Applications retain only domain resource
|
|
83
83
|
names, policies, and readiness composition.
|
|
84
84
|
|
|
85
|
+
Server application bundles should import control-plane, generated SDK, SQL, identity, and Lakebase
|
|
86
|
+
helpers from `@fabric-harness/databricks/runtime`. That subpath intentionally excludes Harness build,
|
|
87
|
+
deployment, and agent-authoring modules, so frameworks such as Next.js do not trace build-time Node
|
|
88
|
+
tooling into request handlers. Agent definitions and release tooling continue to use the root export.
|
|
89
|
+
|
|
90
|
+
```ts
|
|
91
|
+
import {
|
|
92
|
+
databricksControlPlane,
|
|
93
|
+
databricksPrincipalFromEnv,
|
|
94
|
+
databricksSdk,
|
|
95
|
+
} from '@fabric-harness/databricks/runtime';
|
|
96
|
+
|
|
97
|
+
const principal = databricksPrincipalFromEnv(process.env);
|
|
98
|
+
const sdk = databricksSdk({ host: process.env.DATABRICKS_HOST!, principal });
|
|
99
|
+
const controlPlane = databricksControlPlane({
|
|
100
|
+
host: process.env.DATABRICKS_HOST!,
|
|
101
|
+
principal,
|
|
102
|
+
});
|
|
103
|
+
const warehouses = await controlPlane.sqlWarehouses.list();
|
|
104
|
+
```
|
|
105
|
+
|
|
85
106
|
### Fabric Platform integration
|
|
86
107
|
|
|
87
108
|
The optional `@fabric-harness/databricks/platform` subpath maps Databricks resource identity and
|
|
@@ -241,3 +262,7 @@ console.log(result.stdout);
|
|
|
241
262
|
- [Capability matrix](https://github.com/Fabric-Pro/fabric-harness/blob/main/docs/capability-matrix.md)
|
|
242
263
|
|
|
243
264
|
Keep Databricks credentials in environment variables or a secret store. Never place tokens in prompts, payloads, tool inputs, or lineage labels.
|
|
265
|
+
|
|
266
|
+
Host-based applications should compose `databricksGovernanceRuntimeEvidence()` from the `platform`
|
|
267
|
+
entrypoint into `createGovernedActionHost({ runtimeEvidence })`. Each invocation then records the
|
|
268
|
+
exact provider-bridge generation beside its Host and policy generations.
|
package/dist/platform.d.ts
CHANGED
|
@@ -1,5 +1,9 @@
|
|
|
1
|
-
import type { ExecutionAttestation, ExecutionPrincipal, ExternalResourceOperation, ExternalResourceRef, MutationGovernanceResolver } from "@fabricorg/platform/governance";
|
|
1
|
+
import type { ExecutionAttestation, ExecutionPrincipal, ExternalResourceOperation, ExternalResourceRef, GovernanceRuntimeEvidence, MutationGovernanceResolver } from "@fabricorg/platform/governance";
|
|
2
2
|
import type { DatabricksPrincipal } from "./identity.js";
|
|
3
|
+
/** Durable generation of the Harness-to-Platform Databricks governance bridge. */
|
|
4
|
+
export declare const DATABRICKS_PLATFORM_GOVERNANCE_BRIDGE_VERSION = "1";
|
|
5
|
+
/** Runtime evidence applications pass directly to `createGovernedActionHost`. */
|
|
6
|
+
export declare function databricksGovernanceRuntimeEvidence(overrides?: Pick<GovernanceRuntimeEvidence, "hostPackageVersion" | "policyRulesetVersion">): Partial<GovernanceRuntimeEvidence>;
|
|
3
7
|
export interface DatabricksPlatformResource {
|
|
4
8
|
resourceType: string;
|
|
5
9
|
resourceId: string;
|
package/dist/platform.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,yBAAyB,EACzB,mBAAmB,EACnB,0BAA0B,EAC3B,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGzD,MAAM,WAAW,0BAA0B;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,yBAAyB,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,mCAAmC;IAClD,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,mBAAmB,CAAC;IAC/B,gBAAgB,EAAE,CAChB,KAAK,EAAE,UAAU,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,KAC7C,OAAO,CAAC,0BAA0B,EAAE,CAAC,GAAG,0BAA0B,EAAE,CAAC;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,6BAA6B,CAC3C,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,IAAI,CAAC,0BAA0B,EAAE,WAAW,GAAG,qBAAqB,CAAC,GAC9E,mBAAmB,CAWrB;AAED,6FAA6F;AAC7F,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,mBAAmB,EAC9B,WAAW,CAAC,EAAE,kBAAkB,EAChC,UAAU,CAAC,EAAE,MAAM,GAClB,kBAAkB,CAYpB;AAED,kGAAkG;AAClG,wBAAgB,0CAA0C,CACxD,OAAO,EAAE,mCAAmC,GAC3C,0BAA0B,CAqB5B;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,IAAI,CAAC,0BAA0B,EAAE,WAAW,GAAG,qBAAqB,CAAC,CAAC;IACjF,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,0BAA0B,GAChC,oBAAoB,CAqBtB"}
|
|
1
|
+
{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,yBAAyB,EACzB,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGzD,kFAAkF;AAClF,eAAO,MAAM,6CAA6C,MAAM,CAAC;AAEjE,iFAAiF;AACjF,wBAAgB,mCAAmC,CACjD,SAAS,GAAE,IAAI,CAAC,yBAAyB,EAAE,oBAAoB,GAAG,sBAAsB,CAAM,GAC7F,OAAO,CAAC,yBAAyB,CAAC,CAQpC;AAED,MAAM,WAAW,0BAA0B;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,yBAAyB,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,mCAAmC;IAClD,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,mBAAmB,CAAC;IAC/B,gBAAgB,EAAE,CAChB,KAAK,EAAE,UAAU,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,KAC7C,OAAO,CAAC,0BAA0B,EAAE,CAAC,GAAG,0BAA0B,EAAE,CAAC;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,6BAA6B,CAC3C,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,IAAI,CAAC,0BAA0B,EAAE,WAAW,GAAG,qBAAqB,CAAC,GAC9E,mBAAmB,CAWrB;AAED,6FAA6F;AAC7F,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,mBAAmB,EAC9B,WAAW,CAAC,EAAE,kBAAkB,EAChC,UAAU,CAAC,EAAE,MAAM,GAClB,kBAAkB,CAYpB;AAED,kGAAkG;AAClG,wBAAgB,0CAA0C,CACxD,OAAO,EAAE,mCAAmC,GAC3C,0BAA0B,CAqB5B;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,IAAI,CAAC,0BAA0B,EAAE,WAAW,GAAG,qBAAqB,CAAC,CAAC;IACjF,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,0BAA0B,GAChC,oBAAoB,CAqBtB"}
|
package/dist/platform.js
CHANGED
|
@@ -9,6 +9,16 @@ function databricksWorkspaceOrigin(host) {
|
|
|
9
9
|
}
|
|
10
10
|
|
|
11
11
|
// src/platform.ts
|
|
12
|
+
var DATABRICKS_PLATFORM_GOVERNANCE_BRIDGE_VERSION = "1";
|
|
13
|
+
function databricksGovernanceRuntimeEvidence(overrides = {}) {
|
|
14
|
+
return {
|
|
15
|
+
...overrides,
|
|
16
|
+
providerBridge: {
|
|
17
|
+
name: "@fabric-harness/databricks",
|
|
18
|
+
version: DATABRICKS_PLATFORM_GOVERNANCE_BRIDGE_VERSION
|
|
19
|
+
}
|
|
20
|
+
};
|
|
21
|
+
}
|
|
12
22
|
function databricksPlatformResourceRef(workspaceHost, resource) {
|
|
13
23
|
return {
|
|
14
24
|
provider: "databricks",
|
|
@@ -82,9 +92,11 @@ function principalLabel(principal) {
|
|
|
82
92
|
}
|
|
83
93
|
}
|
|
84
94
|
export {
|
|
95
|
+
DATABRICKS_PLATFORM_GOVERNANCE_BRIDGE_VERSION,
|
|
85
96
|
createDatabricksMutationGovernanceResolver,
|
|
86
97
|
databricksExecutionAttestation,
|
|
87
98
|
databricksExecutionPrincipal,
|
|
99
|
+
databricksGovernanceRuntimeEvidence,
|
|
88
100
|
databricksPlatformResourceRef
|
|
89
101
|
};
|
|
90
102
|
//# sourceMappingURL=platform.js.map
|
package/dist/platform.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/workspace-origin.ts","../src/platform.ts"],"sourcesContent":["/** Normalize a workspace hostname or URL to its HTTPS origin. */\nexport function databricksWorkspaceOrigin(host: string): string {\n const value = host.trim();\n if (!value) throw new Error(\"databricks: workspace host cannot be empty.\");\n const url = new URL(value.includes(\"://\") ? value : `https://${value}`);\n if (url.username || url.password)\n throw new Error(\"databricks: workspace host must not contain credentials.\");\n return url.origin;\n}\n","import type {\n ExecutionAttestation,\n ExecutionPrincipal,\n ExternalResourceOperation,\n ExternalResourceRef,\n MutationGovernanceResolver,\n} from \"@fabricorg/platform/governance\";\nimport type { DatabricksPrincipal } from \"./identity.js\";\nimport { databricksWorkspaceOrigin } from \"./workspace-origin.js\";\n\nexport interface DatabricksPlatformResource {\n resourceType: string;\n resourceId: string;\n operation: ExternalResourceOperation;\n displayName?: string;\n dataClassifications?: string[];\n metadata?: Record<string, unknown>;\n}\n\nexport interface DatabricksMutationGovernanceOptions {\n workspaceHost: string;\n principal: DatabricksPrincipal;\n resolveResources: (\n input: Parameters<MutationGovernanceResolver>[0],\n ) => Promise<DatabricksPlatformResource[]> | DatabricksPlatformResource[];\n principalId?: string;\n}\n\nexport function databricksPlatformResourceRef(\n workspaceHost: string,\n resource: Omit<DatabricksPlatformResource, \"operation\" | \"dataClassifications\">,\n): ExternalResourceRef {\n return {\n provider: \"databricks\",\n resourceType: resource.resourceType,\n resourceId: resource.resourceId,\n ...(resource.displayName ? { displayName: resource.displayName } : {}),\n metadata: {\n workspaceHost: databricksWorkspaceOrigin(workspaceHost),\n ...(resource.metadata ?? {}),\n },\n };\n}\n\n/** Audit-safe Databricks identity. Tokens and secrets are deliberately never represented. */\nexport function databricksExecutionPrincipal(\n principal: DatabricksPrincipal,\n delegatedBy?: ExecutionPrincipal,\n explicitId?: string,\n): ExecutionPrincipal {\n const principalId = explicitId ?? principalLabel(principal);\n return {\n principalId,\n principalType:\n principal.kind === \"on-behalf-of\" || principal.kind === \"cli-profile\"\n ? \"natural_person\"\n : \"service_account\",\n provider: \"databricks\",\n ...(delegatedBy ? { delegatedBy } : {}),\n metadata: { authenticationKind: principal.kind },\n };\n}\n\n/** Platform resolver backed by Databricks resource identities but no Databricks network calls. */\nexport function createDatabricksMutationGovernanceResolver(\n options: DatabricksMutationGovernanceOptions,\n): MutationGovernanceResolver {\n return async (input) => {\n const resources = await options.resolveResources(input);\n return {\n footprint: {\n version: 1,\n resources: resources.map((resource) => ({\n resource: databricksPlatformResourceRef(options.workspaceHost, resource),\n operation: resource.operation,\n ...(resource.dataClassifications\n ? { dataClassifications: resource.dataClassifications }\n : {}),\n })),\n },\n executionPrincipal: databricksExecutionPrincipal(\n options.principal,\n { principalId: input.actorId, principalType: input.actorType },\n options.principalId,\n ),\n };\n };\n}\n\nexport interface DatabricksAttestationInput {\n operation: string;\n externalOperationId: string;\n startedAt: Date | string;\n completedAt?: Date | string;\n workspaceHost?: string;\n resource?: Omit<DatabricksPlatformResource, \"operation\" | \"dataClassifications\">;\n satisfiesObligations?: string[];\n evidenceUri?: string;\n metadata?: Record<string, unknown>;\n}\n\nexport function databricksExecutionAttestation(\n input: DatabricksAttestationInput,\n): ExecutionAttestation {\n return {\n provider: \"databricks\",\n operation: input.operation,\n externalOperationId: input.externalOperationId,\n ...(input.resource && input.workspaceHost\n ? { resource: databricksPlatformResourceRef(input.workspaceHost, input.resource) }\n : {}),\n evidenceReferences: [{\n referenceType: \"external_observation\",\n referenceId: input.externalOperationId,\n ...(input.evidenceUri ? { uri: input.evidenceUri } : {}),\n metadata: { provider: \"databricks\", operation: input.operation },\n }],\n ...(input.satisfiesObligations\n ? { satisfiesObligations: input.satisfiesObligations }\n : {}),\n startedAt: input.startedAt,\n ...(input.completedAt ? { completedAt: input.completedAt } : {}),\n ...(input.metadata ? { metadata: input.metadata } : {}),\n };\n}\n\nfunction principalLabel(principal: DatabricksPrincipal): string {\n switch (principal.kind) {\n case \"service-principal\":\n return principal.clientId;\n case \"cli-profile\":\n return principal.profile ?? \"databricks-cli-user\";\n case \"on-behalf-of\":\n return principal.label ?? \"databricks-on-behalf-of-user\";\n case \"pat\":\n return principal.label ?? \"databricks-pat-principal\";\n }\n}\n"],"mappings":";AACO,SAAS,0BAA0B,MAAsB;AAC9D,QAAM,QAAQ,KAAK,KAAK;AACxB,MAAI,CAAC,MAAO,OAAM,IAAI,MAAM,6CAA6C;AACzE,QAAM,MAAM,IAAI,IAAI,MAAM,SAAS,KAAK,IAAI,QAAQ,WAAW,KAAK,EAAE;AACtE,MAAI,IAAI,YAAY,IAAI;AACtB,UAAM,IAAI,MAAM,0DAA0D;AAC5E,SAAO,IAAI;AACb;;;
|
|
1
|
+
{"version":3,"sources":["../src/workspace-origin.ts","../src/platform.ts"],"sourcesContent":["/** Normalize a workspace hostname or URL to its HTTPS origin. */\nexport function databricksWorkspaceOrigin(host: string): string {\n const value = host.trim();\n if (!value) throw new Error(\"databricks: workspace host cannot be empty.\");\n const url = new URL(value.includes(\"://\") ? value : `https://${value}`);\n if (url.username || url.password)\n throw new Error(\"databricks: workspace host must not contain credentials.\");\n return url.origin;\n}\n","import type {\n ExecutionAttestation,\n ExecutionPrincipal,\n ExternalResourceOperation,\n ExternalResourceRef,\n GovernanceRuntimeEvidence,\n MutationGovernanceResolver,\n} from \"@fabricorg/platform/governance\";\nimport type { DatabricksPrincipal } from \"./identity.js\";\nimport { databricksWorkspaceOrigin } from \"./workspace-origin.js\";\n\n/** Durable generation of the Harness-to-Platform Databricks governance bridge. */\nexport const DATABRICKS_PLATFORM_GOVERNANCE_BRIDGE_VERSION = \"1\";\n\n/** Runtime evidence applications pass directly to `createGovernedActionHost`. */\nexport function databricksGovernanceRuntimeEvidence(\n overrides: Pick<GovernanceRuntimeEvidence, \"hostPackageVersion\" | \"policyRulesetVersion\"> = {},\n): Partial<GovernanceRuntimeEvidence> {\n return {\n ...overrides,\n providerBridge: {\n name: \"@fabric-harness/databricks\",\n version: DATABRICKS_PLATFORM_GOVERNANCE_BRIDGE_VERSION,\n },\n };\n}\n\nexport interface DatabricksPlatformResource {\n resourceType: string;\n resourceId: string;\n operation: ExternalResourceOperation;\n displayName?: string;\n dataClassifications?: string[];\n metadata?: Record<string, unknown>;\n}\n\nexport interface DatabricksMutationGovernanceOptions {\n workspaceHost: string;\n principal: DatabricksPrincipal;\n resolveResources: (\n input: Parameters<MutationGovernanceResolver>[0],\n ) => Promise<DatabricksPlatformResource[]> | DatabricksPlatformResource[];\n principalId?: string;\n}\n\nexport function databricksPlatformResourceRef(\n workspaceHost: string,\n resource: Omit<DatabricksPlatformResource, \"operation\" | \"dataClassifications\">,\n): ExternalResourceRef {\n return {\n provider: \"databricks\",\n resourceType: resource.resourceType,\n resourceId: resource.resourceId,\n ...(resource.displayName ? { displayName: resource.displayName } : {}),\n metadata: {\n workspaceHost: databricksWorkspaceOrigin(workspaceHost),\n ...(resource.metadata ?? {}),\n },\n };\n}\n\n/** Audit-safe Databricks identity. Tokens and secrets are deliberately never represented. */\nexport function databricksExecutionPrincipal(\n principal: DatabricksPrincipal,\n delegatedBy?: ExecutionPrincipal,\n explicitId?: string,\n): ExecutionPrincipal {\n const principalId = explicitId ?? principalLabel(principal);\n return {\n principalId,\n principalType:\n principal.kind === \"on-behalf-of\" || principal.kind === \"cli-profile\"\n ? \"natural_person\"\n : \"service_account\",\n provider: \"databricks\",\n ...(delegatedBy ? { delegatedBy } : {}),\n metadata: { authenticationKind: principal.kind },\n };\n}\n\n/** Platform resolver backed by Databricks resource identities but no Databricks network calls. */\nexport function createDatabricksMutationGovernanceResolver(\n options: DatabricksMutationGovernanceOptions,\n): MutationGovernanceResolver {\n return async (input) => {\n const resources = await options.resolveResources(input);\n return {\n footprint: {\n version: 1,\n resources: resources.map((resource) => ({\n resource: databricksPlatformResourceRef(options.workspaceHost, resource),\n operation: resource.operation,\n ...(resource.dataClassifications\n ? { dataClassifications: resource.dataClassifications }\n : {}),\n })),\n },\n executionPrincipal: databricksExecutionPrincipal(\n options.principal,\n { principalId: input.actorId, principalType: input.actorType },\n options.principalId,\n ),\n };\n };\n}\n\nexport interface DatabricksAttestationInput {\n operation: string;\n externalOperationId: string;\n startedAt: Date | string;\n completedAt?: Date | string;\n workspaceHost?: string;\n resource?: Omit<DatabricksPlatformResource, \"operation\" | \"dataClassifications\">;\n satisfiesObligations?: string[];\n evidenceUri?: string;\n metadata?: Record<string, unknown>;\n}\n\nexport function databricksExecutionAttestation(\n input: DatabricksAttestationInput,\n): ExecutionAttestation {\n return {\n provider: \"databricks\",\n operation: input.operation,\n externalOperationId: input.externalOperationId,\n ...(input.resource && input.workspaceHost\n ? { resource: databricksPlatformResourceRef(input.workspaceHost, input.resource) }\n : {}),\n evidenceReferences: [{\n referenceType: \"external_observation\",\n referenceId: input.externalOperationId,\n ...(input.evidenceUri ? { uri: input.evidenceUri } : {}),\n metadata: { provider: \"databricks\", operation: input.operation },\n }],\n ...(input.satisfiesObligations\n ? { satisfiesObligations: input.satisfiesObligations }\n : {}),\n startedAt: input.startedAt,\n ...(input.completedAt ? { completedAt: input.completedAt } : {}),\n ...(input.metadata ? { metadata: input.metadata } : {}),\n };\n}\n\nfunction principalLabel(principal: DatabricksPrincipal): string {\n switch (principal.kind) {\n case \"service-principal\":\n return principal.clientId;\n case \"cli-profile\":\n return principal.profile ?? \"databricks-cli-user\";\n case \"on-behalf-of\":\n return principal.label ?? \"databricks-on-behalf-of-user\";\n case \"pat\":\n return principal.label ?? \"databricks-pat-principal\";\n }\n}\n"],"mappings":"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","names":[]}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import { type DatabricksModelProviderService, type DatabricksModelService, type DatabricksModelServiceDiscoveryOptions } from "./ai-gateway.js";
|
|
2
|
+
import { type DatabricksPrincipal } from "./identity.js";
|
|
3
|
+
import { type DatabricksSqlWarehouse } from "./sql-warehouses.js";
|
|
4
|
+
/** Runtime-only control-plane configuration for applications and server frameworks. */
|
|
5
|
+
export interface DatabricksControlPlaneOptions {
|
|
6
|
+
host: string;
|
|
7
|
+
principal: DatabricksPrincipal;
|
|
8
|
+
fetchImpl?: typeof fetch;
|
|
9
|
+
extraHeaders?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
* A compact Databricks control-plane client that deliberately excludes Harness build, deployment,
|
|
13
|
+
* and agent-authoring code. Use this entrypoint from application bundles such as Next.js.
|
|
14
|
+
*/
|
|
15
|
+
export declare function databricksControlPlane(options: DatabricksControlPlaneOptions): {
|
|
16
|
+
aiGateway: {
|
|
17
|
+
ensure: () => Promise<void>;
|
|
18
|
+
listModelServices: (discoveryOptions?: DatabricksModelServiceDiscoveryOptions) => Promise<DatabricksModelService[]>;
|
|
19
|
+
listModelProviderServices: () => Promise<DatabricksModelProviderService[]>;
|
|
20
|
+
};
|
|
21
|
+
sqlWarehouses: {
|
|
22
|
+
list: () => Promise<DatabricksSqlWarehouse[]>;
|
|
23
|
+
};
|
|
24
|
+
};
|
|
25
|
+
export { databricksModelProviderSupportsAnthropic, type DatabricksModelProviderService, type DatabricksModelService, type DatabricksModelServiceDiscoveryOptions, } from "./ai-gateway.js";
|
|
26
|
+
export { createDatabricksAuthenticatedFetch, databricksAnthropicGatewayBaseUrl, type DatabricksAuthenticatedFetchOptions, } from "./authenticated-fetch.js";
|
|
27
|
+
export { databricksIdentity, databricksPrincipalFromEnv, type DatabricksPrincipal, type DatabricksTokenProvider, } from "./identity.js";
|
|
28
|
+
export { lakebaseCredentialProvider } from "./lakebase.js";
|
|
29
|
+
export { databricksSdk, type DatabricksSdkClients, type DatabricksSdkOptions, } from "./native-sdk.js";
|
|
30
|
+
export { parseStatementRows, runStatement, type SqlParameter, type StatementPoll, } from "./sql-exec.js";
|
|
31
|
+
export { chooseDatabricksSqlWarehouse, type DatabricksSqlWarehouse, } from "./sql-warehouses.js";
|
|
32
|
+
export { databricksWorkspaceOrigin } from "./workspace-origin.js";
|
|
33
|
+
//# sourceMappingURL=runtime.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,8BAA8B,EACnC,KAAK,sBAAsB,EAC3B,KAAK,sCAAsC,EAC5C,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAsB,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAE7E,OAAO,EAA+B,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE/F,uFAAuF;AACvF,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,mBAAmB,CAAC;IAC/B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,YAAY,CAAC,EACT,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtB,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CACtE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,6BAA6B;;sBAS3D,OAAO,CAAC,IAAI,CAAC;+CAEJ,sCAAsC,KACxD,OAAO,CAAC,sBAAsB,EAAE,CAAC;yCACL,OAAO,CAAC,8BAA8B,EAAE,CAAC;;;oBAI9D,OAAO,CAAC,sBAAsB,EAAE,CAAC;;EAGhD;AAED,OAAO,EACL,wCAAwC,EACxC,KAAK,8BAA8B,EACnC,KAAK,sBAAsB,EAC3B,KAAK,sCAAsC,GAC5C,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,kCAAkC,EAClC,iCAAiC,EACjC,KAAK,mCAAmC,GACzC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,GAC7B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,4BAA4B,EAC5B,KAAK,sBAAsB,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC"}
|