kiku-agent 1.0.10 → 1.0.11

package/server/agent/queryDetails.js

@@ -1,182 +1,234 @@
-import { spawnSync } from 'node:child_process';
-
-const DETAIL_VIEWS = new Set(['overview', 'answer', 'thinking', 'tools', 'tool', 'all', 'markdown']);
-
-export function parseDetailsRequest(reference = '') {
-  const tokens = String(reference || '').trim().split(/\s+/).filter(Boolean);
-  let queryNumber = null;
-
-  if (tokens[0] && /^q?\d+$/i.test(tokens[0])) {
-    queryNumber = Number.parseInt(tokens.shift().replace(/^q/i, ''), 10);
-  } else if (tokens[0]?.toLowerCase() === 'latest') {
-    tokens.shift();
-  }
-
-  const view = (tokens.shift() || 'answer').toLowerCase();
-  if (!DETAIL_VIEWS.has(view)) {
-    return { error: `Unknown details view "${view}".`, queryNumber, view: 'overview', toolIndex: null };
-  }
-
-  let toolIndex = null;
-  if (view === 'tool') {
-    const rawIndex = tokens.shift();
-    if (!rawIndex || !/^\d+$/.test(rawIndex) || Number(rawIndex) < 1) {
-      return { error: 'Tool view requires a positive tool number.', queryNumber, view, toolIndex: null };
-    }
-    toolIndex = Number(rawIndex);
-  }
-
-  if (tokens.length > 0) {
-    return { error: 'Too many details arguments.', queryNumber, view, toolIndex };
-  }
-
-  return { error: null, queryNumber, view, toolIndex };
-}
-
-export function classifyToolResult(result = {}) {
-  const count = result?.count ?? result?.returnedCount;
-  if (result?.status === 'error') return { state: 'error', count };
-  if (result?.status === 'not_found' || count === 0) return { state: 'not_found', count };
-  return { state: 'ok', count };
-}
-
-export function summarizeQueryDetails(details = {}) {
-  const tools = Array.isArray(details.tools) ? details.tools : [];
-  const toolStates = tools.map(tool => classifyToolResult(tool.result));
-  return {
-    toolCount: tools.length,
-    successfulTools: toolStates.filter(item => item.state === 'ok').length,
-    failedTools: toolStates.filter(item => item.state === 'error').length,
-    emptyTools: toolStates.filter(item => item.state === 'not_found').length,
-    toolDurationMs: tools.reduce((total, tool) => total + (Number(tool.duration) || 0), 0),
-    thinkingCharacters: String(details.thinking || '').length,
-    answerCharacters: String(details.answer || '').length,
-  };
-}
-
-export function formatDetailDuration(durationMs) {
-  const duration = Number(durationMs);
-  if (!Number.isFinite(duration) || duration < 0) return 'n/a';
-  if (duration < 1000) return `${Math.round(duration)}ms`;
-  return `${(duration / 1000).toFixed(duration < 10000 ? 2 : 1)}s`;
-}
-
-export function serializeDetailValue(value, maxLength = Infinity) {
-  let serialized;
-  try {
-    serialized = JSON.stringify(value ?? {}, null, 2);
-  } catch {
-    serialized = String(value ?? '');
-  }
-  if (!Number.isFinite(maxLength) || serialized.length <= maxLength) {
-    return { text: serialized, truncated: false };
-  }
-  return { text: `${serialized.slice(0, maxLength)}\n… result truncated`, truncated: true };
-}
-
-export function copyToClipboard(text) {
-  if (typeof text !== 'string') text = String(text ?? '');
-  const platform = process.platform;
-
-  try {
-    if (platform === 'win32') {
-      const proc = spawnSync('clip', [], { input: text, encoding: 'utf-8', windowsHide: true });
-      if (proc.status === 0) return true;
-      const ps = spawnSync('powershell.exe', ['-NoProfile', '-Command', '$input | Set-Clipboard'], {
-        input: text,
-        encoding: 'utf-8',
-        windowsHide: true,
-      });
-      return ps.status === 0;
-    }
-    if (platform === 'darwin') {
-      const proc = spawnSync('pbcopy', [], { input: text, encoding: 'utf-8' });
-      return proc.status === 0;
-    }
-    const tools = [
-      { cmd: 'wl-copy', args: [] },
-      { cmd: 'xclip', args: ['-selection', 'clipboard'] },
-      { cmd: 'xsel', args: ['--clipboard', '--input'] },
-    ];
-    for (const t of tools) {
-      try {
-        const proc = spawnSync(t.cmd, t.args, { input: text, encoding: 'utf-8' });
-        if (proc.status === 0) return true;
-      } catch {}
-    }
-  } catch {}
-  return false;
-}
-
-export function getCopyableContent(details, request = {}) {
-  if (!details) return null;
-  const view = request.view || 'answer';
-  const queryLabel = `Q${details.number}`;
-
-  if (view === 'answer') {
-    return {
-      title: `Answer • ${queryLabel}`,
-      text: details.answer || '',
-      type: 'answer',
-    };
-  }
-
-  if (view === 'thinking') {
-    return {
-      title: `Thinking Trace • ${queryLabel}`,
-      text: details.thinking || '',
-      type: 'thinking',
-    };
-  }
-
-  if (view === 'tool') {
-    const tool = details.tools?.[request.toolIndex - 1];
-    if (!tool) return null;
-    return {
-      title: `Tool #${request.toolIndex} (${tool.name}) • ${queryLabel}`,
-      text: JSON.stringify({ name: tool.name, duration: tool.duration, args: tool.args, result: tool.result }, null, 2),
-      type: 'tool',
-    };
-  }
-
-  if (view === 'tools') {
-    const serialized = JSON.stringify(details.tools || [], null, 2);
-    return {
-      title: `Tool Timeline • ${queryLabel}`,
-      text: serialized,
-      type: 'tools',
-    };
-  }
-
-  if (view === 'markdown' || view === 'all') {
-    const md = [
-      `# Question ${details.number}`,
-      `**Status**: ${details.status || 'complete'}`,
-      `**Started**: ${Number.isFinite(details.startedAt) ? new Date(details.startedAt).toISOString() : 'n/a'}`,
-      '',
-      ...(details.thinking ? ['## Thinking', '```', details.thinking, '```', ''] : []),
-      ...(details.tools?.length ? ['## Tools Used', '```json', JSON.stringify(details.tools, null, 2), '```', ''] : []),
-      '## Answer',
-      details.answer || '',
-    ].join('\n');
-    return {
-      title: `Complete Query Markdown • ${queryLabel}`,
-      text: md,
-      type: 'markdown',
-    };
-  }
-
-  const summary = summarizeQueryDetails(details);
-  const overviewText = [
-    `Query: Q${details.number}`,
-    `Status: ${details.status}`,
-    `Answer (${summary.answerCharacters} chars):\n${details.answer || ''}`,
-    details.thinking ? `\nThinking (${summary.thinkingCharacters} chars):\n${details.thinking}` : '',
-  ].filter(Boolean).join('\n');
-
-  return {
-    title: `Overview • ${queryLabel}`,
-    text: overviewText,
-    type: 'overview',
-  };
-}
+import { spawnSync } from 'node:child_process';
+
+const DETAIL_VIEWS = new Set([
+  'overview', 'answer', 'thinking', 'tools', 'tool', 'all',
+  'markdown', 'json', 'text', 'raw', 'session', 'transcript', 'history'
+]);
+
+export function parseDetailsRequest(reference = '') {
+  const tokens = String(reference || '').trim().split(/\s+/).filter(Boolean);
+  let queryNumber = null;
+  let isSession = false;
+
+  const first = (tokens[0] || '').toLowerCase();
+  if (first === 'session' || first === 'transcript' || first === 'history') {
+    isSession = true;
+    tokens.shift();
+  } else if (/^q?\d+$/i.test(tokens[0])) {
+    queryNumber = Number.parseInt(tokens.shift().replace(/^q/i, ''), 10);
+  } else if (tokens[0]?.toLowerCase() === 'latest') {
+    tokens.shift();
+  }
+
+  let view = (tokens.shift() || (isSession ? 'markdown' : 'answer')).toLowerCase();
+  if (view === 'session' || view === 'transcript' || view === 'history') {
+    isSession = true;
+    view = (tokens.shift() || 'markdown').toLowerCase();
+  }
+
+  if (!DETAIL_VIEWS.has(view)) {
+    return { error: `Unknown details view "${view}".`, queryNumber, view: 'overview', toolIndex: null, isSession };
+  }
+
+  let toolIndex = null;
+  if (view === 'tool') {
+    const rawIndex = tokens.shift();
+    if (!rawIndex || !/^\d+$/.test(rawIndex) || Number(rawIndex) < 1) {
+      return { error: 'Tool view requires a positive tool number.', queryNumber, view, toolIndex: null, isSession };
+    }
+    toolIndex = Number(rawIndex);
+  }
+
+  if (tokens.length > 0) {
+    return { error: 'Too many details arguments.', queryNumber, view, toolIndex, isSession };
+  }
+
+  const result = { error: null, queryNumber, view, toolIndex };
+  if (isSession) result.isSession = true;
+  return result;
+}
+
+export function classifyToolResult(result = {}) {
+  const count = result?.count ?? result?.returnedCount;
+  if (result?.status === 'error') return { state: 'error', count };
+  if (result?.status === 'not_found' || count === 0) return { state: 'not_found', count };
+  return { state: 'ok', count };
+}
+
+export function summarizeQueryDetails(details = {}) {
+  const tools = Array.isArray(details.tools) ? details.tools : [];
+  const toolStates = tools.map(tool => classifyToolResult(tool.result));
+  return {
+    toolCount: tools.length,
+    successfulTools: toolStates.filter(item => item.state === 'ok').length,
+    failedTools: toolStates.filter(item => item.state === 'error').length,
+    emptyTools: toolStates.filter(item => item.state === 'not_found').length,
+    toolDurationMs: tools.reduce((total, tool) => total + (Number(tool.duration) || 0), 0),
+    thinkingCharacters: String(details.thinking || '').length,
+    answerCharacters: String(details.answer || '').length,
+  };
+}
+
+export function formatDetailDuration(durationMs) {
+  const duration = Number(durationMs);
+  if (!Number.isFinite(duration) || duration < 0) return 'n/a';
+  if (duration < 1000) return `${Math.round(duration)}ms`;
+  return `${(duration / 1000).toFixed(duration < 10000 ? 2 : 1)}s`;
+}
+
+export function serializeDetailValue(value, maxLength = Infinity) {
+  let serialized;
+  try {
+    serialized = JSON.stringify(value ?? {}, null, 2);
+  } catch {
+    serialized = String(value ?? '');
+  }
+  if (!Number.isFinite(maxLength) || serialized.length <= maxLength) {
+    return { text: serialized, truncated: false };
+  }
+  return { text: `${serialized.slice(0, maxLength)}\n… result truncated`, truncated: true };
+}
+
+export function copyToClipboard(text) {
+  if (typeof text !== 'string') text = String(text ?? '');
+  const platform = process.platform;
+
+  try {
+    if (platform === 'win32') {
+      const proc = spawnSync('clip', [], { input: text, encoding: 'utf-8', windowsHide: true });
+      if (proc.status === 0) return true;
+      const ps = spawnSync('powershell.exe', ['-NoProfile', '-Command', '$input | Set-Clipboard'], {
+        input: text,
+        encoding: 'utf-8',
+        windowsHide: true,
+      });
+      return ps.status === 0;
+    }
+    if (platform === 'darwin') {
+      const proc = spawnSync('pbcopy', [], { input: text, encoding: 'utf-8' });
+      return proc.status === 0;
+    }
+    const tools = [
+      { cmd: 'wl-copy', args: [] },
+      { cmd: 'xclip', args: ['-selection', 'clipboard'] },
+      { cmd: 'xsel', args: ['--clipboard', '--input'] },
+    ];
+    for (const t of tools) {
+      try {
+        const proc = spawnSync(t.cmd, t.args, { input: text, encoding: 'utf-8' });
+        if (proc.status === 0) return true;
+      } catch {}
+    }
+  } catch {}
+  return false;
+}
+
+export function getCopyableContent(details, request = {}, session = null) {
+  const isSessionReq = request.isSession || (!details && session);
+  const view = request.view || 'answer';
+
+  if (isSessionReq && session) {
+    if (view === 'json') {
+      return {
+        title: `Full Session JSON • ${session.id}`,
+        text: typeof session.getTranscriptJson === 'function' ? session.getTranscriptJson() : JSON.stringify(session.toSnapshot?.() || session, null, 2),
+        type: 'session_json',
+      };
+    }
+    if (view === 'text' || view === 'raw') {
+      return {
+        title: `Full Session Text • ${session.id}`,
+        text: typeof session.getTranscriptText === 'function' ? session.getTranscriptText() : String(session.messages || ''),
+        type: 'session_text',
+      };
+    }
+    return {
+      title: `Full Session Markdown • ${session.id}`,
+      text: typeof session.getTranscriptMarkdown === 'function' ? session.getTranscriptMarkdown() : String(session.messages || ''),
+      type: 'session_markdown',
+    };
+  }
+
+  if (!details) return null;
+  const queryLabel = `Q${details.number}`;
+
+  if (view === 'answer') {
+    return {
+      title: `Answer • ${queryLabel}`,
+      text: details.answer || '',
+      type: 'answer',
+    };
+  }
+
+  if (view === 'thinking') {
+    return {
+      title: `Thinking Trace • ${queryLabel}`,
+      text: details.thinking || '',
+      type: 'thinking',
+    };
+  }
+
+  if (view === 'tool') {
+    const tool = details.tools?.[request.toolIndex - 1];
+    if (!tool) return null;
+    return {
+      title: `Tool #${request.toolIndex} (${tool.name}) • ${queryLabel}`,
+      text: JSON.stringify({ name: tool.name, duration: tool.duration, args: tool.args, result: tool.result }, null, 2),
+      type: 'tool',
+    };
+  }
+
+  if (view === 'tools') {
+    const serialized = JSON.stringify(details.tools || [], null, 2);
+    return {
+      title: `Tool Timeline • ${queryLabel}`,
+      text: serialized,
+      type: 'tools',
+    };
+  }
+
+  if (view === 'json') {
+    return {
+      title: `Query Diagnostics JSON • ${queryLabel}`,
+      text: JSON.stringify(details, null, 2),
+      type: 'json',
+    };
+  }
+
+  if (view === 'markdown' || view === 'all') {
+    const md = [
+      `# Question ${details.number}`,
+      `**Status**: ${details.status || 'complete'}`,
+      `**Runtime**: ${details.provider || 'unknown'} / ${details.model || 'unknown'}`,
+      `**Started**: ${Number.isFinite(details.startedAt) ? new Date(details.startedAt).toISOString() : 'n/a'}`,
+      `**Duration**: ${formatDetailDuration(details.durationMs)}`,
+      '',
+      ...(details.prompt ? ['## User Prompt', details.prompt, ''] : []),
+      ...(details.thinking ? ['## Thinking Trace', '```', details.thinking, '```', ''] : []),
+      ...(details.tools?.length ? ['## Tools Used', '```json', JSON.stringify(details.tools, null, 2), '```', ''] : []),
+      '## Answer',
+      details.answer || '',
+    ].join('\n');
+    return {
+      title: `Complete Query Markdown • ${queryLabel}`,
+      text: md,
+      type: 'markdown',
+    };
+  }
+
+  const summary = summarizeQueryDetails(details);
+  const overviewText = [
+    `Query: Q${details.number}`,
+    `Status: ${details.status}`,
+    `Provider / Model: ${details.provider || 'unknown'} / ${details.model || 'unknown'}`,
+    `Duration: ${formatDetailDuration(details.durationMs)}`,
+    `Answer (${summary.answerCharacters} chars):\n${details.answer || ''}`,
+    details.thinking ? `\nThinking (${summary.thinkingCharacters} chars):\n${details.thinking}` : '',
+  ].filter(Boolean).join('\n');
+
+  return {
+    title: `Overview • ${queryLabel}`,
+    text: overviewText,
+    type: 'overview',
+  };
+}