nolo-cli 0.1.40 → 0.1.42

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/activityCompletion.ts

@@ -0,0 +1,97 @@
+import { serializeMessageContent } from "./messageContent";
+import {
+  buildActivityTimeline,
+  type ToolActivityStatus,
+} from "./web/toolDisplayName";
+
+type ActivityMessage = Parameters<typeof buildActivityTimeline>[0][number];
+
+type AssistantActivityCompletionInput = {
+  messages: ActivityMessage[];
+  finalContent: unknown;
+};
+
+type AssistantActivityCompletionMetadata = {
+  activity: {
+    phase: {
+      id: string;
+      title: string;
+      index?: number;
+      total?: number;
+      status: Extract<ToolActivityStatus, "success">;
+    };
+  };
+};
+
+const FINAL_DELIVERY_PHASE_PATTERNS = [
+  /汇报/,
+  /回复/,
+  /总结/,
+  /结果/,
+  /交付/,
+  /可视化/,
+  /图表/,
+  /report/i,
+  /deliver/i,
+  /result/i,
+  /summary/i,
+  /visual/i,
+  /chart/i,
+];
+
+const FAILED_FINAL_CONTENT_PATTERNS = [
+  /抱歉/,
+  /无法/,
+  /不能/,
+  /失败/,
+  /出错/,
+  /未完成/,
+  /cannot/i,
+  /can't/i,
+  /failed/i,
+  /error/i,
+  /unable/i,
+];
+
+function isLikelyFinalDeliveryPhase(title: string): boolean {
+  return FINAL_DELIVERY_PHASE_PATTERNS.some((pattern) => pattern.test(title));
+}
+
+function isLikelyFailedFinalContent(text: string): boolean {
+  return FAILED_FINAL_CONTENT_PATTERNS.some((pattern) => pattern.test(text));
+}
+
+export function inferAssistantActivityCompletionMetadata({
+  messages,
+  finalContent,
+}: AssistantActivityCompletionInput): AssistantActivityCompletionMetadata | undefined {
+  const finalText = serializeMessageContent(finalContent, "[图片]")?.trim();
+  if (!finalText || isLikelyFailedFinalContent(finalText)) return undefined;
+
+  const timeline = buildActivityTimeline(messages);
+  if (timeline.totalPhases <= 1 || timeline.completedPhases >= timeline.totalPhases) {
+    return undefined;
+  }
+
+  const finalPhase = timeline.phases[timeline.phases.length - 1];
+  if (!finalPhase || finalPhase.status !== "pending") return undefined;
+
+  const priorPhases = timeline.phases.slice(0, -1);
+  if (priorPhases.length === 0 || priorPhases.some((phase) => phase.status !== "success")) {
+    return undefined;
+  }
+
+  if (!isLikelyFinalDeliveryPhase(finalPhase.title)) return undefined;
+
+  return {
+    activity: {
+      phase: {
+        id: finalPhase.id,
+        title: finalPhase.title,
+        ...(finalPhase.index !== undefined ? { index: finalPhase.index } : {}),
+        ...(finalPhase.total !== undefined ? { total: finalPhase.total } : {}),
+        status: "success",
+      },
+    },
+  };
+}