@duckcodeailabs/dql-agent 1.6.8 → 1.6.10

package/dist/metadata/analysis-planner.d.ts

@@ -0,0 +1,52 @@
+import type { MetadataAgentIntent, MetadataAllowedSqlContext, MetadataObject } from './catalog.js';
+export type AnalysisQuestionMode = 'exact_lookup' | 'definition' | 'ranking' | 'entity_profile' | 'entity_drilldown' | 'trend' | 'comparison' | 'driver_breakdown' | 'diagnose_change' | 'anomaly' | 'trust_review' | 'general_analysis' | 'clarify';
+export interface AnalysisEntityMention {
+    text: string;
+    source: 'quoted' | 'named_entity' | 'explicit_filter' | 'email' | 'id';
+    typeHint?: string;
+}
+export interface AnalysisQuestionPlan {
+    question: string;
+    normalizedQuestion: string;
+    mode: AnalysisQuestionMode;
+    routeIntent: MetadataAgentIntent;
+    entities: AnalysisEntityMention[];
+    metricTerms: string[];
+    dimensionTerms: string[];
+    filterTerms: string[];
+    timeTerms: string[];
+    outputShape: 'value' | 'table' | 'chart' | 'profile' | 'narrative';
+    needsGeneratedSql: boolean;
+    shouldConsiderCertifiedExact: boolean;
+    needsResearchWorkspace: boolean;
+    searchQueries: string[];
+    searchTerms: string[];
+    confidence: number;
+    reasons: string[];
+}
+export type CertifiedApplicabilityKind = 'exact_answer' | 'safe_parameterized' | 'context_only' | 'not_applicable';
+export interface CertifiedBlockApplicability {
+    objectKey: string;
+    name: string;
+    kind: CertifiedApplicabilityKind;
+    score: number;
+    reasons: string[];
+}
+export interface AllowedSqlRelationScore {
+    relation: string;
+    name: string;
+    source: string;
+    score: number;
+    reasons: string[];
+}
+export declare function buildAnalysisQuestionPlan(question: string, followUp?: unknown): AnalysisQuestionPlan;
+export declare function certifiedApplicabilityForObject(object: MetadataObject, plan: AnalysisQuestionPlan): CertifiedBlockApplicability;
+export declare function scoreMetadataObjectWithAnalysisPlan(object: MetadataObject, plan: AnalysisQuestionPlan): {
+    score: number;
+    reasons: string[];
+};
+export declare function sortAllowedSqlContextForAnalysisPlan(context: MetadataAllowedSqlContext, plan: AnalysisQuestionPlan, options?: {
+    maxRelations?: number;
+}): MetadataAllowedSqlContext;
+export declare function scoreAllowedSqlRelationWithAnalysisPlan(relation: MetadataAllowedSqlContext['relations'][number], plan: AnalysisQuestionPlan): AllowedSqlRelationScore;
+//# sourceMappingURL=analysis-planner.d.ts.map

package/dist/metadata/analysis-planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-planner.d.ts","sourceRoot":"","sources":["../../src/metadata/analysis-planner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EACzB,cAAc,EACf,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,oBAAoB,GAC5B,cAAc,GACd,YAAY,GACZ,SAAS,GACT,gBAAgB,GAChB,kBAAkB,GAClB,OAAO,GACP,YAAY,GACZ,kBAAkB,GAClB,iBAAiB,GACjB,SAAS,GACT,cAAc,GACd,kBAAkB,GAClB,SAAS,CAAC;AAEd,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,GAAG,cAAc,GAAG,iBAAiB,GAAG,OAAO,GAAG,IAAI,CAAC;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,WAAW,EAAE,mBAAmB,CAAC;IACjC,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAClC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;IACnE,iBAAiB,EAAE,OAAO,CAAC;IAC3B,4BAA4B,EAAE,OAAO,CAAC;IACtC,sBAAsB,EAAE,OAAO,CAAC;IAChC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,MAAM,0BAA0B,GAClC,cAAc,GACd,oBAAoB,GACpB,cAAc,GACd,gBAAgB,CAAC;AAErB,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,0BAA0B,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAkCD,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,OAAO,GACjB,oBAAoB,CAuDtB;AAED,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,oBAAoB,GACzB,2BAA2B,CAmF7B;AAED,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,oBAAoB,GACzB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAyBtC;AAED,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,yBAAyB,EAClC,IAAI,EAAE,oBAAoB,EAC1B,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GACtC,yBAAyB,CAW3B;AAED,wBAAgB,uCAAuC,CACrD,QAAQ,EAAE,yBAAyB,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,EACxD,IAAI,EAAE,oBAAoB,GACzB,uBAAuB,CAkDzB"}