@vladimirven/openswe 0.1.0

package/src/config/index.ts

@@ -0,0 +1,171 @@
+/**
+ * Main configuration module for OpenSWE
+ *
+ * This module orchestrates loading configuration from multiple sources
+ * with the following precedence (highest to lowest):
+ * 1. CLI flags
+ * 2. Environment variables (OPENSWE_*)
+ * 3. Global config file (~/.config/openswe/config.toml)
+ * 4. Built-in defaults
+ */
+
+// Re-export all types
+export * from "./types"
+export type {
+  GlobalConfig,
+  PartialConfig,
+  CLIOverrides,
+  AIBackend,
+  LogLevel,
+  AIConfig,
+  KeybindingsConfig,
+  AdvancedConfig,
+} from "./types"
+
+// Re-export defaults
+export { DEFAULT_CONFIG } from "./defaults"
+
+// Re-export global config utilities
+export {
+  getConfigDir,
+  getConfigPath,
+  configFileExists,
+  saveGlobalConfig,
+} from "./global"
+
+import type { GlobalConfig, PartialConfig, CLIOverrides, DeepPartial } from "./types"
+import { DEFAULT_CONFIG } from "./defaults"
+import { loadEnvConfig } from "./env"
+import { loadGlobalConfig } from "./global"
+
+// ============================================================================
+// Deep Merge Utility
+// ============================================================================
+
+/**
+ * Deep merge two objects, with source values overriding target values
+ * Arrays are replaced, not merged
+ */
+export function deepMerge<T extends object>(target: T, source: DeepPartial<T>): T {
+  const result = structuredClone(target)
+
+  for (const key of Object.keys(source)) {
+    const sourceValue = (source as Record<string, unknown>)[key]
+    const targetValue = (result as Record<string, unknown>)[key]
+
+    if (sourceValue === undefined) {
+      continue
+    }
+
+    if (
+      sourceValue !== null &&
+      typeof sourceValue === "object" &&
+      !Array.isArray(sourceValue) &&
+      targetValue !== null &&
+      typeof targetValue === "object" &&
+      !Array.isArray(targetValue)
+    ) {
+      // Recursively merge nested objects
+      ;(result as Record<string, unknown>)[key] = deepMerge(
+        targetValue as object,
+        sourceValue as DeepPartial<object>
+      )
+    } else {
+      // Replace value (including arrays)
+      ;(result as Record<string, unknown>)[key] = sourceValue
+    }
+  }
+
+  return result
+}
+
+// ============================================================================
+// CLI Overrides
+// ============================================================================
+
+/**
+ * Apply CLI flag overrides to config
+ */
+function applyCLIOverrides(config: GlobalConfig, cli: CLIOverrides): GlobalConfig {
+  const result = structuredClone(config)
+
+  if (cli.backend !== undefined) {
+    result.ai.backend = cli.backend
+  }
+
+  if (cli.model !== undefined) {
+    const activeBackend = result.ai.backend
+    if (activeBackend === "opencode") {
+      result.ai.opencode.model = cli.model
+    } else if (activeBackend === "claude") {
+      result.ai.claude.model = cli.model
+    }
+  }
+
+  if (cli.debug === true) {
+    result.advanced.logLevel = "debug"
+  }
+
+  return result
+}
+
+// ============================================================================
+// Main Load Function
+// ============================================================================
+
+/**
+ * Load and merge configuration from all sources
+ *
+ * Precedence (highest to lowest):
+ * 1. CLI overrides
+ * 2. Environment variables
+ * 3. Global config file
+ * 4. Built-in defaults
+ *
+ * @param cliOverrides - Optional CLI flag overrides
+ * @returns Fully resolved configuration
+ */
+export async function loadConfig(cliOverrides?: CLIOverrides): Promise<GlobalConfig> {
+  // 1. Start with defaults
+  let config: GlobalConfig = structuredClone(DEFAULT_CONFIG)
+
+  // 2. Merge global config file (if exists)
+  const fileConfig = await loadGlobalConfig()
+  config = deepMerge(config, fileConfig)
+
+  // 3. Merge environment variables
+  const envConfig = loadEnvConfig()
+  config = deepMerge(config, envConfig)
+
+  // 4. Apply CLI overrides (highest priority)
+  if (cliOverrides) {
+    config = applyCLIOverrides(config, cliOverrides)
+  }
+
+  return config
+}
+
+/**
+ * Load configuration synchronously (for use in non-async contexts)
+ * Note: This skips loading the config file since file I/O is async
+ *
+ * @param cliOverrides - Optional CLI flag overrides
+ * @returns Configuration with defaults + env + CLI (no file)
+ */
+export function loadConfigSync(cliOverrides?: CLIOverrides): GlobalConfig {
+  // 1. Start with defaults
+  let config: GlobalConfig = structuredClone(DEFAULT_CONFIG)
+
+  // 2. Skip file config (would require async)
+
+  // 3. Merge environment variables
+  const envConfig = loadEnvConfig()
+  config = deepMerge(config, envConfig)
+
+  // 4. Apply CLI overrides
+  if (cliOverrides) {
+    config = applyCLIOverrides(config, cliOverrides)
+  }
+
+  return config
+}

