@duckcodeailabs/dql-agent 1.6.28 → 1.6.30

package/dist/router.js

@@ -0,0 +1,246 @@
+/**
+ * Hybrid router — deterministic-first, LLM-assisted for the ambiguous middle.
+ *
+ * The engine already routes deterministically via {@link decideAgentAction}. That
+ * cascade is fast, offline, and confident for the clear cases (a strong certified
+ * match, an explicit "build me a dashboard", an obvious greeting). But paraphrased
+ * or implicit analytical asks land at low confidence and misroute — which is why
+ * users end up clicking "Dig deeper" by hand.
+ *
+ * This router keeps the deterministic decision when it is confident (>= the
+ * threshold) — so certified fast paths and greetings stay 0-LLM — and only spends
+ * ONE cheap classification call when the heuristics are unsure. The completion is
+ * injected (provider-agnostic, like the planner and narrator); any failure falls
+ * back to the deterministic decision unchanged. Results are cached so a repeated
+ * question never pays twice.
+ */
+import { classifyConversationalTurn, decideAgentAction, } from "./intent-controller.js";
+const DEFAULT_THRESHOLD = 0.7;
+const DEFAULT_CACHE_SIZE = 200;
+const DEFAULT_CACHE_TTL_MS = 10 * 60 * 1000;
+/**
+ * Map a router category to the fine-grained {@link MetadataAgentIntent} so the
+ * downstream answer loop keeps its existing behavior. Only used to enrich the
+ * decision — routing itself keys off `action`/`category`.
+ */
+function intentForCategory(category) {
+    switch (category) {
+        case "data_lookup":
+            return "ad_hoc_ranking";
+        case "data_analysis":
+            return "driver_breakdown";
+        case "general_knowledge":
+            return "definition_lookup";
+        default:
+            return undefined;
+    }
+}
+/** Translate a validated classification into an engine {@link IntentDecision}. */
+function classificationToDecision(classification, base) {
+    const followsUp = base.followsUp;
+    const common = {
+        category: classification.category,
+        depth: classification.depth,
+        source: "llm",
+        followsUp,
+    };
+    switch (classification.category) {
+        case "conversational":
+            return { action: "converse", confidence: 0.9, reason: classification.rationale, conversationalKind: "smalltalk", ...common };
+        case "capability":
+            return { action: "converse", confidence: 0.9, reason: classification.rationale, conversationalKind: "meta_capability", ...common };
+        case "general_knowledge":
+            // Rendered as a conversation reply, but tagged general_knowledge downstream.
+            return { action: "converse", confidence: 0.85, reason: classification.rationale, ...common };
+        case "app":
+            return { action: "compose_app", confidence: 0.82, reason: classification.rationale, ...common };
+        case "data_analysis":
+            return { action: "investigate", confidence: 0.8, reason: classification.rationale, ...common };
+        case "authoring":
+            return { action: "answer", confidence: 0.75, reason: classification.rationale, ...common };
+        case "data_lookup":
+            return { action: "answer", confidence: 0.75, reason: classification.rationale, ...common };
+        case "unclear":
+        default:
+            return {
+                action: "clarify",
+                confidence: 0.6,
+                reason: classification.rationale,
+                clarifyingQuestion: classification.needsClarification && classification.clarifyingQuestion
+                    ? classification.clarifyingQuestion
+                    : base.clarifyingQuestion,
+                ...common,
+            };
+    }
+}
+function buildSystemPrompt() {
+    return [
+        "You classify a user's turn in DQL, a governed analytics notebook, so the agent routes it well.",
+        "Pick ONE category:",
+        "- conversational: greeting, thanks, small talk — no data or knowledge needed.",
+        "- capability: asking what the assistant/DQL can do.",
+        "- general_knowledge: a factual question answerable from world knowledge, NOT the user's data (e.g. 'what is dbt?').",
+        "- data_lookup: a specific value/ranking answerable from the user's governed data (e.g. 'total revenue', 'top 10 customers').",
+        "- data_analysis: why / root-cause / driver / breakdown / comparison / trend / anomaly — needs multi-step investigation.",
+        "- authoring: user wants a SQL cell or a DQL block created.",
+        "- app: user wants a dashboard / app / standing view assembled.",
+        "- unclear: a real request but missing the business object, measure, or grain needed to proceed.",
+        "Also pick depth: 'deep' for data_analysis or anything needing several steps; otherwise 'quick'.",
+        "If unclear, set needsClarification true and give ONE sharp clarifyingQuestion.",
+        "Respond with ONLY a JSON object, no prose, no code fences:",
+        '{"category": string, "depth": "quick"|"deep", "needsClarification": boolean, "clarifyingQuestion"?: string, "rationale": string}',
+    ].join("\n");
+}
+function buildUserPrompt(request, catalogContext) {
+    const lines = [];
+    lines.push(`Turn: ${request.question}`);
+    if (request.history?.length) {
+        const recent = request.history.slice(-4).map((turn) => `${turn.role}: ${turn.text}`).join("\n");
+        lines.push(`Recent conversation:\n${recent}`);
+    }
+    if (request.signals)
+        lines.push(`Retrieval signals: ${JSON.stringify(request.signals)}`);
+    if (catalogContext)
+        lines.push(`Available governed data (so you can tell data from general knowledge):\n${catalogContext}`);
+    lines.push("Return the classification as JSON.");
+    return lines.join("\n");
+}
+const CATEGORIES = new Set([
+    "conversational",
+    "capability",
+    "general_knowledge",
+    "data_lookup",
+    "data_analysis",
+    "authoring",
+    "app",
+    "unclear",
+]);
+/** Extract the first balanced JSON object from model text (tolerant of fences/prose). */
+function extractJsonObject(raw) {
+    const trimmed = raw.trim().replace(/^```(?:json)?/i, "").replace(/```$/i, "").trim();
+    const start = trimmed.indexOf("{");
+    if (start < 0)
+        return undefined;
+    let depth = 0;
+    let inString = false;
+    let escaped = false;
+    for (let i = start; i < trimmed.length; i += 1) {
+        const char = trimmed[i];
+        if (inString) {
+            if (escaped)
+                escaped = false;
+            else if (char === "\\")
+                escaped = true;
+            else if (char === '"')
+                inString = false;
+            continue;
+        }
+        if (char === '"')
+            inString = true;
+        else if (char === "{")
+            depth += 1;
+        else if (char === "}") {
+            depth -= 1;
+            if (depth === 0) {
+                try {
+                    return JSON.parse(trimmed.slice(start, i + 1));
+                }
+                catch {
+                    return undefined;
+                }
+            }
+        }
+    }
+    return undefined;
+}
+function parseClassification(raw) {
+    const parsed = extractJsonObject(raw);
+    if (!parsed || typeof parsed !== "object")
+        return undefined;
+    const record = parsed;
+    const category = record.category;
+    if (typeof category !== "string" || !CATEGORIES.has(category))
+        return undefined;
+    const depth = record.depth === "deep" ? "deep" : "quick";
+    const needsClarification = record.needsClarification === true;
+    const clarifyingQuestion = typeof record.clarifyingQuestion === "string" && record.clarifyingQuestion.trim().length > 0
+        ? record.clarifyingQuestion.trim()
+        : undefined;
+    const rationale = typeof record.rationale === "string" && record.rationale.trim().length > 0
+        ? record.rationale.trim()
+        : "Classified by the AI router.";
+    return {
+        category: category,
+        depth,
+        needsClarification,
+        clarifyingQuestion,
+        rationale,
+    };
+}
+/** Normalize a question for cache keying (whitespace/case-insensitive). */
+function cacheKey(request) {
+    const q = request.question.trim().toLowerCase().replace(/\s+/g, " ");
+    const last = request.history?.length ? request.history[request.history.length - 1].text.trim().toLowerCase() : "";
+    return `${q}${last}`;
+}
+/**
+ * Build a hybrid router. Runs the deterministic cascade first and returns it
+ * unchanged when confident; otherwise spends one cached LLM classification call,
+ * falling back to the deterministic decision on any failure.
+ */
+export function createHybridRouter(options = {}) {
+    const threshold = options.llmThreshold ?? DEFAULT_THRESHOLD;
+    const cacheSize = options.cacheSize ?? DEFAULT_CACHE_SIZE;
+    const cacheTtlMs = options.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS;
+    const cache = new Map();
+    let tick = 0;
+    const now = options.now ?? (() => { tick += 1; return tick; });
+    const deterministic = (request) => {
+        const conversationalKind = classifyConversationalTurn(request.question, (request.history?.length ?? 0) > 0);
+        return decideAgentAction({
+            question: request.question,
+            intent: request.intent ?? (conversationalKind ? "clarify" : "ad_hoc_ranking"),
+            signals: request.signals,
+            history: request.history,
+        });
+    };
+    return {
+        async decide(request) {
+            const base = deterministic(request);
+            // Confident heuristic (or no LLM available) → keep the fast, offline decision.
+            if (base.confidence >= threshold || !options.complete) {
+                return { ...base, source: base.source ?? "heuristic" };
+            }
+            const key = cacheKey(request);
+            const cached = cache.get(key);
+            if (cached && (options.cacheTtlMs === undefined || now() - cached.at < cacheTtlMs)) {
+                return { ...cached.decision, source: "cache" };
+            }
+            try {
+                const catalogContext = options.getCatalogContext ? await options.getCatalogContext(request) : undefined;
+                const raw = await options.complete({
+                    system: buildSystemPrompt(),
+                    user: buildUserPrompt(request, catalogContext),
+                    signal: options.signal,
+                });
+                const classification = parseClassification(raw);
+                if (classification) {
+                    const decision = classificationToDecision(classification, base);
+                    cache.set(key, { decision, at: now() });
+                    if (cache.size > cacheSize) {
+                        const oldest = cache.keys().next().value;
+                        if (oldest !== undefined)
+                            cache.delete(oldest);
+                    }
+                    return decision;
+                }
+            }
+            catch {
+                // fall through to deterministic
+            }
+            return { ...base, source: "heuristic" };
+        },
+    };
+}
+export { intentForCategory };
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

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

