@renxqoo/renx-code 0.0.4 → 0.0.5

package/bin/renx.cjs

@@ -6,8 +6,23 @@ const path = require("node:path");
 
 const packageRoot = path.resolve(__dirname, "..");
 const entryPath = path.join(packageRoot, "src", "index.tsx");
+const packagedRepoRoot = path.join(packageRoot, "vendor", "agent-root");
+const localRepoRoot = path.resolve(packageRoot, "..");
 const bunExecutable = process.env.RENX_BUN_PATH || "bun";
 
+const hasAgentSourceRoot = root =>
+  fs.existsSync(path.join(root, "src", "providers", "index.ts")) &&
+  fs.existsSync(path.join(root, "src", "config", "index.ts")) &&
+  fs.existsSync(path.join(root, "src", "agent", "app", "index.ts"));
+
+const resolvedRepoRoot =
+  process.env.AGENT_REPO_ROOT ||
+  (hasAgentSourceRoot(packagedRepoRoot)
+    ? packagedRepoRoot
+    : hasAgentSourceRoot(localRepoRoot)
+      ? localRepoRoot
+      : undefined);
+
 if (!fs.existsSync(entryPath)) {
   console.error(`Could not find CLI entrypoint: ${entryPath}`);
   process.exit(1);
@@ -19,6 +34,7 @@ const result = childProcess.spawnSync(bunExecutable, [entryPath, ...process.argv
   env: {
     ...process.env,
     AGENT_WORKDIR: process.env.AGENT_WORKDIR || process.cwd(),
+    ...(resolvedRepoRoot ? { AGENT_REPO_ROOT: resolvedRepoRoot } : {}),
   },
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@renxqoo/renx-code",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "module": "src/index.tsx",
   "type": "module",
   "private": false,
@@ -10,57 +10,14 @@
   "files": [
     "bin",
     "src",
+    "vendor",
     "README.md",
     "tsconfig.json"
   ],
-  "scripts": {
-    "dev": "bun run src/index.tsx",
-    "dev:watch": "bun run --watch src/index.tsx",
-    "lint": "eslint . --ext .ts,.tsx",
-    "lint:fix": "eslint . --ext .ts,.tsx --fix",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
-    "test:run": "bun test src/context-usage-regressions.test.ts src/ui/theme.simple.test.ts src/ui/theme.test.ts src/runtime/exit.test.ts src/runtime/clipboard.test.ts src/runtime/terminal-theme.test.ts src/utils/time.test.ts src/components/tool-confirm-dialog-content.test.ts src/hooks/chat-local-replies.fixed.test.ts src/hooks/chat-local-replies.test.ts src/hooks/turn-updater.test.ts src/hooks/agent-event-handlers.test.ts src/hooks/use-agent-chat.status.test.ts src/files/attachment-capabilities.test.ts src/files/file-mention-query.test.ts src/commands/slash-commands.test.ts src/agent/runtime/runtime.simple.test.ts src/agent/runtime/tool-call-buffer.test.ts src/components/chat/assistant-reply.test.tsx src/components/chat/assistant-segment.test.ts src/components/chat/code-block.test.tsx src/components/chat/segment-groups.test.ts",
-    "type-check": "tsc --noEmit",
-    "check": "bun run type-check && bun run lint && bun run format:check",
-    "pack:dry": "npm pack --dry-run",
-    "pack:tgz": "npm pack",
-    "version:fix": "npm version patch",
-    "version:feature": "npm version minor",
-    "version:breaking": "npm version major",
-    "publish:fix": "npm run version:fix && npm publish",
-    "publish:feature": "npm run version:feature && npm publish",
-    "publish:breaking": "npm run version:breaking && npm publish",
-    "publish:patch": "npm run publish:fix",
-    "publish:minor": "npm run publish:feature",
-    "publish:major": "npm run publish:breaking",
-    "proxy": "w2 start",
-    "proxy:stop": "w2 stop",
-    "proxy:restart": "w2 restart"
-  },
   "engines": {
     "node": ">=20.0.0",
     "bun": ">=1.1.0"
   },
-  "devDependencies": {
-    "@eslint/js": "^10.0.1",
-    "@testing-library/react": "^16.3.2",
-    "@testing-library/react-hooks": "^8.0.1",
-    "@testing-library/user-event": "^14.6.1",
-    "@types/bun": "latest",
-    "@types/react": "^19.2.14",
-    "@types/react-dom": "^19.2.3",
-    "@typescript-eslint/eslint-plugin": "^8.57.0",
-    "@typescript-eslint/parser": "^8.57.0",
-    "eslint": "^10.0.3",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-prettier": "^5.5.5",
-    "eslint-plugin-react": "^7.37.5",
-    "eslint-plugin-react-hooks": "^7.0.1",
-    "globals": "^17.4.0",
-    "prettier": "^3.8.1",
-    "whistle": "^2.10.1"
-  },
   "peerDependencies": {
     "typescript": "^5.9.3"
   },

package/src/agent/runtime/runtime.context-usage.test.ts

@@ -9,10 +9,6 @@ vi.mock('./source-modules', () => ({
   resolveWorkspaceRoot: vi.fn(),
 }));
 
-vi.mock('../../../../src/agent/prompts/system', () => ({
-  buildSystemPrompt: vi.fn(() => 'Test system prompt'),
-}));
-
 import { disposeAgentRuntime, runAgentPrompt } from './runtime';
 import * as sourceModules from './source-modules';
 import type { AgentContextUsageEvent, AgentEventHandlers } from './types';
@@ -124,7 +120,10 @@ describe('runAgentPrompt context usage forwarding', () => {
         createFromEnv: () => ({}),
       },
       loadEnvFiles: vi.fn().mockResolvedValue([]),
-    loadConfigToEnv: vi.fn().mockReturnValue([]),
+      loadConfigToEnv: vi.fn().mockReturnValue([]),
+      buildSystemPrompt: vi.fn(() => 'Test system prompt'),
+      resolveRenxDatabasePath: vi.fn(() => '/tmp/renx/data.db'),
+      resolveRenxTaskDir: vi.fn(() => '/tmp/renx/task'),
       createLoggerFromEnv: vi.fn(() => ({ info: vi.fn(), warn: vi.fn(), error: vi.fn() })),
       createAgentLoggerAdapter: vi.fn((logger: Record<string, unknown>) => ({
         info: typeof logger.info === 'function' ? logger.info.bind(logger) : undefined,

package/src/agent/runtime/runtime.error-handling.test.ts

@@ -9,10 +9,6 @@ vi.mock('./source-modules', () => ({
   resolveWorkspaceRoot: vi.fn(),
 }));
 
-vi.mock('../../../../src/agent/prompts/system', () => ({
-  buildSystemPrompt: vi.fn(() => 'Test system prompt'),
-}));
-
 import { disposeAgentRuntime, runAgentPrompt } from './runtime';
 import * as sourceModules from './source-modules';
 
@@ -95,7 +91,10 @@ describe('runAgentPrompt error handling', () => {
           createFromEnv: () => ({}),
         },
         loadEnvFiles: vi.fn().mockResolvedValue([]),
-    loadConfigToEnv: vi.fn().mockReturnValue([]),
+        loadConfigToEnv: vi.fn().mockReturnValue([]),
+        buildSystemPrompt: vi.fn(() => 'Test system prompt'),
+        resolveRenxDatabasePath: vi.fn(() => '/tmp/renx/data.db'),
+        resolveRenxTaskDir: vi.fn(() => '/tmp/renx/task'),
         createLoggerFromEnv,
         createAgentLoggerAdapter: vi.fn(() => ({
           info: vi.fn(),

package/src/agent/runtime/runtime.test.ts

@@ -10,10 +10,6 @@ vi.mock('./source-modules', () => ({
   resolveWorkspaceRoot: vi.fn(),
 }));
 
-vi.mock('../../../../src/agent/prompts/system', () => ({
-  buildSystemPrompt: vi.fn(() => 'Test system prompt'),
-}));
-
 import {
   disposeAgentRuntime,
   getAgentModelId,
@@ -103,6 +99,13 @@ const buildMockModules = () => {
     },
     loadEnvFiles: vi.fn().mockResolvedValue([]),
     loadConfigToEnv: vi.fn().mockReturnValue([]),
+    buildSystemPrompt: vi.fn(() => 'Test system prompt'),
+    resolveRenxDatabasePath: vi.fn((env?: NodeJS.ProcessEnv) =>
+      path.join(env?.RENX_HOME ?? renxHome, 'data.db')
+    ),
+    resolveRenxTaskDir: vi.fn((env?: NodeJS.ProcessEnv) =>
+      path.join(env?.RENX_HOME ?? renxHome, 'task')
+    ),
     createLoggerFromEnv: vi.fn(() => ({ info: vi.fn(), warn: vi.fn(), error: vi.fn() })),
     createAgentLoggerAdapter: vi.fn((logger: Record<string, unknown>) => ({
       info: typeof logger.info === 'function' ? logger.info.bind(logger) : undefined,

package/src/agent/runtime/runtime.ts

@@ -30,8 +30,6 @@ import {
   type ToolConfirmEventLike,
 } from './source-modules';
 import { ToolCallBuffer } from './tool-call-buffer';
-import { buildSystemPrompt } from '../../../../src/agent/prompts/system';
-import { resolveRenxDatabasePath, resolveRenxTaskDir } from '../../../../src/config/paths';
 import type { AttachmentModelCapabilities } from '../../files/attachment-capabilities';
 import { resolveAttachmentModelCapabilities } from '../../files/attachment-capabilities';
 import type { MessageContent } from '../../types/message-content';
@@ -129,10 +127,6 @@ const resolveConversationId = () => {
   return `opentui-${Date.now()}`;
 };
 
-const resolveDbPath = (): string => {
-  return resolveRenxDatabasePath(process.env);
-};
-
 const buildCliLoggerEnv = (env: NodeJS.ProcessEnv): NodeJS.ProcessEnv => ({
   ...env,
   AGENT_LOG_CONSOLE: 'false',
@@ -359,7 +353,7 @@ const createRuntime = async (): Promise<RuntimeCore> => {
   });
   const toolManager = new modules.DefaultToolManager();
   const taskStore = new modules.TaskStore({
-    baseDir: resolveRenxTaskDir(process.env),
+    baseDir: modules.resolveRenxTaskDir(process.env),
   });
   toolManager.registerTool(new modules.BashTool());
   toolManager.registerTool(
@@ -411,7 +405,7 @@ const createRuntime = async (): Promise<RuntimeCore> => {
     logger: agentLogger,
   });
 
-  const appStore = modules.createSqliteAgentAppStore(resolveDbPath());
+  const appStore = modules.createSqliteAgentAppStore(modules.resolveRenxDatabasePath(process.env));
   const preparableStore = appStore as AgentAppStoreLike & {
     prepare?: () => Promise<void>;
   };
@@ -636,7 +630,7 @@ export const runAgentPrompt = async (
         conversationId: runtime.conversationId,
         userInput: prompt,
         historyMessages: historyMessages as AgentV4MessageLike[],
-        systemPrompt: buildSystemPrompt({ directory: runtime.workspaceRoot }),
+        systemPrompt: runtime.modules.buildSystemPrompt({ directory: runtime.workspaceRoot }),
         tools: runtime.parentTools,
         config: resolvePromptCacheConfig(runtime.conversationId),
         maxSteps: runtime.maxSteps,

package/src/agent/runtime/runtime.usage-forwarding.test.ts

@@ -9,10 +9,6 @@ vi.mock('./source-modules', () => ({
   resolveWorkspaceRoot: vi.fn(),
 }));
 
-vi.mock('../../../../src/agent/prompts/system', () => ({
-  buildSystemPrompt: vi.fn(() => 'Test system prompt'),
-}));
-
 import { disposeAgentRuntime, runAgentPrompt } from './runtime';
 import * as sourceModules from './source-modules';
 import type { AgentEventHandlers } from './types';
@@ -148,7 +144,10 @@ describe('runAgentPrompt usage forwarding', () => {
         createFromEnv: () => ({}),
       },
       loadEnvFiles: vi.fn().mockResolvedValue([]),
-    loadConfigToEnv: vi.fn().mockReturnValue([]),
+      loadConfigToEnv: vi.fn().mockReturnValue([]),
+      buildSystemPrompt: vi.fn(() => 'Test system prompt'),
+      resolveRenxDatabasePath: vi.fn(() => '/tmp/renx/data.db'),
+      resolveRenxTaskDir: vi.fn(() => '/tmp/renx/task'),
       createLoggerFromEnv: vi.fn(() => loggerFromEnv),
       createAgentLoggerAdapter: vi.fn((logger: typeof loggerFromEnv) => ({
         info: (message: string, _context?: Record<string, unknown>, _data?: unknown) =>

package/src/agent/runtime/source-modules.test.ts

@@ -1,57 +1,38 @@
-import { afterEach, describe, expect, it, vi } from 'vitest';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 import { resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-import { resolveRepoRoot, resolveWorkspaceRoot } from './source-modules';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 
 const runtimeDir = fileURLToPath(new URL('.', import.meta.url));
 const packageRoot = resolve(runtimeDir, '../../..');
 const workspaceRoot = resolve(runtimeDir, '../../../..');
-const originalAgentRepoRoot = process.env.AGENT_REPO_ROOT;
-const originalAgentWorkdir = process.env.AGENT_WORKDIR;
+const sourceModulesUrl = pathToFileURL(resolve(runtimeDir, 'source-modules.ts')).href;
+
+const importSourceModules = async () => {
+  return import(`${sourceModulesUrl}?real=${Date.now()}-${Math.random()}`);
+};
+
+beforeEach(() => {
+  delete process.env.AGENT_REPO_ROOT;
+  delete process.env.AGENT_WORKDIR;
+});
 
 afterEach(() => {
   vi.restoreAllMocks();
-
-  if (originalAgentRepoRoot === undefined) {
-    delete process.env.AGENT_REPO_ROOT;
-  } else {
-    process.env.AGENT_REPO_ROOT = originalAgentRepoRoot;
-  }
-
-  if (originalAgentWorkdir === undefined) {
-    delete process.env.AGENT_WORKDIR;
-  } else {
-    process.env.AGENT_WORKDIR = originalAgentWorkdir;
-  }
 });
 
 describe('resolveRepoRoot', () => {
-  it('finds the workspace root when launched from opentui-agent-cli', () => {
+  it('finds the workspace root when launched from opentui-agent-cli', async () => {
+    const { resolveRepoRoot } = await importSourceModules();
     vi.spyOn(process, 'cwd').mockReturnValue(packageRoot);
 
     expect(resolveRepoRoot()).toBe(workspaceRoot);
   });
 
-  it('respects AGENT_REPO_ROOT when provided', () => {
+  it('respects AGENT_REPO_ROOT when provided', async () => {
+    const { resolveRepoRoot } = await importSourceModules();
     process.env.AGENT_REPO_ROOT = workspaceRoot;
     vi.spyOn(process, 'cwd').mockReturnValue('D:\\temp\\example-workspace');
 
     expect(resolveRepoRoot()).toBe(workspaceRoot);
   });
 });
-
-describe('resolveWorkspaceRoot', () => {
-  it('defaults to the current working directory', () => {
-    vi.spyOn(process, 'cwd').mockReturnValue(packageRoot);
-
-    expect(resolveWorkspaceRoot()).toBe(packageRoot);
-  });
-
-  it('respects AGENT_WORKDIR when provided', () => {
-    process.env.AGENT_WORKDIR = workspaceRoot;
-    vi.spyOn(process, 'cwd').mockReturnValue(packageRoot);
-
-    expect(resolveWorkspaceRoot()).toBe(workspaceRoot);
-  });
-});

package/src/agent/runtime/source-modules.ts

@@ -167,6 +167,16 @@ export type SourceModules = {
   ProviderRegistry: ProviderRegistryLike;
   loadEnvFiles: (cwd?: string) => Promise<string[]>;
   loadConfigToEnv: (options?: Record<string, unknown>) => string[];
+  buildSystemPrompt: (options: {
+    directory: string;
+    language?: string;
+    currentDateTime?: string;
+    sandboxMode?: string;
+    networkPolicy?: string;
+    runtimeToolNames?: string[];
+  }) => string;
+  resolveRenxDatabasePath: (env?: NodeJS.ProcessEnv) => string;
+  resolveRenxTaskDir: (env?: NodeJS.ProcessEnv) => string;
   createLoggerFromEnv: (env?: NodeJS.ProcessEnv, cwd?: string) => unknown;
   createAgentLoggerAdapter: (
     logger: Record<string, unknown>,
@@ -254,6 +264,8 @@ const loadSourceModules = async (): Promise<SourceModules> => {
   const [
     providerMod,
     configMod,
+    pathConfigMod,
+    systemPromptMod,
     appMod,
     agentV4Mod,
     agentLoggerMod,
@@ -279,6 +291,8 @@ const loadSourceModules = async (): Promise<SourceModules> => {
   ] = await Promise.all([
     import(toModuleUrl(resolve(repoRoot, 'src/providers/index.ts'))),
     import(toModuleUrl(resolve(repoRoot, 'src/config/index.ts'))),
+    import(toModuleUrl(resolve(repoRoot, 'src/config/paths.ts'))),
+    import(toModuleUrl(resolve(repoRoot, 'src/agent/prompts/system.ts'))),
     import(toModuleUrl(resolve(repoRoot, 'src/agent/app/index.ts'))),
     import(toModuleUrl(resolve(repoRoot, 'src/agent/agent/index.ts'))),
     import(toModuleUrl(resolve(repoRoot, 'src/agent/agent/logger.ts'))),
@@ -308,6 +322,9 @@ const loadSourceModules = async (): Promise<SourceModules> => {
     ProviderRegistry: getRequiredExport<ProviderRegistryLike>(providerMod, 'ProviderRegistry'),
     loadEnvFiles: getRequiredExport(configMod, 'loadEnvFiles'),
     loadConfigToEnv: getRequiredExport(configMod, 'loadConfigToEnv'),
+    buildSystemPrompt: getRequiredExport(systemPromptMod, 'buildSystemPrompt'),
+    resolveRenxDatabasePath: getRequiredExport(pathConfigMod, 'resolveRenxDatabasePath'),
+    resolveRenxTaskDir: getRequiredExport(pathConfigMod, 'resolveRenxTaskDir'),
     createLoggerFromEnv: getRequiredExport(configMod, 'createLoggerFromEnv'),
     createAgentLoggerAdapter: getRequiredExport(agentLoggerMod, 'createAgentLoggerAdapter'),
     StatelessAgent: getRequiredExport<StatelessAgentCtor>(agentV4Mod, 'StatelessAgent'),

package/vendor/agent-root/src/agent/ENTERPRISE_ACCEPTANCE_CHECKLIST.md

@@ -0,0 +1,95 @@
+# Agent-V4 企业级验收清单与改造路线图
+
+## 1. 文档目的
+- 给 `StatelessAgent` 提供一套可执行、可验收、可持续迭代的企业级基线。
+- 明确 P0/P1 改造顺序，避免“功能堆叠但不可运维”。
+
+## 2. 当前基线（已具备）
+- 无状态单轮流程：LLM -> Tool -> 回写消息。
+- 支持流式处理、工具调用、重试退避、`abortSignal`。
+- `write_file` 支持 `direct/finalize` 缓冲写入协议。
+- `agent-v4` 测试已覆盖主流程与关键异常分支。
+
+## 3. 验收范围定义
+- 验收对象：`src/agent-v4`。
+- 验收目标：可作为企业级基础内核（非完整平台）。
+- 非目标：多租户平台治理、完整控制面、运营后台。
+
+## 4. 企业级验收清单（可量化）
+| 编号 | 项目 | 当前状态 | 验收标准（DoD） | 优先级 |
+|---|---|---|---|---|
+| A1 | 核心流程正确性 | 已有 | 主链路 E2E + 回归稳定（无随机失败） | P0 |
+| A2 | 错误模型统一 | 部分 | 统一错误码、可机读分类、外层稳定映射 | P0 |
+| A3 | 重试与退避治理 | 已有基础 | 可重试/不可重试清晰分层，重试预算可配置 | P0 |
+| A4 | 工具幂等（副作用） | 缺失 | `executionId + toolCallId` 去重账本 | P0 |
+| A5 | 全链路超时取消 | 已有基础 | timeout budget 拆分到 LLM/Tool，原因可观测 | P0 |
+| A6 | 安全策略控制 | 部分 | 工具策略校验层，拒绝理由标准化+审计 | P0 |
+| A7 | 可观测性闭环 | 部分 | 结构化日志 + 指标 + trace/span | P0 |
+| A8 | write_file 协议稳定性 | 已有 | 协议版本化、兼容策略、坏包回放测试 | P0 |
+| A9 | 并发一致性 | 已有基础 | 并发压测无竞态写坏、锁策略可解释 | P0 |
+| A10 | 故障注入与压测 | 部分 | chaos + soak + 基准报告 | P0 |
+| B1 | 配置治理 | 部分 | 配置 schema 校验 + 变更审计 | P1 |
+| B2 | 多租户隔离与配额 | 缺失 | tenant 级限流/配额/隔离 | P1 |
+| B3 | 成本治理 | 缺失 | token/tool 成本指标、预算告警、降级 | P1 |
+| B4 | Runbook/SLO | 缺失 | SLI/SLO/告警阈值与应急手册 | P1 |
+| B5 | 协议与版本升级策略 | 缺失 | 兼容矩阵与回滚策略 | P1 |
+
+## 5. P0 改造顺序（必须先做）
+1. **错误契约冻结（A2）**
+   - 输出统一错误码表（Agent/Tool/Provider）。
+   - 定义 `retryable`、`category`、`httpMapping`。
+   - 对外 API 返回稳定错误结构。
+2. **幂等执行账本（A4）**
+   - 引入执行去重键：`executionId + toolCallId`。
+   - 重试/超时恢复时，副作用工具不重复执行。
+3. **超时预算治理（A5）**
+   - 引入全局 `timeoutBudgetMs`，拆分到 LLM/Tool 子预算。
+   - 记录 `timeout_stage`、`elapsed_ms`。
+4. **安全策略层（A6）**
+   - 工具执行前统一策略检查（路径、命令、危险参数）。
+   - 拒绝行为带错误码和审计字段。
+5. **可观测性最小闭环（A7）**
+   - 日志结构化字段：`executionId`、`stepIndex`、`toolCallId`、`errorCode`、`latencyMs`。
+   - 指标：成功率、P95 时延、重试率、工具失败率。
+6. **write_file 协议加固（A8）**
+   - 增加 `protocolVersion`。
+   - 增加乱序/重复包/坏包处理规则与回放测试。
+7. **并发一致性与压测（A9/A10）**
+   - 混合场景压测：并发工具 + 断点续写 + abort + retry。
+   - 输出基线报告（吞吐、延迟、错误率、资源占用）。
+8. **发布门禁（A1~A10 汇总）**
+   - CI 强制：契约测试、故障注入测试、性能阈值。
+   - 未达阈值禁止发版。
+
+## 6. P1 改造顺序（增强能力）
+1. 配置中心化与灰度开关（B1）。
+2. 多租户隔离与配额（B2）。
+3. 成本治理与自动降级（B3）。
+4. Runbook + SLO + 告警演练（B4）。
+5. 协议版本升级与兼容矩阵（B5）。
+
+## 7. 每项验收模板（建议）
+```md
+### [A2] 错误契约冻结
+- 目标:
+- 代码改动:
+- 风险:
+- 回滚方案:
+- 测试:
+  - 单测:
+  - 集成:
+  - 故障注入:
+- 验收结果:
+  - [ ] 通过
+```
+
+## 8. 推荐里程碑
+- M1（1周）：A2/A4/A5 完成并通过回归。
+- M2（1周）：A6/A7/A8 完成并接入 CI。
+- M3（1周）：A9/A10 压测与故障注入完成，形成发布门禁。
+- M4（持续）：B1~B5 按业务优先级迭代。
+
+## 9. 结论
+- 当前 `agent-v4` 已接近“企业级基础内核”。
+- 完成本清单的 P0 后，可作为生产基础 Agent 投入企业场景。
+- P1 决定系统在规模化、治理、成本控制上的上限。