@duckcodeailabs/dql-agent 1.6.31 → 1.6.33

package/dist/agent-run-engine.d.ts

@@ -1,4 +1,5 @@
 import { type IntentDecision, type IntentSignals } from "./intent-controller.js";
+import { type CascadeAnalysisDepth, type CascadeBudgetTrace, type PartialCascadeBudgetModel } from "./cascade/budgets.js";
 import type { MetadataAgentIntent } from "./metadata/catalog.js";
 import type { ReasoningEffort } from "./providers/reasoning-effort.js";
 export type AgentRunRequestedMode = "auto" | "ask" | "research" | "sql" | "block" | "app";
@@ -78,11 +79,18 @@ export interface AgentRunRequest {
     signals?: IntentSignals;
     selectedObject?: AgentRunSelectedObject;
     workspaceContext?: Record<string, unknown>;
+    conversationContext?: Record<string, unknown>;
     history?: Array<{
         role: "user" | "assistant";
         text: string;
     }>;
+    /** Server-side conversation thread this run belongs to (persistence + resume). */
+    threadId?: string;
     runId?: string;
+    /** Optional run-specific model effort. Hosts should still apply provider/settings ceilings. */
+    reasoningEffort?: ReasoningEffort;
+    /** Optional run-specific context depth for governed answer retrieval and prompting. */
+    analysisDepth?: CascadeAnalysisDepth;
 }
 export interface AgentRunEvent {
     id: string;
@@ -114,6 +122,7 @@ export interface AgentRunStep {
     id: string;
     index: number;
     route: AgentRunRoute;
+    resolvedRoute?: AgentRunRoute;
     goal: string;
     successCriteria: string[];
     status: AgentRunStepStatus;
@@ -144,7 +153,12 @@ export interface AgentRun {
     evaluations: AgentRunEvaluation[];
     events: AgentRunEvent[];
     nextActions: AgentRunNextAction[];
+    /** Same-lane repair reruns. Escalations are tracked separately. */
     repairAttempts: number;
+    /** Engine-level route escalations, separate from same-lane repairs. */
+    escalationAttempts?: number;
+    /** Visible budget model and spend for audits/traces. */
+    budgetUsage?: CascadeBudgetTrace;
 }
 export interface AgentRouteExecutionContext {
     runId: string;
@@ -171,6 +185,18 @@ export interface AgentRouteExecutionContext {
 export interface AgentRouteExecutorResult {
     summary?: string;
     answer?: string;
+    /**
+     * Route resolved by a deeper executor-owned cascade. For example, Ask mode may
+     * execute through the generated-answer route, then the answer loop can prove
+     * the result came from a certified block.
+     */
+    resolvedRoute?: AgentRunRoute;
+    /**
+     * Cascade tier that actually produced the answer (certified_block /
+     * semantic_metric / generated_sql / business_context / no_answer). Lets the
+     * engine short-circuit on a governed tier even when the route was generated_answer.
+     */
+    answerTier?: string;
     /** How to read `answer` for trust; defaults to "governed". */
     answerKind?: AgentRunAnswerKind;
     status?: AgentRunStatus;
@@ -208,6 +234,9 @@ export interface AgentRunReplanInput {
     attemptsUsed: number;
     repairAttemptsUsed: number;
     maxRepairAttempts: number;
+    engineEscalationsUsed?: number;
+    maxEngineEscalations?: number;
+    budgetUsage?: CascadeBudgetTrace;
 }
 export type AgentRunReplanDecision = {
     decision: "accept";
@@ -250,6 +279,8 @@ export interface AgentRunEngineOptions {
     idGenerator?: () => string;
     now?: () => Date;
     maxRepairAttempts?: number;
+    maxEngineEscalations?: number;
+    budgets?: PartialCascadeBudgetModel;
     maxSteps?: number;
 }
 /**
@@ -262,12 +293,17 @@ export declare function resolveAudience(request: AgentRunRequest): AgentRunAudie
 /** A stakeholder may never land on an authoring route — collapse it to a governed answer. */
 export declare function constrainRouteForAudience(route: AgentRunRoute, audience: AgentRunAudience): AgentRunRoute;
 /**
- * "Answer anyway, labeled" — a stakeholder should get a best-effort governed answer
- * rather than a dead-end clarify, UNLESS the catalog explicitly flagged missing
- * context. The answer loop does its own grounding/retrieval and can still return a
- * needs-clarification result if it genuinely can't proceed.
+ * "Answer anyway, labeled" — get a best-effort governed answer rather than a
+ * dead-end clarify. The answer loop does its own grounding/retrieval and can still
+ * return a needs-clarification result if it genuinely can't proceed.
+ *
+ * - A SOFT clarify ("nothing governed matched") is answered anyway for EVERY
+ *   audience — analysts included — so a real analytical question never dead-ends.
+ * - A genuine clarify (explicit missing context, explicit clarify intent, or a
+ *   trust-gap review) stays a clarify for analysts; stakeholders keep the legacy
+ *   answer-anyway affordance unless the catalog explicitly flagged missing context.
  */
-export declare function answerAnywayRoute(route: AgentRunRoute, request: AgentRunRequest, audience: AgentRunAudience): AgentRunRoute;
+export declare function answerAnywayRoute(route: AgentRunRoute, request: AgentRunRequest, audience: AgentRunAudience, decision?: IntentDecision): AgentRunRoute;
 /**
  * Task-adaptive reasoning effort per route — the DQL differentiator. Cheap,
  * mechanical routes (chat, clarify, blocked, a pre-written certified lookup) run
@@ -307,7 +343,7 @@ export declare class AgentRunEngine {
     private readonly store?;
     private readonly idGenerator;
     private readonly now;
-    private readonly maxRepairAttempts;
+    private readonly budgetModel;
     private readonly maxSteps;
     constructor(options?: AgentRunEngineOptions);
     /**

package/dist/agent-run-engine.d.ts.map

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

package/dist/agent-run-engine.js

@@ -1,12 +1,12 @@
 import { randomUUID } from "node:crypto";
 import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
-import { decideAgentAction, looksLikeComposeApp, } from "./intent-controller.js";
+import { classifyConversationalTurn, decideAgentAction, } from "./intent-controller.js";
+import { selectCascadeRunRoute } from "./cascade/route-policy.js";
+import { canUseEngineEscalation, canUseLaneRepair, cascadeBudgetTrace, createCascadeBudgetState, recordEngineEscalation, recordLaneRepair, } from "./cascade/budgets.js";
 /** Routes a stakeholder may never land on (analyst authoring lives in the Notebook). */
 const ANALYST_ONLY_ROUTES = new Set(["sql_cell", "dql_block_draft"]);
-const DEFAULT_MAX_REPAIR_ATTEMPTS = 2;
 const DEFAULT_MAX_STEPS = 4;
-const CERTIFIED_MATCH_THRESHOLD = 0.5;
 /**
  * Routes whose gate failure is better answered by switching routes than by
  * re-running the same executor (repair can't add what the route can't produce).
@@ -27,16 +27,25 @@ export function constrainRouteForAudience(route, audience) {
     return route;
 }
 /**
- * "Answer anyway, labeled" — a stakeholder should get a best-effort governed answer
- * rather than a dead-end clarify, UNLESS the catalog explicitly flagged missing
- * context. The answer loop does its own grounding/retrieval and can still return a
- * needs-clarification result if it genuinely can't proceed.
+ * "Answer anyway, labeled" — get a best-effort governed answer rather than a
+ * dead-end clarify. The answer loop does its own grounding/retrieval and can still
+ * return a needs-clarification result if it genuinely can't proceed.
+ *
+ * - A SOFT clarify ("nothing governed matched") is answered anyway for EVERY
+ *   audience — analysts included — so a real analytical question never dead-ends.
+ * - A genuine clarify (explicit missing context, explicit clarify intent, or a
+ *   trust-gap review) stays a clarify for analysts; stakeholders keep the legacy
+ *   answer-anyway affordance unless the catalog explicitly flagged missing context.
  */
-export function answerAnywayRoute(route, request, audience) {
-    if (audience !== "stakeholder" || route !== "clarify")
+export function answerAnywayRoute(route, request, audience, decision) {
+    if (route !== "clarify")
         return route;
     const explicitMissing = (request.signals?.missingContext?.length ?? 0) > 0;
-    return explicitMissing ? "clarify" : "generated_answer";
+    if (decision?.clarifySoft === true && !explicitMissing)
+        return "generated_answer";
+    if (audience === "stakeholder" && !explicitMissing)
+        return "generated_answer";
+    return "clarify";
 }
 /**
  * Task-adaptive reasoning effort per route — the DQL differentiator. Cheap,
@@ -171,7 +180,7 @@ export class AgentRunEngine {
     store;
     idGenerator;
     now;
-    maxRepairAttempts;
+    budgetModel;
     maxSteps;
     constructor(options = {}) {
         this.executors = options.executors ?? {};
@@ -181,7 +190,14 @@ export class AgentRunEngine {
         this.store = options.store;
         this.idGenerator = options.idGenerator ?? randomUUID;
         this.now = options.now ?? (() => new Date());
-        this.maxRepairAttempts = options.maxRepairAttempts ?? DEFAULT_MAX_REPAIR_ATTEMPTS;
+        this.budgetModel = {
+            ...options.budgets,
+            lane: {
+                ...options.budgets?.lane,
+                execution: options.maxRepairAttempts ?? options.budgets?.lane?.execution,
+            },
+            engineEscalations: options.maxEngineEscalations ?? options.budgets?.engineEscalations,
+        };
         this.maxSteps = Math.max(1, options.maxSteps ?? DEFAULT_MAX_STEPS);
     }
     /**
@@ -228,7 +244,7 @@ export class AgentRunEngine {
         });
         const audience = resolveAudience(request);
         const routeDecision = await this.decideRoute(request);
-        const defaultRoute = answerAnywayRoute(constrainRouteForAudience(selectRoute(request, routeDecision), audience), request, audience);
+        const defaultRoute = answerAnywayRoute(constrainRouteForAudience(selectRoute(request, routeDecision), audience), request, audience, routeDecision);
         try {
             const plan = await this.planner.plan({
                 request,
@@ -249,14 +265,18 @@ export class AgentRunEngine {
             // without explicit missing context.
             const queue = plan.steps.map((step) => ({
                 ...step,
-                route: answerAnywayRoute(constrainRouteForAudience(step.route, audience), request, audience),
+                route: answerAnywayRoute(constrainRouteForAudience(step.route, audience), request, audience, routeDecision),
             }));
-            let repairAttemptsTotal = 0;
+            const budgets = createCascadeBudgetState(this.budgetModel);
             let stepCount = 0;
             let finalStep;
             let finalResult;
             let finalOutcome;
             let clarifyOutcome;
+            // The last step that actually produced a user-facing answer. A later
+            // non-answer step (e.g. a research/draft step that emits only an artifact)
+            // must not drop the data answer an earlier step already computed.
+            let bestAnswerResult;
             while (queue.length > 0 && stepCount < this.maxSteps) {
                 const planned = queue.shift();
                 stepCount += 1;
@@ -299,7 +319,7 @@ export class AgentRunEngine {
                         request,
                         route,
                         routeDecision,
-                        maxRepairAttempts: this.maxRepairAttempts,
+                        maxRepairAttempts: budgets.limits.lane.execution,
                         attempt,
                         stepGoal: planned.goal,
                         priorEvaluations,
@@ -326,11 +346,6 @@ export class AgentRunEngine {
                         stepStatus = attempt > 0 ? "repaired" : "passed";
                         break;
                     }
-                    // Out of modify budget — accept the best result we have.
-                    if (repairAttemptsTotal >= this.maxRepairAttempts) {
-                        stepStatus = "needs_review";
-                        break;
-                    }
                     const currentStep = {
                         id: stepId,
                         index: stepCount,
@@ -349,8 +364,11 @@ export class AgentRunEngine {
                         currentStep,
                         remainingSteps: queue,
                         attemptsUsed: attempt,
-                        repairAttemptsUsed: repairAttemptsTotal,
-                        maxRepairAttempts: this.maxRepairAttempts,
+                        repairAttemptsUsed: budgets.usage.laneExecutionAttemptsUsed,
+                        maxRepairAttempts: budgets.limits.lane.execution,
+                        engineEscalationsUsed: budgets.usage.engineEscalationsUsed,
+                        maxEngineEscalations: budgets.limits.engineEscalations,
+                        budgetUsage: cascadeBudgetTrace(budgets),
                     });
                     emit({
                         type: "replan.decided",
@@ -359,27 +377,51 @@ export class AgentRunEngine {
                         payload: decision,
                     });
                     if (decision.decision === "repair") {
-                        repairAttemptsTotal += 1;
+                        const nextRepairHint = repairHintForEvaluation(failing, decision.repairHint);
+                        if (!canUseLaneRepair(budgets, "execution")) {
+                            stepStatus = "needs_review";
+                            emit({
+                                type: "repair.attempted",
+                                message: `Repair budget exhausted for ${route.replaceAll("_", " ")}.`,
+                                route,
+                                payload: {
+                                    repairHint: nextRepairHint,
+                                    budgetUsage: cascadeBudgetTrace(budgets),
+                                },
+                            });
+                            break;
+                        }
+                        recordLaneRepair(budgets, "execution");
                         attempt += 1;
-                        repairHint = decision.repairHint || failing.suggestedRepair;
+                        repairHint = nextRepairHint;
                         priorEvaluations = evaluations;
                         emit({
                             type: "repair.attempted",
                             message: `Repairing ${route.replaceAll("_", " ")}: ${repairHint}`,
                             route,
-                            payload: { attempt, repairHint },
+                            payload: { attempt, repairHint, budgetUsage: cascadeBudgetTrace(budgets) },
                         });
                         continue;
                     }
                     if (decision.decision === "escalate") {
-                        repairAttemptsTotal += 1;
-                        escalation = { route: decision.route, goal: decision.goal, hint: decision.repairHint || failing.suggestedRepair };
+                        if (!canUseEngineEscalation(budgets)) {
+                            stepStatus = "needs_review";
+                            emit({
+                                type: "escalated",
+                                message: `Escalation budget exhausted for ${route.replaceAll("_", " ")}.`,
+                                route,
+                                payload: { decision, budgetUsage: cascadeBudgetTrace(budgets) },
+                            });
+                            break;
+                        }
+                        recordEngineEscalation(budgets);
+                        escalation = { route: decision.route, goal: decision.goal, hint: repairHintForEvaluation(failing, decision.repairHint) };
                         stepStatus = "escalated";
                         emit({
                             type: "escalated",
                             message: `Escalating ${route.replaceAll("_", " ")} → ${decision.route.replaceAll("_", " ")}.`,
                             route,
-                            payload: decision,
+                            payload: { ...decision, budgetUsage: cascadeBudgetTrace(budgets) },
                         });
                         break;
                     }
@@ -426,6 +468,7 @@ export class AgentRunEngine {
                     id: stepId,
                     index: stepCount,
                     route,
+                    resolvedRoute: result.resolvedRoute,
                     goal: planned.goal,
                     successCriteria: planned.successCriteria,
                     status: outcome.status === "blocked" ? "blocked" : stepStatus,
@@ -462,6 +505,9 @@ export class AgentRunEngine {
                 finalStep = step;
                 finalResult = result;
                 finalOutcome = outcome;
+                if (outcome.status !== "blocked" && typeof result.answer === "string" && result.answer.trim().length > 0) {
+                    bestAnswerResult = result;
+                }
                 if (outcome.status === "blocked")
                     break;
                 if (isTerminalSuccess(route, outcome))
@@ -480,7 +526,8 @@ export class AgentRunEngine {
                 finalResult,
                 finalOutcome,
                 clarifyOutcome,
-                repairAttemptsTotal,
+                bestAnswerResult,
+                budgetUsage: cascadeBudgetTrace(budgets),
                 events,
             });
             emit({
@@ -489,6 +536,7 @@ export class AgentRunEngine {
                 route: run.route,
                 status: run.status,
                 trustState: run.trustState,
+                payload: { budgetUsage: run.budgetUsage },
             });
             run.completedAt = this.timestamp();
             await this.store?.save(run);
@@ -528,6 +576,8 @@ export class AgentRunEngine {
                 events,
                 nextActions: [],
                 repairAttempts: 0,
+                escalationAttempts: 0,
+                budgetUsage: cascadeBudgetTrace(createCascadeBudgetState(this.budgetModel)),
             };
             await this.store?.save(run);
             return run;
@@ -535,6 +585,8 @@ export class AgentRunEngine {
     }
     finalizeRun(input) {
         const { finalStep, finalResult, finalOutcome } = input;
+        const repairAttempts = input.budgetUsage.usage.laneExecutionAttemptsUsed;
+        const escalationAttempts = input.budgetUsage.usage.engineEscalationsUsed;
         const completedAt = this.timestamp();
         if (!finalStep || !finalResult || !finalOutcome) {
             // No step produced a usable result (e.g. an empty plan). Treat as blocked.
@@ -563,14 +615,21 @@ export class AgentRunEngine {
                     }],
                 events: input.events,
                 nextActions: [],
-                repairAttempts: input.repairAttemptsTotal,
+                repairAttempts,
+                escalationAttempts,
+                budgetUsage: input.budgetUsage,
             };
         }
-        const route = finalStep.route;
+        const route = finalResult.resolvedRoute ?? finalStep.resolvedRoute ?? finalStep.route;
         // Aggregate artifacts across every accepted step so a multi-step plan
         // (e.g. research → block draft) surfaces all of its durable work, while the
         // status/trust/answer reflect the final step.
         const artifacts = input.steps.flatMap((step) => step.artifacts);
+        // If the final step produced no user-facing answer (e.g. it only drafted an
+        // artifact), fall back to the last step that DID answer so the run never
+        // drops a data answer an earlier step already computed.
+        const finalHasAnswer = typeof finalResult.answer === "string" && finalResult.answer.trim().length > 0;
+        const answerSource = finalHasAnswer ? finalResult : (input.bestAnswerResult ?? finalResult);
         return {
             id: input.runId,
             question: input.request.question,
@@ -586,13 +645,15 @@ export class AgentRunEngine {
             plan: input.plan,
             steps: input.steps,
             summary: finalOutcome.summary,
-            answer: input.clarifyOutcome?.question ?? finalResult.answer,
-            answerKind: finalResult.answerKind ?? "governed",
+            answer: input.clarifyOutcome?.question ?? answerSource.answer,
+            answerKind: answerSource.answerKind ?? "governed",
             artifacts,
             evaluations: finalStep.evaluations,
             events: input.events,
             nextActions: applyAudienceToNextActions(finalResult.nextActions ?? defaultNextActions(route, finalOutcome.status), resolveAudience(input.request), finalOutcome.status),
-            repairAttempts: finalResult.repairAttempts ?? input.repairAttemptsTotal,
+            repairAttempts: finalResult.repairAttempts ?? repairAttempts,
+            escalationAttempts,
+            budgetUsage: input.budgetUsage,
         };
     }
     evaluate(context) {
@@ -635,6 +696,7 @@ function computeStepOutcome(route, result, evaluations, request, isClarify, clar
         artifacts,
         stopReason,
         summary: result.summary ?? fallback.summary,
+        ...(result.answerTier ? { terminalTier: result.answerTier } : {}),
     };
 }
 function isTerminalSuccess(route, outcome) {
@@ -644,7 +706,15 @@ function isTerminalSuccess(route, outcome) {
     // run loop ends naturally when the planned queue empties or maxSteps is hit.
     if (route === "conversation" && outcome.status === "completed")
         return true;
-    return route === "certified_answer" && outcome.status === "completed";
+    if (route === "certified_answer" && outcome.status === "completed")
+        return true;
+    // A governed SEMANTIC answer (deterministically compiled from the semantic layer)
+    // is as terminal as a certified block for a metric question — no further step adds
+    // trust. Generated SQL (generated_sql / business_context) stays NON-terminal so a
+    // multi-step plan can still chain a research step.
+    if (outcome.status === "completed" && outcome.terminalTier === "semantic_metric")
+        return true;
+    return false;
 }
 function describeReplan(decision) {
     switch (decision.decision) {
@@ -658,6 +728,12 @@ function describeReplan(decision) {
             return "Accepting the current result.";
     }
 }
+function repairHintForEvaluation(evaluation, plannerHint) {
+    return evaluation.repairAction?.hint
+        ?? plannerHint
+        ?? evaluation.suggestedRepair
+        ?? "Revise and retry.";
+}
 /**
  * The default, fully deterministic planner. Produces a single-step plan from the
  * existing route selection and drives repair/escalation from failing evaluations.
@@ -726,6 +802,19 @@ export function defaultSuccessCriteria(route) {
     }
 }
 function buildIntentDecision(request) {
+    const hasConversationContext = Boolean(request.conversationContext && Object.keys(request.conversationContext).length > 0);
+    const conversationalKind = classifyConversationalTurn(request.question, Boolean((request.history?.length ?? 0) > 0 || hasConversationContext));
+    if (request.requestedMode === "ask" && conversationalKind && hasConversationContext) {
+        return {
+            action: "converse",
+            confidence: 0.9,
+            reason: "This asks about the prior conversation, so I will answer from conversation context instead of querying governed data.",
+            conversationalKind,
+            category: "conversational",
+            source: "heuristic",
+            followsUp: true,
+        };
+    }
     const forcedAction = requestedModeToAction(request.requestedMode);
     if (forcedAction) {
         return {
@@ -754,42 +843,7 @@ function requestedModeToAction(mode) {
     return undefined;
 }
 export function selectRoute(request, decision) {
-    const mode = request.requestedMode ?? "auto";
-    if (mode === "research")
-        return "research";
-    if (mode === "sql")
-        return "sql_cell";
-    if (mode === "block")
-        return "dql_block_draft";
-    if (mode === "app")
-        return "app_build";
-    // A conversational turn is decided first — before the authoring/app regexes —
-    // so a greeting never trips "create a … block" style matches.
-    if (decision.action === "converse")
-        return "conversation";
-    const question = request.question;
-    if (looksLikeDqlBlockRequest(question))
-        return "dql_block_draft";
-    if (looksLikeSqlCellRequest(question))
-        return "sql_cell";
-    if (looksLikeComposeApp(question))
-        return "app_build";
-    if (decision.action === "compose_app")
-        return "app_build";
-    if (decision.action === "investigate")
-        return "research";
-    if (decision.action === "clarify")
-        return "clarify";
-    const certifiedScore = request.signals?.certifiedScore ?? 0;
-    if (certifiedScore >= CERTIFIED_MATCH_THRESHOLD)
-        return "certified_answer";
-    return "generated_answer";
-}
-function looksLikeSqlCellRequest(question) {
-    return /\b(sql|query|notebook cell|cell draft|write a select|generate a query)\b/i.test(question);
-}
-function looksLikeDqlBlockRequest(question) {
-    return /\b(dql block|block draft|draft block|create.*block|turn .* into .*block|promote .* block)\b/i.test(question);
+    return selectCascadeRunRoute(request, decision);
 }
 function defaultExecutorResult(route, request, decision) {
     const fallback = defaultOutcome(route);
@@ -834,7 +888,7 @@ function defaultOutcome(route) {
             };
     }
 }
-function defaultEvaluations(route, request, decision) {
+function defaultEvaluations(route, _request, decision) {
     // A conversational reply carries no governance checks — it renders as plain chat.
     if (route === "conversation")
         return [];
@@ -849,9 +903,9 @@ function defaultEvaluations(route, request, decision) {
         base.push({
             id: "certified-context",
             label: "Certified context",
-            passed: (request.signals?.certifiedScore ?? 0) >= CERTIFIED_MATCH_THRESHOLD,
-            severity: "blocking",
-            message: "A certified DQL block or governed artifact must cover the answer.",
+            passed: true,
+            severity: "info",
+            message: "Certified status must come from the route executor or resolved answer-loop tier, not token-overlap routing.",
         });
     }
     if (route === "generated_answer" || route === "sql_cell") {
@@ -976,12 +1030,12 @@ function defaultNextActions(route, status) {
     }
     if (route === "research") {
         return [
-            { id: "insert-sql", label: "Insert SQL cell", route: "sql_cell", artifactKind: "sql_cell" },
-            { id: "create-block", label: "Create DQL draft", route: "dql_block_draft", artifactKind: "dql_block_draft" },
+            { id: "create-block", label: "Review DQL draft", route: "dql_block_draft", artifactKind: "dql_block_draft" },
+            { id: "insert-sql", label: "Insert SQL preview", route: "sql_cell", artifactKind: "sql_cell" },
         ];
     }
     if (route === "sql_cell") {
-        return [{ id: "create-block", label: "Promote to DQL draft", route: "dql_block_draft", artifactKind: "dql_block_draft" }];
+        return [{ id: "create-block", label: "Review as DQL draft", route: "dql_block_draft", artifactKind: "dql_block_draft" }];
     }
     if (route === "dql_block_draft") {
         return [{ id: "open-review", label: "Open review checklist", artifactKind: "dql_block_draft" }];