@greyworld/code-check-core 1.0.0

package/dist/tools/llm/description-intent/format-spec.js

@@ -0,0 +1,167 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFormatSpec = getFormatSpec;
+const line_pattern_1 = require("../../line-pattern");
+const VALUE_RANGE_PATTERN = new line_pattern_1.LinePattern([
+    (0, line_pattern_1.keyword)("The valid value is range from"),
+    (0, line_pattern_1.spaces)(1),
+    (0, line_pattern_1.backticked)("min"),
+    (0, line_pattern_1.spaces)(1),
+    (0, line_pattern_1.keyword)("to"),
+    (0, line_pattern_1.spaces)(1),
+    (0, line_pattern_1.backticked)("max"),
+    (0, line_pattern_1.literal)("."),
+]);
+const ENUM_INTRO_PATTERN = new line_pattern_1.LinePattern([
+    (0, line_pattern_1.keyword)("The valid values are as follow:"),
+]);
+const ENUM_ITEM_PATTERN = new line_pattern_1.LinePattern([
+    (0, line_pattern_1.literal)("+ "),
+    (0, line_pattern_1.literal)("**"),
+    (0, line_pattern_1.rest)("value"),
+]);
+const MAX_LENGTH_REGEX = /contain a maximum of `[^`]+` characters\./;
+const DEFAULT_VALUE_PATTERN = new line_pattern_1.LinePattern([
+    (0, line_pattern_1.keyword)("The default value is"),
+    (0, line_pattern_1.spaces)(1),
+    (0, line_pattern_1.backticked)("value"),
+    (0, line_pattern_1.literal)("."),
+]);
+const CHAR_RESTRICTION_PATTERN = new line_pattern_1.LinePattern([
+    (0, line_pattern_1.keyword)("Only the"),
+    (0, line_pattern_1.spaces)(1),
+    (0, line_pattern_1.rest)("char_types_and_suffix"),
+]);
+const VALUE_RANGE_SPEC = {
+    intent: "value-range",
+    validate(lines) {
+        const expected = VALUE_RANGE_PATTERN.toDisplayFormat();
+        const target = findRelevantLine(lines, /valid\s+value.*range|range\s+from/i);
+        if (!target) {
+            return {
+                ok: false,
+                expected,
+                detail: "No line matches value-range pattern",
+            };
+        }
+        const ok = VALUE_RANGE_PATTERN.test(target);
+        return {
+            ok,
+            expected,
+            detail: ok ? undefined : VALUE_RANGE_PATTERN.describeFailure(target) ?? undefined,
+        };
+    },
+};
+const ENUM_VALUES_SPEC = {
+    intent: "enum-values",
+    validate(lines) {
+        const introExpected = ENUM_INTRO_PATTERN.toDisplayFormat();
+        if (lines.length === 0) {
+            return { ok: false, expected: introExpected, detail: "No lines to check" };
+        }
+        const introLine = lines[0].trim();
+        if (!ENUM_INTRO_PATTERN.test(introLine)) {
+            return {
+                ok: false,
+                expected: introExpected,
+                detail: ENUM_INTRO_PATTERN.describeFailure(introLine) ?? undefined,
+            };
+        }
+        const itemLines = lines.slice(1).filter((l) => l.trim().length > 0);
+        for (const line of itemLines) {
+            const trimmed = line.trim();
+            if (!ENUM_ITEM_PATTERN.test(trimmed)) {
+                return {
+                    ok: false,
+                    expected: "+ **value**: description",
+                    detail: `Invalid enum item: "${trimmed}"`,
+                };
+            }
+        }
+        return { ok: true, expected: introExpected };
+    },
+};
+const CHAR_RESTRICTION_SPEC = {
+    intent: "char-restriction",
+    validate(lines) {
+        const expected = "Only the {char_types} are allowed";
+        const target = findRelevantLine(lines, /only\s+the\b/i);
+        if (!target) {
+            return {
+                ok: false,
+                expected,
+                detail: "No line matches char-restriction pattern",
+            };
+        }
+        const ok = CHAR_RESTRICTION_PATTERN.test(target);
+        if (!ok) {
+            return {
+                ok: false,
+                expected,
+                detail: CHAR_RESTRICTION_PATTERN.describeFailure(target) ?? undefined,
+            };
+        }
+        if (!/are allowed/i.test(target)) {
+            return { ok: false, expected, detail: "Missing \"are allowed\" suffix" };
+        }
+        return { ok: true, expected };
+    },
+};
+const MAX_LENGTH_SPEC = {
+    intent: "max-length",
+    validate(lines) {
+        const expected = "... contain a maximum of `N` characters.";
+        const target = findRelevantLine(lines, /maximum|at most/i);
+        if (!target) {
+            return {
+                ok: false,
+                expected,
+                detail: "No line matches max-length pattern",
+            };
+        }
+        const ok = MAX_LENGTH_REGEX.test(target);
+        return {
+            ok,
+            expected,
+            detail: ok ? undefined : `Got: "${target}"`,
+        };
+    },
+};
+const DEFAULT_VALUE_SPEC = {
+    intent: "default-value",
+    validate(lines) {
+        const expected = DEFAULT_VALUE_PATTERN.toDisplayFormat();
+        const target = findRelevantLine(lines, /default\s+value/i);
+        if (!target) {
+            return {
+                ok: false,
+                expected,
+                detail: "No line matches default-value pattern",
+            };
+        }
+        const ok = DEFAULT_VALUE_PATTERN.test(target);
+        return {
+            ok,
+            expected,
+            detail: ok ? undefined : DEFAULT_VALUE_PATTERN.describeFailure(target) ?? undefined,
+        };
+    },
+};
+const SPEC_MAP = new Map([
+    ["value-range", VALUE_RANGE_SPEC],
+    ["enum-values", ENUM_VALUES_SPEC],
+    ["char-restriction", CHAR_RESTRICTION_SPEC],
+    ["max-length", MAX_LENGTH_SPEC],
+    ["default-value", DEFAULT_VALUE_SPEC],
+]);
+function getFormatSpec(intent) {
+    return SPEC_MAP.get(intent);
+}
+function findRelevantLine(lines, pattern) {
+    for (const line of lines) {
+        if (pattern.test(line))
+            return line.trim();
+    }
+    return null;
+}
+//# sourceMappingURL=format-spec.js.map

package/dist/tools/llm/description-intent/format-spec.js.map

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

package/dist/tools/llm/description-intent/index.d.ts

@@ -0,0 +1,7 @@
+export { DescriptionIntentDetector } from "./intent-detector";
+export { extractSlotsForIntent } from "./slot-extractor";
+export { suggestNormalizedSentence } from "./normalizer";
+export { getFormatSpec } from "./format-spec";
+export { DESCRIPTION_INTENTS, DETECTABLE_DESCRIPTION_INTENTS, } from "./types";
+export type { DescriptionIntent, DetectableDescriptionIntent, SlotMap, SlotValue, IntentResult, IntentDetectionResult, DetectionStatus, FormatValidationResult, DescriptionFormatSpec, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/llm/description-intent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/llm/description-intent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EACH,mBAAmB,EACnB,8BAA8B,GACjC,MAAM,SAAS,CAAC;AACjB,YAAY,EACR,iBAAiB,EACjB,2BAA2B,EAC3B,OAAO,EACP,SAAS,EACT,YAAY,EACZ,qBAAqB,EACrB,eAAe,EACf,sBAAsB,EACtB,qBAAqB,GACxB,MAAM,SAAS,CAAC"}

package/dist/tools/llm/description-intent/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DETECTABLE_DESCRIPTION_INTENTS = exports.DESCRIPTION_INTENTS = exports.getFormatSpec = exports.suggestNormalizedSentence = exports.extractSlotsForIntent = exports.DescriptionIntentDetector = void 0;
+var intent_detector_1 = require("./intent-detector");
+Object.defineProperty(exports, "DescriptionIntentDetector", { enumerable: true, get: function () { return intent_detector_1.DescriptionIntentDetector; } });
+var slot_extractor_1 = require("./slot-extractor");
+Object.defineProperty(exports, "extractSlotsForIntent", { enumerable: true, get: function () { return slot_extractor_1.extractSlotsForIntent; } });
+var normalizer_1 = require("./normalizer");
+Object.defineProperty(exports, "suggestNormalizedSentence", { enumerable: true, get: function () { return normalizer_1.suggestNormalizedSentence; } });
+var format_spec_1 = require("./format-spec");
+Object.defineProperty(exports, "getFormatSpec", { enumerable: true, get: function () { return format_spec_1.getFormatSpec; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "DESCRIPTION_INTENTS", { enumerable: true, get: function () { return types_1.DESCRIPTION_INTENTS; } });
+Object.defineProperty(exports, "DETECTABLE_DESCRIPTION_INTENTS", { enumerable: true, get: function () { return types_1.DETECTABLE_DESCRIPTION_INTENTS; } });
+//# sourceMappingURL=index.js.map

package/dist/tools/llm/description-intent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/llm/description-intent/index.ts"],"names":[],"mappings":";;;AAAA,qDAA8D;AAArD,4HAAA,yBAAyB,OAAA;AAClC,mDAAyD;AAAhD,uHAAA,qBAAqB,OAAA;AAC9B,2CAAyD;AAAhD,uHAAA,yBAAyB,OAAA;AAClC,6CAA8C;AAArC,4GAAA,aAAa,OAAA;AACtB,iCAGiB;AAFb,4GAAA,mBAAmB,OAAA;AACnB,uHAAA,8BAA8B,OAAA"}

package/dist/tools/llm/description-intent/intent-detector.d.ts

@@ -0,0 +1,8 @@
+import type { BaseChatModel } from "@langchain/core/language_models/chat_models";
+import { type IntentDetectionResult } from "./types";
+export declare class DescriptionIntentDetector {
+    private readonly caller;
+    constructor(model: BaseChatModel);
+    detect(argName: string, text: string): Promise<IntentDetectionResult>;
+}
+//# sourceMappingURL=intent-detector.d.ts.map

package/dist/tools/llm/description-intent/intent-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-detector.d.ts","sourceRoot":"","sources":["../../../../src/tools/llm/description-intent/intent-detector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAEjF,OAAO,EAGH,KAAK,qBAAqB,EAE7B,MAAM,SAAS,CAAC;AA6CjB,qBAAa,yBAAyB;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;gBAE9B,KAAK,EAAE,aAAa;IAInB,MAAM,CACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACb,OAAO,CAAC,qBAAqB,CAAC;CA+CpC"}

package/dist/tools/llm/description-intent/intent-detector.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DescriptionIntentDetector = void 0;
+const zod_1 = require("zod");
+const structured_caller_1 = require("../structured-caller");
+const types_1 = require("./types");
+const slot_extractor_1 = require("./slot-extractor");
+const IntentItemSchema = zod_1.z.object({
+    name: zod_1.z.enum(types_1.DETECTABLE_DESCRIPTION_INTENTS),
+    confidence: zod_1.z.number().min(0).max(1),
+    evidenceSpan: zod_1.z.string().min(1),
+});
+const DetectionSchema = zod_1.z.object({
+    intents: zod_1.z.array(IntentItemSchema).default([]),
+    uncertain: zod_1.z.boolean().optional(),
+    reason: zod_1.z.string().optional(),
+});
+const SYSTEM_PROMPT = `You classify Terraform argument descriptions by semantic intent.
+
+Return all matching intents (multi-label), not just one. Intents:
+- "value-range": valid numeric range constraints
+- "enum-values": finite allowed values list
+- "char-restriction": allowed character classes/content restrictions
+- "max-length": maximum length/character count constraints
+- "default-value": explicit default value statement
+
+Rules:
+1) Output only intents directly supported by text.
+2) If confidence is low, set uncertain=true.
+3) evidenceSpan must quote the most relevant phrase from input.
+4) If no intent matches, return intents=[].
+5) Never invent values not present in input text.`;
+const SUSPECTED_STANDARD_KEYWORDS = [
+    /\bvalid values?\b/i,
+    /\brange\b/i,
+    /\bmaximum\b/i,
+    /\bdefault\b/i,
+    /\bonly\b/i,
+    /\ballowed\b/i,
+];
+class DescriptionIntentDetector {
+    constructor(model) {
+        this.caller = new structured_caller_1.StructuredCaller(model, { maxRetries: 1 });
+    }
+    async detect(argName, text) {
+        const userPrompt = `Argument: \`${argName}\`\nDescription:\n${text}`;
+        const result = await this.caller.call(DetectionSchema, SYSTEM_PROMPT, userPrompt);
+        // console.log(result);
+        if (!result.ok) {
+            if (containsSuspiciousSignals(text)) {
+                return {
+                    status: "suspected-standard-intent",
+                    intents: [],
+                    reason: "model_call_failed_with_suspected_signals",
+                };
+            }
+            return { status: "none", intents: [], reason: "model_call_failed" };
+        }
+        const normalized = dedupeIntents(result.data.intents, text);
+        if (normalized.length === 0) {
+            if (containsSuspiciousSignals(text)) {
+                return {
+                    status: "suspected-standard-intent",
+                    intents: [],
+                    reason: "no_intent_but_suspected_signals",
+                };
+            }
+            return { status: "none", intents: [] };
+        }
+        if (result.data.uncertain) {
+            return {
+                status: "uncertain",
+                intents: normalized,
+                reason: result.data.reason ?? "model_marked_uncertain",
+            };
+        }
+        return {
+            status: "classified",
+            intents: normalized,
+            reason: result.data.reason,
+        };
+    }
+}
+exports.DescriptionIntentDetector = DescriptionIntentDetector;
+function dedupeIntents(intents, text) {
+    const map = new Map();
+    for (const intent of intents) {
+        const slots = (0, slot_extractor_1.extractSlotsForIntent)(intent.name, text);
+        const next = {
+            ...intent,
+            slots,
+        };
+        const prev = map.get(intent.name);
+        if (!prev || next.confidence > prev.confidence) {
+            map.set(intent.name, next);
+        }
+    }
+    return Array.from(map.values()).sort((a, b) => b.confidence - a.confidence);
+}
+function containsSuspiciousSignals(text) {
+    return SUSPECTED_STANDARD_KEYWORDS.some((pattern) => pattern.test(text));
+}
+//# sourceMappingURL=intent-detector.js.map

