@ebowwa/codespaces-types 1.1.0 → 1.2.0

package/{dist/compile → compile}/index.js

@@ -1,6 +1,30 @@
+"use strict";
 /**
  * Shared type definitions for frontend and server
  */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoopStatus = exports.VolumeStatus = exports.ActionStatus = exports.EnvironmentStatus = void 0;
+exports.getEnvLocation = getEnvLocation;
+exports.getEnvRegionName = getEnvRegionName;
+exports.getEnvLocationLabel = getEnvLocationLabel;
+// ============================================================================
+// WebSocket Types (shared between terminal and frontend)
+// ============================================================================
+__exportStar(require("./terminal-websocket.js"), exports);
 // ============================================================================
 // Application Types
 // ============================================================================
@@ -20,7 +44,7 @@
  * - "stopping" → "deleting"
  * - "initializing" → "creating"
  */
-export var EnvironmentStatus;
+var EnvironmentStatus;
 (function (EnvironmentStatus) {
     EnvironmentStatus["Running"] = "running";
     EnvironmentStatus["Stopped"] = "stopped";
@@ -30,41 +54,41 @@ export var EnvironmentStatus;
     EnvironmentStatus["Starting"] = "starting";
     EnvironmentStatus["Stopping"] = "stopping";
     EnvironmentStatus["Initializing"] = "initializing";
-})(EnvironmentStatus || (EnvironmentStatus = {}));
+})(EnvironmentStatus || (exports.EnvironmentStatus = EnvironmentStatus = {}));
 /**
  * Action status - used by HetznerAction
  */
-export var ActionStatus;
+var ActionStatus;
 (function (ActionStatus) {
     ActionStatus["Running"] = "running";
     ActionStatus["Success"] = "success";
     ActionStatus["Error"] = "error";
-})(ActionStatus || (ActionStatus = {}));
+})(ActionStatus || (exports.ActionStatus = ActionStatus = {}));
 /**
  * Volume status - used by HetznerVolume
  */
-export var VolumeStatus;
+var VolumeStatus;
 (function (VolumeStatus) {
     VolumeStatus["Creating"] = "creating";
     VolumeStatus["Available"] = "available";
     VolumeStatus["Deleting"] = "deleting";
-})(VolumeStatus || (VolumeStatus = {}));
+})(VolumeStatus || (exports.VolumeStatus = VolumeStatus = {}));
 /**
  * Ralph Loop status - used by RalphLoop interface
  */
-export var LoopStatus;
+var LoopStatus;
 (function (LoopStatus) {
     LoopStatus["Running"] = "running";
     LoopStatus["Stopped"] = "stopped";
     LoopStatus["Error"] = "error";
     LoopStatus["Completed"] = "completed";
-})(LoopStatus || (LoopStatus = {}));
+})(LoopStatus || (exports.LoopStatus = LoopStatus = {}));
 /**
  * Get the location object from an environment
  * @param env - The environment object
  * @returns The location object or null
  */
