@sudocode-ai/types 0.1.18-dev.0 → 0.1.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sudocode-ai/types",
-  "version": "0.1.18-dev.0",
+  "version": "0.1.19",
   "description": "TypeScript type definitions for sudocode",
   "types": "src/index.d.ts",
   "type": "module",

package/src/agents.d.ts

@@ -26,8 +26,11 @@
 
 /**
  * Agent types supported for execution
+ *
+ * ACP-native agents: claude-code, codex, gemini, opencode
+ * Legacy agents (via shim): copilot, cursor
  */
-export type AgentType = "claude-code" | "codex" | "copilot" | "cursor";
+export type AgentType = "claude-code" | "codex" | "gemini" | "opencode" | "copilot" | "cursor";
 
 /**
  * Execution modes supported by agents
@@ -35,6 +38,21 @@ export type AgentType = "claude-code" | "codex" | "copilot" | "cursor";
  */
 export type ExecutionMode = "structured" | "interactive" | "hybrid";
 
+/**
+ * Configuration for automatic context compaction
+ *
+ * When enabled, the agent will automatically compact context when
+ * the token count exceeds the specified threshold.
+ */
+export interface CompactionConfig {
+  /** Whether auto-compaction is enabled */
+  enabled: boolean;
+  /** Token threshold to trigger compaction (default: 100000) */
+  contextTokenThreshold?: number;
+  /** Custom instructions for the compaction summary */
+  customInstructions?: string;
+}
+
 /**
  * Base configuration options that all agents should support
  * Aligns with BaseAgentConfig from agent-execution-engine
@@ -156,6 +174,18 @@ export interface ClaudeCodeConfig extends BaseAgentConfig {
    * the executor will use the bundled hook script from agent-execution-engine.
    */
   directoryGuardHookPath?: string;
+
+  // === Compaction Configuration ===
+  /**
+   * Auto-compaction configuration for managing context tokens
+   *
+   * When enabled, the agent will automatically compact context when
+   * the token count exceeds the specified threshold. This helps prevent
+   * errors in long conversations.
+   *
+   * @default { enabled: false }
+   */
+  compaction?: CompactionConfig;
 }
 
 /**
@@ -268,6 +298,44 @@ export interface CursorConfig extends BaseAgentConfig {
   prompt?: string;
 }
 
+/**
+ * Google Gemini Code Assist configuration
+ */
+export interface GeminiConfig extends BaseAgentConfig {
+  /** Path to gemini CLI executable */
+  geminiPath?: string;
+  /** Model to use (e.g., 'gemini-2.0-flash', 'gemini-2.0-pro') */
+  model?: string;
+  /** Maximum idle time before cleanup */
+  idleTimeout?: number;
+  /** Retry configuration for failed spawns */
+  retry?: {
+    maxAttempts: number;
+    backoffMs: number;
+  };
+  /** Prompt to send to Gemini */
+  prompt?: string;
+}
+
+/**
+ * Opencode configuration
+ */
+export interface OpencodeConfig extends BaseAgentConfig {
+  /** Path to opencode CLI executable */
+  opencodePath?: string;
+  /** Model to use */
+  model?: string;
+  /** Maximum idle time before cleanup */
+  idleTimeout?: number;
+  /** Retry configuration for failed spawns */
+  retry?: {
+    maxAttempts: number;
+    backoffMs: number;
+  };
+  /** Prompt to send to Opencode */
+  prompt?: string;
+}
+
 /**
  * Discriminated union of all agent configurations
  */
@@ -275,4 +343,6 @@ export type AgentConfig =
   | ClaudeCodeConfig
   | CodexConfig
   | CopilotConfig
-  | CursorConfig;
+  | CursorConfig
+  | GeminiConfig
+  | OpencodeConfig;

package/src/index.d.ts

@@ -286,6 +286,67 @@ export interface EditorConfig {
   customCommand?: string;
 }
 
