@yanhaidao/wecom 2.4.120 → 2.5.110

package/src/app/index.ts

@@ -1,192 +0,0 @@
-import type { PluginRuntime } from "openclaw/plugin-sdk";
-import { clearWecomSourceAccount } from "../runtime/source-registry.js";
-import type { ReplyHandle } from "../types/index.js";
-import { WecomAccountRuntime } from "./account-runtime.js";
-
-let runtime: PluginRuntime | null = null;
-const runtimes = new Map<string, WecomAccountRuntime>();
-const botWsPushHandles = new Map<string, BotWsPushHandle>();
-const activeBotWsReplyHandlesBySession = new Map<string, ReplyHandle>();
-const activeBotWsReplyHandlesByPeer = new Map<string, ReplyHandle>();
-
-export type BotWsPushHandle = {
-  isConnected: () => boolean;
-  sendMarkdown: (chatId: string, content: string) => Promise<void>;
-  replyCommand: (params: {
-    cmd: string;
-    body?: Record<string, unknown>;
-    headers?: ({ req_id?: string } & Record<string, string>) | undefined;
-  }) => Promise<Record<string, unknown>>;
-  sendMedia: (params: {
-    chatId: string;
-    mediaUrl: string;
-    text?: string;
-    mediaLocalRoots?: readonly string[];
-    maxBytes?: number;
-  }) => Promise<{
-    ok: boolean;
-    messageId?: string;
-    rejected?: boolean;
-    rejectReason?: string;
-    error?: string;
-  }>;
-};
-
-function normalizeOptional(value: string | null | undefined): string | undefined {
-  const trimmed = String(value ?? "").trim();
-  return trimmed || undefined;
-}
-
-function normalizePeerId(value: string | null | undefined): string | undefined {
-  const trimmed = normalizeOptional(value);
-  return trimmed ? trimmed.toLowerCase() : undefined;
-}
-
-function buildSessionHandleKey(accountId: string, sessionKey: string): string {
-  return `${accountId}::session::${sessionKey}`;
-}
-
-function buildPeerHandleKey(
-  accountId: string,
-  peerKind: "direct" | "group",
-  peerId: string,
-): string {
-  return `${accountId}::peer::${peerKind}::${peerId}`;
-}
-
-export function setWecomRuntime(next: PluginRuntime): void {
-  runtime = next;
-}
-
-export function getWecomRuntime(): PluginRuntime {
-  if (!runtime) {
-    throw new Error("WeCom runtime not initialized");
-  }
-  return runtime;
-}
-
-export function registerAccountRuntime(accountRuntime: WecomAccountRuntime): void {
-  runtimes.set(accountRuntime.account.accountId, accountRuntime);
-  console.log(`[wecom-runtime] register account=${accountRuntime.account.accountId}`);
-}
-
-export function getAccountRuntime(accountId: string): WecomAccountRuntime | undefined {
-  return runtimes.get(accountId);
-}
-
-export function getAccountRuntimeSnapshot(accountId: string) {
-  return runtimes.get(accountId)?.buildRuntimeStatus();
-}
-
-export function registerBotWsPushHandle(accountId: string, handle: BotWsPushHandle): void {
-  botWsPushHandles.set(accountId, handle);
-}
-
-export function getBotWsPushHandle(accountId: string): BotWsPushHandle | undefined {
-  return botWsPushHandles.get(accountId);
-}
-
-export function registerActiveBotWsReplyHandle(params: {
-  accountId: string;
-  sessionKey?: string | null;
-  peerKind?: "direct" | "group" | null;
-  peerId?: string | null;
-  handle: ReplyHandle;
-}): void {
-  const accountId = normalizeOptional(params.accountId);
-  const sessionKey = normalizeOptional(params.sessionKey);
-  const peerId = normalizePeerId(params.peerId);
-  if (!accountId) {
-    return;
-  }
-  if (sessionKey) {
-    activeBotWsReplyHandlesBySession.set(
-      buildSessionHandleKey(accountId, sessionKey),
-      params.handle,
-    );
-  }
-  if ((params.peerKind === "direct" || params.peerKind === "group") && peerId) {
-    activeBotWsReplyHandlesByPeer.set(
-      buildPeerHandleKey(accountId, params.peerKind, peerId),
-      params.handle,
-    );
-  }
-}
-
-export function getActiveBotWsReplyHandle(params: {
-  accountId: string;
-  sessionKey?: string | null;
-  peerKind?: "direct" | "group" | null;
-  peerId?: string | null;
-}): ReplyHandle | undefined {
-  const accountId = normalizeOptional(params.accountId);
-  const sessionKey = normalizeOptional(params.sessionKey);
-  const peerId = normalizePeerId(params.peerId);
-  if (!accountId) {
-    return undefined;
-  }
-  if (sessionKey) {
-    const handle = activeBotWsReplyHandlesBySession.get(
-      buildSessionHandleKey(accountId, sessionKey),
-    );
-    if (handle) {
-      return handle;
-    }
-  }
-  if ((params.peerKind === "direct" || params.peerKind === "group") && peerId) {
-    return activeBotWsReplyHandlesByPeer.get(
-      buildPeerHandleKey(accountId, params.peerKind, peerId),
-    );
-  }
-  return undefined;
-}
-
-export function unregisterActiveBotWsReplyHandle(params: {
-  accountId: string;
-  sessionKey?: string | null;
-  peerKind?: "direct" | "group" | null;
-  peerId?: string | null;
-  handle?: ReplyHandle;
-}): void {
-  const accountId = normalizeOptional(params.accountId);
-  const sessionKey = normalizeOptional(params.sessionKey);
-  const peerId = normalizePeerId(params.peerId);
-  if (!accountId) {
-    return;
-  }
-  if (sessionKey) {
-    const key = buildSessionHandleKey(accountId, sessionKey);
-    const current = activeBotWsReplyHandlesBySession.get(key);
-    if (!params.handle || current === params.handle) {
-      activeBotWsReplyHandlesBySession.delete(key);
-    }
-  }
-  if ((params.peerKind === "direct" || params.peerKind === "group") && peerId) {
-    const key = buildPeerHandleKey(accountId, params.peerKind, peerId);
-    const current = activeBotWsReplyHandlesByPeer.get(key);
-    if (!params.handle || current === params.handle) {
-      activeBotWsReplyHandlesByPeer.delete(key);
-    }
-  }
-}
-
-export function unregisterBotWsPushHandle(accountId: string): void {
-  botWsPushHandles.delete(accountId);
-}
-
-export function unregisterAccountRuntime(accountId: string): void {
-  runtimes.delete(accountId);
-  botWsPushHandles.delete(accountId);
-  for (const key of activeBotWsReplyHandlesBySession.keys()) {
-    if (key.startsWith(`${accountId}::`)) {
-      activeBotWsReplyHandlesBySession.delete(key);
-    }
-  }
-  for (const key of activeBotWsReplyHandlesByPeer.keys()) {
-    if (key.startsWith(`${accountId}::`)) {
-      activeBotWsReplyHandlesByPeer.delete(key);
-    }
-  }
-  clearWecomSourceAccount(accountId);
-  console.log(`[wecom-runtime] unregister account=${accountId}`);
-}

