@dastageer_44/eco-code 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 eco-code contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,105 @@
+# eco-code 🌿
+
+> **Autonomous, Free-Tier AI Coding Agent for your Terminal**  
+> Powered by OpenRouter free models with dynamic discovery and a taste-adaptation harness.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![npm version](https://img.shields.io/npm/v/eco-code.svg)](https://npmjs.com/package/eco-code)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-blue.svg)](https://nodejs.org/)
+
+---
+
+## ⚡ Quick Start
+
+### 1. Instant Run (No installation required)
+```bash
+npx eco-code
+```
+
+### 2. Global Installation
+```bash
+npm install -g eco-code
+eco-code
+```
+
+### 3. Update Anytime
+```bash
+npm update -g eco-code
+```
+
+---
+
+## ✨ Features
+
+- **Zero-Cost Coding**: Automatically queries OpenRouter's live API to discover and connect to available **free tier models** (Qwen 2.5 Coder, DeepSeek, Llama 3.3, Gemini Flash, etc.) at $0/token.
+- **Autonomous Tool Harness**: Equipped with file inspection, line-level editing, creation, directory exploration, and shell command execution.
+- **"Taste" Adaptation Engine**: Inspired by modern meta-agent research (such as Command Code), `eco-code` maintains a `.agent/taste.md` style profile that learns your repository conventions, testing frameworks, and formatting preferences.
+- **Dynamic Model Switching**: Switch between available free models on-the-fly using `/model`.
+- **Direct Shell Escape**: Prefix any command with `!` (e.g. `!git status`, `!npm test`) to run terminal commands without exiting.
+- **Auto-Update Notifier**: Notifies you directly in your terminal whenever a new version is released.
+
+---
+
+## 🚀 Usage & Slash Commands
+
+Inside the `eco-code` interactive REPL:
+
+| Command | Description |
+| :--- | :--- |
+| `/help` | Display the interactive help menu |
+| `/model` | Scan & switch between active OpenRouter free models |
+| `/taste` | View or add directives to the project taste memory (`.agent/taste.md`) |
+| `/key` | Update or rotate your OpenRouter API key |
+| `/clear` | Reset conversation history & context |
+| `!<command>` | Execute a direct terminal command (e.g. `!git diff`, `!npm run build`) |
+| `/exit` | Exit the CLI agent |
+
+---
+
+## 🛠️ Configuration & Credentials
+
+On your first run, `eco-code` will ask for your [OpenRouter API Key](https://openrouter.ai/keys).
+
+- Keys are stored securely in your user home directory (`~/.eco-code/config.json`).
+- You can also set the environment variable:
+  ```bash
+  export OPENROUTER_API_KEY="sk-or-v1-..."
+  ```
+
+---
+
+## 📦 How to Publish & Maintain (For Maintainers)
+
+1. **Clone the repository**:
+   ```bash
+   git clone https://github.com/your-username/eco-code.git
+   cd eco-code
+   ```
+
+2. **Install dependencies**:
+   ```bash
+   npm install
+   ```
+
+3. **Build TypeScript**:
+   ```bash
+   npm run build
+   ```
+
+4. **Test locally with npm link**:
+   ```bash
+   npm link
+   eco-code
+   ```
+
+5. **Publish to NPM**:
+   ```bash
+   npm login
+   npm publish --access public
+   ```
+
+---
+
+## 📄 License
+
+MIT © 2025 eco-code contributors

package/dist/config.d.ts

@@ -0,0 +1,44 @@
+export interface FreeModelInfo {
+    id: string;
+    name: string;
+    contextLength: number;
+    description: string;
+    score: number;
+}
+export interface ModelCache {
+    timestamp: number;
+    dateStr: string;
+    models: FreeModelInfo[];
+}
+export interface EcoConfig {
+    apiKey?: string;
+    defaultModel?: string;
+    systemPromptAddition?: string;
+    autoApproveTools?: boolean;
+    modelCache?: ModelCache;
+}
+export interface SavedSession {
+    id: string;
+    timestamp: number;
+    model: string;
+    messages: any[];
+}
+export declare class ConfigManager {
+    private configDir;
+    private configFile;
+    private sessionsDir;
+    constructor();
+    private ensureDirectoryExists;
+    getConfigPath(): string;
+    load(): EcoConfig;
+    save(config: EcoConfig): void;
+    getApiKey(): string | undefined;
+    setApiKey(key: string): void;
+    getDefaultModel(): string | undefined;
+    setDefaultModel(model: string): void;
+    getCachedModels(): FreeModelInfo[] | null;
+    setCachedModels(models: FreeModelInfo[]): void;
+    saveSession(messages: any[], model: string): void;
+    loadLatestSession(): SavedSession | null;
+    clear(): void;
+}

package/dist/config.js

@@ -0,0 +1,111 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+export class ConfigManager {
+    configDir;
+    configFile;
+    sessionsDir;
+    constructor() {
+        this.configDir = path.join(os.homedir(), '.eco-code');
+        this.configFile = path.join(this.configDir, 'config.json');
+        this.sessionsDir = path.join(this.configDir, 'sessions');
+        this.ensureDirectoryExists();
+    }
+    ensureDirectoryExists() {
+        if (!fs.existsSync(this.configDir)) {
+            fs.mkdirSync(this.configDir, { recursive: true });
+        }
+        if (!fs.existsSync(this.sessionsDir)) {
+            fs.mkdirSync(this.sessionsDir, { recursive: true });
+        }
+    }
+    getConfigPath() {
+        return this.configFile;
+    }
+    load() {
+        try {
+            if (fs.existsSync(this.configFile)) {
+                const raw = fs.readFileSync(this.configFile, 'utf-8');
+                return JSON.parse(raw);
+            }
+        }
+        catch { }
+        return {};
+    }
+    save(config) {
+        this.ensureDirectoryExists();
+        fs.writeFileSync(this.configFile, JSON.stringify(config, null, 2), 'utf-8');
+    }
+    getApiKey() {
+        return process.env.OPENROUTER_API_KEY || this.load().apiKey;
+    }
+    setApiKey(key) {
+        const config = this.load();
+        config.apiKey = key.trim();
+        this.save(config);
+    }
+    getDefaultModel() {
+        return this.load().defaultModel;
+    }
+    setDefaultModel(model) {
+        const config = this.load();
+        config.defaultModel = model;
+        this.save(config);
+    }
+    // --- Model Cache (Daily / 24h invalidation) ---
+    getCachedModels() {
+        const config = this.load();
+        const cache = config.modelCache;
+        if (!cache || !Array.isArray(cache.models) || cache.models.length === 0) {
+            return null;
+        }
+        const todayStr = new Date().toISOString().slice(0, 10);
+        const isWithin24Hours = Date.now() - cache.timestamp < 24 * 60 * 60 * 1000;
+        const isSameDay = cache.dateStr === todayStr;
+        if (isSameDay && isWithin24Hours) {
+            return cache.models;
+        }
+        return null; // Stale cache, needs daily refresh
+    }
+    setCachedModels(models) {
+        const config = this.load();
+        config.modelCache = {
+            timestamp: Date.now(),
+            dateStr: new Date().toISOString().slice(0, 10),
+            models,
+        };
+        this.save(config);
+    }
+    // --- Session Persistence & Resume ---
+    saveSession(messages, model) {
+        this.ensureDirectoryExists();
+        const latestPath = path.join(this.sessionsDir, 'latest.json');
+        const sessionData = {
+            id: 'latest',
+            timestamp: Date.now(),
+            model,
+            messages,
+        };
+        try {
+            fs.writeFileSync(latestPath, JSON.stringify(sessionData, null, 2), 'utf-8');
+        }
+        catch { }
+    }
+    loadLatestSession() {
+        const latestPath = path.join(this.sessionsDir, 'latest.json');
+        try {
+            if (fs.existsSync(latestPath)) {
+                const raw = fs.readFileSync(latestPath, 'utf-8');
+                return JSON.parse(raw);
+            }
+        }
+        catch { }
+        return null;
+    }
+    clear() {
+        if (fs.existsSync(this.configFile)) {
+            fs.unlinkSync(this.configFile);
+        }
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/harness/agent.d.ts

@@ -0,0 +1,51 @@
+import OpenAI from 'openai';
+import { ContextManager } from './context.js';
+import { ConfigManager } from '../config.js';
+export interface TurnCallbacks {
+    onToolStart?: (toolName: string, args: any) => void;
+    onToolEnd?: (toolName: string, result: string) => void;
+    onToken?: (token: string) => void;
+}
+export interface ContextStats {
+    usedTokens: number;
+    maxTokens: number;
+    sessionTotalTokens: number;
+    percentage: number;
+    isWarning: boolean;
+    isCritical: boolean;
+    progressBar: string;
+}
+export declare class AgentHarness {
+    private client;
+    private model;
+    private maxTokens;
+    private currentTokens;
+    private sessionTotalTokens;
+    private contextManager;
+    private configManager;
+    private history;
+    private workspaceDir;
+    constructor(client: OpenAI, model: string, maxTokens: number, configManager: ConfigManager, workspaceDir?: string);
+    resetContext(): void;
+    setModel(newModel: string, maxTokens?: number): void;
+    getModel(): string;
+    getMaxTokens(): number;
+    getSessionTotalTokens(): number;
+    getContextManager(): ContextManager;
+    getHistory(): OpenAI.Chat.Completions.ChatCompletionMessageParam[];
+    setHistory(newHistory: OpenAI.Chat.Completions.ChatCompletionMessageParam[]): void;
+    private recalculateEstimatedTokens;
+    /**
+     * Calculates real-time context token usage and percentage
+     */
+    getContextStats(): ContextStats;
+    /**
+     * Manually compacts context and recalculates tokens
+     */
+    compactContext(): {
+        before: number;
+        after: number;
+        savedPercentage: number;
+    };
+    runTurn(userInput: string, callbacks?: TurnCallbacks): Promise<string>;
+}

package/dist/harness/agent.js

@@ -0,0 +1,168 @@
+import { TOOL_SCHEMAS, executeToolCall } from '../tools/index.js';
+import { ContextManager } from './context.js';
+export class AgentHarness {
+    client;
+    model;
+    maxTokens;
+    currentTokens = 0;
+    sessionTotalTokens = 0;
+    contextManager;
+    configManager;
+    history = [];
+    workspaceDir;
+    constructor(client, model, maxTokens, configManager, workspaceDir = process.cwd()) {
+        this.client = client;
+        this.model = model;
+        this.maxTokens = maxTokens || 8192;
+        this.configManager = configManager;
+        this.workspaceDir = workspaceDir;
+        this.contextManager = new ContextManager(workspaceDir);
+        this.resetContext();
+    }
+    resetContext() {
+        this.history = [
+            {
+                role: 'system',
+                content: this.contextManager.buildSystemPrompt(),
+            },
+        ];
+        this.recalculateEstimatedTokens();
+    }
+    setModel(newModel, maxTokens) {
+        this.model = newModel;
+        if (maxTokens) {
+            this.maxTokens = maxTokens;
+        }
+    }
+    getModel() {
+        return this.model;
+    }
+    getMaxTokens() {
+        return this.maxTokens;
+    }
+    getSessionTotalTokens() {
+        return this.sessionTotalTokens;
+    }
+    getContextManager() {
+        return this.contextManager;
+    }
+    getHistory() {
+        return this.history;
+    }
+    setHistory(newHistory) {
+        this.history = newHistory;
+        this.recalculateEstimatedTokens();
+    }
+    recalculateEstimatedTokens() {
+        const rawStr = JSON.stringify(this.history);
+        // Standard heuristic: ~3.8 characters per token for code/text
+        this.currentTokens = Math.ceil(rawStr.length / 3.8);
+    }
+    /**
+     * Calculates real-time context token usage and percentage
+     */
+    getContextStats() {
+        if (this.currentTokens === 0) {
+            this.recalculateEstimatedTokens();
+        }
+        const percentage = Math.min(100, Math.max(1, Math.round((this.currentTokens / this.maxTokens) * 100)));
+        const isCritical = percentage >= 75;
+        const isWarning = percentage >= 55 && percentage < 75;
+        // Build visual progress bar: [██████░░░░░░░░░░]
+        const totalBars = 10;
+        const filledBars = Math.min(totalBars, Math.round((percentage / 100) * totalBars));
+        const emptyBars = totalBars - filledBars;
+        const progressBar = `[${'█'.repeat(filledBars)}${'░'.repeat(emptyBars)}]`;
+        return {
+            usedTokens: this.currentTokens,
+            maxTokens: this.maxTokens,
+            sessionTotalTokens: this.sessionTotalTokens,
+            percentage,
+            isWarning,
+            isCritical,
+            progressBar,
+        };
+    }
+    /**
+     * Manually compacts context and recalculates tokens
+     */
+    compactContext() {
+        const beforeStats = this.getContextStats();
+        const before = this.history.length;
+        this.history = this.contextManager.manualCompact(this.history, 4);
+        this.recalculateEstimatedTokens();
+        const afterStats = this.getContextStats();
+        const after = this.history.length;
+        const savedPercentage = Math.max(0, beforeStats.percentage - afterStats.percentage);
+        return { before, after, savedPercentage };
+    }
+    async runTurn(userInput, callbacks = {}) {
+        this.history.push({ role: 'user', content: userInput });
+        this.history = this.contextManager.autoCompactHistory(this.history);
+        let maxSteps = 15;
+        let stepCount = 0;
+        while (stepCount < maxSteps) {
+            stepCount++;
+            let response;
+            try {
+                response = await this.client.chat.completions.create({
+                    model: this.model,
+                    messages: this.history,
+                    tools: TOOL_SCHEMAS,
+                    tool_choice: 'auto',
+                    temperature: 0.2,
+                });
+            }
+            catch (err) {
+                throw new Error(`OpenRouter API error with model [${this.model}]: ${err.message}`);
+            }
+            // Record live usage from OpenRouter if reported
+            if (response.usage && response.usage.total_tokens) {
+                this.currentTokens = response.usage.total_tokens;
+                this.sessionTotalTokens += response.usage.total_tokens;
+            }
+            else {
+                this.recalculateEstimatedTokens();
+                // Fallback: estimate session tokens based on current context length
+                // This is a rough heuristic if API doesn't return usage
+                this.sessionTotalTokens += this.currentTokens;
+            }
+            const message = response.choices[0]?.message;
+            if (!message) {
+                throw new Error('Received empty response from model.');
+            }
+            this.history.push(message);
+            // Check if tool calls were requested
+            if (message.tool_calls && message.tool_calls.length > 0) {
+                for (const toolCall of message.tool_calls) {
+                    if (toolCall.type === 'function') {
+                        const funcName = toolCall.function.name;
+                        let args = {};
+                        try {
+                            args = JSON.parse(toolCall.function.arguments);
+                        }
+                        catch {
+                            args = {};
+                        }
+                        callbacks.onToolStart?.(funcName, args);
+                        const toolResult = await executeToolCall(funcName, args, this.workspaceDir);
+                        callbacks.onToolEnd?.(funcName, toolResult);
+                        this.history.push({
+                            role: 'tool',
+                            tool_call_id: toolCall.id,
+                            content: toolResult,
+                        });
+                    }
+                }
+            }
+            else {
+                // Save session state to disk automatically
+                this.configManager.saveSession(this.history, this.model);
+                return message.content || '(No response provided)';
+            }
+        }
+        this.configManager.saveSession(this.history, this.model);
+        return 'Agent reached maximum reasoning steps for this turn.';
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/harness/agent.js.map

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

package/dist/harness/context.d.ts

@@ -0,0 +1,17 @@
+import OpenAI from 'openai';
+import { TasteEngine } from '../taste/engine.js';
+export declare class ContextManager {
+    private tasteEngine;
+    private workspaceDir;
+    constructor(workspaceDir?: string);
+    buildSystemPrompt(): string;
+    getTasteEngine(): TasteEngine;
+    /**
+     * Automatically compacts history if it exceeds rolling limit
+     */
+    autoCompactHistory(messages: OpenAI.Chat.Completions.ChatCompletionMessageParam[], maxTurns?: number): OpenAI.Chat.Completions.ChatCompletionMessageParam[];
+    /**
+     * Explicitly compacts history, keeping system prompt + summary + last N messages
+     */
+    manualCompact(messages: OpenAI.Chat.Completions.ChatCompletionMessageParam[], keepRecent?: number): OpenAI.Chat.Completions.ChatCompletionMessageParam[];
+}

package/dist/harness/context.js

@@ -0,0 +1,77 @@
+import * as os from 'os';
+import { TasteEngine } from '../taste/engine.js';
+export class ContextManager {
+    tasteEngine;
+    workspaceDir;
+    constructor(workspaceDir = process.cwd()) {
+        this.workspaceDir = workspaceDir;
+        this.tasteEngine = new TasteEngine(workspaceDir);
+    }
+    buildSystemPrompt() {
+        const taste = this.tasteEngine.getTastePrompt();
+        return `You are eco-code, an autonomous and intelligent CLI coding assistant.
+You are running directly in the developer's terminal environment.
+
+Current Workspace: ${this.workspaceDir}
+Operating System: ${os.platform()} (${os.arch()})
+
+## Tools — IMPORTANT CONTRACT
+Always prefer these deterministic tools:
+- Use \`read_file\` for all file reading. It is windowed and limits reads to 2000 lines. Do not re-read large files from the beginning.
+- Use \`run_command\` for all shell commands. 
+- For ANY command that might take > 5 seconds, set \`run_in_background: true\`.
+- Read background task output with \`shell_output\` and \`from_offset\` (start at 0, then pass the returned \`next_offset\` for subsequent reads).
+- NEVER manually loop run->sleep->read. Use the \`sleep\` tool to pause, or \`monitor_command\` to wait for an exit or log pattern.
+- Exit code 1 from \`grep\` means "no matches found" — this is NOT an error, do not retry.
+
+## CORE CAPABILITIES & RULES:
+1. Always inspect a file using read_file before attempting to edit it with replace_in_file.
+2. Be precise with replace_in_file: target_content must match the file content verbatim.
+3. When writing code, write complete, working code without placeholders or omissions.
+4. Verify your changes when appropriate.
+5. Keep conversational replies concise. Stop when the task is done. Do not pad responses.
+
+TASTE & DIRECTIVES:
+${taste}`;
+    }
+    getTasteEngine() {
+        return this.tasteEngine;
+    }
+    /**
+     * Automatically compacts history if it exceeds rolling limit
+     */
+    autoCompactHistory(messages, maxTurns = 20) {
+        if (messages.length <= maxTurns) {
+            return messages;
+        }
+        return this.manualCompact(messages, 6);
+    }
+    /**
+     * Explicitly compacts history, keeping system prompt + summary + last N messages
+     */
+    manualCompact(messages, keepRecent = 4) {
+        if (messages.length <= keepRecent + 1) {
+            return messages;
+        }
+        const systemMsg = messages[0];
+        const olderMessages = messages.slice(1, -keepRecent);
+        const recentMessages = messages.slice(-keepRecent);
+        // Extract quick overview of past actions
+        const summaryLines = [];
+        for (const msg of olderMessages) {
+            if (msg.role === 'user' && typeof msg.content === 'string') {
+                summaryLines.push(`User asked: "${msg.content.slice(0, 100)}..."`);
+            }
+            else if (msg.role === 'assistant' && msg.tool_calls) {
+                const toolNames = msg.tool_calls.map((t) => t.type === 'function' ? t.function.name : '').join(', ');
+                summaryLines.push(`Executed tools: [${toolNames}]`);
+            }
+        }
+        const summaryMessage = {
+            role: 'system',
+            content: `[Previous Conversation Compaction Summary]\n${summaryLines.slice(-10).join('\n')}\n(Earlier context compacted to save tokens)`,
+        };
+        return [systemMsg, summaryMessage, ...recentMessages];
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/harness/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/harness/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,OAAO,cAAc;IACjB,WAAW,CAAc;IACzB,YAAY,CAAS;IAE7B,YAAY,eAAuB,OAAO,CAAC,GAAG,EAAE;QAC9C,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,YAAY,CAAC,CAAC;IACnD,CAAC;IAED,iBAAiB;QACf,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC;QAChD,OAAO;;;qBAGU,IAAI,CAAC,YAAY;oBAClB,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE;;;;;;;;;;;;;;;;;;;EAmB7C,KAAK,EAAE,CAAC;IACR,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,kBAAkB,CAChB,QAA8D,EAC9D,WAAmB,EAAE;QAErB,IAAI,QAAQ,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;YAChC,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,aAAa,CACX,QAA8D,EAC9D,aAAqB,CAAC;QAEtB,IAAI,QAAQ,CAAC,MAAM,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACtC,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,aAAa,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;QACrD,MAAM,cAAc,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC;QAEnD,yCAAyC;QACzC,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YAChC,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC3D,YAAY,CAAC,IAAI,CAAC,gBAAgB,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YACrE,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;gBACtD,MAAM,SAAS,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACrG,YAAY,CAAC,IAAI,CAAC,oBAAoB,SAAS,GAAG,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QAED,MAAM,cAAc,GAAuD;YACzE,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,+CAA+C,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,8CAA8C;SACzI,CAAC;QAEF,OAAO,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,cAAc,CAAC,CAAC;IACxD,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};