joonecli 0.1.0

package/dist/__tests__/toolRouter.test.js

@@ -0,0 +1,37 @@
+import { describe, it, expect, beforeEach } from "vitest";
+import { ToolRouter, ToolTarget } from "../tools/router.js";
+describe("Tool Router", () => {
+    let router;
+    beforeEach(() => {
+        router = new ToolRouter();
+    });
+    // ─── Test #20: Routes write_file to host ───
+    it("routes write_file to the host", () => {
+        expect(router.getTarget("write_file")).toBe(ToolTarget.HOST);
+    });
+    // ─── Test #21: Routes read_file to host ───
+    it("routes read_file to the host", () => {
+        expect(router.getTarget("read_file")).toBe(ToolTarget.HOST);
+    });
+    // ─── Test #22: Routes bash to sandbox ───
+    it("routes bash to the sandbox", () => {
+        expect(router.getTarget("bash")).toBe(ToolTarget.SANDBOX);
+    });
+    // ─── Test #23: Routes run_tests to sandbox ───
+    it("routes run_tests to the sandbox", () => {
+        expect(router.getTarget("run_tests")).toBe(ToolTarget.SANDBOX);
+    });
+    // ─── Test #24: Routes install_deps to sandbox ───
+    it("routes install_deps to the sandbox", () => {
+        expect(router.getTarget("install_deps")).toBe(ToolTarget.SANDBOX);
+    });
+    // ─── Test #25: Routes search_tools to host ───
+    it("routes search_tools to the host", () => {
+        expect(router.getTarget("search_tools")).toBe(ToolTarget.HOST);
+    });
+    // ─── Test #26: Unknown tools default to sandbox (safe) ───
+    it("defaults unknown tools to sandbox for safety", () => {
+        expect(router.getTarget("unknown_tool")).toBe(ToolTarget.SANDBOX);
+    });
+});
+//# sourceMappingURL=toolRouter.test.js.map

package/dist/__tests__/toolRouter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolRouter.test.js","sourceRoot":"","sources":["../../src/__tests__/toolRouter.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAM,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE5D,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,IAAI,MAAkB,CAAC;IAEvB,UAAU,CAAC,GAAG,EAAE;QACd,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,8CAA8C;IAE9C,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,6CAA6C;IAE7C,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,2CAA2C;IAE3C,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,gDAAgD;IAEhD,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,mDAAmD;IAEnD,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,gDAAgD;IAEhD,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,4DAA4D;IAE5D,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/tools.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/tools.test.js

