@fabric-harness/databricks 4.4.0 → 4.6.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 (113) hide show
  1. package/README.md +12 -0
  2. package/dist/agent-services.js +142 -0
  3. package/dist/agent-services.js.map +1 -0
  4. package/dist/agent.d.ts +2 -0
  5. package/dist/agent.d.ts.map +1 -1
  6. package/dist/agent.js +839 -362
  7. package/dist/agent.js.map +1 -1
  8. package/dist/ai-gateway.js +51 -0
  9. package/dist/ai-gateway.js.map +1 -0
  10. package/dist/ai-search-admin.js +194 -0
  11. package/dist/ai-search-admin.js.map +1 -0
  12. package/dist/ai.js +22 -0
  13. package/dist/ai.js.map +1 -0
  14. package/dist/app-user-authorization.d.ts.map +1 -1
  15. package/dist/app-user-authorization.js +4 -3
  16. package/dist/app-user-authorization.js.map +1 -1
  17. package/dist/app.js +143 -0
  18. package/dist/app.js.map +1 -0
  19. package/dist/authoring-certification.js +476 -0
  20. package/dist/authoring-certification.js.map +1 -0
  21. package/dist/capabilities.d.ts.map +1 -1
  22. package/dist/capabilities.js +633 -0
  23. package/dist/capabilities.js.map +1 -0
  24. package/dist/certification-environment.d.ts.map +1 -1
  25. package/dist/certification-resource.js +17 -0
  26. package/dist/certification-resource.js.map +1 -0
  27. package/dist/certification-sweeper.js +128 -0
  28. package/dist/certification-sweeper.js.map +1 -0
  29. package/dist/certification.js +236 -0
  30. package/dist/certification.js.map +1 -0
  31. package/dist/certify.js +34 -0
  32. package/dist/certify.js.map +1 -1
  33. package/dist/client.d.ts +58 -0
  34. package/dist/client.d.ts.map +1 -0
  35. package/dist/client.js +184 -0
  36. package/dist/client.js.map +1 -0
  37. package/dist/compatibility.js +88 -0
  38. package/dist/compatibility.js.map +1 -0
  39. package/dist/consumption.js +85 -0
  40. package/dist/consumption.js.map +1 -0
  41. package/dist/cost-budget-actuals.js +316 -0
  42. package/dist/cost-budget-actuals.js.map +1 -0
  43. package/dist/embeddings.js +24 -0
  44. package/dist/embeddings.js.map +1 -0
  45. package/dist/feature-serving.js +29 -0
  46. package/dist/feature-serving.js.map +1 -0
  47. package/dist/genie-agent-mode.js +374 -0
  48. package/dist/genie-agent-mode.js.map +1 -0
  49. package/dist/genie-authoring.js +898 -0
  50. package/dist/genie-authoring.js.map +1 -0
  51. package/dist/genie.js +405 -0
  52. package/dist/genie.js.map +1 -0
  53. package/dist/governance.js +353 -0
  54. package/dist/governance.js.map +1 -0
  55. package/dist/identity.js +229 -0
  56. package/dist/identity.js.map +1 -0
  57. package/dist/index.d.ts +4 -2
  58. package/dist/index.d.ts.map +1 -1
  59. package/dist/index.js +364 -22
  60. package/dist/index.js.map +1 -1
  61. package/dist/jobs-authoring.js +570 -0
  62. package/dist/jobs-authoring.js.map +1 -0
  63. package/dist/jobs.js +173 -0
  64. package/dist/jobs.js.map +1 -0
  65. package/dist/lakebase.js +110 -0
  66. package/dist/lakebase.js.map +1 -0
  67. package/dist/lakeflow-authoring.js +115 -0
  68. package/dist/lakeflow-authoring.js.map +1 -0
  69. package/dist/lakeflow.js +75 -0
  70. package/dist/lakeflow.js.map +1 -0
  71. package/dist/managed-resource.js +197 -0
  72. package/dist/managed-resource.js.map +1 -0
  73. package/dist/mlflow-tracing.js +167 -0
  74. package/dist/mlflow-tracing.js.map +1 -0
  75. package/dist/mock-provider.js +66 -0
  76. package/dist/mock-provider.js.map +1 -0
  77. package/dist/model.js +173 -0
  78. package/dist/model.js.map +1 -0
  79. package/dist/persistence.js +82 -0
  80. package/dist/persistence.js.map +1 -0
  81. package/dist/platform.d.ts +34 -0
  82. package/dist/platform.d.ts.map +1 -0
  83. package/dist/platform.js +90 -0
  84. package/dist/platform.js.map +1 -0
  85. package/dist/rag-chain.js +212 -0
  86. package/dist/rag-chain.js.map +1 -0
  87. package/dist/rag-eval.js +151 -0
  88. package/dist/rag-eval.js.map +1 -0
  89. package/dist/release-evidence.d.ts +66 -0
  90. package/dist/release-evidence.d.ts.map +1 -1
  91. package/dist/secrets-authoring.js +78 -0
  92. package/dist/secrets-authoring.js.map +1 -0
  93. package/dist/secrets.js +25 -0
  94. package/dist/secrets.js.map +1 -0
  95. package/dist/serving-admin.js +255 -0
  96. package/dist/serving-admin.js.map +1 -0
  97. package/dist/serving-usage.js +100 -0
  98. package/dist/serving-usage.js.map +1 -0
  99. package/dist/sql-exec.js +36 -0
  100. package/dist/sql-exec.js.map +1 -0
  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 +12 -3
