@auto-ai/agent 2.1.97 → 2.1.101

package/tools-runtime/code-tool/node_modules/zod/v4/package.json

@@ -0,0 +1,7 @@
+{ 
+  "type": "module",
+  "main": "./index.cjs",
+  "module": "./index.js",
+  "types": "./index.d.cts",
+  "sideEffects": false
+}

package/tools-runtime/code-tool/node_modules/zod/v4-mini/index.cjs

@@ -0,0 +1,32 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.z = void 0;
+const z = __importStar(require("../v4/mini/external.cjs"));
+exports.z = z;
+__exportStar(require("../v4/mini/external.cjs"), exports);

package/tools-runtime/code-tool/node_modules/zod/v4-mini/index.d.cts

@@ -0,0 +1,3 @@
+import * as z from "../v4/mini/external.cjs";
+export * from "../v4/mini/external.cjs";
+export { z };

package/tools-runtime/code-tool/node_modules/zod/v4-mini/index.d.ts

@@ -0,0 +1,3 @@
+import * as z from "../v4/mini/external.js";
+export * from "../v4/mini/external.js";
+export { z };

package/tools-runtime/code-tool/node_modules/zod/v4-mini/index.js

@@ -0,0 +1,3 @@
+import * as z from "../v4/mini/external.js";
+export * from "../v4/mini/external.js";
+export { z };

package/tools-runtime/code-tool/node_modules/zod/v4-mini/package.json

@@ -0,0 +1,7 @@
+{ 
+  "type": "module",
+  "main": "./index.cjs",
+  "module": "./index.js",
+  "types": "./index.d.cts",
+  "sideEffects": false
+}

package/tools-runtime/code-tool/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "code-tool",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "bun run build.ts && bun run build-cli.ts"
+  },
+  "dependencies": {
+    "zod": "latest"
+  }
+}

package/tools-runtime/code-tool/src/actions/apply.ts

@@ -0,0 +1,32 @@
+import { readFile, writeFile } from 'node:fs/promises'
+import { assertApplyPathAllowed, resolveInWorkDir } from '../pathGuard.js'
+import { requireCodeWorkDir } from '../hooks.js'
+
+type PatchOp = { path: string; old_string: string; new_string: string }
+
+export async function runApply(
+  patches: PatchOp[],
+): Promise<Record<string, unknown>> {
+  const results: { path: string; ok: boolean; error?: string }[] = []
+  for (const p of patches) {
+    assertApplyPathAllowed(p.path)
+    try {
+      const full = resolveInWorkDir(requireCodeWorkDir(), p.path)
+      const content = await readFile(full, 'utf8')
+      if (!content.includes(p.old_string)) {
+        results.push({ path: p.path, ok: false, error: 'old_string not found' })
+        continue
+      }
+      const next = content.replace(p.old_string, p.new_string)
+      await writeFile(full, next, 'utf8')
+      results.push({ path: p.path, ok: true })
+    } catch (e) {
+      results.push({
+        path: p.path,
+        ok: false,
+        error: e instanceof Error ? e.message : String(e),
+      })
+    }
+  }
+  return { patches: results }
+}

package/tools-runtime/code-tool/src/actions/inspect.ts

@@ -0,0 +1,30 @@
+import { loadCodeMd } from '../memory/loadCodeMd.js'
+import { scanProjectBrief } from '../projectScan.js'
+import { getCodeMdExcludes, requireCodeWorkDir } from '../hooks.js'
+
+export async function runInspect(brief: boolean): Promise<Record<string, unknown>> {
+  const codeWorkDir = requireCodeWorkDir()
+  const memory = await loadCodeMd({
+    projectRoot: codeWorkDir,
+    excludes: getCodeMdExcludes(),
+    maxChars: brief ? 12_000 : undefined,
+  })
+  const { manifests, tree } = await scanProjectBrief(codeWorkDir)
+  let readme = ''
+  try {
+    const { readFile } = await import('node:fs/promises')
+    const { join } = await import('node:path')
+    readme = await readFile(join(codeWorkDir, 'README.md'), 'utf8')
+    if (readme.length > 6000) readme = `${readme.slice(0, 6000)}…`
+  } catch {
+    readme = ''
+  }
+  return {
+    codeWorkDir,
+    codeMemory: memory,
+    hasCodeMemory: memory.length > 0,
+    readme: brief && readme.length > 2000 ? `${readme.slice(0, 2000)}…` : readme,
+    manifests: brief ? Object.keys(manifests) : manifests,
+    tree: brief ? tree.slice(0, 40) : tree,
+  }
+}

