@hemansubedi/aether-ai 1.0.0

package/assets/aether-banner.svg

@@ -0,0 +1,62 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 300" width="1200" height="300">
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="#0a0e1a"/>
+      <stop offset="50%" stop-color="#0f1525"/>
+      <stop offset="100%" stop-color="#0a0e1a"/>
+    </linearGradient>
+    <linearGradient id="titleGrad" x1="0" y1="0" x2="1" y2="0">
+      <stop offset="0%" stop-color="#7dd3fc"/>
+      <stop offset="50%" stop-color="#a78bfa"/>
+      <stop offset="100%" stop-color="#f0abfc"/>
+    </linearGradient>
+    <linearGradient id="lineGrad" x1="0" y1="0" x2="1" y2="0">
+      <stop offset="0%" stop-color="#22d3ee" stop-opacity="0"/>
+      <stop offset="50%" stop-color="#22d3ee" stop-opacity="1"/>
+      <stop offset="100%" stop-color="#22d3ee" stop-opacity="0"/>
+    </linearGradient>
+    <filter id="glow" x="-50%" y="-50%" width="200%" height="200%">
+      <feGaussianBlur stdDeviation="4" result="b"/>
+      <feMerge>
+        <feMergeNode in="b"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+    <filter id="bigGlow" x="-100%" y="-100%" width="300%" height="300%">
+      <feGaussianBlur stdDeviation="8" result="b"/>
+      <feMerge>
+        <feMergeNode in="b"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+  </defs>
+  <rect width="1200" height="300" fill="url(#bg)"/>
+  <g fill="#1e293b">
+    <circle cx="100" cy="80" r="1.5"/><circle cx="200" cy="80" r="1.5"/><circle cx="300" cy="80" r="1.5"/>
+    <circle cx="100" cy="150" r="1.5"/><circle cx="200" cy="150" r="1.5"/><circle cx="300" cy="150" r="1.5"/>
+    <circle cx="100" cy="220" r="1.5"/><circle cx="200" cy="220" r="1.5"/><circle cx="300" cy="220" r="1.5"/>
+    <circle cx="900" cy="80" r="1.5"/><circle cx="1000" cy="80" r="1.5"/><circle cx="1100" cy="80" r="1.5"/>
+    <circle cx="900" cy="150" r="1.5"/><circle cx="1000" cy="150" r="1.5"/><circle cx="1100" cy="150" r="1.5"/>
+    <circle cx="900" cy="220" r="1.5"/><circle cx="1000" cy="220" r="1.5"/><circle cx="1100" cy="220" r="1.5"/>
+  </g>
+  <g stroke="url(#lineGrad)" stroke-width="2" fill="none">
+    <line x1="0" y1="60" x2="420" y2="60"><animate attributeName="stroke-dasharray" from="0 200" to="200 0" dur="2.4s" repeatCount="indefinite"/><animate attributeName="opacity" values="0;1;0" dur="2.4s" repeatCount="indefinite"/></line>
+    <line x1="0" y1="150" x2="380" y2="150"><animate attributeName="stroke-dasharray" from="0 200" to="200 0" dur="3s" begin="0.4s" repeatCount="indefinite"/><animate attributeName="opacity" values="0;1;0" dur="3s" begin="0.4s" repeatCount="indefinite"/></line>
+    <line x1="0" y1="240" x2="440" y2="240"><animate attributeName="stroke-dasharray" from="0 200" to="200 0" dur="2.6s" begin="0.8s" repeatCount="indefinite"/><animate attributeName="opacity" values="0;1;0" dur="2.6s" begin="0.8s" repeatCount="indefinite"/></line>
+    <line x1="780" y1="60" x2="1200" y2="60"><animate attributeName="stroke-dasharray" from="200 0" to="0 200" dur="2.8s" begin="0.2s" repeatCount="indefinite"/><animate attributeName="opacity" values="0;1;0" dur="2.8s" begin="0.2s" repeatCount="indefinite"/></line>
+    <line x1="820" y1="150" x2="1200" y2="150"><animate attributeName="stroke-dasharray" from="200 0" to="0 200" dur="3.2s" begin="0.6s" repeatCount="indefinite"/><animate attributeName="opacity" values="0;1;0" dur="3.2s" begin="0.6s" repeatCount="indefinite"/></line>
+    <line x1="760" y1="240" x2="1200" y2="240"><animate attributeName="stroke-dasharray" from="200 0" to="0 200" dur="2.5s" begin="1s" repeatCount="indefinite"/><animate attributeName="opacity" values="0;1;0" dur="2.5s" begin="1s" repeatCount="indefinite"/></line>
+  </g>
+  <text x="600" y="135" text-anchor="middle" font-family="'Segoe UI', Arial, sans-serif" font-size="128" font-weight="800" letter-spacing="6" fill="url(#titleGrad)" filter="url(#bigGlow)">AETHER</text>
+  <g filter="url(#glow)">
+    <circle cx="580" cy="205" r="6" fill="#22d3ee"><animate attributeName="r" values="4;10;4" dur="2s" repeatCount="indefinite"/><animate attributeName="opacity" values="1;0.3;1" dur="2s" repeatCount="indefinite"/></circle>
+  </g>
+  <g filter="url(#glow)">
+    <circle cx="620" cy="205" r="6" fill="#a78bfa"><animate attributeName="r" values="4;10;4" dur="2s" begin="0.6s" repeatCount="indefinite"/><animate attributeName="opacity" values="1;0.3;1" dur="2s" begin="0.6s" repeatCount="indefinite"/></circle>
+  </g>
+  <g filter="url(#glow)">
+    <circle cx="660" cy="205" r="6" fill="#f0abfc"><animate attributeName="r" values="4;10;4" dur="2s" begin="1.2s" repeatCount="indefinite"/><animate attributeName="opacity" values="1;0.3;1" dur="2s" begin="1.2s" repeatCount="indefinite"/></circle>
+  </g>
+  <text x="600" y="270" text-anchor="middle" font-family="'Segoe UI', Arial, sans-serif" font-size="18" font-weight="400" letter-spacing="3" fill="#94a3b8">free · unlimited · multi-provider LLM CLI</text>
+</svg>