package/src/capability/agent/delivery-service.ts

@@ -1,87 +0,0 @@
-import type { ResolvedAgentAccount } from "../../types/index.js";
-import { resolveScopedWecomTarget } from "../../target.js";
-import { deliverAgentApiMedia, deliverAgentApiText } from "../../transport/agent-api/delivery.js";
-import { canUseAgentApiDelivery } from "./fallback-policy.js";
-import { getWecomRuntime } from "../../runtime.js";
-
-export class WecomAgentDeliveryService {
-  constructor(private readonly agent: ResolvedAgentAccount) { }
-
-  assertAvailable(): void {
-    if (!canUseAgentApiDelivery(this.agent)) {
-      throw new Error(
-        `WeCom outbound requires channels.wecom.accounts.<accountId>.agent.agentId (or legacy channels.wecom.agent.agentId) for account=${this.agent.accountId}.`,
-      );
-    }
-  }
-
-  resolveTargetOrThrow(to: string | undefined) {
-    const scoped = resolveScopedWecomTarget(to, this.agent.accountId);
-    if (!scoped) {
-      console.error(`[wecom-agent-delivery] missing target account=${this.agent.accountId}`);
-      throw new Error("WeCom outbound requires a target (userid, partyid, tagid or chatid).");
-    }
-    if (scoped.accountId && scoped.accountId !== this.agent.accountId) {
-      console.error(
-        `[wecom-agent-delivery] account mismatch current=${this.agent.accountId} targetAccount=${scoped.accountId} raw=${String(to ?? "")}`,
-      );
-      throw new Error(
-        `WeCom outbound account mismatch: target belongs to account=${scoped.accountId}, current account=${this.agent.accountId}.`,
-      );
-    }
-    const target = scoped.target;
-    if (target.chatid) {
-      console.warn(
-        `[wecom-agent-delivery] blocked chat target account=${this.agent.accountId} chatId=${target.chatid}`,
-      );
-      throw new Error(
-        `企业微信（WeCom）Agent 主动发送不支持向群 chatId 发送（chatId=${target.chatid}）。` +
-        `该路径在实际环境中经常失败（例如 86008：无权限访问该会话/会话由其他应用创建）。` +
-        `请改为发送给用户（userid / user:xxx），或由 Bot 模式在群内交付。`,
-      );
-    }
-    return target;
-  }
-
-  async sendText(params: { to: string | undefined; text: string }): Promise<void> {
-    this.assertAvailable();
-    const target = this.resolveTargetOrThrow(params.to);
-    console.log(
-      `[wecom-agent-delivery] sendText account=${this.agent.accountId} to=${String(params.to ?? "")} len=${params.text.length}`,
-    );
-
-    const runtime = getWecomRuntime();
-    const chunks = runtime.channel.text.chunkText(params.text, 2048);
-
-    for (const chunk of chunks) {
-      if (!chunk.trim()) continue;
-      await deliverAgentApiText({
-        agent: this.agent,
-        target,
-        text: chunk,
-      });
-    }
-  }
-
-  async sendMedia(params: {
-    to: string | undefined;
-    text?: string;
-    buffer: Buffer;
-    filename: string;
-    contentType: string;
-  }): Promise<void> {
-    this.assertAvailable();
-    const target = this.resolveTargetOrThrow(params.to);
-    console.log(
-      `[wecom-agent-delivery] sendMedia account=${this.agent.accountId} to=${String(params.to ?? "")} filename=${params.filename} contentType=${params.contentType}`,
-    );
-    await deliverAgentApiMedia({
-      agent: this.agent,
-      target,
-      buffer: params.buffer,
-      filename: params.filename,
-      contentType: params.contentType,
-      text: params.text,
-    });
-  }
-}

