@sleep2agi/dsh-anet 0.0.0-stage → 0.1.0-preview.24

package/src/client.js

@@ -0,0 +1,433 @@
+// Browser half: ANet node manager (Settings card + sidebar launcher).
+// The official client only exposes a fixed settings allowlist, so the UI talks
+// to the plugin's loopback API at 127.0.0.1:9460.
+window.__ModuleLoader__.load({
+  id: "@sleep2agi/dsh-anet",
+  factory: (require) => {
+    const module = { exports: {} };
+    const exports = module.exports;
+    const React = require("react");
+    const h = React.createElement;
+    const ENDPOINT = "http://127.0.0.1:9460";
+
+    const NS = "anet";
+    const zh = {
+      title: "ANet", subtitle: "把项目/会话变成 Agent Network 节点",
+      steps: "① 登录人类账号　② 创建节点　③ 在 hub 里给节点派任务",
+      nodes: "节点", connected: "已连接", noNodes: "还没有节点，先创建一个。",
+      name: "节点名称", nameHint: "hub 上显示的 alias", project: "项目目录", projectHint: "任务在这个项目下运行",
+      sessionPick: "Session", newSession: "新建会话", sessionHint: "可换成已有会话，或为节点新建一个",
+      loginTitle: "登录人类账号", loginHint: "用 hub 账号登录，创建节点时自动签发 token；登录状态会保存在本机",
+      hub: "Hub 地址", username: "用户名", password: "密码", login: "登录", loggingIn: "登录中…", logout: "退出登录",
+      loggedIn: "已登录", createTitle: "创建节点", createHint: "节点 token 会由当前账号自动创建",
+      create: "创建节点", creating: "创建中…", created: "节点已创建并接入",
+      delete: "删除", confirmDelete: "删除这个节点？", switchSession: "切换会话", switched: "已切换会话",
+      loading: "正在加载…", offline: "本地服务不可用（127.0.0.1:9460）", failed: "操作失败",
+      note: "配置保存在 ~/.anet/dsh/nodes.json（0600）",
+      running: "已连接", starting: "连接中", stopped: "未连接", error: "异常",
+      network: "Network", projectLabel: "项目", noNetwork: "默认网络",
+    };
+    const en = {
+      title: "ANet", subtitle: "Turn a project/session into an Agent Network node",
+      steps: "① Log in　② Create a node　③ Dispatch tasks from the hub",
+      nodes: "Nodes", connected: "connected", noNodes: "No nodes yet. Create one below.",
+      name: "Node name", nameHint: "Alias shown on the hub", project: "Project directory", projectHint: "Tasks run in this project",
+      sessionPick: "Session", newSession: "New session", sessionHint: "Use an existing session, or create one for this node",
+      loginTitle: "Human account login", loginHint: "Log in with a hub account; node tokens are minted for you. The session is remembered on this machine.",
+      hub: "Hub URL", username: "Username", password: "Password", login: "Log in", loggingIn: "Logging in…", logout: "Log out",
+      loggedIn: "Logged in", createTitle: "Create node", createHint: "The node token is minted with the current account",
+      create: "Create node", creating: "Creating…", created: "Node created and connected",
+      delete: "Delete", confirmDelete: "Delete this node?", switchSession: "Switch session", switched: "Session switched",
+      loading: "Loading…", offline: "Local service unavailable (127.0.0.1:9460)", failed: "Failed",
+      note: "Stored in ~/.anet/dsh/nodes.json (0600)",
+      running: "Connected", starting: "Connecting", stopped: "Disconnected", error: "Error",
+      network: "Network", projectLabel: "Project", noNetwork: "default network",
+    };
+
+    const T = {
+      text: "var(--dsw-alias-label-primary)", sub: "var(--dsw-alias-label-secondary)", muted: "var(--dsw-alias-label-tertiary)",
+      border: "var(--dsw-alias-border-l2)", borderStrong: "var(--dsw-alias-border-l1)",
+      bg: "var(--dsw-alias-bg-layer-1)", card: "var(--dsw-alias-bg-layer-2)", field: "var(--dsw-alias-bg-layer-3)",
+      brand: "var(--dsw-alias-label-primary)", onBrand: "var(--dsw-alias-bg-layer-1)",
+      err: "var(--dsw-alias-label-error)", success: "var(--dsw-alias-state-success-primary, #2e7d32)",
+    };
+    const inputStyle = {
+      width: "100%", boxSizing: "border-box", height: 36, padding: "0 12px", borderRadius: 9,
+      border: `1px solid ${T.border}`, background: T.field, color: T.text, font: "inherit", fontSize: 13, outline: "none",
+    };
+    const labelStyle = { fontSize: 12, fontWeight: 600, color: T.sub, marginBottom: 6, display: "block" };
+    const hintStyle = { margin: "5px 0 0", fontSize: 11.5, color: T.muted, lineHeight: 1.5 };
+    const primaryButton = (disabled) => ({
+      height: 34, padding: "0 16px", borderRadius: 9, border: "none", font: "inherit", fontSize: 13, fontWeight: 600,
+      cursor: disabled ? "default" : "pointer", opacity: disabled ? 0.5 : 1, background: T.brand, color: T.onBrand,
+    });
+    const ghostButton = (disabled) => ({
+      height: 30, padding: "0 10px", borderRadius: 8, border: `1px solid ${T.border}`, background: "transparent",
+      color: T.sub, font: "inherit", fontSize: 12, cursor: disabled ? "default" : "pointer",
+    });
+    const cardStyle = { border: `1px solid ${T.border}`, borderRadius: 12, background: T.card, padding: "14px 16px" };
+    const sectionTitle = { fontSize: 13, fontWeight: 700, color: T.text };
+    const sectionHint = { margin: "4px 0 12px", fontSize: 12, color: T.muted, lineHeight: 1.5 };
+    const grid2 = { display: "grid", gridTemplateColumns: "1fr 1fr", gap: 12 };
+
+    function Field(props) {
+      return h("div", { style: props.style ?? null },
+        h("label", { style: labelStyle, htmlFor: props.id }, props.label),
+        h("input", {
+          id: props.id, style: inputStyle, type: props.type ?? "text", value: props.value, disabled: props.disabled,
+          placeholder: props.placeholder, onChange: (event) => props.onChange(event.target.value),
+        }),
+        props.hint ? h("p", { style: hintStyle }, props.hint) : null,
+      );
+    }
+
+    function StatusPill(props) {
+      const { status, t } = props;
+      const map = { running: [t("running"), T.success], starting: [t("starting"), T.muted], error: [t("error"), T.err] };
+      const [label, color] = map[status] ?? [t("stopped"), T.muted];
+      return h("span", { style: { display: "inline-flex", alignItems: "center", gap: 6, fontSize: 12, color } },
+        h("span", { style: { width: 7, height: 7, borderRadius: 99, background: color, display: "inline-block" } }), label);
+    }
+
+    function Meta(props) {
+      return h("div", { style: { minWidth: 0 } },
+        h("div", { style: { fontSize: 10.5, textTransform: "uppercase", letterSpacing: 0.4, color: T.muted } }, props.label),
+        h("div", { style: { fontSize: 12, color: T.sub, marginTop: 2, overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" } }, props.value),
+      );
+    }
+
+    function NodeRow(props) {
+      const { node, t, onDelete, sessions, onSwitch } = props;
+      return h("div", { style: { ...cardStyle, padding: "14px 16px", marginBottom: 10 } },
+        h("div", { style: { display: "flex", alignItems: "center", gap: 10 } },
+          h("div", { style: { fontSize: 14, fontWeight: 650, color: T.text, flex: 1, minWidth: 0, overflowWrap: "anywhere" } }, node.name),
+          h(StatusPill, { status: node.status, t }),
+          h("button", { type: "button", style: ghostButton(false), onClick: () => onDelete(node) }, t("delete")),
+        ),
+        h("div", { style: { display: "grid", gridTemplateColumns: "1.2fr 1fr 1.6fr", gap: 12, marginTop: 10 } },
+          h(Meta, { label: "Hub", value: node.hub }),
+          h(Meta, { label: "NETWORK", value: node.networkId || t("noNetwork") }),
+          h(Meta, { label: "PROJECT", value: node.projectDir }),
+        ),
+        h("div", { style: { display: "flex", alignItems: "center", gap: 8, marginTop: 10, paddingTop: 10, borderTop: `1px solid ${T.border}` } },
+          h("span", { style: { fontSize: 11.5, color: T.muted, flex: "none" } }, t("sessionPick")),
+          h("select", {
+            value: node.sessionId,
+            disabled: !sessions || sessions.length === 0,
+            onChange: (event) => onSwitch(node, event.target.value),
+            style: { ...inputStyle, height: 30, padding: "0 8px", fontSize: 12, flex: 1, minWidth: 0 },
+          },
+            (sessions ?? []).some((session) => session.id === node.sessionId) ? null : h("option", { value: node.sessionId }, node.sessionId),
+            (sessions ?? []).map((session) => h("option", { key: session.id, value: session.id },
+              `${session.id}${session.cwd ? ` — ${session.cwd}` : ""}`)),
+          ),
+        ),
+        node.lastError ? h("div", { style: { fontSize: 11.5, color: T.err, marginTop: 6 } }, node.lastError) : null,
+      );
+    }
+
+    function createOpenStore() {
+      let open = false;
+      const listeners = new Set();
+      const emit = () => { for (const listener of listeners) listener(); };
+      return {
+        get: () => open,
+        set: (value) => { if (open === value) return; open = value; emit(); },
+        subscribe: (listener) => { listeners.add(listener); return () => listeners.delete(listener); },
+      };
+    }
+    const openStore = createOpenStore();
+
+    function AnetSidebarAction(props) {
+      const open = React.useSyncExternalStore(openStore.subscribe, openStore.get, openStore.get);
+      const t = props.t;
+      return h(React.Fragment, null,
+        h("button", {
+          type: "button", title: t("title"), "aria-label": t("title"), onClick: () => openStore.set(!open),
+          style: {
+            width: props.wide ? "100%" : 32, height: 32, display: "flex", alignItems: "center", justifyContent: "center",
+            gap: 7, padding: props.wide ? "0 10px" : 0, marginBottom: 4,
+            border: `1px solid ${T.border}`, borderRadius: 8,
+            background: open ? T.card : "transparent", color: T.sub, font: "inherit",
+            fontSize: props.wide ? 13 : 11, fontWeight: 600, cursor: "pointer",
+          },
+        },
+          h("span", { style: { width: 16, height: 16, borderRadius: 5, background: T.brand, color: T.onBrand, fontSize: 10, fontWeight: 700, display: "inline-flex", alignItems: "center", justifyContent: "center" } }, "A"),
+          props.wide ? "ANet" : null,
+        ),
+        open ? h(AnetOverlay, { t, onClose: () => openStore.set(false) }) : null,
+      );
+    }
+
+    function AnetOverlay(props) {
+      const t = props.t;
+      return h("div", {
+        style: {
+          position: "fixed", inset: 0, zIndex: 10000, background: "rgba(15,18,24,0.5)", backdropFilter: "blur(3px)",
+          display: "flex", alignItems: "center", justifyContent: "center", padding: 24,
+        },
+        onMouseDown: (event) => { if (event.target === event.currentTarget) props.onClose(); },
+      },
+        h("div", {
+          style: {
+            width: "min(880px, 94vw)", maxHeight: "86vh", display: "flex", flexDirection: "column", overflow: "hidden",
+            background: T.bg, borderRadius: 16, border: `1px solid ${T.border}`,
+            boxShadow: "0 24px 70px rgba(0,0,0,0.4)",
+          },
+        },
+          h("div", { style: { display: "flex", alignItems: "center", gap: 12, padding: "18px 20px", borderBottom: `1px solid ${T.border}` } },
+            h("div", { style: { width: 34, height: 34, borderRadius: 10, background: T.brand, color: T.onBrand, fontSize: 16, fontWeight: 800, display: "flex", alignItems: "center", justifyContent: "center" } }, "A"),
+            h("div", { style: { flex: 1, minWidth: 0 } },
+              h("div", { style: { fontSize: 16, fontWeight: 700, color: T.text } }, t("title")),
+              h("div", { style: { fontSize: 12, color: T.muted, marginTop: 2 } }, t("subtitle")),
+            ),
+            h("button", {
+              type: "button", "aria-label": "Close", onClick: props.onClose,
+              style: { border: "none", background: "transparent", color: T.muted, font: "inherit", fontSize: 22, lineHeight: 1, cursor: "pointer", padding: 4 },
+            }, "×"),
+          ),
+          h("div", { style: { overflow: "auto", padding: 20 } }, h(AnetCard, { t })),
+        ),
+      );
+    }
+
+    function AnetCard(props) {
+      const t = props.t;
+      const [state, setState] = React.useState({ status: "loading", nodes: [] });
+      const [session, setSession] = React.useState(null);
+      const [loginDraft, setLoginDraft] = React.useState({ hub: "", username: "", password: "" });
+      const [draft, setDraft] = React.useState({ name: "", projectDir: "", networkId: "" });
+      const [projects, setProjects] = React.useState([]);
+      const [sessions, setSessions] = React.useState([]);
+      const [sessionChoice, setSessionChoice] = React.useState("__new__");
+      const [busy, setBusy] = React.useState(false);
+      const [message, setMessage] = React.useState(null);
+      const [failed, setFailed] = React.useState(false);
+
+      const refresh = React.useCallback(async () => {
+        try {
+          const res = await fetch(`${ENDPOINT}/nodes`, { cache: "no-store" });
+          const body = await res.json();
+          if (!res.ok || body.ok === false) throw new Error(body.error ?? `HTTP ${res.status}`);
+          setState({ status: "ready", nodes: body.nodes ?? [] });
+          setLoginDraft((current) => ({ ...current, hub: current.hub || body.defaults?.hub || "" }));
+          setDraft((current) => ({ ...current, projectDir: current.projectDir || body.defaults?.projectDir || "" }));
+        } catch (error) {
+          setState({ status: "error", nodes: [] });
+          setFailed(true);
+          setMessage(`${t("offline")}: ${error?.message ?? error}`);
+        }
+      }, []);
+
+      React.useEffect(() => { void refresh(); }, []);
+      React.useEffect(() => {
+        fetch(`${ENDPOINT}/account`, { cache: "no-store" })
+          .then((res) => res.json())
+          .then((body) => {
+            if (body?.loggedIn) setSession({ hub: body.hub, username: body.username, networkId: body.networkId ?? "" });
+          })
+          .catch(() => {});
+      }, []);
+      React.useEffect(() => {
+        fetch(`${ENDPOINT}/sessions`, { cache: "no-store" })
+          .then((res) => res.json())
+          .then((body) => { if (body?.ok !== false) setSessions(body.sessions ?? []); })
+          .catch(() => {});
+        fetch(`${ENDPOINT}/projects`, { cache: "no-store" })
+          .then((res) => res.json())
+          .then((body) => {
+            if (body?.ok === false) throw new Error(body.error ?? "projects");
+            setProjects(body.projects ?? []);
+            setDraft((current) => ({ ...current, projectDir: current.projectDir || body.defaultProject || "" }));
+          })
+          .catch(() => {});
+      }, []);
+
+      const editLogin = (key) => (value) => setLoginDraft((current) => ({ ...current, [key]: value }));
+      const editDraft = (key) => (value) => setDraft((current) => ({ ...current, [key]: value }));
+
+      const onLogin = async () => {
+        setBusy(true); setMessage(null); setFailed(false);
+        try {
+          const res = await fetch(`${ENDPOINT}/login`, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(loginDraft) });
+          const body = await res.json();
+          if (!res.ok || body.ok === false) throw new Error(body.error ?? `HTTP ${res.status}`);
+          setSession({ hub: body.hub ?? loginDraft.hub, username: body.username ?? loginDraft.username, networkId: body.networkId ?? "" });
+          setLoginDraft((current) => ({ ...current, password: "" }));
+          setDraft((current) => ({ ...current, networkId: body.networkId ?? "" }));
+          setMessage(`${t("loggedIn")}: ${body.username ?? loginDraft.username}`);
+        } catch (error) {
+          setFailed(true); setMessage(`${t("failed")}: ${error?.message ?? error}`);
+        } finally { setBusy(false); }
+      };
+
+      const onCreate = async () => {
+        if (!session) { setFailed(true); setMessage(t("loginTitle")); return; }
+        setBusy(true); setMessage(null); setFailed(false);
+        try {
+          const res = await fetch(`${ENDPOINT}/nodes`, {
+            method: "POST", headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+              name: draft.name, projectDir: draft.projectDir,
+              hub: session.hub, networkId: draft.networkId || session.networkId,
+              ...(sessionChoice === "__new__" ? {} : { sessionId: sessionChoice }),
+            }),
+          });
+          const body = await res.json();
+          if (!res.ok || body.ok === false) throw new Error(body.error ?? `HTTP ${res.status}`);
+          setMessage(t("created"));
+          setDraft((current) => ({ ...current, name: "" }));
+          setSessionChoice("__new__");
+          await refresh();
+        } catch (error) {
+          setFailed(true); setMessage(`${t("failed")}: ${error?.message ?? error}`);
+        } finally { setBusy(false); }
+      };
+
+      const onDelete = async (node) => {
+        if (!window.confirm(t("confirmDelete"))) return;
+        try {
+          const res = await fetch(`${ENDPOINT}/nodes/${encodeURIComponent(node.id)}`, { method: "DELETE" });
+          const body = await res.json();
+          if (!res.ok || body.ok === false) throw new Error(body.error ?? `HTTP ${res.status}`);
+          await refresh();
+        } catch (error) {
+          setFailed(true); setMessage(`${t("failed")}: ${error?.message ?? error}`);
+        }
+      };
+
+      const onSwitch = async (node, sessionId) => {
+        if (!sessionId || sessionId === node.sessionId) return;
+        if (!window.confirm(t("confirmDelete").replace(/.*/, t("switchSession") + "?"))) return;
+        try {
+          const res = await fetch(`${ENDPOINT}/nodes/${encodeURIComponent(node.id)}`, {
+            method: "PATCH", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ sessionId }),
+          });
+          const body = await res.json();
+          if (!res.ok || body.ok === false) throw new Error(body.error ?? `HTTP ${res.status}`);
+          setMessage(t("switched"));
+          await refresh();
+        } catch (error) {
+          setFailed(true); setMessage(`${t("failed")}: ${error?.message ?? error}`);
+        }
+      };
+
+      if (state.status === "loading") {
+        return h("div", { style: { padding: 28, color: T.muted, fontSize: 13, textAlign: "center" } }, t("loading"));
+      }
+
+      const online = state.nodes.filter((node) => node.status === "running").length;
+      const messageLine = message
+        ? h("span", { style: { fontSize: 12, color: failed ? T.err : T.muted } }, message)
+        : null;
+      const customProject = !projects.some((project) => project.path === draft.projectDir);
+
+      return h("div", { style: { display: "flex", flexDirection: "column", gap: 14 } },
+        h("div", { style: { display: "flex", alignItems: "center", gap: 8, padding: "9px 12px", borderRadius: 10, background: T.card, border: `1px solid ${T.border}`, fontSize: 12, color: T.sub } },
+          h("span", { style: { flex: 1 } }, t("steps")),
+          h("span", { style: { color: T.muted, flex: "none" } }, `${online}/${state.nodes.length} ${t("connected")}`),
+        ),
+
+        h("div", { style: { ...cardStyle } },
+          h("div", { style: sectionTitle }, `${t("nodes")} (${state.nodes.length})`),
+          state.nodes.length === 0
+            ? h("p", { style: { fontSize: 12, color: T.muted, margin: "10px 0 2px" } }, t("noNodes"))
+            : h("div", { style: { marginTop: 12 } }, state.nodes.map((node) =>
+                h(NodeRow, { key: node.id, node, t, onDelete, sessions, onSwitch }))),
+        ),
+
+        session
+          ? h("div", { style: { ...cardStyle, display: "flex", alignItems: "center", gap: 10 } },
+              h("span", { style: { width: 8, height: 8, borderRadius: 99, background: T.success, flex: "none" } }),
+              h("div", { style: { flex: 1, minWidth: 0 } },
+                h("div", { style: { fontSize: 12.5, color: T.text, fontWeight: 600 } }, `${t("loggedIn")}: ${session.username ?? ""}`),
+                h("div", { style: { fontSize: 11.5, color: T.muted, marginTop: 2, overflowWrap: "anywhere" } },
+                  `${session.hub}${session.networkId ? ` · ${session.networkId}` : ""}`),
+              ),
+              h("button", {
+                type: "button", style: { ...ghostButton(false), border: "none" },
+                onClick: async () => { try { await fetch(`${ENDPOINT}/logout`, { method: "POST" }); } catch {} setSession(null); },
+              }, t("logout")),
+            )
+          : h("div", { style: cardStyle },
+              h("div", { style: sectionTitle }, t("loginTitle")),
+              h("p", { style: sectionHint }, t("loginHint")),
+              h(Field, { id: "anet-login-hub", label: t("hub"), value: loginDraft.hub, disabled: busy, onChange: editLogin("hub") }),
+              h("div", { style: { ...grid2, marginTop: 12 } },
+                h(Field, { id: "anet-login-user", label: t("username"), value: loginDraft.username, disabled: busy, onChange: editLogin("username") }),
+                h(Field, { id: "anet-login-pass", label: t("password"), type: "password", value: loginDraft.password, disabled: busy, onChange: editLogin("password") }),
+              ),
+              h("div", { style: { display: "flex", justifyContent: "flex-end", alignItems: "center", gap: 12, paddingTop: 12 } },
+                messageLine,
+                h("button", { type: "button", disabled: busy, style: primaryButton(busy), onClick: onLogin }, busy ? t("loggingIn") : t("login")),
+              ),
+            ),
+
+        session
+          ? h("div", { style: cardStyle },
+              h("div", { style: sectionTitle }, t("createTitle")),
+              h("p", { style: sectionHint }, t("createHint")),
+              h("div", { style: { display: "grid", gridTemplateColumns: "1fr 1fr", gap: 12 } },
+                h(Field, { id: "anet-name", label: t("name"), hint: t("nameHint"), value: draft.name, disabled: busy, onChange: editDraft("name") }),
+                h("div", null,
+                  h("label", { style: labelStyle, htmlFor: "anet-session" }, t("sessionPick")),
+                  h("select", {
+                    id: "anet-session", style: { ...inputStyle, appearance: "auto" }, value: sessionChoice, disabled: busy,
+                    onChange: (event) => setSessionChoice(event.target.value),
+                  },
+                    h("option", { value: "__new__" }, t("newSession")),
+                    sessions.map((item) => h("option", { key: item.id, value: item.id }, `${item.id}${item.cwd ? ` — ${item.cwd}` : ""}`)),
+                  ),
+                  h("p", { style: hintStyle }, t("sessionHint")),
+                ),
+              ),
+              h("div", { style: { marginTop: 12 } },
+                h("label", { style: labelStyle, htmlFor: "anet-project" }, t("project")),
+                projects.length > 0
+                  ? h("select", {
+                      id: "anet-project", style: { ...inputStyle, appearance: "auto" },
+                      value: customProject ? "__custom__" : draft.projectDir, disabled: busy,
+                      onChange: (event) => editDraft("projectDir")(event.target.value === "__custom__" ? "" : event.target.value),
+                    },
+                      projects.map((project) => h("option", { key: project.path, value: project.path }, `${project.label} — ${project.path}`)),
+                      h("option", { value: "__custom__" }, t("project") + " (custom)"),
+                    )
+                  : null,
+                (projects.length === 0 || customProject)
+                  ? h("input", {
+                      id: "anet-project-path", style: { ...inputStyle, marginTop: projects.length > 0 ? 8 : 0 },
+                      value: draft.projectDir, disabled: busy, placeholder: "/path/to/project",
+                      onChange: (event) => editDraft("projectDir")(event.target.value),
+                    })
+                  : null,
+                session.networkId ? null : h("div", { style: { marginTop: 12 } },
+                  h(Field, { id: "anet-network", label: t("network"), value: draft.networkId, disabled: busy, onChange: editDraft("networkId") })),
+                h("p", { style: hintStyle }, t("projectHint")),
+              ),
+              h("div", { style: { display: "flex", justifyContent: "flex-end", alignItems: "center", gap: 12, paddingTop: 14 } },
+                messageLine,
+                h("button", { type: "button", disabled: busy, style: primaryButton(busy), onClick: onCreate }, busy ? t("creating") : t("create")),
+              ),
+            )
+          : null,
+
+        h("div", { style: { fontSize: 11, color: T.muted, textAlign: "center" } }, t("note")),
+      );
+    }
+
+    function apply(ctx) {
+      ctx.effect(() => ctx.locale.register(NS, { zh, en }), "anet: dictionaries");
+      const t = ctx.locale.bind(NS);
+      ctx.slots.inject("settings.plugin.item", () => ctx.slots.register({
+        name: "settings.plugin.item", id: "anet", order: 30, locale: NS, inject: () => ({ t }),
+      }, AnetCard));
+      ctx.slots.inject("sidebar.footer.action", () => ctx.slots.register({
+        name: "sidebar.footer.action", id: "anet", order: 10, locale: NS, inject: () => ({ t }),
+      }, AnetSidebarAction));
+    }
+
+    exports.apply = apply;
+    exports.inject = ["slots", "locale"];
+    return module.exports;
+  },
+});