@@ -0,0 +1,112 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+import { ReadFileTool, WriteFileTool } from "../tools/index.js";
+describe("ReadFileTool", () => {
+    let tmpDir;
+    beforeEach(() => {
+        tmpDir = fs.mkdtempSync(path.join(process.cwd(), ".joone-tools-test-"));
+    });
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    // ─── Test #27: Reads a normal file ───
+    it("reads a small file and returns its content", async () => {
+        const filePath = path.join(tmpDir, "hello.txt");
+        fs.writeFileSync(filePath, "Hello, world!", "utf-8");
+        const result = await ReadFileTool.execute({ path: filePath });
+        expect(result.content).toBe("Hello, world!");
+    });
+    // ─── Test #28: Returns error for non-existent file ───
+    it("returns an error message for a non-existent file", async () => {
+        const result = await ReadFileTool.execute({
+            path: path.join(tmpDir, "nope.txt"),
+        });
+        expect(result.content).toMatch(/not found/i);
+    });
+    // ─── Test #29: File size guardrail rejects files over 512KB ───
+    it("rejects files larger than 512KB with a descriptive error", async () => {
+        const filePath = path.join(tmpDir, "big.txt");
+        // Create a 600KB file
+        const bigContent = "x".repeat(600 * 1024);
+        fs.writeFileSync(filePath, bigContent, "utf-8");
+        const result = await ReadFileTool.execute({ path: filePath });
+        expect(result.content).toMatch(/too large/i);
+        expect(result.content).toMatch(/512/);
+    });
+    // ─── Test #30: Line range slicing works ───
+    it("returns only the requested line range", async () => {
+        const filePath = path.join(tmpDir, "lines.txt");
+        const lines = Array.from({ length: 20 }, (_, i) => `Line ${i + 1}`);
+        fs.writeFileSync(filePath, lines.join("\n"), "utf-8");
+        const result = await ReadFileTool.execute({
+            path: filePath,
+            startLine: 5,
+            endLine: 7,
+        });
+        expect(result.content).toContain("5: Line 5");
+        expect(result.content).toContain("6: Line 6");
+        expect(result.content).toContain("7: Line 7");
+        expect(result.content).not.toContain("4: Line 4");
+        expect(result.content).not.toContain("8: Line 8");
+    });
+    // ─── Test #31: Line count guardrail truncates long files ───
+    it("truncates files with more than 2000 lines", async () => {
+        const filePath = path.join(tmpDir, "long.txt");
+        // Create a file with 2500 short lines (under 512KB)
+        const lines = Array.from({ length: 2500 }, (_, i) => `L${i + 1}`);
+        fs.writeFileSync(filePath, lines.join("\n"), "utf-8");
+        const result = await ReadFileTool.execute({ path: filePath });
+        expect(result.content).toMatch(/truncated at 2000 lines/i);
+        expect(result.content).toContain("1: L1");
+        expect(result.content).toContain("2000: L2000");
+        expect(result.content).not.toContain("2001: L2001");
+    });
+    // ─── Test #X: Security Guardrail Blocks Outside Files ───
+    it("blocks reading files outside the project workspace", async () => {
+        // Create a file in the OS tmp directory (guaranteed outside project workspace)
+        const outsideDir = fs.mkdtempSync(path.join(os.tmpdir(), "joone-outside-"));
+        const filePath = path.join(outsideDir, "secret.txt");
+        fs.writeFileSync(filePath, "secret token", "utf-8");
+        try {
+            const result = await ReadFileTool.execute({ path: filePath });
+            expect(result.isError).toBe(true);
+            expect(result.content).toMatch(/Security Error: Access Denied/i);
+            expect(result.content).toMatch(/outside the current project workspace/i);
+        }
+        finally {
+            fs.rmSync(outsideDir, { recursive: true, force: true });
+        }
+    });
+});
+describe("WriteFileTool", () => {
+    let tmpDir;
+    beforeEach(() => {
+        tmpDir = fs.mkdtempSync(path.join(process.cwd(), ".joone-write-test-"));
+    });
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    // ─── Test #32: Writes a file to disk ───
+    it("writes content to a file and confirms", async () => {
+        const filePath = path.join(tmpDir, "output.ts");
+        const result = await WriteFileTool.execute({
+            path: filePath,
+            content: "const x = 42;",
+        });
+        expect(result.content).toMatch(/file written/i);
+        expect(fs.readFileSync(filePath, "utf-8")).toBe("const x = 42;");
+    });
+    // ─── Test #33: Creates parent directories if needed ───
+    it("creates parent directories if they do not exist", async () => {
+        const filePath = path.join(tmpDir, "nested", "deep", "file.ts");
+        const result = await WriteFileTool.execute({
+            path: filePath,
+            content: "export {}",
+        });
+        expect(result.content).toMatch(/file written/i);
+        expect(fs.existsSync(filePath)).toBe(true);
+    });
+});
+//# sourceMappingURL=tools.test.js.map

package/dist/__tests__/tools.test.js.map

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

package/dist/__tests__/tracing.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/tracing.test.js

