wotann 0.5.0

package/dist/learning/pattern-crystallizer.js

@@ -0,0 +1,248 @@
+/**
+ * Pattern Crystallizer — auto-generates skills from repeated action patterns.
+ *
+ * FROM OPENCLAW FOUNDRY RESEARCH:
+ * "When a pattern hits 5+ uses with 70%+ success rate, Foundry crystallizes
+ *  it into a dedicated tool, reducing 8 tool calls to 1."
+ *
+ * This is automagical self-improvement at the prompt/skill level:
+ * 1. Track action sequences across sessions
+ * 2. Detect repeating patterns (same tool sequence for similar tasks)
+ * 3. When threshold reached (5+ uses, 70%+ success) → auto-generate SKILL.md
+ * 4. Prune stale patterns (< 20% success or 30+ days unused)
+ *
+ * No model training required. No GPU. Immediate benefit.
+ */
+import { readFileSync, existsSync, mkdirSync } from "node:fs";
+import { writeFileAtomic } from "../utils/atomic-io.js";
+import { join } from "node:path";
+import { resolveWotannHome } from "../utils/wotann-home.js";
+// ── Pattern Crystallizer ─────────────────────────────────
+export class PatternCrystallizer {
+    patterns = new Map();
+    dataPath;
+    skillsDir;
+    // Thresholds (from OpenClaw Foundry research)
+    MIN_USES = 5;
+    MIN_SUCCESS_RATE = 0.7;
+    PRUNE_SUCCESS_RATE = 0.2;
+    PRUNE_AGE_MS = 30 * 24 * 60 * 60 * 1000; // 30 days
+    constructor() {
+        const wotannDir = resolveWotannHome();
+        this.dataPath = join(wotannDir, "patterns.json");
+        this.skillsDir = join(wotannDir, "skills");
+        if (!existsSync(this.skillsDir)) {
+            mkdirSync(this.skillsDir, { recursive: true });
+        }
+        this.loadPatterns();
+    }
+    /**
+     * Record a tool sequence from a completed task.
+     * Called after each successful (or failed) task execution.
+     */
+    recordPattern(toolSequence, triggerKeywords, success) {
+        if (toolSequence.length < 2)
+            return null;
+        // Find existing pattern with similar tool sequence
+        const match = this.findSimilarPattern(toolSequence);
+        if (match && match.similarity >= 0.7) {
+            // Update existing pattern
+            const existing = this.patterns.get(match.patternId);
+            const updated = {
+                ...existing,
+                useCount: existing.useCount + 1,
+                successCount: existing.successCount + (success ? 1 : 0),
+                lastUsed: Date.now(),
+                triggerKeywords: [...new Set([...existing.triggerKeywords, ...triggerKeywords])],
+            };
+            this.patterns.set(match.patternId, updated);
+            // Check if ready for crystallization
+            if (this.shouldCrystallize(updated)) {
+                this.crystallize(updated);
+            }
+            this.savePatterns();
+            return match;
+        }
+        // Create new pattern
+        const id = `pattern-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;
+        const newPattern = {
+            id,
+            name: this.generatePatternName(toolSequence, triggerKeywords),
+            description: `Auto-detected pattern: ${toolSequence.join(" → ")}`,
+            toolSequence,
+            triggerKeywords,
+            useCount: 1,
+            successCount: success ? 1 : 0,
+            lastUsed: Date.now(),
+            createdAt: Date.now(),
+            crystallized: false,
+        };
+        this.patterns.set(id, newPattern);
+        this.savePatterns();
+        return null;
+    }
+    /**
+     * Find a similar pattern by Jaccard similarity of tool sequences.
+     */
+    findSimilarPattern(toolSequence) {
+        let bestMatch = null;
+        for (const [id, pattern] of this.patterns) {
+            const similarity = this.jaccardSimilarity(toolSequence, pattern.toolSequence);
+            const confidence = pattern.useCount > 0 ? pattern.successCount / pattern.useCount : 0;
+            if (similarity > (bestMatch?.similarity ?? 0)) {
+                bestMatch = { patternId: id, similarity, confidence };
+            }
+        }
+        return bestMatch;
+    }
+    /**
+     * Jaccard similarity of two tool sequences (order-aware via bigrams).
+     */
+    jaccardSimilarity(a, b) {
+        const bigramsA = new Set(a.slice(0, -1).map((t, i) => `${t}→${a[i + 1]}`));
+        const bigramsB = new Set(b.slice(0, -1).map((t, i) => `${t}→${b[i + 1]}`));
+        if (bigramsA.size === 0 && bigramsB.size === 0)
+            return 1;
+        if (bigramsA.size === 0 || bigramsB.size === 0)
+            return 0;
+        let intersection = 0;
+        for (const bg of bigramsA) {
+            if (bigramsB.has(bg))
+                intersection++;
+        }
+        const union = bigramsA.size + bigramsB.size - intersection;
+        return union > 0 ? intersection / union : 0;
+    }
+    /**
+     * Check if a pattern should be crystallized into a skill.
+     */
+    shouldCrystallize(pattern) {
+        if (pattern.crystallized)
+            return false;
+        if (pattern.useCount < this.MIN_USES)
+            return false;
+        const successRate = pattern.successCount / pattern.useCount;
+        return successRate >= this.MIN_SUCCESS_RATE;
+    }
+    /**
+     * Crystallize a pattern into a SKILL.md file.
+     */
+    crystallize(pattern) {
+        const skillName = pattern.name.toLowerCase().replace(/\s+/g, "-");
+        const skillPath = join(this.skillsDir, `${skillName}.md`);
+        const successRate = Math.round((pattern.successCount / pattern.useCount) * 100);
+        const skillContent = [
+            "---",
+            `name: ${skillName}`,
+            `description: Auto-crystallized pattern (${successRate}% success over ${pattern.useCount} uses)`,
+            `paths: []`,
+            "---",
+            "",
+            `# ${pattern.name}`,
+            "",
+            `Auto-generated by Pattern Crystallizer on ${new Date().toISOString()}.`,
+            `Based on ${pattern.useCount} observed uses with ${successRate}% success rate.`,
+            "",
+            "## Tool Sequence",
+            "",
+            ...pattern.toolSequence.map((tool, i) => `${i + 1}. **${tool}**`),
+            "",
+            "## Trigger Keywords",
+            "",
+            pattern.triggerKeywords.map((k) => `- ${k}`).join("\n"),
+            "",
+            "## Instructions",
+            "",
+            `When the user's request matches these keywords, follow this tool sequence:`,
+            "",
+            pattern.toolSequence
+                .map((tool, i) => `Step ${i + 1}: Use ${tool} to ${this.describeToolAction(tool)}`)
+                .join("\n"),
+            "",
+        ].join("\n");
+        // Wave 6.5-UU (H-22) — crystallized skill file. Atomic write.
+        writeFileAtomic(skillPath, skillContent);
+        // Update pattern as crystallized
+        this.patterns.set(pattern.id, {
+            ...pattern,
+            crystallized: true,
+            skillPath,
+        });
+        console.log(`Pattern crystallized: ${pattern.name} → ${skillPath}`);
+    }
+    /**
+     * Generate a human-readable name for a pattern.
+     */
+    generatePatternName(tools, keywords) {
+        const toolPart = tools.slice(0, 3).join("-");
+        const keywordPart = keywords[0] ?? "general";
+        return `${keywordPart}-${toolPart}`.slice(0, 40);
+    }
+    /**
+     * Describe what a tool does (for generated skill instructions).
+     */
+    describeToolAction(tool) {
+        const descriptions = {
+            Read: "read the relevant file(s)",
+            Grep: "search for the relevant code pattern",
+            Glob: "find matching files",
+            Edit: "make the necessary changes",
+            Write: "create the new file",
+            Bash: "run the verification command",
+            LSP: "check symbol references",
+            Agent: "delegate to a specialized agent",
+        };
+        return descriptions[tool] ?? "perform the action";
+    }
+    /**
+     * Prune stale patterns (low success or old unused).
+     */
+    prune() {
+        const now = Date.now();
+        let pruned = 0;
+        for (const [id, pattern] of this.patterns) {
+            if (pattern.crystallized)
+                continue; // Don't prune crystallized patterns
+            const successRate = pattern.useCount > 0 ? pattern.successCount / pattern.useCount : 0;
+            const age = now - pattern.lastUsed;
+            if ((pattern.useCount >= 3 && successRate < this.PRUNE_SUCCESS_RATE) ||
+                (age > this.PRUNE_AGE_MS && pattern.useCount < this.MIN_USES)) {
+                this.patterns.delete(id);
+                pruned++;
+            }
+        }
+        if (pruned > 0)
+            this.savePatterns();
+        return pruned;
+    }
+    /**
+     * Get all patterns (for dashboard display).
+     */
+    getPatterns() {
+        return [...this.patterns.values()];
+    }
+    /**
+     * Get crystallized skills count.
+     */
+    getCrystallizedCount() {
+        return [...this.patterns.values()].filter((p) => p.crystallized).length;
+    }
+    // ── Persistence ────────────────────────────────────────
+    loadPatterns() {
+        if (!existsSync(this.dataPath))
+            return;
+        try {
+            const data = JSON.parse(readFileSync(this.dataPath, "utf-8"));
+            this.patterns = new Map(data.map((p) => [p.id, p]));
+        }
+        catch {
+            // Start fresh if corrupted
+        }
+    }
+    savePatterns() {
+        const data = [...this.patterns.values()];
+        // Wave 6.5-UU (H-22) — pattern store. Atomic write.
+        writeFileAtomic(this.dataPath, JSON.stringify(data, null, 2));
+    }
+}
+//# sourceMappingURL=pattern-crystallizer.js.map

