opentasks 0.0.3 → 0.0.4

package/dist/tracking/claude-tool-categorizer.js

@@ -0,0 +1,98 @@
+/**
+ * Claude Tool Call Categorizer
+ *
+ * Extracts and categorizes tool_use blocks from parsed Claude Code transcripts.
+ * Groups tools by system: claude-native, mcp-sudocode, mcp-other, or unknown.
+ */
+// ============================================================================
+// Categorization
+// ============================================================================
+const CLAUDE_NATIVE_TOOLS = new Set([
+    'TaskCreate',
+    'TaskUpdate',
+    'TaskList',
+    'TaskGet',
+    'EnterPlanMode',
+    'ExitPlanMode',
+]);
+export function categorizeToolName(name) {
+    if (CLAUDE_NATIVE_TOOLS.has(name))
+        return 'claude-native';
+    if (name.startsWith('mcp__plugin_sudocode_sudocode__'))
+        return 'mcp-sudocode';
+    if (name.startsWith('mcp__'))
+        return 'mcp-other';
+    return 'unknown';
+}
+/**
+ * Build a map of tool_use_id → tool_result from all user messages.
+ */
+function buildToolResultMap(lines) {
+    const resultMap = new Map();
+    for (const line of lines) {
+        if (line.type !== 'user')
+            continue;
+        const message = line.message;
+        if (!message?.content)
+            continue;
+        const content = message.content;
+        if (!Array.isArray(content))
+            continue;
+        for (const block of content) {
+            if (block.type !== 'tool_result' || !block.tool_use_id)
+                continue;
+            let contentStr;
+            if (typeof block.content === 'string') {
+                contentStr = block.content;
+            }
+            else if (Array.isArray(block.content)) {
+                contentStr = JSON.stringify(block.content);
+            }
+            else if (block.content !== undefined && block.content !== null) {
+                contentStr = String(block.content);
+            }
+            else {
+                contentStr = '';
+            }
+            resultMap.set(block.tool_use_id, {
+                content: contentStr,
+                isError: !!block.is_error,
+            });
+        }
+    }
+    return resultMap;
+}
+/**
+ * Extract and categorize all tool calls from a parsed Claude Code transcript.
+ */
+export function extractToolCalls(lines) {
+    const resultMap = buildToolResultMap(lines);
+    const toolCalls = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line.type !== 'assistant')
+            continue;
+        const message = line.message;
+        if (!message?.content || !Array.isArray(message.content))
+            continue;
+        for (const block of message.content) {
+            if (block.type !== 'tool_use' || !block.name)
+                continue;
+            const toolUseId = block.id;
+            if (!toolUseId)
+                continue;
+            const result = resultMap.get(toolUseId);
+            toolCalls.push({
+                toolName: block.name,
+                toolUseId,
+                category: categorizeToolName(block.name),
+                input: block.input ?? {},
+                output: result?.content,
+                success: result ? !result.isError : true,
+                lineIndex: i,
+            });
+        }
+    }
+    return toolCalls;
+}
+//# sourceMappingURL=claude-tool-categorizer.js.map

package/dist/tracking/claude-tool-categorizer.js.map

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

package/dist/tracking/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Tracking Module
+ *
+ * Skill usage tracking for agent sessions/trajectories,
+ * plus transcript-based tool extraction and Claude task reconstruction.
+ *
+ * @packageDocumentation
+ */
+export type { SkillName, SkillInvocation, SkillUsageStats, SkillUsageSummary, SkillTrackerOptions, SkillTracker, SkillTrackerRegistry, } from './skill-tracker.js';
+export { createSkillTracker, createSkillTrackerRegistry } from './skill-tracker.js';
+export type { ToolCategory, ExtractedToolCall } from './claude-tool-categorizer.js';
+export { categorizeToolName, extractToolCalls } from './claude-tool-categorizer.js';
+export type { ReconstructedTask, ReconstructedClaudeTaskState, } from './claude-task-reconstructor.js';
+export { reconstructClaudeTaskState } from './claude-task-reconstructor.js';
+export type { PlanModeTransition } from './plan-mode-tracker.js';
+export { extractPlanModeTransitions } from './plan-mode-tracker.js';
+export type { TranscriptExtractorConfig, TranscriptExtractionResult, TranscriptExtractor, } from './transcript-extractor.js';
+export { createTranscriptExtractor } from './transcript-extractor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tracking/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tracking/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EACV,SAAS,EACT,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAEpF,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEpF,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEpF,YAAY,EACV,iBAAiB,EACjB,4BAA4B,GAC7B,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAE5E,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAEpE,YAAY,EACV,yBAAyB,EACzB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/tracking/index.js