@@ -0,0 +1,147 @@
+import { describe, it, expect, afterEach } from "vitest";
+import { SessionTracer } from "../tracing/sessionTracer.js";
+import { enableLangSmith, disableLangSmith, isLangSmithEnabled, } from "../tracing/langsmith.js";
+import { TraceAnalyzer } from "../tracing/analyzer.js";
+// ═══════════════════════════════════════════════════════════════════════════════
+// 6a: SessionTracer
+// ═══════════════════════════════════════════════════════════════════════════════
+describe("SessionTracer", () => {
+    // ─── Test #83: Records LLM calls and computes totals ───
+    it("records LLM calls and computes token totals", () => {
+        const tracer = new SessionTracer("test-session-1");
+        tracer.recordLLMCall({ promptTokens: 500, completionTokens: 100, cached: false, duration: 800 });
+        tracer.recordLLMCall({ promptTokens: 400, completionTokens: 150, cached: true, duration: 600 });
+        const summary = tracer.getSummary();
+        expect(summary.promptTokens).toBe(900);
+        expect(summary.completionTokens).toBe(250);
+        expect(summary.totalTokens).toBe(1150);
+        expect(summary.turnCount).toBe(2);
+    });
+    // ─── Test #84: Records tool calls and counts them ───
+    it("records tool calls and counts them", () => {
+        const tracer = new SessionTracer("test-session-2");
+        tracer.recordToolCall({ name: "bash", args: { command: "ls" }, duration: 50, success: true });
+        tracer.recordToolCall({ name: "write_file", args: { path: "a.ts" }, duration: 30, success: true });
+        tracer.recordToolCall({ name: "bash", args: { command: "npm test" }, duration: 200, success: false });
+        const summary = tracer.getSummary();
+        expect(summary.toolCallCount).toBe(3);
+    });
+    // ─── Test #85: Computes cache hit rate correctly ───
+    it("computes cache hit rate correctly", () => {
+        const tracer = new SessionTracer("test-session-3");
+        // 3 calls: 2 cached, 1 not
+        tracer.recordLLMCall({ promptTokens: 100, completionTokens: 50, cached: true, duration: 100 });
+        tracer.recordLLMCall({ promptTokens: 100, completionTokens: 50, cached: true, duration: 100 });
+        tracer.recordLLMCall({ promptTokens: 100, completionTokens: 50, cached: false, duration: 100 });
+        const summary = tracer.getSummary();
+        // 200 cached out of 300 total prompt tokens = 66.7%
+        expect(summary.cacheHitRate).toBeCloseTo(0.667, 2);
+    });
+    // ─── Test #86: export() returns valid SessionTrace ───
+    it("export() returns a valid SessionTrace", () => {
+        const tracer = new SessionTracer("export-test");
+        tracer.recordLLMCall({ promptTokens: 100, completionTokens: 50, cached: true, duration: 200 });
+        tracer.recordError({ message: "Timeout", tool: "bash" });
+        const trace = tracer.export();
+        expect(trace.sessionId).toBe("export-test");
+        expect(trace.startedAt).toBeGreaterThan(0);
+        expect(trace.endedAt).toBeGreaterThanOrEqual(trace.startedAt);
+        expect(trace.events).toHaveLength(2);
+        expect(trace.summary.turnCount).toBe(1);
+        expect(trace.summary.errorCount).toBe(1);
+    });
+});
+// ═══════════════════════════════════════════════════════════════════════════════
+// 6b: LangSmith Integration
+// ═══════════════════════════════════════════════════════════════════════════════
+describe("LangSmith Integration", () => {
+    afterEach(() => {
+        disableLangSmith();
+    });
+    // ─── Test #87: enableLangSmith sets correct env vars ───
+    it("sets the correct environment variables", () => {
+        enableLangSmith({ apiKey: "test-key-123", project: "my-project" });
+        expect(process.env.LANGCHAIN_TRACING_V2).toBe("true");
+        expect(process.env.LANGCHAIN_API_KEY).toBe("test-key-123");
+        expect(process.env.LANGCHAIN_PROJECT).toBe("my-project");
+        expect(isLangSmithEnabled()).toBe(true);
+    });
+    // ─── Test #88: disableLangSmith clears env vars ───
+    it("disableLangSmith clears the environment variables", () => {
+        enableLangSmith({ apiKey: "test-key" });
+        disableLangSmith();
+        expect(process.env.LANGCHAIN_TRACING_V2).toBeUndefined();
+        expect(isLangSmithEnabled()).toBe(false);
+    });
+});
+// ═══════════════════════════════════════════════════════════════════════════════
+// 6c: TraceAnalyzer
+// ═══════════════════════════════════════════════════════════════════════════════
+describe("TraceAnalyzer", () => {
+    const createTrace = (overrides) => ({
+        sessionId: "test",
+        startedAt: Date.now() - 10000,
+        endedAt: Date.now(),
+        events: [],
+        summary: {
+            totalTokens: 1000,
+            promptTokens: 700,
+            completionTokens: 300,
+            totalCost: 0.006,
+            cacheHitRate: 0.8,
+            toolCallCount: 5,
+            errorCount: 0,
+            totalDuration: 10000,
+            turnCount: 5,
+        },
+        ...overrides,
+    });
+    // ─── Test #89: Detects loop patterns ───
+    it("detects doom-loop patterns in tool calls", () => {
+        const trace = createTrace({
+            events: [
+                { type: "tool_call", timestamp: 1, data: { name: "bash", args: { command: "ls" } } },
+                { type: "tool_call", timestamp: 2, data: { name: "bash", args: { command: "ls" } } },
+                { type: "tool_call", timestamp: 3, data: { name: "bash", args: { command: "ls" } } },
+            ],
+        });
+        const analyzer = new TraceAnalyzer(trace);
+        const report = analyzer.analyze();
+        const loopIssues = report.issues.filter((i) => i.category === "loop");
+        expect(loopIssues.length).toBeGreaterThan(0);
+        expect(loopIssues[0].severity).toBe("critical");
+    });
+    // ─── Test #90: Detects cost hotspots ───
+    it("flags turns consuming >20% of total tokens", () => {
+        const trace = createTrace({
+            summary: {
+                ...createTrace().summary,
+                totalTokens: 1000,
+            },
+            events: [
+                { type: "llm_call", timestamp: 1, data: { promptTokens: 300, completionTokens: 100, cached: false } },
+                { type: "llm_call", timestamp: 2, data: { promptTokens: 100, completionTokens: 50, cached: true } },
+            ],
+        });
+        const analyzer = new TraceAnalyzer(trace);
+        const report = analyzer.analyze();
+        const costIssues = report.issues.filter((i) => i.category === "cost");
+        expect(costIssues.length).toBeGreaterThan(0);
+    });
+    // ─── Test #91: Warns on low cache hit rate ───
+    it("warns when cache hit rate is below 70%", () => {
+        const trace = createTrace({
+            summary: {
+                ...createTrace().summary,
+                cacheHitRate: 0.5,
+                turnCount: 5,
+            },
+        });
+        const analyzer = new TraceAnalyzer(trace);
+        const report = analyzer.analyze();
+        const cacheIssues = report.issues.filter((i) => i.category === "cache");
+        expect(cacheIssues.length).toBe(1);
+        expect(cacheIssues[0].message).toContain("50.0%");
+    });
+});
+//# sourceMappingURL=tracing.test.js.map

