nova-terminal-assistant 0.1.0

package/src/core/types/config.ts

@@ -0,0 +1,200 @@
+// ============================================================================
+// Config Types - Application configuration
+// ============================================================================
+
+export interface NovaConfig {
+  /** Core engine settings */
+  core: CoreConfig;
+  /** Model provider settings */
+  models: ModelsConfig;
+  /** MCP server configuration */
+  mcp?: Record<string, McpServerConfig>;
+  /** Hook configuration */
+  hooks?: HookConfigEntry[];
+  /** File filter rules */
+  fileFilter?: FileFilterConfig;
+  /** Security settings */
+  security?: SecurityConfig;
+  /** Telemetry settings */
+  telemetry?: TelemetryConfig;
+  /** Extension settings */
+  extensions?: ExtensionsConfig;
+  /** User preferences */
+  preferences?: PreferencesConfig;
+}
+
+export interface CoreConfig {
+  /** Default model to use */
+  defaultModel: string;
+  /** Default approval mode */
+  defaultApprovalMode: 'yolo' | 'default' | 'accepting_edits' | 'plan' | 'smart';
+  /** Maximum conversation turns */
+  maxTurns: number;
+  /** Maximum tokens per response */
+  maxTokens: number;
+  /** Default temperature */
+  temperature: number;
+  /** Context window size for compression */
+  contextWindowTarget: number;
+  /** Whether streaming is enabled by default */
+  streaming: boolean;
+  /** Session persistence directory */
+  sessionsDir?: string;
+  /** Log level */
+  logLevel: 'debug' | 'info' | 'warn' | 'error' | 'silent';
+  /** Global timeout in milliseconds */
+  timeout?: number;
+  /** Maximum number of checkpoints to keep */
+  maxCheckpoints?: number;
+  /** Maximum age of checkpoints in days */
+  checkpointMaxAgeDays?: number;
+}
+
+export interface ModelsConfig {
+  /** Available model providers */
+  providers: Record<string, ModelProviderConfig>;
+  /** Model aliases */
+  aliases?: Record<string, string>;
+}
+
+export interface ModelProviderConfig {
+  /** Provider type */
+  type: 'anthropic' | 'openai' | 'azure' | 'ollama' | 'ollama-cloud' | 'coding-plan' | 'custom';
+  /** Provider name (optional, for display purposes) */
+  name?: string;
+  /** API key (reference to env var or direct value) */
+  apiKey?: string;
+  /** Base URL for API */
+  baseUrl?: string;
+  /** API version */
+  apiVersion?: string;
+  /** Organization ID */
+  organizationId?: string;
+  /** Coding Plan platform (required when type is 'coding-plan') */
+  codingPlanPlatform?: 'alibaba' | 'tencent' | 'volcengine' | 'baidu' | 'kimi' | 'zhipu' | 'minimax' | 'custom';
+  /** Available models from this provider */
+  models: Record<string, ModelConfig>;
+  /** Default model for this provider */
+  defaultModel?: string;
+  /** Rate limits */
+  rateLimit?: {
+    requestsPerMinute: number;
+    tokensPerMinute: number;
+  };
+}
+
+export interface ModelConfig {
+  /** Display name */
+  name?: string;
+  /** Maximum context window */
+  maxContextTokens: number;
+  /** Maximum output tokens */
+  maxOutputTokens: number;
+  /** Whether the model supports vision */
+  supportsVision: boolean;
+  /** Whether the model supports tool use */
+  supportsTools: boolean;
+  /** Whether the model supports streaming */
+  supportsStreaming: boolean;
+  /** Whether the model supports thinking/reasoning */
+  supportsThinking: boolean;
+  /** Cost per 1M input tokens (USD) */
+  inputCostPerMToken?: number;
+  /** Cost per 1M output tokens (USD) */
+  outputCostPerMToken?: number;
+}
+
+export interface McpServerConfig {
+  /** Command to start the MCP server */
+  command: string;
+  /** Arguments */
+  args?: string[];
+  /** Environment variables */
+  env?: Record<string, string>;
+  /** Whether the server is enabled */
+  enabled?: boolean;
+  /** Connection timeout in ms */
+  timeout?: number;
+}
+
+export interface HookConfigEntry {
+  /** Hook event type */
+  event: string;
+  /** Command to execute */
+  command: string;
+  /** Matcher pattern (glob for tool names) */
+  matcher?: string;
+  /** Timeout in ms */
+  timeout?: number;
+  /** Description */
+  description?: string;
+}
+
+export interface FileFilterConfig {
+  /** Glob patterns to always ignore */
+  ignorePatterns: string[];
+  /** Glob patterns to always allow */
+  allowPatterns?: string[];
+  /** Maximum file size to read (bytes) */
+  maxFileSize?: number;
+  /** Maximum number of files for batch operations */
+  maxBatchSize?: number;
+  /** Directories to never access */
+  forbiddenPaths?: string[];
+}
+
+export interface SecurityConfig {
+  /** Sandbox mode */
+  sandbox: 'none' | 'restricted' | 'full';
+  /** Whether to enable checkpoint/recovery */
+  checkpoints: boolean;
+  /** Maximum checkpoint age (ms) */
+  checkpointMaxAge?: number;
+  /** Commands that are always blocked */
+  blockedCommands?: string[];
+  /** Commands that are always allowed (even in strict mode) */
+  allowedCommands?: string[];
+}
+
+export interface TelemetryConfig {
+  /** Whether telemetry is enabled */
+  enabled: boolean;
+  /** Telemetry endpoint */
+  endpoint?: string;
+  /** Unique anonymous identifier */
+  clientId?: string;
+  /** What to track */
+  track: {
+    usage?: boolean;
+    errors?: boolean;
+    performance?: boolean;
+  };
+}
+
+export interface ExtensionsConfig {
+  /** Path to extensions directory */
+  extensionsDir?: string;
+  /** List of enabled extensions */
+  enabled: string[];
+}
+
+export interface PreferencesConfig {
+  /** Theme */
+  theme?: 'light' | 'dark' | 'auto';
+  /** Editor to use for file editing */
+  editor?: string;
+  /** Shell to use */
+  shell?: string;
+  /** Language */
+  language?: string;
+  /** Key bindings */
+  keyBindings?: Record<string, string>;
+}
+
+// --- Config Resolution ---
+export type ConfigSource = 'default' | 'config_file' | 'env' | 'cli_arg';
+
+export interface ResolvedConfig {
+  value: unknown;
+  source: ConfigSource;
+}

