arki 0.0.5 → 0.0.7

package/README.md

@@ -45,6 +45,7 @@ arki [options]
 Options:
   -p <path>      Specify working directory
   --debug, -d    Enable debug mode, show detailed logs
+  --init         Initialize project config without prompting
   --reset        Reset configuration to factory defaults
   --help, -h     Show help information
 ```
@@ -80,9 +81,26 @@ Ways to enable:
 1. Add `--debug` or `-d` parameter at startup
 2. Type `/debug` during runtime to toggle
 
-## Configuration File
+## Configuration
 
-Configuration file is located at `~/.config/arki/config.json`:
+### Global Configuration
+
+Global configuration is stored in system-specific locations:
+
+- **macOS/Linux**: `~/.config/arki/config.json`
+- **Windows**: `%APPDATA%\arki\config.json`
+
+On first run, Arki copies the default configuration template to this location.
+
+### Project Configuration
+
+Each project can have its own configuration in `.arki/` directory:
+
+- `.arki/config.json` - Project-specific settings (overrides global config)
+- `.arki/state.json` - Project state and cache
+
+On first run in a new project, Arki will ask if you trust the project before initializing the `.arki/` directory.
+Use `--init` to skip the prompt in non-interactive environments.
 
 ### Reset to Factory Defaults
 
@@ -90,7 +108,7 @@ Configuration file is located at `~/.config/arki/config.json`:
 arki --reset
 ```
 
-This will delete the current configuration file. The default configuration will be used on next startup.
+This will delete the global configuration file. The default configuration will be used on next startup.
 
 ## Development
 

package/dist/config/.arki/config.json

@@ -0,0 +1,3 @@
+{
+  "agents": {}
+}

package/dist/config/.arki/state.json

@@ -0,0 +1,4 @@
+{
+  "initialized": true,
+  "createdAt": ""
+}

package/dist/config/{config.json → arki/config.json}