package/dist/synthesize.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Answer synthesis — turn a governed result into a reply whose *shape* matches the
+ * question, instead of one static template for everything.
+ *
+ * The answer loop already produces a correct result (rows) and a draft summary from
+ * its SQL-generation call. This step composes the final prose the user reads, with
+ * format rules keyed on the question type and audience:
+ *   - lookup → the number + one sentence, nothing else
+ *   - comparison / breakdown → a short table (supplied rows only) + one insight
+ *   - research → sections (What I found / What's driving it / Caveats / Next step)
+ *   - stakeholder → plain language, no SQL talk; analyst → may reference SQL
+ * Trust boilerplate ("uncertified until reviewed") is NOT prose — the badge owns it.
+ *
+ * Provider-agnostic and offline-safe: the completion is injected (like `narrate`),
+ * and any failure falls back to a deterministic reply built from the draft + rows.
+ */
+export type SynthesisFormat = "lookup" | "comparison" | "research" | "prose";
+export interface SynthesizeResultPreview {
+    columns: string[];
+    rows: Array<Record<string, unknown>>;
+    rowCount: number;
+}
+export interface SynthesizeInput {
+    question: string;
+    /** Router/metadata category, if known (drives the default format). */
+    category?: string;
+    audience?: "analyst" | "stakeholder";
+    /** The bounded result the answer is grounded in (columns + up to ~20 rows). */
+    resultPreview?: SynthesizeResultPreview;
+    /** The SQL that produced the result (analyst-facing only). */
+    sql?: string;
+    /** The loop's draft summary — the deterministic floor when no LLM is available. */
+    draftText?: string;
+    /** Research findings (from narrateResult) to weave into a sectioned answer. */
+    findings?: string[];
+    /** Known gaps/caveats to surface honestly. */
+    gaps?: string[];
+}
+/** Injected text completion, optionally streaming token deltas. */
+export type SynthesizeCompletion = (input: {
+    system: string;
+    user: string;
+    signal?: AbortSignal;
+    onDelta?: (delta: string) => void;
+}) => Promise<string>;
+export interface SynthesizeOptions {
+    complete?: SynthesizeCompletion;
+    onDelta?: (delta: string) => void;
+    signal?: AbortSignal;
+    /** Force a format; otherwise inferred from category + result shape. */
+    format?: SynthesisFormat;
+}
+export interface SynthesizeResult {
+    text: string;
+    format: SynthesisFormat;
+    source: "llm" | "deterministic";
+}
+/** Pick the answer shape from category + question + result cardinality. */
+export declare function inferFormat(input: SynthesizeInput): SynthesisFormat;
+/**
+ * Compose the final answer. Streams token deltas through `options.onDelta` when the
+ * injected completion supports it; always returns the full text (and a deterministic
+ * floor on any failure).
+ */
+export declare function synthesizeAnswer(input: SynthesizeInput, options?: SynthesizeOptions): Promise<SynthesizeResult>;
+//# sourceMappingURL=synthesize.d.ts.map

package/dist/synthesize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesize.d.ts","sourceRoot":"","sources":["../src/synthesize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,OAAO,CAAC;AAE7E,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,SAAS,GAAG,aAAa,CAAC;IACrC,+EAA+E;IAC/E,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,mEAAmE;AACnE,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEtB,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,uEAAuE;IACvE,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,KAAK,GAAG,eAAe,CAAC;CACjC;AAKD,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,eAAe,CAOnE;AAoFD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiBzH"}

package/dist/synthesize.js

@@ -0,0 +1,137 @@
+/**
+ * Answer synthesis — turn a governed result into a reply whose *shape* matches the
+ * question, instead of one static template for everything.
+ *
+ * The answer loop already produces a correct result (rows) and a draft summary from
+ * its SQL-generation call. This step composes the final prose the user reads, with
+ * format rules keyed on the question type and audience:
+ *   - lookup → the number + one sentence, nothing else
+ *   - comparison / breakdown → a short table (supplied rows only) + one insight
+ *   - research → sections (What I found / What's driving it / Caveats / Next step)
+ *   - stakeholder → plain language, no SQL talk; analyst → may reference SQL
+ * Trust boilerplate ("uncertified until reviewed") is NOT prose — the badge owns it.
+ *
+ * Provider-agnostic and offline-safe: the completion is injected (like `narrate`),
+ * and any failure falls back to a deterministic reply built from the draft + rows.
+ */
+const COMPARISON_RE = /\b(compare|versus|vs\.?|by |per |breakdown|break down|top \d+|rank|distribution|segment|cohort|across)\b/i;
+const RESEARCH_RE = /\b(why|driver|drivers|root cause|what happened|what changed|investigate|anomal|trend|explain)\b/i;
+/** Pick the answer shape from category + question + result cardinality. */
+export function inferFormat(input) {
+    if (input.category === "data_analysis" || (input.findings && input.findings.length > 0))
+        return "research";
+    if (RESEARCH_RE.test(input.question))
+        return "research";
+    const rowCount = input.resultPreview?.rowCount ?? input.resultPreview?.rows.length ?? 0;
+    if (COMPARISON_RE.test(input.question) && rowCount > 1)
+        return "comparison";
+    if (rowCount <= 1)
+        return "lookup";
+    return "prose";
+}
+function buildSystemPrompt(format, audience) {
+    const lines = [
+        "You compose the final answer a user reads in DQL, a governed analytics tool.",
+        "Use ONLY numbers that appear in the provided rows — never invent or estimate values.",
+        "Do NOT add trust disclaimers (e.g. 'uncertified', 'review required') — the UI shows a trust badge separately.",
+        "Do NOT say 'As an AI' or narrate your process. Be direct and concrete.",
+    ];
+    if (audience === "stakeholder") {
+        lines.push("Audience: a business stakeholder. Use plain language; do NOT mention SQL, tables, or columns.");
+    }
+    else {
+        lines.push("Audience: an analyst. You may reference tables/columns; keep SQL talk minimal.");
+    }
+    switch (format) {
+        case "lookup":
+            lines.push("Format: state the single value and one short sentence of context. Nothing else — no headings, no table.");
+            break;
+        case "comparison":
+            lines.push("Format: a short GitHub-flavored markdown table built ONLY from the provided rows, then ONE insight sentence beneath it.");
+            break;
+        case "research":
+            lines.push("Format: use these sections as `## ` headings, omitting any that would be empty:", "## What I found\n## What's driving it\n## Caveats\n## Suggested next step", "Keep each section to 1-3 sentences. Ground every claim in the provided findings/rows.");
+            break;
+        default:
+            lines.push("Format: 1-3 tight sentences. Add a small markdown table only if it genuinely aids clarity.");
+    }
+    return lines.join("\n");
+}
+function previewToText(preview, limit = 20) {
+    if (!preview || preview.rows.length === 0)
+        return "(no rows)";
+    const cols = preview.columns.length > 0 ? preview.columns : Object.keys(preview.rows[0] ?? {});
+    const header = `| ${cols.join(" | ")} |`;
+    const sep = `| ${cols.map(() => "---").join(" | ")} |`;
+    const body = preview.rows.slice(0, limit).map((row) => `| ${cols.map((col) => formatCell(row[col])).join(" | ")} |`);
+    const more = preview.rows.length > limit ? `\n(${preview.rows.length - limit} more rows not shown)` : "";
+    return [header, sep, ...body].join("\n") + more;
+}
+function formatCell(value) {
+    if (value === null || value === undefined)
+        return "";
+    if (typeof value === "number")
+        return String(value);
+    return String(value).replace(/\|/g, "\\|");
+}
+function buildUserPrompt(input) {
+    const lines = [];
+    lines.push(`Question: ${input.question}`);
+    if (input.resultPreview)
+        lines.push(`Result (${input.resultPreview.rowCount} rows):\n${previewToText(input.resultPreview)}`);
+    if (input.findings?.length)
+        lines.push(`Findings:\n${input.findings.map((f) => `- ${f}`).join("\n")}`);
+    if (input.gaps?.length)
+        lines.push(`Known gaps/caveats:\n${input.gaps.map((g) => `- ${g}`).join("\n")}`);
+    if (input.sql && input.audience !== "stakeholder")
+        lines.push(`SQL used:\n${input.sql}`);
+    lines.push("Write the answer now.");
+    return lines.join("\n\n");
+}
+/** Deterministic floor — the loop's draft, or a line built from the top row. */
+function deterministicSynthesis(input, format) {
+    if (input.draftText && input.draftText.trim().length > 0) {
+        return { text: input.draftText.trim(), format, source: "deterministic" };
+    }
+    const preview = input.resultPreview;
+    if (format === "comparison" && preview && preview.rows.length > 1) {
+        return { text: previewToText(preview), format, source: "deterministic" };
+    }
+    if (preview && preview.rows.length >= 1) {
+        const cols = preview.columns.length > 0 ? preview.columns : Object.keys(preview.rows[0] ?? {});
+        const first = preview.rows[0];
+        const parts = cols.slice(0, 3).map((col) => `${col}: ${formatCell(first[col])}`);
+        return { text: parts.join(", "), format, source: "deterministic" };
+    }
+    if (input.findings?.length) {
+        return { text: input.findings.map((f) => `- ${f}`).join("\n"), format, source: "deterministic" };
+    }
+    return { text: "No result was available for this question.", format, source: "deterministic" };
+}
+/**
+ * Compose the final answer. Streams token deltas through `options.onDelta` when the
+ * injected completion supports it; always returns the full text (and a deterministic
+ * floor on any failure).
+ */
+export async function synthesizeAnswer(input, options = {}) {
+    const format = options.format ?? inferFormat(input);
+    const floor = deterministicSynthesis(input, format);
+    if (!options.complete)
+        return floor;
+    try {
+        const raw = await options.complete({
+            system: buildSystemPrompt(format, input.audience ?? "analyst"),
+            user: buildUserPrompt(input),
+            signal: options.signal,
+            onDelta: options.onDelta,
+        });
+        const text = raw.trim();
+        if (text.length > 0)
+            return { text, format, source: "llm" };
+    }
+    catch {
+        // fall through to deterministic
+    }
+    return floor;
+}
+//# sourceMappingURL=synthesize.js.map

package/dist/synthesize.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duckcodeailabs/dql-agent",
-  "version": "1.6.28",
+  "version": "1.6.30",
   "description": "DQL agent: knowledge graph, Skills, block-first answer loop, and pluggable LLM providers (Claude / OpenAI / Gemini / Ollama)",
   "license": "Apache-2.0",
   "type": "module",
@@ -24,10 +24,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@duckcodeailabs/dql-core": "^1.6.28",
-    "@duckcodeailabs/dql-governance": "^1.6.28",
-    "@duckcodeailabs/dql-project": "^1.6.28",
-    "better-sqlite3": "^11.7.0",
+    "@duckcodeailabs/dql-core": "^1.6.30",
+    "@duckcodeailabs/dql-governance": "^1.6.30",
+    "@duckcodeailabs/dql-project": "^1.6.30",
+    "better-sqlite3": "^12.11.1",
     "js-yaml": "^4.1.1"
   },
   "devDependencies": {
@@ -38,7 +38,7 @@
     "vitest": "^3.0.0"
   },
   "engines": {
-    "node": ">=20 <23"
+    "node": ">=20"
   },
   "scripts": {
     "build": "rm -rf dist tsconfig.tsbuildinfo && tsc -b",