@duckcodeailabs/dql-agent 1.6.21 → 1.6.22

package/dist/research-loop.js

@@ -0,0 +1,210 @@
+/**
+ * Research loop (P4) — a grounded, ReAct-style planner for "research / follow-up"
+ * questions, so the agent behaves like a real assistant: it DECIDES whether to
+ * answer, to research across multiple steps, or to ask a smart follow-up — instead
+ * of always generating one query.
+ *
+ * The "tools" the loop reasons over are DQL's own assets: governed metrics, certified
+ * blocks, and their dimensions/lineage. Every step is bound to a REAL asset (no
+ * hallucinated tool calls), and every follow-up offers concrete options drawn from
+ * the catalog. The first decision reuses the P0 intent controller; this module turns
+ * that decision into a grounded plan.
+ */
+import { decideAgentAction } from './intent-controller.js';
+import { matchSemanticMetric } from './metadata/metric-match.js';
+const TIME_DIM_RE = /(_at$|_date$|_time$|_ts$|^date$|^month$|^week$|^day$|ordered_at|created)/i;
+function humanize(name) {
+    return name.replace(/[_.]+/g, ' ').replace(/\s+/g, ' ').trim();
+}
+function requestedDimensions(question) {
+    const dims = [];
+    const re = /\bby\s+([a-z_][a-z0-9_]*)/gi;
+    let m;
+    while ((m = re.exec(question.toLowerCase()))) {
+        if (m[1] && m[1] !== 'the' && !dims.includes(m[1]))
+            dims.push(m[1]);
+    }
+    return dims;
+}
+function blocksForMetric(blocks, metric) {
+    if (!metric)
+        return [];
+    const leaf = metric.toLowerCase().split('.').pop();
+    return blocks.filter((b) => {
+        const ref = (b.metricRef ?? '').toLowerCase();
+        return ref === metric.toLowerCase() || ref.split('.').pop() === leaf;
+    });
+}
+function timeDimensionOf(blocks) {
+    for (const b of blocks) {
+        for (const f of [...(b.allowedFilters ?? []), ...(b.dimensions ?? [])]) {
+            if (TIME_DIM_RE.test(f))
+                return f;
+        }
+    }
+    return undefined;
+}
+function categoricalDimensionsOf(blocks) {
+    const out = [];
+    for (const b of blocks) {
+        for (const f of b.allowedFilters ?? []) {
+            if (!TIME_DIM_RE.test(f) && !out.includes(f))
+                out.push(f);
+        }
+    }
+    return out;
+}
+/**
+ * Plan how to handle a research / follow-up question. Returns the decision plus a
+ * grounded plan: a direct answer, a multi-step research trace, or a follow-up with
+ * concrete options. Deterministic + offline; the metric match reuses the spec-17 matcher.
+ */
+export async function planResearch(input) {
+    // Prefer a metric that already has certified blocks (so the research plan can use
+    // its time/breakdown dimensions), falling back to the best overall match.
+    const backedNames = new Set(input.blocks
+        .map((b) => b.metricRef?.toLowerCase())
+        .filter((ref) => Boolean(ref))
+        .flatMap((ref) => [ref, ref.split('.').pop() ?? ref]));
+    const backedMetrics = input.metrics.filter((m) => backedNames.has(m.name.toLowerCase()) || backedNames.has(m.name.toLowerCase().split('.').pop() ?? ''));
+    const match = (backedMetrics.length > 0 ? await matchSemanticMetric(input.question, backedMetrics).catch(() => null) : null) ??
+        (await matchSemanticMetric(input.question, input.metrics).catch(() => null));
+    const metricName = match?.metric.name;
+    const metricBlocks = blocksForMetric(input.blocks, metricName);
+    const decision = decideAgentAction({
+        question: input.question,
+        intent: input.intent ?? 'definition_lookup',
+        signals: {
+            metricScore: match?.score,
+            certifiedScore: metricBlocks.length > 0 ? 0.85 : undefined,
+            hasRetrieval: input.metrics.length > 0 || input.blocks.length > 0,
+        },
+        isFollowUp: input.isFollowUp,
+        history: input.history,
+    });
+    const sources = new Set();
+    if (metricName)
+        sources.add(metricName);
+    for (const b of metricBlocks)
+        sources.add(b.name);
+    // ── compose_app: hand off to the app planner (P1). ───────────────────────────
+    if (decision.action === 'compose_app') {
+        return {
+            decision: 'compose_app',
+            confidence: decision.confidence,
+            rationale: decision.reason,
+            steps: [{
+                    thought: 'This asks to assemble a decision surface, not answer one question.',
+                    action: { kind: 'compose_app', target: metricName ?? humanize(input.question) },
+                    expectation: 'A planned app: KPI + trend + breakdowns over the certified blocks.',
+                }],
+            sources: Array.from(sources),
+            done: false,
+        };
+    }
+    // ── clarify: ask before researching, with concrete options. ──────────────────
+    if (decision.action === 'clarify') {
+        const followUp = buildFollowUp(input, match, metricBlocks, decision.clarifyingQuestion);
+        return {
+            decision: 'clarify',
+            confidence: decision.confidence,
+            rationale: decision.reason,
+            steps: [],
+            followUp,
+            sources: Array.from(sources),
+            done: false,
+        };
+    }
+    // ── investigate: a grounded, multi-step ReAct research trace. ────────────────
+    if (decision.action === 'investigate') {
+        const steps = [];
+        const label = metricName ? humanize(metricName) : humanize(input.question);
+        if (metricName) {
+            steps.push({
+                thought: `Establish the baseline for ${label}.`,
+                action: { kind: 'lookup_metric', target: metricName },
+                expectation: `The current ${label} value to reason from.`,
+            });
+        }
+        const timeDim = timeDimensionOf(metricBlocks);
+        if (timeDim) {
+            steps.push({
+                thought: `See how ${label} moved over time to locate the change.`,
+                action: { kind: 'compare_time', target: timeDim },
+                expectation: `When ${label} shifted, and by how much.`,
+            });
+        }
+        const dims = (requestedDimensions(input.question).filter((d) => !TIME_DIM_RE.test(d))
+            .filter((d) => categoricalDimensionsOf(metricBlocks).includes(d)));
+        const breakdownDim = dims[0] ?? categoricalDimensionsOf(metricBlocks)[0];
+        if (breakdownDim) {
+            steps.push({
+                thought: `Attribute the change — break ${label} down by ${humanize(breakdownDim)}.`,
+                action: { kind: 'breakdown', target: breakdownDim },
+                expectation: `Which ${humanize(breakdownDim)} segments drove the move.`,
+            });
+        }
+        else if (metricName) {
+            steps.push({
+                thought: `No breakdown dimension is certified yet — check lineage for drivers.`,
+                action: { kind: 'check_lineage', target: metricName },
+                expectation: `Upstream models/metrics that feed ${label}.`,
+            });
+        }
+        return {
+            decision: 'investigate',
+            confidence: decision.confidence,
+            rationale: decision.reason,
+            steps,
+            sources: Array.from(sources),
+            done: false,
+        };
+    }
+    // ── answer: a single grounded step. ──────────────────────────────────────────
+    const answerStep = metricBlocks.length > 0
+        ? {
+            thought: `A certified block answers this directly.`,
+            action: { kind: 'lookup_block', target: metricBlocks[0].name },
+            expectation: `The certified ${humanize(metricBlocks[0].name)} result.`,
+        }
+        : {
+            thought: metricName ? `The governed metric answers this directly.` : `Answer from the catalog.`,
+            action: { kind: 'lookup_metric', target: metricName ?? humanize(input.question) },
+            expectation: metricName ? `The governed ${humanize(metricName)} value.` : `A grounded answer.`,
+        };
+    return {
+        decision: 'answer',
+        confidence: decision.confidence,
+        rationale: decision.reason,
+        steps: [answerStep],
+        sources: Array.from(sources),
+        done: true,
+    };
+}
+/**
+ * Build a follow-up that offers REAL options: nearby metrics to disambiguate, or the
+ * certified breakdown dimensions to pick from — never an open-ended "tell me more".
+ */
+function buildFollowUp(input, match, metricBlocks, controllerQuestion) {
+    // No confident metric → ask which subject, offering the closest catalog metrics.
+    if (!match) {
+        const options = input.metrics.slice(0, 4).map((m) => humanize(m.name));
+        return {
+            question: controllerQuestion ?? 'Which metric did you mean?',
+            options,
+        };
+    }
+    // A metric matched but the breakdown is ambiguous → offer the certified dimensions.
+    const dims = categoricalDimensionsOf(metricBlocks);
+    if (dims.length > 0 && requestedDimensions(input.question).length === 0) {
+        return {
+            question: `How should I break ${humanize(match.metric.name)} down?`,
+            options: dims.map(humanize).concat('overall (no breakdown)'),
+        };
+    }
+    return {
+        question: controllerQuestion ?? `Do you want ${humanize(match.metric.name)} overall, or filtered to a period?`,
+        options: ['overall', 'this year', 'a custom period'],
+    };
+}
+//# sourceMappingURL=research-loop.js.map

