axon-code 2.4.0

package/dist/teleport/validation.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Teleport 仓库验证
+ * 确保远程会话在正确的 Git 仓库中运行
+ */
+import type { RepoValidationResult } from './types.js';
+/**
+ * 获取当前 Git 仓库远程 URL
+ */
+export declare function getCurrentRepoUrl(): Promise<string | null>;
+/**
+ * 规范化仓库 URL（去除 .git 后缀，统一协议）
+ */
+export declare function normalizeRepoUrl(url: string): string;
+/**
+ * 比较两个仓库 URL 是否相同
+ */
+export declare function compareRepoUrls(url1: string, url2: string): boolean;
+/**
+ * 验证会话仓库是否匹配当前仓库
+ */
+export declare function validateSessionRepository(sessionRepo?: string): Promise<RepoValidationResult>;
+/**
+ * 获取当前分支名
+ */
+export declare function getCurrentBranch(): Promise<string | null>;
+/**
+ * 检查工作目录是否干净
+ */
+export declare function isWorkingDirectoryClean(): Promise<boolean>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/teleport/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/teleport/validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAwB,MAAM,YAAY,CAAC;AAI7E;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAqBpD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,oBAAoB,CAAC,CA4C/B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAS/D;AAED;;GAEG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,OAAO,CAAC,CAShE"}

package/dist/teleport/validation.js

