luckytri 1.0.0 → 1.0.2

package/server/channels/contract.js

@@ -1,57 +1,57 @@
-// A channel is the only part of LuckyTri that knows how a platform connects.
-// Everything above it (sessions, attention, memory, time, her inner life) sees
-// the same neutral message and talks back through the same few calls, so a
-// new platform is one folder that fulfils this contract and one line in the
-// registry (see channels/index.js).
-//
-//   type                 stable id, also the first part of every session key
-//   capabilities         what the platform can express: mention, quote,
-//                        image, thread, sticker
-//   attach(server, chat) one-time wiring to the HTTP server and the ChatSystem
-//   start()              begin accepting or opening the connection for the
-//                        current settings; safe to call again after a change
-//   stop()               drop the connection and stop timers; safe to repeat
-//   send(message, text)  deliver one bubble; resolves { message_id }
-//   fetchQuoted(message) the message that `message.replyId` points to, or null
-//   fetchImage(file)     a fresh URL or bytes for an expired image, or null
-//   fetchMedia(file, type)  optional: a voice or file the same way, or null
-//   refreshDirectory()   learn real group and friend names; resolves a count
-//   canReach(sessionId)  whether she may start a conversation there now
-//   status()             { online, ... } for the connection panel
-//   close()              final shutdown
-//
-// The message every channel hands to `ChatSystem.receive` is neutral. Besides
-// the fields the core already uses, an adapter fills platformId, accountId,
-// time, mentions, replyId and attachments itself, so nothing above the
-// channel ever has to parse a platform's wire format.
-
-const REQUIRED = [
-  "start",
-  "stop",
-  "attach",
-  "send",
-  "fetchQuoted",
-  "fetchImage",
-  "refreshDirectory",
-  "canReach",
-  "status",
-  "close",
-];
-
-export function defineChannel(channel) {
-  if (!channel || typeof channel.type !== "string" || !channel.type)
-    throw new TypeError("channel needs a type");
-  for (const name of REQUIRED)
-    if (typeof channel[name] !== "function")
-      throw new TypeError(`channel ${channel.type} is missing ${name}()`);
-  return Object.freeze({
-    capabilities: {
-      mention: false,
-      quote: false,
-      image: false,
-      thread: false,
-      sticker: false,
-    },
-    ...channel,
-  });
-}
+// A channel is the only part of LuckyTri that knows how a platform connects.
+// Everything above it (sessions, attention, memory, time, her inner life) sees
+// the same neutral message and talks back through the same few calls, so a
+// new platform is one folder that fulfils this contract and one line in the
+// registry (see channels/index.js).
+//
+//   type                 stable id, also the first part of every session key
+//   capabilities         what the platform can express: mention, quote,
+//                        image, thread, sticker
+//   attach(server, chat) one-time wiring to the HTTP server and the ChatSystem
+//   start()              begin accepting or opening the connection for the
+//                        current settings; safe to call again after a change
+//   stop()               drop the connection and stop timers; safe to repeat
+//   send(message, text)  deliver one bubble; resolves { message_id }
+//   fetchQuoted(message) the message that `message.replyId` points to, or null
+//   fetchImage(file)     a fresh URL or bytes for an expired image, or null
+//   fetchMedia(file, type)  optional: a voice or file the same way, or null
+//   refreshDirectory()   learn real group and friend names; resolves a count
+//   canReach(sessionId)  whether she may start a conversation there now
+//   status()             { online, ... } for the connection panel
+//   close()              final shutdown
+//
+// The message every channel hands to `ChatSystem.receive` is neutral. Besides
+// the fields the core already uses, an adapter fills platformId, accountId,
+// time, mentions, replyId and attachments itself, so nothing above the
+// channel ever has to parse a platform's wire format.
+
+const REQUIRED = [
+  "start",
+  "stop",
+  "attach",
+  "send",
+  "fetchQuoted",
+  "fetchImage",
+  "refreshDirectory",
+  "canReach",
+  "status",
+  "close",
+];
+
+export function defineChannel(channel) {
+  if (!channel || typeof channel.type !== "string" || !channel.type)
+    throw new TypeError("channel needs a type");
+  for (const name of REQUIRED)
+    if (typeof channel[name] !== "function")
+      throw new TypeError(`channel ${channel.type} is missing ${name}()`);
+  return Object.freeze({
+    capabilities: {
+      mention: false,
+      quote: false,
+      image: false,
+      thread: false,
+      sticker: false,
+    },
+    ...channel,
+  });
+}

