@seandong/seno 0.1.0

package/README.md

@@ -0,0 +1,70 @@
+# SENO
+
+ONES 企业内部 AI Agent CLI
+
+## 快速开始
+
+### 环境要求
+
+- [Bun](https://bun.sh) >= 1.0
+
+### 安装
+
+```bash
+git clone <repo-url>
+cd ones-agent-cli
+bun install
+bun link
+```
+
+### 初始化
+
+```bash
+seno init
+```
+
+按照交互提示完成配置：
+
+1. 选择 LLM Provider
+2. 配置授权（OAuth 或 API Key）
+3. 选择模型
+4. 输入 ONES MCP URL
+
+配置文件保存在 `~/.seno/config.json`。
+
+### 使用
+
+```bash
+seno
+```
+
+启动后直接输入自然语言与 AI 对话。输入 `/` 查看可用命令。
+
+## 核心能力
+
+- **运维自动化** — 通过内置 Skills 执行 ONES 安装、升级、备份、巡检等运维操作，支持 SSH 远程执行
+- **插件开发** — 一键初始化 ONES 插件项目，自动检查环境依赖，提供开发文档参考
+- **知识检索** — 智能检索企业内部 Wiki、运维手册、开发者文档、通用技术文档
+- **ONES 协作** — 通过 MCP 直接操作 ONES 平台：任务管理、项目协作、Wiki、工时记录
+
+## 命令参考
+
+| 命令 | 说明 |
+|------|------|
+| `/help` | 显示帮助信息 |
+| `/skills list` | 列出所有 Skills |
+| `/skills sync` | 手动同步远程 Skills |
+| `/server list` | 列出所有 SSH 服务器 |
+| `/server add` | 添加新服务器 |
+| `/server remove <name>` | 删除指定服务器 |
+| `/plugin init` | 初始化新插件项目 |
+| `/model set` | 切换 Provider 和模型 |
+| `/model auth` | 配置 Provider 授权 |
+| `/clear` | 清空对话历史 |
+| `/exit` | 退出 |
+
+## 更多文档
+
+- [产品介绍](docs/product-intro.md)
+- [架构规范](docs/architecture/ones-agent-cli-spec.md)
+- [命令系统](docs/cli/command-system.md)

package/dist/agent/conversation.d.ts

@@ -0,0 +1,39 @@
+import type { Message, ContentBlock } from '../llm/types.js';
+/**
+ * 对话历史管理器
+ * 维护 LLM 对话上下文，格式兼容 Anthropic API
+ */
+export declare class Conversation {
+    private messages;
+    /**
+     * 添加用户消息
+     */
+    addUserMessage(text: string): void;
+    /**
+     * 添加助手消息（可包含文本和工具调用）
+     */
+    addAssistantMessage(content: ContentBlock[]): void;
+    /**
+     * 添加工具执行结果
+     * 多个工具结果合并到同一个 user 消息中（Anthropic API 要求）
+     */
+    addToolResults(results: Array<{
+        toolUseId: string;
+        content: string;
+        isError?: boolean;
+    }>): void;
+    /**
+     * 获取完整消息历史（传给 LLM）
+     */
+    getMessages(): Message[];
+    /**
+     * 截断历史消息，保留最近 keepRecent 条
+     * 用于 context length exceeded 时自动恢复
+     * @returns true 表示成功截断，false 表示已无法再截断
+     */
+    truncate(keepRecent?: number): boolean;
+    /**
+     * 清空历史
+     */
+    clear(): void;
+}

package/dist/agent/conversation.js

@@ -0,0 +1,60 @@
+/**
+ * 对话历史管理器
+ * 维护 LLM 对话上下文，格式兼容 Anthropic API
+ */
+export class Conversation {
+    messages = [];
+    /**
+     * 添加用户消息
+     */
+    addUserMessage(text) {
+        this.messages.push({ role: 'user', content: text });
+    }
+    /**
+     * 添加助手消息（可包含文本和工具调用）
+     */
+    addAssistantMessage(content) {
+        this.messages.push({ role: 'assistant', content });
+    }
+    /**
+     * 添加工具执行结果
+     * 多个工具结果合并到同一个 user 消息中（Anthropic API 要求）
+     */
+    addToolResults(results) {
+        const toolResultBlocks = results.map((r) => ({
+            type: 'tool_result',
+            tool_use_id: r.toolUseId,
+            content: r.content,
+            is_error: r.isError,
+        }));
+        this.messages.push({ role: 'user', content: toolResultBlocks });
+    }
+    /**
+     * 获取完整消息历史（传给 LLM）
+     */
+    getMessages() {
+        return [...this.messages];
+    }
+    /**
+     * 截断历史消息，保留最近 keepRecent 条
+     * 用于 context length exceeded 时自动恢复
+     * @returns true 表示成功截断，false 表示已无法再截断
+     */
+    truncate(keepRecent = 6) {
+        if (this.messages.length <= keepRecent)
+            return false;
+        this.messages = this.messages.slice(-keepRecent);
+        // 确保首条消息是 user 角色（Anthropic API 要求）
+        while (this.messages.length > 0 && this.messages[0].role !== 'user') {
+            this.messages.shift();
+        }
+        return this.messages.length > 0;
+    }
+    /**
+     * 清空历史
+     */
+    clear() {
+        this.messages = [];
+    }
+}
+//# sourceMappingURL=conversation.js.map

package/dist/agent/conversation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.js","sourceRoot":"","sources":["../../src/agent/conversation.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,YAAY;IACf,QAAQ,GAAc,EAAE,CAAC;IAEjC;;OAEG;IACH,cAAc,CAAC,IAAY;QACzB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,OAAuB;QACzC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;IACrD,CAAC;IAED;;;OAGG;IACH,cAAc,CACZ,OAIE;QAEF,MAAM,gBAAgB,GAAsB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9D,IAAI,EAAE,aAAsB;YAC5B,WAAW,EAAE,CAAC,CAAC,SAAS;YACxB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,QAAQ,EAAE,CAAC,CAAC,OAAO;SACpB,CAAC,CAAC,CAAC;QAEJ,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,aAAqB,CAAC;QAC7B,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,UAAU;YAAE,OAAO,KAAK,CAAC;QACrD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC;QACjD,oCAAoC;QACpC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACpE,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACrB,CAAC;CACF"}

package/dist/agent/loop.d.ts

@@ -0,0 +1,41 @@
+import type { LLMProvider } from '../llm/provider.js';
+import type { StreamEvent, ChatOptions } from '../llm/types.js';
+import type { ToolRegistry } from '../tools/registry.js';
+import type { SessionState } from './session.js';
+/**
+ * Agent 核心循环（ReAct 模式）
+ *
+ * 接收用户输入 → 调用 LLM → 执行工具 → 反馈结果 → 循环直到 LLM 结束
+ */
+export declare class AgentLoop {
+    private conversation;
+    private toolRegistry;
+    private llmProvider;
+    private baseSystemPrompt;
+    private chatOptions;
+    private session;
+    constructor(params: {
+        llmProvider: LLMProvider;
+        toolRegistry: ToolRegistry;
+        systemPrompt?: string;
+        chatOptions?: ChatOptions;
+        session?: SessionState;
+    });
+    /**
+     * 动态构建 system prompt
+     * 将 session 上下文追加到基础 prompt 后
+     */
+    private buildSystemPrompt;
+    /**
+     * 运行时热切换 LLM Provider 和模型
+     */
+    updateProvider(provider: LLMProvider, model: string): void;
+    /**
+     * 清空对话历史（/clear 命令使用）
+     */
+    clearHistory(): void;
+    /**
+     * 处理用户输入，返回事件流供 REPL 消费
+     */
+    run(userInput: string): AsyncGenerator<StreamEvent>;
+}

package/dist/agent/loop.js

@@ -0,0 +1,203 @@
+import { Conversation } from './conversation.js';
+import { logger } from '../cli/logger.js';
+import { LLMError } from '../errors.js';
+const MAX_ITERATIONS = 20;
+/**
+ * Agent 核心循环（ReAct 模式）
+ *
+ * 接收用户输入 → 调用 LLM → 执行工具 → 反馈结果 → 循环直到 LLM 结束
+ */
+export class AgentLoop {
+    conversation;
+    toolRegistry;
+    llmProvider;
+    baseSystemPrompt;
+    chatOptions;
+    session;
+    constructor(params) {
+        this.conversation = new Conversation();
+        this.toolRegistry = params.toolRegistry;
+        this.llmProvider = params.llmProvider;
+        this.baseSystemPrompt = params.systemPrompt || '';
+        this.chatOptions = params.chatOptions || {};
+        this.session = params.session || null;
+    }
+    /**
+     * 动态构建 system prompt
+     * 将 session 上下文追加到基础 prompt 后
+     */
+    buildSystemPrompt() {
+        const sessionSection = this.session?.toPromptSection() || '';
+        if (!sessionSection)
+            return this.baseSystemPrompt;
+        return this.baseSystemPrompt + '\n\n' + sessionSection;
+    }
+    /**
+     * 运行时热切换 LLM Provider 和模型
+     */
+    updateProvider(provider, model) {
+        this.llmProvider = provider;
+        this.chatOptions = { ...this.chatOptions, model };
+    }
+    /**
+     * 清空对话历史（/clear 命令使用）
+     */
+    clearHistory() {
+        this.conversation.clear();
+        this.session?.clearConversation();
+    }
+    /**
+     * 处理用户输入，返回事件流供 REPL 消费
+     */
+    async *run(userInput) {
+        this.session?.incrementTurn();
+        this.session?.checkUserInput(userInput);
+        this.conversation.addUserMessage(userInput);
+        for (let iteration = 0; iteration < MAX_ITERATIONS; iteration++) {
+            // 通知 REPL：新一轮 LLM 调用开始
+            yield { type: 'turn_start' };
+            // 累积文本和工具调用，用于重建助手消息
+            let accumulatedText = '';
+            const toolCalls = [];
+            let currentToolId = '';
+            let currentToolName = '';
+            let currentInputJson = '';
+            // 调用 LLM 并转发流式事件
+            const stream = this.llmProvider.chat(this.conversation.getMessages(), this.toolRegistry.getToolDefinitions(), {
+                ...this.chatOptions,
+                system: this.buildSystemPrompt() || undefined,
+            });
+            let shouldRetryWithTruncation = false;
+            for await (const event of stream) {
+                switch (event.type) {
+                    case 'text_delta':
+                        accumulatedText += event.text;
+                        yield event;
+                        break;
+                    case 'tool_use_start':
+                        currentToolId = event.id;
+                        currentToolName = event.name;
+                        currentInputJson = '';
+                        yield event;
+                        break;
+                    case 'tool_use_delta':
+                        currentInputJson += event.input_json;
+                        break;
+                    case 'tool_use_end':
+                        toolCalls.push({
+                            id: currentToolId,
+                            name: currentToolName,
+                            inputJson: currentInputJson,
+                        });
+                        yield event;
+                        break;
+                    case 'message_end':
+                        yield event;
+                        break;
+                    case 'error': {
+                        // Context length exceeded → 截断历史并重试
+                        if (event.error instanceof LLMError &&
+                            event.error.statusCode === 400 &&
+                            (event.error.message.includes('context') ||
+                                event.error.message.includes('too long') ||
+                                event.error.message.includes('max tokens') ||
+                                event.error.message.includes('too many'))) {
+                            const truncated = this.conversation.truncate();
+                            if (truncated) {
+                                logger.debug('agent', 'Context length exceeded, truncated conversation history, retrying...');
+                                yield {
+                                    type: 'text_delta',
+                                    text: '\n[对话历史过长，已自动截断，正在重试...]\n',
+                                };
+                                shouldRetryWithTruncation = true;
+                                break;
+                            }
+                        }
+                        yield event;
+                        return;
+                    }
+                }
+            }
+            // 截断后重试：跳到外层 for 循环下一轮
+            if (shouldRetryWithTruncation) {
+                continue;
+            }
+            // 重建助手消息并保存到对话历史
+            const contentBlocks = [];
+            if (accumulatedText) {
+                contentBlocks.push({ type: 'text', text: accumulatedText });
+            }
+            for (const call of toolCalls) {
+                let input = {};
+                try {
+                    input = call.inputJson ? JSON.parse(call.inputJson) : {};
+                }
+                catch {
+                    // 解析失败时用空对象
+                }
+                const block = {
+                    type: 'tool_use',
+                    id: call.id,
+                    name: call.name,
+                    input,
+                };
+                contentBlocks.push(block);
+            }
+            if (contentBlocks.length > 0) {
+                this.conversation.addAssistantMessage(contentBlocks);
+            }
+            // 无工具调用 → 对话结束
+            if (toolCalls.length === 0) {
+                return;
+            }
+            // 执行所有工具并收集结果
+            const toolResults = [];
+            for (const call of toolCalls) {
+                let args = {};
+                try {
+                    args = call.inputJson ? JSON.parse(call.inputJson) : {};
+                }
+                catch {
+                    toolResults.push({
+                        toolUseId: call.id,
+                        content: `工具参数解析失败: ${call.inputJson}`,
+                        isError: true,
+                    });
+                    continue;
+                }
+                yield { type: 'tool_execute_start', name: call.name, args };
+                const toolStart = Date.now();
+                const result = await this.toolRegistry.executeTool(call.name, args);
+                const toolDuration = Date.now() - toolStart;
+                logger.debug('tool', `${call.name} completed in ${toolDuration}ms`);
+                // 观察工具执行结果，更新会话状态
+                this.session?.observe(call.name, args, result);
+                const maxResultLen = 500;
+                const resultSummary = result.content.length > maxResultLen
+                    ? result.content.slice(0, maxResultLen) + '…'
+                    : result.content;
+                yield {
+                    type: 'tool_execute_end',
+                    name: call.name,
+                    result: resultSummary,
+                    isError: result.isError,
+                };
+                toolResults.push({
+                    toolUseId: call.id,
+                    content: result.content,
+                    isError: result.isError,
+                });
+            }
+            // 工具结果添加到对话历史
+            this.conversation.addToolResults(toolResults);
+            // 继续循环：带工具结果再次调用 LLM
+        }
+        // 达到最大循环次数
+        yield {
+            type: 'text_delta',
+            text: '\n[已达到最大工具调用轮次，停止处理]',
+        };
+        yield { type: 'message_end', stop_reason: 'end_turn' };
+    }
+}
+//# sourceMappingURL=loop.js.map

package/dist/agent/loop.js.map

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

package/dist/agent/session.d.ts

@@ -0,0 +1,63 @@
+import type { UserInfo } from '../mcp/manager.js';
+import type { SshServerConfig } from '../config/types.js';
+/**
+ * 会话级别状态管理
+ *
+ * 在同一会话内记忆上下文信息（SSH 连接、Skill 执行状态等），
+ * 通过观察工具执行结果自动更新状态，并注入到每次 LLM 调用的 system prompt。
+ *
+ * 仅内存维护，不持久化。会话结束自动清理。
+ */
+export declare class SessionState {
+    /** 用户身份（不可变，来自 MCP who_am_i） */
+    readonly user: UserInfo | null;
+    /** 预配置的 SSH 服务器列表 */
+    private servers;
+    /** 匹配到服务器名称时注入的 prompt 段落 */
+    private sshServersHint;
+    /** 最近使用的 SSH host */
+    currentHost: string | null;
+    /** 当前活跃的 SSH 连接 */
+    activeConnections: Set<string>;
+    /** 当前正在执行的 Skill name */
+    activeSkill: string | null;
+    /** 当前 Skill 执行阶段 */
+    skillPhase: string | null;
+    /** 对话轮数 */
+    conversationTurns: number;
+    /** 最后活动时间 */
+    lastActivity: Date;
+    constructor(user: UserInfo | null, servers?: SshServerConfig[]);
+    /**
+     * 每轮用户输入时调用
+     */
+    incrementTurn(): void;
+    /** SSH 相关关键词，匹配到任一即注入服务器列表 */
+    private static readonly SSH_KEYWORDS;
+    /**
+     * 检查用户输入是否涉及 SSH 操作
+     * 匹配服务器名称或 SSH 关键词时，注入服务器列表到 system prompt
+     */
+    checkUserInput(input: string): void;
+    /**
+     * 观察工具执行结果，自动更新会话状态
+     *
+     * 在 loop.ts 工具执行后调用，根据 toolName 和结果更新 session state。
+     */
+    observe(toolName: string, args: Record<string, unknown>, result: {
+        content: string;
+        isError?: boolean;
+    }): void;
+    /**
+     * /clear 时部分重置
+     * 保留 user（身份不变），清除动态上下文
+     */
+    clearConversation(): void;
+    /**
+     * 生成 system prompt 注入段落
+     *
+     * 无状态时返回空字符串（不污染 prompt）。
+     * 有状态时返回 "## 当前会话上下文" 段落。
+     */
+    toPromptSection(): string;
+}

package/dist/agent/session.js

@@ -0,0 +1,135 @@
+/**
+ * 会话级别状态管理
+ *
+ * 在同一会话内记忆上下文信息（SSH 连接、Skill 执行状态等），
+ * 通过观察工具执行结果自动更新状态，并注入到每次 LLM 调用的 system prompt。
+ *
+ * 仅内存维护，不持久化。会话结束自动清理。
+ */
+export class SessionState {
+    /** 用户身份（不可变，来自 MCP who_am_i） */
+    user;
+    /** 预配置的 SSH 服务器列表 */
+    servers;
+    /** 匹配到服务器名称时注入的 prompt 段落 */
+    sshServersHint = null;
+    /** 最近使用的 SSH host */
+    currentHost = null;
+    /** 当前活跃的 SSH 连接 */
+    activeConnections = new Set();
+    /** 当前正在执行的 Skill name */
+    activeSkill = null;
+    /** 当前 Skill 执行阶段 */
+    skillPhase = null;
+    /** 对话轮数 */
+    conversationTurns = 0;
+    /** 最后活动时间 */
+    lastActivity = new Date();
+    constructor(user, servers = []) {
+        this.user = user;
+        this.servers = servers;
+    }
+    /**
+     * 每轮用户输入时调用
+     */
+    incrementTurn() {
+        this.conversationTurns++;
+        this.lastActivity = new Date();
+    }
+    /** SSH 相关关键词，匹配到任一即注入服务器列表 */
+    static SSH_KEYWORDS = [
+        '连接',
+        '服务器',
+        'ssh',
+        '远程',
+        '登录',
+    ];
+    /**
+     * 检查用户输入是否涉及 SSH 操作
+     * 匹配服务器名称或 SSH 关键词时，注入服务器列表到 system prompt
+     */
+    checkUserInput(input) {
+        if (this.servers.length === 0)
+            return;
+        const lowerInput = input.toLowerCase();
+        const matchedByName = this.servers.some((s) => lowerInput.includes(s.name.toLowerCase()));
+        const matchedByKeyword = SessionState.SSH_KEYWORDS.some((kw) => lowerInput.includes(kw));
+        if (matchedByName || matchedByKeyword) {
+            const rows = this.servers.map((s) => `| ${s.name} | ${s.host} | ${s.description || '-'} |`);
+            this.sshServersHint = [
+                '## 可用 SSH 服务器',
+                '',
+                '当用户提到连接服务器或在服务器上执行命令时，使用 ssh_execute 工具，将 host 参数设置为下表中的服务器名称（必须精确匹配）。',
+                '',
+                '| 名称 | 地址 | 说明 |',
+                '|------|------|------|',
+                ...rows,
+            ].join('\n');
+        }
+    }
+    /**
+     * 观察工具执行结果，自动更新会话状态
+     *
+     * 在 loop.ts 工具执行后调用，根据 toolName 和结果更新 session state。
+     */
+    observe(toolName, args, result) {
+        this.lastActivity = new Date();
+        // SSH host 记忆：成功执行 ssh_execute 后记录 host
+        if (toolName === 'ssh_execute' && !result.isError) {
+            const host = args.host;
+            if (host) {
+                this.currentHost = host;
+                this.activeConnections.add(host);
+            }
+        }
+        // Skill 加载追踪：load_skill 成功后记录 skill 名称
+        if (toolName === 'load_skill' && !result.isError) {
+            const skillName = args.name;
+            if (skillName) {
+                this.activeSkill = skillName;
+                this.skillPhase = 'loaded';
+            }
+        }
+    }
+    /**
+     * /clear 时部分重置
+     * 保留 user（身份不变），清除动态上下文
+     */
+    clearConversation() {
+        this.currentHost = null;
+        this.activeConnections.clear();
+        this.activeSkill = null;
+        this.skillPhase = null;
+        this.conversationTurns = 0;
+    }
+    /**
+     * 生成 system prompt 注入段落
+     *
+     * 无状态时返回空字符串（不污染 prompt）。
+     * 有状态时返回 "## 当前会话上下文" 段落。
+     */
+    toPromptSection() {
+        const lines = [];
+        if (this.currentHost) {
+            lines.push(`当前 SSH 主机：${this.currentHost}`);
+            if (this.activeConnections.size > 1) {
+                const hosts = Array.from(this.activeConnections).join(', ');
+                lines.push(`活跃连接：${hosts}`);
+            }
+            lines.push('用户后续的 SSH 命令如果没有指定 host，应默认使用当前主机。');
+        }
+        if (this.activeSkill) {
+            lines.push(`当前正在执行 Skill：${this.activeSkill}`);
+            if (this.skillPhase) {
+                lines.push(`执行阶段：${this.skillPhase}`);
+            }
+        }
+        if (this.sshServersHint) {
+            lines.push(this.sshServersHint);
+        }
+        if (lines.length === 0)
+            return '';
+        return '## 当前会话上下文\n\n' + lines.join('\n');
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/agent/session.js.map

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