@duckcodeailabs/dql-core 1.13.3 → 1.13.5
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/artifacts/dql-artifact.d.ts +24 -0
- package/dist/artifacts/dql-artifact.d.ts.map +1 -1
- package/dist/artifacts/dql-artifact.js +43 -0
- package/dist/artifacts/dql-artifact.js.map +1 -1
- package/dist/artifacts/index.d.ts +2 -2
- package/dist/artifacts/index.d.ts.map +1 -1
- package/dist/artifacts/index.js +1 -1
- package/dist/artifacts/index.js.map +1 -1
- package/dist/contracts/analytical.d.ts +98 -0
- package/dist/contracts/analytical.d.ts.map +1 -1
- package/dist/contracts/analytical.js +204 -1
- package/dist/contracts/analytical.js.map +1 -1
- package/dist/contracts/execution.d.ts +81 -0
- package/dist/contracts/execution.d.ts.map +1 -0
- package/dist/contracts/execution.js +157 -0
- package/dist/contracts/execution.js.map +1 -0
- package/dist/contracts/index.d.ts +3 -2
- package/dist/contracts/index.d.ts.map +1 -1
- package/dist/contracts/index.js +2 -1
- package/dist/contracts/index.js.map +1 -1
- package/dist/contracts/semantic-execution.d.ts +26 -0
- package/dist/contracts/semantic-execution.d.ts.map +1 -1
- package/dist/contracts/semantic-execution.js.map +1 -1
- package/dist/lineage/index.d.ts +1 -1
- package/dist/lineage/index.d.ts.map +1 -1
- package/dist/lineage/index.js +1 -1
- package/dist/lineage/index.js.map +1 -1
- package/dist/lineage/sql-parser.d.ts +59 -0
- package/dist/lineage/sql-parser.d.ts.map +1 -1
- package/dist/lineage/sql-parser.js +331 -0
- package/dist/lineage/sql-parser.js.map +1 -1
- package/dist/semantic/providers/dbt-provider.d.ts +1 -1
- package/dist/semantic/providers/dbt-provider.d.ts.map +1 -1
- package/dist/semantic/providers/dbt-provider.js +28 -5
- package/dist/semantic/providers/dbt-provider.js.map +1 -1
- package/dist/semantic/semantic-layer.d.ts +8 -1
- package/dist/semantic/semantic-layer.d.ts.map +1 -1
- package/dist/semantic/semantic-layer.js +63 -6
- package/dist/semantic/semantic-layer.js.map +1 -1
- package/package.json +1 -1
|
@@ -25,6 +25,27 @@ export interface DqlArtifactExecutionReceipt {
|
|
|
25
25
|
parameterFingerprint: string;
|
|
26
26
|
resultFingerprint: string;
|
|
27
27
|
}
|
|
28
|
+
export interface DqlExecutableArtifactV1 {
|
|
29
|
+
version: 1;
|
|
30
|
+
kind: DqlArtifactKind;
|
|
31
|
+
/** Fingerprints only: this binding must not become a second persisted source or SQL payload. */
|
|
32
|
+
dqlFingerprint: string;
|
|
33
|
+
sourceFingerprint: string;
|
|
34
|
+
compiledSqlFingerprint: string;
|
|
35
|
+
normalizedSqlFingerprint: string;
|
|
36
|
+
parameterFingerprint: string;
|
|
37
|
+
provenanceFingerprint: string;
|
|
38
|
+
targetFingerprint: string;
|
|
39
|
+
snapshotFingerprint: string;
|
|
40
|
+
planFingerprint: string;
|
|
41
|
+
semanticAdapter: string;
|
|
42
|
+
previewPolicy: {
|
|
43
|
+
mode: 'read_only_bounded' | 'compiler_governed';
|
|
44
|
+
rowLimit?: number;
|
|
45
|
+
};
|
|
46
|
+
trustState: DqlArtifactTrustState;
|
|
47
|
+
receipt: DqlArtifactExecutionReceipt;
|
|
48
|
+
}
|
|
28
49
|
export interface DqlArtifactReference {
|
|
29
50
|
kind: DqlArtifactKind;
|
|
30
51
|
source: string;
|
|
@@ -48,6 +69,8 @@ export interface DqlArtifactReference {
|
|
|
48
69
|
compiledSql?: string;
|
|
49
70
|
/** Exact execution contract used for the displayed result. */
|
|
50
71
|
executionReceipt?: DqlArtifactExecutionReceipt;
|
|
72
|
+
/** Immutable preparation/execution binding shared by Ask and Notebook consumers. */
|
|
73
|
+
executableArtifact?: DqlExecutableArtifactV1;
|
|
51
74
|
/**
|
|
52
75
|
* Result columns that may safely be promoted to a runtime filter input.
|
|
53
76
|
*
|
|
@@ -62,5 +85,6 @@ export interface DqlArtifactReference {
|
|
|
62
85
|
}>;
|
|
63
86
|
}
|
|
64
87
|
export declare function normalizeDqlArtifactReference(value: unknown): DqlArtifactReference | undefined;
|
|
88
|
+
export declare function normalizeDqlExecutableArtifactV1(value: unknown): DqlExecutableArtifactV1 | undefined;
|
|
65
89
|
export declare function normalizeDqlArtifactKind(value: unknown): DqlArtifactKind | undefined;
|
|
66
90
|
//# sourceMappingURL=dql-artifact.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"dql-artifact.d.ts","sourceRoot":"","sources":["../../src/artifacts/dql-artifact.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAyB,wBAAwB,EAAwB,MAAM,yBAAyB,CAAC;AAErH,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,WAAW,CAAC;AACjF,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG,OAAO,CAAC;AAC3D,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG,UAAU,GAAG,iBAAiB,CAAC;AAEjF,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC9B,aAAa,CAAC,EAAE,wBAAwB,CAAC;IACzC,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,UAAU,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACxC,+FAA+F;IAC/F,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,mFAAmF;IACnF,WAAW,CAAC,EAAE,sBAAsB,CAAC;IACrC,+DAA+D;IAC/D,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,2BAA2B,CAAC;IAC/C;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxE;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,GAAG,SAAS,
|
|
1
|
+
{"version":3,"file":"dql-artifact.d.ts","sourceRoot":"","sources":["../../src/artifacts/dql-artifact.ts"],"names":[],"mappings":"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"}
|
|
@@ -23,10 +23,53 @@ export function normalizeDqlArtifactReference(value) {
|
|
|
23
23
|
trustState: normalizeDqlArtifactTrustState(record.trustState),
|
|
24
24
|
compiledSql: cleanString(record.compiledSql),
|
|
25
25
|
executionReceipt: normalizeExecutionReceipt(record.executionReceipt),
|
|
26
|
+
executableArtifact: normalizeDqlExecutableArtifactV1(record.executableArtifact),
|
|
26
27
|
filterableColumns: normalizeFilterableColumns(record.filterableColumns),
|
|
27
28
|
...(limit === undefined ? {} : { limit }),
|
|
28
29
|
};
|
|
29
30
|
}
|
|
31
|
+
export function normalizeDqlExecutableArtifactV1(value) {
|
|
32
|
+
const record = objectRecord(value);
|
|
33
|
+
if (!record || record.version !== 1)
|
|
34
|
+
return undefined;
|
|
35
|
+
const kind = normalizeDqlArtifactKind(record.kind);
|
|
36
|
+
const trustState = normalizeDqlArtifactTrustState(record.trustState);
|
|
37
|
+
const semanticAdapter = cleanString(record.semanticAdapter);
|
|
38
|
+
const preview = objectRecord(record.previewPolicy);
|
|
39
|
+
const previewMode = preview?.mode === 'read_only_bounded' || preview?.mode === 'compiler_governed'
|
|
40
|
+
? preview.mode
|
|
41
|
+
: undefined;
|
|
42
|
+
const receipt = normalizeExecutionReceipt(record.receipt);
|
|
43
|
+
const fingerprints = {
|
|
44
|
+
dqlFingerprint: normalizeFingerprint(record.dqlFingerprint),
|
|
45
|
+
sourceFingerprint: normalizeFingerprint(record.sourceFingerprint),
|
|
46
|
+
compiledSqlFingerprint: normalizeFingerprint(record.compiledSqlFingerprint),
|
|
47
|
+
normalizedSqlFingerprint: normalizeFingerprint(record.normalizedSqlFingerprint),
|
|
48
|
+
parameterFingerprint: normalizeFingerprint(record.parameterFingerprint),
|
|
49
|
+
provenanceFingerprint: normalizeFingerprint(record.provenanceFingerprint),
|
|
50
|
+
targetFingerprint: normalizeFingerprint(record.targetFingerprint),
|
|
51
|
+
snapshotFingerprint: normalizeFingerprint(record.snapshotFingerprint),
|
|
52
|
+
planFingerprint: normalizeFingerprint(record.planFingerprint),
|
|
53
|
+
};
|
|
54
|
+
if (!kind || !trustState || !semanticAdapter || !previewMode || !receipt
|
|
55
|
+
|| Object.values(fingerprints).some((fingerprint) => !fingerprint))
|
|
56
|
+
return undefined;
|
|
57
|
+
const rowLimit = finitePositiveInteger(preview?.rowLimit);
|
|
58
|
+
if (previewMode === 'read_only_bounded' && rowLimit === undefined)
|
|
59
|
+
return undefined;
|
|
60
|
+
return {
|
|
61
|
+
version: 1,
|
|
62
|
+
kind,
|
|
63
|
+
...fingerprints,
|
|
64
|
+
semanticAdapter,
|
|
65
|
+
previewPolicy: {
|
|
66
|
+
mode: previewMode,
|
|
67
|
+
...(rowLimit === undefined ? {} : { rowLimit }),
|
|
68
|
+
},
|
|
69
|
+
trustState,
|
|
70
|
+
receipt,
|
|
71
|
+
};
|
|
72
|
+
}
|
|
30
73
|
/**
|
|
31
74
|
* Executable source is receipt-bound byte-for-byte. Trimming it here makes a
|
|
32
75
|
* harmless final newline look like source drift on the next parameterized run.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"dql-artifact.js","sourceRoot":"","sources":["../../src/artifacts/dql-artifact.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"dql-artifact.js","sourceRoot":"","sources":["../../src/artifacts/dql-artifact.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
export { normalizeDqlArtifactKind, normalizeDqlArtifactReference, } from './dql-artifact.js';
|
|
2
|
-
export type { DqlArtifactFilter, DqlArtifactExecutionReceipt, DqlArtifactKind, DqlArtifactOrderBy, DqlArtifactPersistence, DqlArtifactReference, DqlArtifactTimeDimension, DqlArtifactTrustState, } from './dql-artifact.js';
|
|
1
|
+
export { normalizeDqlArtifactKind, normalizeDqlExecutableArtifactV1, normalizeDqlArtifactReference, } from './dql-artifact.js';
|
|
2
|
+
export type { DqlArtifactFilter, DqlArtifactExecutionReceipt, DqlExecutableArtifactV1, DqlArtifactKind, DqlArtifactOrderBy, DqlArtifactPersistence, DqlArtifactReference, DqlArtifactTimeDimension, DqlArtifactTrustState, } from './dql-artifact.js';
|
|
3
3
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/artifacts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,iBAAiB,EACjB,2BAA2B,EAC3B,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/artifacts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,gCAAgC,EAChC,6BAA6B,GAC9B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,iBAAiB,EACjB,2BAA2B,EAC3B,uBAAuB,EACvB,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC"}
|
package/dist/artifacts/index.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export { normalizeDqlArtifactKind, normalizeDqlArtifactReference, } from './dql-artifact.js';
|
|
1
|
+
export { normalizeDqlArtifactKind, normalizeDqlExecutableArtifactV1, normalizeDqlArtifactReference, } from './dql-artifact.js';
|
|
2
2
|
//# sourceMappingURL=index.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/artifacts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,mBAAmB,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/artifacts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,gCAAgC,EAChC,6BAA6B,GAC9B,MAAM,mBAAmB,CAAC"}
|
|
@@ -9,6 +9,8 @@
|
|
|
9
9
|
export declare const ANALYTICAL_QUESTION_FRAME_VERSION: 2;
|
|
10
10
|
export declare const ANALYTICAL_FAILURE_VERSION: 1;
|
|
11
11
|
export declare const ANALYTICAL_FAILURE_V2_VERSION: 2;
|
|
12
|
+
export declare const ANALYTICAL_REPAIR_CAPABILITY_VERSION: 1;
|
|
13
|
+
export declare const PROVIDER_EGRESS_RECEIPT_VERSION: 1;
|
|
12
14
|
export type AnalyticalDimensionRole = 'group_by' | 'filter' | 'display' | 'rank_entity' | 'time_axis';
|
|
13
15
|
export type AnalyticalQuestionType = 'definition' | 'scalar' | 'ranking' | 'trend' | 'comparison' | 'diagnosis' | 'research';
|
|
14
16
|
export type AnalyticalPeriodKind = 'absolute' | 'current' | 'previous_period' | 'previous_year';
|
|
@@ -81,6 +83,28 @@ export interface AnalyticalQuestionFrameV2 {
|
|
|
81
83
|
ambiguity: AnalyticalAmbiguityV2[];
|
|
82
84
|
}
|
|
83
85
|
export type AnalyticalOperation = 'filter' | 'group' | 'trend' | 'compare' | 'rank' | 'window' | 'having';
|
|
86
|
+
/**
|
|
87
|
+
* One immutable relationship authority selected with an analytical metric.
|
|
88
|
+
* DQL relationship IDs and adapter-native semantic paths remain distinct:
|
|
89
|
+
* only the former can authorize generated physical SQL joins.
|
|
90
|
+
*/
|
|
91
|
+
export interface ResolvedRelationshipProofV1 {
|
|
92
|
+
version: 1;
|
|
93
|
+
kind: 'dql_relationship_path' | 'semantic_native_grouping';
|
|
94
|
+
metricId: string;
|
|
95
|
+
dimensionId: string;
|
|
96
|
+
sourceEntityId: string;
|
|
97
|
+
targetEntityId: string;
|
|
98
|
+
route: MetricCapabilityContract['executionCapabilities'][number]['route'];
|
|
99
|
+
adapterId?: string;
|
|
100
|
+
executionId: string;
|
|
101
|
+
snapshotId: string;
|
|
102
|
+
capabilityFingerprint: string;
|
|
103
|
+
relationshipPathIds: string[];
|
|
104
|
+
nativeGroupingReference?: string;
|
|
105
|
+
nativeGroupingPath?: string[];
|
|
106
|
+
authorityFingerprint: string;
|
|
107
|
+
}
|
|
84
108
|
export interface MetricCapabilityContract {
|
|
85
109
|
metricId: string;
|
|
86
110
|
semanticModelId?: string;
|
|
@@ -100,6 +124,14 @@ export interface MetricCapabilityContract {
|
|
|
100
124
|
/** Entity grain produced/filtered by this dimension. */
|
|
101
125
|
entityId: string;
|
|
102
126
|
supportedRoles: AnalyticalDimensionRole[];
|
|
127
|
+
/** Authored semantic-layer display label; never inferred from the ID. */
|
|
128
|
+
label?: string;
|
|
129
|
+
/** Authored registry aliases retained for deterministic binding only. */
|
|
130
|
+
aliases?: string[];
|
|
131
|
+
/** Exact adapter-native group-by reference proved compatible for this metric. */
|
|
132
|
+
nativeGroupingReference?: string;
|
|
133
|
+
/** Exact adapter-native entity path; empty means the metric's own model. */
|
|
134
|
+
nativeGroupingPath?: string[];
|
|
103
135
|
relationshipPathIds?: string[];
|
|
104
136
|
}>;
|
|
105
137
|
timeDimensions: Array<{
|
|
@@ -187,6 +219,72 @@ export interface AnalyticalRepairTrustTransition {
|
|
|
187
219
|
requiresReview: boolean;
|
|
188
220
|
preservesCertifiedAssetIdentity: boolean;
|
|
189
221
|
}
|
|
222
|
+
export type AnalyticalAutomaticRepairAction = 'repair_embedded_sql' | 'none';
|
|
223
|
+
export type AnalyticalRepairCorrectionCode = 'SQL_EXECUTION_REPAIR' | 'MANUAL_REVIEW_REQUIRED';
|
|
224
|
+
export type AnalyticalManualRepairAction = 'edit_dql' | 'open_sql_notebook' | 'refresh_snapshot' | 'retry_same_plan' | 'change_authorized_connection' | 'request_access';
|
|
225
|
+
export type AnalyticalRepairIneligibilityReason = 'failure_not_eligible' | 'missing_failure_authority' | 'missing_dql_wrapper' | 'invalid_dql_wrapper' | 'missing_compiled_sql' | 'missing_plan_fingerprint' | 'missing_execution_target' | 'attempt_exhausted';
|
|
226
|
+
/**
|
|
227
|
+
* Server-owned authority for one automatic Ask execution repair.
|
|
228
|
+
*
|
|
229
|
+
* A retained warehouse diagnostic is deliberately absent: it may explain a
|
|
230
|
+
* failure, but it never grants repair authority. Legacy runs without this
|
|
231
|
+
* capability remain readable and are manual-only.
|
|
232
|
+
*/
|
|
233
|
+
export interface AnalyticalRepairCapabilityV1 {
|
|
234
|
+
version: 1;
|
|
235
|
+
automatic: {
|
|
236
|
+
eligible: boolean;
|
|
237
|
+
action: AnalyticalAutomaticRepairAction;
|
|
238
|
+
correctionCode: AnalyticalRepairCorrectionCode;
|
|
239
|
+
attemptsRemaining: number;
|
|
240
|
+
};
|
|
241
|
+
failureFingerprint: string;
|
|
242
|
+
sourceFingerprint: string;
|
|
243
|
+
planFingerprint: string;
|
|
244
|
+
dqlFingerprint: string;
|
|
245
|
+
sqlFingerprint: string;
|
|
246
|
+
targetFingerprint: string;
|
|
247
|
+
routeLocked: true;
|
|
248
|
+
targetLocked: true;
|
|
249
|
+
sourceImmutable: true;
|
|
250
|
+
manualActions: AnalyticalManualRepairAction[];
|
|
251
|
+
ineligibilityReason?: AnalyticalRepairIneligibilityReason;
|
|
252
|
+
}
|
|
253
|
+
export type ProviderEgressPurpose = 'answer_generation'
|
|
254
|
+
/** Ordinary Ask narration: the provider writes the business-facing answer. */
|
|
255
|
+
| 'answer_narration' | 'research_narration' | 'research_tool' | 'repair_sql';
|
|
256
|
+
export type ProviderEgressCategory = 'instructions' | 'question' | 'schema_metadata' | 'governed_context' | 'result_rows';
|
|
257
|
+
/** Server-owned orchestration phase for one physical provider dispatch. */
|
|
258
|
+
export type ProviderDispatchPhaseV1 = 'meaning_resolution' | 'planning' | 'generation' | 'narration' | 'repair';
|
|
259
|
+
/** Content-free evidence for one provider-bound payload class. */
|
|
260
|
+
export interface ProviderEgressReceiptV1 {
|
|
261
|
+
version: 1;
|
|
262
|
+
purpose: ProviderEgressPurpose;
|
|
263
|
+
/** Additive for legacy compatibility; absent means the phase was not recorded. */
|
|
264
|
+
dispatchPhase?: ProviderDispatchPhaseV1;
|
|
265
|
+
provider: string;
|
|
266
|
+
/** Exact physical transport identity; absent only on legacy receipts. */
|
|
267
|
+
model?: string;
|
|
268
|
+
operation?: 'generate' | 'generate_with_tools' | 'generate_stream';
|
|
269
|
+
attemptIndex?: number;
|
|
270
|
+
options?: {
|
|
271
|
+
maxTokens?: number;
|
|
272
|
+
temperature?: number;
|
|
273
|
+
reasoningEffort?: 'low' | 'medium' | 'high';
|
|
274
|
+
};
|
|
275
|
+
permittedCategories: ProviderEgressCategory[];
|
|
276
|
+
resultRowCount: number;
|
|
277
|
+
/** Rows disclosed so far in this receipt's per-run budget group. */
|
|
278
|
+
cumulativeResultRowCount?: number;
|
|
279
|
+
columnCount: number;
|
|
280
|
+
redactionPolicyId: string;
|
|
281
|
+
optIn: boolean;
|
|
282
|
+
payloadFingerprint: string;
|
|
283
|
+
}
|
|
284
|
+
/** Strictly normalize server-owned automatic repair authority. */
|
|
285
|
+
export declare function normalizeAnalyticalRepairCapabilityV1(value: unknown): AnalyticalRepairCapabilityV1 | undefined;
|
|
286
|
+
/** Strictly normalize a content-free provider egress receipt. */
|
|
287
|
+
export declare function normalizeProviderEgressReceiptV1(value: unknown): ProviderEgressReceiptV1 | undefined;
|
|
190
288
|
/** Strictly normalize an untrusted cross-surface analytical frame. */
|
|
191
289
|
export declare function normalizeAnalyticalQuestionFrameV2(value: unknown): AnalyticalQuestionFrameV2 | undefined;
|
|
192
290
|
/** Strictly normalize capability metadata before it becomes routing evidence. */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"analytical.d.ts","sourceRoot":"","sources":["../../src/contracts/analytical.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,iCAAiC,EAAG,CAAU,CAAC;AAC5D,eAAO,MAAM,0BAA0B,EAAG,CAAU,CAAC;AACrD,eAAO,MAAM,6BAA6B,EAAG,CAAU,CAAC;
|
|
1
|
+
{"version":3,"file":"analytical.d.ts","sourceRoot":"","sources":["../../src/contracts/analytical.ts"],"names":[],"mappings":"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"}
|
|
@@ -9,8 +9,17 @@
|
|
|
9
9
|
export const ANALYTICAL_QUESTION_FRAME_VERSION = 2;
|
|
10
10
|
export const ANALYTICAL_FAILURE_VERSION = 1;
|
|
11
11
|
export const ANALYTICAL_FAILURE_V2_VERSION = 2;
|
|
12
|
+
export const ANALYTICAL_REPAIR_CAPABILITY_VERSION = 1;
|
|
13
|
+
export const PROVIDER_EGRESS_RECEIPT_VERSION = 1;
|
|
12
14
|
const DIMENSION_ROLES = new Set(['group_by', 'filter', 'display', 'rank_entity', 'time_axis']);
|
|
13
15
|
const QUESTION_TYPES = new Set(['definition', 'scalar', 'ranking', 'trend', 'comparison', 'diagnosis', 'research']);
|
|
16
|
+
const PROVIDER_DISPATCH_PHASES = new Set([
|
|
17
|
+
'meaning_resolution',
|
|
18
|
+
'planning',
|
|
19
|
+
'generation',
|
|
20
|
+
'narration',
|
|
21
|
+
'repair',
|
|
22
|
+
]);
|
|
14
23
|
const PERIOD_KINDS = new Set(['absolute', 'current', 'previous_period', 'previous_year']);
|
|
15
24
|
const COMPLETENESS_POLICIES = new Set(['partial_current', 'latest_complete', 'closed_period']);
|
|
16
25
|
const FAILURE_CODES = new Set([
|
|
@@ -48,6 +57,183 @@ const RECOVERABILITY = new Set([
|
|
|
48
57
|
'modeling_change',
|
|
49
58
|
'none',
|
|
50
59
|
]);
|
|
60
|
+
const AUTOMATIC_REPAIR_ACTIONS = new Set(['repair_embedded_sql', 'none']);
|
|
61
|
+
const REPAIR_CORRECTION_CODES = new Set(['SQL_EXECUTION_REPAIR', 'MANUAL_REVIEW_REQUIRED']);
|
|
62
|
+
const MANUAL_REPAIR_ACTIONS = new Set([
|
|
63
|
+
'edit_dql',
|
|
64
|
+
'open_sql_notebook',
|
|
65
|
+
'refresh_snapshot',
|
|
66
|
+
'retry_same_plan',
|
|
67
|
+
'change_authorized_connection',
|
|
68
|
+
'request_access',
|
|
69
|
+
]);
|
|
70
|
+
const REPAIR_INELIGIBILITY_REASONS = new Set([
|
|
71
|
+
'failure_not_eligible',
|
|
72
|
+
'missing_failure_authority',
|
|
73
|
+
'missing_dql_wrapper',
|
|
74
|
+
'invalid_dql_wrapper',
|
|
75
|
+
'missing_compiled_sql',
|
|
76
|
+
'missing_plan_fingerprint',
|
|
77
|
+
'missing_execution_target',
|
|
78
|
+
'attempt_exhausted',
|
|
79
|
+
]);
|
|
80
|
+
const PROVIDER_EGRESS_PURPOSES = new Set([
|
|
81
|
+
'answer_generation',
|
|
82
|
+
'answer_narration',
|
|
83
|
+
'research_narration',
|
|
84
|
+
'research_tool',
|
|
85
|
+
'repair_sql',
|
|
86
|
+
]);
|
|
87
|
+
const PROVIDER_EGRESS_CATEGORIES = new Set([
|
|
88
|
+
'instructions',
|
|
89
|
+
'question',
|
|
90
|
+
'schema_metadata',
|
|
91
|
+
'governed_context',
|
|
92
|
+
'result_rows',
|
|
93
|
+
]);
|
|
94
|
+
/** Strictly normalize server-owned automatic repair authority. */
|
|
95
|
+
export function normalizeAnalyticalRepairCapabilityV1(value) {
|
|
96
|
+
const record = objectRecord(value);
|
|
97
|
+
const automatic = objectRecord(record?.automatic);
|
|
98
|
+
const action = enumValue(automatic?.action, AUTOMATIC_REPAIR_ACTIONS);
|
|
99
|
+
const correctionCode = enumValue(automatic?.correctionCode, REPAIR_CORRECTION_CODES);
|
|
100
|
+
const attemptsRemaining = automatic?.attemptsRemaining;
|
|
101
|
+
const rawManualActions = Array.isArray(record?.manualActions) ? record.manualActions : undefined;
|
|
102
|
+
const manualActions = rawManualActions
|
|
103
|
+
? rawManualActions.flatMap((item) => {
|
|
104
|
+
const action = enumValue(item, MANUAL_REPAIR_ACTIONS);
|
|
105
|
+
return action ? [action] : [];
|
|
106
|
+
})
|
|
107
|
+
: undefined;
|
|
108
|
+
const ineligibilityReason = record?.ineligibilityReason === undefined
|
|
109
|
+
? undefined
|
|
110
|
+
: enumValue(record.ineligibilityReason, REPAIR_INELIGIBILITY_REASONS);
|
|
111
|
+
if (!record
|
|
112
|
+
|| record.version !== ANALYTICAL_REPAIR_CAPABILITY_VERSION
|
|
113
|
+
|| !automatic
|
|
114
|
+
|| typeof automatic.eligible !== 'boolean'
|
|
115
|
+
|| !action
|
|
116
|
+
|| !correctionCode
|
|
117
|
+
|| typeof attemptsRemaining !== 'number'
|
|
118
|
+
|| !Number.isInteger(attemptsRemaining)
|
|
119
|
+
|| attemptsRemaining < 0
|
|
120
|
+
|| !manualActions
|
|
121
|
+
|| manualActions.length !== rawManualActions?.length
|
|
122
|
+
|| (record.ineligibilityReason !== undefined && !ineligibilityReason)
|
|
123
|
+
|| record.routeLocked !== true
|
|
124
|
+
|| record.targetLocked !== true
|
|
125
|
+
|| record.sourceImmutable !== true)
|
|
126
|
+
return undefined;
|
|
127
|
+
const failureFingerprint = cleanString(record.failureFingerprint);
|
|
128
|
+
const sourceFingerprint = cleanString(record.sourceFingerprint);
|
|
129
|
+
const planFingerprint = cleanString(record.planFingerprint);
|
|
130
|
+
const dqlFingerprint = cleanString(record.dqlFingerprint);
|
|
131
|
+
const sqlFingerprint = cleanString(record.sqlFingerprint);
|
|
132
|
+
const targetFingerprint = cleanString(record.targetFingerprint);
|
|
133
|
+
if (!failureFingerprint || !sourceFingerprint || !planFingerprint || !dqlFingerprint || !sqlFingerprint || !targetFingerprint)
|
|
134
|
+
return undefined;
|
|
135
|
+
if (automatic.eligible && (action !== 'repair_embedded_sql' || correctionCode !== 'SQL_EXECUTION_REPAIR' || attemptsRemaining < 1 || ineligibilityReason))
|
|
136
|
+
return undefined;
|
|
137
|
+
if (!automatic.eligible && (action !== 'none' || correctionCode !== 'MANUAL_REVIEW_REQUIRED' || attemptsRemaining !== 0 || !ineligibilityReason))
|
|
138
|
+
return undefined;
|
|
139
|
+
return {
|
|
140
|
+
version: ANALYTICAL_REPAIR_CAPABILITY_VERSION,
|
|
141
|
+
automatic: { eligible: automatic.eligible, action, correctionCode, attemptsRemaining },
|
|
142
|
+
failureFingerprint,
|
|
143
|
+
sourceFingerprint,
|
|
144
|
+
planFingerprint,
|
|
145
|
+
dqlFingerprint,
|
|
146
|
+
sqlFingerprint,
|
|
147
|
+
targetFingerprint,
|
|
148
|
+
routeLocked: true,
|
|
149
|
+
targetLocked: true,
|
|
150
|
+
sourceImmutable: true,
|
|
151
|
+
manualActions,
|
|
152
|
+
...(ineligibilityReason ? { ineligibilityReason } : {}),
|
|
153
|
+
};
|
|
154
|
+
}
|
|
155
|
+
/** Strictly normalize a content-free provider egress receipt. */
|
|
156
|
+
export function normalizeProviderEgressReceiptV1(value) {
|
|
157
|
+
const record = objectRecord(value);
|
|
158
|
+
const purpose = enumValue(record?.purpose, PROVIDER_EGRESS_PURPOSES);
|
|
159
|
+
const dispatchPhase = record?.dispatchPhase === undefined
|
|
160
|
+
? undefined
|
|
161
|
+
: enumValue(record.dispatchPhase, PROVIDER_DISPATCH_PHASES);
|
|
162
|
+
const provider = cleanString(record?.provider);
|
|
163
|
+
const model = cleanString(record?.model);
|
|
164
|
+
const operation = record?.operation === 'generate'
|
|
165
|
+
|| record?.operation === 'generate_with_tools'
|
|
166
|
+
|| record?.operation === 'generate_stream'
|
|
167
|
+
? record.operation
|
|
168
|
+
: undefined;
|
|
169
|
+
const attemptIndex = record?.attemptIndex;
|
|
170
|
+
const optionsRecord = objectRecord(record?.options);
|
|
171
|
+
const options = optionsRecord ? {
|
|
172
|
+
...(typeof optionsRecord.maxTokens === 'number' && Number.isInteger(optionsRecord.maxTokens) && optionsRecord.maxTokens > 0
|
|
173
|
+
? { maxTokens: optionsRecord.maxTokens }
|
|
174
|
+
: {}),
|
|
175
|
+
...(typeof optionsRecord.temperature === 'number' && Number.isFinite(optionsRecord.temperature)
|
|
176
|
+
? { temperature: optionsRecord.temperature }
|
|
177
|
+
: {}),
|
|
178
|
+
...(optionsRecord.reasoningEffort === 'low' || optionsRecord.reasoningEffort === 'medium' || optionsRecord.reasoningEffort === 'high'
|
|
179
|
+
? { reasoningEffort: optionsRecord.reasoningEffort }
|
|
180
|
+
: {}),
|
|
181
|
+
} : undefined;
|
|
182
|
+
const rawCategories = Array.isArray(record?.permittedCategories) ? record.permittedCategories : undefined;
|
|
183
|
+
const categories = rawCategories
|
|
184
|
+
? rawCategories.flatMap((item) => {
|
|
185
|
+
const category = enumValue(item, PROVIDER_EGRESS_CATEGORIES);
|
|
186
|
+
return category ? [category] : [];
|
|
187
|
+
})
|
|
188
|
+
: undefined;
|
|
189
|
+
const resultRowCount = record?.resultRowCount;
|
|
190
|
+
const columnCount = record?.columnCount;
|
|
191
|
+
const cumulativeResultRowCount = record?.cumulativeResultRowCount;
|
|
192
|
+
const redactionPolicyId = cleanString(record?.redactionPolicyId);
|
|
193
|
+
const payloadFingerprint = cleanString(record?.payloadFingerprint);
|
|
194
|
+
if (!record
|
|
195
|
+
|| record.version !== PROVIDER_EGRESS_RECEIPT_VERSION
|
|
196
|
+
|| !purpose
|
|
197
|
+
|| (record.dispatchPhase !== undefined && !dispatchPhase)
|
|
198
|
+
|| !provider
|
|
199
|
+
|| (record.operation !== undefined && !operation)
|
|
200
|
+
|| (record.attemptIndex !== undefined && (typeof attemptIndex !== 'number' || !Number.isInteger(attemptIndex) || attemptIndex < 1))
|
|
201
|
+
|| (record.options !== undefined && !optionsRecord)
|
|
202
|
+
|| !categories
|
|
203
|
+
|| categories.length !== rawCategories?.length
|
|
204
|
+
|| typeof resultRowCount !== 'number'
|
|
205
|
+
|| !Number.isInteger(resultRowCount)
|
|
206
|
+
|| resultRowCount < 0
|
|
207
|
+
|| (cumulativeResultRowCount !== undefined && (typeof cumulativeResultRowCount !== 'number'
|
|
208
|
+
|| !Number.isInteger(cumulativeResultRowCount)
|
|
209
|
+
|| cumulativeResultRowCount < resultRowCount))
|
|
210
|
+
|| typeof columnCount !== 'number'
|
|
211
|
+
|| !Number.isInteger(columnCount)
|
|
212
|
+
|| columnCount < 0
|
|
213
|
+
|| !redactionPolicyId
|
|
214
|
+
|| typeof record.optIn !== 'boolean'
|
|
215
|
+
|| !payloadFingerprint)
|
|
216
|
+
return undefined;
|
|
217
|
+
if (resultRowCount > 0 && (!record.optIn || !categories.includes('result_rows')))
|
|
218
|
+
return undefined;
|
|
219
|
+
return {
|
|
220
|
+
version: PROVIDER_EGRESS_RECEIPT_VERSION,
|
|
221
|
+
...(dispatchPhase ? { dispatchPhase } : {}),
|
|
222
|
+
purpose,
|
|
223
|
+
provider,
|
|
224
|
+
...(model ? { model } : {}),
|
|
225
|
+
...(operation ? { operation } : {}),
|
|
226
|
+
...(typeof attemptIndex === 'number' ? { attemptIndex } : {}),
|
|
227
|
+
...(options ? { options } : {}),
|
|
228
|
+
permittedCategories: categories,
|
|
229
|
+
resultRowCount,
|
|
230
|
+
...(typeof cumulativeResultRowCount === 'number' ? { cumulativeResultRowCount } : {}),
|
|
231
|
+
columnCount,
|
|
232
|
+
redactionPolicyId,
|
|
233
|
+
optIn: record.optIn,
|
|
234
|
+
payloadFingerprint,
|
|
235
|
+
};
|
|
236
|
+
}
|
|
51
237
|
/** Strictly normalize an untrusted cross-surface analytical frame. */
|
|
52
238
|
export function normalizeAnalyticalQuestionFrameV2(value) {
|
|
53
239
|
const record = objectRecord(value);
|
|
@@ -457,14 +643,31 @@ function normalizeCapabilityDimensions(value) {
|
|
|
457
643
|
const normalized = enumValue(role, DIMENSION_ROLES);
|
|
458
644
|
return normalized ? [normalized] : [];
|
|
459
645
|
});
|
|
646
|
+
const label = record.label === undefined ? undefined : cleanString(record.label);
|
|
647
|
+
const aliases = record.aliases === undefined ? undefined : cleanStringArray(record.aliases);
|
|
648
|
+
const nativeGroupingReference = record.nativeGroupingReference === undefined
|
|
649
|
+
? undefined
|
|
650
|
+
: cleanString(record.nativeGroupingReference);
|
|
651
|
+
const nativeGroupingPath = record.nativeGroupingPath === undefined
|
|
652
|
+
? undefined
|
|
653
|
+
: cleanStringArray(record.nativeGroupingPath);
|
|
460
654
|
const relationshipPathIds = record.relationshipPathIds === undefined ? undefined : cleanStringArray(record.relationshipPathIds);
|
|
461
|
-
if (supportedRoles.length !== record.supportedRoles.length
|
|
655
|
+
if (supportedRoles.length !== record.supportedRoles.length
|
|
656
|
+
|| (record.label !== undefined && !label)
|
|
657
|
+
|| (record.aliases !== undefined && !aliases)
|
|
658
|
+
|| (record.nativeGroupingReference !== undefined && !nativeGroupingReference)
|
|
659
|
+
|| (record.nativeGroupingPath !== undefined && !nativeGroupingPath)
|
|
660
|
+
|| (record.relationshipPathIds !== undefined && !relationshipPathIds))
|
|
462
661
|
return [];
|
|
463
662
|
return [
|
|
464
663
|
{
|
|
465
664
|
dimensionId,
|
|
466
665
|
entityId,
|
|
467
666
|
supportedRoles,
|
|
667
|
+
...(label ? { label } : {}),
|
|
668
|
+
...(aliases ? { aliases } : {}),
|
|
669
|
+
...(nativeGroupingReference ? { nativeGroupingReference } : {}),
|
|
670
|
+
...(nativeGroupingPath ? { nativeGroupingPath } : {}),
|
|
468
671
|
...(relationshipPathIds ? { relationshipPathIds } : {}),
|
|
469
672
|
},
|
|
470
673
|
];
|