@@ -0,0 +1,14 @@
+/**
+ * Tracking Module
+ *
+ * Skill usage tracking for agent sessions/trajectories,
+ * plus transcript-based tool extraction and Claude task reconstruction.
+ *
+ * @packageDocumentation
+ */
+export { createSkillTracker, createSkillTrackerRegistry } from './skill-tracker.js';
+export { categorizeToolName, extractToolCalls } from './claude-tool-categorizer.js';
+export { reconstructClaudeTaskState } from './claude-task-reconstructor.js';
+export { extractPlanModeTransitions } from './plan-mode-tracker.js';
+export { createTranscriptExtractor } from './transcript-extractor.js';
+//# sourceMappingURL=index.js.map

package/dist/tracking/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tracking/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,OAAO,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAIpF,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAOpF,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAI5E,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAQpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/tracking/plan-mode-tracker.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Plan Mode Tracker
+ *
+ * Extracts EnterPlanMode/ExitPlanMode transitions from extracted tool calls.
+ */
+import type { ExtractedToolCall } from './claude-tool-categorizer.js';
+export interface PlanModeTransition {
+    type: 'enter' | 'exit';
+    lineIndex: number;
+    /** For exit: the plan content from ExitPlanMode input */
+    planContent?: string;
+    /** For exit: whether user approved (inferred from tool_result success) */
+    approved?: boolean;
+}
+/**
+ * Extract plan mode transitions from a list of extracted tool calls.
+ * Only processes calls with `toolName` of `EnterPlanMode` or `ExitPlanMode`.
+ */
+export declare function extractPlanModeTransitions(toolCalls: ExtractedToolCall[]): PlanModeTransition[];
+//# sourceMappingURL=plan-mode-tracker.d.ts.map

package/dist/tracking/plan-mode-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-mode-tracker.d.ts","sourceRoot":"","sources":["../../src/tracking/plan-mode-tracker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAMtE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAElB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAMD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,iBAAiB,EAAE,GAAG,kBAAkB,EAAE,CAwB/F"}

package/dist/tracking/plan-mode-tracker.js

@@ -0,0 +1,35 @@
+/**
+ * Plan Mode Tracker
+ *
+ * Extracts EnterPlanMode/ExitPlanMode transitions from extracted tool calls.
+ */
+// ============================================================================
+// Implementation
+// ============================================================================
+/**
+ * Extract plan mode transitions from a list of extracted tool calls.
+ * Only processes calls with `toolName` of `EnterPlanMode` or `ExitPlanMode`.
+ */
+export function extractPlanModeTransitions(toolCalls) {
+    const transitions = [];
+    for (const call of toolCalls) {
+        if (call.category !== 'claude-native')
+            continue;
+        if (call.toolName === 'EnterPlanMode') {
+            transitions.push({
+                type: 'enter',
+                lineIndex: call.lineIndex,
+            });
+        }
+        if (call.toolName === 'ExitPlanMode') {
+            transitions.push({
+                type: 'exit',
+                lineIndex: call.lineIndex,
+                planContent: call.input.plan ?? undefined,
+                approved: call.success,
+            });
+        }
+    }
+    return transitions;
+}
+//# sourceMappingURL=plan-mode-tracker.js.map

