@turingflow/agent-kit 0.1.1 → 0.1.2

package/README.md

@@ -42,15 +42,13 @@ kit 侧提供（无需改动）：
 ## Step 0 — 前置条件
 
 - Node.js ≥ 18，目标工程为 **Next.js App Router**（`next.config.mjs` 需支持 `basePath`）
-- 一次性完成 CodeBuddy 登录（浏览器登录，凭据存 `~/.codebuddy`，SDK 持久化、之后自动复用，无需 API Key）。
-  **login/logout 是宿主应用侧职责**，agent-kit 不内置认证命令；参考实现见 `apps/web`：
+- 一次性完成 CodeBuddy 登录（浏览器登录，凭据存 `~/.codebuddy`，SDK 持久化、之后自动复用，无需 API Key）。agent-kit 提供安装即用的命令，宿主无需实现认证脚本：
   ```bash
-  # 在 apps/web 目录下
-  npm run login      # 自动打开浏览器完成 CodeBuddy 登录（scripts/codebuddy-auth.mjs）
-  npm run logout     # 登出（切外部 API 通道前执行，清订阅凭据）
+  # 在宿主应用目录下，以运行服务的同一个系统账号执行
+  npx @turingflow/agent-kit login
+  npx @turingflow/agent-kit logout
   ```
-  宿主应用只需按同样方式实现（直接调用 `@tencent-ai/agent-sdk` 的
-  `unstable_v2_authenticate` / `unstable_v2_logout`），无需持有 kit 源码。
+  已安装依赖时也可用 `npm exec -- agent-kit login`。无桌面的服务器会打印登录链接供手动打开；`--no-open` 可跳过尝试启动浏览器。只有服务账号需要执行，应用最终用户无需逐人登录。
 - 国内网络默认 `CODEBUDDY_INTERNET_ENVIRONMENT=internal`（**SDK 已内置默认值，可不配**；国际版留空即可）
 - （推荐，否则无会话持久化）PostgreSQL 8+，账号可建库
 

package/bin/agent-kit.mjs

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+// 宿主应用可直接运行：npx @turingflow/agent-kit login | logout。
+import { existsSync, readFileSync } from "node:fs";
+import { spawn } from "node:child_process";
+import path from "node:path";
+import { unstable_v2_authenticate, unstable_v2_logout } from "@tencent-ai/agent-sdk";
+
+function loadHostEnv() {
+  const candidates = [process.env.AGENT_ENV_FILE, path.join(process.cwd(), ".env")].filter(Boolean);
+  for (const file of candidates) {
+    const resolved = path.resolve(file);
+    if (!existsSync(resolved)) continue;
+    for (const line of readFileSync(resolved, "utf8").split(/\r?\n/)) {
+      const trimmed = line.trim();
+      if (!trimmed || trimmed.startsWith("#")) continue;
+      const equal = trimmed.indexOf("=");
+      if (equal < 0) continue;
+      const key = trimmed.slice(0, equal).trim();
+      if (!key || key in process.env) continue;
+      let value = trimmed.slice(equal + 1).trim();
+      if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+        value = value.slice(1, -1);
+      }
+      process.env[key] = value;
+    }
+  }
+}
+
+function openBrowser(url) {
+  const [command, args] = process.platform === "win32"
+    ? ["cmd", ["/c", "start", "", url]]
+    : process.platform === "darwin"
+      ? ["open", [url]]
+      : ["xdg-open", [url]];
+  const child = spawn(command, args, { detached: true, stdio: "ignore" });
+  child.on("error", () => {}); // 无桌面的服务器可复制终端中的链接。
+  child.unref();
+}
+
+function help() {
+  console.log(`agent-kit CodeBuddy 订阅认证
+
+用法：
+  agent-kit login   登录运行应用的服务账号
+  agent-kit logout  清除该账号的 CodeBuddy 登录状态
+
+也可运行：npx @turingflow/agent-kit login
+登录凭据由 CodeBuddy 保存在当前系统账号下；应用最终用户无需逐人登录。`);
+}
+
+async function main() {
+  const command = process.argv[2];
+  if (!command || command === "help" || command === "--help" || command === "-h") return help();
+  if (command !== "login" && command !== "logout") {
+    help();
+    process.exitCode = 2;
+    return;
+  }
+
+  loadHostEnv();
+  const environment = process.env.CODEBUDDY_INTERNET_ENVIRONMENT?.trim() || "internal";
+  if (command === "logout") {
+    await unstable_v2_logout({ environment });
+    console.log("CodeBuddy 已退出登录。");
+    return;
+  }
+
+  console.log("正在登录 CodeBuddy。请在弹出的浏览器完成认证；无图形界面时复制下方链接。\n");
+  const result = await unstable_v2_authenticate({
+    environment,
+    onAuthUrl: ({ authUrl }) => {
+      console.log(`登录链接：${authUrl}`);
+      if (!process.argv.includes("--no-open")) openBrowser(authUrl);
+    },
+  });
+  console.log(`\n登录成功：${result.userinfo?.userNickname || result.userinfo?.userName || "服务账号"}。`);
+}
+
+main().catch((error) => {
+  console.error(`CodeBuddy 认证失败：${error instanceof Error ? error.message : String(error)}`);
+  process.exitCode = 1;
+});

