@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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fabric-harness/databricks",
3
- "version": "4.7.0",
3
+ "version": "4.8.0",
4
4
  "description": "Databricks tools and filesystem sources for Fabric Harness agents.",
5
5
  "license": "Apache-2.0",
6
6
  "author": "Fabric",
@@ -53,6 +53,10 @@
53
53
  "./platform": {
54
54
  "types": "./dist/platform.d.ts",
55
55
  "import": "./dist/platform.js"
56
+ },
57
+ "./runtime": {
58
+ "types": "./dist/runtime.d.ts",
59
+ "import": "./dist/runtime.js"
56
60
  }
57
61
  },
58
62
  "files": [
@@ -61,6 +65,13 @@
61
65
  "LICENSE",
62
66
  "NOTICE"
63
67
  ],
68
+ "scripts": {
69
+ "build": "tsup && tsc -b tsconfig.json --force",
70
+ "check": "tsc -b tsconfig.json --force",
71
+ "pretest": "node scripts/fix-databricks-sdk-esm.mjs",
72
+ "test": "vitest run",
73
+ "test:sdk-runtime": "pnpm build && node -e \"import('./dist/index.js').then(m => { if (!m.databricks) process.exit(1) })\""
74
+ },
64
75
  "dependencies": {
65
76
  "@databricks/sdk-accessmanagement": "0.21.0",
66
77
  "@databricks/sdk-auth": "0.21.0",
@@ -87,7 +98,7 @@
87
98
  },
88
99
  "peerDependencies": {
89
100
  "@fabric-harness/node": ">=3.0.0",
90
- "@fabricorg/platform": ">=0.8.0 <1",
101
+ "@fabricorg/platform": ">=0.9.0 <1",
91
102
  "pg": "^8.11.0"
92
103
  },
93
104
  "peerDependenciesMeta": {
@@ -103,16 +114,9 @@
103
114
  },
104
115
  "devDependencies": {
105
116
  "@fabric-harness/node": "^4.2.5",
106
- "@fabricorg/platform": "^0.8.0",
117
+ "@fabricorg/platform": "^0.9.0",
107
118
  "tsup": "8.5.0",
108
119
  "typescript": "^5.8.3",
109
120
  "vitest": "^4.1.5"
110
- },
111
- "scripts": {
112
- "build": "tsup && tsc -b tsconfig.json --force",
113
- "check": "tsc -b tsconfig.json --force",
114
- "pretest": "node scripts/fix-databricks-sdk-esm.mjs",
115
- "test": "vitest run",
116
- "test:sdk-runtime": "pnpm build && node -e \"import('./dist/index.js').then(m => { if (!m.databricks) process.exit(1) })\""
117
121
  }
