@mushinjs/bot-plugin-llm-chat 0.0.0-stage → 0.2.0-next.20261112165327

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Setobox
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import { LEGACY_KEYS, LegacyConfig, chatFlow, legacySettings } from "./legacy.js";
+import { Context, z } from "@mushinjs/core";
+export declare const name = "llm-chat";
+export declare const inject: string[];
+export declare const PACKAGE = "@mushinjs/bot-plugin-llm-chat";
+/**
+ * No settings: LLM chat is the flow this plugin makes on each bot ("大模型对话"), edited on the
+ * canvas. Settings from older versions are accepted and turned into that flow.
+ */
+export declare const Config: z.ZodObject<{}, z.core.$loose>;
+export declare function apply(ctx: Context, config: Record<string, unknown>): Promise<void>;
+export { LEGACY_KEYS, LegacyConfig, chatFlow, legacySettings };

package/dist/index.js

@@ -0,0 +1,95 @@
+import { LEGACY_KEYS, LegacyConfig, chatFlow, legacySettings } from "./legacy.js";
+import { z } from "@mushinjs/core";
+// src/index.ts
+const name = "llm-chat";
+const inject = [
+	"bot",
+	"flows",
+	"storage"
+];
+const PACKAGE = "@mushinjs/bot-plugin-llm-chat";
+const STORAGE_KEY = "llm-chat/flows";
+/**
+* No settings: LLM chat is the flow this plugin makes on each bot ("大模型对话"), edited on the
+* canvas. Settings from older versions are accepted and turned into that flow.
+*/
+const Config = z.looseObject({});
+let queue = Promise.resolve();
+function serial(task) {
+	const next = queue.catch(() => {}).then(task);
+	queue = next;
+	return next;
+}
+const exists = (ctx, id) => {
+	try {
+		ctx.flows.get(id);
+		return true;
+	} catch {
+		return false;
+	}
+};
+/** Makes the bot's chat flow, or rewrites it when legacy settings changed; drops flows of deleted bots. */
+async function reconcile(ctx, raw) {
+	const logger = ctx.logger("llm-chat");
+	const botId = ctx.bot.id;
+	const state = await ctx.storage.get(STORAGE_KEY) ?? {};
+	const known = new Set(ctx.bots.list().map((bot) => bot.id));
+	for (const [id, entry] of Object.entries(state)) {
+		if (known.has(id)) continue;
+		if (exists(ctx, entry.flow)) await ctx.flows.remove(entry.flow);
+		delete state[id];
+	}
+	const legacy = legacySettings(raw);
+	const parsed = LegacyConfig.safeParse(legacy);
+	if (!parsed.success) logger.warn("ignoring old LLM chat settings that are not valid: %s", z.prettifyError(parsed.error));
+	const settings = parsed.success ? parsed.data : LegacyConfig.parse({});
+	const fingerprint = JSON.stringify(parsed.success ? legacy : {});
+	const entry = state[botId];
+	if (!entry || !exists(ctx, entry.flow)) {
+		const doc = await ctx.flows.create({
+			name: `大模型对话 · ${ctx.bot.record.name}`,
+			description: "被 @ 或私聊时用大模型回复。由“大模型对话”插件创建；在这个机器人上停用该插件会删除它。",
+			adapter: ctx.bot.platform,
+			bots: [botId],
+			source: {
+				kind: "plugin",
+				plugin: PACKAGE
+			},
+			...chatFlow(settings)
+		});
+		state[botId] = {
+			flow: doc.id,
+			settings: fingerprint
+		};
+		logger.info(Object.keys(legacy).length ? "turned the LLM chat settings into the flow \"%s\"" : "created the flow \"%s\"", doc.name);
+	} else if (Object.keys(legacy).length && fingerprint !== entry.settings) {
+		await ctx.flows.update(entry.flow, chatFlow(settings));
+		entry.settings = fingerprint;
+		logger.info("rewrote the flow \"%s\" from the LLM chat settings", ctx.flows.get(entry.flow).name);
+	}
+	await ctx.storage.set(STORAGE_KEY, state);
+}
+/** Deletes the bot's chat flow once the plugin is turned off on it (not when the bot only restarts). */
+async function cleanup(ctx, botId) {
+	let enabled;
+	try {
+		enabled = ctx.bots.get(botId).plugins.find((item) => item.package === PACKAGE)?.enabled;
+	} catch {}
+	if (enabled !== false) return;
+	const state = await ctx.storage.get(STORAGE_KEY) ?? {};
+	const entry = state[botId];
+	if (!entry) return;
+	if (exists(ctx, entry.flow)) await ctx.flows.remove(entry.flow);
+	delete state[botId];
+	await ctx.storage.set(STORAGE_KEY, state);
+	ctx.logger("llm-chat").info("removed the LLM chat flow of bot %s", botId);
+}
+async function apply(ctx, config) {
+	const botId = ctx.bot.id;
+	const logger = ctx.logger("llm-chat");
+	ctx.effect(() => () => serial(() => cleanup(ctx, botId)).catch((error) => logger.warn("removing the LLM chat flow failed: %s", error)), "llm-chat flow");
+	await serial(() => reconcile(ctx, config ?? {}));
+}
+export { Config, LEGACY_KEYS, LegacyConfig, PACKAGE, apply, chatFlow, inject, legacySettings, name };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type { Context } from '@mushinjs/core'\r\nimport { z } from '@mushinjs/core'\r\nimport type {} from '@mushinjs/plugin-flows'\r\nimport type {} from '@mushinjs/plugin-storage'\r\nimport { chatFlow, LegacyConfig, legacySettings } from './legacy'\r\n\r\nexport * from './legacy'\r\n\r\nexport const name = 'llm-chat'\r\nexport const inject = ['bot', 'flows', 'storage']\r\n\r\nexport const PACKAGE = '@mushinjs/bot-plugin-llm-chat'\r\nconst STORAGE_KEY = 'llm-chat/flows'\r\n\r\n/**\r\n * No settings: LLM chat is the flow this plugin makes on each bot (\"大模型对话\"), edited on the\r\n * canvas. Settings from older versions are accepted and turned into that flow.\r\n */\r\nexport const Config = z.looseObject({})\r\n\r\n/** Bot id → the flow made for it, and the legacy settings it was last made from. */\r\ntype State = Record<string, { flow: string; settings: string }>\r\n\r\n// Bots start in parallel; changes to the shared state go one at a time.\r\nlet queue: Promise<unknown> = Promise.resolve()\r\nfunction serial<T>(task: () => Promise<T>): Promise<T> {\r\n  const next = queue.catch(() => {}).then(task)\r\n  queue = next\r\n  return next\r\n}\r\n\r\nconst exists = (ctx: Context, id: string) => {\r\n  try {\r\n    ctx.flows.get(id)\r\n    return true\r\n  } catch {\r\n    return false\r\n  }\r\n}\r\n\r\n/** Makes the bot's chat flow, or rewrites it when legacy settings changed; drops flows of deleted bots. */\r\nasync function reconcile(ctx: Context, raw: Record<string, unknown>) {\r\n  const logger = ctx.logger('llm-chat')\r\n  const botId = ctx.bot.id\r\n  const state = (await ctx.storage.get<State>(STORAGE_KEY)) ?? {}\r\n  const known = new Set(ctx.bots.list().map((bot) => bot.id))\r\n  for (const [id, entry] of Object.entries(state)) {\r\n    if (known.has(id)) continue\r\n    if (exists(ctx, entry.flow)) await ctx.flows.remove(entry.flow)\r\n    delete state[id]\r\n  }\r\n\r\n  const legacy = legacySettings(raw)\r\n  const parsed = LegacyConfig.safeParse(legacy)\r\n  if (!parsed.success) logger.warn('ignoring old LLM chat settings that are not valid: %s', z.prettifyError(parsed.error))\r\n  const settings = parsed.success ? parsed.data : LegacyConfig.parse({})\r\n  const fingerprint = JSON.stringify(parsed.success ? legacy : {})\r\n  const entry = state[botId]\r\n  if (!entry || !exists(ctx, entry.flow)) {\r\n    const doc = await ctx.flows.create({\r\n      name: `大模型对话 · ${ctx.bot.record.name}`,\r\n      description: '被 @ 或私聊时用大模型回复。由“大模型对话”插件创建；在这个机器人上停用该插件会删除它。',\r\n      adapter: ctx.bot.platform,\r\n      bots: [botId],\r\n      source: { kind: 'plugin', plugin: PACKAGE },\r\n      ...chatFlow(settings),\r\n    })\r\n    state[botId] = { flow: doc.id, settings: fingerprint }\r\n    logger.info(Object.keys(legacy).length ? 'turned the LLM chat settings into the flow \"%s\"' : 'created the flow \"%s\"', doc.name)\r\n  } else if (Object.keys(legacy).length && fingerprint !== entry.settings) {\r\n    await ctx.flows.update(entry.flow, chatFlow(settings))\r\n    entry.settings = fingerprint\r\n    logger.info('rewrote the flow \"%s\" from the LLM chat settings', ctx.flows.get(entry.flow).name)\r\n  }\r\n  await ctx.storage.set(STORAGE_KEY, state)\r\n}\r\n\r\n/** Deletes the bot's chat flow once the plugin is turned off on it (not when the bot only restarts). */\r\nasync function cleanup(ctx: Context, botId: string) {\r\n  let enabled: boolean | undefined\r\n  try {\r\n    enabled = ctx.bots.get(botId).plugins.find((item) => item.package === PACKAGE)?.enabled\r\n  } catch {}\r\n  if (enabled !== false) return\r\n  const state = (await ctx.storage.get<State>(STORAGE_KEY)) ?? {}\r\n  const entry = state[botId]\r\n  if (!entry) return\r\n  if (exists(ctx, entry.flow)) await ctx.flows.remove(entry.flow)\r\n  delete state[botId]\r\n  await ctx.storage.set(STORAGE_KEY, state)\r\n  ctx.logger('llm-chat').info('removed the LLM chat flow of bot %s', botId)\r\n}\r\n\r\nexport async function apply(ctx: Context, config: Record<string, unknown>) {\r\n  const botId = ctx.bot.id\r\n  const logger = ctx.logger('llm-chat')\r\n  // Runs while the plugin stops, before its context goes away.\r\n  ctx.effect(() => () => serial(() => cleanup(ctx, botId)).catch((error) => logger.warn('removing the LLM chat flow failed: %s', error)), 'llm-chat flow')\r\n  await serial(() => reconcile(ctx, config ?? {}))\r\n}\r\n"],"mappings":"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"}