package/src/core/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["errors.ts"],"names":[],"mappings":"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"}

package/src/core/types/errors.ts

@@ -0,0 +1,204 @@
+// ============================================================================
+// Error Types - Custom error classes and error handling
+// ============================================================================
+
+/** Base error class for all Nova CLI errors */
+export class NovaError extends Error {
+  constructor(
+    message: string,
+    public readonly code: string,
+    public readonly details?: unknown,
+    public readonly retryable: boolean = false
+  ) {
+    super(message);
+    this.name = 'NovaError';
+  }
+
+  toJSON(): Record<string, unknown> {
+    return {
+      name: this.name,
+      code: this.code,
+      message: this.message,
+      details: this.details,
+      retryable: this.retryable,
+    };
+  }
+}
+
+/** Error in configuration loading or validation */
+export class ConfigError extends NovaError {
+  constructor(message: string, details?: unknown) {
+    super(message, 'CONFIG_ERROR', details, false);
+    this.name = 'ConfigError';
+  }
+}
+
+/** Error in model API communication */
+export class ModelError extends NovaError {
+  constructor(
+    message: string,
+    public readonly statusCode?: number,
+    public readonly provider?: string,
+    details?: unknown
+  ) {
+    super(message, 'MODEL_ERROR', details, statusCode !== 429 && statusCode !== 503);
+    this.name = 'ModelError';
+  }
+}
+
+/** Error from rate limiting */
+export class RateLimitError extends ModelError {
+  declare readonly code: string;
+  declare readonly retryable: boolean;
+  constructor(
+    message: string,
+    public readonly retryAfterMs: number,
+    provider?: string
+  ) {
+    super(message, 429, provider, { retryAfterMs });
+    this.name = 'RateLimitError';
+    (this as any).code = 'RATE_LIMIT_ERROR';
+    (this as any).retryable = true;
+  }
+}
+
+/** Error in tool execution */
+export class ToolError extends NovaError {
+  constructor(
+    message: string,
+    public readonly toolName: string,
+    public readonly toolCallId?: string,
+    details?: unknown
+  ) {
+    super(message, 'TOOL_ERROR', details, false);
+    this.name = 'ToolError';
+  }
+}
+
+/** Error from tool input validation */
+export class ToolValidationError extends ToolError {
+  declare readonly code: string;
+  constructor(
+    message: string,
+    toolName: string,
+    public readonly validationErrors: Array<{ field: string; message: string }>
+  ) {
+    super(message, toolName, undefined, { validationErrors });
+    this.name = 'ToolValidationError';
+    (this as any).code = 'TOOL_VALIDATION_ERROR';
+  }
+}
+
+/** Error in session management */
+export class SessionError extends NovaError {
+  constructor(
+    message: string,
+    public readonly sessionId?: string,
+    details?: unknown
+  ) {
+    super(message, 'SESSION_ERROR', details, false);
+    this.name = 'SessionError';
+  }
+}
+
+/** Error from approval system */
+export class ApprovalError extends NovaError {
+  constructor(message: string, details?: unknown) {
+    super(message, 'APPROVAL_ERROR', details, false);
+    this.name = 'ApprovalError';
+  }
+}
+
+/** Error from hook execution */
+export class HookError extends NovaError {
+  constructor(
+    message: string,
+    public readonly hookEvent: string,
+    public readonly exitCode?: number,
+    details?: unknown
+  ) {
+    super(message, 'HOOK_ERROR', details, false);
+    this.name = 'HookError';
+  }
+}
+
+/** Error from MCP server */
+export class McpError extends NovaError {
+  constructor(
+    message: string,
+    public readonly serverName?: string,
+    details?: unknown
+  ) {
+    super(message, 'MCP_ERROR', details, false);
+    this.name = 'McpError';
+  }
+}
+
+/** Error from security/sandbox */
+export class SecurityError extends NovaError {
+  constructor(message: string, details?: unknown) {
+    super(message, 'SECURITY_ERROR', details, false);
+    this.name = 'SecurityError';
+  }
+}
+
+/** Error when context window is exceeded */
+export class ContextOverflowError extends NovaError {
+  constructor(
+    message: string,
+    public readonly currentTokens: number,
+    public readonly maxTokens: number
+  ) {
+    super(message, 'CONTEXT_OVERFLOW', { currentTokens, maxTokens }, false);
+    this.name = 'ContextOverflowError';
+  }
+}
+
+/** Error when operation is cancelled */
+export class CancelledError extends NovaError {
+  constructor(message: string = 'Operation cancelled') {
+    super(message, 'CANCELLED', undefined, false);
+    this.name = 'CancelledError';
+  }
+}
+
+/** Error from timeout */
+export class TimeoutError extends NovaError {
+  constructor(
+    message: string,
+    public readonly timeoutMs: number
+  ) {
+    super(message, 'TIMEOUT', { timeoutMs }, false);
+    this.name = 'TimeoutError';
+  }
+}
+
+/** Aggregate error for multiple failures */
+export class AggregateError extends NovaError {
+  constructor(
+    message: string,
+    public readonly errors: Error[]
+  ) {
+    super(message, 'AGGREGATE_ERROR', { errorCount: errors.length }, false);
+    this.name = 'AggregateError';
+  }
+}
+
+/** Error type guard */
+export function isNovaError(error: unknown): error is NovaError {
+  return error instanceof NovaError;
+}
+
+/** Get user-friendly error message */
+export function getErrorMessage(error: unknown): string {
+  if (isNovaError(error)) {
+    return `[${error.code}] ${error.message}`;
+  }
+  if (error instanceof Error) {
+    return error.message;
+  }
+  if (typeof error === 'string') {
+    return error;
+  }
+  return 'An unknown error occurred';
+}

