@fabric-harness/databricks 4.3.1 → 4.4.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 (104) hide show
  1. package/dist/agent.js +5 -1
  2. package/dist/agent.js.map +1 -1
  3. package/dist/app-user-authorization.js +5 -1
  4. package/dist/app-user-authorization.js.map +1 -1
  5. package/dist/certify.js +29 -16
  6. package/dist/certify.js.map +1 -1
  7. package/dist/index.js +29 -16
  8. package/dist/index.js.map +1 -1
  9. package/dist/rag-chain.d.ts.map +1 -1
  10. package/dist/release-evidence.d.ts +1 -0
  11. package/dist/release-evidence.d.ts.map +1 -1
  12. package/dist/sql-sandbox.js +5 -1
  13. package/dist/sql-sandbox.js.map +1 -1
  14. package/package.json +11 -11
  15. package/dist/agent-services.js +0 -142
  16. package/dist/agent-services.js.map +0 -1
  17. package/dist/ai-gateway.js +0 -51
  18. package/dist/ai-gateway.js.map +0 -1
  19. package/dist/ai-search-admin.js +0 -194
  20. package/dist/ai-search-admin.js.map +0 -1
  21. package/dist/ai.js +0 -22
  22. package/dist/ai.js.map +0 -1
  23. package/dist/app.js +0 -143
  24. package/dist/app.js.map +0 -1
  25. package/dist/authoring-certification.js +0 -476
  26. package/dist/authoring-certification.js.map +0 -1
  27. package/dist/capabilities.js +0 -633
  28. package/dist/capabilities.js.map +0 -1
  29. package/dist/certification-resource.js +0 -17
  30. package/dist/certification-resource.js.map +0 -1
  31. package/dist/certification-sweeper.js +0 -128
  32. package/dist/certification-sweeper.js.map +0 -1
  33. package/dist/certification.js +0 -236
  34. package/dist/certification.js.map +0 -1
  35. package/dist/client.d.ts +0 -58
  36. package/dist/client.d.ts.map +0 -1
  37. package/dist/client.js +0 -184
  38. package/dist/client.js.map +0 -1
  39. package/dist/compatibility.js +0 -88
  40. package/dist/compatibility.js.map +0 -1
  41. package/dist/consumption.js +0 -85
  42. package/dist/consumption.js.map +0 -1
  43. package/dist/cost-budget-actuals.js +0 -316
  44. package/dist/cost-budget-actuals.js.map +0 -1
  45. package/dist/embeddings.js +0 -24
  46. package/dist/embeddings.js.map +0 -1
  47. package/dist/feature-serving.js +0 -29
  48. package/dist/feature-serving.js.map +0 -1
  49. package/dist/genie-agent-mode.js +0 -374
  50. package/dist/genie-agent-mode.js.map +0 -1
  51. package/dist/genie-authoring.js +0 -898
  52. package/dist/genie-authoring.js.map +0 -1
  53. package/dist/genie.js +0 -405
  54. package/dist/genie.js.map +0 -1
  55. package/dist/governance.js +0 -353
  56. package/dist/governance.js.map +0 -1
  57. package/dist/identity.js +0 -229
  58. package/dist/identity.js.map +0 -1
  59. package/dist/jobs-authoring.js +0 -570
  60. package/dist/jobs-authoring.js.map +0 -1
  61. package/dist/jobs.js +0 -173
  62. package/dist/jobs.js.map +0 -1
  63. package/dist/lakebase.js +0 -110
  64. package/dist/lakebase.js.map +0 -1
  65. package/dist/lakeflow-authoring.js +0 -115
  66. package/dist/lakeflow-authoring.js.map +0 -1
  67. package/dist/lakeflow.js +0 -75
  68. package/dist/lakeflow.js.map +0 -1
  69. package/dist/managed-resource.js +0 -197
  70. package/dist/managed-resource.js.map +0 -1
  71. package/dist/mlflow-tracing.js +0 -167
  72. package/dist/mlflow-tracing.js.map +0 -1
  73. package/dist/mock-provider.js +0 -66
  74. package/dist/mock-provider.js.map +0 -1
  75. package/dist/model.js +0 -173
  76. package/dist/model.js.map +0 -1
  77. package/dist/persistence.js +0 -82
  78. package/dist/persistence.js.map +0 -1
  79. package/dist/rag-chain.js +0 -212
  80. package/dist/rag-chain.js.map +0 -1
  81. package/dist/rag-eval.js +0 -151
  82. package/dist/rag-eval.js.map +0 -1
  83. package/dist/secrets-authoring.js +0 -78
  84. package/dist/secrets-authoring.js.map +0 -1
  85. package/dist/secrets.js +0 -25
  86. package/dist/secrets.js.map +0 -1
  87. package/dist/serving-admin.js +0 -255
  88. package/dist/serving-admin.js.map +0 -1
  89. package/dist/serving-usage.js +0 -100
  90. package/dist/serving-usage.js.map +0 -1
  91. package/dist/sql-exec.js +0 -36
  92. package/dist/sql-exec.js.map +0 -1
  93. package/dist/telemetry-sink.js +0 -180
  94. package/dist/telemetry-sink.js.map +0 -1
  95. package/dist/tools.js +0 -167
  96. package/dist/tools.js.map +0 -1
  97. package/dist/unity-catalog-admin.js +0 -166
  98. package/dist/unity-catalog-admin.js.map +0 -1
  99. package/dist/vector-search.js +0 -65
  100. package/dist/vector-search.js.map +0 -1
  101. package/dist/volumes-attachment-store.js +0 -172
  102. package/dist/volumes-attachment-store.js.map +0 -1
  103. package/dist/workspace-authoring.js +0 -78
  104. 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.3.1",
