dsh-agent-toolkit 0.2.5 → 0.2.7

package/lib/index.d.ts

@@ -45,6 +45,8 @@ interface BotsModuleConfig {
   processingReactionEmoji: string;
   /** 回传飞书的错误摘要最大字符数。 */
   errorDetailMaxChars: number;
+  /** 会话创建/恢复时注入「渠道 + 发起人 open_id」提示段（dsh-agent-toolkit:channel:sender）。 */
+  injectSender: boolean;
 }
 //#endregion
 //#region src/agents/team-preset.d.ts

package/lib/index.js

@@ -1698,6 +1698,22 @@ async function setupAgentScope(agentCtx, hooks, toolsScope) {
 }
 //#endregion
 //#region src/channels/feishu/api.ts
+/** 附件服务接受的图片媒体类型（与宿主 attachment v1 一致）。 */
+const IMAGE_MEDIA_TYPES = [
+	"image/png",
+	"image/jpeg",
+	"image/webp",
+	"image/gif"
+];
+/** 按魔数判定图片媒体类型；未知字节时回退响应头 content-type（限接受集合），否则 undefined。 */
+function sniffImageMediaType(data, contentType) {
+	if (data.length >= 4 && data[0] === 137 && data[1] === 80 && data[2] === 78 && data[3] === 71) return "image/png";
+	if (data.length >= 3 && data[0] === 255 && data[1] === 216 && data[2] === 255) return "image/jpeg";
+	if (data.length >= 4 && data[0] === 71 && data[1] === 73 && data[2] === 70 && data[3] === 56) return "image/gif";
+	if (data.length >= 12 && data[0] === 82 && data[1] === 73 && data[2] === 70 && data[3] === 70 && data[8] === 87 && data[9] === 69 && data[10] === 66 && data[11] === 80) return "image/webp";
+	const declared = typeof contentType === "string" ? contentType.split(";")[0].trim().toLowerCase() : "";
+	return IMAGE_MEDIA_TYPES.includes(declared) ? declared : void 0;
+}
 /** SDK 薄封装：tenant_access_token 由 SDK 自动管理；错误带 code/msg 上下文。 */
 function createFeishuApi(client) {
 	return {
@@ -1794,6 +1810,31 @@ function createFeishuApi(client) {
 				message_id: messageId,
 				reaction_id: reactionId
 			} });
+		},
+		async downloadImage(messageId, fileKey) {
+			const res = await client.im.messageResource.get({
+				params: { type: "image" },
+				path: {
+					message_id: messageId,
+					file_key: fileKey
+				}
+			});
+			const chunks = [];
+			await new Promise((resolve, reject) => {
+				const stream = res.getReadableStream();
+				stream.on("data", (chunk) => {
+					chunks.push(chunk);
+				});
+				stream.on("end", () => resolve());
+				stream.on("error", (error) => reject(error instanceof Error ? error : new Error(String(error))));
+			});
+			const data = new Uint8Array(Buffer.concat(chunks));
+			const mediaType = sniffImageMediaType(data, res.headers?.["content-type"]);
+			if (mediaType === void 0) throw new Error(`图片资源格式不受支持（file_key=${fileKey}，content-type=${String(res.headers?.["content-type"] ?? "未知")}）`);
+			return {
+				data,
+				mediaType
+			};
 		}
 	};
 }
