@downcity/agent 1.1.25 → 1.1.32

package/src/service/builtins/chat/runtime/ChatMessageMarkup.ts

@@ -1,263 +0,0 @@
-/**
- * Chat 消息标记语法解析工具。
- *
- * 关键点（中文）
- * - 统一处理 frontmatter metadata 与 `<file>` 附件标签。
- * - 解析结果保留 `segments[]`，用于按正文与附件的真实顺序发送。
- */
-
-import yaml from "js-yaml";
-import type {
-  ChatMessageFileSegment,
-  ChatMessageFileTag,
-  ChatMessageFileType,
-  ChatMessageSegment,
-  ChatMessageTextSegment,
-  ParsedChatMessageMarkup,
-} from "@/service/builtins/chat/types/ChatMessageMarkup.js";
-
-const FILE_TAG_REGEXP =
-  /<file\b([^>]*?)(?:>([\s\S]*?)<\/file>|\/>)/gi;
-const FRONTMATTER_REGEXP = /^---\s*\r?\n([\s\S]*?)\r?\n---\s*(?:\r?\n|$)/;
-
-function normalizeText(value: unknown): string {
-  return String(value ?? "").trim();
-}
-
-/**
- * 解析标签属性。
- */
-function parseTagAttributes(rawAttrs: string): Record<string, string> {
-  const out: Record<string, string> = {};
-  const attrs = String(rawAttrs || "");
-  const regexp = /([a-zA-Z_][a-zA-Z0-9_-]*)\s*=\s*(?:"([^"]*)"|'([^']*)')/g;
-  let match: RegExpExecArray | null = null;
-  while (true) {
-    match = regexp.exec(attrs);
-    if (!match) break;
-    const key = normalizeText(match[1]).toLowerCase();
-    if (!key) continue;
-    const value = normalizeText(match[2] ?? match[3] ?? "");
-    out[key] = value;
-  }
-  return out;
-}
-
-/**
- * 归一化附件类型。
- */
-export function normalizeChatMessageFileType(value: unknown): ChatMessageFileType {
-  const text = normalizeText(value).toLowerCase();
-  if (text === "photo" || text === "image") return "photo";
-  if (text === "voice") return "voice";
-  if (text === "audio") return "audio";
-  if (text === "video") return "video";
-  return "document";
-}
-
-/**
- * 提取 frontmatter metadata。
- */
-export function extractChatMessageFrontmatter(params: {
-  source: string;
-}): {
-  metadata: Record<string, unknown>;
-  body: string;
-} {
-  const source = String(params.source || "");
-  const match = FRONTMATTER_REGEXP.exec(source);
-  if (!match) {
-    return {
-      metadata: {},
-      body: source,
-    };
-  }
-
-  const yamlRaw = String(match[1] || "");
-  let metadata: Record<string, unknown> = {};
-  try {
-    const parsed = yaml.load(yamlRaw);
-    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
-      metadata = parsed as Record<string, unknown>;
-    }
-  } catch {
-    return {
-      metadata: {},
-      body: source,
-    };
-  }
-
-  return {
-    metadata,
-    body: source.slice(match[0].length),
-  };
-}
-
-function toTextSegment(text: string): ChatMessageTextSegment | null {
-  const normalized = normalizeText(text);
-  if (!normalized) return null;
-  return {
-    kind: "text",
-    text: normalized,
-  };
-}
-
-function toFileSegment(file: ChatMessageFileTag): ChatMessageFileSegment | null {
-  const path = normalizeText(file.path);
-  if (!path) return null;
-  return {
-    kind: "file",
-    file: {
-      path,
-      type: normalizeChatMessageFileType(file.type),
-      ...(normalizeText(file.caption)
-        ? { caption: normalizeText(file.caption) }
-        : {}),
-    },
-  };
-}
-
-/**
- * 提取 `<file>` 标签，并保留正文/附件的真实顺序。
- */
-export function extractChatMessageSegments(source: string): ChatMessageSegment[] {
-  const out: ChatMessageSegment[] = [];
-  const text = String(source || "");
-
-  FILE_TAG_REGEXP.lastIndex = 0;
-  let cursor = 0;
-  let match: RegExpExecArray | null = null;
-  while (true) {
-    match = FILE_TAG_REGEXP.exec(text);
-    if (!match) break;
-
-    const rawBefore = text.slice(cursor, match.index);
-    const textSegment = toTextSegment(rawBefore);
-    if (textSegment) out.push(textSegment);
-
-    const attrs = parseTagAttributes(match[1] || "");
-    const path = normalizeText(match[2] || attrs.path);
-    const fileSegment = toFileSegment({
-      path,
-      type: normalizeChatMessageFileType(attrs.type),
-      ...(normalizeText(attrs.caption) ? { caption: normalizeText(attrs.caption) } : {}),
-    });
-    if (fileSegment) out.push(fileSegment);
-    cursor = match.index + match[0].length;
-  }
-
-  const trailingText = toTextSegment(text.slice(cursor));
-  if (trailingText) out.push(trailingText);
-  return out;
-}
-
-/**
- * 提取 `<file>` 标签列表。
- */
-export function extractChatMessageFileTags(source: string): ChatMessageFileTag[] {
-  return extractChatMessageSegments(source)
-    .filter((segment): segment is ChatMessageFileSegment => segment.kind === "file")
-    .map((segment) => segment.file);
-}
-
-/**
- * 移除正文中的 `<file>` 标签，仅保留文本段。
- */
-export function stripChatMessageFileTags(source: string): string {
-  return buildChatMessageText({
-    segments: extractChatMessageSegments(source).filter(
-      (segment): segment is ChatMessageTextSegment => segment.kind === "text",
-    ),
-  });
-}
-
-function normalizeTagAttributeValue(value: string, quote: '"' | "'"): string {
-  if (quote === '"') {
-    return value.replace(/"/g, "'");
-  }
-  return value.replace(/'/g, '"');
-}
-
-/**
- * 渲染一条标准化 `<file>` 标签。
- */
-export function renderChatMessageFileTag(file: ChatMessageFileTag): string {
-  const path = normalizeText(file.path);
-  if (!path) return "";
-  const type = normalizeChatMessageFileType(file.type);
-  const caption = normalizeText(file.caption);
-  const quote: '"' | "'" = caption.includes('"') && !caption.includes("'") ? "'" : '"';
-  const safeCaption = caption
-    ? normalizeTagAttributeValue(caption, quote)
-    : "";
-  const captionAttr = safeCaption ? ` caption=${quote}${safeCaption}${quote}` : "";
-  return `<file type="${type}"${captionAttr}>${path}</file>`;
-}
-
-function renderChatMessageSegment(segment: ChatMessageSegment): string {
-  if (segment.kind === "text") return normalizeText(segment.text);
-  return renderChatMessageFileTag(segment.file);
-}
-
-/**
- * 把附件列表渲染回统一的 `<file>` 文本块。
- */
-export function buildChatMessageFileBlock(files: ChatMessageFileTag[]): string {
-  return files
-    .map((file) => renderChatMessageFileTag(file))
-    .filter((item) => normalizeText(item).length > 0)
-    .join("\n");
-}
-
-/**
- * 把片段重建成统一消息文本。
- */
-export function buildChatMessageText(params: {
-  bodyText?: string;
-  files?: ChatMessageFileTag[];
-  segments?: ChatMessageSegment[];
-}): string {
-  const segments = Array.isArray(params.segments)
-    ? params.segments
-    : [
-        ...(normalizeText(params.bodyText)
-          ? [{
-              kind: "text",
-              text: normalizeText(params.bodyText),
-            } satisfies ChatMessageTextSegment]
-          : []),
-        ...(Array.isArray(params.files)
-          ? params.files
-              .map((file) => toFileSegment(file))
-              .filter((item): item is ChatMessageFileSegment => Boolean(item))
-          : []),
-      ];
-
-  return segments
-    .map((segment) => renderChatMessageSegment(segment))
-    .filter((item) => normalizeText(item).length > 0)
-    .join("\n\n")
-    .trim();
-}
-
-/**
- * 统一解析一段 chat 消息文本。
- */
-export function parseChatMessageMarkup(source: string): ParsedChatMessageMarkup {
-  const extracted = extractChatMessageFrontmatter({
-    source: String(source || ""),
-  });
-  const segments = extractChatMessageSegments(extracted.body);
-  return {
-    metadata: extracted.metadata,
-    bodyText: buildChatMessageText({
-      segments: segments.filter(
-        (segment): segment is ChatMessageTextSegment => segment.kind === "text",
-      ),
-    }),
-    files: segments
-      .filter((segment): segment is ChatMessageFileSegment => segment.kind === "file")
-      .map((segment) => segment.file),
-    segments,
-  };
-}

package/src/service/builtins/chat/runtime/ChatMetaStore.ts

@@ -1,186 +0,0 @@
-/**
- * ChatMetaStore：按 sessionId 维护 chat 路由元信息。
- *
- * 关键点（中文）
- * - 入站消息到达时由 service/builtins/chat 写入
- * - 出站按 sessionId/chatKey 发送时由 service/builtins/chat 读取
- * - 底层数据落在 `.downcity/channel/meta.json`，由 ChannelContextStore 统一维护
- */
-
-import type { AgentContext } from "@/core/AgentContextTypes.js";
-import type { ChatMetaV1 } from "@/service/builtins/chat/types/ChatMeta.js";
-import type { ChatDispatchChannel } from "@/service/builtins/chat/types/ChatDispatcher.js";
-import {
-  removeChannelSessionRouteBySessionId,
-  readChannelSessionRouteBySessionId,
-  resolveChannelSessionIdByTarget,
-  resolveOrCreateChannelSessionIdByTarget,
-  upsertChannelSessionRouteBySessionId,
-} from "./ChannelContextStore.js";
-
-function normalizeSessionId(sessionId: string): string {
-  return String(sessionId || "").trim();
-}
-
-function normalizeChatId(chatId: string): string {
-  return String(chatId || "").trim();
-}
-
-/**
- * 读取指定 sessionId 的 chat meta。
- */
-export async function readChatMetaBySessionId(params: {
-  context: AgentContext;
-  sessionId: string;
-}): Promise<ChatMetaV1 | null> {
-  const sessionId = normalizeSessionId(params.sessionId);
-  if (!sessionId) return null;
-  const route = await readChannelSessionRouteBySessionId({
-    context: params.context,
-    sessionId,
-  });
-  if (!route) return null;
-  return {
-    v: 1,
-    updatedAt: route.updatedAt,
-    sessionId: route.sessionId,
-    channel: route.channel,
-    chatId: route.chatId,
-    ...(route.targetType ? { targetType: route.targetType } : {}),
-    ...(typeof route.threadId === "number" ? { threadId: route.threadId } : {}),
-    ...(route.messageId ? { messageId: route.messageId } : {}),
-    ...(route.actorId ? { actorId: route.actorId } : {}),
-    ...(route.actorName ? { actorName: route.actorName } : {}),
-    ...(route.chatTitle ? { chatTitle: route.chatTitle } : {}),
-  };
-}
-
-/**
- * 更新指定 sessionId 的 chat meta（全量覆盖最近快照）。
- */
-export async function upsertChatMetaBySessionId(params: {
-  context: AgentContext;
-  sessionId: string;
-  channel: ChatDispatchChannel;
-  chatId: string;
-  targetType?: string;
-  threadId?: number;
-  messageId?: string;
-  actorId?: string;
-  actorName?: string;
-  chatTitle?: string;
-}): Promise<void> {
-  const sessionId = normalizeSessionId(params.sessionId);
-  const chatId = normalizeChatId(params.chatId);
-  if (!sessionId || !chatId) return;
-  await upsertChannelSessionRouteBySessionId({
-    context: params.context,
-    sessionId,
-    target: {
-      channel: params.channel,
-      chatId,
-      ...(typeof params.targetType === "string" ? { targetType: params.targetType } : {}),
-      ...(typeof params.threadId === "number" ? { threadId: params.threadId } : {}),
-    },
-    messageId: params.messageId,
-    actorId: params.actorId,
-    actorName: params.actorName,
-    chatTitle: params.chatTitle,
-  });
-}
-
-/**
- * 通过渠道目标查找已有 sessionId。
- */
-export async function resolveSessionIdByChatTarget(params: {
-  context: AgentContext;
-  channel: ChatDispatchChannel;
-  chatId: string;
-  targetType?: string;
-  threadId?: number;
-}): Promise<string | null> {
-  const chatId = normalizeChatId(params.chatId);
-  if (!chatId) return null;
-  return await resolveChannelSessionIdByTarget({
-    context: params.context,
-    target: {
-      channel: params.channel,
-      chatId,
-      ...(typeof params.targetType === "string" ? { targetType: params.targetType } : {}),
-      ...(typeof params.threadId === "number" ? { threadId: params.threadId } : {}),
-    },
-  });
-}
-
-/**
- * 通过渠道目标解析或创建 sessionId。
- */
-export async function resolveOrCreateSessionIdByChatTarget(params: {
-  context: AgentContext;
-  channel: ChatDispatchChannel;
-  chatId: string;
-  targetType?: string;
-  threadId?: number;
-}): Promise<string | null> {
-  const chatId = normalizeChatId(params.chatId);
-  if (!chatId) return null;
-  return await resolveOrCreateChannelSessionIdByTarget({
-    context: params.context,
-    target: {
-      channel: params.channel,
-      chatId,
-      ...(typeof params.targetType === "string" ? { targetType: params.targetType } : {}),
-      ...(typeof params.threadId === "number" ? { threadId: params.threadId } : {}),
-    },
-  });
-}
-
-/**
- * 删除指定 sessionId 的 chat meta 映射。
- *
- * 关键点（中文）
- * - 删除后该 sessionId 不再可用于 chatKey 路由发送。
- * - 若同一 target 重新收到入站消息，会创建新的 sessionId。
- */
-export async function removeChatMetaBySessionId(params: {
-  context: AgentContext;
-  sessionId: string;
-}): Promise<{
-  removed: boolean;
-  route: ChatMetaV1 | null;
-}> {
-  const sessionId = normalizeSessionId(params.sessionId);
-  if (!sessionId) {
-    return {
-      removed: false,
-      route: null,
-    };
-  }
-  const result = await removeChannelSessionRouteBySessionId({
-    context: params.context,
-    sessionId,
-  });
-  const route = result.route;
-  if (!route) {
-    return {
-      removed: false,
-      route: null,
-    };
-  }
-  return {
-    removed: result.removed,
-    route: {
-      v: 1,
-      updatedAt: route.updatedAt,
-      sessionId: route.sessionId,
-      channel: route.channel,
-      chatId: route.chatId,
-      ...(route.targetType ? { targetType: route.targetType } : {}),
-      ...(typeof route.threadId === "number" ? { threadId: route.threadId } : {}),
-      ...(route.messageId ? { messageId: route.messageId } : {}),
-      ...(route.actorId ? { actorId: route.actorId } : {}),
-      ...(route.actorName ? { actorName: route.actorName } : {}),
-      ...(route.chatTitle ? { chatTitle: route.chatTitle } : {}),
-    },
-  };
-}

package/src/service/builtins/chat/runtime/ChatPromptAssets.ts

@@ -1,32 +0,0 @@
-/**
- * ChatPromptAssets：chat service 静态提示词资产。
- *
- * 关键点（中文）
- * - prompt 文本真实来源是 `*.ts.txt` 文本文件。
- * - 这里统一做 `trim()`，避免多渠道 prompt 行为不一致。
- */
-
-import chatServicePromptText from "@/service/builtins/chat/PROMPT.direct.js";
-import feishuChatPromptText from "@/service/builtins/chat/channels/feishu/PROMPT.direct.js";
-import qqChatPromptText from "@/service/builtins/chat/channels/qq/PROMPT.direct.js";
-import telegramChatPromptText from "@/service/builtins/chat/channels/telegram/PROMPT.direct.js";
-
-/**
- * chat service 基础 prompt。
- */
-export const CHAT_SERVICE_PROMPT = chatServicePromptText.trim();
-
-/**
- * 飞书 channel prompt。
- */
-export const FEISHU_CHAT_CHANNEL_PROMPT = feishuChatPromptText.trim();
-
-/**
- * QQ channel prompt。
- */
-export const QQ_CHAT_CHANNEL_PROMPT = qqChatPromptText.trim();
-
-/**
- * Telegram channel prompt。
- */
-export const TELEGRAM_CHAT_CHANNEL_PROMPT = telegramChatPromptText.trim();

package/src/service/builtins/chat/runtime/ChatQueue.ts

@@ -1,77 +0,0 @@
-/**
- * ChatQueue 共享门面。
- *
- * 关键点（中文）
- * - 迁移阶段保留旧函数式 API，内部委托给共享 `ChatQueueStore`。
- * - 新代码应优先通过 `ChatQueueStore` 实例或 `resolveChatQueueStore(runtime)` 使用队列。
- */
-
-import type {
-  ChatQueueEnqueueParams,
-  ChatQueueEnqueueResult,
-  ChatQueueItem,
-} from "@/service/builtins/chat/types/ChatQueue.js";
-import {
-  ChatQueueStore,
-  getSharedChatQueueStore,
-  resolveChatQueueStore,
-  type ChatQueueEnqueueListener,
-  type ChatQueueStorePort,
-} from "./ChatQueueStore.js";
-
-export { ChatQueueStore, getSharedChatQueueStore, resolveChatQueueStore };
-export type { ChatQueueEnqueueListener, ChatQueueStorePort };
-
-/**
- * 订阅共享 queue 的入队事件。
- */
-export function onChatQueueEnqueue(listener: ChatQueueEnqueueListener): () => void {
-  return getSharedChatQueueStore().onEnqueue(listener);
-}
-
-/**
- * 向共享 queue 入队。
- */
-export function enqueueChatQueue(
-  params: ChatQueueEnqueueParams,
-): ChatQueueEnqueueResult {
-  return getSharedChatQueueStore().enqueue(params);
-}
-
-/**
- * 从共享 queue 弹出一条消息。
- */
-export function shiftChatQueueItem(laneKey: string): ChatQueueItem | null {
-  return getSharedChatQueueStore().shift(laneKey);
-}
-
-/**
- * 从共享 queue drain 某个 lane。
- */
-export function drainChatQueueLane(
-  laneKey: string,
-  maxItems?: number,
-): ChatQueueItem[] {
-  return getSharedChatQueueStore().drain(laneKey, maxItems);
-}
-
-/**
- * 列出共享 queue 当前积压的 lane keys。
- */
-export function listChatQueueLanes(): string[] {
-  return getSharedChatQueueStore().listLanes();
-}
-
-/**
- * 查询共享 queue 某个 lane 的长度。
- */
-export function getChatQueueLaneSize(laneKey: string): number {
-  return getSharedChatQueueStore().getLaneSize(laneKey);
-}
-
-/**
- * 清空共享 queue 某个 lane。
- */
-export function clearChatQueueLane(laneKey: string): void {
-  getSharedChatQueueStore().clear(laneKey);
-}

package/src/service/builtins/chat/runtime/ChatQueueSessionBridge.ts

@@ -1,122 +0,0 @@
-/**
- * ChatQueueSessionBridge：chat queue 到 session 的桥接模块。
- *
- * 关键点（中文）
- * - 这里集中处理 queue worker 与 session port 的交互细节。
- * - ChatQueueWorker 负责调度与回发；session 的写入协议收敛到这里。
- * - 这样可以把“队列消费”与“session 持久化/补写”边界拆清楚。
- */
-
-import { drainDeferredPersistedUserMessages } from "@session/SessionRunScope.js";
-import type { JsonObject } from "@/types/common/Json.js";
-import type { SessionRunResult } from "@/session/types/SessionRun.js";
-import type { SessionUserMessageV1 } from "@/session/types/SessionMessages.js";
-import type { SessionPort } from "@/core/AgentContextTypes.js";
-import type { ChatQueueItem } from "@/service/builtins/chat/types/ChatQueue.js";
-import { resolveAssistantMessageForPersistence } from "./UserVisibleText.js";
-
-/**
- * 判断 queue item 是否需要补写到 session。
- */
-export function shouldAppendChatIngressMessage(item: ChatQueueItem): boolean {
-  return item.kind === "exec";
-}
-
-/**
- * 统一补齐入站消息分类标记。
- *
- * 关键点（中文）
- * - 当前 message history 仅写入 `exec`，所以固定写 `ingressKind=exec`。
- */
-export function buildChatIngressExtra(item: ChatQueueItem): JsonObject {
-  const base = item.extra && typeof item.extra === "object" ? item.extra : {};
-  return {
-    ...base,
-    ingressKind: "exec",
-  };
-}
-
-/**
- * 必要时把入站消息补写到 session。
- */
-export async function appendChatIngressMessageIfNeeded(params: {
-  session: SessionPort;
-  item: ChatQueueItem;
-}): Promise<void> {
-  if (!shouldAppendChatIngressMessage(params.item)) return;
-  if (params.item.sessionPersisted === true) return;
-  await params.session.appendUserMessage({
-    text: params.item.text,
-    extra: buildChatIngressExtra(params.item),
-  });
-}
-
-/**
- * 把 queue item 转成 step 阶段可并入的 user message。
- */
-export function toMergedStepUserMessage(
-  item: ChatQueueItem,
-): SessionUserMessageV1 | null {
-  if (item.kind !== "exec") return null;
-  const text = String(item.text ?? "").trim();
-  if (!text) return null;
-  return {
-    id: `u:${item.sessionId}:${item.id}`,
-    role: "user",
-    metadata: {
-      v: 1,
-      ts: Date.now(),
-      sessionId: item.sessionId,
-      source: "ingress",
-      kind: "normal",
-      extra: buildChatIngressExtra(item),
-    },
-    parts: [{ type: "text", text }],
-  };
-}
-
-/**
- * 在 session 中补写一次运行失败的 assistant 文本。
- */
-export async function appendChatRunErrorMessage(params: {
-  session: SessionPort;
-  text: string;
-}): Promise<void> {
-  await params.session.appendAssistantMessage({
-    fallbackText: params.text,
-    extra: {
-      note: "chat_queue_worker_run_failed",
-    },
-  });
-}
-
-/**
- * 持久化一次 queue run 的 session 结果。
- *
- * 关键点（中文）
- * - 若 assistant step 已经持久化，则这里不再重复补写最终 assistant。
- * - SessionRunScope 中延后缓存的 user messages 也在这里统一补写。
- */
-export async function persistChatRunResult(params: {
-  session: SessionPort;
-  sessionId: string;
-  result: SessionRunResult;
-}): Promise<void> {
-  const messageForPersistence = resolveAssistantMessageForPersistence(
-    params.result.assistantMessage,
-  );
-  if (messageForPersistence) {
-    await params.session.appendAssistantMessage({
-      message: messageForPersistence,
-    });
-  }
-
-  const deferredInjectedMessages = drainDeferredPersistedUserMessages(
-    params.sessionId,
-  );
-  for (const message of deferredInjectedMessages) {
-    await params.session.appendUserMessage({
-      message,
-    });
-  }
-}