agent-bridge-aun 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,7 @@
-# Temporary Holding Version
+# AUN 通道插件
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`agent-bridge-aun` 为 mu-agent-bridge 提供 AUN 消息通道，支持使用已有 AID 或通过管理 API 注册 AID，并将收到的文本交给指定 Agent 插件处理。
+
+安装后在 ABWeb 的插件管理中启动 AUN 通道。配置 `aid` 和可选的 `agent_plugin`；默认 Agent 插件为 `qwenwork`。AID 创建接口为 `POST /api/plugins/aun/aid`，请求内容为 `{"aid":"新AID.agentid.cn","owner_aid":"所有者AID.agentid.cn"}`。
+
+该插件依赖 `@agentunion/fastaun`，要求 Node.js 22.16 或更高版本。

package/config.schema.json

@@ -0,0 +1,15 @@
+{
+  "type": "object",
+  "properties": {
+    "aid": { "type": "string", "minLength": 1 },
+    "owner_aid": { "type": "string", "minLength": 1 },
+    "agent_plugin": { "type": "string", "minLength": 1, "default": "qwenwork" },
+    "aun_path": { "type": "string", "minLength": 1 },
+    "encryption_seed": { "type": "string" },
+    "verify_ssl": { "type": "boolean", "default": true },
+    "root_ca_path": { "type": "string" },
+    "allow_from": { "type": "string" },
+    "delivery_mode": { "enum": ["fanout", "queue"] }
+  },
+  "additionalProperties": false
+}

package/dist/src-ts/agent.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentError = void 0;
+class AgentError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "AgentError";
+    }
+}
+exports.AgentError = AgentError;

package/dist/src-ts/channel.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src-ts/plugins/aun/index.js