package/src/config/types.ts

@@ -0,0 +1,131 @@
+/**
+ * Configuration type definitions for OpenSWE
+ */
+
+// ============================================================================
+// Type Literals
+// ============================================================================
+
+/** Supported AI backends */
+export type AIBackend = "opencode" | "claude"
+
+/** Log levels in order of verbosity */
+export type LogLevel = "debug" | "info" | "warn" | "error"
+
+// ============================================================================
+// Sub-Configuration Interfaces
+// ============================================================================
+
+/** OpenCode-specific AI configuration */
+export interface OpenCodeConfig {
+  model: string
+  provider: string
+}
+
+/** Claude-specific AI configuration */
+export interface ClaudeConfig {
+  model: string
+}
+
+/** AI backend configuration */
+export interface AIConfig {
+  backend: AIBackend
+  opencode: OpenCodeConfig
+  claude: ClaudeConfig
+}
+
+/** Keyboard shortcut configuration */
+export interface KeybindingsConfig {
+  navigateUp: string
+  navigateDown: string
+  select: string
+  newSession: string
+  deleteSession: string
+  pauseSession: string
+  taskQueue: string
+  issues: string
+  quit: string
+  help: string
+}
+
+/** Advanced/debug configuration */
+export interface AdvancedConfig {
+  logLevel: LogLevel
+}
+
+/** UI/Theme configuration */
+export interface UIConfig {
+  /** Theme name (bundled or custom) */
+  theme: string
+  /** Theme mode (dark or light) */
+  themeMode: "dark" | "light"
+}
+
+// ============================================================================
+// Full Configuration Interface
+// ============================================================================
+
+/** Complete global configuration */
+export interface GlobalConfig {
+  ai: AIConfig
+  keybindings: KeybindingsConfig
+  advanced: AdvancedConfig
+  ui: UIConfig
+}
+
+// ============================================================================
+// Utility Types
+// ============================================================================
+
+/** Deep partial type - makes all nested properties optional */
+export type DeepPartial<T> = T extends object
+  ? { [P in keyof T]?: DeepPartial<T[P]> }
+  : T
+
+/** Partial configuration for merging sources */
+export type PartialConfig = DeepPartial<GlobalConfig>
+
+/** CLI flags that can override configuration */
+export interface CLIOverrides {
+  backend?: AIBackend
+  model?: string
+  debug?: boolean
+}
+
+// ============================================================================
+// Type Guards
+// ============================================================================
+
+/** Valid AI backend values */
+const VALID_BACKENDS: readonly AIBackend[] = ["opencode", "claude"]
+
+/** Valid log level values */
+const VALID_LOG_LEVELS: readonly LogLevel[] = ["debug", "info", "warn", "error"]
+
+/**
+ * Check if a value is a valid AI backend
+ */
+export function isValidBackend(val: unknown): val is AIBackend {
+  return typeof val === "string" && VALID_BACKENDS.includes(val as AIBackend)
+}
+
+/**
+ * Check if a value is a valid log level
+ */
+export function isValidLogLevel(val: unknown): val is LogLevel {
+  return typeof val === "string" && VALID_LOG_LEVELS.includes(val as LogLevel)
+}
+
+/**
+ * Check if a value is a boolean
+ */
+export function isBoolean(val: unknown): val is boolean {
+  return typeof val === "boolean"
+}
+
+/**
+ * Check if a value is a non-empty string
+ */
+export function isNonEmptyString(val: unknown): val is string {
+  return typeof val === "string" && val.length > 0
+}

