@duckcodeailabs/dql-cli 1.14.0 → 1.14.2

package/dist/llm/analyst-loop-tools.js

@@ -0,0 +1,56 @@
+import { buildPreviewQueryTool, buildSearchValuesTool, buildSemanticStageTools, } from '@duckcodeailabs/dql-agent';
+/**
+ * The tools the analyst loop may call.
+ *
+ * `buildAnswerLoopTools` carries the host's catalog tools, but NOT the governed
+ * semantic ones — so a loop given only those could search metadata and validate
+ * SQL, yet never compile a governed query. `compile_semantic_query` is the IR:
+ * metrics + dimensions + grain + filters in, dialect SQL or a typed refusal out.
+ * It is also the only path whose output the pipeline will label governed, since
+ * it validates every member against the layer instead of trusting the model.
+ *
+ * Extracted from the provider seam so the tool surface is assertable directly;
+ * it is the loop's entire view of what it can do, and a silently missing tool
+ * degrades answers rather than failing loudly.
+ */
+export function buildAnalystLoopTools(loopInput, options) {
+    const execute = loopInput.executeGeneratedSql;
+    const semanticTools = buildSemanticStageTools({
+        ...(loopInput.semanticLayer ? { semanticLayer: loopInput.semanticLayer } : {}),
+        kg: loopInput.kg,
+        ...(loopInput.semanticDriver ? { driver: loopInput.semanticDriver } : {}),
+        ...(loopInput.semanticTableMapping ? { tableMapping: loopInput.semanticTableMapping } : {}),
+        ...(loopInput.semanticQueryCompiler
+            ? { semanticQueryCompiler: loopInput.semanticQueryCompiler }
+            : {}),
+    });
+    return [
+        ...(loopInput.answerLoopTools ?? []),
+        ...semanticTools,
+        // `preview_query` lets the loop ESTABLISH identifiers rather than only
+        // verify ones another tool happened to surface: the warehouse resolving a
+        // name is the strongest evidence it exists. Only offered when an executor
+        // is present — without one the tool could only ever fail.
+        ...(execute ? [buildPreviewQueryTool((sql) => execute(sql))] : []),
+        // `search_values` is the antidote to the recorded false-absence defect:
+        // without it a named member can never become a filter, the plan freezes
+        // filterless, and a truncated result gets narrated as absence. Probing is
+        // opt-in per project, and the tool says so rather than returning a silent
+        // empty result — "did not look" and "looked and found nothing" are
+        // different facts, and only one of them licenses an absence claim.
+        ...(execute
+            ? [buildSearchValuesTool({
+                    execute: async (sql) => execute(sql),
+                    relations: (loopInput.schemaContext ?? []).map((table) => ({
+                        relation: table.relation,
+                        columns: (table.columns ?? []).map((column) => ({
+                            name: column.name,
+                            ...(column.type ? { type: column.type } : {}),
+                        })),
+                    })),
+                    enabled: options.valuesEnabled,
+                })]
+            : []),
+    ];
+}
+//# sourceMappingURL=analyst-loop-tools.js.map

package/dist/llm/analyst-loop-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyst-loop-tools.js","sourceRoot":"","sources":["../../src/llm/analyst-loop-tools.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AAEnC;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAA0B,EAC1B,OAAmC;IAEnC,MAAM,OAAO,GAAG,SAAS,CAAC,mBAAmB,CAAC;IAC9C,MAAM,aAAa,GAAG,uBAAuB,CAAC;QAC5C,GAAG,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,SAAS,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,EAAE,EAAE,SAAS,CAAC,EAAE;QAChB,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,GAAG,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,SAAS,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3F,GAAG,CAAC,SAAS,CAAC,qBAAqB;YACjC,CAAC,CAAC,EAAE,qBAAqB,EAAE,SAAS,CAAC,qBAAqB,EAAE;YAC5D,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC;IACH,OAAO;QACL,GAAG,CAAC,SAAS,CAAC,eAAe,IAAI,EAAE,CAAC;QACpC,GAAG,aAAa;QAChB,uEAAuE;QACvE,0EAA0E;QAC1E,0EAA0E;QAC1E,0DAA0D;QAC1D,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,wEAAwE;QACxE,wEAAwE;QACxE,0EAA0E;QAC1E,0EAA0E;QAC1E,mEAAmE;QACnE,mEAAmE;QACnE,GAAG,CAAC,OAAO;YACT,CAAC,CAAC,CAAC,qBAAqB,CAAC;oBACrB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;oBACpC,SAAS,EAAE,CAAC,SAAS,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;wBACzD,QAAQ,EAAE,KAAK,CAAC,QAAQ;wBACxB,OAAO,EAAE,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;4BAC9C,IAAI,EAAE,MAAM,CAAC,IAAI;4BACjB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;yBAC9C,CAAC,CAAC;qBACJ,CAAC,CAAC;oBACH,OAAO,EAAE,OAAO,CAAC,aAAa;iBAC/B,CAAC,CAAC;YACL,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC"}

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