@@ -1814,9 +1855,39 @@ function stripMentionPlaceholders(text) {
 //#endregion
 //#region src/channels/feishu/parse.ts
 /** im.message.receive_v1 事件解析：窄化为渠道无关的 ParsedMessage；message_id 去重。 */
+/** 从 post content（段落数组）抽取文本与图片 key；段落间以换行连接。 */
+function parsePostContent(content) {
+	const imageKeys = [];
+	const paragraphs = [];
+	try {
+		const parsed = JSON.parse(content);
+		const list = Array.isArray(parsed.content) ? parsed.content : [];
+		for (const paragraph of list) {
+			if (!Array.isArray(paragraph)) continue;
+			const parts = [];
+			for (const node of paragraph) {
+				if (node === null || typeof node !== "object") continue;
+				if (node.tag === "img") {
+					if (typeof node.image_key === "string" && node.image_key.length > 0) imageKeys.push(node.image_key);
+				} else if ((node.tag === "text" || node.tag === "a") && typeof node.text === "string") parts.push(node.text);
+			}
+			paragraphs.push(parts.join(""));
+		}
+	} catch {
+		return {
+			text: "",
+			imageKeys: []
+		};
+	}
+	return {
+		text: paragraphs.join("\n"),
+		imageKeys
+	};
+}
 /**
 * SDK handler 收到的 data 即事件体（README 示例 `data.message` 直接解构）；
-* 兼容包一层 { event } 的形态。过滤：机器人消息、非文本、群内未 @机器人、空文本。
+* 兼容包一层 { event } 的形态。过滤：机器人消息、非 text/post/image 类型、
+* 群内未 @机器人、无文本且无图片。
 */
 function parseMessageEvent(data) {
 	const wrapped = data;
@@ -1825,25 +1896,38 @@ function parseMessageEvent(data) {
 	const userId = event.sender.sender_id?.open_id;
 	const msg = event.message;
 	if (typeof userId !== "string" || msg === void 0) return null;
-	if (msg.message_type !== "text" || typeof msg.content !== "string") return null;
+	if (msg.message_type !== "text" && msg.message_type !== "post" && msg.message_type !== "image") return null;
+	if (typeof msg.content !== "string") return null;
 	if (typeof msg.message_id !== "string" || typeof msg.chat_id !== "string") return null;
 	if (msg.chat_type !== "p2p" && msg.chat_type !== "group") return null;
 	if (msg.chat_type === "group" && !(msg.mentions ?? []).some((m) => m.mentioned_type === "bot")) return null;
-	let text;
-	try {
+	let text = "";
+	let imageKeys = [];
+	if (msg.message_type === "text") try {
 		const parsed = JSON.parse(msg.content);
 		if (typeof parsed.text !== "string") return null;
 		text = stripMentionPlaceholders(parsed.text);
 	} catch {
 		return null;
 	}
-	if (text.length === 0) return null;
+	else if (msg.message_type === "post") {
+		const post = parsePostContent(msg.content);
+		text = stripMentionPlaceholders(post.text);
+		imageKeys = post.imageKeys;
+	} else try {
+		const parsed = JSON.parse(msg.content);
+		if (typeof parsed.image_key === "string" && parsed.image_key.length > 0) imageKeys.push(parsed.image_key);
+	} catch {
+		return null;
+	}
+	if (text.length === 0 && imageKeys.length === 0) return null;
 	return {
 		messageId: msg.message_id,
 		chatId: msg.chat_id,
 		chatType: msg.chat_type,
 		userId,
-		text
+		text,
+		imageKeys
 	};
 }
 /** message_id 去重（飞书会重推）；FIFO 容量淘汰。 */
@@ -2276,12 +2360,14 @@ const feishuChannel = {
 				const parsed = parseMessageEvent(data);
 				if (parsed === null || !dedup.check(parsed.messageId)) return;
 				const reply = new FeishuReplyHandle(api, parsed.chatId, tunables, log);
+				const loadImages = parsed.imageKeys.length > 0 ? async () => Promise.all(parsed.imageKeys.map(async (key) => api.downloadImage(parsed.messageId, key))) : void 0;
 				io.onMessage({
 					botId: bot.record.id,
 					chatId: parsed.chatId,
 					userId: parsed.userId,
 					messageId: parsed.messageId,
 					text: parsed.text,
+					...loadImages !== void 0 ? { loadImages } : {},
 					reply,
 					ackProcessing: makeAck(api, parsed.messageId, tunables.processingReactionEmoji)
 				});
@@ -2318,8 +2404,9 @@ const FeishuConfigSchema = z$1.object({
 const BotRecordSchema = z$1.object({
 	id: z$1.string().regex(BOT_ID_RE),
 	name: z$1.string().min(1).max(64),
-	channel: z$1.literal("feishu"),
-	feishu: FeishuConfigSchema,
+	/** 渠道类型；与 feishu 同有或同无（未绑定为双双缺省）。 */
+	channel: z$1.literal("feishu").optional(),
+	feishu: FeishuConfigSchema.optional(),
 	/** 绑定项目（agent 的 cwd，绝对路径）。一 bot 一项目。 */
 	project: z$1.string().min(1),
 	/** 透传到 agent 创作期的 persona 提示段。 */
@@ -2334,7 +2421,7 @@ const BotRecordSchema = z$1.object({
 	}).optional(),
 	createdAt: z$1.number().int().nonnegative(),
 	updatedAt: z$1.number().int().nonnegative()
-});
+}).refine((r) => r.channel === void 0 === (r.feishu === void 0), { message: "channel 与 feishu 必须同有或同无" });
 const BindingSchema = z$1.object({ sessionId: z$1.string().min(1) });
 /** domain 名受 UNIT_NAME_RE 约束（^[a-z][a-z0-9_]*$），不允许连字符。 */
 const projectBotDomain = defineDomain({
@@ -2467,7 +2554,7 @@ var Outbound = class {
 };
 //#endregion
 //#region src/channels/inbound.ts
-/** 入站：指令分流 → 路由 → 单 in-flight 准入 → 表情回复 → followup 投递。 */
+/** 入站：指令分流 → 路由 → 单 in-flight 准入 → 表情回复 → 图片落附件库 → followup 投递。 */
 var Inbound = class {
 	deps;
 	constructor(deps) {
@@ -2485,7 +2572,7 @@ var Inbound = class {
 		if (bot === void 0) return;
 		const directive = parseDirective(msg.text);
 		if (directive === "new") {
-			await this.deps.router.reset(bot, msg.chatId, msg.reply);
+			await this.deps.router.reset(bot, msg.chatId, msg.reply, msg.userId);
 			await msg.reply.notice("已开启新会话");
 			return;
 		}
@@ -2502,18 +2589,30 @@ var Inbound = class {
 			await msg.reply.notice(rt === void 0 ? `项目：${bot.project}\n会话：未创建（发送消息即创建）` : `项目：${bot.project}\n会话：${rt.sessionId}\n状态：${rt.inflight !== void 0 ? "处理中" : "空闲"}`);
 			return;
 		}
-		const rt = await this.deps.router.ensure(bot, msg.chatId, msg.reply);
+		const rt = await this.deps.router.ensure(bot, msg.chatId, msg.reply, msg.userId);
 		if (rt.inflight !== void 0) {
 			await msg.reply.notice("上一条还在处理中，请稍候（或发送 /stop 取消）");
 			return;
 		}
 		rt.inflight = { ack: void 0 };
 		rt.inflight.ack = await msg.ackProcessing().catch(() => void 0) ?? void 0;
+		const imageRefs = [];
+		if (msg.loadImages !== void 0) {
+			const images = await msg.loadImages();
+			if (images.length > 0) {
+				const attachments = this.deps.attachments?.();
+				if (attachments === void 0) await msg.reply.notice("当前环境暂不支持图片消息（附件服务不可用），已按文字部分处理");
+				else imageRefs.push(...await attachments.saveImages(images));
+			}
+		}
 		const message = createUserMessage({
-			content: [{
+			content: [...msg.text.length > 0 ? [{
 				type: "text",
 				text: msg.text
-			}],
+			}] : [], ...imageRefs.map((ref) => ({
+				type: "image",
+				attachment: ref
+			}))],
 			source: { kind: "user" }
 		});
 		try {
@@ -2538,6 +2637,12 @@ function hooksOf(bot) {
 //#endregion
 //#region src/channels/router.ts
 /** 绑定路由：(botId, chatId) → 长期会话；create / resume / reset。 */
+/** 发起人提示段名：bot 会话声明来源渠道与发起人 open_id。 */
+const SENDER_SECTION_NAME = "dsh-agent-toolkit:channel:sender";
+/** sender 段文本（单聊语义；channel 取 BotRecord.channel，未来新渠道零改动透传）。 */
+function senderSectionText(channel, userId) {
+	return `本会话由 ${channel} 渠道的单聊会话发起。发起人 ID（${channel} open_id）：\`${userId}\`。`;
+}
 var Router = class {
 	agents;
 	bindings;
@@ -2546,7 +2651,8 @@ var Router = class {
 	workspace;
 	onWarn;
 	registry;
-	constructor(agents, bindings, sessions, defaultModel, workspace, onWarn, registry) {
+	injectSender;
+	constructor(agents, bindings, sessions, defaultModel, workspace, onWarn, registry, injectSender = true) {
 		this.agents = agents;
 		this.bindings = bindings;
 		this.sessions = sessions;
@@ -2554,9 +2660,10 @@ var Router = class {
 		this.workspace = workspace;
 		this.onWarn = onWarn;
 		this.registry = registry;
+		this.injectSender = injectSender;
 	}
 	/** 取（或建/恢复）该 chat 的会话 runtime；reply 刷新为最近一次入站携带的句柄。 */
-	async ensure(bot, chatId, reply) {
+	async ensure(bot, chatId, reply, userId) {
 		const bound = this.bindings.get(bot.id, chatId);
 		if (bound !== void 0) {
 			const existing = this.sessions.get(bound);
@@ -2566,7 +2673,7 @@ var Router = class {
 			}
 			const agent = await this.agents.resume({
 				sessionId: bound,
-				...this.resolveSession(bot)
+				...this.resolveSession(bot, userId)
 			});
 			await this.attach(bot.project, bound);
 			return this.adopt(bot.id, chatId, bound, agent, reply);
@@ -2575,7 +2682,7 @@ var Router = class {
 		const agent = await this.agents.create({
 			sessionId,
 			cwd: bot.project,
-			...this.resolveSession(bot)
+			...this.resolveSession(bot, userId)
 		});
 		await this.bindings.set(bot.id, chatId, sessionId);
 		await this.attach(bot.project, sessionId);
@@ -2593,20 +2700,33 @@ var Router = class {
 	resolveOptions(bot) {
 		return bot.agentOptions ?? this.defaultModel();
 	}
+	/** injectSender 开启时向 hooks.sections 末尾追加 sender 段（主/角色形态通用）。 */
+	withSenderSection(hooks, bot, userId) {
+		if (!this.injectSender) return hooks;
+		const section = {
+			name: SENDER_SECTION_NAME,
+			order: 20,
+			text: senderSectionText(bot.channel ?? "unknown", userId)
+		};
+		return {
+			...hooks,
+			sections: [...hooks.sections ?? [], section]
+		};
+	}
 	/**
 	* 按 bot.agentRef 解析会话组装（agentOptions + 创作期 hooks）：
 	* - 缺省/指向 main → 主 Agent 形态：bot 自带 persona/tools + 默认模型回退；
 	* - 指向角色 → 角色形态：persona 单 section + tools.restrict + role.model；
 	* - 指向不存在角色 → warn 并降级为主 Agent 形态。
 	*/
-	resolveSession(bot) {
+	resolveSession(bot, userId) {
 		const ref = bot.agentRef ?? "main";
 		const role = this.registry.get(ref);
 		if (role === void 0 || ref === "main") {
 			if (role === void 0 && ref !== "main") this.onWarn(`[project-bot] bot "${bot.id}" 的 agentRef "${ref}" 不存在，降级绑定主 Agent`);
 			return {
 				agentOptions: this.resolveOptions(bot),
-				hooks: hooksOf(bot)
+				hooks: this.withSenderSection(hooksOf(bot), bot, userId)
 			};
 		}
 		const sections = role.persona === void 0 || role.persona.trim().length === 0 ? [] : [{
@@ -2616,21 +2736,21 @@ var Router = class {
 		}];
 		return {
 			agentOptions: role.model ?? this.resolveOptions(bot),
-			hooks: {
+			hooks: this.withSenderSection({
 				...sections.length > 0 ? { sections } : {},
 				...role.tools !== void 0 ? { tools: role.tools.allow } : {}
-			}
+			}, bot, userId)
 		};
 	}
 	/** /new：取消旧会话、清绑定、开新会话。 */
-	async reset(bot, chatId, reply) {
+	async reset(bot, chatId, reply, userId) {
 		const bound = this.bindings.get(bot.id, chatId);
 		if (bound !== void 0) {
 			this.sessions.get(bound)?.agent.cancel();
 			this.sessions.delete(bound);
 			await this.bindings.delete(bot.id, chatId);
 		}
-		return this.ensure(bot, chatId, reply);
+		return this.ensure(bot, chatId, reply, userId);
 	}
 	lookup(botId, chatId) {
 		const bound = this.bindings.get(botId, chatId);
@@ -2663,11 +2783,12 @@ var BotRuntime = class {
 	constructor(deps) {
 		this.deps = deps;
 		const bindingStore = this.bindingStore();
-		this.router = new Router(deps.agents, bindingStore, this.sessions, deps.defaultModel, deps.workspace, (m) => deps.log.warn(m), deps.registry);
+		this.router = new Router(deps.agents, bindingStore, this.sessions, deps.defaultModel, deps.workspace, (m) => deps.log.warn(m), deps.registry, deps.injectSender ?? true);
 		this.inbound = new Inbound({
 			router: this.router,
 			bots: deps.bots,
 			maxErrorDetailChars: deps.maxErrorDetailChars,
+			...deps.attachments !== void 0 ? { attachments: deps.attachments } : {},
 			onError: (m) => deps.log.warn(m)
 		});
 		this.outbound = new Outbound(this.sessions, (m) => deps.log.warn(m), deps.maxErrorDetailChars);
@@ -2675,11 +2796,12 @@ var BotRuntime = class {
 	async startAll() {
 		for (const botId of [...this.deps.bots.keys()]) await this.reconcile(botId);
 	}
-	/** 按最新记录重建该 bot 的渠道（创建/更新后调用；记录已删则纯停止）。 */
+	/** 按最新记录重建该 bot 的渠道（创建/更新后调用；记录已删或未绑定则纯停止）。 */
 	async reconcile(botId) {
 		await this.stopChannel(botId);
 		const record = this.deps.bots.get(botId);
 		if (record === void 0) return;
+		if (record.feishu === void 0 || record.channel === void 0) return;
 		if (!this.deps.validateProject(record.project)) {
 			this.deps.log.warn(`[project-bot] bot "${botId}" 的项目路径不可用：${record.project}`);
 			return;
@@ -2713,7 +2835,17 @@ var BotRuntime = class {
 		}
 		await this.bindingStore().deleteBot(botId);
 	}
+	/** 解绑渠道：停渠道、取消在飞会话；绑定表与持久会话保留（重绑后 resume 接续）。 */
+	async unbindBot(botId) {
+		await this.stopChannel(botId);
+		for (const [sessionId, rt] of [...this.sessions]) if (rt.botId === botId) {
+			rt.agent.cancel();
+			this.sessions.delete(sessionId);
+		}
+	}
 	statusOf(botId) {
+		const record = this.deps.bots.get(botId);
+		if (record !== void 0 && record.feishu === void 0) return "unbound";
 		return this.handles.get(botId)?.status() ?? "not-running";
 	}
 	/** 卸载时序：取消在飞会话 → 等 idle → drain 出站链（卡片定格）→ 断全部渠道。 */
@@ -2821,7 +2953,7 @@ const CreateBodySchema = z$1.object({
 		/** 手动填写路径：明文密钥（立即入 credentials，不落表）。 */
 		appSecret: z$1.string().min(1).optional(),
 		/** 扫码路径：registerApp 已入库，直接给引用。 */
-		appSecretRef: z$1.string().optional()
+		appSecretRef: z$1.string().regex(CREDENTIAL_REF_RE).optional()
 	})
 });
 const UpdateBodySchema = z$1.object({
@@ -2834,11 +2966,12 @@ const UpdateBodySchema = z$1.object({
 		provider: z$1.string().min(1).optional(),
 		model: z$1.string().min(1).optional()
 	}).nullable().optional(),
-	/** 换绑应用：明文新密钥（立即入 credentials）。 */
+	/** 重绑：明文新密钥（立即入 credentials）或扫码引用（已入库）；null = 解绑渠道（删密钥、保留会话绑定）。 */
 	feishu: z$1.object({
 		appId: z$1.string().regex(FEISHU_APP_ID_RE),
-		appSecret: z$1.string().min(1)
-	}).optional()
+		appSecret: z$1.string().min(1).optional(),
+		appSecretRef: z$1.string().regex(CREDENTIAL_REF_RE).optional()
+	}).refine((f) => f.appSecret !== void 0 || f.appSecretRef !== void 0, { message: "缺少 appSecret 或 appSecretRef" }).nullable().optional()
 });
 function json(res, code, body) {
 	res.writeHead(code, { "content-type": "application/json" }).end(JSON.stringify(body));
@@ -2900,7 +3033,7 @@ function createApiHandler(deps) {
 				json(res, 409, { error: `bot id "${id}" 已存在` });
 				return;
 			}
-			for (const [, existing] of deps.bots.entries()) if (existing.feishu.appId === input.feishu.appId) {
+			for (const [, existing] of deps.bots.entries()) if (existing.feishu !== void 0 && existing.feishu.appId === input.feishu.appId) {
 				json(res, 409, { error: `appId 已被 bot "${existing.id}" 使用` });
 				return;
 			}
@@ -2955,23 +3088,40 @@ function createApiHandler(deps) {
 				return;
 			}
 			const input = parsed.data;
-			let feishu = existing.feishu;
-			if (input.feishu !== void 0) feishu = {
-				appId: input.feishu.appId,
-				appSecretRef: await deps.storeSecret(id, input.feishu.appSecret)
-			};
 			const project = input.project ?? existing.project;
 			if (!deps.validateProject(project)) {
 				json(res, 400, { error: `项目路径不可用：${project}` });
 				return;
 			}
-			const merged = {
-				...existing,
-				...input.name !== void 0 ? { name: input.name } : {},
-				project,
-				feishu,
-				updatedAt: deps.now()
-			};
+			if (input.feishu !== null && input.feishu !== void 0) {
+				for (const [, other] of deps.bots.entries()) if (other.id !== id && other.feishu?.appId === input.feishu.appId) {
+					json(res, 409, { error: `appId 已被 bot "${other.id}" 使用` });
+					return;
+				}
+			}
+			let appSecretRef;
+			if (input.feishu === null) {
+				await deps.runtime.unbindBot(id);
+				if (existing.feishu !== void 0) await deps.deleteSecret(existing.feishu.appSecretRef);
+			} else if (input.feishu !== void 0) {
+				if (input.feishu.appSecret !== void 0) appSecretRef = await deps.storeSecret(id, input.feishu.appSecret);
+				else appSecretRef = input.feishu.appSecretRef;
+				if (existing.feishu !== void 0 && existing.feishu.appSecretRef !== appSecretRef) await deps.deleteSecret(existing.feishu.appSecretRef);
+			}
+			const merged = { ...existing };
+			if (input.name !== void 0) merged.name = input.name;
+			merged.project = project;
+			merged.updatedAt = deps.now();
+			if (input.feishu === null) {
+				delete merged.channel;
+				delete merged.feishu;
+			} else if (input.feishu !== void 0 && appSecretRef !== void 0) {
+				merged.channel = "feishu";
+				merged.feishu = {
+					appId: input.feishu.appId,
+					appSecretRef
+				};
+			}
 			if (input.persona === null) delete merged.persona;
 			else if (input.persona !== void 0) merged.persona = input.persona;
 			if (input.agentRef === null) delete merged.agentRef;
@@ -2998,7 +3148,7 @@ function createApiHandler(deps) {
 			}
 			await deps.runtime.stopBot(id);
 			await deps.bots.delete(id);
-			await deps.deleteSecret(existing.feishu.appSecretRef);
+			if (existing.feishu !== void 0) await deps.deleteSecret(existing.feishu.appSecretRef);
 			json(res, 200, { ok: true });
 			return;
 		}
@@ -3175,6 +3325,18 @@ function setupBots(ctx, config, deps) {
 		if (workspaceRegistry === void 0) throw new Error("workspaceRegistry 服务不可用");
 		await (await workspaceRegistry.create(cwd)).attachSession(SessionId(sessionId));
 	} };
+	const attachmentsOf = () => {
+		if (ctx.get("attachments", false) === void 0) return void 0;
+		return { async saveImages(inputs) {
+			const current = ctx.get("attachments", false);
+			if (current === void 0) throw new Error("attachments 服务不可用");
+			return current.saveImages(inputs.map(({ data, mediaType, name }) => ({
+				data,
+				mediaType,
+				...name !== void 0 ? { name } : {}
+			})));
+		} };
+	};
 	let botsTable;
 	let bindingsTable;
 	let runtime;
@@ -3209,6 +3371,8 @@ function setupBots(ctx, config, deps) {
 			channels,
 			tunables,
 			maxErrorDetailChars: config.errorDetailMaxChars,
+			attachments: attachmentsOf,
+			injectSender: config.injectSender,
 			resolveSecret: async (ref) => (await ctx.credentials.resolve(credentialRef(ref)))?.value,
 			validateProject: (path) => existsSync(path),
 			log
@@ -3434,14 +3598,16 @@ const Config = z.object({
 		processMaxBytes: z.number().default(8e3),
 		registerAppTimeoutMs: z.number().default(6e5),
 		processingReactionEmoji: z.string().default("OneSecond"),
-		errorDetailMaxChars: z.number().default(500)
+		errorDetailMaxChars: z.number().default(500),
+		injectSender: z.boolean().default(true)
 	}).default({
 		cardUpdateThrottleMs: 500,
 		cardMaxBytes: 28e3,
 		processMaxBytes: 8e3,
 		registerAppTimeoutMs: 6e5,
 		processingReactionEmoji: "OneSecond",
-		errorDetailMaxChars: 500
+		errorDetailMaxChars: 500,
+		injectSender: true
 	}),
 	agentTeamPreset: z.object({
 		enabled: z.boolean().default(true),