@duckcodeailabs/dql-agent 1.6.31 → 1.6.32

package/dist/answer-shape.d.ts

@@ -0,0 +1,16 @@
+import type { AnalysisQuestionPlan } from './metadata/analysis-planner.js';
+export interface AnswerShapeResultLike {
+    columns?: unknown;
+    rows?: unknown;
+    rowCount?: unknown;
+}
+export interface AnswerShapeValidation {
+    warnings: string[];
+    missingOutputs: string[];
+    columns: string[];
+    rowCount?: number;
+    topN?: number;
+    topNReturned?: number;
+}
+export declare function validateAnswerResultShape(plan: AnalysisQuestionPlan, result: AnswerShapeResultLike): AnswerShapeValidation;
+//# sourceMappingURL=answer-shape.d.ts.map

package/dist/answer-shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer-shape.d.ts","sourceRoot":"","sources":["../src/answer-shape.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,oBAAoB,EAC1B,MAAM,EAAE,qBAAqB,GAC5B,qBAAqB,CAyBvB"}

package/dist/answer-shape.js

@@ -0,0 +1,85 @@
+export function validateAnswerResultShape(plan, result) {
+    const columns = resultColumnsForShape(result);
+    const rowCount = resultRowCount(result);
+    const missingOutputs = plan.requestedShape.requiredOutputs.filter((output) => !columns.some((column) => columnCoversRequestedOutput(column, output)));
+    const warnings = [];
+    if (missingOutputs.length > 0) {
+        warnings.push(`The answer is missing requested output column(s): ${missingOutputs.join(', ')}.`);
+    }
+    const topN = plan.requestedShape.topN;
+    const topNReturned = topN && topN.scope !== 'per_group' && rowCount !== undefined && rowCount > topN.n
+        ? rowCount
+        : undefined;
+    if (topN && topNReturned !== undefined) {
+        warnings.push(`The user asked for top ${topN.n}, but the answer returned ${topNReturned} rows.`);
+    }
+    return {
+        warnings,
+        missingOutputs,
+        columns,
+        ...(rowCount !== undefined ? { rowCount } : {}),
+        ...(topN ? { topN: topN.n } : {}),
+        ...(topNReturned !== undefined ? { topNReturned } : {}),
+    };
+}
+function resultColumnsForShape(result) {
+    const columns = Array.isArray(result.columns) ? result.columns : [];
+    return columns.map((column) => {
+        if (typeof column === 'string')
+            return canonicalResultColumn(column);
+        if (column && typeof column === 'object') {
+            const record = column;
+            const name = [record.name, record.field, record.key].find((value) => typeof value === 'string' && value.trim().length > 0);
+            return name ? canonicalResultColumn(name) : '';
+        }
+        return '';
+    }).filter(Boolean);
+}
+function resultRowCount(result) {
+    if (typeof result.rowCount === 'number')
+        return result.rowCount;
+    return Array.isArray(result.rows) ? result.rows.length : undefined;
+}
+function columnCoversRequestedOutput(column, requiredOutput) {
+    const required = canonicalResultColumn(requiredOutput);
+    if (!required)
+        return true;
+    if (column === required)
+        return true;
+    const requiredTokens = required.split('_').filter(Boolean);
+    const columnTokens = column.split('_').filter(Boolean);
+    if (required === 'count') {
+        return columnTokens.some((token) => ['count', 'total', 'number', 'num'].includes(token));
+    }
+    const NAME_TOKENS = ['name', 'title', 'label', 'nm', 'description', 'desc'];
+    if (required.endsWith('_name')) {
+        const entity = requiredTokens[0];
+        const hasNameToken = columnTokens.some((token) => NAME_TOKENS.includes(token));
+        // Entity match tolerates common abbreviations (product↔prod, customer↔cust)
+        // via a shared 4-char stem, so aliases like prod_name / cust_name / p_name
+        // don't false-miss.
+        const stem = (token) => token.slice(0, 4);
+        const hasEntityToken = Boolean(entity && columnTokens.some((token) => token === entity || token.startsWith(stem(entity)) || entity.startsWith(stem(token))));
+        // A bare `name`/`label` column (single token) covers any *_name requirement.
+        const bareNameColumn = columnTokens.length === 1 && hasNameToken;
+        return (hasEntityToken && hasNameToken) || column === entity || bareNameColumn;
+    }
+    return requiredTokens.every((token) => columnTokens.includes(token));
+}
+function canonicalResultColumn(value) {
+    return value
+        .toLowerCase()
+        .replace(/[_\-./]+/g, ' ')
+        .replace(/[^a-z0-9 ]+/g, ' ')
+        .split(/\s+/)
+        .filter((token) => token.length > 1)
+        .map((token) => {
+        if (token.endsWith('ies') && token.length > 4)
+            return `${token.slice(0, -3)}y`;
+        if (token.endsWith('s') && token.length > 3)
+            return token.slice(0, -1);
+        return token;
+    })
+        .join('_');
+}
+//# sourceMappingURL=answer-shape.js.map

