mini-coder 0.5.11 → 0.5.13

package/src/theme.ts

@@ -2,8 +2,7 @@
  * UI theme definition and default colors.
  *
  * All UI colors are read from the active {@link Theme} object — the UI
- * never hardcodes colors. Plugins can return a `Partial<Theme>` in their
- * result to override any color. Multiple overrides are merged left-to-right.
+ * never hardcodes colors. Theme overrides are merged left-to-right.
  *
  * Theme values are cel-tui {@link Color} palette references. The default
  * theme prefers ANSI 16-color palette entries so it adapts cleanly to the
@@ -12,11 +11,47 @@
  * @module
  */
 
+import type { SyntaxHighlightTheme } from "@cel-tui/components";
 import type { Color } from "@cel-tui/types";
 
 /** A cel-tui palette color or the terminal default when undefined. */
 type ThemeColor = Color | undefined;
 
+type SyntaxThemeRegistration = Exclude<SyntaxHighlightTheme, string>;
+type SyntaxThemeTokenColor = NonNullable<
+  SyntaxThemeRegistration["tokenColors"]
+>[number];
+type SyntaxThemeVariant = "markdown" | "code" | "shell";
+
+/** ANSI16 fallback hex values for syntax-highlighter theme overrides. */
+const ANSI_COLOR_HEX: Readonly<Record<Color, string>> = {
+  color00: "#000000",
+  color01: "#cd3131",
+  color02: "#0dbc79",
+  color03: "#e5e510",
+  color04: "#2472c8",
+  color05: "#bc3fbc",
+  color06: "#11a8cd",
+  color07: "#e5e5e5",
+  color08: "#666666",
+  color09: "#f14c4c",
+  color10: "#23d18b",
+  color11: "#f5f543",
+  color12: "#3b8eea",
+  color13: "#d670d6",
+  color14: "#29b8db",
+  color15: "#ffffff",
+};
+
+const syntaxThemeCache: Record<
+  SyntaxThemeVariant,
+  WeakMap<Theme, SyntaxThemeRegistration>
+> = {
+  markdown: new WeakMap(),
+  code: new WeakMap(),
+  shell: new WeakMap(),
+};
+
 // ---------------------------------------------------------------------------
 // Types
 // ---------------------------------------------------------------------------