package/server/channels/hub.js

@@ -1,165 +1,165 @@
-import { parseSessionKey } from "./session-key.js";
-
-export const CHANNEL_TYPES = ["onebot", "qqbot"];
-
-// Which channel is wanted: the environment wins over the saved setting, the
-// same way LLM_API_KEY wins over a key saved in the studio.
-export function selectedChannel(store, env = process.env) {
-  const forced = String(env.LUCKYTRI_CHANNEL || "")
-    .trim()
-    .toLowerCase();
-  if (CHANNEL_TYPES.includes(forced)) return { type: forced, locked: true };
-  const saved = String(store.settings().channel || "");
-  return {
-    type: CHANNEL_TYPES.includes(saved) ? saved : "onebot",
-    locked: false,
-  };
-}
-
-// Exactly one channel is connected at a time. Everything above the hub talks
-// to it as if it were the channel itself, so the core, her mind and her life
-// are the same whichever platform she is on; switching is a setting, not a
-// restart.
-const QQ = new Set(CHANNEL_TYPES);
-
-export function createChannelHub(store, channels, { env = process.env } = {}) {
-  const registry = new Map(channels.map((channel) => [channel.type, channel]));
-  if (!registry.size) throw new Error("channel hub needs at least one channel");
-  let active = null;
-  let locked = false;
-  let attached = null;
-  // Plugin channels stay connected beside the one QQ channel in use.
-  const started = new Set();
-
-  const current = () => registry.get(active) || registry.values().next().value;
-
-  function resolve(sessionId) {
-    let type = active;
-    if (sessionId) {
-      try {
-        type = parseSessionKey(sessionId).channel;
-      } catch {
-        /* A session without a channel key is spoken to over the active one. */
-      }
-    }
-    if (QQ.has(type) && type !== active)
-      throw new Error("这个会话属于另一种 QQ 接入方式，当前不能向它发送");
-    const channel = registry.get(type);
-    if (!channel || (!QQ.has(type) && !started.has(type)))
-      throw new Error("这个会话的通道没有接上");
-    return channel;
-  }
-
-  // Bring the connected channel in line with the settings. Cheap when nothing
-  // changed, so it is also what runs after the credentials are edited.
-  function sync() {
-    const wanted = selectedChannel(store, env);
-    const type = registry.has(wanted.type)
-      ? wanted.type
-      : registry.keys().next().value;
-    locked = wanted.locked;
-    if (active && active !== type) registry.get(active).stop();
-    const switched = active !== type;
-    active = type;
-    registry.get(type).start();
-    if (switched)
-      registry
-        .get(type)
-        .refreshDirectory()
-        .catch(() => {});
-    return type;
-  }
-
-  function attach(server, chat) {
-    attached = { server, chat };
-    for (const channel of registry.values()) channel.attach(server, chat);
-    for (const type of started) registry.get(type)?.start();
-    sync();
-  }
-
-  function register(channel) {
-    if (!channel?.type || QQ.has(channel.type) || registry.has(channel.type))
-      throw new Error("这个通道不能接上");
-    registry.set(channel.type, channel);
-    started.add(channel.type);
-    if (attached) {
-      channel.attach(attached.server, attached.chat);
-      channel.start();
-    }
-    return channel.type;
-  }
-
-  function unregister(type) {
-    if (QQ.has(type) || !registry.has(type)) return false;
-    started.delete(type);
-    const channel = registry.get(type);
-    try {
-      channel.stop();
-      channel.close();
-    } catch {
-      /* A plugin channel that already died should still leave the hub. */
-    }
-    registry.delete(type);
-    return true;
-  }
-
-  const send = async (message, text) => {
-    if (message?.simulated) return { message_id: "sim" };
-    return resolve(message.sessionId).send(message, text);
-  };
-
-  function canReach(sessionId) {
-    try {
-      return resolve(sessionId).canReach(sessionId);
-    } catch {
-      return false;
-    }
-  }
-
-  function status() {
-    const channel = current();
-    const own = channel.status();
-    const all = {};
-    for (const item of registry.values()) all[item.type] = item.status();
-    return {
-      channel: channel.type,
-      locked,
-      online: !!own.online,
-      connectedAt: own.connectedAt ?? null,
-      lastEventAt: own.lastEventAt ?? null,
-      lastDisconnectAt: own.lastDisconnectAt ?? null,
-      adminProtected: !!env.ADMIN_TOKEN,
-      port: Number(env.PORT || 3210),
-      capabilities: channel.capabilities,
-      ...all,
-    };
-  }
-
-  return {
-    attach,
-    sync,
-    register,
-    unregister,
-    send,
-    canReach,
-    status,
-    type: () => current().type,
-    online: () =>
-      !!current().status().online ||
-      [...started].some((type) => registry.get(type)?.status().online),
-    fetchQuoted: (message) =>
-      (message?.sessionId ? resolve(message.sessionId) : current()).fetchQuoted(
-        message,
-      ),
-    fetchImage: (file, sessionId) =>
-      (sessionId ? resolve(sessionId) : current()).fetchImage(file),
-    fetchMedia: (file, sessionId, type) => {
-      const channel = sessionId ? resolve(sessionId) : current();
-      return channel.fetchMedia ? channel.fetchMedia(file, type) : null;
-    },
-    refreshDirectory: () => current().refreshDirectory(),
-    close() {
-      for (const channel of registry.values()) channel.close();
-    },
-  };
-}
+import { parseSessionKey } from "./session-key.js";
+
+export const CHANNEL_TYPES = ["onebot", "qqbot"];
+
+// Which channel is wanted: the environment wins over the saved setting, the
+// same way LLM_API_KEY wins over a key saved in the studio.
+export function selectedChannel(store, env = process.env) {
+  const forced = String(env.LUCKYTRI_CHANNEL || "")
+    .trim()
+    .toLowerCase();
+  if (CHANNEL_TYPES.includes(forced)) return { type: forced, locked: true };
+  const saved = String(store.settings().channel || "");
+  return {
+    type: CHANNEL_TYPES.includes(saved) ? saved : "onebot",
+    locked: false,
+  };
+}
+
+// Exactly one channel is connected at a time. Everything above the hub talks
+// to it as if it were the channel itself, so the core, her mind and her life
+// are the same whichever platform she is on; switching is a setting, not a
+// restart.
+const QQ = new Set(CHANNEL_TYPES);
+
+export function createChannelHub(store, channels, { env = process.env } = {}) {
+  const registry = new Map(channels.map((channel) => [channel.type, channel]));
+  if (!registry.size) throw new Error("channel hub needs at least one channel");
+  let active = null;
+  let locked = false;
+  let attached = null;
+  // Plugin channels stay connected beside the one QQ channel in use.
+  const started = new Set();
+
+  const current = () => registry.get(active) || registry.values().next().value;
+
+  function resolve(sessionId) {
+    let type = active;
+    if (sessionId) {
+      try {
+        type = parseSessionKey(sessionId).channel;
+      } catch {
+        /* A session without a channel key is spoken to over the active one. */
+      }
+    }
+    if (QQ.has(type) && type !== active)
+      throw new Error("这个会话属于另一种 QQ 接入方式，当前不能向它发送");
+    const channel = registry.get(type);
+    if (!channel || (!QQ.has(type) && !started.has(type)))
+      throw new Error("这个会话的通道没有接上");
+    return channel;
+  }
+
+  // Bring the connected channel in line with the settings. Cheap when nothing
+  // changed, so it is also what runs after the credentials are edited.
+  function sync() {
+    const wanted = selectedChannel(store, env);
+    const type = registry.has(wanted.type)
+      ? wanted.type
+      : registry.keys().next().value;
+    locked = wanted.locked;
+    if (active && active !== type) registry.get(active).stop();
+    const switched = active !== type;
+    active = type;
+    registry.get(type).start();
+    if (switched)
+      registry
+        .get(type)
+        .refreshDirectory()
+        .catch(() => {});
+    return type;
+  }
+
+  function attach(server, chat) {
+    attached = { server, chat };
+    for (const channel of registry.values()) channel.attach(server, chat);
+    for (const type of started) registry.get(type)?.start();
+    sync();
+  }
+
+  function register(channel) {
+    if (!channel?.type || QQ.has(channel.type) || registry.has(channel.type))
+      throw new Error("这个通道不能接上");
+    registry.set(channel.type, channel);
+    started.add(channel.type);
+    if (attached) {
+      channel.attach(attached.server, attached.chat);
+      channel.start();
+    }
+    return channel.type;
+  }
+
+  function unregister(type) {
+    if (QQ.has(type) || !registry.has(type)) return false;
+    started.delete(type);
+    const channel = registry.get(type);
+    try {
+      channel.stop();
+      channel.close();
+    } catch {
+      /* A plugin channel that already died should still leave the hub. */
+    }
+    registry.delete(type);
+    return true;
+  }
+
+  const send = async (message, text) => {
+    if (message?.simulated) return { message_id: "sim" };
+    return resolve(message.sessionId).send(message, text);
+  };
+
+  function canReach(sessionId) {
+    try {
+      return resolve(sessionId).canReach(sessionId);
+    } catch {
+      return false;
+    }
+  }
+
+  function status() {
+    const channel = current();
+    const own = channel.status();
+    const all = {};
+    for (const item of registry.values()) all[item.type] = item.status();
+    return {
+      channel: channel.type,
+      locked,
+      online: !!own.online,
+      connectedAt: own.connectedAt ?? null,
+      lastEventAt: own.lastEventAt ?? null,
+      lastDisconnectAt: own.lastDisconnectAt ?? null,
+      adminProtected: !!env.ADMIN_TOKEN,
+      port: Number(env.PORT || 3210),
+      capabilities: channel.capabilities,
+      ...all,
+    };
+  }
+
+  return {
+    attach,
+    sync,
+    register,
+    unregister,
+    send,
+    canReach,
+    status,
+    type: () => current().type,
+    online: () =>
+      !!current().status().online ||
+      [...started].some((type) => registry.get(type)?.status().online),
+    fetchQuoted: (message) =>
+      (message?.sessionId ? resolve(message.sessionId) : current()).fetchQuoted(
+        message,
+      ),
+    fetchImage: (file, sessionId) =>
+      (sessionId ? resolve(sessionId) : current()).fetchImage(file),
+    fetchMedia: (file, sessionId, type) => {
+      const channel = sessionId ? resolve(sessionId) : current();
+      return channel.fetchMedia ? channel.fetchMedia(file, type) : null;
+    },
+    refreshDirectory: () => current().refreshDirectory(),
+    close() {
+      for (const channel of registry.values()) channel.close();
+    },
+  };
+}