3
+ "version": "4.4.0",
4
4
  "description": "Databricks tools and filesystem sources for Fabric Harness agents.",
5
5
  "license": "Apache-2.0",
6
6
  "author": "Fabric",
@@ -57,13 +57,6 @@
57
57
  "LICENSE",
58
58
  "NOTICE"
59
59
  ],
60
- "scripts": {
61
- "build": "tsup && tsc -b tsconfig.json --force",
62
- "check": "tsc -b tsconfig.json --force",
63
- "pretest": "node scripts/fix-databricks-sdk-esm.mjs",
64
- "test": "vitest run",
65
- "test:sdk-runtime": "pnpm build && node -e \"import('./dist/index.js').then(m => { if (!m.databricks) process.exit(1) })\""
66
- },
67
60
  "dependencies": {
68
61
  "@databricks/sdk-accessmanagement": "0.21.0",
69
62
  "@databricks/sdk-auth": "0.21.0",
@@ -86,7 +79,7 @@
86
79
  "@databricks/sdk-uc-tables": "0.21.0",
87
80
  "@databricks/sdk-uc-volumes": "0.21.0",
88
81
  "@databricks/sdk-vectorsearch": "0.21.0",
89
- "@fabric-harness/sdk": "^4.1.1"
82
+ "@fabric-harness/sdk": "^4.2.0"
90
83
  },
91
84
  "peerDependencies": {
92
85
  "@fabric-harness/node": ">=3.0.0",
@@ -101,9 +94,16 @@
101
94
  }
102
95
  },
103
96
  "devDependencies": {
104
- "@fabric-harness/node": "^4.1.1",
97
+ "@fabric-harness/node": "^4.2.0",
105
98
  "tsup": "8.5.0",
106
99
  "typescript": "^5.8.3",
107
100
  "vitest": "^4.1.5"
101
+ },
102
+ "scripts": {
103
+ "build": "tsup && tsc -b tsconfig.json --force",
104
+ "check": "tsc -b tsconfig.json --force",
105
+ "pretest": "node scripts/fix-databricks-sdk-esm.mjs",
106
+ "test": "vitest run",
107
+ "test:sdk-runtime": "pnpm build && node -e \"import('./dist/index.js').then(m => { if (!m.databricks) process.exit(1) })\""
108
108
  }
109
- }
109
+ }
@@ -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