@openclaw-china/shared 0.1.22 → 0.1.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw-china/shared",
-  "version": "0.1.22",
+  "version": "0.1.23",
   "type": "module",
   "exports": {
     ".": "./src/index.ts"

package/src/cron/index.ts

@@ -0,0 +1,115 @@
+const CRON_HIDDEN_PROMPT = `
+When creating or updating a cron task, use the main session's last route as the delivery target.
+- Do not ask the user for userId/chatId
+- sessionTarget="isolated"
+- payload.kind="agentTurn"
+- payload.deliver=true
+- Do not set payload.channel/to (fall back to last route automatically)
+- Do not call the message tool to send`;
+
+const CRON_TRIGGER_KEYWORDS = [
+  "定时",
+  "提醒",
+  "每分钟",
+  "每小时",
+  "每天",
+  "每周",
+  "几点",
+  "早上",
+  "晚上",
+  "工作日",
+  "cron",
+  "remind",
+  "reminder",
+  "schedule",
+  "scheduled",
+  "every minute",
+  "every hour",
+  "every day",
+  "daily",
+  "every week",
+  "weekly",
+  "weekday",
+  "workday",
+  "morning",
+  "evening",
+];
+
+const CRON_TRIGGER_PATTERNS = [
+  /提醒我/u,
+  /帮我定时/u,
+  /每.+提醒/u,
+  /每天.+发/u,
+  /remind me/iu,
+  /set (a )?reminder/iu,
+  /every .+ remind/iu,
+  /every day .+ (send|post|notify)/iu,
+  /schedule .+ (reminder|message|notification)/iu,
+];
+
+const CRON_EXCLUDE_PATTERNS = [
+  /是什么意思/u,
+  /区别/u,
+  /为什么/u,
+  /\bhelp\b/iu,
+  /文档/u,
+  /怎么用/u,
+  /what does|what's|meaning of/iu,
+  /difference/iu,
+  /why/iu,
+  /\bdocs?\b/iu,
+  /documentation/iu,
+  /how to/iu,
+  /usage/iu,
+];
+
+export function shouldInjectCronHiddenPrompt(text: string): boolean {
+  const normalized = text.trim();
+  if (!normalized) return false;
+  const lowered = normalized.toLowerCase();
+
+  for (const pattern of CRON_EXCLUDE_PATTERNS) {
+    if (pattern.test(lowered)) return false;
+  }
+
+  for (const keyword of CRON_TRIGGER_KEYWORDS) {
+    if (lowered.includes(keyword.toLowerCase())) return true;
+  }
+
+  return CRON_TRIGGER_PATTERNS.some((pattern) => pattern.test(normalized));
+}
+
+export function splitCronHiddenPrompt(text: string): { base: string; prompt?: string } {
+  const idx = text.indexOf(CRON_HIDDEN_PROMPT);
+  if (idx === -1) {
+    return { base: text };
+  }
+  const base = text.slice(0, idx).trimEnd();
+  return { base, prompt: CRON_HIDDEN_PROMPT };
+}
+
+export function appendCronHiddenPrompt(text: string): string {
+  if (!shouldInjectCronHiddenPrompt(text)) return text;
+  if (text.includes(CRON_HIDDEN_PROMPT)) return text;
+  return `${text}\n\n${CRON_HIDDEN_PROMPT}`;
+}
+
+export function applyCronHiddenPromptToContext<
+  T extends { Body?: string; RawBody?: string; CommandBody?: string }
+>(ctx: T): boolean {
+  const base =
+    (typeof ctx.RawBody === "string" && ctx.RawBody) ||
+    (typeof ctx.Body === "string" && ctx.Body) ||
+    (typeof ctx.CommandBody === "string" && ctx.CommandBody) ||
+    "";
+
+  if (!base) return false;
+
+  const next = appendCronHiddenPrompt(base);
+  if (next === base) return false;
+
+  ctx.CommandBody = next;
+  return true;
+}
+
+export { CRON_HIDDEN_PROMPT };

package/src/index.ts

@@ -5,5 +5,6 @@ export * from "./logger/index.js";
 export * from "./policy/index.js";
 export * from "./http/index.js";
 export * from "./types/common.js";
-export * from "./file/index.js";
-export * from "./media/index.js";
+export * from "./file/index.js";
+export * from "./media/index.js";
+export * from "./cron/index.js";

package/src/media/media-parser.ts

@@ -63,20 +63,20 @@ export interface MediaParseResult {
 /**
  * 媒体解析选项
  */
-export interface MediaParseOptions {
-  /** 是否从文本中移除媒体标记，默认 true */
-  removeFromText?: boolean;
-  /** 是否检查本地文件存在性，默认 false */
-  checkExists?: boolean;
-  /** 文件存在性检查函数（用于依赖注入） */
-  existsSync?: (path: string) => boolean;
-  /** 是否解析行首 MEDIA: 指令，默认 false */
-  parseMediaLines?: boolean;
-  /** 是否解析 Markdown 图片，默认 true */
-  parseMarkdownImages?: boolean;
-  /** 是否解析 HTML img 标签，默认 true */
-  parseHtmlImages?: boolean;
-  /** 是否解析裸露的本地路径，默认 true */
+export interface MediaParseOptions {
+  /** 是否从文本中移除媒体标记，默认 true */
+  removeFromText?: boolean;
+  /** 是否检查本地文件存在性，默认 false */
+  checkExists?: boolean;
+  /** 文件存在性检查函数（用于依赖注入） */
+  existsSync?: (path: string) => boolean;
+  /** 是否解析行首 MEDIA: 指令，默认 false */
+  parseMediaLines?: boolean;
+  /** 是否解析 Markdown 图片，默认 true */
+  parseMarkdownImages?: boolean;
+  /** 是否解析 HTML img 标签，默认 true */
+  parseHtmlImages?: boolean;
+  /** 是否解析裸露的本地路径，默认 true */
   parseBarePaths?: boolean;
   /** 是否解析 Markdown 链接中的文件，默认 true */
   parseMarkdownLinks?: boolean;
@@ -195,7 +195,7 @@ const HTML_IMAGE_RE =
 /**
  * Markdown 链接语法: [label](path)
  */
-const MARKDOWN_LINK_RE = /\[([^\]]*)\]\(([^)]+)\)/g;
+const MARKDOWN_LINK_RE = /\[([^\]]*)\]\(([^)]+)\)/g;
 
 /**
  * 本地图片路径（裸露的，非 Markdown 格式）
@@ -212,33 +212,33 @@ const NON_IMAGE_EXT_PATTERN = Array.from(NON_IMAGE_EXTENSIONS).join("|");
 const WINDOWS_PATH_SEP = String.raw`(?:\\\\|\\)`;
 const WINDOWS_FILE_PATH = String.raw`[A-Za-z]:${WINDOWS_PATH_SEP}(?:[^\\/:*?"<>|\r\n]+${WINDOWS_PATH_SEP})*[^\\/:*?"<>|\r\n]+`;
 const UNIX_FILE_PATH = String.raw`\/(?:tmp|var|private|Users|home|root)\/[^\s'",)]+`;
-const BARE_FILE_PATH_RE = new RegExp(
-  String.raw`\`?((?:${UNIX_FILE_PATH}|${WINDOWS_FILE_PATH})\.(?:${NON_IMAGE_EXT_PATTERN}))\`?`,
-  "gi"
-);
-
-// MEDIA: 行解析辅助
-const MEDIA_LINE_PREFIX = "MEDIA:";
-
-function unwrapMediaLinePayload(value: string): string | undefined {
-  const trimmed = value.trim();
-  if (trimmed.length < 2) return undefined;
-  const first = trimmed[0];
-  const last = trimmed[trimmed.length - 1];
-  if (first !== last) return undefined;
-  if (first !== `"` && first !== "'" && first !== "`") return undefined;
-  return trimmed.slice(1, -1).trim();
-}
-
-function cleanMediaLineCandidate(value: string): string {
-  return value.replace(/^[`"'[{(<]+/, "").replace(/[`"'\])}>.,;]+$/, "");
-}
-
-function splitMediaLineCandidates(payload: string): string[] {
-  const unwrapped = unwrapMediaLinePayload(payload);
-  if (unwrapped) return [unwrapped];
-  return payload.split(/\s+/).filter(Boolean);
-}
+const BARE_FILE_PATH_RE = new RegExp(
+  String.raw`\`?((?:${UNIX_FILE_PATH}|${WINDOWS_FILE_PATH})\.(?:${NON_IMAGE_EXT_PATTERN}))\`?`,
+  "gi"
+);
+
+// MEDIA: 行解析辅助
+const MEDIA_LINE_PREFIX = "MEDIA:";
+
+function unwrapMediaLinePayload(value: string): string | undefined {
+  const trimmed = value.trim();
+  if (trimmed.length < 2) return undefined;
+  const first = trimmed[0];
+  const last = trimmed[trimmed.length - 1];
+  if (first !== last) return undefined;
+  if (first !== `"` && first !== "'" && first !== "`") return undefined;
+  return trimmed.slice(1, -1).trim();
+}
+
+function cleanMediaLineCandidate(value: string): string {
+  return value.replace(/^[`"'[{(<]+/, "").replace(/[`"'\])}>.,;]+$/, "");
+}
+
+function splitMediaLineCandidates(payload: string): string[] {
+  const unwrapped = unwrapMediaLinePayload(payload);
+  if (unwrapped) return [unwrapped];
+  return payload.split(/\s+/).filter(Boolean);
+}
 
 // ============================================================================
 // 路径处理函数
@@ -421,28 +421,28 @@ function createExtractedMedia(
  * @param options - 解析选项
  * @returns 解析结果，包含清理后的文本和提取的媒体列表
  */
