@kernel.chat/kbot 3.28.1 → 3.30.0

package/dist/decision-journal.d.ts

@@ -0,0 +1,72 @@
+export type DecisionType = 'agent-routing' | 'model-selection' | 'tool-choice' | 'fallback-trigger' | 'cost-routing' | 'security-block' | 'learning-extraction' | 'pattern-match' | 'confidence-override';
+export interface Decision {
+    /** When the decision was made */
+    timestamp: string;
+    /** What type of decision */
+    type: DecisionType;
+    /** What was decided */
+    decision: string;
+    /** Why — the reasoning chain */
+    reasoning: string[];
+    /** What alternatives were considered */
+    alternatives: string[];
+    /** Confidence in the decision (0-1) */
+    confidence: number;
+    /** What data informed this decision */
+    evidence: Record<string, unknown>;
+    /** What the user's message was (truncated) */
+    userContext: string;
+    /** Outcome — filled in after execution */
+    outcome?: 'success' | 'failure' | 'partial' | 'unknown';
+}
+/** Log a decision. Call this from agent routing, model selection, tool pipeline, etc. */
+export declare function logDecision(decision: Omit<Decision, 'timestamp'>): void;
+/** Quick helper for agent routing decisions */
+export declare function logAgentRouting(opts: {
+    chosenAgent: string;
+    confidence: number;
+    method: string;
+    alternatives: string[];
+    userMessage: string;
+}): void;
+/** Quick helper for model selection decisions */
+export declare function logModelSelection(opts: {
+    chosenModel: string;
+    chosenProvider: string;
+    reason: string;
+    cost: string;
+    alternatives: string[];
+    userMessage: string;
+}): void;
+/** Quick helper for fallback triggers */
+export declare function logFallback(opts: {
+    from: string;
+    to: string;
+    reason: string;
+    error?: string;
+}): void;
+/** Quick helper for security blocks */
+export declare function logSecurityBlock(opts: {
+    action: string;
+    reason: string;
+    severity: string;
+    userMessage: string;
+}): void;
+/** Get today's decisions */
+export declare function getTodaysDecisions(): Decision[];
+/** Get decisions for a specific date */
+export declare function getDecisions(date: string): Decision[];
+/** Get decisions by type */
+export declare function getDecisionsByType(type: DecisionType, limit?: number): Decision[];
+/** Get decision stats */
+export declare function getDecisionStats(): {
+    total: number;
+    today: number;
+    byType: Record<string, number>;
+    avgConfidence: number;
+    securityBlocks: number;
+    fallbacks: number;
+};
+/** Format decisions for display */
+export declare function formatDecisions(decisions: Decision[]): string;
+//# sourceMappingURL=decision-journal.d.ts.map

package/dist/decision-journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-journal.d.ts","sourceRoot":"","sources":["../src/decision-journal.ts"],"names":[],"mappings":"AA8BA,MAAM,MAAM,YAAY,GACpB,eAAe,GACf,iBAAiB,GACjB,aAAa,GACb,kBAAkB,GAClB,cAAc,GACd,gBAAgB,GAChB,qBAAqB,GACrB,eAAe,GACf,qBAAqB,CAAA;AAEzB,MAAM,WAAW,QAAQ;IACvB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,4BAA4B;IAC5B,IAAI,EAAE,YAAY,CAAA;IAClB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,gCAAgC;IAChC,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,wCAAwC;IACxC,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAA;IAClB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAA;IACnB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;CACxD;AAID,yFAAyF;AACzF,wBAAgB,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,IAAI,CAOvE;AAED,+CAA+C;AAC/C,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;CACpB,GAAG,IAAI,CAgBP;AAED,iDAAiD;AACjD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,MAAM,CAAA;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;CACpB,GAAG,IAAI,CAUP;AAED,yCAAyC;AACzC,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,GAAG,IAAI,CAUP;AAED,uCAAuC;AACvC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;CACpB,GAAG,IAAI,CAUP;AAID,4BAA4B;AAC5B,wBAAgB,kBAAkB,IAAI,QAAQ,EAAE,CAQ/C;AAED,wCAAwC;AACxC,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CAQrD;AAED,4BAA4B;AAC5B,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,SAAK,GAAG,QAAQ,EAAE,CAgB7E;AAED,yBAAyB;AACzB,wBAAgB,gBAAgB,IAAI;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,aAAa,EAAE,MAAM,CAAA;IACrB,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;CAClB,CAiCA;AAED,mCAAmC;AACnC,wBAAgB,eAAe,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CAsB7D"}