package/tools-runtime/code-tool/src/actions/prepare.ts

@@ -0,0 +1,22 @@
+import { access, stat } from 'node:fs/promises'
+import { join } from 'node:path'
+import { hasRootCodeMd } from '../memory/loadCodeMd.js'
+import { requireCodeWorkDir } from '../hooks.js'
+
+export async function runPrepare(): Promise<Record<string, unknown>> {
+  const codeWorkDir = requireCodeWorkDir()
+  await access(codeWorkDir)
+  const st = await stat(codeWorkDir)
+  if (!st.isDirectory()) {
+    throw new Error(`codeWorkDir 不是目录: ${codeWorkDir}`)
+  }
+  let isGit = false
+  try {
+    await access(join(codeWorkDir, '.git'))
+    isGit = true
+  } catch {
+    isGit = false
+  }
+  const hasCodeMd = await hasRootCodeMd(codeWorkDir)
+  return { codeWorkDir, isGit, hasCodeMd }
+}

package/tools-runtime/code-tool/src/actions/read.ts

@@ -0,0 +1,22 @@
+import { readFile } from 'node:fs/promises'
+import { resolveInWorkDir } from '../pathGuard.js'
+import { requireCodeWorkDir } from '../hooks.js'
+
+export async function runRead(
+  path: string,
+  offset?: number,
+  limit?: number,
+): Promise<Record<string, unknown>> {
+  const full = resolveInWorkDir(requireCodeWorkDir(), path)
+  const raw = await readFile(full, 'utf8')
+  const lines = raw.split('\n')
+  const start = Math.max(0, (offset ?? 1) - 1)
+  const end = limit ? start + limit : lines.length
+  const slice = lines.slice(start, end)
+  return {
+    path,
+    offset: start + 1,
+    content: slice.join('\n'),
+    totalLines: lines.length,
+  }
+}

package/tools-runtime/code-tool/src/actions/record.ts

@@ -0,0 +1,37 @@
+import { readFile, writeFile } from 'node:fs/promises'
+import { buildInitialCodeMdTemplate } from '../codeMdTemplate.js'
+import { assertWithinSize, mergeSectionIntoCodeMd } from '../mergeSection.js'
+import { getCodeMdPath } from '../memory/loadCodeMd.js'
+import { requireCodeWorkDir } from '../hooks.js'
+
+export type RecordInput = {
+  section: string
+  content: string
+  mode: 'upsert' | 'append'
+}
+
+/** 增量更新 code.md（仅分区 merge，禁止整文件覆盖） */
+export async function runRecord(input: RecordInput): Promise<Record<string, unknown>> {
+  const codeWorkDir = requireCodeWorkDir()
+  const codeMdPath = getCodeMdPath(codeWorkDir)
+  let existing: string
+  try {
+    existing = await readFile(codeMdPath, 'utf8')
+  } catch {
+    existing = buildInitialCodeMdTemplate()
+  }
+  const merged = mergeSectionIntoCodeMd(
+    existing,
+    input.section,
+    input.content,
+    input.mode,
+  )
+  assertWithinSize(merged)
+  await writeFile(codeMdPath, merged, 'utf8')
+  return {
+    path: codeMdPath,
+    section: input.section,
+    mode: input.mode,
+    size: merged.length,
+  }
+}

package/tools-runtime/code-tool/src/actions/run.ts

@@ -0,0 +1,54 @@
+import { readFile } from 'node:fs/promises'
+import { spawn } from 'node:child_process'
+import { join } from 'node:path'
+import { requireCodeWorkDir } from '../hooks.js'
+
+/** 仅允许 package.json scripts 中声明的脚本名 */
+async function listAllowedScripts(cwd: string): Promise<Set<string>> {
+  const allowed = new Set<string>()
+  try {
+    const raw = await readFile(join(cwd, 'package.json'), 'utf8')
+    const pkg = JSON.parse(raw) as { scripts?: Record<string, string> }
+    for (const k of Object.keys(pkg.scripts ?? {})) {
+      allowed.add(k)
+    }
+  } catch {
+    // 无 package.json 则无允许脚本
+  }
+  return allowed
+}
+
+export async function runScript(script: string): Promise<Record<string, unknown>> {
+  const cwd = requireCodeWorkDir()
+  const allowed = await listAllowedScripts(cwd)
+  if (!allowed.has(script)) {
+    throw new Error(
+      `脚本 "${script}" 不在 package.json scripts 白名单中；允许: ${[...allowed].join(', ') || '(无)'}`,
+    )
+  }
+  return new Promise((resolve, reject) => {
+    const child = spawn('npm', ['run', script], {
+      cwd,
+      shell: false,
+      stdio: ['ignore', 'pipe', 'pipe'],
+      env: process.env,
+    })
+    let stdout = ''
+    let stderr = ''
+    child.stdout.on('data', (d: Buffer) => {
+      stdout += d.toString()
+    })
+    child.stderr.on('data', (d: Buffer) => {
+      stderr += d.toString()
+    })
+    child.on('close', code => {
+      resolve({
+        script,
+        exitCode: code ?? 1,
+        stdout: stdout.slice(-20_000),
+        stderr: stderr.slice(-20_000),
+      })
+    })
+    child.on('error', reject)
+  })
+}