-export function extractMediaFromText(
-  text: string,
-  options: MediaParseOptions = {}
-): MediaParseResult {
-  const {
-    removeFromText = true,
-    checkExists = false,
-    existsSync,
-    parseMediaLines = false,
-    parseMarkdownImages = true,
-    parseHtmlImages = true,
-    parseBarePaths = true,
-    parseMarkdownLinks = true,
-  } = options;
+export function extractMediaFromText(
+  text: string,
+  options: MediaParseOptions = {}
+): MediaParseResult {
+  const {
+    removeFromText = true,
+    checkExists = false,
+    existsSync,
+    parseMediaLines = false,
+    parseMarkdownImages = true,
+    parseHtmlImages = true,
+    parseBarePaths = true,
+    parseMarkdownLinks = true,
+  } = options;
 
   const images: ExtractedMedia[] = [];
   const files: ExtractedMedia[] = [];
   const seenSources = new Set<string>();
   let result = text;
 
-  // 辅助函数：添加媒体项（去重）
-  const addMedia = (media: ExtractedMedia): boolean => {
+  // 辅助函数：添加媒体项（去重）
+  const addMedia = (media: ExtractedMedia): boolean => {
     const key = media.localPath || media.source;
     if (seenSources.has(key)) return false;
 
@@ -461,53 +461,53 @@ export function extractMediaFromText(
     } else {
       files.push(media);
     }
-    return true;
-  };
-
-  // 0. 解析行首 MEDIA: 指令
-  if (parseMediaLines) {
-    const lines = result.split("\n");
-    const keptLines: string[] = [];
-    for (const line of lines) {
-      const trimmedStart = line.trimStart();
-      if (!trimmedStart.startsWith(MEDIA_LINE_PREFIX)) {
-        keptLines.push(line);
-        continue;
-      }
-
-      const payload = trimmedStart.slice(MEDIA_LINE_PREFIX.length).trim();
-      if (!payload) {
-        keptLines.push(line);
-        continue;
-      }
-
-      const candidates = splitMediaLineCandidates(payload);
-      let addedAny = false;
-      for (const raw of candidates) {
-        const candidate = stripTitleFromUrl(cleanMediaLineCandidate(raw));
-        if (!candidate) continue;
-        if (!isHttpUrl(candidate) && !isLocalReference(candidate)) {
-          continue;
-        }
-        const media = createExtractedMedia(candidate, "bare", options);
-        if (addMedia(media)) {
-          addedAny = true;
-        }
-      }
-
-      if (!addedAny || !removeFromText) {
-        keptLines.push(line);
-      }
-    }
-
-    if (removeFromText) {
-      result = keptLines.join("\n");
-    }
-  }
-
-  // 收集需要替换的位置（用于安全替换）
-  type Replacement = { start: number; end: number; replacement: string };
-  const replacements: Replacement[] = [];
+    return true;
+  };
+
+  // 0. 解析行首 MEDIA: 指令
+  if (parseMediaLines) {
+    const lines = result.split("\n");
+    const keptLines: string[] = [];
+    for (const line of lines) {
+      const trimmedStart = line.trimStart();
+      if (!trimmedStart.startsWith(MEDIA_LINE_PREFIX)) {
+        keptLines.push(line);
+        continue;
+      }
+
+      const payload = trimmedStart.slice(MEDIA_LINE_PREFIX.length).trim();
+      if (!payload) {
+        keptLines.push(line);
+        continue;
+      }
+
+      const candidates = splitMediaLineCandidates(payload);
+      let addedAny = false;
+      for (const raw of candidates) {
+        const candidate = stripTitleFromUrl(cleanMediaLineCandidate(raw));
+        if (!candidate) continue;
+        if (!isHttpUrl(candidate) && !isLocalReference(candidate)) {
+          continue;
+        }
+        const media = createExtractedMedia(candidate, "bare", options);
+        if (addMedia(media)) {
+          addedAny = true;
+        }
+      }
+
+      if (!addedAny || !removeFromText) {
+        keptLines.push(line);
+      }
+    }
+
+    if (removeFromText) {
+      result = keptLines.join("\n");
+    }
+  }
+
+  // 收集需要替换的位置（用于安全替换）
+  type Replacement = { start: number; end: number; replacement: string };
+  const replacements: Replacement[] = [];
 
   // 辅助函数：应用替换（从后向前，避免索引错位）
   const applyReplacements = (): void => {