@fabric-harness/databricks 4.3.2 → 4.4.1

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 (113) hide show
  1. package/dist/agent-services.js +142 -0
  2. package/dist/agent-services.js.map +1 -0
  3. package/dist/agent.d.ts.map +1 -1
  4. package/dist/agent.js +197 -2
  5. package/dist/agent.js.map +1 -1
  6. package/dist/ai-gateway.js +51 -0
  7. package/dist/ai-gateway.js.map +1 -0
  8. package/dist/ai-search-admin.js +194 -0
  9. package/dist/ai-search-admin.js.map +1 -0
  10. package/dist/ai.js +22 -0
  11. package/dist/ai.js.map +1 -0
  12. package/dist/app-user-authorization.js +5 -1
  13. package/dist/app-user-authorization.js.map +1 -1
  14. package/dist/app.js +143 -0
  15. package/dist/app.js.map +1 -0
  16. package/dist/authoring-certification.js +476 -0
  17. package/dist/authoring-certification.js.map +1 -0
  18. package/dist/capabilities.d.ts.map +1 -1
  19. package/dist/capabilities.js +633 -0
  20. package/dist/capabilities.js.map +1 -0
  21. package/dist/certification-environment.d.ts.map +1 -1
  22. package/dist/certification-resource.js +17 -0
  23. package/dist/certification-resource.js.map +1 -0
  24. package/dist/certification-sweeper.js +128 -0
  25. package/dist/certification-sweeper.js.map +1 -0
  26. package/dist/certification.d.ts +8 -1
  27. package/dist/certification.d.ts.map +1 -1
  28. package/dist/certification.js +236 -0
  29. package/dist/certification.js.map +1 -0
  30. package/dist/certify.js +118 -19
  31. package/dist/certify.js.map +1 -1
  32. package/dist/client.d.ts +58 -0
  33. package/dist/client.d.ts.map +1 -0
  34. package/dist/client.js +184 -0
  35. package/dist/client.js.map +1 -0
  36. package/dist/compatibility.js +88 -0
  37. package/dist/compatibility.js.map +1 -0
  38. package/dist/consumption.js +85 -0
  39. package/dist/consumption.js.map +1 -0
  40. package/dist/cost-budget-actuals.js +316 -0
  41. package/dist/cost-budget-actuals.js.map +1 -0
  42. package/dist/embeddings.js +24 -0
  43. package/dist/embeddings.js.map +1 -0
  44. package/dist/feature-serving.js +29 -0
  45. package/dist/feature-serving.js.map +1 -0
  46. package/dist/genie-agent-mode.js +374 -0
  47. package/dist/genie-agent-mode.js.map +1 -0
  48. package/dist/genie-authoring.js +898 -0
  49. package/dist/genie-authoring.js.map +1 -0
  50. package/dist/genie.js +405 -0
  51. package/dist/genie.js.map +1 -0
  52. package/dist/governance.js +353 -0
  53. package/dist/governance.js.map +1 -0
  54. package/dist/identity.js +229 -0
  55. package/dist/identity.js.map +1 -0
  56. package/dist/index.d.ts +4 -0
  57. package/dist/index.d.ts.map +1 -1
  58. package/dist/index.js +402 -28
  59. package/dist/index.js.map +1 -1
  60. package/dist/jobs-authoring.js +570 -0
  61. package/dist/jobs-authoring.js.map +1 -0
  62. package/dist/jobs.js +173 -0
  63. package/dist/jobs.js.map +1 -0
  64. package/dist/lakebase.js +110 -0
  65. package/dist/lakebase.js.map +1 -0
  66. package/dist/lakeflow-authoring.js +115 -0
  67. package/dist/lakeflow-authoring.js.map +1 -0
  68. package/dist/lakeflow.js +75 -0
  69. package/dist/lakeflow.js.map +1 -0
  70. package/dist/managed-resource.js +197 -0
  71. package/dist/managed-resource.js.map +1 -0
  72. package/dist/mlflow-tracing.js +167 -0
  73. package/dist/mlflow-tracing.js.map +1 -0
  74. package/dist/mock-provider.js +66 -0
  75. package/dist/mock-provider.js.map +1 -0
  76. package/dist/model.js +173 -0
  77. package/dist/model.js.map +1 -0
  78. package/dist/persistence.js +82 -0
  79. package/dist/persistence.js.map +1 -0
  80. package/dist/rag-chain.d.ts.map +1 -1
  81. package/dist/rag-chain.js +212 -0
  82. package/dist/rag-chain.js.map +1 -0
  83. package/dist/rag-eval.js +151 -0
  84. package/dist/rag-eval.js.map +1 -0
  85. package/dist/release-evidence.d.ts +50 -0
  86. package/dist/release-evidence.d.ts.map +1 -0
  87. package/dist/secrets-authoring.js +78 -0
  88. package/dist/secrets-authoring.js.map +1 -0
  89. package/dist/secrets.js +25 -0
  90. package/dist/secrets.js.map +1 -0
  91. package/dist/serving-admin.js +255 -0
  92. package/dist/serving-admin.js.map +1 -0
  93. package/dist/serving-usage.js +100 -0
  94. package/dist/serving-usage.js.map +1 -0
  95. package/dist/sql-exec.js +36 -0
  96. package/dist/sql-exec.js.map +1 -0
  97. package/dist/sql-sandbox.d.ts +18 -0
  98. package/dist/sql-sandbox.d.ts.map +1 -1
  99. package/dist/sql-sandbox.js +119 -4
  100. package/dist/sql-sandbox.js.map +1 -1
  101. package/dist/telemetry-sink.js +180 -0
  102. package/dist/telemetry-sink.js.map +1 -0
  103. package/dist/tools.js +167 -0
  104. package/dist/tools.js.map +1 -0
  105. package/dist/unity-catalog-admin.js +166 -0
  106. package/dist/unity-catalog-admin.js.map +1 -0
  107. package/dist/vector-search.js +65 -0
  108. package/dist/vector-search.js.map +1 -0
  109. package/dist/volumes-attachment-store.js +172 -0
  110. package/dist/volumes-attachment-store.js.map +1 -0
  111. package/dist/workspace-authoring.js +78 -0
  112. package/dist/workspace-authoring.js.map +1 -0
  113. package/package.json +11 -11
