@cleocode/core 2.0.0

package/dist/skills/marketplace.js

@@ -0,0 +1,90 @@
+/**
+ * SkillsMP (Skills Marketplace) integration.
+ * Delegates to @cleocode/caamp MarketplaceClient for core marketplace operations.
+ *
+ * @epic T4454
+ * @task T4521
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { searchSkills as caampSearchSkills, MarketplaceClient } from '@cleocode/caamp';
+import { getProjectRoot } from '../paths.js';
+/**
+ * Load SkillsMP configuration from skillsmp.json.
+ * @task T4521
+ */
+export function loadConfig(cwd) {
+    const projectRoot = getProjectRoot(cwd);
+    const configFile = join(projectRoot, '.cleo', 'skillsmp.json');
+    if (!existsSync(configFile))
+        return null;
+    try {
+        const data = JSON.parse(readFileSync(configFile, 'utf-8'));
+        if (data.enabled !== true)
+            return null;
+        return {
+            enabled: true,
+            cacheDir: data.cacheDir ?? '',
+        };
+    }
+    catch {
+        return null;
+    }
+}
+// ============================================================================
+// API Operations (delegated to CAAMP)
+// ============================================================================
+/**
+ * Convert a CAAMP MarketplaceResult to CLEO's MarketplaceSkill interface.
+ */
+function toMarketplaceSkill(result) {
+    return {
+        id: result.scopedName,
+        name: result.name,
+        description: result.description,
+        version: '0.0.0', // MarketplaceResult does not carry version
+        author: result.author,
+        tags: result.source ? [result.source] : [],
+        downloadUrl: result.githubUrl,
+    };
+}
+/**
+ * Search the skills marketplace.
+ * Delegates to CAAMP's searchSkills for the actual API call.
+ * @task T4521
+ */
+export async function searchSkills(query, _config) {
+    try {
+        const results = await caampSearchSkills(query);
+        return results.map(toMarketplaceSkill);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Get a specific skill from the marketplace.
+ * Uses CAAMP's MarketplaceClient for retrieval.
+ * @task T4521
+ */
+export async function getSkill(skillId, _config) {
+    try {
+        const client = new MarketplaceClient();
+        const result = await client.getSkill(skillId);
+        if (!result)
+            return null;
+        return toMarketplaceSkill(result);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if the marketplace is enabled and reachable.
+ * @task T4521
+ */
+export function isEnabled(cwd) {
+    const config = loadConfig(cwd);
+    return config?.enabled === true;
+}
+//# sourceMappingURL=marketplace.js.map

package/dist/skills/marketplace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace.js","sourceRoot":"","sources":["../../src/skills/marketplace.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,YAAY,IAAI,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAuB7C;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,MAAM,WAAW,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;IAE/D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;QAC3D,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAEvC,OAAO;YACL,OAAO,EAAE,IAAI;YACb,QAAQ,EAAG,IAAI,CAAC,QAAmB,IAAI,EAAE;SAC1C,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,sCAAsC;AACtC,+EAA+E;AAE/E;;GAEG;AACH,SAAS,kBAAkB,CAAC,MAAyB;IACnD,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,UAAU;QACrB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,OAAO,EAAE,OAAO,EAAE,2CAA2C;QAC7D,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE;QAC1C,WAAW,EAAE,MAAM,CAAC,SAAS;KAC9B,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAa,EACb,OAAwB;IAExB,IAAI,CAAC;QACH,MAAM,OAAO,GAAwB,MAAM,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACpE,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,OAAe,EACf,OAAwB;IAExB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,GAAY;IACpC,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;AAClC,CAAC"}

package/dist/skills/orchestrator/spawn.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Orchestrator spawn logic.
+ * Ports lib/skills/orchestrator-spawn.sh (prompt building functions from orchestrator-startup.sh).
+ *
+ * Builds fully-resolved prompts for subagent spawning by:
+ *   1. Loading skill template (SKILL.md)
+ *   2. Injecting token values
+ *   3. Appending protocol base
+ *   4. Appending task context
+ *
+ * @epic T4454
+ * @task T4519
+ */
+import type { Task } from '@cleocode/contracts';
+import type { SpawnPromptResult } from '../types.js';
+/**
+ * Build a fully-resolved prompt for spawning a subagent.
+ * @task T4519
+ */
+export declare function buildPrompt(taskId: string, templateName?: string, cwd?: string, tier?: 0 | 1 | 2): SpawnPromptResult;
+/**
+ * Generate full spawn command with metadata.
+ * @task T4519
+ */
+export declare function spawn(taskId: string, templateName?: string, cwd?: string, tier?: 0 | 1 | 2): SpawnPromptResult & {
+    spawnTimestamp: string;
+};
+/**
+ * Check if tasks can be spawned in parallel (no inter-dependencies).
+ * @task T4519
+ */
+export declare function canParallelize(taskIds: string[], cwd?: string): {
+    canParallelize: boolean;
+    conflicts: Array<Pick<Task, 'id'> & {
+        dependsOn: string[];
+    }>;
+    safeToSpawn: string[];
+};
+/** Result of a single spawn within a batch. */
+export interface BatchSpawnEntry {
+    taskId: string;
+    success: boolean;
+    result?: SpawnPromptResult & {
+        spawnTimestamp: string;
+    };
+    error?: string;
+}
+/** Result of a batch spawn operation. */
+export interface BatchSpawnResult {
+    count: number;
+    succeeded: number;
+    failed: number;
+    spawns: BatchSpawnEntry[];
+}
+/**
+ * Spawn prompts for multiple tasks in a batch.
+ * Ports orchestrator_spawn_batch from lib/skills/orchestrator-spawn.sh.
+ *
+ * Iterates over task IDs, building spawn prompts for each. Individual failures
+ * are captured per-entry rather than aborting the entire batch.
+ *
+ * @task T4712
+ * @epic T4663
+ */
+export declare function spawnBatch(taskIds: string[], templateName?: string, cwd?: string, tier?: 0 | 1 | 2): BatchSpawnResult;
+//# sourceMappingURL=spawn.d.ts.map

package/dist/skills/orchestrator/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/skills/orchestrator/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAMhD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAMrD;;;GAGG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,MAAwB,EACtC,GAAG,CAAC,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GACf,iBAAiB,CAiGnB;AAED;;;GAGG;AACH,wBAAgB,KAAK,CACnB,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,MAAwB,EACtC,GAAG,CAAC,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GACf,iBAAiB,GAAG;IAAE,cAAc,EAAE,MAAM,CAAA;CAAE,CAOhD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EAAE,EACjB,GAAG,CAAC,EAAE,MAAM,GACX;IACD,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG;QAAE,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC7D,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAkCA;AAMD,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,iBAAiB,GAAG;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,yCAAyC;AACzC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EAAE,EACjB,YAAY,CAAC,EAAE,MAAM,EACrB,GAAG,CAAC,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GACf,gBAAgB,CAmBlB"}

package/dist/skills/orchestrator/spawn.js

@@ -0,0 +1,188 @@
+/**
+ * Orchestrator spawn logic.
+ * Ports lib/skills/orchestrator-spawn.sh (prompt building functions from orchestrator-startup.sh).
+ *
+ * Builds fully-resolved prompts for subagent spawning by:
+ *   1. Loading skill template (SKILL.md)
+ *   2. Injecting token values
+ *   3. Appending protocol base
+ *   4. Appending task context
+ *
+ * @epic T4454
+ * @task T4519
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError } from '../../errors.js';
+import { getAgentOutputsDir, getTaskPath } from '../../paths.js';
+import { findSkill, mapSkillName } from '../discovery.js';
+import { injectProtocol } from '../injection/subagent.js';
+// ============================================================================
+// Prompt Building
+// ============================================================================
+/**
+ * Build a fully-resolved prompt for spawning a subagent.
+ * @task T4519
+ */
+export function buildPrompt(taskId, templateName = 'TASK-EXECUTOR', cwd, tier) {
+    const taskPath = getTaskPath(cwd);
+    if (!existsSync(taskPath)) {
+        throw new CleoError(ExitCode.NOT_FOUND, 'Todo file not found. Run: cleo init');
+    }
+    // Load task
+    const data = JSON.parse(readFileSync(taskPath, 'utf-8'));
+    const tasks = data.tasks ?? [];
+    const task = tasks.find((t) => t.id === taskId);
+    if (!task) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Task ${taskId} not found`);
+    }
+    // Find skill template
+    const skill = findSkill(templateName, cwd);
+    if (!skill || !skill.content) {
+        const { canonical } = mapSkillName(templateName);
+        throw new CleoError(ExitCode.NOT_FOUND, `Skill template ${templateName} not found`, {
+            fix: `Expected at skills/${canonical}/SKILL.md`,
+        });
+    }
+    // Prepare token values
+    const dateToday = new Date().toISOString().split('T')[0];
+    const topicSlug = task.title
+        .replace(/[^a-zA-Z0-9]+/g, '-')
+        .toLowerCase()
+        .replace(/^-|-$/g, '');
+    const outputDir = getAgentOutputsDir(cwd);
+    const manifestPath = `${outputDir}/MANIFEST.jsonl`;
+    // Get epic info
+    let epicId = '';
+    if (task.parentId) {
+        epicId = task.parentId;
+    }
+    const tokenValues = {
+        TASK_ID: taskId,
+        DATE: dateToday,
+        TOPIC_SLUG: topicSlug,
+        EPIC_ID: epicId,
+        OUTPUT_DIR: outputDir,
+        MANIFEST_PATH: manifestPath,
+        TITLE: task.title,
+        TASK_TITLE: task.title,
+        TASK_NAME: task.title,
+        TASK_DESCRIPTION: task.description ?? '',
+        RESEARCH_ID: `${topicSlug}-${dateToday}`,
+        // CLEO command defaults
+        TASK_SHOW_CMD: 'cleo show',
+        TASK_START_CMD: 'cleo start',
+        TASK_CURRENT_CMD: 'cleo current',
+        TASK_COMPLETE_CMD: 'cleo complete',
+        TASK_LINK_CMD: 'cleo research link',
+        TASK_LIST_CMD: 'cleo list',
+        TASK_FIND_CMD: 'cleo find',
+        TASK_ADD_CMD: 'cleo add',
+        TASK_EXISTS_CMD: 'cleo exists',
+        TASK_PHASE_CMD: 'cleo phase show',
+        TASK_TREE_CMD: 'cleo list --tree',
+        SESSION_LIST_CMD: 'cleo session list',
+        SESSION_START_CMD: 'cleo session start',
+        SESSION_END_CMD: 'cleo session end',
+        SESSION_GC_CMD: 'cleo session gc',
+        RESEARCH_LIST_CMD: 'cleo research list',
+        RESEARCH_SHOW_CMD: 'cleo research show',
+        RESEARCH_PENDING_CMD: 'cleo research pending',
+        RESEARCH_INJECT_CMD: 'cleo research inject',
+        DASH_CMD: 'cleo dash',
+    };
+    // Extract task-specific tokens
+    if (task.labels?.length) {
+        tokenValues['TOPICS_JSON'] = JSON.stringify(task.labels);
+    }
+    if (task.depends?.length) {
+        tokenValues['DEPENDS_LIST'] = task.depends.join(', ');
+    }
+    // Inject tokens and protocol into template
+    const promptContent = injectProtocol(skill.content, taskId, tokenValues, cwd, tier);
+    return {
+        taskId,
+        template: templateName,
+        topicSlug,
+        date: dateToday,
+        outputDir,
+        outputFile: `${dateToday}_${topicSlug}.md`,
+        prompt: promptContent,
+    };
+}
+/**
+ * Generate full spawn command with metadata.
+ * @task T4519
+ */
+export function spawn(taskId, templateName = 'TASK-EXECUTOR', cwd, tier) {
+    const result = buildPrompt(taskId, templateName, cwd, tier);
+    return {
+        ...result,
+        spawnTimestamp: new Date().toISOString(),
+    };
+}
+/**
+ * Check if tasks can be spawned in parallel (no inter-dependencies).
+ * @task T4519
+ */
+export function canParallelize(taskIds, cwd) {
+    if (taskIds.length === 0) {
+        return { canParallelize: true, conflicts: [], safeToSpawn: [] };
+    }
+    const taskPath = getTaskPath(cwd);
+    if (!existsSync(taskPath)) {
+        return { canParallelize: true, conflicts: [], safeToSpawn: taskIds };
+    }
+    const data = JSON.parse(readFileSync(taskPath, 'utf-8'));
+    const tasks = data.tasks ?? [];
+    const taskIdSet = new Set(taskIds);
+    const conflicts = [];
+    const safeToSpawn = [];
+    for (const tid of taskIds) {
+        const task = tasks.find((t) => t.id === tid);
+        if (!task)
+            continue;
+        const depsInSet = (task.depends ?? []).filter((d) => taskIdSet.has(d));
+        if (depsInSet.length > 0) {
+            conflicts.push({ id: tid, dependsOn: depsInSet });
+        }
+        else {
+            safeToSpawn.push(tid);
+        }
+    }
+    return {
+        canParallelize: conflicts.length === 0,
+        conflicts,
+        safeToSpawn,
+    };
+}
+/**
+ * Spawn prompts for multiple tasks in a batch.
+ * Ports orchestrator_spawn_batch from lib/skills/orchestrator-spawn.sh.
+ *
+ * Iterates over task IDs, building spawn prompts for each. Individual failures
+ * are captured per-entry rather than aborting the entire batch.
+ *
+ * @task T4712
+ * @epic T4663
+ */
+export function spawnBatch(taskIds, templateName, cwd, tier) {
+    const spawns = [];
+    for (const taskId of taskIds) {
+        try {
+            const result = spawn(taskId, templateName, cwd, tier);
+            spawns.push({ taskId, success: true, result });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            spawns.push({ taskId, success: false, error: message });
+        }
+    }
+    return {
+        count: spawns.length,
+        succeeded: spawns.filter((s) => s.success).length,
+        failed: spawns.filter((s) => !s.success).length,
+        spawns,
+    };
+}
+//# sourceMappingURL=spawn.js.map

package/dist/skills/orchestrator/spawn.js.map

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

package/dist/skills/orchestrator/startup.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Orchestrator session startup protocol.
+ * Ports lib/skills/orchestrator-startup.sh.
+ *
+ * Implements the session startup sequence, context monitoring,
+ * dependency analysis, task spawning, and HITL summary generation.
+ *
+ * @epic T4454
+ * @task T4519
+ */
+import type { Task, TaskRefPriority } from '@cleocode/contracts';
+import type { DependencyAnalysis, HitlSummary, OrchestratorThresholds } from '../types.js';
+/**
+ * Get orchestrator context thresholds from config or defaults.
+ * @task T4519
+ */
+export declare function getThresholds(config?: Record<string, unknown>): OrchestratorThresholds;
+interface ContextState {
+    percentage: number;
+    currentTokens: number;
+    maxTokens: number;
+    status: string;
+    stale: boolean;
+}
+/**
+ * Read the current context state from session-aware files.
+ * @task T4519
+ */
+export declare function getContextState(sessionId?: string, cwd?: string): ContextState;
+/** Session init result. */
+export interface SessionInitResult {
+    activeSessions: number;
+    activeSessionId: string | null;
+    activeScope: string | null;
+    hasFocus: boolean;
+    focusedTask: string | null;
+    hasPending: boolean;
+    recommendedAction: 'resume' | 'spawn_followup' | 'create_and_spawn' | 'request_direction';
+    actionReason: string;
+}
+/**
+ * Initialize orchestrator session state.
+ * Determines the recommended action based on current state.
+ * @task T4519
+ */
+export declare function sessionInit(_epicId?: string, cwd?: string): Promise<SessionInitResult>;
+/** Pause status result. */
+export interface PauseStatus {
+    pauseStatus: 'ok' | 'warning' | 'critical';
+    pauseCode: 0 | 1 | 2;
+    shouldPause: boolean;
+    shouldWrapUp: boolean;
+    contextPercentage: number;
+    recommendation: string;
+}
+/**
+ * Check if orchestrator should pause based on context usage.
+ * @task T4519
+ */
+export declare function shouldPause(config?: Record<string, unknown>, sessionId?: string, cwd?: string): PauseStatus;
+/**
+ * Analyze dependency graph and compute execution waves.
+ * @task T4519
+ */
+export declare function analyzeDependencies(epicId: string, cwd?: string): Promise<DependencyAnalysis>;
+/**
+ * Get the next task ready to spawn for an epic.
+ * @task T4519
+ */
+export declare function getNextTask(epicId: string, cwd?: string): Promise<{
+    task: Task | null;
+    readyCount: number;
+}>;
+/**
+ * Get all tasks ready to spawn in parallel (no inter-dependencies).
+ * @task T4519
+ */
+export declare function getReadyTasks(epicId: string, cwd?: string): Promise<TaskRefPriority[]>;
+/**
+ * Generate a Human-in-the-Loop summary for session handoff.
+ * @task T4519
+ */
+export declare function generateHitlSummary(epicId?: string, stopReason?: string, cwd?: string): Promise<HitlSummary>;
+export {};
+//# sourceMappingURL=startup.d.ts.map

package/dist/skills/orchestrator/startup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup.d.ts","sourceRoot":"","sources":["../../../src/skills/orchestrator/startup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAW,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE1E,OAAO,KAAK,EACV,kBAAkB,EAElB,WAAW,EACX,sBAAsB,EACvB,MAAM,aAAa,CAAC;AASrB;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,sBAAsB,CAYtF;AAMD,UAAU,YAAY;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,YAAY,CAkD9E;AAMD,2BAA2B;AAC3B,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,iBAAiB,EAAE,QAAQ,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;IAC1F,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAqE5F;AAMD,2BAA2B;AAC3B,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,IAAI,GAAG,SAAS,GAAG,UAAU,CAAC;IAC3C,SAAS,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,CAAC,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,MAAM,GACX,WAAW,CAkCb;AAMD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,kBAAkB,CAAC,CAmG7B;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAepD;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,eAAe,EAAE,CAAC,CAoB5B;AAMD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,CAAC,EAAE,MAAM,EACf,UAAU,GAAE,MAAwB,EACpC,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,WAAW,CAAC,CAkGtB"}