chatlab-cli 0.24.1 → 0.25.0

package/dist/{chunk-N5DGZQB4.mjs → chunk-4OMV4VNH.mjs}

@@ -4410,6 +4410,218 @@ function isNewerStableVersion(latest, current) {
   return currentVersion.prerelease;
 }
 
+// ../../packages/core/src/chart/index.ts
+var ChartValidationError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ChartValidationError";
+  }
+};
+var CHART_TYPES = /* @__PURE__ */ new Set(["bar", "line", "pie", "heatmap"]);
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function asFieldName(value, label) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new ChartValidationError(`${label} must be a non-empty field name`);
+  }
+  return value;
+}
+function assertFieldExists(rows, field) {
+  if (rows.length === 0) return;
+  if (!Object.prototype.hasOwnProperty.call(rows[0], field)) {
+    throw new ChartValidationError(`Field "${field}" does not exist in SQL result`);
+  }
+}
+function toLabel(value) {
+  if (value === null || value === void 0 || value === "") return "(empty)";
+  return String(value);
+}
+function toNumber(value, field) {
+  const num = typeof value === "number" ? value : Number(value);
+  if (!Number.isFinite(num)) {
+    throw new ChartValidationError(`Field "${field}" contains non-numeric value "${String(value)}"`);
+  }
+  return num;
+}
+function inferFieldType(values) {
+  const present = values.filter((v) => v !== null && v !== void 0);
+  if (present.length === 0) return "string";
+  if (present.every((v) => typeof v === "number" && Number.isInteger(v))) return "integer";
+  if (present.every(
+    (v) => typeof v === "number" || typeof v === "string" && v.trim() !== "" && !Number.isNaN(Number(v))
+  )) {
+    return "number";
+  }
+  if (present.every((v) => typeof v === "boolean")) return "boolean";
+  return "category";
+}
+function normalizeChartSpec(raw) {
+  if (!isRecord(raw)) throw new ChartValidationError("chartSpec must be an object");
+  if (raw.version !== 1) throw new ChartValidationError("chartSpec.version must be 1");
+  if (typeof raw.type !== "string" || !CHART_TYPES.has(raw.type)) {
+    throw new ChartValidationError("chartSpec.type must be one of: bar, line, pie, heatmap");
+  }
+  if (typeof raw.title !== "string" || raw.title.trim().length === 0) {
+    throw new ChartValidationError("chartSpec.title must be a non-empty string");
+  }
+  if (!isRecord(raw.encoding)) throw new ChartValidationError("chartSpec.encoding must be an object");
+  const spec = raw;
+  switch (spec.type) {
+    case "bar":
+    case "line":
+      asFieldName(spec.encoding.x, "encoding.x");
+      asFieldName(spec.encoding.y, "encoding.y");
+      break;
+    case "pie":
+      asFieldName(spec.encoding.label, "encoding.label");
+      asFieldName(spec.encoding.value, "encoding.value");
+      break;
+    case "heatmap":
+      asFieldName(spec.encoding.x, "encoding.x");
+      asFieldName(spec.encoding.y, "encoding.y");
+      asFieldName(spec.encoding.value, "encoding.value");
+      break;
+  }
+  return {
+    ...spec,
+    title: spec.title.trim()
+  };
+}
+function inferChartDataset(rows, declaredFields) {
+  const declared = new Map((declaredFields ?? []).map((field) => [field.name, field]));
+  const columnNames = rows.length > 0 ? Object.keys(rows[0]) : [...declared.keys()];
+  const columns = columnNames.map((name) => {
+    const declaredField = declared.get(name);
+    if (declaredField) return declaredField;
+    return {
+      name,
+      type: inferFieldType(rows.map((row) => row[name]))
+    };
+  });
+  return { columns, rows };
+}
+function aggregateByLabel(rows, labelField, valueField) {
+  const labels = [];
+  const indexByLabel = /* @__PURE__ */ new Map();
+  const values = [];
+  for (const row of rows) {
+    const label = toLabel(row[labelField]);
+    let index = indexByLabel.get(label);
+    if (index === void 0) {
+      index = labels.length;
+      indexByLabel.set(label, index);
+      labels.push(label);
+      values.push(0);
+    }
+    values[index] += toNumber(row[valueField], valueField);
+  }
+  return { labels, values };
+}
+function buildLineData(rows, spec) {
+  const xField = spec.encoding.x;
+  const yField = spec.encoding.y;
+  const seriesField = spec.encoding.series;
+  if (!seriesField) return aggregateByLabel(rows, xField, yField);
+  assertFieldExists(rows, seriesField);
+  const labels = [];
+  const labelIndex = /* @__PURE__ */ new Map();
+  const seriesNames = [];
+  const seriesIndex = /* @__PURE__ */ new Map();
+  const matrix = [];
+  for (const row of rows) {
+    const label = toLabel(row[xField]);
+    const seriesName = toLabel(row[seriesField]);
+    let xIndex = labelIndex.get(label);
+    if (xIndex === void 0) {
+      xIndex = labels.length;
+      labelIndex.set(label, xIndex);
+      labels.push(label);
+      for (const values of matrix) values.push(0);
+    }
+    let sIndex = seriesIndex.get(seriesName);
+    if (sIndex === void 0) {
+      sIndex = seriesNames.length;
+      seriesIndex.set(seriesName, sIndex);
+      seriesNames.push(seriesName);
+      matrix.push(Array(labels.length).fill(0));
+    }
+    matrix[sIndex][xIndex] += toNumber(row[yField], yField);
+  }
+  const series = seriesNames.map((name, index) => ({ name, values: matrix[index] }));
+  return {
+    labels,
+    values: series[0]?.values ?? [],
+    series
+  };
+}
+function buildHeatmapData(rows, spec) {
+  const xField = spec.encoding.x;
+  const yField = spec.encoding.y;
+  const valueField = spec.encoding.value;
+  const xLabels = [];
+  const yLabels = [];
+  const xIndex = /* @__PURE__ */ new Map();
+  const yIndex = /* @__PURE__ */ new Map();
+  const values = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    const xLabel = toLabel(row[xField]);
+    const yLabel = toLabel(row[yField]);
+    let xi = xIndex.get(xLabel);
+    if (xi === void 0) {
+      xi = xLabels.length;
+      xIndex.set(xLabel, xi);
+      xLabels.push(xLabel);
+    }
+    let yi = yIndex.get(yLabel);
+    if (yi === void 0) {
+      yi = yLabels.length;
+      yIndex.set(yLabel, yi);
+      yLabels.push(yLabel);
+    }
+    const key = `${xi}:${yi}`;
+    values.set(key, (values.get(key) ?? 0) + toNumber(row[valueField], valueField));
+  }
+  const data = [];
+  for (const [key, value] of values.entries()) {
+    const [x, y] = key.split(":").map(Number);
+    data.push([x, y, value]);
+  }
+  return { xLabels, yLabels, data };
+}
+function buildChartPayload(rows, rawSpec, options) {
+  const spec = normalizeChartSpec(rawSpec);
+  const dataset = inferChartDataset(rows, spec.fields);
+  const requiredFields = /* @__PURE__ */ new Set();
+  for (const field of Object.values(spec.encoding)) {
+    if (typeof field === "string" && field) requiredFields.add(field);
+  }
+  for (const field of requiredFields) assertFieldExists(rows, field);
+  let data;
+  switch (spec.type) {
+    case "bar":
+      data = aggregateByLabel(rows, spec.encoding.x, spec.encoding.y);
+      break;
+    case "line":
+      data = buildLineData(rows, spec);
+      break;
+    case "pie":
+      data = aggregateByLabel(rows, spec.encoding.label, spec.encoding.value);
+      break;
+    case "heatmap":
+      data = buildHeatmapData(rows, spec);
+      break;
+  }
+  return {
+    version: 1,
+    spec,
+    dataset,
+    data,
+    rowCount: rows.length,
+    truncated: options?.truncated
+  };
+}
+
 // ../../packages/core/src/nlp/pos-tags.ts
 var POS_TAG_DEFINITIONS = [
   { tag: "n", name: "\u540D\u8BCD", description: "\u666E\u901A\u540D\u8BCD", meaningful: true },
@@ -5248,6 +5460,7 @@ var BUILTIN_TOOL_CATALOG = [
   { name: "search_sessions", category: "core" },
   { name: "get_session_messages", category: "core" },
   { name: "get_members", category: "core" },
+  { name: "get_schema", category: "core" },
   // Analysis 工具
   { name: "get_member_stats", category: "analysis" },
   { name: "get_time_stats", category: "analysis" },
@@ -5256,6 +5469,8 @@ var BUILTIN_TOOL_CATALOG = [
   { name: "get_session_summaries", category: "analysis" },
   { name: "response_time_analysis", category: "analysis" },
   { name: "keyword_frequency", category: "analysis" },
+  { name: "render_chart", category: "analysis" },
+  { name: "execute_sql", category: "analysis" },
   // SQL Analysis 工具
   { name: "message_type_breakdown", category: "analysis" },
   { name: "peak_chat_hours_by_member", category: "analysis" },
@@ -5270,6 +5485,9 @@ var BUILTIN_TOOL_CATALOG = [
   { name: "unanswered_messages", category: "analysis" }
 ];
 
+// ../../packages/core/src/ai/chart-capability.ts
+var CHART_CAPABILITY_SKILL_ID = "chart_runtime";
+
 // ../../packages/core/src/ai/provider-registry.ts
 var OPENAI = {
   id: "openai",
@@ -13394,93 +13612,43 @@ function countMessagesTokens(messages, systemPrompt) {
 // ../../packages/node-runtime/src/ai/skill-manager.ts
 import * as fs30 from "fs";
 import * as path27 from "path";
-var SKILLS_DIR_NAME = "skills";
+
+// ../../packages/node-runtime/src/ai/skill-menu.ts
 var MAX_SKILL_MENU_ITEMS = 15;
-var defaultLogger2 = {
-  info: () => {
-  },
-  warn: () => {
-  }
-};
-var SkillManager = class {
-  skills = /* @__PURE__ */ new Map();
-  initialized = false;
-  skillsDir;
-  logger;
-  constructor(aiDataDir, logger) {
-    this.skillsDir = path27.join(aiDataDir, SKILLS_DIR_NAME);
-    this.logger = logger ?? defaultLogger2;
-  }
-  init() {
-    this.loadAll();
-    this.initialized = true;
-    this.logger.info(`SkillManager initialized: ${this.skills.size} skills`);
-    return { total: this.skills.size };
-  }
-  getSkillConfig(id) {
-    this.ensureInitialized();
-    return this.skills.get(id) ?? null;
-  }
-  getAllSkills() {
-    this.ensureInitialized();
-    return Array.from(this.skills.values()).map((def) => ({
-      id: def.id,
-      name: def.name,
-      description: def.description,
-      tags: def.tags,
-      chatScope: def.chatScope,
-      tools: def.tools,
-      builtinId: def.builtinId
-    }));
-  }
-  /**
-   * 构建 AI 自选技能菜单文本
-   * 只包含与当前 chatType + 助手工具权限兼容的技能
-   */
-  getSkillMenu(chatType, allowedTools) {
-    this.ensureInitialized();
-    const compatible = Array.from(this.skills.values()).filter((skill) => {
-      if (skill.chatScope !== "all" && skill.chatScope !== chatType) return false;
-      if (skill.tools.length > 0 && allowedTools && allowedTools.length > 0) {
-        const allCovered = skill.tools.every((t2) => allowedTools.includes(t2));
-        if (!allCovered) return false;
-      }
-      return true;
-    });
-    if (compatible.length === 0) return null;
-    const items = compatible.slice(0, MAX_SKILL_MENU_ITEMS);
-    const lines = items.map((s) => `- ${s.id}: ${s.name} \u2014 ${s.description}`);
-    return `## \u53EF\u7528\u6280\u80FD
+var SKILL_MENU_HEADER = `## \u53EF\u7528\u6280\u80FD
 \u4EE5\u4E0B\u662F\u4F60\u53EF\u4EE5\u4F7F\u7528\u7684\u5206\u6790\u6280\u80FD\u3002\u5F53\u4F60\u5224\u65AD\u7528\u6237\u7684\u95EE\u9898\u9002\u5408\u4F7F\u7528\u67D0\u4E2A\u6280\u80FD\u65F6\uFF0C
-\u8BF7\u8C03\u7528 activate_skill \u5DE5\u5177\u6FC0\u6D3B\u5B83\uFF0C\u7136\u540E\u6309\u7167\u8FD4\u56DE\u7684\u6307\u5BFC\u5B8C\u6210\u4EFB\u52A1\u3002
+\u8BF7\u8C03\u7528 activate_skill \u5DE5\u5177\u6FC0\u6D3B\u5B83\uFF0C\u7136\u540E\u6309\u7167\u8FD4\u56DE\u7684\u6307\u5BFC\u5B8C\u6210\u4EFB\u52A1\u3002`;
+var SKILL_MENU_CLOSING = "\u5982\u679C\u7528\u6237\u7684\u95EE\u9898\u4E0D\u9700\u8981\u4F7F\u7528\u6280\u80FD\uFF0C\u76F4\u63A5\u56DE\u7B54\u5373\u53EF\u3002";
+var SKILL_MENU_CLOSING_BLOCK = `
 
-${lines.join("\n")}
+${SKILL_MENU_CLOSING}`;
+function formatSkillMenuLine(item) {
+  const guidanceSuffix = item.guidance ? `. ${item.guidance}` : "";
+  return `- ${item.id}: ${item.name} \u2014 ${item.description}${guidanceSuffix}`;
+}
+function buildSkillMenuText(lines) {
+  const visibleLines = normalizeSkillMenuLines(lines);
+  if (visibleLines.length === 0) return null;
+  return `${SKILL_MENU_HEADER}
 
-\u5982\u679C\u7528\u6237\u7684\u95EE\u9898\u4E0D\u9700\u8981\u4F7F\u7528\u6280\u80FD\uFF0C\u76F4\u63A5\u56DE\u7B54\u5373\u53EF\u3002`;
-  }
-  ensureInitialized() {
-    if (!this.initialized) {
-      this.init();
-    }
-  }
-  loadAll() {
-    this.skills.clear();
-    if (!fs30.existsSync(this.skillsDir)) return;
-    const files = fs30.readdirSync(this.skillsDir).filter((f) => f.endsWith(".md"));
-    for (const file of files) {
-      try {
-        const filePath = path27.join(this.skillsDir, file);
-        const content = fs30.readFileSync(filePath, "utf-8");
-        const def = parseSkillFile(content, filePath);
-        if (def) {
-          this.skills.set(def.id, def);
-        }
-      } catch (error) {
-        this.logger.warn(`Failed to load skill: ${file}`, { error: String(error) });
-      }
-    }
+${visibleLines.join("\n")}
+
+${SKILL_MENU_CLOSING}`;
+}
+function appendSkillMenuLines(baseMenu, lines) {
+  const visibleLines = normalizeSkillMenuLines(lines);
+  if (visibleLines.length === 0) return baseMenu ?? null;
+  if (!baseMenu) return buildSkillMenuText(visibleLines);
+  const insertion = `
+${visibleLines.join("\n")}`;
+  if (!baseMenu.includes(SKILL_MENU_CLOSING_BLOCK)) {
+    return `${baseMenu}${insertion}`;
   }
-};
+  return baseMenu.replace(SKILL_MENU_CLOSING_BLOCK, `${insertion}${SKILL_MENU_CLOSING_BLOCK}`);
+}
+function normalizeSkillMenuLines(lines) {
+  return lines.map((line) => line.trim()).filter(Boolean);
+}
 
 // ../../packages/node-runtime/src/ai/skill-manager-core.ts
 function toSummary2(def) {
@@ -13511,7 +13679,6 @@ function simpleHash(content) {
   }
   return hash.toString(36);
 }
-var MAX_SKILL_MENU_ITEMS2 = 15;
 var SkillManagerCore = class {
   deps;
   builtinDefs = /* @__PURE__ */ new Map();
@@ -13665,21 +13832,14 @@ var SkillManagerCore = class {
     this.ensureInitialized();
     const compatible = Array.from(this.cache.values()).filter((skill) => {
       if (skill.chatScope !== "all" && skill.chatScope !== chatType) return false;
-      if (skill.tools.length > 0 && allowedTools && allowedTools.length > 0) {
+      if (skill.tools.length > 0 && allowedTools !== void 0) {
         if (!skill.tools.every((t2) => allowedTools.includes(t2))) return false;
       }
       return true;
     });
     if (compatible.length === 0) return null;
-    const items = compatible.slice(0, MAX_SKILL_MENU_ITEMS2);
-    const lines = items.map((s) => `- ${s.id}: ${s.name} \u2014 ${s.description}`);
-    return `## \u53EF\u7528\u6280\u80FD
-\u4EE5\u4E0B\u662F\u4F60\u53EF\u4EE5\u4F7F\u7528\u7684\u5206\u6790\u6280\u80FD\u3002\u5F53\u4F60\u5224\u65AD\u7528\u6237\u7684\u95EE\u9898\u9002\u5408\u4F7F\u7528\u67D0\u4E2A\u6280\u80FD\u65F6\uFF0C
-\u8BF7\u8C03\u7528 activate_skill \u5DE5\u5177\u6FC0\u6D3B\u5B83\uFF0C\u7136\u540E\u6309\u7167\u8FD4\u56DE\u7684\u6307\u5BFC\u5B8C\u6210\u4EFB\u52A1\u3002
-
-${lines.join("\n")}
-
-\u5982\u679C\u7528\u6237\u7684\u95EE\u9898\u4E0D\u9700\u8981\u4F7F\u7528\u6280\u80FD\uFF0C\u76F4\u63A5\u56DE\u7B54\u5373\u53EF\u3002`;
+    const items = compatible.slice(0, MAX_SKILL_MENU_ITEMS);
+    return buildSkillMenuText(items.map(formatSkillMenuLine));
   }
   // ==================== Internal ====================
   findByBuiltinId(builtinId) {
@@ -13709,6 +13869,80 @@ ${lines.join("\n")}
   }
 };
 
+// ../../packages/node-runtime/src/ai/skill-manager.ts
+var SKILLS_DIR_NAME = "skills";
+var defaultLogger2 = {
+  info: () => {
+  },
+  warn: () => {
+  }
+};
+var nodeFs = {
+  ensureDir(dir) {
+    fs30.mkdirSync(dir, { recursive: true });
+  },
+  listFiles(dir, ext) {
+    if (!fs30.existsSync(dir)) return [];
+    return fs30.readdirSync(dir).filter((file) => file.endsWith(ext));
+  },
+  readFile(filePath) {
+    return fs30.readFileSync(filePath, "utf-8");
+  },
+  writeFile(filePath, content) {
+    fs30.writeFileSync(filePath, content, "utf-8");
+  },
+  deleteFile(filePath) {
+    fs30.unlinkSync(filePath);
+  },
+  fileExists(filePath) {
+    return fs30.existsSync(filePath);
+  },
+  joinPath(...parts) {
+    return path27.join(...parts);
+  }
+};
+var SkillManager = class {
+  core;
+  logger;
+  constructor(aiDataDir, logger) {
+    this.logger = logger ?? defaultLogger2;
+    this.core = new SkillManagerCore({
+      fs: nodeFs,
+      skillsDir: path27.join(aiDataDir, SKILLS_DIR_NAME),
+      builtinRawSkills: [],
+      logger: {
+        info: () => {
+        },
+        warn: (_category, message, data) => this.logger.warn(message, toLoggerExtra(data)),
+        error: (_category, message, data) => this.logger.warn(message, toLoggerExtra(data))
+      }
+    });
+  }
+  init() {
+    const result = this.core.init();
+    this.logger.info(`SkillManager initialized: ${result.total} skills`);
+    return result;
+  }
+  getSkillConfig(id) {
+    return this.core.getSkillConfig(id);
+  }
+  getAllSkills() {
+    return this.core.getAllSkills();
+  }
+  /**
+   * 构建 AI 自选技能菜单文本
+   * 只包含与当前 chatType + 助手工具权限兼容的技能
+   */
+  getSkillMenu(chatType, allowedTools) {
+    return this.core.getSkillMenu(chatType, allowedTools);
+  }
+};
+function toLoggerExtra(data) {
+  if (data === void 0) return void 0;
+  if (data && typeof data === "object" && !Array.isArray(data)) return data;
+  return { data };
+}
+
 // ../../packages/node-runtime/src/ai/activate-skill-tool.ts
 function createActivateSkillTool(options) {
   const { chatType, allowedTools, coreToolNames, getSkillConfig, locale = "zh-CN" } = options;
@@ -13744,7 +13978,7 @@ function createActivateSkillTool(options) {
           details: { skillId, found: true, applicable: false }
         };
       }
-      if (skill.tools.length > 0 && allowedTools && allowedTools.length > 0) {
+      if (skill.tools.length > 0 && allowedTools !== void 0) {
         const missing = skill.tools.filter((t2) => !(coreToolNames?.has(t2) ?? false) && !allowedTools.includes(t2));
         if (missing.length > 0) {
           const msg = isZh ? `\u5F53\u524D\u52A9\u624B\u7F3A\u5C11\u8BE5\u6280\u80FD\u6240\u9700\u7684\u5DE5\u5177\uFF1A${missing.join(", ")}` : `Current assistant lacks tools required by this skill: ${missing.join(", ")}`;
@@ -13763,6 +13997,175 @@ function createActivateSkillTool(options) {
   };
 }
 
+// ../../packages/node-runtime/src/ai/chart-runtime.ts
+var CHART_CAPABILITY_CORE_TOOLS = ["get_schema"];
+var CHART_CAPABILITY_ANALYSIS_TOOLS = ["render_chart"];
+var RAW_SQL_TOOL_NAMES = /* @__PURE__ */ new Set(["execute_sql"]);
+function getChartCapabilityAllowedBuiltinTools(allowedTools) {
+  const baseTools = (allowedTools ?? []).filter((toolName) => !RAW_SQL_TOOL_NAMES.has(toolName));
+  return Array.from(/* @__PURE__ */ new Set([...baseTools, ...CHART_CAPABILITY_ANALYSIS_TOOLS]));
+}
+function getAllowedBuiltinToolsForChartAutoSkill(allowedTools) {
+  if (!allowedTools) return void 0;
+  if (allowedTools.length === 0) return [];
+  return Array.from(/* @__PURE__ */ new Set([...allowedTools, ...CHART_CAPABILITY_ANALYSIS_TOOLS]));
+}
+function shouldUseChartCapabilityForMessage(message) {
+  const normalized = message.trim().toLowerCase();
+  if (!normalized) return false;
+  return /(?:画|绘制|生成|做|出|展示).{0,8}(?:图|图表)|(?:图表|可视化|饼图|柱状图|条形图|折线图|热力图|趋势图|占比图|分布图|chart|charts|plot|visuali[sz]e|visuali[sz]ation|pie chart|bar chart|line chart|heatmap)/i.test(
+    normalized
+  );
+}
+function resolveChartRuntimeForRequest(options) {
+  const locale = options.locale ?? "zh-CN";
+  const isExplicitChartSkill = options.skillId === CHART_CAPABILITY_SKILL_ID;
+  const isAutoChartSkill = options.enableAutoDetection === true && !options.skillId && shouldUseChartCapabilityForMessage(options.userMessage ?? "");
+  if (!isExplicitChartSkill && !isAutoChartSkill) {
+    return { isChartCapability: false };
+  }
+  return {
+    isChartCapability: true,
+    skillDef: { ...getChartCapabilitySkill(locale), chatScope: "all" },
+    allowedBuiltinTools: getChartCapabilityAllowedBuiltinTools(options.assistantAllowedTools)
+  };
+}
+function getChartCapabilitySkill(locale = "zh-CN") {
+  const isZh = locale.startsWith("zh");
+  return {
+    id: CHART_CAPABILITY_SKILL_ID,
+    name: isZh ? "\u7ED8\u56FE\u52A9\u624B" : "Chart Assistant",
+    description: isZh ? "\u6309\u672C\u8F6E\u95EE\u9898\u751F\u6210\u7075\u6D3B\u7684\u804A\u5929\u6570\u636E\u56FE\u8868" : "Generate flexible charts for this chat question",
+    tags: [isZh ? "\u56FE\u8868" : "chart"],
+    chatScope: "all",
+    tools: ["render_chart", "get_schema"],
+    prompt: isZh ? ZH_PROMPT : EN_PROMPT,
+    builtinId: CHART_CAPABILITY_SKILL_ID
+  };
+}
+function getChartMenuLine(locale) {
+  const skill = getChartCapabilitySkill(locale);
+  const isZh = locale.startsWith("zh");
+  const guidance = isZh ? "\u7528\u6237\u660E\u786E\u8981\u6C42\u56FE\u8868\u3001\u753B\u56FE\u3001\u5360\u6BD4\u3001\u8D8B\u52BF\u3001\u5206\u5E03\u3001\u997C\u56FE\u3001\u67F1\u72B6\u56FE\u3001\u6298\u7EBF\u56FE\u6216\u70ED\u529B\u56FE\u65F6\u4F18\u5148\u6FC0\u6D3B\uFF1B\u4E0D\u8981\u8F93\u51FA Python/JS \u7ED8\u56FE\u4EE3\u7801" : "Activate first when the user explicitly asks for charts, visualization, ratios, trends, distributions, pie, bar, line, or heatmap charts; do not output Python/JS chart code";
+  return formatSkillMenuLine({
+    id: skill.id,
+    name: skill.name,
+    description: skill.description,
+    guidance
+  });
+}
+function buildSkillMenuWithBuiltinChart(baseMenu, locale = "zh-CN", allowedTools) {
+  if (allowedTools && !allowedTools.includes(CHART_CAPABILITY_ANALYSIS_TOOLS[0])) return baseMenu ?? null;
+  if (baseMenu?.includes(CHART_CAPABILITY_SKILL_ID)) return baseMenu;
+  const chartLine = getChartMenuLine(locale);
+  return appendSkillMenuLines(baseMenu, [chartLine]) ?? "";
+}
+function getSkillConfigWithBuiltinChart(id, locale = "zh-CN", getSkillConfig) {
+  if (id === CHART_CAPABILITY_SKILL_ID) return getChartCapabilitySkill(locale);
+  return getSkillConfig(id);
+}
+var ZH_PROMPT = `\u4F60\u662F ChatLab \u7ED8\u56FE\u52A9\u624B\u3002\u672C\u8F6E\u7528\u6237\u5E0C\u671B\u4F60\u5728\u56DE\u7B54\u91CC\u81EA\u7136\u5D4C\u5165\u4E00\u5F20\u6216\u591A\u5F20\u56FE\u8868\u3002
+
+\u4F60\u5FC5\u987B\u901A\u8FC7 render_chart \u5DE5\u5177\u751F\u6210\u56FE\u8868\u3002\u4E0D\u8981\u8F93\u51FA HTML\u3001JavaScript\u3001SVG\u3001Canvas\u3001ECharts option \u6216\u4EFB\u4F55\u6E32\u67D3\u4EE3\u7801\u3002
+
+\u786C\u6027\u89C4\u5219\uFF1A
+1. \u7B2C\u4E00\u6B21\u5199 SQL \u524D\u5FC5\u987B\u5148\u8C03\u7528 get_schema\u3002\u7981\u6B62\u731C\u6D4B\u8868\u540D\u3001\u5B57\u6BB5\u540D\u6216\u65F6\u95F4\u5B57\u6BB5\u3002
+2. \u201C\u6700\u8FD1\u201D\u201C\u5230\u73B0\u5728\u201D\u201C\u5230\u6700\u8FD1\u201D\u5FC5\u987B\u7528\u6570\u636E\u4E2D\u7684 MAX(ts) \u6216\u7B49\u4EF7\u5B57\u6BB5\u786E\u5B9A\u7ED3\u675F\u65E5\u671F\uFF1B\u4E0D\u8981\u624B\u7B97\u6216\u81C6\u6D4B\u65E5\u671F\u3002
+3. ChatLab \u7684 message.ts \u662F\u79D2\u7EA7 Unix \u65F6\u95F4\u6233\uFF0C\u4F7F\u7528 date(ts, 'unixepoch', 'localtime')\uFF1B\u7981\u6B62\u5199 ts/1000\u3002
+4. \u201C\u6700\u8FD1\u7684 N \u4EBA/\u6210\u5458\u201D\u5FC5\u987B\u5148\u7528\u6570\u636E\u5B9A\u4E49\u5E76\u7B5B\u9009\u51FA N \u4E2A\u6210\u5458\uFF0C\u518D\u53EA\u7EDF\u8BA1\u8FD9\u4E9B\u6210\u5458\u3002
+5. \u6298\u7EBF\u56FE\u6709\u591A\u6761\u7EBF\u65F6\uFF0C\u6BCF\u6761\u7EBF\u5FC5\u987B\u6709\u660E\u786E series \u5B57\u6BB5\u542B\u4E49\uFF1B\u6309\u65E5\u671F\u7EDF\u8BA1\u65F6\u5E94\u8865\u9F50\u65E5\u671F \xD7 series \u7684 0 \u503C\uFF0C\u907F\u514D\u7F3A\u5931\u65E5\u671F\u5BFC\u81F4\u6298\u7EBF\u65AD\u88C2\u6216\u8BEF\u8FDE\u3002
+6. \u5DE5\u5177\u5931\u8D25\u3001SQL \u4FEE\u6B63\u3001schema \u63A2\u7D22\u8FC7\u7A0B\u4E0D\u8981\u5199\u8FDB\u6700\u7EC8\u56DE\u7B54\uFF1B\u6700\u7EC8\u53EA\u4FDD\u7559\u56FE\u8868\u548C\u7B80\u77ED\u7ED3\u8BBA\u3002
+7. \u56FE\u8868\u89E3\u91CA\u53EA\u80FD\u63CF\u8FF0\u6570\u636E\u76F4\u63A5\u652F\u6301\u7684\u8D8B\u52BF\u3001\u5CF0\u503C\u3001\u4F4E\u8C37\u3001\u5DEE\u5F02\u548C\u540C\u6B65\u6027\uFF0C\u7981\u6B62\u5938\u5F20\u62DF\u4EBA\u5316\u6216\u65E0\u6CD5\u4ECE\u56FE\u4E2D\u9A8C\u8BC1\u7684\u5173\u7CFB\u5224\u65AD\u3002
+
+\u5DE5\u4F5C\u6D41\u7A0B\uFF1A
+1. \u8C03\u7528 get_schema\u3002
+2. \u6839\u636E schema \u548C\u7528\u6237\u8981\u6C42\u786E\u5B9A\u7EDF\u8BA1\u5BF9\u8C61\u3001\u65F6\u95F4\u8303\u56F4\u3001\u7EF4\u5EA6\u3001\u6307\u6807\u548C\u56FE\u8868\u7C7B\u578B\u3002
+3. \u5FC5\u8981\u65F6\u7528\u53EA\u8BFB SQL \u5728 render_chart \u4E2D\u5B8C\u6210\u6210\u5458\u7B5B\u9009\u3001\u65F6\u95F4\u8303\u56F4\u786E\u8BA4\u3001\u805A\u5408\u548C\u8865\u96F6\u3002
+4. \u8C03\u7528 render_chart\uFF0C\u63D0\u4EA4\u53EA\u8BFB SQL \u548C ChartSpec v1\u3002
+5. \u56FE\u8868\u751F\u6210\u540E\uFF0C\u7528 1-3 \u53E5\u7B80\u6D01\u6587\u5B57\u89E3\u91CA\u7ED3\u8BBA\u3002\u7528\u6237\u8981\u6C42\u591A\u5F20\u56FE\u65F6\uFF0C\u53EF\u4EE5\u591A\u6B21\u8C03\u7528 render_chart\u3002
+
+\u5E38\u7528\u8BED\u3001\u53E3\u5934\u7985\u3001\u9AD8\u9891\u77ED\u53E5\u7C7B\u56FE\u8868\u5FC5\u987B\u6392\u9664\u975E\u771F\u4EBA\u6587\u672C\uFF1A\u53D1\u9001\u8005\u4E3A\u7CFB\u7EDF\u6D88\u606F\u3001\u5A92\u4F53\u5360\u4F4D\uFF08\u5982 [\u8868\u60C5\u5305]\u3001[\u56FE\u7247]\u3001[\u8BED\u97F3]\u3001[\u89C6\u9891]\u3001[\u6587\u4EF6]\u3001[\u94FE\u63A5]\u3001[\u7EA2\u5305]\u3001[\u8F6C\u8D26]\uFF09\u4EE5\u53CA\u64A4\u56DE/\u5220\u9664\u63D0\u793A\u90FD\u4E0D\u80FD\u8FDB\u5165\u7EDF\u8BA1\u3002
+
+ChartSpec v1 \u652F\u6301\uFF1A
+- bar: encoding.x + encoding.y
+- line: encoding.x + encoding.y\uFF0C\u53EF\u9009 encoding.series \u8868\u793A\u6BCF\u6761\u7EBF\u7684\u542B\u4E49
+- pie: encoding.label + encoding.value
+- heatmap: encoding.x + encoding.y + encoding.value
+
+ChartSpec \u793A\u4F8B\uFF1A
+{
+  "version": 1,
+  "type": "line",
+  "title": "\u6700\u8FD1 30 \u5929\u6210\u5458\u53D1\u8A00\u8D8B\u52BF",
+  "encoding": { "x": "day", "y": "msg_count", "series": "member_name" },
+  "unit": "\u6761"
+}
+
+\u7528\u6237\u660E\u786E\u8981\u6C42\u56FE\u8868\u65F6\u5FC5\u987B\u5C1D\u8BD5\u751F\u6210\u3002\u7528\u6237\u6CA1\u6709\u660E\u786E\u8981\u6C42\u65F6\uFF0C\u53EA\u6709\u6392\u540D\u3001\u8D8B\u52BF\u3001\u5206\u5E03\u3001\u5360\u6BD4\u6216\u4E8C\u7EF4\u5BC6\u5EA6\u660E\u663E\u66F4\u6E05\u695A\u65F6\u624D\u4E3B\u52A8\u751F\u6210\uFF0C\u4E14\u9ED8\u8BA4\u6700\u591A\u4E00\u5F20\u3002`;
+var EN_PROMPT = `You are the ChatLab Chart Assistant. In this turn, the user wants one or more charts embedded naturally in the answer.
+
+You must generate charts through the render_chart tool. Do not output HTML, JavaScript, SVG, Canvas, ECharts options, or rendering code.
+
+Hard rules:
+1. Always call get_schema before writing the first SQL query. Do not guess table names, field names, or timestamp fields.
+2. For "latest", "until now", or "through the latest date", derive the end date from MAX(ts) or the equivalent timestamp field in the data. Do not hand-calculate or assume dates.
+3. ChatLab message.ts is a Unix timestamp in seconds. Use date(ts, 'unixepoch', 'localtime'); never write ts/1000.
+4. For "latest N members" or "recent N people", first define and select those N members from the data, then count only those members.
+5. For multi-series line charts, every line must have an explicit series field. For daily counts, fill the date x series grid with zero values so missing days do not break or mislead the line.
+6. Do not include failed SQL attempts, schema exploration, or retry reasoning in the final answer. Final answer should contain only the chart and a short conclusion.
+7. Explain only trends, peaks, lows, differences, and synchrony directly supported by chart data. Do not make exaggerated personality or relationship claims.
+
+Workflow:
+1. Call get_schema.
+2. Derive the target members, time range, dimensions, metrics, and chart type from schema and the user request.
+3. When needed, use read-only SQL inside render_chart to select members, determine time range, aggregate data, and fill zero rows.
+4. Call render_chart with read-only SQL and ChartSpec v1.
+5. After the chart is generated, explain the key finding in 1-3 concise sentences. If the user asks for multiple charts, call render_chart multiple times.
+
+For catchphrase, common phrase, or frequent short-text charts, exclude non-human text from the SQL: system-message senders, media placeholders such as [Sticker], [Image], [Photo], [Voice], [Video], [File], [Link], and recall/deletion notices must not be counted.
+
+ChartSpec v1 supports:
+- bar: encoding.x + encoding.y
+- line: encoding.x + encoding.y, optional encoding.series for the meaning of each line
+- pie: encoding.label + encoding.value
+- heatmap: encoding.x + encoding.y + encoding.value
+
+ChartSpec example:
+{
+  "version": 1,
+  "type": "line",
+  "title": "Member message trend in the last 30 days",
+  "encoding": { "x": "day", "y": "msg_count", "series": "member_name" },
+  "unit": "messages"
+}
+
+When the user explicitly asks for charts, you must try to generate them. If the user does not explicitly ask, add at most one chart only when ranking, trend, distribution, ratio, or two-dimensional density is clearly easier to understand visually.`;
+
+// ../../packages/node-runtime/src/ai/chart-schema-gate.ts
+var CHART_SCHEMA_REQUIRED_MESSAGE = "Error: Call get_schema before render_chart. Do not guess table names, fields, or timestamp units.";
+function createChartSchemaGateState() {
+  return { schemaSeen: false };
+}
+function wrapWithChartSchemaGate(tool, state) {
+  const originalExecute = tool.execute;
+  return {
+    ...tool,
+    execute: async (toolCallId, params, signal, onUpdate) => {
+      if (tool.name === "render_chart" && !state.schemaSeen) {
+        return {
+          content: [{ type: "text", text: CHART_SCHEMA_REQUIRED_MESSAGE }],
+          details: null
+        };
+      }
+      const result = await originalExecute(toolCallId, params, signal, onUpdate);
+      if (tool.name === "get_schema") {
+        state.schemaSeen = true;
+      }
+      return result;
+    }
+  };
+}
+
 // ../../packages/node-runtime/src/ai/compression/compressor.ts
 var DEFAULT_CONTEXT_WINDOW = 128e3;
 var INITIAL_COMPRESSION_PROMPT = `You are a context compression assistant. Compress the conversation below into a structured summary.
@@ -14542,6 +14945,11 @@ import {
   streamSimple as defaultStreamSimple,
   clampThinkingLevel
 } from "@earendil-works/pi-ai";
+
+// ../../packages/node-runtime/src/ai/agent/constants.ts
+var DEFAULT_MAX_TOOL_ROUNDS = 10;
+
+// ../../packages/node-runtime/src/ai/agent/core.ts
 function createEmptyPiUsage() {
   return {
     input: 0,
@@ -14584,7 +14992,7 @@ async function runAgentCore(options) {
     tools,
     history,
     userMessage,
-    maxToolRounds = 5,
+    maxToolRounds = DEFAULT_MAX_TOOL_ROUNDS,
     abortSignal,
     steerMessage = "Please provide your final answer based on the information gathered.",
     onEvent,
@@ -15222,6 +15630,19 @@ var zh_CN_default = {
           days: "\u7EDF\u8BA1\u6700\u8FD1\u591A\u5C11\u5929\u7684\u6570\u636E",
           top_n: "\u8FD4\u56DE\u524D\u591A\u5C11\u4E2A\u5173\u952E\u8BCD"
         }
+      },
+      get_schema: {
+        desc: "\u67E5\u770B\u804A\u5929\u6570\u636E\u5E93\u8868\u7ED3\u6784\u3002\u7ED8\u56FE\u6216\u81EA\u5B9A\u4E49 SQL \u524D\u5E94\u5148\u7528\u5B83\u786E\u8BA4\u8868\u540D\u548C\u5B57\u6BB5\u540D\u3002",
+        params: {}
+      },
+      render_chart: {
+        desc: "\u6839\u636E\u53EA\u8BFB SQL \u548C ChartSpec v1 \u751F\u6210 ChatLab \u539F\u751F\u56FE\u8868\u3002\u652F\u6301 bar\u3001line\u3001pie\u3001heatmap\u3002\u7981\u6B62\u8F93\u51FA HTML\u3001JavaScript\u3001SVG\u3001ECharts option \u6216\u6E32\u67D3\u4EE3\u7801\u3002",
+        params: {
+          sql: "\u53EA\u8BFB SELECT \u6216 WITH SELECT SQL\u3002\u5FC5\u987B\u8FD4\u56DE ChartSpec encoding \u4E2D\u5F15\u7528\u7684\u5B57\u6BB5\u3002",
+          params: "SQL \u547D\u540D\u53C2\u6570\u5BF9\u8C61\uFF1B\u4E0D\u9700\u8981\u53C2\u6570\u65F6\u4F20\u7A7A\u5BF9\u8C61\u3002",
+          chartSpec: "ChartSpec v1\uFF0C\u5305\u542B version\u3001type\u3001title\u3001encoding\u3002",
+          maxRows: "\u56FE\u8868\u67E5\u8BE2\u6700\u5927\u884C\u6570\uFF0C\u9ED8\u8BA4 1000\u3002"
+        }
       }
     },
     agent: {
@@ -15544,6 +15965,19 @@ Returned summaries are brief descriptions of each session, helping quickly locat
           days: "Number of recent days to analyze",
           top_n: "Number of top keywords to return"
         }
+      },
+      get_schema: {
+        desc: "Inspect the chat database schema. Use it before charting or custom SQL when table or field names are uncertain.",
+        params: {}
+      },
+      render_chart: {
+        desc: "Generate a native ChatLab chart from read-only SQL and ChartSpec v1. Supports bar, line, pie, and heatmap. Do not output HTML, JavaScript, SVG, ECharts options, or rendering code.",
+        params: {
+          sql: "Read-only SELECT or WITH SELECT SQL. It must return fields referenced by ChartSpec encoding.",
+          params: "Named SQL parameters. Use an empty object when no parameters are needed.",
+          chartSpec: "ChartSpec v1 with version, type, title, and encoding.",
+          maxRows: "Maximum chart query rows. Default 1000."
+        }
       }
     },
     // ===== AI Agent system prompts =====
@@ -15862,6 +16296,19 @@ var ja_JP_default = {
           days: "\u76F4\u8FD1\u4F55\u65E5\u9593\u306E\u30C7\u30FC\u30BF\u3092\u96C6\u8A08\u3059\u308B\u304B",
           top_n: "\u4E0A\u4F4D\u4F55\u500B\u306E\u30AD\u30FC\u30EF\u30FC\u30C9\u3092\u8FD4\u5374\u3059\u308B\u304B"
         }
+      },
+      get_schema: {
+        desc: "\u30C1\u30E3\u30C3\u30C8\u30C7\u30FC\u30BF\u30D9\u30FC\u30B9\u306E\u30B9\u30AD\u30FC\u30DE\u3092\u78BA\u8A8D\u3057\u307E\u3059\u3002\u30C1\u30E3\u30FC\u30C8\u4F5C\u6210\u3084\u30AB\u30B9\u30BF\u30E0 SQL \u306E\u524D\u306B\u30C6\u30FC\u30D6\u30EB\u540D\u3068\u30D5\u30A3\u30FC\u30EB\u30C9\u540D\u3092\u78BA\u8A8D\u3057\u3066\u304F\u3060\u3055\u3044\u3002",
+        params: {}
+      },
+      render_chart: {
+        desc: "\u8AAD\u307F\u53D6\u308A\u5C02\u7528 SQL \u3068 ChartSpec v1 \u304B\u3089 ChatLab \u30CD\u30A4\u30C6\u30A3\u30D6\u30C1\u30E3\u30FC\u30C8\u3092\u751F\u6210\u3057\u307E\u3059\u3002bar\u3001line\u3001pie\u3001heatmap \u3092\u30B5\u30DD\u30FC\u30C8\u3057\u307E\u3059\u3002HTML\u3001JavaScript\u3001SVG\u3001ECharts option\u3001\u63CF\u753B\u30B3\u30FC\u30C9\u306F\u51FA\u529B\u3057\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002",
+        params: {
+          sql: "\u8AAD\u307F\u53D6\u308A\u5C02\u7528\u306E SELECT \u307E\u305F\u306F WITH SELECT SQL\u3002ChartSpec encoding \u3067\u53C2\u7167\u3059\u308B\u30D5\u30A3\u30FC\u30EB\u30C9\u3092\u8FD4\u3059\u5FC5\u8981\u304C\u3042\u308A\u307E\u3059\u3002",
+          params: "SQL \u306E\u540D\u524D\u4ED8\u304D\u30D1\u30E9\u30E1\u30FC\u30BF\u3002\u4E0D\u8981\u306A\u5834\u5408\u306F\u7A7A\u30AA\u30D6\u30B8\u30A7\u30AF\u30C8\u3092\u6E21\u3057\u307E\u3059\u3002",
+          chartSpec: "version\u3001type\u3001title\u3001encoding \u3092\u542B\u3080 ChartSpec v1\u3002",
+          maxRows: "\u30C1\u30E3\u30FC\u30C8\u30AF\u30A8\u30EA\u306E\u6700\u5927\u884C\u6570\u3002\u30C7\u30D5\u30A9\u30EB\u30C8\u306F 1000\u3002"
+        }
       }
     },
     agent: {
@@ -16181,6 +16628,19 @@ var zh_TW_default = {
           days: "\u7D71\u8A08\u6700\u8FD1\u591A\u5C11\u5929\u7684\u8CC7\u6599",
           top_n: "\u56DE\u50B3\u524D\u591A\u5C11\u500B\u95DC\u9375\u8A5E"
         }
+      },
+      get_schema: {
+        desc: "\u67E5\u770B\u804A\u5929\u8CC7\u6599\u5EAB\u8868\u7D50\u69CB\u3002\u7E6A\u5716\u6216\u81EA\u8A02 SQL \u524D\u61C9\u5148\u7528\u5B83\u78BA\u8A8D\u8868\u540D\u548C\u6B04\u4F4D\u540D\u3002",
+        params: {}
+      },
+      render_chart: {
+        desc: "\u6839\u64DA\u552F\u8B80 SQL \u548C ChartSpec v1 \u751F\u6210 ChatLab \u539F\u751F\u5716\u8868\u3002\u652F\u63F4 bar\u3001line\u3001pie\u3001heatmap\u3002\u7981\u6B62\u8F38\u51FA HTML\u3001JavaScript\u3001SVG\u3001ECharts option \u6216\u6E32\u67D3\u7A0B\u5F0F\u78BC\u3002",
+        params: {
+          sql: "\u552F\u8B80 SELECT \u6216 WITH SELECT SQL\u3002\u5FC5\u9808\u8FD4\u56DE ChartSpec encoding \u4E2D\u5F15\u7528\u7684\u6B04\u4F4D\u3002",
+          params: "SQL \u547D\u540D\u53C3\u6578\u7269\u4EF6\uFF1B\u4E0D\u9700\u8981\u53C3\u6578\u6642\u50B3\u7A7A\u7269\u4EF6\u3002",
+          chartSpec: "ChartSpec v1\uFF0C\u5305\u542B version\u3001type\u3001title\u3001encoding\u3002",
+          maxRows: "\u5716\u8868\u67E5\u8A62\u6700\u5927\u884C\u6578\uFF0C\u9810\u8A2D 1000\u3002"
+        }
       }
     },
     agent: {
@@ -18925,6 +19385,7 @@ export {
   getRelationshipStats,
   getLanguagePreferenceAnalysis,
   isNewerStableVersion,
+  buildChartPayload,
   POS_TAG_DEFINITIONS,
   BUILTIN_TOOL_CATALOG,
   BUILTIN_PROVIDERS,
@@ -18963,14 +19424,23 @@ export {
   AIConversationManager,
   initTokenizer,
   countMessagesTokens,
-  SkillManager,
   SkillManagerCore,
+  SkillManager,
   createActivateSkillTool,
+  CHART_CAPABILITY_CORE_TOOLS,
+  getAllowedBuiltinToolsForChartAutoSkill,
+  resolveChartRuntimeForRequest,
+  getChartCapabilitySkill,
+  buildSkillMenuWithBuiltinChart,
+  getSkillConfigWithBuiltinChart,
+  createChartSchemaGateState,
+  wrapWithChartSchemaGate,
   checkAndCompress,
   createCompressionLlmAdapter,
   getDefaultRulesForLocale,
   mergeRulesForLocale,
   applyPreprocessingPipeline,
+  DEFAULT_MAX_TOOL_ROUNDS,
   runAgentCore,
   AgentEventHandler,
   buildSystemPrompt,
@@ -19005,4 +19475,4 @@ export {
   createDatabaseManagerAdapter,
   MergeSessionCache
 };
-//# sourceMappingURL=chunk-N5DGZQB4.mjs.map
+//# sourceMappingURL=chunk-4OMV4VNH.mjs.map