package/dist/answer-shape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer-shape.js","sourceRoot":"","sources":["../src/answer-shape.ts"],"names":[],"mappings":"AAiBA,MAAM,UAAU,yBAAyB,CACvC,IAA0B,EAC1B,MAA6B;IAE7B,MAAM,OAAO,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAC3E,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,2BAA2B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CACvE,CAAC;IACF,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,QAAQ,CAAC,IAAI,CAAC,qDAAqD,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnG,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;IACtC,MAAM,YAAY,GAAG,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,GAAG,IAAI,CAAC,CAAC;QACpG,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,SAAS,CAAC;IACd,IAAI,IAAI,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QACvC,QAAQ,CAAC,IAAI,CAAC,0BAA0B,IAAI,CAAC,CAAC,6BAA6B,YAAY,QAAQ,CAAC,CAAC;IACnG,CAAC;IACD,OAAO;QACL,QAAQ;QACR,cAAc;QACd,OAAO;QACP,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxD,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,MAA6B;IAC1D,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAC5B,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC;QACrE,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YACzC,MAAM,MAAM,GAAG,MAAiC,CAAC;YACjD,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAmB,EAAE,CACnF,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CACrD,CAAC;YACF,OAAO,IAAI,CAAC,CAAC,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED,SAAS,cAAc,CAAC,MAA6B;IACnD,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC;IAChE,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACrE,CAAC;AAED,SAAS,2BAA2B,CAAC,MAAc,EAAE,cAAsB;IACzE,MAAM,QAAQ,GAAG,qBAAqB,CAAC,cAAc,CAAC,CAAC;IACvD,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,cAAc,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3F,CAAC;IACD,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;IAC5E,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,YAAY,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/E,4EAA4E;QAC5E,2EAA2E;QAC3E,oBAAoB;QACpB,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAClD,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CACnE,KAAK,KAAK,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CACrF,CAAC,CAAC;QACH,6EAA6E;QAC7E,MAAM,cAAc,GAAG,YAAY,CAAC,MAAM,KAAK,CAAC,IAAI,YAAY,CAAC;QACjE,OAAO,CAAC,cAAc,IAAI,YAAY,CAAC,IAAI,MAAM,KAAK,MAAM,IAAI,cAAc,CAAC;IACjF,CAAC;IACD,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAa;IAC1C,OAAO,KAAK;SACT,WAAW,EAAE;SACb,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC;SACzB,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;SACnC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAC/E,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvE,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;SACD,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}

package/dist/cascade/budgets.d.ts

