@turingflow/agent-kit 0.0.0-stage → 0.1.0

package/dist/upload.d.ts

@@ -0,0 +1,13 @@
+export interface UploadOptions {
+    /** 保存目录（默认 <cwd>/public/uploads） */
+    dir?: string;
+    /** 单文件大小上限字节（默认 20MB） */
+    maxBytes?: number;
+    /** 允许的 MIME → 扩展名映射（默认覆盖图片/PDF/Office/文本/压缩包） */
+    allowedTypes?: Record<string, string>;
+    /** 返回给前端的 URL 前缀（默认 /uploads，配合 public 目录静态访问） */
+    urlPrefix?: string;
+}
+export declare function createUploadHandler(options?: UploadOptions): {
+    POST: (request: Request) => Promise<Response>;
+};

package/dist/upload.js

@@ -0,0 +1,81 @@
+/**
+ * agent-kit · 附件上传端点（Next.js App Router 通用 handler）
+ *
+ * 默认把文件保存到 <cwd>/public/uploads/ 并返回可访问的相对 URL，
+ * 与前端 ChatWindow 的「+ 上传 / 拖拽添加」流程对接。
+ * 第三方 Next.js 工程只需在 app/api/upload/route.js 里：
+ *   import { createUploadHandler } from "agent-kit";
+ *   export const { POST } = createUploadHandler();
+ */
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import crypto from "node:crypto";
+const DEFAULT_ALLOWED = {
+    "image/jpeg": "jpg",
+    "image/jpg": "jpg",
+    "image/png": "png",
+    "image/webp": "webp",
+    "image/gif": "gif",
+    "application/pdf": "pdf",
+    "text/plain": "txt",
+    "application/msword": "doc",
+    "application/vnd.openxmlformats-officedocument.wordprocessingml.document": "docx",
+    "application/vnd.ms-excel": "xls",
+    "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": "xlsx",
+    "application/zip": "zip",
+};
+function extFromName(name = "") {
+    const i = name.lastIndexOf(".");
+    return i >= 0 ? name.slice(i + 1).toLowerCase() : "";
+}
+/** 文件名安全化：替换 Windows/URL 非法字符与空白，保留中文等可读字符，截断防超长 */
+function safeName(name = "") {
+    return name.replace(/[\\/:*?"<>|\s]+/g, "_").replace(/^_+|_+$/g, "").slice(0, 80);
+}
+export function createUploadHandler(options = {}) {
+    const dir = options.dir ?? path.join(process.cwd(), "public", "uploads");
+    const maxBytes = options.maxBytes ?? 20 * 1024 * 1024;
+    const allowed = options.allowedTypes ?? DEFAULT_ALLOWED;
+    const urlPrefix = (options.urlPrefix ?? "/uploads").replace(/\/+$/, "");
+    async function POST(request) {
+        let form;
+        try {
+            form = await request.formData();
+        }
+        catch {
+            return Response.json({ ok: false, error: "请求格式错误" }, { status: 400 });
+        }
+        const file = form.get("file");
+        if (!file || typeof file === "string" || !file.size) {
+            return Response.json({ ok: false, error: "没有收到文件" }, { status: 400 });
+        }
+        const ext = allowed[String(file.type).toLowerCase()] || extFromName(file.name);
+        if (!ext) {
+            return Response.json({ ok: false, error: "不支持的文件类型（支持图片/PDF/Office/文本/压缩包）" }, { status: 400 });
+        }
+        const buf = Buffer.from(await file.arrayBuffer());
+        if (buf.length > maxBytes) {
+            return Response.json({ ok: false, error: `文件超过 ${Math.floor(maxBytes / 1024 / 1024)}MB 上限` }, { status: 400 });
+        }
+        try {
+            await mkdir(dir, { recursive: true });
+            // 保留原文件名（uuid 前缀防冲突）：模型/用户能对得上文件名，
+            // 配合 chat handler 注入的磁盘路径即可直接 Read。
+            // 去掉原名扩展名再追加规范扩展名，避免 "光伏设备.txt.txt"。
+            const nameBase = safeName(file.name).replace(/\.[^./\\]+$/, "") || "file";
+            const filename = `${crypto.randomUUID()}_${nameBase}.${ext}`;
+            await writeFile(path.join(dir, filename), buf);
+            return Response.json({
+                ok: true,
+                url: `${urlPrefix}/${filename}`,
+                name: file.name,
+                size: buf.length,
+                mime: file.type,
+            });
+        }
+        catch (error) {
+            return Response.json({ ok: false, error: error instanceof Error ? error.message : String(error) }, { status: 500 });
+        }
+    }
+    return { POST };
+}

package/dist/voice.d.ts

@@ -0,0 +1,25 @@
+export interface VoiceUser {
+    userId?: string;
+    name?: string;
+    sub?: string;
+    nick?: string;
+}
+export declare function createVoiceToken(user: VoiceUser, { ttlSeconds }?: {
+    ttlSeconds?: number;
+}): {
+    token: string;
+    tokenType: string;
+    expiresAt: number;
+};
+export declare function verifyVoiceToken(token: string | null | undefined): {
+    purpose?: string;
+    exp?: number;
+} | null;
+export declare function transcribeVoice({ bytes, mimeType, fileName, }: {
+    bytes: Buffer;
+    mimeType: string;
+    fileName: string;
+}): Promise<{
+    text: string;
+    provider: string;
+}>;

package/dist/voice.js

@@ -0,0 +1,61 @@
+/**
+ * agent-kit · 语音输入服务端（Next.js App Router 通用 handler）
+ *
+ * 短时令牌（HMAC-SHA256 签名，默认 10 分钟有效）+ ASR 转写。
+ * 前端录音前先取 token，再带 Bearer token 调 transcribe 接口。
+ * 默认转写后端：BrandAgent / 小米 MiMo（见 transcription/xiaomi-mimo.ts）。
+ */
+import { createHmac, timingSafeEqual } from "node:crypto";
+import { transcribeWithXiaomiMimo } from "./transcription/xiaomi-mimo.js";
+const DEFAULT_TTL_MS = 10 * 60 * 1000;
+function tokenSecret() {
+    return (process.env.AGENT_KIT_VOICE_TOKEN_SECRET ||
+        process.env.HOTLINE_ASR_TOKEN_SECRET ||
+        process.env.HOTLINE_SESSION_SECRET ||
+        "agent-kit-2026");
+}
+function sign(value) {
+    return createHmac("sha256", tokenSecret()).update(value).digest("base64url");
+}
+export function createVoiceToken(user, { ttlSeconds } = {}) {
+    const ttlMs = Math.min(DEFAULT_TTL_MS, Math.max(60_000, (Number(ttlSeconds) || 600) * 1000));
+    const payload = Buffer.from(JSON.stringify({
+        purpose: "agent-kit-voice",
+        sub: user.userId || user.sub || "user",
+        name: user.name || user.nick || "",
+        exp: Date.now() + ttlMs,
+    })).toString("base64url");
+    return { token: `${payload}.${sign(payload)}`, tokenType: "Bearer", expiresAt: Date.now() + ttlMs };
+}
+export function verifyVoiceToken(token) {
+    if (!token || !token.includes("."))
+        return null;
+    const [payload, signature] = token.split(".");
+    if (!payload || !signature)
+        return null;
+    const expected = Buffer.from(sign(payload));
+    const provided = Buffer.from(signature);
+    if (provided.length !== expected.length || !timingSafeEqual(provided, expected))
+        return null;
+    try {
+        const data = JSON.parse(Buffer.from(payload, "base64url").toString("utf8"));
+        if (data.purpose !== "agent-kit-voice")
+            return null;
+        if (typeof data.exp !== "number" || data.exp <= Date.now())
+            return null;
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+// 按环境变量选择转写后端（默认小米 MiMo，经 BrandAgent 平台）。
+export async function transcribeVoice({ bytes, mimeType, fileName, }) {
+    const provider = (process.env.AGENT_KIT_ASR_PROVIDER || process.env.HOTLINE_ASR_PROVIDER || "xiaomi")
+        .trim()
+        .toLowerCase();
+    if (provider === "tencent" || provider === "tencent-cloud") {
+        throw new Error("腾讯云转写未接入（agent-kit 默认提供 BrandAgent / 小米 MiMo）");
+    }
+    return transcribeWithXiaomiMimo({ bytes, mimeType, fileName });
+}

package/package.json

@@ -1,6 +1,76 @@
 {
   "name": "@turingflow/agent-kit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "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",
+  "exports": {
+    ".": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js",
+      "default": "./dist/server/index.js"
+    },
+    "./ui": {
+      "types": "./dist/ui/index.d.ts",
+      "import": "./dist/ui/index.js"
+    },
+    "./styles.css": "./dist/styles.css"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
+  "scripts": {
+    "build": "npm run build:server && npm run build:ui && npm run build:css",
+    "build:server": "tsc -p tsconfig.json",
+    "build:ui": "tsup --config tsup.ui.config.ts",
+    "build:css": "node scripts/check-css-comments.cjs && node -e \"require('fs').copyFileSync('src/ui/styles.css','dist/styles.css')\"",
+    "dev": "tsc -w -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.ui.json --noEmit",
+    "test:artifacts": "tsx scripts/test-all-artifacts.ts",
+    "test:tool-activity": "tsx scripts/test-tool-activity.ts",
+    "test:markdown": "tsx scripts/test-assistant-text.tsx",
+    "test:fork": "tsx scripts/test-session-fork.ts",
+    "demo": "tsx src/server/cli.ts --demo",
+    "cli": "tsx src/server/cli.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@summersmile/voice-dictation": "^0.1.0",
+    "@tencent-ai/agent-sdk": "^0.3.266",
+    "mammoth": "^1.13.0",
+    "pg": "^8.23.1",
+    "playwright": "^1.63.0",
+    "prismjs": "1.30.0",
+    "react-markdown": "^10.1.0",
+    "rehype-highlight": "^7.0.2",
+    "rehype-raw": "^7.0.0",
+    "rehype-sanitize": "^6.0.0",
+    "rehype-stringify": "^10.0.1",
+    "remark-gfm": "^4.0.1",
+    "remark-parse": "^11.0.0",
+    "remark-rehype": "^11.1.2",
+    "unified": "^11.0.5",
+    "zod": "^4.6.5"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.3",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "tsup": "^8.3.5",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}