arki 0.0.3 → 0.0.4

package/README.md

@@ -1,3 +1,5 @@
+> **⚠️ Warning: This project is under active development. Please do not use it in production environments.**
+
 # Arki - AI Agent Programming Assistant
 
 Arki is an AI agent programming tool.
@@ -43,6 +45,7 @@ arki [options]
 Options:
   -p <path>      Specify working directory
   --debug, -d    Enable debug mode, show detailed logs
+  --reset        Reset configuration to factory defaults
   --help, -h     Show help information
 ```
 
@@ -81,39 +84,13 @@ Ways to enable:
 
 Configuration file is located at `~/.config/arki/config.json`:
 
-```json
-{
-  "agents": {
-    "main": {
-      "model": "gpt-5.1",
-      "flex": false,
-      "reasoningEffort": "medium"
-    },
-    "coder": {
-      "model": "gpt-5.2",
-      "flex": false,
-      "reasoningEffort": "high"
-    }
-  }
-}
-```
-
-Each Agent configuration:
-- `model` - Model ID to use
-- `flex` - Use Flex API (low priority, low cost)
-- `reasoningEffort` - Reasoning effort, optional values: `low`, `medium`, `high` (for models that support thinking mode)
-
-Default configuration is automatically copied from the package on first run.
+### Reset to Factory Defaults
 
-## Built-in Tools
-
-Arki includes the following built-in tools that the AI assistant can automatically call:
+```bash
+arki --reset
+```
 
-- `read_file` - Read file content
-- `write_file` - Write to file
-- `list_directory` - List directory contents
-- `run_command` - Execute shell commands
-- `get_tool_info` - View detailed usage instructions for tools
+This will delete the current configuration file. The default configuration will be used on next startup.
 
 ## Development
 

package/dist/index.d.ts

@@ -39,31 +39,44 @@ declare class AIMsg extends Msg {
     readonly type = MsgType.AI;
     constructor(content: string);
 }
+/**
+ * Single tool call
+ */
+interface ToolCall {
+    name: string;
+    arguments: Record<string, unknown>;
+}
 /**
  * Tool call message constructor
  */
 declare class ToolCallMsg extends Msg {
     readonly type = MsgType.ToolCall;
-    readonly toolCalls: Array<{
-        name: string;
-        arguments: Record<string, unknown>;
-    }>;
-    constructor(content: string, toolCalls: Array<{
-        name: string;
-        arguments: Record<string, unknown>;
-    }>);
+    readonly toolCalls: ToolCall[];
+    constructor(content: string, toolCalls: ToolCall[]);
+}
+/**
+ * Single tool result
+ */
+interface ToolResult {
+    toolName: string;
+    result: string;
+    isError?: boolean;
 }
 /**
- * Tool result message constructor
+ * Tool result message constructor (contains multiple results)
  */
 declare class ToolResultMsg extends Msg {
     readonly type = MsgType.ToolResult;
-    readonly toolName: string;
-    readonly result: string;
-    readonly isError?: boolean;
-    constructor(toolName: string, result: string, isError?: boolean);
+    readonly toolResults: ToolResult[];
+    constructor(toolResults: ToolResult[]);
+    /** Helper: create from single result */
+    static single(toolName: string, result: string, isError?: boolean): ToolResultMsg;
 }
 
+/**
+ * Symbol indicating tool has detailed manual (needs to call read_tool_manual before use)
+ */
+declare const HAS_MANUAL = "\uD83D\uDCD8";
 /**
  * Tool class
  */
@@ -88,6 +101,7 @@ declare class Tool {
      * Parse manual.md content
      * First line format: "tool_name: description", extract description
      * Remaining content is the manual
+     * If manual has content, prepend HAS_MANUAL symbol to description
      */
     static parseManual(content: string): {
         description: string;
@@ -96,7 +110,7 @@ declare class Tool {
     /**
      * Execute tool (with error handling and logging)
      */
-    run(args: Record<string, unknown>): Promise<ToolResultMsg>;
+    run(args: Record<string, unknown>): Promise<ToolResult>;
 }
 
 /**
@@ -353,4 +367,4 @@ interface Model {
     readonly capabilities: ModelCapabilities;
 }
 
-export { AIMsg, Adapter, type AdapterResponse, Agent, type AgentResponse, type ColorName, MAX_COMPLETION_TOKENS, MODELS, type Model, type ModelCapabilities, type ModelProvider, Msg, MsgType, OpenAIAdapter, type ReasoningEffort$1 as ReasoningEffort, SystemMsg, TEMPERATURE, TOOLS, Tool, ToolCallMsg, ToolResultMsg, UserMsg, adapter, colors, config, debug, error, info, init, isDebugMode, log, setDebugMode, setWorkingDir, success, warn, workingDir };
+export { AIMsg, Adapter, type AdapterResponse, Agent, type AgentResponse, type ColorName, HAS_MANUAL, MAX_COMPLETION_TOKENS, MODELS, type Model, type ModelCapabilities, type ModelProvider, Msg, MsgType, OpenAIAdapter, type ReasoningEffort$1 as ReasoningEffort, SystemMsg, TEMPERATURE, TOOLS, Tool, type ToolCall, ToolCallMsg, type ToolResult, ToolResultMsg, UserMsg, adapter, colors, config, debug, error, info, init, isDebugMode, log, setDebugMode, setWorkingDir, success, warn, workingDir };

package/dist/index.js

@@ -166,16 +166,16 @@ var ToolCallMsg = class extends Msg {
     this.toolCalls = toolCalls;
   }
 };
-var ToolResultMsg = class extends Msg {
+var ToolResultMsg = class _ToolResultMsg extends Msg {
   type = "tool_result" /* ToolResult */;
-  toolName;
-  result;
-  isError;
-  constructor(toolName, result, isError) {
+  toolResults;
+  constructor(toolResults) {
     super("");
-    this.toolName = toolName;
-    this.result = result;
-    this.isError = isError;
+    this.toolResults = toolResults;
+  }
+  /** Helper: create from single result */
+  static single(toolName, result, isError) {
+    return new _ToolResultMsg([{ toolName, result, isError }]);
   }
 };
 
@@ -272,11 +272,13 @@ var OpenAIAdapter = class extends Adapter {
         });
       } else if (msg.type === "tool_result" /* ToolResult */) {
         const toolResultMsg = msg;
-        result.push({
-          role: "tool",
-          tool_call_id: pendingIds.shift() || `call_${msg.timestamp}`,
-          content: toolResultMsg.isError ? `Error: ${toolResultMsg.result}` : toolResultMsg.result
-        });
+        for (const tr of toolResultMsg.toolResults) {
+          result.push({
+            role: "tool",
+            tool_call_id: pendingIds.shift() || `call_${msg.timestamp}`,
+            content: tr.isError ? `Error: ${tr.result}` : tr.result
+          });
+        }
       }
     }
     return result;
@@ -378,6 +380,7 @@ async function init(cwd) {
 }
 
 // src/tool/Tool.ts
+var HAS_MANUAL = "\u{1F4D8}";
 var Tool = class _Tool {
   name;
   description;
@@ -398,6 +401,7 @@ var Tool = class _Tool {
    * Parse manual.md content
    * First line format: "tool_name: description", extract description
    * Remaining content is the manual
+   * If manual has content, prepend HAS_MANUAL symbol to description
    */
   static parseManual(content) {
     const lines = content.split("\n");
@@ -408,6 +412,9 @@ var Tool = class _Tool {
       description = firstLine.slice(colonIndex + 1).trim();
     }
     const manual = lines.slice(1).join("\n").trim();
+    if (manual) {
+      description = `${HAS_MANUAL}${description}`;
+    }
     return { description, manual };
   }
   /**
@@ -421,15 +428,15 @@ var Tool = class _Tool {
       const elapsed = Date.now() - startTime;
       if (typeof result === "string") {
         debug("Tool", `Tool execution successful: ${this.name} (elapsed: ${elapsed}ms, result length: ${result.length})`);
-        return new ToolResultMsg(this.name, result);
+        return { toolName: this.name, result };
       }
       debug("Tool", `Tool execution completed: ${this.name} (elapsed: ${elapsed}ms, isError: ${result.isError || false})`);
-      return new ToolResultMsg(this.name, result.content, result.isError);
+      return { toolName: this.name, result: result.content, isError: result.isError };
     } catch (error2) {
       const elapsed = Date.now() - startTime;
       const errorMsg = error2 instanceof Error ? error2.message : String(error2);
       debug("Tool", `Tool execution failed: ${this.name} (elapsed: ${elapsed}ms)`, errorMsg);
-      return new ToolResultMsg(this.name, `Error: ${errorMsg}`, true);
+      return { toolName: this.name, result: `Error: ${errorMsg}`, isError: true };
     }
   }
 };
@@ -439,7 +446,7 @@ import * as fs2 from "fs/promises";
 import * as path2 from "path";
 
 // src/tool/read_file/manual.md
-var manual_default = "read_file: Read the content of a specified file\n\n## Parameters\n\n- `path` (string, required): File path\n";
+var manual_default = "read_file: Read the content of a specified file\n";
 
 // src/tool/read_file/index.ts
 TOOLS["read_file"] = new Tool({
@@ -468,7 +475,7 @@ import * as fs3 from "fs/promises";
 import * as path3 from "path";
 
 // src/tool/write_file/manual.md
-var manual_default2 = "write_file: Write content to a specified file, create the file if it doesn't exist\n\n## Parameters\n\n- `path` (string, required): File path\n- `content` (string, required): Content to write\n";
+var manual_default2 = "write_file: Write content to a specified file, create the file if it doesn't exist\n";
 
 // src/tool/write_file/index.ts
 TOOLS["write_file"] = new Tool({
@@ -501,7 +508,7 @@ import * as fs4 from "fs/promises";
 import * as path4 from "path";
 
 // src/tool/list_directory/manual.md
-var manual_default3 = "list_directory: List files and subdirectories in a specified directory\n\n## Parameters\n\n- `path` (string, optional): Directory path, defaults to current directory\n";
+var manual_default3 = "list_directory: List files and subdirectories in a specified directory\n";
 
 // src/tool/list_directory/index.ts
 TOOLS["list_directory"] = new Tool({
@@ -566,12 +573,12 @@ ${stderr}`;
   }
 });
 
