@duckcodeailabs/dql-mcp 1.6.30 → 1.6.32

package/dist/tools/query-semantic-model.d.ts

@@ -0,0 +1,374 @@
+import { type ComposeQueryOptions, type DqlArtifactReference } from '@duckcodeailabs/dql-core';
+import { type GeneratedDraftBlock } from '@duckcodeailabs/dql-agent';
+import type { DQLContext } from '../context.js';
+export declare const querySemanticModelInput: Record<string, import("zod").ZodTypeAny>;
+export declare function querySemanticModel(ctx: DQLContext, args: {
+    question?: string;
+    metrics?: string[];
+    dimensions?: string[];
+    timeDimension?: {
+        name: string;
+        granularity: string;
+    };
+    filters?: Array<{
+        dimension: string;
+        operator: string;
+        values: string[];
+    }>;
+    orderBy?: Array<{
+        name: string;
+        direction: 'asc' | 'desc';
+    }>;
+    limit?: number;
+    rowLimit?: number;
+    saveDraft?: boolean;
+    dryRun?: boolean;
+    serverUrl?: string;
+    driver?: string;
+    tableMapping?: Record<string, string>;
+}): Promise<{
+    matched: boolean;
+    reason: string;
+    available: {
+        metrics: {
+            name: string;
+            label: string;
+            domain: string;
+            status: string | undefined;
+            table: string;
+            type: "custom" | "sum" | "count" | "count_distinct" | "avg" | "min" | "max";
+            description: string;
+        }[];
+        dimensions: {
+            name: string;
+            label: string;
+            domain: string | undefined;
+            status: string | undefined;
+            table: string;
+            type: "string" | "number" | "boolean" | "date";
+            isTimeDimension: boolean | undefined;
+            description: string;
+        }[];
+    };
+    requested?: undefined;
+} | {
+    matched: boolean;
+    reason: string;
+    requested: ComposeQueryOptions;
+    available: {
+        metrics: {
+            name: string;
+            label: string;
+            domain: string;
+            status: string | undefined;
+            table: string;
+            type: "custom" | "sum" | "count" | "count_distinct" | "avg" | "min" | "max";
+            description: string;
+        }[];
+        dimensions: {
+            name: string;
+            label: string;
+            domain: string | undefined;
+            status: string | undefined;
+            table: string;
+            type: "string" | "number" | "boolean" | "date";
+            isTimeDimension: boolean | undefined;
+            description: string;
+        }[];
+    };
+} | {
+    draftBlock: GeneratedDraftBlock | undefined;
+    dqlArtifact: DqlArtifactReference & {
+        kind: "semantic_block";
+    };
+    executionStatus: string;
+    reason: string;
+    maxRowsReturned: number;
+    error?: undefined;
+    rowCount?: undefined;
+    returnedRowCount?: undefined;
+    rowsTruncated?: undefined;
+    durationMs?: undefined;
+    columns?: undefined;
+    rows?: undefined;
+    sql: string;
+    composeResult: import("@duckcodeailabs/dql-core").ComposeQueryResult;
+    limit?: number | undefined;
+    orderBy?: {
+        name: string;
+        direction: "asc" | "desc";
+    }[] | undefined;
+    timeDimension?: {
+        name: string;
+        granularity: string;
+    } | undefined;
+    matched: boolean;
+    uncertified: boolean;
+    reviewStatus: string;
+    certification: string;
+    trustLabelInfo: import("@duckcodeailabs/dql-core").ResolvedTrustLabel;
+    trustStatus: {
+        label: string;
+        uncertified: boolean;
+        reviewStatus: string;
+        certification: string;
+        trustLabelInfo: import("@duckcodeailabs/dql-core").ResolvedTrustLabel;
+        draftPath: string | undefined;
+        promotionPath: string | undefined;
+        caveats: string[];
+    };
+    mode: string;
+    metrics: string[];
+    dimensions: string[];
+    filters: {
+        dimension: string;
+        operator: string;
+        values: string[];
+    }[];
+    available?: undefined;
+    requested?: undefined;
+} | {
+    draftBlock: GeneratedDraftBlock | undefined;
+    dqlArtifact: DqlArtifactReference & {
+        kind: "semantic_block";
+    };
+    executionStatus: string;
+    error: string;
+    maxRowsReturned: number;
+    reason?: undefined;
+    rowCount?: undefined;
+    returnedRowCount?: undefined;
+    rowsTruncated?: undefined;
+    durationMs?: undefined;
+    columns?: undefined;
+    rows?: undefined;
+    sql: string;
+    composeResult: import("@duckcodeailabs/dql-core").ComposeQueryResult;
+    limit?: number | undefined;
+    orderBy?: {
+        name: string;
+        direction: "asc" | "desc";
+    }[] | undefined;
+    timeDimension?: {
+        name: string;
+        granularity: string;
+    } | undefined;
+    matched: boolean;
+    uncertified: boolean;
+    reviewStatus: string;
+    certification: string;
+    trustLabelInfo: import("@duckcodeailabs/dql-core").ResolvedTrustLabel;
+    trustStatus: {
+        label: string;
+        uncertified: boolean;
+        reviewStatus: string;
+        certification: string;
+        trustLabelInfo: import("@duckcodeailabs/dql-core").ResolvedTrustLabel;
+        draftPath: string | undefined;
+        promotionPath: string | undefined;
+        caveats: string[];
+    };
+    mode: string;
+    metrics: string[];
+    dimensions: string[];
+    filters: {
+        dimension: string;
+        operator: string;
+        values: string[];
+    }[];
+    available?: undefined;
+    requested?: undefined;
+} | {
+    draftBlock: GeneratedDraftBlock | undefined;
+    dqlArtifact: DqlArtifactReference & {
+        kind: "semantic_block";
+    };
+    executionStatus: string;
+    rowCount: number;
+    returnedRowCount: number;
+    maxRowsReturned: number;
+    rowsTruncated: boolean;
+    durationMs: number | null;
+    columns: {
+        name: string;
+        type?: string;
+    }[];
+    rows: unknown[];
+    reason?: undefined;
+    error?: undefined;
+    sql: string;
+    composeResult: import("@duckcodeailabs/dql-core").ComposeQueryResult;
+    limit?: number | undefined;
+    orderBy?: {
+        name: string;
+        direction: "asc" | "desc";
+    }[] | undefined;
+    timeDimension?: {
+        name: string;
+        granularity: string;
+    } | undefined;
+    matched: boolean;
+    uncertified: boolean;
+    reviewStatus: string;
+    certification: string;
+    trustLabelInfo: import("@duckcodeailabs/dql-core").ResolvedTrustLabel;
+    trustStatus: {
+        label: string;
+        uncertified: boolean;
+        reviewStatus: string;
+        certification: string;
+        trustLabelInfo: import("@duckcodeailabs/dql-core").ResolvedTrustLabel;
+        draftPath: string | undefined;
+        promotionPath: string | undefined;
+        caveats: string[];
+    };
+    mode: string;
+    metrics: string[];
+    dimensions: string[];
+    filters: {
+        dimension: string;
+        operator: string;
+        values: string[];
+    }[];
+    available?: undefined;
+    requested?: undefined;
+} | {
+    draftBlock: GeneratedDraftBlock | undefined;
+    dqlArtifact: DqlArtifactReference & {
+        kind: "semantic_block";
+    };
+    executionStatus: string;
+    reason: string;
+    maxRowsReturned: number;
+    error?: undefined;
+    rowCount?: undefined;
+    returnedRowCount?: undefined;
+    rowsTruncated?: undefined;
+    durationMs?: undefined;
+    columns?: undefined;
+    rows?: undefined;
+    sql: string;
+    composeResult: import("@duckcodeailabs/dql-core").ComposeQueryResult;
+    limit?: number | undefined;
+    orderBy?: import("@duckcodeailabs/dql-agent").SemanticBridgeOrderBy[] | undefined;
+    timeDimension?: {
+        name: string;
+        granularity: string;
+    } | undefined;
+    matched: boolean;
+    uncertified: boolean;
+    reviewStatus: string;
+    certification: string;
+    trustLabelInfo: import("@duckcodeailabs/dql-core").ResolvedTrustLabel;
+    trustStatus: {
+        label: string;
+        uncertified: boolean;
+        reviewStatus: string;
+        certification: string;
+        trustLabelInfo: import("@duckcodeailabs/dql-core").ResolvedTrustLabel;
+        draftPath: string | undefined;
+        promotionPath: string | undefined;
+        caveats: string[];
+    };
+    mode: string;
+    metric: string;
+    metrics: string[];
+    dimensions: string[];
+    filters: import("@duckcodeailabs/dql-agent").SemanticBridgeFilter[];
+    available?: undefined;
+    requested?: undefined;
+} | {
+    draftBlock: GeneratedDraftBlock | undefined;
+    dqlArtifact: DqlArtifactReference & {
+        kind: "semantic_block";
+    };
+    executionStatus: string;
+    error: string;
+    maxRowsReturned: number;
+    reason?: undefined;
+    rowCount?: undefined;
+    returnedRowCount?: undefined;
+    rowsTruncated?: undefined;
+    durationMs?: undefined;
+    columns?: undefined;
+    rows?: undefined;
+    sql: string;
+    composeResult: import("@duckcodeailabs/dql-core").ComposeQueryResult;
+    limit?: number | undefined;
+    orderBy?: import("@duckcodeailabs/dql-agent").SemanticBridgeOrderBy[] | undefined;
+    timeDimension?: {
+        name: string;
+        granularity: string;
+    } | undefined;
+    matched: boolean;
+    uncertified: boolean;
+    reviewStatus: string;
+    certification: string;
+    trustLabelInfo: import("@duckcodeailabs/dql-core").ResolvedTrustLabel;
+    trustStatus: {
+        label: string;
+        uncertified: boolean;
+        reviewStatus: string;
+        certification: string;
+        trustLabelInfo: import("@duckcodeailabs/dql-core").ResolvedTrustLabel;
+        draftPath: string | undefined;
+        promotionPath: string | undefined;
+        caveats: string[];
+    };
+    mode: string;
+    metric: string;
+    metrics: string[];
+    dimensions: string[];
+    filters: import("@duckcodeailabs/dql-agent").SemanticBridgeFilter[];
+    available?: undefined;
+    requested?: undefined;
+} | {
+    draftBlock: GeneratedDraftBlock | undefined;
+    dqlArtifact: DqlArtifactReference & {
+        kind: "semantic_block";
+    };
+    executionStatus: string;
+    rowCount: number;
+    returnedRowCount: number;
+    maxRowsReturned: number;
+    rowsTruncated: boolean;
+    durationMs: number | null;
+    columns: {
+        name: string;
+        type?: string;
+    }[];
+    rows: unknown[];
+    reason?: undefined;
+    error?: undefined;
+    sql: string;
+    composeResult: import("@duckcodeailabs/dql-core").ComposeQueryResult;
+    limit?: number | undefined;
+    orderBy?: import("@duckcodeailabs/dql-agent").SemanticBridgeOrderBy[] | undefined;
+    timeDimension?: {
+        name: string;
+        granularity: string;
+    } | undefined;
+    matched: boolean;
+    uncertified: boolean;
+    reviewStatus: string;
+    certification: string;
+    trustLabelInfo: import("@duckcodeailabs/dql-core").ResolvedTrustLabel;
+    trustStatus: {
+        label: string;
+        uncertified: boolean;
+        reviewStatus: string;
+        certification: string;
+        trustLabelInfo: import("@duckcodeailabs/dql-core").ResolvedTrustLabel;
+        draftPath: string | undefined;
+        promotionPath: string | undefined;
+        caveats: string[];
+    };
+    mode: string;
+    metric: string;
+    metrics: string[];
+    dimensions: string[];
+    filters: import("@duckcodeailabs/dql-agent").SemanticBridgeFilter[];
+    available?: undefined;
+    requested?: undefined;
+}>;
+//# sourceMappingURL=query-semantic-model.d.ts.map

