@fabric-harness/databricks 2.0.0 → 3.0.2
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.
- package/README.md +37 -8
- package/dist/agent-services.d.ts +3 -3
- package/dist/agent-services.d.ts.map +1 -1
- package/dist/agent.js +56955 -132
- package/dist/agent.js.map +1 -1
- package/dist/ai-gateway.d.ts +3 -3
- package/dist/ai-gateway.d.ts.map +1 -1
- package/dist/ai-search-admin.d.ts +4 -3
- package/dist/ai-search-admin.d.ts.map +1 -1
- package/dist/ai.d.ts +2 -2
- package/dist/ai.d.ts.map +1 -1
- package/dist/app.d.ts +1 -3
- package/dist/app.d.ts.map +1 -1
- package/dist/artifact-digest.d.ts +6 -0
- package/dist/artifact-digest.d.ts.map +1 -0
- package/dist/authoring-certification.d.ts +18 -6
- package/dist/authoring-certification.d.ts.map +1 -1
- package/dist/certification-sweeper.d.ts +18 -2
- package/dist/certification-sweeper.d.ts.map +1 -1
- package/dist/certification.d.ts.map +1 -1
- package/dist/certify.js +59442 -942
- package/dist/certify.js.map +1 -1
- package/dist/client.d.ts +15 -18
- package/dist/client.d.ts.map +1 -1
- package/dist/compatibility.d.ts +6 -2
- package/dist/compatibility.d.ts.map +1 -1
- package/dist/consumption.d.ts +3 -3
- package/dist/consumption.d.ts.map +1 -1
- package/dist/cost-budget-actuals.d.ts +3 -4
- package/dist/cost-budget-actuals.d.ts.map +1 -1
- package/dist/embeddings.d.ts +5 -3
- package/dist/embeddings.d.ts.map +1 -1
- package/dist/feature-serving.d.ts +2 -2
- package/dist/feature-serving.d.ts.map +1 -1
- package/dist/genie-agent-mode.d.ts +3 -3
- package/dist/genie-agent-mode.d.ts.map +1 -1
- package/dist/genie-authoring.d.ts +12 -5
- package/dist/genie-authoring.d.ts.map +1 -1
- package/dist/genie.d.ts +13 -4
- package/dist/genie.d.ts.map +1 -1
- package/dist/identity.d.ts +7 -9
- package/dist/identity.d.ts.map +1 -1
- package/dist/index.d.ts +11 -7
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +61036 -356
- package/dist/index.js.map +1 -1
- package/dist/jobs-authoring.d.ts +5 -4
- package/dist/jobs-authoring.d.ts.map +1 -1
- package/dist/jobs.d.ts +4 -7
- package/dist/jobs.d.ts.map +1 -1
- package/dist/lakebase.d.ts +5 -10
- package/dist/lakebase.d.ts.map +1 -1
- package/dist/lakeflow-authoring.d.ts +7 -3
- package/dist/lakeflow-authoring.d.ts.map +1 -1
- package/dist/lakeflow.d.ts +7 -6
- package/dist/lakeflow.d.ts.map +1 -1
- package/dist/mlflow-tracing.d.ts +2 -2
- package/dist/mlflow-tracing.d.ts.map +1 -1
- package/dist/native-sdk.d.ts +70 -0
- package/dist/native-sdk.d.ts.map +1 -0
- package/dist/persistence.d.ts +1 -1
- package/dist/secrets-authoring.d.ts +4 -3
- package/dist/secrets-authoring.d.ts.map +1 -1
- package/dist/secrets.d.ts +5 -2
- package/dist/secrets.d.ts.map +1 -1
- package/dist/serving-admin.d.ts +6 -5
- package/dist/serving-admin.d.ts.map +1 -1
- package/dist/sql-exec.d.ts +3 -2
- package/dist/sql-exec.d.ts.map +1 -1
- package/dist/sql-sandbox.d.ts +6 -5
- package/dist/sql-sandbox.d.ts.map +1 -1
- package/dist/sql-sandbox.js +51952 -103
- package/dist/sql-sandbox.js.map +1 -1
- package/dist/tools.d.ts +16 -9
- package/dist/tools.d.ts.map +1 -1
- package/dist/unity-catalog-admin.d.ts +13 -4
- package/dist/unity-catalog-admin.d.ts.map +1 -1
- package/dist/vector-search.d.ts +3 -2
- package/dist/vector-search.d.ts.map +1 -1
- package/dist/volumes-attachment-store.d.ts +4 -16
- package/dist/volumes-attachment-store.d.ts.map +1 -1
- package/dist/workspace-authoring.d.ts +3 -3
- package/dist/workspace-authoring.d.ts.map +1 -1
- package/package.json +32 -9
- package/dist/agent-services.js +0 -142
- package/dist/agent-services.js.map +0 -1
- package/dist/ai-gateway.js +0 -51
- package/dist/ai-gateway.js.map +0 -1
- package/dist/ai-search-admin.js +0 -194
- package/dist/ai-search-admin.js.map +0 -1
- package/dist/ai.js +0 -22
- package/dist/ai.js.map +0 -1
- package/dist/app-user-authorization.js +0 -137
- package/dist/app-user-authorization.js.map +0 -1
- package/dist/app.js +0 -143
- package/dist/app.js.map +0 -1
- package/dist/authoring-certification.js +0 -476
- package/dist/authoring-certification.js.map +0 -1
- package/dist/capabilities.js +0 -639
- package/dist/capabilities.js.map +0 -1
- package/dist/certification-resource.js +0 -17
- package/dist/certification-resource.js.map +0 -1
- package/dist/certification-sweeper.js +0 -128
- package/dist/certification-sweeper.js.map +0 -1
- package/dist/certification.js +0 -236
- package/dist/certification.js.map +0 -1
- package/dist/client.js +0 -184
- package/dist/client.js.map +0 -1
- package/dist/compatibility.js +0 -88
- package/dist/compatibility.js.map +0 -1
- package/dist/consumption.js +0 -85
- package/dist/consumption.js.map +0 -1
- package/dist/cost-budget-actuals.js +0 -316
- package/dist/cost-budget-actuals.js.map +0 -1
- package/dist/embeddings.js +0 -24
- package/dist/embeddings.js.map +0 -1
- package/dist/feature-serving.js +0 -29
- package/dist/feature-serving.js.map +0 -1
- package/dist/genie-agent-mode.js +0 -374
- package/dist/genie-agent-mode.js.map +0 -1
- package/dist/genie-authoring.js +0 -898
- package/dist/genie-authoring.js.map +0 -1
- package/dist/genie.js +0 -401
- package/dist/genie.js.map +0 -1
- package/dist/governance.js +0 -353
- package/dist/governance.js.map +0 -1
- package/dist/identity.js +0 -229
- package/dist/identity.js.map +0 -1
- package/dist/jobs-authoring.js +0 -570
- package/dist/jobs-authoring.js.map +0 -1
- package/dist/jobs.js +0 -173
- package/dist/jobs.js.map +0 -1
- package/dist/lakebase.js +0 -110
- package/dist/lakebase.js.map +0 -1
- package/dist/lakeflow-authoring.js +0 -115
- package/dist/lakeflow-authoring.js.map +0 -1
- package/dist/lakeflow.js +0 -75
- package/dist/lakeflow.js.map +0 -1
- package/dist/managed-resource.js +0 -197
- package/dist/managed-resource.js.map +0 -1
- package/dist/mlflow-tracing.js +0 -167
- package/dist/mlflow-tracing.js.map +0 -1
- package/dist/mock-provider.js +0 -66
- package/dist/mock-provider.js.map +0 -1
- package/dist/model.js +0 -173
- package/dist/model.js.map +0 -1
- package/dist/persistence.js +0 -82
- package/dist/persistence.js.map +0 -1
- package/dist/rag-chain.js +0 -261
- package/dist/rag-chain.js.map +0 -1
- package/dist/rag-eval.js +0 -151
- package/dist/rag-eval.js.map +0 -1
- package/dist/secrets-authoring.js +0 -78
- package/dist/secrets-authoring.js.map +0 -1
- package/dist/secrets.js +0 -25
- package/dist/secrets.js.map +0 -1
- package/dist/serving-admin.js +0 -255
- package/dist/serving-admin.js.map +0 -1
- package/dist/serving-usage.js +0 -100
- package/dist/serving-usage.js.map +0 -1
- package/dist/sql-exec.js +0 -36
- package/dist/sql-exec.js.map +0 -1
- package/dist/telemetry-sink.js +0 -180
- package/dist/telemetry-sink.js.map +0 -1
- package/dist/tools.js +0 -167
- package/dist/tools.js.map +0 -1
- package/dist/unity-catalog-admin.js +0 -166
- package/dist/unity-catalog-admin.js.map +0 -1
- package/dist/vector-search.js +0 -63
- package/dist/vector-search.js.map +0 -1
- package/dist/volumes-attachment-store.js +0 -172
- package/dist/volumes-attachment-store.js.map +0 -1
- package/dist/workspace-authoring.js +0 -78
- package/dist/workspace-authoring.js.map +0 -1
package/dist/governance.js
DELETED
|
@@ -1,353 +0,0 @@
|
|
|
1
|
-
import { currentSubmissionContext, redactJson, sameApprovalOperation } from "@fabric-harness/sdk";
|
|
2
|
-
function metaString(tool, key) {
|
|
3
|
-
const value = tool.metadata?.[key];
|
|
4
|
-
return typeof value === "string" ? value : undefined;
|
|
5
|
-
}
|
|
6
|
-
function inputString(input, key) {
|
|
7
|
-
if (input && typeof input === "object" && key in input) {
|
|
8
|
-
const value = input[key];
|
|
9
|
-
if (typeof value === "string")
|
|
10
|
-
return value;
|
|
11
|
-
}
|
|
12
|
-
return undefined;
|
|
13
|
-
}
|
|
14
|
-
function governedObject(input) {
|
|
15
|
-
for (const key of [
|
|
16
|
-
"fullName",
|
|
17
|
-
"table",
|
|
18
|
-
"index",
|
|
19
|
-
"pipelineId",
|
|
20
|
-
"jobId",
|
|
21
|
-
"endpoint",
|
|
22
|
-
"notebookPath",
|
|
23
|
-
]) {
|
|
24
|
-
const value = inputString(input, key);
|
|
25
|
-
if (value)
|
|
26
|
-
return value;
|
|
27
|
-
}
|
|
28
|
-
const catalog = inputString(input, "catalog");
|
|
29
|
-
const schema = inputString(input, "schema");
|
|
30
|
-
return catalog ? [catalog, schema].filter(Boolean).join(".") : undefined;
|
|
31
|
-
}
|
|
32
|
-
function catalogFromInput(input) {
|
|
33
|
-
const explicit = inputString(input, "catalog");
|
|
34
|
-
if (explicit)
|
|
35
|
-
return explicit;
|
|
36
|
-
const object = governedObject(input);
|
|
37
|
-
return object?.includes(".") ? object.split(".")[0] : undefined;
|
|
38
|
-
}
|
|
39
|
-
export function governanceMetadata(tool) {
|
|
40
|
-
const value = tool.metadata?.governance;
|
|
41
|
-
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
42
|
-
return undefined;
|
|
43
|
-
const resources = value.resources;
|
|
44
|
-
if (!Array.isArray(resources))
|
|
45
|
-
return undefined;
|
|
46
|
-
return {
|
|
47
|
-
resources: resources.map((resource, index) => parseResourceDescriptor(resource, tool.name, index)),
|
|
48
|
-
...(value.secretFields !== undefined
|
|
49
|
-
? {
|
|
50
|
-
secretFields: parseStringArray(value.secretFields, `${tool.name} governance.secretFields`),
|
|
51
|
-
}
|
|
52
|
-
: {}),
|
|
53
|
-
};
|
|
54
|
-
}
|
|
55
|
-
/** Validate descriptor syntax and that each path can be traversed in the declared input schema. */
|
|
56
|
-
export function validateDatabricksGovernanceDescriptor(tool, required = false) {
|
|
57
|
-
const metadata = governanceMetadata(tool);
|
|
58
|
-
if (!metadata) {
|
|
59
|
-
if (required)
|
|
60
|
-
throw new Error(`databricks governance: authoring tool "${tool.name}" must declare metadata.governance.resources.`);
|
|
61
|
-
return;
|
|
62
|
-
}
|
|
63
|
-
if (metadata.resources.length === 0)
|
|
64
|
-
throw new Error(`databricks governance: tool "${tool.name}" declares no governed resources.`);
|
|
65
|
-
if (!tool.inputSchema || typeof tool.inputSchema !== "object")
|
|
66
|
-
throw new Error(`databricks governance: tool "${tool.name}" needs an inputSchema for resource validation.`);
|
|
67
|
-
for (const descriptor of metadata.resources)
|
|
68
|
-
validateSchemaPath(tool.name, tool.inputSchema, descriptor);
|
|
69
|
-
}
|
|
70
|
-
export function extractDatabricksGovernedResources(tool, input) {
|
|
71
|
-
const metadata = governanceMetadata(tool);
|
|
72
|
-
if (!metadata)
|
|
73
|
-
return legacyResources(input);
|
|
74
|
-
const resources = [];
|
|
75
|
-
for (const descriptor of metadata.resources) {
|
|
76
|
-
const values = pointerValues(input, descriptor.path);
|
|
77
|
-
if (values.length === 0 && !descriptor.optional) {
|
|
78
|
-
throw new Error(`databricks governance: required resource path "${descriptor.path}" matched no values for tool "${tool.name}".`);
|
|
79
|
-
}
|
|
80
|
-
for (const value of values) {
|
|
81
|
-
if (typeof value !== "string" && typeof value !== "number") {
|
|
82
|
-
throw new Error(`databricks governance: resource path "${descriptor.path}" on tool "${tool.name}" must resolve to strings or numbers.`);
|
|
83
|
-
}
|
|
84
|
-
const text = String(value);
|
|
85
|
-
if (!text)
|
|
86
|
-
throw new Error(`databricks governance: resource path "${descriptor.path}" on tool "${tool.name}" resolved to an empty value.`);
|
|
87
|
-
resources.push({
|
|
88
|
-
kind: descriptor.kind,
|
|
89
|
-
value: text,
|
|
90
|
-
path: descriptor.path,
|
|
91
|
-
...(descriptor.catalogQualified && (descriptor.kind === "catalog" || text.includes("."))
|
|
92
|
-
? { catalog: descriptor.kind === "catalog" ? text : text.split(".")[0] }
|
|
93
|
-
: {}),
|
|
94
|
-
});
|
|
95
|
-
}
|
|
96
|
-
}
|
|
97
|
-
return resources;
|
|
98
|
-
}
|
|
99
|
-
/** Wraps one Databricks tool to stamp lineage/audit and enforce the optional catalog allowlist. */
|
|
100
|
-
export function withGovernance(tool, options = {}) {
|
|
101
|
-
const inner = tool.execute;
|
|
102
|
-
if (!inner)
|
|
103
|
-
return tool;
|
|
104
|
-
validateDatabricksGovernanceDescriptor(tool);
|
|
105
|
-
const now = options.now ?? (() => new Date());
|
|
106
|
-
return {
|
|
107
|
-
...tool,
|
|
108
|
-
metadata: { ...(tool.metadata ?? {}), governed: true },
|
|
109
|
-
async execute(input, context) {
|
|
110
|
-
const resources = extractDatabricksGovernedResources(tool, input);
|
|
111
|
-
const catalogs = [
|
|
112
|
-
...new Set(resources.flatMap((resource) => (resource.catalog ? [resource.catalog] : []))),
|
|
113
|
-
];
|
|
114
|
-
const catalog = catalogs[0] ?? catalogFromInput(input);
|
|
115
|
-
const schema = inputString(input, "schema");
|
|
116
|
-
const object = governedObject(input);
|
|
117
|
-
const startedAt = now().toISOString();
|
|
118
|
-
const service = metaString(tool, "service");
|
|
119
|
-
const provider = metaString(tool, "provider");
|
|
120
|
-
const operation = metaString(tool, "effect");
|
|
121
|
-
// Correlate with the durable submission owning this turn (set by the
|
|
122
|
-
// submission runner); the acting principal falls back to the actor's
|
|
123
|
-
// governed identity when no explicit label was configured.
|
|
124
|
-
const submission = currentSubmissionContext();
|
|
125
|
-
const principal = options.principal ??
|
|
126
|
-
options.executingPrincipal?.ucPrincipal ??
|
|
127
|
-
options.executingPrincipal?.id ??
|
|
128
|
-
submission?.actor?.principal?.id;
|
|
129
|
-
const base = {
|
|
130
|
-
tool: tool.name,
|
|
131
|
-
...(service !== undefined ? { service } : {}),
|
|
132
|
-
...(provider !== undefined ? { provider } : {}),
|
|
133
|
-
...(principal !== undefined ? { principal } : {}),
|
|
134
|
-
...(submission
|
|
135
|
-
? {
|
|
136
|
-
submissionId: submission.submissionId,
|
|
137
|
-
attemptId: submission.attemptId,
|
|
138
|
-
...(submission.tenantId !== undefined ? { tenantId: submission.tenantId } : {}),
|
|
139
|
-
}
|
|
140
|
-
: {}),
|
|
141
|
-
...(catalog !== undefined ? { catalog } : {}),
|
|
142
|
-
...(schema !== undefined ? { schema } : {}),
|
|
143
|
-
...(object !== undefined ? { object } : {}),
|
|
144
|
-
...(resources.length > 0 ? { resources } : {}),
|
|
145
|
-
...(context?.approval?.approvers.length ? { approvers: context.approval.approvers } : {}),
|
|
146
|
-
...(operation !== undefined ? { operation } : {}),
|
|
147
|
-
// Redact secret-ish keys before the input enters the audit/lineage record.
|
|
148
|
-
input: redactToolInput(input, governanceMetadata(tool)?.secretFields),
|
|
149
|
-
startedAt,
|
|
150
|
-
};
|
|
151
|
-
const deniedCatalog = options.catalogs
|
|
152
|
-
? catalogs.find((candidate) => !options.catalogs?.includes(candidate))
|
|
153
|
-
: undefined;
|
|
154
|
-
if (options.catalogs && deniedCatalog) {
|
|
155
|
-
const error = `databricks governance: catalog "${deniedCatalog}" is not in the allowed list (${options.catalogs.join(", ")}).`;
|
|
156
|
-
options.onLineage?.({ ...base, finishedAt: now().toISOString(), ok: false, error });
|
|
157
|
-
throw new Error(error);
|
|
158
|
-
}
|
|
159
|
-
try {
|
|
160
|
-
if (service &&
|
|
161
|
-
(operation === "write" || operation === "execute") &&
|
|
162
|
-
(options.requireApprovalGrantFor?.includes(service) ||
|
|
163
|
-
options.requireApprovalGrantForTools?.includes(tool.name))) {
|
|
164
|
-
if (!options.executingPrincipal)
|
|
165
|
-
throw new Error(`databricks governance: service "${service}" requires a verified executing principal.`);
|
|
166
|
-
if (!context?.approval ||
|
|
167
|
-
!context.toolCallId ||
|
|
168
|
-
!sameApprovalOperation(context.approval, {
|
|
169
|
-
toolCallId: context.toolCallId,
|
|
170
|
-
toolInput: input,
|
|
171
|
-
principal: options.executingPrincipal,
|
|
172
|
-
})) {
|
|
173
|
-
throw new Error(`databricks governance: tool "${tool.name}" requires an ApprovalGrant bound to this call, input, and executing principal.`);
|
|
174
|
-
}
|
|
175
|
-
}
|
|
176
|
-
const result = await inner(input, context);
|
|
177
|
-
options.onLineage?.({ ...base, finishedAt: now().toISOString(), ok: true });
|
|
178
|
-
return result;
|
|
179
|
-
}
|
|
180
|
-
catch (error) {
|
|
181
|
-
options.onLineage?.({
|
|
182
|
-
...base,
|
|
183
|
-
finishedAt: now().toISOString(),
|
|
184
|
-
ok: false,
|
|
185
|
-
error: error instanceof Error ? error.message : String(error),
|
|
186
|
-
});
|
|
187
|
-
throw error;
|
|
188
|
-
}
|
|
189
|
-
},
|
|
190
|
-
};
|
|
191
|
-
}
|
|
192
|
-
function parseResourceDescriptor(value, toolName, index) {
|
|
193
|
-
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
194
|
-
throw new Error(`databricks governance: invalid resource descriptor ${index} on tool "${toolName}".`);
|
|
195
|
-
const row = value;
|
|
196
|
-
if (typeof row.kind !== "string" ||
|
|
197
|
-
!row.kind ||
|
|
198
|
-
typeof row.path !== "string" ||
|
|
199
|
-
!row.path.startsWith("/")) {
|
|
200
|
-
throw new Error(`databricks governance: descriptor ${index} on tool "${toolName}" requires kind and an absolute path.`);
|
|
201
|
-
}
|
|
202
|
-
return {
|
|
203
|
-
kind: row.kind,
|
|
204
|
-
path: row.path,
|
|
205
|
-
...(row.catalogQualified === true ? { catalogQualified: true } : {}),
|
|
206
|
-
...(row.optional === true ? { optional: true } : {}),
|
|
207
|
-
};
|
|
208
|
-
}
|
|
209
|
-
function parseStringArray(value, label) {
|
|
210
|
-
if (!Array.isArray(value) || value.some((item) => typeof item !== "string"))
|
|
211
|
-
throw new Error(`databricks governance: ${label} must be a string array.`);
|
|
212
|
-
return value;
|
|
213
|
-
}
|
|
214
|
-
function pointerSegments(path) {
|
|
215
|
-
return path
|
|
216
|
-
.slice(1)
|
|
217
|
-
.split("/")
|
|
218
|
-
.map((segment) => segment.replace(/~1/g, "/").replace(/~0/g, "~"));
|
|
219
|
-
}
|
|
220
|
-
function pointerValues(input, path) {
|
|
221
|
-
let current = [input];
|
|
222
|
-
for (const segment of pointerSegments(path)) {
|
|
223
|
-
current = current
|
|
224
|
-
.flatMap((value) => {
|
|
225
|
-
if (segment === "*")
|
|
226
|
-
return Array.isArray(value) ? value : [];
|
|
227
|
-
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
228
|
-
return [];
|
|
229
|
-
return segment in value ? [value[segment]] : [];
|
|
230
|
-
})
|
|
231
|
-
.filter((value) => value !== undefined && value !== null);
|
|
232
|
-
}
|
|
233
|
-
return current;
|
|
234
|
-
}
|
|
235
|
-
function validateSchemaPath(toolName, schema, descriptor) {
|
|
236
|
-
let current = [schema];
|
|
237
|
-
for (const segment of pointerSegments(descriptor.path)) {
|
|
238
|
-
const variants = current.flatMap(schemaVariants);
|
|
239
|
-
const next = [];
|
|
240
|
-
let missing = 0;
|
|
241
|
-
for (const variant of variants) {
|
|
242
|
-
if (segment === "*") {
|
|
243
|
-
const items = variant.items;
|
|
244
|
-
if (variant.type === "array" && items && typeof items === "object" && !Array.isArray(items))
|
|
245
|
-
next.push(items);
|
|
246
|
-
else
|
|
247
|
-
missing += 1;
|
|
248
|
-
continue;
|
|
249
|
-
}
|
|
250
|
-
const properties = variant.properties;
|
|
251
|
-
const child = properties && typeof properties === "object" && !Array.isArray(properties)
|
|
252
|
-
? properties[segment]
|
|
253
|
-
: undefined;
|
|
254
|
-
if (child && typeof child === "object" && !Array.isArray(child))
|
|
255
|
-
next.push(child);
|
|
256
|
-
else
|
|
257
|
-
missing += 1;
|
|
258
|
-
}
|
|
259
|
-
if (next.length === 0)
|
|
260
|
-
throw new Error(`databricks governance: path "${descriptor.path}" does not exist in inputSchema for tool "${toolName}".`);
|
|
261
|
-
if (!descriptor.optional && missing > 0)
|
|
262
|
-
throw new Error(`databricks governance: required path "${descriptor.path}" is not present in every inputSchema branch for tool "${toolName}". Mark the descriptor optional or make the schema branch mandatory.`);
|
|
263
|
-
current = next;
|
|
264
|
-
}
|
|
265
|
-
}
|
|
266
|
-
function schemaVariants(schema) {
|
|
267
|
-
const variants = Array.isArray(schema.oneOf)
|
|
268
|
-
? schema.oneOf
|
|
269
|
-
: Array.isArray(schema.anyOf)
|
|
270
|
-
? schema.anyOf
|
|
271
|
-
: undefined;
|
|
272
|
-
if (!variants)
|
|
273
|
-
return [schema];
|
|
274
|
-
return variants.filter((value) => Boolean(value) && typeof value === "object" && !Array.isArray(value));
|
|
275
|
-
}
|
|
276
|
-
function legacyResources(input) {
|
|
277
|
-
const value = governedObject(input);
|
|
278
|
-
if (!value)
|
|
279
|
-
return [];
|
|
280
|
-
const catalog = catalogFromInput(input);
|
|
281
|
-
return [{ kind: "object", value, path: "legacy-heuristic", ...(catalog ? { catalog } : {}) }];
|
|
282
|
-
}
|
|
283
|
-
function redactToolInput(input, secretFields) {
|
|
284
|
-
const clone = redactNamedFields((input ?? {}), new Set(secretFields ?? []));
|
|
285
|
-
return redactJson(clone);
|
|
286
|
-
}
|
|
287
|
-
function redactNamedFields(value, names) {
|
|
288
|
-
if (Array.isArray(value))
|
|
289
|
-
return value.map((item) => redactNamedFields(item, names));
|
|
290
|
-
if (!value || typeof value !== "object")
|
|
291
|
-
return value;
|
|
292
|
-
return Object.fromEntries(Object.entries(value).map(([key, child]) => [
|
|
293
|
-
key,
|
|
294
|
-
names.has(key) ? "[REDACTED]" : redactNamedFields(child, names),
|
|
295
|
-
]));
|
|
296
|
-
}
|
|
297
|
-
/** Wraps a set of Databricks tools with {@link withGovernance}. */
|
|
298
|
-
export function withGovernanceTools(tools, options = {}) {
|
|
299
|
-
return tools.map((tool) => withGovernance(tool, options));
|
|
300
|
-
}
|
|
301
|
-
function shouldGate(tool, services) {
|
|
302
|
-
const effect = tool.metadata?.effect;
|
|
303
|
-
if (effect !== "write" && effect !== "execute")
|
|
304
|
-
return false;
|
|
305
|
-
return !services || services.includes(metaString(tool, "service") ?? "");
|
|
306
|
-
}
|
|
307
|
-
/** Builds approval rules (one per gated tool) for `CapabilityPolicy.toolPolicy.approvalRules`. */
|
|
308
|
-
export function databricksApprovalRules(tools, options) {
|
|
309
|
-
return tools
|
|
310
|
-
.filter((tool) => shouldGate(tool, options.services))
|
|
311
|
-
.map((tool) => ({
|
|
312
|
-
pattern: tool.name,
|
|
313
|
-
audience: options.audience,
|
|
314
|
-
// ${name} is templated by the policy layer at request time — keep it literal here.
|
|
315
|
-
reason: options.reason ?? "Databricks ${name} requires data-steward approval.",
|
|
316
|
-
...(options.ttlSeconds !== undefined ? { ttlSeconds: options.ttlSeconds } : {}),
|
|
317
|
-
}));
|
|
318
|
-
}
|
|
319
|
-
function toHostPatterns(host) {
|
|
320
|
-
if (!host)
|
|
321
|
-
return [];
|
|
322
|
-
const list = Array.isArray(host) ? host : [host];
|
|
323
|
-
return list.map((entry) => {
|
|
324
|
-
try {
|
|
325
|
-
return new URL(entry.includes("://") ? entry : `https://${entry}`).host;
|
|
326
|
-
}
|
|
327
|
-
catch {
|
|
328
|
-
return entry;
|
|
329
|
-
}
|
|
330
|
-
});
|
|
331
|
-
}
|
|
332
|
-
/**
|
|
333
|
-
* Assembles a `CapabilityPolicy` for a Databricks tool set: approval routing for sensitive
|
|
334
|
-
* operations (if `stewardAudience` is set) plus an egress allowlist pinned to the workspace host(s).
|
|
335
|
-
* Used by the `databricks()` bundle; can also be merged into an agent's own policy.
|
|
336
|
-
*/
|
|
337
|
-
export function databricksGovernancePolicy(options) {
|
|
338
|
-
const policy = {};
|
|
339
|
-
if (options.stewardAudience) {
|
|
340
|
-
policy.toolPolicy = {
|
|
341
|
-
approvalRules: databricksApprovalRules(options.tools, {
|
|
342
|
-
audience: options.stewardAudience,
|
|
343
|
-
...(options.approvalServices ? { services: options.approvalServices } : {}),
|
|
344
|
-
...(options.ttlSeconds !== undefined ? { ttlSeconds: options.ttlSeconds } : {}),
|
|
345
|
-
}),
|
|
346
|
-
};
|
|
347
|
-
}
|
|
348
|
-
const hosts = toHostPatterns(options.host);
|
|
349
|
-
if (hosts.length > 0)
|
|
350
|
-
policy.network = { mode: "allowlist", hosts };
|
|
351
|
-
return policy;
|
|
352
|
-
}
|
|
353
|
-
//# sourceMappingURL=governance.js.map
|
package/dist/governance.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"governance.js","sourceRoot":"","sources":["../src/governance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAuFlG,SAAS,UAAU,CAAC,IAAa,EAAE,GAAW;IAC5C,MAAM,KAAK,GAAI,IAAI,CAAC,QAAgD,EAAE,CAAC,GAAG,CAAC,CAAC;IAC5E,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,SAAS,WAAW,CAAC,KAAc,EAAE,GAAW;IAC9C,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC;QACvD,MAAM,KAAK,GAAI,KAAiC,CAAC,GAAG,CAAC,CAAC;QACtD,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;IAC9C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,KAAK,MAAM,GAAG,IAAI;QAChB,UAAU;QACV,OAAO;QACP,OAAO;QACP,YAAY;QACZ,OAAO;QACP,UAAU;QACV,cAAc;KACf,EAAE,CAAC;QACF,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACtC,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IACD,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC5C,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC/C,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACrC,OAAO,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAa;IAC9C,MAAM,KAAK,GAAI,IAAI,CAAC,QAAgD,EAAE,UAAU,CAAC;IACjF,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAClF,MAAM,SAAS,GAAI,KAAiC,CAAC,SAAS,CAAC;IAC/D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAChD,OAAO;QACL,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,CAC3C,uBAAuB,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CACpD;QACD,GAAG,CAAE,KAAoC,CAAC,YAAY,KAAK,SAAS;YAClE,CAAC,CAAC;gBACE,YAAY,EAAE,gBAAgB,CAC3B,KAAoC,CAAC,YAAY,EAClD,GAAG,IAAI,CAAC,IAAI,0BAA0B,CACvC;aACF;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,sCAAsC,CAAC,IAAa,EAAE,QAAQ,GAAG,KAAK;IACpF,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,IAAI,QAAQ;YACV,MAAM,IAAI,KAAK,CACb,0CAA0C,IAAI,CAAC,IAAI,+CAA+C,CACnG,CAAC;QACJ,OAAO;IACT,CAAC;IACD,IAAI,QAAQ,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,CAAC,IAAI,mCAAmC,CAAC,CAAC;IAChG,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ;QAC3D,MAAM,IAAI,KAAK,CACb,gCAAgC,IAAI,CAAC,IAAI,iDAAiD,CAC3F,CAAC;IACJ,KAAK,MAAM,UAAU,IAAI,QAAQ,CAAC,SAAS;QACzC,kBAAkB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,WAAsC,EAAE,UAAU,CAAC,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,IAAa,EACb,KAAc;IAEd,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,QAAQ;QAAE,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAiC,EAAE,CAAC;IACnD,KAAK,MAAM,UAAU,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CACb,kDAAkD,UAAU,CAAC,IAAI,iCAAiC,IAAI,CAAC,IAAI,IAAI,CAChH,CAAC;QACJ,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC3D,MAAM,IAAI,KAAK,CACb,yCAAyC,UAAU,CAAC,IAAI,cAAc,IAAI,CAAC,IAAI,uCAAuC,CACvH,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC3B,IAAI,CAAC,IAAI;gBACP,MAAM,IAAI,KAAK,CACb,yCAAyC,UAAU,CAAC,IAAI,cAAc,IAAI,CAAC,IAAI,+BAA+B,CAC/G,CAAC;YACJ,SAAS,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,KAAK,EAAE,IAAI;gBACX,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,GAAG,CAAC,UAAU,CAAC,gBAAgB,IAAI,CAAC,UAAU,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;oBACtF,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE;oBACxE,CAAC,CAAC,EAAE,CAAC;aACR,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,cAAc,CAC5B,IAAmB,EACnB,UAAuC,EAAE;IAEzC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC;IAC3B,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,sCAAsC,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAE9C,OAAO;QACL,GAAG,IAAI;QACP,QAAQ,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE;QACtD,KAAK,CAAC,OAAO,CAAC,KAAQ,EAAE,OAAO;YAC7B,MAAM,SAAS,GAAG,kCAAkC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAClE,MAAM,QAAQ,GAAG;gBACf,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;aAC1F,CAAC;YACF,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,gBAAgB,CAAC,KAAK,CAAC,CAAC;YACvD,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;YAC5C,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;YACrC,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;YACtC,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC5C,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAC9C,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC7C,qEAAqE;YACrE,qEAAqE;YACrE,2DAA2D;YAC3D,MAAM,UAAU,GAAG,wBAAwB,EAAE,CAAC;YAC9C,MAAM,SAAS,GACb,OAAO,CAAC,SAAS;gBACjB,OAAO,CAAC,kBAAkB,EAAE,WAAW;gBACvC,OAAO,CAAC,kBAAkB,EAAE,EAAE;gBAC9B,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG;gBACX,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7C,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/C,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjD,GAAG,CAAC,UAAU;oBACZ,CAAC,CAAC;wBACE,YAAY,EAAE,UAAU,CAAC,YAAY;wBACrC,SAAS,EAAE,UAAU,CAAC,SAAS;wBAC/B,GAAG,CAAC,UAAU,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBAChF;oBACH,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7C,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3C,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3C,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9C,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzF,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjD,2EAA2E;gBAC3E,KAAK,EAAE,eAAe,CAAC,KAAK,EAAE,kBAAkB,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;gBACrE,SAAS;aACV,CAAC;YACF,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ;gBACpC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;gBACtE,CAAC,CAAC,SAAS,CAAC;YACd,IAAI,OAAO,CAAC,QAAQ,IAAI,aAAa,EAAE,CAAC;gBACtC,MAAM,KAAK,GAAG,mCAAmC,aAAa,iCAAiC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC/H,OAAO,CAAC,SAAS,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;gBACpF,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC;YACD,IAAI,CAAC;gBACH,IACE,OAAO;oBACP,CAAC,SAAS,KAAK,OAAO,IAAI,SAAS,KAAK,SAAS,CAAC;oBAClD,CAAC,OAAO,CAAC,uBAAuB,EAAE,QAAQ,CAAC,OAAO,CAAC;wBACjD,OAAO,CAAC,4BAA4B,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAC5D,CAAC;oBACD,IAAI,CAAC,OAAO,CAAC,kBAAkB;wBAC7B,MAAM,IAAI,KAAK,CACb,mCAAmC,OAAO,4CAA4C,CACvF,CAAC;oBACJ,IACE,CAAC,OAAO,EAAE,QAAQ;wBAClB,CAAC,OAAO,CAAC,UAAU;wBACnB,CAAC,qBAAqB,CAAC,OAAO,CAAC,QAAQ,EAAE;4BACvC,UAAU,EAAE,OAAO,CAAC,UAAU;4BAC9B,SAAS,EAAE,KAAK;4BAChB,SAAS,EAAE,OAAO,CAAC,kBAAkB;yBACtC,CAAC,EACF,CAAC;wBACD,MAAM,IAAI,KAAK,CACb,gCAAgC,IAAI,CAAC,IAAI,iFAAiF,CAC3H,CAAC;oBACJ,CAAC;gBACH,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBAC3C,OAAO,CAAC,SAAS,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC5E,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,SAAS,EAAE,CAAC;oBAClB,GAAG,IAAI;oBACP,UAAU,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;oBAC/B,EAAE,EAAE,KAAK;oBACT,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBAC9D,CAAC,CAAC;gBACH,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAC9B,KAAc,EACd,QAAgB,EAChB,KAAa;IAEb,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAC7D,MAAM,IAAI,KAAK,CACb,sDAAsD,KAAK,aAAa,QAAQ,IAAI,CACrF,CAAC;IACJ,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,IACE,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;QAC5B,CAAC,GAAG,CAAC,IAAI;QACT,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;QAC5B,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EACzB,CAAC;QACD,MAAM,IAAI,KAAK,CACb,qCAAqC,KAAK,aAAa,QAAQ,uCAAuC,CACvG,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,GAAG,CAAC,GAAG,CAAC,gBAAgB,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,GAAG,CAAC,GAAG,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrD,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc,EAAE,KAAa;IACrD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,0BAA0B,CAAC,CAAC;IAC7E,OAAO,KAAiB,CAAC;AAC3B,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,IAAI;SACR,KAAK,CAAC,CAAC,CAAC;SACR,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,aAAa,CAAC,KAAc,EAAE,IAAY;IACjD,IAAI,OAAO,GAAc,CAAC,KAAK,CAAC,CAAC;IACjC,KAAK,MAAM,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5C,OAAO,GAAG,OAAO;aACd,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACjB,IAAI,OAAO,KAAK,GAAG;gBAAE,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YAC3E,OAAO,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,CAAE,KAAiC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,kBAAkB,CACzB,QAAgB,EAChB,MAA+B,EAC/B,UAAkD;IAElD,IAAI,OAAO,GAA8B,CAAC,MAAM,CAAC,CAAC;IAClD,KAAK,MAAM,OAAO,IAAI,eAAe,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACjD,MAAM,IAAI,GAA8B,EAAE,CAAC;QAC3C,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;gBACpB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;gBAC5B,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;oBACzF,IAAI,CAAC,IAAI,CAAC,KAAgC,CAAC,CAAC;;oBACzC,OAAO,IAAI,CAAC,CAAC;gBAClB,SAAS;YACX,CAAC;YACD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;YACtC,MAAM,KAAK,GACT,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;gBACxE,CAAC,CAAE,UAAsC,CAAC,OAAO,CAAC;gBAClD,CAAC,CAAC,SAAS,CAAC;YAChB,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBAC7D,IAAI,CAAC,IAAI,CAAC,KAAgC,CAAC,CAAC;;gBACzC,OAAO,IAAI,CAAC,CAAC;QACpB,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YACnB,MAAM,IAAI,KAAK,CACb,gCAAgC,UAAU,CAAC,IAAI,6CAA6C,QAAQ,IAAI,CACzG,CAAC;QACJ,IAAI,CAAC,UAAU,CAAC,QAAQ,IAAI,OAAO,GAAG,CAAC;YACrC,MAAM,IAAI,KAAK,CACb,yCAAyC,UAAU,CAAC,IAAI,0DAA0D,QAAQ,sEAAsE,CACjM,CAAC;QACJ,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,MAA+B;IACrD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QAC1C,CAAC,CAAC,MAAM,CAAC,KAAK;QACd,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;YAC3B,CAAC,CAAC,MAAM,CAAC,KAAK;YACd,CAAC,CAAC,SAAS,CAAC;IAChB,IAAI,CAAC,QAAQ;QAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,OAAO,QAAQ,CAAC,MAAM,CACpB,CAAC,KAAK,EAAoC,EAAE,CAC1C,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CACvE,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AAChG,CAAC;AAED,SAAS,eAAe,CAAC,KAAc,EAAE,YAAkC;IACzE,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAC,KAAK,IAAI,EAAE,CAAc,EAAE,IAAI,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC;IACzF,OAAO,UAAU,CAAC,KAAmB,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAgB,EAAE,KAAkB;IAC7D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACrF,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;QAC1C,GAAG;QACH,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC;KAChE,CAAC,CACH,CAAC;AACJ,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,mBAAmB,CACjC,KAAgB,EAChB,UAAuC,EAAE;IAEzC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AAC5D,CAAC;AAWD,SAAS,UAAU,CAAC,IAAa,EAAE,QAAmB;IACpD,MAAM,MAAM,GAAI,IAAI,CAAC,QAAgD,EAAE,MAAM,CAAC;IAC9E,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7D,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;AAC3E,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,uBAAuB,CACrC,KAAgB,EAChB,OAAsC;IAEtC,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;SACpD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACd,OAAO,EAAE,IAAI,CAAC,IAAI;QAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,mFAAmF;QACnF,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,oDAAoD;QAC9E,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChF,CAAC,CAAC,CAAC;AACR,CAAC;AAYD,SAAS,cAAc,CAAC,IAAmC;IACzD,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACjD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACxB,IAAI,CAAC;YACH,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC;QAC1E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAA0C;IAE1C,MAAM,MAAM,GAAqB,EAAE,CAAC;IACpC,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;QAC5B,MAAM,CAAC,UAAU,GAAG;YAClB,aAAa,EAAE,uBAAuB,CAAC,OAAO,CAAC,KAAK,EAAE;gBACpD,QAAQ,EAAE,OAAO,CAAC,eAAe;gBACjC,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3E,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAChF,CAAC;SACH,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,OAAO,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IACpE,OAAO,MAAM,CAAC;AAChB,CAAC"}
|
package/dist/identity.js
DELETED
|
@@ -1,229 +0,0 @@
|
|
|
1
|
-
import { redactText } from "@fabric-harness/sdk";
|
|
2
|
-
import { databricksWorkspaceOrigin } from "./client.js";
|
|
3
|
-
/** Builds a cached, auto-refreshing token provider for a Databricks principal. */
|
|
4
|
-
export function databricksIdentity(principal) {
|
|
5
|
-
if (principal.kind === "pat") {
|
|
6
|
-
const { token } = principal;
|
|
7
|
-
return async () => token;
|
|
8
|
-
}
|
|
9
|
-
if (principal.kind === "on-behalf-of") {
|
|
10
|
-
const { userToken } = principal;
|
|
11
|
-
return async () => userToken();
|
|
12
|
-
}
|
|
13
|
-
if (principal.kind === "cli-profile")
|
|
14
|
-
return cliProfileProvider(principal);
|
|
15
|
-
return servicePrincipalProvider(principal);
|
|
16
|
-
}
|
|
17
|
-
/** Resolve a PAT or OAuth M2M principal consistently across CLIs, recipes, Apps, and tests. */
|
|
18
|
-
export function databricksPrincipalFromEnv(env = typeof process !== "undefined" ? process.env : {}, options = {}) {
|
|
19
|
-
const tokenName = options.tokenEnv ?? "DATABRICKS_TOKEN";
|
|
20
|
-
const clientIdName = options.clientIdEnv ?? "DATABRICKS_CLIENT_ID";
|
|
21
|
-
const clientSecretName = options.clientSecretEnv ?? "DATABRICKS_CLIENT_SECRET";
|
|
22
|
-
const hostName = options.hostEnv ?? "DATABRICKS_HOST";
|
|
23
|
-
const profileName = options.profileEnv ?? "DATABRICKS_CONFIG_PROFILE";
|
|
24
|
-
const token = env.DATABRICKS_BEARER?.trim() || env[tokenName]?.trim();
|
|
25
|
-
if (token)
|
|
26
|
-
return { kind: "pat", token };
|
|
27
|
-
const clientId = env[clientIdName]?.trim();
|
|
28
|
-
const clientSecret = env[clientSecretName]?.trim();
|
|
29
|
-
const rawHost = env[hostName]?.trim();
|
|
30
|
-
if (clientId && clientSecret) {
|
|
31
|
-
if (!rawHost)
|
|
32
|
-
throw new Error(`Missing ${hostName} for Databricks OAuth M2M.`);
|
|
33
|
-
return {
|
|
34
|
-
kind: "service-principal",
|
|
35
|
-
host: databricksWorkspaceOrigin(rawHost),
|
|
36
|
-
clientId,
|
|
37
|
-
clientSecret,
|
|
38
|
-
};
|
|
39
|
-
}
|
|
40
|
-
const profile = env[profileName]?.trim() || env.DATABRICKS_PROFILE?.trim();
|
|
41
|
-
if (rawHost && (profile || env.DATABRICKS_AUTH_MODE === "cli")) {
|
|
42
|
-
return {
|
|
43
|
-
kind: "cli-profile",
|
|
44
|
-
host: databricksWorkspaceOrigin(rawHost),
|
|
45
|
-
...(profile ? { profile } : {}),
|
|
46
|
-
};
|
|
47
|
-
}
|
|
48
|
-
throw new Error(`Set DATABRICKS_BEARER/${tokenName}, ${clientIdName} + ${clientSecretName}, or ${hostName} + ${profileName}.`);
|
|
49
|
-
}
|
|
50
|
-
function servicePrincipalProvider(principal) {
|
|
51
|
-
const host = databricksWorkspaceOrigin(principal.host);
|
|
52
|
-
const scope = principal.scope ?? "all-apis";
|
|
53
|
-
const skewMs = (principal.refreshSkewSeconds ?? 60) * 1000;
|
|
54
|
-
const fetchImpl = principal.fetchImpl ?? fetch;
|
|
55
|
-
const basic = base64(`${principal.clientId}:${principal.clientSecret}`);
|
|
56
|
-
let cached;
|
|
57
|
-
let inflight;
|
|
58
|
-
const refresh = async () => {
|
|
59
|
-
const response = await fetchImpl(`${host}/oidc/v1/token`, {
|
|
60
|
-
method: "POST",
|
|
61
|
-
headers: {
|
|
62
|
-
authorization: `Basic ${basic}`,
|
|
63
|
-
"content-type": "application/x-www-form-urlencoded",
|
|
64
|
-
},
|
|
65
|
-
body: `grant_type=client_credentials&scope=${encodeURIComponent(scope)}`,
|
|
66
|
-
});
|
|
67
|
-
if (!response.ok) {
|
|
68
|
-
const text = redactText(await response.text(), {
|
|
69
|
-
additionalSecrets: [principal.clientSecret],
|
|
70
|
-
});
|
|
71
|
-
throw new Error(`databricks oauth: ${response.status} ${response.statusText}: ${text.slice(0, 500)}`);
|
|
72
|
-
}
|
|
73
|
-
const json = (await response.json());
|
|
74
|
-
if (!json.access_token)
|
|
75
|
-
throw new Error("databricks oauth: response missing access_token.");
|
|
76
|
-
const ttlMs = (json.expires_in ?? 3600) * 1000;
|
|
77
|
-
cached = { token: json.access_token, refreshAtMs: Date.now() + Math.max(0, ttlMs - skewMs) };
|
|
78
|
-
return json.access_token;
|
|
79
|
-
};
|
|
80
|
-
return async () => {
|
|
81
|
-
if (cached && Date.now() < cached.refreshAtMs)
|
|
82
|
-
return cached.token;
|
|
83
|
-
// Dedupe concurrent refreshes so a burst of requests triggers a single token exchange.
|
|
84
|
-
if (!inflight)
|
|
85
|
-
inflight = refresh().finally(() => {
|
|
86
|
-
inflight = undefined;
|
|
87
|
-
});
|
|
88
|
-
return inflight;
|
|
89
|
-
};
|
|
90
|
-
}
|
|
91
|
-
function cliProfileProvider(principal) {
|
|
92
|
-
const host = databricksWorkspaceOrigin(principal.host);
|
|
93
|
-
const refreshMs = (principal.refreshIntervalSeconds ?? 1800) * 1000;
|
|
94
|
-
const runner = principal.runner ?? runDatabricksCli;
|
|
95
|
-
let cached;
|
|
96
|
-
let inflight;
|
|
97
|
-
const tokenArgs = (forceRefresh) => [
|
|
98
|
-
"auth",
|
|
99
|
-
"token",
|
|
100
|
-
"--host",
|
|
101
|
-
host,
|
|
102
|
-
...(principal.profile ? ["--profile", principal.profile] : []),
|
|
103
|
-
"--output",
|
|
104
|
-
"json",
|
|
105
|
-
...(forceRefresh ? ["--force-refresh"] : []),
|
|
106
|
-
];
|
|
107
|
-
const env = {
|
|
108
|
-
...(typeof process !== "undefined" ? process.env : {}),
|
|
109
|
-
DATABRICKS_HOST: host,
|
|
110
|
-
...(principal.profile ? { DATABRICKS_CONFIG_PROFILE: principal.profile } : {}),
|
|
111
|
-
};
|
|
112
|
-
const fetchToken = async (forceRefresh) => {
|
|
113
|
-
let output;
|
|
114
|
-
try {
|
|
115
|
-
output = await runner(tokenArgs(forceRefresh), env);
|
|
116
|
-
}
|
|
117
|
-
catch {
|
|
118
|
-
await runner([
|
|
119
|
-
"auth",
|
|
120
|
-
"login",
|
|
121
|
-
"--host",
|
|
122
|
-
host,
|
|
123
|
-
...(principal.profile ? ["--profile", principal.profile] : []),
|
|
124
|
-
"--no-browser",
|
|
125
|
-
], env);
|
|
126
|
-
output = await runner(tokenArgs(forceRefresh), env);
|
|
127
|
-
}
|
|
128
|
-
const parsed = JSON.parse(output);
|
|
129
|
-
if (!parsed.access_token)
|
|
130
|
-
throw new Error("databricks cli: response missing access_token.");
|
|
131
|
-
cached = { token: parsed.access_token, refreshAtMs: Date.now() + refreshMs };
|
|
132
|
-
return parsed.access_token;
|
|
133
|
-
};
|
|
134
|
-
return async () => {
|
|
135
|
-
if (cached && Date.now() < cached.refreshAtMs)
|
|
136
|
-
return cached.token;
|
|
137
|
-
if (!inflight) {
|
|
138
|
-
inflight = fetchToken(Boolean(cached)).finally(() => {
|
|
139
|
-
inflight = undefined;
|
|
140
|
-
});
|
|
141
|
-
}
|
|
142
|
-
return inflight;
|
|
143
|
-
};
|
|
144
|
-
}
|
|
145
|
-
async function runDatabricksCli(args, env) {
|
|
146
|
-
const { execFile } = await import("node:child_process");
|
|
147
|
-
return new Promise((resolve, reject) => {
|
|
148
|
-
execFile("databricks", args, { timeout: 30_000, maxBuffer: 1024 * 1024, env: env }, (error, stdout, stderr) => {
|
|
149
|
-
if (!error)
|
|
150
|
-
return resolve(stdout);
|
|
151
|
-
reject(new Error(`databricks cli: ${redactText(stderr || error.message).slice(0, 500)}`));
|
|
152
|
-
});
|
|
153
|
-
});
|
|
154
|
-
}
|
|
155
|
-
function base64(value) {
|
|
156
|
-
if (typeof Buffer !== "undefined")
|
|
157
|
-
return Buffer.from(value, "utf8").toString("base64");
|
|
158
|
-
return btoa(value);
|
|
159
|
-
}
|
|
160
|
-
// ─── Identity propagation (v2, workstream C3) ───────────────────────────────
|
|
161
|
-
/**
|
|
162
|
-
* The service principal a Databricks App runs as, from the standard app
|
|
163
|
-
* runtime environment (`DATABRICKS_HOST` / `DATABRICKS_CLIENT_ID` /
|
|
164
|
-
* `DATABRICKS_CLIENT_SECRET`). Returns `undefined` when any variable is
|
|
165
|
-
* missing, so callers can fall back to explicit configuration.
|
|
166
|
-
*/
|
|
167
|
-
export function appServicePrincipalFromEnv(env = typeof process !== "undefined" ? process.env : {}) {
|
|
168
|
-
const host = env.DATABRICKS_HOST;
|
|
169
|
-
const clientId = env.DATABRICKS_CLIENT_ID;
|
|
170
|
-
const clientSecret = env.DATABRICKS_CLIENT_SECRET;
|
|
171
|
-
if (!host || !clientId || !clientSecret)
|
|
172
|
-
return undefined;
|
|
173
|
-
return {
|
|
174
|
-
kind: "service-principal",
|
|
175
|
-
host: databricksWorkspaceOrigin(host),
|
|
176
|
-
clientId,
|
|
177
|
-
clientSecret,
|
|
178
|
-
};
|
|
179
|
-
}
|
|
180
|
-
/**
|
|
181
|
-
* On-behalf-of principal from Databricks Apps user-authorization headers:
|
|
182
|
-
* the platform forwards the signed-in user's access token as
|
|
183
|
-
* `x-forwarded-access-token` (plus `x-forwarded-email`/`x-forwarded-user`).
|
|
184
|
-
* Returns `undefined` when the request carries no user token (e.g. app
|
|
185
|
-
* service-to-service traffic) so callers fall back to the app principal.
|
|
186
|
-
*/
|
|
187
|
-
export function onBehalfOfFromHeaders(headers) {
|
|
188
|
-
const read = (name) => {
|
|
189
|
-
if (typeof headers.get === "function")
|
|
190
|
-
return headers.get(name) ?? undefined;
|
|
191
|
-
const value = headers[name];
|
|
192
|
-
return Array.isArray(value) ? value[0] : value;
|
|
193
|
-
};
|
|
194
|
-
const token = read("x-forwarded-access-token");
|
|
195
|
-
if (!token)
|
|
196
|
-
return undefined;
|
|
197
|
-
const label = read("x-forwarded-email") ?? read("x-forwarded-user");
|
|
198
|
-
return { kind: "on-behalf-of", userToken: () => token, ...(label ? { label } : {}) };
|
|
199
|
-
}
|
|
200
|
-
/**
|
|
201
|
-
* Map a Databricks principal onto the SDK's {@link FabricPrincipal} so the
|
|
202
|
-
* governed identity rides submissions → tool calls → lineage/cost records.
|
|
203
|
-
* Never carries a token — ids and labels only.
|
|
204
|
-
*/
|
|
205
|
-
export function fabricPrincipalFor(principal, overrides = {}) {
|
|
206
|
-
if (principal.kind === "service-principal") {
|
|
207
|
-
const id = overrides.id ?? principal.clientId;
|
|
208
|
-
return {
|
|
209
|
-
kind: overrides.asAppPrincipal ? "app-principal" : "service-principal",
|
|
210
|
-
id,
|
|
211
|
-
ucPrincipal: overrides.ucPrincipal ?? id,
|
|
212
|
-
...(overrides.displayName ? { displayName: overrides.displayName } : {}),
|
|
213
|
-
};
|
|
214
|
-
}
|
|
215
|
-
const id = overrides.id ??
|
|
216
|
-
(principal.kind === "cli-profile" ? principal.profile : principal.label) ??
|
|
217
|
-
(principal.kind === "pat"
|
|
218
|
-
? "pat-user"
|
|
219
|
-
: principal.kind === "cli-profile"
|
|
220
|
-
? "databricks-cli-user"
|
|
221
|
-
: "on-behalf-of-user");
|
|
222
|
-
return {
|
|
223
|
-
kind: "user",
|
|
224
|
-
id,
|
|
225
|
-
...(overrides.ucPrincipal ? { ucPrincipal: overrides.ucPrincipal } : {}),
|
|
226
|
-
...(overrides.displayName ? { displayName: overrides.displayName } : {}),
|
|
227
|
-
};
|
|
228
|
-
}
|
|
229
|
-
//# sourceMappingURL=identity.js.map
|
package/dist/identity.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"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"}
|