@gguf/coder 0.3.0 → 0.3.1

package/source/types/core.ts

@@ -0,0 +1,181 @@
+import React from 'react';
+
+import {type Tool as AISDKTool, jsonSchema, tool} from 'ai';
+
+export {tool, jsonSchema};
+
+// Type for AI SDK tools (return type of tool() function)
+// Tool<PARAMETERS, RESULT> is AI SDK's actual tool type
+// We use 'any' for generics since we don't auto-execute tools (human-in-the-loop)
+// biome-ignore lint/suspicious/noExplicitAny: Dynamic typing required
+export type AISDKCoreTool = AISDKTool<any, any>;
+
+// Current Coder message format (OpenAI-compatible)
+// Note: We maintain this format internally and convert to ModelMessage at AI SDK boundary
+export interface Message {
+	role: 'user' | 'assistant' | 'system' | 'tool';
+	content: string;
+	tool_calls?: ToolCall[];
+	tool_call_id?: string;
+	name?: string;
+}
+
+export interface ToolCall {
+	id: string;
+	function: {
+		name: string;
+		arguments: Record<string, unknown>;
+	};
+}
+
+export interface ToolResult {
+	tool_call_id: string;
+	role: 'tool';
+	name: string;
+	content: string;
+}
+
+export interface ToolParameterSchema {
+	type?: string;
+	description?: string;
+	[key: string]: unknown;
+}
+
+export interface Tool {
+	type: 'function';
+	function: {
+		name: string;
+		description: string;
+		parameters: {
+			type: 'object';
+			properties: Record<string, ToolParameterSchema>;
+			required: string[];
+		};
+	};
+}
+
+// Tool handlers accept dynamic args from LLM, so any is appropriate here
+// biome-ignore lint/suspicious/noExplicitAny: Dynamic typing required -- Tool arguments are dynamically typed
+export type ToolHandler = (input: any) => Promise<string>;
+
+/**
+ * Tool formatter type for Ink UI
+ * Formats tool arguments and results for display in the CLI
+ */
+export type ToolFormatter = (
+	// biome-ignore lint/suspicious/noExplicitAny: Dynamic typing required -- Tool arguments are dynamically typed
+	args: any,
+	result?: string,
+) =>
+	| string
+	| Promise<string>
+	| React.ReactElement
+	| Promise<React.ReactElement>;
+
+/**
+ * Tool validator type for pre-execution validation
+ * Returns validation result with optional error message
+ */
+export type ToolValidator = (
+	// biome-ignore lint/suspicious/noExplicitAny: Dynamic typing required -- Tool arguments are dynamically typed
+	args: any,
+) => Promise<{valid: true} | {valid: false; error: string}>;
+
+/**
+ * Coder tool export structure
+ *
+ * This is what individual tool files export (e.g., read-file.tsx, execute-bash.tsx).
+ * The handler is extracted from tool.execute() in tools/index.ts to avoid duplication.
+ *
+ * Structure:
+ * - name: Tool name as const for type safety
+ * - tool: Native AI SDK v6 CoreTool with execute() function
+ * - formatter: Optional React component for rich CLI UI display
+ * - validator: Optional pre-execution validation function
+ */
+export interface CoderToolExport {
+	name: string;
+	tool: AISDKCoreTool; // AI SDK v6 tool with execute()
+	formatter?: ToolFormatter; // For UI display
+	validator?: ToolValidator; // For pre-execution validation
+}
+
+/**
+ * Internal tool entry used by ToolRegistry
+ *
+ * This is the complete tool entry including the handler extracted from tool.execute().
+ * Used internally by ToolRegistry and ToolManager for unified tool management.
+ *
+ * Structure:
+ * - name: Tool name for registry lookup
+ * - tool: Native AI SDK CoreTool (for passing to AI SDK)
+ * - handler: Extracted execute function (for human-in-the-loop execution)
+ * - formatter: Optional React component for rich CLI UI display
+ * - validator: Optional pre-execution validation function
+ */
+export interface ToolEntry {
+	name: string;
+	tool: AISDKCoreTool; // For AI SDK
+	handler: ToolHandler; // For execution (extracted from tool.execute)
+	formatter?: ToolFormatter; // For UI (React component)
+	validator?: ToolValidator; // For validation
+}
+
+interface LLMMessage {
+	role: 'assistant';
+	content: string;
+	tool_calls?: ToolCall[];
+}
+
+export interface LLMChatResponse {
+	choices: Array<{
+		message: LLMMessage;
+	}>;
+	// Auto-executed messages (assistant + tool results) from AI SDK multi-step execution
+	// These need to be added to message history for proper context tracking
+	autoExecutedMessages?: Message[];
+}
+
+export interface StreamCallbacks {
+	onToken?: (token: string) => void;
+	onToolCall?: (toolCall: ToolCall) => void;
+	onToolExecuted?: (toolCall: ToolCall, result: string) => void;
+	onFinish?: () => void;
+}
+
+export interface LLMClient {
+	getCurrentModel(): string;
+	setModel(model: string): void;
+	getContextSize(): number;
+	getAvailableModels(): Promise<string[]>;
+	chat(
+		messages: Message[],
+		tools: Record<string, AISDKCoreTool>,
+		callbacks: StreamCallbacks,
+		signal?: AbortSignal,
+	): Promise<LLMChatResponse>;
+	clearContext(): Promise<void>;
+}
+
+export type DevelopmentMode = 'normal' | 'auto-accept' | 'plan';
+
+export const DEVELOPMENT_MODE_LABELS: Record<DevelopmentMode, string> = {
+	normal: '▶ normal mode on',
+	'auto-accept': '⏵⏵ auto-accept mode on',
+	plan: '⏸ plan mode on',
+};
+
+// Connection status types for MCP and LSP servers
+export type ConnectionStatus = 'connected' | 'failed' | 'pending';
+
+export interface MCPConnectionStatus {
+	name: string;
+	status: ConnectionStatus;
+	errorMessage?: string;
+}
+
+export interface LSPConnectionStatus {
+	name: string;
+	status: ConnectionStatus;
+	errorMessage?: string;
+}