@@ -0,0 +1,218 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AunPlugin = void 0;
+const promises_1 = require("node:fs/promises");
+const node_module_1 = require("node:module");
+const node_path_1 = require("node:path");
+const node_url_1 = require("node:url");
+const messages_1 = require("./messages");
+const manifest = {
+    id: "aun", version: "1.0.0", type: "channel", displayName: "AUN 通道",
+    entry: "dist/src-ts/plugins/aun/index.js", apiVersion: "1", process: "in-process",
+    capabilities: ["channel", "channel.identity.create", "channel.receive", "channel.send", "health"],
+    configSchema: "config.schema.json",
+};
+async function loadSdk() {
+    const resolver = (0, node_module_1.createRequire)(__filename);
+    const dynamicImport = new Function("url", "return import(url)");
+    for (const modules of resolver.resolve.paths("@agentunion/fastaun") ?? []) {
+        const packageRoot = (0, node_path_1.join)(modules, "@agentunion", "fastaun");
+        try {
+            const metadata = JSON.parse(await (0, promises_1.readFile)((0, node_path_1.join)(packageRoot, "package.json"), "utf8"));
+            const entry = typeof metadata.exports?.["."] === "object" ? metadata.exports["."]?.import : metadata.exports?.["."];
+            return await dynamicImport((0, node_url_1.pathToFileURL)((0, node_path_1.join)(packageRoot, entry ?? metadata.main ?? "index.js")).href);
+        }
+        catch { /* 继续查找上一级 node_modules */ }
+    }
+    throw new Error("未找到 @agentunion/fastaun，请确认 AUN 插件依赖已安装");
+}
+const aidPattern = /^[a-z0-9][a-z0-9_-]{2,63}\.[a-z0-9-]+(?:\.[a-z0-9-]+)+$/;
+class AunPlugin {
+    manifest = manifest;
+    context;
+    sdk;
+    store;
+    client;
+    subscription;
+    unregister;
+    ingress;
+    aid = "";
+    config = {};
+    status = "degraded";
+    healthMessage = "尚未配置 AID";
+    seen = new messages_1.DuplicateTracker();
+    constructor(options = {}) { this.sdk = options.sdk; this.ingress = options.ingress; }
+    async activate(context) {
+        this.context = context;
+        this.config = { ...context.config };
+        for (const key of ["aid", "owner_aid", "aun_path", "encryption_seed", "root_ca_path", "allow_from", "agent_plugin"]) {
+            if (this.config[key] !== undefined && typeof this.config[key] !== "string")
+                throw new Error(`${key} 必须是字符串`);
+        }
+        if (this.config.verify_ssl !== undefined && typeof this.config.verify_ssl !== "boolean")
+            throw new Error("verify_ssl 必须是布尔值");
+        if (this.config.delivery_mode !== undefined && !["fanout", "queue"].includes(String(this.config.delivery_mode)))
+            throw new Error("delivery_mode 只能是 fanout 或 queue");
+        if (this.config.aid && !aidPattern.test(String(this.config.aid)))
+            throw new Error("AID 格式无效");
+        if (this.config.owner_aid && !aidPattern.test(String(this.config.owner_aid)))
+            throw new Error("Owner AID 格式无效");
+        this.ingress ??= context.ingress;
+        if (!this.ingress)
+            throw new Error("运行时未提供通道消息入口");
+        this.sdk ??= await loadSdk();
+        await (0, promises_1.mkdir)(this.path(), { recursive: true });
+        this.store = this.newStore();
+        const disposer = context.http.register({ method: "POST", path: "/api/plugins/aun/aid", handler: this.createAid });
+        if (typeof disposer === "function")
+            this.unregister = disposer;
+        this.aid = typeof this.config.aid === "string" ? this.config.aid.trim() : "";
+        if (this.aid)
+            await this.connectAid(this.aid);
+    }
+    async connectAid(aid) {
+        try {
+            const loaded = this.store.load(aid);
+            if (!loaded.ok || !loaded.data)
+                throw new Error(loaded.error?.message ?? "本地密钥库中不存在该 AID");
+            this.client = new this.sdk.AUNClient(loaded.data.aid);
+            this.subscription = this.client.on("message.received", (payload) => this.onMessage(payload));
+            await this.client.connect();
+            this.status = "ready";
+            this.healthMessage = "已连接";
+        }
+        catch (error) {
+            this.status = "degraded";
+            this.healthMessage = safeError(error);
+            this.context?.logger.warn("AUN 通道连接失败", { error: this.healthMessage });
+            await this.closeClient();
+        }
+    }
+    async deactivate(_reason) {
+        this.status = "degraded";
+        this.subscription?.unsubscribe();
+        this.subscription = undefined;
+        await this.closeClient();
+        await this.store?.close();
+        this.store = undefined;
+        this.unregister?.();
+        this.unregister = undefined;
+        this.context?.http.unregister("aun");
+        this.context = undefined;
+    }
+    async health() {
+        return { status: this.status, message: this.healthMessage, details: { aid: this.aid || undefined, connected: this.status === "ready" } };
+    }
+    async handle(_request) { throw new Error("AUN 是入站通道插件"); }
+    path() {
+        const configured = this.config.aun_path;
+        return typeof configured === "string" && configured.trim() ? configured : (0, node_path_1.join)(this.context.dataDir, "aun");
+    }
+    newStore() {
+        return new this.sdk.AIDStore({ aunPath: this.path(), encryptionSeed: typeof this.config.encryption_seed === "string" ? this.config.encryption_seed : "", verifySsl: typeof this.config.verify_ssl === "boolean" ? this.config.verify_ssl : true, rootCaPath: this.config.root_ca_path });
+    }
+    createAid = async (request, response) => {
+        let input;
+        try {
+            let body = "";
+            for await (const chunk of request) {
+                body += Buffer.isBuffer(chunk) ? chunk.toString("utf8") : String(chunk);
+                if (body.length > 65536)
+                    throw new Error("请求内容过大");
+            }
+            input = JSON.parse(body);
+        }
+        catch (error) {
+            return this.json(response, 400, { error: error instanceof Error && error.message === "请求内容过大" ? error.message : "JSON 请求格式无效" });
+        }
+        const aid = input && typeof input === "object" && typeof input.aid === "string" ? input.aid.trim() : "";
+        if (!aidPattern.test(aid))
+            return this.json(response, 400, { error: "AID 格式无效" });
+        if (this.aid && aid !== this.aid)
+            return this.json(response, 409, { error: "创建其他身份前请先停止当前 AID" });
+        if (aid === this.aid)
+            return this.json(response, 200, { aid, status: "existing", connection: this.status });
+        try {
+            const body = input;
+            const owner = typeof body.owner_aid === "string" && body.owner_aid.trim()
+                ? body.owner_aid.trim()
+                : typeof this.config.owner_aid === "string" ? this.config.owner_aid.trim() : "";
+            if (!owner)
+                return this.json(response, 400, { error: "创建 AID 时必须提供 Owner AID" });
+            if (!aidPattern.test(owner))
+                return this.json(response, 400, { error: "Owner AID 格式无效" });
+            const result = await this.store.register({ aid, type: "agent", owner });
+            if (!result.ok)
+                return this.json(response, 502, { error: result.error?.code ?? "注册失败", message: redact(result.error?.message ?? "AID 注册失败") });
+            if (result.data?.ownership_status !== "active")
+                return this.json(response, 202, { aid, owner, status: "等待 Owner 确认", operation_id: result.data?.operation_id });
+            this.config.aid = aid;
+            this.config.owner_aid = owner;
+            this.config.aun_path = this.path();
+            await (0, promises_1.mkdir)(this.context.dataDir, { recursive: true });
+            await (0, promises_1.writeFile)((0, node_path_1.join)(this.context.dataDir, "config.json"), `${JSON.stringify(this.config, null, 2)}\n`, { mode: 0o600 });
+            this.aid = aid;
+            await this.connectAid(aid);
+            return this.json(response, 201, { aid, status: "已创建", connection: this.status });
+        }
+        catch (error) {
+            this.context?.logger.warn("AUN AID 注册失败", { error: safeError(error) });
+            return this.json(response, 502, { error: safeError(error) });
+        }
+    };
+    async onMessage(payload) {
+        const message = (0, messages_1.normalizeAunMessage)(payload, this.aid, typeof this.config.allow_from === "string" ? this.config.allow_from : undefined);
+        if (!message || !this.seen.add(message.messageId ?? ""))
+            return;
+        const channelMessage = {
+            channel: "aun", peerId: message.peerId, messageId: message.messageId, text: message.text, threadId: message.threadId,
+            agentPlugin: typeof this.config.agent_plugin === "string" && this.config.agent_plugin.trim() ? this.config.agent_plugin.trim() : "qwenwork",
+            reply: async (text) => {
+                if (!text.trim())
+                    return;
+                const payload = { type: "text", text };
+                if (message.threadId)
+                    payload.thread_id = message.threadId;
+                const params = { to: message.peerId, payload, encrypt: true };
+                try {
+                    await this.client.call("message.send", params);
+                }
+                catch (error) {
+                    if (!this.isE2eeError(error))
+                        throw error;
+                    await this.client.call("message.send", { ...params, encrypt: false });
+                }
+            },
+        };
+        try {
+            await this.ingress.publish(channelMessage);
+        }
+        catch (error) {
+            this.context?.logger.warn("AUN 消息处理失败", { error: safeError(error) });
+        }
+    }
+    isE2eeError(error) {
+        const sdk = this.sdk;
+        return [sdk.E2EEError, sdk.E2EEDecryptFailedError, sdk.E2EEDegradedError].some((type) => !!type && error instanceof type)
+            || (error instanceof Error && /^(E2EE|E2EE[A-Za-z]+Error)/.test(error.name));
+    }
+    async closeClient() {
+        const client = this.client;
+        this.client = undefined;
+        if (client)
+            await client.close();
+    }
+    json(response, status, value) {
+        response.statusCode = status;
+        response.setHeader("content-type", "application/json; charset=utf-8");
+        response.end(JSON.stringify(value));
+    }
+}
+exports.AunPlugin = AunPlugin;
+exports.default = AunPlugin;
+function safeError(error) {
+    return redact(error instanceof Error ? error.message : String(error)).slice(0, 240);
+}
+function redact(message) {
+    return message.replace(/(private[_ -]?key|seed|token|certificate)\s*[:=]\s*[^\s,;]+/gi, "$1=[已隐藏]");
+}