package/tools-runtime/code-tool/src/actions/search.ts

@@ -0,0 +1,46 @@
+import { spawn } from 'node:child_process'
+import { resolveInWorkDir } from '../pathGuard.js'
+import { requireCodeWorkDir } from '../hooks.js'
+
+export async function runSearch(
+  pattern: string,
+  glob?: string,
+): Promise<Record<string, unknown>> {
+  const cwd = requireCodeWorkDir()
+  const args = ['--json', pattern, cwd]
+  if (glob) {
+    args.splice(1, 0, '-g', glob)
+  }
+  return new Promise((resolve, reject) => {
+    const child = spawn('rg', args, { cwd, stdio: ['ignore', 'pipe', 'pipe'] })
+    let stdout = ''
+    let stderr = ''
+    child.stdout.on('data', (d: Buffer) => {
+      stdout += d.toString()
+    })
+    child.stderr.on('data', (d: Buffer) => {
+      stderr += d.toString()
+    })
+    child.on('close', code => {
+      if (code === 1) {
+        resolve({ matches: [], pattern })
+        return
+      }
+      if (code !== 0) {
+        reject(new Error(stderr.trim() || `rg exit ${code}`))
+        return
+      }
+      try {
+        const lines = stdout
+          .trim()
+          .split('\n')
+          .filter(Boolean)
+          .slice(0, 100)
+          .map(l => JSON.parse(l) as unknown)
+        resolve({ pattern, matches: lines })
+      } catch (e) {
+        reject(e)
+      }
+    })
+  })
+}

package/tools-runtime/code-tool/src/actions/status.ts

@@ -0,0 +1,35 @@
+import { spawn } from 'node:child_process'
+import { requireCodeWorkDir } from '../hooks.js'
+
+function execGit(args: string[], cwd: string): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const child = spawn('git', args, { cwd, stdio: ['ignore', 'pipe', 'pipe'] })
+    let out = ''
+    let err = ''
+    child.stdout.on('data', (d: Buffer) => {
+      out += d.toString()
+    })
+    child.stderr.on('data', (d: Buffer) => {
+      err += d.toString()
+    })
+    child.on('close', code => {
+      if (code !== 0) {
+        reject(new Error(err.trim() || `git ${args.join(' ')} failed`))
+        return
+      }
+      resolve(out)
+    })
+  })
+}
+
+export async function runStatus(): Promise<Record<string, unknown>> {
+  const cwd = requireCodeWorkDir()
+  const status = await execGit(['status', '--short'], cwd)
+  let diffStat = ''
+  try {
+    diffStat = await execGit(['diff', '--stat'], cwd)
+  } catch {
+    diffStat = ''
+  }
+  return { status, diffStat }
+}

package/tools-runtime/code-tool/src/agentConfig.test.ts

@@ -0,0 +1,16 @@
+import { describe, expect, it } from 'bun:test'
+import { isEnabledInAgentConfig } from './agentConfig.js'
+
+describe('code-tool isEnabledInAgentConfig', () => {
+  it('识别 CodeTool 与 *', () => {
+    expect(isEnabledInAgentConfig({ tools: ['CodeTool'] })).toBe(true)
+    expect(isEnabledInAgentConfig({ tools: ['*'] })).toBe(true)
+    expect(isEnabledInAgentConfig({ tools: ['GitTool'] })).toBe(false)
+    expect(
+      isEnabledInAgentConfig({
+        tools: ['*'],
+        disallowedTools: ['CodeTool'],
+      }),
+    ).toBe(false)
+  })
+})

package/tools-runtime/code-tool/src/agentConfig.ts

