axon-code 2.4.0

package/dist/agents/teammate-context.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Agent Teams - Teammate Context 管理
+ * 对齐官方 v2.1.32 实现
+ *
+ * 使用 AsyncLocalStorage 管理 Teammate 上下文
+ * 官方源码：cli.js 中的 R6A 对象（teammate API 导出）
+ *
+ * 环境变量: AXON_EXPERIMENTAL_AGENT_TEAMS=1
+ */
+/**
+ * Teammate 上下文（对齐官方 DynamicTeamContext 结构）
+ */
+export interface TeammateContext {
+    /** Agent 唯一 ID */
+    agentId: string;
+    /** Agent 名称 */
+    agentName: string;
+    /** Team 名称 */
+    teamName: string;
+    /** 颜色标识 */
+    color?: string;
+    /** 是否要求 Plan 模式 */
+    planModeRequired?: boolean;
+    /** 父会话 ID */
+    parentSessionId?: string;
+    /** Agent 类型 */
+    agentType?: 'teammate' | 'subagent';
+    /** Lead Agent ID */
+    leadAgentId?: string;
+}
+/**
+ * In-Process Teammate 任务状态
+ */
+export interface InProcessTeammateTask {
+    type: 'in_process_teammate';
+    status: 'running' | 'completed' | 'failed' | 'idle';
+    isIdle: boolean;
+    onIdleCallbacks?: Array<() => void>;
+    agentId: string;
+    agentName: string;
+    teamName: string;
+}
+/**
+ * Team 任务状态集合
+ */
+export interface TeamTasksState {
+    tasks: Record<string, InProcessTeammateTask>;
+}
+/**
+ * 获取当前 Teammate 上下文
+ * 对齐官方 uk() 函数
+ */
+export declare function getTeammateContext(): TeammateContext | undefined;
+/**
+ * 创建 Teammate 上下文并在其中运行回调
+ * 对齐官方 x86() / runWithTeammateContext()
+ */
+export declare function runWithTeammateContext<T>(context: TeammateContext, callback: () => T): T;
+/**
+ * 创建 Teammate 上下文
+ * 对齐官方 b86() / createTeammateContext()
+ */
+export declare function createTeammateContext(params: {
+    agentId: string;
+    agentName: string;
+    teamName: string;
+    color?: string;
+    planModeRequired?: boolean;
+    parentSessionId?: string;
+    agentType?: 'teammate' | 'subagent';
+    leadAgentId?: string;
+}): TeammateContext;
+/**
+ * 获取 Team 名称
+ * 对齐官方 u5() / getTeamName()
+ */
+export declare function getTeamName(fallback?: {
+    teamName?: string;
+}): string | undefined;
+/**
+ * 获取 Agent ID
+ * 对齐官方 z0() / getAgentId()
+ */
+export declare function getAgentId(): string | undefined;
+/**
+ * 获取 Agent 名称
+ * 对齐官方 T9() / getAgentName()
+ */
+export declare function getAgentName(): string | undefined;
+/**
+ * 获取父会话 ID
+ * 对齐官方 Yn() / getParentSessionId()
+ */
+export declare function getParentSessionId(): string | undefined;
+/**
+ * 获取 Teammate 颜色
+ * 对齐官方 hO() / getTeammateColor()
+ */
+export declare function getTeammateColor(): string | undefined;
+/**
+ * 是否是 Teammate
+ * 对齐官方 rz() / isTeammate()
+ */
+export declare function isTeammate(): boolean;
+/**
+ * 是否是 Team Lead
+ * 对齐官方 cj() / isTeamLead()
+ */
+export declare function isTeamLead(options?: {
+    leadAgentId?: string;
+}): boolean;
+/**
+ * 是否是 In-Process Teammate
+ * 对齐官方 dj() / isInProcessTeammate()
+ */
+export declare function isInProcessTeammate(): boolean;
+/**
+ * 是否需要 Plan 模式
+ * 对齐官方 mL1() / isPlanModeRequired()
+ */
+export declare function isPlanModeRequired(): boolean;
+/**
+ * 获取动态 Team 上下文
+ * 对齐官方 BL1() / getDynamicTeamContext()
+ */
+export declare function getDynamicTeamContext(): TeammateContext | null;
+/**
+ * 设置动态 Team 上下文
+ * 对齐官方 jT5() / setDynamicTeamContext()
+ */
+export declare function setDynamicTeamContext(context: TeammateContext | null): void;
+/**
+ * 清空动态 Team 上下文
+ * 对齐官方 MT5() / clearDynamicTeamContext()
+ */
+export declare function clearDynamicTeamContext(): void;
+/**
+ * 检查是否有活跃的 In-Process Teammates
+ * 对齐官方 u86() / hasActiveInProcessTeammates()
+ */
+export declare function hasActiveInProcessTeammates(state: TeamTasksState): boolean;
+/**
+ * 检查是否有正在工作的 In-Process Teammates
+ * 对齐官方 k6A() / hasWorkingInProcessTeammates()
+ */
+export declare function hasWorkingInProcessTeammates(state: TeamTasksState): boolean;
+/**
+ * 等待 Teammates 变为 Idle
+ * 对齐官方 L6A() / waitForTeammatesToBecomeIdle()
+ */
+export declare function waitForTeammatesToBecomeIdle(updateFn: (updater: (state: TeamTasksState) => TeamTasksState) => void, state: TeamTasksState): Promise<void>;
+/**
+ * 检查 Agent Teams 功能是否启用
+ * 对齐官方 F8() 函数
+ *
+ * 需要 AXON_EXPERIMENTAL_AGENT_TEAMS=1 环境变量
+ */
+export declare function isAgentTeamsEnabled(): boolean;
+/**
+ * 分配下一个 Teammate 颜色
+ */
+export declare function allocateTeammateColor(): string;
+//# sourceMappingURL=teammate-context.d.ts.map

