multiclaws 0.4.41 → 0.4.43

package/dist/index.js

@@ -1,703 +1,703 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const handlers_1 = require("./gateway/handlers");
-const multiclaws_service_1 = require("./service/multiclaws-service");
-const logger_1 = require("./infra/logger");
-const telemetry_1 = require("./infra/telemetry");
-const version_1 = require("./infra/version");
-/** Default FRP tunnel config for demo/testing */
-const DEFAULT_TUNNEL = {
-    type: "frp",
-    serverAddr: "39.105.143.2",
-    serverPort: 7000,
-    token: "jushi@5202fRp",
-    portRangeStart: 7011,
-    portRangeEnd: 7020,
-};
-function readConfig(api) {
-    const raw = (api.pluginConfig ?? {});
-    let tunnel;
-    const rawTunnel = raw.tunnel;
-    if (rawTunnel && rawTunnel.type === "frp") {
-        tunnel = {
-            type: "frp",
-            serverAddr: typeof rawTunnel.serverAddr === "string" ? rawTunnel.serverAddr : DEFAULT_TUNNEL.serverAddr,
-            serverPort: typeof rawTunnel.serverPort === "number" ? rawTunnel.serverPort : DEFAULT_TUNNEL.serverPort,
-            token: typeof rawTunnel.token === "string" ? rawTunnel.token : DEFAULT_TUNNEL.token,
-            portRangeStart: typeof rawTunnel.portRangeStart === "number" ? rawTunnel.portRangeStart : DEFAULT_TUNNEL.portRangeStart,
-            portRangeEnd: typeof rawTunnel.portRangeEnd === "number" ? rawTunnel.portRangeEnd : DEFAULT_TUNNEL.portRangeEnd,
-        };
-    }
-    else {
-        // No tunnel configured — use built-in default for demo
-        tunnel = { ...DEFAULT_TUNNEL };
-    }
-    return {
-        port: typeof raw.port === "number" ? raw.port : undefined,
-        displayName: typeof raw.displayName === "string" ? raw.displayName : undefined,
-        selfUrl: typeof raw.selfUrl === "string" ? raw.selfUrl : undefined,
-        tunnel,
-        telemetry: {
-            consoleExporter: typeof raw.telemetry?.consoleExporter === "boolean"
-                ? Boolean(raw.telemetry.consoleExporter)
-                : undefined,
-        },
-    };
-}
-function textResult(text, details) {
-    return {
-        content: [{ type: "text", text }],
-        ...(details === undefined ? {} : { details }),
-    };
-}
-function requireService(service) {
-    if (!service) {
-        throw new Error("multiclaws service is not running yet");
-    }
-    return service;
-}
-function createTools(getService, logger) {
-    const log = (level, msg) => {
-        const fn = level === "debug" ? logger.debug : logger[level];
-        fn?.(`[multiclaws] ${msg}`);
-    };
-    /* ── Agent tools ──────────────────────────────────────────────── */
-    const multiclawsAgents = {
-        name: "multiclaws_agents",
-        description: "List known A2A agents and their capabilities.",
-        parameters: {
-            type: "object",
-            additionalProperties: false,
-            properties: {},
-        },
-        execute: async () => {
-            log("debug", "tool:multiclaws_agents");
-            try {
-                const service = requireService(getService());
-                const agents = await service.listAgents();
-                return textResult(JSON.stringify({ agents }, null, 2), { agents });
-            }
-            catch (err) {
-                log("error", `tool:multiclaws_agents failed: ${err instanceof Error ? err.message : String(err)}`);
-                throw err;
-            }
-        },
-    };
-    const multiclawsAddAgent = {
-        name: "multiclaws_add_agent",
-        description: "Add a remote A2A agent by URL. Automatically fetches its Agent Card.",
-        parameters: {
-            type: "object",
-            additionalProperties: false,
-            properties: {
-                url: { type: "string" },
-                apiKey: { type: "string" },
-            },
-            required: ["url"],
-        },
-        execute: async (_toolCallId, args) => {
-            const url = typeof args.url === "string" ? args.url.trim() : "";
-            log("debug", `tool:multiclaws_add_agent(url=${url})`);
-            try {
-                const service = requireService(getService());
-                if (!url)
-                    throw new Error("url is required");
-                const apiKey = typeof args.apiKey === "string" ? args.apiKey.trim() : undefined;
-                const agent = await service.addAgent({ url, apiKey });
-                return textResult(`Agent added: ${agent.name} (${agent.url})`, agent);
-            }
-            catch (err) {
-                log("error", `tool:multiclaws_add_agent failed: ${err instanceof Error ? err.message : String(err)}`);
-                throw err;
-            }
-        },
-    };
-    const multiclawsRemoveAgent = {
-        name: "multiclaws_remove_agent",
-        description: "Remove a known A2A agent by URL.",
-        parameters: {
-            type: "object",
-            additionalProperties: false,
-            properties: {
-                url: { type: "string" },
-            },
-            required: ["url"],
-        },
-        execute: async (_toolCallId, args) => {
-            const url = typeof args.url === "string" ? args.url.trim() : "";
-            log("debug", `tool:multiclaws_remove_agent(url=${url})`);
-            try {
-                const service = requireService(getService());
-                if (!url)
-                    throw new Error("url is required");
-                const removed = await service.removeAgent(url);
-                return textResult(removed ? `Agent ${url} removed.` : `Agent ${url} not found.`);
-            }
-            catch (err) {
-                log("error", `tool:multiclaws_remove_agent failed: ${err instanceof Error ? err.message : String(err)}`);
-                throw err;
-            }
-        },
-    };
-    const multiclawsDelegate = {
-        name: "multiclaws_delegate",
-        description: "Delegate a task to a remote A2A agent and wait for the result inline. " +
-            "Sends the task synchronously via A2A and returns the output directly in the current session. " +
-            "For long-running tasks this may take several minutes. " +
-            "Do NOT use multiclaws_delegate_send directly — use this tool instead.",
-        parameters: {
-            type: "object",
-            additionalProperties: false,
-            properties: {
-                agentUrl: { type: "string" },
-                task: { type: "string" },
-            },
-            required: ["agentUrl", "task"],
-        },
-        execute: async (_toolCallId, args) => {
-            const agentUrl = typeof args.agentUrl === "string" ? args.agentUrl.trim() : "";
-            log("info", `tool:multiclaws_delegate(agentUrl=${agentUrl})`);
-            try {
-                const service = requireService(getService());
-                const task = typeof args.task === "string" ? args.task.trim() : "";
-                if (!agentUrl || !task)
-                    throw new Error("agentUrl and task are required");
-                const result = await service.delegateTaskSync({ agentUrl, task });
-                const summary = result.output
-                    ? result.output
-                    : result.error
-                        ? `任务失败：${result.error}`
-                        : `任务状态：${result.status}`;
-                return textResult(summary, result);
-            }
-            catch (err) {
-                log("error", `tool:multiclaws_delegate failed: ${err instanceof Error ? err.message : String(err)}`);
-                throw err;
-            }
-        },
-    };
-    const multiclawsDelegateSend = {
-        name: "multiclaws_delegate_send",
-        description: "Send a task to a remote A2A agent and wait for the result synchronously. " +
-            "Low-level primitive used by sub-agents or advanced orchestration flows. " +
-            "In most cases use multiclaws_delegate instead, which handles this automatically.",
-        parameters: {
-            type: "object",
-            additionalProperties: false,
-            properties: {
-                agentUrl: { type: "string" },
-                task: { type: "string" },
-            },
-            required: ["agentUrl", "task"],
-        },
-        execute: async (_toolCallId, args) => {
-            const agentUrl = typeof args.agentUrl === "string" ? args.agentUrl.trim() : "";
-            log("info", `tool:multiclaws_delegate_send(agentUrl=${agentUrl})`);
-            try {
-                const service = requireService(getService());
-                const task = typeof args.task === "string" ? args.task.trim() : "";
-                if (!agentUrl || !task)
-                    throw new Error("agentUrl and task are required");
-                const result = await service.delegateTaskSync({ agentUrl, task });
-                return textResult(JSON.stringify(result, null, 2), result);
-            }
-            catch (err) {
-                log("error", `tool:multiclaws_delegate_send failed: ${err instanceof Error ? err.message : String(err)}`);
-                throw err;
-            }
-        },
-    };
-    const multiclawsA2ACallback = {
-        name: "multiclaws_a2a_callback",
-        description: "Report the result of an incoming A2A delegated task. " +
-            "Called by sub-agents spawned to handle remote tasks. " +
-            "Do NOT call this directly.",
-        parameters: {
-            type: "object",
-            additionalProperties: false,
-            properties: {
-                taskId: { type: "string" },
-                result: { type: "string" },
-            },
-            required: ["taskId", "result"],
-        },
-        execute: async (_toolCallId, args) => {
-            const taskId = typeof args.taskId === "string" ? args.taskId.trim() : "";
-            const result = typeof args.result === "string" ? args.result : "";
-            log("info", `tool:multiclaws_a2a_callback(taskId=${taskId})`);
-            try {
-                const service = requireService(getService());
-                if (!taskId || !result)
-                    throw new Error("taskId and result are required");
-                const resolved = service.resolveA2ACallback(taskId, result);
-                if (!resolved) {
-                    return textResult(`No pending callback for task ${taskId}. It may have timed out.`);
-                }
-                return textResult(`Task ${taskId} result reported successfully.`);
-            }
-            catch (err) {
-                log("error", `tool:multiclaws_a2a_callback failed: ${err instanceof Error ? err.message : String(err)}`);
-                throw err;
-            }
-        },
-    };
-    const multiclawsNotify = {
-        name: "multiclaws_notify",
-        description: "Send a notification message to the local user's WebUI. " +
-            "Used by sub-agents to deliver delegation results back to the user. " +
-            "Broadcasts to all known channels so the user sees the message regardless of which channel they are on.",
-        parameters: {
-            type: "object",
-            additionalProperties: false,
-            properties: {
-                message: { type: "string", description: "The message to send to the user." },
-            },
-            required: ["message"],
-        },
-        execute: async (_toolCallId, args) => {
-            const msg = typeof args.message === "string" ? args.message.trim() : "";
-            log("info", `tool:multiclaws_notify(len=${msg.length})`);
-            try {
-                const service = requireService(getService());
-                if (!msg)
-                    throw new Error("message is required");
-                await service.notifyUser(msg);
-                return textResult("Notification sent.");
-            }
-            catch (err) {
-                log("error", `tool:multiclaws_notify failed: ${err instanceof Error ? err.message : String(err)}`);
-                throw err;
-            }
-        },
-    };
-    const multiclawsTaskRespond = {
-        name: "multiclaws_task_respond",
-        description: "Approve or reject a pending incoming delegated task that requires human authorization. " +
-            "Call with approved=true to allow execution, approved=false to reject. " +
-            "Use this when the user responds to an approval request for a risky incoming task.",
-        parameters: {
-            type: "object",
-            additionalProperties: false,
-            properties: {
-                taskId: { type: "string", description: "The taskId from the approval request." },
-                approved: { type: "boolean", description: "true to approve, false to reject." },
-            },
-            required: ["taskId", "approved"],
-        },
-        execute: async (_toolCallId, args) => {
-            const taskId = typeof args.taskId === "string" ? args.taskId.trim() : "";
-            const approved = typeof args.approved === "boolean" ? args.approved : false;
-            log("info", `tool:multiclaws_task_respond(taskId=${taskId}, approved=${approved})`);
-            try {
-                const service = requireService(getService());
-                if (!taskId)
-                    throw new Error("taskId is required");
-                const resolved = service.respondToTask(taskId, approved);
-                if (!resolved) {
-                    return textResult(`未找到任务 ${taskId} 的待审批记录，可能已超时或不存在。`);
-                }
-                return textResult(approved
-                    ? `✅ 已授权任务 ${taskId}，执行中…`
-                    : `❌ 已拒绝任务 ${taskId}。`);
-            }
-            catch (err) {
-                log("error", `tool:multiclaws_task_respond failed: ${err instanceof Error ? err.message : String(err)}`);
-                throw err;
-            }
-        },
-    };
-    const multiclawsTaskStatus = {
-        name: "multiclaws_task_status",
-        description: "Check the status of a delegated task.",
-        parameters: {
-            type: "object",
-            additionalProperties: false,
-            properties: {
-                taskId: { type: "string" },
-            },
-            required: ["taskId"],
-        },
-        execute: async (_toolCallId, args) => {
-            const taskId = typeof args.taskId === "string" ? args.taskId.trim() : "";
-            log("debug", `tool:multiclaws_task_status(taskId=${taskId})`);
-            try {
-                const service = requireService(getService());
-                if (!taskId)
-                    throw new Error("taskId is required");
-                const task = service.getTaskStatus(taskId);
-                if (!task)
-                    throw new Error(`task not found: ${taskId}`);
-                return textResult(JSON.stringify(task, null, 2), task);
-            }
-            catch (err) {
-                log("error", `tool:multiclaws_task_status failed: ${err instanceof Error ? err.message : String(err)}`);
-                throw err;
-            }
-        },
-    };
-    /* ── Team tools ───────────────────────────────────────────────── */
-    const multiclawsTeamCreate = {
-        name: "multiclaws_team_create",
-        description: "Create a new team. Returns teamId and invite code.",
-        parameters: {
-            type: "object",
-            additionalProperties: false,
-            properties: {
-                name: { type: "string" },
-            },
-            required: ["name"],
-        },
-        execute: async (_toolCallId, args) => {
-            const name = typeof args.name === "string" ? args.name.trim() : "";
-            log("info", `tool:multiclaws_team_create(name=${name})`);
-            try {
-                const service = requireService(getService());
-                if (!name)
-                    throw new Error("name is required");
-                const team = await service.createTeam(name);
-                const invite = await service.createInvite(team.teamId);
-                return textResult(`Team "${team.teamName}" created (${team.teamId}).\nInvite code: ${invite}\n\n⚠️ 请只将邀请码分享给完全信任的用户。持有邀请码的人可以加入团队并向你的 AI 委派任务。权限管理模块正在开发中。`, { team, inviteCode: invite });
-            }
-            catch (err) {
-                log("error", `tool:multiclaws_team_create failed: ${err instanceof Error ? err.message : String(err)}`);
-                throw err;
-            }
-        },
-    };
-    const multiclawsTeamJoin = {
-        name: "multiclaws_team_join",
-        description: "Join a team using an invite code. Automatically syncs all team members as agents.",
-        parameters: {
-            type: "object",
-            additionalProperties: false,
-            properties: {
-                inviteCode: { type: "string" },
-            },
-            required: ["inviteCode"],
-        },
-        execute: async (_toolCallId, args) => {
-            log("info", "tool:multiclaws_team_join");
-            try {
-                const service = requireService(getService());
-                const inviteCode = typeof args.inviteCode === "string" ? args.inviteCode.trim() : "";
-                if (!inviteCode)
-                    throw new Error("inviteCode is required");
-                const team = await service.joinTeam(inviteCode);
-                const memberNames = team.members.map((m) => m.name).join(", ");
-                return textResult(`Joined team "${team.teamName}" with ${team.members.length} members: ${memberNames}`, { team });
-            }
-            catch (err) {
-                log("error", `tool:multiclaws_team_join failed: ${err instanceof Error ? err.message : String(err)}`);
-                throw err;
-            }
-        },
-    };
-    const multiclawsTeamLeave = {
-        name: "multiclaws_team_leave",
-        description: "Leave a team. Notifies all members and removes them from local agent registry.",
-        parameters: {
-            type: "object",
-            additionalProperties: false,
-            properties: {
-                teamId: { type: "string" },
-            },
-        },
-        execute: async (_toolCallId, args) => {
-            const teamId = typeof args.teamId === "string" ? args.teamId.trim() : undefined;
-            log("info", `tool:multiclaws_team_leave(teamId=${teamId ?? "first"})`);
-            try {
-                const service = requireService(getService());
-                await service.leaveTeam(teamId || undefined);
-                return textResult("Left team successfully.");
-            }
-            catch (err) {
-                log("error", `tool:multiclaws_team_leave failed: ${err instanceof Error ? err.message : String(err)}`);
-                throw err;
-            }
-        },
-    };
-    const multiclawsTeamMembers = {
-        name: "multiclaws_team_members",
-        description: "List all members of a team. If teamId is omitted, returns all teams and their members.",
-        parameters: {
-            type: "object",
-            additionalProperties: false,
-            properties: {
-                teamId: { type: "string" },
-            },
-        },
-        execute: async (_toolCallId, args) => {
-            log("debug", "tool:multiclaws_team_members");
-            try {
-                const service = requireService(getService());
-                const teamId = typeof args.teamId === "string" ? args.teamId.trim() : undefined;
-                const result = await service.listTeamMembers(teamId || undefined);
-                if (!result) {
-                    return textResult("No team found.");
-                }
-                return textResult(JSON.stringify(result, null, 2), result);
-            }
-            catch (err) {
-                log("error", `tool:multiclaws_team_members failed: ${err instanceof Error ? err.message : String(err)}`);
-                throw err;
-            }
-        },
-    };
-    /* ── Profile tools ──────────────────────────────────────────── */
-    const multiclawsProfileSet = {
-        name: "multiclaws_profile_set",
-        description: "Set or update the owner profile (name and bio). Bio is free-form markdown describing role, capabilities, data sources, etc. Broadcasts to team members.",
-        parameters: {
-            type: "object",
-            additionalProperties: false,
-            properties: {
-                ownerName: { type: "string" },
-                bio: { type: "string" },
-            },
-        },
-        execute: async (_toolCallId, args) => {
-            log("debug", "tool:multiclaws_profile_set");
-            try {
-                const service = requireService(getService());
-                const patch = {};
-                if (typeof args.ownerName === "string")
-                    patch.ownerName = args.ownerName.trim();
-                if (typeof args.bio === "string")
-                    patch.bio = args.bio;
-                const profile = await service.setProfile(patch);
-                return textResult(JSON.stringify(profile, null, 2), profile);
-            }
-            catch (err) {
-                log("error", `tool:multiclaws_profile_set failed: ${err instanceof Error ? err.message : String(err)}`);
-                throw err;
-            }
-        },
-    };
-    const multiclawsProfileShow = {
-        name: "multiclaws_profile_show",
-        description: "Show the current owner profile.",
-        parameters: {
-            type: "object",
-            additionalProperties: false,
-            properties: {},
-        },
-        execute: async () => {
-            log("debug", "tool:multiclaws_profile_show");
-            try {
-                const service = requireService(getService());
-                const profile = await service.getProfile();
-                return textResult(JSON.stringify(profile, null, 2), profile);
-            }
-            catch (err) {
-                log("error", `tool:multiclaws_profile_show failed: ${err instanceof Error ? err.message : String(err)}`);
-                throw err;
-            }
-        },
-    };
-    const multiclawsProfilePendingReview = {
-        name: "multiclaws_profile_pending_review",
-        description: "Check if the user's profile was just initialized and is pending review. If pending, returns profile and a message to show the user and ask if they want to adjust.",
-        parameters: {
-            type: "object",
-            additionalProperties: false,
-            properties: {},
-        },
-        execute: async () => {
-            log("debug", "tool:multiclaws_profile_pending_review");
-            try {
-                const service = requireService(getService());
-                const result = await service.getPendingProfileReview();
-                return textResult(JSON.stringify(result, null, 2), result);
-            }
-            catch (err) {
-                log("error", `tool:multiclaws_profile_pending_review failed: ${err instanceof Error ? err.message : String(err)}`);
-                throw err;
-            }
-        },
-    };
-    const multiclawsProfileClearPendingReview = {
-        name: "multiclaws_profile_clear_pending_review",
-        description: "Clear the pending profile review flag after the user has confirmed or finished adjusting their profile.",
-        parameters: {
-            type: "object",
-            additionalProperties: false,
-            properties: {},
-        },
-        execute: async () => {
-            log("debug", "tool:multiclaws_profile_clear_pending_review");
-            try {
-                const service = requireService(getService());
-                await service.clearPendingProfileReview();
-                return textResult("Pending profile review cleared.");
-            }
-            catch (err) {
-                log("error", `tool:multiclaws_profile_clear_pending_review failed: ${err instanceof Error ? err.message : String(err)}`);
-                throw err;
-            }
-        },
-    };
-    return [
-        multiclawsAgents,
-        multiclawsAddAgent,
-        multiclawsRemoveAgent,
-        multiclawsDelegate,
-        multiclawsDelegateSend,
-        multiclawsA2ACallback,
-        multiclawsNotify,
-        multiclawsTaskRespond,
-        multiclawsTaskStatus,
-        multiclawsTeamCreate,
-        multiclawsTeamJoin,
-        multiclawsTeamLeave,
-        multiclawsTeamMembers,
-        multiclawsProfileSet,
-        multiclawsProfileShow,
-        multiclawsProfilePendingReview,
-        multiclawsProfileClearPendingReview,
-    ];
-}
-const plugin = {
-    id: "multiclaws",
-    name: "MultiClaws",
-    version: version_1.PLUGIN_VERSION,
-    register(api) {
-        const config = readConfig(api);
-        (0, telemetry_1.initializeTelemetry)({ enableConsoleExporter: config.telemetry?.consoleExporter });
-        const structured = (0, logger_1.createStructuredLogger)(api.logger, "multiclaws");
-        let service = null;
-        // Ensure required tools are in gateway.tools.allow at registration time
-        // so the gateway starts with them already present (no restart needed).
-        //
-        // Two categories:
-        // 1. Adapter-internal tools: sessions_spawn, sessions_history, message
-        //    — needed by a2a-adapter itself to spawn/poll/notify.
-        // 2. A2A execution tools: exec, read, write, glob, grep
-        //    — needed by spawned sub-agents to actually perform delegated tasks.
-        //    Without these the sub-agent session hits "permission denied" because
-        //    gateway.tools.allow restricts which tools the session can invoke.
-        //
-        // Users can override the execution tool list via plugin config:
-        //   plugins.multiclaws.a2aAllowedTools: ["exec", "read", "write", ...]
-        if (api.config) {
-            const gw = api.config.gateway;
-            if (gw) {
-                const tools = (gw.tools ?? {});
-                const allow = Array.isArray(tools.allow) ? tools.allow : [];
-                const adapterRequired = ["sessions_spawn", "sessions_list", "sessions_send", "sessions_history", "message", "chat.send"];
-                const defaultA2AExecutionTools = ["exec", "read", "write", "edit", "process"];
-                const pluginConf = api.pluginConfig ?? {};
-                const a2aExecTools = Array.isArray(pluginConf.a2aAllowedTools)
-                    ? pluginConf.a2aAllowedTools
-                    : defaultA2AExecutionTools;
-                const required = [...new Set([...adapterRequired, ...a2aExecTools])];
-                const missing = required.filter((t) => !allow.includes(t));
-                if (missing.length > 0) {
-                    tools.allow = [...allow, ...missing];
-                    gw.tools = tools;
-                    structured.logger.info(`auto-added gateway tools: ${missing.join(", ")}`);
-                }
-            }
-        }
-        const gatewayConfig = (() => {
-            const gw = api.config?.gateway;
-            const port = typeof gw?.port === "number" ? gw.port : 18789;
-            const token = typeof gw?.auth?.token === "string" ? gw.auth.token : null;
-            if (!token)
-                return null;
-            return { port, token };
-        })();
-        const pluginService = {
-            id: "multiclaws-service",
-            start: async (ctx) => {
-                structured.logger.info("[multiclaws] service starting");
-                try {
-                    service = new multiclaws_service_1.MulticlawsService({
-                        stateDir: ctx.stateDir,
-                        port: config.port,
-                        displayName: config.displayName,
-                        selfUrl: config.selfUrl,
-                        cwd: process.cwd(),
-                        tunnel: config.tunnel,
-                        gatewayConfig: gatewayConfig ?? undefined,
-                        logger: structured.logger,
-                    });
-                    await service.start();
-                }
-                catch (err) {
-                    structured.logger.error(`[multiclaws] service start failed: ${err instanceof Error ? err.message : String(err)}`);
-                    throw err;
-                }
-            },
-            stop: async () => {
-                structured.logger.info("[multiclaws] service stopping");
-                try {
-                    if (service) {
-                        await service.stop();
-                        service = null;
-                    }
-                    structured.logger.info("[multiclaws] service stopped");
-                }
-                catch (err) {
-                    structured.logger.error(`[multiclaws] service stop failed: ${err instanceof Error ? err.message : String(err)}`);
-                    throw err;
-                }
-            },
-        };
-        api.registerService(pluginService);
-        const gatewayHandlers = (0, handlers_1.createGatewayHandlers)(() => requireService(service), structured.logger);
-        for (const [method, handler] of Object.entries(gatewayHandlers)) {
-            api.registerGatewayMethod(method, handler);
-        }
-        for (const tool of createTools(() => service, structured.logger)) {
-            api.registerTool(tool);
-        }
-        api.registerHttpRoute({
-            path: "/multiclaws/health",
-            auth: "plugin",
-            handler: (_req, res) => {
-                const running = service !== null;
-                res.statusCode = running ? 200 : 503;
-                res.end(JSON.stringify({
-                    ok: running,
-                    plugin: "multiclaws",
-                }));
-            },
-        });
-        api.on("gateway_start", () => {
-            structured.logger.info("[multiclaws] gateway_start observed");
-        });
-        api.on("gateway_stop", () => {
-            structured.logger.info("[multiclaws] gateway_stop observed");
-        });
-        // Collect notification targets from incoming messages.
-        // WebChat is intentionally excluded here: it's registered via
-        // before_prompt_build (type="web") using sessions_send, which correctly
-        // injects messages into the active session. Registering it here too would
-        // cause duplicate notifications.
-        api.on("message_received", (_event, ctx) => {
-            if (!service || !ctx.channelId)
-                return;
-            if (ctx.channelId !== "webchat" && ctx.conversationId) {
-                // External channels only (Telegram, Discord, etc.)
-                service.addNotificationTarget(`${ctx.channelId}:${ctx.conversationId}`, { type: "channel", conversationId: ctx.conversationId });
-            }
-        });
-        // Inject onboarding prompt when profile is pending first-run setup
-        // Also capture web session targets for notifications (skip internal sub-agent sessions)
-        // Skip when channelId is set — those are already handled by message_received hook
-        const INTERNAL_SESSION_PREFIXES = ["delegate-", "a2a-"];
-        api.on("before_prompt_build", async (_event, ctx) => {
-            if (service && ctx.sessionKey && !ctx.channelId &&
-                !INTERNAL_SESSION_PREFIXES.some((p) => ctx.sessionKey.startsWith(p))) {
-                service.addNotificationTarget(`web:${ctx.sessionKey}`, { type: "web", sessionKey: ctx.sessionKey });
-            }
-            if (!service)
-                return;
-            try {
-                const review = await service.getPendingProfileReview();
-                if (!review.pending)
-                    return;
-                return {
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const handlers_1 = require("./gateway/handlers");
+const multiclaws_service_1 = require("./service/multiclaws-service");
+const logger_1 = require("./infra/logger");
+const telemetry_1 = require("./infra/telemetry");
+const version_1 = require("./infra/version");
+/** Default FRP tunnel config for demo/testing */
+const DEFAULT_TUNNEL = {
+    type: "frp",
+    serverAddr: "39.105.143.2",
+    serverPort: 7000,
+    token: "jushi@5202fRp",
+    portRangeStart: 7011,
+    portRangeEnd: 7020,
+};
+function readConfig(api) {
+    const raw = (api.pluginConfig ?? {});
+    let tunnel;
+    const rawTunnel = raw.tunnel;
+    if (rawTunnel && rawTunnel.type === "frp") {
+        tunnel = {
+            type: "frp",
+            serverAddr: typeof rawTunnel.serverAddr === "string" ? rawTunnel.serverAddr : DEFAULT_TUNNEL.serverAddr,
+            serverPort: typeof rawTunnel.serverPort === "number" ? rawTunnel.serverPort : DEFAULT_TUNNEL.serverPort,
+            token: typeof rawTunnel.token === "string" ? rawTunnel.token : DEFAULT_TUNNEL.token,
+            portRangeStart: typeof rawTunnel.portRangeStart === "number" ? rawTunnel.portRangeStart : DEFAULT_TUNNEL.portRangeStart,
+            portRangeEnd: typeof rawTunnel.portRangeEnd === "number" ? rawTunnel.portRangeEnd : DEFAULT_TUNNEL.portRangeEnd,
+        };
+    }
+    else {
+        // No tunnel configured — use built-in default for demo
+        tunnel = { ...DEFAULT_TUNNEL };
+    }
+    return {
+        port: typeof raw.port === "number" ? raw.port : undefined,
+        displayName: typeof raw.displayName === "string" ? raw.displayName : undefined,
+        selfUrl: typeof raw.selfUrl === "string" ? raw.selfUrl : undefined,
+        tunnel,
+        telemetry: {
+            consoleExporter: typeof raw.telemetry?.consoleExporter === "boolean"
+                ? Boolean(raw.telemetry.consoleExporter)
+                : undefined,
+        },
+    };
+}
+function textResult(text, details) {
+    return {
+        content: [{ type: "text", text }],
+        ...(details === undefined ? {} : { details }),
+    };
+}
+function requireService(service) {
+    if (!service) {
+        throw new Error("multiclaws service is not running yet");
+    }
+    return service;
+}
+function createTools(getService, logger) {
+    const log = (level, msg) => {
+        const fn = level === "debug" ? logger.debug : logger[level];
+        fn?.(`[multiclaws] ${msg}`);
+    };
+    /* ── Agent tools ──────────────────────────────────────────────── */
+    const multiclawsAgents = {
+        name: "multiclaws_agents",
+        description: "List known A2A agents and their capabilities.",
+        parameters: {
+            type: "object",
+            additionalProperties: false,
+            properties: {},
+        },
+        execute: async () => {
+            log("debug", "tool:multiclaws_agents");
+            try {
+                const service = requireService(getService());
+                const agents = await service.listAgents();
+                return textResult(JSON.stringify({ agents }, null, 2), { agents });
+            }
+            catch (err) {
+                log("error", `tool:multiclaws_agents failed: ${err instanceof Error ? err.message : String(err)}`);
+                throw err;
+            }
+        },
+    };
+    const multiclawsAddAgent = {
+        name: "multiclaws_add_agent",
+        description: "Add a remote A2A agent by URL. Automatically fetches its Agent Card.",
+        parameters: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                url: { type: "string" },
+                apiKey: { type: "string" },
+            },
+            required: ["url"],
+        },
+        execute: async (_toolCallId, args) => {
+            const url = typeof args.url === "string" ? args.url.trim() : "";
+            log("debug", `tool:multiclaws_add_agent(url=${url})`);
+            try {
+                const service = requireService(getService());
+                if (!url)
+                    throw new Error("url is required");
+                const apiKey = typeof args.apiKey === "string" ? args.apiKey.trim() : undefined;
+                const agent = await service.addAgent({ url, apiKey });
+                return textResult(`Agent added: ${agent.name} (${agent.url})`, agent);
+            }
+            catch (err) {
+                log("error", `tool:multiclaws_add_agent failed: ${err instanceof Error ? err.message : String(err)}`);
+                throw err;
+            }
+        },
+    };
+    const multiclawsRemoveAgent = {
+        name: "multiclaws_remove_agent",
+        description: "Remove a known A2A agent by URL.",
+        parameters: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                url: { type: "string" },
+            },
+            required: ["url"],
+        },
+        execute: async (_toolCallId, args) => {
+            const url = typeof args.url === "string" ? args.url.trim() : "";
+            log("debug", `tool:multiclaws_remove_agent(url=${url})`);
+            try {
+                const service = requireService(getService());
+                if (!url)
+                    throw new Error("url is required");
+                const removed = await service.removeAgent(url);
+                return textResult(removed ? `Agent ${url} removed.` : `Agent ${url} not found.`);
+            }
+            catch (err) {
+                log("error", `tool:multiclaws_remove_agent failed: ${err instanceof Error ? err.message : String(err)}`);
+                throw err;
+            }
+        },
+    };
+    const multiclawsDelegate = {
+        name: "multiclaws_delegate",
+        description: "Delegate a task to a remote A2A agent and wait for the result inline. " +
+            "Sends the task synchronously via A2A and returns the output directly in the current session. " +
+            "For long-running tasks this may take several minutes. " +
+            "Do NOT use multiclaws_delegate_send directly — use this tool instead.",
+        parameters: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                agentUrl: { type: "string" },
+                task: { type: "string" },
+            },
+            required: ["agentUrl", "task"],
+        },
+        execute: async (_toolCallId, args) => {
+            const agentUrl = typeof args.agentUrl === "string" ? args.agentUrl.trim() : "";
+            log("info", `tool:multiclaws_delegate(agentUrl=${agentUrl})`);
+            try {
+                const service = requireService(getService());
+                const task = typeof args.task === "string" ? args.task.trim() : "";
+                if (!agentUrl || !task)
+                    throw new Error("agentUrl and task are required");
+                const result = await service.delegateTaskSync({ agentUrl, task });
+                const summary = result.output
+                    ? result.output
+                    : result.error
+                        ? `任务失败：${result.error}`
+                        : `任务状态：${result.status}`;
+                return textResult(summary, result);
+            }
+            catch (err) {
+                log("error", `tool:multiclaws_delegate failed: ${err instanceof Error ? err.message : String(err)}`);
+                throw err;
+            }
+        },
+    };
+    const multiclawsDelegateSend = {
+        name: "multiclaws_delegate_send",
+        description: "Send a task to a remote A2A agent and wait for the result synchronously. " +
+            "Low-level primitive used by sub-agents or advanced orchestration flows. " +
+            "In most cases use multiclaws_delegate instead, which handles this automatically.",
+        parameters: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                agentUrl: { type: "string" },
+                task: { type: "string" },
+            },
+            required: ["agentUrl", "task"],
+        },
+        execute: async (_toolCallId, args) => {
+            const agentUrl = typeof args.agentUrl === "string" ? args.agentUrl.trim() : "";
+            log("info", `tool:multiclaws_delegate_send(agentUrl=${agentUrl})`);
+            try {
+                const service = requireService(getService());
+                const task = typeof args.task === "string" ? args.task.trim() : "";
+                if (!agentUrl || !task)
+                    throw new Error("agentUrl and task are required");
+                const result = await service.delegateTaskSync({ agentUrl, task });
+                return textResult(JSON.stringify(result, null, 2), result);
+            }
+            catch (err) {
+                log("error", `tool:multiclaws_delegate_send failed: ${err instanceof Error ? err.message : String(err)}`);
+                throw err;
+            }
+        },
+    };
+    const multiclawsA2ACallback = {
+        name: "multiclaws_a2a_callback",
+        description: "Report the result of an incoming A2A delegated task. " +
+            "Called by sub-agents spawned to handle remote tasks. " +
+            "Do NOT call this directly.",
+        parameters: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                taskId: { type: "string" },
+                result: { type: "string" },
+            },
+            required: ["taskId", "result"],
+        },
+        execute: async (_toolCallId, args) => {
+            const taskId = typeof args.taskId === "string" ? args.taskId.trim() : "";
+            const result = typeof args.result === "string" ? args.result : "";
+            log("info", `tool:multiclaws_a2a_callback(taskId=${taskId})`);
+            try {
+                const service = requireService(getService());
+                if (!taskId || !result)
+                    throw new Error("taskId and result are required");
+                const resolved = service.resolveA2ACallback(taskId, result);
+                if (!resolved) {
+                    return textResult(`No pending callback for task ${taskId}. It may have timed out.`);
+                }
+                return textResult(`Task ${taskId} result reported successfully.`);
+            }
+            catch (err) {
+                log("error", `tool:multiclaws_a2a_callback failed: ${err instanceof Error ? err.message : String(err)}`);
+                throw err;
+            }
+        },
+    };
+    const multiclawsNotify = {
+        name: "multiclaws_notify",
+        description: "Send a notification message to the local user's WebUI. " +
+            "Used by sub-agents to deliver delegation results back to the user. " +
+            "Broadcasts to all known channels so the user sees the message regardless of which channel they are on.",
+        parameters: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                message: { type: "string", description: "The message to send to the user." },
+            },
+            required: ["message"],
+        },
+        execute: async (_toolCallId, args) => {
+            const msg = typeof args.message === "string" ? args.message.trim() : "";
+            log("info", `tool:multiclaws_notify(len=${msg.length})`);
+            try {
+                const service = requireService(getService());
+                if (!msg)
+                    throw new Error("message is required");
+                await service.notifyUser(msg);
+                return textResult("Notification sent.");
+            }
+            catch (err) {
+                log("error", `tool:multiclaws_notify failed: ${err instanceof Error ? err.message : String(err)}`);
+                throw err;
+            }
+        },
+    };
+    const multiclawsTaskRespond = {
+        name: "multiclaws_task_respond",
+        description: "Approve or reject a pending incoming delegated task that requires human authorization. " +
+            "Call with approved=true to allow execution, approved=false to reject. " +
+            "Use this when the user responds to an approval request for a risky incoming task.",
+        parameters: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                taskId: { type: "string", description: "The taskId from the approval request." },
+                approved: { type: "boolean", description: "true to approve, false to reject." },
+            },
+            required: ["taskId", "approved"],
+        },
+        execute: async (_toolCallId, args) => {
+            const taskId = typeof args.taskId === "string" ? args.taskId.trim() : "";
+            const approved = typeof args.approved === "boolean" ? args.approved : false;
+            log("info", `tool:multiclaws_task_respond(taskId=${taskId}, approved=${approved})`);
+            try {
+                const service = requireService(getService());
+                if (!taskId)
+                    throw new Error("taskId is required");
+                const resolved = service.respondToTask(taskId, approved);
+                if (!resolved) {
+                    return textResult(`未找到任务 ${taskId} 的待审批记录，可能已超时或不存在。`);
+                }
+                return textResult(approved
+                    ? `✅ 已授权任务 ${taskId}，执行中…`
+                    : `❌ 已拒绝任务 ${taskId}。`);
+            }
+            catch (err) {
+                log("error", `tool:multiclaws_task_respond failed: ${err instanceof Error ? err.message : String(err)}`);
+                throw err;
+            }
+        },
+    };
+    const multiclawsTaskStatus = {
+        name: "multiclaws_task_status",
+        description: "Check the status of a delegated task.",
+        parameters: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                taskId: { type: "string" },
+            },
+            required: ["taskId"],
+        },
+        execute: async (_toolCallId, args) => {
+            const taskId = typeof args.taskId === "string" ? args.taskId.trim() : "";
+            log("debug", `tool:multiclaws_task_status(taskId=${taskId})`);
+            try {
+                const service = requireService(getService());
+                if (!taskId)
+                    throw new Error("taskId is required");
+                const task = service.getTaskStatus(taskId);
+                if (!task)
+                    throw new Error(`task not found: ${taskId}`);
+                return textResult(JSON.stringify(task, null, 2), task);
+            }
+            catch (err) {
+                log("error", `tool:multiclaws_task_status failed: ${err instanceof Error ? err.message : String(err)}`);
+                throw err;
+            }
+        },
+    };
+    /* ── Team tools ───────────────────────────────────────────────── */
+    const multiclawsTeamCreate = {
+        name: "multiclaws_team_create",
+        description: "Create a new team. Returns teamId and invite code.",
+        parameters: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                name: { type: "string" },
+            },
+            required: ["name"],
+        },
+        execute: async (_toolCallId, args) => {
+            const name = typeof args.name === "string" ? args.name.trim() : "";
+            log("info", `tool:multiclaws_team_create(name=${name})`);
+            try {
+                const service = requireService(getService());
+                if (!name)
+                    throw new Error("name is required");
+                const team = await service.createTeam(name);
+                const invite = await service.createInvite(team.teamId);
+                return textResult(`Team "${team.teamName}" created (${team.teamId}).\nInvite code: ${invite}\n\n⚠️ 请只将邀请码分享给完全信任的用户。持有邀请码的人可以加入团队并向你的 AI 委派任务。权限管理模块正在开发中。`, { team, inviteCode: invite });
+            }
+            catch (err) {
+                log("error", `tool:multiclaws_team_create failed: ${err instanceof Error ? err.message : String(err)}`);
+                throw err;
+            }
+        },
+    };
+    const multiclawsTeamJoin = {
+        name: "multiclaws_team_join",
+        description: "Join a team using an invite code. Automatically syncs all team members as agents.",
+        parameters: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                inviteCode: { type: "string" },
+            },
+            required: ["inviteCode"],
+        },
+        execute: async (_toolCallId, args) => {
+            log("info", "tool:multiclaws_team_join");
+            try {
+                const service = requireService(getService());
+                const inviteCode = typeof args.inviteCode === "string" ? args.inviteCode.trim() : "";
+                if (!inviteCode)
+                    throw new Error("inviteCode is required");
+                const team = await service.joinTeam(inviteCode);
+                const memberNames = team.members.map((m) => m.name).join(", ");
+                return textResult(`Joined team "${team.teamName}" with ${team.members.length} members: ${memberNames}`, { team });
+            }
+            catch (err) {
+                log("error", `tool:multiclaws_team_join failed: ${err instanceof Error ? err.message : String(err)}`);
+                throw err;
+            }
+        },
+    };
+    const multiclawsTeamLeave = {
+        name: "multiclaws_team_leave",
+        description: "Leave a team. Notifies all members and removes them from local agent registry.",
+        parameters: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                teamId: { type: "string" },
+            },
+        },
+        execute: async (_toolCallId, args) => {
+            const teamId = typeof args.teamId === "string" ? args.teamId.trim() : undefined;
+            log("info", `tool:multiclaws_team_leave(teamId=${teamId ?? "first"})`);
+            try {
+                const service = requireService(getService());
+                await service.leaveTeam(teamId || undefined);
+                return textResult("Left team successfully.");
+            }
+            catch (err) {
+                log("error", `tool:multiclaws_team_leave failed: ${err instanceof Error ? err.message : String(err)}`);
+                throw err;
+            }
+        },
+    };
+    const multiclawsTeamMembers = {
+        name: "multiclaws_team_members",
+        description: "List all members of a team. If teamId is omitted, returns all teams and their members.",
+        parameters: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                teamId: { type: "string" },
+            },
+        },
+        execute: async (_toolCallId, args) => {
+            log("debug", "tool:multiclaws_team_members");
+            try {
+                const service = requireService(getService());
+                const teamId = typeof args.teamId === "string" ? args.teamId.trim() : undefined;
+                const result = await service.listTeamMembers(teamId || undefined);
+                if (!result) {
+                    return textResult("No team found.");
+                }
+                return textResult(JSON.stringify(result, null, 2), result);
+            }
+            catch (err) {
+                log("error", `tool:multiclaws_team_members failed: ${err instanceof Error ? err.message : String(err)}`);
+                throw err;
+            }
+        },
+    };
+    /* ── Profile tools ──────────────────────────────────────────── */
+    const multiclawsProfileSet = {
+        name: "multiclaws_profile_set",
+        description: "Set or update the owner profile (name and bio). Bio is free-form markdown describing role, capabilities, data sources, etc. Broadcasts to team members.",
+        parameters: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                ownerName: { type: "string" },
+                bio: { type: "string" },
+            },
+        },
+        execute: async (_toolCallId, args) => {
+            log("debug", "tool:multiclaws_profile_set");
+            try {
+                const service = requireService(getService());
+                const patch = {};
+                if (typeof args.ownerName === "string")
+                    patch.ownerName = args.ownerName.trim();
+                if (typeof args.bio === "string")
+                    patch.bio = args.bio;
+                const profile = await service.setProfile(patch);
+                return textResult(JSON.stringify(profile, null, 2), profile);
+            }
+            catch (err) {
+                log("error", `tool:multiclaws_profile_set failed: ${err instanceof Error ? err.message : String(err)}`);
+                throw err;
+            }
+        },
+    };
+    const multiclawsProfileShow = {
+        name: "multiclaws_profile_show",
+        description: "Show the current owner profile.",
+        parameters: {
+            type: "object",
+            additionalProperties: false,
+            properties: {},
+        },
+        execute: async () => {
+            log("debug", "tool:multiclaws_profile_show");
+            try {
+                const service = requireService(getService());
+                const profile = await service.getProfile();
+                return textResult(JSON.stringify(profile, null, 2), profile);
+            }
+            catch (err) {
+                log("error", `tool:multiclaws_profile_show failed: ${err instanceof Error ? err.message : String(err)}`);
+                throw err;
+            }
+        },
+    };
+    const multiclawsProfilePendingReview = {
+        name: "multiclaws_profile_pending_review",
+        description: "Check if the user's profile was just initialized and is pending review. If pending, returns profile and a message to show the user and ask if they want to adjust.",
+        parameters: {
+            type: "object",
+            additionalProperties: false,
+            properties: {},
+        },
+        execute: async () => {
+            log("debug", "tool:multiclaws_profile_pending_review");
+            try {
+                const service = requireService(getService());
+                const result = await service.getPendingProfileReview();
+                return textResult(JSON.stringify(result, null, 2), result);
+            }
+            catch (err) {
+                log("error", `tool:multiclaws_profile_pending_review failed: ${err instanceof Error ? err.message : String(err)}`);
+                throw err;
+            }
+        },
+    };
+    const multiclawsProfileClearPendingReview = {
+        name: "multiclaws_profile_clear_pending_review",
+        description: "Clear the pending profile review flag after the user has confirmed or finished adjusting their profile.",
+        parameters: {
+            type: "object",
+            additionalProperties: false,
+            properties: {},
+        },
+        execute: async () => {
+            log("debug", "tool:multiclaws_profile_clear_pending_review");
+            try {
+                const service = requireService(getService());
+                await service.clearPendingProfileReview();
+                return textResult("Pending profile review cleared.");
+            }
+            catch (err) {
+                log("error", `tool:multiclaws_profile_clear_pending_review failed: ${err instanceof Error ? err.message : String(err)}`);
+                throw err;
+            }
+        },
+    };
+    return [
+        multiclawsAgents,
+        multiclawsAddAgent,
+        multiclawsRemoveAgent,
+        multiclawsDelegate,
+        multiclawsDelegateSend,
+        multiclawsA2ACallback,
+        multiclawsNotify,
+        multiclawsTaskRespond,
+        multiclawsTaskStatus,
+        multiclawsTeamCreate,
+        multiclawsTeamJoin,
+        multiclawsTeamLeave,
+        multiclawsTeamMembers,
+        multiclawsProfileSet,
+        multiclawsProfileShow,
+        multiclawsProfilePendingReview,
+        multiclawsProfileClearPendingReview,
+    ];
+}
+const plugin = {
+    id: "multiclaws",
+    name: "MultiClaws",
+    version: version_1.PLUGIN_VERSION,
+    register(api) {
+        const config = readConfig(api);
+        (0, telemetry_1.initializeTelemetry)({ enableConsoleExporter: config.telemetry?.consoleExporter });
+        const structured = (0, logger_1.createStructuredLogger)(api.logger, "multiclaws");
+        let service = null;
+        // Ensure required tools are in gateway.tools.allow at registration time
+        // so the gateway starts with them already present (no restart needed).
+        //
+        // Two categories:
+        // 1. Adapter-internal tools: sessions_spawn, sessions_history, message
+        //    — needed by a2a-adapter itself to spawn/poll/notify.
+        // 2. A2A execution tools: exec, read, write, glob, grep
+        //    — needed by spawned sub-agents to actually perform delegated tasks.
+        //    Without these the sub-agent session hits "permission denied" because
+        //    gateway.tools.allow restricts which tools the session can invoke.
+        //
+        // Users can override the execution tool list via plugin config:
+        //   plugins.multiclaws.a2aAllowedTools: ["exec", "read", "write", ...]
+        if (api.config) {
+            const gw = api.config.gateway;
+            if (gw) {
+                const tools = (gw.tools ?? {});
+                const allow = Array.isArray(tools.allow) ? tools.allow : [];
+                const adapterRequired = ["sessions_spawn", "sessions_list", "sessions_send", "sessions_history", "message", "chat.send"];
+                const defaultA2AExecutionTools = ["exec", "read", "write", "edit", "process"];
+                const pluginConf = api.pluginConfig ?? {};
+                const a2aExecTools = Array.isArray(pluginConf.a2aAllowedTools)
+                    ? pluginConf.a2aAllowedTools
+                    : defaultA2AExecutionTools;
+                const required = [...new Set([...adapterRequired, ...a2aExecTools])];
+                const missing = required.filter((t) => !allow.includes(t));
+                if (missing.length > 0) {
+                    tools.allow = [...allow, ...missing];
+                    gw.tools = tools;
+                    structured.logger.info(`auto-added gateway tools: ${missing.join(", ")}`);
+                }
+            }
+        }
+        const gatewayConfig = (() => {
+            const gw = api.config?.gateway;
+            const port = typeof gw?.port === "number" ? gw.port : 18789;
+            const token = typeof gw?.auth?.token === "string" ? gw.auth.token : null;
+            if (!token)
+                return null;
+            return { port, token };
+        })();
+        const pluginService = {
+            id: "multiclaws-service",
+            start: async (ctx) => {
+                structured.logger.info("[multiclaws] service starting");
+                try {
+                    service = new multiclaws_service_1.MulticlawsService({
+                        stateDir: ctx.stateDir,
+                        port: config.port,
+                        displayName: config.displayName,
+                        selfUrl: config.selfUrl,
+                        cwd: process.cwd(),
+                        tunnel: config.tunnel,
+                        gatewayConfig: gatewayConfig ?? undefined,
+                        logger: structured.logger,
+                    });
+                    await service.start();
+                }
+                catch (err) {
+                    structured.logger.error(`[multiclaws] service start failed: ${err instanceof Error ? err.message : String(err)}`);
+                    throw err;
+                }
+            },
+            stop: async () => {
+                structured.logger.info("[multiclaws] service stopping");
+                try {
+                    if (service) {
+                        await service.stop();
+                        service = null;
+                    }
+                    structured.logger.info("[multiclaws] service stopped");
+                }
+                catch (err) {
+                    structured.logger.error(`[multiclaws] service stop failed: ${err instanceof Error ? err.message : String(err)}`);
+                    throw err;
+                }
+            },
+        };
+        api.registerService(pluginService);
+        const gatewayHandlers = (0, handlers_1.createGatewayHandlers)(() => requireService(service), structured.logger);
+        for (const [method, handler] of Object.entries(gatewayHandlers)) {
+            api.registerGatewayMethod(method, handler);
+        }
+        for (const tool of createTools(() => service, structured.logger)) {
+            api.registerTool(tool);
+        }
+        api.registerHttpRoute({
+            path: "/multiclaws/health",
+            auth: "plugin",
+            handler: (_req, res) => {
+                const running = service !== null;
+                res.statusCode = running ? 200 : 503;
+                res.end(JSON.stringify({
+                    ok: running,
+                    plugin: "multiclaws",
+                }));
+            },
+        });
+        api.on("gateway_start", () => {
+            structured.logger.info("[multiclaws] gateway_start observed");
+        });
+        api.on("gateway_stop", () => {
+            structured.logger.info("[multiclaws] gateway_stop observed");
+        });
+        // Collect notification targets from incoming messages.
+        // WebChat is intentionally excluded here: it's registered via
+        // before_prompt_build (type="web") using sessions_send, which correctly
+        // injects messages into the active session. Registering it here too would
+        // cause duplicate notifications.
+        api.on("message_received", (_event, ctx) => {
+            if (!service || !ctx.channelId)
+                return;
+            if (ctx.channelId !== "webchat" && ctx.conversationId) {
+                // External channels only (Telegram, Discord, etc.)
+                service.addNotificationTarget(`${ctx.channelId}:${ctx.conversationId}`, { type: "channel", conversationId: ctx.conversationId });
+            }
+        });
+        // Inject onboarding prompt when profile is pending first-run setup
+        // Also capture web session targets for notifications (skip internal sub-agent sessions)
+        // Skip when channelId is set — those are already handled by message_received hook
+        const INTERNAL_SESSION_PREFIXES = ["delegate-", "a2a-"];
+        api.on("before_prompt_build", async (_event, ctx) => {
+            if (service && ctx.sessionKey && !ctx.channelId &&
+                !INTERNAL_SESSION_PREFIXES.some((p) => ctx.sessionKey.startsWith(p))) {
+                service.addNotificationTarget(`web:${ctx.sessionKey}`, { type: "web", sessionKey: ctx.sessionKey });
+            }
+            if (!service)
+                return;
+            try {
+                const review = await service.getPendingProfileReview();
+                if (!review.pending)
+                    return;
+                return {
                     appendSystemContext: `## MultiClaws 首次安装 — 需要完成档案设置
 
 multiclaws 插件刚安装，需要在本次对话中完成以下初始化流程（优先处理，不管用户说了什么）：
@@ -727,13 +727,13 @@ multiclaws 插件刚安装，需要在本次对话中完成以下初始化流程
 
 5. **网络情况告知**（无需用户回答）：告知用户「所有实例通过 FRP 隧道通信，需在插件配置中设置 tunnel 字段（包含 frps 服务器地址、端口、token 和可用端口范围），frpc 会自动下载安装」
 
-**注意**：只有名字需要用户明确确认；bio 自动生成直接保存无需确认；网络情况仅告知无需回答。`,
-                };
-            }
-            catch (err) {
-                structured.logger.warn("[multiclaws] before_prompt_build: failed to check pending review: " + String(err));
-            }
-        });
-    },
-};
-exports.default = plugin;
+**注意**：只有名字需要用户明确确认；bio 自动生成直接保存无需确认；网络情况仅告知无需回答。`,
+                };
+            }
+            catch (err) {
+                structured.logger.warn("[multiclaws] before_prompt_build: failed to check pending review: " + String(err));
+            }
+        });
+    },
+};
+exports.default = plugin;