118
- }
122
+ }
@@ -1,142 +0,0 @@
1
- export const DATABRICKS_AGENT_SERVICES_API = "/api/2.1/unity-catalog/agent-services";
2
- export const DATABRICKS_AGENT_SERVICE_SECURABLE = "AGENT_SERVICE";
3
- /**
4
- * Typed lifecycle client for Unity Catalog Agent Services.
5
- *
6
- * Databricks currently supports registration, discovery and grants only. This
7
- * client intentionally has no invoke method until runtime invocation is part of
8
- * the Agent Services API.
9
- */
10
- export class DatabricksAgentServices {
11
- client;
12
- constructor(client, options) {
13
- this.client = client;
14
- if (options.acknowledgeBeta !== true) {
15
- throw new Error("databricks agent services: acknowledgeBeta must be true.");
16
- }
17
- }
18
- create(options) {
19
- const catalog = ucIdentifier(options.catalog, "catalog");
20
- const schema = ucIdentifier(options.schema, "schema");
21
- const id = ucIdentifier(options.id, "agent service id");
22
- const basePath = externalBasePath(options.basePath ?? "/responses");
23
- return this.client.post(DATABRICKS_AGENT_SERVICES_API, {
24
- agent_service_type: "AGENT_SERVICE_TYPE_EXTERNAL",
25
- ...(options.comment !== undefined ? { comment: options.comment } : {}),
26
- config: {
27
- connection: { name: connectionResourceName(options.connection) },
28
- base_path: basePath,
29
- ...(options.systemPrompt !== undefined ? { system_prompt: options.systemPrompt } : {}),
30
- },
31
- }, { parent: `schemas/${catalog}.${schema}`, agent_service_id: id }, { retry: "never" });
32
- }
33
- get(fullName) {
34
- return this.client.get(agentServicePath(fullName));
35
- }
36
- list(options = {}) {
37
- if ((options.catalog === undefined) !== (options.schema === undefined)) {
38
- throw new Error("databricks agent services: catalog and schema must be provided together.");
39
- }
40
- const parent = options.catalog && options.schema
41
- ? `schemas/${ucIdentifier(options.catalog, "catalog")}.${ucIdentifier(options.schema, "schema")}`
42
- : undefined;
43
- return this.client.get(DATABRICKS_AGENT_SERVICES_API, {
44
- parent,
45
- page_token: options.pageToken,
46
- });
47
- }
48
- update(fullName, options) {
49
- const mask = [];
50
- const config = {};
51
- const body = {};
52
- if (options.comment !== undefined) {
53
- mask.push("comment");
54
- body.comment = options.comment;
55
- }
56
- if (options.basePath !== undefined) {
57
- mask.push("config.base_path");
58
- config.base_path = externalBasePath(options.basePath);
59
- }
60
- if (options.systemPrompt !== undefined) {
61
- mask.push("config.system_prompt");
62
- config.system_prompt = options.systemPrompt;
63
- }
64
- if (mask.length === 0) {
65
- throw new Error("databricks agent services: update requires comment, basePath or systemPrompt.");
66
- }
67
- if (Object.keys(config).length > 0)
68
- body.config = config;
69
- return this.client.request("PATCH", agentServicePath(fullName), body, { update_mask: mask.join(",") }, { retry: "safe" });
70
- }
71
- delete(fullName) {
72
- return this.client.request("DELETE", agentServicePath(fullName), undefined, {}, { retry: "never" });
73
- }
74
- permissions(fullName) {
75
- return this.client.get(permissionsPath(fullName));
76
- }
77
- updatePermissions(fullName, changes) {
78
- if (changes.length === 0) {
79
- throw new Error("databricks agent services: at least one permission change is required.");
80
- }
81
- for (const change of changes) {
82
- if (!change.principal.trim())
83
- throw new Error("databricks agent services: principal cannot be empty.");
84
- if ((change.add?.length ?? 0) === 0 && (change.remove?.length ?? 0) === 0) {
85
- throw new Error(`databricks agent services: ${change.principal} has no privileges to add or remove.`);
86
- }
87
- }
88
- return this.client.request("PATCH", permissionsPath(fullName), { changes }, {}, { retry: "safe" });
89
- }
90
- grant(fullName, principal, privileges = ["EXECUTE"]) {
91
- return this.updatePermissions(fullName, [{ principal, add: privileges }]);
92
- }
93
- revoke(fullName, principal, privileges = ["EXECUTE"]) {
94
- return this.updatePermissions(fullName, [{ principal, remove: privileges }]);
95
- }
96
- }
97
- export function databricksAgentServices(client, options) {
98
- return new DatabricksAgentServices(client, options);
99
- }
100
- function agentServicePath(fullName) {
101
- return `${DATABRICKS_AGENT_SERVICES_API}/${encodeURIComponent(fullUcName(fullName))}`;
102
- }
103
- function permissionsPath(fullName) {
104
- return `/api/2.1/unity-catalog/permissions/${DATABRICKS_AGENT_SERVICE_SECURABLE}/${encodeURIComponent(fullUcName(fullName))}`;
105
- }
106
- function fullUcName(value) {
107
- const parts = value.split(".");
108
- if (parts.length !== 3) {
109
- throw new Error(`databricks agent services: expected catalog.schema.service, received ${value}.`);
110
- }
111
- return parts
112
- .map((part, index) => ucIdentifier(part, ["catalog", "schema", "service"][index] ?? "identifier"))
113
- .join(".");
114
- }
115
- function connectionResourceName(value) {
116
- const trimmed = value.trim();
117
- const name = trimmed.startsWith("connections/") ? trimmed.slice("connections/".length) : trimmed;
118
- const parts = name.split(".");
119
- if (parts.length !== 1 && parts.length !== 3) {
120
- throw new Error(`databricks agent services: expected connection name or catalog.schema.connection, received ${value}.`);
121
- }
122
- return `connections/${parts
123
- .map((part, index) => ucIdentifier(part, parts.length === 1
124
- ? "connection"
125
- : (["catalog", "schema", "connection"][index] ?? "identifier")))
126
- .join(".")}`;
127
- }
128
- function externalBasePath(value) {
129
- const path = value.trim();
130
- if (!path.startsWith("/") || path.startsWith("//") || path.includes("?") || path.includes("#")) {
131
- throw new Error("databricks agent services: basePath must be an absolute URL path without a query or fragment.");
132
- }
133
- return path;
134
- }
135
- function ucIdentifier(value, label) {
136
- const normalized = value.trim();
137
- if (!/^[A-Za-z0-9_][A-Za-z0-9_$-]*$/.test(normalized)) {
138
- throw new Error(`databricks agent services: invalid ${label} ${JSON.stringify(value)}.`);
139
- }
140
- return normalized;
141
- }
142
- //# sourceMappingURL=agent-services.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"agent-services.js","sourceRoot":"","sources":["../src/agent-services.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,6BAA6B,GAAG,uCAAuC,CAAC;AACrF,MAAM,CAAC,MAAM,kCAAkC,GAAG,eAAe,CAAC;AAiFlE;;;;;;GAMG;AACH,MAAM,OAAO,uBAAuB;IAEf;IADnB,YACmB,MAA4B,EAC7C,OAAuC;QADtB,WAAM,GAAN,MAAM,CAAsB;QAG7C,IAAI,OAAO,CAAC,eAAe,KAAK,IAAI,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAED,MAAM,CAAC,OAA4C;QACjD,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACtD,MAAM,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,EAAE,EAAE,kBAAkB,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,CAAC,QAAQ,IAAI,YAAY,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CACrB,6BAA6B,EAC7B;YACE,kBAAkB,EAAE,6BAA6B;YACjD,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,MAAM,EAAE;gBACN,UAAU,EAAE,EAAE,IAAI,EAAE,sBAAsB,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;gBAChE,SAAS,EAAE,QAAQ;gBACnB,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvF;SACF,EACD,EAAE,MAAM,EAAE,WAAW,OAAO,IAAI,MAAM,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE,EAChE,EAAE,KAAK,EAAE,OAAO,EAAE,CACnB,CAAC;IACJ,CAAC;IAED,GAAG,CAAC,QAAgB;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAyB,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,IAAI,CACF,UAAqE,EAAE;QAEvE,IAAI,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,EAAE,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;QAC9F,CAAC;QACD,MAAM,MAAM,GACV,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM;YAC/B,CAAC,CAAC,WAAW,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE;YACjG,CAAC,CAAC,SAAS,CAAC;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAA6B,6BAA6B,EAAE;YAChF,MAAM;YACN,UAAU,EAAE,OAAO,CAAC,SAAS;SAC9B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CACJ,QAAgB,EAChB,OAA4C;QAE5C,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QACjC,CAAC;QACD,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACnC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAC9B,MAAM,CAAC,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACvC,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;YAClC,MAAM,CAAC,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;QAC9C,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,+EAA+E,CAChF,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACzD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,OAAO,EACP,gBAAgB,CAAC,QAAQ,CAAC,EAC1B,IAAI,EACJ,EAAE,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAC/B,EAAE,KAAK,EAAE,MAAM,EAAE,CAClB,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,QAAgB;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,QAAQ,EACR,gBAAgB,CAAC,QAAQ,CAAC,EAC1B,SAAS,EACT,EAAE,EACF,EAAE,KAAK,EAAE,OAAO,EAAE,CACnB,CAAC;IACJ,CAAC;IAED,WAAW,CAAC,QAAgB;QAC1B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAoC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvF,CAAC;IAED,iBAAiB,CACf,QAAgB,EAChB,OAA4C;QAE5C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;QAC5F,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE;gBAC1B,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;YAC3E,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1E,MAAM,IAAI,KAAK,CACb,8BAA8B,MAAM,CAAC,SAAS,sCAAsC,CACrF,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,OAAO,EACP,eAAe,CAAC,QAAQ,CAAC,EACzB,EAAE,OAAO,EAAE,EACX,EAAE,EACF,EAAE,KAAK,EAAE,MAAM,EAAE,CAClB,CAAC;IACJ,CAAC;IAED,KAAK,CACH,QAAgB,EAChB,SAAiB,EACjB,aAAgD,CAAC,SAAS,CAAC;QAE3D,OAAO,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,CACJ,QAAgB,EAChB,SAAiB,EACjB,aAAgD,CAAC,SAAS,CAAC;QAE3D,OAAO,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;IAC/E,CAAC;CACF;AAED,MAAM,UAAU,uBAAuB,CACrC,MAA4B,EAC5B,OAAuC;IAEvC,OAAO,IAAI,uBAAuB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAgB;IACxC,OAAO,GAAG,6BAA6B,IAAI,kBAAkB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;AACxF,CAAC;AAED,SAAS,eAAe,CAAC,QAAgB;IACvC,OAAO,sCAAsC,kCAAkC,IAAI,kBAAkB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;AAChI,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,wEAAwE,KAAK,GAAG,CACjF,CAAC;IACJ,CAAC;IACD,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACnB,YAAY,CAAC,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,CAC5E;SACA,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAa;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACjG,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CACb,8FAA8F,KAAK,GAAG,CACvG,CAAC;IACJ,CAAC;IACD,OAAO,eAAe,KAAK;SACxB,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACnB,YAAY,CACV,IAAI,EACJ,KAAK,CAAC,MAAM,KAAK,CAAC;QAChB,CAAC,CAAC,YAAY;QACd,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,CACjE,CACF;SACA,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AACjB,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC1B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/F,MAAM,IAAI,KAAK,CACb,+FAA+F,CAChG,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,YAAY,CAAC,KAAa,EAAE,KAAa;IAChD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,CAAC,+BAA+B,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,sCAAsC,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}
@@ -1,51 +0,0 @@
1
- /**
2
- * Verify that Unity AI Gateway v2 is enabled. A successful empty listing still means the service is
3
- * available; model-service discovery reports whether usable models exist.
4
- */
5
- export async function ensureDatabricksAiGateway(client) {
6
- await client.get("/api/ai-gateway/v2/endpoints", { page_size: 1 });
7
- }
8
- /** List fully-qualified Unity Catalog model services with bounded, loop-safe pagination. */
9
- export async function listDatabricksModelServices(client, options = {}) {
10
- const pageSize = positiveInteger(options.pageSize ?? 100, "pageSize");
11
- const maxPages = positiveInteger(options.maxPages ?? 100, "maxPages");
12
- const requiredPrefix = options.requiredPrefix ?? "system.ai.";
13
- const services = new Map();
14
- const seenTokens = new Set();
15
- let pageToken;
16
- for (let page = 0; page < maxPages; page += 1) {
17
- const response = await client.get("/api/2.1/unity-catalog/model-services", { page_size: pageSize, ...(pageToken ? { page_token: pageToken } : {}) });
18
- for (const raw of response.model_services ?? []) {
19
- const service = normalizeModelService(raw, requiredPrefix);
20
- if (service)
21
- services.set(service.name, service);
22
- }
23
- const next = response.next_page_token?.trim();
24
- if (!next)
25
- return [...services.values()].sort((a, b) => a.name.localeCompare(b.name));
26
- if (seenTokens.has(next))
27
- throw new Error(`databricks model-services pagination repeated token after page ${page + 1}.`);
28
- seenTokens.add(next);
29
- pageToken = next;
30
- }
31
- throw new Error(`databricks model-services pagination exceeded ${maxPages} pages.`);
32
- }
33
- function normalizeModelService(raw, requiredPrefix) {
34
- const rawName = typeof raw.name === "string" ? raw.name.trim() : "";
35
- const name = rawName.replace(/^model-services\//, "");
36
- if (!name.startsWith(requiredPrefix))
37
- return undefined;
38
- return {
39
- name,
40
- ...(typeof raw.comment === "string" ? { comment: raw.comment } : {}),
41
- ...(typeof raw.creator === "string" ? { creator: raw.creator } : {}),
42
- ...(typeof raw.created_at === "number" ? { createdAt: raw.created_at } : {}),
43
- ...(typeof raw.updated_at === "number" ? { updatedAt: raw.updated_at } : {}),
44
- };
45
- }
46
- function positiveInteger(value, name) {
47
- if (!Number.isSafeInteger(value) || value <= 0)
48
- throw new Error(`${name} must be a positive integer.`);
49
- return value;
50
- }
51
- //# sourceMappingURL=ai-gateway.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"ai-gateway.js","sourceRoot":"","sources":["../src/ai-gateway.ts"],"names":[],"mappings":"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"}
@@ -1,194 +0,0 @@
1
- export class DatabricksAiSearchAdmin {
2
- client;
3
- constructor(client) {
4
- this.client = client;
5
- }
6
- createEndpoint(name, endpointType = "STANDARD") {
7
- return this.client.post("/api/2.0/vector-search/endpoints", { name, endpoint_type: endpointType }, {}, { retry: "never" });
8
- }
9
- deleteEndpoint(name) {
10
- return this.client.delete(`/api/2.0/vector-search/endpoints/${encodeURIComponent(name)}`, undefined, {}, { retry: "safe" });
11
- }
12
- getEndpoint(name) {
13
- return this.client.get(`/api/2.0/vector-search/endpoints/${encodeURIComponent(name)}`);
14
- }
15
- async waitForEndpoint(name, options = {}) {
16
- const deadline = Date.now() + (options.timeoutMs ?? 900_000);
17
- while (true) {
18
- if (options.signal?.aborted)
19
- throw options.signal.reason ?? new DOMException("Aborted", "AbortError");
20
- const endpoint = await this.getEndpoint(name);
21
- const state = endpoint.endpoint_status?.state ??
22
- endpoint.status?.state;
23
- if (state === "ONLINE")
24
- return endpoint;
25
- if (state === "PROVISIONING_ERROR" || state === "OFFLINE")
26
- throw new Error(`Databricks AI Search endpoint ${name} reached ${String(state)}.`);
27
- if (Date.now() >= deadline)
28
- throw new Error(`Databricks AI Search endpoint ${name} timed out.`);
29
- await sleep(jitter(options.pollIntervalMs ?? 5000), options.signal);
30
- }
31
- }
32
- createIndex(spec) {
33
- return this.client.post("/api/2.0/vector-search/indexes", serializeIndex(spec), {}, { retry: "never" });
34
- }
35
- describeIndex(name) {
36
- return this.client.get(`/api/2.0/vector-search/indexes/${encodeURIComponent(name)}`);
37
- }
38
- deleteIndex(name) {
39
- return this.client.delete(`/api/2.0/vector-search/indexes/${encodeURIComponent(name)}`, undefined, {}, { retry: "safe" });
40
- }
41
- async syncIndex(name) {
42
- const index = await this.describeIndex(name);
43
- const type = index.index_type ?? index.indexType;
44
- if (type !== "DELTA_SYNC")
45
- throw new Error(`Databricks AI Search index ${name} is not a delta-sync index.`);
46
- return this.client.post(`/api/2.0/vector-search/indexes/${encodeURIComponent(name)}/sync`, undefined, {}, { retry: "never" });
47
- }
48
- }
49
- export function databricksAiSearchAdminTools(client) {
50
- const api = new DatabricksAiSearchAdmin(client);
51
- return [
52
- tool("databricks_create_search_endpoint", "write", endpointSchema(), [{ kind: "endpoint", path: "/name" }], (i) => api.createEndpoint(i.name, i.endpointType)),
53
- tool("databricks_delete_search_endpoint", "write", nameSchema(), [{ kind: "endpoint", path: "/name" }], (i) => api.deleteEndpoint(i.name)),
54
- tool("databricks_create_search_index", "write", indexSchema(), [
55
- { kind: "index", path: "/name", catalogQualified: true },
56
- { kind: "endpoint", path: "/endpointName" },
57
- { kind: "table", path: "/sourceTable", catalogQualified: true, optional: true },
58
- ], (i) => api.createIndex(i)),
59
- tool("databricks_delete_search_index", "write", nameSchema(), [{ kind: "index", path: "/name", catalogQualified: true }], (i) => api.deleteIndex(i.name)),
60
- tool("databricks_sync_search_index", "execute", nameSchema(), [{ kind: "index", path: "/name", catalogQualified: true }], (i) => api.syncIndex(i.name)),
61
- tool("databricks_describe_search_index", "read", nameSchema(), [{ kind: "index", path: "/name", catalogQualified: true }], (i) => api.describeIndex(i.name)),
62
- ];
63
- }
64
- function serializeIndex(spec) {
65
- if (spec.kind === "deltaSync")
66
- return {
67
- name: spec.name,
68
- endpoint_name: spec.endpointName,
69
- primary_key: spec.primaryKey,
70
- index_type: "DELTA_SYNC",
71
- delta_sync_index_spec: {
72
- source_table: spec.sourceTable,
73
- pipeline_type: spec.pipelineType,
74
- embedding_source_columns: [
75
- {
76
- name: spec.embedding.sourceColumn,
77
- embedding_model_endpoint_name: spec.embedding.modelEndpoint,
78
- },
79
- ],
80
- },
81
- };
82
- return {
83
- name: spec.name,
84
- endpoint_name: spec.endpointName,
85
- primary_key: spec.primaryKey,
86
- index_type: "DIRECT_ACCESS",
87
- direct_access_index_spec: {
88
- schema_json: JSON.stringify(Object.fromEntries(spec.schema.map((column) => [column.name, column.type]))),
89
- embedding_vector_columns: [
90
- {
91
- name: spec.embeddingVectorColumn.name,
92
- embedding_dimension: spec.embeddingVectorColumn.dimension,
93
- },
94
- ],
95
- },
96
- };
97
- }
98
- function tool(name, effect, inputSchema, resources, execute) {
99
- return {
100
- name,
101
- description: name.replaceAll("_", " "),
102
- inputSchema,
103
- metadata: { effect, provider: "databricks", service: "ai-search", governance: { resources } },
104
- execute,
105
- };
106
- }
107
- function nameSchema() {
108
- return {
109
- type: "object",
110
- additionalProperties: false,
111
- properties: { name: { type: "string" } },
112
- required: ["name"],
113
- };
114
- }
115
- function endpointSchema() {
116
- return {
117
- type: "object",
118
- additionalProperties: false,
119
- properties: {
120
- name: { type: "string" },
121
- endpointType: { type: "string", enum: ["STANDARD", "STORAGE_OPTIMIZED"] },
122
- },
123
- required: ["name"],
124
- };
125
- }
126
- function indexSchema() {
127
- return {
128
- oneOf: [
129
- {
130
- type: "object",
131
- additionalProperties: false,
132
- properties: {
133
- kind: { const: "deltaSync" },
134
- name: { type: "string" },
135
- endpointName: { type: "string" },
136
- primaryKey: { type: "string" },
137
- sourceTable: { type: "string" },
138
- pipelineType: { type: "string", enum: ["TRIGGERED", "CONTINUOUS"] },
139
- embedding: {
140
- type: "object",
141
- properties: { sourceColumn: { type: "string" }, modelEndpoint: { type: "string" } },
142
- required: ["sourceColumn", "modelEndpoint"],
143
- },
144
- },
145
- required: [
146
- "kind",
147
- "name",
148
- "endpointName",
149
- "primaryKey",
150
- "sourceTable",
151
- "pipelineType",
152
- "embedding",
153
- ],
154
- },
155
- {
156
- type: "object",
157
- additionalProperties: false,
158
- properties: {
159
- kind: { const: "directVector" },
160
- name: { type: "string" },
161
- endpointName: { type: "string" },
162
- primaryKey: { type: "string" },
163
- schema: {
164
- type: "array",
165
- items: {
166
- type: "object",
167
- properties: { name: { type: "string" }, type: { type: "string" } },
168
- required: ["name", "type"],
169
- },
170
- },
171
- embeddingVectorColumn: {
172
- type: "object",
173
- properties: { name: { type: "string" }, dimension: { type: "number" } },
174
- required: ["name", "dimension"],
175
- },
176
- },
177
- required: ["kind", "name", "endpointName", "primaryKey", "schema", "embeddingVectorColumn"],
178
- },
179
- ],
180
- };
181
- }
182
- function sleep(ms, signal) {
183
- return new Promise((resolve, reject) => {
184
- const timer = setTimeout(resolve, ms);
185
- signal?.addEventListener("abort", () => {
186
- clearTimeout(timer);
187
- reject(signal.reason);
188
- }, { once: true });
189
- });
190
- }
191
- function jitter(ms) {
192
- return Math.max(1, Math.round(ms * (0.9 + Math.random() * 0.2)));
193
- }
194
- //# sourceMappingURL=ai-search-admin.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"ai-search-admin.js","sourceRoot":"","sources":["../src/ai-search-admin.ts"],"names":[],"mappings":"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"}
package/dist/ai.js DELETED
@@ -1,22 +0,0 @@
1
- import { runStatement } from './sql-exec.js';
2
- /**
3
- * `ai_query(endpoint, request)` — run model inference inside the SQL warehouse against a serving
4
- * endpoint. Drives both serving and SQL-warehouse consumption. Uses named SQL parameters, so the
5
- * endpoint and request are never string-interpolated into SQL.
6
- */
7
- export function databricksAiQueryTool(client, options) {
8
- const poll = { intervalMs: options.pollIntervalMs ?? 2000, timeoutMs: options.timeoutMs ?? 120_000 };
9
- return {
10
- name: options.name ?? 'databricks_ai_query',
11
- description: options.description ?? 'Run model inference inside the SQL warehouse via ai_query() against a Databricks serving endpoint.',
12
- inputSchema: {
13
- type: 'object',
14
- additionalProperties: false,
15
- properties: { endpoint: { type: 'string' }, request: { type: 'string' } },
16
- required: ['endpoint', 'request'],
17
- },
18
- metadata: { effect: 'execute', provider: 'databricks', service: 'ai-functions' },
19
- execute: (input) => runStatement(client, options.warehouseId, 'SELECT ai_query(:endpoint, :request) AS result', [{ name: 'endpoint', value: input.endpoint }, { name: 'request', value: input.request }], poll),
20
- };
21
- }
22
- //# sourceMappingURL=ai.js.map
package/dist/ai.js.map DELETED
@@ -1 +0,0 @@
1
- {"version":3,"file":"ai.js","sourceRoot":"","sources":["../src/ai.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAU7C;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAA4B,EAAE,OAAqC;IACvG,MAAM,IAAI,GAAG,EAAE,UAAU,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,OAAO,EAAE,CAAC;IACrG,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,qBAAqB;QAC3C,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,oGAAoG;QACxI,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,oBAAoB,EAAE,KAAK;YAC3B,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;YACzE,QAAQ,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;SAClC;QACD,QAAQ,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE;QAChF,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAC9B,MAAM,EACN,OAAO,CAAC,WAAW,EACnB,gDAAgD,EAChD,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,EACxF,IAAI,CACL;KACF,CAAC;AACJ,CAAC"}
package/dist/app.js DELETED
@@ -1,143 +0,0 @@
1
- import { DatabricksRestClient } from "./client.js";
2
- import { appServicePrincipalFromEnv, databricksIdentity, fabricPrincipalFor, onBehalfOfFromHeaders, } from "./identity.js";
3
- import { databricksFoundationModelProvider, registerDatabricksModelProvider } from "./model.js";
4
- import { databricksPersistence } from "./persistence.js";
5
- import { databricksTelemetry } from "./telemetry-sink.js";
6
- import { UcVolumesAttachmentStore } from "./volumes-attachment-store.js";
7
- export function databricksApp(options = {}) {
8
- registerDatabricksModelProvider();
9
- const env = options.env ?? (typeof process !== "undefined" ? process.env : {});
10
- const principal = options.principal ?? appServicePrincipalFromEnv(env);
11
- if (!principal) {
12
- throw new Error("databricksApp() could not resolve an identity: pass `principal` or set DATABRICKS_HOST + DATABRICKS_CLIENT_ID + DATABRICKS_CLIENT_SECRET (the Databricks Apps runtime provides these).");
13
- }
14
- const host = options.host ??
15
- (principal.kind === "service-principal" || principal.kind === "cli-profile"
16
- ? principal.host
17
- : undefined) ??
18
- (env.DATABRICKS_HOST
19
- ? env.DATABRICKS_HOST.includes("://")
20
- ? env.DATABRICKS_HOST
21
- : `https://${env.DATABRICKS_HOST}`
22
- : undefined);
23
- if (!host) {
24
- throw new Error("databricksApp() requires a workspace host: pass `host` or set DATABRICKS_HOST.");
25
- }
26
- const identity = databricksIdentity(principal);
27
- const fabricPrincipal = fabricPrincipalFor(principal, {
28
- asAppPrincipal: true,
29
- ...(options.ucPrincipal ? { ucPrincipal: options.ucPrincipal } : {}),
30
- });
31
- const actor = { principal: fabricPrincipal };
32
- const client = new DatabricksRestClient({
33
- host,
34
- token: identity,
35
- ...(options.fetchImpl ? { fetchImpl: options.fetchImpl } : {}),
36
- });
37
- const model = options.model ?? env.DATABRICKS_MODEL;
38
- const envMode = parseInferenceMode(env.DATABRICKS_INFERENCE_MODE);
39
- const modelProvider = databricksFoundationModelProvider({
40
- host,
41
- token: identity,
42
- ...(model ? { defaultModel: model } : {}),
43
- ...(env.DATABRICKS_AI_GATEWAY_BASE_URL ? { baseUrl: env.DATABRICKS_AI_GATEWAY_BASE_URL } : {}),
44
- ...(envMode ? { mode: envMode } : {}),
45
- ...(options.inference ?? {}),
46
- ...(options.fetchImpl ? { fetchImpl: options.fetchImpl } : {}),
47
- });
48
- let persistence;
49
- if (options.lakebase !== false) {
50
- const lakebase = options.lakebase === undefined ? {} : options.lakebase;
51
- const lakebaseHost = lakebase.host ?? env.DATABRICKS_LAKEBASE_HOST ?? env.PGHOST;
52
- const database = lakebase.database ?? env.DATABRICKS_LAKEBASE_DATABASE ?? env.PGDATABASE;
53
- const endpoint = lakebase.endpoint ?? env.DATABRICKS_LAKEBASE_ENDPOINT ?? env.ENDPOINT_NAME;
54
- const user = lakebase.user ??
55
- env.DATABRICKS_LAKEBASE_USER ??
56
- env.PGUSER ??
57
- (principal.kind === "service-principal" ? principal.clientId : undefined);
58
- if (lakebaseHost && database && user && endpoint) {
59
- persistence = databricksPersistence({
60
- lakebase: {
61
- host: lakebaseHost,
62
- database,
63
- user,
64
- workspaceHost: host,
65
- endpoint,
66
- token: identity,
67
- ...(options.fetchImpl ? { fetchImpl: options.fetchImpl } : {}),
68
- ...(lakebase.port !== undefined
69
- ? { port: lakebase.port }
70
- : env.PGPORT
71
- ? { port: Number(env.PGPORT) }
72
- : {}),
73
- ...(lakebase.ssl !== undefined ? { ssl: lakebase.ssl } : {}),
74
- ...(lakebase.poolFactory ? { poolFactory: lakebase.poolFactory } : {}),
75
- },
76
- ...(options.loadPersistenceStores ? { loadStores: options.loadPersistenceStores } : {}),
77
- });
78
- }
79
- else if (options.lakebase !== undefined) {
80
- throw new Error("databricksApp({ lakebase }) is missing connection details: provide host/database/user/endpoint or the DATABRICKS_LAKEBASE_* (or PG*/ENDPOINT_NAME) environment variables from the app database resource.");
81
- }
82
- }
83
- const telemetry = persistence && options.telemetry !== false
84
- ? databricksTelemetry({ client: persistence.client })
85
- : undefined;
86
- const attachmentConfig = options.attachments === false ? undefined : (options.attachments ?? {});
87
- const attachmentCatalog = attachmentConfig?.catalog ?? env.DATABRICKS_CATALOG;
88
- const attachmentSchema = attachmentConfig?.schema ?? env.DATABRICKS_SCHEMA;
89
- const attachmentVolume = attachmentConfig?.volume ?? env.DATABRICKS_VOLUME;
90
- const attachmentStore = attachmentCatalog && attachmentSchema && attachmentVolume
91
- ? new UcVolumesAttachmentStore({
92
- host,
93
- token: identity,
94
- catalog: attachmentCatalog,
95
- schema: attachmentSchema,
96
- volume: attachmentVolume,
97
- rootPrefix: attachmentConfig?.rootPrefix ?? env.DATABRICKS_VOLUME_ROOT ?? "fh-attachments",
98
- ...(options.fetchImpl ? { fetchImpl: options.fetchImpl } : {}),
99
- })
100
- : undefined;
101
- return {
102
- identity,
103
- principal: fabricPrincipal,
104
- actor,
105
- client,
106
- modelProvider,
107
- ...(persistence ? { persistence } : {}),
108
- ...(telemetry ? { telemetry } : {}),
109
- ...(attachmentStore ? { attachmentStore } : {}),
110
- async serverOptions() {
111
- if (!persistence)
112
- return attachmentStore ? { attachmentStore } : {};
113
- const { store, submissionStore, conversationStreamStore } = await persistence.connectAll();
114
- return {
115
- sessionStore: store,
116
- submissionStore,
117
- conversationStreamStore,
118
- ...(telemetry ? { telemetry: telemetry.sink } : {}),
119
- ...(attachmentStore ? { attachmentStore } : {}),
120
- };
121
- },
122
- onBehalfOf(headers) {
123
- const user = onBehalfOfFromHeaders(headers);
124
- if (!user)
125
- return undefined;
126
- return {
127
- identity: databricksIdentity(user),
128
- actor: { principal: fabricPrincipalFor(user), onBehalfOf: user.label ?? "user" },
129
- };
130
- },
131
- async close() {
132
- await persistence?.close();
133
- },
134
- };
135
- }
136
- function parseInferenceMode(value) {
137
- if (!value)
138
- return undefined;
139
- if (value === "auto" || value === "ai-gateway" || value === "serving-endpoints")
140
- return value;
141
- throw new Error(`Invalid DATABRICKS_INFERENCE_MODE "${value}". Use auto, ai-gateway, or serving-endpoints.`);
142
- }
143
- //# sourceMappingURL=app.js.map