package/src/core/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/src/core/types/index.ts

@@ -0,0 +1,8 @@
+// ============================================================================
+// Types Barrel Export
+// ============================================================================
+
+export * from './session.js';
+export * from './tools.js';
+export * from './config.js';
+export * from './errors.js';

package/src/core/types/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["session.ts"],"names":[],"mappings":"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"}

package/src/core/types/session.ts

@@ -0,0 +1,216 @@
+// ============================================================================
+// Session Types - Session lifecycle and state management
+// ============================================================================
+
+/** Branded type for session identifiers */
+export type SessionId = string & { readonly __brand: 'SessionId' };
+/** Branded type for message identifiers */
+export type MessageId = string & { readonly __brand: 'MessageId' };
+/** Branded type for tool call identifiers */
+export type ToolCallId = string & { readonly __brand: 'ToolCallId' };
+
+/** Create a branded SessionId */
+export function createSessionId(id: string): SessionId {
+  return id as SessionId;
+}
+
+/** Create a branded MessageId */
+export function createMessageId(id: string): MessageId {
+  return id as MessageId;
+}
+
+/** Create a branded ToolCallId */
+export function createToolCallId(id: string): ToolCallId {
+  return id as ToolCallId;
+}
+
+// --- Session States ---
+export type SessionState =
+  | 'idle'
+  | 'initializing'
+  | 'running'
+  | 'awaiting_approval'
+  | 'paused'
+  | 'completed'
+  | 'error'
+  | 'cancelled';
+
+export type SessionEventType =
+  | 'state_change'
+  | 'message_added'
+  | 'tool_call_start'
+  | 'tool_call_complete'
+  | 'tool_call_error'
+  | 'error'
+  | 'context_update'
+  | 'approval_required'
+  | 'approval_response'
+  | 'streaming_start'
+  | 'streaming_delta'
+  | 'streaming_complete';
+
+export interface SessionEvent<T = unknown> {
+  type: SessionEventType;
+  sessionId: SessionId;
+  timestamp: number;
+  data: T;
+}
+
+// --- Message Types ---
+export type MessageRole = 'system' | 'user' | 'assistant' | 'tool';
+
+export type ContentBlockType =
+  | 'text'
+  | 'image'
+  | 'thinking'
+  | 'tool_use'
+  | 'tool_result';
+
+export interface TextContent {
+  type: 'text';
+  text: string;
+}
+
+export interface ImageContent {
+  type: 'image';
+  source: {
+    type: 'base64' | 'url';
+    media_type: string;
+    data?: string;
+    url?: string;
+  };
+}
+
+export interface ThinkingContent {
+  type: 'thinking';
+  thinking: string;
+}
+
+export interface ToolUseContent {
+  type: 'tool_use';
+  id: ToolCallId;
+  name: string;
+  input: Record<string, unknown>;
+}
+
+export interface ToolResultContent {
+  type: 'tool_result';
+  tool_use_id: ToolCallId;
+  content: string | Array<TextContent | ImageContent>;
+  is_error?: boolean;
+}
+
+export type ContentBlock =
+  | TextContent
+  | ImageContent
+  | ThinkingContent
+  | ToolUseContent
+  | ToolResultContent;
+
+export interface Message {
+    id: MessageId;
+    role: MessageRole;
+    content: ContentBlock[];
+    timestamp: number;
+    createdAt: Date;
+    metadata?: Record<string, unknown>;
+  }
+// --- Conversation ---
+export interface Conversation {
+  messages: Message[];
+  systemPrompt?: string;
+  context?: ConversationContext;
+}
+
+export interface ConversationContext {
+  workingDirectory: string;
+  environment: Record<string, string>;
+  sessionId: SessionId;
+  toolResults: Map<string, unknown>;
+}
+
+// --- Session Config ---
+export interface SessionConfig {
+  /** Unique session identifier */
+  id: SessionId;
+  /** Human-readable session name */
+  name?: string;
+  /** Model identifier (e.g., 'claude-3-opus-20240229') */
+  model: string;
+  /** Maximum tokens for model responses */
+  maxTokens: number;
+  /** Temperature for sampling (0-1) */
+  temperature?: number;
+  /** System prompt */
+  systemPrompt?: string;
+  /** Working directory for file operations */
+  workingDirectory: string;
+  /** Approval mode */
+  approvalMode: ApprovalMode;
+  /** Whether to enable streaming responses */
+  streaming: boolean;
+  /** Maximum number of conversation turns */
+  maxTurns?: number;
+  /** Custom tool definitions */
+  tools?: string[];
+  /** MCP servers to connect */
+  mcpServers?: string[];
+  /** Hook scripts configuration */
+  hooks?: HookConfig[];
+  /** Session metadata */
+  metadata?: Record<string, unknown>;
+  /** Parent session ID for sub-sessions */
+  parentSessionId?: string;
+}
+
+// --- Approval ---
+export type ApprovalMode =
+  | 'yolo'           // Auto-approve everything
+  | 'default'        // Ask for approval on potentially destructive ops
+  | 'accepting_edits' // Auto-approve file edits only
+  | 'plan'           // Always ask before executing
+  | 'smart';         // AI-assisted approval decisions
+
+export interface ApprovalRequest {
+  id: string;
+  sessionId: SessionId;
+  toolName: string;
+  toolInput: Record<string, unknown>;
+  risk: 'low' | 'medium' | 'high' | 'critical';
+  description: string;
+  timestamp: number;
+}
+
+export interface ApprovalResponse {
+  requestId: string;
+  approved: boolean;
+  modifiedInput?: Record<string, unknown>;
+  reason?: string;
+}
+
+// --- Hooks ---
+export type HookEvent =
+  | 'PreToolUse'
+  | 'PostToolUse'
+  | 'SetUpEnvironment'
+  | 'Stop'
+  | 'SessionStart'
+  | 'SessionEnd'
+  | 'UserPromptSubmit'
+  | 'Notification';
+
+export interface HookConfig {
+  event: HookEvent;
+  command: string;
+  timeout?: number;
+  condition?: string;
+  matcher?: string;
+  description?: string;
+}
+
+export interface HookResult {
+  exitCode: number;
+  stdout: string;
+  stderr: string;
+  duration: number;
+}

package/src/core/types/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["tools.ts"],"names":[],"mappings":"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"}