@fabric-harness/databricks 4.10.1 → 5.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -0
- package/dist/agent.js +108 -22
- package/dist/agent.js.map +1 -1
- package/dist/capabilities.d.ts +33 -0
- package/dist/capabilities.d.ts.map +1 -1
- package/dist/certification.d.ts.map +1 -1
- package/dist/certify.js +166 -33
- package/dist/certify.js.map +1 -1
- package/dist/compatibility.d.ts +1 -1
- package/dist/index.d.ts +22 -9
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +505 -42
- package/dist/index.js.map +1 -1
- package/dist/rag-chain.d.ts +21 -8
- package/dist/rag-chain.d.ts.map +1 -1
- package/dist/vector-search.d.ts +58 -8
- package/dist/vector-search.d.ts.map +1 -1
- package/dist/workspace-api.d.ts +40 -0
- package/dist/workspace-api.d.ts.map +1 -0
- package/package.json +3 -3
package/dist/rag-chain.d.ts
CHANGED
|
@@ -1,4 +1,14 @@
|
|
|
1
|
+
import type { FacetResultData } from "@databricks/sdk-vectorsearch/v1";
|
|
1
2
|
import type { CapabilityPolicy, ModelProvider, ModelUsage, RetrieveOptions, RetrievedChunk, Retriever, ToolDef } from "@fabric-harness/sdk";
|
|
3
|
+
import type { DatabricksAiSearchQueryOptions } from "./vector-search.js";
|
|
4
|
+
export interface DatabricksRagRetrievalOptions extends Omit<DatabricksAiSearchQueryOptions, "signal"> {
|
|
5
|
+
}
|
|
6
|
+
export interface DatabricksRagInput {
|
|
7
|
+
question: string;
|
|
8
|
+
signal?: AbortSignal;
|
|
9
|
+
/** Per-turn native AI Search overrides. Requires a Databricks AI Search retriever. */
|
|
10
|
+
retrieval?: DatabricksRagRetrievalOptions;
|
|
11
|
+
}
|
|
2
12
|
/**
|
|
3
13
|
* Structured result of one online RAG inference turn.
|
|
4
14
|
* Mirrors the Databricks AI Cookbook chain:
|
|
@@ -27,6 +37,13 @@ export interface RagTurn {
|
|
|
27
37
|
}>;
|
|
28
38
|
model?: string;
|
|
29
39
|
index?: string;
|
|
40
|
+
/** Native AI Search controls and result metadata used for this turn. */
|
|
41
|
+
retrieval?: {
|
|
42
|
+
inputMode?: DatabricksRagRetrievalOptions["inputMode"];
|
|
43
|
+
strategy?: DatabricksRagRetrievalOptions["strategy"];
|
|
44
|
+
nextPageToken?: string;
|
|
45
|
+
facetResult?: FacetResultData;
|
|
46
|
+
};
|
|
30
47
|
latencyMs: {
|
|
31
48
|
preprocess: number;
|
|
32
49
|
retrieve: number;
|
|
@@ -79,6 +96,8 @@ export interface DatabricksRagChainResolvedOptions {
|
|
|
79
96
|
/** Maximum characters included from one retrieved chunk. Default 8,000. */
|
|
80
97
|
maxChunkChars?: number;
|
|
81
98
|
filter?: RetrieveOptions["filter"];
|
|
99
|
+
/** Native AI Search defaults. Per-turn values supplied to invoke/stream take precedence. */
|
|
100
|
+
retrieval?: DatabricksRagRetrievalOptions;
|
|
82
101
|
preprocess?: RagPreprocess;
|
|
83
102
|
prompt?: RagChainPromptOptions;
|
|
84
103
|
postProcess?: RagChainPostProcessOptions;
|
|
@@ -104,10 +123,7 @@ export type RagStreamEvent = {
|
|
|
104
123
|
};
|
|
105
124
|
export interface DatabricksRagChain {
|
|
106
125
|
/** Deterministic cookbook-style inference chain (not free-form tool calling). */
|
|
107
|
-
invoke(input:
|
|
108
|
-
question: string;
|
|
109
|
-
signal?: AbortSignal;
|
|
110
|
-
}): Promise<RagTurn>;
|
|
126
|
+
invoke(input: DatabricksRagInput): Promise<RagTurn>;
|
|
111
127
|
/**
|
|
112
128
|
* Streaming variant of {@link invoke}. Yields `delta` events while the model
|
|
113
129
|
* generates, then one terminal `turn` event carrying the same validated
|
|
@@ -117,10 +133,7 @@ export interface DatabricksRagChain {
|
|
|
117
133
|
* after deltas were observed, and a repaired answer is only reflected in the
|
|
118
134
|
* terminal `turn`.
|
|
119
135
|
*/
|
|
120
|
-
stream(input:
|
|
121
|
-
question: string;
|
|
122
|
-
signal?: AbortSignal;
|
|
123
|
-
}): AsyncGenerator<RagStreamEvent, void>;
|
|
136
|
+
stream(input: DatabricksRagInput): AsyncGenerator<RagStreamEvent, void>;
|
|
124
137
|
/**
|
|
125
138
|
* Agentic path: same AI Search as a governed `search` tool + model provider
|
|
126
139
|
* for multi-step agents. Prefer when the agent also needs SQL/Genie/etc.
|
package/dist/rag-chain.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"rag-chain.d.ts","sourceRoot":"","sources":["../src/rag-chain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EAEb,UAAU,EACV,eAAe,EACf,cAAc,EACd,SAAS,EACT,OAAO,EACR,MAAM,qBAAqB,CAAC;
|
|
1
|
+
{"version":3,"file":"rag-chain.d.ts","sourceRoot":"","sources":["../src/rag-chain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EAEb,UAAU,EACV,eAAe,EACf,cAAc,EACd,SAAS,EACT,OAAO,EACR,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EACV,8BAA8B,EAE/B,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,6BACf,SAAQ,IAAI,CAAC,8BAA8B,EAAE,QAAQ,CAAC;CAAG;AAE3D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,sFAAsF;IACtF,SAAS,CAAC,EAAE,6BAA6B,CAAC;CAC3C;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,iGAAiG;IACjG,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE,yFAAyF;IACzF,SAAS,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,SAAS,CAAC,EAAE;QACV,SAAS,CAAC,EAAE,6BAA6B,CAAC,WAAW,CAAC,CAAC;QACvD,QAAQ,CAAC,EAAE,6BAA6B,CAAC,UAAU,CAAC,CAAC;QACrD,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,eAAe,CAAC;KAC/B,CAAC;IACF,SAAS,EAAE;QACT,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,wEAAwE;IACxE,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,0BAA0B;IACzC,wFAAwF;IACxF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,+FAA+F;IAC/F,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gGAAgG;IAChG,cAAc,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;IAC3C,4FAA4F;IAC5F,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,sFAAsF;IACtF,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AAEtF,wEAAwE;AACxE,MAAM,WAAW,iCAAiC;IAChD,aAAa,EAAE,aAAa,CAAC;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,4DAA4D;IAC5D,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2FAA2F;IAC3F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IACnC,4FAA4F;IAC5F,SAAS,CAAC,EAAE,6BAA6B,CAAC;IAC1C,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,WAAW,CAAC,EAAE,0BAA0B,CAAC;IACzC,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAEpG,MAAM,WAAW,kBAAkB;IACjC,iFAAiF;IACjF,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD;;;;;;;;OAQG;IACH,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,cAAc,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;IACxE;;;OAGG;IACH,YAAY,IAAI;QACd,aAAa,EAAE,aAAa,CAAC;QAC7B,KAAK,EAAE,OAAO,EAAE,CAAC;QACjB,MAAM,CAAC,EAAE,gBAAgB,CAAC;QAC1B,SAAS,EAAE,SAAS,CAAC;KACtB,CAAC;IACF,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;CACvC;AAoBD;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,iCAAiC,GACzC,kBAAkB,CAsQpB"}
|
package/dist/vector-search.d.ts
CHANGED
|
@@ -1,7 +1,46 @@
|
|
|
1
|
-
import type {
|
|
2
|
-
import type {
|
|
1
|
+
import type { FacetResultData, QueryVectorIndexResponse, RerankerConfig, VectorSearchClient } from "@databricks/sdk-vectorsearch/v1";
|
|
2
|
+
import type { EmbeddingProvider, RetrieveOptions, RetrievedChunk, Retriever } from "@fabric-harness/sdk";
|
|
3
3
|
import type { DatabricksRawProtocolClient } from "./raw-protocol-client.js";
|
|
4
|
-
export type DatabricksVectorSearchClient = Pick<VectorSearchClient, "queryVectorIndex"
|
|
4
|
+
export type DatabricksVectorSearchClient = Pick<VectorSearchClient, "queryVectorIndex"> & Partial<Pick<VectorSearchClient, "queryVectorIndexNextPage">>;
|
|
5
|
+
export type DatabricksAiSearchInputMode = "text" | "vector" | "text-and-vector";
|
|
6
|
+
export type DatabricksAiSearchStrategy = "ann" | "hybrid" | "full-text";
|
|
7
|
+
export interface DatabricksAiSearchQueryOptions extends RetrieveOptions {
|
|
8
|
+
/** Override the configured input mode for this query. */
|
|
9
|
+
inputMode?: DatabricksAiSearchInputMode;
|
|
10
|
+
/** Override the configured retrieval algorithm for this query. */
|
|
11
|
+
strategy?: DatabricksAiSearchStrategy;
|
|
12
|
+
/** Precomputed query vector. Required when no embeddings provider can supply a vector input. */
|
|
13
|
+
queryVector?: number[];
|
|
14
|
+
/** Minimum score accepted by Databricks AI Search. */
|
|
15
|
+
scoreThreshold?: number;
|
|
16
|
+
/** Text columns searched for the query text. */
|
|
17
|
+
queryColumns?: string[];
|
|
18
|
+
/** Sort clauses such as `rating DESC`. */
|
|
19
|
+
sortColumns?: string[];
|
|
20
|
+
/** Facet expressions returned with the result set. */
|
|
21
|
+
facets?: string[];
|
|
22
|
+
/** Native Databricks reranker configuration. */
|
|
23
|
+
reranker?: RerankerConfig;
|
|
24
|
+
/** Columns supplied to the native reranker. */
|
|
25
|
+
columnsToRerank?: string[];
|
|
26
|
+
}
|
|
27
|
+
export interface DatabricksAiSearchQueryResult {
|
|
28
|
+
chunks: RetrievedChunk[];
|
|
29
|
+
nextPageToken?: string;
|
|
30
|
+
facetResult?: FacetResultData;
|
|
31
|
+
/** Complete generated-SDK response for callers that need native result metadata. */
|
|
32
|
+
response: QueryVectorIndexResponse;
|
|
33
|
+
}
|
|
34
|
+
export interface DatabricksAiSearchRetriever extends Retriever {
|
|
35
|
+
readonly kind: "databricks-ai-search";
|
|
36
|
+
readonly index: string;
|
|
37
|
+
readonly inputMode: DatabricksAiSearchInputMode;
|
|
38
|
+
readonly strategy: DatabricksAiSearchStrategy;
|
|
39
|
+
query(query: string, options?: DatabricksAiSearchQueryOptions): Promise<DatabricksAiSearchQueryResult>;
|
|
40
|
+
nextPage(pageToken: string, options?: {
|
|
41
|
+
signal?: AbortSignal;
|
|
42
|
+
}): Promise<DatabricksAiSearchQueryResult>;
|
|
43
|
+
}
|
|
5
44
|
export interface DatabricksAiSearchOptions {
|
|
6
45
|
client: DatabricksVectorSearchClient;
|
|
7
46
|
/**
|
|
@@ -18,14 +57,25 @@ export interface DatabricksAiSearchOptions {
|
|
|
18
57
|
/** Column to surface as `RetrievedChunk.id`. */
|
|
19
58
|
idColumn?: string;
|
|
20
59
|
/**
|
|
21
|
-
*
|
|
22
|
-
*
|
|
60
|
+
* Query representation. Text indexes default to `text`; self-managed indexes use `vector`;
|
|
61
|
+
* `text-and-vector` sends both inputs where the selected Databricks strategy supports them.
|
|
62
|
+
*/
|
|
63
|
+
inputMode?: DatabricksAiSearchInputMode;
|
|
64
|
+
/**
|
|
65
|
+
* Databricks retrieval algorithm. Text input defaults to `hybrid`, while vector-only input
|
|
66
|
+
* defaults to `ann`.
|
|
23
67
|
*/
|
|
24
|
-
|
|
25
|
-
/** Required
|
|
68
|
+
strategy?: DatabricksAiSearchStrategy;
|
|
69
|
+
/** Required for vector input unless each query supplies `queryVector`. */
|
|
26
70
|
embeddings?: EmbeddingProvider;
|
|
71
|
+
scoreThreshold?: number;
|
|
72
|
+
queryColumns?: string[];
|
|
73
|
+
sortColumns?: string[];
|
|
74
|
+
facets?: string[];
|
|
75
|
+
reranker?: RerankerConfig;
|
|
76
|
+
columnsToRerank?: string[];
|
|
27
77
|
name?: string;
|
|
28
78
|
}
|
|
29
79
|
/** Databricks AI Search as a {@link Retriever}. Runs under the bundle's Unity Catalog principal. */
|
|
30
|
-
export declare function databricksAiSearch(options: DatabricksAiSearchOptions):
|
|
80
|
+
export declare function databricksAiSearch(options: DatabricksAiSearchOptions): DatabricksAiSearchRetriever;
|
|
31
81
|
//# sourceMappingURL=vector-search.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"vector-search.d.ts","sourceRoot":"","sources":["../src/vector-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,
|
|
1
|
+
{"version":3,"file":"vector-search.d.ts","sourceRoot":"","sources":["../src/vector-search.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import { type DatabricksPrincipal } from "./identity.js";
|
|
2
|
+
export type DatabricksWorkspaceApiMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
|
|
3
|
+
export interface DatabricksWorkspaceApiOptions {
|
|
4
|
+
host: string;
|
|
5
|
+
principal: DatabricksPrincipal;
|
|
6
|
+
fetchImpl?: typeof fetch;
|
|
7
|
+
maxRetries?: number;
|
|
8
|
+
retryBaseDelayMs?: number;
|
|
9
|
+
signal?: AbortSignal;
|
|
10
|
+
extraHeaders?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
|
|
11
|
+
}
|
|
12
|
+
export interface DatabricksWorkspaceApiRequestOptions {
|
|
13
|
+
/** JSON value by default, or a native fetch body when `bodyEncoding` is `raw`. */
|
|
14
|
+
body?: unknown;
|
|
15
|
+
bodyEncoding?: "json" | "raw";
|
|
16
|
+
query?: Record<string, string | number | boolean | readonly string[] | undefined>;
|
|
17
|
+
signal?: AbortSignal;
|
|
18
|
+
/**
|
|
19
|
+
* Reads retry transient failures automatically. Mutations retry only when explicitly marked
|
|
20
|
+
* idempotent and accompanied by a stable idempotency key.
|
|
21
|
+
*/
|
|
22
|
+
retry?: "safe" | "idempotent" | "never";
|
|
23
|
+
idempotencyKey?: string;
|
|
24
|
+
maxRetries?: number;
|
|
25
|
+
headers?: Record<string, string>;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Credential-safe native Databricks REST escape hatch.
|
|
29
|
+
*
|
|
30
|
+
* Prefer the generated clients from {@link databricksSdk} when one exists. This client preserves
|
|
31
|
+
* access to newly released or uncommon Databricks APIs without waiting for a Harness wrapper. It is
|
|
32
|
+
* deliberately not a model tool: applications must validate requests and place governed mutations
|
|
33
|
+
* behind their own explicit tool/action boundary.
|
|
34
|
+
*/
|
|
35
|
+
export interface DatabricksWorkspaceApi {
|
|
36
|
+
request<T>(method: DatabricksWorkspaceApiMethod, path: string, options?: DatabricksWorkspaceApiRequestOptions): Promise<T>;
|
|
37
|
+
requestRaw(method: DatabricksWorkspaceApiMethod, path: string, options?: DatabricksWorkspaceApiRequestOptions): Promise<Response>;
|
|
38
|
+
}
|
|
39
|
+
export declare function databricksWorkspaceApi(options: DatabricksWorkspaceApiOptions): DatabricksWorkspaceApi;
|
|
40
|
+
//# sourceMappingURL=workspace-api.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"workspace-api.d.ts","sourceRoot":"","sources":["../src/workspace-api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,mBAAmB,EAAsB,MAAM,eAAe,CAAC;AAG7E,MAAM,MAAM,4BAA4B,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEvF,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,mBAAmB,CAAC;IAC/B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,YAAY,CAAC,EACT,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtB,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CACtE;AAED,MAAM,WAAW,oCAAoC;IACnD,kFAAkF;IAClF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IAClF,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,OAAO,CAAC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,CAAC,EACP,MAAM,EAAE,4BAA4B,EACpC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,oCAAoC,GAC7C,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,UAAU,CACR,MAAM,EAAE,4BAA4B,EACpC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,oCAAoC,GAC7C,OAAO,CAAC,QAAQ,CAAC,CAAC;CACtB;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,6BAA6B,GACrC,sBAAsB,CAyGxB"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@fabric-harness/databricks",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "5.0.1",
|
|
4
4
|
"description": "Databricks tools and filesystem sources for Fabric Harness agents.",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"author": "Fabric",
|
|
@@ -87,7 +87,7 @@
|
|
|
87
87
|
"@databricks/sdk-uc-tables": "0.21.0",
|
|
88
88
|
"@databricks/sdk-uc-volumes": "0.21.0",
|
|
89
89
|
"@databricks/sdk-vectorsearch": "0.21.0",
|
|
90
|
-
"@fabric-harness/sdk": "^
|
|
90
|
+
"@fabric-harness/sdk": "^5.0.0"
|
|
91
91
|
},
|
|
92
92
|
"peerDependencies": {
|
|
93
93
|
"@fabric-harness/node": ">=3.0.0",
|
|
@@ -106,7 +106,7 @@
|
|
|
106
106
|
}
|
|
107
107
|
},
|
|
108
108
|
"devDependencies": {
|
|
109
|
-
"@fabric-harness/node": "^
|
|
109
|
+
"@fabric-harness/node": "^5.0.0",
|
|
110
110
|
"@fabricorg/platform": "^0.9.0",
|
|
111
111
|
"tsup": "8.5.0",
|
|
112
112
|
"typescript": "^5.8.3",
|