+/**
+ * Deployment configuration for remote development environments
+ */
+export interface DeployConfig {
+  /** Deployment provider (currently only Codespaces supported) */
+  provider: 'codespaces';
+  /** Default branch to deploy from (optional) */
+  defaultBranch?: string;
+  /** Port number for the server (default: 3000) */
+  port: number;
+  /** Idle timeout in minutes before auto-shutdown */
+  idleTimeout: number;
+  /** Keep-alive duration in hours before auto-cleanup */
+  keepAliveHours: number;
+  /** Machine type/size (e.g., 'basicLinux32gb', 'premiumLinux') */
+  machine: string;
+  /** Retention period in days before cleanup */
+  retentionPeriod: number;
+}
+
+/**
+ * GitHub Codespaces provider configuration
+ */
+export interface CodespacesProviderConfig {
+  /** Default branch to spawn from (optional) */
+  defaultBranch?: string;
+  /** Port number for the server (default: 3000) */
+  port: number;
+  /** Idle timeout in minutes before auto-shutdown */
+  idleTimeout: number;
+  /** Keep-alive duration in hours before auto-cleanup */
+  keepAliveHours: number;
+  /** Machine type/size (e.g., 'basicLinux32gb', 'premiumLinux') */
+  machine: string;
+  /** Retention period in days before cleanup */
+  retentionPeriod: number;
+}
+
+/**
+ * Coder provider configuration (future support)
+ */
+export interface CoderProviderConfig {
+  // Future coder configuration
+}
+
+/**
+ * Spawn configuration for remote development environments
+ * Supports multiple provider configurations
+ */
+export interface SpawnConfig {
+  /** Configuration version */
+  version: string;
+  /** Provider-specific configurations */
+  providers: {
+    /** GitHub Codespaces configuration (optional) */
+    codespaces?: CodespacesProviderConfig;
+    /** Coder configuration (optional, future support) */
+    coder?: CoderProviderConfig;
+  };
+}
+
 /**
  * Config metadata file structure (.sudocode/config.json)
  */
@@ -322,7 +383,7 @@ export type {
  */
 export type ExecutionStatus =
   | "preparing" // Template being prepared
-  | "pending" // Created, not yet started
+  | "pending" // Created, not yet started / Persistent session waiting for next prompt
   | "running" // Agent executing
   | "paused" // Execution paused (awaiting follow-up)
   | "completed" // Successfully finished
@@ -330,6 +391,43 @@ export type ExecutionStatus =
   | "cancelled" // User cancelled
   | "stopped"; // User stopped (legacy alias for cancelled)
 
+/**
+ * Session persistence mode for executions
+ *
+ * - "discrete": Default behavior - one prompt per execution, process terminates after completion
+ * - "persistent": Toad-style - process stays alive, multiple prompts to same session
+ */
+export type SessionMode = "discrete" | "persistent";
+
+/**
+ * Configuration for how a persistent session ends
+ *
+ * Multiple options can be enabled simultaneously. The session ends when any
+ * configured condition is met.
+ */
+export interface SessionEndModeConfig {
+  /** End on explicit user action (default: true) */
+  explicit?: boolean;
+  /** End after idle timeout in milliseconds (0 = disabled, default: 0) */
+  idleTimeoutMs?: number;
+  /** Pause on agent completion signal, resumable (default: false) */
+  pauseOnCompletion?: boolean;
+  /** End when WebSocket connection drops (default: false) */
+  endOnDisconnect?: boolean;
+}
+
+/**
+ * Session configuration for execution
+ *
+ * Controls how the agent session lifecycle is managed during execution.
+ */
+export interface ExecutionSessionConfig {
+  /** Session persistence mode (default: "discrete") */
+  sessionMode?: SessionMode;
+  /** How the persistent session ends (only applies when sessionMode: "persistent") */
+  sessionEndMode?: SessionEndModeConfig;
+}
+
 /**
  * Represents a single agent run on an issue
  * Tracks the full lifecycle of a coding agent execution

package/src/voice.d.ts

@@ -44,7 +44,7 @@ export type TTSProvider = "browser" | "kokoro" | "openai";
  * ```
  */
 export interface VoiceSettingsConfig {
-  /** Whether voice features are enabled (default: true) */
+  /** Whether voice features are enabled (default: false) */
   enabled?: boolean;
   /** Speech-to-text settings */
   stt?: {
@@ -82,6 +82,10 @@ export interface VoiceSettingsConfig {
     narrateToolResults?: boolean;
     /** Whether to narrate assistant messages (default: true) */
     narrateAssistantMessages?: boolean;
+    /** Whether to only narrate explicit speak tool calls (default: false)
+     * When true, ignores narrateToolUse, narrateToolResults, and narrateAssistantMessages
+     * and only narrates when the agent explicitly calls the speak tool */
+    narrateSpeakOnly?: boolean;
   };
 }