@duckcodeailabs/dql-cli 1.14.5 → 1.14.6

package/dist/llm/providers/dql-agent-provider.d.ts.map

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

package/dist/llm/providers/dql-agent-provider.js

@@ -1448,6 +1448,33 @@ function createAskV2LaneHandler(state, limits) {
                     ...(relationshipPathIds.length ? { relationshipPathIds } : {}),
                 });
                 if (!allowed.ok) {
+                    // NEVER-DEAD-END CONCESSION. The progression rule exists to stop a
+                    // model from finishing without trying the executable tiers — but a
+                    // model that has inspected them and TWICE chosen to finish rather
+                    // than write exploratory SQL it cannot ground has made an honest
+                    // judgment (observed live: certified empty + semantic unavailable
+                    // on a 3,373-model repo; sonnet declined to invent Snowflake SQL
+                    // and the kernel burned the whole dispatch budget re-denying).
+                    // Concede on the SECOND identical denial: close the turn as a
+                    // typed gap. No SQL runs, no prose is trusted; the reader gets an
+                    // honest refusal in 3 dispatches instead of a timeout in 6.
+                    if (name === 'finish_answer'
+                        && allowed.reasonCode === 'ASK_V2_TOOL_PROGRESSION_REQUIRED'
+                        && !completed
+                        && state.observations.some((observation) => observation.tool === 'finish_answer'
+                            && observation.reasonCode === 'ASK_V2_TOOL_PROGRESSION_REQUIRED')) {
+                        observe('finish_answer', 'ineligible', 'ASK_V2_REMAINING_TIERS_DECLINED', {
+                            origin: 'agent_control',
+                            ...(allowed.safeNextTools?.length ? { safeAction: `use:${allowed.safeNextTools.join(',')}` } : {}),
+                        });
+                        finishAskAgentV2Turn(state, {
+                            version: 2,
+                            kind: 'gap',
+                            reasonCode: 'ASK_V2_REMAINING_TIERS_DECLINED',
+                            origin: 'agent_control',
+                        });
+                        return { finished: true, conceded: true, reasonCode: 'ASK_V2_REMAINING_TIERS_DECLINED' };
+                    }
                     const clarificationPreFreeze = name === 'request_clarification'
                         && (allowed.reasonCode === 'ASK_V2_CLARIFICATION_NOT_MATERIALLY_AMBIGUOUS'
                             || allowed.reasonCode === 'ASK_V2_TOOL_PROGRESSION_REQUIRED');
@@ -2705,7 +2732,22 @@ function createAskV2LaneHandler(state, limits) {
                         ? 'GOVERNED_RELATIONAL_IDENTIFIER_OR_PATH_NOT_ADMITTED'
                         : 'GOVERNED_RELATIONAL_EXECUTION_UNAVAILABLE';
                     observe('compile_and_run_dql', 'ineligible', reason, { tier: 'governed_relational', candidateIds: selectedCandidateIds, origin: 'validation' });
-                    return denied('compile_and_run_dql', reason);
+                    // A bare "not admitted" is unactionable — the model guessed wrong
+                    // IDs once and will guess again until the budget dies. Name the
+                    // admitted relational identifiers and path handles verbatim, the
+                    // same teaching contract the semantic tier's refusals carry.
+                    const admittedRelational = visibleCandidates()
+                        .filter(relationLike)
+                        .slice(0, 16)
+                        .map((candidate) => v2CandidateId(candidate));
+                    return {
+                        ...denied('compile_and_run_dql', reason),
+                        ...(reason === 'GOVERNED_RELATIONAL_IDENTIFIER_OR_PATH_NOT_ADMITTED' ? {
+                            admittedRelationalIds: admittedRelational,
+                            admittedRelationshipPathIds: state.relationshipPathHandles.slice(0, 8).map((path) => path.id),
+                            usage: 'Re-send compile_and_run_dql using measureIds/dimensionIds/expectedOutputIds from admittedRelationalIds verbatim and relationshipPathIds from admittedRelationshipPathIds. Invented identifiers are never admitted.',
+                        } : {}),
+                    };
                 }
                 // The local host mints a V2-only authorization before compiling the
                 // DQL program.  This is the frozen boundary: the compiler and
@@ -2819,7 +2861,22 @@ function createAskV2LaneHandler(state, limits) {
                 if (!outputs || !validation.ok || (!v2Prepare && !legacyPrepare) || !input.executeAgenticGeneratedSql) {
                     const reason = !outputs ? 'EXPLORATORY_OUTPUT_IDENTIFIER_NOT_ADMITTED' : validation.ok ? 'EXPLORATORY_EXECUTION_CAPABILITY_UNAVAILABLE' : 'EXPLORATORY_SQL_VALIDATION_FAILED';
                     observe('validate_and_run_sql', 'ineligible', reason, { tier: 'exploratory_sql', candidateIds: outputIds, origin: 'validation' });
-                    return denied('validate_and_run_sql', reason);
+                    // Same teaching contract as the semantic/relational refusals: a
+                    // model told only "not admitted" guesses identifiers until the
+                    // budget dies. Name the admitted output IDs verbatim.
+                    const admittedOutputs = reason === 'EXPLORATORY_OUTPUT_IDENTIFIER_NOT_ADMITTED'
+                        ? visibleCandidates().slice(0, 24).map((candidate) => v2CandidateId(candidate))
+                        : [];
+                    return {
+                        ...denied('validate_and_run_sql', reason),
+                        ...(admittedOutputs.length ? {
+                            admittedOutputIds: admittedOutputs,
+                            usage: 'Re-send validate_and_run_sql with expectedOutputIds drawn from admittedOutputIds verbatim; each must name a card your SQL actually selects.',
+                        } : {}),
+                        ...(reason === 'EXPLORATORY_SQL_VALIDATION_FAILED' && !validation.ok && 'reason' in validation && validation.reason ? {
+                            usage: String(validation.reason).slice(0, 400),
+                        } : {}),
+                    };
                 }
                 try {
                     const selectedCandidateIds = [...new Set(outputIds)];
@@ -2999,7 +3056,7 @@ function createAskV2LaneHandler(state, limits) {
         // simply that the user asked for a field this project has never modeled.
         // "Not enough context" for an unmodeled term reads as a system failure;
         // the truthful answer names the term and the governed alternatives.
-        const requestedUnmodeledTerm = () => {
+        const requestedUnmodeledTerm = async () => {
             const plan = buildAnalysisQuestionPlan(input.question);
             const requirements = buildAnalyticalRequirementSet({ question: input.question });
             // A "dimension term" can actually be a member VALUE ("beverage
@@ -3051,10 +3108,31 @@ function createAskV2LaneHandler(state, limits) {
             });
             if (unresolved.length === 0)
                 return undefined;
+            // Retention is a ranking, not the model: a term absent from the 80
+            // retained cards can still be modeled a thousand times over in a large
+            // catalog. Only the HOST's whole-catalog lookup may authorize a
+            // "not modeled" claim; without that proof, no refusal.
+            const catalogCheck = input.catalogTermMentioned;
+            if (!catalogCheck)
+                return undefined;
+            let confirmed;
+            for (const term of unresolved) {
+                try {
+                    if (!(await catalogCheck(term))) {
+                        confirmed = term;
+                        break;
+                    }
+                }
+                catch {
+                    return undefined;
+                }
+            }
+            if (!confirmed)
+                return undefined;
             const admitted = [...new Set(all
                     .filter((candidate) => v2SemanticCandidateMatchesRole(candidate, 'dimension'))
                     .map((candidate) => candidate.semanticRuntimeName ?? candidate.name))].slice(0, 6);
-            return { term: unresolved[0], admitted };
+            return { term: confirmed, admitted };
         };
         const hostFirst = !state.exactCertifiedCandidateId
             && state.tierStates?.certified?.status !== 'complete'
@@ -3104,7 +3182,7 @@ function createAskV2LaneHandler(state, limits) {
         // needed the term to resolve.
         if (!state.terminalOutcome
             && (state.turnClass === 'analytics' || state.turnClass === 'prior_result' || state.turnClass === 'clarification_response')) {
-            const unmodeled = requestedUnmodeledTerm();
+            const unmodeled = await requestedUnmodeledTerm();
             if (unmodeled) {
                 observeAskAgentV2Tool(state, {
                     version: 1,
@@ -3148,7 +3226,14 @@ function createAskV2LaneHandler(state, limits) {
                 // was shown "stopped at its own orchestration budget" instead of the
                 // rows DQL was holding. Ten matches the run-level ceiling so the two
                 // budgets cannot disagree about how much room the analyst really has.
-                maxProviderDispatches: limits?.maxProviderDispatches ?? (state.turnClass === 'research' ? 12 : state.turnClass === 'analytics' || state.turnClass === 'prior_result' ? 10 : 2),
+                // PHYSICAL sends, not logical round trips: a wrapper provider (the
+                // claude-code/codex passthrough) spends TWO physical sends per
+                // logical turn, so a cap of 10 gave those providers only five turns —
+                // the cold big-repo discovery ladder alone costs five, leaving zero
+                // room to apply a taught refusal. Sixteen restores eight logical
+                // turns for wrappers; 1:1 text providers are still bounded by the
+                // tool-call ceiling and the run deadline long before this guard.
+                maxProviderDispatches: limits?.maxProviderDispatches ?? (state.turnClass === 'research' ? 12 : state.turnClass === 'analytics' || state.turnClass === 'prior_result' ? 24 : 4),
                 // The kernel owns current availability. Native transports evaluate it
                 // before each API tool declaration; text transports receive the same
                 // update after every observation. This reserves a final *LLM action*
@@ -3378,6 +3463,9 @@ function createAskV2LaneHandler(state, limits) {
                 askAgentV2Outcome: { version: 2, kind: 'finish_answer', reasonCode: contextualEvidenceBound ? 'ASK_V2_CONTEXTUAL_ANSWER' : 'ASK_V2_GENERAL_UNGROUNDED_ANSWER', origin: 'narration' },
             };
         }
+        if (state.terminalOutcome?.reasonCode === 'ASK_V2_REMAINING_TIERS_DECLINED') {
+            return askV2NoAnswer(input, 'gap', 'ASK_V2_REMAINING_TIERS_DECLINED', 'agent_control');
+        }
         const progress = kernel.toolPolicy();
         if (progress.terminalActionToolNames?.length) {
             observe('finish_answer', 'ineligible', 'ASK_V2_TOOL_PROGRESSION_REQUIRED', {
@@ -3386,7 +3474,7 @@ function createAskV2LaneHandler(state, limits) {
             });
             return askV2NoAnswer(input, 'gap', 'ASK_V2_TOOL_PROGRESSION_REQUIRED', 'agent_control');
         }
-        return askV2NoAnswer(input, 'gap', 'ASK_V2_NO_EXECUTABLE_TOOL_RESULT', 'tool', undefined, requestedUnmodeledTerm());
+        return askV2NoAnswer(input, 'gap', 'ASK_V2_NO_EXECUTABLE_TOOL_RESULT', 'tool', undefined, await requestedUnmodeledTerm());
     };
 }
 /**
@@ -3863,7 +3951,9 @@ function askV2NoAnswer(input, kind, reasonCode, origin, safeActionOverride, mode
                             : 'The selected governed query did not complete on the current connection. Review the connection and trace, then retry.'
                         : modelingGap
                             ? `"${modelingGap.term}" is not modeled in this project's governed data, so no query can compute it.${modelingGap.admitted.length ? ` Governed groupings available: ${modelingGap.admitted.join(', ')}.` : ''} Ask with one of those instead, or model "${modelingGap.term}" and re-sync.`
-                            : 'DQL could not complete a safe analytical tool path from the current metadata snapshot.';
+                            : reasonCode === 'ASK_V2_REMAINING_TIERS_DECLINED'
+                                ? 'No certified block or semantic metric covers this question, and the analyst declined to run unverified exploratory SQL against this snapshot. No query was executed. Use Research for a deeper investigation, certify a block for this question, or name the exact model/columns to query.'
+                                : 'DQL could not complete a safe analytical tool path from the current metadata snapshot.';
     return {
         kind: 'no_answer',
         sourceTier: 'no_answer',
@@ -5730,6 +5820,7 @@ export function createDqlAgentProviderRunner(id, providerOverride) {
                         // SQL-boundary guard is needed because it can never execute a
                         // provider-authored query.
                         ...(req.probeAllowlistedLiteral ? { probeAllowlistedLiteral: req.probeAllowlistedLiteral } : {}),
+                        ...(req.catalogTermMentioned ? { catalogTermMentioned: req.catalogTermMentioned } : {}),
                         prepareExploratorySqlExecution: req.prepareExploratorySqlExecution
                             ? async (sql, ...args) => {
                                 guardSnapshot();