@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.
Files changed (100) hide show
  1. package/README.md +25 -0
  2. package/dist/platform.d.ts +5 -1
  3. package/dist/platform.d.ts.map +1 -1
  4. package/dist/platform.js +12 -0
  5. package/dist/platform.js.map +1 -1
  6. package/dist/runtime.d.ts +33 -0
  7. package/dist/runtime.d.ts.map +1 -0
  8. package/dist/runtime.js +53046 -0
  9. package/dist/runtime.js.map +1 -0
  10. package/package.json +15 -11
  11. package/dist/agent-services.js +0 -142
  12. package/dist/agent-services.js.map +0 -1
  13. package/dist/ai-gateway.js +0 -51
  14. package/dist/ai-gateway.js.map +0 -1
  15. package/dist/ai-search-admin.js +0 -194
  16. package/dist/ai-search-admin.js.map +0 -1
  17. package/dist/ai.js +0 -22
  18. package/dist/ai.js.map +0 -1
  19. package/dist/app.js +0 -143
  20. package/dist/app.js.map +0 -1
  21. package/dist/authoring-certification.js +0 -476
  22. package/dist/authoring-certification.js.map +0 -1
  23. package/dist/capabilities.js +0 -633
  24. package/dist/capabilities.js.map +0 -1
  25. package/dist/certification-resource.js +0 -17
  26. package/dist/certification-resource.js.map +0 -1
  27. package/dist/certification-sweeper.js +0 -128
  28. package/dist/certification-sweeper.js.map +0 -1
  29. package/dist/certification.js +0 -236
  30. package/dist/certification.js.map +0 -1
  31. package/dist/client.d.ts +0 -58
  32. package/dist/client.d.ts.map +0 -1
  33. package/dist/client.js +0 -184
  34. package/dist/client.js.map +0 -1
  35. package/dist/compatibility.js +0 -88
  36. package/dist/compatibility.js.map +0 -1
  37. package/dist/consumption.js +0 -85
  38. package/dist/consumption.js.map +0 -1
  39. package/dist/cost-budget-actuals.js +0 -316
  40. package/dist/cost-budget-actuals.js.map +0 -1
  41. package/dist/embeddings.js +0 -24
  42. package/dist/embeddings.js.map +0 -1
  43. package/dist/feature-serving.js +0 -29
  44. package/dist/feature-serving.js.map +0 -1
  45. package/dist/genie-agent-mode.js +0 -374
  46. package/dist/genie-agent-mode.js.map +0 -1
  47. package/dist/genie-authoring.js +0 -898
  48. package/dist/genie-authoring.js.map +0 -1
  49. package/dist/genie.js +0 -405
  50. package/dist/genie.js.map +0 -1
  51. package/dist/governance.js +0 -353
  52. package/dist/governance.js.map +0 -1
  53. package/dist/identity.js +0 -229
  54. package/dist/identity.js.map +0 -1
  55. package/dist/jobs-authoring.js +0 -570
  56. package/dist/jobs-authoring.js.map +0 -1
  57. package/dist/jobs.js +0 -173
  58. package/dist/jobs.js.map +0 -1
  59. package/dist/lakebase.js +0 -110
  60. package/dist/lakebase.js.map +0 -1
  61. package/dist/lakeflow-authoring.js +0 -115
  62. package/dist/lakeflow-authoring.js.map +0 -1
  63. package/dist/lakeflow.js +0 -75
  64. package/dist/lakeflow.js.map +0 -1
  65. package/dist/managed-resource.js +0 -197
  66. package/dist/managed-resource.js.map +0 -1
  67. package/dist/mlflow-tracing.js +0 -167
  68. package/dist/mlflow-tracing.js.map +0 -1
  69. package/dist/mock-provider.js +0 -66
  70. package/dist/mock-provider.js.map +0 -1
  71. package/dist/model.js +0 -173
  72. package/dist/model.js.map +0 -1
  73. package/dist/persistence.js +0 -82
  74. package/dist/persistence.js.map +0 -1
  75. package/dist/rag-chain.js +0 -212
  76. package/dist/rag-chain.js.map +0 -1
  77. package/dist/rag-eval.js +0 -151
  78. package/dist/rag-eval.js.map +0 -1
  79. package/dist/secrets-authoring.js +0 -78
  80. package/dist/secrets-authoring.js.map +0 -1
  81. package/dist/secrets.js +0 -25
  82. package/dist/secrets.js.map +0 -1
  83. package/dist/serving-admin.js +0 -255
  84. package/dist/serving-admin.js.map +0 -1
  85. package/dist/serving-usage.js +0 -100
  86. package/dist/serving-usage.js.map +0 -1
  87. package/dist/sql-exec.js +0 -36
  88. package/dist/sql-exec.js.map +0 -1
  89. package/dist/telemetry-sink.js +0 -180
  90. package/dist/telemetry-sink.js.map +0 -1
  91. package/dist/tools.js +0 -167
  92. package/dist/tools.js.map +0 -1
  93. package/dist/unity-catalog-admin.js +0 -166
  94. package/dist/unity-catalog-admin.js.map +0 -1
  95. package/dist/vector-search.js +0 -65
  96. package/dist/vector-search.js.map +0 -1
  97. package/dist/volumes-attachment-store.js +0 -172
  98. package/dist/volumes-attachment-store.js.map +0 -1
  99. package/dist/workspace-authoring.js +0 -78
  100. 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.