package/dist/research-loop.js.map

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

package/dist/skills/defaults.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Default starter Skills (spec 16) — `seedDefaultSkills` writes three EDITABLE
+ * starters into `.dql/skills/`, idempotently (it NEVER clobbers a file the user
+ * has edited). The starters are:
+ *
+ *   (a) Metrics glossary  — pre-filled from the semantic layer (MetricFlow
+ *       metrics → vocabulary + preferred_metrics).
+ *   (b) SQL conventions   — prefer {{ ref() }} / qualified relations, exclude
+ *       test/internal accounts, one-row-per-grain, prefer certified blocks.
+ *   (c) Domain rules      — a commented template for the team to fill in.
+ *
+ * Idempotency is by file existence: a starter is only written when its
+ * `.skill.md` does not already exist. Re-running `seedDefaultSkills` after a
+ * user edits a starter is a no-op for that file.
+ */
+import { type SemanticLayer } from '@duckcodeailabs/dql-core';
+import { type Skill } from './loader.js';
+export interface SeedDefaultSkillsOptions {
+    /**
+     * Explicit semantic layer to source the metrics glossary from. When omitted,
+     * the project's configured semantic layer is loaded (best-effort).
+     */
+    semanticLayer?: SemanticLayer;
+}
+export interface SeedDefaultSkillsResult {
+    /** Skills written this run (did not already exist). */
+    created: Skill[];
+    /** Starter ids skipped because their file already existed. */
+    skipped: string[];
+}
+/**
+ * Seed the three editable starter skills into `.dql/skills/`. Idempotent: a
+ * starter is written only when its file does not already exist, so user edits
+ * are never clobbered.
+ */
+export declare function seedDefaultSkills(projectRoot: string, options?: SeedDefaultSkillsOptions): SeedDefaultSkillsResult;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/skills/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/skills/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAyB,KAAK,KAAK,EAAwB,MAAM,aAAa,CAAC;AAEtF,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,OAAO,EAAE,KAAK,EAAE,CAAC;IACjB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AA0HD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,wBAA6B,GACrC,uBAAuB,CAkBzB"}