package/dist/learning/pattern-crystallizer.js.map

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

package/dist/learning/reflection-buffer.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Reflection buffer — persist mistakes + corrections for cross-session.
+ *
+ * When an agent makes a mistake and then corrects it (either via user
+ * feedback or self-discovery), that pair is high-value learning
+ * signal. Logging them to a reflection buffer means future sessions
+ * can surface the correction BEFORE repeating the mistake.
+ *
+ * ReflectionBuffer stores tuples of:
+ *   - context:    what the agent was trying to do
+ *   - mistake:    what went wrong
+ *   - correction: what the right answer was
+ *   - tags:       for filtering (e.g. "bash", "typescript", "memory")
+ *   - createdAt:  for recency-based retrieval
+ *
+ * Retrieval is by tag match + substring over context/mistake. Pure
+ * in-memory; callers own persistence.
+ */
+export interface ReflectionEntry {
+    readonly id: string;
+    readonly context: string;
+    readonly mistake: string;
+    readonly correction: string;
+    readonly tags: readonly string[];
+    readonly createdAt: number;
+    readonly hits: number;
+}
+export interface AddEntryInput {
+    readonly context: string;
+    readonly mistake: string;
+    readonly correction: string;
+    readonly tags?: readonly string[];
+}
+export interface RetrieveOptions {
+    /** Max entries to return. Default 5. */
+    readonly limit?: number;
+    /** Filter by tag (any-match). */
+    readonly tags?: readonly string[];
+    /** Substring query against context + mistake. */
+    readonly query?: string;
+    /** Minimum days old. Default 0. */
+    readonly minAgeDays?: number;
+    /** Maximum days old (recency filter). Default undefined. */
+    readonly maxAgeDays?: number;
+}
+export declare class ReflectionBuffer {
+    private entries;
+    private idCounter;
+    private readonly now;
+    constructor(options?: {
+        readonly now?: () => number;
+    });
+    /** Record a mistake + correction. */
+    add(input: AddEntryInput): ReflectionEntry;
+    /** Retrieve relevant reflections for a context. */
+    retrieve(options?: RetrieveOptions): readonly ReflectionEntry[];
+    /** Format reflections as a prompt-injectable block. */
+    formatForPrompt(entries: readonly ReflectionEntry[]): string;
+    size(): number;
+    list(): readonly ReflectionEntry[];
+    removeById(id: string): boolean;
+    clear(): void;
+    /** Serialize to JSON for persistence. */
+    serialize(): string;
+    /** Restore from previously serialized state. */
+    loadSerialized(raw: string): void;
+}
+//# sourceMappingURL=reflection-buffer.d.ts.map