package/server/channels/index.js

@@ -1,25 +1,28 @@
-import { createOneBotChannel } from "./onebot/index.js";
-import { createQqBotChannel } from "./qqbot/index.js";
-
-// Adding a platform: write a folder that fulfils channels/contract.js, give its
-// adapter an entry in adapters.js (so the core can ask what its media links
-// look like) and its factory a line in createChannels. Nothing above the hub
-// changes.
-export function createChannels(store, options = {}) {
-  return [createOneBotChannel(store), createQqBotChannel(store, options.qqbot)];
-}
-
-export { createChannelHub, selectedChannel, CHANNEL_TYPES } from "./hub.js";
-export { defineChannel } from "./contract.js";
-export { adapterFor, registerChannel, onebot, qqbot } from "./adapters.js";
-export {
-  bindSessionId,
-  formatSessionKey,
-  isGroupSession,
-  parseSessionKey,
-  publicSession,
-  sessionAliases,
-  sessionKind,
-  sessionNativeId,
-} from "./session-key.js";
-export { normalize } from "./onebot/adapter.js";
+import { createOneBotChannel } from "./onebot/index.js";
+import { createQqBotChannel } from "./qqbot/index.js";
+
+// Adding a platform: write a folder that fulfils channels/contract.js, give its
+// adapter an entry in adapters.js (so the core can ask what its media links
+// look like) and its factory a line in createChannels. Nothing above the hub
+// changes.
+export function createChannels(store, options = {}) {
+  return [
+    createOneBotChannel(store, options.onebot),
+    createQqBotChannel(store, options.qqbot),
+  ];
+}
+
+export { createChannelHub, selectedChannel, CHANNEL_TYPES } from "./hub.js";
+export { defineChannel } from "./contract.js";
+export { adapterFor, registerChannel, onebot, qqbot } from "./adapters.js";
+export {
+  bindSessionId,
+  formatSessionKey,
+  isGroupSession,
+  parseSessionKey,
+  publicSession,
+  sessionAliases,
+  sessionKind,
+  sessionNativeId,
+} from "./session-key.js";
+export { normalize } from "./onebot/adapter.js";