package/dist/tracking/plan-mode-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-mode-tracker.js","sourceRoot":"","sources":["../../src/tracking/plan-mode-tracker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmBH,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,SAA8B;IACvE,MAAM,WAAW,GAAyB,EAAE,CAAC;IAE7C,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,IAAI,CAAC,QAAQ,KAAK,eAAe;YAAE,SAAS;QAEhD,IAAI,IAAI,CAAC,QAAQ,KAAK,eAAe,EAAE,CAAC;YACtC,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,OAAO;gBACb,SAAS,EAAE,IAAI,CAAC,SAAS;aAC1B,CAAC,CAAC;QACL,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,KAAK,cAAc,EAAE,CAAC;YACrC,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,MAAM;gBACZ,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,WAAW,EAAG,IAAI,CAAC,KAAK,CAAC,IAAe,IAAI,SAAS;gBACrD,QAAQ,EAAE,IAAI,CAAC,OAAO;aACvB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/tracking/skill-tracker.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Skill Tracker
+ *
+ * Tracks which agent skills (tools) are used during a session/trajectory.
+ * Provides types and a tracker implementation for recording skill invocations,
+ * aggregating usage statistics, and surfacing them in session metadata.
+ *
+ * This enables answering: "What skills did the agent use during this trajectory?"
+ */
+/**
+ * Names of trackable skills (the OpenTasks tool interface)
+ */
+export type SkillName = 'link' | 'query' | 'annotate' | 'task' | 'create' | 'get' | 'update' | 'delete' | string;
+/**
+ * A single skill invocation record
+ */
+export interface SkillInvocation {
+    /** Which skill was invoked */
+    skill: SkillName;
+    /** ISO timestamp of invocation */
+    timestamp: string;
+    /** Whether the invocation succeeded */
+    success: boolean;
+    /** Duration in milliseconds (if available) */
+    durationMs?: number;
+    /** Sub-operation within the skill (e.g., query type: 'ready', 'blockers') */
+    operation?: string;
+    /** Node IDs or URIs involved */
+    targets?: string[];
+    /** Error message if failed */
+    error?: string;
+    /** Agent context at time of invocation */
+    agentId?: string;
+    /** Session context at time of invocation */
+    sessionId?: string;
+}
+/**
+ * Aggregated usage statistics for a single skill
+ */
+export interface SkillUsageStats {
+    /** Skill name */
+    skill: SkillName;
+    /** Total invocation count */
+    count: number;
+    /** Number of successful invocations */
+    successCount: number;
+    /** Number of failed invocations */
+    failureCount: number;
+    /** First invocation timestamp */
+    firstUsedAt: string;
+    /** Last invocation timestamp */
+    lastUsedAt: string;
+    /** Average duration in milliseconds */
+    avgDurationMs?: number;
+    /** Distinct operations used (e.g., query types) */
+    operations: string[];
+}
+/**
+ * Complete skill usage summary for a session/trajectory
+ */
+export interface SkillUsageSummary {
+    /** Session ID this summary belongs to */
+    sessionId: string;
+    /** Total invocations across all skills */
+    totalInvocations: number;
+    /** Distinct skills used */
+    skillsUsed: SkillName[];
+    /** Per-skill statistics */
+    stats: SkillUsageStats[];
+    /** Full invocation log (chronological) */
+    invocations: SkillInvocation[];
+    /** When tracking started */
+    startedAt: string;
+    /** When this summary was last updated */
+    updatedAt: string;
+}
+/**
+ * Options for creating a SkillTracker
+ */
+export interface SkillTrackerOptions {
+    /** Session ID to associate with tracked invocations */
+    sessionId: string;
+    /** Agent ID performing the invocations */
+    agentId?: string;
+    /** Maximum invocations to retain in the log (default: 1000) */
+    maxInvocations?: number;
+}
+/**
+ * SkillTracker interface
+ */
+export interface SkillTracker {
+    /** Record a skill invocation */
+    record(invocation: Omit<SkillInvocation, 'timestamp' | 'agentId' | 'sessionId'>): void;
+    /** Get the full invocation log */
+    getInvocations(): SkillInvocation[];
+    /** Get aggregated usage statistics */
+    getStats(): SkillUsageStats[];
+    /** Get a complete usage summary */
+    getSummary(): SkillUsageSummary;
+    /** Get invocations for a specific skill */
+    getSkillInvocations(skill: SkillName): SkillInvocation[];
+    /** Get the list of distinct skills used */
+    getSkillsUsed(): SkillName[];
+    /** Reset the tracker (clear all recorded invocations) */
+    reset(): void;
+    /** Session ID this tracker is associated with */
+    readonly sessionId: string;
+}
+/**
+ * Create a SkillTracker for recording skill usage during a session
+ */
+export declare function createSkillTracker(options: SkillTrackerOptions): SkillTracker;
+/**
+ * Registry for managing SkillTrackers across concurrent sessions.
+ * The daemon maintains one registry, with one tracker per active session.
+ */
+export interface SkillTrackerRegistry {
+    /** Get or create a tracker for a session */
+    getOrCreate(sessionId: string, agentId?: string): SkillTracker;
+    /** Get an existing tracker (returns null if not found) */
+    get(sessionId: string): SkillTracker | null;
+    /** Remove a tracker when session ends */
+    remove(sessionId: string): SkillUsageSummary | null;
+    /** Get summaries for all active sessions */
+    getAllSummaries(): SkillUsageSummary[];
+    /** Get the number of active trackers */
+    readonly size: number;
+}
+/**
+ * Create a SkillTrackerRegistry for managing per-session trackers
+ */
+export declare function createSkillTrackerRegistry(): SkillTrackerRegistry;
+//# sourceMappingURL=skill-tracker.d.ts.map