-export function getEnvLocation(env) {
+function getEnvLocation(env) {
     if (!env)
         return null;
     return env.location || null;
@@ -74,23 +98,25 @@ export function getEnvLocation(env) {
  * @param env - The environment object
  * @returns The region name (e.g., "nbg1") or "Unknown"
  */
-export function getEnvRegionName(env) {
+function getEnvRegionName(env) {
+    var _a;
     if (!env)
         return "Unknown";
-    return env.location?.name || "Unknown";
+    return ((_a = env.location) === null || _a === void 0 ? void 0 : _a.name) || "Unknown";
 }
 /**
  * Get a human-readable location label with city and country
  * @param env - The environment object
  * @returns A formatted location string (e.g., "Nuremberg, DE" or "nbg1" as fallback)
  */
-export function getEnvLocationLabel(env) {
+function getEnvLocationLabel(env) {
+    var _a, _b, _c;
     if (!env)
         return "Unknown";
     // Show city, country for better UX
-    if (env.location?.city && env.location?.country) {
-        return `${env.location.city}, ${env.location.country}`;
+    if (((_a = env.location) === null || _a === void 0 ? void 0 : _a.city) && ((_b = env.location) === null || _b === void 0 ? void 0 : _b.country)) {
+        return "".concat(env.location.city, ", ").concat(env.location.country);
     }
     // Fallback to location name
-    return env.location?.name || "Unknown";
+    return ((_c = env.location) === null || _c === void 0 ? void 0 : _c.name) || "Unknown";
 }

package/compile/index.ts

@@ -0,0 +1,553 @@
+/**
+ * Shared type definitions for frontend and server
+ */
+
+// ============================================================================
+// WebSocket Types (shared between terminal and frontend)
+// ============================================================================
+
+export * from "./terminal-websocket.js";
+
+// ============================================================================
+// Hetzner API Types (shared between frontend and backend)
+// ============================================================================
+
+/**
+ * Hetzner server type with pricing information
+ */
+export interface HetznerServerType {
+  id: number;
+  name: string;
+  description: string;
+  cores: number;
+  memory: number;
+  disk: number;
+  deprecated?: boolean;
+  prices: Array<{
+    location: string | null | undefined;
+    price_hourly: {
+      net: string;
+      gross: string;
+    };
+    price_monthly: {
+      net: string;
+      gross: string;
+    };
+  }>;
+  storage_type: "local" | "network";
+  cpu_type: "shared" | "dedicated";
+}
+
+/**
+ * Hetzner location/datacenter
+ */
+export interface HetznerLocation {
+  id: number;
+  name: string;
+  description: string;
+  country: string;
+  city: string;
+  latitude: number;
+  longitude: number;
+  network_zone: string;
+}
+
+/**
+ * Hetzner datacenter (specific facility within a location)
+ * Previously backend-only, now shared for full object graph preservation
+ */
+export interface HetznerDatacenter {
+  id: number;
+  name: string;
+  description: string;
+  location: HetznerLocation;
+  supported_server_types?: Array<{
+    id: number;
+    name: string;
+  }> | null;
+  available_server_types?: Array<{
+    id: number;
+    name: string;
+  }>;
+}
+
+// ============================================================================
+// Application Types
+// ============================================================================
+
+// ============================================================================
+// Shared Status Enums
+// ============================================================================
+
+/**
+ * Environment status - used by Environment interface and HetznerServer mapping
+ *
+ * Hetzner API returns: "running" | "stopped" | "starting" | "stopping" | "initializing"
+ * Environment uses subset: "running" | "stopped" | "creating" | "deleting"
+ *
+ * Mapping:
+ * - "running" → "running"
+ * - "stopped" → "stopped"
+ * - "starting" → "creating"
+ * - "stopping" → "deleting"
+ * - "initializing" → "creating"
+ */
+export enum EnvironmentStatus {
+  Running = "running",
+  Stopped = "stopped",
+  Creating = "creating",
+  Deleting = "deleting",
+  // Additional Hetzner server statuses (for API compatibility)
+  Starting = "starting",
+  Stopping = "stopping",
+  Initializing = "initializing",
+}
+
+/**
+ * Action status - used by HetznerAction
+ */
+export enum ActionStatus {
+  Running = "running",
+  Success = "success",
+  Error = "error",
+}
+
+/**
+ * Volume status - used by HetznerVolume
+ */
+export enum VolumeStatus {
+  Creating = "creating",
+  Available = "available",
+  Deleting = "deleting",
+}
+
+/**
+ * Ralph Loop status - used by RalphLoop interface
+ */
+export enum LoopStatus {
+  Running = "running",
+  Stopped = "stopped",
+  Error = "error",
+  Completed = "completed",
+}
+
+/**
+ * Active port on a server
+ */
+export interface ActivePort {
+  port: number;
+  protocol: "tcp" | "udp";
+  service?: string;
+  state: "open" | "closed" | "filtered";
+}
+
+// ============================================================================
+// Base Permissions (shared between Environment and EnvironmentMetadata)
+// ============================================================================
+
+// TODO:
+// https://tailscale.com/kb/1015/100.x-addresses
+// - type for every tailnet device has local access to a private service IP address called Quad100 (100.100.100.100)
+// - `Tailscale automatically assigns a unique IP address to each device in your Tailscale network`
+/**
+ * Base permissions structure shared by Environment and EnvironmentMetadata
+ */
+export interface BasePermissions {
+  // Seed/clone configuration
+  seedConfig?: {
+    sourceEnvironmentId?: string;
+    dependencySnapshot?: string;
+    setupScript?: string;
+  };
+
+  // Authentication providers
+  logins?: {
+    github?: {
+      enabled: boolean;
+      username?: string;
+      tokenScopes?: string[];
+    };
+    doppler?: {
+      enabled: boolean;
+      project?: string;
+      config?: string;
+    };
+    tailscale?: {
+      enabled: boolean;
+      authKey?: string;
+      hostname?: string;
+    };
+  };
+
+  // VPN configurations
+  vpns?: Array<{
+    name: string;
+    type: "wireguard" | "openvpn" | "tailscale";
+    config: string;
+    connected: boolean;
+  }>;
+
+  // Generic plugin configuration
+  plugins?: Record<string, ClaudeCodePlugin>;
+}
+
+// ============================================================================
+// Environment Base (shared fields between Environment and EnvironmentMetadata)
+// ============================================================================
+
+/**
+ * Base fields shared by Environment and EnvironmentMetadata
+ */
+export interface EnvironmentBase {
+  id: string;
+  description?: string;
+  project?: string;
+  owner?: string;
+  purpose?: string;
+  environmentType?: "development" | "staging" | "production" | "testing";
+  hoursActive?: number;
+  lastActive?: string;
+  activePorts?: ActivePort[];
+  /** Cloud-init bootstrap status */
+  bootstrapStatus?: "bootstrapping" | "ready" | "failed";
+}
+
+// TODO: https://code.claude.com/docs/en/common-workflows
+
+/**
+ * Claude Code hook event types
+ */
+export type HookEventType =
+  | "SessionStart"
+  | "UserPromptSubmit"
+  | "PreToolUse"
+  | "PostToolUse"
+  | "PreCommand"
+  | "PostCommand"
+  | "Stop"
+  | "Error"
+  | "FileChange";
+
+/**
+ * Claude Code hook configuration
+ */
+export interface ClaudeCodeHook {
+  event: HookEventType;
+  description?: string;
+  command?: string;
+  output?: {
+    allow?: boolean;
+    context?: string;
+    modifyInput?: string;
+  };
+}
+
+/**
+ * Claude Code agent configuration
+ */
+export interface ClaudeCodeAgent {
+  name: string;
+  description?: string;
+  instructions?: string;
+  model?: string;
+  temperature?: number;
+  maxTokens?: number;
+}
+
+/**
+ * Claude Code command configuration
+ */
+export interface ClaudeCodeCommand {
+  name: string;
+  description?: string;
+  instructions?: string;
+  agent?: string;
+  shouldConfirm?: boolean;
+  parameters?: Record<
+    string,
+    {
+      type: "string" | "boolean" | "number" | "array";
+      description?: string;
+      required?: boolean;
+      default?: unknown;
+    }
+  >;
+}
+
+/**
+ * Claude Code skill configuration
+ */
+export interface ClaudeCodeSkill {
+  name: string;
+  description?: string;
+  instructions?: string;
+  trigger?: {
+    patterns?: string[];
+    fileTypes?: string[];
+    always?: boolean;
+  };
+}
+
+/**
+ * MCP (Model Context Protocol) Server Configuration
+ *
+ * === LAYER 2: CLI Wrapper Plugin System ===
+ *
+ * MCP is NOT part of the OpenAI protocol (Layer 1).
+ * It's a separate plugin system for exposing tools/resources to AI models.
+ *
+ * These types are defined but NOT yet implemented in cheapspaces.
+ *
+ * Reference Implementation: tools/continue/core/context/mcp/
+ *
+ * Potential MCP Tools for Cheapspaces:
+ * - hetzner_create: Create new server (wrap HetznerClient.createServer())
+ * - hetzner_delete: Delete server (wrap HetznerClient.deleteServer())
+ * - hetzner_power: Power on/off (wrap powerOn/powerOff)
+ * - ssh_exec: Execute remote command (wrap execSSH())
+ * - ssh_upload: Upload file via SCP (wrap scpUpload())
+ * - ssh_download: Download file via SCP (wrap scpDownload())
+ * - resources_get: Get resource usage (wrap getResources())
+ *
+ * To implement (Layer 2 only):
+ * 1. Create MCPManagerSingleton (see continue's pattern)
+ * 2. Create MCPConnection wrapper for stdio/HTTP servers
+ * 3. Expose Hetzner/SSH operations as MCP tools
+ * 4. Integrate with AI chat for tool calling
+ */
+export interface MCPServerConfig {
+  name: string;
+  command: string; // For stdio-based servers
+  args?: string[];
+  env?: Record<string, string>;
+  cwd?: string;
+}
+
+/**
+ * Claude Code plugin configuration
+ */
+export interface ClaudeCodePlugin {
+  enabled: boolean;
+  name?: string;
+  description?: string;
+  version?: string;
+  author?: string;
+  commands?: ClaudeCodeCommand[];
+  agents?: ClaudeCodeAgent[];
+  skills?: ClaudeCodeSkill[];
+  hooks?: ClaudeCodeHook[];
+  mcpServers?: MCPServerConfig[];
+  config?: Record<string, unknown>;
+}
+
+/**
+ * Server image information
+ */
+export interface ServerImage {
+  id: number;
+  name: string;
+  description: string;
+  type: "snapshot" | "backup" | "system";
+}
+
+/**
+ * Environment data - shared between frontend and server
+ */
+export interface Environment extends EnvironmentBase {
+  // Core identification (id, description from base)
+  name: string;
+  status:
+    | EnvironmentStatus.Running
+    | EnvironmentStatus.Stopped
+    | EnvironmentStatus.Creating
+    | EnvironmentStatus.Deleting;
+
+  // Action progress (0-100) for long-running operations
+  progress?: number;
+
+  // Server configuration
+  serverId: number;
+  serverType: string;
+  image: ServerImage;
+  location?: HetznerLocation;
+  datacenter?: HetznerDatacenter;
+
+  // Network addresses
+  ipv4: string | null;
+  ipv6: string | null;
+
+  // Metadata
+  createdAt: string;
+  lastUsed: string | null;
+  tags: string[];
+
+  // Resource usage metrics
+  resources?: {
+    cpuPercent: number;
+    memoryPercent: number;
+    memoryUsed: string;
+    memoryTotal: string;
+    diskPercent: number;
+    diskUsed: string;
+    diskTotal: string;
+    gpuPercent?: number;
+    gpuMemoryUsed?: string;
+    gpuMemoryTotal?: string;
+    lastUpdated?: string;
+  };
+
+  // Permissions and integrations
+  nodeAgent?: NodeAgentInfo;
+
+  permissions?: BasePermissions & {
+    // Available skills (Environment-specific)
+    skills?: Array<{
+      name: string;
+      enabled: boolean;
+      config?: Record<string, unknown>;
+    }>;
+  };
+}
+
+/**
+ * Get the location object from an environment
+ * @param env - The environment object
+ * @returns The location object or null
+ */
+export function getEnvLocation(
+  env: Environment | undefined | null,
+): HetznerLocation | null {
+  if (!env) return null;
+  return env.location || null;
+}
+
+/**
+ * Get the region name (short format like "nbg1") from an environment
+ * @param env - The environment object
+ * @returns The region name (e.g., "nbg1") or "Unknown"
+ */
+export function getEnvRegionName(env: Environment | undefined | null): string {
+  if (!env) return "Unknown";
+  return env.location?.name || "Unknown";
+}
+
+/**
+ * Get a human-readable location label with city and country
+ * @param env - The environment object
+ * @returns A formatted location string (e.g., "Nuremberg, DE" or "nbg1" as fallback)
+ */
+export function getEnvLocationLabel(
+  env: Environment | undefined | null,
+): string {
+  if (!env) return "Unknown";
+  // Show city, country for better UX
+  if (env.location?.city && env.location?.country) {
+    return `${env.location.city}, ${env.location.country}`;
+  }
+  // Fallback to location name
+  return env.location?.name || "Unknown";
+}
+
+/**
+ * Environment metadata for storage
+ * Extends EnvironmentBase with storage-specific fields
+ */
+export interface EnvironmentMetadata extends EnvironmentBase {
+  sshKeyPath?: string;
+  permissions?: BasePermissions;
+  updatedAt?: string;
+}
+
+/**
+ * Node Agent - Ralph Loop orchestration service running on each VPS
+ */
+
+/**
+ * Git worktree information
+ */
+export interface Worktree {
+  id: string;
+  branch: string;
+  commit: string;
+  path: string;
+  created?: string;
+}
+
+/**
+ * Ralph Loop status and progress
+ */
+export interface RalphLoop {
+  id: string;
+  worktree_id: string;
+  iteration: number;
+  max_iterations: number;
+  status: LoopStatus;
+  started_at: string;
+  last_activity?: string;
+  recent_commits?: Array<{ hash: string; message: string }>;
+  prompt?: string;
+  completion_promise?: string | null;
+  project_path?: string; // Relative path like ~/seed or ~/seed/worktrees/feature-x
+  git_info?: {
+    remote: string | null; // e.g., "ebowwa/seed" or null
+    branch: string | null; // e.g., "Bun-port" or null
+  };
+  // Ralph Iterative specific fields
+  phase?: "planning" | "executing" | "review" | "complete";
+  current_task?: string | null;
+  total_subtasks?: number;
+  completed_subtasks?: number;
+  subtasks?: Array<{
+    id: string;
+    title: string;
+    status: "pending" | "in_progress" | "completed";
+  }>;
+}
+
+/**
+ * Node Agent capacity metrics (system resources)
+ */
+export interface NodeCapacity {
+  cpu_percent: number;
+  memory_percent: number;
+  disk_percent: number;
+  claude_cpu_total?: number;  // Total CPU % used by all Claude processes
+  claude_process_count?: number;  // Number of active Claude processes
+}
+
+/**
+ * Active Claude Code process info
+ */
+export interface ClaudeCodeProcess {
+  pid: number;
+  worktreeId?: string;
+  loopId?: string;
+  startTime: string;  // ISO date string
+  command: string;
+  cpuPercent: number;
+  memoryPercent: number;
+}
+
+/**
+ * Node Agent status response
+ */
+export interface NodeAgentStatus {
+  node_id: string;
+  hostname: string;
+  tailscale_ip: string;
+  capacity: NodeCapacity;
+  worktrees: Worktree[];
+  ralph_loops: RalphLoop[];
+  active_claude_processes?: ClaudeCodeProcess[];
+}
+
+/**
+ * Node Agent connection info for UI display
+ */
+export interface NodeAgentInfo {
+  running: boolean;
+  port?: number;
+  status?: NodeAgentStatus;
+  lastChecked?: string;
+  error?: string;
+}