@@ -0,0 +1,124 @@
+/**
+ * Teleport 仓库验证
+ * 确保远程会话在正确的 Git 仓库中运行
+ */
+import { exec } from 'child_process';
+import { promisify } from 'util';
+const execAsync = promisify(exec);
+/**
+ * 获取当前 Git 仓库远程 URL
+ */
+export async function getCurrentRepoUrl() {
+    try {
+        const { stdout } = await execAsync('git config --get remote.origin.url', {
+            cwd: process.cwd(),
+        });
+        return stdout.trim() || null;
+    }
+    catch (error) {
+        // 不是 git 仓库或没有 origin
+        return null;
+    }
+}
+/**
+ * 规范化仓库 URL（去除 .git 后缀，统一协议）
+ */
+export function normalizeRepoUrl(url) {
+    let normalized = url.trim();
+    // 移除 .git 后缀
+    if (normalized.endsWith('.git')) {
+        normalized = normalized.slice(0, -4);
+    }
+    // 转换 SSH 格式为 HTTPS
+    // git@github.com:user/repo -> https://github.com/user/repo
+    const sshMatch = normalized.match(/^git@([^:]+):(.+)$/);
+    if (sshMatch) {
+        normalized = `https://${sshMatch[1]}/${sshMatch[2]}`;
+    }
+    // 移除尾部斜杠
+    if (normalized.endsWith('/')) {
+        normalized = normalized.slice(0, -1);
+    }
+    return normalized.toLowerCase();
+}
+/**
+ * 比较两个仓库 URL 是否相同
+ */
+export function compareRepoUrls(url1, url2) {
+    return normalizeRepoUrl(url1) === normalizeRepoUrl(url2);
+}
+/**
+ * 验证会话仓库是否匹配当前仓库
+ */
+export async function validateSessionRepository(sessionRepo) {
+    // 如果会话没有仓库信息，不需要验证
+    if (!sessionRepo) {
+        return {
+            status: 'no_validation',
+        };
+    }
+    try {
+        // 获取当前仓库
+        const currentRepo = await getCurrentRepoUrl();
+        if (!currentRepo) {
+            // 当前目录不是 git 仓库
+            return {
+                status: 'error',
+                sessionRepo,
+                errorMessage: 'Current directory is not a git repository',
+            };
+        }
+        // 比较仓库
+        const isMatch = compareRepoUrls(sessionRepo, currentRepo);
+        if (isMatch) {
+            return {
+                status: 'match',
+                sessionRepo,
+                currentRepo,
+            };
+        }
+        else {
+            return {
+                status: 'mismatch',
+                sessionRepo,
+                currentRepo,
+            };
+        }
+    }
+    catch (error) {
+        return {
+            status: 'error',
+            sessionRepo,
+            errorMessage: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * 获取当前分支名
+ */
+export async function getCurrentBranch() {
+    try {
+        const { stdout } = await execAsync('git branch --show-current', {
+            cwd: process.cwd(),
+        });
+        return stdout.trim() || null;
+    }
+    catch (error) {
+        return null;
+    }
+}
+/**
+ * 检查工作目录是否干净
+ */
+export async function isWorkingDirectoryClean() {
+    try {
+        const { stdout } = await execAsync('git status --porcelain', {
+            cwd: process.cwd(),
+        });
+        return stdout.trim().length === 0;
+    }
+    catch (error) {
+        return false;
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/teleport/validation.js.map

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

package/dist/tools/agent-teams.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Agent Teams 工具 - TeammateTool
+ *
+ * 管理团队和协调代理（对齐官方 cli.js 实现）
+ * 需要 AXON_EXPERIMENTAL_AGENT_TEAMS=1 环境变量
+ *
+ * 注意：SendMessage 功能已统一到 tools/team.ts 的 TeamSendMessageTool
+ * 此文件仅保留 TeammateTool（官方 23 次引用的主要工具）
+ */
+import { BaseTool } from './base.js';
+import type { ToolResult, ToolDefinition } from '../types/index.js';
+interface TeammateToolInput {
+    operation: 'spawnTeam' | 'cleanup';
+    team_name?: string;
+    description?: string;
+}
+export declare class TeammateTool extends BaseTool<TeammateToolInput, ToolResult> {
+    name: string;
+    description: string;
+    getInputSchema(): ToolDefinition['inputSchema'];
+    execute(input: TeammateToolInput): Promise<ToolResult>;
+    private spawnTeam;
+    private cleanup;
+}
+export {};
+//# sourceMappingURL=agent-teams.d.ts.map

package/dist/tools/agent-teams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-teams.d.ts","sourceRoot":"","sources":["../../src/tools/agent-teams.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAqBpE,UAAU,iBAAiB;IACzB,SAAS,EAAE,WAAW,GAAG,SAAS,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD,qBAAa,YAAa,SAAQ,QAAQ,CAAC,iBAAiB,EAAE,UAAU,CAAC;IACvE,IAAI,SAAkB;IACtB,WAAW,SA4B6D;IAExE,cAAc,IAAI,cAAc,CAAC,aAAa,CAAC;IAsBzC,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;IAqB5D,OAAO,CAAC,SAAS;IA+CjB,OAAO,CAAC,OAAO;CA4ChB"}

package/dist/tools/agent-teams.js

@@ -0,0 +1,171 @@
+/**
+ * Agent Teams 工具 - TeammateTool
+ *
+ * 管理团队和协调代理（对齐官方 cli.js 实现）
+ * 需要 AXON_EXPERIMENTAL_AGENT_TEAMS=1 环境变量
+ *
+ * 注意：SendMessage 功能已统一到 tools/team.ts 的 TeamSendMessageTool
+ * 此文件仅保留 TeammateTool（官方 23 次引用的主要工具）
+ */
+import { v4 as uuidv4 } from 'uuid';
+import { BaseTool } from './base.js';
+import { t } from '../i18n/index.js';
+import { isAgentTeamsEnabled, getAgentId, getTeamName, createTeammateContext, setDynamicTeamContext, clearDynamicTeamContext, } from '../agents/teammate-context.js';
+import { createTeam, getTeam, deleteTeam, getActiveMembers, } from '../teams/storage.js';
+// ============================================================================
+// TeammateTool（对齐官方实现，使用统一存储层）
+// ============================================================================
+export class TeammateTool extends BaseTool {
+    name = 'TeammateTool';
+    description = `Manage teams and coordinate agents on your team. Use this tool to create and clean up teams.
+To spawn new teammates, use the Task tool with \`team_name\` and \`name\` parameters.
+
+## Operations
+
+### spawnTeam - Create a Team
+Create a new team to coordinate multiple agents working on a project.
+Teams have a 1:1 correspondence with task lists (Team = TaskList).
+
+### cleanup - Remove a Team
+Remove team and task directories. Cleanup will fail if the team still has active members.
+Gracefully shut down teammates first, then call cleanup after all teammates have closed.
+
+## When to Use
+
+Use this tool proactively whenever:
+- The user explicitly asks to use a team, swarm, or group of agents
+- The user mentions wanting agents to work together, coordinate, or collaborate
+- A task is complex enough that it would benefit from parallel work by multiple agents
+
+When in doubt about whether a task warrants a team, prefer spawning a team.
+
+## Workflow
+1. Create a team with \`spawnTeam\`
+2. Create tasks using Task tool (they auto-use team's task list)
+3. Spawn teammates using Task tool with \`team_name\` and \`name\` parameters
+4. Assign tasks using TaskUpdate's \`owner\` parameter
+5. Teammates work and mark tasks complete via TaskUpdate
+6. Shutdown team via SendMessage (type: "shutdown_request") then cleanup`;
+    getInputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                operation: {
+                    type: 'string',
+                    enum: ['spawnTeam', 'cleanup'],
+                    description: 'The operation to perform',
+                },
+                team_name: {
+                    type: 'string',
+                    description: 'Name for the team (required for spawnTeam)',
+                },
+                description: {
+                    type: 'string',
+                    description: 'Description of the team purpose',
+                },
+            },
+            required: ['operation'],
+        };
+    }
+    async execute(input) {
+        if (!isAgentTeamsEnabled()) {
+            return {
+                success: false,
+                error: t('agentTeams.notEnabled'),
+            };
+        }
+        switch (input.operation) {
+            case 'spawnTeam':
+                return this.spawnTeam(input);
+            case 'cleanup':
+                return this.cleanup();
+            default:
+                return {
+                    success: false,
+                    error: t('agentTeams.unknownOperation', { operation: input.operation }),
+                };
+        }
+    }
+    spawnTeam(input) {
+        const teamName = input.team_name;
+        if (!teamName) {
+            return { success: false, error: t('agentTeams.teamNameRequired') };
+        }
+        // 检查团队是否已存在（使用统一存储层）
+        const existing = getTeam(teamName);
+        if (existing) {
+            return {
+                success: false,
+                error: t('agentTeams.teamAlreadyExists', { teamName }),
+            };
+        }
+        const leadId = getAgentId() || uuidv4();
+        try {
+            // 使用统一存储层创建团队
+            const config = createTeam({
+                teamName,
+                description: input.description,
+                leadAgentId: leadId,
+                leadSessionId: uuidv4(),
+            });
+            // 设置动态 Team 上下文（AsyncLocalStorage）
+            setDynamicTeamContext(createTeammateContext({
+                agentId: leadId,
+                agentName: 'team-lead',
+                teamName,
+                agentType: 'teammate',
+                leadAgentId: leadId,
+            }));
+            return {
+                success: true,
+                output: t('agentTeams.createSuccess', { teamName, teamId: config.teamId, taskListId: config.taskListId }),
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: t('agentTeams.createFailed', { error: error instanceof Error ? error.message : String(error) }),
+            };
+        }
+    }
+    cleanup() {
+        const teamName = getTeamName();
+        if (!teamName) {
+            return {
+                success: false,
+                error: t('agentTeams.noActiveTeam'),
+            };
+        }
+        // 检查团队是否存在（使用统一存储层）
+        const config = getTeam(teamName);
+        if (!config) {
+            return {
+                success: false,
+                error: t('agentTeams.teamNotFound', { teamName }),
+            };
+        }
+        // 检查是否有活跃成员（除 lead 外）
+        const activeMembers = getActiveMembers(teamName).filter(m => m.role === 'teammate');
+        if (activeMembers.length > 0) {
+            return {
+                success: false,
+                error: t('agentTeams.activeMembers', { teamName, count: activeMembers.length, names: activeMembers.map(m => m.name).join(', ') }),
+            };
+        }
+        // 使用统一存储层删除团队
+        const deleted = deleteTeam(teamName);
+        if (!deleted) {
+            return {
+                success: false,
+                error: t('agentTeams.cleanupFailed', { teamName }),
+            };
+        }
+        // 清空动态上下文
+        clearDynamicTeamContext();
+        return {
+            success: true,
+            output: t('agentTeams.cleanupSuccess', { teamName }),
+        };
+    }
+}
+//# sourceMappingURL=agent-teams.js.map

package/dist/tools/agent-teams.js.map

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

package/dist/tools/agent.d.ts

@@ -0,0 +1,223 @@
+/**
+ * Agent 工具 (Task)
+ * 子代理管理 - 参照官方 Axon CLI v2.1.4 实现
+ */
+import { BaseTool } from './base.js';
+import type { AgentInput, ToolResult, ToolDefinition } from '../types/index.js';
+import type { Message } from '../types/index.js';
+export interface AgentTypeDefinition {
+    agentType: string;
+    whenToUse: string;
+    tools?: string[];
+    /** v2.1.33: 限制可以生成的子 agent 类型 (Task(agent_type) 语法) */
+    allowedSubagentTypes?: string[];
+    /** 禁用的工具列表 */
+    disallowedTools?: string[];
+    /** 限制可用的 skills */
+    skills?: string[];
+    forkContext?: boolean;
+    permissionMode?: 'default' | 'plan' | 'acceptEdits' | 'bypassPermissions';
+    model?: string;
+    color?: string;
+    memory?: string;
+    /** agent 来源：built-in, userSettings, projectSettings, plugin */
+    source?: 'built-in' | 'userSettings' | 'projectSettings' | 'plugin';
+    /** 插件名称（source 为 plugin 时有值） */
+    plugin?: string;
+    /** 原始文件名（不含 .md） */
+    filename?: string;
+    /** 最大轮次 */
+    maxTurns?: number;
+    description?: string;
+    getSystemPrompt?: () => string;
+}
+/**
+ * v2.1.33: 解析 tools 字段中的 Task(agent_type) 语法
+ *
+ * 对应官方 qzq 函数中的 tools 格式解析
+ * 例如: "Task(Explore), Task(Plan), Read, Grep" 表示
+ * - 可以使用 Task 工具，但只能生成 Explore 和 Plan 类型的子 agent
+ * - 可以使用 Read 和 Grep 工具
+ *
+ * @param tools 原始 tools 数组
+ * @returns { tools: 过滤后的工具列表, allowedSubagentTypes: 允许的子 agent 类型 }
+ */
+export declare function parseToolsWithAgentTypeRestriction(tools: string[]): {
+    tools: string[];
+    allowedSubagentTypes?: string[];
+};
+export type ModelAlias = 'sonnet' | 'opus' | 'haiku' | 'inherit';
+/**
+ * 设置父模型上下文
+ * 在主循环中设置，供子代理继承
+ */
+export declare function setParentModelContext(model: string | undefined): void;
+/**
+ * 获取父模型上下文
+ */
+export declare function getParentModelContext(): string | undefined;
+/**
+ * 解析模型参数，处理 inherit 继承
+ * @param modelParam 模型参数 ('sonnet', 'opus', 'haiku', 'inherit', 或 undefined)
+ * @param agentDefaultModel 代理类型的默认模型（可选）
+ * @returns 解析后的模型名称
+ */
+export declare function resolveAgentModel(modelParam: string | undefined, agentDefaultModel?: string): string | undefined;
+/**
+ * 格式化代理模型名称用于显示
+ * 官方 w71() 函数 - v2.1.19 修复
+ *
+ * 修复：当代理没有设置模型时显示 "Inherit (default)" 而不是 "Sonnet (default)"
+ *
+ * @param model 模型名称 (undefined, 'inherit', 'sonnet', 'opus', 'haiku' 等)
+ * @returns 格式化的显示名称
+ */
+export declare function formatAgentModel(model: string | undefined): string;
+export declare const BUILT_IN_AGENT_TYPES: AgentTypeDefinition[];
+export declare const AGENT_TYPES: Record<string, {
+    description: string;
+    tools: string[];
+}>;
+/**
+ * 初始化加载所有自定义 agents
+ * 加载顺序（对齐官方 oc7）：
+ * 1. 插件 agents（最低优先级）
+ * 2. 用户级 agents（~/.axon/agents/）
+ * 3. 项目级 agents（.axon/agents/）（最高优先级）
+ */
+export declare function initializeCustomAgents(): void;
+/**
+ * 获取所有活跃的 agent 定义（内置 + 自定义，去重后）
+ * 对齐官方 agentDefinitions.activeAgents
+ */
+export declare function getAllActiveAgents(): AgentTypeDefinition[];
+/**
+ * 获取所有自定义（非内置）的 agent 定义
+ */
+export declare function getCustomAgents(): AgentTypeDefinition[];
+/**
+ * 重置自定义 agents 缓存（用于测试或热重载）
+ */
+export declare function resetCustomAgents(): void;
+export interface AgentHistoryEntry {
+    timestamp: Date;
+    type: 'started' | 'progress' | 'completed' | 'failed' | 'resumed';
+    message: string;
+    data?: any;
+}
+export interface BackgroundAgent {
+    id: string;
+    agentType: string;
+    description: string;
+    prompt: string;
+    model?: string;
+    status: 'running' | 'completed' | 'failed' | 'paused';
+    startTime: Date;
+    endTime?: Date;
+    result?: ToolResult;
+    error?: string;
+    history: AgentHistoryEntry[];
+    intermediateResults: any[];
+    currentStep?: number;
+    totalSteps?: number;
+    workingDirectory?: string;
+    metadata?: Record<string, any>;
+    messages?: Message[];
+    progress?: {
+        toolUseCount: number;
+        tokenCount: number;
+    };
+    lastActivity?: {
+        toolName: string;
+        input: any;
+    };
+}
+export declare function getBackgroundAgents(): BackgroundAgent[];
+export declare function getBackgroundAgent(id: string): BackgroundAgent | undefined;
+export declare function killBackgroundAgent(id: string): boolean;
+export declare function clearCompletedAgents(): number;
+export declare function pauseBackgroundAgent(id: string): boolean;
+export declare function getAgentTypeDefinition(agentType: string): AgentTypeDefinition | null;
+export declare class TaskTool extends BaseTool<AgentInput, ToolResult> {
+    name: string;
+    shouldDefer: boolean;
+    searchHint: string;
+    private static currentDepth;
+    /**
+     * 动态生成 description，包含所有活跃的 agents（内置 + 自定义）
+     */
+    get description(): string;
+    private parentMessages;
+    /**
+     * v2.1.33: 限制可生成的子 agent 类型
+     * 当从 frontmatter 的 tools 字段中解析出 Task(agent_type) 语法时设置
+     * null 表示无限制
+     */
+    private _allowedSubagentTypes;
+    /**
+     * 设置允许的子 agent 类型
+     */
+    setAllowedSubagentTypes(types: string[] | undefined): void;
+    /**
+     * 获取当前的子 agent 类型限制
+     */
+    getAllowedSubagentTypes(): string[] | undefined;
+    /**
+     * 设置父对话上下文（在 Loop 中调用）
+     */
+    setParentContext(messages: Message[]): void;
+    getInputSchema(): ToolDefinition['inputSchema'];
+    execute(input: AgentInput): Promise<ToolResult>;
+    /**
+     * 恢复已有代理
+     */
+    private resumeAgent;
+    /**
+     * 后台执行代理（异步，不阻塞）
+     */
+    private executeAgentInBackground;
+    /**
+     * 同步执行代理（阻塞直到完成）
+     */
+    private executeAgentSync;
+    /**
+     * 真实的代理执行循环（核心逻辑）
+     * 参照官方 B4A 函数实现
+     */
+    private executeAgentLoop;
+    /**
+     * 发送代理完成通知（v2.1.7 功能）
+     * 在代理执行完成后发送通知，包含内联的最终响应摘要
+     */
+    private sendAgentCompletionNotification;
+}
+export declare class TaskOutputTool extends BaseTool<{
+    task_id: string;
+    block?: boolean;
+    timeout?: number;
+    show_history?: boolean;
+    action?: 'stop';
+}, ToolResult> {
+    name: string;
+    shouldDefer: boolean;
+    searchHint: string;
+    description: string;
+    getInputSchema(): ToolDefinition['inputSchema'];
+    execute(input: {
+        task_id: string;
+        block?: boolean;
+        timeout?: number;
+        show_history?: boolean;
+        action?: 'stop';
+    }): Promise<ToolResult>;
+    /**
+     * 处理 Bash 后台任务
+     */
+    private handleBashTask;
+    /**
+     * 从磁盘元数据恢复后台任务信息（进程重启后的 fallback 路径）
+     * 进程重启后内存中的 backgroundTasks Map 已清空，但 .meta.json 和 .log 文件仍在磁盘上
+     */
+    private handleBashTaskFromDisk;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/tools/agent.d.ts.map

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