package/src/capability/agent/fallback-policy.ts

@@ -1,13 +0,0 @@
-import type { ResolvedAgentAccount } from "../../types/index.js";
-
-export function canUseAgentApiDelivery(agent: ResolvedAgentAccount | undefined): boolean {
-  return Boolean(agent?.apiConfigured && typeof agent.agentId === "number");
-}
-
-export function shouldFallbackToAgentApi(params: {
-  agent: ResolvedAgentAccount | undefined;
-  hasText?: boolean;
-  hasMedia?: boolean;
-}): boolean {
-  return canUseAgentApiDelivery(params.agent) && Boolean(params.hasText || params.hasMedia);
-}

package/src/capability/agent/ingress-service.ts

@@ -1,38 +0,0 @@
-import type { OpenClawConfig } from "openclaw/plugin-sdk";
-
-import type { WecomRuntimeEnv } from "../../types/runtime-context.js";
-import type { WecomAccountRuntime } from "../../app/account-runtime.js";
-import { startAgentCallbackTransport } from "../../transport/agent-callback/http-handler.js";
-
-export class WecomAgentIngressService {
-  private stopTransport?: () => void;
-
-  constructor(
-    private readonly runtime: WecomAccountRuntime,
-    private readonly cfg: OpenClawConfig,
-    private readonly runtimeEnv: WecomRuntimeEnv,
-  ) {}
-
-  start(): { transport: "agent-callback"; descriptors: string[] } | undefined {
-    const agent = this.runtime.account.agent;
-    if (!agent?.callbackConfigured) {
-      return undefined;
-    }
-    const callback = startAgentCallbackTransport({
-      account: agent,
-      cfg: this.cfg,
-      runtime: this.runtime,
-      runtimeEnv: this.runtimeEnv,
-    });
-    this.stopTransport = callback.stop;
-    return {
-      transport: "agent-callback",
-      descriptors: callback.paths,
-    };
-  }
-
-  stop(): void {
-    this.stopTransport?.();
-    this.stopTransport = undefined;
-  }
-}