@@ -0,0 +1,142 @@
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
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-services.js","sourceRoot":"","sources":["../src/agent-services.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,eAAe,EAEf,YAAY,EAGZ,UAAU,EACV,aAAa,EACb,cAAc,EACd,OAAO,EACR,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAG3E,MAAM,MAAM,4BAA4B,CAAC,MAAM,GAAG,UAAU,EAAE,OAAO,GAAG,OAAO,IAAI,IAAI,CACrF,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,KAAK,GAAG,OAAO,CAChB,GAAG;IACF,UAAU,CAAC,EAAE,sBAAsB,CAAC;IACpC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,KAAK,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,GAAG,CAAC,EAAE,CACJ,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG;QAAE,UAAU,EAAE,gBAAgB,CAAA;KAAE,KAChE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACjC,CAAC;AAkEF,wBAAgB,qBAAqB,CAAC,MAAM,GAAG,UAAU,EAAE,OAAO,GAAG,OAAO,EAC1E,OAAO,GAAE,4BAA4B,CAAC,MAAM,EAAE,OAAO,CAAM,GAC1D,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CA0C/B;AAuBD,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAgCnF"}
1
+ {"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEf,YAAY,EACZ,eAAe,EACf,YAAY,EAGZ,UAAU,EACV,aAAa,EACb,cAAc,EACd,OAAO,EACR,MAAM,qBAAqB,CAAC;AAO7B,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAI3E,MAAM,MAAM,4BAA4B,CAAC,MAAM,GAAG,UAAU,EAAE,OAAO,GAAG,OAAO,IAAI,IAAI,CACrF,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,KAAK,GAAG,OAAO,CAChB,GAAG;IACF,UAAU,CAAC,EAAE,sBAAsB,CAAC;IACpC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,KAAK,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,GAAG,CAAC,EAAE,CACJ,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG;QAAE,UAAU,EAAE,gBAAgB,CAAA;KAAE,KAChE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACjC,CAAC;AAkEF,wBAAgB,qBAAqB,CAAC,MAAM,GAAG,UAAU,EAAE,OAAO,GAAG,OAAO,EAC1E,OAAO,GAAE,4BAA4B,CAAC,MAAM,EAAE,OAAO,CAAM,GAC1D,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CA6C/B;AAuBD,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAgCnF"}
package/dist/agent.js CHANGED
@@ -1793,7 +1793,11 @@ var require_json_bigint = __commonJS({
1793
1793
  });
