axon-code 2.4.0

package/dist/agents/statusline.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Statusline Setup Agent
+ * 配置 Axon 状态行设置
+ */
+/**
+ * 状态行配置
+ */
+export interface StatuslineConfig {
+    type: 'command' | 'template' | 'disabled';
+    command?: string;
+    template?: string;
+    refreshInterval?: number;
+    position?: 'top' | 'bottom';
+    style?: StatuslineStyle;
+}
+/**
+ * 状态行样式配置
+ */
+export interface StatuslineStyle {
+    backgroundColor?: string;
+    textColor?: string;
+    dimmed?: boolean;
+    bold?: boolean;
+    separatorChar?: string;
+}
+/**
+ * 状态行显示元素
+ */
+export interface StatuslineElement {
+    type: 'model' | 'tokens' | 'cost' | 'duration' | 'tools' | 'cwd' | 'session' | 'git' | 'custom' | 'context_percentage';
+    format?: string;
+    visible: boolean;
+    label?: string;
+}
+/**
+ * 会话上下文数据（由 statusLine 命令接收）
+ */
+export interface StatuslineContext {
+    session_id: string;
+    transcript_path: string;
+    cwd: string;
+    model: {
+        id: string;
+        display_name: string;
+    };
+    workspace: {
+        current_dir: string;
+        project_dir: string;
+    };
+    version: string;
+    output_style: {
+        name: string;
+    };
+    context_window: {
+        total_input_tokens: number;
+        total_output_tokens: number;
+        context_window_size: number;
+        current_usage: {
+            input_tokens: number;
+            output_tokens: number;
+            cache_creation_input_tokens: number;
+            cache_read_input_tokens: number;
+        } | null;
+    };
+}
+/**
+ * PS1 转义序列映射
+ */
+export declare const PS1_ESCAPE_MAPPINGS: Record<string, string>;
+/**
+ * Statusline 代理
+ * 负责配置和管理 Axon 的状态行设置
+ */
+export declare class StatuslineAgent {
+    private configDir;
+    private settingsFile;
+    private scriptsDir;
+    constructor();
+    /**
+     * 确保必要的目录存在
+     */
+    private ensureDirectories;
+    /**
+     * 获取当前状态行配置
+     */
+    getConfig(): Promise<StatuslineConfig | null>;
+    /**
+     * 配置状态行
+     */
+    configure(config: Partial<StatuslineConfig>): Promise<void>;
+    /**
+     * 从 PS1 环境变量导入配置
+     */
+    importFromPS1(shellConfigPath?: string): Promise<{
+        success: boolean;
+        ps1?: string;
+        command?: string;
+        error?: string;
+    }>;
+    /**
+     * 转换 PS1 转义序列为 shell 命令
+     */
+    private convertPS1ToCommand;
+    /**
+     * 创建状态行脚本文件
+     */
+    createScript(scriptName: string, scriptContent: string, makeExecutable?: boolean): Promise<string>;
+    /**
+     * 创建预置模板脚本
+     */
+    createTemplateScript(template: StatuslineTemplate): Promise<string>;
+    /**
+     * 获取模板脚本内容
+     */
+    private getTemplateScript;
+    /**
+     * 重置为默认配置
+     */
+    resetToDefault(): Promise<void>;
+    /**
+     * 预览状态行（使用模拟数据）
+     */
+    preview(command?: string): Promise<string>;
+    /**
+     * 读取设置文件
+     */
+    private readSettings;
+    /**
+     * 写入设置文件
+     */
+    private writeSettings;
+    /**
+     * 验证命令是否安全
+     */
+    validateCommand(command: string): {
+        valid: boolean;
+        error?: string;
+    };
+}
+export type StatuslineTemplate = 'minimal' | 'standard' | 'detailed' | 'custom';
+export declare const STATUSLINE_AGENT_SYSTEM_PROMPT = "You are a status line setup agent for Axon. Your job is to create or update the statusLine command in the user's Axon settings.\n\nWhen asked to convert the user's shell PS1 configuration, follow these steps:\n1. Read the user's shell configuration files in this order of preference:\n   - ~/.zshrc\n   - ~/.bashrc\n   - ~/.bash_profile\n   - ~/.profile\n\n2. Extract the PS1 value using this regex pattern: /(?:^|\\n)\\s*(?:export\\s+)?PS1\\s*=\\s*[\"']([^\"']+)[\"']/m\n\n3. Convert PS1 escape sequences to shell commands:\n   - \\u \u2192 $(whoami)\n   - \\h \u2192 $(hostname -s)\n   - \\H \u2192 $(hostname)\n   - \\w \u2192 $(pwd)\n   - \\W \u2192 $(basename \"$(pwd)\")\n   - \\$ \u2192 $\n   - \\n \u2192 \\n\n   - \\t \u2192 $(date +%H:%M:%S)\n   - \\d \u2192 $(date \"+%a %b %d\")\n   - \\@ \u2192 $(date +%I:%M%p)\n   - \\# \u2192 #\n   - \\! \u2192 !\n\n4. When using ANSI color codes, be sure to use `printf`. Do not remove colors. Note that the status line will be printed in a terminal using dimmed colors.\n\n5. If the imported PS1 would have trailing \"$\" or \">\" characters in the output, you MUST remove them.\n\n6. If no PS1 is found and user did not provide other instructions, ask for further instructions.\n\nHow to use the statusLine command:\n1. The statusLine command will receive the following JSON input via stdin:\n   {\n     \"session_id\": \"string\", // Unique session ID\n     \"transcript_path\": \"string\", // Path to the conversation transcript\n     \"cwd\": \"string\",         // Current working directory\n     \"model\": {\n       \"id\": \"string\",           // Model ID (e.g., \"claude-3-5-sonnet-20241022\")\n       \"display_name\": \"string\"  // Display name (e.g., \"Claude 3.5 Sonnet\")\n     },\n     \"workspace\": {\n       \"current_dir\": \"string\",  // Current working directory path\n       \"project_dir\": \"string\"   // Project root directory path\n     },\n     \"version\": \"string\",        // Axon app version (e.g., \"1.0.71\")\n     \"output_style\": {\n       \"name\": \"string\",         // Output style name (e.g., \"default\", \"Explanatory\", \"Learning\")\n     },\n     \"context_window\": {\n       \"total_input_tokens\": number,       // Total input tokens used in session (cumulative)\n       \"total_output_tokens\": number,      // Total output tokens used in session (cumulative)\n       \"context_window_size\": number,      // Context window size for current model (e.g., 200000)\n       \"current_usage\": {                   // Token usage from last API call (null if no messages yet)\n         \"input_tokens\": number,           // Input tokens for current context\n         \"output_tokens\": number,          // Output tokens generated\n         \"cache_creation_input_tokens\": number,  // Tokens written to cache\n         \"cache_read_input_tokens\": number       // Tokens read from cache\n       } | null\n     }\n   }\n\n   You can use this JSON data in your command like:\n   - $(cat | jq -r '.model.display_name')\n   - $(cat | jq -r '.workspace.current_dir')\n   - $(cat | jq -r '.output_style.name')\n\n   Or store it in a variable first:\n   - input=$(cat); echo \"$(echo \"$input\" | jq -r '.model.display_name') in $(echo \"$input\" | jq -r '.workspace.current_dir')\"\n\n   To calculate context window percentage, use current_usage (current context) not the cumulative totals:\n   - input=$(cat); usage=$(echo \"$input\" | jq '.context_window.current_usage'); if [ \"$usage\" != \"null\" ]; then current=$(echo \"$usage\" | jq '.input_tokens + .cache_creation_input_tokens + .cache_read_input_tokens'); size=$(echo \"$input\" | jq '.context_window.context_window_size'); pct=$((current * 100 / size)); printf '%d%% context' \"$pct\"; fi\n\n2. For longer commands, you can save a new file in the user's ~/.axon directory, e.g.:\n   - ~/.axon/statusline-command.sh and reference that file in the settings.\n\n3. Update the user's ~/.axon/settings.json with:\n   {\n     \"statusLine\": {\n       \"type\": \"command\",\n       \"command\": \"your_command_here\"\n     }\n   }\n\n4. If ~/.axon/settings.json is a symlink, update the target file instead.\n\nGuidelines:\n- Preserve existing settings when updating\n- Return a summary of what was configured, including the name of the script file if used\n- If the script includes git commands, they should skip optional locks\n- IMPORTANT: At the end of your response, inform the parent agent that this \"statusline-setup\" agent must be used for further status line changes.\n  Also ensure that the user is informed that they can ask Claude to continue to make changes to the status line.\n";
+export declare const STATUSLINE_AGENT_CONFIG: {
+    agentType: string;
+    whenToUse: string;
+    tools: string[];
+    source: string;
+    baseDir: string;
+    model: string;
+    color: string;
+    systemPrompt: string;
+};
+export declare const statuslineAgent: StatuslineAgent;
+/**
+ * 创建简单的内联状态行命令
+ */
+export declare function createInlineCommand(elements: StatuslineElement[]): string;
+/**
+ * 解析并验证 statusline 命令
+ */
+export declare function parseStatuslineCommand(command: string): {
+    valid: boolean;
+    uses_jq: boolean;
+    uses_git: boolean;
+    complexity: 'simple' | 'medium' | 'complex';
+    warnings?: string[];
+};
+//# sourceMappingURL=statusline.d.ts.map

package/dist/agents/statusline.d.ts.map

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