package/dist/tools/llm/description-intent/intent-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-detector.js","sourceRoot":"","sources":["../../../../src/tools/llm/description-intent/intent-detector.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,4DAAwD;AACxD,mCAKiB;AACjB,qDAAyD;AAEzD,MAAM,gBAAgB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC9B,IAAI,EAAE,OAAC,CAAC,IAAI,CACR,sCAGC,CACJ;IACD,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAClC,CAAC,CAAC;AAEH,MAAM,eAAe,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7B,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9C,SAAS,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG;;;;;;;;;;;;;;kDAc4B,CAAC;AAEnD,MAAM,2BAA2B,GAAa;IAC1C,oBAAoB;IACpB,YAAY;IACZ,cAAc;IACd,cAAc;IACd,WAAW;IACX,cAAc;CACjB,CAAC;AAEF,MAAa,yBAAyB;IAGlC,YAAY,KAAoB;QAC5B,IAAI,CAAC,MAAM,GAAG,IAAI,oCAAgB,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;IAEM,KAAK,CAAC,MAAM,CACf,OAAe,EACf,IAAY;QAEZ,MAAM,UAAU,GAAG,eAAe,OAAO,qBAAqB,IAAI,EAAE,CAAC;QACrE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACjC,eAAe,EACf,aAAa,EACb,UAAU,CACb,CAAC;QAEF,uBAAuB;QAEvB,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACb,IAAI,yBAAyB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,OAAO;oBACH,MAAM,EAAE,2BAA2B;oBACnC,OAAO,EAAE,EAAE;oBACX,MAAM,EAAE,0CAA0C;iBACrD,CAAC;YACN,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;QACxE,CAAC;QAED,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC5D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,IAAI,yBAAyB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,OAAO;oBACH,MAAM,EAAE,2BAA2B;oBACnC,OAAO,EAAE,EAAE;oBACX,MAAM,EAAE,iCAAiC;iBAC5C,CAAC;YACN,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QAC3C,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACxB,OAAO;gBACH,MAAM,EAAE,WAAW;gBACnB,OAAO,EAAE,UAAU;gBACnB,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,wBAAwB;aACzD,CAAC;QACN,CAAC;QAED,OAAO;YACH,MAAM,EAAE,YAAY;YACpB,OAAO,EAAE,UAAU;YACnB,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;SAC7B,CAAC;IACN,CAAC;CACJ;AAzDD,8DAyDC;AAED,SAAS,aAAa,CAClB,OAAuB,EACvB,IAAY;IAEZ,MAAM,GAAG,GAAG,IAAI,GAAG,EAA6C,CAAC;IACjE,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAA,sCAAqB,EAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACvD,MAAM,IAAI,GAAiB;YACvB,GAAG,MAAM;YACT,KAAK;SACR,CAAC;QACF,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAC7C,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,yBAAyB,CAAC,IAAY;IAC3C,OAAO,2BAA2B,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7E,CAAC"}

