itermbot 1.0.18 → 1.0.19

package/README.md

@@ -1,38 +1,10 @@
 # iTermBot
 
-## Introduction
+## 介绍
 
-`apps/itermbot` is the application repo in this workspace. It runs an iTerm-focused agent on top of the BotBotGo runtime, model, memory, and tool packages.
+`itermbot` 是一个运行在 iTerm2 环境中的终端智能体应用，基于 `@botbotgo/agent` 及相关框架包构建。
 
-## Exposed Interfaces
-
-This repo is an app, not a reusable library. Its public interface is the executable entry:
-
-| Interface | Type | Purpose |
-| --- | --- | --- |
-| `itermbot` | CLI | Start the app from `dist/index.js`. |
-
-## Configuration
-
-Main config files:
-
-- `config/app.yaml`
-- `config/agent.yaml`
-- `config/model.yaml`
-- `config/toolkit.yaml`
-- `config/memory.yaml`
-- `config/task-manager.yaml`
-
-`config/app.yaml` holds app-level behavior such as prompt templates and local startup settings. The model, memory, tool, and runtime files are delegated to the corresponding framework repos.
-`config/task-manager.yaml` defines the application task manager behavior and persistence file.
-
-Task manager commands in CLI:
-
-- `task list`
-- `task add <description>`
-- `task run [task-id]`
-
-## Usage
+## 如何使用
 
 ```bash
 cd apps/itermbot
@@ -41,10 +13,27 @@ npm run build
 npm start
 ```
 
-Other entry modes:
+其他模式：
 
 ```bash
 npm run react
 npm run deep
-npm run test:llm
 ```
+
+## 如何设置
+
+- Node.js >= 22
+- 需在 iTerm2 内运行（依赖 `TERM_PROGRAM=iTerm.app` 或 `ITERM_SESSION_ID`）
+- 主要配置文件：
+- `config/app.yaml`
+- `config/agent.yaml`
+- `config/model.yaml`
+- `config/memory.yaml`
+- `config/toolkit.yaml`
+- `config/task-manager.yaml`
+
+## 暴露 API
+
+- 可执行命令：`itermbot`
+- CLI 入口：`node dist/index.js [react|deep] [prompt]`
+- npm 脚本接口：`npm run start`、`npm run react`、`npm run deep`、`npm run test:llm`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "itermbot",
-  "version": "1.0.18",
+  "version": "1.0.19",
   "description": "iTermBot: ReAct agent (LangChain) + DeepAgent (DeepAgents) using BotBotGo packages",
   "type": "module",
   "main": "dist/index.js",
