@turingflow/agent-kit 0.0.0-stage → 0.1.0

package/dist/server/kit-api.js

@@ -0,0 +1,153 @@
+/**
+ * 统一 API 路由工厂：一个 catch-all 文件挂载 agent-kit 的全部 HTTP 端点。
+ *
+ * 集成方只需建一个文件 app/api/[...path]/route.js：
+ *   import { createAgentKitApi } from "agent-kit";
+ *   export const runtime = "nodejs";
+ *   export const dynamic = "force-dynamic";
+ *   export const { GET, POST, PATCH, DELETE } = createAgentKitApi({
+ *     agent: { chat: { allowBash: false } },
+ *   });
+ *
+ * 内部复用现有端点工厂（createAgentApiRoute / createSessionHandlers /
+ * createShareHandlers / createLoginHandlers），按 [方法, 路径段] 分发；
+ * 未知路径 → 404，未导出的方法 → 由 Next 自动 405。
+ * 以后 kit 新增任何端点只改 agent-kit，应用端零改动。
+ */
+import { createAgentApiRoute } from "./handlers.js";
+import { createSessionHandlers } from "./sessions.js";
+import { createShareHandlers } from "./share.js";
+import { createLoginHandlers } from "./auth/handlers.js";
+import { createUserFilesHandlers } from "./user-files.js";
+import { getModelOptions } from "./model-sources.js";
+const METHOD_NOT_ALLOWED = () => Response.json({ error: "method_not_allowed" }, { status: 405 });
+const SUPPORTED = "/api/chat、/api/chat/answer、/api/chat/steer、/api/chat/browser-answer、/api/upload、" +
+    "/api/voice/token、/api/voice/transcribe、/api/artifact、/api/sessions(+子资源)、" +
+    "/api/models/list、/api/models/context、/api/share(+token)、/api/auth/*、" +
+    "/api/user-files(+raw/mkdir/rename)";
+export function createAgentKitApi(options = {}) {
+    // 复用现有端点工厂，不重写任何业务逻辑
+    const agentRoute = createAgentApiRoute(options.agent ?? {});
+    const session = createSessionHandlers();
+    const share = createShareHandlers();
+    const login = createLoginHandlers(options.login);
+    const userFiles = createUserFilesHandlers();
+    const notFound = (detail) => Response.json({ error: `未找到该端点（${detail}）。agent-kit 支持：${SUPPORTED}` }, { status: 404 });
+    async function dispatch(method, request, context = {}) {
+        const raw = (await Promise.resolve(context.params ?? {}));
+        const segments = raw.path ?? [];
+        const [a, b, c] = segments;
+        const idCtx = { params: { id: b } }; // /sessions/:id/*
+        const tokenCtx = { params: { token: b } }; // /share/:token
+        // ---- agent group（chat / upload / voice / artifact）：复用现有 catch-all ----
+        if (a === "chat" || a === "upload" || a === "voice") {
+            if (method === "POST")
+                return agentRoute.POST(request, { params: { agent: segments } });
+            return notFound(`POST /api/${segments.join("/")}`);
+        }
+        if (a === "artifact") {
+            if (method === "GET")
+                return agentRoute.GET(request, { params: { agent: segments } });
+            return notFound("GET /api/artifact");
+        }
+        // ---- sessions ----
+        if (a === "sessions") {
+            if (!b) {
+                if (method === "GET")
+                    return session.list(request);
+                if (method === "POST")
+                    return session.create(request);
+                return METHOD_NOT_ALLOWED();
+            }
+            if (!c) {
+                if (method === "PATCH")
+                    return session.rename(request, idCtx);
+                if (method === "DELETE")
+                    return session.remove(request, idCtx);
+                return METHOD_NOT_ALLOWED();
+            }
+            if (c === "messages") {
+                if (method === "GET")
+                    return session.messages(request, idCtx);
+                if (method === "POST")
+                    return session.appendMessage(request, idCtx);
+                return METHOD_NOT_ALLOWED();
+            }
+            if (c === "auto-title" && method === "POST")
+                return session.autoTitle(request, idCtx);
+            if (c === "truncate" && method === "POST")
+                return session.truncate(request, idCtx);
+            if (c === "fork" && method === "POST")
+                return session.fork(request, idCtx);
+            if (c === "close-sdk" && method === "POST")
+                return session.closeSdk(request, idCtx);
+            return notFound(`/api/sessions/${b}/${c}`);
+        }
+        // ---- user-files（用户可操作区：目录名 = 登录用户 id，跨会话共享）----
+        if (a === "user-files") {
+            if (method === "GET")
+                return userFiles.GET(request);
+            if (method === "POST")
+                return userFiles.POST(request);
+            if (method === "DELETE")
+                return userFiles.DELETE(request);
+            return METHOD_NOT_ALLOWED();
+        }
+        // ---- share ----
+        if (a === "share") {
+            if (!b) {
+                if (method === "POST")
+                    return share.create.POST(request);
+                return METHOD_NOT_ALLOWED();
+            }
+            if (b === "jsapi-sign") {
+                if (method === "POST")
+                    return share.jsapiSign.POST(request);
+                return METHOD_NOT_ALLOWED();
+            }
+            // /share/:token
+            if (method === "GET")
+                return share.view.GET(request, tokenCtx);
+            if (method === "POST")
+                return share.send.POST(request, tokenCtx);
+            return METHOD_NOT_ALLOWED();
+        }
+        // ---- models（模型上下文窗口上限） ----
+        if (a === "models" && b === "context" && method === "GET")
+            return session.modelContext(request);
+        // ---- models/list（下拉模型来源：models.json 自定义模型优先，否则 env AGENT_MODEL_LIST 兜底） ----
+        if (a === "models" && b === "list" && method === "GET") {
+            return Response.json({ models: getModelOptions() });
+        }
+        // ---- admin（用量页登录保护：admin/admin，未登录 401） ----
+        if (a === "admin") {
+            if (b === "login" && method === "POST")
+                return session.adminLogin(request);
+            if (b === "logout" && method === "POST")
+                return session.adminLogout();
+            if (b === "usage" && method === "GET")
+                return session.adminUsage(request);
+            return notFound(`/api/admin/${b ?? ""}`);
+        }
+        // ---- auth ----
+        if (a === "auth") {
+            if (b === "login" && method === "GET")
+                return login.login.GET(request);
+            if (b === "callback" && method === "GET")
+                return login.callback.GET(request);
+            if (b === "sso" && method === "POST")
+                return login.sso.POST(request);
+            if (b === "session" && method === "GET")
+                return login.session.GET(request);
+            if (b === "logout" && method === "POST")
+                return login.logout.POST(request);
+            return notFound(`/api/auth/${b ?? ""}`);
+        }
+        return notFound(`/api/${segments.join("/") || ""}`);
+    }
+    const GET = (request, context = {}) => dispatch("GET", request, context);
+    const POST = (request, context = {}) => dispatch("POST", request, context);
+    const PATCH = (request, context = {}) => dispatch("PATCH", request, context);
+    const DELETE = (request, context = {}) => dispatch("DELETE", request, context);
+    return { GET, POST, PATCH, DELETE };
+}