package/dist/skills/defaults.js

@@ -0,0 +1,152 @@
+/**
+ * Default starter Skills (spec 16) — `seedDefaultSkills` writes three EDITABLE
+ * starters into `.dql/skills/`, idempotently (it NEVER clobbers a file the user
+ * has edited). The starters are:
+ *
+ *   (a) Metrics glossary  — pre-filled from the semantic layer (MetricFlow
+ *       metrics → vocabulary + preferred_metrics).
+ *   (b) SQL conventions   — prefer {{ ref() }} / qualified relations, exclude
+ *       test/internal accounts, one-row-per-grain, prefer certified blocks.
+ *   (c) Domain rules      — a commented template for the team to fill in.
+ *
+ * Idempotency is by file existence: a starter is only written when its
+ * `.skill.md` does not already exist. Re-running `seedDefaultSkills` after a
+ * user edits a starter is a no-op for that file.
+ */
+import { existsSync } from 'node:fs';
+import { loadProjectConfig, resolveSemanticLayerWithDiagnostics, } from '@duckcodeailabs/dql-core';
+import { skillPath, writeSkill } from './loader.js';
+/** Best-effort load of the project's semantic-layer metrics for the glossary. */
+function loadMetrics(projectRoot, explicit) {
+    try {
+        const layer = explicit ?? resolveProjectSemanticLayer(projectRoot);
+        if (!layer)
+            return [];
+        const metrics = layer.listMetrics();
+        return metrics.map((m) => ({ name: m.name, label: m.label, description: m.description }));
+    }
+    catch {
+        return [];
+    }
+}
+function resolveProjectSemanticLayer(projectRoot) {
+    const config = loadProjectConfig(projectRoot);
+    const semanticConfig = config.semanticLayer?.provider
+        ? config.semanticLayer
+        : config.semanticLayer?.path
+            ? { provider: 'dql', path: config.semanticLayer.path }
+            : undefined;
+    const configured = resolveSemanticLayerWithDiagnostics(semanticConfig, projectRoot).layer;
+    if (configured)
+        return configured;
+    if (config.dbt?.projectDir) {
+        return resolveSemanticLayerWithDiagnostics({ provider: 'dbt', projectPath: config.dbt.projectDir }, projectRoot).layer ?? undefined;
+    }
+    return undefined;
+}
+/** (a) Metrics glossary, pre-filled from the semantic layer. */
+function metricsGlossarySkill(metrics) {
+    const vocabulary = {};
+    for (const metric of metrics) {
+        const term = (metric.label && metric.label.trim()) || metric.name;
+        vocabulary[term] = `metric:${metric.name}`;
+    }
+    const bodyLines = [
+        '# Metrics glossary',
+        '',
+        'Business terms map to certified semantic-layer metrics. Prefer these metrics',
+        'over ad-hoc SQL aggregations when a question matches one of them.',
+        '',
+    ];
+    if (metrics.length > 0) {
+        bodyLines.push('Known metrics:');
+        for (const metric of metrics) {
+            bodyLines.push(`- **${(metric.label && metric.label.trim()) || metric.name}** (\`${metric.name}\`)${metric.description ? ` — ${metric.description}` : ''}`);
+        }
+    }
+    else {
+        bodyLines.push('_No semantic-layer metrics were found when this glossary was seeded._');
+        bodyLines.push('_Add metrics to your semantic layer and re-run `dql init` to refresh, or edit this file._');
+    }
+    return {
+        id: 'metrics-glossary',
+        scope: 'project',
+        description: 'Business terms mapped to certified semantic-layer metrics.',
+        preferredMetrics: metrics.map((m) => m.name),
+        vocabulary,
+        body: bodyLines.join('\n'),
+        isStarter: true,
+    };
+}
+/** (b) SQL conventions — house rules for grounded, certified-first SQL. */
+function sqlConventionsSkill() {
+    return {
+        id: 'sql-conventions',
+        scope: 'project',
+        description: 'House SQL conventions for grounded, certified-first analytics.',
+        body: [
+            '# SQL conventions',
+            '',
+            'Apply these conventions to all generated SQL:',
+            '',
+            "- **Reference relations correctly.** In governed BLOCK SQL, reference tables via `{{ ref('<model>') }}`.",
+            '  In ad-hoc CELL SQL, use the fully-qualified relation `database.schema.table`. Never a bare model name.',
+            '- **Prefer certified blocks.** When a certified block answers the question at the right grain, reuse it',
+            '  instead of regenerating SQL.',
+            '- **Exclude test / internal accounts.** Filter out seed, test, demo, and internal records',
+            '  (e.g. `WHERE NOT is_test_account`) unless the question explicitly asks for them.',
+            '- **One row per grain.** Make the grain explicit and ensure the query returns exactly one row per grain',
+            '  (no accidental fan-out from un-deduplicated joins).',
+            '- **Read-only only.** Generate a single `SELECT` / `WITH` query; never DML or DDL.',
+        ].join('\n'),
+        isStarter: true,
+    };
+}
+/** (c) Domain rules — a commented template for the team to fill in. */
+function domainRulesSkill() {
+    return {
+        id: 'domain-rules',
+        scope: 'project',
+        description: 'Team-specific domain rules and business logic (template — fill in).',
+        body: [
+            '# Domain rules',
+            '',
+            'Fill in the business rules specific to your domain. Examples to replace:',
+            '',
+            '<!--',
+            '- "Active customer" = a customer with an order in the last 90 days.',
+            '- Revenue excludes refunds and chargebacks.',
+            '- The fiscal year starts in February.',
+            '- Region "EMEA" includes the UK.',
+            '-->',
+            '',
+            '_This is a starter template. Edit it with your team\'s definitions; re-running',
+            '`dql init` will not overwrite your changes._',
+        ].join('\n'),
+        isStarter: true,
+    };
+}
+/**
+ * Seed the three editable starter skills into `.dql/skills/`. Idempotent: a
+ * starter is written only when its file does not already exist, so user edits
+ * are never clobbered.
+ */
+export function seedDefaultSkills(projectRoot, options = {}) {
+    const metrics = loadMetrics(projectRoot, options.semanticLayer);
+    const starters = [
+        metricsGlossarySkill(metrics),
+        sqlConventionsSkill(),
+        domainRulesSkill(),
+    ];
+    const created = [];
+    const skipped = [];
+    for (const starter of starters) {
+        if (existsSync(skillPath(projectRoot, starter.id))) {
+            skipped.push(starter.id);
+            continue;
+        }
+        created.push(writeSkill(projectRoot, starter));
+    }
+    return { created, skipped };
+}
+//# sourceMappingURL=defaults.js.map