@@ -1,6 +1,6 @@
 {
   "agents": {
-    "main": {
+    "arki": {
       "model": "gpt-5.1",
       "flex": true,
       "reasoningEffort": "medium"

package/dist/index.d.ts

@@ -135,15 +135,41 @@ declare class Procedure {
     };
 }
 
-/**
- * Fixed parameters
- */
-declare const TEMPERATURE = 0.2;
-declare const MAX_COMPLETION_TOKENS = 4096;
+/** OS type definition */
+interface OS_TYPE {
+    /** Operating system name: 'windows' | 'mac' | 'linux' | 'other' */
+    name: 'windows' | 'mac' | 'linux' | 'other';
+    /** Operating system version */
+    version: string;
+}
+/** Global OS information */
+declare const OS: OS_TYPE;
+/** Working directory */
+declare let workingDir: string;
+/** Set working directory (for testing) */
+declare function setWorkingDir(dir: string): void;
+/** Global paths configuration */
+declare const PATHS: {
+    /** Global config directory (~/.config/arki or %APPDATA%\arki) */
+    globalConfig: string;
+    /** Project config directory (.arki/) - returns path based on current workingDir */
+    readonly projectConfig: string;
+    /** Package's global config template directory */
+    globalTemplate: string;
+    /** Package's project config template directory */
+    projectTemplate: string;
+};
+
 /**
  * Reasoning effort
  */
 type ReasoningEffort$1 = 'low' | 'medium' | 'high';
+/**
+ * Platform-specific options for adapter
+ */
+interface AdapterOptions {
+    [key: string]: unknown;
+}
 /**
  * LLM response result
  */
@@ -159,34 +185,31 @@ interface AdapterResponse {
 }
 /**
  * LLM adapter base class
+ * Only contains platform authentication, model/tools belong to Agent
  */
 declare abstract class Adapter {
     protected apiKey: string;
-    protected model: string;
-    /** Use Flex API (OpenAI) - low priority, low cost */
-    protected flex?: boolean;
-    /** Reasoning effort (thinking mode) */
-    protected reasoningEffort?: ReasoningEffort$1;
-    /** Available tools list */
-    protected tools?: Tool[];
-    constructor(config: {
-        apiKey: string;
-        model: string;
-        /** Use Flex API (OpenAI) - low priority, low cost */
-        flex?: boolean;
-        /** Reasoning effort (thinking mode) */
-        reasoningEffort?: ReasoningEffort$1;
-        /** Available tools list */
-        tools?: Tool[];
-    });
-    abstract chat(messages: Msg[], onChunk?: (chunk: string) => void): Promise<AdapterResponse>;
-    getModel(): string;
+    constructor(apiKey: string);
+    abstract chat(model: string, messages: Msg[], tools: Tool[], options: AdapterOptions, onChunk?: (chunk: string) => void): Promise<AdapterResponse>;
 }
 
+/** Global tool registry */
+declare const TOOLS: Record<string, Tool>;
+/** Global procedure registry */
+declare const PROCEDURES: Record<string, Procedure>;
+/** Global adapter registry by platform */
+declare const adapters: Record<string, Adapter>;
+/**
+ * Get adapter by platform name
+ */
+declare function getAdapter(platform: string): Adapter;
+/** Initialize global state */
+declare function init(cwd?: string, forceInit?: boolean): Promise<void>;
+
 /**
  * Agent type
  */
-type AgentType = 'main' | 'coder';
+type AgentType = 'arki' | 'coder';
 /**
  * Reasoning effort
  */
@@ -195,60 +218,37 @@ type ReasoningEffort = 'low' | 'medium' | 'high';
  * Agent model configuration
  */
 interface AgentModelConfig {
-    /** Model ID */
+    /** Model ID (provider is derived from MODELS) */
     model: string;
-    /** Use Flex API (low priority, low cost) */
+    /** Use Flex API (low priority, low cost) - OpenAI specific */
     flex?: boolean;
     /** Reasoning effort (thinking mode) */
     reasoningEffort?: ReasoningEffort;
 }
 /**
- * Global configuration
+ * Global configuration (from config files)
  */
 interface GlobalConfig {
-    apiKeys?: {
-        openai?: string;
-        anthropic?: string;
-        google?: string;
-        [key: string]: string | undefined;
-    };
     agents: {
         [K in AgentType]?: AgentModelConfig;
     };
 }
 /**
- * Global configuration manager
+ * Get loaded configuration
  */
-declare class ConfigManager {
-    private config;
-    private loaded;
-    /**
-     * Load configuration (called at program startup)
-     */
-    load(): Promise<GlobalConfig>;
-    /**
-     * Save configuration
-     */
-    save(): Promise<void>;
-    get(): GlobalConfig;
-    getApiKey(provider: string): string | undefined;
-    getAgentConfig(agentType: AgentType): AgentModelConfig;
-    private loadEnvApiKeys;
-}
-declare const config: ConfigManager;
-
-/** Working directory */
-declare let workingDir: string;
-/** Set working directory (for testing) */
-declare function setWorkingDir(dir: string): void;
-/** Global tool registry */
-declare const TOOLS: Record<string, Tool>;
-/** Global procedure registry */
-declare const PROCEDURES: Record<string, Procedure>;
-/** Global Adapter instance */
-declare let adapter: Adapter | null;
-/** Initialize global state */
-declare function init(cwd?: string): Promise<void>;
+declare function getConfig(): GlobalConfig;
+/**
+ * Get API key from environment variable
+ */
+declare function getApiKey(provider: string): string | undefined;
+/**
+ * Get agent configuration
+ */
+declare function getAgentConfig(agentType: AgentType): AgentModelConfig;
+/**
+ * Save configuration to global config file
+ */
+declare function saveConfig(): Promise<void>;
 
 /**
  * Debug logging module
@@ -271,6 +271,11 @@ declare function debug(category: string, message: string, data?: unknown): void;
  * All log output is single-line with timestamp prefix
  * Supports XML-style color tags: <red>text</red>, <bold>text</bold>, etc.
  */
+/**
+ * Print output without timestamp (for prompts and simple messages)
+ * @param message Message string with optional XML color tags
+ */
+declare function print(message: string): void;
 /**
  * Log output with timestamp and XML color tag support
  * @param message Message string with optional XML color tags
@@ -331,18 +336,23 @@ declare function convertColorTags(str: string): string;
  */
 declare function createColorConverter(): (chunk: string) => string;
 
+/**
+ * OpenAI-specific options
+ */
+interface OpenAIOptions extends AdapterOptions {
+    /** Use Flex API - low priority, low cost */
+    flex?: boolean;
+    /** Reasoning effort (thinking mode) */
+    reasoningEffort?: ReasoningEffort$1;
+    /** Maximum completion tokens for LLM response */
+    maxCompletionTokens?: number;
+}
 declare class OpenAIAdapter extends Adapter {
     private client;
-    constructor(config: {
-        apiKey: string;
-        model: string;
-        flex?: boolean;
-        reasoningEffort?: 'low' | 'medium' | 'high';
-        tools?: Tool[];
-    });
+    constructor(apiKey: string);
     private toOpenAIMessages;
-    private getTools;
-    chat(messages: Msg[], onChunk?: (chunk: string) => void): Promise<AdapterResponse>;
+    private formatTools;
+    chat(model: string, messages: Msg[], tools: Tool[], options: OpenAIOptions, onChunk?: (chunk: string) => void): Promise<AdapterResponse>;
 }
 
 interface AgentResponse {
@@ -359,17 +369,24 @@ interface AgentResponse {
         cachedTokens?: number;
     };
 }
+interface AgentConfig {
+    adapter: Adapter;
+    model: string;
+    tools: Tool[];
+    platformOptions?: AdapterOptions;
+    messages: Msg[];
+    /** Maximum completion tokens for LLM response */
+    maxCompletionTokens?: number;
+    onStream?: (chunk: string) => void;
+    onToolCallMsg?: (msg: ToolCallMsg) => void;
+    onBeforeToolRun?: (name: string, args: Record<string, unknown>) => void;
+    onToolResult?: (name: string, args: Record<string, unknown>, result: string) => void;
+}
 declare class Agent {
     private config;
     private messages;
-    constructor(config: {
-        adapter: Adapter;
-        messages: Msg[];
-        onStream?: (chunk: string) => void;
-        onToolCallMsg?: (msg: ToolCallMsg) => void;
-        onBeforeToolRun?: (name: string, args: Record<string, unknown>) => void;
-        onToolResult?: (name: string, args: Record<string, unknown>, result: string) => void;
-    });
+    private toolsMap;
+    constructor(config: AgentConfig);
     /**
      * Render template string, replacing {{variable}} style variables
      */
@@ -404,4 +421,4 @@ interface Model {
     readonly capabilities: ModelCapabilities;
 }
 
-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, PROCEDURES, type ReasoningEffort$1 as ReasoningEffort, SystemMsg, TEMPERATURE, TOOLS, Tool, type ToolCall, ToolCallMsg, type ToolResult, ToolResultMsg, UserMsg, adapter, colors, config, convertColorTags, createColorConverter, debug, error, info, init, isDebugMode, log, setDebugMode, setWorkingDir, success, warn, workingDir };
+export { AIMsg, Adapter, type AdapterOptions, type AdapterResponse, Agent, type AgentModelConfig, type AgentResponse, type AgentType, type ColorName, type GlobalConfig, HAS_MANUAL, MODELS, type Model, type ModelCapabilities, type ModelProvider, Msg, MsgType, OS, type OS_TYPE, OpenAIAdapter, type OpenAIOptions, PATHS, PROCEDURES, type ReasoningEffort$1 as ReasoningEffort, SystemMsg, TOOLS, Tool, type ToolCall, ToolCallMsg, type ToolResult, ToolResultMsg, UserMsg, adapters, colors, convertColorTags, createColorConverter, debug, error, getAdapter, getAgentConfig, getApiKey, getConfig, info, init, isDebugMode, log, print, saveConfig, setDebugMode, setWorkingDir, success, warn, workingDir };