@@ -0,0 +1,28 @@
+type AgentToolsBinding = {
+  tools: string[]
+  disallowedTools?: string[]
+}
+
+function toolNameFromSpec(spec: string): string {
+  const trimmed = spec.trim()
+  const paren = trimmed.indexOf('(')
+  if (paren === -1) {
+    return trimmed
+  }
+  return trimmed.slice(0, paren).trim()
+}
+
+/** agent.json 是否启用 CodeTool */
+export function isEnabledInAgentConfig(agent: AgentToolsBinding): boolean {
+  const disallowed = new Set((agent.disallowedTools ?? []).map(toolNameFromSpec))
+  if (disallowed.has('CodeTool')) {
+    return false
+  }
+  for (const spec of agent.tools) {
+    const toolName = toolNameFromSpec(spec)
+    if (toolName === '*' || toolName === 'CodeTool') {
+      return true
+    }
+  }
+  return false
+}

package/tools-runtime/code-tool/src/cli.ts

@@ -0,0 +1,42 @@
+/**
+ * code-tool CLI：本地调试 inspect --brief（宿主会话改由 buildCodeToolSessionAppend 注入）。
+ * 环境变量 CODE_WORK_DIR 须在宿主 configure 后设置，或传 --work-dir。
+ */
+import { configure } from './hooks.js'
+import { runInspect } from './actions/inspect.js'
+
+async function main(): Promise<void> {
+  const args = process.argv.slice(2)
+  const workDirIdx = args.indexOf('--work-dir')
+  let workDir = process.env.CODE_WORK_DIR?.trim() ?? ''
+  if (workDirIdx >= 0 && args[workDirIdx + 1]) {
+    workDir = args[workDirIdx + 1]!
+    args.splice(workDirIdx, 2)
+  }
+  if (!workDir) {
+    console.error('[code-tool-cli] CODE_WORK_DIR 或 --work-dir 必填')
+    process.exit(1)
+  }
+  configure({ getCodeWorkDir: () => workDir })
+
+  const cmd = args[0]
+  if (cmd === 'inspect' && args.includes('--brief')) {
+    const data = await runInspect(true)
+    const mem = String(data.codeMemory ?? '')
+    if (mem) {
+      process.stdout.write(mem)
+    } else {
+      process.stdout.write(
+        '（尚无 code.md；开发任务开始后请 CodeTool.record 首建并写入 overview/commands）\n',
+      )
+    }
+    return
+  }
+  console.error('[code-tool-cli] 仅支持: inspect --brief [--work-dir PATH]')
+  process.exit(1)
+}
+
+main().catch(e => {
+  console.error(`[code-tool-cli] ${e instanceof Error ? e.message : String(e)}`)
+  process.exit(1)
+})

package/tools-runtime/code-tool/src/codeMdTemplate.ts

@@ -0,0 +1,33 @@
+/**
+ * 首建 code.md 固定骨架（record 在文件不存在时使用）
+ */
+export function buildInitialCodeMdTemplate(): string {
+  return `# code.md
+
+本文件由 CodeTool.record 维护，供后续开发会话加载项目规范。
+
+## overview
+
+（技术栈、仓库用途）
+
+## architecture
+
+（模块划分、关键目录）
+
+## commands
+
+（build / test / lint 等常用命令）
+
+## gotchas
+
+（易错点、环境要求）
+
+## patterns
+
+（本仓库偏好的改码方式）
+
+## Learnings
+
+（开发过程中追加的条目）
+`
+}

package/tools-runtime/code-tool/src/hooks.ts

@@ -0,0 +1,33 @@
+export type CodeToolConfigureHooks = {
+  getCodeWorkDir: () => string
+  getCodeMdExcludes?: () => string[]
+}
+
+let hooks: CodeToolConfigureHooks | null = null
+
+export function configure(next: CodeToolConfigureHooks | null): void {
+  hooks = next
+}
+
+export function resetConfigure(): void {
+  hooks = null
+}
+
+export function getCachedConfigure(): CodeToolConfigureHooks | null {
+  return hooks
+}
+
+export function requireCodeWorkDir(): string {
+  if (!hooks?.getCodeWorkDir) {
+    throw new Error('CodeTool: code work directory not configured')
+  }
+  const dir = hooks.getCodeWorkDir()
+  if (!dir || !dir.trim()) {
+    throw new Error('CodeTool: code work directory not configured')
+  }
+  return dir
+}
+
+export function getCodeMdExcludes(): string[] {
+  return hooks?.getCodeMdExcludes?.() ?? []
+}