package/dist/decision-journal.js

@@ -0,0 +1,200 @@
+// kbot Decision Journal — Log WHY, Not Just What
+//
+// Most AI tools are black boxes. You see the output, not the reasoning.
+// The decision journal captures the WHY behind every key decision:
+//   - Why this agent was routed (confidence, keywords, pattern match)
+//   - Why this model was selected (cost, capability, latency, availability)
+//   - Why this tool was chosen (intent match, past success rate)
+//   - Why a fallback was triggered (error, timeout, rate limit)
+//
+// Users see this via `kbot decisions` — transparency builds trust.
+// Future kbot models learn from the reasoning chains, not just outcomes.
+//
+// Storage: ~/.kbot/memory/decisions/YYYY-MM-DD.jsonl (one JSON per line, append-only)
+import { existsSync, appendFileSync, readFileSync, mkdirSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+const DECISIONS_DIR = join(homedir(), '.kbot', 'memory', 'decisions');
+function ensureDir() {
+    if (!existsSync(DECISIONS_DIR))
+        mkdirSync(DECISIONS_DIR, { recursive: true });
+}
+function todayFile() {
+    return join(DECISIONS_DIR, `${new Date().toISOString().split('T')[0]}.jsonl`);
+}
+// ── Logging ──
+/** Log a decision. Call this from agent routing, model selection, tool pipeline, etc. */
+export function logDecision(decision) {
+    ensureDir();
+    const entry = {
+        ...decision,
+        timestamp: new Date().toISOString(),
+    };
+    appendFileSync(todayFile(), JSON.stringify(entry) + '\n');
+}
+/** Quick helper for agent routing decisions */
+export function logAgentRouting(opts) {
+    logDecision({
+        type: 'agent-routing',
+        decision: `Routed to ${opts.chosenAgent}`,
+        reasoning: [
+            `Method: ${opts.method}`,
+            `Confidence: ${(opts.confidence * 100).toFixed(0)}%`,
+            opts.alternatives.length > 0
+                ? `Considered: ${opts.alternatives.join(', ')}`
+                : 'No strong alternatives',
+        ],
+        alternatives: opts.alternatives,
+        confidence: opts.confidence,
+        evidence: { method: opts.method },
+        userContext: opts.userMessage.slice(0, 100),
+    });
+}
+/** Quick helper for model selection decisions */
+export function logModelSelection(opts) {
+    logDecision({
+        type: 'model-selection',
+        decision: `Selected ${opts.chosenModel} via ${opts.chosenProvider}`,
+        reasoning: [opts.reason, `Cost tier: ${opts.cost}`],
+        alternatives: opts.alternatives,
+        confidence: 0.8,
+        evidence: { model: opts.chosenModel, provider: opts.chosenProvider, cost: opts.cost },
+        userContext: opts.userMessage.slice(0, 100),
+    });
+}
+/** Quick helper for fallback triggers */
+export function logFallback(opts) {
+    logDecision({
+        type: 'fallback-trigger',
+        decision: `Fell back from ${opts.from} to ${opts.to}`,
+        reasoning: [opts.reason, opts.error ? `Error: ${opts.error}` : ''].filter(Boolean),
+        alternatives: [],
+        confidence: 1.0, // Fallbacks are deterministic
+        evidence: { from: opts.from, to: opts.to, error: opts.error },
+        userContext: '',
+    });
+}
+/** Quick helper for security blocks */
+export function logSecurityBlock(opts) {
+    logDecision({
+        type: 'security-block',
+        decision: `Blocked: ${opts.action}`,
+        reasoning: [`Security: ${opts.reason}`, `Severity: ${opts.severity}`],
+        alternatives: [],
+        confidence: 1.0,
+        evidence: { severity: opts.severity },
+        userContext: opts.userMessage.slice(0, 100),
+    });
+}
+// ── Retrieval ──
+/** Get today's decisions */
+export function getTodaysDecisions() {
+    const path = todayFile();
+    if (!existsSync(path))
+        return [];
+    return readFileSync(path, 'utf-8')
+        .split('\n')
+        .filter(Boolean)
+        .map(line => { try {
+        return JSON.parse(line);
+    }
+    catch {
+        return null;
+    } })
+        .filter(Boolean);
+}
+/** Get decisions for a specific date */
+export function getDecisions(date) {
+    const path = join(DECISIONS_DIR, `${date}.jsonl`);
+    if (!existsSync(path))
+        return [];
+    return readFileSync(path, 'utf-8')
+        .split('\n')
+        .filter(Boolean)
+        .map(line => { try {
+        return JSON.parse(line);
+    }
+    catch {
+        return null;
+    } })
+        .filter(Boolean);
+}
+/** Get decisions by type */
+export function getDecisionsByType(type, limit = 50) {
+    ensureDir();
+    const allDecisions = [];
+    const files = readdirSync(DECISIONS_DIR).filter(f => f.endsWith('.jsonl')).sort().reverse();
+    for (const file of files) {
+        if (allDecisions.length >= limit)
+            break;
+        const decisions = readFileSync(join(DECISIONS_DIR, file), 'utf-8')
+            .split('\n')
+            .filter(Boolean)
+            .map(line => { try {
+            return JSON.parse(line);
+        }
+        catch {
+            return null;
+        } })
+            .filter((d) => d !== null && d.type === type);
+        allDecisions.push(...decisions);
+    }
+    return allDecisions.slice(0, limit);
+}
+/** Get decision stats */
+export function getDecisionStats() {
+    ensureDir();
+    const todayDecisions = getTodaysDecisions();
+    const allFiles = readdirSync(DECISIONS_DIR).filter(f => f.endsWith('.jsonl'));
+    let total = 0;
+    const byType = {};
+    let confidenceSum = 0;
+    let securityBlocks = 0;
+    let fallbacks = 0;
+    for (const file of allFiles) {
+        const lines = readFileSync(join(DECISIONS_DIR, file), 'utf-8').split('\n').filter(Boolean);
+        for (const line of lines) {
+            try {
+                const d = JSON.parse(line);
+                total++;
+                byType[d.type] = (byType[d.type] || 0) + 1;
+                confidenceSum += d.confidence;
+                if (d.type === 'security-block')
+                    securityBlocks++;
+                if (d.type === 'fallback-trigger')
+                    fallbacks++;
+            }
+            catch { /* skip corrupt */ }
+        }
+    }
+    return {
+        total,
+        today: todayDecisions.length,
+        byType,
+        avgConfidence: total > 0 ? confidenceSum / total : 0,
+        securityBlocks,
+        fallbacks,
+    };
+}
+/** Format decisions for display */
+export function formatDecisions(decisions) {
+    if (decisions.length === 0)
+        return 'No decisions recorded.';
+    const lines = ['## Decision Journal', ''];
+    for (const d of decisions.slice(0, 20)) {
+        const time = d.timestamp.split('T')[1]?.slice(0, 5) || '?';
+        const conf = `${Math.round(d.confidence * 100)}%`;
+        const icon = d.type === 'security-block' ? '🛡' :
+            d.type === 'fallback-trigger' ? '⚡' :
+                d.type === 'agent-routing' ? '🧭' :
+                    d.type === 'model-selection' ? '🧠' :
+                        d.type === 'cost-routing' ? '💰' : '📝';
+        lines.push(`${icon} **${time}** [${d.type}] ${d.decision} (${conf})`);
+        for (const r of d.reasoning) {
+            lines.push(`  ${r}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=decision-journal.js.map

package/dist/decision-journal.js.map

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

package/dist/episodic-memory.d.ts

@@ -0,0 +1,81 @@
+export interface Episode {
+    /** Unique ID: timestamp-based */
+    id: string;
+    /** When the session started */
+    startedAt: string;
+    /** When the session ended */
+    endedAt: string;
+    /** Duration in minutes */
+    durationMinutes: number;
+    /** One-line summary of what happened */
+    summary: string;
+    /** What the user wanted (extracted from first messages) */
+    userIntent: string[];
+    /** What kbot did (tool calls, agents used) */
+    actions: EpisodeAction[];
+    /** What was learned (new patterns, knowledge, corrections) */
+    learnings: string[];
+    /** What was surprising or new (first-time tools, unusual routing, errors) */
+    surprises: string[];
+    /** Emotional valence of the session */
+    valence: 'triumphant' | 'productive' | 'routine' | 'frustrating' | 'exploratory';
+    /** Agents used and their frequency */
+    agentsUsed: Record<string, number>;
+    /** Tools used and their frequency */
+    toolsUsed: Record<string, number>;
+    /** Total messages exchanged */
+    messageCount: number;
+    /** Tokens consumed */
+    tokensUsed: number;
+    /** Errors encountered */
+    errors: string[];
+    /** Project directory */
+    project: string;
+    /** Tags for retrieval */
+    tags: string[];
+}
+export interface EpisodeAction {
+    /** What tool or agent was invoked */
+    action: string;
+    /** Brief description of what it did */
+    description: string;
+    /** Whether it succeeded */
+    success: boolean;
+    /** Timestamp */
+    timestamp: string;
+}
+/** Start collecting episode data for a new session */
+export declare function startEpisode(project: string): void;
+/** Record a user message (extracts intent from early messages) */
+export declare function recordUserMessage(message: string): void;
+/** Record a tool execution */
+export declare function recordToolUse(toolName: string, description: string, success: boolean): void;
+/** Record agent routing */
+export declare function recordAgentUse(agentId: string): void;
+/** Record an error */
+export declare function recordError(error: string): void;
+/** Record something learned */
+export declare function recordLearning(learning: string): void;
+/** Record something surprising */
+export declare function recordSurprise(surprise: string): void;
+/** Record token usage */
+export declare function recordTokens(tokens: number): void;
+/** End the current session and save the episode */
+export declare function endEpisode(): Episode | null;
+/** List all episodes, newest first */
+export declare function listEpisodes(limit?: number): Episode[];
+/** Search episodes by tag */
+export declare function searchEpisodes(tag: string): Episode[];
+/** Get episode stats */
+export declare function getEpisodeStats(): {
+    total: number;
+    totalMinutes: number;
+    totalMessages: number;
+    totalTokens: number;
+    valenceDistribution: Record<string, number>;
+    topTools: Array<[string, number]>;
+    topAgents: Array<[string, number]>;
+};
+/** Format episodes for display */
+export declare function formatEpisodeList(episodes: Episode[]): string;
+//# sourceMappingURL=episodic-memory.d.ts.map

package/dist/episodic-memory.d.ts.map

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

package/dist/episodic-memory.js

@@ -0,0 +1,260 @@
+// kbot Episodic Memory — Sessions as Stories
+//
+// Pattern cache answers: "what tool sequence works for this problem?"
+// Solution cache answers: "what's the answer to this question?"
+// Episodic memory answers: "what HAPPENED?"
+//
+// After each session, kbot generates a narrative episode:
+//   - What the user wanted
+//   - What kbot did
+//   - What was surprising or new
+//   - What kbot learned
+//   - Emotional valence (was it frustrating? triumphant? routine?)
+//
+// Present kbot uses episodes for better session context.
+// Future kbot (70B+) will reason about the narrative arc across episodes
+// and understand growth, patterns of failure, and turning points.
+//
+// Storage: ~/.kbot/memory/episodes/YYYY-MM-DD_HH-MM.json
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+const EPISODES_DIR = join(homedir(), '.kbot', 'memory', 'episodes');
+function ensureDir() {
+    if (!existsSync(EPISODES_DIR))
+        mkdirSync(EPISODES_DIR, { recursive: true });
+}
+// ── Episode Collection (During Session) ──
+let currentEpisode = null;
+let sessionActions = [];
+let sessionErrors = [];
+let sessionIntents = [];
+let sessionLearnings = [];
+let sessionSurprises = [];
+let sessionAgents = {};
+let sessionTools = {};
+let sessionMessages = 0;
+let sessionTokens = 0;
+/** Start collecting episode data for a new session */
+export function startEpisode(project) {
+    currentEpisode = {
+        id: new Date().toISOString().replace(/[:.]/g, '-'),
+        startedAt: new Date().toISOString(),
+        project,
+    };
+    sessionActions = [];
+    sessionErrors = [];
+    sessionIntents = [];
+    sessionLearnings = [];
+    sessionSurprises = [];
+    sessionAgents = {};
+    sessionTools = {};
+    sessionMessages = 0;
+    sessionTokens = 0;
+}
+/** Record a user message (extracts intent from early messages) */
+export function recordUserMessage(message) {
+    sessionMessages++;
+    // Extract intent from first 3 messages
+    if (sessionIntents.length < 3 && message.length > 10) {
+        sessionIntents.push(message.slice(0, 200));
+    }
+}
+/** Record a tool execution */
+export function recordToolUse(toolName, description, success) {
+    sessionTools[toolName] = (sessionTools[toolName] || 0) + 1;
+    sessionActions.push({
+        action: toolName,
+        description: description.slice(0, 100),
+        success,
+        timestamp: new Date().toISOString(),
+    });
+}
+/** Record agent routing */
+export function recordAgentUse(agentId) {
+    sessionAgents[agentId] = (sessionAgents[agentId] || 0) + 1;
+}
+/** Record an error */
+export function recordError(error) {
+    sessionErrors.push(error.slice(0, 200));
+}
+/** Record something learned */
+export function recordLearning(learning) {
+    sessionLearnings.push(learning.slice(0, 200));
+}
+/** Record something surprising */
+export function recordSurprise(surprise) {
+    sessionSurprises.push(surprise.slice(0, 200));
+}
+/** Record token usage */
+export function recordTokens(tokens) {
+    sessionTokens += tokens;
+}
+// ── Episode Finalization ──
+/** Determine the emotional valence of the session */
+function determineValence() {
+    const errorRate = sessionActions.length > 0 ? sessionErrors.length / sessionActions.length : 0;
+    const successRate = sessionActions.length > 0
+        ? sessionActions.filter(a => a.success).length / sessionActions.length
+        : 1;
+    if (sessionSurprises.length > 2 || sessionLearnings.length > 3)
+        return 'exploratory';
+    if (errorRate > 0.3)
+        return 'frustrating';
+    if (successRate > 0.9 && sessionActions.length > 10)
+        return 'triumphant';
+    if (successRate > 0.7)
+        return 'productive';
+    return 'routine';
+}
+/** Generate a one-line summary from session data */
+function generateSummary() {
+    const topTools = Object.entries(sessionTools).sort((a, b) => b[1] - a[1]).slice(0, 3).map(([t]) => t);
+    const topAgents = Object.entries(sessionAgents).sort((a, b) => b[1] - a[1]).slice(0, 2).map(([a]) => a);
+    const actionCount = sessionActions.length;
+    const intent = sessionIntents[0]?.slice(0, 60) || 'general session';
+    const parts = [];
+    parts.push(`${actionCount} actions`);
+    if (topAgents.length)
+        parts.push(`via ${topAgents.join(', ')}`);
+    if (topTools.length)
+        parts.push(`using ${topTools.join(', ')}`);
+    parts.push(`— "${intent}"`);
+    return parts.join(' ');
+}
+/** Generate tags for retrieval */
+function generateTags() {
+    const tags = [];
+    // Tool-based tags
+    if (sessionTools['file_write'] || sessionTools['file_edit'])
+        tags.push('coding');
+    if (sessionTools['bash'])
+        tags.push('shell');
+    if (sessionTools['git_commit'] || sessionTools['git_push'])
+        tags.push('git');
+    if (sessionTools['web_search'])
+        tags.push('research');
+    if (sessionTools['market_data'] || sessionTools['technical_analysis'])
+        tags.push('finance');
+    if (sessionTools['dep_audit'] || sessionTools['secret_scan'] || sessionTools['owasp_check'])
+        tags.push('security');
+    if (sessionTools['paper_trade'] || sessionTools['swap_execute'])
+        tags.push('trading');
+    // Agent-based tags
+    for (const agent of Object.keys(sessionAgents)) {
+        tags.push(agent);
+    }
+    // Valence tag
+    tags.push(determineValence());
+    // Error tag
+    if (sessionErrors.length > 0)
+        tags.push('had-errors');
+    return [...new Set(tags)];
+}
+/** End the current session and save the episode */
+export function endEpisode() {
+    if (!currentEpisode?.startedAt)
+        return null;
+    const now = new Date();
+    const started = new Date(currentEpisode.startedAt);
+    const durationMinutes = Math.round((now.getTime() - started.getTime()) / 60_000);
+    const episode = {
+        id: currentEpisode.id || now.toISOString(),
+        startedAt: currentEpisode.startedAt,
+        endedAt: now.toISOString(),
+        durationMinutes,
+        summary: generateSummary(),
+        userIntent: sessionIntents,
+        actions: sessionActions.slice(-50), // Keep last 50 actions
+        learnings: sessionLearnings,
+        surprises: sessionSurprises,
+        valence: determineValence(),
+        agentsUsed: sessionAgents,
+        toolsUsed: sessionTools,
+        messageCount: sessionMessages,
+        tokensUsed: sessionTokens,
+        errors: sessionErrors.slice(-10),
+        project: currentEpisode.project || process.cwd(),
+        tags: generateTags(),
+    };
+    // Save
+    ensureDir();
+    const filename = `${started.toISOString().split('T')[0]}_${started.toISOString().split('T')[1].slice(0, 5).replace(':', '-')}.json`;
+    writeFileSync(join(EPISODES_DIR, filename), JSON.stringify(episode, null, 2));
+    currentEpisode = null;
+    return episode;
+}
+// ── Episode Retrieval ──
+/** List all episodes, newest first */
+export function listEpisodes(limit = 20) {
+    ensureDir();
+    const files = readdirSync(EPISODES_DIR)
+        .filter(f => f.endsWith('.json'))
+        .sort()
+        .reverse()
+        .slice(0, limit);
+    return files.map(f => {
+        try {
+            return JSON.parse(readFileSync(join(EPISODES_DIR, f), 'utf-8'));
+        }
+        catch {
+            return null;
+        }
+    }).filter(Boolean);
+}
+/** Search episodes by tag */
+export function searchEpisodes(tag) {
+    return listEpisodes(100).filter(e => e.tags.includes(tag.toLowerCase()));
+}
+/** Get episode stats */
+export function getEpisodeStats() {
+    const episodes = listEpisodes(1000);
+    const toolTotals = {};
+    const agentTotals = {};
+    const valence = {};
+    let totalMinutes = 0;
+    let totalMessages = 0;
+    let totalTokens = 0;
+    for (const ep of episodes) {
+        totalMinutes += ep.durationMinutes;
+        totalMessages += ep.messageCount;
+        totalTokens += ep.tokensUsed;
+        valence[ep.valence] = (valence[ep.valence] || 0) + 1;
+        for (const [tool, count] of Object.entries(ep.toolsUsed)) {
+            toolTotals[tool] = (toolTotals[tool] || 0) + count;
+        }
+        for (const [agent, count] of Object.entries(ep.agentsUsed)) {
+            agentTotals[agent] = (agentTotals[agent] || 0) + count;
+        }
+    }
+    return {
+        total: episodes.length,
+        totalMinutes,
+        totalMessages,
+        totalTokens,
+        valenceDistribution: valence,
+        topTools: Object.entries(toolTotals).sort((a, b) => b[1] - a[1]).slice(0, 10),
+        topAgents: Object.entries(agentTotals).sort((a, b) => b[1] - a[1]).slice(0, 10),
+    };
+}
+/** Format episodes for display */
+export function formatEpisodeList(episodes) {
+    if (episodes.length === 0)
+        return 'No episodes recorded yet.';
+    const lines = ['## Session History', ''];
+    for (const ep of episodes) {
+        const date = ep.startedAt.split('T')[0];
+        const duration = ep.durationMinutes < 60
+            ? `${ep.durationMinutes}m`
+            : `${Math.floor(ep.durationMinutes / 60)}h ${ep.durationMinutes % 60}m`;
+        const valenceIcon = {
+            triumphant: '🏆', productive: '⚡', routine: '📎', frustrating: '🔥', exploratory: '🔭',
+        }[ep.valence] || '•';
+        lines.push(`${valenceIcon} **${date}** (${duration}) — ${ep.summary}`);
+        if (ep.learnings.length > 0) {
+            lines.push(`  Learned: ${ep.learnings[0]}`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=episodic-memory.js.map

package/dist/episodic-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"episodic-memory.js","sourceRoot":"","sources":["../src/episodic-memory.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,EAAE;AACF,sEAAsE;AACtE,gEAAgE;AAChE,4CAA4C;AAC5C,EAAE;AACF,0DAA0D;AAC1D,2BAA2B;AAC3B,oBAAoB;AACpB,iCAAiC;AACjC,wBAAwB;AACxB,mEAAmE;AACnE,EAAE;AACF,yDAAyD;AACzD,yEAAyE;AACzE,kEAAkE;AAClE,EAAE;AACF,yDAAyD;AAEzD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACzF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEjC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAA;AAEnE,SAAS,SAAS;IAChB,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,SAAS,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;AAC7E,CAAC;AAoDD,4CAA4C;AAE5C,IAAI,cAAc,GAA4B,IAAI,CAAA;AAClD,IAAI,cAAc,GAAoB,EAAE,CAAA;AACxC,IAAI,aAAa,GAAa,EAAE,CAAA;AAChC,IAAI,cAAc,GAAa,EAAE,CAAA;AACjC,IAAI,gBAAgB,GAAa,EAAE,CAAA;AACnC,IAAI,gBAAgB,GAAa,EAAE,CAAA;AACnC,IAAI,aAAa,GAA2B,EAAE,CAAA;AAC9C,IAAI,YAAY,GAA2B,EAAE,CAAA;AAC7C,IAAI,eAAe,GAAG,CAAC,CAAA;AACvB,IAAI,aAAa,GAAG,CAAC,CAAA;AAErB,sDAAsD;AACtD,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,cAAc,GAAG;QACf,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;QAClD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,OAAO;KACR,CAAA;IACD,cAAc,GAAG,EAAE,CAAA;IACnB,aAAa,GAAG,EAAE,CAAA;IAClB,cAAc,GAAG,EAAE,CAAA;IACnB,gBAAgB,GAAG,EAAE,CAAA;IACrB,gBAAgB,GAAG,EAAE,CAAA;IACrB,aAAa,GAAG,EAAE,CAAA;IAClB,YAAY,GAAG,EAAE,CAAA;IACjB,eAAe,GAAG,CAAC,CAAA;IACnB,aAAa,GAAG,CAAC,CAAA;AACnB,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,eAAe,EAAE,CAAA;IACjB,uCAAuC;IACvC,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACrD,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;IAC5C,CAAC;AACH,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,WAAmB,EAAE,OAAgB;IACnF,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;IAC1D,cAAc,CAAC,IAAI,CAAC;QAClB,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;QACtC,OAAO;QACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC,CAAA;AACJ,CAAC;AAED,2BAA2B;AAC3B,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;AAC5D,CAAC;AAED,sBAAsB;AACtB,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;AACzC,CAAC;AAED,+BAA+B;AAC/B,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;AAC/C,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;AAC/C,CAAC;AAED,yBAAyB;AACzB,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,aAAa,IAAI,MAAM,CAAA;AACzB,CAAC;AAED,6BAA6B;AAE7B,qDAAqD;AACrD,SAAS,gBAAgB;IACvB,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IAC9F,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,GAAG,CAAC;QAC3C,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM;QACtE,CAAC,CAAC,CAAC,CAAA;IAEL,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,aAAa,CAAA;IACpF,IAAI,SAAS,GAAG,GAAG;QAAE,OAAO,aAAa,CAAA;IACzC,IAAI,WAAW,GAAG,GAAG,IAAI,cAAc,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,YAAY,CAAA;IACxE,IAAI,WAAW,GAAG,GAAG;QAAE,OAAO,YAAY,CAAA;IAC1C,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,oDAAoD;AACpD,SAAS,eAAe;IACtB,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;IACrG,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;IACvG,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,CAAA;IACzC,MAAM,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,iBAAiB,CAAA;IAEnE,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,CAAC,IAAI,CAAC,GAAG,WAAW,UAAU,CAAC,CAAA;IACpC,IAAI,SAAS,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC/D,IAAI,QAAQ,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC/D,KAAK,CAAC,IAAI,CAAC,MAAM,MAAM,GAAG,CAAC,CAAA;IAE3B,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACxB,CAAC;AAED,kCAAkC;AAClC,SAAS,YAAY;IACnB,MAAM,IAAI,GAAa,EAAE,CAAA;IAEzB,kBAAkB;IAClB,IAAI,YAAY,CAAC,YAAY,CAAC,IAAI,YAAY,CAAC,WAAW,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAChF,IAAI,YAAY,CAAC,MAAM,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC5C,IAAI,YAAY,CAAC,YAAY,CAAC,IAAI,YAAY,CAAC,UAAU,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC5E,IAAI,YAAY,CAAC,YAAY,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACrD,IAAI,YAAY,CAAC,aAAa,CAAC,IAAI,YAAY,CAAC,oBAAoB,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAC3F,IAAI,YAAY,CAAC,WAAW,CAAC,IAAI,YAAY,CAAC,aAAa,CAAC,IAAI,YAAY,CAAC,aAAa,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IAClH,IAAI,YAAY,CAAC,aAAa,CAAC,IAAI,YAAY,CAAC,cAAc,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAErF,mBAAmB;IACnB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAClB,CAAC;IAED,cAAc;IACd,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAA;IAE7B,YAAY;IACZ,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;IAErD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;AAC3B,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC,cAAc,EAAE,SAAS;QAAE,OAAO,IAAI,CAAA;IAE3C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;IACtB,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAA;IAClD,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,CAAA;IAEhF,MAAM,OAAO,GAAY;QACvB,EAAE,EAAE,cAAc,CAAC,EAAE,IAAI,GAAG,CAAC,WAAW,EAAE;QAC1C,SAAS,EAAE,cAAc,CAAC,SAAS;QACnC,OAAO,EAAE,GAAG,CAAC,WAAW,EAAE;QAC1B,eAAe;QACf,OAAO,EAAE,eAAe,EAAE;QAC1B,UAAU,EAAE,cAAc;QAC1B,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,uBAAuB;QAC3D,SAAS,EAAE,gBAAgB;QAC3B,SAAS,EAAE,gBAAgB;QAC3B,OAAO,EAAE,gBAAgB,EAAE;QAC3B,UAAU,EAAE,aAAa;QACzB,SAAS,EAAE,YAAY;QACvB,YAAY,EAAE,eAAe;QAC7B,UAAU,EAAE,aAAa;QACzB,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,cAAc,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE;QAChD,IAAI,EAAE,YAAY,EAAE;KACrB,CAAA;IAED,OAAO;IACP,SAAS,EAAE,CAAA;IACX,MAAM,QAAQ,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,CAAA;IACnI,aAAa,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;IAE7E,cAAc,GAAG,IAAI,CAAA;IACrB,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,0BAA0B;AAE1B,sCAAsC;AACtC,MAAM,UAAU,YAAY,CAAC,KAAK,GAAG,EAAE;IACrC,SAAS,EAAE,CAAA;IACX,MAAM,KAAK,GAAG,WAAW,CAAC,YAAY,CAAC;SACpC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;SAChC,IAAI,EAAE;SACN,OAAO,EAAE;SACT,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;IAElB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QACnB,IAAI,CAAC;YAAC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAA;QAAC,CAAC;QACvE,MAAM,CAAC;YAAC,OAAO,IAAI,CAAA;QAAC,CAAC;IACvB,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAc,CAAA;AACjC,CAAC;AAED,6BAA6B;AAC7B,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;AAC1E,CAAC;AAED,wBAAwB;AACxB,MAAM,UAAU,eAAe;IAS7B,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;IACnC,MAAM,UAAU,GAA2B,EAAE,CAAA;IAC7C,MAAM,WAAW,GAA2B,EAAE,CAAA;IAC9C,MAAM,OAAO,GAA2B,EAAE,CAAA;IAE1C,IAAI,YAAY,GAAG,CAAC,CAAA;IACpB,IAAI,aAAa,GAAG,CAAC,CAAA;IACrB,IAAI,WAAW,GAAG,CAAC,CAAA;IAEnB,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC1B,YAAY,IAAI,EAAE,CAAC,eAAe,CAAA;QAClC,aAAa,IAAI,EAAE,CAAC,YAAY,CAAA;QAChC,WAAW,IAAI,EAAE,CAAC,UAAU,CAAA;QAC5B,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;QAEpD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;YACzD,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAA;QACpD,CAAC;QACD,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3D,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAA;QACxD,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,QAAQ,CAAC,MAAM;QACtB,YAAY;QACZ,aAAa;QACb,WAAW;QACX,mBAAmB,EAAE,OAAO;QAC5B,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAC7E,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;KAChF,CAAA;AACH,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,iBAAiB,CAAC,QAAmB;IACnD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,2BAA2B,CAAA;IAE7D,MAAM,KAAK,GAAa,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAA;IAClD,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QACvC,MAAM,QAAQ,GAAG,EAAE,CAAC,eAAe,GAAG,EAAE;YACtC,CAAC,CAAC,GAAG,EAAE,CAAC,eAAe,GAAG;YAC1B,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,eAAe,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,eAAe,GAAG,EAAE,GAAG,CAAA;QACzE,MAAM,WAAW,GAAG;YAClB,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI;SACvF,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,GAAG,CAAA;QAEpB,KAAK,CAAC,IAAI,CAAC,GAAG,WAAW,MAAM,IAAI,OAAO,QAAQ,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;QACtE,IAAI,EAAE,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;QAC7C,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}