@fabric-harness/databricks 1.0.0 → 1.2.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 (84) hide show
  1. package/NOTICE +4 -0
  2. package/README.md +78 -32
  3. package/dist/agent.d.ts +5 -5
  4. package/dist/agent.d.ts.map +1 -1
  5. package/dist/agent.js +40 -30
  6. package/dist/agent.js.map +1 -1
  7. package/dist/ai-gateway.d.ts +25 -0
  8. package/dist/ai-gateway.d.ts.map +1 -0
  9. package/dist/ai-gateway.js +51 -0
  10. package/dist/ai-gateway.js.map +1 -0
  11. package/dist/app.d.ts +36 -12
  12. package/dist/app.d.ts.map +1 -1
  13. package/dist/app.js +74 -21
  14. package/dist/app.js.map +1 -1
  15. package/dist/certification.d.ts +62 -0
  16. package/dist/certification.d.ts.map +1 -0
  17. package/dist/certification.js +110 -0
  18. package/dist/certification.js.map +1 -0
  19. package/dist/certify.d.ts +2 -0
  20. package/dist/certify.d.ts.map +1 -0
  21. package/dist/certify.js +707 -0
  22. package/dist/certify.js.map +1 -0
  23. package/dist/client.d.ts +14 -7
  24. package/dist/client.d.ts.map +1 -1
  25. package/dist/client.js +23 -7
  26. package/dist/client.js.map +1 -1
  27. package/dist/compatibility.d.ts +54 -0
  28. package/dist/compatibility.d.ts.map +1 -0
  29. package/dist/compatibility.js +59 -0
  30. package/dist/compatibility.js.map +1 -0
  31. package/dist/cost-budget-actuals.d.ts +29 -1
  32. package/dist/cost-budget-actuals.d.ts.map +1 -1
  33. package/dist/cost-budget-actuals.js +51 -0
  34. package/dist/cost-budget-actuals.js.map +1 -1
  35. package/dist/feature-serving.js +1 -1
  36. package/dist/feature-serving.js.map +1 -1
  37. package/dist/governance.d.ts +4 -0
  38. package/dist/governance.d.ts.map +1 -1
  39. package/dist/governance.js +27 -4
  40. package/dist/governance.js.map +1 -1
  41. package/dist/identity.d.ts +20 -6
  42. package/dist/identity.d.ts.map +1 -1
  43. package/dist/identity.js +55 -23
  44. package/dist/identity.js.map +1 -1
  45. package/dist/index.d.ts +100 -52
  46. package/dist/index.d.ts.map +1 -1
  47. package/dist/index.js +141 -53
  48. package/dist/index.js.map +1 -1
  49. package/dist/jobs.d.ts +77 -0
  50. package/dist/jobs.d.ts.map +1 -0
  51. package/dist/jobs.js +173 -0
  52. package/dist/jobs.js.map +1 -0
  53. package/dist/lakebase.d.ts +34 -18
  54. package/dist/lakebase.d.ts.map +1 -1
  55. package/dist/lakebase.js +89 -4
  56. package/dist/lakebase.js.map +1 -1
  57. package/dist/mlflow-tracing.d.ts +3 -3
  58. package/dist/model.d.ts +24 -15
  59. package/dist/model.d.ts.map +1 -1
  60. package/dist/model.js +155 -32
  61. package/dist/model.js.map +1 -1
  62. package/dist/persistence.d.ts +4 -4
  63. package/dist/persistence.js +2 -2
  64. package/dist/rag-chain.d.ts +118 -0
  65. package/dist/rag-chain.d.ts.map +1 -0
  66. package/dist/rag-chain.js +212 -0
  67. package/dist/rag-chain.js.map +1 -0
  68. package/dist/rag-eval.d.ts +118 -0
  69. package/dist/rag-eval.d.ts.map +1 -0
  70. package/dist/rag-eval.js +151 -0
  71. package/dist/rag-eval.js.map +1 -0
  72. package/dist/secrets.d.ts +9 -0
  73. package/dist/secrets.d.ts.map +1 -0
  74. package/dist/secrets.js +25 -0
  75. package/dist/secrets.js.map +1 -0
  76. package/dist/telemetry-sink.d.ts +12 -0
  77. package/dist/telemetry-sink.d.ts.map +1 -1
  78. package/dist/telemetry-sink.js +29 -2
  79. package/dist/telemetry-sink.js.map +1 -1
  80. package/dist/tools.d.ts +5 -2
  81. package/dist/tools.d.ts.map +1 -1
  82. package/dist/tools.js +7 -16
  83. package/dist/tools.js.map +1 -1
  84. package/package.json +7 -5