@@ -0,0 +1,101 @@
+import type { AnalysisQuestionPlan } from '../metadata/analysis-planner.js';
+import type { ReasoningEffort } from '../providers/reasoning-effort.js';
+export type CascadeLaneRepairKind = 'reground' | 'execution';
+export type CascadeAnalysisDepth = 'quick' | 'deep';
+export type ProposalToolBudgetClass = 'lookup' | 'multi_entity' | 'deep_research';
+export type ContextRetrievalStrictness = 'balanced' | 'exploratory';
+export interface CascadeLaneBudgetLimits {
+    reground: number;
+    execution: number;
+}
+export interface CascadeBudgetModel {
+    lane: CascadeLaneBudgetLimits;
+    engineEscalations: number;
+    /**
+     * MCP tier-2 has no persistent run state yet, so it advertises a bounded
+     * re-ground policy that callers can apply before retrying query_via_metadata.
+     */
+    mcpTier2Reground: number;
+}
+export interface CascadeBudgetUsage {
+    laneRegroundAttemptsUsed: number;
+    laneExecutionAttemptsUsed: number;
+    engineEscalationsUsed: number;
+}
+export interface CascadeBudgetTrace {
+    limits: CascadeBudgetModel;
+    usage: CascadeBudgetUsage;
+}
+export interface CascadeBudgetState {
+    readonly limits: CascadeBudgetModel;
+    readonly usage: CascadeBudgetUsage;
+}
+export interface McpTier2RepairBudget {
+    kind: 'reground';
+    attemptsUsed: number;
+    maxAttempts: number;
+    attemptsRemaining: number;
+    nextTool: 'expand_context';
+}
+export interface ProposalToolBudget {
+    maxToolCalls: number;
+    effortClass: ProposalToolBudgetClass;
+    reason: string;
+}
+export interface ProposalToolBudgetOptions {
+    analysisDepth?: CascadeAnalysisDepth;
+    reasoningEffort?: ReasoningEffort;
+}
+export interface PromptContextBudget {
+    label: CascadeAnalysisDepth;
+    schemaTableLimit: number;
+    schemaColumnLimit: number;
+    contextObjectLimit: number;
+    warningLimit: number;
+    relationCardLimit: number;
+    relationColumnLimit: number;
+    selectedRelationReasonLimit: number;
+    joinPathLimit: number;
+    lineageEdgeLimit: number;
+    otherRelationStart: number;
+    otherRelationEnd: number;
+    otherRelationLimit: number;
+    sourceSqlLimit: number;
+    sourceSqlColumnLimit: number;
+    edgeLimit: number;
+}
+export interface ContextRetrievalBudget {
+    analysisDepth: CascadeAnalysisDepth;
+    strictness: ContextRetrievalStrictness;
+    limit: number;
+}
+export declare const DEFAULT_CASCADE_BUDGET_MODEL: CascadeBudgetModel;
+export declare const QUICK_PROMPT_CONTEXT_BUDGET: PromptContextBudget;
+export declare const DEEP_PROMPT_CONTEXT_BUDGET: PromptContextBudget;
+export declare function createCascadeBudgetState(overrides?: PartialCascadeBudgetModel): CascadeBudgetState;
+export type PartialCascadeBudgetModel = {
+    lane?: Partial<CascadeLaneBudgetLimits>;
+    engineEscalations?: number;
+    mcpTier2Reground?: number;
+};
+export declare function mergeCascadeBudgetModel(overrides?: PartialCascadeBudgetModel): CascadeBudgetModel;
+export declare function canUseLaneRepair(state: CascadeBudgetState, kind: CascadeLaneRepairKind): boolean;
+export declare function recordLaneRepair(state: CascadeBudgetState, kind: CascadeLaneRepairKind): CascadeBudgetUsage;
+export declare function canUseEngineEscalation(state: CascadeBudgetState): boolean;
+export declare function recordEngineEscalation(state: CascadeBudgetState): CascadeBudgetUsage;
+export declare function cascadeBudgetUsage(state: CascadeBudgetState): CascadeBudgetUsage;
+export declare function cascadeBudgetTrace(state: CascadeBudgetState): CascadeBudgetTrace;
+export declare function mcpTier2RegroundRepairBudget(attemptsUsed?: number, model?: PartialCascadeBudgetModel): McpTier2RepairBudget;
+export declare function analysisDepthForQuestion(plan: AnalysisQuestionPlan, reasoningEffort?: ReasoningEffort, requestedDepth?: CascadeAnalysisDepth): CascadeAnalysisDepth;
+export declare function promptContextBudgetForQuestion(input: {
+    questionPlan: AnalysisQuestionPlan;
+    requestedDepth?: CascadeAnalysisDepth;
+    reasoningEffort?: ReasoningEffort;
+}): PromptContextBudget;
+export declare function contextRetrievalBudgetForQuestion(input: {
+    questionPlan: AnalysisQuestionPlan;
+    requestedDepth?: CascadeAnalysisDepth;
+    reasoningEffort?: ReasoningEffort;
+}): ContextRetrievalBudget;
+export declare function proposalToolBudgetForQuestion(plan: AnalysisQuestionPlan, intent: string, options?: ProposalToolBudgetOptions): ProposalToolBudget;
+//# sourceMappingURL=budgets.d.ts.map