package/dist/__tests__/tracing.test.js.map

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

package/dist/cli/config.d.ts

@@ -0,0 +1,49 @@
+/**
+ * The shape of the Joone configuration file (~/.joone/config.json).
+ */
+export interface JooneConfig {
+    provider: string;
+    model: string;
+    apiKey?: string;
+    maxTokens: number;
+    temperature: number;
+    streaming: boolean;
+    /** E2B sandbox template. If set, uses a pre-baked template (prod). If unset, uses default + lazy install (dev). */
+    sandboxTemplate?: string;
+    /** E2B API key for sandbox provisioning. */
+    e2bApiKey?: string;
+    /** OpenSandbox API key for sandbox fallback provisioning. */
+    openSandboxApiKey?: string;
+    /** OpenSandbox API Domain for fallback. */
+    openSandboxDomain?: string;
+    /** Gemini API key for SecurityScanTool (Gemini CLI inside sandbox). */
+    geminiApiKey?: string;
+    /** Valyu API key for web search. */
+    valyuApiKey?: string;
+    /** LangSmith API key for tracing (optional). */
+    langsmithApiKey?: string;
+    /** LangSmith project name (optional, default: "joone"). */
+    langsmithProject?: string;
+    /** Tool permission mode: 'auto' (no prompts), 'ask_dangerous' (prompt for destructive tools), 'ask_all' (prompt for everything). */
+    permissionMode?: "auto" | "ask_dangerous" | "ask_all";
+}
+/**
+ * Sensible defaults — Anthropic Claude as the default provider.
+ */
+export declare const DEFAULT_CONFIG: JooneConfig;
+/**
+ * Loads the Joone config from the specified path.
+ * Returns DEFAULT_CONFIG if the file does not exist.
+ * Falls back to environment variables for API key if not set in config.
+ */
+export declare function loadConfig(configPath: string): JooneConfig;
+/**
+ * Saves the Joone config to the specified path.
+ * Creates the parent directory if it doesn't exist.
+ * Sets restrictive file permissions (owner-only read/write) for security.
+ */
+export declare function saveConfig(configPath: string, config: JooneConfig): void;
+/**
+ * Returns the expected environment variable name for a provider's API key.
+ */
+export declare function getProviderEnvVar(provider: string): string | undefined;

package/dist/cli/config.js