package/dist/tools/query-semantic-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-semantic-model.d.ts","sourceRoot":"","sources":["../../src/tools/query-semantic-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EAE1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAML,KAAK,mBAAmB,EACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,eAAO,MAAM,uBAAuB,0CAA+C,CAAC;AAIpF,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,UAAU,EACf,IAAI,EAAE;IACJ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC3E,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA6CmD,gBAAgB;;;;;;;;;;;;;;;;cArD1C,MAAM;mBAAa,KAAK,GAAG,MAAM;;;cAFjC,MAAM;qBAAe,MAAM;;;;;;;;;;;;;;;;;;;;;mBACtB,MAAM;kBAAY,MAAM;gBAAU,MAAM,EAAE;;;;;;;cAsDrB,gBAAgB;;;;;;;;;;;;;;;;cArD1C,MAAM;mBAAa,KAAK,GAAG,MAAM;;;cAFjC,MAAM;qBAAe,MAAM;;;;;;;;;;;;;;;;;;;;;mBACtB,MAAM;kBAAY,MAAM;gBAAU,MAAM,EAAE;;;;;;;cAsDrB,gBAAgB;;;;;;;;;cAgNxC,MAAM;eAAS,MAAM;;;;;;;;;cArQvB,MAAM;mBAAa,KAAK,GAAG,MAAM;;;cAFjC,MAAM;qBAAe,MAAM;;;;;;;;;;;;;;;;;;;;;mBACtB,MAAM;kBAAY,MAAM;gBAAU,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAsQ7C,MAAM;eAAS,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAlFlD"}