aether-code 0.12.0 → 0.13.0

package/package.json

@@ -1,68 +1,69 @@
-{
-  "name": "aether-code",
-  "version": "0.12.0",
-  "description": "Uncensored AI coding agent for your terminal — Claude Code alternative with MCP support. Reads code, writes files, runs commands. Drives IDA Pro, Roblox Studio, Wireshark, Blender, and any MCP server. No refusal layer.",
-  "homepage": "https://trynoguard.com",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/dannyphantomx64/aether-code"
-  },
-  "license": "MIT",
-  "type": "module",
-  "bin": {
-    "aether": "bin/aether-code.js"
-  },
-  "files": [
-    "bin",
-    "src",
-    "skills",
-    "README.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "scripts": {
-    "lint": "node --check bin/aether-code.js src/agent.js src/api.js src/config.js src/render.js src/tools.js src/diff.js src/repl.js src/mcp.js src/mcp-cli.js src/mcp-registry.js src/skills.js",
-    "test": "node --test \"test/**/*.test.js\""
-  },
-  "keywords": [
-    "aether",
-    "ai",
-    "ai-agent",
-    "ai-cli",
-    "ai-coding-assistant",
-    "ai-coding-agent",
-    "ai-pair-programmer",
-    "agent",
-    "agentic",
-    "agentic-ai",
-    "cli",
-    "claude-code",
-    "claude-code-alternative",
-    "cursor-alternative",
-    "coding-agent",
-    "code-generation",
-    "developer-tools",
-    "llm",
-    "llm-agent",
-    "llm-tools",
-    "mcp",
-    "mcp-client",
-    "model-context-protocol",
-    "modelcontextprotocol",
-    "ida-pro",
-    "reverse-engineering",
-    "roblox",
-    "uncensored",
-    "uncensored-ai",
-    "uncensored-llm",
-    "terminal",
-    "tool-use",
-    "tool-calling",
-    "trynoguard"
-  ],
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0"
-  }
-}
+{
+  "name": "aether-code",
+  "version": "0.13.0",
+  "description": "Uncensored AI coding agent for your terminal — Claude Code alternative with MCP support. Reads code, writes files, runs commands. Drives IDA Pro, Roblox Studio, Wireshark, Blender, and any MCP server. No refusal layer.",
+  "homepage": "https://trynoguard.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dannyphantomx64/aether-code"
+  },
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "aether": "bin/aether-code.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "skills",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "lint": "node --check bin/aether-code.js src/agent.js src/api.js src/config.js src/render.js src/tools.js src/diff.js src/repl.js src/mcp.js src/mcp-cli.js src/mcp-registry.js src/skills.js",
+    "test": "node --test \"test/**/*.test.js\"",
+    "prepublishOnly": "npm run lint && npm test"
+  },
+  "keywords": [
+    "aether",
+    "ai",
+    "ai-agent",
+    "ai-cli",
+    "ai-coding-assistant",
+    "ai-coding-agent",
+    "ai-pair-programmer",
+    "agent",
+    "agentic",
+    "agentic-ai",
+    "cli",
+    "claude-code",
+    "claude-code-alternative",
+    "cursor-alternative",
+    "coding-agent",
+    "code-generation",
+    "developer-tools",
+    "llm",
+    "llm-agent",
+    "llm-tools",
+    "mcp",
+    "mcp-client",
+    "model-context-protocol",
+    "modelcontextprotocol",
+    "ida-pro",
+    "reverse-engineering",
+    "roblox",
+    "uncensored",
+    "uncensored-ai",
+    "uncensored-llm",
+    "terminal",
+    "tool-use",
+    "tool-calling",
+    "trynoguard"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0"
+  }
+}

package/src/agent.js

