Function parseRuntimeModeAndHost

src/common/types/runtime.ts:126–188

(runtime: string | null | undefined)

 * Use this for UI state management (localStorage, form inputs).
 */
export function parseRuntimeModeAndHost(runtime: string | null | undefined): ParsedRuntime | null {
  if (!runtime) {
    return { mode: RUNTIME_MODE.WORKTREE };
  }

  const trimmed = runtime.trim();
  const lowerTrimmed = trimmed.toLowerCase();

  if (lowerTrimmed === RUNTIME_MODE.LOCAL) {
    return { mode: RUNTIME_MODE.LOCAL };
  }

  if (lowerTrimmed === RUNTIME_MODE.WORKTREE) {
    return { mode: RUNTIME_MODE.WORKTREE };
  }

  // Check for "ssh <host>" format
  if (lowerTrimmed.startsWith(SSH_RUNTIME_PREFIX)) {
    const host = trimmed.substring(SSH_RUNTIME_PREFIX.length).trim();
    if (!host) return null; // "ssh " without host is invalid
    return { mode: RUNTIME_MODE.SSH, host };
  }

  // Plain "ssh" without host is invalid
  if (lowerTrimmed === RUNTIME_MODE.SSH) {
    return null;
  }

  // Check for "docker <image>" format
  if (lowerTrimmed.startsWith(DOCKER_RUNTIME_PREFIX)) {
    const image = trimmed.substring(DOCKER_RUNTIME_PREFIX.length).trim();
    if (!image) return null; // "docker " without image is invalid
    return { mode: RUNTIME_MODE.DOCKER, image };
  }

  // Plain "docker" without image is invalid
  if (lowerTrimmed === RUNTIME_MODE.DOCKER) {
    return null;
  }

  // Check for "devcontainer <configPath>" format (config path is optional)
  if (lowerTrimmed.startsWith(DEVCONTAINER_RUNTIME_PREFIX)) {
    const configPath = trimmed.substring(DEVCONTAINER_RUNTIME_PREFIX.length).trim();
    return { mode: RUNTIME_MODE.DEVCONTAINER, configPath };
  }

  if (lowerTrimmed === RUNTIME_MODE.DEVCONTAINER) {
    return { mode: RUNTIME_MODE.DEVCONTAINER, configPath: "" };
  }

  // Try to parse as a plain mode (local/worktree/devcontainer)
  const modeResult = RuntimeModeSchema.safeParse(lowerTrimmed);
  if (modeResult.success) {
    const mode = modeResult.data;
    if (mode === "local") return { mode: "local" };
    if (mode === "worktree") return { mode: "worktree" };
    if (mode === "devcontainer") return { mode: "devcontainer", configPath: "" };
    // ssh/docker without args handled above