@selesai/code 0.12.0 → 0.13.1

package/dist/extensions/pi-hermes-memory/src/tools/session-search-tool.ts

@@ -0,0 +1,246 @@
+import * as path from 'node:path';
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+import { StringEnum } from "@earendil-works/pi-ai";
+import { DatabaseManager } from '../store/db.js';
+import { searchSessions, getIndexedMessageCount } from '../store/session-search.js';
+import { searchSessionAnchors } from '../store/session-anchor-search.js';
+import type { SessionAnchorRange, SessionAnchorSearchResult } from '../store/session-anchor-search.js';
+import type { SessionSearchConfig } from '../types.js';
+import { AGENT_ROOT } from '../paths.js';
+import { createSharedToolResultRenderer } from './shared-output-view.js';
+import { searchResultView } from './tool-result-views.js';
+
+interface SearchResult {
+  success: boolean;
+  count?: number;
+  message?: string;
+  output?: string;
+  outputChars?: number;
+  outputTruncated?: boolean;
+  snippetChars?: number;
+  truncatedCount?: number;
+  ranges?: SessionAnchorRange[];
+}
+
+interface SessionSearchToolOptions {
+  sessionsDir?: string;
+}
+
+const DEFAULT_SESSIONS_DIR = path.join(AGENT_ROOT, 'sessions');
+const DEFAULT_LEGACY_SNIPPET_CHARS = 1_200;
+const MAX_LEGACY_SNIPPET_CHARS = 4_000;
+const MAX_LEGACY_OUTPUT_CHARS = 50 * 1024;
+
+function truncateLegacySnippet(text: string, maxChars: number): { text: string; truncated: boolean } {
+  if (text.length <= maxChars) return { text, truncated: false };
+  return {
+    text: `${text.slice(0, maxChars)}\n... (truncated, ${text.length} chars total — refine the query or increase snippetChars)`,
+    truncated: true,
+  };
+}
+
+function capLegacyOutput(text: string): { text: string; truncated: boolean } {
+  if (text.length <= MAX_LEGACY_OUTPUT_CHARS) return { text, truncated: false };
+  const suffix = `\n... (output truncated, ${text.length} chars total — refine the query or lower the result limit)`;
+  return {
+    text: `${text.slice(0, MAX_LEGACY_OUTPUT_CHARS - suffix.length)}${suffix}`,
+    truncated: true,
+  };
+}
+
+export function registerSessionSearchTool(
+  pi: ExtensionAPI,
+  dbManager: DatabaseManager,
+  sessionSearchConfig: SessionSearchConfig = { variant: 'legacy' },
+  options: SessionSearchToolOptions = {},
+): void {
+  if (sessionSearchConfig.variant === 'anchors') {
+    registerAnchorSessionSearchTool(pi, options.sessionsDir ?? DEFAULT_SESSIONS_DIR);
+    return;
+  }
+
+  registerLegacySessionSearchTool(pi, dbManager);
+}
+
+function registerAnchorSessionSearchTool(pi: ExtensionAPI, sessionsDir: string): void {
+  pi.registerTool({
+    name: 'session_search',
+    label: 'Session Search',
+    description: `Search Pi session JSONL files in the opt-in anchor mode using a Markdown request.
+
+This mode accepts only a markdown request. Supported scalar fields are from, to, cwd, and limit. Supported list sections are all, any, and exclude: all terms must match, any requires at least one listed term, and exclude removes matching ranges. It returns compact JSONL line-range anchors, not summaries or previews. Output is plain text: count, optional message, then anchors as path:startLine-endLine with a short reason.
+
+Example:
+from: 2026-05-14
+to: 2026-05-15
+cwd: /path/to/project
+limit: 20
+
+all:
+- alpha
+
+any:
+- beta
+- gamma
+
+exclude:
+- delta`,
+    promptSnippet: 'Search past session JSONL files for compact source anchors',
+    promptGuidelines: [
+      'Use session_search with markdown only when the session search anchor mode is configured.',
+      'Request source anchors, not summaries or previews.',
+      'Use all for required terms, any for alternatives, and exclude for terms that must not appear in a returned range.',
+    ],
+    renderResult: createSharedToolResultRenderer(searchResultView),
+    parameters: Type.Object({
+      markdown: Type.String({ description: 'Markdown request with optional from/to/cwd/limit fields and all/any/exclude lists.' }),
+    }),
+    execute: async (_id: string, args: { markdown: string }) => {
+      const markdown = args.markdown;
+
+      if (!markdown || markdown.trim().length === 0) {
+        const result: SearchResult = { success: false, message: 'markdown is required' };
+        return { content: [{ type: 'text' as const, text: result.message! }], details: result };
+      }
+
+      const searchResult = searchSessionAnchors(markdown, { sessionsDir });
+      if (!searchResult.success) {
+        const result: SearchResult = { success: false, message: searchResult.message ?? 'Anchor session search failed.' };
+        return { content: [{ type: 'text' as const, text: result.message! }], details: result };
+      }
+
+      const output = formatAnchorSearchOutput(searchResult);
+      const result: SearchResult = {
+        success: true,
+        count: searchResult.ranges.length,
+        message: searchResult.message,
+        output,
+        ranges: searchResult.ranges,
+      };
+      return { content: [{ type: 'text' as const, text: output }], details: result };
+    },
+  });
+}
+
+function formatAnchorSearchOutput(searchResult: SessionAnchorSearchResult): string {
+  const lines = [`count: ${searchResult.ranges.length}`];
+  if (searchResult.message) lines.push(`message: ${searchResult.message}`);
+  if (searchResult.ranges.length > 0) {
+    lines.push("anchors:");
+    for (const range of searchResult.ranges) {
+      const anchor = `${range.path}:${range.startLine}-${range.endLine}`;
+      const reason = compactReason(range.reason);
+      lines.push(reason ? `- ${anchor} — ${reason}` : `- ${anchor}`);
+    }
+  }
+  return lines.join("\n");
+}
+
+function compactReason(reason: string | undefined): string {
+  if (!reason) return "";
+  const oneLine = reason.replace(/\s+/g, " ").trim();
+  return oneLine.length <= 180 ? oneLine : `${oneLine.slice(0, 177)}...`;
+}
+
+function registerLegacySessionSearchTool(pi: ExtensionAPI, dbManager: DatabaseManager): void {
+  pi.registerTool({
+    name: 'session_search',
+    label: 'Session Search',
+    description: `Search across past Pi coding sessions for relevant conversation context. Use this when the user asks about previous discussions, past work, or when you need context from earlier sessions.
+
+Examples:
+- "What did we discuss about auth last week?"
+- "Find the PR where we fixed the test hang"
+- "What approach did we take for the database migration?"
+
+Returns bounded conversation snippets with session dates and project context. Large messages are truncated with their original character count.`,
+    promptSnippet: 'Search past conversations for relevant context',
+    promptGuidelines: [
+      'Use session_search when the user asks about previous discussions or past work.',
+      'Use session_search when you need context from earlier sessions.',
+    ],
+    renderResult: createSharedToolResultRenderer(searchResultView),
+    parameters: Type.Object({
+      query: Type.String({ description: 'Search query. Use natural language or specific terms.' }),
+      project: Type.Optional(Type.String({ description: 'Filter by project name (optional).' })),
+      role: Type.Optional(StringEnum(['user', 'assistant'] as const, { description: 'Filter by message role (optional).' })),
+      limit: Type.Optional(Type.Number({
+        description: 'Maximum results to return (default: 10, min: 1, max: 20).',
+        minimum: 1,
+        maximum: 20,
+      })),
+      snippetChars: Type.Optional(Type.Number({
+        description: `Maximum characters per result snippet (default: ${DEFAULT_LEGACY_SNIPPET_CHARS}, max: ${MAX_LEGACY_SNIPPET_CHARS}).`,
+        minimum: 100,
+        maximum: MAX_LEGACY_SNIPPET_CHARS,
+      })),
+    }),
+    execute: async (_id: string, args: { query: string; project?: string; role?: string; limit?: number; snippetChars?: number }) => {
+      const query = args.query;
+      const project = args.project;
+      const role = args.role;
+      const requestedLimit = Number.isFinite(args.limit) ? Math.floor(args.limit!) : 10;
+      const limit = Math.min(Math.max(requestedLimit, 1), 20);
+      const requestedSnippetChars = Number.isFinite(args.snippetChars)
+        ? Math.floor(args.snippetChars!)
+        : DEFAULT_LEGACY_SNIPPET_CHARS;
+      const snippetChars = Math.min(Math.max(requestedSnippetChars, 100), MAX_LEGACY_SNIPPET_CHARS);
+
+      if (!query || query.trim().length === 0) {
+        const result: SearchResult = { success: false, message: 'query is required' };
+        return { content: [{ type: 'text' as const, text: result.message! }], details: result };
+      }
+
+      const totalMessages = getIndexedMessageCount(dbManager);
+      if (totalMessages === 0) {
+        const result: SearchResult = { success: false, message: 'No sessions indexed yet. Run /memory-index-sessions to import past sessions.' };
+        return { content: [{ type: 'text' as const, text: result.message! }], details: result };
+      }
+
+      const results = searchSessions(dbManager, query, { project, role, limit });
+
+      if (results.length === 0) {
+        const output = capLegacyOutput('No results found. Try a different search term or broader query.');
+        const result: SearchResult = {
+          success: true,
+          count: 0,
+          message: output.text,
+          outputChars: output.text.length,
+          outputTruncated: output.truncated,
+        };
+        return { content: [{ type: 'text' as const, text: output.text }], details: result };
+      }
+
+      const blocks: string[] = [`Found ${results.length} results for "${query}":`];
+      let truncatedCount = 0;
+
+      for (const r of results) {
+        const date = new Date(r.timestamp).toLocaleDateString('en-US', {
+          year: 'numeric',
+          month: 'short',
+          day: 'numeric',
+        });
+
+        const snippet = truncateLegacySnippet(r.snippet, snippetChars);
+        if (snippet.truncated) truncatedCount += 1;
+        blocks.push([
+          '---',
+          `📅 ${date} | 📁 ${r.project} | ${r.role === 'user' ? '👤 User' : '🤖 Assistant'}`,
+          snippet.text,
+        ].join('\n'));
+      }
+
+      const output = capLegacyOutput(blocks.join('\n\n').trim());
+      const finalResult: SearchResult = {
+        success: true,
+        count: results.length,
+        truncatedCount,
+        snippetChars,
+        outputChars: output.text.length,
+        outputTruncated: output.truncated,
+      };
+      return { content: [{ type: 'text' as const, text: output.text }], details: finalResult };
+    },
+  });
+}

