@fabric-harness/databricks 4.1.1 → 4.3.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 (101) hide show
  1. package/dist/agent-services.js +142 -0
  2. package/dist/agent-services.js.map +1 -0
  3. package/dist/agent.js +1727 -1727
  4. package/dist/agent.js.map +1 -1
  5. package/dist/ai-gateway.js +51 -0
  6. package/dist/ai-gateway.js.map +1 -0
  7. package/dist/ai-search-admin.js +194 -0
  8. package/dist/ai-search-admin.js.map +1 -0
  9. package/dist/ai.js +22 -0
  10. package/dist/ai.js.map +1 -0
  11. package/dist/app-deployment.d.ts +79 -0
  12. package/dist/app-deployment.d.ts.map +1 -0
  13. package/dist/app-user-authorization.js +38942 -0
  14. package/dist/app-user-authorization.js.map +1 -0
  15. package/dist/app.js +143 -0
  16. package/dist/app.js.map +1 -0
  17. package/dist/authoring-certification.js +476 -0
  18. package/dist/authoring-certification.js.map +1 -0
  19. package/dist/capabilities.js +633 -0
  20. package/dist/capabilities.js.map +1 -0
  21. package/dist/certification-resource.js +17 -0
  22. package/dist/certification-resource.js.map +1 -0
  23. package/dist/certification-sweeper.js +128 -0
  24. package/dist/certification-sweeper.js.map +1 -0
  25. package/dist/certification.js +236 -0
  26. package/dist/certification.js.map +1 -0
  27. package/dist/client.d.ts +58 -0
  28. package/dist/client.d.ts.map +1 -0
  29. package/dist/client.js +184 -0
  30. package/dist/client.js.map +1 -0
  31. package/dist/compatibility.js +88 -0
  32. package/dist/compatibility.js.map +1 -0
  33. package/dist/consumption.js +85 -0
  34. package/dist/consumption.js.map +1 -0
  35. package/dist/cost-budget-actuals.js +316 -0
  36. package/dist/cost-budget-actuals.js.map +1 -0
  37. package/dist/embeddings.js +24 -0
  38. package/dist/embeddings.js.map +1 -0
  39. package/dist/feature-serving.js +29 -0
  40. package/dist/feature-serving.js.map +1 -0
  41. package/dist/genie-agent-mode.js +374 -0
  42. package/dist/genie-agent-mode.js.map +1 -0
  43. package/dist/genie-authoring.js +898 -0
  44. package/dist/genie-authoring.js.map +1 -0
  45. package/dist/genie.js +405 -0
  46. package/dist/genie.js.map +1 -0
  47. package/dist/governance.js +353 -0
  48. package/dist/governance.js.map +1 -0
  49. package/dist/identity.js +229 -0
  50. package/dist/identity.js.map +1 -0
  51. package/dist/index.d.ts +4 -1
  52. package/dist/index.d.ts.map +1 -1
  53. package/dist/index.js +1446 -1288
  54. package/dist/index.js.map +1 -1
  55. package/dist/jobs-authoring.js +570 -0
  56. package/dist/jobs-authoring.js.map +1 -0
  57. package/dist/jobs.js +173 -0
  58. package/dist/jobs.js.map +1 -0
  59. package/dist/lakebase.js +110 -0
  60. package/dist/lakebase.js.map +1 -0
  61. package/dist/lakeflow-authoring.js +115 -0
  62. package/dist/lakeflow-authoring.js.map +1 -0
  63. package/dist/lakeflow.js +75 -0
  64. package/dist/lakeflow.js.map +1 -0
  65. package/dist/managed-resource.js +197 -0
  66. package/dist/managed-resource.js.map +1 -0
  67. package/dist/mlflow-tracing.js +167 -0
  68. package/dist/mlflow-tracing.js.map +1 -0
  69. package/dist/mock-provider.js +66 -0
  70. package/dist/mock-provider.js.map +1 -0
  71. package/dist/model.js +173 -0
  72. package/dist/model.js.map +1 -0
  73. package/dist/persistence.js +82 -0
  74. package/dist/persistence.js.map +1 -0
  75. package/dist/rag-chain.js +212 -0
  76. package/dist/rag-chain.js.map +1 -0
  77. package/dist/rag-eval.js +151 -0
  78. package/dist/rag-eval.js.map +1 -0
  79. package/dist/secrets-authoring.js +78 -0
  80. package/dist/secrets-authoring.js.map +1 -0
  81. package/dist/secrets.js +25 -0
  82. package/dist/secrets.js.map +1 -0
  83. package/dist/serving-admin.js +255 -0
  84. package/dist/serving-admin.js.map +1 -0
  85. package/dist/serving-usage.js +100 -0
  86. package/dist/serving-usage.js.map +1 -0
  87. package/dist/sql-exec.js +36 -0
  88. package/dist/sql-exec.js.map +1 -0
  89. package/dist/telemetry-sink.js +180 -0
  90. package/dist/telemetry-sink.js.map +1 -0
  91. package/dist/tools.js +167 -0
  92. package/dist/tools.js.map +1 -0
  93. package/dist/unity-catalog-admin.js +166 -0
  94. package/dist/unity-catalog-admin.js.map +1 -0
  95. package/dist/vector-search.js +65 -0
  96. package/dist/vector-search.js.map +1 -0
  97. package/dist/volumes-attachment-store.js +172 -0
  98. package/dist/volumes-attachment-store.js.map +1 -0
  99. package/dist/workspace-authoring.js +78 -0
  100. package/dist/workspace-authoring.js.map +1 -0
  101. package/package.json +15 -11