@@ -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;
@@ -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
@@ -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;;;ACoBO,SAAS,8BACd,eACA,UACqB;AACrB,SAAO;AAAA,IACL,UAAU;AAAA,IACV,cAAc,SAAS;AAAA,IACvB,YAAY,SAAS;AAAA,IACrB,GAAI,SAAS,cAAc,EAAE,aAAa,SAAS,YAAY,IAAI,CAAC;AAAA,IACpE,UAAU;AAAA,MACR,eAAe,0BAA0B,aAAa;AAAA,MACtD,GAAI,SAAS,YAAY,CAAC;AAAA,IAC5B;AAAA,EACF;AACF;AAGO,SAAS,6BACd,WACA,aACA,YACoB;AACpB,QAAM,cAAc,cAAc,eAAe,SAAS;AAC1D,SAAO;AAAA,IACL;AAAA,IACA,eACE,UAAU,SAAS,kBAAkB,UAAU,SAAS,gBACpD,mBACA;AAAA,IACN,UAAU;AAAA,IACV,GAAI,cAAc,EAAE,YAAY,IAAI,CAAC;AAAA,IACrC,UAAU,EAAE,oBAAoB,UAAU,KAAK;AAAA,EACjD;AACF;AAGO,SAAS,2CACd,SAC4B;AAC5B,SAAO,OAAO,UAAU;AACtB,UAAM,YAAY,MAAM,QAAQ,iBAAiB,KAAK;AACtD,WAAO;AAAA,MACL,WAAW;AAAA,QACT,SAAS;AAAA,QACT,WAAW,UAAU,IAAI,CAAC,cAAc;AAAA,UACtC,UAAU,8BAA8B,QAAQ,eAAe,QAAQ;AAAA,UACvE,WAAW,SAAS;AAAA,UACpB,GAAI,SAAS,sBACT,EAAE,qBAAqB,SAAS,oBAAoB,IACpD,CAAC;AAAA,QACP,EAAE;AAAA,MACJ;AAAA,MACA,oBAAoB;AAAA,QAClB,QAAQ;AAAA,QACR,EAAE,aAAa,MAAM,SAAS,eAAe,MAAM,UAAU;AAAA,QAC7D,QAAQ;AAAA,MACV;AAAA,IACF;AAAA,EACF;AACF;AAcO,SAAS,+BACd,OACsB;AACtB,SAAO;AAAA,IACL,UAAU;AAAA,IACV,WAAW,MAAM;AAAA,IACjB,qBAAqB,MAAM;AAAA,IAC3B,GAAI,MAAM,YAAY,MAAM,gBACxB,EAAE,UAAU,8BAA8B,MAAM,eAAe,MAAM,QAAQ,EAAE,IAC/E,CAAC;AAAA,IACL,oBAAoB,CAAC;AAAA,MACnB,eAAe;AAAA,MACf,aAAa,MAAM;AAAA,MACnB,GAAI,MAAM,cAAc,EAAE,KAAK,MAAM,YAAY,IAAI,CAAC;AAAA,MACtD,UAAU,EAAE,UAAU,cAAc,WAAW,MAAM,UAAU;AAAA,IACjE,CAAC;AAAA,IACD,GAAI,MAAM,uBACN,EAAE,sBAAsB,MAAM,qBAAqB,IACnD,CAAC;AAAA,IACL,WAAW,MAAM;AAAA,IACjB,GAAI,MAAM,cAAc,EAAE,aAAa,MAAM,YAAY,IAAI,CAAC;AAAA,IAC9D,GAAI,MAAM,WAAW,EAAE,UAAU,MAAM,SAAS,IAAI,CAAC;AAAA,EACvD;AACF;AAEA,SAAS,eAAe,WAAwC;AAC9D,UAAQ,UAAU,MAAM;AAAA,IACtB,KAAK;AACH,aAAO,UAAU;AAAA,IACnB,KAAK;AACH,aAAO,UAAU,WAAW;AAAA,IAC9B,KAAK;AACH,aAAO,UAAU,SAAS;AAAA,IAC5B,KAAK;AACH,aAAO,UAAU,SAAS;AAAA,EAC9B;AACF;","names":[]}
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"}