1794
1794
 
1795
1795
  // src/agent.ts
1796
- import { defineAgent, mergeCapabilityPolicies } from "@fabric-harness/sdk/strict";
1796
+ import {
1797
+ defineAgent,
1798
+ listSandboxBackendFactories,
1799
+ mergeCapabilityPolicies
1800
+ } from "@fabric-harness/sdk/strict";
1797
1801
 
1798
1802
  // ../../node_modules/.pnpm/@databricks+sdk-auth@0.21.0/node_modules/@databricks/sdk-auth/package.json
1799
1803
  var package_default = {
@@ -57103,7 +57107,11 @@ function fabricHttpClient(fetchImpl, extraHeaders) {
57103
57107
  if (request.body instanceof ReadableStream) {
57104
57108
  init.duplex = "half";
57105
57109
  }
57106
- const response = await fetchImpl(request.url, init);
57110
+ const url2 = new URL(request.url);
57111
+ if (/^\/api\/serving-endpoints\/[^/]+\/invocations$/u.test(url2.pathname)) {
57112
+ url2.pathname = url2.pathname.slice("/api".length);
57113
+ }
57114
+ const response = await fetchImpl(url2, init);
57107
57115
  return {
57108
57116
  statusCode: response.status,
57109
57117
  headers: response.headers,
@@ -58044,6 +58052,190 @@ function base643(value) {
58044
58052
  return btoa(String.fromCharCode(...bytes));
58045
58053
  }
58046
58054
 
58055
+ // src/sql-sandbox.ts
58056
+ import { createRemoteSandboxEnv, registerSandboxBackendFactory, registerSandboxRefDecoder, unregisterSandboxBackendFactory, unregisterSandboxRefDecoder } from "@fabric-harness/sdk";
58057
+ var DATABRICKS_SQL_SANDBOX_REF_PROVIDER = "databricks-sql";
58058
+ function databricksSqlSandbox(options) {
58059
+ const identity = databricksIdentity(options.principal);
58060
+ const client = options.client ?? createDatabricksNativeClients({
58061
+ host: options.host,
58062
+ credentials: databricksCredentials(options.principal),
58063
+ tokenProvider: identity,
58064
+ ...options.fetchImpl ? { fetchImpl: options.fetchImpl } : {}
58065
+ }).statements;
58066
+ const waitTimeoutSeconds = options.waitTimeoutSeconds ?? 30;
58067
+ const resultFormat = options.resultFormat ?? "jsonl";
58068
+ const memFs = /* @__PURE__ */ new Map();
58069
+ const api = {
58070
+ async exec(command) {
58071
+ const startedAt = Date.now();
58072
+ try {
58073
+ const response = await client.executeStatement({
58074
+ warehouseId: options.warehouseId,
58075
+ statement: command,
58076
+ waitTimeout: `${waitTimeoutSeconds}s`,
58077
+ onWaitTimeout: "CANCEL",
58078
+ ...options.catalog ? { catalog: options.catalog } : {},
58079
+ ...options.schema ? { schema: options.schema } : {}
58080
+ });
58081
+ if (response.status?.state === "FAILED" || response.status?.state === "CANCELED") {
58082
+ return {
58083
+ command,
58084
+ exitCode: 1,
58085
+ stdout: "",
58086
+ stderr: response.status.error?.message ?? `Statement ${response.status.state}`,
58087
+ durationMs: Date.now() - startedAt
58088
+ };
58089
+ }
58090
+ const stdout = serializeResult(response, resultFormat);
58091
+ return { command, exitCode: 0, stdout, stderr: "", durationMs: Date.now() - startedAt };
58092
+ } catch (error51) {
58093
+ return {
58094
+ command,
58095
+ exitCode: 1,
58096
+ stdout: "",
58097
+ stderr: error51 instanceof Error ? error51.message : String(error51),
58098
+ durationMs: Date.now() - startedAt
58099
+ };
58100
+ }
58101
+ },
58102
+ async readFile(path) {
58103
+ const bytes = memFs.get(path);
58104
+ if (!bytes) throw new Error(`No such file: ${path}`);
58105
+ return new TextDecoder().decode(bytes);
58106
+ },
58107
+ async readFileBuffer(path) {
58108
+ const bytes = memFs.get(path);
58109
+ if (!bytes) throw new Error(`No such file: ${path}`);
58110
+ return bytes;
58111
+ },
58112
+ async writeFile(path, content) {
58113
+ memFs.set(path, typeof content === "string" ? new TextEncoder().encode(content) : content);
58114
+ },
58115
+ async stat(path) {
58116
+ const bytes = memFs.get(path);
58117
+ if (!bytes) throw new Error(`No such file: ${path}`);
58118
+ return { type: "file", size: bytes.byteLength };
58119
+ },
58120
+ async readdir(path) {
58121
+ const prefix = path.replace(/\/$/, "");
58122
+ const direct = /* @__PURE__ */ new Set();
58123
+ for (const key of memFs.keys()) {
58124
+ if (!key.startsWith(`${prefix}/`)) continue;
58125
+ const tail = key.slice(prefix.length + 1);
58126
+ const slash = tail.indexOf("/");
58127
+ direct.add(slash > 0 ? tail.slice(0, slash) : tail);
58128
+ }
58129
+ return [...direct];
58130
+ },
58131
+ async exists(path) {
58132
+ return memFs.has(path);
58133
+ },
58134
+ async mkdir() {
58135
+ },
58136
+ async rm(path) {
58137
+ for (const key of [...memFs.keys()]) {
58138
+ if (key === path || key.startsWith(`${path}/`)) memFs.delete(key);
58139
+ }
58140
+ }
58141
+ };
58142
+ return createRemoteSandboxEnv(api, {
58143
+ cwd: "/workspace",
58144
+ capabilities: { exec: true, filesystem: true, binaryFiles: true, snapshots: false, restore: false, reconnect: true, network: "provider-managed", persistence: "session", isolation: "provider" },
58145
+ encodeRef: () => ({
58146
+ provider: DATABRICKS_SQL_SANDBOX_REF_PROVIDER,
58147
+ providerData: databricksSqlSandboxRefData(options)
58148
+ })
58149
+ });
58150
+ }
58151
+ function registerDatabricksSqlSandboxBackend(registration = {}) {
58152
+ registerSandboxBackendFactory("databricks", (factoryOptions) => createRegisteredDatabricksSqlSandbox(factoryOptions, registration));
58153
+ registerSandboxRefDecoder(DATABRICKS_SQL_SANDBOX_REF_PROVIDER, (providerData) => {
58154
+ const target = assertDatabricksSqlSandboxRefData(providerData);
58155
+ return (factoryOptions) => databricksSqlSandbox({
58156
+ ...target,
58157
+ principal: resolveRegisteredPrincipal(factoryOptions, target, registration),
58158
+ ...registration.client ? { client: registration.client } : {}
58159
+ });
58160
+ });
58161
+ }
58162
+ function createRegisteredDatabricksSqlSandbox(options, registration) {
58163
+ const env2 = options.env ?? process.env;
58164
+ const metadata = options.metadata ?? {};
58165
+ const catalog = metadataString(metadata, "databricksCatalog") ?? env2.DATABRICKS_CATALOG;
58166
+ const schema = metadataString(metadata, "databricksSchema") ?? env2.DATABRICKS_SCHEMA;
58167
+ const resultFormat = metadataString(metadata, "databricksResultFormat");
58168
+ const target = {
58169
+ host: metadataString(metadata, "databricksHost") ?? env2.DATABRICKS_HOST ?? "",
58170
+ warehouseId: metadataString(metadata, "databricksWarehouseId") ?? env2.DATABRICKS_WAREHOUSE_ID ?? "",
58171
+ ...catalog ? { catalog } : {},
58172
+ ...schema ? { schema } : {},
58173
+ ...resultFormat ? { resultFormat: assertResultFormat(resultFormat) } : {}
58174
+ };
58175
+ assertDatabricksSqlSandboxRefData(target);
58176
+ return databricksSqlSandbox({
58177
+ ...target,
58178
+ principal: resolveRegisteredPrincipal(options, target, registration),
58179
+ ...registration.client ? { client: registration.client } : {}
58180
+ });
58181
+ }
58182
+ function resolveRegisteredPrincipal(options, target, registration) {
58183
+ const env2 = options.env ?? process.env;
58184
+ return registration.resolvePrincipal?.(env2, target) ?? databricksPrincipalFromEnv(env2);
58185
+ }
58186
+ function databricksSqlSandboxRefData(options) {
58187
+ return {
58188
+ host: options.host,
58189
+ warehouseId: options.warehouseId,
58190
+ ...options.catalog ? { catalog: options.catalog } : {},
58191
+ ...options.schema ? { schema: options.schema } : {},
58192
+ ...options.resultFormat ? { resultFormat: options.resultFormat } : {},
58193
+ ...options.waitTimeoutSeconds !== void 0 ? { waitTimeoutSeconds: options.waitTimeoutSeconds } : {}
58194
+ };
58195
+ }
58196
+ function assertDatabricksSqlSandboxRefData(value) {
58197
+ if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error("Invalid Databricks SQL sandbox reference.");
58198
+ const data = value;
58199
+ if (typeof data.host !== "string" || data.host.trim().length === 0) throw new Error("Databricks SQL sandbox reference is missing host.");
58200
+ if (typeof data.warehouseId !== "string" || data.warehouseId.trim().length === 0) throw new Error("Databricks SQL sandbox reference is missing warehouseId.");
58201
+ const result = { host: data.host, warehouseId: data.warehouseId };
58202
+ if (typeof data.catalog === "string") result.catalog = data.catalog;
58203
+ if (typeof data.schema === "string") result.schema = data.schema;
58204
+ if (data.resultFormat !== void 0) result.resultFormat = assertResultFormat(data.resultFormat);
58205
+ if (data.waitTimeoutSeconds !== void 0) {
58206
+ if (typeof data.waitTimeoutSeconds !== "number" || !Number.isFinite(data.waitTimeoutSeconds)) throw new Error("Databricks SQL sandbox reference has an invalid waitTimeoutSeconds.");
58207
+ result.waitTimeoutSeconds = data.waitTimeoutSeconds;
58208
+ }
58209
+ return result;
58210
+ }
58211
+ function metadataString(metadata, key) {
58212
+ const value = metadata[key];
58213
+ return typeof value === "string" && value.trim().length > 0 ? value : void 0;
58214
+ }
58215
+ function assertResultFormat(value) {
58216
+ if (value === "jsonl" || value === "csv") return value;
58217
+ throw new Error("Databricks SQL sandbox result format must be jsonl or csv.");
58218
+ }
58219
+ function serializeResult(response, format) {
58220
+ const columns = response.manifest?.schema?.columns?.map((c2) => c2.name ?? "") ?? [];
58221
+ const rows = response.result?.dataArray ?? [];
58222
+ if (format === "csv") {
58223
+ const header = columns.join(",");
58224
+ const body = rows.map((row) => row.map(formatCsvCell).join(",")).join("\n");
58225
+ return [header, body].filter(Boolean).join("\n");
58226
+ }
58227
+ return rows.map((row) => {
58228
+ const obj = {};
58229
+ for (let i2 = 0; i2 < columns.length; i2 += 1) obj[columns[i2] ?? `_${i2}`] = row[i2];
58230
+ return JSON.stringify(obj);
58231
+ }).join("\n");
58232
+ }
58233
+ function formatCsvCell(value) {
58234
+ if (value === null || value === void 0) return "";
58235
+ const str = String(value);
58236
+ return /[",\n]/.test(str) ? `"${str.replace(/"/g, '""')}"` : str;
58237
+ }
58238
+
58047
58239
  // src/index.ts
58048
58240
  function databricks(config2) {
58049
58241
  return buildDatabricksBundle(config2);
@@ -58356,6 +58548,9 @@ function defineDatabricksAgent(options = {}) {
58356
58548
  } = merged;
58357
58549
  const directTools = tools.filter((tool7) => typeof tool7 !== "string");
58358
58550
  const toolRefs = tools.filter((tool7) => typeof tool7 === "string");
58551
+ if (sandbox === "databricks" && !listSandboxBackendFactories().includes("databricks")) {
58552
+ registerDatabricksSqlSandboxBackend();
58553
+ }
58359
58554
  const def = {
58360
58555
  ...definition,
58361
58556
  ...directTools.length > 0 ? { tools: directTools } : {},