package/source/types/hooks.ts

@@ -0,0 +1,50 @@
+// Enum for all supported placeholder types - ensures type safety
+export enum PlaceholderType {
+	PASTE = 'paste',
+	FILE = 'file',
+	// Future types can be added here:
+	// TEMPLATE = 'template',
+	// ENV_VAR = 'env_var',
+	// COMMAND_OUTPUT = 'command_output'
+}
+
+// Base placeholder content structure
+interface BasePlaceholderContent {
+	type: PlaceholderType;
+	displayText: string; // What shows in the placeholder (e.g., "[Paste #123: 567 chars]")
+}
+
+// Specific placeholder types with their own JSON data structures
+export interface PastePlaceholderContent extends BasePlaceholderContent {
+	type: PlaceholderType.PASTE;
+	content: string; // The actual pasted text
+	originalSize: number;
+	detectionMethod?: 'rate' | 'size' | 'multiline';
+	timestamp?: number; // When the paste occurred
+}
+
+interface FilePlaceholderContent extends BasePlaceholderContent {
+	type: PlaceholderType.FILE;
+	filePath: string; // Absolute or relative path
+	content: string; // File contents at time of inclusion
+	lastModified?: number; // File modification time
+	encoding?: string; // File encoding (utf8, etc.)
+	fileSize?: number; // Original file size
+	checksum?: string; // For detecting file changes
+}
+
+// Union type for all placeholder content types - fully type-safe
+export type PlaceholderContent =
+	| PastePlaceholderContent
+	| FilePlaceholderContent;
+
+// Core data structure for placeholder handling system
+export interface InputState {
+	// The text visible in the input field, including placeholders.
+	// e.g., "Analyze this: [Paste #1234: 567 chars] and compare with [File #5678: config.json]"
+	displayValue: string;
+
+	// A dictionary holding the full content and metadata for each placeholder.
+	// The key is the ID from the placeholder.
+	placeholderContent: Record<string, PlaceholderContent>;
+}

package/source/types/index.ts

@@ -0,0 +1,12 @@
+// Re-export all types from organized modules
+export * from '@/types/core';
+export * from '@/types/config';
+export * from '@/types/mcp';
+export * from '@/types/commands';
+export * from '@/types/ui';
+export * from '@/types/app';
+export * from '@/types/utils';
+export * from '@/types/components';
+export * from '@/types/hooks';
+export * from '@/types/system';
+export * from '@/types/checkpoint';

package/source/types/markdown-parser.ts

@@ -0,0 +1,11 @@
+// Color scheme for terminal output
+export interface Colors {
+	primary: string;
+	secondary: string;
+	success: string;
+	error: string;
+	warning: string;
+	info: string;
+	white: string;
+	tool: string;
+}

package/source/types/mcp.ts

@@ -0,0 +1,52 @@
+export type MCPTransportType = 'stdio' | 'websocket' | 'http';
+
+export interface MCPAuthConfig {
+	type: 'bearer' | 'basic' | 'api-key' | 'custom';
+	token?: string;
+	username?: string;
+	password?: string;
+	apiKey?: string;
+	customHeaders?: Record<string, string>;
+}
+
+export interface MCPServer {
+	name: string;
+	transport: MCPTransportType;
+
+	// STDIO-specific fields
+	command?: string;
+	args?: string[];
+	env?: Record<string, string>;
+
+	// Remote transport-specific fields
+	url?: string;
+	headers?: Record<string, string>;
+	auth?: MCPAuthConfig;
+	timeout?: number;
+	reconnect?: {
+		enabled: boolean;
+		maxAttempts: number;
+		backoffMs: number;
+	};
+
+	// Common fields
+	description?: string;
+	tags?: string[];
+	enabled?: boolean;
+}
+
+export interface MCPTool {
+	name: string;
+	description?: string;
+	// JSON Schema for tool input - intentionally flexible
+	// biome-ignore lint/suspicious/noExplicitAny: Dynamic typing required
+	inputSchema?: any;
+	serverName: string;
+}
+
+export interface MCPInitResult {
+	serverName: string;
+	success: boolean;
+	toolCount?: number;
+	error?: string;
+}