@@ -1,197 +1,197 @@
-// Agent loop. Streams each turn from /api/v1/agent/stream, prints text deltas
-// in real-time, executes any tool calls, loops until the model returns no
-// tool calls (task done) or max-turns is reached.
-
-import { agentTurnStream, AetherError } from "./api.js";
-import { TOOL_DEFINITIONS, executeTool } from "./tools.js";
-import { unnamespaceToolName } from "./mcp.js";
-import { loadAllSkills, selectSkills, renderSkillsBlock } from "./skills.js";
-import { c, divider, turn, toolHeader, toolResult, errorLine } from "./render.js";
-
-const DEFAULT_MAX_TURNS = 25;
-
-export async function runAgent({
-  initialPrompt,
-  priorMessages,
-  cwd,
-  autoYes = false,
-  unsafePaths = false,
-  maxTurns = DEFAULT_MAX_TURNS,
-  onTokens = () => {},
-  // Optional MCPManager. When provided, its tools are merged into the agent's
-  // toolset and tool calls prefixed `mcp__` are routed to it instead of the
-  // built-in executeTool.
-  mcpManager = null,
-}) {
-  // Merge built-in tools with MCP-provided tools. MCP tools come second so
-  // any name collision (unlikely given namespacing, but defense in depth)
-  // resolves to the built-in.
-  const tools = mcpManager
-    ? [...TOOL_DEFINITIONS, ...mcpManager.getToolDefinitions()]
-    : TOOL_DEFINITIONS;
-
-  // Load skills once per runAgent call (bundled + user-installed). They
-  // get selected per-turn against the current prompt + any file paths the
-  // model has read so far. Loading errors are non-fatal — a bad skill file
-  // shouldn't kill the agent.
-  let allSkills = [];
-  try {
-    allSkills = loadAllSkills();
-  } catch (e) {
-    process.stderr.write(c.yellow(`(skill load failed: ${e.message})\n`));
-  }
-  const referencedPaths = [];
-  // Two callers: one-shot (initialPrompt only, fresh conversation) and REPL
-  // (priorMessages + initialPrompt to continue an ongoing chat).
-  const messages = priorMessages
-    ? [...priorMessages, { role: "user", content: initialPrompt }]
-    : [{ role: "user", content: initialPrompt }];
-  let totalCredits = 0;
-  let totalIn = 0;
-  let totalOut = 0;
-  let lastBalance = null;
-
-  for (let i = 0; i < maxTurns; i++) {
-    process.stdout.write("\n" + turn(i + 1) + "\n");
-
-    // Stream the assistant's response. Print text deltas as they arrive,
-    // along with tool-call announcements as soon as the model commits to
-    // calling a particular tool (i.e. the `name` arrives in the stream).
-    const announced = new Set();
-    let lastWasText = false;
-
-    // Select skills for this turn against the current user prompt + any
-    // paths the model has read so far. Prepend the matching skills' bodies
-    // to the last user message of a shallow-cloned messages array — we
-    // don't want skill text accumulating in the persisted history, only
-    // being available to the model for the turn where it's relevant.
-    const turnMessages = buildTurnMessages(messages, allSkills, referencedPaths);
-
-    let res;
-    try {
-      res = await agentTurnStream({
-        messages: turnMessages,
-        tools,
-        onDelta: (text) => {
-          if (!lastWasText) {
-            process.stdout.write("  ");
-            lastWasText = true;
-          }
-          process.stdout.write(text);
-        },
-        onToolCallDelta: (delta) => {
-          // Print the tool header once we know the name (first chunk for that index)
-          if (delta.name && !announced.has(delta.index)) {
-            announced.add(delta.index);
-            if (lastWasText) process.stdout.write("\n");
-            lastWasText = false;
-            process.stdout.write(c.cyan(c.bold(delta.name)) + c.gray("(...)") + c.gray(" preparing args\n"));
-          }
-        },
-      });
-    } catch (err) {
-      if (err instanceof AetherError) {
-        return { ok: false, error: err, totalCredits, totalIn, totalOut, balance: lastBalance, messages };
-      }
-      throw err;
-    }
-
-    // End-of-turn newline + cost meter
-    if (lastWasText) process.stdout.write("\n");
-    totalCredits += res.creditsCharged ?? 0;
-    totalIn += res.usage?.prompt_tokens ?? 0;
-    totalOut += res.usage?.completion_tokens ?? 0;
-    if (typeof res.balanceAfter === "number") lastBalance = res.balanceAfter;
-    onTokens({ totalCredits, totalIn, totalOut, balance: lastBalance });
-    process.stdout.write(
-      c.dim(`  ${res.creditsCharged ?? 0} cr · ${res.usage?.prompt_tokens ?? 0}→${res.usage?.completion_tokens ?? 0} tokens · finish: ${res.finish_reason}\n`),
-    );
-
-    // Push assistant message into history
-    messages.push({
-      role: "assistant",
-      content: res.message.content,
-      tool_calls: res.message.tool_calls,
-    });
-
-    const toolCalls = res.message.tool_calls ?? [];
-    if (toolCalls.length === 0) {
-      return { ok: true, totalCredits, totalIn, totalOut, turns: i + 1, balance: lastBalance, messages };
-    }
-
-    // Execute each tool call. Show the actual args (now that we have them
-    // fully assembled) and run.
-    for (const call of toolCalls) {
-      let args = {};
-      try { args = JSON.parse(call.function.arguments || "{}"); } catch { /* leave empty */ }
-      console.log("");
-      console.log(toolHeader(call.function.name, args));
-
-      // Route to MCP if the tool name is namespaced (mcp__server__tool);
-      // otherwise execute the built-in tool. unnamespaceToolName returns
-      // null for non-MCP names, which is our cheap dispatch test.
-      let result;
-      if (mcpManager && unnamespaceToolName(call.function.name)) {
-        result = await mcpManager.callTool(call.function.name, args);
-      } else {
-        result = await executeTool(call, { cwd, autoYes, unsafePaths });
-      }
-
-      // Track paths the model has touched. Skills with path-pattern triggers
-      // (e.g. RE skill on `*.exe`) match against this list, so reading a
-      // binary in turn 3 can activate the RE skill in turn 4.
-      if (call.function.name === "read_file" || call.function.name === "edit_file" || call.function.name === "write_file") {
-        if (typeof args.path === "string") referencedPaths.push(args.path);
-      }
-      if (result.output) {
-        const preview = result.output.length > 800 ? result.output.slice(0, 800) + "\n…(truncated)" : result.output;
-        console.log(toolResult(preview, result.ok));
-      }
-
-      messages.push({
-        role: "tool",
-        tool_call_id: call.id,
-        content: result.output ?? (result.ok ? "(no output)" : "Failed."),
-      });
-    }
-  }
-
-  console.log(c.yellow(`\nReached max turns (${maxTurns}). Stopping.`));
-  return { ok: false, error: new Error("Max turns reached"), totalCredits, totalIn, totalOut, balance: lastBalance, messages };
-}
-
-/**
- * Per-turn skill injection. Selects skills against the latest user message
- * + paths the model has touched, then prepends matching bodies onto the
- * final user message of a shallow-cloned messages array. Returns the
- * original array unchanged when no skills match — zero overhead on the
- * no-skills path.
- *
- * Why prepend to user message instead of inserting a system message:
- * the server's AGENT_SYSTEM check skips its own system prompt when ANY
- * system message is present in the request. Adding a skills system
- * message would silently delete the server's discipline — which is
- * worse than no skills at all. Prepending into the user message keeps
- * both layers active.
- */
-function buildTurnMessages(messages, allSkills, referencedPaths) {
-  if (allSkills.length === 0) return messages;
-  // Find the latest user message — that's where the current task lives.
-  let lastUserIdx = -1;
-  for (let i = messages.length - 1; i >= 0; i--) {
-    if (messages[i].role === "user") { lastUserIdx = i; break; }
-  }
-  if (lastUserIdx === -1) return messages;
-  const prompt = typeof messages[lastUserIdx].content === "string"
-    ? messages[lastUserIdx].content
-    : "";
-  const active = selectSkills({ skills: allSkills, prompt, referencedPaths });
-  if (active.length === 0) return messages;
-  const block = renderSkillsBlock(active);
-  const cloned = [...messages];
-  cloned[lastUserIdx] = {
-    ...cloned[lastUserIdx],
-    content: `${block}\n\n---\n\n${prompt}`,
-  };
-  return cloned;
-}
+// Agent loop. Streams each turn from /api/v1/agent/stream, prints text deltas
+// in real-time, executes any tool calls, loops until the model returns no
+// tool calls (task done) or max-turns is reached.
+
+import { agentTurnStream, AetherError } from "./api.js";
+import { TOOL_DEFINITIONS, executeTool } from "./tools.js";
+import { unnamespaceToolName } from "./mcp.js";
+import { loadAllSkills, selectSkills, renderSkillsBlock } from "./skills.js";
+import { c, divider, turn, toolHeader, toolResult, errorLine } from "./render.js";
+
+const DEFAULT_MAX_TURNS = 25;
+
+export async function runAgent({
+  initialPrompt,
+  priorMessages,
+  cwd,
+  autoYes = false,
+  unsafePaths = false,
+  maxTurns = DEFAULT_MAX_TURNS,
+  onTokens = () => {},
+  // Optional MCPManager. When provided, its tools are merged into the agent's
+  // toolset and tool calls prefixed `mcp__` are routed to it instead of the
+  // built-in executeTool.
+  mcpManager = null,
+}) {
+  // Merge built-in tools with MCP-provided tools. MCP tools come second so
+  // any name collision (unlikely given namespacing, but defense in depth)
+  // resolves to the built-in.
+  const tools = mcpManager
+    ? [...TOOL_DEFINITIONS, ...mcpManager.getToolDefinitions()]
+    : TOOL_DEFINITIONS;
+
+  // Load skills once per runAgent call (bundled + user-installed). They
+  // get selected per-turn against the current prompt + any file paths the
+  // model has read so far. Loading errors are non-fatal — a bad skill file
+  // shouldn't kill the agent.
+  let allSkills = [];
+  try {
+    allSkills = loadAllSkills();
+  } catch (e) {
+    process.stderr.write(c.yellow(`(skill load failed: ${e.message})\n`));
+  }
+  const referencedPaths = [];
+  // Two callers: one-shot (initialPrompt only, fresh conversation) and REPL
+  // (priorMessages + initialPrompt to continue an ongoing chat).
+  const messages = priorMessages
+    ? [...priorMessages, { role: "user", content: initialPrompt }]
+    : [{ role: "user", content: initialPrompt }];
+  let totalCredits = 0;
+  let totalIn = 0;
+  let totalOut = 0;
+  let lastBalance = null;
+
+  for (let i = 0; i < maxTurns; i++) {
+    process.stdout.write("\n" + turn(i + 1) + "\n");
+
+    // Stream the assistant's response. Print text deltas as they arrive,
+    // along with tool-call announcements as soon as the model commits to
+    // calling a particular tool (i.e. the `name` arrives in the stream).
+    const announced = new Set();
+    let lastWasText = false;
+
+    // Select skills for this turn against the current user prompt + any
+    // paths the model has read so far. Prepend the matching skills' bodies
+    // to the last user message of a shallow-cloned messages array — we
+    // don't want skill text accumulating in the persisted history, only
+    // being available to the model for the turn where it's relevant.
+    const turnMessages = buildTurnMessages(messages, allSkills, referencedPaths);
+
+    let res;
+    try {
+      res = await agentTurnStream({
+        messages: turnMessages,
+        tools,
+        onDelta: (text) => {
+          if (!lastWasText) {
+            process.stdout.write("  ");
+            lastWasText = true;
+          }
+          process.stdout.write(text);
+        },
+        onToolCallDelta: (delta) => {
+          // Print the tool header once we know the name (first chunk for that index)
+          if (delta.name && !announced.has(delta.index)) {
+            announced.add(delta.index);
+            if (lastWasText) process.stdout.write("\n");
+            lastWasText = false;
+            process.stdout.write(c.cyan(c.bold(delta.name)) + c.gray("(...)") + c.gray(" preparing args\n"));
+          }
+        },
+      });
+    } catch (err) {
+      if (err instanceof AetherError) {
+        return { ok: false, error: err, totalCredits, totalIn, totalOut, balance: lastBalance, messages };
+      }
+      throw err;
+    }
+
+    // End-of-turn newline + cost meter
+    if (lastWasText) process.stdout.write("\n");
+    totalCredits += res.creditsCharged ?? 0;
+    totalIn += res.usage?.prompt_tokens ?? 0;
+    totalOut += res.usage?.completion_tokens ?? 0;
+    if (typeof res.balanceAfter === "number") lastBalance = res.balanceAfter;
+    onTokens({ totalCredits, totalIn, totalOut, balance: lastBalance });
+    process.stdout.write(
+      c.dim(`  ${res.creditsCharged ?? 0} cr · ${res.usage?.prompt_tokens ?? 0}→${res.usage?.completion_tokens ?? 0} tokens · finish: ${res.finish_reason}\n`),
+    );
+
+    // Push assistant message into history
+    messages.push({
+      role: "assistant",
+      content: res.message.content,
+      tool_calls: res.message.tool_calls,
+    });
+
+    const toolCalls = res.message.tool_calls ?? [];
+    if (toolCalls.length === 0) {
+      return { ok: true, totalCredits, totalIn, totalOut, turns: i + 1, balance: lastBalance, messages };
+    }
+
+    // Execute each tool call. Show the actual args (now that we have them
+    // fully assembled) and run.
+    for (const call of toolCalls) {
+      let args = {};
+      try { args = JSON.parse(call.function.arguments || "{}"); } catch { /* leave empty */ }
+      console.log("");
+      console.log(toolHeader(call.function.name, args));
+
+      // Route to MCP if the tool name is namespaced (mcp__server__tool);
+      // otherwise execute the built-in tool. unnamespaceToolName returns
+      // null for non-MCP names, which is our cheap dispatch test.
+      let result;
+      if (mcpManager && unnamespaceToolName(call.function.name)) {
+        result = await mcpManager.callTool(call.function.name, args);
+      } else {
+        result = await executeTool(call, { cwd, autoYes, unsafePaths });
+      }
+
+      // Track paths the model has touched. Skills with path-pattern triggers
+      // (e.g. RE skill on `*.exe`) match against this list, so reading a
+      // binary in turn 3 can activate the RE skill in turn 4.
+      if (call.function.name === "read_file" || call.function.name === "edit_file" || call.function.name === "write_file") {
+        if (typeof args.path === "string") referencedPaths.push(args.path);
+      }
+      if (result.output) {
+        const preview = result.output.length > 800 ? result.output.slice(0, 800) + "\n…(truncated)" : result.output;
+        console.log(toolResult(preview, result.ok));
+      }
+
+      messages.push({
+        role: "tool",
+        tool_call_id: call.id,
+        content: result.output ?? (result.ok ? "(no output)" : "Failed."),
+      });
+    }
+  }
+
+  console.log(c.yellow(`\nReached max turns (${maxTurns}). Stopping.`));
+  return { ok: false, error: new Error("Max turns reached"), totalCredits, totalIn, totalOut, balance: lastBalance, messages };
+}
+
+/**
+ * Per-turn skill injection. Selects skills against the latest user message
+ * + paths the model has touched, then prepends matching bodies onto the
+ * final user message of a shallow-cloned messages array. Returns the
+ * original array unchanged when no skills match — zero overhead on the
+ * no-skills path.
+ *
+ * Why prepend to user message instead of inserting a system message:
+ * the server's AGENT_SYSTEM check skips its own system prompt when ANY
+ * system message is present in the request. Adding a skills system
+ * message would silently delete the server's discipline — which is
+ * worse than no skills at all. Prepending into the user message keeps
+ * both layers active.
+ */
+function buildTurnMessages(messages, allSkills, referencedPaths) {
+  if (allSkills.length === 0) return messages;
+  // Find the latest user message — that's where the current task lives.
+  let lastUserIdx = -1;
+  for (let i = messages.length - 1; i >= 0; i--) {
+    if (messages[i].role === "user") { lastUserIdx = i; break; }
+  }
+  if (lastUserIdx === -1) return messages;
+  const prompt = typeof messages[lastUserIdx].content === "string"
+    ? messages[lastUserIdx].content
+    : "";
+  const active = selectSkills({ skills: allSkills, prompt, referencedPaths });
+  if (active.length === 0) return messages;
+  const block = renderSkillsBlock(active);
+  const cloned = [...messages];
+  cloned[lastUserIdx] = {
+    ...cloned[lastUserIdx],
+    content: `${block}\n\n---\n\n${prompt}`,
+  };
+  return cloned;
+}