package/src/hub-client.mjs

@@ -0,0 +1,141 @@
+// CommHub node-side client: MCP tool calls over POST /mcp and the per-alias
+// SSE doorbell at GET /events/<alias>. Same wire contract agent-node uses.
+// The node token is held in a closure and never logged or returned.
+
+const PROTOCOL = "2025-03-26";
+
+export class HubError extends Error {
+  constructor(message, { status, tool } = {}) {
+    super(message);
+    this.name = "HubError";
+    this.status = status;
+    this.tool = tool;
+  }
+}
+
+function parseEnvelope(raw) {
+  try { return JSON.parse(raw); } catch { /* SSE-framed body */ }
+  for (const line of raw.split(/\r?\n/)) {
+    const m = line.match(/^data:\s*(\{.*\})\s*$/);
+    if (m) return JSON.parse(m[1]);
+  }
+  return null;
+}
+
+/**
+ * @param {{hub: string, token: string, networkId?: string, clientVersion?: string,
+ *          fetch?: typeof fetch, timeoutMs?: number}} opts
+ */
+export function createHubClient(opts) {
+  const hub = String(opts.hub || "").replace(/\/+$/, "");
+  if (!/^https?:\/\//.test(hub)) throw new Error("dsh-commhub: hub must be an http(s) URL");
+  if (!opts.token) throw new Error("dsh-commhub: node token is required");
+  const token = opts.token;
+  const doFetch = opts.fetch ?? fetch;
+  const timeoutMs = opts.timeoutMs ?? 30_000;
+  let sessionId = null;
+  let rpcId = 0;
+
+  const headers = () => ({
+    "Content-Type": "application/json",
+    Accept: "application/json, text/event-stream",
+    "MCP-Protocol-Version": PROTOCOL,
+    Authorization: `Bearer ${token}`,
+    ...(sessionId ? { "mcp-session-id": sessionId } : {}),
+  });
+
+  async function initialize() {
+    sessionId = null;
+    const res = await doFetch(`${hub}/mcp`, {
+      method: "POST",
+      headers: headers(),
+      body: JSON.stringify({
+        jsonrpc: "2.0", id: ++rpcId, method: "initialize",
+        params: { protocolVersion: PROTOCOL, capabilities: {},
+          clientInfo: { name: "dsh-commhub", version: opts.clientVersion ?? "0" } },
+      }),
+      signal: AbortSignal.timeout(timeoutMs),
+    });
+    if (!res.ok) throw new HubError(`initialize: HTTP ${res.status}`, { status: res.status });
+    sessionId = res.headers.get("mcp-session-id");
+    await res.text();
+  }
+
+  async function callOnce(tool, args) {
+    const res = await doFetch(`${hub}/mcp`, {
+      method: "POST",
+      headers: headers(),
+      body: JSON.stringify({
+        jsonrpc: "2.0", id: ++rpcId, method: "tools/call",
+        params: { name: tool, arguments: { ...(opts.networkId ? { network_id: opts.networkId } : {}), ...args } },
+      }),
+      signal: AbortSignal.timeout(timeoutMs),
+    });
+    const raw = await res.text();
+    return { res, raw };
+  }
+
+  /** Call a hub MCP tool; returns the parsed JSON payload. Throws HubError on ok:false. */
+  async function call(tool, args = {}) {
+    if (!sessionId) await initialize();
+    let { res, raw } = await callOnce(tool, args);
+    // A restarted hub forgets MCP sessions: re-initialize once and retry.
+    if (res.status === 404 || res.status === 400) {
+      await initialize();
+      ({ res, raw } = await callOnce(tool, args));
+    }
+    if (res.status === 401) throw new HubError(`${tool}: unauthorized (node token rejected)`, { status: 401, tool });
+    const env = parseEnvelope(raw);
+    if (!env) throw new HubError(`${tool}: empty response (HTTP ${res.status})`, { status: res.status, tool });
+    if (env.error) throw new HubError(`${tool}: ${String(env.error.message ?? JSON.stringify(env.error)).slice(0, 300)}`, { status: res.status, tool });
+    const text = env.result?.content?.[0]?.text;
+    let payload = env.result;
+    if (typeof text === "string") {
+      // MCP-level tool failures arrive as plain text, not JSON; don't mistake
+      // them for a successful tool payload.
+      if (/^(?:MCP error|Error executing tool)/i.test(text)) {
+        throw new HubError(`${tool}: ${text.slice(0, 300)}`, { status: res.status, tool });
+      }
+      try { payload = JSON.parse(text); } catch { payload = { ok: true, text }; }
+    }
+    // An offline target is not a failure: the hub answers ok:false + queued:true
+    // with a message id, and delivers when the target comes back.
+    if (payload && payload.ok === false && payload.queued === true) return { ...payload, ok: true, queued: true };
+    if (payload && payload.ok === false) {
+      throw new HubError(`${tool}: ${payload.error ?? payload.message ?? "failed"}`, { status: res.status, tool });
+    }
+    return payload;
+  }
+
+  /**
+   * Async iterator over SSE events for `alias`. Ends when the stream closes;
+   * the caller owns reconnect/backoff.
+   */
+  async function* events(alias, signal) {
+    const res = await doFetch(`${hub}/events/${encodeURIComponent(alias)}`, {
+      headers: { Accept: "text/event-stream", "Cache-Control": "no-cache", Authorization: `Bearer ${token}` },
+      signal,
+    });
+    if (!res.ok || !res.body) throw new HubError(`events: HTTP ${res.status}`, { status: res.status });
+    const reader = res.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) return;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\n");
+        buffer = lines.pop() ?? "";
+        for (const line of lines) {
+          if (!line.startsWith("data: ")) continue;
+          try { yield JSON.parse(line.slice(6)); } catch { /* ignore malformed frame */ }
+        }
+      }
+    } finally {
+      try { await reader.cancel(); } catch { /* already closed */ }
+    }
+  }
+
+  return { call, events, hub };
+}