package/src/capability/agent/upstream-delivery-service.ts

@@ -1,96 +0,0 @@
-import type { ResolvedAgentAccount } from "../../types/index.js";
-import { resolveScopedWecomTarget } from "../../target.js";
-import { deliverUpstreamAgentApiMedia, deliverUpstreamAgentApiText } from "../../transport/agent-api/upstream-delivery.js";
-import { canUseAgentApiDelivery } from "./fallback-policy.js";
-import { getWecomRuntime } from "../../runtime.js";
-
-/**
- * 上下游企业消息发送服务
- * 
- * 使用下游企业的 access_token 和 agentId 发送消息
- */
-export class WecomUpstreamAgentDeliveryService {
-  constructor(
-    private readonly upstreamAgent: ResolvedAgentAccount,
-    private readonly primaryAgent: ResolvedAgentAccount,
-  ) { }
-
-  assertAvailable(): void {
-    if (!canUseAgentApiDelivery(this.upstreamAgent)) {
-      throw new Error(
-        `WeCom upstream outbound requires channels.wecom.accounts.<accountId>.agent.agentId for upstream corp=${this.upstreamAgent.corpId}.`,
-      );
-    }
-  }
-
-  resolveTargetOrThrow(to: string | undefined) {
-    const scoped = resolveScopedWecomTarget(to, this.upstreamAgent.accountId);
-    if (!scoped) {
-      console.error(`[wecom-upstream-delivery] missing target account=${this.upstreamAgent.accountId}`);
-      throw new Error("WeCom upstream outbound requires a target (userid, partyid, tagid or chatid).");
-    }
-    if (scoped.accountId && scoped.accountId !== this.upstreamAgent.accountId) {
-      console.error(
-        `[wecom-upstream-delivery] account mismatch current=${this.upstreamAgent.accountId} targetAccount=${scoped.accountId} raw=${String(to ?? "")}`,
-      );
-      throw new Error(
-        `WeCom upstream outbound account mismatch: target belongs to account=${scoped.accountId}, current account=${this.upstreamAgent.accountId}.`,
-      );
-    }
-    const target = scoped.target;
-    if (target.chatid) {
-      console.warn(
-        `[wecom-upstream-delivery] blocked chat target account=${this.upstreamAgent.accountId} chatId=${target.chatid}`,
-      );
-      throw new Error(
-        `企业微信（WeCom）上下游 Agent 主动发送不支持向群 chatId 发送（chatId=${target.chatid}）。` +
-        `请改为发送给用户（userid / user:xxx）。`,
-      );
-    }
-    return target;
-  }
-
-  async sendText(params: { to: string | undefined; text: string }): Promise<void> {
-    this.assertAvailable();
-    const target = this.resolveTargetOrThrow(params.to);
-    console.log(
-      `[wecom-upstream-delivery] sendText account=${this.upstreamAgent.accountId} corpId=${this.upstreamAgent.corpId} to=${String(params.to ?? "")} len=${params.text.length}`,
-    );
-
-    const runtime = getWecomRuntime();
-    const chunks = runtime.channel.text.chunkText(params.text, 2048);
-
-    for (const chunk of chunks) {
-      if (!chunk.trim()) continue;
-      await deliverUpstreamAgentApiText({
-        upstreamAgent: this.upstreamAgent,
-        primaryAgent: this.primaryAgent,
-        target,
-        text: chunk,
-      });
-    }
-  }
-
-  async sendMedia(params: {
-    to: string | undefined;
-    text?: string;
-    buffer: Buffer;
-    filename: string;
-    contentType: string;
-  }): Promise<void> {
-    this.assertAvailable();
-    const target = this.resolveTargetOrThrow(params.to);
-    console.log(
-      `[wecom-upstream-delivery] sendMedia account=${this.upstreamAgent.accountId} corpId=${this.upstreamAgent.corpId} to=${String(params.to ?? "")} filename=${params.filename} contentType=${params.contentType}`,
-    );
-    await deliverUpstreamAgentApiMedia({
-      upstreamAgent: this.upstreamAgent,
-      primaryAgent: this.primaryAgent,
-      target,
-      buffer: params.buffer,
-      filename: params.filename,
-      contentType: params.contentType,
-      text: params.text,
-    });
-  }
-}