package/dist/legacy.d.ts

@@ -0,0 +1,44 @@
+import { z } from "@mushinjs/core";
+import { FlowEdge, FlowNode } from "@mushinjs/plugin-flows";
+/**
+ * The settings this plugin had before LLM chat became a flow. Bots that still carry them (or API
+ * callers that send them) get an equivalent flow; the settings themselves are no longer used.
+ */
+export declare const LegacyConfig: z.ZodObject<{
+  trigger: z.ZodDefault<z.ZodEnum<{
+    mention: "mention";
+    always: "always";
+  }>>;
+  systemPrompt: z.ZodDefault<z.ZodString>;
+  provider: z.ZodOptional<z.ZodString>;
+  model: z.ZodOptional<z.ZodString>;
+  historySize: z.ZodDefault<z.ZodNumber>;
+  maxTokens: z.ZodDefault<z.ZodNumber>;
+  privateChat: z.ZodDefault<z.ZodBoolean>;
+  groups: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  ignoreUsers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  cooldown: z.ZodDefault<z.ZodNumber>;
+  userLimit: z.ZodDefault<z.ZodNumber>;
+  userWindow: z.ZodDefault<z.ZodNumber>;
+  limitNotice: z.ZodDefault<z.ZodString>;
+  dailyReplies: z.ZodDefault<z.ZodNumber>;
+  dailyTokens: z.ZodDefault<z.ZodNumber>;
+  maxInputChars: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type LegacyConfig = z.infer<typeof LegacyConfig>;
+export declare const LEGACY_KEYS: string[];
+/** Only the legacy settings of a plugin config. */
+export declare function legacySettings(config: Record<string, unknown> | undefined): {
+  [k: string]: unknown;
+};
+type NodeSpec = Omit<FlowNode, 'position'>;
+type EdgeSpec = Omit<FlowEdge, 'id'>;
+/**
+ * The flow equivalent to a set of settings: on message → cooldown → rate limit → daily quota →
+ * ask the LLM (with chat history) → reply. Steps whose limit is off are left out.
+ */
+export declare function chatFlow(settings: LegacyConfig): {
+  nodes: NodeSpec[];
+  edges: EdgeSpec[];
+};
+export {};

package/dist/legacy.js

@@ -0,0 +1,169 @@
+import { z } from "@mushinjs/core";
+// src/legacy.ts
+/**
+* The settings this plugin had before LLM chat became a flow. Bots that still carry them (or API
+* callers that send them) get an equivalent flow; the settings themselves are no longer used.
+*/
+const LegacyConfig = z.object({
+	trigger: z.enum(["mention", "always"]).default("mention"),
+	systemPrompt: z.string().default(""),
+	provider: z.string().optional(),
+	model: z.string().optional(),
+	historySize: z.number().int().min(0).max(50).default(10),
+	maxTokens: z.number().int().min(64).max(64e3).default(2e3),
+	privateChat: z.boolean().default(true),
+	groups: z.array(z.string()).default([]),
+	ignoreUsers: z.array(z.string()).default([]),
+	cooldown: z.number().min(0).default(3),
+	userLimit: z.number().int().min(0).default(5),
+	userWindow: z.number().min(1).default(60),
+	limitNotice: z.string().default(""),
+	dailyReplies: z.number().int().min(0).default(300),
+	dailyTokens: z.number().int().min(0).default(0),
+	maxInputChars: z.number().int().min(50).default(1e3)
+});
+const LEGACY_KEYS = Object.keys(LegacyConfig.shape);
+/** The system prompt the plugin used to fill in; the flow leaves it out so a persona can speak. */
+const OLD_DEFAULT_PROMPT = "You are a friendly chat bot in a QQ chat. Keep replies short and natural, and answer in the language the user writes in.";
+/** Only the legacy settings of a plugin config. */
+function legacySettings(config) {
+	return Object.fromEntries(Object.entries(config ?? {}).filter(([key]) => LEGACY_KEYS.includes(key)));
+}
+/**
+* The flow equivalent to a set of settings: on message → cooldown → rate limit → daily quota →
+* ask the LLM (with chat history) → reply. Steps whose limit is off are left out.
+*/
+function chatFlow(settings) {
+	const nodes = [];
+	const edges = [];
+	let from;
+	const step = (node, exit = "next") => {
+		nodes.push(node);
+		if (from) edges.push({
+			source: from.node,
+			sourceHandle: `exec:${from.exit}`,
+			target: node.id,
+			targetHandle: "exec"
+		});
+		from = {
+			node: node.id,
+			exit
+		};
+	};
+	step({
+		id: "message",
+		type: "trigger.message",
+		label: "收到消息",
+		priority: -100,
+		config: {
+			when: settings.trigger === "always" ? settings.privateChat ? "any" : "group" : settings.privateChat ? "mention" : "groupMention",
+			groups: settings.groups,
+			ignoreUsers: settings.ignoreUsers,
+			skipCommands: true
+		}
+	});
+	if (settings.cooldown > 0) step({
+		id: "cooldown",
+		type: "logic.cooldown",
+		label: "会话冷却",
+		config: {
+			seconds: settings.cooldown,
+			scope: "chat"
+		}
+	}, "ready");
+	if (settings.userLimit > 0) {
+		step({
+			id: "rate",
+			type: "logic.rateLimit",
+			label: "每人限额",
+			config: {
+				limit: settings.userLimit,
+				seconds: settings.userWindow,
+				per: "user"
+			}
+		}, "ok");
+		if (settings.limitNotice) {
+			nodes.push({
+				id: "firstLimited",
+				type: "logic.if",
+				label: "第一次超限",
+				config: {},
+				inputs: { condition: "{{rate.first}}" }
+			}, {
+				id: "notice",
+				type: "action.reply",
+				label: "限流提示",
+				config: {
+					text: settings.limitNotice,
+					quote: false
+				}
+			});
+			edges.push({
+				source: "rate",
+				sourceHandle: "exec:limited",
+				target: "firstLimited",
+				targetHandle: "exec"
+			}, {
+				source: "firstLimited",
+				sourceHandle: "exec:true",
+				target: "notice",
+				targetHandle: "exec"
+			});
+		}
+	}
+	if (settings.dailyReplies > 0 || settings.dailyTokens > 0) step({
+		id: "quota",
+		type: "logic.dailyQuota",
+		label: "每日额度",
+		config: {
+			times: settings.dailyReplies,
+			tokens: settings.dailyTokens,
+			per: "flow"
+		}
+	}, "ok");
+	step({
+		id: "ask",
+		type: "ai.chat",
+		label: "询问大模型",
+		config: {
+			prompt: [
+				{ kind: "persona" },
+				...settings.systemPrompt && settings.systemPrompt !== OLD_DEFAULT_PROMPT ? [{
+					kind: "system",
+					text: settings.systemPrompt
+				}] : [],
+				...settings.historySize ? [{
+					kind: "history",
+					rounds: settings.historySize,
+					source: "chat"
+				}] : [],
+				{
+					kind: "message",
+					text: ""
+				}
+			],
+			maxTokens: settings.maxTokens,
+			maxInputChars: settings.maxInputChars,
+			timeout: 45,
+			...settings.provider ? { provider: settings.provider } : {},
+			...settings.model ? { model: settings.model } : {}
+		}
+	});
+	step({
+		id: "reply",
+		type: "action.reply",
+		label: "回复",
+		config: {
+			text: "",
+			quote: false
+		},
+		inputs: { text: "{{ask.reply}}" }
+	});
+	return {
+		nodes,
+		edges
+	};
+}
+export { LEGACY_KEYS, LegacyConfig, chatFlow, legacySettings };
+
+//# sourceMappingURL=legacy.js.map

package/dist/legacy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.js","names":[],"sources":["../src/legacy.ts"],"sourcesContent":["import { z } from '@mushinjs/core'\r\nimport type { FlowEdge, FlowNode } from '@mushinjs/plugin-flows'\r\n\r\n/**\r\n * The settings this plugin had before LLM chat became a flow. Bots that still carry them (or API\r\n * callers that send them) get an equivalent flow; the settings themselves are no longer used.\r\n */\r\nexport const LegacyConfig = z.object({\r\n  trigger: z.enum(['mention', 'always']).default('mention'),\r\n  systemPrompt: z.string().default(''),\r\n  provider: z.string().optional(),\r\n  model: z.string().optional(),\r\n  historySize: z.number().int().min(0).max(50).default(10),\r\n  maxTokens: z.number().int().min(64).max(64000).default(2000),\r\n  privateChat: z.boolean().default(true),\r\n  groups: z.array(z.string()).default([]),\r\n  ignoreUsers: z.array(z.string()).default([]),\r\n  cooldown: z.number().min(0).default(3),\r\n  userLimit: z.number().int().min(0).default(5),\r\n  userWindow: z.number().min(1).default(60),\r\n  limitNotice: z.string().default(''),\r\n  dailyReplies: z.number().int().min(0).default(300),\r\n  dailyTokens: z.number().int().min(0).default(0),\r\n  maxInputChars: z.number().int().min(50).default(1000),\r\n})\r\n\r\nexport type LegacyConfig = z.infer<typeof LegacyConfig>\r\n\r\nexport const LEGACY_KEYS = Object.keys(LegacyConfig.shape)\r\n\r\n/** The system prompt the plugin used to fill in; the flow leaves it out so a persona can speak. */\r\nconst OLD_DEFAULT_PROMPT = 'You are a friendly chat bot in a QQ chat. Keep replies short and natural, and answer in the language the user writes in.'\r\n\r\n/** Only the legacy settings of a plugin config. */\r\nexport function legacySettings(config: Record<string, unknown> | undefined) {\r\n  return Object.fromEntries(Object.entries(config ?? {}).filter(([key]) => LEGACY_KEYS.includes(key)))\r\n}\r\n\r\ntype NodeSpec = Omit<FlowNode, 'position'>\r\ntype EdgeSpec = Omit<FlowEdge, 'id'>\r\n\r\n/**\r\n * The flow equivalent to a set of settings: on message → cooldown → rate limit → daily quota →\r\n * ask the LLM (with chat history) → reply. Steps whose limit is off are left out.\r\n */\r\nexport function chatFlow(settings: LegacyConfig): { nodes: NodeSpec[]; edges: EdgeSpec[] } {\r\n  const nodes: NodeSpec[] = []\r\n  const edges: EdgeSpec[] = []\r\n  let from: { node: string; exit: string } | undefined\r\n  const step = (node: NodeSpec, exit = 'next') => {\r\n    nodes.push(node)\r\n    if (from) edges.push({ source: from.node, sourceHandle: `exec:${from.exit}`, target: node.id, targetHandle: 'exec' })\r\n    from = { node: node.id, exit }\r\n  }\r\n\r\n  const when = settings.trigger === 'always'\r\n    ? (settings.privateChat ? 'any' : 'group')\r\n    : (settings.privateChat ? 'mention' : 'groupMention')\r\n  // Below other flows, so commands and keyword flows answer first.\r\n  step({ id: 'message', type: 'trigger.message', label: '收到消息', priority: -100, config: { when, groups: settings.groups, ignoreUsers: settings.ignoreUsers, skipCommands: true } })\r\n  if (settings.cooldown > 0) step({ id: 'cooldown', type: 'logic.cooldown', label: '会话冷却', config: { seconds: settings.cooldown, scope: 'chat' } }, 'ready')\r\n  if (settings.userLimit > 0) {\r\n    step({ id: 'rate', type: 'logic.rateLimit', label: '每人限额', config: { limit: settings.userLimit, seconds: settings.userWindow, per: 'user' } }, 'ok')\r\n    if (settings.limitNotice) {\r\n      nodes.push(\r\n        { id: 'firstLimited', type: 'logic.if', label: '第一次超限', config: {}, inputs: { condition: '{{rate.first}}' } },\r\n        { id: 'notice', type: 'action.reply', label: '限流提示', config: { text: settings.limitNotice, quote: false } },\r\n      )\r\n      edges.push(\r\n        { source: 'rate', sourceHandle: 'exec:limited', target: 'firstLimited', targetHandle: 'exec' },\r\n        { source: 'firstLimited', sourceHandle: 'exec:true', target: 'notice', targetHandle: 'exec' },\r\n      )\r\n    }\r\n  }\r\n  if (settings.dailyReplies > 0 || settings.dailyTokens > 0) {\r\n    step({ id: 'quota', type: 'logic.dailyQuota', label: '每日额度', config: { times: settings.dailyReplies, tokens: settings.dailyTokens, per: 'flow' } }, 'ok')\r\n  }\r\n  step({\r\n    id: 'ask',\r\n    type: 'ai.chat',\r\n    label: '询问大模型',\r\n    config: {\r\n      prompt: [\r\n        { kind: 'persona' },\r\n        ...(settings.systemPrompt && settings.systemPrompt !== OLD_DEFAULT_PROMPT ? [{ kind: 'system', text: settings.systemPrompt }] : []),\r\n        ...(settings.historySize ? [{ kind: 'history', rounds: settings.historySize, source: 'chat' }] : []),\r\n        { kind: 'message', text: '' },\r\n      ],\r\n      maxTokens: settings.maxTokens,\r\n      maxInputChars: settings.maxInputChars,\r\n      timeout: 45,\r\n      ...(settings.provider ? { provider: settings.provider } : {}),\r\n      ...(settings.model ? { model: settings.model } : {}),\r\n    },\r\n  })\r\n  step({ id: 'reply', type: 'action.reply', label: '回复', config: { text: '', quote: false }, inputs: { text: '{{ask.reply}}' } })\r\n  return { nodes, edges }\r\n}\r\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,63 @@
 {
   "name": "@mushinjs/bot-plugin-llm-chat",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0-next.20261112165327",
+  "description": "LLM chat bot plugin: makes an editable chat flow on each bot",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mushinjs/mushin.git",
+    "directory": "packages/bot-plugin-llm-chat"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "mushin-plugin"
+  ],
+  "mushin": {
+    "kind": "bot",
+    "platforms": [
+      "onebot"
+    ],
+    "category": "ai",
+    "displayName": {
+      "en": "LLM chat",
+      "zh-CN": "大模型对话"
+    },
+    "description": {
+      "en": "Makes a flow that replies with an LLM when mentioned or in private chat; edit it on the canvas",
+      "zh-CN": "创建一个被 @ 或私聊时用大模型回复的流程，可以在画布上调整"
+    },
+    "requires": {
+      "plugins": {
+        "@mushinjs/plugin-bots": "*",
+        "@mushinjs/plugin-flows": "*",
+        "@mushinjs/plugin-providers": "*",
+        "@mushinjs/plugin-storage": "*"
+      }
+    },
+    "optional": {
+      "plugins": {
+        "@mushinjs/plugin-personas": "*"
+      }
+    }
+  },
+  "dependencies": {
+    "@mushinjs/core": "0.2.0-next.20261112165327",
+    "@mushinjs/plugin-bots": "0.2.0-next.20261112165327",
+    "@mushinjs/plugin-providers": "0.2.0-next.20261112165327",
+    "@mushinjs/plugin-storage": "0.2.0-next.20261112165327",
+    "@mushinjs/plugin-flows": "0.2.0-next.20261112165327"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.