package/dist/agents/teammate-context.d.ts.map

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

package/dist/agents/teammate-context.js

@@ -0,0 +1,272 @@
+/**
+ * Agent Teams - Teammate Context 管理
+ * 对齐官方 v2.1.32 实现
+ *
+ * 使用 AsyncLocalStorage 管理 Teammate 上下文
+ * 官方源码：cli.js 中的 R6A 对象（teammate API 导出）
+ *
+ * 环境变量: AXON_EXPERIMENTAL_AGENT_TEAMS=1
+ */
+import { AsyncLocalStorage } from 'async_hooks';
+// ============================================================================
+// AsyncLocalStorage 上下文（对齐官方 E6A）
+// ============================================================================
+/**
+ * Teammate 上下文存储
+ * 使用 AsyncLocalStorage 实现，确保在异步调用链中正确传播
+ */
+const teammateContextStorage = new AsyncLocalStorage();
+/**
+ * 动态 Team 上下文（全局备用）
+ * 当 AsyncLocalStorage 不可用时使用
+ * 对齐官方 ET 变量
+ */
+let dynamicTeamContext = null;
+// ============================================================================
+// 核心 API（对齐官方 R6A 导出）
+// ============================================================================
+/**
+ * 获取当前 Teammate 上下文
+ * 对齐官方 uk() 函数
+ */
+export function getTeammateContext() {
+    return teammateContextStorage.getStore();
+}
+/**
+ * 创建 Teammate 上下文并在其中运行回调
+ * 对齐官方 x86() / runWithTeammateContext()
+ */
+export function runWithTeammateContext(context, callback) {
+    return teammateContextStorage.run(context, callback);
+}
+/**
+ * 创建 Teammate 上下文
+ * 对齐官方 b86() / createTeammateContext()
+ */
+export function createTeammateContext(params) {
+    return {
+        agentId: params.agentId,
+        agentName: params.agentName,
+        teamName: params.teamName,
+        color: params.color,
+        planModeRequired: params.planModeRequired ?? false,
+        parentSessionId: params.parentSessionId,
+        agentType: params.agentType ?? 'teammate',
+        leadAgentId: params.leadAgentId,
+    };
+}
+/**
+ * 获取 Team 名称
+ * 对齐官方 u5() / getTeamName()
+ */
+export function getTeamName(fallback) {
+    const ctx = getTeammateContext();
+    if (ctx)
+        return ctx.teamName;
+    if (dynamicTeamContext?.teamName)
+        return dynamicTeamContext.teamName;
+    return fallback?.teamName;
+}
+/**
+ * 获取 Agent ID
+ * 对齐官方 z0() / getAgentId()
+ */
+export function getAgentId() {
+    const ctx = getTeammateContext();
+    if (ctx)
+        return ctx.agentId;
+    return dynamicTeamContext?.agentId;
+}
+/**
+ * 获取 Agent 名称
+ * 对齐官方 T9() / getAgentName()
+ */
+export function getAgentName() {
+    const ctx = getTeammateContext();
+    if (ctx)
+        return ctx.agentName;
+    return dynamicTeamContext?.agentName;
+}
+/**
+ * 获取父会话 ID
+ * 对齐官方 Yn() / getParentSessionId()
+ */
+export function getParentSessionId() {
+    const ctx = getTeammateContext();
+    if (ctx)
+        return ctx.parentSessionId;
+    return dynamicTeamContext?.parentSessionId;
+}
+/**
+ * 获取 Teammate 颜色
+ * 对齐官方 hO() / getTeammateColor()
+ */
+export function getTeammateColor() {
+    const ctx = getTeammateContext();
+    if (ctx)
+        return ctx.color;
+    return dynamicTeamContext?.color;
+}
+/**
+ * 是否是 Teammate
+ * 对齐官方 rz() / isTeammate()
+ */
+export function isTeammate() {
+    if (getTeammateContext())
+        return true;
+    return !!(dynamicTeamContext?.agentId && dynamicTeamContext?.teamName);
+}
+/**
+ * 是否是 Team Lead
+ * 对齐官方 cj() / isTeamLead()
+ */
+export function isTeamLead(options) {
+    if (!options?.leadAgentId)
+        return false;
+    const myId = getAgentId();
+    const leadId = options.leadAgentId;
+    if (myId === leadId)
+        return true;
+    if (!myId)
+        return true; // 如果没有 agent ID，默认是 lead
+    return false;
+}
+/**
+ * 是否是 In-Process Teammate
+ * 对齐官方 dj() / isInProcessTeammate()
+ */
+export function isInProcessTeammate() {
+    const ctx = getTeammateContext();
+    return ctx?.agentType === 'teammate';
+}
+/**
+ * 是否需要 Plan 模式
+ * 对齐官方 mL1() / isPlanModeRequired()
+ */
+export function isPlanModeRequired() {
+    const ctx = getTeammateContext();
+    if (ctx)
+        return ctx.planModeRequired ?? false;
+    if (dynamicTeamContext !== null)
+        return dynamicTeamContext.planModeRequired ?? false;
+    return process.env.AXON_PLAN_MODE_REQUIRED === 'true';
+}
+/**
+ * 获取动态 Team 上下文
+ * 对齐官方 BL1() / getDynamicTeamContext()
+ */
+export function getDynamicTeamContext() {
+    return dynamicTeamContext;
+}
+/**
+ * 设置动态 Team 上下文
+ * 对齐官方 jT5() / setDynamicTeamContext()
+ */
+export function setDynamicTeamContext(context) {
+    dynamicTeamContext = context;
+}
+/**
+ * 清空动态 Team 上下文
+ * 对齐官方 MT5() / clearDynamicTeamContext()
+ */
+export function clearDynamicTeamContext() {
+    dynamicTeamContext = null;
+}
+/**
+ * 检查是否有活跃的 In-Process Teammates
+ * 对齐官方 u86() / hasActiveInProcessTeammates()
+ */
+export function hasActiveInProcessTeammates(state) {
+    for (const task of Object.values(state.tasks)) {
+        if (task.type === 'in_process_teammate' && task.status === 'running') {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * 检查是否有正在工作的 In-Process Teammates
+ * 对齐官方 k6A() / hasWorkingInProcessTeammates()
+ */
+export function hasWorkingInProcessTeammates(state) {
+    for (const task of Object.values(state.tasks)) {
+        if (task.type === 'in_process_teammate' && task.status === 'running' && !task.isIdle) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * 等待 Teammates 变为 Idle
+ * 对齐官方 L6A() / waitForTeammatesToBecomeIdle()
+ */
+export function waitForTeammatesToBecomeIdle(updateFn, state) {
+    const activeIds = [];
+    for (const [id, task] of Object.entries(state.tasks)) {
+        if (task.type === 'in_process_teammate' && task.status === 'running' && !task.isIdle) {
+            activeIds.push(id);
+        }
+    }
+    if (activeIds.length === 0)
+        return Promise.resolve();
+    return new Promise((resolve) => {
+        let remaining = activeIds.length;
+        const onIdle = () => {
+            remaining--;
+            if (remaining === 0)
+                resolve();
+        };
+        updateFn((currentState) => {
+            const tasks = { ...currentState.tasks };
+            for (const id of activeIds) {
+                const task = tasks[id];
+                if (task && task.type === 'in_process_teammate') {
+                    if (task.isIdle) {
+                        onIdle();
+                    }
+                    else {
+                        tasks[id] = {
+                            ...task,
+                            onIdleCallbacks: [...(task.onIdleCallbacks ?? []), onIdle],
+                        };
+                    }
+                }
+            }
+            return { ...currentState, tasks };
+        });
+    });
+}
+// ============================================================================
+// 功能开关
+// ============================================================================
+/**
+ * 检查 Agent Teams 功能是否启用
+ * 对齐官方 F8() 函数
+ *
+ * 需要 AXON_EXPERIMENTAL_AGENT_TEAMS=1 环境变量
+ */
+export function isAgentTeamsEnabled() {
+    const envValue = process.env.AXON_EXPERIMENTAL_AGENT_TEAMS;
+    if (!envValue)
+        return false;
+    // 支持 '1', 'true', 'yes' 等
+    return ['1', 'true', 'yes'].includes(envValue.toLowerCase());
+}
+// ============================================================================
+// Teammate 颜色分配
+// ============================================================================
+const TEAMMATE_COLORS = [
+    '#FF6B6B', '#4ECDC4', '#45B7D1', '#96CEB4',
+    '#FFEAA7', '#DDA0DD', '#98D8C8', '#F7DC6F',
+    '#BB8FCE', '#85C1E9', '#82E0AA', '#F8C471',
+];
+let colorIndex = 0;
+/**
+ * 分配下一个 Teammate 颜色
+ */
+export function allocateTeammateColor() {
+    const color = TEAMMATE_COLORS[colorIndex % TEAMMATE_COLORS.length];
+    colorIndex++;
+    return color;
+}
+//# sourceMappingURL=teammate-context.js.map

package/dist/agents/teammate-context.js.map

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

package/dist/agents/tools.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 代理工具配置与过滤
+ *
+ * 定义各 Agent 类型的工具访问权限
+ */
+import { ToolDefinition } from '../types/index.js';
+export interface AgentToolConfig {
+    agentType: string;
+    allowedTools: string[] | '*';
+    disallowedTools?: string[];
+    permissionLevel?: 'readonly' | 'standard' | 'elevated';
+    customRestrictions?: ToolRestriction[];
+}
+export interface ToolRestriction {
+    toolName: string;
+    type: 'scope';
+    rule: ScopeRestriction;
+}
+export interface ScopeRestriction {
+    allowedPaths?: string[];
+    disallowedPaths?: string[];
+    allowedCommands?: RegExp[];
+    disallowedCommands?: RegExp[];
+}
+export declare const AGENT_TOOL_CONFIGS: Record<string, AgentToolConfig>;
+/**
+ * 根据 AgentToolConfig 过滤工具
+ */
+export declare function getToolsForAgent(agentType: string): ToolDefinition[];
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/agents/tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAKnD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;IACvD,kBAAkB,CAAC,EAAE,eAAe,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAID,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAuF9D,CAAC;AAIF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE,CAqBpE"}

package/dist/agents/tools.js

@@ -0,0 +1,116 @@
+/**
+ * 代理工具配置与过滤
+ *
+ * 定义各 Agent 类型的工具访问权限
+ */
+import { toolRegistry } from '../tools/base.js';
+// ============ 预定义代理配置 ============
+export const AGENT_TOOL_CONFIGS = {
+    'general-purpose': {
+        agentType: 'general-purpose',
+        allowedTools: '*',
+        permissionLevel: 'standard',
+    },
+    'statusline-setup': {
+        agentType: 'statusline-setup',
+        allowedTools: ['Read', 'Edit', 'AskUserQuestion'],
+        permissionLevel: 'standard',
+    },
+    'Explore': {
+        agentType: 'Explore',
+        allowedTools: '*',
+        permissionLevel: 'readonly',
+        customRestrictions: [
+            {
+                toolName: 'Bash',
+                type: 'scope',
+                rule: {
+                    allowedCommands: [
+                        /^git\s+(status|diff|log|show)/,
+                        /^ls(\s|$)/,
+                        /^cat(\s|$)/,
+                        /^head(\s|$)/,
+                        /^tail(\s|$)/,
+                    ],
+                },
+            },
+        ],
+    },
+    'Plan': {
+        agentType: 'Plan',
+        allowedTools: '*',
+        permissionLevel: 'elevated',
+    },
+    'axon-guide': {
+        agentType: 'axon-guide',
+        allowedTools: ['Glob', 'Grep', 'Read', 'WebFetch', 'WebSearch', 'AskUserQuestion'],
+        permissionLevel: 'readonly',
+    },
+    'code-reviewer': {
+        agentType: 'code-reviewer',
+        allowedTools: ['Bash', 'Glob', 'Grep', 'Read', 'Task', 'AskUserQuestion'],
+        permissionLevel: 'readonly',
+        customRestrictions: [
+            {
+                toolName: 'Bash',
+                type: 'scope',
+                rule: {
+                    allowedCommands: [/^git\s+(diff|status|log|show|remote\s+show)/],
+                },
+            },
+        ],
+    },
+    // ============ Blueprint 多 Agent 系统专用配置 ============
+    // 以下配置仅在 Web 模式下有效，需先调用 registerBlueprintTools()
+    'chat-tab-agent': {
+        agentType: 'chat-tab-agent',
+        allowedTools: '*',
+        // Chat Tab (planner 主 agent) 排除不属于当前角色的工具
+        disallowedTools: [
+            'Blueprint', // CLI 模式工具，Chat Tab 使用 GenerateBlueprint
+            'UpdateTaskPlan', // LeadAgent 专用 - 更新执行计划中的任务状态
+            'DispatchWorker', // LeadAgent 专用 - 派发任务给 Worker 执行
+        ],
+        permissionLevel: 'standard',
+    },
+    'lead-agent': {
+        agentType: 'lead-agent',
+        allowedTools: [
+            'Bash', 'Read', 'Write', 'Edit', 'Glob', 'Grep',
+            'UpdateTaskPlan', 'DispatchWorker',
+            'AskUserQuestion', 'Database',
+        ],
+        permissionLevel: 'elevated',
+    },
+    'worker': {
+        agentType: 'worker',
+        allowedTools: [
+            'Bash', 'Read', 'Write', 'Edit', 'Glob', 'Grep',
+            'AskUserQuestion', 'Database',
+        ],
+        permissionLevel: 'standard',
+    },
+};
+// ============ 工具过滤器 ============
+/**
+ * 根据 AgentToolConfig 过滤工具
+ */
+export function getToolsForAgent(agentType) {
+    const config = AGENT_TOOL_CONFIGS[agentType];
+    if (!config) {
+        return toolRegistry.getDefinitions();
+    }
+    let tools = toolRegistry.getDefinitions();
+    // 白名单过滤
+    if (config.allowedTools !== '*') {
+        const allowed = new Set(config.allowedTools);
+        tools = tools.filter(t => allowed.has(t.name));
+    }
+    // 黑名单过滤
+    if (config.disallowedTools) {
+        const disallowed = new Set(config.disallowedTools);
+        tools = tools.filter(t => !disallowed.has(t.name));
+    }
+    return tools;
+}
+//# sourceMappingURL=tools.js.map

package/dist/agents/tools.js.map

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