package/dist/tools/llm/description-intent/normalizer.d.ts

@@ -0,0 +1,12 @@
+import type { DetectableDescriptionIntent, SlotMap } from "./types";
+export interface NormalizationSuggestion {
+    intent: DetectableDescriptionIntent;
+    template: string;
+    suggestion: string | null;
+}
+/**
+ * Best-effort formatter that suggests canonical sentences based on slots.
+ * It does not mutate source content and is safe to use as a hint provider.
+ */
+export declare function suggestNormalizedSentence(intent: DetectableDescriptionIntent, slots: SlotMap): NormalizationSuggestion;
+//# sourceMappingURL=normalizer.d.ts.map

package/dist/tools/llm/description-intent/normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../../../../src/tools/llm/description-intent/normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEpE,MAAM,WAAW,uBAAuB;IACpC,MAAM,EAAE,2BAA2B,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACrC,MAAM,EAAE,2BAA2B,EACnC,KAAK,EAAE,OAAO,GACf,uBAAuB,CAuCzB"}

package/dist/tools/llm/description-intent/normalizer.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.suggestNormalizedSentence = suggestNormalizedSentence;
+/**
+ * Best-effort formatter that suggests canonical sentences based on slots.
+ * It does not mutate source content and is safe to use as a hint provider.
+ */
+function suggestNormalizedSentence(intent, slots) {
+    switch (intent) {
+        case "value-range":
+            return {
+                intent,
+                template: "The valid value is range from `min` to `max`.",
+                suggestion: buildRangeSuggestion(slots),
+            };
+        case "enum-values":
+            return {
+                intent,
+                template: "The valid values are as follow:",
+                suggestion: "The valid values are as follow:",
+            };
+        case "char-restriction":
+            return {
+                intent,
+                template: "Only the <char-types> are allowed",
+                suggestion: buildCharRestrictionSuggestion(slots),
+            };
+        case "max-length":
+            return {
+                intent,
+                template: "The <arg_name> contain a maximum of `N` characters.",
+                suggestion: buildMaxLengthSuggestion(slots),
+            };
+        case "default-value":
+            return {
+                intent,
+                template: "The default value is `value`.",
+                suggestion: buildDefaultValueSuggestion(slots),
+            };
+        default:
+            return {
+                intent,
+                template: "",
+                suggestion: null,
+            };
+    }
+}
+function buildRangeSuggestion(slots) {
+    const min = slots.min;
+    const max = slots.max;
+    if (!min || !max)
+        return null;
+    return `The valid value is range from \`${min}\` to \`${max}\`.`;
+}
+function buildCharRestrictionSuggestion(slots) {
+    const allowedChars = slots.allowedChars;
+    if (!allowedChars || typeof allowedChars !== "string")
+        return null;
+    return `Only the ${allowedChars} are allowed`;
+}
+function buildMaxLengthSuggestion(slots) {
+    const maxLength = slots.maxLength;
+    if (!maxLength)
+        return null;
+    return `The value contain a maximum of \`${maxLength}\` characters.`;
+}
+function buildDefaultValueSuggestion(slots) {
+    const defaultValue = slots.defaultValue;
+    if (!defaultValue)
+        return null;
+    return `The default value is \`${defaultValue}\`.`;
+}
+//# sourceMappingURL=normalizer.js.map