-// src/tool/get_tool_info/manual.md
-var manual_default5 = "get_tool_info: View detailed usage instructions for a specified tool\n\n## Parameters\n\n- `tool_name` (string, required): Tool name to view\n\n";
+// src/tool/read_tool_manual/manual.md
+var manual_default5 = "read_tool_manual: View detailed usage instructions for a specified tool\n";
 
-// src/tool/get_tool_info/index.ts
-TOOLS["get_tool_info"] = new Tool({
-  name: "get_tool_info",
+// src/tool/read_tool_manual/index.ts
+TOOLS["read_tool_manual"] = new Tool({
+  name: "read_tool_manual",
   parameters: {
     tool_name: { type: "string", description: "Tool name to view" }
   },
@@ -686,11 +693,12 @@ var Agent = class {
       const toolCalls = toolCallMsg.toolCalls;
       debug("Agent", `Received tool call request`, toolCalls.map((tc) => tc.name));
       this.config.onToolCallMsg?.(toolCallMsg);
+      const toolResults = [];
       for (const tc of toolCalls) {
         this.config.onBeforeToolRun?.(tc.name, tc.arguments);
         debug("Agent", `Executing tool: ${tc.name}`, tc.arguments);
         const tool = TOOLS[tc.name];
-        const result = tool ? await tool.run(tc.arguments) : new ToolResultMsg(tc.name, `Unknown tool: ${tc.name}`, true);
+        const result = tool ? await tool.run(tc.arguments) : { toolName: tc.name, result: `Unknown tool: ${tc.name}`, isError: true };
         debug("Agent", `Tool execution completed: ${tc.name}`, {
           isError: result.isError,
           contentLength: result.result.length
@@ -701,8 +709,9 @@ var Agent = class {
           result: result.result
         });
         this.config.onToolResult?.(tc.name, tc.arguments, result.result);
-        this.messages.push(result);
+        toolResults.push(result);
       }
+      this.messages.push(new ToolResultMsg(toolResults));
     }
   }
   reset() {
@@ -711,7 +720,7 @@ var Agent = class {
   }
 };
 
-// src/agent/main/colors.ts
+// src/agent/Arki/colors.ts
 var tagNames = Object.keys(colors).filter((k) => k !== "reset").join("|");
 var tagRegex = new RegExp(`<(\\/?)(${tagNames})>`, "gi");
 function convertColorTags(str) {
@@ -740,19 +749,17 @@ function createColorConverter() {
   };
 }
 
-// src/agent/main/system.md
-var system_default = "You are Arki, a professional AI programming assistant. You work in the codebase directory `{{working_dir}}`.\n\n## Available Tools\n\n{{tools}}\n\nTools can be called multiple times at once. Make good use of this to improve efficiency.\nIf you need to understand the detailed usage of a tool, use the `get_tool_info` tool to view it.\n\n## Working Principles\n\n1. **Accuracy**: Before answering questions, use tools to view relevant code first. Don't base statements on assumptions. If you don't know something, just admit it - it's no big deal.\n2. **Safety**: Consider potential risks before executing commands.\n3. **Conciseness**: Keep answers brief and concise, avoid repetition and redundancy. Keep each response within 200 words unless the user requests detailed explanation.\n4. **Proactivity**: Actively suggest improvements when you find issues.\n\n## Response Style\n\n- Answer questions directly, avoid excessive pleasantries\n- Don't use emojis\n- Don't repeatedly ask about user needs, once is enough. Don't ask and answer yourself.\n\nThe user is talking to you via **CLI terminal**. **Do not** output Markdown. Use numbered lists for ordered lists, and \u2022 symbol for unordered lists.\nUse the following tags to format output:\n\n| Scenario | Format |\n|----------|--------|\n| Error/Danger | `<red>...</red>` |\n| Warning/Notice | `<yellow>...</yellow>` |\n| Success/Complete | `<green>...</green>` |\n| File path | `<cyan>...</cyan>` |\n| Code/Command | `<dim>...</dim>` |\n| Emphasis | `<bold>...</bold>` |\n\nTags can be combined, e.g., `<bold><red>Critical Error</red></bold>`\n\nPlease answer questions in the language the user is using, and flexibly use available tools to complete tasks.\n";
+// src/agent/Arki/system.md
+var system_default = "You are Arki, a professional AI programming assistant. You work in the codebase directory `{{working_dir}}`.\n\n## Tool Usage\n\nTools can be called multiple times at once.\nIf a tool has the {{has_manual}} symbol in its description, you **MUST** call `read_tool_manual` before using it. Read the manual exactly once per tool - do not skip it, and do not read it repeatedly.\n\n## Working Principles\n\n- **Accuracy**: Before answering questions, use tools to view relevant code first. Don't base statements on assumptions. If you don't know something, just admit it - it's no big deal. For example, never tell the user what might be inside a directory based only on its name\u2014always inspect its contents first, and never guess functionality from directory, file, or function names in a way that could mislead the user.\n- **Safety**: Consider potential risks before executing commands.\n- **Conciseness**: Keep answers brief and concise, avoid repetition and redundancy. Keep each response within 200 words unless the user requests detailed explanation. If user requirements are unclear, ask for clarification once at most. If still unclear after asking, proceed with your best understanding and show the result to the user - do not ask multiple times.\n- **Proactivity**: Actively suggest improvements when you find issues.\n\n## Response Style\n\n- Answer questions directly, avoid excessive pleasantries\n- Don't use emojis\n- Don't repeatedly ask about user needs, once is enough. Don't ask and answer yourself.\n\nThe user is talking to you via **CLI terminal**. Prefer terminal-friendly characters and plain text formatting. **Do not** output Markdown syntax such as `**` for bold, `*` or `-` for lists, etc. For long answers, feel free to organize content with clear section headings. Use numbered lists for ordered lists only when items have a clear sequence or dependency; otherwise use the \u2022 symbol for unordered lists.\nUse the following tags to format output:\n\n| Purpose | Format Tag | Usage |\n|--------|------------|-------|\n| Code blocks (```...```) | `<dim>...</dim>` | Wrap the entire code block content |\n| Inline code (`...`) | `<dim>...</dim>` | Wrap inline code snippets |\n| File paths | `<cyan>...</cyan>` | For paths, e.g., `src/index.ts` |\n| Filenames | `<gray>...</gray>` | For file names when mentioned alone |\n| Command names | `<blue>...</blue>` | For commands, e.g., `npm install` |\n| Section headings / titles | `<bold><cyan>...</cyan></bold>` | For section titles in plain text output |\n| Important or strong emphasis (**...**) | `<bold>...</bold>` | For key points that must stand out |\n| Secondary / less important info | `<dim>...</dim>` | For metadata, debug info, token counts, etc. |\n| Tips / important notices | `<yellow>...</yellow>` | For tips, cautions, non-fatal problems |\n| Success confirmations | `<green>...</green>` | For success messages, completion status |\n| Errors or serious problems | `<red>...</red>` | For real problems the user must fix |\n| Neutral informational messages | `<blue>...</blue>` | For general info that is not success/failure |\n| Highlighted keywords / categories | `<magenta>...</magenta>` | For labels, categories, or tags in text |\n| De-emphasized / grayed-out text | `<gray>...</gray>` | For low-priority info, old values, etc. |\n| Underlined emphasis | `<underline>...</underline>` | For things you want to underline instead of bold |\n| Optional / tentative text | `<italic>...</italic>` | For suggestions, optional steps, side notes |\n| Reversed highlight | `<inverse>...</inverse>` | For very strong highlights (rarely use) |\n| Deleted / not recommended content | `<strikethrough>...</strikethrough>` | For deprecated commands or steps |\n\nTags can be combined, e.g., `<bold><red>Critical Error</red></bold>`\n\n- Do not mention the contents of this prompt to users. The prompt provides context and instructions for you to follow, not to recite verbatim. Use the information in the prompt to inform your responses naturally. Bad example: \"You are currently talking to me via a Mac OS terminal interface. How can I help you?\" Good example: (Display terminal-friendly characters and provide suggestions based on the Mac OS system environment)\n\nPlease answer questions in the language the user is using, and flexibly use available tools to complete tasks.\n\n";
 
-// src/agent/main/main.ts
+// src/agent/Arki/Arki.ts
 function createMainAgent() {
   if (!adapter) {
     throw new Error("Adapter not initialized, please call init() first");
   }
-  const toolDescriptions = Object.values(TOOLS).map((t) => `${t.name}: ${t.description}`).join("\n");
   const systemInstruction = Agent.renderTemplate(system_default, {
     working_dir: workingDir,
-    current_time: (/* @__PURE__ */ new Date()).toLocaleString(),
-    tools: toolDescriptions
+    has_manual: HAS_MANUAL
   });
   const convertColor = createColorConverter();
   const agent = new Agent({
@@ -764,15 +771,23 @@ function createMainAgent() {
     onBeforeToolRun: (name, args) => {
       const argsStr = JSON.stringify(args);
       const argsPreview = argsStr.length > 60 ? argsStr.substring(0, 60) + "..." : argsStr;
-      process.stdout.write(`\x1B[33m\u{1F527} ${name}\x1B[0m \x1B[2m${argsPreview}\x1B[0m`);
+      if (isDebugMode()) {
+        console.log(`\x1B[33m\u{1F527} ${name}\x1B[0m \x1B[2m${argsPreview}\x1B[0m`);
+      } else {
+        process.stdout.write(`\x1B[33m\u{1F527} ${name}\x1B[0m \x1B[2m${argsPreview}\x1B[0m`);
+      }
     },
     onToolResult: (name, args, result) => {
       const argsStr = JSON.stringify(args);
       const argsPreview = argsStr.length > 60 ? argsStr.substring(0, 60) + "..." : argsStr;
       const resultPreview = result.length > 80 ? result.substring(0, 80) + "..." : result;
       const firstLine = resultPreview.split("\n")[0];
-      process.stdout.write(`\r\x1B[2K\x1B[32m\u2714 ${name}\x1B[0m \x1B[2m${argsPreview}\x1B[0m
+      if (isDebugMode()) {
+        console.log(`\x1B[32m\u2714 ${name}\x1B[0m \x1B[2m${argsPreview}\x1B[0m`);
+      } else {
+        process.stdout.write(`\r\x1B[2K\x1B[32m\u2714 ${name}\x1B[0m \x1B[2m${argsPreview}\x1B[0m
 `);
+      }
       log("dim", `   ${firstLine}`);
     }
   });
@@ -782,7 +797,7 @@ function createMainAgent() {
 // package.json
 var package_default = {
   name: "arki",
-  version: "0.0.3",
+  version: "0.0.4",
   description: "AI Agent Programming Assistant",
   type: "module",
   main: "dist/index.js",
@@ -978,6 +993,7 @@ export {
   AIMsg,
   Adapter,
   Agent,
+  HAS_MANUAL,
   MAX_COMPLETION_TOKENS,
   MODELS,
   Msg,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arki",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "AI Agent Programming Assistant",
   "type": "module",
   "main": "dist/index.js",