Function checkDiskAndCleanBeforeSetup

services/cloud-agent-next/src/workspace.ts:217–303

(
  sandbox: SandboxInstance,
  orgId: string | undefined,
  userId: string,
  sessionId: string,
  options: StaleWorkspaceCleanupOptions
)

  kilocodeOrganizationId: string | null | undefined,
  userId: string,
  worktreeId: CloudAgentWorktreeId
): string {
  const parsed = cloudAgentWorktreeIdSchema.safeParse(worktreeId);
  if (!parsed.success) {
    throw invalidSegment('worktree id');
  }
  return `${getBaseWorkspacePath(kilocodeOrganizationId, userId)}/worktrees/${parsed.data}`;
}

export function getSessionHomePath(sessionId: string): string {
  return `${SESSION_HOME_ROOT}/${requireGeneratedIdPathSegment(sessionId, 'session id')}`;
}

export function getKilocodeCliDir(sessionHome: string): string {
  return `${sessionHome}/${CLI_DIR}`;
}

export function getKilocodeLogsDir(sessionHome: string): string {
  return `${sessionHome}/${CLI_LOGS_PATH}`;
}

export function getKilocodeLogFilePath(sessionHome: string): string {
  return `${getKilocodeLogsDir(sessionHome)}/cli.txt`;
}

export function getWrapperLogFilePath(executionId: string): string {
  return `/tmp/kilocode-wrapper-${executionId}.log`;
}

export function getKilocodeTasksDir(sessionHome: string): string {
  return `${sessionHome}/${CLI_GLOBAL_TASKS_PATH}`;
}

export function getKilocodeGlobalDir(sessionHome: string): string {
  return `${getKilocodeCliDir(sessionHome)}/global`;
}

export type SessionPaths = {
  workspacePath: string;
  sessionHome: string;
};

export type StaleWorkspaceCleanupResult = {
  cleaned: number;
  skipped: number;
};

export type StaleWorkspaceCleanupOptions = {
  inspectContainers: boolean;
};

export type WorkspaceAdmissionResult = {
  availableMB: number;
  thresholdMB: number;
  cleanup: StaleWorkspaceCleanupResult;
};

function throwIfSandboxFilesystemUnusable(operation: string, error: unknown): void {