package/dist/tools/llm/description-intent/normalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.js","sourceRoot":"","sources":["../../../../src/tools/llm/description-intent/normalizer.ts"],"names":[],"mappings":";;AAYA,8DA0CC;AA9CD;;;GAGG;AACH,SAAgB,yBAAyB,CACrC,MAAmC,EACnC,KAAc;IAEd,QAAQ,MAAM,EAAE,CAAC;QACjB,KAAK,aAAa;YACd,OAAO;gBACH,MAAM;gBACN,QAAQ,EAAE,+CAA+C;gBACzD,UAAU,EAAE,oBAAoB,CAAC,KAAK,CAAC;aAC1C,CAAC;QACN,KAAK,aAAa;YACd,OAAO;gBACH,MAAM;gBACN,QAAQ,EAAE,iCAAiC;gBAC3C,UAAU,EAAE,iCAAiC;aAChD,CAAC;QACN,KAAK,kBAAkB;YACnB,OAAO;gBACH,MAAM;gBACN,QAAQ,EAAE,mCAAmC;gBAC7C,UAAU,EAAE,8BAA8B,CAAC,KAAK,CAAC;aACpD,CAAC;QACN,KAAK,YAAY;YACb,OAAO;gBACH,MAAM;gBACN,QAAQ,EAAE,qDAAqD;gBAC/D,UAAU,EAAE,wBAAwB,CAAC,KAAK,CAAC;aAC9C,CAAC;QACN,KAAK,eAAe;YAChB,OAAO;gBACH,MAAM;gBACN,QAAQ,EAAE,+BAA+B;gBACzC,UAAU,EAAE,2BAA2B,CAAC,KAAK,CAAC;aACjD,CAAC;QACN;YACI,OAAO;gBACH,MAAM;gBACN,QAAQ,EAAE,EAAE;gBACZ,UAAU,EAAE,IAAI;aACnB,CAAC;IACN,CAAC;AACL,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAc;IACxC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;IACtB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;IACtB,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO,mCAAmC,GAAG,WAAW,GAAG,KAAK,CAAC;AACrE,CAAC;AAED,SAAS,8BAA8B,CAAC,KAAc;IAClD,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;IACxC,IAAI,CAAC,YAAY,IAAI,OAAO,YAAY,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACnE,OAAO,YAAY,YAAY,cAAc,CAAC;AAClD,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAc;IAC5C,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IAClC,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,OAAO,oCAAoC,SAAS,gBAAgB,CAAC;AACzE,CAAC;AAED,SAAS,2BAA2B,CAAC,KAAc;IAC/C,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;IACxC,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO,0BAA0B,YAAY,KAAK,CAAC;AACvD,CAAC"}