package/dist/app.js ADDED
@@ -0,0 +1,143 @@
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
@@ -0,0 +1 @@
1
+ {"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,476 @@
1
+ import { createApprovalGrant, evaluateToolCallPolicy, } from "@fabric-harness/sdk";
2
+ import { runDatabricksAuthoringLifecycle, } from "./certification.js";
3
+ import { databricksAiSearchAdminTools, DatabricksAiSearchAdmin, } from "./ai-search-admin.js";
4
+ import { DatabricksJobsAuthoring, databricksJobsAuthoringTools, } from "./jobs-authoring.js";
5
+ import { DatabricksLakeflowAuthoring, databricksLakeflowAuthoringTools, } from "./lakeflow-authoring.js";
6
+ import { DatabricksServingAdmin, databricksServingAdminTools, } from "./serving-admin.js";
7
+ import { databricksSecretsAuthoringTools } from "./secrets-authoring.js";
8
+ import { databricksUnityCatalogAdminTools } from "./unity-catalog-admin.js";
9
+ import { databricksWorkspaceAuthoringTools } from "./workspace-authoring.js";
10
+ import { databricksGovernancePolicy, withGovernance } from "./governance.js";
11
+ import { DatabricksGenieAdmin, databricksGenieAuthoringTools, } from "./genie-authoring.js";
12
+ import { databricksGenie } from "./genie.js";
13
+ import { MemoryDatabricksManagedResourceStore } from "./managed-resource.js";
14
+ class GovernedCertificationRunner {
15
+ fixtures;
16
+ lineage = [];
17
+ calls = 0;
18
+ constructor(fixtures) {
19
+ this.fixtures = fixtures;
20
+ }
21
+ async execute(tool, input) {
22
+ const service = String(tool.metadata?.service ?? "");
23
+ const policy = databricksGovernancePolicy({
24
+ tools: [tool],
25
+ host: this.fixtures.host,
26
+ stewardAudience: "databricks-certification-stewards",
27
+ approvalServices: [service],
28
+ });
29
+ const decision = evaluateToolCallPolicy({ tool: tool.name, input }, policy);
30
+ if (!decision.approvalRequired ||
31
+ decision.approvalAudience !== "databricks-certification-stewards") {
32
+ throw new Error(`Databricks certification tool ${tool.name} did not route to steward approval.`);
33
+ }
34
+ const toolCallId = `databricks-certification:${tool.name}:${++this.calls}`;
35
+ const grant = createApprovalGrant({
36
+ approvalId: `approval:${toolCallId}`,
37
+ toolCallId,
38
+ toolInput: input,
39
+ principal: this.fixtures.executingPrincipal,
40
+ response: {
41
+ decision: "approved",
42
+ approvers: [
43
+ {
44
+ id: this.fixtures.steward.id,
45
+ type: "user",
46
+ ...(this.fixtures.steward.displayName
47
+ ? { displayName: this.fixtures.steward.displayName }
48
+ : {}),
49
+ },
50
+ ],
51
+ },
52
+ createdAt: new Date().toISOString(),
53
+ });
54
+ const governed = withGovernance(tool, {
55
+ executingPrincipal: this.fixtures.executingPrincipal,
56
+ requireApprovalGrantFor: [service],
57
+ onLineage: (record) => this.lineage.push(record),
58
+ });
59
+ return (await governed.execute?.(input, { toolCallId, approval: grant }));
60
+ }
61
+ evidence(lifecycle) {
62
+ const approved = this.lineage.filter((row) => row.ok && row.approvers?.length).length;
63
+ if (approved !== this.calls) {
64
+ throw new Error(`Databricks certification lineage captured ${approved}/${this.calls} approved calls.`);
65
+ }
66
+ return {
67
+ ...(lifecycle ?? {}),
68
+ approvedToolCalls: this.calls,
69
+ lineageRecords: this.lineage.length,
70
+ executingPrincipal: this.fixtures.executingPrincipal.id,
71
+ steward: this.fixtures.steward.id,
72
+ };
73
+ }
74
+ }
75
+ export function createDatabricksAuthoringCertificationChecks(fixtures) {
76
+ return [
77
+ check("approval-provenance", fixtures.enabled, () => approvalProvenance(fixtures)),
78
+ check("jobs-authoring", fixtures.enabled && Boolean(fixtures.jobs), () => jobsLifecycle(fixtures)),
79
+ check("lakeflow-authoring", fixtures.enabled && Boolean(fixtures.lakeflow), () => lakeflowLifecycle(fixtures)),
80
+ check("ai-search-admin", fixtures.enabled && Boolean(fixtures.aiSearch), () => aiSearchLifecycle(fixtures)),
81
+ check("serving-admin", fixtures.enabled && Boolean(fixtures.serving), () => servingLifecycle(fixtures)),
82
+ check("uc-admin-obo-execution", fixtures.enabled && fixtures.authMode === "on-behalf-of" && Boolean(fixtures.unityCatalog), () => unityCatalogLifecycle(fixtures)),
83
+ check("workspace-write", fixtures.enabled && Boolean(fixtures.workspace), () => workspaceLifecycle(fixtures)),
84
+ check("secrets-write", fixtures.enabled && Boolean(fixtures.secrets), () => secretsLifecycle(fixtures)),
85
+ check("genie-authoring", fixtures.enabled && Boolean(fixtures.genie), () => genieLifecycle(fixtures)),
86
+ ];
87
+ }
88
+ function check(id, configured, run) {
89
+ return {
90
+ id,
91
+ description: `Protected authoring lifecycle evidence for ${id}: create, verify, mutate, delete, approval consumption, lineage, and cleanup.`,
92
+ configured,
93
+ run: async () => ({ ...(await run()), evidenceChecks: authoringEvidenceChecks(id) }),
94
+ };
95
+ }
96
+ function authoringEvidenceChecks(id) {
97
+ const prefix = id === "jobs-authoring"
98
+ ? "jobs"
99
+ : id === "lakeflow-authoring"
100
+ ? "lakeflow"
101
+ : id === "ai-search-admin"
102
+ ? "ai-search-admin"
103
+ : id === "serving-admin"
104
+ ? "serving"
105
+ : id === "uc-admin-obo-execution"
106
+ ? "uc-admin"
107
+ : id === "workspace-write"
108
+ ? "workspace"
109
+ : id === "secrets-write"
110
+ ? "secrets"
111
+ : id === "genie-authoring"
112
+ ? "genie-authoring"
113
+ : undefined;
114
+ if (!prefix)
115
+ return ["approval.request", "approval.consume", "lineage.write"];
116
+ return [
117
+ `${prefix}.create`,
118
+ `${prefix}.verify`,
119
+ `${prefix}.mutate`,
120
+ `${prefix}.delete`,
121
+ ...(prefix === "uc-admin" ? ["uc-admin.obo-execution"] : []),
122
+ "approval.consume",
123
+ "lineage.write",
124
+ ];
125
+ }
126
+ async function approvalProvenance(fixtures) {
127
+ const runner = new GovernedCertificationRunner(fixtures);
128
+ const tool = {
129
+ name: "databricks_certification_approval_probe",
130
+ inputSchema: {
131
+ type: "object",
132
+ properties: { resource: { type: "string" } },
133
+ required: ["resource"],
134
+ },
135
+ metadata: {
136
+ effect: "write",
137
+ provider: "databricks",
138
+ service: "certification",
139
+ governance: { resources: [{ kind: "probe", path: "/resource" }] },
140
+ },
141
+ execute: (input) => input,
142
+ };
143
+ const result = await runner.execute(tool, { resource: "approval-provenance" });
144
+ if (result.resource !== "approval-provenance")
145
+ throw new Error("Approval probe returned the wrong resource.");
146
+ return runner.evidence();
147
+ }
148
+ async function jobsLifecycle(fixtures) {
149
+ const config = requiredFixture(fixtures.jobs, "jobs");
150
+ const runner = new GovernedCertificationRunner(fixtures);
151
+ const tools = databricksJobsAuthoringTools(fixtures.client, config.computePolicy);
152
+ const api = new DatabricksJobsAuthoring(fixtures.client, config.computePolicy);
153
+ let jobId = 0;
154
+ const lifecycle = await runDatabricksAuthoringLifecycle({
155
+ kind: "job",
156
+ create: async () => {
157
+ const created = await runner.execute(findTool(tools, "databricks_create_job"), config.spec);
158
+ jobId = created.jobId;
159
+ return created;
160
+ },
161
+ identify: (created) => String(created.jobId),
162
+ verifyCreated: async (created) => {
163
+ const row = await api.getJob(created.jobId);
164
+ if (!row.settings)
165
+ throw new Error("Created Databricks job was not readable.");
166
+ },
167
+ mutate: async (created) => {
168
+ const name = config.mutateName ?? `${config.spec.name}-verified`;
169
+ await runner.execute(findTool(tools, "databricks_update_job"), {
170
+ jobId: created.jobId,
171
+ set: { name },
172
+ });
173
+ return name;
174
+ },
175
+ verifyMutated: async (created, name) => {
176
+ const row = await api.getJob(created.jobId);
177
+ if (row.settings?.name !== name)
178
+ throw new Error("Databricks job mutation was not observable.");
179
+ },
180
+ delete: (created) => runner.execute(findTool(tools, "databricks_delete_job"), { jobId: created.jobId }),
181
+ verifyDeleted: () => expectNotFound(() => api.getJob(jobId)),
182
+ });
183
+ return runner.evidence(lifecycle);
184
+ }
185
+ async function lakeflowLifecycle(fixtures) {
186
+ const config = requiredFixture(fixtures.lakeflow, "lakeflow");
187
+ const runner = new GovernedCertificationRunner(fixtures);
188
+ const tools = databricksLakeflowAuthoringTools(fixtures.client);
189
+ const api = new DatabricksLakeflowAuthoring(fixtures.client);
190
+ const lifecycle = await runDatabricksAuthoringLifecycle({
191
+ kind: "pipeline",
192
+ create: () => runner.execute(findTool(tools, "databricks_create_pipeline"), config.spec),
193
+ identify: (created) => created.pipelineId,
194
+ verifyCreated: (created) => fixtures.client.get(`/api/2.0/pipelines/${encodeURIComponent(created.pipelineId)}`),
195
+ mutate: async (created) => {
196
+ const name = config.mutateName ?? `${config.spec.name}-verified`;
197
+ await runner.execute(findTool(tools, "databricks_update_pipeline"), {
198
+ pipelineId: created.pipelineId,
199
+ ...config.spec,
200
+ name,
201
+ });
202
+ return name;
203
+ },
204
+ verifyMutated: async (created, name) => {
205
+ const row = await fixtures.client.get(`/api/2.0/pipelines/${encodeURIComponent(created.pipelineId)}`);
206
+ if (row.spec?.name !== name && row.name !== name)
207
+ throw new Error("Lakeflow mutation was not observable.");
208
+ },
209
+ delete: (created) => runner.execute(findTool(tools, "databricks_delete_pipeline"), {
210
+ pipelineId: created.pipelineId,
211
+ }),
212
+ verifyDeleted: (created) => expectNotFound(() => fixtures.client.get(`/api/2.0/pipelines/${encodeURIComponent(created.pipelineId)}`)),
213
+ });
214
+ void api;
215
+ return runner.evidence(lifecycle);
216
+ }
217
+ async function aiSearchLifecycle(fixtures) {
218
+ const config = requiredFixture(fixtures.aiSearch, "aiSearch");
219
+ const runner = new GovernedCertificationRunner(fixtures);
220
+ const tools = databricksAiSearchAdminTools(fixtures.client);
221
+ const api = new DatabricksAiSearchAdmin(fixtures.client);
222
+ const lifecycle = await runDatabricksAuthoringLifecycle({
223
+ kind: "ai-search-endpoint",
224
+ create: async () => {
225
+ await runner.execute(findTool(tools, "databricks_create_search_endpoint"), {
226
+ name: config.endpointName,
227
+ endpointType: "STANDARD",
228
+ });
229
+ await api.waitForEndpoint(config.endpointName);
230
+ return { id: config.endpointName };
231
+ },
232
+ identify: (created) => created.id,
233
+ verifyCreated: () => api.getEndpoint(config.endpointName),
234
+ mutate: async () => {
235
+ await runner.execute(findTool(tools, "databricks_create_search_index"), config.index);
236
+ return config.index.name;
237
+ },
238
+ verifyMutated: (_created, indexName) => api.describeIndex(indexName),
239
+ delete: async () => {
240
+ await runner.execute(findTool(tools, "databricks_delete_search_index"), {
241
+ name: config.index.name,
242
+ });
243
+ await runner.execute(findTool(tools, "databricks_delete_search_endpoint"), {
244
+ name: config.endpointName,
245
+ });
246
+ },
247
+ verifyDeleted: () => expectNotFound(() => api.getEndpoint(config.endpointName)),
248
+ });
249
+ return runner.evidence(lifecycle);
250
+ }
251
+ async function servingLifecycle(fixtures) {
252
+ const config = requiredFixture(fixtures.serving, "serving");
253
+ const runner = new GovernedCertificationRunner(fixtures);
254
+ const tools = databricksServingAdminTools(fixtures.client);
255
+ const api = new DatabricksServingAdmin(fixtures.client);
256
+ const lifecycle = await runDatabricksAuthoringLifecycle({
257
+ kind: "serving-endpoint",
258
+ create: async () => {
259
+ await runner.execute(findTool(tools, "databricks_create_serving_endpoint"), config.spec);
260
+ await api.waitForEndpoint(config.spec.name);
261
+ return { id: config.spec.name };
262
+ },
263
+ identify: (created) => created.id,
264
+ verifyCreated: () => api.getEndpoint(config.spec.name),
265
+ mutate: async () => {
266
+ await runner.execute(findTool(tools, "databricks_update_serving_endpoint"), {
267
+ name: config.spec.name,
268
+ servedEntities: config.spec.servedEntities,
269
+ });
270
+ return api.waitForEndpoint(config.spec.name);
271
+ },
272
+ verifyMutated: () => api.getEndpoint(config.spec.name),
273
+ delete: () => runner.execute(findTool(tools, "databricks_delete_serving_endpoint"), {
274
+ name: config.spec.name,
275
+ }),
276
+ verifyDeleted: () => expectNotFound(() => api.getEndpoint(config.spec.name)),
277
+ });
278
+ return runner.evidence(lifecycle);
279
+ }
280
+ async function unityCatalogLifecycle(fixtures) {
281
+ const config = requiredFixture(fixtures.unityCatalog, "unityCatalog");
282
+ if (fixtures.executingPrincipal.ucPrincipal !== config.oboPrincipal) {
283
+ throw new Error("UC certification requires the executing OBO principal to match oboPrincipal.");
284
+ }
285
+ const currentUser = await fixtures.client.get("/api/2.0/preview/scim/v2/Me");
286
+ if (currentUser.userName !== config.oboPrincipal &&
287
+ currentUser.id !== fixtures.executingPrincipal.id) {
288
+ throw new Error("UC certification OBO token resolved to a different Databricks principal.");
289
+ }
290
+ const runner = new GovernedCertificationRunner(fixtures);
291
+ const tools = databricksUnityCatalogAdminTools(fixtures.client, { destructive: true });
292
+ const fullName = `${config.catalog}.${config.schemaName}`;
293
+ const lifecycle = await runDatabricksAuthoringLifecycle({
294
+ kind: "schema",
295
+ create: async () => {
296
+ await runner.execute(findTool(tools, "databricks_create_schema"), {
297
+ catalogName: config.catalog,
298
+ name: config.schemaName,
299
+ comment: "Fabric Harness protected lifecycle certification",
300
+ });
301
+ return { id: fullName };
302
+ },
303
+ identify: (created) => created.id,
304
+ verifyCreated: () => fixtures.client.get(`/api/2.1/unity-catalog/schemas/${encodeURIComponent(fullName)}`),
305
+ mutate: async () => {
306
+ await runner.execute(findTool(tools, "databricks_grant"), {
307
+ securableType: "schema",
308
+ fullName,
309
+ principal: config.oboPrincipal,
310
+ privileges: ["USE_SCHEMA"],
311
+ });
312
+ return "USE_SCHEMA";
313
+ },
314
+ verifyMutated: async () => {
315
+ const permissions = await fixtures.client.get(`/api/2.1/unity-catalog/permissions/schema/${encodeURIComponent(fullName)}`);
316
+ if (!JSON.stringify(permissions).includes(config.oboPrincipal))
317
+ throw new Error("UC grant was not observable for the OBO principal.");
318
+ },
319
+ delete: () => runner.execute(findTool(tools, "databricks_delete_uc_object"), { kind: "schema", fullName }),
320
+ verifyDeleted: () => expectNotFound(() => fixtures.client.get(`/api/2.1/unity-catalog/schemas/${encodeURIComponent(fullName)}`)),
321
+ });
322
+ return runner.evidence(lifecycle);
323
+ }
324
+ async function workspaceLifecycle(fixtures) {
325
+ const config = requiredFixture(fixtures.workspace, "workspace");
326
+ const runner = new GovernedCertificationRunner(fixtures);
327
+ const tools = databricksWorkspaceAuthoringTools(fixtures.client);
328
+ const root = config.rootPath.replace(/\/$/, "");
329
+ const notebook = `${root}/probe.py`;
330
+ const lifecycle = await runDatabricksAuthoringLifecycle({
331
+ kind: "workspace-directory",
332
+ create: async () => {
333
+ await runner.execute(findTool(tools, "databricks_workspace_mkdirs"), { path: root });
334
+ return { id: root };
335
+ },
336
+ identify: (created) => created.id,
337
+ verifyCreated: () => fixtures.client.get("/api/2.0/workspace/get-status", { path: root }),
338
+ mutate: () => runner.execute(findTool(tools, "databricks_import_notebook"), {
339
+ path: notebook,
340
+ content: "# Fabric Harness certification\n",
341
+ language: "PYTHON",
342
+ format: "SOURCE",
343
+ }),
344
+ verifyMutated: () => fixtures.client.get("/api/2.0/workspace/get-status", { path: notebook }),
345
+ delete: () => runner.execute(findTool(tools, "databricks_delete_workspace_object"), {
346
+ path: root,
347
+ recursive: true,
348
+ }),
349
+ verifyDeleted: () => expectNotFound(() => fixtures.client.get("/api/2.0/workspace/get-status", { path: root })),
350
+ });
351
+ return runner.evidence(lifecycle);
352
+ }
353
+ async function secretsLifecycle(fixtures) {
354
+ const config = requiredFixture(fixtures.secrets, "secrets");
355
+ const runner = new GovernedCertificationRunner(fixtures);
356
+ const tools = databricksSecretsAuthoringTools(fixtures.client, config.provider);
357
+ const lifecycle = await runDatabricksAuthoringLifecycle({
358
+ kind: "secret-scope",
359
+ create: async () => {
360
+ await runner.execute(findTool(tools, "databricks_create_secret_scope"), {
361
+ scope: config.scope,
362
+ });
363
+ return { id: config.scope };
364
+ },
365
+ identify: (created) => created.id,
366
+ verifyCreated: () => verifySecretScope(fixtures.client, config.scope),
367
+ mutate: () => runner.execute(findTool(tools, "databricks_put_secret"), {
368
+ scope: config.scope,
369
+ key: config.key,
370
+ secretRef: { kind: "secret", name: config.secretName },
371
+ }),
372
+ verifyMutated: async () => {
373
+ const keys = await fixtures.client.get("/api/2.0/secrets/list", { scope: config.scope });
374
+ if (!keys.secrets?.some((row) => row.key === config.key))
375
+ throw new Error("Written secret key was not listed.");
376
+ },
377
+ delete: () => runner.execute(findTool(tools, "databricks_delete_secret_scope"), { scope: config.scope }),
378
+ verifyDeleted: () => verifySecretScopeMissing(fixtures.client, config.scope),
379
+ });
380
+ return runner.evidence(lifecycle);
381
+ }
382
+ async function genieLifecycle(fixtures) {
383
+ const config = requiredFixture(fixtures.genie, "genie");
384
+ const runner = new GovernedCertificationRunner(fixtures);
385
+ const store = new MemoryDatabricksManagedResourceStore();
386
+ const tools = databricksGenieAuthoringTools(fixtures.client, {
387
+ managedResourceStore: store,
388
+ principal: fixtures.executingPrincipal.ucPrincipal ?? fixtures.executingPrincipal.id,
389
+ destructive: true,
390
+ ...(config.sqlPolicy ? { sqlPolicy: config.sqlPolicy } : {}),
391
+ });
392
+ const api = new DatabricksGenieAdmin(fixtures.client, { managedResourceStore: store });
393
+ let currentFingerprint = "";
394
+ const lifecycle = await runDatabricksAuthoringLifecycle({
395
+ kind: "genie-agent",
396
+ create: async () => {
397
+ const created = await runner.execute(findTool(tools, "databricks_create_genie_agent"), { spec: config.spec });
398
+ currentFingerprint = created.fingerprint;
399
+ return created;
400
+ },
401
+ identify: (created) => created.agentId,
402
+ verifyCreated: async (created) => {
403
+ const row = await api.get(created.agentId, { includeConfiguration: true });
404
+ if (!row.serializedSpace)
405
+ throw new Error("Created Genie Agent configuration was not readable.");
406
+ const managed = await store.get("genie-agent", created.agentId);
407
+ if (!managed)
408
+ throw new Error("Created Genie Agent had no managed-resource provenance.");
409
+ },
410
+ mutate: async (created) => {
411
+ const nextSpec = {
412
+ ...config.spec,
413
+ sampleQuestions: [
414
+ ...(config.spec.sampleQuestions ?? []),
415
+ { question: "Fabric Harness certification mutation" },
416
+ ],
417
+ };
418
+ const updated = await runner.execute(findTool(tools, "databricks_update_genie_agent"), {
419
+ agentId: created.agentId,
420
+ expectedFingerprint: currentFingerprint,
421
+ set: { spec: nextSpec },
422
+ });
423
+ currentFingerprint = updated.fingerprint;
424
+ return nextSpec;
425
+ },
426
+ verifyMutated: async (created) => {
427
+ const row = await api.get(created.agentId, { includeConfiguration: true });
428
+ if (!row.serializedSpace?.includes("Fabric Harness certification mutation"))
429
+ throw new Error("Genie Agent mutation was not observable.");
430
+ const answer = await databricksGenie(fixtures.client, { agentId: created.agentId }).ask({
431
+ question: config.question,
432
+ });
433
+ if (!answer.conversationId || !answer.messageId)
434
+ throw new Error("Genie Agent query did not return conversation provenance.");
435
+ },
436
+ delete: (created) => runner.execute(findTool(tools, "databricks_delete_genie_agent"), {
437
+ agentId: created.agentId,
438
+ expectedFingerprint: currentFingerprint,
439
+ }),
440
+ verifyDeleted: (created) => expectNotFound(() => api.get(created.agentId)),
441
+ });
442
+ return { ...runner.evidence(lifecycle), queryVerified: true };
443
+ }
444
+ function findTool(tools, name) {
445
+ const tool = tools.find((candidate) => candidate.name === name);
446
+ if (!tool)
447
+ throw new Error(`Databricks certification tool ${name} is unavailable.`);
448
+ return tool;
449
+ }
450
+ function requiredFixture(value, name) {
451
+ if (!value)
452
+ throw new Error(`Databricks authoring certification fixture ${name} is missing.`);
453
+ return value;
454
+ }
455
+ async function expectNotFound(operation) {
456
+ try {
457
+ await operation();
458
+ }
459
+ catch (error) {
460
+ if (/\b404\b|not[ _-]?found|does not exist|RESOURCE_DOES_NOT_EXIST|has been trashed/i.test(error instanceof Error ? error.message : String(error)))
461
+ return;
462
+ throw error;
463
+ }
464
+ throw new Error("Deleted Databricks resource is still readable.");
465
+ }
466
+ async function verifySecretScope(client, scope) {
467
+ const scopes = await client.get("/api/2.0/secrets/scopes/list");
468
+ if (!scopes.scopes?.some((row) => row.name === scope))
469
+ throw new Error("Created secret scope was not listed.");
470
+ }
471
+ async function verifySecretScopeMissing(client, scope) {
472
+ const scopes = await client.get("/api/2.0/secrets/scopes/list");
473
+ if (scopes.scopes?.some((row) => row.name === scope))
474
+ throw new Error("Deleted secret scope is still listed.");
475
+ }
476
+ //# sourceMappingURL=authoring-certification.js.map