@@ -10,8 +10,8 @@
     "iTermbot": "dist/index.js"
   },
   "scripts": {
-    "preinstall": "node scripts/resolve-deps.js",
-    "prebuild": "node scripts/build-internal-deps.mjs",
+    "preinstall": "node -e \"const fs=require('fs'); const {execSync}=require('child_process'); if (fs.existsSync('../../scripts/run-resolve-deps.sh')) { execSync('bash ../../scripts/run-resolve-deps.sh .', { stdio: 'inherit' }); } else { console.log('Skipping workspace resolve-deps helper'); }\"",
+    "prebuild": "node ./scripts/run-iterm-build-internal-deps.mjs .",
     "build": "tsc -p config/tsconfig.json",
     "dev": "tsc -p config/tsconfig.json --watch",
     "start": "node dist/index.js",
@@ -22,16 +22,16 @@
     "test": "npm run typecheck && npm run build && npm run test:policy",
     "test:policy": "npm run build && node --test --test-concurrency=1 test/unit/*.test.mjs test/unit/**/*.test.mjs test/integration/*.test.mjs",
     "test:live": "npm run build && node --test --test-concurrency=1 test/integration/live-iterm-llm.integration.test.mjs",
-    "test:llm": "node scripts/test-llm.mjs",
+    "test:llm": "node ../../scripts/run-iterm-test-llm.mjs .",
     "release": "semantic-release"
   },
   "dependencies": {
-    "@botbotgo/common": "file:../../framework/common",
-    "@botbotgo/memory": "file:../../framework/memory",
-    "@botbotgo/model": "file:../../framework/model",
-    "@botbotgo/agent": "file:../../framework/agent",
-    "@botbotgo/toolkit": "file:../../framework/toolkit",
-    "@botbotgo/toolkit-builtin": "file:../../framework/toolkit-builtin",
+    "@botbotgo/common": "1.0.15",
+    "@botbotgo/memory": "1.0.64",
+    "@botbotgo/model": "1.0.9",
+    "@botbotgo/agent": "1.1.20",
+    "@botbotgo/toolkit": "1.0.122",
+    "@botbotgo/toolkit-builtin": "0.0.114",
     "@langchain/core": "1.1.31",
     "@langchain/langgraph": "1.2.0",
     "@langchain/langgraph-checkpoint": "1.0.0",

package/scripts/resolve-deps.js

@@ -1,49 +1,91 @@
 #!/usr/bin/env node
 
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname, resolve } from "node:path";
-import { fileURLToPath, pathToFileURL } from "node:url";
+import { existsSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { execSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
 
 const DEP_SECTIONS = ["dependencies", "devDependencies", "optionalDependencies"];
+const SCOPES = ["@botbotgo/", "@wallee/"];
+const SKIP_DIRS = new Set(["node_modules", ".git", "dist", "coverage"]);
 
-function fallbackRewriteCurrentPackage(scriptUrl) {
-  const scriptDir = dirname(fileURLToPath(scriptUrl));
-  const packageDir = resolve(scriptDir, "..");
-  const packageJsonPath = resolve(packageDir, "package.json");
-  const pkg = JSON.parse(readFileSync(packageJsonPath, "utf8"));
+function readJson(path) { return JSON.parse(readFileSync(path, "utf8")); }
+function writeJson(path, value) { writeFileSync(path, `${JSON.stringify(value, null, 2)}\n`); }
+function isInternalPackage(name) { return SCOPES.some((scope) => name.startsWith(scope)); }
+
+function tryResolveLocalVersion(pkgDir, spec) {
+  if (!spec.startsWith("file:")) return null;
+  const pkgPath = resolve(pkgDir, spec.slice(5), "package.json");
+  if (!existsSync(pkgPath)) return null;
+  const parsed = readJson(pkgPath);
+  return typeof parsed.version === "string" && parsed.version.length > 0 ? parsed.version : null;
+}
+
+function fetchPublishedVersion(name) {
+  try {
+    const raw = execSync(`npm view ${name} version --json`, { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] }).trim();
+    const parsed = JSON.parse(raw);
+    return typeof parsed === "string" && parsed.length > 0 ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+
+function collectPackageJsonPaths(rootDir) {
+  const out = [];
+  function walk(currentDir) {
+    for (const entry of readdirSync(currentDir)) {
+      if (SKIP_DIRS.has(entry)) continue;
+      const abs = join(currentDir, entry);
+      const st = statSync(abs);
+      if (st.isDirectory()) {
+        walk(abs);
+        continue;
+      }
+      if (entry === "package.json") out.push(abs);
+    }
+  }
+  walk(rootDir);
+  return out.sort();
+}
+
+function rewritePackageJson(pkgPath) {
+  const pkg = readJson(pkgPath);
+  const pkgDir = dirname(pkgPath);
   let changed = false;
 
   for (const section of DEP_SECTIONS) {
     const deps = pkg[section];
     if (!deps || typeof deps !== "object") continue;
-    for (const [name, version] of Object.entries(deps)) {
-      if (!name.startsWith("@botbotgo/")) continue;
-      if (typeof version !== "string" || !version.startsWith("file:")) continue;
-      const target = resolve(packageDir, version.slice("file:".length));
-      if (existsSync(target)) continue;
-      deps[name] = "latest";
-      changed = true;
-      console.log(`[resolve-deps:fallback] ${section}.${name}: ${version} -> latest`);
+    for (const [name, current] of Object.entries(deps)) {
+      if (typeof current !== "string" || !isInternalPackage(name) || !current.startsWith("file:")) continue;
+      const next = tryResolveLocalVersion(pkgDir, current) ?? fetchPublishedVersion(name);
+      if (!next) {
+        console.warn(`[resolve-deps] warn: could not resolve ${name} for ${pkgPath}`);
+        continue;
+      }
+      if (next !== current) {
+        deps[name] = next;
+        changed = true;
+        console.log(`[resolve-deps] ${pkg.name ?? pkgPath} ${section}.${name}: ${current} -> ${next}`);
+      }
     }
   }
 
-  if (changed) {
-    writeFileSync(packageJsonPath, `${JSON.stringify(pkg, null, 2)}\n`);
-  }
+  if (changed) writeJson(pkgPath, pkg);
+  return changed;
 }
 
-async function run() {
-  const scriptDir = dirname(fileURLToPath(import.meta.url));
-  const workspaceRunner = resolve(scriptDir, "../../../scripts/resolve-deps-runner.mjs");
-
-  if (existsSync(workspaceRunner)) {
-    const { runResolveDeps } = await import(pathToFileURL(workspaceRunner).href);
-    await runResolveDeps(import.meta.url, "../../../scripts/internal-package-refs.mjs");
+function main() {
+  if (!process.env.CI) {
+    console.log("[resolve-deps] skipping because CI is not set");
     return;
   }
-
-  console.log(`[resolve-deps] workspace helper not found at ${workspaceRunner}; using local fallback`);
-  fallbackRewriteCurrentPackage(import.meta.url);
+  const repoRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+  const packageJsonPaths = collectPackageJsonPaths(repoRoot);
+  let changed = false;
+  for (const pkgPath of packageJsonPaths) changed = rewritePackageJson(pkgPath) || changed;
+  if (!changed) console.log("[resolve-deps] no file-based internal deps to rewrite");
 }
 
-await run();
+main();

package/scripts/{build-internal-deps.mjs → run-iterm-build-internal-deps.mjs}

@@ -3,16 +3,10 @@
 import { execSync } from "node:child_process";
 import { existsSync, lstatSync, mkdirSync, readFileSync, rmSync, symlinkSync } from "node:fs";
 import { dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
 
-const scriptDir = dirname(fileURLToPath(import.meta.url));
-const appDir = resolve(scriptDir, "..");
+const appDir = process.argv[2] ? resolve(process.argv[2]) : process.cwd();
 const packageJson = JSON.parse(readFileSync(resolve(appDir, "package.json"), "utf8"));
-const dependencySections = [
-  packageJson.dependencies ?? {},
-  packageJson.devDependencies ?? {},
-  packageJson.optionalDependencies ?? {},
-];
+const dependencySections = [packageJson.dependencies ?? {}, packageJson.devDependencies ?? {}, packageJson.optionalDependencies ?? {}];
 
 const WORKSPACE_PACKAGE_DIRS = {
   "@botbotgo/common": "framework/common",
@@ -45,9 +39,7 @@ function resolveWorkspacePackageDir(packageName) {
 
 function syncWorkspacePackage(packageName, packageDir) {
   const [, scope, shortName] = packageName.match(/^@([^/]+)\/(.+)$/) ?? [];
-  if (!scope || !shortName) {
-    throw new Error(`Unsupported scoped package name: ${packageName}`);
-  }
+  if (!scope || !shortName) throw new Error(`Unsupported scoped package name: ${packageName}`);
   const scopeDir = resolve(appDir, "node_modules", `@${scope}`);
   const targetDir = resolve(scopeDir, shortName);
   mkdirSync(scopeDir, { recursive: true });
@@ -81,7 +73,7 @@ function syncPeerDependenciesFromApp(packageDir) {
   }
 }
 
-function ensureInstalledDependencies(packageName, packageDir) {
+function ensureInstalledDependencies(packageDir) {
   if (hasInstalledDependencies(packageDir)) return;
   console.log(`[build-internal-deps] npm install --prefix ${packageDir}`);
   execSync(`npm install --prefix ${JSON.stringify(packageDir)} --legacy-peer-deps --ignore-scripts`, {
@@ -91,33 +83,16 @@ function ensureInstalledDependencies(packageName, packageDir) {
   syncPeerDependenciesFromApp(packageDir);
 }
 
-const packageNames = [
-  "@botbotgo/common",
-  "@botbotgo/model",
-  "@botbotgo/memory",
-  "@botbotgo/toolkit",
-  "@botbotgo/agent",
-  "@botbotgo/toolkit-builtin",
-];
+const packageNames = ["@botbotgo/common", "@botbotgo/model", "@botbotgo/memory", "@botbotgo/toolkit", "@botbotgo/agent", "@botbotgo/toolkit-builtin"];
 
 for (const packageName of packageNames) {
   const spec = getDependencySpec(packageName);
-  const packageDir = spec?.startsWith("file:")
-    ? resolve(appDir, spec.slice("file:".length))
-    : resolveWorkspacePackageDir(packageName);
-  if (!packageDir || !existsSync(resolve(packageDir, "package.json"))) {
-    if (spec?.startsWith("file:")) {
-      console.warn(`[build-internal-deps] skipping missing workspace package for ${packageName}: ${packageDir}`);
-    }
-    continue;
-  }
-  ensureInstalledDependencies(packageName, packageDir);
+  const packageDir = spec?.startsWith("file:") ? resolve(appDir, spec.slice("file:".length)) : resolveWorkspacePackageDir(packageName);
+  if (!packageDir || !existsSync(resolve(packageDir, "package.json"))) continue;
+  ensureInstalledDependencies(packageDir);
   console.log(`[build-internal-deps] npm run build --prefix ${packageDir}`);
   try {
-    execSync(`npm run build --prefix ${JSON.stringify(packageDir)}`, {
-      cwd: appDir,
-      stdio: "inherit",
-    });
+    execSync(`npm run build --prefix ${JSON.stringify(packageDir)}`, { cwd: appDir, stdio: "inherit" });
   } catch (error) {
     if (!hasBuiltOutput(packageDir)) throw error;
     console.warn(`[build-internal-deps] build failed for ${packageName}, using existing dist at ${packageDir}`);

package/scripts/test-llm.mjs

@@ -1,33 +0,0 @@
-/**
- * Quick LLM config test. Run from app root: npm run test:llm
- */
-import { AgentContextTokens, getDefaultAgentContext } from "@botbotgo/common/context";
-import { createAgentModel } from "@botbotgo/model";
-import { loadAppConfig, getModelsConfigPath } from "../dist/config.js";
-
-async function main() {
-  try {
-    const appConfig = await loadAppConfig("config/app.yaml");
-    const agentNames = Object.keys(appConfig?.app?.agent ?? {});
-    const agentName = appConfig?.app?.defaultAgent ?? agentNames[0];
-    const modelPath = getModelsConfigPath(appConfig, agentName);
-    console.log(`[test-llm] Loading LLM from ${modelPath} ...`);
-    await createAgentModel({
-      configPath: modelPath,
-    });
-    const llm = getDefaultAgentContext().get(AgentContextTokens.ChatModel);
-
-    console.log("[test-llm] Invoking LLM ...");
-    const res = await llm.invoke(
-      "In one sentence, introduce yourself and say you are being used to test iTermBot's LLM config."
-    );
-
-    console.log("[test-llm] Raw response:");
-    console.log(JSON.stringify(res, null, 2));
-  } catch (err) {
-    console.error("[test-llm] Error:", err);
-    process.exit(1);
-  }
-}
-
-main();