@fabric-harness/databricks 5.2.0 → 6.0.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/dist/ai.d.ts CHANGED
@@ -1,5 +1,5 @@
1
- import type { ToolDef } from '@fabric-harness/sdk';
2
- import { type DatabricksStatementClient } from './sql-exec.js';
1
+ import type { ToolDef } from "@fabric-harness/sdk";
2
+ import { type DatabricksStatementClient } from "./sql-exec.js";
3
3
  export interface DatabricksAiQueryToolOptions {
4
4
  warehouseId: string;
5
5
  name?: string;
@@ -7,12 +7,19 @@ export interface DatabricksAiQueryToolOptions {
7
7
  pollIntervalMs?: number;
8
8
  timeoutMs?: number;
9
9
  }
10
+ export type DatabricksAiQueryPolicy = {
11
+ allowedEndpoints: readonly string[];
12
+ allowAnyEndpoint?: never;
13
+ } | {
14
+ allowedEndpoints?: never;
15
+ allowAnyEndpoint: true;
16
+ };
10
17
  /**
11
18
  * `ai_query(endpoint, request)` — run model inference inside the SQL warehouse against a serving
12
19
  * endpoint. Drives both serving and SQL-warehouse consumption. Uses named SQL parameters, so the
13
20
  * endpoint and request are never string-interpolated into SQL.
14
21
  */
15
- export declare function databricksAiQueryTool(client: DatabricksStatementClient, options: DatabricksAiQueryToolOptions): ToolDef<{
22
+ export declare function databricksAiQueryTool(client: DatabricksStatementClient, endpointPolicy: DatabricksAiQueryPolicy, options: DatabricksAiQueryToolOptions): ToolDef<{
16
23
  endpoint: string;
17
24
  request: string;
18
25
  }, unknown>;
package/dist/ai.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../src/ai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAgB,KAAK,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAE7E,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,yBAAyB,EAAE,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,CAAC,CAoBvK"}
1
+ {"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../src/ai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAMnD,OAAO,EAAE,KAAK,yBAAyB,EAAgB,MAAM,eAAe,CAAC;AAE7E,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AACD,MAAM,MAAM,uBAAuB,GAC/B;IAAE,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,gBAAgB,CAAC,EAAE,KAAK,CAAA;CAAE,GACjE;IAAE,gBAAgB,CAAC,EAAE,KAAK,CAAC;IAAC,gBAAgB,EAAE,IAAI,CAAA;CAAE,CAAC;AAEzD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,yBAAyB,EACjC,cAAc,EAAE,uBAAuB,EACvC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,CAAC,CAkDzD"}
@@ -63,6 +63,8 @@ export declare const DATABRICKS_APP_USER_PERMISSIONS: readonly ["agent:invoke",
63
63
  export declare function createDatabricksAppUserAuthenticator(options: DatabricksAppUserAuthenticatorOptions): (request: {
64
64
  headers: Headers | Record<string, string | string[] | undefined>;
65
65
  }) => Promise<DatabricksAppAuthenticatedPrincipal | false | undefined>;
66
+ /** Stable, non-reversible tenant scope for Databricks App principals. */
67
+ export declare function databricksPrincipalTenantId(kind: "user" | "service-principal" | "app", id: string): string;
66
68
  /**
67
69
  * Validate a Databricks Apps forwarded user token and return non-secret
68
70
  * identity/lifetime metadata suitable for OBO lifecycle certification.
@@ -1 +1 @@
1
- {"version":3,"file":"app-user-authorization.d.ts","sourceRoot":"","sources":["../src/app-user-authorization.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAS3D,MAAM,WAAW,wCAAwC;IACvD,SAAS,EAAE,eAAe,CAAC;IAC3B,iBAAiB,EAAE;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,KAAK,EAAE;QACL,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAED,MAAM,WAAW,mCAAmC;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,eAAe,CAAC;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qCAAqC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,kGAAkG;IAClG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gGAAgG;IAChG,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,wCAAwC,KAAK,MAAM,CAAC;IAC5E,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC;;;OAGG;IACH,8BAA8B,CAAC,EAAE,OAAO,CAAC;IACzC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,+BAA+B,gJASlC,CAAC;AAEX;;;;GAIG;AACH,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,qCAAqC,GAC7C,CAAC,OAAO,EAAE;IACX,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;CAClE,KAAK,OAAO,CAAC,mCAAmC,GAAG,KAAK,GAAG,SAAS,CAAC,CAiGrE;AAwFD;;;;GAIG;AACH,wBAAsB,qCAAqC,CAAC,OAAO,EAAE;IACnE,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,wCAAwC,CAAC,CAmDpD"}
1
+ {"version":3,"file":"app-user-authorization.d.ts","sourceRoot":"","sources":["../src/app-user-authorization.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAS3D,MAAM,WAAW,wCAAwC;IACvD,SAAS,EAAE,eAAe,CAAC;IAC3B,iBAAiB,EAAE;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,KAAK,EAAE;QACL,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAED,MAAM,WAAW,mCAAmC;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,eAAe,CAAC;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qCAAqC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,kGAAkG;IAClG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gGAAgG;IAChG,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,wCAAwC,KAAK,MAAM,CAAC;IAC5E,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC;;;OAGG;IACH,8BAA8B,CAAC,EAAE,OAAO,CAAC;IACzC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,+BAA+B,gJASlC,CAAC;AAEX;;;;GAIG;AACH,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,qCAAqC,GAC7C,CAAC,OAAO,EAAE;IACX,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;CAClE,KAAK,OAAO,CAAC,mCAAmC,GAAG,KAAK,GAAG,SAAS,CAAC,CA+FrE;AAYD,yEAAyE;AACzE,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,KAAK,EAC1C,EAAE,EAAE,MAAM,GACT,MAAM,CAER;AA8ED;;;;GAIG;AACH,wBAAsB,qCAAqC,CAAC,OAAO,EAAE;IACnE,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,wCAAwC,CAAC,CAmDpD"}
@@ -38809,7 +38809,7 @@ function createDatabricksAppUserAuthenticator(options) {
38809
38809
  id: forwardedUser.id,
38810
38810
  kind: "user",
38811
38811
  provider: "databricks-apps",
38812
- tenantId: `databricks-user:${createHash("sha256").update(forwardedUser.id).digest("hex").slice(0, 24)}`,
38812
+ tenantId: databricksPrincipalTenantId("user", forwardedUser.id),
38813
38813
  permissions: [...permissions],
38814
38814
  ...forwardedUser.displayName ? { displayName: forwardedUser.displayName } : {},
38815
38815
  ...forwardedUser.ucPrincipal ? { ucPrincipal: forwardedUser.ucPrincipal } : {}
@@ -38831,7 +38831,7 @@ function createDatabricksAppUserAuthenticator(options) {
38831
38831
  id,
38832
38832
  kind: "service-principal",
38833
38833
  provider: "databricks-apps",
38834
- tenantId: `databricks-service-principal:${createHash("sha256").update(id).digest("hex").slice(0, 24)}`,
38834
+ tenantId: databricksPrincipalTenantId("service-principal", id),
38835
38835
  permissions: [...permissions]
38836
38836
  };
38837
38837
  }
@@ -38847,7 +38847,7 @@ function createDatabricksAppUserAuthenticator(options) {
38847
38847
  ...options.now ? { now: options.now } : {}
38848
38848
  });
38849
38849
  const id = inspection.principal.id;
38850
- const tenantId = options.tenantId?.(inspection) ?? `databricks-user:${createHash("sha256").update(id).digest("hex").slice(0, 24)}`;
38850
+ const tenantId = options.tenantId?.(inspection) ?? databricksPrincipalTenantId("user", id);
38851
38851
  if (!tenantId) return false;
38852
38852
  const principal = {
38853
38853
  id,
@@ -38875,10 +38875,13 @@ function appPrincipalFor(id, permissions) {
38875
38875
  id,
38876
38876
  kind: "app-principal",
38877
38877
  provider: "databricks-apps",
38878
- tenantId: `databricks-app:${createHash("sha256").update(id).digest("hex").slice(0, 24)}`,
38878
+ tenantId: databricksPrincipalTenantId("app", id),
38879
38879
  permissions: [...permissions]
38880
38880
  };
38881
38881
  }
38882
+ function databricksPrincipalTenantId(kind, id) {
38883
+ return `databricks-${kind}:${createHash("sha256").update(id).digest("hex").slice(0, 24)}`;
38884
+ }
38882
38885
  async function isAppAuthorizedCaller(headers, delegated, allowed) {
38883
38886
  const forwarded = forwardedIdentity(headers);
38884
38887
  if (forwarded && allowed.has(forwarded)) return true;
@@ -38979,6 +38982,7 @@ function jwtLifetimeClaims(token) {
38979
38982
  export {
38980
38983
  DATABRICKS_APP_USER_PERMISSIONS,
38981
38984
  createDatabricksAppUserAuthenticator,
38985
+ databricksPrincipalTenantId,
38982
38986
  inspectDatabricksAppUserAuthorization
38983
38987
  };
38984
38988
  //# sourceMappingURL=app-user-authorization.js.map