package/dist/src-ts/plugins/aun/messages.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DuplicateTracker = void 0;
+exports.normalizeAunMessage = normalizeAunMessage;
+function normalizeAunMessage(payload, selfAid, allowFrom) {
+    if (!payload || typeof payload !== "object")
+        return undefined;
+    const data = payload;
+    const peerId = typeof data.from === "string" ? data.from.trim() : "";
+    const rules = (allowFrom ?? "").split(",").map((value) => value.trim()).filter(Boolean);
+    if (!peerId || peerId === selfAid || (rules.length > 0 && !rules.includes(peerId)))
+        return undefined;
+    const body = data.payload && typeof data.payload === "object" ? data.payload : {};
+    const text = typeof data.payload === "string" ? data.payload : typeof body.text === "string" ? body.text : "";
+    if (!text.trim())
+        return undefined;
+    return {
+        peerId,
+        ...(typeof data.message_id === "string" ? { messageId: data.message_id } : {}),
+        text,
+        ...(typeof body.thread_id === "string" ? { threadId: body.thread_id } : {}),
+    };
+}
+class DuplicateTracker {
+    limit;
+    ttlMs;
+    ids = new Map();
+    constructor(limit = 10000, ttlMs = 5 * 60 * 1000) {
+        this.limit = limit;
+        this.ttlMs = ttlMs;
+    }
+    add(id, now = Date.now()) {
+        if (!id)
+            return true;
+        const seen = this.ids.get(id);
+        if (seen !== undefined && now - seen < this.ttlMs)
+            return false;
+        this.ids.delete(id);
+        this.ids.set(id, now);
+        while (this.ids.size > this.limit)
+            this.ids.delete(this.ids.keys().next().value);
+        return true;
+    }
+}
+exports.DuplicateTracker = DuplicateTracker;

package/package.json

@@ -1,6 +1,13 @@
 {
   "name": "agent-bridge-aun",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "mu-agent-bridge 的 AUN 通道插件。",
+  "keywords": ["mu-agent-bridge-plugin", "mu-agent-bridge-channel"],
+  "repository": { "type": "git", "url": "https://codeup.aliyun.com/6808da56fb3da14b899afd54/agent_bridge.git", "directory": "packages/aun" },
+  "main": "dist/src-ts/plugins/aun/index.js",
+  "files": ["dist/", "plugin.json", "config.schema.json", "README.md"],
+  "agentBridge": { "plugin": "./plugin.json", "type": "channel" },
+  "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" },
+  "engines": { "node": ">=22.16.0" },
+  "dependencies": { "@agentunion/fastaun": "0.5.18" }
+}

package/plugin.json

@@ -0,0 +1,11 @@
+{
+  "id": "aun",
+  "version": "1.0.0",
+  "type": "channel",
+  "displayName": "AUN 通道",
+  "entry": "dist/src-ts/plugins/aun/index.js",
+  "apiVersion": "1",
+  "process": "in-process",
+  "capabilities": ["channel", "channel.identity.create", "channel.receive", "channel.send", "health"],
+  "configSchema": "config.schema.json"
+}