package/dist/learning/reflection-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection-buffer.d.ts","sourceRoot":"","sources":["../../src/learning/reflection-buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,iDAAiD;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,mCAAmC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAID,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAEvB,OAAO,GAAE;QAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;KAAO;IAIzD,qCAAqC;IACrC,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,eAAe;IAc1C,mDAAmD;IACnD,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,SAAS,eAAe,EAAE;IAwCnE,uDAAuD;IACvD,eAAe,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM;IAgB5D,IAAI,IAAI,MAAM;IAId,IAAI,IAAI,SAAS,eAAe,EAAE;IAIlC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAO/B,KAAK,IAAI,IAAI;IAKb,yCAAyC;IACzC,SAAS,IAAI,MAAM;IAInB,gDAAgD;IAChD,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAYlC"}

package/dist/learning/reflection-buffer.js

@@ -0,0 +1,155 @@
+/**
+ * Reflection buffer — persist mistakes + corrections for cross-session.
+ *
+ * When an agent makes a mistake and then corrects it (either via user
+ * feedback or self-discovery), that pair is high-value learning
+ * signal. Logging them to a reflection buffer means future sessions
+ * can surface the correction BEFORE repeating the mistake.
+ *
+ * ReflectionBuffer stores tuples of:
+ *   - context:    what the agent was trying to do
+ *   - mistake:    what went wrong
+ *   - correction: what the right answer was
+ *   - tags:       for filtering (e.g. "bash", "typescript", "memory")
+ *   - createdAt:  for recency-based retrieval
+ *
+ * Retrieval is by tag match + substring over context/mistake. Pure
+ * in-memory; callers own persistence.
+ */
+// ── Buffer ─────────────────────────────────────────────
+export class ReflectionBuffer {
+    entries = [];
+    idCounter = 0;
+    now;
+    constructor(options = {}) {
+        this.now = options.now ?? (() => Date.now());
+    }
+    /** Record a mistake + correction. */
+    add(input) {
+        const entry = {
+            id: `refl-${++this.idCounter}`,
+            context: input.context,
+            mistake: input.mistake,
+            correction: input.correction,
+            tags: input.tags ?? [],
+            createdAt: this.now(),
+            hits: 0,
+        };
+        this.entries.push(entry);
+        return entry;
+    }
+    /** Retrieve relevant reflections for a context. */
+    retrieve(options = {}) {
+        const limit = options.limit ?? 5;
+        const minAgeMs = (options.minAgeDays ?? 0) * 86_400_000;
+        const maxAgeMs = options.maxAgeDays !== undefined ? options.maxAgeDays * 86_400_000 : Infinity;
+        const now = this.now();
+        const queryLower = options.query?.toLowerCase();
+        const scored = this.entries
+            .filter((e) => {
+            const age = now - e.createdAt;
+            if (age < minAgeMs)
+                return false;
+            if (age > maxAgeMs)
+                return false;
+            if (options.tags && options.tags.length > 0) {
+                if (!e.tags.some((t) => options.tags.includes(t)))
+                    return false;
+            }
+            if (queryLower) {
+                const combined = `${e.context} ${e.mistake}`.toLowerCase();
+                if (!combined.includes(queryLower))
+                    return false;
+            }
+            return true;
+        })
+            .map((entry) => ({
+            entry,
+            score: computeScore(entry, options, now),
+        }));
+        scored.sort((a, b) => b.score - a.score);
+        // Update hits for returned entries
+        const returned = scored.slice(0, limit).map((s) => s.entry);
+        for (const entry of returned) {
+            const idx = this.entries.findIndex((e) => e.id === entry.id);
+            if (idx >= 0) {
+                this.entries[idx] = { ...this.entries[idx], hits: this.entries[idx].hits + 1 };
+            }
+        }
+        return returned;
+    }
+    /** Format reflections as a prompt-injectable block. */
+    formatForPrompt(entries) {
+        if (entries.length === 0)
+            return "";
+        const lines = [
+            "## Relevant past mistakes + corrections",
+            "Before proceeding, recall these past lessons:",
+            "",
+        ];
+        for (const e of entries) {
+            lines.push(`- Context: ${e.context}`);
+            lines.push(`  Mistake: ${e.mistake}`);
+            lines.push(`  Correction: ${e.correction}`);
+            lines.push("");
+        }
+        return lines.join("\n");
+    }
+    size() {
+        return this.entries.length;
+    }
+    list() {
+        return [...this.entries];
+    }
+    removeById(id) {
+        const idx = this.entries.findIndex((e) => e.id === id);
+        if (idx < 0)
+            return false;
+        this.entries.splice(idx, 1);
+        return true;
+    }
+    clear() {
+        this.entries = [];
+        this.idCounter = 0;
+    }
+    /** Serialize to JSON for persistence. */
+    serialize() {
+        return JSON.stringify({ entries: this.entries, idCounter: this.idCounter });
+    }
+    /** Restore from previously serialized state. */
+    loadSerialized(raw) {
+        try {
+            const parsed = JSON.parse(raw);
+            if (Array.isArray(parsed.entries))
+                this.entries = parsed.entries;
+            if (typeof parsed.idCounter === "number")
+                this.idCounter = parsed.idCounter;
+        }
+        catch {
+            // Invalid — leave empty
+        }
+    }
+}
+// ── Scoring ────────────────────────────────────────────
+function computeScore(entry, options, now) {
+    // Base: recency decay (1/day)
+    const ageDays = (now - entry.createdAt) / 86_400_000;
+    let score = 1 / (1 + ageDays * 0.1);
+    // Boost by hits (reflections that keep surfacing are more useful)
+    score += entry.hits * 0.1;
+    // Tag match boost
+    if (options.tags && options.tags.length > 0) {
+        const matchCount = entry.tags.filter((t) => options.tags.includes(t)).length;
+        score += matchCount * 0.2;
+    }
+    // Query substring boost
+    if (options.query) {
+        const q = options.query.toLowerCase();
+        if (entry.context.toLowerCase().includes(q))
+            score += 0.3;
+        if (entry.mistake.toLowerCase().includes(q))
+            score += 0.2;
+    }
+    return score;
+}
+//# sourceMappingURL=reflection-buffer.js.map