@@ -1,27 +1,17 @@
1
- import type { DatabricksTokenProvider } from './identity.js';
2
- /**
3
- * Databricks Lakebase is managed Postgres. This builds a Postgres client whose **password is the
4
- * rotating OAuth token** (from {@link databricksIdentity}) rather than a static string: `pg.Pool`
5
- * evaluates the `password` function for every new connection, so a long-lived pool never pins a
6
- * stale token. The returned client is structurally compatible with `PostgresClientLike` from
7
- * `@fabric-harness/node`, so it drops straight into `new PostgresSessionStore({ client })` (and the
8
- * Postgres cost-budget / session-memory stores) — sessions + dispatch journal live in the lakehouse.
9
- *
10
- * Kept decoupled from `@fabric-harness/node` on purpose: this package owns the rotating-token
11
- * client; store assembly happens at the app / `databricks()` bundle layer where `node` is present.
12
- */
1
+ import type { DatabricksTokenProvider } from "./identity.js";
13
2
  export interface LakebaseClient {
14
3
  query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<{
15
4
  rows: T[];
16
5
  }>;
17
6
  end(): Promise<void>;
7
+ /** `pg.Pool` emits idle-client failures here; callers may observe them without crashing Node. */
8
+ on?(event: "error", listener: (error: Error) => void): unknown;
18
9
  }