package/dist/server/model-sources.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 模型来源解析（agent-kit 通用能力，供所有宿主复用）：
+ *
+ *   1. 若用户级 ~/.codebuddy/models.json 配置了自定义模型 → 优先返回这些模型
+ *      （每项 { id, name, meta }，meta 已剔除 apiKey，可安全下发前端）；
+ *   2. 否则回退到环境变量 AGENT_MODEL_LIST（逗号分隔的纯 id 字符串）。
+ *
+ * 这是 CodeBuddy 的原生自定义模型机制：models.json 是数组、字段多、由开发者手动维护，
+ * agent-kit 只负责读取并暴露给前端下拉，不代为生成。应用端无需感知这套逻辑——
+ * 直接调用 getModelOptions()，或让前端自动从 /api/models/list 拉取即可。
+ */
+/** 模型选项：兼容「纯 id 字符串」与「{id, name, meta} 对象」两种来源。 */
+export type ServerModelOption = string | {
+    id: string;
+    name?: string;
+    meta?: Record<string, unknown>;
+};
+/**
+ * 读取用户级 ~/.codebuddy/models.json 的自定义模型。
+ * 不存在 / 损坏 / models 为空 → 返回 null。
+ * 返回的 meta 已剔除 apiKey（绝不把密钥下发前端或写进日志）。
+ */
+export declare function readCodeBuddyModels(): {
+    id: string;
+    name: string;
+    meta: Record<string, unknown>;
+}[] | null;
+/**
+ * 解析下拉模型列表：自定义模型优先，否则 env AGENT_MODEL_LIST 兜底。
+ * 返回值直接序列化给前端（已剔除 apiKey）。
+ */
+export declare function getModelOptions(): ServerModelOption[];