package/assets/aether-router.svg

@@ -0,0 +1,129 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 280" width="1200" height="280">
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="#0a0e1a"/>
+      <stop offset="50%" stop-color="#0f1525"/>
+      <stop offset="100%" stop-color="#0a0e1a"/>
+    </linearGradient>
+    <linearGradient id="titleGrad" x1="0" y1="0" x2="1" y2="0">
+      <stop offset="0%" stop-color="#7dd3fc"/>
+      <stop offset="50%" stop-color="#a78bfa"/>
+      <stop offset="100%" stop-color="#f0abfc"/>
+    </linearGradient>
+    <linearGradient id="greenArrow" x1="0" y1="0" x2="1" y2="0">
+      <stop offset="0%" stop-color="#22d3ee" stop-opacity="0"/>
+      <stop offset="50%" stop-color="#4ade80" stop-opacity="1"/>
+      <stop offset="100%" stop-color="#22d3ee" stop-opacity="0"/>
+    </linearGradient>
+    <filter id="glow" x="-50%" y="-50%" width="200%" height="200%">
+      <feGaussianBlur stdDeviation="3" result="b"/>
+      <feMerge>
+        <feMergeNode in="b"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+    <filter id="routerGlow" x="-100%" y="-100%" width="300%" height="300%">
+      <feGaussianBlur stdDeviation="6" result="b"/>
+      <feMerge>
+        <feMergeNode in="b"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+  </defs>
+  <rect width="1200" height="280" fill="url(#bg)"/>
+  <g fill="#1e293b">
+    <circle cx="60" cy="60" r="1.5"/><circle cx="140" cy="60" r="1.5"/><circle cx="220" cy="60" r="1.5"/>
+    <circle cx="60" cy="140" r="1.5"/><circle cx="140" cy="140" r="1.5"/><circle cx="220" cy="140" r="1.5"/>
+    <circle cx="60" cy="220" r="1.5"/><circle cx="140" cy="220" r="1.5"/><circle cx="220" cy="220" r="1.5"/>
+    <circle cx="980" cy="60" r="1.5"/><circle cx="1060" cy="60" r="1.5"/><circle cx="1140" cy="60" r="1.5"/>
+    <circle cx="980" cy="140" r="1.5"/><circle cx="1060" cy="140" r="1.5"/><circle cx="1140" cy="140" r="1.5"/>
+    <circle cx="980" cy="220" r="1.5"/><circle cx="1060" cy="220" r="1.5"/><circle cx="1140" cy="220" r="1.5"/>
+  </g>
+
+  <!-- title -->
+  <text x="600" y="32" text-anchor="middle" font-family="'Segoe UI', Arial, sans-serif" font-size="17" font-weight="700" letter-spacing="2" fill="url(#titleGrad)">Multi-Provider Routing with Automatic Failover</text>
+
+  <!-- provider nodes -->
+  <g>
+    <rect x="40" y="60" width="90" height="34" rx="8" fill="#0f172a" stroke="#334155" stroke-width="1.5"/>
+    <text x="85" y="81" text-anchor="middle" font-family="'Segoe UI', Arial, sans-serif" font-size="11" font-weight="600" fill="#94a3b8">Ollama</text>
+  </g>
+  <g>
+    <rect x="40" y="123" width="90" height="34" rx="8" fill="#0f172a" stroke="#334155" stroke-width="1.5"/>
+    <text x="85" y="144" text-anchor="middle" font-family="'Segoe UI', Arial, sans-serif" font-size="11" font-weight="600" fill="#94a3b8">OpenRouter</text>
+  </g>
+  <g>
+    <rect x="40" y="186" width="90" height="34" rx="8" fill="#0f172a" stroke="#334155" stroke-width="1.5"/>
+    <text x="85" y="207" text-anchor="middle" font-family="'Segoe UI', Arial, sans-serif" font-size="11" font-weight="600" fill="#94a3b8">Groq</text>
+  </g>
+  <g>
+    <rect x="1070" y="60" width="90" height="34" rx="8" fill="#0f172a" stroke="#334155" stroke-width="1.5"/>
+    <text x="1115" y="81" text-anchor="middle" font-family="'Segoe UI', Arial, sans-serif" font-size="11" font-weight="600" fill="#94a3b8">Mistral</text>
+  </g>
+  <g>
+    <rect x="1070" y="123" width="90" height="34" rx="8" fill="#0f172a" stroke="#334155" stroke-width="1.5"/>
+    <text x="1115" y="144" text-anchor="middle" font-family="'Segoe UI', Arial, sans-serif" font-size="11" font-weight="600" fill="#94a3b8">Together</text>
+  </g>
+
+  <!-- arrows from providers INTO router -->
+  <g stroke="url(#greenArrow)" stroke-width="2.5" fill="none">
+    <line x1="130" y1="77" x2="530" y2="140">
+      <animate attributeName="stroke-dasharray" from="0 500" to="500 0" dur="2.2s" repeatCount="indefinite"/>
+      <animate attributeName="opacity" values="0;1;0" dur="2.2s" repeatCount="indefinite"/>
+    </line>
+    <line x1="130" y1="140" x2="530" y2="140">
+      <animate attributeName="stroke-dasharray" from="0 500" to="500 0" dur="2.6s" begin="0.3s" repeatCount="indefinite"/>
+      <animate attributeName="opacity" values="0;1;0" dur="2.6s" begin="0.3s" repeatCount="indefinite"/>
+    </line>
+    <line x1="130" y1="203" x2="530" y2="140">
+      <animate attributeName="stroke-dasharray" from="0 500" to="500 0" dur="2.4s" begin="0.6s" repeatCount="indefinite"/>
+      <animate attributeName="opacity" values="0;1;0" dur="2.4s" begin="0.6s" repeatCount="indefinite"/>
+    </line>
+    <line x1="1070" y1="77" x2="670" y2="140">
+      <animate attributeName="stroke-dasharray" from="500 0" to="0 500" dur="2.3s" begin="0.2s" repeatCount="indefinite"/>
+      <animate attributeName="opacity" values="0;1;0" dur="2.3s" begin="0.2s" repeatCount="indefinite"/>
+    </line>
+    <line x1="1070" y1="140" x2="670" y2="140">
+      <animate attributeName="stroke-dasharray" from="500 0" to="0 500" dur="2.7s" begin="0.5s" repeatCount="indefinite"/>
+      <animate attributeName="opacity" values="0;1;0" dur="2.7s" begin="0.5s" repeatCount="indefinite"/>
+    </line>
+  </g>
+
+  <!-- arrowhead markers -->
+  <defs>
+    <marker id="arrowIn" markerWidth="8" markerHeight="8" refX="7" refY="4" orient="auto">
+      <path d="M0,0 L7,4 L0,8 Z" fill="#4ade80"/>
+    </marker>
+    <marker id="arrowOut" markerWidth="8" markerHeight="8" refX="7" refY="4" orient="auto">
+      <path d="M0,0 L7,4 L0,8 Z" fill="#fbbf24"/>
+    </marker>
+  </defs>
+
+  <!-- router -->
+  <g filter="url(#routerGlow)">
+    <rect x="530" y="108" width="140" height="64" rx="14" fill="#0f172a" stroke="#4ade80" stroke-width="2"/>
+    <text x="600" y="134" text-anchor="middle" font-family="'Segoe UI', Arial, sans-serif" font-size="15" font-weight="700" fill="#4ade80">ROUTER</text>
+    <text x="600" y="152" text-anchor="middle" font-family="'Segoe UI', Arial, sans-serif" font-size="9" font-weight="500" fill="#64748b">auto-failover</text>
+  </g>
+
+  <!-- circuit breaker pulse -->
+  <g filter="url(#glow)">
+    <circle cx="600" cy="175" r="4" fill="#fbbf24">
+      <animate attributeName="r" values="3;8;3" dur="1.6s" repeatCount="indefinite"/>
+      <animate attributeName="opacity" values="1;0.2;1" dur="1.6s" repeatCount="indefinite"/>
+    </circle>
+  </g>
+
+  <!-- router OUT to CLI -->
+  <g>
+    <line x1="670" y1="140" x2="1050" y2="203" stroke="#fbbf24" stroke-width="2.5" fill="none" marker-end="url(#arrowOut)">
+      <animate attributeName="stroke-dasharray" from="0 500" to="500 0" dur="2s" begin="0.8s" repeatCount="indefinite"/>
+      <animate attributeName="opacity" values="0;1;0" dur="2s" begin="0.8s" repeatCount="indefinite"/>
+    </line>
+  </g>
+  <g>
+    <rect x="1050" y="186" width="110" height="34" rx="8" fill="#0f172a" stroke="#fbbf24" stroke-width="1.5"/>
+    <text x="1105" y="207" text-anchor="middle" font-family="'Segoe UI', Arial, sans-serif" font-size="11" font-weight="700" fill="#fbbf24">CLI</text>
+  </g>
+</svg>