package/dist/extensions/pi-hermes-memory/src/tools/shared-output-view.ts

@@ -0,0 +1,170 @@
+import { keyHint, type ToolRenderResultOptions } from "@earendil-works/pi-coding-agent";
+import stripAnsi from "strip-ansi";
+import {
+  Text,
+  sliceByColumn,
+  truncateToWidth,
+  visibleWidth,
+  type Component,
+} from "@earendil-works/pi-tui";
+
+export type SharedStatus = "success" | "failure" | "empty";
+
+export interface SharedOutputView {
+  summary: string;
+  expandedText: string;
+  status: SharedStatus;
+}
+
+interface SharedOutputTheme {
+  fg?: (color: any, text: string) => string;
+  getBgAnsi?: (color: any) => string;
+}
+
+type ToolCardBackground = "toolPendingBg" | "toolSuccessBg" | "toolErrorBg";
+
+function record(value: unknown): Record<string, unknown> | null {
+  return value !== null && typeof value === "object" && !Array.isArray(value)
+    ? value as Record<string, unknown>
+    : null;
+}
+
+function textBlocks(content: unknown): string[] {
+  if (!Array.isArray(content)) return [];
+  return content.flatMap((item) => {
+    const block = record(item);
+    return block?.type === "text" && typeof block.text === "string"
+      ? [block.text]
+      : [];
+  });
+}
+
+function sanitizeDisplayText(text: string): string {
+  return stripAnsi(text).replace(/[\p{Cc}\p{Cs}\uFFF9-\uFFFB]/gu, (character) =>
+    character === "\n" || character === "\t" ? character : ""
+  );
+}
+
+function firstLine(text: string): string {
+  return text.split(/\r?\n/).find((line) => line.trim())?.trim() ?? "";
+}
+
+function reason(details: Record<string, unknown> | null): string {
+  for (const value of [details?.error, details?.message, details?.reason]) {
+    if (typeof value === "string" && value.trim()) return value.trim();
+  }
+  return "";
+}
+
+export function normalizeSharedOutputView(input: unknown): SharedOutputView {
+  const result = record(input);
+  const details = record(result?.details);
+  const expandedText = sanitizeDisplayText(textBlocks(result?.content).join("\n"));
+  const detailsReason = sanitizeDisplayText(reason(details));
+  const failure = result?.isError === true || details?.success === false || details?.isError === true;
+  const status: SharedStatus = failure ? "failure" : expandedText.trim() ? "success" : "empty";
+  const summary = failure
+    ? detailsReason || firstLine(expandedText) || "Error"
+    : firstLine(expandedText) || detailsReason || "No output";
+  return { summary, expandedText, status };
+}
+
+function themed(
+  theme: SharedOutputTheme | undefined,
+  status: SharedStatus,
+  partial: boolean,
+  text: string,
+): string {
+  if (typeof theme?.fg !== "function") return text;
+  const color = partial ? "warning" : status === "failure" ? "error" : status === "empty" ? "muted" : "toolOutput";
+  return theme.fg(color, text);
+}
+
+function restoreBackground(
+  text: string,
+  background: ToolCardBackground,
+  theme: SharedOutputTheme | undefined,
+): string {
+  if (typeof theme?.getBgAnsi !== "function") return text;
+  const backgroundAnsi = theme.getBgAnsi(background);
+  return text.replace(/\x1b\[[0-?]*[ -/]*m/g, `$&${backgroundAnsi}`);
+}
+
+function compactSummary(summary: string, width: number, preserveTail: boolean): string {
+  if (visibleWidth(summary) <= width) return summary;
+  if (!preserveTail || width < 13) return truncateToWidth(summary, width, "…");
+
+  const tailWidth = Math.max(6, Math.floor(width / 2));
+  const headWidth = Math.max(3, width - tailWidth - 1);
+  const fullWidth = visibleWidth(summary);
+  return `${sliceByColumn(summary, 0, headWidth, true)}…${sliceByColumn(
+    summary,
+    Math.max(0, fullWidth - tailWidth),
+    tailWidth,
+    true,
+  )}`;
+}
+
+function renderView(
+  view: SharedOutputView,
+  options: ToolRenderResultOptions,
+  theme: SharedOutputTheme | undefined,
+  background: ToolCardBackground,
+): Component {
+  if (options.expanded) {
+    return new Text(
+      view.expandedText || view.summary,
+      0,
+      0,
+      (line) => restoreBackground(line, background, theme),
+    );
+  }
+
+  return {
+    render(width: number): string[] {
+      const availableWidth = Math.max(1, width);
+      const partialPrefix = options.isPartial && !/progress|partial|in progress|处理中/i.test(view.summary)
+        ? "In progress: "
+        : "";
+      const fullSummary = `${partialPrefix}${view.summary}`;
+      const hasHiddenText = view.expandedText.trim() !== view.summary.trim();
+      const hint = hasHiddenText ? ` (${keyHint("app.tools.expand", "to expand")})` : "";
+      const hintWidth = visibleWidth(hint);
+      const visibleHint = hintWidth < availableWidth ? hint : "";
+      const summaryWidth = Math.max(1, availableWidth - visibleWidth(visibleHint));
+      const summary = compactSummary(
+        fullSummary,
+        summaryWidth,
+        view.status === "failure" || /warning/i.test(fullSummary),
+      );
+      const line = themed(theme, view.status, options.isPartial, `${summary}${visibleHint}`);
+      return [restoreBackground(line, background, theme)];
+    },
+    invalidate(): void {},
+  };
+}
+
+export function createSharedToolResultRenderer(
+  adapt: (result: unknown) => SharedOutputView = normalizeSharedOutputView,
+) {
+  return (
+    result: unknown,
+    options: ToolRenderResultOptions,
+    theme: SharedOutputTheme,
+    context?: { isError?: boolean },
+  ): Component => {
+    const adapted = adapt(result);
+    const displayView = {
+      ...adapted,
+      summary: sanitizeDisplayText(adapted.summary),
+      expandedText: sanitizeDisplayText(adapted.expandedText),
+    };
+    const view = context?.isError ? { ...displayView, status: "failure" as const } : displayView;
+    const background: ToolCardBackground = options.isPartial
+      ? "toolPendingBg"
+      : context?.isError
+        ? "toolErrorBg"
+        : "toolSuccessBg";
+    return renderView(view, options, theme, background);
+  };
+}