package/dist/cascade/budgets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budgets.d.ts","sourceRoot":"","sources":["../../src/cascade/budgets.ts"],"names":[],"mappings":"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"}

package/dist/cascade/budgets.js

@@ -0,0 +1,184 @@
+export const DEFAULT_CASCADE_BUDGET_MODEL = {
+    lane: {
+        reground: 2,
+        execution: 2,
+    },
+    engineEscalations: 2,
+    mcpTier2Reground: 1,
+};
+export const QUICK_PROMPT_CONTEXT_BUDGET = {
+    label: 'quick',
+    schemaTableLimit: 12,
+    schemaColumnLimit: 50,
+    contextObjectLimit: 18,
+    warningLimit: 8,
+    relationCardLimit: 12,
+    relationColumnLimit: 32,
+    selectedRelationReasonLimit: 8,
+    joinPathLimit: 8,
+    lineageEdgeLimit: 12,
+    otherRelationStart: 12,
+    otherRelationEnd: 40,
+    otherRelationLimit: 24,
+    sourceSqlLimit: 5,
+    sourceSqlColumnLimit: 24,
+    edgeLimit: 0,
+};
+export const DEEP_PROMPT_CONTEXT_BUDGET = {
+    label: 'deep',
+    schemaTableLimit: 40,
+    schemaColumnLimit: 120,
+    contextObjectLimit: 80,
+    warningLimit: 24,
+    relationCardLimit: 40,
+    relationColumnLimit: 120,
+    selectedRelationReasonLimit: 24,
+    joinPathLimit: 24,
+    lineageEdgeLimit: 40,
+    otherRelationStart: 40,
+    otherRelationEnd: 120,
+    otherRelationLimit: 80,
+    sourceSqlLimit: 12,
+    sourceSqlColumnLimit: 48,
+    edgeLimit: 80,
+};
+export function createCascadeBudgetState(overrides = {}) {
+    return {
+        limits: mergeCascadeBudgetModel(overrides),
+        usage: {
+            laneRegroundAttemptsUsed: 0,
+            laneExecutionAttemptsUsed: 0,
+            engineEscalationsUsed: 0,
+        },
+    };
+}
+export function mergeCascadeBudgetModel(overrides = {}) {
+    return {
+        lane: {
+            reground: normalizeBudgetLimit(overrides.lane?.reground, DEFAULT_CASCADE_BUDGET_MODEL.lane.reground),
+            execution: normalizeBudgetLimit(overrides.lane?.execution, DEFAULT_CASCADE_BUDGET_MODEL.lane.execution),
+        },
+        engineEscalations: normalizeBudgetLimit(overrides.engineEscalations, DEFAULT_CASCADE_BUDGET_MODEL.engineEscalations),
+        mcpTier2Reground: normalizeBudgetLimit(overrides.mcpTier2Reground, DEFAULT_CASCADE_BUDGET_MODEL.mcpTier2Reground),
+    };
+}
+export function canUseLaneRepair(state, kind) {
+    return laneRepairAttemptsUsed(state, kind) < state.limits.lane[kind];
+}
+export function recordLaneRepair(state, kind) {
+    if (kind === 'reground') {
+        state.usage.laneRegroundAttemptsUsed += 1;
+    }
+    else {
+        state.usage.laneExecutionAttemptsUsed += 1;
+    }
+    return cascadeBudgetUsage(state);
+}
+export function canUseEngineEscalation(state) {
+    return state.usage.engineEscalationsUsed < state.limits.engineEscalations;
+}
+export function recordEngineEscalation(state) {
+    state.usage.engineEscalationsUsed += 1;
+    return cascadeBudgetUsage(state);
+}
+export function cascadeBudgetUsage(state) {
+    return {
+        laneRegroundAttemptsUsed: state.usage.laneRegroundAttemptsUsed,
+        laneExecutionAttemptsUsed: state.usage.laneExecutionAttemptsUsed,
+        engineEscalationsUsed: state.usage.engineEscalationsUsed,
+    };
+}
+export function cascadeBudgetTrace(state) {
+    return {
+        limits: {
+            lane: { ...state.limits.lane },
+            engineEscalations: state.limits.engineEscalations,
+            mcpTier2Reground: state.limits.mcpTier2Reground,
+        },
+        usage: cascadeBudgetUsage(state),
+    };
+}
+export function mcpTier2RegroundRepairBudget(attemptsUsed = 0, model = {}) {
+    const maxAttempts = mergeCascadeBudgetModel(model).mcpTier2Reground;
+    const used = normalizeBudgetLimit(attemptsUsed, 0);
+    return {
+        kind: 'reground',
+        attemptsUsed: used,
+        maxAttempts,
+        attemptsRemaining: Math.max(0, maxAttempts - used),
+        nextTool: 'expand_context',
+    };
+}
+export function analysisDepthForQuestion(plan, reasoningEffort, requestedDepth) {
+    if (requestedDepth)
+        return requestedDepth;
+    if (reasoningEffort === 'high'
+        || plan.needsResearchWorkspace
+        || plan.mode === 'diagnose_change'
+        || plan.mode === 'driver_breakdown'
+        || plan.mode === 'anomaly') {
+        return 'deep';
+    }
+    return 'quick';
+}
+export function promptContextBudgetForQuestion(input) {
+    return analysisDepthForQuestion(input.questionPlan, input.reasoningEffort, input.requestedDepth) === 'deep'
+        ? DEEP_PROMPT_CONTEXT_BUDGET
+        : QUICK_PROMPT_CONTEXT_BUDGET;
+}
+export function contextRetrievalBudgetForQuestion(input) {
+    const analysisDepth = analysisDepthForQuestion(input.questionPlan, input.reasoningEffort, input.requestedDepth);
+    return analysisDepth === 'deep'
+        ? { analysisDepth, strictness: 'exploratory', limit: 160 }
+        : { analysisDepth, strictness: 'balanced', limit: 100 };
+}
+export function proposalToolBudgetForQuestion(plan, intent, options = {}) {
+    if (options.analysisDepth === 'deep'
+        || options.reasoningEffort === 'high'
+        || plan.needsResearchWorkspace
+        || plan.mode === 'diagnose_change'
+        || plan.mode === 'driver_breakdown'
+        || plan.mode === 'anomaly'
+        || intent === 'diagnose_change'
+        || intent === 'driver_breakdown'
+        || intent === 'anomaly_investigation'
+        || intent === 'trust_gap_review') {
+        return {
+            maxToolCalls: 15,
+            effortClass: 'deep_research',
+            reason: 'deep analysis, diagnosis, anomaly, trust review, or research workspace request',
+        };
+    }
+    const shape = plan.requestedShape;
+    const entityOrJoinShape = plan.entities.length > 0
+        || shape.dimensions.length > 1
+        || shape.requiredOutputs.length > 2
+        || (shape.filters.length > 0 && shape.dimensions.length > 0)
+        || Boolean(shape.topN)
+        || plan.mode === 'comparison'
+        || plan.mode === 'entity_profile'
+        || plan.mode === 'entity_drilldown';
+    if (entityOrJoinShape) {
+        return {
+            maxToolCalls: 8,
+            effortClass: 'multi_entity',
+            reason: 'multi-entity, ranked, filtered, comparison, profile, or drilldown shape',
+        };
+    }
+    return {
+        maxToolCalls: 3,
+        effortClass: 'lookup',
+        reason: 'single metric or simple generated lookup',
+    };
+}
+function laneRepairAttemptsUsed(state, kind) {
+    return kind === 'reground'
+        ? state.usage.laneRegroundAttemptsUsed
+        : state.usage.laneExecutionAttemptsUsed;
+}
+function normalizeBudgetLimit(value, fallback) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return fallback;
+    return Math.max(0, Math.floor(value));
+}
+//# sourceMappingURL=budgets.js.map