package/dist/server/cli.d.ts

@@ -1,6 +1,5 @@
 /**
  * agent-kit · CLI（订阅对话演示/冒烟）
- * CodeBuddy 订阅的 login / logout 已移出 SDK，由宿主应用实现
- * （参考 apps/web/scripts/codebuddy-auth.mjs + npm run login / logout）。
+ * CodeBuddy 订阅登录由 agent-kit bin 命令提供：npx @turingflow/agent-kit login。
  */
 export {};

package/dist/server/cli.js

@@ -1,7 +1,6 @@
 /**
  * agent-kit · CLI（订阅对话演示/冒烟）
- * CodeBuddy 订阅的 login / logout 已移出 SDK，由宿主应用实现
- * （参考 apps/web/scripts/codebuddy-auth.mjs + npm run login / logout）。
+ * CodeBuddy 订阅登录由 agent-kit bin 命令提供：npx @turingflow/agent-kit login。
  */
 import { readFileSync, existsSync } from "node:fs";
 import { createInterface } from "node:readline/promises";
@@ -52,7 +51,7 @@ async function runDemo() {
         }
         catch (err) {
             console.error(`对话失败：${err instanceof Error ? err.message : err}`);
-            console.error("提示：请先在宿主应用中执行登录命令（如 web 的 npm run login）。");
+            console.error("提示：请先在宿主应用目录执行 npx @turingflow/agent-kit login。");
             break;
         }
     }
@@ -91,7 +90,7 @@ function printUsage() {
     console.log(`agent-kit CLI — 用法：
   npm run demo     预设订阅对话冒烟
   无参数            交互式订阅对话
-（CodeBuddy 订阅登录/登出见宿主应用：web 的 npm run login / npm run logout）`);
+（CodeBuddy 订阅登录/登出：npx @turingflow/agent-kit login / logout）`);
 }
 async function main() {
     loadDotEnv();

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "@turingflow/agent-kit",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "private": false,
   "type": "module",
   "description": "Agent 前后端一体 SDK：服务端订阅对话（CodeBuddy / hy3）+ 前端 workbuddy 风格聊天 UI。Next.js 工程后台引主入口、前台引 /ui",
   "main": "./dist/server/index.js",
   "types": "./dist/server/index.d.ts",
+  "bin": {
+    "agent-kit": "./bin/agent-kit.mjs"
+  },
   "exports": {
     ".": {
       "types": "./dist/server/index.d.ts",
@@ -19,6 +22,7 @@
     "./styles.css": "./dist/styles.css"
   },
   "files": [
+    "bin",
     "dist",
     "README.md",
     "LICENSE",