package/dist/server/model-sources.js

@@ -0,0 +1,58 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+const CODEBUDDY_HOME = path.join(os.homedir(), ".codebuddy");
+/**
+ * 读取用户级 ~/.codebuddy/models.json 的自定义模型。
+ * 不存在 / 损坏 / models 为空 → 返回 null。
+ * 返回的 meta 已剔除 apiKey（绝不把密钥下发前端或写进日志）。
+ */
+export function readCodeBuddyModels() {
+    const filePath = path.join(CODEBUDDY_HOME, "models.json");
+    try {
+        if (!fs.existsSync(filePath))
+            return null;
+        const cfg = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+        const arr = cfg?.models;
+        if (!Array.isArray(arr) || arr.length === 0)
+            return null;
+        const list = arr
+            .map((m) => {
+            if (!m || typeof m !== "object")
+                return null;
+            const rec = m;
+            const id = typeof rec.id === "string" ? rec.id.trim() : "";
+            if (!id)
+                return null;
+            // 剔除 apiKey：绝不下发密钥
+            const { apiKey: _apiKey, ...meta } = rec;
+            void _apiKey;
+            return {
+                id,
+                name: typeof rec.name === "string" ? rec.name.trim() : "",
+                meta,
+            };
+        })
+            .filter(Boolean);
+        return list.length > 0 ? list : null;
+    }
+    catch {
+        // 文件损坏 / 不可读 → 回退 env
+        return null;
+    }
+}
+/**
+ * 解析下拉模型列表：自定义模型优先，否则 env AGENT_MODEL_LIST 兜底。
+ * 返回值直接序列化给前端（已剔除 apiKey）。
+ */
+export function getModelOptions() {
+    const custom = readCodeBuddyModels();
+    if (custom && custom.length > 0) {
+        return custom.map((m) => ({ id: m.id, name: m.name || undefined, meta: m.meta }));
+    }
+    const envList = (process.env.AGENT_MODEL_LIST || "")
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+    return envList;
+}

package/dist/server/oa.d.ts