package/dist/cascade/budgets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budgets.js","sourceRoot":"","sources":["../../src/cascade/budgets.ts"],"names":[],"mappings":"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"}

package/dist/cascade/cascade.d.ts

@@ -0,0 +1,86 @@
+export type CascadeLane = 'triage' | 'certified' | 'semantic' | 'generated' | 'refusal';
+export type CascadeLaneStatus = 'selected' | 'checked' | 'skipped' | 'failed';
+export interface CascadeLaneTrace {
+    lane: CascadeLane;
+    status: CascadeLaneStatus;
+    label: string;
+    detail?: string;
+    terminal?: boolean;
+}
+export interface CascadeLaneTraceInput {
+    status?: CascadeLaneStatus;
+    label?: string;
+    detail?: string;
+}
+export interface CascadeTraceInput {
+    terminalLane?: CascadeLane;
+    lanes?: Partial<Record<CascadeLane, CascadeLaneTraceInput>>;
+}
+export interface CascadeEvidenceRouteStep {
+    tool: `cascade_${CascadeLane}`;
+    status: CascadeLaneStatus;
+    label: string;
+    detail?: string;
+}
+export type CascadeAnswerTier = 'certified_block' | 'semantic_metric' | 'generated_sql' | 'business_context' | 'no_answer';
+export interface CascadeAnswerResultInput {
+    routeTier: CascadeAnswerTier;
+    label: string;
+    ref?: string;
+    artifactKind?: string;
+    refusalCode?: string;
+    reason?: string;
+    rowCount?: number;
+    executionStatus?: 'executed' | 'failed' | 'not_requested' | 'not_applicable';
+    draftBlockId?: string;
+    metrics?: string[];
+    dimensions?: string[];
+    hasSqlPreview?: boolean;
+}
+export type CascadeTerminalLane = Exclude<CascadeLane, 'triage'>;
+export interface CascadeAnswerResult {
+    terminalLane: CascadeTerminalLane;
+    routeTier: CascadeAnswerTier;
+    label: string;
+    ref?: string;
+    artifactKind?: string;
+    refusalCode?: string;
+    outcome: CascadeLaneOutcome;
+}
+export type CascadeLaneOutcome = CascadeCertifiedOutcome | CascadeSemanticOutcome | CascadeGeneratedOutcome | CascadeRefusalOutcome;
+export interface CascadeCertifiedOutcome {
+    lane: 'certified';
+    routeTier: 'certified_block' | 'business_context';
+    ref?: string;
+    executionStatus: 'executed' | 'failed' | 'not_requested' | 'not_applicable';
+    rowCount?: number;
+}
+export interface CascadeSemanticOutcome {
+    lane: 'semantic';
+    routeTier: 'semantic_metric';
+    ref?: string;
+    artifactKind?: string;
+    metrics?: string[];
+    dimensions?: string[];
+    rowCount?: number;
+}
+export interface CascadeGeneratedOutcome {
+    lane: 'generated';
+    routeTier: 'generated_sql';
+    artifactKind?: string;
+    draftBlockId?: string;
+    hasSqlPreview: boolean;
+    executionStatus: 'executed' | 'failed' | 'not_requested' | 'not_applicable';
+    rowCount?: number;
+}
+export interface CascadeRefusalOutcome {
+    lane: 'refusal';
+    routeTier: 'no_answer';
+    refusalCode?: string;
+    reason: string;
+}
+export declare function createCascadeTrace(input?: CascadeTraceInput): CascadeLaneTrace[];
+export declare function cascadeTraceToEvidenceRouteSteps(trace: CascadeLaneTrace[]): CascadeEvidenceRouteStep[];
+export declare function createCascadeAnswerResult(input: CascadeAnswerResultInput): CascadeAnswerResult;
+export declare function terminalLaneForRouteTier(routeTier: CascadeAnswerTier): CascadeTerminalLane;
+//# sourceMappingURL=cascade.d.ts.map

