@fabric-harness/databricks 5.0.0 → 5.2.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.
- package/dist/agent.js +271 -10
- package/dist/agent.js.map +1 -1
- package/dist/asset-bundles.d.ts +56 -6
- package/dist/asset-bundles.d.ts.map +1 -1
- package/dist/certify.js.map +1 -1
- package/dist/compatibility.d.ts +1 -1
- package/dist/index.d.ts +25 -9
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +280 -18
- package/dist/index.js.map +1 -1
- package/package.json +3 -3
package/dist/asset-bundles.d.ts
CHANGED
|
@@ -4,6 +4,11 @@ import { type DatabricksManagedResourceStore } from "./managed-resource.js";
|
|
|
4
4
|
export interface DatabricksAssetBundleOptions {
|
|
5
5
|
/** Directory containing the checked-in bundle's `databricks.yml`. */
|
|
6
6
|
bundleDir: string;
|
|
7
|
+
/**
|
|
8
|
+
* Logical bundle name from the named `assetBundles` map; scopes the managed-resource identity so
|
|
9
|
+
* lifecycles sharing one durable store never overwrite each other's records.
|
|
10
|
+
*/
|
|
11
|
+
instanceName?: string;
|
|
7
12
|
/** Bundle target (dev/prod) passed through to the Databricks CLI. */
|
|
8
13
|
target?: string;
|
|
9
14
|
/** Databricks CLI profile. */
|
|
@@ -18,6 +23,20 @@ export interface DatabricksAssetBundleOptions {
|
|
|
18
23
|
/** Label recorded as `createdBy`; never a token. */
|
|
19
24
|
principalLabel?: string;
|
|
20
25
|
}
|
|
26
|
+
/** Structured handoff from bounded bundle submission to Jobs/Lakeflow polling tools. */
|
|
27
|
+
export interface DatabricksAssetBundleRunResult {
|
|
28
|
+
submitted: true;
|
|
29
|
+
resourceKey: string;
|
|
30
|
+
runKind?: "job" | "pipeline";
|
|
31
|
+
/** Jobs run id, directly accepted by the Databricks jobs status/output tools. */
|
|
32
|
+
runId?: number;
|
|
33
|
+
/** Lakeflow pipeline id, paired with `updateId` for pipeline status polling. */
|
|
34
|
+
pipelineId?: string;
|
|
35
|
+
/** Lakeflow update id, paired with `pipelineId` for pipeline status polling. */
|
|
36
|
+
updateId?: string;
|
|
37
|
+
runUrl?: string;
|
|
38
|
+
output: string;
|
|
39
|
+
}
|
|
21
40
|
/**
|
|
22
41
|
* Governed lifecycle for a checked-in Databricks Asset Bundle (DAB).
|
|
23
42
|
*
|
|
@@ -40,6 +59,8 @@ export interface DatabricksAssetBundleOptions {
|
|
|
40
59
|
export declare class DatabricksAssetBundleLifecycle {
|
|
41
60
|
/** Resolved bundle directory; also the governed resource identity on the tools. */
|
|
42
61
|
readonly bundleDir: string;
|
|
62
|
+
/** Logical name of this bundle within a named `assetBundles` map; unset in the single-bundle form. */
|
|
63
|
+
readonly instanceName?: string;
|
|
43
64
|
private readonly target?;
|
|
44
65
|
private readonly profile?;
|
|
45
66
|
private readonly executable;
|
|
@@ -74,10 +95,7 @@ export declare class DatabricksAssetBundleLifecycle {
|
|
|
74
95
|
run(options: {
|
|
75
96
|
key: string;
|
|
76
97
|
restart?: boolean;
|
|
77
|
-
}): Promise<
|
|
78
|
-
submitted: true;
|
|
79
|
-
output: string;
|
|
80
|
-
}>;
|
|
98
|
+
}): Promise<DatabricksAssetBundleRunResult>;
|
|
81
99
|
/** Destroy a Harness-recorded bundle deployment and delete its managed record. */
|
|
82
100
|
destroy(options?: {
|
|
83
101
|
force?: boolean;
|
|
@@ -85,16 +103,48 @@ export declare class DatabricksAssetBundleLifecycle {
|
|
|
85
103
|
destroyed: true;
|
|
86
104
|
output: string;
|
|
87
105
|
}>;
|
|
88
|
-
/**
|
|
106
|
+
/**
|
|
107
|
+
* Bundle `name:` parsed from `databricks.yml`, falling back to the directory basename. Named
|
|
108
|
+
* bundles append `#instanceName` (and `#target` when set) so two lifecycles over the same manifest
|
|
109
|
+
* cannot collide in a shared managed-resource store; the single-bundle form keeps the bare name so
|
|
110
|
+
* existing records stay addressable.
|
|
111
|
+
*/
|
|
89
112
|
private resourceId;
|
|
90
113
|
private requireManifest;
|
|
91
114
|
private targetArgs;
|
|
92
115
|
private profileArgs;
|
|
93
116
|
}
|
|
94
117
|
export declare function databricksAssetBundleLifecycle(options: DatabricksAssetBundleOptions): DatabricksAssetBundleLifecycle;
|
|
118
|
+
/** Several checked-in bundles keyed by logical name; the key becomes the lifecycle's `instanceName`. */
|
|
119
|
+
export type DatabricksAssetBundleMapOptions = Record<string, Omit<DatabricksAssetBundleOptions, "instanceName">>;
|
|
120
|
+
/**
|
|
121
|
+
* Discriminates the single-bundle form from the named-bundle map. A map key literally called
|
|
122
|
+
* `bundleDir` still selects map mode because its value is an entry object, not a string.
|
|
123
|
+
*/
|
|
124
|
+
export declare function isDatabricksAssetBundleEntry(value: unknown): value is {
|
|
125
|
+
bundleDir: string;
|
|
126
|
+
} | DatabricksAssetBundleLifecycle;
|
|
127
|
+
/**
|
|
128
|
+
* Reject a named-bundle container that is not a plain object. Arrays are rejected too (isPlainObject
|
|
129
|
+
* excludes them): from untyped or parsed config they would otherwise enumerate as bundles named
|
|
130
|
+
* "0", "1", … Shared with `databricks()` so the config boundary and this helper report one message.
|
|
131
|
+
* Only the container is checked, so the assertion says nothing about the entries — each one is
|
|
132
|
+
* validated during enumeration in `databricksAssetBundleLifecycles`.
|
|
133
|
+
*/
|
|
134
|
+
export declare function requireDatabricksAssetBundleMap(value: unknown): asserts value is Record<string, unknown>;
|
|
135
|
+
/**
|
|
136
|
+
* Build one lifecycle per named bundle. Names are validated (they reach the model as tool input and
|
|
137
|
+
* the managed-resource store as ids) and sorted, so tool enums and dispatch stay deterministic.
|
|
138
|
+
* `defaults` are applied under each entry, letting a caller set one `principalLabel` for every bundle.
|
|
139
|
+
*/
|
|
140
|
+
export declare function databricksAssetBundleLifecycles(options: DatabricksAssetBundleMapOptions, defaults?: Omit<DatabricksAssetBundleOptions, "bundleDir" | "instanceName">): Map<string, DatabricksAssetBundleLifecycle>;
|
|
95
141
|
/**
|
|
96
142
|
* Model-facing tools for the governed bundle lifecycle. Write tools are approval-gated
|
|
97
143
|
* by the `databricks()` bundle like every other authoring surface.
|
|
144
|
+
*
|
|
145
|
+
* A single bundle keeps bundle-free tool schemas; a named map adds a required `bundle` selector to
|
|
146
|
+
* every schema (even with one entry, so the schema and its approval digests stay stable when a second
|
|
147
|
+
* bundle is added) and governs only the bundle the call actually names.
|
|
98
148
|
*/
|
|
99
|
-
export declare function databricksAssetBundleTools(options: DatabricksAssetBundleOptions | DatabricksAssetBundleLifecycle): ToolDef[];
|
|
149
|
+
export declare function databricksAssetBundleTools(options: DatabricksAssetBundleOptions | DatabricksAssetBundleLifecycle | DatabricksAssetBundleMapOptions | Map<string, DatabricksAssetBundleLifecycle>): ToolDef[];
|
|
100
150
|
//# sourceMappingURL=asset-bundles.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"asset-bundles.d.ts","sourceRoot":"","sources":["../src/asset-bundles.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAc,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAEL,KAAK,uBAAuB,EAE7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAEL,KAAK,8BAA8B,EAIpC,MAAM,uBAAuB,CAAC;
|
|
1
|
+
{"version":3,"file":"asset-bundles.d.ts","sourceRoot":"","sources":["../src/asset-bundles.ts"],"names":[],"mappings":"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"}
|