package/dist/tools/llm/description-intent/slot-extractor.d.ts

@@ -0,0 +1,3 @@
+import type { DetectableDescriptionIntent, SlotMap } from "./types";
+export declare function extractSlotsForIntent(intent: DetectableDescriptionIntent, text: string): SlotMap;
+//# sourceMappingURL=slot-extractor.d.ts.map

package/dist/tools/llm/description-intent/slot-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-extractor.d.ts","sourceRoot":"","sources":["../../../../src/tools/llm/description-intent/slot-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAMpE,wBAAgB,qBAAqB,CACjC,MAAM,EAAE,2BAA2B,EACnC,IAAI,EAAE,MAAM,GACb,OAAO,CAeT"}

package/dist/tools/llm/description-intent/slot-extractor.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractSlotsForIntent = extractSlotsForIntent;
+const BACKTICK_PAIR_REGEX = /`([^`]+)`\s+to\s+`([^`]+)`/i;
+const MAX_LENGTH_REGEX = /maximum of `([^`]+)` characters/i;
+const DEFAULT_VALUE_REGEX = /default value is `([^`]+)`/i;
+function extractSlotsForIntent(intent, text) {
+    switch (intent) {
+        case "value-range":
+            return extractValueRangeSlots(text);
+        case "enum-values":
+            return extractEnumSlots(text);
+        case "char-restriction":
+            return extractCharRestrictionSlots(text);
+        case "max-length":
+            return extractMaxLengthSlots(text);
+        case "default-value":
+            return extractDefaultValueSlots(text);
+        default:
+            return {};
+    }
+}
+function extractValueRangeSlots(text) {
+    const match = text.match(BACKTICK_PAIR_REGEX);
+    if (!match)
+        return {};
+    return {
+        min: match[1],
+        max: match[2],
+    };
+}
+function extractEnumSlots(text) {
+    const lines = text.split("\n").map((line) => line.trim());
+    const values = [];
+    for (const line of lines) {
+        const item = line.match(/^\+\s+\*\*([^*]+)\*\*:/);
+        if (item)
+            values.push(item[1].trim());
+    }
+    return values.length > 0 ? { valueSet: values } : {};
+}
+function extractCharRestrictionSlots(text) {
+    const match = text.match(/only the (.+?) are allowed/i);
+    if (!match)
+        return {};
+    return {
+        allowedChars: match[1].trim(),
+    };
+}
+function extractMaxLengthSlots(text) {
+    const match = text.match(MAX_LENGTH_REGEX);
+    if (!match)
+        return {};
+    return {
+        maxLength: match[1],
+    };
+}
+function extractDefaultValueSlots(text) {
+    const match = text.match(DEFAULT_VALUE_REGEX);
+    if (!match)
+        return {};
+    return {
+        defaultValue: match[1],
+    };
+}
+//# sourceMappingURL=slot-extractor.js.map

package/dist/tools/llm/description-intent/slot-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-extractor.js","sourceRoot":"","sources":["../../../../src/tools/llm/description-intent/slot-extractor.ts"],"names":[],"mappings":";;AAMA,sDAkBC;AAtBD,MAAM,mBAAmB,GAAG,6BAA6B,CAAC;AAC1D,MAAM,gBAAgB,GAAG,kCAAkC,CAAC;AAC5D,MAAM,mBAAmB,GAAG,6BAA6B,CAAC;AAE1D,SAAgB,qBAAqB,CACjC,MAAmC,EACnC,IAAY;IAEZ,QAAQ,MAAM,EAAE,CAAC;QACjB,KAAK,aAAa;YACd,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC;QACxC,KAAK,aAAa;YACd,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAClC,KAAK,kBAAkB;YACnB,OAAO,2BAA2B,CAAC,IAAI,CAAC,CAAC;QAC7C,KAAK,YAAY;YACb,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC;QACvC,KAAK,eAAe;YAChB,OAAO,wBAAwB,CAAC,IAAI,CAAC,CAAC;QAC1C;YACI,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAY;IACxC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAC9C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO;QACH,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;QACb,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;KAChB,CAAC;AACN,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAClD,IAAI,IAAI;YAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACzD,CAAC;AAED,SAAS,2BAA2B,CAAC,IAAY;IAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACxD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO;QACH,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;KAChC,CAAC;AACN,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAY;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO;QACH,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;KACtB,CAAC;AACN,CAAC;AAED,SAAS,wBAAwB,CAAC,IAAY;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAC9C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO;QACH,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC;KACzB,CAAC;AACN,CAAC"}

package/dist/tools/llm/description-intent/types.d.ts

@@ -0,0 +1,28 @@
+export type DescriptionIntent = "value-range" | "enum-values" | "char-restriction" | "max-length" | "default-value" | "none";
+export type DetectableDescriptionIntent = Exclude<DescriptionIntent, "none">;
+export declare const DESCRIPTION_INTENTS: DescriptionIntent[];
+export declare const DETECTABLE_DESCRIPTION_INTENTS: DetectableDescriptionIntent[];
+export type SlotValue = string | number | boolean | string[];
+export type SlotMap = Record<string, SlotValue>;
+export interface IntentResult {
+    name: DetectableDescriptionIntent;
+    confidence: number;
+    evidenceSpan: string;
+    slots?: SlotMap;
+}
+export type DetectionStatus = "classified" | "none" | "uncertain" | "suspected-standard-intent";
+export interface IntentDetectionResult {
+    status: DetectionStatus;
+    intents: IntentResult[];
+    reason?: string;
+}
+export interface FormatValidationResult {
+    ok: boolean;
+    expected: string;
+    detail?: string;
+}
+export interface DescriptionFormatSpec {
+    intent: DetectableDescriptionIntent;
+    validate: (lines: string[]) => FormatValidationResult;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/llm/description-intent/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/tools/llm/description-intent/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GACvB,aAAa,GACb,aAAa,GACb,kBAAkB,GAClB,YAAY,GACZ,eAAe,GACf,MAAM,CAAC;AAEb,MAAM,MAAM,2BAA2B,GAAG,OAAO,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;AAE7E,eAAO,MAAM,mBAAmB,EAAE,iBAAiB,EAOlD,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,2BAA2B,EAMvE,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC;AAC7D,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAEhD,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,2BAA2B,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,eAAe,GACrB,YAAY,GACZ,MAAM,GACN,WAAW,GACX,2BAA2B,CAAC;AAElC,MAAM,WAAW,qBAAqB;IAClC,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IAClC,MAAM,EAAE,2BAA2B,CAAC;IACpC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,sBAAsB,CAAC;CACzD"}

package/dist/tools/llm/description-intent/types.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DETECTABLE_DESCRIPTION_INTENTS = exports.DESCRIPTION_INTENTS = void 0;
+exports.DESCRIPTION_INTENTS = [
+    "value-range",
+    "enum-values",
+    "char-restriction",
+    "max-length",
+    "default-value",
+    "none",
+];
+exports.DETECTABLE_DESCRIPTION_INTENTS = [
+    "value-range",
+    "enum-values",
+    "char-restriction",
+    "max-length",
+    "default-value",
+];
+//# sourceMappingURL=types.js.map

package/dist/tools/llm/description-intent/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/tools/llm/description-intent/types.ts"],"names":[],"mappings":";;;AAUa,QAAA,mBAAmB,GAAwB;IACpD,aAAa;IACb,aAAa;IACb,kBAAkB;IAClB,YAAY;IACZ,eAAe;IACf,MAAM;CACT,CAAC;AAEW,QAAA,8BAA8B,GAAkC;IACzE,aAAa;IACb,aAAa;IACb,kBAAkB;IAClB,YAAY;IACZ,eAAe;CAClB,CAAC"}

package/dist/tools/llm/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * LLM Tool Module
+ *
+ * Provides structured LLM calling with automatic schema validation
+ * and retry logic.  Analogous to RegexGrep for text search —
+ * StructuredCaller takes a prompt + Zod schema and returns a
+ * type-safe, validated object.
+ *
+ * @module tools/llm
+ */
+export { StructuredCaller, extractJson } from "./structured-caller";
+export { createModel } from "./model";
+export type { StructuredCallerOptions, StructuredCallResult, StructuredCallSuccess, StructuredCallFailure, } from "./structured-caller";
+export { DescriptionIntentDetector, extractSlotsForIntent, suggestNormalizedSentence, getFormatSpec, DESCRIPTION_INTENTS, DETECTABLE_DESCRIPTION_INTENTS, } from "./description-intent";
+export type { DescriptionIntent, DetectableDescriptionIntent, SlotMap, SlotValue, IntentResult, IntentDetectionResult, DetectionStatus, FormatValidationResult, DescriptionFormatSpec, } from "./description-intent";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/llm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/llm/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,YAAY,EACR,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACH,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,EACzB,aAAa,EACb,mBAAmB,EACnB,8BAA8B,GACjC,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACR,iBAAiB,EACjB,2BAA2B,EAC3B,OAAO,EACP,SAAS,EACT,YAAY,EACZ,qBAAqB,EACrB,eAAe,EACf,sBAAsB,EACtB,qBAAqB,GACxB,MAAM,sBAAsB,CAAC"}

package/dist/tools/llm/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * LLM Tool Module
+ *
+ * Provides structured LLM calling with automatic schema validation
+ * and retry logic.  Analogous to RegexGrep for text search —
+ * StructuredCaller takes a prompt + Zod schema and returns a
+ * type-safe, validated object.
+ *
+ * @module tools/llm
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DETECTABLE_DESCRIPTION_INTENTS = exports.DESCRIPTION_INTENTS = exports.getFormatSpec = exports.suggestNormalizedSentence = exports.extractSlotsForIntent = exports.DescriptionIntentDetector = exports.createModel = exports.extractJson = exports.StructuredCaller = void 0;
+var structured_caller_1 = require("./structured-caller");
+Object.defineProperty(exports, "StructuredCaller", { enumerable: true, get: function () { return structured_caller_1.StructuredCaller; } });
+Object.defineProperty(exports, "extractJson", { enumerable: true, get: function () { return structured_caller_1.extractJson; } });
+var model_1 = require("./model");
+Object.defineProperty(exports, "createModel", { enumerable: true, get: function () { return model_1.createModel; } });
+var description_intent_1 = require("./description-intent");
+Object.defineProperty(exports, "DescriptionIntentDetector", { enumerable: true, get: function () { return description_intent_1.DescriptionIntentDetector; } });
+Object.defineProperty(exports, "extractSlotsForIntent", { enumerable: true, get: function () { return description_intent_1.extractSlotsForIntent; } });
+Object.defineProperty(exports, "suggestNormalizedSentence", { enumerable: true, get: function () { return description_intent_1.suggestNormalizedSentence; } });
+Object.defineProperty(exports, "getFormatSpec", { enumerable: true, get: function () { return description_intent_1.getFormatSpec; } });
+Object.defineProperty(exports, "DESCRIPTION_INTENTS", { enumerable: true, get: function () { return description_intent_1.DESCRIPTION_INTENTS; } });
+Object.defineProperty(exports, "DETECTABLE_DESCRIPTION_INTENTS", { enumerable: true, get: function () { return description_intent_1.DETECTABLE_DESCRIPTION_INTENTS; } });
+//# sourceMappingURL=index.js.map

package/dist/tools/llm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/llm/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,yDAAoE;AAA3D,qHAAA,gBAAgB,OAAA;AAAE,gHAAA,WAAW,OAAA;AACtC,iCAAsC;AAA7B,oGAAA,WAAW,OAAA;AAQpB,2DAO8B;AAN1B,+HAAA,yBAAyB,OAAA;AACzB,2HAAA,qBAAqB,OAAA;AACrB,+HAAA,yBAAyB,OAAA;AACzB,mHAAA,aAAa,OAAA;AACb,yHAAA,mBAAmB,OAAA;AACnB,oIAAA,8BAA8B,OAAA"}

package/dist/tools/llm/model.d.ts

@@ -0,0 +1,3 @@
+import { ChatOpenAI } from "@langchain/openai";
+export declare function createModel(modelName?: string, temperature?: number, streaming?: boolean, baseURL?: string, apiKey?: string): ChatOpenAI;
+//# sourceMappingURL=model.d.ts.map

package/dist/tools/llm/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/tools/llm/model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAK/C,wBAAgB,WAAW,CACvB,SAAS,GAAE,MAA8C,EACzD,WAAW,GAAE,MAAY,EACzB,SAAS,GAAE,OAAe,EAC1B,OAAO,GAAE,MAA6C,EACtD,MAAM,GAAE,MAA4C,GACrD,UAAU,CAUZ"}