package/dist/cascade/cascade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cascade.d.ts","sourceRoot":"","sources":["../../src/cascade/cascade.ts"],"names":[],"mappings":"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"}

package/dist/cascade/cascade.js

@@ -0,0 +1,115 @@
+const CASCADE_LANE_ORDER = ['triage', 'certified', 'semantic', 'generated', 'refusal'];
+const DEFAULT_LANE_LABELS = {
+    triage: 'Lane 0 triage checked request intent and ambiguity',
+    certified: 'Lane 1 checked certified DQL blocks and business context',
+    semantic: 'Lane 2 checked semantic metrics and dimensions',
+    generated: 'Lane 3 checked generated DQL artifact with SQL preview',
+    refusal: 'Lane 4 checked honest refusal and redirect',
+};
+const TERMINAL_LANE_LABELS = {
+    triage: 'Lane 0 triage was terminal',
+    certified: 'Lane 1 certified answer was terminal',
+    semantic: 'Lane 2 semantic DQL artifact was terminal',
+    generated: 'Lane 3 generated DQL artifact was terminal',
+    refusal: 'Lane 4 refusal was terminal',
+};
+export function createCascadeTrace(input = {}) {
+    const terminalIndex = input.terminalLane ? CASCADE_LANE_ORDER.indexOf(input.terminalLane) : -1;
+    return CASCADE_LANE_ORDER.map((lane, index) => {
+        const override = input.lanes?.[lane];
+        const isTerminal = terminalIndex === index;
+        const afterTerminal = terminalIndex >= 0 && index > terminalIndex;
+        if (afterTerminal) {
+            return {
+                lane,
+                status: 'skipped',
+                label: override?.label ?? skippedByTerminalLaneLabel(lane, input.terminalLane),
+                ...(override?.detail ? { detail: override.detail } : {}),
+            };
+        }
+        const status = override?.status ?? (isTerminal ? 'selected' : terminalIndex >= 0 ? 'checked' : 'skipped');
+        return {
+            lane,
+            status,
+            label: override?.label ?? (isTerminal ? TERMINAL_LANE_LABELS[lane] : DEFAULT_LANE_LABELS[lane]),
+            ...(override?.detail ? { detail: override.detail } : {}),
+            ...(isTerminal ? { terminal: true } : {}),
+        };
+    });
+}
+export function cascadeTraceToEvidenceRouteSteps(trace) {
+    return trace.map((step) => ({
+        tool: `cascade_${step.lane}`,
+        status: step.status,
+        label: step.label,
+        ...(step.detail ? { detail: step.detail } : {}),
+    }));
+}
+export function createCascadeAnswerResult(input) {
+    const terminalLane = terminalLaneForRouteTier(input.routeTier);
+    return {
+        terminalLane,
+        routeTier: input.routeTier,
+        label: input.label,
+        ...(input.ref ? { ref: input.ref } : {}),
+        ...(input.artifactKind ? { artifactKind: input.artifactKind } : {}),
+        ...(input.refusalCode ? { refusalCode: input.refusalCode } : {}),
+        outcome: createCascadeLaneOutcome({ ...input, terminalLane }),
+    };
+}
+export function terminalLaneForRouteTier(routeTier) {
+    switch (routeTier) {
+        case 'certified_block':
+        case 'business_context':
+            return 'certified';
+        case 'semantic_metric':
+            return 'semantic';
+        case 'generated_sql':
+            return 'generated';
+        case 'no_answer':
+            return 'refusal';
+    }
+}
+function createCascadeLaneOutcome(input) {
+    switch (input.terminalLane) {
+        case 'certified':
+            return {
+                lane: 'certified',
+                routeTier: input.routeTier === 'business_context' ? 'business_context' : 'certified_block',
+                ...(input.ref ? { ref: input.ref } : {}),
+                executionStatus: input.executionStatus ?? 'not_requested',
+                ...(input.rowCount === undefined ? {} : { rowCount: input.rowCount }),
+            };
+        case 'semantic':
+            return {
+                lane: 'semantic',
+                routeTier: 'semantic_metric',
+                ...(input.ref ? { ref: input.ref } : {}),
+                ...(input.artifactKind ? { artifactKind: input.artifactKind } : {}),
+                ...(input.metrics?.length ? { metrics: input.metrics } : {}),
+                ...(input.dimensions?.length ? { dimensions: input.dimensions } : {}),
+                ...(input.rowCount === undefined ? {} : { rowCount: input.rowCount }),
+            };
+        case 'generated':
+            return {
+                lane: 'generated',
+                routeTier: 'generated_sql',
+                ...(input.artifactKind ? { artifactKind: input.artifactKind } : {}),
+                ...(input.draftBlockId ? { draftBlockId: input.draftBlockId } : {}),
+                hasSqlPreview: input.hasSqlPreview ?? false,
+                executionStatus: input.executionStatus ?? 'not_requested',
+                ...(input.rowCount === undefined ? {} : { rowCount: input.rowCount }),
+            };
+        case 'refusal':
+            return {
+                lane: 'refusal',
+                routeTier: 'no_answer',
+                ...(input.refusalCode ? { refusalCode: input.refusalCode } : {}),
+                reason: input.reason ?? input.label,
+            };
+    }
+}
+function skippedByTerminalLaneLabel(lane, terminalLane) {
+    return `${DEFAULT_LANE_LABELS[lane]} skipped because ${terminalLane} lane already produced a terminal outcome`;
+}
+//# sourceMappingURL=cascade.js.map