package/source/types/system.ts

@@ -0,0 +1,16 @@
+export interface ModelEntry {
+	id: string; // OpenRouter model ID (e.g., "openai/gpt-4")
+	name: string; // Display name
+	author: string; // Model creator/organization (e.g., "Meta", "Anthropic", "Qwen")
+	size: string; // Context length formatted (e.g., "128K", "1M")
+	local: boolean; // Open weights - can be run locally
+	api: boolean; // Available via hosted API (OpenRouter, etc.)
+	contextLength: number; // Raw context length in tokens
+	created: number; // Unix timestamp of model creation
+	quality: {
+		cost: number; // Cost-effectiveness (10 = free/cheap, 1 = very expensive)
+	};
+	costType: 'free' | 'paid';
+	costDetails: string; // e.g., "$1.25/M in, $5.00/M out"
+	hasToolSupport: boolean; // Whether model supports tool/function calling
+}

package/source/types/tokenization.ts

@@ -0,0 +1,41 @@
+/**
+ * Tokenizer interface and types
+ */
+
+import type {Message} from '@/types/core';
+
+/**
+ * Tokenizer interface for encoding text and counting tokens
+ */
+export interface Tokenizer {
+	/**
+	 * Encode text and return token count
+	 */
+	encode(text: string): number;
+
+	/**
+	 * Count tokens in a message (content + role)
+	 */
+	countTokens(message: Message): number;
+
+	/**
+	 * Get the tokenizer name/type
+	 */
+	getName(): string;
+
+	/**
+	 * Optional cleanup method for releasing resources
+	 * Should be called when the tokenizer is no longer needed
+	 */
+	free?(): void;
+}
+
+/**
+ * Provider types for tokenizer selection
+ */
+export type TokenizerProvider =
+	| 'openai'
+	| 'anthropic'
+	| 'llama'
+	| 'fallback'
+	| 'auto';

package/source/types/ui.ts

@@ -0,0 +1,40 @@
+export interface Colors {
+	white: string;
+	black: string;
+	primary: string;
+	tool: string;
+	secondary: string;
+	success: string;
+	error: string;
+	info: string;
+	warning: string;
+	// Diff highlight colors
+	diffAdded: string;
+	diffRemoved: string;
+	diffAddedText: string;
+	diffRemovedText: string;
+}
+
+export interface Theme {
+	name: string;
+	displayName: string;
+	colors: Colors;
+}
+
+export type ThemePreset =
+	| 'tokyo-night'
+	| 'synthwave-84'
+	| 'forest-night'
+	| 'material-ocean'
+	| 'sunset-glow'
+	| 'nord-frost'
+	| 'rose-pine-dawn'
+	| 'neon-jungle'
+	| 'midnight-amethyst'
+	| 'desert-mirage'
+	| 'cherry-blossom'
+	| 'electric-storm'
+	| 'deep-sea'
+	| 'volcanic-ash'
+	| 'cyberpunk-mint'
+	| 'dracula';

package/source/types/usage.ts

@@ -0,0 +1,58 @@
+/**
+ * Token breakdown by category
+ */
+export interface TokenBreakdown {
+	system: number;
+	userMessages: number;
+	assistantMessages: number;
+	toolDefinitions: number;
+	toolResults: number;
+	total: number;
+}
+
+/**
+ * Session usage data
+ */
+export interface SessionUsage {
+	id: string;
+	timestamp: number;
+	provider: string;
+	model: string;
+	tokens: TokenBreakdown;
+	messageCount: number;
+	duration?: number; // Session duration in milliseconds
+}
+
+/**
+ * Daily aggregate usage
+ */
+export interface DailyAggregate {
+	date: string; // YYYY-MM-DD format
+	sessions: number;
+	totalTokens: number;
+	providers: Record<string, number>; // Provider name -> token count
+	models: Record<string, number>; // Model name -> token count
+}
+
+/**
+ * Persistent usage data structure
+ */
+export interface UsageData {
+	sessions: SessionUsage[]; // Last 100 sessions
+	dailyAggregates: DailyAggregate[]; // Last 30 days
+	totalLifetime: number;
+	lastUpdated: number;
+}
+
+/**
+ * Current session statistics
+ */
+export interface CurrentSessionStats {
+	tokens: TokenBreakdown;
+	messageCount: number;
+	startTime: number;
+	provider: string;
+	model: string;
+	contextLimit: number | null;
+	percentUsed: number;
+}

package/source/types/utils.ts

@@ -0,0 +1,16 @@
+export type MessageType = 'info' | 'error' | 'success' | 'warning';
+
+export interface NpmRegistryResponse {
+	version: string;
+	name: string;
+	[key: string]: unknown;
+}
+
+export interface UpdateInfo {
+	hasUpdate: boolean;
+	currentVersion: string;
+	latestVersion?: string;
+	updateCommand?: string;
+	updateMessage?: string;
+	error?: string;
+}