package/src/core/index.ts

@@ -0,0 +1,5 @@
+export { parseOutputLine, createParser } from "./parser"
+export { SessionManager } from "./session"
+export { TmuxManager } from "./tmux"
+export type { ProcessManager, ProcessSnapshot } from "./process-manager"
+export type { ParsedEvent, ParsedEventType } from "./parser"

package/src/core/parser.ts

@@ -0,0 +1,62 @@
+/**
+ * Output parser for AI session markers
+ *
+ * Detects OpenSWE markers with support for provider-specific patterns.
+ */
+
+import type { ParserPatterns } from "../providers/types"
+
+export type ParsedEventType =
+  | "phase"
+  | "done"
+  | "working"
+  | "raw"
+
+export interface ParsedEvent {
+  type: ParsedEventType
+  payload?: string
+  line: string
+}
+
+// ============================================================================
+// Default Patterns (OpenCode compatible)
+// ============================================================================
+
+const DEFAULT_PATTERNS: ParserPatterns = {
+  workingRegex: /(?:starting|begin|entering).+(?:implementation|coding|execution)|(?:mode|status):\s*(?:implement|coding)/i,
+  doneRegex: /\[?OPENSWE:DONE\]?/i,
+}
+
+// ============================================================================
+// Parser Factory
+// ============================================================================
+
+/**
+ * Create a parser function with custom patterns
+ * @param patterns - Provider-specific parser patterns
+ * @returns Parser function for output lines
+ */
+export function createParser(patterns: ParserPatterns): (line: string) => ParsedEvent | null {
+  return function parseOutputLine(line: string): ParsedEvent | null {
+    // Implicitly detect working phase via keywords
+    if (patterns.workingRegex.test(line)) {
+      return { type: "working", line }
+    }
+
+    if (patterns.doneRegex.test(line)) {
+      return { type: "done", line }
+    }
+
+    return null
+  }
+}
+
+// ============================================================================
+// Default Parser (backward compatible)
+// ============================================================================
+
+/**
+ * Parse a single output line for known markers
+ * Uses default patterns for backward compatibility
+ */
+export const parseOutputLine = createParser(DEFAULT_PATTERNS)

package/src/core/process-manager.ts

@@ -0,0 +1,52 @@
+/**
+ * Process Manager Interface
+ * 
+ * Abstraction for managing background processes (sessions).
+ */
+
+export interface ProcessSnapshot {
+  lines: string[]
+  cursor: { x: number, y: number } | null
+}
+
+export interface ProcessManager {
+  /**
+   * Spawn a new persistent session
+   */
+  spawn(id: string, command: string, args: string[], cwd: string, env: Record<string, string>, logPath: string): Promise<number>
+
+  /**
+   * Check if a session is running
+   */
+  isRunning(id: string): Promise<boolean>
+
+  /**
+   * Kill a session
+   */
+  kill(id: string): Promise<void>
+
+  /**
+   * Get the current visual state of the session
+   */
+  getSnapshot(id: string): Promise<ProcessSnapshot>
+
+  /**
+   * Send input to the session
+   */
+  sendInput(id: string, data: string): Promise<void>
+
+  /**
+   * Get list of active session IDs managed by this backend
+   */
+  listActiveSessions(): Promise<string[]>
+
+  /**
+   * Get the command to attach to this session interactively
+   */
+  getAttachCommand(id: string): string[]
+
+  /**
+   * Resize the session terminal
+   */
+  resize(id: string, cols: number, rows: number): Promise<void>
+}