package/dist/cascade/cascade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cascade.js","sourceRoot":"","sources":["../../src/cascade/cascade.ts"],"names":[],"mappings":"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"}

package/dist/cascade/route-policy.d.ts

@@ -0,0 +1,14 @@
+export type CascadeRequestedMode = 'auto' | 'ask' | 'research' | 'sql' | 'block' | 'app';
+export type CascadeRunRoute = 'conversation' | 'certified_answer' | 'generated_answer' | 'research' | 'sql_cell' | 'dql_block_draft' | 'app_build' | 'clarify' | 'blocked';
+export type CascadeAction = 'answer' | 'clarify' | 'investigate' | 'compose_app' | 'converse';
+export type CascadeAnswerRouteTier = 'certified_block' | 'semantic_metric' | 'generated_sql' | 'business_context' | 'no_answer';
+export interface CascadeRouteRequest {
+    question: string;
+    requestedMode?: CascadeRequestedMode;
+}
+export interface CascadeRouteDecision {
+    action: CascadeAction;
+}
+export declare function selectCascadeRunRoute(request: CascadeRouteRequest, decision: CascadeRouteDecision): CascadeRunRoute;
+export declare function routeForCascadeAnswerTier(tier: CascadeAnswerRouteTier | undefined): CascadeRunRoute | undefined;
+//# sourceMappingURL=route-policy.d.ts.map