package/dist/tracking/skill-tracker.d.ts.map

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

package/dist/tracking/skill-tracker.js

@@ -0,0 +1,130 @@
+/**
+ * Skill Tracker
+ *
+ * Tracks which agent skills (tools) are used during a session/trajectory.
+ * Provides types and a tracker implementation for recording skill invocations,
+ * aggregating usage statistics, and surfacing them in session metadata.
+ *
+ * This enables answering: "What skills did the agent use during this trajectory?"
+ */
+// ============================================================================
+// Implementation
+// ============================================================================
+/**
+ * Create a SkillTracker for recording skill usage during a session
+ */
+export function createSkillTracker(options) {
+    const { sessionId, agentId, maxInvocations = 1000 } = options;
+    let invocations = [];
+    const startedAt = new Date().toISOString();
+    return {
+        get sessionId() {
+            return sessionId;
+        },
+        record(partial) {
+            const invocation = {
+                ...partial,
+                timestamp: new Date().toISOString(),
+                agentId,
+                sessionId,
+            };
+            invocations.push(invocation);
+            // Trim if over limit (keep most recent)
+            if (invocations.length > maxInvocations) {
+                invocations = invocations.slice(-maxInvocations);
+            }
+        },
+        getInvocations() {
+            return [...invocations];
+        },
+        getSkillInvocations(skill) {
+            return invocations.filter((i) => i.skill === skill);
+        },
+        getSkillsUsed() {
+            return [...new Set(invocations.map((i) => i.skill))];
+        },
+        getStats() {
+            const bySkill = new Map();
+            for (const inv of invocations) {
+                const existing = bySkill.get(inv.skill) ?? [];
+                existing.push(inv);
+                bySkill.set(inv.skill, existing);
+            }
+            const stats = [];
+            for (const [skill, skillInvocations] of bySkill) {
+                const successCount = skillInvocations.filter((i) => i.success).length;
+                const failureCount = skillInvocations.length - successCount;
+                const durations = skillInvocations
+                    .map((i) => i.durationMs)
+                    .filter((d) => d !== undefined);
+                const avgDurationMs = durations.length > 0
+                    ? Math.round(durations.reduce((a, b) => a + b, 0) / durations.length)
+                    : undefined;
+                const operations = [
+                    ...new Set(skillInvocations
+                        .map((i) => i.operation)
+                        .filter((op) => op !== undefined)),
+                ];
+                stats.push({
+                    skill,
+                    count: skillInvocations.length,
+                    successCount,
+                    failureCount,
+                    firstUsedAt: skillInvocations[0].timestamp,
+                    lastUsedAt: skillInvocations[skillInvocations.length - 1].timestamp,
+                    avgDurationMs,
+                    operations,
+                });
+            }
+            return stats;
+        },
+        getSummary() {
+            return {
+                sessionId,
+                totalInvocations: invocations.length,
+                skillsUsed: this.getSkillsUsed(),
+                stats: this.getStats(),
+                invocations: this.getInvocations(),
+                startedAt,
+                updatedAt: new Date().toISOString(),
+            };
+        },
+        reset() {
+            invocations = [];
+        },
+    };
+}
+/**
+ * Create a SkillTrackerRegistry for managing per-session trackers
+ */
+export function createSkillTrackerRegistry() {
+    const trackers = new Map();
+    return {
+        get size() {
+            return trackers.size;
+        },
+        getOrCreate(sessionId, agentId) {
+            let tracker = trackers.get(sessionId);
+            if (!tracker) {
+                tracker = createSkillTracker({ sessionId, agentId });
+                trackers.set(sessionId, tracker);
+            }
+            return tracker;
+        },
+        get(sessionId) {
+            return trackers.get(sessionId) ?? null;
+        },
+        remove(sessionId) {
+            const tracker = trackers.get(sessionId);
+            if (!tracker)
+                return null;
+            const summary = tracker.getSummary();
+            trackers.delete(sessionId);
+            return summary;
+        },
+        getAllSummaries() {
+            return Array.from(trackers.values()).map((t) => t.getSummary());
+        },
+    };
+}
+//# sourceMappingURL=skill-tracker.js.map

