chatlab-cli 0.25.0 → 0.26.0

package/dist/{chunk-E65ABM3C.mjs → chunk-IRZRIHIT.mjs}

@@ -20,14 +20,14 @@ import {
   getMessageContext,
   getRecentMessages,
   getSearchMessageContext,
-  getSessionMessages,
+  getSegmentMessages,
+  getSegmentSummaries,
   getSessionMeta,
   getSessionOverview,
-  getSessionSummaries,
   getWeekdayActivity,
   searchMessagesLike,
-  searchSessions
-} from "./chunk-4OMV4VNH.mjs";
+  searchSegments
+} from "./chunk-QY67NN65.mjs";
 
 // ../../packages/tools/src/definitions/sql-query.ts
 var inputSchema = {
@@ -81,17 +81,23 @@ var schemaTool = {
 
 // ../../packages/tools/src/definitions/render-chart.ts
 var DEFAULT_MAX_ROWS = 1e3;
+var DEFAULT_PREVIEW_ROWS = 20;
 var RE_SECONDS_TIMESTAMP_DIVIDED_AS_MILLISECONDS = /\b(?:\w+\.)?ts\s*\/\s*1000\b/i;
 var inputSchema2 = {
   type: "object",
   properties: {
+    rows: {
+      type: "array",
+      description: "Pre-fetched data rows to render directly, skipping SQL execution. Pass the data array from a high-level tool result (e.g. the `data` field from get_time_stats, or member activity rows). Prefer this over sql when data is already available. Mutually exclusive with sql.",
+      items: { type: "object" }
+    },
     sql: {
       type: "string",
-      description: "Read-only SELECT or WITH SELECT SQL used to produce chart rows."
+      description: "Read-only SELECT or WITH SELECT SQL used to produce chart rows. Use only when pre-fetched data is unavailable or custom aggregation is required."
     },
     params: {
       type: "object",
-      description: "Named SQL parameters. Use an empty object when no parameters are needed.",
+      description: "Named SQL parameters. Only used when sql is provided.",
       additionalProperties: true,
       default: {}
     },
@@ -108,7 +114,7 @@ var inputSchema2 = {
       maximum: 5e3
     }
   },
-  required: ["sql", "chartSpec"]
+  required: ["chartSpec"]
 };
 function normalizeSql(sql, maxRows) {
   if (typeof sql !== "string" || sql.trim().length === 0) {
@@ -133,6 +139,14 @@ function normalizeParams(raw) {
   if (!raw || typeof raw !== "object" || Array.isArray(raw)) return {};
   return raw;
 }
+function normalizeRows(raw, maxRows) {
+  if (!Array.isArray(raw)) throw new Error("rows must be an array");
+  const items = raw.filter(
+    (item) => typeof item === "object" && item !== null && !Array.isArray(item)
+  );
+  const truncated = items.length > maxRows;
+  return { rows: truncated ? items.slice(0, maxRows) : items, truncated };
+}
 function normalizeMaxRows(raw) {
   const value = typeof raw === "number" ? raw : DEFAULT_MAX_ROWS;
   if (!Number.isFinite(value)) return DEFAULT_MAX_ROWS;
@@ -144,17 +158,40 @@ function summarizeChart(type, title, rowCount, truncated, locale) {
   }
   return `Generated chart "${title}" (${type}, ${rowCount} rows${truncated ? ", truncated" : ""}).`;
 }
+function summarizeChartForModel(type, title, rows, truncated, locale) {
+  const summary = summarizeChart(type, title, rows.length, truncated, locale);
+  const previewRows = rows.slice(0, DEFAULT_PREVIEW_ROWS);
+  if (previewRows.length === 0) return summary;
+  const preview = JSON.stringify(previewRows);
+  if (locale?.startsWith("zh")) {
+    return `${summary}
+\u6570\u636E\u9884\u89C8\uFF08\u524D ${previewRows.length} \u884C\uFF0C\u7528\u4E8E\u5206\u6790\u5CF0\u503C\u3001\u4F4E\u8C37\u548C\u5DEE\u5F02\uFF09\uFF1A${preview}`;
+  }
+  return `${summary}
+Data preview (first ${previewRows.length} rows; use this to identify peaks, lows, and differences): ${preview}`;
+}
 async function handler2(params, context) {
   if (!context.dataProvider) throw new Error("render_chart requires a data provider");
+  const hasSql = typeof params.sql === "string" && params.sql.trim().length > 0;
+  const hasRows = Array.isArray(params.rows);
+  if (!hasSql && !hasRows) throw new Error("render_chart requires either sql or rows");
   const maxRows = normalizeMaxRows(params.maxRows);
-  const sql = normalizeSql(params.sql, maxRows);
-  const sqlParams = normalizeParams(params.params);
-  const fetchedRows = await context.dataProvider.executeParameterizedSql(sql, sqlParams);
-  const truncated = fetchedRows.length > maxRows;
-  const rows = truncated ? fetchedRows.slice(0, maxRows) : fetchedRows;
+  let rows;
+  let truncated;
+  if (hasRows) {
+    const normalized = normalizeRows(params.rows, maxRows);
+    rows = normalized.rows;
+    truncated = normalized.truncated;
+  } else {
+    const sql = normalizeSql(params.sql, maxRows);
+    const sqlParams = normalizeParams(params.params);
+    const fetchedRows = await context.dataProvider.executeParameterizedSql(sql, sqlParams);
+    truncated = fetchedRows.length > maxRows;
+    rows = truncated ? fetchedRows.slice(0, maxRows) : fetchedRows;
+  }
   const chart = buildChartPayload(rows, params.chartSpec, { truncated });
   return {
-    content: summarizeChart(chart.spec.type, chart.spec.title, rows.length, truncated, context.locale),
+    content: summarizeChartForModel(chart.spec.type, chart.spec.title, rows, truncated, context.locale),
     data: {
       rowCount: rows.length,
       truncated,
@@ -166,7 +203,7 @@ async function handler2(params, context) {
 }
 var renderChartTool = {
   name: "render_chart",
-  description: "Generate a native ChatLab chart from read-only SQL plus ChartSpec v1. Use this for flexible bar, line, pie, and heatmap charts. Never output HTML, JavaScript, SVG, ECharts options, or rendering code.",
+  description: "Generate a native ChatLab chart from ChartSpec v1. Provide either `rows` (pre-fetched data array from a tool result such as get_time_stats or member_stats) or `sql` (read-only SELECT). Prefer `rows` when data is already available \u2014 pass the tool's data array directly. Use `sql` only for custom aggregations not covered by existing tools. Never output HTML, JavaScript, SVG, ECharts options, or rendering code.",
   inputSchema: inputSchema2,
   handler: handler2,
   category: "analysis"
@@ -495,12 +532,12 @@ var getMessageContextTool = {
   truncationStrategy: "keep_last"
 };
 
-// ../../packages/tools/src/definitions/search-sessions.ts
+// ../../packages/tools/src/definitions/search-segments.ts
 var inputSchema9 = {
   type: "object",
   properties: {
     keywords: { type: "array", items: { type: "string" }, description: "\u641C\u7D22\u5173\u952E\u8BCD\u5217\u8868" },
-    limit: { type: "number", description: "\u8FD4\u56DE\u7684\u6700\u5927\u4F1A\u8BDD\u6570\uFF0C\u9ED8\u8BA4 20" },
+    limit: { type: "number", description: "\u8FD4\u56DE\u7684\u6700\u5927\u6BB5\u843D\u6570\uFF0C\u9ED8\u8BA4 20" },
     ...timeParamProperties
   }
 };
@@ -508,31 +545,31 @@ async function handler9(params, context) {
   const { locale, timeFilter: contextTimeFilter } = context;
   const limit = params.limit || 20;
   const effectiveTimeFilter = parseExtendedTimeParams(params, contextTimeFilter);
-  const sessions = await context.dataProvider.searchSessions(
+  const segments = await context.dataProvider.searchSegments(
     params.keywords,
     effectiveTimeFilter,
     limit,
     5
   );
-  if (sessions.length === 0) {
+  if (segments.length === 0) {
     const data2 = {
       total: 0,
-      message: isChineseLocale(locale) ? "\u672A\u627E\u5230\u5339\u914D\u7684\u4F1A\u8BDD" : "No matching sessions found"
+      message: isChineseLocale(locale) ? "\u672A\u627E\u5230\u5339\u914D\u7684\u6BB5\u843D" : "No matching segments found"
     };
     return { content: JSON.stringify(data2), data: data2 };
   }
   const localeStr = isChineseLocale(locale) ? "zh-CN" : "en-US";
   const msgSuffix = isChineseLocale(locale) ? "\u6761\u6D88\u606F" : " messages";
-  const completeLabel = isChineseLocale(locale) ? "\u5B8C\u6574\u4F1A\u8BDD" : "complete";
+  const completeLabel = isChineseLocale(locale) ? "\u5B8C\u6574\u6BB5\u843D" : "complete";
   const data = {
-    total: sessions.length,
+    total: segments.length,
     timeRange: formatTimeRange(effectiveTimeFilter, locale),
-    sessions: sessions.map((s) => {
+    segments: segments.map((s) => {
       const startTime = new Date(s.startTs * 1e3).toLocaleString(localeStr);
       const endTime = new Date(s.endTs * 1e3).toLocaleString(localeStr);
       const completeTag = s.isComplete ? ` [${completeLabel}]` : "";
       return {
-        sessionId: s.id,
+        segmentId: s.id,
         time: `${startTime} ~ ${endTime}`,
         messageCount: `${s.messageCount}${msgSuffix}${completeTag}`,
         preview: s.previewMessages.map((m) => formatMessageCompact(m, locale))
@@ -541,31 +578,31 @@ async function handler9(params, context) {
   };
   return { content: JSON.stringify(data), data };
 }
-var searchSessionsTool = {
-  name: "search_sessions",
-  description: "\u641C\u7D22\u804A\u5929\u4F1A\u8BDD\uFF08\u5BF9\u8BDD\u6BB5\u843D\uFF09\u3002\u4F1A\u8BDD\u662F\u6839\u636E\u6D88\u606F\u65F6\u95F4\u95F4\u9694\u81EA\u52A8\u5207\u5206\u7684\u5BF9\u8BDD\u5355\u5143\u3002\u8FD4\u56DE\u5339\u914D\u7684\u4F1A\u8BDD\u5217\u8868\u53CA\u6BCF\u4E2A\u4F1A\u8BDD\u7684\u524D5\u6761\u6D88\u606F\u9884\u89C8\u3002",
+var searchSegmentsTool = {
+  name: "search_segments",
+  description: "\u641C\u7D22\u804A\u5929\u6BB5\u843D\uFF08\u5BF9\u8BDD\u6BB5\u843D\uFF09\u3002\u6BB5\u843D\u662F\u6839\u636E\u6D88\u606F\u65F6\u95F4\u95F4\u9694\u81EA\u52A8\u5207\u5206\u7684\u5BF9\u8BDD\u5355\u5143\u3002\u8FD4\u56DE\u5339\u914D\u7684\u6BB5\u843D\u5217\u8868\u53CA\u6BCF\u4E2A\u6BB5\u843D\u7684\u524D5\u6761\u6D88\u606F\u9884\u89C8\u3002",
   inputSchema: inputSchema9,
   handler: handler9,
   category: "core"
 };
 
-// ../../packages/tools/src/definitions/get-session-messages.ts
+// ../../packages/tools/src/definitions/get-segment-messages.ts
 var inputSchema10 = {
   type: "object",
   properties: {
-    session_id: { type: "number", description: "\u4F1A\u8BDD ID\uFF08\u901A\u8FC7 search_sessions \u83B7\u53D6\uFF09" },
+    segment_id: { type: "number", description: "\u6BB5\u843D ID\uFF08\u901A\u8FC7 search_segments \u83B7\u53D6\uFF09" },
     limit: { type: "number", description: "\u8FD4\u56DE\u7684\u6700\u5927\u6D88\u606F\u6761\u6570" }
   },
-  required: ["session_id"]
+  required: ["segment_id"]
 };
 async function handler10(params, context) {
   const { locale, maxMessagesLimit } = context;
   const limit = maxMessagesLimit || params.limit || 1e3;
-  const result = await context.dataProvider.getSessionMessages(params.session_id, limit);
+  const result = await context.dataProvider.getSegmentMessages(params.segment_id, limit);
   if (!result) {
     const data2 = {
-      error: isChineseLocale(locale) ? "\u672A\u627E\u5230\u6307\u5B9A\u7684\u4F1A\u8BDD" : "Session not found",
-      sessionId: params.session_id
+      error: isChineseLocale(locale) ? "\u672A\u627E\u5230\u6307\u5B9A\u7684\u6BB5\u843D" : "Segment not found",
+      segmentId: params.segment_id
     };
     return { content: JSON.stringify(data2), data: data2 };
   }
@@ -579,7 +616,7 @@ async function handler10(params, context) {
     timestamp: m.timestamp
   }));
   const data = {
-    sessionId: result.sessionId,
+    segmentId: result.segmentId,
     time: `${startTime} ~ ${endTime}`,
     messageCount: result.messageCount,
     returnedCount: result.returnedCount,
@@ -588,9 +625,9 @@ async function handler10(params, context) {
   };
   return { content: JSON.stringify(data), data, rawMessages };
 }
-var getSessionMessagesTool = {
-  name: "get_session_messages",
-  description: "\u83B7\u53D6\u6307\u5B9A\u4F1A\u8BDD\u7684\u5B8C\u6574\u6D88\u606F\u5217\u8868\u3002\u7528\u4E8E\u5728 search_sessions \u627E\u5230\u76F8\u5173\u4F1A\u8BDD\u540E\uFF0C\u83B7\u53D6\u8BE5\u4F1A\u8BDD\u7684\u5B8C\u6574\u4E0A\u4E0B\u6587\u3002",
+var getSegmentMessagesTool = {
+  name: "get_segment_messages",
+  description: "\u83B7\u53D6\u6307\u5B9A\u6BB5\u843D\u7684\u5B8C\u6574\u6D88\u606F\u5217\u8868\u3002\u7528\u4E8E\u5728 search_segments \u627E\u5230\u76F8\u5173\u6BB5\u843D\u540E\uFF0C\u83B7\u53D6\u8BE5\u6BB5\u843D\u7684\u5B8C\u6574\u4E0A\u4E0B\u6587\u3002",
   inputSchema: inputSchema10,
   handler: handler10,
   category: "core",
@@ -841,12 +878,12 @@ var getConversationBetweenTool = {
   truncationStrategy: "keep_last"
 };
 
-// ../../packages/tools/src/definitions/get-session-summaries.ts
+// ../../packages/tools/src/definitions/get-segment-summaries.ts
 var inputSchema17 = {
   type: "object",
   properties: {
     keywords: { type: "array", items: { type: "string" }, description: "\u6309\u5173\u952E\u8BCD\u8FC7\u6EE4\u6458\u8981\u5185\u5BB9" },
-    limit: { type: "number", description: "\u8FD4\u56DE\u7684\u6700\u5927\u4F1A\u8BDD\u6570\uFF0C\u9ED8\u8BA4 20" },
+    limit: { type: "number", description: "\u8FD4\u56DE\u7684\u6700\u5927\u6BB5\u843D\u6570\uFF0C\u9ED8\u8BA4 20" },
     ...timeParamProperties
   }
 };
@@ -854,36 +891,36 @@ async function handler17(params, context) {
   const { locale, timeFilter: contextTimeFilter } = context;
   const limit = params.limit || 20;
   const effectiveTimeFilter = parseExtendedTimeParams(params, contextTimeFilter);
-  const sessions = await context.dataProvider.getSessionSummaries({
+  const segments = await context.dataProvider.getSegmentSummaries({
     limit: limit * 2,
     timeFilter: effectiveTimeFilter
   });
-  if (!sessions || sessions.length === 0) {
+  if (!segments || segments.length === 0) {
     const data2 = {
-      message: isChineseLocale(locale) ? '\u672A\u627E\u5230\u5E26\u6458\u8981\u7684\u4F1A\u8BDD\u3002\u53EF\u80FD\u8FD8\u6CA1\u6709\u751F\u6210\u6458\u8981\uFF0C\u8BF7\u5728\u4F1A\u8BDD\u65F6\u95F4\u7EBF\u4E2D\u70B9\u51FB"\u6279\u91CF\u751F\u6210"\u6309\u94AE\u3002' : "No sessions with summaries found. Summaries may not have been generated yet."
+      message: isChineseLocale(locale) ? '\u672A\u627E\u5230\u5E26\u6458\u8981\u7684\u6BB5\u843D\u3002\u53EF\u80FD\u8FD8\u6CA1\u6709\u751F\u6210\u6458\u8981\uFF0C\u8BF7\u5728\u6BB5\u843D\u65F6\u95F4\u7EBF\u4E2D\u70B9\u51FB"\u6279\u91CF\u751F\u6210"\u6309\u94AE\u3002' : "No segments with summaries found. Summaries may not have been generated yet."
     };
     return { content: JSON.stringify(data2), data: data2 };
   }
-  let filteredSessions = sessions;
+  let filteredSegments = segments;
   const keywords = params.keywords;
   if (keywords && keywords.length > 0) {
     const lowerKeywords = keywords.map((k) => k.toLowerCase());
-    filteredSessions = sessions.filter(
+    filteredSegments = segments.filter(
       (s) => lowerKeywords.some((keyword) => s.summary?.toLowerCase().includes(keyword))
     );
   }
-  filteredSessions = filteredSessions.filter((s) => s.summary);
-  const limitedSessions = filteredSessions.slice(0, limit);
+  filteredSegments = filteredSegments.filter((s) => s.summary);
+  const limitedSegments = filteredSegments.slice(0, limit);
   const localeStr = isChineseLocale(locale) ? "zh-CN" : "en-US";
   const data = {
-    total: filteredSessions.length,
-    returned: limitedSessions.length,
+    total: filteredSegments.length,
+    returned: limitedSegments.length,
     timeRange: formatTimeRange(effectiveTimeFilter, locale),
-    sessions: limitedSessions.map((s) => {
+    segments: limitedSegments.map((s) => {
       const startTime = new Date(s.startTs * 1e3).toLocaleString(localeStr);
       const endTime = new Date(s.endTs * 1e3).toLocaleString(localeStr);
       return {
-        sessionId: s.id,
+        segmentId: s.id,
         time: `${startTime} ~ ${endTime}`,
         messageCount: s.messageCount,
         participants: s.participants,
@@ -893,9 +930,9 @@ async function handler17(params, context) {
   };
   return { content: JSON.stringify(data), data };
 }
-var getSessionSummariesTool = {
-  name: "get_session_summaries",
-  description: "\u83B7\u53D6\u4F1A\u8BDD\u6458\u8981\u5217\u8868\uFF0C\u5FEB\u901F\u4E86\u89E3\u7FA4\u804A\u5386\u53F2\u8BA8\u8BBA\u7684\u4E3B\u9898\u3002\u53EF\u4EE5\u6309\u5173\u952E\u8BCD\u641C\u7D22\u8BA8\u8BBA\u8FC7\u7684\u8BDD\u9898\u3002",
+var getSegmentSummariesTool = {
+  name: "get_segment_summaries",
+  description: "\u83B7\u53D6\u6BB5\u843D\u6458\u8981\u5217\u8868\uFF0C\u5FEB\u901F\u4E86\u89E3\u7FA4\u804A\u5386\u53F2\u8BA8\u8BBA\u7684\u4E3B\u9898\u3002\u53EF\u4EE5\u6309\u5173\u952E\u8BCD\u641C\u7D22\u8BA8\u8BBA\u8FC7\u7684\u8BDD\u9898\u3002",
   inputSchema: inputSchema17,
   handler: handler17,
   category: "analysis"
@@ -1208,7 +1245,7 @@ var SQL_TOOL_DEFS = [
     },
     execution: {
       type: "sqlite",
-      query: "SELECT COALESCE(m.group_nickname, m.account_name) AS name, COUNT(*) AS initiated_count FROM chat_session cs JOIN message_context mc ON mc.session_id = cs.id JOIN message msg ON msg.id = mc.message_id JOIN member m ON msg.sender_id = m.id WHERE msg.ts = cs.start_ts AND cs.start_ts > unixepoch('now', '-' || @days || ' days') GROUP BY msg.sender_id ORDER BY initiated_count DESC LIMIT @limit",
+      query: "SELECT COALESCE(m.group_nickname, m.account_name) AS name, COUNT(*) AS initiated_count FROM segment cs JOIN message_context mc ON mc.segment_id = cs.id JOIN message msg ON msg.id = mc.message_id JOIN member m ON msg.sender_id = m.id WHERE msg.ts = cs.start_ts AND cs.start_ts > unixepoch('now', '-' || @days || ' days') GROUP BY msg.sender_id ORDER BY initiated_count DESC LIMIT @limit",
       rowTemplate: "{name}\uFF1A\u53D1\u8D77 {initiated_count} \u6B21\u8BDD\u9898",
       summaryTemplate: "\u8BDD\u9898\u53D1\u8D77\u8005 Top {rowCount}\uFF1A",
       fallback: "\u8BE5\u65F6\u95F4\u8303\u56F4\u5185\u6CA1\u6709\u4F1A\u8BDD\u8BB0\u5F55\uFF0C\u53EF\u80FD\u9700\u8981\u5148\u751F\u6210\u4F1A\u8BDD\u7D22\u5F15"
@@ -1310,8 +1347,8 @@ var SHARED_TOOLS = [
   deepSearchMessagesTool,
   recentMessagesTool,
   getMessageContextTool,
-  searchSessionsTool,
-  getSessionMessagesTool,
+  searchSegmentsTool,
+  getSegmentMessagesTool,
   getMembersTool,
   schemaTool,
   // Analysis
@@ -1319,7 +1356,7 @@ var SHARED_TOOLS = [
   timeStatsTool,
   getMemberNameHistoryTool,
   getConversationBetweenTool,
-  getSessionSummariesTool,
+  getSegmentSummariesTool,
   responseTimeAnalysisTool,
   keywordFrequencyTool,
   renderChartTool,
@@ -1409,14 +1446,14 @@ var CoreDataProvider = class {
         return getHourlyActivity(this.db, filter);
     }
   }
-  async searchSessions(keywords, timeFilter, limit, previewCount) {
-    return searchSessions(this.db, keywords, timeFilter, limit, previewCount);
+  async searchSegments(keywords, timeFilter, limit, previewCount) {
+    return searchSegments(this.db, keywords, timeFilter, limit, previewCount);
   }
-  async getSessionMessages(chatSessionId, limit) {
-    return getSessionMessages(this.db, chatSessionId, limit);
+  async getSegmentMessages(segmentId, limit) {
+    return getSegmentMessages(this.db, segmentId, limit);
   }
-  async getSessionSummaries(options) {
-    return getSessionSummaries(this.db, options);
+  async getSegmentSummaries(options) {
+    return getSegmentSummaries(this.db, options);
   }
   async getConversationBetween(memberId1, memberId2, timeFilter, limit) {
     return getConversationBetween(this.db, memberId1, memberId2, timeFilter, limit);
@@ -1437,4 +1474,4 @@ export {
   MCP_TOOL_REGISTRY,
   CoreDataProvider
 };
-//# sourceMappingURL=chunk-E65ABM3C.mjs.map
+//# sourceMappingURL=chunk-IRZRIHIT.mjs.map