@@ -1,4 +1,5 @@
-import { type AgentAnswer, type CertifiedFitConfirmation, type AgentFollowUpContext, type AgentProvider, type ConversationSnapshot, type LocalContextPack } from '@duckcodeailabs/dql-agent';
+import { type ProviderFailureDiagnosticV1 } from '@duckcodeailabs/dql-agent';
+import { type AgentAnswer, type CertifiedFitConfirmation, type AgentFollowUpContext, type AgentProvider, type ConversationSnapshot, type LocalContextPack, type AgenticLane } from '@duckcodeailabs/dql-agent';
 import type { AgentRunRequest, AgentRunner, ProviderId } from '../types.js';
 import { buildAnswerLoopTools } from '../answer-loop-tools.js';
 /**
@@ -7,6 +8,18 @@ import { buildAnswerLoopTools } from '../answer-loop-tools.js';
  * used as plain completion backends here, distinct from the MCP `claudeCodeRunner`.
  */
 type SimpleProviderId = Extract<ProviderId, 'anthropic' | 'openai' | 'gemini' | 'ollama' | 'custom-openai'> | 'claude-code' | 'codex';
+/**
+ * Capture a content-free provider failure at the closest boundary. Local
+ * runtime may later choose a user-facing headline, but must not need raw
+ * provider errors or URLs to reconstruct the cause.
+ */
+declare function providerBoundaryDiagnostic(input: {
+    providerId: SimpleProviderId;
+    projectRoot: string;
+    phase: ProviderFailureDiagnosticV1['phase'];
+    error?: unknown;
+    code?: string;
+}): ProviderFailureDiagnosticV1;
 declare function createCertifiedFitConfirmation(provider: AgentProvider, signal?: AbortSignal): CertifiedFitConfirmation;
 /**
  * Decide whether the answer path needs a live warehouse-schema read up front.
@@ -23,6 +36,40 @@ declare function parseCertifiedFitConfirmation(text: string): {
     confidence?: 'high' | 'medium' | 'low';
     reason?: string;
 };
+declare function readAgentConfig(projectRoot: string): Record<string, unknown> | null;
+/**
+ * Which migration lane this turn belongs to.
+ *
+ * Research is identified by the server-resolved `orchestrationMode`, not by
+ * `analysisDepth`. A reader can ask Ask AI to think deeply without opting into
+ * the Research workflow, its wider dispatch budget, or any row-bearing tools.
+ *
+ * Deliberately coarse: the seam only needs to know which bucket a turn falls in
+ * so a lane can be enabled independently. The fine-grained triage between
+ * certified, semantic, and generated stays inside the answer path, where the
+ * retrieval evidence lives.
+ */
+declare function agenticLaneForRequest(req: AgentRunRequest): AgenticLane;
+export declare function applyEvalCassette(provider: AgentProvider, projectRoot: string): AgentProvider;
+/**
+ * Create a replay-only provider when the runtime is launched for an offline
+ * evaluation. This is intentionally unavailable outside explicit cassette
+ * replay: recording and live modes still require a configured real provider.
+ *
+ * The cassette's recorded provider identity is part of its key. Recover it
+ * from a single-provider cassette directory instead of borrowing a user's
+ * active provider or guessing from an API setting. The base provider cannot
+ * make a network call; replay misses remain CassetteMissError failures.
+ */
+export declare function createEvalCassetteReplayProvider(projectRoot: string): AgentProvider | undefined;
+/**
+ * A raw text provider for planning calls that are not the answer itself.
+ *
+ * Research hypothesis planning needs `generate`, not the full agent runner —
+ * and the runner cannot be reused for it, because the runner IS the governed
+ * answer path. Cassettes apply, so a recorded run stays hermetic.
+ */
+export declare function createGovernedTextProvider(id: SimpleProviderId, projectRoot: string): AgentProvider | undefined;
 export declare function createDqlAgentProviderRunner(id: SimpleProviderId, providerOverride?: AgentProvider): AgentRunner;
 /**
  * When the prior assistant turn was a clarifying question and this turn is the user's
@@ -71,6 +118,7 @@ declare function applyTopicShiftGuard(followUp: AgentFollowUpContext | undefined
 export declare function resolveAgentFollowUpContext(rawContext: Record<string, unknown> | undefined, question: string, snapshot?: ConversationSnapshot): AgentFollowUpContext | undefined;
 declare function followUpFromConversationContext(req: AgentRunRequest, question: string): AgentFollowUpContext | undefined;
 export declare const __test__: {
+    agenticLaneForRequest: typeof agenticLaneForRequest;
     applyTopicShiftGuard: typeof applyTopicShiftGuard;
     isDrilldownFollowUp: typeof isDrilldownFollowUp;
     buildAnswerLoopTools: typeof buildAnswerLoopTools;
@@ -84,6 +132,8 @@ export declare const __test__: {
     shouldSearchProjectFiles: typeof shouldSearchProjectFiles;
     renderProjectSourceSearch: typeof renderProjectSourceSearch;
     researchDispatchPurposeForTool: typeof researchDispatchPurposeForTool;
+    readAgentConfig: typeof readAgentConfig;
+    providerBoundaryDiagnostic: typeof providerBoundaryDiagnostic;
 };
 declare function researchDispatchPurposeForTool(toolName: string): 'research_narration' | 'research_tool';
 /**

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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"}