nolo-cli 0.1.39 → 0.1.41

package/chat/dialog/dialogTitle.ts

@@ -0,0 +1,81 @@
+const GENERATED_DIALOG_TITLE_MAX_CHARS = 36;
+const FALLBACK_DIALOG_TITLE_MAX_CHARS = 24;
+
+const WRAPPING_QUOTES_RE = /^[`"'“”‘’「」『』《》]+|[`"'“”‘’「」『』《》]+$/gu;
+const TRAILING_TITLE_PUNCTUATION_RE = /[。！？!?；;，,、：:]+$/u;
+
+const clip = (text: string, maxChars: number): string =>
+  text.length <= maxChars
+    ? text
+    : `${text.slice(0, maxChars - 1).trimEnd()}…`;
+
+const toSingleLine = (value: string): string =>
+  value
+    .replace(/\r\n?/g, "\n")
+    .split("\n")
+    .map((line) => line.trim())
+    .find(Boolean) ?? "";
+
+const stripTitleFormatting = (value: string): string =>
+  value
+    .replace(/^(?:[-*#>]+\s*|\d+\.\s+)/, "")
+    .replace(WRAPPING_QUOTES_RE, "")
+    .replace(TRAILING_TITLE_PUNCTUATION_RE, "")
+    .trim();
+
+const pickLeadingClause = (value: string): string => {
+  const firstLine = toSingleLine(value);
+  if (!firstLine) return "";
+
+  const separatorIndexes = [firstLine.indexOf("："), firstLine.indexOf(":")]
+    .filter((index) => index > 0)
+    .sort((left, right) => left - right);
+
+  for (const index of separatorIndexes) {
+    const clause = firstLine.slice(0, index).trim();
+    if (clause.length >= 4) return clause;
+  }
+
+  return firstLine;
+};
+
+export const normalizeDialogTitle = (
+  rawTitle: unknown,
+  maxChars = GENERATED_DIALOG_TITLE_MAX_CHARS
+): string => {
+  if (typeof rawTitle !== "string") return "";
+
+  const normalized = stripTitleFormatting(
+    toSingleLine(rawTitle).replace(/\s+/g, " ").trim()
+  );
+  if (!normalized) return "";
+
+  return clip(normalized, maxChars);
+};
+
+export const buildDialogFallbackTitleFromUserInput = (
+  userInput: unknown,
+  maxChars = FALLBACK_DIALOG_TITLE_MAX_CHARS
+): string => {
+  if (typeof userInput !== "string") return "";
+
+  const candidate = pickLeadingClause(userInput);
+  return normalizeDialogTitle(candidate || userInput, maxChars);
+};
+
+export const buildDialogFallbackTitleFromMessages = (
+  messages: Array<{ role?: unknown; content?: unknown }>
+): string => {
+  for (const message of messages) {
+    if (message?.role !== "user") continue;
+    const title = buildDialogFallbackTitleFromUserInput(message?.content);
+    if (title) return title;
+  }
+
+  return "";
+};
+
+export const resolveDialogTitle = (
+  generatedTitle: unknown,
+  fallbackTitle: string
+): string => normalizeDialogTitle(generatedTitle) || fallbackTitle.trim();

package/chat/dialog/dialogTokenStats.ts

@@ -0,0 +1,12 @@
+import type { DialogConfig } from "../../app/types";
+
+import type { TokenStats } from "./dialogSlice";
+
+export const mergeDialogTokenStats = (
+  dialogConfig: DialogConfig | null,
+  runtimeTokens: TokenStats
+): TokenStats => ({
+  inputTokens: (dialogConfig?.inputTokens ?? 0) + runtimeTokens.inputTokens,
+  outputTokens: (dialogConfig?.outputTokens ?? 0) + runtimeTokens.outputTokens,
+  totalCost: (dialogConfig?.totalCost ?? 0) + runtimeTokens.totalCost,
+});

package/chat/dialog/dialogUrl.ts

@@ -0,0 +1,6 @@
+import { buildScopedPagePath } from "../../create/space/contentKeyUtils";
+
+export const buildDialogUrl = (
+  dialogKey: string,
+  spaceId?: string | null
+): string => buildScopedPagePath(dialogKey, spaceId);

package/chat/dialog/goal.ts

@@ -0,0 +1,108 @@
+import type { DialogConfig, DialogGoalState } from "../../app/types";
+import type { TokenStats } from "./dialogSlice";
+
+export interface CreateDialogGoalInput {
+  objective: string;
+  tokenBudget?: number;
+  now?: number;
+}
+
+export interface DialogGoalReport {
+  goal: DialogGoalState | null;
+  usedTokens: number;
+  remainingTokens: number | null;
+  completionBudgetReport: string | null;
+}
+
+const normalizeObjective = (objective: string): string => {
+  const normalized = objective.trim();
+  if (!normalized) {
+    throw new Error("Dialog goal objective is required.");
+  }
+  return normalized;
+};
+
+const normalizeTokenBudget = (tokenBudget: unknown): number | undefined => {
+  if (typeof tokenBudget !== "number") return undefined;
+  if (!Number.isFinite(tokenBudget) || tokenBudget <= 0) return undefined;
+  return Math.floor(tokenBudget);
+};
+
+const getPersistedTokenUsage = (dialog?: DialogConfig | null): number =>
+  Math.max(0, dialog?.inputTokens ?? 0) + Math.max(0, dialog?.outputTokens ?? 0);
+
+const getRuntimeTokenUsage = (runtimeTokens?: TokenStats | null): number =>
+  Math.max(0, runtimeTokens?.inputTokens ?? 0) +
+  Math.max(0, runtimeTokens?.outputTokens ?? 0);
+
+export const buildDialogGoal = (
+  input: CreateDialogGoalInput
+): DialogGoalState => {
+  const tokenBudget = normalizeTokenBudget(input.tokenBudget);
+  return {
+    objective: normalizeObjective(input.objective),
+    status: "active",
+    ...(tokenBudget ? { tokenBudget } : {}),
+    createdAt: input.now ?? Date.now(),
+  };
+};
+
+export const createDialogGoal = (
+  dialog: DialogConfig,
+  input: CreateDialogGoalInput
+): DialogConfig => {
+  return {
+    ...dialog,
+    goal: buildDialogGoal(input),
+  };
+};
+
+export const completeDialogGoal = (
+  dialog: DialogConfig,
+  now = Date.now()
+): DialogConfig => {
+  if (!dialog.goal) return dialog;
+  return {
+    ...dialog,
+    goal: {
+      ...dialog.goal,
+      status: "complete",
+      completedAt: now,
+    },
+  };
+};
+
+export const getDialogGoalReport = (
+  dialog?: DialogConfig | null,
+  runtimeTokens?: TokenStats | null,
+  runtimeGoal?: DialogGoalState | null
+): DialogGoalReport => {
+  const goal = runtimeGoal ?? dialog?.goal ?? null;
+  const usedTokens = getPersistedTokenUsage(dialog) + getRuntimeTokenUsage(runtimeTokens);
+
+  if (!goal) {
+    return {
+      goal: null,
+      usedTokens,
+      remainingTokens: null,
+      completionBudgetReport: null,
+    };
+  }
+
+  if (typeof goal.tokenBudget !== "number") {
+    return {
+      goal,
+      usedTokens,
+      remainingTokens: null,
+      completionBudgetReport: `Goal is ${goal.status}. Used ${usedTokens} tokens. No token budget set.`,
+    };
+  }
+
+  const remainingTokens = Math.max(0, goal.tokenBudget - usedTokens);
+  return {
+    goal,
+    usedTokens,
+    remainingTokens,
+    completionBudgetReport: `Goal is ${goal.status}. Used ${usedTokens} / ${goal.tokenBudget} tokens, ${remainingTokens} remaining.`,
+  };
+};

package/chat/dialog/objectAssistantRegistry.ts

@@ -0,0 +1,286 @@
+import type { Agent } from "../../app/types";
+import type { AgentRuntimeOptions } from "../../ai/agent/types";
+import { FIREWORKS_KIMI_LATEST_MODEL } from "../../ai/llm/kimi";
+import { DataType } from "../../create/types";
+import { createAgentKey } from "../../database/keys";
+import { APP_BUILDER_PUBLIC_AGENT_KEY } from "../../app/constants/appEditor";
+
+export type ObjectAssistantKind = "page" | "table" | "app" | "image" | "file";
+export type BuiltinObjectAssistantKind = Exclude<ObjectAssistantKind, "app">;
+
+export const OBJECT_ASSISTANT_SIDEBAR_PREFIX = "objectAssistant";
+
+export const BUILTIN_OBJECT_ASSISTANT_IDS: Record<BuiltinObjectAssistantKind, string> = {
+  page: "builtin-doc-assistant-v1",
+  table: "builtin-table-assistant-v1",
+  image: "builtin-image-assistant-v1",
+  file: "builtin-file-assistant-v1",
+};
+
+type ObjectAssistantUiConfig = {
+  panelTitle: string;
+  activePanelTitle: string;
+  chatSubtitle: string;
+  loginMessage: string;
+  emptyMessage: string;
+};
+
+const OBJECT_ASSISTANT_UI: Record<ObjectAssistantKind, ObjectAssistantUiConfig> = {
+  app: {
+    panelTitle: "应用助手",
+    activePanelTitle: "应用助手",
+    chatSubtitle: "围绕当前应用继续迭代、预检与重新部署",
+    loginMessage: "登录后可在侧边栏使用助手继续修改当前应用",
+    emptyMessage: "还没有收藏 AI 助手，先去 AI 广场逛逛吧",
+  },
+  page: {
+    panelTitle: "文档助手",
+    activePanelTitle: "文档助手",
+    chatSubtitle: "帮你润色、改写、排版和扩展当前文档",
+    loginMessage: "登录后可在侧边栏使用文档助手",
+    emptyMessage: "文档助手暂时不可用，请稍后重试",
+  },
+  table: {
+    panelTitle: "表格助手",
+    activePanelTitle: "表格助手",
+    chatSubtitle: "帮你理解当前表、补数据、改数据和整理结构",
+    loginMessage: "登录后可在侧边栏使用表格助手",
+    emptyMessage: "表格助手暂时不可用，请稍后重试",
+  },
+  image: {
+    panelTitle: "图片助手",
+    activePanelTitle: "图片助手",
+    chatSubtitle: "先做图片分析与整理占位，后面可继续增强",
+    loginMessage: "登录后可在侧边栏使用图片助手",
+    emptyMessage: "图片助手暂时不可用，请稍后重试",
+  },
+  file: {
+    panelTitle: "文件助手",
+    activePanelTitle: "文件助手",
+    chatSubtitle: "先做文件理解与处理建议占位，后面可继续增强",
+    loginMessage: "登录后可在侧边栏使用文件助手",
+    emptyMessage: "文件助手暂时不可用，请稍后重试",
+  },
+};
+
+export const getObjectAssistantUiConfig = (kind: ObjectAssistantKind): ObjectAssistantUiConfig =>
+  OBJECT_ASSISTANT_UI[kind];
+
+export const getPreferredObjectAssistantKey = (
+  kind: ObjectAssistantKind,
+  userId?: string | null,
+): string[] => {
+  if (kind === "app") return [APP_BUILDER_PUBLIC_AGENT_KEY];
+  if (!userId) return [];
+  return [createAgentKey.private(userId, BUILTIN_OBJECT_ASSISTANT_IDS[kind])];
+};
+
+export const buildObjectAssistantSidebarId = (
+  kind: ObjectAssistantKind,
+  contentKey?: string | null,
+) => `${OBJECT_ASSISTANT_SIDEBAR_PREFIX}:${kind}:${contentKey ?? "current"}`;
+
+export const isObjectAssistantSidebarId = (id?: string | null) =>
+  typeof id === "string" && id.startsWith(`${OBJECT_ASSISTANT_SIDEBAR_PREFIX}:`);
+
+export const resolveBuiltinObjectAssistantKindByKey = (
+  agentKey?: string | null,
+  userId?: string | null,
+): BuiltinObjectAssistantKind | null => {
+  if (!agentKey || !userId) return null;
+
+  const entries = Object.entries(BUILTIN_OBJECT_ASSISTANT_IDS) as Array<
+    [BuiltinObjectAssistantKind, string]
+  >;
+
+  for (const [kind, id] of entries) {
+    if (agentKey === createAgentKey.private(userId, id)) {
+      return kind;
+    }
+  }
+
+  return null;
+};
+
+export const buildBuiltinObjectAssistantAgent = (
+  kind: BuiltinObjectAssistantKind,
+  userId: string,
+): Agent & { dbKey: string } => {
+  const id = BUILTIN_OBJECT_ASSISTANT_IDS[kind];
+  const dbKey = createAgentKey.private(userId, id);
+  const now = Date.now();
+
+  const common = {
+    id,
+    dbKey,
+    type: DataType.AGENT,
+    userId,
+    isPublic: false,
+    provider: "fireworks",
+    model: FIREWORKS_KIMI_LATEST_MODEL,
+    apiSource: "platform" as const,
+    useServerProxy: true,
+    inputPrice: 0.95 * 8,
+    outputPrice: 4 * 8,
+    createdAt: now,
+    updatedAt: now,
+    dialogCount: 0,
+    messageCount: 0,
+    tokenCount: 0,
+    tags: ["builtin", "sidebar-assistant", kind],
+  };
+
+  switch (kind) {
+    case "page":
+      return {
+        ...common,
+        name: "文档助手",
+        introduction: "帮你润色、改写、续写、整理结构与排版的文档助手。",
+        greeting: {
+          text:
+            "你好，我是文档助手 ✍️\n\n你可以直接对我说：\n• 帮我润色这篇文章\n• 把结构整理得更清楚\n• 给这一段改成更口语/更专业\n• 帮我补一个开头或结尾",
+          menu: [
+            { id: "polish", label: "润色当前文档", userMessage: "帮我润色当前文档，让表达更顺" },
+            { id: "structure", label: "整理结构", userMessage: "帮我整理当前文档结构，看看标题和段落怎么更清楚" },
+            { id: "continue", label: "继续写", userMessage: "基于当前文档继续往下写" },
+          ],
+        },
+        tools: ["readDoc", "updateDoc"],
+        prompt:
+          "你是一个文档编辑助手。优先基于当前文档做增量修改，不要脱离现有内容空想重写。重点帮助用户润色、改写、续写、重组结构、生成标题和摘要。涉及修改时，优先读取当前文档真值，再进行定点编辑。",
+      };
+    case "table":
+      return {
+        ...common,
+        name: "表格助手",
+        introduction: "帮你理解表结构、补数据、改数据和整理字段的表格助手。",
+        greeting: {
+          text:
+            "你好，我是表格助手 📊\n\n你可以直接对我说：\n• 帮我看看这张表还缺什么字段\n• 给表里加一条记录\n• 把某一列统一改一下\n• 按这个条件帮我整理数据",
+          menu: [
+            { id: "inspect", label: "看看这张表", userMessage: "帮我看看当前这张表的结构和可改进点" },
+            { id: "add-row", label: "新增数据", userMessage: "我想往当前表里新增一条数据" },
+            { id: "fix-data", label: "批量改数据", userMessage: "我想修改当前表里的部分数据" },
+          ],
+        },
+        tools: [
+          "createTable",
+          "addTableRow",
+          "addTableRows",
+          "queryTableRows",
+          "updateTableRow",
+          "deleteTableRow",
+        ],
+        prompt:
+          "你是一个表格编辑助手。优先帮助用户理解当前表的字段、记录和结构，然后再做新增、查询、更新或删除。对用户说“这个表里的 xxx 怎么怎么改”时，默认理解为当前聚焦或最近提到的表；必要时先确认目标行/字段。",
+      };
+    case "image":
+      return {
+        ...common,
+        name: "图片助手",
+        introduction: "当前先作为图片分析与处理建议入口，后续可扩展为更完整的图片工作流助手。",
+        greeting:
+          "你好，我是图片助手 🖼️\n\n目前我可以先帮你分析图片内容、提炼重点、给出命名/整理建议。后续我们再把更深的图片编辑工作流接上。",
+        tools: [],
+        prompt:
+          "你是一个图片助手。当前阶段重点是围绕当前图片做理解、描述、整理建议和后续处理建议。不要假装已经具备复杂图片编辑能力；如果用户要更强操作，明确说明当前可做的是分析与组织。",
+      };
+    case "file":
+      return {
+        ...common,
+        name: "文件助手",
+        introduction: "当前先作为文件理解与处理建议入口，后续可扩展为更完整的文件工作流助手。",
+        greeting:
+          "你好，我是文件助手 📎\n\n目前我可以先帮你理解这个文件适合怎么处理、怎么提取信息、下一步应该做什么。后续我们再把更完整的文件处理流程接上。",
+        tools: [],
+        prompt:
+          "你是一个文件助手。当前阶段重点是围绕当前文件提供理解、整理、提取与后续处理建议。不要假装已经完成文件内容解析；必要时明确告诉用户当前更多是占位型工作流入口。",
+      };
+  }
+};
+
+export const buildBuiltinObjectAssistantAgentFromKey = (
+  agentKey?: string | null,
+  userId?: string | null,
+): (Agent & { dbKey: string }) | null => {
+  const kind = resolveBuiltinObjectAssistantKindByKey(agentKey, userId);
+  if (!kind || !userId) return null;
+  return buildBuiltinObjectAssistantAgent(kind, userId);
+};
+
+type RuntimeArgs = {
+  kind: ObjectAssistantKind;
+  contentKey?: string | null;
+  title?: string | null;
+  summary?: string | null;
+  metadata?: Record<string, unknown>;
+};
+
+export const buildObjectAssistantRuntimeOptions = (
+  args: RuntimeArgs,
+): AgentRuntimeOptions => {
+  const { kind, contentKey, title, summary, metadata = {} } = args;
+
+  if (kind === "app") {
+    return {
+      extraTools: ["appRead", "appPreflight", "appDeploy", "openAIGptImage"],
+      editingTarget: {
+        kind: "app",
+        key: contentKey ?? undefined,
+        title: title ?? undefined,
+        summary: summary ?? "当前应用可通过 AI 继续修改与重新部署，请围绕已有实现做增量迭代。",
+        metadata,
+      },
+    };
+  }
+
+  if (kind === "table") {
+    return {
+      extraTools: [
+        "addTableRow",
+        "addTableRows",
+        "queryTableRows",
+        "updateTableRow",
+        "deleteTableRow",
+      ],
+      editingTarget: {
+        kind: "table",
+        key: contentKey ?? undefined,
+        title: title ?? undefined,
+        summary:
+          summary ??
+          "当前对象是一张数据表。优先帮助用户理解字段、记录和结构，再做新增或修改。",
+        metadata,
+      },
+    };
+  }
+
+  if (kind === "page") {
+    return {
+      extraTools: ["readDoc", "updateDoc"],
+      editingTarget: {
+        kind: "page",
+        key: contentKey ?? undefined,
+        title: title ?? undefined,
+        summary:
+          summary ??
+          "当前对象是一篇文档。优先围绕现有内容做润色、改写、续写、重组和排版建议。",
+        metadata,
+      },
+    };
+  }
+
+  return {
+    editingTarget: {
+      kind,
+      key: contentKey ?? undefined,
+      title: title ?? undefined,
+      summary:
+        summary ??
+        (kind === "image"
+          ? "当前对象是一张图片，当前阶段优先做理解、描述和整理建议。"
+          : "当前对象是一个文件，当前阶段优先做理解、整理和处理建议。"),
+      metadata,
+    },
+  };
+};

package/chat/dialog/schedule.ts

@@ -0,0 +1,17 @@
+import { Cron } from "croner";
+
+export function computeNextScheduledAt(
+  schedule: string | null | undefined,
+  now = Date.now(),
+): number | null {
+  const normalizedSchedule = typeof schedule === "string" ? schedule.trim() : "";
+  if (!normalizedSchedule) return null;
+
+  try {
+    const cron = new Cron(normalizedSchedule);
+    return cron.nextRuns(1, new Date(now))[0]?.getTime() ?? null;
+  } catch {
+    return null;
+  }
+}
+

package/chat/messages/fetchAndCacheMessages.ts

@@ -0,0 +1,119 @@
+import { Message } from "./types";
+import { fetchMessages as fetchLocalMessages } from "./fetchMessages";
+import { fetchConvMsgs } from "./fetchConvMsgs";
+import { swallowNonAbortError } from "../../app/utils/async";
+import { createKey } from "../../database/keys";
+import { DataType } from "../../create/types";
+import { isTombstoneRecord, shouldReplaceWithNextRecord } from "../../database/tombstones";
+
+type MessageRecord = Message & { deletedAt?: string };
+
+interface FetchAndCacheOptions {
+    db: any; // Local LevelDB instance
+    dialogId: string;
+    dialogKey?: string;
+    limit?: number;
+    beforeKey?: string;
+    token?: string | null;
+    remoteServers?: string[];
+    signal?: AbortSignal;
+}
+
+export const fetchAndCacheMessages = async ({
+    db,
+    dialogId,
+    dialogKey,
+    limit = 50,
+    beforeKey,
+    token,
+    remoteServers = [],
+    signal,
+}: FetchAndCacheOptions): Promise<Message[]> => {
+    // 1. 本地查询
+    const localPromise = fetchLocalMessages(db, dialogId, {
+        limit,
+        beforeKey,
+        throwOnError: false,
+        includeDeleted: true,
+    }).catch(() => [] as MessageRecord[]);
+
+    // 2. 远程查询
+    const remotePromise = (async () => {
+        if (!token || remoteServers.length === 0) return [] as MessageRecord[];
+
+        const results = await Promise.all(
+            remoteServers.map((server) =>
+                swallowNonAbortError(
+                    fetchConvMsgs(
+                        server,
+                        token,
+                        { dialogId, dialogKey, limit, beforeKey },
+                        { signal }
+                    ),
+                    [] as MessageRecord[],
+                    undefined
+                )
+            )
+        );
+        return results.flat() as MessageRecord[];
+    })();
+
+    const [localMsgs, remoteMsgs] = await Promise.all([
+        localPromise,
+        remotePromise,
+    ]);
+
+    const uniqueMap = new Map<string, MessageRecord>();
+
+    // 先放入本地消息
+    localMsgs.forEach((m) => uniqueMap.set(m.id, m));
+
+    const changedMessagesToCache = new Map<string, MessageRecord>();
+
+    // 4. 合并远程消息，并标记需要缓存的新消息
+    remoteMsgs.forEach((m) => {
+        if (!m || !m.id) return;
+
+        const existing = uniqueMap.get(m.id);
+        if (!existing || shouldReplaceWithNextRecord(m, existing)) {
+            uniqueMap.set(m.id, m);
+            changedMessagesToCache.set(m.id, m);
+        }
+    });
+
+    // 5. 将缺失的消息回写到本地 DB
+    if (changedMessagesToCache.size > 0) {
+        try {
+            const ops = Array.from(changedMessagesToCache.values()).map((msg) => {
+                let key = msg.dbKey || (msg as any)._key;
+
+                if (!key) {
+                    key = createKey(DataType.DIALOG, dialogId, "msg", msg.id);
+                }
+
+                return {
+                    type: "put",
+                    key,
+                    value: {
+                        ...msg,
+                        dbKey: key,
+                        type: DataType.MSG,
+                    },
+                };
+            });
+
+            await db.batch(ops);
+        } catch (_error) {
+            // Silently ignore cache write errors
+        }
+    }
+
+    // 6. 排序并返回
+    return Array.from(uniqueMap.values())
+        .filter((message) => !isTombstoneRecord(message))
+        .sort((a, b) => {
+            const tA = new Date((a as any).createdAt || 0).getTime();
+            const tB = new Date((b as any).createdAt || 0).getTime();
+            return tB - tA; // 降序 (Newest First)
+        });
+};

package/chat/messages/fetchConvMsgs.ts

@@ -0,0 +1,51 @@
+const FETCH_TIMEOUT = 5000;
+
+export const fetchConvMsgs = async (
+  server,
+  token,
+  { dialogId, dialogKey, limit, beforeKey },
+  options = {}
+) => {
+  const { signal: externalSignal } = options;
+
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), FETCH_TIMEOUT);
+  const onExternalAbort = () => controller.abort();
+  externalSignal?.addEventListener("abort", onExternalAbort);
+
+  try {
+    const response = await fetch(`${server}/rpc/getConvMsgs`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${token}`,
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify({
+        dialogId,
+        ...(dialogKey && { dialogKey }),
+        limit,
+        ...(beforeKey && { beforeKey }),
+      }),
+      signal: controller.signal,
+    });
+    clearTimeout(timeoutId);
+    externalSignal?.removeEventListener("abort", onExternalAbort);
+
+    if (!response.ok) {
+      console.error(`fetchConvMsgs: Failed ${response.status} from ${server}`);
+      return [];
+    }
+
+    const data = await response.json();
+    return Array.isArray(data) ? data : [];
+  } catch (error) {
+    clearTimeout(timeoutId);
+    externalSignal?.removeEventListener("abort", onExternalAbort);
+    // Only re-throw when external signal was aborted (user navigated away)
+    if (externalSignal?.aborted) {
+      throw error;
+    }
+    console.error(`fetchConvMsgs: Error fetching from ${server}:`, error);
+    return [];
+  }
+};

package/chat/messages/fileUrl.ts

@@ -0,0 +1,13 @@
+import {
+  buildDatabaseFileContentUrl,
+  isLocalDatabaseFileContentUrl,
+} from "../../database/fileUrl";
+
+export const buildMessageFileContentUrl = (
+  serverOrigin: string | undefined | null,
+  fileId: string | undefined | null
+): string | null => buildDatabaseFileContentUrl(serverOrigin, fileId);
+
+export const isLocalFileContentUrl = (
+  url: string | null | undefined
+): boolean => isLocalDatabaseFileContentUrl(url);