package/src/capability/bot/dispatch-config.ts

@@ -1,47 +0,0 @@
-import type { OpenClawConfig } from "openclaw/plugin-sdk";
-
-export function buildWecomBotDispatchConfig(config: OpenClawConfig): OpenClawConfig {
-  const baseAgents = (config as any)?.agents ?? {};
-  const baseAgentDefaults = (baseAgents as any)?.defaults ?? {};
-  const baseBlockChunk = (baseAgentDefaults as any)?.blockStreamingChunk ?? {};
-  const baseBlockCoalesce = (baseAgentDefaults as any)?.blockStreamingCoalesce ?? {};
-  const baseTools = (config as any)?.tools ?? {};
-  const baseSandbox = (baseTools as any)?.sandbox ?? {};
-  const baseSandboxTools = (baseSandbox as any)?.tools ?? {};
-  const existingTopLevelDeny = Array.isArray((baseTools as any).deny) ? ((baseTools as any).deny as string[]) : [];
-  const existingSandboxDeny = Array.isArray((baseSandboxTools as any).deny) ? ((baseSandboxTools as any).deny as string[]) : [];
-  const topLevelDeny = Array.from(new Set([...existingTopLevelDeny, "message"]));
-  const sandboxDeny = Array.from(new Set([...existingSandboxDeny, "message"]));
-  return {
-    ...(config as any),
-    agents: {
-      ...baseAgents,
-      defaults: {
-        ...baseAgentDefaults,
-        blockStreamingChunk: {
-          ...baseBlockChunk,
-          minChars: baseBlockChunk.minChars ?? 120,
-          maxChars: baseBlockChunk.maxChars ?? 360,
-          breakPreference: baseBlockChunk.breakPreference ?? "sentence",
-        },
-        blockStreamingCoalesce: {
-          ...baseBlockCoalesce,
-          minChars: baseBlockCoalesce.minChars ?? 120,
-          maxChars: baseBlockCoalesce.maxChars ?? 360,
-          idleMs: baseBlockCoalesce.idleMs ?? 250,
-        },
-      },
-    },
-    tools: {
-      ...baseTools,
-      deny: topLevelDeny,
-      sandbox: {
-        ...baseSandbox,
-        tools: {
-          ...baseSandboxTools,
-          deny: sandboxDeny,
-        },
-      },
-    },
-  } as OpenClawConfig;
-}