package/dist/tracking/skill-tracker.js.map

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

package/dist/tracking/transcript-extractor.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Transcript Extractor Orchestrator
+ *
+ * Fetches Entire session transcripts, dispatches to the correct parser,
+ * runs categorization/reconstruction/plan-mode tracking, and backfills
+ * the SkillTrackerRegistry before session finalization.
+ *
+ * Best-effort: errors are caught and logged, never blocking the linker.
+ */
+import type { AgentType, TokenUsage } from 'agent-session-parser';
+import { type ExtractedToolCall, type ToolCategory } from './claude-tool-categorizer.js';
+import { type ReconstructedClaudeTaskState } from './claude-task-reconstructor.js';
+import { type PlanModeTransition } from './plan-mode-tracker.js';
+import type { SkillTrackerRegistry } from './skill-tracker.js';
+import type { EntireSessionEvent } from '../daemon/entire-watcher.js';
+export interface TranscriptExtractorConfig {
+    /** Skill tracker registry for backfilling tool usage */
+    skillTrackerRegistry?: SkillTrackerRegistry;
+    /** Git repo path to resolve transcript from (defaults to cwd) */
+    repoPath?: string;
+    /** Override git command execution (for testing) */
+    execGit?: (args: string) => string;
+}
+export interface TranscriptExtractionResult {
+    sessionId: string;
+    agentType: AgentType | 'unknown';
+    /** All extracted tool calls, chronological */
+    toolCalls: ExtractedToolCall[];
+    /** Tool call counts by category */
+    toolCategories: Record<ToolCategory, number>;
+    /** Claude native task state reconstructed from tool calls */
+    claudeTasks?: ReconstructedClaudeTaskState;
+    /** Plan mode transitions */
+    planModeTransitions: PlanModeTransition[];
+    /** Token usage (from agent-session-parser) */
+    tokenUsage?: TokenUsage;
+    /** Spawned subagent IDs (agentId → toolUseId) */
+    subagentIds?: Record<string, string>;
+}
+export interface TranscriptExtractor {
+    /** Extract tool usage from a session's transcript on session end */
+    extract(event: EntireSessionEvent): Promise<TranscriptExtractionResult | null>;
+}
+export declare function createTranscriptExtractor(config: TranscriptExtractorConfig): TranscriptExtractor;
+//# sourceMappingURL=transcript-extractor.d.ts.map

package/dist/tracking/transcript-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-extractor.d.ts","sourceRoot":"","sources":["../../src/tracking/transcript-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAoB,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC3G,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAA8B,KAAK,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC7F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAMtE,MAAM,WAAW,yBAAyB;IACxC,wDAAwD;IACxD,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAE5C,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,mDAAmD;IACnD,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC;IAEjC,8CAA8C;IAC9C,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAE/B,mCAAmC;IACnC,cAAc,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAE7C,6DAA6D;IAC7D,WAAW,CAAC,EAAE,4BAA4B,CAAC;IAE3C,4BAA4B;IAC5B,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;IAE1C,8CAA8C;IAC9C,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,CAAC;CAChF;AAiED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,yBAAyB,GAAG,mBAAmB,CA6FhG"}