19
10
  export interface LakebasePoolConfig {
20
11
  host: string;
21
12
  port: number;
22
13
  database: string;
23
14
  user: string;
24
- /** Static password or a resolver evaluated per new connection (the rotating token path). */
25
15
  password: string | (() => string | Promise<string>);
26
16
  ssl?: boolean | {
27
17
  rejectUnauthorized?: boolean;
@@ -29,21 +19,47 @@ export interface LakebasePoolConfig {
29
19
  max?: number;
30
20
  }
31
21
  export type LakebasePoolFactory = (config: LakebasePoolConfig) => LakebaseClient;
22
+ export interface LakebaseCredentialProviderOptions {
23
+ /** Databricks workspace URL, distinct from the Lakebase Postgres host. */
24
+ workspaceHost: string;
25
+ /** Full endpoint resource name: projects/.../branches/.../endpoints/.... */
26
+ endpoint: string;
27
+ /** Workspace OAuth token. It is exchanged for a database credential. */
28
+ token: string | DatabricksTokenProvider;
29
+ fetchImpl?: typeof fetch;
30
+ /** Refresh this long before expiry. Default five minutes. */
31
+ refreshBeforeMs?: number;
32
+ /** Additional randomized early-refresh window. Default thirty seconds. */
33
+ refreshJitterMs?: number;
34
+ now?: () => number;
35
+ random?: () => number;
36
+ }
37
+ /**
38
+ * Exchange a workspace OAuth token for a Lakebase database credential. The
39
+ * result is cached, refreshed early with jitter, and refreshes are single-flight.
40
+ */
41
+ export declare function lakebaseCredentialProvider(options: LakebaseCredentialProviderOptions): () => Promise<string>;
32
42
  export interface LakebaseClientOptions {
33
43
  host: string;
34
44
  database: string;
35
45
  user: string;
36
- /** Rotating OAuth token (from {@link databricksIdentity}) or a static password. */
37
- token: string | DatabricksTokenProvider;
38
- /** Default 5432. */
46
+ /** Direct database password. Intended for local Postgres/testing, not workspace OAuth. */
47
+ password?: string | (() => string | Promise<string>);
48
+ /** Workspace OAuth token to exchange. Requires workspaceHost and endpoint. */
49
+ token?: string | DatabricksTokenProvider;
50
+ workspaceHost?: string;
51
+ endpoint?: string;
52
+ fetchImpl?: typeof fetch;
53
+ refreshBeforeMs?: number;
54
+ refreshJitterMs?: number;
39
55
  port?: number;
40
- /** Default `{ rejectUnauthorized: true }` — Lakebase requires TLS. */
41
56
  ssl?: boolean | {
42
57
  rejectUnauthorized?: boolean;
43
58
  };
44
59
  max?: number;
45
- /** Inject a pg-like Pool factory for testing; defaults to the optional `pg` package. */
46
60
  poolFactory?: LakebasePoolFactory;
61
+ /** Observe recoverable idle pooled-connection failures. */
62
+ onPoolError?: (error: Error) => void;
47
63
  }
48
64
  export declare function lakebaseClient(options: LakebaseClientOptions): LakebaseClient;
49
65
  //# sourceMappingURL=lakebase.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"lakebase.d.ts","sourceRoot":"","sources":["../src/lakebase.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAI7D;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,EAAE,CAAA;KAAE,CAAC,CAAC;IAC5F,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,4FAA4F;IAC5F,QAAQ,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACpD,GAAG,CAAC,EAAE,OAAO,GAAG;QAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,kBAAkB,KAAK,cAAc,CAAC;AAEjF,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,KAAK,EAAE,MAAM,GAAG,uBAAuB,CAAC;IACxC,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,GAAG,CAAC,EAAE,OAAO,GAAG;QAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wFAAwF;IACxF,WAAW,CAAC,EAAE,mBAAmB,CAAC;CACnC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAW7E"}
1
+ {"version":3,"file":"lakebase.d.ts","sourceRoot":"","sources":["../src/lakebase.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAI7D,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,EAAE,CAAA;KAAE,CAAC,CAAC;IAC5F,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,iGAAiG;IACjG,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC;CAChE;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACpD,GAAG,CAAC,EAAE,OAAO,GAAG;QAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,kBAAkB,KAAK,cAAc,CAAC;AAEjF,MAAM,WAAW,iCAAiC;IAChD,0EAA0E;IAC1E,aAAa,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,KAAK,EAAE,MAAM,GAAG,uBAAuB,CAAC;IACxC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0EAA0E;IAC1E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;CACvB;AAOD;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,iCAAiC,GACzC,MAAM,OAAO,CAAC,MAAM,CAAC,CAkDvB;AAYD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACrD,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,GAAG,uBAAuB,CAAC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,GAAG;QAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,2DAA2D;IAC3D,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACtC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAoC7E"}
package/dist/lakebase.js CHANGED
@@ -1,21 +1,106 @@
1
- import { createRequire } from 'node:module';
1
+ import { createRequire } from "node:module";
2
+ import { redactText } from "@fabric-harness/sdk";
2
3
  const require = createRequire(import.meta.url);
4
+ /**
5
+ * Exchange a workspace OAuth token for a Lakebase database credential. The
6
+ * result is cached, refreshed early with jitter, and refreshes are single-flight.
7
+ */
8
+ export function lakebaseCredentialProvider(options) {
9
+ const workspaceHost = options.workspaceHost.replace(/\/$/, "");
10
+ const fetchImpl = options.fetchImpl ?? fetch;
11
+ const now = options.now ?? Date.now;
12
+ const random = options.random ?? Math.random;
13
+ const refreshBeforeMs = options.refreshBeforeMs ?? 5 * 60_000;
14
+ const refreshJitterMs = options.refreshJitterMs ?? 30_000;
15
+ let cached;
16
+ let refreshing;
17
+ const refresh = async () => {
18
+ const workspaceToken = typeof options.token === "function" ? await options.token() : options.token;
19
+ const response = await fetchImpl(`${workspaceHost}/api/2.0/postgres/credentials`, {
20
+ method: "POST",
21
+ headers: {
22
+ authorization: `Bearer ${workspaceToken}`,
23
+ "content-type": "application/json",
24
+ },
25
+ body: JSON.stringify({ endpoint: options.endpoint }),
26
+ });
27
+ if (!response.ok) {
28
+ const text = redactText(await response.text(), { additionalSecrets: [workspaceToken] });
29
+ throw new Error(`Lakebase credential exchange failed: ${response.status} ${response.statusText}: ${text.slice(0, 2000)}`);
30
+ }
31
+ const value = (await response.json());
32
+ if (typeof value.token !== "string" || !value.token) {
33
+ throw new Error("Lakebase credential exchange returned no token.");
34
+ }
35
+ const expiresAt = parseExpireTime(value.expire_time);
36
+ if (!Number.isFinite(expiresAt)) {
37
+ throw new Error("Lakebase credential exchange returned an invalid expire_time.");
38
+ }
39
+ const jitter = Math.max(0, refreshJitterMs) * random();
40
+ cached = {
41
+ token: value.token,
42
+ refreshAt: Math.max(now(), expiresAt - Math.max(0, refreshBeforeMs) - jitter),
43
+ };
44
+ return value.token;
45
+ };
46
+ return async () => {
47
+ if (cached && now() < cached.refreshAt)
48
+ return cached.token;
49
+ refreshing ??= refresh().finally(() => {
50
+ refreshing = undefined;
51
+ });
52
+ return refreshing;
53
+ };
54
+ }
55
+ function parseExpireTime(value) {
56
+ if (typeof value === "number") {
57
+ // Databricks APIs commonly use epoch milliseconds, but tolerate epoch
58
+ // seconds so credentials are not treated as already expired.
59
+ return value < 1_000_000_000_000 ? value * 1000 : value;
60
+ }
61
+ if (typeof value === "string")
62
+ return new Date(value).getTime();
63
+ return Number.NaN;
64
+ }
3
65
  export function lakebaseClient(options) {
4
66
  const factory = options.poolFactory ?? defaultPoolFactory();
5
- return factory({
67
+ let password = options.password;
68
+ if (password === undefined) {
69
+ if (!options.token || !options.workspaceHost || !options.endpoint) {
70
+ throw new Error("Lakebase OAuth requires token, workspaceHost, and endpoint. A workspace token cannot be used directly as the Postgres password.");
71
+ }
72
+ password = lakebaseCredentialProvider({
73
+ workspaceHost: options.workspaceHost,
74
+ endpoint: options.endpoint,
75
+ token: options.token,
76
+ ...(options.fetchImpl ? { fetchImpl: options.fetchImpl } : {}),
77
+ ...(options.refreshBeforeMs !== undefined
78
+ ? { refreshBeforeMs: options.refreshBeforeMs }
79
+ : {}),
80
+ ...(options.refreshJitterMs !== undefined
81
+ ? { refreshJitterMs: options.refreshJitterMs }
82
+ : {}),
83
+ });
84
+ }
85
+ const client = factory({
6
86
  host: options.host,
7
87
  port: options.port ?? 5432,
8
88
  database: options.database,
9
89
  user: options.user,
10
- password: options.token,
90
+ password,
11
91
  ssl: options.ssl ?? { rejectUnauthorized: true },
12
92
  ...(options.max !== undefined ? { max: options.max } : {}),
13
93
  });
94
+ // node-postgres treats an idle client error as fatal when Pool has no listener. The failed
95
+ // client is already removed from the pool, so keep the process alive and let a later query
96
+ // establish a fresh connection. Applications can attach telemetry through onPoolError.
97
+ client.on?.("error", options.onPoolError ?? (() => undefined));
98
+ return client;
14
99
  }
15
100
  function defaultPoolFactory() {
16
101
  let PoolCtor;
17
102
  try {
18
- PoolCtor = require('pg').Pool;
103
+ PoolCtor = require("pg").Pool;
19
104
  }
20
105
  catch (error) {
21
106
  throw new Error(`Lakebase store requires the optional "pg" package to be installed by the application. Run: pnpm add pg. ${error instanceof Error ? error.message : String(error)}`);
@@ -1 +1 @@
1
- {"version":3,"file":"lakebase.js","sourceRoot":"","sources":["../src/lakebase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AA8C/C,MAAM,UAAU,cAAc,CAAC,OAA8B;IAC3D,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,IAAI,kBAAkB,EAAE,CAAC;IAC5D,OAAO,OAAO,CAAC;QACb,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;QAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,OAAO,CAAC,KAAK;QACvB,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE;QAChD,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3D,CAAC,CAAC;AACL,CAAC;AAED,SAAS,kBAAkB;IACzB,IAAI,QAA4D,CAAC;IACjE,IAAI,CAAC;QACH,QAAQ,GAAI,OAAO,CAAC,IAAI,CAAkE,CAAC,IAAI,CAAC;IAClG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,2GAA2G,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACvL,CAAC;IACD,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC"}
1
+ {"version":3,"file":"lakebase.js","sourceRoot":"","sources":["../src/lakebase.ts"],"names":[],"mappings":"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"}
@@ -17,9 +17,9 @@ import type { DatabricksRestClient } from './client.js';
17
17
  *
18
18
  * The V3 payload ({@link buildMlflowTrace}) is implemented to the published
19
19
  * API spec — OTLP-shaped spans with base64 ids, unix-nano timestamps and
20
- * typed attributes — but live verification requires a workspace: run the
21
- * live-gated smoke test (`DATABRICKS_LIVE_TEST=1` +
22
- * `DATABRICKS_MLFLOW_EXPERIMENT_ID`) against yours before relying on it.
20
+ * typed attributes — but live verification requires a workspace. Set
21
+ * `DATABRICKS_LIVE_TEST=1` and `DATABRICKS_MLFLOW_EXPERIMENT_ID`, then run
22
+ * `pnpm --filter @fabric-harness/databricks test:live` before relying on it.
23
23
  *
24
24
  * Both `sink.record` and `onEvent` never throw — failures (including the
25
25
  * async POST) are reported through `onError`.
package/dist/model.d.ts CHANGED
@@ -1,29 +1,38 @@
1
- import type { ModelProvider } from '@fabric-harness/sdk';
1
+ import type { ModelMetadata, ModelProvider } from "@fabric-harness/sdk";
2
+ export type DatabricksInferenceMode = "auto" | "ai-gateway" | "serving-endpoints";
3
+ export type DatabricksRequestTags = Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
2
4
  export interface DatabricksModelOptions {
3
- /** Workspace host, e.g. https://adb-1234567890.0.cloud.databricks.com */
5
+ /** Workspace host, e.g. https://adb-1234567890.0.cloud.databricks.com. */
4
6
  host: string;
5
7
  /**
6
8
  * Bearer token, or a resolver awaited per request. Pass a resolver for OAuth principal tokens
7
9
  * (service-principal / on-behalf-of) so long-lived agents don't pin a stale token.
8
10
  */
9
11
  token: string | (() => string | Promise<string>);
10
- /** Serving-endpoint name used when a request doesn't specify a model. */
12
+ /** Serving endpoint or fully-qualified Unity AI Gateway model service. */
11
13
  defaultModel?: string;
12
- headers?: Record<string, string>;
14
+ /** Select routing explicitly. `auto` sends `system.ai.*` through Unity AI Gateway. */
15
+ mode?: DatabricksInferenceMode;
16
+ /** Explicit OpenAI-compatible base URL. Overrides `mode` URL construction. */
17
+ baseUrl?: string;
18
+ headers?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
19
+ /** Tags recorded by Unity AI Gateway usage and inference tables. */
20
+ requestTags?: DatabricksRequestTags;
21
+ /** Optional model metadata used by context budgeting and operator UIs. */
22
+ modelMetadata?: Record<string, Omit<ModelMetadata, "provider" | "model" | "gateway">>;
23
+ /** Fetch implementation for tests or controlled private-network transports. */
24
+ fetchImpl?: typeof fetch;
13
25
  }
26
+ /** Build the OpenAI-compatible base URL used for one Databricks inference mode. */
27
+ export declare function databricksModelBaseUrl(host: string, mode: Exclude<DatabricksInferenceMode, "auto">): string;
28
+ /** True for Unity Catalog model-service identifiers accepted by Unity AI Gateway. */
29
+ export declare function isDatabricksModelService(model: string | undefined): boolean;
14
30
  /**
15
- * Mosaic AI Model Serving provider. Databricks serving endpoints expose an OpenAI-compatible chat
16
- * API at `<host>/serving-endpoints/chat/completions` with the endpoint name carried as the `model`
17
- * field, so this is a thin configuration of {@link OpenAICompatibleModelProvider} — streaming,
18
- * tool-calls and reasoning effort come for free.
31
+ * Databricks inference provider supporting both Unity AI Gateway model services and custom
32
+ * Model Serving endpoints. In `auto` mode, fully-qualified `system.ai.*` models use AI Gateway and
33
+ * other endpoint names retain the `/serving-endpoints` route.
19
34
  */
20
35
  export declare function databricksFoundationModelProvider(options: DatabricksModelOptions): ModelProvider;
21
- /**
22
- * Register `databricks/<endpoint>` and `mosaic-ai/<endpoint>` model refs so they resolve via
23
- * `FABRIC_MODEL` / `init({ model })`. Idempotent. Call this explicitly (the `databricks()` bundle
24
- * does it for you) — registration is NOT an import side-effect, since the package is `sideEffects:
25
- * false` and a self-registering import could be tree-shaken. Credentials are read from
26
- * `providers.databricks` then env (`DATABRICKS_HOST`, `DATABRICKS_TOKEN`/`DATABRICKS_API_KEY`).
27
- */
36
+ /** Register `databricks/<model>` model references. */
28
37
  export declare function registerDatabricksModelProvider(): void;
29
38
  //# sourceMappingURL=model.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAwB,MAAM,qBAAqB,CAAC;AAE/E,MAAM,WAAW,sBAAsB;IACrC,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACjD,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,sBAAsB,GAAG,aAAa,CAUhG;AAmBD;;;;;;GAMG;AACH,wBAAgB,+BAA+B,IAAI,IAAI,CAKtD"}
1
+ {"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EAKd,MAAM,qBAAqB,CAAC;AAI7B,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,YAAY,GAAG,mBAAmB,CAAC;AAElF,MAAM,MAAM,qBAAqB,GAC7B,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;AAErE,MAAM,WAAW,sBAAsB;IACrC,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACjD,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,IAAI,CAAC,EAAE,uBAAuB,CAAC;IAC/B,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EACJ,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;IACrE,oEAAoE;IACpE,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC;IACtF,+EAA+E;IAC/E,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,mFAAmF;AACnF,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,CAAC,uBAAuB,EAAE,MAAM,CAAC,GAC7C,MAAM,CAKR;AAED,qFAAqF;AACrF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE3E;AAqGD;;;;GAIG;AACH,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,sBAAsB,GAAG,aAAa,CAEhG;AAgED,sDAAsD;AACtD,wBAAgB,+BAA+B,IAAI,IAAI,CAItD"}
package/dist/model.js CHANGED
@@ -1,50 +1,173 @@
1
- import { OpenAICompatibleModelProvider, registerModelProvider } from '@fabric-harness/sdk';
1
+ import { OpenAICompatibleModelProvider, currentSubmissionContext, registerModelProvider, } from "@fabric-harness/sdk";
2
+ import { databricksIdentity, databricksPrincipalFromEnv } from "./identity.js";
3
+ import { databricksWorkspaceOrigin } from "./client.js";
4
+ /** Build the OpenAI-compatible base URL used for one Databricks inference mode. */
5
+ export function databricksModelBaseUrl(host, mode) {
6
+ const normalized = databricksWorkspaceOrigin(host);
7
+ return mode === "ai-gateway"
8
+ ? `${normalized}/ai-gateway/mlflow/v1`
9
+ : `${normalized}/serving-endpoints`;
10
+ }
11
+ /** True for Unity Catalog model-service identifiers accepted by Unity AI Gateway. */
12
+ export function isDatabricksModelService(model) {
13
+ return model?.startsWith("system.ai.") ?? false;
14
+ }
15
+ class DatabricksModelProvider {
16
+ name = "databricks";
17
+ options;
18
+ gateway;
19
+ serving;
20
+ explicit;
21
+ constructor(options) {
22
+ this.options = options;
23
+ const common = {
24
+ name: this.name,
25
+ apiKey: typeof options.token === "string" ? options.token : "",
26
+ ...(typeof options.token === "function" ? { tokenProvider: options.token } : {}),
27
+ ...(options.defaultModel !== undefined ? { defaultModel: options.defaultModel } : {}),
28
+ ...(options.fetchImpl ? { fetchImpl: options.fetchImpl } : {}),
29
+ };
30
+ this.gateway = new OpenAICompatibleModelProvider({
31
+ ...common,
32
+ baseUrl: databricksModelBaseUrl(options.host, "ai-gateway"),
33
+ headers: () => this.resolveHeaders(true),
34
+ });
35
+ this.serving = new OpenAICompatibleModelProvider({
36
+ ...common,
37
+ baseUrl: databricksModelBaseUrl(options.host, "serving-endpoints"),
38
+ headers: () => this.resolveHeaders(false),
39
+ });
40
+ this.explicit = options.baseUrl
41
+ ? new OpenAICompatibleModelProvider({
42
+ ...common,
43
+ baseUrl: options.baseUrl,
44
+ headers: () => this.resolveHeaders(options.baseUrl?.includes("/ai-gateway/") ?? false),
45
+ })
46
+ : undefined;
47
+ }
48
+ generate(request) {
49
+ return this.providerFor(request.model).generate(request);
50
+ }
51
+ stream(request) {
52
+ const provider = this.providerFor(request.model);
53
+ if (!provider.stream)
54
+ throw new Error("databricks: selected provider does not support streaming.");
55
+ return provider.stream(request);
56
+ }
57
+ getModelMetadata(model = this.options.defaultModel) {
58
+ const mode = this.modeFor(model);
59
+ return {
60
+ provider: this.name,
61
+ ...(model ? { model } : {}),
62
+ gateway: this.options.baseUrl ?? databricksModelBaseUrl(this.options.host, mode),
63
+ ...(model && this.options.modelMetadata?.[model] ? this.options.modelMetadata[model] : {}),
64
+ };
65
+ }
66
+ providerFor(model = this.options.defaultModel) {
67
+ if (this.explicit)
68
+ return this.explicit;
69
+ return this.modeFor(model) === "ai-gateway" ? this.gateway : this.serving;
70
+ }
71
+ modeFor(model) {
72
+ const configured = this.options.mode ?? "auto";
73
+ if (configured !== "auto")
74
+ return configured;
75
+ return isDatabricksModelService(model) ? "ai-gateway" : "serving-endpoints";
76
+ }
77
+ async resolveHeaders(gateway) {
78
+ const configured = typeof this.options.headers === "function"
79
+ ? await this.options.headers()
80
+ : (this.options.headers ?? {});
81
+ if (!gateway)
82
+ return configured;
83
+ const supplied = typeof this.options.requestTags === "function"
84
+ ? await this.options.requestTags()
85
+ : (this.options.requestTags ?? {});
86
+ const context = currentSubmissionContext();
87
+ const tags = compactTags({
88
+ ...(context?.submissionId ? { submission_id: context.submissionId } : {}),
89
+ ...(context?.attemptId ? { attempt_id: context.attemptId } : {}),
90
+ ...(context?.tenantId ? { tenant_id: context.tenantId } : {}),
91
+ ...(context?.agent ? { agent: context.agent } : {}),
92
+ ...supplied,
93
+ });
94
+ return Object.keys(tags).length > 0
95
+ ? { ...configured, "Databricks-Ai-Gateway-Request-Tags": JSON.stringify(tags) }
96
+ : configured;
97
+ }
98
+ }
99
+ function compactTags(tags) {
100
+ return Object.fromEntries(Object.entries(tags)
101
+ .filter(([key, value]) => key.length > 0 && value.length > 0)
102
+ .map(([key, value]) => [key.slice(0, 128), value.slice(0, 512)]));
103
+ }
2
104
  /**
3
- * Mosaic AI Model Serving provider. Databricks serving endpoints expose an OpenAI-compatible chat
4
- * API at `<host>/serving-endpoints/chat/completions` with the endpoint name carried as the `model`
5
- * field, so this is a thin configuration of {@link OpenAICompatibleModelProvider} — streaming,
6
- * tool-calls and reasoning effort come for free.
105
+ * Databricks inference provider supporting both Unity AI Gateway model services and custom
106
+ * Model Serving endpoints. In `auto` mode, fully-qualified `system.ai.*` models use AI Gateway and
107
+ * other endpoint names retain the `/serving-endpoints` route.
7
108
  */
8
109
  export function databricksFoundationModelProvider(options) {
9
- const baseUrl = `${options.host.replace(/\/$/, '')}/serving-endpoints`;
10
- return new OpenAICompatibleModelProvider({
11
- name: 'databricks',
12
- baseUrl,
13
- apiKey: typeof options.token === 'string' ? options.token : '',
14
- ...(typeof options.token === 'function' ? { tokenProvider: options.token } : {}),
15
- ...(options.defaultModel !== undefined ? { defaultModel: options.defaultModel } : {}),
16
- ...(options.headers !== undefined ? { headers: options.headers } : {}),
17
- });
110
+ return new DatabricksModelProvider(options);
111
+ }
112
+ function inferenceMode(value) {
113
+ if (!value)
114
+ return undefined;
115
+ if (value === "auto" || value === "ai-gateway" || value === "serving-endpoints")
116
+ return value;
117
+ throw new Error(`Invalid DATABRICKS_INFERENCE_MODE "${value}". Use auto, ai-gateway, or serving-endpoints.`);
118
+ }
119
+ function origin(value) {
120
+ try {
121
+ return new URL(value).origin;
122
+ }
123
+ catch {
124
+ return value;
125
+ }
18
126
  }
19
127
  const factory = (parsed, providers, env, warnings) => {
20
- const settings = providers?.databricks ?? providers?.['mosaic-ai'];
21
- const host = settings?.baseUrl ?? env.DATABRICKS_HOST;
22
- if (!host)
23
- throw new Error('Missing Databricks host. Set DATABRICKS_HOST or providers.databricks.baseUrl.');
24
- const token = settings?.apiKey?.trim() || env[settings?.apiKeyEnv ?? 'DATABRICKS_TOKEN']?.trim() || env.DATABRICKS_API_KEY?.trim();
25
- if (!token)
26
- throw new Error('Missing Databricks token. Set DATABRICKS_TOKEN or providers.databricks.apiKey/apiKeyEnv.');
128
+ const settings = providers?.databricks;
129
+ const configuredUrl = settings?.baseUrl;
130
+ const rawHost = env.DATABRICKS_HOST ?? (configuredUrl ? origin(configuredUrl) : undefined);
131
+ if (!rawHost)
132
+ throw new Error("Missing Databricks host. Set DATABRICKS_HOST or providers.databricks.baseUrl.");
133
+ const host = rawHost.includes("://") ? rawHost : `https://${rawHost}`;
134
+ const staticToken = settings?.apiKey?.trim() ||
135
+ env[settings?.apiKeyEnv ?? "DATABRICKS_TOKEN"]?.trim() ||
136
+ env.DATABRICKS_API_KEY?.trim();
137
+ let principal;
138
+ if (!staticToken) {
139
+ try {
140
+ principal = databricksPrincipalFromEnv(env);
141
+ }
142
+ catch { }
143
+ }
144
+ if (!staticToken && !principal)
145
+ throw new Error("Missing Databricks credentials. Set DATABRICKS_TOKEN, DATABRICKS_CLIENT_ID + DATABRICKS_CLIENT_SECRET, or providers.databricks.apiKey/apiKeyEnv.");
146
+ const token = staticToken ?? databricksIdentity(principal);
147
+ const explicitBaseUrl = env.DATABRICKS_AI_GATEWAY_BASE_URL ??
148
+ (configuredUrl && new URL(configuredUrl).pathname !== "/" ? configuredUrl : undefined);
149
+ const mode = inferenceMode(env.DATABRICKS_INFERENCE_MODE);
27
150
  return {
28
151
  model: parsed.modelId,
29
- provider: databricksFoundationModelProvider({ host, token, defaultModel: parsed.modelId }),
30
- providerName: 'databricks',
152
+ provider: databricksFoundationModelProvider({
153
+ host,
154
+ token,
155
+ defaultModel: parsed.modelId,
156
+ ...(explicitBaseUrl ? { baseUrl: explicitBaseUrl } : {}),
157
+ ...(mode ? { mode } : {}),
158
+ ...(settings?.headers ? { headers: settings.headers } : {}),
159
+ }),
160
+ providerName: "databricks",
31
161
  modelId: parsed.modelId,
32
162
  warnings,
33
163
  };
34
164
  };
35
165
  let registered = false;
36
- /**
37
- * Register `databricks/<endpoint>` and `mosaic-ai/<endpoint>` model refs so they resolve via
38
- * `FABRIC_MODEL` / `init({ model })`. Idempotent. Call this explicitly (the `databricks()` bundle
39
- * does it for you) — registration is NOT an import side-effect, since the package is `sideEffects:
40
- * false` and a self-registering import could be tree-shaken. Credentials are read from
41
- * `providers.databricks` then env (`DATABRICKS_HOST`, `DATABRICKS_TOKEN`/`DATABRICKS_API_KEY`).
42
- */
166
+ /** Register `databricks/<model>` model references. */
43
167
  export function registerDatabricksModelProvider() {
44
168
  if (registered)
45
169
  return;
46
170
  registered = true;
47
- registerModelProvider('databricks', factory);
48
- registerModelProvider('mosaic-ai', factory);
171
+ registerModelProvider("databricks", factory);
49
172
  }
50
173
  //# sourceMappingURL=model.js.map
package/dist/model.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"model.js","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAgB3F;;;;;GAKG;AACH,MAAM,UAAU,iCAAiC,CAAC,OAA+B;IAC/E,MAAM,OAAO,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,oBAAoB,CAAC;IACvE,OAAO,IAAI,6BAA6B,CAAC;QACvC,IAAI,EAAE,YAAY;QAClB,OAAO;QACP,MAAM,EAAE,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QAC9D,GAAG,CAAC,OAAO,OAAO,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrF,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvE,CAAC,CAAC;AACL,CAAC;AAED,MAAM,OAAO,GAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE;IACzE,MAAM,QAAQ,GAAG,SAAS,EAAE,UAAU,IAAI,SAAS,EAAE,CAAC,WAAW,CAAC,CAAC;IACnE,MAAM,IAAI,GAAG,QAAQ,EAAE,OAAO,IAAI,GAAG,CAAC,eAAe,CAAC;IACtD,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAC;IAC5G,MAAM,KAAK,GAAG,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,QAAQ,EAAE,SAAS,IAAI,kBAAkB,CAAC,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,kBAAkB,EAAE,IAAI,EAAE,CAAC;IACnI,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,0FAA0F,CAAC,CAAC;IACxH,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,OAAO;QACrB,QAAQ,EAAE,iCAAiC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;QAC1F,YAAY,EAAE,YAAY;QAC1B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ;KACT,CAAC;AACJ,CAAC,CAAC;AAEF,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB;;;;;;GAMG;AACH,MAAM,UAAU,+BAA+B;IAC7C,IAAI,UAAU;QAAE,OAAO;IACvB,UAAU,GAAG,IAAI,CAAC;IAClB,qBAAqB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC7C,qBAAqB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC"}
1
+ {"version":3,"file":"model.js","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"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"}
@@ -23,8 +23,8 @@ export interface DatabricksPersistenceStoreModule {
23
23
  }
24
24
  export interface DatabricksPersistenceOptions {
25
25
  /**
26
- * Lakebase connection options (rotating-OAuth `token` supported), or an
27
- * already-constructed client to reuse.
26
+ * Lakebase connection options (workspace OAuth credential exchange or an
27
+ * explicit local/test password), or an already-constructed client to reuse.
28
28
  */
29
29
  lakebase: LakebaseClientOptions | LakebaseClient;
30
30
  /** Override the `@fabric-harness/node` loader (tests / bundlers). */
@@ -58,7 +58,7 @@ export interface DatabricksPersistence extends PersistenceAdapter {
58
58
  *
59
59
  * ```ts
60
60
  * const persistence = databricksPersistence({
61
- * lakebase: { host, database: 'fabric', user: clientId, token: identity },
61
+ * lakebase: { host, database: 'fabric', user: clientId, workspaceHost, endpoint, token: identity },
62
62
  * });
63
63
  * const { store, submissionStore, conversationStreamStore } = await persistence.connectAll();
64
64
  * await startDevServer({ submissionStore, conversationStreamStore });
@@ -66,7 +66,7 @@ export interface DatabricksPersistence extends PersistenceAdapter {
66
66
  *
67
67
  * The Postgres store implementations come from `@fabric-harness/node`
68
68
  * (optional peer) and run unchanged against Lakebase — the only Databricks
69
- * specifics are the rotating-token pool and TLS defaults from
69
+ * specifics are database-credential exchange, refresh caching, and TLS defaults from
70
70
  * {@link lakebaseClient}.
71
71
  */
72
72
  export declare function databricksPersistence(options: DatabricksPersistenceOptions): DatabricksPersistence;
@@ -4,7 +4,7 @@ import { lakebaseClient } from './lakebase.js';
4
4
  *
5
5
  * ```ts
6
6
  * const persistence = databricksPersistence({
7
- * lakebase: { host, database: 'fabric', user: clientId, token: identity },
7
+ * lakebase: { host, database: 'fabric', user: clientId, workspaceHost, endpoint, token: identity },
8
8
  * });
9
9
  * const { store, submissionStore, conversationStreamStore } = await persistence.connectAll();
10
10
  * await startDevServer({ submissionStore, conversationStreamStore });
@@ -12,7 +12,7 @@ import { lakebaseClient } from './lakebase.js';
12
12
  *
13
13
  * The Postgres store implementations come from `@fabric-harness/node`
14
14
  * (optional peer) and run unchanged against Lakebase — the only Databricks
15
- * specifics are the rotating-token pool and TLS defaults from
15
+ * specifics are database-credential exchange, refresh caching, and TLS defaults from
16
16
  * {@link lakebaseClient}.
17
17
  */
18
18
  export function databricksPersistence(options) {