@@ -0,0 +1,87 @@
+/** 钉钉企业内部应用 access_token（gettoken）。 */
+export declare function getDingTalkToken(appKey: string, appSecret: string): Promise<string>;
+/** 钉钉 jsapi_ticket（H5 JSAPI 前端鉴权用）。 */
+export declare function getDingTalkJsapiTicket(appKey: string, appSecret: string): Promise<string>;
+/**
+ * 根据 unionId 解析企业内 userid（OAuth 登录未落 user_code 时，分享发送链路兜底用）。
+ * 接口：POST /topapi/v2/user/getbyunionid（文档另列旧路径 /topapi/user/getbyunionid，失败自动回退）。
+ * 权限：成员信息读权限；缺权限或解析失败返回空串，由调用方决定如何报错。
+ */
+export declare function resolveDingTalkUserIdByUnionId(appKey: string, appSecret: string, unionId: string): Promise<string>;
+/** 钉钉 H5 JSAPI dd.config 签名参数（企业内部应用 · 官方新版算法）。
+ *
+ * 重要（2025+ 新版网页应用/H5 微应用，见开放平台《JSAPI鉴权》/《开发网页应用前端》）：
+ *   plain = "jsapi_ticket=" + ticket + "&noncestr=" + nonceStr + "&timestamp=" + timeStamp + "&url=" + decodeUrl(url)
+ *   signature = SHA256(plain)
+ * 旧版微应用是 sha1(ticket+nonceStr+timeStamp+url) 纯拼接，新版必须用上面的键值对 + SHA-256，
+ * 否则钉钉端重算签名不一致 → dd.config 报 errorCode 9「签名校验失败」（参数全一致也会失败）。
+ */
+export declare function dingTalkJsapiConfig(appKey: string, appSecret: string, corpId: string, agentId: string, url: string): Promise<{
+    agentId: string;
+    corpId: string;
+    timeStamp: string;
+    nonceStr: string;
+    signature: string;
+}>;
+/**
+ * 钉钉「发送普通消息」：向 JSAPI 选中的一次性会话 cid 发消息。
+ * opts.url 提供时发 markdown 消息（title + 链接），钉钉客户端渲染为带预览的链接卡片；
+ * 否则回退纯文本（兼容旧调用）。
+ */
+export declare function sendDingTalkMessage(appKey: string, appSecret: string, cid: string, sender: string, text: string, opts?: {
+    title?: string;
+    url?: string;
+}): Promise<void>;
+/** 飞书 tenant_access_token（企业内部应用）。 */
+export declare function getFeishuTenantToken(appId: string, appSecret: string, baseUrl: string): Promise<string>;
+/** 飞书 jsapi_ticket（H5 JSAPI 前端鉴权用）。 */
+export declare function getFeishuJsapiTicket(appId: string, appSecret: string, baseUrl: string): Promise<string>;
+/** 飞书 H5 JSAPI（window.h5sdk.config）签名参数。 */
+export declare function feishuJsapiConfig(appId: string, appSecret: string, baseUrl: string, url: string): Promise<{
+    appId: string;
+    timestamp: number;
+    nonceStr: string;
+    signature: string;
+}>;
+/**
+ * 飞书「发送消息」到会话（chat_id）。
+ * opts.url 提供时发 link 消息（title/text/message_link），飞书客户端渲染为链接卡片预览；
+ * 否则回退文本消息（兼容旧调用）。
+ */
+export declare function sendFeishuMessage(appId: string, appSecret: string, baseUrl: string, chatId: string, text: string, opts?: {
+    title?: string;
+    url?: string;
+}): Promise<void>;
+/**
+ * 飞书「以当前用户身份」发送消息（user_access_token）。
+ * 不要求应用机器人加入目标会话（用户本就在自己的会话里）；
+ * 需应用开通 im:message + im:message.send_as_user（用户身份读发消息）且 OAuth 授权 scope 含 im:message。
+ * 注意：im/v1/messages 不支持 msg_type=link（历史 API 才有），带链接时发 interactive 卡片：
+ * 大卡片 + 标题竖线 + 直接展示聊天摘要 + 整卡点击跳转（豆包分享同款样式）。
+ */
+export declare function sendFeishuMessageAsUser(userAccessToken: string, baseUrl: string, chatId: string, text: string, opts?: {
+    title?: string;
+    url?: string;
+    chatSummary?: string;
+}): Promise<void>;
+/**
+ * 飞书 user_access_token 刷新（OAuth offline_access scope）。
+ * 返回 { accessToken, refreshToken }；refreshToken 为空时表示飞书未返回新刷新令牌（保留旧值）。
+ */
+export declare function refreshFeishuUserToken(appId: string, appSecret: string, baseUrl: string, refreshToken: string): Promise<{
+    accessToken: string;
+    refreshToken: string | null;
+}>;
+/** 飞书 app_access_token（内部应用；OAuth token 刷新等场景用）。 */
+export declare function getFeishuAppAccessToken(appId: string, appSecret: string, baseUrl: string): Promise<string>;
+/**
+ * 钉钉机器人发送群聊消息（企业内部应用机器人）。
+ * POST /v1.0/robot/groupMessages/send —— 接受 chooseChat 选会话返回的 openConversationId（旧接口
+ * send_to_conversation 只认旧格式 cid 且"不再支持新应用接入"，故改用本接口）。
+ * 前置条件：应用已申请「企业内机器人发送消息权限」，且机器人已加入目标群。
+ * robotCode 未显式配置时用应用 AppKey（企业内部应用机器人 code = AppKey）。
+ */
+export declare function sendDingTalkRobotGroupMessage(appKey: string, appSecret: string, robotCode: string, openConversationId: string, markdown: {
+    title: string;
+    text: string;
+}): Promise<void>;