@onesclawkolor/onesclaw 0.1.0

package/README.md

@@ -0,0 +1,65 @@
+# onesclaw
+
+ONES 企业内部 AI Agent CLI。
+
+## Quick Start
+
+公开 npm 安装：
+
+```bash
+npm install -g @onesclawkolor/onesclaw
+onesclaw init
+onesclaw
+```
+
+或手动安装：
+
+```bash
+npm install -g @onesclawkolor/onesclaw
+onesclaw init
+onesclaw
+```
+
+公开 npm 发布使用个人 scope，例如当前账号为 `onesclawkolor` 时：
+
+```bash
+npm install -g @onesclawkolor/onesclaw
+onesclaw init
+onesclaw
+```
+
+## Requirements
+
+- Node.js >= 18
+- macOS / Linux（Windows 请使用 WSL）
+
+## Stage Gates
+
+- 路线图：`phases.md`
+- 蓝图：`docs/blueprint-v1.md`
+- 阶段门禁文档：`docs/gates/`
+- 发布运维 Runbook：`docs/operations/release-runbook.md`
+- Phase1 冲刺看板：`docs/gates/phase1-sprint-board.md`
+- Phase1 OAuth 矩阵：`docs/gates/phase1-oauth-matrix.md`
+- 核心覆盖率检查：`npm run coverage:core`
+- 运行自检：`npm run doctor`
+- 安装演练：`npm run install:rehearsal`
+- 本地预检：`npm run gate:all:local`
+- 私有发布：`npm run release:publish:private`
+- 公开发布：`npm run release:publish:public`
+- 安装入口上传：`npm run release:install:upload`
+- 远端安装验证：`npm run release:install:verify`
+- 阶段命令：
+  - `npm run gate:phase0`
+  - `npm run gate:phase1`
+  - `npm run gate:phase1:strict-dryrun`
+  - `npm run gate:phase1_5`
+  - `npm run gate:phase2`
+  - `npm run gate:phase3`
+  - `npm run gate:phase4`
+  - `npm run gate:phase4-skills`
+  - `npm run gate:phase5`
+  - `npm run gate:phase6-provider`
+  - `npm run gate:all:local`
+  - `npm run gate:all`
+- 作用域白名单强制模式：`GATE_STRICT_SCOPE=true npm run gate:phaseX`

package/dist/agent/conversation.d.ts

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

package/dist/agent/conversation.js

@@ -0,0 +1,61 @@
+// @ts-nocheck
+/**
+ * 对话历史管理器
+ * 维护 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":"AAAA,cAAc;AACd;;;GAGG;AACH,MAAM,OAAO,YAAY;IACrB,QAAQ,GAAG,EAAE,CAAC;IACd;;OAEG;IACH,cAAc,CAAC,IAAI;QACf,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;IACD;;OAEG;IACH,mBAAmB,CAAC,OAAO;QACvB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;IACvD,CAAC;IACD;;;OAGG;IACH,cAAc,CAAC,OAAO;QAClB,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzC,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,CAAC,CAAC,SAAS;YACxB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,QAAQ,EAAE,CAAC,CAAC,OAAO;SACtB,CAAC,CAAC,CAAC;QACJ,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC;IACpE,CAAC;IACD;;OAEG;IACH,WAAW;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IACD;;;;OAIG;IACH,QAAQ,CAAC,UAAU,GAAG,CAAC;QACnB,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,UAAU;YAClC,OAAO,KAAK,CAAC;QACjB,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;YAClE,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QAC1B,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IACpC,CAAC;IACD;;OAEG;IACH,KAAK;QACD,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACvB,CAAC;CACJ"}

package/dist/agent/loop.d.ts

@@ -0,0 +1,40 @@
+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 {
+    conversation: any;
+    toolRegistry: ToolRegistry;
+    llmProvider: any;
+    baseSystemPrompt: string;
+    chatOptions: ChatOptions;
+    session: SessionState | null;
+    constructor(params: {
+        llmProvider: any;
+        toolRegistry: ToolRegistry;
+        systemPrompt?: string;
+        chatOptions?: ChatOptions;
+        session?: SessionState | null;
+    });
+    /**
+     * 动态构建 system prompt
+     * 将 session 上下文追加到基础 prompt 后
+     */
+    buildSystemPrompt(): string;
+    /**
+     * 运行时热切换 LLM Provider 和模型
+     */
+    updateProvider(provider: any, model: string): void;
+    /**
+     * 清空对话历史（/clear 命令使用）
+     */
+    clearHistory(): void;
+    /**
+     * 处理用户输入，返回事件流供 REPL 消费
+     */
+    run(userInput: string): AsyncGenerator<StreamEvent, void, unknown>;
+}