@@ -0,0 +1,86 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+/**
+ * Sensible defaults — Anthropic Claude as the default provider.
+ */
+export const DEFAULT_CONFIG = {
+    provider: "anthropic",
+    model: "claude-sonnet-4-20250514",
+    maxTokens: 4096,
+    temperature: 0,
+    streaming: true,
+    permissionMode: "auto",
+};
+/**
+ * Maps provider names to their expected environment variable for the API key.
+ */
+const PROVIDER_ENV_VARS = {
+    anthropic: "ANTHROPIC_API_KEY",
+    openai: "OPENAI_API_KEY",
+    google: "GOOGLE_API_KEY",
+    mistral: "MISTRAL_API_KEY",
+    groq: "GROQ_API_KEY",
+    deepseek: "DEEPSEEK_API_KEY",
+    fireworks: "FIREWORKS_API_KEY",
+    together: "TOGETHER_API_KEY",
+    // Ollama (local) doesn't need an API key
+};
+/**
+ * Loads the Joone config from the specified path.
+ * Returns DEFAULT_CONFIG if the file does not exist.
+ * Falls back to environment variables for API key if not set in config.
+ */
+export function loadConfig(configPath) {
+    let config;
+    if (!fs.existsSync(configPath)) {
+        config = { ...DEFAULT_CONFIG };
+    }
+    else {
+        try {
+            const raw = fs.readFileSync(configPath, "utf-8");
+            const parsed = JSON.parse(raw);
+            config = { ...DEFAULT_CONFIG, ...parsed };
+        }
+        catch (err) {
+            console.warn(`Warning: Failed to parse config at ${configPath}. Using defaults.`);
+            config = { ...DEFAULT_CONFIG };
+        }
+    }
+    // Env var fallback: if apiKey is missing, check the provider's env var
+    if (!config.apiKey) {
+        const envVar = PROVIDER_ENV_VARS[config.provider];
+        if (envVar && process.env[envVar]) {
+            config.apiKey = process.env[envVar];
+        }
+    }
+    return config;
+}
+/**
+ * Saves the Joone config to the specified path.
+ * Creates the parent directory if it doesn't exist.
+ * Sets restrictive file permissions (owner-only read/write) for security.
+ */
+export function saveConfig(configPath, config) {
+    const dir = path.dirname(configPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    }
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2), {
+        encoding: "utf-8",
+        mode: 0o600, // Owner read/write only (Linux/macOS)
+    });
+    // On Unix systems, enforce permissions even if file already existed
+    try {
+        fs.chmodSync(configPath, 0o600);
+    }
+    catch {
+        // chmod may fail on Windows — ignore silently
+    }
+}
+/**
+ * Returns the expected environment variable name for a provider's API key.
+ */
+export function getProviderEnvVar(provider) {
+    return PROVIDER_ENV_VARS[provider];
+}
+//# sourceMappingURL=config.js.map

package/dist/cli/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/cli/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAgClC;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,QAAQ,EAAE,WAAW;IACrB,KAAK,EAAE,0BAA0B;IACjC,SAAS,EAAE,IAAI;IACf,WAAW,EAAE,CAAC;IACd,SAAS,EAAE,IAAI;IACf,cAAc,EAAE,MAAM;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,iBAAiB,GAA2B;IAChD,SAAS,EAAE,mBAAmB;IAC9B,MAAM,EAAE,gBAAgB;IACxB,MAAM,EAAE,gBAAgB;IACxB,OAAO,EAAE,iBAAiB;IAC1B,IAAI,EAAE,cAAc;IACpB,QAAQ,EAAE,kBAAkB;IAC5B,SAAS,EAAE,mBAAmB;IAC9B,QAAQ,EAAE,kBAAkB;IAC5B,yCAAyC;CAC1C,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,UAAkB;IAC3C,IAAI,MAAmB,CAAC;IAExB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,CAAC;IACjC,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAyB,CAAC;YACvD,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;QAC5C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,sCAAsC,UAAU,mBAAmB,CAAC,CAAC;YAClF,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,CAAC;QACjC,CAAC;IACH,CAAC;IACD,uEAAuE;IACvE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAClC,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,UAAkB,EAAE,MAAmB;IAChE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;QAC5D,QAAQ,EAAE,OAAO;QACjB,IAAI,EAAE,KAAK,EAAE,sCAAsC;KACpD,CAAC,CAAC;IAEH,oEAAoE;IACpE,IAAI,CAAC;QACH,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,8CAA8C;IAChD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC"}

package/dist/cli/index.d.ts

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