package/dist/skills/defaults.js.map

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

package/dist/skills/loader.d.ts

@@ -17,8 +17,16 @@
  */
 export interface Skill {
     id: string;
+    /**
+     * Skill scope. PROJECT skills (`user` empty) are shared with everyone;
+     * PERSONAL skills (`user` set) are bound to a single user. Derived from
+     * `user` on parse; persisted faithfully on write.
+     */
+    scope: 'project' | 'personal';
     /** Optional user this skill is bound to. Empty = project-level skill. */
     user?: string;
+    /** Optional domain this skill belongs to (spec 17, part B). */
+    domain?: string;
     description?: string;
     preferredMetrics: string[];
     preferredBlocks: string[];
@@ -26,6 +34,8 @@ export interface Skill {
     /** Markdown body (everything after the closing `---`). */
     body: string;
     sourcePath: string;
+    /** True for the editable starter skills seeded by `seedDefaultSkills`. */
+    isStarter?: boolean;
 }
 export interface SkillLoadResult {
     skills: Skill[];
@@ -41,6 +51,36 @@ export interface SkillLoadResult {
 export declare function loadSkills(projectRoot: string): SkillLoadResult;
 /** Public for tests. */
 export declare function parseSkill(raw: string, path: string): Skill | null;
+/** Skills directory for a project. */
+export declare function skillsDir(projectRoot: string): string;
+/** Resolve the `.skill.md` path a skill should be written to. */
+export declare function skillPath(projectRoot: string, id: string): string;
+/**
+ * Render a Skill back to the EXACT `.skill.md` format `parseSkill` consumes, so
+ * `parseSkill(renderSkill(s))` round-trips. Only emits keys that have content.
+ */
+export declare function renderSkill(skill: Skill): string;
+export interface WriteSkillInput {
+    id: string;
+    scope: 'project' | 'personal';
+    user?: string;
+    domain?: string;
+    description?: string;
+    preferredMetrics?: string[];
+    preferredBlocks?: string[];
+    vocabulary?: Record<string, string>;
+    body?: string;
+    isStarter?: boolean;
+}
+/**
+ * Write a skill to `.dql/skills/<id>.skill.md` (overwriting if present). Returns
+ * the persisted Skill as re-read from disk so callers see the canonical form.
+ */
+export declare function writeSkill(projectRoot: string, input: WriteSkillInput): Skill;
+/** Alias for `writeSkill` — create-or-update by id. */
+export declare function upsertSkill(projectRoot: string, input: WriteSkillInput): Skill;
+/** Delete `.dql/skills/<id>.skill.md`. Returns true when a file was removed. */
+export declare function deleteSkill(projectRoot: string, id: string): boolean;
 /**
  * Compose Skills into a single system-prompt fragment for the agent.
  * Filtered by user when a persona is active.
@@ -48,4 +88,24 @@ export declare function parseSkill(raw: string, path: string): Skill | null;
 export declare function buildSkillsPrompt(skills: Skill[], userId: string | null): string;
 export declare function activeSkills(skills: Skill[], userId: string | null): Skill[];
 export declare function buildSkillBlockHints(skills: Skill[], userId: string | null): string[];
+export interface SelectRelevantSkillsOptions {
+    /** Active user — gates personal skills (only this user's are eligible). */
+    userId?: string | null;
+    /** Max skills to return after pinned ones. Default 6. */
+    budget?: number;
+    /**
+     * Skill ids that are ALWAYS kept regardless of match (e.g. SQL conventions).
+     * Defaults to the seeded `sql-conventions` starter. Pinned skills are only
+     * kept when they are in-scope for the active user.
+     */
+    pinnedIds?: string[];
+}
+/**
+ * Rank in-scope skills by topic/vocabulary match to `question` and return the
+ * SELECTED subset the answer-loop / build engine should inject — not all skills.
+ * Pinned project skills (SQL conventions by default) are always kept. The rest
+ * are ordered by lexical overlap (vocabulary + description + body) and capped to
+ * the budget. Deterministic and offline.
+ */
+export declare function selectRelevantSkills(skills: Skill[], question: string, options?: SelectRelevantSkillsOptions): Skill[];
 //# sourceMappingURL=loader.d.ts.map

package/dist/skills/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,CAiB/D;AAiBD,wBAAwB;AACxB,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAkBlE;AAiFD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAoBhF;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,EAAE,CAE5E;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,EAAE,CAcrF"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"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"}