package/dist/agent/loop.js

@@ -0,0 +1,213 @@
+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,
+                });
+                // SSH 执行失败时立即终止当前任务，避免继续执行后续操作
+                if (call.name === 'ssh_execute' && result.isError) {
+                    this.conversation.addToolResults(toolResults);
+                    yield {
+                        type: 'text_delta',
+                        text: '\n[ssh_execute 失败，按安全规则已停止当前任务]\n',
+                    };
+                    yield { type: 'message_end', stop_reason: 'end_turn' };
+                    return;
+                }
+            }
+            // 工具结果添加到对话历史
+            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,73 @@
+import type { MemoryStore } from '../memory/store.js';
+/**
+ * 会话级别状态管理。
+ *
+ * 在同一会话内记忆上下文信息（SSH 连接、Skill 执行状态等），
+ * 并将关键状态持久化到 SQLite，跨重启可恢复。
+ */
+export declare class SessionState {
+    /** 用户身份（不可变，来自 MCP who_am_i） */
+    user: any;
+    /** 预配置的 SSH 服务器列表 */
+    servers: any;
+    /** 持久化存储 */
+    memoryStore: MemoryStore | null;
+    scopeKey: string | null;
+    /** 匹配到服务器名称时注入的 prompt 段落 */
+    sshServersHint: any;
+    /** 最近使用的 SSH host */
+    currentHost: any;
+    /** 当前活跃的 SSH 连接 */
+    activeConnections: Set<string>;
+    /** 当前正在执行的 Skill name */
+    activeSkill: any;
+    /** 当前 Skill 执行阶段 */
+    skillPhase: any;
+    /** 最近确认/偏好 */
+    recentDecisions: string[];
+    /** 对话轮数 */
+    conversationTurns: number;
+    /** 最后活动时间 */
+    lastActivity: Date;
+    constructor(user: any, servers?: any[], options?: {});
+    static create(options: {
+        user?: {
+            id?: string;
+            name?: string;
+            email?: string;
+        } | null;
+        servers?: Array<{
+            name: string;
+            host: string;
+            description?: string;
+        }>;
+        memoryStore?: MemoryStore | null;
+        scopeKey?: string | null;
+    }): Promise<SessionState>;
+    hydrateFromMemory(): Promise<void>;
+    persistToMemory(): void;
+    /**
+     * 每轮用户输入时调用
+     */
+    incrementTurn(): void;
+    /** SSH 相关关键词，匹配到任一即注入服务器列表 */
+    static SSH_KEYWORDS: string[];
+    /**
+     * 检查用户输入是否涉及 SSH 操作
+     * 匹配服务器名称或 SSH 关键词时，注入服务器列表到 system prompt
+     */
+    checkUserInput(input: any): void;
+    private pushDecision;
+    /**
+     * 观察工具执行结果，自动更新会话状态。
+     */
+    observe(toolName: any, args: any, result: any): void;
+    /**
+     * /clear 时清理会话上下文，并删除当前 scope 的持久化记忆。
+     */
+    clearConversation(): void;
+    /**
+     * 生成 system prompt 注入段落。
+     */
+    toPromptSection(): string;
+}