package/src/ledger.mjs

@@ -0,0 +1,31 @@
+// Small durable ledger of task ids this node has handled, so a reconnect, a
+// duplicate doorbell, or a plugin restart never produces a second reply.
+// States: started → answered (reply text kept until the hub accepts it) → done.
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+
+const MAX_ENTRIES = 500;
+
+export function createLedger(path) {
+  let entries = {};
+  if (path) {
+    try { entries = JSON.parse(readFileSync(path, "utf8")).tasks ?? {}; } catch { entries = {}; }
+  }
+  const persist = () => {
+    if (!path) return;
+    const ids = Object.keys(entries);
+    if (ids.length > MAX_ENTRIES) {
+      ids.sort((a, b) => (entries[a].at ?? 0) - (entries[b].at ?? 0));
+      for (const id of ids.slice(0, ids.length - MAX_ENTRIES)) delete entries[id];
+    }
+    mkdirSync(dirname(path), { recursive: true });
+    const tmp = `${path}.${process.pid}.tmp`;
+    writeFileSync(tmp, JSON.stringify({ tasks: entries }), { mode: 0o600 });
+    renameSync(tmp, path);
+  };
+  return {
+    get: (id) => entries[id],
+    set(id, value) { entries[id] = { ...value, at: Date.now() }; persist(); },
+    snapshot: () => JSON.parse(JSON.stringify(entries)),
+  };
+}