package/src/capability/bot/fallback-delivery.ts

@@ -1,178 +0,0 @@
-import type { OpenClawConfig, PluginRuntime } from "openclaw/plugin-sdk";
-
-import { resolveWecomAccount } from "../../config/index.js";
-import { wecomFetch } from "../../http.js";
-import { LIMITS } from "../../monitor/state.js";
-import type { StreamState } from "../../types/legacy-stream.js";
-import type { ResolvedAgentAccount } from "../../types/index.js";
-import { sendMedia as sendAgentMedia, sendText as sendAgentText, uploadMedia } from "../../transport/agent-api/core.js";
-import { buildStreamReplyFromState } from "../../transport/bot-webhook/protocol.js";
-import { useActiveReplyOnce } from "../../transport/bot-webhook/active-reply.js";
-import { guessContentTypeFromPath } from "../../transport/bot-webhook/inbound-normalizer.js";
-
-const STREAM_MAX_DM_BYTES = 200_000;
-
-export function appendDmContent(state: StreamState, text: string): void {
-  const next = state.dmContent ? `${state.dmContent}\n\n${text}`.trim() : text.trim();
-  const buf = Buffer.from(next, "utf8");
-  state.dmContent = buf.length <= STREAM_MAX_DM_BYTES ? next : buf.subarray(buf.length - STREAM_MAX_DM_BYTES).toString("utf8");
-}
-
-export function resolveAgentAccountOrUndefined(cfg: OpenClawConfig, accountId: string): ResolvedAgentAccount | undefined {
-  const agent = resolveWecomAccount({ cfg, accountId }).agent;
-  return agent?.configured ? agent : undefined;
-}
-
-export function buildFallbackPrompt(params: {
-  kind: "media" | "timeout" | "error";
-  agentConfigured: boolean;
-  userId?: string;
-  filename?: string;
-  chatType?: "group" | "direct";
-}): string {
-  const who = params.userId ? `（${params.userId}）` : "";
-  const scope = params.chatType === "group" ? "群聊" : params.chatType === "direct" ? "私聊" : "会话";
-  if (!params.agentConfigured) {
-    return `${scope}中需要通过应用私信发送${params.filename ? `（${params.filename}）` : ""}，但管理员尚未配置企业微信自建应用（Agent）通道。请联系管理员配置后再试。${who}`.trim();
-  }
-  if (!params.userId) {
-    return `${scope}中需要通过应用私信兜底发送${params.filename ? `（${params.filename}）` : ""}，但本次回调未能识别触发者 userid（请检查企微回调字段 from.userid / fromuserid）。请联系管理员排查配置。`.trim();
-  }
-  if (params.kind === "media") {
-    return `已生成文件${params.filename ? `（${params.filename}）` : ""}，将通过应用私信发送给你。${who}`.trim();
-  }
-  if (params.kind === "timeout") {
-    return `内容较长，为避免超时，后续内容将通过应用私信发送给你。${who}`.trim();
-  }
-  return `交付出现异常，已尝试通过应用私信发送给你。${who}`.trim();
-}
-
-export async function sendBotFallbackPromptNow(params: { streamId: string; text: string }): Promise<void> {
-  await useActiveReplyOnce(params.streamId, async ({ responseUrl, proxyUrl }) => {
-    const payload = {
-      msgtype: "stream",
-      stream: {
-        id: params.streamId,
-        finish: true,
-        content: params.text.trim() || "1",
-      },
-    };
-    const res = await wecomFetch(
-      responseUrl,
-      {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(payload),
-      },
-      { proxyUrl, timeoutMs: LIMITS.REQUEST_TIMEOUT_MS },
-    );
-    if (!res.ok) {
-      throw new Error(`fallback prompt push failed: ${res.status}`);
-    }
-  });
-}
-
-export async function pushFinalStreamReplyNow(params: { streamId: string; state: StreamState }): Promise<void> {
-  const finalReply = buildStreamReplyFromState(params.state) as unknown as Record<string, unknown>;
-  await useActiveReplyOnce(params.streamId, async ({ responseUrl, proxyUrl }) => {
-    const res = await wecomFetch(
-      responseUrl,
-      {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(finalReply),
-      },
-      { proxyUrl, timeoutMs: LIMITS.REQUEST_TIMEOUT_MS },
-    );
-    if (!res.ok) {
-      throw new Error(`final stream push failed: ${res.status}`);
-    }
-  });
-}
-
-export async function sendAgentDmText(params: {
-  agent: ResolvedAgentAccount;
-  userId: string;
-  text: string;
-  core: PluginRuntime;
-}): Promise<void> {
-  const chunks = params.core.channel.text.chunkText(params.text, 2048);
-  for (const chunk of chunks) {
-    const trimmed = chunk.trim();
-    if (!trimmed) continue;
-    await sendAgentText({ agent: params.agent, toUser: params.userId, text: trimmed });
-  }
-}
-
-export async function sendAgentDmMedia(params: {
-  agent: ResolvedAgentAccount;
-  userId: string;
-  mediaUrlOrPath: string;
-  contentType?: string;
-  filename: string;
-}): Promise<void> {
-  let buffer: Buffer;
-  let inferredContentType = params.contentType;
-  const looksLikeUrl = /^https?:\/\//i.test(params.mediaUrlOrPath);
-  if (looksLikeUrl) {
-    const res = await fetch(params.mediaUrlOrPath, { signal: AbortSignal.timeout(30_000) });
-    if (!res.ok) throw new Error(`media download failed: ${res.status}`);
-    buffer = Buffer.from(await res.arrayBuffer());
-    inferredContentType = inferredContentType || res.headers.get("content-type") || "application/octet-stream";
-  } else {
-    const fs = await import("node:fs/promises");
-    buffer = await fs.readFile(params.mediaUrlOrPath);
-  }
-
-  let mediaType: "image" | "voice" | "video" | "file" = "file";
-  const ct = (inferredContentType || "").toLowerCase();
-  if (ct.startsWith("image/")) mediaType = "image";
-  else if (ct.startsWith("audio/")) mediaType = "voice";
-  else if (ct.startsWith("video/")) mediaType = "video";
-
-  const mediaId = await uploadMedia({
-    agent: params.agent,
-    type: mediaType,
-    buffer,
-    filename: params.filename,
-  });
-  await sendAgentMedia({
-    agent: params.agent,
-    toUser: params.userId,
-    mediaId,
-    mediaType,
-  });
-}
-
-export function extractLocalImagePathsFromText(params: { text: string; mustAlsoAppearIn: string }): string[] {
-  const text = params.text;
-  const mustAlsoAppearIn = params.mustAlsoAppearIn;
-  if (!text.trim()) return [];
-  const exts = "(png|jpg|jpeg|gif|webp|bmp)";
-  const re = new RegExp(String.raw`(\/(?:Users|tmp|root|home)\/[^\s"'<>]+?\.${exts})`, "gi");
-  const found = new Set<string>();
-  let m: RegExpExecArray | null;
-  while ((m = re.exec(text))) {
-    const p = m[1];
-    if (!p) continue;
-    if (!mustAlsoAppearIn.includes(p)) continue;
-    found.add(p);
-  }
-  return Array.from(found);
-}
-
-export function extractLocalFilePathsFromText(text: string): string[] {
-  if (!text.trim()) return [];
-  const re = /\/(?:Users|tmp|root|home)\/[^\s"'<>]+/g;
-  const found = new Set<string>();
-  let m: RegExpExecArray | null;
-  while ((m = re.exec(text))) {
-    const p = m[0]?.trim();
-    if (p) found.add(p);
-  }
-  return Array.from(found);
-}
-
-export function guessLocalPathContentType(filePath: string): string | undefined {
-  return guessContentTypeFromPath(filePath);
-}