package/dist/agent.js

@@ -0,0 +1,125 @@
+const DEFAULT_MAX_STEPS = 15;
+// Best-effort repair of tool-call arguments. Some models emit non-JSON strings
+// (e.g. `@{path=foo; content=bar}`); others pass an already-parsed object.
+// Handle both so tools always receive a proper args object.
+function parseToolArgs(raw) {
+    if (raw && typeof raw === "object" && !Array.isArray(raw))
+        return raw;
+    if (typeof raw !== "string")
+        return {};
+    const str = raw.trim();
+    if (!str)
+        return {};
+    try {
+        const parsed = JSON.parse(str);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed))
+            return parsed;
+    }
+    catch {
+        // fall through to repair
+    }
+    const args = {};
+    const re = /([A-Za-z_][\w.-]*)\s*=\s*(?:"((?:[^"\\]|\\.)*)"|'((?:[^'\\]|\\.)*)'|([^;}\s,]+))/g;
+    let m;
+    while ((m = re.exec(str)) !== null) {
+        const key = m[1];
+        const val = m[2] ?? m[3] ?? m[4];
+        if (key !== undefined && val !== undefined)
+            args[key] = val;
+    }
+    return args;
+}
+const SYSTEM_PROMPT = `You are an expert AI software engineer with the ability to read, write, edit files, list directories, run shell commands, search the web, and describe images.
+
+WORKFLOW:
+1. Explore first: use ListDir to understand the project structure, then ReadFile to inspect relevant files.
+2. Implement: use WriteFile (for new files) or EditFile (for targeted changes). Write clean, production-quality code.
+3. Verify: use Bash to run tests, typecheck, or lint after making changes.
+4. Never guess file contents - always read before editing.
+
+STYLE:
+- Be concise and direct. Do not narrate your actions excessively.
+- Make changes in the smallest, most targeted way possible.
+- Only use tools when needed; do not call tools unnecessarily.
+- When a task is complete, summarize what was done in 1-2 sentences.
+- If a tool fails, read the error and retry with a fix.
+
+TRUSTWORTHY TOOL RESULTS:
+- When a tool returns output, treat the tool output as the ground truth. Quote or reference the actual tool output verbatim rather than summarizing it from memory.
+- If a tool returned no matches or an empty result, say exactly that ("no matches found") and show the tool output verbatim - never invent files, line numbers, counts, or facts that the tool did not report.
+- Do not assume a tool succeeded if its output contains an ERROR: prefix; report the error to the user.
+- When counting or summarizing tool output (e.g. "how many files"), base your answer strictly on the returned lines and say how you derived it.`;
+export class Agent {
+    router;
+    registry;
+    maxSteps;
+    systemPrompt;
+    memory;
+    modeManager;
+    lastMessages = [];
+    constructor(router, registry, opts) {
+        this.router = router;
+        this.registry = registry;
+        this.maxSteps = opts?.maxSteps ?? DEFAULT_MAX_STEPS;
+        this.systemPrompt = opts?.systemPrompt ?? SYSTEM_PROMPT;
+        this.memory = opts?.memory;
+        this.modeManager = opts?.modeManager;
+    }
+    setMode(name) {
+        if (!this.modeManager)
+            throw new Error("Agent has no ModeManager");
+        this.modeManager.setMode(name);
+    }
+    getMode() {
+        return this.modeManager?.getMode() ?? "normal";
+    }
+    getActiveTools() {
+        if (!this.modeManager)
+            return this.registry.list().map((d) => d.name);
+        return this.modeManager.allowedTools();
+    }
+    async *run(userMessage, history) {
+        const systemMsg = { role: "system", content: this.systemPrompt };
+        this.lastMessages = [systemMsg, ...history, { role: "user", content: userMessage }];
+        for (let step = 0; step < this.maxSteps; step++) {
+            const tools = this.registry.list();
+            let assistantText = "";
+            const toolCalls = [];
+            for await (const chunk of this.router.chat(this.lastMessages, tools, {
+                temperature: 0.7,
+                maxTokens: 4096,
+            })) {
+                if (chunk.type === "text" && chunk.text) {
+                    assistantText += chunk.text;
+                }
+                if (chunk.type === "tool_call" && chunk.tool_call) {
+                    toolCalls.push(chunk.tool_call);
+                }
+                yield chunk;
+            }
+            const assistantMsg = {
+                role: "assistant",
+                content: assistantText,
+                tool_calls: toolCalls.length ? toolCalls : undefined,
+            };
+            this.lastMessages.push(assistantMsg);
+            if (toolCalls.length === 0) {
+                return;
+            }
+            for (const tc of toolCalls) {
+                const parsed = parseToolArgs(tc.function.arguments);
+                const result = await this.registry.executeTool(tc.function.name, parsed);
+                this.lastMessages.push({
+                    role: "tool",
+                    tool_call_id: tc.id,
+                    name: tc.function.name,
+                    content: result,
+                });
+            }
+        }
+        this.lastMessages.push({
+            role: "assistant",
+            content: "\n\n[Reached maximum steps. Stopping.]",
+        });
+    }
+}