@@ -25,6 +25,19 @@ export interface DatabricksAppRecoveryEvidence {
25
25
  attachments?: number;
26
26
  };
27
27
  }
28
+ export interface DatabricksAppUserIsolationEvidence {
29
+ schemaVersion: number;
30
+ target: string;
31
+ generatedAt?: string;
32
+ principalsDistinct?: boolean;
33
+ ownerCanList?: boolean;
34
+ ownerCanRead?: boolean;
35
+ otherCannotList?: boolean;
36
+ otherDirectReadStatus?: number;
37
+ secretsAbsentFromResponses?: boolean;
38
+ principalIdentifiersRetained?: boolean;
39
+ runIdHash?: string;
40
+ }
28
41
  export interface ValidateDatabricksReleaseEvidenceOptions {
29
42
  evidence: DatabricksCertificationEvidence;
30
43
  expectedPackageVersion: string;
@@ -41,10 +54,63 @@ export interface DatabricksReleaseEvidenceValidation {
41
54
  packageVersion: string;
42
55
  requiredChecks: readonly string[];
43
56
  }
57
+ export interface ValidateDatabricksCrossTierEvidenceOptions {
58
+ consumption: DatabricksCertificationEvidence;
59
+ authoring: DatabricksCertificationEvidence;
60
+ expectedPackageVersion?: string;
61
+ expectedCommitSha?: string;
62
+ expectedPackageArtifactSha256?: string;
63
+ maxAgeMs?: number;
64
+ now?: Date;
65
+ }
66
+ export interface DatabricksCrossTierEvidenceManifest {
67
+ schemaVersion: 1;
68
+ valid: true;
69
+ generatedAt: string;
70
+ packageVersion: string;
71
+ commitSha: string;
72
+ packageArtifactSha256: string;
73
+ consumption: {
74
+ evidenceId: string;
75
+ generatedAt: string;
76
+ };
77
+ authoring: {
78
+ evidenceId: string;
79
+ generatedAt: string;
80
+ };
81
+ }
82
+ export interface ValidateDatabricksRollingEvidenceOptions {
83
+ consumption: readonly DatabricksCertificationEvidence[];
84
+ crossTier: readonly DatabricksCrossTierEvidenceManifest[];
85
+ requiredDays?: number;
86
+ now?: Date;
87
+ }
88
+ export interface DatabricksRollingEvidenceReport {
89
+ schemaVersion: 1;
90
+ valid: true;
91
+ generatedAt: string;
92
+ windowStart: string;
93
+ windowEnd: string;
94
+ requiredDays: number;
95
+ consumptionDates: string[];
96
+ crossTierDates: string[];
97
+ packageVersions: string[];
98
+ }
99
+ /**
100
+ * Fail closed unless Tier R and Tier A exercised the same immutable package tarball and commit.
101
+ */
102
+ export declare function validateDatabricksCrossTierEvidence(options: ValidateDatabricksCrossTierEvidenceOptions): DatabricksCrossTierEvidenceManifest;
103
+ /**
104
+ * Require daily Tier R evidence plus at least two same-candidate Tier R/A proofs in the rolling
105
+ * public-claim window. Every Tier R record must bind two-user App isolation.
106
+ */
107
+ export declare function validateDatabricksRollingEvidence(options: ValidateDatabricksRollingEvidenceOptions): DatabricksRollingEvidenceReport;
44
108
  /**
45
109
  * Fail closed unless retained Databricks evidence proves the exact release commit and artifacts.
46
110
  */
47
111
  export declare function validateDatabricksReleaseEvidence(options: ValidateDatabricksReleaseEvidenceOptions): DatabricksReleaseEvidenceValidation;
48
112
  /** Assert that App restart evidence proves durable state, approval recovery, and cascade cleanup. */
49
113
  export declare function validateDatabricksAppRecoveryEvidence(evidence: DatabricksAppRecoveryEvidence): void;
114
+ /** Assert that retained App evidence proves distinct principals and cross-user denial. */
115
+ export declare function validateDatabricksAppUserIsolationEvidence(evidence: DatabricksAppUserIsolationEvidence): void;
50
116
  //# sourceMappingURL=release-evidence.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"release-evidence.d.ts","sourceRoot":"","sources":["../src/release-evidence.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,6BAA6B;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE;QAChB,IAAI,CAAC,EAAE,0BAA0B,CAAC;QAClC,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,uBAAuB,CAAC,EAAE,OAAO,CAAC;QAClC,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC;IACF,gBAAgB,CAAC,EAAE;QACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,sBAAsB,CAAC,EAAE,OAAO,CAAC;KAClC,CAAC;IACF,eAAe,CAAC,EAAE;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,wCAAwC;IACvD,QAAQ,EAAE,+BAA+B,CAAC;IAC1C,sBAAsB,EAAE,MAAM,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,6BAA6B,EAAE,MAAM,CAAC;IACtC,yBAAyB,EAAE,MAAM,CAAC;IAClC,6BAA6B,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,mCAAmC;IAClD,KAAK,EAAE,IAAI,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,wCAAwC,GAChD,mCAAmC,CAkFrC;AAED,qGAAqG;AACrG,wBAAgB,qCAAqC,CACnD,QAAQ,EAAE,6BAA6B,GACtC,IAAI,CAmCN"}
1
+ {"version":3,"file":"release-evidence.d.ts","sourceRoot":"","sources":["../src/release-evidence.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,78 @@
1
+ export class DatabricksSecretsAuthoring {
2
+ client;
3
+ constructor(client) {
4
+ this.client = client;
5
+ }
6
+ createScope(scope, initialManagePrincipal) {
7
+ return this.client.post("/api/2.0/secrets/scopes/create", {
8
+ scope,
9
+ ...(initialManagePrincipal ? { initial_manage_principal: initialManagePrincipal } : {}),
10
+ }, {}, { retry: "never" });
11
+ }
12
+ deleteScope(scope) {
13
+ return this.client.post("/api/2.0/secrets/scopes/delete", { scope }, {}, { retry: "safe" });
14
+ }
15
+ putRawSecret(scope, key, value) {
16
+ return this.client.post("/api/2.0/secrets/put", { scope, key, string_value: value }, {}, { retry: "safe" });
17
+ }
18
+ async putSecret(scope, key, secretRef, provider) {
19
+ const value = await provider.resolve(secretRef);
20
+ if (value === undefined)
21
+ throw new Error(`databricks secrets: provider "${provider.name}" could not resolve ${secretRef.name}.`);
22
+ return this.putRawSecret(scope, key, value);
23
+ }
24
+ }
25
+ export function databricksSecretsAuthoringTools(client, provider) {
26
+ const api = new DatabricksSecretsAuthoring(client);
27
+ return [
28
+ tool("databricks_create_secret_scope", scopeSchema(true), [{ kind: "secret-scope", path: "/scope" }], (i) => api.createScope(i.scope, i.initialManagePrincipal)),
29
+ tool("databricks_delete_secret_scope", scopeSchema(false), [{ kind: "secret-scope", path: "/scope" }], (i) => api.deleteScope(i.scope)),
30
+ tool("databricks_put_secret", putSchema(), [
31
+ { kind: "secret-scope", path: "/scope" },
32
+ { kind: "secret-key", path: "/key" },
33
+ ], (i) => api.putSecret(i.scope, i.key, i.secretRef, provider)),
34
+ ];
35
+ }
36
+ function tool(name, inputSchema, resources, execute) {
37
+ return {
38
+ name,
39
+ description: name.replaceAll("_", " "),
40
+ inputSchema,
41
+ metadata: {
42
+ effect: "write",
43
+ provider: "databricks",
44
+ service: "secrets",
45
+ governance: { resources, secretFields: ["secretRef"] },
46
+ },
47
+ execute,
48
+ };
49
+ }
50
+ function scopeSchema(create) {
51
+ return {
52
+ type: "object",
53
+ additionalProperties: false,
54
+ properties: {
55
+ scope: { type: "string" },
56
+ ...(create ? { initialManagePrincipal: { type: "string" } } : {}),
57
+ },
58
+ required: ["scope"],
59
+ };
60
+ }
61
+ function putSchema() {
62
+ return {
63
+ type: "object",
64
+ additionalProperties: false,
65
+ properties: {
66
+ scope: { type: "string" },
67
+ key: { type: "string" },
68
+ secretRef: {
69
+ type: "object",
70
+ additionalProperties: false,
71
+ properties: { kind: { const: "secret" }, name: { type: "string" } },
72
+ required: ["kind", "name"],
73
+ },
74
+ },
75
+ required: ["scope", "key", "secretRef"],
76
+ };
77
+ }
78
+ //# sourceMappingURL=secrets-authoring.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"secrets-authoring.js","sourceRoot":"","sources":["../src/secrets-authoring.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,25 @@
1
+ import { DatabricksRestClient } from './client.js';
2
+ /** Databricks Secret Management adapter. Secret values are decoded only at runtime. */
3
+ export function databricksSecretsProvider(options) {
4
+ const client = new DatabricksRestClient(options);
5
+ return {
6
+ name: 'databricks-secrets',
7
+ async resolve(ref, context) {
8
+ const scope = typeof options.scope === 'function' ? await options.scope(ref.name, context?.tenantId) : options.scope;
9
+ const key = options.keyForSecret?.(ref.name) ?? ref.name;
10
+ if (!scope || !key)
11
+ throw new Error('Databricks secret scope and key are required.');
12
+ try {
13
+ const response = await client.get('/api/2.0/secrets/get', { scope, key });
14
+ return response.value === undefined ? undefined : Buffer.from(response.value, 'base64').toString('utf8');
15
+ }
16
+ catch (error) {
17
+ const message = error instanceof Error ? error.message : String(error);
18
+ if (/RESOURCE_DOES_NOT_EXIST|does not exist|404/iu.test(message))
19
+ return undefined;
20
+ throw error;
21
+ }
22
+ },
23
+ };
24
+ }
25
+ //# sourceMappingURL=secrets.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"secrets.js","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAQnD,uFAAuF;AACvF,MAAM,UAAU,yBAAyB,CAAC,OAAyC;IACjF,MAAM,MAAM,GAAG,IAAI,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACjD,OAAO;QACL,IAAI,EAAE,oBAAoB;QAC1B,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO;YACxB,MAAM,KAAK,GAAG,OAAO,OAAO,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;YACrH,MAAM,GAAG,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC;YACzD,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG;gBAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;YACrF,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAqB,sBAAsB,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;gBAC9F,OAAO,QAAQ,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC3G,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvE,IAAI,8CAA8C,CAAC,IAAI,CAAC,OAAO,CAAC;oBAAE,OAAO,SAAS,CAAC;gBACnF,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,255 @@
1
+ export class DatabricksServingAdmin {
2
+ client;
3
+ constructor(client) {
4
+ this.client = client;
5
+ }
6
+ createEndpoint(spec) {
7
+ validate(spec);
8
+ const path = spec.kind === "foundationModel"
9
+ ? "/api/2.0/serving-endpoints/pt"
10
+ : "/api/2.0/serving-endpoints";
11
+ return this.client.post(path, serialize(spec), {}, { retry: "never" });
12
+ }
13
+ getEndpoint(name) {
14
+ return this.client.get(`/api/2.0/serving-endpoints/${encodeURIComponent(name)}`);
15
+ }
16
+ updateEndpoint(name, servedEntities) {
17
+ return this.client.put(`/api/2.0/serving-endpoints/${encodeURIComponent(name)}/config`, { served_entities: servedEntities.map(serializeEntity) }, {}, { retry: "never" });
18
+ }
19
+ updateAiGateway(name, update) {
20
+ return this.client.put(`/api/2.0/serving-endpoints/${encodeURIComponent(name)}/ai-gateway`, {
21
+ ...(update.rateLimits ? { rate_limits: update.rateLimits } : {}),
22
+ ...(update.guardrails ? { guardrails: update.guardrails } : {}),
23
+ ...(update.usageTracking ? { inference_table_config: update.usageTracking } : {}),
24
+ ...(update.fallbackEnabled !== undefined
25
+ ? { fallback_config: { enabled: update.fallbackEnabled } }
26
+ : {}),
27
+ }, {}, { retry: "never" });
28
+ }
29
+ deleteEndpoint(name) {
30
+ return this.client.delete(`/api/2.0/serving-endpoints/${encodeURIComponent(name)}`, undefined, {}, { retry: "safe" });
31
+ }
32
+ async waitForEndpoint(name, options = {}) {
33
+ const deadline = Date.now() + (options.timeoutMs ?? 1_800_000);
34
+ while (true) {
35
+ if (options.signal?.aborted)
36
+ throw options.signal.reason ?? new DOMException("Aborted", "AbortError");
37
+ const endpoint = await this.getEndpoint(name);
38
+ const state = endpoint.state?.ready;
39
+ const config = endpoint.state?.config_update;
40
+ if (state === "READY" && config !== "IN_PROGRESS")
41
+ return endpoint;
42
+ if (state === "NOT_READY" && config === "UPDATE_FAILED")
43
+ throw new Error(`Databricks serving endpoint ${name} update failed.`);
44
+ if (Date.now() >= deadline)
45
+ throw new Error(`Databricks serving endpoint ${name} timed out.`);
46
+ await sleep(jitter(options.pollIntervalMs ?? 10_000), options.signal);
47
+ }
48
+ }
49
+ }
50
+ export function databricksServingAdminTools(client) {
51
+ const api = new DatabricksServingAdmin(client);
52
+ return [
53
+ tool("databricks_create_serving_endpoint", "write", servingSchema(), [
54
+ { kind: "endpoint", path: "/name" },
55
+ {
56
+ kind: "model",
57
+ path: "/servedEntities/*/entityName",
58
+ catalogQualified: true,
59
+ optional: true,
60
+ },
61
+ ], (i) => {
62
+ assertModelSafeServingInput(i);
63
+ return api.createEndpoint(i);
64
+ }),
65
+ tool("databricks_update_serving_endpoint", "write", updateSchema(), [
66
+ { kind: "endpoint", path: "/name" },
67
+ {
68
+ kind: "model",
69
+ path: "/servedEntities/*/entityName",
70
+ catalogQualified: true,
71
+ optional: true,
72
+ },
73
+ ], (i) => {
74
+ assertModelSafeServingInput(i);
75
+ return api.updateEndpoint(i.name, i.servedEntities);
76
+ }),
77
+ tool("databricks_update_ai_gateway", "write", gatewaySchema(), [{ kind: "endpoint", path: "/name" }], (i) => api.updateAiGateway(i.name, i)),
78
+ tool("databricks_delete_serving_endpoint", "write", nameSchema(), [{ kind: "endpoint", path: "/name" }], (i) => api.deleteEndpoint(i.name)),
79
+ ];
80
+ }
81
+ function validate(spec) {
82
+ if (!spec.name || !spec.servedEntities.length)
83
+ throw new Error("databricks serving: name and servedEntities are required.");
84
+ if (spec.kind === "foundationModel")
85
+ for (const entity of spec.servedEntities)
86
+ if (entity.minProvisionedThroughput < 0 ||
87
+ entity.maxProvisionedThroughput < entity.minProvisionedThroughput)
88
+ throw new Error("databricks serving: invalid provisioned throughput range.");
89
+ }
90
+ function serialize(spec) {
91
+ return {
92
+ name: spec.name,
93
+ config: { served_entities: spec.servedEntities.map(serializeEntity) },
94
+ ...(spec.tags
95
+ ? { tags: Object.entries(spec.tags).map(([key, value]) => ({ key, value })) }
96
+ : {}),
97
+ };
98
+ }
99
+ function serializeEntity(entity) {
100
+ if ("minProvisionedThroughput" in entity)
101
+ return {
102
+ name: entity.name,
103
+ entity_name: entity.entityName,
104
+ entity_version: entity.entityVersion,
105
+ min_provisioned_throughput: entity.minProvisionedThroughput,
106
+ max_provisioned_throughput: entity.maxProvisionedThroughput,
107
+ };
108
+ if ("modelName" in entity)
109
+ return {
110
+ name: entity.name,
111
+ external_model: { name: entity.modelName, provider: entity.provider, task: entity.task },
112
+ };
113
+ return {
114
+ name: entity.name,
115
+ entity_name: entity.entityName,
116
+ ...("entityVersion" in entity && entity.entityVersion
117
+ ? { entity_version: entity.entityVersion }
118
+ : {}),
119
+ ...("workloadSize" in entity && entity.workloadSize
120
+ ? { workload_size: entity.workloadSize }
121
+ : {}),
122
+ ...("scaleToZeroEnabled" in entity && entity.scaleToZeroEnabled !== undefined
123
+ ? { scale_to_zero_enabled: entity.scaleToZeroEnabled }
124
+ : {}),
125
+ ...("environmentVars" in entity && entity.environmentVars
126
+ ? { environment_vars: entity.environmentVars }
127
+ : {}),
128
+ };
129
+ }
130
+ function tool(name, effect, inputSchema, resources, execute) {
131
+ return {
132
+ name,
133
+ description: name.replaceAll("_", " "),
134
+ inputSchema,
135
+ metadata: {
136
+ effect,
137
+ provider: "databricks",
138
+ service: "serving",
139
+ governance: { resources },
140
+ },
141
+ execute,
142
+ };
143
+ }
144
+ function nameSchema() {
145
+ return {
146
+ type: "object",
147
+ additionalProperties: false,
148
+ properties: { name: { type: "string" } },
149
+ required: ["name"],
150
+ };
151
+ }
152
+ function entitySchema() {
153
+ return {
154
+ oneOf: [
155
+ {
156
+ type: "object",
157
+ properties: {
158
+ name: { type: "string" },
159
+ entityName: { type: "string" },
160
+ entityVersion: { type: "string" },
161
+ workloadSize: { type: "string" },
162
+ scaleToZeroEnabled: { type: "boolean" },
163
+ },
164
+ required: ["name", "entityName"],
165
+ },
166
+ {
167
+ type: "object",
168
+ properties: {
169
+ name: { type: "string" },
170
+ entityName: { type: "string" },
171
+ entityVersion: { type: "string" },
172
+ minProvisionedThroughput: { type: "number" },
173
+ maxProvisionedThroughput: { type: "number" },
174
+ },
175
+ required: [
176
+ "name",
177
+ "entityName",
178
+ "entityVersion",
179
+ "minProvisionedThroughput",
180
+ "maxProvisionedThroughput",
181
+ ],
182
+ },
183
+ {
184
+ type: "object",
185
+ properties: {
186
+ name: { type: "string" },
187
+ modelName: { type: "string" },
188
+ provider: { type: "string" },
189
+ task: { type: "string" },
190
+ },
191
+ required: ["name", "modelName", "provider", "task"],
192
+ },
193
+ ],
194
+ };
195
+ }
196
+ function assertModelSafeServingInput(input) {
197
+ const entities = Array.isArray(input.servedEntities) ? input.servedEntities : [];
198
+ if (entities.some((entity) => entity &&
199
+ typeof entity === "object" &&
200
+ !Array.isArray(entity) &&
201
+ "environmentVars" in entity)) {
202
+ throw new Error("databricks serving: raw environmentVars are available only on the typed client, not model-facing ToolDefs.");
203
+ }
204
+ }
205
+ function servingSchema() {
206
+ return {
207
+ type: "object",
208
+ additionalProperties: false,
209
+ properties: {
210
+ kind: { type: "string", enum: ["customModel", "foundationModel", "externalModel", "agent"] },
211
+ name: { type: "string" },
212
+ servedEntities: { type: "array", items: entitySchema() },
213
+ tags: { type: "object", additionalProperties: { type: "string" } },
214
+ },
215
+ required: ["kind", "name", "servedEntities"],
216
+ };
217
+ }
218
+ function updateSchema() {
219
+ return {
220
+ type: "object",
221
+ additionalProperties: false,
222
+ properties: {
223
+ name: { type: "string" },
224
+ servedEntities: { type: "array", items: entitySchema() },
225
+ },
226
+ required: ["name", "servedEntities"],
227
+ };
228
+ }
229
+ function gatewaySchema() {
230
+ return {
231
+ type: "object",
232
+ additionalProperties: false,
233
+ properties: {
234
+ name: { type: "string" },
235
+ rateLimits: { type: "array", items: { type: "object", additionalProperties: true } },
236
+ guardrails: { type: "object", additionalProperties: true },
237
+ usageTracking: { type: "object", additionalProperties: true },
238
+ fallbackEnabled: { type: "boolean" },
239
+ },
240
+ required: ["name"],
241
+ };
242
+ }
243
+ function sleep(ms, signal) {
244
+ return new Promise((resolve, reject) => {
245
+ const timer = setTimeout(resolve, ms);
246
+ signal?.addEventListener("abort", () => {
247
+ clearTimeout(timer);
248
+ reject(signal.reason ?? new DOMException("Aborted", "AbortError"));
249
+ }, { once: true });
250
+ });
251
+ }
252
+ function jitter(ms) {
253
+ return Math.max(1, Math.round(ms * (0.9 + Math.random() * 0.2)));
254
+ }
255
+ //# sourceMappingURL=serving-admin.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"serving-admin.js","sourceRoot":"","sources":["../src/serving-admin.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,100 @@
1
+ import { currentSubmissionContext, emitSubmissionTelemetry } from '@fabric-harness/sdk';
2
+ /**
3
+ * Build an `onEvent` fan-in that turns model-usage events into
4
+ * `submission_usage` telemetry. For every {@link FabricEvent} carrying
5
+ * `data.usage` (`{ inputTokens?, outputTokens?, costUsd? }`, at least one
6
+ * numeric field) — and optionally `data.model` — while an ambient
7
+ * {@link currentSubmissionContext} is set, it emits one `submission_usage`
8
+ * event stamped with the submission correlation (submission/attempt ids,
9
+ * agent identity, tenant, actor).
10
+ *
11
+ * Events observed outside a submission context are dropped silently — not
12
+ * every session turn belongs to a submission. The submission context does not
13
+ * carry the submission kind, so emitted events use `kind: 'unknown'`.
14
+ */
15
+ export function servingUsageCapture(options) {
16
+ return (event) => {
17
+ try {
18
+ const usage = usageOf(event);
19
+ if (!usage)
20
+ return;
21
+ const context = currentSubmissionContext();
22
+ if (!context)
23
+ return;
24
+ const model = typeof event.data?.model === 'string' ? event.data.model : undefined;
25
+ const at = Date.parse(event.timestamp);
26
+ emitSubmissionTelemetry(options.sink, {
27
+ type: 'submission_usage',
28
+ submissionId: context.submissionId,
29
+ attemptId: context.attemptId,
30
+ kind: 'unknown',
31
+ agent: context.agent,
32
+ instanceId: context.instanceId,
33
+ session: context.session,
34
+ at: Number.isFinite(at) ? at : Date.now(),
35
+ ...(context.tenantId !== undefined ? { tenantId: context.tenantId } : {}),
36
+ ...(context.actor !== undefined ? { actor: context.actor } : {}),
37
+ ...(model !== undefined ? { model } : {}),
38
+ ...(usage.inputTokens !== undefined ? { inputTokens: usage.inputTokens } : {}),
39
+ ...(usage.outputTokens !== undefined ? { outputTokens: usage.outputTokens } : {}),
40
+ ...(usage.costUsd !== undefined ? { costUsd: usage.costUsd } : {}),
41
+ }, options.onError);
42
+ }
43
+ catch (error) {
44
+ options.onError?.(error);
45
+ }
46
+ };
47
+ }
48
+ /** `data.usage` with at least one numeric field, else `undefined`. */
49
+ function usageOf(event) {
50
+ const raw = event.data?.usage;
51
+ if (typeof raw !== 'object' || raw === null || Array.isArray(raw))
52
+ return undefined;
53
+ const usage = raw;
54
+ const fields = {
55
+ ...(typeof usage.inputTokens === 'number' ? { inputTokens: usage.inputTokens } : {}),
56
+ ...(typeof usage.outputTokens === 'number' ? { outputTokens: usage.outputTokens } : {}),
57
+ ...(typeof usage.costUsd === 'number' ? { costUsd: usage.costUsd } : {}),
58
+ };
59
+ return Object.keys(fields).length > 0 ? fields : undefined;
60
+ }
61
+ /**
62
+ * SQL aggregating a serving endpoint's inference/payload table by
63
+ * `client_request_id` — one row per submission with the request count and the
64
+ * first/last request timestamps — for offline joins against
65
+ * `fh_submission_telemetry.submission_id`.
66
+ *
67
+ * Join contract: callers MUST send the submission id as the serving request's
68
+ * `client_request_id` (e.g. the `client_request_id` field on the
69
+ * serving-endpoint invocation) — the inference table records it verbatim, and
70
+ * this query's `submission_id` column only joins when that convention holds.
71
+ * Rows without a `client_request_id` (traffic from other callers) are
72
+ * excluded. Assumes the AI Gateway payload-table schema (`request_time`
73
+ * timestamp column); adapt the projection for classic inference tables that
74
+ * use `timestamp_ms`.
75
+ */
76
+ export function inferenceTableUsageQuery(options) {
77
+ if (!/^[A-Za-z0-9_]+\.[A-Za-z0-9_]+\.[A-Za-z0-9_]+$/.test(options.fullTableName)) {
78
+ throw new Error(`databricks serving-usage: fullTableName must be catalog.schema.table, got: ${options.fullTableName}`);
79
+ }
80
+ let since = '';
81
+ if (options.sinceIso !== undefined) {
82
+ // Strict shape check first — Date.parse alone is far too lenient to gate a SQL literal.
83
+ const isoShape = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,3})?(Z|[+-]\d{2}:\d{2})$/;
84
+ const parsed = Date.parse(options.sinceIso);
85
+ if (!isoShape.test(options.sinceIso) || !Number.isFinite(parsed)) {
86
+ throw new Error(`databricks serving-usage: sinceIso is not a valid ISO-8601 instant: ${options.sinceIso}`);
87
+ }
88
+ since = `\n AND request_time >= TIMESTAMP '${new Date(parsed).toISOString()}'`;
89
+ }
90
+ return `SELECT
91
+ client_request_id AS submission_id,
92
+ COUNT(*) AS request_count,
93
+ MIN(request_time) AS first_request_at,
94
+ MAX(request_time) AS last_request_at
95
+ FROM ${options.fullTableName}
96
+ WHERE client_request_id IS NOT NULL${since}
97
+ GROUP BY client_request_id
98
+ ORDER BY last_request_at DESC`;
99
+ }
100
+ //# sourceMappingURL=serving-usage.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"serving-usage.js","sourceRoot":"","sources":["../src/serving-usage.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,36 @@
1
+ const TERMINAL_STATES = new Set(['SUCCEEDED', 'FAILED', 'CANCELED', 'CLOSED']);
2
+ /** Submit a parameterized SQL statement and poll to a terminal state. Named parameters → injection-safe. */
3
+ export async function runStatement(client, warehouseId, statement, parameters, poll) {
4
+ const submit = await client.post('/api/2.0/sql/statements', {
5
+ warehouse_id: warehouseId,
6
+ statement,
7
+ wait_timeout: '30s',
8
+ disposition: 'INLINE',
9
+ ...(parameters.length > 0 ? { parameters } : {}),
10
+ });
11
+ if (TERMINAL_STATES.has(submit.status?.state ?? ''))
12
+ return submit;
13
+ const id = submit.statement_id;
14
+ if (!id)
15
+ return submit;
16
+ const deadline = Date.now() + poll.timeoutMs;
17
+ let current = submit;
18
+ while (!TERMINAL_STATES.has(current.status?.state ?? '') && Date.now() < deadline) {
19
+ await new Promise((resolve) => setTimeout(resolve, poll.intervalMs));
20
+ current = await client.get(`/api/2.0/sql/statements/${encodeURIComponent(id)}`);
21
+ }
22
+ return current;
23
+ }
24
+ /** Map a statement response's columns + rows into objects keyed by column name. */
25
+ export function parseStatementRows(response) {
26
+ const res = response;
27
+ const columns = res.manifest?.schema?.columns ?? res.manifest?.columns ?? [];
28
+ const names = columns.map((c) => c.name);
29
+ const rows = res.result?.data_array ?? [];
30
+ return rows.map((row) => {
31
+ const record = {};
32
+ names.forEach((name, i) => { record[name] = row[i]; });
33
+ return record;
34
+ });
35
+ }
36
+ //# sourceMappingURL=sql-exec.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sql-exec.js","sourceRoot":"","sources":["../src/sql-exec.ts"],"names":[],"mappings":"AAsBA,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE/E,4GAA4G;AAC5G,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAA4B,EAC5B,WAAmB,EACnB,SAAiB,EACjB,UAA0B,EAC1B,IAAmB;IAEnB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAoB,yBAAyB,EAAE;QAC7E,YAAY,EAAE,WAAW;QACzB,SAAS;QACT,YAAY,EAAE,KAAK;QACnB,WAAW,EAAE,QAAQ;QACrB,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjD,CAAC,CAAC;IACH,IAAI,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;QAAE,OAAO,MAAM,CAAC;IACnE,MAAM,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC;IAC/B,IAAI,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC;IAEvB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;IAC7C,IAAI,OAAO,GAAsB,MAAM,CAAC;IACxC,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAClF,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QACrE,OAAO,GAAG,MAAM,MAAM,CAAC,GAAG,CAAoB,2BAA2B,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACrG,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,kBAAkB,CAAC,QAAiB;IAClD,MAAM,GAAG,GAAG,QAA6B,CAAC;IAC1C,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,IAAI,GAAG,CAAC,QAAQ,EAAE,OAAO,IAAI,EAAE,CAAC;IAC7E,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,IAAI,EAAE,CAAC;IAC1C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACtB,MAAM,MAAM,GAAe,EAAE,CAAC;QAC9B,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAuB,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7E,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC"}