package/dist/learning/reflection-buffer.js.map

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

package/dist/learning/rl-feedback-export.d.ts

@@ -0,0 +1,79 @@
+/**
+ * RL feedback export — Cursor accept/reject pairs for DPO/RM training.
+ *
+ * WHAT
+ *   Every time a user accepts or rejects an agent suggestion, that's
+ *   a free preference label. Cursor exports these as DPO-formatted
+ *   {prompt, chosen, rejected} triples that any RM/DPO trainer can
+ *   consume (HuggingFace TRL, Axolotl, OpenRLHF, etc.).
+ *
+ *   This module's contract:
+ *     - Caller owns the corrections array (no I/O here).
+ *     - Output is JSONL: one JSON object per line, no trailing comma.
+ *     - Pure function. Deterministic on inputs.
+ *
+ * SHAPE
+ *   Each output line:
+ *     { "prompt": "<user instruction>",
+ *       "chosen": "<accepted output>",
+ *       "rejected": "<rejected output>",
+ *       "metadata": { ...optional structured metadata } }
+ *
+ *   Skipped corrections (missing chosen OR rejected) are reported via
+ *   the return type, not silently dropped — WOTANN quality bar #5
+ *   (honest stubs over silent success).
+ *
+ * REFERENCE
+ *   Round 58 competitor analysis — Cursor RL accept/reject pairs.
+ */
+/**
+ * One correction record from the caller. Both `chosen` and `rejected`
+ * are required for the record to be exportable; if either is missing
+ * the record is skipped (and counted in the result.skipped tally).
+ */
+export interface CorrectionRecord {
+    readonly prompt: string;
+    readonly chosen?: string;
+    readonly rejected?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Configuration knobs for the export.
+ */
+export interface ExportOptions {
+    readonly minPromptLength: number;
+    readonly minOutputLength: number;
+    readonly stripWhitespace: boolean;
+}
+export declare const DEFAULT_EXPORT_OPTIONS: ExportOptions;
+/**
+ * The export's return shape: the JSONL string PLUS a structured
+ * skip-report for transparency.
+ */
+export interface ExportResult {
+    readonly jsonl: string;
+    readonly emittedCount: number;
+    readonly skipped: ReadonlyArray<{
+        readonly index: number;
+        readonly reason: string;
+    }>;
+}
+/**
+ * Export an array of corrections as JSONL. Pure. Never throws.
+ *
+ * @param corrections array of corrections supplied by the caller
+ * @param options     optional export options; uses DEFAULT_EXPORT_OPTIONS otherwise
+ * @returns           ExportResult with `jsonl`, `emittedCount`, and `skipped` array
+ */
+export declare function exportRlPairs(corrections: ReadonlyArray<CorrectionRecord>, options?: ExportOptions): ExportResult;
+/**
+ * Parse a JSONL string back into corrections. Useful for round-trip
+ * tests and downstream validation.
+ */
+export declare function parseRlPairs(jsonl: string): ReadonlyArray<{
+    prompt: string;
+    chosen: string;
+    rejected: string;
+    metadata?: Readonly<Record<string, unknown>>;
+}>;
+//# sourceMappingURL=rl-feedback-export.d.ts.map

package/dist/learning/rl-feedback-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rl-feedback-export.d.ts","sourceRoot":"","sources":["../../src/learning/rl-feedback-export.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAED,eAAO,MAAM,sBAAsB,EAAE,aAInC,CAAC;AAEH;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;QAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,CAAC,CAAC;CACJ;AA+CD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,aAAa,CAAC,gBAAgB,CAAC,EAC5C,OAAO,GAAE,aAAsC,GAC9C,YAAY,CA+Bd;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC9C,CAAC,CA4BD"}