@@ -132,7 +167,7 @@ export const DEFAULT_THEME: Theme = {
  * mutated.
  *
  * @param base - The base theme to start from.
- * @param overrides - Partial theme objects to merge (from plugins).
+ * @param overrides - Partial theme objects to merge.
  * @returns A complete {@link Theme} with all overrides applied.
  */
 export function mergeThemes(
@@ -145,3 +180,151 @@ export function mergeThemes(
   }
   return merged;
 }
+
+function colorToHex(color: ThemeColor): string | undefined {
+  return color ? ANSI_COLOR_HEX[color] : undefined;
+}
+
+function pushSyntaxTokenColor(
+  tokenColors: SyntaxThemeTokenColor[],
+  scope: string | readonly string[],
+  foreground: ThemeColor,
+  fontStyle?: string,
+): void {
+  const foregroundHex = colorToHex(foreground);
+  if (!foregroundHex && !fontStyle) {
+    return;
+  }
+
+  tokenColors.push({
+    scope,
+    settings: {
+      ...(foregroundHex ? { foreground: foregroundHex } : {}),
+      ...(fontStyle ? { fontStyle } : {}),
+    },
+  });
+}
+
+function pushCodeSyntaxTokenColors(
+  tokenColors: SyntaxThemeTokenColor[],
+  theme: Theme,
+): void {
+  pushSyntaxTokenColor(
+    tokenColors,
+    ["comment", "quote", "doctag", "markup.quote"],
+    theme.mutedText,
+    "italic",
+  );
+  pushSyntaxTokenColor(
+    tokenColors,
+    ["keyword", "operator"],
+    theme.secondaryAccentText,
+  );
+  pushSyntaxTokenColor(
+    tokenColors,
+    ["command", "function_", "function", "title"],
+    theme.accentText,
+  );
+  pushSyntaxTokenColor(
+    tokenColors,
+    ["builtin", "built_in", "class_", "class", "inherited__", "type"],
+    theme.accentText,
+  );
+  pushSyntaxTokenColor(
+    tokenColors,
+    ["escape", "literal", "number", "symbol"],
+    theme.secondaryAccentText ?? theme.accentText,
+  );
+  pushSyntaxTokenColor(
+    tokenColors,
+    ["code", "string", "markup.code"],
+    theme.diffAdded,
+  );
+  pushSyntaxTokenColor(tokenColors, "regexp", theme.diffRemoved);
+  pushSyntaxTokenColor(
+    tokenColors,
+    ["attr", "attribute", "params", "property", "selector-attr"],
+    theme.accentText,
+  );
+  pushSyntaxTokenColor(
+    tokenColors,
+    [
+      "name",
+      "tag",
+      "selector-class",
+      "selector-id",
+      "selector-pseudo",
+      "selector-tag",
+    ],
+    theme.accentText,
+  );
+}
+
+function pushMarkdownSyntaxTokenColors(
+  tokenColors: SyntaxThemeTokenColor[],
+  theme: Theme,
+): void {
+  pushSyntaxTokenColor(
+    tokenColors,
+    ["quote", "markup.quote"],
+    theme.mutedText,
+    "italic",
+  );
+  pushSyntaxTokenColor(
+    tokenColors,
+    ["section", "markup.heading"],
+    theme.accentText,
+    "bold",
+  );
+  pushSyntaxTokenColor(
+    tokenColors,
+    ["bullet", "markup.list"],
+    theme.secondaryAccentText,
+    "bold",
+  );
+  pushSyntaxTokenColor(
+    tokenColors,
+    ["code", "string", "markup.code"],
+    theme.diffAdded,
+  );
+  pushSyntaxTokenColor(tokenColors, "link", theme.accentText, "underline");
+  pushSyntaxTokenColor(tokenColors, "strong", undefined, "bold");
+  pushSyntaxTokenColor(tokenColors, "emphasis", undefined, "italic");
+}
+
+/**
+ * Build the shared syntax-highlight theme registration for a UI theme variant.
+ *
+ * Markdown, read/code blocks, and shell/tool previews all flow through this
+ * helper so active-theme overrides stay consistent in one place. Variant names
+ * are included in the registration so cel-tui's internal SyntaxHighlight cache
+ * does not collapse code and shell renders onto the same custom-theme key.
+ *
+ * @param theme - Active UI theme.
+ * @param variant - Semantic highlighting variant for the rendered content.
+ * @returns A cached cel-tui syntax-highlight theme registration.
+ */
+export function getSyntaxHighlightTheme(
+  theme: Theme,
+  variant: SyntaxThemeVariant,
+): SyntaxThemeRegistration {
+  const cache = syntaxThemeCache[variant];
+  const cached = cache.get(theme);
+  if (cached) {
+    return cached;
+  }
+
+  const tokenColors: SyntaxThemeTokenColor[] = [];
+  if (variant === "markdown") {
+    pushMarkdownSyntaxTokenColors(tokenColors, theme);
+  } else {
+    pushCodeSyntaxTokenColors(tokenColors, theme);
+  }
+
+  const syntaxTheme: SyntaxThemeRegistration = {
+    name: `mini-coder-${variant}`,
+    tokenColors,
+  };
+  cache.set(theme, syntaxTheme);
+  return syntaxTheme;
+}

package/src/tool-common.ts

@@ -0,0 +1,93 @@
+/**
+ * Shared helpers for built-in tool implementations.
+ *
+ * @module
+ */
+
+import type {
+  ImageContent,
+  Static,
+  TextContent,
+  Tool,
+  ToolCall,
+  TSchema,
+} from "@mariozechner/pi-ai";
+import { validateToolArguments } from "@mariozechner/pi-ai";
+
+/**
+ * Result from executing a tool.
+ *
+ * Content blocks carry either text or image data. The agent loop maps these
+ * directly into pi-ai tool-result content.
+ */
+export interface ToolExecResult {
+  /** Content blocks for the tool result. */
+  content: (TextContent | ImageContent)[];
+  /** Optional structured metadata preserved on the tool-result message. */
+  details?: unknown;
+  /** Whether the execution encountered an error. */
+  isError: boolean;
+}
+
+/**
+ * Build a text-only tool result.
+ *
+ * @param text - Message text to return in the tool result.
+ * @param isError - Whether the result represents a tool error.
+ * @returns Text-only tool result content.
+ */
+export function textResult(text: string, isError: boolean): ToolExecResult {
+  return { content: [{ type: "text", text }], isError };
+}
+
+/**
+ * Detect which line ending a text blob uses.
+ *
+ * @param content - Text to inspect.
+ * @returns The first detected line ending, or `null` when the text is single-line.
+ */
+export function detectLineEnding(content: string): "\n" | "\r\n" | null {
+  if (content.includes("\r\n")) {
+    return "\r\n";
+  }
+  if (content.includes("\n")) {
+    return "\n";
+  }
+  return null;
+}
+
+/**
+ * Normalize line endings to a specific style.
+ *
+ * @param content - Text to normalize.
+ * @param lineEnding - Target line ending sequence.
+ * @returns Text using only the requested line ending style.
+ */
+export function normalizeLineEndings(
+  content: string,
+  lineEnding: "\n" | "\r\n",
+): string {
+  if (lineEnding === "\r\n") {
+    return content.replace(/\r?\n/g, "\r\n");
+  }
+  return content.replace(/\r\n/g, "\n");
+}
+
+/**
+ * Validate and coerce built-in tool arguments against a typed TypeBox schema.
+ *
+ * @param tool - Built-in tool definition.
+ * @param args - Raw parsed tool-call arguments from the model.
+ * @returns Validated arguments typed from the tool schema.
+ */
+export function validateBuiltinToolArgs<TParameters extends TSchema>(
+  tool: Tool<TParameters>,
+  args: Record<string, unknown>,
+): Static<TParameters> {
+  return validateToolArguments(tool, {
+    type: "toolCall",
+    id: tool.name,
+    name: tool.name,
+    arguments: args,
+  } satisfies ToolCall) as Static<TParameters>;
+}